@guildai/cli 0.9.1 → 0.10.0

package/dist/commands/agent/fork.js

@@ -143,6 +143,7 @@ export function createAgentForkCommand() {
                 ownerFlag: options.owner,
                 client,
                 interactive: isInteractive(),
+                requireExplicitOwner: true,
             });
             // Create forked agent
             output.progress(`✓ Forking agent '${agentName}'...`);

package/dist/commands/agent/init.js

@@ -192,6 +192,7 @@ export function createAgentInitCommand() {
                 ownerFlag: options.owner,
                 client,
                 interactive: isInteractive(),
+                requireExplicitOwner: true,
             });
             const agent = await client.post('/agents', {
                 name: agentName,

package/dist/commands/agent/list.js

@@ -6,6 +6,7 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -23,8 +24,8 @@ export function createAgentListCommand() {
         .option('--all', 'Show all agents including archived')
         .option('--owner <name>', 'Filter by owner (user or org name). Without this flag, lists your own agents')
         .option('--workspace <id>', 'Filter agents by workspace ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         if (options.archived && options.all) {

package/dist/commands/agent/pull.js

@@ -13,7 +13,7 @@ export function createAgentPullCommand() {
     const cmd = new Command('pull');
     cmd
         .description('Pull remote changes into local agent directory')
-        .option('--json', 'Output JSON only (no progress messages)', false)
+        .option('--json', 'Output JSON only, no progress messages (default: off)', false)
         .action(async (_options) => {
         const cwd = process.cwd();
         const output = createOutputWriter();

package/dist/commands/agent/save.js

@@ -16,11 +16,11 @@ export function createAgentSaveCommand() {
         .description('Commit, push, and create a new agent version')
         .option('-A, --all', 'Stage all changes and commit before pushing', false)
         .option('-m, --message <text>', 'Commit message (required with --all)')
-        .option('--wait', 'Wait for validation to complete before returning', false)
-        .option('--publish', 'Publish after validation passes (implies --wait)', false)
-        .option('--bump [level]', 'Bump package.json version before saving (patch, or minor/major)', 'patch')
+        .option('--wait', 'Wait for validation to complete before returning (default: returns immediately)', false)
+        .option('--publish', 'Publish after validation passes (implies --wait) (default: does not publish)', false)
+        .option('--bump [level]', 'Bump package.json version before saving (patch, or minor/major) (default: patch)', 'patch')
         .option('--no-bump', 'Skip automatic version bump')
-        .option('--json', 'Output JSON only (no progress messages)', false)
+        .option('--json', 'Output JSON only, no progress messages (default: off)', false)
         .action(async (options) => {
         const cwd = process.cwd();
         let guildConfig = null;

package/dist/commands/agent/search.js

@@ -6,6 +6,7 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatAgentTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -19,8 +20,8 @@ export function createAgentSearchCommand() {
         .argument('<query>', 'Search query')
         .option('--sort <field>', 'Sort by: updated, newest, name, popular (default: updated)', 'updated')
         .option('--published', 'Only show published agents')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (query, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/agent/versions.js

@@ -7,13 +7,14 @@ import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatVersionTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createAgentVersionsCommand() {
     const cmd = new Command('versions');
     cmd
         .description('List all versions of an agent')
         .argument('[identifier]', 'Agent ID or full name (e.g., owner~agent-name)')
-        .option('--limit <number>', 'Maximum number of versions to return', '20')
-        .option('--offset <number>', 'Number of versions to skip', '0')
+        .option('--limit <number>', `Maximum number of versions to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Number of versions to skip (default: 0)', '0')
         .action(async (agentIdArg, options) => {
         const output = createOutputWriter();
         // Get agent ID from argument or guild.json

package/dist/commands/agent/workspaces.js

@@ -7,13 +7,14 @@ import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getAgentId, resolveAgentRef } from '../../lib/agent-helpers.js';
 import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
 import { getOutputMode } from '../../lib/output-mode.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createAgentWorkspacesCommand() {
     const cmd = new Command('workspaces');
     cmd
         .description('List workspaces that use an agent')
         .argument('[identifier]', 'Agent ID or full name (e.g., owner~agent-name)')
-        .option('--limit <number>', 'Maximum number of workspaces to return', '20')
-        .option('--offset <number>', 'Number of workspaces to skip', '0')
+        .option('--limit <number>', `Maximum number of workspaces to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Number of workspaces to skip (default: 0)', '0')
         .action(async (agentIdArg, options) => {
         const output = createOutputWriter();
         const { agentId } = await getAgentId(agentIdArg);

package/dist/commands/chat.d.ts

@@ -2,6 +2,15 @@ import React from 'react';
 import { Command } from 'commander';
 import { GuildAPIClient } from '../lib/api-client.js';
 import { SessionEvent, Session } from '../lib/session-events.js';
+/** Thrown when no workspace is configured (no --workspace flag, no config). */
+export declare class WorkspaceNotConfiguredError extends Error {
+    constructor();
+}
+/** Thrown when the specified workspace ID is not found in the backend. */
+export declare class WorkspaceNotFoundError extends Error {
+    readonly workspaceId: string;
+    constructor(workspaceId: string);
+}
 /**
  * ChatApp wrapper component that shows splash animation during connection
  * and then transitions to ChatUIWithConnection once connected.

package/dist/commands/chat.js

@@ -31,6 +31,28 @@ import { getOutputMode, isQuietMode } from '../lib/output-mode.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // Read version from package.json
 const packageJson = JSON.parse(readFileSync(path.join(__dirname, '../../package.json'), 'utf-8'));
+// ---------------------------------------------------------------------------
+// Workspace error types
+// ---------------------------------------------------------------------------
+/** Thrown when no workspace is configured (no --workspace flag, no config). */
+export class WorkspaceNotConfiguredError extends Error {
+    constructor() {
+        super('No workspace configured.');
+        this.name = 'WorkspaceNotConfiguredError';
+    }
+}
+/** Thrown when the specified workspace ID is not found in the backend. */
+export class WorkspaceNotFoundError extends Error {
+    workspaceId;
+    constructor(workspaceId) {
+        super(`Workspace ${workspaceId} not found.`);
+        this.name = 'WorkspaceNotFoundError';
+        this.workspaceId = workspaceId;
+    }
+}
+/** User-facing error messages for workspace resolution failures. */
+const WORKSPACE_NOT_CONFIGURED_MSG = 'No workspace configured. Pass a --workspace <id_or_name> argument or run guild workspace select';
+const WORKSPACE_NOT_FOUND_MSG = "The workspace doesn't exist.";
 // Configure marked for terminal
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 marked.use(markedTerminal({}, { theme: {} }));
@@ -264,8 +286,11 @@ export function ChatApp({ initialPrompt, version, workspaceId, versionId, agentN
                     formattedError.code === ErrorCodes.AUTH_TOKEN_INVALID) {
                     format.error('Not authenticated. Run: guild auth login');
                 }
-                else if (details.includes('workspace')) {
-                    format.error('Workspace not found. Run: guild workspace select');
+                else if (error instanceof WorkspaceNotConfiguredError) {
+                    format.error(WORKSPACE_NOT_CONFIGURED_MSG);
+                }
+                else if (error instanceof WorkspaceNotFoundError) {
+                    format.error(WORKSPACE_NOT_FOUND_MSG);
                 }
                 else if (details.includes('agent')) {
                     format.error('Agent not found in workspace.');
@@ -1108,7 +1133,7 @@ export async function createSession(client, workspaceId, initialPrompt, versionI
         }
     }
     if (!workspaceId) {
-        throw new Error('No workspace configured. Run: guild workspace select, or pass --workspace <id>');
+        throw new WorkspaceNotConfiguredError();
     }
     progress('Creating session');
     const sessionData = {
@@ -1127,7 +1152,7 @@ export async function createSession(client, workspaceId, initialPrompt, versionI
     catch (error) {
         const err = handleAxiosError(error);
         if (err.code === ErrorCodes.NOT_FOUND) {
-            throw new Error(`Workspace ${workspaceId} not found. Run: guild workspace select`);
+            throw new WorkspaceNotFoundError(workspaceId);
         }
         throw error;
     }
@@ -1256,6 +1281,14 @@ export function createChatCommand() {
             catch (error) {
                 spinner.fail('Connection failed');
                 console.error('');
+                if (error instanceof WorkspaceNotConfiguredError) {
+                    format.error(WORKSPACE_NOT_CONFIGURED_MSG);
+                    process.exit(1);
+                }
+                if (error instanceof WorkspaceNotFoundError) {
+                    format.error(WORKSPACE_NOT_FOUND_MSG);
+                    process.exit(1);
+                }
                 const formattedError = handleAxiosError(error);
                 console.error(`Error: ${formattedError.error}`);
                 console.error(formattedError.details);

package/dist/commands/credentials/endpoint-list.js

@@ -7,6 +7,7 @@ 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';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 import { Table } from '../../lib/table.js';
 export function createCredentialsEndpointListCommand() {
     const cmd = new Command('list');
@@ -15,8 +16,8 @@ export function createCredentialsEndpointListCommand() {
         .argument('<credential-id>', 'Credential ID')
         .option('--include-previous-versions', 'Include endpoints from previous versions')
         .option('--search <query>', 'Search by operation name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (credentialId, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/credentials/list.js

@@ -6,14 +6,15 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatCredentialsTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createCredentialsListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List credentials for an account')
         .requiredOption('--owner <account>', 'Account name or ID')
         .option('--search <query>', 'Filter by integration name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/credentials/policy-list.js

@@ -6,13 +6,14 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatPoliciesTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createCredentialsPolicyListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List policies for a credential')
         .argument('<credential-id>', 'Credential ID')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (credentialId, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/integration/list.js

@@ -6,6 +6,7 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatIntegrationTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 const SORT_MAP = {
     updated: 'updated_at',
     newest: 'created_at',
@@ -18,8 +19,8 @@ export function createIntegrationListCommand() {
         .option('--search <query>', 'Search integrations by name or description')
         .option('--sort <field>', 'Sort by: updated, newest, name (default: updated)', 'updated')
         .option('--published', 'Only show integrations with at least one published version')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/integration/operation/list.js

@@ -9,14 +9,15 @@ import { getOutputMode } from '../../../lib/output-mode.js';
 import { createOutputWriter } from '../../../lib/output.js';
 import { resolveVersionId } from '../../../lib/integration-helpers.js';
 import { Table } from '../../../lib/table.js';
+import { DEFAULT_PAGE_LIMIT_LARGE } from '../../../lib/api-types.js';
 export function createIntegrationOperationListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List operations for an integration version')
         .argument('<id_or_name>', 'Integration ID or name (owner~name)')
         .option('--version-number <semver>', 'Specific version, e.g. 1.0.0')
-        .option('--limit <number>', 'Number of results to return', '100')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT_LARGE})`, String(DEFAULT_PAGE_LIMIT_LARGE))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (identifier, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/integration/version/list.js

@@ -6,13 +6,14 @@ import { getAuthToken } from '../../../lib/auth.js';
 import { handleAxiosError } from '../../../lib/errors.js';
 import { getOutputMode } from '../../../lib/output-mode.js';
 import { createOutputWriter, formatIntegrationVersionTable, } from '../../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createIntegrationVersionListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List integration versions')
         .argument('<id_or_name>', 'Integration ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (identifier, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/session/create.js

@@ -11,7 +11,7 @@ export function createSessionCreateCommand() {
     cmd
         .description('Create a new session')
         .option('--workspace <id>', 'Workspace ID or name (e.g., owner~workspace-name)')
-        .option('--type <type>', 'Session type: chat or agent_test', 'chat')
+        .option('--type <type>', 'Session type: chat or agent_test (default: chat)', 'chat')
         .option('--prompt <text>', 'Initial prompt (required for chat sessions)')
         .option('--agent <identifier>', 'Agent identifier, e.g., owner~agent-name')
         .action(async (options) => {

package/dist/commands/session/events.js

@@ -4,6 +4,7 @@ import { Command } from 'commander';
 import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { parseEventFilter, DEFAULT_EVENT_TYPES, USER_EVENT_TYPES, SYSTEM_EVENT_TYPES, } from '../../lib/event-filter.js';
+import { DEFAULT_PAGE_LIMIT_LARGE } from '../../lib/api-types.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
 export function createSessionEventsCommand() {
@@ -12,8 +13,8 @@ export function createSessionEventsCommand() {
         .description('List events in a session')
         .argument('<session-id>', 'Session ID')
         .option('--events <types>', 'Event types to show (default: user). Shorthands: none, user, system, all, or comma-separated type names')
-        .option('--limit <number>', 'Number of results to return', '100')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT_LARGE})`, String(DEFAULT_PAGE_LIMIT_LARGE))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .addHelpText('after', [
         '',
         'Available event types:',

package/dist/commands/session/list.js

@@ -7,14 +7,15 @@ import { getWorkspaceId } from '../../lib/guild-config.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatSessionTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createSessionListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List sessions in a workspace')
         .option('--workspace <id>', 'Workspace ID or name (e.g., owner~workspace-name)')
         .option('--type <type>', 'Filter by session type: chat, webhook, time, agent_test')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/session/tasks.js

@@ -6,13 +6,14 @@ import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatTaskTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT_LARGE } from '../../lib/api-types.js';
 export function createSessionTasksCommand() {
     const cmd = new Command('tasks');
     cmd
         .description('List tasks in a session')
         .argument('<session-id>', 'Session ID')
-        .option('--limit <number>', 'Number of results to return', '100')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT_LARGE})`, String(DEFAULT_PAGE_LIMIT_LARGE))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (sessionId, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/trigger/list.js

@@ -7,13 +7,14 @@ import { getWorkspaceId } from '../../lib/guild-config.js';
 import { handleAxiosError } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatTriggerTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createTriggerListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List all triggers in a workspace')
         .option('--workspace <id>', 'Workspace ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/trigger/sessions.js

@@ -5,13 +5,14 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { getAuthToken } from '../../lib/auth.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { createOutputWriter } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createTriggerSessionsCommand() {
     const cmd = new Command('sessions');
     cmd
         .description('List sessions spawned by a trigger')
         .argument('<trigger-id>', 'Trigger ID')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (triggerId, options) => {
         const output = createOutputWriter();
         try {

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

@@ -8,13 +8,14 @@ import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { createOutputWriter, formatWorkspaceAgentTable } from '../../../lib/output.js';
 import { getOutputMode } from '../../../lib/output-mode.js';
 import { resolveWorkspaceId } from '../../../lib/workspace-helpers.js';
+import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceAgentListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List agents in a workspace')
         .option('--workspace <id>', 'Workspace ID or name')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/workspace/context/list.js

@@ -5,13 +5,14 @@ import { GuildAPIClient } from '../../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../../lib/errors.js';
 import { getOutputMode } from '../../../lib/output-mode.js';
 import { createOutputWriter, formatContextTable } from '../../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../../lib/api-types.js';
 export function createWorkspaceContextListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List context versions for a workspace')
         .argument('<workspace>', 'Workspace ID or full name (e.g., owner/workspace-name)')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .action(async (workspaceId, options) => {
         const output = createOutputWriter();
         try {

package/dist/commands/workspace/list.js

@@ -5,12 +5,13 @@ import { GuildAPIClient } from '../../lib/api-client.js';
 import { handleAxiosError, ErrorCodes } from '../../lib/errors.js';
 import { getOutputMode } from '../../lib/output-mode.js';
 import { createOutputWriter, formatWorkspaceTable } from '../../lib/output.js';
+import { DEFAULT_PAGE_LIMIT } from '../../lib/api-types.js';
 export function createWorkspaceListCommand() {
     const cmd = new Command('list');
     cmd
         .description('List workspaces')
-        .option('--limit <number>', 'Number of results to return', '20')
-        .option('--offset <number>', 'Offset for pagination', '0')
+        .option('--limit <number>', `Number of results to return (default: ${DEFAULT_PAGE_LIMIT})`, String(DEFAULT_PAGE_LIMIT))
+        .option('--offset <number>', 'Offset for pagination (default: 0)', '0')
         .option('--owner <name>', 'Filter workspaces by owner name (case-insensitive)')
         .action(async (options) => {
         const output = createOutputWriter();

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

@@ -159,6 +159,10 @@ export interface Pagination {
     offset: number;
     has_more: boolean;
 }
+/** Default page size for standard list endpoints (matches backend). */
+export declare const DEFAULT_PAGE_LIMIT = 20;
+/** Default page size for high-volume endpoints (events, tasks, operations). */
+export declare const DEFAULT_PAGE_LIMIT_LARGE = 100;
 /**
  * Generic paginated response wrapper.
  * All list endpoints return { items: T[], pagination: Pagination }

package/dist/lib/api-types.js

@@ -1,5 +1,9 @@
 // Copyright 2026 Guild.ai
 // SPDX-License-Identifier: Apache-2.0
+/** Default page size for standard list endpoints (matches backend). */
+export const DEFAULT_PAGE_LIMIT = 20;
+/** Default page size for high-volume endpoints (events, tasks, operations). */
+export const DEFAULT_PAGE_LIMIT_LARGE = 100;
 // Import and re-export generated types (from cli/scripts/sync-types-from-python.py)
 import { WEBHOOK_SERVICES, TIME_TRIGGER_FREQUENCIES, } from './generated-types.js';
 export { WEBHOOK_SERVICES, TIME_TRIGGER_FREQUENCIES, };

package/dist/lib/output.js

@@ -195,7 +195,7 @@ export function formatVersionTable(versions, pagination) {
                 ? chalk.red
                 : chalk.dim;
         table.addRow({
-            id: v.id.substring(0, 8),
+            id: v.id,
             version: v.version_number || '-',
             status: v.status,
             validation: validationColor(v.validation_status || '-'),
@@ -225,7 +225,7 @@ export function formatContextTable(contexts, pagination) {
     });
     contexts.forEach((ctx) => {
         table.addRow({
-            id: truncate(ctx.id, 12),
+            id: ctx.id,
             status: ctx.status,
             type: ctx.type || '-',
             created: ctx.created_at ? formatRelativeTime(ctx.created_at) : '',
@@ -256,7 +256,7 @@ export function formatWorkspaceAgentTable(agents) {
         const agentUrl = wa.agent.full_name ? `${base}/agents/${wa.agent.full_name}` : '';
         table.addRow({
             name: agentUrl ? hyperlink(name, agentUrl) : name,
-            version: wa.agent_version.version_number || wa.agent_version.id.substring(0, 8),
+            version: wa.agent_version.version_number || wa.agent_version.id,
             auto_update: wa.should_autoupdate ? chalk.green('yes') : chalk.dim('no'),
         });
     });
@@ -353,7 +353,7 @@ export function formatTaskTable(tasks, pagination) {
                     ? chalk.yellow
                     : chalk.dim;
         table.addRow({
-            id: truncate(task.id, 13),
+            id: task.id,
             name,
             status: statusColor(task.status),
             tokens: task.token_usage ? task.token_usage.total_tokens.toLocaleString() : '-',

package/dist/lib/owner-helpers.d.ts

@@ -13,6 +13,9 @@ export interface ResolveOwnerOptions {
     ownerFlag?: string;
     client: GuildAPIClient;
     interactive: boolean;
+    /** When true, error if multiple accounts and no explicit owner in non-interactive mode.
+     *  When false (default), fall back to current user. */
+    requireExplicitOwner?: boolean;
 }
 export declare function resolveOwnerId(options: ResolveOwnerOptions): Promise<OwnerChoice>;
 //# sourceMappingURL=owner-helpers.d.ts.map

package/dist/lib/owner-helpers.js

@@ -11,9 +11,10 @@
  * 2. GUILD_OWNER_ID environment variable
  * 3. default_owner from ~/.guild/config.json
  * 4. Fetch user + orgs from API:
- *    - No orgs → use current user
- *    - Has orgs + interactive → prompt
- *    - Has orgs + non-interactive → use current user
+ *    - No orgs + non-interactive → use current user (single-account, stated explicitly)
+ *    - No orgs + interactive → prompt with personal account as only choice
+ *    - Has orgs + interactive → prompt to select from all accounts
+ *    - Has orgs + non-interactive → error: require --owner flag
  */
 import inquirer from 'inquirer';
 import { loadGlobalConfig } from './guild-config.js';
@@ -35,7 +36,7 @@ export async function lookupOwner(client, val) {
     return undefined;
 }
 export async function resolveOwnerId(options) {
-    const { ownerFlag, client, interactive } = options;
+    const { ownerFlag, client, interactive, requireExplicitOwner = false } = options;
     // Priority 1: --owner flag
     if (ownerFlag) {
         debug('Using owner from --owner flag: %s', ownerFlag);
@@ -71,17 +72,23 @@ export async function resolveOwnerId(options) {
     // Priority 4: Fetch user + orgs
     const me = await client.get('/me');
     const orgs = await client.fetchAll('/me/organizations');
-    // No orgs → use current user
-    if (orgs.length === 0) {
+    // No orgs + non-interactive → use current user (single account, stated explicitly by caller)
+    if (orgs.length === 0 && !interactive) {
         debug('No organizations found, using current user as owner');
         return { id: me.id, name: me.name, type: 'user' };
     }
-    // Has orgs + non-interactive → use current user
-    if (!interactive) {
-        debug('Non-interactive mode with orgs available, using current user as owner');
+    // Has orgs + non-interactive
+    if (orgs.length > 0 && !interactive) {
+        if (requireExplicitOwner) {
+            debug('Non-interactive mode with multiple accounts available, requiring --owner');
+            throw new Error('Owner is required in non-interactive mode when multiple accounts are available.\n\n' +
+                'Use --owner <name-or-id> to specify an owner, or set a default:\n' +
+                '  guild config set default_owner <name-or-id>');
+        }
+        debug('Multiple accounts available, defaulting to current user');
         return { id: me.id, name: me.name, type: 'user' };
     }
-    // Has orgs + interactive → prompt
+    // Interactive → prompt (always, even with single account)
     const choices = [
         {
             name: `${me.name} (personal)`,

package/package.json

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