@lokascript/framework 2.0.0

package/dist/api/domain-registry.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Domain Registry
+ *
+ * Provides auto-discovery and registration of framework domains for MCP servers.
+ * Instead of hardcoding tool definitions and dispatch logic per domain, domains
+ * export a `DomainDescriptor` and the registry generates everything automatically.
+ *
+ * @example
+ * ```typescript
+ * import { DomainRegistry } from '@lokascript/framework';
+ *
+ * const registry = new DomainRegistry();
+ *
+ * // Register domains (each provides a descriptor)
+ * registry.register({
+ *   name: 'sql',
+ *   description: 'Natural language SQL',
+ *   languages: ['en', 'es', 'ja', 'ar'],
+ *   inputLabel: 'query',
+ *   inputDescription: 'SQL query in natural language',
+ *   getDSL: () => import('@lokascript/domain-sql').then(m => m.createSQLDSL()),
+ *   getRenderer: () => import('@lokascript/domain-sql').then(m => m.renderSQL),
+ * });
+ *
+ * // Auto-generate MCP tool definitions
+ * const tools = registry.getToolDefinitions();
+ *
+ * // Dispatch a tool call
+ * const result = await registry.handleToolCall('parse_sql', { query: 'select name from users' });
+ * ```
+ */
+import type { SemanticNode } from '../core/types';
+import type { MultilingualDSL } from './create-dsl';
+import type { NaturalLanguageRenderer } from '../generation/renderer';
+/**
+ * Describes a domain for auto-registration in MCP servers.
+ *
+ * Domains provide this descriptor to the registry, which generates
+ * tool definitions and handles dispatch automatically.
+ */
+export interface DomainDescriptor {
+    /** Short identifier (used in tool names: parse_{name}, compile_{name}, etc.) */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Supported language codes */
+    readonly languages: readonly string[];
+    /** Label for the primary input parameter (e.g., 'query', 'scenario', 'code') */
+    readonly inputLabel: string;
+    /** Description of the primary input parameter */
+    readonly inputDescription: string;
+    /**
+     * Factory to lazily create the DSL instance.
+     * Called once on first tool use. The result is cached.
+     */
+    readonly getDSL: () => MultilingualDSL | Promise<MultilingualDSL>;
+    /**
+     * Factory to lazily create the renderer.
+     * Required for translate_{name} tool. Called once on first use.
+     */
+    readonly getRenderer?: () => NaturalLanguageRenderer | ((node: SemanticNode, language: string) => string) | Promise<NaturalLanguageRenderer | ((node: SemanticNode, language: string) => string)>;
+    /**
+     * Which standard tools to generate. Default: all four.
+     */
+    readonly tools?: readonly ('parse' | 'compile' | 'validate' | 'translate')[];
+    /**
+     * Optional scan configuration for AOT compilation and Vite plugin.
+     * Declares which HTML attributes/script types this domain uses.
+     */
+    readonly scanConfig?: {
+        /** Attribute names to scan for (e.g., ['data-sql', '_sql']) */
+        readonly attributes: readonly string[];
+        /** Script tag types to scan for (e.g., ['text/sql-dsl']) */
+        readonly scriptTypes?: readonly string[];
+        /** Default language when not specified on element */
+        readonly defaultLanguage?: string;
+        /** Keywords for detection, keyed by language code */
+        readonly keywords?: Readonly<Record<string, readonly string[]>>;
+    };
+}
+/**
+ * MCP tool definition. Compatible with the MCP SDK's tool schema.
+ */
+export interface MCPToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: 'object';
+        readonly properties: Record<string, unknown>;
+        readonly required: readonly string[];
+    };
+}
+/**
+ * MCP tool response. Compatible with the MCP SDK's response format.
+ */
+export interface MCPToolResponse {
+    readonly content: ReadonlyArray<{
+        readonly type: string;
+        readonly text: string;
+    }>;
+    readonly isError?: boolean;
+}
+/**
+ * Registry for framework domains.
+ *
+ * Manages domain descriptors, generates MCP tool definitions,
+ * and dispatches tool calls to the appropriate domain.
+ */
+export declare class DomainRegistry {
+    private descriptors;
+    private dslCache;
+    private rendererCache;
+    /**
+     * Register a domain.
+     * @throws if a domain with the same name is already registered
+     */
+    register(descriptor: DomainDescriptor): void;
+    /**
+     * Get all registered domain names.
+     */
+    getDomainNames(): string[];
+    /**
+     * Get a specific domain descriptor.
+     */
+    getDescriptor(name: string): DomainDescriptor | undefined;
+    /**
+     * Generate MCP tool definitions for all registered domains.
+     */
+    getToolDefinitions(): MCPToolDefinition[];
+    /**
+     * Check if a tool name belongs to a registered domain.
+     */
+    canHandle(toolName: string): boolean;
+    /**
+     * Handle a tool call by dispatching to the appropriate domain.
+     * Returns null if the tool name doesn't match any registered domain.
+     */
+    handleToolCall(toolName: string, args: Record<string, unknown>): Promise<MCPToolResponse | null>;
+    /**
+     * Get the DSL instance for a named domain.
+     * Returns null if the domain is not registered.
+     * The DSL is lazily created and cached.
+     */
+    getDSLForDomain(name: string): Promise<MultilingualDSL | null>;
+    private getDSL;
+    private getRenderer;
+    private handleParse;
+    private handleCompile;
+    private handleValidate;
+    private handleTranslate;
+}
+//# sourceMappingURL=domain-registry.d.ts.map

package/dist/api/domain-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-registry.d.ts","sourceRoot":"","sources":["../../src/api/domain-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,cAAc,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAMtE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAElE;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MACnB,uBAAuB,GACvB,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAClD,OAAO,CAAC,uBAAuB,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC;IAE1F;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC,EAAE,CAAC;IAE7E;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,+DAA+D;QAC/D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,4DAA4D;QAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzC,qDAAqD;QACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAClC,qDAAqD;QACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;KACjE,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,aAAa,CAGjB;IAEJ;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAO5C;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIzD;;OAEG;IACH,kBAAkB,IAAI,iBAAiB,EAAE;IAQzC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMpC;;;OAGG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA4BlC;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;YAUtD,MAAM;YASN,WAAW;YAiBX,WAAW;YAwBX,aAAa;YAoBb,cAAc;YAmBd,eAAe;CAyC9B"}

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Main API exports for @lokascript/framework
+ */
+export * from './create-dsl';
+export * from './domain-registry';
+export * from './dispatcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}