@gwdn/nexus-mcp 0.7.0

package/dist/tools/list-tasks.js

@@ -0,0 +1,46 @@
+/**
+ * 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';
+import { nexusPost } from '../nexus-api.js';
+export const listTasksSchema = {
+    project_id: z.string().uuid().describe('Project UUID'),
+    status_filter: z
+        .array(z.enum(['open', 'in_progress', 'blocked', 'done', 'cancelled']))
+        .optional()
+        .describe('Filter by task status (default: all statuses)'),
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of tasks to return (default 50)'),
+};
+export async function listTasks(args) {
+    const result = await nexusPost('/api/mcp/tasks', {
+        action: 'task_list',
+        project_id: args.project_id,
+        status_filter: args.status_filter,
+        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-tasks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.js","sourceRoot":"","sources":["../../src/tools/list-tasks.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,eAAe,GAAG;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACtD,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;SACtE,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAA;AASD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE;QAC/C,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,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/project-list.d.ts

@@ -0,0 +1,28 @@
+/**
+ * project_list -- Layer 1 Knowledge Access
+ *
+ * List accessible projects for the authenticated user/agent.
+ * Delegates to GET /api/mcp/projects.
+ */
+import { z } from 'zod';
+export declare const projectListSchema: {
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+type ProjectListArgs = {
+    limit?: number;
+};
+export declare function projectList(args: ProjectListArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=project-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.d.ts","sourceRoot":"","sources":["../../src/tools/project-list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,iBAAiB;;CAQ7B,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe;;;;;;;;;;;;GA2BtD"}

package/dist/tools/project-list.js

@@ -0,0 +1,43 @@
+/**
+ * project_list -- Layer 1 Knowledge Access
+ *
+ * List accessible projects for the authenticated user/agent.
+ * Delegates to GET /api/mcp/projects.
+ */
+import { z } from 'zod';
+import { nexusGet } from '../nexus-api.js';
+export const projectListSchema = {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Maximum number of projects to return'),
+};
+export async function projectList(args) {
+    const params = new URLSearchParams();
+    if (args.limit !== undefined) {
+        params.set('limit', String(args.limit));
+    }
+    const qs = params.toString();
+    const path = `/api/mcp/projects${qs ? `?${qs}` : ''}`;
+    const result = await nexusGet(path);
+    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=project-list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.js","sourceRoot":"","sources":["../../src/tools/project-list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAA;AAMD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACzC,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAErD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEnC,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/reviews.d.ts

@@ -0,0 +1,145 @@
+/**
+ * rv_list + rv_get + rv_create + rv_decide + rv_comment -- Layer 4 Reviews
+ *
+ * Review lifecycle management tools for the Nexus platform.
+ * Reviews cover skills, agents, and other governed entities.
+ * Delegates to POST /api/mcp/reviews.
+ */
+import { z } from 'zod';
+export declare const rvListSchema: {
+    entity_type: z.ZodOptional<z.ZodEnum<{
+        skill: "skill";
+        agent: "agent";
+    }>>;
+    status: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+type RvListArgs = {
+    entity_type?: string;
+    status?: string;
+    limit?: number;
+    user_id: string;
+};
+export declare function rvList(args: RvListArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rvGetSchema: {
+    review_id: z.ZodOptional<z.ZodString>;
+    entity_type: z.ZodOptional<z.ZodString>;
+    entity_id: z.ZodOptional<z.ZodString>;
+};
+type RvGetArgs = {
+    review_id?: string;
+    entity_type?: string;
+    entity_id?: string;
+    user_id: string;
+};
+export declare function rvGet(args: RvGetArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rvCreateSchema: {
+    entity_type: z.ZodEnum<{
+        skill: "skill";
+        agent: "agent";
+    }>;
+    entity_id: z.ZodString;
+};
+type RvCreateArgs = {
+    entity_type: string;
+    entity_id: string;
+    user_id: string;
+};
+export declare function rvCreate(args: RvCreateArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rvDecideSchema: {
+    review_id: z.ZodString;
+    transition: z.ZodEnum<{
+        accept: "accept";
+        submit: "submit";
+        reject: "reject";
+        request_revision: "request_revision";
+        resubmit: "resubmit";
+        archive: "archive";
+    }>;
+    rationale: z.ZodOptional<z.ZodString>;
+};
+type RvDecideArgs = {
+    review_id: string;
+    transition: string;
+    rationale?: string;
+    user_id: string;
+};
+export declare function rvDecide(args: RvDecideArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare const rvCommentSchema: {
+    review_id: z.ZodString;
+    body: z.ZodString;
+    agent_id: z.ZodOptional<z.ZodString>;
+    line_start: z.ZodOptional<z.ZodNumber>;
+    line_end: z.ZodOptional<z.ZodNumber>;
+};
+type RvCommentArgs = {
+    review_id: string;
+    body: string;
+    agent_id?: string;
+    line_start?: number;
+    line_end?: number;
+    user_id: string;
+};
+export declare function rvComment(args: RvCommentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=reviews.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/tools/reviews.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,YAAY;;;;;;;CAiBxB,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU;;;;;;;;;;;;GAyB5C;AAMD,eAAO,MAAM,WAAW;;;;CAgBvB,CAAA;AAED,KAAK,SAAS,GAAG;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS;;;;;;;;;;;;GAyB1C;AAMD,eAAO,MAAM,cAAc;;;;;;CAQ1B,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY;;;;;;;;;;;;GAwBhD;AAMD,eAAO,MAAM,cAAc;;;;;;;;;;;CAU1B,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY;;;;;;;;;;;;GAyBhD;AAMD,eAAO,MAAM,eAAe;;;;;;CAkB3B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;GA2BlD"}

package/dist/tools/reviews.js

@@ -0,0 +1,220 @@
+/**
+ * rv_list + rv_get + rv_create + rv_decide + rv_comment -- Layer 4 Reviews
+ *
+ * Review lifecycle management tools for the Nexus platform.
+ * Reviews cover skills, agents, and other governed entities.
+ * Delegates to POST /api/mcp/reviews.
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+// ---------------------------------------------------------------------------
+// rv_list
+// ---------------------------------------------------------------------------
+export const rvListSchema = {
+    entity_type: z
+        .enum(['skill', 'agent'])
+        .optional()
+        .describe('Filter by entity type (skill or agent)'),
+    status: z
+        .string()
+        .max(50)
+        .optional()
+        .describe('Filter by review status'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Maximum number of reviews to return'),
+};
+export async function rvList(args) {
+    const result = await nexusPost('/api/mcp/reviews', {
+        action: 'rv_list',
+        entity_type: args.entity_type,
+        status: args.status,
+        limit: args.limit,
+    });
+    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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// rv_get
+// ---------------------------------------------------------------------------
+export const rvGetSchema = {
+    review_id: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Review UUID (look up by review ID)'),
+    entity_type: z
+        .string()
+        .max(50)
+        .optional()
+        .describe('Entity type (used with entity_id for lookup by entity)'),
+    entity_id: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('Entity UUID (used with entity_type for lookup by entity)'),
+};
+export async function rvGet(args) {
+    const result = await nexusPost('/api/mcp/reviews', {
+        action: 'rv_get',
+        review_id: args.review_id,
+        entity_type: args.entity_type,
+        entity_id: args.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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// rv_create
+// ---------------------------------------------------------------------------
+export const rvCreateSchema = {
+    entity_type: z
+        .enum(['skill', 'agent'])
+        .describe('Type of entity to create a review for'),
+    entity_id: z
+        .string()
+        .uuid()
+        .describe('UUID of the entity to review'),
+};
+export async function rvCreate(args) {
+    const result = await nexusPost('/api/mcp/reviews', {
+        action: 'rv_create',
+        entity_type: args.entity_type,
+        entity_id: args.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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// rv_decide
+// ---------------------------------------------------------------------------
+export const rvDecideSchema = {
+    review_id: z.string().uuid().describe('Review UUID'),
+    transition: z
+        .enum(['submit', 'accept', 'reject', 'request_revision', 'resubmit', 'archive'])
+        .describe('State transition to apply'),
+    rationale: z
+        .string()
+        .max(10_000)
+        .optional()
+        .describe('Optional rationale for the decision'),
+};
+export async function rvDecide(args) {
+    const result = await nexusPost('/api/mcp/reviews', {
+        action: 'rv_decide',
+        review_id: args.review_id,
+        transition: args.transition,
+        rationale: args.rationale,
+    });
+    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) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// rv_comment
+// ---------------------------------------------------------------------------
+export const rvCommentSchema = {
+    review_id: z.string().uuid().describe('Review UUID'),
+    body: z.string().max(100_000).describe('Comment body (markdown supported)'),
+    agent_id: z
+        .string()
+        .max(200)
+        .optional()
+        .describe('Agent identifier if comment is posted by an agent'),
+    line_start: z
+        .number()
+        .int()
+        .optional()
+        .describe('Start line number for inline comments'),
+    line_end: z
+        .number()
+        .int()
+        .optional()
+        .describe('End line number for inline comments'),
+};
+export async function rvComment(args) {
+    const result = await nexusPost('/api/mcp/reviews', {
+        action: 'rv_comment',
+        review_id: args.review_id,
+        body: args.body,
+        agent_id: args.agent_id,
+        line_start: args.line_start,
+        line_end: args.line_end,
+    });
+    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=reviews.js.map

package/dist/tools/reviews.js.map

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

package/dist/tools/search-knowledge.d.ts

@@ -0,0 +1,48 @@
+/**
+ * kb_search -- Layer 1 Knowledge Access
+ *
+ * Searches project knowledge using keyword, semantic, or hybrid mode.
+ * Delegates to POST /api/mcp/search.
+ */
+import { z } from 'zod';
+export declare const searchKnowledgeSchema: {
+    query: z.ZodString;
+    project_id: z.ZodString;
+    entity_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        session: "session";
+        decision: "decision";
+        letter: "letter";
+        task: "task";
+        research_note: "research_note";
+        planning_item: "planning_item";
+        ingest_item: "ingest_item";
+    }>>>;
+    search_mode: z.ZodDefault<z.ZodEnum<{
+        keyword: "keyword";
+        semantic: "semantic";
+        hybrid: "hybrid";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type SearchArgs = {
+    query: string;
+    project_id: string;
+    entity_types?: string[];
+    search_mode?: string;
+    limit?: number;
+};
+export declare function searchKnowledge(args: SearchArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=search-knowledge.d.ts.map

package/dist/tools/search-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/search-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;CA4BjC,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU;;;;;;;;;;;;GAmBrD"}

package/dist/tools/search-knowledge.js

@@ -0,0 +1,54 @@
+/**
+ * kb_search -- Layer 1 Knowledge Access
+ *
+ * Searches project knowledge using keyword, semantic, or hybrid mode.
+ * Delegates to POST /api/mcp/search.
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const searchKnowledgeSchema = {
+    query: z.string().max(1000).describe('Free-text search query'),
+    project_id: z.string().uuid().describe('Project UUID to scope the search'),
+    entity_types: z
+        .array(z.enum([
+        'session',
+        'decision',
+        'letter',
+        'task',
+        'research_note',
+        'planning_item',
+        'ingest_item',
+    ]))
+        .optional()
+        .describe('Filter to specific entity types'),
+    search_mode: z
+        .enum(['keyword', 'semantic', 'hybrid'])
+        .default('keyword')
+        .describe('Search mode: keyword, semantic, or hybrid'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe('Maximum results to return'),
+};
+export async function searchKnowledge(args) {
+    const result = await nexusPost('/api/mcp/search', {
+        project_id: args.project_id,
+        query: args.query,
+        entity_types: args.entity_types,
+        search_mode: args.search_mode ?? 'keyword',
+        limit: args.limit ?? 10,
+    });
+    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=search-knowledge.js.map

package/dist/tools/search-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-knowledge.js","sourceRoot":"","sources":["../../src/tools/search-knowledge.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,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC1E,YAAY,EAAE,CAAC;SACZ,KAAK,CACJ,CAAC,CAAC,IAAI,CAAC;QACL,SAAS;QACT,UAAU;QACV,QAAQ;QACR,MAAM;QACN,eAAe;QACf,eAAe;QACf,aAAa;KACd,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACvC,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,2CAA2C,CAAC;IACxD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,2BAA2B,CAAC;CACzC,CAAA;AAUD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAgB;IACpD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE;QAChD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;QAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5F,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjF,CAAA;AACH,CAAC"}