dsh-plugin-subagent-director 0.5.0-beta.1 → 0.5.0

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 本项目的所有显著变更都会记录在此文件中。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
-## [Unreleased]
+## [0.5.0] - 2026-09-04
+
+### 变更
+
+- **设置页开头说明补充模型选择约束（beta.2）**：`sectionIntro` 增加一行
+  「只能选择插件-插件配置-Subagent池里的提供商-模型」（中英双语），设置页打开
+  即明确可选 provider/model 仅来自官方 Subagent 插件配置的模型池。
 
 ### 修复
 

package/README.md

@@ -5,11 +5,11 @@
 <p align="center">
   <img alt="npm version" src="https://img.shields.io/npm/v/dsh-plugin-subagent-director?label=npm">
   <img alt="license" src="https://img.shields.io/npm/l/dsh-plugin-subagent-director">
-  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.6-blue">
+  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.2--alpha.4-blue">
   <img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg">
 </p>
 
-[English](#english) · [特性](#特性) · [快速开始](#快速开始) · [角色模板](#角色模板) · [术语](#术语) · [开发](#开发) · [FAQ](#faq)
+[English](#english) · [特性](#特性) · [官方选择器适配](#与官方子代理选择器的适配) · [快速开始](#快速开始) · [角色模板](#角色模板) · [术语](#术语) · [开发](#开发) · [FAQ](#faq)
 
 ---
 
@@ -33,6 +33,22 @@
 - **可观测性** —— 打开子代理会话时，composer 下方显示其实际运行的供应商/模型
   （从会话 `request/header` 记录读取真实路由；读不到时优雅降级）；
 
+## 与官方子代理选择器的适配
+
+> **兼容性**：v0.5.0 支持 DSH **0.1.2-alpha.4+**（`alpha4-probe` + real-cordis 探针 278/278 通过，实测 alpha.4/alpha.5 依赖集）。旧版 DSH（0.1.0-rc.6 及更早）请使用最后兼容的 npm 版本 **0.4.0**。
+
+DSH alpha.4 起，官方内置 subagent 的模型选择收敛到 `subagent-model-selection` 设置段（`allowedModels` 授权列表）。本插件 v0.5.0 完全适配该机制：
+
+- **只从授权列表选择** —— `route-resolver` 把 provider/model 约束在官方
+  `subagent-model-selection.allowedModels` 内：显式传入未授权路由为**硬错误**；
+  插件默认层 / 角色绑定层的未授权路由被**丢弃并回退继承主代理**；
+- **不再双重写模型路由** —— 移除 rc 时代的 `applyDefaultRoute` 补丁缝，插件与
+  官方选择器不会各自覆盖同一条路由（设置面板可选的 provider/model 即官方
+  「插件-插件配置-Subagent池」里的选项）；
+- **客户端半同步移植** —— 移除 rc 时代对 `@deepseek-ai/dsh-client-runtime/client`
+  的全部引用（alpha.4/alpha.5 宿主均不携带该包），dock 读数改读 alpha.4 会话
+  `request/header` 记录，设置页在 alpha.4/alpha.5 宿主均可正常加载。
+
 ## 快速开始
 
 ### 安装
@@ -209,4 +225,6 @@ DSH 的 Web API 只向白名单内的 settings 命名空间开放读写。本插
 - **Release continuable children** — a model-facing `close_subagent(subagent_id)` tool plus a "Release subagent" button in the subagent session header, freeing resident children through the core `drainContinuableChildren` API;
 - **Observability** — the addressed subagent’s actual provider/model shown under the composer, read from the session’s `request/header` records (graceful degradation when no run is recorded yet).
 
+**Official subagent selector adaptation (v0.5.0+)** — since DSH alpha.4 the built-in subagent constrains model selection to the official `subagent-model-selection` allowlist (`allowedModels`). v0.5.0 aligns with it: routes are selected only from the allowlist (unauthorized explicit routes hard-fail; unauthorized default/role routes are dropped and fall back to inheritance), the rc-era `applyDefaultRoute` patch seam is removed (no double-writing of model routes with the official selector), and the client half no longer references the rc-era `dsh-client-runtime` package. **Compatibility**: v0.5.0 targets DSH **0.1.2-alpha.4+**; for older DSH releases use npm version **0.4.0**.
+
 **Install** — `dsh plugin --profile <name> add dsh-plugin-subagent-director` mounts the main and bridge entries automatically from the package's bundle patch (`cordis.patch.yml`); optionally override the main entry's config in your profile's cordis.patch.yml (see the Chinese section above). License: MIT.

package/lib/client/index.js

@@ -35,7 +35,7 @@ window.__ModuleLoader__.load({
 		/** English dictionary ($subagentDirector). */
 		const en = {
 			"nav": "Subagent Director",
-			"sectionIntro": "Choose the LLM provider and model each subagent uses, and define role templates that bind a model and persona to a delegation.",
+			"sectionIntro": "Choose the LLM provider and model each subagent uses, and define role templates that bind a model and persona to a delegation. Only providers/models from the Subagent pool in plugin config (Plugins → Plugin Config → Subagent) can be selected.",
 			"defaultsHeading": "Default model",
 			"defaultsHint": "Used when a call or role does not name a provider/model.",
 			"noAllowedModels": "No authorized models yet. Select models in the official Subagent model-selection list (plugin settings → Subagent); picks here are limited to that list.",
@@ -106,7 +106,7 @@ window.__ModuleLoader__.load({
 		/** Chinese dictionary. */
 		const zh = {
 			"nav": "子代理导演",
-			"sectionIntro": "为每个子代理选择 LLM 供应商与模型，并以角色模板把模型与 persona 绑定到每次委派。",
+			"sectionIntro": "为每个子代理选择 LLM 供应商与模型，并以角色模板把模型与 persona 绑定到每次委派。只能选择插件-插件配置-Subagent池里的提供商-模型。",
 			"defaultsHeading": "默认模型",
 			"defaultsHint": "当某次调用或角色未指定供应商/模型时使用。",
 			"noAllowedModels": "尚未配置已授权的模型。请先在官方 Subagent 模型选择列表（插件设置 → Subagent）中选择模型；此处只能从该列表中选择。",

package/lib/client/locales.js

@@ -7,7 +7,7 @@
 /** English dictionary ($subagentDirector). */
 export const en = {
     "nav": "Subagent Director",
-    "sectionIntro": "Choose the LLM provider and model each subagent uses, and define role templates that bind a model and persona to a delegation.",
+    "sectionIntro": "Choose the LLM provider and model each subagent uses, and define role templates that bind a model and persona to a delegation. Only providers/models from the Subagent pool in plugin config (Plugins \u2192 Plugin Config \u2192 Subagent) can be selected.",
     "defaultsHeading": "Default model",
     "defaultsHint": "Used when a call or role does not name a provider/model.",
     "noAllowedModels": "No authorized models yet. Select models in the official Subagent model-selection list (plugin settings \u2192 Subagent); picks here are limited to that list.",
@@ -78,7 +78,7 @@ export const en = {
 /** Chinese dictionary. */
 export const zh = {
     "nav": "子代理导演",
-    "sectionIntro": "为每个子代理选择 LLM 供应商与模型，并以角色模板把模型与 persona 绑定到每次委派。",
+    "sectionIntro": "为每个子代理选择 LLM 供应商与模型，并以角色模板把模型与 persona 绑定到每次委派。只能选择插件-插件配置-Subagent池里的提供商-模型。",
     "defaultsHeading": "默认模型",
     "defaultsHint": "当某次调用或角色未指定供应商/模型时使用。",
     "noAllowedModels": "尚未配置已授权的模型。请先在官方 Subagent 模型选择列表（插件设置 → Subagent）中选择模型；此处只能从该列表中选择。",

package/lib/client/locales.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-subagent-director",
-  "version": "0.5.0-beta.1",
+  "version": "0.5.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",

package/lib/close-subagent.d.ts

@@ -1,72 +0,0 @@
-/**
- * close_subagent lifecycle tool (issue #1).
- *
- * A model-facing tool that lets the calling agent close/release one resident
- * continuable subagent it started: a thin adapter over
- * ctx.subagents.drainContinuableChildren(parent, [subagent_id]), mirroring how
- * the core's interrupt_agent adapts ctx.subagents.interrupt() (see
- * @deepseek-ai/dsh-tool-subagent-control). Lifecycle authority stays with the
- * subagent service — the tool only forwards the exact calling agent as the
- * parent and performs no routing of its own.
- *
- * Semantics (documented by drainContinuableChildren): absent targets and a
- * manager-less composition are accepted no-ops; a resident child owned by a
- * different parent is rejected with a SubagentError `UNAUTHORIZED`. Unlike
- * interrupt_agent this is teardown: the released child no longer stays
- * resident and cannot be resumed with send_message afterwards, so its memory
- * and session context are freed before the parent session ends.
- *
- * The tool is registered unconditionally (like the core control tools) —
- * drainContinuableChildren is a no-op in one-shot compositions — and
- * registerCloseSubagent guards against duplicate registration so several
- * plugin instances (distinct toolName) share one close_subagent.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
-/** The canonical model-visible tool name (mirrors interrupt_agent naming). */
-export declare const CLOSE_SUBAGENT_TOOL_NAME = "close_subagent";
-/** The model-facing arguments: the durable id of the continuable child to release. */
-export interface CloseSubagentArgs {
-    /** The subagent id returned when the background subagent was started. */
-    subagent_id: string;
-}
-/**
- * Build the model-facing parameter schema. Exposed as a pure function so unit
- * tests can assert the model-visible shape without a live context. The literal
- * return type (via `satisfies`) lets defineTool infer the validated args shape.
- */
-export declare function createCloseSubagentParameters(): {
-    subagent_id: {
-        type: "string";
-        required: true;
-        description: string;
-    };
-};
-/** The model-facing output schema: a closed object confirming the release. */
-export declare function createCloseSubagentOutputSchema(): {
-    type: "object";
-    additionalProperties: false;
-    properties: {
-        closed: {
-            type: "boolean";
-            required: true;
-        };
-    };
-};
-/** Pure renderer for a close_subagent result (extracted for unit testing). */
-export declare function renderCloseResult(args: CloseSubagentArgs, _value: unknown): string;
-/**
- * Create the close_subagent ToolDefinition for one mounted context. execute
- * releases the named resident continuable direct child of the exact calling
- * agent via ctx.subagents.drainContinuableChildren; the service authorizes the
- * exact live caller, so the tool adds no authority of its own.
- */
-export declare function createCloseSubagentTool(ctx: Context): ToolDefinition;
-/**
- * Register close_subagent once per context. Returns the registry disposer, or
- * undefined when a tool with the same name is already registered (a second
- * plugin instance with a distinct delegation toolName must not double-register
- * the shared control tool).
- */
-export declare function registerCloseSubagent(ctx: Context): (() => void) | undefined;
-//# sourceMappingURL=close-subagent.d.ts.map

package/lib/close-subagent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-subagent.d.ts","sourceRoot":"","sources":["../src/close-subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAwC,KAAK,cAAc,EAAwB,MAAM,wBAAwB,CAAC;AAEzH,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAKzD,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B;;;;;;EAQ5C;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B;;;;;;;;;EAQ9C;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAqBpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAG5E"}

package/lib/close-subagent.js

@@ -1,74 +0,0 @@
-import { SessionId } from '@deepseek-ai/dsh-session';
-import { defineTool } from '@deepseek-ai/dsh-tools';
-/** The canonical model-visible tool name (mirrors interrupt_agent naming). */
-export const CLOSE_SUBAGENT_TOOL_NAME = 'close_subagent';
-/** The canonical error prefix used across structured failures (FR-8.1 convention). */
-const ERROR_PREFIX = 'subagent-director:';
-/**
- * Build the model-facing parameter schema. Exposed as a pure function so unit
- * tests can assert the model-visible shape without a live context. The literal
- * return type (via `satisfies`) lets defineTool infer the validated args shape.
- */
-export function createCloseSubagentParameters() {
-    return {
-        subagent_id: {
-            type: 'string',
-            required: true,
-            description: 'The subagent id returned when the background subagent was started (see list_agents for resident ids).',
-        },
-    };
-}
-/** The model-facing output schema: a closed object confirming the release. */
-export function createCloseSubagentOutputSchema() {
-    return {
-        type: 'object',
-        additionalProperties: false,
-        properties: {
-            closed: { type: 'boolean', required: true },
-        },
-    };
-}
-/** Pure renderer for a close_subagent result (extracted for unit testing). */
-export function renderCloseResult(args, _value) {
-    return `closed subagent ${args.subagent_id}`;
-}
-/**
- * Create the close_subagent ToolDefinition for one mounted context. execute
- * releases the named resident continuable direct child of the exact calling
- * agent via ctx.subagents.drainContinuableChildren; the service authorizes the
- * exact live caller, so the tool adds no authority of its own.
- */
-export function createCloseSubagentTool(ctx) {
-    return defineTool({
-        name: CLOSE_SUBAGENT_TOOL_NAME,
-        description: 'Close/release a resident continuable subagent by its subagent id, freeing its memory and session context. ' +
-            'The target must be a direct continuable child of the exact calling agent: absent or already-released ids are accepted no-ops, ' +
-            'and a resident child owned by another parent is rejected. ' +
-            'This is teardown, not interrupt — the released child no longer stays resident and cannot be resumed with `send_message` afterwards. ' +
-            'Use `list_agents` to see which subagents are still resident.',
-        parameters: createCloseSubagentParameters(),
-        output: {
-            schema: createCloseSubagentOutputSchema(),
-            render: (args, value) => [{ type: 'text', text: renderCloseResult(args, value) }],
-        },
-        async execute(args, exec) {
-            const parent = exec.agent;
-            if (!parent)
-                throw new Error(`${ERROR_PREFIX} close_subagent requires a calling agent (exec.agent was undefined)`);
-            await ctx.subagents.drainContinuableChildren(parent, [SessionId(args.subagent_id)]);
-            return { closed: true };
-        },
-    });
-}
-/**
- * Register close_subagent once per context. Returns the registry disposer, or
- * undefined when a tool with the same name is already registered (a second
- * plugin instance with a distinct delegation toolName must not double-register
- * the shared control tool).
- */
-export function registerCloseSubagent(ctx) {
-    if (ctx.tools.get(CLOSE_SUBAGENT_TOOL_NAME) !== undefined)
-        return undefined;
-    return ctx.tools.register(createCloseSubagentTool(ctx));
-}
-//# sourceMappingURL=close-subagent.js.map

package/lib/close-subagent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-subagent.js","sourceRoot":"","sources":["../src/close-subagent.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAuE,MAAM,wBAAwB,CAAC;AAEzH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAEzD,sFAAsF;AACtF,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAQ1C;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,uGAAuG;SACrH;KAC4B,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC5C;KACwB,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAuB,EAAE,MAAe;IACxE,OAAO,mBAAmB,IAAI,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,4GAA4G;YAC5G,gIAAgI;YAChI,4DAA4D;YAC5D,sIAAsI;YACtI,8DAA8D;QAChE,UAAU,EAAE,6BAA6B,EAAE;QAC3C,MAAM,EAAE;YACN,MAAM,EAAE,+BAA+B,EAAE;YACzC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAyB,EAAE,KAAK,CAAC,EAAE,CAAC;SACvG;QACD,KAAK,CAAC,OAAO,CAAC,IAAuB,EAAE,IAAI;YACzC,MAAM,MAAM,GAAsB,IAAI,CAAC,KAAK,CAAC;YAC7C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,qEAAqE,CAAC,CAAC;YACnH,MAAM,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACpF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/lib/default-route.d.ts

@@ -1,46 +0,0 @@
-/**
- * Default route seam (design: 默认模型兜底).
- *
- * Makes the plugin's configured `defaultProvider`/`defaultModel` apply to ANY
- * subagent start that did not carry an explicit `agentOptions` — including
- * starts initiated by the built-in `subagent` / `subagent_fork` tools, not just
- * the plugin's own `subagent_role`. This closes the gap where the model picks
- * the built-in tool and the configured defaults never take effect.
- *
- * Layering: explicit `agentOptions` (even partial) always wins; the seam is a
- * best-effort default. An un-routable default provider falls back to
- * inheritance and never throws, so a bad default cannot break built-in
- * delegation; the strict `fallbackOnInvalid` error semantics remain the
- * property of `subagent_role`'s explicit path (route-resolver.ts).
- */
-import type { AgentOptions } from '@deepseek-ai/dsh-agent';
-import type { ContinuableStart, ContinuableStartSpec, SubagentRun, SubagentStartRequest } from '@deepseek-ai/dsh-subagent';
-import type { SubagentDirectorSettings } from './route-resolver.js';
-export interface SeamResolveInput {
-    agentOptions?: AgentOptions;
-    settings: SubagentDirectorSettings;
-    isRoutable?: (provider: string) => boolean;
-}
-export declare function resolveSeamAgentOptions(input: SeamResolveInput): Pick<AgentOptions, 'provider' | 'model'> | undefined;
-/** The subset of the subagent service the seam wraps. */
-export interface SubagentsSeam {
-    start(name: string, request: SubagentStartRequest): Promise<SubagentRun>;
-    startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>;
-}
-/** Structural context the seam needs; keeps the wrapper unit-testable. */
-export interface DefaultRouteSeamContext {
-    get(name: string): unknown;
-    logger: {
-        info(message: string): void;
-        warn(message: string): void;
-    };
-    subagents: SubagentsSeam;
-}
-/**
- * Wrap `ctx.subagents.start` / `startContinuable` so a subagent start without
- * explicit `agentOptions` receives the configured defaults. Returns a disposer
- * that restores the original methods (registered via `ctx.effect` by the
- * caller, so it runs when the plugin fiber unloads).
- */
-export declare function applyDefaultRouteSeam(ctx: DefaultRouteSeamContext, getSettings: () => SubagentDirectorSettings): () => void;
-//# sourceMappingURL=default-route.d.ts.map

package/lib/default-route.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"default-route.d.ts","sourceRoot":"","sources":["../src/default-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,wBAAwB,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,SAAS,CAUrH;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzE,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzE;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,MAAM,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,SAAS,EAAE,aAAa,CAAC;CAC1B;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,uBAAuB,EAC5B,WAAW,EAAE,MAAM,wBAAwB,GAC1C,MAAM,IAAI,CAmCZ"}

package/lib/default-route.js

@@ -1,56 +0,0 @@
-function isEmpty(value) {
-    return value === undefined || value === '';
-}
-export function resolveSeamAgentOptions(input) {
-    const { agentOptions, settings, isRoutable } = input;
-    if (agentOptions !== undefined && (agentOptions.provider !== undefined || agentOptions.model !== undefined)) {
-        return undefined;
-    }
-    const provider = settings.defaultProvider;
-    const model = settings.defaultModel;
-    if (isEmpty(provider) || isEmpty(model))
-        return undefined;
-    if (isRoutable !== undefined && !isRoutable(provider))
-        return undefined;
-    return { provider, model };
-}
-function makeIsRoutable(ctx) {
-    const llm = ctx.get('llm');
-    if (llm === undefined)
-        return undefined;
-    return (provider) => llm.listProviders().some((entry) => entry.id === provider);
-}
-/**
- * Wrap `ctx.subagents.start` / `startContinuable` so a subagent start without
- * explicit `agentOptions` receives the configured defaults. Returns a disposer
- * that restores the original methods (registered via `ctx.effect` by the
- * caller, so it runs when the plugin fiber unloads).
- */
-export function applyDefaultRouteSeam(ctx, getSettings) {
-    const subagents = ctx.subagents;
-    const originalStart = subagents.start;
-    const originalStartContinuable = subagents.startContinuable;
-    const isRoutable = makeIsRoutable(ctx);
-    const resolve = (request) => resolveSeamAgentOptions({ agentOptions: request.agentOptions, settings: getSettings(), isRoutable });
-    subagents.start = (name, request) => {
-        const agentOptions = resolve(request);
-        if (agentOptions !== undefined) {
-            ctx.logger.info(`[subagent-director] default route seam: applying ${agentOptions.provider}/${agentOptions.model} to ${name} subagent`);
-            return originalStart.call(subagents, name, { ...request, agentOptions });
-        }
-        return originalStart.call(subagents, name, request);
-    };
-    subagents.startContinuable = (spec) => {
-        const agentOptions = resolve(spec.request);
-        if (agentOptions !== undefined) {
-            ctx.logger.info(`[subagent-director] default route seam: applying ${agentOptions.provider}/${agentOptions.model} to continuable subagent`);
-            return originalStartContinuable.call(subagents, { ...spec, request: { ...spec.request, agentOptions } });
-        }
-        return originalStartContinuable.call(subagents, spec);
-    };
-    return () => {
-        subagents.start = originalStart;
-        subagents.startContinuable = originalStartContinuable;
-    };
-}
-//# sourceMappingURL=default-route.js.map

package/lib/default-route.js.map

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