@khorsheed/dsh-capability-catalog 0.1.97 → 0.1.99

package/lib/typert.host.js

@@ -1,6 +1,8 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
 import { z } from 'zod'
 
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
 let CatalogJsonValueRemoteCodec$schema$value
 const CatalogJsonValueRemoteCodec$schema = () => (CatalogJsonValueRemoteCodec$schema$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema())).readonly()]))
 let CatalogJsonValueRemoteCodec$schema2$value
@@ -16,19 +18,19 @@ const CatalogJsonValueRemoteCodec$schema6 = () => (CatalogJsonValueRemoteCodec$s
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0$schema$value ??= z.object({
   'channel': z.union([z.literal("zip"), z.literal("github"), z.literal("command")]).readonly(),
-  'payload': z.string().readonly(),
-  'repo': z.string().readonly().optional(),
-  'skills': z.array(z.string()).readonly().optional(),
-  'modelInvocable': z.boolean().readonly(),
-  'root': z.union([z.literal("user"), z.literal("project")]).readonly(),
-  'overwrite': z.boolean().readonly().optional(),
+  'payload': z.string().readonly().describe('Base64-encoded zip/tgz bytes for `zip`; opaque for `github`.'),
+  'repo': z.string().readonly().optional().describe('owner/repo, a git URL (a host-prefixed or pasted link and an in-repo subpath resolve to the same clone), or a local dir path for `command`.'),
+  'skills': z.array(z.string()).readonly().optional().describe('Selected skill sub-directory names when `repo` is a multi-skill container dir.'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the added skill is model-invocable (written as disable-model-invocation inversely).'),
+  'root': z.union([z.literal("user"), z.literal("project")]).readonly().describe('Target root: user (`$DSH_HOME/skills`) or project (`.agents/skills`).'),
+  'overwrite': z.boolean().readonly().optional().describe('When true, an existing same-name skill in the target root is replaced instead of prompting.'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_result$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_result$schema$value ??= z.object({
   'ok': z.boolean().readonly(),
   'error': z.string().readonly().optional(),
   'name': z.string().readonly().optional(),
-  'exists': z.boolean().readonly().optional(),
+  'exists': z.boolean().readonly().optional().describe('Set on a soft "skill already exists" refusal (ok:false) so the UI can offer overwrite.'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0$schema$value ??= z.string())
@@ -57,15 +59,15 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_result$schema =
   'userInvocable': z.boolean().readonly(),
   'path': z.string().readonly().optional(),
   'whenToUse': z.string().readonly().optional(),
-  'content': z.string().readonly(),
-  'metadataText': z.string().readonly().optional(),
+  'content': z.string().readonly().describe('Full SKILL.md body.'),
+  'metadataText': z.string().readonly().optional().describe('Parsed frontmatter metadata, serialized to JSON text (typert boundary is strict JSON).'),
   'credentials': z.array(z.object({
   'key': z.string().readonly(),
   'label': z.string().readonly().optional(),
-  'configured': z.boolean().readonly(),
-})).readonly().optional(),
-  'environmentRefs': z.array(z.string()).readonly().optional(),
-  'files': z.array(z.string()).readonly().optional(),
+  'configured': z.boolean().readonly().describe('Whether a value has been configured (never the value itself).'),
+})).readonly().optional().describe('Declared credentials + their configured state (metadata.credentials only).'),
+  'environmentRefs': z.array(z.string()).readonly().optional().describe('Env-var references detected in the skill body (read-only, informational — typically provided by the runtime/caller, NOT user-configurable here). A key already declared in metadata.credentials is excluded — it renders in the credential form instead.'),
+  'files': z.array(z.string()).readonly().optional().describe('Bundle-relative file paths (SKILL.md + scripts/assets/references) for a directory side.'),
 })]))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0$schema$value ??= z.string())
@@ -79,13 +81,13 @@ let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0$schem
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0$schema$value ??= z.object({
   'serverName': z.string().readonly(),
   'transport': z.union([z.literal("stdio"), z.literal("streamable-http")]).readonly(),
-  'command': z.string().readonly().optional(),
+  'command': z.string().readonly().optional().describe('stdio'),
   'args': z.array(z.string()).readonly().optional(),
   'cwd': z.string().readonly().optional(),
-  'url': z.string().readonly().optional(),
+  'url': z.string().readonly().optional().describe('streamable-http'),
   'headers': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'enabled': z.boolean().readonly(),
+  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional().describe('env (value is a secretRef marker if it came from a secret).'),
+  'enabled': z.boolean().readonly().describe('Whether the server is enabled (connected + injected).'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_result$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_result$schema$value ??= z.boolean())
@@ -96,19 +98,7 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_result$sch
   'name': z.string().readonly(),
   'description': z.string().readonly(),
   'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema5())).readonly()]).readonly().optional(),
-  'enabled': z.boolean().readonly(),
-})))
-let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpList_result$schema$value
-const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpList_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpList_result$schema$value ??= z.array(z.object({
-  'serverName': z.string().readonly(),
-  'transport': z.union([z.literal("stdio"), z.literal("streamable-http")]).readonly(),
-  'command': z.string().readonly().optional(),
-  'args': z.array(z.string()).readonly().optional(),
-  'cwd': z.string().readonly().optional(),
-  'url': z.string().readonly().optional(),
-  'headers': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'enabled': z.boolean().readonly(),
+  'enabled': z.boolean().readonly().describe('Per-tool enable/disable.'),
 })))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0$schema$value ??= z.string())
