@contractspec/lib.contracts 0.0.0-canary-20260113162409

package/dist/knowledge/query/service.js

@@ -0,0 +1,65 @@
+//#region src/knowledge/query/service.ts
+var KnowledgeQueryService = class {
+	embeddings;
+	vectorStore;
+	llm;
+	config;
+	constructor(embeddings, vectorStore, llm, config) {
+		this.embeddings = embeddings;
+		this.vectorStore = vectorStore;
+		this.llm = llm;
+		this.config = config;
+	}
+	async query(question) {
+		const embedding = await this.embeddings.embedQuery(question);
+		const results = await this.vectorStore.search({
+			collection: this.config.collection,
+			vector: embedding.vector,
+			topK: this.config.topK ?? 5,
+			namespace: this.config.namespace,
+			filter: void 0
+		});
+		const context = buildContext(results);
+		const messages = this.buildMessages(question, context);
+		const response = await this.llm.chat(messages);
+		return {
+			answer: response.message.content.map((part) => "text" in part ? part.text : "").join(""),
+			references: results.map((result) => ({
+				...result,
+				text: extractText(result)
+			})),
+			usage: response.usage
+		};
+	}
+	buildMessages(question, context) {
+		return [{
+			role: "system",
+			content: [{
+				type: "text",
+				text: this.config.systemPrompt ?? "You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible."
+			}]
+		}, {
+			role: "user",
+			content: [{
+				type: "text",
+				text: `Question:\n${question}\n\nContext:\n${context}`
+			}]
+		}];
+	}
+};
+function buildContext(results) {
+	if (results.length === 0) return "No relevant documents found.";
+	return results.map((result, index) => {
+		const text = extractText(result);
+		return `Source ${index + 1} (score: ${result.score.toFixed(3)}):\n${text}`;
+	}).join("\n\n");
+}
+function extractText(result) {
+	const payload = result.payload ?? {};
+	if (typeof payload.text === "string") return payload.text;
+	if (typeof payload.content === "string") return payload.content;
+	return JSON.stringify(payload);
+}
+
+//#endregion
+export { KnowledgeQueryService };

package/dist/knowledge/runtime.d.ts

@@ -0,0 +1,32 @@
+import { KnowledgeCategory } from "./spec.js";
+import { ResolvedAppConfig, ResolvedKnowledge } from "../app-config/runtime.js";
+
+//#region src/knowledge/runtime.d.ts
+interface KnowledgeAccessContext {
+  tenantId: string;
+  appId: string;
+  environment?: string;
+  workflowName?: string;
+  agentName?: string;
+  operation: 'read' | 'write' | 'search';
+}
+interface KnowledgeAccessResult {
+  allowed: boolean;
+  reason?: string;
+  severity?: 'error' | 'warning';
+}
+interface KnowledgeAccessGuardOptions {
+  disallowWriteCategories?: KnowledgeCategory[];
+  requireWorkflowBinding?: boolean;
+  requireAgentBinding?: boolean;
+}
+declare class KnowledgeAccessGuard {
+  private readonly disallowedWrite;
+  private readonly requireWorkflowBinding;
+  private readonly requireAgentBinding;
+  constructor(options?: KnowledgeAccessGuardOptions);
+  checkAccess(spaceBinding: ResolvedKnowledge, context: KnowledgeAccessContext, appConfig: ResolvedAppConfig): KnowledgeAccessResult;
+  private isSpaceBound;
+}
+//#endregion
+export { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult };

package/dist/knowledge/runtime.js

