callman-core 1.32.0 → 1.33.0

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

@@ -0,0 +1,386 @@
+"use strict";
+// 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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTemporalUiUrl = exports.resolveTemporalOperation = exports.getTemporalNodeMissingFields = exports.TemporalConfigError = exports.createEmptyTemporalResult = exports.TEMPORAL_WORKFLOW_ID_CONFLICT_POLICIES = exports.TEMPORAL_WORKFLOW_ID_REUSE_POLICIES = exports.TEMPORAL_OPERATION_SPECS = exports.isTemporalOperation = exports.TEMPORAL_OPERATIONS = void 0;
+exports.TEMPORAL_OPERATIONS = [
+    "startWorkflow",
+    "signal",
+    "signalWithStart",
+    "query",
+    "update",
+    "awaitResult",
+    "describe",
+    "history",
+    "cancel",
+    "terminate",
+    "list",
+    "count",
+    "describeTaskQueue",
+];
+const isTemporalOperation = (value) => typeof value === "string" && exports.TEMPORAL_OPERATIONS.includes(value);
+exports.isTemporalOperation = isTemporalOperation;
+const START_OPTIONS = [
+    "idReusePolicy",
+    "idConflictPolicy",
+    "memo",
+    "searchAttributes",
+    "workflowExecutionTimeoutMs",
+    "workflowRunTimeoutMs",
+    "workflowTaskTimeoutMs",
+    "startDelayMs",
+    "retryPolicy",
+];
+exports.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,
+    },
+};
+exports.TEMPORAL_WORKFLOW_ID_REUSE_POLICIES = [
+    "ALLOW_DUPLICATE",
+    "ALLOW_DUPLICATE_FAILED_ONLY",
+    "REJECT_DUPLICATE",
+    "TERMINATE_IF_RUNNING",
+];
+exports.TEMPORAL_WORKFLOW_ID_CONFLICT_POLICIES = [
+    "FAIL",
+    "USE_EXISTING",
+    "TERMINATE_EXISTING",
+];
+/** Every key of ScenarioTemporalResult, with its "not applicable" value. */
+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,
+});
+exports.createEmptyTemporalResult = createEmptyTemporalResult;
+class TemporalConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TemporalConfigError";
+    }
+}
+exports.TemporalConfigError = 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.
+ */
+const getTemporalNodeMissingFields = (config) => {
+    const operation = config?.operation;
+    if (!(0, exports.isTemporalOperation)(operation)) {
+        return ["operation"];
+    }
+    const missing = [];
+    if (isBlank(config?.connectionId)) {
+        missing.push("connectionId");
+    }
+    for (const field of exports.TEMPORAL_OPERATION_SPECS[operation].required) {
+        if (isBlank(config?.[field])) {
+            missing.push(String(field));
+        }
+    }
+    return missing;
+};
+exports.getTemporalNodeMissingFields = getTemporalNodeMissingFields;
+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).
+ */
+const resolveTemporalOperation = (config, resolve, resolveJson, options = {}) => {
+    if (!(0, exports.isTemporalOperation)(config.operation)) {
+        throw new TemporalConfigError(`Temporal node has no operation. Choose one of: ${exports.TEMPORAL_OPERATIONS.join(", ")}.`);
+    }
+    const spec = exports.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 &&
+                exports.TEMPORAL_WORKFLOW_ID_REUSE_POLICIES.includes(config.idReusePolicy)
+                ? { idReusePolicy: config.idReusePolicy }
+                : {}),
+            ...(config.idConflictPolicy &&
+                exports.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) }
+                : {}),
+        },
+    };
+};
+exports.resolveTemporalOperation = resolveTemporalOperation;
+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. */
+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;
+};
+exports.buildTemporalUiUrl = buildTemporalUiUrl;
+//# sourceMappingURL=temporal.js.map

package/dist-cjs/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-cjs/ui-test/commands.js

@@ -329,6 +329,77 @@ exports.UI_TEST_COMMANDS = [
             { name: "expect", type: "map", description: "Expected values." },
         ],
         example: '- redisCheck:\n    connection: "redis-dev"\n    key: "otp:{{phone}}"\n    extract:\n      otp: "value"' }),
