@forgeax/view 0.5.0-dev.13604.c415409c3b9d → 0.5.0-dev.13713.d28c4863d779

package/README.md

@@ -276,10 +276,51 @@ loop and retains the World, tools and renderer; explicit hidden capture still
 uses that same App. Revealing the page restores layout and rendering. Independent
 game and Play execution keep their own lifetimes and are not paused by View.
 
-The Content Browser presents the Engine catalog; selection inspects read-only
-asset metadata and double-click opens the exact Engine preview. Assets from
+The Content Browser joins the Engine catalog with Pack's bounded source index.
+`summary.get` is the bounded workspace query for external status readers:
+it exposes project identity, phase, browser generation, revision and at most 16
+target identities, with a `hasMoreTargets` flag. It does not serialize catalog
+assets, resource opens or page selection. The full `tabs.get` snapshot remains
+the View UI state contract.
+`pages.list` separately returns at most 16 connected page IDs with their bounded
+workspace summaries. `pack.reveal` is a public workspace operation: the same
+project/source revision and optional page ID can be submitted through the API,
+`forgeax view workspace call`, or another client adapter. Its result is a
+visible-page receipt or an explicit non-action failure; no adapter owns reveal.
+Zero-output and malformed Pack sources remain file cards with diagnostics, and
+one-output Packs retain their source parent. Activating a Pack only expands it;
+selecting a specific output opens the existing Engine preview route. Assets from
 `.pack.ts` show their Catalog `sourceKey` when present; GUIDs remain their
-operation identity. Hierarchy and Inspector use the optional live target tools
+operation identity. A page-scoped Pack reveal checks project/source revision,
+targets one authenticated frontend connection, and accepts `shown` only after
+the Editor, Content Browser Dock panel and Pack card are visible. Workspace
+selection/open requests and Display run binding belong to that frontend
+connection; disconnect retires its projection and pending reveal.
+Reveal temporarily admits only the addressed Pack through the current filters.
+Search and filter preferences stay intact; manual navigation cancels the focus.
+Request cancellation and timeout retire the pending receipt and notify the exact
+frontend to stop remaining asynchronous navigation. A late visible acknowledgment
+cannot complete a cancelled request; an old cancellation cannot cancel a newer reveal.
+The entry URL uses `view-frontend`; after a project opens, the full View shell
+uses the exact `forgeax-workspace:<sessionId>:<targetId>` caller of the current
+headed project target. Both are page sessions, while other Engine target callers
+cannot claim the View page. Each fresh entry document opens its own Engine
+session from the confirmed project intent; it does not copy another document's
+headed target URL. Each target still owns one accepted browser caller. Refresh
+retains that target and replaces only its browser generation. View selection,
+resource opens and Display bindings belong to the exact frontend connection.
+The Pack receipt rechecks the source revision and project at acknowledgment.
+
+> [!NOTE]
+> A page-less CLI client can still use page operations such as `tabs.get`,
+> `scene.select`, and `asset.open` when exactly one View frontend is connected;
+> the Broker directs those calls to that page's session. With multiple pages,
+> these operations return `view-page-ambiguous` before changing page or Engine
+> state. `summary.get` and Engine project facts remain shared reads.
+> Use `pages.list` to choose an exact page, then `pack.reveal` to direct a
+> revision-bound Pack navigation. Both operations have CLI entry points.
+
+Hierarchy and Inspector use the optional live target tools
 plugin, reporting capability errors when absent. `dev:ui` starts a private
 fixture Host and serves the same Viewer code path as `dev`. Its catalog and
 scene responses arrive through the Host workspace API. Use
