@t4h/agent-runtime 0.0.0-stage → 0.1.0

package/dist/store/long-term.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Memória de longo prazo (Postgres): o que ele fez e o que está pendente.
+ *
+ * Caixa de entrada, itens, histórico de ações com o motivo, propostas esperando uma
+ * pessoa, correções recebidas, teto de nível do disjuntor e o lock da rodada. Tudo que
+ * precisa sobreviver de uma rodada para outra mora aqui, nunca no SQLite.
+ */
+import type { EffectiveLevel, OutcomeStatus } from '../levels.js';
+import { type EventKind, type IncomingEvent } from '../inbox.js';
+import type { Sql } from './sql.js';
+export interface ItemRow {
+    id: number;
+    agent_id: string;
+    subject: string;
+    priority: number;
+    status: string;
+    attempts: number;
+    /** Status antes de entrar na rodada: `waiting` aqui quer dizer prazo vencido. */
+    prev_status?: string;
+}
+export interface EventRow {
+    id: number;
+    type: string;
+    kind: EventKind;
+    subject: string;
+    payload: Record<string, unknown>;
+    received_at: string;
+}
+export type ActionMode = 'executed' | 'proposed' | 'shadow' | 'denied';
+export type ActionStatus = 'pending' | 'ok' | 'error' | 'approved' | 'rejected' | 'corrected';
+export interface ActionRow {
+    id: number;
+    agent_id: string;
+    item_id: number | null;
+    routine: string;
+    tool: string;
+    input: Record<string, unknown>;
+    reason: string | null;
+    mode: ActionMode;
+    status: ActionStatus;
+    level: EffectiveLevel;
+    idempotency_key: string;
+    tool_use_id: string | null;
+    result: unknown;
+    decided_by: string | null;
+    note: string | null;
+    created_at: string;
+    subject?: string | null;
+}
+export declare class LongTermStore {
+    private readonly sql;
+    constructor(sql: Sql);
+    migrate(): Promise<void>;
+    close(): Promise<void>;
+    /** Grava o evento e junta no item aberto do mesmo assunto. Repetido não entra. */
+    enqueue(agentId: string, ev: IncomingEvent, kind: EventKind): Promise<{
+        itemId: number | null;
+        duplicate: boolean;
+    }>;
+    /**
+     * Pega o próximo lote na ordem de prioridade. `SKIP LOCKED` deixa duas réplicas
+     * dividirem a fila sem pegar o mesmo item; o lock da rodada já evita isso no caso comum.
+     */
+    leaseBatch(agentId: string, limit: number): Promise<Array<ItemRow & {
+        events: EventRow[];
+    }>>;
+    /**
+     * Fecha o item. Se chegou evento novo enquanto ele estava na rodada, o item volta para
+     * a fila em vez de fechar: o evento não pode se perder.
+     */
+    finishItem(itemId: number, seenEventIds: number[], outcome: {
+        status: 'done' | 'waiting';
+        summary?: string;
+        waitUntil?: Date;
+    }): Promise<void>;
+    /** Falhou, volta: espera um pouco mais a cada tentativa; depois de N, vira exceção. */
+    failItem(itemId: number, error: string, maxAttempts: number): Promise<'retry' | 'exception'>;
+    /** Reprocessar agora, sem esperar o backoff (operação manual). */
+    retryNow(itemId: number): Promise<void>;
+    queueDepth(agentId: string): Promise<number>;
+    getItem(itemId: number): Promise<ItemRow & {
+        summary: string | null;
+        last_error: string | null;
+    }>;
+    /** Uma rodada por vez: se a anterior ainda roda (lock válido), a próxima espera. */
+    tryLock(agentId: string, holder: string, ttlSec: number): Promise<boolean>;
+    unlock(agentId: string, holder: string): Promise<void>;
+    startRound(agentId: string): Promise<number>;
+    finishRound(roundId: number, items: number, costUsd: number, error?: string): Promise<void>;
+    /** Registra a ação. `duplicate` = a mesma ação já foi feita ou proposta antes. */
+    recordAction(a: {
+        agentId: string;
+        itemId: number | null;
+        routine: string;
+        tool: string;
+        input: Record<string, unknown>;
+        reason: string | null;
+        mode: ActionMode;
+        status: ActionStatus;
+        level: EffectiveLevel;
+        idempotencyKey: string;
+        toolUseId?: string;
+        note?: string;
+    }): Promise<{
+        id: number | null;
+        duplicate: boolean;
+    }>;
+    completeAction(id: number, status: 'ok' | 'error', result: unknown): Promise<void>;
+    getAction(id: number): Promise<ActionRow | undefined>;
+    decideProposal(id: number, decision: 'approved' | 'rejected', by: string, note?: string): Promise<ActionRow | undefined>;
+    setProposalResult(id: number, status: 'ok' | 'error', result: unknown): Promise<void>;
+    /** Uma pessoa corrigiu o que ele fez. É assim que ele aprende, e conta no disjuntor. */
+    correctAction(id: number, by: string, note: string): Promise<ActionRow | undefined>;
+    executedSince(agentId: string, routine: string, since: Date): Promise<number>;
+    /** Desfechos das execuções mais recentes da rotina, mais novo primeiro. */
+    recentOutcomes(agentId: string, routine: string, n: number): Promise<OutcomeStatus[]>;
+    history(agentId: string, opts?: {
+        subject?: string;
+        status?: ActionStatus;
+        mode?: ActionMode;
+        limit?: number;
+    }): Promise<ActionRow[]>;
+    levelCaps(agentId: string): Promise<Map<string, {
+        cap: EffectiveLevel;
+        reason: string;
+    }>>;
+    setLevelCap(agentId: string, routine: string, cap: EffectiveLevel, reason: string): Promise<void>;
+    /** Volta a valer o nível do manifesto (decisão de pessoa, depois de tratar a causa). */
+    clearLevelCap(agentId: string, routine: string): Promise<void>;
+    killSwitch(agentId: string): Promise<{
+        reason: string;
+        set_by: string;
+    } | undefined>;
+    setKillSwitch(agentId: string, reason: string, by: string): Promise<void>;
+    clearKillSwitch(agentId: string): Promise<void>;
+}

