@thoughtflow/core 0.1.2

package/dist/contracts/task-flow.types.d.ts

@@ -0,0 +1,127 @@
+export declare enum TaskKind {
+    EASY = "easy",
+    STANDARD = "standard",
+    HARD = "hard",
+    SPIKE = "spike",
+    BUG = "bug"
+}
+export declare enum TaskStrictness {
+    STRICT = "strict",
+    BALANCED = "balanced",
+    AUDIT = "audit"
+}
+export declare enum PhaseStatus {
+    NOT_STARTED = "not-started",
+    IN_PROGRESS = "in-progress",
+    BLOCKED = "blocked",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+export declare enum GateDecision {
+    PASS = "pass",
+    FAIL = "fail",
+    WARN = "warn"
+}
+export type TaskSeverity = "low" | "medium" | "high" | "critical";
+export type TaskFlowPhaseId = "phase-0" | "phase-1" | "phase-2" | "phase-3" | "phase-4" | "phase-5" | "phase-6" | "phase-7" | "phase-8" | "phase-9";
+export type SourceType = "codebase" | "docs" | "knowledge" | "web" | "human";
+export type DependencyType = "imports" | "calls" | "data-flow" | "config" | "runtime";
+export type GateId = "evidence-threshold" | "dependency-integrity" | "duplication-conflict" | "change-budget" | "plan-completeness";
+export interface TaskIntent {
+    id: string;
+    title: string;
+    input: string;
+    kind: TaskKind;
+    severity: TaskSeverity;
+    constraints: string[];
+    acceptanceCriteria: string[];
+    riskTags: string[];
+    metadata: Record<string, unknown>;
+}
+export interface EvidenceItem {
+    sourceType: SourceType;
+    sourceRef: string;
+    summary: string;
+    confidence: number;
+    tags: string[];
+}
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    type: DependencyType;
+    confidence: number;
+    notes?: string;
+}
+export interface PlanStep {
+    id: string;
+    title: string;
+    rationale: string;
+    dependencies: string[];
+    touchedFiles: string[];
+    verification: string[];
+    proposedSymbols?: string[];
+}
+export interface GateResult {
+    gateId: GateId;
+    decision: GateDecision;
+    reason: string;
+    remediation?: string;
+    evidenceRefs?: string[];
+}
+export interface ExecutionArtifact {
+    researchBrief?: string;
+    dependencyMap?: string;
+    implementationPlan?: string;
+    executionJournal?: string;
+    verificationReport?: string;
+}
+export interface TaskFlowPhaseState {
+    phaseId: TaskFlowPhaseId;
+    status: PhaseStatus;
+    startedAt?: string;
+    completedAt?: string;
+    blockers: string[];
+    gateResults: GateResult[];
+    artifacts: Record<string, string>;
+    retryCount: number;
+    notes: string[];
+}
+export interface TaskFlowProgressState {
+    taskId: string;
+    strictness: TaskStrictness;
+    phases: Record<TaskFlowPhaseId, TaskFlowPhaseState>;
+    updatedAt: string;
+}
+export interface ControlledStepOutcome {
+    summary: string;
+    changedFiles: string[];
+    introducedSymbols?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ControlledExecutionStep {
+    step: PlanStep;
+    execute: () => Promise<ControlledStepOutcome>;
+    verify: (outcome: ControlledStepOutcome) => Promise<boolean> | boolean;
+    rollback?: () => Promise<void>;
+}
+export interface ControlledCodingOptions {
+    strictness: TaskStrictness;
+    protectedFileGlobs: string[];
+    touchedFileBudget: number;
+    allowParallelNonOverlapping: boolean;
+}
+export interface StepExecutionRecord {
+    stepId: string;
+    status: "completed" | "failed" | "rolled-back";
+    startedAt: string;
+    completedAt?: string;
+    changedFiles: string[];
+    message: string;
+}
+export interface ControlledCodingRunResult {
+    success: boolean;
+    records: StepExecutionRecord[];
+    rolledBackSteps: string[];
+    error?: string;
+}
+//# sourceMappingURL=task-flow.types.d.ts.map

package/dist/contracts/task-flow.types.d.ts.map

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

package/dist/contracts/task-flow.types.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GateDecision = exports.PhaseStatus = exports.TaskStrictness = exports.TaskKind = void 0;
+var TaskKind;
+(function (TaskKind) {
+    TaskKind["EASY"] = "easy";
+    TaskKind["STANDARD"] = "standard";
+    TaskKind["HARD"] = "hard";
+    TaskKind["SPIKE"] = "spike";
+    TaskKind["BUG"] = "bug";
+})(TaskKind || (exports.TaskKind = TaskKind = {}));
+var TaskStrictness;
+(function (TaskStrictness) {
+    TaskStrictness["STRICT"] = "strict";
+    TaskStrictness["BALANCED"] = "balanced";
+    TaskStrictness["AUDIT"] = "audit";
+})(TaskStrictness || (exports.TaskStrictness = TaskStrictness = {}));
+var PhaseStatus;
+(function (PhaseStatus) {
+    PhaseStatus["NOT_STARTED"] = "not-started";
+    PhaseStatus["IN_PROGRESS"] = "in-progress";
+    PhaseStatus["BLOCKED"] = "blocked";
+    PhaseStatus["COMPLETED"] = "completed";
+    PhaseStatus["FAILED"] = "failed";
+})(PhaseStatus || (exports.PhaseStatus = PhaseStatus = {}));
+var GateDecision;
+(function (GateDecision) {
+    GateDecision["PASS"] = "pass";
+    GateDecision["FAIL"] = "fail";
+    GateDecision["WARN"] = "warn";
+})(GateDecision || (exports.GateDecision = GateDecision = {}));
+//# sourceMappingURL=task-flow.types.js.map

package/dist/contracts/task-flow.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-flow.types.js","sourceRoot":"","sources":["../../src/contracts/task-flow.types.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,iCAAqB,CAAA;IACrB,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,uBAAW,CAAA;AACb,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAED,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,mCAAiB,CAAA;IACjB,uCAAqB,CAAA;IACrB,iCAAe,CAAA;AACjB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB;AAED,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,0CAA2B,CAAA;IAC3B,0CAA2B,CAAA;IAC3B,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;AACnB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,6BAAa,CAAA;AACf,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/dist/contracts/tool-capability.types.d.ts

@@ -0,0 +1,34 @@
+export type ToolDomain = "neural" | "quality" | "testing" | "refactor" | "docs" | "database" | "devops" | "memory" | "planning" | "codebase" | "workspace" | "subagent" | "infra";
+export interface ToolCapabilityMeta {
+    toolName: string;
+    domain: ToolDomain;
+    intents: string[];
+    capabilities: string[];
+    requires: string[];
+    inputExample: string;
+    outputExample: string;
+    isDestructive: boolean;
+    isReadOnly: boolean;
+    llmCostEstimate: string;
+    triggers: string[];
+    workflow: string;
+}
+export interface CapabilitySearchResult {
+    toolName: string;
+    score: number;
+    matchedIntents: string[];
+}
+export interface ToolSuggestion {
+    toolName: string;
+    reason: string;
+    priority: "high" | "medium" | "low";
+}
+export interface IToolMetadataRegistry {
+    get(toolName: string): ToolCapabilityMeta | undefined;
+    list(): ToolCapabilityMeta[];
+    listByDomain(domain: ToolDomain): ToolCapabilityMeta[];
+    searchByIntent(query: string): Promise<CapabilitySearchResult[]>;
+    suggestForTask(taskDescription: string): ToolSuggestion[];
+    resolveTool(intent: string, context?: string): string[];
+}
+//# sourceMappingURL=tool-capability.types.d.ts.map

package/dist/contracts/tool-capability.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-capability.types.d.ts","sourceRoot":"","sources":["../../src/contracts/tool-capability.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACtD,IAAI,IAAI,kBAAkB,EAAE,CAAC;IAC7B,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACvD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACjE,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAC1D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzD"}

package/dist/contracts/tool-capability.types.js

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

package/dist/contracts/tool-capability.types.js.map

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

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

@@ -0,0 +1,132 @@
+import { z } from "zod";
+export interface ToolLlmCaller {
+    callStructured<T>(prompt: string, schema: z.ZodType<T>): Promise<T>;
+}
+export type ToolExecutionStatus = "QUEUED" | "RUNNING" | "STREAMING" | "SUCCESS" | "ERROR" | "SKIPPED";
+export type ToolCommandGoto = "continue" | "next_iteration" | "end_turn";
+export interface ToolCommand {
+    /** Optional runtime metadata patch merged into next tool calls in the same run. */
+    update?: {
+        /** Explicit runtime state patch merged into next tool calls in the same run. */
+        state?: Record<string, unknown>;
+        /** Backward-compatible alias of runtime state patch. */
+        metadata?: Record<string, unknown>;
+    };
+    /** Optional control-flow jump after current tool execution. */
+    goto?: ToolCommandGoto;
+    /** Optional human-readable command note used as tool output fallback. */
+    message?: string;
+}
+export interface ToolCommandEnvelope {
+    type: "command";
+    command: ToolCommand;
+    output?: string;
+    data?: unknown;
+}
+export interface ToolRetryPolicy {
+    /** Number of retries after first failed attempt. */
+    maxRetries?: number;
+    /** Delay between retry attempts. */
+    retryDelayMs?: number;
+    /** Optional allowlist of tool names eligible for retry. */
+    retryableTools?: string[];
+}
+export interface ToolExecutionResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    data?: unknown;
+    command?: ToolCommand;
+}
+export interface ToolContext {
+    conversationId: string;
+    /** Stable session id (uuidv4) — same value as Conversation.sessionId. */
+    sessionId?: string;
+    signal?: AbortSignal;
+    /** Explicit runtime state object for current run iteration (same object as runtimeContext). */
+    state?: Record<string, unknown>;
+    /** Explicit runtime context object validated by Conversation.contextSchema when configured. */
+    runtimeContext?: Record<string, unknown>;
+    /** Backward-compatible alias for runtimeContext. */
+    metadata?: Record<string, unknown>;
+    emitProgress?: (message: string, data?: unknown) => void;
+    /** Reference to the Conversation instance for tools that need LLM capabilities. */
+    conversation?: ToolLlmCaller;
+}
+export interface ConversationTool {
+    name: string;
+    description: string;
+    inputSchema?: z.ZodTypeAny;
+    execute: (input: Record<string, unknown>, context: ToolContext) => Promise<ToolExecutionResult | ToolCommandEnvelope | string>;
+    /**
+     * Static readonly declaration for the tool as a whole.
+     * true  = tool never modifies state (safe in readonly agent mode).
+     * false = tool may modify state.
+     *
+     * Override per-call with isReadOnly() for tools where it depends on the input
+     * (e.g. git: status=readonly, commit=not).
+     */
+    readonly?: boolean;
+    /**
+     * Per-call readonly check — takes precedence over the static `readonly` field.
+     * Return true if THIS specific call is safe (no side effects).
+     * Example: http_request is readonly for GET, not for POST/DELETE.
+     */
+    isReadOnly?(input: Record<string, unknown>): boolean;
+    /**
+     * Per-call destructive check.
+     * Return true if this call cannot be undone (rm, DROP TABLE, git reset --hard, etc.).
+     * Used by middleware to warn or block in safe-mode agents.
+     */
+    isDestructive?(input: Record<string, unknown>): boolean;
+    /**
+     * Marks tool as safe to retry on transient failures (typically I/O tools).
+     * Keep false/undefined for local mutating tools.
+     */
+    retryable?: boolean;
+    /** Optional namespace for tool grouping/routing ("filesystem", "git", "web", "codebase", etc.) */
+    namespace?: string;
+    /** Optional tags for intent-based tool selection (e.g. ["read", "write", "search"]) */
+    tags?: string[];
+    /** Trigger keywords that indicate this tool may be needed for a user query */
+    keywords?: string[];
+    /** Higher priority tools are always included in tool routing results */
+    priority?: number;
+}
+/**
+ * Tool middleware — runs before / after every tool call.
+ *
+ * Execution order:
+ *  before()  — FIFO (first registered = first called)
+ *  after()   — LIFO (first registered = last called, like an onion)
+ *  onError() — called instead of after() when run() throws
+ */
+export interface ToolMiddleware {
+    name: string;
+    before?(call: {
+        toolName: string;
+        input: Record<string, unknown>;
+    }): Promise<void>;
+    after?(call: {
+        toolName: string;
+        input: Record<string, unknown>;
+    }, result: ToolExecutionResult, meta: {
+        durationMs: number;
+    }): Promise<void>;
+    onError?(call: {
+        toolName: string;
+        input: Record<string, unknown>;
+    }, err: Error): Promise<void>;
+}
+export interface ToolExecutionTrace {
+    id: string;
+    toolName: string;
+    input: Record<string, unknown>;
+    status: ToolExecutionStatus;
+    startedAt: string;
+    endedAt?: string;
+    durationMs?: number;
+    output?: string;
+    error?: string;
+}
+//# sourceMappingURL=tool.types.d.ts.map

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

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

