@unson/brainbase-mcp 0.24.1 → 0.26.0

package/dist/meeting-source-reader.d.ts

@@ -123,3 +123,21 @@ export declare function readProviderSummary(input: {
     meetingId: string;
     now?: () => Date;
 }): Promise<MeetingSourceSummaryResult>;
+export type MeetingSourceTranscriptProbe = {
+    status: 'readable';
+    segmentCount: number;
+} | {
+    status: 'unavailable';
+    failure: MeetingSourceFailure;
+};
+/**
+ * Reads only the first transcript page, to check that the connection may read
+ * full transcripts. A Tactiq probe spends one read of the hourly budget.
+ */
+export declare function probeTranscript(input: {
+    provider: MeetingSourceProvider;
+    callTool: MeetingSourceCallTool;
+    meetingId: string;
+    budget?: TactiqTranscriptBudget;
+    now?: () => Date;
+}): Promise<MeetingSourceTranscriptProbe>;

package/dist/meeting-source-reader.js

@@ -111,6 +111,37 @@ export async function readProviderSummary(input) {
         return { status: 'unavailable', failure: await classifyFailure(error, input.provider, input.callTool, 'meeting', now()) };
     }
 }
+/**
+ * Reads only the first transcript page, to check that the connection may read
+ * full transcripts. A Tactiq probe spends one read of the hourly budget.
+ */
+export async function probeTranscript(input) {
+    const now = input.now ?? (() => new Date());
+    if (input.provider === 'tactiq') {
+        const slot = (input.budget ?? createTactiqTranscriptBudget()).tryAcquire(input.meetingId, now());
+        if (!slot.ok) {
+            return {
+                status: 'unavailable',
+                failure: { reason: 'rate_limited', scope: 'connection', message: 'Tactiq transcript read limit reached for this hour', retryAt: slot.retryAt },
+            };
+        }
+    }
+    try {
+        if (input.provider === 'plaud') {
+            const payload = asRecord(await invoke(input.callTool, 'get_transcript', { file_id: input.meetingId, block: 'transaction', limit: 10 }));
+            if (!payload || !Array.isArray(payload.segments))
+                throw new UnexpectedShapeError('Plaud get_transcript returned no segments');
+            return { status: 'readable', segmentCount: payload.segments.length };
+        }
+        const payload = asRecord(await invoke(input.callTool, 'get_transcript', { meetingId: input.meetingId, page: 1 }));
+        if (!payload || !Array.isArray(payload.entries))
+            throw new UnexpectedShapeError('Tactiq get_transcript returned no entries');
+        return { status: 'readable', segmentCount: payload.entries.length };
+    }
+    catch (error) {
+        return { status: 'unavailable', failure: await classifyFailure(error, input.provider, input.callTool, 'meeting', now()) };
+    }
+}
 // ---------------------------------------------------------------------------
 // Plaud
 async function listPlaud(callTool, since, until, utcOffsetMinutes, pageSize) {

package/dist/world-extension.d.ts

@@ -35,7 +35,14 @@ export interface WorldVocabularyConfig {
         readonly label?: string;
         readonly phase?: WorldLifecyclePhase;
     }>>;
+    /** The owner's words for the states of a business's tools (story-world-business-exits-v1 AC-04). */
+    readonly exit_states?: Readonly<Partial<Record<WorldExitState, {
+        readonly label?: string;
+    }>>>;
 }
