@sift-wiki/conductor 0.0.0 → 0.1.0

package/dist/runtime/localLogSpool.js

@@ -0,0 +1,101 @@
+const DEFAULT_MAX_ENTRIES_PER_RUN = 500;
+const DEFAULT_MAX_MESSAGE_CHARS = 8_000;
+const REDACTION = "[REDACTED]";
+export class LocalLogSpool {
+    maxEntriesPerRun;
+    maxMessageChars;
+    now;
+    entriesByRunId = new Map();
+    droppedEntriesByRunId = new Map();
+    nextId = 1;
+    constructor(options = {}) {
+        this.maxEntriesPerRun = positiveIntegerOrDefault(options.maxEntriesPerRun, DEFAULT_MAX_ENTRIES_PER_RUN);
+        this.maxMessageChars = positiveIntegerOrDefault(options.maxMessageChars, DEFAULT_MAX_MESSAGE_CHARS);
+        this.now = options.now ?? (() => new Date().toISOString());
+    }
+    append(input) {
+        const normalized = normalizeMessage(input.message, this.maxMessageChars);
+        const entry = {
+            id: `local-log-${String(this.nextId)}`,
+            runId: input.runId,
+            occurredAt: input.occurredAt ?? this.now(),
+            stream: input.stream ?? "system",
+            message: normalized.message,
+            redacted: normalized.redacted,
+            truncated: normalized.truncated,
+            droppedChars: normalized.droppedChars,
+            sessionDisplayId: input.sessionDisplayId,
+        };
+        this.nextId += 1;
+        const entries = this.entriesByRunId.get(input.runId) ?? [];
+        entries.push(entry);
+        const overLimit = entries.length - this.maxEntriesPerRun;
+        if (overLimit > 0) {
+            entries.splice(0, overLimit);
+            this.droppedEntriesByRunId.set(input.runId, (this.droppedEntriesByRunId.get(input.runId) ?? 0) + overLimit);
+        }
+        this.entriesByRunId.set(input.runId, entries);
+        return cloneEntry(entry);
+    }
+    list(runId) {
+        return (this.entriesByRunId.get(runId) ?? []).map((entry) => cloneEntry(entry));
+    }
+    stats(runId) {
+        return {
+            runId,
+            retainedEntries: this.entriesByRunId.get(runId)?.length ?? 0,
+            droppedEntries: this.droppedEntriesByRunId.get(runId) ?? 0,
+        };
+    }
+    clear(runId) {
+        this.entriesByRunId.delete(runId);
+        this.droppedEntriesByRunId.delete(runId);
+    }
+}
+export function redactLocalLogMessage(message) {
+    let redacted = false;
+    let output = message;
+    for (const pattern of SECRET_PATTERNS) {
+        output = output.replace(pattern, (...args) => {
+            redacted = true;
+            const prefix = typeof args[1] === "string" ? args[1] : undefined;
+            const suffix = typeof args[2] === "string" ? args[2] : "";
+            return prefix === undefined ? REDACTION : `${prefix}${REDACTION}${suffix}`;
+        });
+    }
+    return { message: output, redacted };
+}
+const SECRET_PATTERNS = [
+    /\bBearer\s+[A-Za-z0-9._~+/:-]+/gu,
+    /\bsift_conductor_[A-Za-z0-9._~+/:-]+/gu,
+    /\bSC-[A-Z0-9][A-Z0-9-]{4,}\b/gu,
+    /\b((?:SIFT_RUN_TOKEN|PAPERCLIP_API_KEY|PAPERCLIP_API_TOKEN)\s*=\s*)[^\s"'`]+/gu,
+    /("(?:runToken|credential|token|apiKey)"\s*:\s*")[^"]+(")/gu,
+];
+function normalizeMessage(message, maxMessageChars) {
+    const redacted = redactLocalLogMessage(message);
+    if (redacted.message.length <= maxMessageChars) {
+        return {
+            message: redacted.message,
+            redacted: redacted.redacted,
+            truncated: false,
+            droppedChars: 0,
+        };
+    }
+    return {
+        message: `${redacted.message.slice(0, maxMessageChars)}...[truncated]`,
+        redacted: redacted.redacted,
+        truncated: true,
+        droppedChars: redacted.message.length - maxMessageChars,
+    };
+}
+function positiveIntegerOrDefault(value, fallback) {
+    if (value === undefined || !Number.isInteger(value) || value < 1) {
+        return fallback;
+    }
+    return value;
+}
+function cloneEntry(entry) {
+    return { ...entry };
+}
+//# sourceMappingURL=localLogSpool.js.map

package/dist/runtime/localLogSpool.js.map

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

package/dist/runtime/localRunQueue.d.ts

@@ -0,0 +1,31 @@
+import type { LocalRuntimeSession } from "./localSessionCache.js";
+import type { ClaimedJob, JsonObject } from "../types.js";
+export type LocalRunQueueStatus = "claimed" | "starting" | "running" | "stopping" | "stopped" | "failed" | "completed" | "cancelled";
+export type LocalRunQueueItem = {
+    runId: string;
+    jobId: string;
+    conductorAgentId: string;
+    localKey: string;
+    adapterType: string;
+    status: LocalRunQueueStatus;
+    phase: string;
+    title: string;
+    contextRefs: string[];
+    limits: JsonObject;
+    wakeSource?: string | undefined;
+    wakeReason?: string | undefined;
+    taskId?: string | undefined;
+    priority?: string | undefined;
+    sessionDisplayId?: string | undefined;
+    cancelRequested: boolean;
+    updatedAt?: string | undefined;
+    siftLinks: {
+        runPath?: string | undefined;
+        taskPath?: string | undefined;
+    };
+};
+export declare function localRunQueueItemFromJob(input: {
+    job: ClaimedJob;
+    session?: LocalRuntimeSession | undefined;
+    siftAppBaseUrl?: string | undefined;
+}): LocalRunQueueItem;

package/dist/runtime/localRunQueue.js

@@ -0,0 +1,76 @@
+export function localRunQueueItemFromJob(input) {
+    const envelope = input.job.wakeEnvelope;
+    const task = readTask(envelope);
+    const status = statusFromSession(input.session);
+    const taskId = envelope?.task.id ?? input.job.taskRecordId;
+    return {
+        runId: input.job.runId,
+        jobId: input.job.id,
+        conductorAgentId: input.job.conductorAgentId,
+        localKey: input.job.localKey,
+        adapterType: input.job.adapterType,
+        status,
+        phase: phaseFromStatus(status),
+        title: task.title ?? input.job.objective,
+        contextRefs: envelope?.contextRefs ?? input.job.contextRefs,
+        limits: envelope?.limits ?? input.job.limits,
+        wakeSource: envelope?.wake.source,
+        wakeReason: envelope?.wake.reason,
+        taskId,
+        priority: task.priority,
+        sessionDisplayId: input.session?.sessionDisplayId,
+        cancelRequested: input.session?.cancelRequested ?? false,
+        updatedAt: input.session?.updatedAt,
+        siftLinks: buildSiftLinks({
+            baseUrl: input.siftAppBaseUrl,
+            runId: input.job.runId,
+            taskId,
+        }),
+    };
+}
+function readTask(envelope) {
+    const task = envelope?.task;
+    return {
+        title: typeof task?.title === "string" ? task.title : undefined,
+        priority: typeof task?.priority === "string" ? task.priority : undefined,
+    };
+}
+function statusFromSession(session) {
+    if (session === undefined) {
+        return "claimed";
+    }
+    return session.status;
+}
+function phaseFromStatus(status) {
+    switch (status) {
+        case "claimed":
+            return "Waiting to start";
+        case "starting":
+            return "Starting local runtime";
+        case "running":
+            return "Running locally";
+        case "stopping":
+            return "Stopping";
+        case "stopped":
+            return "Stopped";
+        case "failed":
+            return "Failed";
+        case "completed":
+            return "Completed";
+        case "cancelled":
+            return "Cancelled";
+    }
+}
+function buildSiftLinks(input) {
+    if (input.baseUrl === undefined || input.baseUrl.length === 0) {
+        return {};
+    }
+    const base = input.baseUrl.replace(/\/+$/u, "");
+    return {
+        runPath: `${base}/runs/${encodeURIComponent(input.runId)}`,
+        ...(input.taskId === undefined
+            ? {}
+            : { taskPath: `${base}/tasks/${encodeURIComponent(input.taskId)}` }),
+    };
+}
+//# sourceMappingURL=localRunQueue.js.map

package/dist/runtime/localRunQueue.js.map

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

package/dist/runtime/localSessionCache.d.ts

@@ -0,0 +1,26 @@
+import type { JsonObject } from "../types.js";
+export type LocalRuntimeSessionStatus = "starting" | "running" | "stopping" | "stopped" | "failed" | "completed" | "cancelled";
+export type LocalRuntimeSession = {
+    runId: string;
+    adapterType: string;
+    localKey: string;
+    status: LocalRuntimeSessionStatus;
+    localOnly: true;
+    updatedAt: string;
+    startedAt?: string | undefined;
+    stoppedAt?: string | undefined;
+    processId?: number | undefined;
+    sessionDisplayId?: string | undefined;
+    taskKey?: string | undefined;
+    cancelRequested?: boolean | undefined;
+    sessionParams?: JsonObject | undefined;
+    errorSummary?: JsonObject | undefined;
+};
+export declare class LocalRuntimeSessionCache {
+    private readonly sessions;
+    upsert(session: LocalRuntimeSession): LocalRuntimeSession;
+    read(runId: string): LocalRuntimeSession | undefined;
+    list(): LocalRuntimeSession[];
+    delete(runId: string): boolean;
+    clear(): void;
+}

package/dist/runtime/localSessionCache.js

@@ -0,0 +1,35 @@
+export class LocalRuntimeSessionCache {
+    sessions = new Map();
+    upsert(session) {
+        const copy = cloneSession(session);
+        this.sessions.set(copy.runId, copy);
+        return cloneSession(copy);
+    }
+    read(runId) {
+        const session = this.sessions.get(runId);
+        return session === undefined ? undefined : cloneSession(session);
+    }
+    list() {
+        return [...this.sessions.values()]
+            .map((session) => cloneSession(session))
+            .sort((left, right) => left.updatedAt.localeCompare(right.updatedAt));
+    }
+    delete(runId) {
+        return this.sessions.delete(runId);
+    }
+    clear() {
+        this.sessions.clear();
+    }
+}
+function cloneSession(session) {
+    return {
+        ...session,
+        ...(session.sessionParams === undefined
+            ? {}
+            : { sessionParams: structuredClone(session.sessionParams) }),
+        ...(session.errorSummary === undefined
+            ? {}
+            : { errorSummary: structuredClone(session.errorSummary) }),
+    };
+}
+//# sourceMappingURL=localSessionCache.js.map

package/dist/runtime/localSessionCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localSessionCache.js","sourceRoot":"","sources":["../../src/runtime/localSessionCache.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,wBAAwB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEnE,MAAM,CAAC,OAA4B;QACjC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;aAC/B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;aACvC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAED,SAAS,YAAY,CAAC,OAA4B;IAChD,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/runtime/process.d.ts

@@ -0,0 +1,27 @@
+import { type ChildProcess, type SpawnOptions } from "node:child_process";
+export type ProcessLogStream = "stdout" | "stderr";
+export type RunProcessInput = {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    stdin?: string | undefined;
+    timeoutMs: number;
+    graceMs: number;
+    outputLimitBytes: number;
+    signal: AbortSignal;
+    onLog(stream: ProcessLogStream, chunk: string): Promise<void>;
+};
+export type RunProcessResult = {
+    exitCode: number | null;
+    signal: string | null;
+    timedOut: boolean;
+    stdout: string;
+    stderr: string;
+    pid: number | null;
+    startedAt: string;
+};
+export type RunProcess = (input: RunProcessInput) => Promise<RunProcessResult>;
+export type SpawnLike = (command: string, args: string[], options: SpawnOptions) => ChildProcess;
+export declare function createProcessRunner(spawn?: SpawnLike): RunProcess;
+export declare const runChildProcess: RunProcess;

package/dist/runtime/process.js

@@ -0,0 +1,128 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { Buffer } from "node:buffer";
+export function createProcessRunner(spawn = nodeSpawn) {
+    return (input) => runChildProcessWithSpawn(input, spawn);
+}
+export const runChildProcess = createProcessRunner();
+async function runChildProcessWithSpawn(input, spawn) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(input.command, input.args, {
+            cwd: input.cwd,
+            env: {
+                ...process.env,
+                ...input.env,
+            },
+            detached: process.platform !== "win32",
+            shell: false,
+            stdio: [input.stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+        });
+        const startedAt = new Date().toISOString();
+        const processGroupId = resolveProcessGroupId(child);
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let closed = false;
+        let logChain = Promise.resolve();
+        let timeout;
+        let killTimeout;
+        const requestStop = (reason) => {
+            if (closed) {
+                return;
+            }
+            if (reason === "timeout") {
+                timedOut = true;
+            }
+            signalRunningProcess(child, processGroupId, "SIGTERM");
+            killTimeout ??= setTimeout(() => {
+                signalRunningProcess(child, processGroupId, "SIGKILL");
+            }, Math.max(1, input.graceMs));
+        };
+        const onAbort = () => requestStop("abort");
+        input.signal.addEventListener("abort", onAbort, { once: true });
+        if (input.signal.aborted) {
+            requestStop("abort");
+        }
+        if (input.timeoutMs > 0) {
+            timeout = setTimeout(() => requestStop("timeout"), input.timeoutMs);
+        }
+        if (input.stdin !== undefined) {
+            child.stdin?.end(input.stdin);
+        }
+        child.stdout?.on("data", (chunk) => {
+            const text = chunkToString(chunk);
+            stdout = appendWithByteCap(stdout, text, input.outputLimitBytes);
+            logChain = logChain
+                .then(() => input.onLog("stdout", text))
+                .catch(() => undefined);
+        });
+        child.stderr?.on("data", (chunk) => {
+            const text = chunkToString(chunk);
+            stderr = appendWithByteCap(stderr, text, input.outputLimitBytes);
+            logChain = logChain
+                .then(() => input.onLog("stderr", text))
+                .catch(() => undefined);
+        });
+        child.on("error", (error) => {
+            cleanup();
+            reject(error);
+        });
+        child.on("close", (code, closeSignal) => {
+            closed = true;
+            cleanup();
+            void logChain.finally(() => {
+                resolve({
+                    exitCode: code,
+                    signal: closeSignal,
+                    timedOut,
+                    stdout,
+                    stderr,
+                    pid: child.pid ?? null,
+                    startedAt,
+                });
+            });
+        });
+        function cleanup() {
+            input.signal.removeEventListener("abort", onAbort);
+            if (timeout !== undefined) {
+                clearTimeout(timeout);
+            }
+            if (killTimeout !== undefined) {
+                clearTimeout(killTimeout);
+            }
+        }
+    });
+}
+function resolveProcessGroupId(child) {
+    if (process.platform === "win32") {
+        return null;
+    }
+    return typeof child.pid === "number" && child.pid > 0 ? child.pid : null;
+}
+function signalRunningProcess(child, processGroupId, signal) {
+    if (process.platform !== "win32" && processGroupId !== null) {
+        try {
+            process.kill(-processGroupId, signal);
+            return;
+        }
+        catch {
+            // Fall through to direct child signaling.
+        }
+    }
+    if (!child.killed) {
+        child.kill(signal);
+    }
+}
+function chunkToString(chunk) {
+    return Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+}
+function appendWithByteCap(existing, chunk, limitBytes) {
+    if (Buffer.byteLength(existing, "utf8") >= limitBytes) {
+        return existing;
+    }
+    const candidate = `${existing}${chunk}`;
+    if (Buffer.byteLength(candidate, "utf8") <= limitBytes) {
+        return candidate;
+    }
+    return Buffer.from(candidate, "utf8").subarray(0, limitBytes).toString("utf8");
+}
+//# sourceMappingURL=process.js.map