package/dist/contracts/tool.types.js

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

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

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

package/dist/contracts/vector-store.types.d.ts

@@ -0,0 +1,79 @@
+import { ResourceKind } from "./structural-decoder.types";
+export interface VectorChunk {
+    id: string;
+    vector: number[];
+    text: string;
+    metadata: ChunkMetadata;
+}
+export interface ChunkMetadata {
+    projectPath: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    language?: string;
+    chunkType: 'code' | 'documentation' | 'config' | 'schema' | 'api-spec' | 'infra';
+    resourceKind?: ResourceKind;
+    category?: string;
+    tags?: string[];
+    hash?: string;
+    summary?: string;
+    parentDocId?: string;
+    features?: string[];
+    decisions?: string[];
+}
+export interface VectorSearchOptions {
+    filter?: Partial<ChunkMetadata>;
+    limit?: number;
+    offset?: number;
+    minScore?: number;
+    includeVectors?: boolean;
+}
+export interface VectorSearchResult<T = VectorChunk> {
+    item: T;
+    score: number;
+}
+export interface VectorStoreStats {
+    totalVectors: number;
+    collections: string[];
+    indexStatus: 'none' | 'building' | 'ready';
+    diskUsageBytes?: number;
+}
+export interface IVectorStore {
+    initialize?(): Promise<void>;
+    dispose?(): Promise<void>;
+    insert(chunks: VectorChunk[]): Promise<void>;
+    delete(filter: {
+        filePath?: string;
+        projectPath?: string;
+    }): Promise<number>;
+    search(queryVector: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    hybridSearch?(queryVector: number[], keywordQuery: string, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    stats(): Promise<VectorStoreStats>;
+    clear(): Promise<void>;
+}
+export interface EmbeddingProviderConfig {
+    model?: string;
+    dimensions?: number;
+    maxBatchSize?: number;
+    normalize?: boolean;
+    pooling?: 'mean' | 'cls';
+}
+export interface IEmbeddingProvider {
+    readonly dimensions: number;
+    readonly maxBatchSize: number;
+    readonly modelName: string;
+    embed(texts: string[]): Promise<number[][]>;
+    embedQuery(text: string): Promise<number[]>;
+    initialize?(): Promise<void>;
+    dispose?(): Promise<void>;
+}
+export type VectorStoreType = 'memory' | 'lancedb' | 'qdrant';
+export type EmbeddingProviderType = 'transformers' | 'ollama' | 'mock' | 'openai';
+export interface CodebaseIntelligenceConfig {
+    vectorStore?: VectorStoreType | IVectorStore;
+    embeddingProvider?: EmbeddingProviderType | IEmbeddingProvider;
+    vectorStoreConfig?: Record<string, unknown>;
+    embeddingConfig?: Record<string, unknown>;
+    repoPath?: string;
+}
+//# sourceMappingURL=vector-store.types.d.ts.map

package/dist/contracts/vector-store.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.types.d.ts","sourceRoot":"","sources":["../../src/contracts/vector-store.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACjF,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,WAAW;IACjD,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,CACJ,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,YAAY,CAAC,CACX,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAID,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;IAC7C,iBAAiB,CAAC,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/contracts/vector-store.types.js

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

package/dist/contracts/vector-store.types.js.map

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

package/dist/conversation.class.d.ts

@@ -0,0 +1,154 @@
+import { CallStructuredOptions, CallStructuredStreamingOptions, ConversationConfig, ConversationInterrupt, ConversationResumeResponse, ConversationInitInfo, ConversationMessage, ConversationPlugin, ResumeOptions, ConversationStatus, ConversationTurnResult, LlmModelInfo, LlmPreflightResult, SendPromptOptions, StoredCheckpoint, StoredInterruptResolution } from "./contracts";
+import { LlmAdapter } from "./contracts";
+import { MessageHistory } from "./libs/message-history.class";
+import { z } from "zod";
+import type { ContextDocument } from "./contracts/context-document.types";
+import type { SubAgent } from "./contracts/subagent.types";
+export declare class Conversation {
+    private readonly config;
+    private readonly conversationId;
+    /** Stable uuidv4 identifier for this conversation session — used for storage namespacing. */
+    readonly sessionId: string;
+    /** Thread identifier alias (same value as sessionId). */
+    readonly threadId: string;
+    private _history;
+    private readonly statusMachine;
+    private readonly eventsBus;
+    private readonly abortController;
+    private readonly promptBuilder;
+    private readonly toolRegistry;
+    private readonly runner;
+    private readonly streamEmitter;
+    private readonly skills;
+    private llmAdapter;
+    private readonly messageStorage;
+    private readonly interruptStorage;
+    private readonly interruptResolutionStorage;
+    private readonly checkpointStorage;
+    private readonly initInfo;
+    private readonly initPromise;
+    private threadIterationsUsed;
+    setAdapter(adapter: LlmAdapter, model: string): void;
+    private checkpointStep;
+    private model;
+    private readonly contextConfig;
+    private contextRouter;
+    private contextDocCache;
+    private contextDecompositionResult;
+    /** Suppress stream events — set during analysis to prevent noise in chat. */
+    suppressStream: boolean;
+    /** Knowledge document injected at session start — accessible across turns. */
+    knowledgeDoc?: {
+        name: string;
+        content: string;
+    };
+    constructor(config: ConversationConfig);
+    get events$(): import("rxjs").Observable<import("./contracts").ConversationEvent>;
+    get messages$(): import("rxjs").Observable<ConversationMessage[]>;
+    get status$(): import("rxjs").Observable<ConversationStatus>;
+    get status(): ConversationStatus;
+    get selectedModel(): string;
+    get pendingInterrupt(): ConversationInterrupt | null;
+    get isInterrupted(): boolean;
+    setModel(model: string): void;
+    ready(): Promise<ConversationInitInfo>;
+    getAvailableModels(forceRefresh?: boolean): Promise<LlmModelInfo[]>;
+    preflight(forceRefresh?: boolean): Promise<LlmPreflightResult>;
+    sendPrompt(prompt: string, options?: SendPromptOptions): Promise<ConversationTurnResult>;
+    resume(response: ConversationResumeResponse, options?: ResumeOptions): Promise<ConversationTurnResult>;
+    callStructured<T>(prompt: string, schema: z.ZodType<T>, options?: CallStructuredOptions): Promise<T>;
+    callStructuredStreaming<T>(prompt: string, schema: z.ZodType<T>, options?: CallStructuredStreamingOptions): Promise<T>;
+    /**
+     * Run a tool-calling loop: sends the prompt, lets the LLM call tools, returns final result.
+     * Tools are already configured via Conversation constructor → config.tools.
+     * Optionally restricts which tools the LLM can use via toolNames.
+     */
+    callWithTools(prompt: string, options?: {
+        toolNames?: string[];
+        signal?: AbortSignal;
+        metadata?: Record<string, unknown>;
+    }): Promise<ConversationTurnResult>;
+    private executeStructuredCall;
+    loadHistory(sessionId?: string): Promise<ConversationMessage[]>;
+    getInterruptResolutions(sessionId?: string): Promise<StoredInterruptResolution[]>;
+    getCheckpoints(sessionId?: string): Promise<StoredCheckpoint[]>;
+    runLoop(nextPrompt: () => Promise<string | null>, options?: SendPromptOptions): Promise<ConversationTurnResult[]>;
+    stop(reason?: string): void;
+    dispose(): void;
+    /**
+     * Get the message history object for this conversation.
+     * Can be used to access raw messages or resolve offloaded payloads.
+     */
+    get history(): MessageHistory;
+    /** Workspace root directory, e.g. for resolving file paths. */
+    get rootDir(): string | undefined;
+    /**
+     * Get the LLM adapter instance for this conversation.
+     * Useful for accessing the underlying adapter and its methods.
+     */
+    getLlmAdapter(): LlmAdapter;
+    /**
+     * Clear all messages from the conversation history.
+     * Also cleans up any offloaded payloads from the filesystem.
+     */
+    clearHistory(): void;
+    /**
+     * Install a plugin into this conversation. The plugin's install() callback
+     * receives the conversation's ToolRegistry and rootDir. Plugins can be
+     * added at any time, but must be installed before the first sendPrompt()
+     * to guarantee their tools are available for that turn.
+     */
+    use(plugin: ConversationPlugin): void;
+    /**
+     * Get all context documents as a flat array of { name, content } objects.
+     */
+    getContextDocuments(): ContextDocument[];
+    /**
+     * Apply context document inheritance to a subagent's system prompt
+     * based on the configured injection policy.
+     *
+     * @param subagent The subagent to modify (mutated in-place)
+     * @param prompt   Optional user prompt for relevant-only routing
+     */
+    applyContextToSubagent(subagent: SubAgent, prompt?: string): Promise<void>;
+    private buildPrompt;
+    private resolveRuntimeContext;
+    private normalizeRuntimeContext;
+    private resolveMaxIterationsBudget;
+    private normalizePositiveInt;
+    private estimateIterationsFromHistory;
+    private selectSkills;
+    private initialize;
+    private initializeContextDocuments;
+    private mergeCache;
+    private applyModelFallback;
+    private runPreflight;
+    private resolveBaseUrl;
+    private getInitInfoSnapshot;
+    private handleTurnComplete;
+    private persistCheckpointSnapshot;
+    private persistMessages;
+    private persistPendingInterruptSnapshot;
+    private restorePendingInterruptSnapshot;
+    private persistInterruptResolution;
+    private resolveResumeDecisions;
+    private cloneInterruptDecision;
+    private toStoredMessage;
+    private fromStoredMessage;
+    private createTransientMessage;
+    private withStructuredOutputInstruction;
+    private resolveStructuredOutputMode;
+    private resolveNativeStructuredOutputSupport;
+    private extractStructuredToolPayload;
+    private tryAutoRepairStructuredData;
+    private repairStructuredValue;
+    private defaultValueForStructuredField;
+    private unwrapZodType;
+    private isOptionalZodField;
+    private parseStructuredJson;
+    private zodToJsonSchema;
+    private collectJsonCandidates;
+    private transition;
+    private isAbortError;
+}
+//# sourceMappingURL=conversation.class.d.ts.map

package/dist/conversation.class.d.ts.map

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