@telvok/librarian-mcp 1.0.0

package/dist/library/schemas.d.ts

@@ -0,0 +1,324 @@
+import { z } from 'zod';
+export declare const SourceTypeSchema: z.ZodEnum<["local", "imported", "archived"]>;
+export type SourceType = z.infer<typeof SourceTypeSchema>;
+export declare const EntrySourceSchema: z.ZodEnum<["manual", "precompact", "imported"]>;
+export type EntrySource = z.infer<typeof EntrySourceSchema>;
+export declare const LibraryEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    topics: z.ZodArray<z.ZodString, "many">;
+    content: z.ZodString;
+    created: z.ZodString;
+    source: z.ZodEnum<["local", "imported", "archived"]>;
+    origin: z.ZodOptional<z.ZodEnum<["manual", "precompact", "imported"]>>;
+    imported_from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    created: string;
+    source: "local" | "imported" | "archived";
+    id: string;
+    topics: string[];
+    origin?: "imported" | "manual" | "precompact" | undefined;
+    imported_from?: string | undefined;
+}, {
+    content: string;
+    created: string;
+    source: "local" | "imported" | "archived";
+    id: string;
+    topics: string[];
+    origin?: "imported" | "manual" | "precompact" | undefined;
+    imported_from?: string | undefined;
+}>;
+export type LibraryEntry = z.infer<typeof LibraryEntrySchema>;
+export declare const FrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    topics: z.ZodArray<z.ZodString, "many">;
+    created: z.ZodString;
+    source: z.ZodOptional<z.ZodEnum<["manual", "precompact", "imported"]>>;
+    imported_from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    created: string;
+    id: string;
+    topics: string[];
+    source?: "imported" | "manual" | "precompact" | undefined;
+    imported_from?: string | undefined;
+}, {
+    created: string;
+    id: string;
+    topics: string[];
+    source?: "imported" | "manual" | "precompact" | undefined;
+    imported_from?: string | undefined;
+}>;
+export type Frontmatter = z.infer<typeof FrontmatterSchema>;
+export declare const BriefParamsSchema: z.ZodObject<{
+    topic: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    context?: string | undefined;
+}, {
+    topic: string;
+    context?: string | undefined;
+}>;
+export type BriefParams = z.infer<typeof BriefParamsSchema>;
+export declare const RecordParamsSchema: z.ZodObject<{
+    topics: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    topics: string | string[];
+}, {
+    content: string;
+    topics: string | string[];
+}>;
+export type RecordParams = z.infer<typeof RecordParamsSchema>;
+export declare const AdoptParamsSchema: z.ZodObject<{
+    entry_id: z.ZodString;
+    library_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entry_id: string;
+    library_name?: string | undefined;
+}, {
+    entry_id: string;
+    library_name?: string | undefined;
+}>;
+export type AdoptParams = z.infer<typeof AdoptParamsSchema>;
+export declare const BriefResultSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        topics: z.ZodArray<z.ZodString, "many">;
+        content: z.ZodString;
+        created: z.ZodString;
+        source: z.ZodEnum<["local", "imported", "archived"]>;
+        origin: z.ZodOptional<z.ZodEnum<["manual", "precompact", "imported"]>>;
+        imported_from: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }>, "many">;
+    conflict: z.ZodOptional<z.ZodBoolean>;
+    conflict_summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }[];
+    conflict?: boolean | undefined;
+    conflict_summary?: string | undefined;
+}, {
+    entries: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }[];
+    conflict?: boolean | undefined;
+    conflict_summary?: string | undefined;
+}>;
+export type BriefResult = z.infer<typeof BriefResultSchema>;
+export declare const ImportedLibrarySchema: z.ZodObject<{
+    name: z.ZodString;
+    entry_count: z.ZodNumber;
+    purchased_at: z.ZodString;
+    sync_preference: z.ZodOptional<z.ZodEnum<["auto", "manual", "pinned"]>>;
+    last_synced: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    entry_count: number;
+    purchased_at: string;
+    sync_preference?: "manual" | "auto" | "pinned" | undefined;
+    last_synced?: string | undefined;
+}, {
+    name: string;
+    entry_count: number;
+    purchased_at: string;
+    sync_preference?: "manual" | "auto" | "pinned" | undefined;
+    last_synced?: string | undefined;
+}>;
+export type ImportedLibrary = z.infer<typeof ImportedLibrarySchema>;
+export declare const StateResultSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        topics: z.ZodArray<z.ZodString, "many">;
+        content: z.ZodString;
+        created: z.ZodString;
+        source: z.ZodEnum<["local", "imported", "archived"]>;
+        origin: z.ZodOptional<z.ZodEnum<["manual", "precompact", "imported"]>>;
+        imported_from: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }>, "many">;
+    imported_libraries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        entry_count: z.ZodNumber;
+        purchased_at: z.ZodString;
+        sync_preference: z.ZodOptional<z.ZodEnum<["auto", "manual", "pinned"]>>;
+        last_synced: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        entry_count: number;
+        purchased_at: string;
+        sync_preference?: "manual" | "auto" | "pinned" | undefined;
+        last_synced?: string | undefined;
+    }, {
+        name: string;
+        entry_count: number;
+        purchased_at: string;
+        sync_preference?: "manual" | "auto" | "pinned" | undefined;
+        last_synced?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }[];
+    imported_libraries: {
+        name: string;
+        entry_count: number;
+        purchased_at: string;
+        sync_preference?: "manual" | "auto" | "pinned" | undefined;
+        last_synced?: string | undefined;
+    }[];
+}, {
+    entries: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }[];
+    imported_libraries: {
+        name: string;
+        entry_count: number;
+        purchased_at: string;
+        sync_preference?: "manual" | "auto" | "pinned" | undefined;
+        last_synced?: string | undefined;
+    }[];
+}>;
+export type StateResult = z.infer<typeof StateResultSchema>;
+export declare const RecordResultSchema: z.ZodObject<{
+    entry: z.ZodObject<{
+        id: z.ZodString;
+        topics: z.ZodArray<z.ZodString, "many">;
+        content: z.ZodString;
+        created: z.ZodString;
+        source: z.ZodEnum<["local", "imported", "archived"]>;
+        origin: z.ZodOptional<z.ZodEnum<["manual", "precompact", "imported"]>>;
+        imported_from: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }, {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    }>;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    entry: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    };
+}, {
+    path: string;
+    entry: {
+        content: string;
+        created: string;
+        source: "local" | "imported" | "archived";
+        id: string;
+        topics: string[];
+        origin?: "imported" | "manual" | "precompact" | undefined;
+        imported_from?: string | undefined;
+    };
+}>;
+export type RecordResult = z.infer<typeof RecordResultSchema>;
+export declare const ExtractedEntrySchema: z.ZodObject<{
+    topics: z.ZodArray<z.ZodString, "many">;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    topics: string[];
+}, {
+    content: string;
+    topics: string[];
+}>;
+export type ExtractedEntry = z.infer<typeof ExtractedEntrySchema>;
+export declare const ExtractionResultSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        topics: z.ZodArray<z.ZodString, "many">;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        topics: string[];
+    }, {
+        content: string;
+        topics: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        content: string;
+        topics: string[];
+    }[];
+}, {
+    entries: {
+        content: string;
+        topics: string[];
+    }[];
+}>;
+export type ExtractionResult = z.infer<typeof ExtractionResultSchema>;

