@tacitai/mcp-server 0.1.1 → 0.2.0

package/dist/tools/kb.d.ts

@@ -0,0 +1,544 @@
+/**
+ * KB tools — CLI wrappers for knowledge collections, articles, categories,
+ * and browse/promote flows on the Axum REST API.
+ *
+ * Routes (Axum, all under /api/v1):
+ *   GET/POST         /knowledge/collections
+ *   PATCH/DELETE      /knowledge/collections/:id
+ *   GET/POST         /knowledge/articles
+ *   GET/PUT          /knowledge/articles/:id
+ *   GET              /knowledge/browse
+ *   POST             /knowledge/articles/from-artifact/:id
+ *   GET/POST         /knowledge/categories
+ */
+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 listCollectionsInputSchema: z.ZodObject<{
+    kb_category_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kb_category_id?: string | undefined;
+}, {
+    kb_category_id?: string | undefined;
+}>;
+export type ListCollectionsInput = z.infer<typeof listCollectionsInputSchema>;
+export declare const LIST_COLLECTIONS_TOOL_DEF: {
+    name: "tacit_kb_list_collections";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            kb_category_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildListCollectionsRequest(client: TacitClient, input: ListCollectionsInput): ToolRequest;
+export declare function handleListCollections(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const createCollectionInputSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    kb_category_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
+    description?: string | undefined;
+    kb_category_id?: string | undefined;
+}, {
+    name: string;
+    slug: string;
+    description?: string | undefined;
+    kb_category_id?: string | undefined;
+}>;
+export type CreateCollectionInput = z.infer<typeof createCollectionInputSchema>;
+export declare const CREATE_COLLECTION_TOOL_DEF: {
+    name: "tacit_kb_create_collection";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            slug: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            kb_category_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildCreateCollectionRequest(client: TacitClient, input: CreateCollectionInput): ToolRequest;
+export declare function handleCreateCollection(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const updateCollectionInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    kb_category_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    slug?: string | undefined;
+    kb_category_id?: string | null | undefined;
+}, {
+    name: string;
+    id: string;
+    slug?: string | undefined;
+    kb_category_id?: string | null | undefined;
+}>;
+export type UpdateCollectionInput = z.infer<typeof updateCollectionInputSchema>;
+export declare const UPDATE_COLLECTION_TOOL_DEF: {
+    name: "tacit_kb_update_collection";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            slug: {
+                type: string;
+                description: string;
+            };
+            kb_category_id: {
+                type: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildUpdateCollectionRequest(client: TacitClient, input: UpdateCollectionInput): ToolRequest;
+export declare function handleUpdateCollection(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const deleteCollectionInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type DeleteCollectionInput = z.infer<typeof deleteCollectionInputSchema>;
+export declare const DELETE_COLLECTION_TOOL_DEF: {
+    name: "tacit_kb_delete_collection";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildDeleteCollectionRequest(client: TacitClient, input: DeleteCollectionInput): ToolRequest;
+export declare function handleDeleteCollection(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const listArticlesInputSchema: z.ZodObject<{
+    collection_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    collection_id?: string | undefined;
+}, {
+    collection_id?: string | undefined;
+}>;
+export type ListArticlesInput = z.infer<typeof listArticlesInputSchema>;
+export declare const LIST_ARTICLES_TOOL_DEF: {
+    name: "tacit_kb_list_articles";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            collection_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildListArticlesRequest(client: TacitClient, input: ListArticlesInput): ToolRequest;
+export declare function handleListArticles(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const getArticleInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type GetArticleInput = z.infer<typeof getArticleInputSchema>;
+export declare const GET_ARTICLE_TOOL_DEF: {
+    name: "tacit_kb_get_article";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildGetArticleRequest(client: TacitClient, input: GetArticleInput): ToolRequest;
+export declare function handleGetArticle(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const createArticleInputSchema: z.ZodObject<{
+    collection_id: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["DRAFT", "PUBLISHED"]>>;
+    domain_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    slug: string;
+    collection_id: string;
+    status?: "DRAFT" | "PUBLISHED" | undefined;
+    content?: string | undefined;
+    domain_id?: string | undefined;
+}, {
+    title: string;
+    slug: string;
+    collection_id: string;
+    status?: "DRAFT" | "PUBLISHED" | undefined;
+    content?: string | undefined;
+    domain_id?: string | undefined;
+}>;
+export type CreateArticleInput = z.infer<typeof createArticleInputSchema>;
+export declare const CREATE_ARTICLE_TOOL_DEF: {
+    name: "tacit_kb_create_article";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            collection_id: {
+                type: string;
+                description: string;
+            };
+            slug: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            domain_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildCreateArticleRequest(client: TacitClient, input: CreateArticleInput): ToolRequest;
+export declare function handleCreateArticle(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const updateArticleInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["DRAFT", "PUBLISHED"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status?: "DRAFT" | "PUBLISHED" | undefined;
+    content?: string | undefined;
+    title?: string | undefined;
+}, {
+    id: string;
+    status?: "DRAFT" | "PUBLISHED" | undefined;
+    content?: string | undefined;
+    title?: string | undefined;
+}>;
+export type UpdateArticleInput = z.infer<typeof updateArticleInputSchema>;
+export declare const UPDATE_ARTICLE_TOOL_DEF: {
+    name: "tacit_kb_update_article";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildUpdateArticleRequest(client: TacitClient, input: UpdateArticleInput): ToolRequest;
+export declare function handleUpdateArticle(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const browseTreeInputSchema: z.ZodObject<{
+    kb_category_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kb_category_id?: string | undefined;
+}, {
+    kb_category_id?: string | undefined;
+}>;
+export type BrowseTreeInput = z.infer<typeof browseTreeInputSchema>;
+export declare const BROWSE_TREE_TOOL_DEF: {
+    name: "tacit_kb_browse_tree";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            kb_category_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildBrowseTreeRequest(client: TacitClient, input: BrowseTreeInput): ToolRequest;
+export declare function handleBrowseTree(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const promoteFromArtifactInputSchema: z.ZodObject<{
+    artifact_id: z.ZodString;
+    collection_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    artifact_id: string;
+    collection_id: string;
+}, {
+    artifact_id: string;
+    collection_id: string;
+}>;
+export type PromoteFromArtifactInput = z.infer<typeof promoteFromArtifactInputSchema>;
+export declare const PROMOTE_FROM_ARTIFACT_TOOL_DEF: {
+    name: "tacit_kb_promote_from_artifact";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            artifact_id: {
+                type: string;
+                description: string;
+            };
+            collection_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildPromoteFromArtifactRequest(client: TacitClient, input: PromoteFromArtifactInput): ToolRequest;
+export declare function handlePromoteFromArtifact(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const promoteFromCatalogInputSchema: z.ZodObject<{
+    catalog_item_id: z.ZodString;
+    collection_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    collection_id: string;
+    catalog_item_id: string;
+}, {
+    collection_id: string;
+    catalog_item_id: string;
+}>;
+export type PromoteFromCatalogInput = z.infer<typeof promoteFromCatalogInputSchema>;
+export declare const PROMOTE_FROM_CATALOG_TOOL_DEF: {
+    name: "tacit_kb_promote_from_catalog";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            catalog_item_id: {
+                type: string;
+                description: string;
+            };
+            collection_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildPromoteFromCatalogRequest(client: TacitClient, input: PromoteFromCatalogInput): ToolRequest;
+export declare function handlePromoteFromCatalog(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const listCategoriesInputSchema: z.ZodObject<{
+    kind: z.ZodOptional<z.ZodString>;
+    include_archived: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    kind?: string | undefined;
+    include_archived?: boolean | undefined;
+}, {
+    kind?: string | undefined;
+    include_archived?: boolean | undefined;
+}>;
+export type ListCategoriesInput = z.infer<typeof listCategoriesInputSchema>;
+export declare const LIST_CATEGORIES_TOOL_DEF: {
+    name: "tacit_kb_list_categories";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            kind: {
+                type: string;
+                description: string;
+            };
+            include_archived: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildListCategoriesRequest(client: TacitClient, input: ListCategoriesInput): ToolRequest;
+export declare function handleListCategories(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare const createCategoryInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description?: string | undefined;
+}, {
+    name: string;
+    description?: string | undefined;
+}>;
+export type CreateCategoryInput = z.infer<typeof createCategoryInputSchema>;
+export declare const CREATE_CATEGORY_TOOL_DEF: {
+    name: "tacit_kb_create_category";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function buildCreateCategoryRequest(client: TacitClient, input: CreateCategoryInput): ToolRequest;
+export declare function handleCreateCategory(args: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function registerKbTools(server: McpServer, getClientFn: () => Promise<TacitClient>): void;