@forgeax/view 0.2.1-beta-20260924075842

package/dist/modules/backend.mjs

@@ -0,0 +1,54 @@
+import {
+  createViewBackend,
+  createViewHostBinding,
+  createViewPlatformBinding
+} from "./chunks/chunk-EPSTTHWV.mjs";
+import "./chunks/chunk-XFQT7XCG.mjs";
+import "./chunks/chunk-L45W6KM6.mjs";
+import "./chunks/chunk-XUYFV23R.mjs";
+import "./chunks/chunk-QD6CCRMG.mjs";
+import "./chunks/chunk-JHOURMYW.mjs";
+import "./chunks/chunk-R4I4JEY5.mjs";
+import "./chunks/chunk-C45U6IIY.mjs";
+import "./chunks/chunk-IVHNYKZB.mjs";
+import "./chunks/chunk-73UZNRHN.mjs";
+import "./chunks/chunk-KHRTIZ56.mjs";
+import "./chunks/chunk-IGRMZYRD.mjs";
+import "./chunks/chunk-H3M22JDL.mjs";
+import "./chunks/chunk-RXF7SBBZ.mjs";
+import "./chunks/chunk-Y5HXCPPQ.mjs";
+import "./chunks/chunk-QK6W7MJO.mjs";
+import "./chunks/chunk-VIGOJWSO.mjs";
+import "./chunks/chunk-7URFF53W.mjs";
+import "./chunks/chunk-KNBAYU5I.mjs";
+import "./chunks/chunk-TSAEK5P3.mjs";
+import "./chunks/chunk-VZXGRZYU.mjs";
+import "./chunks/chunk-VDZJWEAA.mjs";
+import "./chunks/chunk-EJGBVKFE.mjs";
+import "./chunks/chunk-D7GWRZLL.mjs";
+import "./chunks/chunk-NBLGKTEM.mjs";
+import "./chunks/chunk-YYXQDUVT.mjs";
+import "./chunks/chunk-LERMYZRC.mjs";
+import "./chunks/chunk-ALT7XVMQ.mjs";
+import "./chunks/chunk-SSQMQJ52.mjs";
+import "./chunks/chunk-C7R3YRA7.mjs";
+import "./chunks/chunk-VY3S5BWI.mjs";
+import "./chunks/chunk-FMCACPX5.mjs";
+import "./chunks/chunk-FKCQYDLX.mjs";
+import "./chunks/chunk-2IJKOG2F.mjs";
+import "./chunks/chunk-ASI2HBE6.mjs";
+import "./chunks/chunk-RR6L6VVR.mjs";
+import "./chunks/chunk-46O5WX43.mjs";
+import "./chunks/chunk-FJM6WWIY.mjs";
+import "./chunks/chunk-32GD5LL6.mjs";
+import "./chunks/chunk-TP26TASL.mjs";
+import "./chunks/chunk-ZLNWF4ET.mjs";
+import "./chunks/chunk-CUH2G6UF.mjs";
+import "./chunks/chunk-GQBZMCTK.mjs";
+import "./chunks/chunk-FLGC65SR.mjs";
+export {
+  createViewBackend,
+  createViewHostBinding,
+  createViewPlatformBinding
+};
+//# sourceMappingURL=backend.mjs.map

package/dist/modules/backend.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/browser.mjs

