@bhargavvc/sdd-cc 1.35.0 → 1.42.4

package/sdk/dist/sdd-transport-policy.js

@@ -0,0 +1,32 @@
+import { TRANSPORT_RAW_COMMANDS } from './query/query-policy-capability.js';
+const DEFAULT_POLICY = {
+    preferNative: true,
+    allowFallbackToSubprocess: true,
+    outputMode: 'json',
+};
+const BUILTIN_COMMAND_POLICY = Object.fromEntries(TRANSPORT_RAW_COMMANDS.map((command) => [command, { outputMode: 'raw' }]));
+const COMMAND_POLICY_OVERRIDES = {};
+export function resolveTransportPolicy(command) {
+    const override = {
+        ...(BUILTIN_COMMAND_POLICY[command] ?? {}),
+        ...(COMMAND_POLICY_OVERRIDES[command] ?? {}),
+    };
+    return {
+        preferNative: override.preferNative ?? DEFAULT_POLICY.preferNative,
+        allowFallbackToSubprocess: override.allowFallbackToSubprocess ?? DEFAULT_POLICY.allowFallbackToSubprocess,
+        outputMode: override.outputMode ?? DEFAULT_POLICY.outputMode,
+    };
+}
+export function setTransportPolicy(command, override) {
+    COMMAND_POLICY_OVERRIDES[command] = { ...(COMMAND_POLICY_OVERRIDES[command] ?? {}), ...override };
+}
+export function clearTransportPolicy(command) {
+    if (command) {
+        delete COMMAND_POLICY_OVERRIDES[command];
+        return;
+    }
+    for (const key of Object.keys(COMMAND_POLICY_OVERRIDES)) {
+        delete COMMAND_POLICY_OVERRIDES[key];
+    }
+}
+//# sourceMappingURL=sdd-transport-policy.js.map

package/sdk/dist/sdd-transport-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-transport-policy.js","sourceRoot":"","sources":["../src/sdd-transport-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAU5E,MAAM,cAAc,GAAoB;IACtC,YAAY,EAAE,IAAI;IAClB,yBAAyB,EAAE,IAAI;IAC/B,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,MAAM,sBAAsB,GAA6C,MAAM,CAAC,WAAW,CACzF,sBAAsB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,KAAc,EAAE,CAAC,CAAC,CACnF,CAAC;AAEF,MAAM,wBAAwB,GAA6C,EAAE,CAAC;AAE9E,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1C,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;KAC7C,CAAC;IACF,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY;QAClE,yBAAyB,EACvB,QAAQ,CAAC,yBAAyB,IAAI,cAAc,CAAC,yBAAyB;QAChF,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAkC;IACpF,wBAAwB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACxD,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/sdk/dist/sdd-transport.d.ts

@@ -0,0 +1,39 @@
+import type { QueryResult } from './query/utils.js';
+import type { QueryRegistry } from './query/registry.js';
+import type { TransportMode } from './sdd-transport-policy.js';
+export interface TransportRequest {
+    legacyCommand: string;
+    legacyArgs: string[];
+    registryCommand: string;
+    registryArgs: string[];
+    mode: TransportMode;
+    projectDir: string;
+    workstream?: string;
+}
+export interface TransportAdapters {
+    dispatchNative: (request: TransportRequest) => Promise<QueryResult>;
+    execSubprocessJson: (legacyCommand: string, legacyArgs: string[]) => Promise<unknown>;
+    execSubprocessRaw: (legacyCommand: string, legacyArgs: string[]) => Promise<string>;
+    formatNativeRaw?: (registryCommand: string, data: unknown) => string;
+}
+export interface TransportPolicyLike {
+    preferNative: boolean;
+    allowFallbackToSubprocess: boolean;
+}
+export interface TransportDecision {
+    dispatchMode: 'native' | 'subprocess';
+    reason?: 'workstream_forced' | 'native_not_preferred' | 'native_unregistered' | 'native_failure_fallback';
+}
+export declare class SDDTransport {
+    private readonly registry;
+    private readonly adapters;
+    constructor(registry: QueryRegistry, adapters: TransportAdapters);
+    run(request: TransportRequest, policy: TransportPolicyLike, onDecision?: (decision: TransportDecision) => void): Promise<unknown>;
+    private shouldUseNative;
+    private subprocessReason;
+    private shouldRethrowNativeError;
+    private dispatchSubprocess;
+    private projectNativeOutput;
+    private toRaw;
+}
+//# sourceMappingURL=sdd-transport.d.ts.map