package/dist/store/long-term.js

@@ -0,0 +1,206 @@
+import { PRIORITY } from '../inbox.js';
+import { MIGRATIONS } from './migrations.js';
+const num = (v) => Number(v);
+export class LongTermStore {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async migrate() {
+        await this.sql.exec(MIGRATIONS);
+    }
+    close() {
+        return this.sql.close();
+    }
+    // ── caixa de entrada ────────────────────────────────────────────────────────────
+    /** Grava o evento e junta no item aberto do mesmo assunto. Repetido não entra. */
+    async enqueue(agentId, ev, kind) {
+        return this.sql.transaction(async (tx) => {
+            if (ev.id) {
+                const seen = await tx.query('SELECT 1 FROM agent_event WHERE agent_id = $1 AND source_id = $2', [agentId, ev.id]);
+                if (seen.length)
+                    return { itemId: null, duplicate: true };
+            }
+            const [item] = await tx.query(`INSERT INTO agent_item (agent_id, subject, priority, status)
+         VALUES ($1, $2, $3, 'queued')
+         ON CONFLICT (agent_id, subject) WHERE status IN ('queued', 'working', 'waiting')
+         DO UPDATE SET
+           priority   = LEAST(agent_item.priority, EXCLUDED.priority),
+           -- resposta chegou para quem estava esperando: volta para a fila agora
+           status     = CASE WHEN agent_item.status = 'waiting' THEN 'queued' ELSE agent_item.status END,
+           not_before = CASE WHEN agent_item.status = 'waiting' THEN now() ELSE agent_item.not_before END,
+           updated_at = now()
+         RETURNING id`, [agentId, ev.subject, PRIORITY[kind]]);
+            const inserted = await tx.query(`INSERT INTO agent_event (agent_id, source_id, type, kind, subject, payload, item_id)
+         VALUES ($1, $2, $3, $4, $5, $6, $7)
+         ON CONFLICT (agent_id, source_id) WHERE source_id IS NOT NULL DO NOTHING
+         RETURNING id`, [agentId, ev.id ?? null, ev.type, kind, ev.subject, JSON.stringify(ev.payload ?? {}), item.id]);
+            if (!inserted.length)
+                return { itemId: null, duplicate: true };
+            return { itemId: num(item.id), duplicate: false };
+        });
+    }
+    /**
+     * Pega o próximo lote na ordem de prioridade. `SKIP LOCKED` deixa duas réplicas
+     * dividirem a fila sem pegar o mesmo item; o lock da rodada já evita isso no caso comum.
+     */
+    async leaseBatch(agentId, limit) {
+        const items = await this.sql.query(`WITH picked AS (
+         SELECT id, status AS prev_status FROM agent_item
+          WHERE agent_id = $1 AND status IN ('queued', 'waiting') AND not_before <= now()
+          ORDER BY priority, created_at
+          LIMIT $2
+          FOR UPDATE SKIP LOCKED
+       )
+       UPDATE agent_item i SET status = 'working', updated_at = now()
+         FROM picked WHERE i.id = picked.id
+       RETURNING i.id, i.agent_id, i.subject, i.priority, i.status, i.attempts, picked.prev_status`, [agentId, limit]);
+        if (!items.length)
+            return [];
+        const events = await this.sql.query(`SELECT id, item_id, type, kind, subject, payload, received_at FROM agent_event
+        WHERE item_id = ANY($1::bigint[]) AND processed_at IS NULL ORDER BY id`, [items.map((i) => i.id)]);
+        return items
+            .map((i) => ({ ...i, id: num(i.id), events: events.filter((e) => num(e.item_id) === num(i.id)).map((e) => ({ ...e, id: num(e.id) })) }))
+            .sort((a, b) => a.priority - b.priority || a.id - b.id);
+    }
+    /**
+     * Fecha o item. Se chegou evento novo enquanto ele estava na rodada, o item volta para
+     * a fila em vez de fechar: o evento não pode se perder.
+     */
+    async finishItem(itemId, seenEventIds, outcome) {
+        await this.sql.transaction(async (tx) => {
+            if (seenEventIds.length) {
+                await tx.query('UPDATE agent_event SET processed_at = now() WHERE id = ANY($1::bigint[])', [seenEventIds]);
+            }
+            const [{ pending }] = (await tx.query('SELECT count(*)::int AS pending FROM agent_event WHERE item_id = $1 AND processed_at IS NULL', [itemId]));
+            const status = pending > 0 ? 'queued' : outcome.status;
+            await tx.query(`UPDATE agent_item SET status = $2, summary = coalesce($3, summary), attempts = 0, last_error = NULL,
+                not_before = coalesce($4, now()), updated_at = now() WHERE id = $1`, [itemId, status, outcome.summary ?? null, outcome.status === 'waiting' ? outcome.waitUntil ?? null : null]);
+        });
+    }
+    /** Falhou, volta: espera um pouco mais a cada tentativa; depois de N, vira exceção. */
+    async failItem(itemId, error, maxAttempts) {
+        const [row] = await this.sql.query(`UPDATE agent_item SET
+         attempts   = attempts + 1,
+         last_error = $2,
+         status     = CASE WHEN attempts + 1 >= $3 THEN 'exception' ELSE 'queued' END,
+         not_before = now() + make_interval(secs => 30 * power(2, attempts)),
+         updated_at = now()
+       WHERE id = $1 RETURNING status`, [itemId, error.slice(0, 2000), maxAttempts]);
+        return row?.status === 'exception' ? 'exception' : 'retry';
+    }
+    /** Reprocessar agora, sem esperar o backoff (operação manual). */
+    async retryNow(itemId) {
+        await this.sql.query(`UPDATE agent_item SET not_before = now(), updated_at = now() WHERE id = $1 AND status = 'queued'`, [itemId]);
+    }
+    async queueDepth(agentId) {
+        const [r] = await this.sql.query(`SELECT count(*)::int AS n FROM agent_item WHERE agent_id = $1 AND status IN ('queued', 'waiting') AND not_before <= now()`, [agentId]);
+        return r?.n ?? 0;
+    }
+    async getItem(itemId) {
+        const [r] = await this.sql.query('SELECT * FROM agent_item WHERE id = $1', [itemId]);
+        if (!r)
+            throw new Error(`item ${itemId} não existe`);
+        return { ...r, id: num(r.id) };
+    }
+    // ── rodada ──────────────────────────────────────────────────────────────────────
+    /** Uma rodada por vez: se a anterior ainda roda (lock válido), a próxima espera. */
+    async tryLock(agentId, holder, ttlSec) {
+        const rows = await this.sql.query(`INSERT INTO agent_lock (agent_id, holder, until) VALUES ($1, $2, now() + make_interval(secs => $3))
+       ON CONFLICT (agent_id) DO UPDATE SET holder = EXCLUDED.holder, until = EXCLUDED.until
+         WHERE agent_lock.until < now() OR agent_lock.holder = EXCLUDED.holder
+       RETURNING agent_id`, [agentId, holder, ttlSec]);
+        return rows.length > 0;
+    }
+    async unlock(agentId, holder) {
+        await this.sql.query('DELETE FROM agent_lock WHERE agent_id = $1 AND holder = $2', [agentId, holder]);
+    }
+    async startRound(agentId) {
+        const [r] = await this.sql.query('INSERT INTO agent_round (agent_id) VALUES ($1) RETURNING id', [agentId]);
+        return num(r.id);
+    }
+    async finishRound(roundId, items, costUsd, error) {
+        await this.sql.query('UPDATE agent_round SET finished_at = now(), items = $2, cost_usd = $3, error = $4 WHERE id = $1', [roundId, items, costUsd, error ?? null]);
+    }
+    // ── ações ───────────────────────────────────────────────────────────────────────
+    /** Registra a ação. `duplicate` = a mesma ação já foi feita ou proposta antes. */
+    async recordAction(a) {
+        const rows = await this.sql.query(`INSERT INTO agent_action (agent_id, item_id, routine, tool, input, reason, mode, status, level, idempotency_key, tool_use_id, note)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
+       ON CONFLICT (agent_id, idempotency_key) WHERE mode IN ('executed', 'proposed') AND status IN ('pending', 'ok', 'approved')
+       DO NOTHING RETURNING id`, [
+            a.agentId, a.itemId, a.routine, a.tool, JSON.stringify(a.input), a.reason, a.mode, a.status, a.level,
+            a.idempotencyKey, a.toolUseId ?? null, a.note ?? null,
+        ]);
+        return rows.length ? { id: num(rows[0].id), duplicate: false } : { id: null, duplicate: true };
+    }
+    async completeAction(id, status, result) {
+        await this.sql.query('UPDATE agent_action SET status = $2, result = $3 WHERE id = $1', [id, status, JSON.stringify(result ?? null)]);
+    }
+    async getAction(id) {
+        const [r] = await this.sql.query('SELECT * FROM agent_action WHERE id = $1', [id]);
+        return r ? { ...r, id: num(r.id) } : undefined;
+    }
+    async decideProposal(id, decision, by, note) {
+        const [r] = await this.sql.query(`UPDATE agent_action SET status = $2, decided_by = $3, decided_at = now(), note = coalesce($4, note)
+        WHERE id = $1 AND mode = 'proposed' AND status = 'pending' RETURNING *`, [id, decision, by, note ?? null]);
+        return r ? { ...r, id: num(r.id) } : undefined;
+    }
+    async setProposalResult(id, status, result) {
+        // A proposta aprovada vira uma ação executada: é ela que conta no disjuntor.
+        await this.sql.query(`UPDATE agent_action SET mode = 'executed', status = $2, result = $3 WHERE id = $1`, [id, status, JSON.stringify(result ?? null)]);
+    }
+    /** Uma pessoa corrigiu o que ele fez. É assim que ele aprende, e conta no disjuntor. */
+    async correctAction(id, by, note) {
+        const [r] = await this.sql.query(`UPDATE agent_action SET status = 'corrected', decided_by = $2, decided_at = now(), note = $3
+        WHERE id = $1 AND mode = 'executed' RETURNING *`, [id, by, note]);
+        return r ? { ...r, id: num(r.id) } : undefined;
+    }
+    async executedSince(agentId, routine, since) {
+        const [r] = await this.sql.query(`SELECT count(*)::int AS n FROM agent_action
+        WHERE agent_id = $1 AND routine = $2 AND mode = 'executed' AND created_at >= $3`, [agentId, routine, since]);
+        return r?.n ?? 0;
+    }
+    /** Desfechos das execuções mais recentes da rotina, mais novo primeiro. */
+    async recentOutcomes(agentId, routine, n) {
+        const rows = await this.sql.query(`SELECT status FROM agent_action
+        WHERE agent_id = $1 AND routine = $2 AND mode = 'executed' AND status IN ('ok', 'error', 'corrected')
+        ORDER BY created_at DESC, id DESC LIMIT $3`, [agentId, routine, n]);
+        return rows.map((r) => r.status);
+    }
+    async history(agentId, opts = {}) {
+        const rows = await this.sql.query(`SELECT a.*, i.subject FROM agent_action a LEFT JOIN agent_item i ON i.id = a.item_id
+        WHERE a.agent_id = $1
+          AND ($2::text IS NULL OR i.subject = $2)
+          AND ($3::text IS NULL OR a.status = $3)
+          AND ($4::text IS NULL OR a.mode = $4)
+        ORDER BY a.created_at DESC, a.id DESC LIMIT $5`, [agentId, opts.subject ?? null, opts.status ?? null, opts.mode ?? null, opts.limit ?? 50]);
+        return rows.map((r) => ({ ...r, id: num(r.id) }));
+    }
+    // ── nível ───────────────────────────────────────────────────────────────────────
+    async levelCaps(agentId) {
+        const rows = await this.sql.query('SELECT routine, level_cap, reason FROM agent_routine_state WHERE agent_id = $1', [agentId]);
+        return new Map(rows.map((r) => [r.routine, { cap: r.level_cap, reason: r.reason }]));
+    }
+    async setLevelCap(agentId, routine, cap, reason) {
+        await this.sql.query(`INSERT INTO agent_routine_state (agent_id, routine, level_cap, reason) VALUES ($1, $2, $3, $4)
+       ON CONFLICT (agent_id, routine) DO UPDATE SET level_cap = $3, reason = $4, changed_at = now()`, [agentId, routine, cap, reason]);
+    }
+    /** Volta a valer o nível do manifesto (decisão de pessoa, depois de tratar a causa). */
+    async clearLevelCap(agentId, routine) {
+        await this.sql.query('DELETE FROM agent_routine_state WHERE agent_id = $1 AND routine = $2', [agentId, routine]);
+    }
+    // ── bloqueio de emergência ──────────────────────────────────────────────────────
+    async killSwitch(agentId) {
+        const [r] = await this.sql.query('SELECT reason, set_by FROM agent_kill_switch WHERE agent_id = $1', [agentId]);
+        return r;
+    }
+    async setKillSwitch(agentId, reason, by) {
+        await this.sql.query(`INSERT INTO agent_kill_switch (agent_id, reason, set_by) VALUES ($1, $2, $3)
+       ON CONFLICT (agent_id) DO UPDATE SET reason = $2, set_by = $3, set_at = now()`, [agentId, reason, by]);
+    }
+    async clearKillSwitch(agentId) {
+        await this.sql.query('DELETE FROM agent_kill_switch WHERE agent_id = $1', [agentId]);
+    }
+}
+//# sourceMappingURL=long-term.js.map

