pi-subagents 0.68.0 → 0.70.0

package/src/workflows/scripted-workflow.d.ts

@@ -0,0 +1,195 @@
+import type { AcceptanceRecoveryMetadata, HostStepNode, SingleResult } from "../shared/types.ts";
+import { type WorkflowHostCommandParams, type WorkflowHostCommandResult } from "./host-command.ts";
+export interface WorkflowScriptValidationError {
+    message: string;
+    line?: number;
+    column?: number;
+    kind?: "spawn-budget";
+}
+export interface WorkflowScriptValidationWarning {
+    message: string;
+    kind: "dynamic-spawn-count";
+}
+export interface WorkflowScriptValidationResult {
+    ok: boolean;
+    errors: WorkflowScriptValidationError[];
+    warnings?: WorkflowScriptValidationWarning[];
+}
+export interface WorkflowScriptValidationOptions {
+    maxSubagentSpawnsPerRun?: number;
+}
+export interface WorkflowScriptChildResult {
+    key: string;
+    /** True only for successfully completed child work, never for a launch receipt. */
+    ok: boolean;
+    /** An explicit async launch returned before a final child result was available. */
+    state?: "running";
+    asyncDir?: string;
+    lane?: import("../shared/types.ts").WorkflowLaneMetadata;
+    terminalOutcome?: import("../shared/types.ts").WorkflowTerminalOutcome;
+    stopped?: boolean;
+    /** Canonical child agent name when launch resolution produced one. */
+    agent?: string;
+    runId?: string;
+    output: string;
+    error?: string;
+    detached?: boolean;
+    interrupted?: boolean;
+    structuredOutput?: unknown;
+    requestedContext?: "fresh" | "fork";
+    resolvedContext?: "fresh" | "fork" | "mixed";
+    outputReference?: string;
+    /** A file produced by the child runtime (output or worktree handoff), not its job directory. */
+    outputArtifactPath?: string;
+    recovery?: AcceptanceRecoveryMetadata;
+    outputPathMapping?: {
+        requestedPath: string;
+        savedPath: string;
+    };
+    externalAdapter?: import("../shared/types.ts").ExternalCliReceiptMetadata;
+    resumability?: {
+        state: "resumable";
+    } | {
+        state: "not-resumable";
+        reason: string;
+    };
+    continuation?: {
+        runIds: string[];
+    };
+    artifactPaths: string[];
+    results?: SingleResult[];
+}
+export interface WorkflowScriptTraceEntry {
+    operation: "run" | "status" | "steer" | "host";
+    key: string;
+    state: "started" | "completed" | "failed" | "detached" | "stopped" | "reused" | "queued" | "delivered" | "missed";
+    /** Canonical child agent name when resolved launch or result data is available. */
+    agent?: string;
+    runId?: string;
+    durationMs?: number;
+    phase?: string;
+    label?: string;
+    error?: string;
+    /** Internal provenance for a generated runs.lanes child key. */
+    generatedLaneKey?: string;
+    lane?: import("../shared/types.ts").WorkflowLaneMetadata;
+    warning?: string;
+}
+/** Bounded plan metadata emitted when a workflow materializes a runs.lanes graph. */
+export interface WorkflowLanePlanStage {
+    key: string;
+    generatedKey: string;
+    agent?: string;
+    phase?: string;
+    label?: string;
+    outputName?: string;
+    structured?: boolean;
+}
+export interface WorkflowLanePlan {
+    key: string;
+    stages: WorkflowLanePlanStage[];
+}
+export interface WorkflowSteerOptions {
+    mode?: "steer" | "follow_up" | "auto";
+    index?: number;
+    ackTimeoutMs?: number;
+}
+export interface WorkflowSteerResult {
+    key: string;
+    state: "queued" | "delivered" | "missed" | "failed";
+    requestId?: string;
+    deliveryStatus?: "queued" | "delivered";
+    targets?: Array<{
+        index: number;
+        state: string;
+        reason?: string;
+    }>;
+    error?: string;
+}
+export interface WorkflowReceiptResumeReference {
+    workflowRunId: string;
+    key: string;
+    latest: true;
+}
+export interface WorkflowResolvedResumeReference {
+    runId: string;
+    runIds?: string[];
+}
+export interface WorkflowScriptResult {
+    value: unknown;
+    emits: unknown[];
+    console: Array<{
+        level: "log" | "info" | "warn" | "error";
+        text: string;
+    }>;
+    trace: WorkflowScriptTraceEntry[];
+    children: WorkflowScriptChildResult[];
+}
+export declare class WorkflowScriptError extends Error {
+    readonly partial: Omit<WorkflowScriptResult, "value">;
+    readonly errorKind?: "detached-child" | "timeout";
+    constructor(message: string, partial: Omit<WorkflowScriptResult, "value">, errorKind?: "detached-child" | "timeout");
+}
+export type WorkflowChildSettledOutcome = "completed" | "failed" | "paused" | "stopped";
+export interface WorkflowChildSettledNotification {
+    workflowRunId: string;
+    childKey: string;
+    childRunId?: string;
+    outcome: WorkflowChildSettledOutcome;
+    outputReference?: string;
+    error?: string;
+    workflowRunning: boolean;
+}
+export interface RunWorkflowScriptOptions {
+    script: string;
+    /** Normalized raw-script input exposed as the deeply frozen sandbox global `args`. */
+    args?: Readonly<Record<string, unknown>>;
+    /** Parent-session cwd used to recover a stale process cwd. */
+    processCwd?: string;
+    /** Workflow run ID for notifications. Required when onChildSettled is provided. */
+    workflowRunId?: string;
+    /** Host-only first-slice admission context. It is never sent to the workflow worker. */
+    oneUsePermit?: {
+        claim: (key: string) => string | undefined;
+    };
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Let an async workflow flush pure result assembly after reload once every child is terminal. */
+    continueAfterAbortWhenChildrenSettled?: (abortError: Error) => boolean;
+    /** Maximum children executing concurrently within this workflow. Defaults to 20. */
+    globalConcurrencyLimit?: number;
+    admit?: (calls: Array<{
+        key: string;
+        params: Record<string, unknown>;
+    }>, signal: AbortSignal) => void | Promise<void>;
+    launch: (key: string, params: Record<string, unknown>, signal: AbortSignal, admission: {
+        admitted: boolean;
+        batch: boolean;
+    }) => Promise<WorkflowScriptChildResult>;
+    resolveResume?: (reference: WorkflowReceiptResumeReference | string, signal: AbortSignal, index?: number) => string | WorkflowResolvedResumeReference | Promise<string | WorkflowResolvedResumeReference>;
+    status: (keyOrRunId: string, signal: AbortSignal) => Promise<WorkflowScriptChildResult>;
+    steer?: (key: string, message: string, options: WorkflowSteerOptions, signal: AbortSignal) => Promise<WorkflowSteerResult>;
+    host?: (key: string, params: WorkflowHostCommandParams, signal: AbortSignal) => Promise<WorkflowHostCommandResult>;
+    onHostStep?: (hostStep: HostStepNode) => void;
+    state?: {
+        get: (key: string) => unknown | Promise<unknown>;
+        set: (key: string, value: unknown) => void | Promise<void>;
+    };
+    registerStopChild?: (stop: ((key: string, message?: string) => boolean) | undefined) => void;
+    onTrace?: (trace: WorkflowScriptTraceEntry[]) => void;
+    onLanePlan?: (lanes: WorkflowLanePlan[]) => void;
+    onEmit?: (emits: unknown[]) => void;
+    onChildSettled?: (notification: WorkflowChildSettledNotification) => void;
+}
+export declare function assertWorkflowJsonValue(value: unknown, path?: string, seen?: Set<object>): void;
+export declare function formatWorkflowJsonPreview(value: unknown, maxLength: number): string | undefined;
+export interface SimpleWorkflowRunPreview {
+    agent?: string;
+    task?: string;
+}
+/** Display-only preview for the exact simple `return runs.run(key, {...})` form. */
+export declare function previewSimpleWorkflowRun(script: string | undefined): SimpleWorkflowRunPreview | undefined;
+/** Parse a workflowScript and apply only rules that are decidable from its local syntax. */
+export declare function validateWorkflowScript(script: string, options?: WorkflowScriptValidationOptions): WorkflowScriptValidationResult;
+export declare function runWorkflowScript(options: RunWorkflowScriptOptions): Promise<WorkflowScriptResult>;
+//# sourceMappingURL=scripted-workflow.d.ts.map

package/src/workflows/scripted-workflow.d.ts.map

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