@bluefly/openstandardagents 0.4.3 → 0.4.5

package/dist/adapters/base/perfect-agent-utils.js

@@ -0,0 +1,234 @@
+/**
+ * Perfect Agent Utilities
+ *
+ * Utility functions for generating "perfect agent" export bundles.
+ * Provides skill file generation, eval stubs, governance config, and
+ * observability setup reusable across all platform adapters.
+ *
+ * SOLID: Single Responsibility - Perfect agent utilities only
+ * DRY: Reusable across all adapters
+ */
+// ──────────────────────────────────────────────────────────────────
+// Skill Content Generation
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate SKILL.md content from an OSSA manifest
+ */
+export function generateSkillContent(manifest) {
+    const name = manifest.metadata?.name || 'agent';
+    const description = manifest.metadata?.description || '';
+    const role = manifest.spec?.role || '';
+    const tools = manifest.spec?.tools || [];
+    const sections = [];
+    sections.push(`---`);
+    sections.push(`name: ${name}`);
+    sections.push(`description: ${description}`);
+    if (manifest.metadata?.version) {
+        sections.push(`version: ${manifest.metadata.version}`);
+    }
+    sections.push(`---\n`);
+    if (role) {
+        sections.push(`# System Prompt\n\n${role}\n`);
+    }
+    if (tools.length > 0) {
+        sections.push(`# Tools\n`);
+        for (const tool of tools) {
+            sections.push(`- **${tool.name || tool.type}**: ${tool.description || 'No description'}`);
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+// ──────────────────────────────────────────────────────────────────
+// CLEAR Framework Eval Stubs
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate CLEAR framework evaluation stubs
+ */
+export function generateEvalStubs(manifest) {
+    const name = manifest.metadata?.name || 'agent';
+    const content = `/**
+ * ${name} - CLEAR Framework Evaluation Stubs
+ * Generated from OSSA manifest
+ *
+ * CLEAR = Correctness, Latency, Efficiency, Accuracy, Robustness
+ *
+ * Implement these evaluation functions for your agent.
+ */
+
+export interface EvalResult {
+  metric: string;
+  score: number;
+  threshold: number;
+  passed: boolean;
+  details?: string;
+}
+
+export interface EvalSuite {
+  name: string;
+  run(): Promise<EvalResult[]>;
+}
+
+/**
+ * Correctness: Does the agent produce correct outputs?
+ */
+export async function evalCorrectness(): Promise<EvalResult> {
+  // TODO: Implement correctness evaluation
+  return {
+    metric: 'correctness',
+    score: 0,
+    threshold: 0.9,
+    passed: false,
+    details: 'Not implemented - add test cases',
+  };
+}
+
+/**
+ * Latency: Does the agent respond within time constraints?
+ */
+export async function evalLatency(): Promise<EvalResult> {
+  const timeout = ${manifest.spec?.constraints?.performance?.timeoutSeconds || 30};
+  // TODO: Implement latency evaluation
+  return {
+    metric: 'latency',
+    score: 0,
+    threshold: timeout,
+    passed: false,
+    details: \`Target: <\${timeout}s\`,
+  };
+}
+
+/**
+ * Efficiency: Does the agent use resources efficiently?
+ */
+export async function evalEfficiency(): Promise<EvalResult> {
+  const maxTokens = ${manifest.spec?.constraints?.cost?.maxTokensPerRequest || 4096};
+  // TODO: Implement efficiency evaluation
+  return {
+    metric: 'efficiency',
+    score: 0,
+    threshold: maxTokens,
+    passed: false,
+    details: \`Max tokens per request: \${maxTokens}\`,
+  };
+}
+
+/**
+ * Accuracy: Does the agent maintain factual accuracy?
+ */
+export async function evalAccuracy(): Promise<EvalResult> {
+  // TODO: Implement accuracy evaluation
+  return {
+    metric: 'accuracy',
+    score: 0,
+    threshold: 0.95,
+    passed: false,
+    details: 'Not implemented - add golden dataset',
+  };
+}
+
+/**
+ * Robustness: Does the agent handle edge cases?
+ */
+export async function evalRobustness(): Promise<EvalResult> {
+  // TODO: Implement robustness evaluation
+  return {
+    metric: 'robustness',
+    score: 0,
+    threshold: 0.85,
+    passed: false,
+    details: 'Not implemented - add adversarial tests',
+  };
+}
+
+/**
+ * Run full CLEAR evaluation suite
+ */
+export async function runClearEvals(): Promise<EvalResult[]> {
+  return Promise.all([
+    evalCorrectness(),
+    evalLatency(),
+    evalEfficiency(),
+    evalAccuracy(),
+    evalRobustness(),
+  ]);
+}
+`;
+    return {
+        path: 'evals/clear-evals.ts',
+        content,
+        type: 'test',
+        language: 'typescript',
+    };
+}
+// ──────────────────────────────────────────────────────────────────
+// Governance Configuration
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate governance/compliance configuration
+ */
+export function generateGovernanceConfig(manifest) {
+    const name = manifest.metadata?.name || 'agent';
+    const autonomy = manifest.spec?.autonomy;
+    const policies = manifest.spec?.policies || [];
+    const config = {
+        agent: name,
+        version: manifest.metadata?.version || '1.0.0',
+        autonomy: {
+            level: autonomy?.level || 'supervised',
+            approvalRequired: autonomy?.approval_required ?? true,
+            allowedActions: autonomy?.allowed_actions || [],
+            blockedActions: autonomy?.blocked_actions || [],
+        },
+        policies: policies.map((p) => ({
+            name: p.name,
+            type: p.type,
+            rulesCount: Array.isArray(p.rules) ? p.rules.length : 0,
+        })),
+        compliance: {
+            dataRetention: '30d',
+            auditLog: true,
+            humanInLoop: autonomy?.approval_required ?? true,
+        },
+    };
+    return {
+        path: 'governance/policy.json',
+        content: JSON.stringify(config, null, 2),
+        type: 'config',
+        language: 'json',
+    };
+}
+// ──────────────────────────────────────────────────────────────────
+// Observability Setup
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate observability configuration (OTel traces/metrics)
+ */
+export function generateObservabilityConfig(manifest) {
+    const name = manifest.metadata?.name || 'agent';
+    const obs = manifest.spec?.observability;
+    const config = {
+        serviceName: name,
+        tracing: {
+            enabled: obs?.tracing?.enabled ?? true,
+            exporter: obs?.tracing?.exporter || 'otlp',
+            endpoint: obs?.tracing?.endpoint || 'http://localhost:4318/v1/traces',
+        },
+        metrics: {
+            enabled: obs?.metrics?.enabled ?? true,
+            exporter: obs?.metrics?.exporter || 'otlp',
+            endpoint: obs?.metrics?.endpoint || 'http://localhost:4318/v1/metrics',
+        },
+        logging: {
+            level: obs?.logging?.level || 'info',
+            format: obs?.logging?.format || 'json',
+        },
+    };
+    return {
+        path: 'observability/otel-config.json',
+        content: JSON.stringify(config, null, 2),
+        type: 'config',
+        language: 'json',
+    };
+}
+//# sourceMappingURL=perfect-agent-utils.js.map

package/dist/adapters/base/perfect-agent-utils.js.map

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

package/dist/adapters/base/template-engine.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Simple Mustache-style Template Engine
+ *
+ * Zero external dependencies. Supports variable interpolation
+ * and conditional blocks for generating adapter output files.
+ *
+ * SOLID: Single Responsibility - Template rendering only
+ * DRY: Reusable across all adapters instead of inline string concatenation
+ */
+/**
+ * Template data - flat key/value pairs for interpolation.
+ * Values can be strings, numbers, booleans, arrays, or undefined.
+ */
+export type TemplateData = Record<string, string | number | boolean | string[] | undefined>;
+/**
+ * Render a template string by replacing {{variable}} placeholders
+ * with values from the data object.
+ *
+ * Missing keys are replaced with empty strings.
+ *
+ * @param template - Template string with {{variable}} placeholders
+ * @param data - Key/value pairs for interpolation
+ * @returns Rendered string
+ */
+export declare function render(template: string, data: TemplateData): string;
+/**
+ * Render a template with conditional block support.
+ *
+ * Supports:
+ *   {{#if key}}...content...{{/if}} - Include block when key is truthy
+ *   {{#unless key}}...content...{{/unless}} - Include block when key is falsy
+ *   {{#each items}}...{{.}}...{{/each}} - Iterate over string arrays
+ *   {{variable}} - Standard variable interpolation
+ *
+ * @param template - Template with conditionals and variables
+ * @param data - Key/value pairs for interpolation and conditionals
+ * @returns Rendered string
+ */
+export declare function renderConditional(template: string, data: TemplateData): string;
+/**
+ * README template with platform-specific sections.
+ * Variables: name, description, role, platform, version, license,
+ *            installCommand, usageCode, toolsList, llmProvider, llmModel,
+ *            llmTemperature, llmMaxTokens, apiVersion
+ */
+export declare const README_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Description\n\n{{role}}\n\n## Installation\n\n```bash\n{{installCommand}}\n```\n\n## Usage\n\n```\n{{usageCode}}\n```\n\n{{#if toolsList}}\n## Tools\n\n{{toolsList}}\n{{/if}}\n\n{{#if llmProvider}}\n## LLM Configuration\n\n- **Provider**: {{llmProvider}}\n- **Model**: {{llmModel}}\n- **Temperature**: {{llmTemperature}}\n- **Max Tokens**: {{llmMaxTokens}}\n{{/if}}\n\n## Generated from OSSA\n\nThis agent was generated from an OSSA {{apiVersion}} manifest.\n\nOriginal manifest: `agent.ossa.yaml`\n\n## License\n\n{{license}}\n";
+/**
+ * INSTALL section template.
+ * Variables: platform, installCommand, setupSteps
+ */
+export declare const INSTALL_TEMPLATE = "## Installation\n\n### Prerequisites\n\n{{#if prerequisites}}\n{{prerequisites}}\n{{/if}}\n\n### Setup\n\n```bash\n{{installCommand}}\n```\n\n{{#if setupSteps}}\n{{setupSteps}}\n{{/if}}\n";
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/adapters/base/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../../src/adapters/base/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAWnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GACjB,MAAM,CAmDR;AAMD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,yjBA4C3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gMAiB5B,CAAC"}

package/dist/adapters/base/template-engine.js

@@ -0,0 +1,157 @@
+/**
+ * Simple Mustache-style Template Engine
+ *
+ * Zero external dependencies. Supports variable interpolation
+ * and conditional blocks for generating adapter output files.
+ *
+ * SOLID: Single Responsibility - Template rendering only
+ * DRY: Reusable across all adapters instead of inline string concatenation
+ */
+/**
+ * Render a template string by replacing {{variable}} placeholders
+ * with values from the data object.
+ *
+ * Missing keys are replaced with empty strings.
+ *
+ * @param template - Template string with {{variable}} placeholders
+ * @param data - Key/value pairs for interpolation
+ * @returns Rendered string
+ */
+export function render(template, data) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        const value = data[key];
+        if (value === undefined || value === null) {
+            return '';
+        }
+        if (Array.isArray(value)) {
+            return value.join(', ');
+        }
+        return String(value);
+    });
+}
+/**
+ * Render a template with conditional block support.
+ *
+ * Supports:
+ *   {{#if key}}...content...{{/if}} - Include block when key is truthy
+ *   {{#unless key}}...content...{{/unless}} - Include block when key is falsy
+ *   {{#each items}}...{{.}}...{{/each}} - Iterate over string arrays
+ *   {{variable}} - Standard variable interpolation
+ *
+ * @param template - Template with conditionals and variables
+ * @param data - Key/value pairs for interpolation and conditionals
+ * @returns Rendered string
+ */
+export function renderConditional(template, data) {
+    let result = template;
+    // Process {{#each items}}...{{.}}...{{/each}} blocks
+    result = result.replace(/\{\{#each (\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        if (!Array.isArray(value) || value.length === 0) {
+            return '';
+        }
+        return value.map((item) => content.replace(/\{\{\.\}\}/g, item)).join('');
+    });
+    // Process {{#if key}}...{{/if}} blocks
+    result = result.replace(/\{\{#if (\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        const isTruthy = value !== undefined &&
+            value !== null &&
+            value !== false &&
+            value !== '' &&
+            value !== 0 &&
+            !(Array.isArray(value) && value.length === 0);
+        return isTruthy ? content : '';
+    });
+    // Process {{#unless key}}...{{/unless}} blocks
+    result = result.replace(/\{\{#unless (\w+)\}\}([\s\S]*?)\{\{\/unless\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        const isFalsy = value === undefined ||
+            value === null ||
+            value === false ||
+            value === '' ||
+            value === 0 ||
+            (Array.isArray(value) && value.length === 0);
+        return isFalsy ? content : '';
+    });
+    // Standard variable interpolation
+    result = render(result, data);
+    return result;
+}
+// ──────────────────────────────────────────────────────────────────
+// Built-in templates for common patterns
+// ──────────────────────────────────────────────────────────────────
+/**
+ * README template with platform-specific sections.
+ * Variables: name, description, role, platform, version, license,
+ *            installCommand, usageCode, toolsList, llmProvider, llmModel,
+ *            llmTemperature, llmMaxTokens, apiVersion
+ */
+export const README_TEMPLATE = `# {{name}}
+
+{{description}}
+
+## Description
+
+{{role}}
+
+## Installation
+
+\`\`\`bash
+{{installCommand}}
+\`\`\`
+
+## Usage
+
+\`\`\`
+{{usageCode}}
+\`\`\`
+
+{{#if toolsList}}
+## Tools
+
+{{toolsList}}
+{{/if}}
+
+{{#if llmProvider}}
+## LLM Configuration
+
+- **Provider**: {{llmProvider}}
+- **Model**: {{llmModel}}
+- **Temperature**: {{llmTemperature}}
+- **Max Tokens**: {{llmMaxTokens}}
+{{/if}}
+
+## Generated from OSSA
+
+This agent was generated from an OSSA {{apiVersion}} manifest.
+
+Original manifest: \`agent.ossa.yaml\`
+
+## License
+
+{{license}}
+`;
+/**
+ * INSTALL section template.
+ * Variables: platform, installCommand, setupSteps
+ */
+export const INSTALL_TEMPLATE = `## Installation
+
+### Prerequisites
+
+{{#if prerequisites}}
+{{prerequisites}}
+{{/if}}
+
+### Setup
+
+\`\`\`bash
+{{installCommand}}
+\`\`\`
+
+{{#if setupSteps}}
+{{setupSteps}}
+{{/if}}
+`;
+//# sourceMappingURL=template-engine.js.map

package/dist/adapters/base/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../../src/adapters/base/template-engine.ts"],"names":[],"mappings":"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"}

package/dist/adapters/base/tool-params.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared utility for generating typed tool parameters from JSON Schema
+ * Used by CrewAI, LangChain, and other Python/TS adapters
+ */
+interface ToolSchema {
+    name?: string;
+    description?: string;
+    type?: string;
+    input_schema?: JsonSchema;
+    inputSchema?: JsonSchema;
+    schema?: JsonSchema;
+    parameters?: JsonSchema;
+}
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+}
+interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: string[];
+    default?: any;
+    items?: {
+        type?: string;
+    };
+}
+/**
+ * Generate Python function signature from tool schema
+ * Returns: { params: "name: str, age: int = 0", imports: Set<string> }
+ */
+export declare function generatePythonToolParams(tool: ToolSchema): {
+    params: string;
+    imports: Set<string>;
+    docParams: string;
+};
+/**
+ * Generate TypeScript interface from tool schema
+ */
+export declare function generateTSToolInterface(tool: ToolSchema): string;
+export {};
+//# sourceMappingURL=tool-params.d.ts.map

