@smoothcodes/agent-client 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,38 +1,42 @@
-# @smoothcodes/agent-client
-
-## 0.2.2
-
-- Só documentação: o CHANGELOG da 0.2.1 foi publicado com marcas de conflito de merge; o código é o mesmo da 0.2.1.
-
-## 0.2.1
-
-- Sem mudança de API: o mesmo número da `@smoothcodes/agent-server` 0.2.1. Ganha o teste de cobertura: todo grupo do cliente REST gerado tem que estar exposto na casca, com todos os métodos.
-
-## 0.2.0
-
-Desde a 0.1.0 (0.1.1/0.1.2 só republicaram a 0.1.0, presa no stage do npm; a 0.1.3 só trocou a base padrão).
-
-**Migrar da 0.1:** nenhum método, classe ou tipo exportado foi renomeado ou removido (conferido contra a 0.1.0). Só mudam tipos de retorno/campos:
-
-| Onde | 0.1 | 0.2 | O que fazer |
-|---|---|---|---|
-| `chats.delete()` | `Deleted` | `ChatDeleted` (`+ cleanup`) | nada, se só lia `id`/`deleted` |
-| `providers.myProvidersList().data[]` | `ProviderStatus` | `MyProviderStatus` | trocar a anotação de tipo, se houver |
-| `Agent.provider`, `AgentPublic.provider` | obrigatório | opcional | tratar `undefined` (agente sem motor → `providers[]`) |
-| `err.body` dos erros HTTP (`BadRequestError`, `ForbiddenError`…) | `unknown` | `Error_` | os casts passam a ser desnecessários |
-| `DEFAULT_BASE_URL` | `api.smoothagent.dev` | `smoothagent-v3-api.uaibuilder.workers.dev` | nada (quem passa `baseUrl` não muda) |
-
-**Quebra (tipos):**
-- `chats.delete()` devolve `ChatDeleted` (`{ id, deleted, cleanup: "pending" | "done" }`) em vez de `Deleted`.
-- `providers.myProvidersList()`: `data` agora é `MyProviderStatus[]` (`connected`, `via`, `status`, `models`, `connect`, `needed`, `expiresAt`) em vez de `ProviderStatus[]`.
-- `Agent.provider` / `AgentPublic.provider` ficaram opcionais: agente SEM motor; as opções vêm em `providers: AgentProviderOption[]` (`provider`, `models`, `capabilities`, `ready`).
-
-**Novo:**
-- Erros HTTP tipados: `BadRequestError`, `UnauthorizedError`, `ForbiddenError`, `ConflictError`, `TooManyRequestsError`, `InternalServerError` passam a ter `body: Error_` (`{ error: ErrorBody }`) em vez de `unknown` (os outros, `NotFoundError` incluso, já eram `Error_` na 0.1.0). Todos os erros HTTP agora têm `body: Error_`.
-- `agents`: `queue.defaultMode` ausente na criação = `queue` (era `steer`).
-- `chats.create({ provider })`: escolhe o motor do chat quando o agente não tem motor (no agente com motor, só o dele).
-- `chats.switchAgent({ provider?, model?: string | null, effort?: string | null })`: `null` = voltar ao padrão do agente, explícito; ausente = fica o de agora.
-- `EventsInboxState` ganha `wake_failed`; `EventsFailure.details.provider` documenta qual credencial falta/venceu.
-- A base padrão (`DEFAULT_BASE_URL`, `https://smoothagent-v3-api.uaibuilder.workers.dev`, consertada na 0.1.3; antes era `api.smoothagent.dev`, que não existe) agora sai do `servers` do contrato.
-
-Camada ao vivo (`watch`, `events`, `prompt`): sem mudança de API desde a 0.1.0.
+# @smoothcodes/agent-client
+
+## 0.2.3
+
+- `files.upload` agora envia o arquivo: o tipo virou `file: Uploadable` (obrigatório; `Blob`, `File`, `Buffer`/`Uint8Array`, `ReadableStream`, `{ data, filename, contentType }` ou, no Node, `{ path }`) e a parte `file` vai no multipart. Até a 0.2.2 o campo era `file?: unknown` e só array/Set era anexado, então `files.upload({ file: blob })` saía sem o arquivo.
+
+## 0.2.2
+
+- Só documentação: o CHANGELOG da 0.2.1 foi publicado com marcas de conflito de merge; o código é o mesmo da 0.2.1.
+
+## 0.2.1
+
+- Sem mudança de API: o mesmo número da `@smoothcodes/agent-server` 0.2.1. Ganha o teste de cobertura: todo grupo do cliente REST gerado tem que estar exposto na casca, com todos os métodos.
+
+## 0.2.0
+
+Desde a 0.1.0 (0.1.1/0.1.2 só republicaram a 0.1.0, presa no stage do npm; a 0.1.3 só trocou a base padrão).
+
+**Migrar da 0.1:** nenhum método, classe ou tipo exportado foi renomeado ou removido (conferido contra a 0.1.0). Só mudam tipos de retorno/campos:
+
+| Onde | 0.1 | 0.2 | O que fazer |
+|---|---|---|---|
+| `chats.delete()` | `Deleted` | `ChatDeleted` (`+ cleanup`) | nada, se só lia `id`/`deleted` |
+| `providers.myProvidersList().data[]` | `ProviderStatus` | `MyProviderStatus` | trocar a anotação de tipo, se houver |
+| `Agent.provider`, `AgentPublic.provider` | obrigatório | opcional | tratar `undefined` (agente sem motor → `providers[]`) |
+| `err.body` dos erros HTTP (`BadRequestError`, `ForbiddenError`…) | `unknown` | `Error_` | os casts passam a ser desnecessários |
+| `DEFAULT_BASE_URL` | `api.smoothagent.dev` | `smoothagent-v3-api.uaibuilder.workers.dev` | nada (quem passa `baseUrl` não muda) |
+
+**Quebra (tipos):**
+- `chats.delete()` devolve `ChatDeleted` (`{ id, deleted, cleanup: "pending" | "done" }`) em vez de `Deleted`.
+- `providers.myProvidersList()`: `data` agora é `MyProviderStatus[]` (`connected`, `via`, `status`, `models`, `connect`, `needed`, `expiresAt`) em vez de `ProviderStatus[]`.
+- `Agent.provider` / `AgentPublic.provider` ficaram opcionais: agente SEM motor; as opções vêm em `providers: AgentProviderOption[]` (`provider`, `models`, `capabilities`, `ready`).
+
+**Novo:**
+- Erros HTTP tipados: `BadRequestError`, `UnauthorizedError`, `ForbiddenError`, `ConflictError`, `TooManyRequestsError`, `InternalServerError` passam a ter `body: Error_` (`{ error: ErrorBody }`) em vez de `unknown` (os outros, `NotFoundError` incluso, já eram `Error_` na 0.1.0). Todos os erros HTTP agora têm `body: Error_`.
+- `agents`: `queue.defaultMode` ausente na criação = `queue` (era `steer`).
+- `chats.create({ provider })`: escolhe o motor do chat quando o agente não tem motor (no agente com motor, só o dele).
+- `chats.switchAgent({ provider?, model?: string | null, effort?: string | null })`: `null` = voltar ao padrão do agente, explícito; ausente = fica o de agora.
+- `EventsInboxState` ganha `wake_failed`; `EventsFailure.details.provider` documenta qual credencial falta/venceu.
+- A base padrão (`DEFAULT_BASE_URL`, `https://smoothagent-v3-api.uaibuilder.workers.dev`, consertada na 0.1.3; antes era `api.smoothagent.dev`, que não existe) agora sai do `servers` do contrato.
+
+Camada ao vivo (`watch`, `events`, `prompt`): sem mudança de API desde a 0.1.0.