package/dist/store/long-term.js.map

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

package/dist/store/migrations.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tabelas da memória de longo prazo. Um banco por repositório de círculo; toda linha
+ * leva o agent_id. Idempotente: roda no boot.
+ */
+export declare const MIGRATIONS = "\nCREATE TABLE IF NOT EXISTS agent_item (\n  id          BIGSERIAL PRIMARY KEY,\n  agent_id    TEXT        NOT NULL,\n  subject     TEXT        NOT NULL,\n  priority    INT         NOT NULL,\n  -- queued: na fila | working: numa rodada | waiting: esperando resposta (not_before = prazo)\n  -- done: fechado | exception: falhou demais e foi para o DRI\n  status      TEXT        NOT NULL,\n  attempts    INT         NOT NULL DEFAULT 0,\n  not_before  TIMESTAMPTZ NOT NULL DEFAULT now(),\n  summary     TEXT,\n  last_error  TEXT,\n  created_at  TIMESTAMPTZ NOT NULL DEFAULT now(),\n  updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()\n);\n-- Um item aberto por assunto: \u00E9 isso que junta eventos do mesmo chamado num item s\u00F3.\nCREATE UNIQUE INDEX IF NOT EXISTS agent_item_open_subject\n  ON agent_item (agent_id, subject) WHERE status IN ('queued', 'working', 'waiting');\nCREATE INDEX IF NOT EXISTS agent_item_queue ON agent_item (agent_id, status, priority, not_before);\n\nCREATE TABLE IF NOT EXISTS agent_event (\n  id           BIGSERIAL PRIMARY KEY,\n  agent_id     TEXT        NOT NULL,\n  source_id    TEXT,\n  type         TEXT        NOT NULL,\n  kind         TEXT        NOT NULL,\n  subject      TEXT        NOT NULL,\n  payload      JSONB       NOT NULL DEFAULT '{}',\n  item_id      BIGINT REFERENCES agent_item(id),\n  received_at  TIMESTAMPTZ NOT NULL DEFAULT now(),\n  processed_at TIMESTAMPTZ\n);\nCREATE UNIQUE INDEX IF NOT EXISTS agent_event_dedup ON agent_event (agent_id, source_id) WHERE source_id IS NOT NULL;\nCREATE INDEX IF NOT EXISTS agent_event_item ON agent_event (item_id) WHERE processed_at IS NULL;\n\nCREATE TABLE IF NOT EXISTS agent_action (\n  id              BIGSERIAL PRIMARY KEY,\n  agent_id        TEXT        NOT NULL,\n  item_id         BIGINT,\n  routine         TEXT        NOT NULL,\n  tool            TEXT        NOT NULL,\n  input           JSONB       NOT NULL DEFAULT '{}',\n  reason          TEXT,\n  -- executed: rodou | proposed: espera uma pessoa | shadow: s\u00F3 registro | denied: barrado\n  mode            TEXT        NOT NULL,\n  -- pending | ok | error | approved | rejected | corrected\n  status          TEXT        NOT NULL,\n  level           TEXT        NOT NULL,\n  idempotency_key TEXT        NOT NULL,\n  tool_use_id     TEXT,\n  result          JSONB,\n  decided_by      TEXT,\n  decided_at      TIMESTAMPTZ,\n  note            TEXT,\n  created_at      TIMESTAMPTZ NOT NULL DEFAULT now()\n);\n-- Nada se repete: a mesma a\u00E7\u00E3o no mesmo item e rotina s\u00F3 existe uma vez enquanto viva.\nCREATE UNIQUE INDEX IF NOT EXISTS agent_action_once\n  ON agent_action (agent_id, idempotency_key)\n  WHERE mode IN ('executed', 'proposed') AND status IN ('pending', 'ok', 'approved');\nCREATE INDEX IF NOT EXISTS agent_action_routine ON agent_action (agent_id, routine, created_at DESC);\n\n-- Teto de n\u00EDvel gravado pelo disjuntor (ou por uma pessoa num incidente).\nCREATE TABLE IF NOT EXISTS agent_routine_state (\n  agent_id   TEXT NOT NULL,\n  routine    TEXT NOT NULL,\n  level_cap  TEXT NOT NULL,\n  reason     TEXT NOT NULL,\n  changed_at TIMESTAMPTZ NOT NULL DEFAULT now(),\n  PRIMARY KEY (agent_id, routine)\n);\n\n-- Uma rodada por vez por agente, entre r\u00E9plicas.\nCREATE TABLE IF NOT EXISTS agent_lock (\n  agent_id TEXT PRIMARY KEY,\n  holder   TEXT        NOT NULL,\n  until    TIMESTAMPTZ NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS agent_round (\n  id          BIGSERIAL PRIMARY KEY,\n  agent_id    TEXT        NOT NULL,\n  started_at  TIMESTAMPTZ NOT NULL DEFAULT now(),\n  finished_at TIMESTAMPTZ,\n  items       INT         NOT NULL DEFAULT 0,\n  cost_usd    NUMERIC(12, 6) NOT NULL DEFAULT 0,\n  error       TEXT\n);\n\n-- Bloqueio de emerg\u00EAncia: para tudo na hora, sem deploy. O gateway tamb\u00E9m precisa barrar\n-- a identidade; isto aqui \u00E9 o lado do runtime.\nCREATE TABLE IF NOT EXISTS agent_kill_switch (\n  agent_id   TEXT PRIMARY KEY,\n  reason     TEXT NOT NULL,\n  set_by     TEXT NOT NULL,\n  set_at     TIMESTAMPTZ NOT NULL DEFAULT now()\n);\n";

