@qlzt/dsh-tool-subagent 0.0.0-stage → 0.2.1-alpha.2

package/lib/types/list-models.d.ts

@@ -0,0 +1,10 @@
+/** Model-facing discovery of LLM routes available to child Agents. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ModelSelectionPolicy } from './model-selection.ts';
+/**
+ * Register `list_subagent_models` for one owning delegation-tool instance.
+ * @param ctx - Context whose tool registry owns the fixed discovery definition.
+ * @param policy - Route policy captured for this Session.
+ */
+export declare function registerListSubagentModels(ctx: Context, policy: ModelSelectionPolicy): void;
+//# sourceMappingURL=list-models.d.ts.map

package/lib/types/model-selection-settings.d.ts

@@ -0,0 +1,45 @@
+/** Host-owned opt-in setting for model-selectable subagent delegation. */
+import type { Volatile } from '@deepseek-ai/cordis';
+import { Context, Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type AllowedModelRoute } from './model-selection.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** User preference sampled when a new Session receives delegation tools. */
+        subagentModelSelection: SubagentModelSelectionConfig;
+    }
+}
+/** Stored user preference; the shipped composition defaults it off. */
+export interface SubagentModelSelectionSettings {
+    /** Whether newly composed top-level Sessions receive model selection. */
+    enabled: boolean;
+    /** Exact child LLM routes offered to newly composed top-level Sessions. */
+    allowedModels: AllowedModelRoute[];
+}
+/** Optional deployment base for the preference. */
+export interface Config {
+    /** Initial enabled state inherited when the user document does not override it. */
+    enabled: Volatile<boolean>;
+    /** Initial route list inherited when the user document does not override it. */
+    allowedModels: Volatile<AllowedModelRoute[]>;
+}
+/** Singleton settings owner read when delegation tools are composed for a Session. */
+export declare class SubagentModelSelectionConfig extends Service {
+    private config;
+    static Config: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "volatile-defined">;
+        allowedModels: z<NoInfer<AllowedModelRoute[]>, NoInfer<AllowedModelRoute[]>, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: z<boolean, boolean, "volatile-defined">;
+        allowedModels: z<NoInfer<AllowedModelRoute[]>, NoInfer<AllowedModelRoute[]>, "volatile-defined">;
+    }>>, "plain">;
+    constructor(ctx: Context, config: Config);
+    /**
+     * Read a detached selection preference for the next eligible Session composition.
+     * @returns the enabled state and exact allowed routes.
+     */
+    current(): SubagentModelSelectionSettings;
+}
+export declare const name = "subagent-model-selection-settings";
+export default SubagentModelSelectionConfig;
+//# sourceMappingURL=model-selection-settings.d.ts.map

package/lib/types/model-selection-state.d.ts

@@ -0,0 +1,48 @@
+/** Durable per-session state for the user-controlled model-selection opt-in. */
+import { z as zod } from 'zod';
+import type { Session } from '@qlzt/dsh-session';
+import type SessionProjectionRegistry from '@qlzt/dsh-session-projection';
+import { type AllowedModelRoute } from './model-selection.ts';
+declare module '@qlzt/dsh-session/types' {
+    interface SessionEventMap {
+        /**
+         * Records that this session's delegation tool exposes child provider,
+         * model, and reasoning-effort selection. Appended before the first model
+         * request; absence means the fixed-route definition. Log-only: it carries
+         * no `surfaceOp` and never enters model history.
+         */
+        'subagent/model-selection-policy': {
+            /** Exact routes this Session may select explicitly for a child. */
+            allowedModels: AllowedModelRoute[];
+        };
+    }
+}
+declare module '@qlzt/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        /** Exact routes authorized for child LLM selection, or null when disabled. */
+        subagentModelSelectionPolicy: AllowedModelRoute[] | null;
+    }
+}
+/** Host-only projection of the durable model-selection policy. */
+export declare const subagentModelSelectionProjectionDefinition: {
+    key: "subagentModelSelectionPolicy";
+    stateVersion: number;
+    stateSchema: zod.ZodType<AllowedModelRoute[] | null, unknown, zod.core.$ZodTypeInternals<AllowedModelRoute[] | null, unknown>>;
+    init: () => null;
+    apply: (policy: NoInfer<AllowedModelRoute[] | null>, event: import("@qlzt/dsh-session").SessionEvent) => AllowedModelRoute[] | null;
+};
+/**
+ * Read the exact route list captured for a model-selectable definition.
+ * @param projections - registry that owns the policy projection.
+ * @param session - session whose durable decision is read.
+ * @returns a detached route list, or undefined for the fixed-route definition.
+ */
+export declare function subagentModelSelectionPolicy(projections: Pick<SessionProjectionRegistry, 'stateOf'>, session: Session): AllowedModelRoute[] | undefined;
+/**
+ * Append the route policy once, before its definition can reach a model request.
+ * @param projections - registry that owns the policy projection.
+ * @param session - session receiving the model-selectable definition.
+ * @param allowedModels - exact routes the definition may select explicitly.
+ */
+export declare function recordSubagentModelSelection(projections: Pick<SessionProjectionRegistry, 'stateOf'>, session: Session, allowedModels: readonly AllowedModelRoute[]): void;
+//# sourceMappingURL=model-selection-state.d.ts.map

package/lib/types/model-selection.d.ts

