aui-agent-builder 0.1.43 → 0.1.46

package/README.md

@@ -28,7 +28,7 @@ aui import-agent
 # 4. Edit the files in VSCode / Cursor (autocomplete works out of the box)
 
 # 5. Validate your changes
-aui validate
+aui dvalidate
 
 # 6. Push changes back to the backend
 aui push
@@ -112,41 +112,41 @@ Environment selection is saved to `~/.aui/environment`.
 
 ### Core Workflow
 
-| Command | Description |
-|---------|-------------|
-| `aui login` | Authenticate and select org → account → agent |
-| `aui env [env]` | Show or switch environment (staging/custom/production) |
-| `aui create-agent [dir]` | Scaffold a new blank agent project with examples |
-| `aui import-agent [id]` | Download an agent as local `.aui.json` files |
-| `aui validate [path]` | Validate `.aui.json` files for errors |
-| `aui push` | Upload local changes to the backend |
-| `aui status` | Show session, linked agent, and file summary |
-| `aui diff [a] [b]` | Compare two agent configurations |
+| Command                  | Description                                            |
+| ------------------------ | ------------------------------------------------------ |
+| `aui login`              | Authenticate and select org → account → agent          |
+| `aui env [env]`          | Show or switch environment (staging/custom/production) |
+| `aui create-agent [dir]` | Scaffold a new blank agent project with examples       |
+| `aui import-agent [id]`  | Download an agent as local `.aui.json` files           |
+| `aui dvalidate [path]`   | Validate `.aui.json` files for errors                  |
+| `aui push`               | Upload local changes to the backend                    |
+| `aui status`             | Show session, linked agent, and file summary           |
+| `aui diff [a] [b]`       | Compare two agent configurations                       |
 
 ### Management
 
-| Command | Description |
-|---------|-------------|
-| `aui accounts` | Manage accounts — list, create, switch |
-| `aui agents` | Manage agents — list, create, switch, import |
-| `aui list-agents` | Quick table view of agents in your account |
+| Command           | Description                                  |
+| ----------------- | -------------------------------------------- |
+| `aui accounts`    | Manage accounts — list, create, switch       |
+| `aui agents`      | Manage agents — list, create, switch, import |
+| `aui list-agents` | Quick table view of agents in your account   |
 
 ### Configuration
 
-| Command | Description |
-|---------|-------------|
-| `aui add-integration` | Add an integration (API, RAG, or MCP) |
-| `aui rag` | Manage RAG knowledge bases — upload, export, update |
-| `aui chat` | Interactive conversation with an agent |
+| Command               | Description                                         |
+| --------------------- | --------------------------------------------------- |
+| `aui add-integration` | Add an integration (API, RAG, or MCP)               |
+| `aui rag`             | Manage RAG knowledge bases — upload, export, update |
+| `aui chat`            | Interactive conversation with an agent              |
 
 ### Aliases
 
-| Alias | Equivalent |
-|-------|------------|
-| `aui import` | `aui import-agent` |
-| `aui account` | `aui accounts` |
-| `aui agent` | `aui agents` |
-| `aui ls` | `aui list-agents` |
+| Alias         | Equivalent         |
+| ------------- | ------------------ |
+| `aui import`  | `aui import-agent` |
+| `aui account` | `aui accounts`     |
+| `aui agent`   | `aui agents`       |
+| `aui ls`      | `aui list-agents`  |
 
 ## Account Management
 
@@ -157,6 +157,7 @@ aui accounts
 ```
 
 Interactive menu with options to:
+
 - **List** all accounts with status and creation date
 - **Create** a new account (org owner permission required)
 - **Switch** active account
@@ -178,6 +179,7 @@ aui agents
 ```
 
 Interactive menu with options to:
+
 - **List** all agents with current selection highlighted
 - **Switch** active agent
 - **Create** a new agent project (scaffolds local files)
@@ -220,6 +222,7 @@ aui import-agent --dir ./custom-folder
 ### Cross-Account and Cross-Org Import
 
 To import agents from a different account or organization, use the `aui agents` menu and select:
+
 - **Import from another account** — browse accounts in your current org
 - **Import from another organization** — browse all your organizations, then accounts, then agents
 