package/dist/store/migrations.js

@@ -0,0 +1,104 @@
+/**
+ * Tabelas da memória de longo prazo. Um banco por repositório de círculo; toda linha
+ * leva o agent_id. Idempotente: roda no boot.
+ */
+export const MIGRATIONS = /* sql */ `
+CREATE TABLE IF NOT EXISTS agent_item (
+  id          BIGSERIAL PRIMARY KEY,
+  agent_id    TEXT        NOT NULL,
+  subject     TEXT        NOT NULL,
+  priority    INT         NOT NULL,
+  -- queued: na fila | working: numa rodada | waiting: esperando resposta (not_before = prazo)
+  -- done: fechado | exception: falhou demais e foi para o DRI
+  status      TEXT        NOT NULL,
+  attempts    INT         NOT NULL DEFAULT 0,
+  not_before  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  summary     TEXT,
+  last_error  TEXT,
+  created_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+-- Um item aberto por assunto: é isso que junta eventos do mesmo chamado num item só.
+CREATE UNIQUE INDEX IF NOT EXISTS agent_item_open_subject
+  ON agent_item (agent_id, subject) WHERE status IN ('queued', 'working', 'waiting');
+CREATE INDEX IF NOT EXISTS agent_item_queue ON agent_item (agent_id, status, priority, not_before);
+
+CREATE TABLE IF NOT EXISTS agent_event (
+  id           BIGSERIAL PRIMARY KEY,
+  agent_id     TEXT        NOT NULL,
+  source_id    TEXT,
+  type         TEXT        NOT NULL,
+  kind         TEXT        NOT NULL,
+  subject      TEXT        NOT NULL,
+  payload      JSONB       NOT NULL DEFAULT '{}',
+  item_id      BIGINT REFERENCES agent_item(id),
+  received_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  processed_at TIMESTAMPTZ
+);
+CREATE UNIQUE INDEX IF NOT EXISTS agent_event_dedup ON agent_event (agent_id, source_id) WHERE source_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS agent_event_item ON agent_event (item_id) WHERE processed_at IS NULL;
+
+CREATE TABLE IF NOT EXISTS agent_action (
+  id              BIGSERIAL PRIMARY KEY,
+  agent_id        TEXT        NOT NULL,
+  item_id         BIGINT,
+  routine         TEXT        NOT NULL,
+  tool            TEXT        NOT NULL,
+  input           JSONB       NOT NULL DEFAULT '{}',
+  reason          TEXT,
+  -- executed: rodou | proposed: espera uma pessoa | shadow: só registro | denied: barrado
+  mode            TEXT        NOT NULL,
+  -- pending | ok | error | approved | rejected | corrected
+  status          TEXT        NOT NULL,
+  level           TEXT        NOT NULL,
+  idempotency_key TEXT        NOT NULL,
+  tool_use_id     TEXT,
+  result          JSONB,
+  decided_by      TEXT,
+  decided_at      TIMESTAMPTZ,
+  note            TEXT,
+  created_at      TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+-- Nada se repete: a mesma ação no mesmo item e rotina só existe uma vez enquanto viva.
+CREATE UNIQUE INDEX IF NOT EXISTS agent_action_once
+  ON agent_action (agent_id, idempotency_key)
+  WHERE mode IN ('executed', 'proposed') AND status IN ('pending', 'ok', 'approved');
+CREATE INDEX IF NOT EXISTS agent_action_routine ON agent_action (agent_id, routine, created_at DESC);
+
+-- Teto de nível gravado pelo disjuntor (ou por uma pessoa num incidente).
+CREATE TABLE IF NOT EXISTS agent_routine_state (
+  agent_id   TEXT NOT NULL,
+  routine    TEXT NOT NULL,
+  level_cap  TEXT NOT NULL,
+  reason     TEXT NOT NULL,
+  changed_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  PRIMARY KEY (agent_id, routine)
+);
+
+-- Uma rodada por vez por agente, entre réplicas.
+CREATE TABLE IF NOT EXISTS agent_lock (
+  agent_id TEXT PRIMARY KEY,
+  holder   TEXT        NOT NULL,
+  until    TIMESTAMPTZ NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS agent_round (
+  id          BIGSERIAL PRIMARY KEY,
+  agent_id    TEXT        NOT NULL,
+  started_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  finished_at TIMESTAMPTZ,
+  items       INT         NOT NULL DEFAULT 0,
+  cost_usd    NUMERIC(12, 6) NOT NULL DEFAULT 0,
+  error       TEXT
+);
+
+-- Bloqueio de emergência: para tudo na hora, sem deploy. O gateway também precisa barrar
+-- a identidade; isto aqui é o lado do runtime.
+CREATE TABLE IF NOT EXISTS agent_kill_switch (
+  agent_id   TEXT PRIMARY KEY,
+  reason     TEXT NOT NULL,
+  set_by     TEXT NOT NULL,
+  set_at     TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+`;
+//# sourceMappingURL=migrations.js.map

