@thoughtflow/core 0.1.2

package/dist/contracts/context-document.types.js

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

package/dist/contracts/context-document.types.js.map

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

package/dist/contracts/conversation-status.enum.d.ts

@@ -0,0 +1,11 @@
+export declare enum ConversationStatus {
+    IDLE = "IDLE",
+    RUNNING = "RUNNING",
+    WAITING_TOOL = "WAITING_TOOL",
+    INTERRUPTED = "INTERRUPTED",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
+export declare const TERMINAL_CONVERSATION_STATUSES: ReadonlySet<ConversationStatus>;
+//# sourceMappingURL=conversation-status.enum.d.ts.map

package/dist/contracts/conversation-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-status.enum.d.ts","sourceRoot":"","sources":["../../src/contracts/conversation-status.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,kBAAkB,CAIzE,CAAC"}

package/dist/contracts/conversation-status.enum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERMINAL_CONVERSATION_STATUSES = exports.ConversationStatus = void 0;
+var ConversationStatus;
+(function (ConversationStatus) {
+    ConversationStatus["IDLE"] = "IDLE";
+    ConversationStatus["RUNNING"] = "RUNNING";
+    ConversationStatus["WAITING_TOOL"] = "WAITING_TOOL";
+    ConversationStatus["INTERRUPTED"] = "INTERRUPTED";
+    ConversationStatus["COMPLETED"] = "COMPLETED";
+    ConversationStatus["FAILED"] = "FAILED";
+    ConversationStatus["CANCELLED"] = "CANCELLED";
+})(ConversationStatus || (exports.ConversationStatus = ConversationStatus = {}));
+exports.TERMINAL_CONVERSATION_STATUSES = new Set([
+    ConversationStatus.COMPLETED,
+    ConversationStatus.FAILED,
+    ConversationStatus.CANCELLED
+]);
+//# sourceMappingURL=conversation-status.enum.js.map

package/dist/contracts/conversation-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-status.enum.js","sourceRoot":"","sources":["../../src/contracts/conversation-status.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,mDAA6B,CAAA;IAC7B,iDAA2B,CAAA;IAC3B,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,6CAAuB,CAAA;AACzB,CAAC,EARW,kBAAkB,kCAAlB,kBAAkB,QAQ7B;AAEY,QAAA,8BAA8B,GAAoC,IAAI,GAAG,CAAC;IACrF,kBAAkB,CAAC,SAAS;IAC5B,kBAAkB,CAAC,MAAM;IACzB,kBAAkB,CAAC,SAAS;CAC7B,CAAC,CAAC"}

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

@@ -0,0 +1,245 @@
+import { ConversationStatus } from "./conversation-status.enum";
+import { ConversationEvent, StreamMode } from "./events.types";
+import { LlmAdapter, LlmChatResponse, LlmStructuredOutputStrategy, LlmModelInfo, LlmPreflightResult, LlmRuntimePolicy, LlmStreamChunk, StallDetectionMode } from "./llm.types";
+import { ConversationMessage } from "./message.types";
+import type { ConversationPlugin } from "./plugin.types";
+import { SkillDefinition } from "./skill.types";
+import { ConversationStorageConfig } from "./storage.types";
+import { ConversationTool, ToolExecutionTrace, ToolMiddleware, ToolRetryPolicy } from "./tool.types";
+import { ConversationInterrupt, ConversationInterruptDecision, ConversationInterruptOnMap, ConversationResumeResponse } from "./interrupt.types";
+import type { ContextWindowConfig } from "../libs/context-window.class";
+import type { DebugLevel } from "../libs/debug-logger.class";
+import { z } from "zod";
+import type { ToolRouterConfig } from "../libs/tool-router";
+import type { SubAgentJobManagerConfig } from "./subagent.types";
+import type { SubAgent } from "./subagent.types";
+import type { ContextConfig } from "./context-document.types";
+export type { ContextWindowConfig, ConversationPlugin, DebugLevel };
+export interface ConversationCallbacks {
+    onMessagePushStream?: (chunk: {
+        contentDelta?: string;
+        fullContent: string;
+        thinkingDelta?: string;
+        fullThinking?: string;
+        done: boolean;
+        metadata?: Record<string, unknown>;
+    }) => void;
+    onStatusChange?: (status: ConversationStatus) => void;
+    onToolEvent?: (tool: ToolExecutionTrace) => void;
+    onInterrupt?: (interrupt: ConversationInterrupt) => void;
+    onInterruptResolved?: (payload: {
+        interruptId: string;
+        decisions: ConversationInterruptDecision[];
+    }) => void;
+    onStreamMode?: (event: {
+        mode: StreamMode;
+        name: string;
+        payload: Record<string, unknown>;
+    }) => void;
+    onEvent?: (event: ConversationEvent) => void;
+    onError?: (error: Error) => void;
+}
+export interface ModelRoutingContext {
+    phase: "turn" | "resume";
+    iteration: number;
+    defaultModel: string;
+    messages: ConversationMessage[];
+}
+export type ConversationModelRouter = (context: ModelRoutingContext) => string | undefined;
+export interface ModelGuardrailContext {
+    phase: "turn" | "resume" | "structured";
+    iteration: number;
+    model: string;
+    messages: ConversationMessage[];
+    metadata: Record<string, unknown>;
+}
+export type BeforeModelHook = (context: ModelGuardrailContext) => void | Promise<void>;
+export type AfterModelHook = (context: ModelGuardrailContext & {
+    response: LlmChatResponse["message"];
+}) => void | Promise<void>;
+export interface ToolFilteringContext {
+    phase: "turn" | "resume";
+    iteration: number;
+    toolName: string;
+    metadata: Record<string, unknown>;
+    permissions: string[];
+}
+export type ConversationToolFilter = (context: ToolFilteringContext) => boolean;
+export interface ConversationConfig extends ConversationCallbacks {
+    llmAdapter?: LlmAdapter;
+    host?: string;
+    port?: number;
+    baseUrl?: string;
+    model?: string;
+    thinking?: boolean;
+    /** Emit dedicated reasoning token channel (`messages/reasoning_token`). Default: false. */
+    reasoningStream?: boolean;
+    temperature?: number;
+    numCtx?: number;
+    seed?: number;
+    loadModelsOnInit?: boolean;
+    runPreflightOnInit?: boolean;
+    stallDetection?: StallDetectionMode;
+    /** Hard cap on model iterations within a single sendPrompt()/resume() call. */
+    maxIterationsPerRun?: number;
+    /** Hard cap on total model iterations within current session/thread. */
+    maxIterationsPerThread?: number;
+    /** Hard cap on total tool calls within a single sendPrompt()/resume() call. */
+    maxToolCallsPerRun?: number;
+    /** Hard cap per tool name within a single sendPrompt()/resume() call. */
+    maxToolCallsPerTool?: Record<string, number>;
+    /** Retry policy for transient failures on selected I/O tools. */
+    toolRetryPolicy?: ToolRetryPolicy;
+    /** Optional policy hook executed before every model call. */
+    beforeModelHook?: BeforeModelHook;
+    /** Optional policy hook executed after every model response. */
+    afterModelHook?: AfterModelHook;
+    onTurnComplete?: (messages: ConversationMessage[]) => Promise<void>;
+    userLanguage?: string;
+    systemPrompt?: string;
+    tools?: ConversationTool[];
+    skills?: SkillDefinition[];
+    metadata?: Record<string, unknown>;
+    /** Optional schema used to validate/normalize runtime context metadata before model/tool execution. */
+    contextSchema?: z.ZodTypeAny;
+    /** Unified model runtime policy for timeout/retry/circuit-breaker. */
+    llmRuntimePolicy?: LlmRuntimePolicy;
+    /**
+     * Optional dynamic model selection hook executed before each LLM iteration.
+     * Return undefined/empty string to keep using defaultModel.
+     */
+    modelRouter?: ConversationModelRouter;
+    /**
+     * Optional dynamic tool filter evaluated per iteration and phase.
+     * Return false to hide/block a tool for the current runtime context.
+     */
+    toolFilter?: ConversationToolFilter;
+    /** Per-tool HITL configuration. Tools listed here can pause run and wait for resume(decisions). */
+    interruptOn?: ConversationInterruptOnMap;
+    /** Default description prefix for interrupt requests without per-tool description. */
+    interruptDescriptionPrefix?: string;
+    /** Optional session id (uuidv4). Auto-generated if not provided. */
+    sessionId?: string;
+    /** Optional thread id alias (preferred naming for checkpointed thread state). */
+    threadId?: string;
+    /** Per-namespace storage adapters. Defaults to InMemoryAdapter for each missing namespace. */
+    storage?: ConversationStorageConfig;
+    /** Context window management strategy. Disabled by default. */
+    contextWindow?: ContextWindowConfig;
+    /** Tool middleware list. Applied to all tool executions in this conversation. */
+    middleware?: ToolMiddleware[];
+    /**
+     * Workspace root directory. Passed to PluginContext so plugins that need
+     * filesystem access (WorkspacePlugin, DockerPlugin) can receive it without
+     * reading environment variables.
+     */
+    rootDir?: string;
+    /**
+     * Plugins to install on construction. Each plugin's install() is called
+     * with the conversation's ToolRegistry and rootDir.
+     */
+    plugins?: ConversationPlugin[];
+    /**
+     * Debug logging level.
+     * - "off"     — no output (default)
+     * - "info"    — key lifecycle events: iteration count, tool calls, stop reason
+     * - "verbose" — everything: LLM responses, tool args/output, stall detection
+     */
+    debugLevel?: DebugLevel;
+    /** Payload offload cache directory. Default: ".payload-cache". */
+    payloadOffloadCacheDir?: string;
+    /** Payload offload threshold in characters. Payloads larger than this will be offloaded to disk. Default: 20000. */
+    payloadOffloadThreshold?: number;
+    /** Skip installing the default duplicate-detection middleware. Use when caller already added their own middleware instances. */
+    skipDefaultMiddleware?: boolean;
+    /** Skip auto-registering core reasoning tools (solve_complex, problem_tree, adaptive_lookup, comparative_analysis). */
+    skipCoreTools?: boolean;
+    /**
+     * Optional tool router configuration for intelligent tool selection.
+     * When configured, only relevant tools (based on user intent and keywords)
+     * are sent to the LLM, reducing prompt size and improving quality.
+     *
+     * Modes:
+     * - "rule-based": keyword matching and namespace scoring (fast, no LLM cost)
+     * - "model-based": uses an LLM to select relevant tools (more accurate)
+     * - "hybrid": rule-based first, falls back to model-based on low confidence
+     */
+    toolRouter?: ToolRouterConfig;
+    /**
+     * Optional subagent job manager configuration for background subagent execution.
+     * When configured, a {@link subagent_job} tool is automatically registered,
+     * allowing the LLM to spawn, monitor, and await background subagent tasks.
+     */
+    subagentJobs?: SubAgentJobManagerConfig;
+    /**
+     * Subagent profiles available for background job spawning via {@link subagent_job} tool.
+     * Maps profile labels (e.g., "research", "code-review") to SubAgent definitions.
+     * Only used when {@link subagentJobs} is also configured.
+     */
+    subagentProfiles?: Record<string, SubAgent>;
+    /**
+     * Context document intelligence — inject domain knowledge documents
+     * (DECISIONS.md, ARCHITECTURE.md, GLOSSARY.md, etc.) into LLM prompts.
+     *
+     * Documents are decomposed at init (LLM-driven summaries, keywords, categories),
+     * cached by checksum, and intelligently routed per-turn so only relevant
+     * documents are injected.
+     *
+     * Configuration is tree-style — all settings nest under `context.*`.
+     */
+    context?: ContextConfig;
+}
+export interface ConversationInitInfo {
+    models: LlmModelInfo[];
+    preflight?: LlmPreflightResult;
+}
+export interface SendPromptOptions {
+    skillNames?: string[];
+    metadata?: Record<string, unknown>;
+    signal?: AbortSignal;
+    /** When true (default), uses streaming for real-time output. Set false for background subagents. */
+    stream?: boolean;
+}
+export interface ResumeOptions {
+    metadata?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+export interface CallStructuredOptions extends SendPromptOptions {
+    /** Maximum number of LLM attempts when JSON parsing/schema validation fails. */
+    maxRetries?: number;
+    /** Preferred strategy for structured output generation. Default: provider-native. */
+    structuredOutputStrategy?: LlmStructuredOutputStrategy;
+    /** Try to auto-repair partial payloads before retrying model. Default: true. */
+    autoRepairStructuredOutput?: boolean;
+}
+export interface CallStructuredStreamingOptions extends CallStructuredOptions {
+    /** Optional streaming callback for partial raw model output while generating JSON. */
+    onChunk?: (chunk: LlmStreamChunk) => void;
+}
+export interface CallStructuredRetryError extends Error {
+    attempts: number;
+    lastRawOutput?: string;
+    lastParseError?: string;
+}
+export interface CallStructuredRequest<T> {
+    prompt: string;
+    schema: z.ZodType<T>;
+    options?: CallStructuredOptions;
+}
+export interface ConversationTurnResult {
+    output: string;
+    thinking?: string;
+    stopReason?: "completed" | "aborted" | "stall" | "repetition" | "max-iterations" | "max-tool-calls" | "interrupted";
+    status: ConversationStatus;
+    messages: ConversationMessage[];
+    toolExecutions: ToolExecutionTrace[];
+    interrupt?: ConversationInterrupt;
+    tokensInput: number;
+    tokensOutput: number;
+    iterationsUsed: number;
+}
+export interface ResumeRequest {
+    response: ConversationResumeResponse;
+    options?: ResumeOptions;
+}
+//# sourceMappingURL=conversation.types.d.ts.map

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

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

package/dist/contracts/conversation.types.js

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

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

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

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

@@ -0,0 +1,220 @@
+import type { KnowledgeNodeType } from "./knowledge-graph.types";
+/**
+ * The kind of source file discovered during scanning.
+ * Code sources are auto-approved; others need human verification.
+ */
+export type DocSourceKind = "code" | "markdown" | "openapi" | "protobuf" | "graphql_schema" | "database_schema" | "config" | "other";
+export type DocSourceApproval = "auto" | "pending" | "approved" | "rejected";
+/**
+ * A discovered source file, pending or approved for inclusion.
+ */
+export interface DocSource {
+    /** Relative path from project root. */
+    filePath: string;
+    kind: DocSourceKind;
+    approval: DocSourceApproval;
+    /** SHA-256 of file content at time of last scan. */
+    contentHash: string;
+    /** Size in bytes. */
+    sizeBytes: number;
+    /** When this source was last scanned. */
+    scannedAt: string;
+    /** Who/what approved (human name, "auto", or undefined). */
+    approvedBy?: string;
+    /** Reason for rejection if rejected. */
+    rejectionReason?: string;
+}
+/**
+ * A domain section is a logical area of the system (Auth, Billing, etc.)
+ * that groups related code, docs, and their LLM-generated summary.
+ */
+export interface DomainSection {
+    /** Unique ID (uuid). */
+    id: string;
+    /** Human-readable domain name ("Authentication", "Payment Processing"). */
+    name: string;
+    /** Slug for programmatic access ("authentication", "payment-processing"). */
+    slug: string;
+    /** LLM-generated summary of this domain area. */
+    summary: string;
+    /** What this domain handles — capabilities list. */
+    capabilities: string[];
+    /** KnowledgeGraph node IDs belonging to this section. */
+    nodeIds: string[];
+    /** Source files that contribute to this section. */
+    sourceFiles: string[];
+    /** Tags for filtering ("security", "core", "api"). */
+    tags: string[];
+    /** Content hash of the summary + node IDs — for staleness detection. */
+    contentHash: string;
+    /** Whether the section needs regeneration (code changed since last summary). */
+    stale: boolean;
+    /** Which individual source files changed since last generation. */
+    staleFiles: string[];
+    /** When this section was last generated/refreshed. */
+    generatedAt: string;
+    updatedAt: string;
+}
+/**
+ * Input for creating a new DomainSection.
+ */
+export interface CreateDomainSectionInput {
+    name: string;
+    slug: string;
+    summary: string;
+    capabilities: string[];
+    nodeIds: string[];
+    sourceFiles: string[];
+    tags?: string[];
+}
+/**
+ * Input for updating an existing DomainSection.
+ */
+export type UpdateDomainSectionInput = Partial<CreateDomainSectionInput>;
+/**
+ * Per-file hash record used to detect which files changed.
+ */
+export interface FileHashRecord {
+    filePath: string;
+    /** SHA-256 of file content. */
+    hash: string;
+    /** When this hash was recorded. */
+    recordedAt: string;
+}
+/**
+ * Result of a staleness check: which sections need refresh.
+ */
+export interface StalenessReport {
+    /** Total files checked. */
+    totalFiles: number;
+    /** Files whose hash changed since last recording. */
+    changedFiles: string[];
+    /** Sections affected by those changes. */
+    staleSections: Array<{
+        sectionId: string;
+        sectionName: string;
+        changedFiles: string[];
+    }>;
+    checkedAt: string;
+}
+/**
+ * Callbacks injected into the DocGraphBuilder pipeline.
+ * Callers wire these to LLM, filesystem, or human-in-the-loop.
+ */
+export interface DocGraphCallbacks {
+    /**
+     * Discover source files in the project.
+     * Returns raw file list — approval filtering happens separately.
+     */
+    discoverSources: (rootDir: string) => Promise<DocSource[]>;
+    /**
+     * Request human approval for a non-auto source.
+     * Returns updated approval status.
+     * If not provided, non-auto sources are skipped.
+     */
+    requestApproval?: (source: DocSource) => Promise<DocSourceApproval>;
+    /**
+     * LLM: Cluster discovered nodes into domain areas.
+     * Given a list of node summaries, return proposed domain groupings.
+     */
+    clusterDomains: (nodes: DomainClusterInput[]) => Promise<DomainClusterResult[]>;
+    /**
+     * LLM: Generate or refresh a domain section summary.
+     * Given nodes + their descriptions + source contents, produce summary + capabilities.
+     */
+    generateSummary: (input: SummaryGenerationInput) => Promise<SummaryGenerationResult>;
+    /** Optional progress callback. */
+    onProgress?: (stage: DocGraphStage, message: string) => void;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Input node summary for domain clustering.
+ */
+export interface DomainClusterInput {
+    nodeId: string;
+    name: string;
+    type: KnowledgeNodeType;
+    description: string;
+    sourceFile?: string;
+    tags?: string[];
+}
+/**
+ * Result of domain clustering: a proposed grouping.
+ */
+export interface DomainClusterResult {
+    /** Proposed domain name. */
+    domainName: string;
+    /** Proposed slug. */
+    slug: string;
+    /** Node IDs in this cluster. */
+    nodeIds: string[];
+    /** Short justification for this grouping. */
+    rationale: string;
+    /** Suggested tags. */
+    tags: string[];
+}
+export interface SummaryGenerationInput {
+    domainName: string;
+    /** Existing summary (for refresh — LLM can diff). */
+    existingSummary?: string;
+    /** Node descriptions in this domain. */
+    nodes: Array<{
+        name: string;
+        type: string;
+        description: string;
+        sourceFile?: string;
+    }>;
+    /** Contents of changed source files (trimmed for context). */
+    sourceSnippets: Array<{
+        filePath: string;
+        content: string;
+    }>;
+}
+export interface SummaryGenerationResult {
+    summary: string;
+    capabilities: string[];
+}
+export type DocGraphStage = "source-discovery" | "source-approval" | "graph-population" | "domain-clustering" | "summary-generation" | "staleness-check";
+export interface DocGraphStageResult {
+    stage: DocGraphStage;
+    status: "completed" | "failed" | "skipped";
+    durationMs: number;
+    details?: Record<string, unknown>;
+    error?: string;
+}
+export interface DocGraphBuildResult {
+    stages: DocGraphStageResult[];
+    /** All domain sections (created or refreshed). */
+    sections: DomainSection[];
+    /** Sources that were discovered but not approved. */
+    pendingSources: DocSource[];
+    /** Staleness report (if staleness check was run). */
+    stalenessReport?: StalenessReport;
+    /** Total duration. */
+    durationMs: number;
+    builtAt: string;
+}
+export interface DocSectionQueryOptions {
+    /** Filter by domain name (partial match). */
+    search?: string;
+    /** Filter by tags (AND — must have all). */
+    tags?: string[];
+    /** Only sections that are stale. */
+    staleOnly?: boolean;
+    /** Only sections containing this source file. */
+    sourceFile?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DocSourceQueryOptions {
+    /** Filter by source kind. */
+    kinds?: DocSourceKind[];
+    /** Filter by approval status. */
+    approval?: DocSourceApproval;
+    /** Filter by file path prefix. */
+    pathPrefix?: string;
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=doc-graph.types.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Doc Graph Types — Domain-Oriented Code Documentation
+//
+// Layered on top of KnowledgeGraph: organizes knowledge into domain sections
+// (Auth, Billing, Messaging, etc.) with per-source staleness tracking.
+//
+// Key design decisions:
+//   • Each DomainSection groups related nodes from the graph + a summary
+//   • Sources are scanned but non-code sources (swagger, proto) need approval
+//   • File hashes track staleness — when code changes, sections are marked stale
+//   • Summaries are LLM-generated but tagged with the hash they describe
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=doc-graph.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-graph.types.js","sourceRoot":"","sources":["../../src/contracts/doc-graph.types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,EAAE;AACF,wBAAwB;AACxB,yEAAyE;AACzE,8EAA8E;AAC9E,iFAAiF;AACjF,yEAAyE;AACzE,gFAAgF"}

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

@@ -0,0 +1,47 @@
+import { ConversationMessage } from "./message.types";
+import { ConversationStatus } from "./conversation-status.enum";
+import { ToolExecutionTrace } from "./tool.types";
+import { ConversationInterrupt, ConversationInterruptDecision } from "./interrupt.types";
+export type StreamMode = "updates" | "messages" | "custom" | "tools";
+export type ConversationEvent = {
+    type: "status_changed";
+    status: ConversationStatus;
+    at: string;
+} | {
+    type: "message_pushed";
+    message: ConversationMessage;
+    at: string;
+} | {
+    type: "stream_chunk";
+    contentDelta?: string;
+    fullContent: string;
+    thinkingDelta?: string;
+    fullThinking?: string;
+    done: boolean;
+    metadata?: Record<string, unknown>;
+    at: string;
+} | {
+    type: "stream_mode";
+    mode: StreamMode;
+    name: string;
+    payload: Record<string, unknown>;
+    at: string;
+} | {
+    type: "tool_event";
+    tool: ToolExecutionTrace;
+    at: string;
+} | {
+    type: "interrupt";
+    interrupt: ConversationInterrupt;
+    at: string;
+} | {
+    type: "interrupt_resolved";
+    interruptId: string;
+    decisions: ConversationInterruptDecision[];
+    at: string;
+} | {
+    type: "error";
+    error: string;
+    at: string;
+};
+//# sourceMappingURL=events.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.types.d.ts","sourceRoot":"","sources":["../../src/contracts/events.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEzF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,6BAA6B,EAAE,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC"}

package/dist/contracts/events.types.js

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

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

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

package/dist/contracts/execution-runner.types.d.ts

@@ -0,0 +1,13 @@
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface CommandOptions {
+    cwd?: string;
+    timeout?: number;
+}
+export interface ExecutionRunner {
+    run(command: string, options?: CommandOptions): Promise<CommandResult>;
+}
+//# sourceMappingURL=execution-runner.types.d.ts.map

package/dist/contracts/execution-runner.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-runner.types.d.ts","sourceRoot":"","sources":["../../src/contracts/execution-runner.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxE"}

package/dist/contracts/execution-runner.types.js

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

package/dist/contracts/execution-runner.types.js.map

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