graphifyy 0.3.17 → 0.3.28

package/dist/index.d.cts

@@ -6,7 +6,8 @@ declare enum FileType {
     CODE = "code",
     DOCUMENT = "document",
     PAPER = "paper",
-    IMAGE = "image"
+    IMAGE = "image",
+    VIDEO = "video"
 }
 /** Confidence level for extracted relationships. */
 type Confidence = "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
@@ -154,12 +155,15 @@ declare function assertValid(data: unknown): void;
  *    using an explicit `seen` set keyed on node.id.
  */
 
-declare function buildFromJson(extraction: Extraction): Graph;
+interface BuildOptions {
+    directed?: boolean;
+}
+declare function buildFromJson(extraction: Extraction, options?: BuildOptions): Graph;
 /**
  * Merge multiple extraction results into one graph.
  * Extractions are merged in order — last attributes win for duplicate node IDs.
  */
-declare function build(extractions: Extraction[]): Graph;
+declare function build(extractions: Extraction[], options?: BuildOptions): Graph;
 
 type NumericMapLike<T> = Map<number, T> | Record<number | string, T>;
 type StringMapLike<T> = Map<string, T> | Record<string, T>;
@@ -200,6 +204,7 @@ type CommunityLabelsInput = NumericMapLike<string>;
 type CommunityLabelOptions = {
     communityLabels?: CommunityLabelsInput;
 };
+type JsonOptions = CommunityLabelOptions;
 type SvgOptions = CommunityLabelOptions & {
     figsize?: [number, number];
 };
@@ -212,7 +217,7 @@ type Neo4jPushOptions = {
     password: string;
     communities?: NumericMapLike<string[]>;
 };