@@ -139,55 +129,55 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSnapshot_result$sch
   'servers': z.array(z.object({
   'serverName': z.string().readonly(),
   'transport': z.union([z.literal("stdio"), z.literal("streamable-http")]).readonly(),
-  'command': z.string().readonly().optional(),
+  'command': z.string().readonly().optional().describe('stdio'),
   'args': z.array(z.string()).readonly().optional(),
   'cwd': z.string().readonly().optional(),
-  'url': z.string().readonly().optional(),
+  'url': z.string().readonly().optional().describe('streamable-http'),
   'headers': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
-  'enabled': z.boolean().readonly(),
+  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional().describe('env (value is a secretRef marker if it came from a secret).'),
+  'enabled': z.boolean().readonly().describe('Whether the server is enabled (connected + injected).'),
 })).readonly(),
   'tools': z.record(z.string(), z.array(z.object({
   'name': z.string().readonly(),
   'description': z.string().readonly(),
   'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema6())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema6())).readonly()]).readonly().optional(),
-  'enabled': z.boolean().readonly(),
+  'enabled': z.boolean().readonly().describe('Per-tool enable/disable.'),
 }))).readonly().readonly(),
   'credentials': z.array(z.object({
-  'ref': z.string().readonly(),
-  'label': z.string().readonly(),
-  'configured': z.boolean().readonly(),
+  'ref': z.string().readonly().describe('Config key that holds the secret (env var name, header name, or \'query:key\').'),
+  'label': z.string().readonly().describe('Human label (e.g. the env var / header / query param name).'),
+  'configured': z.boolean().readonly().describe('Whether the credential has been configured (never the value).'),
 })).readonly(),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0$schema$value ??= z.union([z.undefined(), z.string()]))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_result$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_result$schema$value ??= z.array(z.object({
-  'preset': z.string().readonly(),
-  'name': z.string().readonly().optional(),
-  'description': z.string().readonly().optional(),
-  'isDefault': z.boolean().readonly(),
+  'preset': z.string().readonly().describe('The preset id this face was read at.'),
+  'name': z.string().readonly().optional().describe('The preset\'s published display name, when it has one.'),
+  'description': z.string().readonly().optional().describe('One sentence on what the preset is for, when it publishes one.'),
+  'isDefault': z.boolean().readonly().describe('Whether this is the deployment\'s default mode.'),
   'skills': z.array(z.object({
   'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'source': z.string().readonly(),
-  'provider': z.string().readonly(),
-  'modelInvocable': z.boolean().readonly(),
-  'userInvocable': z.boolean().readonly(),
-  'whenToUse': z.string().readonly().optional(),
-  'updatedAt': z.number().readonly().optional(),
-  'bodySha': z.string().readonly().optional(),
+  'description': z.string().readonly().describe('Short routing description.'),
+  'source': z.string().readonly().describe('Registration source bucket: project-dsh / project-agents / runtime / user-dsh / user-agents / custom / bundled.'),
+  'provider': z.string().readonly().describe('Provider that owns the skill body (e.g. `filesystem`, `skill-badge`, plugin name).'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the model may load it (in catalog).'),
+  'userInvocable': z.boolean().readonly().describe('Whether a user may invoke it via `/name`.'),
+  'whenToUse': z.string().readonly().optional().describe('Optional extra routing guidance.'),
+  'updatedAt': z.number().readonly().optional().describe('Last-modified time (epoch ms) of the skill body, when a local bundle exists.'),
+  'bodySha': z.string().readonly().optional().describe('sha256 of the skill\'s SKILL.md body — the one part of a skill that IS a capability (the procedure the model executes), carried so the capability fingerprint can be taken from a snapshot alone. Absent when the body could not be read (a remote/opaque skill, or a registry that declines the load).'),
 })).readonly(),
   'tools': z.array(z.object({
-  'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'channel': z.union([z.literal("builtin"), z.literal("plugin"), z.literal("mcp"), z.literal("unknown")]).readonly(),
-  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly(),
-  'serverName': z.string().readonly().optional(),
-  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema())).readonly()]).readonly().optional(),
-  'owner': z.string().readonly().optional(),
+  'name': z.string().readonly().describe('Wire tool name as registered.'),
+  'description': z.string().readonly().describe('Model-facing description.'),
+  'channel': z.union([z.literal("unknown"), z.literal("plugin"), z.literal("builtin"), z.literal("mcp")]).readonly().describe('Attribution result.'),
+  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly().describe('Attribution confidence: exact for prefix/whitelist hits, inferred for baseline-diff hits.'),
+  'serverName': z.string().readonly().optional().describe('MCP server name when channel === \'mcp\' (longest-match resolved).'),
+  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema())).readonly()]).readonly().optional().describe('Model-facing input parameters (JSON value), for the detail view.'),
+  'owner': z.string().readonly().optional().describe('Registrant package/owner when known.'),
 })).readonly(),
-  'unavailable': z.string().readonly().optional(),
+  'unavailable': z.string().readonly().optional().describe('Why this mode has no face; when set, both lists are empty. Present for a preset discovery already refused and for one whose standing scope would not resolve — neither is evidence that the mode loads nothing.'),
 })))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_pickDirectory_result$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_pickDirectory_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_pickDirectory_result$schema$value ??= z.union([z.literal(null), z.string()]))
@@ -214,8 +204,8 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRoster_resu
   'id': z.string().readonly(),
   'name': z.string().readonly().optional(),
   'description': z.string().readonly().optional(),
