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

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

@@ -0,0 +1,40 @@
+import type { Clock } from './deps.js';
+export type AuthErrorReason = 'missing' | 'invalid' | 'expired' | 'revoked';
+export declare class SmoothAgentAuthError extends Error {
+    readonly reason: AuthErrorReason;
+    constructor(reason: AuthErrorReason, message?: string);
+}
+export interface TokenSourceOptions {
+    token?: string;
+    getToken?: () => Promise<string>;
+    clock: Clock;
+    /** Renova quando falta menos que isto pro `exp` (padrão 60 s). */
+    skewMs?: number;
+}
+/** `exp` (ms) de um JWT, ou null se não for JWT (chave de API) ou não tiver `exp`. */
+export declare function jwtExpiresAt(token: string): number | null;
+export declare class TokenSource {
+    private readonly o;
+    private current;
+    private inflight;
+    private stale;
+    private revoked;
+    private readonly listeners;
+    private readonly skewMs;
+    constructor(o: TokenSourceOptions);
+    /** Token válido agora (renova se precisar). Rejeita com SmoothAgentAuthError('revoked') depois de revogado. */
+    get(): Promise<string>;
+    /** O servidor disse `expired`: a próxima `get()` renova. */
+    invalidate(): void;
+    /** O servidor disse `revoked`: nada de renovar. */
+    markRevoked(): void;
+    get isRevoked(): boolean;
+    onRenew(cb: (token: string) => void): () => void;
+    private nearExpiry;
+    private refresh;
+}
+/**
+ * `fetch` com o Authorization do TokenSource e a regra do 401: `expired` → renova e repete UMA vez;
+ * `revoked` → marca e devolve a resposta (quem chamou mostra o erro). Vai como `fetch` da SDK gerada.
+ */
+export declare function authedFetch(source: TokenSource, base?: typeof fetch): typeof fetch;

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

@@ -0,0 +1,9 @@
+export interface BackoffPolicy {
+    baseMs: number;
+    factor: number;
+    capVisibleMs: number;
+    capHiddenMs: number;
+    /** Só zera o contador depois de ficar de pé este tempo. */
+    stableMs: number;
+}
+export declare const DEFAULT_BACKOFF: BackoffPolicy;

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

