@guildai/cli 0.5.12 → 0.6.0

package/docs/skills/agent-dev.md

@@ -151,16 +151,22 @@ import { ask, output, callTools } from '@guildai/agents-sdk';
 import { guildTools, userInterfaceTools } from '@guildai/agents-sdk';
 
 // Service tools (from separate packages - NOT from SDK)
+import { azureDevOpsTools } from '@guildai-services/guildai~azure-devops';
+import { bitbucketTools } from '@guildai-services/guildai~bitbucket';
+import { confluenceTools } from '@guildai-services/guildai~confluence';
+import { cypressTools } from '@guildai-services/guildai~cypress';
+import { figmaTools } from '@guildai-services/guildai~figma';
 import { gitHubTools } from '@guildai-services/guildai~github';
-import { slackTools } from '@guildai-services/guildai~slack';
+import { googleComputeTools } from '@guildai-services/guildai~google-compute';
+import { googleLoggingTools } from '@guildai-services/guildai~google-logging';
 import { jiraTools } from '@guildai-services/guildai~jira';
-import { bitbucketTools } from '@guildai-services/guildai~bitbucket';
-import { azureDevOpsTools } from '@guildai-services/guildai~azure-devops';
 import { pipedreamTools } from '@guildai-services/guildai~pipedream';
-import { cypressTools } from '@guildai-services/guildai~cypress';
+import { slackTools } from '@guildai-services/guildai~slack';
+import { testrailTools } from '@guildai-services/guildai~testrail';
+import { zendeskTools } from '@guildai-services/guildai~zendesk';
 
 // Utilities
-import { pick, progressLogNotifyEvent } from '@guildai/agents-sdk';
+import { pick, omit, progressLogNotifyEvent } from '@guildai/agents-sdk';
 
 // Advanced (for compiled agents with LLM tool loops)
 import { delegatedCallsOf, asToolResultContent } from '@guildai/agents-sdk';
@@ -173,19 +179,25 @@ import { z } from 'zod';
 
 Service tools are in separate `@guildai-services/*` packages. The runtime resolves them automatically.
 
-| Service        | Package                                  | Export               | Tool Name Prefix |
-| -------------- | ---------------------------------------- | -------------------- | ---------------- |
-| Azure DevOps   | `@guildai-services/guildai~azure-devops` | `azureDevOpsTools`   | `azure_devops_`  |
-| Bitbucket      | `@guildai-services/guildai~bitbucket`    | `bitbucketTools`     | `bitbucket_`     |
-| Cypress        | `@guildai-services/guildai~cypress`      | `cypressTools`       | `cypress_`       |
-| GitHub         | `@guildai-services/guildai~github`       | `gitHubTools`        | `github_`        |
-| Guild          | `@guildai/agents-sdk`                    | `guildTools`         | `guild_`         |
-| Jira           | `@guildai-services/guildai~jira`         | `jiraTools`          | `jira_`          |
-| Linear         | `@guildai-services/guildai~linear`       | `linearTools`        | `linear_`        |
-| NewRelic       | `@guildai-services/guildai~newrelic`     | `newrelicTools`      | `newrelic_`      |
-| Pipedream      | `@guildai-services/guildai~pipedream`    | `pipedreamTools`     | `pipedream_`     |
-| Slack          | `@guildai-services/guildai~slack`        | `slackTools`         | `slack_`         |
-| User Interface | `@guildai/agents-sdk`                    | `userInterfaceTools` | `ui_`            |
+| Service        | Package                                    | Export               | Tool Name Prefix  |
+| -------------- | ------------------------------------------ | -------------------- | ----------------- |
+| Azure DevOps   | `@guildai-services/guildai~azure-devops`   | `azureDevOpsTools`   | `azure_devops_`   |
+| Bitbucket      | `@guildai-services/guildai~bitbucket`      | `bitbucketTools`     | `bitbucket_`      |
+| Confluence     | `@guildai-services/guildai~confluence`     | `confluenceTools`    | `confluence_`     |
+| Cypress        | `@guildai-services/guildai~cypress`        | `cypressTools`       | `cypress_`        |
+| Figma          | `@guildai-services/guildai~figma`          | `figmaTools`         | `figma_`          |
+| GitHub         | `@guildai-services/guildai~github`         | `gitHubTools`        | `github_`         |
+| Google Compute | `@guildai-services/guildai~google-compute` | `googleComputeTools` | `google_compute_` |
+| Google Logging | `@guildai-services/guildai~google-logging` | `googleLoggingTools` | `google_logging_` |
+| Guild          | `@guildai/agents-sdk`                      | `guildTools`         | `guild_`          |
+| Jira           | `@guildai-services/guildai~jira`           | `jiraTools`          | `jira_`           |
+| Linear         | `@guildai-services/guildai~linear`         | `linearTools`        | `linear_`         |
+| NewRelic       | `@guildai-services/guildai~newrelic`       | `newrelicTools`      | `newrelic_`       |
+| Pipedream      | `@guildai-services/guildai~pipedream`      | `pipedreamTools`     | `pipedream_`      |
+| Slack          | `@guildai-services/guildai~slack`          | `slackTools`         | `slack_`          |
+| TestRail       | `@guildai-services/guildai~testrail`       | `testrailTools`      | `testrail_`       |
+| User Interface | `@guildai/agents-sdk`                      | `userInterfaceTools` | `ui_`             |
+| Zendesk        | `@guildai-services/guildai~zendesk`        | `zendeskTools`       | `zendesk_`        |
 
 ### Tool Access via `task.tools.*`
 
