@tacitai/mcp-server 0.1.1 → 0.2.0

package/dist/tools/move.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Move tool:
+ *   tacit_move — PATCH /api/v1/objects/:id/placement
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TacitClient } from '../client.js';
+export interface ToolRequest {
+    execute(): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+export declare const moveInputSchema: z.ZodObject<{
+    artifact_id: z.ZodString;
+    placement: z.ZodObject<{
+        kb: z.ZodOptional<z.ZodObject<{
+            collections: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                slug: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                slug?: string | undefined;
+            }, {
+                name: string;
+                slug?: string | undefined;
+            }>]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        }, {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        }>>;
+        pyramid: z.ZodOptional<z.ZodObject<{
+            portfolio_id: z.ZodOptional<z.ZodString>;
+            program_id: z.ZodOptional<z.ZodString>;
+            dossiers: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+            }, {
+                name: string;
+            }>]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        }, {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    }, {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    artifact_id: string;
+    placement: {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    };
+}, {
+    artifact_id: string;
+    placement: {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    };
+}>;
+export type MoveInput = z.infer<typeof moveInputSchema>;
+export declare const MOVE_TOOL_DEF: {
+    name: "tacit_move";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            artifact_id: {
+                type: string;
+                description: string;
+            };
+            placement: {
+                type: string;
+                description: string;
+                properties: {
+                    kb: {
+                        type: string;
+                        properties: {
+                            collections: {
+                                type: string;
+                                items: {
+                                    oneOf: ({
+                                        type: string;
+                                        properties?: undefined;
+                                        required?: undefined;
+                                    } | {
+                                        type: string;
+                                        properties: {
+                                            name: {
+                                                type: string;
+                                            };
+                                        };
+                                        required: string[];
+                                    })[];
+                                };
+                            };
+                        };
+                    };
+                    pyramid: {
+                        type: string;
+                        properties: {
+                            portfolio_id: {
+                                type: string;
+                            };
+                            program_id: {
+                                type: string;
+                            };
+                            dossiers: {
+                                type: string;
+                                items: {
+                                    oneOf: {
+                                        type: string;
+                                    }[];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildMoveRequest(client: TacitClient, input: MoveInput): ToolRequest;
+export declare function handleMove(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function registerMoveTools(server: McpServer, getClientFn: () => Promise<TacitClient>): void;

package/dist/tools/move.js

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Move tool:
+ *   tacit_move — PATCH /api/v1/objects/:id/placement
+ */
+import { z } from 'zod';
+import { getClient } from '../client.js';
+import { apiErrorResult } from './errors.js';
+const placementSchema = z.object({
+    kb: z.object({
+        collections: z.array(z.union([
+            z.string().uuid(),
+            z.object({
+                name: z.string().min(1),
+                slug: z.string().optional(),
+            }),
+        ])),
+    }).optional(),
+    pyramid: z.object({
+        portfolio_id: z.string().uuid().optional(),
+        program_id: z.string().uuid().optional(),
+        dossiers: z.array(z.union([
+            z.string().uuid(),
+            z.object({ name: z.string().min(1) }),
+        ])).optional(),
+    }).optional(),
+});
+export const moveInputSchema = z.object({
+    artifact_id: z.string().min(1).describe('Artifact UUID to move'),
+    placement: placementSchema.describe('New placement — kb and/or pyramid'),
+});
+export const MOVE_TOOL_DEF = {
+    name: 'tacit_move',
+    description: 'Move/re-place content to a different location in the Tacit hierarchy (portfolio, program, dossier, or collection). ' +
+        'Route: PATCH /api/v1/objects/:id/placement.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            artifact_id: { type: 'string', description: 'Artifact UUID' },
+            placement: {
+                type: 'object',
+                description: 'Placement envelope (kb and/or pyramid)',
+                properties: {
+                    kb: {
+                        type: 'object',
+                        properties: {
+                            collections: {
+                                type: 'array',
+                                items: { oneOf: [{ type: 'string' }, { type: 'object', properties: { name: { type: 'string' } }, required: ['name'] }] },
+                            },
+                        },
+                    },
+                    pyramid: {
+                        type: 'object',
+                        properties: {
+                            portfolio_id: { type: 'string' },
+                            program_id: { type: 'string' },
+                            dossiers: { type: 'array', items: { oneOf: [{ type: 'string' }, { type: 'object' }] } },
+                        },
+                    },
+                },
+            },
+        },
+        required: ['artifact_id', 'placement'],
+    },
+};
+export function buildMoveRequest(client, input) {
+    return {
+        async execute() {
+            const { artifact_id, placement } = input;
+            try {
+                const result = await client.patch(`/api/v1/objects/${artifact_id}/placement`, placement);
+                return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+            }
+            catch (err) {
+                return apiErrorResult(err, '/api/v1/objects/:id/placement');
+            }
+        },
+    };
+}
+export async function handleMove(args) {
+    const parsed = moveInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return { content: [{ type: 'text', text: `Invalid input: ${parsed.error.message}` }], isError: true };
+    }
+    return buildMoveRequest(getClient(), parsed.data).execute();
+}
+export function registerMoveTools(server, getClientFn) {
+    server.tool('tacit_move', 'Move/re-place content in the Tacit hierarchy. Route: PATCH /api/v1/objects/:id/placement.', {
+        artifact_id: z.string().min(1).describe('Artifact UUID to move'),
+        placement: z.record(z.unknown()).describe('New placement — kb and/or pyramid'),
+    }, async (args) => {
+        const client = await getClientFn();
+        return buildMoveRequest(client, args).execute();
+    });
+}

package/dist/tools/outbox.d.ts

@@ -0,0 +1,274 @@
+/**
+ * FEAT-111 Wave 2 — Outbox MCP tools:
+ *   tacit_outbox_write  — Write an envelope to the local outbox queue
+ *   tacit_outbox_flush  — Trigger an immediate drain of pending envelopes
+ *   tacit_outbox_status — Check outbox queue status (pending/delivered/failed counts)
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const outboxWriteInputSchema: z.ZodObject<{
+    title: z.ZodString;
+    content: z.ZodString;
+    placement: z.ZodObject<{
+        kb: z.ZodOptional<z.ZodObject<{
+            collections: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                slug: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                slug?: string | undefined;
+            }, {
+                name: string;
+                slug?: string | undefined;
+            }>]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        }, {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        }>>;
+        pyramid: z.ZodOptional<z.ZodObject<{
+            portfolio_id: z.ZodOptional<z.ZodString>;
+            program_id: z.ZodOptional<z.ZodString>;
+            dossiers: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+            }, {
+                name: string;
+            }>]>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        }, {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    }, {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    }>;
+    content_origin: z.ZodDefault<z.ZodEnum<["agent", "human", "git_sync"]>>;
+    source_agent_id: z.ZodOptional<z.ZodString>;
+    autonomy_level: z.ZodOptional<z.ZodEnum<["MENTAT", "TWIN"]>>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    replaces_object_id: z.ZodOptional<z.ZodString>;
+    content_format: z.ZodDefault<z.ZodEnum<["MARKDOWN", "HTML", "PLAIN_TEXT"]>>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    title: string;
+    placement: {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    };
+    content_origin: "agent" | "human" | "git_sync";
+    content_format: "MARKDOWN" | "HTML" | "PLAIN_TEXT";
+    source_agent_id?: string | undefined;
+    autonomy_level?: "MENTAT" | "TWIN" | undefined;
+    idempotency_key?: string | undefined;
+    replaces_object_id?: string | undefined;
+}, {
+    content: string;
+    title: string;
+    placement: {
+        kb?: {
+            collections: (string | {
+                name: string;
+                slug?: string | undefined;
+            })[];
+        } | undefined;
+        pyramid?: {
+            portfolio_id?: string | undefined;
+            program_id?: string | undefined;
+            dossiers?: (string | {
+                name: string;
+            })[] | undefined;
+        } | undefined;
+    };
+    content_origin?: "agent" | "human" | "git_sync" | undefined;
+    source_agent_id?: string | undefined;
+    autonomy_level?: "MENTAT" | "TWIN" | undefined;
+    idempotency_key?: string | undefined;
+    replaces_object_id?: string | undefined;
+    content_format?: "MARKDOWN" | "HTML" | "PLAIN_TEXT" | undefined;
+}>;
+export type OutboxWriteInput = z.infer<typeof outboxWriteInputSchema>;
+export declare const OUTBOX_WRITE_TOOL_DEF: {
+    name: "tacit_outbox_write";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            placement: {
+                type: string;
+                description: string;
+                properties: {
+                    kb: {
+                        type: string;
+                        properties: {
+                            collections: {
+                                type: string;
+                                items: {
+                                    oneOf: ({
+                                        type: string;
+                                        properties?: undefined;
+                                        required?: undefined;
+                                    } | {
+                                        type: string;
+                                        properties: {
+                                            name: {
+                                                type: string;
+                                            };
+                                        };
+                                        required: string[];
+                                    })[];
+                                };
+                            };
+                        };
+                    };
+                    pyramid: {
+                        type: string;
+                        properties: {
+                            portfolio_id: {
+                                type: string;
+                            };
+                            program_id: {
+                                type: string;
+                            };
+                            dossiers: {
+                                type: string;
+                                items: {
+                                    oneOf: {
+                                        type: string;
+                                    }[];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            content_origin: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            source_agent_id: {
+                type: string;
+                description: string;
+            };
+            autonomy_level: {
+                type: string;
+                enum: string[];
+            };
+            idempotency_key: {
+                type: string;
+                description: string;
+            };
+            replaces_object_id: {
+                type: string;
+                description: string;
+            };
+            content_format: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleOutboxWrite(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const OUTBOX_FLUSH_TOOL_DEF: {
+    name: "tacit_outbox_flush";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+};
+export declare function handleOutboxFlush(_args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const OUTBOX_STATUS_TOOL_DEF: {
+    name: "tacit_outbox_status";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+};
+export declare function handleOutboxStatus(_args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function registerOutboxTools(server: McpServer): void;