pi-subagents 0.69.0 → 0.70.0

package/src/workflows/workflow-resources.js

@@ -0,0 +1,230 @@
+import { randomUUID } from "node:crypto";
+import { stableJsonDigest } from "../shared/launch-contract.js";
+import { createWorkflowResourcePermit, } from "../shared/workflow-child-permit.js";
+const RESOURCE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const MAX_ARGS_BYTES = 16 * 1024;
+const MAX_STRING_BYTES = 16 * 1024;
+function registry() {
+    const key = Symbol.for("pi-subagents.workflow-resources.v1");
+    const globalObject = globalThis;
+    const existing = globalObject[key];
+    if (existing === undefined) {
+        const created = { version: 1, bySession: new Map() };
+        globalObject[key] = created;
+        return created;
+    }
+    if (!isPlainRecord(existing) || existing.version !== 1 || !(existing.bySession instanceof Map))
+        throw new Error("Malformed or unsupported workflow resource registry.");
+    return existing;
+}
+/** Session ID scopes lookup, not authentication. Dispose on session_shutdown; issued permits remain valid. */
+export function registerWorkflowResource(input) {
+    if (!isPlainRecord(input) || Object.keys(input).some((key) => key !== "sessionId" && key !== "definition"))
+        throw new Error("Workflow registration requires only sessionId and definition.");
+    const { sessionId, definition } = input;
+    if (typeof sessionId !== "string" || !sessionId || sessionId.trim() !== sessionId || sessionId.length > 256 || sessionId.includes("\0"))
+        throw new Error("Workflow registration requires a non-empty trimmed sessionId of at most 256 characters without NUL.");
+    if (!isPlainRecord(definition) || Object.keys(definition).some((key) => !["name", "version", "resolve"].includes(key)))
+        throw new Error("Workflow definition requires only name, version and resolve.");
+    const { name, version, resolve } = definition;
+    if (typeof name !== "string" || !RESOURCE_NAME_PATTERN.test(name))
+        throw new Error("Workflow definition requires a safe resource name.");
+    if (!Number.isSafeInteger(version) || version < 1)
+        throw new Error("Workflow definition version must be a positive safe integer.");
+    if (typeof resolve !== "function")
+        throw new Error("Workflow definition requires a synchronous resolve function.");
+    if (findWorkflowResource(name))
+        throw new Error(`Workflow resource '${name}' is a protected builtin.`);
+    const current = registry();
+    const bucket = current.bySession.get(sessionId) ?? new Map();
+    if (!(bucket instanceof Map))
+        throw new Error("Malformed workflow resource session registry.");
+    if (bucket.has(name))
+        throw new Error(`Workflow resource '${name}' is already registered in this session; dispose it first.`);
+    const snapshot = Object.freeze({ name, version, resolve });
+    bucket.set(name, snapshot);
+    current.bySession.set(sessionId, bucket);
+    let disposed = false;
+    return {
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            if (bucket.get(name) === snapshot)
+                bucket.delete(name);
+            if (bucket.size === 0 && current.bySession.get(sessionId) === bucket)
+                current.bySession.delete(sessionId);
+        },
+    };
+}
+function isPlainRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function jsonByteLength(value) {
+    try {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new Error("must contain JSON data");
+        return Buffer.byteLength(encoded, "utf8");
+    }
+    catch (error) {
+        throw new Error(`must contain plain JSON data: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function validatePlainJson(value, path, depth = 0) {
+    if (depth > 8)
+        throw new Error(`${path} is too deeply nested.`);
+    if (value === null || typeof value === "boolean")
+        return;
+    if (typeof value === "string") {
+        if (!value.trim())
+            throw new Error(`${path} must not be empty.`);
+        if (Buffer.byteLength(value, "utf8") > MAX_STRING_BYTES)
+            throw new Error(`${path} exceeds ${MAX_STRING_BYTES} bytes.`);
+        return;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new Error(`${path} must be finite.`);
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (value.length > 64)
+            throw new Error(`${path} contains too many items.`);
+        for (const [index, entry] of value.entries())
+            validatePlainJson(entry, `${path}[${index}]`, depth + 1);
+        return;
+    }
+    if (!isPlainRecord(value))
+        throw new Error(`${path} must contain plain JSON data.`);
+    if (Object.keys(value).length > 16)
+        throw new Error(`${path} contains too many fields.`);
+    for (const [key, entry] of Object.entries(value)) {
+        if (!key.trim())
+            throw new Error(`${path} contains an empty field name.`);
+        validatePlainJson(entry, `${path}.${key}`, depth + 1);
+    }
+}
+export function normalizeWorkflowArgs(value) {
+    if (value === undefined)
+        return { args: {} };
+    if (!isPlainRecord(value))
+        return { error: "workflow args must be a plain JSON object." };
+    try {
+        validatePlainJson(value, "workflow args");
+        if (jsonByteLength(value) > MAX_ARGS_BYTES)
+            return { error: `workflow args exceed ${MAX_ARGS_BYTES} bytes.` };
+        return { args: JSON.parse(JSON.stringify(value)) };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+export function deepFreezeWorkflowArgs(args) {
+    deepFreezeWorkflowValue(args);
+    return args;
+}
+function deepFreezeWorkflowValue(value) {
+    if (!Array.isArray(value) && !isPlainRecord(value))
+        return;
+    for (const entry of Object.values(value))
+        deepFreezeWorkflowValue(entry);
+    Object.freeze(value);
+}
+function resolveRunCi(args) {
+    const allowed = new Set(["command", "timeoutMs"]);
+    const unsupported = Object.keys(args).filter((key) => !allowed.has(key));
+    if (unsupported.length > 0)
+        return { error: `workflow 'run-ci' args contain unsupported fields: ${unsupported.join(", ")}.` };
+    const command = args.command === undefined ? "npm test" : args.command;
+    if (command !== "npm test" && command !== "npm run typecheck")
+        return { error: "workflow 'run-ci' args.command must be 'npm test' or 'npm run typecheck'." };
+    const timeoutMs = args.timeoutMs === undefined ? 120_000 : args.timeoutMs;
+    if (typeof timeoutMs !== "number" || !Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 86_400_000)
+        return { error: "workflow 'run-ci' args.timeoutMs must be an integer from 1 to 86400000." };
+    const params = { kind: "command", command, timeoutMs, role: "ci" };
+    return {
+        script: `return await runs.host("ci", ${JSON.stringify(params)});`,
+        hostCommands: [{ key: "ci", command }],
+    };
+}
+function resolveReview(args) {
+    const unsupported = Object.keys(args).filter((key) => key !== "task");
+    if (unsupported.length > 0)
+        return { error: `workflow 'review' args contain unsupported fields: ${unsupported.join(", ")}.` };
+    const task = args.task;
+    if (typeof task !== "string" || !task.trim())
+        return { error: "workflow 'review' requires a non-empty string args.task." };
+    return {
+        script: `return (await runs.run("review", { agent: "reviewer", task: ${JSON.stringify(task.trim())} })).output;`,
+    };
+}
+const WORKFLOW_RESOURCES = [
+    { name: "review", version: 1, resolve: resolveReview },
+    { name: "run-ci", version: 1, resolve: resolveRunCi },
+];
+function findWorkflowResource(name) {
+    return WORKFLOW_RESOURCES.find((resource) => resource.name === name);
+}
+function listWorkflowResourceNames() {
+    return WORKFLOW_RESOURCES.map((resource) => resource.name);
+}
+/** Resolve only extension-owned resources so policy can distinguish them from raw scripts; caller-provided script text is never consulted. */
+export function resolveWorkflowResource(nameValue, argsValue, sessionId) {
+    try {
+        const result = resolveResource(nameValue, argsValue, sessionId);
+        return result.ok ? result : { ok: false, error: result.error.slice(0, 4096) };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message.slice(0, 4096) : "Workflow resource resolution failed." };
+    }
+}
+function resolveResource(nameValue, argsValue, sessionId) {
+    if (typeof nameValue !== "string" || !nameValue.trim())
+        return { ok: false, error: "workflow must be a non-empty resource name." };
+    const name = nameValue.trim();
+    if (!RESOURCE_NAME_PATTERN.test(name))
+        return { ok: false, error: "workflow must use a safe resource name." };
+    const resource = findWorkflowResource(name) ?? (sessionId ? registry().bySession.get(sessionId)?.get(name) : undefined);
+    if (!resource)
+        return { ok: false, error: `Unknown workflow resource '${name}'. Available resources: ${listWorkflowResourceNames().join(", ")}.` };
+    const normalizedArgs = normalizeWorkflowArgs(argsValue);
+    if ("error" in normalizedArgs)
+        return { ok: false, error: normalizedArgs.error };
+    const resolved = resource.resolve(normalizedArgs.args);
+    if (resolved && typeof resolved.then === "function") {
+        void Promise.resolve(resolved).catch(() => { });
+        throw new Error("Workflow resource resolve must be synchronous.");
+    }
+    if (!isPlainRecord(resolved))
+        throw new Error("Workflow resource resolve must return an expansion or error object.");
+    if ("error" in resolved) {
+        if (Object.keys(resolved).some((key) => key !== "error") || typeof resolved.error !== "string" || !resolved.error.trim())
+            throw new Error("Workflow resource returned an invalid error.");
+        return { ok: false, error: resolved.error };
+    }
+    const { script, hostCommands } = resolved;
+    if (Object.keys(resolved).some((key) => key !== "script" && key !== "hostCommands") || typeof script !== "string" || !script.trim())
+        throw new Error("Workflow resource returned an invalid expansion.");
+    const resourceId = randomUUID();
+    const permit = createWorkflowResourcePermit({
+        resourceName: resource.name,
+        resourceVersion: resource.version,
+        resourceId,
+        scriptDigest: stableJsonDigest(script),
+        authority: { host: hostCommands },
+    });
+    const provenance = Object.freeze({
+        kind: "workflow",
+        name: resource.name,
+        version: resource.version,
+        invocation: "named",
+        expansion: "resolved",
+        id: resourceId,
+    });
+    return { ok: true, resource: { script, permit, provenance } };
+}
+//# sourceMappingURL=workflow-resources.js.map

package/src/workflows/workflow-resources.js.map

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

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

@@ -0,0 +1,85 @@
+import type { AsyncStatus, WorkflowRecoveryAction, WorkflowTerminalOutcome, WorkflowTerminalResolution, Usage } from "../shared/types.ts";
+import type { WorkflowReceipt } from "./workflow-receipt.ts";
+export declare const UNSUPPORTED_DETACHED_WORKFLOW_CONTINUATION = "unsupported-continuation: detached workflow child settled, but JavaScript workflow continuation was not persisted. Resume the workflow explicitly instead of treating the completed child as top-level workflow completion.";
+export declare const INTERRUPTED_DETACHED_CHILD = "Interrupted. Waiting for explicit next action.";
+export declare const EVIDENCE_PERSISTENCE_FAILED = "evidence-persistence-failed";
+export type WorkflowStatusStep = NonNullable<AsyncStatus["steps"]>[number] & {
+    outputPathMapping?: {
+        requestedPath: string;
+        savedPath: string;
+    };
+    interrupted?: boolean;
+};
+export interface WorkflowPublicChild {
+    workflowKey?: string;
+    agent?: string;
+    /** Human-readable display name for the child session, when derived at launch. */
+    sessionName?: string;
+    runId?: string;
+    usage?: Usage;
+    sessionFile?: string;
+    output: string;
+    outputState: "present" | "absent";
+    structuredOutput?: unknown;
+    /** Omitted for running launch receipts. */
+    success?: boolean;
+    state?: "running";
+    asyncDir?: string;
+    terminalOutcome?: WorkflowTerminalOutcome;
+    outputReference?: string;
+    outputPathMapping?: {
+        requestedPath: string;
+        savedPath: string;
+    };
+    stopped?: boolean;
+    interrupted?: boolean;
+    detached?: boolean;
+    error?: string;
+    artifactPaths?: {
+        outputPath: string;
+    };
+}
+export interface WorkflowSettlementPlan {
+    status: AsyncStatus;
+    publicResult: Record<string, unknown>;
+    receipt?: WorkflowReceipt;
+    recovery: WorkflowRecoveryAction[];
+    completionEvent?: Record<string, unknown>;
+}
+export declare function findWorkflowSettlementStep(status: AsyncStatus, childRunId: string, workflowKey?: string, sessionFile?: string): WorkflowStatusStep | undefined;
+export declare function promoteSettledPausedWorkflow(status: AsyncStatus, now?: number): AsyncStatus | undefined;
+export declare function applyDetachedChildSettlement(status: AsyncStatus, input: {
+    childRunId: string;
+    result: {
+        exitCode: number | null;
+        error?: string;
+        interrupted?: boolean;
+        sessionFile?: string;
+        sessionName?: string;
+        stopped?: boolean;
+    };
+    workflowKey?: string;
+    now?: number;
+}): AsyncStatus | undefined;
+export declare function classifyWorkflowSettlement(status: AsyncStatus, interrupted?: boolean): WorkflowTerminalResolution | undefined;
+export declare function workflowRecoveryActions(receipt: WorkflowReceipt | undefined): WorkflowRecoveryAction[];
+export declare function workflowTerminalOutcomeForResult(result: {
+    timedOut?: boolean;
+    turnBudgetExceeded?: boolean;
+    toolBudgetBlocked?: boolean;
+}): WorkflowTerminalOutcome | undefined;
+export declare function workflowOutputPathMappingSummary(children: readonly unknown[]): string;
+export declare function planWorkflowSettlement(input: {
+    status: AsyncStatus;
+    summary: string;
+    children: WorkflowPublicChild[];
+    baseResult: Record<string, unknown>;
+    receipt?: WorkflowReceipt;
+    receiptPath?: string;
+    receiptPersistenceError?: string;
+    resolution?: WorkflowTerminalResolution;
+    terminalOutcome?: WorkflowTerminalOutcome;
+    now?: number;
+    eventMetadata?: Record<string, unknown>;
+}): WorkflowSettlementPlan;
+//# sourceMappingURL=workflow-settlement.d.ts.map

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

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

package/src/workflows/workflow-settlement.js

@@ -0,0 +1,204 @@
+import { workflowChildSummary } from "./workflow-child-summary.js";
+export const UNSUPPORTED_DETACHED_WORKFLOW_CONTINUATION = "unsupported-continuation: detached workflow child settled, but JavaScript workflow continuation was not persisted. Resume the workflow explicitly instead of treating the completed child as top-level workflow completion.";
+export const INTERRUPTED_DETACHED_CHILD = "Interrupted. Waiting for explicit next action.";
+export const EVIDENCE_PERSISTENCE_FAILED = "evidence-persistence-failed";
+function cloneWorkflowStatus(status) {
+    return {
+        ...status,
+        steps: status.steps?.map((step) => ({ ...step })),
+        workflow: status.workflow ? { ...status.workflow, trace: [...(status.workflow.trace ?? [])] } : status.workflow,
+    };
+}
+function workflowState(status) {
+    return status.state === "complete" ? "completed" : status.state === "paused" ? "paused" : status.state === "stopped" ? "stopped" : "failed";
+}
+function withWorkflowChildren(status) {
+    return {
+        ...status,
+        workflowChildren: workflowChildSummary({
+            parentToolCallId: status.toolCallId ?? status.runId,
+            workflowRunId: status.runId,
+            workflowState: workflowState(status),
+            inventoryComplete: true,
+            trace: status.workflow?.trace,
+            steps: status.steps,
+        }),
+    };
+}
+export function findWorkflowSettlementStep(status, childRunId, workflowKey, sessionFile) {
+    const exact = status.steps?.find((candidate) => candidate.runId === childRunId);
+    if (exact || !workflowKey || !sessionFile)
+        return exact;
+    const candidates = status.steps?.filter((candidate) => candidate.runId === undefined
+        && candidate.workflowKey === workflowKey
+        && candidate.sessionFile === sessionFile) ?? [];
+    return candidates.length === 1 ? candidates[0] : undefined;
+}
+export function promoteSettledPausedWorkflow(status, now = Date.now()) {
+    if (status.mode !== "workflow" || status.state !== "paused")
+        return undefined;
+    const next = cloneWorkflowStatus(status);
+    const stillOpen = next.steps?.some((candidate) => candidate.status === "running"
+        || (candidate.status === "paused" && candidate.activityState === "needs_attention")) === true;
+    if (stillOpen || !next.steps?.length)
+        return undefined;
+    const failed = next.steps.some((candidate) => candidate.status === "failed");
+    next.lastUpdate = now;
+    next.state = "failed";
+    next.endedAt = now;
+    delete next.activityState;
+    if (!failed)
+        next.error = UNSUPPORTED_DETACHED_WORKFLOW_CONTINUATION;
+    return withWorkflowChildren(next);
+}
+export function applyDetachedChildSettlement(status, input) {
+    if (status.mode !== "workflow" || status.state !== "paused")
+        return undefined;
+    const next = cloneWorkflowStatus(status);
+    const step = findWorkflowSettlementStep(next, input.childRunId, input.workflowKey, input.result.sessionFile);
+    if (!step)
+        return undefined;
+    step.runId ??= input.childRunId;
+    const succeeded = input.result.exitCode === 0 && !input.result.error && !input.result.interrupted;
+    const failedSiblingError = next.steps?.find((candidate) => {
+        const candidateStep = candidate;
+        return candidateStep !== step && candidateStep.status === "failed" && !candidateStep.interrupted && candidateStep.error;
+    })?.error;
+    const interruptedChildError = next.steps?.find((candidate) => {
+        const candidateStep = candidate;
+        return candidateStep.status === "failed" && candidateStep.interrupted && candidateStep.error;
+    })?.error;
+    const now = input.now ?? Date.now();
+    step.status = succeeded ? "completed" : "failed";
+    step.endedAt = now;
+    delete step.activityState;
+    delete step.currentTool;
+    delete step.currentToolStartedAt;
+    if (input.result.sessionFile)
+        step.sessionFile = input.result.sessionFile;
+    if (input.result.sessionName)
+        step.sessionName = input.result.sessionName;
+    if (succeeded) {
+        delete step.error;
+        delete step.interrupted;
+    }
+    else if (input.result.interrupted || input.result.stopped) {
+        step.error = input.result.error ?? INTERRUPTED_DETACHED_CHILD;
+        step.interrupted = true;
+        if (input.result.stopped)
+            step.stopped = true;
+    }
+    else {
+        delete step.interrupted;
+        delete step.stopped;
+        if (input.result.error)
+            step.error = input.result.error;
+    }
+    next.lastUpdate = now;
+    const promoted = promoteSettledPausedWorkflow(next, now);
+    if (promoted?.state === "failed" && failedSiblingError)
+        promoted.error = failedSiblingError;
+    else if (promoted?.state === "failed" && (input.result.interrupted || input.result.stopped))
+        promoted.error = input.result.error ?? INTERRUPTED_DETACHED_CHILD;
+    else if (promoted?.state === "failed" && input.result.error)
+        promoted.error = input.result.error;
+    else if (promoted?.state === "failed" && interruptedChildError)
+        promoted.error = interruptedChildError;
+    return withWorkflowChildren(promoted ?? next);
+}
+export function classifyWorkflowSettlement(status, interrupted = false) {
+    if (status.state !== "complete" && status.state !== "failed")
+        return undefined;
+    if (status.steps?.some((step) => {
+        const candidate = step;
+        return candidate.status === "failed" && !candidate.interrupted;
+    }))
+        return "failed-child";
+    if (interrupted || status.steps?.some((step) => {
+        const candidate = step;
+        return candidate.status === "stopped" || candidate.stopped || candidate.interrupted || candidate.error === INTERRUPTED_DETACHED_CHILD;
+    }))
+        return "interrupted-child";
+    return "settled-awaiting-resume";
+}
+export function workflowRecoveryActions(receipt) {
+    if (!receipt)
+        return [];
+    return Object.values(receipt.entries).flatMap((entry) => entry.resumability.state === "resumable"
+        ? [{ key: entry.key, call: "runs.run", resume: { workflowRunId: receipt.workflowRunId, key: entry.key, latest: true }, taskRequired: true }]
+        : []);
+}
+export function workflowTerminalOutcomeForResult(result) {
+    if (result.timedOut)
+        return { state: "partial", reason: "timeout" };
+    if (result.turnBudgetExceeded || result.toolBudgetBlocked)
+        return { state: "partial", reason: "budget_exhausted" };
+    return undefined;
+}
+export function workflowOutputPathMappingSummary(children) {
+    const mappings = children.flatMap((entry) => {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            return [];
+        const child = entry;
+        return child.outputPathMapping
+            ? [`'${child.workflowKey ?? "child"}': requested ${child.outputPathMapping.requestedPath} -> saved ${child.outputPathMapping.savedPath}`]
+            : [];
+    });
+    return mappings.length > 0 ? ` Output path mappings: ${mappings.join("; ")}.` : "";
+}
+export function planWorkflowSettlement(input) {
+    const now = input.now ?? Date.now();
+    let status = withWorkflowChildren(cloneWorkflowStatus(input.status));
+    let summary = input.summary;
+    let receipt = input.receipt;
+    let resolution = input.resolution;
+    if (input.receiptPersistenceError) {
+        const diagnostic = `${EVIDENCE_PERSISTENCE_FAILED}: ${input.receiptPersistenceError}`;
+        status = withWorkflowChildren({ ...status, state: "failed", error: diagnostic, activityState: undefined, endedAt: now, lastUpdate: now });
+        summary = `${diagnostic} Available child evidence was preserved, but workflow completion was not accepted.`;
+        receipt = undefined;
+        if (!resolution)
+            resolution = classifyWorkflowSettlement(status);
+    }
+    const recovery = workflowRecoveryActions(receipt);
+    delete status.workflowReceiptPath;
+    if (receipt && input.receiptPath)
+        status.workflowReceiptPath = input.receiptPath;
+    if (receipt) {
+        receipt = {
+            ...receipt,
+            state: status.state === "complete" ? "complete" : status.state === "paused" ? "paused" : status.state === "stopped" ? "stopped" : "failed",
+            workflowChildren: status.workflowChildren,
+            ...(resolution ? { workflowResolution: resolution, recovery } : {}),
+        };
+    }
+    const publicResult = {
+        ...input.baseResult,
+        success: status.state === "complete",
+        state: status.state,
+        summary,
+        error: status.state === "complete" ? undefined : status.error ?? summary,
+        stopped: status.stopped ? true : undefined,
+        activityState: status.activityState,
+        workflowChildren: status.workflowChildren,
+        results: input.children,
+        ...(input.terminalOutcome ? { terminalOutcome: input.terminalOutcome } : {}),
+        ...(resolution ? { workflowResolution: resolution, recovery } : {}),
+        ...(receipt && input.receiptPath ? { workflowReceipt: { path: input.receiptPath, receipt } } : {}),
+        timestamp: now,
+    };
+    const terminal = status.state === "complete" || status.state === "failed" || status.state === "partial" || status.state === "stopped";
+    if (!status.workflowReceiptPath)
+        delete publicResult.workflowReceipt;
+    const completionEvent = terminal ? {
+        type: "subagent.workflow.completed",
+        state: status.state,
+        ...(resolution ? { workflowResolution: resolution } : {}),
+        ...(input.terminalOutcome ? { terminalOutcome: input.terminalOutcome } : {}),
+        ...(status.error ? { error: status.error } : {}),
+        ...(status.activityState ? { activityState: status.activityState } : {}),
+        ...input.eventMetadata,
+    } : undefined;
+    return { status, publicResult, receipt, recovery, completionEvent };
+}
+//# sourceMappingURL=workflow-settlement.js.map

package/src/workflows/workflow-settlement.js.map

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

package/index.ts

@@ -1,13 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import type {} from "./src/types/pi-runtime-compat.d.ts";
-import { HERDR_PI_MODE_ENV } from "./src/runs/shared/herdr-pi-protocol.ts";
-
-const registerExtension = process.env[HERDR_PI_MODE_ENV] === "1"
-	? (await import("./src/extension/herdr-pi-bridge.ts")).default
-	: process.env.PI_SUBAGENT_CHILD === "1"
-	? undefined
-	: (await import("./src/extension/index.ts")).default;
-
-export default function registerSubagentExtension(pi: ExtensionAPI): void {
-	registerExtension?.(pi);
-}