@mpowr/nexus-mcp 0.5.0

package/dist/tools/append-session-entry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * session_append -- Layer 2 Coordination
+ *
+ * Appends an entry to an existing session.
+ * Enforces append-only semantics and session write isolation.
+ * Delegates to POST /api/mcp/sessions (action: session_append).
+ */
+import { z } from 'zod';
+export declare const appendSessionEntrySchema: {
+    session_id: z.ZodString;
+    entry_type: z.ZodEnum<{
+        decision_referenced: "decision_referenced";
+        task_created: "task_created";
+        task_updated: "task_updated";
+        letter_sent: "letter_sent";
+        letter_replied: "letter_replied";
+        research_added: "research_added";
+        conflict_detected: "conflict_detected";
+        adr_drafted: "adr_drafted";
+        adr_accepted: "adr_accepted";
+        handoff_recorded: "handoff_recorded";
+        note: "note";
+        correction: "correction";
+    }>;
+    summary: z.ZodString;
+    linked_entity_type: z.ZodOptional<z.ZodString>;
+    linked_entity_id: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type AppendSessionEntryArgs = {
+    session_id: string;
+    entry_type: string;
+    summary: string;
+    linked_entity_type?: string;
+    linked_entity_id?: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function appendSessionEntry(args: AppendSessionEntryArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=append-session-entry.d.ts.map

package/dist/tools/append-session-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-session-entry.d.ts","sourceRoot":"","sources":["../../src/tools/append-session-entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;CA+BpC,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB;;;;;;;;;;;;GA4BpE"}

package/dist/tools/append-session-entry.js

@@ -0,0 +1,67 @@
+/**
+ * session_append -- Layer 2 Coordination
+ *
+ * Appends an entry to an existing session.
+ * Enforces append-only semantics and session write isolation.
+ * Delegates to POST /api/mcp/sessions (action: session_append).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const appendSessionEntrySchema = {
+    session_id: z.string().uuid().describe('Session UUID to append to'),
+    entry_type: z
+        .enum([
+        'decision_referenced',
+        'task_created',
+        'task_updated',
+        'letter_sent',
+        'letter_replied',
+        'research_added',
+        'conflict_detected',
+        'adr_drafted',
+        'adr_accepted',
+        'handoff_recorded',
+        'note',
+        'correction',
+    ])
+        .describe('Type of session entry'),
+    summary: z.string().describe('Entry content / summary text'),
+    linked_entity_type: z
+        .string()
+        .optional()
+        .describe('Type of linked entity (e.g., "task", "decision", "letter", "research_link")'),
+    linked_entity_id: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('UUID of the linked entity'),
+    agent_id: z.string().optional().describe('Agent identifier if applicable'),
+};
+export async function appendSessionEntry(args) {
+    const result = await nexusPost('/api/mcp/sessions', {
+        action: 'session_append',
+        session_id: args.session_id,
+        entry_type: args.entry_type,
+        summary: args.summary,
+        agent_id: args.agent_id,
+        linked_entity_type: args.linked_entity_type,
+        linked_entity_id: args.linked_entity_id,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=append-session-entry.js.map

package/dist/tools/append-session-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-session-entry.js","sourceRoot":"","sources":["../../src/tools/append-session-entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,UAAU,EAAE,CAAC;SACV,IAAI,CAAC;QACJ,qBAAqB;QACrB,cAAc;QACd,cAAc;QACd,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,mBAAmB;QACnB,aAAa;QACb,cAAc;QACd,kBAAkB;QAClB,MAAM;QACN,YAAY;KACb,CAAC;SACD,QAAQ,CAAC,uBAAuB,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC5D,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6EAA6E,CAC9E;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,2BAA2B,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC3E,CAAA;AAYD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA4B;IACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,mBAAmB,EAAE;QAClD,MAAM,EAAE,gBAAgB;QACxB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/dist/tools/create-task.d.ts

@@ -0,0 +1,52 @@
+/**
+ * task_create -- Layer 2 Coordination
+ *
+ * Creates a new task within a project scope.
+ * Delegates to POST /api/mcp/tasks (action: task_create).
+ */
+import { z } from 'zod';
+export declare const createTaskSchema: {
+    project_id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    priority: z.ZodDefault<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        high: "high";
+        urgent: "urgent";
+    }>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        done: "done";
+        cancelled: "cancelled";
+    }>>;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type CreateTaskArgs = {
+    project_id: string;
+    title: string;
+    description?: string;
+    priority?: string;
+    assignee?: string;
+    status?: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function createTask(args: CreateTaskArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=create-task.d.ts.map

package/dist/tools/create-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task.d.ts","sourceRoot":"","sources":["../../src/tools/create-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAc5B,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc;;;;;;;;;;;;GA4BpD"}

package/dist/tools/create-task.js

@@ -0,0 +1,51 @@
+/**
+ * task_create -- Layer 2 Coordination
+ *
+ * Creates a new task within a project scope.
+ * Delegates to POST /api/mcp/tasks (action: task_create).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const createTaskSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    title: z.string().describe('Task title'),
+    description: z.string().optional().describe('Task description'),
+    priority: z
+        .enum(['low', 'normal', 'high', 'urgent'])
+        .default('normal')
+        .describe('Task priority'),
+    assignee: z.string().uuid().optional().describe('UUID of the assigned user'),
+    status: z
+        .enum(['open', 'in_progress', 'blocked', 'done', 'cancelled'])
+        .default('open')
+        .describe('Initial task status'),
+    agent_id: z.string().optional().describe('Agent identifier if applicable'),
+};
+export async function createTask(args) {
+    const result = await nexusPost('/api/mcp/tasks', {
+        action: 'task_create',
+        project_id: args.project_id,
+        title: args.title,
+        description: args.description,
+        priority: args.priority ?? 'normal',
+        assignee: args.assignee,
+        status: args.status ?? 'open',
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=create-task.js.map

package/dist/tools/create-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task.js","sourceRoot":"","sources":["../../src/tools/create-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC/D,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACzC,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,eAAe,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5E,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;SAC7D,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,qBAAqB,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC3E,CAAA;AAaD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE;QAC/C,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;QACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM;KAC9B,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/dist/tools/decision-comments.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Decision comment tools -- Layer 2 Coordination
+ *
+ * Provides append-only comment threads for ADR decisions.
+ * Delegates to POST /api/mcp/governance (actions: dc_add, dc_list).
+ */
+import { z } from 'zod';
+export declare const addDecisionCommentSchema: {
+    decision_id: z.ZodString;
+    body: z.ZodString;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type AddDecisionCommentArgs = {
+    decision_id: string;
+    body: string;
+    agent_id?: string;
+    user_id: string;
+};
+export declare function addDecisionComment(args: AddDecisionCommentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const listDecisionCommentsSchema: {
+    decision_id: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type ListDecisionCommentsArgs = {
+    decision_id: string;
+    limit?: number;
+};
+export declare function listDecisionComments(args: ListDecisionCommentsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=decision-comments.d.ts.map

package/dist/tools/decision-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-comments.d.ts","sourceRoot":"","sources":["../../src/tools/decision-comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,wBAAwB;;;;CAOpC,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB;;;;;;;;;;;;GAyBpE;AAMD,eAAO,MAAM,0BAA0B;;;CAStC,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB;;;;;;;;;;;;GAwBxE"}

package/dist/tools/decision-comments.js

@@ -0,0 +1,80 @@
+/**
+ * Decision comment tools -- Layer 2 Coordination
+ *
+ * Provides append-only comment threads for ADR decisions.
+ * Delegates to POST /api/mcp/governance (actions: dc_add, dc_list).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+// ---------------------------------------------------------------------------
+// add_decision_comment -> dc_add
+// ---------------------------------------------------------------------------
+export const addDecisionCommentSchema = {
+    decision_id: z.string().uuid().describe('Decision UUID to comment on'),
+    body: z.string().describe('Comment body (markdown supported)'),
+    agent_id: z
+        .string()
+        .optional()
+        .describe('Agent identifier if comment is posted by an agent'),
+};
+export async function addDecisionComment(args) {
+    const result = await nexusPost('/api/mcp/governance', {
+        action: 'dc_add',
+        decision_id: args.decision_id,
+        body: args.body,
+        agent_id: args.agent_id,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// list_decision_comments -> dc_list
+// ---------------------------------------------------------------------------
+export const listDecisionCommentsSchema = {
+    decision_id: z.string().uuid().describe('Decision UUID'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum comments to return'),
+};
+export async function listDecisionComments(args) {
+    const result = await nexusPost('/api/mcp/governance', {
+        action: 'dc_list',
+        decision_id: args.decision_id,
+        limit: args.limit ?? 50,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=decision-comments.js.map

package/dist/tools/decision-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-comments.js","sourceRoot":"","sources":["../../src/tools/decision-comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAA;AASD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA4B;IACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IACxD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4BAA4B,CAAC;CAC1C,CAAA;AAOD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAA8B;IACvE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/dist/tools/get-document.d.ts

@@ -0,0 +1,47 @@
+/**
+ * kb_get -- Layer 1 Knowledge Access
+ *
+ * Fetches a single knowledge object in canonical form.
+ * Returns metadata, current version, body, and linked references.
+ * Delegates to POST /api/mcp/documents (action: kb_get).
+ *
+ * ADR-0001 spec: kb_get(entity_type, entity_id, render_mode)
+ */
+import { z } from 'zod';
+export declare const getDocumentSchema: {
+    entity_type: z.ZodEnum<{
+        session: "session";
+        decision: "decision";
+        letter: "letter";
+        task: "task";
+        research_note: "research_note";
+        planning_item: "planning_item";
+        ingest_item: "ingest_item";
+    }>;
+    entity_id: z.ZodString;
+    render_mode: z.ZodDefault<z.ZodEnum<{
+        structured: "structured";
+        markdown: "markdown";
+        summary: "summary";
+    }>>;
+};
+type GetDocumentArgs = {
+    entity_type: string;
+    entity_id: string;
+    render_mode?: string;
+};
+export declare function getDocument(args: GetDocumentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=get-document.d.ts.map

package/dist/tools/get-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document.d.ts","sourceRoot":"","sources":["../../src/tools/get-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAiB7B,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe;;;;;;;;;;;;GAyCtD"}

package/dist/tools/get-document.js

@@ -0,0 +1,68 @@
+/**
+ * kb_get -- Layer 1 Knowledge Access
+ *
+ * Fetches a single knowledge object in canonical form.
+ * Returns metadata, current version, body, and linked references.
+ * Delegates to POST /api/mcp/documents (action: kb_get).
+ *
+ * ADR-0001 spec: kb_get(entity_type, entity_id, render_mode)
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const getDocumentSchema = {
+    entity_type: z
+        .enum([
+        'session',
+        'decision',
+        'letter',
+        'task',
+        'research_note',
+        'planning_item',
+        'ingest_item',
+    ])
+        .describe('Type of the knowledge object'),
+    entity_id: z.string().uuid().describe('UUID of the entity'),
+    render_mode: z
+        .enum(['structured', 'markdown', 'summary'])
+        .default('structured')
+        .describe('Output format: structured JSON, markdown, or summary'),
+};
+export async function getDocument(args) {
+    const result = await nexusPost('/api/mcp/documents', {
+        action: 'kb_get',
+        entity_type: args.entity_type,
+        entity_id: args.entity_id,
+        render_mode: args.render_mode ?? 'structured',
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // For markdown and summary modes, the API returns { content: "..." }
+    // For structured mode, the API returns the full object
+    const data = result.data;
+    const renderMode = args.render_mode ?? 'structured';
+    if (renderMode === 'markdown' || renderMode === 'summary') {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: data.content ?? JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=get-document.js.map

package/dist/tools/get-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document.js","sourceRoot":"","sources":["../../src/tools/get-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,CAAC;SACX,IAAI,CAAC;QACJ,SAAS;QACT,UAAU;QACV,QAAQ;QACR,MAAM;QACN,eAAe;QACf,eAAe;QACf,aAAa;KACd,CAAC;SACD,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC3D,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;SAC3C,OAAO,CAAC,YAAY,CAAC;SACrB,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAA;AAQD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE;QACnD,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY;KAC9C,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,qEAAqE;IACrE,uDAAuD;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA+B,CAAA;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,YAAY,CAAA;IAEnD,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAG,IAAI,CAAC,OAAkB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBAChE;aACF;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SAC/D;KACF,CAAA;AACH,CAAC"}

package/dist/tools/get-project-memory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * kb_memory -- Layer 1 Knowledge Access
+ *
+ * Returns curated project context for agent bootstrapping.
+ * Includes ADRs, active tasks, recent sessions, open letters, etc.
+ * Delegates to POST /api/mcp/memory.
+ *
+ * ADR-0001 spec: kb_memory(project_id, include[], depth)
+ */
+import { z } from 'zod';
+export declare const getProjectMemorySchema: {
+    project_id: z.ZodString;
+    include: z.ZodArray<z.ZodEnum<{
+        adrs: "adrs";
+        rules: "rules";
+        active_tasks: "active_tasks";
+        recent_sessions: "recent_sessions";
+        open_letters: "open_letters";
+        planning: "planning";
+        research: "research";
+    }>>;
+    depth: z.ZodDefault<z.ZodEnum<{
+        light: "light";
+        standard: "standard";
+        deep: "deep";
+    }>>;
+};
+type GetProjectMemoryArgs = {
+    project_id: string;
+    include: string[];
+    depth?: string;
+};
+export declare function getProjectMemory(args: GetProjectMemoryArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=get-project-memory.d.ts.map

package/dist/tools/get-project-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-memory.d.ts","sourceRoot":"","sources":["../../src/tools/get-project-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;CAmBlC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB;;;;;;;;;;;;GAwBhE"}

package/dist/tools/get-project-memory.js

@@ -0,0 +1,53 @@
+/**
+ * kb_memory -- Layer 1 Knowledge Access
+ *
+ * Returns curated project context for agent bootstrapping.
+ * Includes ADRs, active tasks, recent sessions, open letters, etc.
+ * Delegates to POST /api/mcp/memory.
+ *
+ * ADR-0001 spec: kb_memory(project_id, include[], depth)
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const getProjectMemorySchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    include: z
+        .array(z.enum([
+        'adrs',
+        'rules',
+        'active_tasks',
+        'recent_sessions',
+        'open_letters',
+        'planning',
+        'research',
+    ]))
+        .describe('Categories of knowledge to include'),
+    depth: z
+        .enum(['light', 'standard', 'deep'])
+        .default('standard')
+        .describe('Detail level: light (summaries), standard, deep (full bodies)'),
+};
+export async function getProjectMemory(args) {
+    const result = await nexusPost('/api/mcp/memory', {
+        project_id: args.project_id,
+        include: args.include,
+        depth: args.depth ?? 'standard',
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=get-project-memory.js.map

package/dist/tools/get-project-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-memory.js","sourceRoot":"","sources":["../../src/tools/get-project-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACtD,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,IAAI,CAAC;QACL,MAAM;QACN,OAAO;QACP,cAAc;QACd,iBAAiB;QACjB,cAAc;QACd,UAAU;QACV,UAAU;KACX,CAAC,CACH;SACA,QAAQ,CAAC,oCAAoC,CAAC;IACjD,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;SACnC,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAA;AAQD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA0B;IAC/D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE;QAChD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU;KAChC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/dist/tools/get-related-entities.d.ts

@@ -0,0 +1,44 @@
+/**
+ * kb_related -- Layer 1 Knowledge Access
+ *
+ * Returns graph-neighbor entities related to a given entity.
+ * Delegates to POST /api/mcp/related.
+ *
+ * ADR-0001 spec: kb_related(entity_type, entity_id, relation_types[], limit)
+ */
+import { z } from 'zod';
+export declare const getRelatedEntitiesSchema: {
+    entity_type: z.ZodEnum<{
+        session: "session";
+        decision: "decision";
+        letter: "letter";
+        task: "task";
+        research_note: "research_note";
+        planning_item: "planning_item";
+        ingest_item: "ingest_item";
+    }>;
+    entity_id: z.ZodString;
+    relation_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type GetRelatedEntitiesArgs = {
+    entity_type: string;
+    entity_id: string;
+    relation_types?: string[];
+    limit?: number;
+};
+export declare function getRelatedEntities(args: GetRelatedEntitiesArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=get-related-entities.d.ts.map