@angriff36/manifest 2.18.0

package/dist/manifest/agent-sdk/tool-definitions.js

@@ -0,0 +1,288 @@
+/**
+ * Generate AI tool definitions from IR in Anthropic, OpenAI, and Vercel AI SDK formats.
+ */
+import { irParametersToJsonSchema } from './json-schema.js';
+// ------------------------------------------------------------------------------------------------
+// Tool name mangling
+// ------------------------------------------------------------------------------------------------
+/**
+ * Convert a tool name to a safe identifier.
+ * Snake strategy: "Order.placeOrder" → "order_place_order"
+ * Dot strategy: "Order.placeOrder" → "Order.placeOrder" (no change)
+ */
+export function mangleToolName(entity, command, strategy) {
+    if (strategy === 'dot')
+        return `${entity ?? ''}${entity ? '.' : ''}${command}`;
+    // snake: entity is lowercased, command is preserved as-is
+    return `${entity ? entity.toLowerCase() + '_' : ''}${command}`;
+}
+/**
+ * Parse a mangled tool name back into entity + command.
+ * Only works reliably with snake strategy.
+ */
+export function parseToolName(name) {
+    const parts = name.split('_');
+    if (parts.length === 1)
+        return { command: name };
+    // Last part is the command (preserves its original case from mangleToolName);
+    // everything before is the entity name (all-lowercase from mangleToolName)
+    const entity = parts.slice(0, -1).join('');
+    const command = parts[parts.length - 1];
+    return { entity, command };
+}
+// ------------------------------------------------------------------------------------------------
+// Per-command tool converters
+// ------------------------------------------------------------------------------------------------
+function commandDescription(cmd, opts, _ir) {
+    const parts = [];
+    if (cmd.entity)
+        parts.push(`Entity: ${cmd.entity}`);
+    if (cmd.module)
+        parts.push(`Module: ${cmd.module}`);
+    parts.push(`Parameters: ${cmd.parameters.map((p) => `${p.name}: ${p.type.name}${p.required ? '' : '?'}`).join(', ') || 'none'}`);
+    if (opts.includeGuardHints && cmd.guards.length > 0) {
+        parts.push(`Guards: ${cmd.guards.length}`);
+    }
+    if (opts.includePolicyHints && (cmd.policies?.length ?? 0) > 0) {
+        parts.push(`Policies: ${cmd.policies.join(', ')}`);
+    }
+    if (cmd.emits.length > 0) {
+        parts.push(`Emits: ${cmd.emits.join(', ')}`);
+    }
+    return parts.join(' | ');
+}
+export function commandToAnthropicTool(cmd, opts, ir) {
+    return {
+        name: mangleToolName(cmd.entity, cmd.name, opts.toolNameStrategy ?? 'snake'),
+        description: commandDescription(cmd, opts, ir),
+        input_schema: irParametersToJsonSchema(cmd.parameters),
+    };
+}
+export function commandToOpenAITool(cmd, opts, ir) {
+    return {
+        type: 'function',
+        function: {
+            name: mangleToolName(cmd.entity, cmd.name, opts.toolNameStrategy ?? 'snake'),
+            description: commandDescription(cmd, opts, ir),
+            parameters: irParametersToJsonSchema(cmd.parameters),
+        },
+    };
+}
+export function commandToVercelTool(cmd, opts, ir) {
+    const name = mangleToolName(cmd.entity, cmd.name, opts.toolNameStrategy ?? 'snake');
+    return {
+        name,
+        description: commandDescription(cmd, opts, ir),
+        parameters: irParametersToJsonSchema(cmd.parameters),
+    };
+}
+// ------------------------------------------------------------------------------------------------
+// Built-in introspection tools
+// ------------------------------------------------------------------------------------------------
+export function getBuiltinToolNames(prefix) {
+    return {
+        LIST_ENTITIES: `${prefix}_list_entities`,
+        DESCRIBE_ENTITY: `${prefix}_describe_entity`,
+        LIST_COMMANDS: `${prefix}_list_commands`,
+        DESCRIBE_COMMAND: `${prefix}_describe_command`,
+        EXECUTE_COMMAND: `${prefix}_execute_command`,
+        GET_INSTANCES: `${prefix}_get_instances`,
+        CHECK_CONSTRAINTS: `${prefix}_check_constraints`,
+    };
+}
+function builtinListEntitiesSchema(_prefix) {
+    return {
+        type: 'object',
+        properties: {
+            module: { type: 'string', description: 'Optional module name to filter entities by' },
+        },
+        additionalProperties: false,
+    };
+}
+function builtinDescribeEntitySchema() {
+    return {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Name of the entity to describe' },
+            includeSchema: { type: 'boolean', description: 'Include property type schemas', default: false },
+        },
+        required: ['name'],
+        additionalProperties: false,
+    };
+}
+function builtinListCommandsSchema(_prefix) {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Optional entity name to filter commands by' },
+            module: { type: 'string', description: 'Optional module name to filter commands by' },
+        },
+        additionalProperties: false,
+    };
+}
+function builtinDescribeCommandSchema() {
+    return {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Name of the command to describe' },
+            includeExpressions: { type: 'boolean', description: 'Include guard/action expressions', default: false },
+        },
+        required: ['name'],
+        additionalProperties: false,
+    };
+}
+function builtinExecuteCommandSchema() {
+    return {
+        type: 'object',
+        properties: {
+            command: { type: 'string', description: 'Name of the command to execute' },
+            entityId: { type: 'string', description: 'ID of the entity instance to act on (if entity-scoped)' },
+            parameters: { type: 'object', description: 'Command parameters as key-value pairs', additionalProperties: true },
+            context: { type: 'object', description: 'Runtime context overrides', additionalProperties: true },
+        },
+        required: ['command'],
+        additionalProperties: false,
+    };
+}
+function builtinGetInstancesSchema() {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Name of the entity' },
+            limit: { type: 'number', description: 'Maximum number of instances to return', default: 20 },
+        },
+        required: ['entity'],
+        additionalProperties: false,
+    };
+}
+function builtinCheckConstraintsSchema() {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Name of the entity' },
+            entityId: { type: 'string', description: 'ID of the entity instance to check' },
+            constraintCodes: { type: 'array', items: { type: 'string' }, description: 'Specific constraint codes to check (if empty, checks all)' },
+        },
+        required: ['entity', 'entityId'],
+        additionalProperties: false,
+    };
+}
+function builtinCheckConstraintsVercelSchema() {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Name of the entity' },
+            entityId: { type: 'string', description: 'ID of the entity instance to check' },
+            constraintCodes: { type: 'array', items: { type: 'string' }, description: 'Specific constraint codes to check (if empty, checks all)' },
+        },
+        required: ['entity', 'entityId'],
+        additionalProperties: false,
+    };
+}
+function builtinListCommandsVercelSchema(_prefix) {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Optional entity name to filter commands by' },
+            module: { type: 'string', description: 'Optional module name to filter commands by' },
+        },
+        additionalProperties: false,
+    };
+}
+function builtinGetInstancesVercelSchema() {
+    return {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Name of the entity' },
+            limit: { type: 'number', description: 'Maximum number of instances to return', default: 20 },
+        },
+        required: ['entity'],
+        additionalProperties: false,
+    };
+}
+function getBuiltinsAnthropic(prefix, _strategy) {
+    return [
+        { name: `${prefix}_list_entities`, description: 'List all entities defined in the Manifest program', input_schema: builtinListEntitiesSchema(prefix) },
+        { name: `${prefix}_describe_entity`, description: 'Get detailed information about a specific entity', input_schema: builtinDescribeEntitySchema() },
+        { name: `${prefix}_list_commands`, description: 'List all commands, optionally filtered by entity or module', input_schema: builtinListCommandsSchema(prefix) },
+        { name: `${prefix}_describe_command`, description: 'Get detailed information about a specific command including parameters and guards', input_schema: builtinDescribeCommandSchema() },
+        { name: `${prefix}_execute_command`, description: 'Execute a Manifest command on an entity instance', input_schema: builtinExecuteCommandSchema() },
+        { name: `${prefix}_get_instances`, description: 'Get entity instances from the runtime store', input_schema: builtinGetInstancesSchema() },
+        { name: `${prefix}_check_constraints`, description: 'Check constraint outcomes for a specific entity instance', input_schema: builtinCheckConstraintsSchema() },
+    ];
+}
+function getBuiltinsOpenAI(prefix) {
+    return [
+        { type: 'function', function: { name: `${prefix}_list_entities`, description: 'List all entities defined in the Manifest program', parameters: builtinListEntitiesSchema(prefix) } },
+        { type: 'function', function: { name: `${prefix}_describe_entity`, description: 'Get detailed information about a specific entity', parameters: builtinDescribeEntitySchema() } },
+        { type: 'function', function: { name: `${prefix}_list_commands`, description: 'List all commands, optionally filtered by entity or module', parameters: builtinListCommandsSchema(prefix) } },
+        { type: 'function', function: { name: `${prefix}_describe_command`, description: 'Get detailed information about a specific command including parameters and guards', parameters: builtinDescribeCommandSchema() } },
+        { type: 'function', function: { name: `${prefix}_execute_command`, description: 'Execute a Manifest command on an entity instance', parameters: builtinExecuteCommandSchema() } },
+        { type: 'function', function: { name: `${prefix}_get_instances`, description: 'Get entity instances from the runtime store', parameters: builtinGetInstancesSchema() } },
+        { type: 'function', function: { name: `${prefix}_check_constraints`, description: 'Check constraint outcomes for a specific entity instance', parameters: builtinCheckConstraintsSchema() } },
+    ];
+}
+function getBuiltinsVercel(prefix) {
+    return {
+        [`${prefix}_list_entities`]: { description: 'List all entities defined in the Manifest program', parameters: builtinListEntitiesSchema(prefix) },
+        [`${prefix}_describe_entity`]: { description: 'Get detailed information about a specific entity', parameters: builtinDescribeEntitySchema() },
+        [`${prefix}_list_commands`]: { description: 'List all commands, optionally filtered by entity or module', parameters: builtinListCommandsVercelSchema(prefix) },
+        [`${prefix}_describe_command`]: { description: 'Get detailed information about a specific command including parameters and guards', parameters: builtinDescribeCommandSchema() },
+        [`${prefix}_execute_command`]: { description: 'Execute a Manifest command on an entity instance', parameters: builtinExecuteCommandSchema() },
+        [`${prefix}_get_instances`]: { description: 'Get entity instances from the runtime store', parameters: builtinGetInstancesVercelSchema() },
+        [`${prefix}_check_constraints`]: { description: 'Check constraint outcomes for a specific entity instance', parameters: builtinCheckConstraintsVercelSchema() },
+    };
+}
+// ------------------------------------------------------------------------------------------------
+// Top-level converters
+// ------------------------------------------------------------------------------------------------
+/**
+ * Generate Anthropic tool_use format tools from IR.
+ */
+export function toAnthropicTools(ir, opts = {}) {
+    const { toolNameStrategy = 'snake', builtinPrefix = 'manifest', includeBuiltins = true, commandFilter } = opts;
+    const tools = [];
+    for (const cmd of ir.commands) {
+        if (commandFilter && !commandFilter(cmd))
+            continue;
+        tools.push(commandToAnthropicTool(cmd, opts, ir));
+    }
+    if (includeBuiltins) {
+        tools.push(...getBuiltinsAnthropic(builtinPrefix, toolNameStrategy));
+    }
+    return tools;
+}
+/**
+ * Generate OpenAI function-calling format tools from IR.
+ */
+export function toOpenAITools(ir, opts = {}) {
+    const { includeBuiltins = true, commandFilter } = opts;
+    const tools = [];
+    for (const cmd of ir.commands) {
+        if (commandFilter && !commandFilter(cmd))
+            continue;
+        tools.push(commandToOpenAITool(cmd, opts, ir));
+    }
+    if (includeBuiltins) {
+        tools.push(...getBuiltinsOpenAI(opts.builtinPrefix ?? 'manifest'));
+    }
+    return tools;
+}
+/**
+ * Generate Vercel AI SDK tool format from IR.
+ */
+export function toVercelAITools(ir, opts = {}) {
+    const { includeBuiltins = true, commandFilter } = opts;
+    const tools = {};
+    for (const cmd of ir.commands) {
+        if (commandFilter && !commandFilter(cmd))
+            continue;
+        const t = commandToVercelTool(cmd, opts, ir);
+        tools[t.name] = { description: t.description, parameters: t.parameters };
+    }
+    if (includeBuiltins) {
+        Object.assign(tools, getBuiltinsVercel(opts.builtinPrefix ?? 'manifest'));
+    }
+    return tools;
+}
+//# sourceMappingURL=tool-definitions.js.map

