wip inspector

Author: NathanFlurry

docs/conversion.md docs/conversion.mdxdocs/conversion.md renamed to docs/conversion.mdx

@@ -51,10 +51,24 @@ const getDefaultEndpoint = () => {
   return origin;
 };
 
+const getInitialConnection = () => {
+  if (typeof window === "undefined") {
+    return { endpoint: "http://127.0.0.1:2468", token: "" };
+  }
+  const params = new URLSearchParams(window.location.search);
+  const urlParam = params.get("url")?.trim();
+  const tokenParam = params.get("token") ?? "";
+  return {
+    endpoint: urlParam && urlParam.length > 0 ? urlParam : getDefaultEndpoint(),
+    token: tokenParam
+  };
+};
+
 export default function App() {
   const issueTrackerUrl = "https://github.com/rivet-dev/sandbox-agent/issues/new";
-  const [endpoint, setEndpoint] = useState(getDefaultEndpoint);
-  const [token, setToken] = useState("");
+  const initialConnectionRef = useRef(getInitialConnection());
+  const [endpoint, setEndpoint] = useState(initialConnectionRef.current.endpoint);
+  const [token, setToken] = useState(initialConnectionRef.current.token);
   const [connected, setConnected] = useState(false);
   const [connecting, setConnecting] = useState(false);
   const [connectError, setConnectError] = useState<string | null>(null);

frontend/packages/inspector/src/App.tsx

@@ -5,6 +5,7 @@ import {
   Brain,
   Download,
   FileDiff,
+  Gauge,
   GitBranch,
   HelpCircle,
   Image,
@@ -30,6 +31,7 @@ const badges = [
   { key: "sessionLifecycle", label: "Lifecycle", icon: PlayCircle },
   { key: "errorEvents", label: "Errors", icon: AlertTriangle },
   { key: "reasoning", label: "Reasoning", icon: Brain },
+  { key: "status", label: "Status", icon: Gauge },
   { key: "commandExecution", label: "Commands", icon: Terminal },
   { key: "fileChanges", label: "File Changes", icon: FileDiff },
   { key: "mcpTools", label: "MCP", icon: Plug },

frontend/packages/inspector/src/components/agents/CapabilityBadges.tsx

@@ -8,6 +8,7 @@ export type AgentCapabilitiesView = AgentCapabilities & {
   sessionLifecycle?: boolean;
   errorEvents?: boolean;
   reasoning?: boolean;
+  status?: boolean;
   commandExecution?: boolean;
   fileChanges?: boolean;
   mcpTools?: boolean;
@@ -26,6 +27,7 @@ export const emptyCapabilities: AgentCapabilitiesView = {
   sessionLifecycle: false,
   errorEvents: false,
   reasoning: false,
+  status: false,
   commandExecution: false,
   fileChanges: false,
   mcpTools: false,

frontend/packages/inspector/src/types/agents.ts

@@ -1,7 +1,7 @@
 {
   "name": "sandbox-agent",
   "version": "0.1.0",
-  "description": "TypeScript SDK for sandbox-agent",
+  "description": "Universal API for automatic coding agents in sandboxes. Supprots Claude Code, Codex, OpenCode, and Amp.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

sdks/typescript/package.json

@@ -67,6 +67,7 @@ export interface components {
       sessionLifecycle: boolean;
       /** @description Whether this agent uses a shared long-running server process (vs per-turn subprocess) */
       sharedProcess: boolean;
+      status: boolean;
       streamingDeltas: boolean;
       textMessages: boolean;
       toolCalls: boolean;

sdks/typescript/src/generated/openapi.ts

@@ -76,6 +76,8 @@ To keep snapshots deterministic:
 - Permission flow snapshots are truncated after the permission request (or first assistant) event.
 - Unknown events are preserved as `kind: unknown` (raw payload in universal schema).
 - Prefer snapshot-based event skeleton assertions over manual event-order assertions in tests.
+- **Never update snapshots based on any agent that is not the mock agent.** The mock agent is the source of truth for snapshots; other agents must be compared against the mock snapshots without regenerating them.
+- Agent-specific endpoints keep per-agent snapshots; any session-related snapshots must use the mock baseline as the single source of truth.
 
 ## Typical commands