package/sdk/dist/sdd-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-transport.d.ts","sourceRoot":"","sources":["../src/sdd-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,iBAAiB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,eAAe,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,QAAQ,GAAG,YAAY,CAAC;IACtC,MAAM,CAAC,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,yBAAyB,CAAC;CAC3G;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,iBAAiB;IAGxC,GAAG,CACP,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GACjD,OAAO,CAAC,OAAO,CAAC;IA2BnB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,KAAK;CAMd"}

package/sdk/dist/sdd-transport.js

@@ -0,0 +1,78 @@
+import { toFailureSignal } from './query-failure-classification.js';
+import { SDDToolsError } from './sdd-tools-error.js';
+export class SDDTransport {
+    registry;
+    adapters;
+    constructor(registry, adapters) {
+        this.registry = registry;
+        this.adapters = adapters;
+    }
+    async run(request, policy, onDecision) {
+        const useNative = this.shouldUseNative(request, policy);
+        if (useNative) {
+            try {
+                const native = await this.adapters.dispatchNative(request);
+                onDecision?.({ dispatchMode: 'native' });
+                return this.projectNativeOutput(request, native.data);
+            }
+            catch (error) {
+                if (this.shouldRethrowNativeError(error, policy))
+                    throw error;
+                onDecision?.({ dispatchMode: 'subprocess', reason: 'native_failure_fallback' });
+            }
+        }
+        else {
+            const reason = this.subprocessReason(request, policy);
+            if (!policy.allowFallbackToSubprocess && reason === 'native_unregistered') {
+                throw SDDToolsError.failure(`Subprocess fallback disabled: command '${request.registryCommand}' cannot run without native dispatch`, request.legacyCommand, request.legacyArgs, null);
+            }
+            onDecision?.({ dispatchMode: 'subprocess', reason });
+        }
+        return this.dispatchSubprocess(request);
+    }
+    shouldUseNative(request, policy) {
+        const forceSubprocess = Boolean(request.workstream);
+        return !forceSubprocess && policy.preferNative && this.registry.has(request.registryCommand);
+    }
+    subprocessReason(request, policy) {
+        if (request.workstream)
+            return 'workstream_forced';
+        if (!policy.preferNative)
+            return 'native_not_preferred';
+        if (!this.registry.has(request.registryCommand))
+            return 'native_unregistered';
+        throw new Error(`Unexpected subprocess reason state for command '${request.registryCommand}' with preferNative=${String(policy.preferNative)} and workstream=${String(request.workstream)}`);
+    }
+    shouldRethrowNativeError(error, policy) {
+        if (!policy.allowFallbackToSubprocess)
+            return true;
+        // Do not subprocess-fallback after a timed-out native dispatch:
+        // the timeout does not cancel the native handler, so falling through
+        // would run the same command twice (double-execution race).
+        return toFailureSignal(error).kind === 'timeout';
+    }
+    dispatchSubprocess(request) {
+        if (request.mode === 'raw') {
+            return this.adapters.execSubprocessRaw(request.legacyCommand, request.legacyArgs);
+        }
+        return this.adapters.execSubprocessJson(request.legacyCommand, request.legacyArgs);
+    }
+    projectNativeOutput(request, data) {
+        if (request.mode === 'raw') {
+            if (this.adapters.formatNativeRaw) {
+                return this.adapters.formatNativeRaw(request.registryCommand, data).trim();
+            }
+            return this.toRaw(data);
+        }
+        return data;
+    }
+    toRaw(data) {
+        if (typeof data === 'string')
+            return data.trim();
+        const json = JSON.stringify(data, null, 2);
+        if (json == null)
+            return '';
+        return json.trim();
+    }
+}
+//# sourceMappingURL=sdd-transport.js.map