@@ -0,0 +1,180 @@
+import {
+  VIEW_LAYOUT_HOST_ID
+} from "./chunks/chunk-7YSDRIFN.mjs";
+import {
+  VIEW_EXTENSION_CAPABILITIES,
+  VIEW_EXTENSION_ID,
+  createViewExtensionTransport,
+  createViewExtensionWorkspaceClient
+} from "./chunks/chunk-LKJCXYSJ.mjs";
+import {
+  connectViewFrontend,
+  mountViewViewer,
+  mountViewWorkspace
+} from "./chunks/chunk-ZFXZ2NUI.mjs";
+import {
+  createViewSlotRegistry
+} from "./chunks/chunk-SR66S6EJ.mjs";
+import "./chunks/chunk-YVQSDKAO.mjs";
+import "./chunks/chunk-4WXD2KYX.mjs";
+import "./chunks/chunk-GYWIY7AL.mjs";
+import "./chunks/chunk-QURKBAG4.mjs";
+import "./chunks/chunk-6ZWWVAZK.mjs";
+import "./chunks/chunk-MBS3EICT.mjs";
+import "./chunks/chunk-QLBQQKRI.mjs";
+import "./chunks/chunk-ZNZPYE2V.mjs";
+import "./chunks/chunk-NBJKLWJ5.mjs";
+import "./chunks/chunk-AL6ZWIEU.mjs";
+import "./chunks/chunk-UAY27HT3.mjs";
+import "./chunks/chunk-YTHGRKGI.mjs";
+import {
+  ViewWorkspaceInputController,
+  ViewWorkspaceShell,
+  createBrowserPagePresentation
+} from "./chunks/chunk-QSKQZGK7.mjs";
+import "./chunks/chunk-7TGVWKH7.mjs";
+import "./chunks/chunk-UDVQHPWV.mjs";
+import "./chunks/chunk-PEUT3FW7.mjs";
+import "./chunks/chunk-UDLIWGWS.mjs";
+import "./chunks/chunk-4BXQOUDQ.mjs";
+import "./chunks/chunk-G7BAFAGO.mjs";
+import "./chunks/chunk-QF4V23GW.mjs";
+import "./chunks/chunk-FV3DSKZB.mjs";
+import "./chunks/chunk-OBK4LIJB.mjs";
+import {
+  VIEW_INSPECTOR_API_VERSION,
+  VIEW_INSPECTOR_OPERATIONS,
+  VIEW_INSPECTOR_SERVICES,
+  VIEW_INSPECTOR_TOPIC,
+  ViewInspectorClient,
+  ViewInspectorPanel,
+  createInspectorRequest,
+  createViewInspectorToolContributions
+} from "./chunks/chunk-KHRTIZ56.mjs";
+import "./chunks/chunk-IGRMZYRD.mjs";
+import "./chunks/chunk-H3M22JDL.mjs";
+import "./chunks/chunk-RXF7SBBZ.mjs";
+import "./chunks/chunk-Y5HXCPPQ.mjs";
+import "./chunks/chunk-QK6W7MJO.mjs";
+import "./chunks/chunk-VIGOJWSO.mjs";
+import "./chunks/chunk-7URFF53W.mjs";
+import {
+  DISPLAY_SURFACE_ID
+} from "./chunks/chunk-KNBAYU5I.mjs";
+import "./chunks/chunk-TSAEK5P3.mjs";
+import "./chunks/chunk-VZXGRZYU.mjs";
+import "./chunks/chunk-VDZJWEAA.mjs";
+import "./chunks/chunk-EJGBVKFE.mjs";
+import "./chunks/chunk-D7GWRZLL.mjs";
+import "./chunks/chunk-NBLGKTEM.mjs";
+import "./chunks/chunk-YYXQDUVT.mjs";
+import "./chunks/chunk-LERMYZRC.mjs";
+import "./chunks/chunk-ALT7XVMQ.mjs";
+import "./chunks/chunk-SSQMQJ52.mjs";
+import "./chunks/chunk-C7R3YRA7.mjs";
+import {
+  ViewWorkspaceClient,
+  createViewWorkspaceClient
+} from "./chunks/chunk-VY3S5BWI.mjs";
+import "./chunks/chunk-FMCACPX5.mjs";
+import "./chunks/chunk-FKCQYDLX.mjs";
+import "./chunks/chunk-2IJKOG2F.mjs";
+import "./chunks/chunk-ASI2HBE6.mjs";
+import "./chunks/chunk-RR6L6VVR.mjs";
+import "./chunks/chunk-46O5WX43.mjs";
+import "./chunks/chunk-FJM6WWIY.mjs";
+import {
+  VIEW_DISPLAY_TAB_ID,
+  VIEW_FILE_GET_SERVICE,
+  VIEW_PAGE_TYPES,
+  VIEW_WORKSPACE_API_VERSION,
+  VIEW_WORKSPACE_COOK_MODES,
+  VIEW_WORKSPACE_CORE_OPERATIONS,
+  VIEW_WORKSPACE_DOMAIN_OPERATIONS,
+  VIEW_WORKSPACE_OPERATIONS,
+  VIEW_WORKSPACE_SERVICES,
+  VIEW_WORKSPACE_STATE_TOPIC,
+  VIEW_WORKSPACE_TAB_ID,
+  ViewWorkspaceError,
+  assertWorkspaceRequest,
+  cloneWorkspaceValue,
+  createWorkspaceRequest,
+  isOpaqueWorkspaceDiagnostic,
+  jsonUnchanged,
+  requireWorkspaceInteger,
+  requireWorkspaceObject,
+  requireWorkspaceString,
+  serializeWorkspaceAsset,
+  serializeWorkspaceDdc,
+  serializeWorkspaceInspection,
+  serializeWorkspaceOpenRequest,
+  serializeWorkspaceProject,
+  serializeWorkspaceResourceOpens,
+  serializeWorkspaceState,
+  serializeWorkspaceTarget,
+  workspaceCapabilities,
+  workspaceError,
+  workspaceInspectionFactRows,
+  workspaceUiFingerprint
+} from "./chunks/chunk-32GD5LL6.mjs";
+import "./chunks/chunk-TP26TASL.mjs";
+import "./chunks/chunk-ZLNWF4ET.mjs";
+import "./chunks/chunk-FLGC65SR.mjs";
+export {
+  DISPLAY_SURFACE_ID as VIEW_DISPLAY_SURFACE_ID,
+  VIEW_DISPLAY_TAB_ID,
+  VIEW_EXTENSION_CAPABILITIES,
+  VIEW_EXTENSION_ID,
+  VIEW_FILE_GET_SERVICE,
+  VIEW_INSPECTOR_API_VERSION,
+  VIEW_INSPECTOR_OPERATIONS,
+  VIEW_INSPECTOR_SERVICES,
+  VIEW_INSPECTOR_TOPIC,
+  VIEW_LAYOUT_HOST_ID,
+  VIEW_PAGE_TYPES,
+  VIEW_WORKSPACE_API_VERSION,
+  VIEW_WORKSPACE_COOK_MODES,
+  VIEW_WORKSPACE_CORE_OPERATIONS,
+  VIEW_WORKSPACE_DOMAIN_OPERATIONS,
+  VIEW_WORKSPACE_OPERATIONS,
+  VIEW_WORKSPACE_SERVICES,
+  VIEW_WORKSPACE_STATE_TOPIC,
+  VIEW_WORKSPACE_TAB_ID,
+  ViewInspectorClient,
+  ViewInspectorPanel,
+  ViewWorkspaceClient,
+  ViewWorkspaceError,
+  ViewWorkspaceInputController,
+  ViewWorkspaceShell,
+  assertWorkspaceRequest,
+  cloneWorkspaceValue,
+  connectViewFrontend,
+  createBrowserPagePresentation,
+  createInspectorRequest,
+  createViewExtensionTransport,
+  createViewExtensionWorkspaceClient,
+  createViewInspectorToolContributions,
+  createViewSlotRegistry,
+  createViewWorkspaceClient,
+  createWorkspaceRequest,
+  isOpaqueWorkspaceDiagnostic,
+  jsonUnchanged,
+  mountViewViewer,
+  mountViewWorkspace,
+  requireWorkspaceInteger,
+  requireWorkspaceObject,
+  requireWorkspaceString,
+  serializeWorkspaceAsset,
+  serializeWorkspaceDdc,
+  serializeWorkspaceInspection,
+  serializeWorkspaceOpenRequest,
+  serializeWorkspaceProject,
+  serializeWorkspaceResourceOpens,
+  serializeWorkspaceState,
+  serializeWorkspaceTarget,
+  workspaceCapabilities,
+  workspaceError,
+  workspaceInspectionFactRows,
+  workspaceUiFingerprint
+};
+//# sourceMappingURL=browser.mjs.map

