thinkpool-pair 0.7.354 → 0.7.356

package/thinkpool-room-prompt.mjs

@@ -9,6 +9,7 @@
 // tells a fresh agent WHEN ThinkPool expects each capability without requiring
 // the people in the room to know a tool name or summon word.
 import { THINKPOOL_CAPABILITY_ROUTES, THINKPOOL_PROMPT_BUNDLE, thinkPoolCapabilityContract } from './thinkpool-prompt-contracts.mjs'
+import { buildContextManifest, formatRoomContextProjection } from './context-contract.mjs'
 
 export { THINKPOOL_CAPABILITY_ROUTES, THINKPOOL_PROMPT_BUNDLE }
 
@@ -113,7 +114,7 @@ export function createRoomContextSelector(roomContext) {
   return ({ force = false } = {}) => {
     let context = null
     try { context = typeof roomContext === 'function' ? roomContext() : roomContext } catch { context = null }
-    const value = String(context || '').trim()
+    const value = formatRoomContextProjection(context)
     if (!value) return ''
     const fingerprint = roomContextFingerprint(value)
     const changed = fingerprint !== previousFingerprint
@@ -122,6 +123,21 @@ export function createRoomContextSelector(roomContext) {
   }
 }
 
+// A caller can inspect the deterministic selection without retaining its raw
+// text. The manifest contains only allow-listed source kinds and safe refs.
+export function buildThinkPoolContextManifest({ currentUserTurn = '', roomNow = '', flowSliceDigest = null, approvedHumanResponse = null } = {}) {
+  const roomProjection = formatRoomContextProjection(roomNow)
+  return buildContextManifest({
+    promptBundle: THINKPOOL_PROMPT_BUNDLE,
+    sources: [
+      { kind: 'current_user_turn', value: currentUserTurn },
+      { kind: 'room_now_delta', value: roomProjection },
+      ...(flowSliceDigest ? [{ kind: 'flow_slice_digest', value: flowSliceDigest, ref: { type: 'flow_digest', id: 'local' } }] : []),
+      ...(approvedHumanResponse ? [{ kind: 'approved_human_response', value: approvedHumanResponse, ref: { type: 'control_item', id: 'approved' } }] : []),
+    ],
+  })
+}
+
 // One authoritative terminal-identity preamble for every structured runtime.
 // The bridge derives this from durable structural metadata — never from the text
 // of the task handed to the model. That distinction matters because a spawned

package/viewport.mjs

@@ -17,6 +17,10 @@ import os from 'node:os'
 import path from 'node:path'
 import { randomUUID } from 'node:crypto'
 import { previews, startPreview } from './flow-preview.mjs'
+import {
+  DESIGN_SOURCE_MAP_RELATIVE,
+  MAX_DESIGN_SOURCE_MAP_BYTES,
+} from './design-source-contract.mjs'
 
 export const DEFAULT_VIEWPORTS = Object.freeze({
   desktop: Object.freeze({ width: 1440, height: 900 }),
@@ -51,6 +55,18 @@ export async function resolveContainedRoot(workspaceRoot, requested = 'dist') {
   return resolved
 }
 
+export async function resolvePreviewSourceMap(previewRoot) {
+  if (!previewRoot) return null
+  let root, sourceMap
+  try {
+    root = await fsp.realpath(previewRoot)
+    sourceMap = await fsp.realpath(path.join(root, DESIGN_SOURCE_MAP_RELATIVE))
+    const stat = await fsp.stat(sourceMap)
+    if (!stat.isFile() || stat.size <= 0 || stat.size > MAX_DESIGN_SOURCE_MAP_BYTES) return null
+  } catch { return null }
+  return isInside(root, sourceMap) ? sourceMap : null
+}
+
 export function normalizeRoute(value = '/') {
   const route = String(value || '/').trim()
   if (!route.startsWith('/') || route.startsWith('//')) throw new Error('Preview path must start with one "/" and cannot be a URL.')
@@ -674,11 +690,13 @@ export class ViewportManager {
     if (snapshotPath) await fsp.writeFile(snapshotPath, snapshot)
     let manifestPath = null
     if (cardReady) {
+      const sourceMap = await resolvePreviewSourceMap(this.root)
       const manifest = {
         slug, title: String(title || 'Viewport capture').slice(0, 120),
         desktop: captures.desktop.file, mobile: captures.mobile.file, ts: Date.now(),
         sourceKind: 'preview', deliveryIntent: 'card', readinessValidated: true,
         snapshot: snapshotPath, previewRoot, route: normalizedRoute, captureKey,
+        ...(sourceMap ? { sourceMap } : {}),
         ...correlation,
       }
       manifestPath = path.join(this.outbox, `${slug}.json`)