@@ -700,11 +741,14 @@ const api = await connectViewWorkspace({
 const tabId = 'forgeax-user-workspace';
 const state = await api.openProject(projectRoot, { tabId });
 const projectId = state.project.id;
-const { assets } = await api.listAssets(projectId, { tabId });
+const targetId = state.projectTarget.targetId;
+const targetGeneration = state.projectTarget.generation;
+const target = { projectId, tabId, targetId, targetGeneration };
+const { assets } = await api.listAssets(projectId, target);
 const scene = assets.find((asset) => asset.kind === 'scene');
 if (scene) {
-  await api.inspectAsset(scene.guid, { projectId, tabId });
-  await api.openAsset(scene.guid, { projectId, tabId });
+  await api.inspectAsset(scene.guid, target);
+  await api.openAsset(scene.guid, target);
 }
 ```
 
@@ -714,8 +758,8 @@ Authored-asset operations are projections of Engine CLI / ScriptablePack / ToolC
 |:--|:--|:--|
 | `assets.list` | DevKit `assetList({ root })` / existing `listAssets` → `PackEntry[]` | session catalog snapshot, including optional `sourceKey` |
 | `asset.inspect` | DevKit `assetInspect({ root, subject })` plus ScriptablePack `inspect(sourcePath)` / gateway `inspect-meta` | session inspection of PackEntry + `ScriptablePackMetaJson` |
-| `asset-source.rebuild` | ScriptablePack `rebuild(sourcePath, 'rebuild')` / gateway `rebuild` / ToolClient `asset-source.rebuild` | forwarding + CAS `expectedRevision` |
-| `asset-source.cold-cook` | ScriptablePack `rebuild(sourcePath, 'cold-cook')` / gateway `cold-cook` / ToolClient `asset-source.cold-cook` | forwarding + CAS `expectedRevision` |
+| `asset.source.rebuild` | ScriptablePack `rebuild(sourcePath, 'rebuild')` / gateway `rebuild` / ToolClient `asset.source.rebuild` | forwarding + CAS `expectedRevision` |
+| `asset.source.cold-cook` | ScriptablePack `rebuild(sourcePath, 'cold-cook')` / gateway `cold-cook` / ToolClient `asset.source.cold-cook` | forwarding + CAS `expectedRevision` |
 
 Codex edits `pack.ts` through the workspace files. The browser shell places the `sourcePath`-grouped Engine catalog and exact viewport on the left, and a **read-only** Engine meta inspector on the right (`packageId`, `importer`, `subAssets`, `cookReceiptUrl`). `Rebuild` / `Cold-cook` only forward Engine cook. Selecting an already-previewed GUID inspects again and does not open a second preview surface. Missing Engine methods fail closed with `view-engine-capability-unavailable`. Engine revision conflicts surface as `pack-source-revision-conflict`.
 
@@ -748,7 +792,7 @@ const workspaceEngine = {
   assetInspect: (input) => assetInspectCommand({ root: input.root, subject: input.subject }),
   openPreview,
   pack: scriptablePackAuthoringPort, // inspect / preflight / rebuild
-  tools: toolClient,                 // ToolClient.run('asset-source.rebuild' | 'asset-source.cold-cook')
+  tools: toolClient,                 // ToolClient.run('asset.source.rebuild' | 'asset.source.cold-cook')
 };
 const view = await startView({ platform, workspaceEngine });
 ```
@@ -833,3 +877,17 @@ metadata alone is not sufficient build identity.
 
 The required project dialog is modeless: Scene still requires a confirmed project,
 while artifact pages and workspace navigation remain available before opening one.
+
+## Public operation naming
+
+Resource segments and actions retain the same order across API, CLI and MCP.
+The View ToolApi ID `view.workspace.pack.reveal` is the CLI path
+`forgeax view workspace pack reveal`; its relative workspace API operation is
+`pack.reveal`. Read workspace facts with `summary.get` /
+`forgeax view workspace summary get`. The authenticated backend CLI accepts
+`--input` containing the ordinary operation arguments and uses the same owner
+authorization. Frontend requests retain the versioned workspace envelope.
+Engine-owned source operations use `asset.source.rebuild` and
+`asset.source.cold-cook`; scene-tree queries use `scene.tree.get`.
+CLI contribution metadata uses the actual operation ID without a second
+`forgeax.` prefix or duplicate inspector namespace.

package/dist/build-revision.json

@@ -1 +1 @@
-{"codeRevision":"1803fe06a4440233ec0495ef340afc9f8b0e350ce211dd66b15412f48dfecad1","viewerDigest":"20561802de9394166c9b84b8d6909d09e6c4940e20735f0f12f854374a228d9a"}
+{"codeRevision":"d9f8f160baa8c79a98e292a9cfeb82afd6b984ce9994c42ebf2e4e7ce2c72a91","viewerDigest":"c2a8f0d729c9c6f35f59548d9432fc158b5424e24db7d2be69e2a07b103af02b"}

package/dist/modules/backend.mjs

@@ -2,45 +2,45 @@ import {
   createViewBackend,
   createViewHostBinding,
   createViewPlatformBinding
-} from "./chunks/chunk-LZ57Y73Z.mjs";
-import "./chunks/chunk-XQYF2P6M.mjs";
-import "./chunks/chunk-YLCJNKIW.mjs";
+} from "./chunks/chunk-VSJOW7J4.mjs";
+import "./chunks/chunk-5HVXQEO3.mjs";
+import "./chunks/chunk-I32EONBF.mjs";
 import "./chunks/chunk-GQANC3HH.mjs";
 import "./chunks/chunk-YY4G5LVX.mjs";
-import "./chunks/chunk-6KM24NH6.mjs";
-import "./chunks/chunk-27XASYEH.mjs";
-import "./chunks/chunk-HWZCLROY.mjs";
-import "./chunks/chunk-55F55BQY.mjs";
-import "./chunks/chunk-U5J7OTEB.mjs";
-import "./chunks/chunk-IJPWKKIU.mjs";
-import "./chunks/chunk-D25SR5FS.mjs";
-import "./chunks/chunk-AGVLPYVE.mjs";
-import "./chunks/chunk-7IGFAI5H.mjs";
-import "./chunks/chunk-OKQ5RBKO.mjs";
-import "./chunks/chunk-EZSGDSCC.mjs";
-import "./chunks/chunk-EWSCJF77.mjs";
-import "./chunks/chunk-X4NNZ5X6.mjs";
-import "./chunks/chunk-FMCHH5R4.mjs";
-import "./chunks/chunk-STQPRNEO.mjs";
-import "./chunks/chunk-PZIAKZJC.mjs";
-import "./chunks/chunk-QUFVUMSY.mjs";
-import "./chunks/chunk-HRKW766Y.mjs";
-import "./chunks/chunk-KX2WU5Z6.mjs";
-import "./chunks/chunk-B6QUJ33G.mjs";
-import "./chunks/chunk-PJFFCRRD.mjs";
+import "./chunks/chunk-3Y5WN22T.mjs";
+import "./chunks/chunk-YU3HRQX7.mjs";
+import "./chunks/chunk-CN6YN4HP.mjs";
+import "./chunks/chunk-JVOHFCI4.mjs";
+import "./chunks/chunk-FSSARTVM.mjs";
+import "./chunks/chunk-CYOLEAAY.mjs";
+import "./chunks/chunk-N2SH3JGI.mjs";
+import "./chunks/chunk-D2LZIQE2.mjs";
+import "./chunks/chunk-O5QX6H3U.mjs";
+import "./chunks/chunk-LVWHM3UN.mjs";
+import "./chunks/chunk-ZRE7BDDB.mjs";
+import "./chunks/chunk-2CMCY54A.mjs";
+import "./chunks/chunk-C2AMOM7H.mjs";
+import "./chunks/chunk-4FYKRL46.mjs";
+import "./chunks/chunk-MLXRIWJA.mjs";
+import "./chunks/chunk-B24VYGHV.mjs";
+import "./chunks/chunk-AUINYWZP.mjs";
+import "./chunks/chunk-6WZZ7TIC.mjs";
+import "./chunks/chunk-KPLESRQY.mjs";
+import "./chunks/chunk-CXFQME65.mjs";
+import "./chunks/chunk-YDARD4EP.mjs";
 import "./chunks/chunk-IM3H4F4X.mjs";
-import "./chunks/chunk-K2QZRFLE.mjs";
-import "./chunks/chunk-H256DQT6.mjs";
+import "./chunks/chunk-KJTMDFFX.mjs";
+import "./chunks/chunk-TMPTVIAP.mjs";
 import "./chunks/chunk-QW3ZY2AD.mjs";
-import "./chunks/chunk-FNRGLCZW.mjs";
-import "./chunks/chunk-5YTMN435.mjs";
-import "./chunks/chunk-ZIDEETK4.mjs";
-import "./chunks/chunk-KAGFU64Y.mjs";
-import "./chunks/chunk-U5R6MVM4.mjs";
+import "./chunks/chunk-PCQNUFDL.mjs";
+import "./chunks/chunk-DC5JP46Y.mjs";
+import "./chunks/chunk-E4G4HDOC.mjs";
+import "./chunks/chunk-QW2VT3XB.mjs";
+import "./chunks/chunk-RFTLGEB5.mjs";
 import "./chunks/chunk-J5B4LX5H.mjs";
-import "./chunks/chunk-P5XMFZY4.mjs";
-import "./chunks/chunk-TXLD7JI5.mjs";
-import "./chunks/chunk-E3Z7GLFU.mjs";
+import "./chunks/chunk-SFB5BDTB.mjs";
+import "./chunks/chunk-WJNASQF2.mjs";
+import "./chunks/chunk-QJHQN6OD.mjs";
 import "./chunks/chunk-4XEXLHX4.mjs";
 import "./chunks/chunk-QAXALJEY.mjs";
 import "./chunks/chunk-JU5PV2T2.mjs";

package/dist/modules/browser.mjs

@@ -6,41 +6,41 @@ import {
   VIEW_EXTENSION_ID,
   createViewExtensionTransport,
   createViewExtensionWorkspaceClient
-} from "./chunks/chunk-M6S5YA6X.mjs";
+} from "./chunks/chunk-2RUKPDIE.mjs";
 import {
   connectViewFrontend,
   mountViewViewer,
   mountViewWorkspace
-} from "./chunks/chunk-D2RCKG7Q.mjs";
-import "./chunks/chunk-XMP4THLF.mjs";
-import "./chunks/chunk-RJVOH7G2.mjs";
-import "./chunks/chunk-E3PJGTLI.mjs";
-import "./chunks/chunk-YNHEYXDG.mjs";
-import "./chunks/chunk-U64FRQKP.mjs";
-import "./chunks/chunk-U6UMATPV.mjs";
-import "./chunks/chunk-YFQGSDK3.mjs";
-import "./chunks/chunk-ZHO2G4JR.mjs";
-import "./chunks/chunk-CX5WREJC.mjs";
-import "./chunks/chunk-TTRUYO7Q.mjs";
-import "./chunks/chunk-F5RLQAPN.mjs";
+} from "./chunks/chunk-G2QCXN56.mjs";
+import "./chunks/chunk-66LM6NO6.mjs";
+import "./chunks/chunk-VKWEA6NG.mjs";
+import "./chunks/chunk-IGIELQZ2.mjs";
+import "./chunks/chunk-DOU4MNMQ.mjs";
+import "./chunks/chunk-7MWZK7HS.mjs";
+import "./chunks/chunk-CYU3WWN6.mjs";
+import "./chunks/chunk-45WL24XN.mjs";
+import "./chunks/chunk-EZAJ66NW.mjs";
+import "./chunks/chunk-SPGFO2TA.mjs";
+import "./chunks/chunk-UZH2664E.mjs";
+import "./chunks/chunk-A7OGXJAV.mjs";
 import {
   ViewWorkspaceInputController,
   ViewWorkspaceShell,
   createBrowserPagePresentation
-} from "./chunks/chunk-4T3D67CS.mjs";
-import "./chunks/chunk-4D3Q7K44.mjs";
-import "./chunks/chunk-PVP5YBNR.mjs";
+} from "./chunks/chunk-GRDCA6LD.mjs";
+import "./chunks/chunk-SNICHQJP.mjs";
+import "./chunks/chunk-WFM434WJ.mjs";
 import {
   createViewSlotRegistry
 } from "./chunks/chunk-GQOXQ4AV.mjs";
