@autohq/cli 0.1.88 → 0.1.89

package/dist/agent-bridge.js

@@ -21786,6 +21786,281 @@ var RunDiagnosticEventSchema = external_exports.object({
   createdAt: external_exports.string().datetime()
 });
 
+// ../../packages/schemas/src/session-runs.ts
+var SESSION_RUN_STATUSES = [
+  "queued",
+  "running",
+  "awaiting",
+  "failed",
+  "stopped"
+];
+var SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH = 64;
+var SessionRunStatusSchema = external_exports.enum(SESSION_RUN_STATUSES);
+var SessionRunDisplayTitleSchema = external_exports.string().trim().max(SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH);
+var SESSION_RUN_CHECK_STATUSES = [
+  "queued",
+  "in_progress",
+  "completed"
+];
+var SESSION_RUN_CHECK_CONCLUSIONS = ["success", "failure"];
+var SESSION_RUN_CHECK_TIMEOUT_PHASES = ["begin", "complete"];
+var SessionRunCheckStatusSchema = external_exports.enum(SESSION_RUN_CHECK_STATUSES);
+var SessionRunCheckConclusionSchema = external_exports.enum(
+  SESSION_RUN_CHECK_CONCLUSIONS
+);
+var SessionRunCheckTimeoutPhaseSchema = external_exports.enum(
+  SESSION_RUN_CHECK_TIMEOUT_PHASES
+);
+var ManualSessionRunRequestSchema = external_exports.object({
+  message: external_exports.string().trim().min(1).max(2e4).optional(),
+  interactive: external_exports.boolean().optional()
+});
+var SessionRunArchiveRequestSchema = external_exports.object({
+  archived: external_exports.boolean()
+});
+var SessionRunsArchiveRequestSchema = external_exports.object({
+  run_ids: external_exports.array(SessionRunIdSchema2).min(1).max(100),
+  archived: external_exports.boolean()
+});
+var SessionRunRecordSchema = external_exports.object({
+  id: SessionRunIdSchema2,
+  organizationId: external_exports.string().trim().min(1),
+  projectId: external_exports.string().trim().min(1).nullable(),
+  sessionId: SessionIdSchema,
+  runtimeId: RuntimeIdSchema2.nullable(),
+  status: SessionRunStatusSchema,
+  idempotencyKey: external_exports.string().min(1).nullable(),
+  correlationKey: external_exports.string().nullable(),
+  workflowId: external_exports.string().min(1),
+  displayTitle: SessionRunDisplayTitleSchema,
+  starterActor: AuthActorSchema.nullable(),
+  sessionSnapshot: SessionResourceSchema,
+  profileSnapshot: ProfileResourceSchema,
+  environmentSnapshot: EnvironmentResourceSchema,
+  toolSnapshots: external_exports.array(
+    external_exports.discriminatedUnion("source", [
+      external_exports.object({
+        source: external_exports.literal("inline"),
+        alias: ToolAliasSchema,
+        spec: RemoteMcpToolSchema.or(LocalToolSchema)
+      }),
+      external_exports.object({
+        source: external_exports.literal("resource"),
+        alias: ToolAliasSchema,
+        resource: ToolResourceSchema
+      })
+    ])
+  ),
+  input: JsonValueSchema2,
+  createdAt: external_exports.string().datetime(),
+  updatedAt: external_exports.string().datetime(),
+  startedAt: external_exports.string().datetime().nullable(),
+  finishedAt: external_exports.string().datetime().nullable(),
+  archivedAt: external_exports.string().datetime().nullable(),
+  error: JsonValueSchema2.nullable()
+});
+var SessionRunsArchiveResponseSchema = external_exports.object({
+  archived: external_exports.boolean(),
+  runs: external_exports.array(SessionRunRecordSchema)
+});
+
+// ../../packages/schemas/src/run-introspection.ts
+var TruncatedValueSchema = external_exports.object({
+  truncated: external_exports.literal(true),
+  truncatedPreview: external_exports.string(),
+  originalBytes: external_exports.number().int().nonnegative()
+});
+var RunConversationSearchSnippetSchema = external_exports.object({
+  partIndex: external_exports.number().int().nonnegative(),
+  partType: external_exports.string(),
+  /** The search term this snippet was produced for. */
+  query: external_exports.string(),
+  text: external_exports.string()
+});
+var RunConversationSearchMatchSchema = external_exports.object({
+  sequence: external_exports.number().int().nonnegative(),
+  role: ConversationRoleSchema2,
+  kind: ConversationEntryKindSchema2,
+  status: ConversationEntryStatusSchema2,
+  createdAt: external_exports.string().datetime(),
+  /** Which of the requested terms matched this entry. */
+  matchedQueries: external_exports.array(external_exports.string()),
+  /** Total match occurrences across terms in this entry. */
+  matchCount: external_exports.number().int().positive(),
+  snippets: external_exports.array(RunConversationSearchSnippetSchema)
+});
+var RunConversationSearchResponseSchema = external_exports.object({
+  matches: external_exports.array(RunConversationSearchMatchSchema),
+  hasMore: external_exports.boolean(),
+  /**
+   * Sequence of the last candidate entry scanned (not just the last confirmed
+   * match) — pass as `afterSequence` to continue without re-scanning
+   * candidates the match confirmation dropped. Null when nothing was scanned.
+   */
+  nextAfterSequence: external_exports.number().int().nullable()
+});
+var RunToolExchangeSchema = external_exports.object({
+  name: external_exports.string(),
+  callSequence: external_exports.number().int().nonnegative(),
+  resultSequence: external_exports.number().int().nonnegative().nullable(),
+  input: JsonValueSchema2,
+  output: JsonValueSchema2.nullable(),
+  /** Null while the call has no recorded result. */
+  isError: external_exports.boolean().nullable(),
+  /** Result `completedAt` minus call `createdAt`; null without a result. */
+  durationMs: external_exports.number().int().nonnegative().nullable(),
+  startedAt: external_exports.string().datetime(),
+  completedAt: external_exports.string().datetime().nullable()
+});
+var RunToolExchangesResponseSchema = external_exports.object({
+  exchanges: external_exports.array(RunToolExchangeSchema),
+  hasMore: external_exports.boolean(),
+  /**
+   * Sequence bounds of the entries window this page consumed (not just the
+   * returned exchanges) — continue paging with `after`/`before` from these so
+   * filtered-out entries are not re-scanned. Null when nothing was scanned.
+   */
+  nextAfterSequence: external_exports.number().int().nullable(),
+  nextBeforeSequence: external_exports.number().int().nullable()
+});
+var RUN_TRIGGER_DELIVERY_ACTIONS = [
+  "started",
+  "signaled",
+  "dropped",
+  "warned",
+  "errored"
+];
+var RunTriggerDeliveryActionSchema = external_exports.enum(
+  RUN_TRIGGER_DELIVERY_ACTIONS
+);
+var RUN_EVENT_ORIGIN_KINDS = [
+  "internal",
+  "provider_grant",
+  "webhook"
+];
+var RunEventOriginKindSchema = external_exports.enum(RUN_EVENT_ORIGIN_KINDS);
+var RunTriggerDeliveryRecordSchema = external_exports.object({
+  action: RunTriggerDeliveryActionSchema,
+  triggerId: external_exports.string(),
+  eventKey: external_exports.string(),
+  originKind: RunEventOriginKindSchema,
+  occurredAt: external_exports.string().datetime(),
+  receivedAt: external_exports.string().datetime(),
+  deliveredAt: external_exports.string().datetime(),
+  reason: external_exports.string().nullable(),
+  /** Event payload; may be a {@link TruncatedValueSchema} marker. */
+  payload: JsonValueSchema2.optional()
+});
+var RunTriggersResponseSchema = external_exports.object({
+  /** The `started` delivery that spawned the run; null for manual/agent spawns. */
+  spawn: RunTriggerDeliveryRecordSchema.nullable(),
+  /** Who started the run, for manual/CLI/agent spawns. */
+  starter: AuthActorSchema.nullable(),
+  /** Subsequent deliveries against the run, chronological. */
+  deliveries: external_exports.array(RunTriggerDeliveryRecordSchema)
+});
+var RunArtifactRecordSchema = external_exports.object({
+  artifactType: external_exports.string(),
+  externalId: external_exports.string(),
+  payload: JsonValueSchema2,
+  recordedAt: external_exports.string().datetime()
+});
+var RunArtifactsResponseSchema = external_exports.object({
+  artifacts: external_exports.array(RunArtifactRecordSchema)
+});
+var RunTurnSchema = external_exports.object({
+  startSequence: external_exports.number().int().nonnegative(),
+  endSequence: external_exports.number().int().nonnegative(),
+  startedAt: external_exports.string().datetime(),
+  completedAt: external_exports.string().datetime().nullable(),
+  toolCallCount: external_exports.number().int().nonnegative()
+});
+var RunToolStatSchema = external_exports.object({
+  name: external_exports.string(),
+  /** Run-wide call count from the SQL aggregate. */
+  calls: external_exports.number().int().nonnegative(),
+  /**
+   * Derived from the summary's recent-entries window (most recent ~1000
+   * entries), so on very long runs `errors` and `durationMs` can understate
+   * relative to the run-wide `calls`.
+   */
+  errors: external_exports.number().int().nonnegative(),
+  durationMs: external_exports.object({
+    p50: external_exports.number().nonnegative().nullable(),
+    max: external_exports.number().nonnegative().nullable()
+  })
+});
+var RunSummarySchema = external_exports.object({
+  run: external_exports.object({
+    id: SessionRunIdSchema2,
+    sessionName: external_exports.string(),
+    profileName: external_exports.string(),
+    displayTitle: external_exports.string(),
+    status: SessionRunStatusSchema,
+    error: JsonValueSchema2.nullable(),
+    workflowId: external_exports.string(),
+    createdAt: external_exports.string().datetime(),
+    startedAt: external_exports.string().datetime().nullable(),
+    finishedAt: external_exports.string().datetime().nullable(),
+    archivedAt: external_exports.string().datetime().nullable()
+  }),
+  timing: external_exports.object({
+    /** `startedAt - createdAt`; null until the run starts. */
+    queuedMs: external_exports.number().int().nonnegative().nullable(),
+    /** `(finishedAt ?? now) - startedAt`; null until the run starts. */
+    activeMs: external_exports.number().int().nonnegative().nullable(),
+    /** `(finishedAt ?? now) - createdAt`. */
+    totalMs: external_exports.number().int().nonnegative()
+  }),
+  conversation: external_exports.object({
+    entryCount: external_exports.number().int().nonnegative(),
+    firstEntryAt: external_exports.string().datetime().nullable(),
+    lastEntryAt: external_exports.string().datetime().nullable(),
+    countsByKind: external_exports.object({
+      status: external_exports.number().int().nonnegative(),
+      message: external_exports.number().int().nonnegative(),
+      tool_call: external_exports.number().int().nonnegative(),
+      tool_result: external_exports.number().int().nonnegative(),
+      question: external_exports.number().int().nonnegative()
+    }),
+    failedEntryCount: external_exports.number().int().nonnegative(),
+    lastSequence: external_exports.number().int().nonnegative()
+  }),
+  tools: external_exports.array(RunToolStatSchema),
+  /**
+   * True when the run has more conversation entries than the summary's
+   * recent-entries window, meaning per-tool `errors`/`durationMs` (and
+   * `turns`) describe only the most recent slice of the run.
+   */
+  toolStatsWindowed: external_exports.boolean(),
+  trigger: external_exports.object({
+    /** Spawning event key, or "manual" / "agent" for actor-started runs. */
+    spawn: external_exports.string(),
+    signaledCount: external_exports.number().int().nonnegative(),
+    droppedCount: external_exports.number().int().nonnegative()
+  }),
+  artifacts: external_exports.object({
+    count: external_exports.number().int().nonnegative(),
+    types: external_exports.array(external_exports.string())
+  }),
+  /** Derived per-user-message turns, capped to the most recent. */
+  turns: external_exports.array(RunTurnSchema),
+  commands: external_exports.object({
+    total: external_exports.number().int().nonnegative(),
+    byKind: external_exports.record(external_exports.string(), external_exports.number().int().nonnegative()),
+    failed: external_exports.number().int().nonnegative()
+  }),
+  checks: external_exports.array(
+    external_exports.object({
+      name: external_exports.string(),
+      displayName: external_exports.string(),
+      status: SessionRunCheckStatusSchema,
+      conclusion: SessionRunCheckConclusionSchema.nullable(),
+      completedAt: external_exports.string().datetime().nullable()
+    })
+  )
+});
+
 // ../../packages/schemas/src/session-run-commands.ts
 var SESSION_RUN_COMMAND_KINDS = [
   "message",
@@ -22084,84 +22359,6 @@ var RunCommandDispatchSignalPayloadSchema = external_exports.object({
 }).strict();
 var RealtimeRunCursorSchema = external_exports.string().regex(/^rt:(0|[1-9]\d*)$/);
 
-// ../../packages/schemas/src/session-runs.ts
-var SESSION_RUN_STATUSES = [
-  "queued",
-  "running",
-  "awaiting",
-  "failed",
-  "stopped"
-];
-var SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH = 64;
-var SessionRunStatusSchema = external_exports.enum(SESSION_RUN_STATUSES);
-var SessionRunDisplayTitleSchema = external_exports.string().trim().max(SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH);
-var SESSION_RUN_CHECK_STATUSES = [
-  "queued",
-  "in_progress",
-  "completed"
-];
-var SESSION_RUN_CHECK_CONCLUSIONS = ["success", "failure"];
-var SESSION_RUN_CHECK_TIMEOUT_PHASES = ["begin", "complete"];
-var SessionRunCheckStatusSchema = external_exports.enum(SESSION_RUN_CHECK_STATUSES);
-var SessionRunCheckConclusionSchema = external_exports.enum(
-  SESSION_RUN_CHECK_CONCLUSIONS
-);
-var SessionRunCheckTimeoutPhaseSchema = external_exports.enum(
-  SESSION_RUN_CHECK_TIMEOUT_PHASES
-);
-var ManualSessionRunRequestSchema = external_exports.object({
-  message: external_exports.string().trim().min(1).max(2e4).optional(),
-  interactive: external_exports.boolean().optional()
-});
-var SessionRunArchiveRequestSchema = external_exports.object({
-  archived: external_exports.boolean()
-});
-var SessionRunsArchiveRequestSchema = external_exports.object({
-  run_ids: external_exports.array(SessionRunIdSchema2).min(1).max(100),
-  archived: external_exports.boolean()
-});
-var SessionRunRecordSchema = external_exports.object({
-  id: SessionRunIdSchema2,
-  organizationId: external_exports.string().trim().min(1),
-  projectId: external_exports.string().trim().min(1).nullable(),
-  sessionId: SessionIdSchema,
-  runtimeId: RuntimeIdSchema2.nullable(),
-  status: SessionRunStatusSchema,
-  idempotencyKey: external_exports.string().min(1).nullable(),
-  correlationKey: external_exports.string().nullable(),
-  workflowId: external_exports.string().min(1),
-  displayTitle: SessionRunDisplayTitleSchema,
-  starterActor: AuthActorSchema.nullable(),
-  sessionSnapshot: SessionResourceSchema,
-  profileSnapshot: ProfileResourceSchema,
-  environmentSnapshot: EnvironmentResourceSchema,
-  toolSnapshots: external_exports.array(
-    external_exports.discriminatedUnion("source", [
-      external_exports.object({
-        source: external_exports.literal("inline"),
-        alias: ToolAliasSchema,
-        spec: RemoteMcpToolSchema.or(LocalToolSchema)
-      }),
-      external_exports.object({
-        source: external_exports.literal("resource"),
-        alias: ToolAliasSchema,
-        resource: ToolResourceSchema
-      })
-    ])
-  ),
-  input: JsonValueSchema2,
-  createdAt: external_exports.string().datetime(),
-  updatedAt: external_exports.string().datetime(),
-  startedAt: external_exports.string().datetime().nullable(),
-  finishedAt: external_exports.string().datetime().nullable(),
-  archivedAt: external_exports.string().datetime().nullable(),
-  error: JsonValueSchema2.nullable()
-});
-var SessionRunsArchiveResponseSchema = external_exports.object({
-  archived: external_exports.boolean(),
-  runs: external_exports.array(SessionRunRecordSchema)
-});
-
 // ../../packages/schemas/src/temporal.ts
 var ResourceReconciliationScopeSchema = external_exports.object({
   organizationId: external_exports.string().trim().min(1),

package/dist/index.js

@@ -17654,6 +17654,307 @@ var init_run_diagnostics = __esm({
   }
 });
 
+// ../../packages/schemas/src/session-runs.ts
+var SESSION_RUN_STATUSES, SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH, SessionRunStatusSchema, SessionRunDisplayTitleSchema, SESSION_RUN_CHECK_STATUSES, SESSION_RUN_CHECK_CONCLUSIONS, SESSION_RUN_CHECK_TIMEOUT_PHASES, SessionRunCheckStatusSchema, SessionRunCheckConclusionSchema, SessionRunCheckTimeoutPhaseSchema, ManualSessionRunRequestSchema, SessionRunArchiveRequestSchema, SessionRunsArchiveRequestSchema, SessionRunRecordSchema, SessionRunsArchiveResponseSchema;
+var init_session_runs = __esm({
+  "../../packages/schemas/src/session-runs.ts"() {
+    "use strict";
+    init_zod();
+    init_auth();
+    init_environments();
+    init_ids();
+    init_primitives();
+    init_profiles();
+    init_sessions();
+    init_tools();
+    SESSION_RUN_STATUSES = [
+      "queued",
+      "running",
+      "awaiting",
+      "failed",
+      "stopped"
+    ];
+    SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH = 64;
+    SessionRunStatusSchema = external_exports.enum(SESSION_RUN_STATUSES);
+    SessionRunDisplayTitleSchema = external_exports.string().trim().max(SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH);
+    SESSION_RUN_CHECK_STATUSES = [
+      "queued",
+      "in_progress",
+      "completed"
+    ];
+    SESSION_RUN_CHECK_CONCLUSIONS = ["success", "failure"];
+    SESSION_RUN_CHECK_TIMEOUT_PHASES = ["begin", "complete"];
+    SessionRunCheckStatusSchema = external_exports.enum(SESSION_RUN_CHECK_STATUSES);
+    SessionRunCheckConclusionSchema = external_exports.enum(
+      SESSION_RUN_CHECK_CONCLUSIONS
+    );
+    SessionRunCheckTimeoutPhaseSchema = external_exports.enum(
+      SESSION_RUN_CHECK_TIMEOUT_PHASES
+    );
+    ManualSessionRunRequestSchema = external_exports.object({
+      message: external_exports.string().trim().min(1).max(2e4).optional(),
+      interactive: external_exports.boolean().optional()
+    });
+    SessionRunArchiveRequestSchema = external_exports.object({
+      archived: external_exports.boolean()
+    });
+    SessionRunsArchiveRequestSchema = external_exports.object({
+      run_ids: external_exports.array(SessionRunIdSchema2).min(1).max(100),
+      archived: external_exports.boolean()
+    });
+    SessionRunRecordSchema = external_exports.object({
+      id: SessionRunIdSchema2,
+      organizationId: external_exports.string().trim().min(1),
+      projectId: external_exports.string().trim().min(1).nullable(),
+      sessionId: SessionIdSchema,
+      runtimeId: RuntimeIdSchema2.nullable(),
+      status: SessionRunStatusSchema,
+      idempotencyKey: external_exports.string().min(1).nullable(),
+      correlationKey: external_exports.string().nullable(),
+      workflowId: external_exports.string().min(1),
+      displayTitle: SessionRunDisplayTitleSchema,
+      starterActor: AuthActorSchema.nullable(),
+      sessionSnapshot: SessionResourceSchema,
+      profileSnapshot: ProfileResourceSchema,
+      environmentSnapshot: EnvironmentResourceSchema,
+      toolSnapshots: external_exports.array(
+        external_exports.discriminatedUnion("source", [
+          external_exports.object({
+            source: external_exports.literal("inline"),
+            alias: ToolAliasSchema,
+            spec: RemoteMcpToolSchema.or(LocalToolSchema)
+          }),
+          external_exports.object({
+            source: external_exports.literal("resource"),
+            alias: ToolAliasSchema,
+            resource: ToolResourceSchema
+          })
+        ])
+      ),
+      input: JsonValueSchema2,
+      createdAt: external_exports.string().datetime(),
+      updatedAt: external_exports.string().datetime(),
+      startedAt: external_exports.string().datetime().nullable(),
+      finishedAt: external_exports.string().datetime().nullable(),
+      archivedAt: external_exports.string().datetime().nullable(),
+      error: JsonValueSchema2.nullable()
+    });
+    SessionRunsArchiveResponseSchema = external_exports.object({
+      archived: external_exports.boolean(),
+      runs: external_exports.array(SessionRunRecordSchema)
+    });
+  }
+});
+
+// ../../packages/schemas/src/run-introspection.ts
+var TruncatedValueSchema, RunConversationSearchSnippetSchema, RunConversationSearchMatchSchema, RunConversationSearchResponseSchema, RunToolExchangeSchema, RunToolExchangesResponseSchema, RUN_TRIGGER_DELIVERY_ACTIONS, RunTriggerDeliveryActionSchema, RUN_EVENT_ORIGIN_KINDS, RunEventOriginKindSchema, RunTriggerDeliveryRecordSchema, RunTriggersResponseSchema, RunArtifactRecordSchema, RunArtifactsResponseSchema, RunTurnSchema, RunToolStatSchema, RunSummarySchema;
+var init_run_introspection = __esm({
+  "../../packages/schemas/src/run-introspection.ts"() {
+    "use strict";
+    init_zod();
+    init_auth();
+    init_conversation();
+    init_ids();
+    init_primitives();
+    init_session_runs();
+    TruncatedValueSchema = external_exports.object({
+      truncated: external_exports.literal(true),
+      truncatedPreview: external_exports.string(),
+      originalBytes: external_exports.number().int().nonnegative()
+    });
+    RunConversationSearchSnippetSchema = external_exports.object({
+      partIndex: external_exports.number().int().nonnegative(),
+      partType: external_exports.string(),
+      /** The search term this snippet was produced for. */
+      query: external_exports.string(),
+      text: external_exports.string()
+    });
+    RunConversationSearchMatchSchema = external_exports.object({
+      sequence: external_exports.number().int().nonnegative(),
+      role: ConversationRoleSchema2,
+      kind: ConversationEntryKindSchema2,
+      status: ConversationEntryStatusSchema2,
+      createdAt: external_exports.string().datetime(),
+      /** Which of the requested terms matched this entry. */
+      matchedQueries: external_exports.array(external_exports.string()),
+      /** Total match occurrences across terms in this entry. */
+      matchCount: external_exports.number().int().positive(),
+      snippets: external_exports.array(RunConversationSearchSnippetSchema)
+    });
+    RunConversationSearchResponseSchema = external_exports.object({
+      matches: external_exports.array(RunConversationSearchMatchSchema),
+      hasMore: external_exports.boolean(),
+      /**
+       * Sequence of the last candidate entry scanned (not just the last confirmed
+       * match) — pass as `afterSequence` to continue without re-scanning
+       * candidates the match confirmation dropped. Null when nothing was scanned.
+       */
+      nextAfterSequence: external_exports.number().int().nullable()
+    });
+    RunToolExchangeSchema = external_exports.object({
+      name: external_exports.string(),
+      callSequence: external_exports.number().int().nonnegative(),
+      resultSequence: external_exports.number().int().nonnegative().nullable(),
+      input: JsonValueSchema2,
+      output: JsonValueSchema2.nullable(),
+      /** Null while the call has no recorded result. */
+      isError: external_exports.boolean().nullable(),
+      /** Result `completedAt` minus call `createdAt`; null without a result. */
+      durationMs: external_exports.number().int().nonnegative().nullable(),
+      startedAt: external_exports.string().datetime(),
+      completedAt: external_exports.string().datetime().nullable()
+    });
+    RunToolExchangesResponseSchema = external_exports.object({
+      exchanges: external_exports.array(RunToolExchangeSchema),
+      hasMore: external_exports.boolean(),
+      /**
+       * Sequence bounds of the entries window this page consumed (not just the
+       * returned exchanges) — continue paging with `after`/`before` from these so
+       * filtered-out entries are not re-scanned. Null when nothing was scanned.
+       */
+      nextAfterSequence: external_exports.number().int().nullable(),
+      nextBeforeSequence: external_exports.number().int().nullable()
+    });
+    RUN_TRIGGER_DELIVERY_ACTIONS = [
+      "started",
+      "signaled",
+      "dropped",
+      "warned",
+      "errored"
+    ];
+    RunTriggerDeliveryActionSchema = external_exports.enum(
+      RUN_TRIGGER_DELIVERY_ACTIONS
+    );
+    RUN_EVENT_ORIGIN_KINDS = [
+      "internal",
+      "provider_grant",
+      "webhook"
+    ];
+    RunEventOriginKindSchema = external_exports.enum(RUN_EVENT_ORIGIN_KINDS);
+    RunTriggerDeliveryRecordSchema = external_exports.object({
+      action: RunTriggerDeliveryActionSchema,
+      triggerId: external_exports.string(),
+      eventKey: external_exports.string(),
+      originKind: RunEventOriginKindSchema,
+      occurredAt: external_exports.string().datetime(),
+      receivedAt: external_exports.string().datetime(),
+      deliveredAt: external_exports.string().datetime(),
+      reason: external_exports.string().nullable(),
+      /** Event payload; may be a {@link TruncatedValueSchema} marker. */
+      payload: JsonValueSchema2.optional()
+    });
+    RunTriggersResponseSchema = external_exports.object({
+      /** The `started` delivery that spawned the run; null for manual/agent spawns. */
+      spawn: RunTriggerDeliveryRecordSchema.nullable(),
+      /** Who started the run, for manual/CLI/agent spawns. */
+      starter: AuthActorSchema.nullable(),
+      /** Subsequent deliveries against the run, chronological. */
+      deliveries: external_exports.array(RunTriggerDeliveryRecordSchema)
+    });
+    RunArtifactRecordSchema = external_exports.object({
+      artifactType: external_exports.string(),
+      externalId: external_exports.string(),
+      payload: JsonValueSchema2,
+      recordedAt: external_exports.string().datetime()
+    });
+    RunArtifactsResponseSchema = external_exports.object({
+      artifacts: external_exports.array(RunArtifactRecordSchema)
+    });
+    RunTurnSchema = external_exports.object({
+      startSequence: external_exports.number().int().nonnegative(),
+      endSequence: external_exports.number().int().nonnegative(),
+      startedAt: external_exports.string().datetime(),
+      completedAt: external_exports.string().datetime().nullable(),
+      toolCallCount: external_exports.number().int().nonnegative()
+    });
+    RunToolStatSchema = external_exports.object({
+      name: external_exports.string(),
+      /** Run-wide call count from the SQL aggregate. */
+      calls: external_exports.number().int().nonnegative(),
+      /**
+       * Derived from the summary's recent-entries window (most recent ~1000
+       * entries), so on very long runs `errors` and `durationMs` can understate
+       * relative to the run-wide `calls`.
+       */
+      errors: external_exports.number().int().nonnegative(),
+      durationMs: external_exports.object({
+        p50: external_exports.number().nonnegative().nullable(),
+        max: external_exports.number().nonnegative().nullable()
+      })
+    });
+    RunSummarySchema = external_exports.object({
+      run: external_exports.object({
+        id: SessionRunIdSchema2,
+        sessionName: external_exports.string(),
+        profileName: external_exports.string(),
+        displayTitle: external_exports.string(),
+        status: SessionRunStatusSchema,
+        error: JsonValueSchema2.nullable(),
+        workflowId: external_exports.string(),
+        createdAt: external_exports.string().datetime(),
+        startedAt: external_exports.string().datetime().nullable(),
+        finishedAt: external_exports.string().datetime().nullable(),
+        archivedAt: external_exports.string().datetime().nullable()
+      }),
+      timing: external_exports.object({
+        /** `startedAt - createdAt`; null until the run starts. */
+        queuedMs: external_exports.number().int().nonnegative().nullable(),
+        /** `(finishedAt ?? now) - startedAt`; null until the run starts. */
+        activeMs: external_exports.number().int().nonnegative().nullable(),
+        /** `(finishedAt ?? now) - createdAt`. */
+        totalMs: external_exports.number().int().nonnegative()
+      }),
+      conversation: external_exports.object({
+        entryCount: external_exports.number().int().nonnegative(),
+        firstEntryAt: external_exports.string().datetime().nullable(),
+        lastEntryAt: external_exports.string().datetime().nullable(),
+        countsByKind: external_exports.object({
+          status: external_exports.number().int().nonnegative(),
+          message: external_exports.number().int().nonnegative(),
+          tool_call: external_exports.number().int().nonnegative(),
+          tool_result: external_exports.number().int().nonnegative(),
+          question: external_exports.number().int().nonnegative()
+        }),
+        failedEntryCount: external_exports.number().int().nonnegative(),
+        lastSequence: external_exports.number().int().nonnegative()
+      }),
+      tools: external_exports.array(RunToolStatSchema),
+      /**
+       * True when the run has more conversation entries than the summary's
+       * recent-entries window, meaning per-tool `errors`/`durationMs` (and
+       * `turns`) describe only the most recent slice of the run.
+       */
+      toolStatsWindowed: external_exports.boolean(),
+      trigger: external_exports.object({
+        /** Spawning event key, or "manual" / "agent" for actor-started runs. */
+        spawn: external_exports.string(),
+        signaledCount: external_exports.number().int().nonnegative(),
+        droppedCount: external_exports.number().int().nonnegative()
+      }),
+      artifacts: external_exports.object({
+        count: external_exports.number().int().nonnegative(),
+        types: external_exports.array(external_exports.string())
+      }),
+      /** Derived per-user-message turns, capped to the most recent. */
+      turns: external_exports.array(RunTurnSchema),
+      commands: external_exports.object({
+        total: external_exports.number().int().nonnegative(),
+        byKind: external_exports.record(external_exports.string(), external_exports.number().int().nonnegative()),
+        failed: external_exports.number().int().nonnegative()
+      }),
+      checks: external_exports.array(
+        external_exports.object({
+          name: external_exports.string(),
+          displayName: external_exports.string(),
+          status: SessionRunCheckStatusSchema,
+          conclusion: SessionRunCheckConclusionSchema.nullable(),
+          completedAt: external_exports.string().datetime().nullable()
+        })
+      )
+    });
+  }
+});
+
 // ../../packages/schemas/src/session-run-commands.ts
 var SESSION_RUN_COMMAND_KINDS, SESSION_RUN_DISPATCH_COMMAND_KINDS, SESSION_RUN_PERSISTED_COMMAND_KINDS, SESSION_RUN_LIFECYCLE_COMMAND_KINDS, SESSION_RUN_COMMAND_STATUSES, SESSION_RUN_DISPATCH_COMMAND_STATUSES, SessionRunCommandKindSchema2, SessionRunPersistedCommandKindSchema, SessionRunDispatchCommandKindSchema, SessionRunLifecycleCommandKindSchema, SessionRunCommandStatusSchema, SessionRunDispatchCommandStatusSchema, SessionRunCommandSenderSchema, SessionRunMessageCommandPayloadSchema, SessionRunAnswerCommandPayloadSchema, SessionRunLifecycleCommandPayloadSchema, SessionRunCommandPayloadSchema, CreateSessionRunMessageCommandRequestSchema, CreateSessionRunAnswerCommandRequestSchema, CreateSessionRunLifecycleCommandRequestSchema, CreateSessionRunCommandRequestSchema, SessionRunResolutionPolicySchema, SessionAddressedCommandTargetSchema, SessionRunCommandRecordBaseSchema, SessionRunStartCommandPayloadSchema, SessionRunStartWithMessageCommandPayloadSchema, SessionRunPersistedCommandPayloadSchema, SessionRunCommandRecordSchema, SessionRunDispatchMessageCommandPayloadSchema, SessionRunDispatchAnswerCommandPayloadSchema, SessionRunDispatchStopCommandPayloadSchema, SessionRunDispatchCommandPayloadSchema, SessionRunDispatchCommandRecordBaseSchema, SessionRunDispatchCommandRecordSchema;
 var init_session_run_commands = __esm({
@@ -17970,98 +18271,6 @@ var init_runtimes = __esm({
   }
 });
 
-// ../../packages/schemas/src/session-runs.ts
-var SESSION_RUN_STATUSES, SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH, SessionRunStatusSchema, SessionRunDisplayTitleSchema, SESSION_RUN_CHECK_STATUSES, SESSION_RUN_CHECK_CONCLUSIONS, SESSION_RUN_CHECK_TIMEOUT_PHASES, SessionRunCheckStatusSchema, SessionRunCheckConclusionSchema, SessionRunCheckTimeoutPhaseSchema, ManualSessionRunRequestSchema, SessionRunArchiveRequestSchema, SessionRunsArchiveRequestSchema, SessionRunRecordSchema, SessionRunsArchiveResponseSchema;
-var init_session_runs = __esm({
-  "../../packages/schemas/src/session-runs.ts"() {
-    "use strict";
-    init_zod();
-    init_auth();
-    init_environments();
-    init_ids();
-    init_primitives();
-    init_profiles();
-    init_sessions();
-    init_tools();
-    SESSION_RUN_STATUSES = [
-      "queued",
-      "running",
-      "awaiting",
-      "failed",
-      "stopped"
-    ];
-    SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH = 64;
-    SessionRunStatusSchema = external_exports.enum(SESSION_RUN_STATUSES);
-    SessionRunDisplayTitleSchema = external_exports.string().trim().max(SESSION_RUN_DISPLAY_TITLE_MAX_LENGTH);
-    SESSION_RUN_CHECK_STATUSES = [
-      "queued",
-      "in_progress",
-      "completed"
-    ];
-    SESSION_RUN_CHECK_CONCLUSIONS = ["success", "failure"];
-    SESSION_RUN_CHECK_TIMEOUT_PHASES = ["begin", "complete"];
-    SessionRunCheckStatusSchema = external_exports.enum(SESSION_RUN_CHECK_STATUSES);
-    SessionRunCheckConclusionSchema = external_exports.enum(
-      SESSION_RUN_CHECK_CONCLUSIONS
-    );
-    SessionRunCheckTimeoutPhaseSchema = external_exports.enum(
-      SESSION_RUN_CHECK_TIMEOUT_PHASES
-    );
-    ManualSessionRunRequestSchema = external_exports.object({
-      message: external_exports.string().trim().min(1).max(2e4).optional(),
-      interactive: external_exports.boolean().optional()
-    });
-    SessionRunArchiveRequestSchema = external_exports.object({
-      archived: external_exports.boolean()
-    });
-    SessionRunsArchiveRequestSchema = external_exports.object({
-      run_ids: external_exports.array(SessionRunIdSchema2).min(1).max(100),
-      archived: external_exports.boolean()
-    });
-    SessionRunRecordSchema = external_exports.object({
-      id: SessionRunIdSchema2,
-      organizationId: external_exports.string().trim().min(1),
-      projectId: external_exports.string().trim().min(1).nullable(),
-      sessionId: SessionIdSchema,
-      runtimeId: RuntimeIdSchema2.nullable(),
-      status: SessionRunStatusSchema,
-      idempotencyKey: external_exports.string().min(1).nullable(),
-      correlationKey: external_exports.string().nullable(),
-      workflowId: external_exports.string().min(1),
-      displayTitle: SessionRunDisplayTitleSchema,
-      starterActor: AuthActorSchema.nullable(),
-      sessionSnapshot: SessionResourceSchema,
-      profileSnapshot: ProfileResourceSchema,
-      environmentSnapshot: EnvironmentResourceSchema,
-      toolSnapshots: external_exports.array(
-        external_exports.discriminatedUnion("source", [
-          external_exports.object({
-            source: external_exports.literal("inline"),
-            alias: ToolAliasSchema,
-            spec: RemoteMcpToolSchema.or(LocalToolSchema)
-          }),
-          external_exports.object({
-            source: external_exports.literal("resource"),
-            alias: ToolAliasSchema,
-            resource: ToolResourceSchema
-          })
-        ])
-      ),
-      input: JsonValueSchema2,
-      createdAt: external_exports.string().datetime(),
-      updatedAt: external_exports.string().datetime(),
-      startedAt: external_exports.string().datetime().nullable(),
-      finishedAt: external_exports.string().datetime().nullable(),
-      archivedAt: external_exports.string().datetime().nullable(),
-      error: JsonValueSchema2.nullable()
-    });
-    SessionRunsArchiveResponseSchema = external_exports.object({
-      archived: external_exports.boolean(),
-      runs: external_exports.array(SessionRunRecordSchema)
-    });
-  }
-});
-
 // ../../packages/schemas/src/temporal.ts
 var ResourceReconciliationScopeSchema;
 var init_temporal = __esm({
@@ -18097,6 +18306,7 @@ var init_src = __esm({
     init_realtime();
     init_resources();
     init_run_diagnostics();
+    init_run_introspection();
     init_secrets();
     init_session_run_commands();
     init_runtimes();
@@ -18988,8 +19198,9 @@ function createApiClient(input) {
   }
   async function requestJson(path, options = {}) {
     const url2 = new URL(apiUrl(path, options.apiBaseUrl));
-    for (const [name, value] of Object.entries(options.searchParams ?? {})) {
-      url2.searchParams.set(name, value);
+    const searchParamEntries = Array.isArray(options.searchParams) ? options.searchParams : Object.entries(options.searchParams ?? {});
+    for (const [name, value] of searchParamEntries) {
+      url2.searchParams.append(name, value);
     }
     const response = await authenticatedFetch(
       url2.toString(),
@@ -19729,7 +19940,7 @@ function createApiClient(input) {
         sessionApiPath(scope, sessionName, "/runs"),
         {
           apiBaseUrl: options.apiBaseUrl,
-          searchParams: options.includeArchived ? { include_archived: "true" } : void 0
+          searchParams: runListSearchParams(options)
         }
       );
     },
@@ -19737,7 +19948,87 @@ function createApiClient(input) {
       const scope = activeProject();
       return requestJson(projectApiPath(scope, "/runs"), {
         apiBaseUrl: options.apiBaseUrl,
-        searchParams: options.includeArchived ? { include_archived: "true" } : void 0
+        searchParams: runListSearchParams(options)
+      });
+    },
+    async getRunSummary(runId, options = {}) {
+      return requestJson(runApiPath(runId, "/summary"), {
+        apiBaseUrl: options.apiBaseUrl
+      });
+    },
+    async getRunConversation(runId, options = {}) {
+      const searchParams = [];
+      if (options.cursor) searchParams.push(["cursor", options.cursor]);
+      if (options.before !== void 0)
+        searchParams.push(["before", String(options.before)]);
+      if (options.limit !== void 0)
+        searchParams.push(["limit", String(options.limit)]);
+      if (options.order) searchParams.push(["order", options.order]);
+      for (const kind of options.kinds ?? []) searchParams.push(["kind", kind]);
+      for (const role of options.roles ?? []) searchParams.push(["role", role]);
+      return requestJson(
+        runApiPath(runId, "/conversation"),
+        {
+          apiBaseUrl: options.apiBaseUrl,
+          searchParams
+        }
+      );
+    },
+    async searchRunConversation(runId, queries, options = {}) {
+      const searchParams = queries.map((query) => [
+        "q",
+        query
+      ]);
+      if (options.after !== void 0)
+        searchParams.push(["after", String(options.after)]);
+      for (const kind of options.kinds ?? []) searchParams.push(["kind", kind]);
+      for (const role of options.roles ?? []) searchParams.push(["role", role]);
+      if (options.limit !== void 0)
+        searchParams.push(["limit", String(options.limit)]);
+      return requestJson(
+        runApiPath(runId, "/conversation/search"),
+        {
+          apiBaseUrl: options.apiBaseUrl,
+          searchParams
+        }
+      );
+    },
+    async listRunToolExchanges(runId, options = {}) {
+      const searchParams = [];
+      if (options.toolName) searchParams.push(["toolName", options.toolName]);
+      if (options.errorsOnly) searchParams.push(["errorsOnly", "true"]);
+      if (options.after !== void 0)
+        searchParams.push(["after", String(options.after)]);
+      if (options.before !== void 0)
+        searchParams.push(["before", String(options.before)]);
+      if (options.order) searchParams.push(["order", options.order]);
+      if (options.limit !== void 0)
+        searchParams.push(["limit", String(options.limit)]);
+      return requestJson(
+        runApiPath(runId, "/tools"),
+        {
+          apiBaseUrl: options.apiBaseUrl,
+          searchParams
+        }
+      );
+    },
+    async listRunTriggers(runId, options = {}) {
+      return requestJson(runApiPath(runId, "/triggers"), {
+        apiBaseUrl: options.apiBaseUrl,
+        searchParams: options.payload ? { payload: options.payload } : void 0
+      });
+    },
+    async listRunArtifacts(runId, options = {}) {
+      return requestJson(
+        runApiPath(runId, "/artifacts"),
+        {
+          apiBaseUrl: options.apiBaseUrl
+        }
+      );
+    },
+    async listRunCommands(runId, options = {}) {
+      return requestJson(runApiPath(runId, "/commands"), {
+        apiBaseUrl: options.apiBaseUrl
       });
     },
     getOperatorInfo() {
@@ -19797,6 +20088,22 @@ function createApiClient(input) {
     }
   };
 }
+function runListSearchParams(options) {
+  const searchParams = [];
+  if (options.includeArchived) {
+    searchParams.push(["include_archived", "true"]);
+  }
+  for (const status of options.statuses ?? []) {
+    searchParams.push(["status", status]);
+  }
+  if (options.since) {
+    searchParams.push(["created_after", options.since]);
+  }
+  if (options.limit !== void 0) {
+    searchParams.push(["limit", String(options.limit)]);
+  }
+  return searchParams;
+}
 var init_client = __esm({
   "src/lib/api/client.ts"() {
     "use strict";
@@ -21183,7 +21490,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.88",
+      version: "0.1.89",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"
@@ -23866,7 +24173,10 @@ function sessionRunsQueryOptions(client, sessionName, apiUrl, includeArchived =
     queryFn: async () => {
       const res = await client.listSessionRuns(sessionName ?? "", {
         apiBaseUrl: apiUrl,
-        includeArchived
+        includeArchived,
+        // The run-list routes default to 50; ask for the server max so the
+        // TUI keeps showing deep history.
+        limit: TUI_RUN_LIST_LIMIT
       });
       return res.runs;
     },
@@ -23880,7 +24190,8 @@ function runsQueryOptions(client, apiUrl, includeArchived = false) {
     queryFn: async () => {
       const res = await client.listRuns({
         apiBaseUrl: apiUrl,
-        includeArchived
+        includeArchived,
+        limit: TUI_RUN_LIST_LIMIT
       });
       return res.runs;
     },
@@ -23996,12 +24307,13 @@ function invalidateRunsQueries(queryClient, apiUrl, runs) {
     });
   }
 }
-var queryKeys, RUNS_REFETCH_INTERVAL_MS;
+var TUI_RUN_LIST_LIMIT, queryKeys, RUNS_REFETCH_INTERVAL_MS;
 var init_queries = __esm({
   "src/tui/hooks/queries.ts"() {
     "use strict";
     init_src();
     init_ApiClientContext();
+    TUI_RUN_LIST_LIMIT = 200;
     queryKeys = {
       environments: (apiUrl) => ["environments", apiUrl],
       profiles: (apiUrl) => ["profiles", apiUrl],
@@ -24359,7 +24671,7 @@ var init_SessionsView = __esm({
 
 // src/tui/SpecInspector.tsx
 import { Box as Box12, Text as Text13 } from "ink";
-import { stringify as stringify3 } from "yaml";
+import { stringify as stringify4 } from "yaml";
 import { jsx as jsx13, jsxs as jsxs11 } from "react/jsx-runtime";
 function SpecInspector({
   kind,
@@ -24390,7 +24702,7 @@ function specLineCount(spec) {
   return yamlLines(spec).length;
 }
 function yamlLines(spec) {
-  return stringify3(spec).trimEnd().split("\n");
+  return stringify4(spec).trimEnd().split("\n");
 }
 function YamlLine({ line }) {
   const match = /^(\s*)([^:#][^:]*:)(.*)$/.exec(line);
@@ -30424,26 +30736,292 @@ function validateNonNegativeInteger(value, label) {
   }
 }
 
+// src/commands/runs/introspect.ts
+var PREVIEW_CHARS = 160;
+async function handleRunsShow(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const apiBaseUrl = apiUrlFromOptions(context, options);
+  const [run, summary] = await Promise.all([
+    client.getRun(runId, { apiBaseUrl }),
+    client.getRunSummary(runId, { apiBaseUrl })
+  ]);
+  context.io.writeResult({ run, summary }, formatRunShowText);
+}
+function formatRunShowText(result, writeLine) {
+  const { summary } = result;
+  writeLine(
+    `${summary.run.id} ${summary.run.status} session=${summary.run.sessionName} profile=${summary.run.profileName}`
+  );
+  if (summary.run.displayTitle) {
+    writeLine(`title: ${summary.run.displayTitle}`);
+  }
+  writeLine(
+    `created=${summary.run.createdAt} started=${summary.run.startedAt ?? "-"} finished=${summary.run.finishedAt ?? "-"}`
+  );
+  writeLine(
+    `timing: queued=${formatMs(summary.timing.queuedMs)} active=${formatMs(summary.timing.activeMs)} total=${formatMs(summary.timing.totalMs)}`
+  );
+  writeLine(
+    `entries=${summary.conversation.entryCount} failed=${summary.conversation.failedEntryCount} turns=${summary.turns.length} lastSequence=${summary.conversation.lastSequence}`
+  );
+  writeLine(
+    `trigger: spawn=${summary.trigger.spawn} signaled=${summary.trigger.signaledCount} dropped=${summary.trigger.droppedCount}`
+  );
+  if (summary.artifacts.count > 0) {
+    writeLine(
+      `artifacts: ${summary.artifacts.count} (${summary.artifacts.types.join(", ")})`
+    );
+  }
+  writeLine(
+    `commands: ${summary.commands.total} failed=${summary.commands.failed}`
+  );
+  if (summary.tools.length > 0) {
+    writeLine("tools:");
+    for (const tool of summary.tools) {
+      writeLine(
+        `  ${tool.name} calls=${tool.calls} errors=${tool.errors} p50=${formatMs(tool.durationMs.p50)} max=${formatMs(tool.durationMs.max)}`
+      );
+    }
+  }
+  for (const check2 of summary.checks) {
+    writeLine(
+      `check: ${check2.name} ${check2.status}${check2.conclusion ? ` ${check2.conclusion}` : ""}`
+    );
+  }
+  if (summary.run.error !== null) {
+    writeLine(`error: ${JSON.stringify(summary.run.error)}`);
+  }
+}
+async function handleRunsConversation(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const tailMode = !options.after;
+  const response = await client.getRunConversation(runId, {
+    apiBaseUrl: apiUrlFromOptions(context, options),
+    cursor: options.after,
+    before: options.before,
+    order: tailMode ? "desc" : "asc",
+    limit: options.tail ?? 25,
+    kinds: options.kind
+  });
+  const events = [...response.events].sort((a, b) => a.sequence - b.sequence);
+  context.io.writeResult(
+    {
+      runId,
+      events,
+      cursor: response.cursor,
+      hasMore: response.hasMore,
+      full: Boolean(options.full),
+      tailMode
+    },
+    formatConversationText
+  );
+}
+function formatConversationText(result, writeLine) {
+  if (result.events.length === 0) {
+    writeLine("No conversation entries.");
+    return;
+  }
+  for (const event of result.events) {
+    const failed = event.status === "failed" ? " FAILED" : "";
+    writeLine(
+      `${event.sequence} ${event.role}/${event.kind}${failed}: ${entryPreview(event, result.full)}`
+    );
+  }
+  if (result.hasMore) {
+    if (result.tailMode) {
+      const oldest = result.events[0]?.sequence;
+      writeLine(
+        `(more older entries; rerun with --before ${oldest ?? "<sequence>"})`
+      );
+    } else {
+      writeLine(`(more entries; continue with --after ${result.cursor})`);
+    }
+  }
+}
+async function handleRunsSearch(context, runId, queries, options = {}) {
+  const client = createContextApiClient(context);
+  const response = await client.searchRunConversation(runId, queries, {
+    apiBaseUrl: apiUrlFromOptions(context, options),
+    kinds: options.kind,
+    after: options.after,
+    limit: options.limit
+  });
+  context.io.writeResult({ runId, queries, ...response }, formatSearchText);
+}
+function formatSearchText(result, writeLine) {
+  if (result.matches.length === 0) {
+    writeLine(`No matches for: ${result.queries.join(", ")}`);
+    return;
+  }
+  for (const match of result.matches) {
+    for (const snippet of match.snippets) {
+      writeLine(
+        `${match.sequence} ${match.kind} [${snippet.query}]: ${singleLine(snippet.text)}`
+      );
+    }
+  }
+  if (result.hasMore) {
+    writeLine(
+      `(more scanned entries; continue with --after ${result.nextAfterSequence ?? "<sequence>"})`
+    );
+  }
+}
+async function handleRunsTools(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const response = await client.listRunToolExchanges(runId, {
+    apiBaseUrl: apiUrlFromOptions(context, options),
+    toolName: options.tool,
+    errorsOnly: options.errors,
+    after: options.after,
+    before: options.before,
+    limit: options.limit
+  });
+  context.io.writeResult({ runId, ...response }, formatToolsText);
+}
+function formatToolsText(result, writeLine) {
+  if (result.exchanges.length === 0) {
+    writeLine("No tool exchanges.");
+    return;
+  }
+  for (const exchange of result.exchanges) {
+    const duration4 = exchange.durationMs === null ? "-" : `${exchange.durationMs}ms`;
+    const outcome = exchange.isError === null ? "pending" : exchange.isError ? "ERR" : "ok";
+    writeLine(
+      `${exchange.callSequence} ${exchange.name} ${duration4} ${outcome}: ${preview(exchange.input)}`
+    );
+  }
+  if (result.hasMore) {
+    writeLine(
+      `(more exchanges; page older with --before ${result.nextBeforeSequence ?? "<sequence>"})`
+    );
+  }
+}
+async function handleRunsTriggers(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const response = await client.listRunTriggers(runId, {
+    apiBaseUrl: apiUrlFromOptions(context, options)
+  });
+  context.io.writeResult({ runId, ...response }, formatTriggersText);
+}
+function formatTriggersText(result, writeLine) {
+  if (result.spawn) {
+    writeLine(
+      `spawn: ${result.spawn.eventKey} (${result.spawn.originKind}) delivered=${result.spawn.deliveredAt}`
+    );
+  } else if (result.starter) {
+    writeLine(
+      `spawn: ${result.starter.principal.kind === "run" ? "agent" : "manual"} starter=${JSON.stringify(result.starter.principal)}`
+    );
+  } else {
+    writeLine("spawn: manual");
+  }
+  if (result.deliveries.length === 0) {
+    writeLine("No subsequent deliveries.");
+    return;
+  }
+  for (const delivery of result.deliveries) {
+    const reason = delivery.reason ? ` reason=${delivery.reason}` : "";
+    writeLine(
+      `${delivery.deliveredAt} ${delivery.action} ${delivery.eventKey}${reason}`
+    );
+  }
+}
+async function handleRunsArtifacts(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const response = await client.listRunArtifacts(runId, {
+    apiBaseUrl: apiUrlFromOptions(context, options)
+  });
+  context.io.writeResult({ runId, ...response }, formatArtifactsText);
+}
+function formatArtifactsText(result, writeLine) {
+  if (result.artifacts.length === 0) {
+    writeLine("No artifacts currently owned.");
+    return;
+  }
+  for (const artifact of result.artifacts) {
+    writeLine(
+      `${artifact.artifactType} ${artifact.externalId} recorded=${artifact.recordedAt}`
+    );
+  }
+}
+async function handleRunsCommands(context, runId, options = {}) {
+  const client = createContextApiClient(context);
+  const response = await client.listRunCommands(runId, {
+    apiBaseUrl: apiUrlFromOptions(context, options)
+  });
+  context.io.writeResult({ runId, ...response }, formatCommandsText);
+}
+function formatCommandsText(result, writeLine) {
+  if (result.commands.length === 0) {
+    writeLine("No commands.");
+    return;
+  }
+  for (const command of result.commands) {
+    writeLine(
+      `${command.createdAt} ${command.kind} ${command.status} sender=${command.sender.type}: ${preview(command.payload)}`
+    );
+  }
+}
+function formatMs(value) {
+  return value === null ? "-" : `${value}ms`;
+}
+function entryPreview(event, full) {
+  const texts = event.content.parts.map((part) => {
+    switch (part.type) {
+      case "text":
+        return part.text;
+      case "tool_call":
+        return `${part.name} ${stringify3(part.input)}`;
+      case "tool_result":
+        return stringify3(part.output);
+      case "question":
+        return part.questions.map((question) => question.question).join(" ");
+      default:
+        return "";
+    }
+  });
+  const joined = singleLine(texts.join(" "));
+  return full ? joined : clip(joined);
+}
+function preview(value) {
+  return clip(singleLine(stringify3(value)));
+}
+function stringify3(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function singleLine(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function clip(text) {
+  return text.length > PREVIEW_CHARS ? `${text.slice(0, PREVIEW_CHARS)}\u2026` : text;
+}
+
 // src/commands/runs/list.ts
 async function handleRunsList(context, sessionName, options = {}) {
-  const result = await fetchSessionRuns(context, sessionName, options);
+  const result = await fetchRuns(context, sessionName, options);
   context.io.writeResult(result, formatRunsText);
 }
-async function fetchSessionRuns(context, sessionName, options) {
+async function fetchRuns(context, sessionName, options) {
   const client = createContextApiClient(context);
-  const response = await client.listSessionRuns(sessionName, {
+  const clientOptions = {
     apiBaseUrl: apiUrlFromOptions(context, options),
-    includeArchived: options.includeArchived
-  });
+    includeArchived: options.includeArchived,
+    statuses: options.status,
+    since: options.since,
+    limit: options.limit
+  };
+  const response = sessionName ? await client.listSessionRuns(sessionName, clientOptions) : await client.listRuns(clientOptions);
   return {
-    session: sessionName,
+    session: sessionName ?? null,
     runs: response.runs,
     includeArchived: Boolean(options.includeArchived)
   };
 }
 function formatRunsText(result, writeLine) {
   if (result.runs.length === 0) {
-    writeLine(`No runs found for session ${result.session}.`);
+    writeLine(
+      result.session ? `No runs found for session ${result.session}.` : "No runs found in the current project."
+    );
     return;
   }
   for (const run of result.runs) {
@@ -30453,13 +31031,63 @@ function formatRunsText(result, writeLine) {
 }
 
 // src/commands/runs/commands.ts
+function collect(value, previous = []) {
+  return [...previous, value];
+}
 function registerRunCommands(program, context) {
   const runs = program.command("runs").description("Inspect session runs.");
-  runs.command("list").description("List runs for a session.").requiredOption("--session <name>", "session name").option("--include-archived", "include archived runs").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(
-    async (options) => {
-      await handleRunsList(context, options.session, options);
+  runs.command("list").description("List runs for a session or the whole project.").option("--session <name>", "session name").option("--include-archived", "include archived runs").option("--status <status>", "filter by run status (repeatable)", collect).option("--since <iso-timestamp>", "only runs created after this time").option("--limit <count>", "maximum runs to return", parsePositiveInteger).option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (options) => {
+    await handleRunsList(context, options.session, options);
+  });
+  runs.command("show").description("Show a run's lifecycle, timing, and behavior summary.").argument("<run-id>", "run id").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (runId, commandOptions) => {
+    await handleRunsShow(context, runId, commandOptions);
+  });
+  runs.command("conversation").description(
+    "Read a snapshot of a run's conversation (most recent entries by default)."
+  ).argument("<run-id>", "run id").option(
+    "--tail <count>",
+    "number of most recent entries",
+    parsePositiveInteger
+  ).option("--after <cursor>", "read forward from an rt:<sequence> cursor").option(
+    "--before <sequence>",
+    "only entries older than this sequence (backward paging)",
+    parsePositiveInteger
+  ).option("--kind <kind>", "filter by entry kind (repeatable)", collect).option("--full", "do not clip entry previews in text output").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(
+    async (runId, commandOptions) => {
+      await handleRunsConversation(context, runId, commandOptions);
+    }
+  );
+  runs.command("search").description("Grep a run's transcript; multiple query terms OR together.").argument("<run-id>", "run id").argument("<query...>", "search term(s), at least 2 characters each").option("--kind <kind>", "filter by entry kind (repeatable)", collect).option(
+    "--after <sequence>",
+    "only entries after this sequence (forward paging)",
+    parsePositiveInteger
+  ).option("--limit <count>", "maximum matched entries", parsePositiveInteger).option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(
+    async (runId, queries, commandOptions) => {
+      await handleRunsSearch(context, runId, queries, commandOptions);
+    }
+  );
+  runs.command("tools").description("List a run's paired tool calls and results with timing.").argument("<run-id>", "run id").option("--tool <name>", "filter by tool name").option("--errors", "only failed exchanges").option(
+    "--after <sequence>",
+    "only exchanges after this entry sequence",
+    parsePositiveInteger
+  ).option(
+    "--before <sequence>",
+    "only exchanges before this entry sequence (backward paging)",
+    parsePositiveInteger
+  ).option("--limit <count>", "maximum exchanges", parsePositiveInteger).option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(
+    async (runId, commandOptions) => {
+      await handleRunsTools(context, runId, commandOptions);
     }
   );
+  runs.command("triggers").description("Show what spawned a run and the events delivered to it.").argument("<run-id>", "run id").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (runId, commandOptions) => {
+    await handleRunsTriggers(context, runId, commandOptions);
+  });
+  runs.command("artifacts").description("List artifacts a run currently owns.").argument("<run-id>", "run id").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (runId, commandOptions) => {
+    await handleRunsArtifacts(context, runId, commandOptions);
+  });
+  runs.command("commands").description("List a run's inbound command history.").argument("<run-id>", "run id").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (runId, commandOptions) => {
+    await handleRunsCommands(context, runId, commandOptions);
+  });
   runs.command("archive").description("Archive runs so they are hidden from default run lists.").argument("<run-ids...>", "run id(s)").option("--api-url <url>", "Auto API base URL").option("--api-base-url <url>", "Auto API base URL").action(async (runIds, commandOptions) => {
     if (runIds.length === 1) {
       await archiveRunAction(context, runIds[0], commandOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autohq/cli",
-  "version": "0.1.88",
+  "version": "0.1.89",
   "license": "SEE LICENSE IN README.md",
   "publishConfig": {
     "access": "public"