feat(cli): expose log detail trace spans

Author: TheodoreSpeaks

packages/sim-cli/README.md

@@ -125,8 +125,8 @@ sim workflows deploy|undeploy|rollback <id>
 sim workflows run <id> [--input <json|@file>] [--select-output <path>…]
 
 sim logs list [--level error] [--workflow <id>…] [--trigger <name>…] [--start <date>]
-sim logs get <id>
-sim logs execution <executionId>
+sim logs get <logId>
+sim logs executions get <executionId>
 
 sim tables ls [path] [--search <text>] [--limit <n>]
 sim tables list [--folder <path>]
@@ -170,6 +170,13 @@ sim billing logs [--period 7d] [--source sim-chat] [--limit <n>]
 
 The `sim-chat` billing source combines Copilot and workspace chat usage.
 
+`sim logs get` keeps the default human output concise. Use JSON or YAML to
+inspect its complete `executionData` and recursive `traceSpans` tree:
+
+```bash
+sim logs get <logId> --output json | jq '.traceSpans'
+```
+
 Workflow output selectors use `blockName.field` syntax, such as
 `--select-output agent_1.content`; fields that are not produced are omitted.
 

packages/sim-cli/src/contract/commands.ts

@@ -166,7 +166,8 @@ export const CLI_CONTRACT: CliContract = {
     ],
   },
   getLog: {
-    describe: 'Show a log summary (execution data is available in JSON or YAML output)',
+    describe:
+      'Show a log summary (traceSpans and executionData are included in JSON or YAML output)',
     fields: [
       { header: 'id' },
       { header: 'execution', path: 'executionId' },

packages/sim-cli/src/generated/v2-api.ts

@@ -2175,6 +2175,39 @@ export type GetLogParams = {
   id: string
 }
 
+type GetLogResponseRef0 = {
+  id: string
+  name: string
+  type: string
+  duration?: number
+  durationMs?: number
+  startTime?: string
+  endTime?: string
+  status?: string
+  blockId?: string
+  input?: unknown
+  output?: unknown
+  tokens?:
+    | number
+    | {
+        total?: number
+        input?: number
+        output?: number
+      }
+  relativeStartMs?: number
+  toolCalls?: Array<{
+    id?: string
+    name?: string
+    arguments?: unknown
+    result?: unknown
+    error?: string
+    startTime?: string
+    endTime?: string
+    duration?: number
+  }>
+  children?: Array<GetLogResponseRef0>
+}
+
 export type GetLogResponse = {
   data: {
     id: string
@@ -2198,6 +2231,7 @@ export type GetLogResponse = {
       deleted: boolean
     }
     executionData: unknown
+    traceSpans: Array<GetLogResponseRef0>
     cost: {
       total: number
     } | null
@@ -2897,6 +2931,39 @@ export type ListLogsQuery = {
   folderPaths?: string
 }
 
+type ListLogsResponseRef0 = {
+  id: string
+  name: string
+  type: string
+  duration?: number
+  durationMs?: number
+  startTime?: string
+  endTime?: string
+  status?: string
+  blockId?: string
+  input?: unknown
+  output?: unknown
+  tokens?:
+    | number
+    | {
+        total?: number
+        input?: number
+        output?: number
+      }
+  relativeStartMs?: number
+  toolCalls?: Array<{
+    id?: string
+    name?: string
+    arguments?: unknown
+    result?: unknown
+    error?: string
+    startTime?: string
+    endTime?: string
+    duration?: number
+  }>
+  children?: Array<ListLogsResponseRef0>
+}
+
 export type ListLogsResponse = {
   data: Array<{
     id: string
@@ -2919,7 +2986,7 @@ export type ListLogsResponse = {
       deleted: boolean
     }
     finalOutput?: unknown
-    traceSpans?: unknown
+    traceSpans?: Array<ListLogsResponseRef0>
   }>
   nextCursor: string | null
 }

packages/sim-cli/src/runtime/build.test.ts

@@ -458,6 +458,10 @@ describe('commands parsed through commander', () => {
       /--encoding.*utf-8.*base64/s
     )
   })
+
+  it('points log detail users to complete trace output', () => {
+    expect(commandAt('logs', 'get').description()).toMatch(/traceSpans.*JSON or YAML/)
+  })
 })
 
 describe('single-resource rendering', () => {
@@ -555,7 +559,7 @@ describe('single-resource rendering', () => {
     expect(JSON.parse(printed[0])).toEqual({ row: { id: 'r1' }, operation: 'inserted' })
   })
 
-  it('keeps sensitive execution data out of human log output', async () => {
+  it('keeps sensitive execution detail out of human log output', async () => {
     const log = {
       id: 'log_1',
       executionId: 'exec_1',
@@ -568,14 +572,38 @@ describe('single-resource rendering', () => {
       cost: { total: 0.001 },
       files: [],
       executionData: { env: { SECRET_TOKEN: 'encrypted-value' } },
+      traceSpans: [
+        {
+          id: 'span_1',
+          name: 'Workflow Execution',
+          type: 'workflow',
+          children: [
+            {
+              id: 'span_2',
+              name: 'Send email',
+              type: 'block',
+              input: { recipient: 'private@example.com' },
+            },
+          ],
+        },
+      ],
     }
 
     const human = await lines(['logs', 'get', 'log_1'], log, 'text')
     expect(human.join('\n')).not.toContain('executionData')
     expect(human.join('\n')).not.toContain('SECRET_TOKEN')
+    expect(human.join('\n')).not.toContain('traceSpans')
+    expect(human.join('\n')).not.toContain('private@example.com')
 
     const machine = await lines(['logs', 'get', 'log_1'], log, 'json')
-    expect(JSON.parse(machine[0])).toMatchObject({ executionData: log.executionData })
+    expect(JSON.parse(machine[0])).toMatchObject({
+      executionData: log.executionData,
+      traceSpans: log.traceSpans,
+    })
+
+    const yaml = await lines(['logs', 'get', 'log_1'], log, 'yaml')
+    expect(yaml.join('\n')).toContain('traceSpans:')
+    expect(yaml.join('\n')).toContain('span_2')
   })
 })