@@ -232,6 +235,7 @@ aui create-agent my-agent
 ```
 
 This creates a complete project with:
+
 - Example parameters, entities, integrations, tools, and rules
 - A `GUIDE.md` explaining every field and how to configure the agent
 - Schema autocomplete for VSCode and Cursor
@@ -305,13 +309,13 @@ The first time you run `aui rag`, you'll be prompted to paste your RAG API key.
 
 Running `aui rag` opens an interactive menu:
 
-| Option | What it does |
-|--------|-------------|
-| **List knowledge bases** | Shows all KBs for the current agent with IDs and scope |
-| **Upload files to a knowledge base** | Upload local files (PDF, CSV, TXT, etc.) to a new or existing KB |
-| **Upload URLs to a knowledge base** | Scrape web pages into a new or existing KB |
-| **Export knowledge bases** | Download all KB data to `aui.rag.json` in the current directory |
-| **Update from file** | Push an edited `aui.rag.json` back to the server (diff-based sync) |
+| Option                               | What it does                                                       |
+| ------------------------------------ | ------------------------------------------------------------------ |
+| **List knowledge bases**             | Shows all KBs for the current agent with IDs and scope             |
+| **Upload files to a knowledge base** | Upload local files (PDF, CSV, TXT, etc.) to a new or existing KB   |
+| **Upload URLs to a knowledge base**  | Scrape web pages into a new or existing KB                         |
+| **Export knowledge bases**           | Download all KB data to `aui.rag.json` in the current directory    |
+| **Update from file**                 | Push an edited `aui.rag.json` back to the server (diff-based sync) |
 
 ### Uploading Files
 
@@ -365,34 +369,34 @@ Skips the menu and goes straight to uploading. Choose between files or URLs, sel
 Check your configuration files for errors before pushing:
 
 ```bash
-aui validate
+aui dvalidate
 ```
 
-`aui validate` performs **CLI validation**:
+`aui dvalidate` performs **CLI validation**:
 
 - JSON syntax
 - Required fields (codes, types, objectives)
 - Cross-references (e.g. tools referencing unknown integrations; entities referencing unknown parameters)
 
-### Schema vs `aui validate` (important)
+### Schema vs `aui dvalidate` (important)
 
 When you import/create an agent, the CLI also writes:
 
-- **`.aui-schema/aui.schema.json`** (JSON Schema file)
+- **`.aui-schema/aui.dschema.json`** (JSON Schema file)
 - **`.vscode/settings.json`** (wires the schema for VSCode/Cursor)
 
 This provides **editor validation + autocomplete** (red squiggles, enum dropdowns, hover docs).
 
-That schema is **separate** from `aui validate`:
+That schema is **separate** from `aui dvalidate`:
 
 - **Schema**: editor-time, strict typing/shape checking for JSON files
-- **`aui validate`**: CLI-time checks + cross-reference integrity
+- **`aui dvalidate`**: CLI-time checks + cross-reference integrity
 
 If the backend introduces new fields (for example, the integrations schema expands in the V2 endpoints),
 your editor schema may need updating. Re-importing an agent refreshes `.aui-schema/`.
 
 ```bash