-declare function toJson(G: Graph, communities: NumericMapLike<string[]>, outputPath: string): void;
+declare function toJson(G: Graph, communities: NumericMapLike<string[]>, outputPath: string, communityLabelsOrOptions?: CommunityLabelsInput | JsonOptions): void;
 declare function toCypher(G: Graph, outputPath: string): void;
 declare function pushToNeo4j(G: Graph, optionsOrUri: Neo4jPushOptions | string, user?: string, password?: string, communities?: NumericMapLike<string[]>): Promise<{
     nodes: number;
@@ -253,7 +258,12 @@ declare function collectFiles(target: string, options?: {
     followSymlinks?: boolean;
 }): string[];
 
-/** SHA256 of file contents + resolved path. Prevents cache collisions on identical content. */
+/**
+ * SHA256 of file contents + resolved path. Prevents cache collisions on identical content.
+ *
+ * For Markdown files, YAML frontmatter is stripped before hashing so metadata-only
+ * changes do not invalidate semantic extraction cache entries.
+ */
 declare function fileHash(filePath: string): string;
 /**
  * Return cached extraction for this file if hash matches, else null.
@@ -312,9 +322,29 @@ declare function saveQueryResult(questionOrOptions: string | {
     sourceNodes?: string[] | null;
 }, answer?: string, memoryDir?: string, queryType?: string, sourceNodes?: string[] | null): string;
 
+declare function downloadAudio(url: string, outputDir: string): string;
+declare function buildWhisperPrompt(godNodes: Array<{
+    label?: string | null;
+}>): string;
+declare function transcribe(videoPath: string, outputDir?: string, initialPrompt?: string, force?: boolean): Promise<string>;
+declare function transcribeAll(videoFiles: string[], outputDir?: string, initialPrompt?: string, force?: boolean): Promise<string[]>;
+declare function augmentDetectionWithTranscripts(detection: DetectionResult, options?: {
+    outputDir?: string;
+    initialPrompt?: string;
+    godNodes?: Array<{
+        label?: string | null;
+    }>;
+    incremental?: boolean;
+    whisperModel?: string;
+}): Promise<{
+    detection: DetectionResult;
+    transcriptPaths: string[];
+    prompt: string;
+}>;
+
 declare function serve(graphPath?: string, transport?: Transport): Promise<void>;
 
 declare function rebuildCode(watchPath: string, followSymlinks?: boolean): Promise<boolean>;
 declare function watch(watchPath: string, debounce?: number): Promise<void>;
 
-export { type DetectionResult, type Extraction, FileType, type GraphEdge, type GraphNode, type Hyperedge, assertValid, build, buildFromJson, checkSemanticCache, classifyFile, cluster, cohesionScore, collectFiles, detect, detectIncremental, extract, fileHash, generate as generateReport, godNodes, graphDiff, ingest, loadCached, printBenchmark, pushToNeo4j, rebuildCode, runBenchmark, safeFetch, safeFetchText, sanitizeLabel, saveCached, saveManifest, saveQueryResult, saveSemanticCache, scoreAll, serve, suggestQuestions, surprisingConnections, toCanvas, toCypher, toGraphml, toHtml, toJson, toSvg, toWiki, validateExtraction, validateGraphPath, validateUrl, watch };
+export { type DetectionResult, type Extraction, FileType, type GraphEdge, type GraphNode, type Hyperedge, assertValid, augmentDetectionWithTranscripts, build, buildFromJson, buildWhisperPrompt, checkSemanticCache, classifyFile, cluster, cohesionScore, collectFiles, detect, detectIncremental, downloadAudio, extract, fileHash, generate as generateReport, godNodes, graphDiff, ingest, loadCached, printBenchmark, pushToNeo4j, rebuildCode, runBenchmark, safeFetch, safeFetchText, sanitizeLabel, saveCached, saveManifest, saveQueryResult, saveSemanticCache, scoreAll, serve, suggestQuestions, surprisingConnections, toCanvas, toCypher, toGraphml, toHtml, toJson, toSvg, toWiki, transcribe, transcribeAll, validateExtraction, validateGraphPath, validateUrl, watch };

package/dist/index.d.ts

@@ -6,7 +6,8 @@ declare enum FileType {
     CODE = "code",
     DOCUMENT = "document",
     PAPER = "paper",
-    IMAGE = "image"
+    IMAGE = "image",
+    VIDEO = "video"
 }
 /** Confidence level for extracted relationships. */
 type Confidence = "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
@@ -154,12 +155,15 @@ declare function assertValid(data: unknown): void;
  *    using an explicit `seen` set keyed on node.id.
  */
 
-declare function buildFromJson(extraction: Extraction): Graph;
+interface BuildOptions {
+    directed?: boolean;
+}
+declare function buildFromJson(extraction: Extraction, options?: BuildOptions): Graph;
 /**
  * Merge multiple extraction results into one graph.
  * Extractions are merged in order — last attributes win for duplicate node IDs.
  */
-declare function build(extractions: Extraction[]): Graph;
+declare function build(extractions: Extraction[], options?: BuildOptions): Graph;
 
 type NumericMapLike<T> = Map<number, T> | Record<number | string, T>;
 type StringMapLike<T> = Map<string, T> | Record<string, T>;
@@ -200,6 +204,7 @@ type CommunityLabelsInput = NumericMapLike<string>;
 type CommunityLabelOptions = {
     communityLabels?: CommunityLabelsInput;
 };
+type JsonOptions = CommunityLabelOptions;
 type SvgOptions = CommunityLabelOptions & {
     figsize?: [number, number];
 };
@@ -212,7 +217,7 @@ type Neo4jPushOptions = {
     password: string;
     communities?: NumericMapLike<string[]>;
 };
-declare function toJson(G: Graph, communities: NumericMapLike<string[]>, outputPath: string): void;
+declare function toJson(G: Graph, communities: NumericMapLike<string[]>, outputPath: string, communityLabelsOrOptions?: CommunityLabelsInput | JsonOptions): void;
 declare function toCypher(G: Graph, outputPath: string): void;
 declare function pushToNeo4j(G: Graph, optionsOrUri: Neo4jPushOptions | string, user?: string, password?: string, communities?: NumericMapLike<string[]>): Promise<{
     nodes: number;
@@ -253,7 +258,12 @@ declare function collectFiles(target: string, options?: {
     followSymlinks?: boolean;
 }): string[];
 
-/** SHA256 of file contents + resolved path. Prevents cache collisions on identical content. */
+/**
+ * SHA256 of file contents + resolved path. Prevents cache collisions on identical content.
+ *
+ * For Markdown files, YAML frontmatter is stripped before hashing so metadata-only
+ * changes do not invalidate semantic extraction cache entries.
+ */
 declare function fileHash(filePath: string): string;
 /**
  * Return cached extraction for this file if hash matches, else null.
@@ -312,9 +322,29 @@ declare function saveQueryResult(questionOrOptions: string | {
     sourceNodes?: string[] | null;
 }, answer?: string, memoryDir?: string, queryType?: string, sourceNodes?: string[] | null): string;
 
+declare function downloadAudio(url: string, outputDir: string): string;
+declare function buildWhisperPrompt(godNodes: Array<{
+    label?: string | null;
+}>): string;
+declare function transcribe(videoPath: string, outputDir?: string, initialPrompt?: string, force?: boolean): Promise<string>;
+declare function transcribeAll(videoFiles: string[], outputDir?: string, initialPrompt?: string, force?: boolean): Promise<string[]>;
+declare function augmentDetectionWithTranscripts(detection: DetectionResult, options?: {
+    outputDir?: string;
+    initialPrompt?: string;
+    godNodes?: Array<{
+        label?: string | null;
+    }>;
+    incremental?: boolean;
+    whisperModel?: string;
+}): Promise<{
+    detection: DetectionResult;
+    transcriptPaths: string[];
+    prompt: string;
+}>;
+
 declare function serve(graphPath?: string, transport?: Transport): Promise<void>;
 
 declare function rebuildCode(watchPath: string, followSymlinks?: boolean): Promise<boolean>;
 declare function watch(watchPath: string, debounce?: number): Promise<void>;
 
-export { type DetectionResult, type Extraction, FileType, type GraphEdge, type GraphNode, type Hyperedge, assertValid, build, buildFromJson, checkSemanticCache, classifyFile, cluster, cohesionScore, collectFiles, detect, detectIncremental, extract, fileHash, generate as generateReport, godNodes, graphDiff, ingest, loadCached, printBenchmark, pushToNeo4j, rebuildCode, runBenchmark, safeFetch, safeFetchText, sanitizeLabel, saveCached, saveManifest, saveQueryResult, saveSemanticCache, scoreAll, serve, suggestQuestions, surprisingConnections, toCanvas, toCypher, toGraphml, toHtml, toJson, toSvg, toWiki, validateExtraction, validateGraphPath, validateUrl, watch };
+export { type DetectionResult, type Extraction, FileType, type GraphEdge, type GraphNode, type Hyperedge, assertValid, augmentDetectionWithTranscripts, build, buildFromJson, buildWhisperPrompt, checkSemanticCache, classifyFile, cluster, cohesionScore, collectFiles, detect, detectIncremental, downloadAudio, extract, fileHash, generate as generateReport, godNodes, graphDiff, ingest, loadCached, printBenchmark, pushToNeo4j, rebuildCode, runBenchmark, safeFetch, safeFetchText, sanitizeLabel, saveCached, saveManifest, saveQueryResult, saveSemanticCache, scoreAll, serve, suggestQuestions, surprisingConnections, toCanvas, toCypher, toGraphml, toHtml, toJson, toSvg, toWiki, transcribe, transcribeAll, validateExtraction, validateGraphPath, validateUrl, watch };