-import "./chunks/chunk-INTTYJVW.mjs";
+import "./chunks/chunk-LBQ6DFMP.mjs";
 import "./chunks/chunk-Q2NO32WU.mjs";
-import "./chunks/chunk-OQXDADAS.mjs";
-import "./chunks/chunk-IJPWKKIU.mjs";
-import "./chunks/chunk-D25SR5FS.mjs";
+import "./chunks/chunk-UWJYROKS.mjs";
+import "./chunks/chunk-CYOLEAAY.mjs";
+import "./chunks/chunk-N2SH3JGI.mjs";
 import {
   DISPLAY_SURFACE_ID
-} from "./chunks/chunk-AGVLPYVE.mjs";
+} from "./chunks/chunk-D2LZIQE2.mjs";
 import {
   VIEW_INSPECTOR_API_VERSION,
   VIEW_INSPECTOR_OPERATIONS,
@@ -50,41 +50,44 @@ import {
   ViewInspectorPanel,
   createInspectorRequest,
   createViewInspectorToolContributions
-} from "./chunks/chunk-7IGFAI5H.mjs";
-import "./chunks/chunk-OKQ5RBKO.mjs";
-import "./chunks/chunk-EZSGDSCC.mjs";
-import "./chunks/chunk-EWSCJF77.mjs";
-import "./chunks/chunk-X4NNZ5X6.mjs";
-import "./chunks/chunk-FMCHH5R4.mjs";
-import "./chunks/chunk-STQPRNEO.mjs";
-import "./chunks/chunk-PZIAKZJC.mjs";
-import "./chunks/chunk-QUFVUMSY.mjs";
-import "./chunks/chunk-HRKW766Y.mjs";
-import "./chunks/chunk-KX2WU5Z6.mjs";
-import "./chunks/chunk-B6QUJ33G.mjs";
-import "./chunks/chunk-PJFFCRRD.mjs";
+} from "./chunks/chunk-O5QX6H3U.mjs";
+import "./chunks/chunk-LVWHM3UN.mjs";
+import "./chunks/chunk-ZRE7BDDB.mjs";
+import "./chunks/chunk-2CMCY54A.mjs";
+import "./chunks/chunk-C2AMOM7H.mjs";
+import "./chunks/chunk-4FYKRL46.mjs";
+import "./chunks/chunk-MLXRIWJA.mjs";
+import "./chunks/chunk-B24VYGHV.mjs";
+import "./chunks/chunk-AUINYWZP.mjs";
+import "./chunks/chunk-6WZZ7TIC.mjs";
+import "./chunks/chunk-KPLESRQY.mjs";
+import "./chunks/chunk-CXFQME65.mjs";
+import "./chunks/chunk-YDARD4EP.mjs";
 import "./chunks/chunk-IM3H4F4X.mjs";
-import "./chunks/chunk-K2QZRFLE.mjs";
-import "./chunks/chunk-H256DQT6.mjs";
+import "./chunks/chunk-KJTMDFFX.mjs";
+import "./chunks/chunk-TMPTVIAP.mjs";
 import "./chunks/chunk-QW3ZY2AD.mjs";
 import {
   ViewWorkspaceClient,
   createViewWorkspaceClient
-} from "./chunks/chunk-FNRGLCZW.mjs";
-import "./chunks/chunk-5YTMN435.mjs";
-import "./chunks/chunk-ZIDEETK4.mjs";
-import "./chunks/chunk-KAGFU64Y.mjs";
-import "./chunks/chunk-U5R6MVM4.mjs";
-import "./chunks/chunk-APD2EWSZ.mjs";
-import "./chunks/chunk-357UOBAS.mjs";
+} from "./chunks/chunk-PCQNUFDL.mjs";
+import "./chunks/chunk-DC5JP46Y.mjs";
+import "./chunks/chunk-E4G4HDOC.mjs";
+import "./chunks/chunk-QW2VT3XB.mjs";
+import "./chunks/chunk-RFTLGEB5.mjs";
+import "./chunks/chunk-FIWL6TQS.mjs";
+import "./chunks/chunk-XUNDH3E7.mjs";
 import "./chunks/chunk-J5B4LX5H.mjs";
-import "./chunks/chunk-WVU3CQ62.mjs";
-import "./chunks/chunk-CKYXAT7H.mjs";
-import "./chunks/chunk-P5XMFZY4.mjs";
-import "./chunks/chunk-TXLD7JI5.mjs";
+import "./chunks/chunk-GUVUL6D2.mjs";
+import "./chunks/chunk-VC4OEPDH.mjs";
+import "./chunks/chunk-SFB5BDTB.mjs";
+import "./chunks/chunk-WJNASQF2.mjs";
 import {
   VIEW_DISPLAY_TAB_ID,
   VIEW_FILE_GET_SERVICE,
+  VIEW_PACK_REVEAL_ACK_SERVICE,
+  VIEW_PACK_REVEAL_TOPIC,
+  VIEW_PACK_SOURCES_SERVICE,
   VIEW_PAGE_TYPES,
   VIEW_WORKSPACE_API_VERSION,
   VIEW_WORKSPACE_COOK_MODES,
@@ -115,9 +118,9 @@ import {
   workspaceError,
   workspaceInspectionFactRows,
   workspaceUiFingerprint
-} from "./chunks/chunk-E3Z7GLFU.mjs";
+} from "./chunks/chunk-QJHQN6OD.mjs";
 import "./chunks/chunk-4XEXLHX4.mjs";
-import "./chunks/chunk-ZGOGO7SS.mjs";
+import "./chunks/chunk-6J27SWMY.mjs";
 import "./chunks/chunk-QAXALJEY.mjs";
 import "./chunks/chunk-FLGC65SR.mjs";
 export {
@@ -131,6 +134,9 @@ export {
   VIEW_INSPECTOR_SERVICES,
   VIEW_INSPECTOR_TOPIC,
   VIEW_LAYOUT_HOST_ID,
+  VIEW_PACK_REVEAL_ACK_SERVICE,
+  VIEW_PACK_REVEAL_TOPIC,
+  VIEW_PACK_SOURCES_SERVICE,
   VIEW_PAGE_TYPES,
   VIEW_WORKSPACE_API_VERSION,
   VIEW_WORKSPACE_COOK_MODES,

package/dist/modules/chunks/{chunk-EWSCJF77.mjs → chunk-2CMCY54A.mjs}

@@ -1,6 +1,6 @@
 import {
   VIEW_PAGE_TYPES
-} from "./chunk-E3Z7GLFU.mjs";
+} from "./chunk-QJHQN6OD.mjs";
 import {
   __export
 } from "./chunk-FLGC65SR.mjs";
@@ -44,4 +44,4 @@ export {
   TITLE_I18N_KEY,
   identity_exports
 };
-//# sourceMappingURL=chunk-EWSCJF77.mjs.map
+//# sourceMappingURL=chunk-2CMCY54A.mjs.map

package/dist/modules/chunks/{chunk-M6S5YA6X.mjs → chunk-2RUKPDIE.mjs}

@@ -1,13 +1,13 @@
 import {
   createViewWorkspaceClient
-} from "./chunk-FNRGLCZW.mjs";
+} from "./chunk-PCQNUFDL.mjs";
 import {
   VIEW_FILE_GET_SERVICE,
   VIEW_WORKSPACE_DOMAIN_OPERATIONS,
   VIEW_WORKSPACE_SERVICES,
   requireWorkspaceString,
   workspaceError
-} from "./chunk-E3Z7GLFU.mjs";
+} from "./chunk-QJHQN6OD.mjs";
 
 // packages/view-workspace-core/src/extension-bridge.ts
 var VIEW_EXTENSION_ID = "@forgeax-extension/view";