@@ -220,12 +232,16 @@ await task.tools.guild_credentials_request({ service: 'GITHUB' });
 
 ### Task Properties
 
-| Property         | Description                                                                          |
-| ---------------- | ------------------------------------------------------------------------------------ |
-| `task.sessionId` | Session ID for correlating operations                                                |
-| `task.console`   | Debug logging (`task.console.debug(...)`, `.info(...)`, `.warn(...)`, `.error(...)`) |
-| `task.tools`     | Primary API for calling all tools                                                    |
-| `task.guild`     | Guild service (available when **all** `guildTools` included — see warning below)     |
+| Property         | Description                                                                                 |
+| ---------------- | ------------------------------------------------------------------------------------------- |
+| `task.sessionId` | Session ID for correlating operations                                                       |
+| `task.tools`     | Primary API for calling all tools                                                           |
+| `task.llm`       | LLM service — call `task.llm.generateText({ messages, system, tools })` for AI model access |
+| `task.console`   | Debug logging (`task.console.debug(...)`, `.info(...)`, `.warn(...)`, `.error(...)`)        |
+| `task.save()`    | Persist agent state (self-managed state agents only)                                        |
+| `task.restore()` | Retrieve previously saved state (self-managed state agents only)                            |
+| `task.guild`     | **Deprecated** — use `task.tools.guild_*` instead                                           |
+| `task.ui`        | **Deprecated** — use `task.tools.ui_*` instead                                              |
 
 ---
 
