dsh-pstack 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/subagent.d.mts

@@ -1,18 +1,12 @@
-import { f as SubagentCapabilities, g as ToolDefinition, h as SubagentsHost, n as AgentOptions, o as JsonSchemaNode, r as AgentsHost, s as LlmHost, t as Agent, v as ToolsHost } from "./host-contract-o47JH_r8.mjs";
-//#region scripts/role-manifest.d.ts
+import { _ as ToolsHost, g as ToolDefinition, h as SubagentsHost, m as SubagentCapabilities, n as AgentOptions, r as AgentsHost, s as LlmHost, t as Agent, v as WorkingDirectoryHost } from "./host-contract-CUPSpeNk.mjs";
 /**
  * The one pstack role manifest.
  *
- * Every consumer of the role vocabulary reads this module: `src/roles.ts` for
- * exact lookup and panel classification, `src/models.ts` for value shapes,
- * `scripts/build-assets.ts` for the generated example file, and the
- * `setup-pstack` skill text, which points at that example instead of listing the
- * roles again. A second literal role list anywhere is a bug.
+ * Keys are matched exactly after normalization, and commas belong to some keys
+ * (`feature, refactoring`, `reflect judgment, divergent, synthesizer`), so nothing here
+ * may split a key on a comma. A second literal role list anywhere is a bug.
  *
- * Keys are matched exactly after normalization. Commas are part of some keys
- * (`feature, refactoring`), so nothing here may be split on a comma.
- *
- * This module has no Node imports: the Host bundle imports it directly.
+ * This module has no Node imports: the bundle imports it directly.
  */
 /** Whether a role holds one route or a comma-separated list of routes. */
 type RoleValueShape = "single" | "list";
@@ -20,19 +14,11 @@ interface RoleSpec {
   /** Exact key as written in the role file. Commas belong to the key. */
   readonly key: string;
   readonly shape: RoleValueShape;
-  /**
-   * A list role that automatically starts one child per entry. Only the three
-   * panel roles set this; every other list role selects one entry.
-   */
+  /** A list role that starts one child per entry automatically. */
   readonly autoPanel: boolean;
-  /** Skills and playbooks that read this role. */
-  readonly consumers: readonly string[];
-  readonly summary: string;
 }
-//#endregion
-//#region src/models.d.ts
 /** One resolved child route. */
