@unson/brainbase-mcp 0.25.0 → 0.26.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.25.0",
+  "version": "0.26.1",
   "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",
@@ -79,6 +79,10 @@
       "types": "./dist/embedding-provider.d.ts",
       "import": "./dist/embedding-provider.js"
     },
+    "./graph-embedding-provider": {
+      "types": "./dist/graph-embedding-provider.d.ts",
+      "import": "./dist/graph-embedding-provider.js"
+    },
     "./graph-revision-reader": {
       "types": "./dist/graph-revision-reader.d.ts",
       "import": "./dist/graph-revision-reader.js"
@@ -431,5 +435,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "8b9b0e51e70847db4ed540d10c79655d0fd6e050"
+  "gitHead": "fbf6dd5d0f2b9df5e524c5a69623dce6cf24144e"
 }

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 };
+}

package/ui/world/world-view.css

@@ -563,3 +563,82 @@
 .bb-world-district-notice[hidden] {
   display: none;
 }
+
+/* --- the tools a business uses (story-world-business-exits-v1) ----------- */
+.bb-world-exit-list {
+  list-style: none;
+  padding-left: 0;
+}
+
+.bb-world-exit {
+  padding: 6px 8px;
+  border: 1px solid var(--bb-color-border);
+  border-left: 3px solid var(--bb-color-border);
+  border-radius: var(--bb-radius-sm);
+}
+
+.bb-world-exit.is-available { border-left-color: #c99a3a; }
+.bb-world-exit.is-restricted { border-left-color: #c8323c; }
+.bb-world-exit.is-unknown,
+.bb-world-exit.is-unavailable { border-left-color: #9aa3a8; }
+
+.bb-world-exit.is-selected {
+  border-color: var(--bb-color-accent);
+  box-shadow: 0 0 0 2px rgb(8 125 98 / 18%);
+}
+
+.bb-world-exit-head {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  gap: 6px;
+}
+
+.bb-world-exit-label {
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.bb-world-exit-state {
+  font-size: 11px;
+  padding: 0 6px;
+  border-radius: 999px;
+  border: 1px solid var(--bb-color-border);
+  color: var(--bb-color-muted);
+}
+
+.bb-world-exit-state.is-available { color: #7a5a12; border-color: #e0c27a; }
+.bb-world-exit-state.is-restricted { color: #a1192a; border-color: #e3a1a7; }
+
+.bb-world-exit-attention {
+  display: block;
+  margin-top: 2px;
+  font-size: 12px;
+  color: var(--bb-color-ink);
+}
+
+.bb-world-exit-links {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+}
+
+.bb-world-exits-unreadable {
+  display: block;
+  color: var(--bb-color-warning);
+  font-weight: 600;
+}
+
+.bb-world-fallback-exits {
+  margin: 4px 0 10px;
+}
+
+.bb-world-label.is-exit {
+  font-size: 11px;
+  font-weight: 600;
+}
+
+.bb-world-label.is-exit.is-available { border-color: #e0c27a; }
+.bb-world-label.is-exit.is-restricted { border-color: #e3a1a7; color: #a1192a; }
+.bb-world-label.is-exit.is-unknown,
+.bb-world-label.is-exit.is-unavailable { color: var(--bb-color-muted); }