chore: import upstream snapshot with attribution

apps/sim/tools/logs/get_run_details.ts

@@ -0,0 +1,75 @@
+import type { WorkflowLogDetail } from '@/lib/api/contracts/logs'
+import { dollarsToCredits } from '@/lib/billing/credits/conversion'
+import type { LogsGetRunDetailsParams, LogsGetRunDetailsResponse } from '@/tools/logs/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const logsGetRunDetailsTool: ToolConfig<LogsGetRunDetailsParams, LogsGetRunDetailsResponse> =
+  {
+    id: 'logs_get_run_details',
+    name: 'Get Run Details',
+    description:
+      'Fetch details for a single workflow run by its run ID, including the full trace spans.',
+    version: '1.0.0',
+
+    params: {
+      runId: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'The run ID to fetch details for',
+      },
+    },
+
+    request: {
+      url: (params) => {
+        const workspaceId = params._context?.workspaceId
+        if (!workspaceId) {
+          throw new Error('workspaceId is required in execution context')
+        }
+        const qs = new URLSearchParams({ workspaceId })
+        return `/api/logs/by-execution/${encodeURIComponent(params.runId)}?${qs.toString()}`
+      },
+      method: 'GET',
+      headers: () => ({
+        'Content-Type': 'application/json',
+      }),
+    },
+
+    transformResponse: async (response): Promise<LogsGetRunDetailsResponse> => {
+      const result = await response.json()
+      if (!response.ok) {
+        throw new Error(result?.error || `Request failed with status ${response.status}`)
+      }
+      const detail: WorkflowLogDetail = result.data
+
+      return {
+        success: true,
+        output: {
+          runId: detail.executionId ?? '',
+          workflowId: detail.workflowId ?? null,
+          workflowName: detail.workflow?.name ?? null,
+          status: detail.status ?? detail.level,
+          trigger: detail.trigger ?? null,
+          startedAt: detail.createdAt,
+          durationMs: detail.executionData?.totalDuration ?? null,
+          // Costs are stored in dollars; credits are the user-facing unit.
+          cost: detail.cost?.total != null ? dollarsToCredits(detail.cost.total) : null,
+          traceSpans: detail.executionData?.traceSpans ?? [],
+          finalOutput: detail.executionData?.finalOutput ?? null,
+        },
+      }
+    },
+
+    outputs: {
+      runId: { type: 'string', description: 'The run ID' },
+      workflowId: { type: 'string', description: 'Workflow ID this run belongs to' },
+      workflowName: { type: 'string', description: 'Workflow name' },
+      status: { type: 'string', description: 'Run status' },
+      trigger: { type: 'string', description: 'How the run was triggered' },
+      startedAt: { type: 'string', description: 'Run start time (ISO 8601)' },
+      durationMs: { type: 'number', description: 'Run duration in milliseconds' },
+      cost: { type: 'number', description: 'Run cost in credits' },
+      traceSpans: { type: 'array', description: 'Full trace spans for the run' },
+      finalOutput: { type: 'json', description: 'Final output of the run' },
+    },
+  }