callman-core 1.32.0 → 1.33.0

package/dist/scenario-runner/temporal.js

@@ -0,0 +1,377 @@
+// Temporal node helpers shared by the executor, the hosts and the authoring
+// tools (desktop builder validation, backend zod schema, MCP required-field
+// check all read TEMPORAL_OPERATION_SPECS instead of keeping their own list).
+//
+// `resolveTemporalOperation` turns a node config + the live template values
+// into a fully resolved, typed operation (templates substituted, JSON args
+// parsed) and is the ONE place that decides what is required per operation.
+export const TEMPORAL_OPERATIONS = [
+    "startWorkflow",
+    "signal",
+    "signalWithStart",
+    "query",
+    "update",
+    "awaitResult",
+    "describe",
+    "history",
+    "cancel",
+    "terminate",
+    "list",
+    "count",
+    "describeTaskQueue",
+];
+export const isTemporalOperation = (value) => typeof value === "string" && TEMPORAL_OPERATIONS.includes(value);
+const START_OPTIONS = [
+    "idReusePolicy",
+    "idConflictPolicy",
+    "memo",
+    "searchAttributes",
+    "workflowExecutionTimeoutMs",
+    "workflowRunTimeoutMs",
+    "workflowTaskTimeoutMs",
+    "startDelayMs",
+    "retryPolicy",
+];
+export const TEMPORAL_OPERATION_SPECS = {
+    startWorkflow: {
+        operation: "startWorkflow",
+        label: "Start workflow",
+        summary: "Start a workflow execution; optionally wait for its result.",
+        required: ["workflowType", "taskQueue"],
+        optional: ["workflowId", "args", "waitForResult", "followRuns", "onTimeout", ...START_OPTIONS],
+        waits: true,
+    },
+    signal: {
+        operation: "signal",
+        label: "Signal",
+        summary: "Send a signal to a running workflow.",
+        required: ["workflowId", "signalName"],
+        optional: ["runId", "args"],
+        waits: false,
+    },
+    signalWithStart: {
+        operation: "signalWithStart",
+        label: "Signal with start",
+        summary: "Signal the workflow, starting it first when it is not running.",
+        required: ["workflowId", "workflowType", "taskQueue", "signalName"],
+        optional: ["args", "signalArgs", ...START_OPTIONS],
+        waits: false,
+    },
+    query: {
+        operation: "query",
+        label: "Query",
+        summary: "Read workflow state through a query handler (works on closed workflows too).",
+        required: ["workflowId", "queryName"],
+        optional: ["runId", "args"],
+        waits: false,
+    },
+    update: {
+        operation: "update",
+        label: "Update",
+        summary: "Invoke an update handler and wait for its result.",
+        required: ["workflowId", "updateName"],
+        optional: ["runId", "args", "waitForStage"],
+        waits: true,
+    },
+    awaitResult: {
+        operation: "awaitResult",
+        label: "Await result",
+        summary: "Wait for the workflow to close and expose its result or failure.",
+        required: ["workflowId"],
+        optional: ["runId", "followRuns", "onTimeout"],
+        waits: true,
+    },
+    describe: {
+        operation: "describe",
+        label: "Describe",
+        summary: "Status, type, task queue, timings, memo, search attributes and pending activities.",
+        required: ["workflowId"],
+        optional: ["runId"],
+        waits: false,
+    },
+    history: {
+        operation: "history",
+        label: "History",
+        summary: "Fetch the event history and summarize it (event counts, activities, signals, timers, failure).",
+        required: ["workflowId"],
+        optional: ["runId", "eventTypes", "historyLimit"],
+        waits: false,
+    },
+    cancel: {
+        operation: "cancel",
+        label: "Cancel",
+        summary: "Request cancellation (the workflow runs its cleanup).",
+        required: ["workflowId"],
+        optional: ["runId", "reason"],
+        waits: false,
+    },
+    terminate: {
+        operation: "terminate",
+        label: "Terminate",
+        summary: "Terminate the workflow immediately (no cleanup).",
+        required: ["workflowId"],
+        optional: ["runId", "reason"],
+        waits: false,
+    },
+    list: {
+        operation: "list",
+        label: "List",
+        summary: "List workflow executions matching a visibility filter.",
+        required: ["query"],
+        optional: ["pageSize"],
+        waits: false,
+    },
+    count: {
+        operation: "count",
+        label: "Count",
+        summary: "Count workflow executions matching a visibility filter (GROUP BY supported).",
+        required: ["query"],
+        optional: [],
+        waits: false,
+    },
+    describeTaskQueue: {
+        operation: "describeTaskQueue",
+        label: "Describe task queue",
+        summary: "Which workers poll a task queue — a worker-is-alive check.",
+        required: ["taskQueue"],
+        optional: ["taskQueueType"],
+        waits: false,
+    },
+};
+export const TEMPORAL_WORKFLOW_ID_REUSE_POLICIES = [
+    "ALLOW_DUPLICATE",
+    "ALLOW_DUPLICATE_FAILED_ONLY",
+    "REJECT_DUPLICATE",
+    "TERMINATE_IF_RUNNING",
+];
+export const TEMPORAL_WORKFLOW_ID_CONFLICT_POLICIES = [
+    "FAIL",
+    "USE_EXISTING",
+    "TERMINATE_EXISTING",
+];
+/** Every key of ScenarioTemporalResult, with its "not applicable" value. */
+export const createEmptyTemporalResult = (operation, namespace) => ({
+    operation,
+    namespace,
+    workflowId: null,
+    runId: null,
+    status: null,
+    workflowType: null,
+    taskQueue: null,
+    result: null,
+    failure: null,
+    startTime: null,
+    closeTime: null,
+    historyLength: null,
+    memo: null,
+    searchAttributes: null,
+    activities: [],
+    pendingChildren: [],
+    events: [],
+    eventCounts: {},
+    signals: [],
+    timers: [],
+    truncatedHistory: false,
+    executions: [],
+    count: null,
+    groups: [],
+    pollers: [],
+    hasPollers: null,
+    updateId: null,
+    requested: null,
+    timedOut: false,
+    durationMs: 0,
+});
+export class TemporalConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TemporalConfigError";
+    }
+}
+const FIELD_LABELS = {
+    workflowId: "workflow id",
+    workflowType: "workflow type",
+    taskQueue: "task queue",
+    signalName: "signal name",
+    queryName: "query name",
+    updateName: "update name",
+    query: "list filter",
+};
+const describeField = (field) => FIELD_LABELS[field] ?? String(field);
+const isBlank = (value) => value === undefined || value === null || (typeof value === "string" && value.trim() === "");
+/**
+ * Static validation (no templates resolved): which required fields are empty
+ * for the chosen operation. Hosts use it in the builder / on save.
+ */
+export const getTemporalNodeMissingFields = (config) => {
+    const operation = config?.operation;
+    if (!isTemporalOperation(operation)) {
+        return ["operation"];
+    }
+    const missing = [];
+    if (isBlank(config?.connectionId)) {
+        missing.push("connectionId");
+    }
+    for (const field of TEMPORAL_OPERATION_SPECS[operation].required) {
+        if (isBlank(config?.[field])) {
+            missing.push(String(field));
+        }
+    }
+    return missing;
+};
+const parseJsonArray = (raw, field, resolve) => {
+    const text = (raw ?? "").trim();
+    if (!text) {
+        return [];
+    }
+    const resolved = resolve(text);
+    let parsed;
+    try {
+        parsed = JSON.parse(resolved);
+    }
+    catch {
+        throw new TemporalConfigError(`Temporal ${field} must be a JSON array after template resolution (got: ${resolved.slice(0, 80)}).`);
+    }
+    if (Array.isArray(parsed)) {
+        return parsed;
+    }
+    // A single value is a convenience for one-argument handlers.
+    return [parsed];
+};
+const parseJsonObject = (raw, field, resolve) => {
+    const text = (raw ?? "").trim();
+    if (!text) {
+        return undefined;
+    }
+    const resolved = resolve(text);
+    let parsed;
+    try {
+        parsed = JSON.parse(resolved);
+    }
+    catch {
+        throw new TemporalConfigError(`Temporal ${field} must be a JSON object after template resolution (got: ${resolved.slice(0, 80)}).`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new TemporalConfigError(`Temporal ${field} must be a JSON object.`);
+    }
+    return parsed;
+};
+const positiveInt = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.round(value) : undefined;
+const createGeneratedWorkflowId = (label) => {
+    const slug = label
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40);
+    const random = globalThis.crypto?.randomUUID?.() ??
+        `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+    return `callman-${slug || "workflow"}-${random}`;
+};
+/**
+ * Resolve every template in the config and parse the JSON fields. Throws
+ * TemporalConfigError when a required field is empty or JSON is invalid —
+ * the executor turns that into a fail-fast node failure (no gRPC call).
+ */
+export const resolveTemporalOperation = (config, resolve, resolveJson, options = {}) => {
+    if (!isTemporalOperation(config.operation)) {
+        throw new TemporalConfigError(`Temporal node has no operation. Choose one of: ${TEMPORAL_OPERATIONS.join(", ")}.`);
+    }
+    const spec = TEMPORAL_OPERATION_SPECS[config.operation];
+    const text = (value) => {
+        const resolved = resolve((value ?? "").trim()).trim();
+        return resolved ? resolved : null;
+    };
+    for (const field of spec.required) {
+        const value = config[field];
+        const resolved = typeof value === "string" ? text(value) : value;
+        if (isBlank(resolved)) {
+            throw new TemporalConfigError(`Temporal ${spec.label.toLowerCase()} needs a ${describeField(field)}.`);
+        }
+    }
+    let workflowId = text(config.workflowId);
+    if (!workflowId && config.operation === "startWorkflow") {
+        workflowId = createGeneratedWorkflowId(options.nodeLabel ?? "workflow");
+    }
+    const historyLimit = positiveInt(config.historyLimit);
+    const pageSize = positiveInt(config.pageSize);
+    return {
+        operation: config.operation,
+        namespace: text(config.namespace),
+        workflowId,
+        runId: text(config.runId),
+        workflowType: text(config.workflowType),
+        taskQueue: text(config.taskQueue),
+        args: parseJsonArray(config.args, "args", resolveJson),
+        signalName: text(config.signalName),
+        signalArgs: parseJsonArray(config.signalArgs, "signalArgs", resolveJson),
+        queryName: text(config.queryName),
+        updateName: text(config.updateName),
+        waitForStage: config.waitForStage === "ACCEPTED" ? "ACCEPTED" : "COMPLETED",
+        waitForResult: config.waitForResult === true,
+        followRuns: config.followRuns !== false,
+        reason: text(config.reason),
+        query: text(config.query),
+        pageSize: pageSize ?? null,
+        eventTypes: Array.isArray(config.eventTypes)
+            ? config.eventTypes
+                .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
+                .filter((entry) => entry.length > 0)
+            : [],
+        historyLimit: historyLimit ?? null,
+        taskQueueType: config.taskQueueType === "activity" ? "activity" : "workflow",
+        startOptions: {
+            ...(config.idReusePolicy &&
+                TEMPORAL_WORKFLOW_ID_REUSE_POLICIES.includes(config.idReusePolicy)
+                ? { idReusePolicy: config.idReusePolicy }
+                : {}),
+            ...(config.idConflictPolicy &&
+                TEMPORAL_WORKFLOW_ID_CONFLICT_POLICIES.includes(config.idConflictPolicy)
+                ? { idConflictPolicy: config.idConflictPolicy }
+                : {}),
+            ...(parseJsonObject(config.memo, "memo", resolveJson)
+                ? { memo: parseJsonObject(config.memo, "memo", resolveJson) }
+                : {}),
+            ...(parseJsonObject(config.searchAttributes, "searchAttributes", resolveJson)
+                ? {
+                    searchAttributes: parseJsonObject(config.searchAttributes, "searchAttributes", resolveJson),
+                }
+                : {}),
+            ...(positiveInt(config.workflowExecutionTimeoutMs)
+                ? { workflowExecutionTimeoutMs: positiveInt(config.workflowExecutionTimeoutMs) }
+                : {}),
+            ...(positiveInt(config.workflowRunTimeoutMs)
+                ? { workflowRunTimeoutMs: positiveInt(config.workflowRunTimeoutMs) }
+                : {}),
+            ...(positiveInt(config.workflowTaskTimeoutMs)
+                ? { workflowTaskTimeoutMs: positiveInt(config.workflowTaskTimeoutMs) }
+                : {}),
+            ...(positiveInt(config.startDelayMs) ? { startDelayMs: positiveInt(config.startDelayMs) } : {}),
+            ...(config.retryPolicy && typeof config.retryPolicy === "object"
+                ? { retryPolicy: normalizeRetryPolicy(config.retryPolicy) }
+                : {}),
+        },
+    };
+};
+const normalizeRetryPolicy = (value) => ({
+    ...(positiveInt(value.maximumAttempts) ? { maximumAttempts: positiveInt(value.maximumAttempts) } : {}),
+    ...(positiveInt(value.initialIntervalMs)
+        ? { initialIntervalMs: positiveInt(value.initialIntervalMs) }
+        : {}),
+    ...(typeof value.backoffCoefficient === "number" && value.backoffCoefficient >= 1
+        ? { backoffCoefficient: value.backoffCoefficient }
+        : {}),
+    ...(positiveInt(value.maximumIntervalMs)
+        ? { maximumIntervalMs: positiveInt(value.maximumIntervalMs) }
+        : {}),
+});
+/** Deep link into the Temporal Web UI, when the connection names one. */
+export const buildTemporalUiUrl = (uiBaseUrl, namespace, workflowId, runId) => {
+    const base = (uiBaseUrl ?? "").trim().replace(/\/+$/, "");
+    if (!base || !workflowId) {
+        return null;
+    }
+    const path = `${base}/namespaces/${encodeURIComponent(namespace)}/workflows/${encodeURIComponent(workflowId)}`;
+    return runId ? `${path}/${encodeURIComponent(runId)}` : path;
+};
+//# sourceMappingURL=temporal.js.map

package/dist/scenario-runner/temporal.js.map

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

package/dist/scenario-runner/types.d.ts

@@ -3,7 +3,7 @@ import type { ConditionGroupEvaluation, ConditionMode, ConditionNodeConfig, Cond
 import type { ContractFormat } from "../contract/formats.js";
 import type { ClientCertificateConfig, ContractSortedRule, ContractUniqueRule, OAuth2AuthConfig, OAuth2ClientAuth, OAuth2GrantType } from "../types/index.js";
 export type { OAuth2AuthConfig, OAuth2ClientAuth, OAuth2GrantType };
-export type ScenarioNodeType = "request" | "condition" | "assertion" | "wait" | "script" | "db" | "kafka" | "redis" | "notification" | "set-vars" | "poll" | "end" | "aggregator" | "subscenario" | "scenario-ref" | "foreach" | "websocket" | "ai";
+export type ScenarioNodeType = "request" | "condition" | "assertion" | "wait" | "script" | "db" | "kafka" | "redis" | "notification" | "set-vars" | "poll" | "end" | "aggregator" | "subscenario" | "scenario-ref" | "foreach" | "websocket" | "ai" | "temporal";
 export type ScenarioEdgeType = "default" | "yes" | "no" | "error";
 export type ScenarioNodeFailurePolicy = "stop" | "continue";
 export type ScenarioRequestContractValueType = "string" | "number" | "boolean" | "object" | "array" | "null";
@@ -186,13 +186,73 @@ export interface RedisScenarioNodeConfig extends ScenarioNodeConfigWithExecution
     connectionId: string;
     commands: string[];
 }
-export type PollActionType = "request" | "db" | "redis" | "script";
+export type TemporalOperation = "startWorkflow" | "signal" | "signalWithStart" | "query" | "update" | "awaitResult" | "describe" | "history" | "cancel" | "terminate" | "list" | "count" | "describeTaskQueue";
+export type TemporalWorkflowIdReusePolicy = "ALLOW_DUPLICATE" | "ALLOW_DUPLICATE_FAILED_ONLY" | "REJECT_DUPLICATE" | "TERMINATE_IF_RUNNING";
+export type TemporalWorkflowIdConflictPolicy = "FAIL" | "USE_EXISTING" | "TERMINATE_EXISTING";
+export interface TemporalRetryPolicyConfig {
+    maximumAttempts?: number;
+    initialIntervalMs?: number;
+    backoffCoefficient?: number;
+    maximumIntervalMs?: number;
+}
+export interface TemporalScenarioNodeConfig extends ScenarioNodeConfigWithExecutionPolicy {
+    connectionId: string;
+    operation: TemporalOperation;
+    /** Overrides the connection's namespace (template-resolved). */
+    namespace?: string;
+    /** Target workflow (template). On startWorkflow, empty = generated id. */
+    workflowId?: string;
+    runId?: string;
+    workflowType?: string;
+    taskQueue?: string;
+    /** JSON array template string — the workflow / query / update / signal arguments. */
+    args?: string;
+    /** startWorkflow: block until the workflow closes and expose its result. */
+    waitForResult?: boolean;
+    idReusePolicy?: TemporalWorkflowIdReusePolicy;
+    idConflictPolicy?: TemporalWorkflowIdConflictPolicy;
+    /** JSON object template string. */
+    memo?: string;
+    /** JSON object template string. */
+    searchAttributes?: string;
+    workflowExecutionTimeoutMs?: number;
+    workflowRunTimeoutMs?: number;
+    workflowTaskTimeoutMs?: number;
+    startDelayMs?: number;
+    retryPolicy?: TemporalRetryPolicyConfig;
+    signalName?: string;
+    /** signalWithStart only: JSON array template string for the signal. */
+    signalArgs?: string;
+    queryName?: string;
+    updateName?: string;
+    waitForStage?: "ACCEPTED" | "COMPLETED";
+    /** Follow continue-as-new / retry chains (default true). */
+    followRuns?: boolean;
+    /** Keep only these event types (names without the EVENT_TYPE_ prefix). */
+    eventTypes?: string[];
+    /** Max events kept in the output (default/cap in graphTraversal). */
+    historyLimit?: number;
+    reason?: string;
+    /** Temporal visibility list filter, e.g. `WorkflowType = 'Order' AND ExecutionStatus = 'Running'`. */
+    query?: string;
+    pageSize?: number;
+    taskQueueType?: "workflow" | "activity";
+    /** Per-node budget for the operation (default/cap in graphTraversal). */
+    timeoutMs?: number;
+    /** awaitResult / startWorkflow+wait: what a timeout does (default fail). */
+    onTimeout?: "fail" | "continue";
+    /** Checks against the node's OWN output (`<Label>.status`, `<Label>.result.x`, …). */
+    expect?: ConditionRule[];
+    expectMatchMode?: AssertionMatchMode;
+}
+export type PollActionType = "request" | "db" | "redis" | "script" | "temporal";
 export interface PollScenarioNodeConfig extends ScenarioNodeConfigWithExecutionPolicy {
     actionType: PollActionType;
     request?: RequestScenarioNodeConfig;
     db?: DbScenarioNodeConfig;
     redis?: RedisScenarioNodeConfig;
     script?: ScriptScenarioNodeConfig;
+    temporal?: TemporalScenarioNodeConfig;
     /** Success test, evaluated after every tick — full condition engine. */
     successCondition: ConditionNodeConfig;
     /** Delay between ticks. */
@@ -383,7 +443,7 @@ export interface AssertionEvaluationResult {
     failedCount: number;
     checks: AssertionCheckResult[];
 }
-export type ScenarioNodeConfig = RequestScenarioNodeConfig | DbScenarioNodeConfig | WaitScenarioNodeConfig | ScriptScenarioNodeConfig | KafkaScenarioNodeConfig | RedisScenarioNodeConfig | NotificationScenarioNodeConfig | ConditionNodeConfig | AssertionScenarioNodeConfig | SetVarsScenarioNodeConfig | PollScenarioNodeConfig | EndScenarioNodeConfig | AggregatorScenarioNodeConfig | SubScenarioNodeConfig | ScenarioRefNodeConfig | ForeachNodeConfig | WebsocketScenarioNodeConfig | AiScenarioNodeConfig;
+export type ScenarioNodeConfig = RequestScenarioNodeConfig | DbScenarioNodeConfig | WaitScenarioNodeConfig | ScriptScenarioNodeConfig | KafkaScenarioNodeConfig | RedisScenarioNodeConfig | NotificationScenarioNodeConfig | ConditionNodeConfig | AssertionScenarioNodeConfig | SetVarsScenarioNodeConfig | PollScenarioNodeConfig | EndScenarioNodeConfig | AggregatorScenarioNodeConfig | SubScenarioNodeConfig | ScenarioRefNodeConfig | ForeachNodeConfig | WebsocketScenarioNodeConfig | AiScenarioNodeConfig | TemporalScenarioNodeConfig;
 interface BaseScenarioNode<TType extends ScenarioNodeType, TConfig extends ScenarioNodeConfig> {
     id: string;
     type: TType;
@@ -411,8 +471,9 @@ export type ScenarioRefNode = BaseScenarioNode<"scenario-ref", ScenarioRefNodeCo
 export type ForeachScenarioNode = BaseScenarioNode<"foreach", ForeachNodeConfig>;
 export type WebsocketScenarioNode = BaseScenarioNode<"websocket", WebsocketScenarioNodeConfig>;
 export type AiScenarioNode = BaseScenarioNode<"ai", AiScenarioNodeConfig>;
+export type TemporalScenarioNode = BaseScenarioNode<"temporal", TemporalScenarioNodeConfig>;
 export type ScenarioPolicyCapableNodeType = Exclude<ScenarioNodeType, "condition">;
-export type ScenarioNode = RequestScenarioNode | DbScenarioNode | WaitScenarioNode | ScriptScenarioNode | KafkaScenarioNode | RedisScenarioNode | NotificationScenarioNode | ConditionScenarioNode | AssertionScenarioNode | SetVarsScenarioNode | PollScenarioNode | EndScenarioNode | AggregatorScenarioNode | SubScenarioNode | ScenarioRefNode | ForeachScenarioNode | WebsocketScenarioNode | AiScenarioNode;
+export type ScenarioNode = RequestScenarioNode | DbScenarioNode | WaitScenarioNode | ScriptScenarioNode | KafkaScenarioNode | RedisScenarioNode | NotificationScenarioNode | ConditionScenarioNode | AssertionScenarioNode | SetVarsScenarioNode | PollScenarioNode | EndScenarioNode | AggregatorScenarioNode | SubScenarioNode | ScenarioRefNode | ForeachScenarioNode | WebsocketScenarioNode | AiScenarioNode | TemporalScenarioNode;
 export type ScenarioPolicyCapableNode = Exclude<ScenarioNode, ConditionScenarioNode>;
 export interface ScenarioEdge {
     id: string;
@@ -857,6 +918,142 @@ export interface ScenarioAiExecutionResult {
     durationMs: number;
     failureMessage: string | null;
 }
+export type TemporalWorkflowStatus = "RUNNING" | "COMPLETED" | "FAILED" | "CANCELED" | "TERMINATED" | "TIMED_OUT" | "CONTINUED_AS_NEW" | "UNKNOWN";
+export interface ScenarioTemporalFailure {
+    message: string;
+    /** ApplicationFailure type / failure kind (e.g. "ActivityFailure", "CanceledFailure"). */
+    type: string | null;
+    stackTrace?: string | null;
+    /** Flattened cause chain (outermost first), each `{ message, type }`. */
+    cause?: Array<{
+        message: string;
+        type: string | null;
+    }>;
+}
+export interface ScenarioTemporalHistoryEvent {
+    eventId: number;
+    /** Event type name without the EVENT_TYPE_ prefix, e.g. "ActivityTaskCompleted". */
+    eventType: string;
+    eventTime: string | null;
+    /** The event's attribute object, payloads decoded (bounded by the host). */
+    attributes?: unknown;
+}
+export type ScenarioTemporalActivityStatus = "scheduled" | "started" | "completed" | "failed" | "timed_out" | "canceled";
+export interface ScenarioTemporalActivity {
+    activityId: string;
+    activityType: string;
+    status: ScenarioTemporalActivityStatus;
+    attempt: number;
+    scheduledAt: string | null;
+    startedAt: string | null;
+    closedAt: string | null;
+    durationMs: number | null;
+    failure: string | null;
+    result?: unknown;
+}
+export interface ScenarioTemporalExecutionSummary {
+    workflowId: string;
+    runId: string;
+    type: string;
+    status: TemporalWorkflowStatus;
+    startTime: string | null;
+    closeTime: string | null;
+    taskQueue: string | null;
+}
+export interface ScenarioTemporalPoller {
+    identity: string;
+    lastAccessTime: string | null;
+    ratePerSecond: number | null;
+}
+export interface ScenarioTemporalResult {
+    operation: TemporalOperation;
+    namespace: string;
+    workflowId: string | null;
+    runId: string | null;
+    status: TemporalWorkflowStatus | null;
+    workflowType: string | null;
+    taskQueue: string | null;
+    /** awaitResult / query / update / startWorkflow+wait: decoded payload. */
+    result: unknown;
+    failure: ScenarioTemporalFailure | null;
+    startTime: string | null;
+    closeTime: string | null;
+    historyLength: number | null;
+    /** describe: decoded memo / search attributes. */
+    memo: Record<string, unknown> | null;
+    searchAttributes: Record<string, unknown> | null;
+    /** describe: in-flight activities; history: every activity seen. */
+    activities: ScenarioTemporalActivity[];
+    pendingChildren: Array<{
+        workflowId: string;
+        runId: string | null;
+        workflowType: string | null;
+    }>;
+    /** history */
+    events: ScenarioTemporalHistoryEvent[];
+    eventCounts: Record<string, number>;
+    signals: Array<{
+        name: string;
+        eventId: number;
+        eventTime: string | null;
+    }>;
+    timers: Array<{
+        timerId: string;
+        fired: boolean;
+        startedAt: string | null;
+    }>;
+    truncatedHistory: boolean;
+    /** list */
+    executions: ScenarioTemporalExecutionSummary[];
+    /** count */
+    count: number | null;
+    groups: Array<{
+        values: string[];
+        count: number;
+    }>;
+    /** describeTaskQueue */
+    pollers: ScenarioTemporalPoller[];
+    hasPollers: boolean | null;
+    /** update: server-assigned update id. */
+    updateId: string | null;
+    /** cancel / terminate / signal */
+    requested: boolean | null;
+    /** awaitResult / startWorkflow+wait: the wait hit the node budget. */
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface ScenarioTemporalExecutionInput {
+    runId: string;
+    stepId: string;
+    node: TemporalScenarioNode;
+    context: Readonly<ScenarioRuntimeContextState>;
+    signal?: AbortLikeSignal;
+}
+export interface ScenarioTemporalNodeDetails {
+    connectionId: string | null;
+    connectionName: string | null;
+    address: string | null;
+    namespace: string | null;
+    operation: TemporalOperation | null;
+    workflowId: string | null;
+    runId: string | null;
+    /** Deep link into the Temporal Web UI when the connection has `uiBaseUrl`. */
+    uiUrl: string | null;
+    durationMs: number;
+    truncatedHistory: boolean;
+}
+export interface ScenarioTemporalExecutionResult {
+    outputData: ScenarioTemporalResult | null;
+    details: ScenarioTemporalNodeDetails;
+    /** Resolved operation parameters — becomes the step's `resolvedInput`. */
+    resolvedInput: unknown;
+    durationMs: number;
+    assertionResults: AssertionCheckResult[];
+    assertionSummary: AssertionEvaluationResult | null;
+    /** Timed out with `onTimeout: "continue"` — mark the step partial_success. */
+    degraded: boolean;
+    failureMessage: string | null;
+}
 export interface ScenarioNotificationExecutionInput {
     runId: string;
     stepId: string;
@@ -874,6 +1071,7 @@ export interface ScenarioRuntimeAdapters {
     websocketExecutor: (input: ScenarioWebsocketExecutionInput) => Promise<ScenarioWebsocketExecutionResult>;
     notificationExecutor: (input: ScenarioNotificationExecutionInput) => Promise<ScenarioNotificationExecutionResult>;
     aiExecutor?: (input: ScenarioAiExecutionInput) => Promise<ScenarioAiExecutionResult>;
+    temporalExecutor?: (input: ScenarioTemporalExecutionInput) => Promise<ScenarioTemporalExecutionResult>;
     dbSessionRelease?: (input: {
         runId: string;
         outcome: "commit" | "rollback";
@@ -981,6 +1179,7 @@ export type ScenarioRunEvent = {
     conditionDebug?: ConditionGroupEvaluation | null;
     activeBranch?: ScenarioBranchKey | null;
     ai?: ScenarioAiNodeDetails | null;
+    temporal?: ScenarioTemporalNodeDetails | null;
     outputData?: unknown;
 }) | (ScenarioStepBaseEvent & {
     type: "step:fail";
@@ -1022,6 +1221,7 @@ export type ScenarioRunEvent = {
     conditionDebug?: ConditionGroupEvaluation | null;
     activeBranch?: ScenarioBranchKey | null;
     ai?: ScenarioAiNodeDetails | null;
+    temporal?: ScenarioTemporalNodeDetails | null;
     outputData?: unknown;
 }) | (ScenarioStepBaseEvent & {
     type: "step:skip";
@@ -1130,6 +1330,8 @@ export interface ScenarioNodeExecutionRecord {
     activeBranch: ScenarioBranchKey | null;
     /** AI node only (additive): provider/model/token metadata + raw reply. */
     ai?: ScenarioAiNodeDetails | null;
+    /** Temporal node only (additive): connection/workflow identifiers + UI link. */
+    temporal?: ScenarioTemporalNodeDetails | null;
     inputData: unknown | null;
     /** Additive (core >= 1.27): see ScenarioStepBaseEvent.resolvedInput. */
     resolvedInput?: unknown | null;