@lssm/lib.contracts 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060804

package/dist/knowledge/ingestion/document-processor.d.ts

@@ -0,0 +1,24 @@
+//#region src/knowledge/ingestion/document-processor.d.ts
+interface RawDocument {
+  id: string;
+  mimeType: string;
+  data: Uint8Array;
+  metadata?: Record<string, string>;
+}
+interface DocumentFragment {
+  id: string;
+  documentId: string;
+  text: string;
+  metadata?: Record<string, string>;
+}
+type Extractor = (input: RawDocument) => Promise<DocumentFragment[]>;
+declare class DocumentProcessor {
+  private readonly extractors;
+  constructor();
+  registerExtractor(mimeType: string, extractor: Extractor): void;
+  process(document: RawDocument): Promise<DocumentFragment[]>;
+  private extractText;
+  private extractJson;
+}
+//#endregion
+export { DocumentFragment, DocumentProcessor, RawDocument };

package/dist/knowledge/ingestion/embedding-service.d.ts

@@ -0,0 +1,12 @@
+import { EmbeddingProvider, EmbeddingResult } from "../../integrations/providers/embedding.js";
+import { DocumentFragment } from "./document-processor.js";
+
+//#region src/knowledge/ingestion/embedding-service.d.ts
+declare class EmbeddingService {
+  private readonly provider;
+  private readonly batchSize;
+  constructor(provider: EmbeddingProvider, batchSize?: number);
+  embedFragments(fragments: DocumentFragment[]): Promise<EmbeddingResult[]>;
+}
+//#endregion
+export { EmbeddingService };

package/dist/knowledge/ingestion/gmail-adapter.d.ts

@@ -0,0 +1,18 @@
+import { EmailInboundProvider, EmailThread } from "../../integrations/providers/email.js";
+import { DocumentProcessor } from "./document-processor.js";
+import { EmbeddingService } from "./embedding-service.js";
+import { VectorIndexer } from "./vector-indexer.js";
+
+//#region src/knowledge/ingestion/gmail-adapter.d.ts
+declare class GmailIngestionAdapter {
+  private readonly gmail;
+  private readonly processor;
+  private readonly embeddings;
+  private readonly indexer;
+  constructor(gmail: EmailInboundProvider, processor: DocumentProcessor, embeddings: EmbeddingService, indexer: VectorIndexer);
+  syncThreads(query?: Parameters<EmailInboundProvider['listThreads']>[0]): Promise<void>;
+  ingestThread(thread: EmailThread): Promise<void>;
+  private toRawDocument;
+}
+//#endregion
+export { GmailIngestionAdapter };

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

@@ -0,0 +1,6 @@
+import { DocumentFragment, DocumentProcessor, RawDocument } from "./document-processor.js";
+import { EmbeddingService } from "./embedding-service.js";
+import { VectorIndexConfig, VectorIndexer } from "./vector-indexer.js";
+import { GmailIngestionAdapter } from "./gmail-adapter.js";
+import { StorageIngestionAdapter } from "./storage-adapter.js";
+export { DocumentFragment, DocumentProcessor, EmbeddingService, GmailIngestionAdapter, RawDocument, StorageIngestionAdapter, VectorIndexConfig, VectorIndexer };

package/dist/knowledge/ingestion/storage-adapter.d.ts

@@ -0,0 +1,15 @@
+import { GetObjectResult } from "../../integrations/providers/storage.js";
+import { DocumentProcessor } from "./document-processor.js";
+import { EmbeddingService } from "./embedding-service.js";
+import { VectorIndexer } from "./vector-indexer.js";
+
+//#region src/knowledge/ingestion/storage-adapter.d.ts
+declare class StorageIngestionAdapter {
+  private readonly processor;
+  private readonly embeddings;
+  private readonly indexer;
+  constructor(processor: DocumentProcessor, embeddings: EmbeddingService, indexer: VectorIndexer);
+  ingestObject(object: GetObjectResult): Promise<void>;
+}
+//#endregion
+export { StorageIngestionAdapter };

package/dist/knowledge/ingestion/vector-indexer.d.ts

