agentcorp-broker 0.1.0-alpha.1

package/dist/audit.js

@@ -0,0 +1,203 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { DEFAULT_AUDIT_LIMIT, MAX_AUDIT_LIMIT, parseLimit } from "./database.js";
+import { DEFAULT_MAX_AUDIT_PAYLOAD_BYTES, } from "./types.js";
+export function generateAuditSnapshot(broker, options = {}) {
+    const db = broker.database;
+    const boundRoles = new Map(db.listAllRoleBindings().map((b) => [b.roleId, b.agentId]));
+    const roles = broker.config.roles.map((role) => ({
+        id: role.id,
+        model: role.model,
+        capabilities: role.capabilities,
+        allowedPeers: role.allowed_peers,
+        boundAgent: boundRoles.get(role.id),
+    }));
+    const totalTasksAvailable = db.countTasks();
+    const totalMessagesAvailable = db.countMessages();
+    const totalApprovalsAvailable = db.countApprovals();
+    const totalArtifactsAvailable = db.countArtifacts();
+    const matchingTasksCount = db.countAuditTasks(options);
+    const matchingMessagesCount = db.countAuditMessages(options);
+    const matchingApprovalsCount = db.countAuditApprovals(options);
+    const matchingArtifactsCount = db.countAuditArtifacts(options);
+    const effectiveLimit = parseLimit(options.limit, DEFAULT_AUDIT_LIMIT, MAX_AUDIT_LIMIT);
+    const effectiveMaxPayloadBytes = options.maxPayloadBytes !== undefined
+        ? options.maxPayloadBytes
+        : (broker.config.limits?.max_audit_payload_bytes ?? DEFAULT_MAX_AUDIT_PAYLOAD_BYTES);
+    const exportOptions = {
+        ...options,
+        limit: effectiveLimit,
+        maxPayloadBytes: effectiveMaxPayloadBytes,
+    };
+    const tasks = db.getAuditTasks(exportOptions);
+    const messages = db.getAuditMessages(exportOptions);
+    const approvals = db.getAuditApprovals(exportOptions);
+    const artifacts = db.getAuditArtifacts(exportOptions);
+    const rowLimitTruncated = Boolean(tasks.length < matchingTasksCount ||
+        messages.length < matchingMessagesCount ||
+        approvals.length < matchingApprovalsCount ||
+        artifacts.length < matchingArtifactsCount);
+    const truncated = rowLimitTruncated;
+    let clippedTasksCount = 0;
+    for (const t of tasks) {
+        if (t.descriptionClipped === true) {
+            clippedTasksCount++;
+        }
+    }
+    let clippedMessagesCount = 0;
+    for (const m of messages) {
+        if (typeof m.payload === "object" && m.payload !== null && m.payload._truncated === true) {
+            clippedMessagesCount++;
+        }
+    }
+    let clippedApprovalsCount = 0;
+    for (const a of approvals) {
+        if (typeof a.context === "object" && a.context !== null && a.context._truncated === true) {
+            clippedApprovalsCount++;
+        }
+    }
+    let clippedArtifactsCount = 0;
+    for (const art of artifacts) {
+        if (art.contentClipped === true) {
+            clippedArtifactsCount++;
+        }
+    }
+    const fieldClippingActive = (clippedTasksCount + clippedMessagesCount + clippedApprovalsCount + clippedArtifactsCount) > 0;
+    const metadata = {
+        generatedAt: new Date().toISOString(),
+        ...(options.since ? { since: options.since } : {}),
+        limit: effectiveLimit,
+        maxPayloadBytes: effectiveMaxPayloadBytes,
+        totalTasksAvailable,
+        totalMessagesAvailable,
+        totalApprovalsAvailable,
+        totalArtifactsAvailable,
+        matchingTasksCount,
+        matchingMessagesCount,
+        matchingApprovalsCount,
+        matchingArtifactsCount,
+        truncated,
+        rowLimitTruncated,
+        fieldClippingActive,
+        fieldClippedRecordsCount: {
+            tasks: clippedTasksCount,
+            messages: clippedMessagesCount,
+            approvals: clippedApprovalsCount,
+            artifacts: clippedArtifactsCount,
+        },
+    };
+    return {
+        exportedAt: metadata.generatedAt,
+        company: broker.config.company.name,
+        metadata,
+        roles,
+        tasks,
+        messages,
+        approvals,
+        artifacts,
+    };
+}
+export function formatAuditMarkdown(snapshot) {
+    const lines = [];
+    lines.push(`# AgentCorp Audit Log — ${snapshot.company}`);
+    lines.push(`\n**Exported At:** \`${snapshot.exportedAt}\``);
+    if (snapshot.metadata?.since) {
+        lines.push(`**Since:** \`${snapshot.metadata.since}\``);
+    }
+    if (snapshot.metadata?.limit !== undefined) {
+        lines.push(`**Record Limit:** \`${snapshot.metadata.limit}\``);
+    }
+    lines.push(`**Row Limit Truncated:** \`${snapshot.metadata?.rowLimitTruncated ? "Yes" : "No"}\``);
+    if (snapshot.metadata?.maxPayloadBytes !== undefined) {
+        lines.push(`**Max Payload Bytes:** \`${snapshot.metadata.maxPayloadBytes}\``);
+    }
+    lines.push(`**Field Clipping Active:** \`${snapshot.metadata?.fieldClippingActive ? "Yes" : "No"}\``);
+    lines.push(`**Truncated:** \`${snapshot.metadata?.truncated ? "Yes" : "No"}\`\n`);
+    lines.push("## Active Roles & Bindings\n");
+    lines.push("| Role ID | Bound Agent | Allowed Peers | Capabilities |");
+    lines.push("| --- | --- | --- | --- |");
+    for (const role of snapshot.roles) {
+        lines.push(`| \`${role.id}\` | ${role.boundAgent ? `\`${role.boundAgent}\`` : "*unbound*"} | ${role.allowedPeers.map((p) => `\`${p}\``).join(", ") || "*none*"} | ${role.capabilities.join(", ") || "*none*"} |`);
+    }
+    lines.push("");
+    lines.push("## Tasks & Lifecycle\n");
+    if (snapshot.tasks.length === 0) {
+        lines.push("*No tasks recorded.* \n");
+    }
+    else {
+        for (const task of snapshot.tasks) {
+            lines.push(`### Task: ${task.title} (\`${task.taskId}\`)`);
+            lines.push(`- **Status:** \`${task.status}\``);
+            lines.push(`- **Created By:** \`${task.createdBy}\` | **Assigned To:** \`${task.assignedTo ?? "unassigned"}\``);
+            lines.push(`- **Created At:** ${task.createdAt} | **Updated At:** ${task.updatedAt}`);
+            if (task.description) {
+                lines.push(`- **Description:** ${task.description}`);
+            }
+            const taskMessages = snapshot.messages.filter((m) => m.taskId === task.taskId);
+            if (taskMessages.length > 0) {
+                lines.push("\n**Message Thread:**\n");
+                lines.push("| Time | From → To | Type | Status | Payload / Summary |");
+                lines.push("| --- | --- | --- | --- | --- |");
+                for (const msg of taskMessages) {
+                    const payloadStr = typeof msg.payload === "string"
+                        ? msg.payload
+                        : JSON.stringify(msg.payload);
+                    const sanitizedPayload = payloadStr.replace(/\|/g, "\\|").replace(/\n/g, " ");
+                    lines.push(`| ${msg.createdAt} | \`${msg.fromRole}\` → \`${msg.toRole}\` | \`${msg.type}\` | \`${msg.status}\` | ${sanitizedPayload} |`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    const outOfBandMessages = snapshot.messages.filter((m) => !m.taskId);
+    if (outOfBandMessages.length > 0) {
+        lines.push("## Direct / Out-of-Band Messages\n");
+        lines.push("| Time | From → To | Type | Status | Payload |");
+        lines.push("| --- | --- | --- | --- | --- |");
+        for (const msg of outOfBandMessages) {
+            const payloadStr = typeof msg.payload === "string"
+                ? msg.payload
+                : JSON.stringify(msg.payload);
+            lines.push(`| ${msg.createdAt} | \`${msg.fromRole}\` → \`${msg.toRole}\` | \`${msg.type}\` | \`${msg.status}\` | ${payloadStr} |`);
+        }
+        lines.push("");
+    }
+    lines.push("## Approvals\n");
+    if (snapshot.approvals.length === 0) {
+        lines.push("*No approvals recorded.* \n");
+    }
+    else {
+        lines.push("| Approval ID | Subject | Subject ID | Requested By | Status | Decided At | Note |");
+        lines.push("| --- | --- | --- | --- | --- | --- | --- |");
+        for (const app of snapshot.approvals) {
+            lines.push(`| \`${app.approvalId}\` | \`${app.subject}\` | \`${app.subjectId}\` | \`${app.requestedBy}\` | \`${app.status}\` | ${app.decidedAt ?? "*pending*"} | ${app.decisionNote ?? "-"} |`);
+        }
+        lines.push("");
+    }
+    lines.push("## Artifacts Catalog\n");
+    if (snapshot.artifacts.length === 0) {
+        lines.push("*No artifacts recorded.* \n");
+    }
+    else {
+        lines.push("| Artifact ID | Name | Type | Produced By | Visibility | Hash |");
+        lines.push("| --- | --- | --- | --- | --- | --- |");
+        for (const art of snapshot.artifacts) {
+            const vis = art.visibleToRoles === "all" ? "all" : art.visibleToRoles.join(", ");
+            lines.push(`| \`${art.artifactId}\` | ${art.name} | \`${art.type}\` | \`${art.producedBy}\` | \`${vis}\` | \`${art.contentHash.slice(0, 12)}...\` |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function exportAuditTrail(broker, outputDir = "coord", options = {}) {
+    const absoluteDir = resolve(outputDir);
+    mkdirSync(absoluteDir, { recursive: true });
+    const snapshot = generateAuditSnapshot(broker, options);
+    const markdown = formatAuditMarkdown(snapshot);
+    const markdownPath = resolve(absoluteDir, "audit.md");
+    const jsonPath = resolve(absoluteDir, "audit.json");
+    writeFileSync(markdownPath, markdown, "utf8");
+    writeFileSync(jsonPath, JSON.stringify(snapshot, null, 2), "utf8");
+    return { markdownPath, jsonPath, snapshot };
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/broker.d.ts

@@ -0,0 +1,103 @@
+import { EventEmitter } from "node:events";
+import { AgentCorpDatabase } from "./database.js";
+import { type ArtifactRecord, type BrokerLimits, type IdempotencyRecord, type InitialPolicy, type MessageRecord, type MessageType, type OrgConfig, type PaginatedResult, type PaginationOptions, type PendingApproval, type PolicyRule, type PruneOptions, type PruneResult, type RoleDefinition, type RoleWorkQueue, type TaskRecord, type TaskStatus } from "./types.js";
+export type BrokerEventType = "message_created" | "message_status_changed" | "task_created" | "task_status_changed" | "approval_created" | "approval_resolved" | "policy_saved" | "policy_toggled" | "artifact_created" | "role_registered" | "history_pruned";
+export interface BrokerDomainEvent {
+    type: BrokerEventType;
+    data: unknown;
+    timestamp: string;
+}
+export interface SendMessageInput {
+    toRole: string;
+    type: MessageType;
+    payload: unknown;
+    taskId?: string;
+    references?: string[];
+    riskTags?: string[];
+    inReplyTo?: string;
+    idempotencyKey?: string;
+}
+export interface CreateTaskInput {
+    title: string;
+    description?: string;
+    assignedTo?: string;
+    idempotencyKey?: string;
+}
+export interface CreateArtifactInput {
+    type: string;
+    name: string;
+    content?: string;
+    contentUri?: string;
+    visibleToRoles?: "all" | string[];
+    relatedTaskId?: string;
+    idempotencyKey?: string;
+}
+export declare const DEFAULT_MAX_PAYLOAD_SIZE_BYTES: number;
+export declare const DEFAULT_MAX_ARTIFACT_SIZE_BYTES: number;
+export interface BrokerOptions {
+    now?: () => Date;
+    id?: (prefix: string) => string;
+    limits?: BrokerLimits;
+}
+export declare class AgentCorpBroker extends EventEmitter {
+    readonly config: OrgConfig;
+    readonly database: AgentCorpDatabase;
+    readonly maxPayloadSizeBytes: number;
+    readonly maxArtifactSizeBytes: number;
+    private readonly roles;
+    private readonly now;
+    private readonly id;
+    constructor(config: OrgConfig, database: AgentCorpDatabase, options?: BrokerOptions);
+    private emitDomainEvent;
+    private timestamp;
+    private role;
+    touchPresence(callerRole: string): void;
+    private executeIdempotent;
+    getOperation(callerRole: string, key: string): IdempotencyRecord | undefined;
+    private seedPolicies;
+    getRole(roleId: string): RoleDefinition;
+    registerRole(roleId: string, agentId: string, declaredCapabilities: string[]): RoleDefinition;
+    createTask(callerRole: string, input: CreateTaskInput): TaskRecord;
+    listTasksPaginated(callerRole: string, options?: PaginationOptions): PaginatedResult<TaskRecord>;
+    listTasks(callerRole: string, options?: PaginationOptions): TaskRecord[];
+    sendMessage(callerRole: string, input: SendMessageInput): MessageRecord;
+    getInboxPaginated(callerRole: string, options?: PaginationOptions): PaginatedResult<MessageRecord>;
+    getInbox(callerRole: string, options?: PaginationOptions): MessageRecord[];
+    getWorkQueue(callerRole: string): RoleWorkQueue;
+    acknowledgeMessage(callerRole: string, messageId: string): MessageRecord;
+    acceptHandoff(callerRole: string, messageId: string, idempotencyKey?: string): {
+        message: MessageRecord;
+        task: TaskRecord;
+        pendingApproval: boolean;
+    };
+    getThreadPaginated(callerRole: string, taskId: string, options?: PaginationOptions): PaginatedResult<MessageRecord>;
+    getThread(callerRole: string, taskId: string, options?: PaginationOptions): MessageRecord[];
+    createArtifact(callerRole: string, input: CreateArtifactInput): ArtifactRecord;
+    private hasRemainingVisibleArtifact;
+    listArtifactsPaginated(callerRole: string, taskIdOrOptions?: string | PaginationOptions, maybeOptions?: PaginationOptions): PaginatedResult<ArtifactRecord>;
+    listArtifacts(callerRole: string, taskIdOrOptions?: string | PaginationOptions, maybeOptions?: PaginationOptions): ArtifactRecord[];
+    getArtifact(callerRole: string, artifactId: string): ArtifactRecord;
+    updateTaskStatus(callerRole: string, taskId: string, requestedStatus: TaskStatus, riskTags?: string[], idempotencyKey?: string): {
+        task: TaskRecord;
+        pendingApproval: boolean;
+    };
+    listPendingApprovals(): PendingApproval[];
+    approve(approvalId: string, note?: string, editedPayload?: unknown): PendingApproval;
+    reject(approvalId: string, note?: string): PendingApproval;
+    listPolicies(): PolicyRule[];
+    savePolicy(input: InitialPolicy): PolicyRule;
+    setPolicyEnabled(policyId: string, enabled: boolean): PolicyRule;
+    private assertRoute;
+    private assertTaskParticipant;
+    private assignTaskForApprovedProposal;
+    prune(options: PruneOptions): PruneResult;
+    checkpointAndCompact(): {
+        checkpoint: string;
+        busy: boolean;
+        logPages: number;
+        checkpointedPages: number;
+        vacuumed: boolean;
+    };
+    private canSeeArtifact;
+    private assertArtifactVisible;
+}