-  'broken': z.string().readonly().optional(),
-  'isDefault': z.boolean().readonly().optional(),
+  'broken': z.string().readonly().optional().describe('Why this preset cannot compose a session, when it cannot.'),
+  'isDefault': z.boolean().readonly().optional().describe('Whether a session naming no preset composes this one (the deployment default).'),
 })))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0$schema$value ??= z.object({
@@ -229,26 +219,26 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_result$
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeStatus_result$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeStatus_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeStatus_result$schema$value ??= z.object({
-  'enabled': z.boolean().readonly(),
-  'reason': z.string().readonly().optional(),
-  'root': z.string().readonly(),
-  'watching': z.boolean().readonly(),
+  'enabled': z.boolean().readonly().describe('Whether any preset is currently served.'),
+  'reason': z.string().readonly().optional().describe('Why delivery is off, or reduced — absent when fully operational.'),
+  'root': z.string().readonly().describe('The plugin-owned root the delivered skills live in.'),
+  'watching': z.boolean().readonly().describe('Whether the managed root is currently watched for changes.'),
   'skills': z.array(z.object({
   'name': z.string().readonly(),
   'description': z.string().readonly(),
   'modelInvocable': z.boolean().readonly(),
   'userInvocable': z.boolean().readonly(),
-  'path': z.string().readonly(),
-  'presets': z.array(z.string()).readonly(),
-  'delivered': z.boolean().readonly(),
-  'conflict': z.string().readonly().optional(),
+  'path': z.string().readonly().describe('The managed `SKILL.md` path.'),
+  'presets': z.array(z.string()).readonly().describe('The preset ids its frontmatter declares; empty means "every preset".'),
+  'delivered': z.boolean().readonly().describe('Whether a delivery provider currently serves it in at least one preset.'),
+  'conflict': z.string().readonly().optional().describe('The default-root path already supplying this name, when delivery is refused.'),
 })).readonly(),
   'presets': z.array(z.object({
   'presetId': z.string().readonly(),
   'skills': z.array(z.string()).readonly(),
-  'error': z.string().readonly().optional(),
+  'error': z.string().readonly().optional().describe('Why this preset\'s standing scope could not be used.'),
 })).readonly(),
-  'customRootsUnverifiable': z.boolean().readonly(),
+  'customRootsUnverifiable': z.boolean().readonly().describe('True because custom skill roots are configured in host compositions this plugin cannot read: a duplicate there would not be detected.'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0$schema$value ??= z.string())
@@ -275,23 +265,23 @@ let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema$v
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema$value ??= z.object({
   'skills': z.array(z.object({
   'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'source': z.string().readonly(),
-  'provider': z.string().readonly(),
-  'modelInvocable': z.boolean().readonly(),
-  'userInvocable': z.boolean().readonly(),
-  'whenToUse': z.string().readonly().optional(),
-  'updatedAt': z.number().readonly().optional(),
-  'bodySha': z.string().readonly().optional(),
+  'description': z.string().readonly().describe('Short routing description.'),
+  'source': z.string().readonly().describe('Registration source bucket: project-dsh / project-agents / runtime / user-dsh / user-agents / custom / bundled.'),
+  'provider': z.string().readonly().describe('Provider that owns the skill body (e.g. `filesystem`, `skill-badge`, plugin name).'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the model may load it (in catalog).'),
+  'userInvocable': z.boolean().readonly().describe('Whether a user may invoke it via `/name`.'),
+  'whenToUse': z.string().readonly().optional().describe('Optional extra routing guidance.'),
+  'updatedAt': z.number().readonly().optional().describe('Last-modified time (epoch ms) of the skill body, when a local bundle exists.'),
+  'bodySha': z.string().readonly().optional().describe('sha256 of the skill\'s SKILL.md body — the one part of a skill that IS a capability (the procedure the model executes), carried so the capability fingerprint can be taken from a snapshot alone. Absent when the body could not be read (a remote/opaque skill, or a registry that declines the load).'),
 })).readonly(),
   'tools': z.array(z.object({
-  'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'channel': z.union([z.literal("builtin"), z.literal("plugin"), z.literal("mcp"), z.literal("unknown")]).readonly(),
-  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly(),
-  'serverName': z.string().readonly().optional(),
-  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema2())).readonly()]).readonly().optional(),
-  'owner': z.string().readonly().optional(),
+  'name': z.string().readonly().describe('Wire tool name as registered.'),
+  'description': z.string().readonly().describe('Model-facing description.'),
+  'channel': z.union([z.literal("unknown"), z.literal("plugin"), z.literal("builtin"), z.literal("mcp")]).readonly().describe('Attribution result.'),
+  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly().describe('Attribution confidence: exact for prefix/whitelist hits, inferred for baseline-diff hits.'),
+  'serverName': z.string().readonly().optional().describe('MCP server name when channel === \'mcp\' (longest-match resolved).'),
+  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema2())).readonly()]).readonly().optional().describe('Model-facing input parameters (JSON value), for the detail view.'),
+  'owner': z.string().readonly().optional().describe('Registrant package/owner when known.'),
 })).readonly(),
   'mcpServers': z.array(z.object({
   'name': z.string().readonly(),
@@ -301,8 +291,26 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema
   'channel': z.string().readonly(),
   'count': z.number().readonly(),
 })).readonly(),
-  'sha': z.string().readonly().optional(),
-  'preset': z.string().readonly().optional(),
+  'sha': z.string().readonly().optional().describe('The capability hash of this snapshot (`hashOf`), filled by the host half. It is NOT part of the canonical form it digests — a snapshot carrying it and the same snapshot without it hash alike.'),
+  'preset': z.string().readonly().optional().describe('The agent preset this snapshot was taken under; absent when none resolved.'),
+  'completeness': z.object({
+  'skills': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'tools': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'mcpServers': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'channels': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+}).readonly().optional().describe('Evidence-grade per-section completeness, attached only by evidence production (the Remote listing/fingerprint verbs never set it, so their wire form is unchanged). Like `sha`, it is NOT part of the canonical form `hashOf` digests.'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0$schema$value ??= z.union([z.undefined(), z.string()]))
@@ -312,23 +320,23 @@ let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$schema
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$schema$value ??= z.object({
   'skills': z.array(z.object({
   'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'source': z.string().readonly(),
-  'provider': z.string().readonly(),
-  'modelInvocable': z.boolean().readonly(),
-  'userInvocable': z.boolean().readonly(),
-  'whenToUse': z.string().readonly().optional(),
-  'updatedAt': z.number().readonly().optional(),
-  'bodySha': z.string().readonly().optional(),
+  'description': z.string().readonly().describe('Short routing description.'),
+  'source': z.string().readonly().describe('Registration source bucket: project-dsh / project-agents / runtime / user-dsh / user-agents / custom / bundled.'),
+  'provider': z.string().readonly().describe('Provider that owns the skill body (e.g. `filesystem`, `skill-badge`, plugin name).'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the model may load it (in catalog).'),
+  'userInvocable': z.boolean().readonly().describe('Whether a user may invoke it via `/name`.'),
+  'whenToUse': z.string().readonly().optional().describe('Optional extra routing guidance.'),
+  'updatedAt': z.number().readonly().optional().describe('Last-modified time (epoch ms) of the skill body, when a local bundle exists.'),
+  'bodySha': z.string().readonly().optional().describe('sha256 of the skill\'s SKILL.md body — the one part of a skill that IS a capability (the procedure the model executes), carried so the capability fingerprint can be taken from a snapshot alone. Absent when the body could not be read (a remote/opaque skill, or a registry that declines the load).'),
 })).readonly(),
   'tools': z.array(z.object({
-  'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'channel': z.union([z.literal("builtin"), z.literal("plugin"), z.literal("mcp"), z.literal("unknown")]).readonly(),
-  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly(),
-  'serverName': z.string().readonly().optional(),
-  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema3())).readonly()]).readonly().optional(),
-  'owner': z.string().readonly().optional(),
+  'name': z.string().readonly().describe('Wire tool name as registered.'),
+  'description': z.string().readonly().describe('Model-facing description.'),
+  'channel': z.union([z.literal("unknown"), z.literal("plugin"), z.literal("builtin"), z.literal("mcp")]).readonly().describe('Attribution result.'),
+  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly().describe('Attribution confidence: exact for prefix/whitelist hits, inferred for baseline-diff hits.'),
+  'serverName': z.string().readonly().optional().describe('MCP server name when channel === \'mcp\' (longest-match resolved).'),
+  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema3())).readonly()]).readonly().optional().describe('Model-facing input parameters (JSON value), for the detail view.'),
+  'owner': z.string().readonly().optional().describe('Registrant package/owner when known.'),
 })).readonly(),
   'mcpServers': z.array(z.object({
   'name': z.string().readonly(),
@@ -338,8 +346,26 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$sche
   'channel': z.string().readonly(),
   'count': z.number().readonly(),
 })).readonly(),