@@ -0,0 +1,18 @@
+import { EmbeddingResult } from "../../integrations/providers/embedding.js";
+import { VectorStoreProvider } from "../../integrations/providers/vector-store.js";
+import { DocumentFragment } from "./document-processor.js";
+
+//#region src/knowledge/ingestion/vector-indexer.d.ts
+interface VectorIndexConfig {
+  collection: string;
+  namespace?: string;
+  metadata?: Record<string, string>;
+}
+declare class VectorIndexer {
+  private readonly provider;
+  private readonly config;
+  constructor(provider: VectorStoreProvider, config: VectorIndexConfig);
+  upsert(fragments: DocumentFragment[], embeddings: EmbeddingResult[]): Promise<void>;
+}
+//#endregion
+export { VectorIndexConfig, VectorIndexer };

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

@@ -0,0 +1,2 @@
+import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "./service.js";
+export { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService };

package/dist/knowledge/query/service.d.ts

@@ -0,0 +1,29 @@
+import { LLMProvider, LLMResponse } from "../../integrations/providers/llm.js";
+import { EmbeddingProvider } from "../../integrations/providers/embedding.js";
+import { VectorSearchResult, VectorStoreProvider } from "../../integrations/providers/vector-store.js";
+
+//#region src/knowledge/query/service.d.ts
+interface KnowledgeQueryConfig {
+  collection: string;
+  namespace?: string;
+  topK?: number;
+  systemPrompt?: string;
+}
+interface KnowledgeAnswer {
+  answer: string;
+  references: (VectorSearchResult & {
+    text?: string;
+  })[];
+  usage?: LLMResponse['usage'];
+}
+declare class KnowledgeQueryService {
+  private readonly embeddings;
+  private readonly vectorStore;
+  private readonly llm;
+  private readonly config;
+  constructor(embeddings: EmbeddingProvider, vectorStore: VectorStoreProvider, llm: LLMProvider, config: KnowledgeQueryConfig);
+  query(question: string): Promise<KnowledgeAnswer>;
+  private buildMessages;
+}
+//#endregion
+export { KnowledgeAnswer, KnowledgeQueryConfig, 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/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: number;
+  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/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-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/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/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/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/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/spec.d.ts

@@ -0,0 +1,52 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { PolicyRef } from "../policy/spec.js";
+
+//#region src/knowledge/spec.d.ts
+type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
+interface KnowledgeSpaceMeta extends OwnerShipMeta {
+  /** Stable space identifier (e.g., "product-canon", "support-faq"). */
+  key: string;
+  version: number;
+  category: KnowledgeCategory;
+  displayName: string;
+}
+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 {
+  private readonly items;
+  register(spec: KnowledgeSpaceSpec): this;
+  list(): KnowledgeSpaceSpec[];
+  get(key: string, version?: number): KnowledgeSpaceSpec | undefined;
+  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[];
+}
+declare function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta): string;
+//#endregion
+export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };

package/dist/llm/exporters.d.ts

@@ -0,0 +1,67 @@
+import { PresentationDescriptorV2 } from "../presentations.v2.js";
+import { PresentationRegistry } from "../presentations.js";
+import { DocBlock } from "../docs/types.js";
+import { EventSpec } from "../events.js";
+import { AnyContractSpec } from "../spec.js";
+import { SpecRegistry } from "../registry.js";
+import { FeatureModuleSpec } from "../features.js";
+import { FeatureExportOptions, FeatureExportResult, SpecExportOptions, SpecExportResult } from "./types.js";
+import { AnySchemaModel } from "@lssm/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 specToContextMarkdown(spec: AnyContractSpec): 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 specToFullMarkdown(spec: AnyContractSpec, 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 specToAgentPrompt(spec: AnyContractSpec, 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?: SpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): string;
+/**
+ * Export a presentation descriptor to markdown.
+ */
+declare function presentationToMarkdown(presentation: PresentationDescriptorV2): 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: AnyContractSpec, options?: Partial<SpecExportOptions>): SpecExportResult;
+/**
+ * Export a feature with a specific format.
+ */
+declare function exportFeature(feature: FeatureModuleSpec, deps?: {
+  specs?: SpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): FeatureExportResult;
+//#endregion
+export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };

package/dist/llm/index.d.ts

@@ -0,0 +1,4 @@
+import { AgentPrompt, AgentType, BatchExportOptions, ExportableItem, FeatureExportOptions, FeatureExportResult, FeatureLookup, ImplementationPlan, LLMExportFormat, SpecExportOptions, SpecExportResult, SpecLookup, VerificationIssue, VerificationReport, VerificationTier } from "./types.js";
+import { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown } from "./exporters.js";
+import { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt } from "./prompts.js";
+export { AGENT_SYSTEM_PROMPTS, type AgentPrompt, type AgentType, type BatchExportOptions, type ExportableItem, type FeatureExportOptions, type FeatureExportResult, type FeatureLookup, type ImplementationPlan, type LLMExportFormat, type SpecExportOptions, type SpecExportResult, type SpecLookup, type VerificationIssue, type VerificationReport, type VerificationTier, docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, presentationToMarkdown, specToAgentPrompt, specToContextMarkdown, specToFullMarkdown };

