@ai-accounts/ts-core 0.2.1 → 0.3.0-alpha.1

package/dist/index.cjs

@@ -31,6 +31,36 @@ module.exports = __toCommonJS(index_exports);
 // src/protocol/wire.ts
 var WIRE_PROTOCOL_VERSION = 1;
 
+// src/client/login-stream.ts
+async function* parseSseLoginEvents(response) {
+  if (!response.body) return;
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      while (true) {
+        const sep = buffer.indexOf("\n\n");
+        if (sep === -1) break;
+        const frame = buffer.slice(0, sep);
+        buffer = buffer.slice(sep + 2);
+        const dataLine = frame.split("\n").find((l) => l.startsWith("data: "));
+        if (!dataLine) continue;
+        const payload = dataLine.slice(6);
+        try {
+          yield JSON.parse(payload);
+        } catch {
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 // src/client/index.ts
 async function toError(r) {
   let code = "http_error";
@@ -55,7 +85,11 @@ var AiAccountsClient = class {
   constructor(opts) {
     this.baseUrl = opts.baseUrl.replace(/\/$/, "");
     this.token = opts.token;
-    this._fetch = opts.fetch ?? fetch;
+    if (opts.fetch) {
+      this._fetch = opts.fetch;
+    } else {
+      this._fetch = (input, init) => fetch(input, init);
+    }
   }
   headers() {
     const h = { "content-type": "application/json" };
@@ -126,6 +160,55 @@ var AiAccountsClient = class {
   async validateBackend(id) {
     return this.postAction(id, "validate");
   }
+  async beginLogin(accountId, flowKind, inputs) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/begin`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ flow_kind: flowKind, inputs })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async respondLogin(accountId, sessionId, promptId, answer) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/respond`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ session_id: sessionId, prompt_id: promptId, answer })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+  }
+  async cancelLogin(accountId, sessionId) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/cancel`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ session_id: sessionId })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+  }
+  async *streamLogin(accountId, sessionId) {
+    const url = `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/stream?session_id=${encodeURIComponent(sessionId)}`;
+    const headers = { Accept: "text/event-stream" };
+    if (this.token) headers["authorization"] = `Bearer ${this.token}`;
+    const r = await this._fetch(url, { method: "GET", headers });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseLoginEvents(r);
+  }
+  async getBackendMetadata() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/backends/_meta`, {
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
   async startOnboarding() {
     const r = await this._fetch(`${this.baseUrl}/api/v1/onboarding`, {
       method: "POST",
@@ -163,6 +246,56 @@ var AiAccountsClient = class {
   async finalizeOnboarding(id) {
     return this.onboardingAction(id, "finalize");
   }
+  // --- Backend CLI install ---
+  async installBackendCli(kind) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(kind)}/install`,
+      {
+        method: "POST",
+        headers: this.headers()
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  // --- CLIProxyAPI ---
+  async cliproxyStatus() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/status`, {
+      method: "GET",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyInstall() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/install`, {
+      method: "POST",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyLoginBegin(backendKind, configDir) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/login/begin`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ backend_kind: backendKind, config_dir: configDir ?? null })
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyCallbackForward(callbackUrl) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/cliproxy/login/callback-forward`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ callback_url: callbackUrl })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
   async postAction(id, action, body) {
     const r = await this._fetch(
       `${this.baseUrl}/api/v1/backends/${encodeURIComponent(id)}/${action}`,

package/dist/index.d.cts

@@ -61,6 +61,115 @@ interface ErrorEvent {
 }
 type WireEvent = SessionStartEvent | SessionEndEvent | ChatTokenEvent | ChatToolCallEvent | ChatDoneEvent | PtyOutputEvent | PtyResizeEvent | PtyExitEvent | ErrorEvent;
 
+type UrlPrompt = {
+    type: 'url_prompt';
+    prompt_id: string;
+    url: string;
+    user_code?: string | null;
+};
+type TextPrompt = {
+    type: 'text_prompt';
+    prompt_id: string;
+    prompt: string;
+    hidden: boolean;
+};
+type StdoutChunk = {
+    type: 'stdout';
+    text: string;
+};
+type ProgressUpdate = {
+    type: 'progress';
+    label: string;
+    percent?: number | null;
+};
+type LoginComplete = {
+    type: 'complete';
+    account_id: string;
+    backend_status: string;
+};
+type LoginFailed = {
+    type: 'failed';
+    code: string;
+    message: string;
+};
+type LoginEvent = UrlPrompt | TextPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
+type PromptAnswer = {
+    prompt_id: string;
+    answer: string;
+};
+type LoginFlowKind = 'api_key' | 'oauth_device' | 'cli_browser';
+
+type InstallCheck = {
+    command: string[];
+    version_regex: string;
+};
+type InputSpec = {
+    name: string;
+    label: string;
+    kind: 'text' | 'secret' | 'email' | 'path';
+    placeholder?: string | null;
+};
+type LoginFlowSpec = {
+    kind: string;
+    display_name: string;
+    description: string;
+    requires_inputs: InputSpec[];
+};
+type PlanOption = {
+    id: string;
+    label: string;
+    description: string;
+};
+type BackendMetadata = {
+    kind: string;
+    display_name: string;
+    icon_url: string | null;
+    install_check: InstallCheck;
+    login_flows: LoginFlowSpec[];
+    plan_options: PlanOption[] | null;
+    config_schema: Record<string, unknown>;
+    supports_multi_account: boolean;
+    isolation_env_var: string | null;
+};
+
+/**
+ * Types for backend CLI install + CLIProxyAPI install/login flows.
+ *
+ * Mirror of Python models in `ai_accounts.core.cli_install` /
+ * `ai_accounts.core.cliproxy_manager` and the Litestar route responses.
+ */
+type InstallResult = {
+    kind: string;
+    success: boolean;
+    display: string;
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+    binary_path: string | null;
+};
+type CliproxyStatus = {
+    installed: boolean;
+    version: string | null;
+    binary_path: string | null;
+};
+type CliproxyInstallResult = {
+    success: boolean;
+    display: string;
+    stdout: string;
+    stderr: string;
+    binary_path: string | null;
+};
+type CliproxyLoginBeginResponse = {
+    status: 'started' | 'imported' | 'skipped' | 'error';
+    message: string;
+    oauth_url?: string | null;
+    device_code?: string | null;
+};
+type CliproxyCallbackForwardResponse = {
+    status: 'completed' | 'error';
+    message: string;
+};
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -1074,6 +1183,15 @@ declare class AiAccountsClient {
     loginBackend(id: string, flowKind: string, inputs: Record<string, string>): Promise<LoginResponseDTO>;
     pollBackendLogin(id: string, handle: string): Promise<LoginResponseDTO>;
     validateBackend(id: string): Promise<BackendDTO>;
+    beginLogin(accountId: string, flowKind: LoginFlowKind, inputs: Record<string, string>): Promise<{
+        session_id: string;
+    }>;
+    respondLogin(accountId: string, sessionId: string, promptId: string, answer: string): Promise<void>;
+    cancelLogin(accountId: string, sessionId: string): Promise<void>;
+    streamLogin(accountId: string, sessionId: string): AsyncIterable<LoginEvent>;
+    getBackendMetadata(): Promise<{
+        items: BackendMetadata[];
+    }>;
     startOnboarding(): Promise<OnboardingStateDTO>;
     getOnboarding(id: string): Promise<OnboardingStateDTO>;
     detectForOnboarding(id: string): Promise<DetectResultsDTO>;
@@ -1081,10 +1199,55 @@ declare class AiAccountsClient {
     beginOnboardingLogin(id: string, flowKind: string, inputs: Record<string, string>): Promise<LoginResponseDTO>;
     pollOnboardingLogin(id: string, handle: string): Promise<LoginResponseDTO>;
     finalizeOnboarding(id: string): Promise<OnboardingStateDTO>;
+    installBackendCli(kind: string): Promise<InstallResult>;
+    cliproxyStatus(): Promise<CliproxyStatus>;
+    cliproxyInstall(): Promise<CliproxyInstallResult>;
+    cliproxyLoginBegin(backendKind: string, configDir?: string): Promise<CliproxyLoginBeginResponse>;
+    cliproxyCallbackForward(callbackUrl: string): Promise<CliproxyCallbackForwardResponse>;
     private postAction;
     private onboardingAction;
 }
 
+type AiAccountsEvent = {
+    type: 'wizard.opened';
+    backendKind: string;
+} | {
+    type: 'wizard.step';
+    backendKind: string;
+    step: string;
+} | {
+    type: 'wizard.account.created';
+    backendKind: string;
+    accountId: string;
+} | {
+    type: 'wizard.closed';
+    backendKind: string;
+    reason: 'done' | 'skip' | 'cancel';
+} | {
+    type: 'login.started';
+    sessionId: string;
+    backendKind: string;
+    flow: string;
+} | {
+    type: 'login.prompt';
+    sessionId: string;
+    promptKind: 'url' | 'text';
+} | {
+    type: 'login.completed';
+    sessionId: string;
+    accountId: string;
+} | {
+    type: 'login.failed';
+    sessionId: string;
+    code: string;
+    message: string;
+} | {
+    type: 'internal.handler_error';
+    error: string;
+    original: AiAccountsEvent;
+};
+type AiAccountsEventHandler = (event: AiAccountsEvent) => void;
+
 type WizardState = 'idle' | 'picking_kind' | 'detecting' | 'entering_credential' | 'validating' | 'done' | 'error';
 interface AccountWizard {
     readonly state: WizardState;
@@ -1134,4 +1297,4 @@ declare function createOnboardingFlow(opts: CreateOnboardingFlowOptions): Onboar
 
 declare const version = "0.0.0";
 
-export { type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type ApiError, type BackendDTO, type ChatDoneEvent, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type LoginResponseDTO, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type SessionEndEvent, type SessionStartEvent, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };
+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 };

package/dist/index.d.ts

@@ -61,6 +61,115 @@ interface ErrorEvent {
 }
 type WireEvent = SessionStartEvent | SessionEndEvent | ChatTokenEvent | ChatToolCallEvent | ChatDoneEvent | PtyOutputEvent | PtyResizeEvent | PtyExitEvent | ErrorEvent;
 
+type UrlPrompt = {
+    type: 'url_prompt';
+    prompt_id: string;
+    url: string;
+    user_code?: string | null;
+};
+type TextPrompt = {
+    type: 'text_prompt';
+    prompt_id: string;
+    prompt: string;
+    hidden: boolean;
+};
+type StdoutChunk = {
+    type: 'stdout';
+    text: string;
+};
+type ProgressUpdate = {
+    type: 'progress';
+    label: string;
+    percent?: number | null;
+};
+type LoginComplete = {
+    type: 'complete';
+    account_id: string;
+    backend_status: string;
+};
+type LoginFailed = {
+    type: 'failed';
+    code: string;
+    message: string;
+};
+type LoginEvent = UrlPrompt | TextPrompt | StdoutChunk | ProgressUpdate | LoginComplete | LoginFailed;
+type PromptAnswer = {
+    prompt_id: string;
+    answer: string;
+};
+type LoginFlowKind = 'api_key' | 'oauth_device' | 'cli_browser';
+
+type InstallCheck = {
+    command: string[];
+    version_regex: string;
+};
+type InputSpec = {
+    name: string;
+    label: string;
+    kind: 'text' | 'secret' | 'email' | 'path';
+    placeholder?: string | null;
+};
+type LoginFlowSpec = {
+    kind: string;
+    display_name: string;
+    description: string;
+    requires_inputs: InputSpec[];
+};
+type PlanOption = {
+    id: string;
+    label: string;
+    description: string;
+};
+type BackendMetadata = {
+    kind: string;
+    display_name: string;
+    icon_url: string | null;
+    install_check: InstallCheck;
+    login_flows: LoginFlowSpec[];
+    plan_options: PlanOption[] | null;
+    config_schema: Record<string, unknown>;
+    supports_multi_account: boolean;
+    isolation_env_var: string | null;
+};
+
+/**
+ * Types for backend CLI install + CLIProxyAPI install/login flows.
+ *
+ * Mirror of Python models in `ai_accounts.core.cli_install` /
+ * `ai_accounts.core.cliproxy_manager` and the Litestar route responses.
+ */
+type InstallResult = {
+    kind: string;
+    success: boolean;
+    display: string;
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+    binary_path: string | null;
+};
+type CliproxyStatus = {
+    installed: boolean;
+    version: string | null;
+    binary_path: string | null;
+};
+type CliproxyInstallResult = {
+    success: boolean;
+    display: string;
+    stdout: string;
+    stderr: string;
+    binary_path: string | null;
+};
+type CliproxyLoginBeginResponse = {
+    status: 'started' | 'imported' | 'skipped' | 'error';
+    message: string;
+    oauth_url?: string | null;
+    device_code?: string | null;
+};
+type CliproxyCallbackForwardResponse = {
+    status: 'completed' | 'error';
+    message: string;
+};
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -1074,6 +1183,15 @@ declare class AiAccountsClient {
     loginBackend(id: string, flowKind: string, inputs: Record<string, string>): Promise<LoginResponseDTO>;
     pollBackendLogin(id: string, handle: string): Promise<LoginResponseDTO>;
     validateBackend(id: string): Promise<BackendDTO>;
+    beginLogin(accountId: string, flowKind: LoginFlowKind, inputs: Record<string, string>): Promise<{
+        session_id: string;
+    }>;
+    respondLogin(accountId: string, sessionId: string, promptId: string, answer: string): Promise<void>;
+    cancelLogin(accountId: string, sessionId: string): Promise<void>;
+    streamLogin(accountId: string, sessionId: string): AsyncIterable<LoginEvent>;
+    getBackendMetadata(): Promise<{
+        items: BackendMetadata[];
+    }>;
     startOnboarding(): Promise<OnboardingStateDTO>;
     getOnboarding(id: string): Promise<OnboardingStateDTO>;
     detectForOnboarding(id: string): Promise<DetectResultsDTO>;
@@ -1081,10 +1199,55 @@ declare class AiAccountsClient {
     beginOnboardingLogin(id: string, flowKind: string, inputs: Record<string, string>): Promise<LoginResponseDTO>;
     pollOnboardingLogin(id: string, handle: string): Promise<LoginResponseDTO>;
     finalizeOnboarding(id: string): Promise<OnboardingStateDTO>;
+    installBackendCli(kind: string): Promise<InstallResult>;
+    cliproxyStatus(): Promise<CliproxyStatus>;
+    cliproxyInstall(): Promise<CliproxyInstallResult>;
+    cliproxyLoginBegin(backendKind: string, configDir?: string): Promise<CliproxyLoginBeginResponse>;
+    cliproxyCallbackForward(callbackUrl: string): Promise<CliproxyCallbackForwardResponse>;
     private postAction;
     private onboardingAction;
 }
 
+type AiAccountsEvent = {
+    type: 'wizard.opened';
+    backendKind: string;
+} | {
+    type: 'wizard.step';
+    backendKind: string;
+    step: string;
+} | {
+    type: 'wizard.account.created';
+    backendKind: string;
+    accountId: string;
+} | {
+    type: 'wizard.closed';
+    backendKind: string;
+    reason: 'done' | 'skip' | 'cancel';
+} | {
+    type: 'login.started';
+    sessionId: string;
+    backendKind: string;
+    flow: string;
+} | {
+    type: 'login.prompt';
+    sessionId: string;
+    promptKind: 'url' | 'text';
+} | {
+    type: 'login.completed';
+    sessionId: string;
+    accountId: string;
+} | {
+    type: 'login.failed';
+    sessionId: string;
+    code: string;
+    message: string;
+} | {
+    type: 'internal.handler_error';
+    error: string;
+    original: AiAccountsEvent;
+};
+type AiAccountsEventHandler = (event: AiAccountsEvent) => void;
+
 type WizardState = 'idle' | 'picking_kind' | 'detecting' | 'entering_credential' | 'validating' | 'done' | 'error';
 interface AccountWizard {
     readonly state: WizardState;
@@ -1134,4 +1297,4 @@ declare function createOnboardingFlow(opts: CreateOnboardingFlowOptions): Onboar
 
 declare const version = "0.0.0";
 
-export { type AccountWizard, type paths as AiAccountsApiPaths, AiAccountsClient, type ApiError, type BackendDTO, type ChatDoneEvent, type ChatTokenEvent, type ChatToolCallEvent, type ClientOptions, type CreateAccountWizardOptions, type CreateOnboardingFlowOptions, type DetectResultDTO, type DetectResultsDTO, type ErrorEvent, type LoginResponseDTO, type OAuthDeviceLoginDTO, type OnboardingFlowMachine, type OnboardingMachineState, type OnboardingStateDTO, type PtyExitEvent, type PtyOutputEvent, type PtyResizeEvent, type SessionEndEvent, type SessionStartEvent, WIRE_PROTOCOL_VERSION, type WireEvent, type WizardState, createAccountWizard, createOnboardingFlow, version };
+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 };

package/dist/index.js

@@ -1,6 +1,36 @@
 // src/protocol/wire.ts
 var WIRE_PROTOCOL_VERSION = 1;
 
+// src/client/login-stream.ts
+async function* parseSseLoginEvents(response) {
+  if (!response.body) return;
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      while (true) {
+        const sep = buffer.indexOf("\n\n");
+        if (sep === -1) break;
+        const frame = buffer.slice(0, sep);
+        buffer = buffer.slice(sep + 2);
+        const dataLine = frame.split("\n").find((l) => l.startsWith("data: "));
+        if (!dataLine) continue;
+        const payload = dataLine.slice(6);
+        try {
+          yield JSON.parse(payload);
+        } catch {
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 // src/client/index.ts
 async function toError(r) {
   let code = "http_error";
@@ -25,7 +55,11 @@ var AiAccountsClient = class {
   constructor(opts) {
     this.baseUrl = opts.baseUrl.replace(/\/$/, "");
     this.token = opts.token;
-    this._fetch = opts.fetch ?? fetch;
+    if (opts.fetch) {
+      this._fetch = opts.fetch;
+    } else {
+      this._fetch = (input, init) => fetch(input, init);
+    }
   }
   headers() {
     const h = { "content-type": "application/json" };
@@ -96,6 +130,55 @@ var AiAccountsClient = class {
   async validateBackend(id) {
     return this.postAction(id, "validate");
   }
+  async beginLogin(accountId, flowKind, inputs) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/begin`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ flow_kind: flowKind, inputs })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async respondLogin(accountId, sessionId, promptId, answer) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/respond`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ session_id: sessionId, prompt_id: promptId, answer })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+  }
+  async cancelLogin(accountId, sessionId) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/cancel`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ session_id: sessionId })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+  }
+  async *streamLogin(accountId, sessionId) {
+    const url = `${this.baseUrl}/api/v1/backends/${encodeURIComponent(accountId)}/login/stream?session_id=${encodeURIComponent(sessionId)}`;
+    const headers = { Accept: "text/event-stream" };
+    if (this.token) headers["authorization"] = `Bearer ${this.token}`;
+    const r = await this._fetch(url, { method: "GET", headers });
+    if (!r.ok) throw await toError(r);
+    yield* parseSseLoginEvents(r);
+  }
+  async getBackendMetadata() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/backends/_meta`, {
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
   async startOnboarding() {
     const r = await this._fetch(`${this.baseUrl}/api/v1/onboarding`, {
       method: "POST",
@@ -133,6 +216,56 @@ var AiAccountsClient = class {
   async finalizeOnboarding(id) {
     return this.onboardingAction(id, "finalize");
   }
+  // --- Backend CLI install ---
+  async installBackendCli(kind) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/backends/${encodeURIComponent(kind)}/install`,
+      {
+        method: "POST",
+        headers: this.headers()
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  // --- CLIProxyAPI ---
+  async cliproxyStatus() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/status`, {
+      method: "GET",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyInstall() {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/install`, {
+      method: "POST",
+      headers: this.headers()
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyLoginBegin(backendKind, configDir) {
+    const r = await this._fetch(`${this.baseUrl}/api/v1/cliproxy/login/begin`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({ backend_kind: backendKind, config_dir: configDir ?? null })
+    });
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
+  async cliproxyCallbackForward(callbackUrl) {
+    const r = await this._fetch(
+      `${this.baseUrl}/api/v1/cliproxy/login/callback-forward`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify({ callback_url: callbackUrl })
+      }
+    );
+    if (!r.ok) throw await toError(r);
+    return await r.json();
+  }
   async postAction(id, action, body) {
     const r = await this._fetch(
       `${this.baseUrl}/api/v1/backends/${encodeURIComponent(id)}/${action}`,

package/package.json

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