package/dist/adapters/base/tool-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-params.d.ts","sourceRoot":"","sources":["../../../src/adapters/base/tool-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AA6BD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAsDA;AA0BD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAsBhE"}

package/dist/adapters/base/tool-params.js

@@ -0,0 +1,123 @@
+/**
+ * Shared utility for generating typed tool parameters from JSON Schema
+ * Used by CrewAI, LangChain, and other Python/TS adapters
+ */
+/**
+ * Map JSON Schema type to Python type hint
+ */
+function jsonTypeToPython(prop) {
+    switch (prop.type) {
+        case 'string':
+            return prop.enum
+                ? `Literal[${prop.enum.map((e) => `"${e}"`).join(', ')}]`
+                : 'str';
+        case 'integer':
+            return 'int';
+        case 'number':
+            return 'float';
+        case 'boolean':
+            return 'bool';
+        case 'array':
+            const itemType = prop.items?.type
+                ? jsonTypeToPython({ type: prop.items.type })
+                : 'Any';
+            return `list[${itemType}]`;
+        case 'object':
+            return 'dict';
+        default:
+            return 'str';
+    }
+}
+/**
+ * Generate Python function signature from tool schema
+ * Returns: { params: "name: str, age: int = 0", imports: Set<string> }
+ */
+export function generatePythonToolParams(tool) {
+    const schema = tool.input_schema || tool.inputSchema || tool.schema || tool.parameters;
+    const imports = new Set();
+    if (!schema?.properties || Object.keys(schema.properties).length === 0) {
+        return {
+            params: 'input_data: str',
+            imports,
+            docParams: '    input_data: Input data for the tool',
+        };
+    }
+    const required = new Set(schema.required || []);
+    const params = [];
+    const docLines = [];
+    // Required params first, then optional
+    const entries = Object.entries(schema.properties);
+    const sortedEntries = [
+        ...entries.filter(([name]) => required.has(name)),
+        ...entries.filter(([name]) => !required.has(name)),
+    ];
+    for (const [name, prop] of sortedEntries) {
+        const pyType = jsonTypeToPython(prop);
+        if (pyType.startsWith('Literal[')) {
+            imports.add('from typing import Literal');
+        }
+        if (pyType === 'Any') {
+            imports.add('from typing import Any');
+        }
+        const isRequired = required.has(name);
+        const defaultVal = prop.default !== undefined
+            ? ` = ${JSON.stringify(prop.default)}`
+            : isRequired
+                ? ''
+                : ' = None';
+        const optionalType = isRequired ? pyType : `${pyType} | None`;
+        params.push(`${name}: ${isRequired ? pyType : optionalType}${defaultVal}`);
+        const desc = prop.description || `${name} parameter`;
+        docLines.push(`    ${name}: ${desc}`);
+    }
+    return {
+        params: params.join(', '),
+        imports,
+        docParams: docLines.join('\n'),
+    };
+}
+/**
+ * Map JSON Schema type to TypeScript type
+ */
+function jsonTypeToTS(prop) {
+    switch (prop.type) {
+        case 'string':
+            return prop.enum ? prop.enum.map((e) => `'${e}'`).join(' | ') : 'string';
+        case 'integer':
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'array':
+            const itemType = prop.items?.type
+                ? jsonTypeToTS({ type: prop.items.type })
+                : 'unknown';
+            return `${itemType}[]`;
+        case 'object':
+            return 'Record<string, unknown>';
+        default:
+            return 'string';
+    }
+}
+/**
+ * Generate TypeScript interface from tool schema
+ */
+export function generateTSToolInterface(tool) {
+    const schema = tool.input_schema || tool.inputSchema || tool.schema || tool.parameters;
+    const toolName = (tool.name || 'unknown').replace(/[^a-zA-Z0-9]/g, '');
+    const interfaceName = toolName.charAt(0).toUpperCase() + toolName.slice(1) + 'Input';
+    if (!schema?.properties || Object.keys(schema.properties).length === 0) {
+        return `interface ${interfaceName} { input: string; }`;
+    }
+    const required = new Set(schema.required || []);
+    const fields = Object.entries(schema.properties)
+        .map(([name, prop]) => {
+        const tsType = jsonTypeToTS(prop);
+        const optional = required.has(name) ? '' : '?';
+        const comment = prop.description ? ` // ${prop.description}` : '';
+        return `  ${name}${optional}: ${tsType};${comment}`;
+    })
+        .join('\n');
+    return `interface ${interfaceName} {\n${fields}\n}`;
+}
+//# sourceMappingURL=tool-params.js.map

