dsh-plugin-subagent-director 0.1.0

package/lib/settings.js

@@ -0,0 +1,118 @@
+/**
+ * Settings namespace, schema, and write-time validation for Subagent Director
+ * (design section 5.2).
+ *
+ * This module owns the "subagent-director" settings namespace. It re-exports
+ * the role/settings types from ./route-resolver (single source of truth) and
+ * registers them with the canonical optional-settings consumer wiring so a
+ * deployment without a settings provider keeps working off its composition
+ * config (zero intrusion).
+ *
+ * Layering (design 5.2): the schemastery schema stays coercive/permissive
+ * (all fields optional, roles a string-keyed dict) so an absent section
+ * resolves cleanly; cross-field / semantic constraints that the schema cannot
+ * express are enforced at WRITE time by validate(), which throws to refuse the
+ * write exactly as SettingsRegisterOptions.validate / SettingsSectionHooks.validate
+ * demand (dsh-settings/lib/types/index.d.ts:24-48, 307-341).
+ */
+import { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { installSettingsSection, settingsNamespace, } from '@deepseek-ai/dsh-settings';
+/** Settings namespace for Subagent Director (design section 0 naming resolution). */
+export const SUBAGENT_DIRECTOR_SETTINGS_NAMESPACE = settingsNamespace('subagent-director');
+/** Kebab-case: lowercase alphanumeric segments separated by single hyphens. */
+const KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Schemastery schema for one role template. All fields optional so a partial /
+ * absent role resolves; semantic requirements are enforced by validate(). */
+export const RoleTemplateSchema = z.object({
+    displayName: z.string(),
+    description: z.string(),
+    persona: z.string(),
+    provider: z.string(),
+    model: z.string(),
+    reasoningEffort: z.string(),
+    toolFilter: z.object({
+        allow: z.array(z.string()),
+        deny: z.array(z.string()),
+    }),
+});
+/**
+ * Schemastery schema for the Subagent Director settings section. Every field is
+ * optional (schemastery object fields are optional by default); roles is a
+ * string-keyed dict of RoleTemplateSchema.
+ */
+export const SettingsSchema = z.object({
+    defaultProvider: z.string(),
+    defaultModel: z.string(),
+    defaultReasoningEffort: z.string(),
+    defaultRole: z.string(),
+    fallbackOnInvalid: z.boolean().default(true),
+    roles: z.dict(RoleTemplateSchema),
+});
+function isEmpty(value) {
+    return value === undefined || value === null || value.trim().length === 0;
+}
+/** True when the value is a string made only of whitespace. */
+function isBlankString(value) {
+    return typeof value === 'string' && value.trim().length === 0;
+}
+/**
+ * Write-time validator for a resolved settings section (design 5.2).
+ *
+ * Throws to refuse the write that produced value, as the settings seam
+ * contract requires. Checks:
+ *  - every role key is kebab-case;
+ *  - every role's displayName and description are present and non-empty;
+ *  - defaultRole, when set, references an existing role key;
+ *  - every explicitly-set provider is a non-empty string.
+ *
+ * @param value - the resolved section, schema-valid by construction.
+ */
+export function validateDirectorSettings(value) {
+    const roles = value.roles ?? {};
+    for (const [id, role] of Object.entries(roles)) {
+        if (!KEBAB_CASE.test(id)) {
+            throw new Error('subagent-director: role id "' + id + '" is not kebab-case (lowercase letters, digits and single hyphens)');
+        }
+        if (isEmpty(role?.displayName)) {
+            throw new Error('subagent-director: role "' + id + '" must have a non-empty displayName');
+        }
+        if (isEmpty(role?.description)) {
+            throw new Error('subagent-director: role "' + id + '" must have a non-empty description');
+        }
+        if (isBlankString(role?.provider)) {
+            throw new Error('subagent-director: role "' + id + '" provider must be a non-empty string when set');
+        }
+    }
+    if (!isEmpty(value.defaultRole) && roles[value.defaultRole] === undefined) {
+        throw new Error('subagent-director: defaultRole "' + value.defaultRole + '" does not reference a defined role');
+    }
+    if (isBlankString(value.defaultProvider)) {
+        throw new Error('subagent-director: defaultProvider must be a non-empty string when set');
+    }
+}
+/**
+ * Install the Subagent Director settings section through the canonical
+ * optional-settings consumer wiring.
+ *
+ * Mirrors dsh-agent-default-model/lib/index.js's optional pattern: the
+ * registration rides the scoped fiber, so a deployment with no settings
+ * service simply never mounts it. This helper guards that explicitly for
+ * readability and logs a debug line when the service is absent so the gradual
+ * fall-back to the composition config is observable.
+ *
+ * @param ctx - consumer plugin context owning the wiring.
+ * @param entry - the consumer's composition-layer config, used as the settings
+ *   base while a provider is absent.
+ * @param hooks - source sink and change notification (plus optional validate).
+ */
+export function installDirectorSettings(ctx, entry, hooks) {
+    if (ctx.get('settings') === undefined) {
+        ctx.logger.debug('[subagent-director] no settings service mounted; using composition config and skipping settings section registration');
+        return;
+    }
+    installSettingsSection(ctx, SUBAGENT_DIRECTOR_SETTINGS_NAMESPACE, SettingsSchema, entry, hooks);
+}
+/** Convenience exported alias used by tests. */
+export { SettingsSchema as SubagentDirectorSettingsSchema };
+//# sourceMappingURL=settings.js.map

package/lib/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "dsh-plugin-subagent-director",
+  "version": "0.1.0",
+  "description": "Subagent Director: choose an LLM provider/model for each subagent (call args > role binding > plugin default > inherit parent) and plan main-agent/subagent responsibilities with role templates, plus a settings UI.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeverusZh/dsh-plugin-subagent-director.git"
+  },
+  "homepage": "https://github.com/SeverusZh/dsh-plugin-subagent-director",
+  "bugs": {
+    "url": "https://github.com/SeverusZh/dsh-plugin-subagent-director/issues"
+  },
+  "files": [
+    "lib",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
+    "build:client": "node scripts/build-client.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client/index.js"
+    },
+    "./package.json": "./package.json",
+    "./bridge": {
+      "types": "./lib/bridge-entry.d.ts",
+      "default": "./lib/bridge-entry.js"
+    }
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "slots",
+        "locale",
+        "connection",
+        "remote"
+      ],
+      "platform": "web"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "subagent",
+    "subagent-director",
+    "llm",
+    "provider",
+    "model",
+    "role-template"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-web-react": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-schema-form": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.1.0-rc.6"
+  },
+  "devDependencies": {
+    "react": "file:../../../DeepSeekHarness/node_modules/react",
+    "react-dom": "file:../../../DeepSeekHarness/node_modules/react-dom",
+    "use-sync-external-store": "file:../../../DeepSeekHarness/node_modules/use-sync-external-store",
+    "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.1",
+    "@deepseek-ai/cordis": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/cordis",
+    "@deepseek-ai/dsh-agent": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-agent",
+    "@deepseek-ai/dsh-llm": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-llm",
+    "@deepseek-ai/dsh-settings": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-settings",
+    "@deepseek-ai/dsh-subagent": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-subagent",
+    "@deepseek-ai/dsh-system-prompt": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-system-prompt",
+    "@deepseek-ai/dsh-tools": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-tools",
+    "@deepseek-ai/schemastery": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/schemastery",
+    "@deepseek-ai/dsh-client-runtime": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-runtime",
+    "@deepseek-ai/dsh-client-connection": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-connection",
+    "@deepseek-ai/dsh-client-ui-slots": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-ui-slots",
+    "@deepseek-ai/dsh-client-web-react": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-web-react",
+    "@deepseek-ai/dsh-client-ui-settings": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-ui-settings",
+    "@deepseek-ai/dsh-client-schema-form": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-schema-form",
+    "@deepseek-ai/dsh-client-locale": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-locale",
+    "@deepseek-ai/dsh-client-ui-primitives": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-client-ui-primitives",
+    "@deepseek-ai/dsh-host-apiproxy": "file:../../../DeepSeekHarness/node_modules/@deepseek-ai/dsh-host-apiproxy",
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}