@guildai/cli 0.5.1 → 0.5.2

package/README.md

@@ -58,17 +58,23 @@ guild auth status   # Check authentication status
 
 ```bash
 guild agent init --name my-agent        # Initialize a new agent
+guild agent clone <agent-id>            # Clone agent locally
 guild agent save                        # Push commits and create a version
 guild agent save -A --message "..."    # Stage+commit+push in one step
-guild agent versions                    # List versions
-guild agent publish                     # Publish latest draft version
-guild agent unpublish                   # Unpublish latest published version
-guild agent test                        # Test agent
-guild agent chat                        # Chat with agent in current directory
-guild agent get <agent-id>              # Get agent details
-guild agent code <agent-id>             # Fetch latest published code
-guild agent clone <agent-id>            # Clone agent locally
+guild agent pull                        # Pull remote changes
+guild agent test                        # Test agent interactively
+guild agent test --ephemeral            # Test unsaved changes
+guild agent chat "message"              # Send a single message
+guild agent get [agent-id]              # Get agent details
+guild agent versions [agent-id]         # List versions
+guild agent code [agent-id]             # View latest published source
 guild agent list                        # List all agents
+guild agent grep <pattern>              # Search agent source code
+guild agent publish                     # Publish latest draft version
+guild agent unpublish                   # Remove from catalog
+guild agent revalidate                  # Re-run validation
+guild agent update                      # Update agent metadata
+guild agent owners                      # List accounts that can own agents
 guild agent tags list                   # List tags
 guild agent tags add <tag...>           # Add tags
 guild agent tags remove <tag...>        # Remove tags

package/dist/commands/agent/save.js

@@ -258,7 +258,7 @@ export function createAgentSaveCommand() {
             output.progress('');
             output.progress('Version details:');
             output.progress(`  ID: ${version.id}`);
-            output.progress(`  SHA: ${version.sha.substring(0, 12)}`);
+            output.progress(`  SHA: ${version.sha ? version.sha.substring(0, 12) : '-'}`);
             output.progress(`  Status: ${version.status}`);
             if (version.published_at) {
                 output.progress(`  Published at: ${version.published_at}`);

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

@@ -58,7 +58,7 @@ export function createWorkspaceAgentAddCommand() {
             // Display success
             const versionDisplay = response.agent_version.version_number
                 ? `v${response.agent_version.version_number}`
-                : response.agent_version.sha.slice(0, 7);
+                : (response.agent_version.sha?.slice(0, 7) ?? '-');
             const workspaceName = response.workspace?.name || 'workspace';
             output.success(`Added ${response.agent.full_name} to workspace "${workspaceName}"`, {
                 Agent: response.agent.full_name,

package/dist/commands/workspace/select.js

@@ -18,6 +18,16 @@ function formatWorkspaceDisplay(workspace) {
     }
     return base;
 }
+/**
+ * Match a workspace against a search argument (case-insensitive name, full_name, or exact ID).
+ */
+function matchesWorkspaceArg(w, arg) {
+    return (w.name === arg ||
+        w.name.toLowerCase() === arg.toLowerCase() ||
+        w.full_name === arg ||
+        w.full_name?.toLowerCase() === arg.toLowerCase() ||
+        w.id === arg);
+}
 export function createWorkspaceSelectCommand() {
     const cmd = new Command('select');
     cmd
@@ -27,24 +37,25 @@ export function createWorkspaceSelectCommand() {
         const output = createOutputWriter();
         try {
             const client = new GuildAPIClient();
-            // Use filter=all to get workspaces from all orgs user is a member of
-            const workspaces = await client.get('/me/workspaces?filter=all');
-            if (workspaces.items.length === 0) {
-                output.error('No workspaces found.', 'Create a workspace first:\n  guild workspace create <name>');
-                process.exit(1);
-            }
-            // If a workspace argument was provided, find and select it directly
+            // If a workspace argument was provided, use server-side search to find it
             if (workspaceArg) {
-                const workspace = workspaces.items.find((w) => w.name === workspaceArg ||
-                    w.name.toLowerCase() === workspaceArg.toLowerCase() ||
-                    w.full_name === workspaceArg ||
-                    w.full_name?.toLowerCase() === workspaceArg.toLowerCase() ||
-                    w.id === workspaceArg);
+                // Use search param to narrow results server-side, then exact-match client-side.
+                // The backend searches only the "name" column via ILIKE, so full_name (owner/name)
+                // and ID lookups may not return results. Extract just the name part for search,
+                // and if still no match, fall back to fetching the full list.
+                const searchTerm = workspaceArg.includes('/')
+                    ? workspaceArg.split('/').pop()
+                    : workspaceArg;
+                const searchResults = await client.get(`/me/workspaces?filter=all&search=${encodeURIComponent(searchTerm)}&limit=100`);
+                let workspace = searchResults.items.find((w) => matchesWorkspaceArg(w, workspaceArg));
+                // Search didn't find it (could be an ID lookup, or search term didn't match).
+                // Fall back to fetching all workspaces via pagination.
                 if (!workspace) {
-                    const available = workspaces.items
-                        .map((w) => `  - ${formatWorkspaceDisplay(w)}`)
-                        .join('\n');
-                    output.error(`Workspace "${workspaceArg}" not found.`, `Available workspaces:\n${available}`);
+                    const allWorkspaces = await client.fetchAll('/me/workspaces?filter=all');
+                    workspace = allWorkspaces.find((w) => matchesWorkspaceArg(w, workspaceArg));
+                }
+                if (!workspace) {
+                    output.error(`Workspace "${workspaceArg}" not found.`, 'Run: guild workspace list');
                     process.exit(1);
                 }
                 const target = await saveWorkspaceConfig(workspace.id, workspace.name);
@@ -56,6 +67,12 @@ export function createWorkspaceSelectCommand() {
                 }
                 return;
             }
+            // Interactive mode: fetch workspaces for selection
+            const workspaces = await client.get('/me/workspaces?filter=all');
+            if (workspaces.items.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

package/dist/lib/api-types.d.ts

@@ -63,7 +63,7 @@ export interface WorkspaceAgent {
     };
     agent_version: {
         id: string;
-        sha: string;
+        sha: string | null;
         version_number: string | null;
     };
     workspace?: {
@@ -83,7 +83,7 @@ export interface AgentVersion {
     id: string;
     agent_id?: string;
     author_id?: string;
-    sha: string;
+    sha: string | null;
     summary: string;
     status: string;
     validation_status?: string;
@@ -227,7 +227,7 @@ export interface TriggerWorkspaceAgent {
     };
     agent_version: {
         id: string;
-        sha: string;
+        sha: string | null;
         version_number: string | null;
     };
 }

package/dist/lib/output.js

@@ -102,7 +102,7 @@ export function formatVersionTable(versions, pagination) {
                 ? chalk.red
                 : chalk.dim;
         table.addRow({
-            sha: v.sha.slice(0, 7),
+            sha: v.sha ? v.sha.slice(0, 7) : '-',
             version: v.version_number || '-',
             status: v.status,
             validation: validationColor(v.validation_status || '-'),
@@ -176,7 +176,8 @@ export function formatWorkspaceAgentTable(agents) {
     agents.forEach((wa) => {
         table.addRow({
             name: wa.agent.full_name || wa.agent.name,
-            version: wa.agent_version.version_number || wa.agent_version.sha.slice(0, 7),
+            version: wa.agent_version.version_number ||
+                (wa.agent_version.sha ? wa.agent_version.sha.slice(0, 7) : '-'),
             auto_update: wa.should_autoupdate ? chalk.green('yes') : chalk.dim('no'),
         });
     });
@@ -238,7 +239,7 @@ export function formatSessionTable(sessions, pagination) {
     });
     sessions.forEach((session) => {
         table.addRow({
-            id: truncate(session.id, 8),
+            id: session.id,
             type: session.session_type,
             name: session.name ? truncate(session.name, 30) : '-',
             workspace: session.workspace?.name || '',
@@ -281,7 +282,7 @@ export function formatTriggerTable(triggers, pagination) {
                 ? chalk.dim('inactive')
                 : chalk.green('active');
         table.addRow({
-            id: truncate(trigger.id, 8),
+            id: trigger.id,
             type: trigger.type,
             agent: trigger.agent?.full_name || trigger.agent?.name || '',
             status,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guildai/cli",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Guild.ai CLI - Build, test, and deploy AI agents",
   "type": "module",
   "main": "dist/index.js",