import { Command } from "commander"; import { addCommonClientOptions, apiPath, handleCommandError, printOutput, resolveCommandContext, type BaseClientOptions, } from "./common.js"; interface CompanyOptions extends BaseClientOptions { companyId?: string; } interface JsonPayloadOptions extends CompanyOptions { payloadJson: string; } interface RuntimeActionOptions extends BaseClientOptions { payloadJson?: string; } interface OrgOutputOptions extends CompanyOptions { out?: string; } export function registerWorkspaceCommands(program: Command): void { const org = program.command("org").description("Organization chart operations"); addCompanyGet(org, "get", "Get org chart data", "org"); addBinaryCompanyGet(org, "svg", "Download org chart SVG", "org.svg"); addBinaryCompanyGet(org, "png", "Download org chart PNG", "org.png"); addCompanyGet(program.command("agent-config").description("Agent configuration summaries"), "list", "List agent configurations", "agent-configurations"); const workspace = program.command("workspace").description("Execution workspace operations"); addCompanyGet(workspace, "list", "List execution workspaces", "execution-workspaces"); addIdGet(workspace, "get", "Get an execution workspace", "execution-workspaces"); addIdGet(workspace, "close-readiness", "Check execution workspace close readiness", "execution-workspaces", "close-readiness"); addIdGet(workspace, "operations", "List execution workspace operations", "execution-workspaces", "workspace-operations"); addPatchJson(workspace, "update", "Update an execution workspace", "execution-workspaces"); addRuntimeAction(workspace, "runtime-service", "Control an execution workspace runtime service", "execution-workspaces", "runtime-services"); addRuntimeAction(workspace, "runtime-command", "Run an execution workspace runtime command", "execution-workspaces", "runtime-commands"); const environment = program.command("environment").description("Environment operations"); addCompanyGet(environment, "list", "List environments", "environments"); addCompanyGet(environment, "capabilities", "Get environment capabilities", "environments/capabilities"); addCompanyPostJson(environment, "create", "Create an environment", "environments"); addIdGet(environment, "get", "Get an environment", "environments"); addIdGet(environment, "leases", "List environment leases", "environments", "leases"); addCommonClientOptions( environment .command("lease") .description("Get an environment lease") .argument("", "Lease ID") .action(async (leaseId: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.get(apiPath`/api/environment-leases/${leaseId}`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); addPatchJson(environment, "update", "Update an environment", "environments"); addDelete(environment, "delete", "Delete an environment", "environments"); addPostEmpty(environment, "probe", "Probe an environment", "environments", "probe"); addCompanyPostJson(environment, "probe-config", "Probe an environment config", "environments/probe-config"); const projectWorkspace = program.command("project-workspace").description("Project workspace operations"); addCommonClientOptions( projectWorkspace .command("list") .description("List project workspaces") .argument("", "Project ID") .action(async (projectId: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.get(apiPath`/api/projects/${projectId}/workspaces`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); addProjectWorkspaceJson(projectWorkspace, "create", "Create a project workspace", "post"); addProjectWorkspaceJson(projectWorkspace, "update", "Update a project workspace", "patch"); addCommonClientOptions( projectWorkspace .command("delete") .description("Delete a project workspace") .argument("", "Project ID") .argument("", "Workspace ID") .action(async (projectId: string, workspaceId: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.delete(apiPath`/api/projects/${projectId}/workspaces/${workspaceId}`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); addProjectRuntimeAction(projectWorkspace, "runtime-service", "Control a project workspace runtime service", "runtime-services"); addProjectRuntimeAction(projectWorkspace, "runtime-command", "Run a project workspace runtime command", "runtime-commands"); } function addCompanyGet(parent: Command, name: string, description: string, path: string): void { addCommonClientOptions( parent .command(name) .description(description) .option("-C, --company-id ", "Company ID") .action(async (opts: CompanyOptions) => { try { const ctx = resolveCommandContext(opts, { requireCompany: true }); const result = await ctx.api.get(`${apiPath`/api/companies/${ctx.companyId}`}/${path}`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), { includeCompany: false }, ); } function addBinaryCompanyGet(parent: Command, name: string, description: string, path: string): void { addCommonClientOptions( parent .command(name) .description(description) .option("-C, --company-id ", "Company ID") .option("--out ", "Write output to file") .action(async (opts: OrgOutputOptions) => { try { const ctx = resolveCommandContext(opts, { requireCompany: true }); const response = await fetch(buildApiUrl(ctx.api.apiBase, `${apiPath`/api/companies/${ctx.companyId}`}/${path}`), { headers: ctx.api.apiKey ? { authorization: `Bearer ${ctx.api.apiKey}` } : undefined, }); const bytes = Buffer.from(await response.arrayBuffer()); if (!response.ok) throw new Error(`API error ${response.status}: ${bytes.toString("utf8")}`); if (opts.out) { const { writeFile } = await import("node:fs/promises"); await writeFile(opts.out, bytes); printOutput({ out: opts.out, bytes: bytes.byteLength }, { json: ctx.json }); return; } process.stdout.write(bytes); } catch (err) { handleCommandError(err); } }), { includeCompany: false }, ); } function addCompanyPostJson(parent: Command, name: string, description: string, path: string): void { addCommonClientOptions( parent .command(name) .description(description) .option("-C, --company-id ", "Company ID") .requiredOption("--payload-json ", "JSON payload") .action(async (opts: JsonPayloadOptions) => { try { const ctx = resolveCommandContext(opts, { requireCompany: true }); const result = await ctx.api.post(`${apiPath`/api/companies/${ctx.companyId}`}/${path}`, parseJson(opts.payloadJson)); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), { includeCompany: false }, ); } function addIdGet(parent: Command, name: string, description: string, resource: string, suffix?: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "ID") .action(async (id: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.get(`/api/${resource}/${encodeURIComponent(id)}${suffix ? `/${suffix}` : ""}`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addPatchJson(parent: Command, name: string, description: string, resource: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "ID") .requiredOption("--payload-json ", "JSON payload") .action(async (id: string, opts: JsonPayloadOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.patch(`/api/${resource}/${encodeURIComponent(id)}`, parseJson(opts.payloadJson)); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addDelete(parent: Command, name: string, description: string, resource: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "ID") .action(async (id: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.delete(`/api/${resource}/${encodeURIComponent(id)}`); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addPostEmpty(parent: Command, name: string, description: string, resource: string, suffix: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "ID") .action(async (id: string, opts: BaseClientOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.post(`/api/${resource}/${encodeURIComponent(id)}/${suffix}`, {}); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addRuntimeAction(parent: Command, name: string, description: string, resource: string, actionResource: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "Workspace ID") .argument("", "start, stop, restart, or run") .option("--payload-json ", "Runtime target JSON payload", "{}") .action(async (id: string, action: string, opts: RuntimeActionOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.post(`/api/${resource}/${encodeURIComponent(id)}/${actionResource}/${encodeURIComponent(action)}`, parseJson(opts.payloadJson ?? "{}")); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addProjectWorkspaceJson(parent: Command, name: string, description: string, method: "post" | "patch"): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "Project ID") .argument("[workspaceId]", "Workspace ID for update") .requiredOption("--payload-json ", "JSON payload") .action(async (projectId: string, workspaceId: string | undefined, opts: JsonPayloadOptions) => { try { if (method === "patch" && !workspaceId) throw new Error("workspaceId is required for update"); const ctx = resolveCommandContext(opts); const path = method === "post" ? apiPath`/api/projects/${projectId}/workspaces` : apiPath`/api/projects/${projectId}/workspaces/${workspaceId}`; const result = method === "post" ? await ctx.api.post(path, parseJson(opts.payloadJson)) : await ctx.api.patch(path, parseJson(opts.payloadJson)); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function addProjectRuntimeAction(parent: Command, name: string, description: string, actionResource: string): void { addCommonClientOptions( parent .command(name) .description(description) .argument("", "Project ID") .argument("", "Workspace ID") .argument("", "start, stop, restart, or run") .option("--payload-json ", "Runtime target JSON payload", "{}") .action(async (projectId: string, workspaceId: string, action: string, opts: RuntimeActionOptions) => { try { const ctx = resolveCommandContext(opts); const result = await ctx.api.post( `${apiPath`/api/projects/${projectId}/workspaces/${workspaceId}`}/${actionResource}/${encodeURIComponent(action)}`, parseJson(opts.payloadJson ?? "{}"), ); printOutput(result, { json: ctx.json }); } catch (err) { handleCommandError(err); } }), ); } function buildApiUrl(apiBase: string, path: string): string { const url = new URL(apiBase); url.pathname = `${url.pathname.replace(/\/+$/, "")}${path.startsWith("/") ? path : `/${path}`}`; return url.toString(); } function parseJson(value: string): unknown { return JSON.parse(value) as unknown; }