@@ -16,7 +16,7 @@ var VIEW_EXTENSION_CAPABILITIES = Object.freeze({
   author: "view.workspace.author",
   inspect: "view.plugins.read"
 });
-var AUTHORING_OPERATIONS = /* @__PURE__ */ new Set(["asset-source.rebuild", "asset-source.cold-cook"]);
+var AUTHORING_OPERATIONS = /* @__PURE__ */ new Set(["asset.source.rebuild", "asset.source.cold-cook"]);
 var WORKSPACE_OPERATIONS = new Set(VIEW_WORKSPACE_DOMAIN_OPERATIONS);
 function requiredCapability(service, request) {
   const operation = request && typeof request === "object" && "operation" in request ? request.operation : void 0;
@@ -90,4 +90,4 @@ export {
   createViewExtensionTransport,
   createViewExtensionWorkspaceClient
 };
-//# sourceMappingURL=chunk-M6S5YA6X.mjs.map
+//# sourceMappingURL=chunk-2RUKPDIE.mjs.map

package/dist/modules/chunks/{chunk-M6S5YA6X.mjs.map → chunk-2RUKPDIE.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../packages/view-workspace-core/src/extension-bridge.ts"],
-  "sourcesContent": ["import type { HostRequestOptions } from '@forgeax/engine-host/transport';\nimport type { WorkspaceRequest } from './contract.ts';\nexport type ViewExtensionInvoke = (input: { extensionId: string; capability: string; service: string; request: unknown; signal?: AbortSignal; generation?: number }) => unknown | Promise<unknown>;\nexport type ViewExtensionOptions = { invoke: ViewExtensionInvoke; extensionId?: string; capabilities?: readonly string[] };\nimport { VIEW_FILE_GET_SERVICE, VIEW_WORKSPACE_SERVICES, VIEW_WORKSPACE_DOMAIN_OPERATIONS, workspaceError, requireWorkspaceString } from './contract.ts';\nimport { createViewWorkspaceClient } from './client.ts';\n\nexport const VIEW_EXTENSION_ID = '@forgeax-extension/view';\nexport const VIEW_EXTENSION_CAPABILITIES = Object.freeze({\n  read: 'view.workspace.read',\n  author: 'view.workspace.author',\n  inspect: 'view.plugins.read',\n});\n\nconst AUTHORING_OPERATIONS = new Set(['asset-source.rebuild', 'asset-source.cold-cook']);\nconst WORKSPACE_OPERATIONS = new Set(VIEW_WORKSPACE_DOMAIN_OPERATIONS);\n\nfunction requiredCapability(service: string, request: unknown) {\n  const operation = request && typeof request === 'object' && 'operation' in request ? request.operation : undefined;\n  if (service === VIEW_WORKSPACE_SERVICES.call) {\n    if (typeof operation !== 'string' || !WORKSPACE_OPERATIONS.has(operation)) {\n      throw workspaceError(\n        'view-extension-operation-unknown',\n        'operation to be declared by the View workspace contract',\n        'Refresh the View extension capability descriptor.',\n        { operation },\n      );\n    }\n    return AUTHORING_OPERATIONS.has(operation)\n      ? VIEW_EXTENSION_CAPABILITIES.author\n      : VIEW_EXTENSION_CAPABILITIES.read;\n  }\n  if (service === VIEW_WORKSPACE_SERVICES.capabilities) return VIEW_EXTENSION_CAPABILITIES.read;\n  if (service === VIEW_FILE_GET_SERVICE) return VIEW_EXTENSION_CAPABILITIES.read;\n  throw workspaceError(\n    'view-extension-service-unknown',\n    'service to be declared by the View extension contract',\n    'Use the typed View workspace client rather than a raw Host service name.',\n    { service },\n  );\n}\n\n/**\n * Browser-side adapter for an Editor-issued, session-bound View capability.\n * The host authenticates the iframe; this transport never receives or forwards\n * the resident Host endpoint or its bearer token.\n */\nexport function createViewExtensionTransport({\n  invoke,\n  extensionId = VIEW_EXTENSION_ID,\n  capabilities = [],\n}: Partial<ViewExtensionOptions> = {}) {\n  if (typeof invoke !== 'function') {\n    throw new TypeError('View extension transport requires a host capability invoke function');\n  }\n  if (extensionId !== VIEW_EXTENSION_ID) {\n    throw new TypeError(`View extension transport only admits ${VIEW_EXTENSION_ID}`);\n  }\n  const granted = new Set(capabilities);\n  return Object.freeze({\n    request<TPayload, TResult>(service: string, request: TPayload, options: HostRequestOptions = {}): Promise<TResult> {\n      const capability = requiredCapability(service, request);\n      if (!granted.has(capability)) {\n        return Promise.reject(workspaceError(\n          'view-extension-capability-denied',\n          `the ${capability} capability to be granted`,\n          'Install or re-authorize the View extension with the required permission.',\n          { extensionId, capability, service, operation: (request as Partial<WorkspaceRequest> | undefined)?.operation },\n        ));\n      }\n      const { signal, generation } = options;\n      return Promise.resolve(invoke({\n        extensionId,\n        capability,\n        service,\n        request,\n        ...(signal === undefined ? {} : { signal }),\n        ...(generation === undefined ? {} : { generation }),\n      })) as Promise<TResult>;\n    },\n    close() {},\n  });\n}\n\nexport function createViewExtensionWorkspaceClient({ invoke, capabilities, clientId }: Partial<ViewExtensionOptions> & { clientId?: string } = {}) {\n  return createViewWorkspaceClient({\n    transport: createViewExtensionTransport({ invoke, capabilities }),\n    clientId: requireWorkspaceString(clientId, 'clientId'),\n  });\n}\n"],
+  "sourcesContent": ["import type { HostRequestOptions } from '@forgeax/engine-host/transport';\nimport type { WorkspaceRequest } from './contract.ts';\nexport type ViewExtensionInvoke = (input: { extensionId: string; capability: string; service: string; request: unknown; signal?: AbortSignal; generation?: number }) => unknown | Promise<unknown>;\nexport type ViewExtensionOptions = { invoke: ViewExtensionInvoke; extensionId?: string; capabilities?: readonly string[] };\nimport { VIEW_FILE_GET_SERVICE, VIEW_WORKSPACE_SERVICES, VIEW_WORKSPACE_DOMAIN_OPERATIONS, workspaceError, requireWorkspaceString } from './contract.ts';\nimport { createViewWorkspaceClient } from './client.ts';\n\nexport const VIEW_EXTENSION_ID = '@forgeax-extension/view';\nexport const VIEW_EXTENSION_CAPABILITIES = Object.freeze({\n  read: 'view.workspace.read',\n  author: 'view.workspace.author',\n  inspect: 'view.plugins.read',\n});\n\nconst AUTHORING_OPERATIONS = new Set(['asset.source.rebuild', 'asset.source.cold-cook']);\nconst WORKSPACE_OPERATIONS = new Set(VIEW_WORKSPACE_DOMAIN_OPERATIONS);\n\nfunction requiredCapability(service: string, request: unknown) {\n  const operation = request && typeof request === 'object' && 'operation' in request ? request.operation : undefined;\n  if (service === VIEW_WORKSPACE_SERVICES.call) {\n    if (typeof operation !== 'string' || !WORKSPACE_OPERATIONS.has(operation)) {\n      throw workspaceError(\n        'view-extension-operation-unknown',\n        'operation to be declared by the View workspace contract',\n        'Refresh the View extension capability descriptor.',\n        { operation },\n      );\n    }\n    return AUTHORING_OPERATIONS.has(operation)\n      ? VIEW_EXTENSION_CAPABILITIES.author\n      : VIEW_EXTENSION_CAPABILITIES.read;\n  }\n  if (service === VIEW_WORKSPACE_SERVICES.capabilities) return VIEW_EXTENSION_CAPABILITIES.read;\n  if (service === VIEW_FILE_GET_SERVICE) return VIEW_EXTENSION_CAPABILITIES.read;\n  throw workspaceError(\n    'view-extension-service-unknown',\n    'service to be declared by the View extension contract',\n    'Use the typed View workspace client rather than a raw Host service name.',\n    { service },\n  );\n}\n\n/**\n * Browser-side adapter for an Editor-issued, session-bound View capability.\n * The host authenticates the iframe; this transport never receives or forwards\n * the resident Host endpoint or its bearer token.\n */\nexport function createViewExtensionTransport({\n  invoke,\n  extensionId = VIEW_EXTENSION_ID,\n  capabilities = [],\n}: Partial<ViewExtensionOptions> = {}) {\n  if (typeof invoke !== 'function') {\n    throw new TypeError('View extension transport requires a host capability invoke function');\n  }\n  if (extensionId !== VIEW_EXTENSION_ID) {\n    throw new TypeError(`View extension transport only admits ${VIEW_EXTENSION_ID}`);\n  }\n  const granted = new Set(capabilities);\n  return Object.freeze({\n    request<TPayload, TResult>(service: string, request: TPayload, options: HostRequestOptions = {}): Promise<TResult> {\n      const capability = requiredCapability(service, request);\n      if (!granted.has(capability)) {\n        return Promise.reject(workspaceError(\n          'view-extension-capability-denied',\n          `the ${capability} capability to be granted`,\n          'Install or re-authorize the View extension with the required permission.',\n          { extensionId, capability, service, operation: (request as Partial<WorkspaceRequest> | undefined)?.operation },\n        ));\n      }\n      const { signal, generation } = options;\n      return Promise.resolve(invoke({\n        extensionId,\n        capability,\n        service,\n        request,\n        ...(signal === undefined ? {} : { signal }),\n        ...(generation === undefined ? {} : { generation }),\n      })) as Promise<TResult>;\n    },\n    close() {},\n  });\n}\n\nexport function createViewExtensionWorkspaceClient({ invoke, capabilities, clientId }: Partial<ViewExtensionOptions> & { clientId?: string } = {}) {\n  return createViewWorkspaceClient({\n    transport: createViewExtensionTransport({ invoke, capabilities }),\n    clientId: requireWorkspaceString(clientId, 'clientId'),\n  });\n}\n"],
   "mappings": ";;;;;;;;;;;;AAOO,IAAM,oBAAoB;AAC1B,IAAM,8BAA8B,OAAO,OAAO;AAAA,EACvD,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,SAAS;AACX,CAAC;AAED,IAAM,uBAAuB,oBAAI,IAAI,CAAC,wBAAwB,wBAAwB,CAAC;AACvF,IAAM,uBAAuB,IAAI,IAAI,gCAAgC;AAErE,SAAS,mBAAmB,SAAiB,SAAkB;AAC7D,QAAM,YAAY,WAAW,OAAO,YAAY,YAAY,eAAe,UAAU,QAAQ,YAAY;AACzG,MAAI,YAAY,wBAAwB,MAAM;AAC5C,QAAI,OAAO,cAAc,YAAY,CAAC,qBAAqB,IAAI,SAAS,GAAG;AACzE,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA,EAAE,UAAU;AAAA,MACd;AAAA,IACF;AACA,WAAO,qBAAqB,IAAI,SAAS,IACrC,4BAA4B,SAC5B,4BAA4B;AAAA,EAClC;AACA,MAAI,YAAY,wBAAwB,aAAc,QAAO,4BAA4B;AACzF,MAAI,YAAY,sBAAuB,QAAO,4BAA4B;AAC1E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,QAAQ;AAAA,EACZ;AACF;AAOO,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA,cAAc;AAAA,EACd,eAAe,CAAC;AAClB,IAAmC,CAAC,GAAG;AACrC,MAAI,OAAO,WAAW,YAAY;AAChC,UAAM,IAAI,UAAU,qEAAqE;AAAA,EAC3F;AACA,MAAI,gBAAgB,mBAAmB;AACrC,UAAM,IAAI,UAAU,wCAAwC,iBAAiB,EAAE;AAAA,EACjF;AACA,QAAM,UAAU,IAAI,IAAI,YAAY;AACpC,SAAO,OAAO,OAAO;AAAA,IACnB,QAA2B,SAAiB,SAAmB,UAA8B,CAAC,GAAqB;AACjH,YAAM,aAAa,mBAAmB,SAAS,OAAO;AACtD,UAAI,CAAC,QAAQ,IAAI,UAAU,GAAG;AAC5B,eAAO,QAAQ,OAAO;AAAA,UACpB;AAAA,UACA,OAAO,UAAU;AAAA,UACjB;AAAA,UACA,EAAE,aAAa,YAAY,SAAS,WAAY,SAAmD,UAAU;AAAA,QAC/G,CAAC;AAAA,MACH;AACA,YAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,aAAO,QAAQ,QAAQ,OAAO;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,GAAI,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO;AAAA,QACzC,GAAI,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW;AAAA,MACnD,CAAC,CAAC;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IAAC;AAAA,EACX,CAAC;AACH;AAEO,SAAS,mCAAmC,EAAE,QAAQ,cAAc,SAAS,IAA2D,CAAC,GAAG;AACjJ,SAAO,0BAA0B;AAAA,IAC/B,WAAW,6BAA6B,EAAE,QAAQ,aAAa,CAAC;AAAA,IAChE,UAAU,uBAAuB,UAAU,UAAU;AAAA,EACvD,CAAC;AACH;",
   "names": []
 }

package/dist/modules/chunks/{chunk-DWT3TA6M.mjs → chunk-3FBX3P3H.mjs}

@@ -4,13 +4,13 @@ import {
 import {
   openViewProject,
   viewProjectOpenError
-} from "./chunk-XE6ITXHT.mjs";
+} from "./chunk-QB33CMEU.mjs";
 import {
   VIEW_PRODUCT_BACKEND_CATALOG
-} from "./chunk-XQYF2P6M.mjs";
+} from "./chunk-5HVXQEO3.mjs";
 import {
   startViewHostServer
-} from "./chunk-U5J7OTEB.mjs";
+} from "./chunk-FSSARTVM.mjs";
 import {
   resolveProjectIntent,
   withProjectIntent
@@ -19,10 +19,10 @@ import {
   VIEW_FRONTEND_MODULE,
   createViewProductPlan,
   viewFrontendRoot
-} from "./chunk-IJPWKKIU.mjs";
+} from "./chunk-CYOLEAAY.mjs";
 import {
   workspaceDiagnosticRecord
-} from "./chunk-U5R6MVM4.mjs";
+} from "./chunk-RFTLGEB5.mjs";
 
 // src/plugins/product.ts
 import { randomUUID } from "node:crypto";
