@grackle-ai/knowledge-core 0.63.0

package/dist/transcript-chunker.js

@@ -0,0 +1,142 @@
+/**
+ * Session transcript chunker that splits JSONL session logs by conversation turn.
+ *
+ * Accepts the raw JSONL content of a session's `stream.jsonl` file and groups
+ * events into semantic turns (user input → agent response) for embedding.
+ *
+ * @module
+ */
+/** Default event types that are excluded from chunks. */
+const DEFAULT_SKIP_TYPES = ["status", "signal", "usage", "system"];
+/** Default maximum characters per chunk. */
+const DEFAULT_MAX_CHUNK_SIZE = 4000;
+/** Labels used when rendering events into readable text. */
+const EVENT_LABELS = {
+    user_input: "User",
+    text: "Assistant",
+    tool_use: "Tool",
+    tool_result: "Result",
+    error: "Error",
+    finding: "Finding",
+    subtask_create: "Subtask",
+};
+/**
+ * Create a chunker that splits JSONL session transcripts by conversation turn.
+ *
+ * A "turn" starts at a `user_input` event and includes all subsequent events
+ * until the next `user_input`. Events before the first `user_input` are grouped
+ * into an initial turn (turn 0). Turns exceeding {@link TranscriptChunkerOptions.maxChunkSize}
+ * are split into sub-chunks.
+ *
+ * @param options - Optional chunker configuration.
+ * @returns A {@link Chunker} for session transcript JSONL content.
+ */
+export function createTranscriptChunker(options) {
+    const maxChunkSize = options?.maxChunkSize ?? DEFAULT_MAX_CHUNK_SIZE;
+    const skipTypes = new Set(options?.skipEventTypes ?? DEFAULT_SKIP_TYPES);
+    return {
+        chunk(content, metadata) {
+            const entries = parseJsonl(content);
+            if (entries.length === 0) {
+                return [];
+            }
+            // Group on all entries first so user_input boundaries are preserved
+            // even if user_input is in skipTypes. Filter when rendering.
+            const turns = groupByTurn(entries);
+            const chunks = [];
+            for (let turnIndex = 0; turnIndex < turns.length; turnIndex++) {
+                const turnEntries = turns[turnIndex];
+                const visible = turnEntries.filter((e) => !skipTypes.has(e.type));
+                if (visible.length === 0) {
+                    continue;
+                }
+                const text = renderTurn(visible);
+                const timestamps = visible.map((e) => e.timestamp);
+                const eventTypes = [...new Set(visible.map((e) => e.type))];
+                const turnMetadata = {
+                    ...metadata,
+                    turnIndex,
+                    timestampStart: timestamps[0],
+                    timestampEnd: timestamps[timestamps.length - 1],
+                    eventTypes,
+                };
+                if (text.length <= maxChunkSize) {
+                    chunks.push({ text, index: chunks.length, metadata: turnMetadata });
+                }
+                else {
+                    const subChunks = splitText(text, maxChunkSize);
+                    for (const subChunk of subChunks) {
+                        chunks.push({ text: subChunk, index: chunks.length, metadata: turnMetadata });
+                    }
+                }
+            }
+            return chunks;
+        },
+    };
+}
+/** Parse a JSONL string into an array of log entries, skipping malformed lines. */
+function parseJsonl(content) {
+    const entries = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return entries;
+}
+/** Group log entries into turns, splitting on `user_input` events. */
+function groupByTurn(entries) {
+    const turns = [];
+    let current = [];
+    for (const entry of entries) {
+        if (entry.type === "user_input" && current.length > 0) {
+            turns.push(current);
+            current = [];
+        }
+        current.push(entry);
+    }
+    if (current.length > 0) {
+        turns.push(current);
+    }
+    return turns;
+}
+/** Render a turn's events into human-readable text. */
+function renderTurn(entries) {
+    return entries
+        .map((e) => {
+        const label = EVENT_LABELS[e.type] ?? e.type;
+        return `${label}: ${e.content}`;
+    })
+        .join("\n");
+}
+/**
+ * Split text into sub-chunks at line boundaries, targeting at most maxSize characters.
+ * A single line longer than maxSize will be emitted as-is (not split mid-line).
+ */
+function splitText(text, maxSize) {
+    const lines = text.split("\n");
+    const subChunks = [];
+    let current = "";
+    for (const line of lines) {
+        const candidate = current ? current + "\n" + line : line;
+        if (candidate.length > maxSize && current) {
+            subChunks.push(current);
+            current = line;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current) {
+        subChunks.push(current);
+    }
+    return subChunks;
+}
+//# sourceMappingURL=transcript-chunker.js.map

package/dist/transcript-chunker.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Core domain types for the knowledge graph.
+ *
+ * Defines the two node kinds (reference and native), edge types, and
+ * runtime type guards for discriminating between node variants.
+ *
+ * @module
+ */
+/** Discriminator for knowledge graph node kinds. */
+export declare const NODE_KIND: {
+    /** Points to an entity in Grackle's relational DB. No duplicated content. */
+    readonly REFERENCE: "reference";
+    /** Exists only in the graph. Owns its content. */
+    readonly NATIVE: "native";
+};
+/** Union of all node kind values. */
+export type NodeKind = (typeof NODE_KIND)[keyof typeof NODE_KIND];
+/**
+ * Recommended reference source values.
+ *
+ * Consumers can use these or define their own — the {@link ReferenceSource}
+ * type accepts any string.
+ */
+export declare const REFERENCE_SOURCE: {
+    readonly TASK: "task";
+    readonly SESSION: "session";
+    readonly FINDING: "finding";
+    readonly WORKSPACE: "workspace";
+};
+/**
+ * Entity type that a reference node points to.
+ *
+ * Open `string` type — not restricted to the values in {@link REFERENCE_SOURCE}.
+ * Consumers can define their own source types (e.g., `"ado-work-item"`, `"webpage"`).
+ */
+export type ReferenceSource = string;
+/**
+ * Recommended native node categories.
+ *
+ * Consumers can use these or define their own — the {@link NativeCategory}
+ * type accepts any string.
+ */
+export declare const NATIVE_CATEGORY: {
+    readonly DECISION: "decision";
+    readonly INSIGHT: "insight";
+    readonly CONCEPT: "concept";
+    readonly SNIPPET: "snippet";
+};
+/**
+ * Category for native nodes that exist only in the knowledge graph.
+ *
+ * Open `string` type — not restricted to the values in {@link NATIVE_CATEGORY}.
+ * Consumers can define their own categories (e.g., `"research-note"`, `"requirement"`).
+ */
+export type NativeCategory = string;
+/** Relationship types between knowledge graph nodes. */
+export declare const EDGE_TYPE: {
+    readonly RELATES_TO: "RELATES_TO";
+    readonly DEPENDS_ON: "DEPENDS_ON";
+    readonly DERIVED_FROM: "DERIVED_FROM";
+    readonly MENTIONS: "MENTIONS";
+    readonly PART_OF: "PART_OF";
+};
+/** Union of all edge type values. */
+export type EdgeType = (typeof EDGE_TYPE)[keyof typeof EDGE_TYPE];
+/** Properties common to all knowledge graph nodes. */
+export interface KnowledgeNodeBase {
+    /** Unique node identifier (UUID). */
+    id: string;
+    /** Which kind of node this is. */
+    kind: NodeKind;
+    /** Dense vector embedding for similarity search. */
+    embedding: number[];
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: string;
+    /** Workspace scope (empty string = global). */
+    workspaceId: string;
+}
+/** A reference node — points to an entity in Grackle's relational DB. */
+export interface ReferenceNode extends KnowledgeNodeBase {
+    kind: typeof NODE_KIND.REFERENCE;
+    /** Which entity type this refers to. */
+    sourceType: ReferenceSource;
+    /** The ID of the entity in Grackle's relational DB. */
+    sourceId: string;
+    /** Human-readable label derived from the source (e.g., task title). */
+    label: string;
+}
+/** A native node — owns its content directly. */
+export interface NativeNode extends KnowledgeNodeBase {
+    kind: typeof NODE_KIND.NATIVE;
+    /** Subcategory of the native node. */
+    category: NativeCategory;
+    /** Title or summary. */
+    title: string;
+    /** Full content owned by this node. */
+    content: string;
+    /** Free-form tags for categorization. */
+    tags: string[];
+}
+/** Discriminated union of all knowledge graph node types. */
+export type KnowledgeNode = ReferenceNode | NativeNode;
+/** An edge (relationship) in the knowledge graph. */
+export interface KnowledgeEdge {
+    /** Source node ID. */
+    fromId: string;
+    /** Target node ID. */
+    toId: string;
+    /** Relationship type. */
+    type: EdgeType;
+    /** Optional metadata (e.g., confidence score, context snippet). */
+    metadata?: Record<string, unknown>;
+    /** ISO 8601 timestamp when the edge was created. */
+    createdAt: string;
+}
+/** Returns true if the node is a {@link ReferenceNode}. */
+export declare function isReferenceNode(node: KnowledgeNode): node is ReferenceNode;
+/** Returns true if the node is a {@link NativeNode}. */
+export declare function isNativeNode(node: KnowledgeNode): node is NativeNode;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,oDAAoD;AACpD,eAAO,MAAM,SAAS;IACpB,6EAA6E;;IAE7E,kDAAkD;;CAE1C,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAMlE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAMrC;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAMpC,wDAAwD;AACxD,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAMlE,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,OAAO,SAAS,CAAC,SAAS,CAAC;IACjC,wCAAwC;IACxC,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD,IAAI,EAAE,OAAO,SAAS,CAAC,MAAM,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;AAMvD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,aAAa,CAE1E;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,UAAU,CAEpE"}

package/dist/types.js

@@ -0,0 +1,71 @@
+/**
+ * Core domain types for the knowledge graph.
+ *
+ * Defines the two node kinds (reference and native), edge types, and
+ * runtime type guards for discriminating between node variants.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Node kind discriminator
+// ---------------------------------------------------------------------------
+/** Discriminator for knowledge graph node kinds. */
+export const NODE_KIND = {
+    /** Points to an entity in Grackle's relational DB. No duplicated content. */
+    REFERENCE: "reference",
+    /** Exists only in the graph. Owns its content. */
+    NATIVE: "native",
+};
+// ---------------------------------------------------------------------------
+// Reference node source types
+// ---------------------------------------------------------------------------
+/**
+ * Recommended reference source values.
+ *
+ * Consumers can use these or define their own — the {@link ReferenceSource}
+ * type accepts any string.
+ */
+export const REFERENCE_SOURCE = {
+    TASK: "task",
+    SESSION: "session",
+    FINDING: "finding",
+    WORKSPACE: "workspace",
+};
+// ---------------------------------------------------------------------------
+// Native node categories
+// ---------------------------------------------------------------------------
+/**
+ * Recommended native node categories.
+ *
+ * Consumers can use these or define their own — the {@link NativeCategory}
+ * type accepts any string.
+ */
+export const NATIVE_CATEGORY = {
+    DECISION: "decision",
+    INSIGHT: "insight",
+    CONCEPT: "concept",
+    SNIPPET: "snippet",
+};
+// ---------------------------------------------------------------------------
+// Edge types
+// ---------------------------------------------------------------------------
+/** Relationship types between knowledge graph nodes. */
+export const EDGE_TYPE = {
+    RELATES_TO: "RELATES_TO",
+    DEPENDS_ON: "DEPENDS_ON",
+    DERIVED_FROM: "DERIVED_FROM",
+    MENTIONS: "MENTIONS",
+    PART_OF: "PART_OF",
+};
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+/** Returns true if the node is a {@link ReferenceNode}. */
+export function isReferenceNode(node) {
+    return node.kind === NODE_KIND.REFERENCE;
+}
+/** Returns true if the node is a {@link NativeNode}. */
+export function isNativeNode(node) {
+    return node.kind === NODE_KIND.NATIVE;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,6EAA6E;IAC7E,SAAS,EAAE,WAAW;IACtB,kDAAkD;IAClD,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAUX,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAUX,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAsEX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@grackle-ai/knowledge-core",
+  "version": "0.63.0",
+  "description": "Generic knowledge graph SDK on top of Neo4j with vector search, graph traversal, and pluggable embedders/chunkers",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/knowledge-core"
+  },
+  "keywords": [
+    "knowledge-graph",
+    "neo4j",
+    "vector-search",
+    "embeddings",
+    "graph-traversal"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@huggingface/transformers": "^3.4.0",
+    "neo4j-driver": "^6.0.1",
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.4",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}