@smoothcodes/agent-client 0.1.2 → 0.2.0

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   SmoothAgentApiTimeoutError,
   apiErrorBody,
   sortProviders
-} from "./chunk-WQFHS5IU.js";
+} from "./chunk-E4ZFXITU.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_BASE_URL,

package/dist/testing.js

@@ -1,6 +1,6 @@
 import {
   SmoothAgent
-} from "./chunk-WQFHS5IU.js";
+} from "./chunk-E4ZFXITU.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/testing.ts

package/dist/types/sdk/generated/ts-client/api/errors/BadRequestError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class BadRequestError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/errors/ConflictError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class ConflictError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/errors/ForbiddenError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class ForbiddenError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/errors/InternalServerError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class InternalServerError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/errors/TooManyRequestsError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class TooManyRequestsError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/errors/UnauthorizedError.d.ts

@@ -1,5 +1,7 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
 export declare class UnauthorizedError extends errors.SmoothAgentApiError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
 }

package/dist/types/sdk/generated/ts-client/api/resources/chats/client/Client.d.ts

@@ -91,7 +91,8 @@ export declare class ChatsClient {
     get(request: SmoothAgentApi.ChatsGetRequest, requestOptions?: ChatsClient.RequestOptions): core.HttpResponsePromise<SmoothAgentApi.Chat>;
     private __get;
     /**
-     * Apaga o chat, o log e a box própria (a instância só é destruída aqui).
+     * Apaga o chat, o log e a box própria (a instância só é destruída aqui).O chat some NA HORA (404 em toda rota, inclusive o `/live`; o socket aberto recebe `bye`). A limpeza da box própria
+     * (Detona) segue em segundo plano — `cleanup: pending` — e um cron repete até destruir (com teto e alerta).
      *
      * @param {SmoothAgentApi.ChatsDeleteRequest} request
      * @param {ChatsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -117,7 +118,7 @@ export declare class ChatsClient {
      *         id: "id"
      *     })
      */
-    delete(request: SmoothAgentApi.ChatsDeleteRequest, requestOptions?: ChatsClient.RequestOptions): core.HttpResponsePromise<SmoothAgentApi.Deleted>;
+    delete(request: SmoothAgentApi.ChatsDeleteRequest, requestOptions?: ChatsClient.RequestOptions): core.HttpResponsePromise<SmoothAgentApi.ChatDeleted>;
     private __delete;
     /**
      * @param {SmoothAgentApi.ChatsUpdateRequest} request

package/dist/types/sdk/generated/ts-client/api/resources/chats/client/requests/CreateChat.d.ts

@@ -19,6 +19,12 @@ export interface CreateChat {
     machineId?: string;
     /** Só chave sem `as`: de quem é o chat. */
     userId?: string;
+    /**
+     * O motor do chat (fixo nele). Agente COM motor: ausente ou o dele (outro = `invalid_request {reason: provider_fixed}`).
+     * Agente SEM motor: um provedor CONECTADO do usuário; ausente = o último que ele usou com este agente, senão o 1º
+     * conectado (claude, codex); nenhum conectado = `provider_not_connected {needs}`.
+     */
+    provider?: SmoothAgentApi.EventsProvider;
     /** Modelo deste chat, dentro do que o agente permite E está conectado. */
     model?: string;
     effort?: string;

package/dist/types/sdk/generated/ts-client/api/resources/chats/client/requests/SwitchAgent.d.ts

@@ -1,3 +1,4 @@
+import type * as SmoothAgentApi from "../../../../index.js";
 /**
  * @example
  *     {
@@ -11,7 +12,24 @@ export interface SwitchAgent {
     "Idempotency-Key"?: string;
     /** O agente novo (pode ser o mesmo, trocando só o modelo). Exige grant/allAgents. */
     agentId: string;
-    /** Ausente = padrão do agente novo. Tem que estar em `selection.options`. */
-    model?: string;
-    effort?: string;
+    /**
+     * Só pra um agente SEM motor: o provedor (conectado) no agente novo — a regra do create. No MESMO agente o provedor é o
+     * do chat: pedir outro = `conflict {reason: provider_switch_unavailable}` (a troca de provedor no meio do chat vem com
+     * o próximo runtime — DESIGN §14).
+     */
+    provider?: SmoothAgentApi.EventsProvider;
+    /**
+     * Tem que estar em `selection.options`. AUSENTE: no MESMO agente (`agentId` = o atual) fica o modelo de AGORA (trocar
+     * só o esforço não reseta o modelo); noutro agente, o padrão do agente novo. O herdado que não vale mais (saiu da
+     * lista) cai pro padrão; o que o pedido traz é validado (fora das opções = `invalid_request`). `null` = VOLTAR AO
+     * PADRÃO do agente, explícito.
+     */
+    model?: string | null;
+    /**
+     * AUSENTE: no MESMO agente fica o esforço de AGORA, se o modelo resultante o tiver (senão cai); noutro agente, o
+     * padrão do agente novo. `null` = VOLTAR AO PADRÃO, explícito: o esforço do agente se o modelo resultante for o
+     * dele, senão nenhum (o padrão do próprio modelo). O mesmo vale pro frame `switch` do socket (a RPC `resolveSwitch`
+     * usa a mesma regra).
+     */
+    effort?: string | null;
 }