@@ -0,0 +1,49 @@
+//#region src/knowledge/runtime.ts
+const DEFAULT_DISALLOWED_WRITE = ["external", "ephemeral"];
+var KnowledgeAccessGuard = class {
+	disallowedWrite;
+	requireWorkflowBinding;
+	requireAgentBinding;
+	constructor(options = {}) {
+		this.disallowedWrite = new Set(options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE);
+		this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;
+		this.requireAgentBinding = options.requireAgentBinding ?? false;
+	}
+	checkAccess(spaceBinding, context, appConfig) {
+		const { binding, space } = spaceBinding;
+		if (binding.required !== false && !this.isSpaceBound(spaceBinding, appConfig)) return {
+			allowed: false,
+			reason: `Knowledge space "${space.meta.key}" is not bound in the resolved app config.`
+		};
+		if (context.operation === "write" && this.disallowedWrite.has(space.meta.category)) return {
+			allowed: false,
+			reason: `Knowledge space "${space.meta.key}" is category "${space.meta.category}" and is read-only.`
+		};
+		if (this.requireWorkflowBinding && context.workflowName) {
+			const allowedWorkflows = binding.scope?.workflows;
+			if (allowedWorkflows && !allowedWorkflows.includes(context.workflowName)) return {
+				allowed: false,
+				reason: `Workflow "${context.workflowName}" is not authorized to access knowledge space "${space.meta.key}".`
+			};
+		}
+		if (this.requireAgentBinding && context.agentName) {
+			const allowedAgents = binding.scope?.agents;
+			if (allowedAgents && !allowedAgents.includes(context.agentName)) return {
+				allowed: false,
+				reason: `Agent "${context.agentName}" is not authorized to access knowledge space "${space.meta.key}".`
+			};
+		}
+		if (space.meta.category === "ephemeral") return {
+			allowed: true,
+			severity: "warning",
+			reason: `Knowledge space "${space.meta.key}" is ephemeral; results may be transient.`
+		};
+		return { allowed: true };
+	}
+	isSpaceBound(resolved, appConfig) {
+		return appConfig.knowledge.some((entry) => entry.space.meta.key === resolved.space.meta.key && (resolved.space.meta.version == null || entry.space.meta.version === resolved.space.meta.version));
+	}
+};
+
+//#endregion
+export { KnowledgeAccessGuard };

package/dist/knowledge/source.d.ts

@@ -0,0 +1,32 @@
+//#region src/knowledge/source.d.ts
+type KnowledgeSourceType = 'notion' | 'url' | 'file_upload' | 'email' | 'api' | 'manual';
+interface KnowledgeSourceMeta {
+  id: string;
+  tenantId: string;
+  spaceKey: string;
+  spaceVersion: string;
+  label: string;
+  sourceType: KnowledgeSourceType;
+  createdAt: string | Date;
+  updatedAt: string | Date;
+}
+interface KnowledgeSourceConfig {
+  meta: KnowledgeSourceMeta;
+  /** Source-specific configuration (URLs, credentials, filters). */
+  config: Record<string, unknown>;
+  /** Sync schedule (cron or interval). */
+  syncSchedule?: {
+    enabled: boolean;
+    cron?: string;
+    intervalMs?: number;
+  };
+  /** Last sync status. */
+  lastSync?: {
+    timestamp: Date;
+    success: boolean;
+    itemsProcessed?: number;
+    error?: string;
+  };
+}
+//#endregion
+export { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType };

package/dist/knowledge/spaces/email-threads.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/email-threads.d.ts
+declare const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerEmailThreadsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };

package/dist/knowledge/spaces/email-threads.js

@@ -0,0 +1,37 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/email-threads.ts
+const emailThreadsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.email-threads",
+		version: "1.0.0",
+		category: "operational",
+		title: "Operational Email Threads",
+		description: "Indexed copies of operational email threads used for support, onboarding, and workflows.",
+		domain: "operations",
+		owners: ["platform.operations"],
+		tags: ["email", "operations"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: 365 },
+	access: {
+		policy: {
+			key: "knowledge.access.email-threads",
+			version: "1.0.0"
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 600,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Operational email threads synchronized from Gmail to support automations and contextual assistance."
+};
+function registerEmailThreadsKnowledgeSpace(registry) {
+	return registry.register(emailThreadsKnowledgeSpace);
+}
+
+//#endregion
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };

package/dist/knowledge/spaces/financial-docs.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/financial-docs.d.ts
+declare const financialDocsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerFinancialDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };

package/dist/knowledge/spaces/financial-docs.js

@@ -0,0 +1,37 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/financial-docs.ts
+const financialDocsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.financial-docs",
+		version: "1.0.0",
+		category: "canonical",
+		title: "Household Financial Documents",
+		description: "Invoices, bills, and contracts powering Pocket Family Office financial automation.",
+		domain: "finance",
+		owners: ["platform.finance"],
+		tags: ["finance", "documents"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			key: "knowledge.access.financial-docs",
+			version: "1.0.0"
+		},
+		trustLevel: "high",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 700,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Normalized financial documents enabling bill pay automation, reminders, and summaries."
+};
+function registerFinancialDocsKnowledgeSpace(registry) {
+	return registry.register(financialDocsKnowledgeSpace);
+}
+
+//#endregion
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };

package/dist/knowledge/spaces/financial-overview.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/financial-overview.d.ts
+declare const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerFinancialOverviewKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };

package/dist/knowledge/spaces/financial-overview.js

