@kelloggt/dsh-program-agents 0.1.0 → 0.1.1

package/dist/host/skills.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare function registerBundledSkill(ctx: Context): void;

package/dist/host/skills.js

@@ -0,0 +1,45 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { BUNDLED_SKILL_RANK } from '@deepseek-ai/dsh-skill';
+import { parse as parseYaml } from 'yaml';
+import { object } from './validation.js';
+const name = 'program-agents';
+// Both src/host and dist/host sit two levels below the package root. The
+// bundled host entries keep this same layout, including after npm installation.
+const directory = new URL('../../skills/program-agents/', import.meta.url);
+const path = fileURLToPath(new URL('SKILL.md', directory));
+const resourceBase = { kind: 'directory', path: fileURLToPath(directory) };
+async function definition() {
+    const raw = await readFile(path, 'utf8');
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/.exec(raw);
+    if (!match)
+        throw new Error(`Missing skill frontmatter: ${path}`);
+    const metadata = object(parseYaml(match[1]));
+    if (metadata.name !== name || typeof metadata.description !== 'string' || !metadata.description.trim()) {
+        throw new Error(`Invalid bundled skill name or description: ${path}`);
+    }
+    for (const key of ['disable-model-invocation', 'user-invocable']) {
+        if (metadata[key] !== undefined && typeof metadata[key] !== 'boolean')
+            throw new Error(`Invalid ${key} in ${path}`);
+    }
+    return {
+        name, description: metadata.description, path, resourceBase, metadata,
+        provider: name, source: 'bundled', content: match[2],
+        invocation: {
+            modelInvocable: metadata['disable-model-invocation'] !== true,
+            userInvocable: metadata['user-invocable'] !== false,
+        },
+    };
+}
+const provider = {
+    name,
+    async list() {
+        const { content: _content, ...skill } = await definition();
+        return [{ ...skill, rank: BUNDLED_SKILL_RANK, locator: path }];
+    },
+    get: () => definition(),
+};
+export function registerBundledSkill(ctx) {
+    ctx.skills.registerProvider(() => provider);
+}
+//# sourceMappingURL=skills.js.map

package/dist/host/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/host/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAA4C,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAC9B,yEAAyE;AACzE,gFAAgF;AAChF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3E,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAC3D,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAAW,CAAC;AAEpF,KAAK,UAAU,UAAU;IACvB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,kDAAkD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACjE,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,OAAO,IAAI,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ;QACrE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE;QACrD,UAAU,EAAE;YACV,cAAc,EAAE,QAAQ,CAAC,0BAA0B,CAAC,KAAK,IAAI;YAC7D,aAAa,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,KAAK;SACpD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAkB;IAC9B,IAAI;IACJ,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;QAC3D,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;CACxB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/docs/installation.md

@@ -4,7 +4,9 @@ Current UI/runtime: see `composer-strip.md` for program_register, command/watch
 
 ## Status
 
-Local experimental source package, not published. Targets DSH0.2.1-rc.2, Cordis4.0.5. Node22.18+ with erasable TS or precompiled JS. Build with pnpm (lockfile committed). No automatic mutation of a user's profiles, credentials, model settings or running server.
+Published npm package `@kelloggt/dsh-program-agents`. Install with `dsh plugin --profile web add @kelloggt/dsh-program-agents`; the bundle enables the host and browser contribution. Version 0.1.1 adds automatic skill discovery through DSH's native provider registry. Targets DSH0.2.1-rc.2, Cordis4.0.5. Node22.18+ with erasable TS or precompiled JS. Build source checkouts with pnpm (lockfile committed).
+
+The bundled skill is loaded from the installed package, including its frontmatter and resource directory. Registration follows the optional `skills` service lifecycle, so the program tools still load in profiles without skill support. Unloading the plugin removes its provider. Project and user skill overrides retain DSH's normal precedence; an old copied skill must be removed if you want to follow the packaged version. Registration writes no files into a user's skill directories.
 
 ## Host and web contribution
 

package/docs/publishing.md

@@ -26,7 +26,7 @@ It should contain `dist/host/index.js`, `dist/client.js`, the SDK and runtime ex
 
 The publishing dry run skips Git checks so it can preview uncommitted work. The actual publishing command keeps pnpm's normal Git checks enabled.
 
-Test the archive in a disposable DSH profile before publishing. Installing it with `dsh plugin --profile web add /absolute/path/to/the/archive.tgz` enables the plugin through its bundle patch. Install the skill as described in the README.
+Test the archive in a disposable DSH profile before publishing. Installing it with `dsh plugin --profile web add /absolute/path/to/the/archive.tgz` enables the plugin through its bundle patch and registers the bundled skill automatically. Check that `program-agents` is available without copying it into a user skill directory.
 
 ## Publish the verified archive
 
@@ -38,7 +38,7 @@ pnpm whoami --registry=https://registry.npmjs.org/
 pnpm release:publish
 ```
 
-The username check should print `kelloggt` for this personal scope. Follow any authentication prompts from npm. Publishing uses the existing archive without rebuilding it. After the first release succeeds, remove the pending-release wording from the README and make npm installation the default. For future releases, update the package version and run `pnpm release:pack` again; the scripts select the matching archive automatically.
+The username check should print `kelloggt` for this personal scope. Follow any authentication prompts from npm. Publishing uses the existing archive without rebuilding it. For future releases, update the package version and run `pnpm release:pack` again; the scripts select the matching archive automatically.
 
 If publishing fails with **E403: Two-factor authentication or granular access token with bypass 2fa enabled is required**, check your account's 2FA settings. After enabling 2FA, run `pnpm release:login` again and retry `pnpm release:publish` in an interactive terminal. The authentication error does not require rebuilding the archive. If your configured method uses an authenticator code, you can pass it directly with `pnpm release:publish --otp=YOUR_CURRENT_CODE`; the release script forwards that option to pnpm.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kelloggt/dsh-program-agents",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Supervised TypeScript/JavaScript programs for DeepSeek Harness",
   "type": "module",
   "license": "MIT",
@@ -75,6 +75,7 @@
     "@deepseek-ai/schemastery": "3.18.5",
     "@modelcontextprotocol/core": "2.2.0",
     "ajv": "^8.20.0",
+    "yaml": "2.9.1",
     "zod": "^4.6.7"
   },
   "peerDependencies": {
@@ -83,6 +84,7 @@
     "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
     "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
     "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
     "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2"
   },
@@ -92,6 +94,7 @@
     "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
     "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
     "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
     "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
     "@types/node": "^22.18.0",