@rudderhq/cli 0.3.4-canary.2 → 0.3.4-canary.21

package/dist/index.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 
 // ../packages/shared/dist/constants.js
-var ORGANIZATION_STATUSES, ORGANIZATION_INTELLIGENCE_PROFILE_PURPOSES, ORGANIZATION_INTELLIGENCE_PROFILE_STATUSES, DEPLOYMENT_MODES, DEPLOYMENT_EXPOSURES, AUTH_BASE_URL_MODES, AGENT_STATUSES, AGENT_RUNTIME_TYPES, AGENT_ROLES, AGENT_ICON_NAMES, AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX, AGENT_AVATAR_BACKGROUND_PRESET_IDS, ISSUE_STATUSES, ISSUE_PRIORITIES, CALENDAR_SOURCE_TYPES, CALENDAR_OWNER_TYPES, CALENDAR_VISIBILITIES, CALENDAR_SOURCE_STATUSES, CALENDAR_EVENT_KINDS, CALENDAR_EVENT_STATUSES, CALENDAR_SOURCE_MODES, CHAT_CONVERSATION_STATUSES, CHAT_ISSUE_CREATION_MODES, CHAT_MESSAGE_ROLES, CHAT_MESSAGE_KINDS, CHAT_MESSAGE_STATUSES, CHAT_CONTEXT_ENTITY_TYPES, GOAL_LEVELS, GOAL_STATUSES, PROJECT_STATUSES, ORGANIZATION_RESOURCE_KINDS, ORGANIZATION_RESOURCE_SOURCE_TYPES, PROJECT_RESOURCE_ATTACHMENT_ROLES, AUTOMATION_STATUSES, AUTOMATION_CONCURRENCY_POLICIES, AUTOMATION_CATCH_UP_POLICIES, AUTOMATION_OUTPUT_MODES, AUTOMATION_TRIGGER_SIGNING_MODES, PROJECT_COLORS, APPROVAL_TYPES, SECRET_PROVIDERS, STORAGE_PROVIDERS, BILLING_TYPES, FINANCE_EVENT_KINDS, FINANCE_DIRECTIONS, FINANCE_UNITS, BUDGET_SCOPE_TYPES, BUDGET_METRICS, BUDGET_WINDOW_KINDS, BUDGET_INCIDENT_RESOLUTION_ACTIONS, INVITE_JOIN_TYPES, JOIN_REQUEST_TYPES, JOIN_REQUEST_STATUSES, PERMISSION_KEYS, PLUGIN_STATUSES, PLUGIN_CATEGORIES, PLUGIN_CAPABILITIES, PLUGIN_UI_SLOT_TYPES, PLUGIN_RESERVED_COMPANY_ROUTE_SEGMENTS, PLUGIN_LAUNCHER_PLACEMENT_ZONES, PLUGIN_LAUNCHER_ACTIONS, PLUGIN_LAUNCHER_BOUNDS, PLUGIN_LAUNCHER_RENDER_ENVIRONMENTS, PLUGIN_UI_SLOT_ENTITY_TYPES, PLUGIN_STATE_SCOPE_KINDS;
+var ORGANIZATION_STATUSES, ORGANIZATION_INTELLIGENCE_PROFILE_PURPOSES, ORGANIZATION_INTELLIGENCE_PROFILE_STATUSES, DEPLOYMENT_MODES, DEPLOYMENT_EXPOSURES, AUTH_BASE_URL_MODES, AGENT_STATUSES, AGENT_RUNTIME_TYPES, AGENT_ROLES, AGENT_ICON_NAMES, AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX, AGENT_AVATAR_BACKGROUND_PRESET_IDS, ISSUE_STATUSES, ISSUE_PRIORITIES, CALENDAR_SOURCE_TYPES, CALENDAR_OWNER_TYPES, CALENDAR_VISIBILITIES, CALENDAR_SOURCE_STATUSES, CALENDAR_EVENT_KINDS, CALENDAR_EVENT_STATUSES, CALENDAR_SOURCE_MODES, CHAT_CONVERSATION_STATUSES, CHAT_ISSUE_CREATION_MODES, CHAT_MESSAGE_ROLES, CHAT_MESSAGE_KINDS, CHAT_MESSAGE_STATUSES, CHAT_CONTEXT_ENTITY_TYPES, GOAL_LEVELS, GOAL_STATUSES, PROJECT_STATUSES, ORGANIZATION_RESOURCE_KINDS, ORGANIZATION_RESOURCE_SOURCE_TYPES, PROJECT_RESOURCE_ATTACHMENT_ROLES, AUTOMATION_STATUSES, AUTOMATION_CONCURRENCY_POLICIES, AUTOMATION_CATCH_UP_POLICIES, AUTOMATION_OUTPUT_MODES, AUTOMATION_TRIGGER_SIGNING_MODES, PROJECT_COLORS, PROJECT_ICONS, APPROVAL_TYPES, SECRET_PROVIDERS, STORAGE_PROVIDERS, BILLING_TYPES, FINANCE_EVENT_KINDS, FINANCE_DIRECTIONS, FINANCE_UNITS, BUDGET_SCOPE_TYPES, BUDGET_METRICS, BUDGET_WINDOW_KINDS, BUDGET_INCIDENT_RESOLUTION_ACTIONS, INVITE_JOIN_TYPES, JOIN_REQUEST_TYPES, JOIN_REQUEST_STATUSES, PERMISSION_KEYS, PLUGIN_STATUSES, PLUGIN_CATEGORIES, PLUGIN_CAPABILITIES, PLUGIN_UI_SLOT_TYPES, PLUGIN_RESERVED_COMPANY_ROUTE_SEGMENTS, PLUGIN_LAUNCHER_PLACEMENT_ZONES, PLUGIN_LAUNCHER_ACTIONS, PLUGIN_LAUNCHER_BOUNDS, PLUGIN_LAUNCHER_RENDER_ENVIRONMENTS, PLUGIN_UI_SLOT_ENTITY_TYPES, PLUGIN_STATE_SCOPE_KINDS;
 var init_constants = __esm({
   "../packages/shared/dist/constants.js"() {
     "use strict";
@@ -186,6 +186,24 @@ var init_constants = __esm({
       "linear-gradient(135deg, #475569 0%, #0f766e 100%)",
       "linear-gradient(135deg, #334155 0%, #7c3aed 100%)"
     ];
+    PROJECT_ICONS = [
+      "folder",
+      "book",
+      "plane",
+      "globe",
+      "code",
+      "rocket",
+      "target",
+      "lightbulb",
+      "wrench",
+      "shield",
+      "database",
+      "megaphone",
+      "palette",
+      "users",
+      "calendar",
+      "package"
+    ];
     APPROVAL_TYPES = [
       "hire_agent",
       "approve_ceo_strategy",
@@ -428,7 +446,7 @@ var init_workspace_backup = __esm({
 
 // ../packages/shared/dist/validators/instance.js
 import { z } from "zod";
-var instanceLocaleSchema, instanceGeneralSettingsSchema, patchInstanceGeneralSettingsSchema, instanceNotificationSettingsSchema, patchInstanceNotificationSettingsSchema, instanceLangfuseSettingsSchema, patchInstanceLangfuseSettingsSchema, OPERATOR_PROFILE_MORE_ABOUT_YOU_MAX_LENGTH, operatorProfileSettingsSchema, patchOperatorProfileSettingsSchema, instancePathPickerSelectionTypeSchema, instancePathPickerRequestSchema, instancePathPickerResultSchema;
+var instanceLocaleSchema, instanceGeneralSettingsSchema, patchInstanceGeneralSettingsSchema, instanceNotificationSettingsSchema, patchInstanceNotificationSettingsSchema, instanceLangfuseSettingsSchema, patchInstanceLangfuseSettingsSchema, OPERATOR_PROFILE_MORE_ABOUT_YOU_MAX_LENGTH, operatorProfileSettingsSchema, patchOperatorProfileSettingsSchema, KEYBOARD_SHORTCUT_ACTION_IDS, keyboardShortcutActionIdSchema, keyboardShortcutBindingSchema, keyboardShortcutPreferenceSchema, keyboardShortcutSettingsSchema, instancePathPickerSelectionTypeSchema, instancePathPickerRequestSchema, instancePathPickerResultSchema;
 var init_instance = __esm({
   "../packages/shared/dist/validators/instance.js"() {
     "use strict";
@@ -468,6 +486,43 @@ var init_instance = __esm({
       moreAboutYou: z.string().max(OPERATOR_PROFILE_MORE_ABOUT_YOU_MAX_LENGTH).default("")
     }).strict();
     patchOperatorProfileSettingsSchema = operatorProfileSettingsSchema.partial();
+    KEYBOARD_SHORTCUT_ACTION_IDS = [
+      "commandPalette.open",
+      "settings.open",
+      "issue.create",
+      "sidebar.toggle",
+      "panel.toggle"
+    ];
+    keyboardShortcutActionIdSchema = z.enum(KEYBOARD_SHORTCUT_ACTION_IDS);
+    keyboardShortcutBindingSchema = z.object({
+      key: z.string().trim().min(1).max(64),
+      code: z.string().trim().min(1).max(80).optional(),
+      metaKey: z.boolean().optional(),
+      ctrlKey: z.boolean().optional(),
+      altKey: z.boolean().optional(),
+      shiftKey: z.boolean().optional()
+    }).strict();
+    keyboardShortcutPreferenceSchema = z.object({
+      actionId: keyboardShortcutActionIdSchema,
+      bindings: z.array(keyboardShortcutBindingSchema).max(4).optional(),
+      disabled: z.boolean().optional()
+    }).strict();
+    keyboardShortcutSettingsSchema = z.object({
+      shortcuts: z.array(keyboardShortcutPreferenceSchema).max(KEYBOARD_SHORTCUT_ACTION_IDS.length).default([])
+    }).strict().superRefine((value, ctx) => {
+      const seen = /* @__PURE__ */ new Set();
+      value.shortcuts.forEach((shortcut, index) => {
+        if (seen.has(shortcut.actionId)) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `Duplicate shortcut action id: ${shortcut.actionId}`,
+            path: ["shortcuts", index, "actionId"]
+          });
+          return;
+        }
+        seen.add(shortcut.actionId);
+      });
+    });
     instancePathPickerSelectionTypeSchema = z.enum(["file", "directory"]);
     instancePathPickerRequestSchema = z.object({
       selectionType: instancePathPickerSelectionTypeSchema
@@ -1571,7 +1626,7 @@ function validateProjectWorkspace(value, ctx) {
     });
   }
 }
-var executionWorkspaceStrategySchema, projectExecutionWorkspacePolicySchema, projectWorkspaceSourceTypeSchema, projectWorkspaceVisibilitySchema, projectWorkspaceFields, projectColorValues, legacyProjectColorSchema, projectColorSchema, createProjectWorkspaceSchema, updateProjectWorkspaceSchema, projectFields, createProjectSchema, updateProjectSchema;
+var executionWorkspaceStrategySchema, projectExecutionWorkspacePolicySchema, projectWorkspaceSourceTypeSchema, projectWorkspaceVisibilitySchema, projectWorkspaceFields, projectColorValues, legacyProjectColorSchema, projectColorSchema, projectIconSchema, createProjectWorkspaceSchema, updateProjectWorkspaceSchema, projectFields, createProjectSchema, updateProjectSchema;
 var init_project = __esm({
   "../packages/shared/dist/validators/project.js"() {
     "use strict";
@@ -1617,6 +1672,7 @@ var init_project = __esm({
     projectColorValues = new Set(PROJECT_COLORS);
     legacyProjectColorSchema = z13.string().regex(/^#[0-9a-fA-F]{6}$/);
     projectColorSchema = z13.string().refine((value) => legacyProjectColorSchema.safeParse(value).success || projectColorValues.has(value), "Color must be a 6-digit hex value or a supported project gradient");
+    projectIconSchema = z13.enum(PROJECT_ICONS);
     createProjectWorkspaceSchema = z13.object({
       ...projectWorkspaceFields,
       isPrimary: z13.boolean().optional().default(false)
@@ -1635,6 +1691,7 @@ var init_project = __esm({
       leadAgentId: z13.string().uuid().optional().nullable(),
       targetDate: z13.string().optional().nullable(),
       color: projectColorSchema.optional().nullable(),
+      icon: projectIconSchema.optional().nullable(),
       executionWorkspacePolicy: projectExecutionWorkspacePolicySchema.optional().nullable(),
       resourceAttachments: z13.array(projectResourceAttachmentInputSchema).optional(),
       newResources: z13.array(createProjectInlineResourceSchema).optional(),
@@ -1649,12 +1706,12 @@ var init_project = __esm({
 
 // ../packages/shared/dist/validators/issue.js
 import { z as z14 } from "zod";
-var executionWorkspaceStrategySchema2, issueExecutionWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, updateIssueCommentSchema, reportIssueCommitSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema, createLibraryDocumentSchema, updateLibraryDocumentSchema, restoreLibraryDocumentRevisionSchema;
+var runWorkspaceStrategySchema, issueRunWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, updateIssueCommentSchema, reportIssueCommitSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema, createLibraryDocumentSchema, updateLibraryDocumentSchema, restoreLibraryDocumentRevisionSchema;
 var init_issue = __esm({
   "../packages/shared/dist/validators/issue.js"() {
     "use strict";
     init_constants();
-    executionWorkspaceStrategySchema2 = z14.object({
+    runWorkspaceStrategySchema = z14.object({
       type: z14.enum(["project_primary", "git_worktree", "adapter_managed", "cloud_sandbox"]).optional(),
       baseRef: z14.string().optional().nullable(),
       branchTemplate: z14.string().optional().nullable(),
@@ -1662,9 +1719,9 @@ var init_issue = __esm({
       provisionCommand: z14.string().optional().nullable(),
       teardownCommand: z14.string().optional().nullable()
     }).strict();
-    issueExecutionWorkspaceSettingsSchema = z14.object({
+    issueRunWorkspaceSettingsSchema = z14.object({
       mode: z14.enum(["inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"]).optional(),
-      workspaceStrategy: executionWorkspaceStrategySchema2.optional().nullable(),
+      workspaceStrategy: runWorkspaceStrategySchema.optional().nullable(),
       workspaceRuntime: z14.record(z14.unknown()).optional().nullable()
     }).strict();
     issueAssigneeAdapterOverridesSchema = z14.object({
@@ -1687,7 +1744,19 @@ var init_issue = __esm({
       requestDepth: z14.number().int().nonnegative().optional().default(0),
       billingCode: z14.string().optional().nullable(),
       assigneeAgentRuntimeOverrides: issueAssigneeAdapterOverridesSchema.optional().nullable(),
+      runWorkspaceId: z14.string().uuid().optional().nullable(),
+      runWorkspacePreference: z14.enum([
+        "inherit",
+        "shared_workspace",
+        "isolated_workspace",
+        "operator_branch",
+        "reuse_existing",
+        "agent_default"
+      ]).optional().nullable(),
+      runWorkspaceSettings: issueRunWorkspaceSettingsSchema.optional().nullable(),
+      /** @deprecated Use runWorkspaceId. */
       executionWorkspaceId: z14.string().uuid().optional().nullable(),
+      /** @deprecated Use runWorkspacePreference. */
       executionWorkspacePreference: z14.enum([
         "inherit",
         "shared_workspace",
@@ -1696,7 +1765,8 @@ var init_issue = __esm({
         "reuse_existing",
         "agent_default"
       ]).optional().nullable(),
-      executionWorkspaceSettings: issueExecutionWorkspaceSettingsSchema.optional().nullable(),
+      /** @deprecated Use runWorkspaceSettings. */
+      executionWorkspaceSettings: issueRunWorkspaceSettingsSchema.optional().nullable(),
       labelIds: z14.array(z14.string().uuid()).optional()
     });
     createIssueLabelSchema = z14.object({
@@ -1814,6 +1884,8 @@ var init_work_product = __esm({
     ]);
     createIssueWorkProductSchema = z15.object({
       projectId: z15.string().uuid().optional().nullable(),
+      runWorkspaceId: z15.string().uuid().optional().nullable(),
+      /** @deprecated Use runWorkspaceId. */
       executionWorkspaceId: z15.string().uuid().optional().nullable(),
       runtimeServiceId: z15.string().uuid().optional().nullable(),
       type: issueWorkProductTypeSchema,
@@ -1835,19 +1907,19 @@ var init_work_product = __esm({
 
 // ../packages/shared/dist/validators/execution-workspace.js
 import { z as z16 } from "zod";
-var executionWorkspaceStatusSchema, updateExecutionWorkspaceSchema;
+var runWorkspaceStatusSchema, updateRunWorkspaceSchema;
 var init_execution_workspace = __esm({
   "../packages/shared/dist/validators/execution-workspace.js"() {
     "use strict";
-    executionWorkspaceStatusSchema = z16.enum([
+    runWorkspaceStatusSchema = z16.enum([
       "active",
       "idle",
       "in_review",
       "archived",
       "cleanup_failed"
     ]);
-    updateExecutionWorkspaceSchema = z16.object({
-      status: executionWorkspaceStatusSchema.optional(),
+    updateRunWorkspaceSchema = z16.object({
+      status: runWorkspaceStatusSchema.optional(),
       cleanupEligibleAt: z16.string().datetime().optional().nullable(),
       cleanupReason: z16.string().optional().nullable(),
       metadata: z16.record(z16.unknown()).optional().nullable()
@@ -2713,7 +2785,7 @@ var init_organization_skill_reference = __esm({
 });
 
 // ../packages/shared/dist/project-mentions.js
-var AGENT_AVATAR_UUID_RE, AGENT_ASSET_ICON_RE, AGENT_DICEBEAR_NOTIONISTS_ICON_RE, PROJECT_COLOR_VALUES, AGENT_AVATAR_BACKGROUND_VALUES;
+var AGENT_AVATAR_UUID_RE, AGENT_ASSET_ICON_RE, AGENT_DICEBEAR_NOTIONISTS_ICON_RE, PROJECT_COLOR_VALUES, PROJECT_ICON_VALUES, AGENT_AVATAR_BACKGROUND_VALUES;
 var init_project_mentions = __esm({
   "../packages/shared/dist/project-mentions.js"() {
     "use strict";
@@ -2722,12 +2794,13 @@ var init_project_mentions = __esm({
     AGENT_ASSET_ICON_RE = new RegExp(`^asset:${AGENT_AVATAR_UUID_RE}(?:\\?bg=([a-z0-9-]+))?$`, "i");
     AGENT_DICEBEAR_NOTIONISTS_ICON_RE = new RegExp(`^${AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX}${AGENT_AVATAR_UUID_RE}(?:\\?bg=([a-z0-9-]+))?$`, "i");
     PROJECT_COLOR_VALUES = new Set(PROJECT_COLORS);
+    PROJECT_ICON_VALUES = new Set(PROJECT_ICONS);
     AGENT_AVATAR_BACKGROUND_VALUES = new Set(AGENT_AVATAR_BACKGROUND_PRESET_IDS);
   }
 });
 
 // ../packages/shared/dist/issue-activity.js
-var ISSUE_UPDATE_ACTIVITY_METADATA_KEYS, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET;
+var ISSUE_UPDATE_ACTIVITY_METADATA_KEYS, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET, INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET;
 var init_issue_activity = __esm({
   "../packages/shared/dist/issue-activity.js"() {
     "use strict";
@@ -2743,8 +2816,19 @@ var init_issue_activity = __esm({
       "normalizedReason"
     ];
     LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS = ["description", "title"];
+    INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS = [
+      "executionWorkspaceId",
+      "executionWorkspacePreference",
+      "executionWorkspaceSettings",
+      "currentExecutionWorkspace",
+      "runWorkspaceId",
+      "runWorkspacePreference",
+      "runWorkspaceSettings",
+      "currentRunWorkspace"
+    ];
     ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET = new Set(ISSUE_UPDATE_ACTIVITY_METADATA_KEYS);
     LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET = new Set(LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS);
+    INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET = new Set(INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS);
   }
 });
 
@@ -10693,7 +10777,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "issue.documents.put",
     command: "rudder issue documents put <issue> <key> --body-file <path>",
     category: "issue",
-    description: "Legacy create or update of a DB-backed issue document; prefer `rudder library file put` for durable project files.",
+    description: "Legacy create or update of a DB-backed issue document; prefer local project Library files under `$RUDDER_PROJECT_LIBRARY_ROOT` for durable project files.",
     mutating: true,
     contract: "compat",
     requiresOrgId: false,
@@ -10765,7 +10849,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.list",
     command: "rudder library file list [directory]",
     category: "library",
-    description: "List path-based Library files and folders.",
+    description: "List Library files and folders; file rows include `libraryEntryId` when a strong reference can be generated.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -10777,7 +10861,31 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.get",
     command: "rudder library file get <path>",
     category: "library",
-    description: "Read one path-based Library file.",
+    description: "Fallback read when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.ref",
+    command: "rudder library file ref <path>",
+    category: "library",
+    description: "Return the stable Markdown reference for one Library file without printing file content.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.link",
+    command: "rudder library file link <path>",
+    category: "library",
+    description: "Compatibility alias for `rudder library file ref <path>`.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -10789,7 +10897,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.put",
     command: "rudder library file put <path> --body-file <path>",
     category: "library",
-    description: "Create or update one path-based Library file.",
+    description: "Fallback create/update when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.",
     mutating: true,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -10952,12 +11060,327 @@ var AGENT_CLI_CAPABILITIES = [
     requiresAgentId: false,
     requiresRunId: false,
     attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.list",
+    command: "rudder automation list --org-id <id>",
+    category: "automation",
+    description: "List automations for an organization with compact local filters.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.get",
+    command: "rudder automation get <automation-id>",
+    category: "automation",
+    description: "Read one automation detail including triggers and recent runs.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.runs",
+    command: "rudder automation runs <automation-id>",
+    category: "automation",
+    description: "List recent runs for one automation.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.triggers.list",
+    command: "rudder automation triggers list <automation-id>",
+    category: "automation",
+    description: "List triggers configured for one automation.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "automation.create",
+    command: "rudder automation create --org-id <id> --title <title> --assignee-agent-id <id>",
+    category: "automation",
+    description: "Create an automation through the governed automation API.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.update",
+    command: "rudder automation update <automation-id>",
+    category: "automation",
+    description: "Update automation fields through the governed automation API.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.enable",
+    command: "rudder automation enable <automation-id>",
+    category: "automation",
+    description: "Enable an automation by setting status to active.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.disable",
+    command: "rudder automation disable <automation-id>",
+    category: "automation",
+    description: "Disable an automation by setting status to paused.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "automation.run",
+    command: "rudder automation run <automation-id>",
+    category: "automation",
+    description: "Trigger a manual automation run.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.list",
+    command: "rudder chat list --org-id <id>",
+    category: "chat",
+    description: "List chat conversations without dumping full message history.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.search",
+    command: "rudder chat search <query> --org-id <id>",
+    category: "chat",
+    description: "Search chats with bounded snippets and optional scope filtering.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.get",
+    command: "rudder chat get <chat-id>",
+    category: "chat",
+    description: "Read one chat conversation record.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.messages",
+    command: "rudder chat messages <chat-id> [--limit <n>] [--cursor <cursor>] [--include-transcript]",
+    category: "chat",
+    description: "Read bounded chat messages with page cursors; transcript output is omitted unless requested.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.transcript",
+    command: "rudder chat transcript <chat-id> [--limit <n>] [--cursor <cursor>] [--max-output-chars <n>]",
+    category: "chat",
+    description: "Read paginated chat messages with assistant transcript entries clipped in human output.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.read",
+    command: "rudder chat read <chat-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
+    category: "chat",
+    description: "Read a bounded recent-message snapshot for one chat with page cursors.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "chat.create",
+    command: "rudder chat create --org-id <id>",
+    category: "chat",
+    description: "Create a chat conversation.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.send",
+    command: "rudder chat send <chat-id> --body <text>",
+    category: "chat",
+    description: "Send a chat message and persist the assistant reply through the server.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "chat.archive",
+    command: "rudder chat archive <chat-id>",
+    category: "chat",
+    description: "Archive a chat conversation without deleting it.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "runs.list",
+    command: "rudder runs list --org-id <id>",
+    category: "runs",
+    description: "List observed agent runs with filters for status, agent, issue, runtime, and time.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.get",
+    command: "rudder runs get <run-id>",
+    category: "runs",
+    description: "Read one observed run detail.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.events",
+    command: "rudder runs events <run-id>",
+    category: "runs",
+    description: "List persisted run events.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.log",
+    command: "rudder runs log <run-id>",
+    category: "runs",
+    description: "Read stored run log content with clipped human output.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.transcript",
+    command: "rudder runs transcript <run-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
+    category: "runs",
+    description: "Read the server-normalized run transcript; human output is compact and JSON includes full entries.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.errors",
+    command: "rudder runs errors <run-id>",
+    category: "runs",
+    description: "List failed tool calls, stderr, runtime failures, and jump-to-context commands.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "runs.cancel",
+    command: "rudder runs cancel <run-id>",
+    category: "runs",
+    description: "Cancel a heartbeat run through the governed server route.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "runs.retry",
+    command: "rudder runs retry <run-id>",
+    category: "runs",
+    description: "Retry a failed, timed out, or cancelled run through the governed server route.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
   }
 ];
 var CATEGORY_TITLES = {
   agent: "Agent",
   issue: "Issue",
   project: "Project",
+  automation: "Automation",
+  chat: "Chat",
+  runs: "Runs",
   approval: "Approval",
   skill: "Skill",
   library: "Library"
@@ -11706,10 +12129,14 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "- Personal skills live under `$AGENT_HOME/skills`.",
   "- Shared organization workspace root lives under `$RUDDER_ORG_WORKSPACE_ROOT`.",
   "- Shared organization skills live under `$RUDDER_ORG_SKILLS_DIR`.",
-  '- Library-backed project resources use `sourceType: "library"`; their `locator` points into `library:projects/<project-name>/`.',
+  "- Project Library root lives under `$RUDDER_PROJECT_LIBRARY_ROOT` when the run has project context.",
+  "- Project Library locator lives in `$RUDDER_PROJECT_LIBRARY_PATH` when the run has project context, for example `projects/<project-key>`.",
+  '- Library-backed project resources use `sourceType: "library"`; their `locator` points into `library:projects/<project-key>/`.',
   "- Project Context is explicit operator-curated context, not the whole knowledge boundary. When it is insufficient, inspect broader Library and org workspace know-how before concluding context is missing.",
-  "- Durable generated project work files should be written under `library:projects/<project-name>/`.",
-  "- When you create or update a durable Library file, always include a user-visible Markdown link to that file in your final chat reply or issue comment. Use `library-file://file?p=<url-encoded-relative-path>&t=<url-encoded-title>` for Library file links.",
+  "- In local trusted runs, durable generated project work files should be written directly under `$RUDDER_PROJECT_LIBRARY_ROOT` with normal filesystem tools.",
+  "- `library:projects/<project-key>/...` is the Rudder product locator for those files, not the Markdown link syntax and not a reason to route ordinary local edits through the CLI.",
+  '- When you create or update a durable Library file, always include a user-visible Markdown link to that file in your final chat reply or issue comment. Use `rudder library file ref "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>" --json` and paste the returned `markdownLink`; do not pass the absolute `$RUDDER_PROJECT_LIBRARY_ROOT/...` path to `ref`, and do not hand-write `library-entry://...` or `library-file://...` links.',
+  '- If `$RUDDER_PROJECT_LIBRARY_ROOT` is unset or inaccessible, use `rudder library file get/put "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>"` as the remote or restricted runtime fallback.',
   "- Use `/tmp` only for transient scratch files and temporary verification files; do not put durable work product there.",
   "- Local trusted runtimes may expose the host operator home as `$RUDDER_OPERATOR_HOME`; use it only when a local skill or script intentionally needs operator-owned desktop app or CLI state. Do not replace `$HOME` with it.",
   "",
@@ -11718,6 +12145,18 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "When you write issue comments or chat replies, match the language of the user's or board's most recent substantive message unless they explicitly ask for a different language.",
   "When you mention a web page, issue URL, external dashboard, or other user-openable target in an issue comment or chat reply, write it as a clickable Markdown link with a descriptive label, for example `[NameSilo transfer page](https://www.namesilo.com/account_domain_manage_transfer.php)`. Do not put action URLs in backticks or code blocks unless you are showing literal code or a command.",
   "",
+  "## Rudder Renderable Links",
+  "",
+  "When you mention Rudder entities in any user-visible Markdown output, prefer Rudder's renderable Markdown link syntax over plain IDs, bare URLs, or backticked references so the UI can render chips and navigate correctly.",
+  "",
+  "- Issues: use `[<identifier-or-title>](issue://<issue-id>?r=<identifier>)`; include `&c=<comment-id>` when linking to a specific comment.",
+  "- Agents: use `[<agent-name>](agent://<agent-id>)` for reference-only links. Use `[<agent-name>](agent://<agent-id>?intent=wake)` only when you deliberately want an issue-composer mention to wake that agent.",
+  "- Projects: use `[<project-name>](project://<project-id>)` when citing a Rudder project.",
+  "- Chat threads: use `[<chat-title>](chat://<conversation-id>?t=<url-encoded-title>)` when citing a Rudder chat conversation.",
+  '- Library files: use the `markdownLink` returned by `rudder library file ref "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>" --json`; do not hand-write `library-entry://...` links, and treat `library-file://...` as legacy path syntax only.',
+  "",
+  "Write these as normal Markdown links, not inside code spans or code blocks, unless you are literally documenting the syntax.",
+  "",
   "Mention-triggered comment wakes arrive with `RUDDER_WAKE_COMMENT_ID`; read that wake comment before acting. Board/operator issue comments can wake an agent with a plain `@AgentName` token or an issue-composer agent mention serialized as `agent://agent-id?intent=wake`. Plain structured links such as `agent://agent-id` are reference-only links for rendering and navigation. Agent-authored issue comments do not fan out peer wakeups by default; use reviewer, assignment, or explicit handoff workflow instead. Mentioning an agent requests attention or collaboration; it does not transfer issue ownership unless the comment also makes an explicit handoff and normal checkout rules allow it.",
   "",
   "When an issue comment, done comment, or blocker comment cites visual evidence from a local screenshot/image path, attach the image with the Rudder CLI `--image <path>` option instead of leaving only the filesystem path in the text.",
@@ -12703,9 +13142,27 @@ function parseCsv5(value) {
 // src/commands/client/library.ts
 import { readFile as readFile6 } from "node:fs/promises";
 import path20 from "node:path";
+function toLibraryFileLinkResult(detail) {
+  return {
+    filePath: detail.filePath,
+    libraryEntryId: detail.libraryEntryId,
+    mentionHref: detail.mentionHref,
+    markdownLink: detail.markdownLink
+  };
+}
+async function printLibraryFileReference(filePath, opts) {
+  const ctx = resolveCommandContext(opts, { requireCompany: true });
+  const search = new URLSearchParams();
+  search.set("path", filePath.trim());
+  const result = await ctx.api.get(
+    `/api/orgs/${ctx.orgId}/workspace/file?${search.toString()}`
+  );
+  if (!result) throw new Error("Library file not found");
+  printOutput(toLibraryFileLinkResult(result), { json: ctx.json });
+}
 function registerLibraryCommands(program) {
   const library = program.command("library").description("Library file operations");
-  const file = library.command("file").description("Path-based Library file operations");
+  const file = library.command("file").description("Library file operations");
   addCommonClientOptions(
     file.command("list").description(getAgentCliCapabilityById("library.file.list").description).argument("[directoryPath]", "Library directory path", "projects").action(async (directoryPath, opts) => {
       try {
@@ -12740,6 +13197,26 @@ function registerLibraryCommands(program) {
     }),
     { includeCompany: true }
   );
+  addCommonClientOptions(
+    file.command("link").description(getAgentCliCapabilityById("library.file.link").description).argument("<filePath>", "Library file path").action(async (filePath, opts) => {
+      try {
+        await printLibraryFileReference(filePath, opts);
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
+  addCommonClientOptions(
+    file.command("ref").description(getAgentCliCapabilityById("library.file.ref").description).argument("<filePath>", "Library file path").action(async (filePath, opts) => {
+      try {
+        await printLibraryFileReference(filePath, opts);
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
   addCommonClientOptions(
     file.command("put").description(getAgentCliCapabilityById("library.file.put").description).argument("<filePath>", "Library file path").option("--body-file <path>", "Read file content from a file, or '-' for stdin").action(async (filePath, opts) => {
       try {
@@ -12792,6 +13269,664 @@ async function readStdinText3() {
   return Buffer.concat(chunks).toString("utf8");
 }
 
+// src/commands/client/automation.ts
+init_dist();
+function registerAutomationCommands(program) {
+  const automation = program.command("automation").description("Automation operations");
+  addCommonClientOptions(
+    automation.command("list").description(getAgentCliCapabilityById("automation.list").description).option("-O, --org-id <id>", "Organization ID").option("--status <status>", "Filter by automation status").option("--assignee-agent-id <id>", "Filter by assignee agent ID").option("--project-id <id>", "Filter by project ID").option("--output-mode <mode>", "Filter by output mode").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/automations`) ?? [];
+        const filtered = rows.filter(
+          (row) => (!opts.status || row.status === opts.status) && (!opts.assigneeAgentId || row.assigneeAgentId === opts.assigneeAgentId) && (!opts.projectId || row.projectId === opts.projectId) && (!opts.outputMode || row.outputMode === opts.outputMode)
+        );
+        printOutput(ctx.json ? filtered : filtered.map(formatAutomationListItem), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    automation.command("get").description(getAgentCliCapabilityById("automation.get").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/automations/${encodeURIComponent(automationId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("runs").description(getAgentCliCapabilityById("automation.runs").description).argument("<automationId>", "Automation ID").option("--limit <n>", "Maximum runs to return", "50").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const params = new URLSearchParams();
+        if (opts.limit) params.set("limit", opts.limit);
+        const rows = await ctx.api.get(
+          `/api/automations/${encodeURIComponent(automationId)}/runs?${params.toString()}`
+        ) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatAutomationRun), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("triggers").description("Automation trigger operations").command("list").description(getAgentCliCapabilityById("automation.triggers.list").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/automations/${encodeURIComponent(automationId)}`);
+        const triggers = row?.triggers ?? [];
+        printOutput(triggers, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("create").description(getAgentCliCapabilityById("automation.create").description).option("-O, --org-id <id>", "Organization ID").option("--payload <json>", "Raw automation create payload JSON").option("--title <title>", "Automation title").option("--description <text>", "Automation description").option("--assignee-agent-id <id>", "Assignee agent ID").option("--project-id <id>", "Project ID").option("--goal-id <id>", "Goal ID").option("--parent-issue-id <id>", "Parent issue ID").option("--priority <priority>", "Issue priority for tracked output").option("--status <status>", "Automation status").option("--output-mode <mode>", "Automation output mode").option("--concurrency-policy <policy>", "Automation concurrency policy").option("--catch-up-policy <policy>", "Automation catch-up policy").option("--notify-on-issue-created", "Notify when tracked issue output is created").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const payload = createAutomationSchema.parse(buildAutomationPayload(opts));
+        const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/automations`, payload);
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    automation.command("update").description(getAgentCliCapabilityById("automation.update").description).argument("<automationId>", "Automation ID").option("--payload <json>", "Raw automation update payload JSON").option("--title <title>", "Automation title").option("--description <text>", "Automation description").option("--assignee-agent-id <id>", "Assignee agent ID").option("--project-id <id>", "Project ID").option("--goal-id <id>", "Goal ID").option("--parent-issue-id <id>", "Parent issue ID").option("--priority <priority>", "Issue priority for tracked output").option("--status <status>", "Automation status").option("--output-mode <mode>", "Automation output mode").option("--concurrency-policy <policy>", "Automation concurrency policy").option("--catch-up-policy <policy>", "Automation catch-up policy").option("--notify-on-issue-created", "Notify when tracked issue output is created").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = updateAutomationSchema.parse(buildAutomationPayload(opts));
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, payload);
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("enable").description(getAgentCliCapabilityById("automation.enable").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, {
+          status: "active"
+        });
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("disable").description(getAgentCliCapabilityById("automation.disable").description).argument("<automationId>", "Automation ID").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const updated = await ctx.api.patch(`/api/automations/${encodeURIComponent(automationId)}`, {
+          status: "paused"
+        });
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    automation.command("run").description(getAgentCliCapabilityById("automation.run").description).argument("<automationId>", "Automation ID").option("--trigger-id <id>", "Trigger ID").option("--payload <json>", "Manual run payload JSON").option("--idempotency-key <key>", "Idempotency key").option("--source <source>", "Run source", "manual").action(async (automationId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = runAutomationSchema.parse({
+          triggerId: opts.triggerId,
+          payload: opts.payload ? parseJsonOption(opts.payload, "--payload") : void 0,
+          idempotencyKey: opts.idempotencyKey,
+          source: opts.source
+        });
+        const run = await ctx.api.post(`/api/automations/${encodeURIComponent(automationId)}/run`, payload);
+        printOutput(run, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+function buildAutomationPayload(opts) {
+  return {
+    ...parseJsonObjectOption(opts.payload, "--payload"),
+    ...definedRecord({
+      title: opts.title,
+      description: opts.description,
+      assigneeAgentId: opts.assigneeAgentId,
+      projectId: opts.projectId,
+      goalId: opts.goalId,
+      parentIssueId: opts.parentIssueId,
+      priority: opts.priority,
+      status: opts.status,
+      outputMode: opts.outputMode,
+      concurrencyPolicy: opts.concurrencyPolicy,
+      catchUpPolicy: opts.catchUpPolicy,
+      notifyOnIssueCreated: opts.notifyOnIssueCreated
+    })
+  };
+}
+function definedRecord(record) {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== void 0));
+}
+function parseJsonOption(value, label) {
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    throw new Error(`${label} must be valid JSON`);
+  }
+}
+function parseJsonObjectOption(value, label) {
+  if (!value) return {};
+  const parsed = parseJsonOption(value, label);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${label} must be a JSON object`);
+  }
+  return parsed;
+}
+function formatAutomationListItem(row) {
+  const nextRunAt = row.triggers.map((trigger) => trigger.nextRunAt).filter(Boolean).sort()[0] ?? null;
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    assigneeAgentId: row.assigneeAgentId,
+    outputMode: row.outputMode,
+    lastRun: row.lastRun?.status ?? "-",
+    nextRunAt
+  };
+}
+function formatAutomationRun(row) {
+  return {
+    id: row.id,
+    status: row.status,
+    source: row.source,
+    triggeredAt: row.triggeredAt,
+    linkedIssue: row.linkedIssue?.identifier ?? row.linkedIssueId ?? "-",
+    linkedChatConversationId: row.linkedChatConversationId ?? "-",
+    failureReason: row.failureReason ?? "-"
+  };
+}
+
+// src/commands/client/chat.ts
+init_dist();
+function registerChatCommands(program) {
+  const chat = program.command("chat").description("Chat operations");
+  addCommonClientOptions(
+    chat.command("list").description(getAgentCliCapabilityById("chat.list").description).option("-O, --org-id <id>", "Organization ID").option("--status <status>", "active, resolved, archived, or all", "active").option("--query <text>", "Server-side chat search query").option("--limit <n>", "Maximum rows to print").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await listChats(ctx, opts);
+        printOutput(ctx.json ? rows : rows.map(formatChatConversation), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("search").description(getAgentCliCapabilityById("chat.search").description).argument("<query>", "Search query").option("-O, --org-id <id>", "Organization ID").option("--status <status>", "active, resolved, archived, or all", "all").option("--scope <scope>", "Search scope: all, title, summary, messages", "all").option("--limit <n>", "Maximum rows to print", "20").option("--snippet-chars <n>", "Maximum snippet characters", "220").action(async (query, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await listChats(ctx, { ...opts, query });
+        const filtered = filterChatSearchRows(rows, query, opts.scope ?? "all").slice(0, parseLimit(opts.limit, rows.length));
+        const snippetChars = parseLimit(opts.snippetChars, 220);
+        printOutput(
+          ctx.json ? filtered : filtered.map((row) => formatChatSearchResult(row, snippetChars)),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("get").description(getAgentCliCapabilityById("chat.get").description).argument("<chatId>", "Chat conversation ID").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("messages").description(getAgentCliCapabilityById("chat.messages").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: includesChatTranscript(opts),
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        printOutput(
+          ctx.json ? page : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("transcript").description(getAgentCliCapabilityById("chat.transcript").description).argument("<chatId>", "Chat conversation ID").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-chars <n>", "Maximum transcript chars per message", "1200").option("--max-output-chars <n>", "Alias for --max-chars").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: true,
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        const maxChars = parseLimit(opts.maxOutputChars ?? opts.maxChars, 1200);
+        printOutput(
+          ctx.json ? page : page.messages.flatMap((message) => formatChatTranscriptMessage(message, maxChars)),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("read").description(getAgentCliCapabilityById("chat.read").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum recent messages", "20").option("--turn-limit <n>", "Alias for --limit for chat turn snapshots").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const [conversation, page] = await Promise.all([
+          ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}`),
+          getChatMessagesPage(ctx, chatId, {
+            includeTranscript: includesChatTranscript(opts),
+            limit: opts.turnLimit ?? opts.limit,
+            cursor: opts.cursor
+          })
+        ]);
+        const payload = {
+          conversation,
+          messages: page.messages,
+          page: page.page
+        };
+        printOutput(
+          ctx.json ? payload : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("create").description(getAgentCliCapabilityById("chat.create").description).option("-O, --org-id <id>", "Organization ID").option("--payload <json>", "Raw chat create payload JSON").option("--title <title>", "Chat title").option("--summary <text>", "Chat summary").option("--preferred-agent-id <id>", "Preferred agent ID").option("--issue-creation-mode <mode>", "Issue creation mode").option("--plan-mode", "Create a plan-mode chat").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const payload = createChatConversationSchema.parse({
+          ...parseJsonObjectOption2(opts.payload, "--payload"),
+          ...definedRecord2({
+            title: opts.title,
+            summary: opts.summary,
+            preferredAgentId: opts.preferredAgentId,
+            issueCreationMode: opts.issueCreationMode,
+            planMode: opts.planMode
+          })
+        });
+        const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/chats`, payload);
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    chat.command("send").description(getAgentCliCapabilityById("chat.send").description).argument("<chatId>", "Chat conversation ID").option("--body <text>", "Message body").option("--edit-user-message-id <id>", "Regenerate/edit from a prior user message").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const body = opts.body ?? await readStdin();
+        const payload = addChatMessageSchema.parse({
+          body,
+          editUserMessageId: opts.editUserMessageId
+        });
+        const result = await ctx.api.post(`/api/chats/${encodeURIComponent(chatId)}/messages`, payload);
+        printOutput(result, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    chat.command("archive").description(getAgentCliCapabilityById("chat.archive").description).argument("<chatId>", "Chat conversation ID").action(async (chatId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = updateChatConversationSchema.parse({ status: "archived" });
+        const updated = await ctx.api.patch(`/api/chats/${encodeURIComponent(chatId)}`, payload);
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+async function listChats(ctx, opts) {
+  const params = new URLSearchParams();
+  if (opts.status) params.set("status", opts.status);
+  if (opts.query) params.set("q", opts.query);
+  const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/chats?${params.toString()}`) ?? [];
+  return rows.slice(0, parseLimit(opts.limit, rows.length));
+}
+async function getChatMessagesPage(ctx, chatId, opts) {
+  const params = new URLSearchParams();
+  params.set("envelope", "true");
+  params.set("order", "newest");
+  params.set("limit", String(parseLimit(opts.limit, 50)));
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.includeTranscript) params.set("includeTranscript", "true");
+  const page = await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}/messages?${params.toString()}`);
+  if (!page) {
+    throw new Error("Chat messages response was empty");
+  }
+  return page;
+}
+function filterChatSearchRows(rows, query, scope) {
+  const normalized = query.toLowerCase();
+  if (scope === "all") return rows;
+  return rows.filter((row) => {
+    if (scope === "title") return row.title.toLowerCase().includes(normalized);
+    if (scope === "summary") return Boolean(row.summary?.toLowerCase().includes(normalized));
+    if (scope === "messages") return Boolean(row.searchPreview?.toLowerCase().includes(normalized));
+    return true;
+  });
+}
+function formatChatConversation(row) {
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    preferredAgentId: row.preferredAgentId ?? "-",
+    unread: row.unreadCount,
+    lastMessageAt: row.lastMessageAt ?? "-",
+    preview: row.latestReplyPreview ?? row.latestUserMessagePreview ?? "-"
+  };
+}
+function formatChatSearchResult(row, maxChars) {
+  return {
+    id: row.id,
+    title: row.title,
+    status: row.status,
+    lastMessageAt: row.lastMessageAt ?? "-",
+    snippet: clip(row.searchPreview ?? row.latestReplyPreview ?? row.latestUserMessagePreview ?? row.summary ?? "", maxChars)
+  };
+}
+function formatChatMessage(row, maxOutputChars = 1200) {
+  return {
+    id: row.id,
+    role: row.role,
+    kind: row.kind,
+    status: row.status,
+    createdAt: row.createdAt,
+    body: clip(row.body, 220),
+    transcriptEntries: row.transcriptSummary?.entryCount ?? row.transcript?.length ?? 0,
+    ...row.transcript?.length ? { transcriptPreview: clip(row.transcript.map((entry) => formatTranscriptEntry(entry, maxOutputChars)).join(" "), maxOutputChars) } : {}
+  };
+}
+function formatChatTranscriptMessage(row, maxChars) {
+  const header = {
+    id: row.id,
+    role: row.role,
+    kind: row.kind,
+    status: row.status,
+    createdAt: row.createdAt,
+    body: clip(row.body, 220)
+  };
+  const transcriptRows = (row.transcript ?? []).map((entry, index) => ({
+    id: `${row.id}:entry-${index + 1}`,
+    messageId: row.id,
+    role: row.role,
+    entry: formatTranscriptEntry(entry, maxChars)
+  }));
+  return transcriptRows.length > 0 ? [header, ...transcriptRows] : [header];
+}
+function formatTranscriptEntry(entry, maxChars) {
+  if (entry.kind === "tool_call") return `${entry.ts} tool_call ${entry.name} ${clip(JSON.stringify(entry.input), maxChars)}`;
+  if (entry.kind === "tool_result") return `${entry.ts} tool_result ${entry.toolName ?? entry.toolUseId} ${entry.isError ? "ERROR " : ""}${clip(entry.content, maxChars)}`;
+  if (entry.kind === "result") return `${entry.ts} result ${entry.isError ? "ERROR " : ""}${clip(entry.text || entry.errors.join("; "), maxChars)}`;
+  if ("text" in entry) return `${entry.ts} ${entry.kind} ${clip(entry.text, maxChars)}`;
+  return `${entry.ts} ${entry.kind}`;
+}
+function parseLimit(value, fallback) {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.floor(parsed);
+}
+function includesChatTranscript(opts) {
+  return Boolean(opts.includeTranscript || opts.includeOutput || opts.includeOutputs);
+}
+function clip(value, maxChars) {
+  const text6 = value.replace(/\s+/g, " ").trim();
+  if (text6.length <= maxChars) return text6;
+  return `${text6.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+function parseJsonObjectOption2(value, label) {
+  if (!value) return {};
+  try {
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error(`${label} must be a JSON object`);
+    }
+    return parsed;
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("JSON object")) throw error;
+    throw new Error(`${label} must be valid JSON`);
+  }
+}
+function definedRecord2(record) {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== void 0));
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+// src/commands/client/runs.ts
+function registerRunsCommands(program) {
+  const runs = program.command("runs").description("Run debugging operations");
+  addCommonClientOptions(
+    runs.command("list").description(getAgentCliCapabilityById("runs.list").description).option("-O, --org-id <id>", "Organization ID").option("--updated-after <iso>", "Only runs updated after this timestamp").option("--run-id-prefix <prefix>", "Filter by run ID prefix").option("--agent-id <id>", "Filter by agent ID").option("--status <status>", "Filter by run status").option("--runtime <type>", "Filter by runtime type").option("--issue-id <id>", "Filter by linked issue ID").option("--created-before <iso>", "Only runs created before this timestamp").option("--limit <n>", "Maximum rows", "200").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await ctx.api.get(`/api/run-intelligence/orgs/${ctx.orgId}/runs?${buildRunsListQuery(opts)}`) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatRunListRow), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}`);
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const rows = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/events`) ?? [];
+        printOutput(ctx.json ? rows : rows.map(formatRunEvent), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/log`);
+        if (ctx.json) {
+          printOutput(row, { json: true });
+        } else {
+          process.stdout.write(clip2(row?.content ?? "", parseLimit2(opts.maxChars, 12e3)) + "\n");
+        }
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("transcript").description(getAgentCliCapabilityById("runs.transcript").description).argument("<runId>", "Run ID").option("--errors-only", "Show only error transcript rows").option("--around-error <id>", "Show context around a run error id such as step-12").option("--context-turns <n>", "Turns around --around-error", "1").option("--cursor <cursor>", "Stable transcript cursor returned in page.nextCursor").option("--turn-limit <n>", "Maximum turns to return", "20").option("--chronological", "Show oldest-first instead of default newest-first").option("--narrative", "Use a narrative human layout").option("--max-chars <n>", "Maximum output characters per row", "1200").option("--max-output-chars <n>", "Alias for --max-chars").option("--include-output", "Include row output in compact human transcript rows").option("--include-outputs", "Alias for --include-output").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts, { json: ctx.json })}`
+        );
+        if (ctx.json) {
+          printOutput(payload, { json: true });
+        } else if (opts.narrative) {
+          printOutput((payload?.rows ?? []).map(formatRunTranscriptNarrative), { json: false });
+        } else {
+          printOutput((payload?.rows ?? []).map(formatRunTranscriptRow), { json: false });
+        }
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("errors").description(getAgentCliCapabilityById("runs.errors").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum output characters per error", "1200").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const params = new URLSearchParams();
+        params.set("maxChars", String(parseLimit2(opts.maxChars, 1200)));
+        const payload = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/errors?${params.toString()}`
+        );
+        printOutput(ctx.json ? payload : (payload?.errors ?? []).map(formatRunError), { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("cancel").description(getAgentCliCapabilityById("runs.cancel").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/cancel`, {});
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+  addCommonClientOptions(
+    runs.command("retry").description(getAgentCliCapabilityById("runs.retry").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/retry`, {});
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
+}
+function buildRunsListQuery(opts) {
+  const params = new URLSearchParams();
+  if (opts.updatedAfter) params.set("updatedAfter", opts.updatedAfter);
+  if (opts.runIdPrefix) params.set("runIdPrefix", opts.runIdPrefix);
+  if (opts.agentId) params.set("agentId", opts.agentId);
+  if (opts.status) params.set("status", opts.status);
+  if (opts.runtime) params.set("runtime", opts.runtime);
+  if (opts.issueId) params.set("issueId", opts.issueId);
+  if (opts.createdBefore) params.set("createdBefore", opts.createdBefore);
+  if (opts.limit) params.set("limit", opts.limit);
+  return params.toString();
+}
+function buildTranscriptQuery(opts, output) {
+  const params = new URLSearchParams();
+  if (opts.errorsOnly) params.set("errorsOnly", "true");
+  if (opts.aroundError) params.set("aroundError", opts.aroundError);
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.turnLimit) params.set("turnLimit", String(parseLimit2(opts.turnLimit, 20)));
+  params.set("contextTurns", String(parseLimit2(opts.contextTurns, 1)));
+  params.set("order", opts.chronological || opts.narrative ? "oldest" : "newest");
+  params.set("output", output.json ? "full" : "compact");
+  const includeOutputs = output.json || Boolean(opts.includeOutput || opts.includeOutputs || opts.narrative);
+  params.set("includeOutputs", includeOutputs ? "true" : "false");
+  params.set("maxChars", String(parseLimit2(opts.maxOutputChars ?? opts.maxChars, 1200)));
+  return params.toString();
+}
+function formatRunListRow(row) {
+  return {
+    id: row.run.id,
+    status: row.run.status,
+    agent: row.agentName ?? row.run.agentId,
+    runtime: row.bundle.agentRuntimeType,
+    issue: row.issue?.identifier ?? row.issue?.id ?? "-",
+    updatedAt: row.run.updatedAt
+  };
+}
+function formatRunEvent(row) {
+  return {
+    seq: row.seq,
+    level: row.level,
+    stream: row.stream,
+    message: row.message,
+    createdAt: row.createdAt
+  };
+}
+function formatRunTranscriptRow(row) {
+  return {
+    id: row.id,
+    turn: row.turnIndex ?? "-",
+    kind: row.kind,
+    ts: row.ts,
+    error: row.isError ? "yes" : "no",
+    preview: row.preview || row.detailPreview,
+    ...row.output ? { output: row.output.text } : {}
+  };
+}
+function formatRunTranscriptNarrative(row) {
+  const marker = row.isError ? "ERROR " : "";
+  return `${row.id} ${row.ts} ${marker}${row.kind}: ${row.preview || row.detailPreview}${row.output ? `
+${row.output.text}` : ""}`;
+}
+function formatRunError(row) {
+  return {
+    id: row.id,
+    type: row.type,
+    turn: row.turnIndex ?? "-",
+    summary: row.summary,
+    output: row.output.text,
+    context: row.transcriptContext?.command ?? "-"
+  };
+}
+function parseLimit2(value, fallback) {
+  const parsed = Number(value ?? fallback);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.floor(parsed);
+}
+function clip2(value, maxChars) {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+
 // src/config/data-dir.ts
 init_home();
 import path21 from "node:path";
@@ -13172,6 +14307,9 @@ function createProgram() {
   registerDashboardCommands(program);
   registerSkillCommands(program);
   registerLibraryCommands(program);
+  registerAutomationCommands(program);
+  registerChatCommands(program);
+  registerRunsCommands(program);
   registerLazyWorktreeCommands(program);
   registerPluginCommands(program);
   registerLazyBenchmarkCommands(program);