@sensigo/realm-cli 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# @sensigo/realm-cli
+
+Run autonomous agent workflows, host an MCP server over HTTP, and manage workflow definitions and run history from the terminal.
+
+## Installation
+
+```
+npm install -g @sensigo/realm-cli
+```
+
+## Commands
+
+### realm workflow \<command\>
+
+| Command    | Description                                           |
+| ---------- | ----------------------------------------------------- |
+| `init`     | Scaffold a new workflow directory                     |
+| `validate` | Validate a workflow YAML file                         |
+| `register` | Register a workflow from a directory                  |
+| `watch`    | Watch a workflow directory and re-register on changes |
+| `run`      | Start a workflow run                                  |
+| `test`     | Run workflow tests                                    |
+| `migrate`  | Apply schema migrations to stored runs                |
+
+### realm run \<command\>
+
+| Command   | Description                        |
+| --------- | ---------------------------------- |
+| `list`    | List all runs                      |
+| `inspect` | Inspect a run's steps and evidence |
+| `replay`  | Replay a completed run             |
+| `diff`    | Diff two run records               |
+| `resume`  | Resume a paused run                |
+| `respond` | Submit a response to a human gate  |
+| `cleanup` | Delete old or terminal runs        |
+
+### Top-level commands
+
+| Command | Description                                |
+| ------- | ------------------------------------------ |
+| `mcp`   | Start the MCP server over stdio            |
+| `serve` | Start the HTTP gateway                     |
+| `agent` | Run a workflow step using a built-in agent |
+
+## Using `realm agent`
+
+| Flag                | Description                                                    |
+| ------------------- | -------------------------------------------------------------- |
+| `--workflow <path>` | Path to workflow directory or `workflow.yaml` file             |
+| `--provider <name>` | LLM provider: `openai` or `anthropic` (auto-detected from env) |
+| `--model <name>`    | Model name override (default: `gpt-4o` / `claude-sonnet-4-5`)  |
+| `--base-url <url>`  | Base URL for OpenAI-compatible endpoints                       |
+| `--run-id <id>`     | Attach to an existing run                                      |
+| `--params <json>`   | Initial run parameters as JSON                                 |
+| `--register`        | Persist the workflow definition to `~/.realm/workflows/`       |
+
+**DeepSeek / Qwen / other OpenAI-compatible providers:**
+
+```bash
+OPENAI_API_KEY=<your-key> realm agent \
+  --workflow ./my-workflow \
+  --provider openai \
+  --base-url https://api.deepseek.com \
+  --model deepseek-chat
+```
+
+## Custom Providers
+
+`realm agent` supports custom LLM providers via `--provider-module`. Pass the path to an ESM
+module that exports an instance of `LlmProvider` or `ToolCapableLlmProvider` as its default
+export.
+
+**Minimal example:**
+
+```typescript
+// my-ollama-provider.ts
+import { LlmProvider } from '@sensigo/realm-cli/agent';
+
+class OllamaProvider extends LlmProvider {
+  async callStep(prompt: string): Promise<Record<string, unknown>> {
+    // call your local Ollama endpoint here
+    const response = await fetch('http://localhost:11434/api/generate', { ... });
+    return await response.json() as Record<string, unknown>;
+  }
+}
+
+export default new OllamaProvider();
+```
+
+```bash
+realm agent --workflow ./my-workflow --provider-module ./my-ollama-provider.js
+```
+
+The module must export an **instance** (not a class) as its default export. The instance must
+extend `LlmProvider` (for basic steps) or `ToolCapableLlmProvider` (for tool-enabled steps),
+both exported from `@sensigo/realm-cli/agent`.
+
+Custom provider modules are user-supplied code executed in the same process as `realm agent`.
+Only use modules you trust.
+
+`--provider-module` cannot be combined with `--provider`, `--model`, or `--base-url`.
+
+## Programmatic extension
+
+The `@sensigo/realm-cli` package exports its command groups for embedding in custom CLI applications. Import `workflowCommands`, `runCommands`, and `topLevelCommands` (arrays of `Command` objects from `commander`) and register them into your own CLI program.
+
+## Full documentation
+
+Full documentation: https://github.com/sensigo-hq/realm