package/dist/manifest/agent-sdk/tool-definitions.js.map

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

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

@@ -0,0 +1,293 @@
+/**
+ * SDK types for @manifest/agent-sdk
+ * All types here are SDK-specific and don't duplicate ir.ts types.
+ */
+import type { IR, IREntity, IRCommand, IRParameter, IRExpression, IRType, IRValue } from '../ir';
+/**
+ * Minimal JSON Schema Draft-07 subset sufficient for tool definitions.
+ * Used as input_schema in Anthropic tools and parameters in OpenAI/Vercel tools.
+ */
+export interface JsonSchema {
+    type?: string;
+    format?: string;
+    description?: string;
+    default?: unknown;
+    enum?: unknown[];
+    const?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    items?: JsonSchema;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+    /** Schema list for compound types (used internally for unions) */
+    schemas?: JsonSchema[];
+    /** Human-readable type label (sdk extension) */
+    'x-manifest-type'?: string;
+}
+/** Tool format selector */
+export type ToolFormat = 'anthropic' | 'openai' | 'vercel';
+/** Anthropic tool_use object */
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+}
+/** OpenAI function calling format */
+export interface OpenAITool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JsonSchema;
+    };
+}
+/** Vercel AI SDK tool format (keyed by tool name) */
+export type VercelAITools = Record<string, VercelAITool>;
+export interface VercelAITool {
+    description: string;
+    parameters: JsonSchema;
+}
+export interface ToolDefinitionOptions {
+    /**
+     * Strategy for sanitizing tool names (removing invalid chars).
+     * - 'snake': Order.placeOrder → order_place_order
+     * - 'dot': Order.placeOrder → Order.placeOrder (no change; assume chars already valid)
+     * @default 'snake'
+     */
+    toolNameStrategy?: 'snake' | 'dot';
+    /**
+     * Prefix for built-in introspection tools.
+     * @default 'manifest'
+     */
+    builtinPrefix?: string;
+    /**
+     * Optional command name filter: only include commands matching this predicate.
+     */
+    commandFilter?: (cmd: IRCommand) => boolean;
+    /**
+     * Optional entity filter: only include commands for these entities.
+     */
+    entityFilter?: (entity: IREntity) => boolean;
+    /**
+     * Include built-in introspection tools (list_entities, describe_entity, etc.).
+     * @default true
+     */
+    includeBuiltins?: boolean;
+    /**
+     * Include guard expressions in command descriptions.
+     * @default true
+     */
+    includeGuardHints?: boolean;
+    /**
+     * Include policy names in command descriptions.
+     * @default true
+     */
+    includePolicyHints?: boolean;
+}
+export interface PropertyDescriptor {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: unknown;
+    modifiers: string[];
+}
+export interface ComputedPropertyDescriptor {
+    name: string;
+    type: string;
+    dependencies: string[];
+    expression: string;
+}
+export interface RelationshipDescriptor {
+    name: string;
+    kind: string;
+    target: string;
+    foreignKey?: {
+        fields: string[];
+        references?: string[];
+    };
+    through?: string;
+}
+export interface ConstraintDescriptor {
+    name: string;
+    code: string;
+    severity: string;
+    message?: string;
+    expression: string;
+    overrideable?: boolean;
+}
+export interface PolicyDescriptor {
+    name: string;
+    action: string;
+    expression: string;
+    message?: string;
+}
+export interface EntitySummary {
+    name: string;
+    module?: string;
+    propertyCount: number;
+    computedPropertyCount: number;
+    relationshipCount: number;
+    commandCount: number;
+    constraintCount: number;
+}
+export interface EntityDetails {
+    summary: EntitySummary;
+    properties: PropertyDescriptor[];
+    computedProperties: ComputedPropertyDescriptor[];
+    relationships: RelationshipDescriptor[];
+    constraints: ConstraintDescriptor[];
+    policies: PolicyDescriptor[];
+    key?: string[];
+    alternateKeys?: string[][];
+    versionProperty?: string;
+    transitions?: {
+        property: string;
+        from: string;
+        to: string[];
+    }[];
+}
+export interface CommandSummary {
+    name: string;
+    module?: string;
+    entity?: string;
+    parameterCount: number;
+    guardCount: number;
+    constraintCount: number;
+    policyCount: number;
+    emitsCount: number;
+}
+export interface CommandDetails {
+    summary: CommandSummary;
+    parameters: ParameterDescriptor[];
+    guards: GuardDescriptor[];
+    constraints: ConstraintDescriptor[];
+    policies: PolicyDescriptor[];
+    emits: string[];
+    returns?: string;
+    actions: {
+        kind: string;
+        target?: string;
+        expression: string;
+    }[];
+}
+export interface ParameterDescriptor {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: unknown;
+}
+export interface GuardDescriptor {
+    index: number;
+    expression: string;
+}
+export interface RelationshipGraph {
+    entity: string;
+    relationships: {
+        name: string;
+        kind: string;
+        target: string;
+        direction: 'incoming' | 'outgoing';
+        foreignKey?: {
+            fields: string[];
+            references?: string[];
+        };
+        through?: string;
+    }[];
+}
+export interface IntentMatch {
+    command: string;
+    entity?: string;
+    score: number;
+    matchedTokens: string[];
+    reason: string;
+}
+export interface IntentMapperOptions {
+    /**
+     * Minimum score threshold for a match to be included.
+     * @default 0.1
+     */
+    minScore?: number;
+    /**
+     * Optional entity filter.
+     */
+    entityFilter?: (entity: IREntity) => boolean;
+}
+/** Built-in tool names as constants (with configurable prefix) */
+export interface BuiltinToolNames {
+    LIST_ENTITIES: string;
+    DESCRIBE_ENTITY: string;
+    LIST_COMMANDS: string;
+    DESCRIBE_COMMAND: string;
+    EXECUTE_COMMAND: string;
+    GET_INSTANCES: string;
+    CHECK_CONSTRAINTS: string;
+}
+/** Agent tool call as received from an LLM */
+export interface AgentToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Tool result formatted for LLM consumption.
+ * Distinguishes success from user-facing error types (not technical stack traces).
+ */
+export interface AgentToolResult {
+    success: boolean;
+    /** Stable error code or 'SUCCESS' */
+    code: string;
+    /** Human-readable summary */
+    message: string;
+    /** Structured data payload (absent on error) */
+    data?: unknown;
+    /** Guard that failed */
+    guardFailure?: {
+        index: number;
+        expression: string;
+        resolved: Array<{
+            expression: string;
+            value: unknown;
+        }>;
+    };
+    /** Policy that denied */
+    policyDenial?: {
+        policy: string;
+        expression: string;
+    };
+    /** Constraint outcomes */
+    constraintOutcomes?: Array<{
+        code: string;
+        constraintName: string;
+        severity: string;
+        passed: boolean;
+        overridden?: boolean;
+    }>;
+    /** Concurrency conflict details */
+    concurrencyConflict?: {
+        entityType: string;
+        entityId: string;
+        expectedVersion: number;
+        actualVersion: number;
+    };
+    /** Emitted events during command execution */
+    emittedEvents?: string[];
+}
+export interface AgentRuntimeOptions {
+    /**
+     * Prefix for built-in introspection tools.
+     * @default 'manifest'
+     */
+    builtinPrefix?: string;
+    /**
+     * Tool name sanitization strategy.
+     * @default 'snake'
+     */
+    toolNameStrategy?: 'snake' | 'dot';
+}
+export type { IR, IREntity, IRCommand, IRParameter, IRExpression, IRType, IRValue };
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * SDK types for @manifest/agent-sdk
+ * All types here are SDK-specific and don't duplicate ir.ts types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/manifest/agent-sdk/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/manifest/api-diagnostics.d.ts