package/dist/runtime/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/runtime/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAwC,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA8BrC,MAAM,UAAU,mBAAmB,CAAC,QAAmB,SAAS;IAC9D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,EAAE,CAAC;AAErD,KAAK,UAAU,wBAAwB,CAAC,KAAsB,EAAE,KAAgB;IAC9E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;YAC7C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,KAAK,CAAC,GAAG;aACb;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACtC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SACvE,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,QAAQ,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;QAChD,IAAI,OAAmC,CAAC;QACxC,IAAI,WAAuC,CAAC;QAE5C,MAAM,WAAW,GAAG,CAAC,MAA2B,EAAE,EAAE;YAClD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;YACvD,WAAW,KAAK,UAAU,CAAC,GAAG,EAAE;gBAC9B,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACjE,QAAQ,GAAG,QAAQ;iBAChB,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;iBACvC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACjE,QAAQ,GAAG,QAAQ;iBAChB,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;iBACvC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;YACtC,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,EAAE,CAAC;YACV,KAAK,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;gBACzB,OAAO,CAAC;oBACN,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,WAAW;oBACnB,QAAQ;oBACR,MAAM;oBACN,MAAM;oBACN,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,IAAI;oBACtB,SAAS;iBACV,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,SAAS,OAAO;YACd,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,YAAY,CAAC,WAAW,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAmB;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAmB,EACnB,cAA6B,EAC7B,MAAsB;IAEtB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,KAAa,EAAE,UAAkB;IAC5E,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,QAAQ,GAAG,KAAK,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC"}