package/dist/adapters/base/tool-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-params.js","sourceRoot":"","sources":["../../../src/adapters/base/tool-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAwB;IAChD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI;gBACd,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACzD,CAAC,CAAC,KAAK,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI;gBAC/B,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7C,CAAC,CAAC,KAAK,CAAC;YACV,OAAO,QAAQ,QAAQ,GAAG,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAgB;IAKvD,MAAM,MAAM,GACV,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,OAAO;YACP,SAAS,EAAE,yCAAyC;SACrD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uCAAuC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG;QACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;KACnD,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,UAAU,GACd,IAAI,CAAC,OAAO,KAAK,SAAS;YACxB,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACtC,CAAC,CAAC,UAAU;gBACV,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,SAAS,CAAC;QAElB,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,GAAG,UAAU,EAAE,CAAC,CAAC;QAE3E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,YAAY,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,OAAO;QACP,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAwB;IAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3E,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI;gBAC/B,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACzC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,GAAG,QAAQ,IAAI,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,yBAAyB,CAAC;QACnC;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAgB;IACtD,MAAM,MAAM,GACV,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;IAC1E,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,aAAa,GACjB,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAEjE,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,aAAa,aAAa,qBAAqB,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,IAAI,GAAG,QAAQ,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;IACtD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,aAAa,aAAa,OAAO,MAAM,KAAK,CAAC;AACtD,CAAC"}