@locusai/locus-gateway 0.22.13

package/dist/commands.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Command registry — defines all available commands and their properties.
+ *
+ * This is the single source of truth for command→CLI argument mapping,
+ * streaming behavior, and argument requirements.
+ */
+import type { CommandDefinition } from "./types.js";
+/** All known Locus CLI commands. */
+export declare const COMMAND_REGISTRY: Record<string, CommandDefinition>;
+/** Commands that produce streaming (long-running) output. */
+export declare const STREAMING_COMMANDS: Set<string>;
+/** Get the command definition for a command name, or null if not found. */
+export declare function getCommandDefinition(command: string): CommandDefinition | null;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAwB9D,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,aAI9B,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAE1B"}

package/dist/executor.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CommandExecutor — executes Locus CLI commands and git operations,
+ * producing output that the gateway can route back to any platform.
+ *
+ * Handles both streaming (long-running, real-time output) and
+ * buffered (collect-all-then-respond) command execution.
+ */
+import { CommandTracker } from "./tracker.js";
+import type { CommandResult } from "./types.js";
+/** Callback for streaming updates. */
+export interface StreamCallbacks {
+    /** Called when a streaming message should be sent (initial). */
+    onStart(text: string): Promise<string | undefined>;
+    /** Called periodically as new output arrives. messageId is from onStart. */
+    onUpdate(messageId: string, text: string): Promise<void>;
+    /** Called when the command is complete. */
+    onComplete(messageId: string, text: string, exitCode: number): Promise<void>;
+}
+export declare class CommandExecutor {
+    private tracker;
+    constructor(tracker: CommandTracker);
+    /** Get the tracker instance. */
+    getTracker(): CommandTracker;
+    /**
+     * Execute a Locus CLI command.
+     *
+     * For streaming commands, uses callbacks to push incremental output.
+     * For buffered commands, collects all output and returns it.
+     */
+    executeLocusCommand(sessionId: string, command: string, args: string[], callbacks?: StreamCallbacks): Promise<CommandResult & {
+        exitCode: number;
+    }>;
+    /**
+     * Execute a git command directly (not via the Locus CLI).
+     */
+    executeGit(sessionId: string, command: string, args: string[], gitArgs: string): Promise<CommandResult & {
+        exitCode: number;
+    }>;
+    /** Execute a streaming command with real-time output updates. */
+    private executeStreaming;
+    /** Execute a buffered command — collect all output, then return. */
+    private executeBuffered;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAOhE,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,2CAA2C;IAC3C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,cAAc;IAInC,gCAAgC;IAChC,UAAU,IAAI,cAAc;IAI5B;;;;;OAKG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,aAAa,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA4ChD;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAgChD,iEAAiE;YACnD,gBAAgB;IAsE9B,oEAAoE;YACtD,eAAe;CAgC9B"}

package/dist/formatter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MessageFormatter — adapts gateway output to each platform's capabilities.
+ *
+ * Handles format conversion (plain/markdown/html) and message splitting
+ * based on platform constraints.
+ */
+import type { PlatformCapabilities } from "./types.js";
+/** Determine the best output format for a platform. */
+export declare function bestFormat(capabilities: PlatformCapabilities): "plain" | "markdown" | "html";
+/** Split long text into chunks respecting platform message limits. */
+export declare function splitMessage(text: string, maxLength: number): string[];
+/** Truncate text to a max length, appending indicator if truncated. */
+export declare function truncate(text: string, maxLength: number): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,uDAAuD;AACvD,wBAAgB,UAAU,CACxB,YAAY,EAAE,oBAAoB,GACjC,OAAO,GAAG,UAAU,GAAG,MAAM,CAI/B;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBtE;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/gateway.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Gateway — the central orchestrator that connects platform adapters
+ * to the command execution pipeline.
+ *
+ * Adapters push inbound messages into the gateway. The gateway parses,
+ * routes, executes, and sends responses back through the originating adapter.
+ */
+import { CommandExecutor } from "./executor.js";
+import { CommandRouter } from "./router.js";
+import { CommandTracker } from "./tracker.js";
+import type { GatewayEvent, InboundMessage, PlatformAdapter } from "./types.js";
+export type GatewayEventHandler = (event: GatewayEvent) => void;
+export interface GatewayOptions {
+    /** Event handler for gateway events (optional). */
+    onEvent?: GatewayEventHandler;
+}
+export declare class Gateway {
+    private adapters;
+    private router;
+    private executor;
+    private tracker;
+    private onEvent?;
+    constructor(options?: GatewayOptions);
+    /** Register a platform adapter with the gateway. */
+    register(adapter: PlatformAdapter): void;
+    /** Get a registered adapter by platform name. */
+    getAdapter(platform: string): PlatformAdapter | undefined;
+    /** Get the command router. */
+    getRouter(): CommandRouter;
+    /** Get the command executor. */
+    getExecutor(): CommandExecutor;
+    /** Get the command tracker. */
+    getTracker(): CommandTracker;
+    /**
+     * Handle an inbound message from any platform.
+     *
+     * This is the main entry point — adapters call this when they
+     * receive a message from their platform.
+     */
+    handleMessage(message: InboundMessage): Promise<void>;
+    /** Start all registered adapters. */
+    start(): Promise<void>;
+    /** Stop all adapters gracefully. */
+    stop(): Promise<void>;
+    /** Execute a command and send the response through the adapter. */
+    private executeCommand;
+    /** Emit a gateway event. */
+    private emit;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIhF,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAsB;gBAE1B,OAAO,GAAE,cAAmB;IAOxC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAUxC,iDAAiD;IACjD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzD,8BAA8B;IAC9B,SAAS,IAAI,aAAa;IAI1B,gCAAgC;IAChC,WAAW,IAAI,eAAe;IAI9B,+BAA+B;IAC/B,UAAU,IAAI,cAAc;IAI5B;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3D,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,oCAAoC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,mEAAmE;YACrD,cAAc;IA+E5B,4BAA4B;IAC5B,OAAO,CAAC,IAAI;CASb"}