@@ -340,7 +356,7 @@ export default agent({
 
 - `run()` returns the OUTPUT directly (not wrapped in `{ type: "output", output: ... }`)
 - The runtime handles continuations — you can `await` tool calls inline
-- Requires `"use agent"` directive at top of file
+- `"use agent"` directive at top of file is optional (the Babel compiler recognizes it but strips it)
 - No `identifier` field needed
 
 ### 3. Self-Managed State Agent (`start()`/`onToolResults()`)
@@ -474,7 +490,7 @@ import {
 } from '@guildai/agents-sdk';
 import { gitHubTools } from '@guildai-services/guildai~github';
 import { slackTools } from '@guildai-services/guildai~slack';
-import { generateText, type ModelMessage } from 'ai';
+import type { ModelMessage } from 'ai';
 import { z } from 'zod';
 
 const tools = { ...gitHubTools, ...slackTools, ...userInterfaceTools };
@@ -485,15 +501,12 @@ const llmTools = { ...gitHubTools }; // LLM gets execute access to these
 const agentTools = { ...slackTools, ...userInterfaceTools }; // These get delegated
 
 async function start(input, task: Task<Tools>) {
-  const model = await task.llm.model();
   const messages: ModelMessage[] = [{ role: 'user', content: input.text }];
 
-  const result = await generateText({
-    model,
+  const result = await task.llm.generateText({
     system: 'You are a helpful assistant.',
     messages,
     tools: llmTools, // Only give LLM the tools it can execute
-    maxSteps: 10,
   });
 
   // Check for delegated (unexecuted) tool calls
@@ -525,6 +538,7 @@ async function onToolResults(
 
 **Key utilities:**
 
+- `task.llm.generateText({ messages, system, tools })` — call the LLM with automatic authentication and provider selection. The runtime handles model selection and credential injection.
 - `delegatedCallsOf<Tools>(content)` — extracts unexecuted tool calls from `generateText` results that need runtime delegation
 - `asToolResultContent(results)` — converts `TypedToolResult[]` into LLM message format for conversation history
 
@@ -572,13 +586,20 @@ await task.tools.slack_chat_post_message({
 
 **CRITICAL: Only use tool names listed below.** If a tool isn't listed here, it doesn't exist. Do not guess tool names based on API patterns.
 
-Use `pick()` to select specific tools:
+Use `pick()` to select specific tools, or `omit()` to exclude specific tools:
 
 ```typescript
+// Include only specific tools
 const tools = {
   ...pick(gitHubTools, ['github_repos_get', 'github_pulls_list']),
   ...guildTools,
 };
+
+// Include all tools except specific ones
+const tools = {
+  ...omit(gitHubTools, ['github_repos_delete', 'github_repos_update']),
+  ...guildTools,
+};
 ```
 
 #### Azure DevOps (`azure_devops_` prefix, 122 tools)
@@ -1673,8 +1694,8 @@ export default agent({ run: async (input, task) => { ... } })
 ## Versioning
 
 - Use semver: `1.0.0` → `1.0.1` (patch), `1.1.0` (minor), `2.0.0` (breaking)
-- Keep `package.json` version in sync with your releases
-- Bump version before `guild agent save --wait --publish`
+- Use `--bump [patch|minor|major]` with `guild agent save` to auto-bump `package.json` version
+- Or bump manually in `package.json` before saving
 
 ## File Structure
 
@@ -1709,15 +1730,21 @@ guild agent pull                                   # Pull remote changes
 guild agent save                                   # Push commits and create a draft version
 guild agent save -A --message "description"        # Stage+commit+push in one step
 guild agent save --message "v1.0" --wait --publish # Save + validate + publish
+guild agent save --bump minor --message "v1.1"     # Auto-bump version before saving
 guild agent test                                   # Interactive test
 guild agent test --ephemeral                       # Ephemeral test
 guild agent chat "Hello"                           # Test with input
 guild agent get [agent-id]                         # View agent info
+guild agent list                                   # List agents
+guild agent list --search "github" --published     # Search published agents
+guild agent search <query>                         # Search published agents
 guild agent versions [agent-id]                    # Version history
 guild agent clone <agent-id>                       # Clone existing agent
+guild agent fork [identifier]                      # Fork an agent (latest published version, or identifier:version)
 guild agent publish                                # Publish a version
 guild agent unpublish                              # Remove from catalog
-guild agent update                                 # Update agent metadata
+guild agent update [identifier]                    # Update agent metadata
+guild agent workspaces [agent-id]                  # List workspaces using an agent
 guild agent tags list|add|remove|set               # Manage agent tags
 guild agent revalidate                             # Re-run validation
 guild agent code [agent-id]                        # View agent source

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.5.12",
+  "version": "0.6.0",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -35,12 +35,12 @@
     "format:fix": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
-    "test:unit": "vitest run test/unit",
+    "test:unit": "vitest run test/unit --config vitest.unit.config.ts",
     "test:e2e": "vitest run test/e2e --exclude='**/**.slow.test.ts'",
     "test:e2e:slow": "vitest run 'test/e2e/**/*.slow.test.ts'",
     "test:e2e:all": "vitest run test/e2e",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run build && npm run lint && npm run test"
+    "prepublishOnly": "npm run build && npm run lint && npm run test:unit"
   },
   "keywords": [
     "guild",
@@ -55,6 +55,7 @@
     "url": "https://docs.guild.ai/support"
   },
   "dependencies": {
+    "@inquirer/search": "^4.1.7",
     "@napi-rs/canvas": "^0.1.85",
     "@napi-rs/keyring": "^1.2.0",
     "axios": "^1.13.2",

package/dist/commands/container/destroy.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerDestroyCommand(): Command;
-//# sourceMappingURL=destroy.d.ts.map

package/dist/commands/container/destroy.js

@@ -1,48 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerDestroyCommand() {
-    const cmd = new Command('destroy');
-    cmd
-        .description('Destroy a running container')
-        .argument('<container-id>', 'Container ID')
-        .action(async (containerId) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post(`/containers/${containerId}/destroy`, {});
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                if (response.status === 'SUCCESS') {
-                    output.success(`Container ${containerId} destroyed`);
-                }
-                else if (response.status === 'ERROR') {
-                    output.error(`Failed to destroy container: ${response.error || 'unknown error'}`);
-                    process.exit(1);
-                }
-                else {
-                    output.progress(`Container destruction ${response.status.toLowerCase()}...`);
-                }
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to destroy container: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=destroy.js.map

package/dist/commands/container/events.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerEventsCommand(): Command;
-//# sourceMappingURL=events.d.ts.map

package/dist/commands/container/events.js

@@ -1,44 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter, formatContainerEventTable } from '../../lib/output.js';
-export function createContainerEventsCommand() {
-    const cmd = new Command('events');
-    cmd
-        .description('List events for a container')
-        .argument('<container-id>', 'Container ID')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
-        .action(async (containerId, options) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const params = new URLSearchParams();
-            params.append('limit', options.limit);
-            params.append('offset', options.offset);
-            const response = await client.get(`/containers/${containerId}/events?${params.toString()}`);
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                formatContainerEventTable(response.items, response.pagination);
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to list container events: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=events.js.map

package/dist/commands/container/exec.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerExecCommand(): Command;
-//# sourceMappingURL=exec.d.ts.map

package/dist/commands/container/exec.js

@@ -1,64 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { getOutputMode } from '../../lib/output-mode.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerExecCommand() {
-    const cmd = new Command('exec');
-    cmd
-        .description('Execute a command in a running container')
-        .argument('<container-id>', 'Container ID')
-        .argument('<command>', 'Command to execute')
-        .action(async (containerId, command) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post(`/containers/${containerId}/command`, { command });
-            if (getOutputMode() === 'json') {
-                console.log(JSON.stringify(response, null, 2));
-            }
-            else {
-                // Display return code
-                if (response.return_code !== null) {
-                    const codeColor = response.return_code === 0 ? chalk.green : chalk.red;
-                    console.error(chalk.dim('Return code:'), codeColor(String(response.return_code)));
-                }
-                // Display stdout
-                if (response.stdout) {
-                    console.log(response.stdout);
-                }
-                // Display stderr
-                if (response.stderr) {
-                    console.error(chalk.red(response.stderr));
-                }
-                // Display error from event
-                if (response.status === 'ERROR' && response.error) {
-                    console.error(chalk.red(`Error: ${response.error}`));
-                }
-            }
-            // Exit with the command's return code if available
-            if (response.return_code !== null && response.return_code !== 0) {
-                process.exit(response.return_code);
-            }
-            if (response.status === 'ERROR') {
-                process.exit(1);
-            }
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to execute command: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=exec.js.map

package/dist/commands/container/get.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerGetCommand(): Command;
-//# sourceMappingURL=get.d.ts.map

package/dist/commands/container/list.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerListCommand(): Command;
-//# sourceMappingURL=list.d.ts.map

package/dist/commands/container-image/create.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageCreateCommand(): Command;
-//# sourceMappingURL=create.d.ts.map

package/dist/commands/container-image/create.js

@@ -1,41 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerImageCreateCommand() {
-    const cmd = new Command('create');
-    cmd
-        .description('Create a container image')
-        .requiredOption('--account <id-or-name>', 'Account or organization ID or name')
-        .requiredOption('--name <name>', 'Image name (1-100 characters)')
-        .requiredOption('--image <image>', 'Container image path (e.g. registry.example.com/org/image)')
-        .requiredOption('--tag <tag>', 'Image tag (e.g. latest)')
-        .action(async (opts) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.post('/container-images', {
-                name: opts.name,
-                image_name: opts.image,
-                tag: opts.tag,
-                owner_id_or_name: opts.account,
-            });
-            output.data(response);
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to create container image: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=create.js.map

package/dist/commands/container-image/get.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageGetCommand(): Command;
-//# sourceMappingURL=get.d.ts.map

package/dist/commands/container-image/get.js

@@ -1,33 +0,0 @@
-// Copyright 2026 Guild.ai
-// SPDX-License-Identifier: Apache-2.0
-import { Command } from 'commander';
-import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAuthToken } from '../../lib/auth.js';
-import { handleAxiosError } from '../../lib/errors.js';
-import { createOutputWriter } from '../../lib/output.js';
-export function createContainerImageGetCommand() {
-    const cmd = new Command('get');
-    cmd
-        .description('Get container image details')
-        .argument('<image-id-or-name>', 'Container image ID or name (owner~name)')
-        .action(async (imageIdOrName) => {
-        const output = createOutputWriter();
-        try {
-            const token = await getAuthToken();
-            if (!token) {
-                output.error('Not authenticated. Run: guild auth login');
-                process.exit(1);
-            }
-            const client = new GuildAPIClient();
-            const response = await client.get(`/container-images/${imageIdOrName}`);
-            output.data(response);
-        }
-        catch (error) {
-            const formattedError = handleAxiosError(error);
-            output.error(`Failed to get container image: ${formattedError.details}`);
-            process.exit(1);
-        }
-    });
-    return cmd;
-}
-//# sourceMappingURL=get.js.map

package/dist/commands/container-image/list.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createContainerImageListCommand(): Command;
-//# sourceMappingURL=list.d.ts.map