package/dist/agent/agent-utils.d.ts

@@ -0,0 +1,27 @@
+/** Builds the system prompt for an agent step, optionally including the output schema. */
+export declare function buildSystemPrompt(inputSchema?: Record<string, unknown>): string;
+/**
+ * Converts an error value to a string and strips sensitive patterns:
+ * Bearer tokens, query-string tokens, and any process.env value longer than 4 characters.
+ */
+export declare function sanitizeError(err: unknown): string;
+/**
+ * Serializes an MCP tool result to a string and applies the same sanitization pass
+ * as sanitizeError to strip any tokens that upstream services may have echoed.
+ */
+export declare function serializeToolResult(result: unknown): string;
+/** Splits "server_id:tool_name" into its components. Throws if the format is invalid. */
+export declare function parseNamespacedId(id: string): {
+    serverId: string;
+    toolName: string;
+};
+/** Tries to parse JSON; returns a plain object or null if parsing fails or the result is not an object. */
+export declare function tryParseJson(text: string): Record<string, unknown> | null;
+/**
+ * Returns true if all required properties from the schema are present in the parsed object.
+ * Returns true when no schema is provided.
+ */
+export declare function validateSchema(parsed: Record<string, unknown>, schema?: Record<string, unknown>): boolean;
+/** Returns a Promise that rejects with a timeout error after `ms` milliseconds. */
+export declare function rejectAfter(ms: number): Promise<never>;
+//# sourceMappingURL=agent-utils.d.ts.map

package/dist/agent/agent-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-utils.d.ts","sourceRoot":"","sources":["../../src/agent/agent-utils.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAG/E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAiBlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMpF;AAED,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAKT;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAItD"}

package/dist/agent/agent-utils.js