package/sdk/dist/sdd-transport.js.map

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

package/sdk/dist/sdk-package-compatibility.d.ts

@@ -0,0 +1,38 @@
+import { createRequire } from 'node:module';
+export type LegacySdkAsset = 'sdd-tools' | 'core-cjs';
+export interface LegacySdkAssetResolution {
+    asset: LegacySdkAsset;
+    path: string | null;
+    fallbackPath: string;
+    probes: string[];
+}
+interface LegacySdkCompatibilityDeps {
+    existsSync?: (path: string) => boolean;
+    homeDir?: string;
+    createRequire?: typeof createRequire;
+}
+export declare const BUNDLED_SDD_TOOLS_PATH: string;
+export declare const BUNDLED_CORE_CJS_PATH: string;
+export declare const BUNDLED_SDD_TEMPLATES_DIR: string;
+export declare const BUNDLED_SDD_AGENTS_DIR: string;
+export declare function resolveLegacyInstallDir(homeDir?: string): string;
+export declare function resolveLegacyTemplatesDir(homeDir?: string): string;
+export declare function resolveLegacyWorkflowsDir(homeDir?: string): string;
+export declare function resolveLegacyUserProfilePath(homeDir?: string): string;
+export declare function resolveLegacySkillsDir(homeDir?: string): string;
+export declare function resolveBundledTemplatesDir(): string;
+export declare function resolveBundledAgentsDir(): string;
+export declare function probeLegacySdkAsset(asset: LegacySdkAsset, projectDir: string, deps?: LegacySdkCompatibilityDeps): LegacySdkAssetResolution;
+/**
+ * Resolve the legacy `sdd-tools.cjs` executable path through the SDK Package Seam Module.
+ *
+ * Preserves historical behavior: if no probe exists, return the final fallback path so
+ * downstream subprocess errors still show a concrete location.
+ */
+export declare function resolveSddToolsPath(projectDir: string, deps?: LegacySdkCompatibilityDeps): string;
+/**
+ * Load `loadConfig(cwd)` from the legacy CJS install through one compatibility seam.
+ */
+export declare function loadLegacyCoreConfig(projectDir: string, deps?: LegacySdkCompatibilityDeps): Record<string, unknown>;
+export {};
+//# sourceMappingURL=sdk-package-compatibility.d.ts.map

package/sdk/dist/sdk-package-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-package-compatibility.d.ts","sourceRoot":"","sources":["../src/sdk-package-compatibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,0BAA0B;IAClC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;CACtC;AAED,eAAO,MAAM,sBAAsB,QAElC,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAEjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAElC,CAAC;AAYF,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAE3E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAE7E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAE7E;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAE1E;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAWD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,0BAA+B,GACpC,wBAAwB,CAS1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,0BAA+B,GAAG,MAAM,CAGrG;AAUD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,0BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBvH"}

package/sdk/dist/sdk-package-compatibility.js

