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

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# @smoothcodes/agent-server
+
+## 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)
+```