@@ -0,0 +1,79 @@
+// agent-utils.ts — Shared utility functions for LLM provider agentic loops.
+const SYSTEM_PROMPT_BASE = 'You are an AI agent executing a step in a structured workflow.\n' +
+    'Your task is described below. Respond with a JSON object only — no markdown, no explanation.';
+/** Builds the system prompt for an agent step, optionally including the output schema. */
+export function buildSystemPrompt(inputSchema) {
+    if (inputSchema === undefined)
+        return SYSTEM_PROMPT_BASE;
+    return `${SYSTEM_PROMPT_BASE}\nThe JSON must conform to this schema: ${JSON.stringify(inputSchema)}`;
+}
+/**
+ * Converts an error value to a string and strips sensitive patterns:
+ * Bearer tokens, query-string tokens, and any process.env value longer than 4 characters.
+ */
+export function sanitizeError(err) {
+    let text;
+    if (err instanceof Error) {
+        text = err.message;
+    }
+    else if (typeof err === 'string') {
+        text = err;
+    }
+    else {
+        text = String(err);
+    }
+    text = text.replace(/Bearer [A-Za-z0-9._-]+/g, 'Bearer [REDACTED]');
+    text = text.replace(/token=[A-Za-z0-9._-]+/g, 'token=[REDACTED]');
+    for (const val of Object.values(process.env)) {
+        if (val !== undefined && val.length > 4) {
+            text = text.split(val).join('[REDACTED]');
+        }
+    }
+    return text;
+}
+/**
+ * Serializes an MCP tool result to a string and applies the same sanitization pass
+ * as sanitizeError to strip any tokens that upstream services may have echoed.
+ */
+export function serializeToolResult(result) {
+    const raw = typeof result === 'string' ? result : JSON.stringify(result);
+    return sanitizeError(raw);
+}
+/** Splits "server_id:tool_name" into its components. Throws if the format is invalid. */
+export function parseNamespacedId(id) {
+    const colonIdx = id.indexOf(':');
+    if (colonIdx === -1) {
+        throw new Error(`Invalid namespaced tool id '${id}' (expected format: 'serverId:toolName')`);
+    }
+    return { serverId: id.slice(0, colonIdx), toolName: id.slice(colonIdx + 1) };
+}
+/** Tries to parse JSON; returns a plain object or null if parsing fails or the result is not an object. */
+export function tryParseJson(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Returns true if all required properties from the schema are present in the parsed object.
+ * Returns true when no schema is provided.
+ */
+export function validateSchema(parsed, schema) {
+    if (!schema)
+        return true;
+    const required = schema['required'];
+    if (!Array.isArray(required))
+        return true;
+    return required.every((key) => typeof key === 'string' && key in parsed);
+}
+/** Returns a Promise that rejects with a timeout error after `ms` milliseconds. */
+export function rejectAfter(ms) {
+    return new Promise((_, reject) => setTimeout(() => reject(new Error(`tool call timed out after ${ms}ms`)), ms));
+}
+//# sourceMappingURL=agent-utils.js.map

package/dist/agent/agent-utils.js.map

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

package/dist/agent/anthropic-provider.d.ts

@@ -0,0 +1,23 @@
+import { ToolCapableLlmProvider } from './llm-provider.js';
+import type { ToolDefinition, ToolExecutor, StepWithToolsResult } from './mcp-types.js';
+/**
+ * Anthropic LLM provider for realm agent.
+ * Uses the Messages API and extracts JSON from the first text content block.
+ * Retries once if the model returns non-JSON content.
+ */
+export declare class AnthropicProvider extends ToolCapableLlmProvider {
+    private readonly model;
+    constructor(model: string);
+    callStep(prompt: string, inputSchema?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Agentic loop for tool-capable steps. Executes tool calls serially (V1 constraint).
+     * All tool results for one turn are accumulated into a single user message with an array
+     * of tool_result blocks — the Anthropic API rejects interleaved assistant/user turns.
+     */
+    callStepWithTools(prompt: string, tools: ToolDefinition[], executor: ToolExecutor, options: {
+        inputSchema?: Record<string, unknown>;
+        maxToolCalls?: number;
+        toolTimeoutMs?: number;
+    }): Promise<StepWithToolsResult>;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/agent/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/agent/anthropic-provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAWxB;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;IAIpC,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoDnC;;;;OAIG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,mBAAmB,CAAC;CAiNhC"}

package/dist/agent/anthropic-provider.js

@@ -0,0 +1,245 @@
+// anthropic-provider.ts — Anthropic LLM provider implementation for realm agent.
+// Requires @anthropic-ai/sdk >= 0.20.0 as an optional peer dependency (npm install @anthropic-ai/sdk).
+import { WorkflowError } from '@sensigo/realm';
+import { ToolCapableLlmProvider } from './llm-provider.js';
+import { sanitizeError, serializeToolResult, parseNamespacedId, tryParseJson, validateSchema, rejectAfter, buildSystemPrompt, } from './agent-utils.js';
+/**
+ * Anthropic LLM provider for realm agent.
+ * Uses the Messages API and extracts JSON from the first text content block.
+ * Retries once if the model returns non-JSON content.
+ */
+export class AnthropicProvider extends ToolCapableLlmProvider {
+    model;
+    constructor(model) {
+        super();
+        this.model = model;
+    }
+    async callStep(prompt, inputSchema) {
+        // Dynamically import @anthropic-ai/sdk to keep it an optional peer dependency.
+        // See openai-provider.ts for an explanation of the 'string' cast technique.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            const moduleId = '@anthropic-ai/sdk';
+            mod = await import(moduleId);
+        }
+        catch {
+            console.error('realm agent requires the @anthropic-ai/sdk package. Run: npm install @anthropic-ai/sdk');
+            process.exit(1);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const client = new mod.default({
+            apiKey: process.env['ANTHROPIC_API_KEY'],
+        });
+        const systemPrompt = buildSystemPrompt(inputSchema);
+        const makeRequest = async (userContent) => {
+            const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.messages.create({
+                model: this.model,
+                max_tokens: 4096,
+                system: systemPrompt,
+                messages: [{ role: 'user', content: userContent }],
+            });
+            const block = response.content.find(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (b) => b.type === 'text');
+            return block?.text ?? '';
+        };
+        const content = await makeRequest(prompt);
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            // Retry once with an explicit reminder to return JSON.
+            const retryPrompt = `${prompt}\n\nYour previous response was not valid JSON. Respond with a JSON object only.`;
+            const retry = await makeRequest(retryPrompt);
+            try {
+                return JSON.parse(retry);
+            }
+            catch {
+                throw new Error(`Anthropic returned non-JSON content after retry: ${retry.slice(0, 200)}`);
+            }
+        }
+    }
+    /**
+     * Agentic loop for tool-capable steps. Executes tool calls serially (V1 constraint).
+     * All tool results for one turn are accumulated into a single user message with an array
+     * of tool_result blocks — the Anthropic API rejects interleaved assistant/user turns.
+     */
+    async callStepWithTools(prompt, tools, executor, options) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            const moduleId = '@anthropic-ai/sdk';
+            mod = await import(moduleId);
+        }
+        catch {
+            console.error('realm agent requires the @anthropic-ai/sdk package. Run: npm install @anthropic-ai/sdk');
+            process.exit(1);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const client = new mod.default({
+            apiKey: process.env['ANTHROPIC_API_KEY'],
+        });
+        // toolIdMap: bareName → namespaced id, used to recover routing key from LLM responses.
+        // Collision guard: two MCP servers may not expose the same bare tool name in the same step.
+        const toolIdMap = new Map();
+        const anthropicTools = [];
+        for (const tool of tools) {
+            if (toolIdMap.has(tool.name)) {
+                throw new Error(`invariant: duplicate bare tool name '${tool.name}' in toolIdMap — this should have been caught at toolDefs assembly in run-agent.ts`);
+            }
+            toolIdMap.set(tool.name, tool.id);
+            anthropicTools.push({
+                name: tool.name,
+                description: tool.description,
+                input_schema: tool.inputSchema, // note: input_schema, not parameters
+            });
+        }
+        const maxCalls = options.maxToolCalls ?? 20;
+        let tool_call_count = 0;
+        const tool_call_records = [];
+        const system = buildSystemPrompt(options.inputSchema);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const history = [{ role: 'user', content: prompt }];
+        const buildMainCallOpts = () => {
+            const opts = {
+                model: this.model,
+                max_tokens: 4096,
+                system,
+                messages: history,
+            };
+            if (anthropicTools.length > 0)
+                opts['tools'] = anthropicTools;
+            return opts;
+        };
+        // Calls the API with tool_choice: none and no tools array to force a plain text answer.
+        // Does NOT push to history — callers must ensure history ends with a valid user turn.
+        const performFinalExtraction = async () => {
+            const final = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.messages.create({
+                model: this.model,
+                max_tokens: 4096,
+                system,
+                messages: history,
+                tool_choice: { type: 'none' },
+                // NO tools array — enforces text-only response
+                // NO response_format — not a valid Anthropic parameter
+            });
+            const textBlock = final.content.find((b) => b.type === 'text');
+            const text = textBlock?.text ?? '';
+            const parsed = tryParseJson(text);
+            if (parsed && validateSchema(parsed, options.inputSchema)) {
+                return { output: parsed, toolCalls: tool_call_records };
+            }
+            throw new WorkflowError('max_tool_calls reached; final extraction failed', {
+                code: 'ENGINE_STEP_FAILED',
+                category: 'ENGINE',
+                agentAction: 'stop',
+                retryable: false,
+            });
+        };
+        while (true) {
+            const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.messages.create(buildMainCallOpts());
+            const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+            if (toolUseBlocks.length > 0) {
+                history.push({ role: 'assistant', content: response.content });
+                const anthropic_result_blocks = [];
+                let budget_exhausted_mid_batch = false;
+                for (const block of toolUseBlocks) {
+                    const llmToolCallId = block.id; // captured verbatim — "toolu_01abc..."
+                    if (tool_call_count >= maxCalls) {
+                        // Budget exhausted — must still answer every id in the assistant message.
+                        anthropic_result_blocks.push({
+                            type: 'tool_result',
+                            tool_use_id: llmToolCallId,
+                            content: 'Error: tool call budget exhausted',
+                        });
+                        budget_exhausted_mid_batch = true;
+                        continue;
+                    }
+                    const originalId = toolIdMap.get(block.name);
+                    const { serverId, toolName } = parseNamespacedId(originalId);
+                    const args = (block.input ?? {});
+                    const start = Date.now();
+                    let resultContent;
+                    let record;
+                    try {
+                        const rawResult = await Promise.race([
+                            executor(originalId, args),
+                            rejectAfter(options.toolTimeoutMs ?? 30000),
+                        ]);
+                        const serialized = serializeToolResult(rawResult);
+                        record = {
+                            server_id: serverId,
+                            tool: toolName,
+                            args,
+                            result: serialized,
+                            duration_ms: Date.now() - start,
+                        };
+                        resultContent = serialized;
+                    }
+                    catch (err) {
+                        const sanitized = sanitizeError(err);
+                        const content = sanitized.length > 0 ? `Error: ${sanitized}` : 'Error: (redacted)';
+                        record = {
+                            server_id: serverId,
+                            tool: toolName,
+                            args,
+                            result: null,
+                            duration_ms: Date.now() - start,
+                            error: sanitized,
+                        };
+                        resultContent = content;
+                    }
+                    tool_call_records.push(record);
+                    tool_call_count++;
+                    anthropic_result_blocks.push({
+                        type: 'tool_result',
+                        tool_use_id: llmToolCallId,
+                        content: resultContent,
+                    });
+                }
+                const exhausted = budget_exhausted_mid_batch || tool_call_count >= maxCalls;
+                if (exhausted) {
+                    // Merge tool results and extraction prompt into a single user message to avoid
+                    // consecutive user messages, which the Anthropic API rejects with 400.
+                    history.push({
+                        role: 'user',
+                        content: [
+                            ...anthropic_result_blocks,
+                            {
+                                type: 'text',
+                                text: 'You have reached the maximum number of tool calls. Produce your final JSON answer now using only what you have already gathered. No further tool calls will be executed.',
+                            },
+                        ],
+                    });
+                    return performFinalExtraction();
+                }
+                // Normal continuation — single user message with all tool_result blocks.
+                history.push({ role: 'user', content: anthropic_result_blocks });
+            }
+            else {
+                // No tool calls — attempt to parse the final answer.
+                const textBlock = response.content.find((b) => b.type === 'text');
+                const text = textBlock?.text ?? '';
+                const parsed = tryParseJson(text);
+                if (parsed && validateSchema(parsed, options.inputSchema)) {
+                    return { output: parsed, toolCalls: tool_call_records };
+                }
+                // Schema mismatch — append correction and keep looping.
+                history.push({ role: 'assistant', content: response.content });
+                history.push({
+                    role: 'user',
+                    content: 'Your response did not match the required JSON schema. Try again.',
+                });
+                tool_call_count++; // schema correction consumes a slot
+                if (tool_call_count >= maxCalls) {
+                    return performFinalExtraction();
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/agent/anthropic-provider.js.map

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

package/dist/agent/gate/slack-gate-notifier.d.ts

@@ -0,0 +1,80 @@
+import { type RunStore, type WorkflowDefinition, type PendingGate } from '@sensigo/realm';
+import type { LlmProvider } from '../providers/llm-provider.js';
+/**
+ * Formats a gate preview object as human-readable Slack mrkdwn text.
+ * Uses `headline` and `message` fields when present; falls back to indented JSON.
+ * Exported for testing.
+ */
+export declare function formatGatePreviewForSlack(preview: Record<string, unknown>): string;
+/**
+ * POSTs a gate-waiting notification to a Slack Incoming Webhook.
+ * Failure is warned but does not abort the workflow run.
+ * Exported for testing.
+ */
+export declare function postGateNotificationToSlack(webhookUrl: string, gate: PendingGate, runId: string): Promise<void>;
+/**
+ * Posts a gate notification to Slack via chat.postMessage (bot token path).
+ * Returns the message ts for use as a thread anchor, or undefined on failure.
+ * Exported for testing.
+ */
+export declare function postGateViaApi(botToken: string, channelId: string, gate: PendingGate, runId: string): Promise<string | undefined>;
+/**
+ * Posts a reply to an existing Slack thread via chat.postMessage.
+ * Failures are warned but not thrown — best-effort.
+ * Exported for testing.
+ */
+export declare function postSlackReply(botToken: string, channelId: string, threadTs: string, text: string): Promise<void>;
+/**
+ * Starts reminder and escalation timers for an open gate.
+ * Returns a cleanup function that clears both timers — must be called when the gate resolves.
+ * Exported for testing.
+ */
+export declare function startGateReminderTimers(botToken: string, channelId: string, threadTs: string, gate: PendingGate, reminderIntervalMs: number, escalationThresholdMs: number): () => void;
+/** Parameters for the bidirectional gate handler. Exported for testing. */
+export interface BidirectionalGateParams {
+    gate: PendingGate;
+    runId: string;
+    definition: WorkflowDefinition;
+    store: RunStore;
+    provider: LlmProvider;
+    slackBotToken: string;
+    slackChannelId: string;
+    gateThreadTs: string | undefined;
+    slackSigningSecret?: string;
+    slackEventsPort: number;
+    /** SLACK_APP_TOKEN — enables Socket Mode when set. */
+    slackAppToken?: string;
+    gateReminderIntervalMs: number;
+    gateEscalationThresholdMs: number;
+    pollIntervalMs: number;
+}
+/**
+ * Handles a gate using Slack bidirectional resolution:
+ * - Events API (when signing secret is present) or Socket Mode (when app token is present)
+ * - LLM intent interpretation of Slack replies
+ * - Reminder and escalation timers
+ * - Falls back to store polling for terminal-command gate resolution
+ * Exported for testing.
+ */
+export declare function handleBidirectionalGate(params: BidirectionalGateParams): Promise<void>;
+export interface SlackGateHandlerConfig {
+    store: RunStore;
+    definition: WorkflowDefinition;
+    /** Required by handleBidirectionalGate for LLM intent parsing. */
+    provider: LlmProvider;
+    webhookUrl?: string;
+    botToken?: string;
+    channelId?: string;
+    signingSecret?: string;
+    eventsPort?: number;
+    appToken?: string;
+    reminderIntervalMs?: number;
+    escalationThresholdMs?: number;
+    pollIntervalMs?: number;
+}
+/**
+ * Creates a gate handler that notifies via Slack and waits for resolution.
+ * Returns a function typed (runId, gate) => Promise<void>.
+ */
+export declare function createSlackGateHandler(config: SlackGateHandlerConfig): (runId: string, gate: PendingGate) => Promise<void>;
+//# sourceMappingURL=slack-gate-notifier.d.ts.map

package/dist/agent/gate/slack-gate-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-gate-notifier.d.ts","sourceRoot":"","sources":["../../../src/agent/gate/slack-gate-notifier.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAgBlF;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC7B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,kBAAkB,EAAE,MAAM,EAC1B,qBAAqB,EAAE,MAAM,GAC5B,MAAM,IAAI,CAyBZ;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoI5F;AAiCD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAkCrD"}