@@ -0,0 +1,90 @@
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SDDError, ErrorClassification } from './errors.js';
+export const BUNDLED_SDD_TOOLS_PATH = fileURLToPath(new URL('../../sdd/bin/sdd-tools.cjs', import.meta.url));
+export const BUNDLED_CORE_CJS_PATH = fileURLToPath(new URL('../../sdd/bin/lib/core.cjs', import.meta.url));
+export const BUNDLED_SDD_TEMPLATES_DIR = fileURLToPath(new URL('../../sdd/templates', import.meta.url));
+export const BUNDLED_SDD_AGENTS_DIR = fileURLToPath(new URL('../../agents', import.meta.url));
+const LEGACY_ASSET_SUBPATH = {
+    'sdd-tools': 'sdd-tools.cjs',
+    'core-cjs': join('lib', 'core.cjs'),
+};
+const BUNDLED_LEGACY_ASSET_PATH = {
+    'sdd-tools': BUNDLED_SDD_TOOLS_PATH,
+    'core-cjs': BUNDLED_CORE_CJS_PATH,
+};
+export function resolveLegacyInstallDir(homeDir = homedir()) {
+    return join(homeDir, '.claude', 'sdd');
+}
+export function resolveLegacyTemplatesDir(homeDir = homedir()) {
+    return join(resolveLegacyInstallDir(homeDir), 'templates');
+}
+export function resolveLegacyWorkflowsDir(homeDir = homedir()) {
+    return join(resolveLegacyInstallDir(homeDir), 'workflows');
+}
+export function resolveLegacyUserProfilePath(homeDir = homedir()) {
+    return join(resolveLegacyInstallDir(homeDir), 'USER-PROFILE.md');
+}
+export function resolveLegacySkillsDir(homeDir = homedir()) {
+    return join(resolveLegacyInstallDir(homeDir), 'skills');
+}
+export function resolveBundledTemplatesDir() {
+    return BUNDLED_SDD_TEMPLATES_DIR;
+}
+export function resolveBundledAgentsDir() {
+    return BUNDLED_SDD_AGENTS_DIR;
+}
+function legacyAssetProbes(asset, projectDir, homeDir) {
+    const suffix = LEGACY_ASSET_SUBPATH[asset];
+    return [
+        BUNDLED_LEGACY_ASSET_PATH[asset],
+        join(projectDir, '.claude', 'sdd', 'bin', suffix),
+        join(homeDir, '.claude', 'sdd', 'bin', suffix),
+    ];
+}
+export function probeLegacySdkAsset(asset, projectDir, deps = {}) {
+    const pathExists = deps.existsSync ?? existsSync;
+    const probes = legacyAssetProbes(asset, projectDir, deps.homeDir ?? homedir());
+    return {
+        asset,
+        path: probes.find(candidate => pathExists(candidate)) ?? null,
+        fallbackPath: probes[probes.length - 1],
+        probes,
+    };
+}
+/**
+ * Resolve the legacy `sdd-tools.cjs` executable path through the SDK Package Seam Module.
+ *
+ * Preserves historical behavior: if no probe exists, return the final fallback path so
+ * downstream subprocess errors still show a concrete location.
+ */
+export function resolveSddToolsPath(projectDir, deps = {}) {
+    const resolution = probeLegacySdkAsset('sdd-tools', projectDir, deps);
+    return resolution.path ?? resolution.fallbackPath;
+}
+function missingLegacyCoreMessage(resolution) {
+    return [
+        'state load: sdd/bin/lib/core.cjs not found.',
+        `Checked: ${resolution.probes.join(', ')}`,
+        'Install SDD (e.g. npm i -g @bhargavvc/sdd-cc) or clone with sdd next to the SDK.',
+    ].join(' ');
+}
+/**
+ * Load `loadConfig(cwd)` from the legacy CJS install through one compatibility seam.
+ */
+export function loadLegacyCoreConfig(projectDir, deps = {}) {
+    const resolution = probeLegacySdkAsset('core-cjs', projectDir, deps);
+    if (!resolution.path) {
+        throw new SDDError(missingLegacyCoreMessage(resolution), ErrorClassification.Blocked);
+    }
+    const req = (deps.createRequire ?? createRequire)(import.meta.url);
+    const mod = req(resolution.path);
+    if (typeof mod.loadConfig !== 'function') {
+        throw new SDDError(`state load: invalid core.cjs at ${resolution.path} (missing loadConfig(cwd)).`, ErrorClassification.Blocked);
+    }
+    return mod.loadConfig(projectDir);
+}
+//# sourceMappingURL=sdk-package-compatibility.js.map

package/sdk/dist/sdk-package-compatibility.js.map

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