@@ -32,6 +32,7 @@ import { existsSync } from "node:fs";
 import { createHostAssembly } from "@forgeax/engine/host/protocol";
 import { defineTool, toolJsonSchema } from "@forgeax/engine/tool-runtime";
 import { registerTools, startNativePlugin } from "@forgeax/engine/plugin";
+import { listPackSources } from "@forgeax/engine/pack/build";
 var ownerArgs = toolJsonSchema({ type: "object", properties: { root: { type: "string" } }, additionalProperties: false });
 var startArgs = toolJsonSchema({ type: "object", properties: {
   root: { type: "string" },
@@ -148,7 +149,7 @@ var product_default = {
       };
       const plan = createViewProductPlan({
         disabledPages: config.disabledPages,
-        backendConfig: { workspaceAccessToken: token },
+        backendConfig: { workspaceAccessToken: token, packSources: listPackSources },
         frontendConfig
       });
       const installation = {
@@ -174,7 +175,7 @@ var product_default = {
               staticRoot: config.staticRoot ?? builtRoot,
               frontendConfig,
               ...core === void 0 ? {} : {
-                onClientConnect: () => core.resetPageSession(),
+                onClientConnect: (caller) => core.attachPageSession(caller, host.transport),
                 onClientDisconnect: (caller) => core.revokeConnection(caller.connectionId)
               }
             });
@@ -283,4 +284,4 @@ var product_default = {
 export {
   product_default
 };
-//# sourceMappingURL=chunk-DWT3TA6M.mjs.map
+//# sourceMappingURL=chunk-3FBX3P3H.mjs.map

package/dist/modules/chunks/chunk-3FBX3P3H.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/product.ts"],
+  "sourcesContent": ["import type { Context, Fiber } from '@forgeax/engine-plugin';\nimport type {} from '@forgeax/engine/devkit';\nimport type { HostRootDescriptor } from '@forgeax/engine-host/protocol';\nimport type { ToolJsonSchema, ToolSchema } from '@forgeax/engine-tool-runtime';\nimport type { ViewWorkspaceBroker } from '@forgeax/view-workspace-core/broker';\nimport type { ViewFrontendConfig } from '@forgeax/view-viewer/config';\nimport { workspaceDiagnosticRecord } from '@forgeax/view-workspace-core/command-error';\nexport type ViewProductConfig = { disabledPages?: readonly string[]; staticRoot?: string; frontendConfig?: Pick<ViewFrontendConfig, 'layout'>; frontend?: { root?: Partial<HostRootDescriptor>; module?: string } };\ntype LifecycleArgs = { root?: string; project?: string; frontendConfig?: Pick<ViewFrontendConfig, 'layout'> };\nimport { randomUUID } from 'node:crypto';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport { createHostAssembly } from '@forgeax/engine-host/protocol';\nimport { defineTool, toolJsonSchema } from '@forgeax/engine-tool-runtime';\nimport { registerTools, startNativePlugin } from '@forgeax/engine-plugin';\nimport { createViewProductPlan, viewFrontendRoot, VIEW_FRONTEND_MODULE } from '@forgeax/view-viewer/catalog/shared';\nimport { listPackSources } from '@forgeax/engine-pack/build';\nimport { VIEW_PRODUCT_BACKEND_CATALOG } from '@forgeax/view-viewer/catalog/backend';\nimport { startViewHostServer } from '@forgeax/view-workspace-core/resident';\n\nimport { openViewProject, viewProjectOpenError } from '../view-project-open.ts';\nimport { resolveProjectIntent, withProjectIntent } from '../view-start.ts';\nimport { viewStartFrontendConfigSchema } from '../commands.ts';\n\nconst ownerArgs = toolJsonSchema({ type: 'object', properties: { root: { type: 'string' } }, additionalProperties: false });\nconst startArgs = toolJsonSchema({ type: 'object', properties: {\n  root: { type: 'string' }, project: { type: 'string' },\n  frontendConfig: viewStartFrontendConfigSchema,\n}, additionalProperties: false });\nconst projectOpenSchema = {\n  type: 'object',\n  properties: { root: { type: 'string' }, project: { type: 'string' } },\n  required: ['project'],\n  additionalProperties: false,\n} satisfies ToolJsonSchema;\n\nfunction readWorkspaceCore(owner?: Context) {\n  if (!owner || typeof owner.get !== 'function') return undefined;\n  try {\n    const value = owner.get('viewWorkspaceCore', false);\n    return value && typeof value.openProject === 'function' && typeof value.snapshot === 'function' ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction installedViewStaticRoot(projectRoot: string) {\n  try {\n    const pluginEntry = createRequire(join(projectRoot, 'forge.json')).resolve('@forgeax/view/plugin');\n    const staticRoot = resolve(dirname(pluginEntry), '../viewer');\n    return existsSync(join(staticRoot, 'index.html')) ? staticRoot : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction projectFailure(error: unknown) {\n  const record = workspaceDiagnosticRecord(error);\n  const hint = typeof record.hint === 'string' ? record.hint : typeof record.message === 'string' ? record.message : String(error);\n  return {\n    ok: false,\n    error: {\n      code: typeof record.code === 'string' ? record.code : 'view-project-open-failed',\n      expected: typeof record.expected === 'string' ? record.expected : hint,\n      hint,\n      ...(record.detail === undefined ? {} : { detail: record.detail }),\n    },\n  };\n}\n\nfunction projectSuccess(body: Awaited<ReturnType<typeof openViewProject>>) {\n  return {\n    ok: true,\n    value: {\n      ok: true,\n      alreadyOpen: body.alreadyOpen === true,\n      ...(body.viewerUrl === undefined ? {} : { viewerUrl: body.viewerUrl }),\n      project: body.project,\n      projectTarget: body.projectTarget,\n    },\n  };\n}\n\n/** Installed on Engine's resident Host. View owns only its plugin Fibers and sockets. */\nexport default {\n  name: 'forgeax.view',\n  inject: ['devkitBackend', 'engineWorkspace', 'toolApi'],\n  async apply(ctx: Context, config: ViewProductConfig = {}) {\n    const { host } = ctx.devkitBackend;\n    let fiber: Fiber | undefined;\n    let server: Awaited<ReturnType<typeof startViewHostServer>> | undefined;\n    let serverEffect: ReturnType<Context['effect']> | undefined;\n    let failure: ReturnType<typeof failed> | undefined;\n    const failed = (error: unknown) => {\n      const record = workspaceDiagnosticRecord(error);\n      return ({\n      code: typeof record.code === 'string' ? record.code : 'view-cleanup-failed',\n      expected: typeof record.expected === 'string' ? record.expected : 'View-owned contributions to finish cleanup',\n      hint: typeof record.hint === 'string' ? record.hint : typeof record.message === 'string' ? record.message : String(error),\n      cleanup: workspaceDiagnosticRecord(record.detail).cleanup ?? 'failed',\n    }); };\n    let workspaceCore: ViewWorkspaceBroker | undefined;\n    let openAbort: AbortController | undefined;\n    let sessionEpoch = 0;\n    let queue: Promise<unknown> = Promise.resolve();\n    const enqueue = <T>(execute: () => T | Promise<T>) => {\n      const result = queue.then(execute);\n      queue = result.catch(() => {});\n      return result;\n    };\n    const status = () => failure ? { phase: 'failed', error: failure } : ({ phase: server ? 'ready' : 'stopped', ...(server ? { url: server.viewerUrl } : {}) });\n    const stop = async () => {\n      if (failure) throw new Error(`${failure.code}: ${failure.hint}`);\n      sessionEpoch += 1;\n      openAbort?.abort();\n      openAbort = undefined;\n      workspaceCore = undefined;\n      try { await serverEffect?.(); await server?.close(); await fiber?.dispose(); }\n      catch (error) { failure = failed(error); throw error; }\n      fiber = undefined;\n      server = undefined;\n      return status();\n    };\n    const start = async (args: LifecycleArgs = {}) => {\n      if (failure) throw new Error(`${failure.code}: ${failure.hint}`);\n      const project = resolveProjectIntent(args.project === undefined ? [] : ['--project', args.project], ctx.devkitBackend.root);\n      if (fiber) return withProjectIntent(status(), project);\n      const token = randomUUID();\n      const workspaceClient = { clientId: 'view-frontend', token, resourceBrowser: true };\n      const layout = args.frontendConfig?.layout ?? config.frontendConfig?.layout;\n      const frontendConfig: ViewFrontendConfig = {\n        embedded: true,\n        workspace: workspaceClient,\n        ...(layout === undefined ? {} : { layout }),\n      };\n      const plan = createViewProductPlan({\n        disabledPages: config.disabledPages,\n        backendConfig: { workspaceAccessToken: token, packSources: listPackSources },\n        frontendConfig,\n      });\n      const installation = {\n        name: 'forgeax.view.product',\n        provide: ['devkitWorkspaceFrontend'],\n        async apply(owner: Context) {\n          for (const component of plan.backend) {\n            const record = VIEW_PRODUCT_BACKEND_CATALOG.get(component.module);\n            if (!record) throw new Error(`View backend program is missing: ${component.module}`);\n            const module = await record.load();\n            await (await owner.plugin(module.default, component.config)).await();\n          }\n          const builtRoot = config.staticRoot ? undefined : installedViewStaticRoot(\n            ctx.devkitBackend.hostPackageRoot ?? ctx.devkitBackend.root,\n          );\n          if (!config.staticRoot && !builtRoot) throw new Error('View UI is not built. Build or install the View package before starting it.');\n          // The launcher is the parent fiber. Cordis get walks ancestors, so the\n          // broker provided by this installation is read here and kept for the tool.\n          workspaceCore = readWorkspaceCore(owner);\n          const core = workspaceCore;\n          serverEffect = owner.effect(async () => {\n            const ownedServer = await startViewHostServer({\n            backendHost: host,\n            accessToken: token,\n            staticRoot: config.staticRoot ?? builtRoot,\n            frontendConfig,\n            ...(core === undefined ? {} : {\n              onClientConnect: (caller) => core.attachPageSession(caller, host.transport),\n              onClientDisconnect: (caller) => core.revokeConnection(caller.connectionId),\n            }),\n          });\n            server = ownedServer;\n            return () => ownedServer.close();\n          });\n          await serverEffect;\n          Object.assign(workspaceClient, { endpoint: server!.frontendEndpoint, frontendTicket: server!.frontendTicket });\n          const frontendRoot = viewFrontendRoot(frontendConfig, plan.disabledPages);\n          const assembly = createHostAssembly({ root: config.frontend ? { ...frontendRoot, ...config.frontend.root, config: frontendRoot.config } : frontendRoot });\n          owner.provide('devkitWorkspaceFrontend', { assembly, module: config.frontend?.module ?? VIEW_FRONTEND_MODULE });\n          const removeAdmission = host.transport.onClientConnect(caller => {\n            if (caller.kind === 'frontend' && caller.sourceId === 'view-frontend') {\n              host.bindProjection(caller, { assembly });\n            }\n          });\n          owner.effect(() => removeAdmission);\n        },\n      };\n      const started = await startNativePlugin(ctx, installation);\n      if (!started.ok) {\n        workspaceCore = undefined;\n        if (workspaceDiagnosticRecord(started.error.detail).cleanup !== 'completed') failure = failed(started.error);\n        else server = undefined;\n        throw Object.assign(new Error(`${started.error.code}: ${started.error.hint}`), started.error);\n      }\n      fiber = started.value;\n      return withProjectIntent(status(), project);\n    };\n\n    const openProject = async (args: LifecycleArgs = {}, epoch = sessionEpoch) => {\n      const stopped = () => projectFailure(viewProjectOpenError(\n        'view-not-started',\n        'View has stopped. Run forgeax view start again when needed.',\n      ));\n      if (epoch !== sessionEpoch || !server || !workspaceCore) {\n        return projectFailure(viewProjectOpenError(\n          'view-not-started',\n          epoch !== sessionEpoch\n            ? 'View has stopped. Run forgeax view start again when needed.'\n            : 'Run forgeax backend start, then forgeax view start.',\n        ));\n      }\n      const project = typeof args.project === 'string' ? args.project : '';\n      const controller = new AbortController();\n      openAbort = controller;\n      try {\n        if (epoch !== sessionEpoch || controller.signal.aborted) return stopped();\n        const body = await openViewProject(workspaceCore, project, {\n          signal: controller.signal,\n          viewerUrl: server.viewerUrl,\n        });\n        if (epoch !== sessionEpoch || controller.signal.aborted) return stopped();\n        return projectSuccess(body);\n      } catch (error) {\n        if (epoch !== sessionEpoch || controller.signal.aborted) return stopped();\n        return projectFailure(error);\n      } finally {\n        if (openAbort === controller) openAbort = undefined;\n      }\n    };\n    const lifecycleTool = (operation: string, execute: (args: LifecycleArgs) => unknown, { before, argsSchema = ownerArgs }: { before?: () => void; argsSchema?: ToolSchema<unknown> } = {}) => defineTool<unknown, unknown>({\n      id: `view.${operation}`, path: ['view', operation], title: `View ${operation}`,\n      summary: `${operation} the optional View interface on the existing Engine backend.`, realm: 'host',\n      argsSchema, resultSchema: toolJsonSchema({ type: 'object' }), inputSchema: { type: 'object' }, outputSchema: { type: 'object' }, evidence: [],\n    }, (args) => {\n      before?.();\n      return enqueue(() => execute(args as LifecycleArgs));\n    });\n    const tools = [\n      lifecycleTool('start', start, { argsSchema: startArgs }),\n      lifecycleTool('status', status),\n      lifecycleTool('stop', stop, { before: () => { sessionEpoch += 1; openAbort?.abort(); } }),\n      defineTool<unknown, unknown>({\n        id: 'view.project.open',\n        path: ['view', 'project', 'open'],\n        title: 'Open View project',\n        summary: 'Open an editor project on the running View and return its headed document URL.',\n        realm: 'host',\n        argsSchema: toolJsonSchema(projectOpenSchema),\n        resultSchema: toolJsonSchema({ type: 'object' }),\n        inputSchema: projectOpenSchema,\n        outputSchema: { type: 'object' },\n        evidence: [],\n      }, (args) => {\n        const epoch = sessionEpoch;\n        return enqueue(() => openProject(args as LifecycleArgs, epoch));\n      }),\n    ];\n    const revoke = registerTools(ctx, tools, { sourceId: 'view-launcher', module: '@forgeax/view/plugin', realm: 'host' });\n    ctx.effect(() => async () => { await revoke(); await queue; await stop(); });\n  },\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/chunks/{chunk-6KM24NH6.mjs → chunk-3Y5WN22T.mjs}

@@ -44,7 +44,7 @@ function createViewStatusToolContributions(broker, description) {
         outputSchema: { type: "object" },
         evidence: []
       },
-      async () => broker.handshake()
+      async (_args, context) => broker.handshake(context.caller)
     )
   ];
 }
@@ -85,7 +85,7 @@ function createDisplayApiTools(broker) {
       inputSchema: bindingInput,
       outputSchema: { type: "object" },
       evidence: []
-    }, (args) => broker.bind(args))] : []
+    }, (args, context) => broker.bind(args, context.caller))] : []
   ];
 }
 