package/dist/llm/prompts.d.ts

@@ -0,0 +1,51 @@
+import { AnyContractSpec } from "../spec.js";
+import { AgentPrompt, AgentType, ImplementationPlan } from "./types.js";
+
+//#region src/llm/prompts.d.ts
+
+/**
+ * System prompts for different agent types.
+ */
+declare const AGENT_SYSTEM_PROMPTS: Record<AgentType, string>;
+/**
+ * Generate an implementation prompt for a specific agent type.
+ */
+declare function generateImplementationPrompt(spec: AnyContractSpec, agent: AgentType, options?: {
+  existingCode?: string;
+  targetPath?: string;
+}): AgentPrompt;
+/**
+ * Generate a test generation prompt.
+ */
+declare function generateTestPrompt(spec: AnyContractSpec, agent: AgentType, options?: {
+  implementationCode?: string;
+  testFramework?: 'vitest' | 'jest' | 'bun';
+}): AgentPrompt;
+/**
+ * Generate a code review prompt.
+ */
+declare function generateReviewPrompt(spec: AnyContractSpec, agent: AgentType, implementationCode: string): AgentPrompt;
+/**
+ * Generate a verification prompt for AI-powered semantic review.
+ */
+declare function generateVerificationPrompt(spec: AnyContractSpec, implementationCode: string): AgentPrompt;
+/**
+ * Generate a feature implementation plan.
+ */
+declare function generateImplementationPlan(spec: AnyContractSpec, options?: {
+  projectRoot?: string;
+  existingFiles?: string[];
+}): ImplementationPlan;
+/**
+ * Format an implementation plan for a specific agent.
+ */
+declare function formatPlanForAgent(plan: ImplementationPlan, agent: AgentType): AgentPrompt;
+/**
+ * Generate a fix violations prompt after verification.
+ */
+declare function generateFixViolationsPrompt(spec: AnyContractSpec, implementationCode: string, violations: {
+  message: string;
+  suggestion?: string;
+}[]): AgentPrompt;
+//#endregion
+export { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt };

package/dist/llm/types.d.ts

