@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/piWrapper.js

@@ -0,0 +1,406 @@
+"use strict";
+/**
+ * Pi programmatic API wrapper.
+ *
+ * Wraps `@earendil-works/pi-coding-agent`'s `createAgentSession()` to expose
+ * a persistent `AgentSession` through a babysitter-friendly interface.
+ *
+ * The session is lazily initialized on first use and reused across prompts.
+ * Events are forwarded through the `subscribe()` method.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCoreSessionHandle = void 0;
+exports.createAgentCoreSession = createAgentCoreSession;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const piSecureSandbox_1 = require("./piSecureSandbox");
+const compaction_1 = require("./piWrapper/compaction");
+const instructionPrompts_1 = require("./piWrapper/instructionPrompts");
+const moduleSupport_1 = require("./piWrapper/moduleSupport");
+const DEFAULT_TIMEOUT_MS = 900_000;
+const DEFAULT_INIT_FAILURE_BACKOFF_MS = 1_000;
+const DEFAULT_BASH_SANDBOX_MODE = "local";
+const AGENT_END_PROMPT_SETTLE_GRACE_MS = 250;
+const PI_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+const DEFAULT_PI_AGENT_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".pi", "agent");
+const CODING_TOOL_NAMES = ["read", "bash", "edit", "write"];
+const READONLY_TOOL_NAMES = ["read", "grep", "find", "ls"];
+function resolvePiAgentDir(agentDir) {
+    const configured = agentDir?.trim() || process.env[PI_AGENT_DIR_ENV]?.trim();
+    if (!configured) {
+        return DEFAULT_PI_AGENT_DIR;
+    }
+    if (configured === "~") {
+        return (0, node_os_1.homedir)();
+    }
+    if (configured.startsWith("~/")) {
+        return (0, node_path_1.join)((0, node_os_1.homedir)(), configured.slice(2));
+    }
+    return configured;
+}
+// ---------------------------------------------------------------------------
+// AgentCoreSessionHandle
+// ---------------------------------------------------------------------------
+/**
+ * Handle for interacting with the Pi coding agent programmatically.
+ *
+ * Wraps `AgentSession` from `@earendil-works/pi-coding-agent`. The underlying
+ * session is created lazily on first `prompt()` call and reused thereafter.
+ */
+class AgentCoreSessionHandle {
+    options;
+    session = null;
+    initPromise = null;
+    initFailure = null;
+    initRetryAfterMs = 0;
+    cleanupTasks = [];
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Initialize the underlying AgentSession.
+     *
+     * Called automatically by `prompt()` if the session hasn't been created yet.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    async initialize() {
+        if (this.session)
+            return;
+        if (this.initFailure && Date.now() < this.initRetryAfterMs) {
+            throw this.initFailure;
+        }
+        if (this.initFailure) {
+            this.initFailure = null;
+            this.initRetryAfterMs = 0;
+        }
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = this.doInitialize().catch((err) => {
+            this.initPromise = null;
+            this.initFailure = err;
+            this.initRetryAfterMs = Date.now() + (this.options.initFailureBackoffMs ?? DEFAULT_INIT_FAILURE_BACKOFF_MS);
+            throw err;
+        });
+        await this.initPromise;
+    }
+    /**
+     * Send a prompt to the Pi agent and wait for completion.
+     *
+     * Initializes the session if needed, sends the prompt, waits for the
+     * `agent_end` event, and returns collected output.
+     */
+    async prompt(text, timeout) {
+        await this.initialize();
+        const session = this.requireSession();
+        const effectiveTimeout = timeout ?? this.options.timeout ?? DEFAULT_TIMEOUT_MS;
+        const start = Date.now();
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let timer;
+            let agentEndGraceTimer;
+            let agentEndResult = null;
+            let promptSettled = false;
+            const finishWithResult = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timer)
+                    clearTimeout(timer);
+                if (agentEndGraceTimer)
+                    clearTimeout(agentEndGraceTimer);
+                resolve(result);
+            };
+            const finishWithPromptError = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timer)
+                    clearTimeout(timer);
+                if (agentEndGraceTimer)
+                    clearTimeout(agentEndGraceTimer);
+                const message = err instanceof Error ? err.message : String(err);
+                resolve({
+                    output: message,
+                    exitCode: 1,
+                    duration: Date.now() - start,
+                    success: false,
+                });
+            };
+            // Set up timeout
+            if (effectiveTimeout > 0) {
+                timer = setTimeout(() => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    unsubscribe();
+                    void session.abort();
+                    reject(new babysitter_sdk_1.BabysitterRuntimeError("PiTimeoutError", `Pi prompt timed out after ${effectiveTimeout}ms`, { category: babysitter_sdk_1.ErrorCategory.External }));
+                }, effectiveTimeout);
+            }
+            // Subscribe to events to detect completion
+            const unsubscribe = session.subscribe((event) => {
+                if (settled)
+                    return;
+                if (event.type === "agent_end") {
+                    const messages = Array.isArray(event.messages)
+                        ? event.messages
+                        : undefined;
+                    unsubscribe();
+                    const assistantFailure = (0, moduleSupport_1.extractAssistantFailure)(messages);
+                    const assistantText = session.getLastAssistantText();
+                    const output = assistantText && assistantText.trim().length > 0
+                        ? assistantText
+                        : assistantFailure ?? "";
+                    agentEndResult = {
+                        output,
+                        exitCode: assistantFailure ? 1 : 0,
+                        duration: Date.now() - start,
+                        success: !assistantFailure,
+                    };
+                    if (promptSettled) {
+                        finishWithResult(agentEndResult);
+                        return;
+                    }
+                    agentEndGraceTimer = setTimeout(() => {
+                        if (agentEndResult) {
+                            finishWithResult(agentEndResult);
+                        }
+                    }, AGENT_END_PROMPT_SETTLE_GRACE_MS);
+                }
+            });
+            // Fire the prompt — errors are caught and resolved as failures
+            session.prompt(text)
+                .then(() => {
+                promptSettled = true;
+                if (agentEndResult) {
+                    finishWithResult(agentEndResult);
+                }
+            })
+                .catch((err) => {
+                promptSettled = true;
+                if (agentEndResult) {
+                    finishWithResult(agentEndResult);
+                    return;
+                }
+                unsubscribe();
+                finishWithPromptError(err);
+            });
+        });
+    }
+    /**
+     * Steer the running agent with an instruction.
+     *
+     * Steering messages are delivered immediately to the agent while it is
+     * processing a prompt.
+     */
+    async steer(text) {
+        const session = this.requireSession();
+        await session.steer(text);
+    }
+    /** Queue a follow-up message for after the current turn completes. */
+    async followUp(text) {
+        const session = this.requireSession();
+        await session.followUp(text);
+    }
+    /**
+     * Subscribe to session events.
+     *
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener) {
+        const session = this.requireSession();
+        return session.subscribe(listener);
+    }
+    /** Execute a bash command through the agent's sandbox. */
+    async executeBash(command, onChunk) {
+        await this.initialize();
+        const session = this.requireSession();
+        const result = await session.executeBash(command, onChunk);
+        return {
+            output: result.output,
+            exitCode: result.exitCode,
+            cancelled: result.cancelled,
+        };
+    }
+    /** Abort the current prompt execution. */
+    async abort() {
+        if (this.session) {
+            await this.session.abort();
+        }
+    }
+    /** Dispose of the session and release resources. */
+    dispose() {
+        if (this.session) {
+            const session = this.session;
+            if (session.isStreaming) {
+                void session.abort().catch(() => undefined);
+            }
+            session.dispose();
+            this.session = null;
+            this.initPromise = null;
+            this.initFailure = null;
+            this.initRetryAfterMs = 0;
+        }
+        while (this.cleanupTasks.length > 0) {
+            const cleanup = this.cleanupTasks.pop();
+            if (cleanup) {
+                void cleanup();
+            }
+        }
+    }
+    /** The underlying pi session ID, if initialized. */
+    get sessionId() {
+        return this.session?.sessionId;
+    }
+    /** Whether the session is currently streaming a response. */
+    get isStreaming() {
+        return this.session?.isStreaming ?? false;
+    }
+    /** Whether the session has been initialized. */
+    get isInitialized() {
+        return this.session !== null;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers
+    // ---------------------------------------------------------------------------
+    async cleanupPendingTasks() {
+        while (this.cleanupTasks.length > 0) {
+            const cleanup = this.cleanupTasks.pop();
+            if (cleanup) {
+                await cleanup();
+            }
+        }
+    }
+    async doInitialize() {
+        const mod = await (0, moduleSupport_1.loadPiModule)();
+        const azureOpenAiEnv = (0, moduleSupport_1.configureAzureOpenAiEnvDefaults)(typeof this.options.model === "string" ? this.options.model : undefined) ?? {};
+        const piEnv = Object.keys(azureOpenAiEnv).length > 0
+            ? { ...process.env, ...azureOpenAiEnv }
+            : process.env;
+        const createOpts = {};
+        const cwd = this.options.workspace ?? process.cwd();
+        const agentDir = resolvePiAgentDir(this.options.agentDir);
+        const compressionConfig = (0, compaction_1.loadCompressionConfigSafe)(cwd);
+        const compactionEnabled = this.options.enableCompaction ??
+            Boolean(compressionConfig?.enabled && compressionConfig.layers.sdkContextHook.enabled);
+        const compactionSettings = (0, compaction_1.buildCompactionSettings)(compactionEnabled);
+        createOpts.cwd = cwd;
+        createOpts.agentDir = agentDir;
+        if (piEnv !== process.env) {
+            createOpts.env = piEnv;
+        }
+        if (this.options.thinkingLevel)
+            createOpts.thinkingLevel = this.options.thinkingLevel;
+        const customTools = [...(this.options.customTools ?? [])];
+        if (this.options.ephemeral) {
+            createOpts.sessionManager = mod.SessionManager.inMemory();
+        }
+        const secureBashBackend = this.options.toolsMode === "coding" || this.options.toolsMode === "readonly"
+            ? await (0, piSecureSandbox_1.createSecureBashBackend)({
+                workspace: cwd,
+                mode: this.options.bashSandbox ?? DEFAULT_BASH_SANDBOX_MODE,
+            })
+            : null;
+        if (secureBashBackend) {
+            this.cleanupTasks.push(() => secureBashBackend.dispose());
+        }
+        if (this.options.toolsMode === "coding") {
+            createOpts.tools = [...CODING_TOOL_NAMES];
+        }
+        else if (this.options.toolsMode === "readonly") {
+            createOpts.tools = [...READONLY_TOOL_NAMES];
+        }
+        if (secureBashBackend && typeof mod.createBashToolDefinition === "function") {
+            customTools.unshift(mod.createBashToolDefinition(cwd, {
+                operations: secureBashBackend.operations,
+            }));
+        }
+        if (customTools.length > 0) {
+            createOpts.customTools = customTools;
+        }
+        const appendedSystemPrompt = [
+            ...(0, instructionPrompts_1.discoverRepoInstructionPrompts)(cwd),
+            ...(this.options.appendSystemPrompt ?? []),
+            ...(secureBashBackend ? [secureBashBackend.promptNote] : []),
+        ];
+        if (this.options.systemPrompt ||
+            appendedSystemPrompt.length > 0 ||
+            this.options.isolated ||
+            compactionEnabled) {
+            const settingsManager = mod.SettingsManager.inMemory({
+                quietStartup: true,
+                compaction: compactionSettings.compaction,
+                branchSummary: compactionSettings.branchSummary,
+            });
+            createOpts.settingsManager = settingsManager;
+            if (this.options.systemPrompt ||
+                appendedSystemPrompt.length > 0 ||
+                this.options.isolated) {
+                const resourceLoader = new mod.DefaultResourceLoader({
+                    cwd,
+                    agentDir,
+                    settingsManager,
+                    noExtensions: this.options.isolated === true,
+                    noSkills: this.options.isolated === true,
+                    noPromptTemplates: this.options.isolated === true,
+                    noThemes: this.options.isolated === true,
+                    agentsFilesOverride: this.options.isolated === true
+                        ? () => ({ agentsFiles: [] })
+                        : undefined,
+                    systemPromptOverride: this.options.systemPrompt
+                        ? () => this.options.systemPrompt
+                        : undefined,
+                    appendSystemPromptOverride: appendedSystemPrompt.length > 0
+                        ? (base) => [...base, ...appendedSystemPrompt]
+                        : undefined,
+                });
+                await resourceLoader.reload();
+                createOpts.resourceLoader = resourceLoader;
+            }
+        }
+        // Resolve model string to a model object from pi's ModelRegistry.
+        // The `createAgentSession` API expects a model object (with provider,
+        // api, baseUrl, etc.), not a plain string.  We accept formats:
+        //   "provider:modelId"  e.g. "azure-openai-responses:gpt-4.1"
+        //   "modelId"           e.g. "gpt-4.1" (searches all providers)
+        if (typeof this.options.model === "string") {
+            const resolved = await (0, moduleSupport_1.resolvePiModel)(mod, this.options.model, piEnv);
+            if (resolved) {
+                createOpts.model = resolved;
+            }
+            else {
+                await this.cleanupPendingTasks();
+                throw new babysitter_sdk_1.BabysitterRuntimeError("PiModelResolutionFailed", (0, moduleSupport_1.describePiModelResolutionFailure)(this.options.model), { category: babysitter_sdk_1.ErrorCategory.Configuration });
+            }
+        }
+        try {
+            const { session } = await mod.createAgentSession(createOpts);
+            if (this.options.uiContext && typeof session.bindExtensions === "function") {
+                await session.bindExtensions({ uiContext: this.options.uiContext });
+            }
+            this.session = session;
+        }
+        catch (error) {
+            await this.cleanupPendingTasks();
+            throw error;
+        }
+    }
+    requireSession() {
+        if (!this.session) {
+            throw new babysitter_sdk_1.BabysitterRuntimeError("PiSessionNotInitialized", "Pi session has not been initialized — call initialize() or prompt() first", { category: babysitter_sdk_1.ErrorCategory.Runtime });
+        }
+        return this.session;
+    }
+}
+exports.AgentCoreSessionHandle = AgentCoreSessionHandle;
+/**
+ * Create a new Pi session handle.
+ *
+ * The underlying `AgentSession` is created lazily on first use.
+ */
+function createAgentCoreSession(options) {
+    return new AgentCoreSessionHandle(options);
+}

