@try-works/dsh-tool-mode 0.0.0-stage → 0.5.44

package/client/client.model-tools.js

@@ -0,0 +1,1910 @@
+// Generated by scripts/gen-remote-artifacts.mjs from remote/spec.mjs — do not edit.
+//
+// The package-local chunk the browser half loads with
+// require.async('./client.model-tools.js'). It carries the same strict descriptors as
+// the ESM ./remote artifact; see remote/spec.mjs for the wire contract.
+window.__ModuleLoader__.load({
+  id: "@try-works/dsh-tool-mode",
+  chunk: "client.model-tools.js",
+  factory(require) {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    const PACKAGE = "@try-works/dsh-tool-mode"
+    const SERVICE = "modelTools"
+    const NAMESPACE = "modelTools"
+    const INSTALL_WIRE_METHOD = "installExtension"
+
+    function parseModelToolsValue(schema, value) {
+  switch (schema.kind) {
+    case 'string':
+      if (typeof value !== 'string') throw new TypeError('expected a string')
+      return value
+    case 'boolean':
+      if (typeof value !== 'boolean') throw new TypeError('expected a boolean')
+      return value
+    case 'number':
+      if (typeof value !== 'number' || !Number.isFinite(value)) throw new TypeError('expected a finite number')
+      return value
+    case 'json':
+      return value
+    case 'null':
+      if (value !== null) throw new TypeError('expected null')
+      return null
+    case 'literal':
+      if (value !== schema.value) throw new TypeError('expected ' + JSON.stringify(schema.value))
+      return value
+    case 'optional':
+      return value === undefined ? undefined : parseModelToolsValue(schema.of, value)
+    case 'nullable':
+      return value === null ? null : parseModelToolsValue(schema.of, value)
+    case 'array':
+      if (!Array.isArray(value)) throw new TypeError('expected an array')
+      return value.map((item) => parseModelToolsValue(schema.of, item))
+    case 'record': {
+      if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError('expected a string-keyed record')
+      }
+      const parsed = {}
+      for (const [key, item] of Object.entries(value)) parsed[key] = parseModelToolsValue(schema.of, item)
+      return parsed
+    }
+    case 'object': {
+      if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError('expected an object')
+      }
+      const parsed = {}
+      for (const [key, field] of Object.entries(schema.fields)) {
+        const raw = value[key]
+        if (field.kind === 'optional') {
+          const item = parseModelToolsValue(field, raw)
+          if (item !== undefined) parsed[key] = item
+          continue
+        }
+        if (raw === undefined) throw new TypeError('missing field ' + JSON.stringify(key))
+        parsed[key] = parseModelToolsValue(field, raw)
+      }
+      return parsed
+    }
+    case 'union': {
+      let last
+      for (const variant of schema.of) {
+        try {
+          return parseModelToolsValue(variant, value)
+        } catch (error) {
+          last = error
+        }
+      }
+      throw new TypeError('value matched no union variant: ' + last.message)
+    }
+    default:
+      throw new TypeError('unknown schema kind ' + JSON.stringify(schema.kind))
+  }
+}
+
+    function codecForModelToolsValue(typeSymbol, schema) {
+  let parser
+  return {
+    mode: 'strict',
+    typeSymbol,
+    create: () => (parser ??= { parse: (value) => parseModelToolsValue(schema, value) }),
+  }
+}
+
+    function descriptorsFromModelToolsSpecs(packageName, serviceKey, namespace, specs) {
+  return specs.map((spec) => {
+    const descriptor = {
+      id: packageName + '#' + namespace + '/' + spec.method,
+      service: serviceKey,
+      namespace,
+      method: spec.method,
+      description: spec.description,
+      invocation: { kind: 'direct' },
+      parameters: spec.parameters.map((parameter) => {
+        const entry = {
+          name: parameter.name,
+          wire: parameter.wire,
+          source: 'json',
+          codec: codecForModelToolsValue(parameter.typeSymbol, parameter.schema),
+          strictCodec: codecForModelToolsValue(parameter.strictTypeSymbol, parameter.schema),
+        }
+        if (parameter.description !== undefined) entry.description = parameter.description
+        if (parameter.acceptsUndefined === true) entry.acceptsUndefined = true
+        return entry
+      }),
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: spec.result.typeSymbol,
+        create: codecForModelToolsValue(spec.result.typeSymbol, spec.result.schema).create,
+        description: spec.result.description,
+      },
+    }
+    if (spec.implementation !== undefined) descriptor.implementation = spec.implementation
+    return descriptor
+  })
+}
+
+    const METHOD_SPECS = [
+  {
+    "method": "describe",
+    "description": "Read the current extension state; the page calls it on mount and after each action.",
+    "parameters": [],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/describe:result",
+      "description": "the extension surface as the host currently sees it.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "store": {
+            "kind": "nullable",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "writable": {
+            "kind": "boolean"
+          },
+          "sourceDir": {
+            "kind": "nullable",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "extensions": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "id": {
+                  "kind": "string"
+                },
+                "package": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "version": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "installed": {
+                  "kind": "boolean"
+                },
+                "active": {
+                  "kind": "boolean"
+                },
+                "disabled": {
+                  "kind": "boolean"
+                },
+                "integrity": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "unchanged"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "changed"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "unknown"
+                    }
+                  ]
+                },
+                "tools": {
+                  "kind": "array",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "reason": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "requirements": {
+                  "kind": "optional",
+                  "of": {
+                    "kind": "array",
+                    "of": {
+                      "kind": "object",
+                      "fields": {
+                        "kind": {
+                          "kind": "union",
+                          "of": [
+                            {
+                              "kind": "literal",
+                              "value": "store"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "source"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "dependencies"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "runtime"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "assets"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "executable"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "harness-model"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "platform"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "integrity"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "activation"
+                            }
+                          ]
+                        },
+                        "satisfied": {
+                          "kind": "boolean"
+                        },
+                        "reason": {
+                          "kind": "string"
+                        },
+                        "action": {
+                          "kind": "union",
+                          "of": [
+                            {
+                              "kind": "literal",
+                              "value": "install"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "prepare"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "enable"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "config"
+                            },
+                            {
+                              "kind": "literal",
+                              "value": "none"
+                            }
+                          ]
+                        }
+                      }
+                    }
+                  }
+                },
+                "blocked": {
+                  "kind": "optional",
+                  "of": {
+                    "kind": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "installExtension",
+    "implementation": "install",
+    "description": "Install one extension from `source`, or the configured first-party source.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the extension id, for example `@try-works/extension-laya`.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/install:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/install:id",
+        "schema": {
+          "kind": "string"
+        }
+      },
+      {
+        "name": "source",
+        "wire": "source",
+        "description": "an explicit install directory; absent means the configured first-party source.",
+        "acceptsUndefined": true,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/install:source",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/install:source",
+        "schema": {
+          "kind": "optional",
+          "of": {
+            "kind": "string"
+          }
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/install:result",
+      "description": "the installed extension; installation is not activation.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "version": {
+            "kind": "string"
+          },
+          "active": {
+            "kind": "boolean"
+          },
+          "source": {
+            "kind": "optional",
+            "of": {
+              "kind": "union",
+              "of": [
+                {
+                  "kind": "literal",
+                  "value": "registry"
+                },
+                {
+                  "kind": "literal",
+                  "value": "directory"
+                }
+              ]
+            }
+          },
+          "resolvedVersion": {
+            "kind": "optional",
+            "of": {
+              "kind": "string"
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "enable",
+    "description": "Activate an installed extension (removes it from `disabledExtensions`).",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the extension id to activate.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/enable:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/enable:id",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/enable:result",
+      "description": "the extension state after activation.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "active": {
+            "kind": "boolean"
+          },
+          "disabled": {
+            "kind": "boolean"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "disable",
+    "description": "Deactivate an extension (adds it to `disabledExtensions`).",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the extension id to deactivate.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/disable:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/disable:id",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/disable:result",
+      "description": "the extension state after deactivation.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "active": {
+            "kind": "boolean"
+          },
+          "disabled": {
+            "kind": "boolean"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "prepare",
+    "description": "Acquire and verify the installed extension's model assets, then record the readiness a following enable needs.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the installed extension id to prepare.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/prepare:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/prepare:id",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/prepare:result",
+      "description": "the preparation outcome, its RES-02 disclosure, and the readiness recorded for each declared model.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "prepared": {
+            "kind": "boolean"
+          },
+          "reason": {
+            "kind": "nullable",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "plan": {
+            "kind": "nullable",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "modelId": {
+                  "kind": "string"
+                },
+                "modelRevision": {
+                  "kind": "string"
+                },
+                "assets": {
+                  "kind": "array",
+                  "of": {
+                    "kind": "object",
+                    "fields": {
+                      "assetId": {
+                        "kind": "string"
+                      },
+                      "bytes": {
+                        "kind": "number"
+                      },
+                      "source": {
+                        "kind": "string"
+                      },
+                      "executable": {
+                        "kind": "boolean"
+                      }
+                    }
+                  }
+                },
+                "totalBytes": {
+                  "kind": "number"
+                },
+                "storageBytes": {
+                  "kind": "number"
+                },
+                "requiresExecutableApproval": {
+                  "kind": "boolean"
+                },
+                "license": {
+                  "kind": "object",
+                  "fields": {
+                    "name": {
+                      "kind": "string"
+                    },
+                    "url": {
+                      "kind": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "readiness": {
+            "kind": "record",
+            "of": {
+              "kind": "union",
+              "of": [
+                {
+                  "kind": "literal",
+                  "value": "unavailable"
+                },
+                {
+                  "kind": "literal",
+                  "value": "needs-preparation"
+                },
+                {
+                  "kind": "literal",
+                  "value": "preparing"
+                },
+                {
+                  "kind": "literal",
+                  "value": "prepared-cold"
+                },
+                {
+                  "kind": "literal",
+                  "value": "loading"
+                },
+                {
+                  "kind": "literal",
+                  "value": "ready"
+                },
+                {
+                  "kind": "literal",
+                  "value": "busy"
+                },
+                {
+                  "kind": "literal",
+                  "value": "failed"
+                }
+              ]
+            }
+          },
+          "groups": {
+            "kind": "array",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "activationReady": {
+            "kind": "boolean"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "setToolEnabled",
+    "description": "Enable or disable ONE tool of an installed extension through the running host.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the extension id.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:id",
+        "schema": {
+          "kind": "string"
+        }
+      },
+      {
+        "name": "toolName",
+        "wire": "toolName",
+        "description": "the caller-facing tool name to toggle.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:toolName",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:toolName",
+        "schema": {
+          "kind": "string"
+        }
+      },
+      {
+        "name": "enabled",
+        "wire": "enabled",
+        "description": "the desired enabled state.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:enabled",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:enabled",
+        "schema": {
+          "kind": "boolean"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/setToolEnabled:result",
+      "description": "the extension, tool and state after the toggle.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "toolName": {
+            "kind": "string"
+          },
+          "enabled": {
+            "kind": "boolean"
+          },
+          "active": {
+            "kind": "boolean"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "uninstall",
+    "description": "Uninstall an extension through the running host; an active extension requires explicit deactivation.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "the extension id.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/uninstall:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/uninstall:id",
+        "schema": {
+          "kind": "string"
+        }
+      },
+      {
+        "name": "deactivate",
+        "wire": "deactivate",
+        "description": "whether to deactivate first; absent means false.",
+        "acceptsUndefined": true,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/uninstall:deactivate",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/uninstall:deactivate",
+        "schema": {
+          "kind": "optional",
+          "of": {
+            "kind": "boolean"
+          }
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/uninstall:result",
+      "description": "the extension removed and its resulting active state.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "id": {
+            "kind": "string"
+          },
+          "removed": {
+            "kind": "boolean"
+          },
+          "active": {
+            "kind": "boolean"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "toolSources",
+    "description": "List the registered tools with owner attribution (extension, Tool Mode, MCP, pinned first party, unknown).",
+    "parameters": [],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/toolSources:result",
+      "description": "the tool catalog with owner attribution.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "tools": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "name": {
+                  "kind": "string"
+                },
+                "description": {
+                  "kind": "string"
+                },
+                "owner": {
+                  "kind": "string"
+                },
+                "kind": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "built-in"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "extension"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "tool-mode"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "mcp"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "unknown"
+                    }
+                  ]
+                },
+                "origin": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "dsh-core"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "extension"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "tool-mode"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "mcp"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "unknown"
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "toolInventory",
+    "description": "Read the live tool inventory: registered tools plus installed extension tools, with state, kind and usage.",
+    "parameters": [],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/toolInventory:result",
+      "description": "every inventory row, including tools that were never called.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "tools": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "name": {
+                  "kind": "string"
+                },
+                "description": {
+                  "kind": "string"
+                },
+                "owner": {
+                  "kind": "string"
+                },
+                "kind": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "built-in"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "extension"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "tool-mode"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "mcp"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "unknown"
+                    }
+                  ]
+                },
+                "origin": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "dsh-core"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "extension"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "tool-mode"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "mcp"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "unknown"
+                    }
+                  ]
+                },
+                "state": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "active"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "prepared-cold"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "failed"
+                    }
+                  ]
+                },
+                "extension": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "version": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "extensionVersion": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "contractVersion": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "argumentCount": {
+                  "kind": "number"
+                },
+                "lastRegistered": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "mcpExposed": {
+                  "kind": "boolean"
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "success": {
+                  "kind": "number"
+                },
+                "lastUsed": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "mcpStatus",
+    "description": "Read the MCP surface status: the bound endpoint, auth mode, clients, and exposed/withheld tools.",
+    "parameters": [],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/mcpStatus:result",
+      "description": "the MCP status derived from the bound endpoint, identities, surface and ledger.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "enabled": {
+            "kind": "boolean"
+          },
+          "listening": {
+            "kind": "boolean"
+          },
+          "endpoint": {
+            "kind": "nullable",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "host": {
+                  "kind": "string"
+                },
+                "port": {
+                  "kind": "number"
+                },
+                "path": {
+                  "kind": "string"
+                },
+                "url": {
+                  "kind": "string"
+                }
+              }
+            }
+          },
+          "configured": {
+            "kind": "nullable",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "host": {
+                  "kind": "string"
+                },
+                "port": {
+                  "kind": "number"
+                },
+                "path": {
+                  "kind": "string"
+                }
+              }
+            }
+          },
+          "transport": {
+            "kind": "literal",
+            "value": "http"
+          },
+          "auth": {
+            "kind": "object",
+            "fields": {
+              "scheme": {
+                "kind": "union",
+                "of": [
+                  {
+                    "kind": "literal",
+                    "value": "static-token"
+                  },
+                  {
+                    "kind": "literal",
+                    "value": "oauth-resource-server"
+                  },
+                  {
+                    "kind": "literal",
+                    "value": "none"
+                  }
+                ]
+              },
+              "mode": {
+                "kind": "union",
+                "of": [
+                  {
+                    "kind": "literal",
+                    "value": "static-token"
+                  },
+                  {
+                    "kind": "literal",
+                    "value": "oauth-resource-server"
+                  },
+                  {
+                    "kind": "literal",
+                    "value": "none"
+                  }
+                ]
+              },
+              "tokenFile": {
+                "kind": "nullable",
+                "of": {
+                  "kind": "string"
+                }
+              }
+            }
+          },
+          "uptimeMs": {
+            "kind": "number"
+          },
+          "clients": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "clientId": {
+                  "kind": "string"
+                },
+                "id": {
+                  "kind": "string"
+                },
+                "label": {
+                  "kind": "string"
+                },
+                "grantId": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "errors": {
+                  "kind": "number"
+                },
+                "lastSeen": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                }
+              }
+            }
+          },
+          "exposed": {
+            "kind": "array",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "withheld": {
+            "kind": "array",
+            "of": {
+              "kind": "string"
+            }
+          },
+          "exposedCount": {
+            "kind": "number"
+          },
+          "withheldCount": {
+            "kind": "number"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "mcpCalls",
+    "description": "Read the external MCP call log, newest first, from the persisted ledger.",
+    "parameters": [
+      {
+        "name": "query",
+        "wire": "query",
+        "description": "an optional client filter and page; absent means page 1 with the default size.",
+        "acceptsUndefined": true,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/mcpCalls:query",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/mcpCalls:query",
+        "schema": {
+          "kind": "optional",
+          "of": {
+            "kind": "object",
+            "fields": {
+              "clientId": {
+                "kind": "optional",
+                "of": {
+                  "kind": "string"
+                }
+              },
+              "page": {
+                "kind": "optional",
+                "of": {
+                  "kind": "number"
+                }
+              },
+              "pageSize": {
+                "kind": "optional",
+                "of": {
+                  "kind": "number"
+                }
+              }
+            }
+          }
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/mcpCalls:result",
+      "description": "one page of external calls plus the matching total and ledger client identities.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "calls": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "time": {
+                  "kind": "number"
+                },
+                "tool": {
+                  "kind": "string"
+                },
+                "clientId": {
+                  "kind": "string"
+                },
+                "grantId": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "totalMs": {
+                  "kind": "number"
+                },
+                "queuedMs": {
+                  "kind": "number"
+                },
+                "loadMs": {
+                  "kind": "number"
+                },
+                "inferenceMs": {
+                  "kind": "number"
+                },
+                "failureClass": {
+                  "kind": "string"
+                },
+                "reason": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "inputBytes": {
+                  "kind": "number"
+                },
+                "outputBytes": {
+                  "kind": "number"
+                },
+                "receiptId": {
+                  "kind": "string"
+                }
+              }
+            }
+          },
+          "total": {
+            "kind": "number"
+          },
+          "page": {
+            "kind": "number"
+          },
+          "pageSize": {
+            "kind": "number"
+          },
+          "clients": {
+            "kind": "array",
+            "of": {
+              "kind": "string"
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "toolUsageReport",
+    "description": "Aggregate tool usage over an explicit range from the session projection detail.",
+    "parameters": [
+      {
+        "name": "query",
+        "wire": "query",
+        "description": "an optional named range or explicit from/to epoch milliseconds.",
+        "acceptsUndefined": true,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/toolUsageReport:query",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/toolUsageReport:query",
+        "schema": {
+          "kind": "optional",
+          "of": {
+            "kind": "object",
+            "fields": {
+              "range": {
+                "kind": "optional",
+                "of": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "24h"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "7d"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "30d"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "all"
+                    }
+                  ]
+                }
+              },
+              "from": {
+                "kind": "optional",
+                "of": {
+                  "kind": "number"
+                }
+              },
+              "to": {
+                "kind": "optional",
+                "of": {
+                  "kind": "number"
+                }
+              }
+            }
+          }
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/toolUsageReport:result",
+      "description": "the range rollups: totals, by tool/model/owner/workspace/day/error code, and recent calls.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "range": {
+            "kind": "union",
+            "of": [
+              {
+                "kind": "literal",
+                "value": "24h"
+              },
+              {
+                "kind": "literal",
+                "value": "7d"
+              },
+              {
+                "kind": "literal",
+                "value": "30d"
+              },
+              {
+                "kind": "literal",
+                "value": "all"
+              }
+            ]
+          },
+          "from": {
+            "kind": "number"
+          },
+          "to": {
+            "kind": "number"
+          },
+          "calls": {
+            "kind": "number"
+          },
+          "errors": {
+            "kind": "number"
+          },
+          "unsettled": {
+            "kind": "number"
+          },
+          "toolMs": {
+            "kind": "number"
+          },
+          "codeCalls": {
+            "kind": "number"
+          },
+          "sessions": {
+            "kind": "number"
+          },
+          "uniqueTools": {
+            "kind": "number"
+          },
+          "successRate": {
+            "kind": "nullable",
+            "of": {
+              "kind": "number"
+            }
+          },
+          "p50": {
+            "kind": "nullable",
+            "of": {
+              "kind": "number"
+            }
+          },
+          "p95": {
+            "kind": "nullable",
+            "of": {
+              "kind": "number"
+            }
+          },
+          "tools": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "name": {
+                  "kind": "string"
+                },
+                "owner": {
+                  "kind": "string"
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "errors": {
+                  "kind": "number"
+                },
+                "unsettled": {
+                  "kind": "number"
+                },
+                "codeCalls": {
+                  "kind": "number"
+                },
+                "directCalls": {
+                  "kind": "number"
+                },
+                "totalMs": {
+                  "kind": "number"
+                },
+                "maxMs": {
+                  "kind": "number"
+                },
+                "p50": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "p95": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "firstUsed": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "lastUsed": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "argsBytes": {
+                  "kind": "number"
+                },
+                "resultBytes": {
+                  "kind": "number"
+                }
+              }
+            }
+          },
+          "models": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "model": {
+                  "kind": "string"
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "errors": {
+                  "kind": "number"
+                },
+                "tools": {
+                  "kind": "number"
+                },
+                "ms": {
+                  "kind": "number"
+                },
+                "p50": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "p95": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                }
+              }
+            }
+          },
+          "days": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "day": {
+                  "kind": "string"
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "errors": {
+                  "kind": "number"
+                },
+                "ms": {
+                  "kind": "number"
+                },
+                "unsettled": {
+                  "kind": "number"
+                }
+              }
+            }
+          },
+          "workspaces": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "workspace": {
+                  "kind": "string"
+                },
+                "sessions": {
+                  "kind": "number"
+                },
+                "calls": {
+                  "kind": "number"
+                },
+                "errors": {
+                  "kind": "number"
+                },
+                "ms": {
+                  "kind": "number"
+                }
+              }
+            }
+          },
+          "errorCodes": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "code": {
+                  "kind": "string"
+                },
+                "calls": {
+                  "kind": "number"
+                }
+              }
+            }
+          },
+          "recentCalls": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "time": {
+                  "kind": "number"
+                },
+                "name": {
+                  "kind": "string"
+                },
+                "owner": {
+                  "kind": "string"
+                },
+                "model": {
+                  "kind": "string"
+                },
+                "ms": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "number"
+                  }
+                },
+                "ok": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "boolean"
+                  }
+                },
+                "errorCode": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "kind": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "direct"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "code"
+                    }
+                  ]
+                },
+                "callId": {
+                  "kind": "string"
+                },
+                "parentCallId": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                },
+                "sessionId": {
+                  "kind": "string"
+                },
+                "workspace": {
+                  "kind": "nullable",
+                  "of": {
+                    "kind": "string"
+                  }
+                }
+              }
+            }
+          },
+          "histogramScope": {
+            "kind": "literal",
+            "value": "retained"
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "customToolsDescribe",
+    "description": "List the profile-scoped custom tools and their enabled/exposure state.",
+    "parameters": [],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDescribe:result",
+      "description": "the custom-tool store and its active records.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "store": {
+            "kind": "string"
+          },
+          "writable": {
+            "kind": "boolean"
+          },
+          "tools": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "id": {
+                  "kind": "string"
+                },
+                "name": {
+                  "kind": "string"
+                },
+                "title": {
+                  "kind": "string"
+                },
+                "description": {
+                  "kind": "string"
+                },
+                "kind": {
+                  "kind": "union",
+                  "of": [
+                    {
+                      "kind": "literal",
+                      "value": "http"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "prompt"
+                    },
+                    {
+                      "kind": "literal",
+                      "value": "composite"
+                    }
+                  ]
+                },
+                "version": {
+                  "kind": "number"
+                },
+                "enabled": {
+                  "kind": "boolean"
+                },
+                "agentExpose": {
+                  "kind": "boolean"
+                },
+                "mcpExpose": {
+                  "kind": "boolean"
+                },
+                "updatedAt": {
+                  "kind": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "customToolsGet",
+    "description": "Read one full custom-tool record for editing; credential values are never included.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "custom-tool id.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsGet:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsGet:id",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsGet:result",
+      "description": "the active record, or null when it is not present.",
+      "schema": {
+        "kind": "nullable",
+        "of": {
+          "kind": "json"
+        }
+      }
+    }
+  },
+  {
+    "method": "customToolsDraft",
+    "description": "Ask the host model to draft a custom tool from a description; never saves or executes it.",
+    "parameters": [
+      {
+        "name": "description",
+        "wire": "description",
+        "description": "natural-language description.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDraft:description",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDraft:description",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDraft:result",
+      "description": "a validated draft or a named failure; the draft is not saved.",
+      "schema": {
+        "kind": "json"
+      }
+    }
+  },
+  {
+    "method": "customToolsValidate",
+    "description": "Validate a custom-tool draft without persisting or executing it.",
+    "parameters": [
+      {
+        "name": "draft",
+        "wire": "draft",
+        "description": "the user-authored draft.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsValidate:draft",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsValidate:draft",
+        "schema": {
+          "kind": "json"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsValidate:result",
+      "description": "the validation verdict and field issues.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "ok": {
+            "kind": "boolean"
+          },
+          "issues": {
+            "kind": "array",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "path": {
+                  "kind": "string"
+                },
+                "message": {
+                  "kind": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "customToolsTest",
+    "description": "Execute a custom-tool draft once with sample arguments; never persists or registers it.",
+    "parameters": [
+      {
+        "name": "draft",
+        "wire": "draft",
+        "description": "the draft to execute.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsTest:draft",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsTest:draft",
+        "schema": {
+          "kind": "json"
+        }
+      },
+      {
+        "name": "args",
+        "wire": "args",
+        "description": "sample arguments.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsTest:args",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsTest:args",
+        "schema": {
+          "kind": "json"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsTest:result",
+      "description": "the test value or a named failure.",
+      "schema": {
+        "kind": "object",
+        "fields": {
+          "ok": {
+            "kind": "boolean"
+          },
+          "value": {
+            "kind": "optional",
+            "of": {
+              "kind": "json"
+            }
+          },
+          "error": {
+            "kind": "optional",
+            "of": {
+              "kind": "object",
+              "fields": {
+                "code": {
+                  "kind": "string"
+                },
+                "message": {
+                  "kind": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  {
+    "method": "customToolsSave",
+    "description": "Validate, persist and register a new immutable custom-tool version.",
+    "parameters": [
+      {
+        "name": "draft",
+        "wire": "draft",
+        "description": "the draft to save.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSave:draft",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSave:draft",
+        "schema": {
+          "kind": "json"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSave:result",
+      "description": "the persisted record.",
+      "schema": {
+        "kind": "json"
+      }
+    }
+  },
+  {
+    "method": "customToolsSetEnabled",
+    "description": "Enable or disable a saved custom tool and reconcile its registration.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "custom-tool id.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSetEnabled:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSetEnabled:id",
+        "schema": {
+          "kind": "string"
+        }
+      },
+      {
+        "name": "enabled",
+        "wire": "enabled",
+        "description": "desired state.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSetEnabled:enabled",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSetEnabled:enabled",
+        "schema": {
+          "kind": "boolean"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsSetEnabled:result",
+      "description": "the updated record.",
+      "schema": {
+        "kind": "json"
+      }
+    }
+  },
+  {
+    "method": "customToolsDelete",
+    "description": "Delete the active pointer for a custom tool and remove its registration.",
+    "parameters": [
+      {
+        "name": "id",
+        "wire": "id",
+        "description": "custom-tool id.",
+        "acceptsUndefined": false,
+        "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDelete:id",
+        "strictTypeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDelete:id",
+        "schema": {
+          "kind": "string"
+        }
+      }
+    ],
+    "result": {
+      "typeSymbol": "@try-works/dsh-tool-mode#modelTools/customToolsDelete:result",
+      "description": "whether an active record was removed.",
+      "schema": {
+        "kind": "boolean"
+      }
+    }
+  }
+]
+
+    const contribution = {
+      package: PACKAGE,
+      descriptors: descriptorsFromModelToolsSpecs(PACKAGE, SERVICE, NAMESPACE, METHOD_SPECS),
+    }
+
+    /**
+     * Mount the contribution in the calling client plugin's fiber.
+     * @param ctx - the client Cordis context whose Remote service is available.
+     * @returns null when this Host/assembly has no Client Remote service, else
+     *   the Remote service and the namespace disposer.
+     */
+    async function mount(ctx) {
+      const remote = typeof ctx?.get === 'function' ? ctx.get('remote') : undefined
+      if (remote === undefined || remote === null || typeof remote.$mount !== 'function') return null
+      const dispose = await remote.$mount(contribution)
+      return { remote, dispose }
+    }
+
+    exports.contribution = contribution
+    exports.mount = mount
+    return module.exports
+  },
+})