-  'sha': z.string().readonly().optional(),
-  'preset': z.string().readonly().optional(),
+  'sha': z.string().readonly().optional().describe('The capability hash of this snapshot (`hashOf`), filled by the host half. It is NOT part of the canonical form it digests — a snapshot carrying it and the same snapshot without it hash alike.'),
+  'preset': z.string().readonly().optional().describe('The agent preset this snapshot was taken under; absent when none resolved.'),
+  'completeness': z.object({
+  'skills': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'tools': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'mcpServers': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'channels': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+}).readonly().optional().describe('Evidence-grade per-section completeness, attached only by evidence production (the Remote listing/fingerprint verbs never set it, so their wire form is unchanged). Like `sha`, it is NOT part of the canonical form `hashOf` digests.'),
 }))
 let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0$schema$value
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0$schema$value ??= z.union([z.undefined(), z.string()]))
@@ -349,23 +375,23 @@ let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$schem
 const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$schema$value ??= z.object({
   'skills': z.array(z.object({
   'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'source': z.string().readonly(),
-  'provider': z.string().readonly(),
-  'modelInvocable': z.boolean().readonly(),
-  'userInvocable': z.boolean().readonly(),
-  'whenToUse': z.string().readonly().optional(),
-  'updatedAt': z.number().readonly().optional(),
-  'bodySha': z.string().readonly().optional(),
+  'description': z.string().readonly().describe('Short routing description.'),
+  'source': z.string().readonly().describe('Registration source bucket: project-dsh / project-agents / runtime / user-dsh / user-agents / custom / bundled.'),
+  'provider': z.string().readonly().describe('Provider that owns the skill body (e.g. `filesystem`, `skill-badge`, plugin name).'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the model may load it (in catalog).'),
+  'userInvocable': z.boolean().readonly().describe('Whether a user may invoke it via `/name`.'),
+  'whenToUse': z.string().readonly().optional().describe('Optional extra routing guidance.'),
+  'updatedAt': z.number().readonly().optional().describe('Last-modified time (epoch ms) of the skill body, when a local bundle exists.'),
+  'bodySha': z.string().readonly().optional().describe('sha256 of the skill\'s SKILL.md body — the one part of a skill that IS a capability (the procedure the model executes), carried so the capability fingerprint can be taken from a snapshot alone. Absent when the body could not be read (a remote/opaque skill, or a registry that declines the load).'),
 })).readonly(),
   'tools': z.array(z.object({
-  'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'channel': z.union([z.literal("builtin"), z.literal("plugin"), z.literal("mcp"), z.literal("unknown")]).readonly(),
-  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly(),
-  'serverName': z.string().readonly().optional(),
-  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema4())).readonly()]).readonly().optional(),
-  'owner': z.string().readonly().optional(),
+  'name': z.string().readonly().describe('Wire tool name as registered.'),
+  'description': z.string().readonly().describe('Model-facing description.'),
+  'channel': z.union([z.literal("unknown"), z.literal("plugin"), z.literal("builtin"), z.literal("mcp")]).readonly().describe('Attribution result.'),
+  'confidence': z.union([z.literal("exact"), z.literal("inferred")]).readonly().describe('Attribution confidence: exact for prefix/whitelist hits, inferred for baseline-diff hits.'),
+  'serverName': z.string().readonly().optional().describe('MCP server name when channel === \'mcp\' (longest-match resolved).'),
+  'parameters': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => CatalogJsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => CatalogJsonValueRemoteCodec$schema4())).readonly()]).readonly().optional().describe('Model-facing input parameters (JSON value), for the detail view.'),
+  'owner': z.string().readonly().optional().describe('Registrant package/owner when known.'),
 })).readonly(),
   'mcpServers': z.array(z.object({
   'name': z.string().readonly(),
@@ -375,32 +401,143 @@ const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$sch
   'channel': z.string().readonly(),
   'count': z.number().readonly(),
 })).readonly(),
