@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/harness/planMode.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * GAP-USER-012: Plan Mode with Verification
+ *
+ * Interactive plan-verify-execute loop. Generates structured plans,
+ * presents for approval, executes with per-step verification,
+ * and allows plan modification mid-execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlan = createPlan;
+exports.updateStepStatus = updateStepStatus;
+exports.insertStep = insertStep;
+exports.removeStep = removeStep;
+exports.getNextStep = getNextStep;
+exports.getPlanProgress = getPlanProgress;
+exports.formatPlanForDisplay = formatPlanForDisplay;
+// ---------------------------------------------------------------------------
+// Plan construction
+// ---------------------------------------------------------------------------
+/** Create a new execution plan. */
+function createPlan(id, title, description, steps) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        title,
+        description,
+        steps: steps.map((s) => ({ ...s, status: "pending" })),
+        status: "draft",
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Update a step's status. */
+function updateStepStatus(plan, stepId, status, feedback) {
+    const now = new Date().toISOString();
+    const steps = plan.steps.map((s) => {
+        if (s.id !== stepId)
+            return s;
+        return {
+            ...s,
+            status,
+            completedAt: status === "completed" || status === "failed" ? now : s.completedAt,
+            feedback: feedback ?? s.feedback,
+        };
+    });
+    // Derive plan status from step statuses
+    const allCompleted = steps.every((s) => s.status === "completed" || s.status === "skipped");
+    const anyFailed = steps.some((s) => s.status === "failed");
+    const anyInProgress = steps.some((s) => s.status === "in_progress");
+    let planStatus = plan.status;
+    if (allCompleted)
+        planStatus = "completed";
+    else if (anyFailed)
+        planStatus = "failed";
+    else if (anyInProgress)
+        planStatus = "executing";
+    return { ...plan, steps, status: planStatus, updatedAt: now };
+}
+/** Insert a new step into the plan at a given position. */
+function insertStep(plan, step, afterStepId) {
+    const now = new Date().toISOString();
+    const newStep = { ...step, status: "pending" };
+    const steps = [...plan.steps];
+    if (afterStepId) {
+        const idx = steps.findIndex((s) => s.id === afterStepId);
+        if (idx >= 0) {
+            steps.splice(idx + 1, 0, newStep);
+        }
+        else {
+            steps.push(newStep);
+        }
+    }
+    else {
+        steps.push(newStep);
+    }
+    return { ...plan, steps, status: "modified", updatedAt: now };
+}
+/** Remove a step from the plan. Also removes it from other steps' dependsOn lists. */
+function removeStep(plan, stepId) {
+    const now = new Date().toISOString();
+    const steps = plan.steps
+        .filter((s) => s.id !== stepId)
+        .map((s) => ({
+        ...s,
+        dependsOn: s.dependsOn.filter((dep) => dep !== stepId),
+    }));
+    return {
+        ...plan,
+        steps,
+        status: "modified",
+        updatedAt: now,
+    };
+}
+/** Get the next executable step (all dependencies satisfied). */
+function getNextStep(plan) {
+    const completedIds = new Set(plan.steps
+        .filter((s) => s.status === "completed" || s.status === "skipped")
+        .map((s) => s.id));
+    return plan.steps.find((s) => s.status === "pending" &&
+        s.dependsOn.every((dep) => completedIds.has(dep)));
+}
+/** Get plan progress summary. */
+function getPlanProgress(plan) {
+    const total = plan.steps.length;
+    const completed = plan.steps.filter((s) => s.status === "completed" || s.status === "skipped").length;
+    const failed = plan.steps.filter((s) => s.status === "failed").length;
+    const pending = plan.steps.filter((s) => s.status === "pending").length;
+    return {
+        total,
+        completed,
+        failed,
+        pending,
+        percentComplete: total > 0 ? Math.round((completed / total) * 100) : 0,
+    };
+}
+/** Format plan for display. */
+function formatPlanForDisplay(plan) {
+    const progress = getPlanProgress(plan);
+    const lines = [
+        `## ${plan.title}`,
+        `Status: ${plan.status} | Progress: ${progress.completed}/${progress.total} (${progress.percentComplete}%)`,
+        "",
+        plan.description,
+        "",
+        "### Steps",
+    ];
+    for (const step of plan.steps) {
+        const statusIcon = {
+            pending: "[ ]",
+            in_progress: "[~]",
+            completed: "[x]",
+            failed: "[!]",
+            skipped: "[-]",
+            modified: "[*]",
+        }[step.status];
+        lines.push(`${statusIcon} **${step.id}**: ${step.title}`);
+        if (step.description)
+            lines.push(`    ${step.description}`);
+        if (step.dependsOn.length > 0)
+            lines.push(`    Depends on: ${step.dependsOn.join(", ")}`);
+        if (step.feedback)
+            lines.push(`    Feedback: ${step.feedback}`);
+    }
+    return lines.join("\n");
+}

