wave-code 0.19.2 → 0.19.4

package/src/stdio/index.ts

@@ -0,0 +1,7 @@
+export { StdioServer, type StdioServerOptions } from "./stdioServer.js";
+export {
+  AgentBridge,
+  type AgentBridgeOptions,
+  RpcError,
+} from "./agentBridge.js";
+export * from "./protocol.js";

package/src/stdio/protocol.ts

@@ -0,0 +1,134 @@
+/**
+ * JSON-RPC 2.0-compatible protocol types for stdio communication.
+ *
+ * Each line on stdin/stdout is one JSON object.
+ * - Requests have `id` (number|string) and expect a response.
+ * - Responses match the request `id` with either `result` or `error`.
+ * - Notifications have no `id` and expect no response.
+ */
+
+// ── Envelope types ──────────────────────────────────────────────
+
+export interface JsonRpcRequest {
+  id: number | string;
+  method: string;
+  params?: unknown;
+  /** Session-scoped requests carry sessionId for routing to the right Agent. */
+  sessionId?: string;
+}
+
+export interface JsonRpcResponse {
+  id: number | string | null;
+  result?: unknown;
+  error?: JsonRpcError;
+}
+
+export interface JsonRpcError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+export interface JsonRpcNotification {
+  method: string;
+  params?: unknown;
+  /** Session-scoped notifications carry sessionId for demultiplexing on the client. */
+  sessionId?: string;
+}
+
+// ── Error codes (JSON-RPC 2.0 standard) ────────────────────────
+
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+
+// ── Client → Server request methods ─────────────────────────────
+
+export type RequestMethod =
+  | "initialize"
+  | "destroy"
+  | "restoreSession"
+  | "listSessions"
+  | "getSessionInfo"
+  | "sendMessage"
+  | "bang"
+  | "abortMessage"
+  | "clearMessages"
+  | "rewindToMessage"
+  | "deleteQueuedMessage"
+  | "getMessages"
+  | "getFullMessageThread"
+  | "setPermissionMode"
+  | "getPermissionMode"
+  | "getMcpServers"
+  | "connectMcpServer"
+  | "disconnectMcpServer"
+  | "getSlashCommands"
+  | "searchFiles"
+  | "getPromptHistory"
+  | "searchPromptHistory"
+  | "updateConfig"
+  // Auth
+  | "getAuthStatus"
+  | "login"
+  | "logout"
+  // Plugins
+  | "listPlugins"
+  | "installPlugin"
+  | "uninstallPlugin"
+  | "enablePlugin"
+  | "disablePlugin"
+  | "updatePlugin"
+  | "listMarketplaces"
+  | "addMarketplace"
+  | "removeMarketplace"
+  | "updateMarketplace";
+
+// ── Client → Server notification methods ────────────────────────
+
+export type ClientNotificationMethod = "permissionResponse";
+
+// ── Server → Client notification methods ────────────────────────
+
+export type ServerNotificationMethod =
+  | "messagesChange"
+  | "userMessageAdded"
+  | "assistantMessageAdded"
+  | "assistantContentUpdated"
+  | "assistantReasoningUpdated"
+  | "toolBlockUpdated"
+  | "errorBlockAdded"
+  | "loadingChange"
+  | "commandRunningChange"
+  | "queuedMessagesChange"
+  | "tasksChange"
+  | "sessionIdChange"
+  | "permissionModeChange"
+  | "mcpServersChange"
+  | "bangMessageAdded"
+  | "bangMessageUpdated"
+  | "bangMessageCompleted"
+  | "notificationMessageAdded"
+  | "permissionRequest"
+  | "authUrl";
+
+// ── Helper: is this a request (has id)? ─────────────────────────
+
+export function isRequest(msg: unknown): msg is JsonRpcRequest {
+  return (
+    typeof msg === "object" &&
+    msg !== null &&
+    "method" in msg &&
+    "id" in msg &&
+    (typeof (msg as { id: unknown }).id === "number" ||
+      typeof (msg as { id: unknown }).id === "string")
+  );
+}
+
+export function isNotification(msg: unknown): msg is JsonRpcNotification {
+  return (
+    typeof msg === "object" && msg !== null && "method" in msg && !("id" in msg)
+  );
+}

package/src/stdio/stdioServer.ts

