@angriff36/manifest 2.18.0

package/dist/manifest/agent-sdk/agent-runtime.js

@@ -0,0 +1,232 @@
+/**
+ * AgentRuntime — LLM-friendly wrapper around RuntimeEngine.
+ * Handles tool call routing, result formatting, and built-in introspection.
+ */
+import { toAnthropicTools, toOpenAITools, toVercelAITools, getBuiltinToolNames } from './tool-definitions.js';
+import { listEntities, describeEntity, listCommands, describeCommand, formatExpression } from './introspect.js';
+import { findMatchingCommands } from './intent-mapper.js';
+// ------------------------------------------------------------------------------------------------
+// AgentRuntime
+// ------------------------------------------------------------------------------------------------
+export class AgentRuntime {
+    engine;
+    options;
+    ir;
+    builtinToolNames;
+    constructor(engine, options = {}) {
+        this.engine = engine;
+        this.options = {
+            builtinPrefix: options.builtinPrefix ?? 'manifest',
+            toolNameStrategy: options.toolNameStrategy ?? 'snake',
+        };
+        this.ir = engine.getIR();
+        this.builtinToolNames = getBuiltinToolNames(this.options.builtinPrefix);
+    }
+    // ------------------------------------------------------------------------------------------------
+    // Tool Definitions
+    // ------------------------------------------------------------------------------------------------
+    getToolDefinitions(format) {
+        switch (format) {
+            case 'anthropic':
+                return toAnthropicTools(this.ir, { ...this.options, includeBuiltins: true });
+            case 'openai':
+                return toOpenAITools(this.ir, { ...this.options, includeBuiltins: true });
+            case 'vercel':
+                return toVercelAITools(this.ir, { ...this.options, includeBuiltins: true });
+        }
+    }
+    // ------------------------------------------------------------------------------------------------
+    // Tool Call Execution
+    // ------------------------------------------------------------------------------------------------
+    async executeToolCall(call) {
+        const { name, arguments: args } = call;
+        // Route to built-in or user command
+        if (name in this.builtinToolNames) {
+            return this.executeBuiltin(name, args);
+        }
+        // Unknown tool: command not in builtins and not in IR commands
+        const commandExists = this.ir.commands.some((c) => c.name === name || `${c.entity?.toLowerCase()}_${c.name}` === name);
+        if (!commandExists) {
+            return { success: false, code: 'UNKNOWN_TOOL', message: `Unknown tool: ${name}` };
+        }
+        // User command — try mangled name first, then raw name
+        return this.executeCommand(name, args);
+    }
+    async executeBuiltin(name, args) {
+        const tool = this.builtinToolNames[name];
+        if (!tool) {
+            return {
+                success: false,
+                code: 'UNKNOWN_TOOL',
+                message: `Unknown tool: ${name}`,
+            };
+        }
+        switch (tool) {
+            case this.builtinToolNames.LIST_ENTITIES: {
+                const module = args.module;
+                const entities = listEntities(this.ir).filter((e) => !module || e.module === module);
+                return { success: true, code: 'SUCCESS', message: `${entities.length} entities found`, data: entities };
+            }
+            case this.builtinToolNames.DESCRIBE_ENTITY: {
+                const name_ = args.name;
+                if (!name_)
+                    return { success: false, code: 'MISSING_ARGUMENT', message: 'Missing required argument: name' };
+                const details = describeEntity(this.ir, name_);
+                if (!details)
+                    return { success: false, code: 'ENTITY_NOT_FOUND', message: `Entity not found: ${name_}` };
+                return { success: true, code: 'SUCCESS', message: `Entity: ${name_}`, data: details };
+            }
+            case this.builtinToolNames.LIST_COMMANDS: {
+                const entity = args.entity;
+                const module = args.module;
+                const cmds = listCommands(this.ir, { entity, module });
+                return { success: true, code: 'SUCCESS', message: `${cmds.length} commands found`, data: cmds };
+            }
+            case this.builtinToolNames.DESCRIBE_COMMAND: {
+                const name_ = args.name;
+                if (!name_)
+                    return { success: false, code: 'MISSING_ARGUMENT', message: 'Missing required argument: name' };
+                const details = describeCommand(this.ir, name_);
+                if (!details)
+                    return { success: false, code: 'COMMAND_NOT_FOUND', message: `Command not found: ${name_}` };
+                return { success: true, code: 'SUCCESS', message: `Command: ${name_}`, data: details };
+            }
+            case this.builtinToolNames.EXECUTE_COMMAND: {
+                const { command, entityId, parameters = {}, context = {} } = args;
+                if (!command)
+                    return { success: false, code: 'MISSING_ARGUMENT', message: 'Missing required argument: command' };
+                // runCommand signature: (name, input, options?)
+                const result = await this.engine.runCommand(command, { ...parameters, ...(entityId ? { entityId } : {}) }, {
+                    ...(entityId ? { instanceId: entityId } : {}),
+                    ...(context ? { causationId: context.causationId } : {}),
+                });
+                return this.formatResultForLLM(result);
+            }
+            case this.builtinToolNames.GET_INSTANCES: {
+                const { entity, limit = 20 } = args;
+                if (!entity)
+                    return { success: false, code: 'MISSING_ARGUMENT', message: 'Missing required argument: entity' };
+                const instances = await this.engine.getAllInstances(entity);
+                return { success: true, code: 'SUCCESS', message: `${instances.length} instances found`, data: instances.slice(0, limit) };
+            }
+            case this.builtinToolNames.CHECK_CONSTRAINTS: {
+                const { entity, entityId, constraintCodes } = args;
+                if (!entity || !entityId) {
+                    return { success: false, code: 'MISSING_ARGUMENT', message: 'Missing required arguments: entity, entityId' };
+                }
+                const inst = await this.engine.getInstance(entity, entityId);
+                if (!inst)
+                    return { success: false, code: 'INSTANCE_NOT_FOUND', message: `Instance not found: ${entityId}` };
+                const entityDef = this.ir.entities.find((e) => e.name === entity);
+                if (!entityDef)
+                    return { success: false, code: 'ENTITY_NOT_FOUND', message: `Entity not found: ${entity}` };
+                const constraintOutcomes = (entityDef.constraints ?? [])
+                    .filter((c) => !constraintCodes || constraintCodes.length === 0 || constraintCodes.includes(c.code))
+                    .map((c) => ({ code: c.code, constraintName: c.name, severity: c.severity ?? 'block', passed: false }));
+                return { success: true, code: 'SUCCESS', message: 'Constraint check complete', data: constraintOutcomes };
+            }
+            default:
+                return { success: false, code: 'UNKNOWN_TOOL', message: `Unknown tool: ${name}` };
+        }
+    }
+    async executeCommand(commandName, args) {
+        const { entityId, parameters = {}, context = {} } = args;
+        // Try to resolve the actual command name (may be mangled as entity_command or raw)
+        const cmd = this.ir.commands.find((c) => c.name === commandName || `${c.entity?.toLowerCase()}_${c.name}` === commandName);
+        const resolvedName = cmd?.name ?? commandName;
+        // runCommand signature: (commandName, input, options?)
+        const result = await this.engine.runCommand(resolvedName, { ...parameters, ...(entityId ? { entityId } : {}) }, {
+            ...(entityId ? { instanceId: entityId } : {}),
+            ...(context ? { causationId: context.causationId } : {}),
+        });
+        return this.formatResultForLLM(result);
+    }
+    // ------------------------------------------------------------------------------------------------
+    // Convenience introspection helpers
+    // ------------------------------------------------------------------------------------------------
+    listEntities(opts) {
+        return listEntities(this.ir).filter((e) => !opts?.module || e.module === opts.module);
+    }
+    describeEntity(name) {
+        return describeEntity(this.ir, name);
+    }
+    listCommands(opts) {
+        return listCommands(this.ir, opts);
+    }
+    describeCommand(name) {
+        return describeCommand(this.ir, name);
+    }
+    findCommands(intent) {
+        return findMatchingCommands(this.ir, intent);
+    }
+    // ------------------------------------------------------------------------------------------------
+    // Result formatting
+    // ------------------------------------------------------------------------------------------------
+    formatResultForLLM(result) {
+        if (result.success) {
+            return {
+                success: true,
+                code: 'SUCCESS',
+                message: 'Command executed successfully',
+                data: result.result,
+                emittedEvents: result.emittedEvents.map((e) => e.name),
+            };
+        }
+        if (result.guardFailure) {
+            return {
+                success: false,
+                code: 'GUARD_FAILED',
+                message: `Guard ${result.guardFailure.index + 1} evaluated to false`,
+                guardFailure: {
+                    index: result.guardFailure.index,
+                    expression: formatExpression(result.guardFailure.expression),
+                    resolved: result.guardFailure.resolved ?? [],
+                },
+            };
+        }
+        if (result.policyDenial) {
+            return {
+                success: false,
+                code: 'POLICY_DENIED',
+                message: result.policyDenial.message ?? 'Policy denied execution',
+                policyDenial: {
+                    policy: result.policyDenial.policyName ?? 'unknown',
+                    expression: formatExpression(result.policyDenial.expression),
+                },
+            };
+        }
+        if (result.concurrencyConflict) {
+            return {
+                success: false,
+                code: 'CONCURRENCY_CONFLICT',
+                message: 'Concurrent modification detected',
+                concurrencyConflict: {
+                    entityType: result.concurrencyConflict.entityType,
+                    entityId: result.concurrencyConflict.entityId,
+                    expectedVersion: result.concurrencyConflict.expectedVersion,
+                    actualVersion: result.concurrencyConflict.actualVersion,
+                },
+            };
+        }
+        if (result.constraintOutcomes && result.constraintOutcomes.some((c) => c.severity === 'block' && !c.passed)) {
+            return {
+                success: false,
+                code: 'CONSTRAINT_BLOCKED',
+                message: 'One or more constraints were violated',
+                constraintOutcomes: result.constraintOutcomes.map((c) => ({
+                    code: c.code,
+                    constraintName: c.constraintName,
+                    severity: c.severity ?? 'block',
+                    passed: c.passed,
+                    overridden: c.overridden,
+                })),
+            };
+        }
+        return {
+            success: false,
+            code: 'EXECUTION_ERROR',
+            message: result.error ?? 'Command execution failed',
+        };
+    }
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/manifest/agent-sdk/agent-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.js","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/agent-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,mGAAmG;AACnG,eAAe;AACf,mGAAmG;AAEnG,MAAM,OAAO,YAAY;IACN,MAAM,CAAgB;IACtB,OAAO,CAAgC;IAC/C,EAAE,CAAK;IACP,gBAAgB,CAAmB;IAE5C,YAAY,MAAqB,EAAE,UAA+B,EAAE;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG;YACb,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,UAAU;YAClD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,OAAO;SACtD,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,mGAAmG;IACnG,mBAAmB;IACnB,mGAAmG;IAEnG,kBAAkB,CAAC,MAAkB;QACnC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,WAAW;gBACd,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/E,KAAK,QAAQ;gBACX,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,KAAK,QAAQ;gBACX,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,mGAAmG;IACnG,sBAAsB;IACtB,mGAAmG;IAEnG,KAAK,CAAC,eAAe,CAAC,IAAmB;QACvC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEvC,oCAAoC;QACpC,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,+DAA+D;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,CAC1E,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACpF,CAAC;QAED,uDAAuD;QACvD,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAA6B;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAA8B,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,iBAAiB,IAAI,EAAE;aACjC,CAAC;QACJ,CAAC;QAED,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;gBACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;gBACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC1G,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAc,CAAC;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;gBAC5G,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,KAAK,EAAE,EAAE,CAAC;gBACzG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxF,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;gBACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;gBACjD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAClG,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAc,CAAC;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;gBAC5G,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChD,IAAI,CAAC,OAAO;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,KAAK,EAAE,EAAE,CAAC;gBAC3G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACzF,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAK5D,CAAC;gBACF,IAAI,CAAC,OAAO;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;gBACjH,gDAAgD;gBAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBACzG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAG,OAAoC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvF,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;gBACzC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAA2C,CAAC;gBAC3E,IAAI,CAAC,MAAM;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;gBAC/G,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,MAAM,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAe,CAAC,EAAE,CAAC;YACvI,CAAC;YAED,KAAK,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAC7C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAI7C,CAAC;gBACF,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;gBAC/G,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC7D,IAAI,CAAC,IAAI;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,uBAAuB,QAAQ,EAAE,EAAE,CAAC;gBAC7G,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAClE,IAAI,CAAC,SAAS;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,MAAM,EAAE,EAAE,CAAC;gBAC5G,MAAM,kBAAkB,GAAG,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC;qBACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACnG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC1G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;YAC5G,CAAC;YAED;gBACE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,WAAmB,EAAE,IAA6B;QAC7E,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,IAInD,CAAC;QAEF,mFAAmF;QACnF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,WAAW,CACxF,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC;QAE9C,uDAAuD;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACzC,YAAY,EACZ,EAAE,GAAI,UAAsC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACjF;YACE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAG,OAAoC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CACF,CAAC;QAEF,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,mGAAmG;IACnG,oCAAoC;IACpC,mGAAmG;IAEnG,YAAY,CAAC,IAA0B;QACrC,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IACxF,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,YAAY,CAAC,IAA2C;QACtD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,mGAAmG;IACnG,oBAAoB;IACpB,mGAAmG;IAE3F,kBAAkB,CAAC,MAAqB;QAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,+BAA+B;gBACxC,IAAI,EAAE,MAAM,CAAC,MAAM;gBACnB,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACvD,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,SAAS,MAAM,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,qBAAqB;gBACpE,YAAY,EAAE;oBACZ,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK;oBAChC,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;oBAC5D,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE;iBAC7C;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,IAAI,yBAAyB;gBACjE,YAAY,EAAE;oBACZ,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU,IAAI,SAAS;oBACnD,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;iBAC7D;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EAAE,kCAAkC;gBAC3C,mBAAmB,EAAE;oBACnB,UAAU,EAAE,MAAM,CAAC,mBAAmB,CAAC,UAAU;oBACjD,QAAQ,EAAE,MAAM,CAAC,mBAAmB,CAAC,QAAQ;oBAC7C,eAAe,EAAE,MAAM,CAAC,mBAAmB,CAAC,eAAe;oBAC3D,aAAa,EAAE,MAAM,CAAC,mBAAmB,CAAC,aAAa;iBACxD;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5G,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,uCAAuC;gBAChD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO;oBAC/B,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,0BAA0B;SACpD,CAAC;IACJ,CAAC;CACF"}

package/dist/manifest/agent-sdk/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @manifest/agent-sdk — LLM-friendly interfaces for the Manifest runtime engine.
+ *
+ * Exports:
+ * - AgentRuntime         — stateful wrapper with tool call routing
+ * - Tool formats         — Anthropic / OpenAI / Vercel tool definition generators
+ * - Introspection        — entity & command listing and description
+ * - Intent mapping       — keyword-based natural-language command matching
+ * - JSON Schema helpers  — IR type → JSON Schema conversion
+ */
+export type * from './types';
+export { irTypeToJsonSchema, irParametersToJsonSchema, irValueToJson } from './json-schema.js';
+export { listEntities, describeEntity, listCommands, describeCommand, getEntityRelationships, getActionableEntities, formatExpression, formatIRType, } from './introspect.js';
+export { toAnthropicTools, toOpenAITools, toVercelAITools, commandToAnthropicTool, commandToOpenAITool, commandToVercelTool, mangleToolName, parseToolName, getBuiltinToolNames, } from './tool-definitions.js';
+export { findMatchingCommands, tokenize } from './intent-mapper.js';
+export { AgentRuntime } from './agent-runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/agent-sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,mBAAmB,SAAS,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG/F,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/manifest/agent-sdk/index.js

@@ -0,0 +1,21 @@
+/**
+ * @manifest/agent-sdk — LLM-friendly interfaces for the Manifest runtime engine.
+ *
+ * Exports:
+ * - AgentRuntime         — stateful wrapper with tool call routing
+ * - Tool formats         — Anthropic / OpenAI / Vercel tool definition generators
+ * - Introspection        — entity & command listing and description
+ * - Intent mapping       — keyword-based natural-language command matching
+ * - JSON Schema helpers  — IR type → JSON Schema conversion
+ */
+// JSON Schema converter
+export { irTypeToJsonSchema, irParametersToJsonSchema, irValueToJson } from './json-schema.js';
+// Introspection
+export { listEntities, describeEntity, listCommands, describeCommand, getEntityRelationships, getActionableEntities, formatExpression, formatIRType, } from './introspect.js';
+// Tool definitions
+export { toAnthropicTools, toOpenAITools, toVercelAITools, commandToAnthropicTool, commandToOpenAITool, commandToVercelTool, mangleToolName, parseToolName, getBuiltinToolNames, } from './tool-definitions.js';
+// Intent mapping
+export { findMatchingCommands, tokenize } from './intent-mapper.js';
+// AgentRuntime
+export { AgentRuntime } from './agent-runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/manifest/agent-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,wBAAwB;AACxB,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE/F,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEpE,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/manifest/agent-sdk/intent-mapper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Keyword-based natural-language-to-command intent mapping.
+ * No LLM dependency — pure keyword and token scoring.
+ */
+import type { IR } from '../ir';
+import type { IntentMatch, IntentMapperOptions } from './types';
+/**
+ * Tokenize a string into program-relevant tokens.
+ * Splits on whitespace/punctuation and camelCase boundaries, lowercases, removes stopwords.
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Find commands that best match a natural-language user intent.
+ * Uses multi-token keyword scoring with determinism via score desc + name asc.
+ */
+export declare function findMatchingCommands(ir: IR, userIntent: string, opts?: IntentMapperOptions): IntentMatch[];
+//# sourceMappingURL=intent-mapper.d.ts.map

package/dist/manifest/agent-sdk/intent-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-mapper.d.ts","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/intent-mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAgBhE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,WAAW,EAAE,CAwFf"}

package/dist/manifest/agent-sdk/intent-mapper.js

@@ -0,0 +1,115 @@
+/**
+ * Keyword-based natural-language-to-command intent mapping.
+ * No LLM dependency — pure keyword and token scoring.
+ */
+// English stopwords to filter from tokenization
+const STOPWORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by',
+    'from', 'as', 'is', 'was', 'are', 'were', 'been', 'be', 'have', 'has', 'had', 'do', 'does',
+    'did', 'will', 'would', 'could', 'should', 'may', 'might', 'must', 'shall', 'can', 'need',
+    'i', 'you', 'he', 'she', 'it', 'we', 'they', 'me', 'him', 'her', 'us', 'them', 'my', 'your',
+    'his', 'her', 'its', 'our', 'their', 'what', 'which', 'who', 'whom', 'this', 'that', 'these',
+    'those', 'am', 'if', 'then', 'else', 'when', 'where', 'why', 'how', 'all', 'each', 'every',
+    'both', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own',
+    'same', 'so', 'than', 'too', 'very', 'just', 'also', 'now', 'here', 'there', 'up', 'down',
+    'out', 'off', 'over', 'into', 'about', 'after', 'before', 'above', 'below', 'between',
+    'through', 'during', 'under', 'again', 'further', 'once',
+]);
+/**
+ * Tokenize a string into program-relevant tokens.
+ * Splits on whitespace/punctuation and camelCase boundaries, lowercases, removes stopwords.
+ */
+export function tokenize(text) {
+    return text
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .flatMap((segment) => segment.split(/(?=[A-Z])/)) // split camelCase BEFORE lowercasing
+        .map((t) => t.toLowerCase())
+        .filter((t) => t.length > 1 && !STOPWORDS.has(t));
+}
+/**
+ * Find commands that best match a natural-language user intent.
+ * Uses multi-token keyword scoring with determinism via score desc + name asc.
+ */
+export function findMatchingCommands(ir, userIntent, opts = {}) {
+    const { minScore = 0.1, entityFilter } = opts;
+    const tokens = tokenize(userIntent);
+    if (tokens.length === 0)
+        return [];
+    const scored = [];
+    for (const cmd of ir.commands) {
+        if (entityFilter) {
+            const entity = ir.entities.find((e) => e.name === cmd.entity);
+            if (entity && !entityFilter(entity))
+                continue;
+        }
+        let score = 0;
+        const matchedTokens = [];
+        const cmdTokens = tokenize(cmd.name);
+        // +3 per command name token
+        for (const tk of cmdTokens) {
+            if (tokens.includes(tk)) {
+                score += 3;
+                matchedTokens.push(tk);
+            }
+        }
+        // +2 per entity name token
+        if (cmd.entity) {
+            const entityTokens = tokenize(cmd.entity);
+            for (const tk of entityTokens) {
+                if (tokens.includes(tk)) {
+                    score += 2;
+                    matchedTokens.push(tk);
+                }
+            }
+        }
+        // +1 per parameter or event name token
+        for (const p of cmd.parameters) {
+            const pTokens = tokenize(p.name);
+            for (const tk of pTokens) {
+                if (tokens.includes(tk)) {
+                    score += 1;
+                    matchedTokens.push(tk);
+                }
+            }
+        }
+        for (const ev of cmd.emits) {
+            const evTokens = tokenize(ev);
+            for (const tk of evTokens) {
+                if (tokens.includes(tk)) {
+                    score += 1;
+                    matchedTokens.push(tk);
+                }
+            }
+        }
+        // +0.5 per module name token
+        if (cmd.module) {
+            const modTokens = tokenize(cmd.module);
+            for (const tk of modTokens) {
+                if (tokens.includes(tk)) {
+                    score += 0.5;
+                    matchedTokens.push(tk);
+                }
+            }
+        }
+        if (score >= minScore) {
+            scored.push({
+                command: cmd.name,
+                entity: cmd.entity,
+                score,
+                matchedTokens: [...new Set(matchedTokens)],
+                reason: matchedTokens.length > 0
+                    ? `Matched: ${[...new Set(matchedTokens)].join(', ')}`
+                    : 'Command name similarity',
+            });
+        }
+    }
+    // Sort deterministically: score desc, then name asc
+    scored.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.command.localeCompare(b.command);
+    });
+    return scored;
+}
+//# sourceMappingURL=intent-mapper.js.map