package/dist/harness/planMode.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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.
+ */
+/** A single step in an execution plan. */
+export interface PlanStep {
+    /** Unique step identifier. */
+    id: string;
+    /** Human-readable title. */
+    title: string;
+    /** Description of what this step does. */
+    description: string;
+    /** Step status. */
+    status: PlanStepStatus;
+    /** Dependencies (IDs of steps that must complete first). */
+    dependsOn: string[];
+    /** Verification criteria for this step. */
+    verificationCriteria?: string;
+    /** Task ID if this step was dispatched as an effect. */
+    effectId?: string;
+    /** Timestamp of completion. */
+    completedAt?: string;
+    /** Feedback received during verification. */
+    feedback?: string;
+}
+export type PlanStepStatus = "pending" | "in_progress" | "completed" | "failed" | "skipped" | "modified";
+/** An execution plan. */
+export interface ExecutionPlan {
+    /** Plan ID. */
+    id: string;
+    /** Plan title. */
+    title: string;
+    /** Overall goal/description. */
+    description: string;
+    /** Ordered steps. */
+    steps: PlanStep[];
+    /** Plan status. */
+    status: PlanStatus;
+    /** Creation timestamp. */
+    createdAt: string;
+    /** Last update timestamp. */
+    updatedAt: string;
+}
+export type PlanStatus = "draft" | "approved" | "executing" | "completed" | "failed" | "modified";
+/** Create a new execution plan. */
+export declare function createPlan(id: string, title: string, description: string, steps: Array<Omit<PlanStep, "status">>): ExecutionPlan;
+/** Update a step's status. */
+export declare function updateStepStatus(plan: ExecutionPlan, stepId: string, status: PlanStepStatus, feedback?: string): ExecutionPlan;
+/** Insert a new step into the plan at a given position. */
+export declare function insertStep(plan: ExecutionPlan, step: Omit<PlanStep, "status">, afterStepId?: string): ExecutionPlan;
+/** Remove a step from the plan. Also removes it from other steps' dependsOn lists. */
+export declare function removeStep(plan: ExecutionPlan, stepId: string): ExecutionPlan;
+/** Get the next executable step (all dependencies satisfied). */
+export declare function getNextStep(plan: ExecutionPlan): PlanStep | undefined;
+/** Get plan progress summary. */
+export declare function getPlanProgress(plan: ExecutionPlan): {
+    total: number;
+    completed: number;
+    failed: number;
+    pending: number;
+    percentComplete: number;
+};
+/** Format plan for display. */
+export declare function formatPlanForDisplay(plan: ExecutionPlan): string;
+//# sourceMappingURL=planMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planMode.d.ts","sourceRoot":"","sources":["../../src/harness/planMode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzG,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,mBAAmB;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMlG,mCAAmC;AACnC,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GACrC,aAAa,CAWf;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,CAuBf;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAiBf;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAc7E;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS,CAWrE;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAYA;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA2BhE"}

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/profileOrchestration.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Profile-driven orchestration configuration — derive orchestration
+ * preferences from a user profile so runs automatically align with
+ * the operator's breakpoint tolerance, model preference, and tool
+ * choices (GAP-PROF-001).
+ */
+export type BreakpointDensity = 'none' | 'sparse' | 'moderate' | 'frequent';
+export interface OrchestrationConfig {
+    breakpointDensity: BreakpointDensity;
+    preferredModel: string | undefined;
+    toolPreferences: {
+        editor: string | undefined;
+        shell: string | undefined;
+        packageManagers: string[];
+    };
+}
+export interface ProcessOptions {
+    breakpointDensity?: BreakpointDensity;
+    model?: string;
+    toolPreferences?: {
+        editor?: string;
+        shell?: string;
+        packageManagers?: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Minimal subset of UserProfile that this module reads.
+ * We accept any object matching this shape so we don't import the SDK
+ * userTypes at compile time (the SDK is a build-time reference).
+ */
+export interface ProfileLike {
+    breakpointTolerance?: {
+        global?: string;
+    };
+    toolPreferences?: {
+        editor?: string;
+        shell?: string;
+        packageManagers?: string[];
+        [key: string]: unknown;
+    };
+    preferences?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * Derive orchestration configuration from a user profile.
+ */
+export declare function deriveOrchestrationConfig(profile: ProfileLike): OrchestrationConfig;
+/**
+ * Merge profile-derived preferences into process options.
+ * Explicit values in `options` take precedence over the profile.
+ */
+export declare function applyProfileToProcessOptions(profile: ProfileLike, options: ProcessOptions): ProcessOptions;
+//# sourceMappingURL=profileOrchestration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profileOrchestration.d.ts","sourceRoot":"","sources":["../../src/harness/profileOrchestration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE;QACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAuBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,CAenF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,cAAc,GACtB,cAAc,CAahB"}