-  'sha': z.string().readonly().optional(),
-  'preset': z.string().readonly().optional(),
+  'sha': z.string().readonly().optional().describe('The capability hash of this snapshot (`hashOf`), filled by the host half. It is NOT part of the canonical form it digests — a snapshot carrying it and the same snapshot without it hash alike.'),
+  'preset': z.string().readonly().optional().describe('The agent preset this snapshot was taken under; absent when none resolved.'),
+  'completeness': z.object({
+  'skills': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'tools': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'mcpServers': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+  'channels': z.object({
+  'state': z.union([z.literal("complete"), z.literal("unavailable"), z.literal("partial")]).readonly(),
+  'reason': z.string().readonly().optional().describe('Why the section is not complete; absent when it is.'),
+}).readonly().optional(),
+}).readonly().optional().describe('Evidence-grade per-section completeness, attached only by evidence production (the Remote listing/fingerprint verbs never set it, so their wire form is unchanged). Like `sha`, it is NOT part of the canonical form `hashOf` digests.'),
+}))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0_strict$schema$value ??= z.strictObject({
+  'channel': z.union([z.literal("zip"), z.literal("github"), z.literal("command")]).readonly(),
+  'payload': z.string().readonly().describe('Base64-encoded zip/tgz bytes for `zip`; opaque for `github`.'),
+  'repo': z.string().readonly().optional().describe('owner/repo, a git URL (a host-prefixed or pasted link and an in-repo subpath resolve to the same clone), or a local dir path for `command`.'),
+  'skills': z.array(z.string()).readonly().optional().describe('Selected skill sub-directory names when `repo` is a multi-skill container dir.'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the added skill is model-invocable (written as disable-model-invocation inversely).'),
+  'root': z.union([z.literal("user"), z.literal("project")]).readonly().describe('Target root: user (`$DSH_HOME/skills`) or project (`.agents/skills`).'),
+  'overwrite': z.boolean().readonly().optional().describe('When true, an existing same-name skill in the target root is replaced instead of prompting.'),
 }))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0_strict$schema$value ??= z.strictObject({
+  'serverName': z.string().readonly(),
+  'transport': z.union([z.literal("stdio"), z.literal("streamable-http")]).readonly(),
+  'command': z.string().readonly().optional().describe('stdio'),
+  'args': z.array(z.string()).readonly().optional(),
+  'cwd': z.string().readonly().optional(),
+  'url': z.string().readonly().optional().describe('streamable-http'),
+  'headers': z.array(z.tuple([z.string(), z.string()])).readonly().optional(),
+  'env': z.array(z.tuple([z.string(), z.string()])).readonly().optional().describe('env (value is a secretRef marker if it came from a secret).'),
+  'enabled': z.boolean().readonly().describe('Whether the server is enabled (connected + injected).'),
+}))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1_strict$schema$value ??= z.boolean())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2_strict$schema$value ??= z.boolean())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0_strict$schema$value ??= z.strictObject({
+  'name': z.string().readonly(),
+  'presets': z.array(z.string()).readonly(),
+  'workdir': z.string().readonly().optional(),
+}))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0_strict$schema$value ??= z.strictObject({
+  'name': z.string().readonly(),
+  'presets': z.array(z.string()).readonly(),
+}))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1_strict$schema$value ??= z.string())
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0_strict$schema$value ??= z.strictObject({
+  'key': z.string().readonly(),
+  'value': z.string().readonly(),
+}))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0_strict$schema$value ??= z.union([z.undefined(), z.string()]))
+let _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1_strict$schema$value
+const _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1_strict$schema = () => (_khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1_strict$schema$value ??= z.union([z.undefined(), z.string()]))
 
-export const TYPERT = {
+const $remote = createTypertRemoteInfo({
   package: '@khorsheed/dsh-capability-catalog',
-  face: 'host',
-  schemas: [
-  ],
-  invocations: [
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/addSkill',
+  methods: {
+    'capabilityCatalog/addSkill': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'addSkill',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogAddSkillRequest',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"channel":{"type":"string","enum":["zip","github","command"]},"payload":{"type":"string","description":"Base64-encoded zip/tgz bytes for `zip`; opaque for `github`."},"repo":{"type":"string","description":"owner/repo, a git URL (a host-prefixed or pasted link and an in-repo subpath resolve to the same clone), or a local dir path for `command`."},"skills":{"type":"array","items":{"type":"string"},"description":"Selected skill sub-directory names when `repo` is a multi-skill container dir."},"modelInvocable":{"type":"boolean","description":"Whether the added skill is model-invocable (written as disable-model-invocation inversely)."},"root":{"type":"string","enum":["user","project"],"description":"Target root: user (`$DSH_HOME/skills`) or project (`.agents/skills`)."},"overwrite":{"type":"boolean","description":"When true, an existing same-name skill in the target root is replaced instead of prompting."}},"required":["channel","payload","modelInvocable","root"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogAddSkillRequest',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"channel":{"type":"string","enum":["zip","github","command"]},"payload":{"type":"string","description":"Base64-encoded zip/tgz bytes for `zip`; opaque for `github`."},"repo":{"type":"string","description":"owner/repo, a git URL (a host-prefixed or pasted link and an in-repo subpath resolve to the same clone), or a local dir path for `command`."},"skills":{"type":"array","items":{"type":"string"},"description":"Selected skill sub-directory names when `repo` is a multi-skill container dir."},"modelInvocable":{"type":"boolean","description":"Whether the added skill is model-invocable (written as disable-model-invocation inversely)."},"root":{"type":"string","enum":["user","project"],"description":"Target root: user (`$DSH_HOME/skills`) or project (`.agents/skills`)."},"overwrite":{"type":"boolean","description":"When true, an existing same-name skill in the target root is replaced instead of prompting."}},"required":["channel","payload","modelInvocable","root"],"additionalProperties":false},
           },
         },
       ],
