@alextis59/athena 1.0.0

package/dist/parsers/types.d.ts

@@ -0,0 +1,48 @@
+import type { SourceKind } from "../shared/types.js";
+export interface ParserWarning {
+    code: string;
+    message: string;
+    startLine?: number;
+    endLine?: number;
+}
+export interface ParserArtifactDraft {
+    kind: string;
+    payload: unknown;
+}
+export interface ParsedBlock {
+    kind: "heading" | "paragraph" | "code" | "list" | "table" | "raw";
+    text: string;
+    normalizedText: string;
+    startLine: number;
+    endLine: number;
+    headingPath: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ParsedDocument {
+    parserName: string;
+    parserVersion: string;
+    sourceKind: SourceKind;
+    title: string | null;
+    text: string;
+    normalizedText: string;
+    blocks: ParsedBlock[];
+    warnings: ParserWarning[];
+    metadata?: Record<string, unknown>;
+    artifacts?: ParserArtifactDraft[];
+}
+export interface ChunkingOptions {
+    targetTokens: number;
+    overlapTokens: number;
+    hardMaxTokens: number;
+}
+export interface ChunkDraft {
+    ordinal: number;
+    text: string;
+    normalizedText: string;
+    headingPath: string[];
+    startLine: number;
+    endLine: number;
+    tokenEstimate: number;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/parsers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parsers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/parsers/types.js

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

package/dist/parsers/types.js.map

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

package/dist/retrieval/index.d.ts

@@ -0,0 +1,4 @@
+export { toolSchemas } from "./schemas.js";
+export { RetrievalToolRuntime } from "./tools.js";
+export type { GrepDocsInput, GrepDocsResult, ListDocsInput, ListDocsResult, ReadPdfSourceInput, ReadPdfSourceResult, ReadSourceRangeInput, ReadSourceRangeResult, RelatedChunkResult, RelatedChunksInput, RetrievalTrace, SearchDocsInput, SearchDocsMode, SearchDocsResult } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/retrieval/index.js

@@ -0,0 +1,3 @@
+export { toolSchemas } from "./schemas.js";
+export { RetrievalToolRuntime } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/retrieval/schemas.d.ts

@@ -0,0 +1,127 @@
+export declare const toolSchemas: {
+    readonly searchDocs: {
+        readonly type: "object";
+        readonly required: readonly ["query"];
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 50;
+            };
+            readonly pathPrefix: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: "string";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+    readonly readSourceRange: {
+        readonly type: "object";
+        readonly required: readonly ["path", "startLine", "endLine"];
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly startLine: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly endLine: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+        };
+        readonly additionalProperties: false;
+    };
+    readonly readPdfSource: {
+        readonly type: "object";
+        readonly required: readonly ["path"];
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly page: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly regionId: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly additionalProperties: false;
+    };
+    readonly grepDocs: {
+        readonly type: "object";
+        readonly required: readonly ["pattern"];
+        readonly properties: {
+            readonly pattern: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+            };
+            readonly regex: {
+                readonly type: "boolean";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 100;
+            };
+            readonly pathPrefix: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: "string";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+    readonly listDocs: {
+        readonly type: "object";
+        readonly properties: {
+            readonly pathPrefix: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+            };
+        };
+        readonly additionalProperties: false;
+    };
+    readonly relatedChunks: {
+        readonly type: "object";
+        readonly required: readonly ["chunkId"];
+        readonly properties: {
+            readonly chunkId: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly before: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 10;
+            };
+            readonly after: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 10;
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/retrieval/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/retrieval/schemas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Dd,CAAC"}

package/dist/retrieval/schemas.js

@@ -0,0 +1,65 @@
+export const toolSchemas = {
+    searchDocs: {
+        type: "object",
+        required: ["query"],
+        properties: {
+            query: { type: "string", minLength: 1 },
+            limit: { type: "integer", minimum: 1, maximum: 50 },
+            pathPrefix: { type: "string" },
+            kind: { type: "string" }
+        },
+        additionalProperties: false
+    },
+    readSourceRange: {
+        type: "object",
+        required: ["path", "startLine", "endLine"],
+        properties: {
+            path: { type: "string", minLength: 1 },
+            startLine: { type: "integer", minimum: 1 },
+            endLine: { type: "integer", minimum: 1 }
+        },
+        additionalProperties: false
+    },
+    readPdfSource: {
+        type: "object",
+        required: ["path"],
+        properties: {
+            path: { type: "string", minLength: 1 },
+            page: { type: "integer", minimum: 1 },
+            regionId: { type: "string", minLength: 1 }
+        },
+        additionalProperties: false
+    },
+    grepDocs: {
+        type: "object",
+        required: ["pattern"],
+        properties: {
+            pattern: { type: "string", minLength: 1, maxLength: 128 },
+            regex: { type: "boolean" },
+            limit: { type: "integer", minimum: 1, maximum: 100 },
+            pathPrefix: { type: "string" },
+            kind: { type: "string" }
+        },
+        additionalProperties: false
+    },
+    listDocs: {
+        type: "object",
+        properties: {
+            pathPrefix: { type: "string" },
+            kind: { type: "string" },
+            limit: { type: "integer", minimum: 1, maximum: 500 }
+        },
+        additionalProperties: false
+    },
+    relatedChunks: {
+        type: "object",
+        required: ["chunkId"],
+        properties: {
+            chunkId: { type: "string", minLength: 1 },
+            before: { type: "integer", minimum: 0, maximum: 10 },
+            after: { type: "integer", minimum: 0, maximum: 10 }
+        },
+        additionalProperties: false
+    }
+};
+//# sourceMappingURL=schemas.js.map

package/dist/retrieval/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/retrieval/schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YACnD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC;QAC1C,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;YACtC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YAC1C,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;SACzC;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;YACtC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACrC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;SAC3C;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;YACzD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;YACpD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;SACrD;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;YACzC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YACpD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;SACpD;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC"}

package/dist/retrieval/tools.d.ts

@@ -0,0 +1,31 @@
+import type { GrepDocsInput, GrepDocsResult, ListDocsInput, ListDocsResult, ReadPdfSourceInput, ReadPdfSourceResult, ReadSourceRangeInput, ReadSourceRangeResult, RelatedChunkResult, RelatedChunksInput, RetrievalTrace, SearchDocsInput, SearchDocsMode, SearchDocsResult } from "./types.js";
+export declare class RetrievalToolRuntime {
+    readonly trace: RetrievalTrace;
+    private readonly database;
+    private readonly root;
+    constructor(root: string, dbPath?: string);
+    close(): void;
+    searchDocs(input: SearchDocsInput): SearchDocsResult[];
+    searchDocsWithMode(input: SearchDocsInput, mode: SearchDocsMode): SearchDocsResult[];
+    readSourceRange(input: ReadSourceRangeInput): Promise<ReadSourceRangeResult>;
+    readPdfSource(input: ReadPdfSourceInput): ReadPdfSourceResult;
+    grepDocs(input: GrepDocsInput): Promise<GrepDocsResult[]>;
+    listDocs(input?: ListDocsInput): ListDocsResult[];
+    getDoc(pathValue: string): ListDocsResult | null;
+    relatedChunks(input: RelatedChunksInput): RelatedChunkResult[];
+    private readSourceRangeFromSource;
+    private searchFtsCandidates;
+    private searchVectorCandidates;
+    private toFtsCandidate;
+    private toVectorCandidate;
+    private expandNeighborCandidates;
+    private getNeighborRows;
+    private toNeighborCandidate;
+    private rankingAdjustments;
+    private getSourceByPath;
+    private findSourceByPath;
+    private getChunkById;
+    private getParserArtifacts;
+    private getPdfLocators;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/retrieval/tools.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA6EpB,qBAAa,oBAAoB;IAC/B,SAAgB,KAAK,EAAE,cAAc,CAInC;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAEX,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IASzC,KAAK,IAAI,IAAI;IAIb,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,EAAE;IAItD,kBAAkB,CACvB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,cAAc,GACnB,gBAAgB,EAAE;IAoEd,eAAe,CACpB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAc1B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB;IA4DvD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0D/D,QAAQ,CAAC,KAAK,GAAE,aAAkB,GAAG,cAAc,EAAE;IAgCrD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAMhD,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,EAAE;YAgCvD,yBAAyB;IAiCvC,OAAO,CAAC,mBAAmB;IAkC3B,OAAO,CAAC,sBAAsB;IAoE9B,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,wBAAwB;IA+BhC,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;CAWvB"}