citekit 0.1.0

package/dist/address.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CiteKit Address Parser — parse and build URI-style addresses.
+ *
+ * Formats:
+ *   doc://resource_id#pages=3-5
+ *   video://resource_id#t=192-230
+ *   audio://resource_id#t=60-120
+ *   image://resource_id#bbox=0.2,0.3,0.8,0.7
+ */
+import type { Location } from "./models.js";
+/**
+ * Parse a CiteKit address into a resource ID and location.
+ *
+ * @example
+ * parseAddress("doc://calculus_book#pages=12-13")
+ * // → { resourceId: "calculus_book", location: { modality: "document", pages: [12, 13] } }
+ */
+export declare function parseAddress(address: string): {
+    resourceId: string;
+    location: Location;
+};
+/**
+ * Build a CiteKit address from a resource ID and location.
+ *
+ * @example
+ * buildAddress("book", { modality: "document", pages: [3, 4, 5] })
+ * // → "doc://book#pages=3-5"
+ */
+export declare function buildAddress(resourceId: string, location: Location): string;
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgB5C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACtB,CAqDA;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA8B3E"}

package/dist/address.js

@@ -0,0 +1,129 @@
+/**
+ * CiteKit Address Parser — parse and build URI-style addresses.
+ *
+ * Formats:
+ *   doc://resource_id#pages=3-5
+ *   video://resource_id#t=192-230
+ *   audio://resource_id#t=60-120
+ *   image://resource_id#bbox=0.2,0.3,0.8,0.7
+ */
+const SCHEME_TO_MODALITY = {
+    doc: "document",
+    video: "video",
+    audio: "audio",
+    image: "image",
+};
+const MODALITY_TO_SCHEME = {
+    document: "doc",
+    video: "video",
+    audio: "audio",
+    image: "image",
+};
+/**
+ * Parse a CiteKit address into a resource ID and location.
+ *
+ * @example
+ * parseAddress("doc://calculus_book#pages=12-13")
+ * // → { resourceId: "calculus_book", location: { modality: "document", pages: [12, 13] } }
+ */
+export function parseAddress(address) {
+    const match = address.match(/^(\w+):\/\/([^#]+)(?:#(.+))?$/);
+    if (!match) {
+        throw new Error(`Invalid CiteKit address: ${address}`);
+    }
+    const [, scheme, resourceId, fragment] = match;
+    const modality = SCHEME_TO_MODALITY[scheme];
+    if (!modality) {
+        throw new Error(`Unknown scheme '${scheme}'. Expected: ${Object.keys(SCHEME_TO_MODALITY).join(", ")}`);
+    }
+    const location = { modality };
+    if (fragment) {
+        const params = Object.fromEntries(fragment.split("&").map((part) => {
+            const [key, value] = part.split("=", 2);
+            return [key, value];
+        }));
+        if (params.pages) {
+            if (params.pages.includes("-")) {
+                const [start, end] = params.pages.split("-").map(Number);
+                location.pages = Array.from({ length: end - start + 1 }, (_, i) => start + i);
+            }
+            else {
+                location.pages = params.pages.split(",").map(Number);
+            }
+        }
+        if (params.t) {
+            const [start, end] = params.t.split("-").map(parseTime);
+            location.start = start;
+            location.end = end;
+        }
+        if (params.bbox) {
+            const parts = params.bbox.split(",").map(Number);
+            if (parts.length !== 4) {
+                throw new Error(`bbox must have 4 values, got ${parts.length}`);
+            }
+            location.bbox = parts;
+        }
+    }
+    return { resourceId, location };
+}
+/**
+ * Build a CiteKit address from a resource ID and location.
+ *
+ * @example
+ * buildAddress("book", { modality: "document", pages: [3, 4, 5] })
+ * // → "doc://book#pages=3-5"
+ */
+export function buildAddress(resourceId, location) {
+    const scheme = MODALITY_TO_SCHEME[location.modality];
+    if (!scheme) {
+        throw new Error(`Unknown modality: ${location.modality}`);
+    }
+    const fragments = [];
+    if (location.pages && location.pages.length > 0) {
+        const sorted = [...location.pages].sort((a, b) => a - b);
+        const isConsecutive = sorted.length === sorted[sorted.length - 1] - sorted[0] + 1;
+        if (isConsecutive) {
+            fragments.push(`pages=${sorted[0]}-${sorted[sorted.length - 1]}`);
+        }
+        else {
+            fragments.push(`pages=${sorted.join(",")}`);
+        }
+    }
+    if (location.start !== undefined && location.end !== undefined) {
+        fragments.push(`t=${formatTime(location.start)}-${formatTime(location.end)}`);
+    }
+    if (location.bbox) {
+        fragments.push(`bbox=${location.bbox.join(",")}`);
+    }
+    const fragment = fragments.join("&");
+    return fragment ? `${scheme}://${resourceId}#${fragment}` : `${scheme}://${resourceId}`;
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function parseTime(timeStr) {
+    const trimmed = timeStr.trim();
+    if (trimmed.includes(":")) {
+        const parts = trimmed.split(":").map(Number);
+        if (parts.length === 3)
+            return parts[0] * 3600 + parts[1] * 60 + parts[2];
+        if (parts.length === 2)
+            return parts[0] * 60 + parts[1];
+    }
+    return Number(trimmed);
+}
+function formatTime(seconds) {
+    if (Number.isInteger(seconds)) {
+        if (seconds >= 3600) {
+            const h = Math.floor(seconds / 3600);
+            const m = Math.floor((seconds % 3600) / 60);
+            const s = seconds % 60;
+            return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+        }
+        if (seconds >= 60) {
+            const m = Math.floor(seconds / 60);
+            const s = seconds % 60;
+            return `${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+        }
+    }
+    return String(seconds);
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CiteKit JavaScript Client.
+ *
+ * Reads/writes resource map JSON files locally and calls the Python
+ * resolver backend for resolution (since resolvers are Python-based).
+ */
+import type { ResourceMap, ResolvedEvidence } from "./models.js";
+export interface CiteKitClientOptions {
+    /** Directory where resource maps are stored. Default: ".resource_maps" */
+    storageDir?: string;
+    /** Directory for resolved output files. Default: ".citekit_output" */
+    outputDir?: string;
+    /** Gemini API Key (can also be set via env GEMINI_API_KEY) */
+    apiKey?: string;
+    /** Gemini Model (default: "gemini-2.0-flash") */
+    model?: string;
+}
+export declare class CiteKitClient {
+    private storageDir;
+    private outputDir;
+    private mapper;
+    private resolvers;
+    constructor(options?: CiteKitClientOptions);
+    /**
+     * Load a previously generated map from local storage.
+     */
+    getMap(resourceId: string): ResourceMap;
+    /**
+     * List all available resource map IDs.
+     */
+    listMaps(): string[];
+    /**
+     * Get the map as a plain object (for JSON serialization / MCP responses).
+     */
+    getStructure(resourceId: string): ResourceMap;
+    /**
+     * Ingest a resource using the configured mapper.
+     */
+    ingest(resourcePath: string, resourceType: string, options?: {
+        resourceId?: string;
+    }): Promise<ResourceMap>;
+    /**
+     * Resolve a node to evidence using the appropriate resolver.
+     */
+    resolve(resourceId: string, nodeId: string): Promise<ResolvedEvidence>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAQ,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAcvE,MAAM,WAAW,oBAAoB;IACjC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA2B;gBAEhC,OAAO,GAAE,oBAAyB;IA4C9C;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAUvC;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAOpB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAM7C;;OAEG;IACG,MAAM,CACR,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,WAAW,CAAC;IAgBvB;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA6B/E"}

package/dist/client.js

@@ -0,0 +1,121 @@
+/**
+ * CiteKit JavaScript Client.
+ *
+ * Reads/writes resource map JSON files locally and calls the Python
+ * resolver backend for resolution (since resolvers are Python-based).
+ */
+import { readFileSync, writeFileSync, readdirSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+// ── Imported Mappers & Resolvers ────────────────────────────────────────
+import { GeminiMapper } from "./mapper/gemini.js";
+import { DocumentResolver } from "./resolvers/document.js";
+import { VideoResolver } from "./resolvers/video.js";
+import { ImageResolver } from "./resolvers/image.js";
+export class CiteKitClient {
+    storageDir;
+    outputDir;
+    mapper;
+    resolvers;
+    constructor(options = {}) {
+        this.storageDir = options.storageDir ?? ".resource_maps";
+        this.outputDir = options.outputDir ?? ".citekit_output";
+        const apiKey = options.apiKey ?? process.env.GEMINI_API_KEY;
+        if (!apiKey) {
+            // We allow client init without key, but ingest will fail if we don't have it eventually.
+            // For now, let's just warn or let the mapper throw.
+            // Actually, the mapper constructor needs it.
+            // If unavailable, we can delay mapper init? Or throw?
+            // Let's assume user must provide it if they want to ingest.
+            // But if they only want resolve(), they might not need it?
+            // Resolution logic doesn't need Gemini.
+            // So we should lazily init mapper or allow null.
+        }
+        // Initialize mapper
+        // Note: For this MVP port, we assume GeminiMapper is the default.
+        if (apiKey) {
+            this.mapper = new GeminiMapper(apiKey, options.model);
+        }
+        else {
+            // Mock mapper that throws
+            this.mapper = {
+                generateMap: async () => { throw new Error("GEMINI_API_KEY required for ingestion."); }
+            };
+        }
+        // Initialize resolvers
+        this.resolvers = {
+            "document": new DocumentResolver(),
+            "video": new VideoResolver(),
+            "image": new ImageResolver(),
+            // Audio uses VideoResolver logic mostly, but we can reuse or just alias?
+            // "audio" -> Generic A/V resolver?
+            // "audio": new VideoResolver(), // ffmpeg handles both
+        };
+        // Ensure directories exist
+        if (!existsSync(this.storageDir))
+            mkdirSync(this.storageDir, { recursive: true });
+        if (!existsSync(this.outputDir))
+            mkdirSync(this.outputDir, { recursive: true });
+    }
+    // ── Map access ──────────────────────────────────────────────────────────
+    /**
+     * Load a previously generated map from local storage.
+     */
+    getMap(resourceId) {
+        const mapPath = join(this.storageDir, `${resourceId}.json`);
+        if (!existsSync(mapPath)) {
+            throw new Error(`No map found for resource '${resourceId}'. Expected at: ${mapPath}`);
+        }
+        return JSON.parse(readFileSync(mapPath, "utf-8"));
+    }
+    /**
+     * List all available resource map IDs.
+     */
+    listMaps() {
+        if (!existsSync(this.storageDir))
+            return [];
+        return readdirSync(this.storageDir)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => f.replace(/\.json$/, ""));
+    }
+    /**
+     * Get the map as a plain object (for JSON serialization / MCP responses).
+     */
+    getStructure(resourceId) {
+        return this.getMap(resourceId);
+    }
+    // ── Ingestion ───────────────────────────────────────────────────────────
+    /**
+     * Ingest a resource using the configured mapper.
+     */
+    async ingest(resourcePath, resourceType, options) {
+        const map = await this.mapper.generateMap(resourcePath, resourceType, options?.resourceId);
+        // Save map
+        const mapPath = join(this.storageDir, `${map.resource_id}.json`);
+        writeFileSync(mapPath, JSON.stringify(map, null, 2));
+        return map;
+    }
+    // ── Resolution ──────────────────────────────────────────────────────────
+    /**
+     * Resolve a node to evidence using the appropriate resolver.
+     */
+    async resolve(resourceId, nodeId) {
+        const map = this.getMap(resourceId);
+        const node = map.nodes.find((n) => n.id === nodeId);
+        if (!node) {
+            throw new Error(`Node '${nodeId}' not found in map '${resourceId}'`);
+        }
+        const type = map.type; // document, video, etc.
+        const resolver = this.resolvers[type];
+        if (!resolver) {
+            // Check if we can fallback?
+            // For now, if no resolver, failure.
+            // Maybe handle "audio" with video resolver?
+            if (type === "audio" && this.resolvers["video"]) {
+                return this.resolvers["video"].resolve(resourceId, nodeId, map.source_path, node.location, this.outputDir);
+            }
+            throw new Error(`No resolver implementation for resource type '${type}'`);
+        }
+        return resolver.resolve(resourceId, nodeId, map.source_path, node.location, this.outputDir);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./client.js";
+export * from "./models.js";
+export * from "./mapper/base.js";
+export * from "./mapper/gemini.js";
+export * from "./resolvers/base.js";
+export * from "./resolvers/document.js";
+export * from "./resolvers/video.js";
+export * from "./resolvers/image.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./client.js";
+export * from "./models.js";
+export * from "./mapper/base.js";
+export * from "./mapper/gemini.js";
+export * from "./resolvers/base.js";
+export * from "./resolvers/document.js";
+export * from "./resolvers/video.js";
+export * from "./resolvers/image.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/mapper/base.d.ts

@@ -0,0 +1,5 @@
+import type { ResourceMap } from "../models.js";
+export interface MapperProvider {
+    generateMap(resourcePath: string, resourceType: string, resourceId?: string): Promise<ResourceMap>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/mapper/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/mapper/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC3B,WAAW,CACP,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B"}

package/dist/mapper/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/mapper/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/mapper/base.ts"],"names":[],"mappings":""}

package/dist/mapper/gemini.d.ts

@@ -0,0 +1,13 @@
+import { MapperProvider } from "./base.js";
+import type { ResourceMap } from "../models.js";
+export declare class GeminiMapper implements MapperProvider {
+    private genAI;
+    private model;
+    constructor(apiKey: string, modelName?: string);
+    generateMap(resourcePath: string, resourceType: string, resourceId?: string): Promise<ResourceMap>;
+    private mapDocument;
+    private mapVideo;
+    private callGemini;
+    private parseNodesResponse;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/mapper/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/mapper/gemini.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC;AAkDhE,qBAAa,YAAa,YAAW,cAAc;IAC/C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,KAAK,CAAM;gBAEP,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAA2B;IAK5D,WAAW,CACb,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC;YA2BT,WAAW;YA2BX,QAAQ;YAkBR,UAAU;IAOxB,OAAO,CAAC,kBAAkB;CA+C7B"}

package/dist/mapper/gemini.js

@@ -0,0 +1,169 @@
+import { GoogleGenerativeAI } from "@google/generative-ai";
+import { readFileSync, existsSync } from "node:fs";
+import { basename, extname } from "node:path";
+import { createRequire } from "node:module";
+// pdf-parse is a CJS module, best imported via require in ESM
+const require = createRequire(import.meta.url);
+const pdf = require("pdf-parse");
+// ── Prompt Templates ────────────────────────────────────────────────────────
+const DOCUMENT_PROMPT = `\
+You are a structure analyzer. Given the text content of a document, produce a JSON map \
+that identifies the key concepts, sections, definitions, examples, and diagrams.
+
+Each node must have:
+- "id": a dot-separated identifier (e.g. "chapter1.derivatives.definition")
+- "title": a short human-readable title
+- "type": one of "section", "definition", "example", "explanation", "diagram", "theorem", "exercise", "summary"
+- "location": { "modality": "document", "pages": [list of 1-indexed page numbers] }
+- "summary": a 1-2 sentence summary of what this section covers
+
+Rules:
+- Be thorough — capture ALL distinct concepts, not just top-level sections.
+- Page numbers are 1-indexed.
+- Keep summaries concise but informative.
+- IDs should be hierarchical and descriptive.
+
+Return ONLY a JSON array of nodes. No markdown, no explanation.
+
+Document title: {title}
+
+--- DOCUMENT TEXT (page-delimited) ---
+{text}
+`;
+const VIDEO_PROMPT = `\
+You are a video structure analyzer. Given metadata about a video, identify key segments.
+
+Video duration: {duration} seconds
+Filename: {filename}
+
+Each node must have:
+- "id": a descriptive dot-separated identifier
+- "title": a short human-readable title
+- "type": one of "introduction", "explanation", "example", "demonstration", "summary", "transition"
+- "location": { "modality": "video", "start": <seconds>, "end": <seconds> }
+- "summary": brief description of what this segment covers
+
+Rules:
+- Segments should be meaningful chunks, not arbitrary splits.
+- start/end are in seconds.
+- Cover the entire video duration.
+
+Return ONLY a JSON array of nodes. No markdown, no explanation.
+`;
+export class GeminiMapper {
+    genAI;
+    model;
+    constructor(apiKey, modelName = "gemini-2.0-flash") {
+        this.genAI = new GoogleGenerativeAI(apiKey);
+        this.model = this.genAI.getGenerativeModel({ model: modelName });
+    }
+    async generateMap(resourcePath, resourceType, resourceId) {
+        if (!existsSync(resourcePath)) {
+            throw new Error(`Resource not found: ${resourcePath}`);
+        }
+        const id = resourceId || basename(resourcePath, extname(resourcePath));
+        let nodes = [];
+        if (resourceType === "document") {
+            nodes = await this.mapDocument(resourcePath);
+        }
+        else if (resourceType === "video") {
+            nodes = await this.mapVideo(resourcePath);
+        }
+        else {
+            // Fallback or TODO for image/audio
+            throw new Error(`Resource type '${resourceType}' not fully implemented in JS port yet.`);
+        }
+        return {
+            resource_id: id,
+            type: resourceType,
+            title: id.replace(/[_-]/g, " ").replace(/\b\w/g, c => c.toUpperCase()),
+            source_path: resourcePath,
+            nodes: nodes,
+            created_at: new Date().toISOString()
+        };
+    }
+    async mapDocument(path) {
+        const dataBuffer = readFileSync(path);
+        // Use pdf-parse to extract text. Note: pdf-parse merges pages by default.
+        // To get basic page info we might need a custom render callback, but 
+        // for MVP we'll just extract all text and let Gemini infer or use a simple split.
+        // Actually, pdf-parse provides page count but text is merged.
+        // We can use a pager render callback to insert delimiters.
+        const options = {
+            pagerender: (pageData) => {
+                return `--- PAGE ${pageData.pageIndex + 1} ---\n` +
+                    pageData.getTextContent().items.map((i) => i.str).join(" ");
+            }
+        };
+        // TypeScript workaround for pdf-parse types if needed, but import * as pdf works usually.
+        // @ts-ignore
+        const data = await pdf(dataBuffer, options);
+        const prompt = DOCUMENT_PROMPT
+            .replace("{title}", basename(path))
+            .replace("{text}", data.text);
+        return this.callGemini(prompt);
+    }
+    async mapVideo(path) {
+        // We need duration. We can use fluent-ffmpeg to probe.
+        const { ffprobe } = await import("fluent-ffmpeg");
+        const duration = await new Promise((resolve, reject) => {
+            ffprobe(path, (err, metadata) => {
+                if (err)
+                    return reject(err);
+                resolve(metadata.format.duration || 0);
+            });
+        });
+        const prompt = VIDEO_PROMPT
+            .replace("{duration}", duration.toString())
+            .replace("{filename}", basename(path));
+        return this.callGemini(prompt);
+    }
+    async callGemini(prompt) {
+        const result = await this.model.generateContent(prompt);
+        const response = await result.response;
+        const text = response.text();
+        return this.parseNodesResponse(text);
+    }
+    parseNodesResponse(text) {
+        let cleaned = text.trim();
+        // Regex to extract JSON array [ ... ]
+        const match = cleaned.match(/\[.*\]/s);
+        if (match) {
+            cleaned = match[0];
+        }
+        // Remove markdown fences
+        if (cleaned.startsWith("```")) {
+            cleaned = cleaned.replace(/^```[a-z]*\n/, "").replace(/\n```$/, "");
+        }
+        // Fix trailing commas: remove comma before ] or }
+        cleaned = cleaned.replace(/,\s*([\]}])/g, "$1");
+        // Fix object comma separation: } { -> }, {
+        cleaned = cleaned.replace(/}\s*{/g, "}, {");
+        // Attempt verify/repair brackets
+        const openBrackets = (cleaned.match(/\[/g) || []).length - (cleaned.match(/\]/g) || []).length;
+        const openBraces = (cleaned.match(/{/g) || []).length - (cleaned.match(/}/g) || []).length;
+        if (openBraces > 0) {
+            cleaned = cleaned.replace(/,+$/, "");
+            cleaned += "}".repeat(openBraces);
+        }
+        if (openBrackets > 0) {
+            cleaned = cleaned.replace(/,+$/, "");
+            cleaned += "]".repeat(openBrackets);
+        }
+        try {
+            const rawNodes = JSON.parse(cleaned);
+            return rawNodes.map((raw) => ({
+                id: raw.id,
+                title: raw.title,
+                type: raw.type || "section",
+                location: raw.location,
+                summary: raw.summary
+            }));
+        }
+        catch (e) {
+            console.error("DEBUG: Failed JSON parse. Raw:", cleaned);
+            throw new Error(`Failed to parse Gemini JSON: ${e}`);
+        }
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/mapper/gemini.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CiteKit MCP Server (JavaScript/TypeScript).
+ *
+ * Exposes listResources, getStructure, and resolve tools via MCP.
+ * Reads maps from local JSON and delegates resolution to the Python SDK.
+ *
+ * Run with:
+ *   npx tsx src/mcp-server.ts
+ */
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/mcp-server.js

@@ -0,0 +1,124 @@
+/**
+ * CiteKit MCP Server (JavaScript/TypeScript).
+ *
+ * Exposes listResources, getStructure, and resolve tools via MCP.
+ * Reads maps from local JSON and delegates resolution to the Python SDK.
+ *
+ * Run with:
+ *   npx tsx src/mcp-server.ts
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CiteKitClient } from "./client.js";
+function createServer(storageDir, outputDir) {
+    const server = new Server({ name: "citekit", version: "0.1.0" }, { capabilities: { tools: {} } });
+    const client = new CiteKitClient({ storageDir, outputDir });
+    // ── List tools ──────────────────────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "listResources",
+                description: "List all available resource map IDs that have been ingested.",
+                inputSchema: { type: "object", properties: {} },
+            },
+            {
+                name: "getStructure",
+                description: "Get the structured map of a resource. Returns nodes with concept/section info and physical locations.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        resource_id: {
+                            type: "string",
+                            description: "The resource ID to get the structure for.",
+                        },
+                    },
+                    required: ["resource_id"],
+                },
+            },
+            {
+                name: "resolve",
+                description: "Resolve a node into extracted evidence (mini-PDF, clip, or crop).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        resource_id: {
+                            type: "string",
+                            description: "The resource ID.",
+                        },
+                        node_id: {
+                            type: "string",
+                            description: "The node ID to resolve.",
+                        },
+                    },
+                    required: ["resource_id", "node_id"],
+                },
+            },
+        ],
+    }));
+    // ── Call tools ──────────────────────────────────────────────────────────
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            if (name === "listResources") {
+                const resources = client.listMaps();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ resources }, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (name === "getStructure") {
+                const resourceId = args.resource_id;
+                const structure = client.getStructure(resourceId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(structure, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (name === "resolve") {
+                const { resource_id, node_id } = args;
+                const evidence = client.resolve(resource_id, node_id);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(evidence, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+// ── Main ────────────────────────────────────────────────────────────────────
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CiteKit — TypeScript interfaces and types.
+ *
+ * These mirror the Python SDK's Pydantic models exactly,
+ * so maps generated by either SDK are cross-compatible.
+ */
+/** Physical location within a resource. */
+export interface Location {
+    modality: "document" | "video" | "audio" | "image";
+    /** Document: 1-indexed page numbers. */
+    pages?: number[];
+    /** Video/Audio: start time in seconds. */
+    start?: number;
+    /** Video/Audio: end time in seconds. */
+    end?: number;
+    /** Image: normalized bounding box [x1, y1, x2, y2] (0.0–1.0). */
+    bbox?: [number, number, number, number];
+}
+/** A concept or section within a resource. */
+export interface Node {
+    /** Dot-separated identifier, e.g. "derivatives.definition". */
+    id: string;
+    /** Human-readable title. */
+    title?: string;
+    /** Node type: definition, example, explanation, diagram, etc. */
+    type: string;
+    /** Where this node lives in the resource. */
+    location: Location;
+    /** 1-2 sentence summary. */
+    summary?: string;
+}
+/** Structured map of a resource — the first output of ingestion. */
+export interface ResourceMap {
+    resource_id: string;
+    type: "document" | "video" | "audio" | "image";
+    title: string;
+    source_path: string;
+    nodes: Node[];
+    created_at: string;
+}
+/** Result of resolving a node. */
+export interface ResolvedEvidence {
+    /** Path to the extracted file (mini-PDF, clip, crop, etc.) */
+    output_path: string;
+    modality: string;
+    /** URI-style address, e.g. doc://book#pages=12-13 */
+    address: string;
+    node: Node;
+    resource_id: string;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACrB,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAEnD,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,8CAA8C;AAC9C,MAAM,WAAW,IAAI;IACjB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IAEX,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC7B,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACvB"}

package/dist/models.js

@@ -0,0 +1,8 @@
+/**
+ * CiteKit — TypeScript interfaces and types.
+ *
+ * These mirror the Python SDK's Pydantic models exactly,
+ * so maps generated by either SDK are cross-compatible.
+ */
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/resolvers/base.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedEvidence } from "../models.js";
+export interface Resolver {
+    resolve(resourceId: string, nodeId: string, sourcePath: string, location: any, outputDir: string): Promise<ResolvedEvidence>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/resolvers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/resolvers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,QAAQ;IACrB,OAAO,CACH,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChC"}

package/dist/resolvers/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/resolvers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/resolvers/base.ts"],"names":[],"mappings":""}

package/dist/resolvers/document.d.ts

@@ -0,0 +1,6 @@
+import { Resolver } from "./base.js";
+import type { ResolvedEvidence } from "../models.js";
+export declare class DocumentResolver implements Resolver {
+    resolve(resourceId: string, nodeId: string, sourcePath: string, location: any, outputDir: string): Promise<ResolvedEvidence>;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/resolvers/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/resolvers/document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,qBAAa,gBAAiB,YAAW,QAAQ;IACvC,OAAO,CACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;CAiC/B"}

package/dist/resolvers/document.js

@@ -0,0 +1,32 @@
+import { PDFDocument } from "pdf-lib";
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export class DocumentResolver {
+    async resolve(resourceId, nodeId, sourcePath, location, outputDir) {
+        if (!location.pages || location.pages.length === 0) {
+            throw new Error(`Node ${nodeId} has no pages specified.`);
+        }
+        const pdfBytes = readFileSync(sourcePath);
+        const srcDoc = await PDFDocument.load(pdfBytes);
+        const newDoc = await PDFDocument.create();
+        // Pages are 1-indexed in our map, but 0-indexed in pdf-lib
+        const pagesToCopy = location.pages.map((p) => p - 1);
+        // Copy pages
+        const copiedPages = await newDoc.copyPages(srcDoc, pagesToCopy);
+        copiedPages.forEach((page) => newDoc.addPage(page));
+        const outputBytes = await newDoc.save();
+        // Generate filename similar to Python SDK: {resource}_{pages}_{p1}_{p2}.pdf
+        const pageStr = location.pages.join("_");
+        const filename = `${resourceId}_pages_${pageStr}.pdf`;
+        const outputPath = join(outputDir, filename);
+        writeFileSync(outputPath, outputBytes);
+        return {
+            output_path: outputPath,
+            modality: "document",
+            address: `doc://${resourceId}#pages=${location.pages[0]}-${location.pages[location.pages.length - 1]}`,
+            node: { id: nodeId, location: location }, // Only minimal node needed? Or fetch full?
+            resource_id: resourceId
+        };
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/resolvers/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/resolvers/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,OAAO,gBAAgB;IACzB,KAAK,CAAC,OAAO,CACT,UAAkB,EAClB,MAAc,EACd,UAAkB,EAClB,QAAa,EACb,SAAiB;QAEjB,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,0BAA0B,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAE1C,2DAA2D;QAC3D,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,aAAa;QACb,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChE,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAExC,4EAA4E;QAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,UAAU,UAAU,OAAO,MAAM,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE7C,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEvC,OAAO;YACH,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,SAAS,UAAU,UAAU,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;YACtG,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAS,EAAE,2CAA2C;YAC5F,WAAW,EAAE,UAAU;SAC1B,CAAC;IACN,CAAC;CACJ"}

package/dist/resolvers/image.d.ts

@@ -0,0 +1,6 @@
+import { Resolver } from "./base.js";
+import type { ResolvedEvidence } from "../models.js";
+export declare class ImageResolver implements Resolver {
+    resolve(resourceId: string, nodeId: string, sourcePath: string, location: any, outputDir: string): Promise<ResolvedEvidence>;
+}
+//# sourceMappingURL=image.d.ts.map

package/dist/resolvers/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/resolvers/image.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,qBAAa,aAAc,YAAW,QAAQ;IACpC,OAAO,CACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;CAuC/B"}

package/dist/resolvers/image.js

@@ -0,0 +1,36 @@
+import sharp from "sharp";
+import { join } from "node:path";
+export class ImageResolver {
+    async resolve(resourceId, nodeId, sourcePath, location, outputDir) {
+        if (!location.bbox || location.bbox.length !== 4) {
+            throw new Error(`Node ${nodeId} missing valid bbox.`);
+        }
+        const [x1, y1, x2, y2] = location.bbox;
+        // Load original to get dimensions
+        const image = sharp(sourcePath);
+        const metadata = await image.metadata();
+        if (!metadata.width || !metadata.height) {
+            throw new Error("Could not read image dimensions.");
+        }
+        const width = metadata.width;
+        const height = metadata.height;
+        // Convert normalized bbox (0-1) to pixel coordinates
+        const left = Math.floor(x1 * width);
+        const top = Math.floor(y1 * height);
+        const cropWidth = Math.floor((x2 - x1) * width);
+        const cropHeight = Math.floor((y2 - y1) * height);
+        const filename = `${resourceId}_crop_${left}_${top}.png`;
+        const outputPath = join(outputDir, filename);
+        await image
+            .extract({ left, top, width: cropWidth, height: cropHeight })
+            .toFile(outputPath);
+        return {
+            output_path: outputPath,
+            modality: "image",
+            address: `image://${resourceId}#rect=${x1},${y1},${x2},${y2}`,
+            node: { id: nodeId, location: location },
+            resource_id: resourceId
+        };
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/resolvers/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/resolvers/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,OAAO,aAAa;IACtB,KAAK,CAAC,OAAO,CACT,UAAkB,EAClB,MAAc,EACd,UAAkB,EAClB,QAAa,EACb,SAAiB;QAEjB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,sBAAsB,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QAEvC,kCAAkC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QAExC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE/B,qDAAqD;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG,GAAG,UAAU,SAAS,IAAI,IAAI,GAAG,MAAM,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE7C,MAAM,KAAK;aACN,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;aAC5D,MAAM,CAAC,UAAU,CAAC,CAAC;QAExB,OAAO;YACH,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,WAAW,UAAU,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC7D,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAS;YAC/C,WAAW,EAAE,UAAU;SAC1B,CAAC;IACN,CAAC;CACJ"}

package/dist/resolvers/video.d.ts

@@ -0,0 +1,6 @@
+import { Resolver } from "./base.js";
+import type { ResolvedEvidence } from "../models.js";
+export declare class VideoResolver implements Resolver {
+    resolve(resourceId: string, nodeId: string, sourcePath: string, location: any, outputDir: string): Promise<ResolvedEvidence>;
+}
+//# sourceMappingURL=video.d.ts.map

package/dist/resolvers/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../src/resolvers/video.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,qBAAa,aAAc,YAAW,QAAQ;IACpC,OAAO,CACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;CA+B/B"}

package/dist/resolvers/video.js

@@ -0,0 +1,33 @@
+import ffmpeg from "fluent-ffmpeg";
+import { join } from "node:path";
+export class VideoResolver {
+    async resolve(resourceId, nodeId, sourcePath, location, outputDir) {
+        if (location.start === undefined || location.end === undefined) {
+            throw new Error(`Node ${nodeId} missing start/end times.`);
+        }
+        const start = location.start;
+        const duration = location.end - location.start;
+        const filename = `${resourceId}_clip_${start}_${location.end}.mp4`;
+        const outputPath = join(outputDir, filename);
+        return new Promise((resolve, reject) => {
+            ffmpeg(sourcePath)
+                .setStartTime(start)
+                .setDuration(duration)
+                .output(outputPath)
+                .on("end", () => {
+                resolve({
+                    output_path: outputPath,
+                    modality: "video",
+                    address: `video://${resourceId}#t=${start},${location.end}`,
+                    node: { id: nodeId, location: location },
+                    resource_id: resourceId
+                });
+            })
+                .on("error", (err) => {
+                reject(new Error(`ffmpeg failed: ${err.message}`));
+            })
+                .run();
+        });
+    }
+}
+//# sourceMappingURL=video.js.map

package/dist/resolvers/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/resolvers/video.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,OAAO,aAAa;IACtB,KAAK,CAAC,OAAO,CACT,UAAkB,EAClB,MAAc,EACd,UAAkB,EAClB,QAAa,EACb,SAAiB;QAEjB,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,2BAA2B,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC;QAE/C,MAAM,QAAQ,GAAG,GAAG,UAAU,SAAS,KAAK,IAAI,QAAQ,CAAC,GAAG,MAAM,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,CAAC,UAAU,CAAC;iBACb,YAAY,CAAC,KAAK,CAAC;iBACnB,WAAW,CAAC,QAAQ,CAAC;iBACrB,MAAM,CAAC,UAAU,CAAC;iBAClB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACZ,OAAO,CAAC;oBACJ,WAAW,EAAE,UAAU;oBACvB,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,WAAW,UAAU,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,EAAE;oBAC3D,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAS;oBAC/C,WAAW,EAAE,UAAU;iBAC1B,CAAC,CAAC;YACP,CAAC,CAAC;iBACD,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACjB,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC;iBACD,GAAG,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "citekit",
+    "version": "0.1.0",
+    "description": "A local SDK that lets AI agents open specific parts of files instead of sending entire documents.",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch"
+    },
+    "dependencies": {
+        "@google/generative-ai": "^0.24.1",
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "fluent-ffmpeg": "^2.1.3",
+        "pdf-lib": "^1.17.1",
+        "pdf-parse": "^2.4.5",
+        "sharp": "^0.34.5",
+        "zod": "^4.3.6"
+    },
+    "devDependencies": {
+        "@types/fluent-ffmpeg": "^2.1.28",
+        "@types/node": "^20.0.0",
+        "@types/pdf-parse": "^1.1.5",
+        "typescript": "^5.4.0"
+    },
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/citekit/citekit.git",
+        "directory": "javascript"
+    },
+    "keywords": [
+        "ai",
+        "sdk",
+        "llm",
+        "mcp",
+        "document",
+        "video"
+    ],
+    "author": "",
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ]
+}