@contractspec/module.ai-chat 1.44.0

package/dist/ai-chat.operations.js

@@ -0,0 +1,174 @@
+import { ScalarTypeEnum } from "./libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "./libs/schema/dist/SchemaModel.js";
+import "./libs/schema/dist/index.js";
+import { ChatConversationModel, ListConversationsOutputModel, SendMessageInputModel, SendMessageOutputModel } from "./schema.js";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+
+//#region src/ai-chat.operations.ts
+const SendMessageContract = defineCommand({
+	meta: {
+		key: "ai-chat.send",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "Send a message to the AI chat.",
+		tags: ["chat", "send"],
+		goal: "Send message",
+		context: "Chat UI"
+	},
+	io: {
+		input: SendMessageInputModel,
+		output: SendMessageOutputModel
+	},
+	policy: { auth: "user" }
+});
+const StreamMessageOutputModel = defineSchemaModel({
+	name: "StreamMessageOutput",
+	fields: { stream: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const StreamMessageContract = defineCommand({
+	meta: {
+		key: "ai-chat.stream",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "Stream a message response from the AI chat.",
+		tags: ["chat", "stream"],
+		goal: "Stream response",
+		context: "Chat UI"
+	},
+	io: {
+		input: SendMessageInputModel,
+		output: StreamMessageOutputModel
+	},
+	policy: { auth: "user" }
+});
+const ListConversationsContract = defineQuery({
+	meta: {
+		key: "ai-chat.conversations.list",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "List user conversations.",
+		tags: ["chat", "list"],
+		goal: "List conversations",
+		context: "Chat History"
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "VoidInput",
+			fields: {}
+		}),
+		output: ListConversationsOutputModel
+	},
+	policy: { auth: "user" }
+});
+const GetConversationContract = defineQuery({
+	meta: {
+		key: "ai-chat.conversations.get",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "Get a specific conversation.",
+		tags: ["chat", "get"],
+		goal: "Get conversation",
+		context: "Chat UI"
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "GetConversationInput",
+			fields: { id: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			} }
+		}),
+		output: ChatConversationModel
+	},
+	policy: { auth: "user" }
+});
+const DeleteConversationContract = defineCommand({
+	meta: {
+		key: "ai-chat.conversations.delete",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "Delete a conversation.",
+		tags: ["chat", "delete"],
+		goal: "Delete conversation",
+		context: "Chat History"
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "DeleteConversationInput",
+			fields: { id: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			} }
+		}),
+		output: defineSchemaModel({
+			name: "VoidOutput",
+			fields: {}
+		})
+	},
+	policy: { auth: "user" }
+});
+const ListProvidersContract = defineQuery({
+	meta: {
+		key: "ai-chat.providers.list",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "List available AI providers.",
+		tags: ["chat", "providers"],
+		goal: "List providers",
+		context: "Settings"
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "VoidInput2",
+			fields: {}
+		}),
+		output: defineSchemaModel({
+			name: "ProviderList",
+			fields: { providers: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isArray: true,
+				isOptional: false
+			} }
+		})
+	},
+	policy: { auth: "user" }
+});
+const ScanContextContract = defineCommand({
+	meta: {
+		key: "ai-chat.context.scan",
+		version: 1,
+		owners: ["@ai-team"],
+		stability: "experimental",
+		description: "Scan workspace context.",
+		tags: ["chat", "context"],
+		goal: "Scan context",
+		context: "Background"
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "ScanContextInput",
+			fields: { path: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			} }
+		}),
+		output: defineSchemaModel({
+			name: "VoidOutput2",
+			fields: {}
+		})
+	},
+	policy: { auth: "user" }
+});
+
+//#endregion
+export { DeleteConversationContract, GetConversationContract, ListConversationsContract, ListProvidersContract, ScanContextContract, SendMessageContract, StreamMessageContract };
+//# sourceMappingURL=ai-chat.operations.js.map