@@ -0,0 +1,41 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/financial-overview.ts
+const financialOverviewKnowledgeSpace = {
+	meta: {
+		key: "knowledge.financial-overview",
+		version: "1.0.0",
+		category: "operational",
+		title: "Derived Financial Summaries",
+		description: "Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.",
+		domain: "finance",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"summaries",
+			"cashflow"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	retention: { ttlDays: 180 },
+	access: {
+		policy: {
+			key: "knowledge.access.financial-overview",
+			version: "1.0.0"
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 600,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails."
+};
+function registerFinancialOverviewKnowledgeSpace(registry) {
+	return registry.register(financialOverviewKnowledgeSpace);
+}
+
+//#endregion
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };

package/dist/knowledge/spaces/index.d.ts

@@ -0,0 +1,7 @@
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./financial-overview.js";
+export { emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spaces/index.js

@@ -0,0 +1,8 @@
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./financial-overview.js";
+
+export { emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spaces/product-canon.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/product-canon.d.ts
+declare const productCanonKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerProductCanonKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };

package/dist/knowledge/spaces/product-canon.js

@@ -0,0 +1,37 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/product-canon.ts
+const productCanonKnowledgeSpace = {
+	meta: {
+		key: "knowledge.product-canon",
+		version: "1.0.0",
+		category: "canonical",
+		title: "Product Canon Knowledge Space",
+		description: "Authoritative product knowledge covering strategy, roadmap, and delivery canon.",
+		domain: "product",
+		owners: ["platform.product"],
+		tags: ["knowledge", "product"],
+		stability: StabilityEnum.Stable
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			key: "knowledge.access.product-canon",
+			version: "1.0.0"
+		},
+		trustLevel: "high",
+		automationWritable: false
+	},
+	indexing: {
+		embeddingModel: "text-embedding-3-large",
+		chunkSize: 800,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Single source of truth for product canon, principles, and strategic narratives."
+};
+function registerProductCanonKnowledgeSpace(registry) {
+	return registry.register(productCanonKnowledgeSpace);
+}
+
+//#endregion
+export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };

package/dist/knowledge/spaces/support-faq.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/support-faq.d.ts
+declare const supportFaqKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerSupportFaqKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };

package/dist/knowledge/spaces/support-faq.js

@@ -0,0 +1,40 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/support-faq.ts
+const supportFaqKnowledgeSpace = {
+	meta: {
+		key: "knowledge.support-faq",
+		version: "1.0.0",
+		category: "operational",
+		title: "Support & Success FAQ",
+		description: "Operational knowledge base for customer support and success.",
+		domain: "support",
+		owners: ["platform.support"],
+		tags: ["knowledge", "support"],
+		stability: StabilityEnum.Beta
+	},
+	retention: {
+		ttlDays: 365,
+		archiveAfterDays: 180
+	},
+	access: {
+		policy: {
+			key: "knowledge.access.support",
+			version: "1.0.0"
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "text-embedding-3-small",
+		chunkSize: 700,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Operational FAQs, runbooks, and customer success playbooks augmented with automation updates."
+};
+function registerSupportFaqKnowledgeSpace(registry) {
+	return registry.register(supportFaqKnowledgeSpace);
+}
+
+//#endregion
+export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };

package/dist/knowledge/spaces/uploaded-docs.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/uploaded-docs.d.ts
+declare const uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerUploadedDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spaces/uploaded-docs.js

@@ -0,0 +1,37 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region src/knowledge/spaces/uploaded-docs.ts
+const uploadedDocsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.uploaded-docs",
+		version: "1.0.0",
+		category: "external",
+		title: "Uploaded Knowledge Assets",
+		description: "Documents uploaded by households, including invoices, contracts, and reference files.",
+		domain: "operations",
+		owners: ["platform.operations"],
+		tags: ["documents", "storage"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: null },
+	access: {
+		policy: {
+			key: "knowledge.access.uploaded-docs",
+			version: "1.0.0"
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 900,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "User-provided documents normalized and embedded for retrieval augmented workflows."
+};
+function registerUploadedDocsKnowledgeSpace(registry) {
+	return registry.register(uploadedDocsKnowledgeSpace);
+}
+
+//#endregion
+export { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spec.d.ts

@@ -0,0 +1,46 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { PolicyRef } from "../policy/spec.js";
+import { SpecContractRegistry } from "../registry.js";
+
+//#region src/knowledge/spec.d.ts
+type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
+interface KnowledgeSpaceMeta extends OwnerShipMeta {
+  category: KnowledgeCategory;
+}
+interface KnowledgeRetentionPolicy {
+  /** TTL in days (null = indefinite). */
+  ttlDays?: number | null;
+  /** Auto-archive after inactivity. */
+  archiveAfterDays?: number;
+}
+interface KnowledgeAccessPolicy {
+  /** Which PolicySpec governs access. */
+  policy?: PolicyRef;
+  /** Trust level for agent/workflow consumption. */
+  trustLevel: 'high' | 'medium' | 'low';
+  /** Can this space be mutated by automation? */
+  automationWritable: boolean;
+}
+interface KnowledgeIndexingConfig {
+  embeddingModel?: string;
+  chunkSize?: number;
+  vectorDbIntegration?: string;
+}
+interface KnowledgeSpaceSpec {
+  meta: KnowledgeSpaceMeta;
+  /** Retention and cleanup rules. */
+  retention: KnowledgeRetentionPolicy;
+  /** Access control and trust. */
+  access: KnowledgeAccessPolicy;
+  /** Optional embedding/indexing config. */
+  indexing?: KnowledgeIndexingConfig;
+  /** Documentation. */
+  description?: string;
+}
+declare class KnowledgeSpaceRegistry extends SpecContractRegistry<'knowledge-space', KnowledgeSpaceSpec> {
+  constructor(items?: KnowledgeSpaceSpec[]);
+  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[];
+}
+declare function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta): string;
+//#endregion
+export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };

package/dist/knowledge/spec.js

@@ -0,0 +1,17 @@
+import { SpecContractRegistry } from "../registry.js";
+
+//#region src/knowledge/spec.ts
+var KnowledgeSpaceRegistry = class extends SpecContractRegistry {
+	constructor(items) {
+		super("knowledge-space", items);
+	}
+	getByCategory(category) {
+		return this.list().filter((spec) => spec.meta.category === category);
+	}
+};
+function makeKnowledgeSpaceKey(meta) {
+	return `${meta.key}.v${meta.version}`;
+}
+
+//#endregion
+export { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey };

package/dist/llm/exporters.d.ts

@@ -0,0 +1,70 @@
+import { DocBlock } from "../docs/types.js";
+import { PresentationSpec } from "../presentations/presentations.js";
+import { AnyOperationSpec } from "../operations/operation.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import "../operations/index.js";
+import { FeatureModuleSpec } from "../features/types.js";
+import { PresentationRegistry } from "../presentations/registry.js";
+import "../presentations/index.js";
+import "../features/index.js";
+import { EventSpec } from "../events.js";
+import { FeatureExportOptions, FeatureExportResult, SpecExportOptions, SpecExportResult } from "./types.js";
+import { AnySchemaModel } from "@contractspec/lib.schema";
+
+//#region src/llm/exporters.d.ts
+
+/**
+ * Export a single spec to context-focused markdown.
+ * Includes: goal, context, description, acceptance scenarios.
+ * Best for: Understanding what the spec does, providing context to LLMs.
+ */
+declare function operationSpecToContextMarkdown(spec: AnyOperationSpec): string;
+/**
+ * Export a single spec to full markdown with all details.
+ * Includes: all fields, I/O schemas, policy, events, examples.
+ * Best for: Complete documentation, implementation reference.
+ */
+declare function operationSpecToFullMarkdown(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): string;
+/**
+ * Export a single spec as an actionable agent prompt.
+ * Includes: instructions, full spec, expected output format.
+ * Best for: Directly feeding to coding agents for implementation.
+ */
+declare function operationSpecToAgentPrompt(spec: AnyOperationSpec, options?: {
+  taskType?: 'implement' | 'test' | 'refactor' | 'review';
+  existingCode?: string;
+}): string;
+/**
+ * Export a feature module to markdown.
+ * Includes all related specs, events, and presentations.
+ */
+declare function featureToMarkdown(feature: FeatureModuleSpec, deps?: {
+  specs?: OperationSpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): string;
+/**
+ * Export a presentation descriptor to markdown.
+ */
+declare function presentationToMarkdown(presentation: PresentationSpec): string;
+/**
+ * Export an event spec to markdown.
+ */
+declare function eventToMarkdown(event: EventSpec<AnySchemaModel>): string;
+/**
+ * Export a DocBlock to markdown (already markdown, but formatted consistently).
+ */
+declare function docBlockToMarkdown(doc: DocBlock): string;
+/**
+ * Export a spec with a specific format.
+ * Convenience function that wraps the format-specific functions.
+ */
+declare function exportSpec(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): SpecExportResult;
+/**
+ * Export a feature with a specific format.
+ */
+declare function exportFeature(feature: FeatureModuleSpec, deps?: {
+  specs?: OperationSpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): FeatureExportResult;
+//#endregion
+export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, presentationToMarkdown };