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

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

@@ -0,0 +1,78 @@
+import { SmoothAgentApiClient, SmoothAgentApiError, SmoothAgentApiTimeoutError } from '../../../generated/ts-server/index.js';
+import { type Clock, type SocketLike } from '../../core-live/src/deps.js';
+import type { LiveClient } from '../../core-live/src/client.js';
+import type { ContractChatState, ContractItem } from '../../core-live/src/reducers/contract.js';
+import { ProviderSet } from '../../core-live/src/providers.js';
+export { SmoothAgentApiError, SmoothAgentApiTimeoutError };
+export { apiErrorBody, type ApiErrorBody } from '../../core-live/src/rest.js';
+export type { ErrorCode } from '../../core-live/src/types.js';
+export { ProviderSet, sortProviders, type ConnectFlow, type ConnectState, type ConnectStatus, type ProviderEntry, type ProviderGroup, type ProviderRow, type ProvidersState } from '../../core-live/src/providers.js';
+export interface SmoothAgentServerOptions {
+    /** Chave de conta ou de workspace (`sa_…`). Uma função = renovada a cada pedido (ex.: sessão do dashboard). */
+    apiKey: string | (() => string | Promise<string>);
+    /** Workspace padrão (header `SmoothAgent-Workspace`); a chave de conta precisa dele nas rotas de workspace. */
+    workspace?: string;
+    /** Agir como este usuário (header `SmoothAgent-As-User`; a chave precisa do escopo `users:act`). Use `sa.as(userId)`. */
+    asUser?: string;
+    /** White-label: só isto muda. Padrão: produção. No navegador do dashboard, `location.origin` (proxy /v3). */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    /** O ao vivo (`live()`) fora do navegador/Node 22: passe o WebSocket. */
+    WebSocket?: new (url: string, protocols: string[]) => SocketLike;
+    /** Testes. */
+    clock?: Clock;
+}
+/** 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'];
+type GeneratedProviders = SmoothAgentApiClient['providers'];
+type GeneratedConnectionsApi = SmoothAgentApiClient['connections'];
+export interface ProvidersLive {
+    /** Os provedores do usuário (`sa.as(userId).providers.watch()`), prontos pra tela — a mesma forma do client. */
+    watch(opts?: {
+        primary?: readonly string[];
+    }): ProviderSet;
+}
+export interface ConnectionsLive {
+    /** Os provedores de UMA conexão do workspace, prontos pra tela: a mesma forma de `providers.watch()`. */
+    watchProviders(connectionId: string): ProviderSet;
+}
+export declare class SmoothAgentServer {
+    private readonly o;
+    /** O cliente REST gerado (todas as rotas da audience `server`). */
+    readonly api: SmoothAgentApiClient;
+    readonly chats: GeneratedChats;
+    readonly providers: GeneratedProviders & ProvidersLive;
+    readonly connections: GeneratedConnectionsApi & ConnectionsLive;
+    private readonly baseUrl;
+    private liveClient;
+    constructor(o: SmoothAgentServerOptions);
+    /**
+     * A camada ao vivo com a chave (DESIGN §3: um backend ou bot acompanha um chat igual a uma tela):
+     * `(await sa.live()).watch(chatId)`, `.events(chatId, {after})`, `.prompt(chatId, 'oi')`. O núcleo (wasm)
+     * só carrega aqui, num pedaço separado — quem usa só o REST nunca baixa (M49).
+     */
+    live(): Promise<LiveClient<ContractChatState, ContractItem>>;
+    /**
+     * Agindo como um usuário, do backend, sem expor token (DESIGN §3, §12.5): a mesma API, com todo pedido REST
+     * levando `SmoothAgent-As-User` — o servidor aplica o acesso DESSE usuário (grants). `sa.as(u).chats.send(…)`.
+     */
+    as(userId: string): SmoothAgentServer;
+    /** A mesma API presa a outro workspace (chave de conta). */
+    workspace(id: string): SmoothAgentServer;
+    /** A organização (chave de conta): `account.update({ name })` renomeia. */
+    get account(): import("../../../generated/ts-server/api/resources/account/client/Client.js").AccountClient;
+    get agents(): import("../../../generated/ts-server/api/resources/agents/client/Client.js").AgentsClient;
+    get apiKeys(): import("../../../generated/ts-server/api/resources/keys/client/Client.js").KeysClient;
+    get billing(): import("../../../generated/ts-server/api/resources/billing/client/Client.js").BillingClient;
+    get files(): import("../../../generated/ts-server/api/resources/files/client/Client.js").FilesClient;
+    get machines(): import("../../../generated/ts-server/api/resources/machines/client/Client.js").MachinesClient;
+    get me(): import("../../../generated/ts-server/api/resources/identity/client/Client.js").IdentityClient;
+    /** Diagnóstico/logs/métricas de chat, saúde de agente e releases (o que o dashboard mostra). */
+    get observability(): import("../../../generated/ts-server/api/resources/observability/client/Client.js").ObservabilityClient;
+    get runs(): import("../../../generated/ts-server/api/resources/runs/client/Client.js").RunsClient;
+    get secrets(): import("../../../generated/ts-server/api/resources/secrets/client/Client.js").SecretsClient;
+    get users(): import("../../../generated/ts-server/api/resources/users/client/Client.js").UsersClient;
+    get webhooks(): import("../../../generated/ts-server/api/resources/webhooks/client/Client.js").WebhooksClient;
+    get workspaces(): import("../../../generated/ts-server/api/resources/workspaces/client/Client.js").WorkspacesClient;
+}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@smoothbuilder/smoothagent-agent-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "type": "module",
+  "description": "SmoothAgent SDK de quem integra (chave de conta/workspace): REST gerada do contrato + live() pra acompanhar chats. Roda no Node e no navegador.",
+  "license": "UNLICENSED",
+  "keywords": [
+    "smoothagent",
+    "agents",
+    "sdk",
+    "realtime"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/sdk/ts/server/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/sdk/ts/server/src/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./dashboard": {
+      "types": "./dist/types/sdk/ts/server/src/dashboard.d.ts",
+      "import": "./dist/dashboard.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/bytes-*.js.map",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://smoothagent-v3-api.uaibuilder.workers.dev/v3/docs",
+  "gitHead": "7531d42e"
+}