@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/__tests__/memory-graph-tools.test.js

@@ -0,0 +1,254 @@
+/**
+ * Memory Graph MCP Tools Tests — Phase 4
+ *
+ * Tests for graph-based memory storage, semantic query,
+ * timeline, and context aggregation.
+ */
+import { describe, it, expect, vi, beforeEach, afterAll } from 'vitest';
+import { createRegistry, toMcpResult } from '@dobbyai/capability-core';
+// Mock global fetch
+const mockFetch = vi.fn();
+vi.stubGlobal('fetch', mockFetch);
+// Clear env to force local-only mode
+const originalEnv = { ...process.env };
+// ADR-019: the legacy handle* functions are gone — dispatch goes through the
+// capability registry (handlers are verbatim copies; MCP output byte-identical).
+const registry = createRegistry();
+const callCap = async (id, client, args) => toMcpResult(await registry.get(id).handler({ client: client }, args));
+// ============================================
+// Store Memory
+// ============================================
+describe('MemoryGraph: Store', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        // Ensure no MEM0_API_KEY for local-only tests
+        delete process.env.MEM0_API_KEY;
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+    });
+    it('stores memory locally when Mem0 is not configured', async () => {
+        const result = await callCap('memory_graph_store', {}, {
+            content: 'Decided to use BigQuery append-only pattern for all tables',
+            category: 'project_decisions',
+            project: 'dobby',
+            tags: ['database', 'architecture'],
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.status).toBe('stored');
+        expect(data.memory_id).toMatch(/^mem_/);
+        expect(data.category).toBe('project_decisions');
+        expect(data.mem0_synced).toBe(false);
+        expect(data.graph_size).toBeGreaterThanOrEqual(1);
+    });
+    it('stores memory with relationships', async () => {
+        const result = await callCap('memory_graph_store', {}, {
+            content: 'Switched from PostgreSQL to BigQuery',
+            category: 'project_decisions',
+            related_to: ['mem_previous_123'],
+            relationship_type: 'supersedes',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.status).toBe('stored');
+        expect(data.relationships).toHaveLength(1);
+        expect(data.relationships[0].type).toBe('supersedes');
+        expect(data.relationships[0].target_id).toBe('mem_previous_123');
+    });
+    it('defaults category to project_decisions', async () => {
+        const result = await callCap('memory_graph_store', {}, {
+            content: 'Some important decision',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.category).toBe('project_decisions');
+    });
+    it('defaults relationship type to related', async () => {
+        const result = await callCap('memory_graph_store', {}, {
+            content: 'Related context',
+            related_to: ['other_mem'],
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.relationships[0].type).toBe('related');
+    });
+});
+// ============================================
+// Query Memory
+// ============================================
+describe('MemoryGraph: Query', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        delete process.env.MEM0_API_KEY;
+    });
+    it('returns empty results when graph is empty', async () => {
+        // Previous tests may have populated the shared graph
+        const result = await callCap('memory_graph_query', {}, {
+            query: 'something that definitely does not exist xyz123',
+        });
+        const data = JSON.parse(result.content[0].text);
+        // Either empty results or non-matching
+        expect(data.query).toBe('something that definitely does not exist xyz123');
+    });
+    it('searches local graph cache by keyword', async () => {
+        // Store a memory first
+        await callCap('memory_graph_store', {}, {
+            content: 'Authentication uses JWT tokens with 30-day expiry',
+            category: 'conventions',
+            project: 'dobby',
+            tags: ['auth', 'jwt'],
+        });
+        // Query for it
+        const result = await callCap('memory_graph_query', {}, {
+            query: 'authentication JWT',
+            project: 'dobby',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.results.length).toBeGreaterThanOrEqual(1);
+        expect(data.results[0].memory).toContain('JWT');
+        expect(data.results[0].source).toBe('local_graph');
+    });
+    it('respects depth and limit parameters', async () => {
+        const result = await callCap('memory_graph_query', {}, {
+            query: 'authentication',
+            depth: 2,
+            limit: 3,
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.depth).toBe(2);
+        // Results should not exceed limit
+        expect(data.results?.length || 0).toBeLessThanOrEqual(3);
+    });
+    it('caps depth at 3', async () => {
+        // Store a memory with "depth" keyword so we get results (which include depth field)
+        await callCap('memory_graph_store', {}, {
+            content: 'Testing depth cap behavior in graph traversal',
+            category: 'conventions',
+        });
+        const result = await callCap('memory_graph_query', {}, {
+            query: 'depth traversal',
+            depth: 10,
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.depth).toBe(3);
+    });
+    it('filters by category', async () => {
+        await callCap('memory_graph_store', {}, {
+            content: 'Always use vitest for frontend testing',
+            category: 'conventions',
+        });
+        await callCap('memory_graph_store', {}, {
+            content: 'Bug in vitest mock setup',
+            category: 'bug_history',
+        });
+        const result = await callCap('memory_graph_query', {}, {
+            query: 'vitest',
+            category: 'conventions',
+        });
+        const data = JSON.parse(result.content[0].text);
+        const localResults = (data.results || []).filter((r) => r.source === 'local_graph');
+        for (const r of localResults) {
+            expect(r.category).toBe('conventions');
+        }
+    });
+});
+// ============================================
+// Timeline
+// ============================================
+describe('MemoryGraph: Timeline', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        delete process.env.MEM0_API_KEY;
+    });
+    it('returns timeline for a topic', async () => {
+        // Store some timeline entries
+        await callCap('memory_graph_store', {}, {
+            content: 'Initial database schema design for authentication',
+            category: 'architecture',
+            tags: ['database'],
+        });
+        const result = await callCap('memory_graph_timeline', {}, {
+            topic: 'database',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.topic).toBe('database');
+        expect(data.timeline).toBeDefined();
+        expect(Array.isArray(data.timeline)).toBe(true);
+    });
+    it('returns empty timeline with helpful note', async () => {
+        const result = await callCap('memory_graph_timeline', {}, {
+            topic: 'nonexistent_unique_topic_abc',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.total_entries).toBe(0);
+        expect(data.note).toContain('No timeline entries');
+    });
+    it('respects limit parameter', async () => {
+        const result = await callCap('memory_graph_timeline', {}, {
+            topic: 'test',
+            limit: 5,
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.timeline.length).toBeLessThanOrEqual(5);
+    });
+});
+// ============================================
+// Context Aggregation
+// ============================================
+describe('MemoryGraph: Context', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        delete process.env.MEM0_API_KEY;
+    });
+    it('returns context package with local memories', async () => {
+        await callCap('memory_graph_store', {}, {
+            content: 'API routes follow RESTful conventions with /api/v1/ prefix',
+            category: 'conventions',
+            tags: ['api'],
+        });
+        const result = await callCap('memory_graph_context', {}, {
+            task_title: 'Add new API endpoint for user management',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.task).toBe('Add new API endpoint for user management');
+        expect(data.gathered_at).toBeTruthy();
+        expect(data.summary).toBeDefined();
+        expect(data.summary.total_memories_found).toBeGreaterThanOrEqual(0);
+        expect(data.summary.categories_searched).toContain('project_decisions');
+    });
+    it('includes mem0 not configured note', async () => {
+        const result = await callCap('memory_graph_context', {}, {
+            task_title: 'Some task',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.mem0_configured).toBe(false);
+        expect(data.note).toContain('MEM0_API_KEY');
+    });
+    it('includes project filter', async () => {
+        const result = await callCap('memory_graph_context', {}, {
+            task_title: 'Fix auth bug',
+            project: 'dobby',
+        });
+        const data = JSON.parse(result.content[0].text);
+        expect(data.project).toBe('dobby');
+    });
+});
+// ============================================
+// Tool Registration
+// ============================================
+describe('MemoryGraph: Tool Registration', () => {
+    it('all memory graph tools are in allTools', async () => {
+        const { allTools } = await import('../tools/index.js');
+        expect(allTools.memory_graph_store).toBeDefined();
+        expect(allTools.memory_graph_query).toBeDefined();
+        expect(allTools.memory_graph_timeline).toBeDefined();
+        expect(allTools.memory_graph_context).toBeDefined();
+    });
+    it('memory graph tools have correct schemas', async () => {
+        const { memoryGraphTools } = await import('../tools/memory-graph.js');
+        for (const [name, tool] of Object.entries(memoryGraphTools)) {
+            expect(tool.name).toBe(name);
+            expect(tool.description).toBeTruthy();
+            expect(tool.inputSchema.type).toBe('object');
+            expect(tool.inputSchema.properties).toBeDefined();
+        }
+    });
+});
+//# sourceMappingURL=memory-graph-tools.test.js.map

package/dist/__tests__/memory-graph-tools.test.js.map

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

package/dist/__tests__/registry-dispatch.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ADR-019 Phase 1 — registry dispatch alignment.
+ *
+ * CallTool now dispatches through the @dobbyai/capability-core registry instead
+ * of a switch. This guards the load-bearing invariant: EVERY tool the server
+ * lists (allTools / getToolDefinitions) must be a registered capability, or the
+ * dispatch returns "Unknown tool" for a tool the client can see. A miss here is
+ * exactly the class of bug a silent migration would introduce.
+ */
+export {};
+//# sourceMappingURL=registry-dispatch.test.d.ts.map

package/dist/__tests__/registry-dispatch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-dispatch.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/registry-dispatch.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/registry-dispatch.test.js

@@ -0,0 +1,30 @@
+/**
+ * ADR-019 Phase 1 — registry dispatch alignment.
+ *
+ * CallTool now dispatches through the @dobbyai/capability-core registry instead
+ * of a switch. This guards the load-bearing invariant: EVERY tool the server
+ * lists (allTools / getToolDefinitions) must be a registered capability, or the
+ * dispatch returns "Unknown tool" for a tool the client can see. A miss here is
+ * exactly the class of bug a silent migration would introduce.
+ */
+import { describe, it, expect } from "vitest";
+import { createRegistry } from "@dobbyai/capability-core";
+import { allTools } from "../tools/index.js";
+describe("registry ↔ allTools alignment", () => {
+    const registry = createRegistry();
+    it("every allTools tool is a registered, dispatchable capability", () => {
+        const toolNames = Object.keys(allTools).sort();
+        const capabilityIds = registry.ids().sort();
+        expect(capabilityIds).toEqual(toolNames);
+    });
+    it("registers the full 148-tool catalog", () => {
+        expect(registry.size).toBe(Object.keys(allTools).length);
+        expect(registry.size).toBe(148);
+    });
+    it("no tool name maps to a missing capability", () => {
+        for (const name of Object.keys(allTools)) {
+            expect(registry.has(name)).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=registry-dispatch.test.js.map

package/dist/__tests__/registry-dispatch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-dispatch.test.js","sourceRoot":"","sources":["../../src/__tests__/registry-dispatch.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/registry-listing-parity.test.d.ts

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

package/dist/__tests__/registry-listing-parity.test.d.ts.map

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

package/dist/__tests__/registry-listing-parity.test.js

@@ -0,0 +1,89 @@
+/**
+ * Byte-identical parity guard for routing ListTools/CallTool gating through the
+ * capability registry (ADR-019 P1 tail). Proves that
+ * `capabilityRegistry.visibleTo()` produces the EXACT same visible tool set as
+ * the legacy `filterToolsByTier` + read-only + `passesRoleCap` path — so the
+ * reroute of `getToolDefinitions` cannot change what mcp.dobby-ai.com serves.
+ *
+ * The equivalence rests on three field consistencies between each capability and
+ * its mcp/external metadata; if any drifts, this test fails loudly.
+ */
+import { describe, it, expect } from "vitest";
+import { createRegistry } from "@dobbyai/capability-core";
+import { allTools, minRoleForTool, getToolDefinitions, } from "../tools/index.js";
+import { MVP_TOOLS, PRO_TOOLS } from "../tools/tiers.js";
+const reg = createRegistry();
+const toolNames = Object.keys(allTools);
+function expectedTier(name) {
+    if (MVP_TOOLS.includes(name))
+        return "mvp";
+    if (PRO_TOOLS.includes(name))
+        return "pro";
+    return "enterprise";
+}
+describe("registry ↔ mcp/external field consistency (the reroute's foundation)", () => {
+    it("every allTools name is a registered capability", () => {
+        const missing = toolNames.filter((n) => !reg.get(n));
+        expect(missing).toEqual([]);
+    });
+    it("every registered capability id exists as a key in allTools (reverse of the check above — catches a capability added to capability-core's registry but never wired into an mcp/external tool group, which would otherwise bypass getToolAccessDenial's tier/read-only/role-cap gates entirely)", () => {
+        const toolNameSet = new Set(toolNames);
+        const missing = reg.ids().filter((id) => !toolNameSet.has(id));
+        expect(missing).toEqual([]);
+    });
+    it("cap.tier === the tiers.ts allowlist bucket for every tool", () => {
+        const drift = toolNames.filter((n) => reg.get(n).tier !== expectedTier(n));
+        expect(drift).toEqual([]);
+    });
+    it("cap.minRole === minRoleForTool(name) for every tool", () => {
+        const drift = toolNames.filter((n) => reg.get(n).minRole !== minRoleForTool(n));
+        expect(drift).toEqual([]);
+    });
+    it("cap.readOnly === annotations.readOnlyHint for every tool", () => {
+        const drift = toolNames.filter((n) => {
+            const hint = allTools[n]?.annotations?.readOnlyHint === true;
+            return reg.get(n).readOnly !== hint;
+        });
+        expect(drift).toEqual([]);
+    });
+});
+describe("visibleTo() set === legacy getToolDefinitions() set (concrete roles + superadmin)", () => {
+    const tiers = ["mvp", "pro", "enterprise"];
+    const roles = [
+        "viewer",
+        "member",
+        "operator",
+        "developer",
+        "tenant_admin",
+        "tenant_owner",
+    ];
+    function visibleViaRegistry(opts) {
+        const allowed = new Set(toolNames);
+        return reg
+            .visibleTo(opts)
+            .map((c) => c.id)
+            .filter((id) => allowed.has(id))
+            .sort();
+    }
+    function legacyList(opts) {
+        return getToolDefinitions(opts.tier, opts)
+            .map((t) => t.name)
+            .sort();
+    }
+    for (const tier of tiers) {
+        for (const readOnly of [false, true]) {
+            it(`tier=${tier} readOnly=${readOnly} superadmin → identical set`, () => {
+                expect(visibleViaRegistry({ tier, isSuperAdmin: true, readOnly })).toEqual(legacyList({ tier, isSuperAdmin: true, readOnly }));
+            });
+            it(`tier=${tier} readOnly=${readOnly} null role → identical set (graceful, tier-only)`, () => {
+                expect(visibleViaRegistry({ tier, role: null, readOnly })).toEqual(legacyList({ tier, role: null, readOnly }));
+            });
+            for (const role of roles) {
+                it(`tier=${tier} role=${role} readOnly=${readOnly} → identical set`, () => {
+                    expect(visibleViaRegistry({ tier, role, readOnly })).toEqual(legacyList({ tier, role, readOnly }));
+                });
+            }
+        }
+    }
+});
+//# sourceMappingURL=registry-listing-parity.test.js.map

package/dist/__tests__/registry-listing-parity.test.js.map

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

package/dist/__tests__/role-cap.test.d.ts

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

package/dist/__tests__/role-cap.test.d.ts.map

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

package/dist/__tests__/role-cap.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect } from "vitest";
+import { allTools, passesRoleCap, getToolDefinitions, getToolAccessDenial, } from "../tools/index.js";
+// Representative tools:
+//   get_setup_status — readOnlyHint  → minRole viewer
+//   create_task      — write         → minRole member
+//   approve_task     — admin-class   → minRole tenant_admin
+const ENTERPRISE_SCOPES = ["mcp:*", "mcp:execute"];
+describe("RBAC role-cap (ADR-019 Phase 2)", () => {
+    describe("passesRoleCap", () => {
+        it("superadmin bypasses every role-cap", () => {
+            expect(passesRoleCap("approve_task", "viewer", true)).toBe(true);
+        });
+        it("a nullish role skips the cap (tier-only, non-breaking rollout)", () => {
+            expect(passesRoleCap("create_task", undefined)).toBe(true);
+            expect(passesRoleCap("create_task", null)).toBe(true);
+        });
+        it("a viewer may call read-only tools but not writes", () => {
+            expect(passesRoleCap("get_setup_status", "viewer")).toBe(true);
+            expect(passesRoleCap("create_task", "viewer")).toBe(false);
+        });
+        it("a member may call standard writes but not admin-class tools", () => {
+            expect(passesRoleCap("create_task", "member")).toBe(true);
+            expect(passesRoleCap("approve_task", "member")).toBe(false);
+        });
+        it("tenant_admin/tenant_owner may call admin-class tools", () => {
+            expect(passesRoleCap("approve_task", "tenant_admin")).toBe(true);
+            expect(passesRoleCap("approve_task", "tenant_owner")).toBe(true);
+        });
+        it("an unknown role fails closed for a write tool", () => {
+            expect(passesRoleCap("create_task", "bogus_role")).toBe(false);
+        });
+    });
+    describe("getToolDefinitions role filtering (ListTools)", () => {
+        it("a viewer sees read-only tools, not writes", () => {
+            const names = getToolDefinitions("enterprise", { role: "viewer" }).map((t) => t.name);
+            expect(names).toContain("get_setup_status");
+            expect(names).not.toContain("create_task");
+        });
+        it("a member sees writes but not admin-class", () => {
+            const names = getToolDefinitions("enterprise", { role: "member" }).map((t) => t.name);
+            expect(names).toContain("create_task");
+            expect(names).not.toContain("approve_task");
+        });
+        it("superadmin sees the full enterprise set — a strict superset of a non-superadmin's", () => {
+            // capability-core 0.1.2 hides the 5 superAdminOnly ops tools from every
+            // non-superadmin, so a superadmin now sees STRICTLY MORE than a normal
+            // enterprise principal. The superadmin set = the FULL registry (all tools);
+            // the non-superadmin set is the full set minus the 5 ops tools.
+            //
+            // Both sides use a nullish role (tier-only, no role floor) so the ONLY
+            // difference between them is the superAdminOnly gating — isolating exactly
+            // the 5 ops tools as the delta.
+            const nonSu = new Set(getToolDefinitions("enterprise").map((t) => t.name));
+            const su = getToolDefinitions("enterprise", {
+                isSuperAdmin: true,
+            }).map((t) => t.name);
+            const suSet = new Set(su);
+            // Superadmin reaches the entire catalog (byte-identical to allTools).
+            expect(su.length).toBe(Object.keys(allTools).length);
+            // ...and it is a STRICT superset of the non-superadmin set.
+            expect(su.length).toBeGreaterThan(nonSu.size);
+            for (const name of nonSu) {
+                expect(suSet.has(name), `superadmin missing "${name}"`).toBe(true);
+            }
+            // The exclusive tools are exactly the 5 superAdminOnly ops caps.
+            const exclusive = su.filter((n) => !nonSu.has(n));
+            expect(exclusive.sort()).toEqual([
+                "acknowledge_ops_issue",
+                "get_active_issues",
+                "get_ops_audit_log",
+                "get_ops_health_summary",
+                "get_service_status",
+            ].sort());
+        });
+        it("a nullish role does not reduce the set (tier-only)", () => {
+            const all = getToolDefinitions("enterprise").length;
+            expect(getToolDefinitions("enterprise", {}).length).toBe(all);
+        });
+    });
+    describe("getToolAccessDenial role denial (CallTool)", () => {
+        it("denies a viewer on a write tool", () => {
+            const d = getToolAccessDenial("create_task", {
+                scopes: ENTERPRISE_SCOPES,
+                role: "viewer",
+            });
+            expect(d).toMatch(/tenant role/);
+        });
+        it("allows a member on a write tool", () => {
+            expect(getToolAccessDenial("create_task", {
+                scopes: ENTERPRISE_SCOPES,
+                role: "member",
+            })).toBeNull();
+        });
+        it("denies a member on an admin-class tool (names the required role)", () => {
+            const d = getToolAccessDenial("approve_task", {
+                scopes: ENTERPRISE_SCOPES,
+                role: "member",
+            });
+            expect(d).toMatch(/tenant_admin/);
+        });
+        it("superadmin bypasses the role denial", () => {
+            expect(getToolAccessDenial("approve_task", {
+                scopes: ENTERPRISE_SCOPES,
+                role: "viewer",
+                isSuperAdmin: true,
+            })).toBeNull();
+        });
+        it("a nullish role does not deny (tier-only)", () => {
+            expect(getToolAccessDenial("create_task", { scopes: ENTERPRISE_SCOPES })).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=role-cap.test.js.map

package/dist/__tests__/role-cap.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-cap.test.js","sourceRoot":"","sources":["../../src/__tests__/role-cap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,wBAAwB;AACxB,sDAAsD;AACtD,sDAAsD;AACtD,4DAA4D;AAC5D,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAEnD,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;QAC7D,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,CACpE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACd,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,CACpE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACd,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;YAC3F,wEAAwE;YACxE,uEAAuE;YACvE,4EAA4E;YAC5E,gEAAgE;YAChE,EAAE;YACF,uEAAuE;YACvE,2EAA2E;YAC3E,gCAAgC;YAChC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,kBAAkB,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACpD,CAAC;YACF,MAAM,EAAE,GAAG,kBAAkB,CAAC,YAAY,EAAE;gBAC1C,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;YAE1B,sEAAsE;YACtE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;YACrD,4DAA4D;YAC5D,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,uBAAuB,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,iEAAiE;YACjE,MAAM,SAAS,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAC9B;gBACE,uBAAuB;gBACvB,mBAAmB;gBACnB,mBAAmB;gBACnB,wBAAwB;gBACxB,oBAAoB;aACrB,CAAC,IAAI,EAAE,CACT,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,GAAG,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;YACpD,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAC1D,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,GAAG,mBAAmB,CAAC,aAAa,EAAE;gBAC3C,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YACH,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CACJ,mBAAmB,CAAC,aAAa,EAAE;gBACjC,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,QAAQ;aACf,CAAC,CACH,CAAC,QAAQ,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,MAAM,CAAC,GAAG,mBAAmB,CAAC,cAAc,EAAE;gBAC5C,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YACH,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CACJ,mBAAmB,CAAC,cAAc,EAAE;gBAClC,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,IAAI;aACnB,CAAC,CACH,CAAC,QAAQ,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CACJ,mBAAmB,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAClE,CAAC,QAAQ,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/schedule-tools.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Schedule MCP Tools Tests
+ *
+ * Tests for scheduled agent task execution:
+ * create_schedule, list_schedules, pause_schedule, delete_schedule
+ */
+export {};
+//# sourceMappingURL=schedule-tools.test.d.ts.map

package/dist/__tests__/schedule-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schedule-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}