@stigmer/runner 3.0.1

package/dist/activities/execute-deep-agent/writeback-coordinator.js

@@ -0,0 +1,295 @@
+/**
+ * Incremental git write-back coordinator for workspace entries.
+ *
+ * During agent execution, each file-modifying tool call triggers an
+ * incremental commit-and-push cycle for the affected git workspace.
+ * The first cycle creates the branch and PR; subsequent cycles add
+ * commits to the same branch — the PR updates automatically on GitHub.
+ *
+ * DD-5: Incremental writeback, not batch.
+ *
+ * Lifecycle:
+ *   1. Created after workspace provisioning in index.ts.
+ *   2. `onFileModified(path)` called from streaming on each write/edit tool end.
+ *   3. `finalize()` called from post-stream as a safety net.
+ *
+ * Concurrency: one mutex per workspace entry serializes git operations.
+ */
+import { create } from "@bufbuild/protobuf";
+import { WorkspaceWriteBackSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/writeback_pb";
+import { WorkspaceWriteBackPhase, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/writeback_pb";
+import { GitWriteBackMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+import { SourceType } from "../../shared/workspace/types.js";
+const WRITE_BACK_ENABLED_MODES = new Set([
+    GitWriteBackMode.GIT_WRITE_BACK_MODE_UNSPECIFIED,
+    GitWriteBackMode.GIT_WRITE_BACK_BRANCH_AND_PR,
+]);
+export class WriteBackCoordinator {
+    statusWriter;
+    executionId;
+    workspaceBackend;
+    shortId;
+    branchName;
+    eligible = new Map();
+    state = new Map();
+    locks = new Map();
+    constructor(opts) {
+        this.statusWriter = opts.statusWriter;
+        this.executionId = opts.executionId;
+        this.workspaceBackend = opts.workspaceBackend;
+        this.shortId = opts.executionId.slice(0, 8);
+        this.branchName = `stigmer/${this.shortId}`;
+        this.initEligibleEntries(opts.provisionResults, opts.workspaceEntries);
+    }
+    get hasEligibleEntries() {
+        return this.eligible.size > 0;
+    }
+    /**
+     * Called after a file-modifying tool completes. Resolves the path to
+     * a workspace entry and runs an incremental commit/push cycle.
+     * Fire-and-forget: errors are logged, never thrown.
+     */
+    async onFileModified(path) {
+        try {
+            const entryName = this.resolveEntry(path);
+            if (!entryName)
+                return;
+            await this.withLock(entryName, () => this.incrementalWriteBack(entryName));
+        }
+        catch (err) {
+            console.warn(`[WriteBack] execution=${this.executionId} — ` +
+                `onFileModified error for '${path}': ${err}`);
+        }
+    }
+    /**
+     * Post-execution safety net. Checks every eligible workspace entry
+     * for remaining uncommitted changes and commits/pushes them.
+     */
+    async finalize() {
+        for (const entryName of this.eligible.keys()) {
+            try {
+                await this.withLock(entryName, () => this.incrementalWriteBack(entryName));
+            }
+            catch (err) {
+                console.warn(`[WriteBack] execution=${this.executionId} entry=${entryName} — ` +
+                    `finalize error: ${err}`);
+            }
+        }
+    }
+    // ── Initialization ──────────────────────────────────────────────────
+    initEligibleEntries(provisionResults, workspaceEntries) {
+        const modeMap = new Map();
+        for (const entry of workspaceEntries) {
+            const source = entry.source;
+            if (source?.source.case === "gitRepo") {
+                modeMap.set(entry.name, source.source.value.writeBackMode);
+            }
+        }
+        for (const pr of provisionResults) {
+            if (pr.sourceType !== SourceType.GIT_REPO)
+                continue;
+            if (!pr.gitMetadata)
+                continue;
+            if (!pr.gitMetadata.gitCredentialsConfigured)
+                continue;
+            const mode = modeMap.get(pr.entryName) ?? GitWriteBackMode.GIT_WRITE_BACK_MODE_UNSPECIFIED;
+            if (!WRITE_BACK_ENABLED_MODES.has(mode))
+                continue;
+            this.eligible.set(pr.entryName, {
+                provisionResult: pr,
+                baseBranch: pr.gitMetadata.branch,
+                rootDir: pr.rootDir,
+                entryName: pr.entryName,
+            });
+            this.state.set(pr.entryName, {
+                branchCreated: false,
+                prCreated: false,
+                prUrl: "",
+                prNumber: 0,
+                commitCount: 0,
+                lastCommitSha: "",
+                githubToken: "",
+                githubOwner: "",
+                githubRepo: "",
+            });
+        }
+        if (this.eligible.size > 0) {
+            console.log(`[WriteBack] execution=${this.executionId} — coordinator initialized with ` +
+                `${this.eligible.size} eligible workspace(s): ${[...this.eligible.keys()].join(", ")}`);
+        }
+    }
+    // ── Path Resolution ─────────────────────────────────────────────────
+    resolveEntry(path) {
+        if (this.eligible.size === 0)
+            return null;
+        if (this.eligible.size === 1)
+            return this.eligible.keys().next().value;
+        const normalized = path.replace(/^\/+/, "");
+        for (const entryName of this.eligible.keys()) {
+            if (normalized.startsWith(entryName + "/") || normalized === entryName) {
+                return entryName;
+            }
+        }
+        return null;
+    }
+    // ── Core Incremental Write-Back ─────────────────────────────────────
+    async incrementalWriteBack(entryName) {
+        const entry = this.eligible.get(entryName);
+        const entryState = this.state.get(entryName);
+        const rootDir = entry.rootDir;
+        const exec = async (cmd) => {
+            return this.workspaceBackend.execute(`cd ${rootDir} && ${cmd}`);
+        };
+        let mutationStarted = false;
+        try {
+            const hasChanges = await this.hasChanges(exec);
+            if (!hasChanges)
+                return;
+            mutationStarted = true;
+            if (!entryState.branchCreated) {
+                await this.createBranch(entryName, entryState, exec);
+            }
+            const commitMsg = `agent changes (${entryState.commitCount + 1})`;
+            await this.commitAndPush(entryName, entryState, exec, commitMsg);
+            if (!entryState.prCreated) {
+                await this.createPr(entryName, entryState, entry, exec);
+            }
+            await this.updateStatus(entryName, entryState, entry, exec);
+        }
+        catch (err) {
+            console.warn(`[WriteBack] execution=${this.executionId} entry=${entryName} — ` +
+                `incremental error: ${err}`);
+            if (!mutationStarted)
+                return;
+            const wb = create(WorkspaceWriteBackSchema, {
+                workspaceEntryName: entryName,
+                baseBranch: entry.baseBranch,
+                branchName: entryState.branchCreated ? this.branchName : "",
+                phase: WorkspaceWriteBackPhase.WORKSPACE_WRITE_BACK_FAILED,
+                error: String(err),
+            });
+            if (entryState.prCreated) {
+                wb.pullRequestUrl = entryState.prUrl;
+                wb.pullRequestNumber = entryState.prNumber;
+            }
+            this.statusWriter.addWriteBack(wb);
+        }
+    }
+    // ── Git Operations ──────────────────────────────────────────────────
+    async hasChanges(exec) {
+        const diff = await exec("git diff --stat").catch(() => "");
+        const staged = await exec("git diff --cached --stat").catch(() => "");
+        if (diff.trim() || staged.trim())
+            return true;
+        const untracked = await exec("git ls-files --others --exclude-standard").catch(() => "");
+        return untracked.trim().length > 0;
+    }
+    async createBranch(entryName, entryState, exec) {
+        await exec(`git checkout -b ${this.branchName}`);
+        entryState.branchCreated = true;
+        console.log(`[WriteBack] execution=${this.executionId} entry=${entryName} — ` +
+            `created branch ${this.branchName}`);
+    }
+    async commitAndPush(entryName, entryState, exec, commitMsg) {
+        await exec("git add -A");
+        await exec(`git commit -m "${commitMsg}"`);
+        entryState.commitCount++;
+        const shaOutput = await exec("git rev-parse HEAD");
+        entryState.lastCommitSha = shaOutput.trim();
+        if (entryState.commitCount === 1) {
+            await exec(`git push -u origin ${this.branchName}`);
+        }
+        else {
+            await exec("git push");
+        }
+        console.log(`[WriteBack] execution=${this.executionId} entry=${entryName} — ` +
+            `commit #${entryState.commitCount} pushed (sha=${entryState.lastCommitSha.slice(0, 12)})`);
+    }
+    async createPr(entryName, entryState, entry, _exec) {
+        const meta = entry.provisionResult.gitMetadata;
+        const { owner, repo } = parseGithubRepo(meta.repoUrl);
+        if (!entryState.githubToken) {
+            entryState.githubToken = extractGithubToken(meta.repoUrl);
+            entryState.githubOwner = owner;
+            entryState.githubRepo = repo;
+        }
+        const prTitle = `Agent changes (${this.shortId})`;
+        const prBody = `Automated pull request from Stigmer agent execution.\n\n` +
+            `**Execution:** \`${this.executionId}\`\n` +
+            `**Workspace:** \`${entryName}\`\n`;
+        const resp = await fetch(`https://api.github.com/repos/${entryState.githubOwner}/${entryState.githubRepo}/pulls`, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${entryState.githubToken}`,
+                "Accept": "application/vnd.github+json",
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                title: prTitle,
+                body: prBody,
+                head: this.branchName,
+                base: entry.baseBranch,
+            }),
+        });
+        if (!resp.ok) {
+            const body = await resp.text();
+            throw new Error(`GitHub API error (HTTP ${resp.status}): ${body}`);
+        }
+        const data = await resp.json();
+        entryState.prCreated = true;
+        entryState.prUrl = data.html_url ?? "";
+        entryState.prNumber = data.number ?? 0;
+        console.log(`[WriteBack] execution=${this.executionId} entry=${entryName} — ` +
+            `PR #${entryState.prNumber} created: ${entryState.prUrl}`);
+    }
+    async updateStatus(entryName, entryState, entry, exec) {
+        const summaryOutput = await exec(`git diff --stat ${entry.baseBranch}...HEAD`).catch(() => "");
+        const phase = entryState.prCreated
+            ? WorkspaceWriteBackPhase.WORKSPACE_WRITE_BACK_PR_CREATED
+            : WorkspaceWriteBackPhase.WORKSPACE_WRITE_BACK_PUSHED;
+        const wb = create(WorkspaceWriteBackSchema, {
+            workspaceEntryName: entryName,
+            branchName: this.branchName,
+            baseBranch: entry.baseBranch,
+            commitSha: entryState.lastCommitSha,
+            pullRequestUrl: entryState.prUrl,
+            pullRequestNumber: entryState.prNumber,
+            diffSummary: summaryOutput.trim(),
+            phase,
+        });
+        this.statusWriter.addWriteBack(wb);
+    }
+    // ── Concurrency ─────────────────────────────────────────────────────
+    async withLock(entryName, fn) {
+        const existing = this.locks.get(entryName) ?? Promise.resolve();
+        const next = existing.then(fn, fn);
+        this.locks.set(entryName, next);
+        await next;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+/**
+ * Extract GitHub owner and repo from a clone URL.
+ * Supports HTTPS (with or without .git) and SSH formats.
+ */
+export function parseGithubRepo(repoUrl) {
+    const httpsMatch = repoUrl.match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        return { owner: httpsMatch[1], repo: httpsMatch[2] };
+    }
+    throw new Error(`Cannot parse GitHub owner/repo from URL: ${repoUrl}`);
+}
+/**
+ * Extract a GitHub token from an HTTPS clone URL that has credentials embedded.
+ * Format: https://{token}@github.com/...
+ */
+export function extractGithubToken(repoUrl) {
+    const match = repoUrl.match(/https?:\/\/([^@]+)@github\.com/);
+    if (match)
+        return match[1];
+    const envToken = process.env.GITHUB_TOKEN;
+    if (envToken)
+        return envToken;
+    throw new Error("Cannot extract GitHub token from repo URL and GITHUB_TOKEN is not set");
+}
+//# sourceMappingURL=writeback-coordinator.js.map

package/dist/activities/execute-deep-agent/writeback-coordinator.js.map

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

package/dist/activities/hydrate-workflow-execution.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Temporal activity that hydrates a workflow execution from slim IDs
+ * into the fully materialized input the CNCF workflow engine expects.
+ *
+ * Bridges the gap between the Java/Go orchestrators (which pass slim
+ * orchestration coordinates via {@link HydrateInput}) and the TS
+ * workflow engine (which expects a parsed {@link ExecuteServerlessWorkflowInput}).
+ *
+ * Hydration chain:
+ *   1. Fetch WorkflowExecution → extract trigger_message
+ *   2. Resolve Workflow → extract pre-validated YAML from status
+ *   3. Fetch ExecutionContext → flatten env data
+ *   4. Parse YAML → WorkflowModel
+ *   5. Assemble ExecuteServerlessWorkflowInput
+ */
+import { StigmerClient } from "../client/stigmer-client.js";
+import type { Config } from "../config.js";
+import type { ExecuteServerlessWorkflowInput } from "../workflows/execute-serverless-workflow.js";
+export interface HydrateInput {
+    readonly execution_id: string;
+    readonly workflow_instance_id: string;
+    readonly workflow_id: string;
+    readonly org_id: string;
+}
+export declare function createHydrateWorkflowActivities(config: Config): {
+    HydrateWorkflowExecution: (input: HydrateInput) => Promise<ExecuteServerlessWorkflowInput>;
+};
+/**
+ * Core hydration logic — exported separately for unit testing with
+ * a mock client (same pattern as discover-mcp-server.ts).
+ */
+export declare function hydrateWorkflowExecution(input: HydrateInput, client: StigmerClient): Promise<ExecuteServerlessWorkflowInput>;

package/dist/activities/hydrate-workflow-execution.js

@@ -0,0 +1,212 @@
+/**
+ * Temporal activity that hydrates a workflow execution from slim IDs
+ * into the fully materialized input the CNCF workflow engine expects.
+ *
+ * Bridges the gap between the Java/Go orchestrators (which pass slim
+ * orchestration coordinates via {@link HydrateInput}) and the TS
+ * workflow engine (which expects a parsed {@link ExecuteServerlessWorkflowInput}).
+ *
+ * Hydration chain:
+ *   1. Fetch WorkflowExecution → extract trigger_message
+ *   2. Resolve Workflow → extract pre-validated YAML from status
+ *   3. Fetch ExecutionContext → flatten env data
+ *   4. Parse YAML → WorkflowModel
+ *   5. Assemble ExecuteServerlessWorkflowInput
+ */
+import { ApplicationFailure } from "@temporalio/activity";
+import { StigmerClient } from "../client/stigmer-client.js";
+import { loadWorkflowFromYaml } from "../workflow-engine/loader.js";
+import { ValidationState } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/serverless/validation_pb";
+export function createHydrateWorkflowActivities(config) {
+    const client = new StigmerClient({
+        endpoint: config.stigmerBackendEndpoint,
+        token: config.stigmerToken,
+        tokenRef: config.stigmerTokenRef,
+    });
+    return {
+        HydrateWorkflowExecution: (input) => hydrateWorkflowExecution(input, client),
+    };
+}
+/**
+ * Core hydration logic — exported separately for unit testing with
+ * a mock client (same pattern as discover-mcp-server.ts).
+ */
+export async function hydrateWorkflowExecution(input, client) {
+    const { execution_id, workflow_instance_id, workflow_id, org_id } = input;
+    // 1. Fetch WorkflowExecution for trigger_message and version hash
+    const workflowExecution = await fetchWorkflowExecution(client, execution_id);
+    const triggerMessage = workflowExecution.spec?.triggerMessage ?? "";
+    const versionHash = workflowExecution.status?.workflowVersionHash;
+    // 2. Resolve workflow ID — prefer direct workflow_id, fall back to instance lookup
+    const resolvedWorkflowId = await resolveWorkflowId(client, workflow_id, workflow_instance_id);
+    // 3. Fetch workflow YAML — use pinned version if available, otherwise live workflow
+    const yaml = await fetchWorkflowYaml(client, resolvedWorkflowId, versionHash);
+    // 4. Parse YAML into WorkflowModel
+    const model = parseWorkflowYaml(yaml, resolvedWorkflowId);
+    // 5. Fetch ExecutionContext and flatten env
+    const env = await fetchAndFlattenEnv(client, execution_id);
+    // 6. Parse trigger_message as workflow_input
+    const workflow_input = parseTriggerMessage(triggerMessage);
+    return {
+        model,
+        workflow_input,
+        env,
+        metadata: {
+            execution_id,
+            workflow_id: resolvedWorkflowId,
+            workflow_instance_id,
+            org_id,
+        },
+    };
+}
+async function fetchWorkflowExecution(client, executionId) {
+    try {
+        return await client.getWorkflowExecution(executionId);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 5 || code === "not_found" || code === "NOT_FOUND") {
+            throw ApplicationFailure.nonRetryable(`WorkflowExecution '${executionId}' not found`, "WORKFLOW_EXECUTION_NOT_FOUND");
+        }
+        throw err;
+    }
+}
+async function resolveWorkflowId(client, workflowId, workflowInstanceId) {
+    if (workflowId)
+        return workflowId;
+    if (!workflowInstanceId) {
+        throw ApplicationFailure.nonRetryable("Neither workflow_id nor workflow_instance_id provided — cannot resolve workflow", "MISSING_WORKFLOW_REFERENCE");
+    }
+    try {
+        const instance = await client.getWorkflowInstance(workflowInstanceId);
+        const resolved = instance.spec?.workflowId;
+        if (!resolved) {
+            throw ApplicationFailure.nonRetryable(`WorkflowInstance '${workflowInstanceId}' has no workflow_id in spec`, "INVALID_WORKFLOW_INSTANCE");
+        }
+        return resolved;
+    }
+    catch (err) {
+        if (err instanceof ApplicationFailure)
+            throw err;
+        const code = err?.code;
+        if (code === 5 || code === "not_found" || code === "NOT_FOUND") {
+            throw ApplicationFailure.nonRetryable(`WorkflowInstance '${workflowInstanceId}' not found`, "WORKFLOW_INSTANCE_NOT_FOUND");
+        }
+        throw err;
+    }
+}
+/**
+ * Fetches the CNCF YAML for a workflow, using version pinning when available.
+ *
+ * Resolution strategy:
+ * 1. If versionHash is provided, fetch the specific version entry's YAML
+ * 2. If version fetch fails or versionHash is absent, fall back to live workflow
+ *
+ * This ensures backward compatibility with pre-versioning executions while
+ * providing correctness for versioned executions.
+ */
+async function fetchWorkflowYaml(client, workflowId, versionHash) {
+    // Path 1: Versioned execution — fetch YAML from the pinned version entry
+    if (versionHash) {
+        try {
+            const versionEntry = await client.getWorkflowVersion(workflowId, versionHash);
+            if (versionEntry?.validatedYaml) {
+                console.log(`[hydrate] Resolved workflow YAML from pinned version: hash=${versionHash.slice(0, 12)}...`);
+                return versionEntry.validatedYaml;
+            }
+        }
+        catch (err) {
+            // Version entry not found — fall through to live workflow fetch.
+            // This handles the edge case of data migration (execution created after
+            // versioning enabled, but audit entry not yet backfilled).
+            console.warn(`[hydrate] Failed to fetch workflow version ${versionHash.slice(0, 12)}... ` +
+                `— falling back to live workflow fetch`, err);
+        }
+    }
+    // Path 2: Legacy execution or version fetch failed — use live workflow
+    return fetchAndValidateWorkflowYamlLive(client, workflowId);
+}
+async function fetchAndValidateWorkflowYamlLive(client, workflowId) {
+    let workflow;
+    try {
+        workflow = await client.getWorkflow(workflowId);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 5 || code === "not_found" || code === "NOT_FOUND") {
+            throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' not found`, "WORKFLOW_NOT_FOUND");
+        }
+        throw err;
+    }
+    const validation = workflow.status?.serverlessWorkflowValidation;
+    if (!validation) {
+        throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' has no serverless_workflow_validation in status — ` +
+            `the workflow may not have been validated yet`, "MISSING_VALIDATION");
+    }
+    switch (validation.state) {
+        case ValidationState.VALID:
+            break;
+        case ValidationState.PENDING:
+            throw ApplicationFailure.retryable(`Workflow '${workflowId}' validation is still in progress — retrying`, "VALIDATION_PENDING");
+        case ValidationState.INVALID:
+            throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' validation failed: ${validation.errors.join("; ")}`, "VALIDATION_INVALID");
+        case ValidationState.FAILED:
+            throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' validation encountered a system error — ` +
+                `retry validation or contact support`, "VALIDATION_FAILED");
+        default:
+            throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' has unexpected validation state: ${validation.state}`, "VALIDATION_UNKNOWN_STATE");
+    }
+    const yaml = validation.yaml;
+    if (!yaml) {
+        throw ApplicationFailure.nonRetryable(`Workflow '${workflowId}' has VALID validation state but empty YAML — ` +
+            `the workflow status may not be fully populated (known OSS gap: ` +
+            `PopulateServerlessValidation step is not implemented in the Go server)`, "YAML_EMPTY");
+    }
+    return yaml;
+}
+function parseWorkflowYaml(yaml, workflowId) {
+    try {
+        return loadWorkflowFromYaml(yaml);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw ApplicationFailure.nonRetryable(`Failed to parse CNCF Serverless Workflow YAML for workflow '${workflowId}': ${message}`, "YAML_PARSE_ERROR");
+    }
+}
+async function fetchAndFlattenEnv(client, executionId) {
+    let execCtx;
+    try {
+        execCtx = await client.getExecutionContextByExecutionId(executionId);
+    }
+    catch (err) {
+        // ConnectError uses numeric Code.NotFound (5); match the pattern
+        // from execute-cursor/env-resolver.ts.
+        const code = err?.code;
+        if (code === 5 || code === "not_found" || code === "NOT_FOUND") {
+            console.log(`[hydrate] No ExecutionContext found for execution ${executionId} — ` +
+                `proceeding with empty environment`);
+            return {};
+        }
+        throw err;
+    }
+    const env = {};
+    const data = execCtx.spec?.data;
+    if (data) {
+        for (const [key, execValue] of Object.entries(data)) {
+            env[key] = execValue.value;
+        }
+    }
+    console.log(`[hydrate] Resolved environment: env_count=${Object.keys(env).length}`);
+    return env;
+}
+function parseTriggerMessage(triggerMessage) {
+    if (!triggerMessage)
+        return null;
+    try {
+        return JSON.parse(triggerMessage);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=hydrate-workflow-execution.js.map

package/dist/activities/hydrate-workflow-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-workflow-execution.js","sourceRoot":"","sources":["../../src/activities/hydrate-workflow-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,yEAAyE,CAAC;AAW1G,MAAM,UAAU,+BAA+B,CAAC,MAAc;IAC5D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,sBAAsB;QACvC,KAAK,EAAE,MAAM,CAAC,YAAY;QAC1B,QAAQ,EAAE,MAAM,CAAC,eAAe;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,wBAAwB,EAAE,CAAC,KAAmB,EAA2C,EAAE,CACzF,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAmB,EACnB,MAAqB;IAErB,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE1E,kEAAkE;IAClE,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,EAAE,cAAc,IAAI,EAAE,CAAC;IACpE,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAElE,mFAAmF;IACnF,MAAM,kBAAkB,GAAG,MAAM,iBAAiB,CAChD,MAAM,EAAE,WAAW,EAAE,oBAAoB,CAC1C,CAAC;IAEF,oFAAoF;IACpF,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;IAE9E,mCAAmC;IACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAE1D,4CAA4C;IAC5C,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE3D,6CAA6C;IAC7C,MAAM,cAAc,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAE3D,OAAO;QACL,KAAK;QACL,cAAc;QACd,GAAG;QACH,QAAQ,EAAE;YACR,YAAY;YACZ,WAAW,EAAE,kBAAkB;YAC/B,oBAAoB;YACpB,MAAM;SACP;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,MAAqB,EACrB,WAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAAkC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/D,MAAM,kBAAkB,CAAC,YAAY,CACnC,sBAAsB,WAAW,aAAa,EAC9C,8BAA8B,CAC/B,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAAqB,EACrB,UAAkB,EAClB,kBAA0B;IAE1B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,kBAAkB,CAAC,YAAY,CACnC,iFAAiF,EACjF,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,kBAAkB,CAAC,YAAY,CACnC,qBAAqB,kBAAkB,8BAA8B,EACrE,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,kBAAkB;YAAE,MAAM,GAAG,CAAC;QACjD,MAAM,IAAI,GAAI,GAAkC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/D,MAAM,kBAAkB,CAAC,YAAY,CACnC,qBAAqB,kBAAkB,aAAa,EACpD,6BAA6B,CAC9B,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAAqB,EACrB,UAAkB,EAClB,WAA+B;IAE/B,yEAAyE;IACzE,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YAC9E,IAAI,YAAY,EAAE,aAAa,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CACT,8DAA8D,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAC5F,CAAC;gBACF,OAAO,YAAY,CAAC,aAAa,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,iEAAiE;YACjE,wEAAwE;YACxE,2DAA2D;YAC3D,OAAO,CAAC,IAAI,CACV,8CAA8C,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM;gBAC5E,uCAAuC,EACvC,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,OAAO,gCAAgC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,gCAAgC,CAC7C,MAAqB,EACrB,UAAkB;IAElB,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAAkC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/D,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,aAAa,EACpC,oBAAoB,CACrB,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IACjE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,sDAAsD;YAC7E,8CAA8C,EAC9C,oBAAoB,CACrB,CAAC;IACJ,CAAC;IAED,QAAQ,UAAU,CAAC,KAAK,EAAE,CAAC;QACzB,KAAK,eAAe,CAAC,KAAK;YACxB,MAAM;QACR,KAAK,eAAe,CAAC,OAAO;YAC1B,MAAM,kBAAkB,CAAC,SAAS,CAChC,aAAa,UAAU,8CAA8C,EACrE,oBAAoB,CACrB,CAAC;QACJ,KAAK,eAAe,CAAC,OAAO;YAC1B,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,wBAAwB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC7E,oBAAoB,CACrB,CAAC;QACJ,KAAK,eAAe,CAAC,MAAM;YACzB,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,4CAA4C;gBACnE,qCAAqC,EACrC,mBAAmB,CACpB,CAAC;QACJ;YACE,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,sCAAsC,UAAU,CAAC,KAAK,EAAE,EAC/E,0BAA0B,CAC3B,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,kBAAkB,CAAC,YAAY,CACnC,aAAa,UAAU,gDAAgD;YACvE,iEAAiE;YACjE,wEAAwE,EACxE,YAAY,CACb,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,UAAkB;IACzD,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,kBAAkB,CAAC,YAAY,CACnC,+DAA+D,UAAU,MAAM,OAAO,EAAE,EACxF,kBAAkB,CACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,MAAqB,EACrB,WAAmB;IAEnB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,iEAAiE;QACjE,uCAAuC;QACvC,MAAM,IAAI,GAAI,GAAkC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/D,OAAO,CAAC,GAAG,CACT,qDAAqD,WAAW,KAAK;gBACrE,mCAAmC,CACpC,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IAChC,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CACT,6CAA6C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CACvE,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,mBAAmB,CAAC,cAAsB;IACjD,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/activities/notification.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Notification Temporal activity — sends fire-and-forget notifications
+ * through channel providers (webhook, etc.).
+ *
+ * Resolves JIT placeholders in body, subject, recipients, and metadata
+ * values before dispatching to the provider. Delivery is non-fatal:
+ * errors produce a result with delivered=false rather than failing
+ * the activity.
+ */
+import { type NotificationResult } from "../notification/index.js";
+export interface NotificationConfig {
+    readonly channel: string;
+    readonly recipients: readonly string[];
+    readonly subject?: string;
+    readonly body: string;
+    readonly template?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+export declare function notificationAction(config: NotificationConfig, runtimeEnv: Record<string, unknown>): Promise<NotificationResult>;

package/dist/activities/notification.js

@@ -0,0 +1,47 @@
+/**
+ * Notification Temporal activity — sends fire-and-forget notifications
+ * through channel providers (webhook, etc.).
+ *
+ * Resolves JIT placeholders in body, subject, recipients, and metadata
+ * values before dispatching to the provider. Delivery is non-fatal:
+ * errors produce a result with delivered=false rather than failing
+ * the activity.
+ */
+import { getProvider } from "../notification/index.js";
+import { resolveObjectPlaceholders } from "../workflow-engine/resolve.js";
+function resolveStringPlaceholder(value, env) {
+    const resolved = resolveObjectPlaceholders({ __v: value }, env);
+    return String(resolved.__v ?? value);
+}
+export async function notificationAction(config, runtimeEnv) {
+    if (!config.channel) {
+        throw new Error("notification: 'channel' field is required");
+    }
+    if (!config.body) {
+        throw new Error("notification: 'body' field is required");
+    }
+    if (!config.recipients || config.recipients.length === 0) {
+        throw new Error("notification: at least one recipient is required");
+    }
+    const resolvedBody = resolveStringPlaceholder(config.body, runtimeEnv);
+    const resolvedSubject = config.subject
+        ? resolveStringPlaceholder(config.subject, runtimeEnv)
+        : "";
+    const resolvedRecipients = config.recipients.map(r => resolveStringPlaceholder(r, runtimeEnv));
+    const resolvedMetadata = {};
+    if (config.metadata) {
+        for (const [k, v] of Object.entries(config.metadata)) {
+            resolvedMetadata[k] = resolveStringPlaceholder(v, runtimeEnv);
+        }
+    }
+    const provider = getProvider(config.channel);
+    return provider.send({
+        channel: config.channel,
+        recipients: resolvedRecipients,
+        subject: resolvedSubject,
+        body: resolvedBody,
+        template: config.template,
+        metadata: resolvedMetadata,
+    });
+}
+//# sourceMappingURL=notification.js.map

package/dist/activities/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/activities/notification.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAA2B,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAW1E,SAAS,wBAAwB,CAC/B,KAAa,EACb,GAA4B;IAE5B,MAAM,QAAQ,GAAG,yBAAyB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,CAA4B,CAAC;IAC3F,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA0B,EAC1B,UAAmC;IAEnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,YAAY,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;QACpC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC;QACtD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAC9C,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,EAAE,UAAU,CAAC,CAC7C,CAAC;IAEF,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,gBAAgB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7C,OAAO,QAAQ,CAAC,IAAI,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;AACL,CAAC"}