package/sdk/dist/session-runner.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session runner — orchestrates Agent SDK query() calls for plan execution.
+ *
+ * Takes a parsed plan, builds the executor prompt, configures query() options,
+ * processes the message stream, and extracts results into a typed PlanResult.
+ */
+import type { ParsedPlan, PlanResult, SessionOptions, PhaseStepType } from './types.js';
+import type { SDDConfig } from './config.js';
+import type { SDDEventStream, EventStreamContext } from './event-stream.js';
+/**
+ * Run a plan execution session via the Agent SDK query() function.
+ *
+ * Builds the executor prompt from the parsed plan, configures query() with
+ * appropriate permissions, tool restrictions, and budget limits, then iterates
+ * the message stream to extract the result.
+ *
+ * @param plan - Parsed plan structure
+ * @param config - SDD project configuration
+ * @param options - Session overrides (maxTurns, budget, model, etc.)
+ * @param agentDef - Raw agent definition content (optional, for tool/role extraction)
+ * @returns Typed PlanResult with cost, duration, success/error status
+ */
+export declare function runPlanSession(plan: ParsedPlan, config: SDDConfig, options?: SessionOptions, agentDef?: string, eventStream?: SDDEventStream, streamContext?: EventStreamContext, phaseDir?: string): Promise<PlanResult>;
+/**
+ * Run a phase step session via the Agent SDK query() function.
+ *
+ * Unlike runPlanSession which takes a ParsedPlan, this accepts a raw prompt
+ * string and a phase step type. The prompt becomes the system prompt append,
+ * and tools are scoped by phase type.
+ *
+ * @param prompt - Raw prompt string to append to the system prompt
+ * @param phaseStep - Phase step type (determines tool scoping)
+ * @param config - SDD project configuration
+ * @param options - Session overrides (maxTurns, budget, model, etc.)
+ * @param eventStream - Optional event stream for observability
+ * @param streamContext - Optional context for event tagging
+ * @returns Typed PlanResult with cost, duration, success/error status
+ */
+export declare function runPhaseStepSession(prompt: string, phaseStep: PhaseStepType, config: SDDConfig, options?: SessionOptions, eventStream?: SDDEventStream, streamContext?: EventStreamContext): Promise<PlanResult>;
+//# sourceMappingURL=session-runner.d.ts.map

package/sdk/dist/session-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runner.d.ts","sourceRoot":"","sources":["../src/session-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAoC,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAuD5E;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,cAAc,EAC5B,aAAa,CAAC,EAAE,kBAAkB,EAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAuJD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,cAAc,EAC5B,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,UAAU,CAAC,CA4BrB"}

package/sdk/dist/session-runner.js

