@fitchmultz/pi-subagents 0.49.0 → 0.50.0

package/dist/runs/shared/acceptance-submission.js

@@ -1,167 +0,0 @@
-import { isDeepStrictEqual } from "node:util";
-import { createStructuredOutputRuntime, readStructuredOutput, validateStructuredOutputValue, } from "./structured-output.js";
-import { ACCEPTANCE_REPORT_SCHEMA, isAcceptanceReport, parseAcceptanceReport, } from "./acceptance-reports.js";
-export function createFinalizationReportRuntime(publicOutputSchema) {
-    const runtime = createStructuredOutputRuntime({
-        type: "object",
-        properties: {
-            // Resource-local references, including recursive '#', stay scoped to the public answer.
-            answer: publicOutputSchema
-                ? { $id: "urn:pi-subagents:public-output", ...publicOutputSchema }
-                : {
-                    type: "string",
-                    pattern: "\\S",
-                    description: "Complete standalone final answer, including every requested handoff detail.",
-                },
-            report: ACCEPTANCE_REPORT_SCHEMA,
-        },
-        required: ["answer", "report"],
-        additionalProperties: false,
-    });
-    return { ...runtime, publicOutputSchema };
-}
-function readReportValue(value, publicOutputSchema) {
-    if (value === null || typeof value !== "object") {
-        return undefined;
-    }
-    // Legacy runtimes retain their original string schema.
-    if (publicOutputSchema === undefined && "report" in value && typeof value.report === "string") {
-        const parsed = parseAcceptanceReport(value.report);
-        if (parsed.report) {
-            return { output: value.report, report: parsed.report };
-        }
-    }
-    if (!("answer" in value) || !("report" in value) || !isAcceptanceReport(value.report)) {
-        return undefined;
-    }
-    return readAnswer(value.answer, value.report, publicOutputSchema);
-}
-function readAnswer(answer, report, schema) {
-    if (schema) {
-        if (validateStructuredOutputValue(schema, answer).status === "invalid") {
-            return undefined;
-        }
-        return { output: JSON.stringify(answer), structuredOutput: answer, report };
-    }
-    if (typeof answer !== "string" || answer.trim().length === 0) {
-        return undefined;
-    }
-    return { output: answer, report };
-}
-export function reportAuditOutput(submission) {
-    return submission.report && !parseAcceptanceReport(submission.output).report
-        ? `${submission.output}\n\n\`\`\`acceptance-report\n${JSON.stringify(submission.report)}\n\`\`\``
-        : submission.output;
-}
-function toolResultSucceeded(result) {
-    return result.isError === false;
-}
-function successfulStructuredIds(messages) {
-    return new Set(messages.flatMap((message) => message.role === "toolResult" &&
-        message.toolName === "structured_output" &&
-        toolResultSucceeded(message)
-        ? [message.toolCallId]
-        : []));
-}
-function auditSubmission(value, runtime) {
-    const previous = readReportValue(value, runtime.publicOutputSchema);
-    return previous && validateStructuredOutputValue(runtime.schema, value).status === "valid"
-        ? reportAuditOutput(previous)
-        : undefined;
-}
-function previousAuditOutput(messages, runtime, submitted) {
-    const successfulIds = successfulStructuredIds(messages);
-    let retained = submitted ? reportAuditOutput(submitted) : undefined;
-    for (const message of messages) {
-        if (message.role !== "assistant") {
-            continue;
-        }
-        const content = message.content;
-        if (!Array.isArray(message.content)) {
-            continue;
-        }
-        for (const call of content) {
-            if (call.type !== "toolCall" ||
-                call.name !== "structured_output" ||
-                !successfulIds.has(call.id)) {
-                continue;
-            }
-            const value = call.arguments.value;
-            retained = auditSubmission(value, runtime) ?? retained;
-        }
-    }
-    return retained;
-}
-function latestSubmissionError(messages, call, index) {
-    const result = messages
-        .slice(index + 1)
-        .findLast((message) => message.role === "toolResult" && message.toolCallId === call.id);
-    if (result?.role !== "toolResult" ||
-        result.toolName !== "structured_output" ||
-        !toolResultSucceeded(result)) {
-        return "the latest structured_output call has no matching successful result.";
-    }
-    return undefined;
-}
-function latestAssistant(messages) {
-    const index = messages.findLastIndex((message) => message.role === "assistant");
-    const last = Object.hasOwn(messages, index) ? messages[index] : undefined;
-    if (last?.role !== "assistant" ||
-        (last.errorMessage ?? "").length > 0 ||
-        (last.stopReason !== "stop" && last.stopReason !== "toolUse") ||
-        !Array.isArray(last.content)) {
-        return undefined;
-    }
-    return { message: last, index };
-}
-function currentToolSubmissionError(last, messages, index, captured) {
-    const calls = last.content.filter((part) => part.type === "toolCall");
-    const call = calls.length > 0 ? calls[0] : undefined;
-    if (calls.length !== 1 || call?.name !== "structured_output") {
-        return "the latest assistant turn must submit structured_output as its only tool call.";
-    }
-    const error = latestSubmissionError(messages, call, index);
-    if (error !== undefined) {
-        return error;
-    }
-    if (captured.error !== undefined) {
-        return captured.error;
-    }
-    if (!isDeepStrictEqual(captured.value, call.arguments.value)) {
-        return "the capture does not match the latest submission.";
-    }
-    return undefined;
-}
-/** The current attempt's terminal assistant and its actual successful tool result authorize publication. */
-export function readFinalizationReport(messages, runtime, options = {}) {
-    const currentMessages = messages.slice(options.messageOffset ?? 0);
-    const captured = readStructuredOutput(runtime);
-    const submitted = readReportValue(captured.value, runtime.publicOutputSchema);
-    const unconfirmedOutput = previousAuditOutput(currentMessages, runtime, submitted);
-    const rejected = (reason) => ({
-        output: "",
-        reportSubmissionError: `No current finalization report: ${reason}`,
-        unconfirmedOutput,
-    });
-    const latest = latestAssistant(currentMessages);
-    if (!latest) {
-        return rejected("the latest assistant turn did not finish successfully.");
-    }
-    // Claude Code's terminal result is schema-constrained rather than a Pi tool call.
-    if (options.structuredResult === true) {
-        if (captured.error !== undefined) {
-            return rejected(captured.error);
-        }
-        return submitted
-            ? { ...submitted, unconfirmedOutput }
-            : rejected("the submission must contain a complete answer and a valid acceptance report.");
-    }
-    const error = currentToolSubmissionError(latest.message, currentMessages, latest.index, captured);
-    if (error !== undefined) {
-        return rejected(error);
-    }
-    if (!submitted) {
-        return rejected("the submission must contain a complete answer and a valid acceptance report.");
-    }
-    return { ...submitted, unconfirmedOutput };
-}

