@grackle-ai/server 0.74.1 → 0.75.1

package/dist/ws-bridge.d.ts

@@ -1,27 +1,24 @@
 import { WebSocketServer, WebSocket } from "ws";
 import type { Server as HttpServer } from "node:http";
 import { taskStore } from "@grackle-ai/database";
-/** Options for {@link createWsBridge}. */
-export interface WsBridgeOptions {
-    /** Verify a Bearer-token API key. */
-    verifyApiKey: (token: string) => boolean;
-    /** Verify a session cookie. */
-    validateCookie?: (cookieHeader: string) => boolean;
-    /** The port the web/WS server is listening on (used for origin validation). */
-    webPort: number;
-    /** Whether the server is bound to a wildcard address (`--allow-network`). */
-    allowNetwork: boolean;
-}
 /**
- * Check whether a WebSocket connection's Origin header is acceptable.
+ * Check whether a WebSocket Origin header is allowed.
  *
- * - If no Origin is present (CLI/SDK clients), the connection is allowed.
- * - If Origin is present, it must target the expected web port.
- * - In local mode the Origin hostname must be a loopback address.
- * - In network mode (`--allow-network`) any hostname on the correct port is accepted.
+ * Rules:
+ * - Missing origin (non-browser clients, extensions) → always allowed
+ * - Origin port must match the web server port
+ * - In local mode (`allowNetwork === false`), hostname must be loopback
+ * - In network mode (`allowNetwork === true`), any hostname on the right port is allowed
  */
 export declare function isAllowedOrigin(origin: string | undefined, webPort: number, allowNetwork: boolean): boolean;
-/** Create a WebSocket server on top of an HTTP server that bridges JSON messages to gRPC operations. */
+/** Options for creating the WebSocket bridge. */
+interface WsBridgeOptions {
+    verifyApiKey: (token: string) => boolean;
+    validateCookie?: (cookieHeader: string) => boolean;
+    webPort?: number;
+    allowNetwork?: boolean;
+}
+/** Create a WebSocket server on top of an HTTP server for real-time event streaming. */
 export declare function createWsBridge(httpServer: HttpServer, options: WsBridgeOptions): WebSocketServer;
 /** Start a new agent session for a task. Returns an error message string on failure, undefined on success. */
 export declare function startTaskSession(ws: WebSocket | undefined, task: taskStore.TaskRow, options?: {
@@ -29,4 +26,5 @@ export declare function startTaskSession(ws: WebSocket | undefined, task: taskSt
     environmentId?: string;
     notes?: string;
 }): Promise<string | undefined>;
+export {};
 //# sourceMappingURL=ws-bridge.d.ts.map

package/dist/ws-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-bridge.d.ts","sourceRoot":"","sources":["../src/ws-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAItD,OAAO,EAA8E,SAAS,EAA4G,MAAM,sBAAsB,CAAC;AAuEvO,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,+BAA+B;IAC/B,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,GACpB,OAAO,CAyBT;AAED,wGAAwG;AACxG,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,eAAe,GACvB,eAAe,CAiDjB;AA6HD,8GAA8G;AAC9G,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,GAAG,SAAS,EACzB,IAAI,EAAE,SAAS,CAAC,OAAO,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6I7B"}
+{"version":3,"file":"ws-bridge.d.ts","sourceRoot":"","sources":["../src/ws-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAItD,OAAO,EAA6C,SAAS,EAAe,MAAM,sBAAsB,CAAC;AAqCzG;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,OAAO,GACpB,OAAO,CAyBT;AAQD,iDAAiD;AACjD,UAAU,eAAe;IACvB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,eAAe,GACvB,eAAe,CAiDjB;AA6HD,8GAA8G;AAC9G,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,GAAG,SAAS,EACzB,IAAI,EAAE,SAAS,CAAC,OAAO,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6I7B"}