@@ -0,0 +1,89 @@
+import { TokenSource } from './auth.js';
+import { type Clock, type LiveEnv, type SocketLike } from './deps.js';
+import type { DebugEvent, Violation } from './stream.js';
+import type { ContentPart, Envelope, SendMode } from './types.js';
+import { LiveChat, type HistoryPage, type Reducer, type WatchOptions } from './watch.js';
+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> {
+    /** a base da API, ex. `https://smoothagent-v3-api.uaibuilder.workers.dev` (white-label: só isto muda). */
+    baseUrl: string;
+    token?: string;
+    getToken?: () => Promise<string>;
+    /** Ignorado: o reducer é o do contrato, no núcleo Rust (mantido pra compatibilidade). */
+    reducer?: Reducer<S, I>;
+    fetch?: typeof fetch;
+    WebSocket?: new (url: string, protocols: string[]) => SocketLike;
+    clock?: Clock;
+    env?: LiveEnv;
+    keepAliveMs?: number;
+    onDebug?(chatId: string, e: DebugEvent): void;
+    /** Modo estrito (testes): buraco vira violação em vez de resync. */
+    strict?: boolean;
+    onViolation?(chatId: string, v: Violation): void;
+    /** Revogado: a sessão acabou (o app volta pro login dele). */
+    onAuthRevoked?(): void;
+    /** Opções repassadas a cada stream (testes e ajuste fino). */
+    stream?: Partial<Omit<WatchOptions<S, I>, 'chatId' | 'reducer'>>;
+}
+export declare class LiveClient<S, I = unknown> {
+    private readonly o;
+    readonly tokens: TokenSource;
+    /** `fetch` com o token e a regra do 401 (a SDK gerada usa o mesmo). */
+    readonly fetch: typeof fetch;
+    private readonly clock;
+    private readonly entries;
+    private readonly lists;
+    private readonly api;
+    constructor(o: LiveClientOptions<S, I>);
+    /** O estado ao vivo do chat. Chame `close()` no handle quando a tela desmontar. */
+    watch(chatId: string): LiveChat<S, I> & {
+        release(): void;
+    };
+    /**
+     * Eventos crus, já sem duplicado/buraco e com a troca de transporte. Termina no `return()`/break.
+     * - `after`: começa DEPOIS deste seq (retomar de onde parou: todo evento de `after+1` em diante, sem snapshot);
+     *   sem `after`, começa no estado atual (o snapshot do servidor; `onSnapshot(seq)` diz até onde ele cobre).
+     * - `onSnapshot(seq)`: o servidor mandou um snapshot em vez dos eventos — os anteriores a `seq` NÃO vêm
+     *   (início sem `after`, ou resync depois de um buraco que não fechou). Nunca pula em silêncio (M46).
+     * - `includeRaw`: os eventos trazem o `raw` do provedor.
+     * Um socket próprio (não o do `watch()`), pra o cursor ser só dele.
+     */
+    events(chatId: string, o?: {
+        after?: number;
+        includeRaw?: boolean;
+        onSnapshot?(seq: number): void;
+    }): AsyncGenerator<Envelope, void, undefined>;
+    /** Manda e acompanha só esse run. `result` nunca rejeita por transporte. */
+    prompt(chatId: string, content: string | ContentPart[], opts?: {
+        mode?: SendMode;
+        attachments?: string[];
+        messageId?: string;
+        metadata?: Record<string, string>;
+    }): RunHandle;
+    /** A lista lateral ao vivo (UserFeed): título, estado, esperando o quê, não lidas. Filtro por agente aqui. */
+    watchList(filter?: {
+        agentId?: string;
+    }): ChatListLive;
+    /** Marca como lido até `seq` (vale pra todos os dispositivos do usuário; o feed atualiza o unreadCount). */
+    markRead(chatId: string, seq: number): Promise<void>;
+    /** Fecha tudo agora. */
+    close(): void;
+    private release;
+    private watchOptions;
+    private deps;
+    /**
+     * O caminho durável do `send` (REST `SendMessage`): a mesma fila fria do ChatLog, deduplicada pelo
+     * `clientMessageId` (= o messageId do socket) e pela Idempotency-Key (a mesma). Falha passageira: repete com
+     * espera (`untilStored`) e, esgotado, rejeita; recusa do servidor = `rejected` com o código do §6.
+     */
+    private postMessage;
+    private json;
+}
+/**
+ * A página do `GET /v3/chats/{id}/history` do contrato (tipo GERADO): cada entrada é o EVENTO que fechou
+ * um item (`entry.event`, um Events.Event) + o `seq` dele. Vira envelope do log e passa pelo reducer do
+ * contrato como qualquer evento (`item.completed` traz o item em `data.item`). Ids de evento vêm em string.
+ */
+export declare function fromControlPage(_chatId: string, p: ControlHistoryPage): HistoryPage;

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