package/dist/store/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/store/migrations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGnC,CAAC"}

package/dist/store/sql.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Acesso ao Postgres por uma interface mínima, para o mesmo código rodar em produção
+ * (`pg`) e localmente ou nos testes (PGlite: Postgres de verdade, em processo, sem Docker).
+ */
+export interface Queryable {
+    query<T = Record<string, unknown>>(text: string, params?: unknown[]): Promise<T[]>;
+}
+export interface Sql extends Queryable {
+    /** Executa várias instruções sem parâmetros (migrações). */
+    exec(text: string): Promise<void>;
+    transaction<T>(fn: (tx: Queryable) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+export declare function pgSql(connectionString: string): Promise<Sql>;
+/** `dataDir` ausente = banco em memória (some ao fechar). */
+export declare function pgliteSql(dataDir?: string): Promise<Sql>;
+/** DATABASE_URL `postgres://...` usa `pg`; `pglite:<pasta>` (ou ausente) usa PGlite. */
+export declare function sqlFromUrl(url: string | undefined): Promise<Sql>;

package/dist/store/sql.js

@@ -0,0 +1,67 @@
+export async function pgSql(connectionString) {
+    const { default: pg } = await import('pg');
+    const pool = new pg.Pool({ connectionString, max: 5 });
+    return {
+        async query(text, params) {
+            const res = await pool.query(text, params);
+            return res.rows;
+        },
+        async exec(text) {
+            await pool.query(text);
+        },
+        async transaction(fn) {
+            const client = await pool.connect();
+            try {
+                await client.query('BEGIN');
+                const out = await fn({
+                    async query(text, params) {
+                        const res = await client.query(text, params);
+                        return res.rows;
+                    },
+                });
+                await client.query('COMMIT');
+                return out;
+            }
+            catch (e) {
+                await client.query('ROLLBACK');
+                throw e;
+            }
+            finally {
+                client.release();
+            }
+        },
+        close: () => pool.end(),
+    };
+}
+/** `dataDir` ausente = banco em memória (some ao fechar). */
+export async function pgliteSql(dataDir) {
+    const { PGlite } = await import('@electric-sql/pglite');
+    const db = dataDir ? new PGlite(dataDir) : new PGlite();
+    await db.waitReady;
+    return {
+        async query(text, params) {
+            const res = await db.query(text, params);
+            return res.rows;
+        },
+        async exec(text) {
+            await db.exec(text);
+        },
+        transaction(fn) {
+            return db.transaction((tx) => fn({
+                async query(text, params) {
+                    const res = await tx.query(text, params);
+                    return res.rows;
+                },
+            }));
+        },
+        close: () => db.close(),
+    };
+}
+/** DATABASE_URL `postgres://...` usa `pg`; `pglite:<pasta>` (ou ausente) usa PGlite. */
+export async function sqlFromUrl(url) {
+    if (url && /^postgres(ql)?:\/\//.test(url))
+        return pgSql(url);
+    const dir = url?.startsWith('pglite:') ? url.slice('pglite:'.length) : undefined;
+    return pgliteSql(dir || undefined);
+}
+//# sourceMappingURL=sql.js.map

package/dist/store/sql.js.map

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

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@t4h/agent-runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Runtime dos colaboradores digitais (agentes de IA) da Tech for Humans: manifesto agent.yaml, caixa de entrada de eventos, rodadas, níveis de autonomia por rotina com disjuntor, memória curta (SQLite) e longa (Postgres), e acesso aos sistemas pelo Enterprise MCP Gateway com a identidade própria do agente.",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema/agent.schema.json": "./schema/agent.schema.json"
+  },
+  "bin": {
+    "t4h-agent": "bin/t4h-agent.mjs"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.310",
+    "@electric-sql/pglite": "^0.5.11",
+    "ajv": "^8.20.0",
+    "croner": "^10.0.1",
+    "pg": "^8.23.1",
+    "yaml": "^2.9.1",
+    "zod": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "@types/pg": "^8.15.0",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.7",
+    "tsx": "^4.19.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}