+    cmd({ key: "temporalStart", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Start a Temporal workflow through a workspace connection; extract its ids (or result when waiting).",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowType", type: "string", required: true, description: "Workflow type name." },
+            { name: "taskQueue", type: "string", required: true, description: "Task queue." },
+            { name: "workflowId", type: "string", description: "Workflow id; empty = generated. {{vars}} allowed." },
+            { name: "args", type: "list", description: "Workflow arguments (list; mappings sent as JSON)." },
+            { name: "waitForResult", type: "boolean", description: "Block until the workflow closes and expose result/status." },
+            { name: "extract", type: "map", description: "{ var: \"workflowId\" | \"runId\" | \"result.path\" }." },
+            { name: "expect", type: "map|list", description: "Map {path: value} or list [{field, op, value}] over the output (status, result.*)." },
+            TIMEOUT,
+        ],
+        example: '- temporalStart:\n    connection: "temporal-dev"\n    workflowType: "OrderWorkflow"\n    taskQueue: "orders"\n    workflowId: "order-{{orderNo}}"\n    args:\n      - { orderId: "{{orderNo}}" }\n    extract:\n      runId: "runId"' }),
+    cmd({ key: "temporalSignal", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Send a signal to a running Temporal workflow.",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowId", type: "string", required: true, description: "Workflow id. {{vars}} allowed." },
+            { name: "signalName", type: "string", required: true, description: "Signal name." },
+            { name: "args", type: "list", description: "Signal arguments." },
+            { name: "runId", type: "string", description: "Run id (default: latest run)." },
+            TIMEOUT,
+        ],
+        example: '- temporalSignal:\n    connection: "temporal-dev"\n    workflowId: "order-{{orderNo}}"\n    signalName: "paymentReceived"\n    args:\n      - { amount: 100 }' }),
+    cmd({ key: "temporalQuery", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Query a Temporal workflow's state; extract and assert on the reply.",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowId", type: "string", required: true, description: "Workflow id. {{vars}} allowed." },
+            { name: "queryName", type: "string", required: true, description: "Query handler name." },
+            { name: "args", type: "list", description: "Query arguments." },
+            { name: "runId", type: "string", description: "Run id (default: latest run)." },
+            { name: "extract", type: "map", description: "{ var: \"result.path\" }." },
+            { name: "expect", type: "map|list", description: "Map {path: value} or list [{field, op, value}] over the output (result.*)." },
+            TIMEOUT,
+        ],
+        example: '- temporalQuery:\n    connection: "temporal-dev"\n    workflowId: "order-{{orderNo}}"\n    queryName: "getStatus"\n    expect:\n      - field: "result.step"\n        op: equals\n        value: "SHIPPED"' }),
+    cmd({ key: "temporalAwait", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Wait for a Temporal workflow to close; assert on its status / result.",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowId", type: "string", required: true, description: "Workflow id. {{vars}} allowed." },
+            { name: "runId", type: "string", description: "Run id (default: latest run, following continue-as-new)." },
+            { name: "extract", type: "map", description: "{ var: \"result.path\" | \"status\" }." },
+            { name: "expect", type: "map|list", description: "Map {path: value} or list [{field, op, value}] over the output (status, result.*, failure.message)." },
+            TIMEOUT,
+        ],
+        example: '- temporalAwait:\n    connection: "temporal-dev"\n    workflowId: "order-{{orderNo}}"\n    timeout: 60000\n    expect:\n      status: "COMPLETED"' }),
+    cmd({ key: "temporalDescribe", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Describe a Temporal workflow (status, type, task queue, pending activities); extract and assert.",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowId", type: "string", required: true, description: "Workflow id. {{vars}} allowed." },
+            { name: "runId", type: "string", description: "Run id (default: latest run)." },
+            { name: "extract", type: "map", description: "{ var: \"status\" | \"runId\" | \"workflowType\" }." },
+            { name: "expect", type: "map|list", description: "Map {path: value} or list [{field, op, value}] over the output." },
+            TIMEOUT,
+        ],
+        example: '- temporalDescribe:\n    connection: "temporal-dev"\n    workflowId: "order-{{orderNo}}"\n    expect:\n      status: "RUNNING"' }),
+    cmd({ key: "temporalCancel", category: "Data / Hybrid", platforms: ALL, hybrid: true,
+        summary: "Request cancellation of a Temporal workflow (or terminate it).",
+        args: [
+            { name: "connection", type: "string", required: true, description: "Temporal connection name or id." },
+            { name: "workflowId", type: "string", required: true, description: "Workflow id. {{vars}} allowed." },
+            { name: "runId", type: "string", description: "Run id (default: latest run)." },
+            { name: "terminate", type: "boolean", description: "Terminate immediately instead of a cooperative cancel." },
+            { name: "reason", type: "string", description: "Reason recorded in the history." },
+            TIMEOUT,
+        ],
+        example: '- temporalCancel:\n    connection: "temporal-dev"\n    workflowId: "order-{{orderNo}}"\n    reason: "test cleanup"' }),
     cmd({ key: "runScript", category: "Data / Hybrid", platforms: MOBILE, forms: ["scalar"], scalarArg: "path",
         summary: "Run a JS file with the mobile engine.", args: [{ name: "path", type: "string", required: true, description: "Script file." }], example: '- runScript: "setup.js"' }),
     // ── Media ─────────────────────────────────────────────────────────────────