@guildai/cli 0.5.0 → 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/owners.js

@@ -13,7 +13,7 @@ export function createAgentOwnersCommand() {
             const client = new GuildAPIClient();
             const [me, orgs, globalConfig] = await Promise.all([
                 client.get('/me'),
-                client.get('/me/organizations'),
+                client.fetchAll('/me/organizations'),
                 loadGlobalConfig(),
             ]);
             const defaultOwnerId = globalConfig?.default_owner;
@@ -24,7 +24,7 @@ export function createAgentOwnersCommand() {
                     type: 'user',
                     is_default: defaultOwnerId === me.id,
                 },
-                ...orgs.items.map((org) => ({
+                ...orgs.map((org) => ({
                     id: org.id,
                     name: org.name,
                     type: 'organization',

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/config/set.js

@@ -56,8 +56,8 @@ async function resolveOwnerName(ownerId) {
         if (me.id === ownerId) {
             return me.name;
         }
-        const orgs = await client.get('/me/organizations');
-        const org = orgs.items.find((o) => o.id === ownerId);
+        const orgs = await client.fetchAll('/me/organizations');
+        const org = orgs.find((o) => o.id === ownerId);
         return org?.name;
     }
     catch (error) {

package/dist/commands/trigger/create.js

@@ -50,8 +50,8 @@ export function createTriggerCreateCommand() {
             }
             const client = new GuildAPIClient();
             // Find workspace_agent_id from agent identifier
-            const workspaceAgentsResponse = await client.get(`/workspaces/${workspaceId}/workspace_agents`);
-            const workspaceAgent = workspaceAgentsResponse.items.find((wa) => wa.agent.full_name === options.agent ||
+            const allWorkspaceAgents = await client.fetchAll(`/workspaces/${workspaceId}/workspace_agents`);
+            const workspaceAgent = allWorkspaceAgents.find((wa) => wa.agent.full_name === options.agent ||
                 wa.agent.name === options.agent ||
                 wa.agent.id === options.agent);
             if (!workspaceAgent) {

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/agent/remove.js

@@ -30,10 +30,10 @@ export function createWorkspaceAgentRemoveCommand() {
                 }
                 workspaceId = resolved.workspaceId;
             }
-            // List workspace agents to find the one to remove
-            const response = await client.get(`/workspaces/${workspaceId}/workspace_agents`);
+            // List all workspace agents to find the one to remove
+            const allWorkspaceAgents = await client.fetchAll(`/workspaces/${workspaceId}/workspace_agents`);
             // Find the agent by identifier (match full_name, name, agent id, or workspace_agent id)
-            const workspaceAgent = response.items.find((wa) => wa.id === agentIdentifier ||
+            const workspaceAgent = allWorkspaceAgents.find((wa) => wa.id === agentIdentifier ||
                 wa.agent.full_name === agentIdentifier ||
                 wa.agent.name === agentIdentifier ||
                 wa.agent.id === agentIdentifier);

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-client.d.ts

@@ -50,5 +50,13 @@ export declare class GuildAPIClient {
      * Make a DELETE request
      */
     delete<T = unknown>(endpoint: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Fetch all items from a paginated endpoint by paging through results.
+     * Use for display commands or ID-based lookups where you need the complete list.
+     *
+     * @param endpoint - API endpoint path (may include query params)
+     * @returns Flat array of all items across all pages
+     */
+    fetchAll<T>(endpoint: string): Promise<T[]>;
 }
 //# sourceMappingURL=api-client.d.ts.map

package/dist/lib/api-client.js

@@ -121,5 +121,27 @@ export class GuildAPIClient {
     async delete(endpoint, config) {
         return this.request('DELETE', endpoint, config);
     }
+    /**
+     * Fetch all items from a paginated endpoint by paging through results.
+     * Use for display commands or ID-based lookups where you need the complete list.
+     *
+     * @param endpoint - API endpoint path (may include query params)
+     * @returns Flat array of all items across all pages
+     */
+    async fetchAll(endpoint) {
+        const PAGE_SIZE = 100;
+        const allItems = [];
+        let offset = 0;
+        while (true) {
+            const separator = endpoint.includes('?') ? '&' : '?';
+            const url = `${endpoint}${separator}limit=${PAGE_SIZE}&offset=${offset}`;
+            const response = await this.get(url);
+            allItems.push(...response.items);
+            offset += response.pagination.limit;
+            if (!response.pagination.has_more)
+                break;
+        }
+        return allItems;
+    }
 }
 //# sourceMappingURL=api-client.js.map

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;
@@ -170,7 +170,7 @@ export type AgentListResponse = PaginatedResponse<Agent>;
 export type WorkspaceListResponse = PaginatedResponse<Workspace>;
 export type VersionListResponse = PaginatedResponse<AgentVersion>;
 export type ContextListResponse = PaginatedResponse<Context>;
-export type WorkspaceAgentListResponse = CountedResponse<WorkspaceAgent>;
+export type WorkspaceAgentListResponse = PaginatedResponse<WorkspaceAgent>;
 /**
  * Response from creating a new agent.
  */
@@ -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/dist/lib/owner-helpers.js

@@ -27,8 +27,8 @@ export async function resolveOwnerId(options) {
         if (me.id === ownerFlag) {
             return { id: me.id, name: me.name, type: 'user' };
         }
-        const orgs = await client.get('/me/organizations');
-        const org = orgs.items.find((o) => o.id === ownerFlag);
+        const orgs = await client.fetchAll('/me/organizations');
+        const org = orgs.find((o) => o.id === ownerFlag);
         if (org) {
             return { id: org.id, name: org.name, type: 'organization' };
         }
@@ -43,8 +43,8 @@ export async function resolveOwnerId(options) {
         if (me.id === envOwnerId) {
             return { id: me.id, name: me.name, type: 'user' };
         }
-        const orgs = await client.get('/me/organizations');
-        const org = orgs.items.find((o) => o.id === envOwnerId);
+        const orgs = await client.fetchAll('/me/organizations');
+        const org = orgs.find((o) => o.id === envOwnerId);
         if (org) {
             return { id: org.id, name: org.name, type: 'organization' };
         }
@@ -63,9 +63,9 @@ export async function resolveOwnerId(options) {
     }
     // Priority 4: Fetch user + orgs
     const me = await client.get('/me');
-    const orgs = await client.get('/me/organizations');
+    const orgs = await client.fetchAll('/me/organizations');
     // No orgs → use current user
-    if (orgs.items.length === 0) {
+    if (orgs.length === 0) {
         debug('No organizations found, using current user as owner');
         return { id: me.id, name: me.name, type: 'user' };
     }
@@ -80,7 +80,7 @@ export async function resolveOwnerId(options) {
             name: `${me.name} (personal)`,
             value: { id: me.id, name: me.name, type: 'user' },
         },
-        ...orgs.items.map((org) => ({
+        ...orgs.map((org) => ({
             name: org.name,
             value: { id: org.id, name: org.name, type: 'organization' },
         })),

package/package.json

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