package/dist/library/schemas.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+// ============================================================================
+// Core Types
+// ============================================================================
+export const SourceTypeSchema = z.enum(['local', 'imported', 'archived']);
+export const EntrySourceSchema = z.enum(['manual', 'precompact', 'imported']);
+// ============================================================================
+// Library Entry
+// ============================================================================
+export const LibraryEntrySchema = z.object({
+    id: z.string().uuid(),
+    topics: z.array(z.string().min(1)).min(1),
+    content: z.string().min(1),
+    created: z.string().datetime(),
+    source: SourceTypeSchema,
+    origin: EntrySourceSchema.optional(),
+    imported_from: z.string().optional(),
+});
+// ============================================================================
+// File Frontmatter (YAML)
+// ============================================================================
+export const FrontmatterSchema = z.object({
+    id: z.string().uuid(),
+    topics: z.array(z.string().min(1)).min(1),
+    created: z.string().datetime(),
+    source: EntrySourceSchema.optional(),
+    imported_from: z.string().optional(),
+});
+// ============================================================================
+// MCP Tool Parameters
+// ============================================================================
+export const BriefParamsSchema = z.object({
+    topic: z.string().min(1).describe('What to query (e.g., "deployment", "api-design")'),
+    context: z.string().optional().describe('Additional context to narrow results'),
+});
+export const RecordParamsSchema = z.object({
+    topics: z.union([
+        z.string().min(1),
+        z.array(z.string().min(1)).min(1),
+    ]).describe('Topic tags - string or array (e.g., "deployment" or ["stripe", "webhooks"])'),
+    content: z.string().min(1).describe('The reasoning to record'),
+});
+export const AdoptParamsSchema = z.object({
+    entry_id: z.string().uuid().describe('ID of the imported entry to adopt'),
+    library_name: z.string().optional().describe('Name of the imported library'),
+});
+// ============================================================================
+// MCP Tool Results
+// ============================================================================
+export const BriefResultSchema = z.object({
+    entries: z.array(LibraryEntrySchema),
+    conflict: z.boolean().optional(),
+    conflict_summary: z.string().optional(),
+});
+export const ImportedLibrarySchema = z.object({
+    name: z.string(),
+    entry_count: z.number(),
+    purchased_at: z.string().datetime(),
+    sync_preference: z.enum(['auto', 'manual', 'pinned']).optional(),
+    last_synced: z.string().datetime().optional(),
+});
+export const StateResultSchema = z.object({
+    entries: z.array(LibraryEntrySchema),
+    imported_libraries: z.array(ImportedLibrarySchema),
+});
+export const RecordResultSchema = z.object({
+    entry: LibraryEntrySchema,
+    path: z.string(),
+});
+// ============================================================================
+// Extraction Types
+// ============================================================================
+export const ExtractedEntrySchema = z.object({
+    topics: z.array(z.string().min(1)).min(1),
+    content: z.string().min(1),
+});
+export const ExtractionResultSchema = z.object({
+    entries: z.array(ExtractedEntrySchema),
+});