@@ -94,4 +94,4 @@ export {
   DISPLAY_STATUS_OPERATION_DESCRIPTION,
   createDisplayApiTools
 };
-//# sourceMappingURL=chunk-6KM24NH6.mjs.map
+//# sourceMappingURL=chunk-3Y5WN22T.mjs.map

package/dist/modules/chunks/chunk-3Y5WN22T.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-plugin-display/src/tool-runtime.ts", "../../../packages/view-plugin-display/src/api.ts"],
+  "sourcesContent": ["import type { ToolApi, ToolCallerIdentity, ToolRuntimeError, ToolSchema, ToolDescriptor } from '@forgeax/engine-tool-runtime';\nimport { defineTool } from '@forgeax/engine-tool-runtime';\n\nexport const VIEW_STATUS_OPERATION = 'view.display.status';\n\nfunction toolFailureError(failure: ToolRuntimeError) {\n  const diagnostic =\n    (typeof failure?.hint === 'string' && failure.hint.trim() !== '' ? failure.hint : undefined)\n    ?? (typeof failure?.expected === 'string' && failure.expected.trim() !== '' ? failure.expected : undefined);\n  const detail = failure.detail && typeof failure.detail === 'object' && !Array.isArray(failure.detail) ? failure.detail as Record<string, unknown> : {};\n  return Object.assign(new Error(diagnostic ?? String(failure ?? 'view-status-provider-failed')), { name: 'ViewToolError', code: detail.code ?? detail.remoteCode ?? failure.code, expected: failure.expected, hint: failure.hint ?? diagnostic, detail: failure.detail ?? { failure } });\n}\n\nexport async function runViewToolApi(\n  api: ToolApi,\n  { operation, args = {}, caller, signal, providerId, generation }: { operation: string; args?: unknown; caller?: ToolCallerIdentity; signal?: AbortSignal; providerId?: string; generation?: number },\n) {\n  const run = api.run(operation, args, {\n    sourceId: 'view-backend',\n    providerId,\n    generation,\n    caller,\n    signal,\n  });\n  const terminal = await run.terminal;\n  if (terminal.outcome === 'failed') throw toolFailureError(terminal.failure);\n  return terminal.result;\n}\n\nexport function createViewStatusToolContributions(broker: { handshake: (caller?: ToolCallerIdentity) => object | Promise<object> }, description: Pick<ToolDescriptor, \"id\" | \"path\" | \"title\" | \"summary\">) {\n  const argsSchema: ToolSchema<object> = {\n    parse(value) {\n      return value === undefined || (value !== null && typeof value === 'object' && !Array.isArray(value))\n        ? { ok: true, value: value ?? {} }\n        : { ok: false, error: 'View status arguments must be an object' };\n    },\n    describe: 'JSON object accepted by the read-only View status operation.',\n  };\n  const resultSchema: ToolSchema<object> = {\n    parse(value) {\n      return value !== null && typeof value === 'object' && !Array.isArray(value)\n        ? { ok: true, value }\n        : { ok: false, error: 'View status result must be an object' };\n    },\n    describe: 'JSON object returned by the View status operation.',\n  };\n  return [\n    defineTool<unknown, object>(\n      {\n        id: description.id,\n        path: description.path,\n        title: description.title,\n        summary: description.summary,\n        realm: 'host',\n        argsSchema,\n        resultSchema,\n        inputSchema: { type: 'object' },\n        outputSchema: { type: 'object' },\n        evidence: [],\n      },\n      async (_args, context) => broker.handshake(context.caller),\n    ),\n  ];\n}\n", "import type { ToolCallerIdentity, ToolSchema } from '@forgeax/engine-tool-runtime';\nimport type { DisplayStatusInput } from './status.ts';\nexport type DisplayBindArgs = { root: null; runId?: string } | { root: string; runId: string };\nexport type DisplayService = { handshake: (caller?: ToolCallerIdentity) => object | Promise<object>; bind?: (input: DisplayBindArgs, caller?: ToolCallerIdentity) => DisplayStatusInput };\nimport { createViewStatusToolContributions } from './tool-runtime.ts';\nimport { defineTool, toolJsonSchema } from '@forgeax/engine-tool-runtime';\nexport const DISPLAY_STATUS_OPERATION_DESCRIPTION = Object.freeze({\n  id: 'view.display.status',\n  path: ['view', 'display', 'status'],\n  title: 'View status',\n  summary: 'Read the current View display and workspace status.',\n});\n\nconst bindingInput = {\n  type: 'object',\n  properties: { root: { type: ['string', 'null'] }, runId: { type: 'string', minLength: 1 } },\n  required: ['root'], additionalProperties: false,\n};\nconst bindingArgs: ToolSchema<DisplayBindArgs> = {\n  describe: JSON.stringify(bindingInput),\n  parse(value: unknown) {\n    const input = value as Partial<DisplayBindArgs> | null;\n    const valid = value && typeof value === 'object' && !Array.isArray(value)\n      && Object.keys(value).every(key => key === 'root' || key === 'runId')\n      && (input?.root === null || (typeof input?.root === 'string' && input?.root.trim()\n        && typeof input?.runId === 'string' && input?.runId.trim()));\n    return valid ? { ok: true, value: value as DisplayBindArgs } : { ok: false, error: 'Provide root and exact runId, or null root to disconnect.' };\n  },\n};\n\n/** API (Tool) contributions for the display product plugin. */\nexport function createDisplayApiTools(broker: DisplayService) {\n  return [\n    ...createViewStatusToolContributions(broker, DISPLAY_STATUS_OPERATION_DESCRIPTION),\n    ...(broker.bind ? [defineTool<unknown, unknown>({\n      id: 'view.display.bind', path: ['view', 'display', 'bind'], title: 'Bind observed run',\n      summary: 'Observe one explicit Engine run independently of the Editor project; null root disconnects.',\n      realm: 'host',\n      argsSchema: bindingArgs,\n      resultSchema: toolJsonSchema({ type: 'object' }), inputSchema: bindingInput, outputSchema: { type: 'object' }, evidence: [],\n    }, (args, context) => broker.bind!(args as DisplayBindArgs, context.caller))] : []),\n  ];\n}\n"],
+  "mappings": "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",
+  "names": ["defineTool"]
+}