package/dist/{chunk-E4ZFXITU.js → chunk-ERJ5SQDU.js}

@@ -8436,18 +8436,19 @@ var FilesClient = class {
    * @throws {@link SmoothAgentApi.ServiceUnavailableError}
    * @throws {@link errors.SmoothAgentApiError}
    * @throws {@link errors.SmoothAgentApiTimeoutError}
+   *
+   * @example
+   *     import { createReadStream } from "fs";
+   *     await client.files.upload({
+   *         file: fs.createReadStream("/path/to/your/file")
+   *     })
    */
   upload(request, requestOptions) {
     return HttpResponsePromise.fromPromise(this.__upload(request, requestOptions));
   }
   async __upload(request, requestOptions) {
     const _body = await newFormData();
-    if (request.file != null) {
-      if (Array.isArray(request.file) || request.file instanceof Set)
-        for (const _item of request.file) {
-          _body.append("file", typeof _item === "string" ? _item : toJson(_item));
-        }
-    }
+    await _body.appendFile("file", request.file);
     const _maybeEncodedRequest = await _body.getRequest();
     const _authRequest = await this._options.authProvider.getAuthRequest();
     const _headers = mergeHeaders(
@@ -9653,7 +9654,8 @@ var MachinesClient = class {
   }
   /**
    * Gera o código de pareamento de um computador. Chave (pra um `userId`) OU o próprio usuário
-   * na interface do cliente (o login é do cliente, nunca nosso).
+   * na interface do cliente (o login é do cliente, nunca nosso). Por CHAVE (pura ou agindo como o usuário) o
+   * pareamento emite token pro usuário: exige `tokens:write` e o recorte de agentes da chave (`agents_restricted`).
    *
    * @param {SmoothAgentApi.MachinesPairRequest} request
    * @param {MachinesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -14848,4 +14850,4 @@ export {
   DEFAULT_BASE_URL,
   SmoothAgent
 };
-//# sourceMappingURL=chunk-E4ZFXITU.js.map
+//# sourceMappingURL=chunk-ERJ5SQDU.js.map