@@ -0,0 +1,63 @@
+import type { ChatSnapshot, Envelope } from './types.js';
+/** O mínimo de um WebSocket (browser, React Native, Node ≥ 22, Bun, Deno ou um falso de teste). */
+export interface SocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((ev?: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((ev: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    onerror: ((ev?: unknown) => void) | null;
+}
+export type OpenSocket = (url: string, protocols: string[]) => SocketLike;
+export interface Clock {
+    now(): number;
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export interface LiveEnv {
+    /** false = sabemos que não há rede (navigator.onLine). */
+    online(): boolean;
+    /** Primeiro plano? (visibilitychange / AppState). Muda o teto do backoff. */
+    visible(): boolean;
+    /** Rede voltou, aba voltou pro primeiro plano, foco: acorda o retry na hora. Devolve o "desligar". */
+    onWake(cb: (why: 'online' | 'visible' | 'focus' | 'manual', awayMs?: number) => void): () => void;
+}
+export interface LiveDeps {
+    /** URL do conector (o WebSocket do ChatLog): `wss://…/v3/chats/:id/live`. */
+    connectorUrl(chatId: string): string;
+    openSocket: OpenSocket;
+    /** Token do usuário (ou chave), já com a renovação single-flight (auth.ts). */
+    token(): Promise<string>;
+    /** O servidor disse que o token venceu: a próxima `token()` tem que trazer um novo. */
+    invalidateToken?(): void;
+    /** Pedaço do log por REST, quando não há socket que responda o `fetch`. */
+    eventsRange?(chatId: string, from: number, to: number): Promise<{
+        events: Envelope[];
+        range: {
+            from: number;
+            to: number;
+        };
+    }>;
+    /**
+     * O WebSocket não mostra o HTTP de um upgrade recusado (o navegador só dá 1006). Quando o conector nem
+     * chega a abrir, a SDK pergunta aqui (REST `GET /chats/{id}`) se é falta de acesso, pra não religar pra sempre.
+     */
+    probeAccess?(chatId: string): Promise<'ok' | 'unauthorized' | 'forbidden'>;
+    /** Snapshot por REST (resync sem socket). */
+    snapshot?(chatId: string): Promise<ChatSnapshot>;
+    clock: Clock;
+    env: LiveEnv;
+}
+export declare const PROTOCOL = "smoothagent.v3";
+/** A auto-resposta hibernável do DO compara a STRING EXATA (realtime: PING/PONG). Qualquer outra forma acorda o DO. */
+export declare const PING = "{\"t\":\"ping\"}";
+export declare const PONG = "{\"t\":\"pong\"}";
+export declare const systemClock: Clock;
+/** Ambiente neutro (Node/servidor): sempre online e visível, sem eventos de wakeup. */
+export declare const serverEnv: LiveEnv;

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

@@ -0,0 +1,73 @@
+import type { LiveDeps } from './deps.js';
+export type Env = [now: number, online: boolean, visible: boolean, rand: number];
+/** As entradas que todo núcleo (LiveSession, LiveWatch) aceita; cada uma devolve os efeitos em JSON. */
+export interface CoreLike {
+    tick(...e: Env): string;
+    on_open(...a: [...Env, number]): string;
+    on_message(...a: [...Env, number, string]): string;
+    on_error(...a: [...Env, number]): string;
+    on_close(...a: [...Env, number, number, string]): string;
+    on_open_failed(...a: [...Env, number]): string;
+    on_token(...a: [...Env, number, boolean, string]): string;
+    on_probe(...a: [...Env, number, boolean, string]): string;
+    on_range(...a: [...Env, number, boolean, string, number, number]): string;
+    on_snapshot(...a: [...Env, number, boolean, string]): string;
+    next_deadline(): number;
+}
+export type IoFx = {
+    k: 'token' | 'probe' | 'snapshot';
+    req: number;
+} | {
+    k: 'invalidateToken';
+} | {
+    k: 'range';
+    req: number;
+    from: number;
+    to: number;
+} | {
+    k: 'open';
+    conn: number;
+    via: string;
+    url: string;
+    protocols: string[];
+} | {
+    k: 'send';
+    conn: number;
+    text: string;
+} | {
+    k: 'close';
+    conn: number;
+    code: number;
+    reason: string;
+};
+/** Um efeito que não é IO (cada casca trata os seus). */
+export type OtherFx = {
+    k: string;
+    [x: string]: unknown;
+};
+export declare class Edge<C extends CoreLike> {
+    private readonly d;
+    private readonly chatId;
+    private readonly random;
+    private readonly handle;
+    private readonly sockets;
+    private timer;
+    private stopped;
+    /** O núcleo desta casca; `null` até o wasm carregar (as entradas esperam em `pending`, em ordem). */
+    core: C | null;
+    private pending;
+    constructor(make: () => C, d: LiveDeps, chatId: string, random: () => number, handle: (f: OtherFx) => void);
+    /** Roda `fn` com o núcleo: na hora se já carregou, senão na ordem em que foi pedido, quando carregar. */
+    when(fn: (c: C) => void): void;
+    env(): Env;
+    /** Uma entrada pro núcleo; executa os efeitos devolvidos, em ordem; re-arma o timer. */
+    run(input: (c: C, e: Env) => string): void;
+    /** Executa uma lista de efeitos já devolvida (quando quem chamou precisou do JSON antes). */
+    exec(fx: Array<IoFx | OtherFx>): void;
+    /** Para tudo (depois do close do núcleo): sem timer, sem novas entradas. */
+    stop(): void;
+    private arm;
+    private disarm;
+    private one;
+    private open;
+}

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

@@ -0,0 +1,66 @@
+import type { Clock, LiveEnv, OpenSocket } from './deps.js';
+import type { BoxPresence } from './types.js';
+export interface ChatRow {
+    chatId: string;
+    agentId: string;
+    title?: string;
+    state: string;
+    waiting?: 'approval' | 'question' | 'input';
+    box?: BoxPresence;
+    lastEventSeq: number;
+    updatedAt: string;
+    lastReadSeq: number;
+    unreadCount: number;
+}
+export type FeedFrame = {
+    t: 'feed';
+    version: number;
+    rows: ChatRow[];
+} | {
+    t: 'row';
+    version: number;
+    row: ChatRow;
+} | {
+    t: 'removed';
+    version: number;
+    chatId: string;
+} | {
+    t: 'hello';
+    tokenExpiresAt?: number;
+} | {
+    t: 'bye';
+    reason: string;
+    reconnect: string;
+} | {
+    t: 'pong';
+};
+export type FeedStatus = 'connecting' | 'live' | 'reconnecting' | 'offline' | 'auth_failed' | 'forbidden' | 'closed';
+export interface FeedState {
+    version: number;
+    /** Ordenadas por `updatedAt` (mais recente primeiro), já filtradas por agente se pedido. */
+    rows: ChatRow[];
+    status: FeedStatus;
+}
+export interface FeedDeps {
+    url: string;
+    openSocket: OpenSocket;
+    token(): Promise<string>;
+    invalidateToken?(): void;
+    clock: Clock;
+    env: LiveEnv;
+}
+/** CASCA FINA sobre o núcleo Rust (`Feed`): a borda comum executa o IO; o estado chega pronto. */
+export declare class ChatListLive {
+    private readonly d;
+    private readonly edge;
+    private state;
+    private readonly listeners;
+    private readonly unWake;
+    private closed;
+    constructor(d: FeedDeps, filter?: {
+        agentId?: string;
+    });
+    getState: () => FeedState;
+    subscribe: (cb: (s: FeedState) => void) => (() => void);
+    close(): void;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * `messageId` gerado no cliente: `msg_` + UUIDv7 (contrato control: `^msg_[A-Za-z0-9_-]{8,64}$`).
+ * É a idempotência e o dedupe do log; o prefixo separa mensagem de número de evento no `history?around=`.
+ */
+export declare function newMessageId(nowMs?: number): string;
+/** UUIDv7 (ordenável no tempo). */
+export declare function uuidv7(nowMs?: number): string;

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

@@ -0,0 +1,7 @@
+import * as live from './wasm/live.js';
+/** Carrega o núcleo (uma vez). A camada ao vivo chama sozinha; chamar antes só adianta o download. */
+export declare function loadCore(): Promise<typeof live>;
+/** O núcleo, se já carregou (senão `null`: quem usa enfileira até `loadCore()` resolver). */
+export declare function coreIfReady(): typeof live | null;
+/** O núcleo já carregado; antes disso é erro (use `loadCore()`). */
+export declare function core(): typeof live;

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

@@ -0,0 +1,81 @@
+import type { ContentPart, Envelope, SendMode } from './types.js';
+import type { LiveChat } from './watch.js';
+export type RunOutcome = 'completed' | 'stopped' | 'failed' | 'not_delivered' | 'cancelled';
+export interface RunResult {
+    status: RunOutcome;
+    messageId: string;
+    runId?: string;
+    text: string;
+    /** Itens fechados deste run (o `data.item` dos item.completed). */
+    items: unknown[];
+    usage?: unknown;
+    error?: unknown;
+    /** Só em `not_delivered`: `not_consumed` = a box dormiu várias vezes sem o provedor ler; ausente = STOP antes do turno. */
+    notDeliveredReason?: string;
+}
+export type RunEvent = {
+    type: 'queued';
+} | {
+    type: 'started';
+    runId: string;
+} | {
+    type: 'text';
+    delta: string;
+    text: string;
+} | {
+    type: 'item';
+    item: unknown;
+} | {
+    type: 'event';
+    event: Envelope;
+} | {
+    type: 'done';
+    result: RunResult;
+};
+export declare class PromptRejectedError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class RunHandle implements AsyncIterable<RunEvent> {
+    private readonly live;
+    private readonly onSettled?;
+    readonly result: Promise<RunResult>;
+    state: 'sending' | 'queued' | 'running' | 'done';
+    messageId: string;
+    runId: string | undefined;
+    private resolve;
+    private reject;
+    private readonly handlers;
+    private readonly buffer;
+    private wakeIterators;
+    private text;
+    private readonly items;
+    private readonly untap;
+    private unselect;
+    constructor(live: LiveChat<unknown, unknown>, content: string | ContentPart[], opts?: {
+        mode?: SendMode;
+        attachments?: string[];
+        messageId?: string;
+        metadata?: Record<string, string>;
+    }, onSettled?: (() => void) | undefined);
+    on<K extends RunEvent['type']>(type: K, cb: (e: Extract<RunEvent, {
+        type: K;
+    }>) => void): this;
+    /** STOP do chat (o run é dele). O `result` resolve com `stopped` quando o run fechar. */
+    stop(): Promise<unknown>;
+    /** Para de ouvir; o agente segue. O `result` resolve com `cancelled`. */
+    cancel(): void;
+    [Symbol.asyncIterator](): AsyncIterator<RunEvent>;
+    private watchQueue;
+    private onEvent;
+    /**
+     * O texto do run = os itens `text` fechados. Um steer no Codex CORTA a resposta em andamento
+     * (`steerBoundary: 'model_call'`): o parcial fecha `interrupted` e outra resposta começa já com o
+     * steer — a resposta final é a que completou; o parcial cortado só entra se não houver outra.
+     */
+    private finalText;
+    private settle;
+    private fail;
+    private cleanup;
+    private emit;
+}

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

@@ -0,0 +1,187 @@
+import type { Clock } from './deps.js';
+/** Um provedor como a API devolve (`/me/providers` ou dentro de uma conexão). */
+export interface ProviderRow {
+    provider: string;
+    connected: boolean;
+    via: string[];
+    expiresAt?: string | null;
+    /** ok | expiring (renova sozinho no próximo uso) | dead (reconectar) | disconnected. */
+    status: 'ok' | 'expiring' | 'dead' | 'disconnected';
+    message?: string;
+    models: {
+        id: string;
+        name?: string;
+    }[];
+    connect: string[];
+    /** `/me/providers`: algum agente do usuário roda neste provedor. Ausente nas conexões do workspace. */
+    needed?: boolean;
+}
+/** O início de um login, como a API devolve (`connect`). */
+export type LoginStart = {
+    kind: 'oauth';
+    loginId: string;
+    url: string;
+    expiresAt: string;
+} | {
+    kind: 'device';
+    loginId: string;
+    url: string;
+    userCode: string;
+    expiresAt: string;
+};
+/** As rotas de UM dono. A cola (client/server) monta isto com o REST gerado. */
+export interface ProviderEndpoints {
+    list(): Promise<ProviderRow[]>;
+    connect(provider: string): Promise<LoginStart>;
+    complete(loginId: string, code: string): Promise<unknown>;
+    loginStatus(loginId: string): Promise<{
+        status: string;
+        error?: {
+            code?: string;
+            message?: string;
+        };
+    }>;
+    setKey(provider: string, key: string): Promise<unknown>;
+    disconnect(provider: string, via?: 'subscription' | 'key'): Promise<unknown>;
+}
+/** O estado de um fluxo de conectar. `error` no pending = falha que dá pra tentar de novo (código errado, rede). */
+export type ConnectState = {
+    status: 'starting';
+    provider: string;
+} | {
+    status: 'pending';
+    provider: string;
+    kind: 'oauth';
+    url: string;
+    expiresAt: string;
+    submitting: boolean;
+    error?: string;
+} | {
+    status: 'pending';
+    provider: string;
+    kind: 'device';
+    userCode: string;
+    verificationUrl: string;
+    expiresAt: string;
+    error?: string;
+} | {
+    status: 'connected';
+    provider: string;
+} | {
+    status: 'expired';
+    provider: string;
+} | {
+    status: 'failed';
+    provider: string;
+    message: string;
+    code?: string;
+} | {
+    status: 'cancelled';
+    provider: string;
+};
+export type ConnectStatus = ConnectState['status'];
+/** Um login em andamento. `subscribe`/`getState` servem o `useSyncExternalStore`. */
+export interface ConnectFlow {
+    readonly provider: string;
+    getState(): ConnectState;
+    subscribe(fn: (s: ConnectState) => void): () => void;
+    /** Só OAuth: o código que o site mostrou. Código errado = continua `pending` com `error` (cole de novo). */
+    complete(code: string): Promise<ConnectState>;
+    /** Para de esperar (o login no servidor vence sozinho). */
+    cancel(): void;
+    /** Resolve no estado final: connected | expired | failed | cancelled. Nunca rejeita. */
+    readonly done: Promise<ConnectState>;
+}
+/** Um provedor na tela: a linha da API + o fluxo de conectar dele + a ação de chave/desconectar em curso. */
+export interface ProviderEntry extends ProviderRow {
+    /** Em que seção desenhar (ver `sortProviders`). */
+    group: ProviderGroup;
+    /** O login aberto (ou o último que falhou/venceu, até o próximo `connect`/`dismiss`). */
+    flow: ConnectState | null;
+    /** `setKey`/`disconnect` em curso. */
+    busy: 'key' | 'disconnect' | null;
+    /** O erro da última `setKey`/`disconnect` (limpo na próxima ação). */
+    error: string | null;
+}
+export interface ProvidersState {
+    /** Ordenada: os que algum agente do usuário usa (`needed`) primeiro, depois os outros, na ordem da API. */
+    rows: ProviderEntry[];
+    loading: boolean;
+    /** Falha ao carregar a lista. */
+    error: string | null;
+}
+export interface ProviderSetOptions {
+    clock: Clock;
+    /** Os provedores do agente/chat aberto (ex.: `agent.needs` ou `[agent.provider]`): vêm primeiro. Troque com `setPrimary`. */
+    primary?: readonly string[];
+    /** Intervalo do poll do device (padrão 2 s). */
+    pollMs?: number;
+    /** Folga sobre o `expiresAt` do servidor antes de dar `expired` localmente (relógio do aparelho torto; padrão 30 s). */
+    graceMs?: number;
+}
+export declare const PROVIDER_POLL_MS = 2000;
+/** O grupo da linha na tela: os do agente/chat (`primary`), os que algum agente do usuário usa (`needed`), o resto. */
+export type ProviderGroup = 'primary' | 'needed' | 'other';
+export declare const groupOf: (r: {
+    provider: string;
+    needed?: boolean;
+}, primary?: readonly string[]) => ProviderGroup;
+/** Ordena: `primary` (na ordem dada) → `needed` → o resto; estável. A lista nunca é filtrada. */
+export declare function sortProviders<R extends {
+    provider: string;
+    needed?: boolean;
+}>(rows: readonly R[], primary?: readonly string[]): R[];
+/** Texto curto de um erro do REST pra tela (sem nada do pedido). */
+export declare function errorMessage(e: unknown): string;
+/** Só http(s): URL de login com outro esquema (javascript:, data:) não chega na tela. */
+export declare function safeLoginUrl(url: unknown): string | null;
+/**
+ * Os provedores de UM dono, prontos pra tela: lista ordenada, conectar (OAuth/device, com o poll aqui dentro), chave,
+ * desconectar. Recarrega a lista sozinho depois de cada mudança. `release()` quando a tela desmontar.
+ */
+export declare class ProviderSet {
+    private readonly ep;
+    private state;
+    private raw;
+    private flows;
+    private last;
+    private busy;
+    private errors;
+    private subs;
+    private loadSeq;
+    private released;
+    private readonly o;
+    private primary;
+    constructor(ep: ProviderEndpoints, o: ProviderSetOptions);
+    getState: () => ProvidersState;
+    subscribe: (fn: (s: ProvidersState) => void) => (() => void);
+    /** Busca a lista de novo (a resposta mais nova vence). */
+    reload: () => Promise<void>;
+    /** Abre o login: Claude → `oauth` (abra `url`, cole o código em `complete`); Codex → `device` (mostre `userCode`). */
+    connect: (provider: string) => ConnectFlow;
+    /** O login aberto deste provedor, se houver. */
+    flow(provider: string): ConnectFlow | null;
+    /** Troca os provedores que vêm primeiro (o chat mudou de agente). Não busca de novo. */
+    setPrimary: (primary: readonly string[] | undefined) => void;
+    /** Some com o erro/expirado que ficou na linha. */
+    dismiss: (provider: string) => void;
+    /** Chave própria. Rejeita com o erro da API (e o deixa na linha); a chave nunca fica guardada. */
+    setKey: (provider: string, key: string) => Promise<void>;
+    disconnect: (provider: string, via?: "subscription" | "key") => Promise<void>;
+    /** Cancela os logins abertos e para de avisar. */
+    release: () => void;
+    private act;
+    private emit;
+}
+type Method = (req: never, opts?: never) => PromiseLike<unknown>;
+/** O que a SDK gerada tem pra `/me/providers` (o mesmo no client e no server). */
+export type GeneratedMyProviders = Record<'myProvidersList' | 'myProvidersConnect' | 'myProvidersComplete' | 'myProvidersLoginStatus' | 'myProvidersSetKey' | 'myProvidersDisconnect', Method>;
+/** O que a SDK gerada (server) tem pra `/connections`. */
+export type GeneratedConnections = Record<'get' | 'connect' | 'complete' | 'loginStatus' | 'setKey' | 'disconnect', Method>;
+/** As rotas do usuário (`/me/providers`), com a gerada. */
+export declare function myProviderEndpoints(g: GeneratedMyProviders): ProviderEndpoints;
+/** As rotas de uma conexão do workspace (`/connections/{id}`), com a gerada: a mesma forma do usuário. */
+export declare function connectionProviderEndpoints(g: GeneratedConnections, id: string): ProviderEndpoints;
+/** A gerada + métodos a mais (os da gerada continuam presos a ela). */
+export declare function withExtra<G extends object, E extends object>(gen: G, extra: E): G & E;
+export {};

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

@@ -0,0 +1,18 @@
+import type { ChatState } from '../types.js';
+import type { Reducer } from '../watch.js';
+/**
+ * O `ChatState` GERADO do contrato (contract/events, auditoria H23), com os itens vistos pela lente solta
+ * `ContractItem` (o app lê campos do item sem estreitar a união `Item` por `kind`).
+ */
+export type ContractChatState = Omit<ChatState, 'items'> & {
+    items: Record<string, ContractItem>;
+};
+export interface ContractItem {
+    id: string;
+    kind: string;
+    status?: string;
+    /** `user_message`: o metadata que o app mandou com a mensagem (ausente quando não houve; o agente nunca vê). */
+    metadata?: Record<string, string>;
+    [k: string]: unknown;
+}
+export declare const contractReducer: Reducer<ContractChatState, ContractItem>;