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

package/node_modules/@try-works/tool-mode-extension-sdk/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@try-works/tool-mode-extension-sdk",
+  "version": "0.1.5",
+  "description": "Author-facing SDK for Tool Mode extensions: TMX manifest schema, validation, lifecycle state and management errors",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/try-works/tool-mode.git",
+    "directory": "packages/tool-mode-extension-sdk"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    "./schema/extension-manifest-1.1.0.schema.json": "./schema/extension-manifest-1.1.0.schema.json",
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "bin/*.mjs",
+    "schema/*.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "adm-zip": "^0.5.18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "tsx --test tests/*.test.ts",
+    "prepack": "tsc -p tsconfig.build.json",
+    "prepare": "tsc -p tsconfig.build.json"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "@types/adm-zip": "^0.5.8"
+  },
+  "bin": {
+    "dsh-tool-mode": "./bin/dsh-tool-mode.mjs"
+  }
+}
+

package/node_modules/@try-works/tool-mode-extension-sdk/schema/extension-manifest-1.1.0.schema.json

@@ -0,0 +1,253 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://try-works.dev/tool-mode/extension-manifest-1.1.0.schema.json",
+  "title": "Tool Mode extension manifest",
+  "description": "The manifest an extension package ships and the host validates before importing any extension code (EXT-14). Schemas referenced from here are offline package files: a remote $ref is not fetched and an executable schema generator is never run during discovery.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocolVersion", "id", "version", "displayName", "description", "compatibility", "execution", "permissions"],
+  "properties": {
+    "protocolVersion": {
+      "description": "TMX protocol version. Minor versions are additive; a different major requires reviewed migration (EXT-16).",
+      "type": "string",
+      "pattern": "^1\\.(0|1)\\.\\d+$"
+    },
+    "id": {
+      "description": "Extension identity. MUST equal the package name exactly (EXT-14).",
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 214
+    },
+    "version": {
+      "description": "Package version. MUST equal package.json version exactly (EXT-14).",
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$"
+    },
+    "displayName": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "description": { "type": "string", "minLength": 10, "maxLength": 2000 },
+    "license": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "activation": {
+      "description": "How activation behaves. A built-in is a first-party package following the identical protocol, not an exception embedded in the host (EXT-03).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy"],
+      "properties": {
+        "policy": { "type": "string", "enum": ["operator", "bundled-default"] },
+        "deactivatable": { "type": "boolean", "default": true }
+      }
+    },
+    "runtimeApi": {
+      "description": "Module runtime API major this extension implements. 1.0 and 1.1 manifests both use major 1 (EXT-16).",
+      "type": "integer",
+      "const": 1
+    },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hostApi"],
+      "properties": {
+        "hostApi": { "type": "string", "pattern": "^[\\^~]?\\d+\\.\\d+\\.\\d+$" },
+        "requiredFeatures": {
+          "description": "Features the host must provide. An unknown required feature blocks activation rather than degrading silently (EXT-14).",
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "uniqueItems": true
+        }
+      }
+    },
+    "execution": {
+      "description": "How extension code runs. Assertion of isolation is not proof of sandboxing (EXT-20).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["module", "declarative"] },
+        "entry": { "type": "string", "pattern": "^\\./" },
+        "isolation": { "type": "string", "enum": ["managed-process", "host-inline"] }
+      }
+    },
+    "configurationSchema": { "type": "string", "pattern": "^\\./" },
+    "licenses": {
+      "description": "Per-layer licences (LIC-01). An adapter's licence says nothing about the weights it loads, so each layer is declared separately and a MISSING layer is reported as a gap rather than defaulted.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["layer", "name", "url", "openSource", "redistribution", "attributionRequired"],
+        "properties": {
+          "layer": { "enum": ["code", "engine", "weights", "conversion-artifacts", "sdk"] },
+          "name": { "type": "string", "minLength": 1, "maxLength": 200 },
+          "url": { "type": "string", "minLength": 1, "maxLength": 500 },
+          "openSource": {
+            "description": "Whether the licence is OSI-approved open source. Source-available is NOT open source (LIC-02).",
+            "type": "boolean"
+          },
+          "redistribution": {
+            "description": "Whether these bytes may be redistributed inside a package. `unclear` is treated as NOT permitted.",
+            "enum": ["permitted", "not-permitted", "unclear"]
+          },
+          "attributionRequired": { "type": "boolean" },
+          "attributionText": { "type": "string", "maxLength": 500 },
+          "obligations": { "type": "array", "items": { "type": "string", "maxLength": 500 } }
+        }
+      }
+    },
+    "network": {
+      "description": "Declared network behaviour (LIC-04). Declared rather than assumed, because an implementation that must report telemetry cannot be described as network-free.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requiredTelemetry", "otherNetworkUse"],
+      "properties": {
+        "requiredTelemetry": { "type": "boolean" },
+        "otherNetworkUse": { "type": "boolean" },
+        "telemetryContent": { "type": "array", "items": { "type": "string", "maxLength": 300 } }
+      }
+    },
+    "permissions": {
+      "description": "Requests privileges; it does not grant them (EXT-14). The host applies its own export policy on top (EXT-23).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["networkOrigins", "inputFiles", "storage", "secrets", "nativeCode"],
+      "properties": {
+        "networkOrigins": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "inputFiles": { "type": "boolean" },
+        "storage": { "type": "string", "enum": ["none", "extension-private"] },
+        "secrets": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "nativeCode": {
+          "description": "An explicit review signal, not permission to run arbitrary operator commands.",
+          "type": "boolean"
+        },
+        "harnessModel": {
+          "description": "Declared harness-model capability request (§19.3): a capability request, not an authorization grant. The actual provider's network use is governed by the host executor profile.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["inputModalities", "outputModalities"],
+          "properties": {
+            "inputModalities": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": { "type": "string", "enum": ["text", "image", "audio", "video"] }
+            },
+            "outputModalities": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": { "type": "string", "enum": ["text", "image", "audio", "video"] }
+            }
+          }
+        }
+      }
+    },
+    "models": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "assetSet", "assetLock", "platforms"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 120 },
+          "assetSet": { "type": "string", "minLength": 1, "maxLength": 120 },
+          "assetLock": { "type": "string", "pattern": "^\\./" },
+          "platforms": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["os", "arch"],
+              "properties": {
+                "os": { "type": "string", "enum": ["win32", "darwin", "linux"] },
+                "arch": { "type": "string", "enum": ["x64", "arm64"] },
+                "accelerator": { "type": "string", "enum": ["cpu", "gpu", "npu"] }
+              }
+            }
+          }
+        }
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "contractId", "contractVersion", "description", "inputSchema", "outputSchema"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 120 },
+          "name": {
+            "description": "The caller-facing tool name. A custom contribution owns it; an implementation of a standard contract must use the contract's name (EXT-21, EXT-22).",
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]*$",
+            "maxLength": 64
+          },
+          "contractId": { "type": "string", "minLength": 3, "maxLength": 214 },
+          "contractVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+          "description": { "type": "string", "minLength": 10, "maxLength": 2000 },
+          "inputSchema": { "type": "string", "pattern": "^\\./" },
+          "outputSchema": { "type": "string", "pattern": "^\\./" }
+        }
+      }
+    },
+    "implementations": {
+      "description": "Model/recipe bindings. Two closed shapes: the module form (modelId references a declared model) and the spec §19.3 harness-model form (kind + recipe path, no modelId).",
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "contractId", "contractVersion", "recipeVersion"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 120 },
+              "contractId": { "type": "string", "minLength": 3, "maxLength": 214 },
+              "contractVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+              "modelId": { "type": "string", "minLength": 1, "maxLength": 120 },
+              "recipeVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "kind", "contractId", "contractVersion", "recipeVersion", "recipe"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 120 },
+              "kind": { "type": "string", "const": "harness-model" },
+              "contractId": { "type": "string", "minLength": 3, "maxLength": 214 },
+              "contractVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+              "recipeVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+              "recipe": {
+                "description": "The package-relative recipe file the host interprets through the controlled recipe path (RCP-01, §19.3).",
+                "type": "string",
+                "pattern": "^\\./"
+              }
+            }
+          }
+        ]
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "description", "path"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 120 },
+          "name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 64 },
+          "description": { "type": "string", "minLength": 10, "maxLength": 1000 },
+          "path": { "type": "string", "pattern": "^\\./" },
+          "requiresTools": {
+            "type": "array",
+            "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+            "uniqueItems": true
+          }
+        }
+      }
+    }
+  },
+  "patternProperties": {
+    "^x-[a-z0-9-]+$": {
+      "description": "The only extension point for vendor data. Any other unknown top-level field is rejected (EXT-14)."
+    }
+  }
+}

package/node_modules/@try-works/tool-mode-recipes/bin/tool-mode-recipe.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * `tool-mode-recipe` — the recipe authoring CLI (RCP-08).
+ *
+ * A thin argv/stdio wrapper over the compiled library, so the packed artifact
+ * works under plain Node with no TypeScript loader.
+ */
+
+import { runRecipeCli } from '../lib/cli.js'
+
+const exit = await runRecipeCli(process.argv.slice(2), {
+  out: line => process.stdout.write(`${line}\n`),
+  err: line => process.stderr.write(`${line}\n`),
+})
+process.exitCode = exit