package/dist/runtime/runEnvironment.d.ts

@@ -0,0 +1,12 @@
+import type { LocalAgentRunJob } from "../adapters/types.js";
+import type { SiftWakeEnvelope } from "./wakeEnvelope.js";
+export type RunEnvironmentInput = {
+    job?: LocalAgentRunJob | undefined;
+    wakeEnvelope?: SiftWakeEnvelope | undefined;
+    includePaperclipAliases?: boolean | undefined;
+    bridgeBaseUrl?: string | undefined;
+    bridgeToken?: string | undefined;
+};
+export declare function buildRunEnvironment(input: RunEnvironmentInput): Record<string, string>;
+export declare function buildSiftRunEnvironment(input: RunEnvironmentInput): Record<string, string>;
+export declare function buildPaperclipAliasEnvironment(siftEnv: Record<string, string>): Record<string, string>;

package/dist/runtime/runEnvironment.js

@@ -0,0 +1,59 @@
+export function buildRunEnvironment(input) {
+    const env = buildSiftRunEnvironment(input);
+    if (input.includePaperclipAliases === true) {
+        return {
+            ...env,
+            ...buildPaperclipAliasEnvironment(env),
+        };
+    }
+    return env;
+}
+export function buildSiftRunEnvironment(input) {
+    const env = {};
+    const envelope = input.wakeEnvelope;
+    const job = input.job;
+    setIfPresent(env, "SIFT_AGENT_ID", envelope?.agentPrincipalId);
+    setIfPresent(env, "SIFT_WORKSPACE_ID", envelope?.workspaceId);
+    setIfPresent(env, "SIFT_BRAIN_ID", envelope?.brainId);
+    setIfPresent(env, "SIFT_TASK_ID", envelope?.task.id ?? job?.taskRecordId);
+    setIfPresent(env, "SIFT_RUN_ID", envelope?.runId ?? job?.runId);
+    setIfPresent(env, "SIFT_CONDUCTOR_AGENT_ID", job?.conductorAgentId);
+    setIfPresent(env, "SIFT_API_URL", input.bridgeBaseUrl);
+    setIfPresent(env, "SIFT_RUN_TOKEN", input.bridgeToken);
+    setIfPresent(env, "SIFT_WAKE_SOURCE", envelope?.wake.source);
+    setIfPresent(env, "SIFT_WAKE_REASON", envelope?.wake.reason);
+    if (envelope !== undefined) {
+        env.SIFT_WAKE_PAYLOAD_JSON = JSON.stringify({
+            task: envelope.task,
+            wake: envelope.wake,
+            comments: envelope.comments,
+            blockers: envelope.blockers,
+            pendingApproval: envelope.pendingApproval ?? null,
+            contextRefs: envelope.contextRefs,
+            limits: envelope.limits,
+        });
+    }
+    return env;
+}
+export function buildPaperclipAliasEnvironment(siftEnv) {
+    const aliases = {};
+    aliasIfPresent(aliases, "PAPERCLIP_AGENT_ID", siftEnv.SIFT_AGENT_ID);
+    aliasIfPresent(aliases, "PAPERCLIP_COMPANY_ID", siftEnv.SIFT_WORKSPACE_ID);
+    aliasIfPresent(aliases, "PAPERCLIP_TASK_ID", siftEnv.SIFT_TASK_ID);
+    aliasIfPresent(aliases, "PAPERCLIP_RUN_ID", siftEnv.SIFT_RUN_ID);
+    aliasIfPresent(aliases, "PAPERCLIP_API_URL", siftEnv.SIFT_API_URL);
+    aliasIfPresent(aliases, "PAPERCLIP_API_KEY", siftEnv.SIFT_RUN_TOKEN);
+    aliasIfPresent(aliases, "PAPERCLIP_WAKE_PAYLOAD_JSON", siftEnv.SIFT_WAKE_PAYLOAD_JSON);
+    return aliases;
+}
+function setIfPresent(env, key, value) {
+    if (value !== undefined && value.length > 0) {
+        env[key] = value;
+    }
+}
+function aliasIfPresent(env, key, value) {
+    if (value !== undefined && value.length > 0) {
+        env[key] = value;
+    }
+}
+//# sourceMappingURL=runEnvironment.js.map

