sxng-cli 1.0.8 → 1.1.0

package/dist/deep/graph-explore.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Agent-style knowledge graph exploration.
+ *
+ * Two-step interaction model:
+ *   graph-explore: inspect all relations around a seed entity (summary view)
+ *   graph-drill:   follow specific relations from an entity (targeted retrieval)
+ *
+ * Also includes dead-end detection and alternative path suggestion.
+ */
+import { DirectedGraph } from 'graphology';
+import { GraphNodeAttrs, GraphEdgeAttrs } from './graph.js';
+export interface RelationTarget {
+    nodeId: string;
+    label: string;
+    type: string;
+    weight: number;
+}
+export interface RelationGroup {
+    relation: string;
+    targets: RelationTarget[];
+}
+export interface ExploreResult {
+    entity: {
+        id: string;
+        label: string;
+        type: string;
+        score?: number;
+        degree: number;
+    };
+    outgoingRelations: RelationGroup[];
+    incomingRelations: RelationGroup[];
+    suggestedNextSteps: string[];
+}
+export interface DrillResult {
+    seed: string;
+    relations: string[];
+    triples: Array<{
+        source: string;
+        sourceLabel: string;
+        relation: string;
+        target: string;
+        targetLabel: string;
+        weight: number;
+    }>;
+    nextSteps: string[];
+}
+export interface DeadEndInfo {
+    entityId: string;
+    reason: 'low_degree' | 'only_mentioned_in' | 'already_visited';
+    alternativePaths: Array<{
+        fromEntity: string;
+        fromLabel: string;
+        relation: string;
+        toEntity: string;
+        toLabel: string;
+        score: number;
+    }>;
+}
+export interface EntitySuggestion {
+    id: string;
+    label: string;
+    distance: number;
+}
+/** Explore all relations around a seed entity. */
+export declare function exploreSeedEntity(graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, seedLabel: string): ExploreResult | {
+    error: string;
+    suggestions: EntitySuggestion[];
+};
+/** Follow specific relations from a seed entity. */
+export declare function drillByRelations(graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, seedLabel: string, relations: string[]): DrillResult | {
+    error: string;
+    suggestions: EntitySuggestion[];
+};
+/** Detect if an entity is a dead end and suggest alternatives. */
+export declare function detectDeadEnd(graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, entityId: string, visited?: Set<string>): DeadEndInfo | null;
+export interface TraverseResult {
+    pathId: string;
+    pathType: string;
+    label: string;
+    hops: Array<{
+        index: number;
+        entityId: string;
+        entityLabel: string;
+        entityType: string;
+        relation?: string;
+    }>;
+    sources: {
+        resultCount: number;
+        domains: string[];
+        rounds: number[];
+    };
+}
+/** Traverse a path: node and return the ordered reasoning chain. */
+export declare function traversePath(graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, pathId: string): TraverseResult | {
+    error: string;
+    availablePaths: string[];
+};
+export interface SearchResult {
+    id: string;
+    label: string;
+    score: number;
+}
+/** Keyword search across entity labels. Returns entity IDs ranked by score × degree. */
+export declare function searchEntities(graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, keyword: string, limit?: number): SearchResult[];
+/** Format explore result as Markdown. */
+export declare function formatExploreAsMarkdown(result: ExploreResult): string;
+/** Format drill result as Markdown. */
+export declare function formatDrillAsMarkdown(result: DrillResult): string;
+/** Format dead-end info as Markdown. */
+export declare function formatDeadEndAsMarkdown(info: DeadEndInfo): string;
+/** Format traverse result as Markdown. */
+export declare function formatTraverseAsMarkdown(result: TraverseResult): string;
+/** Format search results as Markdown. */
+export declare function formatSearchAsMarkdown(results: SearchResult[], keyword: string): string;
+//# sourceMappingURL=graph-explore.d.ts.map

package/dist/deep/graph-explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-explore.d.ts","sourceRoot":"","sources":["../../src/deep/graph-explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5D,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;IAC/D,gBAAgB,EAAE,KAAK,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACN;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAID,kDAAkD;AAClD,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,SAAS,EAAE,MAAM,GAClB,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAyEpE;AAID,oDAAoD;AACpD,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,GACpB,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAAE,CA+FlE;AAID,kEAAkE;AAClE,wBAAgB,aAAa,CACzB,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,WAAW,GAAG,IAAI,CAiDpB;AA8DD,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;QACR,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACL;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CACxB,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,MAAM,EAAE,MAAM,GACf,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAwF9D;AAYD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAC1B,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,GACnB,YAAY,EAAE,CAyBhB;AAmGD,yCAAyC;AACzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6CrE;AAED,uCAAuC;AACvC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAmCjE;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAuBjE;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA0BvE;AAED,yCAAyC;AACzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAavF"}