package/dist/harness/selectionPolicies.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GAP-HADAPT-008: Harness Selection Policies.
+ *
+ * Configurable policies for harness selection: cost-optimized,
+ * latency-optimized, capability-first, user-preferred.
+ * Policy evaluator scores candidates using selectHarness from capabilityRouter.
+ */
+import { type TaskRequirements, type HarnessCandidate, type RoutingResult } from "./capabilityRouter";
+export type PolicyName = "cost-optimized" | "latency-optimized" | "capability-first" | "user-preferred";
+export interface SelectionPolicy {
+    name: PolicyName;
+    description: string;
+    evaluate(candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions): PolicyEvaluatorResult;
+}
+export interface PolicyEvaluatorResult {
+    selected: HarnessCandidate | null;
+    policyName: PolicyName;
+    score: number;
+    reason: string;
+    routingResult: RoutingResult | null;
+}
+export interface PolicyEvaluatorOptions {
+    preferredHarness?: string;
+}
+export declare function getDefaultPolicy(): SelectionPolicy;
+export declare function getPolicyByName(name: PolicyName): SelectionPolicy;
+export declare function createPolicyEvaluator(policy: SelectionPolicy): (candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions) => PolicyEvaluatorResult;
+export declare function evaluatePolicy(policyName: PolicyName, candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions): PolicyEvaluatorResult;
+//# sourceMappingURL=selectionPolicies.d.ts.map

package/dist/harness/selectionPolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionPolicies.d.ts","sourceRoot":"","sources":["../../src/harness/selectionPolicies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CACN,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkKD,wBAAgB,gBAAgB,IAAI,eAAe,CAElD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAMjE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GACtB,CACD,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,KAC7B,qBAAqB,CAGzB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAGvB"}

