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

package/node_modules/@try-works/tool-mode-recipes/schema/harness-model-recipe.schema.json

@@ -0,0 +1,273 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://try-works.dev/tool-mode/harness-model-recipe.schema.json",
+  "$comment": "Published vocabulary for RCP-02: the harness-model recipe document the declarative broker loads. AUTHORITY: the code validator in packages/tool-mode-recipes/src/recipe-format.ts is the normative implementation; this schema mirrors it and the parity test (tests/schema-parity.test.ts) fails if they drift. TWO VOCABULARIES NORMALIZE TO ONE FROZEN RECIPE: the CANONICAL RCP-02 shape (schemaVersion/kind/modelSelection/instructions/inputBindings/response/limits/context) and the LEGACY shape (id/version/description/tool/inputs/promptTemplate/maxOutputTokens/imageInputs/policy), a documented deprecated alias (normalizeRecipeDocument in recipe-format.ts maps canonical->legacy before the field checks). Code-only checks a JSON Schema cannot express: (1) forbidden keys refused BY NAME with a 'data, not a program' reason — the schema refuses them structurally (closed objects) but cannot reproduce the named refusal; (2) reserved prototype keys — same; (3) non-finite numbers, functions, class instances and non-plain objects — not JSON data, so a schema over parsed JSON cannot see them; (4) description TRIMMED to at least 10 characters — the schema's minLength 10 is the sound approximation, trim semantics are code-only; (5) default must be one of the declared enum values — 2020-12 cannot reference a sibling enum; (6) promptTemplate/instructions placeholder-to-input correspondence and unbalanced-brace refusal — cross-field, code-only; (7) imageInputs.max/limits.maxImages vs declared image-input count — cross-field, code-only; (8) the load-time identity-claim refusal (expectedToolName/expectedContractId) — an option of parseRecipe, not a document property; (9) modelSelection.requires consistency with the declared bindings (image binding needs 'image' in inputModalities) — cross-field, code-only; (10) deep-freeze at parse — runtime behavior, not schema. BINDING-TIME checks (validateRecipeInputs) apply to caller arguments, not to the recipe document, and are out of scope for this schema.",
+  "title": "harness-model-recipe",
+  "oneOf": [
+    {
+      "title": "Canonical RCP-02 recipe",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "description", "tool", "instructions", "inputBindings", "modelSelection", "limits"],
+      "properties": {
+        "schemaVersion": {
+          "description": "The vocabulary version, accepted and pinned ('1.0.0').",
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "description": "The recipe kind; only 'harness-model' exists in this vocabulary.",
+          "type": "string",
+          "const": "harness-model"
+        },
+        "id": {
+          "description": "Recipe identity. Pattern from recipe-format.ts — letters, digits, dot, dash, underscore, slash or a leading scope, no whitespace.",
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[A-Za-z0-9@][A-Za-z0-9._@/-]*$"
+        },
+        "version": {
+          "description": "Semantic version (RCP-06: a prompt change is a version change).",
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "description": {
+          "description": "A real sentence describing what the recipe does.",
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 2000
+        },
+        "tool": {
+          "description": "The tool identity the recipe implements (RCP-06).",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "contractId"],
+          "properties": {
+            "name": { "type": "string", "minLength": 1, "maxLength": 64 },
+            "contractId": { "type": "string", "minLength": 3, "maxLength": 214 }
+          }
+        },
+        "modelSelection": {
+          "description": "Static versus per-call authority (RCP-05). 'caller-model' is the default strategy; 'approved-profile' references a logical profile name the operator explicitly binds.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["strategy", "requires"],
+          "properties": {
+            "strategy": { "type": "string", "enum": ["caller-model", "approved-profile"] },
+            "profile": {
+              "description": "Required with 'approved-profile'; the host binding resolves it.",
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+            },
+            "requires": {
+              "description": "The capability request this recipe needs (HLM-04). Unknown is not supported.",
+              "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"] }
+                }
+              }
+            }
+          }
+        },
+        "instructions": {
+          "description": "The static instruction text with {{name}} binding placeholders. Static data only: no template expressions, eval, shell, dynamic imports or remote prompt downloads (RCP-02).",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536
+        },
+        "inputBindings": {
+          "description": "Validated JSON Pointers into the detached, schema-validated argument object (RCP-03). Simple name segments only; reserved characters, prototype keys and escapes are refused. The optional constraint fields are re-emitted by the canonical serializer so the canonical round trip is LOSSLESS.",
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "pointer", "required"],
+            "properties": {
+              "kind": { "type": "string", "enum": ["text", "image", "json"] },
+              "pointer": { "type": "string", "pattern": "^(/[A-Za-z0-9_-]+)+$" },
+              "required": { "type": "boolean" },
+              "label": { "type": "string", "minLength": 1, "maxLength": 500 },
+              "minLength": { "type": "integer", "minimum": 0 },
+              "maxLength": { "type": "integer", "minimum": 1 },
+              "minimum": { "type": "number" },
+              "maximum": { "type": "number" },
+              "enum": { "type": "array", "minItems": 1 },
+              "default": { "anyOf": [{ "type": "string" }, { "type": "number" }, { "type": "boolean" }] },
+              "mediaTypes": {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": "string", "pattern": "^image/" }
+              },
+              "maxBytes": { "type": "integer", "minimum": 1 }
+            }
+          }
+        },
+        "response": {
+          "description": "RCP-04: 'text' maps into one named payload string field; 'json' is prompt-enforced and locally validated in this build (no provider structured-output negotiation) — the describe metadata discloses the difference.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode", "field"],
+          "properties": {
+            "mode": { "type": "string", "enum": ["text", "json"] },
+            "field": { "type": "string", "minLength": 1, "maxLength": 120 }
+          }
+        },
+        "limits": {
+          "description": "The recipe's own bounds (HLM-07). maxOutputTokens and maxImages are enforced; timeoutMs/maxInputTextBytes/maxAttempts/repairAttempts are validated and recorded as the author's request (the caller owns the deadline).",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["maxOutputTokens"],
+          "properties": {
+            "timeoutMs": { "type": "integer", "minimum": 1 },
+            "maxInputTextBytes": { "type": "integer", "minimum": 1 },
+            "maxImages": { "type": "integer", "minimum": 0 },
+            "maxOutputTokens": { "type": "integer", "minimum": 1 },
+            "maxAttempts": { "type": "integer", "minimum": 1 },
+            "repairAttempts": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "context": {
+          "description": "HLM-05's frozen invariants: only {inheritConversation:false, includeTools:false} is supported in this release; anything else is refused, not ignored.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["inheritConversation", "includeTools"],
+          "properties": {
+            "inheritConversation": { "type": "boolean", "const": false },
+            "includeTools": { "type": "boolean", "const": false }
+          }
+        }
+      }
+    },
+    {
+      "title": "Legacy recipe (deprecated alias)",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "description", "tool", "inputs", "promptTemplate", "maxOutputTokens", "imageInputs", "policy"],
+      "properties": {
+        "id": {
+          "description": "Recipe identity. Pattern from recipe-format.ts:619 — letters, digits, dot, dash, underscore, slash or a leading scope, no whitespace.",
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[A-Za-z0-9@][A-Za-z0-9._@/-]*$"
+        },
+        "version": {
+          "description": "Semantic version (RCP-06: a prompt change is a version change).",
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "description": {
+          "description": "A real sentence describing what the recipe does.",
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 2000
+        },
+        "tool": {
+          "description": "The tool identity the recipe implements (RCP-06).",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "contractId"],
+          "properties": {
+            "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$", "maxLength": 64 },
+            "contractId": { "type": "string", "minLength": 3, "maxLength": 214, "pattern": "^[a-z][a-z0-9@._/-]*$" }
+          }
+        },
+        "inputs": {
+          "description": "The declared inputs, keyed by input name, in declaration order. Names that reach into the object model or the parent context are refused by name, like the code validator refuses them.",
+          "type": "object",
+          "minProperties": 1,
+          "propertyNames": {
+            "not": {
+              "enum": ["tools", "tool_calls", "toolCalls", "messages", "history", "conversation", "attachments", "memory", "skills", "systemPrompt", "inheritConversation", "includeTools", "__proto__", "constructor", "prototype"]
+            }
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["type", "required"],
+            "properties": {
+              "type": { "type": "string", "enum": ["string", "integer", "number", "boolean", "image"] },
+              "required": { "type": "boolean" },
+              "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
+              "minLength": { "type": "integer", "minimum": 0 },
+              "maxLength": { "type": "integer", "minimum": 1 },
+              "minimum": { "type": "number" },
+              "maximum": { "type": "number" },
+              "enum": { "type": "array", "minItems": 1 },
+              "default": { "anyOf": [{ "type": "string" }, { "type": "number" }, { "type": "boolean" }] },
+              "mediaTypes": {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": "string", "pattern": "^image/" }
+              },
+              "maxBytes": { "type": "integer", "minimum": 1 },
+              "jsonSerialized": { "type": "boolean", "const": true }
+            },
+            "allOf": [
+              {
+                "if": { "properties": { "type": { "const": "image" } }, "required": ["type"] },
+                "then": { "properties": { "default": false, "minLength": false, "maxLength": false, "minimum": false, "maximum": false, "enum": false, "jsonSerialized": false } }
+              },
+              {
+                "if": { "properties": { "type": { "const": "string" } }, "required": ["type"] },
+                "then": { "properties": { "minimum": false, "maximum": false, "mediaTypes": false, "maxBytes": false } }
+              },
+              {
+                "if": { "properties": { "type": { "enum": ["integer", "number"] } }, "required": ["type"] },
+                "then": { "properties": { "minLength": false, "maxLength": false, "mediaTypes": false, "maxBytes": false, "jsonSerialized": false } }
+              },
+              {
+                "if": { "properties": { "type": { "const": "boolean" } }, "required": ["type"] },
+                "then": { "properties": { "minLength": false, "maxLength": false, "minimum": false, "maximum": false, "mediaTypes": false, "maxBytes": false, "jsonSerialized": false } }
+              }
+            ]
+          }
+        },
+        "promptTemplate": {
+          "description": "The static instruction text, with {{name}} binding placeholders. Template-expression syntax is refused, like the code validator refuses it.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536,
+          "not": { "anyOf": [{ "pattern": "\\$\\{" }, { "pattern": "<%" }, { "pattern": "%>" }] }
+        },
+        "maxOutputTokens": {
+          "description": "The recipe's own output-token ceiling (RES-10 initial maximum).",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1024
+        },
+        "imageInputs": {
+          "description": "The image inputs this recipe permits (RES-10 initial maximum).",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["max"],
+          "properties": {
+            "max": { "type": "integer", "minimum": 0, "maximum": 2 }
+          }
+        },
+        "policy": {
+          "description": "Recording and destination declarations (HLM-09).",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["record", "allowRemote"],
+          "properties": {
+            "record": { "type": "boolean" },
+            "allowRemote": { "type": "boolean" }
+          }
+        }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,129 @@
 {
   "name": "@try-works/dsh-tool-mode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.45",
+  "description": "Install Desert Ant Labs on-device models as DSH tools and skills, with per-platform capability gating",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "on-device",
+    "desert-ant-labs",
+    "models-as-tools"
+  ],
+  "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": "dsh-tool-mode/packages/dsh-tool-mode"
+  },
+  "homepage": "https://github.com/try-works/tool-mode#readme",
+  "bugs": {
+    "url": "https://github.com/try-works/tool-mode/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./client/index.js",
+    "./typert": "./remote/typert.host.mjs",
+    "./remote": "./remote/typert.remote-client.mjs",
+    "./catalog": {
+      "types": "./lib/catalog.d.ts",
+      "default": "./lib/catalog.js"
+    },
+    "./catalog/desert-ant-models.json": "./catalog/desert-ant-models.json",
+    "./catalog/playbooks.json": "./catalog/playbooks.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "client/index.js",
+    "client/client.model-tools.js",
+    "remote/*.mjs",
+    "catalog/desert-ant-models.json",
+    "catalog/playbooks.json",
+    "cordis.patch.yml",
+    "builtins.lock.json",
+    "README.md",
+    "bin"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ],
+      "external": []
+    }
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=0.2.0-rc.2 || >=0.2.1-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.2.0-rc.2 || >=0.2.1-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 || >=0.2.1-rc.1"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node scripts/clean-lib.mjs && tsc -p tsconfig.build.json && node scripts/gen-client-catalog.mjs",
+    "build:client": "node scripts/gen-client-catalog.mjs",
+    "build:remote": "node scripts/gen-remote-artifacts.mjs",
+    "check:remote": "node scripts/gen-remote-artifacts.mjs --check",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "tsx --test tests/*.test.ts",
+    "prepack": "node scripts/stage-bundle.mjs && npm run build",
+    "prepare": "tsc -p tsconfig.build.json",
+    "postpack": "node scripts/stage-bundle.mjs --clean"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "2.3.1",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@modelcontextprotocol/node": "2.1.1",
+    "@modelcontextprotocol/server": "2.3.1",
+    "@try-works/tool-mode-contracts": "^0.1.0",
+    "@try-works/tool-mode-extension-sdk": "^0.1.0",
+    "ajv": "^8.20.0",
+    "adm-zip": "^0.5.18",
+    "@try-works/tool-mode-recipes": "^0.1.0"
+  },
+  "bin": {
+    "dsh-tool-mode": "bin/dsh-tool-mode.mjs",
+    "dsh-tool-mode-mcp-stdio": "bin/dsh-tool-mode-mcp-stdio.mjs",
+    "dsh-tool-mode-credentials": "bin/dsh-tool-mode-credentials.mjs"
+  },
+  "bundledDependencies": [
+    "@try-works/tool-mode-contracts",
+    "@try-works/tool-mode-extension-sdk",
+    "@try-works/tool-mode-recipes"
+  ],
+  "bundleDependencies": [
+    "@try-works/tool-mode-contracts",
+    "@try-works/tool-mode-extension-sdk",
+    "@try-works/tool-mode-recipes"
+  ]
+}