@@ -0,0 +1,169 @@
+/**
+ * StdioServer — reads JSON-RPC messages from stdin, dispatches to AgentBridge,
+ * and writes responses / notifications to stdout.
+ *
+ * One JSON object per line. stderr is reserved for logger output.
+ */
+
+import readline from "readline";
+import type { Readable, Writable } from "stream";
+import { AgentBridge, type AgentBridgeOptions } from "./agentBridge.js";
+import {
+  type JsonRpcRequest,
+  type JsonRpcResponse,
+  type JsonRpcNotification,
+  PARSE_ERROR,
+  INVALID_REQUEST,
+  INTERNAL_ERROR,
+  isRequest,
+  isNotification,
+} from "./protocol.js";
+
+export interface StdioServerOptions {
+  input?: Readable;
+  output?: Writable;
+  bridgeOptions?: AgentBridgeOptions;
+}
+
+export class StdioServer {
+  private rl: readline.Interface | undefined;
+  private bridge: AgentBridge;
+  private input: Readable;
+  private output: Writable;
+  private started = false;
+
+  constructor(options: StdioServerOptions = {}) {
+    this.input = options.input ?? process.stdin;
+    this.output = options.output ?? process.stdout;
+    this.bridge = new AgentBridge({
+      ...options.bridgeOptions,
+      emit: (method, params, sessionId) =>
+        this.sendNotification(method, params, sessionId),
+    });
+  }
+
+  get agentBridge(): AgentBridge {
+    return this.bridge;
+  }
+
+  start(): void {
+    if (this.started) return;
+    this.started = true;
+
+    this.rl = readline.createInterface({
+      input: this.input,
+      crlfDelay: Infinity,
+    });
+
+    this.rl.on("line", (line: string) => {
+      this.handleLine(line).catch((err) => {
+        // Should never reach here — handleLine catches internally
+        this.sendResponse(null, undefined, {
+          code: INTERNAL_ERROR,
+          message: `Unhandled error: ${(err as Error).message}`,
+        });
+      });
+    });
+
+    this.rl.on("close", () => {
+      this.started = false;
+    });
+  }
+
+  stop(): void {
+    this.rl?.close();
+    this.rl = undefined;
+    this.started = false;
+  }
+
+  async handleLine(line: string): Promise<void> {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+
+    let msg: unknown;
+    try {
+      msg = JSON.parse(trimmed);
+    } catch {
+      this.sendResponse(null, undefined, {
+        code: PARSE_ERROR,
+        message: "Parse error: invalid JSON",
+      });
+      return;
+    }
+
+    if (isRequest(msg)) {
+      await this.handleRequest(msg);
+    } else if (isNotification(msg)) {
+      this.handleNotification(msg);
+    } else {
+      // Echo back the id if the message has one, otherwise null
+      const id =
+        typeof msg === "object" &&
+        msg !== null &&
+        "id" in msg &&
+        (typeof (msg as { id: unknown }).id === "number" ||
+          typeof (msg as { id: unknown }).id === "string")
+          ? (msg as { id: number | string }).id
+          : null;
+      this.sendResponse(id, undefined, {
+        code: INVALID_REQUEST,
+        message: "Invalid request: must have 'method' field",
+      });
+    }
+  }
+
+  private async handleRequest(msg: JsonRpcRequest): Promise<void> {
+    try {
+      const result = await this.bridge.handleRequest(
+        msg.method,
+        msg.params,
+        msg.sessionId,
+      );
+      this.sendResponse(msg.id, result);
+    } catch (err) {
+      const code =
+        err && typeof err === "object" && "code" in err
+          ? (err as { code: number }).code
+          : INTERNAL_ERROR;
+      const message = err instanceof Error ? err.message : String(err);
+      this.sendResponse(msg.id, undefined, { code, message });
+    }
+  }
+
+  private handleNotification(msg: JsonRpcNotification): void {
+    try {
+      this.bridge.handleNotification(msg.method, msg.params);
+    } catch (err) {
+      // Notifications don't get responses, but we log to stderr
+      process.stderr.write(
+        `Error handling notification ${msg.method}: ${(err as Error).message}\n`,
+      );
+    }
+  }
+
+  // ── Output helpers ────────────────────────────────────────────
+
+  sendResponse(
+    id: number | string | null,
+    result?: unknown,
+    error?: { code: number; message: string },
+  ): void {
+    const response: JsonRpcResponse = { id };
+    if (error) {
+      response.error = error;
+    } else {
+      response.result = result ?? null;
+    }
+    this.write(response);
+  }
+
+  sendNotification(method: string, params?: unknown, sessionId?: string): void {
+    const notification: JsonRpcNotification = { method, params };
+    if (sessionId) notification.sessionId = sessionId;
+    this.write(notification);
+  }
+
+  private write(obj: JsonRpcResponse | JsonRpcNotification): void {
+    this.output.write(JSON.stringify(obj) + "\n");
+  }
+}

