feat(parser): add ZCode SQLite sync support (#1003) (#1012)

ZCode sessions were invisible because agentsview did not have an agent type, provider, parser, or sync route for the SQLite database reported in #1003.

This adds `AgentZCode` on the existing DB-backed provider path. The provider resolves either `.zcode/cli/db` or `.zcode/cli` to `db.sqlite`, reads the reported `session` and `model_usage` tables, and emits metadata-only sessions plus usage events. Freshness uses the same effective mtime for provider fingerprints and stored session file info, combining session timestamps, usage timestamps, and the SQLite DB/WAL/SHM mtimes so usage-only updates stay visible.

This covers metadata and usage from the issue's reported schema. Live ZCode compatibility and transcript-message storage need a sample DB, local install, or upstream schema source.

Closes #1003


Co-authored-by: Rod Boev <rodboev@users.noreply.github.com>

Author: rodboev

internal/parser/provider.go

@@ -484,6 +484,8 @@ func providerFactoryForDef(def AgentDef) ProviderFactory {
 		return newVSCodeCopilotProviderFactory(def)
 	case AgentVibe:
 		return newVibeProviderFactory(def)
+	case AgentZCode:
+		return newZcodeProviderFactory(def)
 	case AgentWarp:
 		return newWarpProviderFactory(def)
 	case AgentWorkBuddy:

internal/parser/provider_migration.go

@@ -51,6 +51,7 @@ var providerMigrationModes = map[AgentType]ProviderMigrationMode{
 	AgentPiebald:        ProviderMigrationProviderAuthoritative,
 	AgentWarp:           ProviderMigrationProviderAuthoritative,
 	AgentPositron:       ProviderMigrationProviderAuthoritative,
+	AgentZCode:          ProviderMigrationProviderAuthoritative,
 	AgentAntigravity:    ProviderMigrationProviderAuthoritative,
 	AgentAntigravityCLI: ProviderMigrationProviderAuthoritative,
 	AgentVibe:           ProviderMigrationProviderAuthoritative,

internal/parser/types.go

@@ -46,6 +46,7 @@ const (
 	AgentPiebald        AgentType = "piebald"
 	AgentWarp           AgentType = "warp"
 	AgentPositron       AgentType = "positron"
+	AgentZCode          AgentType = "zcode"
 	AgentAntigravity    AgentType = "antigravity"
 	AgentAntigravityCLI AgentType = "antigravity-cli"
 	AgentVibe           AgentType = "vibe"
@@ -510,6 +511,21 @@ var Registry = []AgentDef{
 		WatchSubdirs: []string{"workspaceStorage"},
 		FileBased:    true,
 	},
+	{
+		Type:        AgentZCode,
+		DisplayName: "ZCode",
+		EnvVar:      "ZCODE_DIR",
+		ConfigKey:   "zcode_dirs",
+		DefaultDirs: []string{
+			".zcode/cli/db",
+			".zcode/cli",
+		},
+		IDPrefix:  "zcode:",
+		FileBased: false,
+		Usage: UsageCapabilities{
+			NoPerMessageTokenData: true,
+		},
+	},
 	{
 		Type:         AgentZed,
 		DisplayName:  "Zed",

internal/parser/types_test.go

@@ -437,6 +437,7 @@ func TestRegistryCompleteness(t *testing.T) {
 		AgentPiebald,
 		AgentWarp,
 		AgentPositron,
+		AgentZCode,
 		AgentZed,
 		AgentAntigravity,
 		AgentAntigravityCLI,
@@ -586,6 +587,17 @@ func TestZedRegistryEntry(t *testing.T) {
 	assert.Equal(t, "zed:", def.IDPrefix)
 }
 
+func TestZCodeRegistryEntry(t *testing.T) {
+	def, ok := AgentByType(AgentZCode)
+	require.True(t, ok, "AgentZCode missing from Registry")
+	require.False(t, def.FileBased, "ZCode FileBased")
+	assert.Equal(t, "ZCODE_DIR", def.EnvVar)
+	assert.Equal(t, "zcode_dirs", def.ConfigKey)
+	assert.Equal(t, []string{".zcode/cli/db", ".zcode/cli"}, def.DefaultDirs)
+	assert.Equal(t, "zcode:", def.IDPrefix)
+	assert.True(t, def.Usage.NoPerMessageTokenData)
+}
+
 func TestShelleyRegistryEntry(t *testing.T) {
 	def, ok := AgentByType(AgentShelley)
 	require.True(t, ok, "AgentShelley missing from Registry")