@smoothbuilder/smoothagent-agent-server 0.0.0-stage → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,65 @@
+# @smoothcodes/agent-server
+
+## 0.4.0
+
+- **Usuário guest** (docs/GUEST.md), só pela chave de API:
+  - `users.create({ id, kind: 'guest', expiresAt })` — `expiresAt` obrigatório, no futuro, no máximo 30 dias.
+  - `users.update({ userId, kind: 'user' })` promove o guest a usuário normal com o MESMO id (o prazo some).
+  - `users.update({ userId, expiresAt })` estende ou encurta o prazo (até 30 dias a partir de agora).
+  - `users.merge({ userId, into })` passa chats, acessos e boxes do guest pra um usuário existente; o guest some.
+    Guest já vencido = 410 `request_expired` (`reason: guest_expired`).
+- `User` ganha `kind: 'user' | 'guest'` e `expiresAt?` (só presente em guest). No vencimento o guest perde o acesso na
+  hora (401) e some com chats, boxes, tokens e credenciais; os agentes do workspace ficam.
+- Apagar usuário ou máquina (`machines.delete`) agora destrói a box dele no Detona (antes só marcava).
+- Exige o backend publicado em 2026-11-10 (API fa160ef2, realtime 11fd03d9).
+
+## 0.3.0
+
+- Métodos e exports anteriores preservados; contrato aditivo.
+- Metadata opcional no envio, autoria de agente, recibo de mensagem e views de mensagens/seleção.
+- O fallback HTTP mantém o messageId e metadata; o caminho legado permanece disponível.
+- As views novas exigem o backend integrado de novembro de 2026. A autenticação interna da box não muda neste pacote.
+
+## 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
+
+- **Conserto:** `sa.account` era `undefined` na 0.2.0 — a casca escrita à mão não expunha o grupo, embora a 0.2.0 anunciasse `account.update`. Agora `sa.account.update({ name })` funciona (na 0.2.0, contornar com `sa.api.account.update(…)`).
+- Teste de cobertura: todo grupo do cliente REST gerado tem que estar exposto na casca, com todos os métodos (vermelho se o contrato ganhar grupo e a casca não).
+
+## 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[]` em vez de `ProviderStatus[]`.
+- `Agent.provider` / `AgentPublic.provider` opcionais (agente SEM motor; opções em `providers: AgentProviderOption[]`).
+
+**Novo:**
+- `ApiKey.createdBy: { memberId, email } | null` (quem criou a chave pelo dashboard).
+- `account.update({ name })`: renomear a organização (chave de conta; workspace/restrita = 403 `only_account_key`) — **na 0.2.0 publicada só por `sa.api.account`; `sa.account` chegou na 0.2.1**.
+- 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`).
+- `agents.create/update`: `provider` opcional (`null` no merge-patch = tira o motor do agente).
+- `chats.create({ provider })` e `chats.switchAgent({ provider?, model?: string | null, effort?: string | null })` — `null` = voltar ao padrão.
+- `EventsInboxState` ganha `wake_failed`.
+- 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.
+
+`@smoothcodes/agent-server/dashboard` (só pro Studio, fora da API pública): `SmoothAgentDashboardClient` ganha convites (`invitesList/Create/Revoke`, `dashboardAuthLookupInvite/AcceptInvite`), membros (`membersList/Update/Remove/Leave`; `membersRemove` devolve `createdKeys[]`), `dashboardAuthCreateAccount`, `dashboardAuthSwitchAccount` e `NotFoundError` tipado.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @smoothcodes/agent-server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A SDK de **quem integra** a SmoothAgent: a chave de conta ou de workspace num backend, num bot ou no dashboard
+(navegador). Roda no Node ≥ 20 e no navegador, sem dependência.
+
+- **REST** gerada do contrato (`contract/api`, audiência `server`): agentes, usuários e tokens, workspaces, chaves,
+  conexões de provedor, máquinas, segredos, chats de todos os usuários, runs, observabilidade, billing, webhooks.
+- **Idempotency-Key** em todo pedido (a mesma nas tentativas do gerador) e `chats.send` que reenvia sozinho em queda
+  de rede/5xx com o mesmo `clientMessageId`.
+- **Ao vivo** com a chave: `await sa.live()` → `watch` / `events` / `prompt`. O núcleo (wasm) só carrega aqui.
+
+```ts
+import { SmoothAgentServer } from '@smoothcodes/agent-server'
+
+const sa = new SmoothAgentServer({ apiKey: process.env.SMOOTHAGENT_KEY!, workspace: 'ws_…' })
+
+const agent = await sa.agents.create({ name: 'suporte', provider: 'claude' })
+await sa.users.create({ id: 'u_123', allAgents: true })
+const { token } = await sa.users.userTokensCreate({ userId: 'u_123', device: 'web' })   // vai pro navegador do usuário
+
+const live = await sa.live()
+const r = await live.prompt(chatId, 'oi').result
+```
+
+- `sa.workspace(id)`: a mesma API presa a outro workspace (chave de conta).
+- `@smoothcodes/agent-server/dashboard`: o login do dev no dashboard (`/v3/auth/*`) — uso interno do Studio.
+
+## Desenvolver
+
+```bash
+npm ci
+npm test
+npm run build
+npm run pack:next   # tarball em sdk/.packs
+node e2e/prod.mjs   # prova contra o v3 de prod (recursos v3-t-sdk-*, apagados no fim)
+```

package/dist/chunk-PZ5AY32C.js

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-PZ5AY32C.js.map

package/dist/chunk-PZ5AY32C.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/chunk-T5FJM7CV.js

@@ -0,0 +1,82 @@
+// ../core-live/src/deps.ts
+var systemClock = {
+  now: () => Date.now(),
+  setTimeout: (fn, ms) => setTimeout(fn, ms),
+  clearTimeout: (h) => clearTimeout(h)
+};
+var serverEnv = {
+  online: () => true,
+  visible: () => true,
+  onWake: () => () => {
+  }
+};
+
+// ../../../contract/events/ts/src/gen/known.ts
+var KNOWN_ERROR_CODES = ["unauthorized", "forbidden", "not_found", "invalid_request", "provider_not_connected", "provider_auth_expired", "provider_error", "usage_limit_reached", "plan_limit", "rate_limited", "box_unavailable", "conflict", "machine_offline", "request_expired", "no_run", "queue_full", "internal"];
+
+// ../core-live/src/ids.ts
+function newMessageId(nowMs = Date.now()) {
+  return "msg_" + uuidv7(nowMs);
+}
+function uuidv7(nowMs = Date.now()) {
+  const bytes = new Uint8Array(16);
+  globalThis.crypto.getRandomValues(bytes);
+  let ts = BigInt(Math.floor(nowMs));
+  for (let i = 5; i >= 0; i--) {
+    bytes[i] = Number(ts & 0xffn);
+    ts >>= 8n;
+  }
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
+// ../core-live/src/rest.ts
+function idempotencyHeaders() {
+  return { "Idempotency-Key": () => "idk_" + uuidv7() };
+}
+var SEND_ATTEMPTS = 6;
+function transient(e, errors) {
+  if (e instanceof errors.timeout) return true;
+  if (!(e instanceof errors.api)) return false;
+  const { statusCode, body } = e;
+  const retryable = body?.error?.retryable;
+  if (retryable === false) return false;
+  if (statusCode === 409) return retryable === true;
+  return statusCode === void 0 || statusCode === 408 || statusCode === 429 || statusCode >= 500;
+}
+function apiErrorBody(e) {
+  const err = e?.body?.error;
+  if (!err || typeof err !== "object" || typeof err.code !== "string") return void 0;
+  return { ...err, code: KNOWN_ERROR_CODES.includes(err.code) ? err.code : "internal", message: String(err.message ?? ""), retryable: err.retryable === true };
+}
+function sendBody(req) {
+  const clientMessageId = req.clientMessageId ?? newMessageId();
+  return { ...req, clientMessageId, "Idempotency-Key": req["Idempotency-Key"] ?? clientMessageId };
+}
+async function untilStored(call, o) {
+  const attempts = o.attempts ?? SEND_ATTEMPTS;
+  for (let n = 0; ; n++) {
+    try {
+      return await call();
+    } catch (e) {
+      if (n + 1 >= attempts || !o.isTransient(e) || o.abortSignal?.aborted) throw e;
+      await new Promise((res) => o.clock.setTimeout(res, 1e3 * 2 ** n * (0.75 + 0.5 * Math.random())));
+    }
+  }
+}
+
+export {
+  systemClock,
+  serverEnv,
+  newMessageId,
+  uuidv7,
+  KNOWN_ERROR_CODES,
+  idempotencyHeaders,
+  transient,
+  apiErrorBody,
+  sendBody,
+  untilStored
+};
+//# sourceMappingURL=chunk-T5FJM7CV.js.map

package/dist/chunk-T5FJM7CV.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../core-live/src/deps.ts", "../../../../contract/events/ts/src/gen/known.ts", "../../core-live/src/ids.ts", "../../core-live/src/rest.ts"],
+  "sourcesContent": ["// O que a camada ao vivo recebe de fora (proposta sdk \u00A75). Nada aqui conhece o c\u00F3digo gerado:\n// trocar de gerador = reescrever a cola que monta estas depend\u00EAncias.\nimport type { ChatSnapshot, Envelope } from './types'\n\n/** O m\u00EDnimo de um WebSocket (browser, React Native, Node \u2265 22, Bun, Deno ou um falso de teste). */\nexport interface SocketLike {\n  readonly readyState: number // 0 CONNECTING \u00B7 1 OPEN \u00B7 2 CLOSING \u00B7 3 CLOSED\n  send(data: string): void\n  close(code?: number, reason?: string): void\n  onopen: ((ev?: unknown) => void) | null\n  onmessage: ((ev: { data: unknown }) => void) | null\n  onclose: ((ev: { code: number; reason: string }) => void) | null\n  onerror: ((ev?: unknown) => void) | null\n}\n\nexport type OpenSocket = (url: string, protocols: string[]) => SocketLike\n\nexport interface Clock {\n  now(): number\n  setTimeout(fn: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\n\nexport interface LiveEnv {\n  /** false = sabemos que n\u00E3o h\u00E1 rede (navigator.onLine). */\n  online(): boolean\n  /** Primeiro plano? (visibilitychange / AppState). Muda o teto do backoff. */\n  visible(): boolean\n  /** Rede voltou, aba voltou pro primeiro plano, foco: acorda o retry na hora. Devolve o \"desligar\". */\n  onWake(cb: (why: 'online' | 'visible' | 'focus' | 'manual', awayMs?: number) => void): () => void\n}\n\nexport interface LiveDeps {\n  /** URL do conector (o WebSocket do ChatLog): `wss://\u2026/v3/chats/:id/live`. */\n  connectorUrl(chatId: string): string\n  openSocket: OpenSocket\n  /** Token do usu\u00E1rio (ou chave), j\u00E1 com a renova\u00E7\u00E3o single-flight (auth.ts). */\n  token(): Promise<string>\n  /** O servidor disse que o token venceu: a pr\u00F3xima `token()` tem que trazer um novo. */\n  invalidateToken?(): void\n  /** Peda\u00E7o do log por REST, quando n\u00E3o h\u00E1 socket que responda o `fetch`. */\n  eventsRange?(chatId: string, from: number, to: number): Promise<{ events: Envelope[]; range: { from: number; to: number } }>\n  /**\n   * O WebSocket n\u00E3o mostra o HTTP de um upgrade recusado (o navegador s\u00F3 d\u00E1 1006). Quando o conector nem\n   * chega a abrir, a SDK pergunta aqui (REST `GET /chats/{id}`) se \u00E9 falta de acesso, pra n\u00E3o religar pra sempre.\n   */\n  probeAccess?(chatId: string): Promise<'ok' | 'unauthorized' | 'forbidden'>\n  /** Snapshot por REST (resync sem socket). */\n  snapshot?(chatId: string): Promise<ChatSnapshot>\n  clock: Clock\n  env: LiveEnv\n}\n\nexport const PROTOCOL = 'smoothagent.v3'\n\n/** A auto-resposta hibern\u00E1vel do DO compara a STRING EXATA (realtime: PING/PONG). Qualquer outra forma acorda o DO. */\nexport const PING = '{\"t\":\"ping\"}'\nexport const PONG = '{\"t\":\"pong\"}'\n\nexport const systemClock: Clock = {\n  now: () => Date.now(),\n  setTimeout: (fn, ms) => setTimeout(fn, ms),\n  clearTimeout: (h) => clearTimeout(h as ReturnType<typeof setTimeout>),\n}\n\n/** Ambiente neutro (Node/servidor): sempre online e vis\u00EDvel, sem eventos de wakeup. */\nexport const serverEnv: LiveEnv = {\n  online: () => true,\n  visible: () => true,\n  onWake: () => () => {},\n}\n", "/* GERADO por gen-ts.mjs \u2014 n\u00E3o editar. Tudo fora destas listas: IGNORAR (tipo desconhecido n\u00E3o \u00E9 erro). Sem node:fs: vai pro bundle de navegador. */\nimport type { Capabilities, ErrorCode, FailureReason } from './events';\nexport const KNOWN_EVENT_TYPES = [\"session.started\",\"chat.state\",\"run.started\",\"run.waiting\",\"run.completed\",\"usage.updated\",\"item.started\",\"item.delta\",\"item.updated\",\"item.completed\",\"item.retracted\",\"task.updated\",\"context.updated\",\"limits.updated\",\"agent.switched\",\"agent.switch_failed\",\"notice\",\"error\"] as const;\nexport const KNOWN_ITEM_KINDS = [\"user_message\",\"text\",\"reasoning\",\"tool_call\",\"command\",\"file_change\",\"file_search\",\"web_search\",\"plan\",\"proposed_plan\",\"subagent\",\"notification\",\"timer\",\"approval\",\"question\",\"compaction\",\"handoff\",\"hook\",\"error\"] as const;\nexport const KNOWN_ERROR_CODES = [\"unauthorized\",\"forbidden\",\"not_found\",\"invalid_request\",\"provider_not_connected\",\"provider_auth_expired\",\"provider_error\",\"usage_limit_reached\",\"plan_limit\",\"rate_limited\",\"box_unavailable\",\"conflict\",\"machine_offline\",\"request_expired\",\"no_run\",\"queue_full\",\"internal\"] as const satisfies readonly ErrorCode[];\nexport const KNOWN_FAILURE_REASONS = [\"no_credit\",\"subscription_limit\",\"rate_limited\",\"out_of_memory\",\"context_window_exceeded\",\"auth_failed\",\"provider_crashed\",\"max_turns\",\"network\",\"request_expired\",\"grant_revoked\",\"unknown\"] as const satisfies readonly FailureReason[];\n/** status HTTP de cada c\u00F3digo de erro (\u00A76) */\nexport const ERROR_CODE_HTTP = {\"unauthorized\":401,\"forbidden\":403,\"not_found\":404,\"invalid_request\":400,\"provider_not_connected\":424,\"provider_auth_expired\":424,\"provider_error\":502,\"usage_limit_reached\":429,\"plan_limit\":402,\"rate_limited\":429,\"box_unavailable\":503,\"conflict\":409,\"machine_offline\":409,\"request_expired\":410,\"no_run\":409,\"queue_full\":429,\"internal\":500} as const satisfies Record<ErrorCode, number>;\nexport const CONTRACT_VERSION = '0.1.0';\n/** M42: a tabela \u00DANICA de capabilities por provedor (capabilities.json). fake = a linha do sabor dele. */\nexport const PROVIDER_CAPABILITIES = {\"revision\":4,\"providers\":{\"claude\":{\"measuredOn\":\"2.1.310\",\"contextWindow\":{\"default\":200000,\"rules\":[{\"suffix\":\"[1m]\",\"tokens\":1000000}]},\"capabilities\":{\"version\":1,\"reasoning\":true,\"plans\":true,\"approvals\":false,\"questions\":true,\"subagents\":true,\"background\":true,\"wakeTurns\":true,\"taskStop\":true,\"timers\":false,\"fileChanges\":true,\"images\":true,\"contextUsage\":true,\"usageLimits\":true,\"costReporting\":true,\"parallelTools\":true,\"steering\":\"native\",\"steerBoundary\":\"tool\",\"steerRecall\":true,\"steerInterrupts\":\"nothing\",\"interrupt\":\"native\",\"consumptionSignal\":\"echo\",\"modelSwitchInSession\":true,\"resume\":true,\"effortSwitch\":\"live\",\"handoffInject\":\"native_history\",\"mcpSwitch\":\"live\"}},\"codex\":{\"measuredOn\":\"0.163.0\",\"contextWindow\":{\"default\":258400,\"rules\":[]},\"capabilities\":{\"version\":1,\"reasoning\":true,\"reasoningSummary\":true,\"plans\":true,\"proposedPlans\":true,\"approvals\":true,\"questions\":true,\"subagents\":true,\"background\":true,\"wakeTurns\":false,\"taskStop\":true,\"timers\":false,\"fileChanges\":true,\"images\":true,\"boxFiles\":false,\"contextUsage\":true,\"usageLimits\":true,\"costReporting\":false,\"parallelTools\":true,\"steering\":\"native\",\"steerBoundary\":\"model_call\",\"steerRecall\":false,\"steerDuringCompaction\":\"waits_turn\",\"steerInterrupts\":\"response\",\"interrupt\":\"native\",\"consumptionSignal\":\"echo\",\"streaming\":{\"text\":true,\"reasoning\":true,\"toolInput\":false,\"commandOutput\":true,\"planText\":true},\"modelSwitchInSession\":true,\"effortSwitch\":\"live\",\"resume\":true,\"handoffInject\":\"native_history\",\"mcpSwitch\":\"live\"}}}} as const satisfies { revision: number; providers: Record<string, { measuredOn: string; contextWindow: { default: number; rules: ReadonlyArray<{ id?: string; prefix?: string; suffix?: string; tokens: number }> }; capabilities: Capabilities }> };\n", "// Ids gerados no cliente (sem depend\u00EAncia: o REST usa sem puxar a camada ao vivo).\n\n/**\n * `messageId` gerado no cliente: `msg_` + UUIDv7 (contrato control: `^msg_[A-Za-z0-9_-]{8,64}$`).\n * \u00C9 a idempot\u00EAncia e o dedupe do log; o prefixo separa mensagem de n\u00FAmero de evento no `history?around=`.\n */\nexport function newMessageId(nowMs: number = Date.now()): string {\n  return 'msg_' + uuidv7(nowMs)\n}\n\n/** UUIDv7 (orden\u00E1vel no tempo). */\nexport function uuidv7(nowMs: number = Date.now()): string {\n  const bytes = new Uint8Array(16)\n  globalThis.crypto.getRandomValues(bytes)\n  let ts = BigInt(Math.floor(nowMs))\n  for (let i = 5; i >= 0; i--) {\n    bytes[i] = Number(ts & 0xffn)\n    ts >>= 8n\n  }\n  bytes[6] = (bytes[6]! & 0x0f) | 0x70\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80\n  const hex = [...bytes].map((b) => b.toString(16).padStart(2, '0')).join('')\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n", "// O que as SDKs REST (client e server) somam \u00E0 gerada pelo Fern, sem a camada ao vivo (sem wasm).\n//  - Idempotency-Key em TODO pedido que o app n\u00E3o chaveou: o retry do gerador (2\u00D7 em 408/429/5xx) nunca\n//    duplica um POST (o control guarda 24 h por credencial; mesmo corpo \u2192 mesma resposta). Auditoria M47.\n//  - `send` com o `clientMessageId` gerado uma vez e reenvio sozinho na falha passageira (PLAN sdk 3).\nimport { newMessageId, uuidv7 } from './ids'\nimport type { Clock } from './deps'\nimport { KNOWN_ERROR_CODES } from '../../../../contract/events/ts/src/gen/known'\nimport type { ErrorCode } from './types'\n\n/** Cabe\u00E7alho padr\u00E3o do cliente gerado: uma chave nova por chamada (a mesma em todas as tentativas dela). */\nexport function idempotencyHeaders(): Record<string, () => string> {\n  return { 'Idempotency-Key': () => 'idk_' + uuidv7() }\n}\n\n/** Tentativas do `send` al\u00E9m do retry do gerador (que n\u00E3o cobre queda de rede): ~1+2+4+8+16 s. */\nexport const SEND_ATTEMPTS = 6\n\ntype ApiErrorLike = { statusCode?: number; body?: unknown }\n\n/**\n * Falha passageira: rede caiu (sem status), timeout, 408/429/5xx, ou 409 `retryable` (a mesma chave ainda em\n * andamento) \u2014 a menos que o corpo diga `retryable:false`.\n */\nexport function transient(e: unknown, errors: { api: abstract new (...a: never[]) => unknown; timeout: abstract new (...a: never[]) => unknown }): boolean {\n  if (e instanceof errors.timeout) return true\n  if (!(e instanceof errors.api)) return false\n  const { statusCode, body } = e as ApiErrorLike\n  const retryable = (body as { error?: { retryable?: boolean } } | undefined)?.error?.retryable\n  if (retryable === false) return false\n  if (statusCode === 409) return retryable === true\n  return statusCode === undefined || statusCode === 408 || statusCode === 429 || statusCode >= 500\n}\n\n/** O corpo de erro do contrato (`{ error: ErrorBody }`, \u00A76). */\nexport interface ApiErrorBody {\n  code: ErrorCode\n  message: string\n  retryable: boolean\n  /** o campo culpado em `invalid_request` */\n  param?: string\n  requestId?: string\n  /** dados do c\u00F3digo: `reason`, `resetsAt`, `scope`\u2026 */\n  details?: Record<string, unknown>\n}\n\n/**\n * O corpo tipado de um erro do REST (`SmoothAgentApiError`), ou `undefined` se n\u00E3o for um (rede, timeout,\n * outro erro). C\u00F3digo fora da lista do \u00A76 vira `internal` (vers\u00E3o nova do servidor n\u00E3o quebra a tela).\n */\nexport function apiErrorBody(e: unknown): ApiErrorBody | undefined {\n  const err = (e as { body?: { error?: Partial<ApiErrorBody> } } | null)?.body?.error\n  if (!err || typeof err !== 'object' || typeof err.code !== 'string') return undefined\n  return { ...err, code: ((KNOWN_ERROR_CODES as readonly string[]).includes(err.code) ? err.code : 'internal') as ErrorCode, message: String(err.message ?? ''), retryable: err.retryable === true } as ApiErrorBody\n}\n\n/**\n * Faz o `send` at\u00E9 gravar: o `clientMessageId` \u00E9 gerado UMA vez (antes do 1\u00BA envio) e vira tamb\u00E9m a\n * Idempotency-Key; na falha passageira repete o MESMO pedido com espera. O log responde `duplicate`/a mesma\n * resposta se o primeiro j\u00E1 tinha gravado.\n */\nexport function sendBody<R extends { clientMessageId?: string; 'Idempotency-Key'?: string }>(req: R): R & { clientMessageId: string; 'Idempotency-Key': string } {\n  const clientMessageId = req.clientMessageId ?? newMessageId()\n  return { ...req, clientMessageId, 'Idempotency-Key': req['Idempotency-Key'] ?? clientMessageId }\n}\n\nexport async function untilStored<T>(\n  call: () => Promise<T>,\n  o: { clock: Clock; abortSignal?: AbortSignal; isTransient(e: unknown): boolean; attempts?: number },\n): Promise<T> {\n  const attempts = o.attempts ?? SEND_ATTEMPTS\n  for (let n = 0; ; n++) {\n    try {\n      return await call()\n    } catch (e) {\n      if (n + 1 >= attempts || !o.isTransient(e) || o.abortSignal?.aborted) throw e\n      await new Promise<void>((res) => o.clock.setTimeout(res, 1_000 * 2 ** n * (0.75 + 0.5 * Math.random())))\n    }\n  }\n}\n"],
+  "mappings": ";AA2DO,IAAM,cAAqB;AAAA,EAChC,KAAK,MAAM,KAAK,IAAI;AAAA,EACpB,YAAY,CAAC,IAAI,OAAO,WAAW,IAAI,EAAE;AAAA,EACzC,cAAc,CAAC,MAAM,aAAa,CAAkC;AACtE;AAGO,IAAM,YAAqB;AAAA,EAChC,QAAQ,MAAM;AAAA,EACd,SAAS,MAAM;AAAA,EACf,QAAQ,MAAM,MAAM;AAAA,EAAC;AACvB;;;AClEO,IAAM,oBAAoB,CAAC,gBAAe,aAAY,aAAY,mBAAkB,0BAAyB,yBAAwB,kBAAiB,uBAAsB,cAAa,gBAAe,mBAAkB,YAAW,mBAAkB,mBAAkB,UAAS,cAAa,UAAU;;;ACEzS,SAAS,aAAa,QAAgB,KAAK,IAAI,GAAW;AAC/D,SAAO,SAAS,OAAO,KAAK;AAC9B;AAGO,SAAS,OAAO,QAAgB,KAAK,IAAI,GAAW;AACzD,QAAM,QAAQ,IAAI,WAAW,EAAE;AAC/B,aAAW,OAAO,gBAAgB,KAAK;AACvC,MAAI,KAAK,OAAO,KAAK,MAAM,KAAK,CAAC;AACjC,WAAS,IAAI,GAAG,KAAK,GAAG,KAAK;AAC3B,UAAM,CAAC,IAAI,OAAO,KAAK,KAAK;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,CAAC,IAAK,MAAM,CAAC,IAAK,KAAQ;AAChC,QAAM,CAAC,IAAK,MAAM,CAAC,IAAK,KAAQ;AAChC,QAAM,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAC1E,SAAO,GAAG,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,GAAG,EAAE,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;AAC1G;;;ACbO,SAAS,qBAAmD;AACjE,SAAO,EAAE,mBAAmB,MAAM,SAAS,OAAO,EAAE;AACtD;AAGO,IAAM,gBAAgB;AAQtB,SAAS,UAAU,GAAY,QAAqH;AACzJ,MAAI,aAAa,OAAO,QAAS,QAAO;AACxC,MAAI,EAAE,aAAa,OAAO,KAAM,QAAO;AACvC,QAAM,EAAE,YAAY,KAAK,IAAI;AAC7B,QAAM,YAAa,MAA0D,OAAO;AACpF,MAAI,cAAc,MAAO,QAAO;AAChC,MAAI,eAAe,IAAK,QAAO,cAAc;AAC7C,SAAO,eAAe,UAAa,eAAe,OAAO,eAAe,OAAO,cAAc;AAC/F;AAkBO,SAAS,aAAa,GAAsC;AACjE,QAAM,MAAO,GAA2D,MAAM;AAC9E,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,SAAS,SAAU,QAAO;AAC5E,SAAO,EAAE,GAAG,KAAK,MAAQ,kBAAwC,SAAS,IAAI,IAAI,IAAI,IAAI,OAAO,YAA0B,SAAS,OAAO,IAAI,WAAW,EAAE,GAAG,WAAW,IAAI,cAAc,KAAK;AACnM;AAOO,SAAS,SAA6E,KAAoE;AAC/J,QAAM,kBAAkB,IAAI,mBAAmB,aAAa;AAC5D,SAAO,EAAE,GAAG,KAAK,iBAAiB,mBAAmB,IAAI,iBAAiB,KAAK,gBAAgB;AACjG;AAEA,eAAsB,YACpB,MACA,GACY;AACZ,QAAM,WAAW,EAAE,YAAY;AAC/B,WAAS,IAAI,KAAK,KAAK;AACrB,QAAI;AACF,aAAO,MAAM,KAAK;AAAA,IACpB,SAAS,GAAG;AACV,UAAI,IAAI,KAAK,YAAY,CAAC,EAAE,YAAY,CAAC,KAAK,EAAE,aAAa,QAAS,OAAM;AAC5E,YAAM,IAAI,QAAc,CAAC,QAAQ,EAAE,MAAM,WAAW,KAAK,MAAQ,KAAK,KAAK,OAAO,MAAM,KAAK,OAAO,EAAE,CAAC;AAAA,IACzG;AAAA,EACF;AACF;",
+  "names": []
+}