@sensigo/realm-cli 0.1.0

package/dist/agent/openai-provider.js

@@ -0,0 +1,253 @@
+// openai-provider.ts — OpenAI LLM provider implementation for realm agent.
+// Requires openai >= 4.0.0 as an optional peer dependency (npm install openai).
+import { WorkflowError } from '@sensigo/realm';
+import { ToolCapableLlmProvider } from './llm-provider.js';
+import { sanitizeError, serializeToolResult, parseNamespacedId, tryParseJson, validateSchema, rejectAfter, buildSystemPrompt, } from './agent-utils.js';
+/**
+ * OpenAI LLM provider for realm agent.
+ * Uses the Chat Completions API. Sends `response_format: json_object` on native
+ * OpenAI endpoints; falls back to prompt-only JSON enforcement on compat endpoints
+ * behind `--base-url`. Retries once if the model returns non-JSON content.
+ */
+export class OpenAIProvider extends ToolCapableLlmProvider {
+    model;
+    baseUrl;
+    constructor(model, baseUrl) {
+        super();
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Native OpenAI endpoints have a well-defined, tested capability surface that includes
+     * json_object mode. Custom compat endpoints behind --base-url do not guarantee this feature.
+     * Default to prompt-only enforcement for any unknown endpoint.
+     */
+    capabilities() {
+        return { jsonMode: this.baseUrl === undefined };
+    }
+    async callStep(prompt, inputSchema) {
+        // Dynamically import openai to keep it an optional peer dependency.
+        // Assigning the module specifier to a typed variable via 'string' makes TS
+        // treat it as Promise<any>, bypassing static module resolution at build time.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            const moduleId = 'openai';
+            mod = await import(moduleId);
+        }
+        catch {
+            console.error('realm agent requires the openai package. Run: npm install openai');
+            process.exit(1);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const client = new mod.default({
+            apiKey: process.env['OPENAI_API_KEY'],
+            ...(this.baseUrl !== undefined ? { baseURL: this.baseUrl } : {}),
+        });
+        const systemPrompt = buildSystemPrompt(inputSchema);
+        const messages = [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: prompt },
+        ];
+        const makeRequest = async (msgs) => {
+            const opts = {
+                model: this.model,
+                messages: msgs,
+            };
+            if (this.capabilities().jsonMode) {
+                opts['response_format'] = { type: 'json_object' };
+            }
+            const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.chat.completions.create(opts);
+            return response.choices[0]?.message?.content ?? '';
+        };
+        const content = await makeRequest(messages);
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            // Retry once with an explicit reminder to return JSON.
+            const retryMessages = [
+                ...messages,
+                { role: 'assistant', content },
+                {
+                    role: 'user',
+                    content: 'Your previous response was not valid JSON. Respond with a JSON object only.',
+                },
+            ];
+            const retry = await makeRequest(retryMessages);
+            try {
+                return JSON.parse(retry);
+            }
+            catch {
+                throw new Error(`OpenAI returned non-JSON content after retry: ${retry.slice(0, 200)}`);
+            }
+        }
+    }
+    /**
+     * Agentic loop for tool-capable steps. Executes tool calls serially (V1 constraint)
+     * until the model returns a final JSON answer or the tool call budget is exhausted.
+     */
+    async callStepWithTools(prompt, tools, executor, options) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            const moduleId = 'openai';
+            mod = await import(moduleId);
+        }
+        catch {
+            console.error('realm agent requires the openai package. Run: npm install openai');
+            process.exit(1);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const client = new mod.default({
+            apiKey: process.env['OPENAI_API_KEY'],
+            ...(this.baseUrl !== undefined ? { baseURL: this.baseUrl } : {}),
+        });
+        const responseFormat = this.capabilities().jsonMode && options.inputSchema !== undefined
+            ? { type: 'json_object' }
+            : undefined;
+        // 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 openaiTools = [];
+        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);
+            openaiTools.push({
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.inputSchema,
+                },
+            });
+        }
+        const maxCalls = options.maxToolCalls ?? 20;
+        let tool_call_count = 0;
+        const tool_call_records = [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const history = [
+            { role: 'system', content: buildSystemPrompt(options.inputSchema) },
+            { role: 'user', content: prompt },
+        ];
+        const buildMainCallOpts = () => {
+            const opts = { model: this.model, messages: history };
+            if (openaiTools.length > 0)
+                opts['tools'] = openaiTools;
+            if (responseFormat !== undefined)
+                opts['response_format'] = responseFormat;
+            return opts;
+        };
+        const buildFinalCallOpts = () => {
+            const opts = { model: this.model, messages: history };
+            if (responseFormat !== undefined)
+                opts['response_format'] = responseFormat;
+            return opts;
+        };
+        // Injects the over-budget message and calls the API without tools to produce a final answer.
+        const performFinalExtraction = async () => {
+            history.push({
+                role: 'user',
+                content: '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.',
+            });
+            const final = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.chat.completions.create(buildFinalCallOpts());
+            const text = final.choices[0].message.content ?? '';
+            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.chat.completions.create(buildMainCallOpts());
+            const message = response.choices[0].message;
+            if (message.tool_calls?.length) {
+                const batch = message.tool_calls;
+                history.push(message);
+                let budget_exhausted_mid_batch = false;
+                for (const tool of batch) {
+                    const llmToolCallId = tool.id; // captured verbatim — API returns 400 if echoed incorrectly
+                    if (tool_call_count >= maxCalls) {
+                        // Budget exhausted — must still answer every id in the assistant message.
+                        history.push({
+                            role: 'tool',
+                            tool_call_id: llmToolCallId,
+                            content: 'Error: tool call budget exhausted',
+                        });
+                        budget_exhausted_mid_batch = true;
+                        continue;
+                    }
+                    const originalId = toolIdMap.get(tool.function.name);
+                    const { serverId, toolName } = parseNamespacedId(originalId);
+                    const args = JSON.parse(tool.function.arguments || '{}');
+                    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++;
+                    history.push({ role: 'tool', tool_call_id: llmToolCallId, content: resultContent });
+                }
+                if (budget_exhausted_mid_batch || tool_call_count >= maxCalls) {
+                    return performFinalExtraction();
+                }
+            }
+            else {
+                // No tool calls — attempt to parse the final answer.
+                const text = message.content ?? '';
+                const parsed = tryParseJson(text);
+                if (parsed && validateSchema(parsed, options.inputSchema)) {
+                    return { output: parsed, toolCalls: tool_call_records };
+                }
+                // Schema mismatch — append correction message and continue the loop.
+                history.push({ role: 'assistant', content: text });
+                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=openai-provider.js.map

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

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

package/dist/agent/openai-reasoning-provider.d.ts

@@ -0,0 +1,18 @@
+import { LlmProvider } from './llm-provider.js';
+/**
+ * OpenAI reasoning model provider for realm agent.
+ * Handles the o1/o3 model families, which differ from standard chat completions:
+ * - No `response_format` parameter (JSON enforced via system prompt + retry).
+ * - System prompt content is folded into the first user message — the safe
+ *   universal approach for the full o1/o3 lineage. (o1 originally rejected the
+ *   system role; later versions accept it as a developer role, but prepending
+ *   to the user message works uniformly across all revisions.)
+ * - Tool calling is not supported — this class extends LlmProvider, not
+ *   ToolCapableLlmProvider, so `isToolCapable` returns false for these instances.
+ */
+export declare class OpenAIReasoningProvider extends LlmProvider {
+    private readonly model;
+    constructor(model: string);
+    callStep(prompt: string, inputSchema?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=openai-reasoning-provider.d.ts.map

package/dist/agent/openai-reasoning-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-reasoning-provider.d.ts","sourceRoot":"","sources":["../../src/agent/openai-reasoning-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM;IAKnB,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;CAwDpC"}

package/dist/agent/openai-reasoning-provider.js

@@ -0,0 +1,76 @@
+// openai-reasoning-provider.ts — OpenAI reasoning model provider (o1/o3) for realm agent.
+// Extends LlmProvider (not ToolCapableLlmProvider) — reasoning models do not support the tools parameter.
+import { LlmProvider } from './llm-provider.js';
+import { buildSystemPrompt } from './agent-utils.js';
+/**
+ * OpenAI reasoning model provider for realm agent.
+ * Handles the o1/o3 model families, which differ from standard chat completions:
+ * - No `response_format` parameter (JSON enforced via system prompt + retry).
+ * - System prompt content is folded into the first user message — the safe
+ *   universal approach for the full o1/o3 lineage. (o1 originally rejected the
+ *   system role; later versions accept it as a developer role, but prepending
+ *   to the user message works uniformly across all revisions.)
+ * - Tool calling is not supported — this class extends LlmProvider, not
+ *   ToolCapableLlmProvider, so `isToolCapable` returns false for these instances.
+ */
+export class OpenAIReasoningProvider extends LlmProvider {
+    model;
+    constructor(model) {
+        super();
+        this.model = model;
+    }
+    async callStep(prompt, inputSchema) {
+        // Dynamically import openai to keep it an optional peer dependency.
+        // Assigning the module specifier to a typed variable via 'string' makes TS
+        // treat it as Promise<any>, bypassing static module resolution at build time.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            const moduleId = 'openai';
+            mod = await import(moduleId);
+        }
+        catch {
+            console.error('realm agent requires the openai package. Run: npm install openai');
+            process.exit(1);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const client = new mod.default({
+            apiKey: process.env['OPENAI_API_KEY'],
+        });
+        // Fold system prompt into the user message — safe for all o1/o3 API revisions.
+        const systemPrompt = buildSystemPrompt(inputSchema);
+        const userContent = `${systemPrompt}\n\n${prompt}`;
+        const messages = [{ role: 'user', content: userContent }];
+        const makeRequest = async (msgs) => {
+            const response = await // eslint-disable-next-line @typescript-eslint/no-explicit-any
+             client.chat.completions.create({
+                model: this.model,
+                messages: msgs,
+            });
+            return response.choices[0]?.message?.content ?? '';
+        };
+        const content = await makeRequest(messages);
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            // Retry once with an explicit reminder to return JSON.
+            const retryMessages = [
+                ...messages,
+                { role: 'assistant', content },
+                {
+                    role: 'user',
+                    content: 'Your previous response was not valid JSON. Respond with a JSON object only.',
+                },
+            ];
+            const retry = await makeRequest(retryMessages);
+            try {
+                return JSON.parse(retry);
+            }
+            catch {
+                throw new Error(`OpenAI returned non-JSON content after retry: ${retry.slice(0, 200)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=openai-reasoning-provider.js.map

package/dist/agent/openai-reasoning-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-reasoning-provider.js","sourceRoot":"","sources":["../../src/agent/openai-reasoning-provider.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,0GAA0G;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACrC,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,WAAqC;QAErC,oEAAoE;QACpE,2EAA2E;QAC3E,8EAA8E;QAC9E,8DAA8D;QAC9D,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAW,QAAQ,CAAC;YAClC,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAK,GAAG,CAAC,OAAsD,CAAC;YAC7E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;SACtC,CAAC,CAAC;QAEH,+EAA+E;QAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,GAAG,YAAY,OAAO,MAAM,EAAE,CAAC;QAGnD,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAErE,MAAM,WAAW,GAAG,KAAK,EAAE,IAAe,EAAmB,EAAE;YAC7D,MAAM,QAAQ,GAAG,MAAM,8DAA8D;aACpF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAA0D,CAAC;gBAClF,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YACH,OAAQ,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAA8B,IAAI,EAAE,CAAC;QAC7E,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,MAAM,aAAa,GAAc;gBAC/B,GAAG,QAAQ;gBACX,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE;gBAC9B;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,6EAA6E;iBACvF;aACF,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;YAC/C,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,iDAAiD,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/agent/preflight.d.ts

@@ -0,0 +1,36 @@
+import type { WorkflowDefinition } from '@sensigo/realm';
+export interface PreflightFinding {
+    /** Service name from the workflow definition. */
+    serviceName: string;
+    /** Adapter name (e.g. 'github', 'slack'). */
+    adapter: string;
+    /** Name of the missing environment variable. */
+    missingVar: string;
+    /** Ready-to-paste export command for the missing variable. */
+    exportExample: string;
+}
+/**
+ * Inspects the workflow's `services` block and returns a finding for each
+ * built-in adapter whose required environment variable is absent from env.
+ * Returns an empty array when all prerequisites are satisfied.
+ */
+export declare function checkAdapterPrerequisites(definition: WorkflowDefinition, env?: NodeJS.ProcessEnv): PreflightFinding[];
+/**
+ * Formats preflight findings into a multi-line actionable error message.
+ * Does not include secrets or values — only variable names and export examples.
+ */
+export declare function formatPreflightError(findings: PreflightFinding[]): string;
+/** An advisory (non-blocking) Slack configuration warning. */
+export interface PreflightWarning {
+    message: string;
+}
+/**
+ * Checks for incomplete Slack bidirectional configuration and returns advisory warnings.
+ * These are non-blocking — the run proceeds but with degraded Slack functionality.
+ *
+ * Bidirectional resolution requires SLACK_BOT_TOKEN + SLACK_CHANNEL_ID and at least one of:
+ * - SLACK_APP_TOKEN (Socket Mode — WebSocket push, no public URL required)
+ * - SLACK_SIGNING_SECRET (Events API — HTTP push, requires public URL)
+ */
+export declare function checkSlackBidirectionalConfig(env?: NodeJS.ProcessEnv): PreflightWarning[];
+//# sourceMappingURL=preflight.d.ts.map

package/dist/agent/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/agent/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAczD,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,kBAAkB,EAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,gBAAgB,EAAE,CAepB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAUzE;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,gBAAgB,EAAE,CAgCpB"}

package/dist/agent/preflight.js

@@ -0,0 +1,81 @@
+/** Maps adapter name to the env var it requires. */
+const ADAPTER_ENV_REQS = {
+    github: {
+        envVar: 'GITHUB_TOKEN',
+        exportExample: 'export GITHUB_TOKEN=ghp_...',
+    },
+    slack: {
+        envVar: 'SLACK_WEBHOOK_URL',
+        exportExample: 'export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...',
+    },
+};
+/**
+ * Inspects the workflow's `services` block and returns a finding for each
+ * built-in adapter whose required environment variable is absent from env.
+ * Returns an empty array when all prerequisites are satisfied.
+ */
+export function checkAdapterPrerequisites(definition, env = process.env) {
+    const findings = [];
+    for (const [serviceName, serviceDef] of Object.entries(definition.services ?? {})) {
+        const req = ADAPTER_ENV_REQS[serviceDef.adapter];
+        if (req === undefined)
+            continue;
+        if (env[req.envVar] === undefined) {
+            findings.push({
+                serviceName,
+                adapter: serviceDef.adapter,
+                missingVar: req.envVar,
+                exportExample: req.exportExample,
+            });
+        }
+    }
+    return findings;
+}
+/**
+ * Formats preflight findings into a multi-line actionable error message.
+ * Does not include secrets or values — only variable names and export examples.
+ */
+export function formatPreflightError(findings) {
+    const lines = ['Error: Missing required environment variables for workflow services:'];
+    for (const f of findings) {
+        lines.push(`  - service '${f.serviceName}' (adapter '${f.adapter}'): ${f.missingVar}`);
+    }
+    lines.push('', 'Set and retry:');
+    for (const f of findings) {
+        lines.push(`  ${f.exportExample}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Checks for incomplete Slack bidirectional configuration and returns advisory warnings.
+ * These are non-blocking — the run proceeds but with degraded Slack functionality.
+ *
+ * Bidirectional resolution requires SLACK_BOT_TOKEN + SLACK_CHANNEL_ID and at least one of:
+ * - SLACK_APP_TOKEN (Socket Mode — WebSocket push, no public URL required)
+ * - SLACK_SIGNING_SECRET (Events API — HTTP push, requires public URL)
+ */
+export function checkSlackBidirectionalConfig(env = process.env) {
+    const warnings = [];
+    if (env['SLACK_WEBHOOK_URL'] !== undefined && env['SLACK_BOT_TOKEN'] === undefined) {
+        warnings.push({
+            message: 'SLACK_WEBHOOK_URL is set but SLACK_BOT_TOKEN is not. Gate replies cannot be received from Slack — approval requires the terminal command.',
+        });
+    }
+    if (env['SLACK_BOT_TOKEN'] !== undefined &&
+        env['SLACK_APP_TOKEN'] === undefined &&
+        env['SLACK_SIGNING_SECRET'] === undefined) {
+        warnings.push({
+            message: 'SLACK_BOT_TOKEN is set but neither SLACK_APP_TOKEN nor SLACK_SIGNING_SECRET is set. ' +
+                'Gate replies cannot be resolved automatically from Slack — set SLACK_APP_TOKEN (Socket Mode, recommended) ' +
+                'or SLACK_SIGNING_SECRET (Events API) to enable automatic resolution.',
+        });
+    }
+    if (env['SLACK_APP_TOKEN'] !== undefined && env['SLACK_SIGNING_SECRET'] !== undefined) {
+        warnings.push({
+            message: 'Both SLACK_APP_TOKEN and SLACK_SIGNING_SECRET are set — Socket Mode (Mode 2) takes precedence. ' +
+                'Remove SLACK_APP_TOKEN to use Events API (Mode 3).',
+        });
+    }
+    return warnings;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/agent/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/agent/preflight.ts"],"names":[],"mappings":"AAIA,oDAAoD;AACpD,MAAM,gBAAgB,GAA8D;IAClF,MAAM,EAAE;QACN,MAAM,EAAE,cAAc;QACtB,aAAa,EAAE,6BAA6B;KAC7C;IACD,KAAK,EAAE;QACL,MAAM,EAAE,mBAAmB;QAC3B,aAAa,EAAE,+DAA+D;KAC/E;CACF,CAAC;AAaF;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAA8B,EAC9B,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QAClF,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,WAAW;gBACX,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,UAAU,EAAE,GAAG,CAAC,MAAM;gBACtB,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAA4B;IAC/D,MAAM,KAAK,GAAG,CAAC,sEAAsE,CAAC,CAAC;IACvF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,WAAW,eAAe,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,GAAG,CAAC,mBAAmB,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,iBAAiB,CAAC,KAAK,SAAS,EAAE,CAAC;QACnF,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EACL,2IAA2I;SAC9I,CAAC,CAAC;IACL,CAAC;IAED,IACE,GAAG,CAAC,iBAAiB,CAAC,KAAK,SAAS;QACpC,GAAG,CAAC,iBAAiB,CAAC,KAAK,SAAS;QACpC,GAAG,CAAC,sBAAsB,CAAC,KAAK,SAAS,EACzC,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EACL,sFAAsF;gBACtF,4GAA4G;gBAC5G,sEAAsE;SACzE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,iBAAiB,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,sBAAsB,CAAC,KAAK,SAAS,EAAE,CAAC;QACtF,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EACL,iGAAiG;gBACjG,oDAAoD;SACvD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/agent/providers/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/providers/agent-utils.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+import { ToolCapableLlmProvider } from './llm-provider.js';
+import type { ToolDefinition, ToolExecutor, StepWithToolsResult } from '../mcp/mcp-extensions.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/providers/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/anthropic-provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAuBlC;;;;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"}