@guildai/cli 0.5.12 → 0.5.13

package/dist/commands/agent/fork.js

@@ -8,6 +8,7 @@ import * as readline from 'readline';
 import { runGit, GitError, formatGitError } from '../../lib/git.js';
 import { createOutputWriter } from '../../lib/output.js';
 import { resolveOwnerId } from '../../lib/owner-helpers.js';
+import { isInteractive } from '../../lib/stdin.js';
 async function promptForName() {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -32,9 +33,6 @@ async function promptForDescription(defaultDescription) {
         });
     });
 }
-function isInteractive() {
-    return process.stdin.isTTY === true;
-}
 async function isDirectoryEmpty(dirPath) {
     try {
         const files = await fs.readdir(dirPath);

package/dist/commands/agent/init.js

@@ -11,6 +11,7 @@ import * as readline from 'readline';
 import { getAuthenticatedUrl } from '../../lib/auth.js';
 import { runGit, GitError, formatGitError, installPrePushHook } from '../../lib/git.js';
 import { resolveOwnerId } from '../../lib/owner-helpers.js';
+import { isInteractive } from '../../lib/stdin.js';
 const TEMPLATE_CHOICES = [
     {
         name: 'LLM - Simple language model agent (recommended)',
@@ -71,9 +72,6 @@ async function promptForTemplate() {
     ]);
     return template;
 }
-function isInteractive() {
-    return process.stdin.isTTY === true;
-}
 export function createAgentInitCommand() {
     const cmd = new Command('init');
     cmd

package/dist/commands/workspace/select.js

@@ -2,10 +2,11 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import * as fs from 'fs/promises';
-import * as readline from 'readline';
+import search from '@inquirer/search';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
+import { isInteractive } from '../../lib/stdin.js';
 import { isAgentDirectory, loadLocalConfig, getLocalConfigPath, getWorkspaceId, saveGlobalConfig, } from '../../lib/guild-config.js';
 /**
  * Format workspace for display with owner name.
@@ -68,44 +69,39 @@ export function createWorkspaceSelectCommand() {
                 }
                 return;
             }
-            // Interactive mode: fetch workspaces for selection
-            const workspaces = await client.get('/me/workspaces?filter=all');
-            if (workspaces.items.length === 0) {
+            if (!isInteractive()) {
+                output.error('Interactive mode requires a terminal.', 'Provide a workspace argument:\n  guild workspace select <name|id>');
+                process.exit(1);
+            }
+            // Interactive mode: fetch all workspaces across all pages
+            const workspaces = await client.fetchAll('/me/workspaces?filter=all');
+            if (workspaces.length === 0) {
                 output.error('No workspaces found.', 'Create a workspace first:\n  guild workspace create <name>');
                 process.exit(1);
             }
             // Resolve the currently selected workspace (if any)
             const current = await getWorkspaceId();
-            const currentIndex = current
-                ? workspaces.items.findIndex((w) => w.id === current.workspaceId)
-                : -1;
-            // Show interactive selection
-            console.log('Select a default workspace:\n');
-            workspaces.items.forEach((workspace, index) => {
-                const marker = index === currentIndex ? ' (current)' : '';
-                console.log(`  ${index + 1}. ${formatWorkspaceDisplay(workspace)}${marker}`);
-            });
-            console.log('');
-            const rl = readline.createInterface({
-                input: process.stdin,
-                output: process.stdout,
-            });
-            const defaultHint = currentIndex >= 0 ? ` [${currentIndex + 1}]` : '';
-            const answer = await new Promise((resolve) => {
-                rl.question(`Enter number (1-${workspaces.items.length})${defaultHint}: `, resolve);
+            const currentId = current?.workspaceId;
+            // Interactive searchable selection
+            const selectedId = await search({
+                message: 'Select a workspace (type to filter)',
+                pageSize: 15,
+                default: currentId,
+                source: (input) => {
+                    const term = input?.toLowerCase() ?? '';
+                    const filtered = term
+                        ? workspaces.filter((w) => w.name.toLowerCase().includes(term) ||
+                            w.full_name?.toLowerCase().includes(term) ||
+                            w.owner?.name.toLowerCase().includes(term))
+                        : workspaces;
+                    return filtered.map((w) => ({
+                        name: formatWorkspaceDisplay(w) + (w.id === currentId ? ' (current)' : ''),
+                        value: w.id,
+                        short: w.name,
+                    }));
+                },
             });
-            rl.close();
-            // Empty input keeps current selection
-            if (answer.trim() === '' && currentIndex >= 0) {
-                console.log('Workspace unchanged.');
-                return;
-            }
-            const selection = parseInt(answer.trim(), 10);
-            if (isNaN(selection) || selection < 1 || selection > workspaces.items.length) {
-                output.error('Invalid selection');
-                process.exit(1);
-            }
-            const selectedWorkspace = workspaces.items[selection - 1];
+            const selectedWorkspace = workspaces.find((w) => w.id === selectedId);
             const target = await saveWorkspaceConfig(selectedWorkspace.id, selectedWorkspace.name);
             if (target === 'local') {
                 output.success(`Workspace set for this agent: ${formatWorkspaceDisplay(selectedWorkspace)}`);

package/dist/lib/stdin.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Check if stdin is connected to an interactive terminal (TTY).
+ */
+export declare function isInteractive(): boolean;
 /**
  * Exit with a helpful error when stdin is piped but no --mode flag was given.
  * Call this before rendering an interactive UI (Ink render()) so users who

package/dist/lib/stdin.js

@@ -1,5 +1,11 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
+/**
+ * Check if stdin is connected to an interactive terminal (TTY).
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true;
+}
 /**
  * Exit with a helpful error when stdin is piped but no --mode flag was given.
  * Call this before rendering an interactive UI (Ink render()) so users who

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 <agent-id>:<version-id>           # Fork a specific version as a new agent
 guild agent publish                                # Publish a version
 guild agent unpublish                              # Remove from catalog
 guild agent update                                 # 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.5.13",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -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",