package/dist/library/storage.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Get the library root path.
+ * Uses .librarian/ in the current working directory.
+ */
+export declare function getLibraryPath(): string;
+/**
+ * Get the local entries path.
+ */
+export declare function getLocalPath(libraryPath: string): string;
+/**
+ * Get the imported entries path.
+ */
+export declare function getImportedPath(libraryPath: string): string;
+/**
+ * Get the archived entries path.
+ */
+export declare function getArchivedPath(libraryPath: string): string;

package/dist/library/storage.js

@@ -0,0 +1,29 @@
+import * as path from 'path';
+// ============================================================================
+// Path Utilities
+// ============================================================================
+/**
+ * Get the library root path.
+ * Uses .librarian/ in the current working directory.
+ */
+export function getLibraryPath() {
+    return path.join(process.cwd(), '.librarian');
+}
+/**
+ * Get the local entries path.
+ */
+export function getLocalPath(libraryPath) {
+    return path.join(libraryPath, 'local');
+}
+/**
+ * Get the imported entries path.
+ */
+export function getImportedPath(libraryPath) {
+    return path.join(libraryPath, 'imported');
+}
+/**
+ * Get the archived entries path.
+ */
+export function getArchivedPath(libraryPath) {
+    return path.join(libraryPath, 'archived');
+}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { briefTool } from './tools/brief.js';
+import { recordTool } from './tools/record.js';
+import { adoptTool } from './tools/adopt.js';
+const server = new Server({
+    name: 'librarian',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: briefTool.name,
+                description: briefTool.description,
+                inputSchema: briefTool.inputSchema,
+            },
+            {
+                name: recordTool.name,
+                description: recordTool.description,
+                inputSchema: recordTool.inputSchema,
+            },
+            {
+                name: adoptTool.name,
+                description: adoptTool.description,
+                inputSchema: adoptTool.inputSchema,
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case 'brief':
+                result = await briefTool.handler(args);
+                break;
+            case 'record':
+                result = await recordTool.handler(args);
+                break;
+            case 'adopt':
+                result = await adoptTool.handler(args);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: message }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/tools/adopt.d.ts

@@ -0,0 +1,24 @@
+export interface AdoptResult {
+    success: boolean;
+    from: string;
+    to: string;
+}
+export declare const adoptTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler(args: unknown): Promise<AdoptResult>;
+};