@ai-accounts/ts-core 0.3.0-alpha.2 → 0.3.1

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AiAccountsClient: () => AiAccountsClient,
+  PtySocket: () => PtySocket,
   WIRE_PROTOCOL_VERSION: () => WIRE_PROTOCOL_VERSION,
   createAccountWizard: () => createAccountWizard,
   createOnboardingFlow: () => createOnboardingFlow,
@@ -37,6 +38,7 @@ async function* parseSseLoginEvents(response) {
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  let consecutiveParseErrors = 0;
   try {
     while (true) {
       const { value, done } = await reader.read();
@@ -51,8 +53,25 @@ async function* parseSseLoginEvents(response) {
         if (!dataLine) continue;
         const payload = dataLine.slice(6);
         try {
-          yield JSON.parse(payload);
+          const parsed = JSON.parse(payload);
+          if (parsed && typeof parsed === "object" && typeof parsed.type === "string") {
+            consecutiveParseErrors = 0;
+            yield parsed;
+          } else {
+            console.warn("[ai-accounts] SSE frame missing type field:", payload.slice(0, 200));
+            consecutiveParseErrors++;
+          }
         } catch {
+          console.warn("[ai-accounts] malformed SSE frame:", payload.slice(0, 200));
+          consecutiveParseErrors++;
+        }
+        if (consecutiveParseErrors >= 3) {
+          yield {
+            type: "failed",
+            code: "stream_corrupt",
+            message: "Multiple malformed SSE frames received"
+          };
+          return;
         }
       }
     }
@@ -61,6 +80,97 @@ async function* parseSseLoginEvents(response) {
   }
 }
 
+// src/client/sse-parser.ts
+async function* parseSseFrames(response) {
+  if (!response.body) {
+    throw new Error("[ai-accounts] SSE response has no body");
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buf = "";
+  function* drain(flush) {
+    while (true) {
+      const boundary = findBoundary(buf);
+      if (boundary === null) {
+        if (!flush) return;
+        if (!buf.trim()) return;
+        const tail = buf;
+        buf = "";
+        const payload2 = extractDataPayload(tail);
+        if (payload2 !== null) yield payload2;
+        return;
+      }
+      const frame = buf.slice(0, boundary.index);
+      buf = buf.slice(boundary.index + boundary.length);
+      const payload = extractDataPayload(frame);
+      if (payload !== null) yield payload;
+    }
+  }
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        buf += decoder.decode();
+        yield* drain(true);
+        return;
+      }
+      buf += decoder.decode(value, { stream: true });
+      yield* drain(false);
+    }
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+}
+function findBoundary(buf) {
+  let best = null;
+  const candidates = ["\r\n\r\n", "\n\n", "\r\r"];
+  for (const sep of candidates) {
+    const i = buf.indexOf(sep);
+    if (i === -1) continue;
+    if (!best || i < best.index) best = { index: i, length: sep.length };
+  }
+  return best;
+}
+function extractDataPayload(frame) {
+  const dataLines = [];
+  for (const rawLine of frame.split(/\r?\n/)) {
+    if (!rawLine.startsWith("data:")) continue;
+    const rest = rawLine.slice(5);
+    dataLines.push(rest.startsWith(" ") ? rest.slice(1) : rest);
+  }
+  if (dataLines.length === 0) return null;
+  return dataLines.join("\n");
+}
+
+// src/client/chat-stream.ts
+async function* parseSseChatEvents(response) {
+  for await (const payload of parseSseFrames(response)) {
+    const trimmed = payload.trim();
+    if (!trimmed) continue;
+    try {
+      yield JSON.parse(trimmed);
+    } catch {
+      console.warn("[ai-accounts] malformed SSE chat frame dropped:", trimmed.slice(0, 200));
+    }
+  }
+}
+
+// src/client/smart-chat-stream.ts
+async function* parseSseSmartChatEvents(response) {
+  for await (const payload of parseSseFrames(response)) {
+    const trimmed = payload.trim();
+    if (!trimmed) continue;
+    try {
+      yield JSON.parse(trimmed);
+    } catch {
+      console.warn("[ai-accounts] malformed smart chat SSE frame dropped:", trimmed.slice(0, 200));
+    }
+  }
+}
+
 // src/client/index.ts
 async function toError(r) {
   let code = "http_error";
@@ -296,6 +406,126 @@ var AiAccountsClient = class {
     if (!r.ok) throw await toError(r);
     return await r.json();
   }
+  // --- CLIProxyAPI Server Lifecycle ---
+  async cliproxyServerStart(port = 8317, apiKey = "not-needed") {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/start`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ port, api_key: apiKey })
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyServerStop() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/stop`, {
+      method: "POST",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyServerStatus() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/status`, {
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  // --- Conversations / Chat ---
+  async createConversation(input) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(input)
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async listConversations(backendId) {
+    const qs = backendId ? `?backend_id=${encodeURIComponent(backendId)}` : "";
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/${qs}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getConversation(id) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/${encodeURIComponent(id)}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async *streamChat(sessionId, content) {
+    const url = `${this.baseUrl}/api/v1/conversations/${encodeURIComponent(sessionId)}/messages`;
+    const headers = { ...this.headers(), Accept: "text/event-stream" };
+    const r = await this._fetch(url, { method: "POST", headers, body: JSON.stringify({ content }) });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseChatEvents(r);
+  }
+  // --- Scheduler ---
+  async getSchedulerHealth() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/health`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getAccountHealth(id) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/health/${encodeURIComponent(id)}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async schedulerPick(kind) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/pick`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(kind ? { kind } : {})
+    });
+    if (r.status === 204) return null;
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getChain() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/chain`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async setChain(entries) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/chain`, {
+      method: "PUT",
+      headers: this.headers(),
+      body: JSON.stringify({ entries })
+    });
+    if (!r.ok) throw await toError(r);
+  }
+  async markRateLimited(backendId, seconds, reason) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/mark-limited`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ backend_id: backendId, cooldown_seconds: seconds, reason })
+    });
+    if (!r.ok) throw await toError(r);
+  }
+  // --- Smart Chat ---
+  async *sendChat(request, opts = {}) {
+    const url = `${this.baseUrl}/api/v1/chat/send`;
+    const headers = {
+      ...this.headers(),
+      Accept: "text/event-stream"
+    };
+    if (opts.lastEventId && opts.lastEventId > 0) {
+      headers["Last-Event-ID"] = String(opts.lastEventId);
+    }
+    const r = await this._fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(request),
+      ...opts.signal ? { signal: opts.signal } : {}
+    });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseSmartChatEvents(r);
+  }
+  async createChatSession(backendId, model) {
+    return this.createConversation({ backend_id: backendId, model });
+  }
+  async listChatSessions(backendId) {
+    return this.listConversations(backendId);
+  }
   async postAction(id, action, body) {
     const r = await this._fetch(
       `${this.baseUrl}/api/v1/backends/${encodeURIComponent(id)}/${action}`,
@@ -322,6 +552,46 @@ var AiAccountsClient = class {
   }
 };
 
+// src/client/pty-socket.ts
+var PtySocket = class {
+  ws = null;
+  opts;
+  closed = false;
+  constructor(opts) {
+    this.opts = opts;
+    this.connect();
+  }
+  connect() {
+    if (this.closed) return;
+    this.ws = new WebSocket(this.opts.url);
+    this.ws.binaryType = "arraybuffer";
+    this.ws.onmessage = (event) => {
+      if (event.data instanceof ArrayBuffer) {
+        this.opts.onData(new Uint8Array(event.data));
+      }
+    };
+    this.ws.onclose = () => {
+      if (!this.closed && this.opts.reconnectMs) {
+        setTimeout(() => this.connect(), this.opts.reconnectMs);
+      }
+      this.opts.onClose?.();
+    };
+    this.ws.onerror = (e) => {
+      this.opts.onError?.(e);
+    };
+  }
+  send(data) {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(data);
+    }
+  }
+  close() {
+    this.closed = true;
+    this.ws?.close();
+    this.ws = null;
+  }
+};
+
 // src/machines/accountWizard.ts
 function createAccountWizard(opts) {
   const listeners = /* @__PURE__ */ new Set();
@@ -622,6 +892,7 @@ var version = "0.0.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AiAccountsClient,
+  PtySocket,
   WIRE_PROTOCOL_VERSION,
   createAccountWizard,
   createOnboardingFlow,

package/dist/index.d.cts

@@ -73,6 +73,17 @@ type TextPrompt = {
     prompt: string;
     hidden: boolean;
 };
+type MenuOptionDTO = {
+    number: number;
+    label: string;
+    description?: string | null;
+};
+type MenuPrompt = {
+    type: 'menu_prompt';
+    prompt_id: string;
+    prompt: string;
+    options: MenuOptionDTO[];
+};
 type StdoutChunk = {
     type: 'stdout';
     text: string;
@@ -92,13 +103,94 @@ type LoginFailed = {
     code: string;
     message: string;
 };
-type LoginEvent = UrlPrompt | TextPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
+type LoginEvent = UrlPrompt | TextPrompt | MenuPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
 type PromptAnswer = {
     prompt_id: string;
     answer: string;
 };
 type LoginFlowKind = 'api_key' | 'oauth_device' | 'cli_browser';
 
+interface BackendResponse {
+    backend: string;
+    content: string;
+    status: 'streaming' | 'complete' | 'error' | 'timeout';
+    error?: string;
+}
+interface SynthesisState {
+    status: 'waiting' | 'streaming' | 'complete' | 'error';
+    content: string;
+    primaryBackend: string;
+    backendsCollected: string[];
+    error?: string;
+}
+interface BackendOption {
+    kind: string;
+    displayName: string;
+    accounts: string[];
+    models: string[];
+}
+type ProcessGroupType = 'tool_call' | 'reasoning' | 'code_execution';
+interface ToolCallDelta {
+    id: string;
+    name?: string;
+    arguments?: string;
+    group_type?: ProcessGroupType;
+}
+type _WithSeq<T> = T & {
+    _seq?: number;
+};
+type SmartChatEvent = _WithSeq<{
+    kind: 'token';
+    payload: string;
+} | {
+    kind: 'done';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'error';
+    payload: string;
+} | {
+    kind: 'backend_delta';
+    backend: string;
+    text: string;
+} | {
+    kind: 'backend_complete';
+    backend: string;
+} | {
+    kind: 'backend_error';
+    backend: string;
+    error: string;
+} | {
+    kind: 'backend_timeout';
+    backend: string;
+} | {
+    kind: 'synthesis_start';
+    primary_backend: string;
+    backends_collected: string[];
+} | {
+    kind: 'synthesis_delta';
+    text: string;
+} | {
+    kind: 'synthesis_complete';
+} | {
+    kind: 'synthesis_error';
+    error: string;
+} | {
+    kind: 'tool_call';
+    id: string;
+    name?: string;
+    arguments?: string;
+    group_type?: ProcessGroupType;
+}>;
+type ChatMode = 'single' | 'all' | 'compound';
+interface SendChatRequest {
+    session_id: string;
+    content: string;
+    mode?: ChatMode;
+    backend_kind?: string;
+    account_id?: string;
+    model?: string;
+}
+
 type InstallCheck = {
     command: string[];
     version_regex: string;
@@ -170,6 +262,61 @@ type CliproxyCallbackForwardResponse = {
     message: string;
 };
 
+interface ChatSessionDTO {
+    id: string;
+    backend_id: string;
+    model: string | null;
+    title: string | null;
+    created_at: string;
+}
+interface ChatMessageDTO {
+    id: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    created_at: string;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+interface ChatSessionDetailDTO extends ChatSessionDTO {
+    messages: ChatMessageDTO[];
+}
+interface ChatDelta {
+    kind: 'token' | 'done' | 'error';
+    text: string | null;
+    finish_reason: string | null;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+
+interface UsageWindowDTO {
+    window_type: string;
+    usage_percent: number;
+    resets_at: string | null;
+    tokens_used: number | null;
+    tokens_limit: number | null;
+}
+interface AccountHealthDTO {
+    backend_id: string;
+    kind: string;
+    windows: UsageWindowDTO[];
+    rate_limited_until: string | null;
+    rate_limit_reason: string | null;
+    last_used_at: string | null;
+    last_polled_at: string | null;
+}
+interface PickResultDTO {
+    backend_id: string;
+    kind: string;
+    isolation_dir: string;
+    retry_after: string | null;
+}
+interface FallbackChainEntryDTO {
+    backend_id: string;
+    priority: number;
+}
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -1121,6 +1268,7 @@ interface BackendDTO {
     display_name: string;
     status: string;
     config: Record<string, unknown>;
+    config_dir: string | null;
     last_error: string | null;
 }
 interface DetectResultDTO {
@@ -1204,6 +1352,50 @@ declare class AiAccountsClient {
     cliproxyInstall(): Promise<CliproxyInstallResult>;
     cliproxyLoginBegin(backendKind: string, configDir?: string): Promise<CliproxyLoginBeginResponse>;
     cliproxyCallbackForward(callbackUrl: string): Promise<CliproxyCallbackForwardResponse>;
+    cliproxyServerStart(port?: number, apiKey?: string): Promise<{
+        status: string;
+        port: number;
+        pid: number | null;
+        message: string;
+    }>;
+    cliproxyServerStop(): Promise<{
+        status: string;
+        message: string;
+    }>;
+    cliproxyServerStatus(): Promise<{
+        installed: boolean;
+        running: boolean;
+        port: number;
+        version: string | null;
+    }>;
+    createConversation(input: {
+        backend_id: string;
+        model: string;
+        title?: string;
+    }): Promise<ChatSessionDTO>;
+    listConversations(backendId?: string): Promise<{
+        items: ChatSessionDTO[];
+    }>;
+    getConversation(id: string): Promise<ChatSessionDetailDTO>;
+    streamChat(sessionId: string, content: string): AsyncIterable<ChatDelta>;
+    getSchedulerHealth(): Promise<{
+        items: AccountHealthDTO[];
+    }>;
+    getAccountHealth(id: string): Promise<AccountHealthDTO>;
+    schedulerPick(kind?: string): Promise<PickResultDTO | null>;
+    getChain(): Promise<{
+        entries: FallbackChainEntryDTO[];
+    }>;
+    setChain(entries: FallbackChainEntryDTO[]): Promise<void>;
+    markRateLimited(backendId: string, seconds: number, reason: string): Promise<void>;
+    sendChat(request: SendChatRequest, opts?: {
+        signal?: AbortSignal;
+        lastEventId?: number;
+    }): AsyncIterable<SmartChatEvent>;
+    createChatSession(backendId: string, model: string): Promise<ChatSessionDTO>;
+    listChatSessions(backendId?: string): Promise<{
+        items: ChatSessionDTO[];
+    }>;
     private postAction;
     private onboardingAction;
 }
@@ -1231,7 +1423,7 @@ type AiAccountsEvent = {
 } | {
     type: 'login.prompt';
     sessionId: string;
-    promptKind: 'url' | 'text';
+    promptKind: 'url' | 'text' | 'menu';
 } | {
     type: 'login.completed';
     sessionId: string;
@@ -1248,6 +1440,33 @@ type AiAccountsEvent = {
 };
 type AiAccountsEventHandler = (event: AiAccountsEvent) => void;
 
+interface PtySessionDTO {
+    session_id: string;
+}
+interface PtySpawnRequest {
+    backend_id: string;
+    command: string[];
+    cols?: number;
+    rows?: number;
+}
+
+interface PtySocketOptions {
+    url: string;
+    onData: (data: Uint8Array) => void;
+    onClose?: () => void;
+    onError?: (error: Event) => void;
+    reconnectMs?: number;
+}
+declare class PtySocket {
+    private ws;
+    private readonly opts;
+    private closed;
+    constructor(opts: PtySocketOptions);
+    private connect;
+    send(data: Uint8Array): void;
+    close(): void;
+}
+
 type WizardState = 'idle' | 'picking_kind' | 'detecting' | 'entering_credential' | 'validating' | 'done' | 'error';
 interface AccountWizard {
     readonly state: WizardState;
@@ -1297,4 +1516,4 @@ declare function createOnboardingFlow(opts: CreateOnboardingFlowOptions): Onboar
 
 declare const version = "0.0.0";
 
-export { type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type AiAccountsEvent, type AiAccountsEventHandler, type ApiError, type BackendDTO, type BackendMetadata, type ChatDoneEvent, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CliproxyCallbackForwardResponse, type CliproxyInstallResult, type CliproxyLoginBeginResponse, type CliproxyStatus, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type InputSpec, type InstallCheck, type InstallResult, type LoginComplete, type LoginEvent, type LoginFailed, type LoginFlowKind, type LoginFlowSpec, type LoginResponseDTO, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PlanOption, type ProgressUpdate, type PromptAnswer, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type SessionEndEvent, type SessionStartEvent, type StdoutChunk, type TextPrompt, type UrlPrompt, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };
+export { type AccountHealthDTO, type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type AiAccountsEvent, type AiAccountsEventHandler, type ApiError, type BackendDTO, type BackendMetadata, type BackendOption, type BackendResponse, type ChatDelta, type ChatDoneEvent, type ChatMessageDTO, type ChatMode, type ChatSessionDTO, type ChatSessionDetailDTO, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CliproxyCallbackForwardResponse, type CliproxyInstallResult, type CliproxyLoginBeginResponse, type CliproxyStatus, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type FallbackChainEntryDTO, type InputSpec, type InstallCheck, type InstallResult, type LoginComplete, type LoginEvent, type LoginFailed, type LoginFlowKind, type LoginFlowSpec, type LoginResponseDTO, type MenuOptionDTO, type MenuPrompt, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PickResultDTO, type PlanOption, type ProcessGroupType, type ProgressUpdate, type PromptAnswer, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type PtySessionDTO, PtySocket, type PtySocketOptions, type PtySpawnRequest, type SendChatRequest, type SessionEndEvent, type SessionStartEvent, type SmartChatEvent, type StdoutChunk, type SynthesisState, type TextPrompt, type ToolCallDelta, type UrlPrompt, type UsageWindowDTO, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };

package/dist/index.d.ts

@@ -73,6 +73,17 @@ type TextPrompt = {
     prompt: string;
     hidden: boolean;
 };
+type MenuOptionDTO = {
+    number: number;
+    label: string;
+    description?: string | null;
+};
+type MenuPrompt = {
+    type: 'menu_prompt';
+    prompt_id: string;
+    prompt: string;
+    options: MenuOptionDTO[];
+};
 type StdoutChunk = {
     type: 'stdout';
     text: string;
@@ -92,13 +103,94 @@ type LoginFailed = {
     code: string;
     message: string;
 };
-type LoginEvent = UrlPrompt | TextPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
+type LoginEvent = UrlPrompt | TextPrompt | MenuPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
 type PromptAnswer = {
     prompt_id: string;
     answer: string;
 };
 type LoginFlowKind = 'api_key' | 'oauth_device' | 'cli_browser';
 
+interface BackendResponse {
+    backend: string;
+    content: string;
+    status: 'streaming' | 'complete' | 'error' | 'timeout';
+    error?: string;
+}
+interface SynthesisState {
+    status: 'waiting' | 'streaming' | 'complete' | 'error';
+    content: string;
+    primaryBackend: string;
+    backendsCollected: string[];
+    error?: string;
+}
+interface BackendOption {
+    kind: string;
+    displayName: string;
+    accounts: string[];
+    models: string[];
+}
+type ProcessGroupType = 'tool_call' | 'reasoning' | 'code_execution';
+interface ToolCallDelta {
+    id: string;
+    name?: string;
+    arguments?: string;
+    group_type?: ProcessGroupType;
+}
+type _WithSeq<T> = T & {
+    _seq?: number;
+};
+type SmartChatEvent = _WithSeq<{
+    kind: 'token';
+    payload: string;
+} | {
+    kind: 'done';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'error';
+    payload: string;
+} | {
+    kind: 'backend_delta';
+    backend: string;
+    text: string;
+} | {
+    kind: 'backend_complete';
+    backend: string;
+} | {
+    kind: 'backend_error';
+    backend: string;
+    error: string;
+} | {
+    kind: 'backend_timeout';
+    backend: string;
+} | {
+    kind: 'synthesis_start';
+    primary_backend: string;
+    backends_collected: string[];
+} | {
+    kind: 'synthesis_delta';
+    text: string;
+} | {
+    kind: 'synthesis_complete';
+} | {
+    kind: 'synthesis_error';
+    error: string;
+} | {
+    kind: 'tool_call';
+    id: string;
+    name?: string;
+    arguments?: string;
+    group_type?: ProcessGroupType;
+}>;
+type ChatMode = 'single' | 'all' | 'compound';
+interface SendChatRequest {
+    session_id: string;
+    content: string;
+    mode?: ChatMode;
+    backend_kind?: string;
+    account_id?: string;
+    model?: string;
+}
+
 type InstallCheck = {
     command: string[];
     version_regex: string;
@@ -170,6 +262,61 @@ type CliproxyCallbackForwardResponse = {
     message: string;
 };
 
+interface ChatSessionDTO {
+    id: string;
+    backend_id: string;
+    model: string | null;
+    title: string | null;
+    created_at: string;
+}
+interface ChatMessageDTO {
+    id: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    created_at: string;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+interface ChatSessionDetailDTO extends ChatSessionDTO {
+    messages: ChatMessageDTO[];
+}
+interface ChatDelta {
+    kind: 'token' | 'done' | 'error';
+    text: string | null;
+    finish_reason: string | null;
+    model: string | null;
+    tokens_in: number | null;
+    tokens_out: number | null;
+}
+
+interface UsageWindowDTO {
+    window_type: string;
+    usage_percent: number;
+    resets_at: string | null;
+    tokens_used: number | null;
+    tokens_limit: number | null;
+}
+interface AccountHealthDTO {
+    backend_id: string;
+    kind: string;
+    windows: UsageWindowDTO[];
+    rate_limited_until: string | null;
+    rate_limit_reason: string | null;
+    last_used_at: string | null;
+    last_polled_at: string | null;
+}
+interface PickResultDTO {
+    backend_id: string;
+    kind: string;
+    isolation_dir: string;
+    retry_after: string | null;
+}
+interface FallbackChainEntryDTO {
+    backend_id: string;
+    priority: number;
+}
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -1121,6 +1268,7 @@ interface BackendDTO {
     display_name: string;
     status: string;
     config: Record<string, unknown>;
+    config_dir: string | null;
     last_error: string | null;
 }
 interface DetectResultDTO {
@@ -1204,6 +1352,50 @@ declare class AiAccountsClient {
     cliproxyInstall(): Promise<CliproxyInstallResult>;
     cliproxyLoginBegin(backendKind: string, configDir?: string): Promise<CliproxyLoginBeginResponse>;
     cliproxyCallbackForward(callbackUrl: string): Promise<CliproxyCallbackForwardResponse>;
+    cliproxyServerStart(port?: number, apiKey?: string): Promise<{
+        status: string;
+        port: number;
+        pid: number | null;
+        message: string;
+    }>;
+    cliproxyServerStop(): Promise<{
+        status: string;
+        message: string;
+    }>;
+    cliproxyServerStatus(): Promise<{
+        installed: boolean;
+        running: boolean;
+        port: number;
+        version: string | null;
+    }>;
+    createConversation(input: {
+        backend_id: string;
+        model: string;
+        title?: string;
+    }): Promise<ChatSessionDTO>;
+    listConversations(backendId?: string): Promise<{
+        items: ChatSessionDTO[];
+    }>;
+    getConversation(id: string): Promise<ChatSessionDetailDTO>;
+    streamChat(sessionId: string, content: string): AsyncIterable<ChatDelta>;
+    getSchedulerHealth(): Promise<{
+        items: AccountHealthDTO[];
+    }>;
+    getAccountHealth(id: string): Promise<AccountHealthDTO>;
+    schedulerPick(kind?: string): Promise<PickResultDTO | null>;
+    getChain(): Promise<{
+        entries: FallbackChainEntryDTO[];
+    }>;
+    setChain(entries: FallbackChainEntryDTO[]): Promise<void>;
+    markRateLimited(backendId: string, seconds: number, reason: string): Promise<void>;
+    sendChat(request: SendChatRequest, opts?: {
+        signal?: AbortSignal;
+        lastEventId?: number;
+    }): AsyncIterable<SmartChatEvent>;
+    createChatSession(backendId: string, model: string): Promise<ChatSessionDTO>;
+    listChatSessions(backendId?: string): Promise<{
+        items: ChatSessionDTO[];
+    }>;
     private postAction;
     private onboardingAction;
 }
@@ -1231,7 +1423,7 @@ type AiAccountsEvent = {
 } | {
     type: 'login.prompt';
     sessionId: string;
-    promptKind: 'url' | 'text';
+    promptKind: 'url' | 'text' | 'menu';
 } | {
     type: 'login.completed';
     sessionId: string;
@@ -1248,6 +1440,33 @@ type AiAccountsEvent = {
 };
 type AiAccountsEventHandler = (event: AiAccountsEvent) => void;
 
+interface PtySessionDTO {
+    session_id: string;
+}
+interface PtySpawnRequest {
+    backend_id: string;
+    command: string[];
+    cols?: number;
+    rows?: number;
+}
+
+interface PtySocketOptions {
+    url: string;
+    onData: (data: Uint8Array) => void;
+    onClose?: () => void;
+    onError?: (error: Event) => void;
+    reconnectMs?: number;
+}
+declare class PtySocket {
+    private ws;
+    private readonly opts;
+    private closed;
+    constructor(opts: PtySocketOptions);
+    private connect;
+    send(data: Uint8Array): void;
+    close(): void;
+}
+
 type WizardState = 'idle' | 'picking_kind' | 'detecting' | 'entering_credential' | 'validating' | 'done' | 'error';
 interface AccountWizard {
     readonly state: WizardState;
@@ -1297,4 +1516,4 @@ declare function createOnboardingFlow(opts: CreateOnboardingFlowOptions): Onboar
 
 declare const version = "0.0.0";
 
-export { type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type AiAccountsEvent, type AiAccountsEventHandler, type ApiError, type BackendDTO, type BackendMetadata, type ChatDoneEvent, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CliproxyCallbackForwardResponse, type CliproxyInstallResult, type CliproxyLoginBeginResponse, type CliproxyStatus, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type InputSpec, type InstallCheck, type InstallResult, type LoginComplete, type LoginEvent, type LoginFailed, type LoginFlowKind, type LoginFlowSpec, type LoginResponseDTO, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PlanOption, type ProgressUpdate, type PromptAnswer, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type SessionEndEvent, type SessionStartEvent, type StdoutChunk, type TextPrompt, type UrlPrompt, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };
+export { type AccountHealthDTO, type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type AiAccountsEvent, type AiAccountsEventHandler, type ApiError, type BackendDTO, type BackendMetadata, type BackendOption, type BackendResponse, type ChatDelta, type ChatDoneEvent, type ChatMessageDTO, type ChatMode, type ChatSessionDTO, type ChatSessionDetailDTO, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CliproxyCallbackForwardResponse, type CliproxyInstallResult, type CliproxyLoginBeginResponse, type CliproxyStatus, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type FallbackChainEntryDTO, type InputSpec, type InstallCheck, type InstallResult, type LoginComplete, type LoginEvent, type LoginFailed, type LoginFlowKind, type LoginFlowSpec, type LoginResponseDTO, type MenuOptionDTO, type MenuPrompt, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PickResultDTO, type PlanOption, type ProcessGroupType, type ProgressUpdate, type PromptAnswer, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type PtySessionDTO, PtySocket, type PtySocketOptions, type PtySpawnRequest, type SendChatRequest, type SessionEndEvent, type SessionStartEvent, type SmartChatEvent, type StdoutChunk, type SynthesisState, type TextPrompt, type ToolCallDelta, type UrlPrompt, type UsageWindowDTO, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };

package/dist/index.js

@@ -7,6 +7,7 @@ async function* parseSseLoginEvents(response) {
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  let consecutiveParseErrors = 0;
   try {
     while (true) {
       const { value, done } = await reader.read();
@@ -21,8 +22,25 @@ async function* parseSseLoginEvents(response) {
         if (!dataLine) continue;
         const payload = dataLine.slice(6);
         try {
-          yield JSON.parse(payload);
+          const parsed = JSON.parse(payload);
+          if (parsed && typeof parsed === "object" && typeof parsed.type === "string") {
+            consecutiveParseErrors = 0;
+            yield parsed;
+          } else {
+            console.warn("[ai-accounts] SSE frame missing type field:", payload.slice(0, 200));
+            consecutiveParseErrors++;
+          }
         } catch {
+          console.warn("[ai-accounts] malformed SSE frame:", payload.slice(0, 200));
+          consecutiveParseErrors++;
+        }
+        if (consecutiveParseErrors >= 3) {
+          yield {
+            type: "failed",
+            code: "stream_corrupt",
+            message: "Multiple malformed SSE frames received"
+          };
+          return;
         }
       }
     }
@@ -31,6 +49,97 @@ async function* parseSseLoginEvents(response) {
   }
 }
 
+// src/client/sse-parser.ts
+async function* parseSseFrames(response) {
+  if (!response.body) {
+    throw new Error("[ai-accounts] SSE response has no body");
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buf = "";
+  function* drain(flush) {
+    while (true) {
+      const boundary = findBoundary(buf);
+      if (boundary === null) {
+        if (!flush) return;
+        if (!buf.trim()) return;
+        const tail = buf;
+        buf = "";
+        const payload2 = extractDataPayload(tail);
+        if (payload2 !== null) yield payload2;
+        return;
+      }
+      const frame = buf.slice(0, boundary.index);
+      buf = buf.slice(boundary.index + boundary.length);
+      const payload = extractDataPayload(frame);
+      if (payload !== null) yield payload;
+    }
+  }
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        buf += decoder.decode();
+        yield* drain(true);
+        return;
+      }
+      buf += decoder.decode(value, { stream: true });
+      yield* drain(false);
+    }
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+}
+function findBoundary(buf) {
+  let best = null;
+  const candidates = ["\r\n\r\n", "\n\n", "\r\r"];
+  for (const sep of candidates) {
+    const i = buf.indexOf(sep);
+    if (i === -1) continue;
+    if (!best || i < best.index) best = { index: i, length: sep.length };
+  }
+  return best;
+}
+function extractDataPayload(frame) {
+  const dataLines = [];
+  for (const rawLine of frame.split(/\r?\n/)) {
+    if (!rawLine.startsWith("data:")) continue;
+    const rest = rawLine.slice(5);
+    dataLines.push(rest.startsWith(" ") ? rest.slice(1) : rest);
+  }
+  if (dataLines.length === 0) return null;
+  return dataLines.join("\n");
+}
+
+// src/client/chat-stream.ts
+async function* parseSseChatEvents(response) {
+  for await (const payload of parseSseFrames(response)) {
+    const trimmed = payload.trim();
+    if (!trimmed) continue;
+    try {
+      yield JSON.parse(trimmed);
+    } catch {
+      console.warn("[ai-accounts] malformed SSE chat frame dropped:", trimmed.slice(0, 200));
+    }
+  }
+}
+
+// src/client/smart-chat-stream.ts
+async function* parseSseSmartChatEvents(response) {
+  for await (const payload of parseSseFrames(response)) {
+    const trimmed = payload.trim();
+    if (!trimmed) continue;
+    try {
+      yield JSON.parse(trimmed);
+    } catch {
+      console.warn("[ai-accounts] malformed smart chat SSE frame dropped:", trimmed.slice(0, 200));
+    }
+  }
+}
+
 // src/client/index.ts
 async function toError(r) {
   let code = "http_error";
@@ -266,6 +375,126 @@ var AiAccountsClient = class {
     if (!r.ok) throw await toError(r);
     return await r.json();
   }
+  // --- CLIProxyAPI Server Lifecycle ---
+  async cliproxyServerStart(port = 8317, apiKey = "not-needed") {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/start`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ port, api_key: apiKey })
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyServerStop() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/stop`, {
+      method: "POST",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyServerStatus() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/server/status`, {
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  // --- Conversations / Chat ---
+  async createConversation(input) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(input)
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async listConversations(backendId) {
+    const qs = backendId ? `?backend_id=${encodeURIComponent(backendId)}` : "";
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/${qs}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getConversation(id) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/conversations/${encodeURIComponent(id)}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async *streamChat(sessionId, content) {
+    const url = `${this.baseUrl}/api/v1/conversations/${encodeURIComponent(sessionId)}/messages`;
+    const headers = { ...this.headers(), Accept: "text/event-stream" };
+    const r = await this._fetch(url, { method: "POST", headers, body: JSON.stringify({ content }) });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseChatEvents(r);
+  }
+  // --- Scheduler ---
+  async getSchedulerHealth() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/health`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getAccountHealth(id) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/health/${encodeURIComponent(id)}`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async schedulerPick(kind) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/pick`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(kind ? { kind } : {})
+    });
+    if (r.status === 204) return null;
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async getChain() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/chain`, { headers: this.headers() });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async setChain(entries) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/chain`, {
+      method: "PUT",
+      headers: this.headers(),
+      body: JSON.stringify({ entries })
+    });
+    if (!r.ok) throw await toError(r);
+  }
+  async markRateLimited(backendId, seconds, reason) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/scheduler/mark-limited`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ backend_id: backendId, cooldown_seconds: seconds, reason })
+    });
+    if (!r.ok) throw await toError(r);
+  }
+  // --- Smart Chat ---
+  async *sendChat(request, opts = {}) {
+    const url = `${this.baseUrl}/api/v1/chat/send`;
+    const headers = {
+      ...this.headers(),
+      Accept: "text/event-stream"
+    };
+    if (opts.lastEventId && opts.lastEventId > 0) {
+      headers["Last-Event-ID"] = String(opts.lastEventId);
+    }
+    const r = await this._fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(request),
+      ...opts.signal ? { signal: opts.signal } : {}
+    });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseSmartChatEvents(r);
+  }
+  async createChatSession(backendId, model) {
+    return this.createConversation({ backend_id: backendId, model });
+  }
+  async listChatSessions(backendId) {
+    return this.listConversations(backendId);
+  }
   async postAction(id, action, body) {
     const r = await this._fetch(
       `${this.baseUrl}/api/v1/backends/${encodeURIComponent(id)}/${action}`,
@@ -292,6 +521,46 @@ var AiAccountsClient = class {
   }
 };
 
+// src/client/pty-socket.ts
+var PtySocket = class {
+  ws = null;
+  opts;
+  closed = false;
+  constructor(opts) {
+    this.opts = opts;
+    this.connect();
+  }
+  connect() {
+    if (this.closed) return;
+    this.ws = new WebSocket(this.opts.url);
+    this.ws.binaryType = "arraybuffer";
+    this.ws.onmessage = (event) => {
+      if (event.data instanceof ArrayBuffer) {
+        this.opts.onData(new Uint8Array(event.data));
+      }
+    };
+    this.ws.onclose = () => {
+      if (!this.closed && this.opts.reconnectMs) {
+        setTimeout(() => this.connect(), this.opts.reconnectMs);
+      }
+      this.opts.onClose?.();
+    };
+    this.ws.onerror = (e) => {
+      this.opts.onError?.(e);
+    };
+  }
+  send(data) {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(data);
+    }
+  }
+  close() {
+    this.closed = true;
+    this.ws?.close();
+    this.ws = null;
+  }
+};
+
 // src/machines/accountWizard.ts
 function createAccountWizard(opts) {
   const listeners = /* @__PURE__ */ new Set();
@@ -591,6 +860,7 @@ function createOnboardingFlow(opts) {
 var version = "0.0.0";
 export {
   AiAccountsClient,
+  PtySocket,
   WIRE_PROTOCOL_VERSION,
   createAccountWizard,
   createOnboardingFlow,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-accounts/ts-core",
-  "version": "0.3.0-alpha.2",
+  "version": "0.3.1",
   "description": "Framework-agnostic TypeScript client and protocol for ai-accounts",
   "license": "Apache-2.0",
   "type": "module",