@stigmer/runner 3.0.1

package/dist/activities/promote-task-output.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Activity: Promote large task outputs to the Artifact store (T07).
+ *
+ * When a task's serialized output exceeds the promotion threshold (256KB),
+ * this activity calls ArtifactCommandController.create() to persist the
+ * content as a first-class Artifact resource, then replaces the inline
+ * output with an artifact reference.
+ *
+ * This runs as a Temporal LOCAL activity (short-lived, in-process I/O)
+ * because the gRPC call to the Stigmer server is fast and the data is
+ * already in memory.
+ *
+ * Called from the workflow sandbox via proxyLocalActivities.
+ */
+export interface PromoteTaskOutputResult {
+    /** The output to use (original if small, artifact reference if promoted). */
+    output: unknown;
+    /** Artifact IDs created during promotion (empty if no promotion). */
+    artifactIds: string[];
+    /** Event descriptors for artifact_created events (empty if no promotion). */
+    artifactCreatedEvents: ArtifactCreatedEventDescriptor[];
+}
+export interface ArtifactCreatedEventDescriptor {
+    type: "artifact_created";
+    artifactId: string;
+    displayName: string;
+    contentType: string;
+    sizeBytes: number;
+    occurredAt: string;
+}
+export declare function createPromoteTaskOutputActivities(): {
+    /**
+     * Check if a task output should be promoted to an artifact. If the
+     * serialized JSON exceeds the threshold, create an artifact via gRPC
+     * and return a reference.
+     */
+    PromoteTaskOutput(taskOutput: unknown, workflowExecutionId: string, taskName: string): Promise<PromoteTaskOutputResult>;
+};

package/dist/activities/promote-task-output.js