-aui validate --verbose    # Detailed output per file
+aui dvalidate --verbose    # Detailed output per file
 ```
 
 ## Pushing Changes
@@ -441,14 +445,14 @@ Env var override:
 
 The push command detects changes via git diff and pushes only what changed:
 
-| Resource | Method | What gets sent |
-|----------|--------|---------------|
-| **Tools (modified)** | PATCH | Only changed fields (name, objective, config, etc.) |
-| **Tools (new)** | POST | Full tool object |
-| **General Settings** | PATCH | Only changed fields |
-| **Parameters** | PUT | Full parameters data (upsert) |
-| **Entities** | PUT | Full entities data (upsert) |
-| **Rules** | PUT | Full rules data (upsert) |
+| Resource             | Method | What gets sent                                      |
+| -------------------- | ------ | --------------------------------------------------- |
+| **Tools (modified)** | PATCH  | Only changed fields (name, objective, config, etc.) |
+| **Tools (new)**      | POST   | Full tool object                                    |
+| **General Settings** | PATCH  | Only changed fields                                 |
+| **Parameters**       | PUT    | Full parameters data (upsert)                       |
+| **Entities**         | PUT    | Full entities data (upsert)                         |
+| **Rules**            | PUT    | Full rules data (upsert)                            |
 
 All changes are pushed **in parallel** for speed. After a successful push, the git baseline is updated so the next push only sends new changes.
 
@@ -509,14 +513,14 @@ aui chat --rest                   # REST only, no streaming
 
 ### Chat Commands
 
-| Command | Action |
-|---------|--------|
-| `/exit` | End conversation |
-| `/clear` | Clear screen |
-| `/history` | View message history |
+| Command    | Action                    |
+| ---------- | ------------------------- |
+| `/exit`    | End conversation          |
+| `/clear`   | Clear screen              |
+| `/history` | View message history      |
 | `/suggest` | Get follow-up suggestions |
-| `/task` | Show task ID |
-| `/help` | Show commands |
+| `/task`    | Show task ID              |
+| `/help`    | Show commands             |
 
 ## Configuration
 
@@ -534,29 +538,29 @@ aui chat --rest                   # REST only, no streaming
 
 ### Stored Files
 
-| File | Purpose |
-|------|---------|
-| `~/.aui/session.json` | Auth token, org, account, agent, environment |
-| `~/.aui/environment` | Selected environment (staging/custom/production) |
-| `~/.aui/kbm-key` | RAG API key (auto-saved on first use) |
+| File                        | Purpose                                                            |
+| --------------------------- | ------------------------------------------------------------------ |
+| `~/.aui/session.json`       | Auth token, org, account, agent, environment                       |
+| `~/.aui/environment`        | Selected environment (staging/custom/production)                   |
+| `~/.aui/kbm-key`            | RAG API key (auto-saved on first use)                              |
 | `~/.aui/agent-settings-key` | Agent Settings API key (fallback if Bearer token lacks permission) |
-| `~/.aui/api-workflow-key` | API Workflow key (required for `aui add-integration`) |
-| `.auirc` | Project config — links folder to a backend agent |
-| `aui.rag.json` | Exported RAG knowledge base data |
+| `~/.aui/api-workflow-key`   | API Workflow key (required for `aui add-integration`)              |
+| `.auirc`                    | Project config — links folder to a backend agent                   |
+| `aui.rag.json`              | Exported RAG knowledge base data                                   |
 
 ### Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `AUI_AUTH_TOKEN` | Auth token (skip login) |
-| `AUI_API_URL` | Override API base URL |
-| `AUI_ENVIRONMENT` | `staging`, `custom`, or `production` |
-| `AUI_ACCOUNT_ID` | Account ID |
-| `AUI_ORGANIZATION_ID` | Organization ID |
-| `AUI_AGENT_CODE` | Agent code |
-| `AUI_KBM_API_KEY` | RAG API key (overrides saved key in `~/.aui/kbm-key`) |
-| `AUI_AGENT_TOOLS_API_KEY` | Agent Settings API key (fallback auth) |
-| `AUI_API_WORKFLOW_KEY` | API Workflow key |
+| Variable                  | Description                                           |
+| ------------------------- | ----------------------------------------------------- |
+| `AUI_AUTH_TOKEN`          | Auth token (skip login)                               |
+| `AUI_API_URL`             | Override API base URL                                 |
+| `AUI_ENVIRONMENT`         | `staging`, `custom`, or `production`                  |
+| `AUI_ACCOUNT_ID`          | Account ID                                            |
+| `AUI_ORGANIZATION_ID`     | Organization ID                                       |
+| `AUI_AGENT_CODE`          | Agent code                                            |
+| `AUI_KBM_API_KEY`         | RAG API key (overrides saved key in `~/.aui/kbm-key`) |
+| `AUI_AGENT_TOOLS_API_KEY` | Agent Settings API key (fallback auth)                |
+| `AUI_API_WORKFLOW_KEY`    | API Workflow key                                      |
 
 ## License
 

package/dist/commands/add-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-integration.d.ts","sourceRoot":"","sources":["../../src/commands/add-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDxF"}
+{"version":3,"file":"add-integration.d.ts","sourceRoot":"","sources":["../../src/commands/add-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwBH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,GAAE,qBAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAuEf"}