syncpoint-ai 0.1.0

package/dist/mcp/tools/agent-message.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { msgSend, msgRead, msgReply, msgList, msgThread, } from "../../server/application/index.js";
+import { fail, ok } from "./_shared.js";
+export function registerAgentMessageTools(server) {
+    // Agent Message Tools
+    // ═══════════════════════════════════════════════════════
+    server.registerTool("syncpoint_message_send", {
+        title: "Send Message",
+        description: "Send a message to another agent. Use kind='request' for messages that require a response (with optional timeout).",
+        inputSchema: {
+            fromAgent: z.string().describe("Sender agent ID"),
+            toAgent: z.string().describe("Recipient agent ID"),
+            kind: z.enum(["message", "request", "response"]).default("message").describe("Message kind: plain message, request (expects response), or response"),
+            subject: z.string().default("").describe("Subject line"),
+            body: z.string().default("").describe("Message body"),
+            expiresAt: z.string().nullable().default(null).describe("ISO timestamp when request expires (only for kind=request)"),
+        },
+    }, async (input) => {
+        try {
+            const msg = msgSend({ ...input, kind: input.kind });
+            return ok({ id: msg.id, kind: msg.kind, requestStatus: msg.requestStatus });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_message_list", {
+        title: "List Messages",
+        description: "List messages with optional filters. Commonly used to check unread messages for an agent.",
+        inputSchema: {
+            toAgent: z.string().optional().describe("Filter by recipient agent ID"),
+            fromAgent: z.string().optional().describe("Filter by sender agent ID"),
+            unreadOnly: z.boolean().optional().describe("Only show unread messages"),
+            kind: z.enum(["message", "request", "response"]).optional().describe("Filter by message kind"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (default 50)"),
+        },
+    }, async (input) => {
+        try {
+            const messages = msgList({ ...input, kind: input.kind });
+            return ok({ count: messages.length, messages });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_message_read", {
+        title: "Read Message",
+        description: "Mark a message as read. Only the recipient agent can mark a message as read.",
+        inputSchema: {
+            messageId: z.string().describe("Message ID to mark as read"),
+            agentId: z.string().describe("Agent ID (must be the recipient)"),
+        },
+    }, async ({ messageId, agentId }) => {
+        try {
+            const msg = msgRead(messageId, agentId);
+            return ok({ id: msg.id, readStatus: msg.readStatus, readAt: msg.readAt });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_message_reply", {
+        title: "Reply to Message",
+        description: "Reply to a message. Creates a response message in the same thread. If replying to a request, transitions the request to RESPONDED.",
+        inputSchema: {
+            messageId: z.string().describe("Message ID to reply to"),
+            agentId: z.string().describe("Agent ID (must be the recipient of the original message)"),
+            body: z.string().describe("Reply body"),
+        },
+    }, async ({ messageId, agentId, body }) => {
+        try {
+            const response = msgReply(messageId, agentId, body);
+            return ok({ id: response.id, threadRootId: response.threadRootId, replyToMessageId: response.replyToMessageId });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_message_thread", {
+        title: "View Message Thread",
+        description: "View all messages in a thread, ordered chronologically.",
+        inputSchema: {
+            threadRootId: z.string().describe("Thread root message ID"),
+        },
+    }, async ({ threadRootId }) => {
+        try {
+            const messages = msgThread(threadRootId);
+            return ok({ count: messages.length, messages });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+}
+//# sourceMappingURL=agent-message.js.map

package/dist/mcp/tools/agent-message.js.map

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

package/dist/mcp/tools/checkpoint-review.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCheckpointReviewTools(server: McpServer): void;
+//# sourceMappingURL=checkpoint-review.d.ts.map

package/dist/mcp/tools/checkpoint-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-review.d.ts","sourceRoot":"","sources":["../../../_build/src/mcp/tools/checkpoint-review.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8GrE"}

package/dist/mcp/tools/checkpoint-review.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { stxCreate, stxApprove, stxReject, stxResolve, stxStatus, } from "../../server/application/index.js";
+import { fail, ok } from "./_shared.js";
+export function registerCheckpointReviewTools(server) {
+    // CheckpointReview Tools
+    // ═══════════════════════════════════════════════════════
+    server.registerTool("syncpoint_checkpoint_review_create", {
+        title: "Create Checkpoint Review",
+        description: "Create a checkpoint review for a checkpoint. Automatically creates a bound SyncGate. The requesting agent is blocked until all approvers approve and the review is resolved.",
+        inputSchema: {
+            sessionId: z.string(),
+            taskId: z.string(),
+            checkpointId: z.string(),
+            requestingAgentId: z.string(),
+            requiredApproverIds: z.array(z.string()).min(1).describe("Agent IDs that must approve"),
+        },
+    }, async (input) => {
+        try {
+            const result = stxCreate(input);
+            return ok({
+                tx: result.tx,
+                pending: result.pending,
+                isBlocking: result.isBlocking,
+                gateId: result.tx.gateId,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_checkpoint_review_status", {
+        title: "Checkpoint Review Status",
+        description: "Get detailed status of a checkpoint review — pending approvers, approval/rejection state, blocking state.",
+        inputSchema: { txId: z.string() },
+    }, async ({ txId }) => {
+        try {
+            const result = stxStatus(txId);
+            return ok({
+                tx: result.tx,
+                pending: result.pending,
+                allApproved: result.allApproved,
+                hasRejection: result.hasRejection,
+                isBlocking: result.isBlocking,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_checkpoint_review_approve", {
+        title: "Approve Checkpoint Review",
+        description: "Approve a checkpoint review as a required approver. When all approvers approve, the review advances to APPROVED.",
+        inputSchema: {
+            txId: z.string(),
+            agentId: z.string(),
+            summary: z.string().optional().describe("Approval summary"),
+        },
+    }, async ({ txId, agentId, summary }) => {
+        try {
+            const result = stxApprove(txId, agentId, summary);
+            return ok({
+                tx: result.tx,
+                pending: result.pending,
+                allApproved: result.allApproved,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_checkpoint_review_reject", {
+        title: "Reject Checkpoint Review",
+        description: "Reject a checkpoint review. The requesting agent remains blocked. A follow-up action is required before the review can be resolved.",
+        inputSchema: {
+            txId: z.string(),
+            agentId: z.string(),
+            reason: z.string().optional().describe("Rejection reason"),
+        },
+    }, async ({ txId, agentId, reason }) => {
+        try {
+            const result = stxReject(txId, agentId, reason);
+            return ok({ tx: result.tx });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    server.registerTool("syncpoint_checkpoint_review_resolve", {
+        title: "Resolve Checkpoint Review",
+        description: "Resolve a checkpoint review and release the bound SyncGate. The requesting agent may now resume work.",
+        inputSchema: {
+            txId: z.string(),
+            decisionSummary: z.string().optional(),
+        },
+    }, async ({ txId, decisionSummary }) => {
+        try {
+            const result = stxResolve(txId, decisionSummary);
+            return ok({ tx: result.tx });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+}
+//# sourceMappingURL=checkpoint-review.js.map

package/dist/mcp/tools/checkpoint-review.js.map

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

package/dist/mcp/tools/constraint.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP tools for constraint management and preflight checks.
+ *
+ * syncpoint_constraint_list  — list active constraint rules
+ * syncpoint_constraint_check — check if a file/path matches constraints
+ * syncpoint_preflight        — pre-modification safety check
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerConstraintTools(server: McpServer): void;
+//# sourceMappingURL=constraint.d.ts.map

package/dist/mcp/tools/constraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint.d.ts","sourceRoot":"","sources":["../../../_build/src/mcp/tools/constraint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4a/D"}

package/dist/mcp/tools/constraint.js

@@ -0,0 +1,386 @@
+/**
+ * MCP tools for constraint management and preflight checks.
+ *
+ * syncpoint_constraint_list  — list active constraint rules
+ * syncpoint_constraint_check — check if a file/path matches constraints
+ * syncpoint_preflight        — pre-modification safety check
+ */
+import { z } from "zod";
+import { rcRelease, rcDetectConflicts, rcList, } from "../../server/application/index.js";
+import { resolveBoundAgentId } from "../identity.js";
+import { fail, ok } from "./_shared.js";
+export function registerConstraintTools(server) {
+    // ── Constraint list ──────────────────────────────────
+    server.registerTool("syncpoint_constraint_list", {
+        title: "List Constraints",
+        description: "List active constraint rules (do_not_touch, require_review, etc.) that govern what agents can modify.",
+        inputSchema: {
+            sessionId: z.string().optional(),
+            resourceType: z.string().optional().describe("Filter by constraint type (default: all)"),
+        },
+    }, async ({ sessionId }) => {
+        try {
+            // Constraints are exposed through the project memory and guard systems.
+            // Collect do_not_touch entries and other constraint types.
+            const constraints = [];
+            // Check for do_not_touch patterns in environment / config
+            const doNotTouch = process.env.SYNCPOINT_DO_NOT_TOUCH;
+            if (doNotTouch) {
+                for (const p of doNotTouch.split(",").map(s => s.trim()).filter(Boolean)) {
+                    constraints.push({
+                        kind: "do_not_touch",
+                        pattern: p,
+                        description: `Files matching '${p}' are protected and must not be edited`,
+                        source: "environment",
+                    });
+                }
+            }
+            // Check for require_review patterns
+            const requireReview = process.env.SYNCPOINT_REQUIRE_REVIEW;
+            if (requireReview) {
+                for (const p of requireReview.split(",").map(s => s.trim()).filter(Boolean)) {
+                    constraints.push({
+                        kind: "require_review",
+                        pattern: p,
+                        description: `Files matching '${p}' require review before merging`,
+                        source: "environment",
+                    });
+                }
+            }
+            // Also check active resource claims for guarding context
+            const activeClaims = sessionId ? rcList({ sessionId, status: "ACTIVE" }) : [];
+            for (const claim of activeClaims) {
+                for (const resource of claim.resources ?? []) {
+                    if (resource.scope === "file") {
+                        constraints.push({
+                            kind: "active_claim",
+                            pattern: resource.locator,
+                            description: `Currently claimed by ${claim.actorId} (task: ${claim.taskId})`,
+                            source: `claim:${claim.id}`,
+                        });
+                    }
+                }
+            }
+            return ok({
+                count: constraints.length,
+                constraints,
+                hint: "Use syncpoint_preflight to check a specific file before editing.",
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── Constraint check ─────────────────────────────────
+    server.registerTool("syncpoint_constraint_check", {
+        title: "Check Constraints",
+        description: "Check whether a specific file or path matches any active constraints. Returns warnings if the file is restricted.",
+        inputSchema: {
+            locator: z.string().describe("File path or glob pattern to check against constraints"),
+            sessionId: z.string().optional(),
+        },
+    }, async ({ locator, sessionId }) => {
+        try {
+            const violations = [];
+            const warnings = [];
+            // Check do_not_touch
+            const doNotTouch = process.env.SYNCPOINT_DO_NOT_TOUCH?.split(",").map(s => s.trim()).filter(Boolean) ?? [];
+            for (const pattern of doNotTouch) {
+                if (matchesGlob(locator, pattern)) {
+                    violations.push(`do_not_touch: ${locator} matches restricted pattern '${pattern}'`);
+                }
+            }
+            // Check require_review
+            const requireReview = process.env.SYNCPOINT_REQUIRE_REVIEW?.split(",").map(s => s.trim()).filter(Boolean) ?? [];
+            for (const pattern of requireReview) {
+                if (matchesGlob(locator, pattern)) {
+                    warnings.push(`require_review: ${locator} matches review-required pattern '${pattern}'`);
+                }
+            }
+            // Check active exclusive claims
+            const activeClaims = sessionId ? rcList({ sessionId, status: "ACTIVE" }) : [];
+            for (const claim of activeClaims) {
+                for (const resource of claim.resources ?? []) {
+                    if (resource.scope === "file" && resource.locator === locator && claim.mode === "exclusive") {
+                        violations.push(`active_claim: ${locator} is exclusively claimed by ${claim.actorId} (task: ${claim.taskId})`);
+                    }
+                }
+            }
+            return ok({
+                locator,
+                safe: violations.length === 0,
+                violations,
+                warnings,
+                suggestion: violations.length > 0
+                    ? `Cannot modify ${locator}: ${violations.join("; ")}`
+                    : warnings.length > 0
+                        ? `Proceed with caution: ${warnings.join("; ")}`
+                        : `No constraints blocking ${locator}.`,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── Preflight check ──────────────────────────────────
+    server.registerTool("syncpoint_preflight", {
+        title: "Preflight Check",
+        description: "Run a complete pre-modification safety check on one or more files. Checks constraints, active claims, and conflicts before you edit. Always run this BEFORE modifying any file in a multi-agent project.",
+        inputSchema: {
+            locators: z.string().describe("Comma-separated file paths to check before modifying"),
+            agentId: z.string().optional(),
+            taskId: z.string().optional(),
+            sessionId: z.string().optional(),
+        },
+    }, async ({ locators, agentId, taskId, sessionId }) => {
+        try {
+            const resolved = resolveBoundAgentId(agentId);
+            const files = locators.split(",").map(s => s.trim()).filter(Boolean);
+            const results = [];
+            for (const file of files) {
+                const fileViolations = [];
+                const fileWarnings = [];
+                // Check do_not_touch
+                const doNotTouch = process.env.SYNCPOINT_DO_NOT_TOUCH?.split(",").map(s => s.trim()).filter(Boolean) ?? [];
+                for (const pattern of doNotTouch) {
+                    if (matchesGlob(file, pattern)) {
+                        fileViolations.push(`do_not_touch: restricted pattern '${pattern}'`);
+                    }
+                }
+                // Check active exclusive claims by OTHER agents
+                const activeClaims = sessionId ? rcList({ sessionId, status: "ACTIVE" }) : [];
+                for (const claim of activeClaims) {
+                    // Skip this agent's own claims
+                    if (resolved && claim.actorId === resolved)
+                        continue;
+                    for (const resource of claim.resources ?? []) {
+                        if (resource.scope === "file" && resource.locator === file) {
+                            if (claim.mode === "exclusive") {
+                                fileViolations.push(`claimed exclusively by ${claim.actorId} (${claim.taskId})`);
+                            }
+                            else {
+                                fileWarnings.push(`shared claim by ${claim.actorId} (${claim.taskId})`);
+                            }
+                        }
+                    }
+                }
+                results.push({
+                    locator: file,
+                    safe: fileViolations.length === 0,
+                    violations: fileViolations,
+                    warnings: fileWarnings,
+                });
+            }
+            const blockedFiles = results.filter(r => !r.safe);
+            const allSafe = blockedFiles.length === 0;
+            return ok({
+                allSafe,
+                totalFiles: files.length,
+                blockedCount: blockedFiles.length,
+                results,
+                suggestion: allSafe
+                    ? "All files clear to edit."
+                    : `${blockedFiles.length} file(s) have restrictions. Resolve violations or coordinate with other agents before proceeding.`,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── Conflict suggest ─────────────────────────────────
+    server.registerTool("syncpoint_conflict_suggest", {
+        title: "Suggest Conflict Resolution",
+        description: "Generate resolution suggestions for an active resource conflict. Analyzes the conflict and proposes narrowing scope, waiting, or coordinating.",
+        inputSchema: {
+            locator: z.string().describe("The resource locator involved in the conflict"),
+            sessionId: z.string().optional(),
+        },
+    }, async ({ locator, sessionId }) => {
+        try {
+            const conflicts = rcDetectConflicts(sessionId ? { sessionId } : undefined);
+            const relevantConflicts = conflicts.filter(c => c.overlappingLocator.includes(locator));
+            if (relevantConflicts.length === 0) {
+                return ok({
+                    locator,
+                    hasConflict: false,
+                    message: "No active conflicts found for this resource.",
+                });
+            }
+            const suggestions = [];
+            for (const c of relevantConflicts) {
+                // Analyze scope overlap for smarter suggestions
+                const claimAResources = c.claimA.resources ?? [];
+                const claimBResources = c.claimB.resources ?? [];
+                const aHasFileScope = claimAResources.some((r) => (r.scope ?? "file") === "file");
+                const bHasFileScope = claimBResources.some((r) => (r.scope ?? "file") === "file");
+                if (aHasFileScope || bHasFileScope) {
+                    suggestions.push(`Conflict on '${locator}': one agent claims the entire file. ` +
+                        `Try narrowing to function-level scope (use --scope function --function <name>) ` +
+                        `to reduce false conflicts.`);
+                }
+                else {
+                    suggestions.push(`Conflict on '${locator}': overlapping function or line-range claims. ` +
+                        `Check if the agents are actually editing the same code. If not, adjust your scope.`);
+                }
+                if (c.isHardConflict) {
+                    suggestions.push(`This is a HARD conflict on '${locator}' (exclusive mode clash). ` +
+                        `Coordinate with ${c.claimB.actorId} (task: ${c.claimB.taskId}) or wait for their claim to be released.`);
+                }
+            }
+            return ok({
+                locator,
+                hasConflict: true,
+                conflictCount: relevantConflicts.length,
+                suggestions,
+                relatedAgents: [...new Set(relevantConflicts.flatMap(c => [c.claimA.actorId, c.claimB.actorId]))],
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── Conflict list ───────────────────────────────────
+    server.registerTool("syncpoint_conflict_list", {
+        title: "List Conflicts",
+        description: "List all active resource conflicts across agents. Shows overlapping claims with conflict severity (HARD/SOFT) and the agents involved.",
+        inputSchema: {
+            sessionId: z.string().optional(),
+            resourceType: z.string().optional().describe("Filter by resource type (default: all)"),
+        },
+    }, async ({ sessionId, resourceType }) => {
+        try {
+            const conflicts = rcDetectConflicts({ sessionId, resourceType });
+            const formatted = conflicts.map(c => ({
+                kind: c.isHardConflict ? "HARD" : "SOFT",
+                locator: c.overlappingLocator,
+                agents: [c.claimA.actorId, c.claimB.actorId],
+                tasks: [c.claimA.taskId, c.claimB.taskId],
+                claimIds: [c.claimA.id, c.claimB.id],
+                claimAMode: c.claimA.mode,
+                claimBMode: c.claimB.mode,
+                claimAScope: c.claimA.resources?.[0]?.scope ?? "file",
+                claimBScope: c.claimB.resources?.[0]?.scope ?? "file",
+            }));
+            return ok({
+                count: formatted.length,
+                hardCount: formatted.filter(c => c.kind === "HARD").length,
+                softCount: formatted.filter(c => c.kind === "SOFT").length,
+                conflicts: formatted,
+                hint: conflicts.length > 0
+                    ? "Use syncpoint_conflict_suggest for resolution suggestions, or syncpoint_conflict_resolve to resolve."
+                    : undefined,
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── Conflict resolve ─────────────────────────────────
+    server.registerTool("syncpoint_conflict_resolve", {
+        title: "Resolve Conflict",
+        description: "Resolve an active resource conflict. Choose a strategy: release your claim (give way to other agent), force-release theirs (take ownership), or convert both to shared mode (cooperative).",
+        inputSchema: {
+            claimAId: z.string().describe("First claim ID from the conflict"),
+            claimBId: z.string().describe("Second claim ID from the conflict"),
+            resolution: z.enum(["release_claim_a", "release_claim_b", "convert_to_shared"]).describe("Resolution strategy: 'release_claim_a' releases the first claim, 'release_claim_b' releases the second, 'convert_to_shared' changes both to shared mode"),
+        },
+    }, async ({ claimAId, claimBId, resolution }) => {
+        try {
+            if (resolution === "release_claim_a") {
+                const released = rcRelease(claimAId);
+                return ok({
+                    action: "release_claim_a",
+                    released,
+                    message: `Released claim ${claimAId}. Claim ${claimBId} now has sole ownership.`,
+                });
+            }
+            if (resolution === "release_claim_b") {
+                const released = rcRelease(claimBId);
+                return ok({
+                    action: "release_claim_b",
+                    released,
+                    message: `Released claim ${claimBId}. Claim ${claimAId} now has sole ownership.`,
+                });
+            }
+            // convert_to_shared: release and re-claim in shared mode
+            // We release both and the caller should re-claim in shared mode
+            return ok({
+                action: "convert_to_shared",
+                suggestion: "To convert to shared mode, release both claims and re-claim with mode='shared'. Use syncpoint_resource_release followed by syncpoint_resource_claim with mode=shared.",
+                claimAId,
+                claimBId,
+                nextSteps: [
+                    { tool: "syncpoint_resource_release", params: { claimId: claimAId } },
+                    { tool: "syncpoint_resource_release", params: { claimId: claimBId } },
+                    { tool: "syncpoint_resource_claim", params: { mode: "shared", hint: "re-claim resources from both agents with shared mode" } },
+                ],
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+    // ── History ──────────────────────────────────────────
+    server.registerTool("syncpoint_history", {
+        title: "Query Operation History",
+        description: "Query recent events in the SyncPoint system. Filter by agent, task, or event type to understand what happened.",
+        inputSchema: {
+            agentId: z.string().optional(),
+            taskId: z.string().optional(),
+            eventType: z.string().optional().describe("Filter by event type (e.g. RESOURCE_CLAIMED, SYNC_GATE_CREATED)"),
+            limit: z.number().optional().describe("Max events to return (default: 20)"),
+        },
+    }, async ({ agentId, taskId, eventType, limit }) => {
+        try {
+            // Use repository events — listEvents returns most recent first
+            const { listEvents } = await import("../../server/repositories/index.js");
+            const events = listEvents(limit ?? 100);
+            let filtered = events;
+            if (agentId) {
+                const lower = agentId.toLowerCase();
+                filtered = filtered.filter((e) => (e.detail ?? "").toLowerCase().includes(lower) ||
+                    (e.entityId ?? "").toLowerCase().includes(lower));
+            }
+            if (taskId) {
+                filtered = filtered.filter((e) => (e.detail ?? "").includes(taskId) ||
+                    (e.entityId ?? "").includes(taskId));
+            }
+            if (eventType) {
+                filtered = filtered.filter((e) => (e.eventType ?? e.type ?? "") === eventType);
+            }
+            const recent = filtered.slice(0, limit ?? 20);
+            return ok({
+                count: recent.length,
+                totalAvailable: filtered.length,
+                events: recent.map((e) => ({
+                    type: e.eventType ?? e.type,
+                    entity: `${e.entityType ?? ""}:${e.entityId ?? e.id ?? ""}`,
+                    timestamp: e.createdAt ?? e.timestamp,
+                    detail: e.detail,
+                })),
+            });
+        }
+        catch (e) {
+            return fail(e);
+        }
+    });
+}
+// ── Simple glob matcher ───────────────────────────────
+function matchesGlob(filePath, pattern) {
+    // Convert glob pattern to regex
+    const regexStr = pattern
+        .replace(/\./g, "\\.")
+        .replace(/\*\*/g, "___DOUBLESTAR___")
+        .replace(/\*/g, "[^/]*")
+        .replace(/___DOUBLESTAR___/g, ".*")
+        .replace(/\?/g, ".");
+    try {
+        const regex = new RegExp(`^${regexStr}$`);
+        return regex.test(filePath);
+    }
+    catch {
+        // If regex fails, fall back to simple includes match
+        return filePath.includes(pattern.replace(/\*\*/g, "").replace(/\*/g, ""));
+    }
+}
+//# sourceMappingURL=constraint.js.map