package/dist/ai-chat.operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat.operations.js","names":[],"sources":["../src/ai-chat.operations.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport {\n  ChatConversationModel,\n  ListConversationsOutputModel,\n  SendMessageInputModel,\n  SendMessageOutputModel,\n} from './schema';\n\nexport const SendMessageContract = defineCommand({\n  meta: {\n    key: 'ai-chat.send',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'Send a message to the AI chat.',\n    tags: ['chat', 'send'],\n    goal: 'Send message',\n    context: 'Chat UI',\n  },\n  io: { input: SendMessageInputModel, output: SendMessageOutputModel },\n  policy: { auth: 'user' },\n});\n\nconst StreamMessageOutputModel = defineSchemaModel({\n  name: 'StreamMessageOutput',\n  fields: {\n    stream: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }, // Placeholder for stream content\n  },\n});\n\nexport const StreamMessageContract = defineCommand({\n  meta: {\n    key: 'ai-chat.stream',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'Stream a message response from the AI chat.',\n    tags: ['chat', 'stream'],\n    goal: 'Stream response',\n    context: 'Chat UI',\n  },\n  io: { input: SendMessageInputModel, output: StreamMessageOutputModel },\n  policy: { auth: 'user' },\n});\n\nexport const ListConversationsContract = defineQuery({\n  meta: {\n    key: 'ai-chat.conversations.list',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'List user conversations.',\n    tags: ['chat', 'list'],\n    goal: 'List conversations',\n    context: 'Chat History',\n  },\n  io: {\n    input: defineSchemaModel({ name: 'VoidInput', fields: {} }),\n    output: ListConversationsOutputModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const GetConversationContract = defineQuery({\n  meta: {\n    key: 'ai-chat.conversations.get',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'Get a specific conversation.',\n    tags: ['chat', 'get'],\n    goal: 'Get conversation',\n    context: 'Chat UI',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'GetConversationInput',\n      fields: {\n        id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      },\n    }),\n    output: ChatConversationModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const DeleteConversationContract = defineCommand({\n  meta: {\n    key: 'ai-chat.conversations.delete',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'Delete a conversation.',\n    tags: ['chat', 'delete'],\n    goal: 'Delete conversation',\n    context: 'Chat History',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'DeleteConversationInput',\n      fields: {\n        id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      },\n    }),\n    output: defineSchemaModel({ name: 'VoidOutput', fields: {} }),\n  },\n  policy: { auth: 'user' },\n});\n\nexport const ListProvidersContract = defineQuery({\n  meta: {\n    key: 'ai-chat.providers.list',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'List available AI providers.',\n    tags: ['chat', 'providers'],\n    goal: 'List providers',\n    context: 'Settings',\n  },\n  io: {\n    input: defineSchemaModel({ name: 'VoidInput2', fields: {} }),\n    output: defineSchemaModel({\n      name: 'ProviderList',\n      fields: {\n        providers: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isArray: true,\n          isOptional: false,\n        },\n      },\n    }),\n  },\n  policy: { auth: 'user' },\n});\n\nexport const ScanContextContract = defineCommand({\n  meta: {\n    key: 'ai-chat.context.scan',\n    version: 1,\n    owners: ['@ai-team'],\n    stability: 'experimental',\n    description: 'Scan workspace context.',\n    tags: ['chat', 'context'],\n    goal: 'Scan context',\n    context: 'Background',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'ScanContextInput',\n      fields: {\n        path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      },\n    }),\n    output: defineSchemaModel({ name: 'VoidOutput2', fields: {} }),\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,57 @@
+import { WorkspaceContext } from "./workspace-context.js";
+
+//#region src/context/context-builder.d.ts
+
+/**
+ * Context entry for a file or spec
+ */
+interface ContextEntry {
+  type: 'spec' | 'file' | 'reference';
+  path: string;
+  content?: string;
+  summary?: string;
+  relevance: number;
+}
+/**
+ * Built context for LLM
+ */
+interface BuiltContext {
+  entries: ContextEntry[];
+  summary: string;
+  totalTokensEstimate: number;
+}
+/**
+ * Options for building context
+ */
+interface ContextBuilderOptions {
+  /** Maximum estimated tokens for context */
+  maxTokens?: number;
+  /** Query to use for relevance scoring */
+  query?: string;
+  /** Specific files to include */
+  includeFiles?: string[];
+  /** Specific specs to include */
+  includeSpecs?: string[];
+}
+/**
+ * Context builder for creating rich LLM context
+ */
+declare class ContextBuilder {
+  private readonly context;
+  constructor(context: WorkspaceContext);
+  /**
+   * Build context for a chat message
+   */
+  build(options?: ContextBuilderOptions): BuiltContext;
+  /**
+   * Build a text summary of the context entries
+   */
+  private buildSummary;
+}
+/**
+ * Create a context builder
+ */
+declare function createContextBuilder(context: WorkspaceContext): ContextBuilder;
+//#endregion
+export { BuiltContext, ContextBuilder, ContextBuilderOptions, ContextEntry, createContextBuilder };
+//# sourceMappingURL=context-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","names":[],"sources":["../../src/context/context-builder.ts"],"sourcesContent":[],"mappings":";;;;AA0GA;;;AAU8C,UA1G7B,YAAA,CA0G6B;EAAY,IAAA,EAAA,MAAA,GAAA,MAAA,GAAA,WAAA;EAwI1C,IAAA,EAAA,MAAA;;;;;;;;UAvOC,YAAA;WACN;;;;;;;UAQM,qBAAA;;;;;;;;;;;;;cA4EJ,cAAA;;uBAGU;;;;kBAON,wBAA6B;;;;;;;;;iBAwI9B,oBAAA,UACL,mBACR"}

package/dist/context/context-builder.js

@@ -0,0 +1,148 @@
+//#region src/context/context-builder.ts
+/**
+* Estimates token count from string (rough approximation)
+*/
+function estimateTokens(text) {
+	return Math.ceil(text.length / 4);
+}
+/**
+* Calculate relevance score for a spec
+*/
+function scoreSpec(spec, query) {
+	if (!query) return .5;
+	const lowerQuery = query.toLowerCase();
+	let score = 0;
+	if (spec.name.toLowerCase().includes(lowerQuery)) score += .4;
+	if (spec.description?.toLowerCase().includes(lowerQuery)) score += .3;
+	if (spec.tags?.some((t) => t.toLowerCase().includes(lowerQuery))) score += .2;
+	return Math.min(score, 1);
+}
+/**
+* Calculate relevance score for a file
+*/
+function scoreFile(file, query) {
+	if (!query) return .5;
+	const lowerQuery = query.toLowerCase();
+	let score = 0;
+	if (file.path.toLowerCase().includes(lowerQuery)) score += .5;
+	if (file.name.toLowerCase().includes(lowerQuery)) score += .3;
+	if (file.isSpec) score += .2;
+	return Math.min(score, 1);
+}
+/**
+* Context builder for creating rich LLM context
+*/
+var ContextBuilder = class {
+	context;
+	constructor(context) {
+		this.context = context;
+	}
+	/**
+	* Build context for a chat message
+	*/
+	build(options = {}) {
+		const maxTokens = options.maxTokens ?? 4e3;
+		const entries = [];
+		let totalTokens = 0;
+		if (options.includeSpecs?.length) for (const specName of options.includeSpecs) {
+			const spec = this.context.getSpecs().find((s) => s.name === specName);
+			if (spec) {
+				const entry = {
+					type: "spec",
+					path: spec.path,
+					summary: `${spec.type}: ${spec.name}${spec.description ? ` - ${spec.description}` : ""}`,
+					relevance: 1
+				};
+				entries.push(entry);
+				totalTokens += estimateTokens(entry.summary ?? "");
+			}
+		}
+		if (options.includeFiles?.length) for (const filePath of options.includeFiles) {
+			const file = this.context.getFiles().find((f) => f.path === filePath);
+			if (file) {
+				const entry = {
+					type: "file",
+					path: file.path,
+					summary: `File: ${file.relativePath}`,
+					relevance: 1
+				};
+				entries.push(entry);
+				totalTokens += estimateTokens(entry.summary ?? "");
+			}
+		}
+		if (options.query) {
+			const scoredSpecs = this.context.getSpecs().map((spec) => ({
+				spec,
+				score: scoreSpec(spec, options.query)
+			})).filter(({ score }) => score > .2).sort((a, b) => b.score - a.score);
+			for (const { spec, score } of scoredSpecs) {
+				if (totalTokens >= maxTokens) break;
+				if (entries.some((e) => e.path === spec.path)) continue;
+				const entry = {
+					type: "spec",
+					path: spec.path,
+					summary: `${spec.type}: ${spec.name}${spec.description ? ` - ${spec.description}` : ""}`,
+					relevance: score
+				};
+				entries.push(entry);
+				totalTokens += estimateTokens(entry.summary ?? "");
+			}
+		}
+		if (options.query) {
+			const scoredFiles = this.context.getFiles().map((file) => ({
+				file,
+				score: scoreFile(file, options.query)
+			})).filter(({ score }) => score > .2).sort((a, b) => b.score - a.score);
+			for (const { file, score } of scoredFiles) {
+				if (totalTokens >= maxTokens) break;
+				if (entries.some((e) => e.path === file.path)) continue;
+				const entry = {
+					type: "file",
+					path: file.path,
+					summary: `File: ${file.relativePath}`,
+					relevance: score
+				};
+				entries.push(entry);
+				totalTokens += estimateTokens(entry.summary ?? "");
+			}
+		}
+		const summary = this.buildSummary(entries);
+		return {
+			entries,
+			summary,
+			totalTokensEstimate: totalTokens + estimateTokens(summary)
+		};
+	}
+	/**
+	* Build a text summary of the context entries
+	*/
+	buildSummary(entries) {
+		if (entries.length === 0) return this.context.getContextSummary();
+		const parts = [];
+		const workspaceSummary = this.context.getSummary();
+		parts.push(`Workspace: ${workspaceSummary.name}`);
+		parts.push("");
+		const specs = entries.filter((e) => e.type === "spec");
+		if (specs.length > 0) {
+			parts.push("### Relevant Specs");
+			for (const entry of specs) parts.push(`- ${entry.summary}`);
+			parts.push("");
+		}
+		const files = entries.filter((e) => e.type === "file");
+		if (files.length > 0) {
+			parts.push("### Relevant Files");
+			for (const entry of files) parts.push(`- ${entry.summary}`);
+		}
+		return parts.join("\n");
+	}
+};
+/**
+* Create a context builder
+*/
+function createContextBuilder(context) {
+	return new ContextBuilder(context);
+}
+
+//#endregion
+export { ContextBuilder, createContextBuilder };
+//# sourceMappingURL=context-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","names":["entries: ContextEntry[]","entry: ContextEntry","parts: string[]"],"sources":["../../src/context/context-builder.ts"],"sourcesContent":["/**\n * Context builder for LLM prompts\n *\n * Builds rich context from workspace information for AI assistance.\n */\nimport type { WorkspaceContext, SpecInfo, FileInfo } from './workspace-context';\n\n/**\n * Context entry for a file or spec\n */\nexport interface ContextEntry {\n  type: 'spec' | 'file' | 'reference';\n  path: string;\n  content?: string;\n  summary?: string;\n  relevance: number; // 0-1 score\n}\n\n/**\n * Built context for LLM\n */\nexport interface BuiltContext {\n  entries: ContextEntry[];\n  summary: string;\n  totalTokensEstimate: number;\n}\n\n/**\n * Options for building context\n */\nexport interface ContextBuilderOptions {\n  /** Maximum estimated tokens for context */\n  maxTokens?: number;\n  /** Query to use for relevance scoring */\n  query?: string;\n  /** Specific files to include */\n  includeFiles?: string[];\n  /** Specific specs to include */\n  includeSpecs?: string[];\n}\n\n/**\n * Estimates token count from string (rough approximation)\n */\nfunction estimateTokens(text: string): number {\n  // Rough estimate: ~4 characters per token\n  return Math.ceil(text.length / 4);\n}\n\n/**\n * Calculate relevance score for a spec\n */\nfunction scoreSpec(spec: SpecInfo, query?: string): number {\n  if (!query) return 0.5;\n\n  const lowerQuery = query.toLowerCase();\n  let score = 0;\n\n  // Name match\n  if (spec.name.toLowerCase().includes(lowerQuery)) {\n    score += 0.4;\n  }\n\n  // Description match\n  if (spec.description?.toLowerCase().includes(lowerQuery)) {\n    score += 0.3;\n  }\n\n  // Tag match\n  if (spec.tags?.some((t) => t.toLowerCase().includes(lowerQuery))) {\n    score += 0.2;\n  }\n\n  return Math.min(score, 1);\n}\n\n/**\n * Calculate relevance score for a file\n */\nfunction scoreFile(file: FileInfo, query?: string): number {\n  if (!query) return 0.5;\n\n  const lowerQuery = query.toLowerCase();\n  let score = 0;\n\n  // Path match\n  if (file.path.toLowerCase().includes(lowerQuery)) {\n    score += 0.5;\n  }\n\n  // Name match\n  if (file.name.toLowerCase().includes(lowerQuery)) {\n    score += 0.3;\n  }\n\n  // Spec file bonus\n  if (file.isSpec) {\n    score += 0.2;\n  }\n\n  return Math.min(score, 1);\n}\n\n/**\n * Context builder for creating rich LLM context\n */\nexport class ContextBuilder {\n  private readonly context: WorkspaceContext;\n\n  constructor(context: WorkspaceContext) {\n    this.context = context;\n  }\n\n  /**\n   * Build context for a chat message\n   */\n  build(options: ContextBuilderOptions = {}): BuiltContext {\n    const maxTokens = options.maxTokens ?? 4000;\n    const entries: ContextEntry[] = [];\n    let totalTokens = 0;\n\n    // Add explicitly included specs\n    if (options.includeSpecs?.length) {\n      for (const specName of options.includeSpecs) {\n        const spec = this.context.getSpecs().find((s) => s.name === specName);\n        if (spec) {\n          const entry: ContextEntry = {\n            type: 'spec',\n            path: spec.path,\n            summary: `${spec.type}: ${spec.name}${spec.description ? ` - ${spec.description}` : ''}`,\n            relevance: 1,\n          };\n          entries.push(entry);\n          totalTokens += estimateTokens(entry.summary ?? '');\n        }\n      }\n    }\n\n    // Add explicitly included files\n    if (options.includeFiles?.length) {\n      for (const filePath of options.includeFiles) {\n        const file = this.context.getFiles().find((f) => f.path === filePath);\n        if (file) {\n          const entry: ContextEntry = {\n            type: 'file',\n            path: file.path,\n            summary: `File: ${file.relativePath}`,\n            relevance: 1,\n          };\n          entries.push(entry);\n          totalTokens += estimateTokens(entry.summary ?? '');\n        }\n      }\n    }\n\n    // Add relevant specs based on query\n    if (options.query) {\n      const scoredSpecs = this.context\n        .getSpecs()\n        .map((spec) => ({ spec, score: scoreSpec(spec, options.query) }))\n        .filter(({ score }) => score > 0.2)\n        .sort((a, b) => b.score - a.score);\n\n      for (const { spec, score } of scoredSpecs) {\n        if (totalTokens >= maxTokens) break;\n        if (entries.some((e) => e.path === spec.path)) continue;\n\n        const entry: ContextEntry = {\n          type: 'spec',\n          path: spec.path,\n          summary: `${spec.type}: ${spec.name}${spec.description ? ` - ${spec.description}` : ''}`,\n          relevance: score,\n        };\n        entries.push(entry);\n        totalTokens += estimateTokens(entry.summary ?? '');\n      }\n    }\n\n    // Add relevant files based on query\n    if (options.query) {\n      const scoredFiles = this.context\n        .getFiles()\n        .map((file) => ({ file, score: scoreFile(file, options.query) }))\n        .filter(({ score }) => score > 0.2)\n        .sort((a, b) => b.score - a.score);\n\n      for (const { file, score } of scoredFiles) {\n        if (totalTokens >= maxTokens) break;\n        if (entries.some((e) => e.path === file.path)) continue;\n\n        const entry: ContextEntry = {\n          type: 'file',\n          path: file.path,\n          summary: `File: ${file.relativePath}`,\n          relevance: score,\n        };\n        entries.push(entry);\n        totalTokens += estimateTokens(entry.summary ?? '');\n      }\n    }\n\n    // Build summary\n    const summary = this.buildSummary(entries);\n\n    return {\n      entries,\n      summary,\n      totalTokensEstimate: totalTokens + estimateTokens(summary),\n    };\n  }\n\n  /**\n   * Build a text summary of the context entries\n   */\n  private buildSummary(entries: ContextEntry[]): string {\n    if (entries.length === 0) {\n      return this.context.getContextSummary();\n    }\n\n    const parts: string[] = [];\n\n    // Workspace info\n    const workspaceSummary = this.context.getSummary();\n    parts.push(`Workspace: ${workspaceSummary.name}`);\n    parts.push('');\n\n    // Relevant specs\n    const specs = entries.filter((e) => e.type === 'spec');\n    if (specs.length > 0) {\n      parts.push('### Relevant Specs');\n      for (const entry of specs) {\n        parts.push(`- ${entry.summary}`);\n      }\n      parts.push('');\n    }\n\n    // Relevant files\n    const files = entries.filter((e) => e.type === 'file');\n    if (files.length > 0) {\n      parts.push('### Relevant Files');\n      for (const entry of files) {\n        parts.push(`- ${entry.summary}`);\n      }\n    }\n\n    return parts.join('\\n');\n  }\n}\n\n/**\n * Create a context builder\n */\nexport function createContextBuilder(\n  context: WorkspaceContext\n): ContextBuilder {\n  return new ContextBuilder(context);\n}\n"],"mappings":"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"}

package/dist/context/file-operations.d.ts

@@ -0,0 +1,100 @@
+//#region src/context/file-operations.d.ts
+/**
+ * File operations for workspace context
+ *
+ * Provides read/write operations for files in the workspace.
+ */
+/**
+ * Result of a file read operation
+ */
+interface FileReadResult {
+  success: boolean;
+  path: string;
+  content?: string;
+  error?: string;
+}
+/**
+ * Result of a file write operation
+ */
+interface FileWriteResult {
+  success: boolean;
+  path: string;
+  error?: string;
+}
+/**
+ * File operation to perform
+ */
+interface FileOperation {
+  type: 'read' | 'write' | 'create' | 'delete';
+  path: string;
+  content?: string;
+}
+/**
+ * Result of a file operation
+ */
+interface FileOperationResult {
+  operation: FileOperation;
+  success: boolean;
+  content?: string;
+  error?: string;
+}
+/**
+ * Interface for file system operations
+ */
+interface FileSystem {
+  /**
+   * Read a file's contents
+   */
+  readFile(path: string): Promise<string>;
+  /**
+   * Write content to a file
+   */
+  writeFile(path: string, content: string): Promise<void>;
+  /**
+   * Check if a file exists
+   */
+  exists(path: string): Promise<boolean>;
+  /**
+   * Delete a file
+   */
+  deleteFile(path: string): Promise<void>;
+  /**
+   * List files in a directory
+   */
+  listFiles(directory: string, options?: {
+    recursive?: boolean;
+    pattern?: string;
+  }): Promise<string[]>;
+}
+/**
+ * File operations executor
+ */
+declare class FileOperations {
+  private readonly fs;
+  private readonly workspacePath;
+  private readonly allowWrites;
+  constructor(fs: FileSystem, workspacePath: string, allowWrites?: boolean);
+  /**
+   * Read a file
+   */
+  read(relativePath: string): Promise<FileReadResult>;
+  /**
+   * Write to a file
+   */
+  write(relativePath: string, content: string): Promise<FileWriteResult>;
+  /**
+   * Execute multiple file operations
+   */
+  execute(operations: FileOperation[]): Promise<FileOperationResult[]>;
+  /**
+   * Resolve a relative path to an absolute path
+   */
+  private resolvePath;
+}
+/**
+ * Create a file operations instance with Node.js fs
+ */
+declare function createNodeFileOperations(workspacePath: string, allowWrites?: boolean): FileOperations;
+//#endregion
+export { FileOperation, FileOperationResult, FileOperations, FileReadResult, FileSystem, FileWriteResult, createNodeFileOperations };
+//# sourceMappingURL=file-operations.d.ts.map

package/dist/context/file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.d.ts","names":[],"sources":["../../src/context/file-operations.ts"],"sourcesContent":[],"mappings":";;AASA;AAUA;AASA;AASA;AAUA;;;AAcwB,UApDP,cAAA,CAoDO;EAKI,OAAA,EAAA,OAAA;EAQvB,IAAA,EAAA,MAAA;EAAO,OAAA,CAAA,EAAA,MAAA;EAMC,KAAA,CAAA,EAAA,MAAA;;;;;AA4ByC,UAzFrC,eAAA,CAyFqC;EA0B1B,OAAA,EAAA,OAAA;EAA0B,IAAA,EAAA,MAAA;EAAR,KAAA,CAAA,EAAA,MAAA;;AAyF9C;;;UAnMiB,aAAA;;;;;;;;UASA,mBAAA;aACJ;;;;;;;;UASI,UAAA;;;;0BAIS;;;;4CAKkB;;;;wBAKpB;;;;4BAKI;;;;;;;MAQvB;;;;;cAMQ,cAAA;;;;kBAEY;;;;8BAQW,QAAQ;;;;gDAkBU,QAAQ;;;;sBA0BlC,kBAAkB,QAAQ;;;;;;;;;iBAyFtC,wBAAA,gDAGb"}