@a5c-ai/genty-platform 5.1.1-staging.583e3d9a6ed7

package/dist/harness/internal/createRun/utils.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Shared utilities, types, constants, and logging helpers for the
+ * create-run command handler phases.
+ */
+import { type EffectAction, type IterationResult } from "@a5c-ai/babysitter-sdk";
+import type { HarnessDiscoveryResult, SessionBindResult } from "../../types";
+import type { AskUserQuestionUiContext, AskUserQuestionResponse } from "../../../interaction";
+export type OutputMode = "cli" | "json" | "tui" | "adapters-events";
+export interface HarnessCreateRunArgs {
+    invocationCommand?: string;
+    prompt?: string;
+    harness?: string;
+    processPath?: string;
+    workspace?: string;
+    model?: string;
+    maxIterations?: number;
+    runsDir?: string;
+    json: boolean;
+    verbose: boolean;
+    interactive?: boolean;
+    existingRunId?: string;
+    existingRunDir?: string;
+    existingSessionBound?: SessionBindResult;
+    planOnly?: boolean;
+    outputMode?: OutputMode;
+}
+/** @deprecated Use HarnessCreateRunArgs instead */
+export type SessionCreateArgs = HarnessCreateRunArgs;
+export interface PlanProcessProgress {
+    phase: "1";
+    status: "started" | "skipped" | "completed" | "failed" | "interview" | "intent" | "planning";
+    harness?: string;
+    processPath?: string;
+    error?: string;
+    answer?: string;
+}
+export interface OrchestrationProgress {
+    phase: "2";
+    status: "started" | "resuming" | "skipped-plan-only" | "run-created" | "bound" | "iteration" | "iteration-start" | "effect-start" | "effect-group-start" | "iteration-summary" | "effect" | "effect-group-summary" | "completed" | "failed" | "process-error-recovery";
+    runId?: string;
+    runDir?: string;
+    harness?: string;
+    sessionId?: string;
+    iteration?: number;
+    runStatus?: string;
+    pendingEffects?: number;
+    effectId?: string;
+    effectKind?: string;
+    effectTitle?: string;
+    effectHarness?: string;
+    effectStatus?: string;
+    error?: string;
+    output?: string;
+    processPath?: string;
+    attempt?: number;
+    maxAttempts?: number;
+    elapsedMs?: number;
+    effectsResolved?: number;
+    parallelGroupId?: string;
+    maxConcurrency?: number;
+    tokenEstimate?: number;
+}
+export type ProgressPayload = PlanProcessProgress | OrchestrationProgress;
+export interface ToolResultShape {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details?: unknown;
+}
+export interface ProcessDefinitionReport {
+    processPath: string;
+    summary?: string;
+    runId?: string;
+    runDir?: string;
+    sessionBound?: SessionBindResult;
+    conversationSummary?: string;
+}
+export interface OrchestrationFinishReport {
+    summary?: string;
+}
+export type ResolveEffectResult = {
+    status: "ok" | "error";
+    value?: unknown;
+    error?: unknown;
+    stdout?: string;
+    stderr?: string;
+};
+export interface OrchestrationState {
+    runId?: string;
+    runDir?: string;
+    sessionBound?: SessionBindResult;
+    iteration: number;
+    lastIterationResult?: IterationResult;
+    pendingActions: Map<string, EffectAction>;
+    pendingEffectResults: Map<string, ResolveEffectResult>;
+    lastAskUserQuestionResponse?: AskUserQuestionResponse;
+    finished?: OrchestrationFinishReport;
+}
+export interface ExternalWorkspaceAssessment {
+    kind: "empty" | "non-empty";
+    entries: string[];
+}
+export interface AskUserQuestionToolContext {
+    hasUI?: boolean;
+    ui?: AskUserQuestionUiContext;
+}
+export interface DelegationConfig {
+    model?: string;
+    timeout?: number;
+    toolsMode?: "default" | "coding" | "readonly";
+    thinkingLevel?: "none" | "low" | "medium" | "high";
+    bashSandbox?: "auto" | "secure" | "local";
+    skills?: string[];
+    subagentName?: string;
+}
+export interface EffectRetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    backoffMultiplier: number;
+    maxDelayMs: number;
+    nonRetryableKinds: string[];
+}
+export declare const DEFAULT_EFFECT_RETRY_CONFIG: EffectRetryConfig;
+export declare const ASK_OPTION_SCHEMA: import("@sinclair/typebox").TObject<{
+    label: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const ASK_QUESTION_SCHEMA: import("@sinclair/typebox").TObject<{
+    question: import("@sinclair/typebox").TString;
+    header: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    options: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        label: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+    multiSelect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    allowOther: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    required: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    recommended: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare const ASK_USER_QUESTION_SCHEMA: import("@sinclair/typebox").TObject<{
+    questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        question: import("@sinclair/typebox").TString;
+        header: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        options: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            label: import("@sinclair/typebox").TString;
+            description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>>;
+        multiSelect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        allowOther: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        required: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        recommended: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function resolveTaskHarness(action: EffectAction, defaultHarness: string, discovered: HarnessDiscoveryResult[]): string;
+/**
+ * @deprecated Prefer isInternalHarness — isPiHarness is kept for backward compat.
+ */
+export declare function isPiHarness(harnessName: string): boolean;
+export declare function isInternalHarness(harnessName: string): boolean;
+export declare function usesExternalHarness(harnessName: string): boolean;
+export declare function shouldUseExternalHarness(harnessName: string): boolean;
+export declare function shellQuoteArg(value: string): string;
+export { resolveOutputMode, isAmuxEventsMode, DIM, RESET, BOLD, CYAN, GREEN, YELLOW, RED, MAGENTA, VERBOSE_LOG_LIMIT, PROCESS_LIBRARY_READ_MAX_CHARS, PROCESS_LIBRARY_SEARCH_DEFAULT_LIMIT, truncateForVerboseLog, stringifyForVerboseLog, writeVerboseLine, writeVerboseBlock, emitProgress, emitAmuxEvent, formatElapsed, createStreamingProgressCallbacks, loadSessionCompressionConfig, compressInternalHarnessPrompt, buildPromptContext, selectHarness, } from "./output";
+export { DEFAULT_INTERACTIVE_ASK_TIMEOUT_MS, createReadlineInterface, askLine, readInteractivePrompt, formatToolResult, isApprovalAskRequest, askUserQuestionViaTool, } from "./askUserQuestion";
+export { TRANSIENT_PI_PROMPT_RETRY_DELAYS_MS, PARENT_PROMPT_TIMEOUT_MS, DEFAULT_PROMPT_TIMEOUT_MS, WORKER_TIMEOUT_MS, PI_PARENT_PROMPT_TIMEOUT_MS, PI_DEFAULT_PROMPT_TIMEOUT_MS, PI_WORKER_TIMEOUT_MS, readBooleanMetadata, readBashSandboxMetadata, readStringMetadata, isProcessModuleLoadFailure, isRetryablePiPromptFailure, isIgnorablePiPromptFailure, promptPiWithRetry, buildPiWorkerSessionOptions, resolveAgentCoreBackendForHarness, } from "./pi";
+export type { CompressionConfig } from "@a5c-ai/babysitter-sdk";
+export type { HarnessDiscoveryResult, AgentCoreSessionEvent, AgentCorePromptResult, AgentCoreSessionOptions, SessionBindResult, } from "../../types";
+export type { AskUserQuestionUiContext, AskUserQuestionRequest, AskUserQuestionResponse, } from "../../../interaction";
+export type { EffectAction, IterationResult } from "@a5c-ai/babysitter-sdk";
+export type { HarnessPromptContext } from "./prompts";
+/** @deprecated Use HarnessPromptContext instead */
+export type { HarnessPromptContext as SessionCreatePromptContext } from "./prompts";
+export { createReadlineAskUserQuestionUiContext, createApprovalAskUserQuestion, createAskUserQuestionResponse, } from "../../../interaction";
+export { createAgentCoreSession } from "@a5c-ai/genty-core";
+export type { AgentCoreSessionHandle } from "@a5c-ai/genty-core";
+export { discoverHarnesses } from "@a5c-ai/babysitter-sdk";
+export { BabysitterRuntimeError, ErrorCategory } from "@a5c-ai/babysitter-sdk";
+export { Type } from "@sinclair/typebox";
+//# sourceMappingURL=utils.d.ts.map

package/dist/harness/internal/createRun/utils.d.ts.map

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

package/dist/harness/internal/createRun/utils.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Shared utilities, types, constants, and logging helpers for the
+ * create-run command handler phases.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptPiWithRetry = exports.isIgnorablePiPromptFailure = exports.isRetryablePiPromptFailure = exports.isProcessModuleLoadFailure = exports.readStringMetadata = exports.readBashSandboxMetadata = exports.readBooleanMetadata = exports.PI_WORKER_TIMEOUT_MS = exports.PI_DEFAULT_PROMPT_TIMEOUT_MS = exports.PI_PARENT_PROMPT_TIMEOUT_MS = exports.WORKER_TIMEOUT_MS = exports.DEFAULT_PROMPT_TIMEOUT_MS = exports.PARENT_PROMPT_TIMEOUT_MS = exports.TRANSIENT_PI_PROMPT_RETRY_DELAYS_MS = exports.askUserQuestionViaTool = exports.isApprovalAskRequest = exports.formatToolResult = exports.readInteractivePrompt = exports.askLine = exports.createReadlineInterface = exports.DEFAULT_INTERACTIVE_ASK_TIMEOUT_MS = exports.selectHarness = exports.buildPromptContext = exports.compressInternalHarnessPrompt = exports.loadSessionCompressionConfig = exports.createStreamingProgressCallbacks = exports.formatElapsed = exports.emitAmuxEvent = exports.emitProgress = exports.writeVerboseBlock = exports.writeVerboseLine = exports.stringifyForVerboseLog = exports.truncateForVerboseLog = exports.PROCESS_LIBRARY_SEARCH_DEFAULT_LIMIT = exports.PROCESS_LIBRARY_READ_MAX_CHARS = exports.VERBOSE_LOG_LIMIT = exports.MAGENTA = exports.RED = exports.YELLOW = exports.GREEN = exports.CYAN = exports.BOLD = exports.RESET = exports.DIM = exports.isAmuxEventsMode = exports.resolveOutputMode = exports.ASK_USER_QUESTION_SCHEMA = exports.ASK_QUESTION_SCHEMA = exports.ASK_OPTION_SCHEMA = exports.DEFAULT_EFFECT_RETRY_CONFIG = void 0;
+exports.Type = exports.ErrorCategory = exports.BabysitterRuntimeError = exports.discoverHarnesses = exports.createAgentCoreSession = exports.createAskUserQuestionResponse = exports.createApprovalAskUserQuestion = exports.createReadlineAskUserQuestionUiContext = exports.resolveAgentCoreBackendForHarness = exports.buildPiWorkerSessionOptions = void 0;
+exports.resolveTaskHarness = resolveTaskHarness;
+exports.isPiHarness = isPiHarness;
+exports.isInternalHarness = isInternalHarness;
+exports.usesExternalHarness = usesExternalHarness;
+exports.shouldUseExternalHarness = shouldUseExternalHarness;
+exports.shellQuoteArg = shellQuoteArg;
+const typebox_1 = require("@sinclair/typebox");
+const builtInHarness_1 = require("../../builtInHarness");
+const capabilityRouter_1 = require("../../capabilityRouter");
+const fallbackChains_1 = require("../../fallbackChains");
+const modelSelection_1 = require("../../modelSelection");
+const selectionPolicies_1 = require("../../selectionPolicies");
+exports.DEFAULT_EFFECT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1_000,
+    backoffMultiplier: 4,
+    maxDelayMs: 60_000,
+    nonRetryableKinds: ["breakpoint", "sleep"],
+};
+exports.ASK_OPTION_SCHEMA = typebox_1.Type.Object({
+    label: typebox_1.Type.String(),
+    description: typebox_1.Type.Optional(typebox_1.Type.String()),
+    preview: typebox_1.Type.Optional(typebox_1.Type.String()),
+});
+exports.ASK_QUESTION_SCHEMA = typebox_1.Type.Object({
+    question: typebox_1.Type.String(),
+    header: typebox_1.Type.Optional(typebox_1.Type.String()),
+    options: typebox_1.Type.Optional(typebox_1.Type.Array(exports.ASK_OPTION_SCHEMA)),
+    multiSelect: typebox_1.Type.Optional(typebox_1.Type.Boolean()),
+    allowOther: typebox_1.Type.Optional(typebox_1.Type.Boolean()),
+    required: typebox_1.Type.Optional(typebox_1.Type.Boolean()),
+    recommended: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Index of the recommended option (0-based). Auto-selected in non-interactive mode or on timeout." })),
+});
+exports.ASK_USER_QUESTION_SCHEMA = typebox_1.Type.Object({
+    questions: typebox_1.Type.Array(exports.ASK_QUESTION_SCHEMA, { minItems: 1, maxItems: 4 }),
+    timeout: typebox_1.Type.Optional(typebox_1.Type.Number({ description: "Timeout in ms. On expiry, the recommended option (or first) is auto-selected." })),
+});
+function resolveTaskHarness(action, defaultHarness, discovered) {
+    if (typeof action.schedulerHints?.preferredHarness === "string") {
+        const requestedHarness = (0, builtInHarness_1.normalizeBuiltInHarnessName)(action.schedulerHints.preferredHarness);
+        const match = discovered.find((h) => h.name === requestedHarness && h.installed);
+        if (match)
+            return match.name;
+    }
+    const meta = action.taskDef?.metadata;
+    const execution = action.taskDef?.execution;
+    if (typeof execution?.harness === "string") {
+        const requestedHarness = (0, builtInHarness_1.normalizeBuiltInHarnessName)(execution.harness);
+        const match = discovered.find((h) => h.name === requestedHarness && h.installed);
+        if (match)
+            return match.name;
+    }
+    const policyHarness = resolvePolicySelectedHarness(action, discovered);
+    if (policyHarness) {
+        return policyHarness;
+    }
+    if (typeof meta?.harness === "string") {
+        const requestedHarness = (0, builtInHarness_1.normalizeBuiltInHarnessName)(meta.harness);
+        const match = discovered.find((h) => h.name === requestedHarness && h.installed);
+        if (match)
+            return match.name;
+    }
+    return (0, builtInHarness_1.normalizeBuiltInHarnessName)(defaultHarness);
+}
+function resolvePolicySelectedHarness(action, discovered) {
+    const taskDef = action.taskDef;
+    const execution = taskDef?.execution;
+    const meta = taskDef?.metadata;
+    const candidates = toHarnessCandidates(discovered);
+    if (candidates.length === 0) {
+        return undefined;
+    }
+    const policyName = coercePolicyName(execution?.policy ?? meta?.selectionPolicy);
+    if (policyName) {
+        const result = (0, selectionPolicies_1.evaluatePolicy)(policyName, candidates, (0, capabilityRouter_1.buildTaskRequirements)(taskDef ?? {}), { preferredHarness: stringValue(execution?.harness ?? meta?.preferredHarness) });
+        if (result.selected) {
+            return result.selected.name;
+        }
+    }
+    if (typeof execution?.model === "string") {
+        const result = (0, modelSelection_1.resolveModelForTask)(taskDef ?? {}, candidates);
+        if (result.selectedHarness) {
+            return result.selectedHarness;
+        }
+    }
+    const fallbackChain = arrayOfStrings(execution?.fallbackChain ?? meta?.fallbackChain);
+    if (fallbackChain.length > 0) {
+        const failedHarnesses = arrayOfStrings(meta?.failedHarnesses);
+        const result = (0, fallbackChains_1.resolveFallbackHarness)({ harnesses: fallbackChain.map(builtInHarness_1.normalizeBuiltInHarnessName), maxRetries: fallbackChain.length - 1 }, failedHarnesses.map(builtInHarness_1.normalizeBuiltInHarnessName));
+        if (result.harness && discovered.some((h) => h.name === result.harness && h.installed)) {
+            return result.harness;
+        }
+    }
+    return undefined;
+}
+function toHarnessCandidates(discovered) {
+    return discovered
+        .filter((harness) => harness.installed)
+        .map((harness) => {
+        const extra = harness;
+        return {
+            name: harness.name,
+            capabilities: harness.capabilities,
+            supportedModels: extra.supportedModels ?? [],
+            availableTools: extra.availableTools ?? [],
+            permissions: extra.permissions ?? [],
+        };
+    });
+}
+function coercePolicyName(value) {
+    return value === "cost-optimized" ||
+        value === "latency-optimized" ||
+        value === "capability-first" ||
+        value === "user-preferred"
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function arrayOfStrings(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string")
+        : [];
+}
+/**
+ * @deprecated Prefer isInternalHarness — isPiHarness is kept for backward compat.
+ */
+function isPiHarness(harnessName) {
+    return isInternalHarness(harnessName);
+}
+function isInternalHarness(harnessName) {
+    return (0, builtInHarness_1.isBuiltInHarnessName)(harnessName);
+}
+function usesExternalHarness(harnessName) {
+    return !isPiHarness(harnessName);
+}
+function shouldUseExternalHarness(harnessName) {
+    if (!usesExternalHarness(harnessName)) {
+        return false;
+    }
+    return true;
+}
+function shellQuoteArg(value) {
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+var output_1 = require("./output");
+Object.defineProperty(exports, "resolveOutputMode", { enumerable: true, get: function () { return output_1.resolveOutputMode; } });
+Object.defineProperty(exports, "isAmuxEventsMode", { enumerable: true, get: function () { return output_1.isAmuxEventsMode; } });
+Object.defineProperty(exports, "DIM", { enumerable: true, get: function () { return output_1.DIM; } });
+Object.defineProperty(exports, "RESET", { enumerable: true, get: function () { return output_1.RESET; } });
+Object.defineProperty(exports, "BOLD", { enumerable: true, get: function () { return output_1.BOLD; } });
+Object.defineProperty(exports, "CYAN", { enumerable: true, get: function () { return output_1.CYAN; } });
+Object.defineProperty(exports, "GREEN", { enumerable: true, get: function () { return output_1.GREEN; } });
+Object.defineProperty(exports, "YELLOW", { enumerable: true, get: function () { return output_1.YELLOW; } });
+Object.defineProperty(exports, "RED", { enumerable: true, get: function () { return output_1.RED; } });
+Object.defineProperty(exports, "MAGENTA", { enumerable: true, get: function () { return output_1.MAGENTA; } });
+Object.defineProperty(exports, "VERBOSE_LOG_LIMIT", { enumerable: true, get: function () { return output_1.VERBOSE_LOG_LIMIT; } });
+Object.defineProperty(exports, "PROCESS_LIBRARY_READ_MAX_CHARS", { enumerable: true, get: function () { return output_1.PROCESS_LIBRARY_READ_MAX_CHARS; } });
+Object.defineProperty(exports, "PROCESS_LIBRARY_SEARCH_DEFAULT_LIMIT", { enumerable: true, get: function () { return output_1.PROCESS_LIBRARY_SEARCH_DEFAULT_LIMIT; } });
+Object.defineProperty(exports, "truncateForVerboseLog", { enumerable: true, get: function () { return output_1.truncateForVerboseLog; } });
+Object.defineProperty(exports, "stringifyForVerboseLog", { enumerable: true, get: function () { return output_1.stringifyForVerboseLog; } });
+Object.defineProperty(exports, "writeVerboseLine", { enumerable: true, get: function () { return output_1.writeVerboseLine; } });
+Object.defineProperty(exports, "writeVerboseBlock", { enumerable: true, get: function () { return output_1.writeVerboseBlock; } });
+Object.defineProperty(exports, "emitProgress", { enumerable: true, get: function () { return output_1.emitProgress; } });
+Object.defineProperty(exports, "emitAmuxEvent", { enumerable: true, get: function () { return output_1.emitAmuxEvent; } });
+Object.defineProperty(exports, "formatElapsed", { enumerable: true, get: function () { return output_1.formatElapsed; } });
+Object.defineProperty(exports, "createStreamingProgressCallbacks", { enumerable: true, get: function () { return output_1.createStreamingProgressCallbacks; } });
+Object.defineProperty(exports, "loadSessionCompressionConfig", { enumerable: true, get: function () { return output_1.loadSessionCompressionConfig; } });
+Object.defineProperty(exports, "compressInternalHarnessPrompt", { enumerable: true, get: function () { return output_1.compressInternalHarnessPrompt; } });
+Object.defineProperty(exports, "buildPromptContext", { enumerable: true, get: function () { return output_1.buildPromptContext; } });
+Object.defineProperty(exports, "selectHarness", { enumerable: true, get: function () { return output_1.selectHarness; } });
+var askUserQuestion_1 = require("./askUserQuestion");
+Object.defineProperty(exports, "DEFAULT_INTERACTIVE_ASK_TIMEOUT_MS", { enumerable: true, get: function () { return askUserQuestion_1.DEFAULT_INTERACTIVE_ASK_TIMEOUT_MS; } });
+Object.defineProperty(exports, "createReadlineInterface", { enumerable: true, get: function () { return askUserQuestion_1.createReadlineInterface; } });
+Object.defineProperty(exports, "askLine", { enumerable: true, get: function () { return askUserQuestion_1.askLine; } });
+Object.defineProperty(exports, "readInteractivePrompt", { enumerable: true, get: function () { return askUserQuestion_1.readInteractivePrompt; } });
+Object.defineProperty(exports, "formatToolResult", { enumerable: true, get: function () { return askUserQuestion_1.formatToolResult; } });
+Object.defineProperty(exports, "isApprovalAskRequest", { enumerable: true, get: function () { return askUserQuestion_1.isApprovalAskRequest; } });
+Object.defineProperty(exports, "askUserQuestionViaTool", { enumerable: true, get: function () { return askUserQuestion_1.askUserQuestionViaTool; } });
+var pi_1 = require("./pi");
+Object.defineProperty(exports, "TRANSIENT_PI_PROMPT_RETRY_DELAYS_MS", { enumerable: true, get: function () { return pi_1.TRANSIENT_PI_PROMPT_RETRY_DELAYS_MS; } });
+Object.defineProperty(exports, "PARENT_PROMPT_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.PARENT_PROMPT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "DEFAULT_PROMPT_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.DEFAULT_PROMPT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "WORKER_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.WORKER_TIMEOUT_MS; } });
+Object.defineProperty(exports, "PI_PARENT_PROMPT_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.PI_PARENT_PROMPT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "PI_DEFAULT_PROMPT_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.PI_DEFAULT_PROMPT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "PI_WORKER_TIMEOUT_MS", { enumerable: true, get: function () { return pi_1.PI_WORKER_TIMEOUT_MS; } });
+Object.defineProperty(exports, "readBooleanMetadata", { enumerable: true, get: function () { return pi_1.readBooleanMetadata; } });
+Object.defineProperty(exports, "readBashSandboxMetadata", { enumerable: true, get: function () { return pi_1.readBashSandboxMetadata; } });
+Object.defineProperty(exports, "readStringMetadata", { enumerable: true, get: function () { return pi_1.readStringMetadata; } });
+Object.defineProperty(exports, "isProcessModuleLoadFailure", { enumerable: true, get: function () { return pi_1.isProcessModuleLoadFailure; } });
+Object.defineProperty(exports, "isRetryablePiPromptFailure", { enumerable: true, get: function () { return pi_1.isRetryablePiPromptFailure; } });
+Object.defineProperty(exports, "isIgnorablePiPromptFailure", { enumerable: true, get: function () { return pi_1.isIgnorablePiPromptFailure; } });
+Object.defineProperty(exports, "promptPiWithRetry", { enumerable: true, get: function () { return pi_1.promptPiWithRetry; } });
+Object.defineProperty(exports, "buildPiWorkerSessionOptions", { enumerable: true, get: function () { return pi_1.buildPiWorkerSessionOptions; } });
+Object.defineProperty(exports, "resolveAgentCoreBackendForHarness", { enumerable: true, get: function () { return pi_1.resolveAgentCoreBackendForHarness; } });
+var interaction_1 = require("../../../interaction");
+Object.defineProperty(exports, "createReadlineAskUserQuestionUiContext", { enumerable: true, get: function () { return interaction_1.createReadlineAskUserQuestionUiContext; } });
+Object.defineProperty(exports, "createApprovalAskUserQuestion", { enumerable: true, get: function () { return interaction_1.createApprovalAskUserQuestion; } });
+Object.defineProperty(exports, "createAskUserQuestionResponse", { enumerable: true, get: function () { return interaction_1.createAskUserQuestionResponse; } });
+var genty_core_1 = require("@a5c-ai/genty-core");
+Object.defineProperty(exports, "createAgentCoreSession", { enumerable: true, get: function () { return genty_core_1.createAgentCoreSession; } });
+var babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+Object.defineProperty(exports, "discoverHarnesses", { enumerable: true, get: function () { return babysitter_sdk_1.discoverHarnesses; } });
+var babysitter_sdk_2 = require("@a5c-ai/babysitter-sdk");
+Object.defineProperty(exports, "BabysitterRuntimeError", { enumerable: true, get: function () { return babysitter_sdk_2.BabysitterRuntimeError; } });
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return babysitter_sdk_2.ErrorCategory; } });
+var typebox_2 = require("@sinclair/typebox");
+Object.defineProperty(exports, "Type", { enumerable: true, get: function () { return typebox_2.Type; } });

package/dist/harness/internal.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Internal harness adapter.
+ *
+ * The 'agent-core' harness represents the SDK's built-in programmatic execution
+ * engine (agent-core). It is always available, requires no external CLI, and is
+ * the default harness for `agent-platform create-run`.
+ *
+ * Unlike the 'pi' harness (which invokes the pi CLI as a child process), the
+ * agent-core harness calls agent-core.prompt() directly in-process.
+ */
+import type { HarnessAdapter } from "./types";
+export declare function createInternalAdapter(): HarnessAdapter;
+//# sourceMappingURL=internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/harness/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EACV,cAAc,EAOf,MAAM,SAAS,CAAC;AA2BjB,wBAAgB,qBAAqB,IAAI,cAAc,CAmGtD"}

package/dist/harness/internal.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Internal harness adapter.
+ *
+ * The 'agent-core' harness represents the SDK's built-in programmatic execution
+ * engine (agent-core). It is always available, requires no external CLI, and is
+ * the default harness for `agent-platform create-run`.
+ *
+ * Unlike the 'pi' harness (which invokes the pi CLI as a child process), the
+ * agent-core harness calls agent-core.prompt() directly in-process.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInternalAdapter = createInternalAdapter;
+const path = __importStar(require("node:path"));
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const types_1 = require("./types");
+function resolveInternalPluginRoot(args = {}) {
+    const root = args.pluginRoot || process.env.OMP_PLUGIN_ROOT || process.env.PI_PLUGIN_ROOT;
+    return root ? path.resolve(root) : undefined;
+}
+function resolveInternalStateDir(args) {
+    return (0, babysitter_sdk_1.normalizeSessionStateDir)(args.stateDir ?? process.env.BABYSITTER_STATE_DIR);
+}
+function resolveInternalSessionId(parsed) {
+    if (parsed.sessionId)
+        return parsed.sessionId;
+    if (process.env.OMP_SESSION_ID)
+        return process.env.OMP_SESSION_ID;
+    if (process.env.PI_SESSION_ID)
+        return process.env.PI_SESSION_ID;
+    return undefined;
+}
+function createInternalAdapter() {
+    const claude = (0, babysitter_sdk_1.createClaudeCodeAdapter)();
+    return {
+        name: "agent-core",
+        // The built-in agent-core harness is never auto-detected via env vars.
+        // It is explicitly selected as the default or via --harness agent-core.
+        isActive() {
+            return false;
+        },
+        autoResolvesSessionId() {
+            return true;
+        },
+        resolveSessionId(parsed) {
+            return resolveInternalSessionId(parsed);
+        },
+        resolveStateDir(args) {
+            return resolveInternalStateDir(args);
+        },
+        resolvePluginRoot(args) {
+            return resolveInternalPluginRoot(args);
+        },
+        getCapabilities() {
+            return [
+                types_1.HarnessCapability.Programmatic,
+                types_1.HarnessCapability.SessionBinding,
+                types_1.HarnessCapability.StopHook,
+                types_1.HarnessCapability.HeadlessPrompt,
+                types_1.HarnessCapability.ConcurrentEffects,
+                types_1.HarnessCapability.BackgroundEffects,
+                types_1.HarnessCapability.MultiHarnessDispatch,
+            ];
+        },
+        async bindSession(opts) {
+            const stateDir = resolveInternalStateDir({
+                stateDir: opts.stateDir,
+                pluginRoot: opts.pluginRoot,
+            });
+            const result = await claude.bindSession({
+                ...opts,
+                stateDir,
+            });
+            return { ...result, harness: "agent-core" };
+        },
+        handleStopHook(args) {
+            const pluginRoot = resolveInternalPluginRoot(args);
+            const stateDir = resolveInternalStateDir({
+                stateDir: args.stateDir,
+                pluginRoot,
+            });
+            return claude.handleStopHook({
+                ...args,
+                pluginRoot,
+                stateDir,
+            });
+        },
+        handleSessionStartHook(args) {
+            const pluginRoot = resolveInternalPluginRoot(args);
+            const stateDir = resolveInternalStateDir({
+                stateDir: args.stateDir,
+                pluginRoot,
+            });
+            return claude.handleSessionStartHook({
+                ...args,
+                pluginRoot,
+                stateDir,
+            });
+        },
+        findHookDispatcherPath(_startCwd) {
+            return null;
+        },
+        // Agent-core has no CLI to install — it IS the built-in runtime.
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async installHarness(options) {
+            return {
+                harness: "agent-core",
+                summary: "The agent-core harness is built into the babysitter SDK and requires no separate installation.",
+                dryRun: options.dryRun,
+            };
+        },
+        getPromptContext(opts) {
+            return (0, babysitter_sdk_1.createInternalContext)(opts);
+        },
+    };
+}

package/dist/harness/invoker/launch.d.ts

@@ -0,0 +1,20 @@
+export interface HarnessCliSpec {
+    cli: string;
+    workspaceFlag?: string;
+    supportsModel: boolean;
+    promptStyle?: "positional" | "flag";
+    baseArgs?: string[];
+}
+export interface LaunchSpec {
+    command: string;
+    args: string[];
+    shell: boolean;
+}
+/**
+ * Build a LaunchSpec for spawning a harness CLI.
+ *
+ * Only Pi uses direct CLI invocation. External harnesses are routed
+ * through adapters and never reach this function.
+ */
+export declare function buildLaunchSpec(_name: string, spec: HarnessCliSpec, cliPath: string | undefined, args: string[]): LaunchSpec;
+//# sourceMappingURL=launch.d.ts.map

package/dist/harness/invoker/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/harness/invoker/launch.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EAAE,GACb,UAAU,CAcZ"}

package/dist/harness/invoker/launch.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLaunchSpec = buildLaunchSpec;
+/**
+ * Build a LaunchSpec for spawning a harness CLI.
+ *
+ * Only Pi uses direct CLI invocation. External harnesses are routed
+ * through adapters and never reach this function.
+ */
+function buildLaunchSpec(_name, spec, cliPath, args) {
+    if (process.platform === "win32") {
+        return {
+            command: spec.cli,
+            args,
+            shell: true,
+        };
+    }
+    return {
+        command: cliPath ?? spec.cli,
+        args,
+        shell: false,
+    };
+}

package/dist/harness/invoker/processControl.d.ts

@@ -0,0 +1,11 @@
+interface ChildHandle {
+    pid?: number;
+    kill: (signal?: NodeJS.Signals | number) => boolean;
+}
+export declare function trackChild(child: ChildHandle): void;
+export declare function untrackChild(pid: number | undefined): void;
+export declare function cancelRunningProcess(pid: number, options?: {
+    gracePeriodMs?: number;
+}): Promise<boolean>;
+export {};
+//# sourceMappingURL=processControl.d.ts.map

package/dist/harness/invoker/processControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processControl.d.ts","sourceRoot":"","sources":["../../../src/harness/invoker/processControl.ts"],"names":[],"mappings":"AAAA,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC;CACrD;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAInD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI1D;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,OAAO,CAAC,CAkClB"}