@@ -409,30 +546,34 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogAddSkillResult',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_addSkill_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"},"name":{"type":"string"},"exists":{"type":"boolean","description":"Set on a soft \"skill already exists\" refusal (ok:false) so the UI can offer overwrite."}},"required":["ok"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":631,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":646,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill',
+    'capabilityCatalog/deleteSkill': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'deleteSkill',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'name',
-          wire: 'name',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:name',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:name',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'workdir',
-          wire: 'workdir',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -440,11 +581,18 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'presetId',
-          wire: 'presetId',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -452,6 +600,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:presetId',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/deleteSkill:presetId',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_parameter_2_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -460,30 +616,34 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogDeleteSkillResult',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_deleteSkill_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"}},"required":["ok"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":636,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":651,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail',
+    'capabilityCatalog/detail': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'detail',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'name',
-          wire: 'name',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:name',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:name',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'workdir',
-          wire: 'workdir',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -491,11 +651,18 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'presetId',
-          wire: 'presetId',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -503,6 +670,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:presetId',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:presetId',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_parameter_2_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -511,25 +686,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/detail:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_detail_result$schema(),
+        jsonSchemaError: 'typert tool schema: unsupported undefined value',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":597,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":612,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/listDirSkills',
+    'capabilityCatalog/listDirSkills': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'listDirSkills',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'dirPath',
-          wire: 'dirPath',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/listDirSkills:dirPath',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/listDirSkills:dirPath',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -538,25 +718,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/listDirSkills:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_listDirSkills_result$schema(),
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"kind":{"type":"string","enum":["self","child"]}},"required":["name","description"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":621,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":636,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpAdd',
+    'capabilityCatalog/mcpAdd': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpAdd',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'config',
-          wire: 'config',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogMcpServerConfig',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0$schema(),
+            jsonSchemaError: 'typert tool schema: unsupported selected tuple type',
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogMcpServerConfig',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_parameter_0_strict$schema(),
+            jsonSchemaError: 'typert tool schema: unsupported selected tuple type',
           },
         },
       ],
@@ -565,25 +750,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpAdd:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpAdd_result$schema(),
+        jsonSchema: {"type":"boolean"},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":654,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":663,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpDiscover',
+    'capabilityCatalog/mcpDiscover': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpDiscover',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'serverName',
-          wire: 'serverName',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpDiscover:serverName',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpDiscover:serverName',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -592,41 +782,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpDiscover:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpDiscover_result$schema(),
+        jsonSchemaError: 'typert tool schema: recursive selected type requires a supported JSON value declaration',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":687,"column":9},
-    },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpList',
-      service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpList',
-      invocation: { kind: 'direct' },
-      parameters: [
-      ],
-      result: {
-        mode: 'strict',
-        typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpList:result',
-        create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpList_result$schema,
-        schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpList_result$schema(),
-      },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":648,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":696,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpRemove',
+    'capabilityCatalog/mcpRemove': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpRemove',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'serverName',
-          wire: 'serverName',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpRemove:serverName',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpRemove:serverName',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -635,36 +814,48 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpRemove:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpRemove_result$schema(),
+        jsonSchema: {"type":"boolean"},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":662,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":671,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential',
+    'capabilityCatalog/mcpSetCredential': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpSetCredential',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'ref',
-          wire: 'ref',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential:ref',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential:ref',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'value',
-          wire: 'value',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential:value',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential:value',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -673,36 +864,48 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetCredential:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetCredential_result$schema(),
+        jsonSchema: {"type":"boolean"},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":675,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":684,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled',
+    'capabilityCatalog/mcpSetEnabled': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpSetEnabled',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'serverName',
-          wire: 'serverName',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled:serverName',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled:serverName',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'enabled',
-          wire: 'enabled',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled:enabled',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1$schema(),
+            jsonSchema: {"type":"boolean"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled:enabled',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_parameter_1_strict$schema(),
+            jsonSchema: {"type":"boolean"},
           },
         },
       ],
@@ -711,47 +914,66 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetEnabled:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetEnabled_result$schema(),
+        jsonSchemaError: 'typert tool schema: unsupported void value',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":669,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":678,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled',
+    'capabilityCatalog/mcpSetToolEnabled': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpSetToolEnabled',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'serverName',
-          wire: 'serverName',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:serverName',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:serverName',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'tool',
-          wire: 'tool',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:tool',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:tool',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'enabled',
-          wire: 'enabled',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:enabled',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2$schema(),
+            jsonSchema: {"type":"boolean"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:enabled',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_parameter_2_strict$schema(),
+            jsonSchema: {"type":"boolean"},
           },
         },
       ],
@@ -760,14 +982,12 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSetToolEnabled:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSetToolEnabled_result$schema(),
+        jsonSchemaError: 'typert tool schema: unsupported void value',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":681,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":690,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/mcpSnapshot',
+    'capabilityCatalog/mcpSnapshot': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'mcpSnapshot',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -776,19 +996,18 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogMcpSnapshot',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSnapshot_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_mcpSnapshot_result$schema(),
+        jsonSchemaError: 'typert tool schema: unsupported selected tuple type',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":694,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":703,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/modeFaces',
+    'capabilityCatalog/modeFaces': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'modeFaces',
+      description: 'Every mode\'s capability face in ONE call, for the cross-mode comparison view ("which modes load this tool/skill?"). This is the expensive verb of the pair: a mode whose standing scope has not been composed yet is MOUNTED by its read (see modes.ts — there is no cheap honest source, because a composition file names plugins, not the tools and skills those plugins register). The browser therefore calls it only when a human chooses to compare modes, never on opening the section. A mode that cannot be read keeps its row with `unavailable` set rather than an empty face, so the comparison never claims that a broken mode loads nothing. `preset` on a face is always the id that was asked for: a read that silently degraded to the global layer is reported as unavailable, not as that mode\'s face.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'workdir',
-          wire: 'workdir',
+          description: 'optional cwd for project-scoped skill roots.',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -796,6 +1015,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/modeFaces:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/modeFaces:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -804,14 +1031,12 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/modeFaces:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_modeFaces_result$schema(),
+        jsonSchemaError: 'typert tool schema: recursive selected type requires a supported JSON value declaration',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":344,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":351,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/pickDirectory',
+    'capabilityCatalog/pickDirectory': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'pickDirectory',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -820,25 +1045,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/pickDirectory:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_pickDirectory_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_pickDirectory_result$schema(),
+        jsonSchema: {"oneOf":[{"type":"null","const":null},{"type":"string"}]},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":643,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":658,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeAdopt',
+    'capabilityCatalog/presetScopeAdopt': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'presetScopeAdopt',
+      description: 'Move an installed skill into the managed root with a preset scope.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeAdoptRequest',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}},"workdir":{"type":"string"}},"required":["name","presets"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeAdoptRequest',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}},"workdir":{"type":"string"}},"required":["name","presets"],"additionalProperties":false},
           },
         },
       ],
