@jstn-sdk/rcs 0.1.0

package/dist/openclaw/dispatcher.js

@@ -0,0 +1,259 @@
+/**
+ * OpenClaw Gateway Dispatcher
+ *
+ * Sends instruction payloads to OpenClaw gateways via HTTP or CLI command.
+ * All calls are non-blocking with timeouts. Failures are swallowed
+ * to avoid blocking hooks.
+ *
+ * SECURITY: Command gateway requires RCS_OPENCLAW_COMMAND=1 opt-in.
+ * Command timeout is configurable with safe bounds.
+ * Prefers execFile for simple commands; falls back to sh -c only for shell metacharacters.
+ */
+/** Default per-request timeout for HTTP gateways */
+const DEFAULT_HTTP_TIMEOUT_MS = 10_000;
+/** Default command gateway timeout (backward-compatible default) */
+const DEFAULT_COMMAND_TIMEOUT_MS = 5_000;
+/**
+ * Command timeout safety bounds.
+ * - Minimum 100ms: avoids immediate/near-zero timeout misconfiguration.
+ * - Maximum 300000ms (5 minutes): prevents runaway long-lived command processes.
+ */
+const MIN_COMMAND_TIMEOUT_MS = 100;
+const MAX_COMMAND_TIMEOUT_MS = 300_000;
+/** Shell metacharacters that require sh -c instead of execFile */
+const SHELL_METACHAR_RE = /[|&;><`$()]/;
+/**
+ * Validate gateway URL. Must be HTTPS, except localhost/127.0.0.1/::1
+ * which allows HTTP for local development.
+ */
+export function validateGatewayUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol === "https:")
+            return true;
+        if (parsed.protocol === "http:" &&
+            (parsed.hostname === "localhost" ||
+                parsed.hostname === "127.0.0.1" ||
+                parsed.hostname === "::1" ||
+                parsed.hostname === "[::1]")) {
+            return true;
+        }
+        return false;
+    }
+    catch (err) {
+        process.stderr.write(`[openclaw-dispatcher] operation failed: ${err}\n`);
+        return false;
+    }
+}
+/**
+ * Interpolate template variables in an instruction string.
+ *
+ * Supported variables (from hook context):
+ * - {{projectName}} - basename of project directory
+ * - {{projectPath}} - full project directory path
+ * - {{sessionId}} - session identifier
+ * - {{prompt}} - prompt text
+ * - {{contextSummary}} - context summary (session-end event)
+ * - {{question}} - question text (ask-user-question event)
+ * - {{timestamp}} - ISO timestamp
+ * - {{event}} - hook event name
+ * - {{instruction}} - interpolated instruction (for command gateway)
+ * - {{replyChannel}} - originating channel (from OPENCLAW_REPLY_CHANNEL env var)
+ * - {{replyTarget}} - reply target user/bot (from OPENCLAW_REPLY_TARGET env var)
+ * - {{replyThread}} - reply thread ID (from OPENCLAW_REPLY_THREAD env var)
+ *
+ * Unresolved variables are replaced with empty string.
+ */
+export function interpolateInstruction(template, variables) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        return variables[key] ?? "";
+    });
+}
+/**
+ * Type guard: is this gateway config a command gateway?
+ */
+export function isCommandGateway(config) {
+    return config.type === "command";
+}
+/**
+ * Shell-escape a string for safe embedding in a shell command.
+ * Uses single-quote wrapping with internal quote escaping.
+ */
+export function shellEscapeArg(value) {
+    return "'" + value.replace(/'/g, "'\\''") + "'";
+}
+/**
+ * Resolve command gateway timeout with precedence:
+ * gateway timeout > RCS_OPENCLAW_COMMAND_TIMEOUT_MS > default.
+ */
+export function resolveCommandTimeoutMs(gatewayTimeout, envTimeoutRaw = process.env.RCS_OPENCLAW_COMMAND_TIMEOUT_MS) {
+    const parseFinite = (value) => {
+        if (typeof value !== "number" || !Number.isFinite(value))
+            return undefined;
+        return value;
+    };
+    const parseEnv = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    };
+    const rawTimeout = parseFinite(gatewayTimeout) ??
+        parseEnv(envTimeoutRaw) ??
+        DEFAULT_COMMAND_TIMEOUT_MS;
+    return Math.min(MAX_COMMAND_TIMEOUT_MS, Math.max(MIN_COMMAND_TIMEOUT_MS, Math.trunc(rawTimeout)));
+}
+/**
+ * Wake an HTTP-type OpenClaw gateway with the given payload.
+ */
+export async function wakeGateway(gatewayName, gatewayConfig, payload) {
+    if (!validateGatewayUrl(gatewayConfig.url)) {
+        return {
+            gateway: gatewayName,
+            success: false,
+            error: "Invalid URL (HTTPS required)",
+        };
+    }
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+            ...gatewayConfig.headers,
+        };
+        const timeout = gatewayConfig.timeout ?? DEFAULT_HTTP_TIMEOUT_MS;
+        const response = await fetch(gatewayConfig.url, {
+            method: gatewayConfig.method || "POST",
+            headers,
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (!response.ok) {
+            return {
+                gateway: gatewayName,
+                success: false,
+                error: `HTTP ${response.status}`,
+                statusCode: response.status,
+            };
+        }
+        return { gateway: gatewayName, success: true, statusCode: response.status };
+    }
+    catch (error) {
+        return {
+            gateway: gatewayName,
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+/**
+ * Wake a command-type OpenClaw gateway by executing a shell command.
+ *
+ * SECURITY REQUIREMENTS:
+ * - Requires RCS_OPENCLAW_COMMAND=1 opt-in (separate gate from RCS_OPENCLAW)
+ * - Timeout is configurable via gateway.timeout or RCS_OPENCLAW_COMMAND_TIMEOUT_MS
+ *   with safe clamping bounds and backward-compatible default 5000ms
+ * - Prefers execFile for simple commands (no metacharacters)
+ * - Falls back to sh -c only when metacharacters detected
+ * - detached: false to prevent orphan processes
+ * - SIGTERM cleanup handler kills child on parent SIGTERM, 1s grace then SIGKILL
+ *
+ * The command template supports {{variable}} placeholders. All variable
+ * values are shell-escaped before interpolation to prevent injection.
+ */
+export async function wakeCommandGateway(gatewayName, gatewayConfig, variables) {
+    // Separate command gateway opt-in gate
+    if (process.env.RCS_OPENCLAW_COMMAND !== "1") {
+        return {
+            gateway: gatewayName,
+            success: false,
+            error: "Command gateway disabled (set RCS_OPENCLAW_COMMAND=1 to enable)",
+        };
+    }
+    let child = null;
+    let sigtermHandler = null;
+    try {
+        const { execFile, exec } = await import("child_process");
+        const timeout = resolveCommandTimeoutMs(gatewayConfig.timeout);
+        // Interpolate variables with shell escaping
+        const interpolated = gatewayConfig.command.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+            const value = variables[key];
+            if (value === undefined)
+                return match;
+            return shellEscapeArg(value);
+        });
+        // Detect whether the interpolated command contains shell metacharacters
+        const hasMetachars = SHELL_METACHAR_RE.test(interpolated);
+        await new Promise((resolve, reject) => {
+            const cleanup = (signal) => {
+                if (child) {
+                    child.kill(signal);
+                    // 1s grace period then SIGKILL
+                    setTimeout(() => {
+                        try {
+                            child?.kill("SIGKILL");
+                        }
+                        catch (err) {
+                            process.stderr.write(`[openclaw-dispatcher] operation failed: ${err}\n`);
+                        }
+                    }, 1000);
+                }
+            };
+            sigtermHandler = () => cleanup("SIGTERM");
+            process.once("SIGTERM", sigtermHandler);
+            const onExit = (code, signal) => {
+                if (sigtermHandler) {
+                    process.removeListener("SIGTERM", sigtermHandler);
+                    sigtermHandler = null;
+                }
+                if (signal) {
+                    reject(new Error(`Command killed by signal ${signal}`));
+                }
+                else if (code !== 0) {
+                    reject(new Error(`Command exited with code ${code}`));
+                }
+                else {
+                    resolve();
+                }
+            };
+            const onError = (err) => {
+                if (sigtermHandler) {
+                    process.removeListener("SIGTERM", sigtermHandler);
+                    sigtermHandler = null;
+                }
+                reject(err);
+            };
+            if (hasMetachars) {
+                // Fall back to sh -c for complex commands with metacharacters
+                child = exec(interpolated, {
+                    timeout,
+                    env: { ...process.env },
+                });
+            }
+            else {
+                // Parse simple command: split on whitespace, use execFile
+                const parts = interpolated.split(/\s+/).filter(Boolean);
+                const cmd = parts[0];
+                const args = parts.slice(1);
+                child = execFile(cmd, args, {
+                    timeout,
+                    env: { ...process.env },
+                });
+            }
+            // Ensure detached is false (default, but explicit via options above)
+            child.on("exit", onExit);
+            child.on("error", onError);
+        });
+        return { gateway: gatewayName, success: true };
+    }
+    catch (error) {
+        // Ensure SIGTERM handler is cleaned up on error
+        if (sigtermHandler) {
+            process.removeListener("SIGTERM", sigtermHandler);
+        }
+        return {
+            gateway: gatewayName,
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/openclaw/dispatcher.js.map

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

package/dist/openclaw/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenClaw Integration - Public API
+ *
+ * Wakes OpenClaw gateways on hook events.
+ * Most lifecycle events remain fire-and-forget, but callers may await
+ * ask-user-question delivery so downstream reply routing stays attached.
+ *
+ * Usage (from notify hook via wakeOpenClaw):
+ *   wakeOpenClaw("session-start", { sessionId, projectPath: directory });
+ *
+ * Activation requires RCS_OPENCLAW=1 env var and config in .rcs-config.json.
+ */
+export type { OpenClawCommandGatewayConfig, OpenClawConfig, OpenClawContext, OpenClawGatewayConfig, OpenClawHookEvent, OpenClawHookMapping, OpenClawHttpGatewayConfig, OpenClawPayload, OpenClawResult, } from "./types.js";
+export { getOpenClawConfig, resolveGateway, resetOpenClawConfigCache } from "./config.js";
+export { wakeGateway, wakeCommandGateway, interpolateInstruction, isCommandGateway, shellEscapeArg, validateGatewayUrl, } from "./dispatcher.js";
+import type { OpenClawHookEvent, OpenClawContext, OpenClawResult } from "./types.js";
+/**
+ * Wake the OpenClaw gateway mapped to a hook event.
+ *
+ * This is the main entry point called from the notify hook.
+ * Errors are swallowed and null is returned when OpenClaw is not configured
+ * or the event is not mapped.
+ *
+ * @param event - The hook event type
+ * @param context - Context data for template variable interpolation
+ * @returns OpenClawResult or null if not configured/mapped
+ */
+export declare function wakeOpenClaw(event: OpenClawHookEvent, context: OpenClawContext): Promise<OpenClawResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/openclaw/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openclaw/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,4BAA4B,EAC5B,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6BrF;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgGhC"}

package/dist/openclaw/index.js

@@ -0,0 +1,149 @@
+/**
+ * OpenClaw Integration - Public API
+ *
+ * Wakes OpenClaw gateways on hook events.
+ * Most lifecycle events remain fire-and-forget, but callers may await
+ * ask-user-question delivery so downstream reply routing stays attached.
+ *
+ * Usage (from notify hook via wakeOpenClaw):
+ *   wakeOpenClaw("session-start", { sessionId, projectPath: directory });
+ *
+ * Activation requires RCS_OPENCLAW=1 env var and config in .rcs-config.json.
+ */
+export { getOpenClawConfig, resolveGateway, resetOpenClawConfigCache } from "./config.js";
+export { wakeGateway, wakeCommandGateway, interpolateInstruction, isCommandGateway, shellEscapeArg, validateGatewayUrl, } from "./dispatcher.js";
+import { getOpenClawConfig, resolveGateway } from "./config.js";
+import { wakeGateway, wakeCommandGateway, interpolateInstruction, isCommandGateway } from "./dispatcher.js";
+import { basename } from "path";
+import { getCurrentTmuxSession, sanitizeTmuxAlertText } from "../notifications/tmux.js";
+/** Whether debug logging is enabled */
+const DEBUG = process.env.RCS_OPENCLAW_DEBUG === "1";
+/**
+ * Build a whitelisted context object from the input context.
+ * Only known fields are included to prevent accidental data leakage.
+ */
+function buildWhitelistedContext(context) {
+    const result = {};
+    if (context.sessionId !== undefined)
+        result.sessionId = context.sessionId;
+    if (context.projectPath !== undefined)
+        result.projectPath = context.projectPath;
+    if (context.tmuxSession !== undefined)
+        result.tmuxSession = context.tmuxSession;
+    if (context.prompt !== undefined)
+        result.prompt = context.prompt;
+    if (context.contextSummary !== undefined)
+        result.contextSummary = context.contextSummary;
+    if (context.reason !== undefined)
+        result.reason = context.reason;
+    if (context.question !== undefined)
+        result.question = context.question;
+    if (context.tmuxTail !== undefined)
+        result.tmuxTail = context.tmuxTail;
+    if (context.replyChannel !== undefined)
+        result.replyChannel = context.replyChannel;
+    if (context.replyTarget !== undefined)
+        result.replyTarget = context.replyTarget;
+    if (context.replyThread !== undefined)
+        result.replyThread = context.replyThread;
+    return result;
+}
+/**
+ * Wake the OpenClaw gateway mapped to a hook event.
+ *
+ * This is the main entry point called from the notify hook.
+ * Errors are swallowed and null is returned when OpenClaw is not configured
+ * or the event is not mapped.
+ *
+ * @param event - The hook event type
+ * @param context - Context data for template variable interpolation
+ * @returns OpenClawResult or null if not configured/mapped
+ */
+export async function wakeOpenClaw(event, context) {
+    try {
+        const config = getOpenClawConfig();
+        if (!config)
+            return null;
+        const resolved = resolveGateway(config, event);
+        if (!resolved)
+            return null;
+        const { gatewayName, gateway, instruction } = resolved;
+        // Single timestamp for both template variables and payload
+        const now = new Date().toISOString();
+        // Read originating channel context from env vars (set by external bot/automation)
+        const replyChannel = context.replyChannel ?? process.env.OPENCLAW_REPLY_CHANNEL ?? undefined;
+        const replyTarget = context.replyTarget ?? process.env.OPENCLAW_REPLY_TARGET ?? undefined;
+        const replyThread = context.replyThread ?? process.env.OPENCLAW_REPLY_THREAD ?? undefined;
+        const sanitizedContextTmuxTail = sanitizeTmuxAlertText(context.tmuxTail);
+        // Merge reply context into the context object for whitelisting
+        const enrichedContext = {
+            ...context,
+            tmuxTail: sanitizedContextTmuxTail,
+            ...(replyChannel !== undefined && { replyChannel }),
+            ...(replyTarget !== undefined && { replyTarget }),
+            ...(replyThread !== undefined && { replyThread }),
+        };
+        // Auto-detect tmux session if not provided in context
+        const tmuxSession = enrichedContext.tmuxSession ?? getCurrentTmuxSession() ?? undefined;
+        // Preserve only explicitly supplied tmux tails. Auto-capturing stop/session-end
+        // pane history here can replay historical pane lines after a session has been
+        // stopped or completed, which creates false follow-up alerts downstream.
+        const tmuxTail = enrichedContext.tmuxTail;
+        // Build template variables from whitelisted context fields
+        const variables = {
+            sessionId: enrichedContext.sessionId,
+            projectPath: enrichedContext.projectPath,
+            projectName: enrichedContext.projectPath ? basename(enrichedContext.projectPath) : undefined,
+            tmuxSession,
+            prompt: enrichedContext.prompt,
+            contextSummary: enrichedContext.contextSummary,
+            reason: enrichedContext.reason,
+            question: enrichedContext.question,
+            tmuxTail,
+            event,
+            timestamp: now,
+            replyChannel,
+            replyTarget,
+            replyThread,
+        };
+        // Add interpolated instruction to variables for command gateway {{instruction}} placeholder
+        const interpolatedInstruction = interpolateInstruction(instruction, variables);
+        variables.instruction = interpolatedInstruction;
+        let result;
+        if (isCommandGateway(gateway)) {
+            // Command gateway: execute shell command with shell-escaped variables
+            result = await wakeCommandGateway(gatewayName, gateway, variables);
+        }
+        else {
+            // HTTP gateway: send JSON payload
+            const payload = {
+                event,
+                instruction: interpolatedInstruction,
+                text: interpolatedInstruction,
+                timestamp: now,
+                sessionId: enrichedContext.sessionId,
+                projectPath: enrichedContext.projectPath,
+                projectName: enrichedContext.projectPath ? basename(enrichedContext.projectPath) : undefined,
+                tmuxSession,
+                tmuxTail,
+                ...(replyChannel !== undefined && { channel: replyChannel }),
+                ...(replyTarget !== undefined && { to: replyTarget }),
+                ...(replyThread !== undefined && { threadId: replyThread }),
+                context: buildWhitelistedContext(enrichedContext),
+            };
+            result = await wakeGateway(gatewayName, gateway, payload);
+        }
+        if (DEBUG) {
+            console.error(`[openclaw] wake ${event} -> ${gatewayName}: ${result.success ? "ok" : result.error}`);
+        }
+        return result;
+    }
+    catch (error) {
+        // Never let OpenClaw failures propagate to hooks
+        if (DEBUG) {
+            console.error(`[openclaw] wakeOpenClaw error:`, error instanceof Error ? error.message : error);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/openclaw/index.js.map

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

package/dist/openclaw/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * OpenClaw Gateway Integration Types
+ *
+ * Defines types for the OpenClaw gateway waker system.
+ * Each hook event can be mapped to a gateway with a pre-defined instruction.
+ *
+ * NOTE: Codex CLI only supports a limited set of hook events.
+ * pre-tool-use, post-tool-use, and keyword-detector are OMC-specific
+ * and are NOT available in Codex CLI — excluded here intentionally.
+ */
+/** Hook events that can trigger OpenClaw gateway calls */
+export type OpenClawHookEvent = "session-start" | "session-end" | "session-idle" | "ask-user-question" | "stop";
+/** HTTP gateway configuration (default when type is absent or "http") */
+export interface OpenClawHttpGatewayConfig {
+    /** Gateway type discriminator (optional for backward compat) */
+    type?: "http";
+    /** Gateway endpoint URL (HTTPS required, HTTP allowed for localhost) */
+    url: string;
+    /** Optional custom headers (e.g., Authorization) */
+    headers?: Record<string, string>;
+    /** HTTP method (default: POST) */
+    method?: "POST" | "PUT";
+    /** Per-request timeout in ms (default: 10000) */
+    timeout?: number;
+}
+/** CLI command gateway configuration */
+export interface OpenClawCommandGatewayConfig {
+    /** Gateway type discriminator */
+    type: "command";
+    /** Command template with {{variable}} placeholders.
+     *  Variables are shell-escaped automatically before interpolation. */
+    command: string;
+    /**
+     * Per-command timeout in ms.
+     * Precedence: gateway timeout > RCS_OPENCLAW_COMMAND_TIMEOUT_MS > default (5000ms).
+     * Runtime clamps to safe bounds.
+     */
+    timeout?: number;
+}
+/** Gateway configuration — HTTP or CLI command */
+export type OpenClawGatewayConfig = OpenClawHttpGatewayConfig | OpenClawCommandGatewayConfig;
+/** Per-hook-event mapping to a gateway + instruction */
+export interface OpenClawHookMapping {
+    /** Name of the gateway (key in gateways object) */
+    gateway: string;
+    /** Instruction template with {{variable}} placeholders */
+    instruction: string;
+    /** Whether this hook-event mapping is active */
+    enabled: boolean;
+}
+/** Top-level config schema for notifications.openclaw key in .rcs-config.json */
+export interface OpenClawConfig {
+    /** Global enable/disable */
+    enabled: boolean;
+    /** Named gateway endpoints */
+    gateways: Record<string, OpenClawGatewayConfig>;
+    /** Hook-event to gateway+instruction mappings */
+    hooks: Partial<Record<OpenClawHookEvent, OpenClawHookMapping>>;
+}
+/** Payload sent to an OpenClaw gateway */
+export interface OpenClawPayload {
+    /** The hook event that triggered this call */
+    event: OpenClawHookEvent;
+    /** Interpolated instruction text */
+    instruction: string;
+    /** Alias of instruction — allows OpenClaw /hooks/wake to consume the payload directly */
+    text: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Session identifier (if available) */
+    sessionId?: string;
+    /** Project directory path */
+    projectPath?: string;
+    /** Project basename */
+    projectName?: string;
+    /** Tmux session name (if running inside tmux) */
+    tmuxSession?: string;
+    /** Recent tmux pane output when explicitly supplied by the caller. */
+    tmuxTail?: string;
+    /** Originating channel for reply routing (if OPENCLAW_REPLY_CHANNEL is set) */
+    channel?: string;
+    /** Reply target user/bot (if OPENCLAW_REPLY_TARGET is set) */
+    to?: string;
+    /** Reply thread ID (if OPENCLAW_REPLY_THREAD is set) */
+    threadId?: string;
+    /** Context data from the hook (whitelisted fields only) */
+    context: OpenClawContext;
+}
+/**
+ * Context data passed from the hook to OpenClaw for template interpolation.
+ *
+ * All fields are explicitly enumerated (no index signature) to prevent
+ * accidental leakage of sensitive data into gateway payloads.
+ */
+export interface OpenClawContext {
+    sessionId?: string;
+    projectPath?: string;
+    tmuxSession?: string;
+    prompt?: string;
+    contextSummary?: string;
+    reason?: string;
+    question?: string;
+    /** Recent tmux pane output when explicitly supplied by the caller. */
+    tmuxTail?: string;
+    /** Originating channel for reply routing (from OPENCLAW_REPLY_CHANNEL env var) */
+    replyChannel?: string;
+    /** Reply target user/bot (from OPENCLAW_REPLY_TARGET env var) */
+    replyTarget?: string;
+    /** Reply thread ID for threaded conversations (from OPENCLAW_REPLY_THREAD env var) */
+    replyThread?: string;
+}
+/** Result of a gateway wake attempt */
+export interface OpenClawResult {
+    /** Gateway name */
+    gateway: string;
+    /** Whether the call succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** HTTP status code if available */
+    statusCode?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/openclaw/types.d.ts.map

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

package/dist/openclaw/types.js

@@ -0,0 +1,12 @@
+/**
+ * OpenClaw Gateway Integration Types
+ *
+ * Defines types for the OpenClaw gateway waker system.
+ * Each hook event can be mapped to a gateway with a pre-defined instruction.
+ *
+ * NOTE: Codex CLI only supports a limited set of hook events.
+ * pre-tool-use, post-tool-use, and keyword-detector are OMC-specific
+ * and are NOT available in Codex CLI — excluded here intentionally.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/openclaw/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openclaw/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/pipeline/__tests__/orchestrator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orchestrator.test.d.ts.map

package/dist/pipeline/__tests__/orchestrator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.test.d.ts","sourceRoot":"","sources":["../../../src/pipeline/__tests__/orchestrator.test.ts"],"names":[],"mappings":""}