package/dist/runtime/runEnvironment.js.map

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

package/dist/runtime/runEventRetryBuffer.d.ts

@@ -0,0 +1,42 @@
+import type { RunEventInput } from "../types.js";
+export type BufferedRunEvent = {
+    id: string;
+    runId: string;
+    event: RunEventInput;
+    attempts: number;
+    enqueuedAt: number;
+    nextAttemptAt: number;
+    lastErrorMessage?: string | undefined;
+};
+export type RunEventRetryBufferOptions = {
+    maxEntries?: number | undefined;
+    retryDelayMs?: number | undefined;
+    nowMs?: (() => number) | undefined;
+};
+export type EnqueueRunEventInput = {
+    runId: string;
+    event: RunEventInput;
+    error?: unknown;
+};
+export type RunEventRetryBufferStats = {
+    retainedEntries: number;
+    droppedEntries: number;
+};
+export declare class RunEventRetryBuffer {
+    private readonly maxEntries;
+    private readonly retryDelayMs;
+    private readonly nowMs;
+    private readonly entries;
+    private nextId;
+    private droppedEntries;
+    constructor(options?: RunEventRetryBufferOptions);
+    enqueue(input: EnqueueRunEventInput): BufferedRunEvent;
+    list(): BufferedRunEvent[];
+    due(nowMs?: number): BufferedRunEvent[];
+    stats(): RunEventRetryBufferStats;
+    recordDelivered(id: string): boolean;
+    recordFailure(id: string, error: unknown): boolean;
+    flushDue(deliver: (entry: BufferedRunEvent) => Promise<void>, nowMs?: number): Promise<void>;
+    clear(): void;
+    private enforceBounds;
+}