package/dist/modules/browser.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/carrier-contract.mjs

@@ -0,0 +1,38 @@
+import {
+  BROWSER_CARRIER,
+  FALLBACK_REASONS,
+  GPU_MODES,
+  VIEW_CARRIER,
+  VIEW_PROTOCOL,
+  VIEW_PROTOCOL_VERSION,
+  assertLeaseTarget,
+  browserFallback,
+  createLeaseRequest,
+  createRunIdentity,
+  deserializeRequest,
+  isFallbackDecision,
+  normalizeRunIdentity,
+  sameRun,
+  serializeTarget,
+  viewDecision
+} from "./chunks/chunk-GQBZMCTK.mjs";
+import "./chunks/chunk-FLGC65SR.mjs";
+export {
+  BROWSER_CARRIER,
+  FALLBACK_REASONS,
+  GPU_MODES,
+  VIEW_CARRIER,
+  VIEW_PROTOCOL,
+  VIEW_PROTOCOL_VERSION,
+  assertLeaseTarget,
+  browserFallback,
+  createLeaseRequest,
+  createRunIdentity,
+  deserializeRequest,
+  isFallbackDecision,
+  normalizeRunIdentity,
+  sameRun,
+  serializeTarget,
+  viewDecision
+};
+//# sourceMappingURL=carrier-contract.mjs.map