package/src/stdio-cli.ts

@@ -0,0 +1,18 @@
+/**
+ * stdio-cli.ts — Entry point for `wave --stdio` mode.
+ *
+ * Starts a StdioServer that reads JSON-RPC messages from stdin and writes
+ * responses/notifications to stdout. The server creates an Agent lazily when
+ * the client sends an "initialize" request.
+ */
+
+import { StdioServer } from "./stdio/stdioServer.js";
+
+export async function startStdioCli(): Promise<void> {
+  const server = new StdioServer();
+  server.start();
+
+  // Keep the process alive — readline on stdin handles the event loop.
+  // When stdin closes (EOF), the readline interface emits 'close' and
+  // the process will exit naturally.
+}

package/dist/acp/agent.d.ts

@@ -1,32 +0,0 @@
-import { type Agent as AcpAgent, type AgentSideConnection, type InitializeResponse, type NewSessionRequest, type NewSessionResponse, type LoadSessionRequest, type LoadSessionResponse, type ListSessionsRequest, type ListSessionsResponse, type PromptRequest, type PromptResponse, type CancelNotification, type AuthenticateResponse, type SetSessionModeRequest, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse } from "@agentclientprotocol/sdk";
-export declare class WaveAcpAgent implements AcpAgent {
-    private agents;
-    private connection;
-    private taskCache;
-    constructor(connection: AgentSideConnection);
-    private getSessionModeState;
-    private getSessionConfigOptions;
-    private cleanupAllAgents;
-    initialize(): Promise<InitializeResponse>;
-    authenticate(): Promise<AuthenticateResponse | void>;
-    private createAgent;
-    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
-    loadSession(params: LoadSessionRequest): Promise<LoadSessionResponse>;
-    listSessions(params: ListSessionsRequest): Promise<ListSessionsResponse>;
-    unstable_closeSession(params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    extMethod(method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    setSessionMode(params: SetSessionModeRequest): Promise<void>;
-    setSessionConfigOption(params: SetSessionConfigOptionRequest): Promise<SetSessionConfigOptionResponse>;
-    prompt(params: PromptRequest): Promise<PromptResponse>;
-    cancel(params: CancelNotification): Promise<void>;
-    private getAllowAlwaysName;
-    private handleAskQuestion;
-    private handleCreatePlan;
-    private handlePermissionRequest;
-    private getToolContent;
-    private getToolLocations;
-    private getToolKind;
-    private replayConversationHistory;
-    private createCallbacks;
-}
-//# sourceMappingURL=agent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/acp/agent.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,KAAK,KAAK,IAAI,QAAQ,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAUzB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EAQpC,MAAM,0BAA0B,CAAC;AAwBlC,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,SAAS,CAA6B;gBAElC,UAAU,EAAE,mBAAmB;IAI3C,OAAO,CAAC,mBAAmB;IAkC3B,OAAO,CAAC,uBAAuB;YAmCjB,gBAAgB;IASxB,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAyBzC,YAAY,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;YAI5C,WAAW;IAkFnB,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAalE,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAcrE,YAAY,CAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAuB1B,qBAAqB,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAc7B,SAAS,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO7B,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D,sBAAsB,CAC1B,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,8BAA8B,CAAC;IAuBpC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA+DtD,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD,OAAO,CAAC,kBAAkB;YA2BZ,iBAAiB;YAsEjB,gBAAgB;YAyDhB,uBAAuB;IAmNrC,OAAO,CAAC,cAAc;IA6FtB,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,WAAW;YAmBL,yBAAyB;IAoIvC,OAAO,CAAC,eAAe;CAgTxB"}