@lmzhen/dsh-evolution-agent-preset 0.3.73 → 0.3.76

package/README.md

@@ -19,8 +19,70 @@ Zero direct token effect from this package; consumers add any model-visible toke
 
 Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
 
+## Preset variants
+
+`agent.cordis.yml` here is a DELTA: the four evolution model-tool rows and nothing else.
+The installed preset is GENERATED at install time by `packages/scripts/install-layered.mjs`
+(agent / layered modes), which prepends the RUNTIME platform composition the `--base` names
+and writes the result to `$DSH_HOME/.agent-presets/<id>/agent.cordis.yml`. No platform row is
+vendored — the preset follows whichever platform the user actually has.
+
+| `--base` | Platform composition (read verbatim) | Installed preset id | Metadata file |
+|---|---|---|---|
+| `standard` (default) | `<platform>/standard/agent.cordis.yml` | `evolution` | `preset.yml` |
+| `ptc` | `<platform>/ptc/agent.cordis.yml` | `evolution-ptc` | `preset.ptc.yml` |
+
+`bases.json` in this package is the single table behind all four columns — the installer
+(`AGENT_PRESET_BASES`) and the host command (`/evolution preset install --base <name>`) both
+read THIS file, so a base cannot be half-added (a directory one consumer knows about and
+another does not) and the two install paths cannot disagree. It also carries `default`. A base whose
+runtime composition is absent — an older platform with no `ptc` preset, a preset root that does
+not carry it — is REFUSED with a named error; it is never composed from another base. The V10-14
+`tool-skill` catalog-cap injection (`injectToolSkillCap`) runs on the composed output
+for every base, and the row-collision guard still fails loud when a delta row id appears in the
+platform composition.
+
+### PTC base (`--base ptc`)
+
+Composes the platform's `ptc` preset — the standard coding agent with `run_code` as the model's
+composition surface — plus this delta, so the family's `memory`, `skill_manage` and
+`session_search` entry points reach a PTC session.
+
+Known limitations of this base:
+
+- **Tools are SDK members, not schemas.** PTC presents only `run_code` plus a generated SDK, and
+  the model may call `run_code` alone; every family tool is reached as a member inside a code
+  program. Prompt text that names a family tool as directly callable is a model-facing wording
+  question owned by the persona / tool-description packages, not by this container.
+- **A deployment without a code runtime refuses the preset at mount**, naming
+  `tool-presentation`; that row and its requirement come from the platform `ptc` preset and are
+  not something this variant can soften.
+- **Both install paths produce this variant** (0.3.75): `/evolution preset install --base ptc`
+  (npm, `evolution-commands`) and `install-layered.mjs --base ptc` (source checkout) read the same
+  `bases.json` and write `.agent-presets/evolution-ptc/`. It still only composes a platform that
+  actually ships the `ptc` preset; a `standard`-only runtime is refused by name.
+- **Tool-use observation under PTC** depends on the family reading dispatches through
+  `evolution-core`'s dispatch normalizer rather than matching a platform event vocabulary; a
+  consumer that matches `tool/call` directly goes blind in this mode (the arch guard rejects that
+  form).
+
 ## Known Limitations and Deferred Work
 
 
 - No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
 
+### Base coverage
+
+`bases.json` carries `standard` and `ptc`. There is no `cordis` base, and the
+reason is mechanical: the cordis preset's extra row is `tool-cordis`, which
+injects `dynamicCordisRunner` — a service mounted only by the `web-app` bundle.
+A cordis-based preset installed on a headless, ACP or SDK profile would mount a
+row whose injection cannot be satisfied, and a preset row that never activates is
+refused at mount time rather than degraded. Cordis sessions get the family
+through the profile-wide `all` install, which needs no variant.
+
+`minimal` is out of scope for the same class of reason: it mounts no skill or
+file tool rows for the family to write through (see `packages/INSTALL.md`).
+
+**Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).
+

package/bases.json

@@ -0,0 +1,15 @@
+{
+  "default": "standard",
+  "bases": [
+    {
+      "name": "standard",
+      "id": "evolution",
+      "metadata": "preset.yml"
+    },
+    {
+      "name": "ptc",
+      "id": "evolution-ptc",
+      "metadata": "preset.ptc.yml"
+    }
+  ]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-agent-preset",
   "description": "Agent preset exposing memory and skill evolution tools to a session (community build)",
-  "version": "0.3.73",
+  "version": "0.3.76",
   "publishConfig": {
     "access": "public"
   },
@@ -13,7 +13,9 @@
   "type": "module",
   "files": [
     "agent.cordis.yml",
+    "bases.json",
     "preset.yml",
+    "preset.ptc.yml",
     "package.json",
     "lib/*.js",
     "lib/types/**/*.d.ts"
@@ -21,31 +23,21 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/dsh-tool-session-query": "^0.1.5-rc.2",
-    "@lmzhen/dsh-tool-memory": "^0.3.73",
-    "@lmzhen/dsh-tool-skill-manage": "^0.3.73",
-    "@lmzhen/dsh-evolution-skill-catalog": "^0.3.73"
+    "@lmzhen/dsh-tool-memory": "^0.3.76",
+    "@lmzhen/dsh-tool-skill-manage": "^0.3.76",
+    "@lmzhen/dsh-evolution-skill-catalog": "^0.3.76"
   },
   "exports": {
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     ".": {
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
     "./agent.cordis.yml": "./agent.cordis.yml",
+    "./bases.json": "./bases.json",
     "./preset.yml": "./preset.yml",
+    "./preset.ptc.yml": "./preset.ptc.yml",
     "./package.json": "./package.json"
   },
-  "peerDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
-  },
-  "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
-  },
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts"
 }

package/preset.ptc.yml

@@ -0,0 +1,3 @@
+name: Evolution PTC
+description: Based on the platform ptc preset plus the Evolution family rows - durable memory and skill evolution tools, with run_code as the model's composition surface.
+order: 11

package/lib/invariant.js

@@ -1,8 +0,0 @@
-//#region lib/types/invariant.js
-const PACKAGE_NAME = "@lmzhen/dsh-evolution-agent-preset";
-const name = "evolution-agent-invariant";
-const inject = ["invariants"];
-const install = () => {};
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,5 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "evolution-agent-invariant";
-export declare const inject: string[];
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map