@@ -847,25 +1078,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeEditResult',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeAdopt_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"}},"required":["ok"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":383,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":390,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeRelease',
+    'capabilityCatalog/presetScopeRelease': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'presetScopeRelease',
+      description: 'Move a managed skill back to the user skill root (the recovery direction).',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'name',
-          wire: 'name',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeRelease:name',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeRelease:name',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -874,14 +1111,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeEditResult',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRelease_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"}},"required":["ok"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":393,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":400,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeRoster',
+    'capabilityCatalog/presetScopeRoster': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'presetScopeRoster',
+      description: 'Every preset the roster supplies, for the scope picker.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -890,25 +1126,31 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeRoster:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRoster_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeRoster_result$schema(),
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"broken":{"type":"string","description":"Why this preset cannot compose a session, when it cannot."},"isDefault":{"type":"boolean","description":"Whether a session naming no preset composes this one (the deployment default)."}},"required":["id"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":322,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":329,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeSet',
+    'capabilityCatalog/presetScopeSet': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'presetScopeSet',
+      description: 'Declare which presets one managed skill is delivered to.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeSetRequest',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}}},"required":["name","presets"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeSetRequest',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"name":{"type":"string"},"presets":{"type":"array","items":{"type":"string"}}},"required":["name","presets"],"additionalProperties":false},
           },
         },
       ],
@@ -917,14 +1159,13 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeEditResult',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeSet_result$schema(),
+        jsonSchema: {"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"}},"required":["ok"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":375,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":382,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/presetScopeStatus',
+    'capabilityCatalog/presetScopeStatus': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'presetScopeStatus',
+      description: 'The preset-scoped delivery\'s current state, for the settings surface.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -933,41 +1174,52 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogPresetScopeStatus',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeStatus_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_presetScopeStatus_result$schema(),
+        jsonSchema: {"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether any preset is currently served."},"reason":{"type":"string","description":"Why delivery is off, or reduced — absent when fully operational."},"root":{"type":"string","description":"The plugin-owned root the delivered skills live in."},"watching":{"type":"boolean","description":"Whether the managed root is currently watched for changes."},"skills":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"modelInvocable":{"type":"boolean"},"userInvocable":{"type":"boolean"},"path":{"type":"string","description":"The managed `SKILL.md` path."},"presets":{"type":"array","items":{"type":"string"},"description":"The preset ids its frontmatter declares; empty means \"every preset\"."},"delivered":{"type":"boolean","description":"Whether a delivery provider currently serves it in at least one preset."},"conflict":{"type":"string","description":"The default-root path already supplying this name, when delivery is refused."}},"required":["name","description","modelInvocable","userInvocable","path","presets","delivered"],"additionalProperties":true}},"presets":{"type":"array","items":{"type":"object","properties":{"presetId":{"type":"string"},"skills":{"type":"array","items":{"type":"string"}},"error":{"type":"string","description":"Why this preset's standing scope could not be used."}},"required":["presetId","skills"],"additionalProperties":true}},"customRootsUnverifiable":{"type":"boolean","description":"True because custom skill roots are configured in host compositions this plugin cannot read: a duplicate there would not be detected."}},"required":["enabled","root","watching","skills","presets","customRootsUnverifiable"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":305,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":312,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile',
+    'capabilityCatalog/readSkillFile': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'readSkillFile',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'name',
-          wire: 'name',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:name',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:name',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'filePath',
-          wire: 'filePath',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:filePath',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:filePath',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'workdir',
-          wire: 'workdir',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -975,11 +1227,18 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_2_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'presetId',
-          wire: 'presetId',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -987,6 +1246,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:presetId',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:presetId',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_parameter_3_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -995,25 +1262,30 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/readSkillFile:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_readSkillFile_result$schema(),
+        jsonSchemaError: 'typert tool schema: unsupported undefined value',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":608,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":623,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/setCredential',
+    'capabilityCatalog/setCredential': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'setCredential',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogCredentialSetRequest',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0$schema(),
+            jsonSchema: {"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog/types#CatalogCredentialSetRequest',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_parameter_0_strict$schema(),
+            jsonSchema: {"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},
           },
         },
       ],
@@ -1022,19 +1294,16 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/setCredential:result',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_setCredential_result$schema(),
+        jsonSchema: {"type":"boolean"},
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":626,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":641,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshot',
+    'capabilityCatalog/snapshot': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'snapshot',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'workdir',
-          wire: 'workdir',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -1042,6 +1311,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshot:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshot:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -1050,19 +1327,18 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CapabilityCatalogSnapshot',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshot_result$schema(),
+        jsonSchemaError: 'typert tool schema: recursive selected type requires a supported JSON value declaration',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":516,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":531,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotAt',
+    'capabilityCatalog/snapshotAt': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'snapshotAt',
+      description: 'The capability face of ONE mode as a LISTING — {@link snapshot} scoped to a named preset, for the settings surface\'s mode picker. The LISTING/FINGERPRINT split matters here the way it does everywhere else: a viewer wants rows as fast as the registries can produce them, not every skill body loaded and digested. Asking for a preset\'s IDENTITY is {@link snapshotFor}. Like every scope resolution, this MOUNTS a preset nothing has composed yet. Degrades like {@link snapshot}: a preset whose standing scope refuses answers with the global layer and NO `preset` stamp, which is how a caller tells "this mode" from "the fallback" and says so.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'presetId',
-          wire: 'presetId',
+          description: 'the mode to read, or undefined for the deployment default.',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -1070,11 +1346,19 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotAt:presetId',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotAt:presetId',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'workdir',
-          wire: 'workdir',
+          description: 'optional cwd for project-scoped skill roots.',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -1082,6 +1366,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotAt:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotAt:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -1090,19 +1382,18 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CapabilityCatalogSnapshot',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotAt_result$schema(),
+        jsonSchemaError: 'typert tool schema: recursive selected type requires a supported JSON value declaration',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":537,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":552,"column":9},
     },
