pi-worker-graph 0.1.0-dev.0

package/dist/output.js

@@ -0,0 +1,248 @@
+export const NODE_OUTPUT_SCHEMA_VERSION = 1;
+export const NODE_OUTPUT_LIMITS = Object.freeze({
+    maxBytes: 96 * 1024,
+    maxItemsPerSection: 128,
+    maxTextBytes: 16 * 1024,
+    maxPathBytes: 4 * 1024,
+    maxDiagnosticsBytes: 16 * 1024,
+    /**
+     * Supplemental long-form text a worker may retain beside its report. It is
+     * not part of the report envelope and is not counted against `maxBytes`:
+     * the runtime never parses it and never places it on a dependency edge.
+     */
+    maxArtifactBytes: 128 * 1024,
+});
+export class NodeOutputValidationError extends Error {
+    code;
+    path;
+    constructor(code, path, message) {
+        super(`Invalid node output at ${path}: ${message}`);
+        this.name = "NodeOutputValidationError";
+        this.code = code;
+        this.path = path;
+    }
+}
+const OUTPUT_FIELDS = new Set([
+    "schemaVersion",
+    "summary",
+    "changedFiles",
+    "interfaces",
+    "decisions",
+    "validation",
+    "blockers",
+]);
+const CHANGED_FILE_FIELDS = new Set(["path", "description"]);
+const VALIDATION_FIELDS = new Set(["command", "result"]);
+const SIMPLE_FIELD = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const WINDOWS_DRIVE_PATH = /^[A-Za-z]:/;
+function fail(code, path, message) {
+    throw new NodeOutputValidationError(code, path, message);
+}
+function fieldPath(path, field) {
+    return field.length <= 64 && SIMPLE_FIELD.test(field)
+        ? `${path}.${field}`
+        : path;
+}
+function dataFields(value, path, maxFields) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return fail("invalid_field", path, "expected an object");
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        return fail("invalid_value", path, "expected a plain object");
+    }
+    const keys = Reflect.ownKeys(value);
+    if (keys.length > maxFields) {
+        fail("unknown_field", path, "object contains too many fields");
+    }
+    const fields = new Map();
+    for (const key of keys) {
+        if (typeof key !== "string") {
+            fail("invalid_value", path, "symbol fields are not allowed");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined ||
+            !descriptor.enumerable ||
+            !("value" in descriptor)) {
+            fail("invalid_value", fieldPath(path, key), "expected a data field");
+        }
+        fields.set(key, descriptor.value);
+    }
+    return fields;
+}
+function exactFields(value, expected, path) {
+    const fields = dataFields(value, path, expected.size + 1);
+    for (const field of expected) {
+        if (!fields.has(field)) {
+            fail("missing_field", `${path}.${field}`, "field is required");
+        }
+    }
+    for (const field of [...fields.keys()].sort()) {
+        if (!expected.has(field)) {
+            fail("unknown_field", fieldPath(path, field), "field is not allowed");
+        }
+    }
+    return fields;
+}
+function arrayItems(value, path) {
+    if (!Array.isArray(value)) {
+        return fail("invalid_field", path, "expected an array");
+    }
+    if (Object.getPrototypeOf(value) !== Array.prototype) {
+        return fail("invalid_value", path, "expected a plain array");
+    }
+    const lengthDescriptor = Object.getOwnPropertyDescriptor(value, "length");
+    if (lengthDescriptor === undefined ||
+        !("value" in lengthDescriptor) ||
+        !Number.isInteger(lengthDescriptor.value) ||
+        lengthDescriptor.value < 0) {
+        return fail("invalid_value", path, "array has an invalid length");
+    }
+    const length = lengthDescriptor.value;
+    if (length > NODE_OUTPUT_LIMITS.maxItemsPerSection) {
+        fail("item_limit", path, `section exceeds ${NODE_OUTPUT_LIMITS.maxItemsPerSection} items`);
+    }
+    const keys = Reflect.ownKeys(value);
+    if (keys.length !== length + 1 || !keys.includes("length")) {
+        fail("invalid_value", path, "expected a dense array without extra fields");
+    }
+    const items = [];
+    for (let index = 0; index < length; index += 1) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (descriptor === undefined ||
+            !descriptor.enumerable ||
+            !("value" in descriptor)) {
+            fail("invalid_value", `${path}[${index}]`, "expected a data item");
+        }
+        items.push(descriptor.value);
+    }
+    return items;
+}
+function text(value, path, maxBytes, budget) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return fail("invalid_field", path, "expected a non-empty string");
+    }
+    if (Buffer.byteLength(value) > maxBytes) {
+        fail("text_limit", path, `text exceeds ${maxBytes} bytes`);
+    }
+    budget.serializedTextBytes += Buffer.byteLength(JSON.stringify(value));
+    if (budget.serializedTextBytes > NODE_OUTPUT_LIMITS.maxBytes) {
+        fail("output_limit", "$", `serialized report exceeds ${NODE_OUTPUT_LIMITS.maxBytes} bytes`);
+    }
+    return value;
+}
+function reportPath(value, path, budget) {
+    const parsed = text(value, path, NODE_OUTPUT_LIMITS.maxPathBytes, budget);
+    const segments = parsed.split("/");
+    if (parsed.startsWith("/") ||
+        parsed.includes("\\") ||
+        WINDOWS_DRIVE_PATH.test(parsed) ||
+        [...parsed].some((character) => {
+            const code = character.codePointAt(0);
+            return code !== undefined && (code <= 0x1f || code === 0x7f);
+        }) ||
+        segments.some((segment) => segment.length === 0 || segment === "." || segment === "..")) {
+        fail("invalid_field", path, "expected a normalized repository-relative path");
+    }
+    return parsed;
+}
+function textSection(value, path, budget) {
+    return Object.freeze(arrayItems(value, path).map((item, index) => text(item, `${path}[${index}]`, NODE_OUTPUT_LIMITS.maxTextBytes, budget)));
+}
+function parseReport(value) {
+    const budget = { serializedTextBytes: 0 };
+    const candidate = exactFields(value, OUTPUT_FIELDS, "$");
+    if (candidate.get("schemaVersion") !== NODE_OUTPUT_SCHEMA_VERSION) {
+        fail("invalid_schema_version", "$.schemaVersion", `expected schema version ${NODE_OUTPUT_SCHEMA_VERSION}`);
+    }
+    const changedFiles = Object.freeze(arrayItems(candidate.get("changedFiles"), "$.changedFiles").map((item, index) => {
+        const path = `$.changedFiles[${index}]`;
+        const changedFile = exactFields(item, CHANGED_FILE_FIELDS, path);
+        return Object.freeze({
+            path: reportPath(changedFile.get("path"), `${path}.path`, budget),
+            description: text(changedFile.get("description"), `${path}.description`, NODE_OUTPUT_LIMITS.maxTextBytes, budget),
+        });
+    }));
+    const validation = Object.freeze(arrayItems(candidate.get("validation"), "$.validation").map((item, index) => {
+        const path = `$.validation[${index}]`;
+        const result = exactFields(item, VALIDATION_FIELDS, path);
+        return Object.freeze({
+            command: text(result.get("command"), `${path}.command`, NODE_OUTPUT_LIMITS.maxTextBytes, budget),
+            result: text(result.get("result"), `${path}.result`, NODE_OUTPUT_LIMITS.maxTextBytes, budget),
+        });
+    }));
+    const output = Object.freeze({
+        schemaVersion: NODE_OUTPUT_SCHEMA_VERSION,
+        summary: text(candidate.get("summary"), "$.summary", NODE_OUTPUT_LIMITS.maxTextBytes, budget),
+        changedFiles,
+        interfaces: textSection(candidate.get("interfaces"), "$.interfaces", budget),
+        decisions: textSection(candidate.get("decisions"), "$.decisions", budget),
+        validation,
+        blockers: textSection(candidate.get("blockers"), "$.blockers", budget),
+    });
+    if (Buffer.byteLength(JSON.stringify(output)) > NODE_OUTPUT_LIMITS.maxBytes) {
+        fail("output_limit", "$", `serialized report exceeds ${NODE_OUTPUT_LIMITS.maxBytes} bytes`);
+    }
+    return output;
+}
+/** Validates an untrusted worker report and returns an immutable snapshot. */
+export function parseNodeOutput(value) {
+    try {
+        return parseReport(value);
+    }
+    catch (error) {
+        if (error instanceof NodeOutputValidationError)
+            throw error;
+        return fail("invalid_value", "$", "value cannot be inspected safely");
+    }
+}
+/**
+ * Splits a submitted worker report into the report envelope and the optional
+ * artifact submitted beside it.
+ *
+ * The split reads the value through the same field discipline
+ * `parseNodeOutput` applies, before reading anything: an exotic prototype, a
+ * symbol key, and an accessor property are rejected here rather than invoked.
+ * Separating the artifact must never become a way past that check, which a
+ * rest-destructuring of the submitted value would be.
+ */
+export function splitReportArtifact(value) {
+    const fields = dataFields(value, "$", OUTPUT_FIELDS.size + 2);
+    const report = {};
+    for (const [field, item] of fields) {
+        if (field !== "artifact")
+            report[field] = item;
+    }
+    return { report, artifact: fields.get("artifact") };
+}
+/**
+ * Internal shared validation for a retained text artifact, at every boundary
+ * it crosses: the worker report tool, the adapter that reads a child's tool
+ * result, the graph runner, and the store that publishes it.
+ */
+export function parseNodeArtifact(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return fail("invalid_field", "$.artifact", "expected non-blank text");
+    }
+    if (Buffer.byteLength(value) > NODE_OUTPUT_LIMITS.maxArtifactBytes) {
+        fail("text_limit", "$.artifact", `artifact exceeds ${NODE_OUTPUT_LIMITS.maxArtifactBytes} bytes`);
+    }
+    return value;
+}
+/** Internal shared validation for persisted and executor diagnostics. */
+export function parseNodeDiagnostics(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        return fail("invalid_field", "$.diagnostics", "expected a string");
+    }
+    if (Buffer.byteLength(value) > NODE_OUTPUT_LIMITS.maxDiagnosticsBytes ||
+        Buffer.byteLength(JSON.stringify(value)) >
+            NODE_OUTPUT_LIMITS.maxDiagnosticsBytes) {
+        fail("text_limit", "$.diagnostics", `diagnostics exceed ${NODE_OUTPUT_LIMITS.maxDiagnosticsBytes} bytes`);
+    }
+    return value;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/pi-subprocess.d.ts

