@substrate-ai/core 0.19.54

package/dist/dispatch/types.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Types and interfaces for the Sub-Agent Dispatch Engine.
+ *
+ * This is the stable, type-safe dispatch contract exported from @substrate-ai/core.
+ * Consumers should import from this package rather than from the monolith.
+ */
+import type { ZodSchema } from "zod";
+import type { BillingMode } from "../types.js";
+import type { IRoutingResolver } from "../routing/routing-engine.js";
+/**
+ * Request payload for dispatching a sub-agent.
+ */
+export interface DispatchRequest<T = unknown> {
+    /** Compiled prompt to pass to the agent via stdin */
+    prompt: string;
+    /** Agent identifier (e.g., "claude-code", "codex", "gemini") */
+    agent: string;
+    /** Task type determines default timeout and output schema */
+    taskType: string;
+    /** Optional timeout override in milliseconds */
+    timeout?: number;
+    /** Optional Zod schema to validate the parsed YAML output */
+    outputSchema?: ZodSchema<T>;
+    /** Optional working directory for the spawned process (defaults to process.cwd()) */
+    workingDirectory?: string;
+    /** Optional model identifier override */
+    model?: string;
+    /** Optional maximum agentic turns override */
+    maxTurns?: number;
+    /** Optional OTLP endpoint URL for telemetry export */
+    otlpEndpoint?: string;
+    /** Optional story key for OTEL resource attribute tagging */
+    storyKey?: string;
+    /** Optional maximum context tokens ceiling */
+    maxContextTokens?: number;
+    /** Optional optimization directives derived from prior stories telemetry */
+    optimizationDirectives?: string;
+}
+/**
+ * Handle returned immediately when a dispatch is requested.
+ * Provides access to current status and lifecycle control.
+ */
+export interface DispatchHandle {
+    /** Unique identifier for this dispatch */
+    id: string;
+    /** Current lifecycle status */
+    status: "queued" | "running" | "completed" | "failed" | "timeout";
+    /** Cancel this dispatch (sends SIGTERM if running, removes from queue if queued) */
+    cancel(): Promise<void>;
+}
+/**
+ * Final result of a completed dispatch.
+ */
+export interface DispatchResult<T = unknown> {
+    /** Unique identifier matching the DispatchHandle */
+    id: string;
+    /** Final status of the dispatch */
+    status: "completed" | "failed" | "timeout";
+    /** Exit code from the subprocess */
+    exitCode: number;
+    /** Output from the agent */
+    output: string;
+    /** Parsed and validated YAML result (null if parsing failed or no schema) */
+    parsed: T | null;
+    /** Error description if parsing failed */
+    parseError: string | null;
+    /** Total duration from spawn to exit in milliseconds */
+    durationMs: number;
+    /** Token usage estimates */
+    tokenEstimate: {
+        /** Estimated input tokens (prompt.length / 4) */
+        input: number;
+        /** Estimated output tokens (output.length / 4) */
+        output: number;
+    };
+    /**
+     * True when AdapterOutputNormalizer exhausted all normalization strategies
+     * without extracting parseable YAML from the adapter's raw output (story 53-10).
+     * Authoritative signal for 'adapter-format' root cause classification.
+     * Optional — existing callers without the field continue to compile unchanged.
+     */
+    adapterError?: boolean;
+    /**
+     * Short verdict string for adapter format failures ('error').
+     * Set alongside adapterError when normalization is exhausted (story 53-10).
+     */
+    verdict?: string;
+    /**
+     * Human-readable error message for adapter format failures.
+     * Contains adapter_id | tried_strategies | raw_output_snippet (story 53-10).
+     */
+    errorMessage?: string;
+}
+/**
+ * Configuration for the Dispatcher.
+ */
+export interface DispatchConfig {
+    /** Maximum number of concurrently running dispatches */
+    maxConcurrency: number;
+    /** Default timeouts per task type in milliseconds */
+    defaultTimeouts: Record<string, number>;
+    /**
+     * Optional routing resolver for model selection.
+     * Typed as IRoutingResolver so packages/core does not depend on the monolith.
+     * The existing RoutingResolver class satisfies IRoutingResolver structurally.
+     */
+    routingResolver?: IRoutingResolver;
+}
+/**
+ * Default timeout values per task type (milliseconds).
+ */
+export declare const DEFAULT_TIMEOUTS: Record<string, number>;
+/**
+ * Default max agentic turns per task type.
+ * Passed as --max-turns to Claude CLI to prevent turn exhaustion without YAML emission.
+ */
+export declare const DEFAULT_MAX_TURNS: Record<string, number>;
+/**
+ * Current memory pressure state as seen by the dispatcher.
+ * Used by the orchestrator for pre-dispatch backoff-retry logic.
+ */
+export interface DispatcherMemoryState {
+    /** Available free memory in megabytes */
+    freeMB: number;
+    /** Minimum free memory threshold in megabytes */
+    thresholdMB: number;
+    /**
+     * Platform memory pressure level (macOS only).
+     * 1 = normal, 2 = warn, 4 = critical. 0 on non-macOS platforms.
+     */
+    pressureLevel: number;
+    /** True when available memory is below the threshold */
+    isPressured: boolean;
+}
+/**
+ * The main dispatcher interface for spawning, tracking, and collecting
+ * results from autonomous coding agents.
+ */
+export interface Dispatcher {
+    /**
+     * Dispatch a sub-agent with the given request.
+     *
+     * Returns a DispatchHandle synchronously with id, status, cancel(),
+     * and a result Promise that resolves with the final DispatchResult.
+     *
+     * If the concurrency limit is reached, the request is queued.
+     *
+     * @param request - Dispatch request with prompt, agent, taskType, and optional config
+     * @returns DispatchHandle with id, status, cancel(), and result Promise
+     */
+    dispatch<T>(request: DispatchRequest<T>): DispatchHandle & {
+        result: Promise<DispatchResult<T>>;
+    };
+    /**
+     * Return the number of queued (waiting) dispatches.
+     */
+    getPending(): number;
+    /**
+     * Return the number of currently running dispatches.
+     */
+    getRunning(): number;
+    /**
+     * Return current memory pressure state.
+     *
+     * Used by the orchestrator for pre-dispatch backoff-retry logic (Story 23-8).
+     * Callers can check isPressured before dispatching and back off if true.
+     */
+    getMemoryState(): DispatcherMemoryState;
+    /**
+     * Gracefully shut down the dispatcher.
+     *
+     * Sends SIGTERM to all running processes, waits 10 seconds, then
+     * sends SIGKILL to any remaining processes. Rejects new dispatch
+     * requests after this is called.
+     *
+     * @returns Promise that resolves when all processes have exited
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Error thrown when dispatch is attempted on a shutting-down dispatcher.
+ */
+export declare class DispatcherShuttingDownError extends Error {
+    constructor();
+}
+/**
+ * Minimal spawn command descriptor used by DispatcherImpl.
+ * The concrete SpawnCommand from src/adapters/types satisfies this structurally.
+ */
+export interface ISpawnCommand {
+    /** The binary to execute */
+    binary: string;
+    /** Arguments to pass to the binary */
+    args: string[];
+    /** Working directory for the process */
+    cwd: string;
+    /** Optional environment variable overrides */
+    env?: Record<string, string>;
+    /** Optional list of environment variable keys to unset in the child process */
+    unsetEnvKeys?: string[];
+}
+/**
+ * Minimal options passed to ICliAdapter.buildCommand().
+ * The concrete AdapterOptions from src/adapters/types satisfies this structurally.
+ */
+export interface IAdapterOptions {
+    /** Path to the git worktree for this task */
+    worktreePath: string;
+    /** Billing mode to use for this execution */
+    billingMode: BillingMode;
+    /** Optional model identifier override */
+    model?: string;
+    /** Optional maximum agentic turns */
+    maxTurns?: number;
+    /** Optional maximum context tokens */
+    maxContextTokens?: number;
+    /** Optional OTLP endpoint URL for telemetry export */
+    otlpEndpoint?: string;
+    /** Optional story key for OTEL resource attribute tagging */
+    storyKey?: string;
+    /** Optional optimization directives */
+    optimizationDirectives?: string;
+    /** Task type for OTLP attribution */
+    taskType?: string;
+    /** Unique dispatch ID for per-dispatch telemetry correlation */
+    dispatchId?: string;
+}
+/**
+ * Minimal CLI adapter interface.
+ * Only defines the methods DispatcherImpl actually calls.
+ * The concrete WorkerAdapter from src/adapters satisfies this structurally.
+ */
+export interface ICliAdapter {
+    buildCommand(prompt: string, options: IAdapterOptions): ISpawnCommand;
+    /** Return adapter capabilities for dispatch decisions. */
+    getCapabilities(): {
+        timeoutMultiplier?: number;
+        requiresYamlSuffix?: boolean;
+        supportsOtlpExport?: boolean;
+        supportsSystemPrompt?: boolean;
+        defaultMaxReviewCycles?: number;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Minimal adapter registry interface.
+ * Only defines the methods DispatcherImpl and RoutingEngineImpl actually call.
+ * The concrete AdapterRegistry from src/adapters satisfies this structurally.
+ */
+export interface IAdapterRegistry {
+    get(id: string): ICliAdapter | undefined;
+    /**
+     * Return all registered adapters.
+     * Optional — only needed for RoutingEngineImpl's no-policy fallback path.
+     * The concrete AdapterRegistry always has this method.
+     */
+    getAll?(): Array<{
+        id: string;
+    }>;
+}
+/**
+ * Logger interface compatible with both pino-style loggers and console.
+ * Methods accept any argument pattern: (msg: string) or (obj: unknown, msg?: string).
+ */
+export interface ILogger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/dispatch/types.d.ts.map

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

package/dist/dispatch/types.js

@@ -0,0 +1,76 @@
+/**
+ * Types and interfaces for the Sub-Agent Dispatch Engine.
+ *
+ * This is the stable, type-safe dispatch contract exported from @substrate-ai/core.
+ * Consumers should import from this package rather than from the monolith.
+ */
+// ---------------------------------------------------------------------------
+// Default timeouts
+// ---------------------------------------------------------------------------
+/**
+ * Default timeout values per task type (milliseconds).
+ */
+export const DEFAULT_TIMEOUTS = {
+    "analysis": 300_000,
+    "planning": 300_000,
+    "architecture": 300_000,
+    "story-generation": 300_000,
+    "create-story": 600_000,
+    "dev-story": 1_800_000,
+    "code-review": 900_000,
+    "minor-fixes": 300_000,
+    "major-rework": 900_000,
+    "readiness-check": 600_000,
+    "elicitation": 900_000,
+    "analysis-vision": 180_000,
+    "analysis-scope": 180_000,
+    "planning-classification": 180_000,
+    "planning-frs": 240_000,
+    "planning-nfrs": 240_000,
+    "arch-context": 180_000,
+    "arch-decisions": 240_000,
+    "arch-patterns": 240_000,
+    "story-epics": 240_000,
+    "story-stories": 600_000,
+};
+/**
+ * Default max agentic turns per task type.
+ * Passed as --max-turns to Claude CLI to prevent turn exhaustion without YAML emission.
+ */
+export const DEFAULT_MAX_TURNS = {
+    "analysis": 15,
+    "planning": 20,
+    "architecture": 25,
+    "story-generation": 30,
+    "readiness-check": 20,
+    "elicitation": 15,
+    "critique": 15,
+    "dev-story": 75,
+    "major-rework": 50,
+    "code-review": 25,
+    "create-story": 30,
+    "minor-fixes": 25,
+    "analysis-vision": 8,
+    "analysis-scope": 10,
+    "planning-classification": 8,
+    "planning-frs": 12,
+    "planning-nfrs": 12,
+    "arch-context": 10,
+    "arch-decisions": 15,
+    "arch-patterns": 12,
+    "story-epics": 15,
+    "story-stories": 20,
+};
+// ---------------------------------------------------------------------------
+// Error types
+// ---------------------------------------------------------------------------
+/**
+ * Error thrown when dispatch is attempted on a shutting-down dispatcher.
+ */
+export class DispatcherShuttingDownError extends Error {
+    constructor() {
+        super("Dispatcher is shutting down and cannot accept new requests");
+        this.name = "DispatcherShuttingDownError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/dispatch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dispatch/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuIH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,OAAO;IACnB,cAAc,EAAE,OAAO;IACvB,kBAAkB,EAAE,OAAO;IAC3B,cAAc,EAAE,OAAO;IACvB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,OAAO;IACtB,aAAa,EAAE,OAAO;IACtB,cAAc,EAAE,OAAO;IACvB,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,OAAO;IACtB,iBAAiB,EAAE,OAAO;IAC1B,gBAAgB,EAAE,OAAO;IACzB,yBAAyB,EAAE,OAAO;IAClC,cAAc,EAAE,OAAO;IACvB,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,OAAO;IACvB,gBAAgB,EAAE,OAAO;IACzB,eAAe,EAAE,OAAO;IACxB,aAAa,EAAE,OAAO;IACtB,eAAe,EAAE,OAAO;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,EAAE;IAClB,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,EAAE;IACpB,yBAAyB,EAAE,CAAC;IAC5B,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;CACpB,CAAA;AA4ED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD;QACE,KAAK,CAAC,4DAA4D,CAAC,CAAA;QACnE,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAA;IAC3C,CAAC;CACF"}

package/dist/dispatch/yaml-parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * YAML extraction and parsing for sub-agent output.
+ *
+ * Sub-agents emit structured YAML at the END of their output. This module
+ * extracts and validates that YAML block regardless of surrounding narrative
+ * text, reasoning, or code fences.
+ *
+ * Extraction strategy:
+ * 1. Scan from the END of the output (YAML is always last per output contract)
+ * 2. Look for fenced YAML blocks (```yaml...```) first
+ * 3. Fall back to unfenced lines starting with known anchor keys
+ * 4. If multiple YAML blocks exist, take the LAST one
+ * 5. Parse with js-yaml and optionally validate with Zod schema
+ */
+import type { ZodSchema } from 'zod';
+/**
+ * Extract the YAML result block from sub-agent output.
+ *
+ * Scans from the end of the output looking for:
+ * - A fenced YAML block (```yaml...``` or ```...```)
+ * - An unfenced block starting with a known anchor key
+ *
+ * If multiple blocks are found, the LAST one is returned.
+ *
+ * @param output - Raw stdout from the sub-agent process
+ * @returns The raw YAML string, or null if no valid block is found
+ */
+export declare function extractYamlBlock(output: string): string | null;
+/**
+ * Parse a YAML string and optionally validate it against a Zod schema.
+ *
+ * @param yamlText - Raw YAML string to parse
+ * @param schema   - Optional Zod schema for validation
+ * @returns Object with parsed result and optional error
+ */
+export declare function parseYamlResult<T>(yamlText: string, schema?: ZodSchema<T>): {
+    parsed: T | null;
+    error: string | null;
+};
+//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/dispatch/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/dispatch/yaml-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAYpC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB9D;AAmND;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GACpB;IAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAwC5C"}