refactor(workhub): clarify renderer decision seams

apps/desktop/renderer-architecture.json

@@ -4533,6 +4533,7 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
+          "./application/contracts/workhub.js": 1,
           "./workhub-route-policy.js": 1
         }
       },
@@ -4566,8 +4567,8 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
+          "./application/contracts/workhub.js": 1,
           "./desktop-transcript-range-store.js": 1,
-          "./workhub-controller.js": 1,
           "@maka/core/session": 1
         }
       },
@@ -4579,7 +4580,8 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
-          "./application/contracts/workhub-request-intent.js": 1
+          "./application/contracts/workhub-action-intent.js": 1,
+          "./application/contracts/workhub-session-resolver.js": 1
         }
       },
       "src/renderer/workhub-send-lease.ts": {
@@ -4607,8 +4609,8 @@
         "actionFactories": [],
         "dependencyPaths": {
           "../shared/runtime-host-identity.js": 1,
+          "./application/contracts/workhub.js": 1,
           "./desktop-transcript-range-store.js": 1,
-          "./workhub-controller.js": 1,
           "@maka/core/session": 1
         }
       },
@@ -4624,7 +4626,7 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
-          "./workhub-coordination-port.js": 1,
+          "./application/contracts/workhub.js": 1,
           "./workhub-send-lease.js": 1,
           "@astryxdesign/core": 1,
           "@astryxdesign/core/Button": 1,

apps/desktop/src/main/__tests__/workhub-controller.test.ts

@@ -21,18 +21,18 @@ import assert from 'node:assert/strict';
 import { existsSync, readFileSync } from 'node:fs';
 import test from 'node:test';
 import type { WorkHubCoordinationActInput } from '@maka/runtime-host/protocol';
+import { createWorkHubController as createGatedWorkHubController } from '../../renderer/workhub-controller.js';
 import {
-  createWorkHubController as createGatedWorkHubController,
   WORKHUB_ROUTING_STRATEGY_ID,
+  WorkHubCoordinationFailure,
+  type WorkHubCoordinationTurn,
   type WorkHubSessionFacts,
   type WorkHubSessionPort,
-  type WorkHubCoordinationTurn,
-} from '../../renderer/workhub-controller.js';
+} from '../../renderer/application/contracts/workhub.js';
 import {
   createWorkHubRoutePolicy,
   workHubNewSessionName,
 } from '../../renderer/workhub-route-policy.js';
-import { WorkHubCoordinationFailure } from '../../renderer/workhub-coordination-port.js';
 
 const appShellUrl = [
   new URL('../../renderer/app-shell.tsx', import.meta.url),

apps/desktop/src/main/__tests__/workhub-session-resolver-port.test.ts

@@ -22,7 +22,7 @@ import test from 'node:test';
 import type {
   WorkHubSessionResolution,
   WorkHubSessionResolver,
-} from '../../renderer/application/contracts/workhub-request-intent.js';
+} from '../../renderer/application/contracts/workhub-session-resolver.js';
 import { createWorkHubRoutePolicy } from '../../renderer/workhub-route-policy.js';
 
 const routable = (sessionId: string, sessionName: string) => ({

apps/desktop/src/main/__tests__/workhub-surface-flow.test.ts

@@ -35,14 +35,14 @@ import {
   workHubSurfaceFailure,
   workHubSubmissionClearsDraft,
 } from '../../renderer/workhub-surface.js';
+import { createWorkHubController } from '../../renderer/workhub-controller.js';
 import {
-  createWorkHubController,
   WORKHUB_ROUTING_STRATEGY_ID,
   type WorkHubController,
   type WorkHubCoordinationTurn,
   type WorkHubDelegationExecutionState,
   type WorkHubSubmitInput,
-} from '../../renderer/workhub-controller.js';
+} from '../../renderer/application/contracts/workhub.js';
 import { WorkHubSendLease } from '../../renderer/workhub-send-lease.js';
 import {
   createDesktopWorkHubSessionPort,

apps/desktop/src/renderer/application/contracts/workhub-action-intent.ts

@@ -0,0 +1,25 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/** Renderer seam for the shared, pure WorkHub Action Intent module. */
+export {
+  readWorkHubRequestIntent,
+  workHubCorrectionAdmitsReference,
+} from '@maka/core/workhub-creation-intent';
+export type { WorkHubRequestIntent } from '@maka/core/workhub-creation-intent';

apps/desktop/src/renderer/application/contracts/workhub-request-intent.ts → apps/desktop/src/renderer/application/contracts/workhub-session-resolver.ts

@@ -17,11 +17,7 @@
  * under the License.
  */
 
-export {
-  readWorkHubRequestIntent,
-  workHubCorrectionAdmitsReference,
-} from '@maka/core/workhub-creation-intent';
-export type { WorkHubRequestIntent } from '@maka/core/workhub-creation-intent';
+/** Renderer seam for recalling existing Sessions without choosing an action. */
 export { createExactNameSessionResolver } from '@maka/core/workhub-session-resolver';
 export type {
   WorkHubResolverSession,