package/dist/runs/shared/acceptance-verification.js

@@ -1,100 +0,0 @@
-import { spawn } from "node:child_process";
-import { addAbortListener } from "node:events";
-import * as path from "node:path";
-import { attachChildProcessLifecycle } from "../../shared/post-exit-stdio-guard.js";
-const MAX_VERIFY_OUTPUT_CHARS = 12_000;
-class VerifyOutput {
-    value = "";
-    truncated = false;
-    append(chunk) {
-        const text = chunk.toString();
-        const remaining = Math.max(0, MAX_VERIFY_OUTPUT_CHARS - this.value.length);
-        this.value += text.slice(0, remaining);
-        this.truncated ||= text.length > remaining;
-    }
-    read() {
-        const trimmed = this.value.trim();
-        if (trimmed.length === 0 && !this.truncated) {
-            return undefined;
-        }
-        return this.truncated ? `${trimmed}${trimmed.length > 0 ? "\n" : ""}...[truncated]` : trimmed;
-    }
-}
-function verifyStatus(exitCode, timedOut, cancelled, allowFailure) {
-    if (cancelled) {
-        return "failed";
-    }
-    if (timedOut) {
-        return "timed-out";
-    }
-    if (exitCode === 0) {
-        return "passed";
-    }
-    return allowFailure ? "allowed-failure" : "failed";
-}
-/** Owns the verification child, tree termination, output bounds, listeners and timer through close. */
-export function runVerifyCommand(command, defaultCwd, signal) {
-    return new Promise((resolve) => {
-        const startedAt = Date.now();
-        const cwd = command.cwd !== undefined && command.cwd.length > 0
-            ? path.resolve(defaultCwd, command.cwd)
-            : defaultCwd;
-        const stdout = new VerifyOutput();
-        const stderr = new VerifyOutput();
-        let timedOut = false;
-        let cancelled = false;
-        const child = spawn(command.command, {
-            cwd,
-            env: { ...process.env, ...command.env },
-            shell: true,
-            stdio: ["ignore", "pipe", "pipe"],
-            detached: true,
-        });
-        const lifecycle = attachChildProcessLifecycle(child);
-        const abortListener = signal &&
-            addAbortListener(signal, () => {
-                cancelled = true;
-                lifecycle.terminate();
-            });
-        const timeout = setTimeout(() => {
-            timedOut = true;
-            lifecycle.terminate();
-        }, command.timeoutMs ?? 120_000);
-        timeout.unref();
-        child.stdout.on("data", (chunk) => {
-            stdout.append(chunk);
-        });
-        child.stderr.on("data", (chunk) => {
-            stderr.append(chunk);
-        });
-        const cleanup = () => {
-            clearTimeout(timeout);
-            abortListener?.[Symbol.dispose]();
-        };
-        child.on("close", (exitCode) => {
-            cleanup();
-            resolve({
-                id: command.id,
-                command: command.command,
-                cwd,
-                exitCode,
-                status: verifyStatus(exitCode, timedOut, cancelled, command.allowFailure === true),
-                stdout: stdout.read(),
-                stderr: cancelled ? "Verification cancelled." : stderr.read(),
-                durationMs: Date.now() - startedAt,
-            });
-        });
-        child.on("error", (error) => {
-            cleanup();
-            resolve({
-                id: command.id,
-                command: command.command,
-                cwd,
-                exitCode: 1,
-                status: command.allowFailure === true ? "allowed-failure" : "failed",
-                stderr: error.message,
-                durationMs: Date.now() - startedAt,
-            });
-        });
-    });
-}