package/dist/modules/carrier-contract.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/carrier.mjs

@@ -0,0 +1,13 @@
+import {
+  VIEW_ENGINE_CARRIER_CONTRACT,
+  ViewCarrierAdapter,
+  createViewCarrierAdapter
+} from "./chunks/chunk-CUH2G6UF.mjs";
+import "./chunks/chunk-GQBZMCTK.mjs";
+import "./chunks/chunk-FLGC65SR.mjs";
+export {
+  VIEW_ENGINE_CARRIER_CONTRACT,
+  ViewCarrierAdapter,
+  createViewCarrierAdapter
+};
+//# sourceMappingURL=carrier.mjs.map

package/dist/modules/carrier.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/chunks/chunk-2ASWB6IX.mjs

@@ -0,0 +1,225 @@
+import {
+  connectViewWorkspace
+} from "./chunk-73UZNRHN.mjs";
+import {
+  VIEW_WORKSPACE_OPERATIONS
+} from "./chunk-32GD5LL6.mjs";
+
+// src/cli.mjs
+import { randomUUID } from "node:crypto";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+var HELP = `forgeax-view workspace
+
+Call the View workspace API through the resident Engine Host.
+
+Usage:
+  forgeax-view workspace --operation <operation> [--args <json>] [options]
+  forgeax-view workspace --batch <json-array> [options]
+
+Operations:
+  ${VIEW_WORKSPACE_OPERATIONS.join(", ")}
+
+Connection options:
+  --endpoint <ws-url>   or FORGEAX_VIEW_WORKSPACE_ENDPOINT
+  --token <token>       or FORGEAX_VIEW_WORKSPACE_TOKEN
+  --client-id <id>      or FORGEAX_VIEW_CLIENT_ID (default: unique per process)
+  --follow              keep plugins.watch subscribed until disconnect or abort
+
+The JSON passed to --args is sent unchanged to the Engine-owned API. This
+command does not implement project, asset, scene, or camera behavior locally.
+Use --batch to keep one authenticated client connection for a camera
+begin/update/commit transaction. Inspector watch requires --follow so the
+authenticated subscription remains alive after the watch response.
+`;
+var OPERATIONS = new Set(VIEW_WORKSPACE_OPERATIONS);
+function valueAfter(argv, index, flag) {
+  const value = argv[index + 1];
+  if (value === void 0 || value.startsWith("--")) {
+    throw new Error(`${flag} requires a value`);
+  }
+  return value;
+}
+function parseArgs(argv, env = process.env) {
+  let endpoint = env.FORGEAX_VIEW_WORKSPACE_ENDPOINT;
+  let token = env.FORGEAX_VIEW_WORKSPACE_TOKEN;
+  let clientId = env.FORGEAX_VIEW_CLIENT_ID;
+  let operation;
+  let input = "{}";
+  let inputSeen = false;
+  let batchInput;
+  let follow = false;
+  for (let index = 0; index < argv.length; index += 1) {
+    const flag = argv[index];
+    if (flag === "--help" || flag === "-h") return { help: true };
+    if (flag === "--endpoint") {
+      endpoint = valueAfter(argv, index, flag);
+      index += 1;
+    } else if (flag === "--token") {
+      token = valueAfter(argv, index, flag);
+      index += 1;
+    } else if (flag === "--client-id") {
+      clientId = valueAfter(argv, index, flag);
+      index += 1;
+    } else if (flag === "--operation") {
+      operation = valueAfter(argv, index, flag);
+      index += 1;
+    } else if (flag === "--args") {
+      input = valueAfter(argv, index, flag);
+      inputSeen = true;
+      index += 1;
+    } else if (flag === "--batch") {
+      batchInput = valueAfter(argv, index, flag);
+      index += 1;
+    } else if (flag === "--follow") {
+      follow = true;
+    } else if (flag === "workspace" || flag === "call") {
+    } else if (operation === void 0 && !flag.startsWith("--")) {
+      operation = flag;
+    } else {
+      throw new Error(`unknown argument ${flag}`);
+    }
+  }
+  if (batchInput !== void 0 && (operation !== void 0 || inputSeen))
+    throw new Error("--operation/--args cannot be combined with --batch");
+  if (operation === void 0 && batchInput === void 0) throw new Error("workspace operation is required");
+  if (follow && (batchInput !== void 0 || operation !== "plugins.watch")) {
+    throw new Error("--follow is only supported for plugins.watch");
+  }
+  if (typeof endpoint !== "string" || endpoint.trim() === "") {
+    throw new Error("View workspace endpoint is required (--endpoint or FORGEAX_VIEW_WORKSPACE_ENDPOINT)");
+  }
+  if (typeof token !== "string" || token.trim() === "") {
+    throw new Error("View workspace token is required (--token or FORGEAX_VIEW_WORKSPACE_TOKEN)");
+  }
+  const parseObject = (raw, flag) => {
+    let value;
+    try {
+      value = JSON.parse(raw);
+    } catch {
+      throw new Error(`${flag} must be valid JSON`);
+    }
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+      throw new Error(`${flag} must be a JSON object`);
+    }
+    return value;
+  };
+  const parseOperation = (candidate) => {
+    if (typeof candidate !== "string" || !OPERATIONS.has(candidate)) {
+      throw new Error(`unsupported workspace operation ${candidate}`);
+    }
+    return candidate;
+  };
+  if (operation === "plugins.watch" && !follow && batchInput === void 0) {
+    throw new Error("plugins.watch requires --follow to keep the subscription alive");
+  }
+  const client = clientId ?? `forgeax-cli-${randomUUID()}`;
+  if (batchInput !== void 0) {
+    let batch;
+    try {
+      batch = JSON.parse(batchInput);
+    } catch {
+      throw new Error("--batch must be valid JSON");
+    }
+    if (!Array.isArray(batch) || batch.length === 0) throw new Error("--batch must be a non-empty JSON array");
+    const calls = batch.map((entry, index) => {
+      if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
+        throw new Error(`--batch item ${index} must be an object`);
+      }
+      return {
+        operation: parseOperation(entry.operation),
+        args: entry.args === void 0 ? {} : parseObject(JSON.stringify(entry.args), `--batch item ${index}.args`)
+      };
+    });
+    return { endpoint, token, clientId: client, batch: calls };
+  }
+  return {
+    endpoint,
+    token,
+    clientId: client,
+    operation: parseOperation(operation),
+    args: parseObject(input, "--args"),
+    follow
+  };
+}
+function resultError(error) {
+  return {
+    ok: false,
+    error: {
+      code: typeof error?.code === "string" ? error.code : "view-cli-failed",
+      ...typeof error?.expected === "string" ? { expected: error.expected } : {},
+      hint: typeof error?.hint === "string" ? error.hint : error?.message ?? String(error),
+      ...error?.detail === void 0 ? {} : { detail: error.detail }
+    }
+  };
+}
+async function runViewWorkspaceCli(argv, { connect = connectViewWorkspace, signal } = {}) {
+  let options;
+  try {
+    options = parseArgs(argv);
+    if (options.help) return { exitCode: 0, value: HELP };
+    const client = await connect({
+      endpoint: options.endpoint,
+      token: options.token,
+      clientId: options.clientId
+    });
+    try {
+      let value;
+      if (options.batch === void 0) {
+        value = await client.call(options.operation, options.args, { signal });
+      } else {
+        value = [];
+        for (const call of options.batch)
+          value.push(await client.call(call.operation, call.args, { signal }));
+      }
+      if (options.follow) {
+        const events = [];
+        const unsubscribe = client.subscribeInspector?.((event) => events.push(event));
+        await new Promise((resolve) => {
+          if (signal?.aborted) {
+            resolve();
+            return;
+          }
+          const onAbort = () => {
+            signal?.removeEventListener("abort", onAbort);
+            removeDisconnect?.();
+            resolve();
+          };
+          const removeDisconnect = client.onDisconnect?.(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+          });
+          signal?.addEventListener("abort", onAbort, { once: true });
+        });
+        unsubscribe?.();
+        return { exitCode: 0, value: { ok: true, value, events } };
+      }
+      return { exitCode: 0, value: { ok: true, value } };
+    } finally {
+      client.close?.("view CLI request complete");
+    }
+  } catch (error) {
+    return { exitCode: 1, value: resultError(error) };
+  }
+}
+function isDirectInvocation() {
+  if (process.argv[1] === void 0) return false;
+  const modulePath = fileURLToPath(import.meta.url);
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(modulePath);
+  } catch {
+    return process.argv[1] === modulePath;
+  }
+}
+if (isDirectInvocation()) {
+  const result = await runViewWorkspaceCli(process.argv.slice(2));
+  if (typeof result.value === "string") process.stdout.write(result.value);
+  else process.stdout.write(`${JSON.stringify(result.value, null, result.value?.ok ? 0 : 2)}
+`);
+  process.exitCode = result.exitCode;
+}
+
+export {
+  runViewWorkspaceCli
+};
+//# sourceMappingURL=chunk-2ASWB6IX.mjs.map

