@contractspec/module.ai-chat 1.44.0

package/dist/context/file-operations.js

@@ -0,0 +1,175 @@
+//#region src/context/file-operations.ts
+/**
+* File operations executor
+*/
+var FileOperations = class {
+	constructor(fs, workspacePath, allowWrites = false) {
+		this.fs = fs;
+		this.workspacePath = workspacePath;
+		this.allowWrites = allowWrites;
+	}
+	/**
+	* Read a file
+	*/
+	async read(relativePath) {
+		const fullPath = this.resolvePath(relativePath);
+		try {
+			return {
+				success: true,
+				path: relativePath,
+				content: await this.fs.readFile(fullPath)
+			};
+		} catch (error) {
+			return {
+				success: false,
+				path: relativePath,
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+	}
+	/**
+	* Write to a file
+	*/
+	async write(relativePath, content) {
+		if (!this.allowWrites) return {
+			success: false,
+			path: relativePath,
+			error: "File writes are not enabled"
+		};
+		const fullPath = this.resolvePath(relativePath);
+		try {
+			await this.fs.writeFile(fullPath, content);
+			return {
+				success: true,
+				path: relativePath
+			};
+		} catch (error) {
+			return {
+				success: false,
+				path: relativePath,
+				error: error instanceof Error ? error.message : String(error)
+			};
+		}
+	}
+	/**
+	* Execute multiple file operations
+	*/
+	async execute(operations) {
+		const results = [];
+		for (const operation of operations) {
+			let result;
+			switch (operation.type) {
+				case "read": {
+					const readResult = await this.read(operation.path);
+					result = {
+						operation,
+						success: readResult.success,
+						content: readResult.content,
+						error: readResult.error
+					};
+					break;
+				}
+				case "write":
+				case "create":
+					if (!operation.content) result = {
+						operation,
+						success: false,
+						error: "Content is required for write operations"
+					};
+					else {
+						const writeResult = await this.write(operation.path, operation.content);
+						result = {
+							operation,
+							success: writeResult.success,
+							error: writeResult.error
+						};
+					}
+					break;
+				case "delete":
+					if (!this.allowWrites) result = {
+						operation,
+						success: false,
+						error: "File writes are not enabled"
+					};
+					else try {
+						await this.fs.deleteFile(this.resolvePath(operation.path));
+						result = {
+							operation,
+							success: true
+						};
+					} catch (error) {
+						result = {
+							operation,
+							success: false,
+							error: error instanceof Error ? error.message : String(error)
+						};
+					}
+					break;
+				default: result = {
+					operation,
+					success: false,
+					error: `Unknown operation type: ${operation.type}`
+				};
+			}
+			results.push(result);
+		}
+		return results;
+	}
+	/**
+	* Resolve a relative path to an absolute path
+	*/
+	resolvePath(relativePath) {
+		const normalized = relativePath.replace(/\.\./g, "").replace(/^\//, "");
+		return `${this.workspacePath}/${normalized}`;
+	}
+};
+/**
+* Create a file operations instance with Node.js fs
+*/
+function createNodeFileOperations(workspacePath, allowWrites = false) {
+	return new FileOperations({
+		async readFile(path) {
+			const { readFile } = await import("node:fs/promises");
+			return readFile(path, "utf-8");
+		},
+		async writeFile(path, content) {
+			const { writeFile, mkdir } = await import("node:fs/promises");
+			const { dirname } = await import("node:path");
+			await mkdir(dirname(path), { recursive: true });
+			await writeFile(path, content, "utf-8");
+		},
+		async exists(path) {
+			const { access } = await import("node:fs/promises");
+			try {
+				await access(path);
+				return true;
+			} catch {
+				return false;
+			}
+		},
+		async deleteFile(path) {
+			const { unlink } = await import("node:fs/promises");
+			await unlink(path);
+		},
+		async listFiles(directory, options) {
+			const { readdir } = await import("node:fs/promises");
+			const { join } = await import("node:path");
+			const files = [];
+			const entries = await readdir(directory, { withFileTypes: true });
+			for (const entry of entries) {
+				const fullPath = join(directory, entry.name);
+				if (entry.isDirectory() && options?.recursive) {
+					const subFiles = await this.listFiles(fullPath, options);
+					files.push(...subFiles);
+				} else if (entry.isFile()) {
+					if (!options?.pattern || entry.name.match(new RegExp(options.pattern))) files.push(fullPath);
+				}
+			}
+			return files;
+		}
+	}, workspacePath, allowWrites);
+}
+
+//#endregion
+export { FileOperations, createNodeFileOperations };
+//# sourceMappingURL=file-operations.js.map

package/dist/context/file-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.js","names":["fs: FileSystem","workspacePath: string","results: FileOperationResult[]","result: FileOperationResult","files: string[]"],"sources":["../../src/context/file-operations.ts"],"sourcesContent":["/**\n * File operations for workspace context\n *\n * Provides read/write operations for files in the workspace.\n */\n\n/**\n * Result of a file read operation\n */\nexport interface FileReadResult {\n  success: boolean;\n  path: string;\n  content?: string;\n  error?: string;\n}\n\n/**\n * Result of a file write operation\n */\nexport interface FileWriteResult {\n  success: boolean;\n  path: string;\n  error?: string;\n}\n\n/**\n * File operation to perform\n */\nexport interface FileOperation {\n  type: 'read' | 'write' | 'create' | 'delete';\n  path: string;\n  content?: string;\n}\n\n/**\n * Result of a file operation\n */\nexport interface FileOperationResult {\n  operation: FileOperation;\n  success: boolean;\n  content?: string;\n  error?: string;\n}\n\n/**\n * Interface for file system operations\n */\nexport interface FileSystem {\n  /**\n   * Read a file's contents\n   */\n  readFile(path: string): Promise<string>;\n\n  /**\n   * Write content to a file\n   */\n  writeFile(path: string, content: string): Promise<void>;\n\n  /**\n   * Check if a file exists\n   */\n  exists(path: string): Promise<boolean>;\n\n  /**\n   * Delete a file\n   */\n  deleteFile(path: string): Promise<void>;\n\n  /**\n   * List files in a directory\n   */\n  listFiles(\n    directory: string,\n    options?: { recursive?: boolean; pattern?: string }\n  ): Promise<string[]>;\n}\n\n/**\n * File operations executor\n */\nexport class FileOperations {\n  constructor(\n    private readonly fs: FileSystem,\n    private readonly workspacePath: string,\n    private readonly allowWrites = false\n  ) {}\n\n  /**\n   * Read a file\n   */\n  async read(relativePath: string): Promise<FileReadResult> {\n    const fullPath = this.resolvePath(relativePath);\n\n    try {\n      const content = await this.fs.readFile(fullPath);\n      return { success: true, path: relativePath, content };\n    } catch (error) {\n      return {\n        success: false,\n        path: relativePath,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  /**\n   * Write to a file\n   */\n  async write(relativePath: string, content: string): Promise<FileWriteResult> {\n    if (!this.allowWrites) {\n      return {\n        success: false,\n        path: relativePath,\n        error: 'File writes are not enabled',\n      };\n    }\n\n    const fullPath = this.resolvePath(relativePath);\n\n    try {\n      await this.fs.writeFile(fullPath, content);\n      return { success: true, path: relativePath };\n    } catch (error) {\n      return {\n        success: false,\n        path: relativePath,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  /**\n   * Execute multiple file operations\n   */\n  async execute(operations: FileOperation[]): Promise<FileOperationResult[]> {\n    const results: FileOperationResult[] = [];\n\n    for (const operation of operations) {\n      let result: FileOperationResult;\n\n      switch (operation.type) {\n        case 'read': {\n          const readResult = await this.read(operation.path);\n          result = {\n            operation,\n            success: readResult.success,\n            content: readResult.content,\n            error: readResult.error,\n          };\n          break;\n        }\n\n        case 'write':\n        case 'create': {\n          if (!operation.content) {\n            result = {\n              operation,\n              success: false,\n              error: 'Content is required for write operations',\n            };\n          } else {\n            const writeResult = await this.write(\n              operation.path,\n              operation.content\n            );\n            result = {\n              operation,\n              success: writeResult.success,\n              error: writeResult.error,\n            };\n          }\n          break;\n        }\n\n        case 'delete': {\n          if (!this.allowWrites) {\n            result = {\n              operation,\n              success: false,\n              error: 'File writes are not enabled',\n            };\n          } else {\n            try {\n              await this.fs.deleteFile(this.resolvePath(operation.path));\n              result = { operation, success: true };\n            } catch (error) {\n              result = {\n                operation,\n                success: false,\n                error: error instanceof Error ? error.message : String(error),\n              };\n            }\n          }\n          break;\n        }\n\n        default:\n          result = {\n            operation,\n            success: false,\n            error: `Unknown operation type: ${(operation as FileOperation).type}`,\n          };\n      }\n\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Resolve a relative path to an absolute path\n   */\n  private resolvePath(relativePath: string): string {\n    // Prevent path traversal\n    const normalized = relativePath.replace(/\\.\\./g, '').replace(/^\\//, '');\n    return `${this.workspacePath}/${normalized}`;\n  }\n}\n\n/**\n * Create a file operations instance with Node.js fs\n */\nexport function createNodeFileOperations(\n  workspacePath: string,\n  allowWrites = false\n): FileOperations {\n  // Dynamic import to avoid issues in browser environments\n  const fs: FileSystem = {\n    async readFile(path: string): Promise<string> {\n      const { readFile } = await import('node:fs/promises');\n      return readFile(path, 'utf-8');\n    },\n    async writeFile(path: string, content: string): Promise<void> {\n      const { writeFile, mkdir } = await import('node:fs/promises');\n      const { dirname } = await import('node:path');\n      await mkdir(dirname(path), { recursive: true });\n      await writeFile(path, content, 'utf-8');\n    },\n    async exists(path: string): Promise<boolean> {\n      const { access } = await import('node:fs/promises');\n      try {\n        await access(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    async deleteFile(path: string): Promise<void> {\n      const { unlink } = await import('node:fs/promises');\n      await unlink(path);\n    },\n    async listFiles(\n      directory: string,\n      options?: { recursive?: boolean; pattern?: string }\n    ): Promise<string[]> {\n      const { readdir } = await import('node:fs/promises');\n      const { join } = await import('node:path');\n\n      const files: string[] = [];\n      const entries = await readdir(directory, { withFileTypes: true });\n\n      for (const entry of entries) {\n        const fullPath = join(directory, entry.name);\n        if (entry.isDirectory() && options?.recursive) {\n          const subFiles = await this.listFiles(fullPath, options);\n          files.push(...subFiles);\n        } else if (entry.isFile()) {\n          if (\n            !options?.pattern ||\n            entry.name.match(new RegExp(options.pattern))\n          ) {\n            files.push(fullPath);\n          }\n        }\n      }\n\n      return files;\n    },\n  };\n\n  return new FileOperations(fs, workspacePath, allowWrites);\n}\n"],"mappings":"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"}

package/dist/context/index.d.ts

@@ -0,0 +1,4 @@
+import { FileInfo, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createWorkspaceContext } from "./workspace-context.js";
+import { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, createContextBuilder } from "./context-builder.js";
+import { FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, createNodeFileOperations } from "./file-operations.js";
+export { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, FileInfo, FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createContextBuilder, createNodeFileOperations, createWorkspaceContext };

package/dist/context/index.js

@@ -0,0 +1,5 @@
+import { WorkspaceContext, createWorkspaceContext } from "./workspace-context.js";
+import { ContextBuilder, createContextBuilder } from "./context-builder.js";
+import { FileOperations, createNodeFileOperations } from "./file-operations.js";
+
+export { ContextBuilder, FileOperations, WorkspaceContext, createContextBuilder, createNodeFileOperations, createWorkspaceContext };

package/dist/context/workspace-context.d.ts

@@ -0,0 +1,117 @@
+//#region src/context/workspace-context.d.ts
+/**
+ * Workspace context management
+ *
+ * Provides access to specs, files, and codebase information
+ * for context-aware AI chat assistance.
+ */
+/**
+ * Spec information for context
+ */
+interface SpecInfo {
+  name: string;
+  version: number;
+  type: 'command' | 'query' | 'event' | 'presentation';
+  path: string;
+  description?: string;
+  tags?: string[];
+}
+/**
+ * File information for context
+ */
+interface FileInfo {
+  path: string;
+  relativePath: string;
+  name: string;
+  extension: string;
+  size: number;
+  isSpec: boolean;
+}
+/**
+ * Workspace summary for context
+ */
+interface WorkspaceSummary {
+  name: string;
+  path: string;
+  specs: {
+    total: number;
+    commands: number;
+    queries: number;
+    events: number;
+    presentations: number;
+  };
+  files: {
+    total: number;
+    typescript: number;
+    specFiles: number;
+  };
+}
+/**
+ * Configuration for workspace context
+ */
+interface WorkspaceContextConfig {
+  /** Root path of the workspace */
+  workspacePath: string;
+  /** File patterns to include */
+  includePatterns?: string[];
+  /** File patterns to exclude */
+  excludePatterns?: string[];
+  /** Maximum file size to read (bytes) */
+  maxFileSize?: number;
+  /** Whether to enable file writes */
+  allowWrites?: boolean;
+}
+/**
+ * Workspace context for AI chat
+ */
+declare class WorkspaceContext {
+  readonly workspacePath: string;
+  readonly allowWrites: boolean;
+  private specs;
+  private files;
+  private initialized;
+  constructor(config: WorkspaceContextConfig);
+  /**
+   * Initialize the workspace context by scanning files
+   */
+  initialize(): Promise<void>;
+  /**
+   * Get all discovered specs
+   */
+  getSpecs(): SpecInfo[];
+  /**
+   * Get all discovered files
+   */
+  getFiles(): FileInfo[];
+  /**
+   * Add specs to the context
+   */
+  addSpecs(specs: SpecInfo[]): void;
+  /**
+   * Add files to the context
+   */
+  addFiles(files: FileInfo[]): void;
+  /**
+   * Get a summary of the workspace for context
+   */
+  getSummary(): WorkspaceSummary;
+  /**
+   * Get a context summary for LLM prompts
+   */
+  getContextSummary(): string;
+  /**
+   * Find specs matching a query
+   */
+  findSpecs(query: string): SpecInfo[];
+  /**
+   * Find files matching a query
+   */
+  findFiles(query: string): FileInfo[];
+}
+/**
+ * Create a workspace context from a path
+ */
+declare function createWorkspaceContext(path: string, options?: Partial<WorkspaceContextConfig>): Promise<WorkspaceContext>;
+//#endregion
+export { FileInfo, SpecInfo, WorkspaceContext, WorkspaceContextConfig, WorkspaceSummary, createWorkspaceContext };
+//# sourceMappingURL=workspace-context.d.ts.map

package/dist/context/workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-context.d.ts","names":[],"sources":["../../src/context/workspace-context.ts"],"sourcesContent":[],"mappings":";;AAUA;AAYA;AAYA;AAoBA;AAgBA;;;;AAkCc,UA9FG,QAAA,CA8FH;EAOI,IAAA,EAAA,MAAA;EAOA,OAAA,EAAA,MAAA;EAOF,IAAA,EAAA,SAAA,GAAA,OAAA,GAAA,OAAA,GAAA,cAAA;EA8DY,IAAA,EAAA,MAAA;EAaA,WAAA,CAAA,EAAA,MAAA;EAAQ,IAAA,CAAA,EAAA,MAAA,EAAA;AAapC;;;;AAGG,UAlMc,QAAA,CAkMd;EAAO,IAAA,EAAA,MAAA;;;;;;;;;;UAtLO,gBAAA;;;;;;;;;;;;;;;;;;;UAoBA,sBAAA;;;;;;;;;;;;;;;cAgBJ,gBAAA;;;;;;sBAQS;;;;gBAQA;;;;cAWR;;;;cAOA;;;;kBAOI;;;;kBAOA;;;;gBAOF;;;;;;;;4BA8DY;;;;4BAaA;;;;;iBAaN,sBAAA,yBAEV,QAAQ,0BACjB,QAAQ"}

package/dist/context/workspace-context.js

@@ -0,0 +1,124 @@
+//#region src/context/workspace-context.ts
+/**
+* Workspace context for AI chat
+*/
+var WorkspaceContext = class {
+	workspacePath;
+	allowWrites;
+	specs = [];
+	files = [];
+	initialized = false;
+	constructor(config) {
+		this.workspacePath = config.workspacePath;
+		this.allowWrites = config.allowWrites ?? false;
+	}
+	/**
+	* Initialize the workspace context by scanning files
+	*/
+	async initialize() {
+		if (this.initialized) return;
+		this.initialized = true;
+	}
+	/**
+	* Get all discovered specs
+	*/
+	getSpecs() {
+		return this.specs;
+	}
+	/**
+	* Get all discovered files
+	*/
+	getFiles() {
+		return this.files;
+	}
+	/**
+	* Add specs to the context
+	*/
+	addSpecs(specs) {
+		this.specs.push(...specs);
+	}
+	/**
+	* Add files to the context
+	*/
+	addFiles(files) {
+		this.files.push(...files);
+	}
+	/**
+	* Get a summary of the workspace for context
+	*/
+	getSummary() {
+		const commands = this.specs.filter((s) => s.type === "command").length;
+		const queries = this.specs.filter((s) => s.type === "query").length;
+		const events = this.specs.filter((s) => s.type === "event").length;
+		const presentations = this.specs.filter((s) => s.type === "presentation").length;
+		const tsFiles = this.files.filter((f) => f.extension === ".ts").length;
+		const specFiles = this.files.filter((f) => f.isSpec).length;
+		return {
+			name: this.workspacePath.split("/").pop() ?? "workspace",
+			path: this.workspacePath,
+			specs: {
+				total: this.specs.length,
+				commands,
+				queries,
+				events,
+				presentations
+			},
+			files: {
+				total: this.files.length,
+				typescript: tsFiles,
+				specFiles
+			}
+		};
+	}
+	/**
+	* Get a context summary for LLM prompts
+	*/
+	getContextSummary() {
+		const summary = this.getSummary();
+		const parts = [
+			`Workspace: ${summary.name}`,
+			`Path: ${summary.path}`,
+			"",
+			"### Specs",
+			`- Commands: ${summary.specs.commands}`,
+			`- Queries: ${summary.specs.queries}`,
+			`- Events: ${summary.specs.events}`,
+			`- Presentations: ${summary.specs.presentations}`
+		];
+		if (this.specs.length > 0) {
+			parts.push("", "### Available Specs");
+			for (const spec of this.specs.slice(0, 20)) parts.push(`- ${spec.name} (${spec.type})`);
+			if (this.specs.length > 20) parts.push(`- ... and ${this.specs.length - 20} more`);
+		}
+		return parts.join("\n");
+	}
+	/**
+	* Find specs matching a query
+	*/
+	findSpecs(query) {
+		const lowerQuery = query.toLowerCase();
+		return this.specs.filter((s) => s.name.toLowerCase().includes(lowerQuery) || s.description?.toLowerCase().includes(lowerQuery) || s.tags?.some((t) => t.toLowerCase().includes(lowerQuery)));
+	}
+	/**
+	* Find files matching a query
+	*/
+	findFiles(query) {
+		const lowerQuery = query.toLowerCase();
+		return this.files.filter((f) => f.path.toLowerCase().includes(lowerQuery) || f.name.toLowerCase().includes(lowerQuery));
+	}
+};
+/**
+* Create a workspace context from a path
+*/
+async function createWorkspaceContext(path, options) {
+	const context = new WorkspaceContext({
+		workspacePath: path,
+		...options
+	});
+	await context.initialize();
+	return context;
+}
+
+//#endregion
+export { WorkspaceContext, createWorkspaceContext };
+//# sourceMappingURL=workspace-context.js.map

package/dist/context/workspace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-context.js","names":["parts: string[]"],"sources":["../../src/context/workspace-context.ts"],"sourcesContent":["/**\n * Workspace context management\n *\n * Provides access to specs, files, and codebase information\n * for context-aware AI chat assistance.\n */\n\n/**\n * Spec information for context\n */\nexport interface SpecInfo {\n  name: string;\n  version: number;\n  type: 'command' | 'query' | 'event' | 'presentation';\n  path: string;\n  description?: string;\n  tags?: string[];\n}\n\n/**\n * File information for context\n */\nexport interface FileInfo {\n  path: string;\n  relativePath: string;\n  name: string;\n  extension: string;\n  size: number;\n  isSpec: boolean;\n}\n\n/**\n * Workspace summary for context\n */\nexport interface WorkspaceSummary {\n  name: string;\n  path: string;\n  specs: {\n    total: number;\n    commands: number;\n    queries: number;\n    events: number;\n    presentations: number;\n  };\n  files: {\n    total: number;\n    typescript: number;\n    specFiles: number;\n  };\n}\n\n/**\n * Configuration for workspace context\n */\nexport interface WorkspaceContextConfig {\n  /** Root path of the workspace */\n  workspacePath: string;\n  /** File patterns to include */\n  includePatterns?: string[];\n  /** File patterns to exclude */\n  excludePatterns?: string[];\n  /** Maximum file size to read (bytes) */\n  maxFileSize?: number;\n  /** Whether to enable file writes */\n  allowWrites?: boolean;\n}\n\n/**\n * Workspace context for AI chat\n */\nexport class WorkspaceContext {\n  readonly workspacePath: string;\n  readonly allowWrites: boolean;\n\n  private specs: SpecInfo[] = [];\n  private files: FileInfo[] = [];\n  private initialized = false;\n\n  constructor(config: WorkspaceContextConfig) {\n    this.workspacePath = config.workspacePath;\n    this.allowWrites = config.allowWrites ?? false;\n  }\n\n  /**\n   * Initialize the workspace context by scanning files\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // This would scan the workspace for specs and files\n    // For now, we just mark as initialized\n    this.initialized = true;\n  }\n\n  /**\n   * Get all discovered specs\n   */\n  getSpecs(): SpecInfo[] {\n    return this.specs;\n  }\n\n  /**\n   * Get all discovered files\n   */\n  getFiles(): FileInfo[] {\n    return this.files;\n  }\n\n  /**\n   * Add specs to the context\n   */\n  addSpecs(specs: SpecInfo[]): void {\n    this.specs.push(...specs);\n  }\n\n  /**\n   * Add files to the context\n   */\n  addFiles(files: FileInfo[]): void {\n    this.files.push(...files);\n  }\n\n  /**\n   * Get a summary of the workspace for context\n   */\n  getSummary(): WorkspaceSummary {\n    const commands = this.specs.filter((s) => s.type === 'command').length;\n    const queries = this.specs.filter((s) => s.type === 'query').length;\n    const events = this.specs.filter((s) => s.type === 'event').length;\n    const presentations = this.specs.filter(\n      (s) => s.type === 'presentation'\n    ).length;\n\n    const tsFiles = this.files.filter((f) => f.extension === '.ts').length;\n    const specFiles = this.files.filter((f) => f.isSpec).length;\n\n    return {\n      name: this.workspacePath.split('/').pop() ?? 'workspace',\n      path: this.workspacePath,\n      specs: {\n        total: this.specs.length,\n        commands,\n        queries,\n        events,\n        presentations,\n      },\n      files: {\n        total: this.files.length,\n        typescript: tsFiles,\n        specFiles,\n      },\n    };\n  }\n\n  /**\n   * Get a context summary for LLM prompts\n   */\n  getContextSummary(): string {\n    const summary = this.getSummary();\n\n    const parts: string[] = [\n      `Workspace: ${summary.name}`,\n      `Path: ${summary.path}`,\n      '',\n      '### Specs',\n      `- Commands: ${summary.specs.commands}`,\n      `- Queries: ${summary.specs.queries}`,\n      `- Events: ${summary.specs.events}`,\n      `- Presentations: ${summary.specs.presentations}`,\n    ];\n\n    if (this.specs.length > 0) {\n      parts.push('', '### Available Specs');\n      for (const spec of this.specs.slice(0, 20)) {\n        parts.push(`- ${spec.name} (${spec.type})`);\n      }\n      if (this.specs.length > 20) {\n        parts.push(`- ... and ${this.specs.length - 20} more`);\n      }\n    }\n\n    return parts.join('\\n');\n  }\n\n  /**\n   * Find specs matching a query\n   */\n  findSpecs(query: string): SpecInfo[] {\n    const lowerQuery = query.toLowerCase();\n    return this.specs.filter(\n      (s) =>\n        s.name.toLowerCase().includes(lowerQuery) ||\n        s.description?.toLowerCase().includes(lowerQuery) ||\n        s.tags?.some((t) => t.toLowerCase().includes(lowerQuery))\n    );\n  }\n\n  /**\n   * Find files matching a query\n   */\n  findFiles(query: string): FileInfo[] {\n    const lowerQuery = query.toLowerCase();\n    return this.files.filter(\n      (f) =>\n        f.path.toLowerCase().includes(lowerQuery) ||\n        f.name.toLowerCase().includes(lowerQuery)\n    );\n  }\n}\n\n/**\n * Create a workspace context from a path\n */\nexport async function createWorkspaceContext(\n  path: string,\n  options?: Partial<WorkspaceContextConfig>\n): Promise<WorkspaceContext> {\n  const context = new WorkspaceContext({\n    workspacePath: path,\n    ...options,\n  });\n  await context.initialize();\n  return context;\n}\n"],"mappings":";;;;AAsEA,IAAa,mBAAb,MAA8B;CAC5B,AAAS;CACT,AAAS;CAET,AAAQ,QAAoB,EAAE;CAC9B,AAAQ,QAAoB,EAAE;CAC9B,AAAQ,cAAc;CAEtB,YAAY,QAAgC;AAC1C,OAAK,gBAAgB,OAAO;AAC5B,OAAK,cAAc,OAAO,eAAe;;;;;CAM3C,MAAM,aAA4B;AAChC,MAAI,KAAK,YAAa;AAItB,OAAK,cAAc;;;;;CAMrB,WAAuB;AACrB,SAAO,KAAK;;;;;CAMd,WAAuB;AACrB,SAAO,KAAK;;;;;CAMd,SAAS,OAAyB;AAChC,OAAK,MAAM,KAAK,GAAG,MAAM;;;;;CAM3B,SAAS,OAAyB;AAChC,OAAK,MAAM,KAAK,GAAG,MAAM;;;;;CAM3B,aAA+B;EAC7B,MAAM,WAAW,KAAK,MAAM,QAAQ,MAAM,EAAE,SAAS,UAAU,CAAC;EAChE,MAAM,UAAU,KAAK,MAAM,QAAQ,MAAM,EAAE,SAAS,QAAQ,CAAC;EAC7D,MAAM,SAAS,KAAK,MAAM,QAAQ,MAAM,EAAE,SAAS,QAAQ,CAAC;EAC5D,MAAM,gBAAgB,KAAK,MAAM,QAC9B,MAAM,EAAE,SAAS,eACnB,CAAC;EAEF,MAAM,UAAU,KAAK,MAAM,QAAQ,MAAM,EAAE,cAAc,MAAM,CAAC;EAChE,MAAM,YAAY,KAAK,MAAM,QAAQ,MAAM,EAAE,OAAO,CAAC;AAErD,SAAO;GACL,MAAM,KAAK,cAAc,MAAM,IAAI,CAAC,KAAK,IAAI;GAC7C,MAAM,KAAK;GACX,OAAO;IACL,OAAO,KAAK,MAAM;IAClB;IACA;IACA;IACA;IACD;GACD,OAAO;IACL,OAAO,KAAK,MAAM;IAClB,YAAY;IACZ;IACD;GACF;;;;;CAMH,oBAA4B;EAC1B,MAAM,UAAU,KAAK,YAAY;EAEjC,MAAMA,QAAkB;GACtB,cAAc,QAAQ;GACtB,SAAS,QAAQ;GACjB;GACA;GACA,eAAe,QAAQ,MAAM;GAC7B,cAAc,QAAQ,MAAM;GAC5B,aAAa,QAAQ,MAAM;GAC3B,oBAAoB,QAAQ,MAAM;GACnC;AAED,MAAI,KAAK,MAAM,SAAS,GAAG;AACzB,SAAM,KAAK,IAAI,sBAAsB;AACrC,QAAK,MAAM,QAAQ,KAAK,MAAM,MAAM,GAAG,GAAG,CACxC,OAAM,KAAK,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,GAAG;AAE7C,OAAI,KAAK,MAAM,SAAS,GACtB,OAAM,KAAK,aAAa,KAAK,MAAM,SAAS,GAAG,OAAO;;AAI1D,SAAO,MAAM,KAAK,KAAK;;;;;CAMzB,UAAU,OAA2B;EACnC,MAAM,aAAa,MAAM,aAAa;AACtC,SAAO,KAAK,MAAM,QACf,MACC,EAAE,KAAK,aAAa,CAAC,SAAS,WAAW,IACzC,EAAE,aAAa,aAAa,CAAC,SAAS,WAAW,IACjD,EAAE,MAAM,MAAM,MAAM,EAAE,aAAa,CAAC,SAAS,WAAW,CAAC,CAC5D;;;;;CAMH,UAAU,OAA2B;EACnC,MAAM,aAAa,MAAM,aAAa;AACtC,SAAO,KAAK,MAAM,QACf,MACC,EAAE,KAAK,aAAa,CAAC,SAAS,WAAW,IACzC,EAAE,KAAK,aAAa,CAAC,SAAS,WAAW,CAC5C;;;;;;AAOL,eAAsB,uBACpB,MACA,SAC2B;CAC3B,MAAM,UAAU,IAAI,iBAAiB;EACnC,eAAe;EACf,GAAG;EACJ,CAAC;AACF,OAAM,QAAQ,YAAY;AAC1B,QAAO"}

package/dist/core/chat-service.d.ts

@@ -0,0 +1,73 @@
+import { WorkspaceContext } from "../context/workspace-context.js";
+import { ChatConversation, SendMessageOptions, SendMessageResult, StreamMessageResult } from "./message-types.js";
+import { ConversationStore } from "./conversation-store.js";
+import { Provider } from "@contractspec/lib.ai-providers";
+
+//#region src/core/chat-service.d.ts
+
+/**
+ * Configuration for ChatService
+ */
+interface ChatServiceConfig {
+  /** LLM provider to use */
+  provider: Provider;
+  /** Optional workspace context for code-aware chat */
+  context?: WorkspaceContext;
+  /** Optional conversation store (defaults to in-memory) */
+  store?: ConversationStore;
+  /** Default system prompt */
+  systemPrompt?: string;
+  /** Maximum conversation history to include */
+  maxHistoryMessages?: number;
+  /** Callback for usage tracking */
+  onUsage?: (usage: {
+    inputTokens: number;
+    outputTokens: number;
+  }) => void;
+}
+/**
+ * Main chat service for AI-powered conversations
+ */
+declare class ChatService {
+  private readonly provider;
+  private readonly context?;
+  private readonly store;
+  private readonly systemPrompt;
+  private readonly maxHistoryMessages;
+  private readonly onUsage?;
+  constructor(config: ChatServiceConfig);
+  /**
+   * Send a message and get a complete response
+   */
+  send(options: SendMessageOptions): Promise<SendMessageResult>;
+  /**
+   * Send a message and get a streaming response
+   */
+  stream(options: SendMessageOptions): Promise<StreamMessageResult>;
+  /**
+   * Get a conversation by ID
+   */
+  getConversation(conversationId: string): Promise<ChatConversation | null>;
+  /**
+   * List conversations
+   */
+  listConversations(options?: {
+    limit?: number;
+    offset?: number;
+  }): Promise<ChatConversation[]>;
+  /**
+   * Delete a conversation
+   */
+  deleteConversation(conversationId: string): Promise<boolean>;
+  /**
+   * Build prompt string for LLM
+   */
+  private buildPrompt;
+}
+/**
+ * Create a chat service with the given configuration
+ */
+declare function createChatService(config: ChatServiceConfig): ChatService;
+//#endregion
+export { ChatService, ChatServiceConfig, createChatService };
+//# sourceMappingURL=chat-service.d.ts.map

package/dist/core/chat-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-service.d.ts","names":[],"sources":["../../src/core/chat-service.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAmBA;AAEY,UAFK,iBAAA,CAEL;EAEA;EAEF,QAAA,EAJE,QAIF;EAAiB;EA8Bd,OAAA,CAAA,EAhCD,gBAgCY;EAWF;EAYA,KAAA,CAAA,EArDZ,iBAqDY;EAA6B;EAAR,YAAA,CAAA,EAAA,MAAA;EA6EnB;EAA6B,kBAAA,CAAA,EAAA,MAAA;EAAR;EAqGhC,OAAA,CAAA,EAAA,CAAA,KAAA,EAAA;IAAR,WAAA,EAAA,MAAA;IAUS,YAAA,EAAA,MAAA;EAAR,CAAA,EAAA,GAAA,IAAA;;;AA2DN;;cA9Qa,WAAA;;;;;;;sBAWS;;;;gBAYA,qBAAqB,QAAQ;;;;kBA6E3B,qBAAqB,QAAQ;;;;2CAqGhD,QAAQ;;;;;;;MAUP,QAAQ;;;;8CAUsC;;;;;;;;;iBAiDpC,iBAAA,SAA0B,oBAAoB"}