package/dist/modules/chunks/{chunk-YFQGSDK3.mjs → chunk-45WL24XN.mjs}

@@ -5,7 +5,7 @@ import {
   PANEL_LAYOUT,
   SLOT,
   TITLE_I18N_KEY
-} from "./chunk-STQPRNEO.mjs";
+} from "./chunk-MLXRIWJA.mjs";
 
 // packages/view-plugin-scene-tree/src/frontend.ts
 var VIEW_SCENE_TREE_FRONTEND_PLUGIN_ID = FRONTEND_PLUGIN_ID;
@@ -39,4 +39,4 @@ export {
   viewSceneTreeFrontendPlugin,
   frontend_default
 };
-//# sourceMappingURL=chunk-YFQGSDK3.mjs.map
+//# sourceMappingURL=chunk-45WL24XN.mjs.map

package/dist/modules/chunks/{chunk-FMCHH5R4.mjs → chunk-4FYKRL46.mjs}

@@ -1,10 +1,10 @@
 import {
   RESOURCE_PREVIEW_LAYOUT,
   RESOURCE_PROPERTIES_LAYOUT
-} from "./chunk-KX2WU5Z6.mjs";
+} from "./chunk-KPLESRQY.mjs";
 import {
   VIEW_PAGE_TYPES
-} from "./chunk-E3Z7GLFU.mjs";
+} from "./chunk-QJHQN6OD.mjs";
 import {
   __export
 } from "./chunk-FLGC65SR.mjs";
@@ -74,4 +74,4 @@ export {
   PROPERTIES_TITLE_I18N_KEY,
   identity_exports
 };
-//# sourceMappingURL=chunk-FMCHH5R4.mjs.map
+//# sourceMappingURL=chunk-4FYKRL46.mjs.map