@guildai/cli 0.5.13 → 0.6.0

package/dist/commands/agent/clone.js

@@ -8,6 +8,7 @@ import * as path from 'path';
 import { getAuthenticatedUrl } from '../../lib/auth.js';
 import { runGit, GitError, formatGitError, installPrePushHook } from '../../lib/git.js';
 import { createOutputWriter } from '../../lib/output.js';
+import { resolveAgentRef } from '../../lib/agent-helpers.js';
 async function isDirectoryEmpty(dirPath) {
     try {
         const files = await fs.readdir(dirPath);
@@ -30,7 +31,8 @@ export function createAgentCloneCommand() {
         try {
             // Fetch agent details
             const client = new GuildAPIClient();
-            const agent = await client.get(`/agents/${agentId}`);
+            const resolvedId = await resolveAgentRef(client, agentId);
+            const agent = await client.get(`/agents/${resolvedId}`);
             if (!agent.git_url) {
                 output.error('Error: Agent does not have a git repository', 'This agent may not have been initialized with git.');
                 process.exit(1);

package/dist/commands/agent/code.js

@@ -3,7 +3,7 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { createOutputWriter } from '../../lib/output.js';
 import * as fs from 'fs/promises';
 import * as path from 'path';
@@ -22,7 +22,8 @@ export function createAgentCodeCommand() {
         const includeDraft = options.draft ? '1' : '0';
         let files;
         try {
-            files = await client.get(`/agents/${agentId}/code?include_unpublished=${includeDraft}`);
+            const resolvedId = await resolveAgentRef(client, agentId);
+            files = await client.get(`/agents/${resolvedId}/code?include_unpublished=${includeDraft}`);
         }
         catch (error) {
             const formattedError = handleAxiosError(error);

package/dist/commands/agent/fork.js

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes, debug } from '../../lib/errors.js';
 import * as fs from 'fs/promises';
 import * as readline from 'readline';
@@ -47,21 +48,48 @@ export function createAgentForkCommand() {
     const cmd = new Command('fork');
     cmd
         .description('Fork an existing agent version to create a new agent')
-        .argument('<agent-id>:<version-id>', 'Source agent and version (e.g., agent_abc:version_xyz)')
+        .argument('[identifier]', 'Agent ID, full name, or agent:version (e.g., owner/agent-name:version_xyz)')
         .option('--name <name>', 'Name for the forked agent')
         .option('--description <desc>', 'Description for the forked agent')
         .option('--directory <path>', 'Target directory for clone')
         .option('--owner <owner-id>', 'Owner account (user or organization ID)')
-        .action(async (sourceArg, options) => {
+        .action(async (identifierArg, options) => {
         const output = createOutputWriter();
         try {
-            // Parse agent-id:version-id format
-            const parts = sourceArg.split(':');
-            if (parts.length !== 2 || !parts[0] || !parts[1]) {
-                output.error('Error: Invalid argument format', `Expected: <agent-id>:<version-id>\nExample: guild agent fork agent_abc123:version_xyz789\n\nTo find versions:\n  guild agent versions ${parts[0] || '<agent-id>'}`);
-                process.exit(1);
+            // Resolve agent ID and optional version ID
+            let sourceAgentId;
+            let sourceVersionId;
+            if (identifierArg && identifierArg.includes(':')) {
+                // Explicit agent:version format
+                const colonIndex = identifierArg.lastIndexOf(':');
+                const agentPart = identifierArg.substring(0, colonIndex);
+                sourceVersionId = identifierArg.substring(colonIndex + 1);
+                if (!agentPart || !sourceVersionId) {
+                    output.error('Error: Invalid argument format', 'Expected: [identifier] or [identifier]:[version-id]\nExample: guild agent fork owner/agent-name:version_xyz\n\nTo find versions:\n  guild agent versions <agent-id>');
+                    process.exit(1);
+                }
+                const resolved = await getAgentId(agentPart);
+                sourceAgentId = resolved.agentId;
+            }
+            else {
+                // No version specified — resolve agent, then find latest published
+                const resolved = await getAgentId(identifierArg);
+                sourceAgentId = resolved.agentId;
+            }
+            // Auto-resolve version if not specified
+            const client = new GuildAPIClient();
+            sourceAgentId = await resolveAgentRef(client, sourceAgentId);
+            if (!sourceVersionId) {
+                const versions = await client.get(`/agents/${sourceAgentId}/versions`);
+                const published = versions.items
+                    .filter((v) => v.status === 'PUBLISHED')
+                    .sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+                if (published.length === 0) {
+                    output.error('No published versions found', `Agent ${sourceAgentId} has no published versions to fork.\n\nTo see all versions:\n  guild agent versions ${sourceAgentId}`);
+                    process.exit(1);
+                }
+                sourceVersionId = published[0].id;
             }
-            const [sourceAgentId, sourceVersionId] = parts;
             // Determine name (validate before API call for better UX)
             let agentName = options.name;
             if (!agentName) {
@@ -73,7 +101,7 @@ export function createAgentForkCommand() {
                     }
                 }
                 else {
-                    output.error('Error: Agent name required in non-interactive mode', `Provide a name:\n  guild agent fork ${sourceArg} --name my-forked-agent\n\nOr run interactively to be prompted.`);
+                    output.error('Error: Agent name required in non-interactive mode', `Provide a name:\n  guild agent fork ${identifierArg || '<identifier>'} --name my-forked-agent\n\nOr run interactively to be prompted.`);
                     process.exit(1);
                 }
             }
@@ -92,12 +120,11 @@ export function createAgentForkCommand() {
             if (dirExists) {
                 const isEmpty = await isDirectoryEmpty(targetDir);
                 if (!isEmpty) {
-                    output.error(`Error: Directory '${targetDir}' already exists and is not empty`, `Choose a different directory:\n  guild agent fork ${sourceArg} --directory ./different-path\n\nOr remove the existing directory first.`);
+                    output.error(`Error: Directory '${targetDir}' already exists and is not empty`, `Choose a different directory:\n  guild agent fork ${identifierArg || '<identifier>'} --directory ./different-path\n\nOr remove the existing directory first.`);
                     process.exit(1);
                 }
             }
-            // Now fetch source version from API (after local validations)
-            const client = new GuildAPIClient();
+            // Fetch source version from API (after local validations)
             const sourceVersion = await client.get(`/agents/${sourceAgentId}/versions/${sourceVersionId}`);
             output.progress(`✓ Fetched source version from '${sourceVersion.agent.name}' (${sourceVersionId.substring(0, 12)})`);
             // Determine description
@@ -174,8 +201,7 @@ export function createAgentForkCommand() {
                 process.exit(1);
             }
             if (formattedError.code === ErrorCodes.NOT_FOUND) {
-                const [sourceAgentId] = sourceArg.split(':');
-                output.error(`Error: Version not found: ${sourceArg}`, `Check available versions:\n  guild agent versions ${sourceAgentId}`);
+                output.error(`Error: Agent or version not found: ${identifierArg || '<identifier>'}`, `Check available versions:\n  guild agent versions <agent-id>`);
                 process.exit(1);
             }
             if (formattedError.code === ErrorCodes.CONN_REFUSED) {

package/dist/commands/agent/get.js

@@ -3,7 +3,7 @@
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
 export function createAgentGetCommand() {
@@ -22,7 +22,8 @@ export function createAgentGetCommand() {
             // Get agent ID from argument or guild.json
             const { agentId } = await getAgentId(idArg);
             const client = new GuildAPIClient();
-            const response = await client.get(`/agents/${agentId}`);
+            const resolvedId = await resolveAgentRef(client, agentId);
+            const response = await client.get(`/agents/${resolvedId}`);
             output.data(response);
         }
         catch (error) {

package/dist/commands/agent/grep.js

@@ -5,12 +5,14 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { createOutputWriter } from '../../lib/output.js';
 import { handleAxiosError } from '../../lib/errors.js';
+import { loadLocalConfig } from '../../lib/guild-config.js';
 export function createAgentGrepCommand() {
     const cmd = new Command('grep');
     cmd
         .description('Search agent files for a matching pattern')
         .argument('[pattern]', 'JavaScript regex for which to search: all lines matching this pattern will be printed')
-        .option('--published', 'Only search published agents')
+        .option('--all', 'Search all agents (default: current agent only)')
+        .option('--published', 'Only search published agents (requires --all)')
         .action(grep);
     return cmd;
 }
@@ -36,36 +38,11 @@ async function grep(patternArg, options) {
             process.exit(1);
         }
         const client = new GuildAPIClient();
-        let offset = 0;
-        while (true) {
-            const params = new URLSearchParams();
-            params.append('offset', `${offset}`);
-            params.append('limit', `${BATCH_SIZE}`);
-            if (options.published) {
-                params.append('published_only', 'true');
-            }
-            const response = await client.get(`/agents?${params.toString()}`);
-            await Promise.all(response.items.map(async (agent) => {
-                let files = [];
-                try {
-                    files = await client.get(`/agents/${agent.id}/code`);
-                }
-                catch (ex) {
-                    const formattedError = handleAxiosError(ex);
-                    output.error(`${agent.owner?.name}/${agent.name}: ${formattedError.details}`);
-                    return;
-                }
-                for (const { path, content } of files) {
-                    content.split('\n').forEach((line, lineNumber) => {
-                        if (patternRE.test(line)) {
-                            output.progress(`${agent.owner?.name}/${agent.name}/${path}:${lineNumber + 1}:${line}`);
-                        }
-                    });
-                }
-            }));
-            offset += response.pagination.limit;
-            if (!response.pagination.has_more)
-                break;
+        if (options.all) {
+            await grepAllAgents(client, patternRE, options.published, output);
+        }
+        else {
+            await grepCurrentAgent(client, patternRE, output);
         }
     }
     catch (error) {
@@ -74,4 +51,57 @@ async function grep(patternArg, options) {
         process.exit(1);
     }
 }
+function searchFiles(files, patternRE, prefix, output) {
+    for (const { path, content } of files) {
+        content.split('\n').forEach((line, lineNumber) => {
+            if (patternRE.test(line)) {
+                output.progress(`${prefix}${path}:${lineNumber + 1}:${line}`);
+            }
+        });
+    }
+}
+async function grepCurrentAgent(client, patternRE, output) {
+    const config = await loadLocalConfig();
+    if (!config?.agent_id) {
+        output.error('Not in an agent directory.', 'Either run from an agent directory with guild.json:\n  cd <agent-directory>\n  guild agent grep <pattern>\n\nOr search all agents:\n  guild agent grep <pattern> --all');
+        process.exit(1);
+    }
+    let files = [];
+    try {
+        files = await client.get(`/agents/${config.agent_id}/code`);
+    }
+    catch (ex) {
+        const formattedError = handleAxiosError(ex);
+        output.error(`Failed to fetch agent code: ${formattedError.details}`);
+        process.exit(1);
+    }
+    searchFiles(files, patternRE, '', output);
+}
+async function grepAllAgents(client, patternRE, publishedOnly, output) {
+    let offset = 0;
+    while (true) {
+        const params = new URLSearchParams();
+        params.append('offset', `${offset}`);
+        params.append('limit', `${BATCH_SIZE}`);
+        if (publishedOnly) {
+            params.append('published_only', 'true');
+        }
+        const response = await client.get(`/agents?${params.toString()}`);
+        await Promise.all(response.items.map(async (agent) => {
+            let files = [];
+            try {
+                files = await client.get(`/agents/${agent.id}/code`);
+            }
+            catch (ex) {
+                const formattedError = handleAxiosError(ex);
+                output.error(`${agent.owner?.name}/${agent.name}: ${formattedError.details}`);
+                return;
+            }
+            searchFiles(files, patternRE, `${agent.owner?.name}/${agent.name}/`, output);
+        }));
+        offset += response.pagination.limit;
+        if (!response.pagination.has_more)
+            break;
+    }
+}
 //# sourceMappingURL=grep.js.map

package/dist/commands/agent/publish.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { pollUntilComplete } from '../../lib/polling.js';
 import { createOutputWriter } from '../../lib/output.js';
@@ -18,8 +18,9 @@ export function createAgentPublishCommand() {
             const client = new GuildAPIClient();
             // Resolve agent ID
             const { agentId, config } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             // Fetch all versions
-            const response = await client.get(`/agents/${agentId}/versions`);
+            const response = await client.get(`/agents/${resolvedId}/versions`);
             // Find latest DRAFT version
             const draftVersions = response.items
                 .filter((v) => v.status === 'DRAFT')

package/dist/commands/agent/revalidate.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { createOutputWriter } from '../../lib/output.js';
 export function createAgentRevalidateCommand() {
     const cmd = new Command('revalidate');
@@ -19,10 +19,11 @@ export function createAgentRevalidateCommand() {
         const baseUrl = getGuildcoreUrl();
         const client = new GuildAPIClient({ baseUrl });
         try {
+            const resolvedId = await resolveAgentRef(client, agentId);
             let versionId = versionIdArg;
             // If no version ID provided, get the latest version
             if (!versionId) {
-                const versions = await client.get(`/agents/${agentId}/versions?limit=1&offset=0`);
+                const versions = await client.get(`/agents/${resolvedId}/versions?limit=1&offset=0`);
                 if (!versions.items || versions.items.length === 0) {
                     output.error('No versions found for this agent.', `The agent may still be initializing. Check status:\n  guild agent get ${agentId}`);
                     process.exit(1);
@@ -30,7 +31,7 @@ export function createAgentRevalidateCommand() {
                 versionId = versions.items[0].id;
             }
             // Revalidate the version
-            const result = await client.post(`/agents/${agentId}/versions/${versionId}/revalidate`);
+            const result = await client.post(`/agents/${resolvedId}/versions/${versionId}/revalidate`);
             output.data(result);
         }
         catch (error) {

package/dist/commands/agent/search.js

@@ -15,10 +15,10 @@ const SORT_MAP = {
 export function createAgentSearchCommand() {
     const cmd = new Command('search');
     cmd
-        .description('Search published agents')
+        .description('Search agents')
         .argument('<query>', 'Search query')
         .option('--sort <field>', 'Sort by: updated, newest, name, popular (default: updated)', 'updated')
-        .option('--all', 'Include unpublished agents')
+        .option('--published', 'Only show published agents')
         .option('--limit <number>', 'Number of results to return', '20')
         .option('--offset <number>', 'Offset for pagination', '0')
         .action(async (query, options) => {
@@ -34,7 +34,7 @@ export function createAgentSearchCommand() {
             params.append('search', query);
             params.append('limit', options.limit);
             params.append('offset', options.offset);
-            if (!options.all) {
+            if (options.published) {
                 params.append('published_only', 'true');
             }
             const sortField = SORT_MAP[options.sort];

package/dist/commands/agent/tags/add.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
-import { getAgentId } from '../../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsAddCommand() {
@@ -34,17 +34,18 @@ export function createAgentTagsAddCommand() {
             }
             // Now resolve agent ID properly
             const { agentId, config } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             if (tagsToAdd.length === 0) {
                 output.error('At least one tag is required.', 'Usage: guild agent tags add [agent-id] <tag...>');
                 process.exit(1);
             }
             // Fetch current tags
-            const response = await client.get(`/agents/${agentId}/tags`);
+            const response = await client.get(`/agents/${resolvedId}/tags`);
             const currentTags = response.names;
             // Add new tags (deduplicate)
             const updatedTags = Array.from(new Set([...currentTags, ...tagsToAdd]));
             // Update tags
-            await client.post(`/agents/${agentId}/tags`, { names: updatedTags });
+            await client.post(`/agents/${resolvedId}/tags`, { names: updatedTags });
             const agentName = config?.name || `agent ${agentId}`;
             const label = `${agentName}${config ? '' : ` (${agentId})`}`;
             output.success(`Updated tags for agent: ${label}`);

package/dist/commands/agent/tags/list.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
-import { getAgentId } from '../../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsListCommand() {
@@ -16,8 +16,9 @@ export function createAgentTagsListCommand() {
             const client = new GuildAPIClient();
             // Resolve agent ID
             const { agentId } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             // Fetch tags
-            const response = await client.get(`/agents/${agentId}/tags`);
+            const response = await client.get(`/agents/${resolvedId}/tags`);
             output.data(response);
         }
         catch (error) {

package/dist/commands/agent/tags/remove.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
-import { getAgentId } from '../../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsRemoveCommand() {
@@ -34,19 +34,20 @@ export function createAgentTagsRemoveCommand() {
             }
             // Now resolve agent ID properly
             const { agentId, config } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             if (tagsToRemove.length === 0) {
                 output.error('At least one tag is required.', 'Usage: guild agent tags remove [agent-id] <tag...>');
                 process.exit(1);
             }
             // Fetch current tags
-            const response = await client.get(`/agents/${agentId}/tags`);
+            const response = await client.get(`/agents/${resolvedId}/tags`);
             const currentTags = response.names;
             // Remove specified tags
             const updatedTags = currentTags.filter((tag) => !tagsToRemove.includes(tag));
             // Track which tags were not present
             const notPresentTags = tagsToRemove.filter((tag) => !currentTags.includes(tag));
             // Update tags
-            await client.post(`/agents/${agentId}/tags`, { names: updatedTags });
+            await client.post(`/agents/${resolvedId}/tags`, { names: updatedTags });
             const agentName = config?.name || `agent ${agentId}`;
             const label = `${agentName}${config ? '' : ` (${agentId})`}`;
             output.success(`Updated tags for agent: ${label}`);

package/dist/commands/agent/tags/set.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../../lib/api-client.js';
-import { getAgentId } from '../../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter } from '../../../lib/output.js';
 export function createAgentTagsSetCommand() {
@@ -36,8 +36,9 @@ export function createAgentTagsSetCommand() {
             }
             // Now resolve agent ID properly
             const { agentId, config } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             // Update tags (direct replacement)
-            await client.post(`/agents/${agentId}/tags`, { names: tagsToSet });
+            await client.post(`/agents/${resolvedId}/tags`, { names: tagsToSet });
             const agentName = config?.name || `agent ${agentId}`;
             const label = `${agentName}${config ? '' : ` (${agentId})`}`;
             if (tagsToSet.length === 0) {

package/dist/commands/agent/unpublish.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
 export function createAgentUnpublishCommand() {
@@ -16,8 +16,9 @@ export function createAgentUnpublishCommand() {
             const client = new GuildAPIClient();
             // Resolve agent ID
             const { agentId, config } = await getAgentId(agentIdArg);
+            const resolvedId = await resolveAgentRef(client, agentId);
             // Fetch all versions
-            const response = await client.get(`/agents/${agentId}/versions`);
+            const response = await client.get(`/agents/${resolvedId}/versions`);
             // Find latest PUBLISHED version
             const publishedVersions = response.items
                 .filter((v) => v.status === 'PUBLISHED')

package/dist/commands/agent/update.js

@@ -3,7 +3,7 @@
 import { Command } from 'commander';
 import * as readline from 'readline';
 import { GuildAPIClient } from '../../lib/api-client.js';
-import { getGuildcoreUrl } from '../../lib/config.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
 async function confirmVisibilityChange(agentName, makePublic) {
@@ -26,15 +26,15 @@ export function createAgentUpdateCommand() {
     const cmd = new Command('update');
     cmd
         .description('Update agent properties (visibility)')
-        .argument('<identifier>', 'Agent ID or full name (e.g., owner/agent-name)')
+        .argument('[identifier]', 'Agent ID or full name (e.g., owner/agent-name)')
         .option('--public', 'Make the agent public (visible to everyone)')
         .option('--private', 'Make the agent private (only visible to owner)')
         .option('--yes', 'Skip confirmation prompt for visibility changes')
-        .action(async (agentId, options) => {
+        .action(async (identifierArg, options) => {
         const output = createOutputWriter();
         // Validate that at least one option is provided
         if (!options.public && !options.private) {
-            output.error('No update options provided.', 'Usage: guild agent update <agent-id> [options]\n\nOptions:\n  --public              Make the agent public\n  --private             Make the agent private\n  --yes                 Skip confirmation prompt\n\nExamples:\n  guild agent update my-agent --public\n  guild agent update my-agent --private --yes\n\nNote: Agent descriptions are set from README.md when publishing.');
+            output.error('No update options provided.', 'Usage: guild agent update [identifier] [options]\n\nOptions:\n  --public              Make the agent public\n  --private             Make the agent private\n  --yes                 Skip confirmation prompt\n\nExamples:\n  guild agent update my-agent --public\n  guild agent update my-agent --private --yes\n  guild agent update --public          (uses guild.json)\n\nNote: Agent descriptions are set from README.md when publishing.');
             process.exit(1);
         }
         // Validate that --public and --private are not both specified
@@ -42,11 +42,12 @@ export function createAgentUpdateCommand() {
             output.error('Cannot specify both --public and --private');
             process.exit(1);
         }
-        const baseUrl = getGuildcoreUrl();
-        const client = new GuildAPIClient({ baseUrl });
+        const { agentId } = await getAgentId(identifierArg);
+        const client = new GuildAPIClient();
         try {
+            const resolvedId = await resolveAgentRef(client, agentId);
             // Fetch current agent info for confirmation prompts
-            const agent = await client.get(`/agents/${agentId}`);
+            const agent = await client.get(`/agents/${resolvedId}`);
             // Handle visibility change confirmation
             const changingVisibility = options.public || options.private;
             if (changingVisibility) {
@@ -73,7 +74,7 @@ export function createAgentUpdateCommand() {
             if (options.private) {
                 updatePayload.is_public = false;
             }
-            const result = await client.patch(`/agents/${agentId}`, updatePayload);
+            const result = await client.patch(`/agents/${resolvedId}`, updatePayload);
             // Build success message
             const changes = [];
             if (changingVisibility) {

package/dist/commands/agent/versions.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatVersionTable } from '../../lib/output.js';
 export function createAgentVersionsCommand() {
@@ -23,7 +23,8 @@ export function createAgentVersionsCommand() {
         const limit = parseInt(options.limit, 10);
         const offset = parseInt(options.offset, 10);
         try {
-            const result = await client.get(`/agents/${agentId}/versions?limit=${limit}&offset=${offset}`);
+            const resolvedId = await resolveAgentRef(client, agentId);
+            const result = await client.get(`/agents/${resolvedId}/versions?limit=${limit}&offset=${offset}`);
             if (getOutputMode() === 'json') {
                 output.data(result);
             }

package/dist/commands/agent/workspaces.js

@@ -4,7 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getGuildcoreUrl } from '../../lib/config.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
-import { getAgentId } from '../../lib/agent-helpers.js';
+import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 export function createAgentWorkspacesCommand() {
@@ -22,7 +22,8 @@ export function createAgentWorkspacesCommand() {
         const limit = parseInt(options.limit, 10);
         const offset = parseInt(options.offset, 10);
         try {
-            const result = await client.get(`/agents/${agentId}/workspaces?limit=${limit}&offset=${offset}`);
+            const resolvedId = await resolveAgentRef(client, agentId);
+            const result = await client.get(`/agents/${resolvedId}/workspaces?limit=${limit}&offset=${offset}`);
             if (getOutputMode() === 'json') {
                 output.data(result);
             }

package/dist/commands/credentials/endpoint-list.d.ts

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