@@ -0,0 +1,81 @@
+/** Child LLM route selection for the subagent tool. */
+import type { LlmRuntime } from '@qlzt/dsh-llm';
+import type { AgentOptions } from '@qlzt/dsh-agent';
+import z from '@deepseek-ai/schemastery';
+/** One exact child LLM route authorized by a user setting. */
+export interface AllowedModelRoute {
+    /** Registered LLM provider id. */
+    readonly provider: string;
+    /** Provider-owned exact model id. */
+    readonly model: string;
+}
+/** Schema shared by the Host setting and its deployment base. */
+export declare const AllowedModelRouteSchema: z<AllowedModelRoute>;
+/** Route-selection authority captured by one delegation definition. */
+export interface ModelSelectionPolicy {
+    /** Exact provider/model routes authorized for explicit selection. */
+    readonly routes: readonly AllowedModelRoute[];
+}
+/**
+ * Stable identity for one provider/model pair.
+ * @param route - Exact provider/model route.
+ * @returns Opaque key for equality checks.
+ */
+export declare function modelRouteKey(route: AllowedModelRoute): string;
+/**
+ * Reject malformed or duplicate route policy entries at a durable or configuration boundary.
+ * @param routes - Candidate exact routes to validate.
+ * @returns an assertion that the candidate is a validated exact-route array.
+ */
+export declare function assertAllowedModelRoutes(routes: unknown): asserts routes is readonly AllowedModelRoute[];
+/** Model-facing child LLM route fields. */
+export interface DelegationModelRequest {
+    readonly provider?: string;
+    readonly model?: string;
+    readonly reasoning_effort?: string;
+}
+/**
+ * Whether a call explicitly selects any child LLM value.
+ * @param request - Model-facing route fields from the tool call.
+ * @returns Whether at least one route or effort field is present.
+ */
+export declare function hasDelegationModelRequest(request: DelegationModelRequest): boolean;
+/**
+ * Merge model-supplied selection fields over configured child defaults.
+ * Provider and model form one route and must be supplied together. Changing
+ * that route without an effort clears the configured route-owned effort.
+ * @param parentOptions - Current parent values that supply missing child values.
+ * @param configured - Tool-instance child defaults.
+ * @param request - Model-facing route override.
+ * @param enabled - Whether this tool instance permits model-facing selection.
+ * @returns Child Agent options, preserving omission when no layer contributes one.
+ */
+export declare function requestedAgentOptions(parentOptions: AgentOptions, configured: AgentOptions | undefined, request: DelegationModelRequest, enabled: boolean): AgentOptions | undefined;
+/**
+ * Enforce a settings-owned route list at the operation that creates the child.
+ * Pure inheritance remains outside this policy because no model-facing choice
+ * occurred; any explicit route or effort field must resolve to an allowed route.
+ * @param policy - Selection authority captured for this Session.
+ * @param parentOptions - Current parent values that supply missing child values.
+ * @param requested - Effective child options after request/config merging.
+ * @param request - Model-facing selection fields from the tool call.
+ */
+export declare function assertAllowedModelSelection(policy: ModelSelectionPolicy | undefined, parentOptions: AgentOptions, requested: AgentOptions | undefined, request: DelegationModelRequest): void;
+/**
+ * Whether configured Agent options require route validation before delegation.
+ * @param options - Tool-instance child defaults.
+ * @returns Whether configured provider, model, or effort values must be resolved.
+ */
+export declare function hasConfiguredLlmSelection(options: AgentOptions | undefined): boolean;
+/**
+ * Resolve an effective child route through its live adapter before the child is
+ * created. The LLM runtime owns provider lookup, exact-model metadata, effort
+ * validation, and adapter defaults.
+ * @param llm - Live LLM runtime.
+ * @param parentOptions - Current parent values whose compatible fields the child inherits.
+ * @param requested - Per-child options after request/config merging.
+ * @param signal - Tool-call cancellation signal.
+ * @param inheritParentReasoningEffort - Whether an omitted effort may inherit from the parent route.
+ */
+export declare function preflightChildLlmRoute(llm: LlmRuntime, parentOptions: AgentOptions, requested: AgentOptions | undefined, signal: AbortSignal, inheritParentReasoningEffort?: boolean): Promise<void>;
+//# sourceMappingURL=model-selection.d.ts.map

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@qlzt/dsh-tool-subagent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Model-facing subagent delegation tool over the ctx.subagents seam",
+  "version": "0.2.1-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/zsping1989/deepseek-harness.git",
+    "directory": "packages/subagent/tool-subagent"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./model-selection-settings": {
+      "types": "./lib/types/model-selection-settings.d.ts",
+      "default": "./lib/model-selection-settings.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/model-selection-settings.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@qlzt/dsh-agent": "0.2.1-alpha.2",
+    "@qlzt/dsh-llm": "0.2.1-alpha.2",
+    "@qlzt/dsh-session": "0.2.1-alpha.2",
+    "@qlzt/dsh-session-projection": "0.2.1-alpha.2",
+    "@qlzt/dsh-scope": "0.2.1-alpha.2",
+    "@qlzt/dsh-subagent": "0.2.1-alpha.2",
+    "@qlzt/dsh-system-prompt": "0.2.1-alpha.2",
+    "@qlzt/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2"
+  },
+  "dsh": {}
+}