@zihin/agent-client 0.1.0 → 0.4.0

package/dist/triggers.js

@@ -1,241 +0,0 @@
-"use strict";
-/**
- * Caminho B — invocação assíncrona/desacoplada via sistema de triggers.
- *  - createTrigger: provisiona (1x) um webhook ligado a um agente (POST /api/triggers).
- *  - dispatchAgent: dispara o trigger (POST /api/triggers/webhook/:id) → 202 (async) | JSON (sync).
- *  - getExecution: consulta o resultado (GET /api/triggers/:id/executions/:execId).
- *
- * Requer key role admin/editor (triggers:create / telemetry:read). Keys `member` → 403.
- *
- * @module triggers
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTrigger = createTrigger;
-exports.dispatchAgent = dispatchAgent;
-exports.listTriggers = listTriggers;
-exports.getTrigger = getTrigger;
-exports.deleteTrigger = deleteTrigger;
-exports.findOrCreateTrigger = findOrCreateTrigger;
-exports.getExecution = getExecution;
-const errors_1 = require("./errors");
-const http_1 = require("./http");
-const internal_1 = require("./internal");
-const security_1 = require("./security");
-/** Request JSON (com deadline/retry conforme política); lança ZihinAgentError em não-2xx. */
-async function requestJson(cfg, args) {
-    const res = await (0, http_1.requestBuffered)({
-        method: args.method,
-        url: `${cfg.baseUrl}${args.path}`,
-        headers: (0, http_1.buildHeaders)(cfg.apiKey),
-        body: args.body !== undefined ? JSON.stringify(args.body) : undefined,
-        timeoutMs: cfg.timeoutMs,
-        maxRetries: cfg.maxRetries,
-        policy: args.policy,
-        callerSignal: args.signal,
-        fetchImpl: cfg.fetchImpl,
-        onRetry: cfg.onRetry,
-    });
-    if (!res.ok) {
-        throw (0, errors_1.errorFromResponse)(res.status, (0, http_1.parseBody)(res.text), { endpoint: res.endpoint, attempts: res.attempts });
-    }
-    try {
-        return JSON.parse(res.text);
-    }
-    catch {
-        throw new errors_1.ZihinAgentError('protocol', 'Expected JSON response.', { endpoint: res.endpoint });
-    }
-}
-/**
- * Provisiona um trigger de webhook ligado a um agente. Faça isto uma vez; depois dispare
- * quantas vezes quiser com `dispatchAgent`.
- */
-async function createTrigger(cfg, params) {
-    if (!params.agentId)
-        throw new errors_1.ZihinAgentError('config', 'agentId is required.');
-    if (!params.name)
-        throw new errors_1.ZihinAgentError('config', 'name is required.');
-    const mode = params.mode ?? 'async';
-    if (mode === 'async' && !params.callbackUrl) {
-        throw new errors_1.ZihinAgentError('config', 'callbackUrl is required for async triggers.');
-    }
-    // S3: valida a callbackUrl (HTTPS + sem IP privado) antes de registrá-la no BE.
-    if (params.callbackUrl) {
-        const cb = (0, security_1.validateBaseUrl)(params.callbackUrl, { allowCustomDomains: true });
-        if (!cb.valid) {
-            throw new errors_1.ZihinAgentError('config', `Invalid callbackUrl: ${cb.error}`);
-        }
-    }
-    const execution = { mode };
-    if (params.callbackUrl) {
-        execution.callback = {
-            url: params.callbackUrl,
-            method: params.callbackMethod ?? 'POST',
-        };
-    }
-    const body = {
-        agent_id: params.agentId,
-        name: params.name,
-        trigger_type: 'webhook',
-        trigger_config: {
-            query_extraction: { mode: 'field', field: params.queryField ?? 'message' },
-            auth: { type: params.dispatchAuth ?? 'api_key' },
-            execution,
-        },
-    };
-    const json = (0, internal_1.rec)(await requestJson(cfg, { method: 'POST', path: '/api/triggers', body, policy: 'side-effecting', signal: params.signal }));
-    const data = (0, internal_1.rec)(json.data);
-    const triggerId = (0, internal_1.str)(data.id) ?? (0, internal_1.str)(json.id);
-    const webhookUrl = (0, internal_1.str)(json.webhook_url) ?? (triggerId ? `${cfg.baseUrl}/api/triggers/webhook/${triggerId}` : undefined);
-    if (!triggerId || !webhookUrl) {
-        throw new errors_1.ZihinAgentError('protocol', 'createTrigger: missing trigger id / webhook url in response.');
-    }
-    return { triggerId, webhookUrl };
-}
-/**
- * Dispara um trigger. Em modo async retorna `{ accepted, executionId }` (202);
- * em modo sync retorna também `{ agentResponse, usage }` (200).
- */
-async function dispatchAgent(cfg, params) {
-    if (!params.triggerId)
-        throw new errors_1.ZihinAgentError('config', 'triggerId is required.');
-    const res = await (0, http_1.requestBuffered)({
-        method: 'POST',
-        url: `${cfg.baseUrl}/api/triggers/webhook/${encodeURIComponent(params.triggerId)}`,
-        headers: (0, http_1.buildHeaders)(cfg.apiKey),
-        body: JSON.stringify(params.payload ?? {}),
-        timeoutMs: cfg.timeoutMs,
-        maxRetries: cfg.maxRetries,
-        policy: 'side-effecting', // S1: nunca duplica disparo por erro de rede
-        callerSignal: params.signal,
-        fetchImpl: cfg.fetchImpl,
-        onRetry: cfg.onRetry,
-    });
-    if (!res.ok) {
-        throw (0, errors_1.errorFromResponse)(res.status, (0, http_1.parseBody)(res.text), { endpoint: res.endpoint, attempts: res.attempts });
-    }
-    const json = (0, http_1.parseBody)(res.text);
-    const j = (0, internal_1.rec)(json);
-    return {
-        accepted: true,
-        triggerId: (0, internal_1.str)(j.trigger_id) ?? params.triggerId,
-        executionId: (0, internal_1.str)(j.execution_id),
-        agentResponse: (0, internal_1.str)(j.agent_response),
-        usage: (0, internal_1.parseUsage)(j.usage),
-        raw: json,
-    };
-}
-function webhookUrlFor(cfg, t) {
-    if ((0, internal_1.str)(t.webhook_url))
-        return (0, internal_1.str)(t.webhook_url);
-    const id = (0, internal_1.str)(t.id);
-    return t.trigger_type === 'webhook' && id ? `${cfg.baseUrl}/api/triggers/webhook/${id}` : undefined;
-}
-function mapTriggerInfo(cfg, raw) {
-    const t = (0, internal_1.rec)(raw);
-    return {
-        id: (0, internal_1.str)(t.id) ?? '',
-        agentId: (0, internal_1.str)(t.agent_id),
-        name: (0, internal_1.str)(t.name),
-        description: (0, internal_1.str)(t.description),
-        triggerType: (0, internal_1.str)(t.trigger_type),
-        enabled: typeof t.enabled === 'boolean' ? t.enabled : undefined,
-        triggerCount: (0, internal_1.num)(t.trigger_count),
-        lastError: (0, internal_1.str)(t.last_error),
-        webhookUrl: webhookUrlFor(cfg, t),
-    };
-}
-/** Lista os triggers do tenant (opcionalmente filtrando por agente/tipo/habilitados). */
-async function listTriggers(cfg, params = {}) {
-    const qs = new URLSearchParams();
-    if (params.agentId)
-        qs.set('agentId', params.agentId);
-    if (params.triggerType)
-        qs.set('triggerType', params.triggerType);
-    if (params.enabledOnly)
-        qs.set('enabledOnly', 'true');
-    const query = qs.toString();
-    const path = `/api/triggers${query ? `?${query}` : ''}`;
-    const json = await requestJson(cfg, { method: 'GET', path, policy: 'idempotent', signal: params.signal });
-    const list = Array.isArray(json) ? json : Array.isArray((0, internal_1.rec)(json).data) ? (0, internal_1.rec)(json).data : [];
-    return list.map((t) => mapTriggerInfo(cfg, t));
-}
-/** Obtém um trigger pelo id (inclui webhookUrl para webhooks). */
-async function getTrigger(cfg, params) {
-    if (!params.triggerId)
-        throw new errors_1.ZihinAgentError('config', 'triggerId is required.');
-    const json = await requestJson(cfg, {
-        method: 'GET',
-        path: `/api/triggers/${encodeURIComponent(params.triggerId)}`,
-        policy: 'idempotent',
-        signal: params.signal,
-    });
-    return mapTriggerInfo(cfg, (0, internal_1.rec)(json).data ?? json);
-}
-/** Remove um trigger. Requer key role admin/owner (editor NÃO pode deletar → 403). */
-async function deleteTrigger(cfg, params) {
-    if (!params.triggerId)
-        throw new errors_1.ZihinAgentError('config', 'triggerId is required.');
-    const res = await (0, http_1.requestBuffered)({
-        method: 'DELETE',
-        url: `${cfg.baseUrl}/api/triggers/${encodeURIComponent(params.triggerId)}`,
-        headers: (0, http_1.buildHeaders)(cfg.apiKey),
-        timeoutMs: cfg.timeoutMs,
-        maxRetries: cfg.maxRetries,
-        policy: 'idempotent', // DELETE é idempotente
-        callerSignal: params.signal,
-        fetchImpl: cfg.fetchImpl,
-        onRetry: cfg.onRetry,
-    });
-    if (!res.ok) {
-        throw (0, errors_1.errorFromResponse)(res.status, (0, http_1.parseBody)(res.text), { endpoint: res.endpoint, attempts: res.attempts });
-    }
-    const j = (0, internal_1.rec)((0, http_1.parseBody)(res.text));
-    return { deleted: j.deleted === true || res.status === 200 };
-}
-/**
- * Reaproveita um trigger existente do mesmo agente+nome, ou cria um novo. Evita o footgun de
- * duplicação (o BE não tem unicidade de nome). Retorna `created: false` se reusou.
- *
- * Nota: se um trigger com o mesmo nome já existe mas com config diferente (ex.: outra callbackUrl),
- * ele é REAPROVEITADO como está — atualize explicitamente com o BE se precisar reconciliar.
- */
-async function findOrCreateTrigger(cfg, params) {
-    if (!params.agentId)
-        throw new errors_1.ZihinAgentError('config', 'agentId is required.');
-    if (!params.name)
-        throw new errors_1.ZihinAgentError('config', 'name is required.');
-    const existing = await listTriggers(cfg, { agentId: params.agentId, signal: params.signal });
-    const match = existing.find((t) => t.name === params.name);
-    if (match && match.id) {
-        const webhookUrl = match.webhookUrl ?? `${cfg.baseUrl}/api/triggers/webhook/${match.id}`;
-        return { triggerId: match.id, webhookUrl, created: false };
-    }
-    const ref = await createTrigger(cfg, params);
-    return { ...ref, created: true };
-}
-/**
- * Consulta o status/resultado de uma execução disparada por trigger.
- * Útil para polling no modo async (alternativa ao callback).
- */
-async function getExecution(cfg, params) {
-    if (!params.triggerId || !params.executionId) {
-        throw new errors_1.ZihinAgentError('config', 'triggerId and executionId are required.');
-    }
-    const path = `/api/triggers/${encodeURIComponent(params.triggerId)}/executions/${encodeURIComponent(params.executionId)}`;
-    const json = (0, internal_1.rec)(await requestJson(cfg, { method: 'GET', path, policy: 'idempotent', signal: params.signal }));
-    // O BE aninha sob o envelope `data`: { success, data: { execution, metrics } }.
-    const data = (0, internal_1.rec)(json.data);
-    const exec = (0, internal_1.rec)(data.execution ?? json.execution);
-    const metrics = (0, internal_1.rec)(data.metrics ?? json.metrics);
-    return {
-        executionId: (0, internal_1.str)(exec.id) ?? params.executionId,
-        status: (0, internal_1.str)(exec.status) ?? 'unknown',
-        startedAt: (0, internal_1.str)(exec.started_at),
-        finishedAt: (0, internal_1.str)(exec.finished_at),
-        executionTimeMs: (0, internal_1.num)(exec.execution_time_ms),
-        usage: (0, internal_1.parseUsage)(metrics.usage ?? metrics) ?? (0, internal_1.parseUsage)(exec.usage),
-        result: (0, internal_1.str)(exec.agent_response) ?? (0, internal_1.str)(exec.result),
-        raw: json,
-    };
-}
-//# sourceMappingURL=triggers.js.map