@@ -0,0 +1,213 @@
+import { PresentationDescriptorV2 } from "../presentations.v2.js";
+import { DocBlock } from "../docs/types.js";
+import { EventSpec } from "../events.js";
+import { AnyContractSpec } from "../spec.js";
+import { FeatureModuleSpec } from "../features.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+
+//#region src/llm/types.d.ts
+
+/** Supported export formats for LLM consumption */
+type LLMExportFormat = 'context' | 'full' | 'prompt';
+/** Supported agent types for implementation guidance */
+type AgentType = 'claude-code' | 'cursor-cli' | 'generic-mcp';
+/** Verification tiers */
+type VerificationTier = 'structure' | 'behavior' | 'ai_review';
+/** Options for exporting specs to markdown */
+interface SpecExportOptions {
+  /** Export format: context (summary), full (all details), prompt (actionable) */
+  format: LLMExportFormat;
+  /** Include JSON Schema for I/O types */
+  includeSchemas?: boolean;
+  /** Include acceptance scenarios */
+  includeScenarios?: boolean;
+  /** Include examples */
+  includeExamples?: boolean;
+  /** Include policy details */
+  includePolicy?: boolean;
+  /** Include side effects (events, analytics) */
+  includeSideEffects?: boolean;
+}
+/** Options for exporting features to markdown */
+interface FeatureExportOptions extends SpecExportOptions {
+  /** Include related specs inline */
+  includeRelatedSpecs?: boolean;
+  /** Include related events inline */
+  includeRelatedEvents?: boolean;
+  /** Include related presentations inline */
+  includeRelatedPresentations?: boolean;
+}
+/** Result of spec export */
+interface SpecExportResult {
+  /** The spec that was exported */
+  spec: AnyContractSpec;
+  /** Generated markdown content */
+  markdown: string;
+  /** Export format used */
+  format: LLMExportFormat;
+  /** Metadata about the export */
+  meta: {
+    specName: string;
+    specVersion: number;
+    exportedAt: string;
+    wordCount: number;
+  };
+}
+/** Result of feature export */
+interface FeatureExportResult {
+  /** The feature that was exported */
+  feature: FeatureModuleSpec;
+  /** Generated markdown content */
+  markdown: string;
+  /** Export format used */
+  format: LLMExportFormat;
+  /** Included specs */
+  includedSpecs: string[];
+  /** Included events */
+  includedEvents: string[];
+  /** Included presentations */
+  includedPresentations: string[];
+}
+/** Implementation plan generated for agents */
+interface ImplementationPlan {
+  /** Feature/spec being implemented */
+  target: {
+    type: 'spec' | 'feature' | 'presentation';
+    name: string;
+    version: number;
+  };
+  /** Context section */
+  context: {
+    goal: string;
+    description: string;
+    background: string;
+  };
+  /** Full spec markdown */
+  specMarkdown: string;
+  /** Suggested file structure */
+  fileStructure: {
+    path: string;
+    purpose: string;
+    type: 'create' | 'modify';
+  }[];
+  /** Ordered implementation steps */
+  steps: {
+    order: number;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+  }[];
+  /** Constraints to follow */
+  constraints: {
+    policy: string[];
+    security: string[];
+    pii: string[];
+  };
+  /** Verification checklist */
+  verificationChecklist: string[];
+}
+/** Verification issue found during implementation check */
+interface VerificationIssue {
+  /** Issue severity */
+  severity: 'error' | 'warning' | 'info';
+  /** Issue category */
+  category: 'type' | 'export' | 'import' | 'scenario' | 'example' | 'error_handling' | 'semantic';
+  /** Issue message */
+  message: string;
+  /** Location in code if applicable */
+  location?: {
+    file?: string;
+    line?: number;
+    column?: number;
+  };
+  /** Suggested fix */
+  suggestion?: string;
+}
+/** Result of implementation verification */
+interface VerificationReport {
+  /** Verification tier that was run */
+  tier: VerificationTier;
+  /** Overall pass/fail */
+  passed: boolean;
+  /** Score from 0-100 */
+  score: number;
+  /** Issues found */
+  issues: VerificationIssue[];
+  /** Suggestions for improvement */
+  suggestions: string[];
+  /** Coverage metrics */
+  coverage: {
+    scenarios: {
+      total: number;
+      covered: number;
+    };
+    errors: {
+      total: number;
+      handled: number;
+    };
+    fields: {
+      total: number;
+      implemented: number;
+    };
+  };
+  /** Metadata about the verification */
+  meta: {
+    specName: string;
+    specVersion: number;
+    implementationPath: string;
+    verifiedAt: string;
+    duration: number;
+  };
+}
+/** Agent-specific prompt format */
+interface AgentPrompt {
+  /** Agent type this prompt is for */
+  agent: AgentType;
+  /** System prompt (if applicable) */
+  systemPrompt?: string;
+  /** User/task prompt */
+  taskPrompt: string;
+  /** Additional context resources */
+  resources?: {
+    uri: string;
+    title: string;
+    mimeType: string;
+  }[];
+}
+/** Input for spec lookup */
+interface SpecLookup {
+  name: string;
+  version?: number;
+}
+/** Input for feature lookup */
+interface FeatureLookup {
+  key: string;
+}
+/** Batch export options */
+interface BatchExportOptions extends SpecExportOptions {
+  /** Glob pattern to match spec files */
+  pattern?: string;
+  /** Spec types to include */
+  types?: ('command' | 'query' | 'event' | 'presentation' | 'feature')[];
+  /** Output format */
+  outputFormat?: 'single' | 'per-spec' | 'per-feature';
+}
+/** Exportable item types */
+type ExportableItem = {
+  type: 'spec';
+  item: AnyContractSpec;
+} | {
+  type: 'feature';
+  item: FeatureModuleSpec;
+} | {
+  type: 'presentation';
+  item: PresentationDescriptorV2;
+} | {
+  type: 'event';
+  item: EventSpec<AnySchemaModel>;
+} | {
+  type: 'doc';
+  item: DocBlock;
+};
+//#endregion
+export { AgentPrompt, AgentType, BatchExportOptions, ExportableItem, FeatureExportOptions, FeatureExportResult, FeatureLookup, ImplementationPlan, LLMExportFormat, SpecExportOptions, SpecExportResult, SpecLookup, VerificationIssue, VerificationReport, VerificationTier };