Add white-label attribution to agent run CLI

Adds external workspace/user/project attribution flags to CLI agent-run creation and listing paths.

Author: robertohluna

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@miosa/cli",
-  "version": "1.0.78",
+  "version": "1.0.79",
   "description": "MIOSA platform CLI — projects, sandboxes, deploys, databases, more",
   "type": "module",
   "bin": {

package.json

@@ -17,6 +17,9 @@ interface AgentRun {
   id: string;
   target_kind?: string;
   target_id?: string;
+  external_workspace_id?: string;
+  external_user_id?: string;
+  external_project_id?: string;
   provider?: string;
   status?: string;
   prompt?: string;
@@ -154,6 +157,9 @@ export function register(program: Command): void {
     .option("--computer <id>", "Filter by computer ID")
     .option("--workspace <id>", "Filter by workspace ID")
     .option("--project <id>", "Filter by project ID")
+    .option("--external-workspace <id>", "Filter by white-label workspace/customer ID")
+    .option("--external-user <id>", "Filter by white-label user ID")
+    .option("--external-project <id>", "Filter by white-label project ID")
     .option("--target-kind <kind>", "Filter by target kind")
     .option("--target-id <id>", "Filter by target ID")
     .option("--status <status>", "Filter by run status")
@@ -166,6 +172,9 @@ export function register(program: Command): void {
           computer?: string;
           workspace?: string;
           project?: string;
+          externalWorkspace?: string;
+          externalUser?: string;
+          externalProject?: string;
           targetKind?: string;
           targetId?: string;
           status?: string;
@@ -182,6 +191,11 @@ export function register(program: Command): void {
           const query = new URLSearchParams();
           if (opts.workspace) query.set("workspace_id", opts.workspace);
           if (opts.project) query.set("project_id", opts.project);
+          if (opts.externalWorkspace)
+            query.set("external_workspace_id", opts.externalWorkspace);
+          if (opts.externalUser) query.set("external_user_id", opts.externalUser);
+          if (opts.externalProject)
+            query.set("external_project_id", opts.externalProject);
           if (opts.sandbox) {
             query.set("target_kind", "sandbox");
             query.set("target_id", opts.sandbox);
@@ -210,6 +224,18 @@ export function register(program: Command): void {
           renderTable(data, [
             { header: "ID", key: "id", width: 18 },
             { header: "TARGET", key: (row) => `${str(row.target_kind)} ${str(row.target_id)}`, width: 28 },
+            {
+              header: "EXTERNAL",
+              key: (row) =>
+                [
+                  str(row.external_workspace_id),
+                  str(row.external_user_id),
+                  str(row.external_project_id),
+                ]
+                  .filter(Boolean)
+                  .join(" / "),
+              width: 30,
+            },
             { header: "PROVIDER", key: "provider", width: 12 },
             { header: "STATUS", key: (row) => colorStatus(row.status), width: 12 },
             { header: "PROMPT", key: (row) => str(row.prompt), width: 44 },

src/commands/agent-runs.ts

@@ -84,6 +84,9 @@ type AgentRunOptions = JsonOptions & {
   timeout?: string;
   agentProfile?: string;
   skipAgentProfile?: boolean;
+  externalWorkspace?: string;
+  externalUser?: string;
+  externalProject?: string;
   executionPacket?: string;
   executionPacketFile?: string;
   outputContract?: string;
@@ -412,6 +415,9 @@ async function runPromptTarget(instruction: string, opts: AgentRunOptions): Prom
   if (opts.timeout) body["timeout"] = Number.parseInt(opts.timeout, 10);
   if (opts.agentProfile) body["agent_runtime_profile_id"] = opts.agentProfile;
   if (opts.skipAgentProfile) body["skip_agent_runtime_profile"] = true;
+  if (opts.externalWorkspace) body["external_workspace_id"] = opts.externalWorkspace;
+  if (opts.externalUser) body["external_user_id"] = opts.externalUser;
+  if (opts.externalProject) body["external_project_id"] = opts.externalProject;
   const executionPacket = readJsonValue(
     opts.executionPacket,
     opts.executionPacketFile,
@@ -472,6 +478,9 @@ async function runOpenComputerHostPrompt(
   if (opts.model) body["model"] = opts.model;
   if (opts.agentProfile) body["agent_runtime_profile_id"] = opts.agentProfile;
   if (opts.skipAgentProfile) body["skip_agent_runtime_profile"] = true;
+  if (opts.externalWorkspace) body["external_workspace_id"] = opts.externalWorkspace;
+  if (opts.externalUser) body["external_user_id"] = opts.externalUser;
+  if (opts.externalProject) body["external_project_id"] = opts.externalProject;
   const executionPacket = readJsonValue(
     opts.executionPacket,
     opts.executionPacketFile,
@@ -563,6 +572,9 @@ function buildRun(agent: Command): void {
     .option("--timeout <sec>", "Timeout in seconds")
     .option("--agent-profile <id>", "Agent runtime profile ID")
     .option("--skip-agent-profile", "Do not apply default agent runtime profile")
+    .option("--external-workspace <id>", "White-label workspace/customer ID for billing attribution")
+    .option("--external-user <id>", "White-label user ID for billing attribution")
+    .option("--external-project <id>", "White-label project ID for billing attribution")
     .option("--execution-packet <json>", "Execution packet JSON for product context, plan, and acceptance criteria")
     .option("--execution-packet-file <file>", "Read execution packet JSON from a file")
     .option("--output-contract <json>", "Output contract JSON declaring expected artifacts/previews")

src/commands/agent.ts

@@ -648,6 +648,18 @@ export function register(program: Command): void {
       "--skip-agent-profile",
       "Do not apply the default agent runtime profile",
     )
+    .option(
+      "--external-workspace <id>",
+      "White-label workspace/customer ID for billing attribution",
+    )
+    .option(
+      "--external-user <id>",
+      "White-label user ID for billing attribution",
+    )
+    .option(
+      "--external-project <id>",
+      "White-label project ID for billing attribution",
+    )
     .option("--timeout <sec>", "Exec timeout in seconds", parseIntegerOption)
     .option("--json", "Output as JSON")
     .action(
@@ -664,6 +676,9 @@ export function register(program: Command): void {
           env?: string[];
           agentProfile?: string;
           skipAgentProfile?: boolean;
+          externalWorkspace?: string;
+          externalUser?: string;
+          externalProject?: string;
           timeout?: number;
         } & JsonOptions,
       ) =>
@@ -707,6 +722,15 @@ export function register(program: Command): void {
           if (opts.skipAgentProfile) {
             body["skip_agent_runtime_profile"] = true;
           }
+          if (opts.externalWorkspace) {
+            body["external_workspace_id"] = opts.externalWorkspace;
+          }
+          if (opts.externalUser) {
+            body["external_user_id"] = opts.externalUser;
+          }
+          if (opts.externalProject) {
+            body["external_project_id"] = opts.externalProject;
+          }
           if (opts.timeout != null) body["timeout"] = opts.timeout;
 
           const run = unwrap(

src/commands/sandbox.ts

@@ -48,7 +48,7 @@ describe("miosa agent-runs", () => {
     const pool = mock.get("https://api.miosa.ai");
     pool
       .intercept({
-        path: "/api/v1/agent-runs?target_kind=sandbox&target_id=sbx_123&status=running",
+        path: "/api/v1/agent-runs?external_workspace_id=clinic-iq&external_user_id=founder-1&external_project_id=landing-page&target_kind=sandbox&target_id=sbx_123&status=running",
         method: "GET",
       })
       .reply(
@@ -113,6 +113,12 @@ describe("miosa agent-runs", () => {
       "sbx_123",
       "--status",
       "running",
+      "--external-workspace",
+      "clinic-iq",
+      "--external-user",
+      "founder-1",
+      "--external-project",
+      "landing-page",
     ]);
     await program.parseAsync([
       "node",

test/commands/agent-runs.test.ts

@@ -200,6 +200,9 @@ describe("miosa agent", () => {
           provider: "codex",
           env: { FEATURE_FLAG: "on" },
           agent_runtime_profile_id: "prof_123",
+          external_workspace_id: "clinic-iq",
+          external_user_id: "founder-1",
+          external_project_id: "landing-page",
         }),
       })
       .reply(
@@ -237,6 +240,12 @@ describe("miosa agent", () => {
       "FEATURE_FLAG=on",
       "--agent-profile",
       "prof_123",
+      "--external-workspace",
+      "clinic-iq",
+      "--external-user",
+      "founder-1",
+      "--external-project",
+      "landing-page",
     ]);
 
     expect(JSON.parse(logged.join("\n"))).toMatchObject({

test/commands/agent.test.ts

@@ -1477,6 +1477,9 @@ describe("miosa sandbox connectors", () => {
           prompt: "hello",
           env: { FEATURE_FLAG: "on" },
           agent_runtime_profile_id: "prof_123",
+          external_workspace_id: "clinic-iq",
+          external_user_id: "founder-1",
+          external_project_id: "landing-page",
         }),
       })
       .reply(
@@ -1506,6 +1509,12 @@ describe("miosa sandbox connectors", () => {
       "FEATURE_FLAG=on",
       "--agent-profile",
       "prof_123",
+      "--external-workspace",
+      "clinic-iq",
+      "--external-user",
+      "founder-1",
+      "--external-project",
+      "landing-page",
       "hello",
     ]);