+declare const EXIT_STATES: readonly ["available", "restricted", "unknown", "unavailable"];
+/** The state a host gives a tool of a business (`businessExits` in the world view). */
+export type WorldExitState = (typeof EXIT_STATES)[number];
 export interface WorldVocabulary {
     readonly kinds: readonly {
         readonly key: string | null;
@@ -54,6 +61,11 @@ export interface WorldVocabulary {
         readonly label: string;
         readonly phase: WorldLifecyclePhase;
     }[];
+    /** The words for the four tool states, the owner's over the defaults, in a fixed order. */
+    readonly exit_states: readonly {
+        readonly key: WorldExitState;
+        readonly label: string;
+    }[];
 }
 export interface WorldEngagement {
     readonly id: string;

package/dist/world-extension.js

@@ -20,6 +20,7 @@ export const WORLD_EXTENSION_ID = 'world';
 export const WORLD_EXTENSION_VERSION = 'world-extension.v1';
 const LIFECYCLE_PHASES = ['active', 'maintenance', 'finished', 'concept'];
 const BUILDING_FORMS = ['tower', 'hall', 'dome', 'office'];
+const EXIT_STATES = ['available', 'restricted', 'unknown', 'unavailable'];
 /** Lifecycle words common to any Graph; a host vocabulary may relabel or add to them. */
 const DEFAULT_STATUSES = Object.freeze({
     active: { label: '進行中', phase: 'active' },
@@ -29,6 +30,13 @@ const DEFAULT_STATUSES = Object.freeze({
     archived: { label: '保管', phase: 'finished' },
     concept: { label: '構想', phase: 'concept' },
 });
+/** The words for the states of a business's tools when the owner gives none. */
+const DEFAULT_EXIT_STATES = Object.freeze({
+    available: '使える',
+    restricted: '権限が必要',
+    unknown: '未確認',
+    unavailable: '読めない',
+});
 const KIND_PALETTE = ['#1261ad', '#b07a1f', '#35684c', '#6b4fa0', '#a8433a', '#2f7d86', '#7a6a2b', '#5b6470'];
 const UNCLASSIFIED_COLOR = '#69746d';
 const HEX_COLOR = /^#[0-9a-f]{6}$/iu;
@@ -197,7 +205,8 @@ export function resolveWorldVocabulary(config, businesses, terms = undefined) {
             phase: entry.phase && LIFECYCLE_PHASES.includes(entry.phase) ? entry.phase : base?.phase ?? 'active',
         });
     }
-    return { kinds, statuses: [...statuses].map(([key, entry]) => ({ key, ...entry })), terms: terms === undefined ? 'none' : terms === null ? 'unavailable' : 'read' };
+    const exitStates = EXIT_STATES.map((key) => ({ key, label: text(config?.exit_states?.[key]?.label) ?? DEFAULT_EXIT_STATES[key] }));
+    return { kinds, statuses: [...statuses].map(([key, entry]) => ({ key, ...entry })), exit_states: exitStates, terms: terms === undefined ? 'none' : terms === null ? 'unavailable' : 'read' };
 }
 /** Reads and checks a vocabulary file; an invalid file is an error, never silently ignored. */
 export async function readWorldVocabulary(path) {
@@ -222,7 +231,19 @@ export async function readWorldVocabulary(path) {
             throw new Error(`world vocabulary status ${key} has an unknown phase`);
         statuses[key] = { ...(text(entry.label) ? { label: text(entry.label) } : {}), ...(entry.phase ? { phase: entry.phase } : {}) };
     }
-    return { kinds, statuses };
+    if (parsed.exit_states === undefined)
+        return { kinds, statuses };
+    if (!isRecord(parsed.exit_states))
+        throw new Error('world vocabulary exit_states must be an object');
+    const exitStates = {};
+    for (const [key, entry] of Object.entries(parsed.exit_states)) {
+        if (!EXIT_STATES.includes(key))
+            throw new Error(`world vocabulary has an unknown exit state ${key}`);
+        if (!isRecord(entry))
+            throw new Error(`world vocabulary exit state ${key} must be an object`);
+        exitStates[key] = text(entry.label) ? { label: text(entry.label) } : {};
+    }
+    return { kinds, statuses, exit_states: exitStates };
 }
 /**
  * The businesses from the same Graph the other screens read (this Mac's Graph).
@@ -347,7 +368,7 @@ export function createWorldExtension(options = {}) {
     return {
         id: WORLD_EXTENSION_ID,
         uiDir: fileURLToPath(new URL('../ui/world/', import.meta.url)),
-        uiFiles: ['world-view.js', 'world-view.css', 'world-canvas-ui.js', 'world-canvas-ui.css', 'world-canvas-notes.js', 'world-vendor.js', 'world-placement.js', 'world-work-rail.js', 'world-district.js', 'world-scenery.js'],
+        uiFiles: ['world-view.js', 'world-view.css', 'world-canvas-ui.js', 'world-canvas-ui.css', 'world-canvas-notes.js', 'world-vendor.js', 'world-placement.js', 'world-work-rail.js', 'world-district.js', 'world-scenery.js', 'world-exits.js'],
         screenEntry: 'world-view.js',
         // P17: the world sits above the home and opens first.
         navPosition: 'first',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.24.1",
+  "version": "0.26.0",
   "description": "Local-first Brainbase judgment OS that lets supported AI agents reuse a user's approved goals, priorities, decisions, and judgment criteria.",
   "type": "module",
   "license": "MIT",
@@ -135,6 +135,10 @@
       "types": "./dist/meeting-minutes-lineage-adapters.d.ts",
       "import": "./dist/meeting-minutes-lineage-adapters.js"
     },
+    "./meeting-source-connection": {
+      "types": "./dist/meeting-source-connection.d.ts",
+      "import": "./dist/meeting-source-connection.js"
+    },
     "./meeting-source-reader": {
       "types": "./dist/meeting-source-reader.d.ts",
       "import": "./dist/meeting-source-reader.js"
@@ -427,5 +431,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "3a1e004ecb50844069ccca0ad19e05b57cb63f9d"
+  "gitHead": "feb040b1ff7395da03e5775429af9b91d8c2c8b9"
 }

package/ui/world/world-canvas-ui.js

@@ -28,7 +28,8 @@ const nodeList = (nodes) => (Array.isArray(nodes) ? nodes : [nodes]).filter((nod
  * @param {() => void} [options.onDismissTask] User dismissed task details.
  *
  * showRail/showTask/setHelp accept actual DOM nodes, preserving their events and
- * all source details. showRail never opens the drawer. showTask does not move
+ * all source details. showRail never opens the drawer; openRail opens it without
+ * moving focus (a picked station opens its city's details). showTask does not move
  * focus unless its optional second argument is { focus: true }.
  * addNote shows a quest only for an explicit nonempty summary; its full text
  * remains in help. No summary is inferred from a long or nonurgent notice.
@@ -451,7 +452,7 @@ export function createWorldCanvasUI({ doc, stage, reducedMotion = false, onReset
   setCities([]);
 
   return {
-    setCities, setCity, setSky, showRail, showTask, closeTask, setTaskAnchor,
+    setCities, setCity, setSky, showRail, openRail, showTask, closeTask, setTaskAnchor,
     setHelp(nodes) { if (!disposed) helpContent.replaceChildren(...nodeList(nodes)); },
     addNote, clearNotes, dismissOverlay,
     dispose() {

package/ui/world/world-district.js

@@ -11,12 +11,19 @@
  *     colours (a review date passed), fog (the work could not be read).
  * People walking the streets and chimney smoke are the town's atmosphere: they come from no record,
  * never enter a lot, and the legend says so.  Nothing here writes.
+ *
+ * When the host gives the tools a business uses (story-world-business-exits-v1), each stands as a
+ * station in a yard outside the gate: lit when usable, its wicket closed when a permission is needed,
+ * in fog when its state is unconfirmed or could not be read.  A station's sign carries the count its
+ * tool asks attention for.  Picking a station selects its row in the city details; it never leaves
+ * the world.
  */
 
 import { THREE, MapControls } from './world-vendor.js';
 import { DISTRICT_STREETS, districtGroundPlan, districtStage, districtStreetLots, skyAt } from './world-placement.js';
 import { canvasTexture, drawFacade, FACADE_SIZES, FACADE_UNITS, gableRoof, hashUnit, paintVertices, roundedPlate, valueNoise } from './world-scenery.js';
 import { makeWorkspaceElement as el } from '../../workspace-kit.js';
+import { attentionSignText } from './world-exits.js';
 
 export const WORLD_DISTRICT_CONTRACT_VERSION = 'brainbase.world-district.v0';
 
@@ -76,14 +83,24 @@ export function projectDistrictSelection({ taskId = null, anchor, camera, viewpo
   };
 }
 
+/** Where the station of the `index`th tool stands: rows of four in the yard outside the gate, to its right. */
+export function districtStationSpot(index, gateZ) {
+  return { x: 8 + (index % 4) * 3.4, z: gateZ + 3.6 + Math.floor(index / 4) * 3.2 };
+}
+const STATION_YARD = Object.freeze({ xFrom: 6, xTo: 21.5, zFrom: 1.5, zTo: 12.5 });
+
 /**
  * `showChrome: false` is for hosts that present DISTRICT_LEGEND and the work's read warnings in their
  * own overlay. `focusSelection: false` leaves navigation with the viewer when selecting a work site.
  * `onProjectSelection` receives { taskId, x, y, visible } on each rendered frame and immediately when
  * selection, visibility, size or records change. Coordinates are stage-local CSS pixels, never device
  * pixels; a cleared selection is { taskId: null, x: null, y: null, visible: false }.
+ * `exitLegend` (lines as DISTRICT_LEGEND) turns on the station yard for the tools of a business:
+ * stations come from `setExits`, and a picked station calls `onPickExit(id)`.  Without it nothing of
+ * the yard is drawn or listed.
  */
-export function createDistrictView({ doc, stage, reducedMotion = false, focusSelection = true, showChrome = true, onPick, onClear, onEscape, onProjectSelection }) {
+export function createDistrictView({ doc, stage, reducedMotion = false, focusSelection = true, showChrome = true, onPick, onClear, onEscape, onProjectSelection, exitLegend = null, onPickExit }) {
+  const stationsEnabled = Array.isArray(exitLegend);
   const renderer = new THREE.WebGLRenderer({ antialias: true });
   renderer.setPixelRatio(Math.min(globalThis.devicePixelRatio ?? 1, 2));
   renderer.shadowMap.enabled = true;
@@ -100,7 +117,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
   const legend = el(doc, 'details', { className: 'bb-world-district-legend', attrs: { open: true } });
   legend.append(el(doc, 'summary', { text: '区画の見方' }));
   const legendList = el(doc, 'ul');
-  for (const [className, text] of DISTRICT_LEGEND) legendList.append(el(doc, 'li', { className, text }));
+  for (const [className, text] of [...DISTRICT_LEGEND, ...(stationsEnabled ? exitLegend : [])]) legendList.append(el(doc, 'li', { className, text }));
   legend.append(legendList);
   legend.hidden = true;
   stage.append(legend);
@@ -329,6 +346,12 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
   let root = null;
   let fountainJet = null;
   let lots = new Map();
+  // The tools of the business (from the host), and their stations once the district is built.
+  let exitsData = [];
+  let stations = new Map();
+  let stationLayer = null;
+  let stationLabels = [];
+  let gateAt = 0;
   let labels = [];
   let walkers = [];
   let puffs = [];
@@ -503,6 +526,83 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     return group;
   }
 
+  // --- a station for a tool of the business, in local space: its front toward +z ------------------
+  function stationGroup(exit) {
+    const group = new THREE.Group();
+    const state = exit.state;
+    const lit = state === 'available';
+    const fogged = state === 'unknown' || state === 'unavailable';
+    const part = (object, name) => {
+      object.userData.part = name;
+      group.add(object);
+      return object;
+    };
+    group.add(mesh(roundedPlate(2.8, 1.9, 0.22, 0.2), material(0xd9d3c6, { roughness: 1 })));
+    group.add(mesh(new THREE.BoxGeometry(2.8, 0.04, 0.12), material(0xe9d27a, { roughness: 0.8 }), { y: 0.24, z: 0.86, shadow: false }));
+    const house = block(1.8, 1.15, 1.0, { style: 'civic', wall: fogged ? 0xcfd2d0 : 0xeee6d6, lit, roof: 0x8a6d55 });
+    house.position.set(0, 0.22, -0.35);
+    group.add(house);
+    const roof = mesh(gableRoof(1.0, 1.8, 0.5), material(fogged ? 0x9aa0a0 : 0x8a5a44, { roughness: 0.75 }), { y: 1.37, z: -0.35 });
+    roof.rotation.y = Math.PI / 2;
+    group.add(roof);
+    if (lit) {
+      // The station's lamp: always on, whatever the sky (its light is its state).
+      part(mesh(new THREE.CylinderGeometry(0.05, 0.06, 1.7, 6), material(0x3f4844, { roughness: 0.6, metalness: 0.4 }), { x: 1.15, y: 1.07, z: 0.55 }), 'light-pole');
+      part(mesh(new THREE.SphereGeometry(0.2, 12, 10), material(0xfff3d6, { emissive: new THREE.Color(0xffc867), emissiveIntensity: 2.2 }), { x: 1.15, y: 1.98, z: 0.55, shadow: false }), 'light');
+      const pool = mesh(new THREE.CircleGeometry(1.1, 24), new THREE.MeshBasicMaterial({ color: 0xffd98a, transparent: true, opacity: 0.45, depthWrite: false }), { x: 1.15, y: 0.25, z: 0.55, shadow: false });
+      pool.rotation.x = -Math.PI / 2;
+      part(pool, 'light-pool');
+    }
+    if (state === 'restricted') {
+      // The wicket closed: posts and a striped bar across the way in.
+      const post = material(0x4b524e, { roughness: 0.6, metalness: 0.3 });
+      for (const x of [-0.95, 0.95]) part(mesh(new THREE.BoxGeometry(0.14, 0.8, 0.14), post, { x, y: 0.62, z: 0.55 }), 'gate-post');
+      part(mesh(new THREE.BoxGeometry(1.9, 0.12, 0.08), material(0xc8323c, { roughness: 0.6, emissive: new THREE.Color(0x3a0a0e) }), { y: 0.86, z: 0.55 }), 'gate');
+      for (const x of [-0.5, 0.1, 0.7]) group.add(mesh(new THREE.BoxGeometry(0.22, 0.125, 0.085), material(0xf4f1e8), { x, y: 0.86, z: 0.55, shadow: false }));
+    }
+    if (fogged) {
+      // Fog round the station: its state could not be seen, which is not "unusable" or "usable".
+      const fogMaterial = new THREE.MeshBasicMaterial({ color: 0xe9edf0, transparent: true, opacity: 0.68, depthWrite: false });
+      const fog = mesh(new THREE.SphereGeometry(1.9, 18, 12), fogMaterial, { y: 0.9, shadow: false });
+      fog.scale.set(1, 0.72, 0.9);
+      part(fog, 'fog');
+    }
+    // The sign by the platform: what the tool asks attention for, if anything.
+    group.add(mesh(new THREE.CylinderGeometry(0.04, 0.05, 1.6, 6), material(0x4b524e), { x: -1.2, y: 1.0, z: 0.75 }));
+    group.add(mesh(new THREE.BoxGeometry(0.9, 0.42, 0.05), material(exit.attention ? 0x1f5f8b : 0x8e9a95, { roughness: 0.6 }), { x: -1.2, y: 1.85, z: 0.75 }));
+    group.userData = { kind: 'exit', exit, state };
+    return group;
+  }
+
+  function clearStations() {
+    if (stationLayer) root?.remove(stationLayer);
+    for (const label of stationLabels) {
+      label.node.remove();
+      labels = labels.filter((entry) => entry !== label);
+    }
+    stationLayer = null;
+    stationLabels = [];
+    if (selected?.userData?.kind === 'exit') select(null, { focus: false });
+    stations = new Map();
+  }
+
+  function placeStations() {
+    clearStations();
+    if (!stationsEnabled || !root || exitsData.length === 0) return;
+    stationLayer = new THREE.Group();
+    exitsData.forEach((exit, index) => {
+      const spot = districtStationSpot(index, gateAt);
+      const group = stationGroup(exit);
+      group.position.set(spot.x, 0, spot.z);
+      stationLayer.add(group);
+      stations.set(exit.id, group);
+      const sign = attentionSignText(exit.attention);
+      const name = exit.label.length > 16 ? `${exit.label.slice(0, 15)}…` : exit.label;
+      stationLabels.push(addLabel(`駅：${name}${sign ? `・${sign}` : ''}`, new THREE.Vector3(spot.x, 2.9, spot.z), `is-exit is-${exit.state}${exit.attention ? ' has-attention' : ''}`, { priority: 2 }));
+    });
+    root.add(stationLayer);
+  }
+
   // --- the district -------------------------------------------------------------------------------
   function clear() {
     if (root) scene.remove(root);
@@ -512,6 +612,9 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     for (const label of labels) label.node.remove();
     labels = [];
     lots = new Map();
+    stations = new Map();
+    stationLayer = null;
+    stationLabels = [];
     walkers = [];
     puffs = [];
     selected = null;
@@ -570,6 +673,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     const grown = stage.level;
     const plan = districtGroundPlan(L);
     const { gateZ, hallZ, plazaZ, plazaRadius } = plan;
+    gateAt = gateZ;
     // Land as in the world: gentle, non-repeating shades of grass (scenery).
     const grass = { low: new THREE.Color(0x9fbf8c), high: new THREE.Color(0xd3e4bd), warm: new THREE.Color(0xd9d6a6) };
     const land = mesh(paintVertices(new THREE.CircleGeometry(150, 96, 0, Math.PI * 2), (color, x, y) => {
@@ -618,7 +722,8 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
       const rz = pavingDepth / 2 + 3 + hashUnit(`belt${i}z`) * 8;
       trees.push([Math.cos(angle) * rx, (gateZ + hallZ) / 2 + Math.sin(angle) * rz, 0.8 + hashUnit(`belt${i}s`) * 0.6]);
     }
-    plantTrees(root, trees.filter(([x, z]) => !(Math.abs(x) < 4.2 && z > gateZ - 1)));
+    const inYard = (x, z) => stationsEnabled && x > STATION_YARD.xFrom && x < STATION_YARD.xTo && z > gateZ + STATION_YARD.zFrom && z < gateZ + STATION_YARD.zTo;
+    plantTrees(root, trees.filter(([x, z]) => !(Math.abs(x) < 4.2 && z > gateZ - 1) && !inYard(x, z)));
     // Lamps come with the district's growth: none on vacant land, every other one in a village.
     placeLamps(lift, grown === 0 ? [] : grown === 1 ? lamps.filter((_, i) => i % 4 === 0) : lamps);
     // The gate: stone pillars on plinths, a lintel with a cornice, lamps on its pillars.
@@ -731,6 +836,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
       root.add(walker);
       walkers.push(walker);
     }
+    placeStations();
     root.updateMatrixWorld(true);
     const chimneys = [hallChimney];
     for (const group of lots.values()) {
@@ -791,7 +897,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     pointer.x = ((clientX - rect.left) / rect.width) * 2 - 1;
     pointer.y = -((clientY - rect.top) / rect.height) * 2 + 1;
     raycaster.setFromCamera(pointer, camera);
-    const targets = [...lots.values()];
+    const targets = [...lots.values(), ...stations.values()];
     for (const hit of raycaster.intersectObjects(targets, true)) {
       let object = hit.object;
       while (object && !targets.includes(object)) object = object.parent;
@@ -809,7 +915,11 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
   renderer.domElement.addEventListener('pointerup', (event) => {
     if (!downAt || Math.hypot(event.clientX - downAt.x, event.clientY - downAt.y) > 5) return;
     const group = pickAt(event.clientX, event.clientY);
-    if (group) {
+    if (group?.userData.kind === 'exit') {
+      // A station selects its tool in the city details; it never leaves the world.
+      select(group, { focus: false });
+      onPickExit?.(group.userData.exit.id);
+    } else if (group) {
       select(group);
       onPick?.(group.userData.site);
     } else {
@@ -973,8 +1083,12 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
   }
 
   return {
-    /** Enters the district of a business; `neighbours` maps other business codes to their names. */
-    show(business, work, { neighbours = new Map() } = {}) {
+    /**
+     * Enters the district of a business; `neighbours` maps other business codes to their names, and
+     * `exits` (normalized tools, see world-exits.js) are its stations when the yard is on.
+     */
+    show(business, work, { neighbours = new Map(), exits } = {}) {
+      if (exits !== undefined) exitsData = exits;
       build(business, work, neighbours);
       setVisible(true);
       resize();
@@ -1017,7 +1131,8 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     /** Shows what changed since the viewer's last visit (from `districtChanges`). */
     celebrate,
     /** Rebuilds the open district from fresh records, keeping the camera where it is. */
-    refresh(business, work, { neighbours = new Map() } = {}) {
+    refresh(business, work, { neighbours = new Map(), exits } = {}) {
+      if (exits !== undefined) exitsData = exits;
       const keep = { target: controls.target.clone(), position: camera.position.clone(), taskId: selected?.userData?.site?.task_id };
       flight = null;
       controls.enabled = true;
@@ -1027,6 +1142,18 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
       camera.lookAt(keep.target);
       select(lots.get(keep.taskId) ?? null, { focus: false });
     },
+    /** The tools of the open business arrived (or changed): redraws only its stations. */
+    setExits(exits) {
+      exitsData = Array.isArray(exits) ? exits : [];
+      if (root) placeStations();
+    },
+    /** Marks a tool's station as selected (without moving the camera); false when it has none. */
+    selectExit(id) {
+      const group = stations.get(id);
+      if (!group) return false;
+      select(group, { focus: false });
+      return true;
+    },
     dispose() {
       running = false;
       setVisible(false);

package/ui/world/world-exits.js

@@ -0,0 +1,200 @@
+/*
+ * The tools a business uses (story-world-business-exits-v1).
+ *
+ * A host may pass `businessExits(business)` to the world.  Its answer is read here into what the
+ * world draws: the read state of the answer, and each tool with its link, its state and what it
+ * asks attention for.  Only `https:` links and links inside this host (starting with `/` or `?`)
+ * are drawn; anything else is dropped and counted, never shown as a link.  A read that failed or is
+ * not connected is never shown as zero tools.  Nothing here writes, and the host's answer is never
+ * changed: the world draws copies.
+ *
+ * The words for the four states come from the owner's vocabulary (`exit_states` in the businesses
+ * answer, as story-world-generic-graph-v1), over the defaults below.  No organization, member, role
+ * or request concept lives here: `state` and `action` are whatever the host decided.
+ */
+
+import {
+  makeWorkspaceElement as el,
+  workspaceRailBlock,
+} from '../../workspace-kit.js';
+import { shortTime } from './world-work-rail.js';
+
+export const WORLD_EXITS_CONTRACT_VERSION = 'brainbase.world-exits.v0';
+
+/** How the host read the tools of a business. */
+export const EXIT_READ_STATUSES = Object.freeze(['complete', 'partial', 'failed', 'not_connected']);
+
+/** The states of a tool, with the words used when the owner gives none. */
+export const EXIT_STATES = Object.freeze([
+  Object.freeze({ key: 'available', label: '使える' }),
+  Object.freeze({ key: 'restricted', label: '権限が必要' }),
+  Object.freeze({ key: 'unknown', label: '未確認' }),
+  Object.freeze({ key: 'unavailable', label: '読めない' }),
+]);
+const STATE_KEYS = new Set(EXIT_STATES.map((entry) => entry.key));
+
+const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : null);
+
+/**
+ * Where a link goes: 'external' for an https: URL, 'internal' for a link inside this host (a path
+ * starting with a single `/`, or a query starting with `?`), null for anything the world must not draw.
+ */
+export function exitHrefKind(href) {
+  if (typeof href !== 'string' || !href || href !== href.trim() || /[\u0000-\u001f\u007f\\]/u.test(href)) return null;
+  if (href.startsWith('?')) return 'internal';
+  if (href.startsWith('/')) return href.startsWith('//') ? null : 'internal';
+  if (!/^https:\/\//iu.test(href)) return null;
+  try {
+    const url = new URL(href);
+    return url.protocol === 'https:' && url.hostname ? 'external' : null;
+  } catch {
+    return null;
+  }
+}
+
+function attentionOf(value) {
+  if (!value || typeof value !== 'object') return null;
+  const count = typeof value.count === 'number' && Number.isInteger(value.count) && value.count >= 0 ? value.count : null;
+  return { count, label: text(value.label), as_of: text(value.as_of) };
+}
+
+/**
+ * Reads a host's answer into `{ status, read_at, reason, exits, dropped }`.  An answer the world
+ * cannot understand is a failed read (`invalid_answer`), never an empty one.  A tool without an id
+ * or a label, with a link it must not draw, or with an id already given is dropped and counted; an
+ * action with such a link is dropped from its tool and counted.  A state the world does not know is
+ * drawn as `unknown`, never as usable.
+ */
+export function normalizeBusinessExits(answer) {
+  const invalid = { status: 'failed', read_at: null, reason: 'invalid_answer', exits: [], dropped: { exits: 0, actions: 0 } };
+  if (!answer || typeof answer !== 'object' || !EXIT_READ_STATUSES.includes(answer.status)) return invalid;
+  const readable = answer.status === 'complete' || answer.status === 'partial';
+  if (readable && !Array.isArray(answer.exits)) return invalid;
+  const dropped = { exits: 0, actions: 0 };
+  const exits = [];
+  const seen = new Set();
+  for (const entry of readable ? answer.exits : []) {
+    const id = text(entry?.id);
+    const label = text(entry?.label);
+    const target = exitHrefKind(entry?.href);
+    if (!id || !label || !target || seen.has(id)) {
+      dropped.exits += 1;
+      continue;
+    }
+    seen.add(id);
+    let action = null;
+    if (entry.action != null) {
+      const actionLabel = text(entry.action?.label);
+      const actionTarget = exitHrefKind(entry.action?.href);
+      if (actionLabel && actionTarget) action = { label: actionLabel, href: entry.action.href, target: actionTarget };
+      else dropped.actions += 1;
+    }
+    exits.push({
+      id,
+      label,
+      href: entry.href,
+      target,
+      state: STATE_KEYS.has(entry.state) ? entry.state : 'unknown',
+      note: text(entry.note),
+      action,
+      attention: attentionOf(entry.attention),
+    });
+  }
+  return { status: answer.status, read_at: text(answer.read_at), reason: text(answer.reason), exits, dropped };
+}
+
+/** The owner's word for a state (`exit_states` of the vocabulary), else the default. */
+export function exitStateLabel(state, vocabulary) {
+  const given = Array.isArray(vocabulary?.exit_states) ? vocabulary.exit_states.find((entry) => entry?.key === state) : null;
+  return text(given?.label) ?? EXIT_STATES.find((entry) => entry.key === state)?.label ?? EXIT_STATES.find((entry) => entry.key === 'unknown').label;
+}
+
+/** What a tool asks attention for: its label, its count (never 0 for a missing count) and its time. */
+export function attentionText(attention) {
+  if (!attention) return null;
+  const count = attention.count === null ? '件数は未確認' : `${attention.count}件`;
+  const at = shortTime(attention.as_of);
+  return `${attention.label ?? '知らせ'} ${count}（${at ? `${at}時点` : '時点不明'}）`;
+}
+
+/** The short words on a station's sign. */
+export function attentionSignText(attention) {
+  if (!attention) return null;
+  return attention.count === null ? '件数未確認' : `${attention.count}件`;
+}
+
+/** The legend lines for the stations, in the owner's words for the states (AC-08). */
+export function exitLegend(vocabulary) {
+  const word = (state) => exitStateLabel(state, vocabulary);
+  return [
+    ['is-exit-available', `明かりのついた駅＝${word('available')}`],
+    ['is-exit-restricted', `改札が閉じた駅＝${word('restricted')}`],
+    ['is-exit-fog', `霧の駅＝${word('unknown')}・${word('unavailable')}`],
+    ['is-exit-sign', '駅の看板の数＝その道具が知らせている件数（ホストが渡した値。数が無いときは「件数未確認」）'],
+    ['is-exit-pick', '駅＝この事業で使う外の道具。選ぶと都市の詳細でその道具の行が選ばれます（駅からは外へ移りません）'],
+  ];
+}
+
+const READ_FAILURE_TEXT = Object.freeze({ not_connected: '未接続', invalid_answer: '道具の答えの形式が正しくありません' });
+
+function linkTo(doc, href, target, textValue, label) {
+  const attrs = { href, 'aria-label': target === 'external' ? `${label}（新しいタブで開く）` : label };
+  if (target === 'external') Object.assign(attrs, { target: '_blank', rel: 'noopener noreferrer' });
+  return el(doc, 'a', { className: 'bb-world-rail-link bb-world-exit-link', text: textValue, attrs });
+}
+
+/**
+ * The 「この事業の道具」 section of a city (AC-03, AC-05, AC-06).  `result` is a normalized answer, or
+ * null while it is being read.  Returns the section and the row of `selectedId`, if any.
+ */
+export function exitsRailBlock(doc, { result, vocabulary, selectedId = null }) {
+  const title = 'この事業の道具';
+  if (!result) return { block: workspaceRailBlock(doc, { title, className: 'bb-world-exits', content: { text: '道具を読み込んでいます…' } }), selectedRow: null };
+  if (result.status === 'failed' || result.status === 'not_connected') {
+    const reason = READ_FAILURE_TEXT[result.reason] ?? result.reason ?? (result.status === 'not_connected' ? READ_FAILURE_TEXT.not_connected : '理由不明');
+    return {
+      block: workspaceRailBlock(doc, {
+        title,
+        className: 'bb-world-exits is-unreadable',
+        content: [
+          { text: '道具を読めません（0件とは確認できません）', className: 'bb-world-exits-unreadable' },
+          { text: `理由：${result.status === 'not_connected' && result.reason ? `未接続（${reason}）` : reason}`, className: 'bb-world-rail-note' },
+        ],
+      }),
+      selectedRow: null,
+    };
+  }
+  const content = [];
+  let selectedRow = null;
+  if (result.status === 'partial') {
+    content.push({ text: `一部だけ読めた${result.reason ? `（${result.reason}）` : ''}。読めていない道具は0件とは限りません。`, className: 'bb-world-rail-caveat' });
+  }
+  if (result.exits.length === 0) {
+    content.push({ text: result.status === 'complete' ? 'この事業の道具は登録されていません' : '読めた範囲では道具は0件です' });
+  } else {
+    const list = el(doc, 'ul', { className: 'bb-world-rail-list bb-world-exit-list' });
+    for (const exit of result.exits) {
+      const selected = exit.id === selectedId;
+      const row = el(doc, 'li', { className: `bb-world-exit is-${exit.state}${selected ? ' is-selected' : ''}`, attrs: { 'data-exit-id': exit.id, 'aria-current': selected ? 'true' : null } });
+      const head = el(doc, 'div', { className: 'bb-world-exit-head' });
+      head.append(
+        el(doc, 'span', { className: 'bb-world-exit-label', text: exit.label }),
+        el(doc, 'span', { className: `bb-world-exit-state is-${exit.state}`, text: exitStateLabel(exit.state, vocabulary) }),
+      );
+      row.append(head);
+      if (exit.note) row.append(el(doc, 'small', { className: 'bb-world-rail-note', text: exit.note }));
+      if (exit.attention) row.append(el(doc, 'small', { className: 'bb-world-exit-attention', text: attentionText(exit.attention) }));
+      const links = el(doc, 'div', { className: 'bb-world-exit-links' });
+      links.append(linkTo(doc, exit.href, exit.target, '開く', `${exit.label}を開く`));
+      if (exit.action) links.append(linkTo(doc, exit.action.href, exit.action.target, exit.action.label, `${exit.label}：${exit.action.label}`));
+      row.append(links);
+      list.append(row);
+      if (selected) selectedRow = row;
+    }
+    content.push(list);
+  }
+  if (result.dropped.exits) content.push({ text: `形式が正しくない道具、または開けないリンク（https:とこの画面の中のリンク以外）の道具${result.dropped.exits}件は描いていません。`, className: 'bb-world-rail-note' });
+  if (result.dropped.actions) content.push({ text: `開けないリンクの操作${result.dropped.actions}件は出していません。`, className: 'bb-world-rail-note' });
+  content.push({ text: `読み込み：${shortTime(result.read_at) ?? '時点不明'}。状態と件数はホストが渡した値で、世界からは書き換えません。`, className: 'bb-world-rail-note' });
+  return { block: workspaceRailBlock(doc, { title, className: 'bb-world-exits', content }), selectedRow };
+}