-type ChildRoute = {
+type Route = {
   readonly kind: "inherit";
 } | {
   readonly kind: "route";
@@ -45,93 +31,43 @@ type RouteSelectionMode = "single" | "panel" | "selected";
 interface RouteSelection {
   readonly role: RoleSpec;
   readonly mode: RouteSelectionMode;
-  /** Whether the role came from the file or from the inherit-parent fallback. */
+  /** Whether the role came from the file or the inherit-parent fallback. */
   readonly configured: boolean;
-  readonly routes: readonly ChildRoute[];
+  readonly routes: readonly Route[];
   /** How many entries the role holds, before selection. */
   readonly total: number;
   readonly roleIndex?: number;
-  readonly issues: readonly string[];
 }
-//#endregion
-//#region src/effort.d.ts
-/**
- * The `agentOptions` one (route, effort override) pair contributes.
- *
- * The two independent halves are easy to get wrong in opposite directions:
- *
- * - an inherit-parent route with an override must still send `reasoningEffort`,
- *   which means `{ reasoningEffort }` on its own is a real `agentOptions` value and
- *   the backend still has to support the capability;
- * - an override always wins over the role line, because the caller asked for this
- *   delegation specifically.
- */
-export declare function agentOptionsFor(route: ChildRoute, effortOverride?: string): AgentOptions | undefined;
-//#endregion
-//#region src/subagent.d.ts
 /** Cordis row name, used by Loader diagnostics. */
 export declare const name = "pstack-subagent";
 /**
- * Delegation needs the tool registry, the subagent registry, and the LLM adapters.
- *
- * `agents` is deliberately **not** here. It is used only to reach a child this tool
- * has just started, and a composition without it still delegates: the children keep
- * the effort their request carried and cannot change it afterwards. Declaring it as
- * a hard dependency would make the whole row inert in such a profile, so the tool
- * would not exist at all — the failure `pstack-history` already paid for once with
- * `sessionQuery`. It is read per call through `ctx.get("agents")` instead, which is
- * why a controller mounted after this row is still seen.
+ * Delegation needs the tool registry, the subagent registry, the LLM adapters, and the
+ * session directory. `agents` is not here: it is optional and read per call, so a
+ * profile without it still delegates and the child simply keeps its starting effort.
  */
 export declare const inject: string[];
 /** Model-facing tool name. */
 export declare const TOOL_NAME = "pstack_subagent";
 /** Backend used when the row does not name one. */
 export declare const DEFAULT_SUBAGENT_PROVIDER = "spawn";
-/** Agent type used when the call does not name one. */
-export declare const DEFAULT_AGENT_KIND = "poteto-agent";
 /** The child kinds this tool knows how to brief. */
 export declare const AGENT_KINDS: readonly ["poteto-agent", "comment-sicko", "general"];
 export type AgentKind = (typeof AGENT_KINDS)[number];
-/** One exact route a row may authorize for explicit child selection. */
-export interface AllowedModelRoute {
-  readonly provider: string;
-  readonly model: string;
-}
 /** Row configuration. */
 export interface PstackSubagentConfig {
-  /** `ctx.subagents` provider to start children on. */
   readonly provider: string;
-  /**
-   * This row's delegation-depth cap. A call may lower it and may never exceed it.
-   * Omitted means the Host setting decides.
-   */
   readonly maxDepth?: number;
-  /**
-   * Exact routes this row authorizes. Empty means no explicit route limit. This is
-   * pstack's own check and is unrelated to the native session `allowedModels`
-   * policy, which this plugin does not read.
-   */
-  readonly allowedModels: readonly AllowedModelRoute[];
-  /** Non-empty allowlist; also what makes `agentPreset` appear in the schema. */
-  readonly allowedAgentPresets: readonly string[];
 }
-/** What a call asked for, after argument validation. */
+/** What a call asked for, after every required argument has been validated. */
 export interface DelegationArgs {
   readonly description: string;
   readonly prompt: string;
   readonly agent: AgentKind;
-  readonly role?: string;
-  readonly cwd?: string;
-  readonly agentPreset?: string;
-  readonly maxDepth?: number;
-  readonly roleIndex?: number;
-  /**
-   * Effort for every child this call starts, overriding each role line's value.
-   *
-   * Validated per entry against the model that entry will actually request, so a
-   * panel with one incompatible entry starts nothing rather than half its children.
-   */
-  readonly reasoningEffort?: string;
+  readonly role: string | null;
+  readonly cwd: string | null;
+  readonly maxDepth: number;
+  readonly roleIndex: number | null;
+  readonly reasoningEffort: string | null;
 }
 /** One child this call started. */
 export interface ChildRecord {
@@ -140,7 +76,6 @@ export interface ChildRecord {
   readonly agent: string;
   readonly role: string;
   readonly route: string;
-  /** The effort this child runs at, when any applies. */
   readonly effort?: string;
   readonly maxDepth?: number;
 }
@@ -158,73 +93,37 @@ export declare class PartialDelegationError extends DelegationError {
   readonly startedChildren: readonly ChildRecord[];
   constructor(message: string, startedChildren: readonly ChildRecord[]);
 }
-/** Raised when a required agent preamble is missing or unusable. */
-export declare class PreambleError extends DelegationError {
-  constructor(message: string);
-}
 /** The live services and locations one delegation reads. */
 export interface SubagentRuntime {
   readonly subagents: SubagentsHost;
   readonly llm: LlmHost;
-  /**
-   * The Agent registry, used to reach a child this tool just started.
-   *
-   * Optional because a row can be composed without the `agents` service and a
-   * delegation still works there: the children then keep the effort their request
-   * carried and simply cannot change it afterwards. Making it required would turn a
-   * missing service into a row that registers no tool at all.
-   */
+  /** Optional: absent means the child keeps the effort it was started with. */
   readonly agents?: AgentsHost;
-  /** `$DSH_HOME`, home of the role file. */
+  readonly workingDirectory: WorkingDirectoryHost;
   readonly dshHome: string;
-  /** Absolute package assets root, home of the agent preambles. */
-  readonly assetsRoot: string;
-}
-interface StandardSchemaIssue {
-  readonly message: string;
-  readonly path?: readonly (string | number)[];
 }
-type StandardSchemaResult = {
-  readonly value: PstackSubagentConfig;
-  readonly issues?: undefined;
-} | {
-  readonly issues: readonly StandardSchemaIssue[];
-};
-/**
- * Minimal Standard Schema for this row, so an omitted `config` is valid and a
- * typo fails at load instead of at the first delegation.
- */
-export declare const Config: {
-  "~standard": {
-    version: number;
-    vendor: string;
-    validate(value: unknown): StandardSchemaResult;
-  };
-};
 /**
- * Read one agent preamble from the package assets by absolute path.
+ * Validate the row configuration without a Schemastery dependency.
  *
- * A missing or empty preamble blocks that agent type. It never degrades into a
- * plain child, because a `comment-sicko` or `poteto-agent` child without its
- * instructions is a different agent wearing the name.
- */
-export declare function loadAgentPreamble(agent: AgentKind, assetsRoot: string): string | undefined;
-/** One absolute path the Host injects into a child brief. */
-export interface InjectedPath {
-  readonly label: string;
-  readonly path: string;
-}
-/**
- * Compose the self-contained prompt one child receives.
- *
- * The preambles used to locate things themselves; the Host injects the absolute
- * paths instead, so a child never scans a plugin directory or guesses a version.
+ * A typo must fail at activation rather than at the first delegation, and an omitted
+ * `config` must be valid. Cordis passes the raw mapping because this row exports no
+ * `Config` object; callers that object as `config` are still checked here.
  */
+export declare function normalizeConfig(value: unknown): PstackSubagentConfig;
+/** The preset id behind each pstack agent kind. `general` joins the parent preset. */
+export declare const AGENT_PRESETS: Readonly<Record<Exclude<AgentKind, "general">, string>>;
+/** The preset a child of this kind must mount, or undefined to join the parent preset. */
+export declare function agentPresetFor(agent: AgentKind): string | undefined;
+/** Compose the self-contained prompt one child receives. */
 export declare function composeChildPrompt(input: {
-  readonly preamble?: string;
-  readonly injectedPaths?: readonly InjectedPath[];
+  readonly injectedPaths?: readonly {
+    readonly label: string;
+    readonly path: string;
+  }[];
   readonly task: string;
 }): string;
+/** Validate every required model-facing argument. Null declines an optional setting. */
+export declare function parseDelegationArgs(raw: unknown): DelegationArgs;
 /** One planned child, before any Host call. */
 export interface ChildPlan {
   readonly index: number;
@@ -232,16 +131,15 @@ export interface ChildPlan {
   readonly label: string;
   readonly agent: AgentKind;
   readonly role: string;
-  readonly route: ChildRoute;
+  readonly route: Route;
   readonly routeLabel: string;
-  /** The effort this child will actually run at: the override when present, else the role line's. */
   readonly effort?: string;
   readonly agentOptions?: AgentOptions;
+  /** Preset id that supplies this child's persona and tool composition. */
   readonly agentPreset?: string;
   readonly cwd?: string;
   readonly maxDepth?: number;
 }
-/** The decided plan for one call. */
 export interface DelegationPlan {
   readonly agent: AgentKind;
   readonly prompt: string;
@@ -250,41 +148,15 @@ export interface DelegationPlan {
   readonly mode: RouteSelection["mode"];
   readonly roleIndex?: number;
   readonly roleTotal: number;
-  /** The call-wide effort override, when it supplied one. */
   readonly reasoningEffort?: string;
   readonly children: readonly ChildPlan[];
   readonly diagnostics: readonly string[];
 }
-/** The text form of one route, as reported back to the model. */
-export declare function routeLabel(route: ChildRoute): string;
-/**
- * The route text a caller sees when an effort override wins.
- *
- * `routeLabel` describes the role file, which stops being the whole truth once the
- * caller overrode the effort. Reporting the file's value there would tell the model
- * its override had been ignored.
- */
-export declare function plannedRouteLabel(route: ChildRoute, effortOverride?: string): string;
-/**
- * Take the smallest of the requested depth, this row's cap, and the Host setting.
- *
- * A request above the row cap is an error rather than a silent clamp, so a caller
- * cannot believe it asked for two levels when the row allows one.
- */
+/** Route text as reported to the model. */
+export declare function routeLabel(route: Route, effortOverride?: string): string;
+/** Take the smallest of the requested depth, this row's cap, and the Host setting. */
 export declare function resolveDelegationDepth(configured: number | undefined, requested: number | undefined, hostLimit: number | undefined): number | undefined;
-/**
- * Validate the model-facing arguments.
- *
- * The tool schema is advisory at the model boundary, so every constraint is
- * re-checked here and reported with the reason.
- */
-export declare function parseDelegationArgs(raw: unknown, config?: PstackSubagentConfig): DelegationArgs;
-/**
- * Resolve the role file, the routes, the prompt, and the depth into one plan.
- *
- * Pure with respect to the Host: it reads the role file and the packaged preamble,
- * and it makes no service call.
- */
+/** Resolve the role file, routes, prompt, and depth into one plan. Pure of service calls. */
 export declare function planDelegation(args: DelegationArgs, runtime: SubagentRuntime, config?: PstackSubagentConfig): DelegationPlan;
 /** Check the backend can enforce what this call asks for. */
 export declare function assertProviderCapabilities(capabilities: SubagentCapabilities, providerName: string, asks: {
@@ -293,44 +165,35 @@ export declare function assertProviderCapabilities(capabilities: SubagentCapabil
   readonly maxDepth: boolean;
 }): void;
 /**
- * Start the planned children.
+ * Resolve and validate one child's `cwd`.
  *
- * Everything that can be rejected has already been rejected. A failure at entry N
- * keeps children 1..N-1 running and reports their ids, because the runtime owns
- * those activations and this tool cannot roll them back.
+ * A child may run inside the session directory or inside an explicitly separate Git
+ * worktree. Anything else is refused: this tool does not create isolation, so it will
+ * not promise one.
+ */
+export declare function resolveChildCwd(requested: string | undefined, sessionRoot: string): string | undefined;
+/**
+ * Start the planned children. Everything rejectable has already been rejected; a
+ * failure at entry N keeps children 1..N-1 running and reports their ids.
  */
 export declare function startPlannedChildren(parent: Agent, plan: DelegationPlan, runtime: SubagentRuntime, config: PstackSubagentConfig, signal: AbortSignal): Promise<DelegationResult>;
 /** Full delegation: plan, validate, start. */
 export declare function delegate(parent: Agent, args: DelegationArgs, runtime: SubagentRuntime, config?: PstackSubagentConfig, signal?: AbortSignal): Promise<DelegationResult>;
-export declare const OUTPUT_SCHEMA: JsonSchemaNode;
 /** Render one delegation result for the model. */
 export declare function renderDelegationResult(result: DelegationResult): string;
 /** Build the model-facing tool for one row. */
 export declare function createPstackSubagentTool(runtime: SubagentRuntime, config?: PstackSubagentConfig): ToolDefinition;
-/**
- * The slices of the Cordis context this row uses.
- *
- * `agents` is optional in both directions: it is absent from `inject` and read per
- * call below, so a profile that mounts no agent registry still registers this tool.
- * See the `inject` comment for why a hard dependency is the wrong shape here.
- */
+/** The slices of the Cordis context this row uses. */
 export interface PstackSubagentHost {
   readonly tools: ToolsHost;
   readonly subagents: SubagentsHost;
   readonly llm: LlmHost;
+  readonly workingDirectory: WorkingDirectoryHost;
 }
 /** Build the runtime a real Host call reads. */
 export declare function hostRuntime(ctx: PstackSubagentHost, getAgentRegistry?: () => AgentsHost | undefined): SubagentRuntime;
-/**
- * Register `pstack_subagent` for this row.
- *
- * @param ctx - context providing the tool registry, the subagent registry, the LLM
- *   adapters, and optionally `ctx.get` for the agent registry.
- * @param config - validated row config.
- */
+/** Register `pstack_subagent` for this row. */
 export declare function apply(ctx: PstackSubagentHost & {
   get?: (name: string) => AgentsHost | undefined;
-}, config?: PstackSubagentConfig): void;
-//#endregion
-export {};
-//# sourceMappingURL=subagent.d.mts.map
+}, config?: unknown): void;
+export {};