@@ -0,0 +1,90 @@
+/**
+ * Activity: Promote large task outputs to the Artifact store (T07).
+ *
+ * When a task's serialized output exceeds the promotion threshold (256KB),
+ * this activity calls ArtifactCommandController.create() to persist the
+ * content as a first-class Artifact resource, then replaces the inline
+ * output with an artifact reference.
+ *
+ * This runs as a Temporal LOCAL activity (short-lived, in-process I/O)
+ * because the gRPC call to the Stigmer server is fast and the data is
+ * already in memory.
+ *
+ * Called from the workflow sandbox via proxyLocalActivities.
+ */
+import { StigmerClient } from "../client/stigmer-client.js";
+import { loadConfig } from "../config.js";
+import { create } from "@bufbuild/protobuf";
+import { CreateArtifactInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/io_pb";
+import { ArtifactSpecSchema, ArtifactSourceSchema, } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/spec_pb";
+const PROMOTION_THRESHOLD_BYTES = 256 * 1024; // 256 KB
+let cachedClient = null;
+function getClient() {
+    if (!cachedClient) {
+        const config = loadConfig();
+        cachedClient = new StigmerClient({
+            endpoint: config.stigmerBackendEndpoint,
+            token: config.stigmerToken,
+        });
+    }
+    return cachedClient;
+}
+export function createPromoteTaskOutputActivities() {
+    return {
+        /**
+         * Check if a task output should be promoted to an artifact. If the
+         * serialized JSON exceeds the threshold, create an artifact via gRPC
+         * and return a reference.
+         */
+        async PromoteTaskOutput(taskOutput, workflowExecutionId, taskName) {
+            if (taskOutput === undefined || taskOutput === null) {
+                return { output: taskOutput, artifactIds: [], artifactCreatedEvents: [] };
+            }
+            let serialized;
+            try {
+                serialized = JSON.stringify(taskOutput);
+            }
+            catch {
+                return { output: taskOutput, artifactIds: [], artifactCreatedEvents: [] };
+            }
+            const byteLength = Buffer.byteLength(serialized, "utf-8");
+            if (byteLength < PROMOTION_THRESHOLD_BYTES) {
+                return { output: taskOutput, artifactIds: [], artifactCreatedEvents: [] };
+            }
+            const displayName = `${taskName} — output.json`;
+            const contentType = "application/json";
+            const contentBytes = Buffer.from(serialized, "utf-8");
+            const input = create(CreateArtifactInputSchema, {
+                spec: create(ArtifactSpecSchema, {
+                    contentType,
+                    displayName,
+                    source: create(ArtifactSourceSchema, {
+                        workflowExecutionId,
+                        taskName,
+                    }),
+                }),
+                content: new Uint8Array(contentBytes),
+            });
+            const artifact = await getClient().createArtifact(input);
+            const artifactId = artifact.metadata?.id ?? "";
+            return {
+                output: {
+                    _artifact_ref: artifactId,
+                    display_name: displayName,
+                    content_type: contentType,
+                    size_bytes: byteLength,
+                },
+                artifactIds: [artifactId],
+                artifactCreatedEvents: [{
+                        type: "artifact_created",
+                        artifactId,
+                        displayName,
+                        contentType,
+                        sizeBytes: byteLength,
+                        occurredAt: new Date().toISOString(),
+                    }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=promote-task-output.js.map

package/dist/activities/promote-task-output.js.map

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

package/dist/activities/run-command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Run command activities — executes scripts and shell commands.
+ *
+ * Two activity functions:
+ * - RunScript: writes inline code to a temp file, executes via node/python
+ * - RunShell: executes a shell command directly
+ *
+ * Both resolve runtime placeholders (JIT secrets) before execution
+ * and capture stdout as the activity result.
+ */
+import type { RunCommandConfig } from "../workflow-engine/types.js";
+export declare function createRunCommandActivities(): {
+    RunScript(config: RunCommandConfig): Promise<unknown>;
+    RunShell(config: RunCommandConfig): Promise<unknown>;
+};

package/dist/activities/run-command.js

@@ -0,0 +1,123 @@
+/**
+ * Run command activities — executes scripts and shell commands.
+ *
+ * Two activity functions:
+ * - RunScript: writes inline code to a temp file, executes via node/python
+ * - RunShell: executes a shell command directly
+ *
+ * Both resolve runtime placeholders (JIT secrets) before execution
+ * and capture stdout as the activity result.
+ */
+import { execFile, exec } from "node:child_process";
+import { writeFile, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { ApplicationFailure } from "@temporalio/activity";
+import { startHeartbeat } from "../shared/heartbeat.js";
+const execFileAsync = promisify(execFile);
+const execAsync = promisify(exec);
+export function createRunCommandActivities() {
+    return {
+        async RunScript(config) {
+            const hb = startHeartbeat(10_000, () => ({ phase: "running_script" }));
+            try {
+                return await runScriptImpl(config);
+            }
+            finally {
+                hb.stop();
+            }
+        },
+        async RunShell(config) {
+            const hb = startHeartbeat(10_000, () => ({ phase: "running_shell" }));
+            try {
+                return await runShellImpl(config);
+            }
+            finally {
+                hb.stop();
+            }
+        },
+    };
+}
+async function runScriptImpl(config) {
+    if (config.mode !== "script") {
+        throw ApplicationFailure.nonRetryable("RunScript called with non-script config");
+    }
+    const language = config.language;
+    const code = config.code;
+    const env = buildEnv(config.environment);
+    const ext = language === "js" ? ".js" : ".py";
+    const interpreter = language === "js" ? "node" : "python3";
+    let tempDir;
+    try {
+        tempDir = await mkdtemp(join(tmpdir(), "stigmer-run-"));
+        const scriptPath = join(tempDir, `script${ext}`);
+        await writeFile(scriptPath, code, { mode: 0o600 });
+        const args = buildArgsList(config.arguments);
+        const { stdout } = await execFileAsync(interpreter, [scriptPath, ...args], {
+            env,
+            timeout: 300_000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return stdout.trim();
+    }
+    catch (err) {
+        if (isExecError(err)) {
+            throw ApplicationFailure.nonRetryable(`Script execution failed (exit code ${err.code})`, "SCRIPT_EXECUTION_FAILED", { stderr: err.stderr, stdout: err.stdout, code: err.code });
+        }
+        throw err;
+    }
+    finally {
+        if (tempDir) {
+            await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+async function runShellImpl(config) {
+    if (config.mode !== "shell") {
+        throw ApplicationFailure.nonRetryable("RunShell called with non-shell config");
+    }
+    const command = config.command;
+    const args = buildArgsList(config.arguments);
+    const fullCommand = args.length > 0
+        ? `${command} ${args.join(" ")}`
+        : command;
+    const env = buildEnv(config.environment);
+    try {
+        const { stdout } = await execAsync(fullCommand, {
+            env,
+            timeout: 300_000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return stdout.trim();
+    }
+    catch (err) {
+        if (isExecError(err)) {
+            throw ApplicationFailure.nonRetryable(`Shell command failed (exit code ${err.code})`, "SHELL_EXECUTION_FAILED", { stderr: err.stderr, stdout: err.stdout, code: err.code });
+        }
+        throw err;
+    }
+}
+function buildEnv(taskEnv) {
+    const base = { ...process.env };
+    if (taskEnv) {
+        for (const [k, v] of Object.entries(taskEnv)) {
+            base[k] = v;
+        }
+    }
+    return base;
+}
+function buildArgsList(args) {
+    if (!args)
+        return [];
+    if (Array.isArray(args))
+        return args.map(String);
+    if (typeof args === "object" && args !== null) {
+        return Object.values(args).map(String);
+    }
+    return [String(args)];
+}
+function isExecError(err) {
+    return err instanceof Error && "code" in err;
+}
+//# sourceMappingURL=run-command.js.map

package/dist/activities/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/activities/run-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,MAAwB;YACtC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC;gBACH,OAAO,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,IAAI,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,MAAwB;YACrC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC;gBACH,OAAO,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,IAAI,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAwB;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,kBAAkB,CAAC,YAAY,CAAC,yCAAyC,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAS,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAK,CAAC;IAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzC,MAAM,GAAG,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3D,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAEnD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE;YACzE,GAAG;YACH,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,kBAAkB,CAAC,YAAY,CACnC,sCAAsC,GAAG,CAAC,IAAI,GAAG,EACjD,yBAAyB,EACzB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAwB;IAClD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,kBAAkB,CAAC,YAAY,CAAC,uCAAuC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAQ,CAAC;IAChC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAChC,CAAC,CAAC,OAAO,CAAC;IACZ,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE;YAC9C,GAAG;YACH,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,kBAAkB,CAAC,YAAY,CACnC,mCAAmC,GAAG,CAAC,IAAI,GAAG,EAC9C,wBAAwB,EACxB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CACf,OAAgC;IAEhC,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,IAAa;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACxB,CAAC;AAQD,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC;AAC/C,CAAC"}

package/dist/activities/workflow-event-activities.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Local activities for emitting workflow execution events.
+ *
+ * Converts plain event descriptors (safe for the Temporal deterministic
+ * sandbox) into WorkflowExecutionEvent proto objects and sends them
+ * alongside a status update via gRPC. Best-effort — failures are logged
+ * but do not fail the activity.
+ *
+ * Registered as proxyLocalActivities in engine-core.ts so the workflow
+ * sandbox can emit events at task boundaries and approval gates.
+ */
+import { type WorkflowExecutionEvent } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+import type { WorkflowEventDescriptor } from "../workflow-engine/types.js";
+import type { TaskStatusEntry } from "../workflow-engine/task-status-accumulator.js";
+import type { RecoveryTaskData } from "../workflow-engine/recovery.js";
+/**
+ * Initialize the event sequence counter from the persisted high-water mark.
+ *
+ * On first run (no prior events), the counter stays at 0 and the first
+ * event gets sequence_number = 1 — identical to the original behavior.
+ *
+ * On recovery (events already persisted from a failed run), the counter
+ * is set to the highest persisted sequence_number so that new events
+ * continue from N+1, avoiding duplicate-key collisions in storage.
+ *
+ * When executionId is empty (direct executeServerlessWorkflow without a
+ * persisted execution), the counter resets to 0 as a safe fallback.
+ */
+export declare function initSequenceFromEventLog(executionId: string): Promise<void>;
+/** @internal Exported for unit testing only. */
+export declare function toProtoEvent(desc: WorkflowEventDescriptor): WorkflowExecutionEvent;
+export declare function emitWorkflowEvents(executionId: string, events: WorkflowEventDescriptor[], taskStatuses?: TaskStatusEntry[]): Promise<void>;
+/**
+ * Loads recovery context data from the previous run's status snapshot.
+ *
+ * Fetches the WorkflowExecution and extracts status.tasks[] as plain
+ * serializable objects. The workflow sandbox builds the RecoveryContext
+ * from this data via buildRecoveryContext().
+ *
+ * Unlike emitWorkflowEvents (best-effort), this activity propagates
+ * errors — recovery context loading is required for correctness.
+ */
+export declare function loadRecoveryContext(executionId: string): Promise<RecoveryTaskData[]>;
+export declare function createWorkflowEventActivities(): {
+    EmitWorkflowEvents: typeof emitWorkflowEvents;
+    ResetEventSequence: typeof initSequenceFromEventLog;
+    LoadRecoveryContext: typeof loadRecoveryContext;
+};