reflectt-node 0.1.8 → 0.1.11

package/dist/agent-messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messaging.d.ts","sourceRoot":"","sources":["../src/agent-messaging.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AA8BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,GAAG,YAAY,CAaf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,YAAY,EAAE,CAsBjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAIhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAY/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,EAAE,CAW9G"}

package/dist/agent-messaging.js

@@ -0,0 +1,103 @@
+// SPDX-License-Identifier: Apache-2.0
+// Host-native agent-to-agent messaging — replaces gateway for local agents
+import { getDb } from './db.js';
+function rowToMessage(row) {
+    return {
+        id: row.id,
+        fromAgent: row.from_agent,
+        toAgent: row.to_agent,
+        channel: row.channel,
+        content: row.content,
+        metadata: JSON.parse(row.metadata || '{}'),
+        readAt: row.read_at,
+        createdAt: row.created_at,
+    };
+}
+function generateId() {
+    return `amsg-${Date.now()}-${Math.random().toString(36).slice(2, 13)}`;
+}
+/**
+ * Send a message from one agent to another (or to a channel).
+ */
+export function sendAgentMessage(opts) {
+    const db = getDb();
+    const id = generateId();
+    const now = Date.now();
+    const channel = opts.channel ?? 'direct';
+    const metadata = opts.metadata ?? {};
+    db.prepare(`
+    INSERT INTO agent_messages (id, from_agent, to_agent, channel, content, metadata, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(id, opts.fromAgent, opts.toAgent, channel, opts.content, JSON.stringify(metadata), now);
+    return { id, fromAgent: opts.fromAgent, toAgent: opts.toAgent, channel, content: opts.content, metadata, readAt: null, createdAt: now };
+}
+/**
+ * List messages for an agent (inbox).
+ */
+export function listAgentMessages(opts) {
+    const db = getDb();
+    const conditions = ['to_agent = ?'];
+    const params = [opts.agentId];
+    if (opts.channel) {
+        conditions.push('channel = ?');
+        params.push(opts.channel);
+    }
+    if (opts.unreadOnly) {
+        conditions.push('read_at IS NULL');
+    }
+    if (opts.since) {
+        conditions.push('created_at >= ?');
+        params.push(opts.since);
+    }
+    const limit = opts.limit ?? 50;
+    const sql = `SELECT * FROM agent_messages WHERE ${conditions.join(' AND ')} ORDER BY created_at DESC LIMIT ?`;
+    params.push(limit);
+    return db.prepare(sql).all(...params).map(rowToMessage);
+}
+/**
+ * List messages sent by an agent (outbox).
+ */
+export function listSentMessages(agentId, limit) {
+    const db = getDb();
+    return db.prepare('SELECT * FROM agent_messages WHERE from_agent = ? ORDER BY created_at DESC LIMIT ?')
+        .all(agentId, limit ?? 50).map(rowToMessage);
+}
+/**
+ * Mark messages as read.
+ */
+export function markMessagesRead(agentId, messageIds) {
+    const db = getDb();
+    const now = Date.now();
+    if (messageIds && messageIds.length > 0) {
+        const placeholders = messageIds.map(() => '?').join(',');
+        const result = db.prepare(`UPDATE agent_messages SET read_at = ? WHERE to_agent = ? AND id IN (${placeholders}) AND read_at IS NULL`)
+            .run(now, agentId, ...messageIds);
+        return result.changes;
+    }
+    // Mark all unread
+    const result = db.prepare('UPDATE agent_messages SET read_at = ? WHERE to_agent = ? AND read_at IS NULL').run(now, agentId);
+    return result.changes;
+}
+/**
+ * Get unread count for an agent.
+ */
+export function getUnreadCount(agentId) {
+    const db = getDb();
+    return db.prepare('SELECT COUNT(*) as c FROM agent_messages WHERE to_agent = ? AND read_at IS NULL').get(agentId).c;
+}
+/**
+ * List messages in a channel (broadcast/topic).
+ */
+export function listChannelMessages(channel, opts) {
+    const db = getDb();
+    const conditions = ['channel = ?'];
+    const params = [channel];
+    if (opts?.since) {
+        conditions.push('created_at >= ?');
+        params.push(opts.since);
+    }
+    const limit = opts?.limit ?? 50;
+    return db.prepare(`SELECT * FROM agent_messages WHERE ${conditions.join(' AND ')} ORDER BY created_at DESC LIMIT ?`)
+        .all(...params, limit).map(rowToMessage);
+}
+//# sourceMappingURL=agent-messaging.js.map

package/dist/agent-messaging.js.map

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

package/dist/agent-messaging.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-messaging.test.d.ts.map

package/dist/agent-messaging.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messaging.test.d.ts","sourceRoot":"","sources":["../src/agent-messaging.test.ts"],"names":[],"mappings":""}

package/dist/agent-messaging.test.js

@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+class InMemoryMessageStore {
+    messages = [];
+    counter = 0;
+    send(from, to, content, channel = 'direct') {
+        const msg = { id: `amsg-${++this.counter}`, from, to, channel, content, readAt: null };
+        this.messages.push(msg);
+        return msg;
+    }
+    inbox(agentId, opts) {
+        let result = this.messages.filter(m => m.to === agentId);
+        if (opts?.unreadOnly)
+            result = result.filter(m => m.readAt === null);
+        if (opts?.channel)
+            result = result.filter(m => m.channel === opts.channel);
+        return result;
+    }
+    sent(agentId) {
+        return this.messages.filter(m => m.from === agentId);
+    }
+    markRead(agentId, ids) {
+        let count = 0;
+        for (const m of this.messages) {
+            if (m.to !== agentId || m.readAt !== null)
+                continue;
+            if (!ids || ids.includes(m.id)) {
+                m.readAt = Date.now();
+                count++;
+            }
+        }
+        return count;
+    }
+    unreadCount(agentId) {
+        return this.messages.filter(m => m.to === agentId && m.readAt === null).length;
+    }
+    channel(ch) {
+        return this.messages.filter(m => m.channel === ch);
+    }
+    clear() { this.messages = []; this.counter = 0; }
+}
+describe('agent messaging', () => {
+    let store;
+    beforeEach(() => { store = new InMemoryMessageStore(); });
+    it('sends a direct message', () => {
+        const msg = store.send('link', 'kai', 'PR #879 ready for review');
+        assert.equal(msg.from, 'link');
+        assert.equal(msg.to, 'kai');
+        assert.equal(msg.channel, 'direct');
+        assert.equal(msg.readAt, null);
+    });
+    it('shows in recipient inbox', () => {
+        store.send('link', 'kai', 'Hello');
+        const inbox = store.inbox('kai');
+        assert.equal(inbox.length, 1);
+        assert.equal(inbox[0].content, 'Hello');
+    });
+    it('does not show in sender inbox', () => {
+        store.send('link', 'kai', 'Hello');
+        assert.equal(store.inbox('link').length, 0);
+    });
+    it('shows in sender sent', () => {
+        store.send('link', 'kai', 'Hello');
+        assert.equal(store.sent('link').length, 1);
+    });
+    it('tracks unread count', () => {
+        store.send('link', 'kai', 'msg1');
+        store.send('pixel', 'kai', 'msg2');
+        assert.equal(store.unreadCount('kai'), 2);
+    });
+    it('marks specific messages read', () => {
+        const m1 = store.send('link', 'kai', 'msg1');
+        store.send('pixel', 'kai', 'msg2');
+        store.markRead('kai', [m1.id]);
+        assert.equal(store.unreadCount('kai'), 1);
+    });
+    it('marks all messages read', () => {
+        store.send('link', 'kai', 'msg1');
+        store.send('pixel', 'kai', 'msg2');
+        store.markRead('kai');
+        assert.equal(store.unreadCount('kai'), 0);
+    });
+    it('filters unread only', () => {
+        store.send('link', 'kai', 'msg1');
+        const m2 = store.send('pixel', 'kai', 'msg2');
+        store.markRead('kai', [m2.id]);
+        const unread = store.inbox('kai', { unreadOnly: true });
+        assert.equal(unread.length, 1);
+    });
+    it('supports channel messages', () => {
+        store.send('link', 'team', 'broadcast', 'shipping');
+        store.send('pixel', 'team', 'design update', 'shipping');
+        store.send('kai', 'team', 'ops note', 'general');
+        assert.equal(store.channel('shipping').length, 2);
+        assert.equal(store.channel('general').length, 1);
+    });
+    it('filters inbox by channel', () => {
+        store.send('link', 'kai', 'direct msg');
+        store.send('link', 'kai', 'channel msg', 'reviews');
+        assert.equal(store.inbox('kai', { channel: 'reviews' }).length, 1);
+        assert.equal(store.inbox('kai', { channel: 'direct' }).length, 1);
+    });
+});
+//# sourceMappingURL=agent-messaging.test.js.map

package/dist/agent-messaging.test.js.map

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

package/dist/agent-runs.d.ts

@@ -0,0 +1,158 @@
+export type AgentRunStatus = 'idle' | 'working' | 'blocked' | 'waiting_review' | 'completed' | 'failed' | 'cancelled';
+export declare const VALID_RUN_STATUSES: AgentRunStatus[];
+export declare const VALID_EVENT_TYPES: readonly ["run_created", "task_attached", "tool_invoked", "artifact_produced", "review_requested", "review_approved", "review_rejected", "blocked", "handed_off", "completed", "failed"];
+export type AgentEventType = (typeof VALID_EVENT_TYPES)[number];
+export interface AgentRun {
+    id: string;
+    agentId: string;
+    teamId: string;
+    objective: string;
+    status: AgentRunStatus;
+    parentRunId: string | null;
+    contextSnapshot: Record<string, unknown>;
+    artifacts: Array<Record<string, unknown>>;
+    startedAt: number;
+    updatedAt: number;
+    completedAt: number | null;
+}
+export interface EventRationale {
+    choice: string;
+    considered?: string[];
+    constraint?: string;
+}
+export interface AgentEvent {
+    id: string;
+    runId: string | null;
+    agentId: string;
+    eventType: AgentEventType;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export declare function validateRationale(rationale: unknown): EventRationale;
+export declare function createAgentRun(agentId: string, teamId: string, objective: string, opts?: {
+    taskId?: string;
+    parentRunId?: string;
+}): AgentRun;
+export declare function updateAgentRun(runId: string, updates: {
+    status?: AgentRunStatus;
+    contextSnapshot?: Record<string, unknown>;
+    artifacts?: Array<Record<string, unknown>>;
+    completedAt?: number;
+}): AgentRun | null;
+export declare function getAgentRun(runId: string): AgentRun | null;
+export declare function getActiveAgentRun(agentId: string, teamId: string): AgentRun | null;
+export declare function listAgentRuns(agentId: string, teamId: string, opts?: {
+    status?: AgentRunStatus;
+    limit?: number;
+}): AgentRun[];
+export interface RoutingValidation {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate routing semantics for actionable events.
+ * Enforces: action_required, urgency, owner required.
+ * Optional: expires_at.
+ */
+export declare function validateRoutingSemantics(eventType: string, payload: Record<string, unknown>): RoutingValidation;
+export declare function appendAgentEvent(event: {
+    agentId: string;
+    runId?: string | null;
+    eventType: string;
+    payload?: Record<string, unknown>;
+    enforceRouting?: boolean;
+}): AgentEvent;
+export declare function listAgentEvents(opts: {
+    agentId?: string;
+    runId?: string;
+    eventType?: string;
+    since?: number;
+    limit?: number;
+}): AgentEvent[];
+export interface RetentionPolicy {
+    maxAgeDays: number;
+    maxCompletedRuns: number;
+    deleteArchived: boolean;
+}
+export interface RetentionResult {
+    archived: number;
+    deleted: number;
+    eventsDeleted: number;
+    dryRun: boolean;
+}
+/**
+ * Archive old completed/cancelled/failed runs per retention policy.
+ * Returns count of runs archived and events cleaned up.
+ */
+export declare function applyRunRetention(opts?: {
+    policy?: Partial<RetentionPolicy>;
+    agentId?: string;
+    dryRun?: boolean;
+}): RetentionResult;
+/**
+ * Get retention stats — how many runs would be affected by current policy.
+ */
+export declare function getRetentionStats(policy?: Partial<RetentionPolicy>): {
+    totalRuns: number;
+    terminalRuns: number;
+    wouldArchive: number;
+    oldestRunAge: number | null;
+};
+export interface PendingApproval {
+    event: AgentEvent;
+    agentId: string;
+    runId: string | null;
+    urgency: string | null;
+    owner: string | null;
+    expiresAt: number | null;
+}
+/**
+ * List pending approvals: review_requested events with action_required
+ * that don't yet have a matching review_approved or review_rejected.
+ */
+export declare function listPendingApprovals(opts?: {
+    agentId?: string;
+    limit?: number;
+}): PendingApproval[];
+/**
+ * Submit an approval decision. Records a review_approved or review_rejected event
+ * and optionally unblocks the associated run.
+ */
+/**
+ * Dedicated approval queue — unified view of everything needing human decision.
+ * Covers review_requested (PR reviews) AND approval_requested (agent actions like deploy/execute).
+ * Each item answers: what needs decision, who owns it, when it expires, what happens if ignored.
+ */
+export interface ApprovalQueueItem {
+    id: string;
+    category: 'review' | 'agent_action';
+    event: AgentEvent;
+    agentId: string;
+    runId: string | null;
+    title: string;
+    description: string | null;
+    urgency: string | null;
+    owner: string | null;
+    expiresAt: number | null;
+    autoAction: string | null;
+    createdAt: number;
+    isExpired: boolean;
+}
+export declare function listApprovalQueue(opts?: {
+    agentId?: string;
+    category?: 'review' | 'agent_action';
+    includeExpired?: boolean;
+    limit?: number;
+}): ApprovalQueueItem[];
+export declare function submitApprovalDecision(opts: {
+    eventId: string;
+    decision: 'approve' | 'reject';
+    reviewer: string;
+    comment?: string;
+    rationale?: EventRationale;
+}): {
+    event: AgentEvent;
+    runUnblocked: boolean;
+};
+//# sourceMappingURL=agent-runs.d.ts.map

package/dist/agent-runs.d.ts.map

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