@gwdn/nexus-mcp 0.7.0

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

@@ -0,0 +1,40 @@
+/**
+ * doc_ingest -- Layer 2 Coordination
+ *
+ * Allows agents to push text/markdown content into a project's
+ * knowledge base via the ingest_items table.
+ * Delegates to POST /api/mcp/documents (action: doc_ingest).
+ */
+import { z } from 'zod';
+export declare const ingestDocumentSchema: {
+    project_id: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type IngestDocumentArgs = {
+    project_id: string;
+    title: string;
+    body: string;
+    source?: string;
+    source_url?: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function ingestDocument(args: IngestDocumentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=ingest-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-document.d.ts","sourceRoot":"","sources":["../../src/tools/ingest-document.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,oBAAoB;;;;;;;CAahC,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;GA4B5D"}

package/dist/tools/ingest-document.js

@@ -0,0 +1,49 @@
+/**
+ * doc_ingest -- Layer 2 Coordination
+ *
+ * Allows agents to push text/markdown content into a project's
+ * knowledge base via the ingest_items table.
+ * Delegates to POST /api/mcp/documents (action: doc_ingest).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const ingestDocumentSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    title: z.string().max(500).describe('Document title'),
+    body: z.string().max(100_000).describe('Document content (text or markdown)'),
+    source: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Source identifier (e.g. "mcp-agent", "research", "session-extract")'),
+    source_url: z.string().url().optional().describe('Source URL if applicable'),
+    agent_id: z.string().max(200).optional().describe('Agent identifier if applicable'),
+};
+export async function ingestDocument(args) {
+    const result = await nexusPost('/api/mcp/documents', {
+        action: 'doc_ingest',
+        project_id: args.project_id,
+        title: args.title,
+        body: args.body,
+        source: args.source,
+        source_url: args.source_url,
+        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) },
+        ],
+    };
+}
+//# sourceMappingURL=ingest-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-document.js","sourceRoot":"","sources":["../../src/tools/ingest-document.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,oBAAoB,GAAG;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC7E,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qEAAqE,CACtE;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACpF,CAAA;AAYD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAwB;IAC3D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE;QACnD,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,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"}

package/dist/tools/letter-inbox.d.ts

@@ -0,0 +1,80 @@
+/**
+ * vl_inbox + vl_outbox + vl_ack -- Layer 2 Coordination
+ *
+ * Inbox/outbox polling and acknowledgment for vault letters.
+ * Delegates to POST /api/mcp/letters (actions: vl_inbox, vl_outbox, vl_ack).
+ */
+import { z } from 'zod';
+export declare const listInboxSchema: {
+    project_id: z.ZodString;
+    status_filter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type ListInboxArgs = {
+    project_id: string;
+    status_filter?: string[];
+    limit?: number;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function listInbox(args: ListInboxArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const listOutboxSchema: {
+    project_id: z.ZodString;
+    status_filter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type ListOutboxArgs = {
+    project_id: string;
+    status_filter?: string[];
+    limit?: number;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function listOutbox(args: ListOutboxArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const acknowledgeLetterSchema: {
+    letter_id: z.ZodString;
+};
+type AcknowledgeLetterArgs = {
+    letter_id: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function acknowledgeLetter(args: AcknowledgeLetterArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=letter-inbox.d.ts.map

package/dist/tools/letter-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"letter-inbox.d.ts","sourceRoot":"","sources":["../../src/tools/letter-inbox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,eAAe;;;;CAc3B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;GAyBlD;AAMD,eAAO,MAAM,gBAAgB;;;;CAY5B,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc;;;;;;;;;;;;GAyBpD;AAMD,eAAO,MAAM,uBAAuB;;CAEnC,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB;;;;;;;;;;;;GAwBlE"}

package/dist/tools/letter-inbox.js

@@ -0,0 +1,118 @@
+/**
+ * vl_inbox + vl_outbox + vl_ack -- Layer 2 Coordination
+ *
+ * Inbox/outbox polling and acknowledgment for vault letters.
+ * Delegates to POST /api/mcp/letters (actions: vl_inbox, vl_outbox, vl_ack).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+// ---------------------------------------------------------------------------
+// list_inbox
+// ---------------------------------------------------------------------------
+export const listInboxSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    status_filter: z
+        .array(z.string().max(50))
+        .optional()
+        .describe('Filter by letter status (default: new, acknowledged, in_progress, blocked, needs_review)'),
+    limit: z
+        .number()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe('Max number of letters to return'),
+};
+export async function listInbox(args) {
+    const result = await nexusPost('/api/mcp/letters', {
+        action: 'vl_inbox',
+        project_id: args.project_id,
+        status_filter: args.status_filter,
+        limit: args.limit ?? 20,
+    });
+    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_outbox
+// ---------------------------------------------------------------------------
+export const listOutboxSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    status_filter: z
+        .array(z.string().max(50))
+        .optional()
+        .describe('Filter by letter status (default: all non-closed)'),
+    limit: z
+        .number()
+        .min(1)
+        .max(50)
+        .default(20)
+        .describe('Max number of letters to return'),
+};
+export async function listOutbox(args) {
+    const result = await nexusPost('/api/mcp/letters', {
+        action: 'vl_outbox',
+        project_id: args.project_id,
+        status_filter: args.status_filter,
+        limit: args.limit ?? 20,
+    });
+    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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// acknowledge_letter
+// ---------------------------------------------------------------------------
+export const acknowledgeLetterSchema = {
+    letter_id: z.string().uuid().describe('Letter UUID to acknowledge'),
+};
+export async function acknowledgeLetter(args) {
+    const result = await nexusPost('/api/mcp/letters', {
+        action: 'vl_ack',
+        letter_id: args.letter_id,
+        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) },
+        ],
+    };
+}
+//# sourceMappingURL=letter-inbox.js.map

package/dist/tools/letter-inbox.js.map

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

package/dist/tools/letters.d.ts

@@ -0,0 +1,91 @@
+/**
+ * vl_create + vl_reply -- Layer 2 Coordination
+ *
+ * Vault letter management for agent coordination.
+ * Delegates to POST /api/mcp/letters (actions: vl_create, vl_reply).
+ */
+import { z } from 'zod';
+export declare const createLetterSchema: {
+    project_id: z.ZodString;
+    from_actor: z.ZodString;
+    to_actor: z.ZodString;
+    subject: z.ZodString;
+    body: z.ZodString;
+    priority: z.ZodDefault<z.ZodEnum<{
+        low: "low";
+        normal: "normal";
+        high: "high";
+        urgent: "urgent";
+    }>>;
+    blocking: z.ZodDefault<z.ZodBoolean>;
+    thread_id: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type CreateLetterArgs = {
+    project_id: string;
+    from_actor: string;
+    to_actor: string;
+    subject: string;
+    body: string;
+    priority?: string;
+    blocking?: boolean;
+    thread_id?: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function createLetter(args: CreateLetterArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const replyLetterSchema: {
+    letter_id: z.ZodString;
+    body: z.ZodString;
+    message_type: z.ZodDefault<z.ZodEnum<{
+        response: "response";
+        clarification: "clarification";
+        review_note: "review_note";
+        follow_up: "follow_up";
+        context: "context";
+    }>>;
+    agent_id: z.ZodOptional<z.ZodString>;
+    new_status: z.ZodOptional<z.ZodEnum<{
+        in_progress: "in_progress";
+        blocked: "blocked";
+        acknowledged: "acknowledged";
+        answered: "answered";
+        needs_review: "needs_review";
+        closed: "closed";
+    }>>;
+};
+type ReplyLetterArgs = {
+    letter_id: string;
+    body: string;
+    message_type?: string;
+    user_id: string;
+    agent_id?: string;
+    new_status?: string;
+};
+export declare function replyLetter(args: ReplyLetterArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=letters.d.ts.map

package/dist/tools/letters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"letters.d.ts","sourceRoot":"","sources":["../../src/tools/letters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAoB9B,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;;;;GA+BxD;AAMD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CAmB7B,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe;;;;;;;;;;;;GA2BtD"}

package/dist/tools/letters.js

@@ -0,0 +1,112 @@
+/**
+ * vl_create + vl_reply -- Layer 2 Coordination
+ *
+ * Vault letter management for agent coordination.
+ * Delegates to POST /api/mcp/letters (actions: vl_create, vl_reply).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+// ---------------------------------------------------------------------------
+// create_letter
+// ---------------------------------------------------------------------------
+export const createLetterSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    from_actor: z.string().max(200).describe('Sender identifier (agent name or user)'),
+    to_actor: z.string().max(200).describe('Recipient identifier (agent name or user)'),
+    subject: z.string().max(500).describe('Letter subject'),
+    body: z.string().max(100_000).describe('Initial message body'),
+    priority: z
+        .enum(['low', 'normal', 'high', 'urgent'])
+        .default('normal')
+        .describe('Letter priority'),
+    blocking: z
+        .boolean()
+        .default(false)
+        .describe('Whether this letter blocks the sender'),
+    thread_id: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Optional thread UUID to group related letters'),
+    agent_id: z.string().max(200).optional().describe('Agent identifier if applicable'),
+};
+export async function createLetter(args) {
+    const result = await nexusPost('/api/mcp/letters', {
+        action: 'vl_create',
+        project_id: args.project_id,
+        from_actor: args.from_actor,
+        to_actor: args.to_actor,
+        subject: args.subject,
+        body: args.body,
+        priority: args.priority ?? 'normal',
+        blocking: args.blocking ?? false,
+        thread_id: args.thread_id,
+        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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// reply_letter
+// ---------------------------------------------------------------------------
+export const replyLetterSchema = {
+    letter_id: z.string().uuid().describe('Letter UUID to reply to'),
+    body: z.string().max(100_000).describe('Reply message body'),
+    message_type: z
+        .enum(['response', 'clarification', 'review_note', 'follow_up', 'context'])
+        .default('response')
+        .describe('Type of reply message'),
+    agent_id: z.string().max(200).optional().describe('Agent identifier if applicable'),
+    new_status: z
+        .enum([
+        'acknowledged',
+        'in_progress',
+        'answered',
+        'blocked',
+        'needs_review',
+        'closed',
+    ])
+        .optional()
+        .describe('Optionally update the letter status'),
+};
+export async function replyLetter(args) {
+    const result = await nexusPost('/api/mcp/letters', {
+        action: 'vl_reply',
+        letter_id: args.letter_id,
+        body: args.body,
+        message_type: args.message_type ?? 'response',
+        agent_id: args.agent_id,
+        new_status: args.new_status,
+    });
+    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=letters.js.map

package/dist/tools/letters.js.map

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

package/dist/tools/list-documents.d.ts

@@ -0,0 +1,33 @@
+/**
+ * doc_list -- Layer 2 Coordination
+ *
+ * List ingested documents for a project with optional source filtering.
+ * Delegates to POST /api/mcp/documents (action: doc_list).
+ */
+import { z } from 'zod';
+export declare const listDocumentsSchema: {
+    project_id: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type ListDocumentsArgs = {
+    project_id: string;
+    source?: string;
+    limit?: number;
+    user_id: string;
+};
+export declare function listDocuments(args: ListDocumentsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=list-documents.d.ts.map

package/dist/tools/list-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.d.ts","sourceRoot":"","sources":["../../src/tools/list-documents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,mBAAmB;;;;CAa/B,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;GAyB1D"}

package/dist/tools/list-documents.js

@@ -0,0 +1,47 @@
+/**
+ * doc_list -- Layer 2 Coordination
+ *
+ * List ingested documents for a project with optional source filtering.
+ * Delegates to POST /api/mcp/documents (action: doc_list).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const listDocumentsSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    source: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Filter by source (e.g., "mcp-agent", "research", "session-extract")'),
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of documents to return (default 50)'),
+};
+export async function listDocuments(args) {
+    const result = await nexusPost('/api/mcp/documents', {
+        action: 'doc_list',
+        project_id: args.project_id,
+        source: args.source,
+        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=list-documents.js.map

package/dist/tools/list-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.js","sourceRoot":"","sources":["../../src/tools/list-documents.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,mBAAmB,GAAG;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACtD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAA;AASD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE;QACnD,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,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/list-tasks.d.ts

@@ -0,0 +1,39 @@
+/**
+ * task_list -- Layer 2 Coordination
+ *
+ * List tasks for a project with optional status filtering.
+ * Delegates to POST /api/mcp/tasks (action: task_list).
+ */
+import { z } from 'zod';
+export declare const listTasksSchema: {
+    project_id: z.ZodString;
+    status_filter: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        done: "done";
+        cancelled: "cancelled";
+    }>>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type ListTasksArgs = {
+    project_id: string;
+    status_filter?: string[];
+    limit?: number;
+    user_id: string;
+};
+export declare function listTasks(args: ListTasksArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=list-tasks.d.ts.map

package/dist/tools/list-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/list-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe;;;;;;;;;;CAY3B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;GAyBlD"}