package/dist/modules/chunks/chunk-2ASWB6IX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli.mjs"],
+  "sourcesContent": ["#!/usr/bin/env node\n\nimport { randomUUID } from 'node:crypto';\nimport { realpathSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\n\nimport { connectViewWorkspace } from '@forgeax/view-workspace-core/resident';\nimport { VIEW_WORKSPACE_OPERATIONS } from '@forgeax/view-workspace-core/contract';\n\nconst HELP = `forgeax-view workspace\n\nCall the View workspace API through the resident Engine Host.\n\nUsage:\n  forgeax-view workspace --operation <operation> [--args <json>] [options]\n  forgeax-view workspace --batch <json-array> [options]\n\nOperations:\n  ${VIEW_WORKSPACE_OPERATIONS.join(', ')}\n\nConnection options:\n  --endpoint <ws-url>   or FORGEAX_VIEW_WORKSPACE_ENDPOINT\n  --token <token>       or FORGEAX_VIEW_WORKSPACE_TOKEN\n  --client-id <id>      or FORGEAX_VIEW_CLIENT_ID (default: unique per process)\n  --follow              keep plugins.watch subscribed until disconnect or abort\n\nThe JSON passed to --args is sent unchanged to the Engine-owned API. This\ncommand does not implement project, asset, scene, or camera behavior locally.\nUse --batch to keep one authenticated client connection for a camera\nbegin/update/commit transaction. Inspector watch requires --follow so the\nauthenticated subscription remains alive after the watch response.\n`;\n\nconst OPERATIONS = new Set(VIEW_WORKSPACE_OPERATIONS);\n\nfunction valueAfter(argv, index, flag) {\n  const value = argv[index + 1];\n  if (value === undefined || value.startsWith('--')) {\n    throw new Error(`${flag} requires a value`);\n  }\n  return value;\n}\n\nfunction parseArgs(argv, env = process.env) {\n  let endpoint = env.FORGEAX_VIEW_WORKSPACE_ENDPOINT;\n  let token = env.FORGEAX_VIEW_WORKSPACE_TOKEN;\n  let clientId = env.FORGEAX_VIEW_CLIENT_ID;\n  let operation;\n  let input = '{}';\n  let inputSeen = false;\n  let batchInput;\n  let follow = false;\n  for (let index = 0; index < argv.length; index += 1) {\n    const flag = argv[index];\n    if (flag === '--help' || flag === '-h') return { help: true };\n    if (flag === '--endpoint') {\n      endpoint = valueAfter(argv, index, flag);\n      index += 1;\n    } else if (flag === '--token') {\n      token = valueAfter(argv, index, flag);\n      index += 1;\n    } else if (flag === '--client-id') {\n      clientId = valueAfter(argv, index, flag);\n      index += 1;\n    } else if (flag === '--operation') {\n      operation = valueAfter(argv, index, flag);\n      index += 1;\n    } else if (flag === '--args') {\n      input = valueAfter(argv, index, flag);\n      inputSeen = true;\n      index += 1;\n    } else if (flag === '--batch') {\n      batchInput = valueAfter(argv, index, flag);\n      index += 1;\n    } else if (flag === '--follow') {\n      follow = true;\n    } else if (flag === 'workspace' || flag === 'call') {\n      // Keep the command prefix explicit but allow the operation to be the\n      // first positional for a short shell form.\n    } else if (operation === undefined && !flag.startsWith('--')) {\n      operation = flag;\n    } else {\n      throw new Error(`unknown argument ${flag}`);\n    }\n  }\n  if (batchInput !== undefined && (operation !== undefined || inputSeen))\n    throw new Error('--operation/--args cannot be combined with --batch');\n  if (operation === undefined && batchInput === undefined) throw new Error('workspace operation is required');\n  if (follow && (batchInput !== undefined || operation !== 'plugins.watch')) {\n    throw new Error('--follow is only supported for plugins.watch');\n  }\n  if (typeof endpoint !== 'string' || endpoint.trim() === '') {\n    throw new Error('View workspace endpoint is required (--endpoint or FORGEAX_VIEW_WORKSPACE_ENDPOINT)');\n  }\n  if (typeof token !== 'string' || token.trim() === '') {\n    throw new Error('View workspace token is required (--token or FORGEAX_VIEW_WORKSPACE_TOKEN)');\n  }\n  const parseObject = (raw, flag) => {\n    let value;\n    try {\n      value = JSON.parse(raw);\n    } catch {\n      throw new Error(`${flag} must be valid JSON`);\n    }\n    if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n      throw new Error(`${flag} must be a JSON object`);\n    }\n    return value;\n  };\n  const parseOperation = (candidate) => {\n    if (typeof candidate !== 'string' || !OPERATIONS.has(candidate)) {\n      throw new Error(`unsupported workspace operation ${candidate}`);\n    }\n    return candidate;\n  };\n  if (operation === 'plugins.watch' && !follow && batchInput === undefined) {\n    throw new Error('plugins.watch requires --follow to keep the subscription alive');\n  }\n  const client = clientId ?? `forgeax-cli-${randomUUID()}`;\n  if (batchInput !== undefined) {\n    let batch;\n    try {\n      batch = JSON.parse(batchInput);\n    } catch {\n      throw new Error('--batch must be valid JSON');\n    }\n    if (!Array.isArray(batch) || batch.length === 0) throw new Error('--batch must be a non-empty JSON array');\n    const calls = batch.map((entry, index) => {\n      if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {\n        throw new Error(`--batch item ${index} must be an object`);\n      }\n      return {\n        operation: parseOperation(entry.operation),\n        args: entry.args === undefined ? {} : parseObject(JSON.stringify(entry.args), `--batch item ${index}.args`),\n      };\n    });\n    return { endpoint, token, clientId: client, batch: calls };\n  }\n  return {\n    endpoint,\n    token,\n    clientId: client,\n    operation: parseOperation(operation),\n    args: parseObject(input, '--args'),\n    follow,\n  };\n}\n\nfunction resultError(error) {\n  return {\n    ok: false,\n    error: {\n      code: typeof error?.code === 'string' ? error.code : 'view-cli-failed',\n      ...(typeof error?.expected === 'string' ? { expected: error.expected } : {}),\n      hint: typeof error?.hint === 'string' ? error.hint : error?.message ?? String(error),\n      ...(error?.detail === undefined ? {} : { detail: error.detail }),\n    },\n  };\n}\n\n/** Execute one thin CLI request; all domain semantics stay in View/Engine API. */\nexport async function runViewWorkspaceCli(argv, { connect = connectViewWorkspace, signal } = {}) {\n  let options;\n  try {\n    options = parseArgs(argv);\n    if (options.help) return { exitCode: 0, value: HELP };\n    const client = await connect({\n      endpoint: options.endpoint,\n      token: options.token,\n      clientId: options.clientId,\n    });\n    try {\n      let value;\n      if (options.batch === undefined) {\n        value = await client.call(options.operation, options.args, { signal });\n      } else {\n        value = [];\n        for (const call of options.batch)\n          value.push(await client.call(call.operation, call.args, { signal }));\n      }\n      if (options.follow) {\n        const events = [];\n        const unsubscribe = client.subscribeInspector?.((event) => events.push(event));\n        await new Promise((resolve) => {\n          if (signal?.aborted) {\n            resolve();\n            return;\n          }\n          const onAbort = () => {\n            signal?.removeEventListener('abort', onAbort);\n            removeDisconnect?.();\n            resolve();\n          };\n          const removeDisconnect = client.onDisconnect?.(() => {\n            signal?.removeEventListener('abort', onAbort);\n            resolve();\n          });\n          signal?.addEventListener('abort', onAbort, { once: true });\n        });\n        unsubscribe?.();\n        return { exitCode: 0, value: { ok: true, value, events } };\n      }\n      return { exitCode: 0, value: { ok: true, value } };\n    } finally {\n      client.close?.('view CLI request complete');\n    }\n  } catch (error) {\n    return { exitCode: 1, value: resultError(error) };\n  }\n}\n\nfunction isDirectInvocation() {\n  if (process.argv[1] === undefined) return false;\n  const modulePath = fileURLToPath(import.meta.url);\n  try {\n    return realpathSync(process.argv[1]) === realpathSync(modulePath);\n  } catch {\n    return process.argv[1] === modulePath;\n  }\n}\n\nif (isDirectInvocation()) {\n  const result = await runViewWorkspaceCli(process.argv.slice(2));\n  if (typeof result.value === 'string') process.stdout.write(result.value);\n  else process.stdout.write(`${JSON.stringify(result.value, null, result.value?.ok ? 0 : 2)}\\n`);\n  process.exitCode = result.exitCode;\n}\n"],
+  "mappings": "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",
+  "names": []
+}