aui-agent-builder 0.1.0

package/dist/types/integration.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Integration types for AUI Agent Builder
+ *
+ * Integrations define API connections, RAG knowledge bases, MCP servers,
+ * and other external services that tools can invoke.
+ */
+import { IntegrationType, HttpMethod, AuthType, ValueSource } from './base';
+/**
+ * Authentication configuration for an endpoint
+ */
+export interface EndpointAuth {
+    /** Authentication method */
+    type: AuthType;
+    /** Bearer token value or env var reference (e.g. "$MY_TOKEN") */
+    token?: string;
+    /** API key value or env var reference */
+    apiKey?: string;
+    /** Custom header name for API key auth */
+    headerName?: string;
+    /** Username for basic auth */
+    username?: string;
+    /** Password for basic auth */
+    password?: string;
+}
+/**
+ * HTTP endpoint configuration
+ */
+export interface Endpoint {
+    /** URL template - supports {{param}} placeholders (e.g. "https://api.example.com/users/{{id}}") */
+    url: string;
+    /** HTTP method */
+    method: HttpMethod;
+    /** Authentication configuration */
+    authentication?: EndpointAuth;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+/**
+ * A field in the API request schema.
+ * Defines what data the integration needs and where it comes from.
+ */
+export interface RequestSchemaField {
+    /** Field name in the API request */
+    key: string;
+    /** Whether this field is required */
+    required: boolean;
+    /** Description of what this field is for */
+    description: string;
+    /** Data type */
+    type: 'STRING' | 'NUMBER' | 'BOOLEAN' | 'ENUM' | 'OBJECT' | 'ARRAY';
+    /** Where the value comes from */
+    value_source: ValueSource;
+    /** Parameter codes to pull value from (for user_profile, context, entities sources) */
+    params: string[];
+    /** Entity codes to pull value from (for entities source) */
+    entities: string[];
+    /** Allowed values (for ENUM type) */
+    values: string[];
+    /** Default value (for default source) */
+    default_value: string;
+}
+/**
+ * A single field mapping from API response to a parameter
+ */
+export interface ResponseFieldMapping {
+    /** JSON path keys to the value in the response */
+    key: string[];
+    /** Human-readable label */
+    label: string;
+    /** Parameter code to map to */
+    param: string;
+    /** Whether to show this to the user */
+    show: boolean;
+    /** Example value from response */
+    sample?: unknown;
+}
+/**
+ * A group of response mappings (maps response data to an entity)
+ */
+export interface ResponseMappingGroup {
+    /** Name of the mapping group (usually entity name) */
+    name: string;
+    /** JSON path prefixes */
+    paths: string[];
+    /** Field mappings */
+    mappings: ResponseFieldMapping[];
+}
+/**
+ * Response mapping configuration.
+ * Maps API response fields to AUI parameters.
+ */
+export interface ResponseMapping {
+    [category: string]: ResponseMappingGroup[];
+}
+/**
+ * RAG (Retrieval Augmented Generation) settings
+ */
+export interface RAGSettings {
+    /** Number of top results from search */
+    search_top_k: number;
+    /** Number of results after reranking */
+    ranker_top_k: number;
+    /** Reranker model (null for default) */
+    ranker_model: string | null;
+    /** Minimum confidence threshold */
+    confidence_threshold: number;
+    /** Knowledge base identifier */
+    knowledge_base_id: string;
+    /** Parent knowledge base IDs */
+    parent_knowledge_base_ids: string[];
+    /** Whether to allow multiple RAG calls */
+    allow_multiple_calls: boolean;
+    /** Placeholder values for RAG queries */
+    placeholders: string[];
+}
+/**
+ * API integration settings
+ */
+export interface APIIntegrationSettings {
+    /** HTTP endpoint configuration */
+    endpoint: Endpoint | null;
+    /** Request schema fields */
+    request_schema: RequestSchemaField[];
+    /** Response mapping (auto-generated after test_curl execution) */
+    response_mapping: ResponseMapping;
+    /** Curl command for testing the integration */
+    test_curl?: string;
+    /** Guidelines for query construction */
+    query_guidelines?: string;
+}
+/**
+ * Full integration definition
+ */
+export interface Integration {
+    /** Integration type */
+    type: IntegrationType;
+    /** Unique code identifier (kebab-case) */
+    code: string;
+    /** API integration settings (when type is "API") */
+    settings?: APIIntegrationSettings | RAGSettings;
+    /** Description of what this integration does */
+    description?: string;
+}
+/**
+ * Integrations file structure (integrations.aui.json)
+ */
+export interface IntegrationsFile {
+    $schema?: string;
+    integrations: Integration[];
+}
+//# sourceMappingURL=integration.d.ts.map

package/dist/types/integration.d.ts.map

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

package/dist/types/integration.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Integration types for AUI Agent Builder
+ *
+ * Integrations define API connections, RAG knowledge bases, MCP servers,
+ * and other external services that tools can invoke.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=integration.js.map

package/dist/types/integration.js.map

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

package/dist/types/parameter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Parameter types for AUI Agent Builder
+ *
+ * Parameters are the fundamental data units in AUI.
+ * They represent pieces of information the agent needs to collect,
+ * track, or output during conversations.
+ */
+import { ParameterType, UsageType } from './base';
+/**
+ * A parameter definition.
+ *
+ * Parameters are referenced by their `code` (kebab-case identifier) across
+ * entities, tools, integrations, and rules.
+ */
+export interface Parameter {
+    /** Unique identifier (kebab-case, e.g. "transaction-id") */
+    code: string;
+    /** Human-readable description - also serves as extraction guidance for the LLM */
+    description: string;
+    /** Data type */
+    type: ParameterType;
+    /** Whether this is an input, output, or both */
+    usage: UsageType;
+    /** Allowed values (for enum types) */
+    values?: string[];
+    /** Nested parameter codes (for object/list_of_objects types) */
+    nested_params?: string[];
+    /** Question to ask when collecting this parameter */
+    question?: string;
+}
+/**
+ * Parameters file structure (parameters.aui.json)
+ */
+export interface ParametersFile {
+    $schema?: string;
+    parameters: Parameter[];
+}
+//# sourceMappingURL=parameter.d.ts.map

package/dist/types/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../src/types/parameter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,KAAK,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB"}

package/dist/types/parameter.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Parameter types for AUI Agent Builder
+ *
+ * Parameters are the fundamental data units in AUI.
+ * They represent pieces of information the agent needs to collect,
+ * track, or output during conversations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parameter.js.map

package/dist/types/parameter.js.map

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

package/dist/types/rule.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Rule types for AUI Agent Builder
+ *
+ * Rules define conditional logic that controls agent behavior:
+ * - Pre-rules: Constraints, required parameters, missing info checks
+ * - Post-rules (summary): Success/fail handling after integration execution
+ */
+import { WhenMethod, OperatorType, ThenAction } from './base';
+/**
+ * A single WHEN condition
+ */
+export interface Condition {
+    /** The method/check to evaluate */
+    method?: WhenMethod;
+    /** Parameter codes to check */
+    params?: string[];
+    /** Comparison operator */
+    operation?: OperatorType;
+    /** Value to compare against */
+    value?: string | number | boolean;
+}
+/**
+ * Group of conditions supporting AND/OR/NOT nesting
+ */
+export interface ConditionGroup {
+    /** All conditions must be true (AND) */
+    all?: (Condition | ConditionGroup)[];
+    /** Any condition must be true (OR) */
+    any?: (Condition | ConditionGroup)[];
+    /** Negate a condition (NOT) */
+    not?: Condition | ConditionGroup;
+    /** Shortcut: single condition method (for simple triggers) */
+    method?: WhenMethod;
+    /** Shortcut: operation for simple conditions */
+    operation?: OperatorType;
+    /** Shortcut: value for simple conditions */
+    value?: string;
+}
+/**
+ * THEN clause for tool activation settings
+ */
+export interface ToolActivationSettings {
+    tools: Array<{
+        name: string;
+        description: string;
+        guidelines?: string | null;
+    }>;
+}
+/**
+ * THEN action clause
+ */
+export interface RuleThen {
+    /** Action to take */
+    action?: ThenAction;
+    /** Message to display or instruction for the LLM */
+    message?: string;
+    /** Parameters to require */
+    params?: {
+        mandatory?: string[];
+        optional?: string[];
+    };
+    /** Tool activation settings */
+    settings?: ToolActivationSettings;
+}
+/**
+ * A complete rule definition
+ */
+export interface Rule {
+    /** Human-readable description */
+    description?: string | null;
+    /** WHEN conditions */
+    when: ConditionGroup;
+    /** THEN action */
+    then: RuleThen;
+}
+/**
+ * Pre-execution rules (before integration call)
+ */
+export interface PreRules {
+    /** Constraint rules that block execution */
+    constraint?: Rule[];
+    /** Rules that dynamically require parameters */
+    required_parameters?: Rule[];
+    /** Rules that check for missing info */
+    missing_info?: Rule[];
+}
+/**
+ * Post-execution / summary rules
+ */
+export interface SummaryRules {
+    /** Rules for successful integration responses */
+    success?: Rule[];
+    /** Rules for failed integration responses */
+    fail?: Rule[];
+    /** Rules for missing information after execution */
+    missing_info?: Rule[];
+}
+/**
+ * Tool-level rules
+ */
+export interface ToolRules {
+    /** Pre-execution rules */
+    pre?: PreRules;
+    /** Post-execution / summary rules */
+    summary?: SummaryRules;
+}
+/**
+ * Global rules (applies across tools, scoped by applies_to)
+ */
+export interface GlobalRule extends Rule {
+    /** Tool codes this rule applies to (empty = all tools) */
+    applies_to?: string[];
+}
+/**
+ * Global rules file structure (rules.aui.json)
+ */
+export interface RulesFile {
+    $schema?: string;
+    rules: {
+        pre?: {
+            constraint?: GlobalRule[];
+        };
+    };
+}
+//# sourceMappingURL=rule.d.ts.map

package/dist/types/rule.d.ts.map

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

package/dist/types/rule.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Rule types for AUI Agent Builder
+ *
+ * Rules define conditional logic that controls agent behavior:
+ * - Pre-rules: Constraints, required parameters, missing info checks
+ * - Post-rules (summary): Success/fail handling after integration execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rule.js.map

package/dist/types/rule.js.map

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

package/dist/types/tool.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Tool types for AUI Agent Builder
+ *
+ * Tools are the primary capabilities of an agent. Each tool defines:
+ * - When it activates (triggers/objective)
+ * - What parameters it needs (required/optional)
+ * - What integrations it calls (in order)
+ * - Rules for pre/post execution behavior
+ */
+import { ConditionGroup, ToolRules } from './rule';
+/**
+ * Integration reference within a tool
+ */
+export interface ToolIntegrationRef {
+    /** Integration code (from integrations.aui.json) */
+    code: string;
+}
+/**
+ * Trigger configuration
+ */
+export interface ToolTrigger {
+    when: ConditionGroup;
+}
+/**
+ * Tool parameter configuration
+ *
+ * Required params can be:
+ * - A string: that single parameter is required
+ * - An array of strings: OR group - at least one must be provided
+ *
+ * @example
+ * required: ["dispute-reason", ["email", "phone"]]
+ * // dispute-reason is always required
+ * // PLUS either email OR phone must be provided
+ */
+export interface ToolParams {
+    /** Required parameters (strings or OR-groups as arrays) */
+    required: Array<string | string[]>;
+    /** Optional parameters */
+    optional: string[];
+}
+/**
+ * Tool config (triggers + params)
+ */
+export interface ToolConfig {
+    /** Trigger conditions */
+    triggers: ToolTrigger;
+    /** Parameter requirements */
+    params: ToolParams;
+}
+/**
+ * Available context for a tool (entities it can reference)
+ */
+export interface ToolAvailableContext {
+    entities: string[];
+}
+/**
+ * Complete tool definition
+ */
+export interface Tool {
+    /** Unique identifier (SCREAMING_SNAKE_CASE, e.g. "CREATE_FRAUD_DISPUTE") */
+    code: string;
+    /** When this tool should activate - natural language description */
+    objective: string;
+    /** Whether this tool is enabled */
+    status: boolean;
+    /** Whether the agent can activate this directly (true) or only via triggers/other tools (false) */
+    main_tool: boolean;
+    /** Whether to ask user for confirmation before executing */
+    requires_confirmation: boolean;
+    /** Response display type */
+    response_type: 'text' | 'text_and_widget';
+    /** Response brevity preference */
+    brevity: string;
+    /** Override agent tone for this tool */
+    tone_of_voice: string;
+    /** Tool configuration (triggers and params) */
+    config: ToolConfig;
+    /** Ordered list of integrations to execute */
+    integrations: ToolIntegrationRef[];
+    /** Available context entities */
+    available_context?: ToolAvailableContext;
+    /** LLM model override for this tool */
+    summary_model?: string;
+    /** Tool rules (pre and post/summary) */
+    rules: ToolRules;
+}
+/**
+ * Tool file structure (tools/*.aui.json)
+ */
+export interface ToolFile {
+    $schema?: string;
+    tool: Tool;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACnC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,6BAA6B;IAC7B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,mGAAmG;IACnG,SAAS,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4BAA4B;IAC5B,aAAa,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC1C,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,MAAM,EAAE,UAAU,CAAC;IACnB,8CAA8C;IAC9C,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ"}

package/dist/types/tool.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Tool types for AUI Agent Builder
+ *
+ * Tools are the primary capabilities of an agent. Each tool defines:
+ * - When it activates (triggers/objective)
+ * - What parameters it needs (required/optional)
+ * - What integrations it calls (in order)
+ * - Rules for pre/post execution behavior
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Utility functions for AUI Agent Builder
+ */
+import { AgentExport } from '../types';
+/**
+ * Find all .aui.json files in a directory
+ */
+export declare function findAuiFiles(dir: string): Promise<string[]>;
+/**
+ * Parse a single .aui.json file
+ */
+export declare function parseAuiFile(filePath: string): Record<string, unknown> | null;
+/**
+ * Read all agent files from a project directory and build an AgentExport
+ */
+export declare function readAgentFiles(projectDir: string): Promise<AgentExport>;
+/**
+ * Write agent export data as files to a directory
+ */
+export declare function writeAgentFiles(projectDir: string, data: AgentExport): Promise<string[]>;
+/**
+ * Write JSON to a file with pretty formatting
+ */
+export declare function writeJsonFile(filePath: string, data: unknown): void;
+export interface ValidationIssue {
+    type: 'error' | 'warning';
+    file?: string;
+    path?: string;
+    message: string;
+}
+/**
+ * Validate cross-file references (parameters referenced in entities, tools, etc.)
+ */
+export declare function validateReferences(data: AgentExport): ValidationIssue[];
+/**
+ * Format a relative time string
+ */
+export declare function formatRelativeTime(iso: string): string;
+/**
+ * Convert a string to kebab-case
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Convert a string to SCREAMING_SNAKE_CASE
+ */
+export declare function toScreamingSnakeCase(str: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAML,WAAW,EACZ,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMjE;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAO7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmC7E;AAID;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2D9F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnE;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,EAAE,CA8DvE;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxD"}