@@ -0,0 +1,92 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
+import { spawn } from "node:child_process";
+import type { TaskExecutionInput, TaskExecutionResult, TaskExecutor } from "./run.js";
+import type { TaskUsage } from "./usage.js";
+declare const REPORT_TOOL_NAME = "worker_graph_report";
+/**
+ * Registered by the child extension only when the worker receives run-scoped
+ * coordination, so they are allowlisted on exactly the same condition: Pi's
+ * `--tools` is a strict allowlist over built-in, extension, and custom tools.
+ */
+declare const COORDINATION_TOOL_NAMES: readonly ["worker_graph_event", "worker_graph_events", "worker_graph_message", "worker_graph_inbox"];
+export type PiThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+/**
+ * Pi's own session thinking levels, which have no `off`. A worker is a fresh
+ * one-shot subprocess, so `off` is expressible there; the parent's level is set
+ * on a live session through an API that cannot express it.
+ */
+export type PiSessionThinkingLevel = Exclude<PiThinkingLevel, "off">;
+export type PiWorkerTool = "read" | "bash" | "powershell" | "edit" | "write" | "grep" | "find" | "ls";
+export type PiWorkerCoordinationTool = (typeof COORDINATION_TOOL_NAMES)[number];
+type ProgressTool = PiWorkerTool | PiWorkerCoordinationTool | typeof REPORT_TOOL_NAME;
+export interface PiWorkerProfile {
+    readonly provider: string;
+    readonly model: string;
+    readonly thinkingLevel: PiThinkingLevel;
+    readonly tools: readonly PiWorkerTool[];
+}
+/**
+ * The adapter reports the runtime's own usage shape; the alias keeps the
+ * transport-facing name without a second definition of it.
+ */
+export type PiWorkerUsage = TaskUsage;
+export type PiWorkerProgressPhase = "started" | "turn_completed" | "tool_started" | "tool_completed" | "finished";
+export interface PiWorkerProgress {
+    readonly taskId: string;
+    readonly phase: PiWorkerProgressPhase;
+    readonly tool?: ProgressTool;
+    readonly status?: "succeeded" | "failed" | "aborted";
+    readonly usage: PiWorkerUsage;
+}
+export interface PiSubprocessExecutorOptions {
+    readonly profiles: Readonly<Record<string, PiWorkerProfile>>;
+    readonly command?: string;
+    readonly extensionPath?: string;
+    readonly onProgress?: (progress: PiWorkerProgress) => void;
+}
+export interface PiWorkerTaskPayload {
+    readonly assignment: string;
+    readonly profile: string;
+    readonly acceptanceCriteria?: readonly string[];
+    readonly expectedPaths?: readonly string[];
+}
+interface ProcessDependencies {
+    readonly spawnProcess?: typeof spawn;
+    readonly terminateProcessTree?: (child: ChildProcessWithoutNullStreams, force: boolean) => void;
+    readonly terminationGraceMs?: number;
+}
+/** Internal strict profile parser shared with the Pi configuration layer. */
+export declare function parsePiWorkerProfiles(value: unknown): Readonly<Record<string, PiWorkerProfile>>;
+/**
+ * The parent session's provider, model, and thinking level.
+ *
+ * This selects nothing to spawn. It names what the orchestrator session itself
+ * should run as while the mode is active, so it carries no tool allowlist: the
+ * parent's tools are governed by its own snapshot and the tools the mode
+ * suppresses.
+ */
+export interface PiOrchestratorProfile {
+    readonly provider: string;
+    readonly model: string;
+    readonly thinkingLevel: PiSessionThinkingLevel;
+}
+/** Internal strict parent parser shared with the Pi configuration layer. */
+export declare function parsePiOrchestratorProfile(value: unknown): PiOrchestratorProfile;
+/**
+ * Internal fakeable subprocess boundary used by adapter tests.
+ *
+ * Rejects rather than throwing for every invalid input, so one `catch` covers
+ * both validation and execution.
+ */
+export declare function runPiWorkerProcess(input: TaskExecutionInput, options: PiSubprocessExecutorOptions, dependencies?: ProcessDependencies): Promise<TaskExecutionResult>;
+/**
+ * Builds a `TaskExecutor` that runs each task in its own Pi subprocess.
+ *
+ * Profile configuration is validated eagerly and throws, because it is a
+ * construction error in the caller's own configuration. Everything the executor
+ * itself rejects — an invalid assignment, an unknown profile, a failed worker —
+ * is reported by rejecting the returned promise.
+ */
+export declare function createPiSubprocessExecutor(options: PiSubprocessExecutorOptions): TaskExecutor;
+export {};
+//# sourceMappingURL=pi-subprocess.d.ts.map

package/dist/pi-subprocess.d.ts.map

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