@@ -0,0 +1,274 @@
+/**
+ * Session runner — orchestrates Agent SDK query() calls for plan execution.
+ *
+ * Takes a parsed plan, builds the executor prompt, configures query() options,
+ * processes the message stream, and extracts results into a typed PlanResult.
+ */
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { SDDEventType, PhaseType } from './types.js';
+import { buildExecutorPrompt, parseAgentTools, DEFAULT_ALLOWED_TOOLS } from './prompt-builder.js';
+import { getToolsForPhase } from './tool-scoping.js';
+import { detectRuntime } from './query/helpers.js';
+import { resolveRuntimeTierDefault } from './model-catalog.js';
+// ─── Model resolution ────────────────────────────────────────────────────────
+/**
+ * Resolve model identifier from options or config profile.
+ *
+ * Priority: explicit model option > config model_profile > default.
+ *
+ * Runtime-aware (#2832): the profile -> Claude-id map only applies when the
+ * project is targeting the Claude runtime. For Codex, Gemini, OpenCode, etc.,
+ * forcing a Claude model id (e.g. 'claude-sonnet-4-6') silently routes the
+ * autonomous run through the Claude path, which is wrong for those runtimes.
+ * In those cases — and whenever `resolve_model_ids: "omit"` is set — leave
+ * `model` unset so the runtime falls back to its configured default.
+ */
+function resolveModel(options, config) {
+    if (options?.model)
+        return options.model;
+    // Honor the explicit "don't resolve model ids" config knob (#2652, #2832).
+    // Mirrors `query/config-query.ts` resolve_model_ids === 'omit' branch.
+    if (config?.resolve_model_ids === 'omit') {
+        return undefined;
+    }
+    // Profile -> Claude id map. Applies only on the Claude runtime.
+    // Use `detectRuntime` so `SDD_RUNTIME` env precedence is honored — a Codex
+    // run with a Claude-shaped config must NOT be silently routed to Claude.
+    const runtime = detectRuntime({
+        runtime: config?.runtime,
+    });
+    if (runtime !== 'claude') {
+        // Non-Claude runtimes: never inject a Claude id from the profile map.
+        return undefined;
+    }
+    if (config?.model_profile) {
+        const profile = String(config.model_profile).toLowerCase();
+        if (profile === 'inherit')
+            return undefined;
+        const tier = profile === 'quality' ? 'opus'
+            : (profile === 'budget' || profile === 'speed') ? 'haiku'
+                : (profile === 'balanced' || profile === 'adaptive') ? 'sonnet'
+                    : null;
+        if (!tier)
+            return config.model_profile;
+        return resolveRuntimeTierDefault('claude', tier)?.model;
+    }
+    return undefined; // Let SDK use its default
+}
+// ─── Session runner ──────────────────────────────────────────────────────────
+/**
+ * Run a plan execution session via the Agent SDK query() function.
+ *
+ * Builds the executor prompt from the parsed plan, configures query() with
+ * appropriate permissions, tool restrictions, and budget limits, then iterates
+ * the message stream to extract the result.
+ *
+ * @param plan - Parsed plan structure
+ * @param config - SDD project configuration
+ * @param options - Session overrides (maxTurns, budget, model, etc.)
+ * @param agentDef - Raw agent definition content (optional, for tool/role extraction)
+ * @returns Typed PlanResult with cost, duration, success/error status
+ */
+export async function runPlanSession(plan, config, options, agentDef, eventStream, streamContext, phaseDir) {
+    // Build the executor prompt
+    const executorPrompt = buildExecutorPrompt(plan, { agentDef, phaseDir });
+    // Resolve allowed tools — from agent definition or defaults
+    const allowedTools = options?.allowedTools ??
+        (agentDef ? parseAgentTools(agentDef) : DEFAULT_ALLOWED_TOOLS);
+    // Resolve model
+    const model = resolveModel(options, config);
+    // Configure query options
+    const maxTurns = options?.maxTurns ?? 50;
+    const maxBudgetUsd = options?.maxBudgetUsd ?? 5.0;
+    const cwd = options?.cwd ?? process.cwd();
+    const queryStream = query({
+        prompt: `Execute this plan:\n\n${plan.objective || 'Execute the plan tasks below.'}`,
+        options: {
+            systemPrompt: {
+                type: 'preset',
+                preset: 'claude_code',
+                append: executorPrompt,
+            },
+            settingSources: ['project'],
+            allowedTools,
+            permissionMode: 'bypassPermissions',
+            allowDangerouslySkipPermissions: true,
+            maxTurns,
+            maxBudgetUsd,
+            cwd,
+            ...(model ? { model } : {}),
+        },
+    });
+    return processQueryStream(queryStream, eventStream, streamContext);
+}
+// ─── Result extraction ───────────────────────────────────────────────────────
+function isResultMessage(msg) {
+    return msg.type === 'result';
+}
+function isSuccessResult(msg) {
+    return msg.subtype === 'success';
+}
+function isErrorResult(msg) {
+    return msg.subtype !== 'success';
+}
+function emptyUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadInputTokens: 0,
+        cacheCreationInputTokens: 0,
+    };
+}
+function extractUsage(msg) {
+    const u = msg.usage;
+    return {
+        inputTokens: u.input_tokens ?? 0,
+        outputTokens: u.output_tokens ?? 0,
+        cacheReadInputTokens: u.cache_read_input_tokens ?? 0,
+        cacheCreationInputTokens: u.cache_creation_input_tokens ?? 0,
+    };
+}
+function extractResult(msg) {
+    const base = {
+        sessionId: msg.session_id,
+        totalCostUsd: msg.total_cost_usd,
+        durationMs: msg.duration_ms,
+        usage: extractUsage(msg),
+        numTurns: msg.num_turns,
+    };
+    if (isSuccessResult(msg)) {
+        return {
+            ...base,
+            success: true,
+        };
+    }
+    // Error result
+    const errorMsg = msg;
+    return {
+        ...base,
+        success: false,
+        error: {
+            subtype: errorMsg.subtype,
+            messages: errorMsg.errors ?? [],
+        },
+    };
+}
+// ─── Shared stream processing ────────────────────────────────────────────────
+/**
+ * Process a query() message stream, emit events, and extract the result.
+ * Shared between runPlanSession and runPhaseStepSession to avoid duplication.
+ */
+async function processQueryStream(queryStream, eventStream, streamContext) {
+    let resultMessage;
+    try {
+        for await (const message of queryStream) {
+            if (eventStream) {
+                eventStream.mapAndEmit(message, streamContext ?? {});
+            }
+            if (isResultMessage(message)) {
+                resultMessage = message;
+            }
+        }
+    }
+    catch (err) {
+        return {
+            success: false,
+            sessionId: '',
+            totalCostUsd: 0,
+            durationMs: 0,
+            usage: emptyUsage(),
+            numTurns: 0,
+            error: {
+                subtype: 'error_during_execution',
+                messages: [err instanceof Error ? err.message : String(err)],
+            },
+        };
+    }
+    if (!resultMessage) {
+        return {
+            success: false,
+            sessionId: '',
+            totalCostUsd: 0,
+            durationMs: 0,
+            usage: emptyUsage(),
+            numTurns: 0,
+            error: {
+                subtype: 'error_during_execution',
+                messages: ['No result message received from query stream'],
+            },
+        };
+    }
+    const result = extractResult(resultMessage);
+    if (eventStream) {
+        const cost = eventStream.getCost();
+        eventStream.emitEvent({
+            type: SDDEventType.CostUpdate,
+            timestamp: new Date().toISOString(),
+            sessionId: resultMessage.session_id,
+            phase: streamContext?.phase,
+            planName: streamContext?.planName,
+            sessionCostUsd: result.totalCostUsd,
+            cumulativeCostUsd: cost.cumulative,
+        });
+    }
+    return result;
+}
+// ─── Phase step session runner ───────────────────────────────────────────────
+/**
+ * Map PhaseStepType to PhaseType for tool scoping.
+ * PhaseStepType includes 'advance' which has no session-level equivalent.
+ */
+function stepTypeToPhaseType(step) {
+    const mapping = {
+        discuss: PhaseType.Discuss,
+        research: PhaseType.Research,
+        plan: PhaseType.Plan,
+        plan_check: PhaseType.Verify,
+        execute: PhaseType.Execute,
+        verify: PhaseType.Verify,
+    };
+    return mapping[step] ?? PhaseType.Execute;
+}
+/**
+ * Run a phase step session via the Agent SDK query() function.
+ *
+ * Unlike runPlanSession which takes a ParsedPlan, this accepts a raw prompt
+ * string and a phase step type. The prompt becomes the system prompt append,
+ * and tools are scoped by phase type.
+ *
+ * @param prompt - Raw prompt string to append to the system prompt
+ * @param phaseStep - Phase step type (determines tool scoping)
+ * @param config - SDD project configuration
+ * @param options - Session overrides (maxTurns, budget, model, etc.)
+ * @param eventStream - Optional event stream for observability
+ * @param streamContext - Optional context for event tagging
+ * @returns Typed PlanResult with cost, duration, success/error status
+ */
+export async function runPhaseStepSession(prompt, phaseStep, config, options, eventStream, streamContext) {
+    const phaseType = stepTypeToPhaseType(phaseStep);
+    const allowedTools = options?.allowedTools ?? getToolsForPhase(phaseType);
+    const model = resolveModel(options, config);
+    const maxTurns = options?.maxTurns ?? 50;
+    const maxBudgetUsd = options?.maxBudgetUsd ?? 5.0;
+    const cwd = options?.cwd ?? process.cwd();
+    const queryStream = query({
+        prompt: `Execute this phase step: ${phaseStep}`,
+        options: {
+            systemPrompt: {
+                type: 'preset',
+                preset: 'claude_code',
+                append: prompt,
+            },
+            settingSources: ['project'],
+            allowedTools,
+            permissionMode: 'bypassPermissions',
+            allowDangerouslySkipPermissions: true,
+            maxTurns,
+            maxBudgetUsd,
+            cwd,
+            ...(model ? { model } : {}),
+        },
+    });
+    return processQueryStream(queryStream, eventStream, streamContext);
+}
+//# sourceMappingURL=session-runner.js.map

package/sdk/dist/session-runner.js.map

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