package/dist/harness/selectionPolicies.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * GAP-HADAPT-008: Harness Selection Policies.
+ *
+ * Configurable policies for harness selection: cost-optimized,
+ * latency-optimized, capability-first, user-preferred.
+ * Policy evaluator scores candidates using selectHarness from capabilityRouter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultPolicy = getDefaultPolicy;
+exports.getPolicyByName = getPolicyByName;
+exports.createPolicyEvaluator = createPolicyEvaluator;
+exports.evaluatePolicy = evaluatePolicy;
+const capabilityRouter_1 = require("./capabilityRouter");
+const types_1 = require("./types");
+// ---------------------------------------------------------------------------
+// Policy implementations
+// ---------------------------------------------------------------------------
+const capabilityFirstPolicy = {
+    name: "capability-first",
+    description: "Select the harness with the highest capability score",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "capability-first", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        return {
+            selected: result.selected,
+            policyName: "capability-first",
+            score: result.score,
+            reason: `Selected ${result.selected.name} with score ${result.score}`,
+            routingResult: result,
+        };
+    },
+};
+const costOptimizedPolicy = {
+    name: "cost-optimized",
+    description: "Prefer harnesses with fewer capabilities (proxy for lower cost)",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "cost-optimized", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        // Among eligible candidates (those that passed the threshold), pick the one
+        // with the fewest capabilities — a proxy for cost
+        const eligible = result.scores
+            .filter((s) => !s.disqualified && s.total >= 50)
+            .map((s) => s.name);
+        const eligibleCandidates = candidates.filter((c) => eligible.includes(c.name));
+        if (eligibleCandidates.length === 0) {
+            return { selected: null, policyName: "cost-optimized", score: 0, reason: "No eligible candidate", routingResult: result };
+        }
+        // Sort by fewest capabilities ascending
+        const sorted = [...eligibleCandidates].sort((a, b) => a.capabilities.length - b.capabilities.length);
+        const pick = sorted[0];
+        const pickScore = result.scores.find((s) => s.name === pick.name);
+        return {
+            selected: pick,
+            policyName: "cost-optimized",
+            score: pickScore?.total ?? 0,
+            reason: `Selected ${pick.name} (fewest capabilities: ${pick.capabilities.length})`,
+            routingResult: result,
+        };
+    },
+};
+const latencyOptimizedPolicy = {
+    name: "latency-optimized",
+    description: "Prefer harnesses with Programmatic + StopHook for lowest latency",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "latency-optimized", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        const eligible = result.scores
+            .filter((s) => !s.disqualified && s.total >= 50)
+            .map((s) => s.name);
+        const eligibleCandidates = candidates.filter((c) => eligible.includes(c.name));
+        if (eligibleCandidates.length === 0) {
+            return { selected: null, policyName: "latency-optimized", score: 0, reason: "No eligible candidate", routingResult: result };
+        }
+        // Score: +2 for StopHook, +2 for Programmatic, +1 for SessionBinding
+        const latencyScore = (c) => {
+            let s = 0;
+            if (c.capabilities.includes(types_1.HarnessCapability.StopHook))
+                s += 2;
+            if (c.capabilities.includes(types_1.HarnessCapability.Programmatic))
+                s += 2;
+            if (c.capabilities.includes(types_1.HarnessCapability.SessionBinding))
+                s += 1;
+            return s;
+        };
+        const sorted = [...eligibleCandidates].sort((a, b) => latencyScore(b) - latencyScore(a));
+        const pick = sorted[0];
+        const pickScore = result.scores.find((s) => s.name === pick.name);
+        return {
+            selected: pick,
+            policyName: "latency-optimized",
+            score: pickScore?.total ?? 0,
+            reason: `Selected ${pick.name} (latency-optimized: StopHook+Programmatic)`,
+            routingResult: result,
+        };
+    },
+};
+const userPreferredPolicy = {
+    name: "user-preferred",
+    description: "Select the user-preferred harness if it qualifies, else fall back to capability-first",
+    evaluate(candidates, requirements, options) {
+        const preferred = options?.preferredHarness;
+        if (preferred) {
+            // Try routing with the preferred harness hint
+            const augmented = {
+                ...requirements,
+                preferredHarness: preferred,
+            };
+            const result = (0, capabilityRouter_1.selectHarness)(augmented, candidates);
+            if (result && result.selected.name === preferred) {
+                return {
+                    selected: result.selected,
+                    policyName: "user-preferred",
+                    score: result.score,
+                    reason: `Selected user-preferred harness ${preferred}`,
+                    routingResult: result,
+                };
+            }
+        }
+        // Fall back to capability-first
+        const fallback = capabilityFirstPolicy.evaluate(candidates, requirements);
+        return {
+            ...fallback,
+            policyName: "user-preferred",
+            reason: preferred
+                ? `Preferred harness '${preferred}' not available, fell back to ${fallback.selected?.name ?? "none"}`
+                : fallback.reason,
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+const POLICIES = {
+    "capability-first": capabilityFirstPolicy,
+    "cost-optimized": costOptimizedPolicy,
+    "latency-optimized": latencyOptimizedPolicy,
+    "user-preferred": userPreferredPolicy,
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function getDefaultPolicy() {
+    return POLICIES["capability-first"];
+}
+function getPolicyByName(name) {
+    const policy = POLICIES[name];
+    if (!policy) {
+        throw new TypeError(`Unknown selection policy: ${String(name)}`);
+    }
+    return policy;
+}
+function createPolicyEvaluator(policy) {
+    return (candidates, requirements, options) => policy.evaluate(candidates, requirements, options);
+}
+function evaluatePolicy(policyName, candidates, requirements, options) {
+    const policy = getPolicyByName(policyName);
+    return policy.evaluate(candidates, requirements, options);
+}

package/dist/harness/types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+import type { AskUserQuestionUiContext } from "../interaction";
+import type { PromptContext } from "@a5c-ai/babysitter-sdk";
+/** Capabilities that a harness adapter may support. */
+export declare enum HarnessCapability {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    Programmatic = "programmatic",
+    /** Harness can bind a babysitter run to a host session. */
+    SessionBinding = "session-binding",
+    /** Harness implements the stop-hook lifecycle event. */
+    StopHook = "stop-hook",
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    Mcp = "mcp",
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HeadlessPrompt = "headless-prompt",
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    ConcurrentEffects = "concurrent-effects",
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    BackgroundEffects = "background-effects",
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    MultiHarnessDispatch = "multi-harness-dispatch"
+}
+/**
+ * Result of probing the local environment for a specific harness CLI.
+ *
+ * This is the **installed-discovery** result — it answers "is this CLI on
+ * PATH?" and "does config exist?".  It does NOT report whether we are
+ * currently running inside this harness; use `CallerHarnessResult` /
+ * `detectCallerHarness()` for that.
+ */
+export interface HarnessDiscoveryResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Whether the CLI binary was found on the system. */
+    installed: boolean;
+    /** Semantic version reported by the CLI, if obtainable. */
+    version?: string;
+    /** Absolute path to the CLI binary, if resolved. */
+    cliPath?: string;
+    /** Shell command used to invoke the CLI. */
+    cliCommand: string;
+    /** Whether harness-specific configuration was found on disk. */
+    configFound: boolean;
+    /** Capabilities advertised by this harness. */
+    capabilities: HarnessCapability[];
+    /** Platform identifier (e.g. "win32", "linux", "darwin"). */
+    platform: string;
+}
+/** Result of detecting which harness spawned the current process, if any. */
+export interface CallerHarnessResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Environment variable names that matched the active caller. */
+    matchedEnvVars: string[];
+    /** Capabilities advertised by the detected caller harness. */
+    capabilities: HarnessCapability[];
+}
+/** Callback invoked with each raw chunk from stdout or stderr. */
+export type StreamingOutputCallback = (chunk: string) => void;
+/** Callback invoked with each complete line and its source stream. */
+export type StreamingLineCallback = (line: string, source: "stdout" | "stderr") => void;
+/** Options for real-time streaming output capture from harness invocations. */
+export interface StreamingOutputOptions {
+    /** Called with each stdout chunk as it arrives. */
+    onStdout?: StreamingOutputCallback;
+    /** Called with each stderr chunk as it arrives. */
+    onStderr?: StreamingOutputCallback;
+    /** Called with each complete line (from either stream) as it becomes available. */
+    onLine?: StreamingLineCallback;
+}
+/** Options for programmatically invoking a harness CLI. */
+export interface HarnessInvokeOptions {
+    /** The prompt to send to the harness. */
+    prompt: string;
+    /** Working directory for the invocation. */
+    workspace?: string;
+    /** Model override (harness-specific). */
+    model?: string;
+    /** Maximum execution time in milliseconds. */
+    timeout?: number;
+    /** Whether to use RPC/structured-output mode. */
+    rpc?: boolean;
+    /** Additional environment variables passed to the child process. */
+    env?: Record<string, string>;
+    /** Real-time streaming output callbacks (GAP-SUBOBS-001). */
+    streaming?: StreamingOutputOptions;
+    /** AbortSignal to cancel the invocation and kill the child process. */
+    signal?: AbortSignal;
+}
+/** Result returned after a harness CLI invocation completes. */
+export interface HarnessInvokeResult {
+    /** Whether the invocation completed without error. */
+    success: boolean;
+    /** Combined stdout/stderr output from the CLI. */
+    output: string;
+    /** Process exit code. */
+    exitCode: number;
+    /** Wall-clock duration of the invocation in milliseconds. */
+    duration: number;
+    /** Name of the harness that was invoked. */
+    harness: string;
+    /** GAP-PERF-004: Whether output was streamed in real-time. */
+    streamed?: boolean;
+    /** GAP-PERF-004: Number of streaming chunks emitted. */
+    streamChunkCount?: number;
+}
+/** Options for creating a Pi harness session (programmatic API). */
+export interface AgentCoreSessionOptions {
+    /** Working directory for the session. */
+    workspace?: string;
+    /** Model identifier string (e.g. "claude-opus-4-5"). */
+    model?: string;
+    /** Maximum time in ms to wait for a single prompt to complete. */
+    timeout?: number;
+    /** Thinking level for the model. */
+    thinkingLevel?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** Built-in tool mode to expose to the model. */
+    toolsMode?: "default" | "coding" | "readonly";
+    /** Custom tool definitions to register with the session. */
+    customTools?: unknown[];
+    /** Optional extension-style UI context exposed to custom tools inside the PI loop. */
+    uiContext?: AskUserQuestionUiContext;
+    /** Replace the discovered system prompt with a custom one. */
+    systemPrompt?: string;
+    /** Append custom system prompt instructions. */
+    appendSystemPrompt?: string[];
+    /** Isolate the session from discovered extensions, skills, and AGENTS files. */
+    isolated?: boolean;
+    /** Use an in-memory session manager instead of persistent session files. */
+    ephemeral?: boolean;
+    /** Bash tool execution backend. Defaults to native/local PI execution; "secure" opts into the sandbox backend and "auto" falls back to local. */
+    bashSandbox?: "auto" | "secure" | "local";
+    /** Whether PI session compaction should be enabled for this session. */
+    enableCompaction?: boolean;
+    /** Global pi agent config directory (default: ~/.pi/agent). */
+    agentDir?: string;
+}
+/**
+ * Event emitted by a Pi session during prompt execution.
+ * Mirrors the AgentSessionEvent union from `@mariozechner/pi-coding-agent`.
+ */
+export interface AgentCoreSessionEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Result of sending a prompt through a Pi session. */
+export interface AgentCorePromptResult {
+    /** Collected text output from the agent response. */
+    output: string;
+    /** Wall-clock duration in milliseconds. */
+    duration: number;
+    /** Whether the prompt completed without error. */
+    success: boolean;
+    /** Exit code (0 = success, 1 = failure). */
+    exitCode: number;
+}
+export interface SessionBindOptions {
+    sessionId: string;
+    runId: string;
+    runDir: string;
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    maxIterations?: number;
+    prompt: string;
+    verbose: boolean;
+    json: boolean;
+}
+export interface SessionBindResult {
+    harness: string;
+    sessionId: string;
+    stateFile?: string;
+    error?: string;
+    /** When true, the error is fatal and run:create should exit non-zero. */
+    fatal?: boolean;
+}
+export interface HookHandlerArgs {
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    json: boolean;
+    verbose?: boolean;
+}
+export interface HarnessInstallOptions {
+    workspace?: string;
+    json: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+}
+export interface HarnessInstallResult {
+    harness: string;
+    dryRun?: boolean;
+    warning?: string;
+    summary?: string;
+    command?: string;
+    output?: string;
+    location?: string;
+}
+export interface HarnessAdapter {
+    /** Harness identifier (e.g. "claude-code") */
+    readonly name: string;
+    /** Does this harness appear to be active? (env var detection) */
+    isActive(): boolean;
+    /** Resolve session ID from CLI args / env vars / env file */
+    resolveSessionId(parsed: {
+        sessionId?: string;
+    }): string | undefined;
+    /** Resolve state directory from args / env */
+    resolveStateDir(args: {
+        stateDir?: string;
+        pluginRoot?: string;
+    }): string | undefined;
+    /** Resolve plugin root from args / env */
+    resolvePluginRoot(args: {
+        pluginRoot?: string;
+    }): string | undefined;
+    /**
+     * Whether this adapter auto-resolves session IDs from environment variables
+     * or other ambient sources.  When true, explicitly passing `--session-id`
+     * is rejected as a conflict.  Defaults to `false` when not implemented.
+     */
+    autoResolvesSessionId?(): boolean;
+    /** Guidance shown when a harness-specific session ID is required but missing. */
+    getMissingSessionIdHint?(): string;
+    /** Whether this harness truthfully supports a given SDK hook entrypoint. */
+    supportsHookType?(hookType: string): boolean;
+    /** Message shown when a hook type is requested but unsupported by the harness. */
+    getUnsupportedHookMessage?(hookType: string): string;
+    /** Bind a run to the caller's session (run:create flow) */
+    bindSession(opts: SessionBindOptions): Promise<SessionBindResult>;
+    /** Handle the stop hook (decision: approve/block) */
+    handleStopHook(args: HookHandlerArgs): Promise<number>;
+    /** Handle the session-start hook (env file + state file setup) */
+    handleSessionStartHook(args: HookHandlerArgs): Promise<number>;
+    /** Find hook dispatcher path (for shell hook execution) */
+    findHookDispatcherPath(startCwd: string): string | null;
+    /** Check whether the harness CLI binary is installed and reachable. */
+    isCliInstalled?(): Promise<boolean>;
+    /** Return CLI metadata (command name, version, resolved path). */
+    getCliInfo?(): Promise<{
+        command: string;
+        version?: string;
+        path?: string;
+    }>;
+    /** List capabilities supported by this harness adapter. */
+    getCapabilities?(): HarnessCapability[];
+    /** Install the harness CLI itself. */
+    installHarness?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /** Install or materialize the Babysitter plugin/extension integration for this harness. */
+    installPlugin?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /**
+     * Return a PromptContext pre-configured for this harness.
+     * Centralizes harness-specific prompt configuration in the adapter itself.
+     */
+    getPromptContext?(opts?: {
+        interactive?: boolean | undefined;
+    }): PromptContext;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/harness/types.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessCapability = void 0;
+// ---------------------------------------------------------------------------
+// Harness capability enum
+// ---------------------------------------------------------------------------
+/** Capabilities that a harness adapter may support. */
+var HarnessCapability;
+(function (HarnessCapability) {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    HarnessCapability["Programmatic"] = "programmatic";
+    /** Harness can bind a babysitter run to a host session. */
+    HarnessCapability["SessionBinding"] = "session-binding";
+    /** Harness implements the stop-hook lifecycle event. */
+    HarnessCapability["StopHook"] = "stop-hook";
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    HarnessCapability["Mcp"] = "mcp";
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HarnessCapability["HeadlessPrompt"] = "headless-prompt";
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    HarnessCapability["ConcurrentEffects"] = "concurrent-effects";
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    HarnessCapability["BackgroundEffects"] = "background-effects";
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    HarnessCapability["MultiHarnessDispatch"] = "multi-harness-dispatch";
+})(HarnessCapability || (exports.HarnessCapability = HarnessCapability = {}));

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./cli/main";
+export * from "./harness";
+export * from "./runtime";
+export * from "./api";
+export * from "./daemon";
+export * from "./interaction";
+export * as anycli from "./anycli";
+export * as cost from "./cost";
+export * as governance from "./governance";
+export * from "./observability";
+export * as session from "./session";
+export * as storage from "./storage";
+export * as tasks from "./tasks";
+//# sourceMappingURL=index.d.ts.map