@stigmer/server 3.14.0-dev.20260910084630

package/dist/temporal/schedule/workflows/tick.js

@@ -0,0 +1,283 @@
+/**
+ * The tick workflow — ports pkg/domain/schedule/temporal/tick_workflow.go:
+ * one schedule fire, spanning its run (DD-013 via DD-015): record the
+ * fire, start the run, poll it to a terminal phase, record the verdict.
+ * Spanning is what makes the artifact's overlap SKIP genuinely mean "never
+ * start a run while the last is active", and the verdict is what feeds the
+ * failure streak behind the platform auto-pause.
+ *
+ * WHY A TIMER-DRIVEN POLL AND NOT THE CALLBACK TOKEN — read before
+ * "fixing" this. The platform already uses async activity completion for
+ * call:agent, so the token is the tempting shape here too. It loses on
+ * grounds that are edition-neutral (DD-015 D-E): the token cannot be
+ * re-armed after a create-then-crash, and its completion fire is
+ * best-effort — two silent-hang modes on a surface where a hang is a
+ * silenced reminder. The poll holds no worker thread (the workflow is
+ * dormant between polls; each poll is a millisecond activity), is bounded
+ * twice (budget + MAX_TRACKING_CYCLES), and keeps ONE verdict matrix
+ * across both editions.
+ *
+ * FORWARD CONSTRAINT: ticks live for minutes-to-an-hour once tracking is
+ * real, and OSS releases cut every 1-3 days — an in-flight tick WILL
+ * straddle a binary upgrade. Any behavioral change to this workflow body
+ * must be gated with patched()/deprecatePatch() (OD-6 discipline), and the
+ * replay gate (__tests__/replay.test.ts) must stay green against the
+ * committed histories.
+ *
+ * ERROR POSTURE (the #18 panel lesson, applied from day one): Go's
+ * `return err` fails the WORKFLOW EXECUTION; a plain thrown Error in the
+ * TS sandbox fails only the workflow TASK and retries forever. Every Go
+ * error return is therefore an ApplicationFailure here. Cancellation
+ * (sleep throwing CancelledFailure) propagates untouched — Go's
+ * workflow.Sleep error return, same terminal outcome.
+ *
+ * WORKFLOW-BUNDLE IMPORT DISCIPLINE: this module runs in the deterministic
+ * sandbox — imports are limited to @temporalio/workflow, @temporalio/common,
+ * and the pure names module.
+ */
+import { ApplicationFailure, isCancellation, proxyActivities, sleep, workflowInfo, log, } from "@temporalio/workflow";
+import { SearchAttributeType, defineSearchAttributeKey, } from "@temporalio/common";
+import { FAILURE_RUN_FAILED, FAILURE_RUN_TIMED_OUT, FAILURE_START_FAILED, PHASE_COMPLETED, PHASE_GONE, PHASE_RUNNING, RECORD_FAILED_RUN_ACTIVITY_NAME, RECORD_SUCCESSFUL_RUN_ACTIVITY_NAME, RECORD_TICK_ACTIVITY_NAME, POLL_EXECUTION_PHASE_ACTIVITY_NAME, RUN_ALREADY_STARTED, RUN_REFUSED, RUN_SKIPPED, RUN_STARTED, RUN_TARGET_MISSING, START_SCHEDULED_RUN_ACTIVITY_NAME, TICK_FIRED, artifactId, } from "../names.js";
+/**
+ * The tracking loop's code-level backstop, on top of the per-fire budget:
+ * 240 polls at the capped backoff is ~3.9 hours and ~1,200 history
+ * events — the loop can never outgrow a workflow history even if a budget
+ * is misconfigured (Go MaxTrackingCycles; exported so the bound test can
+ * assert it).
+ */
+export const MAX_TRACKING_CYCLES = 240;
+/**
+ * The nominal fire time Temporal stamps on every schedule-started
+ * workflow — tier one of the nominal-time derivation (present on cron
+ * fires AND manual triggers alike; Go scheduledStartTimeKey).
+ */
+const SCHEDULED_START_TIME_KEY = defineSearchAttributeKey("TemporalScheduledStartTime", SearchAttributeType.DATETIME);
+// The three activity-option contexts (Go tick_workflow.go). Record stub:
+// short idempotent status writes, retried freely.
+const recordActivities = proxyActivities({
+    startToCloseTimeout: "30 seconds",
+    retry: {
+        maximumAttempts: 3,
+        initialInterval: "5 seconds",
+        backoffCoefficient: 2.0,
+    },
+});
+// Run-start stub: enters the full create pipeline (session, context,
+// workflow start) — minutes-scale timeout, still retried (the
+// deterministic execution name absorbs retries).
+const startActivities = proxyActivities({
+    startToCloseTimeout: "3 minutes",
+    retry: {
+        maximumAttempts: 3,
+        initialInterval: "5 seconds",
+        backoffCoefficient: 2.0,
+    },
+});
+// Failure-record stub: EXACTLY ONE attempt — the streak increment is the
+// clock's single non-idempotent write. A retry after a successful write
+// over-counts and pauses a healthy schedule early; a lost write
+// under-counts, which fails safe.
+const failureActivities = proxyActivities({
+    startToCloseTimeout: "30 seconds",
+    retry: { maximumAttempts: 1 },
+});
+/**
+ * Executes one tick (Go TickWorkflow.Run; registered as "schedule/tick"
+ * via the barrel). The single argument is the schedule resource id
+ * (Temporal bakes action args once — the nominal fire time is derived,
+ * never carried).
+ */
+export async function tick(scheduleResourceId) {
+    const nominal = nominalFireTime(scheduleResourceId);
+    const nominalRfc3339 = rfc3339Seconds(nominal);
+    const tickOutcome = await failing("record tick", recordActivities[RECORD_TICK_ACTIVITY_NAME](scheduleResourceId, nominalRfc3339));
+    if (tickOutcome !== TICK_FIRED) {
+        log.info("Schedule tick complete", {
+            schedule_id: scheduleResourceId,
+            nominal_fire_time: nominalRfc3339,
+            outcome: tickOutcome,
+        });
+        return;
+    }
+    const runStart = await failing("start scheduled run", startActivities[START_SCHEDULED_RUN_ACTIVITY_NAME](scheduleResourceId, nominalRfc3339));
+    switch (runStart.outcome) {
+        case RUN_SKIPPED:
+            log.info("Schedule tick complete", {
+                schedule_id: scheduleResourceId,
+                nominal_fire_time: nominalRfc3339,
+                run_outcome: runStart.outcome,
+            });
+            return;
+        case RUN_TARGET_MISSING:
+        case RUN_REFUSED: {
+            // The run never existed: the streak counts the fire, the completion
+            // verdicts do not.
+            const recorded = await failing("record start failure", failureActivities[RECORD_FAILED_RUN_ACTIVITY_NAME](scheduleResourceId, runStart.failureReason, FAILURE_START_FAILED));
+            log.info("Schedule tick complete", {
+                schedule_id: scheduleResourceId,
+                nominal_fire_time: nominalRfc3339,
+                run_outcome: runStart.outcome,
+                verdict: "start_failed",
+                consecutive_failures: recorded.consecutiveFailures,
+                paused: recorded.paused,
+            });
+            return;
+        }
+        case RUN_STARTED:
+        case RUN_ALREADY_STARTED:
+            await trackRun(scheduleResourceId, nominalRfc3339, runStart);
+            return;
+        default: {
+            // Compile-time exhaustiveness; the runtime throw stands for
+            // deserialized history data outside the union.
+            const exhaustive = runStart.outcome;
+            throw ApplicationFailure.nonRetryable(`unknown run outcome "${String(exhaustive)}"`);
+        }
+    }
+}
+/**
+ * Polls the run to a terminal phase within this fire's budget and records
+ * the verdict (Go trackRun).
+ */
+async function trackRun(scheduleResourceId, nominalRfc3339, runStart) {
+    const deadline = Date.now() + runStart.trackingTimeoutMinutes * 60_000;
+    let phase = PHASE_RUNNING;
+    let budgetExhausted = false;
+    // Poll-first, deadline checked after each poll and before each sleep: an
+    // ALREADY_STARTED retry may already be terminal, and the loop must never
+    // sleep past its own deadline.
+    for (let cycle = 1;; cycle++) {
+        if (cycle > MAX_TRACKING_CYCLES) {
+            budgetExhausted = true;
+            break;
+        }
+        // DB unreachable past the activity's own retries: fail the tick with
+        // NO verdict — guessing "failed" during an outage could pause a
+        // healthy schedule. The artifact stays armed (PauseOnFailure=false);
+        // the next fire is unaffected.
+        phase = await failing("poll execution phase", recordActivities[POLL_EXECUTION_PHASE_ACTIVITY_NAME](runStart.executionId));
+        if (phase !== PHASE_RUNNING) {
+            break;
+        }
+        if (Date.now() >= deadline) {
+            budgetExhausted = true;
+            break;
+        }
+        await sleep(trackingBackoffMs(cycle));
+    }
+    if (budgetExhausted) {
+        // The run is NOT cancelled: its own execution profile bounds spend,
+        // and a destructive act buys nothing. Under SKIP this budget is
+        // literally the maximum time one hung run may silence the schedule.
+        const reason = `run ${runStart.executionId} did not finish within ${runStart.trackingTimeoutMinutes} minutes`;
+        const recorded = await failing("record tracking timeout", failureActivities[RECORD_FAILED_RUN_ACTIVITY_NAME](scheduleResourceId, reason, FAILURE_RUN_TIMED_OUT));
+        logVerdict(scheduleResourceId, nominalRfc3339, runStart, "timed_out", recorded);
+        return;
+    }
+    if (phase === PHASE_COMPLETED) {
+        await failing("record successful run", recordActivities[RECORD_SUCCESSFUL_RUN_ACTIVITY_NAME](scheduleResourceId));
+        logVerdict(scheduleResourceId, nominalRfc3339, runStart, "completed");
+        return;
+    }
+    if (phase === PHASE_GONE) {
+        // Deleting a run must not brick its schedule: no verdict.
+        logVerdict(scheduleResourceId, nominalRfc3339, runStart, "gone");
+        return;
+    }
+    // FAILED, CANCELLED, TERMINATED.
+    const reason = `run ${runStart.executionId} ended ${phase.toLowerCase()}`;
+    const recorded = await failing("record failed run", failureActivities[RECORD_FAILED_RUN_ACTIVITY_NAME](scheduleResourceId, reason, FAILURE_RUN_FAILED));
+    logVerdict(scheduleResourceId, nominalRfc3339, runStart, phase.toLowerCase(), recorded);
+}
+/**
+ * The delay before the next phase poll: linear cycle×5s capped at 60s —
+ * recoveryBackoff's exact shape, the only backoff curve this platform runs
+ * in production workflow code. It notices a 30-120s run (the common case)
+ * within seconds and reaches its cap by cycle twelve, bounding poll volume
+ * on long runs (Go trackingBackoff). Exported for the curve's unit pin.
+ */
+export function trackingBackoffMs(cycle) {
+    const ms = cycle * 5_000;
+    return ms > 60_000 ? 60_000 : ms;
+}
+/**
+ * Derives THE fire's nominal time, three tiers (Go nominalFireTime):
+ *  1. The TemporalScheduledStartTime search attribute (cron fires and
+ *     manual triggers both carry it — spike-verified on the Go side).
+ *  2. The workflow-id suffix Temporal appends to the artifact's base id.
+ *  3. Workflow time truncated to whole seconds (a hand-started tick).
+ *
+ * The nominal time is the fire's identity: last_fire_at records it and the
+ * execution name derives from it, so both idempotency keys agree on every
+ * retry.
+ */
+function nominalFireTime(scheduleResourceId) {
+    const attribute = workflowInfo().typedSearchAttributes.get(SCHEDULED_START_TIME_KEY);
+    if (attribute !== undefined) {
+        return attribute;
+    }
+    const base = `${artifactId(scheduleResourceId)}-`;
+    const workflowId = workflowInfo().workflowId;
+    if (workflowId.startsWith(base)) {
+        const suffix = workflowId.slice(base.length);
+        // Go time.Parse(time.RFC3339) is strict; Date() is lenient — the
+        // pattern guard keeps a non-RFC3339 suffix falling to tier 3 exactly
+        // as Go's parse error does.
+        if (RFC3339_PATTERN.test(suffix)) {
+            const parsed = new Date(suffix);
+            if (!Number.isNaN(parsed.getTime())) {
+                return parsed;
+            }
+        }
+    }
+    // Date.now() is deterministic workflow time inside the sandbox — Go's
+    // workflow.Now twin.
+    return new Date(Math.floor(Date.now() / 1000) * 1000);
+}
+/**
+ * Maps a failed activity to Go's `return fmt.Errorf("<label>: %w", err)` —
+ * a WORKFLOW failure (see the module header's error posture). Cancellation
+ * failures propagate untouched.
+ */
+async function failing(label, promise) {
+    try {
+        return await promise;
+    }
+    catch (error) {
+        if (error instanceof ApplicationFailure || isCancellation(error)) {
+            throw error;
+        }
+        throw ApplicationFailure.create({
+            message: `${label}: ${error instanceof Error ? error.message : String(error)}`,
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+}
+/** Anchored RFC-3339 shape (Z or numeric offset, optional fraction). */
+const RFC3339_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+/** Go time.RFC3339, UTC whole seconds (the wire shape the activities pin). */
+function rfc3339Seconds(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function logVerdict(scheduleResourceId, nominalRfc3339, runStart, verdict, recorded) {
+    if (recorded === undefined) {
+        log.info("Schedule tick complete", {
+            schedule_id: scheduleResourceId,
+            nominal_fire_time: nominalRfc3339,
+            run_outcome: runStart.outcome,
+            execution_id: runStart.executionId,
+            verdict,
+        });
+        return;
+    }
+    log.info("Schedule tick complete", {
+        schedule_id: scheduleResourceId,
+        nominal_fire_time: nominalRfc3339,
+        run_outcome: runStart.outcome,
+        execution_id: runStart.executionId,
+        verdict,
+        consecutive_failures: recorded.consecutiveFailures,
+        paused: recorded.paused,
+    });
+}
+//# sourceMappingURL=tick.js.map

package/dist/temporal/schedule/workflows/tick.js.map

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

package/dist/temporal/workflow-source.d.ts

@@ -0,0 +1,22 @@
+export type WorkflowSource = {
+    /** Pre-built bundle on disk (slim artifacts; #24). */
+    readonly kind: "prebuilt";
+    readonly codePath: string;
+} | {
+    /** Bundle on boot from the compiled workflows entry module. */
+    readonly kind: "runtime";
+    readonly workflowsPath: string;
+};
+export interface ResolveWorkflowSourceOptions {
+    /**
+     * Candidate workflows entries in preference order — typically the
+     * compiled `.js` first, then the `.ts` source (the tsx dev loop runs
+     * from src/, where only the .ts exists; the SDK's bundler compiles
+     * TypeScript natively, so either candidate works).
+     */
+    readonly workflowsEntryCandidates: readonly URL[];
+    /** Where a prebuilt bundle would sit (e.g. new URL("./workflow-bundle-agent-execution.js", import.meta.url)). */
+    readonly prebuiltSibling: URL;
+}
+export declare function resolveWorkflowSource(options: ResolveWorkflowSourceOptions): WorkflowSource;
+//# sourceMappingURL=workflow-source.d.ts.map

package/dist/temporal/workflow-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-source.d.ts","sourceRoot":"","sources":["../../src/temporal/workflow-source.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,cAAc,GACtB;IACE,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,wBAAwB,EAAE,SAAS,GAAG,EAAE,CAAC;IAClD,iHAAiH;IACjH,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,cAAc,CAkBhB"}

package/dist/temporal/workflow-source.js

@@ -0,0 +1,44 @@
+/**
+ * Resolves where a worker's Temporal WORKFLOW code comes from — the
+ * runner's resolveWorkflowSource seam (runner src/workflow-source.ts),
+ * generalized for a server that hosts one workflow entry per domain
+ * worker.
+ *
+ * Workflow code runs inside Temporal's deterministic sandbox and must be
+ * bundled separately from host code. Two production modes:
+ *
+ * 1. **Runtime** (this sub-project's operative mode, ratified brief #7 of
+ *    sub-project 20260824.03): the worker bundles the compiled dist entry
+ *    on boot via the SDK's built-in webpack. This is how conformance and
+ *    the CLI-launched dev server boot — node_modules present, no native
+ *    packaging needed.
+ * 2. **Prebuilt** (the hook #24 cli-cutover fills): the slim artifact
+ *    cannot bundle at runtime (no webpack/@swc shipped), so the build
+ *    emits the bundle next to main.js and this resolver finds it as a
+ *    sibling — exactly the runner's discovery rule.
+ *
+ * Callers pass URLs relative to their own module (import.meta.url): in the
+ * tsc dist the sibling bundle never exists so dev builds always take the
+ * runtime path; in a slim artifact every module collapses into main.js and
+ * the sibling resolves next to it, where #24's build will emit it.
+ */
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+export function resolveWorkflowSource(options) {
+    const prebuiltPath = fileURLToPath(options.prebuiltSibling);
+    if (existsSync(prebuiltPath)) {
+        return { kind: "prebuilt", codePath: prebuiltPath };
+    }
+    for (const candidate of options.workflowsEntryCandidates) {
+        const candidatePath = fileURLToPath(candidate);
+        if (existsSync(candidatePath)) {
+            return { kind: "runtime", workflowsPath: candidatePath };
+        }
+    }
+    throw new Error("no Temporal workflows entry found (checked: " +
+        options.workflowsEntryCandidates
+            .map((url) => fileURLToPath(url))
+            .join(", ") +
+        ") — the build did not emit the workflows module");
+}
+//# sourceMappingURL=workflow-source.js.map

package/dist/temporal/workflow-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-source.js","sourceRoot":"","sources":["../../src/temporal/workflow-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA0BzC,MAAM,UAAU,qBAAqB,CACnC,OAAqC;IAErC,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;QACzD,MAAM,aAAa,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,8CAA8C;QAC5C,OAAO,CAAC,wBAAwB;aAC7B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;aAChC,IAAI,CAAC,IAAI,CAAC;QACb,iDAAiD,CACpD,CAAC;AACJ,CAAC"}

package/dist/temporal/workflowexecution/activities.d.ts

@@ -0,0 +1,34 @@
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { WorkflowExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { Logger } from "../../boot/logger.js";
+import type { StreamBroker } from "../../domain/workflowexecution/stream-broker.js";
+import type { WorkflowSandboxTerminalObserver } from "../../sandbox/steps.js";
+import type { Store } from "../../store/interface.js";
+export interface WorkflowExecutionActivityDeps {
+    readonly store: Store;
+    readonly logger: Logger;
+    readonly broker: StreamBroker;
+    /**
+     * Fires the workflow-sandbox teardown on terminal transitions (§6d,
+     * O6) — this activity is the orchestrator's failure/cancellation
+     * persist site, one of the three status write sites the Q3b ruling
+     * wires.
+     */
+    readonly sandboxTerminalObserver: WorkflowSandboxTerminalObserver;
+}
+/**
+ * Builds the activity record the worker registers. Keys are the
+ * byte-pinned activity names; the runner-owned child workflow is
+ * deliberately NOT here — a worker registering the other side's names
+ * would break queue-based routing (worker_config.go's contract).
+ */
+export declare function createWorkflowExecutionActivities(deps: WorkflowExecutionActivityDeps): Record<string, (...args: never[]) => Promise<unknown>>;
+/**
+ * The ACTIVITY's merge body (update_status_impl.go UpdateExecutionStatus,
+ * field-for-field), run inside the store's atomic updateResource closure.
+ * Deliberately NOT applyUpdateStatusMerge from the domain's RPC path —
+ * see the module header for the wire-visible differences. Exported for
+ * the co-located unit tests.
+ */
+export declare function applyActivityStatusMerge(execution: WorkflowExecution, statusUpdates: WorkflowExecutionStatus): void;
+//# sourceMappingURL=activities.d.ts.map

package/dist/temporal/workflowexecution/activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../../src/temporal/workflowexecution/activities.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAKxG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAQ9G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAKpF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGtD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;CACnE;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,6BAA6B,GAClC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAwExD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,aAAa,EAAE,uBAAuB,GACrC,IAAI,CA0CN"}

package/dist/temporal/workflowexecution/activities.js

@@ -0,0 +1,145 @@
+/**
+ * Server-side activity implementations for the workflow-execution worker —
+ * ports pkg/domain/workflowexecution/temporal/activities
+ * (update_status_impl.go) and registers #15's DeleteExecutionContext seam.
+ *
+ * UpdateWorkflowExecutionStatus deliberately does NOT reuse the domain's
+ * updateStatus RPC merge (the choice agentexecution's port made): in Go
+ * the two merges are DIFFERENT code with different semantics, and the
+ * differences are wire-visible for exactly the payloads this workflow
+ * sends (sub-project DD-001 brief, owner-ratified):
+ *
+ *   - The activity bumps statusAudit.updatedAt on EVERY call; the RPC
+ *     bumps only on phase TRANSITIONS (the recents-sidebar rule). A
+ *     defense re-assert of an unchanged phase must keep bumping.
+ *   - The activity never touches events, output, temporal_workflow_id,
+ *     or the pending gate lists.
+ *   - A missing execution is an ordinary wrapped activity error
+ *     ("workflow execution not found: …"), not the RPC's NotFound.
+ *
+ * What IS adopted from the domain: the atomic `updateResource` persist
+ * (the #20 DD-001 posture — Go's activity is a load-then-save with the
+ * same lost-update window its RPC has; not ported) and the post-persist
+ * broadcast through the domain's StreamBroker (Go wires the same broker
+ * into both).
+ *
+ * Payload boundary (sub-project 20260824.03 design rule): statuses cross
+ * as proto-JSON — the TS default payload converter cannot serialize the
+ * bigint int64 fields of typed messages. Server-internal payloads; only
+ * the activity NAMES are byte-pinned.
+ */
+import { create, fromJson } from "@bufbuild/protobuf";
+import { timestampNow } from "@bufbuild/protobuf/wkt";
+import { WorkflowExecutionSchema, WorkflowExecutionStatusSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { ApiResourceAuditInfoSchema, ApiResourceAuditSchema, } from "@stigmer/protos/ai/stigmer/commons/apiresource/status_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { DELETE_EXECUTION_CONTEXT_ACTIVITY_NAME, deleteExecutionContextForExecution, } from "../../domain/executioncontext/temporal/delete-execution-context.js";
+import { UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME } from "./names.js";
+/**
+ * Builds the activity record the worker registers. Keys are the
+ * byte-pinned activity names; the runner-owned child workflow is
+ * deliberately NOT here — a worker registering the other side's names
+ * would break queue-based routing (worker_config.go's contract).
+ */
+export function createWorkflowExecutionActivities(deps) {
+    const { store, logger, broker, sandboxTerminalObserver } = deps;
+    return {
+        /**
+         * The orchestrator's status persist, invoked as a LOCAL activity
+         * (pause/resume handlers) AND a REGULAR activity (failure/
+         * cancellation paths) — one implementation serves both modes,
+         * exactly one named registration (see names.ts's DD-002 note on why
+         * the NAME is load-bearing).
+         */
+        [UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME]: async (executionId, statusJson) => {
+            const statusUpdates = fromJson(WorkflowExecutionStatusSchema, statusJson);
+            let updated;
+            // The phase BEFORE this merge, read under the write lock — the
+            // sandbox observer below keys on the transition (§6d, O6).
+            let previousPhase = ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+            try {
+                updated = await store.updateResource(ApiResourceKind.workflow_execution, executionId, WorkflowExecutionSchema, (execution) => {
+                    previousPhase =
+                        execution.status?.phase ??
+                            ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+                    applyActivityStatusMerge(execution, statusUpdates);
+                });
+            }
+            catch (error) {
+                // Go wraps EVERY load/save failure with this one text ("workflow
+                // execution not found: %w" — update_status_impl.go names the
+                // load; the atomic persist folds both arms into it).
+                throw new Error(`workflow execution not found: ${errorText(error)}`, { cause: error });
+            }
+            logger.info("Activity updated workflow execution status", {
+                execution_id: executionId,
+                phase: ExecutionPhase[updated.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED],
+                tasks: updated.status?.tasks.length ?? 0,
+            });
+            // Broadcast to active subscribers AFTER the persist commits
+            // (ADR 011 write path) — failure recovery updates must be
+            // immediately visible to externally-connected subscribe streams.
+            broker.broadcast(updated);
+            // A terminal transition (the orchestrator's FAILED/CANCELLED
+            // persists) tears the per-execution sandbox down, fire-and-forget.
+            sandboxTerminalObserver(executionId, previousPhase, updated.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED);
+        },
+        /** #15's seam, shared with the agent-execution worker exactly as in Go. */
+        [DELETE_EXECUTION_CONTEXT_ACTIVITY_NAME]: async (executionId) => {
+            await deleteExecutionContextForExecution(store, logger, executionId);
+        },
+    };
+}
+/**
+ * The ACTIVITY's merge body (update_status_impl.go UpdateExecutionStatus,
+ * field-for-field), run inside the store's atomic updateResource closure.
+ * Deliberately NOT applyUpdateStatusMerge from the domain's RPC path —
+ * see the module header for the wire-visible differences. Exported for
+ * the co-located unit tests.
+ */
+export function applyActivityStatusMerge(execution, statusUpdates) {
+    if (execution.status === undefined) {
+        execution.status = create(WorkflowExecutionStatusSchema);
+    }
+    const status = execution.status;
+    // Tasks: replaced wholesale with the worker's latest complete set.
+    if (statusUpdates.tasks.length > 0) {
+        status.tasks = statusUpdates.tasks;
+    }
+    if (statusUpdates.phase !== ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED) {
+        status.phase = statusUpdates.phase;
+    }
+    if (statusUpdates.error !== "") {
+        status.error = statusUpdates.error;
+    }
+    if (statusUpdates.startedAt !== "") {
+        status.startedAt = statusUpdates.startedAt;
+    }
+    if (statusUpdates.completedAt !== "") {
+        status.completedAt = statusUpdates.completedAt;
+    }
+    // Cost/token aggregates: monotonically increasing, always take the
+    // latest value; zero means "no update", never "reset".
+    if (statusUpdates.totalCostMicros > 0n) {
+        status.totalCostMicros = statusUpdates.totalCostMicros;
+    }
+    if (statusUpdates.totalInputTokens > 0n) {
+        status.totalInputTokens = statusUpdates.totalInputTokens;
+    }
+    if (statusUpdates.totalOutputTokens > 0n) {
+        status.totalOutputTokens = statusUpdates.totalOutputTokens;
+    }
+    // UNCONDITIONAL statusAudit bump — the activity's semantic, distinct
+    // from the RPC merge's phase-transition-only rule (module header).
+    const audit = status.audit ?? create(ApiResourceAuditSchema);
+    status.audit = audit;
+    const statusAudit = audit.statusAudit ?? create(ApiResourceAuditInfoSchema);
+    audit.statusAudit = statusAudit;
+    statusAudit.updatedAt = timestampNow();
+    statusAudit.event = "updated";
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=activities.js.map

package/dist/temporal/workflowexecution/activities.js.map

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

package/dist/temporal/workflowexecution/dispatch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Workflow dispatch-queue resolution — ports
+ * pkg/domain/workflowexecution/temporal/dispatch.go
+ * (ResolveWorkflowTaskQueue): which Temporal task queue a workflow
+ * execution's CHILD workflow starts on.
+ *
+ * Unlike agentexecution's dispatch (which loads the session to read its
+ * harness and target), this resolution is PURE — the execution target
+ * rides in on the create pipeline's spec read (the seam's
+ * StartWorkflowExecutionInput.executionTarget), so there is no store
+ * read and no failure lane: Go's Create has no dispatch error boundary
+ * and neither does this port.
+ *
+ * Routing modes (config.workflowActivityRouting):
+ *   - "global": always the configured runner queue (stigmer_runner) —
+ *     all workflow executions share the global runner pool.
+ *   - "execution": wfexec:{execution_id} regardless of execution target.
+ *     For CLOUD a dedicated sandbox is provisioned for that queue; for
+ *     LOCAL the desktop runner-manager creates a worker on it.
+ */
+import type { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+import type { Logger } from "../../boot/logger.js";
+import { type WorkflowExecutionTemporalConfig } from "../../domain/workflowexecution/temporal/config.js";
+/**
+ * The resolved Temporal task queue and effective execution target for a
+ * workflow execution's child dispatch (Go WorkflowDispatchResult).
+ */
+export interface WorkflowDispatchResult {
+    readonly taskQueue: string;
+    readonly executionTarget: ExecutionTarget;
+}
+/**
+ * Go ResolveWorkflowTaskQueue: resolves the child's task queue from the
+ * routing mode, and UNSPECIFIED targets through the config's single
+ * resolution rule.
+ */
+export declare function resolveWorkflowTaskQueue(executionId: string, executionTarget: ExecutionTarget, config: WorkflowExecutionTemporalConfig, logger: Logger): WorkflowDispatchResult;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/temporal/workflowexecution/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/temporal/workflowexecution/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAE7F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,mDAAmD,CAAC;AAG3D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,+BAA+B,EACvC,MAAM,EAAE,MAAM,GACb,sBAAsB,CAqBxB"}

package/dist/temporal/workflowexecution/dispatch.js

@@ -0,0 +1,28 @@
+import { WORKFLOW_ROUTING_EXECUTION, } from "../../domain/workflowexecution/temporal/config.js";
+import { formatWfExecTaskQueue } from "./names.js";
+/**
+ * Go ResolveWorkflowTaskQueue: resolves the child's task queue from the
+ * routing mode, and UNSPECIFIED targets through the config's single
+ * resolution rule.
+ */
+export function resolveWorkflowTaskQueue(executionId, executionTarget, config, logger) {
+    const resolved = config.resolveWorkflowExecutionTarget(executionTarget);
+    if (config.workflowActivityRouting === WORKFLOW_ROUTING_EXECUTION) {
+        const taskQueue = formatWfExecTaskQueue(executionId);
+        logger.info("Workflow dispatch resolved per-execution queue", {
+            execution_id: executionId,
+            task_queue: taskQueue,
+            routing_mode: config.workflowActivityRouting,
+            execution_target: resolved,
+        });
+        return { taskQueue, executionTarget: resolved };
+    }
+    logger.info("Workflow dispatch resolved global queue", {
+        execution_id: executionId,
+        task_queue: config.runnerQueue,
+        routing_mode: config.workflowActivityRouting,
+        execution_target: resolved,
+    });
+    return { taskQueue: config.runnerQueue, executionTarget: resolved };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/temporal/workflowexecution/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../src/temporal/workflowexecution/dispatch.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,0BAA0B,GAE3B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAWnD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,eAAgC,EAChC,MAAuC,EACvC,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,CAAC,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,uBAAuB,KAAK,0BAA0B,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE;YAC5D,YAAY,EAAE,WAAW;YACzB,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,MAAM,CAAC,uBAAuB;YAC5C,gBAAgB,EAAE,QAAQ;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;QACrD,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,YAAY,EAAE,MAAM,CAAC,uBAAuB;QAC5C,gBAAgB,EAAE,QAAQ;KAC3B,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;AACtE,CAAC"}