Distillation

Date: Sep 9, 2026

• 🔴 (14:16) User stated to always check package.json for the latest scripts before running project commands; commands run from packages/cli or via pnpm --filter sentry run <script> from the repository root.
• 🔴 (14:16) User stated every added package must be placed in devDependencies, never dependencies, because everything is bundled with esbuild and CI enforces this through pnpm run check:deps.
• 🔴 (14:16) User stated packages must always be added with pnpm add -D <package> using the -D flag.
• 🔴 (14:16) User stated properties in property-based tests must always hold regardless of input; model-based tests are preferred for stateful systems, property-based tests for parsing/validation/transformations, and unit tests only for trivial or difficult-to-express properties.
• 🔴 (14:16) User stated agent conversation IDs are organization-scoped and never contain /; [<org>/]<conversation-id> therefore permits at most one slash, with the prefix interpreted as the organization and the remainder as the conversation ID.
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/view.ts, parseConversationTarget(target) trims input, returns the entire slash-free value as conversationId, rejects multiple slashes with validationError("Conversation target must contain at most one '/'.", [USAGE_HINT], "conversation-id"), and rejects empty slash-delimited segments with a second validationError.
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/view.ts, viewCommand uses positional usage [<org>/]<conversation-id>, resolves an omitted organization through resolveOrg({ org: orgArg, cwd }), fetches through withProgress() and getConversationSpans(org, conversationId), builds output with buildTranscriptResult(), copies the API truncated value onto the result, and yields CommandOutput<TranscriptResult>.
• 🔴 (14:16) packages/cli/src/commands/agent-conversation/view.ts defines 3 command examples in order: 1. sentry agent-conversation view conv-123 — organization auto-detected, 2. sentry agent-conversation view my-org/conv-123 — explicit organization, 3. sentry agent-conversation view my-org/conv-123 --json — JSON output.
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/list.ts, listCommand is built with buildListCommand("agent-conversation", ...); pagination uses PAGINATION_KEY = "agent-conversation-list", default period DEFAULT_PERIOD = "7d", and a single optional positional organization slug.
• 🔴 (14:16) packages/cli/src/commands/agent-conversation/list.ts defines ListFlags with limit, optional query, period, json, optional cursor, fresh, and optional fields; ConversationListResult contains conversations, hasMore, optional hasPrev, optional nextCursor, and org.
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/list.ts, list pagination context is keyed by entity "agent-conversation", organization, query q, and serializeTimeRange(flags.period); it calls resolveCursor(), listConversations() with query, limit, cursor, and timeRangeToApiParams(), then advancePaginationState() and hasPreviousPage().
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/list.ts, JSON output is an envelope containing data, hasMore, and boolean hasPrev, plus nextCursor only when present; requested fields are applied to each conversation with filterFields(c, fields).
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/list.ts, human output is Agent conversations in ${org}: followed by formatConversationTable(conversations); an empty page reports No conversations on this page. when hasMore, otherwise No agent conversations found..
• 🔴 (14:16) In packages/cli/src/commands/agent-conversation/list.ts, pagination hints are generated with shared paginationHint() using sentry agent-conversation list ${org} -c next and -c prev; query and non-default period flags are preserved in the hint suffix.
• 🔴 (14:16) packages/cli/src/commands/agent-conversation/list.ts defines 5 command examples in order: 1. sentry agent-conversation list — recent conversations, 2. sentry agent-conversation list my-org — explicit organization, 3. sentry agent-conversation list --limit 50 --period 24h — more results over 24 hours, 4. sentry agent-conversation list -q "has:errors" — filtered conversations, 5. sentry agent-conversation list my-org -c next — pagination.