@@ -0,0 +1,41 @@
+import type { CommandResult, EmittedEvent } from './runtime-engine.js';
+/**
+ * Normalized diagnostic structure for API responses.
+ * Provides a consistent shape for all runtime failures at the API boundary.
+ */
+export interface RuntimeDiagnostic {
+    kind: 'guard_failure' | 'policy_denial' | 'constraint_block' | 'constraint_warn' | 'runtime_error';
+    entity: string;
+    command: string;
+    ruleName?: string;
+    message: string;
+    resolved?: Array<{
+        expression: string;
+        value: unknown;
+    }>;
+    details?: Record<string, unknown>;
+}
+/**
+ * Normalized command result for API responses.
+ * Converts runtime CommandResult into a consistent API contract.
+ */
+export interface NormalizedCommandResult {
+    success: boolean;
+    error?: string;
+    diagnostics?: RuntimeDiagnostic[];
+    data?: unknown;
+    events: EmittedEvent[];
+}
+/**
+ * Normalize a CommandResult into a consistent API response shape.
+ *
+ * This function bridges the gap between the runtime's CommandResult structure
+ * and a consistent API contract that surfaces all diagnostic information.
+ *
+ * @param entityName - Name of the entity the command operates on
+ * @param commandName - Name of the command being executed
+ * @param result - CommandResult from RuntimeEngine.runCommand()
+ * @returns Normalized result with consistent diagnostic structure
+ */
+export declare function normalizeCommandResult(entityName: string, commandName: string, result: CommandResult): NormalizedCommandResult;
+//# sourceMappingURL=api-diagnostics.d.ts.map

package/dist/manifest/api-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-diagnostics.d.ts","sourceRoot":"","sources":["../../src/manifest/api-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IACnG,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,GACpB,uBAAuB,CA0EzB"}