package/dist/runs/shared/acceptance.js

@@ -1,4 +0,0 @@
-export { acceptanceInputFromResolved, acceptanceSelfReviewConfig, formatAcceptancePrompt, resolveEffectiveAcceptance, shouldRunAcceptanceFinalization, validateAcceptanceInput, } from "./acceptance-contract.js";
-export { parseAcceptanceReport, validateAcceptanceReportShape, stripAcceptanceReport, } from "./acceptance-reports.js";
-export { acceptanceFailureMessage, acceptanceHumanAction, evaluateAcceptance, evaluateAcceptanceReport, } from "./acceptance-evaluation.js";
-export { buildFinalizationProcessFailureLedger, createFinalizationProcessFailureTurn, createFinalizationReportRuntime, readFinalizationReport, formatUnconfirmedFinalizationOutput, formatAcceptanceFinalizationPrompt, evaluateRunAcceptance, resolveExecutionOutcome, resolveFinalizationOutput, } from "./acceptance-finalization.js";

package/dist/runs/shared/chain-outputs.js

@@ -1,138 +0,0 @@
-import { isDynamicParallelStep, isParallelStep } from "../../shared/settings.js";
-import { DynamicFanoutError, hasDynamicFanoutFields, isSafeOutputName, resolveItemTemplate, validateDynamicStepShape, } from "./dynamic-fanout.js";
-const OUTPUT_REF_PATTERN = /\{outputs\.([^}]*)\}/g;
-export class ChainOutputValidationError extends Error {
-}
-function outputNamesForStep(step) {
-    if (isParallelStep(step)) {
-        return step.parallel.map((task) => task.as).filter((name) => Boolean(name));
-    }
-    if (isDynamicParallelStep(step)) {
-        return [step.collect.as];
-    }
-    const name = step.as;
-    return name !== undefined && name.length > 0 ? [name] : [];
-}
-function taskTemplatesForStep(step) {
-    if (isParallelStep(step)) {
-        return step.parallel.map((task) => task.task ?? "{previous}");
-    }
-    if (isDynamicParallelStep(step)) {
-        return [step.parallel.task ?? "{previous}", step.parallel.label ?? ""].filter(Boolean);
-    }
-    return [step.task ?? "{previous}"];
-}
-function validateDynamicSource(step, stepIndex, available, config) {
-    if (!hasDynamicFanoutFields(step)) {
-        return;
-    }
-    if (!isDynamicParallelStep(step)) {
-        throw new ChainOutputValidationError(`Dynamic chain step ${stepIndex + 1} requires expand, a single parallel template object, and collect; dynamic expand/collect cannot be mixed with static parallel arrays.`);
-    }
-    try {
-        validateDynamicStepShape(step, stepIndex, config);
-    }
-    catch (error) {
-        if (error instanceof DynamicFanoutError) {
-            throw new ChainOutputValidationError(error.message, { cause: error });
-        }
-        throw error;
-    }
-    if (!available.includes(step.expand.from.output)) {
-        throw new ChainOutputValidationError(`Dynamic chain step ${stepIndex + 1} references unknown output '${step.expand.from.output}'. Named outputs are only available after producing step/group completes.`);
-    }
-}
-function validateTemplateBindings(templates, available, stepIndex) {
-    for (const template of templates) {
-        for (const match of template.matchAll(OUTPUT_REF_PATTERN)) {
-            const rawReference = match[0];
-            const name = match[1];
-            if (!isSafeOutputName(name)) {
-                throw new ChainOutputValidationError(`Invalid chain output reference '${rawReference}' at step ${stepIndex + 1}. Use {outputs.name} with /^[A-Za-z_][A-Za-z0-9_]*$/ names.`);
-            }
-            if (!available.includes(name)) {
-                throw new ChainOutputValidationError(`Unknown chain output reference '${rawReference}' at step ${stepIndex + 1}. Named outputs are only available after producing step/group completes.`);
-            }
-        }
-    }
-}
-export function validateChainOutputBindings(steps, dynamicFanoutConfig = {}) {
-    const available = [];
-    const seen = new Set();
-    for (const [stepIndex, step] of steps.entries()) {
-        validateDynamicSource(step, stepIndex, available, dynamicFanoutConfig);
-        for (const name of outputNamesForStep(step)) {
-            if (!isSafeOutputName(name)) {
-                throw new ChainOutputValidationError(`Invalid chain output name '${name}' at step ${stepIndex + 1}. Use /^[A-Za-z_][A-Za-z0-9_]*$/.`);
-            }
-            if (seen.has(name)) {
-                throw new ChainOutputValidationError(`Duplicate chain output name '${name}'. Each as name must be unique.`);
-            }
-            seen.add(name);
-        }
-        validateTemplateBindings(taskTemplatesForStep(step), available, stepIndex);
-        for (const name of outputNamesForStep(step)) {
-            available.push(name);
-        }
-    }
-}
-export function resolveOutputReferences(template, outputs) {
-    return template.replace(OUTPUT_REF_PATTERN, (rawReference, name) => {
-        if (!isSafeOutputName(name)) {
-            throw new ChainOutputValidationError(`Invalid chain output reference '${rawReference}'. Use {outputs.name} with /^[A-Za-z_][A-Za-z0-9_]*$/ names.`);
-        }
-        const entry = Object.hasOwn(outputs, name)
-            ? outputs[name]
-            : undefined;
-        if (!entry) {
-            throw new ChainOutputValidationError(`Unknown chain output reference '${rawReference}'.`);
-        }
-        return entry.text;
-    });
-}
-function isItemPlaceholder(raw, name) {
-    return raw === `{${name}}` || raw.startsWith(`{${name}.`);
-}
-function renderReference(raw, reference, values) {
-    if (values.item && isItemPlaceholder(raw, values.item.name)) {
-        return resolveItemTemplate(raw, values.item.name, values.item.value);
-    }
-    if (reference === "task") {
-        return values.originalTask ?? "";
-    }
-    if (reference === "chain_dir") {
-        return values.chainDir ?? "";
-    }
-    if (reference !== undefined && reference.startsWith("outputs.")) {
-        return resolveOutputReferences(raw, values.outputs ?? {});
-    }
-    return raw;
-}
-export function renderChainTask(template, values, placeholder = "{previous}") {
-    const pattern = new RegExp(`${placeholder.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}|\\{([^{}]*)\\}`, "g");
-    const previousOutput = values.previousOutput ?? "";
-    const usedPrevious = [...template.matchAll(pattern)].some(([raw]) => raw === placeholder && !(values.item && isItemPlaceholder(raw, values.item.name)));
-    const task = template.replace(pattern, (raw, reference) => {
-        // Item placeholders retain precedence if a caller customizes the previous-output placeholder.
-        if (values.item && isItemPlaceholder(raw, values.item.name)) {
-            return renderReference(raw, reference, values);
-        }
-        if (raw === placeholder) {
-            return previousOutput;
-        }
-        return renderReference(raw, reference, values);
-    });
-    return !usedPrevious && previousOutput.trim().length > 0
-        ? `${task}\n\n---\nPrevious step output:\n${previousOutput.trim()}`
-        : task;
-}
-export function outputEntryFromResult(result, stepIndex) {
-    return {
-        text: result.structuredOutput !== undefined
-            ? JSON.stringify(result.structuredOutput)
-            : result.output,
-        ...(result.structuredOutput !== undefined ? { structured: result.structuredOutput } : {}),
-        agent: result.agent,
-        stepIndex,
-    };
-}

package/dist/runs/shared/child-attempt-types.js

@@ -1 +0,0 @@
-export {};