-    {
-      id: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotFor',
+    'capabilityCatalog/snapshotFor': {
       service: 'capabilityCatalog',
-      namespace: 'capabilityCatalog',
-      method: 'snapshotFor',
+      description: 'The capability face of ONE preset, with its {@link hashOf} digest. This is the fingerprint verb: every skill body is loaded (so the rows carry `bodySha`) and `sha` is stamped, which is what makes the answer an identity rather than a listing. `presetId` omitted reads the deployment default — the same face `snapshot` reads, now hashable. Degrades like every other verb: without a skills registry the answer is an empty face with the hash of an empty face, not a throw. Note that a preset nobody has composed yet is MOUNTED by the read (the roster\'s single-flight standing mount), so asking is not free.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'presetId',
-          wire: 'presetId',
+          description: 'the preset to fingerprint, or undefined for the default.',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -1110,11 +1401,19 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotFor:presetId',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotFor:presetId',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_0_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'workdir',
-          wire: 'workdir',
+          description: 'optional cwd for project-scoped skill roots.',
           source: 'json',
           acceptsUndefined: true,
           codec: {
@@ -1122,6 +1421,14 @@ export const TYPERT = {
             typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotFor:workdir',
             create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1$schema,
             schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1$schema(),
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@khorsheed/dsh-capability-catalog#capabilityCatalog/snapshotFor:workdir',
+            create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1_strict$schema,
+            schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_parameter_1_strict$schema(),
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -1130,10 +1437,19 @@ export const TYPERT = {
         typeSymbol: '@khorsheed/dsh-capability-catalog/types#CapabilityCatalogSnapshot',
         create: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$schema,
         schema: _khorsheed_dsh_capability_catalog_capabilityCatalog_snapshotFor_result$schema(),
+        jsonSchemaError: 'typert tool schema: recursive selected type requires a supported JSON value declaration',
       },
-      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":557,"column":9},
+      sourceLocation: {"file":"packages/capability-catalog/src/index.ts","line":572,"column":9},
     },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@khorsheed/dsh-capability-catalog',
+  face: 'host',
+  schemas: [
   ],
+  get invocations() { return $remote.descriptors },
   model: {
     "services": [
       {
@@ -1250,11 +1566,6 @@ export const TYPERT = {
             "name": "pickDirectory",
             "signature": "@Remote('pickDirectory') async pickDirectory(): Promise<string | null>"
           },
-          {
-            "kind": "method",
-            "name": "mcpList",
-            "signature": "@Remote('mcpList') async mcpList(): Promise<readonly CatalogMcpServerConfig[]>"
-          },
           {
             "kind": "method",
             "name": "mcpAdd",
@@ -1298,7 +1609,7 @@ export const TYPERT = {
           },
           {
             "name": "CapabilityCatalogSnapshot",
-            "declaration": "export interface CapabilityCatalogSnapshot {\n    readonly skills: readonly CatalogSkillRow[];\n    readonly tools: readonly CatalogToolRow[];\n    readonly mcpServers: readonly CatalogMcpServerRow[];\n    readonly channels: readonly CatalogChannelSummary[];\n    readonly sha?: string;\n    readonly preset?: string;\n}"
+            "declaration": "export interface CapabilityCatalogSnapshot {\n    readonly skills: readonly CatalogSkillRow[];\n    readonly tools: readonly CatalogToolRow[];\n    readonly mcpServers: readonly CatalogMcpServerRow[];\n    readonly channels: readonly CatalogChannelSummary[];\n    readonly sha?: string;\n    readonly preset?: string;\n    readonly completeness?: CatalogSnapshotCompleteness;\n}"
           },
           {
             "name": "CatalogAddSkillRequest",
@@ -1384,6 +1695,10 @@ export const TYPERT = {
             "name": "CatalogScopedSkillRow",
             "declaration": "export interface CatalogScopedSkillRow {\n    readonly name: string;\n    readonly description: string;\n    readonly modelInvocable: boolean;\n    readonly userInvocable: boolean;\n    readonly path: string;\n    readonly presets: readonly string[];\n    readonly delivered: boolean;\n    readonly conflict?: string;\n}"
           },
+          {
+            "name": "CatalogSectionCompleteness",
+            "declaration": "export interface CatalogSectionCompleteness {\n    readonly state: 'complete' | 'partial' | 'unavailable';\n    readonly reason?: string;\n}"
+          },
           {
             "name": "CatalogSkillDetail",
             "declaration": "export interface CatalogSkillDetail {\n    readonly name: string;\n    readonly description: string;\n    readonly source: string;\n    readonly provider: string;\n    readonly modelInvocable: boolean;\n    readonly userInvocable: boolean;\n    readonly path?: string;\n    readonly whenToUse?: string;\n    readonly content: string;\n    readonly metadataText?: string;\n    readonly credentials?: readonly CatalogCredentialState[];\n    readonly environmentRefs?: readonly string[];\n    readonly files?: readonly string[];\n}"
@@ -1396,6 +1711,10 @@ export const TYPERT = {
             "name": "CatalogSkillRow",
             "declaration": "export interface CatalogSkillRow {\n    readonly name: string;\n    readonly description: string;\n    readonly source: string;\n    readonly provider: string;\n    readonly modelInvocable: boolean;\n    readonly userInvocable: boolean;\n    readonly whenToUse?: string;\n    readonly updatedAt?: number;\n    readonly bodySha?: string;\n}"
           },
+          {
+            "name": "CatalogSnapshotCompleteness",
+            "declaration": "export interface CatalogSnapshotCompleteness {\n    readonly skills?: CatalogSectionCompleteness;\n    readonly tools?: CatalogSectionCompleteness;\n    readonly mcpServers?: CatalogSectionCompleteness;\n    readonly channels?: CatalogSectionCompleteness;\n}"
+          },
           {
             "name": "CatalogToolChannel",
             "declaration": "export type CatalogToolChannel = 'builtin' | 'plugin' | 'mcp' | 'unknown';"