package/dist/triggers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,268 +0,0 @@
-/**
- * Tipos do contrato externo Zihin — fonte de verdade verificada contra o BE
- * (zihin-agent-builder/server-llm, 2026-06-28).
- *
- * @module types
- */
-import type { ZihinAgentError } from './errors';
-export interface ZihinClientConfig {
-    /** API key `zhn_live_*` (tenant embutido). Para triggers/telemetria use role admin/editor. */
-    apiKey: string;
-    /** Base URL. Default: https://llm.zihin.ai */
-    baseUrl?: string;
-    /** Timeout por request (ms). Default: 120000 (= limite do /stream no BE). */
-    timeoutMs?: number;
-    /** Máximo de retentativas em 5xx/429/erro de rede. Default: 2. */
-    maxRetries?: number;
-    /** Permite base URL fora da whitelist Zihin (default false → SSRF guard). */
-    allowCustomBaseUrl?: boolean;
-    /** Permite http:// (apenas dev/local). Default false. */
-    allowHttp?: boolean;
-    /** Teto de bytes por evento/linha SSE (anti-DoS de memória). Default: 1MB. */
-    maxStreamEventBytes?: number;
-    /** Teto de bytes do stream inteiro (anti-DoS de memória). Default: 64MB. */
-    maxStreamTotalBytes?: number;
-    /**
-     * Implementação de `fetch` a usar. Default: `globalThis.fetch`. Injete em runtimes onde o
-     * fetch não é global (Node <18 com polyfill, testes, proxies).
-     */
-    fetch?: typeof fetch;
-    /**
-     * Observabilidade (opt-in, sem console): chamado antes de cada retentativa.
-     * Para logar backoff/timeouts/falhas transitórias em produção externa.
-     */
-    onRetry?: (info: RetryInfo) => void;
-    /** Observabilidade: chamado quando uma operação falha em definitivo (após retries). */
-    onError?: (error: ZihinAgentError) => void;
-}
-export interface RetryInfo {
-    /** "POST llm.zihin.ai/api/v2/agents/abc/stream". */
-    endpoint: string;
-    /** Número da tentativa que acabou de falhar (1 = primeira). */
-    attempt: number;
-    /** Atraso até a próxima tentativa, em ms. */
-    delayMs: number;
-    /** Motivo do retry. */
-    reason: 'status' | 'network';
-    /** Status HTTP, quando `reason === 'status'`. */
-    status?: number;
-}
-export type AttachmentType = 'image' | 'audio' | 'document';
-export interface Attachment {
-    url: string;
-    type: AttachmentType;
-}
-export interface InvokeOptions {
-    temperature?: number;
-    maxTokens?: number;
-    /** Timeout específico desta chamada (ms); sobrepõe o do cliente. */
-    timeoutMs?: number;
-    /** Just-in-time tool loading (Sprint 33). */
-    jitMode?: boolean;
-}
-export interface InvokeAgentParams {
-    /** UUID do agente (path :agent_id). */
-    agentId: string;
-    /** Mensagem ao agente. `message` OU `attachments` é obrigatório. */
-    message?: string;
-    /** Anexos multimodais. `message` OU `attachments` é obrigatório. */
-    attachments?: Attachment[];
-    /** Continuidade de conversa (Supabase agent_sessions). */
-    sessionId?: string;
-    options?: InvokeOptions;
-    metadata?: {
-        traceId?: string;
-        correlationId?: string;
-        [k: string]: unknown;
-    };
-    /** Cancelamento externo. */
-    signal?: AbortSignal;
-    /**
-     * Retém todos os eventos SSE brutos em `AgentResult.raw`. Default: false (economiza memória
-     * em runs longos). `streamAgent` sempre entrega os chunks ao vivo, independente disto.
-     */
-    includeRaw?: boolean;
-}
-export interface Usage {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-    costUsd?: number;
-}
-export interface Source {
-    title?: string;
-    url?: string;
-    [k: string]: unknown;
-}
-/**
- * Resultado final de `invokeAgent`: consolida o evento SSE `response`
- * (content/sources/session_id/blocks) com o evento `metrics` (usage/model).
- */
-export interface AgentResult {
-    content: string;
-    sessionId?: string;
-    model?: string;
-    usage?: Usage;
-    sources?: Source[];
-    /** Cards/blocos estruturados (SPEC B). */
-    blocks?: Array<{
-        type: string;
-        [k: string]: unknown;
-    }>;
-    iterations?: number;
-    executionTimeMs?: number;
-    /** Eventos SSE brutos coletados (para depuração / casos avançados). */
-    raw: AgentStreamChunk[];
-}
-/**
- * Chunk normalizado emitido por `streamAgent`. Mapeia os tipos de evento SSE do BE:
- * metadata, status, attachments, phase, thinking, tool, action_proposed, token,
- * warning, response, metrics.
- */
-export type AgentStreamChunk = {
-    type: 'metadata';
-    requestId?: string;
-    agentId?: string;
-    sessionId?: string;
-    data: unknown;
-} | {
-    type: 'status';
-    phase?: string;
-    data: unknown;
-} | {
-    type: 'attachments';
-    data: unknown;
-} | {
-    type: 'phase';
-    phase?: string;
-    data: unknown;
-} | {
-    type: 'thinking';
-    thought?: string;
-    data: unknown;
-} | {
-    type: 'tool';
-    tool?: string;
-    callId?: string;
-    success?: boolean;
-    data: unknown;
-} | {
-    type: 'action_proposed';
-    data: unknown;
-} | {
-    type: 'token';
-    content: string;
-    data: unknown;
-} | {
-    type: 'warning';
-    message?: string;
-    data: unknown;
-} | {
-    type: 'response';
-    content: string;
-    sessionId?: string;
-    sources?: Source[];
-    blocks?: Array<{
-        type: string;
-        [k: string]: unknown;
-    }>;
-    data: unknown;
-} | {
-    type: 'metrics';
-    usage?: Usage;
-    model?: string;
-    iterations?: number;
-    executionTimeMs?: number;
-    data: unknown;
-} | {
-    type: 'unknown';
-    event: string;
-    data: unknown;
-};
-export type TriggerMode = 'sync' | 'async';
-export interface CreateTriggerParams {
-    agentId: string;
-    /** Nome legível do trigger. */
-    name: string;
-    /** `async` → 202 + callback; `sync` → 200 + JSON na hora. Default: async. */
-    mode?: TriggerMode;
-    /** URL que o BE chama com o resultado (obrigatório no modo async). */
-    callbackUrl?: string;
-    /** Método HTTP do callback. Default: POST. */
-    callbackMethod?: 'POST' | 'PUT';
-    /** Campo do payload de disparo de onde sai a mensagem do agente. Default: "message". */
-    queryField?: string;
-    /** Auth de disparo aceita. Default: api_key. */
-    dispatchAuth?: 'api_key' | 'signature' | 'none';
-    signal?: AbortSignal;
-}
-export interface TriggerRef {
-    triggerId: string;
-    /** URL completa de disparo: POST {webhookUrl}. */
-    webhookUrl: string;
-}
-/** Resultado de findOrCreateTrigger: o ref + se foi recém-criado ou reaproveitado. */
-export interface FindOrCreateResult extends TriggerRef {
-    created: boolean;
-}
-/** Trigger como listado/obtido do BE. */
-export interface TriggerInfo {
-    id: string;
-    agentId?: string;
-    name?: string;
-    description?: string;
-    triggerType?: string;
-    enabled?: boolean;
-    triggerCount?: number;
-    lastError?: string;
-    /** Presente para triggers do tipo webhook. */
-    webhookUrl?: string;
-}
-export interface ListTriggersParams {
-    /** Filtra por agente. */
-    agentId?: string;
-    /** Filtra por tipo (webhook | db_event | email | schedule). */
-    triggerType?: string;
-    /** Apenas habilitados. */
-    enabledOnly?: boolean;
-    signal?: AbortSignal;
-}
-export interface GetTriggerParams {
-    triggerId: string;
-    signal?: AbortSignal;
-}
-export interface DeleteTriggerParams {
-    triggerId: string;
-    signal?: AbortSignal;
-}
-export interface DispatchAgentParams {
-    triggerId: string;
-    /** Payload entregue ao trigger (a mensagem sai do `queryField` configurado). */
-    payload: Record<string, unknown>;
-    signal?: AbortSignal;
-}
-export interface DispatchResult {
-    /** true quando o BE retorna 202 (async) ou 200 (sync). */
-    accepted: boolean;
-    triggerId?: string;
-    executionId?: string;
-    /** Presente quando o trigger é `sync`: resposta imediata do agente. */
-    agentResponse?: string;
-    usage?: Usage;
-    raw: unknown;
-}
-export interface ExecutionStatus {
-    executionId: string;
-    status: string;
-    startedAt?: string;
-    finishedAt?: string;
-    executionTimeMs?: number;
-    usage?: Usage;
-    result?: string;
-    raw: unknown;
-}
-export interface GetExecutionParams {
-    triggerId: string;
-    executionId: string;
-    signal?: AbortSignal;
-}

package/dist/types.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * Tipos do contrato externo Zihin — fonte de verdade verificada contra o BE
- * (zihin-agent-builder/server-llm, 2026-06-28).
- *
- * @module types
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}