@smoothcodes/agent-client 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,55 @@
+import type { CFSend, ContentPart as ContractContentPart, ErrorCode, Origin, Provider, RawFrame, SnapshotPayload, SubmitAccepted, SubmitConflict, SubmitDuplicate, Timestamp } from '../../../../contract/events/ts/src/gen/events.js';
+export type { AgentSelection, QueueItem, QueueState, PendingSwitch, BoxPresence, ChatState, ClientFrame, ErrorCode, Event, InboxEntry, InboxState, Origin, QueueOp, RawFrame, ScheduledSwitch, ServerFrame, FeedFrame, } from '../../../../contract/events/ts/src/gen/events.js';
+/**
+ * Um evento da timeline com `type`/`data` soltos (o app lê campos sem estreitar a união). É o envelope do
+ * contrato (`Event`) sem a amarração por tipo; pra estreitar por `type`, use `Event`.
+ */
+export interface Envelope {
+    /** = String(seq) */
+    id: string;
+    seq: number;
+    /** fencing: a concessão que numerou */
+    epoch?: number;
+    chatId: string;
+    ts: string;
+    type: string;
+    runId?: string;
+    itemId?: string;
+    parentItemId?: string;
+    origin?: Origin;
+    /** só com `includeRaw` */
+    raw?: RawFrame[];
+    data?: Record<string, unknown>;
+}
+export type SendMode = CFSend['mode'];
+/**
+ * "Conecte sua conta": o usuário roda com a PRÓPRIA credencial do provedor e ela falta ou venceu. Derivado no
+ * núcleo (o snapshot/F5 reproduz): fila parada por `auth`, último run falhado por `provider_not_connected`/
+ * `provider_auth_expired`, ou send/resend recusado com esses códigos. Some no `run.started` seguinte.
+ */
+export interface NeedsProvider {
+    provider: Provider;
+    reason: 'not_connected' | 'auth_expired';
+    /** desde quando a fila está parada (o `held.since`) */
+    since?: Timestamp;
+}
+/** Pedaço do conteúdo de uma mensagem — o tipo GERADO do contrato. No fio do WS o conteúdo é SEMPRE lista. */
+export type ContentPart = ContractContentPart;
+/**
+ * Texto solto vira `[{type:'text', text}]` (o realtime recusa string no `send` e no `edit`); anexos
+ * (`fileId` do upload) entram como partes `file` — o frame não tem campo `attachments`.
+ */
+export declare function toContentParts(content: string | ContentPart[], attachments?: string[]): ContentPart[];
+/**
+ * A resposta de um comando, só depois de gravado no log. O `rejected` da SDK traz sempre um código do §6
+ * (`ErrorCode`): código fora da lista vira `internal` (e `bad_ack` no modo estrito).
+ */
+export type SubmitResult = SubmitAccepted | SubmitDuplicate | SubmitConflict | {
+    status: 'rejected';
+    code: ErrorCode;
+    message: string;
+};
+/** O snapshot que o servidor manda (o estado já reduzido no `seq`, a inbox, a presença e os recentes). */
+export type ChatSnapshot = SnapshotPayload;
+/** @deprecated o nome antigo; é o `InboxState` do contrato. */
+export type { InboxState as Inbox } from '../../../../contract/events/ts/src/gen/events.js';