@questionbase/deskfree 0.6.2 → 0.6.3

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { PluginLogger, AgentContext, DeskFreeClient, DeskFreeTool, ChatMessage, RuntimeBootstrapConfig } from '@deskfree/core';
 import * as _anthropic_ai_claude_agent_sdk from '@anthropic-ai/claude-agent-sdk';
 import { McpSdkServerConfigWithInstance, SDKMessage, SDKUserMessage, Query, tool } from '@anthropic-ai/claude-agent-sdk';
+import WebSocket from 'ws';
 
 interface StartAgentOptions {
     log?: PluginLogger;
@@ -11,7 +12,7 @@ type DisposeAgent = () => void;
  * Full agent startup sequence:
  *
  * 1. Load local config (botId + apiUrl from env)
- * 2. Connect to DeskFree (bots.connect → rotation token)
+ * 2. Connect to DeskFree (WS-first → rotation token)
  * 3. Create authenticated DeskFree client
  * 4. Bootstrap: fetch config from API (wsUrl, model, region, tools)
  * 5. Install enabled tool packages
@@ -268,19 +269,6 @@ declare class SessionStore {
     dispose(): void;
 }
 
-/** Host fingerprint sent to bots.connect. */
-interface HostFingerprint {
-    hostId: string;
-    machineId: string;
-    platform: string;
-    arch: string;
-    hostname: string;
-    cpuModel: string;
-    totalMemory: number;
-    nodeVersion: string;
-    runtimeVersion: string;
-}
-
 interface WorkerStatus {
     activeWorkers: number;
     queuedTasks: number;
@@ -297,22 +285,19 @@ interface GatewayConfig {
     getWorkerStatus?: () => WorkerStatus;
     /** Trigger memory consolidation on demand. Returns status string. */
     onConsolidate?: () => Promise<string>;
-    /** Bot ID for bots.connect flow */
+    /** Bot ID for WS-first connection */
     botId: string;
-    /** Public API URL for bots.connect (e.g. https://stage.domain/v1/public) */
-    publicApiUrl: string;
-    /** Host fingerprint for bots.connect */
-    fingerprint: HostFingerprint;
-    /** Ticket + wsUrl from initial bots.connect — skip first connect call */
-    initialTicket?: {
-        ticket: string;
-        wsUrl: string;
-    };
+    /** Deployment stage (e.g. "dev", "alpha") */
+    stage: string;
+    /** Live WebSocket from initial connect (first iteration only) */
+    initialWs: WebSocket;
+    /** Rotation token from initial connect */
+    initialRotationToken: string;
 }
 /**
  * Start the WS gateway — reconnection loop with backoff.
  *
- * Flow: bots.connect → WS connect → heartbeat rotation → proactive reconnect
+ * Flow: WS connect → init → "go" → run connection → proactive reconnect
  */
 declare function startGateway(config: GatewayConfig): Promise<void>;
 
@@ -348,6 +333,10 @@ interface LocalConfig {
     botId: string;
     /** DeskFree backend API URL */
     apiUrl: string;
+    /** Deployment stage (e.g. "dev", "alpha") */
+    stage: string;
+    /** WebSocket URL (derived from domain or explicit override) */
+    wsUrl: string;
     /** Directory for cursor + media storage */
     stateDir: string;
     /** Directory for dynamic tool installs */