package/dist/manifest/agent-sdk/intent-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-mapper.js","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/intent-mapper.ts"],"names":[],"mappings":"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"}

package/dist/manifest/agent-sdk/introspect.d.ts

@@ -0,0 +1,42 @@
+/**
+ * IR introspection helpers for AI agent consumption.
+ * Pure functions that extract meaningful summaries from compiled IR.
+ */
+import type { IR, IRExpression, IRType } from '../ir';
+import type { EntitySummary, EntityDetails, CommandSummary, CommandDetails, RelationshipGraph } from './types';
+/** Standalone expression formatter — mirrors the algorithm from RuntimeEngine.formatExpression. */
+export declare function formatExpression(expr: IRExpression): string;
+export declare function formatIRType(type: IRType): string;
+/**
+ * List all entities as lightweight summaries.
+ */
+export declare function listEntities(ir: IR): EntitySummary[];
+/**
+ * Get detailed information about a single entity.
+ */
+export declare function describeEntity(ir: IR, name: string): EntityDetails | null;
+/**
+ * List all commands as lightweight summaries.
+ * Optional filter by entity or module.
+ */
+export declare function listCommands(ir: IR, opts?: {
+    entity?: string;
+    module?: string;
+}): CommandSummary[];
+/**
+ * Get detailed information about a single command.
+ */
+export declare function describeCommand(ir: IR, name: string, opts?: {
+    includeGuardExpressions?: boolean;
+    includeActionExpressions?: boolean;
+}): CommandDetails | null;
+/**
+ * Get the relationship graph for an entity.
+ * Shows both outgoing relationships (this entity → others) and incoming (others → this).
+ */
+export declare function getEntityRelationships(ir: IR, name: string): RelationshipGraph;
+/**
+ * Get entities that have commands — useful for showing which entities are "actionable".
+ */
+export declare function getActionableEntities(ir: IR): EntitySummary[];
+//# sourceMappingURL=introspect.d.ts.map

package/dist/manifest/agent-sdk/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/introspect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,EAAE,EAGF,YAAY,EACZ,MAAM,EAIP,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EAGd,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAMjB,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA4B3D;AA6BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,aAAa,EAAE,CAEpD;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoCzE;AAqBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,EAAE,EACN,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,cAAc,EAAE,CAKlB;AAeD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/E,cAAc,GAAG,IAAI,CA6CvB;AA0BD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAoC9E;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,aAAa,EAAE,CAG7D"}