@thoughtflow/core 0.1.2

package/dist/contracts/index.d.ts

@@ -0,0 +1,25 @@
+export * from "./conversation-status.enum";
+export * from "./conversation.types";
+export * from "./events.types";
+export * from "./interrupt.types";
+export * from "./llm.types";
+export * from "./message.types";
+export * from "./plugin.types";
+export * from "./prompt.types";
+export * from "./skill.types";
+export * from "./storage.types";
+export * from "./subagent.types";
+export * from "./task-flow.types";
+export * from "./tool.types";
+export * from "./knowledge-graph.types";
+export * from "./task-board.types";
+export * from "./doc-graph.types";
+export * from "./codebase-analysis.types";
+export * from "./structural-decoder.types";
+export * from "./vector-store.types";
+export * from "./tool-capability.types";
+export * from "./context-document.types";
+export * from "./memory.types";
+export * from "./problem-tree.types";
+export * from "./mcp.types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./conversation-status.enum"), exports);
+__exportStar(require("./conversation.types"), exports);
+__exportStar(require("./events.types"), exports);
+__exportStar(require("./interrupt.types"), exports);
+__exportStar(require("./llm.types"), exports);
+__exportStar(require("./message.types"), exports);
+__exportStar(require("./plugin.types"), exports);
+__exportStar(require("./prompt.types"), exports);
+__exportStar(require("./skill.types"), exports);
+__exportStar(require("./storage.types"), exports);
+__exportStar(require("./subagent.types"), exports);
+__exportStar(require("./task-flow.types"), exports);
+__exportStar(require("./tool.types"), exports);
+__exportStar(require("./knowledge-graph.types"), exports);
+__exportStar(require("./task-board.types"), exports);
+__exportStar(require("./doc-graph.types"), exports);
+__exportStar(require("./codebase-analysis.types"), exports);
+__exportStar(require("./structural-decoder.types"), exports);
+__exportStar(require("./vector-store.types"), exports);
+__exportStar(require("./tool-capability.types"), exports);
+__exportStar(require("./context-document.types"), exports);
+__exportStar(require("./memory.types"), exports);
+__exportStar(require("./problem-tree.types"), exports);
+__exportStar(require("./mcp.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,uDAAqC;AACrC,iDAA+B;AAC/B,oDAAkC;AAClC,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B;AAC/B,iDAA+B;AAC/B,gDAA8B;AAC9B,kDAAgC;AAChC,mDAAiC;AACjC,oDAAkC;AAClC,+CAA6B;AAC7B,0DAAwC;AACxC,qDAAmC;AACnC,oDAAkC;AAClC,4DAA0C;AAC1C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,iDAA+B;AAC/B,uDAAqC;AACrC,8CAA4B"}

package/dist/contracts/interrupt.types.d.ts

@@ -0,0 +1,62 @@
+export declare const DEFAULT_INTERRUPT_DECISIONS: readonly ["approve", "edit", "reject"];
+export type InterruptDecisionType = (typeof DEFAULT_INTERRUPT_DECISIONS)[number];
+export interface ConversationAction {
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ConversationActionRequest extends ConversationAction {
+    description: string;
+}
+export interface ConversationReviewConfig {
+    actionName: string;
+    allowedDecisions: InterruptDecisionType[];
+}
+export interface ConversationInterruptRequest {
+    actionRequests: ConversationActionRequest[];
+    reviewConfigs: ConversationReviewConfig[];
+}
+export interface ConversationInterrupt {
+    id: string;
+    request: ConversationInterruptRequest;
+    createdAt: string;
+}
+export interface ApproveInterruptDecision {
+    type: "approve";
+}
+export interface EditInterruptDecision {
+    type: "edit";
+    editedAction: ConversationAction;
+}
+export interface RejectInterruptDecision {
+    type: "reject";
+    message?: string;
+}
+export type ConversationInterruptDecision = ApproveInterruptDecision | EditInterruptDecision | RejectInterruptDecision;
+export interface ConversationInterruptResponse {
+    decisions: ConversationInterruptDecision[];
+}
+/** Resume payload in LangGraph style: { [interruptId]: { decisions: [...] } } */
+export type ConversationInterruptResponseById = Record<string, ConversationInterruptResponse>;
+/** Accept both simple and id-mapped resume payloads for backward compatibility. */
+export type ConversationResumeResponse = ConversationInterruptResponse | ConversationInterruptResponseById;
+export interface ConversationInterruptOnConfig {
+    allowedDecisions?: InterruptDecisionType[];
+    description?: string;
+}
+export type ConversationInterruptOnMap = Record<string, boolean | ConversationInterruptOnConfig>;
+export interface ConversationPendingInterruptTool {
+    index: number;
+    config: {
+        allowedDecisions: InterruptDecisionType[];
+        description?: string;
+    };
+}
+/**
+ * Serializable snapshot of a paused run used to restore resume() after reload.
+ */
+export interface ConversationPendingInterrupt {
+    interrupt: ConversationInterrupt;
+    toolCalls: ConversationAction[];
+    interruptTools: ConversationPendingInterruptTool[];
+}
+//# sourceMappingURL=interrupt.types.d.ts.map

package/dist/contracts/interrupt.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.types.d.ts","sourceRoot":"","sources":["../../src/contracts/interrupt.types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,wCAAyC,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,yBAAyB,EAAE,CAAC;IAC5C,aAAa,EAAE,wBAAwB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,4BAA4B,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,6BAA6B,GACrC,wBAAwB,GACxB,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,6BAA6B,EAAE,CAAC;CAC5C;AAED,iFAAiF;AACjF,MAAM,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;AAE9F,mFAAmF;AACnF,MAAM,MAAM,0BAA0B,GAClC,6BAA6B,GAC7B,iCAAiC,CAAC;AAEtC,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAC7C,MAAM,EACN,OAAO,GAAG,6BAA6B,CACxC,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,cAAc,EAAE,gCAAgC,EAAE,CAAC;CACpD"}

package/dist/contracts/interrupt.types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_INTERRUPT_DECISIONS = void 0;
+exports.DEFAULT_INTERRUPT_DECISIONS = ["approve", "edit", "reject"];
+//# sourceMappingURL=interrupt.types.js.map

package/dist/contracts/interrupt.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.types.js","sourceRoot":"","sources":["../../src/contracts/interrupt.types.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC"}

package/dist/contracts/knowledge-graph.types.d.ts

@@ -0,0 +1,112 @@
+export type KnowledgeNodeType = "business_concept" | "requirement" | "milestone" | "domain_entity" | "feature" | "workflow" | "integration" | "module" | "class" | "method" | "interface" | "type" | "enum" | "struct" | "trait" | "service" | "controller" | "repository" | "model" | "dependency" | "task" | "note";
+export type KnowledgeSourceType = "business_doc" | "code" | "behavioral" | "human";
+export interface KnowledgeNode {
+    id: string;
+    type: KnowledgeNodeType;
+    name: string;
+    description: string;
+    /** Which knowledge source produced this node. */
+    source: KnowledgeSourceType;
+    /** File that this node was extracted from (relative path). */
+    sourceFile?: string;
+    /** Start line number in source file (1-based). */
+    sourceLine?: number;
+    /** End line number in source file (1-based, inclusive). */
+    sourceLineEnd?: number;
+    /** Confidence score 0..1 for LLM-inferred nodes. */
+    confidence?: number;
+    /** Free-form tags for filtering. */
+    tags?: string[];
+    /** Arbitrary structured metadata. */
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export type KnowledgeEdgeType = "implements" | "depends_on" | "satisfies" | "calls" | "extends" | "contains" | "blocks" | "relates_to" | "contradicts";
+export interface KnowledgeEdge {
+    id: string;
+    fromId: string;
+    toId: string;
+    type: KnowledgeEdgeType;
+    /** Confidence score 0..1 for LLM-inferred edges. */
+    confidence: number;
+    /** Human-readable justification or LLM evidence. */
+    evidence?: string;
+    /** Arbitrary structured metadata. */
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface NodeQueryOptions {
+    /** Filter by node type(s). */
+    types?: KnowledgeNodeType[];
+    /** Filter by knowledge source. */
+    source?: KnowledgeSourceType;
+    /** Filter by tags (AND — must have all). */
+    tags?: string[];
+    /** Full-text search on name + description. */
+    search?: string;
+    /** Filter by source file path (exact or glob). */
+    sourceFile?: string;
+    /** Minimum confidence threshold (0..1). */
+    minConfidence?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface EdgeQueryOptions {
+    /** Filter by edge type(s). */
+    types?: KnowledgeEdgeType[];
+    /** Only edges originating from this node. */
+    fromId?: string;
+    /** Only edges targeting this node. */
+    toId?: string;
+    /** Minimum confidence threshold (0..1). */
+    minConfidence?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface NeighborhoodOptions {
+    /** Max hops from center node (default 1). */
+    depth?: number;
+    /** Only traverse edges of these types. */
+    edgeTypes?: KnowledgeEdgeType[];
+    /** Only include nodes of these types. */
+    nodeTypes?: KnowledgeNodeType[];
+    /** Direction of traversal. */
+    direction?: "outgoing" | "incoming" | "both";
+}
+export interface GraphPath {
+    /** Ordered list of node IDs from start to end. */
+    nodes: string[];
+    /** Edges connecting consecutive nodes. */
+    edges: string[];
+    /** Product of edge confidences along the path. */
+    confidence: number;
+}
+export interface SubGraph {
+    nodes: KnowledgeNode[];
+    edges: KnowledgeEdge[];
+}
+export interface GraphStatistics {
+    totalNodes: number;
+    totalEdges: number;
+    nodesByType: Record<string, number>;
+    edgesByType: Record<string, number>;
+    nodesBySource: Record<string, number>;
+    avgConfidence: number;
+    disconnectedNodes: number;
+}
+export interface GraphSnapshot {
+    id: string;
+    takenAt: string;
+    nodeCount: number;
+    edgeCount: number;
+    /** SHA-256 hash of sorted node IDs + edge IDs for fast comparison. */
+    contentHash: string;
+    /** Node IDs present in this snapshot. */
+    nodeIds: string[];
+    /** Edge IDs present in this snapshot. */
+    edgeIds: string[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=knowledge-graph.types.d.ts.map

package/dist/contracts/knowledge-graph.types.d.ts.map

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

package/dist/contracts/knowledge-graph.types.js

@@ -0,0 +1,13 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Knowledge Graph Types — Phase 1
+//
+// Persistent, queryable graph of entities spanning 3 knowledge sources:
+//   Source 1: Business documents (.md files, plans, notes)
+//   Source 2: Code structure (AST symbols, dependency tree)
+//   Source 3: Behavioral understanding (LLM-inferred relationships)
+//
+// Backed by IStorageAdapter for pluggable persistence.
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=knowledge-graph.types.js.map

package/dist/contracts/knowledge-graph.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.types.js","sourceRoot":"","sources":["../../src/contracts/knowledge-graph.types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kCAAkC;AAClC,EAAE;AACF,wEAAwE;AACxE,2DAA2D;AAC3D,4DAA4D;AAC5D,oEAAoE;AACpE,EAAE;AACF,uDAAuD;AACvD,gFAAgF"}

package/dist/contracts/llm.types.d.ts

@@ -0,0 +1,137 @@
+import { ConversationMessage, ToolCall } from "./message.types";
+export interface LlmToolSpec {
+    name: string;
+    description: string;
+    inputJsonSchema?: Record<string, unknown>;
+}
+export interface LlmModelInfo {
+    name: string;
+    sizeBytes?: number;
+    modifiedAt?: string;
+    digest?: string;
+    details?: Record<string, unknown>;
+}
+export interface LlmPreflightCapabilities {
+    supportsThinking: boolean;
+    supportsTools: boolean;
+    supportsStreaming: boolean;
+    /** True when adapter+model can enforce JSON schema natively (provider-level). */
+    supportsNativeStructuredOutput?: boolean;
+    /** True when the model supports image/multimodal inputs (vision). */
+    supportsVision?: boolean;
+}
+export type LlmStructuredOutputStrategy = "auto" | "provider-native" | "tool" | "prompt-json";
+export interface LlmStructuredOutputConfig {
+    strategy?: LlmStructuredOutputStrategy;
+    /** Provider-specific schema name when required (e.g. OpenAI json_schema). */
+    schemaName?: string;
+    /** Request strict schema enforcement when provider supports it. */
+    strict?: boolean;
+}
+export interface LlmPreflightRequest {
+    model: string;
+    thinking?: boolean;
+}
+export interface LlmPreflightResult {
+    model: string;
+    modelFound: boolean;
+    availableModels: LlmModelInfo[];
+    capabilities: LlmPreflightCapabilities;
+    warnings: string[];
+}
+export interface LlmChatRequest {
+    model: string;
+    messages: ConversationMessage[];
+    tools: LlmToolSpec[];
+    /** Preferred response mode. "json" requests machine-parseable JSON output. */
+    responseFormat?: "text" | "json";
+    /** Optional JSON schema hint for providers that support structured output schemas. */
+    responseSchema?: Record<string, unknown>;
+    /** Strategy/config used by adapters to prefer provider-native structured outputs. */
+    structuredOutput?: LlmStructuredOutputConfig;
+    signal?: AbortSignal;
+    thinking?: boolean;
+    temperature?: number;
+    /** Max output tokens for the response. Provider default if omitted. */
+    maxTokens?: number;
+    numCtx?: number;
+    seed?: number;
+}
+export interface LlmChatResponse {
+    message: {
+        content: string;
+        toolCalls?: ToolCall[];
+        thinking?: string;
+        reasoningContent?: string;
+    };
+    tokensInput?: number;
+    tokensOutput?: number;
+}
+export interface LlmCircuitBreakerPolicy {
+    /** Consecutive failed requests needed to open the circuit. Default: 5 */
+    failureThreshold?: number;
+    /** How long the circuit stays open before allowing a trial call. Default: 30000 */
+    resetTimeoutMs?: number;
+}
+export interface LlmRuntimePolicy {
+    /** Per-request timeout for model calls. Disabled when undefined/<=0. */
+    timeoutMs?: number;
+    /** Number of retries after the first failed request. Default: 0. */
+    maxRetries?: number;
+    /** Optional delay between retries in milliseconds. Default: 0. */
+    retryDelayMs?: number;
+    /** Fallback models used on retry when current model fails. */
+    fallbackModels?: string[];
+    /** Optional per-model fallback matrix. Key=primary model, value=ordered fallback list. */
+    fallbackMatrix?: Record<string, string[]>;
+    /** Optional circuit breaker configuration. */
+    circuitBreaker?: LlmCircuitBreakerPolicy;
+}
+export type StopReason = "completed" | "aborted" | "stall" | "repetition" | "max-iterations" | "max-tool-calls" | "interrupted";
+export type StallDetectionMode = "write" | "tool";
+export interface LlmStreamChunk {
+    contentDelta?: string;
+    fullContent: string;
+    thinkingDelta?: string;
+    fullThinking?: string;
+    done: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface LlmAdapter {
+    listModels(): Promise<LlmModelInfo[]>;
+    preflight(request: LlmPreflightRequest): Promise<LlmPreflightResult>;
+    chat(request: LlmChatRequest): Promise<LlmChatResponse>;
+    streamChat(request: LlmChatRequest, onChunk: (chunk: LlmStreamChunk) => void): Promise<LlmChatResponse>;
+}
+/**
+ * Unified model reference — binds a model name to connection details.
+ * Used wherever a model might need a different provider/host than the
+ * parent conversation.  Falls back to parent connection when fields
+ * are omitted.
+ *
+ * @example
+ * // Full explicit
+ * { model: 'gpt-4o', provider: 'openai', connection: { apiKey: 'sk-...' } }
+ *
+ * @example
+ * // Inherits connection from conversation, only overrides model name
+ * { model: 'qwen3:4b' }
+ *
+ * @example
+ * // Plain string shortcut (model name only, inherits everything else)
+ * 'claude-3-haiku'
+ */
+export interface ModelRef {
+    /** Model name (e.g. "gpt-4o", "claude-3-haiku", "qwen3:8b"). */
+    model: string;
+    /** Provider / adapter type. Defaults to parent's provider when omitted. */
+    provider?: "ollama" | "openai" | "anthropic" | "mock";
+    /** Connection details. Falls back to parent connection when omitted. */
+    connection?: {
+        baseUrl?: string;
+        apiKey?: string;
+        host?: string;
+        port?: number;
+    };
+}
+//# sourceMappingURL=llm.types.d.ts.map

package/dist/contracts/llm.types.d.ts.map

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

package/dist/contracts/llm.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=llm.types.js.map

package/dist/contracts/llm.types.js.map

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