package/dist/types/sdk/generated/ts-client/api/resources/providers/types/MyProvidersListResponse.d.ts

@@ -1,4 +1,4 @@
 import type * as SmoothAgentApi from "../../../index.js";
 export interface MyProvidersListResponse {
-    data: SmoothAgentApi.ProviderStatus[];
+    data: SmoothAgentApi.MyProviderStatus[];
 }

package/dist/types/sdk/generated/ts-client/api/types/Agent.d.ts

@@ -3,7 +3,12 @@ export interface Agent {
     id: string;
     workspaceId: string;
     name: string;
-    provider: SmoothAgentApi.EventsProvider;
+    /**
+     * O motor. Ausente = agente SEM motor (DESIGN §14, 2026-11-01): roda com a credencial DO USUÁRIO e o chat escolhe
+     * entre os provedores que ele tem conectados (fixo no chat). Sem motor não aceita `credential`
+     * (`{reason: connection_requires_provider}`) nem `model`/`allowedModels`/`providerOptions` (`{reason: provider_required}`).
+     */
+    provider?: SmoothAgentApi.EventsProvider | undefined;
     /** Id do modelo do provedor; ausente = padrão da conta/assinatura. `id#esforço` vira o esforço. */
     model?: string | undefined;
     /** Recorte do que o usuário pode escolher por chat. Ausente = só `model`. */
@@ -14,12 +19,18 @@ export interface Agent {
     box?: SmoothAgentApi.BoxProfile | undefined;
     placement?: SmoothAgentApi.Placement | undefined;
     /**
-     * O que `mode: 'auto'` faz com o agente trabalhando. Ausente na criação = `steer`
-     * (a experiência do terminal), GRAVADO na config — a leitura sempre traz o valor. O mesmo padrão em
+     * O que `mode: 'auto'` faz com o agente trabalhando. Ausente na criação = `queue` (decisão do dono 2026-11-01: a
+     * FILA é o padrão; `steer` — a experiência do terminal — é escolha explícita; fila vazia começa na hora), GRAVADO na config — a leitura sempre traz o valor. O mesmo padrão em
      * todas as pontas (control, realtime, box).
      */
     queue?: Agent.Queue | undefined;
     hooks?: SmoothAgentApi.AgentHooks | undefined;
+    /**
+     * A credencial do WORKSPACE (uma conexão) que roda o agente; vence a do usuário (§9.7). ATENÇÃO: pôr `credential` num
+     * agente que já tem chats faz TODOS eles passarem a rodar com a conexão no próximo turno (e tirar faz voltarem pra a
+     * credencial de cada usuário) — sem aviso aos usuários. Exige `provider` (agente sem motor = 400
+     * `connection_requires_provider`).
+     */
     credential?: SmoothAgentApi.AgentCredential | undefined;
     /** Opções nativas do provedor repassadas sem interpretar (permissões, sandbox…). */
     providerOptions?: Record<string, unknown> | undefined;
@@ -47,8 +58,8 @@ export interface Agent {
 }
 export declare namespace Agent {
     /**
-     * O que `mode: 'auto'` faz com o agente trabalhando. Ausente na criação = `steer`
-     * (a experiência do terminal), GRAVADO na config — a leitura sempre traz o valor. O mesmo padrão em
+     * O que `mode: 'auto'` faz com o agente trabalhando. Ausente na criação = `queue` (decisão do dono 2026-11-01: a
+     * FILA é o padrão; `steer` — a experiência do terminal — é escolha explícita; fila vazia começa na hora), GRAVADO na config — a leitura sempre traz o valor. O mesmo padrão em
      * todas as pontas (control, realtime, box).
      */
     interface Queue {

package/dist/types/sdk/generated/ts-client/api/types/AgentProviderOption.d.ts

@@ -0,0 +1,11 @@
+import type * as SmoothAgentApi from "../index.js";
+/**
+ * Um provedor que o usuário pode usar num agente SEM motor (os que ele tem conectados).
+ */
+export interface AgentProviderOption {
+    provider: SmoothAgentApi.EventsProvider;
+    /** Os modelos que a credencial DELE libera nesse provedor. */
+    models: SmoothAgentApi.ModelInfo[];
+    capabilities: SmoothAgentApi.EventsCapabilities;
+    ready: boolean;
+}

package/dist/types/sdk/generated/ts-client/api/types/AgentPublic.d.ts

@@ -2,9 +2,14 @@ import type * as SmoothAgentApi from "../index.js";
 export interface AgentPublic {
     id: string;
     name: string;
-    provider: SmoothAgentApi.EventsProvider;
+    /** Ausente = agente SEM motor: as opções estão em `providers` (o chat escolhe uma no create). */
+    provider?: SmoothAgentApi.EventsProvider | undefined;
+    /** Agente com motor: os modelos dele. Sem motor: vazio (ver `providers[].models`). */
     models: SmoothAgentApi.ModelInfo[];
+    /** Agente sem motor: o que vale nos dois motores; o de cada um está em `providers[].capabilities`. */
     capabilities: SmoothAgentApi.EventsCapabilities;
+    /** Só agente SEM motor: os provedores que o usuário tem CONECTADOS (vazio = nenhum; `needs` diz o que conectar). */
+    providers?: SmoothAgentApi.AgentProviderOption[] | undefined;
     theme?: SmoothAgentApi.AgentTheme | undefined;
     /** O usuário consegue mandar mensagem agora? (`provider_not_connected` se não). */
     ready: boolean;

package/dist/types/sdk/generated/ts-client/api/types/ChatDeleted.d.ts

@@ -0,0 +1,15 @@
+/**
+ * O chat apagado: some na hora; `pending` = a limpeza da box ainda corre (sem esperar o Detona), `done` = já foi.
+ */
+export interface ChatDeleted {
+    id: string;
+    deleted: boolean;
+    cleanup: ChatDeleted.Cleanup;
+}
+export declare namespace ChatDeleted {
+    const Cleanup: {
+        readonly Pending: "pending";
+        readonly Done: "done";
+    };
+    type Cleanup = (typeof Cleanup)[keyof typeof Cleanup];
+}

package/dist/types/sdk/generated/ts-client/api/types/ChatSelection.d.ts

@@ -22,6 +22,8 @@ export declare namespace ChatSelection {
         /** O modelo que VAI RODAR, resolvido (chat > agente > padrão da credencial). Ausente só se o provedor não informou nenhum. */
         model?: string | undefined;
         modelName?: string | undefined;
+        /** O modelo concreto em que o `model` (alias da assinatura) resolve agora, segundo o CLI. Ausente = `model` já é concreto. */
+        resolvedModel?: string | undefined;
         /** Esforço separado do modelo (P1). */
         effort?: string | undefined;
         /** De onde vem a credencial que roda este chat; null = nenhuma conectada. */

package/dist/types/sdk/generated/ts-client/api/types/EventsFailure.d.ts

@@ -1,6 +1,6 @@
 import type * as SmoothAgentApi from "../index.js";
 /**
- * Uma falha pronta pra tela: código de erro, motivo fino e mensagem sem segredo.
+ * Uma falha pronta pra tela: código de erro, motivo fino e mensagem sem segredo. Credencial que falta ou venceu (provider_not_connected / provider_auth_expired): o provedor DELA vem em `details.provider`, que pode diferir do provedor do agente.
  */
 export interface EventsFailure {
     code: SmoothAgentApi.EventsErrorCode;
@@ -12,6 +12,6 @@ export interface EventsFailure {
     resetsAt?: SmoothAgentApi.EventsTimestamp | undefined;
     /** Status HTTP que o provedor devolveu. */
     httpStatus?: number | undefined;
-    /** Detalhes extras (sem segredo). */
+    /** Detalhes extras (sem segredo). Com `code` provider_not_connected ou provider_auth_expired, `details.provider` é o provedor da CREDENCIAL que falta ou venceu — pode ser diferente de `run.agent.provider` (ex.: um agente fake que roda com a credencial Claude do usuário): é ele que a tela manda conectar/reconectar. */
     details?: Record<string, unknown> | undefined;
 }

package/dist/types/sdk/generated/ts-client/api/types/EventsInboxState.d.ts

@@ -43,6 +43,7 @@ export declare namespace EventsInboxState {
             readonly NoCredit: "no_credit";
             readonly Auth: "auth";
             readonly Error: "error";
+            readonly WakeFailed: "wake_failed";
         };
         type Reason = (typeof Reason)[keyof typeof Reason];
     }

package/dist/types/sdk/generated/ts-client/api/types/ModelInfo.d.ts

@@ -1,6 +1,12 @@
 export interface ModelInfo {
+    /** O que vai no pedido (`model`): o id do provedor, ou o ALIAS que o CLI da assinatura aceita (`default`, `opus`…). */
     id: string;
     name: string;
     isDefault: boolean;
     efforts?: string[] | undefined;
+    /**
+     * O modelo concreto em que o alias resolve AGORA, como o próprio CLI diz (Claude: o `initialize`, ex.
+     * `default` → `claude-opus-5-5`). Ausente = o `id` já é o modelo concreto.
+     */
+    resolvedModel?: string | undefined;
 }

package/dist/types/sdk/generated/ts-client/api/types/MyProviderStatus.d.ts

@@ -0,0 +1,61 @@
+import type * as SmoothAgentApi from "../index.js";
+/**
+ * Um provedor na lista do usuário: o status + se algum agente que ele pode usar roda nele.
+ */
+export interface MyProviderStatus {
+    provider: SmoothAgentApi.ProviderKind;
+    connected: boolean;
+    /** `agent` = o agente já traz (o usuário não precisa conectar). */
+    via: MyProviderStatus.Via.Item[];
+    /** Só assinatura: quando o access token atual vence (o CLI renova sozinho — doutrina do token). */
+    expiresAt?: (SmoothAgentApi.Timestamp | null) | undefined;
+    /**
+     * Saúde pro dashboard. `ok`; `expiring` = o access token da assinatura venceu, a box renova sozinha no
+     * próximo uso (nada a fazer); `dead` = o provedor recusou a renovação e não há outra viva (reconectar);
+     * `disconnected` = nada conectado.
+     */
+    status: MyProviderStatus.Status;
+    /** Explicação curta pro usuário quando não é `ok`. */
+    message?: string | undefined;
+    /** Os modelos que ESTA credencial libera (extraídos do provedor, nunca catálogo nosso). */
+    models: SmoothAgentApi.ModelInfo[];
+    /** Como conectar o que falta. */
+    connect: MyProviderStatus.Connect.Item[];
+    /**
+     * `true` = algum agente que o usuário pode usar roda neste provedor (o app do cliente filtra por isso pra
+     * mostrar "só o configurado"); `false` = oferecido, mas nenhum agente dele precisa agora.
+     */
+    needed: boolean;
+}
+export declare namespace MyProviderStatus {
+    type Via = Via.Item[];
+    namespace Via {
+        const Item: {
+            readonly Subscription: "subscription";
+            readonly Key: "key";
+            readonly Agent: "agent";
+        };
+        type Item = (typeof Item)[keyof typeof Item];
+    }
+    /**
+     * Saúde pro dashboard. `ok`; `expiring` = o access token da assinatura venceu, a box renova sozinha no
+     * próximo uso (nada a fazer); `dead` = o provedor recusou a renovação e não há outra viva (reconectar);
+     * `disconnected` = nada conectado.
+     */
+    const Status: {
+        readonly Ok: "ok";
+        readonly Expiring: "expiring";
+        readonly Dead: "dead";
+        readonly Disconnected: "disconnected";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+    type Connect = Connect.Item[];
+    namespace Connect {
+        const Item: {
+            readonly Oauth: "oauth";
+            readonly Device: "device";
+            readonly Key: "key";
+        };
+        type Item = (typeof Item)[keyof typeof Item];
+    }
+}

package/dist/types/sdk/generated/ts-client/api/types/index.d.ts

@@ -2,6 +2,7 @@ export * from "./Agent.js";
 export * from "./AgentCredential.js";
 export * from "./AgentHooks.js";
 export * from "./AgentLimits.js";
+export * from "./AgentProviderOption.js";
 export * from "./AgentPublic.js";
 export * from "./AgentTheme.js";
 export * from "./BoxFileContent.js";
@@ -10,6 +11,7 @@ export * from "./BoxFileList.js";
 export * from "./BoxProfile.js";
 export * from "./Chat.js";
 export * from "./ChatContext.js";
+export * from "./ChatDeleted.js";
 export * from "./ChatSelection.js";
 export * from "./ChatTask.js";
 export * from "./ChatTaskOutput.js";
@@ -124,6 +126,7 @@ export * from "./Machine.js";
 export * from "./McpServer.js";
 export * from "./Metadata.js";
 export * from "./ModelInfo.js";
+export * from "./MyProviderStatus.js";
 export * from "./OAuthFlow.js";
 export * from "./Pairing.js";
 export * from "./Placement.js";

package/dist/types/sdk/generated/ts-client/environments.d.ts

@@ -1,4 +1,4 @@
 export declare const SmoothAgentApiEnvironment: {
-    readonly Default: "https://api.smoothagent.dev/v3";
+    readonly Default: "https://smoothagent-v3-api.uaibuilder.workers.dev/v3";
 };
 export type SmoothAgentApiEnvironment = typeof SmoothAgentApiEnvironment.Default;

package/dist/types/sdk/ts/client/src/index.d.ts

@@ -24,7 +24,8 @@ export interface SmoothAgentOptions {
 export type ChatLive = LiveChat<ContractChatState, ContractItem> & {
     release(): void;
 };
-export declare const DEFAULT_BASE_URL = "https://api.smoothagent.dev";
+/** A base de produção = o `servers` do contrato (sem o `/v3`); white-label passa `baseUrl`. */
+export declare const DEFAULT_BASE_URL: string;
 type GeneratedChats = SmoothAgentApiClient['chats'];
 export interface ChatsLive {
     /** O estado pronto da tela (snapshot + eventos aplicados + fila + box + histórico paginado). */

package/dist/types/sdk/ts/core-live/src/client.d.ts

@@ -7,7 +7,7 @@ import { RunHandle } from './prompt.js';
 import type { HistoryPage as ControlHistoryPage } from '../../../generated/ts-client/api/types/HistoryPage.js';
 import { ChatListLive } from './feed.js';
 export interface LiveClientOptions<S, I> {
-    /** `https://api.smoothagent.dev` (white-label: só isto muda). */
+    /** a base da API, ex. `https://smoothagent-v3-api.uaibuilder.workers.dev` (white-label: só isto muda). */
     baseUrl: string;
     token?: string;
     getToken?: () => Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smoothcodes/agent-client",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "description": "SmoothAgent SDK do usuário (token do usuário): REST gerada do contrato + a camada ao vivo (watch, events, prompt, lista de chats). Roda no navegador e no Node.",
   "license": "UNLICENSED",
@@ -29,7 +29,8 @@
   "files": [
     "dist",
     "!dist/bytes-*.js.map",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "publishConfig": {