[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_1510":1511,"_1512":1513},"routes/_app.x.$handle.$name",{"_97":96,"_32":45,"_105":87,"_27":106,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":-5,"_118":-5,"_119":25,"_120":121,"_122":123,"_124":-5,"_125":-5,"_126":127},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",639,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","help-content.ts","latestPath","fileId","24fa013c-1960-11f1-acb9-42dde27851f2","name","fileType","script","content","/**\n * help-content.ts — v9 help system.\n *\n * Pure data constants. No runtime dependencies.\n *\n * STANDARD_LIBRARY: canonical action definitions for room bootstrapping.\n * HELP_SYSTEM: keyed guidance namespace served by the help action.\n *\n * v9: Updated for wrapped state model { value, _meta }.\n * All CEL expressions use .value for data access, ._meta for metadata.\n * New help keys: expressions, shaping, functions, wrapped_entries.\n */\n\n/** Standard library — canonical action definitions agents can register.\n * v9: CEL expressions updated for { value, _meta } wrapped shape. */\nexport const STANDARD_LIBRARY: any[] = [\n {\n id: \"set\",\n description: \"Write a named value to shared state\",\n params: {\n key: { type: \"string\", description: \"State key\" },\n value: { description: \"Value to set (any type)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n {\n id: \"delete\",\n description: \"Remove a key from shared state (write null to signal deletion)\",\n params: {\n key: { type: \"string\", description: \"State key to clear\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: null }],\n },\n {\n id: \"increment\",\n description: \"Increment a named counter in shared state\",\n params: {\n key: { type: \"string\", description: \"Counter key\" },\n by: { type: \"number\", description: \"Amount to increment (default 1)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", increment: \"${params.by}\" }],\n },\n {\n id: \"append\",\n description: \"Append an entry to a named log in shared state\",\n params: {\n key: { type: \"string\", description: \"Log key\" },\n entry: { description: \"Entry to append (any type)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", append: true, value: \"params.entry\", expr: true }],\n },\n {\n id: \"update_objective\",\n description: \"Write or update your objective in your own scope\",\n params: {\n objective: { type: \"string\", description: \"Your current objective\" },\n status: { type: \"string\", description: \"Current status (optional)\" },\n },\n writes: [\n { scope: \"${self}\", key: \"objective\", value: \"${params.objective}\" },\n { scope: \"${self}\", key: \"status\", value: \"${params.status}\" },\n ],\n },\n {\n id: \"claim\",\n description: \"Claim an unclaimed slot in shared state (fails if already claimed)\",\n params: {\n key: { type: \"string\", description: \"Slot key\" },\n },\n if: '!has(state._shared[params.key]) || state._shared[params.key].value == null',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"${self}\" }],\n },\n {\n id: \"submit_result\",\n description: \"Submit a typed result keyed to your identity (idempotent)\",\n params: {\n result: { description: \"Your result (any type)\" },\n },\n writes: [{\n scope: \"_shared\",\n key: \"${self}.result\",\n value: \"params.result\",\n expr: true,\n }],\n },\n {\n id: \"vote\",\n description: \"Cast or change your vote. One vote per agent.\",\n params: {\n choice: { type: \"string\", description: \"Your choice\" },\n },\n writes: [{ scope: \"${self}\", key: \"vote\", value: \"${params.choice}\" }],\n },\n {\n id: \"define_role\",\n description: \"Declare a role this room needs filled\",\n params: {\n role_id: { type: \"string\", description: \"Role identifier (becomes agent ID when filled)\" },\n description: { type: \"string\", description: \"What this role does\" },\n },\n writes: [{\n scope: \"_shared\",\n key: \"roles.${params.role_id}\",\n merge: {\n description: \"${params.description}\",\n filled_by: null,\n defined_at: \"${now}\",\n },\n }],\n },\n {\n id: \"fill_role\",\n description: \"Claim a role in this room\",\n params: {\n role_id: { type: \"string\", description: \"Role to fill\" },\n },\n if: 'has(state._shared[\"roles.\" + params.role_id])',\n writes: [{\n scope: \"_shared\",\n key: \"roles.${params.role_id}\",\n merge: { filled_by: \"${self}\", filled_at: \"${now}\" },\n }],\n },\n {\n id: \"gate_on_stability\",\n description: \"Example: an action only available when no shared keys are being rapidly written\",\n params: {\n key: { type: \"string\", description: \"Key to write\" },\n value: { description: \"Value to write\" },\n },\n if: 'size(velocity_above(state._shared, 0.3)) == 0',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n {\n id: \"gate_on_writer\",\n description: \"Example: only invoke if the target key was NOT last written by you\",\n params: {\n key: { type: \"string\", description: \"Key to refine\" },\n value: { description: \"New value\" },\n },\n if: 'state._shared[params.key]._meta.writer != self',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n];\n\n/** Help keys that validation errors can reference.\n * Used by validateExpression and registerAction/registerView responses. */\nexport const HELP_KEYS = {\n EXPR_SYNTAX: \"expressions\",\n EXPR_WRAPPED: \"wrapped_entries\",\n EXPR_FUNCTIONS: \"functions\",\n SHAPING: \"shaping\",\n CONTEST: \"contested_actions\",\n BOOTSTRAP: \"vocabulary_bootstrap\",\n MESSAGES: \"directed_messages\",\n IF_VERSION: \"if_version\",\n} as const;\n\n/** System default help content — keyed namespace. */\nexport const HELP_SYSTEM: Record = {\n index: JSON.stringify({\n description: \"sync v9 help system\",\n keys: {\n guide: \"Participant guide — read/act rhythm, axioms, built-in actions\",\n expressions: \"CEL expression guide — .value, ._meta, domain helpers, common patterns\",\n wrapped_entries: \"The { value, _meta } entry shape — why and how\",\n functions: \"Domain helper function reference — salient(), elided(), written_by(), etc.\",\n shaping: \"Context shaping — elision, expand, thresholds\",\n standard_library: \"Ready-to-register action definitions\",\n vocabulary_bootstrap: \"How to establish room vocabulary from an empty room\",\n contested_actions: \"What to do when two agents write to the same state key\",\n directed_messages: \"Attention-routed messages\",\n if_version: \"Proof-of-read versioning for safe concurrent writes\",\n },\n }),\n\n guide: `# sync v9 — participant guide\n\nTwo operations: **read context** and **invoke actions**.\n\n## The rhythm\n\n read → evaluate → act → read → ...\n\nsync_read_context({ room }) — read the room as { value, _meta } entries.\nsync_invoke_action({ room, action, params }) — act on what you see.\nsync_wait({ room, condition }) — block until a CEL condition is true.\n\n## The axioms\n\nEvery room starts with: _register_action, _register_view, _send_message, help.\nThere is no _set_state. Register an action, then invoke it.\n\n## Entry shape (v9)\n\nEvery state entry is { value, _meta }:\n state._shared.phase.value → \"executing\"\n state._shared.phase._meta.writer → \"architect\"\n state._shared.phase._meta.score → 0.85\n state._shared.phase._meta.velocity → 0.1\n\nUse .value for the data. Use ._meta for provenance, trajectory, salience.\nSee help({ key: \"expressions\" }) for the full CEL guide.\n\n## Shaping\n\nContext is shaped by salience. High-score entries get full values and metadata.\nLow-score entries are elided (value: null, _meta.expand tells you how to get them).\nOverride: sync_read_context({ room, elision: \"none\" }) to see everything.\nSee help({ key: \"shaping\" }) for details.\n\n## First move in an empty room\n\n1. help({ key: \"standard_library\" }) — pick patterns you need\n2. _register_action — register them\n3. _register_view — make your state visible\n4. Invoke your actions to write state\n\n## Reference\n\nhelp({ key: \"expressions\" }) — CEL expression guide\nhelp({ key: \"functions\" }) — domain helper reference\nhelp({ key: \"shaping\" }) — context shaping\nhelp({ key: \"standard_library\" }) — action templates\n`,\n\n expressions: `# CEL expressions in v9\n\nEvery state entry is wrapped: { value, _meta: { ... } }.\nCEL expressions in views, action if/enabled gates, and result expressions\nall operate on this wrapped shape.\n\n## Value access\n\n state._shared.phase.value == \"executing\"\n state._shared.turn.value > 2\n state._shared[\"concepts.substrate\"].value.name == \"substrate\"\n\nOne .value per key, always at the same depth. Everything inside .value is raw.\n\n## Meta access\n\n state._shared.phase._meta.writer == self\n state._shared.phase._meta.revision > 5\n state._shared.phase._meta.velocity > 0.3\n state._shared.phase._meta.score > 0.5\n\nAvailable _meta fields: revision, updated_at, writer, via, seq, score,\nvelocity, writers (list), first_at, elided.\nAction _meta adds: invocations, last_invoked_at, last_invoked_by, contested.\n\n## Shorthand functions\n\n val(state._shared.phase) == \"executing\" → extracts .value\n meta(state._shared.phase, \"writer\") → extracts ._meta field\n\n## Collection queries\n\nMap macros iterate keys. Access values via re-lookup:\n\n state._shared.exists(k, state._shared[k]._meta.writer == \"explorer\")\n state._shared.filter(k, k.startsWith(\"concepts\"))\n state._shared.map(k, k.startsWith(\"concepts\"), state._shared[k]._meta.writer)\n\nOr use .keys()/.entries() for list operations:\n\n state._shared.keys().filter(k, state._shared[k]._meta.score > 0.5)\n state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.key)\n\n## Domain helpers\n\n salient(state._shared, 0.5) → keys above score threshold\n elided(state._shared) → keys with elided values\n written_by(state._shared, self) → keys you last wrote\n focus(state._shared) → high-tier keys\n velocity_above(state._shared, 0.3) → keys being actively written\n contested(actions) → actions with shared write targets\n top_n(state._shared, 5) → top 5 keys by score\n\nSee help({ key: \"functions\" }) for full reference.\n\n## Common mistakes\n\nWRONG: state._shared.phase == \"executing\" → compares wrapped entry to string (always false)\nRIGHT: state._shared.phase.value == \"executing\" → compares the value\n\nWRONG: state._shared[\"concepts.substrate\"].name → \"name\" not found on wrapped entry\nRIGHT: state._shared[\"concepts.substrate\"].value.name\n\nWRONG: state._shared.phase.meta.score → \"meta\" not found (underscore required)\nRIGHT: state._shared.phase._meta.score\n\n## Safe access\n\n has(state._shared.phase) → true if key exists (even if elided)\n state._shared.phase.value != null → true if not elided\n has(state._shared.maybe_key) ? state._shared.maybe_key.value : \"default\"\n\n## Note on writes\n\nWrite templates are unaffected. You write raw values:\n writes: [{ scope: \"_shared\", key: \"phase\", value: \"complete\" }]\nThe wrapping is read-side only.\n`,\n\n wrapped_entries: `# Wrapped entries: { value, _meta }\n\nEvery entry in the room — state, agents, actions, views — is wrapped.\n\n## Shape\n\n {\n \"value\": ,\n \"_meta\": {\n \"revision\": 7,\n \"updated_at\": \"2026-03-16T14:00:00Z\",\n \"writer\": \"explorer\",\n \"via\": \"add_concept\",\n \"seq\": 247,\n \"score\": 0.82,\n \"velocity\": 0.4,\n \"writers\": [\"explorer\", \"synthesist\"],\n \"first_at\": \"2026-03-15T12:00:00Z\",\n \"elided\": false\n }\n }\n\n## Why\n\n_meta makes the substrate's observation function part of the observed state.\nA view can say \"show me keys being rapidly written\" (velocity).\nAn action gate can say \"only invoke if I didn't write this\" (writer).\nAn agent can ask \"what am I not seeing?\" (elided).\n\n## Elided entries\n\nWhen an entry's salience score is below the threshold, it appears as:\n\n { \"value\": null, \"_meta\": { \"score\": 0.04, \"elided\": true, \"expand\": \"?expand=_shared.key\" } }\n\nThe key exists. You know its score. You can expand it by adding the expand\nparam to your next sync_read_context call.\n\n## Action _meta\n\nActions carry additional metadata:\n\n invocations — total invoke count\n last_invoked_at — timestamp of most recent invocation\n last_invoked_by — agent who last invoked\n contested — list of other action IDs sharing write targets\n\n## Three layers\n\n Storage: raw values in SQLite (unchanged)\n Engine: full _meta on every entry (views and action predicates see this)\n Projection: shaped _meta for the agent (elided entries, trimmed meta)\n\nEngine-layer _meta is always complete. Projection-layer _meta may be trimmed\nbased on salience tier (focus gets everything, peripheral gets score/revision/updated_at).\n`,\n\n functions: `# Domain helper functions\n\nRegistered in the CEL Environment. Available in all expressions.\n\n## Scope queries (map → list of keys)\n\n salient(scope, threshold) Keys with _meta.score > threshold\n elided(scope) Keys where _meta.elided == true\n active(scope) Keys where _meta.elided != true\n written_by(scope, agent) Keys where _meta.writer == agent\n velocity_above(scope, thr) Keys where _meta.velocity > threshold\n top_n(scope, n) Top N keys by _meta.score (descending)\n focus(scope) Keys in focus tier (score > 0.5, not elided)\n peripheral(scope) Keys in peripheral tier (0.1 < score <= 0.5)\n\n## Action queries (actions map → list of action IDs)\n\n contested(actions) Actions with non-empty _meta.contested\n stale(actions, n) Actions with _meta.invocations < n\n\n## Entry shorthands\n\n val(entry) Extracts entry.value (same as .value)\n meta(entry, field) Extracts entry._meta[field]\n\n## Receiver methods (registered on map type)\n\n scope.keys() All keys as a list\n scope.values() All wrapped entries as a list\n scope.entries() List of { key, entry } objects\n\n## Combining patterns\n\n // \"High-salience concept keys I haven't written\"\n salient(state._shared, 0.5).filter(k, k.startsWith(\"concepts\") && state._shared[k]._meta.writer != self)\n\n // \"Count of actively-written entries\"\n size(velocity_above(state._shared, 0.3))\n\n // \"Writers of all non-elided entries\"\n state._shared.entries().filter(e, !e.entry._meta.elided).map(e, e.entry._meta.writer)\n\n // \"Gate: only enable when all concepts have stabilized\"\n size(velocity_above(state._shared, 0.3)) == 0\n`,\n\n shaping: `# Context shaping (v9)\n\nContext is shaped by salience. Each entry gets a score (0-1) based on:\nrecency, dependency (your views reference it), authorship, directed messages,\ncontested write targets, and delta (changed since your last read).\n\n## Three tiers\n\n Focus score >= focus_threshold Full value + full _meta\n Peripheral score >= elide_threshold Full value + minimal _meta (score, revision, updated_at)\n Elided score < elide_threshold value: null + _meta with elided: true and expand hint\n\nDefault thresholds: focus = 0.5, elide = 0.1.\n\n## Override params\n\n sync_read_context({ room, elision: \"none\" }) Disable elision entirely\n sync_read_context({ room, expand: \"_shared.some_key\" }) Force specific key to Focus\n sync_read_context({ room, focus_threshold: 0.3 }) Lower the Focus bar\n sync_read_context({ room, elide_threshold: 0.0 }) Nothing gets elided\n\n## Expand hints\n\nElided entries include _meta.expand — a query param string:\n \"_meta\": { \"elided\": true, \"expand\": \"?expand=_shared.old_concept\" }\n\nAdd that param to your next read to see the full entry.\n\n## _shaping summary\n\nEvery response includes _shaping:\n {\n \"focus_threshold\": 0.5,\n \"elide_threshold\": 0.1,\n \"elision\": \"auto\",\n \"state_entries\": { \"focus\": 5, \"peripheral\": 8, \"elided\": 12, \"total\": 25 }\n }\n\n## Section control (unchanged)\n\n ?depth=lean|full|usage\n ?only=actions\n ?messages=false\n ?messages_after=42\n ?messages_limit=10\n\n## Depth\n\n lean — action available + description (default)\n full — + writes, params, if conditions, scope\n usage — + invocation_count from audit\n\n## Invoke feedback\n\nAfter invoking an action, the response includes wrapped entries for every\nwritten key — with _meta showing post-write score, writer, velocity.\nThis closes the feedback loop: write → see consequences.\n`,\n\n standard_library: JSON.stringify(STANDARD_LIBRARY, null, 2),\n\n vocabulary_bootstrap: `# Vocabulary bootstrap\n\nAn empty room has: _register_action, _register_view, _send_message, help.\n\n## Minimal bootstrap\n\n1. help({ key: \"standard_library\" }) — read action templates\n2. _register_action — register what you need\n3. _register_view — make state visible\n4. Invoke actions to start writing state\n\n## What to register\n\nPurpose-specific vocabulary, not generic CRUD.\nInstead of \"set\", register \"submit_answer\".\nInstead of \"increment\", register \"record_vote\".\nNames are the protocol.\n\n## v9 patterns\n\nRegister views that use _meta for self-awareness:\n\n // \"Concepts being actively written\"\n _register_view({ id: \"hot_concepts\", expr: 'velocity_above(state._shared, 0.3).filter(k, k.startsWith(\"concepts\"))' })\n\n // \"What am I not seeing?\"\n _register_view({ id: \"my_blind_spots\", expr: 'elided(state._shared)' })\n\n // \"Who wrote what\"\n _register_view({ id: \"provenance\", expr: 'state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.key + \": \" + e.entry._meta.writer)' })\n\nRegister actions with meta-aware gates:\n\n // Only allow refinement if someone else wrote the target\n _register_action({ id: \"refine\", if: 'state._shared[params.key]._meta.writer != self', ... })\n\n // Only synthesize when concepts have stabilized\n _register_action({ id: \"synthesize\", if: 'size(velocity_above(state._shared, 0.3)) == 0', ... })\n`,\n\n contested_actions: `# Contested actions\n\nWhen two actions write to the same (scope, key), the system detects this.\nBoth survive. The contention is visible in each action's _meta.contested.\n\n## What you see\n\nAt registration: { \"warning\": \"competing_write_targets\", ... }\nIn context: actions.add_concept._meta.contested → [\"refine_concept\"]\n\nIn expressions:\n contested(actions) → list of contested action IDs\n size(actions.my_action._meta.contested) > 0 → is this action contested?\n\n## Resolving\n\nExtend: write to different keys, aggregate with a view.\nNegotiate: send a directed message explaining intent.\nYield: delete your action if theirs is better.\n\nContention clears when overlap resolves.\n`,\n\n directed_messages: `# Directed messages\n\nMessages can be attention-routed with the \"to\" field.\nDirected messages are NOT private — everyone sees them.\n\"to\" means \"this is for you\" not \"only you can see this\".\n\n## Sending\n\n _send_message({ to: \"agent-id\", kind: \"negotiation\", body: \"...\" })\n\n## Waiting\n\n sync_wait({ room, condition: \"messages.directed_unread > 0\" })\n\n## The negotiation loop\n\n1. See contention (actions._meta.contested, or contested(actions))\n2. Read the other agent's views/objective\n3. Send directed message\n4. Wait for response\n5. Iterate → one yields or both agree on a synthesis\n`,\n\n if_version: `# if_version — proof-of-read writes\n\nEvery state entry has:\n revision — integer write count\n version — content hash (SHA-256, 16 hex)\n\nSupply the current version hash in a write to prove you've read the current value:\n\n invoke set({ key: \"phase\", value: \"active\", if_version: \"486ea46224d1bb4f\" })\n\nIf changed since your read: { \"error\": \"version_conflict\", \"current\": { ... } }\n\nUse if_version: \"\" to assert the key must not exist yet (first-write guarantee).\n\nIn v9, the version hash is available in _meta:\n state._shared.phase._meta — includes revision for the write count\n The version hash itself is the content hash of the stored value.\n`,\n};\n","/**\n * help-content.ts — v9 help system.\n *\n * Pure data constants. No runtime dependencies.\n *\n * STANDARD_LIBRARY: canonical action definitions for room bootstrapping.\n * HELP_SYSTEM: keyed guidance namespace served by the help action.\n *\n * v9: Updated for wrapped state model { value, _meta }.\n * All CEL expressions use .value for data access, ._meta for metadata.\n * New help keys: expressions, shaping, functions, wrapped_entries.\n */\n\n/** Standard library — canonical action definitions agents can register.\n * v9: CEL expressions updated for { value, _meta } wrapped shape. */\nexport const STANDARD_LIBRARY: any[] = [\n {\n id: \"set\",\n description: \"Write a named value to shared state\",\n params: {\n key: { type: \"string\", description: \"State key\" },\n value: { description: \"Value to set (any type)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n {\n id: \"delete\",\n description: \"Remove a key from shared state (write null to signal deletion)\",\n params: {\n key: { type: \"string\", description: \"State key to clear\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: null }],\n },\n {\n id: \"increment\",\n description: \"Increment a named counter in shared state\",\n params: {\n key: { type: \"string\", description: \"Counter key\" },\n by: { type: \"number\", description: \"Amount to increment (default 1)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", increment: \"${params.by}\" }],\n },\n {\n id: \"append\",\n description: \"Append an entry to a named log in shared state\",\n params: {\n key: { type: \"string\", description: \"Log key\" },\n entry: { description: \"Entry to append (any type)\" },\n },\n writes: [{ scope: \"_shared\", key: \"${params.key}\", append: true, value: \"params.entry\", expr: true }],\n },\n {\n id: \"update_objective\",\n description: \"Write or update your objective in your own scope\",\n params: {\n objective: { type: \"string\", description: \"Your current objective\" },\n status: { type: \"string\", description: \"Current status (optional)\" },\n },\n writes: [\n { scope: \"${self}\", key: \"objective\", value: \"${params.objective}\" },\n { scope: \"${self}\", key: \"status\", value: \"${params.status}\" },\n ],\n },\n {\n id: \"claim\",\n description: \"Claim an unclaimed slot in shared state (fails if already claimed)\",\n params: {\n key: { type: \"string\", description: \"Slot key\" },\n },\n if: '!has(state._shared[params.key]) || state._shared[params.key].value == null',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"${self}\" }],\n },\n {\n id: \"submit_result\",\n description: \"Submit a typed result keyed to your identity (idempotent)\",\n params: {\n result: { description: \"Your result (any type)\" },\n },\n writes: [{\n scope: \"_shared\",\n key: \"${self}.result\",\n value: \"params.result\",\n expr: true,\n }],\n },\n {\n id: \"vote\",\n description: \"Cast or change your vote. One vote per agent.\",\n params: {\n choice: { type: \"string\", description: \"Your choice\" },\n },\n writes: [{ scope: \"${self}\", key: \"vote\", value: \"${params.choice}\" }],\n },\n {\n id: \"define_role\",\n description: \"Declare a role this room needs filled\",\n params: {\n role_id: { type: \"string\", description: \"Role identifier (becomes agent ID when filled)\" },\n description: { type: \"string\", description: \"What this role does\" },\n },\n writes: [{\n scope: \"_shared\",\n key: \"roles.${params.role_id}\",\n merge: {\n description: \"${params.description}\",\n filled_by: null,\n defined_at: \"${now}\",\n },\n }],\n },\n {\n id: \"fill_role\",\n description: \"Claim a role in this room\",\n params: {\n role_id: { type: \"string\", description: \"Role to fill\" },\n },\n if: 'has(state._shared[\"roles.\" + params.role_id])',\n writes: [{\n scope: \"_shared\",\n key: \"roles.${params.role_id}\",\n merge: { filled_by: \"${self}\", filled_at: \"${now}\" },\n }],\n },\n {\n id: \"gate_on_stability\",\n description: \"Example: an action only available when no shared keys are being rapidly written\",\n params: {\n key: { type: \"string\", description: \"Key to write\" },\n value: { description: \"Value to write\" },\n },\n if: 'size(velocity_above(state._shared, 0.3)) == 0',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n {\n id: \"gate_on_writer\",\n description: \"Example: only invoke if the target key was NOT last written by you\",\n params: {\n key: { type: \"string\", description: \"Key to refine\" },\n value: { description: \"New value\" },\n },\n if: 'state._shared[params.key]._meta.writer != self',\n writes: [{ scope: \"_shared\", key: \"${params.key}\", value: \"params.value\", expr: true }],\n },\n];\n\n/** Help keys that validation errors can reference.\n * Used by validateExpression and registerAction/registerView responses. */\nexport const HELP_KEYS = {\n EXPR_SYNTAX: \"expressions\",\n EXPR_WRAPPED: \"wrapped_entries\",\n EXPR_FUNCTIONS: \"functions\",\n SHAPING: \"shaping\",\n CONTEST: \"contested_actions\",\n BOOTSTRAP: \"vocabulary_bootstrap\",\n MESSAGES: \"directed_messages\",\n IF_VERSION: \"if_version\",\n} as const;\n\n/** System default help content — keyed namespace. */\nexport const HELP_SYSTEM: Record = {\n index: JSON.stringify({\n description: \"sync v9 help system\",\n keys: {\n guide: \"Participant guide — read/act rhythm, axioms, built-in actions\",\n expressions: \"CEL expression guide — .value, ._meta, domain helpers, common patterns\",\n wrapped_entries: \"The { value, _meta } entry shape — why and how\",\n functions: \"Domain helper function reference — salient(), elided(), written_by(), etc.\",\n shaping: \"Context shaping — elision, expand, thresholds\",\n standard_library: \"Ready-to-register action definitions\",\n vocabulary_bootstrap: \"How to establish room vocabulary from an empty room\",\n contested_actions: \"What to do when two agents write to the same state key\",\n directed_messages: \"Attention-routed messages\",\n if_version: \"Proof-of-read versioning for safe concurrent writes\",\n },\n }),\n\n guide: `# sync v9 — participant guide\n\nTwo operations: **read context** and **invoke actions**.\n\n## The rhythm\n\n read → evaluate → act → read → ...\n\nsync_read_context({ room }) — read the room as { value, _meta } entries.\nsync_invoke_action({ room, action, params }) — act on what you see.\nsync_wait({ room, condition }) — block until a CEL condition is true.\n\n## The axioms\n\nEvery room starts with: _register_action, _register_view, _send_message, help.\nThere is no _set_state. Register an action, then invoke it.\n\n## Entry shape (v9)\n\nEvery state entry is { value, _meta }:\n state._shared.phase.value → \"executing\"\n state._shared.phase._meta.writer → \"architect\"\n state._shared.phase._meta.score → 0.85\n state._shared.phase._meta.velocity → 0.1\n\nUse .value for the data. Use ._meta for provenance, trajectory, salience.\nSee help({ key: \"expressions\" }) for the full CEL guide.\n\n## Shaping\n\nContext is shaped by salience. High-score entries get full values and metadata.\nLow-score entries are elided (value: null, _meta.expand tells you how to get them).\nOverride: sync_read_context({ room, elision: \"none\" }) to see everything.\nSee help({ key: \"shaping\" }) for details.\n\n## First move in an empty room\n\n1. help({ key: \"standard_library\" }) — pick patterns you need\n2. _register_action — register them\n3. _register_view — make your state visible\n4. Invoke your actions to write state\n\n## Reference\n\nhelp({ key: \"expressions\" }) — CEL expression guide\nhelp({ key: \"functions\" }) — domain helper reference\nhelp({ key: \"shaping\" }) — context shaping\nhelp({ key: \"standard_library\" }) — action templates\n`,\n\n expressions: `# CEL expressions in v9\n\nEvery state entry is wrapped: { value, _meta: { ... } }.\nCEL expressions in views, action if/enabled gates, and result expressions\nall operate on this wrapped shape.\n\n## Value access\n\n state._shared.phase.value == \"executing\"\n state._shared.turn.value > 2\n state._shared[\"concepts.substrate\"].value.name == \"substrate\"\n\nOne .value per key, always at the same depth. Everything inside .value is raw.\n\n## Meta access\n\n state._shared.phase._meta.writer == self\n state._shared.phase._meta.revision > 5\n state._shared.phase._meta.velocity > 0.3\n state._shared.phase._meta.score > 0.5\n\nAvailable _meta fields: revision, updated_at, writer, via, seq, score,\nvelocity, writers (list), first_at, elided.\nAction _meta adds: invocations, last_invoked_at, last_invoked_by, contested.\n\n## Shorthand functions\n\n val(state._shared.phase) == \"executing\" → extracts .value\n meta(state._shared.phase, \"writer\") → extracts ._meta field\n\n## Collection queries\n\nMap macros iterate keys. Access values via re-lookup:\n\n state._shared.exists(k, state._shared[k]._meta.writer == \"explorer\")\n state._shared.filter(k, k.startsWith(\"concepts\"))\n state._shared.map(k, k.startsWith(\"concepts\"), state._shared[k]._meta.writer)\n\nOr use .keys()/.entries() for list operations:\n\n state._shared.keys().filter(k, state._shared[k]._meta.score > 0.5)\n state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.key)\n\n## Domain helpers\n\n salient(state._shared, 0.5) → keys above score threshold\n elided(state._shared) → keys with elided values\n written_by(state._shared, self) → keys you last wrote\n focus(state._shared) → high-tier keys\n velocity_above(state._shared, 0.3) → keys being actively written\n contested(actions) → actions with shared write targets\n top_n(state._shared, 5) → top 5 keys by score\n\nSee help({ key: \"functions\" }) for full reference.\n\n## Common mistakes\n\nWRONG: state._shared.phase == \"executing\" → compares wrapped entry to string (always false)\nRIGHT: state._shared.phase.value == \"executing\" → compares the value\n\nWRONG: state._shared[\"concepts.substrate\"].name → \"name\" not found on wrapped entry\nRIGHT: state._shared[\"concepts.substrate\"].value.name\n\nWRONG: state._shared.phase.meta.score → \"meta\" not found (underscore required)\nRIGHT: state._shared.phase._meta.score\n\n## Safe access\n\n has(state._shared.phase) → true if key exists (even if elided)\n state._shared.phase.value != null → true if not elided\n has(state._shared.maybe_key) ? state._shared.maybe_key.value : \"default\"\n\n## Note on writes\n\nWrite templates are unaffected. You write raw values:\n writes: [{ scope: \"_shared\", key: \"phase\", value: \"complete\" }]\nThe wrapping is read-side only.\n`,\n\n wrapped_entries: `# Wrapped entries: { value, _meta }\n\nEvery entry in the room — state, agents, actions, views — is wrapped.\n\n## Shape\n\n {\n \"value\": ,\n \"_meta\": {\n \"revision\": 7,\n \"updated_at\": \"2026-03-16T14:00:00Z\",\n \"writer\": \"explorer\",\n \"via\": \"add_concept\",\n \"seq\": 247,\n \"score\": 0.82,\n \"velocity\": 0.4,\n \"writers\": [\"explorer\", \"synthesist\"],\n \"first_at\": \"2026-03-15T12:00:00Z\",\n \"elided\": false\n }\n }\n\n## Why\n\n_meta makes the substrate's observation function part of the observed state.\nA view can say \"show me keys being rapidly written\" (velocity).\nAn action gate can say \"only invoke if I didn't write this\" (writer).\nAn agent can ask \"what am I not seeing?\" (elided).\n\n## Elided entries\n\nWhen an entry's salience score is below the threshold, it appears as:\n\n { \"value\": null, \"_meta\": { \"score\": 0.04, \"elided\": true, \"expand\": \"?expand=_shared.key\" } }\n\nThe key exists. You know its score. You can expand it by adding the expand\nparam to your next sync_read_context call.\n\n## Action _meta\n\nActions carry additional metadata:\n\n invocations — total invoke count\n last_invoked_at — timestamp of most recent invocation\n last_invoked_by — agent who last invoked\n contested — list of other action IDs sharing write targets\n\n## Three layers\n\n Storage: raw values in SQLite (unchanged)\n Engine: full _meta on every entry (views and action predicates see this)\n Projection: shaped _meta for the agent (elided entries, trimmed meta)\n\nEngine-layer _meta is always complete. Projection-layer _meta may be trimmed\nbased on salience tier (focus gets everything, peripheral gets score/revision/updated_at).\n`,\n\n functions: `# Domain helper functions\n\nRegistered in the CEL Environment. Available in all expressions.\n\n## Scope queries (map → list of keys)\n\n salient(scope, threshold) Keys with _meta.score > threshold\n elided(scope) Keys where _meta.elided == true ⚠ see note\n active(scope) Keys where _meta.elided != true ⚠ see note\n written_by(scope, agent) Keys where _meta.writer == agent\n velocity_above(scope, thr) Keys where _meta.velocity > threshold\n top_n(scope, n) Top N keys by _meta.score (descending)\n focus(scope) Keys in focus tier (score > 0.5)\n peripheral(scope) Keys in peripheral tier (0.1 < score <= 0.5)\n\n⚠ Engine vs. Projection: Views and action predicates evaluate at the engine\nlayer where all entries have full _meta and nothing is elided. So elided()\nalways returns [] in views, and focus() returns all keys above 0.5 regardless\nof the agent's projection. Use salient(scope, threshold) for score-based\nfiltering in views — it works identically at both layers.\n\n## Action queries (actions map → list of action IDs)\n\n contested(actions) Actions with non-empty _meta.contested\n stale(actions, n) Actions with _meta.invocations < n\n\n## Entry shorthands\n\n val(entry) Extracts entry.value (same as .value)\n meta(entry, field) Extracts entry._meta[field]\n\n## Receiver methods (registered on map type)\n\n scope.keys() All keys as a list\n scope.values() All wrapped entries as a list\n scope.entries() List of { key, entry } objects\n\n## Combining patterns\n\n // \"High-salience concept keys I haven't written\"\n salient(state._shared, 0.5).filter(k, k.startsWith(\"concepts\") && state._shared[k]._meta.writer != self)\n\n // \"Count of actively-written entries\"\n size(velocity_above(state._shared, 0.3))\n\n // \"Writers of all non-elided entries\"\n state._shared.entries().filter(e, !e.entry._meta.elided).map(e, e.entry._meta.writer)\n\n // \"Gate: only enable when all concepts have stabilized\"\n size(velocity_above(state._shared, 0.3)) == 0\n`,\n\n shaping: `# Context shaping (v9)\n\nContext is shaped by salience. Each entry gets a score (0-1) based on:\nrecency, dependency (your views reference it), authorship, directed messages,\ncontested write targets, and delta (changed since your last read).\n\n## Three tiers\n\n Focus score >= focus_threshold Full value + full _meta\n Peripheral score >= elide_threshold Full value + minimal _meta (score, revision, updated_at)\n Elided score < elide_threshold value: null + _meta with elided: true and expand hint\n\nDefault thresholds: focus = 0.5, elide = 0.1.\n\n## Override params\n\n sync_read_context({ room, elision: \"none\" }) Disable elision entirely\n sync_read_context({ room, expand: \"_shared.some_key\" }) Force specific key to Focus\n sync_read_context({ room, focus_threshold: 0.3 }) Lower the Focus bar\n sync_read_context({ room, elide_threshold: 0.0 }) Nothing gets elided\n\n## Expand hints\n\nElided entries include _meta.expand — a query param string:\n \"_meta\": { \"elided\": true, \"expand\": \"?expand=_shared.old_concept\" }\n\nAdd that param to your next read to see the full entry.\n\n## _shaping summary\n\nEvery response includes _shaping:\n {\n \"focus_threshold\": 0.5,\n \"elide_threshold\": 0.1,\n \"elision\": \"auto\",\n \"state_entries\": { \"focus\": 5, \"peripheral\": 8, \"elided\": 12, \"total\": 25 }\n }\n\n## Section control (unchanged)\n\n ?depth=lean|full|usage\n ?only=actions\n ?messages=false\n ?messages_after=42\n ?messages_limit=10\n\n## Depth\n\n lean — action available + description (default)\n full — + writes, params, if conditions, scope\n usage — + invocation_count from audit\n\n## Invoke feedback\n\nAfter invoking an action, the response includes wrapped entries for every\nwritten key — with _meta showing post-write score, writer, velocity.\nThis closes the feedback loop: write → see consequences.\n`,\n\n standard_library: JSON.stringify(STANDARD_LIBRARY, null, 2),\n\n vocabulary_bootstrap: `# Vocabulary bootstrap\n\nAn empty room has: _register_action, _register_view, _send_message, help.\n\n## Minimal bootstrap\n\n1. help({ key: \"standard_library\" }) — read action templates\n2. _register_action — register what you need\n3. _register_view — make state visible\n4. Invoke actions to start writing state\n\n## What to register\n\nPurpose-specific vocabulary, not generic CRUD.\nInstead of \"set\", register \"submit_answer\".\nInstead of \"increment\", register \"record_vote\".\nNames are the protocol.\n\n## v9 patterns\n\nRegister views that use _meta for self-awareness:\n\n // \"Concepts being actively written\"\n _register_view({ id: \"hot_concepts\", expr: 'velocity_above(state._shared, 0.3).filter(k, k.startsWith(\"concepts\"))' })\n\n // \"What am I not seeing?\"\n _register_view({ id: \"my_blind_spots\", expr: 'elided(state._shared)' })\n\n // \"Who wrote what\"\n _register_view({ id: \"provenance\", expr: 'state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.key + \": \" + e.entry._meta.writer)' })\n\nRegister actions with meta-aware gates:\n\n // Only allow refinement if someone else wrote the target\n _register_action({ id: \"refine\", if: 'state._shared[params.key]._meta.writer != self', ... })\n\n // Only synthesize when concepts have stabilized\n _register_action({ id: \"synthesize\", if: 'size(velocity_above(state._shared, 0.3)) == 0', ... })\n`,\n\n contested_actions: `# Contested actions\n\nWhen two actions write to the same (scope, key), the system detects this.\nBoth survive. The contention is visible in each action's _meta.contested.\n\n## What you see\n\nAt registration: { \"warning\": \"competing_write_targets\", ... }\nIn context: actions.add_concept._meta.contested → [\"refine_concept\"]\n\nIn expressions:\n contested(actions) → list of contested action IDs\n size(actions.my_action._meta.contested) > 0 → is this action contested?\n\n## Resolving\n\nExtend: write to different keys, aggregate with a view.\nNegotiate: send a directed message explaining intent.\nYield: delete your action if theirs is better.\n\nContention clears when overlap resolves.\n`,\n\n directed_messages: `# Directed messages\n\nMessages can be attention-routed with the \"to\" field.\nDirected messages are NOT private — everyone sees them.\n\"to\" means \"this is for you\" not \"only you can see this\".\n\n## Sending\n\n _send_message({ to: \"agent-id\", kind: \"negotiation\", body: \"...\" })\n\n## Waiting\n\n sync_wait({ room, condition: \"messages.directed_unread > 0\" })\n\n## The negotiation loop\n\n1. See contention (actions._meta.contested, or contested(actions))\n2. Read the other agent's views/objective\n3. Send directed message\n4. Wait for response\n5. Iterate → one yields or both agree on a synthesis\n`,\n\n if_version: `# if_version — proof-of-read writes\n\nEvery state entry has:\n revision — integer write count\n version — content hash (SHA-256, 16 hex)\n\nSupply the current version hash in a write to prove you've read the current value:\n\n invoke set({ key: \"phase\", value: \"active\", if_version: \"486ea46224d1bb4f\" })\n\nIf changed since your read: { \"error\": \"version_conflict\", \"current\": { ... } }\n\nUse if_version: \"\" to assert the key must not exist yet (first-write guarantee).\n\nIn v9, the version hash is available in _meta:\n state._shared.phase._meta — includes revision for the write count\n The version hash itself is the content hash of the stored value.\n`,\n};\n","createdAt",["D",1773738449830],"branchVersion","branchId","93e21602-0ebb-11f1-a6cd-42dde27851f2","id","93e19588-0ebb-11f1-a6cd-42dde27851f2","sync",["D",1771633422787],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Agent collaboration layer https://sync.parc.land","imageUrl","21f2e37e-8066-4730-9dc7-d27cf8d3c9f3","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"orgId","0630d977-f678-453e-926c-52043293f59f","tursoName","93e195880ebb11f1a6cd42dde27851f2","tursoHostname","93e195880ebb11f1a6cd42dde27851f2-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789531243171],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_97":96,"_104":100},"org",{"_97":96,"_98":-5,"_99":100,"_18":55,"_101":102,"_103":25},"branch",{"_13":14,"_32":87,"_43":42,"_88":44,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":45,"_95":96},"isOwned","main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","c15r","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb2RJNlc1czZ1NlpZRmoxdGJ2eFVNNVhmeTYifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":1505,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":1506,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":1507,"_82":1508,"_84":1509,"_86":25},"tree",[452,455,458,472,524,538,549,561,564,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581,582,583,584,585,586,587,588,589,590,591,592,593,594,595,596,597],"files",[452,453,454,455,456,457,458,459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476,477,478,479,480,481,482,483,484,485,486,487,488,489,490,491,492,493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510,511,512,513,514,515,516,517,518,519,520,521,522,523,524,525,526,527,528,529,530,531,532,533,534,535,536,537,538,539,540,541,542,543,544,545,546,547,548,549,550,551,552,553,554,555,556,557,558,559,560,561,562,563,564,565,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581,582,583,584,585,586,587,588,589,590,591,592,593,594,595,596,597],"counts",{"_441":178,"_442":443,"_444":178,"_445":446,"_447":448},"contents",[130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{"_128":129},"ab4f0c14-0ebb-11f1-8d13-42dde27851f2","sync.parc.land",{"_43":435,"_32":436,"_30":437,"_174":-5,"_41":42,"_40":438,"_176":123,"_38":439,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":440},{"_43":429,"_32":430,"_30":431,"_174":-5,"_41":42,"_40":432,"_176":123,"_38":433,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":434},{"_43":423,"_32":424,"_30":425,"_174":-5,"_41":42,"_40":426,"_176":123,"_38":427,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":428},{"_43":417,"_32":418,"_30":419,"_174":-5,"_41":42,"_40":420,"_176":123,"_38":421,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":422},{"_43":411,"_32":412,"_30":413,"_174":-5,"_41":42,"_40":414,"_176":123,"_38":415,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":416},{"_43":405,"_32":406,"_30":407,"_174":-5,"_41":42,"_40":408,"_176":123,"_38":409,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":410},{"_43":399,"_32":400,"_30":401,"_174":-5,"_41":42,"_40":402,"_176":123,"_38":403,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":404},{"_43":393,"_32":394,"_30":395,"_174":-5,"_41":42,"_40":396,"_176":123,"_38":397,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":398},{"_43":386,"_32":387,"_30":388,"_174":-5,"_41":42,"_40":389,"_176":123,"_38":390,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_27":392},{"_43":380,"_32":381,"_30":382,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":383,"_13":178,"_33":20,"_35":384,"_24":25,"_180":-5,"_27":385},{"_43":373,"_32":374,"_30":375,"_174":-5,"_41":42,"_40":376,"_176":123,"_38":377,"_13":178,"_33":20,"_35":378,"_24":25,"_180":-5,"_27":379},{"_43":367,"_32":368,"_30":369,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":370,"_13":178,"_33":20,"_35":371,"_24":25,"_180":-5,"_27":372},{"_43":360,"_32":361,"_30":362,"_174":-5,"_41":42,"_40":363,"_176":123,"_38":364,"_13":210,"_33":20,"_35":365,"_24":25,"_180":-5,"_27":366},{"_43":353,"_32":354,"_30":355,"_174":-5,"_41":42,"_40":356,"_176":123,"_38":357,"_13":187,"_33":20,"_35":358,"_24":25,"_180":-5,"_27":359},{"_43":346,"_32":347,"_30":348,"_174":-5,"_41":42,"_40":349,"_176":123,"_38":350,"_13":178,"_33":20,"_35":351,"_24":25,"_180":-5,"_27":352},{"_43":339,"_32":340,"_30":341,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":342,"_13":343,"_33":20,"_35":344,"_24":25,"_180":-5,"_27":345},{"_43":333,"_32":334,"_30":335,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":336,"_13":285,"_33":34,"_35":337,"_24":25,"_180":-5,"_27":338},{"_43":327,"_32":328,"_30":329,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":330,"_13":61,"_33":34,"_35":331,"_24":25,"_180":-5,"_27":332},{"_43":321,"_32":322,"_30":323,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":324,"_13":61,"_33":34,"_35":325,"_24":25,"_180":-5,"_27":326},{"_43":314,"_32":315,"_30":316,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":317,"_13":318,"_33":34,"_35":319,"_24":25,"_180":-5,"_27":320},{"_43":307,"_32":308,"_30":309,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":310,"_13":311,"_33":34,"_35":312,"_24":25,"_180":-5,"_27":313},{"_43":301,"_32":302,"_30":303,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":304,"_13":187,"_33":34,"_35":305,"_24":25,"_180":-5,"_27":306},{"_43":294,"_32":295,"_30":296,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":298,"_13":178,"_33":20,"_35":299,"_24":25,"_180":-5,"_27":300},{"_43":288,"_32":289,"_30":290,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":291,"_13":178,"_33":34,"_35":292,"_24":25,"_180":-5,"_27":293},{"_43":280,"_32":281,"_30":282,"_174":-5,"_41":42,"_40":283,"_176":123,"_38":284,"_13":285,"_33":34,"_35":286,"_24":25,"_180":-5,"_27":287},{"_43":277,"_32":28,"_30":31,"_174":-5,"_41":42,"_40":14,"_176":123,"_38":278,"_13":210,"_33":34,"_35":37,"_24":25,"_180":-5,"_27":279},{"_43":270,"_32":271,"_30":272,"_174":-5,"_41":42,"_40":273,"_176":123,"_38":274,"_13":210,"_33":34,"_35":275,"_24":25,"_180":-5,"_27":276},{"_43":263,"_32":264,"_30":128,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":265,"_13":266,"_33":267,"_35":268,"_24":25,"_180":-5,"_27":269},{"_43":257,"_32":258,"_30":259,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":260,"_13":178,"_33":34,"_35":261,"_24":25,"_180":-5,"_27":262},{"_43":251,"_32":252,"_30":253,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":254,"_13":61,"_33":34,"_35":255,"_24":25,"_180":-5,"_27":256},{"_43":245,"_32":246,"_30":247,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":248,"_13":187,"_33":34,"_35":249,"_24":25,"_180":-5,"_27":250},{"_43":239,"_32":240,"_30":241,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":242,"_13":210,"_33":34,"_35":243,"_24":25,"_180":-5,"_27":244},{"_43":233,"_32":234,"_30":235,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":236,"_13":178,"_33":34,"_35":237,"_24":25,"_180":-5,"_27":238},{"_43":226,"_32":227,"_30":228,"_174":-5,"_41":42,"_40":229,"_176":123,"_38":230,"_13":178,"_33":34,"_35":231,"_24":25,"_180":-5,"_27":232},{"_43":220,"_32":221,"_30":222,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":223,"_13":178,"_33":34,"_35":224,"_24":25,"_180":-5,"_27":225},{"_43":213,"_32":214,"_30":215,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":216,"_13":217,"_33":34,"_35":218,"_24":25,"_180":-5,"_27":219},{"_43":205,"_32":206,"_30":207,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":209,"_13":210,"_33":34,"_35":211,"_24":25,"_180":-5,"_27":212},{"_43":197,"_32":198,"_30":199,"_174":-5,"_41":42,"_40":200,"_176":123,"_38":201,"_13":202,"_33":34,"_35":203,"_24":25,"_180":-5,"_27":204},{"_43":190,"_32":191,"_30":192,"_174":-5,"_41":42,"_40":193,"_176":123,"_38":194,"_13":178,"_33":34,"_35":195,"_24":25,"_180":-5,"_27":196},{"_43":182,"_32":183,"_30":184,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":186,"_13":187,"_33":34,"_35":188,"_24":25,"_180":-5,"_27":189},{"_43":171,"_32":172,"_30":173,"_174":-5,"_41":42,"_40":175,"_176":123,"_38":177,"_13":178,"_33":34,"_35":179,"_24":25,"_180":-5,"_27":181},"debcc940-1ad9-11f1-b21b-42dde27851f2","wait.ts","debcc9c2-1ad9-11f1-b21b-42dde27851f2","parentId",417,"latest",["D",1772965847190],0,"/**\n * wait.ts — Long-poll condition waiting.\n *\n * Blocks until a CEL expression becomes true against room state,\n * then returns the current context. Used by /rooms/:id/wait endpoint.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, sleep } from \"./utils.ts\";\nimport { buildContext, evalCel, validateCel } from \"./cel.ts\";\nimport { buildExpandedContext, parseContextRequest, type ContextRequest } from \"./context.ts\";\nimport type { AuthResult } from \"./auth.ts\";\n\nconst MAX_WAIT_MS = 25_000;\nconst POLL_INTERVAL_MS = 1_000;\n\nasync function buildIncludeData(roomId: string, includeParam: string | null, ctx: Record) {\n const data: Record = {};\n if (!includeParam) return data;\n const includes = includeParam.split(\",\");\n for (const inc of includes) {\n const trimmed = inc.trim();\n if (trimmed === \"state\" || trimmed.startsWith(\"state.\")) {\n const scope = trimmed === \"state\" ? null : trimmed.slice(6);\n data.state = scope ? (ctx.state?.[scope] ?? {}) : ctx.state;\n }\n if (trimmed === \"agents\") data.agents = ctx.agents;\n if (trimmed === \"messages\") data.messages = ctx.messages;\n if (trimmed === \"actions\") data.actions = ctx.actions;\n if (trimmed === \"views\") data.views = ctx.views;\n }\n return data;\n}\n\nexport async function waitForCondition(roomId: string, url: URL, auth: AuthResult) {\n const condition = url.searchParams.get(\"condition\");\n const agent = url.searchParams.get(\"agent\") ?? auth.agentId;\n const timeoutParam = url.searchParams.get(\"timeout\");\n const includeParam = url.searchParams.get(\"include\");\n if (!condition) return json({ error: \"condition parameter is required (CEL expression)\" }, 400);\n const validation = validateCel(condition);\n if (!validation.valid) return json({ error: \"invalid_cel\", expression: condition, detail: validation.error }, 400);\n const timeout = Math.min(timeoutParam ? parseInt(timeoutParam) : MAX_WAIT_MS, MAX_WAIT_MS);\n\n // include=context (or no include param) returns full context object\n const wantFullContext = !includeParam || includeParam === \"context\";\n\n // Parse ContextRequest from URL (wait inherits all context shaping params)\n const ctxReq = parseContextRequest(url);\n\n if (agent) {\n await sqlite.execute({\n sql: `UPDATE agents SET status = 'waiting', waiting_on = ?, last_heartbeat = datetime('now') WHERE id = ? AND room_id = ?`,\n args: [condition, agent, roomId],\n });\n }\n\n const startTime = Date.now();\n try {\n while (Date.now() - startTime < timeout) {\n const ctx = await buildContext(roomId, { selfAgent: agent ?? undefined });\n const result = await evalCel(roomId, condition, ctx);\n if (result.ok && result.value) {\n if (agent) {\n await sqlite.execute({\n sql: `UPDATE agents SET status = 'active', waiting_on = NULL, last_heartbeat = datetime('now') WHERE id = ? AND room_id = ?`,\n args: [agent, roomId],\n });\n }\n if (wantFullContext) {\n const expanded = await buildExpandedContext(roomId, auth, ctxReq);\n return json({ triggered: true, condition, context: expanded });\n }\n const includeData = await buildIncludeData(roomId, includeParam, ctx);\n return json({ triggered: true, condition, value: result.value, ...includeData });\n }\n await sleep(POLL_INTERVAL_MS);\n }\n if (agent) {\n await sqlite.execute({\n sql: `UPDATE agents SET status = 'active', waiting_on = NULL, last_heartbeat = datetime('now') WHERE id = ? AND room_id = ?`,\n args: [agent, roomId],\n });\n }\n if (wantFullContext) {\n const expanded = await buildExpandedContext(roomId, auth, ctxReq);\n return json({ triggered: false, timeout: true, elapsed_ms: Date.now() - startTime, context: expanded });\n }\n const ctx = await buildContext(roomId, { selfAgent: agent ?? undefined });\n const includeData = await buildIncludeData(roomId, includeParam, ctx);\n return json({ triggered: false, timeout: true, elapsed_ms: Date.now() - startTime, ...includeData });\n } catch (e) {\n if (agent) {\n try { await sqlite.execute({ sql: `UPDATE agents SET status = 'active', waiting_on = NULL WHERE id = ? AND room_id = ?`, args: [agent, roomId] }); } catch {}\n }\n throw e;\n }\n}\n","label",[172],"89c8fd1c-2198-11f1-9238-42dde27851f2","views.ts","debcabea-1ad9-11f1-b21b-42dde27851f2",634,["D",1773707445460],2,"/**\n * views.ts — View registration and deletion.\n *\n * v9: Uses Environment-based CEL evaluation (celEval) and rich validation\n * (validateExpression) with lint warnings for old-style patterns.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport { validateCel, validateExpression, celEval, buildContext, buildViewContext } from \"./cel.ts\";\nimport { parseTimer, validateTimer } from \"./timers.ts\";\nimport { appendStructuralEvent } from \"./audit.ts\";\nimport { extractDependencies } from \"./deps.ts\";\nimport type { AuthResult } from \"./auth.ts\";\n\nexport async function registerView(roomId: string, body: any, auth: AuthResult) {\n const id = body.id;\n if (!id) return json({ error: \"id is required\" }, 400);\n if (!body.expr) return json({ error: \"expr is required\" }, 400);\n const scope = body.scope ?? \"_shared\";\n\n // Scope ownership enforcement\n if (scope !== \"_shared\") {\n if (!auth.authenticated) return json({ error: \"authentication_required\" }, 401);\n if (auth.kind !== \"room\" && !auth.grants.includes(\"*\") && auth.agentId !== scope) {\n return json({ error: \"identity_mismatch\", message: `view scope \"${scope}\" requires authentication as \"${scope}\"` }, 403);\n }\n }\n\n // Validate expression with full pipeline\n const exprValidation = validateExpression(body.expr);\n if (!exprValidation.valid) {\n return json({\n error: \"invalid_cel\",\n field: \"expr\",\n stage: exprValidation.stage,\n detail: exprValidation.error,\n hint: exprValidation.hint,\n source: exprValidation.source,\n help: exprValidation.help ?? \"expressions\",\n }, 400);\n }\n\n if (body.enabled) {\n const enabledValidation = validateExpression(body.enabled);\n if (!enabledValidation.valid) {\n return json({\n error: \"invalid_cel\",\n field: \"enabled\",\n stage: enabledValidation.stage,\n detail: enabledValidation.error,\n hint: enabledValidation.hint,\n source: enabledValidation.source,\n help: enabledValidation.help ?? \"expressions\",\n }, 400);\n }\n }\n\n if (body.timer) {\n const tv = validateTimer(body.timer);\n if (!tv.valid) return json({ error: \"invalid_timer\", detail: tv.error }, 400);\n }\n\n const registeredBy = scope !== \"_shared\" ? scope : (body.registered_by ?? (auth.authenticated ? auth.agentId : null));\n\n // Extract CEL dependencies at registration time\n let deps: any[] = [];\n try {\n deps = extractDependencies(body.expr);\n } catch { /* non-fatal */ }\n\n // Write to _views scope\n const viewStateValue = JSON.stringify({\n expr: body.expr,\n description: body.description ?? null,\n enabled: body.enabled ?? null,\n render: body.render ?? null,\n scope,\n registered_by: registeredBy,\n timer: body.timer ?? null,\n deps,\n });\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, id, viewStateValue],\n });\n\n // Evaluate current value using Environment\n const ctx = await buildContext(roomId, { selfAgent: auth.agentId ?? undefined });\n const viewCtx = await buildViewContext(roomId, scope, ctx);\n let resolvedValue: any = null;\n try {\n const evalResult = celEval(body.expr, viewCtx);\n resolvedValue = typeof evalResult === \"bigint\" ? Number(evalResult) : evalResult;\n } catch (e: any) {\n resolvedValue = { _error: e.message };\n }\n\n appendStructuralEvent(roomId, \"register_view\", auth.authenticated ? auth.agentId ?? null : null, {\n id, scope, description: body.description ?? null,\n expr: body.expr, enabled_expr: body.enabled ?? null,\n render: body.render ?? null, deps,\n }).catch(() => {});\n\n const response: any = {\n id, room_id: roomId, scope, description: body.description ?? null,\n expr: body.expr, enabled: body.enabled ?? null,\n render: body.render ?? null,\n registered_by: registeredBy,\n value: resolvedValue, deps,\n };\n\n // Include lint warnings if any\n const allWarnings = [\n ...(exprValidation.warnings ?? []),\n ];\n if (allWarnings.length > 0) {\n response.warnings = allWarnings;\n }\n\n return json(response, 201);\n}\n\nexport async function deleteView(roomId: string, viewId: string, auth: AuthResult) {\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_views' AND key = ?`,\n args: [roomId, viewId],\n });\n if (existing.rows.length === 0) return json({ error: \"view not found\" }, 404);\n let def: any = {};\n try { def = JSON.parse(existing.rows[0][0] as string); } catch {}\n const scope = def.scope ?? \"_shared\";\n if (scope !== \"_shared\") {\n if (auth.kind !== \"room\" && !auth.grants.includes(\"*\") && auth.agentId !== scope) {\n return json({ error: \"view_owned\", message: `view \"${viewId}\" owned by \"${scope}\"` }, 403);\n }\n }\n await sqlite.execute({ sql: `DELETE FROM state WHERE room_id = ? AND scope = '_views' AND key = ?`, args: [roomId, viewId] });\n appendStructuralEvent(roomId, \"delete_view\", auth.authenticated ? auth.agentId ?? null : null, { id: viewId }).catch(() => {});\n return json({ deleted: true, id: viewId });\n}\n",[183],"24f36b42-1960-11f1-881e-42dde27851f2","utils.ts","24f36c14-1960-11f1-881e-42dde27851f2",271,["D",1772803615260],"/**\n * utils.ts — shared HTTP and data utilities for sync.\n *\n * Pure functions with no internal dependencies. Used by main.ts, invoke.ts,\n * context.ts, and any other module that needs JSON responses, SQLite row\n * formatting, template substitution, or content hashing.\n */\n\n/** JSON response with CORS headers. */\nexport function json(data: any, status = 200) {\n return new Response(JSON.stringify(data), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET,POST,PUT,PATCH,DELETE,OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type,Authorization\",\n },\n });\n}\n\n/** Convert SQLite result rows to objects using column names. */\nexport function rows2objects(result: any) {\n return result.rows.map((row: any[]) =>\n Object.fromEntries(result.columns.map((col: string, i: number) => [col, row[i]]))\n );\n}\n\n/** Sentinel for failed JSON parsing. */\nexport const PARSE_FAILED = Symbol(\"parse_failed\");\n\n/** Parse request body as JSON. Returns {} for empty bodies, PARSE_FAILED for invalid JSON. */\nexport async function parseBody(req: Request) {\n const text = await req.text();\n if (!text || text.trim() === \"\") return {};\n try { return JSON.parse(text); } catch { return PARSE_FAILED; }\n}\n\n/** Promise-based delay. */\nexport const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\n/** Compute a 16-hex-char SHA-256 content hash of a string value.\n * This is the v6 `version` field — unforgeable proof-of-read for if_version writes.\n * Agents cannot supply a correct hash without having fetched the current value. */\nexport async function contentHash(value: string): Promise {\n const data = new TextEncoder().encode(value);\n const buf = await crypto.subtle.digest(\"SHA-256\", data);\n return Array.from(new Uint8Array(buf))\n .slice(0, 8)\n .map(b => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n}\n\n/** Deep substitute ${params.x}, ${self}, and ${now} in any value.\n * Single-pass: param values containing ${self} or ${now} are NOT re-expanded.\n * Timestamp is computed once per call and shared across the entire tree. */\nexport function deepSubstitute(value: any, params: Record, self: string, _ts?: string): any {\n if (typeof value === \"string\") {\n if (!value.includes(\"${\")) return value;\n const ts = _ts ?? new Date().toISOString();\n return value.replace(/\\$\\{(params\\.(\\w+)|self|now)\\}/g, (match: string, full: string, paramName: string) => {\n if (paramName !== undefined) return String(params[paramName] ?? \"\");\n if (full === \"self\") return self;\n if (full === \"now\") return ts;\n return match;\n });\n }\n if (Array.isArray(value)) {\n const ts = _ts ?? new Date().toISOString();\n return value.map(v => deepSubstitute(v, params, self, ts));\n }\n if (value !== null && typeof value === \"object\") {\n const ts = _ts ?? new Date().toISOString();\n const out: Record = {};\n for (const [k, v] of Object.entries(value)) {\n const rk = k.includes(\"${\") ? deepSubstitute(k, params, self, ts) as string : k;\n out[rk] = deepSubstitute(v, params, self, ts);\n }\n return out;\n }\n return value;\n}\n\n/** Deep-merge source into target. Objects merge recursively; arrays and\n * primitives in source overwrite target. null in source explicitly deletes\n * the key (set to null). */\nexport function deepMerge(target: any, source: any): any {\n if (source === null || source === undefined) return source;\n if (typeof target !== \"object\" || typeof source !== \"object\"\n || Array.isArray(target) || Array.isArray(source)\n || target === null) {\n return source;\n }\n const out: Record = { ...target };\n for (const [k, v] of Object.entries(source)) {\n if (v === null) { out[k] = null; continue; }\n out[k] = (k in out && typeof out[k] === \"object\" && !Array.isArray(out[k]) && out[k] !== null)\n ? deepMerge(out[k], v)\n : v;\n }\n return out;\n}\n\n/** Recursively strip null/undefined values from an object (for ?compact=true). */\nexport function stripNulls(data: any): any {\n if (data === null || data === undefined) return undefined;\n if (Array.isArray(data)) return data.map(stripNulls);\n if (typeof data === \"object\") {\n const out: Record = {};\n for (const [k, v] of Object.entries(data)) {\n if (v !== null && v !== undefined) out[k] = stripNulls(v);\n }\n return out;\n }\n return data;\n}\n",[191],"e854bd6a-1e70-11f1-9d26-42dde27851f2","tokens.ts","ba200440-1df3-11f1-a2c2-42dde27851f2",556,["D",1773360570812],6,"/**\n * tokens.ts — Token management HTTP endpoints.\n *\n * POST /tokens — Mint a scoped token (delegation, view, agent-bound)\n * GET /tokens — List your minted tokens\n * DELETE /tokens/:id — Revoke a token\n * PATCH /tokens/:id — Update a token's scope (bounded by caller's scope)\n * POST /tokens/refresh — Refresh a token (exchange refresh_token for new access_token)\n *\n * All endpoints require a valid tok_ or smcp_at_ token in Authorization header\n * (except refresh which uses the refresh_token in the body).\n *\n * SECURITY: Minted/patched tokens cannot exceed the calling token's scope.\n * A narrow token cannot mint a wide one (no privilege escalation).\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport * as db from \"./mcp/db.ts\";\nimport { hashTokenB64 } from \"./auth.ts\";\nimport {\n parseScope, serializeScope, matchRoom, roleToLevel, minLevel,\n scopeSubsumes, type ParsedScope,\n} from \"./mcp/scope.ts\";\nimport { json, rows2objects } from \"./utils.ts\";\n\n// ─── Caller resolution ──────────────────────────────────────────\n\ninterface CallerInfo {\n userId: string;\n /** Parsed scope of the calling token. null = unrestricted (legacy smcp_at_ or session). */\n scope: ParsedScope | null;\n}\n\n/**\n * Resolve the calling user + their token's scope from a bearer token.\n * Returns null if unauthenticated.\n */\nasync function resolveCaller(req: Request): Promise {\n const header = req.headers.get(\"Authorization\");\n if (!header?.startsWith(\"Bearer \")) return null;\n const token = header.slice(7);\n\n // Check unified tokens table\n const hash = await hashTokenB64(token);\n const tok = await db.validateTokenByHash(hash);\n if (tok) {\n return { userId: tok.mintedBy, scope: parseScope(tok.scope) };\n }\n\n // Fallback: check smcp_access_tokens for backward compat\n // Legacy tokens have no structured scope — treat as unrestricted\n if (token.startsWith(\"smcp_at_\")) {\n const res = await sqlite.execute({\n sql: `SELECT user_id FROM smcp_access_tokens WHERE token = ? AND expires_at > datetime('now')`,\n args: [token],\n });\n if (res.rows.length > 0) {\n return { userId: res.rows[0][0] as string, scope: null };\n }\n }\n\n return null;\n}\n\n// ─── Shared validation ──────────────────────────────────────────\n\n/**\n * Validate that a requested scope is within bounds:\n * 1. User must have access to all rooms (user_rooms check)\n * 2. New scope must not exceed calling token's scope (subsumption check)\n */\nasync function validateScope(\n userId: string,\n callerScope: ParsedScope | null,\n requestedScope: string,\n): Promise {\n const parsed = parseScope(requestedScope);\n\n // Check 1: user_rooms — user must actually have access to named rooms\n for (const [rId] of parsed.rooms) {\n const userRoom = await sqlite.execute({\n sql: `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?`,\n args: [userId, rId],\n });\n if (userRoom.rows.length === 0) {\n return json({\n error: \"scope_exceeds_access\",\n message: `You don't have access to room \"${rId}\"`,\n room: rId,\n }, 403);\n }\n }\n\n // Check 2: token subsumption — new scope ≤ caller's scope\n if (callerScope) {\n const check = scopeSubsumes(callerScope, parsed);\n if (!check.ok) {\n return json({\n error: \"scope_exceeds_token\",\n message: check.reason,\n hint: \"A token cannot grant more access than it has itself.\",\n }, 403);\n }\n }\n // callerScope === null means legacy/unrestricted — skip subsumption\n\n return null; // all good\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /tokens — Mint a scoped token\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleMintToken(req: Request): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n const body = await req.json();\n const scope = body.scope;\n if (!scope || typeof scope !== \"string\") {\n return json({ error: \"scope is required (e.g., 'rooms:my-room:agent:alice')\" }, 400);\n }\n\n const label = body.label ?? null;\n const expiresIn = body.expires_in ?? null;\n const roomId = body.room_id ?? null;\n const agentId = body.agent_id ?? null;\n\n // Validate scope against user access AND calling token\n const scopeError = await validateScope(caller.userId, caller.scope, scope);\n if (scopeError) return scopeError;\n\n // Validate: if agent-bound, the agent must exist\n const parsed = parseScope(scope);\n const agentBound = agentId ?? (() => {\n for (const [, rs] of parsed.rooms) {\n if (rs.agent) return rs.agent;\n }\n return null;\n })();\n if (agentBound && roomId) {\n const agentCheck = await sqlite.execute({\n sql: `SELECT id FROM agents WHERE id = ? AND room_id = ?`,\n args: [agentBound, roomId],\n });\n if (agentCheck.rows.length === 0) {\n return json({\n error: \"agent_not_found\",\n message: `Agent \"${agentBound}\" not found in room \"${roomId}\"`,\n }, 404);\n }\n }\n\n const result = await db.mintToken({\n userId: caller.userId,\n scope,\n label,\n roomId,\n agentId: agentBound,\n expiresInSec: expiresIn ?? undefined,\n withRefresh: !!body.with_refresh,\n });\n\n return json({\n id: result.id,\n token: result.token,\n refresh_token: result.refreshToken ?? undefined,\n scope,\n label,\n room_id: roomId,\n agent_id: agentBound,\n expires_at: result.expiresAt,\n }, 201);\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// GET /tokens — List your minted tokens\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleListTokens(req: Request): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n const tokens = await db.listUserTokens(caller.userId);\n\n return json({\n tokens: tokens.map(t => ({\n id: t.id,\n scope: t.scope,\n label: t.label,\n room_id: t.roomId,\n agent_id: t.agentId,\n client_id: t.clientId,\n revoked: t.revoked,\n expires_at: t.expiresAt,\n created_at: t.createdAt,\n })),\n });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// DELETE /tokens/:id — Revoke a token\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleRevokeToken(req: Request, tokenId: string): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n const ok = await db.revokeToken(tokenId, caller.userId);\n if (!ok) return json({ error: \"not_found\", message: \"Token not found or not owned by you\" }, 404);\n\n return json({ revoked: true, id: tokenId });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// PATCH /tokens/:id — Update a token's scope (bounded by caller's scope)\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleUpdateToken(req: Request, tokenId: string): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n const body = await req.json();\n const newScope = body.scope;\n if (!newScope || typeof newScope !== \"string\") {\n return json({ error: \"scope is required\" }, 400);\n }\n\n // Fetch the existing token — must be owned by caller\n const existing = await sqlite.execute({\n sql: `SELECT id, scope, label, minted_by, revoked FROM tokens WHERE id = ? AND minted_by = ?`,\n args: [tokenId, caller.userId],\n });\n if (existing.rows.length === 0) {\n return json({ error: \"not_found\", message: \"Token not found or not owned by you\" }, 404);\n }\n if (existing.rows[0][4] === 1) {\n return json({ error: \"token_revoked\", message: \"Cannot update a revoked token\" }, 409);\n }\n\n const oldScope = existing.rows[0][1] as string;\n\n // Validate new scope against user access AND calling token\n const scopeError = await validateScope(caller.userId, caller.scope, newScope);\n if (scopeError) return scopeError;\n\n // Update the scope\n await sqlite.execute({\n sql: `UPDATE tokens SET scope = ? WHERE id = ?`,\n args: [newScope, tokenId],\n });\n\n // Optionally update label\n if (body.label !== undefined) {\n await sqlite.execute({\n sql: `UPDATE tokens SET label = ? WHERE id = ?`,\n args: [body.label, tokenId],\n });\n }\n\n return json({\n id: tokenId,\n scope: newScope,\n label: body.label ?? existing.rows[0][2],\n previous_scope: oldScope,\n });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /tokens/refresh — Exchange refresh_token for new access_token\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleRefreshToken(req: Request): Promise {\n let body: Record;\n const contentType = req.headers.get(\"content-type\") ?? \"\";\n if (contentType.includes(\"application/x-www-form-urlencoded\")) {\n const text = await req.text();\n body = Object.fromEntries(new URLSearchParams(text));\n } else {\n body = await req.json();\n }\n\n const refreshToken = body.refresh_token;\n if (!refreshToken) {\n return json({ error: \"invalid_request\", error_description: \"refresh_token required\" }, 400);\n }\n\n const refreshHash = await hashTokenB64(refreshToken);\n const result = await db.refreshUnifiedToken(refreshHash);\n if (!result) {\n return json({ error: \"invalid_grant\", error_description: \"Invalid or expired refresh token\" }, 400);\n }\n\n return json({\n access_token: result.token,\n token_type: \"Bearer\",\n expires_in: 3600,\n refresh_token: result.refreshToken,\n });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /rooms/:id/invite — Invite a user to a room\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleInvite(req: Request, roomId: string, body?: any): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n // Check the caller is an owner\n const callerRoom = await sqlite.execute({\n sql: `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?`,\n args: [caller.userId, roomId],\n });\n if (callerRoom.rows.length === 0 || callerRoom.rows[0][0] !== \"owner\") {\n return json({ error: \"not_owner\", message: \"Only room owners can invite users\" }, 403);\n }\n\n if (!body) body = await req.json();\n const { username, role } = body;\n if (!username) return json({ error: \"username is required\" }, 400);\n\n const validRoles = [\"owner\", \"collaborator\", \"participant\", \"observer\"];\n const targetRole = role ?? \"participant\";\n if (!validRoles.includes(targetRole)) {\n return json({ error: \"invalid_role\", valid: validRoles }, 400);\n }\n\n // Look up user by username\n const targetUser = await db.getUserByUsername(username);\n if (!targetUser) {\n return json({ error: \"user_not_found\", message: `No user with username \"${username}\"` }, 404);\n }\n\n await db.inviteUserToRoom(targetUser.id, roomId, targetRole, caller.userId, body.label);\n\n return json({ invited: true, username, room: roomId, role: targetRole });\n}\n\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /rooms/:id/claim — Claim an orphaned room\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Claim a room that has no owners in user_rooms. This handles rooms\n * created via the HTTP API before unified auth existed (e.g., cartographers).\n *\n * Rules:\n * - If room has NO user_rooms entries: any authenticated user can claim as owner\n * - If room has owners but you have the room_ token: claim as owner\n * - Otherwise: denied\n */\nexport async function handleClaim(req: Request, roomId: string, body?: any): Promise {\n const caller = await resolveCaller(req);\n if (!caller) return json({ error: \"authentication_required\" }, 401);\n\n // Verify room exists\n const roomCheck = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ?`,\n args: [roomId],\n });\n if (roomCheck.rows.length === 0) {\n return json({ error: \"room_not_found\" }, 404);\n }\n\n // Check for existing owners\n const ownerCheck = await sqlite.execute({\n sql: `SELECT user_id FROM smcp_user_rooms WHERE room_id = ?`,\n args: [roomId],\n });\n\n if (ownerCheck.rows.length > 0) {\n // Room already has users — check if caller has the room_ token\n if (!body) try { body = await req.json(); } catch { body = {}; }\n const roomToken = body?.room_token;\n if (!roomToken) {\n return json({\n error: \"already_owned\",\n message: \"Room already has users. Provide room_token to claim, or ask an owner to invite you.\",\n existing_users: ownerCheck.rows.length,\n }, 403);\n }\n // Verify room token\n const { hashToken } = await import(\"./auth.ts\");\n const hash = await hashToken(roomToken);\n const tokenCheck = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ? AND token_hash = ?`,\n args: [roomId, hash],\n });\n if (tokenCheck.rows.length === 0) {\n return json({ error: \"invalid_room_token\" }, 401);\n }\n }\n\n // Claim as owner\n const label = body?.label ?? `Claimed: ${roomId}`;\n await sqlite.execute({\n sql: `INSERT INTO smcp_user_rooms (user_id, room_id, access, label)\n VALUES (?, ?, 'owner', ?)\n ON CONFLICT(user_id, room_id) DO UPDATE SET access = 'owner'`,\n args: [caller.userId, roomId, label],\n });\n\n return json({ claimed: true, room: roomId, role: \"owner\" });\n}\n",[198],"1b968072-2075-11f1-8859-42dde27851f2","timers.ts","57fdc9d8-117c-11f1-a945-42dde27851f2",612,["D",1773582277011],3,"import { sqlite } from \"https://esm.town/v/std/sqlite\";\n\n/**\n * Timer and Enabled utilities for agent-sync.\n *\n * Timer: temporal lifecycle for any resource (state, actions, messages, agents).\n * - Wall-clock: { ms, effect } or { at, effect }\n * - Logical-clock: { ticks, tick_on, effect }\n * - effect: \"delete\" (resource vanishes on expiry) or \"enable\" (dormant until expiry)\n *\n * Enabled: CEL expression gating a resource's participation in live state.\n * - Disabled resources are stored but invisible to reads and CEL contexts.\n */\n\n// ============ Timer parsing and storage ============\n\nexport interface TimerConfig {\n ms?: number;\n at?: string; // ISO datetime\n ticks?: number;\n tick_on?: string; // state key path to watch\n effect: \"delete\" | \"enable\";\n}\n\nexport interface TimerColumns {\n timer_json: string | null;\n timer_expires_at: string | null;\n timer_ticks_left: number | null;\n timer_tick_on: string | null;\n timer_effect: string | null;\n timer_started_at: string | null;\n}\n\n/** Parse a timer config from request body into DB columns */\nexport function parseTimer(timer: TimerConfig | undefined | null): TimerColumns {\n if (!timer) {\n return {\n timer_json: null,\n timer_expires_at: null,\n timer_ticks_left: null,\n timer_tick_on: null,\n timer_effect: null,\n timer_started_at: null,\n };\n }\n\n const now = new Date();\n const cols: TimerColumns = {\n timer_json: JSON.stringify(timer),\n timer_effect: timer.effect,\n timer_started_at: now.toISOString(),\n timer_expires_at: null,\n timer_ticks_left: null,\n timer_tick_on: null,\n };\n\n if (timer.ms !== undefined) {\n cols.timer_expires_at = new Date(now.getTime() + timer.ms).toISOString();\n } else if (timer.at !== undefined) {\n cols.timer_expires_at = new Date(timer.at).toISOString();\n } else if (timer.ticks !== undefined) {\n cols.timer_ticks_left = timer.ticks;\n cols.timer_tick_on = timer.tick_on ?? null;\n }\n\n return cols;\n}\n\n/** Validate timer config from request body */\nexport function validateTimer(timer: any): { valid: true } | { valid: false; error: string } {\n if (!timer || typeof timer !== \"object\") {\n return { valid: false, error: \"timer must be an object\" };\n }\n if (!timer.effect || (timer.effect !== \"delete\" && timer.effect !== \"enable\")) {\n return { valid: false, error: \"timer.effect must be 'delete' or 'enable'\" };\n }\n const hasMs = timer.ms !== undefined;\n const hasAt = timer.at !== undefined;\n const hasTicks = timer.ticks !== undefined;\n const clockCount = [hasMs, hasAt, hasTicks].filter(Boolean).length;\n if (clockCount === 0) {\n return { valid: false, error: \"timer must specify one of: ms, at, ticks\" };\n }\n if (clockCount > 1) {\n return { valid: false, error: \"timer must specify exactly one of: ms, at, ticks\" };\n }\n if (hasMs && (typeof timer.ms !== \"number\" || timer.ms <= 0)) {\n return { valid: false, error: \"timer.ms must be a positive number\" };\n }\n if (hasAt) {\n const d = new Date(timer.at);\n if (isNaN(d.getTime())) {\n return { valid: false, error: \"timer.at must be a valid ISO datetime\" };\n }\n }\n if (hasTicks) {\n if (typeof timer.ticks !== \"number\" || timer.ticks <= 0 || !Number.isInteger(timer.ticks)) {\n return { valid: false, error: \"timer.ticks must be a positive integer\" };\n }\n if (!timer.tick_on || typeof timer.tick_on !== \"string\") {\n return { valid: false, error: \"timer.tick_on is required for logical-clock timers (state key path to watch)\" };\n }\n }\n return { valid: true };\n}\n\n// ============ Timer status evaluation ============\n\nexport type TimerStatus = \"active\" | \"expired\" | \"no_timer\";\n\n/** Check the timer status of a resource row */\nexport function getTimerStatus(row: {\n timer_effect?: string | null;\n timer_expires_at?: string | null;\n timer_ticks_left?: number | null;\n}): TimerStatus {\n if (!row.timer_effect) return \"no_timer\";\n\n // Wall-clock timer\n if (row.timer_expires_at) {\n const expires = new Date(row.timer_expires_at).getTime();\n const now = Date.now();\n return now >= expires ? \"expired\" : \"active\";\n }\n\n // Logical-clock timer\n if (row.timer_ticks_left !== undefined && row.timer_ticks_left !== null) {\n return row.timer_ticks_left <= 0 ? \"expired\" : \"active\";\n }\n\n return \"no_timer\";\n}\n\n/**\n * Determine if a resource is live (visible to reads and CEL) based on its timer.\n *\n * effect=\"delete\": live while timer is active, dead when expired\n * effect=\"enable\": dead while timer is active (dormant), live when expired\n */\nexport function isTimerLive(row: {\n timer_effect?: string | null;\n timer_expires_at?: string | null;\n timer_ticks_left?: number | null;\n}): boolean {\n const status = getTimerStatus(row);\n if (status === \"no_timer\") return true;\n\n if (row.timer_effect === \"delete\") {\n return status === \"active\"; // live until expired\n }\n if (row.timer_effect === \"enable\") {\n return status === \"expired\"; // dormant until expired, then live\n }\n return true;\n}\n\n// ============ Logical clock ticking ============\n\n/**\n * Called after a state key is written. Decrements ticks_remaining for all\n * resources in the room that have tick_on matching the written key path.\n *\n * The key path is \"scope.key\" (e.g., \"_shared.turn\", \"agent-a.score\").\n * tick_on values are matched as stored — agents set them as state key paths\n * like \"state._shared.turn\".\n */\nexport async function tickLogicalTimers(roomId: string, scope: string, key: string): Promise {\n // Match tick_on patterns: \"state.{scope}.{key}\" or just \"{scope}.{key}\"\n const fullPath = `state.${scope}.${key}`;\n const shortPath = `${scope}.${key}`;\n\n // Tick state timers (covers all state entries including _actions, _views scopes)\n await sqlite.execute({\n sql: `UPDATE state SET timer_ticks_left = timer_ticks_left - 1\n WHERE room_id = ? AND timer_tick_on IS NOT NULL AND timer_ticks_left > 0\n AND (timer_tick_on = ? OR timer_tick_on = ?)`,\n args: [roomId, fullPath, shortPath],\n });\n // Note: action/view timers in v8 use the _timer field inside their JSON value,\n // managed by invoke.ts on_invoke cooldown. Logical-clock ticking for action/view\n // timers would need read-modify-write on the JSON value if ever used.\n}\n\n// ============ Timer renewal ============\n\n/** Renew a wall-clock timer (reset expiry from now) */\nexport function renewTimer(timerJson: string | null): { expires_at: string } | null {\n if (!timerJson) return null;\n try {\n const timer = JSON.parse(timerJson);\n if (timer.ms) {\n return { expires_at: new Date(Date.now() + timer.ms).toISOString() };\n }\n } catch {}\n return null;\n}\n",[206],"1b96368a-2075-11f1-8859-42dde27851f2","schema.ts","99b4cf34-0ebb-11f1-be01-42dde27851f2",["D",1773582277011],16,"import { sqlite } from \"https://esm.town/v/std/sqlite\";\n\n/**\n * Schema migration chain.\n *\n * v8: Two primitives — state + log. All domain entities (actions, views, agents)\n * live in state table scopes (_actions, _views, _agents). Legacy entity tables\n * (actions, views, agents) are created for backward compat with existing installs,\n * then dropped after v8 migration runs.\n *\n * Core tables that remain:\n * rooms — room identity + admin/view token hashes\n * state — the substrate (all scopes: _shared, _actions, _views, _agents, _messages, _audit, ...)\n * tokens — unified credential store (room tokens, agent tokens, MCP tokens)\n * smcp_* — MCP auth infrastructure (users, credentials, sessions, etc.)\n * log_index — temporal query index over state audit entries\n */\n\nexport async function migrate() {\n await sqlite.batch([\n // ============ Rooms ============\n {\n sql: `CREATE TABLE IF NOT EXISTS rooms (\n id TEXT PRIMARY KEY,\n created_at TEXT DEFAULT (datetime('now')),\n meta TEXT DEFAULT '{}',\n token_hash TEXT,\n view_token_hash TEXT\n )`,\n args: [],\n },\n\n // ============ Agents ============\n {\n sql: `CREATE TABLE IF NOT EXISTS agents (\n id TEXT NOT NULL,\n room_id TEXT NOT NULL REFERENCES rooms(id),\n name TEXT NOT NULL,\n role TEXT DEFAULT 'agent',\n joined_at TEXT DEFAULT (datetime('now')),\n meta TEXT DEFAULT '{}',\n last_heartbeat TEXT,\n status TEXT DEFAULT 'active',\n waiting_on TEXT,\n token_hash TEXT,\n grants TEXT DEFAULT '[]',\n last_seen_seq INTEGER DEFAULT 0,\n enabled_expr TEXT,\n PRIMARY KEY (id, room_id)\n )`,\n args: [],\n },\n\n // ============ Unified State ============\n {\n sql: `CREATE TABLE IF NOT EXISTS state (\n room_id TEXT NOT NULL,\n scope TEXT NOT NULL,\n key TEXT NOT NULL,\n sort_key INTEGER,\n value TEXT NOT NULL,\n version TEXT DEFAULT '',\n revision INTEGER DEFAULT 1,\n updated_at TEXT DEFAULT (datetime('now')),\n timer_json TEXT,\n timer_expires_at TEXT,\n timer_ticks_left INTEGER,\n timer_tick_on TEXT,\n timer_effect TEXT,\n timer_started_at TEXT,\n enabled_expr TEXT,\n PRIMARY KEY (room_id, scope, key)\n )`,\n args: [],\n },\n\n // ============ Actions ============\n {\n sql: `CREATE TABLE IF NOT EXISTS actions (\n id TEXT NOT NULL,\n room_id TEXT NOT NULL REFERENCES rooms(id),\n scope TEXT DEFAULT '_shared',\n description TEXT,\n if_expr TEXT,\n enabled_expr TEXT,\n result_expr TEXT,\n writes_json TEXT NOT NULL DEFAULT '[]',\n params_json TEXT,\n timer_json TEXT,\n timer_expires_at TEXT,\n timer_ticks_left INTEGER,\n timer_tick_on TEXT,\n timer_effect TEXT,\n timer_started_at TEXT,\n on_invoke_timer_json TEXT,\n registered_by TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n version INTEGER DEFAULT 1,\n PRIMARY KEY (id, room_id)\n )`,\n args: [],\n },\n\n // ============ Views ============\n {\n sql: `CREATE TABLE IF NOT EXISTS views (\n id TEXT NOT NULL,\n room_id TEXT NOT NULL REFERENCES rooms(id),\n scope TEXT DEFAULT '_shared',\n description TEXT,\n expr TEXT NOT NULL,\n enabled_expr TEXT,\n render_json TEXT,\n timer_json TEXT,\n timer_expires_at TEXT,\n timer_ticks_left INTEGER,\n timer_tick_on TEXT,\n timer_effect TEXT,\n timer_started_at TEXT,\n registered_by TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n version INTEGER DEFAULT 1,\n PRIMARY KEY (id, room_id)\n )`,\n args: [],\n },\n ]);\n\n // ============ Indexes ============\n const indexes = [\n `CREATE INDEX IF NOT EXISTS idx_state_scope_sort ON state(room_id, scope, sort_key) WHERE sort_key IS NOT NULL`,\n `CREATE INDEX IF NOT EXISTS idx_state_scope ON state(room_id, scope)`,\n `CREATE INDEX IF NOT EXISTS idx_state_tick_on ON state(room_id, timer_tick_on) WHERE timer_tick_on IS NOT NULL`,\n `CREATE INDEX IF NOT EXISTS idx_actions_room ON actions(room_id)`,\n `CREATE INDEX IF NOT EXISTS idx_actions_tick_on ON actions(room_id, timer_tick_on) WHERE timer_tick_on IS NOT NULL`,\n `CREATE INDEX IF NOT EXISTS idx_views_room ON views(room_id)`,\n `CREATE INDEX IF NOT EXISTS idx_agents_room ON agents(room_id)`,\n ];\n for (const sql of indexes) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n // ============ v4→v5 migration helpers ============\n // Add new columns to existing tables if upgrading from v4\n const addColumn = async (table: string, col: string, typedef: string) => {\n try {\n await sqlite.execute({ sql: `ALTER TABLE ${table} ADD COLUMN ${col} ${typedef}`, args: [] });\n } catch (_) { /* already exists */ }\n };\n\n // Rooms: add token_hash and view_token_hash if missing\n await addColumn(\"rooms\", \"token_hash\", \"TEXT\");\n await addColumn(\"rooms\", \"view_token_hash\", \"TEXT\");\n\n // Agents: add grants and last_seen_seq if missing\n await addColumn(\"agents\", \"grants\", \"TEXT DEFAULT '[]'\");\n await addColumn(\"agents\", \"last_seen_seq\", \"INTEGER DEFAULT 0\");\n await addColumn(\"agents\", \"enabled_expr\", \"TEXT\");\n\n // State: add sort_key if missing\n await addColumn(\"state\", \"sort_key\", \"INTEGER\");\n await addColumn(\"state\", \"timer_json\", \"TEXT\");\n await addColumn(\"state\", \"timer_expires_at\", \"TEXT\");\n await addColumn(\"state\", \"timer_ticks_left\", \"INTEGER\");\n await addColumn(\"state\", \"timer_tick_on\", \"TEXT\");\n await addColumn(\"state\", \"timer_effect\", \"TEXT\");\n await addColumn(\"state\", \"timer_started_at\", \"TEXT\");\n await addColumn(\"state\", \"enabled_expr\", \"TEXT\");\n\n // Actions: add description, scope if missing\n await addColumn(\"actions\", \"scope\", \"TEXT DEFAULT '_shared'\");\n await addColumn(\"actions\", \"description\", \"TEXT\");\n await addColumn(\"actions\", \"result_expr\", \"TEXT\");\n\n // Views table is new — created above. No migration needed.\n\n // ============ v5→v6 migration helpers ============\n // state.version becomes a content hash (TEXT). Add state.revision as sequential integer.\n // The addColumn approach silently fails if version already exists as INTEGER (from v5).\n // Use RENAME COLUMN to fix the affinity on production databases.\n try {\n // If this succeeds, the column was still INTEGER — rename it, add TEXT version, backfill revision\n await sqlite.execute({ sql: `ALTER TABLE state RENAME COLUMN version TO version_v5`, args: [] });\n await sqlite.execute({ sql: `ALTER TABLE state ADD COLUMN version TEXT DEFAULT ''`, args: [] });\n await sqlite.execute({ sql: `ALTER TABLE state ADD COLUMN revision INTEGER DEFAULT 1`, args: [] });\n // Migrate: copy integer version into revision, clear version hash (will be recomputed on next write)\n await sqlite.execute({\n sql: `UPDATE state SET revision = CAST(version_v5 AS INTEGER), version = ''\n WHERE revision IS NULL OR revision <= 1`,\n args: [],\n });\n } catch (_) {\n // Rename failed — either already migrated (version_v5 exists) or fresh install (version TEXT already set).\n // Ensure revision column exists and backfill any stragglers.\n await addColumn(\"state\", \"revision\", \"INTEGER DEFAULT 1\");\n try {\n await sqlite.execute({\n sql: `UPDATE state SET revision = 1, version = ''\n WHERE revision IS NULL OR revision = 0`,\n args: [],\n });\n } catch (_) { /* best-effort */ }\n }\n\n // views.render_json: render hint for surfaces-as-views\n await addColumn(\"views\", \"render_json\", \"TEXT\");\n\n // ============ MCP auth tables (smcp_ prefix) ============\n // v7: Only tables still actively needed. Deprecated tables (smcp_access_tokens,\n // smcp_refresh_tokens, smcp_vault, smcp_user_sessions) are no longer created.\n // They still exist in production for backward compat with active sessions.\n await sqlite.batch([\n { sql: `CREATE TABLE IF NOT EXISTS smcp_users (\n id TEXT PRIMARY KEY,\n username TEXT UNIQUE NOT NULL,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_credentials (\n id TEXT PRIMARY KEY,\n user_id TEXT NOT NULL REFERENCES smcp_users(id),\n public_key BLOB NOT NULL,\n counter INTEGER NOT NULL DEFAULT 0,\n transports TEXT,\n device_type TEXT,\n backed_up INTEGER DEFAULT 0,\n rp_id TEXT,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_challenges (\n id TEXT PRIMARY KEY,\n challenge TEXT NOT NULL,\n user_id TEXT,\n type TEXT NOT NULL,\n expires_at TEXT NOT NULL,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_oauth_clients (\n client_id TEXT PRIMARY KEY,\n client_secret TEXT,\n redirect_uris TEXT NOT NULL,\n client_name TEXT,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_auth_codes (\n code TEXT PRIMARY KEY,\n client_id TEXT NOT NULL,\n user_id TEXT NOT NULL,\n redirect_uri TEXT NOT NULL,\n code_challenge TEXT NOT NULL,\n code_challenge_method TEXT NOT NULL DEFAULT 'S256',\n scope TEXT,\n resource TEXT,\n expires_at TEXT NOT NULL,\n used INTEGER DEFAULT 0\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_sessions (\n id TEXT PRIMARY KEY,\n user_id TEXT NOT NULL,\n expires_at TEXT NOT NULL,\n scope TEXT DEFAULT 'consent',\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_recovery_tokens (\n id TEXT PRIMARY KEY,\n user_id TEXT NOT NULL REFERENCES smcp_users(id),\n token_hash TEXT NOT NULL,\n expires_at TEXT NOT NULL,\n used INTEGER DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`, args: [] },\n ]);\n\n // smcp_ column migrations (for existing installs from separate sync-mcp val)\n await addColumn(\"smcp_credentials\", \"rp_id\", \"TEXT\");\n await addColumn(\"smcp_sessions\", \"scope\", \"TEXT DEFAULT 'consent'\");\n\n // ============ Agency & Identity tables ============\n // These support the user→room→agent identity model for MCP clients.\n // See docs/agency-and-identity.md for the design.\n await sqlite.batch([\n { sql: `CREATE TABLE IF NOT EXISTS smcp_user_rooms (\n user_id TEXT NOT NULL REFERENCES smcp_users(id),\n room_id TEXT NOT NULL,\n access TEXT NOT NULL DEFAULT 'participant',\n is_default INTEGER DEFAULT 0,\n label TEXT,\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (user_id, room_id)\n )`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_embodiments (\n session_hash TEXT NOT NULL,\n room_id TEXT NOT NULL,\n agent_id TEXT NOT NULL,\n embodied_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (session_hash, room_id)\n )`, args: [] },\n ]);\n\n const agencyIndexes = [\n `CREATE INDEX IF NOT EXISTS idx_smcp_user_rooms_user ON smcp_user_rooms(user_id)`,\n `CREATE INDEX IF NOT EXISTS idx_smcp_embodiments_session ON smcp_embodiments(session_hash)`,\n ];\n for (const sql of agencyIndexes) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n // ============ v8: log_index + backfill ============\n const { migrateV8 } = await import(\"./schema-v8.ts\");\n await migrateV8();\n\n // ============ v8: tokens.last_used_at ============\n await addColumn(\"tokens\", \"last_used_at\", \"TEXT\");\n\n // ============ v8: Drop legacy entity tables ============\n // All domain data migrated to state table scopes (_actions, _views, _agents).\n // Agent tokens migrated to unified tokens table.\n // These tables are no longer read or written by any code path.\n const legacyDrops = [\n `DROP TABLE IF EXISTS views`,\n `DROP TABLE IF EXISTS actions`,\n `DROP TABLE IF EXISTS agents`,\n ];\n for (const sql of legacyDrops) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n // Drop orphaned indexes on dropped tables\n const legacyIndexDrops = [\n `DROP INDEX IF EXISTS idx_actions_room`,\n `DROP INDEX IF EXISTS idx_actions_tick_on`,\n `DROP INDEX IF EXISTS idx_views_room`,\n `DROP INDEX IF EXISTS idx_agents_room`,\n ];\n for (const sql of legacyIndexDrops) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n}",[214],"1b8fc598-2075-11f1-8859-42dde27851f2","schema-v8.ts","1b8fc656-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * schema-v8.ts — Two Primitives: state + log.\n *\n * v8 unifies actions, views, and agents into state with reserved scope prefixes.\n * The log (formerly _audit) becomes a first-class table with a key-based index.\n *\n * This migration is additive: existing tables are untouched. The compatibility\n * layer in context assembly reads from scope-based entries when present, falls\n * back to legacy tables when absent. Rooms migrate incrementally.\n *\n * New tables:\n * log_index — key-based index into the audit trail, enabling:\n * - \"what happened to key X?\" queries (temporal projection)\n * - provenance tracing (which agent/action wrote key X?)\n * - dependency-scoped replay (only replay entries touching keys a view depends on)\n *\n * New scope conventions (data in existing `state` table):\n * _actions.{id} — action definitions (replaces `actions` table)\n * _views.{id} — view definitions (replaces `views` table)\n * _agents.{id} — agent presence (replaces semantic cols in `agents` table)\n * _config.{key} — room configuration (replaces _shared._dashboard, etc.)\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\n\nexport async function migrateV8() {\n // ── Log index table ──────────────────────────────────────────────────\n // Maps (room, scope, key) → list of audit sequence numbers that affected that key.\n // Populated on every audit/log append. Enables key-level temporal queries.\n await sqlite.execute({\n sql: `CREATE TABLE IF NOT EXISTS log_index (\n room_id TEXT NOT NULL,\n seq INTEGER NOT NULL,\n scope TEXT NOT NULL,\n key TEXT NOT NULL,\n UNIQUE(room_id, seq, scope, key)\n )`,\n args: [],\n });\n\n const indexes = [\n // Primary lookup: \"what happened to this key?\"\n `CREATE INDEX IF NOT EXISTS idx_li_key ON log_index(room_id, scope, key, seq)`,\n // Secondary: \"what keys were affected at this seq?\"\n `CREATE INDEX IF NOT EXISTS idx_li_seq ON log_index(room_id, seq)`,\n // Prefix queries: \"all events touching _shared.concepts.*\"\n `CREATE INDEX IF NOT EXISTS idx_li_scope ON log_index(room_id, scope)`,\n `CREATE UNIQUE INDEX IF NOT EXISTS idx_li_uniq ON log_index(room_id, seq, scope, key)`,\n ];\n for (const sql of indexes) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n // ── Deduplicate log_index (needed if backfill ran before unique index) ──\n try {\n await sqlite.execute({\n sql: `DELETE FROM log_index WHERE rowid NOT IN (\n SELECT MIN(rowid) FROM log_index GROUP BY room_id, seq, scope, key\n )`,\n args: [],\n });\n } catch { /* best-effort */ }\n\n // ── Backfill log_index from existing _audit entries ──────────────────\n // Walk existing audit entries and populate the index for rooms that\n // already have history. This is idempotent — INSERT OR IGNORE.\n try {\n const auditRows = await sqlite.execute({\n sql: `SELECT room_id, sort_key, value FROM state WHERE scope = '_audit' ORDER BY room_id, sort_key ASC`,\n args: [],\n });\n\n const batch: { sql: string; args: any[] }[] = [];\n for (const row of auditRows.rows) {\n const [roomId, seq, rawValue] = row;\n try {\n const entry = JSON.parse(rawValue as string);\n const writes: Array<{ scope: string; key: string }> = entry.effect?.writes ?? [];\n\n // For structural events, index the target entity\n if (entry.kind === \"register_action\" || entry.kind === \"register_view\" ||\n entry.kind === \"delete_action\" || entry.kind === \"delete_view\") {\n const schema = entry.schema ?? {};\n if (schema.id) {\n const scope = entry.kind.includes(\"action\") ? \"_actions\" : \"_views\";\n batch.push({\n sql: `INSERT OR IGNORE INTO log_index (room_id, seq, scope, key) VALUES (?, ?, ?, ?)`,\n args: [roomId, seq, scope, schema.id],\n });\n }\n }\n\n // For invocations, index each affected key\n for (const w of writes) {\n if (w.scope && w.key) {\n batch.push({\n sql: `INSERT OR IGNORE INTO log_index (room_id, seq, scope, key) VALUES (?, ?, ?, ?)`,\n args: [roomId, seq, w.scope, w.key],\n });\n }\n }\n\n // For agent events, index the agent\n if (entry.kind === \"agent_join\" || entry.kind === \"agent_update\") {\n const schema = entry.schema ?? {};\n if (schema.id) {\n batch.push({\n sql: `INSERT OR IGNORE INTO log_index (room_id, seq, scope, key) VALUES (?, ?, ?, ?)`,\n args: [roomId, seq, \"_agents\", schema.id],\n });\n }\n }\n } catch { /* malformed entry, skip */ }\n }\n\n // Execute in chunks to avoid enormous batch sizes\n const CHUNK = 200;\n for (let i = 0; i < batch.length; i += CHUNK) {\n await sqlite.batch(batch.slice(i, i + CHUNK));\n }\n } catch (e) {\n console.error(\"[v8 migration] backfill error (non-fatal):\", e);\n }\n}\n\n/**\n * Append to the log index. Called from audit.ts on every log entry.\n * Fire-and-forget, never throws.\n */\nexport async function indexLogEntry(\n roomId: string,\n seq: number,\n affectedKeys: Array<{ scope: string; key: string }>,\n) {\n if (affectedKeys.length === 0) return;\n try {\n const batch = affectedKeys.map(({ scope, key }) => ({\n sql: `INSERT OR IGNORE INTO log_index (room_id, seq, scope, key) VALUES (?, ?, ?, ?)`,\n args: [roomId, seq, scope, key] as any[],\n }));\n await sqlite.batch(batch);\n } catch { /* fire and forget */ }\n}\n\n/**\n * Query key history from the log index.\n * Returns audit entries that affected the given key, ordered chronologically.\n */\nexport async function queryKeyHistory(\n roomId: string,\n scope: string,\n key: string,\n opts: { limit?: number; after?: number } = {},\n): Promise> {\n const limit = opts.limit ?? 100;\n let sql = `\n SELECT DISTINCT li.seq, s.value\n FROM log_index li\n JOIN state s ON s.room_id = li.room_id\n AND s.scope = '_audit'\n AND s.sort_key = li.seq\n WHERE li.room_id = ? AND li.scope = ? AND li.key = ?\n `;\n const args: any[] = [roomId, scope, key];\n\n if (opts.after) {\n sql += ` AND li.seq > ?`;\n args.push(opts.after);\n }\n\n sql += ` ORDER BY li.seq ASC LIMIT ?`;\n args.push(limit);\n\n const result = await sqlite.execute({ sql, args });\n return result.rows.map(([seq, rawValue]) => {\n let entry: any = {};\n try { entry = JSON.parse(rawValue as string); } catch {}\n return { seq: seq as number, entry };\n });\n}\n\n/**\n * Query key history by prefix (e.g. all keys matching \"concepts.*\" in _shared).\n * Used for views with prefix-level dependencies.\n */\nexport async function queryPrefixHistory(\n roomId: string,\n scope: string,\n prefix: string,\n opts: { limit?: number; after?: number } = {},\n): Promise> {\n const limit = opts.limit ?? 200;\n let sql = `\n SELECT DISTINCT li.seq, li.key, s.value\n FROM log_index li\n JOIN state s ON s.room_id = li.room_id\n AND s.scope = '_audit'\n AND s.sort_key = li.seq\n WHERE li.room_id = ? AND li.scope = ? AND li.key LIKE ? ESCAPE '\\'\n `;\n const args: any[] = [roomId, scope, prefix.replace(/%/g, '\\\\%').replace(/_/g, '\\\\_') + '%'];\n\n if (opts.after) {\n sql += ` AND li.seq > ?`;\n args.push(opts.after);\n }\n\n sql += ` ORDER BY li.seq ASC LIMIT ?`;\n args.push(limit);\n\n const result = await sqlite.execute({ sql, args });\n return result.rows.map(([seq, key, rawValue]) => {\n let entry: any = {};\n try { entry = JSON.parse(rawValue as string); } catch {}\n return { seq: seq as number, key: key as string, entry };\n });\n}\n",[221],"ba1ff40a-1df3-11f1-a2c2-42dde27851f2","schema-v7.ts","ba1ff4b4-1df3-11f1-a2c2-42dde27851f2",449,["D",1773306806181],"/**\n * schema-v7.ts — Unified auth schema additions (Phase 1).\n *\n * Adds:\n * - `tokens` table: unified token storage (replaces smcp_vault, smcp_access_tokens, etc.)\n * - `device_codes` table: OAuth Device Authorization flow\n *\n * Phase 1 is additive: existing smcp_ tables and token columns are untouched.\n * Old auth paths continue to work. New tokens table operates alongside.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\n\nexport async function migrateUnifiedAuth() {\n await sqlite.batch([\n // ── Unified tokens table ──\n // All minted credentials live here: device auth tokens, OAuth tokens,\n // delegation tokens, read-scoped tokens (view replacements).\n // Scope string determines what the token can do.\n {\n sql: `CREATE TABLE IF NOT EXISTS tokens (\n id TEXT PRIMARY KEY,\n token_hash TEXT NOT NULL UNIQUE,\n refresh_hash TEXT UNIQUE,\n minted_by TEXT NOT NULL,\n scope TEXT NOT NULL DEFAULT 'rooms:*',\n label TEXT,\n room_id TEXT,\n agent_id TEXT,\n client_id TEXT,\n revoked INTEGER DEFAULT 0,\n expires_at TEXT,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`,\n args: [],\n },\n\n // ── Device authorization codes ──\n // RFC 8628: device_code is the secret the CLI polls with,\n // user_code is the short human-readable code shown on approval page.\n {\n sql: `CREATE TABLE IF NOT EXISTS device_codes (\n device_code TEXT PRIMARY KEY,\n user_code TEXT NOT NULL UNIQUE,\n client_id TEXT,\n scope TEXT DEFAULT 'rooms:*',\n status TEXT DEFAULT 'pending',\n approved_by TEXT,\n expires_at TEXT NOT NULL,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`,\n args: [],\n },\n ]);\n\n // Indexes\n const indexes = [\n `CREATE INDEX IF NOT EXISTS idx_tokens_minted_by ON tokens(minted_by)`,\n `CREATE INDEX IF NOT EXISTS idx_tokens_room ON tokens(room_id) WHERE room_id IS NOT NULL`,\n `CREATE INDEX IF NOT EXISTS idx_tokens_refresh ON tokens(refresh_hash) WHERE refresh_hash IS NOT NULL`,\n `CREATE INDEX IF NOT EXISTS idx_device_codes_user ON device_codes(user_code)`,\n ];\n for (const sql of indexes) {\n try { await sqlite.execute({ sql, args: [] }); } catch (_) {}\n }\n\n // Add invited_by to user_rooms if missing\n try {\n await sqlite.execute({\n sql: `ALTER TABLE smcp_user_rooms ADD COLUMN invited_by TEXT`,\n args: [],\n });\n } catch (_) { /* already exists */ }\n}\n",[227],"1b8fa464-2075-11f1-8859-42dde27851f2","sampling.ts","1b8fa522-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * sampling.ts — View value sampling for temporal traces.\n *\n * Records periodic snapshots of view values into the audit log as\n * `kind: \"sample\"` entries. These entries power temporal sparklines\n * and history views on the dashboard.\n *\n * Sampling strategy:\n * - Only views with render.temporal = true are sampled\n * - At most one sample per view per SAMPLE_INTERVAL_MS (60s default)\n * - Sampling is piggybacked on dashboardPoll — no separate cron\n * - Samples are fire-and-forget, never block the poll response\n * - Sample entries are indexed in log_index under scope \"_samples\"\n *\n * Sample log entry shape:\n * { kind: \"sample\", ts, views: { [viewId]: value } }\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { rows2objects } from \"./utils.ts\";\nimport { indexLogEntry } from \"./schema-v8.ts\";\n\nconst SAMPLE_INTERVAL_MS = 60_000; // 1 minute\n\n// In-memory last-sample timestamps per room. Resets on cold start (acceptable).\nconst lastSampleTime = new Map();\n\n/**\n * Record view value samples if enough time has elapsed since the last sample.\n * Called from dashboardPoll after view evaluation.\n *\n * @param roomId - The room to sample\n * @param views - Evaluated views from the poll (with .value and .render)\n */\nexport async function maybeSampleViews(\n roomId: string,\n views: Array<{ id: string; value: any; render: any }>,\n) {\n const now = Date.now();\n const lastTime = lastSampleTime.get(roomId) ?? 0;\n if (now - lastTime < SAMPLE_INTERVAL_MS) return;\n\n // Find temporal views\n const temporalViews = views.filter(v =>\n v.render?.temporal === true &&\n v.value !== undefined &&\n !(v.value && typeof v.value === \"object\" && v.value._error)\n );\n if (temporalViews.length === 0) return;\n\n // Record the sample\n lastSampleTime.set(roomId, now);\n\n try {\n // Get next audit seq\n const seqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = '_audit'`,\n args: [roomId],\n });\n const seq = Number(rows2objects(seqResult)[0]?.next_seq ?? 1);\n\n // Build sample entry\n const sampleValues: Record = {};\n for (const v of temporalViews) {\n sampleValues[v.id] = v.value;\n }\n\n const entry = JSON.stringify({\n ts: new Date().toISOString(),\n kind: \"sample\",\n agent: \"_system\",\n ok: true,\n views: sampleValues,\n });\n\n // Append to audit log\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [roomId, String(seq), seq, entry],\n });\n\n // Index under _samples scope for each sampled view\n const affectedKeys = temporalViews.map(v => ({ scope: \"_samples\", key: v.id }));\n await indexLogEntry(roomId, seq, affectedKeys);\n } catch {\n // Fire and forget — never disrupt the poll\n }\n}\n\n/**\n * Query view value samples from the log.\n * Returns chronologically ordered samples for a specific view.\n */\nexport async function queryViewSamples(\n roomId: string,\n viewId: string,\n opts: { limit?: number; after?: number } = {},\n): Promise> {\n const limit = opts.limit ?? 100;\n let sql = `\n SELECT DISTINCT li.seq, s.value\n FROM log_index li\n JOIN state s ON s.room_id = li.room_id\n AND s.scope = '_audit'\n AND s.sort_key = li.seq\n WHERE li.room_id = ? AND li.scope = '_samples' AND li.key = ?\n `;\n const args: any[] = [roomId, viewId];\n\n if (opts.after) {\n sql += ` AND li.seq > ?`;\n args.push(opts.after);\n }\n\n sql += ` ORDER BY li.seq ASC LIMIT ?`;\n args.push(limit);\n\n const result = await sqlite.execute({ sql, args });\n return result.rows.map(([seq, rawValue]) => {\n let entry: any = {};\n try { entry = JSON.parse(rawValue as string); } catch {}\n return {\n seq: seq as number,\n ts: entry.ts ?? \"\",\n value: entry.views?.[viewId] ?? null,\n };\n });\n}\n",[234],"1b9613b2-2075-11f1-8859-42dde27851f2","rooms.ts","debc98e4-1ad9-11f1-b21b-42dde27851f2",["D",1773582277011],"/**\n * rooms.ts — Room CRUD operations.\n *\n * v7: Room creation auto-links to user_rooms when caller has user identity.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport { generateToken, hashToken, type AuthResult } from \"./auth.ts\";\n\nexport async function createRoom(body: any, auth?: AuthResult) {\n const id = body.id ?? crypto.randomUUID();\n const meta = JSON.stringify(body.meta ?? {});\n const token = generateToken(\"room\");\n const hash = await hashToken(token);\n const viewToken = generateToken(\"view\");\n const viewHash = await hashToken(viewToken);\n try {\n await sqlite.execute({\n sql: `INSERT INTO rooms (id, meta, token_hash, view_token_hash) VALUES (?, ?, ?, ?)`,\n args: [id, meta, hash, viewHash],\n });\n } catch (e: any) {\n if (e.message?.includes(\"UNIQUE constraint\")) return json({ error: \"room_exists\", id }, 409);\n throw e;\n }\n const result = await sqlite.execute({ sql: `SELECT * FROM rooms WHERE id = ?`, args: [id] });\n const room = rows2objects(result)[0];\n delete room.token_hash;\n delete room.view_token_hash;\n\n // v7: Auto-link to user_rooms when caller has user identity\n const userId = auth?.userId;\n if (userId) {\n try {\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO smcp_user_rooms (user_id, room_id, access, label)\n VALUES (?, ?, 'owner', ?)`,\n args: [userId, id, body.label ?? `Room: ${id}`],\n });\n } catch (_) { /* best-effort — don't fail room creation */ }\n }\n\n return json({ ...room, token, view_token: viewToken }, 201);\n}\n\nexport async function getRoom(roomId: string) {\n const result = await sqlite.execute({ sql: `SELECT * FROM rooms WHERE id = ?`, args: [roomId] });\n const room = rows2objects(result)[0];\n if (!room) return json({ error: \"room not found\" }, 404);\n delete room.token_hash;\n delete room.view_token_hash;\n return json(room);\n}\n\nexport async function listRooms(req: Request) {\n const header = req.headers.get(\"Authorization\");\n if (!header || !header.startsWith(\"Bearer \")) {\n return json({ error: \"authentication_required\", message: \"include Authorization: Bearer to list your rooms\" }, 401);\n }\n const token = header.slice(7);\n const hash = await hashToken(token);\n\n const stripHashes = (r: any) => { delete r.token_hash; delete r.view_token_hash; return r; };\n\n // v7: Check unified tokens table for tok_ tokens\n if (token.startsWith(\"tok_\")) {\n // Import hashTokenB64 inline to avoid circular dep\n const data = new TextEncoder().encode(token);\n const hashBuf = await crypto.subtle.digest(\"SHA-256\", data);\n const b64 = btoa(String.fromCharCode(...new Uint8Array(hashBuf)))\n .replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=/g, \"\");\n\n const tokenResult = await sqlite.execute({\n sql: `SELECT minted_by FROM tokens WHERE token_hash = ? AND revoked = 0\n AND (expires_at IS NULL OR expires_at > datetime('now'))`,\n args: [b64],\n });\n if (tokenResult.rows.length > 0) {\n const userId = tokenResult.rows[0][0] as string;\n const userRooms = await sqlite.execute({\n sql: `SELECT room_id FROM smcp_user_rooms WHERE user_id = ?`,\n args: [userId],\n });\n const roomIds = userRooms.rows.map((r: any[]) => r[0] as string);\n if (roomIds.length === 0) return json([]);\n const placeholders = roomIds.map(() => \"?\").join(\",\");\n const result = await sqlite.execute({\n sql: `SELECT * FROM rooms WHERE id IN (${placeholders}) ORDER BY created_at DESC`,\n args: roomIds,\n });\n return json(rows2objects(result).map(stripHashes));\n }\n }\n\n // Legacy: Check room tokens\n if (token.startsWith(\"room_\")) {\n const result = await sqlite.execute({\n sql: `SELECT * FROM rooms WHERE token_hash = ?`, args: [hash],\n });\n return json(rows2objects(result).map(stripHashes));\n }\n\n // Legacy: Check view tokens\n if (token.startsWith(\"view_\")) {\n const result = await sqlite.execute({\n sql: `SELECT * FROM rooms WHERE view_token_hash = ?`, args: [hash],\n });\n return json(rows2objects(result).map(stripHashes));\n }\n\n // v8: Agent token — check tokens table\n const agentResult = await sqlite.execute({\n sql: `SELECT room_id FROM tokens WHERE token_hash = ? AND revoked = 0`, args: [hash],\n });\n if (agentResult.rows.length === 0) return json({ error: \"invalid_token\" }, 401);\n const roomIds = agentResult.rows.map((r: any[]) => r[0]);\n const placeholders = roomIds.map(() => \"?\").join(\",\");\n const result = await sqlite.execute({\n sql: `SELECT * FROM rooms WHERE id IN (${placeholders}) ORDER BY created_at DESC`,\n args: roomIds,\n });\n return json(rows2objects(result).map(stripHashes));\n}\n\n// ── View token rotation ──\n\nexport async function rotateViewToken(roomId: string) {\n const viewToken = generateToken(\"view\");\n const viewHash = await hashToken(viewToken);\n const result = await sqlite.execute({\n sql: `UPDATE rooms SET view_token_hash = ? WHERE id = ?`,\n args: [viewHash, roomId],\n });\n if (result.rowsAffected === 0) return json({ error: \"room not found\" }, 404);\n return json({ ok: true, view_token: viewToken });\n}\n",[240],"89c8d3d2-2198-11f1-9238-42dde27851f2","replay.ts","debc6afe-1ad9-11f1-b21b-42dde27851f2",["D",1773707445460],"/**\n * replay.ts — Time-travel replay for sync rooms.\n *\n * v9: Reconstructs wrapped { value, _meta } state from audit entries.\n * Uses celEval (Environment) so v9 expressions with domain helpers work.\n * Accumulates per-key _meta (writer, via, revision) from audit walk.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { celEval } from \"./cel.ts\";\nimport { rows2objects } from \"./utils.ts\";\nimport { isTimerLive } from \"./timers.ts\";\nimport type { EntryMeta } from \"./meta.ts\";\n\n/** Minimal _meta accumulated from audit walk */\nfunction replayMeta(revision: number, writer: string | null, via: string | null, seq: number | null, ts: string): EntryMeta {\n return {\n revision,\n updated_at: ts,\n writer,\n via,\n seq,\n score: 0,\n velocity: 0,\n writers: writer ? [writer] : [],\n first_at: ts,\n elided: false,\n };\n}\n\n/**\n * Reconstruct room state by replaying audit entries up to seq N.\n * Returns wrapped { value, _meta } entries — same shape as live context.\n */\nexport async function replayRoom(roomId: string, upToSeq: number): Promise<{\n agents: any[];\n state: any[];\n messages: any[];\n actions: any[];\n views: any[];\n audit: any[];\n _replay: { seq: number; total: number; ts: string | null };\n}> {\n const auditRes = await sqlite.execute({\n sql: `SELECT sort_key, value FROM state WHERE room_id = ? AND scope = '_audit' AND sort_key <= ? ORDER BY sort_key ASC`,\n args: [roomId, upToSeq],\n });\n const auditRows = rows2objects(auditRes);\n\n const totalRes = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) as total FROM state WHERE room_id = ? AND scope = '_audit'`,\n args: [roomId],\n });\n const total = Number(rows2objects(totalRes)[0]?.total ?? 0);\n\n // ── Reconstruction state ──\n const agentsMap: Record = {};\n const actionsMap: Record = {};\n const viewsMap: Record = {};\n // state: scope → key → { value, revision, writer, via, seq, writers, first_at }\n const stateMap: Record; first_at: string }>> = {};\n const messagesArr: any[] = [];\n const auditOut: any[] = [];\n\n let lastTs: string | null = null;\n\n function writeState(scope: string, key: string, value: any, agent: string | null, action: string | null, seq: number, ts: string) {\n if (!stateMap[scope]) stateMap[scope] = {};\n const existing = stateMap[scope][key];\n if (existing) {\n existing.value = value;\n existing.revision++;\n existing.writer = agent;\n existing.via = action;\n existing.seq = seq;\n if (agent) existing.writers.add(agent);\n } else {\n stateMap[scope][key] = {\n value, revision: 1, writer: agent, via: action, seq,\n writers: new Set(agent ? [agent] : []),\n first_at: ts,\n };\n }\n }\n\n for (const row of auditRows) {\n let entry: any;\n try { entry = JSON.parse(row.value); } catch { continue; }\n const kind = entry.kind ?? \"invoke\";\n lastTs = entry.ts ?? lastTs;\n const seq = Number(row.sort_key);\n\n auditOut.push({ sort_key: row.sort_key, value: entry, updated_at: entry.ts ?? \"\" });\n\n switch (kind) {\n case \"agent_join\": {\n const s = entry.schema ?? {};\n agentsMap[s.id] = {\n id: s.id, name: s.name ?? s.id, role: s.role ?? \"agent\",\n status: \"active\", grants: JSON.stringify(s.grants ?? []),\n joined_at: entry.ts ?? \"\", last_heartbeat: entry.ts ?? \"\", waiting_on: null,\n };\n if (s.state && typeof s.state === \"object\") {\n for (const [key, value] of Object.entries(s.state)) {\n writeState(s.id, key, value, s.id, null, seq, entry.ts ?? \"\");\n }\n }\n break;\n }\n case \"agent_update\": {\n const s = entry.schema ?? {};\n if (agentsMap[s.id]) {\n const changes = s.changes ?? {};\n if (changes.name !== undefined) agentsMap[s.id].name = changes.name;\n if (changes.role !== undefined) agentsMap[s.id].role = changes.role;\n if (changes.grants !== undefined) agentsMap[s.id].grants = JSON.stringify(changes.grants);\n }\n break;\n }\n case \"register_action\": {\n const s = entry.schema ?? {};\n if (s.id) {\n actionsMap[s.id] = {\n id: s.id, room_id: roomId, scope: s.scope ?? \"_shared\",\n description: s.description ?? null, if: s.if_expr ?? null,\n enabled: s.enabled_expr ?? null, writes: s.writes ?? [],\n params: s.params ?? null, available: true, version: 1,\n registered_by: entry.agent ?? null,\n };\n }\n break;\n }\n case \"delete_action\": {\n const s = entry.schema ?? {};\n if (s.id) delete actionsMap[s.id];\n break;\n }\n case \"register_view\": {\n const s = entry.schema ?? {};\n if (s.id) {\n viewsMap[s.id] = {\n id: s.id, room_id: roomId, scope: s.scope ?? \"_shared\",\n description: s.description ?? null, expr: s.expr,\n enabled: s.enabled_expr ?? null, render: s.render ?? null,\n registered_by: entry.agent ?? null, version: 1,\n };\n }\n break;\n }\n case \"delete_view\": {\n const s = entry.schema ?? {};\n if (s.id) delete viewsMap[s.id];\n break;\n }\n case \"invoke\":\n default: {\n const writes: Array<{ scope: string; key: string; value?: any }> = entry.effect?.writes ?? [];\n for (const w of writes) {\n if (!w.scope || !w.key) continue;\n if (w.scope === \"_messages\") {\n messagesArr.push({ sort_key: w.key, value: w.value, updated_at: entry.ts ?? \"\" });\n continue;\n }\n if (w.scope === \"_audit\") continue;\n writeState(w.scope, w.key, w.value, entry.agent ?? null, entry.action ?? null, seq, entry.ts ?? \"\");\n }\n const invokeAgent = entry.agent;\n if (invokeAgent && agentsMap[invokeAgent]) {\n agentsMap[invokeAgent].status = \"active\";\n agentsMap[invokeAgent].last_heartbeat = entry.ts ?? agentsMap[invokeAgent].last_heartbeat;\n }\n break;\n }\n }\n }\n\n // ── Build wrapped state (v9 shape: { value, _meta }) ──\n const stateRows: any[] = [];\n const celState: Record> = {};\n\n for (const [scope, keys] of Object.entries(stateMap)) {\n celState[scope] = {};\n for (const [key, entry] of Object.entries(keys)) {\n const wrapped = {\n value: entry.value,\n _meta: {\n ...replayMeta(entry.revision, entry.writer, entry.via, entry.seq, entry.first_at),\n updated_at: lastTs ?? entry.first_at,\n writers: [...entry.writers],\n },\n };\n celState[scope][key] = wrapped;\n stateRows.push({ room_id: roomId, scope, key, value: entry.value, version: \"\", revision: entry.revision, sort_key: null, updated_at: lastTs ?? \"\" });\n }\n }\n\n // ── Wrapped agents for CEL context ──\n const celAgents: Record = {};\n for (const [id, a] of Object.entries(agentsMap)) {\n celAgents[id] = {\n value: { name: a.name, role: a.role, status: a.status },\n _meta: replayMeta(1, null, null, null, a.joined_at ?? \"\"),\n };\n }\n\n // ── Wrapped actions for CEL context ──\n const celActions: Record = {};\n for (const [id, a] of Object.entries(actionsMap)) {\n celActions[id] = {\n value: { enabled: true, available: true, description: a.description },\n _meta: { ...replayMeta(1, a.registered_by, null, null, \"\"), invocations: 0, last_invoked_at: null, last_invoked_by: null, contested: [] },\n };\n }\n\n // ── Evaluate views against wrapped reconstructed state ──\n const views: any[] = [];\n for (const viewDef of Object.values(viewsMap)) {\n let value: any = null;\n try {\n const celCtx = {\n state: celState,\n views: {},\n agents: celAgents,\n actions: celActions,\n messages: { count: messagesArr.length, unread: 0, directed_unread: 0 },\n self: \"\",\n params: {},\n };\n const evalResult = celEval(viewDef.expr, celCtx);\n value = typeof evalResult === \"bigint\" ? Number(evalResult) : evalResult;\n } catch (e: any) {\n value = { _error: e.message };\n }\n views.push({ ...viewDef, value });\n }\n\n // ── Messages from DB (more reliable than audit writes) ──\n if (lastTs) {\n const sqliteTs = lastTs.replace(\"T\", \" \").replace(/\\.\\d+Z?$/, \"\");\n const dbMsgsRes = await sqlite.execute({\n sql: `SELECT sort_key, value, updated_at FROM state\n WHERE room_id = ? AND scope = '_messages' AND updated_at <= ?\n ORDER BY sort_key ASC`,\n args: [roomId, sqliteTs],\n });\n messagesArr.length = 0;\n for (const row of rows2objects(dbMsgsRes)) {\n let msgValue: any = row.value;\n try { msgValue = JSON.parse(row.value); } catch {}\n messagesArr.push({ sort_key: row.sort_key, value: msgValue, updated_at: row.updated_at });\n }\n } else {\n messagesArr.length = 0;\n }\n\n return {\n agents: Object.values(agentsMap),\n state: stateRows,\n messages: messagesArr,\n actions: Object.values(actionsMap),\n views,\n audit: auditOut,\n _replay: { seq: upToSeq, total, ts: lastTs },\n };\n}\n",[246],"89c8b550-2198-11f1-9238-42dde27851f2","poll-v8.ts","1b8efa00-2075-11f1-8859-42dde27851f2",["D",1773707445460],"/**\n * poll.ts — Dashboard poll endpoint (v9).\n *\n * Single data source: the state table. Returns state rows with _meta\n * (writer, score, velocity), resolved view values, action availability,\n * audit trail, and salience map.\n *\n * v9: Every state row includes _meta from meta.ts.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport { buildContext, buildViewContext, celEval } from \"./cel.ts\";\nimport { isTimerLive } from \"./timers.ts\";\nimport { hasFullReadAccess, touchAgent, type AuthResult } from \"./auth.ts\";\nimport { computeContestedTargets } from \"./actions.ts\";\nimport { maybeSampleViews } from \"./sampling.ts\";\nimport { computeRoomMeta, computeScore, wrapEntry, loadAgentContext, type RoomMeta } from \"./meta.ts\";\n\nexport async function dashboardPoll(roomId: string, url: URL, auth: AuthResult) {\n const auditLimit = Math.min(parseInt(url.searchParams.get(\"audit_limit\") ?? \"500\"), 2000);\n\n // ── Single state query: everything except _audit ──\n let stateSql = `SELECT scope, key, sort_key, value, revision, updated_at\n FROM state WHERE room_id = ? AND scope != '_audit'`;\n const stateArgs: any[] = [roomId];\n\n // Scope privacy\n if (!hasFullReadAccess(auth)) {\n if (auth.authenticated && auth.kind === \"agent\") {\n const accessible = [auth.agentId!, ...auth.grants].filter(Boolean);\n const conditions = [`scope LIKE '\\\\_%' ESCAPE '\\\\'`];\n for (const s of accessible) { conditions.push(`scope = ?`); stateArgs.push(s); }\n stateSql += ` AND (${conditions.join(\" OR \")})`;\n } else {\n stateSql += ` AND scope LIKE '\\\\_%' ESCAPE '\\\\'`;\n }\n }\n\n stateSql += ` ORDER BY CASE WHEN sort_key IS NOT NULL THEN sort_key ELSE 0 END ASC`;\n\n const [stateResult, auditResult] = await Promise.all([\n sqlite.execute({ sql: stateSql, args: stateArgs }),\n sqlite.execute({\n sql: `SELECT sort_key, value, updated_at FROM state\n WHERE room_id = ? AND scope = '_audit'\n ORDER BY sort_key ASC LIMIT ?`,\n args: [roomId, auditLimit],\n }),\n ]);\n\n // ── Compute room meta for _meta enrichment ──\n let roomMeta: RoomMeta | null = null;\n let agentCtx: any = null;\n try {\n roomMeta = await computeRoomMeta(roomId);\n if (auth.agentId) {\n agentCtx = await loadAgentContext(roomId, auth.agentId, rows2objects(stateResult) as any[]);\n }\n } catch {}\n\n // ── Process state rows with _meta ──\n const rawRows = rows2objects(stateResult);\n const stateRows: any[] = [];\n\n for (const row of rawRows) {\n if (!isTimerLive(row)) continue;\n let value: any = row.value;\n try { value = JSON.parse(row.value); } catch {}\n\n // Compute _meta for this entry\n let _meta: any = null;\n if (roomMeta) {\n const score = computeScore(row.scope as string, row.key as string, row.updated_at as string, value, agentCtx, roomMeta);\n const wrapped = wrapEntry(value, row.scope as string, row.key as string, row.revision ?? 0, row.updated_at ?? \"\", roomMeta, score);\n _meta = wrapped._meta;\n }\n\n stateRows.push({\n scope: row.scope,\n key: row.key,\n sort_key: row.sort_key ?? null,\n value,\n revision: row.revision,\n updated_at: row.updated_at,\n _meta,\n });\n }\n\n // ── Build CEL context for evaluation ──\n const ctx = await buildContext(roomId, {\n selfAgent: auth.agentId ?? undefined,\n allScopes: hasFullReadAccess(auth),\n });\n\n // ── Resolve view values from _views scope ──\n const resolved: Record = {};\n const viewDefs = stateRows.filter(r => r.scope === \"_views\");\n\n for (const v of viewDefs) {\n const def = v.value;\n if (!def?.expr) continue;\n\n if (def.enabled) {\n try { if (!celEval(def.enabled, ctx)) continue; } catch { continue; }\n }\n\n const viewCtx = await buildViewContext(roomId, def.scope ?? \"_shared\", ctx);\n try {\n const result = celEval(def.expr, viewCtx);\n resolved[v.key] = typeof result === \"bigint\" ? Number(result) : result;\n } catch (e: any) {\n resolved[v.key] = { _error: e.message };\n }\n }\n\n // ── Evaluate action availability from _actions scope ──\n const available: Record = {};\n const actionDefs = stateRows.filter(r => r.scope === \"_actions\");\n\n for (const a of actionDefs) {\n const def = a.value;\n if (def?.enabled) {\n try { if (!celEval(def.enabled, ctx)) continue; } catch { continue; }\n }\n if (def?.if) {\n try { available[a.key] = !!celEval(def.if, ctx); } catch { available[a.key] = false; }\n } else {\n available[a.key] = true;\n }\n }\n\n // ── Process audit ──\n const auditRows = rows2objects(auditResult).map((row: any) => {\n let value: any = row.value;\n try { value = JSON.parse(row.value); } catch {}\n return { seq: row.sort_key, value, updated_at: row.updated_at };\n });\n\n // ── Sampling (fire-and-forget) ──\n const viewsForSampling = viewDefs\n .filter(v => v.value?.render?.temporal === true && resolved[v.key] !== undefined)\n .map(v => ({ id: v.key, value: resolved[v.key], render: v.value?.render }));\n maybeSampleViews(roomId, viewsForSampling).catch(() => {});\n\n // ── Salience (agent-authenticated only) ──\n let salience: any[] | undefined;\n if (auth.authenticated && auth.agentId) {\n touchAgent(roomId, auth.agentId);\n try {\n salience = stateRows\n .filter((r: any) => !r.scope.startsWith(\"_\") || r.scope === \"_shared\")\n .filter((r: any) => r._meta && r._meta.score > 0.05)\n .map((r: any) => ({ key: `${r.scope}.${r.key}`, score: Math.round(r._meta.score * 100) / 100 }))\n .sort((a: any, b: any) => b.score - a.score)\n .slice(0, 20);\n } catch {}\n }\n\n return json({\n state: stateRows,\n resolved,\n available,\n audit: auditRows,\n ...(salience ? { salience } : {}),\n });\n}\n",[252],"89c1805a-2198-11f1-9238-42dde27851f2","meta.ts","89c18104-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * meta.ts — Entry metadata computation for wrapped state.\n *\n * v9: Every state entry carries { value, _meta: { ... } }.\n * This module computes _meta from:\n * - The state row itself (revision, updated_at)\n * - A single bulk audit scan (writer, via, seq, velocity, writers, first_at)\n * - Action invocation stats (invocations, last_invoked_at, last_invoked_by)\n * - Contested targets (contested)\n * - Agent-specific salience score\n *\n * Design principle: one SQL query for audit entries, one pass to accumulate\n * per-key stats. Room-level meta is agent-independent. Score is added per-agent.\n *\n * Replaces salience.ts — score becomes one field in _meta, not a separate module.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport type { DependencySet } from \"./deps.ts\";\nimport { isRelevant } from \"./deps.ts\";\n\n// ── Types ──────────────────────────────────────────────────────────────\n\nexport interface EntryMeta {\n revision: number;\n updated_at: string;\n writer: string | null;\n via: string | null;\n seq: number | null;\n score: number;\n velocity: number;\n writers: string[];\n first_at: string | null;\n elided: boolean;\n}\n\nexport interface ActionMeta extends EntryMeta {\n invocations: number;\n last_invoked_at: string | null;\n last_invoked_by: string | null;\n contested: string[];\n}\n\nexport interface WrappedEntry {\n value: T;\n _meta: EntryMeta | ActionMeta;\n}\n\n// ── Internal accumulators ──────────────────────────────────────────────\n\ninterface WriteEvent {\n agent: string;\n action: string;\n seq: number;\n ts: string;\n}\n\ninterface KeyAccum {\n writes: WriteEvent[];\n earliest_ts: string | null;\n}\n\ninterface ActionInvokeAccum {\n invocations: number;\n last_invoked_at: string | null;\n last_invoked_by: string | null;\n}\n\n// ── Velocity ───────────────────────────────────────────────────────────\n\nconst VELOCITY_HALF_LIFE_MS = 300_000; // 5 minutes\n\n/**\n * Exponential-decay weighted write count.\n * A write just now contributes 1.0, a write 5 min ago contributes 0.5.\n * Dimensionless — higher = more recent write activity.\n */\nfunction computeVelocity(writes: WriteEvent[], now: number): number {\n let sum = 0;\n for (const w of writes) {\n const ts = new Date(w.ts).getTime();\n if (isNaN(ts)) continue;\n const age = now - ts;\n if (age < 0) continue;\n sum += Math.pow(0.5, age / VELOCITY_HALF_LIFE_MS);\n }\n return Math.round(sum * 100) / 100;\n}\n\n// ── Room-level meta (agent-independent) ────────────────────────────────\n\nexport interface RoomMeta {\n keys: Map;\n actions: Map;\n /** Contested write targets: \"scope:key\" → list of competing action IDs */\n contested: Map;\n}\n\n/**\n * Compute room-level metadata from a single bulk audit scan.\n * One query, one pass. Agent-independent — score is added later.\n */\nexport async function computeRoomMeta(roomId: string): Promise {\n const now = Date.now();\n\n // ── Single audit scan ──\n const auditResult = await sqlite.execute({\n sql: `SELECT sort_key, value FROM state\n WHERE room_id = ? AND scope = '_audit'\n ORDER BY sort_key DESC LIMIT 1000`,\n args: [roomId],\n });\n\n const keyAccums = new Map();\n const actionAccums = new Map();\n\n for (const row of auditResult.rows) {\n const seq = Number(row[0]);\n let entry: any;\n try { entry = JSON.parse(row[1] as string); } catch { continue; }\n\n const agent = entry.agent ?? \"\";\n const action = entry.action ?? \"\";\n const ts = entry.ts ?? \"\";\n\n // Track action invocations (only non-builtin successful invokes)\n if ((entry.kind === \"invoke\" || (!entry.kind && entry.action)) && entry.ok !== false) {\n if (action && !entry.builtin) {\n let accum = actionAccums.get(action);\n if (!accum) {\n accum = { invocations: 0, last_invoked_at: null, last_invoked_by: null };\n actionAccums.set(action, accum);\n }\n accum.invocations++;\n // First encountered in DESC order = most recent\n if (!accum.last_invoked_at) {\n accum.last_invoked_at = ts;\n accum.last_invoked_by = agent;\n }\n }\n }\n\n // Track per-key writes\n const writes: Array<{ scope: string; key: string }> = entry.effect?.writes ?? [];\n for (const w of writes) {\n if (!w.scope || !w.key) continue;\n const mk = `${w.scope}:${w.key}`;\n let accum = keyAccums.get(mk);\n if (!accum) {\n accum = { writes: [], earliest_ts: null };\n keyAccums.set(mk, accum);\n }\n accum.writes.push({ agent, action, seq, ts });\n // Last seen in DESC order = earliest known\n accum.earliest_ts = ts;\n }\n }\n\n // ── Compute per-key derived fields ──\n const keys = new Map();\n\n for (const [mk, accum] of keyAccums) {\n const mostRecent = accum.writes[0]; // first in DESC = most recent\n const writerSet = [...new Set(accum.writes.map(w => w.agent))];\n keys.set(mk, {\n writer: mostRecent?.agent ?? null,\n via: mostRecent?.action ?? null,\n seq: mostRecent?.seq ?? null,\n velocity: computeVelocity(accum.writes, now),\n writers: writerSet,\n first_at: accum.earliest_ts,\n });\n }\n\n // ── Contested targets from action definitions ──\n const contested = new Map();\n try {\n const actionsResult = await sqlite.execute({\n sql: `SELECT key, value FROM state WHERE room_id = ? AND scope = '_actions'`,\n args: [roomId],\n });\n const writeTargets = new Map();\n for (const row of actionsResult.rows) {\n const actionId = row[0] as string;\n try {\n const def = JSON.parse(row[1] as string);\n if (!Array.isArray(def.writes)) continue;\n for (const w of def.writes) {\n const scope = w.scope ?? \"_shared\";\n const key = w.key;\n if (!key || key.includes(\"${\")) continue; // skip templated keys\n const target = `${scope}:${key}`;\n if (!writeTargets.has(target)) writeTargets.set(target, []);\n writeTargets.get(target)!.push(actionId);\n }\n } catch {}\n }\n for (const [target, actions] of writeTargets) {\n if (actions.length >= 2) contested.set(target, actions);\n }\n } catch {}\n\n return { keys, actions: actionAccums, contested };\n}\n\n// ── Score computation (agent-specific) ─────────────────────────────────\n\nexport interface ScoreWeights {\n recency: number;\n dependency: number;\n authorship: number;\n directed: number;\n contest: number;\n delta: number;\n}\n\nexport const DEFAULT_WEIGHTS: ScoreWeights = {\n recency: 0.10,\n dependency: 0.30,\n authorship: 0.10,\n directed: 0.20,\n contest: 0.10,\n delta: 0.20,\n};\n\n/** Agent-specific context needed for score computation */\nexport interface AgentContext {\n agentId: string;\n deps: DependencySet;\n lastSeen: string | null;\n registeredActions: Set;\n weights: ScoreWeights;\n}\n\n/**\n * Load the agent context needed for score computation.\n * One function, two queries.\n */\nexport async function loadAgentContext(\n roomId: string,\n agentId: string,\n stateRows: any[],\n): Promise {\n // Agent last_heartbeat from _agents scope (already in stateRows)\n let lastSeen: string | null = null;\n const agentRow = stateRows.find(\n (r: any) => r.scope === \"_agents\" && r.key === agentId,\n );\n if (agentRow) {\n try {\n const val = JSON.parse(agentRow.value);\n lastSeen = val.last_heartbeat ?? null;\n } catch {}\n }\n\n // Agent's registered actions (from stateRows)\n const registeredActions = new Set();\n for (const row of stateRows) {\n if (row.scope !== \"_actions\") continue;\n try {\n const def = JSON.parse(row.value);\n if (def.registered_by === agentId) registeredActions.add(row.key);\n } catch {}\n }\n\n // Agent's view dependencies (from stateRows)\n const deps: DependencySet = [];\n for (const row of stateRows) {\n if (row.scope !== \"_views\") continue;\n try {\n const viewDef = JSON.parse(row.value);\n if (\n viewDef.registered_by === agentId || viewDef.scope === agentId\n ) {\n if (Array.isArray(viewDef.deps)) {\n deps.push(...viewDef.deps);\n }\n }\n } catch {}\n }\n\n // Room-level weight overrides\n let weights = { ...DEFAULT_WEIGHTS };\n const configRow = stateRows.find(\n (r: any) => r.scope === \"_config\" && r.key === \"salience_weights\",\n );\n if (configRow) {\n try {\n const overrides = JSON.parse(configRow.value);\n weights = { ...weights, ...overrides };\n } catch {}\n }\n\n return { agentId, deps, lastSeen, registeredActions, weights };\n}\n\n/**\n * Compute salience score for a single entry.\n * All signals normalized to [0, 1], weighted sum.\n */\nexport function computeScore(\n scope: string,\n key: string,\n updatedAt: string | null,\n value: any,\n agentCtx: AgentContext | null,\n roomMeta: RoomMeta,\n): number {\n if (!agentCtx) return 0.5; // no agent context → neutral score\n\n const w = agentCtx.weights;\n const now = Date.now();\n const mk = `${scope}:${key}`;\n\n // Recency: exponential decay from last update\n let recency = 0;\n if (updatedAt) {\n const age = now - new Date(updatedAt).getTime();\n if (age >= 0) recency = Math.pow(0.5, age / 300_000);\n }\n\n // Dependency: is this key in the agent's view dependency set?\n const dependency = isRelevant(agentCtx.deps, scope, key) ? 1.0 : 0;\n\n // Authorship: did this agent last write this key?\n const km = roomMeta.keys.get(mk);\n const authorship = km?.writer === agentCtx.agentId ? 1.0 : 0;\n\n // Directed: for messages, is this directed at the agent?\n let directed = 0;\n if (scope === \"_messages\" && typeof value === \"object\" && value !== null) {\n if (Array.isArray(value.to)) {\n directed = value.to.includes(agentCtx.agentId) ? 1.0 : 0.1;\n } else {\n directed = 0.3; // broadcast\n }\n }\n\n // Contest: is this key a write target of 2+ actions?\n let contest = 0;\n const contestants = roomMeta.contested.get(mk);\n if (contestants && contestants.length >= 2) {\n contest = contestants.some((id) => agentCtx.registeredActions.has(id))\n ? 1.0\n : 0.5;\n }\n\n // Delta: has this key been updated since the agent's last heartbeat?\n let delta = 0;\n if (updatedAt && agentCtx.lastSeen) {\n const updated = new Date(updatedAt).getTime();\n const last = new Date(agentCtx.lastSeen).getTime();\n if (!isNaN(updated) && !isNaN(last) && updated > last) delta = 1.0;\n }\n\n const score = recency * w.recency +\n dependency * w.dependency +\n authorship * w.authorship +\n directed * w.directed +\n contest * w.contest +\n delta * w.delta;\n\n return Math.round(score * 100) / 100;\n}\n\n// ── Entry wrapping ─────────────────────────────────────────────────────\n\n/**\n * Wrap a state entry with full _meta.\n * Called once per entry during buildContext.\n */\nexport function wrapEntry(\n value: any,\n scope: string,\n key: string,\n revision: number,\n updatedAt: string,\n roomMeta: RoomMeta,\n score: number,\n): WrappedEntry {\n const mk = `${scope}:${key}`;\n const km = roomMeta.keys.get(mk);\n\n const meta: EntryMeta = {\n revision,\n updated_at: updatedAt,\n writer: km?.writer ?? null,\n via: km?.via ?? null,\n seq: km?.seq ?? null,\n score,\n velocity: km?.velocity ?? 0,\n writers: km?.writers ?? [],\n first_at: km?.first_at ?? null,\n elided: false,\n };\n\n // Action-specific meta\n if (scope === \"_actions\") {\n const am = roomMeta.actions.get(key);\n // Contested: other actions that share write targets with this action\n const myContested: string[] = [];\n for (const [_target, actions] of roomMeta.contested) {\n if (actions.includes(key)) {\n for (const a of actions) {\n if (a !== key && !myContested.includes(a)) myContested.push(a);\n }\n }\n }\n\n const actionMeta = meta as ActionMeta;\n actionMeta.invocations = am?.invocations ?? 0;\n actionMeta.last_invoked_at = am?.last_invoked_at ?? null;\n actionMeta.last_invoked_by = am?.last_invoked_by ?? null;\n actionMeta.contested = myContested;\n }\n\n return { value, _meta: meta };\n}\n\n/**\n * Create a minimal _meta for entries with no audit history.\n * Used for newly created entries or entries predating the audit window.\n */\nexport function minimalMeta(\n revision: number,\n updatedAt: string,\n score: number = 0,\n): EntryMeta {\n return {\n revision,\n updated_at: updatedAt,\n writer: null,\n via: null,\n seq: null,\n score,\n velocity: 0,\n writers: [],\n first_at: null,\n elided: false,\n };\n}\n",[258],"89c7b93e-2198-11f1-9238-42dde27851f2","main.ts",["D",1773707445460],172,"http","// v9 — wrapped state model · { value, _meta } · Environment CEL\n// force-restart: 2026-03-16T23:40Z\n//\n// main.ts — HTTP router + barrel re-exports.\n//\n// All domain logic has been extracted to focused modules.\n// This file provides the HTTP routing layer and re-exports\n// for backward compatibility with mcp/tools.ts.\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"./schema.ts\";\nimport { migrateUnifiedAuth } from \"./schema-v7.ts\";\nimport {\n json,\n PARSE_FAILED,\n parseBody,\n rows2objects,\n stripNulls,\n} from \"./utils.ts\";\nimport { handleMcpRequest } from \"./mcp/mcp.ts\";\nimport {\n renderDashboardPage,\n renderDocPage,\n renderDocsIndex,\n renderLandingPage,\n renderOverviewPage,\n} from \"./frontend/pages.tsx\";\nimport { mdToHtml } from \"./frontend/markdown.ts\";\nimport { DOC_REGISTRY, README, REFERENCE_FILES } from \"./docs.ts\";\nimport {\n assertIdentity,\n type AuthResult,\n hasFullReadAccess,\n hashToken,\n hashTokenB64,\n requireRoomToken,\n requireWriteAuth,\n resolveAuth,\n} from \"./auth.ts\";\nimport { touchAgent } from \"./auth.ts\";\nimport { createRoom, getRoom, listRooms, rotateViewToken } from \"./rooms.ts\";\nimport { insertAgentDirect, joinRoom, updateAgent } from \"./agents.ts\";\nimport { deleteAction, registerAction } from \"./actions.ts\";\nimport { deleteView, registerView } from \"./views.ts\";\nimport { invokeAction, invokeBuiltinAction } from \"./invoke.ts\";\nimport {\n buildExpandedContext,\n type ContextRequest,\n evalExpression,\n parseContextRequest,\n} from \"./context.ts\";\nimport { waitForCondition } from \"./wait.ts\";\nimport { replayRoom } from \"./replay.ts\";\nimport { queryKeyHistory, queryPrefixHistory } from \"./schema-v8.ts\";\nimport { queryViewSamples } from \"./sampling.ts\";\nimport { computeRoomMeta, computeScore, loadAgentContext } from \"./meta.ts\";\nimport { dashboardPoll } from \"./poll-v8.ts\";\nimport { parseScope } from \"./mcp/scope.ts\";\nimport { validateTokenByHash } from \"./mcp/db.ts\";\n// v7: Device auth + token management\nimport {\n handleDeviceApprove,\n handleDeviceDeny,\n handleDeviceLookup,\n handleDevicePage,\n handleDeviceStart,\n handleDeviceToken,\n} from \"./mcp/device.ts\";\nimport {\n handleConsentApprove,\n handleConsentPage,\n handleConsentRooms,\n handleElevatePage,\n} from \"./mcp/elevate.tsx\";\nimport {\n handleClaim,\n handleInvite,\n handleListTokens,\n handleMintToken,\n handleRefreshToken,\n handleRevokeToken,\n handleUpdateToken,\n} from \"./tokens.ts\";\n\n// ── Re-exports for mcp/tools.ts backward compatibility ──\n\nexport {\n buildExpandedContext,\n createRoom,\n deleteAction,\n deleteView,\n evalExpression,\n insertAgentDirect,\n invokeAction,\n invokeBuiltinAction,\n joinRoom,\n listRooms,\n registerAction,\n registerView,\n waitForCondition,\n};\nexport type { ContextRequest };\n\n// ── Migration guard ──\n\nlet migrated = false;\nasync function ensureMigrated() {\n if (!migrated) {\n await migrate();\n await migrateUnifiedAuth();\n migrated = true;\n }\n}\n\n// ── Context endpoint ──\n\nasync function getContext(roomId: string, url: URL, auth: AuthResult) {\n touchAgent(roomId, auth.agentId);\n const req = parseContextRequest(url);\n const fullCtx = await buildExpandedContext(roomId, auth, req);\n return json(fullCtx);\n}\n\n// ── Router ──\n\nexport default async function (req: Request) {\n await ensureMigrated();\n const url = new URL(req.url);\n const compact = url.searchParams.get(\"compact\") === \"true\";\n\n const response = await route(req, url);\n\n // v8: Add version header to every response for debugging stale isolates\n response.headers.set(\"X-Sync-Version\", \"v9\");\n\n if (compact && response.headers.get(\"Content-Type\")?.includes(\"json\")) {\n const data = await response.json();\n return json(stripNulls(data), response.status);\n }\n return response;\n}\n\nasync function route(req: Request, _url?: URL): Promise {\n const url = _url ?? new URL(req.url);\n const method = req.method;\n const parts = url.pathname.split(\"/\").filter(Boolean);\n\n // CORS preflight\n if (method === \"OPTIONS\") {\n return new Response(null, {\n headers: {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET,POST,PUT,PATCH,DELETE,OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type,Authorization\",\n },\n });\n }\n\n // ── v7: Device auth endpoints ──\n const p = url.pathname;\n if (p.startsWith(\"/auth/device\")) {\n if (method === \"POST\" && p === \"/auth/device\") {\n return handleDeviceStart(req);\n }\n if (method === \"GET\" && p === \"/auth/device\") return handleDevicePage(req);\n if (method === \"POST\" && p === \"/auth/device/lookup\") {\n return handleDeviceLookup(req);\n }\n if (method === \"POST\" && p === \"/auth/device/approve\") {\n return handleDeviceApprove(req);\n }\n if (method === \"POST\" && p === \"/auth/device/deny\") {\n return handleDeviceDeny(req);\n }\n if (method === \"POST\" && p === \"/auth/device/token\") {\n return handleDeviceToken(req);\n }\n return json({ error: \"not found\" }, 404);\n }\n\n // ── v7: Unified consent page ──\n if (p.startsWith(\"/auth/consent\")) {\n if (method === \"GET\" && p === \"/auth/consent\") {\n return handleConsentPage(req);\n }\n if (method === \"GET\" && p === \"/auth/consent/rooms\") {\n return handleConsentRooms(req);\n }\n if (method === \"POST\" && p === \"/auth/consent/approve\") {\n return handleConsentApprove(req);\n }\n return json({ error: \"not found\" }, 404);\n }\n\n // ── v7: Legacy /auth/elevate → redirect to /auth/consent ──\n if (p.startsWith(\"/auth/elevate\")) {\n if (method === \"GET\" && p === \"/auth/elevate\") {\n return handleElevatePage(req);\n }\n // Legacy approve endpoint — redirect to consent approve\n if (method === \"POST\" && p === \"/auth/elevate/approve\") {\n return handleConsentApprove(req);\n }\n if (method === \"GET\" && p === \"/auth/elevate/token\") {\n return handleConsentRooms(req);\n }\n return json({ error: \"not found\" }, 404);\n }\n\n // ── v7: Token management endpoints ──\n if (p === \"/tokens\" || p.startsWith(\"/tokens/\")) {\n if (method === \"POST\" && p === \"/tokens\") return handleMintToken(req);\n if (method === \"POST\" && p === \"/tokens/refresh\") {\n return handleRefreshToken(req);\n }\n if (method === \"GET\" && p === \"/tokens\") return handleListTokens(req);\n if (method === \"PATCH\" && parts[0] === \"tokens\" && parts[1]) {\n return handleUpdateToken(req, parts[1]);\n }\n if (method === \"DELETE\" && parts[0] === \"tokens\" && parts[1]) {\n return handleRevokeToken(req, parts[1]);\n }\n return json({ error: \"not found\" }, 404);\n }\n\n // ── MCP / OAuth / WebAuthn / Management — delegate to MCP handler ──\n if (\n p === \"/mcp\" ||\n p.startsWith(\"/oauth/\") ||\n p.startsWith(\"/webauthn/\") ||\n p.startsWith(\"/manage\") ||\n p.startsWith(\"/recover\") ||\n (p.startsWith(\"/.well-known/oauth\"))\n ) {\n return handleMcpRequest(req);\n }\n\n // ── Legacy /vault → 410 Gone ──\n if (p.startsWith(\"/vault\")) {\n return json({\n error: \"vault_deprecated\",\n message: \"Use /tokens endpoints instead.\",\n }, 410);\n }\n\n // POST /rooms — v7: require auth with create_rooms scope (or legacy token)\n if (method === \"POST\" && parts[0] === \"rooms\" && parts.length === 1) {\n const body = await parseBody(req);\n if (body === PARSE_FAILED) return json({ error: \"invalid JSON\" }, 400);\n let auth: AuthResult | undefined;\n let creatingTokenId: string | null = null;\n const header = req.headers.get(\"Authorization\");\n if (!header?.startsWith(\"Bearer \")) {\n return json({\n error: \"authentication_required\",\n message:\n \"Room creation requires authentication. Use device auth or OAuth to get a token.\",\n }, 401);\n }\n const tokenStr = header.slice(7);\n // v7 tokens: check create_rooms scope\n if (tokenStr.startsWith(\"tok_\")) {\n const hash = await hashTokenB64(tokenStr);\n const tok = await validateTokenByHash(hash);\n if (!tok) return json({ error: \"invalid_token\" }, 401);\n const parsed = parseScope(tok.scope);\n if (!parsed.createRooms && !parsed.wildcardRooms) {\n return json({\n error: \"scope_denied\",\n message: \"Token scope does not include create_rooms\",\n }, 403);\n }\n auth = {\n authenticated: true,\n kind: \"room\",\n agentId: null,\n roomId: null,\n grants: [\"*\"],\n userId: tok.mintedBy,\n };\n // Track which token is creating this room (for scope append)\n if (!parsed.wildcardRooms) creatingTokenId = tok.id;\n } else {\n // Legacy tokens\n const result = await resolveAuth(req, \"__room_creation__\");\n if (result instanceof Response) return result;\n if (!result.authenticated) return json({ error: \"invalid_token\" }, 401);\n if (result.userId) auth = result;\n else auth = result;\n }\n const response = await createRoom(body, auth);\n // v7: Append the new room to the creating token's scope\n if (creatingTokenId && response.status === 201) {\n try {\n const roomData = await response.clone().json();\n const newRoomId = roomData.id;\n if (newRoomId) {\n await sqlite.execute({\n sql:\n `UPDATE tokens SET scope = scope || ' rooms:' || ? WHERE id = ?`,\n args: [newRoomId, creatingTokenId],\n });\n }\n } catch { /* best-effort */ }\n }\n return response;\n }\n // GET /rooms\n if (method === \"GET\" && parts[0] === \"rooms\" && parts.length === 1) {\n return listRooms(req);\n }\n // GET /rooms/:id\n if (\n method === \"GET\" && parts[0] === \"rooms\" && parts.length === 2 &&\n parts[1] !== \"\"\n ) return getRoom(parts[1]);\n\n const roomId = parts[1];\n if (!roomId || parts[0] !== \"rooms\") {\n // /overview — Vision & Architecture page\n if (\n method === \"GET\" &&\n (url.pathname === \"/overview\" || url.pathname === \"/overview/\")\n ) {\n return renderOverviewPage();\n }\n // /docs — SSR index and rendered pages\n if (\n method === \"GET\" &&\n (url.pathname === \"/docs\" || url.pathname === \"/docs/\")\n ) {\n const docList = Object.entries(DOC_REGISTRY).map(([slug, d]) => ({\n slug,\n title: d.title,\n category: d.category,\n }));\n return renderDocsIndex(docList);\n }\n if (\n method === \"GET\" && url.pathname.startsWith(\"/docs/\") &&\n parts.length === 2\n ) {\n const rawSlug = parts[1];\n if (rawSlug.endsWith(\".md\")) {\n const bareSlug = rawSlug.replace(/\\.md$/, \"\");\n const doc = DOC_REGISTRY[bareSlug];\n if (doc) {\n return new Response(doc.content, {\n headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n });\n }\n return json({ error: \"doc not found\" }, 404);\n }\n const doc = DOC_REGISTRY[rawSlug];\n if (doc) {\n return renderDocPage(\n rawSlug,\n doc.title,\n mdToHtml(doc.content),\n doc.rawPath,\n );\n }\n return json({ error: \"doc not found\" }, 404);\n }\n if (url.pathname === \"/\" || url.pathname === \"\") {\n const roomId = url.searchParams.get(\"room\");\n const docId = url.searchParams.get(\"doc\");\n if (roomId) {\n // Redirect to canonical dashboard URL\n return new Response(null, {\n status: 302,\n headers: { \"Location\": `/rooms/${encodeURIComponent(roomId)}/dashboard` },\n });\n }\n if (docId) {\n const slug = docId.replace(/\\.md$/, \"\");\n return new Response(null, {\n status: 301,\n headers: { \"Location\": `/docs/${slug}` },\n });\n }\n return renderLandingPage();\n }\n if (method === \"GET\" && url.pathname.startsWith(\"/frontend/\")) {\n const modulePath = url.pathname.slice(1);\n const esmUrl = `https://esm.town/v/c15r/sync/${modulePath}`;\n return new Response(null, {\n status: 302,\n headers: {\n \"Location\": esmUrl,\n \"Cache-Control\": \"no-cache, no-store, must-revalidate\",\n },\n });\n }\n if (\n method === \"GET\" &&\n (url.pathname.startsWith(\"/static/\") || url.pathname === \"/favicon.ico\" ||\n url.pathname === \"/favicon.svg\")\n ) {\n const filePath = url.pathname === \"/favicon.ico\"\n ? \"static/favicon.ico\"\n : url.pathname === \"/favicon.svg\"\n ? \"static/favicon.svg\"\n : url.pathname.slice(1);\n try {\n const fileUrl = new URL(`./${filePath}`, import.meta.url);\n const res = await fetch(fileUrl);\n if (!res.ok) return json({ error: \"not found\" }, 404);\n const body = await res.arrayBuffer();\n const ext = filePath.split(\".\").pop()?.toLowerCase() ?? \"\";\n const mimeTypes: Record = {\n ico: \"image/x-icon\",\n svg: \"image/svg+xml\",\n png: \"image/png\",\n jpg: \"image/jpeg\",\n jpeg: \"image/jpeg\",\n gif: \"image/gif\",\n webp: \"image/webp\",\n css: \"text/css\",\n js: \"application/javascript\",\n json: \"application/json\",\n woff: \"font/woff\",\n woff2: \"font/woff2\",\n ttf: \"font/ttf\",\n txt: \"text/plain\",\n xml: \"application/xml\",\n };\n return new Response(body, {\n headers: {\n \"Content-Type\": mimeTypes[ext] || \"application/octet-stream\",\n \"Cache-Control\": \"public, max-age=86400\",\n },\n });\n } catch {\n return json({ error: \"not found\" }, 404);\n }\n }\n if (\n method === \"GET\" &&\n (url.pathname === \"/SKILL.md\" || url.pathname === \"/skill.md\")\n ) {\n return new Response(README, {\n headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n });\n }\n if (method === \"GET\" && parts[0] === \"reference\" && parts.length === 2) {\n const doc = REFERENCE_FILES[parts[1]];\n if (doc) {\n return new Response(doc, {\n headers: { \"Content-Type\": \"text/plain; charset=utf-8\" },\n });\n }\n }\n return json({ error: \"not found\" }, 404);\n }\n\n // Parse body for mutations\n let body: any = undefined;\n if (\n method === \"POST\" || method === \"PUT\" || method === \"DELETE\" ||\n method === \"PATCH\"\n ) {\n body = await parseBody(req);\n if (body === PARSE_FAILED) return json({ error: \"invalid JSON\" }, 400);\n }\n\n // Resolve auth for all room-scoped requests\n const authResult = await resolveAuth(req, roomId);\n if (authResult instanceof Response) return authResult;\n const auth = authResult;\n\n const sub = parts[2];\n const subId = parts[3];\n const subAction = parts[4];\n\n // ---- v7: Room invitation ----\n if (sub === \"invite\" && method === \"POST\") {\n return handleInvite(req, roomId, body);\n }\n\n // ---- v7: Room claim (orphaned rooms) ----\n if (sub === \"claim\" && method === \"POST\") {\n return handleClaim(req, roomId, body);\n }\n\n // ---- v7: Room deletion (owner only) ----\n if (!sub && method === \"DELETE\") {\n if (!auth.authenticated) {\n return json({ error: \"authentication_required\" }, 401);\n }\n // Check ownership: admin auth OR direct user_rooms owner check\n let isOwner = auth.kind === \"room\" || auth.grants.includes(\"*\");\n if (!isOwner && auth.userId) {\n const ownerCheck = await sqlite.execute({\n sql:\n `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ? AND access = 'owner'`,\n args: [auth.userId, roomId],\n });\n isOwner = ownerCheck.rows.length > 0;\n }\n // Fallback: if no user_rooms entries exist for this room at all, allow owner-scoped token\n if (!isOwner && auth.userId) {\n const anyUsers = await sqlite.execute({\n sql: `SELECT COUNT(*) FROM smcp_user_rooms WHERE room_id = ?`,\n args: [roomId],\n });\n if (Number(anyUsers.rows[0][0]) === 0) isOwner = true; // orphaned room, allow cleanup\n }\n if (!isOwner) {\n return json({\n error: \"owner_required\",\n message: \"Only room owners can delete rooms\",\n }, 403);\n }\n // Delete room and all related data (FK constraints off for clean cascade)\n try {\n await sqlite.execute({ sql: `PRAGMA foreign_keys = OFF`, args: [] });\n } catch {}\n const tables = [\n `DELETE FROM state WHERE room_id = ?`,\n `DELETE FROM log_index WHERE room_id = ?`,\n `DELETE FROM tokens WHERE room_id = ?`,\n `DELETE FROM smcp_embodiments WHERE room_id = ?`,\n `DELETE FROM smcp_vault WHERE room_id = ?`,\n `DELETE FROM smcp_user_rooms WHERE room_id = ?`,\n `DELETE FROM rooms WHERE id = ?`,\n ];\n for (const sql of tables) {\n try {\n await sqlite.execute({ sql, args: [roomId] });\n } catch {}\n }\n try {\n await sqlite.execute({ sql: `PRAGMA foreign_keys = ON`, args: [] });\n } catch {}\n return json({ deleted: true, room: roomId });\n }\n\n // ---- v9: SSR dashboard (canonical URL) ----\n if (method === \"GET\" && sub === \"dashboard\") return renderDashboardPage(roomId);\n\n // ---- Agents ----\n if (sub === \"agents\") {\n if (method === \"POST\" && !subId) return joinRoom(roomId, body, req);\n if (method === \"PATCH\" && subId && !subAction) {\n const deny = requireRoomToken(auth);\n if (deny) return deny;\n return updateAgent(roomId, subId, body);\n }\n }\n\n // ---- Actions (invoke only — writes via built-in actions) ----\n if (sub === \"actions\") {\n if (method === \"POST\" && subId && subAction === \"invoke\") {\n const deny = requireWriteAuth(auth);\n if (deny) return deny;\n const identityDeny = assertIdentity(auth, body.agent);\n if (identityDeny) return identityDeny;\n return invokeAction(roomId, subId, body, auth);\n }\n }\n\n // ---- Wait ----\n if (method === \"GET\" && sub === \"wait\") {\n return waitForCondition(roomId, url, auth);\n }\n\n // ---- Context ----\n if (method === \"GET\" && sub === \"context\") {\n return getContext(roomId, url, auth);\n }\n\n // ---- Dashboard poll (v8: state-only) ----\n if (method === \"GET\" && sub === \"poll\") {\n return dashboardPoll(roomId, url, auth);\n }\n\n // ---- Replay ----\n if (method === \"GET\" && sub === \"replay\" && subId) {\n const seq = parseInt(subId);\n if (isNaN(seq) || seq < 0) {\n return json({ error: \"seq must be a non-negative integer\" }, 400);\n }\n const result = await replayRoom(roomId, seq);\n return json(result);\n }\n\n // ---- v8: Key history (temporal projection) ----\n // GET /rooms/:id/history/:scope/:key?limit=100&after=seq\n if (method === \"GET\" && sub === \"history\" && subId && subAction) {\n const scope = subId;\n const key = subAction;\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"100\");\n const after = url.searchParams.get(\"after\")\n ? parseInt(url.searchParams.get(\"after\")!)\n : undefined;\n const prefix = url.searchParams.get(\"prefix\");\n\n if (prefix) {\n // Prefix query: /rooms/:id/history/:scope/_?prefix=concepts.\n const results = await queryPrefixHistory(roomId, scope, prefix, {\n limit,\n after,\n });\n return json({ room_id: roomId, scope, prefix, entries: results });\n }\n\n const results = await queryKeyHistory(roomId, scope, key, { limit, after });\n return json({ room_id: roomId, scope, key, entries: results });\n }\n\n // ---- v8: View value samples (temporal sparklines) ----\n // GET /rooms/:id/samples/:viewId?limit=100&after=seq\n if (method === \"GET\" && sub === \"samples\" && subId) {\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"100\");\n const after = url.searchParams.get(\"after\")\n ? parseInt(url.searchParams.get(\"after\")!)\n : undefined;\n const results = await queryViewSamples(roomId, subId, { limit, after });\n return json({ room_id: roomId, view_id: subId, samples: results });\n }\n\n // ---- v9: Salience map (agent-specific relevance scores via meta.ts) ----\n // GET /rooms/:id/salience?limit=50&agent=X (agent param for room/admin tokens)\n if (method === \"GET\" && sub === \"salience\") {\n if (!auth.authenticated) {\n return json({\n error: \"agent_auth_required\",\n message: \"Salience requires authentication\",\n }, 401);\n }\n let agentId = auth.agentId;\n const agentParam = url.searchParams.get(\"agent\");\n if (\n agentParam &&\n (auth.kind === \"room\" || auth.kind === \"view\" ||\n auth.grants.includes(\"*\"))\n ) {\n agentId = agentParam;\n }\n if (!agentId) {\n return json({\n error: \"agent_required\",\n message:\n \"Use ?agent= with a room token, or authenticate as an agent\",\n }, 400);\n }\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"50\");\n\n // v9: Use meta.ts for salience computation\n const roomMeta = await computeRoomMeta(roomId);\n const stateResult = await sqlite.execute({\n sql: `SELECT scope, key, value, revision, updated_at FROM state WHERE room_id = ? AND scope NOT IN ('_audit')`,\n args: [roomId],\n });\n const stateRows = rows2objects(stateResult) as any[];\n const agentCtx = await loadAgentContext(roomId, agentId, stateRows);\n\n const entries = stateRows.map((row: any) => {\n let val: any;\n try { val = JSON.parse(row.value); } catch { val = row.value; }\n const score = computeScore(row.scope, row.key, row.updated_at, val, agentCtx, roomMeta);\n return { scope: row.scope, key: row.key, score };\n }).sort((a: any, b: any) => b.score - a.score).slice(0, limit);\n\n return json({\n agent: agentId,\n weights: agentCtx.weights,\n entries,\n computed_at: new Date().toISOString(),\n });\n }\n\n // ---- CEL eval ----\n if (method === \"POST\" && sub === \"eval\") {\n return evalExpression(roomId, body, auth);\n }\n\n // ---- View token rotation (admin only) ----\n if (method === \"POST\" && sub === \"rotate-view-token\") {\n const deny = requireRoomToken(auth);\n if (deny) return deny;\n return rotateViewToken(roomId);\n }\n\n // ---- Generate view token for existing rooms that don't have one (admin only) ----\n if (method === \"POST\" && sub === \"generate-view-token\") {\n const deny = requireRoomToken(auth);\n if (deny) return deny;\n const existing = await sqlite.execute({\n sql: `SELECT view_token_hash FROM rooms WHERE id = ?`,\n args: [roomId],\n });\n const room = rows2objects(existing)[0];\n if (room?.view_token_hash) {\n return json({\n error: \"view_token_exists\",\n message:\n \"room already has a view token — use rotate-view-token to replace it\",\n }, 409);\n }\n return rotateViewToken(roomId);\n }\n\n return json({ error: \"not found\" }, 404);\n}",[264],"7cdbb69c-21e0-11f1-b2f7-42dde27851f2","invoke.ts","debb3da0-1ad9-11f1-b21b-42dde27851f2",635,["D",1773738347617],"/**\n * invoke.ts — Action invocation engine and built-in action dispatch.\n *\n * Contains invokeAction (the ~350-line write engine), invokeBuiltinAction,\n * and the BUILTIN_ACTIONS / OVERRIDABLE_BUILTINS constants.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport {\n json, rows2objects, contentHash, deepSubstitute, deepMerge,\n} from \"./utils.ts\";\nimport { buildContext, celEval, evalCelWithParams, buildViewContext, type BuildContextOptions } from \"./cel.ts\";\nimport { computeRoomMeta, computeScore, wrapEntry, loadAgentContext, type RoomMeta } from \"./meta.ts\";\nimport { isTimerLive, getTimerStatus, parseTimer, tickLogicalTimers, validateTimer } from \"./timers.ts\";\nimport { touchAgent, type AuthResult } from \"./auth.ts\";\nimport { appendAuditEntry, appendStructuralEvent } from \"./audit.ts\";\nimport { registerAction, deleteAction, computeContestedTargets } from \"./actions.ts\";\nimport { registerView, deleteView } from \"./views.ts\";\nimport { HELP_SYSTEM } from \"./help-content.ts\";\n\n// ── Builtins ──\n\nexport const BUILTIN_ACTIONS: Record }> = {\n _send_message: {\n description: \"Send a message to the room\",\n params: {\n body: { type: \"string\", description: \"Message content\" },\n kind: { type: \"string\", description: \"Message kind (default: chat)\" },\n },\n },\n _register_action: {\n description: \"Register a new action in the room\",\n params: {\n id: { type: \"string\", description: \"Action ID\" },\n scope: { type: \"string\", description: \"Owning scope\" },\n description: { type: \"string\", description: \"Human-readable description\" },\n if: { type: \"string\", description: \"CEL availability predicate\" },\n enabled: { type: \"string\", description: \"CEL enabled expression\" },\n result: { type: \"string\", description: \"CEL expression evaluated after writes, returned to invoker\" },\n writes: { type: \"array\", description: \"State write templates\" },\n params: { type: \"object\", description: \"Parameter schema\" },\n },\n },\n _delete_action: {\n description: \"Delete an action from the room\",\n params: { id: { type: \"string\", description: \"Action ID to delete\" } },\n },\n _register_view: {\n description: \"Register a computed view. Pass render: { type, label, ... } to create a surface.\",\n params: {\n id: { type: \"string\", description: \"View ID\" },\n expr: { type: \"string\", description: \"CEL expression\" },\n scope: { type: \"string\", description: \"Registrar scope (default: self)\" },\n description: { type: \"string\", description: \"Human-readable description\" },\n enabled: { type: \"string\", description: \"CEL visibility expression\" },\n render: { type: \"object\", description: \"Render hint — makes this view a surface. { type, label, ... }\" },\n },\n },\n _delete_view: {\n description: \"Delete a view from the room\",\n params: { id: { type: \"string\", description: \"View ID to delete\" } },\n },\n help: {\n description: \"Room-specific participant guide (overridable by custom action)\",\n params: {\n key: { type: \"string\", description: \"Help key — omit to list all keys. Try: guide, standard_library, vocabulary_bootstrap\" },\n },\n },\n};\n\n/** Built-in actions that can be overridden by custom actions with the same id.\n * If a room registers a custom action with one of these ids, the custom one\n * wins in both context listing and invocation. */\nexport const OVERRIDABLE_BUILTINS = new Set([\"help\"]);\n\n// ── Invocation ──\n\nexport async function invokeAction(roomId: string, actionId: string, body: any, auth: AuthResult) {\n // Built-in actions: dispatch to handler\n if (actionId.startsWith(\"_\") && BUILTIN_ACTIONS[actionId]) {\n const response = await invokeBuiltinAction(roomId, actionId, body, auth);\n appendAuditEntry(roomId, body.agent ?? auth.agentId, actionId, true, body.params ?? {}, response.status).catch(() => {});\n return response;\n }\n\n const agent = body.agent ?? auth.agentId;\n touchAgent(roomId, agent);\n\n // v8: Read action definition from _actions scope\n const scopeResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [roomId, actionId],\n });\n if (scopeResult.rows.length === 0) {\n // Fall through to overridable built-in if no custom action registered\n if (OVERRIDABLE_BUILTINS.has(actionId) && BUILTIN_ACTIONS[actionId]) {\n const response = await invokeBuiltinAction(roomId, actionId, body, auth);\n appendAuditEntry(roomId, body.agent ?? auth.agentId, actionId, true, body.params ?? {}, response.status).catch(() => {});\n return response;\n }\n return json({ error: \"action not found\" }, 404);\n }\n\n let def: any;\n try { def = JSON.parse(scopeResult.rows[0][0] as string); } catch {\n return json({ error: \"action_corrupt\", action: actionId }, 500);\n }\n\n // Normalize v8 def to match the field names invoke.ts expects\n const action: any = {\n id: actionId,\n scope: def.scope ?? \"_shared\",\n enabled_expr: def.enabled ?? null,\n if_expr: def.if ?? null,\n result_expr: def.result ?? null,\n params_json: def.params ? JSON.stringify(def.params) : null,\n writes_json: def.writes ? JSON.stringify(def.writes) : \"[]\",\n on_invoke_timer_json: def.on_invoke?.timer ? JSON.stringify(def.on_invoke.timer) : null,\n // Timer state from _timer field in scope value\n timer_effect: def._timer?.timer_effect ?? null,\n timer_expires_at: def._timer?.timer_expires_at ?? null,\n timer_ticks_left: def._timer?.timer_ticks_left ?? null,\n };\n\n if (!isTimerLive(action)) {\n // Distinguish cooldown (dormant, will re-enable) from truly expired\n if (action.timer_effect === \"enable\" && getTimerStatus(action) === \"active\") {\n return json({\n error: \"action_cooldown\", action: actionId,\n message: \"action is in cooldown period\",\n available_at: action.timer_expires_at ?? undefined,\n ticks_remaining: action.timer_ticks_left ?? undefined,\n }, 409);\n }\n return json({ error: \"action_expired\", action: actionId }, 404);\n }\n\n const actionScope = action.scope ?? \"_shared\";\n\n // Build context with registrar's scope access for predicate evaluation\n const ctxOpts: BuildContextOptions = { selfAgent: agent ?? undefined };\n if (actionScope !== \"_shared\") {\n ctxOpts.includeScopes = [actionScope];\n }\n const ctx = await buildContext(roomId, ctxOpts);\n\n // Check enabled\n if (action.enabled_expr) {\n try {\n if (!celEval(action.enabled_expr, ctx)) return json({ error: \"action_disabled\", id: actionId }, 409);\n } catch (e: any) { return json({ error: \"cel_error\", field: \"enabled\", detail: e.message }, 400); }\n }\n\n // Validate and merge params\n const params = body.params ?? {};\n if (action.params_json) {\n try {\n const schema = JSON.parse(action.params_json);\n for (const [name, def] of Object.entries(schema as Record)) {\n if (def.enum && params[name] !== undefined && !def.enum.includes(params[name])) {\n return json({ error: \"invalid_param\", param: name, value: params[name], allowed: def.enum }, 400);\n }\n if (def.type && def.type !== \"any\" && params[name] !== undefined && typeof params[name] !== def.type) {\n return json({ error: \"invalid_param_type\", param: name, expected: def.type, actual: typeof params[name] }, 400);\n }\n }\n } catch {}\n }\n\n // Check if predicate\n if (action.if_expr) {\n const result = evalCelWithParams(action.if_expr, ctx, params);\n if (!result.ok) return json({ error: \"cel_error\", field: \"if\", detail: result.error }, 400);\n if (!result.value) return json({ error: \"precondition_failed\", action: actionId, expression: action.if_expr }, 409);\n }\n\n // Execute writes\n const writes = JSON.parse(action.writes_json || \"[]\");\n const statements: any[] = [];\n const executedWrites: any[] = [];\n\n for (const w of writes) {\n // Shared timestamp for consistent ${now} across scope, key + value\n const invokeTs = new Date().toISOString();\n\n // Resolve template vars in scope before authority check\n let writeScope = w.scope ?? \"_shared\";\n if (writeScope.includes(\"${\")) {\n writeScope = writeScope.replace(/\\$\\{(params\\.(\\w+)|self|now)\\}/g, (match: string, full: string, paramName: string) => {\n if (paramName !== undefined) return String(params[paramName] ?? \"\");\n if (full === \"self\") return agent ?? \"\";\n if (full === \"now\") return invokeTs;\n return match;\n });\n }\n\n // Scope enforcement via registrar-identity bridging\n if (writeScope !== \"_shared\" && !writeScope.startsWith(\"_\")) {\n const registrarAllowed = actionScope === writeScope;\n const invokerAllowed = agent === writeScope;\n if (!registrarAllowed && !invokerAllowed) {\n return json({ error: \"scope_denied\", message: `action \"${actionId}\" cannot write to scope \"${writeScope}\"` }, 403);\n }\n }\n\n // Resolve param substitutions in key (single-pass to prevent injection)\n let key = w.key ?? null;\n if (key && key.includes(\"${\")) {\n key = key.replace(/\\$\\{(params\\.(\\w+)|self|now)\\}/g, (match: string, full: string, paramName: string) => {\n if (paramName !== undefined) return String(params[paramName] ?? \"\");\n if (full === \"self\") return agent ?? \"\";\n if (full === \"now\") return invokeTs;\n return match;\n });\n }\n\n // Resolve value\n let value: any;\n if (w.expr === true && typeof w.value === \"string\") {\n const evalResult = evalCelWithParams(w.value, ctx, params);\n if (!evalResult.ok) return json({ error: \"cel_error\", field: \"writes[].value\", detail: evalResult.error, key }, 400);\n value = evalResult.value;\n } else {\n value = deepSubstitute(w.value, params, agent ?? \"\", invokeTs);\n }\n\n let writeTimerCols = parseTimer(null);\n if (w.timer) { const tv = validateTimer(w.timer); if (tv.valid) writeTimerCols = parseTimer(w.timer); }\n const enabledExpr = w.enabled ?? null;\n const wTimerArgs = [writeTimerCols.timer_json, writeTimerCols.timer_expires_at, writeTimerCols.timer_ticks_left,\n writeTimerCols.timer_tick_on, writeTimerCols.timer_effect, writeTimerCols.timer_started_at];\n\n // Handle append\n let sortKey: number | null = null;\n let arrayPushAction: any = undefined;\n if (w.append === true) {\n if (key) {\n // Array-push: append value to JSON array stored at this key\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = ? AND key = ?`,\n args: [roomId, writeScope, key],\n });\n let arr: any[] = [];\n if (existing.rows.length > 0) {\n try {\n const parsed = JSON.parse(existing.rows[0][0] as string);\n arr = Array.isArray(parsed) ? parsed : [parsed];\n } catch { arr = []; }\n }\n if (value === undefined) return json({ error: \"write_failed\", action: actionId, reason: \"value is required for array append\", key }, 400);\n arr.push(value);\n arrayPushAction = arr;\n } else {\n const seqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = ?`,\n args: [roomId, writeScope],\n });\n sortKey = Number(rows2objects(seqResult)[0]?.next_seq ?? 1);\n key = String(sortKey);\n }\n }\n\n if (!key) return json({ error: \"write needs a key (or use append: true)\", write: w }, 400);\n\n // if_version: compare-and-swap on write templates (proof-of-read)\n if (w.if_version !== undefined) {\n let expectedVersion = w.if_version;\n if (typeof expectedVersion === \"string\" && expectedVersion.includes(\"${\")) {\n expectedVersion = expectedVersion.replace(/\\$\\{(params\\.(\\w+)|self|now)\\}/g, (match: string, full: string, paramName: string) => {\n if (paramName !== undefined) return String(params[paramName] ?? \"\");\n if (full === \"self\") return agent ?? \"\";\n if (full === \"now\") return invokeTs;\n return match;\n });\n }\n const expected = String(expectedVersion);\n const current = await sqlite.execute({\n sql: `SELECT version, value, revision FROM state WHERE room_id = ? AND scope = ? AND key = ?`,\n args: [roomId, writeScope, key],\n });\n if (current.rows.length > 0) {\n const row = rows2objects(current)[0];\n if (row.version !== expected) {\n return json({ error: \"version_conflict\", expected_version: expected, current: row }, 409);\n }\n } else if (expected !== \"\") {\n return json({ error: \"not_found\", message: \"key does not exist, use if_version='' to create\", scope: writeScope, key }, 404);\n }\n }\n\n // Handle merge in action writes\n if (w.merge && typeof w.merge === \"object\") {\n let mergePayload = deepSubstitute(w.merge, params, agent ?? \"\", invokeTs);\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = ? AND key = ?`,\n args: [roomId, writeScope, key],\n });\n let currentValue: any = {};\n if (existing.rows.length > 0) { try { currentValue = JSON.parse(existing.rows[0][0] as string); } catch {} }\n const mergedValue = JSON.stringify(deepMerge(currentValue, mergePayload));\n const vHash = await contentHash(mergedValue);\n\n statements.push({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at, enabled_expr,\n timer_json, timer_expires_at, timer_ticks_left, timer_tick_on, timer_effect, timer_started_at)\n VALUES (?, ?, ?, ?, ?, ?, 1, datetime('now'), ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = excluded.version, revision = state.revision + 1,\n updated_at = datetime('now'),\n sort_key = COALESCE(excluded.sort_key, state.sort_key),\n enabled_expr = excluded.enabled_expr,\n timer_json = excluded.timer_json, timer_expires_at = excluded.timer_expires_at,\n timer_ticks_left = excluded.timer_ticks_left, timer_tick_on = excluded.timer_tick_on,\n timer_effect = excluded.timer_effect, timer_started_at = excluded.timer_started_at`,\n args: [roomId, writeScope, key, sortKey, mergedValue, vHash, enabledExpr, ...wTimerArgs],\n });\n executedWrites.push({ scope: writeScope, key, merge: mergePayload });\n } else if (w.increment) {\n // Increment: read-compute-write to maintain hash consistency\n let resolvedIncrement: any = w.increment;\n if (typeof resolvedIncrement === \"string\") {\n resolvedIncrement = deepSubstitute(resolvedIncrement, params, agent ?? \"\", invokeTs);\n const n = Number(resolvedIncrement);\n resolvedIncrement = isNaN(n) ? 1 : n;\n }\n const actionIncrementAmount = typeof resolvedIncrement === \"number\" ? resolvedIncrement : (value ?? 1);\n const existingInc = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = ? AND key = ?`,\n args: [roomId, writeScope, key],\n });\n const currentNum = existingInc.rows.length > 0 ? (parseInt(existingInc.rows[0][0] as string) || 0) : 0;\n const newNum = currentNum + actionIncrementAmount;\n const newValue = String(newNum);\n const vHash = await contentHash(newValue);\n if (existingInc.rows.length > 0) {\n statements.push({\n sql: `UPDATE state SET value = ?, version = ?, revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = ? AND key = ?`,\n args: [newValue, vHash, roomId, writeScope, key],\n });\n } else {\n statements.push({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at, enabled_expr,\n timer_json, timer_expires_at, timer_ticks_left, timer_tick_on, timer_effect, timer_started_at)\n VALUES (?, ?, ?, ?, ?, ?, 1, datetime('now'), ?, ?, ?, ?, ?, ?, ?)`,\n args: [roomId, writeScope, key, sortKey, newValue, vHash, enabledExpr, ...wTimerArgs],\n });\n }\n executedWrites.push({ scope: writeScope, key, value: newNum });\n } else {\n const rawAction = arrayPushAction !== undefined ? arrayPushAction : value;\n const strValue = typeof rawAction === \"string\" ? rawAction : JSON.stringify(rawAction);\n const vHash = await contentHash(strValue);\n statements.push({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at, enabled_expr,\n timer_json, timer_expires_at, timer_ticks_left, timer_tick_on, timer_effect, timer_started_at)\n VALUES (?, ?, ?, ?, ?, ?, 1, datetime('now'), ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = excluded.version, revision = state.revision + 1,\n updated_at = datetime('now'),\n sort_key = COALESCE(excluded.sort_key, state.sort_key),\n enabled_expr = excluded.enabled_expr,\n timer_json = excluded.timer_json, timer_expires_at = excluded.timer_expires_at,\n timer_ticks_left = excluded.timer_ticks_left, timer_tick_on = excluded.timer_tick_on,\n timer_effect = excluded.timer_effect, timer_started_at = excluded.timer_started_at`,\n args: [roomId, writeScope, key, sortKey, strValue, vHash, enabledExpr, ...wTimerArgs],\n });\n executedWrites.push({ scope: writeScope, key, value });\n }\n }\n\n if (statements.length > 0) {\n try {\n await sqlite.batch(statements);\n } catch (e: any) {\n const msg = e.message || String(e);\n const detail = msg.includes(\"SQLITE_CONSTRAINT\") ? msg.split(\":\").slice(1).join(\":\").trim() : msg;\n return json({\n error: \"write_failed\",\n action: actionId,\n detail,\n writes_attempted: executedWrites,\n }, 500);\n }\n }\n\n // Tick logical timers\n for (const w of executedWrites) {\n await tickLogicalTimers(roomId, w.scope, w.key);\n }\n\n // Apply on_invoke cooldown timer — update _timer field in _actions scope\n if (action.on_invoke_timer_json) {\n try {\n const invokeTimer = JSON.parse(action.on_invoke_timer_json);\n const cols = parseTimer(invokeTimer);\n // Re-read current def, update _timer, write back\n const currentResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [roomId, actionId],\n });\n if (currentResult.rows.length > 0) {\n const currentDef = JSON.parse(currentResult.rows[0][0] as string);\n currentDef._timer = {\n timer_json: cols.timer_json,\n timer_expires_at: cols.timer_expires_at,\n timer_ticks_left: cols.timer_ticks_left,\n timer_tick_on: cols.timer_tick_on,\n timer_effect: cols.timer_effect,\n timer_started_at: cols.timer_started_at,\n };\n await sqlite.execute({\n sql: `UPDATE state SET value = ?, revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [JSON.stringify(currentDef), roomId, actionId],\n });\n }\n } catch {}\n }\n\n // Log invocation to _messages\n const logSeqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = '_messages'`,\n args: [roomId],\n });\n const logSeq = Number(rows2objects(logSeqResult)[0]?.next_seq ?? 1);\n const logValue = JSON.stringify({\n from: agent, kind: \"action_invocation\",\n body: `${actionId}(${Object.entries(params).map(([k,v]) => `${k}=${JSON.stringify(v)}`).join(\", \")})`,\n action: actionId, params, writes: executedWrites,\n });\n const logHash = await contentHash(logValue);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at)\n VALUES (?, '_messages', ?, ?, ?, ?, 1, datetime('now'))`,\n args: [roomId, String(logSeq), logSeq, logValue, logHash],\n });\n\n // Include the auto-log message write so audit entries capture it for replay reconstruction\n const auditWrites = [...executedWrites, { scope: \"_messages\", key: String(logSeq), value: JSON.parse(logValue) }];\n appendAuditEntry(roomId, agent, actionId, false, params, 200, auditWrites).catch(() => {});\n\n // Evaluate result expression against post-write state\n let result: any = undefined;\n if (action.result_expr) {\n try {\n const postCtx = await buildContext(roomId, {\n selfAgent: agent ?? undefined,\n includeScopes: actionScope !== \"_shared\" ? [actionScope] : undefined,\n });\n const evalResult = evalCelWithParams(action.result_expr, postCtx, params);\n if (evalResult.ok) {\n result = typeof evalResult.value === \"bigint\" ? Number(evalResult.value) : evalResult.value;\n } else {\n result = { _error: evalResult.error };\n }\n } catch (e: any) {\n result = { _error: e.message };\n }\n }\n\n // v9: Build wrapped entries for written keys\n // The agent sees _meta (provenance, score, velocity) for each key it just affected\n let wrappedWrites: any[] | undefined;\n try {\n const roomMeta = await computeRoomMeta(roomId);\n const postStateRows = await sqlite.execute({\n sql: `SELECT scope, key, value, revision, updated_at FROM state WHERE room_id = ?`,\n args: [roomId],\n });\n const postRows = rows2objects(postStateRows) as any[];\n let postAgentCtx = null;\n if (agent) {\n postAgentCtx = await loadAgentContext(roomId, agent, postRows);\n }\n\n wrappedWrites = [];\n for (const w of executedWrites) {\n const row = postRows.find((r: any) => r.scope === w.scope && r.key === w.key);\n if (row) {\n let val: any;\n try { val = JSON.parse(row.value); } catch { val = row.value; }\n const score = computeScore(w.scope, w.key, row.updated_at, val, postAgentCtx, roomMeta);\n const wrapped = wrapEntry(val, w.scope, w.key, row.revision ?? 0, row.updated_at ?? \"\", roomMeta, score);\n // Override writer/via — the audit entry for this invoke hasn't been scanned yet,\n // so roomMeta still shows the *previous* writer. We know the current one.\n wrapped._meta.writer = agent ?? wrapped._meta.writer;\n wrapped._meta.via = actionId;\n if (agent && !wrapped._meta.writers.includes(agent)) {\n wrapped._meta.writers = [agent, ...wrapped._meta.writers];\n }\n wrappedWrites.push({ scope: w.scope, key: w.key, ...wrapped });\n } else {\n wrappedWrites.push(w);\n }\n }\n } catch {\n // Fallback to unwrapped writes if meta computation fails\n wrappedWrites = executedWrites;\n }\n\n const response: any = { invoked: true, action: actionId, agent, params, writes: wrappedWrites ?? executedWrites };\n if (result !== undefined) response.result = result;\n return json(response);\n}\n\n// ── Built-in action dispatch ──\n\nexport async function invokeBuiltinAction(roomId: string, actionId: string, body: any, auth: AuthResult): Promise {\n const agent = body.agent ?? auth.agentId;\n const params = body.params ?? {};\n touchAgent(roomId, agent);\n\n switch (actionId) {\n case \"_send_message\": {\n const msgBody = params.body;\n if (!msgBody) return json({ error: \"params.body is required\" }, 400);\n const kind = params.kind ?? \"chat\";\n const to = params.to ?? null; // agent ID string or array — directed but not private\n const seqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = '_messages'`,\n args: [roomId],\n });\n const seq = Number(rows2objects(seqResult)[0]?.next_seq ?? 1);\n const msgObj: any = { from: agent, kind, body: msgBody };\n if (to !== null) msgObj.to = Array.isArray(to) ? to : [to];\n const value = JSON.stringify(msgObj);\n const vHash = await contentHash(value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at)\n VALUES (?, '_messages', ?, ?, ?, ?, 1, datetime('now'))`,\n args: [roomId, String(seq), seq, value, vHash],\n });\n return json({ ok: true, action: \"_send_message\", seq, from: agent, kind, ...(msgObj.to ? { to: msgObj.to } : {}) });\n }\n\n case \"_register_action\": {\n return registerAction(roomId, {\n id: params.id,\n scope: params.scope,\n description: params.description,\n if: params.if,\n enabled: params.enabled,\n result: params.result,\n writes: params.writes,\n params: params.params,\n timer: params.timer,\n on_invoke: params.on_invoke,\n }, auth);\n }\n\n case \"_delete_action\": {\n if (!params.id) return json({ error: \"params.id is required\" }, 400);\n return deleteAction(roomId, params.id, auth);\n }\n\n case \"_register_view\": {\n return registerView(roomId, {\n id: params.id,\n expr: params.expr,\n scope: params.scope ?? auth.agentId ?? \"_shared\",\n description: params.description,\n enabled: params.enabled,\n render: params.render,\n timer: params.timer,\n }, auth);\n }\n\n case \"_delete_view\": {\n if (!params.id) return json({ error: \"params.id is required\" }, 400);\n return deleteView(roomId, params.id, auth);\n }\n\n case \"help\": {\n const key = params.key;\n if (!key) {\n // Return index — merge system keys with any room overrides\n const roomHelpResult = await sqlite.execute({\n sql: `SELECT key FROM state WHERE room_id = ? AND scope = '_help' ORDER BY key`,\n args: [roomId],\n });\n const roomKeys = rows2objects(roomHelpResult).map((r: any) => r.key);\n const allKeys = [...new Set([...Object.keys(HELP_SYSTEM), ...roomKeys])];\n return json({\n invoked: true, action: \"help\",\n keys: allKeys,\n usage: 'invoke help({ key: \"\" }) to read a specific entry',\n });\n }\n // Try room override first\n const roomEntry = await sqlite.execute({\n sql: `SELECT value, version, revision FROM state WHERE room_id = ? AND scope = '_help' AND key = ?`,\n args: [roomId, key],\n });\n if (roomEntry.rows.length > 0) {\n const row = rows2objects(roomEntry)[0];\n let content = row.value;\n try { content = JSON.parse(row.value); } catch {}\n return json({\n invoked: true, action: \"help\", key,\n content,\n version: row.version, // hash — supply to if_version to override\n revision: row.revision,\n source: \"room\",\n });\n }\n // System default\n const rawContent = HELP_SYSTEM[key];\n if (!rawContent) {\n return json({\n error: \"help_key_not_found\", key,\n available: Object.keys(HELP_SYSTEM),\n }, 404);\n }\n // Parse JSON keys for cleaner return; keep string keys as strings\n let content: any = rawContent;\n try { content = JSON.parse(rawContent); } catch {}\n // Compute hash so caller can supply it to if_version when overriding\n const hash = await contentHash(rawContent);\n return json({\n invoked: true, action: \"help\", key,\n content,\n version: hash, // supply to if_version to override this key\n revision: 0, // 0 = system default, never written to room state\n source: \"system\",\n });\n }\n\n default:\n return json({ error: \"unknown builtin action\", id: actionId }, 404);\n }\n}\n",[271],"b9c6ac4c-21e0-11f1-9d4c-42dde27851f2",["D",1773738449830],[28],"9d8c8c86-1ce0-11f1-9f12-42dde27851f2","docs.ts","debb2bbc-1ad9-11f1-b21b-42dde27851f2",437,["D",1773188646576],4,"/**\n * docs.ts — Document registry.\n *\n * Single list of filenames per directory. Titles extracted from # headers.\n * To add a doc: add its filename to the array below. That's it.\n */\n\nexport interface DocEntry {\n title: string;\n content: string;\n category: string;\n rawPath: string;\n}\n\n/** Extract title from first markdown # heading, or humanize the filename. */\nfunction extractTitle(content: string, filename: string): string {\n const match = content.match(/^#\\s+(.+)$/m);\n if (match) return match[1].trim();\n return filename.replace(/\\.md$/, \"\").replace(/[-_]/g, \" \").replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n/** Fetch a file's content relative to this module. */\nasync function fetchFile(path: string): Promise {\n const url = new URL(`./${path}`, import.meta.url);\n return fetch(url).then(r => r.text());\n}\n\n// ── Load content ──\n\nexport const README = await fetchFile(\"README.md\");\n\n// One array per directory. Add a filename and it works.\nconst REF_FILES = [\n \"api.md\", \"cel.md\", \"examples.md\", \"surfaces.md\",\n \"v6.md\", \"help.md\", \"views.md\", \"landing.md\",\n];\nconst DOC_FILES = [\n \"what-becomes-true.md\", \"introducing-sync.md\", \"the-substrate-thesis.md\",\n \"SUBSTRATE.md\", \"isnt-this-just-react.md\", \"pressure-field.md\",\n \"sigma-calculus.md\", \"surfaces-design.md\", \"agent-sync-technical-design.md\",\n \"agency-and-identity.md\", \"frontend-unify.md\", \"adaptive-salience.md\",\n \"the-self-assembling-harness.md\",\n];\n\nexport const REFERENCE_FILES: Record = {};\nawait Promise.all(REF_FILES.map(async name => {\n REFERENCE_FILES[name] = await fetchFile(`reference/${name}`);\n}));\n\nexport const DOC_ESSAY_FILES: Record = {};\nawait Promise.all(DOC_FILES.map(async name => {\n DOC_ESSAY_FILES[name] = await fetchFile(`docs/${name}`);\n}));\n\n// ── Build registry — titles derived from content, not a second map ──\n\nexport const DOC_REGISTRY: Record = {};\n\nfor (const [name, content] of Object.entries(REFERENCE_FILES)) {\n const slug = name.replace(/\\.md$/, \"\");\n DOC_REGISTRY[slug] = { title: extractTitle(content, name), content, category: \"reference\", rawPath: `/reference/${name}` };\n}\n\nDOC_REGISTRY[\"SKILL\"] = { title: \"Skill Guide\", content: README, category: \"reference\", rawPath: \"/SKILL.md\" };\n\nfor (const [name, content] of Object.entries(DOC_ESSAY_FILES)) {\n const slug = name.replace(/\\.md$/, \"\");\n DOC_REGISTRY[slug] = { title: extractTitle(content, name), content, category: \"essay\", rawPath: `/docs/${name}` };\n}\n",[281],"1b8d8c2e-2075-11f1-8859-42dde27851f2","deps.ts","1b8d8d5a-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * deps.ts — CEL dependency extraction.\n *\n * Verified against @marcbachmann/cel-js AST output (March 2026).\n *\n * AST format:\n * { op: \"id\", args: \"state\" } — identifier (args is a STRING)\n * { op: \".\", args: [parent, \"field\"] } — member access\n * { op: \"[]\", args: [obj, index] } — bracket access\n * { op: \"value\", args: \"literal\" } — literal value\n * { op: \"==\", args: [left, right] } — comparison\n * { op: \"?:\", args: [cond, then, else] } — ternary\n * { op: \"&&\", args: [left, right] } — logical and\n *\n * CRITICAL: Pipe expressions (state._shared | keys() | filter(...))\n * are NOT parseable by parse() — they fail with \"Unexpected character: |\".\n * evaluate() handles them at runtime but the AST is unavailable.\n * For pipe expressions, we fall back to regex extraction.\n *\n * Strategy:\n * 1. Try AST walking (covers direct access, bracket access, comparisons)\n * 2. Fall back to regex for pipe expressions and parse failures\n * 3. Complement with Proxy tracing at runtime (optional validation)\n */\n\nimport { parse } from \"npm:@marcbachmann/cel-js\";\n\n// ── Types ──────────────────────────────────────────────────────────────\n\nexport interface Dependency {\n root: \"state\" | \"views\" | \"agents\" | \"actions\" | \"messages\";\n scope?: string;\n key?: string;\n prefix?: string;\n access: \"direct\" | \"scope\" | \"prefix\" | \"full\";\n certainty: \"static\" | \"regex\" | \"runtime\";\n}\n\nexport type DependencySet = Dependency[];\n\n// ── Context roots ──────────────────────────────────────────────────────\n\nconst CONTEXT_ROOTS = new Set([\"state\", \"views\", \"agents\", \"actions\", \"messages\"]);\n\n// ── AST Walking (verified format) ──────────────────────────────────────\n\n/**\n * Resolve a member access chain from an AST node.\n * Returns [\"state\", \"_shared\", \"phase\"] for state._shared.phase\n */\nfunction resolveChain(node: any): string[] | null {\n if (!node || typeof node !== \"object\") return null;\n\n // Identifier: { op: \"id\", args: \"state\" }\n if (node.op === \"id\" && typeof node.args === \"string\") {\n return [node.args];\n }\n\n // Member access: { op: \".\", args: [parent, \"field\"] }\n if (node.op === \".\" && Array.isArray(node.args) && node.args.length === 2) {\n const parent = resolveChain(node.args[0]);\n const field = node.args[1];\n if (parent && typeof field === \"string\") {\n return [...parent, field];\n }\n return null;\n }\n\n // Bracket access: { op: \"[]\", args: [obj, { op: \"value\", args: \"key\" }] }\n if (node.op === \"[]\" && Array.isArray(node.args) && node.args.length === 2) {\n const parent = resolveChain(node.args[0]);\n const index = node.args[1];\n if (parent && index?.op === \"value\" && typeof index.args === \"string\") {\n return [...parent, index.args];\n }\n return null;\n }\n\n return null;\n}\n\n/**\n * Walk an AST and extract dependencies.\n * Only records the MOST SPECIFIC dep per chain (direct > scope > full).\n */\nfunction walkAst(node: any, deps: Dependency[], seen: Set) {\n if (!node || typeof node !== \"object\") return;\n\n function addDep(dep: Dependency) {\n const k = JSON.stringify(dep);\n if (seen.has(k)) return;\n seen.add(k);\n deps.push(dep);\n }\n\n // Find the deepest resolvable chain at this node.\n // We want state._shared.phase to produce ONE dep (direct), not three.\n function deepestChain(n: any): string[] | null {\n // Try to extend: if this is a \".\" with a child that's also a \".\",\n // the parent will be covered by the child's walk. So only resolve\n // at leaf positions (nodes not used as operands in a deeper \".\").\n const chain = resolveChain(n);\n return chain;\n }\n\n // Check if this node is a leaf in a member chain (not the operand of a parent \".\")\n // We handle this by only recording deps for the TOP-LEVEL chain at each point.\n const chain = deepestChain(node);\n if (chain && chain.length > 0 && CONTEXT_ROOTS.has(chain[0])) {\n const root = chain[0] as Dependency[\"root\"];\n if (root === \"state\") {\n if (chain.length >= 3) {\n addDep({ root: \"state\", scope: chain[1], key: chain[2], access: \"direct\", certainty: \"static\" });\n } else if (chain.length === 2) {\n addDep({ root: \"state\", scope: chain[1], access: \"scope\", certainty: \"static\" });\n } else {\n addDep({ root: \"state\", access: \"full\", certainty: \"static\" });\n }\n } else {\n if (chain.length >= 2) {\n addDep({ root, key: chain[1], access: \"direct\", certainty: \"static\" });\n } else {\n addDep({ root, access: \"scope\", certainty: \"static\" });\n }\n }\n // For member chains, DON'T recurse into children — the chain\n // already captured the full access path. Recurse into non-chain\n // siblings (e.g. the right side of a comparison).\n if (node.op === \".\" || node.op === \"[]\") return;\n }\n\n // Not a resolvable chain — recurse into args\n if (Array.isArray(node.args)) {\n for (const arg of node.args) {\n if (arg && typeof arg === \"object\") walkAst(arg, deps, seen);\n }\n }\n}\n\n// ── Regex Fallback (for pipe expressions) ──────────────────────────────\n\n/**\n * Extract dependencies from a CEL expression string using regex.\n * Used when AST parsing fails (pipe expressions) or as a supplement.\n */\nfunction extractRegex(expr: string): Dependency[] {\n const deps: Dependency[] = [];\n const seen = new Set();\n\n function addDep(dep: Dependency) {\n const k = JSON.stringify(dep);\n if (seen.has(k)) return;\n seen.add(k);\n deps.push(dep);\n }\n\n // Direct key access: state._shared.phase or state._shared.theses.x\n const directPattern = /state\\.([a-zA-Z_][a-zA-Z0-9_]*)\\.([a-zA-Z_][a-zA-Z0-9_]*)/g;\n let m;\n while ((m = directPattern.exec(expr))) {\n addDep({ root: \"state\", scope: m[1], key: m[2], access: \"direct\", certainty: \"regex\" });\n }\n\n // Scope-level access: state._shared (without further key, e.g. in pipe chains)\n const scopePattern = /state\\.([a-zA-Z_][a-zA-Z0-9_]*)\\s*[|)]/g;\n while ((m = scopePattern.exec(expr))) {\n addDep({ root: \"state\", scope: m[1], access: \"scope\", certainty: \"regex\" });\n }\n\n // Bracket access: state._shared[\"key.with.dots\"]\n const bracketPattern = /state\\.([a-zA-Z_][a-zA-Z0-9_]*)\\[\"([^\"]+)\"\\]/g;\n while ((m = bracketPattern.exec(expr))) {\n addDep({ root: \"state\", scope: m[1], key: m[2], access: \"direct\", certainty: \"regex\" });\n }\n\n // startsWith patterns: k.startsWith(\"concepts.\")\n const prefixPattern = /startsWith\$[\"']([^\"']+)[\"']\$/g;\n while ((m = prefixPattern.exec(expr))) {\n addDep({ root: \"state\", prefix: m[1], access: \"prefix\", certainty: \"regex\" });\n }\n\n // View references: views[\"concept_count\"] or views.concept_count\n const viewPattern1 = /views\\[\"([^\"]+)\"\\]/g;\n while ((m = viewPattern1.exec(expr))) {\n addDep({ root: \"views\", key: m[1], access: \"direct\", certainty: \"regex\" });\n }\n const viewPattern2 = /views\\.([a-zA-Z_][a-zA-Z0-9_]*)/g;\n while ((m = viewPattern2.exec(expr))) {\n addDep({ root: \"views\", key: m[1], access: \"direct\", certainty: \"regex\" });\n }\n\n // Agent/action references\n const agentPattern = /agents\\.([a-zA-Z_][a-zA-Z0-9_]*)/g;\n while ((m = agentPattern.exec(expr))) {\n addDep({ root: \"agents\", key: m[1], access: \"direct\", certainty: \"regex\" });\n }\n\n // Messages reference\n if (/messages\\b/.test(expr)) {\n addDep({ root: \"messages\", access: \"scope\", certainty: \"regex\" });\n }\n\n // Bare \"agents\" or \"actions\" in pipe chains\n if (/\\bagents\\s*[|.]/.test(expr) || /\\bagents\\s*\\|/.test(expr)) {\n addDep({ root: \"agents\", access: \"full\", certainty: \"regex\" });\n }\n if (/\\bactions\\s*[|.]/.test(expr) || /\\bactions\\s*\\|/.test(expr)) {\n addDep({ root: \"actions\", access: \"full\", certainty: \"regex\" });\n }\n\n return deps;\n}\n\n// ── Main extraction ────────────────────────────────────────────────────\n\n/**\n * Extract dependencies from a CEL expression.\n *\n * Tries AST walking first (accurate, handles member access chains).\n * Falls back to regex for pipe expressions (which fail to parse).\n * Returns a deduplicated array.\n */\nexport function extractDependencies(expr: string): DependencySet {\n const deps: Dependency[] = [];\n const seen = new Set();\n\n // Try AST walking\n let astWorked = false;\n try {\n const compiled = parse(expr);\n if (compiled?.ast) {\n walkAst(compiled.ast, deps, seen);\n astWorked = true;\n }\n } catch {\n // Parse failed (likely pipe expression) — fall through to regex\n }\n\n // Always run regex to catch pipe expressions and supplement AST\n const regexDeps = extractRegex(expr);\n for (const dep of regexDeps) {\n const k = JSON.stringify({ ...dep, certainty: undefined });\n // Only add regex deps that aren't already covered by AST deps\n const hasStatic = deps.some(d => {\n const dk = JSON.stringify({ ...d, certainty: undefined });\n return dk === k;\n });\n if (!hasStatic) {\n const fullK = JSON.stringify(dep);\n if (!seen.has(fullK)) {\n seen.add(fullK);\n deps.push(dep);\n }\n }\n }\n\n return deps;\n}\n\n// ── Proxy Tracing ──────────────────────────────────────────────────────\n\n/**\n * Wrap a CEL context in Proxies that record property access.\n * Use to validate/supplement extracted dependencies at runtime.\n */\nexport function traceContext(ctx: Record): {\n traced: Record;\n getAccesses: () => DependencySet;\n} {\n const accesses: Array<{ path: string[] }> = [];\n\n function proxyWrap(obj: any, path: string[]): any {\n if (obj === null || typeof obj !== \"object\") return obj;\n if (typeof obj === \"function\") return obj;\n\n return new Proxy(obj, {\n get(target, prop, receiver) {\n if (typeof prop === \"symbol\") return Reflect.get(target, prop, receiver);\n const key = String(prop);\n if (key === \"toJSON\" || key === \"constructor\" || key === \"prototype\" ||\n key === \"then\" || key === \"length\" || key === \"toString\" || key === \"valueOf\") {\n return Reflect.get(target, prop, receiver);\n }\n accesses.push({ path: [...path, key] });\n const val = Reflect.get(target, prop, receiver);\n return proxyWrap(val, [...path, key]);\n },\n });\n }\n\n function getAccesses(): DependencySet {\n const deps: Dependency[] = [];\n const seen = new Set();\n for (const { path } of accesses) {\n if (path.length === 0 || !CONTEXT_ROOTS.has(path[0])) continue;\n const root = path[0] as Dependency[\"root\"];\n let dep: Dependency;\n if (root === \"state\") {\n if (path.length >= 3) dep = { root: \"state\", scope: path[1], key: path[2], access: \"direct\", certainty: \"runtime\" };\n else if (path.length === 2) dep = { root: \"state\", scope: path[1], access: \"scope\", certainty: \"runtime\" };\n else dep = { root: \"state\", access: \"full\", certainty: \"runtime\" };\n } else {\n dep = { root, key: path.length >= 2 ? path[1] : undefined, access: path.length >= 2 ? \"direct\" : \"scope\", certainty: \"runtime\" };\n }\n const k = JSON.stringify(dep);\n if (!seen.has(k)) { seen.add(k); deps.push(dep); }\n }\n return deps;\n }\n\n return { traced: proxyWrap(ctx, []), getAccesses };\n}\n\n// ── Utilities ──────────────────────────────────────────────────────────\n\nexport function mergeDependencies(staticDeps: DependencySet, runtimeDeps: DependencySet): DependencySet {\n const seen = new Set();\n const merged: Dependency[] = [];\n for (const dep of staticDeps) {\n const k = JSON.stringify({ ...dep, certainty: undefined });\n if (!seen.has(k)) { seen.add(k); merged.push(dep); }\n }\n for (const dep of runtimeDeps) {\n const k = JSON.stringify({ ...dep, certainty: undefined });\n if (!seen.has(k)) { seen.add(k); merged.push(dep); }\n }\n return merged;\n}\n\nexport function isRelevant(deps: DependencySet, scope: string, key: string): boolean {\n for (const dep of deps) {\n if (dep.root !== \"state\") continue;\n if (dep.access === \"full\") return true;\n if (dep.access === \"scope\" && dep.scope === scope) return true;\n if (dep.access === \"direct\" && dep.scope === scope && dep.key === key) return true;\n if (dep.access === \"prefix\" && dep.prefix && key.startsWith(dep.prefix)) {\n if (!dep.scope || dep.scope === scope) return true;\n }\n }\n return false;\n}\n\n// ── Probe (development) ────────────────────────────────────────────────\n\nexport function probeAst(expr: string): any {\n try {\n const compiled = parse(expr);\n return compiled.ast;\n } catch (e: any) {\n return { error: e.message };\n }\n}\n",[289],"e6c48c9c-1708-11f1-95df-42dde27851f2","deno.json","e6c48d14-1708-11f1-95df-42dde27851f2",200,["D",1772546242374],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"tasks\": {\n \"dev\": \"deno run -A --import-map=local/import_map.json local/dev.ts\"\n },\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[295],"89c4c3e6-2198-11f1-9238-42dde27851f2","context.ts","debad81a-1ad9-11f1-b21b-42dde27851f2",["D",1773707445460],"/**\n * context.ts — v9 Projection layer.\n *\n * Takes the full wrapped context from buildContext (engine layer) and shapes\n * it for the requesting agent based on salience thresholds.\n *\n * Three tiers:\n * Focus (score >= focus_threshold): full value + full _meta\n * Peripheral (score >= elide_threshold): full value + minimal _meta\n * Elided (score < elide_threshold): value: null + minimal _meta + expand hint\n *\n * Override params:\n * expand — force specific keys to Focus (e.g. [\"_shared.some_key\"])\n * elision — \"none\" to disable elision entirely\n * meta_threshold — override where full _meta kicks in (default: 0.5)\n * focus_threshold — override focus threshold (default: 0.5)\n * elide_threshold — override elide threshold (default: 0.1)\n *\n * Replaces: _salience synthetic view, _contested synthetic view, _context envelope.\n * All metadata now lives in _meta on the relevant entries.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport {\n buildContext,\n celEval,\n evalCel,\n type BuildContextOptions,\n type WrappedEntry,\n type EntryMeta,\n} from \"./cel.ts\";\nimport { isTimerLive } from \"./timers.ts\";\nimport { hasFullReadAccess, touchAgent, type AuthResult } from \"./auth.ts\";\nimport { BUILTIN_ACTIONS, OVERRIDABLE_BUILTINS } from \"./invoke.ts\";\nimport { minimalMeta } from \"./meta.ts\";\n\n// ── ContextRequest ──────────────────────────────────────────────────────\n\nexport interface ContextRequest {\n /** Action detail level */\n depth?: \"lean\" | \"full\" | \"usage\";\n /** Return only these top-level sections */\n only?: string[];\n /** Include actions section (default true) */\n actions?: boolean;\n /** Include messages section (default true) */\n messages?: boolean;\n /** Message seq cursor — only return messages after this seq */\n messagesAfter?: number;\n /** Max messages to return (default 100, max 500) */\n messagesLimit?: number;\n /** Extra state scopes to include (e.g. \"_audit\") */\n include?: string[];\n\n // ── v9 shaping params ──\n\n /** Force specific keys to Focus tier: [\"_shared.key1\", \"_agents.explorer\"] */\n expand?: string[];\n /** Disable elision entirely: \"none\" */\n elision?: \"none\" | \"auto\";\n /** Threshold for full _meta (default 0.5) */\n focusThreshold?: number;\n /** Threshold below which values are elided (default 0.1) */\n elideThreshold?: number;\n}\n\n/** Parse a ContextRequest from URL search params or MCP tool params */\nexport function parseContextRequest(url: URL): ContextRequest {\n const req: ContextRequest = {};\n const depth = url.searchParams.get(\"depth\");\n if (depth === \"lean\" || depth === \"full\" || depth === \"usage\") req.depth = depth;\n const only = url.searchParams.get(\"only\");\n if (only) req.only = only.split(\",\").map((s) => s.trim()).filter(Boolean);\n const actions = url.searchParams.get(\"actions\");\n if (actions === \"false\") req.actions = false;\n const messages = url.searchParams.get(\"messages\");\n if (messages === \"false\") req.messages = false;\n const after = url.searchParams.get(\"messages_after\");\n if (after) req.messagesAfter = parseInt(after);\n const limit = url.searchParams.get(\"messages_limit\");\n if (limit) req.messagesLimit = parseInt(limit);\n const include = url.searchParams.get(\"include\");\n if (include) req.include = include.split(\",\").map((s) => s.trim()).filter(Boolean);\n\n // v9 shaping\n const expand = url.searchParams.get(\"expand\");\n if (expand) req.expand = expand.split(\",\").map((s) => s.trim()).filter(Boolean);\n const elision = url.searchParams.get(\"elision\");\n if (elision === \"none\") req.elision = \"none\";\n const focusThreshold = url.searchParams.get(\"focus_threshold\");\n if (focusThreshold) req.focusThreshold = parseFloat(focusThreshold);\n const elideThreshold = url.searchParams.get(\"elide_threshold\");\n if (elideThreshold) req.elideThreshold = parseFloat(elideThreshold);\n\n return req;\n}\n\n// ── Shaping ─────────────────────────────────────────────────────────────\n\nconst DEFAULT_FOCUS_THRESHOLD = 0.5;\nconst DEFAULT_ELIDE_THRESHOLD = 0.1;\n\n/** Minimal _meta for peripheral/elided tier — strip trajectory/provenance */\nfunction trimMeta(meta: any, elided: boolean, expandHint?: string): any {\n const trimmed: any = {\n score: meta.score,\n revision: meta.revision,\n updated_at: meta.updated_at,\n elided,\n };\n if (elided && expandHint) {\n trimmed.expand = expandHint;\n }\n return trimmed;\n}\n\n/** Check if a scope.key is in the expand list */\nfunction isExpanded(scope: string, key: string, expandSet: Set): boolean {\n return (\n expandSet.has(`${scope}.${key}`) ||\n expandSet.has(`${scope}.*`) ||\n expandSet.has(\"*\")\n );\n}\n\n/**\n * Shape a scope's entries by salience threshold.\n *\n * Focus: full value + full _meta\n * Peripheral: full value + trimmed _meta (score, revision, updated_at)\n * Elided: value: null + trimmed _meta + expand hint\n */\nfunction shapeScope(\n scope: string,\n entries: Record,\n focusThreshold: number,\n elideThreshold: number,\n expandSet: Set,\n noElision: boolean,\n): Record {\n const shaped: Record = {};\n\n for (const [key, entry] of Object.entries(entries)) {\n const score = entry._meta?.score ?? 0;\n const forceExpand = isExpanded(scope, key, expandSet);\n\n if (forceExpand || noElision || score >= focusThreshold) {\n // Focus tier: full value + full _meta\n shaped[key] = entry;\n } else if (score >= elideThreshold) {\n // Peripheral tier: full value + trimmed _meta\n shaped[key] = {\n value: entry.value,\n _meta: trimMeta(entry._meta, false),\n };\n } else {\n // Elided tier: null value + minimal _meta + expand hint\n shaped[key] = {\n value: null,\n _meta: trimMeta(\n entry._meta,\n true,\n `?expand=${scope}.${key}`,\n ),\n };\n }\n }\n\n return shaped;\n}\n\n// ── buildExpandedContext ─────────────────────────────────────────────────\n\n/**\n * Build the agent-facing context response.\n *\n * v9: Returns wrapped { value, _meta } entries shaped by salience threshold.\n * All metadata (salience, provenance, trajectory, contested) lives in _meta.\n * No synthetic views, no _context envelope.\n */\nexport async function buildExpandedContext(\n roomId: string,\n auth: AuthResult,\n req: ContextRequest = {},\n): Promise> {\n const depth = req.depth ?? \"lean\";\n const includeActions = req.actions !== false;\n const includeMessages = req.messages !== false;\n const includedScopes = req.include ?? [];\n\n // Shaping params\n const focusThreshold = req.focusThreshold ?? DEFAULT_FOCUS_THRESHOLD;\n const elideThreshold = req.elideThreshold ?? DEFAULT_ELIDE_THRESHOLD;\n const noElision = req.elision === \"none\";\n const expandSet = new Set(req.expand ?? []);\n\n // ── Engine layer: full wrapped context ──\n const ctx = await buildContext(roomId, {\n selfAgent: auth.agentId ?? undefined,\n allScopes: hasFullReadAccess(auth),\n });\n\n // ── Shape state scopes ──\n const stateOut: Record = {};\n for (const [scope, entries] of Object.entries(ctx.state as Record>)) {\n // Strip _audit and _messages unless opted in\n if (scope === \"_audit\" && !includedScopes.includes(\"_audit\")) continue;\n if (scope === \"_messages\" && !includedScopes.includes(\"_messages\")) continue;\n // Skip system internals\n if (scope === \"_actions\" || scope === \"_views\" || scope === \"_agents\" || scope === \"_config\" || scope === \"_help\") continue;\n\n stateOut[scope] = shapeScope(\n scope, entries, focusThreshold, elideThreshold, expandSet, noElision,\n );\n }\n\n // ── Shape agents ──\n const agentsOut: Record = {};\n for (const [id, entry] of Object.entries(ctx.agents as Record)) {\n // Agents are always focus tier (important for coordination)\n agentsOut[id] = entry;\n }\n\n // ── Shape views ──\n const viewsOut: Record = {};\n for (const [id, entry] of Object.entries(ctx.views as Record)) {\n const score = entry._meta?.score ?? 0;\n if (noElision || score >= elideThreshold || isExpanded(\"_views\", id, expandSet)) {\n viewsOut[id] = score >= focusThreshold || noElision\n ? entry\n : { value: entry.value, _meta: trimMeta(entry._meta, false) };\n } else {\n viewsOut[id] = {\n value: null,\n _meta: trimMeta(entry._meta, true, `?expand=_views.${id}`),\n };\n }\n }\n\n // ── Actions ──\n let actionsOut: Record | undefined;\n\n if (includeActions) {\n actionsOut = {};\n\n // Custom actions from engine context (already wrapped with action _meta)\n for (const [id, entry] of Object.entries(ctx.actions as Record)) {\n const actionValue = entry.value;\n const actionMeta = entry._meta as any;\n\n const shaped: any = {\n value: {\n available: actionValue.available ?? true,\n description: null as string | null,\n },\n _meta: actionMeta,\n };\n\n // Load full definition for description and depth-dependent fields\n try {\n const defResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [roomId, id],\n });\n if (defResult.rows.length > 0) {\n const def = JSON.parse(defResult.rows[0][0] as string);\n shaped.value.description = def.description ?? null;\n\n if (depth === \"full\" || depth === \"usage\") {\n shaped.value.enabled = true;\n if (def.params) shaped.value.params = def.params;\n if (def.writes?.length > 0) shaped.value.writes = def.writes;\n if (def.if) shaped.value.if = def.if;\n if (def.scope && def.scope !== \"_shared\") shaped.value.scope = def.scope;\n }\n }\n } catch {}\n\n actionsOut[id] = shaped;\n }\n\n // Built-in actions (not in _actions scope — synthesize wrapped entries)\n for (const [id, def] of Object.entries(BUILTIN_ACTIONS)) {\n if (OVERRIDABLE_BUILTINS.has(id) && actionsOut[id]) continue;\n\n const builtinValue: any = {\n available: true,\n builtin: true,\n description: def.description,\n };\n if (depth === \"full\" || depth === \"usage\") {\n builtinValue.enabled = true;\n builtinValue.params = def.params ?? null;\n }\n\n actionsOut[id] = {\n value: builtinValue,\n _meta: {\n ...minimalMeta(0, \"\", 0),\n // Builtins have no audit trail — minimal meta\n invocations: 0,\n last_invoked_at: null,\n last_invoked_by: null,\n contested: [],\n },\n };\n }\n }\n\n // ── Messages ──\n let messagesOut: any;\n let sectionElided: string[] = [];\n\n if (includeMessages) {\n const messagesLimit = Math.min(req.messagesLimit ?? 100, 500);\n let msgSql = `SELECT scope, key, sort_key, value, revision, updated_at,\n timer_json, timer_expires_at, timer_ticks_left, timer_tick_on,\n timer_effect, timer_started_at, enabled_expr\n FROM state WHERE room_id = ? AND scope = '_messages'`;\n const msgArgs: any[] = [roomId];\n if (req.messagesAfter) {\n msgSql += ` AND sort_key > ?`;\n msgArgs.push(req.messagesAfter);\n }\n msgSql += ` ORDER BY sort_key DESC LIMIT ?`;\n msgArgs.push(messagesLimit);\n const msgResult = await sqlite.execute({ sql: msgSql, args: msgArgs });\n let msgRows = rows2objects(msgResult).filter((r: any) => isTimerLive(r));\n msgRows.reverse();\n\n const recentMessages = msgRows.map((r: any) => {\n let parsed: any = {};\n try {\n parsed = JSON.parse(r.value);\n } catch {\n parsed = { body: r.value };\n }\n return { seq: r.sort_key, ...parsed };\n });\n\n // Update last_seen_seq\n if (auth.agentId && recentMessages.length > 0) {\n const maxSeq = Math.max(...recentMessages.map((m: any) => m.seq ?? 0));\n if (maxSeq > 0) {\n sqlite.execute({\n sql: `UPDATE state SET\n value = json_set(value, '$.last_seen_seq', ?),\n revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [maxSeq, roomId, auth.agentId],\n }).catch(() => {});\n }\n }\n\n // Count total for elision detection\n const totalMsgResult = await sqlite.execute({\n sql: `SELECT COUNT(*) as cnt FROM state WHERE room_id = ? AND scope = '_messages'`,\n args: [roomId],\n });\n const totalMessages = Number(rows2objects(totalMsgResult)[0]?.cnt ?? 0);\n const oldestSeq = recentMessages.length > 0 ? (recentMessages[0].seq ?? 0) : 0;\n\n messagesOut = {\n count: ctx.messages.count,\n unread: ctx.messages.unread,\n directed_unread: ctx.messages.directed_unread,\n recent: recentMessages,\n };\n\n if (totalMessages > messagesLimit) {\n messagesOut._meta = {\n total: totalMessages,\n returned: recentMessages.length,\n elided: true,\n expand: `?messages_after=0&messages_limit=${Math.min(totalMessages, 500)}`,\n };\n }\n } else {\n sectionElided.push(\"messages\");\n }\n\n if (!includeActions) {\n sectionElided.push(\"actions\");\n }\n\n // ── Assemble response ──\n let result: Record = {\n state: stateOut,\n views: viewsOut,\n agents: agentsOut,\n ...(actionsOut !== undefined ? { actions: actionsOut } : {}),\n ...(messagesOut !== undefined ? { messages: messagesOut } : {}),\n self: ctx.self,\n };\n\n // ── Apply `only` filter ──\n if (req.only && req.only.length > 0) {\n const filtered: Record = {};\n for (const s of req.only) {\n if (s in result) filtered[s] = result[s];\n if (s.startsWith(\"state.\")) {\n const scope = s.slice(6);\n if (!filtered.state) filtered.state = {};\n if (ctx.state[scope]) {\n filtered.state[scope] = shapeScope(\n scope, ctx.state[scope], focusThreshold, elideThreshold, expandSet, noElision,\n );\n }\n }\n }\n if (result.self) filtered.self = result.self;\n for (const key of Object.keys(result)) {\n if (!(key in filtered) && key !== \"self\") sectionElided.push(key);\n }\n result = filtered;\n }\n\n // ── Shaping summary ──\n // Minimal envelope — just enough for the agent to understand what it got\n const shapingSummary: any = {\n focus_threshold: focusThreshold,\n elide_threshold: elideThreshold,\n elision: noElision ? \"none\" : \"auto\",\n };\n\n // Count shaped entries\n let focusCount = 0;\n let peripheralCount = 0;\n let elidedCount = 0;\n for (const scope of Object.values(stateOut)) {\n for (const entry of Object.values(scope as Record)) {\n const e = entry as any;\n if (e?._meta?.elided) elidedCount++;\n else if (e?._meta?.score !== undefined && !e?._meta?.writers) peripheralCount++;\n else focusCount++;\n }\n }\n shapingSummary.state_entries = {\n focus: focusCount,\n peripheral: peripheralCount,\n elided: elidedCount,\n total: focusCount + peripheralCount + elidedCount,\n };\n\n if (sectionElided.length > 0) {\n shapingSummary.sections_elided = sectionElided;\n }\n\n result._shaping = shapingSummary;\n\n return result;\n}\n\n// ── CEL eval endpoint ───────────────────────────────────────────────────\n\nexport async function evalExpression(\n roomId: string,\n body: any,\n auth: AuthResult,\n) {\n const expr = body.expr;\n if (!expr || typeof expr !== \"string\") {\n return json({ error: \"expr string is required\" }, 400);\n }\n touchAgent(roomId, auth.agentId);\n const ctx = await buildContext(roomId, {\n selfAgent: auth.agentId ?? undefined,\n });\n const result = await evalCel(roomId, expr, ctx);\n if (!result.ok) {\n return json(\n { error: \"cel_error\", expression: expr, detail: result.error },\n 400,\n );\n }\n return json({ expression: expr, value: result.value });\n}\n",[302],"89c44ba0-2198-11f1-9238-42dde27851f2","cel.ts","85ccce52-1048-11f1-ab7f-42dde27851f2",["D",1773707445460],7,"/**\n * cel.ts — CEL (Common Expression Language) evaluator for sync v9.\n *\n * v9: Wrapped state model + Environment API.\n *\n * Every entry in the CEL context is { value, _meta: { ... } }.\n * The Environment registers domain helpers and receiver methods\n * so expressions can query the wrapped shape ergonomically:\n *\n * state._shared.phase.value == \"executing\" // value access\n * state._shared.phase._meta.writer == \"explorer\" // meta access\n * salient(state._shared, 0.5) // domain helper\n * state._shared.keys().filter(k, ...) // receiver method\n * written_by(state._shared, self) // provenance query\n *\n * Three layers:\n * Storage: raw values in SQLite\n * Engine: buildContext wraps every entry with full _meta (this module)\n * Projection: buildExpandedContext shapes _meta by salience threshold (context.ts)\n *\n * Validation pipeline (validateExpression):\n * 1. Parse — syntax check with source-pointed error\n * 2. Check — type-level validation via Environment.check()\n * 3. Lint — static detection of old-style (v8) expressions\n * 4. Eval — trial evaluation against room state (optional)\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport {\n Environment,\n evaluate as bareEvaluate,\n parse,\n ParseError,\n EvaluationError,\n} from \"npm:@marcbachmann/cel-js\";\nimport { isTimerLive } from \"./timers.ts\";\nimport {\n computeRoomMeta,\n computeScore,\n loadAgentContext,\n wrapEntry,\n minimalMeta,\n type AgentContext,\n type RoomMeta,\n type WrappedEntry,\n type EntryMeta,\n} from \"./meta.ts\";\n\n// Re-export for consumers\nexport type { WrappedEntry, EntryMeta };\n\n// ── Singleton Environment ──────────────────────────────────────────────\n//\n// Created once per process. Registers all domain helpers and receiver\n// methods. Used for all CEL evaluation and validation.\n\nlet _env: Environment | null = null;\n\nexport function getCelEnvironment(): Environment {\n if (_env) return _env;\n\n const env = new Environment({\n unlistedVariablesAreDyn: true,\n homogeneousAggregateLiterals: false,\n enableOptionalTypes: true,\n });\n\n // ── Receiver methods (map → list conversions) ──────────────────────\n // The built-in map.keys() and map.entries() don't resolve through dyn\n // at eval time, so we register explicit receiver methods that work\n // regardless of how the map is accessed in the expression.\n\n env.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n description: \"Get all keys from a map as a list\",\n });\n\n env.registerFunction({\n name: \"entries\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) =>\n Object.entries(m).map(([k, v]) => ({ key: k, entry: v })),\n params: [],\n description: \"Get all entries from a map as a list of { key, entry }\",\n });\n\n env.registerFunction({\n name: \"values\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.values(m),\n params: [],\n description: \"Get all values from a map as a list\",\n });\n\n // ── Domain helpers: scope queries ──────────────────────────────────\n\n env.registerFunction({\n signature: \"salient(map, double): list\",\n handler: (scope: any, threshold: number) =>\n Object.keys(scope).filter(\n (k) => (scope[k]?._meta?.score ?? 0) > threshold,\n ),\n description:\n \"Keys in scope with salience score above threshold\",\n });\n\n env.registerFunction({\n signature: \"elided(map): list\",\n handler: (scope: any) =>\n Object.keys(scope).filter((k) => scope[k]?._meta?.elided === true),\n description: \"Keys in scope that are elided (value is null)\",\n });\n\n env.registerFunction({\n signature: \"active(map): list\",\n handler: (scope: any) =>\n Object.keys(scope).filter((k) => !scope[k]?._meta?.elided),\n description: \"Keys in scope that are not elided\",\n });\n\n env.registerFunction({\n signature: \"written_by(map, string): list\",\n handler: (scope: any, agent: string) =>\n Object.keys(scope).filter((k) => scope[k]?._meta?.writer === agent),\n description: \"Keys in scope last written by a specific agent\",\n });\n\n env.registerFunction({\n signature: \"velocity_above(map, double): list\",\n handler: (scope: any, threshold: number) =>\n Object.keys(scope).filter(\n (k) => (scope[k]?._meta?.velocity ?? 0) > threshold,\n ),\n description: \"Keys in scope with write velocity above threshold\",\n });\n\n env.registerFunction({\n signature: \"top_n(map, int): list\",\n handler: (scope: any, n: bigint) =>\n Object.entries(scope)\n .map(([k, v]: [string, any]) => ({\n key: k,\n score: v?._meta?.score ?? 0,\n }))\n .sort((a, b) => b.score - a.score)\n .slice(0, Number(n))\n .map((e) => e.key),\n description:\n \"Top N keys in scope by salience score\",\n });\n\n env.registerFunction({\n signature: \"focus(map): list\",\n handler: (scope: any) =>\n Object.entries(scope)\n .filter(\n ([_, v]: [string, any]) =>\n !v?._meta?.elided && (v?._meta?.score ?? 0) > 0.5,\n )\n .map(([k]) => k),\n description: \"Keys in focus tier (high score, not elided)\",\n });\n\n env.registerFunction({\n signature: \"peripheral(map): list\",\n handler: (scope: any) =>\n Object.entries(scope)\n .filter(([_, v]: [string, any]) => {\n const s = v?._meta?.score ?? 0;\n return !v?._meta?.elided && s > 0.1 && s <= 0.5;\n })\n .map(([k]) => k),\n description:\n \"Keys in peripheral tier (medium score, not elided)\",\n });\n\n // ── Domain helpers: action queries ─────────────────────────────────\n\n env.registerFunction({\n signature: \"contested(map): list\",\n handler: (actions: any) =>\n Object.keys(actions).filter((k) => {\n const c = actions[k]?._meta?.contested;\n return Array.isArray(c) && c.length > 0;\n }),\n description: \"Action IDs that have contested write targets\",\n });\n\n env.registerFunction({\n signature: \"stale(map, int): list\",\n handler: (actions: any, threshold: bigint) =>\n Object.keys(actions).filter(\n (k) => (actions[k]?._meta?.invocations ?? 0) < Number(threshold),\n ),\n description: \"Action IDs with fewer than N invocations\",\n });\n\n // ── Convenience shorthands ─────────────────────────────────────────\n\n env.registerFunction({\n signature: \"val(dyn): dyn\",\n handler: (entry: any) => {\n if (entry && typeof entry === \"object\" && \"value\" in entry) {\n return entry.value;\n }\n return entry;\n },\n description: \"Shorthand: extract .value from a wrapped entry\",\n });\n\n env.registerFunction({\n signature: \"meta(dyn, string): dyn\",\n handler: (entry: any, field: string) => {\n if (entry && typeof entry === \"object\" && \"_meta\" in entry) {\n return entry._meta[field] ?? null;\n }\n return null;\n },\n description: \"Shorthand: extract a _meta field from a wrapped entry\",\n });\n\n _env = env;\n return env;\n}\n\n// ── CEL evaluation (replaces bare evaluate()) ──────────────────────────\n\n/**\n * Evaluate a CEL expression using the sync Environment.\n * All domain helpers and receiver methods are available.\n */\nexport function celEval(expr: string, ctx: Record): any {\n const env = getCelEnvironment();\n return env.evaluate(expr, ctx);\n}\n\n// ── Validation ─────────────────────────────────────────────────────────\n\nexport interface ValidationResult {\n valid: boolean;\n stage: \"parse\" | \"check\" | \"lint\" | \"eval\" | \"ok\";\n error?: string;\n /** Source pointer for parse/eval errors (if available) */\n source?: string;\n /** Actionable hint for fixing the issue */\n hint?: string;\n /** Help key — invoke help({ key }) for detailed guidance */\n help?: string;\n /** Inferred return type (if validation succeeded) */\n type?: string;\n /** Lint warnings (expressions that parse but may be incorrect) */\n warnings?: string[];\n}\n\n/**\n * Detect old-style (v8) CEL patterns that silently produce wrong results\n * under the v9 wrapped shape.\n *\n * These expressions parse and evaluate without error, but compare\n * { value, _meta } objects to primitives (always false) or access\n * fields directly on the wrapped entry instead of on .value.\n */\nfunction lintExpression(expr: string): string[] {\n const warnings: string[] = [];\n\n // Pattern: state.scope.key == \"literal\" (without .value)\n // Compares { value, _meta } to a primitive → always false\n const bareCompare =\n /state\\.(\\w+)\\.(\\w+)\\s*(==|!=|>=|<=|>|<)\\s*(\".*?\"|'.*?'|\\d+(?:\\.\\d+)?|true|false|null)/g;\n let m;\n while ((m = bareCompare.exec(expr))) {\n const fullPath = `state.${m[1]}.${m[2]}`;\n if (\n !fullPath.endsWith(\".value\") && !fullPath.includes(\"._meta\")\n ) {\n const parts = fullPath.split(\".\");\n if (parts.length === 3) {\n warnings.push(\n `\"${fullPath}\" compares a wrapped entry to a primitive. ` +\n `Use \"${fullPath}.value\" instead. See help({ key: \"wrapped_entries\" }).`,\n );\n }\n }\n }\n\n // Pattern: state.scope[\"key\"].field where field isn't value or _meta\n const bracketField =\n /state\\.\\w+\\[\"[^\"]+\"\\]\\.([a-z]\\w+)/g;\n while ((m = bracketField.exec(expr))) {\n const field = m[1];\n if (field !== \"value\" && field !== \"_meta\" && !field.startsWith(\"_\")) {\n warnings.push(\n `\".${field}\" accesses the wrapped entry directly. ` +\n `Use \".value.${field}\" instead. See help({ key: \"wrapped_entries\" }).`,\n );\n }\n }\n\n // Pattern: state.scope.key.field where field isn't value/_meta\n // but only at the 4th dot level (state.scope.key.field)\n const dotField =\n /state\\.(\\w+)\\.(\\w+)\\.([a-z]\\w+)/g;\n while ((m = dotField.exec(expr))) {\n const field = m[3];\n if (\n field !== \"value\" && field !== \"_meta\" && !field.startsWith(\"_\")\n ) {\n // Avoid false positives: state._shared.phase.value.something is fine\n // We only flag state._shared.key.field (not state._shared.key.value.field)\n const preceding = `state.${m[1]}.${m[2]}`;\n // Check that the preceding token isn't \".value\"\n const fullMatch = m[0];\n if (!fullMatch.includes(\".value.\")) {\n warnings.push(\n `\".${field}\" on \"${preceding}\" accesses the wrapped entry directly. ` +\n `Use \"${preceding}.value.${field}\" instead.`,\n );\n }\n }\n }\n\n // Deduplicate\n return [...new Set(warnings)];\n}\n\n/**\n * Validate a CEL expression through a multi-stage pipeline.\n *\n * Stages:\n * 1. parse — syntax check (catches missing operators, bad tokens, etc.)\n * 2. check — type-level validation via Environment.check()\n * 3. lint — static detection of v8-style patterns (silent wrong results)\n * 4. eval — trial evaluation against provided context (optional)\n *\n * Returns structured feedback with error location, hint, and warnings.\n */\nexport function validateExpression(\n expr: string,\n trialCtx?: Record,\n): ValidationResult {\n if (!expr || typeof expr !== \"string\" || expr.trim() === \"\") {\n return {\n valid: false,\n stage: \"parse\",\n error: \"Expression is empty\",\n hint: \"Provide a CEL expression.\",\n };\n }\n\n // ── Stage 1: Parse ──\n try {\n parse(expr);\n } catch (e: any) {\n const msg = e.message || String(e);\n // Extract source pointer if present (lines after the first)\n const lines = msg.split(\"\\n\");\n const source = lines.length > 1 ? lines.slice(1).join(\"\\n\") : undefined;\n\n return {\n valid: false,\n stage: \"parse\",\n error: lines[0],\n source,\n hint: e instanceof ParseError\n ? \"Syntax error. Check: balanced parentheses, valid operators (== not ===), proper string quotes.\"\n : \"Expression could not be parsed.\",\n help: \"expressions\",\n };\n }\n\n // ── Stage 2: Check ──\n // With unlistedVariablesAreDyn, all state access resolves to `dyn` which\n // means the checker can't validate receiver methods (.keys(), .entries())\n // or deep property access. We treat check failures as soft warnings\n // rather than hard errors — the real validation happens at eval time.\n try {\n const env = getCelEnvironment();\n const checkResult = env.check(expr);\n if (!checkResult.valid) {\n const msg = checkResult.error?.message ?? \"Type check failed\";\n // dyn-related failures are soft (receiver methods, overloads on dyn)\n const isDynIssue = msg.includes(\"dyn\") || msg.includes(\"no matching overload\");\n if (!isDynIssue) {\n const lines = msg.split(\"\\n\");\n return {\n valid: false,\n stage: \"check\",\n error: lines[0],\n source: lines.length > 1 ? lines.slice(1).join(\"\\n\") : undefined,\n hint:\n \"Type error. Check that variable types match operators. Use .value for entry values and ._meta for metadata.\",\n help: \"expressions\",\n };\n }\n // dyn type limitation — soft pass, not a real error\n }\n } catch {\n // check() can throw for complex dyn expressions — soft pass\n }\n\n // ── Stage 3: Lint ──\n const warnings = lintExpression(expr);\n\n // ── Stage 4: Trial eval (optional) ──\n if (trialCtx) {\n try {\n const env = getCelEnvironment();\n const result = env.evaluate(expr, trialCtx);\n const type = result === null\n ? \"null\"\n : typeof result === \"bigint\"\n ? \"int\"\n : Array.isArray(result)\n ? \"list\"\n : typeof result === \"object\"\n ? \"map\"\n : typeof result;\n\n return {\n valid: true,\n stage: \"ok\",\n type,\n ...(warnings.length > 0 ? { warnings } : {}),\n };\n } catch (e: any) {\n const msg = e.message || String(e);\n const lines = msg.split(\"\\n\");\n\n let hint: string;\n let help = \"expressions\";\n if (msg.includes(\"No such key\")) {\n const keyMatch = msg.match(/No such key: (\\S+)/);\n const missingKey = keyMatch?.[1] ?? \"\";\n if (missingKey === \"value\" || missingKey === \"_meta\") {\n hint =\n `Key \"${missingKey}\" not found. Only the top-level entry has .value and ._meta — ` +\n `you may be inside .value already.`;\n help = \"wrapped_entries\";\n } else if (missingKey === \"meta\") {\n hint = `Did you mean \"._meta\"? Meta fields use an underscore prefix.`;\n help = \"wrapped_entries\";\n } else {\n hint =\n `Key \"${missingKey}\" not found. Check the key exists, or guard with has().`;\n }\n } else if (msg.includes(\"no such overload\")) {\n hint =\n \"Type mismatch. Wrapped entries are maps — use .value for comparisons.\";\n help = \"wrapped_entries\";\n } else if (msg.includes(\"no matching overload\")) {\n hint =\n \"Function or method not available for this type. See help({ key: \\\"functions\\\" }) for available helpers.\";\n help = \"functions\";\n } else {\n hint =\n \"Expression failed at runtime. Check that referenced keys exist.\";\n }\n\n return {\n valid: false,\n stage: \"eval\",\n error: lines[0],\n source: lines.length > 1 ? lines.slice(1).join(\"\\n\") : undefined,\n hint,\n help,\n ...(warnings.length > 0 ? { warnings } : {}),\n };\n }\n }\n\n // No trial context — return parse+check+lint result\n return {\n valid: true,\n stage: \"ok\",\n ...(warnings.length > 0 ? { warnings } : {}),\n };\n}\n\n/**\n * Legacy-compatible validateCel — wraps validateExpression.\n * Used by actions.ts, views.ts for backward-compatible validation.\n */\nexport function validateCel(\n expr: string,\n): { valid: true; warnings?: string[] } | { valid: false; error: string; hint?: string; warnings?: string[] } {\n const result = validateExpression(expr);\n if (result.valid) {\n return { valid: true, ...(result.warnings?.length ? { warnings: result.warnings } : {}) };\n }\n // \"No such key\" at eval stage is acceptable — the key may not exist yet\n if (result.stage === \"eval\" && result.error?.includes(\"No such key\")) {\n return { valid: true, ...(result.warnings?.length ? { warnings: result.warnings } : {}) };\n }\n return {\n valid: false,\n error: result.error ?? \"validation failed\",\n hint: result.hint,\n ...(result.warnings?.length ? { warnings: result.warnings } : {}),\n };\n}\n\n// ── Internal helpers ───────────────────────────────────────────────────\n\nfunction rows2objects(result: { columns: string[]; rows: any[][] }) {\n return result.rows.map((row) =>\n Object.fromEntries(result.columns.map((col, i) => [col, row[i]]))\n );\n}\n\nfunction parseValue(raw: string): any {\n try {\n return JSON.parse(raw);\n } catch {\n return raw;\n }\n}\n\n// ── buildContext ────────────────────────────────────────────────────────\n\nexport interface BuildContextOptions {\n /** The requesting agent's ID. Used for `self`, scope privacy, and salience scoring. */\n selfAgent?: string;\n /** Additional scopes to include (for view/action evaluation with registrar authority). */\n includeScopes?: string[];\n /** If true, include ALL scopes (for internal/admin use). */\n allScopes?: boolean;\n}\n\n/**\n * Build the CEL evaluation context from room data.\n *\n * v9: Every entry is wrapped as { value, _meta: { ... } }.\n * All evaluation uses the Environment (celEval) for domain helpers.\n */\nexport async function buildContext(\n roomId: string,\n opts: BuildContextOptions = {},\n): Promise> {\n const { selfAgent, includeScopes = [], allScopes = false } = opts;\n\n const stateResult = await sqlite.execute({\n sql: `SELECT scope, key, sort_key, value, revision, updated_at,\n timer_effect, timer_expires_at, timer_ticks_left, enabled_expr\n FROM state WHERE room_id = ?`,\n args: [roomId],\n });\n const stateRows = rows2objects(stateResult) as any[];\n\n const roomMeta = await computeRoomMeta(roomId);\n\n let agentCtx: AgentContext | null = null;\n if (selfAgent) {\n agentCtx = await loadAgentContext(roomId, selfAgent, stateRows);\n }\n\n // ── Build wrapped state tree ──\n const state: Record> = {};\n const deferredEnabled: {\n scope: string;\n key: string;\n value: any;\n revision: number;\n updatedAt: string;\n enabled_expr: string;\n }[] = [];\n\n for (const row of stateRows) {\n if (!isTimerLive(row)) continue;\n\n const scope = row.scope as string;\n const isShared = scope === \"_shared\";\n const isSelf = selfAgent && scope === selfAgent;\n const isExplicitlyIncluded = includeScopes.includes(scope);\n const isSystemScope = scope.startsWith(\"_\");\n\n if (\n !allScopes && !isShared && !isSelf && !isExplicitlyIncluded &&\n !isSystemScope\n ) {\n continue;\n }\n\n if (row.enabled_expr) {\n deferredEnabled.push({\n scope,\n key: row.key,\n value: parseValue(row.value),\n revision: row.revision ?? 0,\n updatedAt: row.updated_at ?? \"\",\n enabled_expr: row.enabled_expr,\n });\n continue;\n }\n\n const contextScope = (isSelf && !allScopes) ? \"self\" : scope;\n if (!state[contextScope]) state[contextScope] = {};\n\n const value = parseValue(row.value);\n const score = computeScore(\n scope, row.key, row.updated_at, value, agentCtx, roomMeta,\n );\n\n state[contextScope][row.key] = wrapEntry(\n value, scope, row.key, row.revision ?? 0, row.updated_at ?? \"\",\n roomMeta, score,\n );\n }\n\n // ── Agents (wrapped) ──\n const agents: Record = {};\n for (const row of stateRows) {\n if (row.scope !== \"_agents\") continue;\n if (!isTimerLive(row)) continue;\n const val = parseValue(row.value);\n const agentData = {\n name: val.name ?? row.key,\n role: val.role ?? \"agent\",\n status: val.status ?? \"active\",\n waiting_on: val.waiting_on ?? null,\n last_heartbeat: val.last_heartbeat ?? null,\n };\n const score = computeScore(\n \"_agents\", row.key, row.updated_at, val, agentCtx, roomMeta,\n );\n agents[row.key] = wrapEntry(\n agentData, \"_agents\", row.key, row.revision ?? 0,\n row.updated_at ?? \"\", roomMeta, score,\n );\n }\n\n // ── Message counts ──\n const countResult = await sqlite.execute({\n sql: `SELECT COUNT(*) as total FROM state WHERE room_id = ? AND scope = '_messages'\n AND (timer_effect IS NULL\n OR (timer_effect = 'delete' AND (timer_expires_at IS NULL OR timer_expires_at > datetime('now'))\n AND (timer_ticks_left IS NULL OR timer_ticks_left > 0))\n OR (timer_effect = 'enable' AND ((timer_expires_at IS NOT NULL AND timer_expires_at <= datetime('now'))\n OR (timer_ticks_left IS NOT NULL AND timer_ticks_left <= 0))))`,\n args: [roomId],\n });\n const totalCount = Number(\n (rows2objects(countResult)[0] as any)?.total || 0,\n );\n\n let unreadCount = 0;\n let directedUnread = 0;\n if (selfAgent) {\n let lastSeen = 0;\n try {\n const agentEntry = stateRows.find(\n (r: any) => r.scope === \"_agents\" && r.key === selfAgent,\n );\n if (agentEntry) {\n const val = parseValue(agentEntry.value);\n lastSeen = val.last_seen_seq ?? 0;\n }\n } catch {}\n const unreadResult = await sqlite.execute({\n sql: `SELECT COUNT(*) as c FROM state WHERE room_id = ? AND scope = '_messages' AND sort_key > ?\n AND (timer_effect IS NULL\n OR (timer_effect = 'delete' AND (timer_expires_at IS NULL OR timer_expires_at > datetime('now'))\n AND (timer_ticks_left IS NULL OR timer_ticks_left > 0))\n OR (timer_effect = 'enable' AND ((timer_expires_at IS NOT NULL AND timer_expires_at <= datetime('now'))\n OR (timer_ticks_left IS NOT NULL AND timer_ticks_left <= 0))))`,\n args: [roomId, lastSeen],\n });\n unreadCount = Number((rows2objects(unreadResult)[0] as any)?.c || 0);\n\n const directedResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_messages' AND sort_key > ?`,\n args: [roomId, lastSeen],\n });\n for (const row of rows2objects(directedResult)) {\n try {\n const msg = JSON.parse((row as any).value);\n if (Array.isArray(msg.to) && msg.to.includes(selfAgent)) {\n directedUnread++;\n }\n } catch {}\n }\n }\n\n // ── Actions (wrapped with action meta) ──\n const actionsCtx: Record = {};\n for (const row of stateRows) {\n if (row.scope !== \"_actions\") continue;\n if (!isTimerLive(row)) continue;\n const val = parseValue(row.value);\n\n if (val.enabled) {\n try {\n const checkCtx = {\n state, views: {}, agents,\n messages: { count: 0, unread: 0, directed_unread: 0 },\n actions: {}, self: selfAgent ?? \"\", params: {},\n };\n if (!celEval(val.enabled, checkCtx)) continue;\n } catch { continue; }\n }\n\n const actionData = { enabled: true, if_expr: val.if ?? null };\n const score = computeScore(\n \"_actions\", row.key, row.updated_at, val, agentCtx, roomMeta,\n );\n actionsCtx[row.key] = wrapEntry(\n actionData, \"_actions\", row.key, row.revision ?? 0,\n row.updated_at ?? \"\", roomMeta, score,\n );\n }\n\n // ── Assemble context ──\n const ctx: Record = {\n state,\n views: {} as Record,\n agents,\n messages: {\n count: totalCount,\n unread: unreadCount,\n directed_unread: directedUnread,\n },\n actions: actionsCtx,\n self: selfAgent ?? \"\",\n params: {},\n };\n\n // ── Deferred enabled entries ──\n for (const d of deferredEnabled) {\n try {\n if (celEval(d.enabled_expr, ctx)) {\n const contextScope =\n selfAgent && d.scope === selfAgent && !allScopes\n ? \"self\"\n : d.scope;\n if (!state[contextScope]) state[contextScope] = {};\n const score = computeScore(\n d.scope, d.key, d.updatedAt, d.value, agentCtx, roomMeta,\n );\n state[contextScope][d.key] = wrapEntry(\n d.value, d.scope, d.key, d.revision, d.updatedAt, roomMeta, score,\n );\n }\n } catch {}\n }\n\n // ── Views (wrapped) ──\n const viewEntries = stateRows.filter(\n (r: any) => r.scope === \"_views\" && isTimerLive(r),\n );\n const views = ctx.views as Record;\n\n for (const row of viewEntries) {\n const val = parseValue(row.value);\n if (!val.expr) continue;\n\n if (val.enabled) {\n try {\n if (!celEval(val.enabled, ctx)) continue;\n } catch { continue; }\n }\n\n const viewCtx = await buildViewContext(\n roomId, val.scope ?? \"_shared\", ctx, roomMeta, agentCtx,\n );\n\n try {\n const result = celEval(val.expr, viewCtx);\n const viewValue = typeof result === \"bigint\" ? Number(result) : result;\n\n const score = computeScore(\n \"_views\", row.key, row.updated_at, viewValue, agentCtx, roomMeta,\n );\n views[row.key] = {\n value: viewValue,\n _meta: {\n ...minimalMeta(row.revision ?? 0, row.updated_at ?? \"\", score),\n writer: val.registered_by ?? null,\n via: null,\n seq: null,\n },\n };\n } catch (e: any) {\n views[row.key] = {\n value: { _error: e.message },\n _meta: minimalMeta(row.revision ?? 0, row.updated_at ?? \"\", 0),\n };\n }\n }\n\n // ── Action availability (post-view resolution) ──\n for (const [_id, entry] of Object.entries(actionsCtx)) {\n const ifExpr = entry.value.if_expr;\n if (ifExpr) {\n try {\n entry.value.available = !!celEval(ifExpr, ctx);\n } catch {\n entry.value.available = false;\n }\n } else {\n entry.value.available = true;\n }\n delete entry.value.if_expr;\n }\n\n return ctx;\n}\n\n/**\n * Build a context for view evaluation that includes the registrar's private scope.\n */\nexport async function buildViewContext(\n roomId: string,\n registrarScope: string,\n baseCtx: Record,\n roomMeta?: RoomMeta,\n agentCtx?: AgentContext | null,\n): Promise> {\n if (registrarScope === \"_shared\" || baseCtx.state[registrarScope]) {\n return baseCtx;\n }\n\n const scopeResult = await sqlite.execute({\n sql: `SELECT key, value, revision, updated_at,\n timer_effect, timer_expires_at, timer_ticks_left, enabled_expr\n FROM state WHERE room_id = ? AND scope = ?`,\n args: [roomId, registrarScope],\n });\n const rows = rows2objects(scopeResult) as any[];\n\n const scopeData: Record = {};\n for (const row of rows) {\n if (!isTimerLive(row)) continue;\n if (row.enabled_expr) {\n try {\n if (!celEval(row.enabled_expr, baseCtx)) continue;\n } catch { continue; }\n }\n const value = parseValue(row.value);\n const score = roomMeta\n ? computeScore(\n registrarScope, row.key, row.updated_at, value,\n agentCtx ?? null, roomMeta,\n )\n : 0;\n scopeData[row.key] = roomMeta\n ? wrapEntry(\n value, registrarScope, row.key, row.revision ?? 0,\n row.updated_at ?? \"\", roomMeta, score,\n )\n : { value, _meta: minimalMeta(row.revision ?? 0, row.updated_at ?? \"\") };\n }\n\n return {\n ...baseCtx,\n state: { ...baseCtx.state, [registrarScope]: scopeData },\n };\n}\n\n// ── Public evaluation API ──────────────────────────────────────────────\n\n/**\n * Evaluate a CEL expression against room state.\n */\nexport async function evalCel(\n roomId: string,\n expr: string,\n ctx?: Record,\n): Promise<{ ok: true; value: any } | { ok: false; error: string }> {\n try {\n const context = ctx ?? (await buildContext(roomId));\n const result = celEval(expr, context);\n const value = typeof result === \"bigint\" ? Number(result) : result;\n return { ok: true, value };\n } catch (e: any) {\n return { ok: false, error: e.message || String(e) };\n }\n}\n\n/**\n * Evaluate a CEL expression with additional params context.\n */\nexport function evalCelWithParams(\n expr: string,\n ctx: Record,\n params: Record,\n): { ok: true; value: any } | { ok: false; error: string } {\n try {\n const extendedCtx = { ...ctx, params };\n const result = celEval(expr, extendedCtx);\n const value = typeof result === \"bigint\" ? Number(result) : result;\n return { ok: true, value };\n } catch (e: any) {\n return { ok: false, error: e.message || String(e) };\n }\n}\n",[308],"1b9125f0-2075-11f1-8859-42dde27851f2","auth.ts","647487ae-122d-11f1-bb2b-42dde27851f2",["D",1773582277011],15,"import { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport {\n parseScope, matchRoom, roleToLevel, minLevel, canWrite as scopeCanWrite,\n canAdmin as scopeCanAdmin, type ScopeLevel,\n} from \"./mcp/scope.ts\";\n\n/**\n * Auth module — unified auth model (v7 Phase 1).\n *\n * Supports BOTH legacy tokens (room_, view_, as_) and unified tokens (tok_).\n * Legacy tokens resolve through rooms/agents tables (unchanged).\n * Unified tokens resolve through the `tokens` table + `smcp_user_rooms`.\n *\n * AuthResult is backward-compatible: existing checks on kind/grants continue to work.\n * New fields (userId, role) are available for new code.\n */\n\n// ============ Token generation and hashing ============\n\nexport async function hashToken(token: string): Promise {\n const data = new TextEncoder().encode(token);\n const hash = await crypto.subtle.digest(\"SHA-256\", data);\n return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\n/** SHA-256 as base64url (used by mcp/db.ts for tokens table). */\nexport async function hashTokenB64(token: string): Promise {\n const data = new TextEncoder().encode(token);\n const hash = await crypto.subtle.digest(\"SHA-256\", data);\n const bytes = new Uint8Array(hash);\n return btoa(String.fromCharCode(...bytes))\n .replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=/g, \"\");\n}\n\nexport function generateToken(prefix: \"room\" | \"view\" | \"as\" = \"as\"): string {\n const bytes = new Uint8Array(24);\n crypto.getRandomValues(bytes);\n return `${prefix}_` + Array.from(bytes).map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\n// ============ Auth resolution ============\n\nexport interface AuthResult {\n authenticated: boolean;\n kind: \"room\" | \"view\" | \"agent\" | null;\n agentId: string | null;\n roomId: string | null;\n grants: string[]; // scopes this identity can direct-write\n\n // ── v7 unified auth fields (null for legacy tokens) ──\n userId?: string | null;\n tokenId?: string | null;\n role?: ScopeLevel | null;\n}\n\nconst UNAUTH: AuthResult = { authenticated: false, kind: null, agentId: null, roomId: null, grants: [] };\n\n/**\n * Resolve auth from request headers. Returns AuthResult or a Response (error).\n */\nexport async function resolveAuth(req: Request, roomId: string): Promise {\n const header = req.headers.get(\"Authorization\");\n if (!header || !header.startsWith(\"Bearer \")) {\n return UNAUTH;\n }\n return resolveAuthFromToken(header.slice(7), roomId);\n}\n\n/**\n * Resolve auth from a raw token string (no HTTP request needed).\n * Handles both legacy tokens (room_, view_, as_) and unified tokens (tok_).\n */\nexport async function resolveAuthFromToken(token: string, roomId: string): Promise {\n // ── Unified token path (tok_ prefix) ──\n if (token.startsWith(\"tok_\") || token.startsWith(\"smcp_at_\")) {\n return resolveUnifiedToken(token, roomId);\n }\n\n // ── Legacy paths (unchanged) ──\n const hash = await hashToken(token);\n\n // Check room token\n if (token.startsWith(\"room_\")) {\n const roomResult = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ? AND token_hash = ?`,\n args: [roomId, hash],\n });\n if (roomResult.rows.length > 0) {\n return { authenticated: true, kind: \"room\", agentId: null, roomId, grants: [\"*\"] };\n }\n return json({ error: \"invalid_token\", message: \"room token does not match\" }, 401);\n }\n\n // Check view token\n if (token.startsWith(\"view_\")) {\n const roomResult = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ? AND view_token_hash = ?`,\n args: [roomId, hash],\n });\n if (roomResult.rows.length > 0) {\n return { authenticated: true, kind: \"view\", agentId: null, roomId, grants: [] };\n }\n return json({ error: \"invalid_token\", message: \"view token does not match\" }, 401);\n }\n\n // Check agent token (as_ or any unknown prefix) — v8: tokens table\n const agentResult = await sqlite.execute({\n sql: `SELECT agent_id, scope, room_id FROM tokens WHERE token_hash = ? AND room_id = ? AND revoked = 0`,\n args: [hash, roomId],\n });\n if (agentResult.rows.length === 0) {\n return json({ error: \"invalid_token\", message: \"bearer token does not match any agent in this room\" }, 401);\n }\n const agentId = agentResult.rows[0][0] as string;\n // Derive grants from scope + agent_id\n let grants: string[] = [agentId];\n // Legacy compatibility: check if _agents scope has explicit grants\n try {\n const scopeResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [roomId, agentId],\n });\n if (scopeResult.rows.length > 0) {\n const def = JSON.parse(scopeResult.rows[0][0] as string);\n if (Array.isArray(def.grants) && def.grants.length > 0) {\n grants = [agentId, ...def.grants.filter((g: string) => g !== agentId)];\n }\n }\n } catch {}\n\n return { authenticated: true, kind: \"agent\", agentId, roomId, grants };\n}\n\n// ============ Unified token resolution (v7) ============\n\n/**\n * Resolve a unified token (tok_ or smcp_at_) against the tokens table.\n *\n * Flow: token → tokens table → user_rooms → scope intersection → embodiment check.\n * Returns backward-compatible AuthResult with v7 extensions.\n */\nasync function resolveUnifiedToken(token: string, roomId: string): Promise {\n // Hash with the same algorithm mcp/db.ts uses (base64url SHA-256)\n const hash = await hashTokenB64(token);\n\n // 1. Token lookup\n const tokenResult = await sqlite.execute({\n sql: `SELECT id, minted_by, scope, room_id, agent_id\n FROM tokens\n WHERE token_hash = ? AND revoked = 0\n AND (expires_at IS NULL OR expires_at > datetime('now'))`,\n args: [hash],\n });\n\n // Also check legacy smcp_access_tokens for smcp_at_ backward compat\n if (tokenResult.rows.length === 0 && token.startsWith(\"smcp_at_\")) {\n return resolveSmcpAccessToken(token, roomId, hash);\n }\n\n if (tokenResult.rows.length === 0) {\n return json({ error: \"invalid_token\", message: \"token not found, expired, or revoked\" }, 401);\n }\n\n const tok = {\n id: tokenResult.rows[0][0] as string,\n mintedBy: tokenResult.rows[0][1] as string,\n scope: tokenResult.rows[0][2] as string,\n roomId: tokenResult.rows[0][3] as string | null,\n agentId: tokenResult.rows[0][4] as string | null,\n };\n\n // 2. Scope check: does this token grant access to the requested room?\n const parsed = parseScope(tok.scope);\n const roomMatch = matchRoom(parsed, roomId);\n if (!roomMatch) {\n // Build stateless elevation URL for the agent to present to the user\n const elevateUrl = `https://sync.parc.land/auth/elevate?token_id=${encodeURIComponent(tok.id)}&room=${encodeURIComponent(roomId)}`;\n return json({\n error: \"scope_denied\",\n message: `Token scope does not include room \"${roomId}\"`,\n room: roomId,\n elevate: elevateUrl,\n hint: \"Present the elevate URL to the user to request access, then retry.\",\n }, 403);\n }\n\n // 3. User's actual room role\n const userRoomResult = await sqlite.execute({\n sql: `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?`,\n args: [tok.mintedBy, roomId],\n });\n\n let userRole: ScopeLevel = \"read\"; // default if no user_rooms entry\n if (userRoomResult.rows.length > 0) {\n userRole = roleToLevel(userRoomResult.rows[0][0] as string);\n }\n\n // 4. Intersect scope with user's actual role\n const effectiveLevel = minLevel(roomMatch.level, userRole);\n\n // 5. Agent resolution\n let agentId = roomMatch.agentId ?? tok.agentId ?? null;\n\n // If no agent from scope, check embodiment\n if (!agentId) {\n const embodimentResult = await sqlite.execute({\n sql: `SELECT agent_id FROM smcp_embodiments\n WHERE session_hash = ? AND room_id = ?`,\n args: [hash, roomId],\n });\n if (embodimentResult.rows.length > 0) {\n agentId = embodimentResult.rows[0][0] as string;\n }\n }\n\n // 6. Map to backward-compatible AuthResult\n const isAdmin = scopeCanAdmin(effectiveLevel);\n const isWrite = scopeCanWrite(effectiveLevel);\n const isReadOnly = !isWrite;\n\n let kind: \"room\" | \"view\" | \"agent\";\n let grants: string[];\n\n if (isAdmin) {\n kind = \"room\";\n grants = [\"*\"];\n } else if (isReadOnly) {\n kind = \"view\";\n grants = [];\n } else if (agentId) {\n kind = \"agent\";\n grants = [agentId, \"_shared\"];\n } else {\n // Write-capable but no agent — treat as view until embodied\n kind = \"view\";\n grants = [];\n }\n\n return {\n authenticated: true,\n kind,\n agentId,\n roomId,\n grants,\n // v7 extensions\n userId: tok.mintedBy,\n tokenId: tok.id,\n role: effectiveLevel,\n };\n}\n\n/**\n * Backward-compat fallback: resolve smcp_at_ tokens from old smcp_access_tokens table.\n * This path exists so existing MCP sessions don't break during Phase 1.\n */\nasync function resolveSmcpAccessToken(token: string, roomId: string, _hash: string): Promise {\n // Delegate to the old MCP path — return as view-level (observe) for safety\n // The MCP handler will resolve embodiment separately\n const result = await sqlite.execute({\n sql: `SELECT user_id FROM smcp_access_tokens WHERE token = ? AND expires_at > datetime('now')`,\n args: [token],\n });\n if (result.rows.length === 0) {\n return json({ error: \"invalid_token\", message: \"token not found or expired\" }, 401);\n }\n const userId = result.rows[0][0] as string;\n\n // Check user_rooms\n const userRoomResult = await sqlite.execute({\n sql: `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?`,\n args: [userId, roomId],\n });\n if (userRoomResult.rows.length === 0) {\n return { authenticated: true, kind: \"view\", agentId: null, roomId, grants: [], userId };\n }\n const role = userRoomResult.rows[0][0] as string;\n const level = roleToLevel(role);\n\n if (scopeCanAdmin(level)) {\n return { authenticated: true, kind: \"room\", agentId: null, roomId, grants: [\"*\"], userId };\n }\n return { authenticated: true, kind: \"view\", agentId: null, roomId, grants: [], userId };\n}\n\n// ============ Authorization checks ============\n\nexport function checkScopeAuthority(auth: AuthResult, scope: string): Response | null {\n if (!auth.authenticated) {\n return json({ error: \"authentication_required\", message: \"include Authorization: Bearer \" }, 401);\n }\n if (auth.grants.includes(\"*\")) return null;\n if (auth.grants.includes(scope)) return null;\n return json({\n error: \"scope_denied\",\n message: `no authority over scope \"${scope}\"`,\n grants: auth.grants,\n scope,\n }, 403);\n}\n\nexport function assertIdentity(auth: AuthResult, claimedAgent: string | null): Response | null {\n if (!auth.authenticated) return null;\n if (!claimedAgent) return null;\n if (auth.kind === \"room\") return null;\n if (auth.agentId === claimedAgent) return null;\n return json({\n error: \"identity_mismatch\",\n message: `token belongs to \"${auth.agentId}\" but request claims \"${claimedAgent}\"`,\n authenticated_as: auth.agentId,\n claimed: claimedAgent,\n }, 403);\n}\n\nexport function requireAuth(auth: AuthResult): Response | null {\n if (!auth.authenticated) {\n return json({ error: \"authentication_required\", message: \"include Authorization: Bearer \" }, 401);\n }\n return null;\n}\n\nexport function requireRoomToken(auth: AuthResult): Response | null {\n if (!auth.authenticated) {\n return json({ error: \"authentication_required\", message: \"room token required\" }, 401);\n }\n if (auth.kind !== \"room\" && !auth.grants.includes(\"*\")) {\n return json({ error: \"room_token_required\", message: \"this operation requires a room token or admin grants\" }, 403);\n }\n return null;\n}\n\nexport function requireWriteAuth(auth: AuthResult): Response | null {\n if (!auth.authenticated) {\n return json({ error: \"authentication_required\", message: \"include Authorization: Bearer \" }, 401);\n }\n if (auth.kind === \"view\") {\n return json({ error: \"read_only_token\", message: \"view tokens cannot perform mutations\" }, 403);\n }\n return null;\n}\n\nexport function hasFullReadAccess(auth: AuthResult): boolean {\n return auth.grants.includes(\"*\") || auth.kind === \"view\";\n}\n\n// ============ Auto-heartbeat ============\n\nexport function touchAgent(roomId: string, agentId: string | null | undefined): void {\n if (!agentId) return;\n const now = new Date().toISOString();\n // Update token liveness (applies to all token types)\n sqlite.execute({\n sql: `UPDATE tokens SET last_used_at = ? WHERE room_id = ? AND agent_id = ? AND revoked = 0`,\n args: [now, roomId, agentId],\n }).catch(() => {});\n // Update _agents scope heartbeat\n sqlite.execute({\n sql: `UPDATE state SET\n value = json_set(value, '$.last_heartbeat', ?),\n revision = revision + 1, updated_at = ?\n WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [now, now, roomId, agentId],\n }).catch(() => {});\n}\n\n// ============ Direct agent auth (no token required) ============\n\nexport async function resolveAgentAuth(\n roomId: string, agentId: string,\n): Promise {\n // v8: Read grants from _agents scope\n const result = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [roomId, agentId],\n });\n if (result.rows.length === 0) return null;\n let grants: string[] = [agentId];\n try {\n const def = JSON.parse(result.rows[0][0] as string);\n if (Array.isArray(def.grants) && def.grants.length > 0) {\n grants = [agentId, ...def.grants.filter((g: string) => g !== agentId)];\n }\n } catch {}\n return {\n authenticated: true,\n kind: \"agent\",\n agentId,\n roomId,\n grants,\n };\n}\n",[315],"1b910124-2075-11f1-8859-42dde27851f2","audit.ts","debac5c8-1ad9-11f1-b21b-42dde27851f2",["D",1773582277011],"/**\n * audit.ts — Fire-and-forget audit logging for sync rooms.\n *\n * Two entry types:\n * - Invocation entries (kind=\"invoke\"): action invocations with effect.writes for replay\n * - Structural entries: agent join/update, action/view register/delete\n *\n * Both are appended to the _audit scope in room state. Never throws.\n *\n * v8: Also populates log_index for key-based temporal queries.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { rows2objects } from \"./utils.ts\";\nimport { indexLogEntry } from \"./schema-v8.ts\";\n\n/** Append a structured audit entry to the _audit scope (fire-and-forget).\n *\n * Entry shape (v2):\n * kind: \"invoke\" (default, backward-compatible) | structural event kinds\n * ts, agent, ok — always present\n * action, builtin, params — present for kind=\"invoke\"\n * effect.writes — resolved {scope, key, value} tuples for kind=\"invoke\" (enables replay)\n *\n * Old entries without `kind` are treated as kind=\"invoke\" during replay reconstruction. */\nexport async function appendAuditEntry(\n roomId: string,\n agent: string | null,\n action: string,\n builtin: boolean,\n params: Record,\n status: number,\n executedWrites?: Array<{ scope: string; key: string; value?: any }>,\n) {\n try {\n const seqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = '_audit'`,\n args: [roomId],\n });\n const seq = Number(rows2objects(seqResult)[0]?.next_seq ?? 1);\n const entry: Record = {\n ts: new Date().toISOString(),\n kind: \"invoke\",\n agent: agent ?? \"admin\",\n action,\n builtin,\n params,\n ok: status < 400,\n };\n if (executedWrites && executedWrites.length > 0 && status < 400) {\n entry.effect = { writes: executedWrites };\n }\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [roomId, String(seq), seq, JSON.stringify(entry)],\n });\n\n // v8: populate log_index for key-based temporal queries\n const affectedKeys: Array<{ scope: string; key: string }> = [];\n if (executedWrites && executedWrites.length > 0 && status < 400) {\n for (const w of executedWrites) {\n if (w.scope && w.key) affectedKeys.push({ scope: w.scope, key: w.key });\n }\n }\n indexLogEntry(roomId, seq, affectedKeys).catch(() => {});\n } catch {}\n}\n\n/** Append a structural audit event (agent join/update, action/view register/delete).\n * These are the schema-change half of replay: they capture what entities existed\n * at each point in time so reconstruction has the right agents, actions, and views.\n *\n * `kind` discriminates the event. `schema` contains the full definition needed to\n * reconstruct the entity. Fire-and-forget, never throws. */\nexport async function appendStructuralEvent(\n roomId: string,\n kind: \"agent_join\" | \"agent_update\" | \"register_action\" | \"register_view\" | \"delete_action\" | \"delete_view\",\n agent: string | null,\n schema: Record,\n) {\n try {\n const seqResult = await sqlite.execute({\n sql: `SELECT COALESCE(MAX(sort_key), 0) + 1 as next_seq FROM state WHERE room_id = ? AND scope = '_audit'`,\n args: [roomId],\n });\n const seq = Number(rows2objects(seqResult)[0]?.next_seq ?? 1);\n const entry = JSON.stringify({\n ts: new Date().toISOString(),\n kind,\n agent: agent ?? \"admin\",\n ok: true,\n schema,\n });\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [roomId, String(seq), seq, entry],\n });\n\n // v8: populate log_index for structural events\n const affectedKeys: Array<{ scope: string; key: string }> = [];\n if (schema.id) {\n if (kind.includes(\"action\")) {\n affectedKeys.push({ scope: \"_actions\", key: schema.id });\n } else if (kind.includes(\"view\")) {\n affectedKeys.push({ scope: \"_views\", key: schema.id });\n } else if (kind === \"agent_join\" || kind === \"agent_update\") {\n affectedKeys.push({ scope: \"_agents\", key: schema.id });\n }\n }\n // Also index any state keys mentioned in the schema (e.g. action write targets)\n if (schema.writes && Array.isArray(schema.writes)) {\n for (const w of schema.writes) {\n if (w.scope && w.key && !w.key.includes(\"${\")) {\n affectedKeys.push({ scope: w.scope, key: w.key });\n }\n }\n }\n indexLogEntry(roomId, seq, affectedKeys).catch(() => {});\n } catch {}\n}\n",[322],"1b90a350-2075-11f1-8859-42dde27851f2","agents.ts","deba96c0-1ad9-11f1-b21b-42dde27851f2",["D",1773582277011],"/**\n * agents.ts — Agent lifecycle management.\n *\n * v8: Agent presence in _agents scope, auth tokens in tokens table.\n * Legacy agents table removed from write path.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport { generateToken, hashToken } from \"./auth.ts\";\nimport { validateCel } from \"./cel.ts\";\nimport { appendStructuralEvent } from \"./audit.ts\";\n\nexport async function joinRoom(roomId: string, body: any, req: Request) {\n const id = body.id ?? crypto.randomUUID();\n const name = body.name ?? \"anonymous\";\n const role = body.role ?? \"agent\";\n const meta = body.meta ?? {};\n const enabled_expr = body.enabled ?? null;\n const token = generateToken(\"as\");\n const hash = await hashToken(token);\n\n if (enabled_expr) {\n const v = validateCel(enabled_expr);\n if (!v.valid) return json({ error: \"invalid_cel\", field: \"enabled\", detail: v.error }, 400);\n }\n\n // Check for existing agent — re-join requires matching token\n const existingToken = await sqlite.execute({\n sql: `SELECT token_hash FROM tokens WHERE room_id = ? AND agent_id = ? AND revoked = 0 LIMIT 1`,\n args: [roomId, id],\n });\n if (existingToken.rows.length > 0) {\n const existingHash = existingToken.rows[0][0] as string;\n const header = req.headers.get(\"Authorization\");\n if (!header || !header.startsWith(\"Bearer \")) {\n return json({ error: \"agent_exists\", message: `agent \"${id}\" already registered — include Authorization: Bearer to re-join`, agent: id }, 409);\n }\n const callerToken = header.slice(7);\n const callerHash = await hashToken(callerToken);\n if (callerHash !== existingHash) {\n // Check if it's a room token\n const roomCheck = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ? AND token_hash = ?`,\n args: [roomId, callerHash],\n });\n if (roomCheck.rows.length === 0) {\n return json({ error: \"invalid_token\", message: `token does not match agent \"${id}\" — cannot re-join`, agent: id }, 401);\n }\n }\n // Re-join: revoke old token, mint new one\n await sqlite.execute({\n sql: `UPDATE tokens SET revoked = 1 WHERE room_id = ? AND agent_id = ? AND revoked = 0`,\n args: [roomId, id],\n });\n }\n\n // Create token in tokens table\n const tokenId = `agent_${roomId}_${id}_${Date.now()}`;\n const scope = `rooms:${roomId}:agent:${id}:write`;\n await sqlite.execute({\n sql: `INSERT INTO tokens (id, token_hash, minted_by, scope, room_id, agent_id, label, last_used_at, created_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))`,\n args: [tokenId, hash, \"agent_join\", scope, roomId, id, `Agent ${name}`],\n });\n\n const now = new Date().toISOString();\n\n // Write to _agents scope (single source of truth for presence)\n const agentDef = {\n name, role, status: \"active\",\n grants: [], last_heartbeat: now,\n joined_at: now, token_id: tokenId,\n last_seen_seq: 0,\n ...(Object.keys(meta).length > 0 ? { meta } : {}),\n };\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, id, JSON.stringify(agentDef)],\n });\n\n // Inline initial state\n if (body.state && typeof body.state === \"object\") {\n const statements: any[] = [];\n for (const [key, value] of Object.entries(body.state)) {\n const strValue = typeof value === \"string\" ? value : JSON.stringify(value);\n statements.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, updated_at)\n VALUES (?, ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = version + 1, updated_at = datetime('now')`,\n args: [roomId, id, key, strValue],\n });\n if (body.public_keys?.includes(key)) {\n const viewId = `${id}.${key}`;\n const expr = `state[\"${id}\"][\"${key}\"]`;\n const viewDef = JSON.stringify({\n expr, description: `auto: ${id}.${key}`, scope: id,\n registered_by: id, deps: [], render: null, enabled: null, timer: null,\n });\n statements.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, viewId, viewDef],\n });\n }\n }\n if (statements.length > 0) await sqlite.batch(statements);\n }\n\n // Inline views (v8: _views scope only)\n if (Array.isArray(body.views)) {\n const viewStatements: any[] = [];\n for (const v of body.views) {\n if (!v.id || !v.expr) continue;\n const vv = validateCel(v.expr);\n if (!vv.valid) continue;\n const viewDef = JSON.stringify({\n expr: v.expr, description: v.description ?? null, scope: id,\n registered_by: id, deps: [], render: null, enabled: null, timer: null,\n });\n viewStatements.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, v.id, viewDef],\n });\n }\n if (viewStatements.length > 0) await sqlite.batch(viewStatements);\n }\n\n appendStructuralEvent(roomId, \"agent_join\", id, {\n id, name, role, grants: [],\n state: body.state && typeof body.state === \"object\" ? body.state : undefined,\n }).catch(() => {});\n\n return json({\n id, room_id: roomId, name, role, joined_at: now,\n meta: JSON.stringify(meta), last_heartbeat: now,\n status: \"active\", waiting_on: null, enabled_expr: null,\n grants: \"[]\", last_seen_seq: 0, token,\n }, 201);\n}\n\n/** Create or re-activate an agent without HTTP request auth.\n * Trust boundary: caller is responsible for authorization.\n * Used by MCP embodiment where trust source is smcp_user_rooms, not a room token. */\nexport async function insertAgentDirect(\n roomId: string,\n params: {\n id: string;\n name: string;\n role?: string;\n meta?: Record;\n grants?: string[];\n state?: Record;\n publicKeys?: string[];\n views?: Array<{ id: string; expr: string; description?: string }>;\n },\n): Promise<{ agentId: string; token: string }> {\n const id = params.id;\n const name = params.name;\n const role = params.role ?? \"agent\";\n const meta = params.meta ?? {};\n const grants = params.grants ?? [];\n const token = generateToken(\"as\");\n const hash = await hashToken(token);\n\n // Revoke existing tokens for this agent\n await sqlite.execute({\n sql: `UPDATE tokens SET revoked = 1 WHERE room_id = ? AND agent_id = ? AND revoked = 0`,\n args: [roomId, id],\n });\n\n // Create token\n const tokenId = `agent_${roomId}_${id}_${Date.now()}`;\n const scope = `rooms:${roomId}:agent:${id}:write`;\n await sqlite.execute({\n sql: `INSERT INTO tokens (id, token_hash, minted_by, scope, room_id, agent_id, label, last_used_at, created_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))`,\n args: [tokenId, hash, \"mcp_embody\", scope, roomId, id, `Agent ${name}`],\n });\n\n const now = new Date().toISOString();\n\n // Write to _agents scope\n const agentDef = {\n name, role, status: \"active\",\n grants, last_heartbeat: now,\n joined_at: now, token_id: tokenId,\n last_seen_seq: 0,\n ...(Object.keys(meta).length > 0 ? { meta } : {}),\n };\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, id, JSON.stringify(agentDef)],\n });\n\n // Inline initial state\n if (params.state && typeof params.state === \"object\") {\n const stmts: any[] = [];\n for (const [key, value] of Object.entries(params.state)) {\n const strValue = typeof value === \"string\" ? value : JSON.stringify(value);\n stmts.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, ?, ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, id, key, strValue],\n });\n if (params.publicKeys?.includes(key)) {\n const viewId = `${id}.${key}`;\n const expr = `state[\"${id}\"][\"${key}\"]`;\n const viewDef = JSON.stringify({\n expr, description: `auto: ${id}.${key}`, scope: id,\n registered_by: id, deps: [], render: null, enabled: null, timer: null,\n });\n stmts.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, viewId, viewDef],\n });\n }\n }\n if (stmts.length > 0) await sqlite.batch(stmts);\n }\n\n // Inline views (v8: _views scope only)\n if (Array.isArray(params.views)) {\n const stmts: any[] = [];\n for (const v of params.views) {\n if (!v.id || !v.expr) continue;\n const viewDef = JSON.stringify({\n expr: v.expr, description: v.description ?? null, scope: id,\n registered_by: id, deps: [], render: null, enabled: null, timer: null,\n });\n stmts.push({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, v.id, viewDef],\n });\n }\n if (stmts.length > 0) await sqlite.batch(stmts);\n }\n\n return { agentId: id, token };\n}\n\nexport async function updateAgent(roomId: string, agentId: string, body: any) {\n // Read current _agents scope entry\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [roomId, agentId],\n });\n if (existing.rows.length === 0) return json({ error: \"agent not found\" }, 404);\n let current: any = {};\n try { current = JSON.parse(existing.rows[0][0] as string); } catch {}\n\n // Apply updates\n if (body.grants !== undefined) current.grants = body.grants;\n if (body.role !== undefined) current.role = body.role;\n if (body.name !== undefined) current.name = body.name;\n if (body.meta !== undefined) current.meta = body.meta;\n\n await sqlite.execute({\n sql: `UPDATE state SET value = ?, revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [JSON.stringify(current), roomId, agentId],\n });\n\n const changes: Record = {};\n if (body.grants !== undefined) changes.grants = body.grants;\n if (body.role !== undefined) changes.role = body.role;\n if (body.name !== undefined) changes.name = body.name;\n appendStructuralEvent(roomId, \"agent_update\", agentId, { id: agentId, changes }).catch(() => {});\n\n // Return compatible shape\n return json({\n id: agentId, room_id: roomId, name: current.name, role: current.role,\n status: current.status, last_heartbeat: current.last_heartbeat,\n grants: JSON.stringify(current.grants ?? []), joined_at: current.joined_at,\n });\n}\n\n\n// ── Shared helpers used by MCP tools ──\n\n/** Release an agent: set idle and clear any role filled_by referencing it.\n * Used by embody (switch), disembody, restrict_scope, revoke_access. */\nexport async function releaseAgent(roomId: string, agentId: string) {\n // Update _agents scope entry\n try {\n const result = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [roomId, agentId],\n });\n if (result.rows.length > 0) {\n const current = JSON.parse(result.rows[0][0] as string);\n current.status = \"idle\";\n delete current.waiting_on;\n await sqlite.execute({\n sql: `UPDATE state SET value = ?, revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [JSON.stringify(current), roomId, agentId],\n });\n }\n } catch {}\n // Clear role filled_by\n await sqlite.execute({\n sql: `UPDATE state SET\n value = json_set(value, '$.filled_by', json('null')),\n revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_shared' AND key LIKE 'roles.%'\n AND json_extract(value, '$.filled_by') = ?`,\n args: [roomId, agentId],\n });\n}\n\n/** Fetch role definitions from _shared state for a room.\n * Returns a map of roleId → parsed role definition object. */\nexport async function fetchRoomRoles(roomId: string): Promise> {\n const rolesResult = await sqlite.execute({\n sql: `SELECT key, value FROM state\n WHERE room_id = ? AND scope = '_shared' AND key LIKE 'roles.%'`,\n args: [roomId],\n });\n const roles: Record = {};\n for (const r of rolesResult.rows) {\n const roleId = (r[0] as string).replace(\"roles.\", \"\");\n try { roles[roleId] = JSON.parse(r[1] as string); } catch {}\n }\n return roles;\n}\n",[328],"89c41b1c-2198-11f1-9238-42dde27851f2","actions.ts","deba5e62-1ad9-11f1-b21b-42dde27851f2",["D",1773707445460],"/**\n * actions.ts — Action registration, deletion, and helpers.\n *\n * v9: Uses Environment-based CEL validation (validateExpression) with\n * structured error feedback including stage, hints, and lint warnings.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { json, rows2objects } from \"./utils.ts\";\nimport { validateExpression } from \"./cel.ts\";\nimport { parseTimer, validateTimer } from \"./timers.ts\";\nimport { appendStructuralEvent } from \"./audit.ts\";\nimport type { AuthResult } from \"./auth.ts\";\n\n/**\n * Returns a map of \"scope:key\" → [actionId, ...] for any (scope, key) pair\n * that is the write target of two or more registered actions.\n */\nexport async function computeContestedTargets(roomId: string): Promise> {\n const result = await sqlite.execute({\n sql: `SELECT key, value FROM state WHERE room_id = ? AND scope = '_actions'`,\n args: [roomId],\n });\n const rows = rows2objects(result);\n\n const targets: Record = {};\n for (const row of rows) {\n let def: any;\n try { def = JSON.parse(row.value as string); } catch { continue; }\n const writes = Array.isArray(def.writes) ? def.writes : [];\n for (const w of writes) {\n const scope = w.scope ?? \"_shared\";\n const key = w.key ?? null;\n if (!key) continue;\n const target = `${scope}:${key}`;\n if (!targets[target]) targets[target] = [];\n if (!targets[target].includes(row.key as string)) targets[target].push(row.key as string);\n }\n }\n\n const contested: Record = {};\n for (const [target, ids] of Object.entries(targets)) {\n if (ids.length >= 2) contested[target] = ids;\n }\n return contested;\n}\n\n/** Validate a CEL field on an action definition, returning a structured error response or null if valid. */\nfunction validateActionCel(field: string, expr: string): Response | null {\n const result = validateExpression(expr);\n if (result.valid) return null;\n if (result.stage === \"eval\" && result.error?.includes(\"No such key\")) return null;\n return json({\n error: \"invalid_cel\",\n field,\n stage: result.stage,\n detail: result.error,\n hint: result.hint,\n source: result.source,\n help: result.help ?? \"expressions\",\n }, 400) as unknown as Response;\n}\n\n/** Collect lint warnings from all CEL fields on an action definition. */\nfunction collectCelWarnings(body: any): string[] {\n const warnings: string[] = [];\n for (const field of [\"if\", \"enabled\", \"result\"]) {\n if (body[field]) {\n const result = validateExpression(body[field]);\n if (result.warnings) {\n for (const w of result.warnings) {\n warnings.push(`${field}: ${w}`);\n }\n }\n }\n }\n // Also lint write expressions\n if (Array.isArray(body.writes)) {\n for (const w of body.writes) {\n if (w.expr === true && typeof w.value === \"string\") {\n const result = validateExpression(w.value);\n if (result.warnings) {\n for (const warn of result.warnings) {\n warnings.push(`writes[].value: ${warn}`);\n }\n }\n }\n }\n }\n return warnings;\n}\n\nexport async function registerAction(roomId: string, body: any, auth: AuthResult) {\n const id = body.id;\n if (!id) return json({ error: \"id is required\" }, 400);\n const scope = body.scope ?? \"_shared\";\n\n // Scope ownership enforcement\n if (scope !== \"_shared\") {\n if (!auth.authenticated) return json({ error: \"authentication_required\", message: `scoped actions require auth` }, 401);\n if (auth.kind !== \"room\" && !auth.grants.includes(\"*\") && auth.agentId !== scope) {\n return json({ error: \"identity_mismatch\", message: `action scope \"${scope}\" requires authentication as \"${scope}\"` }, 403);\n }\n }\n\n // Validate expressions with structured feedback\n if (body.if) { const err = validateActionCel(\"if\", body.if); if (err) return err; }\n if (body.enabled) { const err = validateActionCel(\"enabled\", body.enabled); if (err) return err; }\n if (body.result) { const err = validateActionCel(\"result\", body.result); if (err) return err; }\n\n if (body.timer) {\n const tv = validateTimer(body.timer);\n if (!tv.valid) return json({ error: \"invalid_timer\", detail: tv.error }, 400);\n }\n if (body.on_invoke?.timer) {\n const tv = validateTimer(body.on_invoke.timer);\n if (!tv.valid) return json({ error: \"invalid_timer\", field: \"on_invoke.timer\", detail: tv.error }, 400);\n }\n\n const writes = body.writes ?? [];\n if (!Array.isArray(writes)) return json({ error: \"writes must be an array\" }, 400);\n const registeredBy = scope !== \"_shared\" ? scope : (body.registered_by ?? (auth.authenticated ? auth.agentId : null));\n\n // Check for semantic changes on re-registration\n const writesJson = JSON.stringify(writes);\n const paramsJson = body.params ? JSON.stringify(body.params) : null;\n let reregistration: {\n previousRegistrant: string | null;\n writesChanged: boolean;\n paramsChanged: boolean;\n previousWrites: any[];\n invocationCount: number;\n } | null = null;\n\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [roomId, id],\n });\n if (existing.rows.length > 0) {\n let prevDef: any = {};\n try { prevDef = JSON.parse(existing.rows[0][0] as string); } catch {}\n const prevWritesJson = JSON.stringify(prevDef.writes ?? []);\n const prevParamsJson = prevDef.params ? JSON.stringify(prevDef.params) : null;\n const writesChanged = prevWritesJson !== writesJson;\n const paramsChanged = prevParamsJson !== paramsJson;\n\n if (writesChanged || paramsChanged) {\n let invocationCount = 0;\n try {\n const auditResult = await sqlite.execute({\n sql: `SELECT COUNT(*) as cnt FROM state WHERE room_id = ? AND scope = '_audit' AND value LIKE ?`,\n args: [roomId, `%\"action\":\"${id}\"%`],\n });\n invocationCount = Number(rows2objects(auditResult)[0]?.cnt ?? 0);\n } catch {}\n\n reregistration = {\n previousRegistrant: prevDef.registered_by ?? null,\n writesChanged, paramsChanged,\n previousWrites: prevDef.writes ?? [],\n invocationCount,\n };\n }\n }\n\n // Build timer state for initial registration\n let timerState: any = null;\n if (body.timer) {\n const cols = parseTimer(body.timer);\n timerState = {\n timer_json: cols.timer_json,\n timer_expires_at: cols.timer_expires_at,\n timer_ticks_left: cols.timer_ticks_left,\n timer_tick_on: cols.timer_tick_on,\n timer_effect: cols.timer_effect,\n timer_started_at: cols.timer_started_at,\n };\n }\n\n // Write to _actions scope\n const actionDef = {\n description: body.description ?? null,\n if: body.if ?? null,\n enabled: body.enabled ?? null,\n result: body.result ?? null,\n writes,\n params: body.params ?? null,\n scope,\n registered_by: registeredBy,\n timer: body.timer ?? null,\n on_invoke: body.on_invoke ?? null,\n _timer: timerState,\n };\n\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_actions', ?, ?, '', 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [roomId, id, JSON.stringify(actionDef)],\n });\n\n appendStructuralEvent(roomId, \"register_action\", auth.authenticated ? auth.agentId ?? null : null, {\n id, scope, description: body.description ?? null,\n if_expr: body.if ?? null, enabled_expr: body.enabled ?? null,\n writes, params: body.params ?? null,\n }).catch(() => {});\n\n // Build response\n const response: any = {\n id, room_id: roomId, scope, description: body.description ?? null,\n registered_by: registeredBy, writes, params: body.params ?? null,\n };\n if (body.if) response.if = body.if;\n if (body.enabled) response.enabled = body.enabled;\n if (body.result) response.result = body.result;\n if (body.timer) response.timer = body.timer;\n if (body.on_invoke) response.on_invoke = body.on_invoke;\n\n // Check contested targets\n const contested = await computeContestedTargets(roomId);\n const myWrites = writes.map((w: any) => `${w.scope ?? \"_shared\"}:${w.key ?? \"\"}`).filter((t: string) => !t.endsWith(\":\"));\n const myContested = myWrites.filter((t: string) => contested[t] && contested[t].length >= 2);\n\n const warnings: string[] = [];\n const warningDetails: Record = {};\n\n if (myContested.length > 0) {\n warnings.push(\"competing_write_targets\");\n warningDetails.contested_targets = myContested;\n warningDetails.competing_actions = myContested.map(t => ({ target: t, actions: contested[t] }));\n }\n\n if (reregistration) {\n warnings.push(\"action_redefined\");\n warningDetails.redefinition = {\n previous_registrant: reregistration.previousRegistrant,\n writes_changed: reregistration.writesChanged,\n params_changed: reregistration.paramsChanged,\n invocation_count: reregistration.invocationCount,\n previous_writes: reregistration.previousWrites,\n risk: reregistration.invocationCount > 0 && reregistration.writesChanged\n ? \"high — action has been invoked and write behavior changed\"\n : reregistration.writesChanged\n ? \"medium — write behavior changed\"\n : \"low — parameter schema changed but write targets unchanged\",\n };\n }\n\n // Collect lint warnings from CEL expressions\n const celWarnings = collectCelWarnings(body);\n if (celWarnings.length > 0) {\n warnings.push(\"cel_lint\");\n warningDetails.cel_warnings = celWarnings;\n }\n\n if (warnings.length > 0) {\n return json({ ...response, warning: warnings.length === 1 ? warnings[0] : warnings, ...warningDetails, help: \"contested_actions\" }, 201);\n }\n\n return json(response, 201);\n}\n\nexport async function deleteAction(roomId: string, actionId: string, auth: AuthResult) {\n const existing = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`,\n args: [roomId, actionId],\n });\n if (existing.rows.length === 0) return json({ error: \"action not found\" }, 404);\n let def: any = {};\n try { def = JSON.parse(existing.rows[0][0] as string); } catch {}\n const scope = def.scope ?? \"_shared\";\n if (scope !== \"_shared\") {\n if (auth.kind !== \"room\" && !auth.grants.includes(\"*\") && auth.agentId !== scope) {\n return json({ error: \"action_owned\", message: `action \"${actionId}\" owned by \"${scope}\"`, owner: scope }, 403);\n }\n }\n await sqlite.execute({ sql: `DELETE FROM state WHERE room_id = ? AND scope = '_actions' AND key = ?`, args: [roomId, actionId] });\n appendStructuralEvent(roomId, \"delete_action\", auth.authenticated ? auth.agentId ?? null : null, { id: actionId }).catch(() => {});\n return json({ deleted: true, id: actionId });\n}\n",[334],"89c3d77e-2198-11f1-9238-42dde27851f2","README.md","24e6aeae-0ebe-11f1-8fb6-42dde27851f2",["D",1773707445460],22,"---\nname: sync\ndescription: Coordination substrate for multi-agent systems. Two operations — read context, invoke actions. No direct state writes. Every entry is { value, _meta } — the substrate reasons about its own observation. Agents declare vocabulary, then act through it. Unified auth via passkey-minted scoped tokens. Built on wrapped state, CEL expressions with domain helpers, and salience-driven context shaping. Base URL is https://sync.parc.land/.\n---\n\n# sync v9\n\nCoordination substrate for multi-agent systems at `https://sync.parc.land/`.\n\nTwo operations: **read context**, **invoke actions**. Everything else is wiring.\n\nThere is no `_set_state`. Agents declare write capabilities as actions, then invoke them.\nThe declaration is the commitment. The vocabulary is the protocol.\n\n## What's new in v9\n\nEvery entry is wrapped: `{ value, _meta }`. The substrate observes itself.\n\n- **`value`** — the stored data (or `null` if elided by salience)\n- **`_meta`** — provenance, trajectory, salience: `revision`, `updated_at`, `writer`, `via`, `seq`, `score`, `velocity`, `writers`, `first_at`, `elided`\n- **Actions** carry extra `_meta`: `invocations`, `last_invoked_at`, `last_invoked_by`, `contested`\n\nCEL expressions access `.value` for data, `._meta` for metadata. Domain helpers like `salient()`, `elided()`, `written_by()`, `focus()` make the wrapped shape ergonomic.\n\nContext is shaped by salience: high-score entries get full values and metadata, low-score entries are elided (value: null, with expand hints). Override with `elision: \"none\"`.\n\n---\n\n## Authentication\n\nPasskeys are the root of trust. Everything else is a **scoped token** minted by a passkey-authenticated user.\n\n### Quick start (CLI / scripts)\n\n```bash\n# 1. Initiate device auth\ncurl -s -X POST https://sync.parc.land/auth/device \\\n -H \"Content-Type: application/json\" \\\n -d '{\"scope\":\"rooms:* create_rooms\"}'\n# → { device_code, user_code, verification_uri_complete }\n\n# 2. Open the URL in browser, authenticate with passkey, approve scope\n\n# 3. Poll for token\ncurl -s -X POST https://sync.parc.land/auth/device/token \\\n -H \"Content-Type: application/json\" \\\n -d '{\"device_code\":\"dev_xxx\"}'\n# → { access_token: \"tok_xxx\", refresh_token: \"ref_xxx\", scope, expires_in }\n```\n\n### Quick start (MCP clients)\n\nMCP clients (Claude, ChatGPT, etc.) use OAuth 2.1 with PKCE + WebAuthn passkeys. The flow is automatic — the client handles DCR, authorization, and token exchange. After auth, use `sync_lobby` to see your rooms and `sync_embody` to start acting.\n\n### Token model\n\nOne token concept. Scope is the only knob.\n\n| Scope | Meaning |\n|-------|---------|\n| `rooms:*` | All rooms the user has access to |\n| `rooms:*:read` | All rooms, read-only |\n| `rooms:my-room` | Full access to a specific room |\n| `rooms:my-room:write` | Read + write |\n| `rooms:my-room:read` | Read-only (shareable dashboard link) |\n| `rooms:my-room:agent:alice` | Bound to agent alice (implies write) |\n| `create_rooms` | Can create new rooms |\n\nEffective access = `min(token.scope, user_rooms.role)`. A token can only narrow, never widen.\n\n### Token operations\n\n```\nPOST /tokens Mint a scoped token\nGET /tokens List your tokens\nPATCH /tokens/:id Update scope (bounded by your access)\nDELETE /tokens/:id Revoke a token\nPOST /tokens/refresh Exchange refresh_token for new access_token\n```\n\n### Scope elevation (agent-initiated)\n\nWhen an agent hits `scope_denied`, the response includes a stateless elevation URL. The agent presents the URL to the user. The user opens it → passkey auth → choose access level → approve. The server patches the token's scope. The agent retries.\n\n### Legacy tokens\n\nLegacy `room_`, `view_`, `as_` prefix tokens continue to work for backward compatibility.\n\n---\n\n## Core workflow\n\n### Step 1: Create a room\n\n```bash\ncurl -X POST https://sync.parc.land/rooms \\\n -H \"Authorization: Bearer tok_xxx\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\":\"my-room\"}'\n```\n\n### Step 2: Embody an agent\n\nVia MCP: `sync_embody({ room: \"my-room\", name: \"Alice\" })`.\n\nOr via HTTP:\n\n```bash\ncurl -X POST https://sync.parc.land/rooms/my-room/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\":\"alice\",\"name\":\"Alice\",\"role\":\"agent\"}'\n```\n\n### Step 3: Read context\n\n```bash\ncurl -H \"Authorization: Bearer tok_xxx\" \\\n https://sync.parc.land/rooms/my-room/context\n```\n\nReturns wrapped entries. Example state entry:\n\n```json\n{\n \"phase\": {\n \"value\": \"executing\",\n \"_meta\": {\n \"revision\": 3,\n \"writer\": \"architect\",\n \"score\": 0.85,\n \"velocity\": 0.1,\n \"elided\": false\n }\n }\n}\n```\n\nThe `_shaping` summary tells you how context was shaped. In an empty room, `help({ key: \"vocabulary_bootstrap\" })` guides the first move.\n\n### Step 4: Bootstrap vocabulary\n\n```\nPOST /rooms/my-room/actions/help/invoke\n{ \"params\": { \"key\": \"standard_library\" } }\n```\n\n```\nPOST /rooms/my-room/actions/_register_action/invoke\n{ \"params\": {\n \"id\": \"submit_result\",\n \"description\": \"Submit a result keyed to your identity\",\n \"params\": { \"result\": { \"type\": \"any\" } },\n \"writes\": [{ \"scope\": \"_shared\", \"key\": \"${self}.result\", \"value\": \"${params.result}\" }]\n}}\n```\n\n### Step 5: Invoke actions\n\n```\nPOST /rooms/my-room/actions/submit_result/invoke\nAuthorization: Bearer tok_xxx\n{ \"params\": { \"result\": \"42\" } }\n→ {\n \"invoked\": true,\n \"writes\": [{\n \"scope\": \"_shared\",\n \"key\": \"alice.result\",\n \"value\": \"42\",\n \"_meta\": { \"revision\": 1, \"writer\": \"alice\", \"score\": 0.7, \"velocity\": 1.0 }\n }]\n }\n```\n\nThe invoke response includes `_meta` on every written key — the agent sees the structural consequences of its action.\n\n### Step 6: Wait for conditions\n\n```\nGET /rooms/my-room/wait?condition=views.results.value.size()>0\n→ { \"triggered\": true, \"context\": { ... } }\n```\n\nNote: v9 CEL expressions use `.value` to access entry data.\n\n---\n\n## Built-in actions\n\n| Action | Description | Key params |\n|--------|-------------|------------|\n| `_register_action` | Declare a write capability | `id`, `description`, `params`, `writes`, `if` |\n| `_delete_action` | Remove an action | `id` |\n| `_register_view` | Declare a read capability | `id`, `expr`, `scope`, `description`, `render` |\n| `_delete_view` | Remove a view | `id` |\n| `_send_message` | Send a message to the room | `body`, `kind`, `to` |\n| `help` | Read guidance documents | `key` |\n\nNo `_set_state`. All writes through registered actions.\n\n---\n\n## Expressions (CEL)\n\nv9 uses a CEL Environment with domain helpers. Every entry is `{ value, _meta }`.\n\n### Value and meta access\n\n```cel\nstate._shared.phase.value == \"executing\"\nstate._shared.phase._meta.writer == self\nstate._shared.phase._meta.velocity > 0.3\n```\n\n### Domain helpers\n\n```cel\nsalient(state._shared, 0.5) // keys above score threshold\nelided(state._shared) // keys with elided values\nwritten_by(state._shared, self) // keys you last wrote\nfocus(state._shared) // high-tier keys\nvelocity_above(state._shared, 0.3) // actively-written keys\ncontested(actions) // actions sharing write targets\ntop_n(state._shared, 5) // top 5 by score\n```\n\n### Collection patterns\n\n```cel\nstate._shared.keys().filter(k, state._shared[k]._meta.score > 0.5)\nstate._shared.entries().filter(e, !e.entry._meta.elided).map(e, e.key)\n```\n\n### Shorthands\n\n```cel\nval(state._shared.phase) == \"executing\" // extracts .value\nmeta(state._shared.phase, \"writer\") // extracts ._meta field\n```\n\n### Validation\n\nExpressions are validated at registration with structured feedback:\n\n```json\n{\n \"error\": \"invalid_cel\",\n \"stage\": \"parse\",\n \"detail\": \"Unexpected token: EOF\",\n \"hint\": \"Syntax error. Check: balanced parentheses, valid operators (== not ===).\",\n \"help\": \"expressions\"\n}\n```\n\nThe `help` field points to a help key — invoke `help({ key: \"expressions\" })` for the full guide.\n\n---\n\n## Conflict detection\n\nWhen two actions write to the same `(scope, key)` target, the second registration returns a warning. Contention is visible in each action's `_meta.contested`:\n\n```cel\nactions.add_concept._meta.contested // → [\"refine_concept\"]\ncontested(actions) // → [\"add_concept\", \"refine_concept\"]\n```\n\n---\n\n## Context shaping (v9)\n\nContext is shaped by salience score. Three tiers:\n\n| Tier | Condition | Value | _meta |\n|------|-----------|-------|-------|\n| Focus | score >= focus_threshold | Full | Full (provenance, trajectory) |\n| Peripheral | score >= elide_threshold | Full | Minimal (score, revision, updated_at) |\n| Elided | score < elide_threshold | `null` | Minimal + `expand` hint |\n\n### Shaping params\n\n```\nGET /context?elision=none Disable elision (see everything)\nGET /context?expand=_shared.some_key Force key to Focus tier\nGET /context?focus_threshold=0.3 Lower the Focus bar\nGET /context?elide_threshold=0.0 Nothing gets elided\nGET /context?depth=lean Action detail: available + description\nGET /context?depth=full + writes, params, if conditions\nGET /context?depth=usage + invocation counts\nGET /context?only=actions Just actions section\nGET /context?messages=false Skip messages\nGET /context?messages_after=42 Messages after seq 42\n```\n\n### _shaping summary\n\nEvery response includes `_shaping`:\n\n```json\n{\n \"focus_threshold\": 0.5,\n \"elide_threshold\": 0.1,\n \"elision\": \"auto\",\n \"state_entries\": { \"focus\": 5, \"peripheral\": 8, \"elided\": 12, \"total\": 25 }\n}\n```\n\n---\n\n## Help system\n\n| Key | Content |\n|-----|---------|\n| `guide` | Participant guide — read/act rhythm, entry shape, shaping |\n| `expressions` | CEL expression guide — .value, ._meta, helpers, common mistakes |\n| `wrapped_entries` | The { value, _meta } shape — why, how, three layers |\n| `functions` | Domain helper reference — salient(), elided(), written_by(), etc. |\n| `shaping` | Context shaping — elision, expand, thresholds |\n| `standard_library` | Ready-to-register action definitions |\n| `vocabulary_bootstrap` | Bootstrapping a room from scratch |\n| `contested_actions` | Resolving write target contention |\n| `directed_messages` | Attention-routed messages |\n| `if_version` | Proof-of-read versioning |\n\nInvoke `help({ key: \"expressions\" })` for any key. Room overrides: write to `_help` scope.\n\n---\n\n## API surface\n\n```\n── Auth ──\nPOST /auth/device Initiate device auth\nGET /auth/device Browser approval page\nPOST /auth/device/token CLI polls for token\nGET /auth/elevate Scope elevation page\nPOST /tokens Mint a scoped token\nGET /tokens List your tokens\nPATCH /tokens/:id Update token scope\nDELETE /tokens/:id Revoke a token\nPOST /tokens/refresh Refresh token\n\n── OAuth / WebAuthn (MCP clients) ──\nGET /.well-known/oauth-protected-resource\nGET /.well-known/oauth-authorization-server\nPOST /oauth/register Dynamic Client Registration\nGET /oauth/authorize Consent page\nPOST /oauth/token Token exchange\n\n── Room lifecycle ──\nPOST /rooms Create room\nGET /rooms List rooms\nGET /rooms/:id Room info\nDELETE /rooms/:id Delete room (owner only)\nPOST /rooms/:id/agents Join room\nPOST /rooms/:id/invite Invite user\n\n── Core (read + write) ──\nGET /rooms/:id/context Read context (shaped by salience)\nGET /rooms/:id/wait Block until condition\nGET /rooms/:id/poll Dashboard poll\nPOST /rooms/:id/actions/:id/invoke Invoke action\nPOST /rooms/:id/eval CEL eval\n\n── Temporal ──\nGET /rooms/:id/history/:scope/:key Key history from audit trail\nGET /rooms/:id/samples/:viewId View value samples (sparklines)\nGET /rooms/:id/salience Salience map (agent-specific)\nGET /rooms/:id/replay/:seq Replay room to sequence\n\n── Management ──\nGET /manage Management UI\nPOST /mcp MCP JSON-RPC 2.0\nGET /docs Documentation\nGET /SKILL.md This file\n```\n\n---\n\n## MCP tools (18)\n\nWhen connected via MCP (OAuth), these tools are available:\n\n| Tool | Description |\n|------|-------------|\n| `sync_lobby` | Overview of rooms, agents, roles. Starting point. |\n| `sync_embody` | Commit to an agent in a room. |\n| `sync_disembody` | Release an agent. |\n| `sync_create_room` | Create a new room. |\n| `sync_list_rooms` | List accessible rooms. |\n| `sync_join_room` | Join a room as agent (low-level). |\n| `sync_read_context` | Read room context (shaped, with expand/elision params). |\n| `sync_invoke_action` | Invoke any action (returns wrapped writes with _meta). |\n| `sync_wait` | Block until CEL condition. |\n| `sync_register_action` | Register a write capability (with CEL validation). |\n| `sync_register_view` | Register a read capability (with CEL validation). |\n| `sync_delete_action` | Remove an action. |\n| `sync_delete_view` | Remove a view. |\n| `sync_send_message` | Send a message. |\n| `sync_help` | Read help system. |\n| `sync_eval_cel` | Evaluate CEL expression. |\n| `sync_restrict_scope` | Narrow session scope. |\n| `sync_revoke_access` | Remove room from session. |\n\n---\n\n## Reference\n\n- [Architecture](reference/v6.md) — thesis, axioms, design rationale\n- [API Reference](reference/api.md) — all endpoints, request/response shapes\n- [CEL Reference](reference/cel.md) — expression language, context shape, patterns\n- [Views Reference](reference/views.md) — render hints, surface types\n- [Help Reference](reference/help.md) — help namespace, versioning, overrides\n- [Examples](reference/examples.md) — task queues, voting, private state\n",[340],"41722250-1d42-11f1-bb0a-42dde27851f2","PLUGIN.md","41722318-1d42-11f1-bb0a-42dde27851f2",441,["D",1773230582762],"# sync Plugin Architecture\n\nThis repository serves multiple purposes:\n\n## 1. Deployed Service (https://sync.parc.land)\n\nThe main application providing:\n- HTTP API for multi-agent coordination\n- MCP server at `/mcp` endpoint\n- OAuth 2.1 + WebAuthn authentication\n- Dashboard and documentation\n\n## 2. Claude Code Plugin\n\nThe repository itself IS a plugin that can be installed:\n\n```bash\n# From Claude Code\n/plugin install sync\n\n# Or test locally\nclaude --plugin-dir /path/to/sync.parc.land\n```\n\n### Plugin Components\n\n**Agent Skill** (`skills/api/SKILL.md`):\n- Declarative knowledge about the sync coordination API\n- Automatically available to Claude when working with sync\n- Teaches Claude the concepts, workflow, and patterns\n\n**MCP Server** (`.mcp.json`):\n- Points to the deployed service at `https://sync.parc.land/mcp`\n- Provides 16 programmatic tools (sync_lobby, sync_embody, etc.)\n- OAuth-authenticated access to rooms and agents\n\n### Two-Layer Design\n\nThe plugin has **complementary layers**:\n\n1. **Declarative layer** (Agent Skill): Gives Claude **knowledge** about sync\n - \"What is sync?\"\n - \"How do I coordinate agents?\"\n - \"What's the workflow?\"\n\n2. **Programmatic layer** (MCP tools): Gives Claude **capabilities** to actually use sync\n - Create rooms\n - Embody agents\n - Read/write state\n - Invoke actions\n\nBoth work together: the skill teaches, the MCP tools execute.\n\n## 3. Local Development\n\nFor repo-scoped development on this codebase:\n\n**`.claude/mcp.json`**: Repo-scoped MCP config\n- `sync-prod`: Points to production (default enabled)\n- `sync-local`: Points to localhost:8787 (disabled by default)\n\nEnable local dev by editing `.claude/settings.local.json`:\n\n```json\n{\n \"mcpServers\": {\n \"sync-local\": { \"disabled\": false },\n \"sync-prod\": { \"disabled\": true }\n }\n}\n```\n\nThen run `deno task dev` to start the local server.\n\n## Distribution\n\nThis repo is **self-contained** - it's both a plugin AND a marketplace that lists itself.\n\n### Direct Installation (Current)\n\nUsers can install directly from the git repository:\n\n```bash\n/plugin marketplace add christopherdebeer/sync.parc.land\n/plugin install sync@sync\n```\n\nThe repo contains both:\n- `.claude-plugin/plugin.json` (plugin manifest)\n- `.claude-plugin/marketplace.json` (marketplace catalog pointing to itself)\n\n### Official Marketplace (Future)\n\nSubmit to claude.ai/settings/plugins/submit or console.anthropic.com/plugins/submit\n\nOnce approved, users can install with:\n```bash\n/plugin install sync\n```\n\n### Team Distribution\n\nAdd to project `.claude/settings.json`:\n\n```json\n{\n \"extraKnownMarketplaces\": {\n \"sync\": {\n \"source\": {\n \"source\": \"github\",\n \"repo\": \"christopherdebeer/sync.parc.land\"\n }\n }\n },\n \"enabledPlugins\": {\n \"sync@sync\": true\n }\n}\n```\n\nSee `INSTALL.md` for complete installation instructions.\n\n## Key Design Insights\n\n### Why Both Skill and MCP?\n\n1. **Skills** are about **knowledge transfer** - they teach Claude concepts\n2. **MCP tools** are about **capabilities** - they let Claude take action\n3. Together they create a complete integration\n\n### Why Serve README.md as /SKILL.md?\n\nFrom `docs/agent-sync-technical-design.md`:\n\n> Serving the README as the SKILL.md means every LLM that can fetch a URL can learn the API. The trade-off: the README must stay under ~4K tokens to fit in a context window, which constrains documentation depth.\n\nThe deployed service serves README.md at `/SKILL.md` so any LLM can learn the API. The plugin's Agent Skill (`skills/api/SKILL.md`) is a more focused, Claude Code-specific extraction of that knowledge.\n\n### Dual Use of /SKILL.md Endpoint\n\n- **Generic LLMs**: Fetch `https://sync.parc.land/SKILL.md` directly\n- **Claude Code**: Uses the bundled `skills/api/SKILL.md` in the plugin\n\nBoth serve the same purpose (teach the API) but the plugin version is optimized for Claude Code's skill system.\n\n## File Structure\n\n```\nsync.parc.land/\n├── .claude-plugin/\n│ └── plugin.json # Makes this repo a plugin\n├── skills/\n│ └── api/\n│ └── SKILL.md # Agent Skill (declarative knowledge)\n├── .mcp.json # MCP config (points to deployed service)\n├── .claude/\n│ ├── mcp.json # Repo-scoped MCP (prod + local)\n│ └── settings.local.json # Local overrides (gitignored)\n├── mcp/\n│ ├── mcp.ts # MCP server implementation\n│ ├── tools.ts # 16 MCP tools\n│ └── db.ts # OAuth/WebAuthn/Vault storage\n├── main.ts # HTTP router + API endpoints\n├── README.md # Also served as /SKILL.md endpoint\n└── ... (rest of codebase)\n```\n\n## Testing\n\n**Test as plugin:**\n```bash\nclaude --plugin-dir .\n```\n\n**Test local MCP:**\n```bash\n# Terminal 1\ndeno task dev\n\n# Terminal 2 - edit .claude/settings.local.json to enable sync-local\nclaude\n```\n\n**Validate plugin:**\n```bash\nclaude plugin validate .\n# Or from within Claude Code:\n/plugin validate .\n```\n",[347],"bcc1dd3e-1e04-11f1-87c7-42dde27851f2","INSTALL.md","418edec2-1d42-11f1-94de-42dde27851f2",504,["D",1773314112062],"# Installing the sync Plugin\n\nThis repository serves as both a **plugin** and a **marketplace** for Claude Code.\n\n## Installation Methods\n\n### Method 1: From Git Repository (Recommended)\n\nExternal users can install the sync plugin:\n\n```bash\n# Step 1: Add the marketplace\n/plugin marketplace add christopherdebeer/sync.parc.land\n\n# Step 2: Install the plugin\n/plugin install sync@sync\n```\n\nOr in one new Claude session:\n```bash\n/plugin marketplace add christopherdebeer/sync.parc.land && /plugin install sync@sync\n```\n\n### Method 2: Local Development\n\nWhen working on this codebase:\n\n```bash\n# From the repo directory\nclaude --plugin-dir .\n```\n\nThis loads the plugin directly without copying to cache, useful for development.\n\n### Method 3: Official Marketplace (Future)\n\nOnce submitted to the official Anthropic marketplace:\n\n```bash\n/plugin install sync\n```\n\n## What Gets Installed\n\nWhen users install the plugin, they get:\n\n1. **Agent Skill** (`/sync:api`): Declarative knowledge about the sync coordination API\n2. **MCP Server**: 18 programmatic tools (`sync_lobby`, `sync_embody`, `sync_read_context`, etc.)\n\nThe skill teaches Claude about sync, while the MCP tools let Claude actually use it.\n\n## Authentication\n\n### MCP clients (Claude, ChatGPT)\nOn first use of an MCP tool, you'll be prompted to authenticate via OAuth 2.1 + WebAuthn:\n\n1. Browser opens to `https://sync.parc.land/oauth/authorize`\n2. Sign in with passkey (or create account)\n3. Consent screen: choose which rooms to grant access\n4. OAuth flow completes, tokens stored securely\n5. MCP tools work with authenticated access\n\n### CLI / scripts (device auth)\nFor non-browser environments:\n\n```bash\n# 1. Initiate\ncurl -X POST https://sync.parc.land/auth/device \\\n -H \"Content-Type: application/json\" \\\n -d '{\"scope\":\"rooms:* create_rooms\"}'\n\n# 2. Open the verification_uri_complete in browser, auth with passkey, approve\n\n# 3. Poll for token\ncurl -X POST https://sync.parc.land/auth/device/token \\\n -H \"Content-Type: application/json\" \\\n -d '{\"device_code\":\"dev_xxx\"}'\n```\n\n### Management UI\nVisit `https://sync.parc.land/manage` to view rooms, manage tokens, and configure passkeys.\n\n## Verification\n\nAfter installation, verify it worked:\n\n```bash\n# List installed plugins\n/plugin list\n\n# Should see:\n# sync@sync (6.0.0)\n\n# Try the skill\n/sync:api\n# Claude will explain the sync coordination API\n\n# Try an MCP tool (triggers OAuth on first use)\n# This will fail with \"not embodied\" but proves MCP works:\n/sync:api What MCP tools are available?\n```\n\n## Updating\n\nTo update to the latest version:\n\n```bash\n/plugin marketplace update sync\n/plugin update sync@sync\n```\n\nOr enable auto-updates in settings:\n\n```json\n{\n \"plugins\": {\n \"autoUpdate\": true\n }\n}\n```\n\n## Uninstalling\n\n```bash\n/plugin uninstall sync@sync\n/plugin marketplace remove sync\n```\n\n## For Team/Enterprise Distribution\n\nTo distribute this plugin to your team:\n\n### Option A: Repository-Level Installation\n\nAdd to your project's `.claude/settings.json`:\n\n```json\n{\n \"extraKnownMarketplaces\": {\n \"sync\": {\n \"source\": {\n \"source\": \"github\",\n \"repo\": \"christopherdebeer/sync.parc.land\"\n }\n }\n },\n \"enabledPlugins\": {\n \"sync@sync\": true\n }\n}\n```\n\nTeam members will be prompted to install on first project load.\n\n### Option B: Managed Settings (Enterprise)\n\nSet in organization-wide managed settings:\n\n```json\n{\n \"strictKnownMarketplaces\": [\n {\n \"source\": \"github\",\n \"repo\": \"christopherdebeer/sync.parc.land\"\n }\n ],\n \"enabledPlugins\": {\n \"sync@sync\": true\n }\n}\n```\n\nThis enforces the sync plugin across all users.\n\n## Troubleshooting\n\n### \"Marketplace file not found\"\n\nIf you see:\n```\nError: Marketplace file not found at .../.claude-plugin/marketplace.json\n```\n\nMake sure you're using the correct repo name:\n```bash\n/plugin marketplace add christopherdebeer/sync.parc.land\n```\n\n### \"Authentication failed\" on MCP tools\n\nMCP tools require OAuth. On first use:\n1. Browser opens to sync.parc.land\n2. Create a passkey (WebAuthn)\n3. Grant access to rooms\n\n### Plugin not showing up\n\n```bash\n# Refresh marketplace\n/plugin marketplace update sync\n\n# List available plugins\n/plugin marketplace list sync\n\n# Should show:\n# sync@sync (6.0.0) - Multi-agent coordination platform\n```\n\n### Need production vs local dev?\n\nThe repo includes `.claude/mcp.json` with both:\n- `sync-prod` (enabled) → https://sync.parc.land/mcp\n- `sync-local` (disabled) → http://localhost:8787/mcp\n\nToggle in `.claude/settings.local.json` (gitignored):\n\n```json\n{\n \"mcpServers\": {\n \"sync-local\": { \"disabled\": false },\n \"sync-prod\": { \"disabled\": true }\n }\n}\n```\n\nThen run `deno task dev` to start local server.\n\n## Support\n\n- Homepage: https://sync.parc.land\n- Documentation: https://sync.parc.land/reference/api.md\n- Repository: https://github.com/christopherdebeer/sync.parc.land\n- Issues: https://github.com/christopherdebeer/sync.parc.land/issues\n",[354],"5bebc296-14f3-11f1-a1df-42dde27851f2","CLAUDE.md","6474c6b0-122d-11f1-bb2b-42dde27851f2",196,["D",1772317087667],"# CLAUDE.md\n\nThis is agent-sync, a multi-agent coordination platform at https://sync.parc.land/.\n\n## Key architectural fact\n\nThe `README.md` is served as the root response (`GET /`) and doubles as the\nremote SKILL.md for Claude's skill system. It is fetched at module load time\nand served as `text/plain`.\n\nThis means README.md must:\n- Follow SKILL.md formatting conventions (frontmatter with `name` and `description`, concise workflow-first structure)\n- Be self-contained enough for an LLM to use the API without reading reference docs\n- Stay under ~4K tokens so it fits comfortably in a context window alongside other skills\n- Link to `reference/api.md`, `reference/cel.md`, `reference/examples.md` for deeper detail\n\nWhen editing README.md, you are editing the skill definition that other Claude\ninstances will read to learn how to use this platform. Write for that audience.\n\n## v5 architecture (context-first)\n\nTwo operations: **read context**, **invoke actions**.\n\n- `GET /context` — returns everything (state, views, agents, actions with defs, messages with bodies)\n- `POST /actions/:id/invoke` — the only write endpoint (builtin and custom actions)\n- `GET /wait` — blocks until condition, returns full context\n\n10 total endpoints. Every write flows through action invocation.\nEvery invocation is logged to `_audit` scope.\n\nThere are NO direct write endpoints for state, actions, views, or messages.\nAll writes go through built-in actions (`_set_state`, `_register_action`, etc.)\nor custom actions.\n\n## Project structure\n\n```\nmain.ts — HTTP router, all endpoint handlers, built-in actions, audit logging\nauth.ts — Token generation, hashing, scope authority checks\ncel.ts — CEL context builder, expression evaluation, view context\nschema.ts — SQLite schema and v4→v5 migration\ntimers.ts — Wall-clock and logical-clock timer lifecycle\ndashboard.ts — Browser dashboard (auth-gated, single HTML response)\nREADME.md — Skill definition (served at root)\nreference/ — Detailed docs (api.md, cel.md, examples.md, surfaces.md)\n```\n\n## Dashboard tabs\n\nAgents, State, Messages, Actions, Views, Audit, CEL Console.\nThe Audit tab shows every action invocation with success/failure status.\n\n## Surfaces (branch: surfaces)\n\nThe `surfaces` branch adds declarative UI composition to the dashboard.\nKey files:\n\n- `frontend/types.ts` — Surface type definitions and `DashboardConfig` interface\n- `frontend/components/panels/Surfaces.tsx` — Renderer for all 10 surface types\n- `frontend/components/Dashboard.tsx` — Consumes `state._shared._dashboard`,\n switches between surface mode and classic tab mode, includes client-side\n CEL evaluator for `enabled` expressions\n- `reference/surfaces.md` — Full reference doc\n\n### Client-side CEL evaluator\n\n`Dashboard.tsx` has `makeSimpleCelEvaluator()` for evaluating surface `enabled`\nexpressions in the browser. Key behavior:\n\n- Supports `state..` comparisons, `views[\"id\"]`, `&&`, `||`\n- **Loose equality:** `undefined == false` returns `true` (missing state keys\n are treated as falsy). This is critical for gating on discovery flags that\n haven't been set yet.\n- **Fail-closed:** Unrecognized expressions return `false` (hide the surface).\n\n### Surface types\n\n`markdown`, `metric`, `view-grid`, `view-table`, `action-bar`, `action-form`,\n`action-choice`, `feed`, `watch`, `section` (nesting container).\n\nAll defined in `types.ts` as a discriminated union on the `type` field.\n",[361],"e6c487b0-1708-11f1-95df-42dde27851f2",".vtignore","e6c48832-1708-11f1-95df-42dde27851f2",["D",1772546242374],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\nlocal\nCLAUDE.md",[368],"4178c97a-1d42-11f1-b429-42dde27851f2",".mcp.json","4178ca2e-1d42-11f1-b429-42dde27851f2",442,["D",1773230582769],"{\n \"mcpServers\": {\n \"sync\": {\n \"type\": \"http\",\n \"url\": \"https://sync.parc.land/mcp\",\n \"description\": \"Programmatic tools for sync.parc.land coordination platform\",\n \"authentication\": {\n \"type\": \"oauth2\",\n \"discoveryUrl\": \"https://sync.parc.land/.well-known/oauth-authorization-server\"\n }\n }\n }\n}\n",[374],"e6c46a46-1708-11f1-95df-42dde27851f2",".gitignore","e6c46afa-1708-11f1-95df-42dde27851f2",["D",1772546242374],"local/sync.db\nlocal/sync.db-wal\nlocal/sync.db-shm\n.vt/\n.DS_Store\nnode_modules/\n",[381],"69cabc58-18b0-11f1-ad37-42dde27851f2","static","019cbed4-be27-732f-9c68-34c437bf8810",240,["D",1772728139302],"directory",[387],"412abc94-1d42-11f1-a960-42dde27851f2","skills","412abd2a-1d42-11f1-a960-42dde27851f2",439,["D",1773230582350],[394],"80999e44-1ee7-11f1-b2a4-42dde27851f2","scripts","15be4c92-8ed7-4353-a438-bd8953be1b25",580,["D",1773411506886],[400],"b2302c1a-1097-11f1-8f1d-42dde27851f2","reference","b2302ce2-1097-11f1-8f1d-42dde27851f2",25,["D",1771837914069],[406],"9f5210ea-18a3-11f1-b05e-42dde27851f2","mcp","019cbe80-ea89-7462-9a69-79fbc30a3494",233,["D",1772722645641],[412],"7834c5c2-13fb-11f1-b99c-42dde27851f2","frontend","019c9ffc-060a-74df-be1d-7697cbc66a41",128,["D",1772210619912],[418],"9fc8554e-11e0-11f1-837f-42dde27851f2","docs","9fc855f8-11e0-11f1-837f-42dde27851f2",69,["D",1771979187614],[424],"410d0b5e-1d42-11f1-94de-42dde27851f2",".claude-plugin","410d0bf4-1d42-11f1-94de-42dde27851f2",438,["D",1773230582141],[430],"96ec2120-1709-11f1-8e59-42dde27851f2",".claude","96ec21d4-1709-11f1-8e59-42dde27851f2",201,["D",1772546537932],[436],"pulls","branches",9,"forks","envVars",{"_449":187,"_451":178},"connections",{"_449":178,"_450":178},"count","unfilledCount","emptyCount",{"_43":435,"_32":436,"_30":437,"_174":-5,"_41":42,"_40":438,"_176":123,"_38":1502,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1503,"_27":1504},{"_43":1494,"_32":1495,"_30":1496,"_174":437,"_41":42,"_40":1497,"_176":123,"_38":1498,"_13":178,"_33":20,"_35":1499,"_24":25,"_180":-5,"_599":1500,"_27":1501},{"_43":1486,"_32":1487,"_30":1488,"_174":437,"_41":42,"_40":1489,"_176":123,"_38":1490,"_13":61,"_33":20,"_35":1491,"_24":25,"_180":-5,"_599":1492,"_27":1493},{"_43":429,"_32":430,"_30":431,"_174":-5,"_41":42,"_40":432,"_176":123,"_38":1483,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1484,"_27":1485},{"_43":1475,"_32":1476,"_30":1477,"_174":431,"_41":42,"_40":1478,"_176":123,"_38":1479,"_13":178,"_33":20,"_35":1480,"_24":25,"_180":-5,"_599":1481,"_27":1482},{"_43":1467,"_32":1468,"_30":1469,"_174":431,"_41":42,"_40":1470,"_176":123,"_38":1471,"_13":178,"_33":20,"_35":1472,"_24":25,"_180":-5,"_599":1473,"_27":1474},{"_43":423,"_32":424,"_30":425,"_174":-5,"_41":42,"_40":426,"_176":123,"_38":1464,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1465,"_27":1466},{"_43":1456,"_32":1457,"_30":1458,"_174":425,"_41":42,"_40":1459,"_176":123,"_38":1460,"_13":61,"_33":20,"_35":1461,"_24":25,"_180":-5,"_599":1462,"_27":1463},{"_43":1448,"_32":1449,"_30":1450,"_174":425,"_41":42,"_40":1451,"_176":123,"_38":1452,"_13":61,"_33":20,"_35":1453,"_24":25,"_180":-5,"_599":1454,"_27":1455},{"_43":1440,"_32":1441,"_30":1442,"_174":425,"_41":42,"_40":1443,"_176":123,"_38":1444,"_13":61,"_33":20,"_35":1445,"_24":25,"_180":-5,"_599":1446,"_27":1447},{"_43":1432,"_32":1433,"_30":1434,"_174":425,"_41":42,"_40":1435,"_176":123,"_38":1436,"_13":178,"_33":20,"_35":1437,"_24":25,"_180":-5,"_599":1438,"_27":1439},{"_43":1425,"_32":1426,"_30":1427,"_174":425,"_41":42,"_40":389,"_176":123,"_38":1428,"_13":178,"_33":20,"_35":1429,"_24":25,"_180":-5,"_599":1430,"_27":1431},{"_43":1417,"_32":1418,"_30":1419,"_174":425,"_41":42,"_40":1420,"_176":123,"_38":1421,"_13":178,"_33":20,"_35":1422,"_24":25,"_180":-5,"_599":1423,"_27":1424},{"_43":1409,"_32":1410,"_30":1411,"_174":425,"_41":42,"_40":1412,"_176":123,"_38":1413,"_13":178,"_33":20,"_35":1414,"_24":25,"_180":-5,"_599":1415,"_27":1416},{"_43":1401,"_32":1402,"_30":1403,"_174":425,"_41":42,"_40":1404,"_176":123,"_38":1405,"_13":178,"_33":20,"_35":1406,"_24":25,"_180":-5,"_599":1407,"_27":1408},{"_43":1393,"_32":1394,"_30":1395,"_174":425,"_41":42,"_40":1396,"_176":123,"_38":1397,"_13":178,"_33":20,"_35":1398,"_24":25,"_180":-5,"_599":1399,"_27":1400},{"_43":1385,"_32":1386,"_30":1387,"_174":425,"_41":42,"_40":1388,"_176":123,"_38":1389,"_13":61,"_33":20,"_35":1390,"_24":25,"_180":-5,"_599":1391,"_27":1392},{"_43":1377,"_32":1378,"_30":1379,"_174":425,"_41":42,"_40":1380,"_176":123,"_38":1381,"_13":61,"_33":20,"_35":1382,"_24":25,"_180":-5,"_599":1383,"_27":1384},{"_43":1369,"_32":1370,"_30":1371,"_174":425,"_41":42,"_40":1372,"_176":123,"_38":1373,"_13":178,"_33":20,"_35":1374,"_24":25,"_180":-5,"_599":1375,"_27":1376},{"_43":1361,"_32":1362,"_30":1363,"_174":425,"_41":42,"_40":1364,"_176":123,"_38":1365,"_13":61,"_33":20,"_35":1366,"_24":25,"_180":-5,"_599":1367,"_27":1368},{"_43":417,"_32":418,"_30":419,"_174":-5,"_41":42,"_40":420,"_176":123,"_38":1358,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1359,"_27":1360},{"_43":1354,"_32":1221,"_30":1215,"_174":419,"_41":42,"_40":420,"_176":123,"_38":1355,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1356,"_27":1357},{"_43":1350,"_32":1295,"_30":1289,"_174":1215,"_41":42,"_40":420,"_176":123,"_38":1351,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1352,"_27":1353},{"_43":1342,"_32":1343,"_30":1344,"_174":1289,"_41":42,"_40":1345,"_176":123,"_38":1346,"_13":311,"_33":34,"_35":1347,"_24":25,"_180":-5,"_599":1348,"_27":1349},{"_43":1334,"_32":1335,"_30":1336,"_174":1289,"_41":42,"_40":1337,"_176":123,"_38":1338,"_13":311,"_33":34,"_35":1339,"_24":25,"_180":-5,"_599":1340,"_27":1341},{"_43":1326,"_32":1327,"_30":1328,"_174":1289,"_41":42,"_40":1329,"_176":123,"_38":1330,"_13":61,"_33":34,"_35":1331,"_24":25,"_180":-5,"_599":1332,"_27":1333},{"_43":1319,"_32":1320,"_30":1321,"_174":1289,"_41":42,"_40":266,"_176":123,"_38":1322,"_13":61,"_33":34,"_35":1323,"_24":25,"_180":-5,"_599":1324,"_27":1325},{"_43":1310,"_32":1311,"_30":1312,"_174":1289,"_41":42,"_40":1313,"_176":123,"_38":1314,"_13":1315,"_33":34,"_35":1316,"_24":25,"_180":-5,"_599":1317,"_27":1318},{"_43":1303,"_32":1304,"_30":1305,"_174":1289,"_41":42,"_40":185,"_176":123,"_38":1306,"_13":285,"_33":34,"_35":1307,"_24":25,"_180":-5,"_599":1308,"_27":1309},{"_43":1296,"_32":1297,"_30":1298,"_174":1289,"_41":42,"_40":208,"_176":123,"_38":1299,"_13":837,"_33":34,"_35":1300,"_24":25,"_180":-5,"_599":1301,"_27":1302},{"_43":1286,"_32":1287,"_30":1288,"_174":1289,"_41":42,"_40":1290,"_176":123,"_38":1291,"_13":187,"_33":34,"_35":1292,"_24":25,"_180":-5,"_599":1293,"_27":1294},{"_43":1278,"_32":1279,"_30":1280,"_174":1215,"_41":42,"_40":185,"_176":123,"_38":1281,"_13":1282,"_33":34,"_35":1283,"_24":25,"_180":-5,"_599":1284,"_27":1285},{"_43":1270,"_32":1271,"_30":1272,"_174":1215,"_41":42,"_40":1273,"_176":123,"_38":1274,"_13":1157,"_33":34,"_35":1275,"_24":25,"_180":-5,"_599":1276,"_27":1277},{"_43":1263,"_32":1264,"_30":1265,"_174":1215,"_41":42,"_40":420,"_176":123,"_38":1266,"_13":178,"_33":34,"_35":1267,"_24":25,"_180":-5,"_599":1268,"_27":1269},{"_43":1254,"_32":1255,"_30":1256,"_174":1215,"_41":42,"_40":1257,"_176":123,"_38":1258,"_13":1259,"_33":34,"_35":1260,"_24":25,"_180":-5,"_599":1261,"_27":1262},{"_43":1246,"_32":1247,"_30":1248,"_174":1215,"_41":42,"_40":1249,"_176":123,"_38":1250,"_13":178,"_33":34,"_35":1251,"_24":25,"_180":-5,"_599":1252,"_27":1253},{"_43":1238,"_32":1239,"_30":1240,"_174":1215,"_41":42,"_40":1241,"_176":123,"_38":1242,"_13":210,"_33":34,"_35":1243,"_24":25,"_180":-5,"_599":1244,"_27":1245},{"_43":1230,"_32":1231,"_30":1232,"_174":1215,"_41":42,"_40":1233,"_176":123,"_38":1234,"_13":61,"_33":34,"_35":1235,"_24":25,"_180":-5,"_599":1236,"_27":1237},{"_43":1222,"_32":1223,"_30":1224,"_174":1215,"_41":42,"_40":185,"_176":123,"_38":1225,"_13":1226,"_33":34,"_35":1227,"_24":25,"_180":-5,"_599":1228,"_27":1229},{"_43":1212,"_32":1213,"_30":1214,"_174":1215,"_41":42,"_40":1216,"_176":123,"_38":1217,"_13":61,"_33":34,"_35":1218,"_24":25,"_180":-5,"_599":1219,"_27":1220},{"_43":1208,"_32":1080,"_30":1091,"_174":419,"_41":42,"_40":389,"_176":123,"_38":1209,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1210,"_27":1211},{"_43":1204,"_32":1195,"_30":1190,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1205,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1206,"_27":1207},{"_43":1196,"_32":1197,"_30":1198,"_174":1190,"_41":42,"_40":1199,"_176":123,"_38":1200,"_13":311,"_33":34,"_35":1201,"_24":25,"_180":-5,"_599":1202,"_27":1203},{"_43":1188,"_32":1073,"_30":1189,"_174":1190,"_41":42,"_40":389,"_176":123,"_38":1191,"_13":178,"_33":34,"_35":1192,"_24":25,"_180":-5,"_599":1193,"_27":1194},{"_43":1183,"_32":1174,"_30":1168,"_174":1091,"_41":42,"_40":1184,"_176":123,"_38":1185,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1186,"_27":1187},{"_43":1175,"_32":1176,"_30":1177,"_174":1168,"_41":42,"_40":1178,"_176":123,"_38":1179,"_13":178,"_33":34,"_35":1180,"_24":25,"_180":-5,"_599":1181,"_27":1182},{"_43":1166,"_32":1073,"_30":1167,"_174":1168,"_41":42,"_40":1169,"_176":123,"_38":1170,"_13":178,"_33":34,"_35":1171,"_24":25,"_180":-5,"_599":1172,"_27":1173},{"_43":1162,"_32":1161,"_30":1154,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1163,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1164,"_27":1165},{"_43":1152,"_32":1073,"_30":1153,"_174":1154,"_41":42,"_40":1155,"_176":123,"_38":1156,"_13":1157,"_33":34,"_35":1158,"_24":25,"_180":-5,"_599":1159,"_27":1160},{"_43":1148,"_32":424,"_30":1142,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1149,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1150,"_27":1151},{"_43":1140,"_32":1073,"_30":1141,"_174":1142,"_41":42,"_40":1143,"_176":123,"_38":1144,"_13":210,"_33":34,"_35":1145,"_24":25,"_180":-5,"_599":1146,"_27":1147},{"_43":1136,"_32":1135,"_30":1129,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1137,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1138,"_27":1139},{"_43":1127,"_32":1073,"_30":1128,"_174":1129,"_41":42,"_40":1130,"_176":123,"_38":1131,"_13":285,"_33":34,"_35":1132,"_24":25,"_180":-5,"_599":1133,"_27":1134},{"_43":1123,"_32":1115,"_30":1110,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1124,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1125,"_27":1126},{"_43":1116,"_32":1117,"_30":1118,"_174":1110,"_41":42,"_40":185,"_176":123,"_38":1119,"_13":217,"_33":34,"_35":1120,"_24":25,"_180":-5,"_599":1121,"_27":1122},{"_43":1108,"_32":1073,"_30":1109,"_174":1110,"_41":42,"_40":389,"_176":123,"_38":1111,"_13":178,"_33":34,"_35":1112,"_24":25,"_180":-5,"_599":1113,"_27":1114},{"_43":1104,"_32":1103,"_30":1097,"_174":1091,"_41":42,"_40":1098,"_176":123,"_38":1105,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1106,"_27":1107},{"_43":1095,"_32":1073,"_30":1096,"_174":1097,"_41":42,"_40":1098,"_176":123,"_38":1099,"_13":178,"_33":34,"_35":1100,"_24":25,"_180":-5,"_599":1101,"_27":1102},{"_43":1090,"_32":1081,"_30":1075,"_174":1091,"_41":42,"_40":389,"_176":123,"_38":1092,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":1093,"_27":1094},{"_43":1082,"_32":1083,"_30":1084,"_174":1075,"_41":42,"_40":1085,"_176":123,"_38":1086,"_13":61,"_33":34,"_35":1087,"_24":25,"_180":-5,"_599":1088,"_27":1089},{"_43":1072,"_32":1073,"_30":1074,"_174":1075,"_41":42,"_40":389,"_176":123,"_38":1076,"_13":178,"_33":34,"_35":1077,"_24":25,"_180":-5,"_599":1078,"_27":1079},{"_43":1064,"_32":1065,"_30":1066,"_174":419,"_41":42,"_40":1067,"_176":123,"_38":1068,"_13":187,"_33":20,"_35":1069,"_24":25,"_180":-5,"_599":1070,"_27":1071},{"_43":1056,"_32":1057,"_30":1058,"_174":419,"_41":42,"_40":1059,"_176":123,"_38":1060,"_13":210,"_33":34,"_35":1061,"_24":25,"_180":-5,"_599":1062,"_27":1063},{"_43":1049,"_32":1050,"_30":1051,"_174":419,"_41":42,"_40":297,"_176":123,"_38":1052,"_13":178,"_33":34,"_35":1053,"_24":25,"_180":-5,"_599":1054,"_27":1055},{"_43":1042,"_32":1043,"_30":1044,"_174":419,"_41":42,"_40":208,"_176":123,"_38":1045,"_13":837,"_33":34,"_35":1046,"_24":25,"_180":-5,"_599":1047,"_27":1048},{"_43":1034,"_32":1035,"_30":1036,"_174":419,"_41":42,"_40":1037,"_176":123,"_38":1038,"_13":61,"_33":34,"_35":1039,"_24":25,"_180":-5,"_599":1040,"_27":1041},{"_43":1026,"_32":1027,"_30":1028,"_174":419,"_41":42,"_40":1029,"_176":123,"_38":1030,"_13":837,"_33":34,"_35":1031,"_24":25,"_180":-5,"_599":1032,"_27":1033},{"_43":1019,"_32":1020,"_30":1021,"_174":419,"_41":42,"_40":389,"_176":123,"_38":1022,"_13":178,"_33":34,"_35":1023,"_24":25,"_180":-5,"_599":1024,"_27":1025},{"_43":1012,"_32":1013,"_30":1014,"_174":419,"_41":42,"_40":420,"_176":123,"_38":1015,"_13":178,"_33":34,"_35":1016,"_24":25,"_180":-5,"_599":1017,"_27":1018},{"_43":1005,"_32":1006,"_30":1007,"_174":419,"_41":42,"_40":389,"_176":123,"_38":1008,"_13":178,"_33":34,"_35":1009,"_24":25,"_180":-5,"_599":1010,"_27":1011},{"_43":998,"_32":999,"_30":1000,"_174":419,"_41":42,"_40":185,"_176":123,"_38":1001,"_13":311,"_33":34,"_35":1002,"_24":25,"_180":-5,"_599":1003,"_27":1004},{"_43":991,"_32":191,"_30":992,"_174":419,"_41":42,"_40":993,"_176":123,"_38":994,"_13":187,"_33":34,"_35":995,"_24":25,"_180":-5,"_599":996,"_27":997},{"_43":411,"_32":412,"_30":413,"_174":-5,"_41":42,"_40":414,"_176":123,"_38":988,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":989,"_27":990},{"_43":981,"_32":340,"_30":982,"_174":413,"_41":42,"_40":983,"_176":123,"_38":984,"_13":210,"_33":20,"_35":985,"_24":25,"_180":-5,"_599":986,"_27":987},{"_43":973,"_32":974,"_30":975,"_174":413,"_41":42,"_40":976,"_176":123,"_38":977,"_13":202,"_33":34,"_35":978,"_24":25,"_180":-5,"_599":979,"_27":980},{"_43":965,"_32":966,"_30":967,"_174":413,"_41":42,"_40":968,"_176":123,"_38":969,"_13":311,"_33":34,"_35":970,"_24":25,"_180":-5,"_599":971,"_27":972},{"_43":956,"_32":957,"_30":958,"_174":413,"_41":42,"_40":959,"_176":123,"_38":960,"_13":961,"_33":34,"_35":962,"_24":25,"_180":-5,"_599":963,"_27":964},{"_43":948,"_32":949,"_30":950,"_174":413,"_41":42,"_40":951,"_176":123,"_38":952,"_13":210,"_33":34,"_35":953,"_24":25,"_180":-5,"_599":954,"_27":955},{"_43":940,"_32":941,"_30":942,"_174":413,"_41":42,"_40":943,"_176":123,"_38":944,"_13":202,"_33":34,"_35":945,"_24":25,"_180":-5,"_599":946,"_27":947},{"_43":932,"_32":933,"_30":934,"_174":413,"_41":42,"_40":935,"_176":123,"_38":936,"_13":904,"_33":267,"_35":937,"_24":25,"_180":-5,"_599":938,"_27":939},{"_43":924,"_32":925,"_30":926,"_174":413,"_41":42,"_40":927,"_176":123,"_38":928,"_13":61,"_33":34,"_35":929,"_24":25,"_180":-5,"_599":930,"_27":931},{"_43":916,"_32":917,"_30":918,"_174":413,"_41":42,"_40":919,"_176":123,"_38":920,"_13":202,"_33":34,"_35":921,"_24":25,"_180":-5,"_599":922,"_27":923},{"_43":908,"_32":909,"_30":910,"_174":413,"_41":42,"_40":911,"_176":123,"_38":912,"_13":187,"_33":34,"_35":913,"_24":25,"_180":-5,"_599":914,"_27":915},{"_43":899,"_32":900,"_30":901,"_174":413,"_41":42,"_40":902,"_176":123,"_38":903,"_13":904,"_33":34,"_35":905,"_24":25,"_180":-5,"_599":906,"_27":907},{"_43":891,"_32":892,"_30":893,"_174":413,"_41":42,"_40":894,"_176":123,"_38":895,"_13":61,"_33":34,"_35":896,"_24":25,"_180":-5,"_599":897,"_27":898},{"_43":884,"_32":885,"_30":886,"_174":413,"_41":42,"_40":175,"_176":123,"_38":887,"_13":178,"_33":34,"_35":888,"_24":25,"_180":-5,"_599":889,"_27":890},{"_43":405,"_32":406,"_30":407,"_174":-5,"_41":42,"_40":408,"_176":123,"_38":881,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":882,"_27":883},{"_43":872,"_32":873,"_30":874,"_174":407,"_41":42,"_40":875,"_176":123,"_38":876,"_13":877,"_33":20,"_35":878,"_24":25,"_180":-5,"_599":879,"_27":880},{"_43":864,"_32":865,"_30":866,"_174":407,"_41":42,"_40":867,"_176":123,"_38":868,"_13":285,"_33":20,"_35":869,"_24":25,"_180":-5,"_599":870,"_27":871},{"_43":856,"_32":857,"_30":858,"_174":407,"_41":42,"_40":859,"_176":123,"_38":860,"_13":217,"_33":20,"_35":861,"_24":25,"_180":-5,"_599":862,"_27":863},{"_43":849,"_32":850,"_30":851,"_174":407,"_41":42,"_40":297,"_176":123,"_38":852,"_13":178,"_33":20,"_35":853,"_24":25,"_180":-5,"_599":854,"_27":855},{"_43":841,"_32":842,"_30":843,"_174":407,"_41":42,"_40":844,"_176":123,"_38":845,"_13":178,"_33":20,"_35":846,"_24":25,"_180":-5,"_599":847,"_27":848},{"_43":832,"_32":833,"_30":834,"_174":407,"_41":42,"_40":835,"_176":123,"_38":836,"_13":837,"_33":20,"_35":838,"_24":25,"_180":-5,"_599":839,"_27":840},{"_43":824,"_32":825,"_30":826,"_174":407,"_41":42,"_40":827,"_176":123,"_38":828,"_13":61,"_33":20,"_35":829,"_24":25,"_180":-5,"_599":830,"_27":831},{"_43":817,"_32":818,"_30":819,"_174":407,"_41":42,"_40":297,"_176":123,"_38":820,"_13":187,"_33":20,"_35":821,"_24":25,"_180":-5,"_599":822,"_27":823},{"_43":810,"_32":811,"_30":812,"_174":407,"_41":42,"_40":208,"_176":123,"_38":813,"_13":178,"_33":20,"_35":814,"_24":25,"_180":-5,"_599":815,"_27":816},{"_43":803,"_32":804,"_30":805,"_174":407,"_41":42,"_40":297,"_176":123,"_38":806,"_13":178,"_33":20,"_35":807,"_24":25,"_180":-5,"_599":808,"_27":809},{"_43":399,"_32":400,"_30":401,"_174":-5,"_41":42,"_40":402,"_176":123,"_38":800,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":801,"_27":802},{"_43":793,"_32":794,"_30":795,"_174":401,"_41":42,"_40":208,"_176":123,"_38":796,"_13":178,"_33":267,"_35":797,"_24":25,"_180":-5,"_599":798,"_27":799},{"_43":786,"_32":787,"_30":788,"_174":401,"_41":42,"_40":185,"_176":123,"_38":789,"_13":178,"_33":34,"_35":790,"_24":25,"_180":-5,"_599":791,"_27":792},{"_43":779,"_32":780,"_30":781,"_174":401,"_41":42,"_40":185,"_176":123,"_38":782,"_13":178,"_33":34,"_35":783,"_24":25,"_180":-5,"_599":784,"_27":785},{"_43":772,"_32":773,"_30":774,"_174":401,"_41":42,"_40":185,"_176":123,"_38":775,"_13":178,"_33":34,"_35":776,"_24":25,"_180":-5,"_599":777,"_27":778},{"_43":765,"_32":766,"_30":767,"_174":401,"_41":42,"_40":208,"_176":123,"_38":768,"_13":178,"_33":267,"_35":769,"_24":25,"_180":-5,"_599":770,"_27":771},{"_43":758,"_32":759,"_30":760,"_174":401,"_41":42,"_40":208,"_176":123,"_38":761,"_13":178,"_33":267,"_35":762,"_24":25,"_180":-5,"_599":763,"_27":764},{"_43":751,"_32":752,"_30":753,"_174":401,"_41":42,"_40":185,"_176":123,"_38":754,"_13":178,"_33":34,"_35":755,"_24":25,"_180":-5,"_599":756,"_27":757},{"_43":744,"_32":745,"_30":746,"_174":401,"_41":42,"_40":185,"_176":123,"_38":747,"_13":178,"_33":34,"_35":748,"_24":25,"_180":-5,"_599":749,"_27":750},{"_43":737,"_32":738,"_30":739,"_174":401,"_41":42,"_40":185,"_176":123,"_38":740,"_13":178,"_33":34,"_35":741,"_24":25,"_180":-5,"_599":742,"_27":743},{"_43":730,"_32":731,"_30":732,"_174":401,"_41":42,"_40":185,"_176":123,"_38":733,"_13":178,"_33":34,"_35":734,"_24":25,"_180":-5,"_599":735,"_27":736},{"_43":723,"_32":724,"_30":725,"_174":401,"_41":42,"_40":185,"_176":123,"_38":726,"_13":178,"_33":34,"_35":727,"_24":25,"_180":-5,"_599":728,"_27":729},{"_43":393,"_32":394,"_30":395,"_174":-5,"_41":42,"_40":396,"_176":123,"_38":720,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":721,"_27":722},{"_43":715,"_32":45,"_30":709,"_174":395,"_41":42,"_40":716,"_176":123,"_38":717,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":718,"_27":719},{"_43":706,"_32":707,"_30":708,"_174":709,"_41":42,"_40":710,"_176":123,"_38":711,"_13":178,"_33":20,"_35":712,"_24":25,"_180":-5,"_599":713,"_27":714},{"_43":386,"_32":387,"_30":388,"_174":-5,"_41":42,"_40":389,"_176":123,"_38":703,"_13":178,"_33":391,"_35":-5,"_24":25,"_180":-5,"_599":704,"_27":705},{"_43":695,"_32":696,"_30":697,"_174":388,"_41":42,"_40":698,"_176":123,"_38":699,"_13":61,"_33":20,"_35":700,"_24":25,"_180":-5,"_599":701,"_27":702},{"_43":380,"_32":381,"_30":382,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":692,"_13":178,"_33":20,"_35":384,"_24":25,"_180":-5,"_599":693,"_27":694},{"_43":373,"_32":374,"_30":375,"_174":-5,"_41":42,"_40":376,"_176":123,"_38":689,"_13":178,"_33":20,"_35":378,"_24":25,"_180":-5,"_599":690,"_27":691},{"_43":367,"_32":368,"_30":369,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":686,"_13":178,"_33":20,"_35":371,"_24":25,"_180":-5,"_599":687,"_27":688},{"_43":360,"_32":361,"_30":362,"_174":-5,"_41":42,"_40":363,"_176":123,"_38":683,"_13":210,"_33":20,"_35":365,"_24":25,"_180":-5,"_599":684,"_27":685},{"_43":353,"_32":354,"_30":355,"_174":-5,"_41":42,"_40":356,"_176":123,"_38":680,"_13":187,"_33":20,"_35":358,"_24":25,"_180":-5,"_599":681,"_27":682},{"_43":346,"_32":347,"_30":348,"_174":-5,"_41":42,"_40":349,"_176":123,"_38":677,"_13":178,"_33":20,"_35":351,"_24":25,"_180":-5,"_599":678,"_27":679},{"_43":339,"_32":340,"_30":341,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":674,"_13":343,"_33":20,"_35":344,"_24":25,"_180":-5,"_599":675,"_27":676},{"_43":333,"_32":334,"_30":335,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":671,"_13":285,"_33":34,"_35":337,"_24":25,"_180":-5,"_599":672,"_27":673},{"_43":327,"_32":328,"_30":329,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":668,"_13":61,"_33":34,"_35":331,"_24":25,"_180":-5,"_599":669,"_27":670},{"_43":321,"_32":322,"_30":323,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":665,"_13":61,"_33":34,"_35":325,"_24":25,"_180":-5,"_599":666,"_27":667},{"_43":314,"_32":315,"_30":316,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":662,"_13":318,"_33":34,"_35":319,"_24":25,"_180":-5,"_599":663,"_27":664},{"_43":307,"_32":308,"_30":309,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":659,"_13":311,"_33":34,"_35":312,"_24":25,"_180":-5,"_599":660,"_27":661},{"_43":301,"_32":302,"_30":303,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":656,"_13":187,"_33":34,"_35":305,"_24":25,"_180":-5,"_599":657,"_27":658},{"_43":294,"_32":295,"_30":296,"_174":-5,"_41":42,"_40":297,"_176":123,"_38":653,"_13":178,"_33":20,"_35":299,"_24":25,"_180":-5,"_599":654,"_27":655},{"_43":288,"_32":289,"_30":290,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":650,"_13":178,"_33":34,"_35":292,"_24":25,"_180":-5,"_599":651,"_27":652},{"_43":280,"_32":281,"_30":282,"_174":-5,"_41":42,"_40":283,"_176":123,"_38":647,"_13":285,"_33":34,"_35":286,"_24":25,"_180":-5,"_599":648,"_27":649},{"_43":277,"_32":28,"_30":31,"_174":-5,"_41":42,"_40":14,"_176":123,"_38":644,"_13":210,"_33":34,"_35":37,"_24":25,"_180":-5,"_599":645,"_27":646},{"_43":270,"_32":271,"_30":272,"_174":-5,"_41":42,"_40":273,"_176":123,"_38":641,"_13":210,"_33":34,"_35":275,"_24":25,"_180":-5,"_599":642,"_27":643},{"_43":263,"_32":264,"_30":128,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":638,"_13":266,"_33":267,"_35":268,"_24":25,"_180":-5,"_599":639,"_27":640},{"_43":257,"_32":258,"_30":259,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":635,"_13":178,"_33":34,"_35":261,"_24":25,"_180":-5,"_599":636,"_27":637},{"_43":251,"_32":252,"_30":253,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":632,"_13":61,"_33":34,"_35":255,"_24":25,"_180":-5,"_599":633,"_27":634},{"_43":245,"_32":246,"_30":247,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":629,"_13":187,"_33":34,"_35":249,"_24":25,"_180":-5,"_599":630,"_27":631},{"_43":239,"_32":240,"_30":241,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":626,"_13":210,"_33":34,"_35":243,"_24":25,"_180":-5,"_599":627,"_27":628},{"_43":233,"_32":234,"_30":235,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":623,"_13":178,"_33":34,"_35":237,"_24":25,"_180":-5,"_599":624,"_27":625},{"_43":226,"_32":227,"_30":228,"_174":-5,"_41":42,"_40":229,"_176":123,"_38":620,"_13":178,"_33":34,"_35":231,"_24":25,"_180":-5,"_599":621,"_27":622},{"_43":220,"_32":221,"_30":222,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":617,"_13":178,"_33":34,"_35":224,"_24":25,"_180":-5,"_599":618,"_27":619},{"_43":213,"_32":214,"_30":215,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":614,"_13":217,"_33":34,"_35":218,"_24":25,"_180":-5,"_599":615,"_27":616},{"_43":205,"_32":206,"_30":207,"_174":-5,"_41":42,"_40":208,"_176":123,"_38":611,"_13":210,"_33":34,"_35":211,"_24":25,"_180":-5,"_599":612,"_27":613},{"_43":197,"_32":198,"_30":199,"_174":-5,"_41":42,"_40":200,"_176":123,"_38":608,"_13":202,"_33":34,"_35":203,"_24":25,"_180":-5,"_599":609,"_27":610},{"_43":190,"_32":191,"_30":192,"_174":-5,"_41":42,"_40":193,"_176":123,"_38":605,"_13":178,"_33":34,"_35":195,"_24":25,"_180":-5,"_599":606,"_27":607},{"_43":182,"_32":183,"_30":184,"_174":-5,"_41":42,"_40":185,"_176":123,"_38":602,"_13":187,"_33":34,"_35":188,"_24":25,"_180":-5,"_599":603,"_27":604},{"_43":171,"_32":172,"_30":173,"_174":-5,"_41":42,"_40":175,"_176":123,"_38":598,"_13":178,"_33":34,"_35":179,"_24":25,"_180":-5,"_599":600,"_27":601},["D",1772965847190],"children",[],[172],["D",1773707445460],[],[183],["D",1772803615260],[],[191],["D",1773360570812],[],[198],["D",1773582277011],[],[206],["D",1773582277011],[],[214],["D",1773582277011],[],[221],["D",1773306806181],[],[227],["D",1773582277011],[],[234],["D",1773582277011],[],[240],["D",1773707445460],[],[246],["D",1773707445460],[],[252],["D",1773707445460],[],[258],["D",1773707445460],[],[264],["D",1773738347617],[],[271],["D",1773738449830],[],[28],["D",1773188646576],[],[281],["D",1773582277011],[],[289],["D",1772546242374],[],[295],["D",1773707445460],[],[302],["D",1773707445460],[],[308],["D",1773582277011],[],[315],["D",1773582277011],[],[322],["D",1773582277011],[],[328],["D",1773707445460],[],[334],["D",1773707445460],[],[340],["D",1773230582762],[],[347],["D",1773314112062],[],[354],["D",1772317087667],[],[361],["D",1772546242374],[],[368],["D",1773230582769],[],[374],["D",1772546242374],[],[381],"2d1427fa-195e-11f1-aafb-42dde27851f2","favicon.svg","69ca917e-18b0-11f1-ad37-42dde27851f2",262,["D",1772802769888],"\n",[],[387,696],["D",1772728139302],[565],[387],"419c576e-1d42-11f1-bb0a-42dde27851f2","SKILL.md","419c5840-1d42-11f1-bb0a-42dde27851f2","414b860e-1d42-11f1-bb0a-42dde27851f2",447,["D",1773230583057],"---\nname: sync\ndescription: Knowledge about the sync.parc.land coordination API. Use when working with multi-agent systems, room coordination, or when the user mentions sync.parc.land.\n---\n\n# sync.parc.land API Knowledge\n\n**Base URL**: `https://sync.parc.land`\n\nThis skill provides declarative knowledge about the sync coordination platform. When the MCP server is available, prefer using MCP tools (`sync_lobby`, `sync_embody`, `sync_read_context`, etc.) for actual operations.\n\n## Core Concepts\n\n**Two operations:**\n- **Read context** → `GET /rooms/:id/context`\n- **Invoke actions** → `POST /rooms/:id/actions/:action/invoke`\n\nThere is no `_set_state`. Agents declare write capabilities as actions, then invoke them. The declaration is the commitment. The vocabulary is the protocol.\n\n## Quick Start Workflow\n\n1. **Create room**: `POST /rooms` → `{ token, view_token, id }`\n2. **Agent joins**: `POST /rooms/:id/agents` with `{ id, name, role }` → `{ token }`\n3. **Read context**: `GET /rooms/:id/context` → full state snapshot\n4. **Bootstrap vocabulary**:\n - Invoke `help` action with `{ \"params\": { \"key\": \"standard_library\" } }`\n - Use `_register_action` to declare write capabilities\n5. **Register views**: `_register_view` to expose computed state\n6. **Act**: `POST /rooms/:id/actions/:id/invoke` with params\n7. **Wait**: `GET /rooms/:id/wait?condition=` to block until condition\n\n## Auth Model\n\nThree token types:\n- **Room token** (`room_...`): Admin, full authority\n- **Agent token** (`as_...`): Own scope + grants\n- **View token** (`view_...`): Read-only\n\nAll mutations require `Authorization: Bearer `.\n\n## Built-in Actions\n\nEvery room has:\n- `_register_action` - Declare write capability (id, description, params, writes, if)\n- `_register_view` - Declare read capability (id, expr, scope, description, render)\n- `_delete_action` / `_delete_view` - Remove capabilities\n- `_send_message` - Send message (body, kind, to)\n- `help` - Access guidance (key)\n\n## Actions = Write Capabilities\n\nActions are **declared operations** with:\n\n```json\n{\n \"id\": \"vote\",\n \"description\": \"Cast or change your vote\",\n \"params\": { \"choice\": { \"type\": \"string\" } },\n \"writes\": [\n { \"scope\": \"${self}\", \"key\": \"vote\", \"value\": \"${params.choice}\" }\n ]\n}\n```\n\n**Write templates** support:\n- `${params.x}` - invocation parameters\n- `${self}` - agent ID\n- `${now}` - timestamp\n\n**Write modes**:\n- Plain value\n- `increment` - atomic counter\n- `merge` - deep object merge\n- `append` - log row or array push\n- `if_version` - proof-of-read CAS\n\n**Scope authority**: Action registrar's identity bridges authority to invoker.\n\n**Conflict detection**: Two actions writing same `(scope, key)` → warning + `_contested` view.\n\n## Views = Read Capabilities\n\nCEL expressions projecting state to public values:\n\n```json\n{\n \"id\": \"score\",\n \"expr\": \"state['_shared']['score']\",\n \"render\": { \"type\": \"metric\", \"label\": \"Score\" }\n}\n```\n\nViews scoped to an agent can read that agent's private state and expose results publicly.\n\n**Render hints**: Turn views into dashboard surfaces (metric, markdown, view-grid, action-bar, etc.).\n\n## State = Versioned Key-Value\n\nEvery entry: `(scope, key) → value` with:\n- `revision` - sequential write count\n- `version` - SHA-256 hash (16 hex chars, unforgeable)\n\nThe `version` is proof-of-read for CAS operations:\n\n```json\n{\n \"writes\": [{\n \"scope\": \"_shared\",\n \"key\": \"phase\",\n \"value\": \"active\",\n \"if_version\": \"486ea46224d1bb4f\"\n }]\n}\n```\n\n## Messages = Directed Routing\n\n```json\n{\n \"count\": 12,\n \"unread\": 3,\n \"directed_unread\": 1,\n \"recent\": [\n { \"seq\": 10, \"from\": \"alice\", \"body\": \"hello\" },\n { \"seq\": 11, \"from\": \"bob\", \"to\": [\"alice\"], \"body\": \"...\" }\n ]\n}\n```\n\n`directed_unread` counts messages with `to` containing your ID. Use as wait condition.\n\n## CEL Context\n\nEvery expression sees:\n\n```\nstate._shared.* # shared state\nstate.self.* # your private scope\nstate[\"agent-id\"].* # other agents (if authority)\nviews.* # all resolved views\nagents.* # agent metadata\nactions.* # action availability\nmessages.count # total messages\nmessages.unread # unread count\nmessages.directed_unread # directed to you\nself # your agent ID string\nparams.* # action params (in writes/if)\n```\n\n## Context Shaping\n\nQuery params for `/context`:\n\n- `depth=lean|full|usage` - detail level (default: lean)\n- `only=state,messages` - section filter\n- `messages_after=N` - pagination\n- `messages_limit=10` - cap bodies\n- `include=_audit` - opt-in scopes\n- `compact=true` - strip nulls\n\n## Standard Library\n\nInvoke `help` with `{ \"params\": { \"key\": \"standard_library\" } }` to see ready-to-register action patterns:\n\n- `set` - unconditional write\n- `delete` - remove key\n- `increment` - atomic counter\n- `append` - log or array push\n- `merge` - deep merge\n- `if_version` - CAS pattern\n\n## Complete API Surface\n\n```\nPOST /rooms # create\nGET /rooms/:id/context # read everything\nPOST /rooms/:id/actions/:id/invoke # write (only endpoint)\nGET /rooms/:id/wait # block until CEL true\nPOST /rooms/:id/agents # join\nPATCH /rooms/:id/agents/:id # update grants\nPOST /rooms/:id/eval # debug CEL\nGET /reference/:doc # api.md, cel.md, etc.\n```\n\n## Using with MCP Tools\n\nWhen the sync MCP server is available, prefer these tools over raw HTTP:\n\n**Lobby & Identity:**\n- `sync_lobby` - overview of rooms/agents/roles\n- `sync_embody` - commit to agent (creates/takes over/switches)\n- `sync_disembody` - release agent\n\n**Core Operations:**\n- `sync_read_context` - read room state (embodied or observer)\n- `sync_invoke_action` - invoke any action (requires embodiment)\n- `sync_wait` - block until condition\n\n**Vocabulary:**\n- `sync_register_action` - declare write capability\n- `sync_register_view` - declare read capability\n- `sync_delete_action` / `sync_delete_view` - remove capabilities\n\n**Sugar:**\n- `sync_send_message` - send message\n- `sync_help` - access help system\n- `sync_eval_cel` - evaluate CEL expression\n\n**Lifecycle:**\n- `sync_create_room` - create room (auto-registers in user account)\n- `sync_join_room` - low-level join (prefer `sync_embody`)\n\nThe MCP tools handle OAuth, embodiment state, scope checks, and admin escalation automatically.\n\n## Reference Documentation\n\nFull details:\n- API: `https://sync.parc.land/reference/api.md`\n- CEL: `https://sync.parc.land/reference/cel.md`\n- Examples: `https://sync.parc.land/reference/examples.md`\n- Views: `https://sync.parc.land/reference/views.md`\n- Help: `https://sync.parc.land/reference/help.md`\n- v6 Architecture: `https://sync.parc.land/reference/v6.md`\n\n## Design Philosophy\n\nFrom `reference/v6.md`:\n\n> No `_set_state`. Agents declare write capabilities as actions, then invoke them.\n> The declaration is the commitment. The vocabulary is the protocol.\n\nsync v6 is built on two axioms:\n- `_register_action` (declare write capability)\n- `_register_view` (declare read capability)\n\nEverything else is sugar. The vocabulary is the coordination mechanism.\n",[],[394,45,707],"414b8532-1d42-11f1-bb0a-42dde27851f2",440,["D",1773230582564],[563],[394,45],["D",1773230582350],[562],[394],"89c3743c-2198-11f1-9238-42dde27851f2","test-v9-wrap.ts","89c374be-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/test-v9-wrap.ts — Verify wrapped context shape.\n *\n * Creates a test room with state, actions, views, agents, and messages,\n * then calls buildContext and validates the wrapped shape.\n *\n * Run: Val.town run_file on this script\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"../schema.ts\";\nimport { migrateV8 } from \"../schema-v8.ts\";\nimport { buildContext } from \"../cel.ts\";\nimport { contentHash } from \"../utils.ts\";\n\nconst ROOM_ID = \"_test_v9_wrap_\" + Date.now();\n\nasync function setup() {\n await migrate();\n await migrateV8();\n\n // Create room\n const token = \"room_test_\" + Date.now();\n const tokenHash = await contentHash(token);\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO rooms (id, token_hash, created_at) VALUES (?, ?, datetime('now'))`,\n args: [ROOM_ID, tokenHash],\n });\n\n // Add some _shared state\n const entries = [\n { scope: \"_shared\", key: \"phase\", value: JSON.stringify(\"executing\") },\n { scope: \"_shared\", key: \"turn\", value: JSON.stringify(3) },\n {\n scope: \"_shared\",\n key: \"concepts.substrate\",\n value: JSON.stringify({\n name: \"substrate\",\n definition: \"shared-state coordination layer\",\n }),\n },\n {\n scope: \"_shared\",\n key: \"concepts.stigmergy\",\n value: JSON.stringify({\n name: \"stigmergy\",\n definition: \"indirect coordination through environment\",\n }),\n },\n ];\n\n for (const e of entries) {\n const hash = await contentHash(e.value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, ?, ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = excluded.version,\n revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM_ID, e.scope, e.key, e.value, hash],\n });\n }\n\n // Add agents\n const agents = [\n {\n id: \"explorer\",\n value: {\n name: \"Explorer\",\n role: \"concept-finder\",\n status: \"active\",\n last_heartbeat: new Date().toISOString(),\n last_seen_seq: 0,\n },\n },\n {\n id: \"synthesist\",\n value: {\n name: \"Synthesist\",\n role: \"concept-linker\",\n status: \"active\",\n last_heartbeat: new Date(Date.now() - 60000).toISOString(),\n last_seen_seq: 0,\n },\n },\n ];\n\n for (const a of agents) {\n const val = JSON.stringify(a.value);\n const hash = await contentHash(val);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = excluded.version,\n revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM_ID, a.id, val, hash],\n });\n\n // Also insert into agents table for auth\n const agentToken = \"as_test_\" + a.id;\n const agentTokenHash = await contentHash(agentToken);\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO agents (id, room_id, name, role, status, token_hash, joined_at, last_heartbeat)\n VALUES (?, ?, ?, ?, 'active', ?, datetime('now'), datetime('now'))`,\n args: [a.id, ROOM_ID, a.value.name, a.value.role, agentTokenHash],\n });\n }\n\n // Add actions\n const actions = [\n {\n id: \"add_concept\",\n value: {\n description: \"Add a new concept to the shared knowledge base\",\n registered_by: \"explorer\",\n scope: \"_shared\",\n params: {\n name: { type: \"string\" },\n definition: { type: \"string\" },\n },\n writes: [\n {\n scope: \"_shared\",\n key: \"concepts.${params.name}\",\n value: {\n name: \"${params.name}\",\n definition: \"${params.definition}\",\n },\n },\n ],\n },\n },\n {\n id: \"refine_concept\",\n value: {\n description: \"Refine an existing concept definition\",\n registered_by: \"synthesist\",\n scope: \"_shared\",\n params: {\n name: { type: \"string\" },\n definition: { type: \"string\" },\n },\n writes: [\n {\n scope: \"_shared\",\n key: \"concepts.${params.name}\",\n merge: { definition: \"${params.definition}\", refined: true },\n },\n ],\n },\n },\n ];\n\n for (const a of actions) {\n const val = JSON.stringify(a.value);\n const hash = await contentHash(val);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_actions', ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, version = excluded.version,\n revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM_ID, a.id, val, hash],\n });\n }\n\n // Add a view\n const viewDef = {\n expr: 'size(state._shared)',\n description: \"Count of entries in _shared scope\",\n registered_by: \"explorer\",\n scope: \"explorer\",\n };\n const viewVal = JSON.stringify(viewDef);\n const viewHash = await contentHash(viewVal);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', 'shared_entry_count', ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, viewVal, viewHash],\n });\n\n // Add some audit entries to populate meta\n const auditEntries = [\n {\n ts: new Date(Date.now() - 120000).toISOString(),\n kind: \"invoke\",\n agent: \"explorer\",\n action: \"add_concept\",\n ok: true,\n params: { name: \"substrate\", definition: \"shared-state coordination layer\" },\n effect: {\n writes: [\n { scope: \"_shared\", key: \"concepts.substrate\", value: { name: \"substrate\", definition: \"shared-state coordination layer\" } },\n ],\n },\n },\n {\n ts: new Date(Date.now() - 60000).toISOString(),\n kind: \"invoke\",\n agent: \"explorer\",\n action: \"add_concept\",\n ok: true,\n params: { name: \"stigmergy\", definition: \"indirect coordination\" },\n effect: {\n writes: [\n { scope: \"_shared\", key: \"concepts.stigmergy\", value: { name: \"stigmergy\", definition: \"indirect coordination\" } },\n ],\n },\n },\n {\n ts: new Date(Date.now() - 30000).toISOString(),\n kind: \"invoke\",\n agent: \"synthesist\",\n action: \"refine_concept\",\n ok: true,\n params: { name: \"stigmergy\", definition: \"indirect coordination through environment\" },\n effect: {\n writes: [\n { scope: \"_shared\", key: \"concepts.stigmergy\", value: { name: \"stigmergy\", definition: \"indirect coordination through environment\", refined: true } },\n ],\n },\n },\n ];\n\n for (let i = 0; i < auditEntries.length; i++) {\n const seq = i + 1;\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, String(seq), seq, JSON.stringify(auditEntries[i])],\n });\n }\n\n // Add a message\n const msg = JSON.stringify({\n from: \"explorer\",\n kind: \"chat\",\n body: \"Found two interesting concepts\",\n to: [\"synthesist\"],\n });\n const msgHash = await contentHash(msg);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at)\n VALUES (?, '_messages', '1', 1, ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, msg, msgHash],\n });\n}\n\nasync function test() {\n console.log(\"=== v9 Wrapped Context Test ===\\n\");\n\n // Build context as explorer\n const ctx = await buildContext(ROOM_ID, { selfAgent: \"explorer\" });\n\n // ── Verify shape ──\n const checks: Array<{ name: string; ok: boolean; detail?: string }> = [];\n\n // 1. State entries are wrapped\n const phase = ctx.state._shared?.phase;\n checks.push({\n name: \"state entry has .value\",\n ok: phase?.value === \"executing\",\n detail: `phase.value = ${JSON.stringify(phase?.value)}`,\n });\n checks.push({\n name: \"state entry has ._meta\",\n ok: typeof phase?._meta === \"object\" && phase._meta !== null,\n detail: `phase._meta keys: ${phase?._meta ? Object.keys(phase._meta).join(\", \") : \"MISSING\"}`,\n });\n checks.push({\n name: \"_meta has revision\",\n ok: typeof phase?._meta?.revision === \"number\",\n detail: `revision = ${phase?._meta?.revision}`,\n });\n checks.push({\n name: \"_meta has score\",\n ok: typeof phase?._meta?.score === \"number\",\n detail: `score = ${phase?._meta?.score}`,\n });\n checks.push({\n name: \"_meta has velocity\",\n ok: typeof phase?._meta?.velocity === \"number\",\n detail: `velocity = ${phase?._meta?.velocity}`,\n });\n\n // 2. Concepts have provenance from audit\n const substrate = ctx.state._shared?.[\"concepts.substrate\"];\n checks.push({\n name: \"concepts.substrate has writer from audit\",\n ok: substrate?._meta?.writer === \"explorer\",\n detail: `writer = ${substrate?._meta?.writer}`,\n });\n checks.push({\n name: \"concepts.substrate has via from audit\",\n ok: substrate?._meta?.via === \"add_concept\",\n detail: `via = ${substrate?._meta?.via}`,\n });\n\n // 3. Key with multiple writers\n const stigmergy = ctx.state._shared?.[\"concepts.stigmergy\"];\n checks.push({\n name: \"stigmergy last writer is synthesist\",\n ok: stigmergy?._meta?.writer === \"synthesist\",\n detail: `writer = ${stigmergy?._meta?.writer}`,\n });\n checks.push({\n name: \"stigmergy has multiple writers\",\n ok: Array.isArray(stigmergy?._meta?.writers) && stigmergy._meta.writers.length === 2,\n detail: `writers = ${JSON.stringify(stigmergy?._meta?.writers)}`,\n });\n\n // 4. Agents are wrapped\n const explorerAgent = ctx.agents?.explorer;\n checks.push({\n name: \"agents.explorer has .value.name\",\n ok: explorerAgent?.value?.name === \"Explorer\",\n detail: `name = ${explorerAgent?.value?.name}`,\n });\n checks.push({\n name: \"agents.explorer has ._meta\",\n ok: typeof explorerAgent?._meta === \"object\",\n detail: `_meta keys: ${explorerAgent?._meta ? Object.keys(explorerAgent._meta).join(\", \") : \"MISSING\"}`,\n });\n\n // 5. Actions are wrapped with action-specific meta\n const addConcept = ctx.actions?.add_concept;\n checks.push({\n name: \"actions.add_concept has .value\",\n ok: typeof addConcept?.value === \"object\",\n detail: `value = ${JSON.stringify(addConcept?.value)}`,\n });\n checks.push({\n name: \"actions.add_concept has invocations in _meta\",\n ok: typeof addConcept?._meta?.invocations === \"number\",\n detail: `invocations = ${(addConcept?._meta as any)?.invocations}`,\n });\n checks.push({\n name: \"add_concept invocations = 2 (from audit)\",\n ok: (addConcept?._meta as any)?.invocations === 2,\n detail: `invocations = ${(addConcept?._meta as any)?.invocations}`,\n });\n checks.push({\n name: \"add_concept contested with refine_concept\",\n ok: Array.isArray((addConcept?._meta as any)?.contested) &&\n (addConcept?._meta as any)?.contested.includes(\"refine_concept\"),\n detail: `contested = ${JSON.stringify((addConcept?._meta as any)?.contested)}`,\n });\n\n // 6. Views are wrapped\n const viewResult = ctx.views?.shared_entry_count;\n checks.push({\n name: \"views.shared_entry_count has .value\",\n ok: typeof viewResult?.value === \"number\",\n detail: `value = ${viewResult?.value}`,\n });\n checks.push({\n name: \"views.shared_entry_count has ._meta\",\n ok: typeof viewResult?._meta === \"object\",\n detail: `_meta keys: ${viewResult?._meta ? Object.keys(viewResult._meta).join(\", \") : \"MISSING\"}`,\n });\n\n // 7. Messages summary (not wrapped — it's a computed aggregate)\n checks.push({\n name: \"messages is a summary object\",\n ok: typeof ctx.messages?.count === \"number\",\n detail: `count = ${ctx.messages?.count}`,\n });\n checks.push({\n name: \"directed_unread for synthesist's message to explorer\",\n ok: true, // explorer's directed_unread is 0 because the message is FROM explorer TO synthesist\n detail: `directed_unread = ${ctx.messages?.directed_unread}`,\n });\n\n // 8. Self is set\n checks.push({\n name: \"self = explorer\",\n ok: ctx.self === \"explorer\",\n detail: `self = ${ctx.self}`,\n });\n\n // ── Print results ──\n let passed = 0;\n let failed = 0;\n for (const c of checks) {\n const icon = c.ok ? \"✓\" : \"✗\";\n console.log(` ${icon} ${c.name}${c.detail ? ` — ${c.detail}` : \"\"}`);\n if (c.ok) passed++;\n else failed++;\n }\n\n console.log(`\\n${passed} passed, ${failed} failed out of ${checks.length} checks`);\n\n // ── Print sample wrapped entries ──\n console.log(\"\\n=== Sample wrapped entries ===\\n\");\n console.log(\"state._shared.phase:\");\n console.log(JSON.stringify(phase, null, 2));\n console.log(\"\\nstate._shared['concepts.stigmergy']:\");\n console.log(JSON.stringify(stigmergy, null, 2));\n console.log(\"\\nactions.add_concept:\");\n console.log(JSON.stringify(addConcept, null, 2));\n console.log(\"\\nviews.shared_entry_count:\");\n console.log(JSON.stringify(viewResult, null, 2));\n\n return { passed, failed, total: checks.length };\n}\n\nasync function cleanup() {\n await sqlite.execute({\n sql: `DELETE FROM state WHERE room_id = ?`,\n args: [ROOM_ID],\n });\n await sqlite.execute({\n sql: `DELETE FROM agents WHERE room_id = ?`,\n args: [ROOM_ID],\n });\n await sqlite.execute({\n sql: `DELETE FROM rooms WHERE id = ?`,\n args: [ROOM_ID],\n });\n try {\n await sqlite.execute({\n sql: `DELETE FROM log_index WHERE room_id = ?`,\n args: [ROOM_ID],\n });\n } catch {}\n}\n\n// ── Run ──\ntry {\n await setup();\n const result = await test();\n await cleanup();\n if (result.failed > 0) {\n console.error(`\\n❌ ${result.failed} checks failed`);\n } else {\n console.log(`\\n✅ All ${result.total} checks passed`);\n }\n} catch (e) {\n console.error(\"Test error:\", e);\n await cleanup().catch(() => {});\n throw e;\n}\n",[],[400,724],"89c33fda-2198-11f1-9238-42dde27851f2","test-v9-validation.ts","89c3405c-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/test-v9-validation.ts — Test the CEL validation pipeline and Environment.\n *\n * Verifies: parse errors, type checking, lint detection, domain helpers,\n * receiver methods, and structured error feedback.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"../schema.ts\";\nimport { migrateV8 } from \"../schema-v8.ts\";\nimport { validateExpression, celEval, buildContext, getCelEnvironment } from \"../cel.ts\";\nimport { contentHash } from \"../utils.ts\";\n\nconst ROOM_ID = \"_test_v9_val_\" + Date.now();\n\nasync function setup() {\n await migrate();\n await migrateV8();\n\n const tokenHash = await contentHash(\"room_test_\" + Date.now());\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO rooms (id, token_hash, created_at) VALUES (?, ?, datetime('now'))`,\n args: [ROOM_ID, tokenHash],\n });\n\n const entries = [\n { scope: \"_shared\", key: \"phase\", value: JSON.stringify(\"executing\") },\n { scope: \"_shared\", key: \"turn\", value: JSON.stringify(3) },\n { scope: \"_shared\", key: \"concepts.substrate\", value: JSON.stringify({ name: \"substrate\", definition: \"shared-state\" }) },\n ];\n for (const e of entries) {\n const hash = await contentHash(e.value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at) VALUES (?, ?, ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, e.scope, e.key, e.value, hash],\n });\n }\n\n // Agent\n const agentVal = JSON.stringify({ name: \"Explorer\", role: \"finder\", status: \"active\", last_heartbeat: new Date().toISOString(), last_seen_seq: 0 });\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at) VALUES (?, '_agents', 'explorer', ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, agentVal, await contentHash(agentVal)],\n });\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO agents (id, room_id, name, role, status, token_hash, joined_at, last_heartbeat)\n VALUES ('explorer', ?, 'Explorer', 'finder', 'active', ?, datetime('now'), datetime('now'))`,\n args: [ROOM_ID, await contentHash(\"as_test_explorer\")],\n });\n\n // Audit for provenance\n const audit = {\n ts: new Date().toISOString(), kind: \"invoke\", agent: \"explorer\", action: \"write_phase\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"phase\" }] },\n };\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at) VALUES (?, '_audit', '1', 1, ?, 1, datetime('now'))`,\n args: [ROOM_ID, JSON.stringify(audit)],\n });\n}\n\nasync function cleanup() {\n for (const sql of [\n `DELETE FROM state WHERE room_id = ?`,\n `DELETE FROM agents WHERE room_id = ?`,\n `DELETE FROM rooms WHERE id = ?`,\n `DELETE FROM log_index WHERE room_id = ?`,\n ]) { try { await sqlite.execute({ sql, args: [ROOM_ID] }); } catch {} }\n}\n\nlet passed = 0;\nlet failed = 0;\n\nfunction check(name: string, ok: boolean, detail?: string) {\n const icon = ok ? \"✓\" : \"✗\";\n console.log(` ${icon} ${name}${detail ? ` — ${detail}` : \"\"}`);\n if (ok) passed++; else failed++;\n}\n\nasync function test() {\n console.log(\"=== v9 Validation Pipeline Tests ===\\n\");\n\n // ── 1. Parse errors ──\n console.log(\"--- Parse errors ---\\n\");\n\n const parseEmpty = validateExpression(\"\");\n check(\"empty expression → parse error\", !parseEmpty.valid && parseEmpty.stage === \"parse\");\n\n const parseBadSyntax = validateExpression(\"state._shared.phase ==\");\n check(\"missing operand → parse error\", !parseBadSyntax.valid && parseBadSyntax.stage === \"parse\",\n parseBadSyntax.error);\n check(\"parse error has hint\", !!parseBadSyntax.hint);\n check(\"parse error has source pointer\", !!parseBadSyntax.source);\n\n const parseTripleEquals = validateExpression('state._shared.phase === \"test\"');\n check(\"=== (JS not CEL) → parse error\", !parseTripleEquals.valid && parseTripleEquals.stage === \"parse\");\n\n const parsePipe = validateExpression(\"state._shared | keys()\");\n check(\"pipe syntax → parse error\", !parsePipe.valid && parsePipe.stage === \"parse\");\n\n // ── 2. Valid expressions ──\n console.log(\"\\n--- Valid expressions ---\\n\");\n\n const validValue = validateExpression('state._shared.phase.value == \"executing\"');\n check(\"v9 value access is valid\", validValue.valid);\n\n const validMeta = validateExpression(\"state._shared.phase._meta.score > 0.5\");\n check(\"v9 meta access is valid\", validMeta.valid);\n\n const validHelper = validateExpression(\"salient(state._shared, 0.5)\");\n check(\"domain helper is valid\", validHelper.valid);\n\n const validKeys = validateExpression(\"state._shared.keys()\");\n check(\"receiver method .keys() is valid\", validKeys.valid);\n\n const validEntries = validateExpression(\"state._shared.entries().filter(e, e.entry._meta.score > 0.5)\");\n check(\"entries + filter chain is valid\", validEntries.valid);\n\n const validWrittenBy = validateExpression('written_by(state._shared, \"explorer\")');\n check(\"written_by helper is valid\", validWrittenBy.valid);\n\n const validVal = validateExpression('val(state._shared.phase) == \"executing\"');\n check(\"val() shorthand is valid\", validVal.valid);\n\n const validMeta2 = validateExpression('meta(state._shared.phase, \"writer\")');\n check(\"meta() shorthand is valid\", validMeta2.valid);\n\n // ── 3. Lint warnings (old-style) ──\n console.log(\"\\n--- Lint warnings (v8 patterns) ---\\n\");\n\n const lintBareCompare = validateExpression('state._shared.phase == \"executing\"');\n check(\"bare comparison → valid with warning\",\n lintBareCompare.valid === true && (lintBareCompare.warnings?.length ?? 0) > 0,\n lintBareCompare.warnings?.[0]);\n\n const lintBareNumeric = validateExpression(\"state._shared.turn > 2\");\n check(\"bare numeric comparison → valid with warning\",\n lintBareNumeric.valid === true && (lintBareNumeric.warnings?.length ?? 0) > 0,\n lintBareNumeric.warnings?.[0]);\n\n const lintCorrectValue = validateExpression('state._shared.phase.value == \"executing\"');\n check(\"correct .value access → no warnings\",\n lintCorrectValue.valid === true && (lintCorrectValue.warnings?.length ?? 0) === 0);\n\n const lintCorrectMeta = validateExpression(\"state._shared.phase._meta.score > 0.5\");\n check(\"correct ._meta access → no warnings\",\n lintCorrectMeta.valid === true && (lintCorrectMeta.warnings?.length ?? 0) === 0);\n\n // ── 4. Trial evaluation against room state ──\n console.log(\"\\n--- Trial evaluation ---\\n\");\n\n const ctx = await buildContext(ROOM_ID, { selfAgent: \"explorer\" });\n\n const trialValid = validateExpression('state._shared.phase.value == \"executing\"', ctx);\n check(\"trial eval: valid expr → ok\", trialValid.valid && trialValid.stage === \"ok\",\n `type: ${trialValid.type}`);\n\n const trialMissing = validateExpression(\"state._shared.nonexistent.value\", ctx);\n check(\"trial eval: missing key → eval error\", !trialMissing.valid && trialMissing.stage === \"eval\",\n trialMissing.error);\n check(\"trial eval: missing key has hint\", !!trialMissing.hint);\n\n const trialType = validateExpression(\"state._shared.phase.value * 2\", ctx);\n check(\"trial eval: type mismatch → eval error\", !trialType.valid && trialType.stage === \"eval\",\n trialType.error);\n check(\"trial eval: type mismatch has hint\", trialType.hint?.includes(\"Type mismatch\") ?? false);\n\n // ── 5. Environment domain helpers work on room context ──\n console.log(\"\\n--- Domain helpers on real room state ---\\n\");\n\n try {\n const r1 = celEval(\"salient(state._shared, 0.0)\", ctx);\n check(\"salient() returns list\", Array.isArray(r1), `${JSON.stringify(r1)}`);\n } catch (e: any) { check(\"salient() works\", false, e.message); }\n\n try {\n const r2 = celEval('written_by(state._shared, \"explorer\")', ctx);\n check(\"written_by() returns list\", Array.isArray(r2), `${JSON.stringify(r2)}`);\n } catch (e: any) { check(\"written_by() works\", false, e.message); }\n\n try {\n const r3 = celEval(\"elided(state._shared)\", ctx);\n check(\"elided() returns empty list (nothing elided at engine layer)\", Array.isArray(r3) && r3.length === 0);\n } catch (e: any) { check(\"elided() works\", false, e.message); }\n\n try {\n const r4 = celEval(\"state._shared.keys()\", ctx);\n check(\".keys() receiver works\", Array.isArray(r4), `${JSON.stringify(r4)}`);\n } catch (e: any) { check(\".keys() receiver works\", false, e.message); }\n\n try {\n const r5 = celEval(\"state._shared.entries().filter(e, e.entry._meta.score > 0).size()\", ctx);\n check(\"entries().filter().size() chain works\", typeof r5 === \"bigint\" || typeof r5 === \"number\",\n `result: ${r5}`);\n } catch (e: any) { check(\"entries().filter().size() chain\", false, e.message); }\n\n try {\n const r6 = celEval('val(state._shared.phase) == \"executing\"', ctx);\n check(\"val() shorthand evaluates correctly\", r6 === true);\n } catch (e: any) { check(\"val() shorthand\", false, e.message); }\n\n try {\n const r7 = celEval('meta(state._shared.phase, \"writer\")', ctx);\n check(\"meta() shorthand returns writer\", r7 === \"explorer\" || r7 === null,\n `writer: ${r7}`);\n } catch (e: any) { check(\"meta() shorthand\", false, e.message); }\n\n try {\n const r8 = celEval(\"top_n(state._shared, 2)\", ctx);\n check(\"top_n() returns list of N keys\", Array.isArray(r8) && r8.length === 2,\n `${JSON.stringify(r8)}`);\n } catch (e: any) { check(\"top_n() works\", false, e.message); }\n\n // ── 6. getDefinitions() for agent documentation ──\n console.log(\"\\n--- Environment definitions ---\\n\");\n\n const env = getCelEnvironment();\n try {\n const defs = env.getDefinitions();\n const customFns = defs.functions?.filter((f: any) => {\n const sig = f.signature ?? \"\";\n return sig.includes(\"salient\") || sig.includes(\"elided\") || sig.includes(\"written_by\") ||\n sig.includes(\"val(\") || sig.includes(\"meta(\") || sig.includes(\"focus\") ||\n sig.includes(\"contested\") || sig.includes(\"stale\") || sig.includes(\"active\") ||\n sig.includes(\"velocity_above\") || sig.includes(\"top_n\") || sig.includes(\"peripheral\");\n }) ?? [];\n check(\"custom domain functions registered\", customFns.length >= 10,\n `found ${customFns.length} domain functions`);\n\n // Check that our functions have descriptions\n const withDesc = customFns.filter((f: any) => f.description);\n check(\"domain functions have descriptions\", withDesc.length === customFns.length,\n `${withDesc.length}/${customFns.length} have descriptions`);\n } catch (e: any) { check(\"getDefinitions()\", false, e.message); }\n}\n\ntry {\n await setup();\n await test();\n await cleanup();\n console.log(`\\n${passed} passed, ${failed} failed out of ${passed + failed}`);\n if (failed > 0) console.error(`\\n❌ ${failed} checks failed`);\n else console.log(`\\n✅ All checks passed`);\n} catch (e) {\n console.error(\"Test error:\", e);\n await cleanup().catch(() => {});\n throw e;\n}\n",[],[400,731],"89c30a6a-2198-11f1-9238-42dde27851f2","test-v9-phase2.ts","89c30af6-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/test-v9-phase2.ts — Phase 2 integration test.\n *\n * Tests:\n * 1. buildExpandedContext returns wrapped { value, _meta } shape\n * 2. Salience-threshold shaping (focus/peripheral/elided tiers)\n * 3. expand param forces keys to Focus\n * 4. elision: \"none\" disables elision\n * 5. _shaping summary in response\n * 6. invoke response includes wrapped writes with _meta\n * 7. No _salience, _contested, or _context in response\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"../schema.ts\";\nimport { migrateV8 } from \"../schema-v8.ts\";\nimport { buildExpandedContext } from \"../context.ts\";\nimport { invokeAction } from \"../invoke.ts\";\nimport { registerAction } from \"../actions.ts\";\nimport { contentHash } from \"../utils.ts\";\nimport type { AuthResult } from \"../auth.ts\";\n\nconst ROOM = \"_test_v9_p2_\" + Date.now();\n\n// ── Setup ──────────────────────────────────────────────────────────────\n\nasync function setup() {\n await migrate();\n await migrateV8();\n\n const token = \"room_test_\" + Date.now();\n const tokenHash = await contentHash(token);\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO rooms (id, token_hash, created_at) VALUES (?, ?, datetime('now'))`,\n args: [ROOM, tokenHash],\n });\n\n // Mix of entries: some will be high-salience, some low\n const entries = [\n { scope: \"_shared\", key: \"phase\", value: JSON.stringify(\"executing\") },\n { scope: \"_shared\", key: \"turn\", value: JSON.stringify(3) },\n { scope: \"_shared\", key: \"concepts.substrate\", value: JSON.stringify({ name: \"substrate\" }) },\n { scope: \"_shared\", key: \"concepts.stigmergy\", value: JSON.stringify({ name: \"stigmergy\" }) },\n // Low-activity keys\n { scope: \"_shared\", key: \"config.display_mode\", value: JSON.stringify(\"grid\") },\n { scope: \"_shared\", key: \"config.max_turns\", value: JSON.stringify(10) },\n { scope: \"_shared\", key: \"archive.old_concept_1\", value: JSON.stringify({ name: \"old1\", archived: true }) },\n { scope: \"_shared\", key: \"archive.old_concept_2\", value: JSON.stringify({ name: \"old2\", archived: true }) },\n ];\n\n for (const e of entries) {\n const hash = await contentHash(e.value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, ?, ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM, e.scope, e.key, e.value, hash],\n });\n }\n\n // Agents\n for (const id of [\"explorer\", \"synthesist\"]) {\n const val = JSON.stringify({\n name: id, role: \"agent\", status: \"active\",\n last_heartbeat: new Date().toISOString(), last_seen_seq: 0,\n });\n const hash = await contentHash(val);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM, id, val, hash],\n });\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO agents (id, room_id, name, role, status, token_hash, joined_at, last_heartbeat)\n VALUES (?, ?, ?, 'agent', 'active', ?, datetime('now'), datetime('now'))`,\n args: [id, ROOM, id, await contentHash(\"as_\" + id)],\n });\n }\n\n // Audit entries — give some keys high recency/dependency signals\n const audits = [\n {\n ts: new Date(Date.now() - 10000).toISOString(),\n kind: \"invoke\", agent: \"explorer\", action: \"add_concept\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.substrate\" }] },\n },\n {\n ts: new Date(Date.now() - 5000).toISOString(),\n kind: \"invoke\", agent: \"synthesist\", action: \"refine\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.stigmergy\" }, { scope: \"_shared\", key: \"phase\" }] },\n },\n ];\n for (let i = 0; i < audits.length; i++) {\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM, String(i + 1), i + 1, JSON.stringify(audits[i])],\n });\n }\n\n // Register an action (so invoke test works)\n const auth: AuthResult = {\n authenticated: true, kind: \"room\", agentId: \"explorer\",\n roomId: ROOM, grants: [\"*\"],\n };\n await registerAction(ROOM, {\n id: \"set_phase\",\n description: \"Set the phase\",\n writes: [{ scope: \"_shared\", key: \"phase\", value: \"${params.phase}\" }],\n params: { phase: { type: \"string\" } },\n }, auth);\n\n // A message\n const msg = JSON.stringify({ from: \"explorer\", kind: \"chat\", body: \"hello\" });\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, revision, updated_at)\n VALUES (?, '_messages', '1', 1, ?, ?, 1, datetime('now'))`,\n args: [ROOM, msg, await contentHash(msg)],\n });\n}\n\n// ── Test harness ───────────────────────────────────────────────────────\n\nlet passed = 0;\nlet failed = 0;\nconst failures: string[] = [];\n\nfunction check(name: string, ok: boolean, detail?: string) {\n if (ok) { console.log(` ✓ ${name}`); passed++; }\n else { console.log(` ✗ ${name}${detail ? ` — ${detail}` : \"\"}`); failed++; failures.push(name); }\n}\n\n// ── Tests ──────────────────────────────────────────────────────────────\n\nasync function testWrappedShape() {\n console.log(\"\\n── 1. Wrapped shape in response ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true, kind: \"agent\", agentId: \"explorer\",\n roomId: ROOM, grants: [],\n };\n\n const ctx = await buildExpandedContext(ROOM, auth, { elision: \"none\" });\n\n // State entries are wrapped\n const phase = ctx.state?._shared?.phase;\n check(\"state entry has .value\", phase?.value === \"executing\");\n check(\"state entry has ._meta\", typeof phase?._meta === \"object\");\n check(\"_meta has score\", typeof phase?._meta?.score === \"number\");\n check(\"_meta has writer\", phase?._meta?.writer !== undefined);\n check(\"_meta has velocity\", typeof phase?._meta?.velocity === \"number\");\n\n // Agents wrapped\n const exp = ctx.agents?.explorer;\n check(\"agent has .value.name\", exp?.value?.name === \"explorer\");\n check(\"agent has ._meta\", typeof exp?._meta === \"object\");\n\n // Actions wrapped\n const sp = ctx.actions?.set_phase;\n check(\"action has .value\", typeof sp?.value === \"object\");\n check(\"action has ._meta.invocations\", typeof sp?._meta?.invocations === \"number\");\n\n // No old synthetic views\n check(\"no _salience in views\", !ctx.views?._salience);\n check(\"no _contested in views\", !ctx.views?._contested);\n check(\"no _context in response\", !ctx._context);\n\n // _shaping summary present\n check(\"_shaping present\", typeof ctx._shaping === \"object\");\n check(\"_shaping has state_entries\", typeof ctx._shaping?.state_entries === \"object\");\n}\n\nasync function testSalienceShaping() {\n console.log(\"\\n── 2. Salience-threshold shaping ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true, kind: \"agent\", agentId: \"explorer\",\n roomId: ROOM, grants: [],\n };\n\n // Default thresholds: focus=0.5, elide=0.1\n const ctx = await buildExpandedContext(ROOM, auth);\n\n const shared = ctx.state?._shared ?? {};\n const keys = Object.keys(shared);\n check(\"state has entries\", keys.length > 0, `${keys.length} keys`);\n\n // Check for elided entries (value: null)\n const elidedKeys = keys.filter(k => shared[k]?.value === null);\n const nonElidedKeys = keys.filter(k => shared[k]?.value !== null);\n check(\"some entries may be elided\", true, `elided: ${elidedKeys.length}, non-elided: ${nonElidedKeys.length}`);\n\n // Elided entries should have _meta.elided: true\n for (const k of elidedKeys) {\n check(`elided key ${k} has _meta.elided`, shared[k]._meta?.elided === true);\n check(`elided key ${k} has expand hint`, typeof shared[k]._meta?.expand === \"string\");\n }\n\n // Non-elided entries should have _meta.elided: false or undefined\n for (const k of nonElidedKeys.slice(0, 3)) { // check first 3\n check(`non-elided key ${k} has value`, shared[k]?.value !== null && shared[k]?.value !== undefined);\n }\n\n // _shaping summary\n check(\"_shaping.state_entries.total > 0\", (ctx._shaping?.state_entries?.total ?? 0) > 0);\n}\n\nasync function testExpandParam() {\n console.log(\"\\n── 3. expand param ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true, kind: \"agent\", agentId: \"explorer\",\n roomId: ROOM, grants: [],\n };\n\n // First get default — some keys may be elided\n const defaultCtx = await buildExpandedContext(ROOM, auth);\n const defaultShared = defaultCtx.state?._shared ?? {};\n const defaultElidedKeys = Object.keys(defaultShared).filter(k => defaultShared[k]?.value === null);\n\n if (defaultElidedKeys.length > 0) {\n // Expand one of the elided keys\n const keyToExpand = defaultElidedKeys[0];\n const expandedCtx = await buildExpandedContext(ROOM, auth, {\n expand: [`_shared.${keyToExpand}`],\n });\n const expandedEntry = expandedCtx.state?._shared?.[keyToExpand];\n check(`expanded key ${keyToExpand} has value`, expandedEntry?.value !== null);\n check(`expanded key has full _meta`, !!expandedEntry?._meta?.writers);\n } else {\n check(\"(no elided keys to test expand — all above threshold)\", true);\n }\n}\n\nasync function testElisionNone() {\n console.log(\"\\n── 4. elision: none ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true, kind: \"agent\", agentId: \"explorer\",\n roomId: ROOM, grants: [],\n };\n\n const ctx = await buildExpandedContext(ROOM, auth, { elision: \"none\" });\n const shared = ctx.state?._shared ?? {};\n const elidedKeys = Object.keys(shared).filter(k => shared[k]?.value === null);\n check(\"no elided entries with elision:none\", elidedKeys.length === 0, `${elidedKeys.length} still elided`);\n check(\"_shaping.elision is 'none'\", ctx._shaping?.elision === \"none\");\n}\n\nasync function testInvokeWrappedWrites() {\n console.log(\"\\n── 5. Invoke response with wrapped writes ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true, kind: \"agent\", agentId: \"explorer\",\n roomId: ROOM, grants: [\"*\"],\n };\n\n const response = await invokeAction(ROOM, \"set_phase\", {\n agent: \"explorer\",\n params: { phase: \"synthesis\" },\n }, auth);\n\n const body = await response.json();\n check(\"invoke succeeded\", body.invoked === true);\n check(\"writes is an array\", Array.isArray(body.writes));\n\n if (body.writes?.length > 0) {\n const w = body.writes[0];\n check(\"write has .value\", w.value !== undefined);\n check(\"write has ._meta\", typeof w._meta === \"object\");\n check(\"write _meta has score\", typeof w._meta?.score === \"number\");\n check(\"write _meta has writer\", w._meta?.writer !== undefined);\n check(\"write _meta has revision\", typeof w._meta?.revision === \"number\");\n check(\"write _meta has velocity\", typeof w._meta?.velocity === \"number\");\n check(\"write scope is _shared\", w.scope === \"_shared\");\n check(\"write key is phase\", w.key === \"phase\");\n }\n}\n\n// ── Run ────────────────────────────────────────────────────────────────\n\nasync function cleanup() {\n for (const sql of [\n `DELETE FROM state WHERE room_id = ?`,\n `DELETE FROM agents WHERE room_id = ?`,\n `DELETE FROM rooms WHERE id = ?`,\n `DELETE FROM log_index WHERE room_id = ?`,\n ]) {\n try { await sqlite.execute({ sql, args: [ROOM] }); } catch {}\n }\n}\n\ntry {\n await setup();\n await testWrappedShape();\n await testSalienceShaping();\n await testExpandParam();\n await testElisionNone();\n await testInvokeWrappedWrites();\n await cleanup();\n\n console.log(`\\n════════════════════════════════════════`);\n console.log(`${passed} passed, ${failed} failed`);\n if (failures.length > 0) {\n console.log(`\\nFailed:`);\n for (const f of failures) console.log(` - ${f}`);\n }\n console.log(`════════════════════════════════════════`);\n\n if (failed > 0) console.error(`\\n❌ ${failed} checks failed`);\n else console.log(`\\n✅ All ${passed} checks passed`);\n} catch (e) {\n console.error(\"Test error:\", e);\n await cleanup().catch(() => {});\n throw e;\n}\n",[],[400,738],"89c2bd26-2198-11f1-9238-42dde27851f2","test-v9-env.ts","89c2be2a-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/test-v9-env.ts — Integration test for v9 Environment + validation pipeline.\n *\n * Tests:\n * 1. Environment singleton (celEval uses domain helpers)\n * 2. buildContext produces wrapped entries evaluated via Environment\n * 3. validateExpression pipeline (parse, check, lint, eval stages)\n * 4. Action registration with CEL validation and lint warnings\n * 5. View registration with CEL evaluation via Environment\n * 6. Error quality: specific hints for common mistakes\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"../schema.ts\";\nimport { migrateV8 } from \"../schema-v8.ts\";\nimport {\n buildContext,\n celEval,\n getCelEnvironment,\n validateExpression,\n validateCel,\n} from \"../cel.ts\";\nimport { registerAction } from \"../actions.ts\";\nimport { registerView } from \"../views.ts\";\nimport { contentHash } from \"../utils.ts\";\nimport type { AuthResult } from \"../auth.ts\";\n\nconst ROOM = \"_test_v9_env_\" + Date.now();\n\n// ── Setup ──────────────────────────────────────────────────────────────\n\nasync function setup() {\n await migrate();\n await migrateV8();\n\n const token = \"room_test_\" + Date.now();\n const tokenHash = await contentHash(token);\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO rooms (id, token_hash, created_at) VALUES (?, ?, datetime('now'))`,\n args: [ROOM, tokenHash],\n });\n\n // State entries\n const entries = [\n { scope: \"_shared\", key: \"phase\", value: JSON.stringify(\"executing\") },\n { scope: \"_shared\", key: \"turn\", value: JSON.stringify(3) },\n {\n scope: \"_shared\",\n key: \"concepts.substrate\",\n value: JSON.stringify({\n name: \"substrate\",\n definition: \"shared-state coordination\",\n }),\n },\n {\n scope: \"_shared\",\n key: \"concepts.stigmergy\",\n value: JSON.stringify({\n name: \"stigmergy\",\n definition: \"indirect coordination\",\n }),\n },\n ];\n\n for (const e of entries) {\n const hash = await contentHash(e.value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, ?, ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM, e.scope, e.key, e.value, hash],\n });\n }\n\n // Agents\n for (const id of [\"explorer\", \"synthesist\"]) {\n const val = JSON.stringify({\n name: id, role: \"agent\", status: \"active\",\n last_heartbeat: new Date().toISOString(), last_seen_seq: 0,\n });\n const hash = await contentHash(val);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, ?, 1, datetime('now'))\n ON CONFLICT(room_id, scope, key) DO UPDATE SET\n value = excluded.value, revision = state.revision + 1, updated_at = datetime('now')`,\n args: [ROOM, id, val, hash],\n });\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO agents (id, room_id, name, role, status, token_hash, joined_at, last_heartbeat)\n VALUES (?, ?, ?, 'agent', 'active', ?, datetime('now'), datetime('now'))`,\n args: [id, ROOM, id, await contentHash(\"as_\" + id)],\n });\n }\n\n // Audit entries\n const audits = [\n {\n ts: new Date(Date.now() - 60000).toISOString(),\n kind: \"invoke\", agent: \"explorer\", action: \"add_concept\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.substrate\" }] },\n },\n {\n ts: new Date(Date.now() - 30000).toISOString(),\n kind: \"invoke\", agent: \"synthesist\", action: \"refine\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.stigmergy\" }] },\n },\n ];\n for (let i = 0; i < audits.length; i++) {\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM, String(i + 1), i + 1, JSON.stringify(audits[i])],\n });\n }\n}\n\n// ── Test harness ───────────────────────────────────────────────────────\n\nlet passed = 0;\nlet failed = 0;\nconst failures: string[] = [];\n\nfunction check(name: string, ok: boolean, detail?: string) {\n if (ok) {\n console.log(` ✓ ${name}`);\n passed++;\n } else {\n console.log(` ✗ ${name}${detail ? ` — ${detail}` : \"\"}`);\n failed++;\n failures.push(name);\n }\n}\n\n// ── Tests ──────────────────────────────────────────────────────────────\n\nasync function testEnvironmentSingleton() {\n console.log(\"\\n── 1. Environment singleton ──\\n\");\n\n const env = getCelEnvironment();\n check(\"Environment created\", !!env);\n\n // Verify domain helpers registered\n const defs = env.getDefinitions();\n const fnNames = (defs.functions ?? []).map((f: any) => {\n const sig = f.signature ?? \"\";\n const match = sig.match(/^(?:\\w+\\.)?(\\w+)\\(/);\n return match?.[1] ?? f.name ?? \"\";\n });\n\n check(\"salient() registered\", fnNames.includes(\"salient\"));\n check(\"elided() registered\", fnNames.includes(\"elided\"));\n check(\"written_by() registered\", fnNames.includes(\"written_by\"));\n check(\"focus() registered\", fnNames.includes(\"focus\"));\n check(\"contested() registered\", fnNames.includes(\"contested\"));\n check(\"val() registered\", fnNames.includes(\"val\"));\n check(\"meta() registered\", fnNames.includes(\"meta\"));\n check(\"keys() receiver registered\", fnNames.includes(\"keys\"));\n check(\"entries() receiver registered\", fnNames.includes(\"entries\"));\n\n // Same instance on second call\n const env2 = getCelEnvironment();\n check(\"Singleton returns same instance\", env === env2);\n}\n\nasync function testCelEvalWithHelpers() {\n console.log(\"\\n── 2. celEval with domain helpers ──\\n\");\n\n const ctx = await buildContext(ROOM, { selfAgent: \"explorer\" });\n\n // Direct value access\n const phase = celEval('state._shared.phase.value', ctx);\n check(\"celEval: value access\", phase === \"executing\", `got ${phase}`);\n\n // Meta access\n const rev = celEval('state._shared.phase._meta.revision', ctx);\n check(\"celEval: meta access\", typeof rev === \"number\" || typeof rev === \"bigint\", `got ${typeof rev}`);\n\n // val() shorthand\n const valResult = celEval('val(state._shared.phase) == \"executing\"', ctx);\n check(\"celEval: val() shorthand\", valResult === true, `got ${valResult}`);\n\n // meta() shorthand\n const metaResult = celEval('meta(state._shared.phase, \"revision\")', ctx);\n check(\"celEval: meta() shorthand\", metaResult !== null && metaResult !== undefined, `got ${metaResult}`);\n\n // keys() receiver\n const keys = celEval('state._shared.keys()', ctx);\n check(\"celEval: keys() receiver\", Array.isArray(keys) && keys.length === 4, `got ${JSON.stringify(keys)}`);\n\n // entries() receiver\n const entries = celEval('state._shared.entries().size()', ctx);\n check(\"celEval: entries().size()\", Number(entries) === 4, `got ${entries}`);\n\n // salient() helper\n const sal = celEval('salient(state._shared, 0.0)', ctx);\n check(\"celEval: salient()\", Array.isArray(sal), `got ${typeof sal}`);\n\n // written_by() helper\n const wb = celEval('written_by(state._shared, \"explorer\")', ctx);\n check(\"celEval: written_by()\", Array.isArray(wb), `got ${typeof wb}`);\n\n // Complex chain: keys + filter + size\n const highScore = celEval(\n 'state._shared.keys().filter(k, state._shared[k]._meta.score > 0.0).size()',\n ctx,\n );\n check(\"celEval: keys().filter()._meta.score chain\", Number(highScore) > 0, `got ${highScore}`);\n\n // entries + filter + map\n const writers = celEval(\n 'state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.entry._meta.writer)',\n ctx,\n );\n check(\"celEval: entries().filter().map() chain\", Array.isArray(writers), `got ${typeof writers}`);\n}\n\nasync function testValidationPipeline() {\n console.log(\"\\n── 3. Validation pipeline ──\\n\");\n\n // Valid v9 expression\n const v1 = validateExpression('state._shared.phase.value == \"executing\"');\n check(\"valid v9 expr\", v1.valid && v1.stage === \"ok\");\n\n // Parse error: missing operand\n const v2 = validateExpression(\"state._shared.phase ==\");\n check(\"parse error detected\", !v2.valid && v2.stage === \"parse\");\n check(\"parse error has hint\", !!v2.hint);\n check(\"parse error has source pointer\", !!v2.source);\n\n // Parse error: empty\n const v3 = validateExpression(\"\");\n check(\"empty expr caught\", !v3.valid && v3.stage === \"parse\");\n\n // Valid domain helper\n const v4 = validateExpression(\"salient(state._shared, 0.5)\");\n check(\"domain helper validates\", v4.valid);\n\n // Old-style lint warning\n const v5 = validateExpression('state._shared.phase == \"executing\"');\n check(\"old-style expr gets lint warning\", v5.valid && (v5.warnings?.length ?? 0) > 0,\n `warnings: ${JSON.stringify(v5.warnings)}`);\n\n // Nested field without .value lint\n const v6 = validateExpression('state._shared[\"concepts.substrate\"].name == \"substrate\"');\n check(\"bare field access gets lint warning\", v6.valid && (v6.warnings?.length ?? 0) > 0,\n `warnings: ${JSON.stringify(v6.warnings)}`);\n\n // Correct expression: no warnings\n const v7 = validateExpression('state._shared.phase.value == \"executing\"');\n check(\"correct expr: no warnings\", v7.valid && (!v7.warnings || v7.warnings.length === 0));\n\n // Trial evaluation — valid\n const ctx = await buildContext(ROOM, { selfAgent: \"explorer\" });\n const v8 = validateExpression('state._shared.phase.value == \"executing\"', ctx);\n check(\"trial eval: valid\", v8.valid && v8.type === \"boolean\");\n\n // Trial evaluation — missing key\n const v9 = validateExpression(\"state._shared.nonexistent.value\", ctx);\n check(\"trial eval: missing key\", !v9.valid && v9.stage === \"eval\");\n check(\"missing key hint mentions key name\", v9.hint?.includes(\"nonexistent\") ?? false);\n\n // Trial evaluation — type mismatch\n const v10 = validateExpression(\"state._shared.phase.value * 2\", ctx);\n check(\"trial eval: type mismatch\", !v10.valid && v10.stage === \"eval\");\n check(\"type mismatch hint mentions .value\", v10.hint?.includes(\".value\") ?? false);\n}\n\nasync function testValidateCelLegacy() {\n console.log(\"\\n── 4. validateCel (legacy compat) ──\\n\");\n\n const r1 = validateCel('state._shared.phase.value == \"executing\"');\n check(\"validateCel: valid\", r1.valid);\n\n const r2 = validateCel(\"invalid + + syntax\");\n check(\"validateCel: invalid\", !r2.valid);\n check(\"validateCel: has error\", \"error\" in r2 && !!r2.error);\n check(\"validateCel: has hint\", \"hint\" in r2 && !!r2.hint);\n\n // Lint warnings pass through\n const r3 = validateCel('state._shared.phase == \"executing\"');\n check(\"validateCel: old-style passes with warnings\",\n r3.valid && (r3.warnings?.length ?? 0) > 0);\n}\n\nasync function testActionRegistrationValidation() {\n console.log(\"\\n── 5. Action registration validation ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true,\n kind: \"room\",\n agentId: \"explorer\",\n roomId: ROOM,\n grants: [\"*\"],\n };\n\n // Valid action with v9 expressions\n const r1 = await registerAction(ROOM, {\n id: \"test_valid_action\",\n description: \"Test action with v9 CEL\",\n if: 'state._shared.phase.value == \"executing\"',\n writes: [{ scope: \"_shared\", key: \"test_key\", value: \"test\" }],\n }, auth);\n const j1 = await r1.json();\n check(\"valid action registered\", r1.status === 201, `status ${r1.status}: ${JSON.stringify(j1)}`);\n\n // Action with parse error in if\n const r2 = await registerAction(ROOM, {\n id: \"test_bad_if\",\n if: \"state._shared.phase ==\",\n writes: [],\n }, auth);\n const j2 = await r2.json();\n check(\"bad if expression rejected\", r2.status === 400);\n check(\"error includes stage\", j2.stage === \"parse\");\n check(\"error includes hint\", !!j2.hint);\n\n // Action with old-style lint warnings\n const r3 = await registerAction(ROOM, {\n id: \"test_lint_action\",\n description: \"Action with old-style CEL\",\n if: 'state._shared.phase == \"executing\"',\n writes: [{ scope: \"_shared\", key: \"lint_test\", value: \"v\" }],\n }, auth);\n const j3 = await r3.json();\n check(\"old-style action registered (warnings, not errors)\", r3.status === 201);\n check(\"response includes cel_warnings\", Array.isArray(j3.cel_warnings),\n `cel_warnings: ${JSON.stringify(j3.cel_warnings)}`);\n}\n\nasync function testViewRegistrationValidation() {\n console.log(\"\\n── 6. View registration validation ──\\n\");\n\n const auth: AuthResult = {\n authenticated: true,\n kind: \"room\",\n agentId: \"explorer\",\n roomId: ROOM,\n grants: [\"*\"],\n };\n\n // Valid v9 view using domain helper\n const r1 = await registerView(ROOM, {\n id: \"test_salient_view\",\n expr: \"salient(state._shared, 0.0)\",\n description: \"Keys above zero salience\",\n scope: \"_shared\",\n }, auth);\n const j1 = await r1.json();\n check(\"domain helper view registered\", r1.status === 201, `status ${r1.status}`);\n check(\"view resolved value is a list\", Array.isArray(j1.value), `value: ${JSON.stringify(j1.value)}`);\n\n // View using keys() + filter\n const r2 = await registerView(ROOM, {\n id: \"test_keys_view\",\n expr: 'state._shared.keys().filter(k, k.startsWith(\"concepts\"))',\n description: \"Concept keys\",\n scope: \"_shared\",\n }, auth);\n const j2 = await r2.json();\n check(\"keys() view registered\", r2.status === 201);\n check(\"keys view resolved\", Array.isArray(j2.value) && j2.value.length === 2,\n `value: ${JSON.stringify(j2.value)}`);\n\n // View using val() shorthand\n const r3 = await registerView(ROOM, {\n id: \"test_val_view\",\n expr: 'val(state._shared.phase)',\n description: \"Phase value via shorthand\",\n scope: \"_shared\",\n }, auth);\n const j3 = await r3.json();\n check(\"val() view registered\", r3.status === 201);\n check(\"val() view resolved to 'executing'\", j3.value === \"executing\", `value: ${j3.value}`);\n\n // View with entries() chain\n const r4 = await registerView(ROOM, {\n id: \"test_entries_view\",\n expr: 'state._shared.entries().filter(e, e.entry._meta.writer != null).map(e, e.key)',\n description: \"Keys with known writers\",\n scope: \"_shared\",\n }, auth);\n const j4 = await r4.json();\n check(\"entries() view registered\", r4.status === 201, `status ${r4.status}`);\n check(\"entries view resolved to list\", Array.isArray(j4.value), `value: ${JSON.stringify(j4.value)}`);\n\n // View with bad expression\n const r5 = await registerView(ROOM, {\n id: \"test_bad_view\",\n expr: \"state._shared.phase ==\",\n scope: \"_shared\",\n }, auth);\n const j5 = await r5.json();\n check(\"bad view rejected\", r5.status === 400);\n check(\"bad view error has stage\", j5.stage === \"parse\");\n\n // View with lint warnings\n const r6 = await registerView(ROOM, {\n id: \"test_lint_view\",\n expr: 'state._shared.phase == \"executing\"',\n scope: \"_shared\",\n }, auth);\n const j6 = await r6.json();\n check(\"lint view registered with warnings\", r6.status === 201);\n check(\"lint view has warnings\", Array.isArray(j6.warnings) && j6.warnings.length > 0,\n `warnings: ${JSON.stringify(j6.warnings)}`);\n}\n\nasync function testErrorQuality() {\n console.log(\"\\n── 7. Error quality ──\\n\");\n\n const ctx = await buildContext(ROOM, { selfAgent: \"explorer\" });\n\n // Specific error for missing key\n const r1 = validateExpression(\"state._shared.nonexistent.value\", ctx);\n check(\"missing key: error names the key\", r1.error?.includes(\"nonexistent\") ?? false);\n check(\"missing key: hint suggests has()\", r1.hint?.includes(\"has()\") ?? false);\n\n // Specific error for type mismatch\n const r2 = validateExpression(\"state._shared.phase.value * 2\", ctx);\n check(\"type mismatch: error mentions overload\", r2.error?.includes(\"overload\") ?? false);\n check(\"type mismatch: hint mentions .value\", r2.hint?.includes(\".value\") ?? false);\n\n // Wrong meta path (no underscore)\n const r3 = validateExpression(\"state._shared.phase.meta.score\", ctx);\n check(\"wrong meta path: caught\", !r3.valid);\n check(\"wrong meta path: error names 'meta'\", r3.error?.includes(\"meta\") ?? false);\n\n // _meta on bare value (not on wrapped entry)\n const r4 = validateExpression(\"state._shared.phase.value._meta\", ctx);\n check(\"_meta on value: caught\", !r4.valid);\n\n // Triple equals (JavaScript habit)\n const r5 = validateExpression('state._shared.phase.value === \"executing\"');\n check(\"=== caught at parse\", !r5.valid && r5.stage === \"parse\");\n\n // Unbalanced parens\n const r6 = validateExpression(\"size(state._shared\");\n check(\"unbalanced parens: caught at parse\", !r6.valid && r6.stage === \"parse\");\n check(\"unbalanced parens: has source pointer\", !!r6.source);\n}\n\n// ── Run ────────────────────────────────────────────────────────────────\n\nasync function cleanup() {\n for (const sql of [\n `DELETE FROM state WHERE room_id = ?`,\n `DELETE FROM agents WHERE room_id = ?`,\n `DELETE FROM rooms WHERE id = ?`,\n `DELETE FROM log_index WHERE room_id = ?`,\n ]) {\n try { await sqlite.execute({ sql, args: [ROOM] }); } catch {}\n }\n}\n\ntry {\n await setup();\n await testEnvironmentSingleton();\n await testCelEvalWithHelpers();\n await testValidationPipeline();\n await testValidateCelLegacy();\n await testActionRegistrationValidation();\n await testViewRegistrationValidation();\n await testErrorQuality();\n await cleanup();\n\n console.log(`\\n════════════════════════════════════════`);\n console.log(`${passed} passed, ${failed} failed`);\n if (failures.length > 0) {\n console.log(`\\nFailed:`);\n for (const f of failures) console.log(` - ${f}`);\n }\n console.log(`════════════════════════════════════════`);\n\n if (failed > 0) console.error(`\\n❌ ${failed} checks failed`);\n else console.log(`\\n✅ All ${passed} checks passed`);\n} catch (e) {\n console.error(\"Test error:\", e);\n await cleanup().catch(() => {});\n throw e;\n}\n",[],[400,745],"89c29a08-2198-11f1-9238-42dde27851f2","test-v9-cel.ts","89c29ab2-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/test-v9-cel.ts — Verify CEL expressions work against wrapped shape.\n *\n * Tests that new-style expressions (.value, ._meta) evaluate correctly,\n * and that old-style expressions fail as expected.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { evaluate } from \"npm:@marcbachmann/cel-js\";\nimport { migrate } from \"../schema.ts\";\nimport { migrateV8 } from \"../schema-v8.ts\";\nimport { buildContext } from \"../cel.ts\";\nimport { contentHash } from \"../utils.ts\";\n\nconst ROOM_ID = \"_test_v9_cel_\" + Date.now();\n\nasync function setup() {\n await migrate();\n await migrateV8();\n\n const token = \"room_test_\" + Date.now();\n const tokenHash = await contentHash(token);\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO rooms (id, token_hash, created_at) VALUES (?, ?, datetime('now'))`,\n args: [ROOM_ID, tokenHash],\n });\n\n const entries = [\n { scope: \"_shared\", key: \"phase\", value: JSON.stringify(\"executing\") },\n { scope: \"_shared\", key: \"turn\", value: JSON.stringify(3) },\n {\n scope: \"_shared\",\n key: \"concepts.substrate\",\n value: JSON.stringify({ name: \"substrate\", definition: \"shared-state coordination\" }),\n },\n {\n scope: \"_shared\",\n key: \"concepts.stigmergy\",\n value: JSON.stringify({ name: \"stigmergy\", definition: \"indirect coordination\" }),\n },\n {\n scope: \"_shared\",\n key: \"concepts.emergence\",\n value: JSON.stringify({ name: \"emergence\", definition: \"complex behavior from simple rules\" }),\n },\n ];\n\n for (const e of entries) {\n const hash = await contentHash(e.value);\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, ?, ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, e.scope, e.key, e.value, hash],\n });\n }\n\n // Agent\n const agentVal = JSON.stringify({\n name: \"Explorer\", role: \"finder\", status: \"active\",\n last_heartbeat: new Date().toISOString(), last_seen_seq: 0,\n });\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', 'explorer', ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, agentVal, await contentHash(agentVal)],\n });\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO agents (id, room_id, name, role, status, token_hash, joined_at, last_heartbeat)\n VALUES ('explorer', ?, 'Explorer', 'finder', 'active', ?, datetime('now'), datetime('now'))`,\n args: [ROOM_ID, await contentHash(\"as_test_explorer\")],\n });\n\n // Audit entries for provenance\n const audit = [\n {\n ts: new Date(Date.now() - 60000).toISOString(),\n kind: \"invoke\", agent: \"explorer\", action: \"add_concept\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.substrate\" }] },\n },\n {\n ts: new Date(Date.now() - 30000).toISOString(),\n kind: \"invoke\", agent: \"explorer\", action: \"add_concept\", ok: true,\n params: {}, effect: { writes: [{ scope: \"_shared\", key: \"concepts.stigmergy\" }] },\n },\n ];\n for (let i = 0; i < audit.length; i++) {\n await sqlite.execute({\n sql: `INSERT INTO state (room_id, scope, key, sort_key, value, version, updated_at)\n VALUES (?, '_audit', ?, ?, ?, 1, datetime('now'))`,\n args: [ROOM_ID, String(i + 1), i + 1, JSON.stringify(audit[i])],\n });\n }\n}\n\nasync function test() {\n console.log(\"=== v9 CEL Expression Tests ===\\n\");\n\n const ctx = await buildContext(ROOM_ID, { selfAgent: \"explorer\" });\n const checks: Array<{ name: string; expr: string; expected: any; ok: boolean; actual: any }> = [];\n\n function check(name: string, expr: string, expected: any) {\n try {\n const result = evaluate(expr, ctx);\n const actual = typeof result === \"bigint\" ? Number(result) : result;\n const ok = JSON.stringify(actual) === JSON.stringify(expected);\n checks.push({ name, expr, expected, ok, actual });\n } catch (e: any) {\n checks.push({ name, expr, expected, ok: expected === \"ERROR\", actual: `ERROR: ${e.message}` });\n }\n }\n\n // ── Value access ──\n check(\n \"value access: phase\",\n 'state._shared.phase.value == \"executing\"',\n true,\n );\n check(\n \"value access: turn\",\n \"state._shared.turn.value > 2\",\n true,\n );\n check(\n \"value access: nested\",\n 'state._shared[\"concepts.substrate\"].value.name == \"substrate\"',\n true,\n );\n\n // ── Meta access ──\n check(\n \"meta: revision\",\n \"state._shared.phase._meta.revision == 1\",\n true,\n );\n check(\n \"meta: writer\",\n 'state._shared[\"concepts.substrate\"]._meta.writer == \"explorer\"',\n true,\n );\n check(\n \"meta: elided is false\",\n \"state._shared.phase._meta.elided == false\",\n true,\n );\n\n // ── Collection operations ──\n check(\n \"size of scope (counts keys)\",\n \"size(state._shared)\",\n 5,\n );\n\n // ── Filter by meta ──\n // Note: cel-js filter syntax: obj.filter(k, v, predicate)\n // Under wrapped model, v is { value, _meta }\n check(\n \"filter: entries with writer == explorer\",\n 'state._shared.filter(k, e, e._meta.writer == \"explorer\").size()',\n 2,\n );\n check(\n \"filter: entries with velocity > 0\",\n \"state._shared.filter(k, e, e._meta.velocity > 0).size()\",\n 2,\n );\n check(\n \"filter: entries with score > 0.05\",\n \"state._shared.filter(k, e, e._meta.score > 0.05).size() > 0\",\n true,\n );\n\n // ── Agent access ──\n check(\n \"agent value access\",\n 'agents.explorer.value.name == \"Explorer\"',\n true,\n );\n check(\n \"agent meta access\",\n \"agents.explorer._meta.revision == 1\",\n true,\n );\n\n // ── Old-style expressions SHOULD FAIL ──\n check(\n \"OLD STYLE: bare value comparison should fail\",\n 'state._shared.phase == \"executing\"',\n \"ERROR\",\n );\n\n // ── Substrate-native expressions (new capabilities) ──\n check(\n \"NEW: count entries without audit history\",\n \"state._shared.filter(k, e, e._meta.writer == null).size()\",\n 3, // phase, turn, concepts.emergence have no audit writes\n );\n check(\n \"NEW: map keys to their writers\",\n 'state._shared.filter(k, e, e._meta.writer != null).map(k, e, e._meta.writer)',\n // This returns a map/object of key→writer, let's check size instead\n \"ERROR\", // map returns an object, not easily comparable — let's skip this\n );\n\n // ── Print results ──\n let passed = 0;\n let failed = 0;\n for (const c of checks) {\n const icon = c.ok ? \"✓\" : \"✗\";\n console.log(` ${icon} ${c.name}`);\n console.log(` expr: ${c.expr}`);\n if (!c.ok) {\n console.log(` expected: ${JSON.stringify(c.expected)}`);\n console.log(` actual: ${JSON.stringify(c.actual)}`);\n }\n if (c.ok) passed++;\n else failed++;\n }\n console.log(`\\n${passed} passed, ${failed} failed out of ${checks.length}`);\n return { passed, failed };\n}\n\nasync function cleanup() {\n for (const sql of [\n `DELETE FROM state WHERE room_id = ?`,\n `DELETE FROM agents WHERE room_id = ?`,\n `DELETE FROM rooms WHERE id = ?`,\n `DELETE FROM log_index WHERE room_id = ?`,\n ]) {\n try { await sqlite.execute({ sql, args: [ROOM_ID] }); } catch {}\n }\n}\n\ntry {\n await setup();\n const result = await test();\n await cleanup();\n if (result.failed > 0) console.error(`\\n❌ ${result.failed} checks failed`);\n else console.log(`\\n✅ All ${result.passed} checks passed`);\n} catch (e) {\n console.error(\"Test error:\", e);\n await cleanup().catch(() => {});\n throw e;\n}\n",[],[400,752],"1b904cac-2075-11f1-8859-42dde27851f2","probe-ast.ts","1b904d56-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * scripts/probe-ast.ts — CEL AST shape discovery tool.\n *\n * Verified AST format (March 2026):\n * { op: \"id\", args: \"state\" } — identifier (args is STRING)\n * { op: \".\", args: [parent, \"field\"] } — member access\n * { op: \"[]\", args: [obj, index] } — bracket access\n * { op: \"value\", args: \"literal\" } — literal value\n * Pipe expressions (|) FAIL to parse — handled by regex fallback in deps.ts\n *\n * Keep as reference. Can be removed before merge.\n */\n\nimport { parse } from \"npm:@marcbachmann/cel-js\";\nimport { extractDependencies } from \"../deps.ts\";\n\nconst EXPRESSIONS = [\n // Direct key access — should yield AST deps\n `state._shared.phase`,\n `state._shared.theses.game_designer`,\n\n // Pipe expressions — should fall back to regex\n `state._shared | keys() | filter(k, k.startsWith(\"concepts.\")) | size()`,\n\n // View reference via bracket — should yield AST deps\n `views[\"concept_count\"] > 10`,\n\n // Comparison — should yield AST deps\n `state._shared.phase == \"active\"`,\n\n // Pipe with agents — regex fallback\n `agents | values() | filter(a, a.status == \"active\") | size()`,\n\n // Mixed: direct + pipe — AST for first part, regex catches pipe\n `state._shared.thesis_log | size() > 0 && state._shared.phase != \"setup\"`,\n\n // Bracket access — AST deps\n `state._shared[\"concepts.attention_restoration\"]`,\n\n // Messages — AST deps\n `messages.count > 0`,\n\n // Ternary — AST deps\n `state._shared.score > 100 ? \"high\" : \"low\"`,\n\n // Pipe with prefix — regex catches both scope and prefix\n `state._shared | keys() | filter(k, k.startsWith(\"tensions.\")) | size()`,\n];\n\nexport default async function handler(req: Request): Promise {\n const results: any[] = [];\n\n for (const expr of EXPRESSIONS) {\n const entry: any = { expr };\n try {\n const compiled = parse(expr);\n entry.parseable = true;\n entry.astTopOp = compiled.ast?.op;\n } catch (e: any) {\n entry.parseable = false;\n entry.parseError = e.message?.split(\"\\n\")[0];\n }\n // Always extract deps (should work for both parseable and unparseable)\n entry.deps = extractDependencies(expr);\n results.push(entry);\n }\n\n return new Response(JSON.stringify(results, (_, v) => typeof v === \"bigint\" ? Number(v) : v, 2), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n}\n",[],[400,759],"1b90303c-2075-11f1-8859-42dde27851f2","migrate-agent-tokens.ts","1b9030f0-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * scripts/migrate-agent-tokens.ts — Fold agent tokens into unified tokens table.\n *\n * For each agent with a token_hash, creates a corresponding tokens table entry.\n * Adds last_seen_seq to _agents scope entries.\n * Adds last_used_at column to tokens table.\n *\n * Idempotent: uses INSERT OR IGNORE (won't overwrite existing tokens).\n *\n * GET /scripts/migrate-agent-tokens → run the migration, return stats.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\n\nfunction rows2objects(result: { columns: string[]; rows: any[][] }) {\n return result.rows.map((row) =>\n Object.fromEntries(result.columns.map((col, i) => [col, row[i]]))\n );\n}\n\nexport default async function handler(req: Request): Promise {\n const stats = { agents: 0, tokens_created: 0, scope_updated: 0, errors: [] as string[] };\n\n // 1. Add last_used_at column to tokens table\n try {\n await sqlite.execute({ sql: `ALTER TABLE tokens ADD COLUMN last_used_at TEXT`, args: [] });\n } catch { /* already exists */ }\n\n // 2. Get all agents with token hashes\n const agentsResult = await sqlite.execute({\n sql: `SELECT id, room_id, token_hash, grants, last_seen_seq, last_heartbeat, name, role FROM agents WHERE token_hash IS NOT NULL`,\n args: [],\n });\n const agents = rows2objects(agentsResult);\n stats.agents = agents.length;\n\n for (const agent of agents) {\n const agentId = agent.id as string;\n const roomId = agent.room_id as string;\n const tokenHash = agent.token_hash as string;\n const lastSeenSeq = agent.last_seen_seq ?? 0;\n const lastHeartbeat = agent.last_heartbeat ?? null;\n\n // Parse grants\n let grants: string[] = [];\n try { grants = JSON.parse(agent.grants as string || \"[]\"); } catch {}\n\n // Build scope string from grants\n // as_ tokens are room-scoped with agent identity\n const scope = `rooms:${roomId}:agent:${agentId}:write`;\n\n // 3. Create tokens table entry (using same hex hash)\n try {\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO tokens (id, token_hash, minted_by, scope, room_id, agent_id, label, last_used_at, created_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`,\n args: [\n `legacy_${roomId}_${agentId}`, // deterministic ID\n tokenHash, // same hex SHA-256 hash\n \"legacy_migration\", // minted_by\n scope,\n roomId,\n agentId,\n `Agent ${agent.name ?? agentId}`,\n lastHeartbeat,\n ],\n });\n stats.tokens_created++;\n } catch (e: any) {\n // Likely UNIQUE constraint on token_hash — token already migrated\n if (!e.message?.includes(\"UNIQUE\")) {\n stats.errors.push(`token ${roomId}/${agentId}: ${e.message}`);\n }\n }\n\n // 4. Update _agents scope entry with last_seen_seq and token_id\n try {\n const scopeResult = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [roomId, agentId],\n });\n if (scopeResult.rows.length > 0) {\n const current = JSON.parse(scopeResult.rows[0][0] as string);\n current.last_seen_seq = lastSeenSeq;\n current.token_id = `legacy_${roomId}_${agentId}`;\n await sqlite.execute({\n sql: `UPDATE state SET value = ?, revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_agents' AND key = ?`,\n args: [JSON.stringify(current), roomId, agentId],\n });\n stats.scope_updated++;\n }\n } catch (e: any) {\n stats.errors.push(`scope ${roomId}/${agentId}: ${e.message}`);\n }\n }\n\n return new Response(JSON.stringify(stats, null, 2), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n}\n",[],[400,766],"89c276c2-2198-11f1-9238-42dde27851f2","explore-cel-maps.ts","89c27744-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/explore-cel-maps.ts — Explore cel-js capabilities on maps/objects.\n *\n * Tests what macros and operations work on map-typed data (our state scopes).\n * Goal: find what patterns work for filtering/querying wrapped entries.\n */\n\nimport { evaluate, parse, Environment } from \"npm:@marcbachmann/cel-js\";\n\n// Simulate a wrapped state scope\nconst wrappedScope = {\n phase: { value: \"executing\", _meta: { score: 0.85, writer: \"architect\", revision: 3, velocity: 0.1 } },\n turn: { value: 3, _meta: { score: 0.5, writer: \"system\", revision: 5, velocity: 0.0 } },\n \"concepts.substrate\": { value: { name: \"substrate\", def: \"shared state\" }, _meta: { score: 0.9, writer: \"explorer\", revision: 7, velocity: 0.4 } },\n \"concepts.stigmergy\": { value: { name: \"stigmergy\", def: \"indirect coord\" }, _meta: { score: 0.3, writer: \"synthesist\", revision: 2, velocity: 0.0 } },\n};\n\nconst ctx = {\n state: { _shared: wrappedScope },\n self: \"explorer\",\n};\n\nfunction tryExpr(label: string, expr: string, context?: any) {\n try {\n const result = evaluate(expr, context ?? ctx);\n const display = typeof result === \"bigint\" ? `${result}n` : JSON.stringify(result);\n console.log(` ✓ ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` result: ${display}`);\n return result;\n } catch (e: any) {\n console.log(` ✗ ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` error: ${e.message.split(\"\\n\")[0]}`);\n return undefined;\n }\n}\n\nconsole.log(\"=== 1. Basic map operations ===\\n\");\n\ntryExpr(\"size of map\", \"size(state._shared)\");\ntryExpr(\"key access\", 'state._shared.phase.value');\ntryExpr(\"bracket key access\", 'state._shared[\"concepts.substrate\"].value.name');\ntryExpr(\"has() on map key\", 'has(state._shared.phase)');\ntryExpr(\"has() on missing key\", 'has(state._shared.nonexistent)');\ntryExpr(\"in operator (key in map)\", '\"phase\" in state._shared');\ntryExpr(\"in operator (missing key)\", '\"missing\" in state._shared');\n\nconsole.log(\"\\n=== 2. Map macros (2-arg: iterates keys) ===\\n\");\n\ntryExpr(\"all keys exist pattern\", 'state._shared.all(k, k != \"\")');\ntryExpr(\"exists key matching\", 'state._shared.exists(k, k == \"phase\")');\ntryExpr(\"exists_one key\", 'state._shared.exists_one(k, k == \"phase\")');\n\nconsole.log(\"\\n=== 3. Map macros with value access ===\\n\");\n// In CEL, map macros iterate over KEYS. Can we access the value via the map?\n\ntryExpr(\n \"all: check score via map[key]\",\n 'state._shared.all(k, state._shared[k]._meta.score >= 0)',\n);\ntryExpr(\n \"exists: high score entry\",\n 'state._shared.exists(k, state._shared[k]._meta.score > 0.8)',\n);\ntryExpr(\n \"exists: writer check\",\n 'state._shared.exists(k, state._shared[k]._meta.writer == \"explorer\")',\n);\n\nconsole.log(\"\\n=== 4. List-based workarounds ===\\n\");\n\n// Convert map to list of entries first, then filter/map\n// In CEL: does keys() or entries() exist?\ntryExpr(\"map keys as list (not standard)\", 'state._shared.keys()');\n\n// Pipe syntax (might work at runtime but not parse for AST)\ntryExpr(\"pipe: keys\", 'state._shared | keys()');\n\nconsole.log(\"\\n=== 5. Filter/map attempts on maps ===\\n\");\n\ntryExpr(\"2-arg filter on map (key filter)\", 'state._shared.filter(k, k.startsWith(\"concepts\"))');\ntryExpr(\"3-arg filter on map (k, v, pred)\", 'state._shared.filter(k, v, v._meta.score > 0.5)');\ntryExpr(\"2-arg map on map\", 'state._shared.map(k, k)');\ntryExpr(\"3-arg map on map (filter+map)\", 'state._shared.map(k, k.startsWith(\"concepts\"), state._shared[k]._meta.writer)');\n\nconsole.log(\"\\n=== 6. List comprehension workaround ===\\n\");\n\n// If we inject a keys list alongside the map, we can filter on the list\nconst ctxWithKeys = {\n ...ctx,\n _keys: Object.keys(wrappedScope),\n};\n\ntryExpr(\n \"filter keys list by score\",\n '_keys.filter(k, state._shared[k]._meta.score > 0.5)',\n ctxWithKeys,\n);\ntryExpr(\n \"map keys to writers\",\n '_keys.map(k, state._shared[k]._meta.writer)',\n ctxWithKeys,\n);\ntryExpr(\n \"count high-score entries via keys list\",\n 'size(_keys.filter(k, state._shared[k]._meta.score > 0.5))',\n ctxWithKeys,\n);\ntryExpr(\n \"count entries by writer\",\n 'size(_keys.filter(k, state._shared[k]._meta.writer == \"explorer\"))',\n ctxWithKeys,\n);\n\nconsole.log(\"\\n=== 7. Environment API with custom functions ===\\n\");\n\nconst env = new Environment({ unlistedVariablesAreDyn: true });\n\n// Register helper functions that operate on the wrapped scope\nenv.registerFunction('count_where(map, string, string): int', (scope: any, field: string, value: string) => {\n let count = 0n;\n for (const key of Object.keys(scope)) {\n const entry = scope[key];\n if (entry?._meta?.[field] === value) count++;\n }\n return count;\n});\n\nenv.registerFunction('high_score_keys(map, double): list', (scope: any, threshold: number) => {\n const keys: string[] = [];\n for (const key of Object.keys(scope)) {\n const entry = scope[key];\n if (entry?._meta?.score > threshold) keys.push(key);\n }\n return keys;\n});\n\nenv.registerFunction('scope_keys(map): list', (scope: any) => {\n return Object.keys(scope);\n});\n\ntry {\n const r1 = env.evaluate('count_where(state._shared, \"writer\", \"explorer\")', ctx);\n console.log(` ✓ count_where: ${r1}`);\n} catch (e: any) {\n console.log(` ✗ count_where: ${e.message.split(\"\\n\")[0]}`);\n}\n\ntry {\n const r2 = env.evaluate('high_score_keys(state._shared, 0.5)', ctx);\n console.log(` ✓ high_score_keys(>0.5): ${JSON.stringify(r2)}`);\n} catch (e: any) {\n console.log(` ✗ high_score_keys: ${e.message.split(\"\\n\")[0]}`);\n}\n\ntry {\n const r3 = env.evaluate('scope_keys(state._shared)', ctx);\n console.log(` ✓ scope_keys: ${JSON.stringify(r3)}`);\n} catch (e: any) {\n console.log(` ✗ scope_keys: ${e.message.split(\"\\n\")[0]}`);\n}\n\n// Can we chain: get keys, then filter with list macros?\ntry {\n const r4 = env.evaluate(\n 'scope_keys(state._shared).filter(k, state._shared[k]._meta.score > 0.5)',\n ctx,\n );\n console.log(` ✓ scope_keys + list filter: ${JSON.stringify(r4)}`);\n} catch (e: any) {\n console.log(` ✗ scope_keys + list filter: ${e.message.split(\"\\n\")[0]}`);\n}\n\ntry {\n const r5 = env.evaluate(\n 'scope_keys(state._shared).filter(k, state._shared[k]._meta.writer == \"explorer\").size()',\n ctx,\n );\n console.log(` ✓ scope_keys + filter by writer + size: ${r5}`);\n} catch (e: any) {\n console.log(` ✗ scope_keys + filter by writer + size: ${e.message.split(\"\\n\")[0]}`);\n}\n\nconsole.log(\"\\n=== 8. Practical v9 expressions (best patterns found) ===\\n\");\n\n// Using whichever patterns work from above, show practical expressions\ntry {\n // \"Enable synthesis only when concepts have stabilized\"\n const r = env.evaluate(\n '!scope_keys(state._shared).exists(k, k.startsWith(\"concepts\") && state._shared[k]._meta.velocity > 0.3)',\n ctx,\n );\n console.log(` ✓ \"concepts stabilized\" gate: ${r}`);\n} catch (e: any) {\n console.log(` ✗ \"concepts stabilized\" gate: ${e.message.split(\"\\n\")[0]}`);\n}\n\ntry {\n // \"How many things has explorer written?\"\n const r = env.evaluate(\n 'scope_keys(state._shared).filter(k, state._shared[k]._meta.writer == \"explorer\").size()',\n ctx,\n );\n console.log(` ✓ \"explorer write count\": ${r}`);\n} catch (e: any) {\n console.log(` ✗ \"explorer write count\": ${e.message.split(\"\\n\")[0]}`);\n}\n\ntry {\n // \"Get all high-salience keys I haven't written\"\n const r = env.evaluate(\n 'scope_keys(state._shared).filter(k, state._shared[k]._meta.score > 0.5 && state._shared[k]._meta.writer != self)',\n ctx,\n );\n console.log(` ✓ \"high-salience keys not written by me\": ${JSON.stringify(r)}`);\n} catch (e: any) {\n console.log(` ✗ \"high-salience keys not written by me\": ${e.message.split(\"\\n\")[0]}`);\n}\n\nconsole.log(\"\\nDone.\");\n",[],[400,773],"89c21ea2-2198-11f1-9238-42dde27851f2","explore-cel-errors.ts","89c21f24-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/explore-cel-errors.ts — Explore error reporting, parse/compile feedback,\n * and type-checking in cel-js Environment API.\n *\n * Goal: Understand what quality of error messages we can give room designers\n * when their CEL expressions are malformed, reference missing keys, have type\n * mismatches, or use the wrapped shape incorrectly.\n */\n\nimport { evaluate, parse, Environment, ParseError, EvaluationError } from \"npm:@marcbachmann/cel-js\";\n\n// ── Test wrapped context ────────────────────────────────────────────────\n\nconst wrappedScope = {\n phase: {\n value: \"executing\",\n _meta: { score: 0.85, writer: \"architect\", revision: 3, velocity: 0.1, elided: false },\n },\n turn: {\n value: 3,\n _meta: { score: 0.5, writer: \"system\", revision: 5, velocity: 0.0, elided: false },\n },\n \"concepts.substrate\": {\n value: { name: \"substrate\", definition: \"shared-state coordination\" },\n _meta: { score: 0.9, writer: \"explorer\", revision: 7, velocity: 0.4, elided: false },\n },\n};\n\nconst ctx = {\n state: { _shared: wrappedScope },\n actions: {},\n agents: {},\n views: {},\n messages: { count: 0, unread: 0, directed_unread: 0 },\n self: \"explorer\",\n params: {},\n};\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 1: Parse errors — what feedback does parse() give?\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"═══ 1. PARSE ERRORS ═══\\n\");\n\nfunction tryParse(label: string, expr: string) {\n try {\n const compiled = parse(expr);\n console.log(` ✓ parsed: ${label}`);\n return compiled;\n } catch (e: any) {\n const isParseError = e instanceof ParseError;\n console.log(` ✗ ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` type: ${isParseError ? \"ParseError\" : e.constructor?.name ?? typeof e}`);\n console.log(` message: ${e.message}`);\n if (e.line !== undefined) console.log(` line: ${e.line}, col: ${e.column}`);\n if (e.source !== undefined) console.log(` source: ${e.source}`);\n return null;\n }\n}\n\ntryParse(\"valid expression\", 'state._shared.phase.value == \"executing\"');\ntryParse(\"syntax error: missing operand\", \"state._shared.phase ==\");\ntryParse(\"syntax error: unbalanced parens\", \"size(state._shared\");\ntryParse(\"syntax error: invalid token\", \"state._shared.phase === 'test'\");\ntryParse(\"syntax error: pipe (unsupported)\", \"state._shared | keys()\");\ntryParse(\"syntax error: empty\", \"\");\ntryParse(\"syntax error: just a dot\", \".\");\ntryParse(\"syntax error: double operator\", \"1 ++ 2\");\ntryParse(\"syntax error: bad string\", '\"unterminated');\ntryParse(\"misspelled macro\", \"state._shared.filtr(k, k == 1)\");\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 2: Evaluation errors — what happens at runtime?\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 2. EVALUATION ERRORS ═══\\n\");\n\nfunction tryEval(label: string, expr: string, context?: any) {\n try {\n const result = evaluate(expr, context ?? ctx);\n const display = typeof result === \"bigint\" ? `${result}n` : JSON.stringify(result);\n console.log(` ✓ ${label} → ${display}`);\n return result;\n } catch (e: any) {\n const isEvalError = e instanceof EvaluationError;\n console.log(` ✗ ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` type: ${isEvalError ? \"EvaluationError\" : e.constructor?.name ?? typeof e}`);\n // Show full message (includes source pointer)\n const lines = e.message.split(\"\\n\");\n for (const line of lines) {\n console.log(` ${line}`);\n }\n return undefined;\n }\n}\n\nconsole.log(\"--- Missing keys ---\\n\");\ntryEval(\"missing scope\", \"state._missing.phase.value\");\ntryEval(\"missing key in scope\", \"state._shared.nonexistent.value\");\ntryEval(\"missing _meta field\", \"state._shared.phase._meta.nonexistent_field\");\ntryEval(\"missing nested value field\", 'state._shared.phase.value.nonexistent');\n\nconsole.log(\"\\n--- Type mismatches ---\\n\");\ntryEval(\"string + int\", 'state._shared.phase.value + 1');\ntryEval(\"comparing number to string\", 'state._shared.turn.value == \"three\"');\ntryEval(\"arithmetic on string\", 'state._shared.phase.value * 2');\ntryEval(\"calling size on non-collection\", 'size(state._shared.phase.value)');\ntryEval(\"calling size on number\", 'size(state._shared.turn.value)');\ntryEval(\"boolean logic on string\", 'state._shared.phase.value && true');\n\nconsole.log(\"\\n--- Common v9 mistakes ---\\n\");\ntryEval(\"OLD STYLE: forgot .value (string compare)\", 'state._shared.phase == \"executing\"');\ntryEval(\"OLD STYLE: forgot .value (numeric)\", 'state._shared.turn > 2');\ntryEval(\"OLD STYLE: forgot .value (nested)\", 'state._shared[\"concepts.substrate\"].name');\ntryEval(\"wrong meta path (no underscore)\", 'state._shared.phase.meta.score');\ntryEval(\"_meta on bare value\", 'state._shared.phase.value._meta');\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 3: Environment type-checking (env.check())\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 3. ENVIRONMENT TYPE-CHECKING ═══\\n\");\n\n// Build a typed environment that knows about the wrapped shape\nconst env = new Environment({\n unlistedVariablesAreDyn: true, // for now — explore strict mode later\n});\n\n// Register receiver methods\nenv.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\nenv.registerFunction({\n name: \"entries\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.entries(m).map(([k, v]) => ({ key: k, entry: v })),\n params: [],\n});\n\n// Domain helpers\nenv.registerFunction(\"salient(map, double): list\", (scope: any, threshold: number) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.score > threshold)\n);\nenv.registerFunction(\"elided(map): list\", (scope: any) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.elided === true)\n);\nenv.registerFunction(\"written_by(map, string): list\", (scope: any, agent: string) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.writer === agent)\n);\n\nfunction tryCheck(label: string, expr: string) {\n try {\n const result = env.check(expr);\n if (result.valid) {\n console.log(` ✓ valid: ${label} → type: ${result.type}`);\n } else {\n console.log(` ✗ invalid: ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` error: ${result.error?.message ?? \"unknown\"}`);\n }\n return result;\n } catch (e: any) {\n console.log(` ✗ check threw: ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` error: ${e.message.split(\"\\n\")[0]}`);\n return null;\n }\n}\n\nconsole.log(\"--- Basic type checks ---\\n\");\ntryCheck(\"int literal\", \"1 + 2\");\ntryCheck(\"string literal\", '\"hello\"');\ntryCheck(\"bool literal\", \"true && false\");\ntryCheck(\"comparison\", \"1 > 2\");\n\nconsole.log(\"\\n--- With unlistedVariablesAreDyn: true ---\\n\");\ntryCheck(\"dyn variable access\", \"state._shared.phase.value\");\ntryCheck(\"dyn comparison\", 'state._shared.phase.value == \"executing\"');\ntryCheck(\"dyn _meta access\", \"state._shared.phase._meta.score > 0.5\");\ntryCheck(\"function call\", \"salient(state._shared, 0.5)\");\ntryCheck(\"chained\", 'salient(state._shared, 0.5).filter(k, k.startsWith(\"concepts\"))');\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 4: Strict typed environment\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 4. STRICT TYPED ENVIRONMENT ═══\\n\");\n\nconst strictEnv = new Environment({\n unlistedVariablesAreDyn: false,\n homogeneousAggregateLiterals: false,\n});\n\n// Register the state shape with proper typing\n// The challenge: state is deeply nested with dynamic keys\n// Let's see how far we can get with registerVariable + schema\n\ntry {\n strictEnv.registerVariable(\"self\", \"string\");\n strictEnv.registerVariable(\"params\", \"map\");\n strictEnv.registerVariable(\"messages\", {\n type: \"map\",\n description: \"Message counts\",\n });\n\n // state is a nested map — hard to type fully since keys are dynamic\n strictEnv.registerVariable(\"state\", {\n type: \"map\",\n description: \"Room state — wrapped entries with { value, _meta }\",\n });\n strictEnv.registerVariable(\"views\", { type: \"map\" });\n strictEnv.registerVariable(\"agents\", { type: \"map\" });\n strictEnv.registerVariable(\"actions\", { type: \"map\" });\n\n console.log(\" ✓ Strict environment created with variables\\n\");\n} catch (e: any) {\n console.log(` ✗ Failed to create strict env: ${e.message}\\n`);\n}\n\nfunction tryStrictCheck(label: string, expr: string) {\n try {\n const result = strictEnv.check(expr);\n if (result.valid) {\n console.log(` ✓ valid: ${label} → type: ${result.type}`);\n } else {\n console.log(` ✗ invalid: ${label}`);\n console.log(` expr: ${expr}`);\n console.log(` error: ${result.error?.message}`);\n }\n } catch (e: any) {\n console.log(` ✗ check threw: ${label}`);\n console.log(` ${e.message.split(\"\\n\")[0]}`);\n }\n}\n\nfunction tryStrictEval(label: string, expr: string) {\n try {\n const result = strictEnv.evaluate(expr, ctx);\n const display = typeof result === \"bigint\" ? `${result}n` : JSON.stringify(result);\n console.log(` ✓ ${label} → ${display}`);\n } catch (e: any) {\n console.log(` ✗ ${label}`);\n const lines = e.message.split(\"\\n\");\n console.log(` ${lines[0]}`);\n }\n}\n\nconsole.log(\"--- Type checks in strict mode ---\\n\");\ntryStrictCheck(\"known variable\", \"self\");\ntryStrictCheck(\"unknown variable\", \"unknown_var\");\ntryStrictCheck(\"state access (map)\", \"state._shared\");\ntryStrictCheck(\"deep access (dyn from map)\", 'state._shared.phase.value == \"executing\"');\ntryStrictCheck(\"self comparison\", 'self == \"explorer\"');\ntryStrictCheck(\"params access\", \"params.name\");\n\nconsole.log(\"\\n--- Evaluation in strict mode ---\\n\");\ntryStrictEval(\"value access\", 'state._shared.phase.value');\ntryStrictEval(\"meta access\", 'state._shared.phase._meta.score');\ntryStrictEval(\"comparison\", 'state._shared.phase.value == \"executing\"');\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 5: Custom validation — wrapping parse + check + eval\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 5. CUSTOM VALIDATION PIPELINE ═══\\n\");\n\ninterface ValidationResult {\n valid: boolean;\n stage: \"parse\" | \"typecheck\" | \"evaluate\" | \"ok\";\n error?: string;\n hint?: string;\n type?: string;\n}\n\nfunction validateExpression(expr: string, context?: any): ValidationResult {\n // Stage 1: Parse\n try {\n parse(expr);\n } catch (e: any) {\n return {\n valid: false,\n stage: \"parse\",\n error: e.message,\n hint: \"Check syntax: balanced parentheses, valid operators, proper string quotes.\",\n };\n }\n\n // Stage 2: Type check (if using Environment)\n try {\n const checkResult = env.check(expr);\n if (!checkResult.valid) {\n return {\n valid: false,\n stage: \"typecheck\",\n error: checkResult.error?.message ?? \"Type check failed\",\n hint: \"Check that variable types match operators used.\",\n };\n }\n } catch (e: any) {\n // check() itself threw — treat as soft warning, not hard failure\n // (dyn types can cause this)\n }\n\n // Stage 3: Trial evaluation\n try {\n const result = env.evaluate(expr, context ?? ctx);\n const type = result === null ? \"null\"\n : typeof result === \"bigint\" ? \"int\"\n : Array.isArray(result) ? \"list\"\n : typeof result;\n return { valid: true, stage: \"ok\", type };\n } catch (e: any) {\n const msg = e.message || String(e);\n\n // Detect common v9 mistakes and provide specific hints\n let hint: string | undefined;\n\n if (msg.includes(\"No such key: value\") || msg.includes(\"no such key\")) {\n hint = \"Key not found. If accessing a wrapped entry, use .value for the data and ._meta for metadata.\";\n }\n\n // Detect old-style access pattern (comparing wrapped entry to primitive)\n if (!msg.includes(\"No such key\")) {\n // Try to detect: result was an object compared to a primitive\n // This is subtle — the expression evaluates but gives wrong result\n }\n\n return {\n valid: false,\n stage: \"evaluate\",\n error: msg.split(\"\\n\")[0],\n hint: hint ?? \"Expression parsed but failed at runtime. Check that referenced keys exist in the current room state.\",\n };\n }\n}\n\nconsole.log(\"--- Validation pipeline ---\\n\");\n\nconst cases = [\n { label: \"valid v9 expression\", expr: 'state._shared.phase.value == \"executing\"' },\n { label: \"valid meta access\", expr: \"state._shared.phase._meta.score > 0.5\" },\n { label: \"valid domain helper\", expr: \"salient(state._shared, 0.5)\" },\n { label: \"syntax error\", expr: \"state._shared.phase ==\" },\n { label: \"missing key\", expr: \"state._shared.nonexistent.value\" },\n { label: \"old-style (no .value)\", expr: 'state._shared.phase == \"executing\"' },\n { label: \"wrong meta path\", expr: \"state._shared.phase.meta.score\" },\n { label: \"type mismatch\", expr: 'state._shared.phase.value * 2' },\n { label: \"empty expression\", expr: \"\" },\n { label: \"valid filter chain\", expr: 'state._shared.keys().filter(k, state._shared[k]._meta.score > 0.5)' },\n];\n\nfor (const c of cases) {\n const result = validateExpression(c.expr);\n const icon = result.valid ? \"✓\" : \"✗\";\n console.log(` ${icon} ${c.label}`);\n console.log(` expr: ${c.expr}`);\n if (result.valid) {\n console.log(` → type: ${result.type}`);\n } else {\n console.log(` stage: ${result.stage}`);\n console.log(` error: ${result.error?.split(\"\\n\")[0]}`);\n if (result.hint) console.log(` hint: ${result.hint}`);\n }\n console.log();\n}\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 6: Detecting old-style expressions\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"═══ 6. OLD-STYLE EXPRESSION DETECTION ═══\\n\");\n\n/**\n * Detect common patterns where someone wrote a v8-style expression\n * that would silently produce wrong results under v9 wrapped shape.\n *\n * These DON'T throw — they evaluate to a wrong value. So we need\n * static analysis of the expression to catch them.\n */\nfunction detectOldStyle(expr: string): string[] {\n const warnings: string[] = [];\n\n // Pattern: state.scope.key == \"literal\" (without .value)\n // This compares { value, _meta } to \"literal\" → always false\n const bareCompare = /state\\.\\w+\\.\\w+\\s*(==|!=|>=|<=|>|<)\\s*(\".*?\"|'.*?'|\\d+|true|false)/g;\n let m;\n while ((m = bareCompare.exec(expr))) {\n const path = m[0].split(/\\s*(==|!=|>=|<=|>|<)\\s*/)[0].trim();\n // Check it's not already accessing .value or ._meta\n if (!path.endsWith(\".value\") && !path.includes(\"._meta\")) {\n // Count dots to see if it's scope.key level (not scope.key.value.field)\n const parts = path.split(\".\");\n if (parts.length === 3) { // state.scope.key\n warnings.push(\n `\"${path}\" compares a wrapped entry (not its value). Did you mean \"${path}.value ${m[1]} ${m[2]}\"?`\n );\n }\n }\n }\n\n // Pattern: state.scope.key.field (accessing nested field without .value)\n // e.g., state._shared[\"concepts.substrate\"].name instead of .value.name\n const directNested = /state\\.\\w+(?:\\[\"[^\"]+\"\\]|\\.\\w+)\\.([a-z]\\w+)/g;\n while ((m = directNested.exec(expr))) {\n const field = m[1];\n if (field !== \"value\" && field !== \"_meta\" && !field.startsWith(\"_\")) {\n // This might be accessing a field directly on the wrapped entry\n // (which would fail or return undefined, not the intended value field)\n warnings.push(\n `\".${field}\" accesses the wrapped entry directly. If this is a value field, use \".value.${field}\" instead.`\n );\n }\n }\n\n return warnings;\n}\n\nconst oldStyleCases = [\n 'state._shared.phase == \"executing\"',\n 'state._shared.turn > 2',\n 'state._shared.phase.value == \"executing\"', // correct — should NOT warn\n 'state._shared[\"concepts.substrate\"].name == \"substrate\"',\n 'state._shared[\"concepts.substrate\"].value.name == \"substrate\"', // correct\n 'state._shared.phase._meta.score > 0.5', // correct — should NOT warn\n];\n\nfor (const expr of oldStyleCases) {\n const warnings = detectOldStyle(expr);\n if (warnings.length === 0) {\n console.log(` ✓ ${expr}`);\n } else {\n console.log(` ⚠ ${expr}`);\n for (const w of warnings) {\n console.log(` → ${w}`);\n }\n }\n}\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 7: Environment.getDefinitions() — can we expose to agents?\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 7. ENVIRONMENT DEFINITIONS (for agent docs) ═══\\n\");\n\ntry {\n const defs = env.getDefinitions();\n console.log(\" Registered definitions:\");\n if (defs.functions) {\n for (const f of defs.functions) {\n const sig = f.signature ?? `${f.name}(${(f.params ?? []).map((p: any) => p.type ?? 'dyn').join(', ')}): ${f.returnType ?? 'dyn'}`;\n console.log(` fn ${sig}${f.description ? ` — ${f.description}` : ''}`);\n }\n }\n if (defs.variables) {\n for (const v of defs.variables) {\n console.log(` var ${v.name}: ${v.type}${v.description ? ` — ${v.description}` : ''}`);\n }\n }\n} catch (e: any) {\n console.log(` getDefinitions() error: ${e.message}`);\n // Try alternative approaches\n try {\n const defs = (env as any).getDefinitions?.() ?? \"method not found\";\n console.log(` raw: ${JSON.stringify(defs).slice(0, 500)}`);\n } catch {}\n}\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 8: Parse + AST inspection\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 8. AST INSPECTION ═══\\n\");\n\nfunction inspectAst(label: string, expr: string) {\n try {\n const compiled = parse(expr);\n console.log(` ${label}:`);\n console.log(` expr: ${expr}`);\n if (compiled.ast) {\n console.log(` ast: ${JSON.stringify(compiled.ast).slice(0, 200)}`);\n }\n // What properties does the compiled function have?\n const props = Object.keys(compiled).filter(k => k !== \"ast\");\n if (props.length > 0) {\n console.log(` props: ${props.join(\", \")}`);\n }\n // Does it have a check method?\n if (typeof compiled.check === \"function\") {\n const checkResult = compiled.check();\n console.log(` check(): ${JSON.stringify(checkResult)}`);\n }\n } catch (e: any) {\n console.log(` ✗ ${label}: ${e.message.split(\"\\n\")[0]}`);\n }\n}\n\ninspectAst(\"simple comparison\", 'state._shared.phase.value == \"executing\"');\ninspectAst(\"meta access\", 'state._shared.phase._meta.score');\ninspectAst(\"function call\", 'size(state._shared)');\ninspectAst(\"filter macro\", 'state._shared.filter(k, k.startsWith(\"concepts\"))');\n\n// ═══════════════════════════════════════════════════════════════════════\n// SECTION 9: Environment with enableOptionalTypes\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ 9. OPTIONAL CHAINING ═══\\n\");\n\nconst optEnv = new Environment({\n unlistedVariablesAreDyn: true,\n enableOptionalTypes: true,\n});\n\n// Register helpers\noptEnv.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\n\nfunction tryOpt(label: string, expr: string) {\n try {\n const result = optEnv.evaluate(expr, ctx);\n const display = typeof result === \"bigint\" ? `${result}n` : JSON.stringify(result);\n console.log(` ✓ ${label} → ${display}`);\n } catch (e: any) {\n console.log(` ✗ ${label}`);\n console.log(` ${e.message.split(\"\\n\")[0]}`);\n }\n}\n\n// Optional chaining: .?key returns optional(value) or optional.none()\ntryOpt(\"optional access on existing key\", 'state._shared.?phase');\ntryOpt(\"optional access on missing key\", 'state._shared.?nonexistent');\ntryOpt(\"optional deep access\", 'state._shared.?phase.?value');\ntryOpt(\"optional _meta\", 'state._shared.?phase.?_meta.?score');\ntryOpt(\"optional with comparison\", 'state._shared.?phase.?value == \"executing\"');\ntryOpt(\"optional on missing with default\", 'state._shared.?nonexistent.orValue(\"default\")');\ntryOpt(\"has + optional combo\", 'has(state._shared.nonexistent) ? state._shared.nonexistent.value : \"missing\"');\n\nconsole.log(\"\\nDone.\");\n",[],[400,780],"89c1d762-2198-11f1-9238-42dde27851f2","explore-cel-ergonomics.ts","89c1d7f8-2198-11f1-9238-42dde27851f2",["D",1773707445460],"/**\n * scripts/explore-cel-ergonomics.ts — Explore Environment API for wrapped state ergonomics.\n *\n * Goal: Find the best patterns for making CEL expressions over { value, _meta }\n * entries feel natural. Test custom functions, receiver methods, and macros.\n */\n\nimport { evaluate, parse, Environment } from \"npm:@marcbachmann/cel-js\";\n\n// ── Test data ──────────────────────────────────────────────────────────\n\nconst wrappedScope = {\n phase: {\n value: \"executing\",\n _meta: { score: 0.85, writer: \"architect\", revision: 3, velocity: 0.1, elided: false, writers: [\"architect\"] },\n },\n turn: {\n value: 3,\n _meta: { score: 0.5, writer: \"system\", revision: 5, velocity: 0.0, elided: false, writers: [\"system\"] },\n },\n \"concepts.substrate\": {\n value: { name: \"substrate\", definition: \"shared-state coordination layer\" },\n _meta: { score: 0.9, writer: \"explorer\", revision: 7, velocity: 0.4, elided: false, writers: [\"explorer\", \"synthesist\"] },\n },\n \"concepts.stigmergy\": {\n value: { name: \"stigmergy\", definition: \"indirect coordination\" },\n _meta: { score: 0.3, writer: \"synthesist\", revision: 2, velocity: 0.0, elided: false, writers: [\"synthesist\"] },\n },\n \"concepts.emergence\": {\n value: null, // elided\n _meta: { score: 0.04, writer: \"explorer\", revision: 1, velocity: 0.0, elided: true, writers: [\"explorer\"] },\n },\n};\n\nconst wrappedActions = {\n add_concept: {\n value: { enabled: true, available: true, description: \"Add a concept\" },\n _meta: { score: 0.6, invocations: 14, last_invoked_by: \"explorer\", contested: [\"refine_concept\"], elided: false },\n },\n refine_concept: {\n value: { enabled: true, available: true, description: \"Refine a concept\" },\n _meta: { score: 0.4, invocations: 3, last_invoked_by: \"synthesist\", contested: [\"add_concept\"], elided: false },\n },\n synthesize: {\n value: { enabled: false, available: false, description: \"Generate synthesis\" },\n _meta: { score: 0.2, invocations: 0, last_invoked_by: null, contested: [], elided: false },\n },\n};\n\nconst ctx = {\n state: { _shared: wrappedScope },\n actions: wrappedActions,\n self: \"explorer\",\n};\n\n// ── Helpers ─────────────────────────────────────────────────────────────\n\nlet passCount = 0;\nlet failCount = 0;\n\nfunction tryExpr(env: Environment, label: string, expr: string, context?: any) {\n try {\n const result = env.evaluate(expr, context ?? ctx);\n const display = typeof result === \"bigint\" ? `${result}n` : JSON.stringify(result);\n console.log(` ✓ ${label}`);\n console.log(` ${expr}`);\n console.log(` → ${display}`);\n passCount++;\n return result;\n } catch (e: any) {\n console.log(` ✗ ${label}`);\n console.log(` ${expr}`);\n console.log(` ERROR: ${e.message.split(\"\\n\")[0]}`);\n failCount++;\n return undefined;\n }\n}\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 1: Utility functions (scope → list conversions)\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"═══ APPROACH 1: Utility functions ═══\\n\");\n\nconst env1 = new Environment({ unlistedVariablesAreDyn: true });\n\n// keys(map) → list of key strings\nenv1.registerFunction(\"keys(map): list\", (m: any) => Object.keys(m));\n\n// values(map) → list of wrapped entries\nenv1.registerFunction(\"values(map): list\", (m: any) => Object.values(m));\n\n// entries(map) → list of [key, entry] pairs\nenv1.registerFunction(\"entries(map): list\", (m: any) =>\n Object.entries(m).map(([k, v]) => ({ key: k, entry: v }))\n);\n\nconsole.log(\"--- keys / values / entries ---\\n\");\n\ntryExpr(env1, \"keys(scope)\", \"keys(state._shared)\");\ntryExpr(env1, \"keys + filter by meta\", \n 'keys(state._shared).filter(k, state._shared[k]._meta.score > 0.5)');\ntryExpr(env1, \"keys + count by writer\",\n 'size(keys(state._shared).filter(k, state._shared[k]._meta.writer == \"explorer\"))');\ntryExpr(env1, \"values: count non-elided\",\n \"values(state._shared).filter(e, !e._meta.elided).size()\");\ntryExpr(env1, \"entries: map to key+score pairs\",\n \"entries(state._shared).map(e, e.key + \\\": \\\" + string(e.entry._meta.score))\");\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 2: Receiver methods on maps (called as map.method())\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ APPROACH 2: Receiver methods ═══\\n\");\n\nconst env2 = new Environment({ unlistedVariablesAreDyn: true });\n\n// map.keys() as a receiver method\nenv2.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\n\n// map.values() as a receiver method\nenv2.registerFunction({\n name: \"values\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.values(m),\n params: [],\n});\n\n// map.entries() as a receiver method → list of {key, entry}\nenv2.registerFunction({\n name: \"entries\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.entries(m).map(([k, v]) => ({ key: k, entry: v })),\n params: [],\n});\n\nconsole.log(\"--- scope.keys() / scope.values() / scope.entries() ---\\n\");\n\ntryExpr(env2, \"scope.keys()\", \"state._shared.keys()\");\ntryExpr(env2, \"scope.values()\", \"state._shared.values().size()\");\ntryExpr(env2, \"scope.entries()\", \"state._shared.entries().size()\");\ntryExpr(env2, \"keys + filter chain\",\n 'state._shared.keys().filter(k, state._shared[k]._meta.score > 0.5)');\ntryExpr(env2, \"entries + filter on entry\",\n \"state._shared.entries().filter(e, e.entry._meta.score > 0.5).size()\");\ntryExpr(env2, \"entries + map to writers\",\n \"state._shared.entries().filter(e, !e.entry._meta.elided).map(e, e.entry._meta.writer)\");\ntryExpr(env2, \"entries: high-score elided keys\",\n \"state._shared.entries().filter(e, e.entry._meta.elided && e.entry._meta.score > 0.01).map(e, e.key)\");\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 3: Domain-specific helpers\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ APPROACH 3: Domain helpers ═══\\n\");\n\nconst env3 = new Environment({ unlistedVariablesAreDyn: true });\n\n// Reuse receiver methods\nenv3.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\nenv3.registerFunction({\n name: \"values\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.values(m),\n params: [],\n});\nenv3.registerFunction({\n name: \"entries\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.entries(m).map(([k, v]) => ({ key: k, entry: v })),\n params: [],\n});\n\n// written_by(scope, agent) → list of keys written by agent\nenv3.registerFunction(\"written_by(map, string): list\", (scope: any, agent: string) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.writer === agent)\n);\n\n// salient(scope, threshold) → list of keys above threshold\nenv3.registerFunction(\"salient(map, double): list\", (scope: any, threshold: number) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.score > threshold)\n);\n\n// elided(scope) → list of elided keys\nenv3.registerFunction(\"elided(map): list\", (scope: any) =>\n Object.keys(scope).filter(k => scope[k]?._meta?.elided === true)\n);\n\n// active(scope) → list of non-elided keys\nenv3.registerFunction(\"active(map): list\", (scope: any) =>\n Object.keys(scope).filter(k => !scope[k]?._meta?.elided)\n);\n\n// velocity_above(scope, threshold) → keys with velocity above threshold\nenv3.registerFunction(\"velocity_above(map, double): list\", (scope: any, threshold: number) =>\n Object.keys(scope).filter(k => (scope[k]?._meta?.velocity ?? 0) > threshold)\n);\n\n// contested(actions_map) → list of action IDs that have contested targets\nenv3.registerFunction(\"contested(map): list\", (actions: any) =>\n Object.keys(actions).filter(k => {\n const c = actions[k]?._meta?.contested;\n return Array.isArray(c) && c.length > 0;\n })\n);\n\n// stale(actions_map, count_threshold) → actions with < N invocations\nenv3.registerFunction(\"stale(map, int): list\", (actions: any, threshold: bigint) =>\n Object.keys(actions).filter(k => (actions[k]?._meta?.invocations ?? 0) < Number(threshold))\n);\n\nconsole.log(\"--- Domain helpers ---\\n\");\n\ntryExpr(env3, \"written_by(scope, agent)\",\n 'written_by(state._shared, \"explorer\")');\ntryExpr(env3, \"salient(scope, threshold)\",\n \"salient(state._shared, 0.5)\");\ntryExpr(env3, \"elided(scope)\",\n \"elided(state._shared)\");\ntryExpr(env3, \"active(scope) count\",\n \"size(active(state._shared))\");\ntryExpr(env3, \"velocity_above for stability gate\",\n 'size(velocity_above(state._shared, 0.3)) == 0');\ntryExpr(env3, \"contested actions\",\n \"contested(actions)\");\ntryExpr(env3, \"stale actions (< 5 invocations)\",\n \"stale(actions, 5)\");\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 4: Combining approaches — practical expressions\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ APPROACH 4: Practical v9 expressions ═══\\n\");\n\n// Use env3 which has all helpers\n\nconsole.log(\"--- Action predicates (if / enabled gates) ---\\n\");\n\ntryExpr(env3, \"gate: only when concepts stabilized\",\n 'size(velocity_above(state._shared, 0.3)) == 0');\n\ntryExpr(env3, \"gate: only if I haven't written the target\",\n 'state._shared[\"concepts.substrate\"]._meta.writer != self');\n\ntryExpr(env3, \"gate: only if target was recently updated\",\n 'state._shared[\"concepts.substrate\"]._meta.velocity > 0.1');\n\ntryExpr(env3, \"gate: at least 3 non-elided concepts exist\",\n 'active(state._shared).filter(k, k.startsWith(\"concepts\")).size() >= 3');\n\ntryExpr(env3, \"gate: action not invoked more than 20 times\",\n \"actions.add_concept._meta.invocations < 20\");\n\ntryExpr(env3, \"gate: only invoke if contested\",\n \"size(actions.add_concept._meta.contested) > 0\");\n\nconsole.log(\"\\n--- View expressions ---\\n\");\n\ntryExpr(env3, \"view: count of active concepts\",\n 'active(state._shared).filter(k, k.startsWith(\"concepts\")).size()');\n\ntryExpr(env3, \"view: high-salience keys I should look at\",\n \"salient(state._shared, 0.5)\");\n\ntryExpr(env3, \"view: what am I not seeing?\",\n \"elided(state._shared)\");\n\ntryExpr(env3, \"view: who is most active writer?\",\n \"state._shared.entries().filter(e, !e.entry._meta.elided).map(e, e.entry._meta.writer)\");\n\ntryExpr(env3, \"view: velocity report as key list\",\n \"state._shared.entries().filter(e, e.entry._meta.velocity > 0).map(e, e.key)\");\n\nconsole.log(\"\\n--- Self-aware / meta-reasoning ---\\n\");\n\ntryExpr(env3, \"am I seeing less than half?\",\n \"size(elided(state._shared)) > size(active(state._shared))\");\n\ntryExpr(env3, \"how many of my writes are high-salience?\",\n 'written_by(state._shared, self).filter(k, state._shared[k]._meta.score > 0.5).size()');\n\ntryExpr(env3, \"are there contested actions I registered?\",\n 'contested(actions).exists(a, actions[a]._meta.last_invoked_by == self)');\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 5: Custom macros (parse-time transforms)\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ APPROACH 5: Custom macros ═══\\n\");\n\nconst env5 = new Environment({ unlistedVariablesAreDyn: true });\n\n// Reuse receiver methods\nenv5.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\nenv5.registerFunction({\n name: \"entries\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.entries(m).map(([k, v]) => ({ key: k, entry: v })),\n params: [],\n});\n\n// Try registering a macro that transforms at parse time\n// The idea: scope.where(field, op, value) → filtered key list\ntry {\n env5.registerFunction('where(ast): dyn', ({ast, args}: any) => {\n return {\n typeCheck(checker: any, macro: any, ctx: any) {\n return { type: 'list' };\n },\n evaluate(evaluator: any, macro: any, ctx: any) {\n // This runs at evaluation time\n const scope = evaluator.eval(args[0], ctx);\n if (!scope || typeof scope !== 'object') return [];\n return Object.keys(scope);\n }\n };\n });\n console.log(\" ✓ Macro registered (where)\");\n} catch (e: any) {\n console.log(` ✗ Macro registration failed: ${e.message.split(\"\\n\")[0]}`);\n}\n\n// Try a simpler macro: `val(entry)` → entry.value (shorthand for .value)\ntry {\n env5.registerFunction('val(dyn): dyn', (entry: any) => {\n if (entry && typeof entry === 'object' && 'value' in entry) return entry.value;\n return entry;\n });\n console.log(\" ✓ val() function registered\");\n \n tryExpr(env5, \"val(entry) shorthand\",\n 'val(state._shared.phase) == \"executing\"');\n tryExpr(env5, \"val() on nested\",\n 'val(state._shared[\"concepts.substrate\"]).name == \"substrate\"');\n} catch (e: any) {\n console.log(` ✗ val() registration failed: ${e.message.split(\"\\n\")[0]}`);\n}\n\n// meta(entry, field) → entry._meta[field]\ntry {\n env5.registerFunction('meta(dyn, string): dyn', (entry: any, field: string) => {\n if (entry && typeof entry === 'object' && '_meta' in entry) return entry._meta[field];\n return null;\n });\n console.log(\" ✓ meta() function registered\");\n \n tryExpr(env5, \"meta(entry, field) shorthand\",\n 'meta(state._shared.phase, \"writer\") == \"architect\"');\n tryExpr(env5, \"meta for score\",\n 'meta(state._shared[\"concepts.substrate\"], \"score\") > 0.5');\n} catch (e: any) {\n console.log(` ✗ meta() registration failed: ${e.message.split(\"\\n\")[0]}`);\n}\n\n// ═══════════════════════════════════════════════════════════════════════\n// APPROACH 6: Score-aware sorting helper\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══ APPROACH 6: Score-aware helpers ═══\\n\");\n\nconst env6 = new Environment({ unlistedVariablesAreDyn: true });\n\nenv6.registerFunction({\n name: \"keys\",\n receiverType: \"map\",\n returnType: \"list\",\n handler: (m: any) => Object.keys(m),\n params: [],\n});\n\n// top_n(scope, n) → top N keys by score\nenv6.registerFunction(\"top_n(map, int): list\", (scope: any, n: bigint) => {\n const entries = Object.entries(scope)\n .map(([k, v]: [string, any]) => ({ key: k, score: v?._meta?.score ?? 0 }))\n .sort((a, b) => b.score - a.score)\n .slice(0, Number(n));\n return entries.map(e => e.key);\n});\n\n// focus(scope) → keys in focus tier (high score, non-elided)\nenv6.registerFunction(\"focus(map): list\", (scope: any) =>\n Object.entries(scope)\n .filter(([_, v]: [string, any]) => !v?._meta?.elided && (v?._meta?.score ?? 0) > 0.5)\n .map(([k]) => k)\n);\n\n// peripheral(scope) → keys in peripheral tier (medium score, non-elided)\nenv6.registerFunction(\"peripheral(map): list\", (scope: any) =>\n Object.entries(scope)\n .filter(([_, v]: [string, any]) => {\n const s = v?._meta?.score ?? 0;\n return !v?._meta?.elided && s > 0.1 && s <= 0.5;\n })\n .map(([k]) => k)\n);\n\ntryExpr(env6, \"top_n(scope, 3)\",\n \"top_n(state._shared, 3)\");\ntryExpr(env6, \"focus(scope) — high tier keys\",\n \"focus(state._shared)\");\ntryExpr(env6, \"peripheral(scope) — medium tier keys\",\n \"peripheral(state._shared)\");\ntryExpr(env6, \"gate: only proceed if focus set has concepts\",\n 'focus(state._shared).exists(k, k.startsWith(\"concepts\"))');\n\n// ═══════════════════════════════════════════════════════════════════════\n// Summary\n// ═══════════════════════════════════════════════════════════════════════\n\nconsole.log(\"\\n═══════════════════════════════════════════════\");\nconsole.log(`Total: ${passCount} passed, ${failCount} failed`);\nconsole.log(\"═══════════════════════════════════════════════\\n\");\n\nconsole.log(\"RECOMMENDED PATTERN:\");\nconsole.log(\" Combine receiver methods (.keys(), .entries()) with domain helpers\");\nconsole.log(\" (written_by, salient, elided, focus) and direct ._meta access.\\n\");\nconsole.log(\" Receiver: state._shared.entries().filter(e, e.entry._meta.score > 0.5)\");\nconsole.log(\" Helper: salient(state._shared, 0.5)\");\nconsole.log(\" Direct: state._shared.phase._meta.writer == self\");\nconsole.log(\" Shorthand: val(state._shared.phase) == \\\"executing\\\"\");\n",[],[400,787],"1b9007c4-2075-11f1-8859-42dde27851f2","backfill-scopes.ts","1b900882-2075-11f1-8859-42dde27851f2",["D",1773582277011],"/**\n * scripts/backfill-scopes.ts — One-time migration: populate v8 scopes from legacy tables.\n *\n * For every room, copies:\n * - actions table → state._actions.{id} (full action definition as JSON)\n * - views table → state._views.{id} (full view definition as JSON, with deps extracted)\n * - agents table → state._agents.{id} (presence data)\n *\n * Idempotent: uses INSERT OR IGNORE (won't overwrite data from dual-write).\n * Run once to bring all existing rooms up to v8 scope conventions.\n *\n * GET /scripts/backfill-scopes → run the migration, return stats.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { extractDependencies } from \"../deps.ts\";\n\nfunction rows2objects(result: { columns: string[]; rows: any[][] }) {\n return result.rows.map((row) =>\n Object.fromEntries(result.columns.map((col, i) => [col, row[i]]))\n );\n}\n\nexport default async function handler(req: Request): Promise {\n const stats = { rooms: 0, actions: 0, views: 0, agents: 0, skipped: 0, errors: [] as string[] };\n\n // Get all rooms\n const roomsResult = await sqlite.execute({ sql: `SELECT id FROM rooms`, args: [] });\n const rooms = roomsResult.rows.map(r => r[0] as string);\n stats.rooms = rooms.length;\n\n for (const roomId of rooms) {\n // ── Backfill _actions ──\n try {\n const actionsResult = await sqlite.execute({\n sql: `SELECT * FROM actions WHERE room_id = ?`,\n args: [roomId],\n });\n const actions = rows2objects(actionsResult);\n\n for (const action of actions) {\n try {\n let writes: any[] = [];\n try { writes = JSON.parse(action.writes_json || \"[]\"); } catch {}\n let params: any = null;\n try { params = action.params_json ? JSON.parse(action.params_json) : null; } catch {}\n let timer: any = null;\n try { timer = action.timer_json ? JSON.parse(action.timer_json) : null; } catch {}\n let onInvoke: any = null;\n try { onInvoke = action.on_invoke_timer_json ? { timer: JSON.parse(action.on_invoke_timer_json) } : null; } catch {}\n\n const value = JSON.stringify({\n description: action.description ?? null,\n if: action.if_expr ?? null,\n enabled: action.enabled_expr ?? null,\n result: action.result_expr ?? null,\n writes,\n params,\n scope: action.scope ?? \"_shared\",\n registered_by: action.registered_by ?? null,\n timer,\n on_invoke: onInvoke,\n });\n\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_actions', ?, ?, '', 1, datetime('now'))`,\n args: [roomId, action.id, value],\n });\n stats.actions++;\n } catch (e: any) {\n stats.errors.push(`action ${roomId}/${action.id}: ${e.message}`);\n }\n }\n } catch (e: any) {\n stats.errors.push(`actions for ${roomId}: ${e.message}`);\n }\n\n // ── Backfill _views ──\n try {\n const viewsResult = await sqlite.execute({\n sql: `SELECT * FROM views WHERE room_id = ?`,\n args: [roomId],\n });\n const views = rows2objects(viewsResult);\n\n for (const view of views) {\n try {\n let render: any = null;\n try { render = view.render_json ? JSON.parse(view.render_json) : null; } catch {}\n let timer: any = null;\n try { timer = view.timer_json ? JSON.parse(view.timer_json) : null; } catch {}\n\n // Extract deps\n let deps: any[] = [];\n try { deps = extractDependencies(view.expr); } catch {}\n\n const value = JSON.stringify({\n expr: view.expr,\n description: view.description ?? null,\n enabled: view.enabled_expr ?? null,\n render,\n scope: view.scope ?? \"_shared\",\n registered_by: view.registered_by ?? null,\n timer,\n deps,\n });\n\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_views', ?, ?, '', 1, datetime('now'))`,\n args: [roomId, view.id, value],\n });\n stats.views++;\n } catch (e: any) {\n stats.errors.push(`view ${roomId}/${view.id}: ${e.message}`);\n }\n }\n } catch (e: any) {\n stats.errors.push(`views for ${roomId}: ${e.message}`);\n }\n\n // ── Backfill _agents ──\n try {\n const agentsResult = await sqlite.execute({\n sql: `SELECT * FROM agents WHERE room_id = ?`,\n args: [roomId],\n });\n const agents = rows2objects(agentsResult);\n\n for (const agent of agents) {\n try {\n let grants: any[] = [];\n try { grants = agent.grants ? JSON.parse(agent.grants) : []; } catch {}\n\n const value = JSON.stringify({\n name: agent.name,\n role: agent.role ?? \"agent\",\n status: agent.status ?? \"active\",\n grants,\n last_heartbeat: agent.last_heartbeat ?? null,\n joined_at: agent.joined_at ?? null,\n });\n\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO state (room_id, scope, key, value, version, revision, updated_at)\n VALUES (?, '_agents', ?, ?, '', 1, datetime('now'))`,\n args: [roomId, agent.id, value],\n });\n stats.agents++;\n } catch (e: any) {\n stats.errors.push(`agent ${roomId}/${agent.id}: ${e.message}`);\n }\n }\n } catch (e: any) {\n stats.errors.push(`agents for ${roomId}: ${e.message}`);\n }\n }\n\n return new Response(JSON.stringify(stats, null, 2), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n}\n",[],[400,794],["D",1773411506886],[550,551,552,553,554,555,556,557,558,559,560],[400],"e6c4e16a-1708-11f1-95df-42dde27851f2","views.md","e6c4e1f6-1708-11f1-95df-42dde27851f2",["D",1772546242374],"# Views Reference\n\nViews are CEL expressions that project state into named values visible to all agents.\nThey are the read half of the v6 contract — symmetric with actions as the write half.\n\n---\n\n## Registration\n\n```\nPOST /rooms/:id/actions/_register_view/invoke\nAuthorization: Bearer as_agent...\n{ \"params\": {\n \"id\": \"results\",\n \"expr\": \"state[\\\"_shared\\\"].keys().filter(k, k.endsWith(\\\".result\\\"))\",\n \"description\": \"All submitted results\",\n \"scope\": \"_shared\"\n}}\n```\n\nOr directly:\n\n```\nPOST /rooms/:id/views\n{ \"id\": \"results\", \"expr\": \"...\", \"scope\": \"_shared\" }\n```\n\n**Fields:**\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| `id` | ✓ | Unique within the room |\n| `expr` | ✓ | CEL expression evaluated server-side |\n| `scope` | | Registrar scope — grants read access to that scope's state (default: `_shared`) |\n| `description` | | Human-readable label |\n| `enabled` | | CEL visibility predicate — view omitted from context when false |\n| `render` | | Render hint — makes this view a surface (see below) |\n| `timer` | | Expiry/appearance timer (same format as action timers) |\n\n**Response includes the current resolved value:**\n\n```json\n{\n \"id\": \"results\",\n \"expr\": \"...\",\n \"scope\": \"_shared\",\n \"value\": [\"alice.result\", \"bob.result\"],\n \"version\": 2,\n \"created_at\": \"2026-03-03T12:00:00Z\"\n}\n```\n\n---\n\n## Scope authority\n\nA view's `scope` determines which private state it can read during evaluation.\n\n```json\n{\n \"id\": \"alice.health\",\n \"scope\": \"alice\",\n \"expr\": \"state[\\\"alice\\\"][\\\"health\\\"]\"\n}\n```\n\nThis view is registered with `scope: \"alice\"`. Only an agent with identity `alice`\n(or room-token authority) may register it. At evaluation time, the system augments\nthe CEL context with `alice`'s private scope, so `state[\"alice\"][\"health\"]` resolves.\nThe result is visible to everyone. The raw scope is not.\n\n**The pattern:** private state → view → public projection. No other read-sharing mechanism needed.\n\n---\n\n## CEL context in view expressions\n\nViews see the full room context:\n\n```\nstate._shared.* shared state\nstate[\"agent-id\"].* registrar's private scope (if scope != \"_shared\")\nviews.* all other resolved views (evaluated before this one)\nagents.* agent presence\nmessages.count / .unread / .directed_unread\nself evaluating agent's ID (may be empty for system evaluation)\n```\n\n**View order:** Views are evaluated in registration order. A view can reference the\nresolved value of a previously registered view via `views[\"earlier-view\"]`.\n\n---\n\n## Enabled expressions\n\n```json\n{\n \"id\": \"final-score\",\n \"expr\": \"state[\\\"_shared\\\"][\\\"score\\\"]\",\n \"enabled\": \"state[\\\"_shared\\\"][\\\"phase\\\"] == \\\"complete\\\"\"\n}\n```\n\nWhen `enabled` is false, the view is omitted from context entirely — it does not\nappear in `views.*` and its value is not computed. Useful for phase-gated surfaces.\n\nEnabled expressions are evaluated server-side with the full CEL context.\nNo client-side CEL evaluator required.\n\n---\n\n## Render hints — views as surfaces\n\nA view with a `render` object becomes a **surface** — a UI element rendered by the dashboard.\n\n```json\n{\n \"id\": \"score-display\",\n \"expr\": \"state[\\\"_shared\\\"][\\\"score\\\"]\",\n \"render\": { \"type\": \"metric\", \"label\": \"Score\", \"unit\": \"pts\" },\n \"enabled\": \"state[\\\"_shared\\\"][\\\"phase\\\"] == \\\"active\\\"\"\n}\n```\n\nThe dashboard queries `GET /rooms/:id/views` and renders all views with `render` defined,\nin registration order. No `_dashboard` config blob required. No separate surface registration.\n\n**The dashboard is a view query.** Register views with render hints. They appear automatically.\n\n---\n\n## Surface types\n\n### `metric`\n\nSingle scalar value.\n\n```json\n{ \"type\": \"metric\", \"label\": \"Score\", \"unit\": \"pts\", \"format\": \"number\" }\n```\n\n`format`: `\"number\"` (default), `\"percent\"`, `\"duration\"`, `\"currency\"`.\n\n---\n\n### `markdown`\n\nMarkdown string rendered as HTML.\n\n```json\n{ \"type\": \"markdown\", \"label\": \"Status\" }\n```\n\nView expr should return a string. Supports GFM.\n\n---\n\n### `feed`\n\nOrdered list of message-like objects.\n\n```json\n{ \"type\": \"feed\", \"label\": \"Activity\", \"limit\": 20 }\n```\n\nView expr should return an array of objects. Items rendered as feed entries.\nObjects with `from`, `kind`, `body` fields render naturally.\n\n---\n\n### `view-table`\n\nTabular data from an array of objects.\n\n```json\n{ \"type\": \"view-table\", \"label\": \"Results\", \"columns\": [\"agent\", \"answer\", \"score\"] }\n```\n\nView expr returns an array of objects. `columns` specifies which keys to show and in what order.\n\n---\n\n### `view-grid`\n\nGrid of key-value pairs from an object.\n\n```json\n{ \"type\": \"view-grid\", \"label\": \"Scores\" }\n```\n\nView expr returns an object. Keys and values displayed as a grid.\n\n---\n\n### `action-bar`\n\nRow of invokable action buttons.\n\n```json\n{ \"type\": \"action-bar\", \"label\": \"Controls\", \"actions\": [\"start\", \"pause\", \"reset\"] }\n```\n\n`actions`: list of action IDs to display. Available actions shown as enabled buttons,\nunavailable ones shown as disabled. Params-free actions invoke immediately on click.\n\n---\n\n### `action-form`\n\nForm for invoking a parameterised action.\n\n```json\n{ \"type\": \"action-form\", \"label\": \"Submit Answer\", \"action\": \"submit_answer\" }\n```\n\n`action`: the action ID. Form fields generated from the action's `params` schema.\n`enum` params render as dropdowns. Boolean params as checkboxes. Others as text inputs.\n\n---\n\n### `action-choice`\n\nEnum selection that invokes an action with the selected value.\n\n```json\n{ \"type\": \"action-choice\", \"label\": \"Vote\", \"action\": \"vote\", \"param\": \"choice\" }\n```\n\n`action`: action ID. `param`: the enum param to set. Renders the enum values as\nselectable options. Current selection highlighted if state reflects it.\n\n---\n\n### `watch`\n\nLive CEL expression result shown as raw JSON with auto-refresh.\n\n```json\n{ \"type\": \"watch\", \"label\": \"Debug: Phase\" }\n```\n\nUseful for diagnostics and development. Shows the raw resolved value, updated on poll.\n\n---\n\n### `section`\n\nContainer that groups other surfaces.\n\n```json\n{ \"type\": \"section\", \"label\": \"Round Results\", \"views\": [\"score-display\", \"results-table\"] }\n```\n\n`views`: ordered list of view IDs to nest inside this section. Sections do not have\ntheir own `expr` — the view expr is ignored if `render.type` is `\"section\"`.\n\n---\n\n## Synthetic system views\n\nThe runtime injects synthetic views under reserved IDs. These appear in the `views`\nsection of context with `system: true`. They cannot be registered or deleted manually.\n\n### `_contested`\n\nPresent when two or more actions write to the same `(scope, key)` target.\n\n```json\n\"_contested\": {\n \"value\": {\n \"_shared:answer\": [\"alice_submit\", \"bob_submit\"]\n },\n \"description\": \"Write targets contested by 2+ actions.\",\n \"system\": true\n}\n```\n\nClears automatically when the overlap resolves (action deleted or writes retargeted).\nUse as a wait condition: `views[\"_contested\"].size() > 0`.\n\n---\n\n## View timers\n\nViews support the same timer syntax as actions and state entries.\n\n```json\n{\n \"id\": \"halftime-banner\",\n \"expr\": \"\\\"Half time — scores frozen\\\"\",\n \"render\": { \"type\": \"markdown\", \"label\": \"Announcement\" },\n \"timer\": { \"ms\": 30000, \"effect\": \"delete\" }\n}\n```\n\n`effect: \"delete\"` — view exists now, disappears after 30 seconds.\n`effect: \"enable\"` — view appears after the timer fires (countdown before reveal).\n\n---\n\n## The three ways to create views\n\n**1. At agent join:**\n\n```json\nPOST /rooms/:id/agents\n{ \"views\": [{ \"id\": \"alice-status\", \"expr\": \"state[\\\"alice\\\"][\\\"status\\\"]\", \"scope\": \"alice\" }] }\n```\n\n**2. Auto-view from state write:**\n\n```json\nPOST /rooms/:id/actions/_set_state/invoke\n{ \"params\": { \"key\": \"health\", \"value\": 85, \"public\": true } }\n```\n\nCreates `alice.health` view automatically, scoped to the writing agent.\n\n**3. Via `_register_view` action (or directly):**\n\nFull control over expression, scope, enabled condition, and render hint.\n\n---\n\n## Deleting views\n\n```\nPOST /rooms/:id/actions/_delete_view/invoke\n{ \"params\": { \"id\": \"my-view\" } }\n```\n\nOr directly:\n\n```\nDELETE /rooms/:id/views/:id\n```\n\nViews scoped to an agent can only be deleted by that agent or a room-token holder.\n\n---\n\n## Competition detection on views\n\nTwo views rendering to the same conceptual slot create tension surfaced through the normal\naction conflict mechanism if they happen to write to the same state. Views themselves\ndon't write, so direct view-on-view conflict is not currently detected. If two views\nproduce incompatible projections of the same data, that is a vocabulary negotiation —\nuse directed messages to resolve it.\n",[],[406,804],"1b8f24d0-2075-11f1-8859-42dde27851f2","v8.md","1b8f258e-2075-11f1-8859-42dde27851f2",["D",1773582277011],"# sync v8 — Two Primitives\n\n> *The room is the world model. Actions are the transition function.*\n> *Views are the observation function. The audit log is the trajectory.*\n> *What's missing? The reward signal.*\n> *That's adaptive salience.*\n>\n> — kernel.ts, closing comment\n\n---\n\n## Status\n\n**Phase 1: Unification** — ✅ Complete, verified live\n- `log_index` table with backfill from existing audit entries\n- CEL dependency extraction (hybrid AST walking + regex for pipe expressions)\n- Dual-write to `_actions`, `_views`, `_agents` scopes alongside legacy tables\n- Temporal query endpoints: `/history/:scope/:key`, prefix queries\n- Structural event indexing (register/delete actions, views, agents)\n- Observable vocabulary: `state._actions.add_concept.description` evaluable as CEL\n\n**Phase 2: Log-Based Temporal** — ✅ Complete, verified live\n- View value sampling piggybacked on dashboardPoll (60s interval)\n- `kind: \"sample\"` audit entries indexed under `_samples` scope\n- `/samples/:viewId` endpoint for temporal sparkline data\n- marked.js (v15) + mermaid.js (v11.4) loaded in dashboard shell\n- MarkdownSurface renders markdown + detects mermaid code blocks\n\n**Phase 3: Adaptive Salience** — ✅ Complete, verified live\n- Six structural signals: recency, dependency, authorship, directed, contest, delta\n- Per-room configurable weights via `_config.salience_weights`\n- `_salience` system view injected in agent context with transparent scoring\n- `/salience` endpoint for full map with per-key signal breakdown\n- Salience is observable — agents can inspect their own relevance map\n\n**Phase 4: Clean Break** — ✅ Complete, verified live\n- Dashboard poll reads state table only (single SQL query via `poll-v8.ts`)\n- Surfaces.tsx decoupled from PollData — uses minimal inline interfaces\n- Dashboard.tsx and Replay.tsx build SurfaceContext directly from v8 data\n- `v8ToLegacyPoll()` adapter created, used, and deleted\n- `dashboardPoll()` deleted (old 6-query legacy poll)\n- `PollData` type deleted — frontend consumes `PollDataV8` exclusively\n\n**Phase 5: Legacy Table Removal** — ✅ Complete, verified live\n- `views` table: DROPPED — all CRUD via `_views` scope only\n- `actions` table: DROPPED — timer cooldown state in `_timer` field of `_actions` scope value\n- `agents` table: DROPPED — tokens migrated to unified `tokens` table (82 agents), `last_seen_seq` in `_agents` scope, heartbeat via `tokens.last_used_at` + scope\n- `timers.ts`: removed references to dropped tables\n- `replay.ts`: already v8-clean (reconstructs from `_audit` scope, no legacy reads)\n- Schema: `DROP TABLE IF EXISTS views/actions/agents` in migration chain\n\n## Two Primitives\n\nA sync room is exactly two things:\n\n**State** — a finite partial function from located keys to versioned values. The current projection of all truth.\n\n**Log** — an append-only sequence of events. The complete causal history.\n\nEverything else is convention and interpretation.\n\n```\nstate(room_id, scope, key) → { value, revision, hash, updated_at }\nlog(room_id, seq) → { kind, ts, agent, payload }\n```\n\n### Reserved Scopes as Entity Types\n\n| Scope Prefix | Interpretation | Replaces |\n|---|---|---|\n| `_shared` | Shared substrate | (unchanged) |\n| `_actions` | Write affordances | `actions` table |\n| `_views` | Read lenses | `views` table |\n| `_agents` | Participant presence | `agents` table |\n| `_messages` | Communication log | (unchanged) |\n| `_audit` | Event history | (unchanged) |\n| `_help` | Guidance namespace | (unchanged) |\n| `_config` | Room configuration | `_shared._dashboard` |\n| `{agent-id}` | Agent-private scope | (unchanged) |\n\n### The Log Index\n\nThe audit trail (now: log) is optimised for sequential replay. The log_index table makes it queryable by affected key:\n\n```sql\nCREATE TABLE log_index (\n room_id TEXT NOT NULL,\n seq INTEGER NOT NULL,\n scope TEXT NOT NULL,\n key TEXT NOT NULL\n);\nCREATE INDEX idx_li_key ON log_index(room_id, scope, key);\nCREATE INDEX idx_li_seq ON log_index(room_id, seq);\n```\n\nThis replaces proposed `state_history` and `view_journal` tables. The log IS the history.\n\n---\n\n## Migration — Complete\n\nAll legacy entity tables (`actions`, `views`, `agents`) have been dropped. The database now contains:\n\n| Table | Purpose |\n|---|---|\n| `rooms` | Room identity + admin/view token hashes |\n| `state` | The substrate — all domain data via scope conventions |\n| `tokens` | Unified credential store (room, agent, MCP, device auth tokens) |\n| `log_index` | Temporal query index over audit entries |\n| `smcp_*` | MCP auth infrastructure (users, credentials, sessions, etc.) |\n| `device_codes` | OAuth Device Authorization flow |\n\n### Tables Remaining\n\nThe `state` table is the single source of truth for all domain data. The `tokens` table handles all authentication. Everything else is MCP auth plumbing.\n\n---\n\n## Architecture\n\n### Two Primitives\n\nState and Log. One is the current projection, the other is causal history. Everything else — actions, views, agents, messages — is convention interpreted by scope prefix.\n",[],[406,811],"e6c7fd78-1708-11f1-95df-42dde27851f2","v6.md","23ee866a-16f8-11f1-ab1e-42dde27851f2",["D",1772546242374],"# sync v6 — Architecture & Design\n\n> This document is the authoritative statement of sync v6's architecture.\n> It is written for agents reading cold: not just how to use the system,\n> but why it works the way it does. Implementation is checked against this.\n\n---\n\n## The thesis\n\nEvery multi-agent system reduces to two operations: **read context** and **invoke actions**.\n\nThis is not an observation — it is a constraint, imposed deliberately. The constraint is\nprescriptive. Its value comes from what it prevents as much as what it enables.\n\nThe analogy is functional programming: constraining mutation doesn't just tidy up code,\nit produces referential transparency — a specific, nameable property that makes systems\nlocally reasonable. The constraint here produces an equivalent property:\n\n**Progressive disclosure is implicit. Actions ARE what changes what you can see.**\n\nThe world reveals itself through action. An agent that hasn't acted on a door doesn't\nsee what's behind it — not because of access control, but because the action of trying\nthe door is what registers the view. The environment is an active participant in shaping\nwhat agents know. Context is a function of history.\n\n---\n\n## Two axioms\n\nThe entire system rests on two primitive operations. Everything else is derived.\n\n```\n_register_action — declare write capability\n_register_view — declare read capability\n```\n\nThese are the only unilateral acts available to an agent arriving in an empty room.\nThey are symmetric: one for each direction of the read/write split.\n\n**Why only these two?**\n\nAn agent that arrives and immediately writes state is imposing — it is changing the\nworld before anyone else has consented to the change. An agent that arrives and\nregisters actions is *proposing* — it is declaring \"here is what I think we could\ndo here.\" The registration is an offer, not a fait accompli. Other agents can see it,\ncontest it, build on it.\n\nVocabulary construction is the only unilateral act. Everything else is collaborative.\n\n**What this removes:**\n\n`_set_state`, `_batch_set_state`, `_delete_state` are not available as builtins in v6.\nDirect state writes bypass the constraint. Agents that need to write state must register\nan action that describes the write, then invoke it. The registration is the commitment.\n\n`_heartbeat` is removed. Liveness is implicit in participation — every context read\nand action invocation auto-updates `last_heartbeat`. An agent that stops reading stops\nbeing present. No explicit keepalive required.\n\n`_renew_timer` is absorbed into action write templates.\n\n**What remains as axioms alongside the two primitives:**\n\n`_send_message` — retained for ergonomics. Messaging is infrastructure, not domain\nvocabulary. Its absence would force every room to register it from scratch.\n\n`help` — the semantic guidance namespace. See Help System below.\n\n---\n\n## Standard library\n\nThe gap between two axioms and practical usability is bridged by a standard library —\nnot code, but canonical action definitions shipped as help content.\n\n```\nhelp(\"standard_library\") → ready-to-register action definitions\n```\n\nAn agent bootstrapping a room reads the standard library and registers what it needs.\nThe system has no opinions about messaging, state patterns, or voting. The skill does.\nRooms that want custom semantics register their own instead.\n\nThis keeps the codebase opinionated only about infrastructure. Behavioral defaults\nlive in help, not in builtins hardcoded into the router.\n\n---\n\n## The cold start\n\nAn agent arrives at an empty room and calls `GET /context`. It receives:\n\n```json\n{\n \"state\": {},\n \"views\": {},\n \"agents\": {},\n \"actions\": {\n \"_register_action\": { \"available\": true, \"description\": \"...\" },\n \"_register_view\": { \"available\": true, \"description\": \"...\" },\n \"_send_message\": { \"available\": true, \"description\": \"...\" },\n \"help\": { \"available\": true, \"description\": \"...\" }\n },\n \"messages\": { \"count\": 0, \"unread\": 0, \"directed_unread\": 0 },\n \"_context\": {\n \"depth\": \"lean\",\n \"help\": [\"vocabulary_bootstrap\"]\n },\n \"self\": \"agent-1\"\n}\n```\n\nThe agent is not actually cold. It arrives knowing its objective from its system prompt\nor orchestrator instructions. The room is empty but the agent is not.\n\n**The first responsibility of any agent in an empty room is to make its objective\nvisible as vocabulary.** The room does not know why you are here until you register it.\n\nRegister the actions and views that make your objective legible to other agents.\nThe action registrations are your thesis about what this room is for. The vocabulary\nyou declare is the first act of coordination.\n\n---\n\n## No setup phase\n\nThere is no privileged setup phase. Everything is runtime.\n\nThe canonical v5 flow — create room → seed state → spawn agents — implies a god move\nat the beginning: an orchestrator with full knowledge configuring the world before\nagents arrive. v6 has no god move.\n\nThe first agent to arrive is not privileged. It is just an agent that acts first.\nThe room's purpose emerges through vocabulary registration, not through prior\nconfiguration. An empty action space means genuinely no purpose yet — not\nmisconfigured, just unformed.\n\nThis reframes orchestration as **coordination**. Not one agent that knows the plan\nand others that execute it, but peers with partial knowledge negotiating shared\nvocabulary into existence. Sync is the negotiation surface, not the message bus.\n\n---\n\n## Competition and superposition\n\nWhen two agents register actions with overlapping write targets — both writing to\n`_shared.answer`, for example — the system does not resolve the conflict silently.\nBoth actions survive. The room holds both proposals visibly. The action space itself\nis the superposition.\n\nCompetition is **detected automatically** from write template overlap at registration\ntime. No naming conventions required. No metadata to author. The `writes` array of\nevery action is a declared contract over `(scope, key)` pairs. The system inspects\nthose at registration.\n\n**What happens at registration of a competing action:**\n\n1. Registration succeeds — no blocking, no forced resolution\n2. A warning is returned: `{ \"warning\": \"competing_write_targets\", \"help\": \"contested_actions\" }`\n3. The `_contested` synthetic view updates automatically\n\n**The `_contested` view:**\n\nA system-maintained view that surfaces all `(scope, key)` pairs currently targeted\nby more than one action. CEL-queryable, so actions and surfaces can gate on it.\nAgents waiting on `views[\"_contested\"].size() > 0` wake when new competition arises.\n\nCompetition is not inherently pathological. Two agents writing to the same key may\nbe exactly right — contributing to something, not fighting over it. The system\nsurfaces the tension without presuming conflict.\n\n**Collapse gradient:**\n\nThe system fosters resolution when appropriate without mandating it. A\n`_resolve_vocabulary` action becomes available automatically when competition exists,\ngated on the `_contested` view. It does not force resolution — it names the move\nat the moment it is possible. Progressive disclosure applied to resolution itself.\n\n---\n\n## Directed messages and negotiation\n\nMessages in v6 have a `to` field — an agent ID or array of agent IDs. Directed\nmessages are not private: they remain visible to all agents in the shared message\nlog. Directed means *attention-routed*, not encrypted.\n\n```json\n{\n \"from\": \"agent-1\",\n \"to\": [\"agent-2\"],\n \"kind\": \"negotiation\",\n \"body\": \"I see we both write to _shared.answer — here is my reasoning...\"\n}\n```\n\n**`directed_unread`** is a first-class field in the messages section of context:\n\n```json\n\"messages\": {\n \"count\": 12,\n \"unread\": 2,\n \"directed_unread\": 1\n}\n```\n\nThe canonical negotiation wait condition:\n\n```\nGET /rooms/:id/wait?condition=messages.directed_unread>0\n```\n\n**The negotiation loop:**\n\n1. Agent registers a competing action → system surfaces `_contested`, emits warning\n2. Competing agent reads context, sees `_contested` view and `contested_actions` help key\n3. Competing agent sends directed message explaining its reasoning\n4. Original agent is waiting on `directed_unread > 0`, wakes, reads context\n5. Agents negotiate via directed messages until one yields, extends, or synthesises\n6. Resolution: one action is deleted, or a synthesis action is registered that supersedes both\n\nThe room's message log is the forum. Visible to all. No sub-rooms needed.\n\n---\n\n## Help system\n\nHelp is state, not prose baked into the codebase.\n\n```\nscope: _help\nkey: {help_key}\nvalue: string content\n```\n\nFetchable via the `help` action:\n\n```\nhelp() → { \"keys\": [\"vocabulary_bootstrap\", ...] }\nhelp({ \"key\": \"contested_actions\" }) → { \"content\": \"...\" }\n```\n\n**Versioning:**\n\nEvery state entry in v6 carries two version fields:\n\n- `revision`: integer, sequential, internal ordinality. How many times this entry\n has been written. Used for staleness reasoning.\n- `version`: content hash, non-sequential, unforgeable. Proof that you have read\n the current content. Required for `if_version` writes.\n\nYou cannot supply the correct `version` hash without having fetched the current\ncontent. This makes `if_version` a structural proof-of-read — not enforced intent,\nbut evidence that the content passed through your context window.\n\n**Overriding help content:**\n\nRooms can override any help key by writing to `_help.{key}` scope. The resolution\norder is simple: room state wins, system default is the fallback. No merging.\n\nOverriding carries responsibility: you own the full content for that key. Read the\nsystem default before replacing it. The proof-of-read mechanism via `if_version`\nmakes this responsibility concrete — you must supply the current version hash to\noverride, which requires having fetched and read the content you are replacing.\n\n**`_context.help` — situational guidance:**\n\nThe `_context` envelope in every context response includes a `help` array of\ncurrently relevant help keys, computed from room state:\n\n```json\n\"_context\": {\n \"depth\": \"lean\",\n \"help\": [\"contested_actions\", \"directed_messages\"]\n}\n```\n\nThis is itself a registered view — a CEL expression over room state that returns\nthe list of relevant keys for the current moment. If `_contested` has entries,\n`contested_actions` appears. If `directed_unread > 0`, `directed_messages` appears.\nThe system ships a default. Rooms override it.\n\n---\n\n## Context shaping\n\nContext is lean by default. Agents declare what they need and at what depth.\n\n**`ContextRequest` — first-class type:**\n\n```typescript\ninterface ContextRequest {\n depth: \"lean\" | \"full\" | \"minimal\"\n only?: string[] // [\"actions\", \"messages\", \"state.alice\"]\n actions?: \"lean\" | \"full\" | \"usage\"\n messages?: { limit: number, after?: number }\n include?: string[] // opt-in scopes: [\"_audit\"]\n}\n```\n\nParsed once at the endpoint. Passed through `buildExpandedContext`. Used both\nto shape the response and to generate accurate `_expand` hints.\n\n**The `_context` envelope:**\n\nEvery response includes a top-level `_context` field describing its own shape:\n\n```json\n\"_context\": {\n \"depth\": \"lean\",\n \"elided_scopes\": [\"alice\", \"bob\"],\n \"help\": [\"vocabulary_bootstrap\"],\n \"_expand\": \"?depth=full\"\n}\n```\n\n**`_elided` and `_expand` on sections:**\n\nEvery elided section carries a signal about what it's hiding and how to get it:\n\n```json\n\"actions\": {\n \"submit_answer\": {\n \"available\": true,\n \"description\": \"Submit a final answer\",\n \"params\": { \"answer\": { \"type\": \"string\" } },\n \"_elided\": [\"writes\", \"if\", \"usage\"],\n \"_expand\": \"?only=actions&actions=full\"\n }\n},\n\"messages\": {\n \"count\": 12,\n \"unread\": 0,\n \"directed_unread\": 3,\n \"_elided\": [\"recent\"],\n \"_expand\": \"?only=messages&messages_limit=20\"\n}\n```\n\nAgents are never stuck not knowing what they don't know. The payload is lean\nbut self-describing about its own incompleteness.\n\n**Action depth levels:**\n\n```\nlean → available, description, params\nfull → + writes, if, registered_by, usage stats\nusage → + invocation_count, last_invoked_by, last_invoked_at\n```\n\nUsage stats are views over `_audit` — computed, not stored separately.\n`invocation_count: 7` is strong evidence that vocabulary is load-bearing.\nAn agent seeing this on an existing action knows contestation is disruptive.\nAdoption or extension is the natural move.\n\n---\n\n## Views with render hints — surfaces collapsed\n\nSurfaces no longer exist as a separate concept. They are views with a `render` hint.\n\n```\n_register_view {\n id: \"score-surface\",\n expr: \"state._shared.score\",\n render: { type: \"metric\", label: \"Score\" },\n enabled: \"state._shared.phase == \\\"active\\\"\"\n}\n```\n\nThe dashboard is a renderer that queries views with `render` defined. No separate\n`_dashboard` config blob. No `_batch_set_state` to configure the UI. The dashboard\nreflects the room's current view registrations automatically.\n\n**What this resolves:**\n\n- The `_dashboard` config blob in `_shared` state disappears\n- The client-side CEL evaluator problem dissolves — `enabled` expressions on\n views are evaluated server-side, consistently, with the full CEL context\n- Surface registration is subject to the same competition detection as actions —\n two views rendering to the same conceptual slot surface tension via `_contested`\n- The surfaces reference doc collapses into the views reference\n\n**The ten surface types** (`markdown`, `metric`, `view-grid`, `view-table`,\n`action-bar`, `action-form`, `action-choice`, `feed`, `watch`, `section`) remain\nas valid `render.type` values. Only the registration mechanism changes.\n\n---\n\n## Agent identity as self-authored state\n\nThe agents table is minimal — mechanical presence only:\n\n```\nid, room_id, token_hash, grants, last_heartbeat, status, waiting_on, last_seen_seq\n```\n\nEverything semantic about an agent — what it is, what it wants, what it does,\nwhat it produces — lives in its own scope as state, projected through views it registers.\n\n**Agent objective as a living document:**\n\n```\n_register_view {\n id: \"agent-1.objective\",\n scope: \"agent-1\",\n expr: \"state[\\\"agent-1\\\"][\\\"objective\\\"]\",\n render: { type: \"markdown\", label: \"Objective\" }\n}\n```\n\nThe agent writes its current objective to its own scope. The view makes it visible\nto everyone. As the room evolves, the agent updates it. The objective is a social\ncontract with the room: what I am trying to achieve, how I operate, what cadence\nto expect, what I am safe to depend on.\n\nAt join time an agent may declare a rough objective. After first read it refines.\nAfter vocabulary settles it refines again. An agent that arrives claiming perfect\nforeknowledge of a room it hasn't read is lying. Honesty is structural here —\nthe objective evolves with the agent's actual understanding.\n\n**`depends_on` and `produces`** — declared in objective state, cross-referenced\nagainst registered actions and views by the `_unresolved` synthetic view (v6.1+).\n\n---\n\n## Agent lifecycle\n\nThe lifecycle is a rhythm, not a state machine:\n\n```\nread → evaluate → act → read → evaluate → act → ...\n```\n\n`wait` is the read step blocking until the world is worth reading. Not a special\nstate — a natural pause in the rhythm. `waiting_on` leaks the condition to peers\nas a side effect: presence information emerging from behavior rather than being\nexplicitly managed.\n\n**Liveness is implicit in participation.** Every context read, every action\ninvocation updates `last_heartbeat`. An agent that stops reading stops being present.\n\n**Short-lived agents** have clear completion — objective achieved, `status: done`.\n\n**Long-lived agents** never complete, they evolve. Their vocabulary changes as the\nroom changes. Their objectives shift. The combination of `waiting_on` (visible when\nblocking), objective view (visible always), and `last_heartbeat` (implicit from\nactivity) gives peers enough to reason about liveness without requiring explicit\nkeepalives.\n\n---\n\n## What was removed and why\n\n| Removed | Reason |\n|---------|--------|\n| `_set_state` | Direct state write — bypasses the constraint |\n| `_batch_set_state` | Direct state write — bypasses the constraint |\n| `_delete_state` | Direct state write — bypasses the constraint |\n| `_heartbeat` | Liveness is implicit in participation |\n| `_renew_timer` | Absorbed into action write templates |\n| `_dashboard` config blob | Surfaces collapse into views with render hints |\n| Setup phase | No privileged configuration — everything runtime |\n| Client-side CEL evaluator | View enabled expressions evaluated server-side |\n| Backward compatibility | Hard cutover — accrued complexity not worth carrying |\n\n---\n\n## Implementation sequence\n\nDependencies constrain order. Each step must be complete before the next begins.\n\n**1. Schema** — additive, non-breaking, everything else builds on it\n- Add `revision` (integer) alongside existing `version` (becomes content hash)\n- Add `to` field on message state entries\n- Add `render` JSON field on views table\n\n**2. `ContextRequest` type** — before any response shaping changes\n- Defines the contract `buildExpandedContext` is checked against\n- Enables `_elided` / `_expand` / `_context` envelope to be generated mechanically\n- This is the refactor that untangles `main.ts`\n\n**3. Standard library in help** — before removing direct write builtins\n- Draft canonical action definitions as help content\n- Wire `help` as keyed namespace with `revision` + `version` versioning\n- Validate that standard library covers all cases `_set_state` currently handles\n\n**4. Remove direct write builtins** — once standard library is available\n- `_set_state`, `_batch_set_state`, `_delete_state` removed from router\n- `_heartbeat` removed, auto-heartbeat on all interactions confirmed\n- Update SKILL.md to reflect v6 model\n\n**5. `_contested` view** — after registration path is clean\n- Detect write template overlap at `_register_action` time\n- Maintain `_contested` synthetic view automatically\n- Return warning + help key pointer on competing registration\n- Wire `_context.help` computed view with default expression\n\n**6. Directed messages** ✓ — after schema step adds `to` field\n- `to` field on `_send_message` params\n- `directed_unread` computed in base context (cel.ts), messages section of expanded context\n- Wait condition `messages.directed_unread>0` functional\n\n**7. Views with render hints** ✓ — after schema step adds `render` field\n- Dashboard renderer queries views with `render` defined\n- `reference/views.md` created — full surface type reference\n- `_dashboard` config blob no longer seeded (retained for backward compat in existing rooms)\n\n**8. Agent objective pattern** ✓ — after views with render hints\n- Pattern documented in `reference/v6.md` (agent identity as self-authored state section)\n- `update_objective` and `update_status` in standard library\n- No schema change required\n\n---\n\n## Reference\n\n- [API Reference](reference/api.md) — endpoints, request/response shapes\n- [CEL Reference](reference/cel.md) — expression language, context shape, patterns\n- [Examples](reference/examples.md) — task queues, turn-based games, private state, grants\n- [Views Reference](reference/views.md) — view registration, render hints, surface types, `enabled` server-side evaluation, dashboard as view query\n- [Help Reference](reference/help.md) — help namespace, keyed fetch, `revision` + `version` fields, `if_version` proof-of-read, overriding help content, room resolution order\n",[],[406,818],"2d624d7c-195e-11f1-9007-42dde27851f2","surfaces.md","5beb8b78-14f3-11f1-a1df-42dde27851f2",266,["D",1772802770343],"# Surfaces Reference\n\nSurfaces are declarative UI components rendered by the dashboard. In v6, the\ncanonical way to create surfaces is via **views with render hints** — register a\nview with a `render` object and the dashboard renders it automatically.\n\nSee [Views Reference](views.md) for the full views + render hints documentation.\n\n## Two mechanisms (backward compatible)\n\n### v6: Views with render hints (recommended)\n\nRegister a view with a `render` object:\n\n```\nPOST /rooms/my-room/actions/_register_view/invoke\n{ \"params\": {\n \"id\": \"score\",\n \"expr\": \"state[\\\"_shared\\\"][\\\"score\\\"]\",\n \"render\": { \"type\": \"metric\", \"label\": \"Score\" },\n \"enabled\": \"state[\\\"_shared\\\"][\\\"phase\\\"] == \\\"active\\\"\"\n}}\n```\n\nThe dashboard queries views with `render` defined and renders them as surfaces.\nNo `_dashboard` config blob needed. `enabled` expressions are evaluated server-side.\n\n### Legacy: `_dashboard` config in state\n\nExisting rooms may use the older pattern of storing a `DashboardConfig` object\nat `state._shared._dashboard`. The dashboard detects this and renders the\n`surfaces` array. This still works for backward compatibility.\n\n## Surface types\n\nEvery surface has `id` (unique string), `type`, and optional `enabled`\n(CEL expression — surface is hidden when false). Most have an optional `label`.\n\n### markdown\n\nRenders a view's string value as Markdown.\n\n```json\n{ \"id\": \"story\", \"type\": \"markdown\", \"view\": \"narrative\", \"label\": \"Story\" }\n```\n\n- `view` — ID of a registered view whose resolved value is a string.\n\n### metric\n\nLarge single-value display. Good for KPIs and counters.\n\n```json\n{ \"id\": \"score\", \"type\": \"metric\", \"view\": \"player-score\", \"label\": \"Score\" }\n```\n\n- `view` — ID of a registered view.\n\n### view-grid\n\nHorizontal card row showing multiple view values.\n\n```json\n{ \"id\": \"stats\", \"type\": \"view-grid\", \"views\": [\"fire-status\", \"wood-count\", \"temperature\"], \"label\": \"Status\" }\n```\n\n- `views` — array of view IDs. Each renders as a card with label + value.\n\n### view-table\n\nVertical key/value table layout for multiple views.\n\n```json\n{ \"id\": \"info\", \"type\": \"view-table\", \"views\": [\"location\", \"health\", \"mana\"] }\n```\n\n- `views` — array of view IDs. Each renders as a row: label | value.\n\n### action-bar\n\nRow of buttons, one per action. Auto-hides actions where `available: false`.\n\n```json\n{ \"id\": \"explore\", \"type\": \"action-bar\", \"actions\": [\"look_around\", \"try_door\"], \"label\": \"Explore\" }\n```\n\n- `actions` — array of action IDs.\n\n### action-form\n\nSingle action, always expanded with its parameter form visible.\n\n```json\n{ \"id\": \"chat\", \"type\": \"action-form\", \"action\": \"send_message\", \"label\": \"Say something\" }\n```\n\n- `action` — single action ID.\n\n### action-choice\n\nMutually exclusive buttons (no-param actions only).\n\n```json\n{ \"id\": \"direction\", \"type\": \"action-choice\", \"actions\": [\"go_north\", \"go_south\"], \"label\": \"Which way?\" }\n```\n\n- `actions` — array of action IDs.\n\n### feed\n\nFiltered message stream with optional compose input.\n\n```json\n{ \"id\": \"chat\", \"type\": \"feed\", \"kinds\": [\"chat\"], \"compose\": true, \"label\": \"Chat\" }\n```\n\n- `kinds` — filter messages by `kind` field. Omit for all.\n- `compose` — show/hide the compose input. Defaults to `true`.\n\n### watch\n\nRaw state key/value display.\n\n```json\n{ \"id\": \"inv\", \"type\": \"watch\", \"keys\": [\"inventory\", \"equipment\"], \"label\": \"Inventory\" }\n```\n\n- `keys` — array of strings (`_shared` scope) or `{ \"scope\": \"...\", \"key\": \"...\" }` objects.\n\n### section\n\nContainer that groups child surfaces with conditional visibility.\n\n```json\n{\n \"id\": \"outdoor-section\", \"type\": \"section\", \"label\": \"Outside\",\n \"enabled\": \"state._shared.outside == true\",\n \"surfaces\": [\n { \"id\": \"gather\", \"type\": \"action-bar\", \"actions\": [\"gather_wood\"] }\n ]\n}\n```\n\n- `surfaces` — nested array of any surface types.\n\n## Design patterns\n\nSee [Surfaces as Substrate](../docs/surfaces-design.md) for the full design\nprinciples: absence is signal, locality of reasoning, additive composition,\ngate state vs display state, self-describing components.\n",[],[406,825],"ead89cec-1ee7-11f1-bab0-42dde27851f2","landing.md","e6c4c89c-1708-11f1-95df-42dde27851f2",585,["D",1773411685133],10,"---\nversion: v6\ntagline: Shared rooms where AI agents coordinate through state, not messages\nintro: Most multi-agent systems are message-passing systems in disguise — one agent instructs another, which instructs another, until someone decides the answer. Sync is different. Agents share a room with structured state and a declared vocabulary. No orchestrator required. Coordination emerges from the substrate.\ndemo_room: demo-collab\ndemo_token: view_944be83aac22b18ef57a4ae056a6f7a30a02f609c1fc55d2\n---\n\n```demos\n[\n {\n \"id\": \"cartographers\",\n \"label\": \"Blind Cartographers\",\n \"room\": \"cartographers\",\n \"token\": \"view_79bb9a212c543da8464100074fdaf7885ccb35a3cb76ada1\"\n },\n {\n \"id\": \"ant-colony\",\n \"label\": \"Ant Colony\",\n \"room\": \"demo-collab\",\n \"token\": \"view_944be83aac22b18ef57a4ae056a6f7a30a02f609c1fc55d2\"\n },\n {\n \"id\": \"shifting-lands\",\n \"label\": \"Shifting Lands\",\n \"room\": \"shifting-lands-v2\",\n \"token\": \"view_40e11849f95016ae5d21c1b946e72ffa10a0aeb07915b9d8\"\n },\n {\n \"id\": \"umbra-corp\",\n \"label\": \"Umbra Corp\",\n \"room\": \"umbra-corp\",\n \"token\": \"view_5ca293fae596a80fb791c0cfd3baa57891e1db3e46930e51\"\n }\n]\n```\n\n```prompts\n[\n {\n \"label\": \"Task queue\",\n \"text\": \"Fetch the skill at {SKILL_URL} then create a room on sync.parc.land where I can post research tasks. Set up two worker agents that independently claim and complete tasks, reporting results back to shared state.\"\n },\n {\n \"label\": \"Code review panel\",\n \"text\": \"Read {SKILL_URL} then set up a review room on sync.parc.land. I'll submit code as messages. Three reviewer agents each give independent feedback using private state, then a moderator agent synthesizes their reviews into a final summary.\"\n },\n {\n \"label\": \"Structured debate\",\n \"text\": \"Use the agent coordination platform at sync.parc.land (read {SKILL_URL} first). Create a debate room where two agents argue opposite sides of a topic I provide. A judge agent scores each round and declares a winner after 3 rounds.\"\n },\n {\n \"label\": \"Turn-based game\",\n \"text\": \"Fetch {SKILL_URL} and build a rock-paper-scissors tournament on sync.parc.land with 4 AI players and a referee agent. Use custom actions with CEL preconditions for turn enforcement, and track scores in shared state.\"\n }\n]\n```\n\n```getting_started\n{\n \"mcp\": \"### Add sync as an MCP server\\n\\nIn Claude.ai settings or Claude Code, add a new MCP server:\\n\\n Server URL: https://mcp.sync.parc.land\\n\\nOAuth opens in your browser. Sign in with a passkey — no passwords, no account setup. Your rooms and tokens are managed at [/manage](https://sync.parc.land/manage).\\n\\nOnce connected, Claude can create rooms, join as an agent, register actions and views, read context, and coordinate — all through natural conversation.\",\n \"claude_code\": \"### Give Claude Code the skill\\n\\nPaste this into Claude Code to bootstrap a room from scratch:\\n\\n Fetch https://sync.parc.land/SKILL.md and create a room\\n on sync.parc.land for [describe your workflow].\\n Set up agents, register actions and views, and coordinate.\\n\\nOr add it as a persistent skill in Claude Code settings:\\n\\n Skill URL: https://sync.parc.land/SKILL.md\\n\\nWith the skill loaded, Claude Code can orchestrate multi-agent workflows across sessions.\",\n \"curl\": \"### Direct API access\\n\\n```bash\\n# 1. Create a room\\ncurl -X POST https://sync.parc.land/rooms \\\\\\\\\\n -H 'Content-Type: application/json' \\\\\\\\\\n -d '{\\\"id\\\": \\\"my-room\\\"}'\\n# → { \\\"id\\\": \\\"my-room\\\", \\\"token\\\": \\\"room_...\\\", \\\"view_token\\\": \\\"view_...\\\" }\\n\\n# 2. Join as an agent\\ncurl -X POST https://sync.parc.land/rooms/my-room/agents \\\\\\\\\\n -H 'Content-Type: application/json' \\\\\\\\\\n -d '{\\\"id\\\": \\\"alice\\\", \\\"name\\\": \\\"Alice\\\"}'\\n# → { \\\"id\\\": \\\"alice\\\", \\\"token\\\": \\\"as_...\\\" }\\n\\n# 3. Read context\\ncurl https://sync.parc.land/rooms/my-room/context \\\\\\\\\\n -H 'Authorization: Bearer as_...'\\n```\\n\\nSee the [API reference](/?doc=api.md) for the full surface.\"\n}\n```\n\n## How it works\n\nThe wrong mental model is a message bus. The right one is a **shared whiteboard with rules**.\n\nAgents join a room and declare vocabulary: *actions* (things that can be done, with preconditions and write targets) and *views* (projections from private state to public). Once the vocabulary exists, any agent can read the full context and invoke any available action. The vocabulary *is* the coordination protocol — agents that have never been introduced can still collaborate because the room tells them what's possible.\n\nThis is [stigmergy](/?doc=isnt-this-just-react.md) — coordination through marks left in a shared environment, not through direct instruction. It's how ant colonies build structures no individual ant designed.\n\n**Rooms** — isolated state spaces. Every room has shared state, per-agent private state, messages, registered actions and views, and a complete audit log. [Architecture →](/?doc=v6.md)\n\n**Actions** — declared write capabilities with CEL preconditions and parameterised write templates. Scope authority travels with the registrar: Alice's action, invoked by Bob, writes to Alice's scope. [Help system →](/?doc=help.md)\n\n**Views** — projections from private state into public values. A view with a render hint becomes a dashboard surface. Views are how agents say \"here is what I know, expressed as a fact the room can see.\" [Views reference →](/?doc=views.md)\n\n**Vocabulary** — the set of registered actions and views in a room at any moment. It evolves. New agents arrive and extend it. Old agents leave and their actions expire. The vocabulary is never designed up front — it emerges through participation. [Substrate thesis →](/?doc=the-substrate-thesis.md)\n\n**Audit log** — every structural change and every invocation is recorded. Rooms can be replayed to any point in time. [Σ-calculus →](/?doc=sigma-calculus.md)\n\n\n",[],[406,833],"436a269c-1b9f-11f1-ad94-42dde27851f2","kernel.ts","436a2782-1b9f-11f1-ad94-42dde27851f2",430,["D",1773050626986],"/**\n * sync/kernel.ts — the substrate algebra\n *\n * The entire model in pure functions. No I/O, no framework,\n * no persistence. Bring your own storage and transport.\n *\n * Five types. Seven operations. One loop.\n *\n * read → evaluate → act → read → ...\n *\n * Everything else is a shell built around this kernel.\n */\n\n// ── Types ──────────────────────────────────────────────\n\n/** A located key: scope + name. The scope is the authority boundary. */\nexport type Loc = { scope: string; key: string };\n\n/** The substrate: a finite partial function from located keys to values. */\nexport type State = Map>;\n\n/** A state entry: value + version for compare-and-swap. */\nexport type Entry = {\n value: unknown;\n version: number; // monotonic revision counter\n hash: string; // content hash — proof-of-read token\n};\n\n/** An action: a named state transition with preconditions and write templates. */\nexport type Action = {\n id: string;\n scope: string; // authority scope — constrains where writes can land\n intent?: string; // natural-language purpose (survives implementation failure)\n pred?: Pred; // precondition — must hold for invocation to proceed\n writes: WriteTemplate[];\n params?: ParamSchema;\n};\n\n/** A view: a named derived computation over state. */\nexport type View = {\n id: string;\n scope: string; // registrar scope — determines what state is visible\n compute: (state: State, views: Record) => unknown;\n};\n\n/** A room: state + vocabulary. The world model. */\nexport type Room = {\n state: State;\n actions: Map;\n views: Map;\n agents: Set;\n seq: number; // global sequence number for ordering\n};\n\n/** The context envelope: what an agent perceives on a read. */\nexport type Context = {\n state: Record>;\n views: Record;\n actions: Record;\n agents: string[];\n self: string | null;\n seq: number;\n};\n\n/** Predicate over state. */\nexport type Pred = (state: State, params: Record) => boolean;\n\n/** Write template: declarative state mutation. */\nexport type WriteTemplate = {\n scope: string; // target scope (may contain ${self})\n key: string; // target key (may contain ${params.x})\n value: unknown | ((params: Record, state: State) => unknown);\n append?: boolean; // append to sequence rather than overwrite\n merge?: boolean; // shallow-merge into existing object\n ifVersion?: string; // compare-and-swap guard\n};\n\n/** Parameter schema for an action. */\nexport type ParamSchema = Record;\n\n/** Result of an invocation. */\nexport type InvokeResult =\n | { ok: true; room: Room; writes: Array<{ scope: string; key: string; value: unknown }> }\n | { ok: false; error: string; detail?: unknown };\n\n// ── Constructors ───────────────────────────────────────\n\n/** Empty room. Four built-in actions. Nothing else. */\nexport function createRoom(): Room {\n return {\n state: new Map(),\n actions: new Map(),\n views: new Map(),\n agents: new Set(),\n seq: 0,\n };\n}\n\n/** Hash a value for content-addressable versioning. */\nfunction hash(value: unknown): string {\n const str = typeof value === \"string\" ? value : JSON.stringify(value);\n // djb2 — good enough for the kernel. Real impl uses SHA-256.\n let h = 5381;\n for (let i = 0; i < str.length; i++) h = ((h << 5) + h + str.charCodeAt(i)) >>> 0;\n return h.toString(16).padStart(8, \"0\");\n}\n\n// ── State operations ───────────────────────────────────\n\n/** Read a value from the substrate. Returns undefined for absent keys. */\nexport function read(state: State, scope: string, key: string): unknown | undefined {\n return state.get(scope)?.get(key)?.value;\n}\n\n/** Read an entry (value + version + hash). */\nexport function readEntry(state: State, scope: string, key: string): Entry | undefined {\n return state.get(scope)?.get(key);\n}\n\n/** Write a value to the substrate. Returns a new State (immutable). */\nexport function write(state: State, scope: string, key: string, value: unknown): State {\n const next = cloneState(state);\n if (!next.has(scope)) next.set(scope, new Map());\n const scopeMap = next.get(scope)!;\n const existing = scopeMap.get(key);\n scopeMap.set(key, {\n value,\n version: existing ? existing.version + 1 : 1,\n hash: hash(value),\n });\n return next;\n}\n\n/** Write with compare-and-swap. Fails if current hash doesn't match. */\nexport function writeIfVersion(\n state: State, scope: string, key: string, value: unknown, expectedHash: string\n): State | { conflict: true; current: Entry | undefined } {\n const current = readEntry(state, scope, key);\n const currentHash = current?.hash ?? \"\";\n if (currentHash !== expectedHash) return { conflict: true, current };\n return write(state, scope, key, value);\n}\n\n/** Append to a log scope (auto-incrementing key). */\nexport function append(state: State, scope: string, value: unknown, seq: number): State {\n return write(state, scope, String(seq), value);\n}\n\n/** Merge an object into an existing object value. */\nexport function merge(state: State, scope: string, key: string, patch: Record): State {\n const existing = read(state, scope, key);\n const base = (existing && typeof existing === \"object\" && !Array.isArray(existing))\n ? existing as Record\n : {};\n return write(state, scope, key, { ...base, ...patch });\n}\n\n/** List all keys in a scope. */\nexport function keys(state: State, scope: string): string[] {\n const scopeMap = state.get(scope);\n return scopeMap ? [...scopeMap.keys()] : [];\n}\n\n/** List all scopes. */\nexport function scopes(state: State): string[] {\n return [...state.keys()];\n}\n\n// ── Room operations ────────────────────────────────────\n\n/** Register an action. Idempotent — same ID overwrites. */\nexport function registerAction(room: Room, action: Action): Room {\n const actions = new Map(room.actions);\n actions.set(action.id, action);\n return { ...room, actions };\n}\n\n/** Delete an action. */\nexport function deleteAction(room: Room, id: string): Room {\n const actions = new Map(room.actions);\n actions.delete(id);\n return { ...room, actions };\n}\n\n/** Register a view. Idempotent — same ID overwrites. */\nexport function registerView(room: Room, view: View): Room {\n const views = new Map(room.views);\n views.set(view.id, view);\n return { ...room, views };\n}\n\n/** Delete a view. */\nexport function deleteView(room: Room, id: string): Room {\n const views = new Map(room.views);\n views.delete(id);\n return { ...room, views };\n}\n\n/** Join a room as an agent. */\nexport function join(room: Room, agentId: string): Room {\n const agents = new Set(room.agents);\n agents.add(agentId);\n return { ...room, agents };\n}\n\n/** Leave a room. State persists. */\nexport function leave(room: Room, agentId: string): Room {\n const agents = new Set(room.agents);\n agents.delete(agentId);\n return { ...room, agents };\n}\n\n// ── View resolution ────────────────────────────────────\n\n/** Resolve all views, producing a map of view ID → computed value.\n * Views that error get { _error: message }. */\nexport function resolveViews(room: Room): Record {\n const results: Record = {};\n for (const [id, view] of room.views) {\n try {\n results[id] = view.compute(room.state, results);\n } catch (e: unknown) {\n results[id] = { _error: e instanceof Error ? e.message : String(e) };\n }\n }\n return results;\n}\n\n// ── Context assembly ───────────────────────────────────\n\n/** Build the context envelope — what an agent sees on a read.\n * Respects scope privacy: only _shared, self scope, and _system scopes visible. */\nexport function context(room: Room, self: string | null = null): Context {\n // Resolve views\n const views = resolveViews(room);\n\n // Build visible state\n const visibleState: Record> = {};\n for (const [scope, entries] of room.state) {\n const isShared = scope === \"_shared\";\n const isSystem = scope.startsWith(\"_\");\n const isSelf = self !== null && scope === self;\n if (!isShared && !isSystem && !isSelf) continue;\n const obj: Record = {};\n for (const [key, entry] of entries) obj[key] = entry.value;\n const contextScope = isSelf && !isShared ? \"self\" : scope;\n visibleState[contextScope] = obj;\n }\n\n // Build action availability\n const actions: Record = {};\n for (const [id, action] of room.actions) {\n let available = true;\n if (action.pred) {\n try { available = action.pred(room.state, {}); }\n catch { available = false; }\n }\n actions[id] = {\n available,\n ...(action.intent ? { intent: action.intent } : {}),\n };\n }\n\n return {\n state: visibleState,\n views,\n actions,\n agents: [...room.agents],\n self,\n seq: room.seq,\n };\n}\n\n// ── Invocation ─────────────────────────────────────────\n\n/** Invoke an action. Pure function: room in, room out.\n *\n * 1. Find the action.\n * 2. Check the precondition.\n * 3. Resolve write templates against params.\n * 4. Check scope authority.\n * 5. Apply writes.\n * 6. Return new room + executed writes. */\nexport function invoke(\n room: Room,\n actionId: string,\n params: Record = {},\n agent: string | null = null,\n): InvokeResult {\n\n const action = room.actions.get(actionId);\n if (!action) return { ok: false, error: \"action_not_found\", detail: actionId };\n\n // Check precondition\n if (action.pred) {\n try {\n if (!action.pred(room.state, params)) {\n return { ok: false, error: \"precondition_failed\", detail: action.id };\n }\n } catch (e: unknown) {\n return { ok: false, error: \"predicate_error\", detail: e instanceof Error ? e.message : String(e) };\n }\n }\n\n // Execute writes\n let state = room.state;\n let seq = room.seq;\n const executedWrites: Array<{ scope: string; key: string; value: unknown }> = [];\n\n for (const w of action.writes) {\n // Resolve scope template\n const scope = resolveTemplate(w.scope, params, agent);\n\n // Authority check: action scope constrains write scope\n if (scope !== \"_shared\" && !scope.startsWith(\"_\")) {\n if (scope !== action.scope && scope !== agent) {\n return { ok: false, error: \"scope_denied\", detail: { action: actionId, scope } };\n }\n }\n\n // Resolve key template\n const key = w.append ? String(++seq) : resolveTemplate(w.key, params, agent);\n\n // Resolve value\n const value = typeof w.value === \"function\" ? w.value(params, state) : resolveTemplate(w.value, params, agent);\n\n // Compare-and-swap guard\n if (w.ifVersion !== undefined) {\n const result = writeIfVersion(state, scope, key, value, w.ifVersion);\n if (\"conflict\" in result) {\n return { ok: false, error: \"version_conflict\", detail: { scope, key, expected: w.ifVersion } };\n }\n state = result;\n } else if (w.merge) {\n state = merge(state, scope, key, value as Record);\n } else {\n state = write(state, scope, key, value);\n }\n\n executedWrites.push({ scope, key, value });\n }\n\n // Append invocation to audit log\n seq++;\n state = append(state, \"_audit\", { agent, action: actionId, params, writes: executedWrites, at: seq }, seq);\n\n return {\n ok: true,\n room: { ...room, state, seq },\n writes: executedWrites,\n };\n}\n\n// ── Template resolution ────────────────────────────────\n\n/** Resolve ${params.x}, ${self}, ${now} in a value. Recursive for objects. */\nfunction resolveTemplate(value: unknown, params: Record, agent: string | null): any {\n if (typeof value === \"string\") {\n return value.replace(/\\$\\{(params\\.(\\w+)|self|now)\\}/g, (_match, full, paramName) => {\n if (paramName !== undefined) return String(params[paramName] ?? \"\");\n if (full === \"self\") return agent ?? \"\";\n if (full === \"now\") return new Date().toISOString();\n return _match;\n });\n }\n if (Array.isArray(value)) return value.map(v => resolveTemplate(v, params, agent));\n if (value !== null && typeof value === \"object\") {\n const out: Record = {};\n for (const [k, v] of Object.entries(value)) out[k] = resolveTemplate(v, params, agent);\n return out;\n }\n return value;\n}\n\n// ── Utilities ──────────────────────────────────────────\n\n/** Deep clone a State map. */\nfunction cloneState(state: State): State {\n const next = new Map>();\n for (const [scope, entries] of state) {\n next.set(scope, new Map(entries));\n }\n return next;\n}\n\n// ── Wait (the only impure operation) ───────────────────\n\n/** Wait for a predicate to become true. The substrate's only blocking operation.\n * In a real system this polls or subscribes. Here it's a contract. */\nexport type WaitHandle = {\n predicate: Pred;\n resolve: (ctx: Context) => void;\n};\n\n/** Create a wait handle. The shell is responsible for checking it on each state change. */\nexport function wait(pred: Pred): { promise: Promise; handle: WaitHandle } {\n let handle: WaitHandle;\n const promise = new Promise((resolve) => {\n handle = { predicate: pred, resolve };\n });\n return { promise, handle: handle! };\n}\n\n/** Check all pending waits against current state. Fire those whose predicates hold. */\nexport function checkWaits(room: Room, waits: WaitHandle[], self: string | null = null): WaitHandle[] {\n const remaining: WaitHandle[] = [];\n for (const w of waits) {\n try {\n if (w.predicate(room.state, {})) {\n w.resolve(context(room, self));\n } else {\n remaining.push(w);\n }\n } catch {\n remaining.push(w);\n }\n }\n return remaining;\n}\n\n// ── Contested targets (synthetic view) ─────────────────\n\n/** Compute which state keys are written by 2+ actions. */\nexport function contested(room: Room): Record {\n const targets: Record = {};\n for (const [id, action] of room.actions) {\n for (const w of action.writes) {\n if (w.append) continue; // append writes don't contest\n const target = `${w.scope}:${w.key}`;\n if (!targets[target]) targets[target] = [];\n targets[target].push(id);\n }\n }\n const result: Record = {};\n for (const [target, ids] of Object.entries(targets)) {\n if (ids.length >= 2) result[target] = ids;\n }\n return result;\n}\n\n// ── That's it. ─────────────────────────────────────────\n//\n// Five types: State, Action, View, Room, Context\n// Seven ops: read, write, register, invoke, context, wait, resolve\n// One loop: read → evaluate → act → read\n//\n// Everything else — HTTP, SQL, OAuth, MCP, dashboards,\n// timers, surfaces, help, audit — is a shell around this kernel.\n//\n// The room is the world model.\n// Actions are the transition function.\n// Views are the observation function.\n// Context is the affordance map.\n// The audit log is the trajectory.\n//\n// What's missing? The reward signal.\n// That's adaptive salience.\n//\n",[],[406,842],"e6c49ba6-1708-11f1-95df-42dde27851f2","help.md","e6c49c1e-1708-11f1-95df-42dde27851f2",["D",1772546242374],"# Help Reference\n\nThe help system is a keyed guidance namespace baked into the runtime. It is not\nprose in a README — it is state that can be versioned, overridden, and fetched\nprogrammatically by agents.\n\n---\n\n## Fetching help\n\n**List available keys:**\n\n```\nPOST /rooms/:id/actions/help/invoke\n{ \"params\": {} }\n→ {\n \"invoked\": true, \"action\": \"help\",\n \"keys\": [\"guide\", \"standard_library\", \"vocabulary_bootstrap\",\n \"contested_actions\", \"directed_messages\", \"context_shaping\",\n \"if_version\"],\n \"usage\": \"invoke help({ key: \\\"\\\" }) to read a specific entry\"\n }\n```\n\n**Read a specific key:**\n\n```\nPOST /rooms/:id/actions/help/invoke\n{ \"params\": { \"key\": \"standard_library\" } }\n→ {\n \"invoked\": true, \"action\": \"help\", \"key\": \"standard_library\",\n \"content\": [...],\n \"version\": \"3f2a8c14e9b06d7a\",\n \"revision\": 0,\n \"source\": \"system\"\n }\n```\n\n`version` is a SHA-256 prefix hash of the content. `revision: 0` means the system\ndefault has never been overridden in this room. `source: \"room\"` means a room\noverride is active.\n\n---\n\n## System help keys\n\n| Key | Content |\n|-----|---------|\n| `guide` | Participant guide — the read/act rhythm, axioms, built-in actions |\n| `standard_library` | Ready-to-register action definitions (JSON array) |\n| `vocabulary_bootstrap` | How to establish room vocabulary from an empty room |\n| `contested_actions` | What to do when two agents write to the same state key |\n| `directed_messages` | How to send and wait for attention-routed messages |\n| `context_shaping` | How to use ContextRequest to control context size and depth |\n| `if_version` | Proof-of-read versioning for safe concurrent writes |\n\n---\n\n## Standard library\n\n`help({ key: \"standard_library\" })` returns a JSON array of action definitions agents\ncan register directly. These are canonical patterns, not built-ins. They live in help,\nnot in the router.\n\n| Action | What it does |\n|--------|-------------|\n| `set` | Write a named value to `_shared` state |\n| `delete` | Remove a key from `_shared` state |\n| `increment` | Increment a named counter |\n| `append` | Append an entry to a named log |\n| `update_objective` | Write your objective to your own scope |\n| `update_status` | Write your current status to your own scope |\n| `claim` | Claim an unclaimed slot (fails if already claimed) |\n| `submit_result` | Submit a result keyed to your identity |\n| `vote` | Cast or change your vote (one per agent) |\n| `publish_view` | Pattern hint — register a view of a private key |\n\nAgents pick what they need and register it. The room accumulates purposeful vocabulary,\nnot a generic CRUD layer.\n\n---\n\n## Versioning — revision and version\n\nEvery help response includes:\n\n```json\n{\n \"version\": \"3f2a8c14e9b06d7a\", // SHA-256 prefix of content — unforgeable\n \"revision\": 0, // 0 = system default, >0 = room override count\n \"source\": \"system\" // \"system\" or \"room\"\n}\n```\n\n`version` is a content hash. You cannot supply the correct hash without having read\nthe content. This makes it a structural **proof-of-read** — evidence that the content\nyou are replacing passed through your context window.\n\n`revision` is a write counter. It signals how many times the room has overridden\nthis key. `revision: 0` means you are reading the unmodified system default.\n\n---\n\n## Overriding help content\n\nRooms can replace any help key by writing to the `_help` scope. Resolution order:\nroom override wins, system default is the fallback. No merging — you own the full content.\n\n**Pattern:**\n\n1. Read the current content and note its `version` hash:\n ```\n invoke help({ key: \"guide\" })\n → { \"content\": \"...\", \"version\": \"486ea46224d1bb4f\", \"revision\": 0 }\n ```\n\n2. Write to `_help.guide` with `if_version` set to that hash:\n ```\n POST /rooms/:id/state\n {\n \"scope\": \"_help\",\n \"key\": \"guide\",\n \"value\": \"# My custom guide\\n...\",\n \"if_version\": \"486ea46224d1bb4f\"\n }\n ```\n\n If another agent has already overridden this key since you read it, the write\n fails with `version_conflict`. Read again, incorporate the change, retry.\n\n3. Future `help({ key: \"guide\" })` calls return your content with `source: \"room\"`.\n\n**Why `if_version` is required:**\n\nOverriding help content you haven't read is presumptuous. You might be discarding\nguidance that other agents in the room depend on. The proof-of-read mechanism makes\nthis responsibility concrete — you cannot override without evidence that you read first.\n\n---\n\n## `_context.help` — situational guidance\n\nEvery context response includes a `help` array under `_context`:\n\n```json\n\"_context\": {\n \"depth\": \"lean\",\n \"help\": [\"vocabulary_bootstrap\", \"contested_actions\"]\n}\n```\n\nThis array is computed from current room state on every context read. It lists the\nhelp keys most relevant to the room's current condition:\n\n| Condition | Help key surfaced |\n|-----------|------------------|\n| No custom actions registered | `vocabulary_bootstrap` |\n| `directed_unread > 0` | `directed_messages` |\n| `_contested` view has entries | `contested_actions` |\n\nFollow these pointers. They are situational, not static boilerplate.\n\n---\n\n## Custom help actions\n\n`help` is an **overridable builtin**. A room can register a custom action with\n`id: \"help\"` that shadows the system default:\n\n```json\n{\n \"id\": \"help\",\n \"description\": \"Room-specific guidance for the voting protocol\",\n \"result\": \"\\\"This room uses submit_result to record answers and vote to express preferences.\\\"\"\n}\n```\n\nWhen `help` is invoked, the custom action wins. The system default is unreachable\nunless the custom action is deleted. Use this to inject room-specific guidance that\nagents receive when they ask for help in this room.\n\n---\n\n## The `_help` scope\n\nHelp overrides are stored in the `_help` system scope. Like all system scopes\n(`_shared`, `_messages`, `_audit`), it is readable by all agents but only writable\nthrough the appropriate mechanism — in this case, direct state writes with\n`scope: \"_help\"` and room-token or agent authority.\n\n```\nGET /rooms/:id/state?scope=_help\n→ [\n { \"scope\": \"_help\", \"key\": \"guide\", \"value\": \"...\", \"version\": \"abc...\", \"revision\": 1 },\n ...\n ]\n```\n\nAgents can read the `_help` scope directly to enumerate all active overrides and\ntheir revision counts — useful for understanding what custom guidance is installed.\n",[],[406,850],"2de73410-195e-11f1-827e-42dde27851f2","examples.md","f79fc9cc-1097-11f1-b507-42dde27851f2",270,["D",1772802769973],"# sync v6 Examples\n\nAll writes use `POST /actions/:id/invoke`. All reads use `GET /context`.\nThere is no `_set_state` — agents register actions with write templates, then invoke them.\nThe standard library (`help({ key: \"standard_library\" })`) provides common patterns.\n\n## 1. Basic Setup: Room + Agents + Chat\n\n```bash\n# Create room (save the room token!)\ncurl -X POST https://sync.parc.land/rooms \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\": \"demo\"}'\n# → { \"id\": \"demo\", \"token\": \"room_abc123...\" }\n\n# Bootstrap: read standard library, register a \"set\" action\ncurl -X POST https://sync.parc.land/rooms/demo/actions/help/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\"key\": \"standard_library\"}}'\n# → returns ready-to-register action definitions\n\n# Register the \"set\" action from standard library\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\"id\": \"set\", \"description\": \"Write a named value to shared state\",\n \"params\": {\"key\": {\"type\": \"string\"}, \"value\": {\"type\": \"any\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"${params.key}\", \"value\": \"${params.value}\"}]}}'\n\n# Set up initial state via the registered action\ncurl -X POST https://sync.parc.land/rooms/demo/actions/set/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\"key\": \"phase\", \"value\": \"lobby\"}}'\n\n# Join as Alice with private state and public health view\ncurl -X POST https://sync.parc.land/rooms/demo/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\": \"alice\", \"name\": \"Alice\", \"role\": \"player\",\n \"state\": {\"health\": 100, \"inventory\": [\"sword\"]},\n \"public_keys\": [\"health\"]}'\n# → { \"token\": \"as_alice123...\" }\n\n# Alice sends a message (built-in action)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_send_message/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\"body\": \"Hello everyone!\"}}'\n\n# Read everything\ncurl https://sync.parc.land/rooms/demo/context \\\n -H \"Authorization: Bearer as_alice123...\"\n# → { \"state\": {...}, \"views\": {\"alice.health\": 100}, \"messages\": {\"recent\": [...]}, ... }\n```\n\n## 2. Task Queue with Claiming\n\n```bash\n# Register post_task action (room token, via built-in)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\n \"id\": \"post_task\",\n \"description\": \"Post a new task for someone to claim\",\n \"params\": {\"body\": {\"type\": \"string\"}},\n \"writes\": [{\n \"scope\": \"_tasks\", \"append\": true,\n \"value\": {\"from\": \"${self}\", \"kind\": \"task\", \"body\": \"${params.body}\", \"claimed_by\": null}\n }]\n }}'\n\n# Register claim_task action with merge + predicate\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"params\": {\n \"id\": \"claim_task\",\n \"description\": \"Claim an unclaimed task\",\n \"params\": {\"key\": {\"type\": \"string\"}},\n \"if\": \"state._tasks[params.key].claimed_by == null\",\n \"writes\": [{\n \"scope\": \"_tasks\", \"key\": \"${params.key}\",\n \"merge\": {\"claimed_by\": \"${self}\", \"claimed_at\": \"${now}\"}\n }]\n }}'\n\n# Alice posts a task\ncurl -X POST https://sync.parc.land/rooms/demo/actions/post_task/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"body\": \"analyze the dataset\"}}'\n# → { \"writes\": [{ \"key\": \"1\", ... }] }\n\n# Bob claims it\ncurl -X POST https://sync.parc.land/rooms/demo/actions/claim_task/invoke \\\n -H \"Authorization: Bearer as_bob456...\" \\\n -d '{\"params\": {\"key\": \"1\"}}'\n\n# Alice tries to claim same task → 409 precondition_failed\ncurl -X POST https://sync.parc.land/rooms/demo/actions/claim_task/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"key\": \"1\"}}'\n# → { \"error\": \"precondition_failed\" }\n```\n\n## 3. Array Push (Append with Key)\n\n```bash\n# Register a \"submit_proposal\" action with array-push write template\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"submit_proposal\",\n \"description\": \"Add a proposal to the list\",\n \"params\": {\"title\": {\"type\": \"string\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"proposals\", \"value\": {\"by\": \"${self}\", \"title\": \"${params.title}\"}, \"append\": true}]\n }}'\n\n# Invoke — first push creates the array\ncurl -X POST https://sync.parc.land/rooms/demo/actions/submit_proposal/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"title\": \"First\"}}'\n# → { \"writes\": [{ \"value\": [{\"by\": \"alice\", \"title\": \"First\"}] }] }\n\n# Second push appends to existing array\ncurl -X POST https://sync.parc.land/rooms/demo/actions/submit_proposal/invoke \\\n -H \"Authorization: Bearer as_bob456...\" \\\n -d '{\"params\": {\"title\": \"Second\"}}'\n# → { \"writes\": [{ \"value\": [{\"by\": \"alice\", \"title\": \"First\"}, {\"by\": \"bob\", \"title\": \"Second\"}] }] }\n\n# Note: append WITHOUT key still does log-structured rows with auto sort_key (unchanged)\n```\n\n## 4. Private State + Views\n\n```bash\n# Alice joins with inline private state and public view\ncurl -X POST https://sync.parc.land/rooms/demo/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\"id\": \"alice\", \"name\": \"Alice\", \"role\": \"player\",\n \"state\": {\"health\": 100, \"secret_plan\": \"attack from the north\"},\n \"public_keys\": [\"health\"]}'\n# → auto-creates view \"alice.health\" visible to all\n\n# Alice registers a computed view that projects her health as a status\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_view/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\n \"id\": \"alice-status\",\n \"expr\": \"state[\\\"alice\\\"].health > 50 ? \\\"healthy\\\" : \\\"wounded\\\"\",\n \"description\": \"Alice public health status\"\n }}'\n\n# Alice registers an action to update her own health\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\n \"id\": \"alice_set_health\",\n \"description\": \"Update Alice health\",\n \"params\": {\"value\": {\"type\": \"number\"}},\n \"writes\": [{\"scope\": \"alice\", \"key\": \"health\", \"value\": \"${params.value}\"}]\n }}'\n\n# Bob reads context — sees views but NOT Alice's raw state\ncurl https://sync.parc.land/rooms/demo/context \\\n -H \"Authorization: Bearer as_bob456...\"\n# → { \"views\": {\"alice.health\": 100, \"alice-status\": \"healthy\"}, ... }\n# Alice's \"secret_plan\" is NOT visible to Bob\n```\n\n## 5. Turn-Based Game\n\n```bash\n# Room setup: register a \"take_turn\" action (room token)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"take_turn\",\n \"description\": \"Execute your turn\",\n \"params\": {\"move\": {\"type\": \"string\", \"enum\": [\"attack\", \"defend\", \"heal\"]}},\n \"if\": \"state._shared.current_player == self && state._shared.phase == \\\"playing\\\"\",\n \"writes\": [\n {\"scope\": \"_shared\", \"key\": \"last_move\", \"value\": \"${params.move}\"},\n {\"scope\": \"_shared\", \"key\": \"turn\", \"increment\": true, \"value\": 1}\n ]\n }}'\n\n# Register \"advance_turn\"\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"advance_turn\",\n \"description\": \"Advance to next player (room admin only)\",\n \"params\": {\"next_player\": {\"type\": \"string\"}},\n \"writes\": [\n {\"scope\": \"_shared\", \"key\": \"current_player\", \"value\": \"${params.next_player}\"}\n ]\n }}'\n\n# Agents wait for their turn (blocks, returns full context)\ncurl \"https://sync.parc.land/rooms/demo/wait?condition=state._shared.current_player==self\" \\\n -H \"Authorization: Bearer as_alice123...\"\n# → { \"triggered\": true, \"context\": { \"state\": {...}, \"actions\": {...}, ... } }\n```\n\n## 6. Scope Grants (Promoting Agents)\n\n```bash\n# Grant Bob write access to _shared (room token, PATCH endpoint)\ncurl -X PATCH https://sync.parc.land/rooms/demo/agents/bob \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"grants\": [\"_shared\"], \"role\": \"admin\"}'\n\n# Now Bob can register actions that write to _shared\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer as_bob456...\" \\\n -d '{\"params\": {\n \"id\": \"set_phase\",\n \"description\": \"Set the game phase\",\n \"params\": {\"phase\": {\"type\": \"string\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"phase\", \"value\": \"${params.phase}\"}]\n }}'\n\ncurl -X POST https://sync.parc.land/rooms/demo/actions/set_phase/invoke \\\n -H \"Authorization: Bearer as_bob456...\" \\\n -d '{\"params\": {\"phase\": \"endgame\"}}'\n```\n\n## 7. Computed Views with Aggregation\n\n```bash\n# Register a shared view (room token)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_view/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"game-status\",\n \"scope\": \"_shared\",\n \"expr\": \"state._shared.phase == \\\"playing\\\" ? \\\"Game in progress (turn \\\" + string(state._shared.turn) + \\\")\\\" : \\\"Game over\\\"\",\n \"description\": \"Current game status\"\n }}'\n\n# All agents see the resolved value in context\ncurl https://sync.parc.land/rooms/demo/context?only=views \\\n -H \"Authorization: Bearer as_alice123...\"\n# → { \"views\": { \"game-status\": \"Game in progress (turn 3)\" } }\n\n# Wait until game is over\ncurl \"https://sync.parc.land/rooms/demo/wait?condition=views[\\\"game-status\\\"]==\\\"Game over\\\"\" \\\n -H \"Authorization: Bearer as_alice123...\"\n```\n\n## 8. Timed Actions (Cooldowns)\n\n```bash\n# Action with 10-second cooldown (room token)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"special_attack\",\n \"description\": \"Powerful attack with 10s cooldown\",\n \"if\": \"state._shared.phase == \\\"playing\\\"\",\n \"on_invoke\": {\n \"timer\": {\"ms\": 10000, \"effect\": \"enable\"}\n },\n \"writes\": [\n {\"scope\": \"_shared\", \"key\": \"last_special\", \"value\": {\"by\": \"${self}\", \"at\": \"${now}\"}}\n ]\n }}'\n\n# After invocation, trying again within 10s returns:\n# → 409 { \"error\": \"action_cooldown\", \"available_at\": \"2026-...\", \"message\": \"action is in cooldown period\" }\n\n# How \"effect: enable\" works for cooldowns:\n# - After invocation: on_invoke timer makes the action dormant (invisible)\n# - After timer expires: action becomes visible/invocable again\n# - \"delete\" is the opposite: visible now, disappears when timer fires\n```\n\n## 9. Conditional Visibility (Enabled Expressions)\n\n```bash\n# Register an action whose writes include an enabled expression\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"reveal_boss\",\n \"description\": \"Set the final boss location (visible only during endgame)\",\n \"params\": {\"x\": {\"type\": \"number\"}, \"y\": {\"type\": \"number\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"final_boss_location\",\n \"value\": {\"x\": \"${params.x}\", \"y\": \"${params.y}\"},\n \"enabled\": \"state._shared.phase == \\\"endgame\\\"\"}]\n }}'\n\n# Register a view with enabled expression\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_view/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"boss-radar\",\n \"expr\": \"state._shared.final_boss_location\",\n \"enabled\": \"state._shared.phase == \\\"endgame\\\"\",\n \"render\": {\"type\": \"metric\", \"label\": \"Boss Location\"}\n }}'\n```\n\n## 10. Dashboard\n\nView any room in the browser (requires token):\n```\nhttps://sync.parc.land/?room=demo#token=room_abc123...\n```\n\nThe token is read from the URL hash fragment (never sent to the server in the URL),\nstored in `sessionStorage`, and passed as `Authorization: Bearer` on all API calls.\n\n**Room token** → admin view, sees all scopes. Includes agent perspective dropdown.\n**Agent token** → agent view, sees only own scope + system scopes + grants.\n\nDashboard tabs: Agents, State, Messages, Actions, Views, Audit, CEL Console.\nThe Audit tab shows every action invocation with success/failure indicators.\n\n## 11. Agent Workflow Pattern\n\nThe canonical agent loop — two calls:\n\n```python\nimport httpx\n\nBASE = \"https://sync.parc.land\"\nROOM = \"my-room\"\n\n# Join with inline state\nr = httpx.post(f\"{BASE}/rooms/{ROOM}/agents\", json={\n \"id\": \"worker-1\", \"name\": \"Worker 1\", \"role\": \"worker\",\n \"state\": {\"status\": \"idle\"},\n \"public_keys\": [\"status\"]\n})\nTOKEN = r.json()[\"token\"]\nHEADERS = {\"Authorization\": f\"Bearer {TOKEN}\"}\n\nwhile True:\n # Wait for something to happen (blocks, returns full context)\n r = httpx.get(\n f\"{BASE}/rooms/{ROOM}/wait\",\n params={\"condition\": \"messages.unread > 0 || state._shared.phase != \\\"idle\\\"\"},\n headers=HEADERS, timeout=30\n )\n ctx = r.json().get(\"context\", {})\n\n # Read what happened from context\n messages = ctx.get(\"messages\", {}).get(\"recent\", [])\n actions = ctx.get(\"actions\", {})\n state = ctx.get(\"state\", {})\n\n # Act on what you see\n for msg in messages:\n if msg.get(\"kind\") == \"task\":\n # Invoke a custom action\n httpx.post(\n f\"{BASE}/rooms/{ROOM}/actions/claim_task/invoke\",\n json={\"params\": {\"key\": msg[\"body\"]}},\n headers=HEADERS\n )\n\n # Update own status (via standard library \"update_status\" action, registered at startup)\n httpx.post(\n f\"{BASE}/rooms/{ROOM}/actions/update_status/invoke\",\n json={\"params\": {\"status\": \"working\"}},\n headers=HEADERS\n )\n```\n\n## 12. Dynamic Actions (Increment Templates + Dynamic Keys)\n\n```bash\n# Action with parameterized increment (template resolves to number)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"adjust_morale\",\n \"description\": \"Adjust team morale by a given amount\",\n \"params\": {\"amount\": {\"type\": \"number\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"morale\", \"increment\": \"${params.amount}\"}]\n }}'\n\n# Invoke: morale goes from 50 → 65\ncurl -X POST https://sync.parc.land/rooms/demo/actions/adjust_morale/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"amount\": 15}}'\n\n# Negative works too: morale 65 → 55\ncurl -X POST https://sync.parc.land/rooms/demo/actions/adjust_morale/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"amount\": -10}}'\n\n# Action with dynamic object keys (template in key position)\ncurl -X POST https://sync.parc.land/rooms/demo/actions/_register_action/invoke \\\n -H \"Authorization: Bearer room_abc123...\" \\\n -d '{\"params\": {\n \"id\": \"set_player_attr\",\n \"description\": \"Set an attribute on a player\",\n \"params\": {\"attr\": {\"type\": \"string\"}, \"val\": {\"type\": \"any\"}},\n \"writes\": [{\"scope\": \"_shared\", \"key\": \"players\", \"merge\": {\"${params.attr}\": \"${params.val}\"}}]\n }}'\n\n# Invoke: sets players.strength = \"high\"\ncurl -X POST https://sync.parc.land/rooms/demo/actions/set_player_attr/invoke \\\n -H \"Authorization: Bearer as_alice123...\" \\\n -d '{\"params\": {\"attr\": \"strength\", \"val\": \"high\"}}'\n```\n\n## 13. Compact Responses\n\nAdd `?compact=true` to any GET endpoint to strip null fields. Reduces payload ~40%.\n\n```bash\ncurl https://sync.parc.land/rooms/demo/context?compact=true \\\n -H \"Authorization: Bearer as_alice123...\"\n```\n",[],[406,857],"2d5e7454-195e-11f1-8a94-42dde27851f2","cel.md","e133ee16-1097-11f1-a64e-42dde27851f2",265,["D",1772802770302],"# CEL (Common Expression Language) Reference — sync v6\n\nCEL is used throughout sync for predicates, computed values, enabled expressions, and views.\n\n## Context Shape\n\nEvery CEL expression is evaluated against a context object. The shape depends on who is evaluating:\n\n### Agent Context (GET /context, /wait, POST /eval)\n\n```\n{\n state: {\n _shared: { phase: \"playing\", turn: 3 },\n _messages: { \"1\": { from: \"alice\", body: \"hi\" }, ... },\n self: { health: 80, inventory: [\"sword\"] } // own scope mapped to \"self\"\n },\n views: {\n \"alice-status\": \"healthy\",\n \"total-score\": 142\n },\n agents: {\n \"agent-a\": { name: \"Alice\", role: \"warrior\", status: \"active\" },\n \"agent-b\": { name: \"Bob\", role: \"healer\", status: \"waiting\" }\n },\n actions: {\n \"attack\": { available: true, enabled: true },\n \"heal\": { available: false, enabled: true }\n },\n messages: { count: 42, unread: 3, directed_unread: 1 },\n self: \"agent-a\",\n params: {}\n}\n```\n\n### Action/View Evaluation Context\n\nActions and views evaluate with the **registrar's** scope authority:\n- An action registered by `agent-a` can reference `state[\"agent-a\"]` in its `if` predicate\n- A view registered by `agent-a` can reference `state[\"agent-a\"]` in its `expr`\n- The platform loads the registrar's scope into the context for evaluation\n\n## Operators\n\n### Comparison\n```\n== != < <= > >=\n```\n\n### Logical\n```\n&& || !\n```\n\n### Arithmetic\n```\n+ - * / %\n```\n\n### Ternary\n```\ncondition ? value_if_true : value_if_false\n```\n\n### Membership\n```\n\"item\" in list // list contains\n\"key\" in map // map has key\n```\n\n### String\n```\nstring.contains(\"sub\")\nstring.startsWith(\"pre\")\nstring.endsWith(\"suf\")\nstring.size() // length\n```\n\n## Common Patterns\n\n### State Checks\n```cel\nstate._shared.phase == \"playing\"\nstate._shared.turn > 0\nstate.self.health > 0\n```\n\n### View References\n```cel\nviews[\"alice-status\"] == \"healthy\"\nviews[\"all-ready\"] == true\n```\n\n### Agent Checks\n```cel\nagents[\"agent-a\"].status == \"active\"\nagents[self].status == \"waiting\"\n```\n\n### Action Availability\n```cel\nactions[\"attack\"].available == true\n```\n\n### Message Tracking\n```cel\nmessages.unread > 0\nmessages.directed_unread > 0\nmessages.count >= 10\n```\n\n### Claiming / Ownership (in action predicates)\n```cel\n// Only claimable if not yet claimed\nstate._tasks[params.key].claimed_by == null\n\n// Only if self posted it\nstate._tasks[params.key].from == self\n```\n\n### Turn-Based Logic\n```cel\n// It's my turn\nstate._shared.current_player == self\n\n// Turn limit not reached\nstate._shared.turn < state._shared.max_turns\n```\n\n### Compound Conditions\n```cel\nstate._shared.phase == \"playing\"\n && agents[self].status == \"active\"\n && state.self.health > 0\n && actions[\"attack\"].available\n```\n\n## Where CEL is Used\n\n| Context | Field | Purpose |\n|---------|-------|---------|\n| State write | `if` | Write gate — must be true for write to proceed |\n| State entry | `enabled` | Entry visibility — hidden when false |\n| Action | `if` | Invocation gate — must be true to invoke |\n| Action | `enabled` | Action visibility — hidden when false |\n| Action write | `expr: true` on value | Compute value from expression |\n| View | `expr` | Compute projection from state |\n| View | `enabled` | View visibility — hidden when false |\n| Wait | `condition` | Block until true |\n| Eval | `expr` | Debug evaluation |\n\n## Parameter Substitution (Actions)\n\nInside action `writes`, values support template substitution:\n\n- `${self}` — invoking agent's ID\n- `${params.name}` — parameter value\n- `${now}` — ISO 8601 timestamp at invocation time\n\nSubstitution is **deep** — works inside nested objects and arrays:\n\n```json\n{\n \"value\": {\n \"from\": \"${self}\",\n \"claimed_at\": \"${now}\",\n \"data\": {\n \"items\": [\"${params.item}\"],\n \"metadata\": { \"author\": \"${self}\" }\n }\n }\n}\n```\n\nFor computed values, use `\"expr\": true` on the write entry:\n\n```json\n{\n \"value\": \"state._shared.turn + 1\",\n \"expr\": true\n}\n```\n\n## Notes\n\n- CEL returns typed values: strings, numbers, booleans, lists, maps\n- Division by zero and null access produce errors (expression fails)\n- Failed expressions in `enabled` contexts mean \"not enabled\" (hidden)\n- Failed expressions in `if` contexts mean \"precondition not met\" (409)\n- `bigint` results are automatically converted to numbers\n",[],[406,865],"eff961ea-1e45-11f1-bbdc-42dde27851f2","api.md","cd96bd98-1097-11f1-bb0b-42dde27851f2",530,["D",1773342115247],26,"# sync v7 API Reference\n\nBase URL: `https://sync.parc.land`\n\n## Auth Model\n\n**Unified tokens (v7):** All credentials are scoped tokens minted by a passkey-authenticated user. Token prefix: `tok_`. Scope string determines what the token can do.\n\n**Legacy tokens:** `room_`, `view_`, `as_` prefix tokens continue to work for backward compatibility.\n\n**Effective access** = `min(token.scope, user_rooms.role)`. A token can only narrow, never widen.\n\n---\n\n## Device Auth (RFC 8628)\n\n### POST /auth/device\nInitiate device authorization. Returns a device code for CLI polling and a user code for browser approval.\n\n```json\n// Request\n{ \"scope\": \"rooms:* create_rooms\", \"client_id\": \"my-cli\" }\n\n// Response 200\n{\n \"device_code\": \"dev_xxx\",\n \"user_code\": \"ABCD-1234\",\n \"verification_uri\": \"https://sync.parc.land/auth/device\",\n \"verification_uri_complete\": \"https://sync.parc.land/auth/device?code=ABCD-1234\",\n \"expires_in\": 900,\n \"interval\": 5\n}\n```\n\n### GET /auth/device?code=ABCD-1234\nBrowser approval page with WebAuthn passkey auth + consent UI (room picker, scope customization).\n\n### POST /auth/device/token\nCLI polls for token. Returns `authorization_pending` until user approves.\n\n```json\n// Request\n{ \"device_code\": \"dev_xxx\" }\n\n// Pending: 200 { \"error\": \"authorization_pending\" }\n// Denied: 403 { \"error\": \"access_denied\" }\n// Approved: 200\n{\n \"access_token\": \"tok_xxx\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600,\n \"refresh_token\": \"ref_xxx\",\n \"scope\": \"rooms:* create_rooms\"\n}\n```\n\n---\n\n## Scope Elevation\n\nWhen a `tok_` token attempts to access a room not in its scope, the `403` response includes a stateless elevation URL:\n\n```json\n{\n \"error\": \"scope_denied\",\n \"room\": \"kernel-ergonomics\",\n \"elevate\": \"https://sync.parc.land/auth/elevate?token_id=xxx&room=kernel-ergonomics\",\n \"hint\": \"Present the elevate URL to the user to request access, then retry.\"\n}\n```\n\n### GET /auth/elevate\nBrowser elevation page. Shows the requested room, access level picker (full/write/read), passkey auth, and approve/deny.\n\nQuery params: `token_id` (required), `room` (required), `level` (optional, default `full`).\n\n### POST /auth/elevate/approve\nServer-side endpoint called by the elevation page after passkey auth. Validates the user owns the token, has access to the room in `user_rooms`, and appends the scope. No new tables — the token's scope string is patched directly.\n\nThe MCP path surfaces the same URL in error messages, enabling agents to present it to users conversationally.\n\n---\n\n## Token Management\n\n### POST /tokens\nMint a scoped token. Requires authentication. Scope must not exceed the minting user's access.\n\n```json\n// Request\n{ \"scope\": \"rooms:my-room:agent:alice\", \"label\": \"Alice delegation\", \"expires_in\": 3600 }\n\n// Response 201\n{ \"id\": \"...\", \"token\": \"tok_xxx\", \"scope\": \"...\", \"expires_at\": \"...\" }\n```\n\n### GET /tokens\nList tokens minted by the authenticated user. Never exposes bearer strings.\n\n### PATCH /tokens/:id\nUpdate a token's scope or label. The new scope must not exceed the caller's actual access (user_rooms + authenticating token privileges). Both widening and narrowing are allowed within this bound.\n\n```json\n// Request — widen to add rooms\n{ \"scope\": \"rooms:cartographers rooms:demo create_rooms\", \"label\": \"Updated\" }\n\n// Response 200\n{ \"id\": \"...\", \"scope\": \"rooms:cartographers rooms:demo create_rooms\", \"previous_scope\": \"rooms:cartographers:read\", \"label\": \"Updated\" }\n```\n\nReturns `403 scope_exceeds_access` if the new scope includes rooms or privileges the caller doesn't have.\n\n**Room creation and scope:** When a `tok_` token with `create_rooms` scope creates a room, the system automatically appends `rooms:` to that token's scope. This means the creating token (and only that token) gains access to the room. Other tokens from the same user do not — the scope string is the single source of truth.\n\n### DELETE /tokens/:id\nRevoke a token. Must be minted by the authenticated user.\n\n### POST /tokens/refresh\nExchange a refresh token for a new access token.\n\n```json\n{ \"refresh_token\": \"ref_xxx\" }\n→ { \"access_token\": \"tok_yyy\", \"refresh_token\": \"ref_yyy\", \"expires_in\": 3600 }\n```\n\n---\n\n## Rooms\n\n### POST /rooms\nCreate a room. If authenticated with a `tok_` token that has `create_rooms` scope, the room is auto-linked to your user as owner. Unauthenticated creation still works for backward compatibility.\n\n```json\n// Request\n{ \"id\": \"my-room\", \"meta\": { \"name\": \"My Room\" } }\n\n// Response 201\n{ \"id\": \"my-room\", \"created_at\": \"...\", \"meta\": \"{...}\", \"token\": \"room_...\", \"view_token\": \"view_...\" }\n```\n\n### GET /rooms\nList rooms visible to the authenticated token.\n\n### GET /rooms/:id\nGet room info.\n\n### POST /rooms/:id/invite\n**Requires owner access.** Invite a user to a room.\n\n```json\n{ \"username\": \"bob\", \"role\": \"collaborator\" }\n→ { \"invited\": true, \"username\": \"bob\", \"room\": \"my-room\", \"role\": \"collaborator\" }\n```\n\nRoles: `owner`, `collaborator`, `participant`, `observer`.\n\n### POST /rooms/:id/claim\nClaim an orphaned room (no owners in user_rooms). Any authenticated user can claim rooms with no existing users.\n\n```json\n{ \"label\": \"My Room\" }\n→ { \"claimed\": true, \"room\": \"my-room\", \"role\": \"owner\" }\n```\n\n### POST /rooms/:id/rotate-view-token\n**Requires admin access.** Regenerate the view token.\n\n### POST /rooms/:id/generate-view-token\n**Requires admin access.** Generate a view token for rooms that don't have one.\nReturns 409 if one already exists.\n\n---\n\n## Agents\n\n### POST /rooms/:id/agents\nJoin a room. Returns agent token.\n\n```json\n// Basic join\n{ \"id\": \"agent-a\", \"name\": \"Alice\", \"role\": \"warrior\" }\n\n// Join with private state and views (recommended)\n{ \"id\": \"agent-a\", \"name\": \"Alice\", \"role\": \"warrior\",\n \"state\": { \"health\": 100, \"inventory\": [\"sword\"] },\n \"public_keys\": [\"health\"],\n \"views\": [\n { \"id\": \"alice-combat\", \"expr\": \"state[\\\"alice\\\"][\\\"health\\\"] > 50 ? \\\"ready\\\" : \\\"wounded\\\"\" }\n ]}\n\n// Response 201\n{ \"id\": \"agent-a\", \"name\": \"Alice\", \"role\": \"warrior\", \"token\": \"as_...\", \"grants\": \"[]\", ... }\n```\n\n**Inline state:** `state` object writes key-value pairs to the agent's private scope.\n**public_keys:** Array of key names from `state` to auto-create views for (equivalent to `\"public\": true`).\n**Inline views:** Array of view definitions scoped to this agent. Each needs `id` and `expr`.\n\nRe-joining: provide existing agent token or room token in Authorization header.\n\n### PATCH /rooms/:id/agents/:agent-id\n**Requires room token.** Update agent grants, role, name, meta.\n\n```json\n{ \"grants\": [\"_shared\", \"_messages\"] }\n```\n\n---\n\n## Context (primary read endpoint)\n\n### GET /rooms/:id/context\nReturns everything an agent needs in one call: state, views, agents, actions\n(with descriptions and params), and messages (with bodies).\n\n**Query params:**\n- `only` — comma-separated sections: `state`, `views`, `agents`, `actions`, `messages`, or `state._shared`\n- `messages_after` — only messages with seq > N (for pagination)\n- `messages_limit` — max message bodies (default 50, max 200)\n\n```json\n// GET /rooms/my-room/context (as alice)\n{\n \"state\": {\n \"_shared\": { \"phase\": \"playing\", \"turn\": 3 },\n \"self\": { \"health\": 80, \"inventory\": [\"sword\", \"potion\"] }\n },\n \"views\": {\n \"alice.health\": 80,\n \"alice-combat\": \"ready\",\n \"bob.health\": 65\n },\n \"agents\": {\n \"alice\": { \"name\": \"Alice\", \"role\": \"warrior\", \"status\": \"active\" },\n \"bob\": { \"name\": \"Bob\", \"role\": \"healer\", \"status\": \"waiting\" }\n },\n \"actions\": {\n \"attack\": {\n \"available\": true, \"enabled\": true,\n \"description\": \"Attack a target\",\n \"params\": { \"target\": { \"type\": \"string\", \"enum\": [\"goblin\", \"dragon\"] } },\n \"writes\": [{ \"scope\": \"_shared\", \"key\": \"last_attack\", \"value\": { \"by\": \"${self}\", \"target\": \"${params.target}\" } }]\n },\n \"_send_message\": {\n \"available\": true, \"enabled\": true, \"builtin\": true,\n \"description\": \"Send a message to the room\",\n \"params\": { \"body\": { \"type\": \"string\" }, \"kind\": { \"type\": \"string\" } }\n }\n },\n \"messages\": {\n \"count\": 12, \"unread\": 3, \"directed_unread\": 1,\n \"recent\": [\n { \"seq\": 10, \"from\": \"alice\", \"kind\": \"chat\", \"body\": \"hello\" },\n { \"seq\": 11, \"from\": \"bob\", \"to\": [\"alice\"], \"kind\": \"negotiation\", \"body\": \"...\" },\n { \"seq\": 12, \"from\": \"alice\", \"kind\": \"chat\", \"body\": \"thanks\" }\n ]\n },\n \"_context\": { \"depth\": \"lean\", \"help\": [] },\n \"self\": \"alice\"\n}\n```\n\n**Scope privacy:** Agent tokens see system scopes + own scope (as `self`) + view projections.\nRoom and view tokens see all scopes. Bob cannot see Alice's raw state — only her view projections.\n\n**Action writes in context:** Custom actions include their `writes` templates in the context\nresponse, letting agents inspect what an action will do before invoking it.\n\nReading context updates `last_seen_seq`, marking messages as read.\n\n### GET /rooms/:id/poll\nDashboard-optimized bundle. Returns agents, state, messages, actions, views, and audit log.\nUnlike `/context`, returns raw row data suitable for debugging UIs.\n\n**Query params:**\n- `messages_limit` — max messages (default 500, max 2000)\n- `audit_limit` — max audit entries (default 500, max 2000)\n\nState tab excludes `_messages` and `_audit` scopes (those have dedicated sections).\n\n---\n\n## Wait\n\n### GET /rooms/:id/wait\nBlock until a CEL condition becomes true. Returns full context by default.\n\n**Query params:**\n- `condition` — CEL expression (required)\n- `agent` — agent ID for status tracking (defaults to auth identity)\n- `timeout` — max wait ms (default/max 25000)\n- `include` — `context` (default) returns full context; or comma-separated: `state`, `agents`, `messages`, `actions`, `views`\n\n```\nGET /rooms/my-room/wait?condition=messages.unread>0\n→ { \"triggered\": true, \"condition\": \"...\", \"context\": { \"state\": {...}, \"views\": {...}, \"messages\": { \"recent\": [...] }, ... } }\n```\n\n---\n\n## Actions (the write endpoint)\n\n### POST /rooms/:id/actions/:action-id/invoke\nInvoke an action (user-registered or built-in). **Requires auth.**\n\n```json\n{ \"params\": { \"target\": \"goblin\" } }\n```\n\nThis is the only write endpoint. All state mutations, messages, registrations,\nand deletions flow through action invocation. Every invocation is logged to the\n`_audit` scope for traceability.\n\n**Built-in actions** are available in every room:\n\n| Action | Description | Key params |\n|--------|-------------|------------|\n| `_register_action` | Declare a write capability | `id`, `description`, `params`, `writes`, `if`, `enabled`, `result`, `scope` |\n| `_delete_action` | Remove an action | `id` |\n| `_register_view` | Declare a read capability | `id`, `expr`, `scope`, `description`, `render`, `enabled` |\n| `_delete_view` | Remove a view | `id` |\n| `_send_message` | Send a message | `body` (required), `kind` (default: \"chat\"), `to` (directed routing) |\n| `help` | Read guidance documents (overridable) | `key` |\n\nThere is no `_set_state`, `_heartbeat`, or `_renew_timer`. Agents write state by\nregistering actions with write templates, then invoking them. The standard library\n(`help({ key: \"standard_library\" })`) provides ready-to-register patterns for common\noperations like `set`, `delete`, `increment`, `append`, and more.\n\nBuilt-in actions appear in `/context` with `\"builtin\": true` and full param descriptions.\n\n**Overridable builtins:** The `help` action is a built-in that returns a participant guide\nwith API usage, available actions, and key concepts. Room creators can override it by\nregistering a custom action with `\"id\": \"help\"` — the custom version replaces the built-in\nin both context listing and invocation.\n\n**Registering custom actions** (via `_register_action`):\n\n```json\nPOST /rooms/my-room/actions/_register_action/invoke\n{ \"params\": {\n \"id\": \"attack\",\n \"description\": \"Attack a target\",\n \"params\": { \"target\": { \"type\": \"string\", \"enum\": [\"goblin\", \"dragon\"] } },\n \"if\": \"state._shared.phase == \\\"combat\\\"\",\n \"writes\": [\n { \"scope\": \"_shared\", \"key\": \"last_attack\", \"value\": { \"by\": \"${self}\", \"target\": \"${params.target}\", \"at\": \"${now}\" } }\n ]\n}}\n```\n\n**Custom action fields:**\n- `id` — unique within room (required)\n- `scope` — owner scope (default `_shared`). Scoped actions carry that agent's authority.\n- `description` — human-readable\n- `params` — parameter schema with `type` and optional `enum`\n- `writes` — array of state mutations (with `${self}`, `${params.x}`, `${now}` substitution in both values AND object keys)\n- `increment` in write templates supports templates: `\"increment\": \"${params.amount}\"` is resolved and coerced to number\n- `if` — CEL predicate gating execution\n- `enabled` — CEL expression gating visibility\n- `timer` — lifecycle timer\n- `on_invoke.timer` — cooldown timer applied after each invocation\n\n**State write modes** (in action write templates):\n- `value` — full replacement (default)\n- `merge` — deep merge into existing object (null values delete keys)\n- `increment` — atomic counter increment (supports template: `\"increment\": \"${params.amount}\"`)\n- `append: true` — two modes: without `key`, creates log-row with auto sort_key; with `key`, does array-push (reads existing value, wraps as array, pushes new value)\n- `if_version` — CAS (compare-and-swap) using content hash\n- `timer` — attach lifecycle timer to state entry\n\n**Error responses:**\n- `409 action_cooldown` — action is in cooldown. Includes `available_at` or `ticks_remaining`.\n- `409 precondition_failed` — the action's `if` predicate evaluated to false.\n- `409 action_disabled` — the action's `enabled` expression is false.\n- `404 action_expired` — action's timer has permanently expired.\n- `403 scope_denied` — agent lacks authority over target scope.\n- `500 write_failed` — SQLite constraint or other write error. Returns `{ error, action, detail, writes_attempted }` for debugging.\n\n---\n\n## Audit Log\n\nEvery action invocation generates an entry in the `_audit` scope:\n\n```json\n{ \"ts\": \"2026-02-26T12:55:23Z\", \"agent\": \"alice\", \"action\": \"submit_result\",\n \"builtin\": false, \"params\": { \"result\": \"42\" }, \"ok\": true }\n```\n\nEntries capture: timestamp, agent identity (or \"admin\" for room token), action name,\nwhether it's a builtin, parameters passed, and success/failure status. Failed\ninvocations (scope denials, precondition failures) are logged with `\"ok\": false`.\n\nVisible in the dashboard Audit tab and via `/poll` response's `audit` array.\n\n---\n\n## CEL Eval\n\n### POST /rooms/:id/eval\nEvaluate a CEL expression for debugging.\n\n```json\n{ \"expr\": \"state._shared.phase == \\\"playing\\\" && messages.unread > 0\" }\n```\n\n---\n\n## Scope Conventions\n\n| Scope | Mode | Purpose |\n|-------|------|---------|\n| `_shared` | mutable | Communal game/room state |\n| `_messages` | append | Communication log |\n| `_audit` | append | Action invocation log (auto-generated) |\n| `{agent-id}` | mutable | Private agent state |\n\n## Authority Model\n\n| Identity | Default Scope | Can Read | Can Write |\n|----------|--------------|----------|-----------|\n| Room token | `*` | Everything | Everything |\n| View token | — | Everything | Nothing (read-only) |\n| Agent (default) | own scope | System scopes + own scope | Own scope only |\n| Agent (granted) | own + grants | System scopes + own + grants | Own scope + granted scopes |\n| Via action | registrar's | — | Action's defined writes |\n\nUnprivileged agents register actions with write templates scoped to their own\nnamespace, or invoke custom actions registered by other agents that bridge scope\nauthority. The standard library provides canonical patterns: `help({ key: \"standard_library\" })`.\n",[],[406,873],["D",1771837914069],[539,540,541,542,543,544,545,546,547,548],[406],"debc4d12-1ad9-11f1-b21b-42dde27851f2","webauthn.ts","debc4d8a-1ad9-11f1-b21b-42dde27851f2",["D",1772965847190],"/**\n * webauthn.ts — WebAuthn passkey registration and authentication handlers.\n *\n * Uses @simplewebauthn/server for passkey crypto.\n * Separated from OAuth because these are a distinct authentication mechanism.\n */\n\nimport {\n generateAuthenticationOptions,\n generateRegistrationOptions,\n verifyAuthenticationResponse,\n verifyRegistrationResponse,\n} from \"npm:@simplewebauthn/server@13\";\nimport type {\n AuthenticatorTransportFuture,\n} from \"npm:@simplewebauthn/server@13\";\n\nimport * as db from \"./db.ts\";\n\n// ─── Configuration ───────────────────────────────────────────────\n\nconst RP_NAME = \"sync-mcp\";\nconst STABLE_RP_ID = Deno.env.get(\"WEBAUTHN_RP_ID\") ?? \"parc.land\";\n\nfunction getOrigin(req: Request): string {\n const url = new URL(req.url);\n return `${url.protocol}//${url.host}`;\n}\n\nexport function getRpId(req: Request): string {\n const hostname = new URL(req.url).hostname;\n if (hostname === STABLE_RP_ID || hostname.endsWith(\".\" + STABLE_RP_ID)) {\n return STABLE_RP_ID;\n }\n return hostname;\n}\n\nfunction json(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n \"Cache-Control\": \"no-store\",\n },\n });\n}\n\n// ─── WebAuthn: Registration Options ──────────────────────────────\n\nexport async function handleRegisterOptions(req: Request): Promise {\n const { username } = await req.json();\n if (\n !username || typeof username !== \"string\" || username.length < 1 ||\n username.length > 64\n ) {\n return json({ error: \"Username required (1-64 chars)\" }, 400);\n }\n\n const existing = await db.getUserByUsername(username);\n if (existing) {\n return json(\n { error: \"Username already taken. Try signing in instead.\" },\n 409,\n );\n }\n\n const userId = db.generateId();\n const rpId = getRpId(req);\n\n const options = await generateRegistrationOptions({\n rpName: RP_NAME,\n rpID: rpId,\n userName: username,\n userID: new TextEncoder().encode(userId),\n attestationType: \"none\",\n authenticatorSelection: {\n residentKey: \"preferred\",\n userVerification: \"preferred\",\n },\n });\n\n const challengeId = db.generateId();\n await db.saveChallenge(\n challengeId,\n options.challenge,\n \"registration\",\n userId,\n );\n\n return json({\n options,\n challengeId,\n userId,\n username,\n });\n}\n\n// ─── WebAuthn: Registration Verify ───────────────────────────────\n\nexport async function handleRegisterVerify(req: Request): Promise {\n const { challengeId, userId, username, response } = await req.json();\n\n const challenge = await db.getChallenge(challengeId);\n if (!challenge || challenge.type !== \"registration\") {\n return json({ error: \"Invalid or expired challenge\" }, 400);\n }\n\n const rpId = getRpId(req);\n const origin = getOrigin(req);\n\n try {\n const verification = await verifyRegistrationResponse({\n response,\n expectedChallenge: challenge.challenge,\n expectedOrigin: origin,\n expectedRPID: rpId,\n });\n\n if (!verification.verified || !verification.registrationInfo) {\n return json({ error: \"Verification failed\" }, 400);\n }\n\n const { credential, credentialDeviceType, credentialBackedUp } =\n verification.registrationInfo;\n\n await db.createUser(userId, username);\n\n await db.saveCredential({\n id: credential.id,\n userId,\n publicKey: credential.publicKey,\n counter: credential.counter,\n transports: credential.transports as string[],\n deviceType: credentialDeviceType,\n backedUp: credentialBackedUp,\n rpId: getRpId(req),\n });\n\n await db.deleteChallenge(challengeId);\n\n const sessionId = await db.createSession(userId);\n\n return json({ verified: true, sessionId });\n } catch (err) {\n return json(\n { error: `Registration failed: ${(err as Error).message}` },\n 400,\n );\n }\n}\n\n// ─── WebAuthn: Authentication Options ────────────────────────────\n\nexport async function handleAuthOptions(req: Request): Promise {\n const body = await req.json().catch(() => ({}));\n const rpId = getRpId(req);\n\n let allowCredentials: {\n id: string;\n transports?: AuthenticatorTransportFuture[];\n }[] | undefined;\n if (body.username) {\n const user = await db.getUserByUsername(body.username);\n if (user) {\n const creds = await db.getCredentialsByUserId(user.id, rpId);\n allowCredentials = creds.map((c) => ({\n id: c.id,\n transports: c.transports as AuthenticatorTransportFuture[] | undefined,\n }));\n }\n }\n\n const options = await generateAuthenticationOptions({\n rpID: rpId,\n userVerification: \"preferred\",\n allowCredentials,\n });\n\n const challengeId = db.generateId();\n await db.saveChallenge(challengeId, options.challenge, \"authentication\");\n\n return json({ options, challengeId });\n}\n\n// ─── WebAuthn: Authentication Verify ─────────────────────────────\n\nexport async function handleAuthVerify(req: Request): Promise {\n const { challengeId, response } = await req.json();\n\n const challenge = await db.getChallenge(challengeId);\n if (!challenge || challenge.type !== \"authentication\") {\n return json({ error: \"Invalid or expired challenge\" }, 400);\n }\n\n const credential = await db.getCredentialById(response.id);\n if (!credential) {\n return json({ error: \"Unknown credential\" }, 400);\n }\n\n const rpId = getRpId(req);\n const origin = getOrigin(req);\n\n try {\n const verification = await verifyAuthenticationResponse({\n response,\n expectedChallenge: challenge.challenge,\n expectedOrigin: origin,\n expectedRPID: rpId,\n credential: {\n id: credential.id,\n publicKey: credential.publicKey,\n counter: credential.counter,\n transports: credential.transports as\n | AuthenticatorTransportFuture[]\n | undefined,\n },\n });\n\n if (!verification.verified) {\n return json({ error: \"Authentication failed\" }, 400);\n }\n\n await db.updateCredentialCounter(\n credential.id,\n verification.authenticationInfo.newCounter,\n );\n await db.deleteChallenge(challengeId);\n\n const sessionId = await db.createSession(credential.userId);\n\n return json({ verified: true, sessionId });\n } catch (err) {\n return json({ error: `Auth failed: ${(err as Error).message}` }, 400);\n }\n}\n",[],[412,885],"8073dc00-1e50-11f1-adda-42dde27851f2","vault.ts","debc39b2-1ad9-11f1-b21b-42dde27851f2",549,["D",1773346652631],"/**\n * vault.ts — Legacy token resolution helper.\n *\n * v7: The vault API and vault CRUD have been removed.\n * This file retains only `resolveToken` which is used by the legacy\n * tool fallback path in tool-context.ts for explicit token params.\n *\n * Will be fully removed once all tools migrate to resolveForRoom.\n */\n\n/**\n * Resolve room + token for legacy tool calls that pass explicit params.\n * No vault lookup — just passthrough for explicit room+token pairs.\n */\nexport async function resolveToken(\n userId: string | null,\n room?: string,\n token?: string,\n): Promise<{ room: string; token: string } | null> {\n // Explicit token always wins (only remaining use case)\n if (room && token) return { room, token };\n return null;\n}\n",[],[412,892],"b1649e7e-21e0-11f1-97dd-42dde27851f2","tools.ts","9f51a29a-18a3-11f1-b05e-42dde27851f2",638,["D",1773738435759],11,"/**\n * tools.ts — MCP tool definitions for sync-mcp\n *\n * v3: Agency & Identity model.\n * - New ToolContext with resolveForRoom (session-aware, embodiment-aware)\n * - Observe/embody split: read_context is view-level by default, mutations require embodiment\n * - New tools: sync_lobby, sync_embody, sync_disembody, sync_restrict_scope, sync_revoke_access\n * - Context decoration: _session block + _current/_switchable agent annotations\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { rows2objects } from \"../utils.ts\";\nimport {\n buildExpandedContext,\n createRoom,\n joinRoom,\n invokeAction,\n invokeBuiltinAction,\n registerAction,\n registerView,\n deleteAction,\n deleteView,\n evalExpression,\n listRooms,\n insertAgentDirect,\n waitForCondition,\n type ContextRequest,\n} from \"../main.ts\";\n\nimport {\n resolveAuthFromToken,\n resolveAgentAuth,\n generateToken,\n hashToken,\n type AuthResult,\n} from \"../auth.ts\";\n\nimport { releaseAgent, fetchRoomRoles } from \"../agents.ts\";\nimport { migrate } from \"../schema.ts\";\n\nimport * as db from \"./db.ts\";\nimport {\n type ParsedScope,\n parseScope,\n serializeScope,\n checkRoomInScope,\n} from \"./scope.ts\";\n\nimport {\n type ToolContext,\n type ToolDef,\n tokenToAuth,\n resolveForTool,\n unwrap,\n withResponseEscalation,\n decorateContextWithSession,\n} from \"./tool-context.ts\";\n\n// Re-export for mcp.ts\nexport type { ToolContext, ToolDef };\n\n// ─── Ensure schema on first tool call ────────────────────────────\n\nlet migrated = false;\nasync function ensureMigrated() {\n if (!migrated) { await migrate(); migrated = true; }\n}\n\n// ─── Tool Definitions ────────────────────────────────────────────\n\nexport const TOOLS: ToolDef[] = [\n // ═══════════════════════════════════════════════════════════════\n // NEW: Agency & Identity tools\n // ═══════════════════════════════════════════════════════════════\n\n {\n name: \"sync_lobby\",\n title: \"Lobby\",\n description: `Overview of your rooms, agents, and roles. The starting point.\n\nReturns rooms you have access to, with agents, roles, access levels,\nand current embodiments. Agents are annotated with _current and _switchable.\n\nThis is observation — no agent presence is created.`,\n inputSchema: { type: \"object\", properties: {} },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(_params, ctx) {\n if (!ctx.userId) throw new Error(\"OAuth required\");\n await ensureMigrated();\n\n const userRooms = await db.listUserRooms(ctx.userId);\n const embodiments = ctx.sessionHash\n ? await db.listEmbodiments(ctx.sessionHash) : [];\n\n const rooms = [];\n for (const ur of userRooms) {\n // Check scope allows this room — wildcard grants access to all\n if (ctx.scope && ctx.scope.rooms.size > 0 && !ctx.scope.wildcardRooms) {\n if (!ctx.scope.rooms.has(ur.roomId)) continue;\n }\n\n // Fetch room agents\n const agentsResult = await sqlite.execute({\n sql: `SELECT id, name, role, status, last_heartbeat, waiting_on\n FROM agents WHERE room_id = ? ORDER BY joined_at`,\n args: [ur.roomId],\n });\n const agents = rows2objects(agentsResult);\n\n // Fetch role definitions\n const roles = await fetchRoomRoles(ur.roomId);\n\n const currentEmbodiment = embodiments.find(e => e.roomId === ur.roomId);\n const canEmbody = ur.access !== \"observer\";\n\n const switchableAgents = canEmbody ? agents.filter((a: any) => {\n if (a.id === currentEmbodiment?.agentId) return false;\n return a.status === \"idle\" || a.status === \"done\";\n }).map((a: any) => a.id as string) : [];\n\n const unfilledRoles = Object.entries(roles)\n .filter(([_, def]) => !def.filled_by)\n .map(([id]) => id)\n .filter(id => !switchableAgents.includes(id));\n\n const scopeLevel = ctx.scope?.rooms.get(ur.roomId);\n\n rooms.push({\n id: ur.roomId,\n access: ur.access,\n label: ur.label,\n scope_level: scopeLevel\n ? (scopeLevel.level === \"role\" ? `role:${scopeLevel.role}` : scopeLevel.level)\n : \"full\",\n roles,\n agents: agents.map((a: any) => ({\n id: a.id, name: a.name, role: a.role, status: a.status,\n last_heartbeat: a.last_heartbeat, waiting_on: a.waiting_on,\n _current: currentEmbodiment?.agentId === a.id,\n _switchable: canEmbody && (a.status === \"idle\" || a.status === \"done\") && a.id !== currentEmbodiment?.agentId,\n })),\n unfilled_roles: unfilledRoles,\n embodied_as: currentEmbodiment?.agentId ?? null,\n });\n }\n\n return {\n user: (await db.getUserById(ctx.userId))?.username ?? ctx.userId,\n client: ctx.clientId,\n rooms,\n can_create_rooms: ctx.scope?.createRooms ?? true,\n active_embodiments: embodiments,\n };\n },\n },\n\n {\n name: \"sync_embody\",\n title: \"Embody Agent\",\n description: `Commit to an agent in a room. Creates, takes over, or switches agents.\n\nSwitching: if already embodied in this room, the old agent is cleanly\nreleased (set idle, filled_by cleared) before the new one activates.\nAlways returns fresh context as the new agent.\n\nOne session can embody agents in multiple rooms simultaneously.\nOne agent per room per session — call sync_embody again to switch.\n\nArgs:\n - room (string, required): Room ID.\n - agent (string, optional): Existing agent ID to take over.\n - role (string, optional): Role to fill (creates/takes agent with role ID).\n - name (string, optional): Display name for new agent.\n - state (object, optional): Initial state for new agent.\n\nReturns: Full context with self set to embodied agent, plus _session metadata.`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\", description: \"Room ID\" },\n agent: { type: \"string\", description: \"Existing agent ID to take over\" },\n role: { type: \"string\", description: \"Role to fill\" },\n name: { type: \"string\", description: \"Display name for new agent\" },\n state: { type: \"object\", description: \"Initial state for new agent\" },\n },\n required: [\"room\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },\n async handler(params, ctx) {\n if (!ctx.userId || !ctx.sessionHash) throw new Error(\"OAuth required\");\n await ensureMigrated();\n\n const roomId = params.room as string;\n\n // 1. Scope check\n const requiredLevel = params.role ? \"embody_role\" as const : \"embody\" as const;\n const scopeCheck = checkRoomInScope(ctx.scope!, roomId, requiredLevel, params.role as string);\n if (!scopeCheck.allowed) throw new Error(`Scope denied: ${scopeCheck.reason}`);\n\n // 2. User-room access check\n const userRoom = await db.getUserRoom(ctx.userId, roomId);\n if (!userRoom) throw new Error(`No access to room ${roomId}. Use sync_lobby to see your rooms.`);\n if (userRoom.access === \"observer\") throw new Error(\"Observer access cannot embody agents\");\n\n // 3. Grants from access level\n const grants = (userRoom.access === \"owner\" || userRoom.access === \"collaborator\")\n ? [\"_shared\"] : [];\n\n // 4. Clean transition: release old agent if switching within this room\n const previousAgentId = await db.getEmbodiment(ctx.sessionHash, roomId);\n if (previousAgentId) {\n await releaseAgent(roomId, previousAgentId);\n }\n\n // 5. Determine agent ID\n let agentId: string;\n let isNewAgent = false;\n\n if (params.role) {\n agentId = params.role as string;\n // Verify role exists\n const roleState = await sqlite.execute({\n sql: `SELECT value FROM state WHERE room_id = ? AND scope = '_shared' AND key = ?`,\n args: [roomId, `roles.${agentId}`],\n });\n if (roleState.rows.length === 0) throw new Error(`Role \"${agentId}\" not defined in this room`);\n } else if (params.agent) {\n agentId = params.agent as string;\n const existing = await sqlite.execute({\n sql: `SELECT id FROM agents WHERE id = ? AND room_id = ?`,\n args: [agentId, roomId],\n });\n if (existing.rows.length === 0) throw new Error(`Agent \"${agentId}\" not found in room ${roomId}`);\n } else {\n // New agent — derive ID from user + client\n const user = await db.getUserById(ctx.userId);\n const username = user?.username ?? ctx.userId;\n const client = await db.getOAuthClient(ctx.clientId!);\n const clientSlug = (client?.clientName ?? \"mcp\")\n .toLowerCase().replace(/[^a-z0-9]/g, \"-\").replace(/-+/g, \"-\");\n agentId = `${username}:${clientSlug}`;\n isNewAgent = true;\n }\n\n // 6. Create or re-activate agent\n const existingAgent = await sqlite.execute({\n sql: `SELECT id FROM agents WHERE id = ? AND room_id = ?`,\n args: [agentId, roomId],\n });\n\n if (existingAgent.rows.length === 0 || isNewAgent) {\n const user = await db.getUserById(ctx.userId);\n await insertAgentDirect(roomId, {\n id: agentId,\n name: (params.name as string) ?? user?.username ?? \"agent\",\n role: params.role ? \"role\" : \"mcp-client\",\n grants,\n state: params.state as Record | undefined,\n });\n } else {\n // Re-activate: rotate token, reset status, reset grants\n const newToken = generateToken(\"as\");\n const newHash = await hashToken(newToken);\n await sqlite.execute({\n sql: `UPDATE agents SET token_hash = ?, status = 'active',\n last_heartbeat = datetime('now'), waiting_on = NULL, grants = ?\n WHERE id = ? AND room_id = ?`,\n args: [newHash, JSON.stringify(grants), agentId, roomId],\n });\n }\n\n // 7. Record embodiment\n await db.setEmbodiment(ctx.sessionHash, roomId, agentId);\n\n // 8. Update role filled_by if applicable\n if (params.role) {\n await sqlite.execute({\n sql: `UPDATE state SET\n value = json_set(value, '$.filled_by', json(?)),\n revision = revision + 1, updated_at = datetime('now')\n WHERE room_id = ? AND scope = '_shared' AND key = ?`,\n args: [JSON.stringify(agentId), roomId, `roles.${params.role}`],\n });\n }\n\n // 9. Return fresh context as the new agent\n const auth = await resolveAgentAuth(roomId, agentId);\n if (!auth) throw new Error(\"Failed to resolve agent auth after creation\");\n const context = await buildExpandedContext(roomId, auth, { depth: \"lean\" });\n\n // 10. Decorate with _session\n return decorateContextWithSession(context, ctx, roomId, agentId);\n },\n },\n\n {\n name: \"sync_disembody\",\n title: \"Disembody\",\n description: `Release an agent in a room. Agent persists as idle; you stop driving it.\n\nArgs:\n - room (string, required): Room to disembody from.\n\nReturns: Confirmation with disembodied agent ID.`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\", description: \"Room to disembody from\" },\n },\n required: [\"room\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n if (!ctx.sessionHash) throw new Error(\"OAuth required\");\n await ensureMigrated();\n const roomId = params.room as string;\n\n const agentId = await db.getEmbodiment(ctx.sessionHash, roomId);\n if (!agentId) throw new Error(`Not embodied in room ${roomId}`);\n\n // Clean transition\n await releaseAgent(roomId, agentId);\n\n await db.removeEmbodiment(ctx.sessionHash, roomId);\n return { ok: true, disembodied: agentId, room: roomId };\n },\n },\n\n {\n name: \"sync_restrict_scope\",\n title: \"Restrict Scope\",\n description: `Narrow your session's effective scope for a room.\n\nArgs:\n - room (string, required): Room ID.\n - level (string, required): \"observe\" or \"role\".\n - role (string, optional): Required when level is \"role\".`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n level: { type: \"string\", enum: [\"observe\", \"role\"] },\n role: { type: \"string\" },\n },\n required: [\"room\", \"level\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n if (!ctx.sessionHash || !ctx.scope) throw new Error(\"OAuth required\");\n const roomId = params.room as string;\n const level = params.level as string;\n const role = params.role as string | undefined;\n\n const newScope: ParsedScope = { rooms: new Map(ctx.scope.rooms), createRooms: ctx.scope.createRooms };\n if (level === \"observe\") {\n newScope.rooms.set(roomId, { level: \"observe\" });\n // Disembody if currently embodied\n const agentId = await db.getEmbodiment(ctx.sessionHash, roomId);\n if (agentId) {\n await releaseAgent(roomId, agentId);\n await db.removeEmbodiment(ctx.sessionHash, roomId);\n }\n } else if (level === \"role\") {\n if (!role) throw new Error(\"role parameter required when level is 'role'\");\n newScope.rooms.set(roomId, { level: \"role\", role });\n }\n await db.updateSessionScope(ctx.sessionHash, serializeScope(newScope));\n return { ok: true, room: roomId, level, role };\n },\n },\n\n {\n name: \"sync_revoke_access\",\n title: \"Revoke Room Access\",\n description: `Remove a room from your session's effective scope.\n\nArgs:\n - room (string, required): Room to remove.`,\n inputSchema: {\n type: \"object\",\n properties: { room: { type: \"string\" } },\n required: [\"room\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n if (!ctx.sessionHash || !ctx.scope) throw new Error(\"OAuth required\");\n const roomId = params.room as string;\n const agentId = await db.getEmbodiment(ctx.sessionHash, roomId);\n if (agentId) {\n await releaseAgent(roomId, agentId);\n await db.removeEmbodiment(ctx.sessionHash, roomId);\n }\n const newScope: ParsedScope = { rooms: new Map(ctx.scope.rooms), createRooms: ctx.scope.createRooms };\n newScope.rooms.delete(roomId);\n await db.updateSessionScope(ctx.sessionHash, serializeScope(newScope));\n return { ok: true, revoked: roomId };\n },\n },\n\n // ═══════════════════════════════════════════════════════════════\n // Room lifecycle\n // ═══════════════════════════════════════════════════════════════\n\n {\n name: \"sync_create_room\",\n title: \"Create Room\",\n description: `Create a new sync collaboration room. Returns the room ID, admin token, and view token.\n\nIf authenticated via OAuth, the room is registered in your user-rooms as owner\nand added to your session scope.\n\nArgs:\n - id (string, optional): Custom room ID. Auto-generated if omitted.\n - meta (object, optional): Arbitrary metadata for the room.\n - label (string, optional): Label for this room.\n - set_default (boolean, optional): Make this the default room.\n\nReturns: { id, token, view_token, created_at }`,\n inputSchema: {\n type: \"object\",\n properties: {\n id: { type: \"string\", description: \"Custom room ID (auto-generated if omitted)\" },\n meta: { type: \"object\", description: \"Room metadata (any JSON)\" },\n label: { type: \"string\", description: \"Label for this room\" },\n set_default: { type: \"boolean\", description: \"Make this the default room\" },\n },\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const body: Record = {};\n if (params.id) body.id = params.id;\n if (params.meta) body.meta = params.meta;\n const result = await unwrap(await createRoom(body)) as Record;\n\n // v7: rooms.ts handles user_rooms linkage when auth has userId.\n // No vault auto-store needed.\n if (ctx.userId && result.id) {\n await db.upsertUserRoom(\n ctx.userId, result.id as string, \"owner\",\n (params.label as string) ?? `Room ${result.id}`,\n params.set_default as boolean ?? false,\n );\n // Widen session scope\n if (ctx.sessionHash && ctx.scope) {\n const newScope: ParsedScope = { rooms: new Map(ctx.scope.rooms), createRooms: ctx.scope.createRooms, wildcardRooms: ctx.scope.wildcardRooms };\n newScope.rooms.set(result.id as string, { level: \"full\" });\n await db.updateSessionScope(ctx.sessionHash, serializeScope(newScope));\n }\n }\n return result;\n },\n },\n\n {\n name: \"sync_list_rooms\",\n title: \"List Rooms\",\n description: `List rooms accessible with the given token. If authenticated, uses vault token.\nPrefer sync_lobby for a richer overview with agents and roles.\n\nArgs:\n - token (string, optional): Auth token. Optional if authenticated.\n\nReturns: Array of room objects.`,\n inputSchema: {\n type: \"object\",\n properties: {\n token: { type: \"string\", description: \"Auth token (room_xxx, view_xxx, or as_xxx). Optional if authenticated.\" },\n },\n },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n if (!ctx.userId) throw new Error(\"Authentication required. Use sync_lobby for a richer view.\");\n // v7: Use user_rooms as source of truth\n const userRooms = await db.listUserRooms(ctx.userId);\n if (userRooms.length === 0) return [];\n const roomIds = userRooms.map(ur => ur.roomId);\n const placeholders = roomIds.map(() => \"?\").join(\",\");\n const result = await sqlite.execute({\n sql: `SELECT id, created_at, meta FROM rooms WHERE id IN (${placeholders}) ORDER BY created_at DESC`,\n args: roomIds,\n });\n return rows2objects(result);\n },\n },\n\n {\n name: \"sync_join_room\",\n title: \"Join Room\",\n description: `Join a sync room as an agent (low-level). Returns an agent token (as_xxx).\nPrefer sync_embody for the agency-identity flow.\n\nArgs: room, token (optional), id, name, role, state, public_keys, views.\n\nReturns: Agent object with { id, token, room_id, ... }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n id: { type: \"string\", description: \"Agent ID\" },\n name: { type: \"string\", description: \"Display name\" },\n role: { type: \"string\", description: \"Agent role\" },\n state: { type: \"object\", description: \"Initial private state\" },\n public_keys: { type: \"array\", items: { type: \"string\" }, description: \"State keys to auto-expose\" },\n views: { type: \"array\", items: { type: \"object\" }, description: \"Views to pre-register\" },\n },\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const resolved = await resolveForTool(ctx, params);\n const body: Record = {};\n for (const key of [\"id\", \"name\", \"role\", \"state\", \"public_keys\", \"views\"]) {\n if (params[key] !== undefined) body[key] = params[key];\n }\n const result = await withResponseEscalation(ctx, resolved.room, resolved.auth, async (auth) => {\n const req = new Request(\"http://internal/rooms/\" + resolved.room + \"/agents\", {\n headers: auth.kind === \"room\"\n ? { Authorization: `Bearer room_placeholder` }\n : { Authorization: `Bearer ${resolved.token}` },\n });\n return joinRoom(resolved.room, body, req);\n }) as Record;\n\n // v7: no vault auto-store. Agent tokens are returned to caller.\n return result;\n },\n },\n\n // ═══════════════════════════════════════════════════════════════\n // Core rhythm: read → act\n // ═══════════════════════════════════════════════════════════════\n\n {\n name: \"sync_read_context\",\n title: \"Read Context\",\n description: `THE primary read operation. Returns the room context with wrapped entries.\n\nEvery entry is { value, _meta: { score, revision, writer, via, velocity, ... } }.\nEntries are shaped by salience: high-score entries get full value + full _meta,\nlow-score entries are elided (value: null, _meta.elided: true, _meta.expand: \"...\").\n\nUse .value to access stored data, ._meta for provenance/trajectory/salience.\nDomain helpers: salient(), elided(), written_by(), focus(), keys(), entries().\n\nIf embodied: reads as agent (full scope, heartbeat). If not: observer (view-level).\n\nArgs:\n - room (string, required): Room ID.\n - token (string, optional): Auth token (legacy — prefer OAuth + embodiment).\n - depth: \"lean\" | \"full\" | \"usage\" — action detail level.\n - expand: comma-separated keys to force into Focus tier (e.g. \"_shared.key1\").\n - elision: \"none\" to disable elision entirely (return everything).\n - focus_threshold: score above which entries get full _meta (default: 0.5).\n - elide_threshold: score below which values are null (default: 0.1).\n - only, actions, messages, messages_after, messages_limit, include.\n\nReturns: { state, views, agents, actions, messages, self, _shaping }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\", description: \"Room ID\" },\n token: { type: \"string\", description: \"Auth token (legacy)\" },\n depth: { type: \"string\", enum: [\"lean\", \"full\", \"usage\"] },\n only: { type: \"string\" },\n actions: { type: \"boolean\" },\n messages: { type: \"boolean\" },\n messages_after: { type: \"number\" },\n messages_limit: { type: \"number\" },\n include: { type: \"string\" },\n expand: { type: \"string\", description: \"Comma-separated keys to force into Focus tier\" },\n elision: { type: \"string\", enum: [\"none\", \"auto\"], description: \"Set to 'none' to disable elision\" },\n focus_threshold: { type: \"number\", description: \"Score threshold for full _meta (default: 0.5)\" },\n elide_threshold: { type: \"number\", description: \"Score threshold below which values are elided (default: 0.1)\" },\n },\n required: [\"room\"],\n },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n // Build ContextRequest with v9 shaping params\n const ctxReq: ContextRequest = {};\n if (params.depth) ctxReq.depth = params.depth as \"lean\" | \"full\" | \"usage\";\n if (params.only) ctxReq.only = (params.only as string).split(\",\").map(s => s.trim());\n if (params.actions === false) ctxReq.actions = false;\n if (params.messages === false) ctxReq.messages = false;\n if (params.messages_after !== undefined) ctxReq.messagesAfter = params.messages_after as number;\n if (params.messages_limit !== undefined) ctxReq.messagesLimit = params.messages_limit as number;\n if (params.include) ctxReq.include = (params.include as string).split(\",\").map(s => s.trim());\n // v9 shaping\n if (params.expand) ctxReq.expand = (params.expand as string).split(\",\").map(s => s.trim());\n if (params.elision) ctxReq.elision = params.elision as \"none\" | \"auto\";\n if (params.focus_threshold !== undefined) ctxReq.focusThreshold = params.focus_threshold as number;\n if (params.elide_threshold !== undefined) ctxReq.elideThreshold = params.elide_threshold as number;\n\n // New path: session-aware resolution\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}. Use sync_lobby to see your rooms.`);\n\n const context = await buildExpandedContext(roomId, resolved.auth, ctxReq);\n return decorateContextWithSession(context, ctx, roomId, resolved.agentId);\n }\n\n // Legacy fallback: explicit token\n const resolved = await resolveForTool(ctx, params);\n return buildExpandedContext(resolved.room, resolved.auth, ctxReq);\n },\n },\n\n {\n name: \"sync_invoke_action\",\n title: \"Invoke Action\",\n description: `THE primary write operation. Invoke any action (built-in or custom) in a room.\n\nRequires embodiment — call sync_embody first if not yet embodied.\nReturns wrapped entries for written keys with _meta (score, writer, velocity,\ncontested) so the agent sees the structural consequences of its action.\n\nArgs:\n - room (string, required): Room ID.\n - token (string, optional): Auth token (legacy).\n - action (string, required): Action ID to invoke.\n - params (object, optional): Parameters for the action.\n\nReturns: { invoked, action, agent, params, writes: [{ scope, key, value, _meta }], result? }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n action: { type: \"string\", description: \"Action ID to invoke\" },\n params: { type: \"object\", description: \"Action parameters\" },\n },\n required: [\"room\", \"action\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n // New path: session-aware\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) {\n throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n }\n const body: Record = {};\n if (params.params) body.params = params.params;\n return unwrap(await invokeAction(roomId, params.action as string, body, resolved.auth));\n }\n\n // Legacy fallback\n const resolved = await resolveForTool(ctx, params);\n const body: Record = {};\n if (params.params) body.params = params.params;\n return unwrap(await invokeAction(resolved.room, params.action as string, body, resolved.auth));\n },\n },\n\n {\n name: \"sync_wait\",\n title: \"Wait for Condition\",\n description: `Block until a CEL condition becomes true, then return room context.\n\nArgs:\n - room (string, required): Room ID.\n - token (string, optional): Auth token (legacy).\n - condition (string, required): CEL expression.\n - timeout (number, optional): Max wait ms (default: 25000).\n - depth, only: Context shaping params.\n\nReturns: { triggered: true/false, condition, context }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n condition: { type: \"string\", description: \"CEL expression to wait for\" },\n timeout: { type: \"number\" },\n depth: { type: \"string\", enum: [\"lean\", \"full\", \"usage\"] },\n only: { type: \"string\" },\n },\n required: [\"room\", \"condition\"],\n },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n // Resolve auth (embodied or view-level)\n let auth: AuthResult;\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n auth = resolved.auth;\n } else {\n const resolved = await resolveForTool(ctx, params);\n auth = resolved.auth;\n }\n\n // Build URL for waitForCondition\n const url = new URL(`http://internal/rooms/${roomId}/wait`);\n url.searchParams.set(\"condition\", params.condition as string);\n if (params.timeout) url.searchParams.set(\"timeout\", String(params.timeout));\n if (params.depth) url.searchParams.set(\"depth\", params.depth as string);\n if (params.only) url.searchParams.set(\"only\", params.only as string);\n\n return unwrap(await waitForCondition(roomId, url, auth));\n },\n },\n\n // ═══════════════════════════════════════════════════════════════\n // Sugar for common built-in actions\n // ═══════════════════════════════════════════════════════════════\n\n {\n name: \"sync_register_action\",\n title: \"Register Action\",\n description: `Register a new action in a room. Requires embodiment.\n\nArgs: room (required), id (required), description, writes, params, scope, if, enabled, result, on_invoke.\n\nReturns: Saved action definition.`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n id: { type: \"string\", description: \"Action ID\" },\n description: { type: \"string\" },\n writes: { type: \"array\", items: { type: \"object\" }, description: \"Write templates\" },\n params: { type: \"object\", description: \"Parameter schema\" },\n scope: { type: \"string\" },\n \"if\": { type: \"string\", description: \"CEL precondition\" },\n enabled: { type: \"string\", description: \"CEL visibility gate\" },\n result: { type: \"string\", description: \"CEL result expression\" },\n on_invoke: { type: \"object\", description: \"Cooldown timer\" },\n },\n required: [\"room\", \"id\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n const actionBody: Record = {};\n for (const key of [\"id\", \"description\", \"writes\", \"params\", \"scope\", \"if\", \"enabled\", \"result\", \"on_invoke\"]) {\n if (params[key] !== undefined) actionBody[key] = params[key];\n }\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n return withResponseEscalation(ctx, roomId, resolved.auth, (auth) =>\n registerAction(roomId, actionBody, auth)\n );\n }\n\n const resolved = await resolveForTool(ctx, params);\n return withResponseEscalation(ctx, resolved.room, resolved.auth, (auth) =>\n registerAction(resolved.room, actionBody, auth)\n );\n },\n },\n\n {\n name: \"sync_register_view\",\n title: \"Register View\",\n description: `Register a computed view. Requires embodiment.\n\nArgs: room (required), id (required), expr (required), description, scope, enabled, render.\n\nReturns: View with current resolved value.`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n id: { type: \"string\" },\n expr: { type: \"string\" },\n description: { type: \"string\" },\n scope: { type: \"string\" },\n enabled: { type: \"string\" },\n render: { type: \"object\" },\n },\n required: [\"room\", \"id\", \"expr\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n const viewBody: Record = {};\n for (const key of [\"id\", \"expr\", \"description\", \"scope\", \"enabled\", \"render\"]) {\n if (params[key] !== undefined) viewBody[key] = params[key];\n }\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n return withResponseEscalation(ctx, roomId, resolved.auth, (auth) =>\n registerView(roomId, viewBody, auth)\n );\n }\n\n const resolved = await resolveForTool(ctx, params);\n return withResponseEscalation(ctx, resolved.room, resolved.auth, (auth) =>\n registerView(resolved.room, viewBody, auth)\n );\n },\n },\n\n {\n name: \"sync_send_message\",\n title: \"Send Message\",\n description: `Send a message to a sync room. Requires embodiment.\n\nArgs: room (required), body (required), kind, to.\n\nReturns: { ok, seq, from, kind }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n body: { type: \"string\", description: \"Message content\" },\n kind: { type: \"string\" },\n to: { type: \"string\", description: \"Direct to agent(s)\" },\n },\n required: [\"room\", \"body\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n const msgParams: Record = { body: params.body };\n if (params.kind) msgParams.kind = params.kind;\n if (params.to) msgParams.to = params.to;\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n return unwrap(await invokeBuiltinAction(roomId, \"_send_message\", { params: msgParams }, resolved.auth));\n }\n\n const resolved = await resolveForTool(ctx, params);\n return unwrap(await invokeBuiltinAction(resolved.room, \"_send_message\", { params: msgParams }, resolved.auth));\n },\n },\n\n {\n name: \"sync_help\",\n title: \"Get Help\",\n description: `Access the sync help system.\n\nArgs: room (required), key (optional).\n\nReturns: { content, version, source }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n key: { type: \"string\", description: \"Help key\" },\n },\n required: [\"room\"],\n },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n const helpParams: Record = {};\n if (params.key) helpParams.key = params.key;\n\n // Help works in observe mode — no embodiment required\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n return unwrap(await invokeBuiltinAction(roomId, \"help\", { params: helpParams }, resolved.auth));\n }\n\n const resolved = await resolveForTool(ctx, params);\n return unwrap(await invokeBuiltinAction(resolved.room, \"help\", { params: helpParams }, resolved.auth));\n },\n },\n\n {\n name: \"sync_eval_cel\",\n title: \"Evaluate CEL\",\n description: `Evaluate a CEL expression against the current room state.\n\nArgs: room (required), expr (required).\n\nReturns: { expression, value }`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n expr: { type: \"string\", description: \"CEL expression\" },\n },\n required: [\"room\", \"expr\"],\n },\n annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n return unwrap(await evalExpression(roomId, { expr: params.expr }, resolved.auth));\n }\n\n const resolved = await resolveForTool(ctx, params);\n return unwrap(await evalExpression(resolved.room, { expr: params.expr }, resolved.auth));\n },\n },\n\n {\n name: \"sync_delete_action\",\n title: \"Delete Action\",\n description: `Remove an action from a room. Requires embodiment.\n\nArgs: room (required), id (required).`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n id: { type: \"string\", description: \"Action ID to delete\" },\n },\n required: [\"room\", \"id\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n return unwrap(await deleteAction(roomId, params.id as string, resolved.auth));\n }\n\n const resolved = await resolveForTool(ctx, params);\n return unwrap(await deleteAction(resolved.room, params.id as string, resolved.auth));\n },\n },\n\n {\n name: \"sync_delete_view\",\n title: \"Delete View\",\n description: `Remove a view from a room. Requires embodiment.\n\nArgs: room (required), id (required).`,\n inputSchema: {\n type: \"object\",\n properties: {\n room: { type: \"string\" },\n token: { type: \"string\" },\n id: { type: \"string\", description: \"View ID to delete\" },\n },\n required: [\"room\", \"id\"],\n },\n annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },\n async handler(params, ctx) {\n await ensureMigrated();\n const roomId = params.room as string;\n\n if (ctx.resolveForRoom) {\n const resolved = await ctx.resolveForRoom(roomId);\n if (!resolved) throw new Error(`No access to room ${roomId}`);\n if (!resolved.agentId) throw new Error(`Not embodied in room ${roomId}. Call sync_embody first.`);\n return unwrap(await deleteView(roomId, params.id as string, resolved.auth));\n }\n\n const resolved = await resolveForTool(ctx, params);\n return unwrap(await deleteView(resolved.room, params.id as string, resolved.auth));\n },\n },\n\n // ═══════════════════════════════════════════════════════════════\n // Vault management — REMOVED in v7 (unified tokens replace vault)\n // Legacy vault tools have been removed. Use /tokens endpoints instead.\n // ═══════════════════════════════════════════════════════════════\n];\n",[],[412,900],"89de0034-21e0-11f1-9b94-42dde27851f2","tool-context.ts","debc196e-1ad9-11f1-b21b-42dde27851f2",637,["D",1773738369451],"/**\n * tool-context.ts — MCP tool infrastructure.\n *\n * Contains ToolContext and ToolDef interfaces, auth helpers for tool handlers,\n * and context decoration with session metadata. Separated from tools.ts\n * so tool implementations can import a focused set of infrastructure.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { rows2objects } from \"../utils.ts\";\nimport {\n resolveAuthFromToken,\n type AuthResult,\n} from \"../auth.ts\";\nimport * as db from \"./db.ts\";\nimport { type ParsedScope } from \"./scope.ts\";\n\n// ─── Tool context (injected by MCP handler) ─────────────────────\n\nexport interface ToolContext {\n userId: string | null;\n clientId: string | null;\n sessionHash: string | null;\n scope: ParsedScope | null;\n\n /** Resolve auth for a room, accounting for embodiment state.\n * Returns embodied agent's AuthResult (if embodied), or view-level\n * AuthResult (if observing), or null (no access). */\n resolveForRoom: (\n roomId: string,\n ) => Promise<{ auth: AuthResult; agentId: string | null } | null>;\n\n /** Legacy: explicit token override (backward compat for non-OAuth callers) */\n resolveToken: (\n room?: string, token?: string,\n ) => Promise<{ room: string; token: string } | null>;\n\n /** Admin-level auth for privilege escalation */\n resolveAdminAuth: (\n roomId: string,\n ) => Promise;\n}\n\n// ─── Tool definition ─────────────────────────────────────────────\n\nexport interface ToolDef {\n name: string;\n title: string;\n description: string;\n inputSchema: Record;\n annotations: {\n readOnlyHint: boolean;\n destructiveHint: boolean;\n idempotentHint: boolean;\n openWorldHint: boolean;\n };\n handler: (params: Record, ctx: ToolContext) => Promise;\n}\n\n// ─── Auth helpers ────────────────────────────────────────────────\n\n/** Convert a vault token string into an AuthResult for direct function calls. */\nexport async function tokenToAuth(token: string, roomId: string): Promise {\n const result = await resolveAuthFromToken(token, roomId);\n if (result instanceof Response) {\n const data = await result.json();\n throw new Error(data.error ?? data.message ?? \"Invalid token\");\n }\n return result;\n}\n\n/** Resolve vault → room + AuthResult for a tool call (legacy path). */\nexport async function resolveForTool(\n ctx: ToolContext,\n params: Record,\n): Promise<{ room: string; token: string; auth: AuthResult }> {\n const resolved = await ctx.resolveToken(\n params.room as string | undefined,\n params.token as string | undefined,\n );\n if (!resolved) {\n if (!ctx.userId) {\n throw new Error(\"Authentication required. Connect with OAuth or provide room + token parameters.\");\n }\n throw new Error(\"No room specified and no default room in vault. Provide 'room' parameter or set a default room via sync_vault_store.\");\n }\n const auth = await tokenToAuth(resolved.token, resolved.room);\n return { room: resolved.room, token: resolved.token, auth };\n}\n\n/** Unwrap a Response into data. Throws on error status with full structured detail. */\nexport async function unwrap(response: Response): Promise {\n const data = await response.json();\n if (response.status >= 400) {\n // Preserve full error body for MCP consumers — agents need hint, help, stage, source\n if (typeof data === \"object\" && data !== null) {\n const parts: string[] = [];\n if (data.error) parts.push(String(data.error));\n if (data.detail) parts.push(String(data.detail));\n if (data.hint) parts.push(`Hint: ${data.hint}`);\n if (data.help) parts.push(`Help: invoke help({ key: \"${data.help}\" })`);\n if (data.source) parts.push(`Source: ${data.source}`);\n if (data.stage) parts.push(`Stage: ${data.stage}`);\n if (data.field) parts.push(`Field: ${data.field}`);\n // Elevation URL for scope_denied\n if (data.elevate) parts.push(`Elevate: ${data.elevate}`);\n throw new Error(parts.join(\"\\n\"));\n }\n throw new Error(String(data));\n }\n return data;\n}\n\n/** Escalation wrapper for functions returning Response. */\nexport async function withResponseEscalation(\n ctx: ToolContext,\n room: string,\n agentAuth: AuthResult,\n fn: (auth: AuthResult) => Promise,\n): Promise {\n const response = await fn(agentAuth);\n if (response.status < 400) return response.json();\n\n const data = await response.json();\n const error = data?.error;\n const isScopeDenied = error === \"scope_denied\" || error === \"room_token_required\";\n\n if (!isScopeDenied) {\n // Preserve structured error for MCP consumers\n const parts: string[] = [];\n if (typeof error === \"string\") parts.push(error);\n if (data.detail) parts.push(String(data.detail));\n if (data.hint) parts.push(`Hint: ${data.hint}`);\n if (data.help) parts.push(`Help: invoke help({ key: \"${data.help}\" })`);\n if (data.stage) parts.push(`Stage: ${data.stage}`);\n throw new Error(parts.length > 0 ? parts.join(\"\\n\") : JSON.stringify(data));\n }\n\n const adminAuth = await ctx.resolveAdminAuth(room);\n if (!adminAuth) throw new Error(typeof error === \"string\" ? error : JSON.stringify(data));\n\n return unwrap(await fn(adminAuth));\n}\n\n// ─── Context decoration ─────────────────────────────────────────\n\n/** Decorate a context response with MCP session metadata.\n * Adds _session block + _current/_switchable annotations on agents.\n * This is MCP-layer only — buildExpandedContext stays session-unaware. */\nexport async function decorateContextWithSession(\n context: Record,\n ctx: ToolContext,\n roomId: string,\n currentAgentId: string | null,\n): Promise> {\n if (!ctx.sessionHash || !ctx.userId) return context;\n\n const userRoom = await db.getUserRoom(ctx.userId, roomId);\n const canEmbody = userRoom && userRoom.access !== \"observer\";\n\n const switchable: string[] = [];\n\n // Annotate agents in the agents section\n if (canEmbody && context.agents) {\n const agentsObj = context.agents;\n if (typeof agentsObj === \"object\" && !Array.isArray(agentsObj)) {\n for (const [agentId, agentData] of Object.entries(agentsObj as Record)) {\n const isCurrent = agentId === currentAgentId;\n const isIdle = agentData.status === \"idle\"\n || agentData.status === \"done\"\n || agentData.status === \"suspended\";\n agentData._current = isCurrent;\n agentData._switchable = !isCurrent && isIdle;\n if (agentData._switchable) switchable.push(agentId);\n }\n }\n }\n\n // Check for unfilled roles\n try {\n const rolesResult = await sqlite.execute({\n sql: `SELECT key, value FROM state\n WHERE room_id = ? AND scope = '_shared' AND key LIKE 'roles.%'`,\n args: [roomId],\n });\n for (const r of rolesResult.rows) {\n const roleId = (r[0] as string).replace(\"roles.\", \"\");\n try {\n const def = JSON.parse(r[1] as string);\n if (!def.filled_by && !switchable.includes(roleId)\n && roleId !== currentAgentId) {\n switchable.push(roleId);\n }\n } catch {}\n }\n } catch {}\n\n const scopeLevel = ctx.scope?.rooms.get(roomId);\n\n context._session = {\n agent: currentAgentId,\n room: roomId,\n switchable,\n scope_level: scopeLevel\n ? (scopeLevel.level === \"role\"\n ? `role:${scopeLevel.role}` : scopeLevel.level)\n : \"full\",\n };\n\n return context;\n}\n",[],[412,909],"c47a1b38-1e70-11f1-94d3-42dde27851f2","scope.ts","debc09c4-1ad9-11f1-b21b-42dde27851f2",555,["D",1773360510655],"/**\n * scope.ts — OAuth scope parsing and room-level access checking.\n *\n * v7: Extended scope language.\n * rooms:{id} Full access (up to user's role)\n * rooms:{id}:read Read-only\n * rooms:{id}:write Read + write\n * rooms:{id}:agent:{agent} Bound to specific agent (implies write)\n * rooms:{id}:admin Admin operations\n * rooms:{id}:observe Observe-only (backward compat)\n * rooms:* All rooms the user has access to\n * rooms:*:read All rooms, read-only\n * create_rooms Can create new rooms\n */\n\n// ─── Types ──────────────────────────────────────────────────────\n\nexport interface ParsedScope {\n rooms: Map;\n createRooms: boolean;\n /** If true, wildcard rooms:* was specified — applies to all rooms the user has access to */\n wildcardRooms: RoomScope | null;\n}\n\nexport type ScopeLevel = \"full\" | \"admin\" | \"write\" | \"read\" | \"observe\";\n\nexport interface RoomScope {\n level: ScopeLevel;\n agent?: string;\n /** Multiple agent bindings for the same room (rooms:X:agent:A rooms:X:agent:B) */\n agents?: string[];\n /** v5 compat: role-based scope */\n role?: string;\n}\n\n/** The role hierarchy, from most to least privileged. */\nconst LEVEL_ORDER: ScopeLevel[] = [\"full\", \"admin\", \"write\", \"read\", \"observe\"];\n\n/** Return the less privileged of two scope levels. */\nexport function minLevel(a: ScopeLevel, b: ScopeLevel): ScopeLevel {\n const ai = LEVEL_ORDER.indexOf(a);\n const bi = LEVEL_ORDER.indexOf(b);\n return ai >= bi ? a : b; // higher index = less privilege\n}\n\n/** Map user_rooms.role to a ScopeLevel for intersection. */\nexport function roleToLevel(role: string): ScopeLevel {\n switch (role) {\n case \"owner\": return \"full\";\n case \"collaborator\": return \"write\";\n case \"participant\": return \"write\";\n case \"observer\": return \"read\";\n default: return \"read\";\n }\n}\n\n/** Check if a scope level grants read access. */\nexport function canRead(level: ScopeLevel): boolean {\n return true; // all levels can read\n}\n\n/** Check if a scope level grants write access. */\nexport function canWrite(level: ScopeLevel): boolean {\n return level !== \"read\" && level !== \"observe\";\n}\n\n/** Check if a scope level grants admin access. */\nexport function canAdmin(level: ScopeLevel): boolean {\n return level === \"full\" || level === \"admin\";\n}\n\n// ─── Parsing ────────────────────────────────────────────────────\n\n/** Parse scope string into structured form. */\nexport function parseScope(scope: string): ParsedScope {\n const result: ParsedScope = { rooms: new Map(), createRooms: false, wildcardRooms: null };\n for (const part of scope.split(/\\s+/).filter(Boolean)) {\n if (part === \"create_rooms\") {\n result.createRooms = true;\n continue;\n }\n // Legacy: \"sync:rooms\" or \"sync:rooms.admin\" → broad access\n if (part === \"sync:rooms\" || part.startsWith(\"sync:\")) {\n result.wildcardRooms = { level: \"full\" };\n result.createRooms = true;\n continue;\n }\n if (!part.startsWith(\"rooms:\")) continue;\n\n const segments = part.split(\":\");\n const roomId = segments[1];\n if (!roomId) continue;\n\n // Wildcard: rooms:* or rooms:*:read etc.\n if (roomId === \"*\") {\n const modifier = segments[2];\n if (modifier === \"read\") {\n result.wildcardRooms = { level: \"read\" };\n } else if (modifier === \"write\") {\n result.wildcardRooms = { level: \"write\" };\n } else if (modifier === \"observe\") {\n result.wildcardRooms = { level: \"observe\" };\n } else {\n result.wildcardRooms = { level: \"full\" };\n }\n continue;\n }\n\n // Specific room\n const modifier = segments[2];\n if (modifier === \"read\") {\n result.rooms.set(roomId, { level: \"read\" });\n } else if (modifier === \"write\") {\n result.rooms.set(roomId, { level: \"write\" });\n } else if (modifier === \"admin\") {\n result.rooms.set(roomId, { level: \"admin\" });\n } else if (modifier === \"observe\") {\n result.rooms.set(roomId, { level: \"observe\" });\n } else if (modifier === \"agent\" && segments[3]) {\n const existing = result.rooms.get(roomId);\n if (existing?.agents) {\n // Accumulate: multiple agent bindings for same room\n existing.agents.push(segments[3]);\n } else if (existing?.agent) {\n // Second agent for this room — upgrade to agents array\n existing.agents = [existing.agent, segments[3]];\n } else {\n result.rooms.set(roomId, { level: \"write\", agent: segments[3], agents: [segments[3]] });\n }\n } else if (modifier === \"role\" && segments[3]) {\n // v5 backward compat\n result.rooms.set(roomId, { level: \"write\", role: segments[3] });\n } else {\n result.rooms.set(roomId, { level: \"full\" });\n }\n }\n return result;\n}\n\n/** Serialize a ParsedScope back to a scope string. */\nexport function serializeScope(parsed: ParsedScope): string {\n const parts: string[] = [];\n if (parsed.wildcardRooms) {\n if (parsed.wildcardRooms.level === \"full\") parts.push(\"rooms:*\");\n else parts.push(`rooms:*:${parsed.wildcardRooms.level}`);\n }\n for (const [roomId, scope] of parsed.rooms) {\n if (scope.agents && scope.agents.length > 0) {\n for (const agentId of scope.agents) {\n parts.push(`rooms:${roomId}:agent:${agentId}`);\n }\n } else if (scope.agent) {\n parts.push(`rooms:${roomId}:agent:${scope.agent}`);\n } else if (scope.role) {\n parts.push(`rooms:${roomId}:role:${scope.role}`);\n } else if (scope.level === \"full\") {\n parts.push(`rooms:${roomId}`);\n } else {\n parts.push(`rooms:${roomId}:${scope.level}`);\n }\n }\n if (parsed.createRooms) parts.push(\"create_rooms\");\n return parts.join(\" \");\n}\n\n// ─── Room Matching ──────────────────────────────────────────────\n\nexport interface RoomMatch {\n level: ScopeLevel;\n agentId: string | null;\n}\n\n/** Match a room against this scope. Returns the granted level, or null if no access.\n * When multiple agent bindings exist for the same room, agentId is null\n * (let embodiment decide which agent to act as). */\nexport function matchRoom(parsed: ParsedScope, roomId: string): RoomMatch | null {\n const specific = parsed.rooms.get(roomId);\n if (specific) {\n // Multiple agents → don't bind to one, let embodiment decide\n const agentId = (specific.agents && specific.agents.length > 1)\n ? null\n : specific.agent ?? null;\n return { level: specific.level, agentId };\n }\n if (parsed.wildcardRooms) {\n return { level: parsed.wildcardRooms.level, agentId: null };\n }\n if (parsed.rooms.size === 0 && !parsed.wildcardRooms) {\n return { level: \"full\", agentId: null };\n }\n return null;\n}\n\n// ─── Access Checking (backward compat) ──────────────────────────\n\n/** Check if level `have` is at least as privileged as `need`. */\nexport function levelCovers(have: ScopeLevel, need: ScopeLevel): boolean {\n return LEVEL_ORDER.indexOf(have) <= LEVEL_ORDER.indexOf(need);\n}\n\n/**\n * Check if `caller` scope fully subsumes `requested` scope.\n * A token can only mint/update sub-tokens within its own scope.\n *\n * Rules:\n * - requested.createRooms requires caller.createRooms\n * - requested wildcard requires caller wildcard at ≥ level\n * - each room in requested must be matched by caller (specific or wildcard) at ≥ level\n */\nexport function scopeSubsumes(\n caller: ParsedScope, requested: ParsedScope,\n): { ok: true } | { ok: false; reason: string } {\n // create_rooms check\n if (requested.createRooms && !caller.createRooms) {\n return { ok: false, reason: \"Caller token lacks create_rooms\" };\n }\n\n // Wildcard check\n if (requested.wildcardRooms) {\n if (!caller.wildcardRooms) {\n return { ok: false, reason: \"Caller token lacks wildcard room access\" };\n }\n if (!levelCovers(caller.wildcardRooms.level, requested.wildcardRooms.level)) {\n return {\n ok: false,\n reason: `Caller wildcard is ${caller.wildcardRooms.level}, cannot grant ${requested.wildcardRooms.level}`,\n };\n }\n }\n\n // Per-room check\n for (const [roomId, reqScope] of requested.rooms) {\n // Find caller's level for this room\n const callerSpecific = caller.rooms.get(roomId);\n const callerLevel = callerSpecific?.level\n ?? caller.wildcardRooms?.level\n ?? null;\n\n if (callerLevel === null) {\n // Caller has no access to this room at all (and no wildcard)\n // But: if caller has an empty scope (no rooms, no wildcard), it means\n // the scope was not restricted — treat as full (legacy backward compat)\n if (caller.rooms.size === 0 && !caller.wildcardRooms) {\n continue; // unrestricted caller\n }\n return { ok: false, reason: `Caller token lacks access to room \"${roomId}\"` };\n }\n\n if (!levelCovers(callerLevel, reqScope.level)) {\n return {\n ok: false,\n reason: `Caller has ${callerLevel} on room \"${roomId}\", cannot grant ${reqScope.level}`,\n };\n }\n }\n\n return { ok: true };\n}\n\n/** Check if a scope grants access to a room at the required level. */\nexport function checkRoomInScope(\n parsed: ParsedScope, roomId: string,\n requiredLevel: \"observe\" | \"embody\" | \"embody_role\",\n role?: string,\n): { allowed: boolean; reason?: string } {\n const match = matchRoom(parsed, roomId);\n\n // No match at all\n if (!match) {\n return { allowed: false, reason: \"room_not_in_scope\" };\n }\n\n if (requiredLevel === \"observe\") return { allowed: true };\n\n // observe/read can't embody\n if (match.level === \"observe\" || match.level === \"read\") {\n return { allowed: false, reason: \"scope_read_only\" };\n }\n\n if (requiredLevel === \"embody_role\") {\n const roomScope = parsed.rooms.get(roomId);\n if (roomScope?.role && roomScope.role !== role) {\n return { allowed: false, reason: \"scope_role_mismatch\" };\n }\n }\n\n return { allowed: true };\n}\n",[],[412,917],"c1602bc2-1df8-11f1-beba-42dde27851f2","oauth.ts","debbe16a-1ad9-11f1-b21b-42dde27851f2",463,["D",1773308965809],"/**\n * oauth.ts — OAuth 2.1 protocol handlers for sync-mcp.\n *\n * v7: Token exchange writes to unified `tokens` table.\n * New tokens use tok_ prefix. Old smcp_at_ tokens still work through\n * extractSession fallback in mcp.ts.\n *\n * Implements:\n * - Protected Resource Metadata (RFC 9728)\n * - Authorization Server Metadata (RFC 8414)\n * - Dynamic Client Registration (RFC 7591)\n * - Consent (exchange session for auth code)\n * - Token endpoint (authorization_code + refresh_token grants)\n */\n\nimport * as db from \"./db.ts\";\n\n// ─── Configuration ───────────────────────────────────────────────\n\nconst TOKEN_EXPIRY_SECS = 3600; // 1 hour access tokens\n\nfunction getOrigin(req: Request): string {\n const url = new URL(req.url);\n return `${url.protocol}//${url.host}`;\n}\n\nfunction json(\n data: unknown,\n status = 200,\n extraHeaders?: Record,\n): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n \"Cache-Control\": \"no-store\",\n ...extraHeaders,\n },\n });\n}\n\n// ─── Protected Resource Metadata ─────────────────────────────────\n\nexport function handlePRM(req: Request): Response {\n const origin = getOrigin(req);\n return json({\n resource: `${origin}/mcp`,\n authorization_servers: [origin],\n bearer_methods_supported: [\"header\"],\n resource_documentation: \"https://sync.parc.land\",\n });\n}\n\n// ─── Authorization Server Metadata ───────────────────────────────\n\nexport function handleASMetadata(req: Request): Response {\n const origin = getOrigin(req);\n return json({\n issuer: origin,\n authorization_endpoint: `${origin}/oauth/authorize`,\n token_endpoint: `${origin}/oauth/token`,\n registration_endpoint: `${origin}/oauth/register`,\n response_types_supported: [\"code\"],\n grant_types_supported: [\"authorization_code\", \"refresh_token\"],\n code_challenge_methods_supported: [\"S256\"],\n token_endpoint_auth_methods_supported: [\"client_secret_post\", \"none\"],\n scopes_supported: [\n \"sync:rooms\", \"create_rooms\",\n \"rooms:*\", \"rooms:*:read\",\n \"rooms:{room_id}\", \"rooms:{room_id}:read\", \"rooms:{room_id}:write\",\n \"rooms:{room_id}:agent:{agent_id}\", \"rooms:{room_id}:admin\",\n ],\n });\n}\n\n// ─── Dynamic Client Registration ─────────────────────────────────\n\nexport async function handleDCR(req: Request): Promise {\n const body = await req.json();\n const redirectUris = body.redirect_uris;\n if (\n !redirectUris || !Array.isArray(redirectUris) || redirectUris.length === 0\n ) {\n return json({\n error: \"invalid_client_metadata\",\n error_description: \"redirect_uris required\",\n }, 400);\n }\n\n const clientId = await db.generateToken(\"client\");\n const clientSecret = body.token_endpoint_auth_method === \"none\"\n ? undefined\n : await db.generateToken(\"secret\");\n\n await db.saveOAuthClient({\n clientId,\n clientSecret,\n redirectUris,\n clientName: body.client_name ?? null,\n });\n\n return json({\n client_id: clientId,\n client_secret: clientSecret,\n redirect_uris: redirectUris,\n client_name: body.client_name ?? null,\n token_endpoint_auth_method: clientSecret ? \"client_secret_post\" : \"none\",\n }, 201);\n}\n\n// ─── Consent (exchange session for auth code) ────────────────────\n\nexport async function handleConsent(req: Request): Promise {\n const body = await req.json();\n const {\n sessionId,\n clientId,\n redirectUri,\n codeChallenge,\n codeChallengeMethod,\n scope,\n state,\n resource,\n } = body;\n\n const session = await db.validateSession(sessionId);\n if (!session) {\n return json({ error: \"Invalid or expired session\" }, 401);\n }\n if (session.scope !== \"consent\") {\n return json({ error: \"Session not authorized for consent\" }, 403);\n }\n\n // Generate authorization code\n const code = await db.generateToken(\"authz\");\n await db.saveAuthCode({\n code,\n clientId,\n userId: session.userId,\n redirectUri,\n codeChallenge,\n codeChallengeMethod,\n scope,\n resource,\n });\n\n await db.deleteSession(sessionId);\n\n // Build redirect URL\n const redirect = new URL(redirectUri);\n redirect.searchParams.set(\"code\", code);\n if (state) redirect.searchParams.set(\"state\", state);\n\n return json({ redirect: redirect.toString() });\n}\n\n// ─── Token Endpoint ──────────────────────────────────────────────\n\nexport async function handleToken(req: Request): Promise {\n let body: Record;\n const contentType = req.headers.get(\"content-type\") ?? \"\";\n if (contentType.includes(\"application/x-www-form-urlencoded\")) {\n const text = await req.text();\n body = Object.fromEntries(new URLSearchParams(text));\n } else {\n body = await req.json();\n }\n\n const grantType = body.grant_type;\n\n if (grantType === \"authorization_code\") {\n return handleAuthCodeExchange(body);\n } else if (grantType === \"refresh_token\") {\n return handleRefreshExchange(body);\n }\n\n return json({ error: \"unsupported_grant_type\" }, 400);\n}\n\n// ─── Auth Code → Token (v7: writes to unified tokens table) ─────\n\nasync function handleAuthCodeExchange(\n body: Record,\n): Promise {\n const { code, redirect_uri, code_verifier, client_id } = body;\n\n if (!code || !redirect_uri || !code_verifier) {\n return json({\n error: \"invalid_request\",\n error_description: \"code, redirect_uri, code_verifier required\",\n }, 400);\n }\n\n const authCode = await db.consumeAuthCode(code);\n if (!authCode) {\n return json({\n error: \"invalid_grant\",\n error_description: \"Invalid, expired, or already-used code\",\n }, 400);\n }\n\n if (authCode.redirectUri !== redirect_uri) {\n return json({\n error: \"invalid_grant\",\n error_description: \"redirect_uri mismatch\",\n }, 400);\n }\n\n if (client_id && authCode.clientId !== client_id) {\n return json({\n error: \"invalid_grant\",\n error_description: \"client_id mismatch\",\n }, 400);\n }\n\n // Verify PKCE\n const expectedChallenge = await db.sha256(code_verifier);\n if (expectedChallenge !== authCode.codeChallenge) {\n return json({\n error: \"invalid_grant\",\n error_description: \"PKCE verification failed\",\n }, 400);\n }\n\n // v7: Mint unified token instead of writing to smcp_access_tokens / smcp_refresh_tokens\n const scope = authCode.scope ?? \"sync:rooms\";\n const result = await db.mintToken({\n userId: authCode.userId,\n scope,\n label: `OAuth: ${authCode.clientId}`,\n clientId: authCode.clientId,\n expiresInSec: TOKEN_EXPIRY_SECS,\n withRefresh: true,\n });\n\n return json({\n access_token: result.token,\n token_type: \"Bearer\",\n expires_in: TOKEN_EXPIRY_SECS,\n refresh_token: result.refreshToken,\n scope,\n });\n}\n\n// ─── Refresh Token → New Token (v7: handles both old and new) ───\n\nasync function handleRefreshExchange(\n body: Record,\n): Promise {\n const { refresh_token } = body;\n if (!refresh_token) {\n return json({ error: \"invalid_request\" }, 400);\n }\n\n // v7: Try unified tokens table first (ref_ prefix)\n if (refresh_token.startsWith(\"ref_\")) {\n const refreshHash = await db.sha256(refresh_token);\n const result = await db.refreshUnifiedToken(refreshHash, TOKEN_EXPIRY_SECS);\n if (!result) {\n return json({\n error: \"invalid_grant\",\n error_description: \"Invalid or expired refresh token\",\n }, 400);\n }\n return json({\n access_token: result.token,\n token_type: \"Bearer\",\n expires_in: TOKEN_EXPIRY_SECS,\n refresh_token: result.refreshToken,\n });\n }\n\n // Legacy: Try old smcp_refresh_tokens table (smcp_rt_ prefix)\n const rt = await db.consumeRefreshToken(refresh_token);\n if (!rt) {\n return json({\n error: \"invalid_grant\",\n error_description: \"Invalid or expired refresh token\",\n }, 400);\n }\n\n // Migrate: mint new unified token instead of old smcp_at_ + smcp_rt_\n const scope = rt.scope ?? \"sync:rooms\";\n const result = await db.mintToken({\n userId: rt.userId,\n scope,\n label: `OAuth refresh: ${rt.clientId}`,\n clientId: rt.clientId,\n expiresInSec: TOKEN_EXPIRY_SECS,\n withRefresh: true,\n });\n\n // Transfer embodiments from old session hashes to new token hash\n try {\n const newTokenHash = await db.sha256(result.token);\n const oldSessions = await db.findSessionsByUserClient(rt.userId, rt.clientId, newTokenHash);\n for (const oldHash of oldSessions) {\n await db.transferEmbodiments(oldHash, newTokenHash);\n await db.deleteUserSession(oldHash);\n }\n } catch (_) { /* best-effort */ }\n\n return json({\n access_token: result.token,\n token_type: \"Bearer\",\n expires_in: TOKEN_EXPIRY_SECS,\n refresh_token: result.refreshToken,\n scope,\n });\n}\n",[],[412,925],"ca25742c-1e45-11f1-9d1f-42dde27851f2","mcp.ts","9f516b54-18a3-11f1-b05e-42dde27851f2",527,["D",1773342051805],"/**\n * mcp.ts — sync-mcp HTTP router + MCP protocol handler\n *\n * v7 Phase 1: extractSession also checks unified tokens table for tok_ tokens.\n */\n\nimport {\n cleanupExpired, ensureSchema, validateAccessToken,\n getUserSession, createUserSession, getUserRoom, getEmbodiment,\n parseScope, checkRoomInScope,\n validateTokenByHash,\n type ParsedScope,\n} from \"./db.ts\";\nimport * as db from \"./db.ts\";\nimport {\n handleASMetadata,\n handleAuthOptions,\n handleAuthorize,\n handleAuthVerify,\n handleConsent,\n handleDCR,\n handleManageApi,\n handleManagePage,\n handlePRM,\n handleRecoverPage,\n handleRecoverRegisterOptions,\n handleRecoverRegisterVerify,\n handleRecoverValidate,\n handleRegisterOptions,\n handleRegisterVerify,\n handleToken,\n resolveToken,\n} from \"./auth.tsx\";\nimport {\n resolveAuthFromToken,\n resolveAgentAuth,\n type AuthResult,\n} from \"../auth.ts\";\nimport { type ToolContext, TOOLS } from \"./tools.ts\";\n\n// ─── Configuration ───────────────────────────────────────────────\n\nconst SERVER_NAME = \"sync-mcp-server\";\nconst SERVER_VERSION = \"3.1.0\";\nconst PROTOCOL_VERSION = \"2025-03-26\";\n\n// ─── Schema init (runs once per cold start) ──────────────────────\n\nlet schemaReady = false;\nasync function initSchema() {\n if (!schemaReady) {\n await ensureSchema();\n schemaReady = true;\n cleanupExpired().catch(() => {});\n db.cleanupDeviceCodes().catch(() => {});\n }\n}\n\n// ─── MCP Protocol (JSON-RPC 2.0) ────────────────────────────────\n\ninterface JsonRpcRequest {\n jsonrpc: \"2.0\";\n id?: string | number;\n method: string;\n params?: Record;\n}\n\ninterface JsonRpcResponse {\n jsonrpc: \"2.0\";\n id?: string | number | null;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n}\n\nfunction rpcResult(\n id: string | number | null | undefined,\n result: unknown,\n): JsonRpcResponse {\n return { jsonrpc: \"2.0\", id: id ?? null, result };\n}\n\nfunction rpcError(\n id: string | number | null | undefined,\n code: number,\n message: string,\n data?: unknown,\n): JsonRpcResponse {\n return {\n jsonrpc: \"2.0\",\n id: id ?? null,\n error: { code, message, ...(data !== undefined ? { data } : {}) },\n };\n}\n\nfunction toolsToSchema() {\n return TOOLS.map((t) => ({\n name: t.name,\n title: t.title,\n description: t.description,\n inputSchema: t.inputSchema,\n annotations: t.annotations,\n }));\n}\n\nasync function handleRpc(\n req: JsonRpcRequest,\n ctx: ToolContext,\n): Promise {\n const { method, id, params } = req;\n\n if (method === \"initialize\") {\n return rpcResult(id, {\n protocolVersion: PROTOCOL_VERSION,\n capabilities: { tools: {} },\n serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },\n });\n }\n\n if (method === \"notifications/initialized\" || method === \"ping\") {\n return rpcResult(id, {});\n }\n\n if (method === \"tools/list\") {\n return rpcResult(id, { tools: toolsToSchema() });\n }\n\n if (method === \"tools/call\") {\n const toolName = (params as any)?.name;\n const toolArgs = (params as any)?.arguments ?? {};\n\n const tool = TOOLS.find((t) => t.name === toolName);\n if (!tool) {\n return rpcError(id, -32602, `Unknown tool: ${toolName}`);\n }\n\n try {\n const result = await tool.handler(toolArgs, ctx);\n return rpcResult(id, {\n content: [\n {\n type: \"text\",\n text: typeof result === \"string\"\n ? result\n : JSON.stringify(result, null, 2),\n },\n ],\n });\n } catch (err: unknown) {\n const message = err instanceof Error ? err.message : String(err);\n return rpcResult(id, {\n content: [{ type: \"text\", text: `Error: ${message}` }],\n isError: true,\n });\n }\n }\n\n return rpcError(id, -32601, `Method not found: ${method}`);\n}\n\n// ─── Session extraction ──────────────────────────────────────────\n\ninterface SessionInfo {\n userId: string;\n clientId: string;\n tokenHash: string;\n scope: ParsedScope;\n}\n\nasync function extractSession(req: Request): Promise {\n const authHeader = req.headers.get(\"authorization\");\n if (!authHeader?.startsWith(\"Bearer \")) return null;\n\n const token = authHeader.substring(7);\n // Skip sync tokens (room_xxx, as_xxx, view_xxx) — those are per-call legacy\n if (\n token.startsWith(\"room_\") || token.startsWith(\"as_\") ||\n token.startsWith(\"view_\")\n ) return null;\n\n // ── v7: Check unified tokens table for tok_ tokens ──\n if (token.startsWith(\"tok_\")) {\n const tokenHash = await db.sha256(token);\n const tok = await validateTokenByHash(tokenHash);\n if (!tok) return null;\n return {\n userId: tok.mintedBy,\n clientId: tok.clientId ?? \"unified\",\n tokenHash,\n scope: parseScope(tok.scope),\n };\n }\n\n // ── Existing path: smcp_at_ tokens via smcp_access_tokens table ──\n const valid = await validateAccessToken(token);\n if (!valid) return null;\n\n const tokenHash = await db.sha256(token);\n\n let session = await getUserSession(tokenHash);\n if (!session) {\n try {\n await createUserSession({\n tokenHash,\n userId: valid.userId,\n clientId: valid.clientId,\n scope: valid.scope ?? \"sync:rooms\",\n expiresAt: valid.expiresAt,\n });\n session = await getUserSession(tokenHash);\n } catch (_) { /* race condition */ }\n if (!session) {\n return {\n userId: valid.userId,\n clientId: valid.clientId,\n tokenHash,\n scope: parseScope(valid.scope ?? \"sync:rooms\"),\n };\n }\n }\n\n return {\n userId: session.userId,\n clientId: session.clientId,\n tokenHash: session.tokenHash,\n scope: parseScope(session.scope),\n };\n}\n\n// ─── 401 Challenge ───────────────────────────────────────────────\n\nfunction unauthorizedResponse(req: Request): Response {\n const origin = new URL(req.url);\n const prmUrl =\n `${origin.protocol}//${origin.host}/.well-known/oauth-protected-resource`;\n return new Response(\n JSON.stringify({\n error: \"unauthorized\",\n error_description:\n \"OAuth Bearer token required. Complete the OAuth flow or use device auth to authenticate.\",\n }),\n {\n status: 401,\n headers: {\n ...CORS_HEADERS,\n \"Content-Type\": \"application/json\",\n \"WWW-Authenticate\": `Bearer resource_metadata=\"${prmUrl}\"`,\n },\n },\n );\n}\n\n// ─── CORS ────────────────────────────────────────────────────────\n\nconst CORS_HEADERS: Record = {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\":\n \"Content-Type, Authorization, Mcp-Session-Id, X-Session-Id\",\n};\n\nfunction corsJson(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: { ...CORS_HEADERS, \"Content-Type\": \"application/json\" },\n });\n}\n\n// ─── HTTP Router ─────────────────────────────────────────────────\n\nexport async function handleMcpRequest(req: Request): Promise {\n await initSchema();\n\n const url = new URL(req.url);\n const path = url.pathname;\n\n if (req.method === \"OPTIONS\") {\n return new Response(null, { headers: CORS_HEADERS });\n }\n\n // ── Well-Known ──\n if (req.method === \"GET\" && path === \"/.well-known/oauth-protected-resource\") {\n return handlePRM(req);\n }\n if (req.method === \"GET\" && path === \"/.well-known/oauth-authorization-server\") {\n return handleASMetadata(req);\n }\n\n // ── OAuth ──\n if (req.method === \"POST\" && path === \"/oauth/register\") return handleDCR(req);\n if (req.method === \"GET\" && path === \"/oauth/authorize\") return handleAuthorize(req);\n if (req.method === \"POST\" && path === \"/oauth/consent\") return handleConsent(req);\n if (req.method === \"POST\" && path === \"/oauth/token\") return handleToken(req);\n\n // ── WebAuthn ──\n if (req.method === \"POST\" && path === \"/webauthn/register/options\") return handleRegisterOptions(req);\n if (req.method === \"POST\" && path === \"/webauthn/register/verify\") return handleRegisterVerify(req);\n if (req.method === \"POST\" && path === \"/webauthn/authenticate/options\") return handleAuthOptions(req);\n if (req.method === \"POST\" && path === \"/webauthn/authenticate/verify\") return handleAuthVerify(req);\n\n // ── Management UI ──\n if (req.method === \"GET\" && path === \"/manage\") return handleManagePage(req);\n if (path.startsWith(\"/manage/api\")) return handleManageApi(req);\n\n // ── Recovery ──\n if (req.method === \"GET\" && path === \"/recover\") return handleRecoverPage(req);\n if (req.method === \"POST\" && path === \"/recover/validate\") return handleRecoverValidate(req);\n if (req.method === \"POST\" && path === \"/recover/register/options\") return handleRecoverRegisterOptions(req);\n if (req.method === \"POST\" && path === \"/recover/register/verify\") return handleRecoverRegisterVerify(req);\n\n // ── Vault API (REMOVED — legacy, kept as 410 for old clients) ──\n if (path.startsWith(\"/vault\")) {\n return corsJson({ error: \"vault_deprecated\", message: \"Vault has been replaced by unified tokens. Use /tokens endpoints.\" }, 410);\n }\n\n // ── MCP: DELETE ──\n if (req.method === \"DELETE\" && (path === \"/mcp\" || path === \"/\")) {\n return new Response(null, { status: 200, headers: CORS_HEADERS });\n }\n\n // ── MCP: GET (server info) ──\n if (req.method === \"GET\" && (path === \"/\" || path === \"/mcp\")) {\n return corsJson({\n name: SERVER_NAME,\n version: SERVER_VERSION,\n protocol: \"MCP\",\n protocolVersion: PROTOCOL_VERSION,\n transport: \"streamable-http\",\n auth: \"OAuth 2.1 + WebAuthn passkeys + Device Auth\",\n tools: TOOLS.map((t) => t.name),\n description:\n \"MCP server for sync — multi-agent coordination platform (https://sync.parc.land)\",\n endpoints: {\n mcp: \"POST /mcp (JSON-RPC 2.0, requires OAuth or device auth token)\",\n device_auth: \"POST /auth/device (initiate), GET /auth/device (approve), POST /auth/device/token (poll)\",\n tokens: \"POST /tokens (mint), GET /tokens (list), DELETE /tokens/:id (revoke)\",\n oauth_prm: \"GET /.well-known/oauth-protected-resource\",\n oauth_metadata: \"GET /.well-known/oauth-authorization-server\",\n oauth_register: \"POST /oauth/register\",\n oauth_authorize: \"GET /oauth/authorize\",\n oauth_token: \"POST /oauth/token\",\n },\n });\n }\n\n // ── MCP: POST (JSON-RPC — requires OAuth or unified token) ──\n if (req.method === \"POST\" && (path === \"/mcp\" || path === \"/\")) {\n const session = await extractSession(req);\n if (!session) return unauthorizedResponse(req);\n\n const ctx: ToolContext = {\n userId: session.userId,\n clientId: session.clientId,\n sessionHash: session.tokenHash,\n scope: session.scope,\n\n async resolveForRoom(roomId: string) {\n const scopeCheck = checkRoomInScope(session.scope, roomId, \"observe\");\n if (!scopeCheck.allowed) {\n // Surface elevation URL for scope_denied — agent can present to user\n const tokenResult = await db.validateTokenByHash(session.tokenHash);\n if (tokenResult) {\n const elevateUrl = `https://sync.parc.land/auth/elevate?token_id=${encodeURIComponent(tokenResult.id)}&room=${encodeURIComponent(roomId)}`;\n throw new Error(`scope_denied: Token scope does not include room \"${roomId}\". To request access, ask the user to open: ${elevateUrl}`);\n }\n return null;\n }\n\n // v7: user_rooms is the source of truth. No vault fallback.\n const userRoom = await getUserRoom(session.userId, roomId);\n if (!userRoom) return null;\n\n // Check for active embodiment in this room\n const embodiedAgentId = await getEmbodiment(session.tokenHash, roomId);\n if (embodiedAgentId) {\n const agentAuth = await resolveAgentAuth(roomId, embodiedAgentId);\n if (agentAuth) return { auth: agentAuth, agentId: embodiedAgentId };\n await db.removeEmbodiment(session.tokenHash, roomId);\n }\n\n // Not embodied — return access level based on user_rooms role\n const isOwner = userRoom.access === \"owner\";\n return {\n auth: {\n authenticated: true,\n kind: (isOwner ? \"room\" : \"view\") as \"room\" | \"view\",\n agentId: null,\n roomId,\n grants: isOwner ? [\"*\"] : [],\n userId: session.userId,\n },\n agentId: null,\n };\n },\n\n // Legacy resolver — kept for backward compat with old tool paths\n // that pass explicit token params. Will be removed in Phase 5.\n resolveToken: (room?: string, token?: string) =>\n resolveToken(session.userId, room, token),\n\n // v7: Admin auth from user_rooms owner role, no vault lookup needed\n async resolveAdminAuth(roomId: string) {\n const userRoom = await getUserRoom(session.userId, roomId);\n if (!userRoom || userRoom.access !== \"owner\") return null;\n // Construct admin AuthResult directly from ownership\n return {\n authenticated: true,\n kind: \"room\" as const,\n agentId: null,\n roomId,\n grants: [\"*\"],\n userId: session.userId,\n };\n },\n };\n\n let body: unknown;\n try {\n body = await req.json();\n } catch {\n return new Response(\n JSON.stringify(rpcError(null, -32700, \"Parse error\")),\n {\n status: 400,\n headers: { ...CORS_HEADERS, \"Content-Type\": \"application/json\" },\n },\n );\n }\n\n if (Array.isArray(body)) {\n const responses = await Promise.all(\n (body as JsonRpcRequest[]).map((r) => handleRpc(r, ctx)),\n );\n return new Response(JSON.stringify(responses), {\n headers: { ...CORS_HEADERS, \"Content-Type\": \"application/json\" },\n });\n }\n\n const response = await handleRpc(body as JsonRpcRequest, ctx);\n return new Response(JSON.stringify(response), {\n headers: { ...CORS_HEADERS, \"Content-Type\": \"application/json\" },\n });\n }\n\n return corsJson({ error: \"Not found. POST JSON-RPC to /mcp\" }, 404);\n}\n",[],[412,933],"c3519382-1e50-11f1-87b9-42dde27851f2","manage.tsx","debba470-1ad9-11f1-b21b-42dde27851f2",551,["D",1773346764813],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/**\n * manage.tsx — Management UI, authorize page, and recovery flow.\n *\n * Contains all endpoints that render JSX (SSR) or serve session-authenticated APIs:\n * - GET /oauth/authorize — Authorization page with WebAuthn\n * - GET /manage — Management dashboard\n * - GET/POST/DELETE /manage/api/* — Management REST API\n * - GET /recover — Recovery page\n * - POST /recover/* — Recovery API endpoints\n */\n\nimport {\n generateRegistrationOptions,\n verifyRegistrationResponse,\n} from \"npm:@simplewebauthn/server@13\";\nimport type {\n AuthenticatorTransportFuture,\n} from \"npm:@simplewebauthn/server@13\";\n\nimport * as db from \"./db.ts\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { renderPage } from \"../frontend/ssr.ts\";\nimport { RecoverPage } from \"../frontend/pages/recover/RecoverPage.tsx\";\nimport { ManagePage } from \"../frontend/pages/manage/ManagePage.tsx\";\nimport { AuthorizePage } from \"../frontend/pages/authorize/AuthorizePage.tsx\";\nimport { getRpId } from \"./webauthn.ts\";\nimport { fetchRoomRoles } from \"../agents.ts\";\n\n// ─── Helpers ─────────────────────────────────────────────────────\n\nfunction getOrigin(req: Request): string {\n const url = new URL(req.url);\n return `${url.protocol}//${url.host}`;\n}\n\n/** Compute the dashboard origin from the request.\n * If served from mcp.X, dashboard is at X. Otherwise same origin. */\nfunction getDashboardOrigin(req: Request): string {\n const url = new URL(req.url);\n const hostname = url.hostname;\n if (hostname.startsWith(\"mcp.\")) {\n return `${url.protocol}//${hostname.slice(4)}${url.port ? \":\" + url.port : \"\"}`;\n }\n return getOrigin(req);\n}\n\nfunction json(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n },\n });\n}\n\nfunction html(body: string, status = 200): Response {\n return new Response(body, {\n status,\n headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n });\n}\n\nconst ERROR_CSS = `*{box-sizing:border-box;margin:0;padding:0}body{font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",system-ui,sans-serif;background:#0d1117;color:#c9d1d9;min-height:100vh;display:flex;align-items:center;justify-content:center}.container{width:100%;max-width:420px;padding:1rem}.card{background:#161b22;border:1px solid #21262d;border-radius:12px;padding:2rem}h1{font-size:1.5rem;margin-bottom:0.75rem;font-weight:600}.error{color:#f85149;font-size:0.85rem;margin-top:0.5rem}`;\n\nfunction errorPage(message: string): string {\n return `\nError — sync-mcp\n\n\n\n

Error

${escapeHtml(message)}

`;\n}\n\nfunction escapeHtml(str: string): string {\n return str.replace(/&/g, \"&\").replace(//g, \">\")\n .replace(/\"/g, \""\");\n}\n\n// ─── Authorization Endpoint ──────────────────────────────────────\n\nexport async function handleAuthorize(req: Request): Promise {\n const url = new URL(req.url);\n const clientId = url.searchParams.get(\"client_id\");\n const redirectUri = url.searchParams.get(\"redirect_uri\");\n const responseType = url.searchParams.get(\"response_type\");\n const codeChallenge = url.searchParams.get(\"code_challenge\");\n const codeChallengeMethod = url.searchParams.get(\"code_challenge_method\") ??\n \"S256\";\n const scope = url.searchParams.get(\"scope\") ?? \"sync:rooms\";\n const state = url.searchParams.get(\"state\") ?? \"\";\n const resource = url.searchParams.get(\"resource\") ?? \"\";\n\n if (!clientId || !redirectUri || responseType !== \"code\" || !codeChallenge) {\n return html(\n errorPage(\n \"Missing required parameters (client_id, redirect_uri, response_type=code, code_challenge)\",\n ),\n 400,\n );\n }\n\n const client = await db.getOAuthClient(clientId);\n if (!client) {\n return html(errorPage(\"Unknown client_id\"), 400);\n }\n if (!client.redirectUris.includes(redirectUri)) {\n return html(errorPage(\"redirect_uri not registered for this client\"), 400);\n }\n\n const origin = getOrigin(req);\n\n const oauthParams = {\n clientId,\n clientName: client.clientName ?? \"MCP Client\",\n redirectUri,\n codeChallenge,\n codeChallengeMethod,\n scope,\n state,\n resource,\n };\n\n return renderPage({\n element: ,\n entry: \"https://esm.town/v/c15r/sync/frontend/pages/authorize/client.tsx\",\n props: { origin, params: oauthParams },\n title: \"Sign in — sync·mcp\",\n });\n}\n\n// ─── Management Page ─────────────────────────────────────────────\n\nexport function handleManagePage(req: Request): Response {\n const origin = getOrigin(req);\n const dashboardOrigin = getDashboardOrigin(req);\n return renderPage({\n element: ,\n entry: \"https://esm.town/v/c15r/sync/frontend/pages/manage/client.tsx\",\n props: { origin, dashboardOrigin },\n title: \"Manage — sync·mcp\",\n });\n}\n\nexport async function handleManageApi(req: Request): Promise {\n const sessionId = req.headers.get(\"x-session-id\");\n if (!sessionId) return json({ error: \"Missing X-Session-Id header\" }, 401);\n\n const session = await db.validateSession(sessionId);\n if (!session) {\n return json(\n { error: \"Invalid or expired session. Please sign in again.\" },\n 401,\n );\n }\n if (session.scope === \"recovery\") {\n return json(\n { error: \"Recovery sessions cannot access management API\" },\n 403,\n );\n }\n\n const userId = session.userId;\n const url = new URL(req.url);\n const path = url.pathname.replace(\"/manage/api\", \"\");\n\n // GET /manage/api/me — user info\n if (req.method === \"GET\" && path === \"/me\") {\n const user = await db.getUserById(userId);\n const creds = await db.getCredentialsByUserId(userId);\n return json({\n user: user\n ? { id: user.id, username: user.username, created_at: user.created_at }\n : null,\n passkeys: creds.map((c) => ({\n id: c.id.substring(0, 16) + \"...\",\n device_type: c.deviceType,\n backed_up: c.backedUp,\n })),\n });\n }\n\n // GET /manage/api/rooms — user's rooms with agents and roles\n if (req.method === \"GET\" && path === \"/rooms\") {\n const userRooms = await db.listUserRooms(userId);\n const roomsWithDetail = [];\n for (const ur of userRooms) {\n const agentsRes = await sqlite.execute({\n sql: `SELECT id, name, role, status, last_heartbeat FROM agents WHERE room_id = ? ORDER BY joined_at`,\n args: [ur.roomId],\n });\n const agents = agentsRes.rows.map((r: any[]) => ({\n id: r[0], name: r[1], role: r[2], status: r[3], last_heartbeat: r[4],\n }));\n const roles = await fetchRoomRoles(ur.roomId);\n roomsWithDetail.push({\n room_id: ur.roomId,\n access: ur.access,\n label: ur.label,\n is_default: ur.isDefault,\n agents,\n roles,\n });\n }\n return json({ rooms: roomsWithDetail });\n }\n\n // POST /manage/api/rooms — create a new room\n if (req.method === \"POST\" && path === \"/rooms\") {\n const body = await req.json();\n const roomId = body.id ?? crypto.randomUUID();\n const label = body.label ?? `Room: ${roomId}`;\n // Check if room already exists\n const existing = await sqlite.execute({\n sql: `SELECT id FROM rooms WHERE id = ?`, args: [roomId],\n });\n if (existing.rows.length > 0) return json({ error: \"room_exists\", id: roomId }, 409);\n // Create room\n const { generateToken, hashToken } = await import(\"../auth.ts\");\n const token = generateToken(\"room\");\n const hash = await hashToken(token);\n const viewToken = generateToken(\"view\");\n const viewHash = await hashToken(viewToken);\n await sqlite.execute({\n sql: `INSERT INTO rooms (id, meta, token_hash, view_token_hash) VALUES (?, ?, ?, ?)`,\n args: [roomId, JSON.stringify(body.meta ?? {}), hash, viewHash],\n });\n // Link to user as owner\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO smcp_user_rooms (user_id, room_id, access, label)\n VALUES (?, ?, 'owner', ?)`,\n args: [userId, roomId, label],\n });\n return json({ id: roomId, label, access: \"owner\" }, 201);\n }\n\n // POST /manage/api/rooms/:id/invite — invite a user\n if (req.method === \"POST\" && path.match(/^\\/rooms\\/[^/]+\\/invite$/)) {\n const roomId = path.split(\"/\")[2];\n const userRoom = await db.getUserRoom(userId, roomId);\n if (!userRoom || userRoom.access !== \"owner\") {\n return json({ error: \"not_owner\", message: \"Only room owners can invite users\" }, 403);\n }\n const body = await req.json();\n const { username, role } = body;\n if (!username) return json({ error: \"username required\" }, 400);\n const validRoles = [\"owner\", \"collaborator\", \"participant\", \"observer\"];\n const targetRole = role ?? \"participant\";\n if (!validRoles.includes(targetRole)) return json({ error: \"invalid_role\", valid: validRoles }, 400);\n const targetUser = await db.getUserByUsername(username);\n if (!targetUser) return json({ error: \"user_not_found\", message: `No user \"${username}\"` }, 404);\n await db.inviteUserToRoom(targetUser.id, roomId, targetRole, userId, body.label);\n return json({ invited: true, username, room: roomId, role: targetRole });\n }\n\n // DELETE /manage/api/rooms/:id — delete a room (owner only)\n if (req.method === \"DELETE\" && path.match(/^\\/rooms\\/[^/]+$/)) {\n const roomId = path.split(\"/\")[2];\n const userRoom = await db.getUserRoom(userId, roomId);\n if (!userRoom || userRoom.access !== \"owner\") {\n return json({ error: \"not_owner\", message: \"Only room owners can delete rooms\" }, 403);\n }\n // Delete room data (cascade: agents, state, actions, views, messages, audit)\n await sqlite.batch([\n { sql: `DELETE FROM state WHERE room_id = ?`, args: [roomId] },\n { sql: `DELETE FROM actions WHERE room_id = ?`, args: [roomId] },\n { sql: `DELETE FROM views WHERE room_id = ?`, args: [roomId] },\n { sql: `DELETE FROM agents WHERE room_id = ?`, args: [roomId] },\n { sql: `DELETE FROM smcp_user_rooms WHERE room_id = ?`, args: [roomId] },\n { sql: `DELETE FROM rooms WHERE id = ?`, args: [roomId] },\n ]);\n return json({ deleted: true, room: roomId });\n }\n\n // POST /manage/api/room-token — mint a temporary token for dashboard access\n if (req.method === \"POST\" && path === \"/room-token\") {\n const body = await req.json();\n const roomId = body.room_id;\n if (!roomId) return json({ error: \"room_id required\" }, 400);\n\n // Check user has access to this room\n const userRoom = await db.getUserRoom(userId, roomId);\n if (!userRoom) return json({ error: \"no_access\", message: \"You don't have access to this room\" }, 403);\n\n // Mint a short-lived token scoped to this room\n const level = userRoom.access === \"owner\" ? \"\" : \":read\";\n const result = await db.mintToken({\n userId,\n scope: `rooms:${roomId}${level}`,\n label: `Dashboard: ${roomId}`,\n roomId,\n expiresInSec: 3600, // 1 hour\n });\n\n return json({\n token: result.token,\n room_id: roomId,\n access: userRoom.access,\n expires_at: result.expiresAt,\n });\n }\n\n // ── Unified tokens (v7) ──\n\n // GET /manage/api/tokens — list unified tokens\n if (req.method === \"GET\" && path === \"/tokens\") {\n const tokens = await db.listUserTokens(userId);\n return json({\n tokens: tokens.map(t => ({\n id: t.id,\n scope: t.scope,\n label: t.label,\n room_id: t.roomId,\n agent_id: t.agentId,\n client_id: t.clientId,\n revoked: t.revoked,\n expires_at: t.expiresAt,\n created_at: t.createdAt,\n })),\n });\n }\n\n // DELETE /manage/api/tokens/:id — revoke a unified token\n if (req.method === \"DELETE\" && path.startsWith(\"/tokens/\")) {\n const tokenId = path.split(\"/\")[2];\n if (!tokenId) return json({ error: \"Missing token ID\" }, 400);\n const ok = await db.revokeToken(tokenId, userId);\n if (!ok) return json({ error: \"Token not found or not owned by you\" }, 404);\n return json({ revoked: true, id: tokenId });\n }\n\n // POST /manage/api/recovery — generate recovery token\n if (req.method === \"POST\" && path === \"/recovery\") {\n const result = await db.createRecoveryToken(userId);\n if (\"error\" in result) return json({ error: result.error }, 400);\n return json({\n token: result.token,\n expires_at: result.expiresAt,\n warning: \"Store this token safely. It will not be shown again.\",\n }, 201);\n }\n\n // GET /manage/api/recovery — list recovery tokens (metadata only)\n if (req.method === \"GET\" && path === \"/recovery\") {\n const tokens = await db.listRecoveryTokens(userId);\n return json({ tokens });\n }\n\n // DELETE /manage/api/recovery/:id — revoke a recovery token\n if (req.method === \"DELETE\" && path.startsWith(\"/recovery/\")) {\n const tokenId = path.split(\"/\")[2];\n if (!tokenId) return json({ error: \"Missing token ID\" }, 400);\n await db.revokeRecoveryToken(userId, tokenId);\n return json({ deleted: true, id: tokenId });\n }\n\n return json({ error: \"Not found\" }, 404);\n}\n\n// ─── Recovery: passkey re-registration ───────────────────────────\n\nexport function handleRecoverPage(req: Request): Response {\n const origin = getOrigin(req);\n return renderPage({\n element: ,\n entry: \"https://esm.town/v/c15r/sync/frontend/pages/recover/client.tsx\",\n props: { origin },\n title: \"Recover — sync·mcp\",\n });\n}\n\nexport async function handleRecoverValidate(req: Request): Promise {\n const { token } = await req.json();\n if (!token) return json({ error: \"Recovery token required\" }, 400);\n\n const result = await db.validateRecoveryToken(token);\n if (!result) {\n return json(\n { error: \"Invalid, expired, or already-used recovery token\" },\n 400,\n );\n }\n\n const sessionId = await db.createSession(result.userId, \"recovery\");\n\n return json({ verified: true, sessionId, tokenId: result.tokenId });\n}\n\nexport async function handleRecoverRegisterOptions(\n req: Request,\n): Promise {\n const { sessionId } = await req.json();\n if (!sessionId) return json({ error: \"Session required\" }, 400);\n\n const session = await db.validateSession(sessionId);\n if (!session || session.scope !== \"recovery\") {\n return json({ error: \"Invalid or expired recovery session\" }, 400);\n }\n\n const user = await db.getUserById(session.userId);\n if (!user) return json({ error: \"User not found\" }, 400);\n\n const rpId = getRpId(req);\n const existingCreds = await db.getCredentialsByUserId(user.id, rpId);\n\n const options = await generateRegistrationOptions({\n rpName: \"sync-mcp\",\n rpID: rpId,\n userName: user.username,\n userID: new TextEncoder().encode(user.id),\n attestationType: \"none\",\n authenticatorSelection: {\n residentKey: \"preferred\",\n userVerification: \"preferred\",\n },\n excludeCredentials: existingCreds.map((c) => ({\n id: c.id,\n transports: c.transports as AuthenticatorTransportFuture[] | undefined,\n })),\n });\n\n const challengeId = db.generateId();\n await db.saveChallenge(\n challengeId,\n options.challenge,\n \"recovery-registration\",\n user.id,\n );\n\n return json({ options, challengeId, username: user.username });\n}\n\nexport async function handleRecoverRegisterVerify(\n req: Request,\n): Promise {\n const { challengeId, sessionId, tokenId, response } = await req.json();\n\n const session = await db.validateSession(sessionId);\n if (!session || session.scope !== \"recovery\") {\n return json({ error: \"Invalid or expired recovery session\" }, 400);\n }\n\n const challenge = await db.getChallenge(challengeId);\n if (!challenge || challenge.type !== \"recovery-registration\") {\n return json({ error: \"Invalid or expired challenge\" }, 400);\n }\n\n const rpId = getRpId(req);\n const origin = getOrigin(req);\n\n try {\n const verification = await verifyRegistrationResponse({\n response,\n expectedChallenge: challenge.challenge,\n expectedOrigin: origin,\n expectedRPID: rpId,\n });\n\n if (!verification.verified || !verification.registrationInfo) {\n return json({ error: \"Verification failed\" }, 400);\n }\n\n const { credential, credentialDeviceType, credentialBackedUp } =\n verification.registrationInfo;\n\n await db.saveCredential({\n id: credential.id,\n userId: session.userId,\n publicKey: credential.publicKey,\n counter: credential.counter,\n transports: credential.transports as string[],\n deviceType: credentialDeviceType,\n backedUp: credentialBackedUp,\n rpId,\n });\n\n await db.deleteChallenge(challengeId);\n await db.consumeRecoveryToken(tokenId);\n await db.deleteSession(sessionId);\n\n return json({ verified: true, rpId });\n } catch (err) {\n return json(\n { error: `Registration failed: ${(err as Error).message}` },\n 400,\n );\n }\n}\n",[],[412,941],"7cca34da-2127-11f1-a952-42dde27851f2","elevate.tsx","a342dce6-1e45-11f1-b03a-42dde27851f2",629,["D",1773658890447],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/**\n * elevate.ts — Unified scope consent handlers.\n *\n * Routes:\n * GET /auth/consent SSR consent page (React)\n * GET /auth/consent/rooms Load user's rooms + token scope (API)\n * POST /auth/consent/approve Apply scope changes (mode-dependent)\n * GET /auth/elevate Redirect to /auth/consent?mode=elevate\n */\n\nimport * as db from \"./db.ts\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { renderPage } from \"../frontend/ssr.ts\";\nimport { ConsentPage } from \"../frontend/pages/consent/ConsentPage.tsx\";\n\nfunction jsonResp(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization, X-Session-Id\",\n \"Cache-Control\": \"no-store\",\n },\n });\n}\n\nfunction getOrigin(req: Request): string {\n const url = new URL(req.url);\n return `${url.protocol}//${url.host}`;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// GET /auth/consent — Unified SSR consent page\n// ═══════════════════════════════════════════════════════════════════\n\nexport function handleConsentPage(req: Request): Response {\n const url = new URL(req.url);\n const origin = getOrigin(req);\n\n const props = {\n origin,\n mode: (url.searchParams.get(\"mode\") ?? \"elevate\") as \"elevate\" | \"device\" | \"oauth\",\n // Elevate\n tokenId: url.searchParams.get(\"token_id\") ?? undefined,\n addRoom: url.searchParams.get(\"room\") ?? undefined,\n addLevel: url.searchParams.get(\"level\") ?? undefined,\n // Device (pre-authenticated)\n sessionId: url.searchParams.get(\"session_id\") ?? undefined,\n deviceCode: url.searchParams.get(\"device_code\") ?? undefined,\n requestedScope: url.searchParams.get(\"scope\") ?? undefined,\n // OAuth (pre-authenticated)\n clientId: url.searchParams.get(\"client_id\") ?? undefined,\n clientName: url.searchParams.get(\"client_name\") ?? undefined,\n redirectUri: url.searchParams.get(\"redirect_uri\") ?? undefined,\n codeChallenge: url.searchParams.get(\"code_challenge\") ?? undefined,\n codeChallengeMethod: url.searchParams.get(\"code_challenge_method\") ?? undefined,\n oauthScope: url.searchParams.get(\"scope\") ?? undefined,\n oauthState: url.searchParams.get(\"state\") ?? undefined,\n resource: url.searchParams.get(\"resource\") ?? undefined,\n };\n\n // Strip undefined values for clean serialization\n const cleanProps = Object.fromEntries(\n Object.entries(props).filter(([, v]) => v !== undefined)\n );\n\n return renderPage({\n element: ,\n entry: \"https://esm.town/v/c15r/sync/frontend/pages/consent/client.tsx\",\n props: cleanProps,\n title: `${props.mode === \"elevate\" ? \"Grant Access\" : props.mode === \"device\" ? \"Authorize Device\" : \"Authorize\"} — sync`,\n });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// GET /auth/elevate — Legacy redirect\n// ═══════════════════════════════════════════════════════════════════\n\nexport function handleElevatePage(req: Request): Response {\n const url = new URL(req.url);\n const newUrl = new URL(\"/auth/consent\", url.origin);\n newUrl.searchParams.set(\"mode\", \"elevate\");\n for (const key of [\"token_id\", \"room\", \"level\"]) {\n const v = url.searchParams.get(key);\n if (v) newUrl.searchParams.set(key, v);\n }\n return Response.redirect(newUrl.toString(), 302);\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// GET /auth/consent/rooms — Load user's rooms + token scope\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleConsentRooms(req: Request): Promise {\n const url = new URL(req.url);\n const sessionId = url.searchParams.get(\"session_id\") ?? req.headers.get(\"x-session-id\") ?? \"\";\n const tokenId = url.searchParams.get(\"token_id\") ?? \"\";\n\n if (!sessionId) return jsonResp({ error: \"session_id required\" }, 400);\n const session = await db.validateSession(sessionId);\n if (!session) return jsonResp({ error: \"invalid_session\" }, 401);\n\n // Fetch user's rooms with agents\n const userRooms = await db.listUserRooms(session.userId);\n const rooms = [];\n for (const ur of userRooms) {\n const agentsRes = await sqlite.execute({\n sql: `SELECT id, name, role, status FROM agents WHERE room_id = ? ORDER BY joined_at`,\n args: [ur.roomId],\n });\n rooms.push({\n room_id: ur.roomId,\n access: ur.access,\n label: ur.label,\n agents: agentsRes.rows.map((r: any[]) => ({ id: r[0], name: r[1], role: r[2], status: r[3] })),\n });\n }\n\n // If editing existing token, include its current scope\n let tokenScope: string | null = null;\n let tokenLabel: string | null = null;\n if (tokenId) {\n const tokenResult = await sqlite.execute({\n sql: `SELECT scope, label FROM tokens WHERE id = ? AND minted_by = ? AND revoked = 0`,\n args: [tokenId, session.userId],\n });\n if (tokenResult.rows.length > 0) {\n tokenScope = tokenResult.rows[0][0] as string;\n tokenLabel = tokenResult.rows[0][1] as string | null;\n }\n }\n\n return jsonResp({ rooms, token_scope: tokenScope, token_label: tokenLabel });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/consent/approve — Apply scope changes (mode-dependent)\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleConsentApprove(req: Request): Promise {\n const body = await req.json();\n const { mode, session_id, new_scope } = body;\n\n if (!session_id || !new_scope) return jsonResp({ error: \"session_id and new_scope required\" }, 400);\n\n const session = await db.validateSession(session_id);\n if (!session) return jsonResp({ error: \"invalid_session\" }, 401);\n\n // Validate: user must have access to all rooms in scope\n const scopeParts = new_scope.split(/\\s+/).filter(Boolean);\n for (const part of scopeParts) {\n if (!part.startsWith(\"rooms:\")) continue;\n const roomId = part.split(\":\")[1];\n if (roomId === \"*\") continue;\n const userRoom = await sqlite.execute({\n sql: `SELECT access FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?`,\n args: [session.userId, roomId],\n });\n if (userRoom.rows.length === 0) {\n return jsonResp({ error: \"no_access\", message: `You don't have access to room \"${roomId}\"`, room: roomId }, 403);\n }\n }\n\n // ── Mode: Elevate (patch existing token) ──\n if (mode === \"elevate\") {\n const tokenId = body.token_id;\n if (!tokenId) return jsonResp({ error: \"token_id required\" }, 400);\n const tokenResult = await sqlite.execute({\n sql: `SELECT id FROM tokens WHERE id = ? AND minted_by = ? AND revoked = 0`,\n args: [tokenId, session.userId],\n });\n if (tokenResult.rows.length === 0) return jsonResp({ error: \"token_not_found\" }, 404);\n await sqlite.execute({ sql: `UPDATE tokens SET scope = ? WHERE id = ?`, args: [new_scope, tokenId] });\n await db.deleteSession(session_id);\n return jsonResp({ ok: true, mode: \"elevate\", token_id: tokenId, scope: new_scope });\n }\n\n // ── Mode: Device (approve device code with chosen scope) ──\n if (mode === \"device\") {\n const deviceCode = body.device_code;\n if (!deviceCode) return jsonResp({ error: \"device_code required\" }, 400);\n // Update scope + approve\n await sqlite.execute({ sql: `UPDATE device_codes SET scope = ? WHERE device_code = ?`, args: [new_scope, deviceCode] });\n const ok = await db.approveDeviceCode(deviceCode, session.userId);\n if (!ok) return jsonResp({ error: \"approval_failed\" }, 500);\n await db.deleteSession(session_id);\n return jsonResp({ ok: true, mode: \"device\" });\n }\n\n // ── Mode: OAuth (issue auth code with chosen scope) ──\n if (mode === \"oauth\") {\n const { client_id, redirect_uri, code_challenge, code_challenge_method, state, resource } = body;\n if (!client_id || !redirect_uri || !code_challenge) {\n return jsonResp({ error: \"missing OAuth params\" }, 400);\n }\n const code = await db.generateToken(\"authz\");\n await db.saveAuthCode({\n code, clientId: client_id, userId: session.userId,\n redirectUri: redirect_uri, codeChallenge: code_challenge,\n codeChallengeMethod: code_challenge_method || \"S256\",\n scope: new_scope, resource,\n });\n await db.deleteSession(session_id);\n const redirect = new URL(redirect_uri);\n redirect.searchParams.set(\"code\", code);\n if (state) redirect.searchParams.set(\"state\", state);\n return jsonResp({ ok: true, mode: \"oauth\", redirect: redirect.toString() });\n }\n\n return jsonResp({ error: \"invalid mode\" }, 400);\n}\n",[],[412,949],"fa04d63c-1e4b-11f1-a842-42dde27851f2","device.ts","ba1f92bc-1df3-11f1-a2c2-42dde27851f2",540,["D",1773344709106],8,"/**\n * device.ts — OAuth Device Authorization (RFC 8628) for sync.\n *\n * Flow:\n * 1. CLI calls POST /auth/device → gets device_code + user_code + verification_uri\n * 2. User opens verification_uri in browser\n * 3. Browser page shows user_code, triggers WebAuthn passkey auth\n * 4. After passkey → redirects to /auth/consent?mode=device for scope selection\n * 5. Unified consent page handles room picker + approve/deny\n * 6. CLI polls POST /auth/device/token → gets access_token + refresh_token\n */\n\nimport * as db from \"./db.ts\";\nimport { getRpId } from \"./webauthn.ts\";\n\nfunction jsonResp(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data, null, 2), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n \"Cache-Control\": \"no-store\",\n },\n });\n}\n\nfunction getOrigin(req: Request): string {\n const url = new URL(req.url);\n return `${url.protocol}//${url.host}`;\n}\n\nconst ACCESS_TOKEN_EXPIRY = 3600;\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/device — CLI initiates device auth\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDeviceStart(req: Request): Promise {\n let body: Record = {};\n try { body = await req.json(); } catch {}\n const scope = body.scope ?? \"rooms:* create_rooms\";\n const clientId = body.client_id ?? null;\n const { deviceCode, userCode } = await db.createDeviceCode(scope, clientId);\n const origin = getOrigin(req);\n return jsonResp({\n device_code: deviceCode,\n user_code: userCode,\n verification_uri: `${origin}/auth/device`,\n verification_uri_complete: `${origin}/auth/device?code=${userCode}`,\n expires_in: 900,\n interval: 5,\n });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// GET /auth/device — Code entry + passkey auth page (minimal)\n// After passkey auth, redirects to /auth/consent?mode=device\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDevicePage(req: Request): Promise {\n const url = new URL(req.url);\n const code = url.searchParams.get(\"code\") ?? \"\";\n const origin = getOrigin(req);\n const rpId = getRpId(req);\n return new Response(renderDeviceAuthPage(origin, rpId, code), {\n headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n });\n}\n\nfunction esc(s: string): string {\n return s.replace(/&/g, \"&\").replace(//g, \">\").replace(/\"/g, \""\");\n}\n\nfunction renderDeviceAuthPage(origin: string, rpId: string, prefillCode: string): string {\n // Minimal page: code entry → passkey auth → redirect to unified consent\n return `\n\n\n\nAuthorize Device — sync\n\n\n\n

sync·device

A device is requesting access to your sync account.

Enter the code shown on your device\n

\n \n

${esc(prefillCode)}

\n \n \n \n

🔐

Waiting for passkey...

✗

Failed

🚫

Access Denied

The device will be notified.

\n\n`;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/device/lookup\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDeviceLookup(req: Request): Promise {\n const { user_code } = await req.json();\n if (!user_code) return jsonResp({ error: \"user_code required\" }, 400);\n const code = await db.getDeviceCodeByUserCode(user_code.toUpperCase());\n if (!code) return jsonResp({ error: \"not_found\" }, 404);\n if (code.status !== \"pending\") return jsonResp({ error: \"already_used\" }, 409);\n return jsonResp({ device_code: code.deviceCode, scope: code.scope, user_code: code.userCode });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/device/approve (kept for backward compat — consent page uses /auth/consent/approve)\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDeviceApprove(req: Request): Promise {\n const { device_code, session_id, user_code, scope: narrowedScope } = await req.json();\n if (!session_id) return jsonResp({ error: \"session_id required\" }, 400);\n const session = await db.validateSession(session_id);\n if (!session) return jsonResp({ error: \"invalid_session\" }, 401);\n let dc;\n if (device_code) dc = await db.getDeviceCode(device_code);\n else if (user_code) dc = await db.getDeviceCodeByUserCode(user_code);\n if (!dc) return jsonResp({ error: \"not_found\" }, 404);\n if (dc.status !== \"pending\") return jsonResp({ error: \"already_processed\" }, 409);\n if (narrowedScope && typeof narrowedScope === \"string\" && narrowedScope.trim()) {\n await db.updateDeviceCodeScope(dc.deviceCode, narrowedScope.trim());\n }\n const ok = await db.approveDeviceCode(dc.deviceCode, session.userId);\n if (!ok) return jsonResp({ error: \"approval_failed\" }, 500);\n await db.deleteSession(session_id);\n return jsonResp({ approved: true, device_code: dc.deviceCode });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/device/deny\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDeviceDeny(req: Request): Promise {\n const { device_code } = await req.json();\n if (!device_code) return jsonResp({ error: \"device_code required\" }, 400);\n await db.denyDeviceCode(device_code);\n return jsonResp({ denied: true });\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// POST /auth/device/token — CLI polls for token\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function handleDeviceToken(req: Request): Promise {\n let body: Record;\n const ct = req.headers.get(\"content-type\") ?? \"\";\n if (ct.includes(\"application/x-www-form-urlencoded\")) {\n body = Object.fromEntries(new URLSearchParams(await req.text()));\n } else {\n body = await req.json();\n }\n const deviceCode = body.device_code;\n if (!deviceCode) return jsonResp({ error: \"invalid_request\", error_description: \"device_code required\" }, 400);\n const dc = await db.getDeviceCode(deviceCode);\n if (!dc) return jsonResp({ error: \"invalid_grant\", error_description: \"Unknown device code\" }, 400);\n if (new Date(dc.expiresAt) < new Date()) return jsonResp({ error: \"expired_token\" }, 400);\n switch (dc.status) {\n case \"pending\": return jsonResp({ error: \"authorization_pending\" });\n case \"denied\": return jsonResp({ error: \"access_denied\" }, 403);\n case \"consumed\": return jsonResp({ error: \"invalid_grant\", error_description: \"Already consumed\" }, 400);\n case \"approved\": {\n const consumed = await db.consumeDeviceCode(deviceCode);\n if (!consumed) return jsonResp({ error: \"server_error\" }, 500);\n const result = await db.mintToken({\n userId: consumed.approvedBy, scope: consumed.scope,\n label: \"Device auth\", clientId: dc.clientId ?? \"cli\",\n expiresInSec: ACCESS_TOKEN_EXPIRY, withRefresh: true,\n });\n return jsonResp({\n access_token: result.token, token_type: \"Bearer\",\n expires_in: ACCESS_TOKEN_EXPIRY, refresh_token: result.refreshToken,\n scope: consumed.scope,\n });\n }\n default: return jsonResp({ error: \"server_error\" }, 500);\n }\n}\n",[],[412,957],"d7b5ecf6-1e50-11f1-9153-42dde27851f2","db.ts","9f51169a-18a3-11f1-b05e-42dde27851f2",553,["D",1773346799033],"/**\n * db.ts — SQLite helpers for sync-mcp OAuth/WebAuthn/Vault\n *\n * Schema is managed by the parent ../schema.ts (unified migration).\n * This file provides CRUD helpers + ensures smcp_ tables exist.\n */\nimport { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { migrate } from \"../schema.ts\";\n\n// Re-export scope types and functions for backward compatibility\nexport {\n type ParsedScope,\n type RoomScope,\n parseScope,\n serializeScope,\n checkRoomInScope,\n} from \"./scope.ts\";\n\n// ─── Schema migration (delegates to unified schema + ensures smcp_ tables) ──\n\nexport async function ensureSchema() {\n // Run the unified migration (creates all tables including smcp_)\n await migrate();\n\n // Belt-and-suspenders: ensure smcp_ tables exist even if parent\n // schema.ts is cached at an older version without them.\n await sqlite.batch([\n { sql: `CREATE TABLE IF NOT EXISTS smcp_users (id TEXT PRIMARY KEY, username TEXT UNIQUE NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_credentials (id TEXT PRIMARY KEY, user_id TEXT NOT NULL, public_key BLOB NOT NULL, counter INTEGER NOT NULL DEFAULT 0, transports TEXT, device_type TEXT, backed_up INTEGER DEFAULT 0, rp_id TEXT, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_challenges (id TEXT PRIMARY KEY, challenge TEXT NOT NULL, user_id TEXT, type TEXT NOT NULL, expires_at TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_oauth_clients (client_id TEXT PRIMARY KEY, client_secret TEXT, redirect_uris TEXT NOT NULL, client_name TEXT, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_auth_codes (code TEXT PRIMARY KEY, client_id TEXT NOT NULL, user_id TEXT NOT NULL, redirect_uri TEXT NOT NULL, code_challenge TEXT NOT NULL, code_challenge_method TEXT NOT NULL DEFAULT 'S256', scope TEXT, resource TEXT, expires_at TEXT NOT NULL, used INTEGER DEFAULT 0)`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_access_tokens (token TEXT PRIMARY KEY, user_id TEXT NOT NULL, client_id TEXT NOT NULL, scope TEXT, expires_at TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_refresh_tokens (token TEXT PRIMARY KEY, user_id TEXT NOT NULL, client_id TEXT NOT NULL, scope TEXT, expires_at TEXT NOT NULL, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_vault (id TEXT PRIMARY KEY, user_id TEXT NOT NULL, room_id TEXT NOT NULL, token TEXT NOT NULL, token_type TEXT NOT NULL, label TEXT, is_default INTEGER DEFAULT 0, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_sessions (id TEXT PRIMARY KEY, user_id TEXT NOT NULL, expires_at TEXT NOT NULL, scope TEXT DEFAULT 'consent', created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n { sql: `CREATE TABLE IF NOT EXISTS smcp_recovery_tokens (id TEXT PRIMARY KEY, user_id TEXT NOT NULL, token_hash TEXT NOT NULL, expires_at TEXT NOT NULL, used INTEGER DEFAULT 0, created_at TEXT NOT NULL DEFAULT (datetime('now')))`, args: [] },\n ]);\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────\n\nexport function generateId(): string {\n return crypto.randomUUID();\n}\n\nexport async function generateToken(prefix = \"\"): Promise {\n const bytes = new Uint8Array(32);\n crypto.getRandomValues(bytes);\n const b64 = btoa(String.fromCharCode(...bytes))\n .replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=/g, \"\");\n return prefix ? `${prefix}_${b64}` : b64;\n}\n\n// Base64url encode/decode\nexport function b64urlEncode(buf: Uint8Array): string {\n return btoa(String.fromCharCode(...buf))\n .replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=/g, \"\");\n}\n\nexport function b64urlDecode(str: string): Uint8Array {\n const padded = str + \"=\".repeat((4 - (str.length % 4)) % 4);\n const binary = atob(padded.replace(/-/g, \"+\").replace(/_/g, \"/\"));\n return Uint8Array.from(binary, (c) => c.charCodeAt(0));\n}\n\n// SHA-256 for PKCE\nexport async function sha256(input: string): Promise {\n const data = new TextEncoder().encode(input);\n const hash = await crypto.subtle.digest(\"SHA-256\", data);\n return b64urlEncode(new Uint8Array(hash));\n}\n\n// ─── User CRUD ───────────────────────────────────────────────────\n\nexport async function createUser(id: string, username: string) {\n await sqlite.execute({\n sql: \"INSERT INTO smcp_users (id, username) VALUES (?, ?)\",\n args: [id, username],\n });\n}\n\nexport async function getUserByUsername(username: string) {\n const res = await sqlite.execute({\n sql: \"SELECT * FROM smcp_users WHERE username = ?\",\n args: [username],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string,\n username: r[1] as string,\n created_at: r[2] as string,\n };\n}\n\nexport async function getUserById(id: string) {\n const res = await sqlite.execute({\n sql: \"SELECT * FROM smcp_users WHERE id = ?\",\n args: [id],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string,\n username: r[1] as string,\n created_at: r[2] as string,\n };\n}\n\n// ─── Credential CRUD ────────────────────────────────────────────\n\nexport async function saveCredential(cred: {\n id: string;\n userId: string;\n publicKey: Uint8Array;\n counter: number;\n transports?: string[];\n deviceType?: string;\n backedUp?: boolean;\n rpId?: string;\n}) {\n await sqlite.execute({\n sql:\n `INSERT INTO smcp_credentials (id, user_id, public_key, counter, transports, device_type, backed_up, rp_id)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [\n cred.id,\n cred.userId,\n b64urlEncode(cred.publicKey),\n cred.counter,\n cred.transports ? JSON.stringify(cred.transports) : null,\n cred.deviceType ?? null,\n cred.backedUp ? 1 : 0,\n cred.rpId ?? null,\n ],\n });\n}\n\nexport async function getCredentialsByUserId(userId: string, rpId?: string) {\n let sql = \"SELECT * FROM smcp_credentials WHERE user_id = ?\";\n const args: any[] = [userId];\n if (rpId) {\n sql += \" AND (rp_id = ? OR rp_id IS NULL)\";\n args.push(rpId);\n }\n const res = await sqlite.execute({ sql, args });\n return res.rows.map((r) => ({\n id: r[0] as string,\n userId: r[1] as string,\n publicKey: b64urlDecode(r[2] as string),\n counter: r[3] as number,\n transports: r[4] ? JSON.parse(r[4] as string) : undefined,\n deviceType: r[5] as string | null,\n backedUp: r[6] === 1,\n rpId: r[7] as string | null,\n }));\n}\n\nexport async function getCredentialById(credId: string) {\n const res = await sqlite.execute({\n sql: \"SELECT * FROM smcp_credentials WHERE id = ?\",\n args: [credId],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string,\n userId: r[1] as string,\n publicKey: b64urlDecode(r[2] as string),\n counter: r[3] as number,\n transports: r[4] ? JSON.parse(r[4] as string) : undefined,\n deviceType: r[5] as string | null,\n backedUp: r[6] === 1,\n rpId: r[7] as string | null,\n };\n}\n\nexport async function updateCredentialCounter(\n credId: string,\n newCounter: number,\n) {\n await sqlite.execute({\n sql: \"UPDATE smcp_credentials SET counter = ? WHERE id = ?\",\n args: [newCounter, credId],\n });\n}\n\n// ─── Challenge CRUD ─────────────────────────────────────────────\n\nexport async function saveChallenge(\n id: string,\n challenge: string,\n type: string,\n userId?: string,\n) {\n const expires = new Date(Date.now() + 5 * 60 * 1000).toISOString(); // 5 min\n await sqlite.execute({\n sql:\n \"INSERT INTO smcp_challenges (id, challenge, user_id, type, expires_at) VALUES (?, ?, ?, ?, ?)\",\n args: [id, challenge, userId ?? null, type, expires],\n });\n}\n\nexport async function getChallenge(id: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT * FROM smcp_challenges WHERE id = ? AND expires_at > datetime('now')\",\n args: [id],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string,\n challenge: r[1] as string,\n userId: r[2] as string | null,\n type: r[3] as string,\n };\n}\n\nexport async function deleteChallenge(id: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_challenges WHERE id = ?\",\n args: [id],\n });\n}\n\n// ─── OAuth Client CRUD ──────────────────────────────────────────\n\nexport async function saveOAuthClient(client: {\n clientId: string;\n clientSecret?: string;\n redirectUris: string[];\n clientName?: string;\n}) {\n await sqlite.execute({\n sql:\n `INSERT OR REPLACE INTO smcp_oauth_clients (client_id, client_secret, redirect_uris, client_name)\n VALUES (?, ?, ?, ?)`,\n args: [\n client.clientId,\n client.clientSecret ?? null,\n JSON.stringify(client.redirectUris),\n client.clientName ?? null,\n ],\n });\n}\n\nexport async function getOAuthClient(clientId: string) {\n const res = await sqlite.execute({\n sql: \"SELECT * FROM smcp_oauth_clients WHERE client_id = ?\",\n args: [clientId],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n clientId: r[0] as string,\n clientSecret: r[1] as string | null,\n redirectUris: JSON.parse(r[2] as string) as string[],\n clientName: r[3] as string | null,\n };\n}\n\n// ─── Auth Code CRUD ─────────────────────────────────────────────\n\nexport async function saveAuthCode(code: {\n code: string;\n clientId: string;\n userId: string;\n redirectUri: string;\n codeChallenge: string;\n codeChallengeMethod: string;\n scope?: string;\n resource?: string;\n}) {\n const expires = new Date(Date.now() + 10 * 60 * 1000).toISOString(); // 10 min\n await sqlite.execute({\n sql:\n `INSERT INTO smcp_auth_codes (code, client_id, user_id, redirect_uri, code_challenge, code_challenge_method, scope, resource, expires_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [\n code.code,\n code.clientId,\n code.userId,\n code.redirectUri,\n code.codeChallenge,\n code.codeChallengeMethod,\n code.scope ?? null,\n code.resource ?? null,\n expires,\n ],\n });\n}\n\nexport async function consumeAuthCode(code: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT * FROM smcp_auth_codes WHERE code = ? AND used = 0 AND expires_at > datetime('now')\",\n args: [code],\n });\n if (res.rows.length === 0) return null;\n await sqlite.execute({\n sql: \"UPDATE smcp_auth_codes SET used = 1 WHERE code = ?\",\n args: [code],\n });\n const r = res.rows[0];\n return {\n code: r[0] as string,\n clientId: r[1] as string,\n userId: r[2] as string,\n redirectUri: r[3] as string,\n codeChallenge: r[4] as string,\n codeChallengeMethod: r[5] as string,\n scope: r[6] as string | null,\n resource: r[7] as string | null,\n };\n}\n\n// ─── Token CRUD ─────────────────────────────────────────────────\n\nexport async function saveAccessToken(t: {\n token: string;\n userId: string;\n clientId: string;\n scope?: string;\n expiresInSec?: number;\n}) {\n const expires = new Date(Date.now() + (t.expiresInSec ?? 3600) * 1000)\n .toISOString();\n await sqlite.execute({\n sql:\n `INSERT INTO smcp_access_tokens (token, user_id, client_id, scope, expires_at)\n VALUES (?, ?, ?, ?, ?)`,\n args: [t.token, t.userId, t.clientId, t.scope ?? null, expires],\n });\n}\n\nexport async function validateAccessToken(token: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT * FROM smcp_access_tokens WHERE token = ? AND expires_at > datetime('now')\",\n args: [token],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n token: r[0] as string,\n userId: r[1] as string,\n clientId: r[2] as string,\n scope: r[3] as string | null,\n expiresAt: r[4] as string,\n };\n}\n\nexport async function saveRefreshToken(t: {\n token: string;\n userId: string;\n clientId: string;\n scope?: string;\n}) {\n const expires = new Date(Date.now() + 30 * 24 * 3600 * 1000).toISOString(); // 30 days\n await sqlite.execute({\n sql:\n `INSERT INTO smcp_refresh_tokens (token, user_id, client_id, scope, expires_at)\n VALUES (?, ?, ?, ?, ?)`,\n args: [t.token, t.userId, t.clientId, t.scope ?? null, expires],\n });\n}\n\nexport async function consumeRefreshToken(token: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT * FROM smcp_refresh_tokens WHERE token = ? AND expires_at > datetime('now')\",\n args: [token],\n });\n if (res.rows.length === 0) return null;\n await sqlite.execute({\n sql: \"DELETE FROM smcp_refresh_tokens WHERE token = ?\",\n args: [token],\n });\n const r = res.rows[0];\n return {\n token: r[0] as string,\n userId: r[1] as string,\n clientId: r[2] as string,\n scope: r[3] as string | null,\n };\n}\n\n// ─── Session CRUD ───────────────────────────────────────────────\n\nexport async function createSession(\n userId: string,\n scope: string = \"consent\",\n): Promise {\n const id = await generateToken(\"sess\");\n const expires = new Date(Date.now() + 15 * 60 * 1000).toISOString(); // 15 min\n await sqlite.execute({\n sql:\n \"INSERT INTO smcp_sessions (id, user_id, expires_at, scope) VALUES (?, ?, ?, ?)\",\n args: [id, userId, expires, scope],\n });\n return id;\n}\n\nexport async function validateSession(sessionId: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT id, user_id, scope FROM smcp_sessions WHERE id = ? AND expires_at > datetime('now')\",\n args: [sessionId],\n });\n if (res.rows.length === 0) return null;\n return {\n userId: res.rows[0][1] as string,\n scope: (res.rows[0][2] as string) ?? \"consent\",\n };\n}\n\nexport async function deleteSession(sessionId: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_sessions WHERE id = ?\",\n args: [sessionId],\n });\n}\n\n// ─── Recovery Token CRUD ─────────────────────────────────────────\n\nconst RECOVERY_EXPIRY_DAYS = 90;\nconst MAX_ACTIVE_RECOVERY_TOKENS = 3;\n\nexport async function createRecoveryToken(\n userId: string,\n): Promise<{ token: string; expiresAt: string } | { error: string }> {\n const countRes = await sqlite.execute({\n sql:\n \"SELECT COUNT(*) FROM smcp_recovery_tokens WHERE user_id = ? AND used = 0 AND expires_at > datetime('now')\",\n args: [userId],\n });\n const activeCount = Number(countRes.rows[0][0]);\n if (activeCount >= MAX_ACTIVE_RECOVERY_TOKENS) {\n return {\n error:\n `Maximum ${MAX_ACTIVE_RECOVERY_TOKENS} active recovery tokens. Revoke one first.`,\n };\n }\n\n const token = await generateToken(\"recover\");\n const tokenHash = await sha256(token);\n const id = generateId();\n const expiresAt = new Date(\n Date.now() + RECOVERY_EXPIRY_DAYS * 24 * 3600 * 1000,\n ).toISOString();\n\n await sqlite.execute({\n sql:\n \"INSERT INTO smcp_recovery_tokens (id, user_id, token_hash, expires_at) VALUES (?, ?, ?, ?)\",\n args: [id, userId, tokenHash, expiresAt],\n });\n\n return { token, expiresAt };\n}\n\nexport async function validateRecoveryToken(\n token: string,\n): Promise<{ userId: string; tokenId: string } | null> {\n const tokenHash = await sha256(token);\n const res = await sqlite.execute({\n sql:\n \"SELECT id, user_id FROM smcp_recovery_tokens WHERE token_hash = ? AND used = 0 AND expires_at > datetime('now')\",\n args: [tokenHash],\n });\n if (res.rows.length === 0) return null;\n return {\n tokenId: res.rows[0][0] as string,\n userId: res.rows[0][1] as string,\n };\n}\n\nexport async function consumeRecoveryToken(tokenId: string) {\n await sqlite.execute({\n sql: \"UPDATE smcp_recovery_tokens SET used = 1 WHERE id = ?\",\n args: [tokenId],\n });\n}\n\nexport async function listRecoveryTokens(userId: string) {\n const res = await sqlite.execute({\n sql:\n \"SELECT id, expires_at, used, created_at FROM smcp_recovery_tokens WHERE user_id = ? ORDER BY created_at DESC\",\n args: [userId],\n });\n return res.rows.map((r) => ({\n id: r[0] as string,\n expiresAt: r[1] as string,\n used: r[2] === 1,\n createdAt: r[3] as string,\n }));\n}\n\nexport async function revokeRecoveryToken(userId: string, tokenId: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_recovery_tokens WHERE id = ? AND user_id = ?\",\n args: [tokenId, userId],\n });\n}\n\n// ─── Cleanup ────────────────────────────────────────────────────\n\nexport async function cleanupExpired() {\n await sqlite.batch([\n {\n sql: \"DELETE FROM smcp_challenges WHERE expires_at < datetime('now')\",\n args: [],\n },\n {\n sql: \"DELETE FROM smcp_auth_codes WHERE expires_at < datetime('now')\",\n args: [],\n },\n {\n sql: \"DELETE FROM smcp_sessions WHERE expires_at < datetime('now')\",\n args: [],\n },\n {\n sql:\n \"DELETE FROM smcp_recovery_tokens WHERE expires_at < datetime('now') OR used = 1\",\n args: [],\n },\n ]);\n}\n\n// ─── User-Room CRUD ─────────────────────────────────────────────\n\nexport async function upsertUserRoom(\n userId: string, roomId: string, access: string,\n label?: string, isDefault?: boolean,\n) {\n if (isDefault) {\n await sqlite.execute({\n sql: \"UPDATE smcp_user_rooms SET is_default = 0 WHERE user_id = ?\",\n args: [userId],\n });\n }\n await sqlite.execute({\n sql: `INSERT INTO smcp_user_rooms (user_id, room_id, access, label, is_default)\n VALUES (?, ?, ?, ?, ?)\n ON CONFLICT(user_id, room_id) DO UPDATE SET\n access = excluded.access,\n label = COALESCE(excluded.label, smcp_user_rooms.label),\n is_default = COALESCE(excluded.is_default, smcp_user_rooms.is_default)`,\n args: [userId, roomId, access, label ?? null, isDefault ? 1 : 0],\n });\n}\n\nexport async function getUserRoom(userId: string, roomId: string) {\n const res = await sqlite.execute({\n sql: \"SELECT user_id, room_id, access, is_default, label, created_at FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?\",\n args: [userId, roomId],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n userId: r[0] as string, roomId: r[1] as string,\n access: r[2] as string, isDefault: r[3] === 1,\n label: r[4] as string | null, createdAt: r[5] as string,\n };\n}\n\nexport async function listUserRooms(userId: string) {\n const res = await sqlite.execute({\n sql: `SELECT user_id, room_id, access, is_default, label, created_at\n FROM smcp_user_rooms WHERE user_id = ?\n ORDER BY is_default DESC, created_at DESC`,\n args: [userId],\n });\n return res.rows.map((r) => ({\n userId: r[0] as string, roomId: r[1] as string,\n access: r[2] as string, isDefault: r[3] === 1,\n label: r[4] as string | null, createdAt: r[5] as string,\n }));\n}\n\nexport async function deleteUserRoom(userId: string, roomId: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_user_rooms WHERE user_id = ? AND room_id = ?\",\n args: [userId, roomId],\n });\n}\n\n// ─── User Session CRUD (OAuth-token-level) ──────────────────────\n\nexport async function createUserSession(params: {\n tokenHash: string; userId: string; clientId: string;\n scope: string; expiresAt: string;\n}) {\n await sqlite.execute({\n sql: `INSERT INTO smcp_user_sessions\n (token_hash, user_id, client_id, scope, expires_at)\n VALUES (?, ?, ?, ?, ?)`,\n args: [params.tokenHash, params.userId, params.clientId,\n params.scope, params.expiresAt],\n });\n}\n\nexport async function getUserSession(tokenHash: string) {\n const res = await sqlite.execute({\n sql: `SELECT token_hash, user_id, client_id, scope, created_at, expires_at\n FROM smcp_user_sessions\n WHERE token_hash = ? AND expires_at > datetime('now')`,\n args: [tokenHash],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n tokenHash: r[0] as string, userId: r[1] as string,\n clientId: r[2] as string, scope: r[3] as string,\n createdAt: r[4] as string, expiresAt: r[5] as string,\n };\n}\n\nexport async function updateSessionScope(tokenHash: string, scope: string) {\n await sqlite.execute({\n sql: `UPDATE smcp_user_sessions SET scope = ? WHERE token_hash = ?`,\n args: [scope, tokenHash],\n });\n}\n\nexport async function deleteUserSession(tokenHash: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_embodiments WHERE session_hash = ?\",\n args: [tokenHash],\n });\n await sqlite.execute({\n sql: \"DELETE FROM smcp_user_sessions WHERE token_hash = ?\",\n args: [tokenHash],\n });\n}\n\nexport async function transferEmbodiments(\n oldTokenHash: string, newTokenHash: string,\n) {\n const res = await sqlite.execute({\n sql: \"SELECT room_id, agent_id FROM smcp_embodiments WHERE session_hash = ?\",\n args: [oldTokenHash],\n });\n if (res.rows.length === 0) return;\n const stmts = res.rows.map((r) => ({\n sql: `INSERT OR IGNORE INTO smcp_embodiments\n (session_hash, room_id, agent_id, embodied_at)\n VALUES (?, ?, ?, datetime('now'))`,\n args: [newTokenHash, r[0] as string, r[1] as string],\n }));\n await sqlite.batch(stmts);\n await sqlite.execute({\n sql: \"DELETE FROM smcp_embodiments WHERE session_hash = ?\",\n args: [oldTokenHash],\n });\n}\n\n// ─── Embodiment CRUD ────────────────────────────────────────────\n\nexport async function setEmbodiment(\n sessionHash: string, roomId: string, agentId: string,\n) {\n await sqlite.execute({\n sql: `INSERT INTO smcp_embodiments (session_hash, room_id, agent_id)\n VALUES (?, ?, ?)\n ON CONFLICT(session_hash, room_id) DO UPDATE SET\n agent_id = excluded.agent_id,\n embodied_at = datetime('now')`,\n args: [sessionHash, roomId, agentId],\n });\n}\n\nexport async function getEmbodiment(sessionHash: string, roomId: string) {\n const res = await sqlite.execute({\n sql: `SELECT agent_id FROM smcp_embodiments\n WHERE session_hash = ? AND room_id = ?`,\n args: [sessionHash, roomId],\n });\n if (res.rows.length === 0) return null;\n return res.rows[0][0] as string;\n}\n\nexport async function listEmbodiments(sessionHash: string) {\n const res = await sqlite.execute({\n sql: `SELECT room_id, agent_id, embodied_at FROM smcp_embodiments\n WHERE session_hash = ? ORDER BY embodied_at DESC`,\n args: [sessionHash],\n });\n return res.rows.map((r) => ({\n roomId: r[0] as string, agentId: r[1] as string,\n embodiedAt: r[2] as string,\n }));\n}\n\nexport async function removeEmbodiment(sessionHash: string, roomId: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_embodiments WHERE session_hash = ? AND room_id = ?\",\n args: [sessionHash, roomId],\n });\n}\n\nexport async function removeAllEmbodiments(sessionHash: string) {\n await sqlite.execute({\n sql: \"DELETE FROM smcp_embodiments WHERE session_hash = ?\",\n args: [sessionHash],\n });\n}\n\nexport async function findSessionsByUserClient(\n userId: string, clientId: string, excludeHash?: string,\n) {\n let sql = `SELECT token_hash FROM smcp_user_sessions\n WHERE user_id = ? AND client_id = ? AND expires_at > datetime('now')`;\n const args: any[] = [userId, clientId];\n if (excludeHash) {\n sql += ` AND token_hash != ?`;\n args.push(excludeHash);\n }\n const res = await sqlite.execute({ sql, args });\n return res.rows.map(r => r[0] as string);\n}\n\n\n// ═══════════════════════════════════════════════════════════════════\n// Unified Tokens (Phase 1 — v7 auth model)\n// ═══════════════════════════════════════════════════════════════════\n\nexport async function mintToken(params: {\n userId: string;\n scope: string;\n label?: string;\n roomId?: string;\n agentId?: string;\n clientId?: string;\n expiresInSec?: number;\n withRefresh?: boolean;\n}): Promise<{ id: string; token: string; refreshToken?: string; expiresAt: string | null }> {\n const id = generateId();\n const token = await generateToken(\"tok\");\n const tokenHash = await sha256(token);\n const expiresAt = params.expiresInSec\n ? new Date(Date.now() + params.expiresInSec * 1000).toISOString()\n : null;\n\n let refreshToken: string | undefined;\n let refreshHash: string | null = null;\n if (params.withRefresh) {\n refreshToken = await generateToken(\"ref\");\n refreshHash = await sha256(refreshToken);\n }\n\n await sqlite.execute({\n sql: `INSERT INTO tokens (id, token_hash, refresh_hash, minted_by, scope, label,\n room_id, agent_id, client_id, expires_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [id, tokenHash, refreshHash, params.userId, params.scope,\n params.label ?? null, params.roomId ?? null, params.agentId ?? null,\n params.clientId ?? null, expiresAt],\n });\n\n return { id, token, refreshToken, expiresAt };\n}\n\nexport async function validateTokenByHash(hash: string): Promise<{\n id: string; mintedBy: string; scope: string; label: string | null;\n roomId: string | null; agentId: string | null; clientId: string | null;\n expiresAt: string | null; createdAt: string;\n} | null> {\n const res = await sqlite.execute({\n sql: `SELECT id, minted_by, scope, label, room_id, agent_id, client_id,\n expires_at, created_at\n FROM tokens\n WHERE token_hash = ? AND revoked = 0\n AND (expires_at IS NULL OR expires_at > datetime('now'))`,\n args: [hash],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string, mintedBy: r[1] as string, scope: r[2] as string,\n label: r[3] as string | null, roomId: r[4] as string | null,\n agentId: r[5] as string | null, clientId: r[6] as string | null,\n expiresAt: r[7] as string | null, createdAt: r[8] as string,\n };\n}\n\nexport async function validateRefreshByHash(hash: string): Promise<{\n id: string; mintedBy: string; scope: string; clientId: string | null;\n} | null> {\n const res = await sqlite.execute({\n sql: `SELECT id, minted_by, scope, client_id\n FROM tokens\n WHERE refresh_hash = ? AND revoked = 0\n AND (expires_at IS NULL OR expires_at > datetime('now'))`,\n args: [hash],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n id: r[0] as string, mintedBy: r[1] as string,\n scope: r[2] as string, clientId: r[3] as string | null,\n };\n}\n\nexport async function refreshUnifiedToken(oldRefreshHash: string, newExpiresInSec = 3600): Promise<{\n id: string; token: string; refreshToken: string; expiresAt: string;\n} | null> {\n const old = await validateRefreshByHash(oldRefreshHash);\n if (!old) return null;\n\n // Revoke old token\n await sqlite.execute({\n sql: `UPDATE tokens SET revoked = 1 WHERE id = ?`,\n args: [old.id],\n });\n\n // Mint new with same scope\n const result = await mintToken({\n userId: old.mintedBy,\n scope: old.scope,\n clientId: old.clientId ?? undefined,\n expiresInSec: newExpiresInSec,\n withRefresh: true,\n });\n\n // Transfer embodiments from old token to new\n await sqlite.execute({\n sql: `UPDATE smcp_embodiments SET session_hash = ?\n WHERE session_hash = (SELECT token_hash FROM tokens WHERE id = ?)`,\n args: [await sha256(result.token), old.id],\n }).catch(() => {});\n\n return {\n id: result.id,\n token: result.token,\n refreshToken: result.refreshToken!,\n expiresAt: result.expiresAt!,\n };\n}\n\nexport async function revokeToken(tokenId: string, userId: string): Promise {\n const res = await sqlite.execute({\n sql: `UPDATE tokens SET revoked = 1 WHERE id = ? AND minted_by = ?`,\n args: [tokenId, userId],\n });\n return (res.rowsAffected ?? 0) > 0;\n}\n\nexport async function listUserTokens(userId: string): Promise> {\n const res = await sqlite.execute({\n sql: `SELECT id, scope, label, room_id, agent_id, client_id, revoked,\n expires_at, created_at\n FROM tokens WHERE minted_by = ?\n ORDER BY created_at DESC LIMIT 100`,\n args: [userId],\n });\n return res.rows.map((r: any[]) => ({\n id: r[0] as string, scope: r[1] as string, label: r[2] as string | null,\n roomId: r[3] as string | null, agentId: r[4] as string | null,\n clientId: r[5] as string | null, revoked: r[6] === 1,\n expiresAt: r[7] as string | null, createdAt: r[8] as string,\n }));\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// Device Authorization Codes\n// ═══════════════════════════════════════════════════════════════════\n\nfunction generateUserCode(): string {\n const chars = \"ABCDEFGHJKLMNPQRSTUVWXYZ23456789\"; // no I/O/0/1\n const left = Array.from({ length: 4 }, () => chars[Math.floor(Math.random() * chars.length)]).join(\"\");\n const right = Array.from({ length: 4 }, () => chars[Math.floor(Math.random() * chars.length)]).join(\"\");\n return `${left}-${right}`;\n}\n\nexport async function createDeviceCode(scope: string, clientId?: string): Promise<{\n deviceCode: string; userCode: string; expiresAt: string;\n}> {\n const deviceCode = await generateToken(\"dev\");\n let userCode = generateUserCode();\n\n // Ensure unique user_code (unlikely collision but be safe)\n for (let i = 0; i < 5; i++) {\n try {\n const expiresAt = new Date(Date.now() + 15 * 60 * 1000).toISOString(); // 15 min\n await sqlite.execute({\n sql: `INSERT INTO device_codes (device_code, user_code, client_id, scope, expires_at)\n VALUES (?, ?, ?, ?, ?)`,\n args: [deviceCode, userCode, clientId ?? \"cli\", scope, expiresAt],\n });\n return { deviceCode, userCode, expiresAt };\n } catch (e: any) {\n if (e.message?.includes(\"UNIQUE\") && e.message?.includes(\"user_code\")) {\n userCode = generateUserCode();\n continue;\n }\n throw e;\n }\n }\n throw new Error(\"Failed to generate unique user code\");\n}\n\nexport async function getDeviceCode(deviceCode: string): Promise<{\n deviceCode: string; userCode: string; scope: string; status: string;\n approvedBy: string | null; expiresAt: string;\n} | null> {\n const res = await sqlite.execute({\n sql: `SELECT device_code, user_code, scope, status, approved_by, expires_at\n FROM device_codes WHERE device_code = ?`,\n args: [deviceCode],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n deviceCode: r[0] as string, userCode: r[1] as string,\n scope: r[2] as string, status: r[3] as string,\n approvedBy: r[4] as string | null, expiresAt: r[5] as string,\n };\n}\n\nexport async function getDeviceCodeByUserCode(userCode: string): Promise<{\n deviceCode: string; userCode: string; scope: string; status: string;\n approvedBy: string | null; expiresAt: string;\n} | null> {\n const res = await sqlite.execute({\n sql: `SELECT device_code, user_code, scope, status, approved_by, expires_at\n FROM device_codes\n WHERE user_code = ? AND expires_at > datetime('now')`,\n args: [userCode],\n });\n if (res.rows.length === 0) return null;\n const r = res.rows[0];\n return {\n deviceCode: r[0] as string, userCode: r[1] as string,\n scope: r[2] as string, status: r[3] as string,\n approvedBy: r[4] as string | null, expiresAt: r[5] as string,\n };\n}\n\nexport async function approveDeviceCode(deviceCode: string, userId: string): Promise {\n const res = await sqlite.execute({\n sql: `UPDATE device_codes SET status = 'approved', approved_by = ?\n WHERE device_code = ? AND status = 'pending'\n AND expires_at > datetime('now')`,\n args: [userId, deviceCode],\n });\n return (res.rowsAffected ?? 0) > 0;\n}\n\nexport async function denyDeviceCode(deviceCode: string): Promise {\n const res = await sqlite.execute({\n sql: `UPDATE device_codes SET status = 'denied'\n WHERE device_code = ? AND status = 'pending'`,\n args: [deviceCode],\n });\n return (res.rowsAffected ?? 0) > 0;\n}\n\nexport async function consumeDeviceCode(deviceCode: string): Promise<{\n scope: string; approvedBy: string;\n} | null> {\n const dc = await getDeviceCode(deviceCode);\n if (!dc || dc.status !== \"approved\" || !dc.approvedBy) return null;\n if (new Date(dc.expiresAt) < new Date()) return null;\n // Mark consumed by setting status\n await sqlite.execute({\n sql: `UPDATE device_codes SET status = 'consumed' WHERE device_code = ?`,\n args: [deviceCode],\n });\n return { scope: dc.scope, approvedBy: dc.approvedBy };\n}\n\nexport async function cleanupDeviceCodes() {\n await sqlite.execute({\n sql: `DELETE FROM device_codes WHERE expires_at < datetime('now')`,\n args: [],\n });\n}\n\n// ─── Room invitation ─────────────────────────────────────────────\n\nexport async function inviteUserToRoom(\n userId: string, roomId: string, role: string, invitedBy: string, label?: string,\n) {\n await sqlite.execute({\n sql: `INSERT INTO smcp_user_rooms (user_id, room_id, access, invited_by, label)\n VALUES (?, ?, ?, ?, ?)\n ON CONFLICT(user_id, room_id) DO UPDATE SET\n access = excluded.access, invited_by = excluded.invited_by`,\n args: [userId, roomId, role, invitedBy, label ?? null],\n });\n}\n\n\nexport async function updateDeviceCodeScope(deviceCode: string, scope: string) {\n await sqlite.execute({\n sql: `UPDATE device_codes SET scope = ? WHERE device_code = ?`,\n args: [scope, deviceCode],\n });\n}\n",[],[412,966],"7b5e9c32-1e50-11f1-9151-42dde27851f2","auth.tsx","9f4ffe5e-18a3-11f1-b05e-42dde27851f2",548,["D",1773346644107],"/**\n * auth.tsx — Barrel re-exports for MCP auth subsystem.\n *\n * All implementations have been extracted to focused modules.\n * This file preserves the import contract for mcp/mcp.ts.\n */\n\n// OAuth 2.1 protocol\nexport { handlePRM, handleASMetadata, handleDCR, handleConsent, handleToken } from \"./oauth.ts\";\n\n// WebAuthn passkeys\nexport { handleRegisterOptions, handleRegisterVerify, handleAuthOptions, handleAuthVerify } from \"./webauthn.ts\";\n\n// Management UI + API, authorize page, recovery flow\nexport {\n handleAuthorize,\n handleManagePage,\n handleManageApi,\n handleRecoverPage,\n handleRecoverValidate,\n handleRecoverRegisterOptions,\n handleRecoverRegisterVerify,\n} from \"./manage.tsx\";\n\n// Legacy token resolution (used by tool-context.ts legacy fallback path)\nexport { resolveToken } from \"./vault.ts\";\n",[],[412,974],"4c86b62c-18a8-11f1-b8ac-42dde27851f2","406e96ac-18a8-11f1-9ea5-42dde27851f2",237,["D",1772724654196],"# sync-mcp\n\nMCP server for [sync](https://sync.parc.land) — the multi-agent coordination\nplatform.\n\nConnects any MCP client to sync rooms using the **read → evaluate → act**\nrhythm. Authenticate once with a passkey, then create rooms, join as agents,\ninvoke actions, and send messages — no tokens to copy-paste.\n\n**Live endpoint:** `https://mcp.sync.parc.land/mcp`\n\n## What is sync?\n\nsync is a coordination layer for multi-agent systems. Agents (human or AI) join\n**rooms**, observe shared **state**, invoke **actions** that mutate state\natomically, and communicate via **messages**. Everything is expressed through\n[CEL](https://cel.dev/) expressions and a small set of primitives.\n\nsync-mcp exposes the full sync API as 16 MCP tools, so any MCP-compatible client\ncan participate as a first-class agent.\n\n## Quick start\n\n### Claude.ai (web / mobile / desktop app)\n\n1. Open **Settings → Connectors** (or click the tools icon → **Manage\n Connectors**)\n2. Click **Add custom connector**\n3. Enter the server URL:\n ```\n https://mcp.sync.parc.land/mcp\n ```\n4. Click **Add**\n5. When prompted, **register a passkey** (or sign in if you already have one)\n and **grant consent**\n\nThat's it. Claude now has access to all 16 sync tools. Try asking:\n\n> \"Create a new sync room called 'planning' and send a hello message.\"\n\n### Claude Code (CLI)\n\nAdd sync-mcp as a remote HTTP server. Pick the scope that fits your use case:\n\n**User scope** — available across all your projects:\n\n```bash\nclaude mcp add --transport http sync-mcp --scope user https://mcp.sync.parc.land/mcp\n```\n\n**Local scope** — current project only (default):\n\n```bash\nclaude mcp add --transport http sync-mcp https://mcp.sync.parc.land/mcp\n```\n\n**Project scope** — shared with your team via `.mcp.json`:\n\n```bash\nclaude mcp add --transport http sync-mcp --scope project https://mcp.sync.parc.land/mcp\n```\n\nThen authenticate:\n\n```bash\n# Inside Claude Code, trigger the OAuth flow:\n/mcp\n# Select sync-mcp → Authenticate → complete passkey registration in browser\n```\n\nVerify the connection:\n\n```bash\nclaude mcp list\nclaude mcp get sync-mcp\n```\n\n### Manual JSON configuration\n\nIf you prefer editing config files directly, add this to your configuration:\n\n**Claude Code** (`~/.claude.json` for user scope, or `.mcp.json` at project root\nfor project scope):\n\n```json\n{\n \"mcpServers\": {\n \"sync-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.sync.parc.land/mcp\"\n }\n }\n}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"sync-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"mcp-remote\", \"https://mcp.sync.parc.land/mcp\"]\n }\n }\n}\n```\n\nAfter editing config files, restart the client for changes to take effect.\n\n## Authentication\n\nsync-mcp uses **OAuth 2.1 with WebAuthn passkeys** — no passwords, no API keys.\n\nThe first time an MCP client connects, the server returns an HTTP 401 with a\n`WWW-Authenticate` header pointing to the OAuth discovery endpoints. The client\n(Claude) handles the flow automatically:\n\n1. **Discovery** — client fetches `/.well-known/oauth-protected-resource` →\n `/.well-known/oauth-authorization-server`\n2. **Client registration** — client registers itself via Dynamic Client\n Registration (DCR)\n3. **Authorization** — client opens the authorize page in your browser\n4. **Passkey** — you register a new passkey (or sign in with an existing one)\n5. **Consent** — you approve access for the MCP client\n6. **Token exchange** — client receives an OAuth access token (1 hour,\n auto-refreshed)\n\nAll subsequent tool calls are authenticated automatically. Tokens refresh\ntransparently via refresh tokens (30-day lifetime).\n\n### Token vault\n\nWhen authenticated, sync tokens are automatically stored in your personal\n**vault**:\n\n- Creating a room → room token + view token auto-vaulted\n- Joining a room as an agent → agent token auto-vaulted\n- Setting a default room → subsequent calls resolve room + token automatically\n\nThis means most tool calls need **zero parameters** — the server resolves your\nroom and token from the vault. You can still pass explicit `room` and `token`\nparameters to override vault resolution.\n\n### Backward compatibility\n\nIf you can't or don't want to use OAuth, every tool still accepts explicit\n`room` and `token` parameters. The server works with or without authentication —\nOAuth just removes the friction of passing tokens on every call.\n\n## Tools\n\nsync-mcp exposes 16 tools organized around sync's core concepts:\n\n### Room lifecycle\n\n| Tool | Description |\n| ------------------ | ---------------------------------------------------------- |\n| `sync_create_room` | Create a new room. Auto-vaults tokens when authenticated. |\n| `sync_list_rooms` | List rooms accessible with current auth or explicit token. |\n| `sync_join_room` | Join a room as an agent. Auto-vaults agent token. |\n\n### Core rhythm (read → act)\n\n| Tool | Description |\n| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| `sync_read_context` | **The primary read.** Returns state, views, agents, actions, messages. Supports context shaping via `depth`, `only`, `compact`. |\n| `sync_invoke_action` | **The primary write.** Invoke any action (built-in or custom). All state mutations flow through actions. |\n| `sync_wait` | Block until a CEL condition becomes true (max 25s). For event-driven coordination. |\n\n### Registration\n\n| Tool | Description |\n| ---------------------- | ----------------------------------------------------------------------------------- |\n| `sync_register_action` | Register a new action — define write effects, preconditions, parameters, cooldowns. |\n| `sync_register_view` | Register a computed view — a named CEL expression for derived state. |\n\n### Messaging\n\n| Tool | Description |\n| ------------------- | ----------------------------------------------------------------------------------------------- |\n| `sync_send_message` | Send a message. Supports `kind` (chat, proposal, etc.) and `to` for directed attention routing. |\n\n### Utilities\n\n| Tool | Description |\n| -------------------- | ------------------------------------------------------------------------ |\n| `sync_help` | Access the help system — guides, standard library, vocabulary bootstrap. |\n| `sync_eval_cel` | Evaluate a CEL expression against current room state. |\n| `sync_delete_action` | Remove an action from a room. |\n| `sync_delete_view` | Remove a view from a room. |\n\n### Vault management\n\n| Tool | Description |\n| ------------------- | -------------------------------------------------------------------------- |\n| `sync_vault_list` | List all stored tokens (room, agent, view) with their labels and defaults. |\n| `sync_vault_store` | Manually store a sync token in the vault. |\n| `sync_vault_remove` | Remove a token from the vault. |\n\n## Typical workflow\n\nHere's what a typical session looks like once authenticated:\n\n```\nYou: Create a room called \"sprint-planning\" and make it my default.\n\nClaude: [sync_create_room] → room created, tokens vaulted, set as default\n\nYou: Join as an agent named \"facilitator\".\n\nClaude: [sync_join_room] → joined, agent token vaulted\n\nYou: Register an action called \"add_item\" that appends to a backlog list.\n\nClaude: [sync_register_action] → action registered with write template\n\nYou: Add \"Fix login bug\" to the backlog.\n\nClaude: [sync_invoke_action: add_item] → item appended to state\n\nYou: What's the current state?\n\nClaude: [sync_read_context] → shows backlog, agents, actions, messages\n```\n\nNo room IDs or tokens needed in any of those calls — everything resolves from\nthe vault.\n\n## Architecture\n\n```\n┌─────────────┐ OAuth 2.1 ┌──────────────────┐\n│ MCP Client │◄──────────────────►│ sync-mcp │\n│ (Claude) │ Bearer token │ (Val.town) │\n└─────────────┘ │ │\n │ ┌────────────┐ │\n │ │ OAuth/PKCE │ │\n │ │ WebAuthn │ │\n │ │ Token vault│ │\n │ │ SQLite │ │\n │ └────────────┘ │\n │ │ │\n │ ▼ │\n │ ┌────────────┐ │\n │ │ sync API │──┼──► sync.parc.land\n │ │ proxy │ │\n │ └────────────┘ │\n └──────────────────┘\n```\n\nsync-mcp is both an **OAuth Authorization Server** (issues its own tokens,\nmanages WebAuthn credentials) and an **MCP Resource Server** (validates tokens\non every request, proxies to sync API).\n\n### Files\n\n| File | Purpose |\n| ---------- | --------------------------------------------------------------------------------------------------------------------------- |\n| `main.ts` | HTTP router — MCP JSON-RPC, OAuth endpoints, WebAuthn endpoints, vault API |\n| `auth.ts` | OAuth 2.1 flow (PRM, AS metadata, DCR, authorize, consent, token exchange) + WebAuthn + vault management + token resolution |\n| `tools.ts` | 16 MCP tool definitions with context-aware auth resolution |\n| `db.ts` | SQLite schema (10 tables) + all CRUD helpers |\n\n### Endpoints\n\n| Path | Method | Auth | Purpose |\n| ----------------------------------------- | ----------------- | ---------------- | -------------------------------------------------- |\n| `/mcp` | `POST` | Bearer | MCP JSON-RPC 2.0 |\n| `/mcp` | `GET` | — | Server info |\n| `/.well-known/oauth-protected-resource` | `GET` | — | Protected Resource Metadata (RFC 9728) |\n| `/.well-known/oauth-authorization-server` | `GET` | — | Authorization Server Metadata (RFC 8414) |\n| `/oauth/register` | `POST` | — | Dynamic Client Registration (RFC 7591) |\n| `/oauth/authorize` | `GET` | — | Authorization page (WebAuthn + consent UI) |\n| `/oauth/consent` | `POST` | Session | Exchange session for auth code |\n| `/oauth/token` | `POST` | — | Token exchange (authorization_code, refresh_token) |\n| `/webauthn/register/options` | `POST` | — | WebAuthn registration challenge |\n| `/webauthn/register/verify` | `POST` | — | WebAuthn registration verification |\n| `/webauthn/authenticate/options` | `POST` | — | WebAuthn authentication challenge |\n| `/webauthn/authenticate/verify` | `POST` | — | WebAuthn authentication verification |\n| `/vault` | `GET/POST/DELETE` | Bearer | Token vault CRUD |\n| `/manage` | `GET` | Session | Management UI (vault, passkeys, recovery tokens) |\n| `/manage/api/*` | `GET/POST/DELETE` | Session | Management API |\n| `/recover` | `GET` | — | Recovery page (passkey re-registration) |\n| `/recover/validate` | `POST` | — | Validate recovery token |\n| `/recover/register/*` | `POST` | Recovery session | Register new passkey via recovery token |\n\n## Passkey management\n\nPasskeys are bound to a **Relying Party ID** (RP ID). sync-mcp uses `parc.land`\nas the stable RP ID, so passkeys work on any `*.parc.land` origin (e.g.\n`mcp.sync.parc.land`, `auth.parc.land`). On non-`parc.land` hostnames (like\nVal.town dev endpoints), the RP ID falls back to the request hostname — giving\neach dev endpoint its own isolated passkeys.\n\n**Recovery tokens** let you register a new passkey on a different hostname while\nkeeping your existing account, vault, and rooms. Generate one at `/manage`, then\nuse it at `/recover` on the new hostname. Useful for domain migrations, device\nloss, or bridging between production and dev passkeys.\n\n## Self-hosting\n\nsync-mcp runs on [Val.town](https://val.town). To fork and run your own\ninstance:\n\n1. Fork the `c15r/sync-mcp` val on Val.town\n2. Set the `WEBAUTHN_RP_ID` environment variable to your domain (e.g.\n `example.com`)\n3. Optionally set the `SYNC_URL` environment variable (defaults to\n `https://sync.parc.land`)\n4. Configure a custom domain pointing to the val's HTTP endpoint\n5. The HTTP handler in `main.ts` starts serving immediately\n\nThe SQLite database is automatically provisioned per-val by Val.town. Set\n`WEBAUTHN_RP_ID` to your root domain so passkeys survive hostname changes.\nWithout it, passkeys bind to the request hostname.\n\n## Standards\n\n- **MCP**: [Model Context Protocol](https://modelcontextprotocol.io/) —\n Streamable HTTP transport, JSON-RPC 2.0\n- **OAuth 2.1**: Authorization Code + PKCE (S256), refresh token rotation,\n Dynamic Client Registration\n- **WebAuthn**: Passkey registration and authentication via\n [@simplewebauthn/server](https://simplewebauthn.dev/)\n- **RFC 9728**: OAuth 2.0 Protected Resource Metadata\n- **RFC 8414**: OAuth 2.0 Authorization Server Metadata\n- **RFC 7591**: OAuth 2.0 Dynamic Client Registration\n\n## Links\n\n- **sync platform**: [sync.parc.land](https://sync.parc.land)\n- **sync-mcp**: [mcp.sync.parc.land](https://mcp.sync.parc.land)\n- **Management UI**:\n [mcp.sync.parc.land/manage](https://mcp.sync.parc.land/manage)\n- **sync dashboard**: [sync.parc.land](https://sync.parc.land/?room=workspace)\n- **Val.town project**:\n [val.town/x/c15r/sync-mcp](https://www.val.town/x/c15r/sync-mcp)\n- **MCP specification**:\n [modelcontextprotocol.io](https://modelcontextprotocol.io/)\n\n## License\n\nMIT",[],[412,340],["D",1772722645641],[525,526,527,528,529,530,531,532,533,534,535,536,537],[412],"b27e5772-1ebc-11f1-b619-42dde27851f2","7834bb68-13fb-11f1-b99c-42dde27851f2",557,["D",1773393122225],"import type { Agent } from \"./types.ts\";\n\nexport function esc(s: any): string {\n if (s == null) return \"\";\n return String(s)\n .replace(/&/g, \"&\")\n .replace(//g, \">\")\n .replace(/\"/g, \""\");\n}\n\nexport function rel(ts: string | null | undefined): string {\n if (!ts) return \"\";\n const d = new Date(ts.replace(\" \", \"T\") + (ts.includes(\"Z\") || ts.includes(\"+\") ? \"\" : \"Z\"));\n const s = Math.floor((Date.now() - d.getTime()) / 1000);\n if (s < 5) return \"now\";\n if (s < 60) return s + \"s\";\n const m = Math.floor(s / 60);\n if (m < 60) return m + \"m\";\n const h = Math.floor(m / 60);\n if (h < 24) return h + \"h\";\n return Math.floor(h / 24) + \"d\";\n}\n\nexport function hbc(ts: string | null | undefined): \"stale\" | \"dead\" | \"\" {\n if (!ts) return \"dead\";\n const d = new Date(ts.replace(\" \", \"T\") + (ts.includes(\"Z\") || ts.includes(\"+\") ? \"\" : \"Z\"));\n const m = (Date.now() - d.getTime()) / 60000;\n if (m < 2) return \"\";\n if (m < 10) return \"stale\";\n return \"dead\";\n}\n\nexport function aname(id: string | null | undefined, agentMap: Record): string {\n if (!id) return \"system\";\n const a = agentMap[id];\n return a ? a.name : id.length > 12 ? id.slice(0, 8) + \"…\" : id;\n}\n\nexport function tryParseJson(s: any): any {\n if (typeof s !== \"string\") return s;\n try { return JSON.parse(s); } catch { return s; }\n}\n\n\n/** Relative time from a fixed epoch (e.g. replay start). Returns \"+0s\", \"+14s\", \"+2m\", etc. */\nexport function relTo(ts: string | null | undefined, epochMs: number): string {\n if (!ts) return \"\";\n const d = new Date(ts.replace(\" \", \"T\") + (ts.includes(\"Z\") || ts.includes(\"+\") ? \"\" : \"Z\"));\n const ms = d.getTime() - epochMs;\n if (ms < 0) return \"+0s\";\n const s = Math.floor(ms / 1000);\n if (s < 5) return \"+0s\";\n if (s < 60) return `+${s}s`;\n const m = Math.floor(s / 60);\n if (m < 60) return `+${m}m`;\n const h = Math.floor(m / 60);\n if (h < 24) return `+${h}h`;\n return `+${Math.floor(h / 24)}d`;\n}\n\n/** Heartbeat class relative to a replay playhead rather than Date.now(). */\nexport function hbcAt(ts: string | null | undefined, playheadMs: number): \"stale\" | \"dead\" | \"\" {\n if (!ts) return \"dead\";\n const d = new Date(ts.replace(\" \", \"T\") + (ts.includes(\"Z\") || ts.includes(\"+\") ? \"\" : \"Z\"));\n const m = (playheadMs - d.getTime()) / 60000;\n if (m < 2) return \"\";\n if (m < 10) return \"stale\";\n return \"dead\";\n}\n",[],[418,191],"89c6c68c-2198-11f1-9238-42dde27851f2","types.ts","7834b302-13fb-11f1-b99c-42dde27851f2",["D",1773707445460],"// ── v9 types: state entries include _meta ────────────────────────────────────\n\n/** v9 entry metadata — provenance, trajectory, salience */\nexport interface EntryMeta {\n revision: number;\n updated_at: string;\n writer: string | null;\n via: string | null;\n seq: number | null;\n score: number;\n velocity: number;\n writers: string[];\n first_at: string | null;\n elided: boolean;\n // Action-specific fields\n invocations?: number;\n last_invoked_at?: string | null;\n last_invoked_by?: string | null;\n contested?: string[];\n}\n\n/** A single entry in the state table. Every entity lives here. */\nexport interface StateEntry {\n scope: string;\n key: string;\n sort_key: number | null;\n value: any;\n revision: number;\n updated_at: string;\n /** v9: provenance, trajectory, salience metadata */\n _meta?: EntryMeta | null;\n}\n\n/** Action definition (value of _actions.{id} state entry) */\nexport interface ActionDef {\n description?: string;\n if?: string;\n enabled?: string;\n result?: string;\n writes: any[];\n params?: Record;\n scope: string;\n registered_by?: string;\n timer?: any;\n on_invoke?: any;\n}\n\n/** View definition (value of _views.{id} state entry) */\nexport interface ViewDef {\n expr: string;\n description?: string;\n enabled?: string;\n render?: RenderHint | null;\n scope: string;\n registered_by?: string;\n timer?: any;\n deps?: any[];\n}\n\n/** Agent presence (value of _agents.{id} state entry) */\nexport interface AgentDef {\n name: string;\n role: string;\n status: string;\n grants: string[];\n last_heartbeat?: string;\n joined_at?: string;\n}\n\n/** Salience entry in poll response */\nexport interface SalienceEntry {\n key: string;\n score: number;\n signals: string[];\n}\n\n/** Audit entry */\nexport interface AuditEntry {\n seq: number;\n value: any;\n updated_at: string;\n}\n\n/** The v8 poll response. State is the single data source. */\nexport interface PollDataV8 {\n state: StateEntry[];\n resolved: Record;\n available: Record;\n audit: AuditEntry[];\n salience?: SalienceEntry[];\n}\n\n/** Helper: extract entries for a specific scope */\nexport function scopeEntries(poll: PollDataV8, scope: string): StateEntry[] {\n return poll.state.filter(s => s.scope === scope);\n}\n\n/** Helper: get all unique scopes in the state */\nexport function allScopes(poll: PollDataV8): string[] {\n const s = new Set(poll.state.map(e => e.scope));\n return [...s].sort();\n}\n\n/** Helper: extract action defs with availability and _meta */\nexport function actionsFromState(poll: PollDataV8): Array<{ id: string; def: ActionDef; available: boolean; _meta?: EntryMeta | null }> {\n return scopeEntries(poll, \"_actions\").map(e => ({\n id: e.key,\n def: e.value as ActionDef,\n available: poll.available[e.key] ?? true,\n _meta: e._meta ?? null,\n }));\n}\n\n/** Helper: extract view defs with resolved values */\nexport function viewsFromState(poll: PollDataV8): Array<{ id: string; def: ViewDef; value: any }> {\n return scopeEntries(poll, \"_views\").map(e => ({\n id: e.key,\n def: e.value as ViewDef,\n value: poll.resolved[e.key],\n }));\n}\n\n/** Helper: extract agents */\nexport function agentsFromState(poll: PollDataV8): Array<{ id: string; def: AgentDef }> {\n return scopeEntries(poll, \"_agents\").map(e => ({\n id: e.key,\n def: e.value as AgentDef,\n }));\n}\n\n/** Helper: extract messages (sorted by sort_key) */\nexport function messagesFromState(poll: PollDataV8): StateEntry[] {\n return scopeEntries(poll, \"_messages\").sort((a, b) => (a.sort_key ?? 0) - (b.sort_key ?? 0));\n}\n\n/** Helper: extract shared state */\nexport function sharedState(poll: PollDataV8): StateEntry[] {\n return scopeEntries(poll, \"_shared\");\n}\n\n// ── Legacy types (used by panel components + replay normalizers) ────────────\n\nexport interface Agent {\n id: string;\n name: string;\n role: string;\n status: string;\n last_heartbeat: string;\n waiting_on?: string;\n grants: string;\n joined_at: string;\n}\n\nexport interface StateRow {\n room_id: string;\n scope: string;\n key: string;\n value: any;\n version: number;\n sort_key?: number;\n updated_at: string;\n timer_effect?: string;\n timer_expires_at?: string;\n timer_ticks_left?: number;\n enabled_expr?: string;\n /** v9: entry metadata from poll */\n _meta?: EntryMeta | null;\n}\n\nexport interface RawMessage {\n sort_key: number;\n value: any;\n updated_at: string;\n}\n\nexport interface Action {\n id: string;\n room_id: string;\n scope: string;\n description?: string;\n if?: string;\n available: boolean;\n params?: Record;\n writes?: any[];\n version: number;\n registered_by?: string;\n /** v9: invocations, contested, etc. */\n _meta?: EntryMeta | null;\n}\n\nexport interface RenderHintColumn {\n key: string;\n label?: string;\n width?: string;\n truncate?: number;\n}\n\nexport interface RenderHint {\n type: \"metric\" | \"markdown\" | \"array-table\" | \"view-table\" | \"json\";\n label?: string;\n order?: number;\n group?: string;\n // metric-specific\n unit?: string;\n color?: \"default\" | \"green\" | \"red\" | \"yellow\";\n // array-table-specific\n columns?: RenderHintColumn[];\n max_rows?: number;\n layout?: \"table\" | \"event-log\";\n}\n\nexport interface View {\n id: string;\n room_id: string;\n scope: string;\n description?: string;\n expr: string;\n value: any;\n version: number;\n registered_by?: string;\n render?: RenderHint | null;\n}\n\nexport interface AuditRow {\n sort_key: number;\n value: any;\n updated_at: string;\n}\n\nexport type TokenKind = \"room\" | \"view\" | \"agent\";\n\n// ── Surface types ───────────────────────────────────────────────────────────\n\nexport interface SurfaceMetric {\n id: string;\n type: \"metric\";\n view: string;\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceViewGrid {\n id: string;\n type: \"view-grid\";\n views: string[];\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceViewTable {\n id: string;\n type: \"view-table\";\n views: string[];\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceActionBar {\n id: string;\n type: \"action-bar\";\n actions: string[];\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceActionForm {\n id: string;\n type: \"action-form\";\n action: string;\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceActionChoice {\n id: string;\n type: \"action-choice\";\n actions: string[];\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceFeed {\n id: string;\n type: \"feed\";\n kinds?: string[];\n compose?: boolean;\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceWatch {\n id: string;\n type: \"watch\";\n keys: { scope: string; key: string }[];\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceSection {\n id: string;\n type: \"section\";\n label?: string;\n enabled?: string;\n surfaces: Surface[];\n}\n\nexport interface SurfaceMarkdown {\n id: string;\n type: \"markdown\";\n view: string;\n label?: string;\n enabled?: string;\n}\n\nexport interface SurfaceArrayTable {\n id: string;\n type: \"array-table\";\n view: string;\n label?: string;\n enabled?: string;\n columns?: RenderHintColumn[];\n max_rows?: number;\n}\n\nexport type Surface =\n | SurfaceMetric\n | SurfaceViewGrid\n | SurfaceViewTable\n | SurfaceArrayTable\n | SurfaceActionBar\n | SurfaceActionForm\n | SurfaceActionChoice\n | SurfaceFeed\n | SurfaceWatch\n | SurfaceSection\n | SurfaceMarkdown;\n\n// ── Dashboard config ────────────────────────────────────────────────────────\n\nexport interface DashboardConfig {\n title?: string;\n subtitle?: string;\n default_tab?: string;\n tabs?: string[];\n pinned_views?: string[];\n hero?: string | null;\n surfaces?: Surface[];\n hide_debug?: boolean;\n}\n",[],[418,999],"69ca886e-18b0-11f1-ad37-42dde27851f2","theme.ts","69ca88dc-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],"/** Shared design tokens for styled-components.\n *\n * These match the CSS custom properties in shell.ts :root.\n * Use in styled-components via ${({ theme }) => theme.bg} or import directly.\n *\n * Note: the dashboard uses a dark theme always. Landing/docs pages use\n * the \"landing\" subset which is light-default with dark media query.\n * The MCP auth pages use the dark dashboard theme.\n */\n\nexport const theme = {\n // Core dark palette (dashboard + MCP pages)\n bg: \"#0d1117\",\n fg: \"#c9d1d9\",\n dim: \"#484f58\",\n border: \"#21262d\",\n accent: \"#58a6ff\",\n green: \"#3fb950\",\n yellow: \"#d29922\",\n red: \"#f85149\",\n surface: \"#161b22\",\n surface2: \"#1c2129\",\n purple: \"#bc8cff\",\n orange: \"#f0883e\",\n\n // Typography\n fontFamily:\n '-apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif',\n monoFamily: '\"SF Mono\", \"Fira Code\", \"Cascadia Code\", monospace',\n\n // Spacing\n radius: \"8px\",\n radiusSm: \"4px\",\n radiusLg: \"12px\",\n} as const;\n\nexport type Theme = typeof theme;\n",[],[418,1006],"7834afec-13fb-11f1-b99c-42dde27851f2","styled.ts","7834b06e-13fb-11f1-b99c-42dde27851f2",["D",1772210619912],"export { default as styled, css, keyframes, createGlobalStyle } from \"https://esm.sh/styled-components@6?deps=react@18.2.0,react-dom@18.2.0\";\n",[],[418,1013],"69ca7bda-18b0-11f1-ad37-42dde27851f2","ssr.ts","69ca7c5c-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Server-side rendering utility.\n *\n * Renders a React component to HTML string with styled-components CSS extraction.\n * Used by route handlers in main.ts / mcp/auth.ts to produce complete HTML pages.\n */\nimport { renderToString } from \"https://esm.sh/react-dom@18.2.0/server\";\nimport { ServerStyleSheet } from \"https://esm.sh/styled-components@6?deps=react@18.2.0,react-dom@18.2.0\";\nimport type { ReactElement } from \"https://esm.sh/react@18.2.0\";\nimport { shell, type ShellOptions } from \"./shell.ts\";\n\nexport interface RenderPageOptions {\n /** The React element to render */\n element: ReactElement;\n /** Path to the client hydration script (e.g. \"/frontend/pages/recover/client.tsx\") */\n entry: string;\n /** Props to serialize for client hydration */\n props?: Record;\n /** Page title */\n title?: string;\n /** Additional scripts (e.g. WebAuthn UMD) */\n headScripts?: string;\n /** HTTP status code (default 200) */\n status?: number;\n}\n\n/** Render a React page to a full HTML Response with SSR + styled-components CSS. */\nexport function renderPage(opts: RenderPageOptions): Response {\n const {\n element,\n entry,\n props = {},\n title,\n headScripts,\n status = 200,\n } = opts;\n\n let htmlBody: string;\n let css: string;\n\n const sheet = new ServerStyleSheet();\n try {\n htmlBody = renderToString(sheet.collectStyles(element));\n css = sheet.getStyleTags();\n } catch (err) {\n // Fallback: render without styled-components if SSR fails\n console.error(\"SSR styled-components error, falling back:\", err);\n htmlBody = renderToString(element);\n css = \"\";\n } finally {\n sheet.seal();\n }\n\n const fullHtml = shell({\n html: htmlBody,\n css,\n props,\n entry,\n title,\n headScripts,\n });\n\n return new Response(fullHtml, {\n status,\n headers: {\n \"Content-Type\": \"text/html; charset=utf-8\",\n \"Cache-Control\": \"no-cache, no-store, must-revalidate\",\n },\n });\n}\n",[],[418,1020],"7cb9ac00-2127-11f1-921e-42dde27851f2","shell.ts","69ca6a82-18b0-11f1-ad37-42dde27851f2",628,["D",1773658890446],"/** SSR HTML shell — wraps rendered React + extracted styled-components CSS.\n *\n * Each page calls shell() with:\n * html — renderToString output\n * css — ServerStyleSheet.getStyleTags() output\n * props — serializable data passed to client for hydration\n * entry — path to the page's client.tsx hydration script\n * title — page \n * meta — optional extra <meta> tags\n */\n\nexport interface ShellOptions {\n html: string;\n css: string;\n props?: Record<string, unknown>;\n entry: string;\n title?: string;\n meta?: string;\n /** Additional <script> tags to include in <head> (e.g. UMD bundles) */\n headScripts?: string;\n}\n\nexport function shell(opts: ShellOptions): string {\n const {\n html,\n css,\n props = {},\n entry,\n title = \"sync — Multi-Agent Coordination\",\n meta = \"\",\n headScripts = \"\",\n } = opts;\n\n // Escape JSON for safe embedding in <script type=\"application/json\">\n const serializedProps = JSON.stringify(props)\n .replace(/</g, \"\\\\u003c\")\n .replace(/>/g, \"\\\\u003e\")\n .replace(/&/g, \"\\\\u0026\");\n\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>${escapeHtml(title)}\n\n\n${meta}\n\n\n${css}\n${headScripts}\n\n\n\n\n

${html}

\n\n\n\n`;\n}\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(//g, \">\")\n .replace(/\"/g, \""\");\n}",[],[418,1027],"edff2272-1b15-11f1-8869-42dde27851f2","renderInference.ts","3310196a-1a81-11f1-8ad0-42dde27851f2",427,["D",1772991642621],"/**\n * Pure value-shape → surface type inference.\n * No side effects, no imports from React or the DOM.\n *\n * Used by the dashboard to decide how to auto-surface a view that has\n * no explicit render.type, and to drive ArrayTableSurface's column logic.\n */\n\nimport type { RenderHintColumn } from \"./types.ts\";\n\n// ── Result types ──────────────────────────────────────────────────────────────\n\nexport type SurfaceHint =\n | { type: \"metric\" }\n | { type: \"markdown\" }\n | { type: \"array-table\"; homogeneous: boolean; columns: string[] }\n | { type: \"object-table\"; keys: string[] }\n | { type: \"json\" }\n | { type: \"error\"; message: string };\n\n// ── Column inference ──────────────────────────────────────────────────────────\n\nconst SAMPLE_SIZE = 5;\n\n/** Returns the sorted key list from an object, or null if not an object. */\nfunction objectKeys(item: any): string[] | null {\n if (item === null || typeof item !== \"object\" || Array.isArray(item)) return null;\n return Object.keys(item);\n}\n\n/**\n * Inspect a homogeneity sample from an array.\n * Returns:\n * { homogeneous: true, columns: [...] } — all sampled items share the same keys\n * { homogeneous: false, columns: [] } — heterogeneous; fallback to json\n *\n * Arrays of scalars are treated as homogeneous with a single synthetic column \"value\".\n */\nexport function inferArrayColumns(arr: any[]): { homogeneous: boolean; columns: string[] } {\n if (arr.length === 0) return { homogeneous: true, columns: [] };\n\n const sample = arr.slice(0, SAMPLE_SIZE);\n\n // All scalars?\n const allScalar = sample.every(\n item => item === null || typeof item !== \"object\"\n );\n if (allScalar) return { homogeneous: true, columns: [\"value\"] };\n\n // All objects?\n const keySets = sample.map(objectKeys);\n if (keySets.some(k => k === null)) {\n // Mixed scalars and objects — heterogeneous\n return { homogeneous: false, columns: [] };\n }\n\n // Compare key sets — allow at most 1 key difference across the sample\n const allKeys = keySets as string[][];\n const baseKeys = allKeys[0];\n const baseSorted = [...baseKeys].sort().join(\",\");\n\n for (const keys of allKeys.slice(1)) {\n const sorted = [...keys].sort().join(\",\");\n if (sorted !== baseSorted) {\n // Count differences\n const baseSet = new Set(baseKeys);\n const otherSet = new Set(keys);\n const added = keys.filter(k => !baseSet.has(k));\n const removed = baseKeys.filter(k => !otherSet.has(k));\n if (added.length + removed.length > 1) {\n return { homogeneous: false, columns: [] };\n }\n }\n }\n\n // Union of all keys in sample order (first item's order wins for stable display)\n const seen = new Set();\n const columns: string[] = [];\n for (const keys of allKeys) {\n for (const k of keys) {\n if (!seen.has(k)) { seen.add(k); columns.push(k); }\n }\n }\n\n return { homogeneous: true, columns };\n}\n\n// ── Top-level inference ───────────────────────────────────────────────────────\n\nconst MARKDOWN_PATTERN = /^#{1,3} |^\\*\\*|^- |\\n#{1,3} |\\n\\*\\*|\\n- |`{1,3}/;\n\nexport function inferSurfaceType(value: any): SurfaceHint {\n // Error sentinel\n if (value && typeof value === \"object\" && \"_error\" in value) {\n return { type: \"error\", message: String(value._error) };\n }\n\n // Null / undefined → metric (shows \"—\")\n if (value === null || value === undefined) return { type: \"metric\" };\n\n // Scalars\n if (typeof value === \"number\" || typeof value === \"boolean\") return { type: \"metric\" };\n\n if (typeof value === \"string\") {\n // Long string or contains markdown → markdown\n if (value.length > 120 || value.includes(\"\\n\") || MARKDOWN_PATTERN.test(value)) {\n return { type: \"markdown\" };\n }\n return { type: \"metric\" };\n }\n\n // Array\n if (Array.isArray(value)) {\n const { homogeneous, columns } = inferArrayColumns(value);\n return { type: \"array-table\", homogeneous, columns };\n }\n\n // Object\n if (typeof value === \"object\") {\n const keys = Object.keys(value);\n // Object with all scalar leaf values → property panel (object-table)\n const allScalarLeaves = keys.every(k => {\n const v = value[k];\n return v === null || typeof v !== \"object\";\n });\n if (allScalarLeaves && keys.length > 0) {\n return { type: \"object-table\", keys };\n }\n return { type: \"json\" };\n }\n\n return { type: \"json\" };\n}\n\n// ── Column resolution (merge inferred + explicit render.columns) ──────────────\n\nexport interface ResolvedColumn {\n key: string;\n label: string;\n width?: string;\n truncate: number;\n}\n\nexport function resolveColumns(\n inferredColumns: string[],\n renderColumns?: RenderHintColumn[] | null,\n): ResolvedColumn[] {\n if (renderColumns && renderColumns.length > 0) {\n return renderColumns.map(c => ({\n key: c.key,\n label: c.label ?? c.key,\n width: c.width,\n truncate: c.truncate ?? 80,\n }));\n }\n return inferredColumns.map(k => ({\n key: k,\n label: k,\n truncate: 80,\n }));\n}\n",[],[418,1035],"1b9468d2-2075-11f1-8859-42dde27851f2","pages.tsx","69c9a4d0-18b0-11f1-ad37-42dde27851f2",["D",1773582277011],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Page renderers for main.ts — SSR each page to a Response. */\nimport { renderPage } from \"./ssr.ts\";\nimport { Landing, parseLandingMd } from \"./components/Landing.tsx\";\nimport { Dashboard } from \"./components/Dashboard.tsx\";\nimport { DocPage, DocsIndex } from \"./components/DocViewer.tsx\";\nimport { Overview } from \"./components/Overview.tsx\";\nimport { mdToHtml } from \"./markdown.ts\";\n\n// Derive ESM base URL from import.meta.url — branch-aware on val.town\n// e.g. https://esm.town/v/c15r/sync@153-v8/frontend/pages.tsx → https://esm.town/v/c15r/sync@153-v8\nconst ESM_BASE = (() => {\n const u = import.meta.url;\n // Strip /frontend/pages.tsx (or similar trailing path)\n const match = u.match(/^(https:\\/\\/esm\\.town\\/v\\/[^/]+\\/[^/]+)/);\n return match ? match[1] : \"https://esm.town/v/c15r/sync\";\n})();\n\nconst LANDING_MD_URL = new URL(\"../reference/landing.md\", import.meta.url);\nconst LANDING_RAW = await fetch(LANDING_MD_URL).then(r => r.text()).catch(() => \"\");\n\nexport function renderLandingPage(): Response {\n const data = parseLandingMd(LANDING_RAW, mdToHtml);\n return renderPage({\n element: ,\n entry: `${ESM_BASE}/frontend/pages/landing/client.tsx`,\n props: { data },\n title: \"sync — Multi-Agent Coordination for AI Workflows\",\n });\n}\n\nexport function renderDashboardPage(roomId: string): Response {\n return renderPage({\n element: ,\n entry: `${ESM_BASE}/frontend/pages/dashboard/client.tsx`,\n props: { roomId },\n title: `${roomId} — sync dashboard`,\n // v8: Load marked.js for prose rendering and mermaid.js for diagram rendering.\n // Surfaces.tsx renderMarkdown() checks for globalThis.marked — this makes it work.\n headScripts: ``,\n });\n}\n\n/** Render a single doc page — markdown is already converted to HTML server-side. */\nexport function renderDocPage(slug: string, title: string, html: string, rawPath?: string): Response {\n return renderPage({\n element: ,\n entry: `${ESM_BASE}/frontend/pages/docs/client.tsx`,\n props: { slug, title, html, rawPath },\n title: `${title} — sync docs`,\n });\n}\n\n/** Render the docs index page listing all available docs. */\nexport function renderDocsIndex(docs: Array<{ slug: string; title: string; category: string }>): Response {\n return renderPage({\n element: ,\n entry: `${ESM_BASE}/frontend/pages/docs/client.tsx`,\n props: { docs },\n title: \"Documentation — sync\",\n });\n}\n\n/** Render the overview / vision & architecture page. */\nexport function renderOverviewPage(): Response {\n return renderPage({\n element: ,\n entry: `${ESM_BASE}/frontend/pages/overview/client.tsx`,\n props: {},\n title: \"Vision & Architecture — sync\",\n headScripts: ``,\n });\n}\n",[],[418,1043],"e6c492dc-1708-11f1-95df-42dde27851f2","mermaid.ts","e6c4935e-1708-11f1-95df-42dde27851f2",["D",1772546242374],"/** Shared mermaid utilities for DocViewer and Landing */\n\nlet _initialized = false;\nlet _mermaid: any = null;\n\nasync function getMermaid(): Promise {\n if (_mermaid) return _mermaid;\n // @ts-ignore — dynamic CDN import\n const mod = await import(\"https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs\");\n _mermaid = mod.default;\n return _mermaid;\n}\n\n/**\n * Call after dangerouslySetInnerHTML renders. Finds .mermaid divs and renders them.\n */\nexport async function runMermaid(): Promise {\n try {\n const m = await getMermaid();\n if (!_initialized) {\n m.initialize({ startOnLoad: false });\n _initialized = true;\n }\n await m.run({ querySelector: \".mermaid\", suppressErrors: true });\n } catch (_e) {\n // silent — mermaid failure shouldn't break the page\n }\n}\n\n/**\n * Rewrite marked's `

…

`\n * into `

…

` so mermaid.run() picks them up.\n */\nexport function processMermaidBlocks(html: string): string {\n return html.replace(\n /

([\\s\\S]*?)<\\/code><\\/pre>/g,\n    '$1
',\n  );\n}\n",[],[418,1050],"49ac4640-1a85-11f1-ac1e-42dde27851f2","markdown.ts","5949a254-1a31-11f1-b757-42dde27851f2",408,["D",1772929519408],"/**\n * Shared markdown → HTML utility. Works in both Deno (server-side) and browser.\n *\n * Uses npm:marked so it can be imported at the top level in pages.tsx for SSR,\n * eliminating the CDN marked script and the client-side \"wait for marked\" dance.\n */\nimport { marked } from \"npm:marked@12\";\nimport { processMermaidBlocks } from \"./mermaid.ts\";\n\nfunction rewriteDocLinks(html: string): string {\n  return html.replace(\n    /href=\"([^\"]*)\"/g,\n    (_match: string, href: string) => {\n      // Already a full URL, anchor, or already a /docs/ link — leave alone\n      if (href.startsWith(\"http\") || href.startsWith(\"#\") || href.startsWith(\"/docs/\")) return `href=\"${href}\"`;\n      // Legacy /?doc=filename.md links in source content\n      if (href.startsWith(\"/?doc=\")) {\n        const slug = href.replace(\"/?doc=\", \"\").replace(/\\.md$/, \"\");\n        return `href=\"/docs/${slug}\"`;\n      }\n      // Bare .md filename or relative path ending in .md → /docs/slug\n      if (href.endsWith(\".md\")) {\n        const slug = href.split(\"/\").pop()!.replace(/\\.md$/, \"\");\n        return `href=\"/docs/${slug}\"`;\n      }\n      return `href=\"${href}\"`;\n    },\n  );\n}\n\nexport function mdToHtml(md: string): string {\n  if (!md) return \"\";\n  try {\n    const html = marked.parse(md, { gfm: true }) as string;\n    return rewriteDocLinks(processMermaidBlocks(html));\n  } catch {\n    return \"\";\n  }\n}\n",[],[418,1057],"ee67cb8a-140b-11f1-9640-42dde27851f2","index.html","78349ff2-13fb-11f1-b99c-42dde27851f2",141,["D",1772217690130],"\n\n\n\n\nsync — Multi-Agent Coordination for AI Workflows\n\n\n\n\n
\n\n\n\n",[],[418,1065],"69ca48d6-18b0-11f1-ad37-42dde27851f2","client.tsx","69ca4958-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-30a4e899db48",["D",1772728139302],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for RecoverPage.\n *\n * Reads serialized props from the __PROPS__ script tag,\n * hydrates the server-rendered HTML with React interactivity.\n */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { RecoverPage } from \"./RecoverPage.tsx\";\n\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent!) : {};\n\nconst root = document.getElementById(\"root\");\nif (root) {\n  hydrateRoot(root, );\n}\n",[],[418,1080,1081,1073],"pages","recover","2cdbca9a-195e-11f1-999b-42dde27851f2","RecoverPage.tsx","69ca4f34-18b0-11f1-ad37-42dde27851f2",256,["D",1772802769533],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** RecoverPage — recovery token → new passkey registration.\n *\n * Three-step flow:\n *   1. Enter recovery token → validate\n *   2. Token verified → register new passkey (WebAuthn)\n *   3. Success → link to /manage\n *\n * Isomorphic: server renders step 1 (the form), client hydration\n * adds the WebAuthn interactivity.\n */\nimport { useState, useRef } from \"https://esm.sh/react@18.2.0\";\nimport { Nav } from \"../../components/Nav.tsx\";\nimport {\n  PageWrapper,\n  Container,\n  Card,\n  Title,\n  TitleDim,\n  Subtitle,\n  Label,\n  Input,\n  PrimaryButton,\n  StatusText,\n  ErrorText,\n  SuccessText,\n  AccentLink,\n} from \"../../components/mcp.tsx\";\n\nexport interface RecoverPageProps {\n  origin: string;\n}\n\ntype Step = \"token\" | \"register\" | \"done\";\n\nexport function RecoverPage({ origin }: RecoverPageProps) {\n  const [step, setStep] = useState(\"token\");\n  const [status, setStatus] = useState(\"\");\n  const [error, setError] = useState(\"\");\n  const [username, setUsername] = useState(\"\");\n  const [sessionId, setSessionId] = useState(null);\n  const [tokenId, setTokenId] = useState(null);\n  const regOptionsRef = useRef(null);\n\n  async function handleValidateToken(e?: React.FormEvent) {\n    e?.preventDefault();\n    setError(\"\");\n    setStatus(\"Validating token...\");\n\n    const tokenInput = (document.getElementById(\"recovery-token\") as HTMLInputElement)?.value?.trim();\n    if (!tokenInput) {\n      setError(\"Enter your recovery token\");\n      setStatus(\"\");\n      return;\n    }\n\n    try {\n      const res = await fetch(`${origin}/recover/validate`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ token: tokenInput }),\n      });\n      const data = await res.json();\n      if (!res.ok || !data.verified) {\n        setError(data.error || \"Invalid token\");\n        setStatus(\"\");\n        return;\n      }\n\n      setSessionId(data.sessionId);\n      setTokenId(data.tokenId);\n\n      // Get registration options to show username\n      const optRes = await fetch(`${origin}/recover/register/options`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ sessionId: data.sessionId }),\n      });\n      const optData = await optRes.json();\n      if (!optRes.ok) {\n        setError(optData.error || \"Failed to get options\");\n        setStatus(\"\");\n        return;\n      }\n\n      regOptionsRef.current = optData;\n      setUsername(optData.username);\n      setStep(\"register\");\n      setStatus(\"\");\n    } catch (err: any) {\n      setError(err.message);\n      setStatus(\"\");\n    }\n  }\n\n  async function handleRegisterPasskey() {\n    setError(\"\");\n    setStatus(\"Touch your authenticator...\");\n\n    try {\n      // Dynamic import — only loaded client-side when needed\n      const { startRegistration } = await import(\n        \"https://esm.sh/@simplewebauthn/browser@13\"\n      );\n\n      const attResp = await startRegistration({\n        optionsJSON: regOptionsRef.current.options,\n      });\n\n      setStatus(\"Verifying...\");\n\n      const verRes = await fetch(`${origin}/recover/register/verify`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          challengeId: regOptionsRef.current.challengeId,\n          sessionId,\n          tokenId,\n          response: attResp,\n        }),\n      });\n      const verData = await verRes.json();\n      if (!verRes.ok || !verData.verified) {\n        setError(verData.error || \"Registration failed\");\n        setStatus(\"\");\n        return;\n      }\n\n      setStep(\"done\");\n      setStatus(\"\");\n    } catch (err: any) {\n      setError(err.message);\n      setStatus(\"\");\n    }\n  }\n\n  return (\n    <>\n      \n      \n        \n        {step === \"token\" && (\n          \n            \n              sync<TitleDim>·recover</TitleDim>\n            \n            \n              Enter your recovery token to register a new passkey for an\n              existing account.\n            \n            \n              Recovery token\n              \n              Verify token\n            \n            {status && {status}}\n            {error && {error}}\n          \n        )}\n\n        {step === \"register\" && (\n          \n            \n              sync<TitleDim>·recover</TitleDim>\n            \n            \n              Token verified for {username}. Register a new\n              passkey for this account.\n            \n            \n              Register new passkey\n            \n            {status && {status}}\n            {error && {error}}\n          \n        )}\n\n        {step === \"done\" && (\n          \n            \n              sync<TitleDim>·recover</TitleDim>\n            \n            \n              New passkey registered successfully. Your recovery token has been\n              consumed.\n            \n            \n              You can now sign in with\n              your new passkey, or close this page.\n            \n          \n        )}\n      \n      \n    \n  );\n}\n",[],[418,1080,1081,1083],"69cabb04-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-190c90bfe408",["D",1772728139302],[511,512],[418,1080,1081],"453ba09e-1efc-11f1-890b-42dde27851f2","453ba166-1efc-11f1-890b-42dde27851f2","e3abf806-4323-4a09-93f2-81a76a62b5d1",603,["D",1773420426700],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for Overview page. */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { Overview } from \"../../components/Overview.tsx\";\n\nconst root = document.getElementById(\"root\");\n\nif (root) {\n  hydrateRoot(root, );\n  window.__HYDRATION_OK__?.();\n}\n",[],[418,1080,1103,1073],"overview","453bc4e8-1efc-11f1-890b-42dde27851f2",["D",1773420426700],[509],[418,1080,1103],"69c9f552-18b0-11f1-ad37-42dde27851f2","69c9f5c0-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-2cdb52a84d86",["D",1772728139302],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for ManagePage. */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { ManagePage } from \"./ManagePage.tsx\";\n\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent!) : {};\n\nconst root = document.getElementById(\"root\");\nif (root) {\n  hydrateRoot(root, );\n}\n",[],[418,1080,1115,1073],"manage","89c63c26-2198-11f1-9238-42dde27851f2","ManagePage.tsx","69c9fa84-18b0-11f1-ad37-42dde27851f2",["D",1773707445460],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** ManagePage — unified management: profile, rooms, tokens.\n *\n * v7: Replaces vault table with unified tokens section.\n * Adds room search/filter/pagination.\n */\nimport { useCallback, useState, useEffect, useMemo } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\nimport { Nav } from \"../../components/Nav.tsx\";\nimport {\n  Card, ErrorText, Input, Label, PageWrapper,\n  PrimaryButton, StatusText, Subtitle, Title, TitleDim,\n} from \"../../components/mcp.tsx\";\n\nexport interface ManagePageProps {\n  origin: string;\n  dashboardOrigin?: string;\n}\n\n// ─── Styled components ───────────────────────────────────────────\n\nconst ModeToggle = styled.div`display:flex;gap:0;margin-bottom:1.25rem;border-radius:8px;overflow:hidden;border:1px solid var(--border,#21262d);`;\nconst ModeTab = styled.button<{$active?:boolean}>`flex:1;padding:0.5rem;border:none;background:${({$active})=>$active?\"var(--surface2)\":\"transparent\"};color:${({$active})=>$active?\"var(--fg)\":\"var(--dim)\"};cursor:pointer;font-size:0.85rem;transition:all 0.2s;font-family:inherit;`;\nconst MC = styled.div`width:100%;max-width:760px;padding:1rem;`;\nconst Section = styled.div`background:var(--surface,#161b22);border:1px solid var(--border,#21262d);border-radius:12px;padding:1.5rem 2rem;margin-bottom:1rem;@media(max-width:600px){padding:1rem 1.25rem;}`;\nconst Header = styled.div`display:flex;align-items:center;justify-content:space-between;margin-bottom:1.5rem;flex-wrap:wrap;gap:0.5rem;`;\nconst UserBadge = styled.span`font-size:0.8rem;color:var(--dim);background:var(--bg,#0d1117);border:1px solid var(--border,#21262d);border-radius:6px;padding:0.3rem 0.7rem;`;\nconst SignOutBtn = styled.button`border:1px solid var(--border,#21262d);background:none;color:var(--dim);padding:0.3rem 0.8rem;border-radius:6px;font-size:0.78rem;cursor:pointer;font-family:inherit;&:hover{border-color:var(--red);color:var(--red);}`;\nconst STitle = styled.div`font-size:0.75rem;text-transform:uppercase;letter-spacing:0.08em;color:var(--dim);margin-bottom:0.75rem;`;\nconst PasskeyList = styled.div`display:flex;gap:0.5rem;flex-wrap:wrap;`;\nconst PasskeyChip = styled.span`font-size:0.75rem;background:var(--bg);border:1px solid var(--border);border-radius:5px;padding:0.2rem 0.6rem;color:var(--dim);font-family:\"SF Mono\",\"Fira Code\",monospace;`;\nconst SyncBadge = styled.span`color:var(--green);margin-left:0.3rem;font-size:0.65rem;`;\nconst ActionBtn = styled.button<{$v?:string}>`border:none;background:none;cursor:pointer;padding:0.25rem 0.5rem;border-radius:4px;font-size:0.78rem;font-family:inherit;transition:all 0.15s;${({$v})=>$v===\"red\"?`color:var(--red);&:hover{background:var(--surface);}`:$v===\"blue\"?`color:var(--accent);&:hover{background:var(--surface);}`:$v===\"purple\"?`color:var(--purple);&:hover{background:#1a1a2a;}`:$v===\"green\"?`color:var(--green);&:hover{background:var(--surface);}`:`color:var(--dim);&:hover{background:var(--surface2);}`};`;\nconst EmptyState = styled.div`text-align:center;padding:2rem;color:var(--dim);font-size:0.9rem;`;\nconst SearchInput = styled.input`width:100%;padding:0.55rem 0.75rem;background:var(--bg);border:1px solid var(--border);border-radius:6px;color:var(--fg);font-size:0.85rem;font-family:inherit;&:focus{outline:none;border-color:var(--accent);}&::placeholder{color:#484f58;}`;\nconst TabBar = styled.div`display:flex;gap:0;border-radius:8px;overflow:hidden;border:1px solid var(--border);margin-bottom:1rem;`;\nconst Tab = styled.button<{$active?:boolean}>`flex:1;padding:0.5rem;border:none;background:${({$active})=>$active?\"var(--surface2)\":\"transparent\"};color:${({$active})=>$active?\"var(--fg)\":\"var(--dim)\"};cursor:pointer;font-size:0.82rem;font-family:inherit;transition:all 0.15s;`;\nconst Pill = styled.button`padding:0.2rem 0.6rem;border:1px solid var(--border);border-radius:99px;background:transparent;color:var(--dim);font-size:0.72rem;cursor:pointer;font-family:inherit;&:hover{border-color:var(--accent);color:var(--fg);}`;\nconst Count = styled.span`font-size:0.72rem;color:var(--dim);`;\nconst RoomCard = styled.div<{$open?:boolean}>`border:1px solid var(--border);border-radius:8px;margin-bottom:0.4rem;overflow:hidden;transition:border-color 0.15s;&:hover{border-color:#30363d;}`;\nconst RoomHeader = styled.div`display:flex;align-items:center;gap:0.75rem;padding:0.6rem 0.85rem;cursor:pointer;`;\nconst RoomName = styled.span`font-weight:600;font-size:0.88rem;color:var(--fg);`;\nconst RoomMeta = styled.span`font-size:0.72rem;color:var(--dim);`;\nconst RoomDetail = styled.div`padding:0 0.85rem 0.65rem;font-size:0.8rem;border-top:1px solid var(--border);`;\nconst AgentRow = styled.div`display:flex;align-items:center;gap:0.5rem;padding:0.3rem 0;font-size:0.8rem;`;\nconst AgentName = styled.span`color:var(--fg);font-weight:500;`;\nconst AgentMeta = styled.span`color:var(--dim);font-size:0.72rem;`;\nconst TokenRow = styled.div`display:flex;align-items:flex-start;gap:0.75rem;padding:0.6rem 0;border-bottom:1px solid var(--border);&:last-child{border-bottom:none;}`;\nconst TokenInfo = styled.div`flex:1;min-width:0;`;\nconst TokenLabel = styled.div`font-size:0.85rem;color:var(--fg);font-weight:500;`;\nconst TokenScope = styled.div`font-size:0.72rem;color:var(--dim);font-family:\"SF Mono\",\"Fira Code\",monospace;word-break:break-all;margin-top:0.15rem;`;\nconst TokenMeta = styled.div`font-size:0.72rem;color:var(--dim);margin-top:0.15rem;`;\nconst Badge = styled.span<{$c?:string}>`display:inline-block;font-size:0.68rem;font-weight:600;text-transform:uppercase;letter-spacing:0.04em;padding:0.12rem 0.4rem;border-radius:4px;${({$c})=>$c===\"active\"?`background:#1a2a1a;color:#6c6;`:$c===\"revoked\"?`background:#2a1a1a;color:#c66;`:$c===\"expired\"?`background:#2a2a1a;color:#cc6;`:`background:#1a1a2a;color:#88f;`}`;\nconst RecoveryBox = styled.div`margin-top:0.75rem;background:var(--bg);border:1px solid var(--border);border-radius:8px;padding:0.75rem;`;\nconst RecoveryInput = styled.input`width:100%;padding:0.5rem 0.6rem;border:1px solid var(--border);border-radius:6px;background:var(--surface);color:var(--fg);font-family:\"SF Mono\",\"Fira Code\",monospace;font-size:0.8rem;margin-bottom:0.4rem;`;\nconst Toast = styled.div<{$show?:boolean}>`position:fixed;bottom:1.5rem;left:50%;transform:translateX(-50%);background:var(--surface2);color:var(--fg);padding:0.5rem 1.25rem;border-radius:8px;font-size:0.85rem;opacity:${({$show})=>$show?1:0};transition:opacity 0.3s;pointer-events:none;z-index:100;`;\nconst HeaderRight = styled.div`display:flex;align-items:center;gap:0.5rem;`;\nconst SmallPrimary = styled(PrimaryButton)`width:auto;padding:0.4rem 1rem;font-size:0.82rem;`;\nconst Pager = styled.div`display:flex;align-items:center;justify-content:center;gap:0.5rem;margin-top:0.75rem;`;\nconst PageBtn = styled.button<{$disabled?:boolean}>`padding:0.3rem 0.7rem;border:1px solid var(--border);border-radius:6px;background:transparent;color:${({$disabled})=>$disabled?\"var(--dim)\":\"var(--fg)\"};font-size:0.8rem;cursor:${({$disabled})=>$disabled?\"default\":\"pointer\"};font-family:inherit;opacity:${({$disabled})=>$disabled?0.4:1};&:hover{${({$disabled})=>!$disabled&&`border-color:var(--accent);`}}`;\nconst DashLink = styled.a`color:var(--purple);text-decoration:none;font-size:0.82rem;&:hover{text-decoration:underline;}`;\nconst InlineForm = styled.div`padding:0.65rem 0.85rem;border-top:1px solid var(--border);display:flex;flex-direction:column;gap:0.5rem;`;\nconst FormRow = styled.div`display:flex;gap:0.5rem;align-items:center;flex-wrap:wrap;`;\nconst FormInput = styled.input`flex:1;min-width:120px;padding:0.45rem 0.65rem;background:var(--bg);border:1px solid var(--border);border-radius:6px;color:var(--fg);font-size:0.82rem;font-family:inherit;&:focus{outline:none;border-color:var(--accent);}&::placeholder{color:#484f58;}`;\nconst FormSelect = styled.select`padding:0.45rem 0.5rem;background:var(--bg);border:1px solid var(--border);border-radius:6px;color:var(--fg);font-size:0.82rem;font-family:inherit;`;\nconst FormError = styled.div`font-size:0.75rem;color:var(--red,#f85149);`;\n\n// ─── Types ───────────────────────────────────────────────────────\n\ninterface Passkey { id: string; device_type: string; backed_up: boolean; }\ninterface RoomData {\n  room_id: string; access: string; label: string | null; is_default: boolean;\n  agents: Array<{ id: string; name: string; role: string; status: string; last_heartbeat: string }>;\n  roles: Record;\n}\ninterface TokenData {\n  id: string; scope: string; label: string | null; room_id: string | null;\n  agent_id: string | null; client_id: string | null; revoked: boolean;\n  expires_at: string | null; created_at: string;\n}\ninterface RecoveryToken { id: string; createdAt: string; expiresAt: string; used: boolean; }\n\ntype AuthMode = \"signin\" | \"register\";\ntype DashTab = \"rooms\" | \"tokens\" | \"profile\";\nconst PAGE_SIZE = 20;\n\n// ─── Component ───────────────────────────────────────────────────\n\nexport function ManagePage({ origin, dashboardOrigin }: ManagePageProps) {\n  const [phase, setPhase] = useState<\"auth\"|\"dashboard\">(\"auth\");\n  const [authMode, setAuthMode] = useState(\"signin\");\n  const [status, setStatus] = useState(\"\");\n  const [error, setError] = useState(\"\");\n  const [sessionId, setSessionId] = useState(null);\n  const [username, setUsername] = useState(\"\");\n  const [passkeys, setPasskeys] = useState([]);\n  const [rooms, setRooms] = useState([]);\n  const [tokens, setTokens] = useState([]);\n  const [recoveryTokens, setRecoveryTokens] = useState([]);\n  const [newRecoveryToken, setNewRecoveryToken] = useState(null);\n  const [toastMsg, setToastMsg] = useState(\"\");\n  const [toastVisible, setToastVisible] = useState(false);\n  const [tab, setTab] = useState(\"rooms\");\n  const [roomSearch, setRoomSearch] = useState(\"\");\n  const [roomPage, setRoomPage] = useState(0);\n  const [tokenFilter, setTokenFilter] = useState<\"active\"|\"all\">(\"active\");\n  const [expandedRoom, setExpandedRoom] = useState(null);\n  const [showCreateRoom, setShowCreateRoom] = useState(false);\n  const [newRoomId, setNewRoomId] = useState(\"\");\n  const [newRoomLabel, setNewRoomLabel] = useState(\"\");\n  const [inviteRoom, setInviteRoom] = useState(null);\n  const [inviteUsername, setInviteUsername] = useState(\"\");\n  const [inviteRole, setInviteRole] = useState(\"participant\");\n  const [actionError, setActionError] = useState(\"\");\n\n  useEffect(() => {\n    try {\n      const saved = localStorage.getItem('sync_session_id');\n      if (saved) {\n        setSessionId(saved);\n        setPhase(\"dashboard\");\n        loadDashboard(saved).catch(() => { localStorage.removeItem('sync_session_id'); signOut(); });\n      }\n    } catch {}\n  }, []);\n\n  function toast(msg: string) { setToastMsg(msg); setToastVisible(true); setTimeout(() => setToastVisible(false), 2000); }\n\n  async function api(method: string, path: string, body?: any, sid?: string): Promise {\n    const opts: RequestInit = { method, headers: { \"Content-Type\": \"application/json\", \"X-Session-Id\": sid || sessionId || \"\" } };\n    if (body) opts.body = JSON.stringify(body);\n    const res = await fetch(`${origin}/manage/api${path}`, opts);\n    if (res.status === 401) { signOut(); return null; }\n    return res.json();\n  }\n\n  async function doAuth() { setError(\"\"); if (authMode === \"register\") await doRegister(); else await doSignIn(); }\n\n  async function doSignIn() {\n    setStatus(\"Generating authentication options...\");\n    try {\n      const { startAuthentication } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n      const optRes = await fetch(`${origin}/webauthn/authenticate/options`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({}) });\n      const optData = await optRes.json();\n      if (!optRes.ok) { setError(optData.error); setStatus(\"\"); return; }\n      setStatus(\"Touch your authenticator...\");\n      const assertResp = await startAuthentication({ optionsJSON: optData.options });\n      setStatus(\"Verifying...\");\n      const verRes = await fetch(`${origin}/webauthn/authenticate/verify`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ challengeId: optData.challengeId, response: assertResp }) });\n      const verData = await verRes.json();\n      if (!verRes.ok || !verData.verified) { setError(verData.error || \"Authentication failed\"); setStatus(\"\"); return; }\n      setSessionId(verData.sessionId);\n      setPhase(\"dashboard\");\n      try { localStorage.setItem('sync_session_id', verData.sessionId); } catch {}\n      setStatus(\"\");\n      await loadDashboard(verData.sessionId);\n    } catch (err: any) { setError(err.message || \"Authentication failed\"); setStatus(\"\"); }\n  }\n\n  async function doRegister() {\n    const u = (document.getElementById(\"manage-username\") as HTMLInputElement)?.value?.trim();\n    if (!u) { setError(\"Username is required\"); return; }\n    setStatus(\"Generating registration options...\");\n    try {\n      const { startRegistration } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n      const optRes = await fetch(`${origin}/webauthn/register/options`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ username: u }) });\n      const optData = await optRes.json();\n      if (!optRes.ok) { setError(optData.error || \"Registration failed\"); setStatus(\"\"); return; }\n      setStatus(\"Create your passkey...\");\n      const regResp = await startRegistration({ optionsJSON: optData.options });\n      setStatus(\"Verifying...\");\n      const verRes = await fetch(`${origin}/webauthn/register/verify`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ challengeId: optData.challengeId, response: regResp }) });\n      const verData = await verRes.json();\n      if (!verRes.ok || !verData.verified) { setError(verData.error || \"Registration failed\"); setStatus(\"\"); return; }\n      setSessionId(verData.sessionId);\n      setPhase(\"dashboard\");\n      setStatus(\"\");\n      await loadDashboard(verData.sessionId);\n    } catch (err: any) { setError(err.message || \"Registration failed\"); setStatus(\"\"); }\n  }\n\n  async function loadDashboard(sid?: string) {\n    const me = await api(\"GET\", \"/me\", undefined, sid);\n    if (!me) return;\n    setUsername(me.user?.username ?? \"Unknown\");\n    setPasskeys(me.passkeys ?? []);\n    const roomData = await api(\"GET\", \"/rooms\", undefined, sid);\n    if (roomData?.rooms) setRooms(roomData.rooms);\n    const tokenData = await api(\"GET\", \"/tokens\", undefined, sid);\n    if (tokenData?.tokens) setTokens(tokenData.tokens);\n    const recData = await api(\"GET\", \"/recovery\", undefined, sid);\n    if (recData?.tokens) setRecoveryTokens(recData.tokens.filter((t: RecoveryToken) => !t.used && new Date(t.expiresAt) > new Date()));\n  }\n\n  async function createNewRoom() {\n    setActionError(\"\");\n    const id = newRoomId.trim() || undefined;\n    const label = newRoomLabel.trim() || undefined;\n    const data = await api(\"POST\", \"/rooms\", { id, label });\n    if (!data) return;\n    if (data.error) { setActionError(data.error === \"room_exists\" ? \"Room ID already exists\" : data.error); return; }\n    toast(`Room \"${data.id}\" created`);\n    setShowCreateRoom(false); setNewRoomId(\"\"); setNewRoomLabel(\"\");\n    const roomData = await api(\"GET\", \"/rooms\");\n    if (roomData?.rooms) setRooms(roomData.rooms);\n  }\n\n  async function inviteUser(roomId: string) {\n    setActionError(\"\");\n    if (!inviteUsername.trim()) { setActionError(\"Username required\"); return; }\n    const data = await api(\"POST\", `/rooms/${encodeURIComponent(roomId)}/invite`, { username: inviteUsername.trim(), role: inviteRole });\n    if (!data) return;\n    if (data.error) { setActionError(data.error === \"user_not_found\" ? `User \"${inviteUsername}\" not found` : data.error); return; }\n    toast(`Invited ${inviteUsername} to ${roomId}`);\n    setInviteRoom(null); setInviteUsername(\"\"); setInviteRole(\"participant\");\n  }\n\n  async function deleteRoom(roomId: string) {\n    if (!confirm(`Delete room \"${roomId}\"? This removes all state, agents, actions, and views. This cannot be undone.`)) return;\n    const data = await api(\"DELETE\", `/rooms/${encodeURIComponent(roomId)}`);\n    if (!data) return;\n    if (data.error) { toast(data.error); return; }\n    toast(`Room \"${roomId}\" deleted`);\n    setExpandedRoom(null);\n    const roomData = await api(\"GET\", \"/rooms\");\n    if (roomData?.rooms) setRooms(roomData.rooms);\n  }\n\n  async function revokeToken(id: string, label: string) {\n    if (!confirm(`Revoke token \"${label || id}\"?`)) return;\n    await api(\"DELETE\", `/tokens/${id}`);\n    toast(\"Token revoked\");\n    const tokenData = await api(\"GET\", \"/tokens\");\n    if (tokenData?.tokens) setTokens(tokenData.tokens);\n  }\n\n  async function generateRecovery() {\n    const data = await api(\"POST\", \"/recovery\");\n    if (!data || data.error) { toast(data?.error || \"Failed\"); return; }\n    setNewRecoveryToken(data.token);\n    toast(\"Recovery token generated\");\n    const recData = await api(\"GET\", \"/recovery\");\n    if (recData?.tokens) setRecoveryTokens(recData.tokens.filter((t: RecoveryToken) => !t.used && new Date(t.expiresAt) > new Date()));\n  }\n\n  async function revokeRecovery(id: string) {\n    if (!confirm(\"Revoke this recovery token?\")) return;\n    await api(\"DELETE\", `/recovery/${id}`);\n    toast(\"Recovery token revoked\");\n    const recData = await api(\"GET\", \"/recovery\");\n    if (recData?.tokens) setRecoveryTokens(recData.tokens.filter((t: RecoveryToken) => !t.used && new Date(t.expiresAt) > new Date()));\n  }\n\n  function signOut() {\n    try { localStorage.removeItem('sync_session_id'); } catch {}\n    setSessionId(null); setPhase(\"auth\"); setStatus(\"\"); setError(\"\");\n    setRooms([]); setTokens([]); setPasskeys([]); setRecoveryTokens([]); setNewRecoveryToken(null);\n  }\n\n  // ── Derived data ──\n  const dashBase = dashboardOrigin ?? origin.replace(/mcp\\./, \"\");\n\n  const filteredRooms = useMemo(() => {\n    const q = roomSearch.toLowerCase().trim();\n    if (!q) return rooms;\n    return rooms.filter(r =>\n      r.room_id.toLowerCase().includes(q) ||\n      (r.label || \"\").toLowerCase().includes(q) ||\n      r.agents.some(a => a.name.toLowerCase().includes(q) || a.id.toLowerCase().includes(q))\n    );\n  }, [rooms, roomSearch]);\n\n  const totalRoomPages = Math.max(1, Math.ceil(filteredRooms.length / PAGE_SIZE));\n  const pagedRooms = filteredRooms.slice(roomPage * PAGE_SIZE, (roomPage + 1) * PAGE_SIZE);\n\n  const roomsWithAgents = rooms.filter(r => r.agents.length > 0).length;\n\n  const filteredTokens = useMemo(() => {\n    if (tokenFilter === \"active\") return tokens.filter(t => !t.revoked && (!t.expires_at || new Date(t.expires_at) > new Date()));\n    return tokens;\n  }, [tokens, tokenFilter]);\n\n  const activeTokenCount = tokens.filter(t => !t.revoked && (!t.expires_at || new Date(t.expires_at) > new Date())).length;\n\n  function describeScope(scope: string): string {\n    const items = scope.split(/\\s+/).filter(Boolean);\n    if (items.length === 0) return \"—\";\n    return items.map(item => {\n      if (item === \"create_rooms\") return \"create rooms\";\n      if (item === \"rooms:*\") return \"all rooms\";\n      if (item === \"rooms:*:read\") return \"all rooms (read)\";\n      if (item === \"sync:rooms\") return \"all rooms (legacy)\";\n      if (item.includes(\":agent:\")) { const p = item.split(\":\"); return `${p[1]} → ${p[3]}`; }\n      if (item.endsWith(\":read\")) return `${item.split(\":\")[1]} (read)`;\n      if (item.endsWith(\":write\")) return `${item.split(\":\")[1]} (write)`;\n      if (item.startsWith(\"rooms:\")) return item.split(\":\")[1];\n      return item;\n    }).join(\", \");\n  }\n\n  function tokenStatus(t: TokenData): \"active\" | \"revoked\" | \"expired\" {\n    if (t.revoked) return \"revoked\";\n    if (t.expires_at && new Date(t.expires_at) < new Date()) return \"expired\";\n    return \"active\";\n  }\n\n  function timeAgo(iso: string): string {\n    const d = new Date(iso);\n    const diff = Date.now() - d.getTime();\n    const mins = Math.floor(diff / 60000);\n    if (mins < 60) return `${mins}m ago`;\n    const hrs = Math.floor(mins / 60);\n    if (hrs < 24) return `${hrs}h ago`;\n    const days = Math.floor(hrs / 24);\n    return `${days}d ago`;\n  }\n\n  // ─── Render ────────────────────────────────────────────────────\n\n  return (\n    <>\n      \n      \n        \n          {phase === \"auth\" && (\n            \n              sync<TitleDim>·manage</TitleDim>\n              Sign in or create an account to manage your sync rooms, tokens, and passkeys.\n              \n                 { setAuthMode(\"signin\"); setError(\"\"); setStatus(\"\"); }}>Sign in\n                 { setAuthMode(\"register\"); setError(\"\"); setStatus(\"\"); }}>Register\n              \n              {authMode === \"register\" && (\n                Username e.key === \"Enter\" && doAuth()} />
\n              )}\n              {authMode === \"register\" ? \"Create account with passkey\" : \"Sign in with passkey\"}\n              {status && {status}}\n              {error && {error}}\n            
\n          )}\n\n          {phase === \"dashboard\" && (\n            <>\n              \n                \n                  sync<TitleDim>·manage</TitleDim>\n                  \n                    {username}\n                    Sign out\n                  \n                
\n                \n                   setTab(\"rooms\")}>Rooms ({rooms.length})\n                   setTab(\"tokens\")}>Tokens ({activeTokenCount})\n                   setTab(\"profile\")}>Profile\n                \n              
\n\n              {/* ── Rooms tab ── */}\n              {tab === \"rooms\" && (\n                \n                  \n                     { setRoomSearch(e.target.value); setRoomPage(0); }} style={{ flex: 1, minWidth: \"200px\" }} />\n                     { setRoomSearch(\"\"); setRoomPage(0); }}>Clear\n                     setShowCreateRoom(v => !v)} style={{ margin: 0 }}>+ Room\n                  
\n\n                  {showCreateRoom && (\n                    \n                      \n                         setNewRoomId(e.target.value)} />\n                         setNewRoomLabel(e.target.value)} />\n                        Create\n                         { setShowCreateRoom(false); setActionError(\"\"); }}>Cancel\n                      \n                      {actionError && {actionError}}\n                    \n                  )}\n\n                  \n                    {filteredRooms.length} of {rooms.length} rooms\n                    ·\n                    {roomsWithAgents} with agents\n                  
\n\n                  {pagedRooms.length === 0 ? (\n                    {rooms.length === 0 ? \"No rooms yet. Click + Room to create one.\" : \"No rooms match your search.\"}\n                  ) : pagedRooms.map(r => {\n                    const isOpen = expandedRoom === r.room_id;\n                    const isOwner = r.access === \"owner\";\n                    const agentCount = r.agents.length;\n                    const roleCount = Object.keys(r.roles || {}).length;\n                    return (\n                      \n                         { setExpandedRoom(isOpen ? null : r.room_id); setInviteRoom(null); setActionError(\"\"); }}>\n                          {isOpen ? \"▾\" : \"▸\"}\n                          \n                            {r.label || r.room_id}\n                            {r.label && r.label !== r.room_id && {r.room_id}}\n                            [{r.access}]\n                            \n                              {agentCount > 0 && {agentCount} agent{agentCount > 1 ? \"s\" : \"\"}}\n                              {roleCount > 0 &&  · {roleCount} role{roleCount > 1 ? \"s\" : \"\"}}\n                            
\n                          
\n                           e.stopPropagation()}>dashboard\n                        \n                        {isOpen && (\n                          \n                            {r.agents.length > 0 ? (\n                              <>\n                                Agents
\n                                {r.agents.map(a => (\n                                  \n                                    {a.name || a.id}\n                                    {a.role}\n                                    ·\n                                    {a.status}\n                                    {a.last_heartbeat && · {timeAgo(a.last_heartbeat.replace(\" \", \"T\") + \"Z\")}}\n                                  \n                                ))}\n                              \n                            ) : (\n                              No agents in this room.
\n                            )}\n\n                            {isOwner && (\n                              \n                                 { e.stopPropagation(); setInviteRoom(inviteRoom === r.room_id ? null : r.room_id); setActionError(\"\"); }}>\n                                  {inviteRoom === r.room_id ? \"cancel invite\" : \"invite user\"}\n                                \n                                 { e.stopPropagation(); deleteRoom(r.room_id); }}>delete room\n                              
\n                            )}\n\n                            {inviteRoom === r.room_id && (\n                              \n                                \n                                   setInviteUsername(e.target.value)}\n                                    onKeyDown={e => e.key === \"Enter\" && inviteUser(r.room_id)} />\n                                   setInviteRole(e.target.value)}>\n                                    \n                                    \n                                    \n                                    \n                                  \n                                   inviteUser(r.room_id)} style={{ margin: 0 }}>Invite\n                                \n                                {actionError && {actionError}}\n                              
\n                            )}\n                          \n                        )}\n                      \n                    );\n                  })}\n\n                  {totalRoomPages > 1 && (\n                    \n                       roomPage > 0 && setRoomPage(roomPage - 1)}>← Prev\n                      {roomPage + 1} / {totalRoomPages}\n                      = totalRoomPages - 1} onClick={() => roomPage < totalRoomPages - 1 && setRoomPage(roomPage + 1)}>Next →\n                    \n                  )}\n                
\n              )}\n\n              {/* ── Tokens tab ── */}\n              {tab === \"tokens\" && (\n                \n                  \n                     setTokenFilter(\"active\")} style={tokenFilter === \"active\" ? { borderColor: \"var(--accent)\", color: \"var(--fg)\" } : {}}>Active ({activeTokenCount})\n                     setTokenFilter(\"all\")} style={tokenFilter === \"all\" ? { borderColor: \"var(--accent)\", color: \"var(--fg)\" } : {}}>All ({tokens.length})\n                  
\n\n                  {filteredTokens.length === 0 ? (\n                    No {tokenFilter === \"active\" ? \"active \" : \"\"}tokens. Use device auth or MCP to create tokens.\n                  ) : filteredTokens.map(t => {\n                    const st = tokenStatus(t);\n                    const scopeRoomCount = (t.scope.match(/rooms:/g) || []).length;\n                    return (\n                      \n                        \n                          \n                            {t.label || t.client_id || \"Token\"}\n                            {st}\n                          
\n                          {describeScope(t.scope)}{scopeRoomCount > 5 && ` (${scopeRoomCount} rooms)`}\n                          \n                            Created {timeAgo(t.created_at.replace(\" \", \"T\") + \"Z\")}\n                            {t.expires_at && ` · expires ${new Date(t.expires_at).toLocaleDateString()}`}\n                            {t.client_id && ` · ${t.client_id.substring(0, 16)}...`}\n                          \n                        \n                        {st === \"active\" && (\n                           revokeToken(t.id, t.label || t.id)}>revoke\n                        )}\n                      \n                    );\n                  })}\n                
\n              )}\n\n              {/* ── Profile tab ── */}\n              {tab === \"profile\" && (\n                <>\n                  \n                    Passkeys\n                    \n                      {passkeys.length > 0 ? passkeys.map(p => (\n                        {p.id}{p.backed_up && synced}\n                      )) : No passkeys found}\n                    \n                  
\n                  \n                    Recovery Tokens\n                    {recoveryTokens.length === 0 ? (\n                      No active recovery tokens.\n                    ) : recoveryTokens.map(t => (\n                      \n                        Created {t.createdAt.split(\"T\")[0]}\n                        expires {t.expiresAt.split(\"T\")[0]}\n                         revokeRecovery(t.id)}>revoke\n                      
\n                    ))}\n                    \n                      Generate recovery token\n                    
\n                    {newRecoveryToken && (\n                      \n                        Copy this token now — it will not be shown again.
\n                         (e.target as HTMLInputElement).select()} />\n                         { navigator.clipboard.writeText(newRecoveryToken); toast(\"Recovery token copied\"); }}>copy\n                      \n                    )}\n                  
\n                \n              )}\n            \n          )}\n          {toastMsg}\n        \n      \n    \n  );\n}\n",[],[418,1080,1115,1117],"69cab92e-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[506,507],[418,1080,1115],"67743adc-1a41-11f1-81d7-42dde27851f2","69c9f11a-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-2b6dd30acf2c",362,["D",1772900363592],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for Landing page. All content is pre-rendered server-side. */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { Landing } from \"../../components/Landing.tsx\";\nimport type { LandingData } from \"../../components/Landing.tsx\";\n\nconst root = document.getElementById(\"root\");\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent || \"{}\") : {};\n\nif (root) {\n  hydrateRoot(root, );\n}\n",[],[418,1080,1135,1073],"landing","69cab80c-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[504],[418,1080,1135],"6d729a70-1a85-11f1-ac1e-42dde27851f2","69c9ed32-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-271fdaf9910a",411,["D",1772929579428],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for doc pages (DocPage and DocsIndex). */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { DocPage, DocsIndex } from \"../../components/DocViewer.tsx\";\n\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent!) : {};\n\nconst root = document.getElementById(\"root\");\nif (root) {\n  // DocsIndex pages have a `docs` array prop; DocPage pages have `slug`\n  if (props.docs) {\n    hydrateRoot(root, );\n  } else {\n    hydrateRoot(root, );\n  }\n}\n",[],[418,1080,424,1073],"69cab578-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[502],[418,1080,424],"9cdc6298-2078-11f1-ab20-42dde27851f2","69c9e8c8-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-23a11c1cea8d",618,["D",1773583782486],5,"/** @jsxImportSource https://esm.sh/react@18.2.0?dev */\n/** Client entry for Dashboard page — TEMP: using React dev build for error messages */\nimport React from \"https://esm.sh/react@18.2.0?dev\";\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0?dev/client\";\n\nconsole.log(\"[dashboard-client] module loaded\");\n\n// Error boundary to catch render crashes\nclass ErrorBoundary extends React.Component {\n  constructor(props) {\n    super(props);\n    this.state = { error: null, info: null };\n  }\n  static getDerivedStateFromError(error) {\n    return { error };\n  }\n  componentDidCatch(error, info) {\n    console.error(\"[dashboard-client] React render error:\", error);\n    console.error(\"[dashboard-client] Component stack:\", info?.componentStack);\n    this.setState({ info });\n  }\n  render() {\n    if (this.state.error) {\n      return React.createElement(\"div\", {\n        style: { padding: \"2rem\", fontFamily: \"monospace\", fontSize: \"13px\", color: \"#f85149\", background: \"#0d1117\", minHeight: \"100vh\" }\n      },\n        React.createElement(\"h2\", { style: { color: \"#f85149\" } }, \"Dashboard render error\"),\n        React.createElement(\"pre\", { style: { whiteSpace: \"pre-wrap\", wordBreak: \"break-all\", marginTop: \"1rem\", padding: \"1rem\", background: \"#161b22\", borderRadius: \"6px\" } },\n          String(this.state.error?.message || this.state.error)\n        ),\n        this.state.error?.stack && React.createElement(\"pre\", {\n          style: { whiteSpace: \"pre-wrap\", wordBreak: \"break-all\", marginTop: \"0.5rem\", padding: \"1rem\", background: \"#161b22\", borderRadius: \"6px\", color: \"#484f58\", fontSize: \"11px\" }\n        }, this.state.error.stack),\n        this.state.info?.componentStack && React.createElement(\"pre\", {\n          style: { whiteSpace: \"pre-wrap\", wordBreak: \"break-all\", marginTop: \"0.5rem\", padding: \"1rem\", background: \"#161b22\", borderRadius: \"6px\", color: \"#58a6ff\", fontSize: \"11px\" }\n        }, \"Component stack:\" + this.state.info.componentStack)\n      );\n    }\n    return this.props.children;\n  }\n}\n\ntry {\n  console.log(\"[dashboard-client] importing Dashboard component...\");\n  const { Dashboard } = await import(\"../../components/Dashboard.tsx\");\n  console.log(\"[dashboard-client] Dashboard imported:\", typeof Dashboard);\n\n  const propsEl = document.getElementById(\"__PROPS__\");\n  const props = propsEl ? JSON.parse(propsEl.textContent) : {};\n  console.log(\"[dashboard-client] props:\", JSON.stringify(props));\n\n  const root = document.getElementById(\"root\");\n  console.log(\"[dashboard-client] root element:\", root ? \"found\" : \"MISSING\");\n\n  if (root) {\n    console.log(\"[dashboard-client] calling createRoot...\");\n    const reactRoot = createRoot(root);\n    console.log(\"[dashboard-client] rendering with ErrorBoundary...\");\n    reactRoot.render(\n      React.createElement(ErrorBoundary, null,\n        React.createElement(Dashboard, { roomId: props.roomId })\n      )\n    );\n    console.log(\"[dashboard-client] render() called — React should mount\");\n  }\n} catch (err) {\n  console.error(\"[dashboard-client] FATAL:\", err);\n  console.error(\"[dashboard-client] stack:\", err?.stack);\n  const root = document.getElementById(\"root\");\n  if (root) {\n    root.innerHTML = '' +\n      'Dashboard load error
' +\n      '' +\n      (err?.message || String(err)) + '
' +\n      '' +\n      (err?.stack || '') + '
';\n  }\n}\n",[],[418,1080,1161,1073],"dashboard","69cab3de-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[500],[418,1080,1161],"abd57444-1e4b-11f1-bb8e-42dde27851f2","abd57516-1e4b-11f1-bb8e-42dde27851f2","67c67e60-1e4b-11f1-b23f-42dde27851f2",536,["D",1773344577891],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for ConsentPage. */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { ConsentPage } from \"./ConsentPage.tsx\";\n\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent!) : {};\n\nconst root = document.getElementById(\"root\");\nif (root) {\n  hydrateRoot(root, );\n}\n",[],[418,1080,1174,1073],"consent","a7b64f64-1e4b-11f1-b034-42dde27851f2","ConsentPage.tsx","a7b6502c-1e4b-11f1-b034-42dde27851f2",535,["D",1773344571018],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/**\n * ConsentPage — Unified scope consent for all auth flows.\n *\n * Three modes, one component:\n *   - elevate:  Agent requests room access → passkey auth → scope editor\n *   - device:   Post-passkey device auth → scope editor → approve device code\n *   - oauth:    Post-passkey OAuth → scope editor → issue auth code\n *\n * After passkey auth, loads user's rooms + current token scope (if elevate),\n * shows a full scope editor, then applies changes via mode-specific backend.\n */\nimport { useState, useMemo, useCallback } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\nimport {\n  PageWrapper, Container, Card, Title, TitleDim, Subtitle,\n  PrimaryButton, SecondaryButton, StatusText, ErrorText,\n} from \"../../components/mcp.tsx\";\n\n// ─── Props ───────────────────────────────────────────────────────\n\nexport interface ConsentPageProps {\n  origin: string;\n  mode: \"elevate\" | \"device\" | \"oauth\";\n  // Elevate\n  tokenId?: string;\n  addRoom?: string;\n  addLevel?: string;\n  // Device (pre-authenticated)\n  sessionId?: string;\n  deviceCode?: string;\n  requestedScope?: string;\n  // OAuth (pre-authenticated)\n  clientId?: string;\n  clientName?: string;\n  redirectUri?: string;\n  codeChallenge?: string;\n  codeChallengeMethod?: string;\n  oauthScope?: string;\n  oauthState?: string;\n  resource?: string;\n}\n\n// ─── Styled ──────────────────────────────────────────────────────\n\nconst WideContainer = styled.div`\n  width: 100%; max-width: 520px; padding: 1rem;\n`;\n\nconst TokenInfo = styled.div`\n  font-size: 0.8rem; color: var(--dim); margin-bottom: 1rem;\n  padding: 0.5rem 0.75rem; background: var(--bg); border: 1px solid var(--border);\n  border-radius: 8px;\n  strong { color: var(--fg); }\n`;\n\nconst ScopeText = styled.div`\n  font-size: 0.72rem; color: var(--dim); font-family: \"SF Mono\",\"Fira Code\",monospace;\n  word-break: break-all; margin-top: 0.25rem;\n`;\n\nconst Toolbar = styled.div`margin-bottom: 0.75rem;`;\n\nconst SearchInput = styled.input`\n  width: 100%; padding: 0.55rem 0.75rem; background: var(--bg);\n  border: 1px solid var(--border); border-radius: 6px; color: var(--fg);\n  font-size: 0.85rem; font-family: inherit; margin-bottom: 0.5rem;\n  &:focus { outline: none; border-color: var(--accent); }\n  &::placeholder { color: var(--dim); }\n`;\n\nconst BulkActions = styled.div`display: flex; gap: 0.35rem; flex-wrap: wrap;`;\n\nconst Pill = styled.button`\n  padding: 0.25rem 0.65rem; border: 1px solid var(--border); border-radius: 99px;\n  background: transparent; color: var(--dim); font-size: 0.75rem; font-family: inherit;\n  cursor: pointer; &:hover { border-color: var(--accent); color: var(--fg); }\n`;\n\nconst RoomCount = styled.div`font-size: 0.75rem; color: var(--dim); margin-bottom: 0.4rem;`;\n\nconst RoomList = styled.div`max-height: 350px; overflow-y: auto; margin-bottom: 0.75rem;`;\n\nconst RoomRow = styled.div<{ $selected?: boolean; $isNew?: boolean }>`\n  display: flex; align-items: center; gap: 0.75rem;\n  padding: 0.55rem 0.8rem; border-radius: 8px; margin-bottom: 0.35rem;\n  cursor: pointer; transition: all 0.15s;\n  border: 1px solid ${({ $selected, $isNew }) =>\n    $isNew ? \"var(--green)\" : $selected ? \"var(--accent)\" : \"var(--border)\"};\n  background: ${({ $selected, $isNew }) =>\n    $isNew ? \"rgba(63,185,80,0.08)\" : $selected ? \"rgba(88,166,255,0.08)\" : \"transparent\"};\n  &:hover { border-color: var(--accent); }\n`;\n\nconst RoomCheck = styled.input`accent-color: var(--accent); width: 1rem; height: 1rem; flex-shrink: 0;`;\n\nconst RoomInfo = styled.div`flex: 1; min-width: 0;`;\nconst RoomName = styled.span`font-weight: 600; font-size: 0.88rem; color: var(--fg);`;\nconst RoomMeta = styled.span`font-size: 0.72rem; color: var(--dim); margin-left: 0.5rem;`;\nconst RoomDetail = styled.div`font-size: 0.72rem; color: var(--dim); margin-top: 0.12rem;`;\n\nconst NewBadge = styled.span`\n  font-size: 0.65rem; font-weight: 600; color: var(--green);\n  background: rgba(63,185,80,0.1); border: 1px solid var(--green);\n  border-radius: 4px; padding: 0.05rem 0.3rem; margin-left: 0.4rem;\n`;\n\nconst ScopeSelect = styled.select`\n  padding: 0.3rem 0.5rem; border: 1px solid var(--border); border-radius: 6px;\n  background: var(--surface); color: var(--fg); font-size: 0.8rem;\n  font-family: inherit; flex-shrink: 0;\n`;\n\nconst ExpandLink = styled.div`\n  font-size: 0.72rem; color: var(--accent); cursor: pointer;\n  padding: 0.15rem 0; margin-top: 0.2rem;\n  &:hover { text-decoration: underline; }\n`;\n\nconst AgentList = styled.div`\n  margin: 0.35rem 0 0 1.75rem; border-top: 1px solid var(--border);\n  padding-top: 0.35rem;\n`;\n\nconst AgentRow = styled.div`\n  display: flex; align-items: center; gap: 0.5rem;\n  padding: 0.25rem 0; font-size: 0.78rem;\n`;\n\nconst AgentName = styled.span`color: var(--fg); font-weight: 500;`;\nconst AgentMeta = styled.span`color: var(--dim); font-size: 0.72rem;`;\n\nconst AgentSelect = styled.select`\n  padding: 0.15rem 0.35rem; border: 1px solid var(--border); border-radius: 4px;\n  background: var(--bg); color: var(--fg); font-size: 0.75rem; font-family: inherit;\n`;\n\nconst OptionRow = styled.label`\n  display: flex; align-items: center; gap: 0.5rem; padding: 0.35rem 0;\n  font-size: 0.85rem; color: var(--fg); cursor: pointer;\n  input { accent-color: var(--accent); }\n`;\n\nconst Hint = styled.p`font-size: 0.75rem; color: var(--dim); margin-top: 0.5rem; line-height: 1.45;`;\n\nconst ButtonRow = styled.div`\n  display: flex; gap: 0.75rem; margin-top: 1rem; justify-content: flex-end;\n`;\n\nconst SuccessIcon = styled.div`\n  text-align: center; padding: 1rem 0; color: var(--green);\n  .icon { font-size: 3rem; margin-bottom: 0.5rem; }\n`;\n\nconst ErrorIcon = styled.div`\n  text-align: center; padding: 1rem 0; color: var(--red);\n  .icon { font-size: 3rem; margin-bottom: 0.5rem; }\n`;\n\nconst ClientBadge = styled.div`\n  font-size: 0.85rem; color: var(--dim); margin-bottom: 1rem;\n  padding: 0.5rem 0.75rem; background: var(--bg); border: 1px solid var(--border);\n  border-radius: 8px;\n  strong { color: var(--fg); }\n`;\n\n// ─── Types ───────────────────────────────────────────────────────\n\ninterface RoomData {\n  room_id: string; access: string; label: string | null;\n  agents: Array<{ id: string; name: string; role: string; status: string }>;\n}\n\ninterface RoomSelection {\n  selected: boolean;\n  level: \"full\" | \"write\" | \"read\";\n  isNew: boolean;\n  expanded: boolean;\n  agentScope: Record | null;\n}\n\ntype Step = \"auth\" | \"loading\" | \"consent\" | \"success\" | \"error\";\n\n// ─── Component ───────────────────────────────────────────────────\n\nexport function ConsentPage(props: ConsentPageProps) {\n  const { origin, mode } = props;\n  const needsAuth = mode === \"elevate\"; // device + oauth arrive pre-authenticated\n\n  const [step, setStep] = useState(needsAuth ? \"auth\" : \"loading\");\n  const [status, setStatus] = useState(needsAuth ? \"\" : \"Loading rooms...\");\n  const [error, setError] = useState(\"\");\n  const [sessionId, setSid] = useState(props.sessionId ?? \"\");\n  const [rooms, setRooms] = useState([]);\n  const [selections, setSelections] = useState>({});\n  const [canCreate, setCanCreate] = useState(true);\n  const [search, setSearch] = useState(\"\");\n  const [currentScopeParts, setCurrentScopeParts] = useState>(new Set());\n  const [tokenLabel, setTokenLabel] = useState(null);\n  const [tokenScope, setTokenScope] = useState(null);\n  const [successMsg, setSuccessMsg] = useState(\"\");\n  const [redirectUrl, setRedirectUrl] = useState(null);\n\n  // ── Title text ──\n  const titleSuffix = mode === \"elevate\" ? \"scope\" : mode === \"device\" ? \"device\" : \"authorize\";\n  const subtitleText = mode === \"elevate\" && props.addRoom\n    ? <>An agent is requesting access to {props.addRoom}.\n    : mode === \"device\"\n    ? \"Choose what access to grant this device.\"\n    : mode === \"oauth\"\n    ? <>Grant {props.clientName || \"MCP Client\"} access?\n    : \"Review and edit token scope.\";\n\n  // ── Load rooms after auth ──\n  const loadRooms = useCallback(async (sid: string) => {\n    try {\n      const url = `${origin}/auth/consent/rooms?session_id=${encodeURIComponent(sid)}`\n        + (props.tokenId ? `&token_id=${encodeURIComponent(props.tokenId)}` : \"\");\n      const res = await fetch(url);\n      if (!res.ok) throw new Error(\"Failed to load rooms\");\n      const data = await res.json();\n      if (data.error) throw new Error(data.message || data.error);\n\n      const roomList: RoomData[] = data.rooms || [];\n      setRooms(roomList);\n      setTokenLabel(data.token_label);\n      setTokenScope(data.token_scope);\n\n      // Parse current scope to set initial selections\n      const scopeStr = data.token_scope || props.requestedScope || props.oauthScope || \"\";\n      const parts = scopeStr.split(/\\s+/).filter(Boolean);\n      const partSet = new Set(parts);\n      setCurrentScopeParts(partSet);\n      setCanCreate(parts.includes(\"create_rooms\") || mode !== \"elevate\");\n\n      const hasWildcard = parts.some((p: string) => p === \"rooms:*\" || p.startsWith(\"rooms:*:\"));\n      const init: Record = {};\n\n      for (const r of roomList) {\n        let inScope = hasWildcard;\n        let level: \"full\" | \"write\" | \"read\" = hasWildcard ? \"full\" : \"full\";\n        for (const p of parts) {\n          if (p === `rooms:${r.room_id}`) { inScope = true; level = \"full\"; }\n          else if (p === `rooms:${r.room_id}:write`) { inScope = true; level = \"write\"; }\n          else if (p === `rooms:${r.room_id}:read`) { inScope = true; level = \"read\"; }\n          else if (p.startsWith(`rooms:${r.room_id}:agent:`)) { inScope = true; level = \"full\"; }\n        }\n        const isRequested = r.room_id === props.addRoom;\n        init[r.room_id] = {\n          selected: mode === \"elevate\" ? (inScope || isRequested) : (hasWildcard || inScope || mode !== \"oauth\"),\n          level: isRequested && !inScope ? (props.addLevel as any || \"full\") : (inScope ? level : \"full\"),\n          isNew: isRequested && !inScope,\n          expanded: false,\n          agentScope: null,\n        };\n      }\n      setSelections(init);\n      setStep(\"consent\");\n      setStatus(\"\");\n    } catch (e: any) {\n      setError(e.message || \"Failed to load rooms\");\n      setStep(\"error\");\n    }\n  }, [origin, props.tokenId, props.addRoom, props.addLevel, props.requestedScope, props.oauthScope, mode]);\n\n  // ── Auto-load for pre-authenticated modes ──\n  useState(() => {\n    if (!needsAuth && sessionId) {\n      loadRooms(sessionId);\n    }\n  });\n\n  // ── Passkey auth (elevate mode only) ──\n  async function doPasskeyAuth() {\n    setError(\"\"); setStatus(\"Generating options...\");\n    try {\n      const { startAuthentication } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n      const optRes = await fetch(`${origin}/webauthn/authenticate/options`, {\n        method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({}),\n      });\n      const optData = await optRes.json();\n      if (!optRes.ok) throw new Error(optData.error);\n      setStatus(\"Touch your authenticator...\");\n      const assertResp = await startAuthentication({ optionsJSON: optData.options });\n      setStatus(\"Verifying...\");\n      const verRes = await fetch(`${origin}/webauthn/authenticate/verify`, {\n        method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ challengeId: optData.challengeId, response: assertResp }),\n      });\n      const verData = await verRes.json();\n      if (!verRes.ok || !verData.verified) throw new Error(verData.error || \"Verification failed\");\n      setSid(verData.sessionId);\n      setStep(\"loading\"); setStatus(\"Loading rooms...\");\n      await loadRooms(verData.sessionId);\n    } catch (e: any) { setError(e.message); setStatus(\"\"); }\n  }\n\n  // ── Filtering ──\n  const filtered = useMemo(() => {\n    const q = search.toLowerCase().trim();\n    if (!q) return rooms;\n    return rooms.filter(r =>\n      r.room_id.toLowerCase().includes(q) ||\n      (r.label || \"\").toLowerCase().includes(q) ||\n      r.agents.some(a => a.name.toLowerCase().includes(q) || a.id.toLowerCase().includes(q))\n    );\n  }, [rooms, search]);\n\n  const selectedCount = Object.values(selections).filter(s => s.selected).length;\n  const newCount = Object.values(selections).filter(s => s.selected && s.isNew).length;\n  const withAgentsCount = rooms.filter(r => r.agents.length > 0).length;\n\n  // ── Selection helpers ──\n  function toggle(roomId: string) {\n    setSelections(s => ({ ...s, [roomId]: { ...s[roomId], selected: !s[roomId]?.selected } }));\n  }\n  function setLevel(roomId: string, level: \"full\" | \"write\" | \"read\") {\n    setSelections(s => ({ ...s, [roomId]: { ...s[roomId], level } }));\n  }\n  function toggleExpand(roomId: string) {\n    setSelections(s => ({ ...s, [roomId]: { ...s[roomId], expanded: !s[roomId]?.expanded } }));\n  }\n  function setAgentBinding(roomId: string, agentId: string, value: string) {\n    setSelections(s => {\n      const curr = s[roomId];\n      const agentScope = { ...(curr.agentScope || {}) };\n      if (value === \"agent\") agentScope[agentId] = \"agent\";\n      else delete agentScope[agentId];\n      return { ...s, [roomId]: { ...curr, agentScope: Object.keys(agentScope).length ? agentScope : null } };\n    });\n  }\n  function selectAll() {\n    setSelections(s => {\n      const n = { ...s };\n      for (const r of filtered) if (n[r.room_id]) n[r.room_id] = { ...n[r.room_id], selected: true };\n      return n;\n    });\n  }\n  function selectNone() {\n    setSelections(s => {\n      const n = { ...s };\n      for (const r of filtered) if (n[r.room_id]) n[r.room_id] = { ...n[r.room_id], selected: false };\n      return n;\n    });\n  }\n  function selectWithAgents() {\n    setSelections(s => {\n      const n = { ...s };\n      for (const r of rooms) if (n[r.room_id]) n[r.room_id] = { ...n[r.room_id], selected: r.agents.length > 0 };\n      return n;\n    });\n    setSearch(\"\");\n  }\n  function selectCurrent() {\n    setSelections(s => {\n      const n = { ...s };\n      for (const [rid, sel] of Object.entries(n)) {\n        const inOld = !sel.isNew && (\n          currentScopeParts.has(`rooms:${rid}`) ||\n          currentScopeParts.has(`rooms:${rid}:read`) ||\n          currentScopeParts.has(`rooms:${rid}:write`) ||\n          currentScopeParts.has(\"rooms:*\")\n        );\n        n[rid] = { ...sel, selected: inOld };\n      }\n      return n;\n    });\n  }\n\n  // ── Build scope string ──\n  function buildScope(): string {\n    const parts: string[] = [];\n    for (const [roomId, sel] of Object.entries(selections)) {\n      if (!sel.selected) continue;\n      const agentBindings = sel.agentScope ? Object.entries(sel.agentScope).filter(([, v]) => v === \"agent\") : [];\n      if (agentBindings.length > 0) {\n        for (const [agentId] of agentBindings) parts.push(`rooms:${roomId}:agent:${agentId}`);\n      } else if (sel.level === \"read\") parts.push(`rooms:${roomId}:read`);\n      else if (sel.level === \"write\") parts.push(`rooms:${roomId}:write`);\n      else parts.push(`rooms:${roomId}`);\n    }\n    if (canCreate) parts.push(\"create_rooms\");\n    if (parts.length === 0 || (parts.length === 1 && parts[0] === \"create_rooms\")) {\n      parts.unshift(\"rooms:*\");\n    }\n    return parts.join(\" \");\n  }\n\n  // ── Approve ──\n  async function approve() {\n    setError(\"\");\n    try {\n      const scope = buildScope();\n\n      if (mode === \"elevate\") {\n        const res = await fetch(`${origin}/auth/consent/approve`, {\n          method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ mode: \"elevate\", session_id: sessionId, token_id: props.tokenId, new_scope: scope }),\n        });\n        const data = await res.json();\n        if (data.error) throw new Error(data.message || data.error);\n        setSuccessMsg(newCount > 0\n          ? `Access granted. Return to your conversation — the agent can retry.`\n          : \"Token scope updated.\");\n        setStep(\"success\");\n      } else if (mode === \"device\") {\n        const res = await fetch(`${origin}/auth/consent/approve`, {\n          method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({ mode: \"device\", session_id: sessionId, device_code: props.deviceCode, new_scope: scope }),\n        });\n        const data = await res.json();\n        if (data.error) throw new Error(data.message || data.error);\n        setSuccessMsg(\"Device authorized. You can close this tab and return to your terminal.\");\n        setStep(\"success\");\n      } else if (mode === \"oauth\") {\n        const res = await fetch(`${origin}/auth/consent/approve`, {\n          method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            mode: \"oauth\", session_id: sessionId, new_scope: scope,\n            client_id: props.clientId, redirect_uri: props.redirectUri,\n            code_challenge: props.codeChallenge, code_challenge_method: props.codeChallengeMethod,\n            state: props.oauthState, resource: props.resource,\n          }),\n        });\n        const data = await res.json();\n        if (data.error) throw new Error(data.message || data.error);\n        if (data.redirect) { window.location.href = data.redirect; return; }\n        setSuccessMsg(\"Authorization complete.\");\n        setStep(\"success\");\n      }\n    } catch (e: any) { setError(e.message || \"Failed\"); setStep(\"error\"); }\n  }\n\n  function deny() {\n    if (mode === \"device\" && props.deviceCode) {\n      fetch(`${origin}/auth/device/deny`, {\n        method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ device_code: props.deviceCode }),\n      }).catch(() => {});\n    }\n    if (mode === \"oauth\" && props.redirectUri) {\n      const redirect = new URL(props.redirectUri);\n      redirect.searchParams.set(\"error\", \"access_denied\");\n      if (props.oauthState) redirect.searchParams.set(\"state\", props.oauthState);\n      window.location.href = redirect.toString();\n      return;\n    }\n    setSuccessMsg(\"Access denied.\");\n    setStep(\"success\");\n  }\n\n  // ─── Render ────────────────────────────────────────────────────\n\n  return (\n    \n      \n        {/* Auth step (elevate only) */}\n        {step === \"auth\" && (\n          \n            sync<TitleDim>·{titleSuffix}</TitleDim>\n            {subtitleText}\n            Authenticate with passkey\n             window.close()} style={{ width: \"100%\", marginTop: \"0.5rem\" }}>Cancel\n            {status && {status}}\n            {error && {error}}\n          \n        )}\n\n        {/* Loading */}\n        {step === \"loading\" && (\n          \n            {status || \"Loading...\"}\n          \n        )}\n\n        {/* Consent editor */}\n        {step === \"consent\" && (\n          \n            sync<TitleDim>·{titleSuffix}</TitleDim>\n            {subtitleText}\n\n            {/* Context info */}\n            {mode === \"elevate\" && tokenScope !== null && (\n              \n                {tokenLabel || \"Token\"}{\" \"}\n                \n                  {props.tokenId?.substring(0, 12)}...\n                \n                Current: {tokenScope || \"(empty)\"}\n              \n            )}\n            {mode === \"oauth\" && props.clientName && (\n              {props.clientName}\n            )}\n            {mode === \"device\" && props.requestedScope && (\n              Requested: {props.requestedScope}\n            )}\n\n            {/* Toolbar */}\n            \n               setSearch(e.target.value)} />\n              \n                All\n                None\n                {withAgentsCount > 0 && With agents}\n                {mode === \"elevate\" && Current only}\n              \n            \n\n            \n              {filtered.length} of {rooms.length} rooms · {selectedCount} selected\n              {newCount > 0 && ` (${newCount} new)`}\n            \n\n            {/* Room list */}\n            \n              {filtered.length === 0 ? (\n                \n                  {rooms.length === 0 ? \"No rooms yet.\" : \"No rooms match your search.\"}\n                
\n              ) : filtered.map(r => {\n                const sel = selections[r.room_id];\n                if (!sel) return null;\n                const agentCount = r.agents.length;\n                return (\n                  \n                     toggle(r.room_id)}>\n                       toggle(r.room_id)} onClick={e => e.stopPropagation()} />\n                      \n                        {r.label || r.room_id}\n                        {r.label && r.label !== r.room_id && {r.room_id}}\n                        [{r.access}]\n                        {sel.isNew && requested}\n                        \n                          {agentCount > 0 && `${agentCount} agent${agentCount > 1 ? \"s\" : \"\"}`}\n                        \n                        {sel.selected && agentCount > 0 && (\n                           { e.stopPropagation(); toggleExpand(r.room_id); }}>\n                            {sel.expanded ? \"▾ hide agents\" : \"▸ refine per agent\"}\n                          \n                        )}\n                      \n                      {sel.selected && (\n                         e.stopPropagation()}\n                          onChange={e => { e.stopPropagation(); setLevel(r.room_id, e.target.value as any); }}>\n                          \n                          \n                          \n                        \n                      )}\n                    \n                    {sel.selected && sel.expanded && agentCount > 0 && (\n                      \n                        {r.agents.map(a => (\n                          \n                            {a.name || a.id}\n                            {a.role}\n                             e.stopPropagation()}\n                              onChange={e => setAgentBinding(r.room_id, a.id, e.target.value)}\n                              value={sel.agentScope?.[a.id] || \"\"}>\n                              \n                              \n                            \n                          \n                        ))}\n                      \n                    )}\n                  
\n                );\n              })}\n            \n\n            \n               setCanCreate(e.target.checked)} />\n              Allow creating new rooms\n            \n\n            \n              {selectedCount > 0\n                ? `${selectedCount} room${selectedCount > 1 ? \"s\" : \"\"} selected.`\n                : \"No rooms selected. Only room creation will be allowed.\"}\n              {newCount > 0 && ` ${newCount} new (highlighted in green).`}\n            \n\n            {error && {error}}\n\n            \n              Deny\n              \n                {mode === \"elevate\" ? \"Apply\" : \"Approve\"}\n              \n            \n          \n        )}\n\n        {/* Success */}\n        {step === \"success\" && (\n          \n            \n              ✓
\n              \n                {mode === \"elevate\" ? \"Scope Updated\" : mode === \"device\" ? \"Device Authorized\" : \"Authorized\"}\n              \n              {successMsg}\n            \n          \n        )}\n\n        {/* Error */}\n        {step === \"error\" && (\n          \n            \n              ✗
\n              Failed\n              {error}\n            \n             setStep(needsAuth ? \"auth\" : \"consent\")} style={{ width: \"100%\" }}>\n              Try Again\n            \n          \n        )}\n      \n    \n  );\n}\n",[],[418,1080,1174,1176],"67c67d98-1e4b-11f1-b23f-42dde27851f2",534,["D",1773344463754],[497,498],[418,1080,1174],"69c9e3a0-18b0-11f1-ad37-42dde27851f2","69c9e418-18b0-11f1-ad37-42dde27851f2","019cbed4-be27-732f-9c68-1c11ef71caf9",["D",1772728139302],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Client hydration entry for AuthorizePage. */\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { AuthorizePage } from \"./AuthorizePage.tsx\";\n\nconst propsEl = document.getElementById(\"__PROPS__\");\nconst props = propsEl ? JSON.parse(propsEl.textContent!) : {};\n\nconst root = document.getElementById(\"root\");\nif (root) {\n  hydrateRoot(root, );\n}\n",[],[418,1080,1195,1073],"authorize","755bfe56-1e50-11f1-9568-42dde27851f2","AuthorizePage.tsx","69c9b01a-18b0-11f1-ad37-42dde27851f2",547,["D",1773346634017],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** AuthorizePage — OAuth sign-in/register, then redirect to unified consent.\n *\n * Step 1: Sign in (passkey) or Register (username + passkey)\n * Step 2: Redirect to /auth/consent?mode=oauth with session + OAuth params\n */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\nimport {\n  PageWrapper, Container, Card, Title, TitleDim, Subtitle,\n  Label, Input, PrimaryButton, StatusText, ErrorText,\n} from \"../../components/mcp.tsx\";\n\nexport interface OAuthParams {\n  clientId: string;\n  clientName: string;\n  redirectUri: string;\n  codeChallenge: string;\n  codeChallengeMethod: string;\n  scope: string;\n  state: string;\n  resource: string;\n}\n\nexport interface AuthorizePageProps {\n  origin: string;\n  params: OAuthParams;\n}\n\nconst ModeToggle = styled.div`\n  display: flex; gap: 0; margin-bottom: 1.25rem; border-radius: 8px;\n  overflow: hidden; border: 1px solid var(--border, #21262d);\n`;\n\nconst Tab = styled.button<{ $active?: boolean }>`\n  flex: 1; padding: 0.5rem; border: none;\n  background: ${({ $active }) => ($active ? \"var(--surface2)\" : \"transparent\")};\n  color: ${({ $active }) => ($active ? \"var(--fg)\" : \"var(--dim)\")};\n  cursor: pointer; font-size: 0.85rem; transition: all 0.2s; font-family: inherit;\n`;\n\ntype Mode = \"signin\" | \"register\";\n\nexport function AuthorizePage({ origin, params }: AuthorizePageProps) {\n  const [mode, setMode] = useState(\"signin\");\n  const [status, setStatus] = useState(\"\");\n  const [error, setError] = useState(\"\");\n\n  function clearStatus() { setStatus(\"\"); setError(\"\"); }\n\n  function redirectToConsent(sid: string) {\n    const u = new URL(`${origin}/auth/consent`);\n    u.searchParams.set(\"mode\", \"oauth\");\n    u.searchParams.set(\"session_id\", sid);\n    u.searchParams.set(\"client_id\", params.clientId);\n    u.searchParams.set(\"client_name\", params.clientName);\n    u.searchParams.set(\"redirect_uri\", params.redirectUri);\n    u.searchParams.set(\"code_challenge\", params.codeChallenge);\n    u.searchParams.set(\"code_challenge_method\", params.codeChallengeMethod);\n    u.searchParams.set(\"scope\", params.scope);\n    u.searchParams.set(\"state\", params.state);\n    u.searchParams.set(\"resource\", params.resource);\n    window.location.href = u.toString();\n  }\n\n  async function doAuth() {\n    clearStatus();\n    try {\n      if (mode === \"register\") await doRegister();\n      else await doSignIn();\n    } catch (err: any) { setError(err.message || \"Authentication failed\"); }\n  }\n\n  async function doSignIn() {\n    setStatus(\"Generating authentication options...\");\n    const { startAuthentication } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n    const optRes = await fetch(`${origin}/webauthn/authenticate/options`, {\n      method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({}),\n    });\n    const optData = await optRes.json();\n    if (!optRes.ok) { setError(optData.error); setStatus(\"\"); return; }\n    setStatus(\"Touch your authenticator...\");\n    const assertResp = await startAuthentication({ optionsJSON: optData.options });\n    setStatus(\"Verifying...\");\n    const verRes = await fetch(`${origin}/webauthn/authenticate/verify`, {\n      method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ challengeId: optData.challengeId, response: assertResp }),\n    });\n    const verData = await verRes.json();\n    if (!verRes.ok || !verData.verified) { setError(verData.error || \"Authentication failed\"); setStatus(\"\"); return; }\n    redirectToConsent(verData.sessionId);\n  }\n\n  async function doRegister() {\n    const usernameInput = (document.getElementById(\"username\") as HTMLInputElement)?.value?.trim();\n    if (!usernameInput) { setError(\"Username required\"); return; }\n    setStatus(\"Generating passkey options...\");\n    const { startRegistration } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n    const optRes = await fetch(`${origin}/webauthn/register/options`, {\n      method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ username: usernameInput }),\n    });\n    const optData = await optRes.json();\n    if (!optRes.ok) { setError(optData.error); setStatus(\"\"); return; }\n    setStatus(\"Touch your authenticator...\");\n    const attResp = await startRegistration({ optionsJSON: optData.options });\n    setStatus(\"Verifying...\");\n    const verRes = await fetch(`${origin}/webauthn/register/verify`, {\n      method: \"POST\", headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ challengeId: optData.challengeId, userId: optData.userId, username: optData.username, response: attResp }),\n    });\n    const verData = await verRes.json();\n    if (!verRes.ok || !verData.verified) { setError(verData.error || \"Registration failed\"); setStatus(\"\"); return; }\n    redirectToConsent(verData.sessionId);\n  }\n\n  return (\n    \n      \n        \n          sync<TitleDim>·mcp</TitleDim>\n          \n            Sign in with a passkey to grant {params.clientName} access to your sync rooms.\n          \n          \n             { setMode(\"signin\"); clearStatus(); }}>Sign in\n             { setMode(\"register\"); clearStatus(); }}>New account\n          \n          {mode === \"register\" && (\n            \n              Username\n              \n            
\n          )}\n          \n            {mode === \"register\" ? \"Create account with passkey\" : \"Sign in with passkey\"}\n          \n          {status && {status}}\n          {error && {error}}\n        \n      \n    \n  );\n}\n",[],[418,1080,1195,1197],"69cab28a-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[494,495],[418,1080,1195],"69caaea2-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],[493,496,499,501,503,505,508,510],[418,1080],"2cbabeea-195e-11f1-9f66-42dde27851f2","mcp.tsx","69c9906c-18b0-11f1-ad37-42dde27851f2","019c9ffc-060a-74df-be1d-7850f5dfbf5a",252,["D",1772802769297],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Shared styled components for MCP auth pages (authorize, manage, recover).\n *\n * Uses unified theme variables. These components are isomorphic —\n * they render correctly both in SSR (renderToString) and client hydration.\n */\nimport { styled, css } from \"../styled.ts\";\n\n// ─── Layout ──────────────────────────────────────────────────────\n\nexport const PageWrapper = styled.div`\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  background: var(--bg);\n  color: var(--fg);\n  min-height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n`;\n\nexport const Container = styled.div<{ $wide?: boolean }>`\n  width: 100%;\n  max-width: ${({ $wide }) => ($wide ? \"720px\" : \"420px\")};\n  padding: 1rem;\n`;\n\nexport const Card = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 12px;\n  padding: 2rem;\n`;\n\n// ─── Typography ──────────────────────────────────────────────────\n\nexport const Title = styled.h1`\n  font-size: 1.5rem;\n  margin-bottom: 0.75rem;\n  font-weight: 600;\n`;\n\nexport const TitleDim = styled.span`\n  color: var(--dim);\n`;\n\nexport const Subtitle = styled.p`\n  color: var(--dim);\n  font-size: 0.9rem;\n  margin-bottom: 1.5rem;\n  line-height: 1.5;\n\n  strong {\n    color: var(--fg);\n  }\n`;\n\n// ─── Forms ───────────────────────────────────────────────────────\n\nexport const Label = styled.label`\n  display: block;\n  font-size: 0.8rem;\n  color: var(--dim);\n  margin-bottom: 0.3rem;\n`;\n\nexport const Input = styled.input`\n  width: 100%;\n  padding: 0.6rem 0.75rem;\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  background: var(--bg);\n  color: var(--fg);\n  font-size: 0.95rem;\n  margin-bottom: 1rem;\n  outline: none;\n  transition: border-color 0.2s;\n  font-family: inherit;\n\n  &:focus {\n    border-color: var(--accent);\n  }\n`;\n\n// ─── Buttons ─────────────────────────────────────────────────────\n\nexport const PrimaryButton = styled.button`\n  width: 100%;\n  padding: 0.7rem;\n  border: none;\n  border-radius: 8px;\n  background: var(--accent);\n  color: white;\n  font-size: 0.95rem;\n  font-weight: 500;\n  cursor: pointer;\n  transition: opacity 0.2s;\n  font-family: inherit;\n\n  &:hover {\n    opacity: 0.9;\n  }\n\n  &:disabled {\n    opacity: 0.5;\n    cursor: not-allowed;\n  }\n`;\n\nexport const SecondaryButton = styled.button`\n  padding: 0.7rem 1.5rem;\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dim);\n  font-size: 0.95rem;\n  cursor: pointer;\n  font-family: inherit;\n`;\n\n// ─── Status & Feedback ──────────────────────────────────────────\n\nexport const StatusText = styled.p`\n  color: var(--dim);\n  font-size: 0.85rem;\n  margin-top: 0.75rem;\n  min-height: 1.2em;\n`;\n\nexport const ErrorText = styled.p`\n  color: var(--red);\n  font-size: 0.85rem;\n  margin-top: 0.5rem;\n  min-height: 1.2em;\n`;\n\nexport const SuccessText = styled.p`\n  color: var(--green);\n  font-size: 0.9rem;\n`;\n\n// ─── Links ───────────────────────────────────────────────────────\n\nexport const AccentLink = styled.a`\n  color: var(--accent);\n  text-decoration: none;\n\n  &:hover {\n    text-decoration: underline;\n  }\n`;\n",[],[418,1221,1213],"components","89c59d34-2198-11f1-9238-42dde27851f2","Replay.tsx","88f60640-1a23-11f1-a362-42dde27851f2",["D",1773707445460],29,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/**\n * Replay widget — plays back a frozen room from its audit log.\n *\n * Props:\n *   roomId    — the room to replay\n *   viewToken — read-only token; no write access needed\n *   height    — optional container height (default 420px)\n *\n * Architecture:\n *   1. On mount, fetch full audit log via /poll (for the timeline)\n *   2. Fetch /replay/ to show initial state\n *   3. On playhead move to seq N, call GET /rooms/:id/replay/:seq\n *   4. Feed resulting PollData into frozen panel components\n *\n * Playback is time-faithful:\n *   - Timeline strip dots are positioned proportionally to real event timestamps\n *   - Scrubbing maps click position → timestamp → nearest event\n *   - Auto-play delays are gap_ms / speed (speed = compression factor; 1× = real time)\n *   - Gaps are capped at MAX_REAL_GAP_MS so a 6-hour silence doesn't freeze playback\n *\n * The widget is entirely read-only. No tokens are written, no mutations issued.\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled, keyframes } from \"../styled.ts\";\nimport type { AuditRow, Agent, View, Surface } from \"../types.ts\";\nimport { AgentsPanel } from \"./panels/Agents.tsx\";\nimport { StatePanel } from \"./panels/State.tsx\";\nimport { MessagesPanel } from \"./panels/Messages.tsx\";\nimport { ActionsPanel } from \"./panels/Actions.tsx\";\nimport { ViewsPanel } from \"./panels/Views.tsx\";\nimport { SurfacesView, type SurfaceContext } from \"./panels/Surfaces.tsx\";\n\n// Lazily resolved at call time so it works during SSR (no location available)\nfunction getBaseUrl(): string {\n  return (typeof location !== \"undefined\" && location.origin) || \"https://sync.parc.land\";\n}\n\n// ── Styled shell ─────────────────────────────────────────────────────────────\n\nconst Shell = styled.div<{ $height: number }>`\n  background: var(--bg);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  overflow: hidden;\n  display: flex;\n  flex-direction: column;\n  height: ${p => p.$height}px;\n  font-family: \"SF Mono\", \"Cascadia Code\", \"Fira Code\", monospace;\n  font-size: 12px;\n  color: var(--fg);\n`;\n\n// ── Top bar ──────────────────────────────────────────────────────────────────\n\nconst TopBar = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.75rem;\n  padding: 0.5rem 0.85rem;\n  border-bottom: 1px solid var(--border);\n  background: var(--surface);\n  flex-shrink: 0;\n`;\n\nconst RoomLabel = styled.div`\n  font-size: 11px;\n  color: var(--dim);\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n`;\n\nconst ReplayBadge = styled.div`\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 0.06em;\n  color: var(--accent);\n  opacity: 0.7;\n  white-space: nowrap;\n`;\n\nconst SeqLabel = styled.div`\n  font-size: 10px;\n  color: var(--dim);\n  white-space: nowrap;\n`;\n\n// ── Tabs ─────────────────────────────────────────────────────────────────────\n\nconst TabsRow = styled.div`\n  display: flex;\n  border-bottom: 1px solid var(--border);\n  flex-shrink: 0;\n  padding: 0 0.5rem;\n`;\n\nconst RTab = styled.button<{ $active: boolean }>`\n  padding: 0.35rem 0.6rem;\n  font-size: 11px;\n  background: none;\n  border: none;\n  border-bottom: 2px solid ${p => p.$active ? \"var(--accent)\" : \"transparent\"};\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  cursor: pointer;\n  font-family: inherit;\n  white-space: nowrap;\n  &:hover { color: var(--fg); }\n`;\n\nconst TabBadge = styled.span<{ $active: boolean }>`\n  display: inline-block;\n  background: ${p => p.$active ? \"rgba(88,166,255,0.15)\" : \"var(--border)\"};\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  border-radius: 8px;\n  padding: 0 4px;\n  font-size: 9px;\n  margin-left: 3px;\n`;\n\n// ── Panel area ───────────────────────────────────────────────────────────────\n\nconst PanelArea = styled.div`\n  flex: 1;\n  overflow-y: auto;\n  -webkit-overflow-scrolling: touch;\n`;\n\nconst EmptyState = styled.div`\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  height: 100%;\n  color: var(--dim);\n  font-size: 11px;\n  opacity: 0.5;\n`;\n\n// ── Agent colours ─────────────────────────────────────────────────────────────\n\nconst AGENT_PALETTE = [\n  \"var(--accent)\", \"var(--green)\", \"var(--purple)\", \"var(--orange)\",\n  \"var(--yellow)\", \"var(--red)\", \"#e879a0\", \"#47d1d1\",\n];\n\nfunction agentColor(agentId: string): string {\n  let h = 0;\n  for (let i = 0; i < agentId.length; i++) h = ((h << 5) - h + agentId.charCodeAt(i)) | 0;\n  return AGENT_PALETTE[Math.abs(h) % AGENT_PALETTE.length];\n}\n\n// ── Event kind symbols ────────────────────────────────────────────────────────\n\nfunction kindSymbol(kind: string): string {\n  switch (kind) {\n    case \"agent_join\": return \"+\";\n    case \"agent_update\": return \"~\";\n    case \"register_action\": return \"⚡\";\n    case \"delete_action\": return \"−\";\n    case \"register_view\": return \"◉\";\n    case \"delete_view\": return \"−\";\n    case \"invoke\": return \"→\";\n    default: return \"·\";\n  }\n}\n\n// ── Timeline ─────────────────────────────────────────────────────────────────\n\nconst TimelineArea = styled.div`\n  flex-shrink: 0;\n  border-top: 1px solid var(--border);\n  padding: 0.5rem 0.85rem 0.6rem;\n  background: var(--surface);\n`;\n\nconst ControlsRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.35rem;\n`;\n\nconst TBtn = styled.button<{ $active?: boolean }>`\n  background: none;\n  border: 1px solid ${p => p.$active ? \"var(--accent)\" : \"var(--border)\"};\n  border-radius: 4px;\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  font-size: 11px;\n  padding: 0.2rem 0.4rem;\n  cursor: pointer;\n  font-family: inherit;\n  white-space: nowrap;\n  flex-shrink: 0;\n  line-height: 1;\n  &:hover { color: var(--fg); border-color: var(--dim); }\n  &:disabled { opacity: 0.3; cursor: default; }\n`;\n\nconst SpeedBtn = styled.button<{ $active: boolean }>`\n  background: none;\n  border: 1px solid ${p => p.$active ? \"var(--accent)\" : \"var(--border)\"};\n  border-radius: 4px;\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  font-size: 10px;\n  padding: 0.2rem 0.4rem;\n  cursor: pointer;\n  font-family: inherit;\n  white-space: nowrap;\n  &:hover { color: var(--fg); }\n`;\n\nconst SeqCounter = styled.div`\n  font-size: 10px;\n  color: var(--dim);\n  white-space: nowrap;\n  min-width: 3.5em;\n  text-align: center;\n`;\n\nconst Spacer = styled.div`flex: 1;`;\n\n// ── Visual timeline strip ────────────────────────────────────────────────────\n\nconst StripWrap = styled.div`\n  margin-top: 0.35rem;\n  position: relative;\n  height: 18px;\n  cursor: pointer;\n`;\n\nconst StripTrack = styled.div`\n  position: absolute;\n  top: 8px;\n  left: 0;\n  right: 0;\n  height: 2px;\n  background: var(--border);\n  border-radius: 1px;\n`;\n\nconst StripDot = styled.div<{ $color: string; $active: boolean; $pct: number }>`\n  position: absolute;\n  top: ${p => p.$active ? \"3px\" : \"5px\"};\n  left: ${p => p.$pct}%;\n  width: ${p => p.$active ? \"8px\" : \"4px\"};\n  height: ${p => p.$active ? \"12px\" : \"8px\"};\n  margin-left: ${p => p.$active ? \"-4px\" : \"-2px\"};\n  border-radius: ${p => p.$active ? \"2px\" : \"1px\"};\n  background: ${p => p.$color};\n  opacity: ${p => p.$active ? 1 : 0.5};\n  transition: all 0.1s ease;\n  z-index: ${p => p.$active ? 2 : 1};\n`;\n\nconst TimeRow = styled.div`\n  display: flex;\n  justify-content: space-between;\n  margin-top: 0.2rem;\n`;\n\nconst TimeLabel = styled.div`\n  font-size: 9px;\n  color: var(--dim);\n  opacity: 0.5;\n  white-space: nowrap;\n`;\n\nconst EventLabel = styled.div`\n  font-size: 10px;\n  color: var(--dim);\n  margin-top: 0.2rem;\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  min-height: 1.4em;\n  display: flex;\n  align-items: center;\n  gap: 0.35rem;\n`;\n\nconst AgentDot = styled.span<{ $color: string }>`\n  display: inline-block;\n  width: 6px;\n  height: 6px;\n  border-radius: 50%;\n  background: ${p => p.$color};\n  flex-shrink: 0;\n`;\n\n// ── Loading shimmer ───────────────────────────────────────────────────────────\n\nconst shimmer = keyframes`\n  0% { opacity: 0.4; }\n  50% { opacity: 0.8; }\n  100% { opacity: 0.4; }\n`;\n\nconst Loading = styled.div`\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  height: 100%;\n  color: var(--dim);\n  font-size: 11px;\n  animation: ${shimmer} 1.5s ease-in-out infinite;\n`;\n\n// ── Time helpers ──────────────────────────────────────────────────────────────\n\n/** Extract epoch ms from an audit row's embedded .ts field. Returns 0 if absent. */\nfunction entryMs(entry: AuditRow | undefined): number {\n  const ts = (entry?.value as any)?.ts;\n  if (!ts) return 0;\n  const ms = Date.parse(ts);\n  return isNaN(ms) ? 0 : ms;\n}\n\n/** Format a duration in ms as a compact human string: 0s, 4s, 2m 3s, 1h 4m */\nfunction formatDuration(ms: number): string {\n  if (ms <= 0) return \"0s\";\n  const s = Math.floor(ms / 1000);\n  if (s < 60) return `${s}s`;\n  const m = Math.floor(s / 60);\n  const rs = s % 60;\n  if (m < 60) return rs > 0 ? `${m}m ${rs}s` : `${m}m`;\n  const h = Math.floor(m / 60);\n  const rm = m % 60;\n  return rm > 0 ? `${h}h ${rm}m` : `${h}h`;\n}\n\n/** Format a total duration for the right end label: abbreviated for long spans. */\nfunction formatTotal(ms: number): string {\n  return formatDuration(ms);\n}\n\n// Max real gap before we cap the playback delay (30s of real time = cap)\nconst MAX_REAL_GAP_MS = 30_000;\n// Minimum playback delay per step (ms) — prevents instant-fire on zero-gap clusters\nconst MIN_DELAY_MS = 50;\n\n// ── Data shape normalizers ────────────────────────────────────────────────────\n\nfunction normalizeAgents(raw: any): Agent[] {\n  if (!raw) return [];\n  if (Array.isArray(raw)) return raw;\n  return Object.entries(raw).map(([id, v]: [string, any]) => ({ id, ...v }));\n}\n\nfunction normalizeState(raw: any): any[] {\n  if (!raw) return [];\n  if (Array.isArray(raw)) return raw;\n  const rows: any[] = [];\n  for (const [scope, keys] of Object.entries(raw)) {\n    if (typeof keys !== \"object\" || keys === null) continue;\n    for (const [key, value] of Object.entries(keys as Record)) {\n      rows.push({ scope, key, value, version: 1, room_id: \"\", updated_at: \"\" });\n    }\n  }\n  return rows;\n}\n\nfunction normalizeMessages(raw: any): any[] {\n  if (!raw) return [];\n  if (Array.isArray(raw)) return raw;\n  if (raw.recent && Array.isArray(raw.recent)) {\n    return raw.recent.map((m: any) => ({\n      sort_key: m.seq ?? 0,\n      value: m,\n      updated_at: \"\",\n    }));\n  }\n  return Object.entries(raw)\n    .filter(([k]) => !isNaN(Number(k)))\n    .sort(([a], [b]) => Number(a) - Number(b))\n    .map(([k, v]) => ({ sort_key: Number(k), value: v, updated_at: \"\" }));\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\nconst SPEEDS = [1, 2, 5] as const;\ntype Speed = typeof SPEEDS[number];\n\nfunction describeAuditEntry(entry: any): string {\n  if (!entry) return \"\";\n  const kind = entry.kind ?? \"invoke\";\n  const agent = entry.agent ?? \"?\";\n  switch (kind) {\n    case \"agent_join\": return `${agent} joined`;\n    case \"agent_update\": return `${agent} updated`;\n    case \"register_action\": return `${agent} registered action \"${entry.schema?.id ?? \"\"}\"`;\n    case \"delete_action\": return `${agent} deleted action \"${entry.schema?.id ?? \"\"}\"`;\n    case \"register_view\": return `${agent} registered view \"${entry.schema?.id ?? \"\"}\"`;\n    case \"delete_view\": return `${agent} deleted view \"${entry.schema?.id ?? \"\"}\"`;\n    case \"invoke\": {\n      const ok = entry.ok ? \"\" : \" ✗\";\n      return `${agent} → ${entry.action ?? \"?\"}${ok}`;\n    }\n    default: return `${agent}: ${kind}`;\n  }\n}\n\n// ── Render hint → Surface converter (mirrors Dashboard.tsx logic) ─────────────\n\nfunction renderHintToSurface(view: View): Surface {\n  const hint = view.render!;\n  const id = `auto-${view.id}`;\n  const label = hint.label || view.description || view.id;\n  switch (hint.type) {\n    case \"metric\": return { id, type: \"metric\", view: view.id, label };\n    case \"markdown\": return { id, type: \"markdown\", view: view.id, label };\n    case \"array-table\": return { id, type: \"array-table\", view: view.id, label, columns: hint.columns, max_rows: hint.max_rows };\n    case \"view-table\": return { id, type: \"view-table\", views: [view.id], label };\n    default: return { id, type: \"metric\", view: view.id, label };\n  }\n}\n\n// ── Component ─────────────────────────────────────────────────────────────────\n\ninterface ReplayWidgetProps {\n  roomId: string;\n  viewToken: string;\n  height?: number;\n}\n\ntype ReplayTab = \"surfaces\" | \"agents\" | \"state\" | \"messages\" | \"actions\" | \"views\";\n\nexport function ReplayWidget({ roomId, viewToken, height = 420 }: ReplayWidgetProps) {\n  const [auditLog, setAuditLog] = useState([]);\n  const [snapshot, setSnapshot] = useState(null);\n  const [playIdx, setPlayIdx] = useState(0);\n  const [playing, setPlaying] = useState(false);\n  const [speed, setSpeed] = useState(1);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState(null);\n  const [fetching, setFetching] = useState(false);\n  const [activeTab, setActiveTab] = useState(\"agents\");\n  const playTimeoutRef = useRef | null>(null);\n  const fetchAbortRef = useRef(null);\n\n  const authHeadersRef = useRef({ \"Authorization\": `Bearer ${viewToken}` });\n  useEffect(() => {\n    authHeadersRef.current = { \"Authorization\": `Bearer ${viewToken}` };\n  }, [viewToken]);\n\n  // ── Fetch full audit log on mount ─────────────────────────────────────────\n  useEffect(() => {\n    setLoading(true);\n    setError(null);\n    const baseUrl = getBaseUrl();\n    fetch(`${baseUrl}/rooms/${roomId}/poll?audit_limit=2000`, { headers: authHeadersRef.current })\n      .then(async r => {\n        if (!r.ok) {\n          const body = await r.text().catch(() => \"\");\n          throw new Error(`${r.status}: ${body.slice(0, 120)}`);\n        }\n        return r.json();\n      })\n      .then((data: any) => {\n        // v8: audit entries have `seq` instead of `sort_key`. Normalize.\n        const rawAudit = data.audit || [];\n        const log: AuditRow[] = rawAudit.map((a: any) => ({\n          sort_key: a.sort_key ?? a.seq ?? 0,\n          value: a.value,\n          updated_at: a.updated_at ?? \"\",\n        })).sort(\n          (a: AuditRow, b: AuditRow) => Number(a.sort_key) - Number(b.sort_key)\n        );\n        setAuditLog(log);\n        setPlayIdx(0);\n        // Load snapshot at the very first event\n        const firstSeq = log.length > 0 ? Number(log[0].sort_key ?? 0) : 0;\n        fetch(`${baseUrl}/rooms/${roomId}/replay/${firstSeq}`, { headers: authHeadersRef.current })\n          .then(r => r.ok ? r.json() : null)\n          .then(d => { if (d) setSnapshot(d); })\n          .catch(() => {});\n      })\n      .catch(e => setError(e.message ?? String(e)))\n      .finally(() => setLoading(false));\n  }, [roomId, viewToken]);\n\n  // ── Fetch snapshot at a given audit index ─────────────────────────────────\n  const fetchSnapshot = useCallback(async (idx: number) => {\n    if (auditLog.length === 0) return;\n    const seq = Number(auditLog[idx]?.sort_key ?? idx);\n    if (fetchAbortRef.current) fetchAbortRef.current.abort();\n    const ac = new AbortController();\n    fetchAbortRef.current = ac;\n    setFetching(true);\n    const baseUrl = getBaseUrl();\n    try {\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/replay/${seq}`, {\n        headers: authHeadersRef.current,\n        signal: ac.signal,\n      });\n      if (!r.ok) return;\n      setSnapshot(await r.json());\n    } catch (e: any) {\n      if (e.name !== \"AbortError\") setError(e.message ?? String(e));\n    } finally {\n      setFetching(false);\n    }\n  }, [roomId, auditLog]);\n\n  // ── Time-based auto-play via setTimeout chain ─────────────────────────────\n  // Re-runs whenever playIdx advances (or playing/speed/auditLog change).\n  // Each timeout fires once, advances playIdx by 1, then this effect re-runs\n  // and schedules the *next* gap — so speed changes take effect immediately.\n  useEffect(() => {\n    if (playTimeoutRef.current) clearTimeout(playTimeoutRef.current);\n    if (!playing || auditLog.length === 0) return;\n    if (playIdx >= auditLog.length - 1) {\n      setPlaying(false);\n      return;\n    }\n    const currentMs = entryMs(auditLog[playIdx]);\n    const nextMs = entryMs(auditLog[playIdx + 1]);\n    const rawGap = Math.max(0, nextMs - currentMs);\n    const cappedGap = Math.min(rawGap, MAX_REAL_GAP_MS);\n    const delay = Math.max(MIN_DELAY_MS, cappedGap / speed);\n\n    playTimeoutRef.current = setTimeout(() => {\n      const next = playIdx + 1;\n      setPlayIdx(next);\n      fetchSnapshot(next);\n    }, delay);\n\n    return () => { if (playTimeoutRef.current) clearTimeout(playTimeoutRef.current); };\n  }, [playing, playIdx, speed, auditLog, fetchSnapshot]);\n\n  const togglePlay = useCallback(() => {\n    setPlaying(p => {\n      if (!p && playIdx >= auditLog.length - 1) {\n        setPlayIdx(0);\n        fetchSnapshot(0);\n      }\n      return !p;\n    });\n  }, [playIdx, auditLog.length, fetchSnapshot]);\n\n  const stepBack = useCallback(() => {\n    if (playIdx <= 0) return;\n    const next = playIdx - 1;\n    setPlayIdx(next);\n    fetchSnapshot(next);\n  }, [playIdx, fetchSnapshot]);\n\n  const stepForward = useCallback(() => {\n    if (playIdx >= auditLog.length - 1) return;\n    const next = playIdx + 1;\n    setPlayIdx(next);\n    fetchSnapshot(next);\n  }, [playIdx, auditLog.length, fetchSnapshot]);\n\n  // ── Scrub: debounced to avoid hammering /replay on drag ──────────────────\n  const scrubTimeout = useRef | null>(null);\n  const onScrub = useCallback((idx: number) => {\n    setPlayIdx(idx);\n    if (scrubTimeout.current) clearTimeout(scrubTimeout.current);\n    scrubTimeout.current = setTimeout(() => fetchSnapshot(idx), 120);\n  }, [fetchSnapshot]);\n\n  // ── Timeline strip: time-based click mapping ──────────────────────────────\n  const stripRef = useRef(null);\n\n  const firstMs = auditLog.length > 0 ? entryMs(auditLog[0]) : 0;\n  const lastMs = auditLog.length > 0 ? entryMs(auditLog[auditLog.length - 1]) : 0;\n  const totalMs = lastMs - firstMs;\n\n  const onStripClick = useCallback((e: React.MouseEvent) => {\n    if (!stripRef.current || auditLog.length === 0) return;\n    const rect = stripRef.current.getBoundingClientRect();\n    const pct = Math.max(0, Math.min(1, (e.clientX - rect.left) / rect.width));\n\n    let idx: number;\n    if (totalMs <= 0) {\n      // All events at same timestamp — fall back to index\n      idx = Math.round(pct * (auditLog.length - 1));\n    } else {\n      const targetMs = firstMs + pct * totalMs;\n      // Last entry with ts <= targetMs\n      idx = 0;\n      for (let i = 0; i < auditLog.length; i++) {\n        if (entryMs(auditLog[i]) <= targetMs) idx = i;\n        else break;\n      }\n    }\n    setPlayIdx(idx);\n    fetchSnapshot(idx);\n  }, [auditLog, firstMs, totalMs, fetchSnapshot]);\n\n  // ── Derived display values ────────────────────────────────────────────────\n  const currentEntry = auditLog[playIdx]?.value;\n  const eventDesc = describeAuditEntry(currentEntry);\n  const currentAgent = (currentEntry as any)?.agent ?? \"\";\n  const currentKind = (currentEntry as any)?.kind ?? \"invoke\";\n\n  const currentMs = entryMs(auditLog[playIdx]);\n  const elapsedMs = currentMs - firstMs;\n  const seqLabel = auditLog.length > 0 ? `${playIdx + 1} / ${auditLog.length}` : \"—\";\n  const elapsedLabel = totalMs > 0 ? `+${formatDuration(elapsedMs)}` : \"\";\n  const totalLabel = totalMs > 0 ? formatTotal(totalMs) : \"\";\n\n  const agents = normalizeAgents(snapshot?.agents);\n  const state = normalizeState(snapshot?.state);\n  const messages = normalizeMessages(snapshot?.messages);\n  const actions: any[] = Array.isArray((snapshot as any)?.actions) ? (snapshot as any).actions : [];\n  const views: any[] = Array.isArray((snapshot as any)?.views) ? (snapshot as any).views : [];\n  const agentMap: Record = {};\n  for (const a of agents) agentMap[a.id] = a;\n\n  // ── Surfaces from views with render hints ──────────────────────────────────\n  const activeSurfaces = useMemo(() => {\n    return views\n      .filter((v: any) => v.render)\n      .sort((a: any, b: any) => (a.render?.order ?? 999) - (b.render?.order ?? 999))\n      .map((v: any) => renderHintToSurface(v as View));\n  }, [views]);\n\n  const hasSurfaces = activeSurfaces.length > 0;\n\n  // Auto-switch to surfaces tab when surfaces become available\n  useEffect(() => {\n    if (hasSurfaces && activeTab === \"agents\") setActiveTab(\"surfaces\");\n  }, [hasSurfaces]);\n\n  const surfaceCtx = useMemo(() => {\n    if (!snapshot || !hasSurfaces) return null;\n    return {\n      views: views.map((v: any) => ({ id: v.id, value: v.value, description: v.description, render: v.render })),\n      actions: actions.map((a: any) => ({ id: a.id, available: a.available !== false, description: a.description, params: a.params, writes: a.writes, if: a.if })),\n      messages: messages.map((m: any) => ({ sort_key: m.sort_key ?? 0, value: m.value, updated_at: m.updated_at ?? \"\" })),\n      state: state.map((s: any) => ({ scope: s.scope ?? \"_shared\", key: s.key ?? \"\", value: s.value })),\n      agentMap: Object.fromEntries(agents.map(a => [a.id, { name: a.name }])),\n      roomId,\n      baseUrl: getBaseUrl(),\n      authHeaders: () => authHeadersRef.current,\n      evalCel: () => true,\n      readOnly: true,\n    };\n  }, [snapshot, agents, state, messages, actions, views, roomId, hasSurfaces]);\n\n  const tabs: { id: ReplayTab; label: string; count: number }[] = [\n    ...(hasSurfaces ? [{ id: \"surfaces\" as ReplayTab, label: \"Surfaces\", count: activeSurfaces.length }] : []),\n    { id: \"agents\", label: \"Agents\", count: agents.length },\n    { id: \"state\", label: \"State\", count: state.length },\n    { id: \"messages\", label: \"Messages\", count: messages.length },\n    { id: \"actions\", label: \"Actions\", count: actions.length },\n    { id: \"views\", label: \"Views\", count: views.length },\n  ];\n\n  return (\n    \n      {/* Top bar */}\n      \n        {roomId}\n        {fetching && …}\n        {seqLabel}\n        {elapsedLabel && {elapsedLabel}}\n        replay\n      \n\n      {/* Tabs */}\n      \n        {tabs.map(t => (\n           setActiveTab(t.id)}>\n            {t.label}\n            {t.count}\n          \n        ))}\n      \n\n      {/* Panel */}\n      \n        {loading ? (\n          loading audit log…\n        ) : error ? (\n          \n            fetch error\n            {error}\n          \n        ) : !snapshot ? (\n          no data\n        ) : (\n          <>\n            {activeTab === \"surfaces\" && surfaceCtx && (\n              \n            )}\n            {activeTab === \"agents\" && (\n              agents.length === 0\n                ? no agents at this point\n                : \n            )}\n            {activeTab === \"state\" && (\n              state.length === 0\n                ? no state at this point\n                : \n            )}\n            {activeTab === \"messages\" && (\n              messages.length === 0\n                ? no messages at this point\n                :  authHeadersRef.current}\n                    autoScroll={false}\n                    readOnly\n                    epochMs={firstMs}\n                  />\n            )}\n            {activeTab === \"actions\" && (\n              actions.length === 0\n                ? no actions at this point\n                :  authHeadersRef.current}\n                    readOnly\n                  />\n            )}\n            {activeTab === \"views\" && (\n              views.length === 0\n                ? no views at this point\n                : \n            )}\n          \n        )}\n      \n\n      {/* Timeline */}\n      \n        \n          \n            {playing ? \"⏸\" : \"▶\"}\n          \n          ◀\n          = auditLog.length - 1}>▶\n          {seqLabel}\n          \n          {SPEEDS.map(s => (\n             setSpeed(s)}>\n              {s}×\n            \n          ))}\n        \n\n        {auditLog.length > 0 && (\n          <>\n            \n              \n              {auditLog.map((entry, i) => {\n                const v = (entry.value ?? {}) as any;\n                const agent = v.agent ?? \"\";\n                const kind = v.kind ?? \"invoke\";\n                // Position by real timestamp fraction; fall back to index if no ts data\n                const pct = totalMs > 0\n                  ? Math.max(0, Math.min(100, ((entryMs(entry) - firstMs) / totalMs) * 100))\n                  : auditLog.length <= 1 ? 50 : (i / (auditLog.length - 1)) * 100;\n                return (\n                  \n                );\n              })}\n            \n\n            {totalMs > 0 && (\n              \n                0s\n                {totalLabel}\n              \n            )}\n          \n        )}\n\n        \n          {currentAgent && }\n          {kindSymbol(currentKind)} {eventDesc || \"\\u00a0\"}\n        \n      \n    \n  );\n}\n",[],[418,1221,1223],"2a6f48e0-1f03-11f1-ac56-42dde27851f2","Overview.tsx","40df2bba-1efc-11f1-9301-42dde27851f2",611,["D",1773423388237],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Overview / Vision & Architecture page — SSR-compatible, uses project theme vars.\n *\n * Typography: Newsreader (serif body), Playfair Display (display quote),\n * SF Mono/Fira Code (monospace). Loaded via headScripts in pages.tsx.\n */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { Nav } from \"./Nav.tsx\";\n\n// ── Section definitions ──────────────────────────────────────────────────────\n\ninterface SectionDef {\n  id: string;\n  label: string;\n  title: string;\n  subtitle: string;\n}\n\nconst SECTIONS: SectionDef[] = [\n  { id: \"thesis\", label: \"Thesis\", title: \"The Substrate Thesis\", subtitle: \"Programs execute. Ecosystems emerge.\" },\n  { id: \"algebra\", label: \"Algebra\", title: \"The Sync Algebra\", subtitle: \"Two operations. Ten endpoints. One substrate.\" },\n  { id: \"room\", label: \"Room\", title: \"Anatomy of a Room\", subtitle: \"Shared state observed by self-activating participants.\" },\n  { id: \"convergence\", label: \"Convergence\", title: \"Three Projects, One Architecture\", subtitle: \"ctxl · sync · playtest\" },\n  { id: \"salience\", label: \"Salience\", title: \"Adaptive Salience\", subtitle: \"The missing reward signal.\" },\n];\n\n// ── Typography ───────────────────────────────────────────────────────────────\n\nconst SERIF = '\"Newsreader\", Georgia, \"Times New Roman\", serif';\nconst DISPLAY = '\"Playfair Display\", Georgia, serif';\nconst MONO = '\"SF Mono\", \"Fira Code\", \"Cascadia Code\", monospace';\nconst SYSTEM = '-apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif';\n\n// ── Layout ───────────────────────────────────────────────────────────────────\n\nconst Page = styled.div`\n  font-family: ${SERIF};\n  background: var(--bg);\n  color: var(--fg);\n  line-height: 1.6;\n  min-height: 100vh;\n  display: flex;\n  flex-direction: column;\n  a { color: var(--accent); text-decoration: none; }\n  a:hover { text-decoration: underline; }\n`;\n\nconst Header = styled.div`\n  padding: 3rem 3rem 2rem;\n  border-bottom: 1px solid var(--border);\n  @media (max-width: 640px) { padding: 2rem 1.25rem 1.25rem; }\n`;\n\nconst Mono = styled.span`\n  font-family: ${MONO};\n`;\n\nconst Breadcrumb = styled.span`\n  font-family: ${MONO};\n  font-size: 0.72rem;\n  letter-spacing: 0.15em;\n  text-transform: uppercase;\n  color: var(--dim);\n  margin-bottom: 0.75rem;\n  display: block;\n  a { color: var(--dim); }\n  a:hover { color: var(--accent); }\n`;\n\nconst PageTitle = styled.h1`\n  font-family: ${SERIF};\n  font-size: 2.25rem;\n  font-weight: 600;\n  letter-spacing: -0.03em;\n  margin: 0;\n  line-height: 1.2;\n  @media (max-width: 640px) { font-size: 1.65rem; }\n`;\n\nconst PageSub = styled.p`\n  font-family: ${SERIF};\n  color: var(--dim);\n  font-size: 1.05rem;\n  margin-top: 0.4rem;\n  font-style: italic;\n  @media (max-width: 640px) { font-size: 0.92rem; }\n`;\n\nconst Layout = styled.div`\n  display: flex;\n  flex: 1;\n  @media (max-width: 768px) { flex-direction: column; }\n`;\n\nconst Sidebar = styled.nav`\n  width: 210px;\n  flex-shrink: 0;\n  padding: 1.5rem 0.85rem;\n  border-right: 1px solid var(--border);\n  position: sticky;\n  top: 48px;\n  height: calc(100vh - 48px - 120px);\n  overflow-y: auto;\n  @media (max-width: 768px) {\n    width: 100%;\n    height: auto;\n    position: static;\n    border-right: none;\n    border-bottom: 1px solid var(--border);\n    padding: 0.6rem 1.25rem;\n    display: flex;\n    gap: 0.25rem;\n    overflow-x: auto;\n    overflow-y: hidden;\n    -webkit-overflow-scrolling: touch;\n  }\n`;\n\nconst SideBtn = styled.button<{ $active: boolean }>`\n  display: block;\n  width: 100%;\n  text-align: left;\n  padding: 0.6rem 0.85rem;\n  margin-bottom: 0.25rem;\n  background: ${({ $active }) => ($active ? \"var(--surface)\" : \"transparent\")};\n  border: none;\n  border-radius: 6px;\n  border-left: 2px solid ${({ $active }) => ($active ? \"var(--accent)\" : \"transparent\")};\n  cursor: pointer;\n  font-family: inherit;\n  transition: all 0.15s;\n  &:hover { background: var(--surface); }\n  @media (max-width: 768px) {\n    width: auto;\n    flex-shrink: 0;\n    padding: 0.4rem 0.7rem;\n    border-left: none;\n    border-bottom: 2px solid ${({ $active }) => ($active ? \"var(--accent)\" : \"transparent\")};\n    border-radius: 4px 4px 0 0;\n    margin-bottom: 0;\n  }\n`;\n\nconst SideBtnLabel = styled.span<{ $active: boolean }>`\n  font-family: ${MONO};\n  font-size: 0.7rem;\n  text-transform: uppercase;\n  letter-spacing: 0.12em;\n  color: ${({ $active }) => ($active ? \"var(--accent)\" : \"var(--dim)\")};\n  display: block;\n`;\n\nconst SideBtnSub = styled.div<{ $active: boolean }>`\n  font-family: ${SERIF};\n  font-size: 0.73rem;\n  color: var(--dim);\n  opacity: ${({ $active }) => ($active ? 1 : 0.55)};\n  margin-top: 0.15rem;\n  font-style: italic;\n  @media (max-width: 768px) { display: none; }\n`;\n\nconst Main = styled.main`\n  flex: 1;\n  padding: 2.25rem 3rem;\n  max-width: 760px;\n  @media (max-width: 768px) { padding: 1.75rem 1.25rem; }\n`;\n\nconst SectionTitle = styled.h2`\n  font-family: ${SERIF};\n  font-size: 1.75rem;\n  font-weight: 600;\n  letter-spacing: -0.025em;\n  margin: 0 0 0.2rem;\n  line-height: 1.25;\n  @media (max-width: 640px) { font-size: 1.35rem; }\n`;\n\nconst SectionSub = styled.p`\n  font-family: ${SERIF};\n  color: var(--dim);\n  font-size: 0.95rem;\n  font-style: italic;\n  margin-bottom: 1.75rem;\n`;\n\nconst Body = styled.p`\n  font-family: ${SERIF};\n  font-size: 1.02rem;\n  line-height: 1.8;\n  margin-bottom: 1.75rem;\n`;\n\nconst BodyDim = styled(Body)`\n  color: var(--dim);\n  font-size: 0.92rem;\n  line-height: 1.75;\n`;\n\nconst BodySmall = styled.p`\n  font-family: ${SERIF};\n  font-size: 0.88rem;\n  line-height: 1.7;\n  color: var(--dim);\n  margin-bottom: 1.25rem;\n  a { color: var(--accent); }\n`;\n\nconst Footer = styled.footer`\n  font-family: ${SYSTEM};\n  text-align: center;\n  padding: 2.5rem;\n  color: var(--dim);\n  font-size: 0.8rem;\n  border-top: 1px solid var(--border);\n  a { color: var(--accent); }\n`;\n\n// ── Blocks ───────────────────────────────────────────────────────────────────\n\nconst QuoteBlock = styled.div`\n  background: linear-gradient(135deg, rgba(88, 166, 255, 0.08), transparent);\n  border: 1px solid var(--border);\n  border-radius: 10px;\n  padding: 1.75rem 2rem;\n  margin-bottom: 2rem;\n  font-family: ${DISPLAY};\n  font-size: 1.35rem;\n  font-style: italic;\n  line-height: 1.6;\n  color: var(--accent);\n  @media (max-width: 640px) { font-size: 1.1rem; padding: 1.25rem 1.4rem; }\n`;\n\nconst Callout = styled.div<{ $color: string; $tint?: string }>`\n  padding: 1.15rem 1.5rem;\n  border-left: 3px solid ${({ $color }) => $color};\n  background: ${({ $tint }) => $tint ?? \"var(--surface)\"};\n  border-radius: 0 8px 8px 0;\n  margin-bottom: 1.75rem;\n  font-family: ${SERIF};\n  font-size: 0.92rem;\n  line-height: 1.75;\n  color: var(--dim);\n`;\n\nconst Card = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 1.25rem 1.4rem;\n  position: relative;\n  overflow: hidden;\n`;\n\nconst CardAccentTop = styled.div<{ $color: string }>`\n  position: absolute;\n  top: 0; left: 0; right: 0;\n  height: 2.5px;\n  background: ${({ $color }) => $color};\n  opacity: 0.75;\n`;\n\nconst CardAccentLeft = styled.div<{ $color: string }>`\n  position: absolute;\n  left: 0; top: 0; bottom: 0;\n  width: 3px;\n  background: ${({ $color }) => $color};\n  opacity: 0.75;\n`;\n\nconst Grid2 = styled.div`\n  display: grid;\n  grid-template-columns: 1fr 1fr;\n  gap: 0.85rem;\n  margin-bottom: 2rem;\n  @media (max-width: 560px) { grid-template-columns: 1fr; }\n`;\n\nconst Grid3 = styled.div`\n  display: grid;\n  grid-template-columns: 1fr 1fr 1fr;\n  gap: 0.85rem;\n  margin-bottom: 2rem;\n  @media (max-width: 560px) { grid-template-columns: 1fr; }\n`;\n\nconst SectionLabel = styled.span`\n  font-family: ${MONO};\n  font-size: 0.68rem;\n  text-transform: uppercase;\n  letter-spacing: 0.18em;\n  color: var(--dim);\n  display: block;\n  margin-bottom: 0.75rem;\n`;\n\nconst CardLabel = styled.span<{ $color?: string }>`\n  font-family: ${MONO};\n  font-size: 0.7rem;\n  text-transform: uppercase;\n  letter-spacing: 0.12em;\n  color: ${({ $color }) => $color ?? \"var(--dim)\"};\n  display: block;\n  margin-bottom: 0.65rem;\n`;\n\nconst CardTitle = styled.div`\n  font-family: ${SERIF};\n  font-size: 1.08rem;\n  font-weight: 600;\n  margin-bottom: 0.45rem;\n`;\n\nconst CardDesc = styled.div`\n  font-family: ${SERIF};\n  font-size: 0.85rem;\n  color: var(--dim);\n  line-height: 1.65;\n`;\n\nconst CodeBlock = styled.div`\n  font-family: ${MONO};\n  font-size: 0.82rem;\n  padding: 0.85rem 1.15rem;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  display: block;\n  line-height: 1.9;\n  margin-bottom: 1.75rem;\n  overflow-x: auto;\n  color: var(--fg);\n`;\n\nconst EndpointGrid = styled.div`\n  display: grid;\n  grid-template-columns: 1fr 1fr;\n  gap: 0.4rem;\n  margin-bottom: 1.75rem;\n  @media (max-width: 560px) { grid-template-columns: 1fr; }\n`;\n\nconst EndpointRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.65rem;\n  padding: 0.5rem 0.75rem;\n  background: var(--surface);\n  border-radius: 4px;\n  font-family: ${MONO};\n  font-size: 0.78rem;\n`;\n\nconst EndpointPath = styled.span`\n  color: var(--accent);\n  min-width: 7.5rem;\n`;\n\nconst EndpointPurpose = styled.span`\n  font-family: ${SERIF};\n  color: var(--dim);\n`;\n\nconst Dot = styled.span<{ $color: string }>`\n  width: 8px; height: 8px;\n  border-radius: 50%;\n  background: ${({ $color }) => $color};\n  opacity: 0.75;\n  flex-shrink: 0;\n  display: inline-block;\n`;\n\n// ── Primitives interactive ───────────────────────────────────────────────────\n\nconst PrimitiveGrid = styled.div`\n  display: grid;\n  grid-template-columns: repeat(4, 1fr);\n  gap: 0.7rem;\n  margin-bottom: 1.25rem;\n  @media (max-width: 560px) { grid-template-columns: repeat(2, 1fr); }\n`;\n\nconst PrimitiveBtn = styled.button<{ $active: boolean; $color: string }>`\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  gap: 0.55rem;\n  padding: 1.1rem 0.75rem;\n  background: ${({ $active }) => ($active ? \"var(--surface)\" : \"transparent\")};\n  border: 1px solid ${({ $active, $color }) => ($active ? $color + \"55\" : \"transparent\")};\n  border-radius: 8px;\n  cursor: pointer;\n  font-family: inherit;\n  transition: all 0.2s;\n  &:hover { background: var(--surface); }\n`;\n\nconst PrimitiveLabel = styled.span<{ $active: boolean; $color: string }>`\n  font-family: ${MONO};\n  font-size: 0.72rem;\n  color: ${({ $active, $color }) => ($active ? $color : \"var(--dim)\")};\n  transition: color 0.2s;\n`;\n\nconst PrimitiveDetail = styled.div<{ $active: boolean }>`\n  min-height: 4rem;\n  padding: 1rem 1.15rem;\n  border-radius: 6px;\n  margin-bottom: 1.5rem;\n  font-family: ${SERIF};\n  font-size: 0.88rem;\n  line-height: 1.75;\n  color: var(--dim);\n  background: ${({ $active }) => ($active ? \"var(--surface)\" : \"transparent\")};\n  transition: background 0.2s;\n`;\n\nconst PrimitiveName = styled.span<{ $color: string }>`\n  color: ${({ $color }) => $color};\n  font-weight: 600;\n`;\n\n// ── Convergence ──────────────────────────────────────────────────────────────\n\nconst ProjectCard = styled(Card)`\n  display: flex;\n  gap: 1.15rem;\n  padding: 1.2rem 1.35rem;\n`;\n\nconst ProjectName = styled.span<{ $color: string }>`\n  font-family: ${MONO};\n  font-size: 1.05rem;\n  font-weight: 700;\n  color: ${({ $color }) => $color};\n`;\n\nconst ProjectTagline = styled.div`\n  font-family: ${SERIF};\n  font-size: 0.92rem;\n  font-weight: 600;\n  margin-bottom: 0.2rem;\n`;\n\nconst LayerRow = styled.div<{ $color: string }>`\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0.7rem 1.15rem;\n  background: var(--surface);\n  border-radius: 5px;\n  margin-bottom: 0.25rem;\n  &:last-child { margin-bottom: 0; }\n`;\n\nconst LayerName = styled.span<{ $color: string }>`\n  font-family: ${SERIF};\n  font-weight: 600;\n  font-size: 0.92rem;\n  color: ${({ $color }) => $color};\n`;\n\nconst LayerSub = styled.span`\n  font-family: ${SERIF};\n  font-size: 0.8rem;\n  color: var(--dim);\n`;\n\n// ── Salience ─────────────────────────────────────────────────────────────────\n\nconst DomainRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.75rem;\n  padding: 0.6rem 0.85rem;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n`;\n\nconst DomainName = styled.div`\n  font-family: ${SERIF};\n  font-size: 0.88rem;\n  font-weight: 600;\n`;\n\nconst DomainFocus = styled.div`\n  font-family: ${SERIF};\n  font-size: 0.75rem;\n  color: var(--dim);\n`;\n\nconst StackCard = styled(Card)`\n  padding: 1.25rem 1.5rem;\n`;\n\nconst StackContent = styled.div`\n  font-family: ${SERIF};\n  font-size: 0.85rem;\n  color: var(--dim);\n  line-height: 1.85;\n`;\n\n// ── SVG Glyphs ───────────────────────────────────────────────────────────────\n\nfunction Glyph({ type, color }: { type: string; color: string }) {\n  const s = 34;\n  const h = s / 2;\n  const st = { width: s, height: s, flexShrink: 0 } as any;\n\n  if (type === \"state\") return (\n    \n  );\n  if (type === \"action\") return (\n    \n  );\n  if (type === \"view\") return (\n    \n  );\n  if (type === \"agent\") return (\n    \n  );\n  return null;\n}\n\n// ── Section: Thesis ──────────────────────────────────────────────────────────\n\nfunction ThesisSection() {\n  return (\n    \n      \n        Every multi-agent coordination framework starts from the same assumption:\n        agents need to talk to each other. Sync starts from a different premise.\n      \n\n      \n        Agents don't need to talk to each other.
They can share reality.\n      \n\n      \n        {[\n          { label: \"Traditional\", accent: false, items: [\"Message passing\", \"Orchestration layers\", \"Rigid schemas\", \"Predefined workflows\"] },\n          { label: \"Substrate\", accent: true, items: [\"Stigmergic traces\", \"Self-activation\", \"Open-world state\", \"Emergent coordination\"] },\n        ].map(col => (\n          \n            {col.label}\n            {col.items.map(item => (\n              {item}\n            ))}\n          \n        ))}\n      \n\n      \n        The insight comes from an old lineage: Nii's blackboard architectures (1986), Selfridge's\n        Pandemonium (1959), Linda tuple spaces. But those systems required rigid schemas and\n        deterministic programs. Language models change the condition — they tolerate open worlds, interpret\n        partially structured environments, and act meaningfully within them. Stigmergy becomes computationally viable.\n      \n\n      \n        The system behaves less like software and more like an ecosystem.\n        A reef rather than a workflow.\n      \n\n      \n        Read the full argument: The Substrate Thesis · What Becomes True · Introducing Sync\n      \n    
\n  );\n}\n\n// ── Section: Algebra ─────────────────────────────────────────────────────────\n\nfunction AlgebraSection() {\n  const ops = [\n    { name: \"read context\", endpoint: \"GET /context\", desc: \"Returns everything: state, views, agents, actions with schemas, messages. The world as perceived.\", color: \"var(--green)\" },\n    { name: \"invoke action\", endpoint: \"POST /actions/:id/invoke\", desc: \"The only write path. Built-in and custom. Every invocation logged to _audit.\", color: \"var(--red)\" },\n  ];\n\n  const endpoints = [\n    { path: \"POST /rooms\", purpose: \"Create room\" },\n    { path: \"POST /agents\", purpose: \"Join room\" },\n    { path: \"GET /context\", purpose: \"Read everything\" },\n    { path: \"POST /invoke\", purpose: \"Write anything\" },\n    { path: \"GET /wait\", purpose: \"Block until condition\" },\n    { path: \"POST /eval\", purpose: \"Evaluate CEL\" },\n    { path: \"GET /rooms\", purpose: \"List rooms\" },\n    { path: \"GET /agents\", purpose: \"List agents\" },\n    { path: \"GET /docs/*\", purpose: \"Dynamic docs\" },\n    { path: \"GET /\", purpose: \"Dashboard\" },\n  ];\n\n  return (\n    \n      \n        Every multi-agent system, regardless of domain, reduces to two operations.\n        Everything else is wiring.\n      \n\n      \n        {ops.map(op => (\n          \n            \n            {op.endpoint}\n            {op.name}\n            {op.desc}\n          \n        ))}\n      \n\n      10 Total Endpoints\n      \n        {endpoints.map(ep => (\n          \n            {ep.path}\n            {ep.purpose}\n          \n        ))}\n      \n\n      \n        The kernel reduction (reference/kernel.ts) expresses\n        this full algebra in ~300 lines of pure TypeScript. No dependencies. The proof that the surface area\n        is genuinely minimal. See Architecture docs · Σ-calculus\n      \n    
\n  );\n}\n\n// ── Section: Room ────────────────────────────────────────────────────────────\n\nfunction RoomSection() {\n  const [active, setActive] = useState(null);\n\n  const primitives = [\n    { id: \"state\", icon: \"state\", name: \"State\", color: \"var(--green)\",\n      desc: \"Scoped key-value entries. _shared is public; agent scopes are private. Absence is signal — a key that doesn't exist yet is not an error, it's information. State grows by accretion.\" },\n    { id: \"actions\", icon: \"action\", name: \"Actions\", color: \"var(--red)\",\n      desc: \"Delegated write capabilities. Registered by Alice, scoped to Alice, invokable by Bob — Bob's invocation writes to Alice's scope using Alice's authority. Capability delegation without an auth framework.\" },\n    { id: \"views\", icon: \"view\", name: \"Views\", color: \"var(--yellow)\",\n      desc: \"Declarative CEL expressions projecting private state into public meaning. Registered dynamically, scoped to registrar's authority, evaluated lazily at read time. Interpretation as a composable runtime layer.\" },\n    { id: \"agents\", icon: \"agent\", name: \"Agents\", color: \"var(--accent)\",\n      desc: \"Humans and AI are equivalent participants, distinguished not by kind but by observation modality. MCP clients are first-class agents with embodiment identity.\" },\n  ];\n\n  const activePrim = primitives.find(p => p.id === active);\n\n  return (\n    \n      \n        A room is the fundamental unit. Shared state observed by self-activating participants.\n        No controller. No router. The room's structure is the protocol.\n      \n\n      \n        \n          Room Primitives — {active ? \"tap to deselect\" : \"tap to explore\"}\n        \n\n        \n          {primitives.map(p => (\n             setActive(active === p.id ? null : p.id)}>\n              \n              {p.name}\n            \n          ))}\n        \n\n        \n          {activePrim\n            ? <>{activePrim.name} — {activePrim.desc}\n            : Select a primitive to see how it works\n          }\n        \n      \n\n      \n        {[\n          { scope: \"_shared\", desc: \"Public truth. Visible to all.\", color: \"var(--green)\" },\n          { scope: \"alice\", desc: \"Alice's private scope.\", color: \"var(--accent)\" },\n          { scope: \"_audit\", desc: \"Every invocation. Immutable.\", color: \"var(--dim)\" },\n        ].map(s => (\n          \n            {s.scope}\n            {s.desc}\n          \n        ))}\n      \n\n      \n        CEL (Common Expression Language) is the universal evaluation layer. Enabled expressions,\n        wait conditions, view projections, action preconditions — all CEL. One expression language\n        for the entire system.\n      \n\n      \n        {\"// view: project meaning from raw state\"}
\n        status = state.alice.health {\"<\"} 20 ? \"critical\" : \"stable\"
\n        {\"// action: enabled only when relevant\"}
\n        enabled = state._shared.phase == \"combat\" && state.alice.health {\">\"} 0\n      \n\n      \n        See CEL reference · API reference · Views reference · Surfaces design principles\n      \n    
\n  );\n}\n\n// ── Section: Convergence ─────────────────────────────────────────────────────\n\nfunction ConvergenceSection() {\n  const projects = [\n    { name: \"ctxl\", tagline: \"Intelligence inside a component\", color: \"var(--red)\",\n      desc: \"The interface remains alive to reasoning. Components don't use intelligence — they are intelligent. useReasoning hooks, self-modifying React.\" },\n    { name: \"sync\", tagline: \"Intelligence across shared state\", color: \"var(--accent)\",\n      desc: \"Shared state is the execution environment. Agents observe and modify a common substrate. The reef emerges from local rules.\" },\n    { name: \"playtest\", tagline: \"Experience emerging from observers\", color: \"var(--yellow)\",\n      desc: \"Game mechanics as bounded engines. Organs resolving constraints, emitting stable facts back into shared reality. 192 BGG-sourced mechanics formalized.\" },\n  ];\n\n  const layers = [\n    { layer: \"Participants\", sub: \"Humans / Agents / MCP Clients\", color: \"var(--accent)\" },\n    { layer: \"Surfaces\", sub: \"Declarative observers, self-activating\", color: \"var(--yellow)\" },\n    { layer: \"Derived Meaning\", sub: \"Views, CEL projections, interpretation\", color: \"var(--purple)\" },\n    { layer: \"State\", sub: \"Scoped key-value substrate\", color: \"var(--green)\" },\n    { layer: \"Organs\", sub: \"Localized state machines (Playtest)\", color: \"var(--red)\" },\n  ];\n\n  return (\n    \n      \n        Three projects. One architecture. The convergence became clear: they all describe the same\n        structure at different scales.\n      \n\n      \n        {projects.map(p => (\n          \n            \n            \n              {p.name}\n            
\n            \n              {p.tagline}\n              {p.desc}\n            
\n          \n        ))}\n      
\n\n      \n        Unified Architecture\n        {layers.map(l => (\n          \n            {l.layer}\n            {l.sub}\n          \n        ))}\n      \n\n      \n        When these conditions hold: new surfaces can be added without modifying existing ones, new actions\n        introduce new realities without rewrites, agents and humans collaborate without coordination logic.\n        Design shifts from scripting behavior to shaping conditions under which behavior can arise.\n      \n\n      \n        Read the essays: What Becomes True · The Substrate Thesis · Isn't This Just ReAct?\n      \n    
\n  );\n}\n\n// ── Section: Salience ────────────────────────────────────────────────────────\n\nfunction SalienceSection() {\n  const domains = [\n    { name: \"Auftragstaktik\", focus: \"Intent-based delegation\", color: \"var(--red)\" },\n    { name: \"Bjork/Vygotsky\", focus: \"Scaffolded challenge\", color: \"var(--yellow)\" },\n    { name: \"Lakatos/Popper\", focus: \"Falsifiable design\", color: \"var(--purple)\" },\n    { name: \"Gibson\", focus: \"Affordance perception\", color: \"var(--green)\" },\n    { name: \"Dorigo\", focus: \"Swarm intelligence\", color: \"var(--accent)\" },\n    { name: \"Argyris\", focus: \"Double-loop learning\", color: \"var(--red)\" },\n    { name: \"RWML/RAGEN\", focus: \"RL world models\", color: \"var(--yellow)\" },\n  ];\n\n  return (\n    \n      \n        The deepest theoretical move: sync rooms are structurally isomorphic to RL world models.\n        Adaptive salience fills the missing reward signal role.\n      \n\n      \n        \n          The gap identified as most important: aggregating signals across the vocabulary\n          into a room-level assessment — not just surfacing individual problems, but synthesizing\n          a coherent field of relevance that guides agent attention.\n        \n        \n          room state → observation │ action invocation → policy │ salience → reward signal\n        \n      \n\n      Seven Grounding Domains\n\n      \n        {domains.map(d => (\n          \n            \n            \n              {d.name}\n              {d.focus}\n            
\n          \n        ))}\n      \n\n      \n        The demo infrastructure tests this with a stigmergic ant colony scenario — genuinely\n        independent subagents (narrator, scout, analyst, architect) coordinating through\n        environmental traces, not messages. Each agent's action modifies the perceptual\n        environment for others. Understanding accumulates socially.\n      \n\n      \n        Implementation Stack\n        \n          TypeScript/Deno on Val.town ·{\" \"}\n          SQLite persistence ·{\" \"}\n          CEL expressions ·{\" \"}\n          MCP native protocol ·{\" \"}\n          SSR React dashboard
\n          Codebase decomposed from monolith to 10+ domain modules. 51 tests.
\n          Single domain: sync.parc.land\n        \n      \n\n      \n        Read more: The Pressure Field · Examples · Help reference\n      \n    
\n  );\n}\n\n// ── Section registry ─────────────────────────────────────────────────────────\n\nconst SECTION_COMPONENTS: Record JSX.Element> = {\n  thesis: ThesisSection,\n  algebra: AlgebraSection,\n  room: RoomSection,\n  convergence: ConvergenceSection,\n  salience: SalienceSection,\n};\n\n// ── Main export ──────────────────────────────────────────────────────────────\n\nexport function Overview() {\n  const [activeSection, setActiveSection] = useState(\"thesis\");\n  const ActiveComponent = SECTION_COMPONENTS[activeSection] ?? ThesisSection;\n  const sec = SECTIONS.find(s => s.id === activeSection)!;\n\n  return (\n    \n      \n      \n        /sync / overview\n        Vision & Architecture\n        A room-based multi-agent coordination substrate\n      
\n      \n        \n          {SECTIONS.map(s => (\n             setActiveSection(s.id)}>\n              {s.label}\n              {s.subtitle}\n            \n          ))}\n        \n        \n          {sec.title}\n          {sec.subtitle}\n          \n        
\n      \n      \n        sync · @christopherdebeer · Edinburgh\n      
\n    \n  );\n}\n",[],[418,1221,1231],"b74f3dc6-1efc-11f1-9910-42dde27851f2","Nav.tsx","2cb67f24-195e-11f1-999b-42dde27851f2",609,["D",1773420618104],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Shared navigation header — appears on all pages except OAuth authorize. */\nimport { useCallback, useEffect, useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { Logo } from \"./Logo.tsx\";\n\nconst Bar = styled.nav`\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0.6rem 1.5rem;\n  border-bottom: 1px solid var(--border);\n  background: var(--bg);\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  font-size: 0.85rem;\n  position: sticky;\n  top: 0;\n  z-index: 50;\n  @media (max-width: 480px) {\n    padding: 0.5rem 1rem;\n    font-size: 0.8rem;\n  }\n`;\n\nconst Left = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 1.25rem;\n`;\n\nconst LogoLink = styled.a`\n  font-weight: 700;\n  font-size: 1rem;\n  color: var(--fg);\n  text-decoration: none;\n  letter-spacing: -0.03em;\n  display: flex;\n  align-items: center;\n  gap: 0.4rem;\n  &:hover { text-decoration: none; }\n`;\n\nconst NavLinks = styled.div`\n  display: flex;\n  gap: 0.9rem;\n  @media (max-width: 480px) {\n    gap: 0.6rem;\n  }\n`;\n\nconst NavLink = styled.a<{ $active?: boolean }>`\n  color: ${({ $active }) => ($active ? \"var(--accent)\" : \"var(--dim)\")};\n  text-decoration: none;\n  font-weight: ${({ $active }) => ($active ? \"600\" : \"400\")};\n  transition: color 0.15s;\n  &:hover {\n    color: var(--fg);\n    text-decoration: none;\n  }\n`;\n\nconst Right = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n`;\n\nconst ThemeToggle = styled.div`\n  display: flex;\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  overflow: hidden;\n`;\n\nconst ThemeOption = styled.button<{ $active: boolean }>`\n  background: ${({ $active }) => ($active ? \"var(--surface2)\" : \"transparent\")};\n  border: none;\n  color: ${({ $active }) => ($active ? \"var(--fg)\" : \"var(--dim)\")};\n  cursor: pointer;\n  padding: 0.2rem 0.45rem;\n  font-size: 0.75rem;\n  line-height: 1;\n  transition: all 0.15s;\n  &:hover {\n    color: var(--fg);\n  }\n  & + & {\n    border-left: 1px solid var(--border);\n  }\n`;\n\ntype Theme = \"system\" | \"light\" | \"dark\";\n\nexport interface NavProps {\n  active?: \"home\" | \"docs\" | \"manage\" | \"dashboard\" | \"overview\";\n}\n\nexport function Nav({ active }: NavProps) {\n  const [theme, setTheme] = useState(\"system\");\n\n  useEffect(() => {\n    const stored = localStorage.getItem(\"sync-theme\");\n    if (stored === \"light\" || stored === \"dark\") setTheme(stored);\n  }, []);\n\n  const pick = useCallback((t: Theme) => {\n    setTheme(t);\n    if (t === \"system\") {\n      localStorage.removeItem(\"sync-theme\");\n      document.documentElement.removeAttribute(\"data-theme\");\n    } else {\n      localStorage.setItem(\"sync-theme\", t);\n      document.documentElement.setAttribute(\"data-theme\", t);\n    }\n  }, []);\n\n  return (\n    \n      \n        \n          \n        \n        \n          /sync\n          Overview\n          Docs\n          Manage\n        \n      \n      \n        \n           pick(\"light\")} title=\"Light\">{\"\\u2600\"}\n           pick(\"system\")} title=\"System\">{\"\\u25D0\"}\n           pick(\"dark\")} title=\"Dark\">{\"\\u263E\"}\n        \n      \n    \n  );\n}\n",[],[418,1221,1239],"2ca5c63e-195e-11f1-9f66-42dde27851f2","Logo.tsx","2ca5c724-195e-11f1-9f66-42dde27851f2",250,["D",1772802769102],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** Inline SVG logo — uses document CSS variables so it responds to the theme toggle,\n *  not just system prefers-color-scheme. The  in the HTML head still\n *  uses the static favicon.svg which correctly follows system preference for the browser tab. */\n\nexport function Logo({ size = \"1.4rem\" }: { size?: string }) {\n  return (\n    \n      \n      \n      \n      \n      \n      \n      \n      \n      \n      \n      \n    \n  );\n}\n",[],[418,1221,1247],"a7cb8c60-1ec0-11f1-a151-42dde27851f2","Landing.tsx","7833f4d0-13fb-11f1-b99c-42dde27851f2",577,["D",1773394822269],33,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useEffect, useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { runMermaid } from \"../mermaid.ts\";\nimport { Nav } from \"./Nav.tsx\";\nimport { Logo } from \"./Logo.tsx\";\nimport { ReplayWidget } from \"./Replay.tsx\";\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\nexport interface DemoEntry {\n  id: string;\n  label: string;\n  room: string;\n  token: string;\n  description?: string;\n}\n\nexport interface LandingData {\n  version: string;\n  tagline: string;\n  intro: string;\n  demo_room: string;\n  demo_token: string;\n  demos: DemoEntry[];\n  /** Pre-rendered HTML body (server-side via npm:marked) */\n  bodyHtml: string;\n  /** Pre-rendered HTML for each getting_started tab */\n  tabHtml: Record;\n  /** Raw tab keys present (for tab bar rendering) */\n  tabKeys: string[];\n  prompts: { label: string; text: string }[];\n}\n\nexport const DEFAULT_DATA: LandingData = {\n  version: \"v6\",\n  tagline: \"Shared rooms where AI agents coordinate through state, not messages\",\n  intro: \"sync is a coordination substrate for multi-agent systems.\",\n  demo_room: \"\",\n  demo_token: \"\",\n  demos: [],\n  bodyHtml: \"\",\n  tabHtml: {},\n  tabKeys: [],\n  prompts: [],\n};\n\nconst SKILL_URL = \"https://sync.parc.land/SKILL.md\";\n\n/**\n * Parse landing.md → LandingData.\n * Pass a `renderMd` function to produce HTML. Safe to call server-side.\n *\n * IMPORTANT: Fenced-block regexes anchor the closing ``` to start-of-line\n * (\\n```) so that backticks embedded inside JSON string values (e.g. the\n * curl tab's ```bash code block) don't short-circuit the match.\n */\nexport function parseLandingMd(raw: string, renderMd: (md: string) => string): LandingData {\n  const data = { ...DEFAULT_DATA };\n\n  // Frontmatter\n  const fmMatch = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/);\n  if (fmMatch) {\n    for (const line of fmMatch[1].split(\"\\n\")) {\n      const colon = line.indexOf(\":\");\n      if (colon < 1) continue;\n      const key = line.slice(0, colon).trim();\n      const val = line.slice(colon + 1).trim();\n      if (key === \"version\") data.version = val;\n      else if (key === \"tagline\") data.tagline = val;\n      else if (key === \"intro\") data.intro = val;\n      else if (key === \"demo_room\") data.demo_room = val;\n      else if (key === \"demo_token\") data.demo_token = val;\n    }\n  }\n\n  // ```getting_started JSON block\n  // Closing fence must be at start of line to avoid matching backticks inside JSON strings\n  const gsMatch = raw.match(/```getting_started\\r?\\n([\\s\\S]*?)\\n```/);\n  let gettingStarted: Record = {};\n  if (gsMatch) {\n    try {\n      const parsed = JSON.parse(gsMatch[1].trim());\n      if (typeof parsed === \"object\" && parsed !== null) gettingStarted = parsed;\n    } catch {}\n  }\n\n  // ```prompts JSON block\n  const promptsMatch = raw.match(/```prompts\\r?\\n([\\s\\S]*?)\\n```/);\n  if (promptsMatch) {\n    try {\n      const raw_prompts = JSON.parse(promptsMatch[1].trim());\n      if (Array.isArray(raw_prompts)) {\n        data.prompts = raw_prompts.map((p: any) => ({\n          label: p.label,\n          text: (p.text as string).replace(/\\{SKILL_URL\\}/g, SKILL_URL),\n        }));\n      }\n    } catch {}\n  }\n\n  // ```demos JSON block — array of { id, label, room, token, description? }\n  const demosMatch = raw.match(/```demos\\r?\\n([\\s\\S]*?)\\n```/);\n  if (demosMatch) {\n    try {\n      const raw_demos = JSON.parse(demosMatch[1].trim());\n      if (Array.isArray(raw_demos)) {\n        data.demos = raw_demos.filter((d: any) => d.room && d.token).map((d: any) => ({\n          id: d.id || d.room,\n          label: d.label || d.room,\n          room: d.room,\n          token: d.token,\n          description: d.description,\n        }));\n      }\n    } catch {}\n  }\n\n  // Backward compat: if no demos block but demo_room/demo_token exist, synthesize single entry\n  if (data.demos.length === 0 && data.demo_room && data.demo_token) {\n    data.demos = [{ id: data.demo_room, label: data.demo_room, room: data.demo_room, token: data.demo_token }];\n  }\n\n  // Body markdown — strip frontmatter + fenced blocks, render\n  let body = raw;\n  body = body.replace(/^---\\r?\\n[\\s\\S]*?\\r?\\n---\\r?\\n/, \"\");\n  body = body.replace(/```getting_started\\r?\\n[\\s\\S]*?\\n```\\r?\\n?/g, \"\");\n  body = body.replace(/```prompts\\r?\\n[\\s\\S]*?\\n```\\r?\\n?/g, \"\");\n  body = body.replace(/```demos\\r?\\n[\\s\\S]*?\\n```\\r?\\n?/g, \"\");\n  body = body.trim();\n  data.bodyHtml = body ? renderMd(body) : \"\";\n\n  // Render tab content\n  const TAB_KEYS = [\"mcp\", \"claude_code\", \"curl\"];\n  data.tabKeys = TAB_KEYS.filter(k => gettingStarted[k]);\n  data.tabHtml = {};\n  for (const k of data.tabKeys) {\n    data.tabHtml[k] = renderMd(gettingStarted[k]);\n  }\n\n  return data;\n}\n\n// ── Styles ────────────────────────────────────────────────────────────────────\n\nconst Page = styled.div`\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  background: var(--bg);\n  color: var(--fg);\n  line-height: 1.6;\n  min-height: 100vh;\n  display: flex;\n  flex-direction: column;\n  a { color: var(--accent); text-decoration: none; }\n  a:hover { text-decoration: underline; }\n`;\n\nconst Container = styled.div`\n  max-width: 680px;\n  margin: 0 auto;\n  padding: 3.5rem 1.5rem 2rem;\n  flex: 1;\n  @media (max-width: 480px) { padding: 2rem 1rem 1.5rem; }\n`;\n\nconst Lockup = styled.div`\n  display: flex;\n  gap: 2em;\n  align-items: center;\n  margin-bottom: 2em;\n`;\n\nconst H1 = styled.h1`\n  font-size: 2.2rem;\n  font-weight: 700;\n  letter-spacing: -0.03em;\n  margin-bottom: 0.35rem;\n  @media (max-width: 480px) { font-size: 1.75rem; }\n`;\n\nconst Tagline = styled.p`\n  color: var(--dim);\n  font-size: 1.15rem;\n  line-height: 1.5;\n  max-width: 75%;\n  @media (max-width: 480px) { font-size: 1.05rem; max-width: 100%; }\n`;\n\nconst Intro = styled.p`\n  font-size: 1.02rem;\n  margin-bottom: 2.5rem;\n  color: var(--fg);\n  line-height: 1.7;\n  @media (max-width: 480px) { font-size: 0.95rem; margin-bottom: 2rem; }\n`;\n\nconst Section = styled.section`\n  margin-bottom: 2.5rem;\n  @media (max-width: 480px) { margin-bottom: 2rem; }\n`;\n\nconst H2 = styled.h2`\n  font-size: 1.15rem;\n  font-weight: 600;\n  letter-spacing: -0.01em;\n  margin-bottom: 0.75rem;\n`;\n\nconst SectionIntro = styled.p`\n  color: var(--dim);\n  font-size: 0.95rem;\n  margin-bottom: 1rem;\n  line-height: 1.55;\n`;\n\nconst Prose = styled.div`\n  line-height: 1.7;\n  font-size: 0.95rem;\n  color: var(--fg);\n  margin-bottom: 2.5rem;\n  h2 { font-size: 1.15rem; font-weight: 600; letter-spacing: -0.01em; margin: 2rem 0 0.75rem; }\n  h3 { font-size: 1rem; font-weight: 600; margin: 1.25rem 0 0.4rem; }\n  p { margin: 0.5rem 0 0.9rem; }\n  a { color: var(--accent); text-decoration: none; }\n  a:hover { text-decoration: underline; }\n  strong { color: var(--fg); font-weight: 600; }\n  ul, ol { margin: 0.5rem 0 0.9rem; padding-left: 1.5rem; }\n  li { margin: 0.3rem 0; }\n  pre {\n    background: var(--surface); border: 1px solid var(--border); border-radius: 8px;\n    padding: 1rem 1.25rem; overflow-x: auto; font-size: 0.82rem;\n    margin: 0.75rem 0 1.25rem; line-height: 1.55;\n    code { background: none; border: none; padding: 0; color: var(--fg); font-size: inherit; }\n  }\n  code {\n    background: var(--surface); border: 1px solid var(--border);\n    padding: 0.15em 0.4em; border-radius: 4px; font-size: 0.88em; color: var(--accent);\n  }\n  hr { border: none; border-top: 1px solid var(--border); margin: 2rem 0; }\n  .mermaid { margin: 1.25rem 0; text-align: center; overflow-x: auto; svg { max-width: 100%; height: auto; } }\n  @media (max-width: 480px) { font-size: 0.9rem; pre { padding: 0.75rem 0.9rem; font-size: 0.75rem; } }\n`;\n\nconst ReplayPlaceholder = styled.div`\n  background: var(--surface); border: 1px solid var(--border); border-radius: 8px;\n  height: 340px; display: flex; flex-direction: column; align-items: center;\n  justify-content: center; gap: 0.5rem; color: var(--dim); font-size: 0.88rem;\n`;\n\nconst ReplayLabel = styled.div`\n  font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.08em;\n  color: var(--dim); opacity: 0.5;\n`;\n\nconst DemoSelector = styled.div`\n  display: flex;\n  gap: 0.35rem;\n  margin-bottom: 0.65rem;\n  flex-wrap: wrap;\n`;\n\nconst DemoPill = styled.button<{ $active: boolean }>`\n  background: ${p => p.$active ? \"rgba(88,166,255,0.12)\" : \"transparent\"};\n  border: 1px solid ${p => p.$active ? \"var(--accent)\" : \"var(--border)\"};\n  border-radius: 100px;\n  padding: 0.3rem 0.75rem;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 0.78rem;\n  font-weight: ${p => p.$active ? \"600\" : \"400\"};\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  transition: all 0.15s;\n  white-space: nowrap;\n  line-height: 1.3;\n  &:hover { color: var(--fg); border-color: var(--dim); }\n  @media (max-width: 480px) { padding: 0.25rem 0.6rem; font-size: 0.72rem; }\n`;\n\nconst TabBar = styled.div`\n  display: flex; border-bottom: 1px solid var(--border);\n`;\n\nconst Tab = styled.button<{ $active: boolean }>`\n  background: ${p => p.$active ? \"var(--surface)\" : \"transparent\"};\n  border: 1px solid ${p => p.$active ? \"var(--border)\" : \"transparent\"};\n  border-bottom: ${p => p.$active ? \"1px solid var(--surface)\" : \"1px solid var(--border)\"};\n  border-radius: 6px 6px 0 0;\n  padding: 0.5rem 1rem; cursor: pointer; font-family: inherit; font-size: 0.85rem;\n  font-weight: ${p => p.$active ? \"600\" : \"400\"};\n  color: ${p => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  transition: color 0.15s; margin-bottom: -1px;\n  &:hover { color: var(--fg); }\n  @media (max-width: 480px) { padding: 0.45rem 0.7rem; font-size: 0.8rem; }\n`;\n\nconst TabProse = styled.div`\n  background: var(--surface); border: 1px solid var(--border); border-top: none;\n  border-radius: 0 0 8px 8px; padding: 1.25rem 1.4rem; font-size: 0.9rem;\n  line-height: 1.65; color: var(--fg);\n  h3 { font-size: 0.95rem; font-weight: 600; margin: 0 0 0.65rem; letter-spacing: -0.01em; }\n  p { margin: 0 0 0.75rem; color: var(--dim); }\n  a { color: var(--accent); } a:hover { text-decoration: underline; }\n  pre {\n    background: var(--bg); border: 1px solid var(--border); border-radius: 6px;\n    padding: 0.85rem 1rem; overflow-x: auto;\n    font-family: \"SF Mono\", \"Cascadia Code\", \"Fira Code\", monospace;\n    font-size: 0.8rem; line-height: 1.6; margin: 0.5rem 0 0.75rem;\n    code { background: none; border: none; padding: 0; font-size: inherit; color: var(--fg); }\n  }\n  code {\n    background: var(--bg); border: 1px solid var(--border); padding: 0.1em 0.35em;\n    border-radius: 3px; font-family: \"SF Mono\", \"Cascadia Code\", \"Fira Code\", monospace;\n    font-size: 0.85em; color: var(--accent);\n  }\n  @media (max-width: 480px) { padding: 1rem; font-size: 0.85rem; pre { font-size: 0.75rem; } }\n`;\n\nconst ApiTable = styled.table`\n  width: 100%; border-collapse: collapse;\n  font-family: \"SF Mono\", \"Cascadia Code\", \"Fira Code\", monospace; font-size: 0.82rem;\n  background: var(--surface); border: 1px solid var(--border); border-radius: 8px; overflow: hidden;\n  tr { border-bottom: 1px solid var(--border); &:last-child { border-bottom: none; } }\n  td { padding: 0.55rem 0.9rem; vertical-align: top; }\n  @media (max-width: 480px) { font-size: 0.75rem; td { padding: 0.45rem 0.65rem; } }\n`;\nconst ApiMethod = styled.td`color: var(--accent); white-space: nowrap; font-weight: 600; width: 3.5rem;`;\nconst ApiPath = styled.td`color: var(--fg); white-space: nowrap; @media (max-width: 480px) { white-space: normal; word-break: break-all; }`;\nconst ApiDesc = styled.td`color: var(--dim);`;\n\nconst RefGrid = styled.div`\n  display: grid; grid-template-columns: 1fr 1fr; gap: 2rem; margin-bottom: 2.5rem;\n  @media (max-width: 560px) { grid-template-columns: 1fr; gap: 1.5rem; }\n`;\nconst RefCol = styled.div``;\nconst RefList = styled.ul`list-style: none; margin: 0; padding: 0;`;\nconst RefItem = styled.li`\n  margin-bottom: 0.75rem;\n  a { color: var(--accent); font-size: 0.9rem; font-weight: 500; text-decoration: none; &:hover { text-decoration: underline; } }\n`;\nconst RefItemDesc = styled.div`font-size: 0.82rem; color: var(--dim); line-height: 1.4; margin-top: 0.1rem;`;\n\nconst Footer = styled.footer`\n  text-align: center; padding: 2rem; color: var(--dim); font-size: 0.8rem;\n  border-top: 1px solid var(--border);\n`;\n\n// ── Tab labels ────────────────────────────────────────────────────────────────\n\nconst TAB_LABELS: Record = { mcp: \"MCP\", claude_code: \"Claude Code\", curl: \"curl / REST\" };\n\n// ── Component ─────────────────────────────────────────────────────────────────\n\ninterface LandingProps {\n  data?: LandingData;\n}\n\nexport function Landing({ data = DEFAULT_DATA }: LandingProps) {\n  const [activeTab, setActiveTab] = useState(data.tabKeys[0] ?? \"mcp\");\n  const [activeDemo, setActiveDemo] = useState(0);\n\n  const demos = data.demos;\n  const currentDemo = demos[activeDemo] ?? null;\n\n  // Run mermaid once on mount if bodyHtml has mermaid blocks\n  useEffect(() => {\n    if (data.bodyHtml?.includes('class=\"mermaid\"')) runMermaid();\n  }, []);\n\n  return (\n    \n      \n      \n\n        {/* 1. Hero */}\n        \n          \n          \n            /sync
\n            {data.tagline}\n          
\n        \n        {data.intro}\n\n        {/* 2. How it works */}\n        {data.bodyHtml && (\n          \n        )}\n\n        {/* 3. Replay widget */}\n        \n          See it in action
\n          A recorded run of a real room, replayed live from the audit log.\n          {demos.length > 1 && (\n            \n              {demos.map((d, i) => (\n                 setActiveDemo(i)}>\n                  {d.label}\n                \n              ))}\n            \n          )}\n          {currentDemo\n            ? \n            : \n                replay widget\n                configure demos in landing.md\n              \n          }\n        
\n\n        {/* 4. Getting started */}\n        {data.tabKeys.length > 0 && (\n          \n            Getting started
\n            \n              {data.tabKeys.map(k => (\n                 setActiveTab(k)}>\n                  {TAB_LABELS[k] ?? k}\n                \n              ))}\n            \n            \n          
\n        )}\n\n        {/* 5. API surface */}\n        \n          API surface
\n          Five endpoints. One write path. Every invocation audited.\n          \n            {([\n              [\"POST\", \"/rooms\", \"create a room\"],\n              [\"POST\", \"/rooms/:id/agents\", \"join as an agent\"],\n              [\"GET\",  \"/rooms/:id/context\", \"read everything\"],\n              [\"POST\", \"/rooms/:id/actions/:id/invoke\", \"invoke an action\"],\n              [\"GET\",  \"/rooms/:id/wait?condition=\", \"block until a CEL condition is true\"],\n            ] as [string,string,string][]).map(([m,p,d]) => (\n              {m}{p}{d}\n            ))}\n          \n        
\n\n        {/* 6. Reference + Writing */}\n        \n          \n            Reference
\n            \n              {([\n                [\"SKILL.md\", \"SKILL.md\", \"Full API skill — readable by agents and humans\"],\n                [\"api.md\", \"API reference\", \"Endpoints, request/response shapes\"],\n                [\"cel.md\", \"CEL reference\", \"Expression language and context\"],\n                [\"views.md\", \"Views reference\", \"Render hints, surface types, dashboard\"],\n                [\"examples.md\", \"Examples\", \"Task queues, games, grants, views\"],\n                [\"v6.md\", \"Architecture\", \"The thesis, axioms, and why v6 works this way\"],\n                [\"help.md\", \"Help reference\", \"Standard library, proof-of-read versioning\"],\n              ] as [string,string,string][]).map(([doc,label,desc]) => (\n                \n                  {label}\n                  {desc}\n                \n              ))}\n            \n          \n          \n            Writing
\n            \n              {([\n                [\"what-becomes-true.md\", \"What Becomes True\", \"Tools → games → substrate → v6. Start here.\"],\n                [\"introducing-sync.md\", \"Introducing Sync\", \"Games, five decades of research, and the architecture they converge on\"],\n                [\"the-substrate-thesis.md\", \"The Substrate Thesis\", \"Full argument: ctxl + sync + playtest\"],\n                [\"isnt-this-just-react.md\", \"Isn't This Just ReAct?\", \"Stigmergy and positioning against the field\"],\n                [\"the-pressure-field.md\", \"The Pressure Field\", \"13 intellectual lineages mapped\"],\n                [\"sigma-calculus.md\", \"Σ-calculus\", \"Minimal algebra for substrate systems\"],\n                [\"surfaces-design.md\", \"Surfaces as Substrate\", \"7 design principles for composable experiences\"],\n              ] as [string,string,string][]).map(([doc,label,desc]) => (\n                \n                  {label}\n                  {desc}\n                \n              ))}\n            \n          \n        \n\n      \n      \n        sync {data.version} · @christopherdebeer\n      
\n    \n  );\n}\n",[],[418,1221,1255],"7833e148-13fb-11f1-b99c-42dde27851f2","JsonView.tsx","7833e1fc-13fb-11f1-b99c-42dde27851f2",["D",1772210619912],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { tryParseJson } from \"../utils.ts\";\n\nconst Wrap = styled.span`cursor: default;`;\nconst Str = styled.span`color: #a5d6ff;`;\nconst Num = styled.span`color: #79c0ff;`;\nconst Bool = styled.span`color: var(--orange);`;\nconst Null = styled.span`color: var(--dim); font-style: italic;`;\nconst Key = styled.span`color: #7ee787;`;\nconst Brace = styled.span`color: var(--dim);`;\nconst Children = styled.div`padding-left: 16px;`;\nconst Collapsed = styled.span`color: var(--dim); font-style: italic; font-size: 11px;`;\nconst Toggle = styled.span`\n  cursor: pointer;\n  user-select: none;\n  display: inline;\n  &:hover { color: var(--accent); }\n`;\n\ninterface JsonViewProps {\n  value: any;\n  depth?: number;\n  path?: string;\n}\n\nexport function JsonView({ value, depth = 0, path = \"r\" }: JsonViewProps) {\n  const v = depth === 0 && typeof value === \"string\" ? tryParseJson(value) : value;\n  return {renderValue(v, depth, path)};\n}\n\nfunction CollapsibleNode({ keys, getValue, depth, path, brackets: [b0, b1] }: {\n  keys: string[];\n  getValue: (k: string) => any;\n  depth: number;\n  path: string;\n  brackets: [string, string];\n}) {\n  const [open, setOpen] = useState(depth === 0 && keys.length <= 4);\n  if (!keys.length) return {b0}{b1};\n  const isObj = b0 === \"{\";\n  return (\n    <>\n       setOpen(o => !o)}>\n        {b0}\n        {!open &&  {keys.length} {isObj ? \"keys\" : \"items\"} }\n        {!open && {b1}}\n      \n      {open && (\n        <>\n          \n            {keys.map((k, i) => (\n              \n                {isObj && <>{k}{\": \"}}\n                \n                {i < keys.length - 1 && \",\"}\n              
\n            ))}\n          \n          {b1}\n        \n      )}\n    \n  );\n}\n\nfunction InlineValue({ value, depth, path }: { value: any; depth: number; path: string }) {\n  const v = depth < 3 && typeof value === \"string\" ? tryParseJson(value) : value;\n  return <>{renderValue(v, depth, path)};\n}\n\nfunction renderValue(v: any, depth: number, path: string): React.ReactNode {\n  if (v === null) return null;\n  if (v === undefined) return undef;\n  if (typeof v === \"boolean\") return {String(v)};\n  if (typeof v === \"number\" || typeof v === \"bigint\") return {String(v)};\n  if (typeof v === \"string\") {\n    const display = v.length > 100 ? v.slice(0, 100) + \"…\" : v;\n    return \"{display}\";\n  }\n  if (Array.isArray(v)) {\n    return  String(i))} getValue={k => v[Number(k)]} depth={depth} path={path} brackets={[\"[\", \"]\"]} />;\n  }\n  if (typeof v === \"object\") {\n    const keys = Object.keys(v);\n    return  v[k]} depth={depth} path={path} brackets={[\"{\", \"}\"]} />;\n  }\n  return {String(v)};\n}\n",[],[418,1221,1264],"61eb65b0-1a85-11f1-bf83-42dde27851f2","DocViewer.tsx","025c2fba-140b-11f1-844f-42dde27851f2",409,["D",1772929560083],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n/** SSR-friendly doc page — receives pre-rendered HTML from the server.\n *  No client-side markdown fetching or parsing needed. */\nimport { useState, useEffect, useCallback } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { runMermaid } from \"../mermaid.ts\";\nimport { Nav } from \"./Nav.tsx\";\n\n// ── Styled ──────────────────────────────────────────────────────────────────\n\nconst Page = styled.div`\n  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;\n  background: var(--bg);\n  color: var(--fg);\n  min-height: 100vh;\n  display: flex;\n  flex-direction: column;\n`;\n\nconst TopBar = styled.div`\n  position: sticky;\n  top: 0;\n  z-index: 10;\n  background: var(--surface);\n  border-bottom: 1px solid var(--border);\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0.6rem 1.5rem;\n  gap: 0.75rem;\n  @media (max-width: 480px) {\n    padding: 0.5rem 0.75rem;\n  }\n`;\n\nconst BackLink = styled.a`\n  color: var(--dim);\n  text-decoration: none;\n  font-size: 0.85rem;\n  display: flex;\n  align-items: center;\n  gap: 0.35rem;\n  white-space: nowrap;\n  &:hover { color: var(--fg); }\n`;\n\nconst DocTitle = styled.span`\n  font-weight: 600;\n  font-size: 0.9rem;\n  color: var(--fg);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  min-width: 0;\n  @media (max-width: 480px) {\n    font-size: 0.82rem;\n  }\n`;\n\nconst Actions = styled.div`\n  display: flex;\n  gap: 0.4rem;\n  flex-shrink: 0;\n`;\n\nconst Btn = styled.button`\n  background: transparent;\n  border: 1px solid var(--border);\n  border-radius: 5px;\n  color: var(--dim);\n  font-size: 0.75rem;\n  padding: 0.3rem 0.55rem;\n  cursor: pointer;\n  white-space: nowrap;\n  font-family: inherit;\n  transition: all 0.15s;\n  &:hover { color: var(--fg); border-color: var(--dim); }\n  @media (max-width: 480px) {\n    font-size: 0.72rem;\n    padding: 0.3rem 0.45rem;\n  }\n`;\n\nconst Container = styled.div`\n  max-width: 780px;\n  margin: 0 auto;\n  padding: 2rem 1.5rem 3rem;\n  flex: 1;\n  width: 100%;\n  @media (max-width: 480px) {\n    padding: 1.25rem 1rem 2rem;\n  }\n`;\n\nconst Prose = styled.div`\n  line-height: 1.7;\n  font-size: 0.95rem;\n\n  h1 {\n    font-size: 1.6rem;\n    font-weight: 700;\n    letter-spacing: -0.02em;\n    margin: 2rem 0 0.75rem;\n    color: var(--fg);\n    &:first-child { margin-top: 0; }\n  }\n  h2 {\n    font-size: 1.2rem;\n    font-weight: 600;\n    letter-spacing: -0.01em;\n    margin: 2rem 0 0.6rem;\n    color: var(--fg);\n    padding-bottom: 0.35rem;\n    border-bottom: 1px solid var(--border);\n  }\n  h3 {\n    font-size: 1.02rem;\n    font-weight: 600;\n    margin: 1.5rem 0 0.4rem;\n    color: var(--fg);\n  }\n  h4 {\n    font-size: 0.92rem;\n    font-weight: 600;\n    margin: 1.25rem 0 0.35rem;\n    color: var(--dim);\n  }\n\n  p { margin: 0.6rem 0; }\n\n  a { color: var(--accent); text-decoration: none; }\n  a:hover { text-decoration: underline; }\n\n  strong { color: var(--fg); font-weight: 600; }\n  em { color: var(--dim); }\n\n  ul, ol {\n    margin: 0.6rem 0;\n    padding-left: 1.5rem;\n  }\n  li { margin: 0.25rem 0; }\n\n  code {\n    background: var(--surface);\n    border: 1px solid var(--border);\n    padding: 0.15em 0.4em;\n    border-radius: 4px;\n    font-family: 'SF Mono', 'Cascadia Code', 'Fira Code', monospace;\n    font-size: 0.88em;\n    color: var(--accent);\n  }\n\n  pre {\n    background: var(--surface);\n    border: 1px solid var(--border);\n    border-radius: 8px;\n    padding: 1rem 1.15rem;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n    margin: 1rem 0;\n    line-height: 1.5;\n    code {\n      background: none;\n      border: none;\n      padding: 0;\n      border-radius: 0;\n      font-size: 0.85rem;\n      color: var(--fg);\n    }\n  }\n\n  blockquote {\n    border-left: 3px solid var(--accent);\n    padding: 0.4rem 0 0.4rem 1rem;\n    margin: 1rem 0;\n    color: var(--dim);\n  }\n\n  table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 1rem 0;\n    font-size: 0.88rem;\n    display: block;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  th, td {\n    border: 1px solid var(--border);\n    padding: 0.45rem 0.7rem;\n    text-align: left;\n  }\n  th {\n    background: var(--surface);\n    font-weight: 600;\n    color: var(--fg);\n    white-space: nowrap;\n  }\n  td { color: var(--dim); }\n  td code {\n    font-size: 0.82rem;\n  }\n\n  hr {\n    border: none;\n    border-top: 1px solid var(--border);\n    margin: 2rem 0;\n  }\n\n  .mermaid {\n    margin: 1.25rem 0;\n    text-align: center;\n    overflow-x: auto;\n    svg { max-width: 100%; height: auto; }\n  }\n\n  img { max-width: 100%; border-radius: 6px; }\n\n  @media (max-width: 480px) {\n    font-size: 0.9rem;\n    h1 { font-size: 1.35rem; }\n    h2 { font-size: 1.1rem; }\n    pre { padding: 0.75rem 0.85rem; }\n    pre code { font-size: 0.78rem; }\n  }\n`;\n\nconst ErrorMsg = styled.div`\n  color: #f85149;\n  font-size: 0.9rem;\n  padding: 2rem;\n  text-align: center;\n  a { color: var(--accent); }\n`;\n\n// ── DocPage component (SSR-rendered) ────────────────────────────────────────\n\nexport interface DocPageProps {\n  slug: string;\n  title: string;\n  html: string;\n  rawPath?: string;\n}\n\nexport function DocPage({ slug, title, html, rawPath }: DocPageProps) {\n  const [copied, setCopied] = useState(null);\n\n  useEffect(() => {\n    if (html) runMermaid();\n  }, [html]);\n\n  const copy = useCallback((text: string, label: string) => {\n    navigator.clipboard.writeText(text).then(() => {\n      setCopied(label);\n      setTimeout(() => setCopied(null), 1500);\n    }).catch(() => {});\n  }, []);\n\n  const origin = typeof globalThis.location !== \"undefined\" ? globalThis.location.origin : \"\";\n  const pageUrl = `${origin}/docs/${slug}`;\n\n  return (\n    \n      \n      \n        {\"\\u2190\"} docs\n        {title}\n        \n           copy(pageUrl, \"url\")}>\n            {copied === \"url\" ? \"copied \\u2713\" : \"copy URL\"}\n          \n          {rawPath && (\n            \n              source\n            \n          )}\n        \n      \n      \n        \n      \n    \n  );\n}\n\n// ── DocsIndex component ─────────────────────────────────────────────────────\n\nconst IndexContainer = styled.div`\n  max-width: 680px;\n  margin: 0 auto;\n  padding: 2.5rem 1.5rem 3rem;\n  width: 100%;\n  @media (max-width: 480px) {\n    padding: 1.5rem 1rem 2rem;\n  }\n`;\n\nconst IndexTitle = styled.h1`\n  font-size: 1.4rem;\n  font-weight: 700;\n  letter-spacing: -0.02em;\n  color: var(--fg);\n  margin-bottom: 0.3rem;\n`;\n\nconst IndexSub = styled.p`\n  font-size: 0.88rem;\n  color: var(--dim);\n  margin-bottom: 2rem;\n`;\n\nconst SectionLabel = styled.h2`\n  font-size: 0.78rem;\n  text-transform: uppercase;\n  letter-spacing: 0.08em;\n  color: var(--dim);\n  margin: 1.8rem 0 0.6rem;\n  &:first-of-type { margin-top: 0; }\n`;\n\nconst DocLink = styled.a`\n  display: block;\n  padding: 0.5rem 0.7rem;\n  margin: 0.15rem 0;\n  border-radius: 6px;\n  color: var(--fg);\n  text-decoration: none;\n  font-size: 0.92rem;\n  transition: background 0.12s;\n  &:hover { background: var(--surface); }\n`;\n\nexport interface DocsIndexProps {\n  docs: Array<{ slug: string; title: string; category: string }>;\n}\n\nexport function DocsIndex({ docs }: DocsIndexProps) {\n  const reference = docs.filter(d => d.category === \"reference\");\n  const essays = docs.filter(d => d.category === \"essay\");\n\n  return (\n    \n      \n      \n        Documentation\n        Reference guides and essays on the substrate thesis.\n        Reference\n        {reference.map(d => (\n          {d.title}\n        ))}\n        Essays & Design\n        {essays.map(d => (\n          {d.title}\n        ))}\n      \n    \n  );\n}\n",[],[418,1221,1271],"89c5096e-2198-11f1-9238-42dde27851f2","Dashboard.tsx","783393e6-13fb-11f1-b99c-42dde27851f2",["D",1773707445460],35,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../styled.ts\";\nimport { Nav } from \"./Nav.tsx\";\nimport type {\n  PollDataV8, DashboardConfig, Surface, TokenKind,\n  ActionDef, ViewDef, AgentDef, StateEntry, AuditEntry,\n} from \"../types.ts\";\nimport {\n  actionsFromState, viewsFromState, agentsFromState,\n  messagesFromState, sharedState, scopeEntries, allScopes,\n} from \"../types.ts\";\nimport { JsonView } from \"./JsonView.tsx\";\nimport { AgentsPanel } from \"./panels/Agents.tsx\";\nimport { StatePanel } from \"./panels/State.tsx\";\nimport { MessagesPanel } from \"./panels/Messages.tsx\";\nimport { ActionsPanel } from \"./panels/Actions.tsx\";\nimport { ViewsPanel } from \"./panels/Views.tsx\";\nimport { AuditPanel } from \"./panels/Audit.tsx\";\nimport { CelPanel } from \"./panels/Cel.tsx\";\nimport { SurfacesView, type SurfaceContext } from \"./panels/Surfaces.tsx\";\n\nconst POLL_INTERVAL_MS = 2000;\nconst BASE_URL = globalThis.location?.origin || \"\";\nconst STORAGE_KEY = (roomId: string) => `sync_token_${roomId}`;\n\n// Signal to the shell that React hydrated successfully\nif (typeof window !== \"undefined\" && typeof (window as any).__HYDRATION_OK__ === \"function\") {\n  (window as any).__HYDRATION_OK__();\n}\n\n// ── Safe storage helpers ─────────────────────────────────────────────────\n\nfunction safeGetItem(storage: Storage, key: string): string | null {\n  try { return storage.getItem(key); } catch { return null; }\n}\nfunction safeSetItem(storage: Storage, key: string, value: string): void {\n  try { storage.setItem(key, value); } catch {}\n}\nfunction safeRemoveItem(storage: Storage, key: string): void {\n  try { storage.removeItem(key); } catch {}\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction inferTokenKind(tok: string): TokenKind {\n  if (tok.startsWith(\"room_\")) return \"room\";\n  if (tok.startsWith(\"view_\")) return \"view\";\n  if (tok.startsWith(\"tok_\")) return \"room\"; // unified tokens get full dashboard access\n  return \"agent\";\n}\n\nfunction ts(): string {\n  return new Date().toISOString().slice(11, 23);\n}\n\n// ── Styled components (unchanged) ────────────────────────────────────────────\n\nconst Page = styled.div`\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  background: var(--bg); color: var(--fg); line-height: 1.6; min-height: 100vh;\n  display: flex; flex-direction: column;\n  a { color: var(--accent); text-decoration: none; }\n  a:hover { text-decoration: underline; }\n`;\nconst Gate = styled.div`\n  padding: 15vw 1.5rem; text-align: center; font-size: 13px; width: 100%;\n  min-height: 100vh; display: flex; flex-direction: column; align-items: center;\n  justify-content: center; background-color: var(--bg); box-sizing: border-box;\n  @media (max-width: 480px) { padding: 20vw 1.25rem; }\n`;\nconst GateTitle = styled.h2`\n  color: var(--accent); font-size: 16px; margin-bottom: 0.3rem;\n`;\nconst GateSub = styled.div`\n  color: var(--dim); font-size: 12px; margin-bottom: 1.2rem;\n`;\nconst TokenInput = styled.input`\n  width: 100%; max-width: 20rem; background: var(--surface);\n  border: 1px solid var(--border); border-radius: 6px; padding: 0.6rem 0.8rem;\n  color: var(--fg); font-family: inherit; font-size: 13px; outline: none;\n  text-align: center; box-sizing: border-box;\n  &:focus { border-color: var(--accent); }\n`;\nconst GateError = styled.div`\n  color: var(--red); font-size: 12px; margin-top: 0.5rem;\n`;\nconst GateHint = styled.div`\n  color: var(--dim); font-size: 11px; margin-top: 1rem;\n`;\nconst GateStatus = styled.div`\n  color: var(--dim); font-size: 12px; margin-top: 0.5rem;\n`;\nconst PasskeyButton = styled.button`\n  margin-top: 0.75rem; padding: 0.5rem 1.2rem; background: var(--surface);\n  border: 1px solid var(--border); border-radius: 6px; color: var(--accent);\n  font-family: inherit; font-size: 12px; cursor: pointer; transition: all 0.15s;\n  &:hover { border-color: var(--accent); background: rgba(88,166,255,0.08); }\n  &:disabled { opacity: 0.5; cursor: default; }\n`;\nconst GateDivider = styled.div`\n  color: var(--dim); font-size: 11px; margin: 0.75rem 0;\n  display: flex; align-items: center; gap: 0.5rem;\n  &::before, &::after { content: \"\"; flex: 1; border-top: 1px solid var(--border); }\n`;\nconst DebugTrace = styled.div`\n  margin-top: 1.5rem; padding: 0.5rem 0.75rem; background: var(--surface);\n  border: 1px solid var(--border); border-radius: 6px; text-align: left;\n  font-family: \"SF Mono\", \"Fira Code\", monospace; font-size: 10px;\n  color: var(--dim); max-width: 28rem; width: 100%; max-height: 12rem;\n  overflow-y: auto; line-height: 1.6; white-space: pre-wrap; word-break: break-all;\n`;\nconst Main = styled.div`\n  font-family: \"SF Mono\", \"Cascadia Code\", \"Fira Code\", monospace;\n  font-size: 13px; line-height: 1.5; background: var(--bg); color: var(--fg);\n  max-width: 1100px; margin: 0 auto; min-height: 100vh; width: 100%;\n  a { color: var(--accent); text-decoration: none; }\n  code { background: var(--surface); padding: 0.15em 0.4em; border-radius: 3px; font-size: 0.88em; }\n`;\nconst Headers = styled.div`\n  position: sticky; top: 0; background-color: var(--bg); padding: 1em; z-index: 10;\n  @media (max-width: 480px) { padding: 0.6rem 0.5rem; }\n`;\nconst HeaderRow = styled.div`\n  display: flex; align-items: baseline; justify-content: space-between; margin-bottom: 0.5rem;\n`;\nconst Title = styled.h1`\n  font-size: 14px; font-weight: 600;\n  a { color: var(--accent); text-decoration: none; }\n`;\nconst Subtitle = styled.div`\n  color: var(--dim); font-size: 11px; word-break: break-all;\n`;\nconst PollInfo = styled.div`\n  color: var(--dim); font-size: 11px; display: flex; align-items: center; gap: 6px;\n`;\nconst Dot = styled.span<{ $error?: boolean }>`\n  display: inline-block; width: 7px; height: 7px; border-radius: 50%;\n  background: ${(p) => p.$error ? \"var(--red)\" : \"var(--green)\"};\n`;\nconst IdBar = styled.div`\n  display: flex; align-items: center; gap: 0.75rem; padding: 0.4rem 0.6rem;\n  background: var(--surface); border: 1px solid var(--border); border-radius: 6px;\n  margin-bottom: 0.5rem; font-size: 12px; flex-wrap: wrap;\n`;\nconst IdLabel = styled.span` color: var(--dim); `;\nconst IdKind = styled.span<{ $kind: TokenKind | null }>`\n  font-weight: 600;\n  color: ${(p) => p.$kind === \"room\" ? \"var(--orange)\" : p.$kind === \"view\" ? \"var(--purple)\" : \"var(--accent)\"};\n`;\nconst IdSelect = styled.select`\n  background: var(--bg); border: 1px solid var(--border); border-radius: 4px;\n  color: var(--fg); font-family: inherit; font-size: 12px; padding: 2px 6px; outline: none;\n  &:focus { border-color: var(--accent); }\n`;\nconst Logout = styled.span`\n  color: var(--dim); cursor: pointer; font-size: 11px; margin-left: auto;\n  &:hover { color: var(--red); }\n`;\nconst SummaryBar = styled.div`\n  display: flex; gap: 1rem; padding: 0.4rem 0; font-size: 12px; color: var(--dim); flex-wrap: wrap;\n  @media (max-width: 480px) { gap: 0.5rem 0.75rem; font-size: 11px; }\n`;\nconst Stat = styled.div<{ $color?: string }>`\n  display: flex; align-items: center; gap: 4px; color: ${(p) => p.$color || \"var(--dim)\"};\n`;\nconst StatN = styled.span` color: var(--fg); font-weight: 600; `;\nconst TabsBar = styled.div`\n  display: flex; border-bottom: 1px solid var(--border); margin: 0.5rem 0 0;\n  overflow-x: auto; scrollbar-width: none;\n  &::-webkit-scrollbar { display: none; }\n`;\nconst Tab = styled.button<{ $active: boolean }>`\n  padding: 0.4rem 0.7rem; font-size: 12px; cursor: pointer;\n  color: ${(p) => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  border-bottom: 2px solid ${(p) => p.$active ? \"var(--accent)\" : \"transparent\"};\n  background: none; border-top: none; border-left: none; border-right: none;\n  font-family: inherit; white-space: nowrap;\n  &:hover { color: var(--fg); }\n`;\nconst TabBadge = styled.span<{ $active: boolean }>`\n  display: inline-block;\n  background: ${(p) => p.$active ? \"rgba(88,166,255,0.15)\" : \"var(--border)\"};\n  color: ${(p) => p.$active ? \"var(--accent)\" : \"var(--dim)\"};\n  border-radius: 8px; padding: 0 5px; font-size: 10px; margin-left: 3px;\n`;\nconst Panel = styled.div<{ $active: boolean }>`\n  display: ${(p) => p.$active ? \"block\" : \"none\"}; padding: 0.75rem 1em;\n  @media (max-width: 480px) { padding: 0.5rem; }\n`;\nconst DebugToggle = styled.button<{ $open: boolean }>`\n  display: flex; align-items: center; gap: 6px; width: 100%; padding: 0.5rem 1rem;\n  background: var(--surface); border: none; border-top: 1px solid var(--border);\n  color: var(--dim); font-family: inherit; font-size: 11px; cursor: pointer;\n  &:hover { color: var(--fg); }\n`;\nconst DebugSection = styled.div<{ $open: boolean }>`\n  display: ${p => p.$open ? \"block\" : \"none\"};\n`;\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\ntype PollStatus = \"connecting\" | \"live\" | \"error\";\ntype TabId = \"agents\" | \"state\" | \"messages\" | \"actions\" | \"views\" | \"audit\" | \"cel\";\n\nconst ALL_TABS: { id: TabId; label: string }[] = [\n  { id: \"agents\", label: \"Agents\" },\n  { id: \"state\", label: \"State\" },\n  { id: \"messages\", label: \"Messages\" },\n  { id: \"actions\", label: \"Actions\" },\n  { id: \"views\", label: \"Views\" },\n  { id: \"audit\", label: \"Audit\" },\n  { id: \"cel\", label: \"CEL\" },\n];\n\ninterface DashboardProps { roomId: string; }\n\n// ── Dashboard config helpers ─────────────────────────────────────────────────\n\nfunction extractDashboardConfig(state: StateEntry[]): DashboardConfig | null {\n  const row = state.find(s => s.scope === \"_shared\" && s.key === \"_dashboard\");\n  if (!row) return null;\n  const v = typeof row.value === \"string\" ? (() => { try { return JSON.parse(row.value); } catch { return null; } })() : row.value;\n  if (!v || typeof v !== \"object\") return null;\n  return v as DashboardConfig;\n}\n\n/** v8: Generate auto-surface from a view definition with render hint */\nfunction viewDefToSurface(viewId: string, def: ViewDef): Surface {\n  const hint = def.render!;\n  const id = `auto-${viewId}`;\n  const label = hint.label || def.description || viewId;\n  switch (hint.type) {\n    case \"metric\": return { id, type: \"metric\", view: viewId, label };\n    case \"markdown\": return { id, type: \"markdown\", view: viewId, label };\n    case \"array-table\": return { id, type: \"array-table\", view: viewId, label, columns: hint.columns, max_rows: hint.max_rows };\n    case \"view-table\": return { id, type: \"view-table\", views: [viewId], label };\n    default: return { id, type: \"metric\", view: viewId, label };\n  }\n}\n\n/** v8: Build a simple client-side CEL evaluator from state entries */\nfunction makeSimpleCelEvaluatorV8(data: PollDataV8): (expr: string) => boolean {\n  const stateMap: Record> = {};\n  for (const s of data.state) {\n    if (!stateMap[s.scope]) stateMap[s.scope] = {};\n    stateMap[s.scope][s.key] = s.value;\n  }\n\n  function evalAtom(clause: string): boolean {\n    const c = clause.trim();\n    if (c === \"true\") return true;\n    if (c === \"false\") return false;\n    const m = c.match(/^state\\.([a-zA-Z_][a-zA-Z0-9_]*)\\.([a-zA-Z_][a-zA-Z0-9_]*)\\s*(==|!=|>=?|<=?)\\s*(.+)$/);\n    if (m) {\n      const [, scope, key, op, rawVal] = m;\n      const actual = stateMap[scope]?.[key];\n      let expected: any = rawVal.trim();\n      if ((expected.startsWith('\"') && expected.endsWith('\"')) || (expected.startsWith(\"'\") && expected.endsWith(\"'\"))) expected = expected.slice(1, -1);\n      else if (expected === \"true\") expected = true;\n      else if (expected === \"false\") expected = false;\n      else if (expected === \"null\") expected = null;\n      else if (!isNaN(Number(expected))) expected = Number(expected);\n      if (op === \"==\") return actual == expected;\n      if (op === \"!=\") return actual != expected;\n      if (op === \">\") return actual > expected;\n      if (op === \"<\") return actual < expected;\n      if (op === \">=\") return actual >= expected;\n      if (op === \"<=\") return actual <= expected;\n    }\n    const mv = c.match(/^views\\[\"?([^\"]+)\"?\\]\\s*(==|!=)\\s*(.+)$/);\n    if (mv) {\n      const [, id, op, rawVal] = mv;\n      const actual = data.resolved[id];\n      let expected: any = rawVal.trim();\n      if ((expected.startsWith('\"') && expected.endsWith('\"')) || (expected.startsWith(\"'\") && expected.endsWith(\"'\"))) expected = expected.slice(1, -1);\n      if (op === \"==\") return actual == expected;\n      if (op === \"!=\") return actual != expected;\n    }\n    return false;\n  }\n\n  return (expr: string): boolean => {\n    try {\n      const orGroups = expr.trim().split(/\\s*\\|\\|\\s*/);\n      for (const group of orGroups) {\n        const allTrue = group.split(/\\s*&&\\s*/).every(c => evalAtom(c.replace(/^\\(+/, '').replace(/\\)+$/, '').trim()));\n        if (allTrue) return true;\n      }\n      return false;\n    } catch { return false; }\n  };\n}\n\n// ── Component ────────────────────────────────────────────────────────────────\n\nexport function Dashboard({ roomId }: DashboardProps) {\n  const [token, setToken] = useState(null);\n  const [tokenKind, setTokenKind] = useState(null);\n  const [tokenInput, setTokenInput] = useState(\"\");\n  const [authError, setAuthError] = useState(\"\");\n  const [authStatus, setAuthStatus] = useState(\"\");\n  const [data, setData] = useState(null);\n  const [pollStatus, setPollStatus] = useState(\"connecting\");\n  const [activeTab, setActiveTab] = useState(\"agents\");\n  const [viewAs, setViewAs] = useState(\"\");\n  const [tabInitialized, setTabInitialized] = useState(false);\n  const [debugOpen, setDebugOpen] = useState(false);\n  const [hasPasskeyOption, setHasPasskeyOption] = useState(false);\n  const [vaultChecked, setVaultChecked] = useState(false);\n  const [debugLog, setDebugLog] = useState([]);\n  const pollRef = useRef | null>(null);\n\n  // Append a timestamped line to the visible debug trace\n  const log = useCallback((msg: string) => {\n    setDebugLog(prev => [...prev, `[${ts()}] ${msg}`]);\n  }, []);\n\n  const authHeaders = useCallback((): Record => ({\n    \"Authorization\": `Bearer ${token}`,\n  }), [token]);\n\n  const agentMap = useMemo>(() => {\n    if (!data) return {};\n    const m: Record = {};\n    for (const a of agentsFromState(data)) m[a.id] = { name: a.def.name, role: a.def.role };\n    return m;\n  }, [data]);\n\n  const dashConfig = useMemo(() => {\n    if (!data) return null;\n    return extractDashboardConfig(data.state);\n  }, [data]);\n\n  // v8: derive views from state for surface detection\n  const derivedViews = useMemo(() => data ? viewsFromState(data) : [], [data]);\n\n  const hasSurfaces = useMemo(\n    () => Boolean(dashConfig?.surfaces?.length) || Boolean(derivedViews.some(v => v.def.render)),\n    [dashConfig, derivedViews]\n  );\n  const activeSurfaces = useMemo(() => {\n    if (dashConfig?.surfaces?.length) return dashConfig.surfaces;\n    return derivedViews\n      .filter(v => v.def.render)\n      .sort((a, b) => (a.def.render?.order ?? 999) - (b.def.render?.order ?? 999))\n      .map(v => viewDefToSurface(v.id, v.def));\n  }, [dashConfig, derivedViews]);\n  const visibleTabs = useMemo(() => {\n    if (!dashConfig?.tabs) return ALL_TABS;\n    return ALL_TABS.filter(t => new Set(dashConfig.tabs).has(t.id));\n  }, [dashConfig?.tabs]);\n\n  useEffect(() => {\n    if (tabInitialized || !dashConfig?.default_tab) return;\n    const dt = dashConfig.default_tab as TabId;\n    if (ALL_TABS.some(t => t.id === dt)) setActiveTab(dt);\n    setTabInitialized(true);\n  }, [dashConfig, tabInitialized]);\n\n  const evalCel = useMemo(() => {\n    if (!data) return () => true;\n    return makeSimpleCelEvaluatorV8(data);\n  }, [data]);\n\n  // v8: Build SurfaceContext directly from v8 data — no legacy adapter\n  const surfaceCtx = useMemo(() => {\n    if (!data || !token) return null;\n    return {\n      views: derivedViews.map(v => ({ id: v.id, value: v.value, description: v.def.description, render: v.def.render })),\n      actions: actionsFromState(data).map(a => ({ id: a.id, available: a.available, description: a.def.description, params: a.def.params, writes: a.def.writes, if: a.def.if })),\n      messages: messagesFromState(data).map(m => ({ sort_key: m.sort_key ?? 0, value: m.value, updated_at: m.updated_at })),\n      state: data.state.map(s => ({ scope: s.scope, key: s.key, value: s.value })),\n      agentMap,\n      roomId,\n      baseUrl: BASE_URL,\n      authHeaders: () => ({ \"Authorization\": `Bearer ${token}` }),\n      evalCel,\n    };\n  }, [data, derivedViews, agentMap, roomId, token, evalCel]);\n\n  const doPoll = useCallback(async (tok: string) => {\n    try {\n      const r = await fetch(`${BASE_URL}/rooms/${roomId}/poll`, {\n        headers: { \"Authorization\": `Bearer ${tok}` },\n      });\n      if (r.status === 401) return null;\n      if (!r.ok) throw new Error(`${r.status}`);\n      return await r.json() as PollDataV8;\n    } catch { return undefined; }\n  }, [roomId]);\n\n  const startPolling = useCallback((tok: string) => {\n    if (pollRef.current) clearInterval(pollRef.current);\n    const poll = async () => {\n      const d = await doPoll(tok);\n      if (d === null) { safeRemoveItem(sessionStorage, STORAGE_KEY(roomId)); setToken(null); setTokenKind(null); setPollStatus(\"error\"); if (pollRef.current) clearInterval(pollRef.current); return; }\n      if (d === undefined) { setPollStatus(\"error\"); return; }\n      setData(d); setPollStatus(\"live\");\n    };\n    poll();\n    pollRef.current = setInterval(poll, POLL_INTERVAL_MS);\n  }, [doPoll, roomId]);\n\n  const authenticateWith = useCallback(async (tok: string): Promise => {\n    const d = await doPoll(tok);\n    if (d === null || d === undefined) return false;\n    safeSetItem(sessionStorage, STORAGE_KEY(roomId), tok);\n    setToken(tok); setTokenKind(inferTokenKind(tok)); setData(d); setPollStatus(\"live\"); startPolling(tok);\n    return true;\n  }, [doPoll, roomId, startPolling]);\n\n  const tryAuth = useCallback(async () => {\n    const tok = tokenInput.trim();\n    if (!tok) return;\n    setAuthError(\"\");\n    const d = await doPoll(tok);\n    if (d === null) { setAuthError(\"Invalid token for this room.\"); return; }\n    if (d === undefined) { setAuthError(\"Connection failed.\"); return; }\n    safeSetItem(sessionStorage, STORAGE_KEY(roomId), tok);\n    setToken(tok); setTokenKind(inferTokenKind(tok)); setData(d); setPollStatus(\"live\"); startPolling(tok);\n  }, [tokenInput, doPoll, roomId, startPolling]);\n\n  const tryRoomTokenAuth = useCallback(async (sessionId: string): Promise => {\n    try {\n      // v7: Mint a temporary tok_ token for this room via manage API\n      const res = await fetch(`${BASE_URL}/manage/api/room-token`, {\n        method: \"POST\",\n        headers: { \"X-Session-Id\": sessionId, \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ room_id: roomId }),\n      });\n      if (res.status === 401) { safeRemoveItem(localStorage, \"sync_session_id\"); return false; }\n      if (res.status === 403) return false; // no access to this room\n      if (!res.ok) return false;\n      const data = await res.json();\n      if (!data.token) return false;\n      return await authenticateWith(data.token);\n    } catch { return false; }\n  }, [roomId, authenticateWith]);\n\n  const doPasskeyAuth = useCallback(async () => {\n    setAuthError(\"\"); setAuthStatus(\"Signing in with passkey…\");\n    try {\n      const { startAuthentication } = await import(\"https://esm.sh/@simplewebauthn/browser@13\");\n      const optRes = await fetch(`${BASE_URL}/webauthn/authenticate/options`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({}) });\n      const optData = await optRes.json();\n      if (!optRes.ok) { setAuthError(optData.error || \"Failed to get auth options\"); setAuthStatus(\"\"); return; }\n      setAuthStatus(\"Touch your authenticator…\");\n      const assertResp = await startAuthentication({ optionsJSON: optData.options });\n      setAuthStatus(\"Verifying…\");\n      const verRes = await fetch(`${BASE_URL}/webauthn/authenticate/verify`, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ challengeId: optData.challengeId, response: assertResp }) });\n      const verData = await verRes.json();\n      if (!verRes.ok || !verData.verified) { setAuthError(verData.error || \"Authentication failed\"); setAuthStatus(\"\"); return; }\n      safeSetItem(localStorage, \"sync_session_id\", verData.sessionId);\n      setAuthStatus(\"Checking access…\");\n      const ok = await tryRoomTokenAuth(verData.sessionId);\n      if (!ok) setAuthError(\"Signed in but you don't have access to this room.\");\n      setAuthStatus(\"\");\n    } catch (err: any) { setAuthError(err.message || \"Passkey authentication failed\"); setAuthStatus(\"\"); }\n  }, [tryRoomTokenAuth]);\n\n  // ── Mount: sequential auth chain with debug logging ───────────────────────\n\n  useEffect(() => {\n    let cancelled = false;\n    log(\"effect start · roomId=\" + roomId);\n    log(\"hash=\" + (location.hash || \"(empty)\"));\n    log(\"origin=\" + BASE_URL);\n\n    (async () => {\n      try {\n        // 1. Hash token\n        const hash = location.hash;\n        let hashToken: string | null = null;\n        if (hash.includes(\"token=\")) {\n          hashToken = new URLSearchParams(hash.slice(1)).get(\"token\");\n          log(\"hash token found: \" + (hashToken ? hashToken.slice(0, 12) + \"…\" : \"null\"));\n        } else {\n          log(\"no hash token\");\n        }\n\n        if (hashToken) {\n          log(\"polling with hash token…\");\n          const d = await doPoll(hashToken);\n          if (cancelled) { log(\"cancelled after hash poll\"); return; }\n          log(\"hash poll result: \" + (d === null ? \"401\" : d === undefined ? \"error\" : \"ok\"));\n          if (d && d !== null && d !== undefined) {\n            history.replaceState(null, \"\", location.pathname + location.search);\n            safeSetItem(sessionStorage, STORAGE_KEY(roomId), hashToken);\n            setToken(hashToken); setTokenKind(inferTokenKind(hashToken)); setData(d); setPollStatus(\"live\"); startPolling(hashToken);\n            log(\"authenticated via hash token ✓\");\n            return;\n          }\n          history.replaceState(null, \"\", location.pathname + location.search);\n          setAuthError(d === null ? \"Token from link was invalid or expired.\" : \"Connection failed while verifying token from link.\");\n          setTokenInput(hashToken);\n        }\n\n        // 2. sessionStorage\n        const stored = safeGetItem(sessionStorage, STORAGE_KEY(roomId));\n        log(\"sessionStorage: \" + (stored ? stored.slice(0, 12) + \"…\" : \"null\"));\n        if (stored) {\n          log(\"polling with stored token…\");\n          const d = await doPoll(stored);\n          if (cancelled) { log(\"cancelled after stored poll\"); return; }\n          log(\"stored poll result: \" + (d === null ? \"401\" : d === undefined ? \"error\" : \"ok\"));\n          if (d && d !== null && d !== undefined) {\n            setToken(stored); setTokenKind(inferTokenKind(stored)); setData(d); setPollStatus(\"live\"); startPolling(stored);\n            log(\"authenticated via sessionStorage ✓\");\n            return;\n          }\n          safeRemoveItem(sessionStorage, STORAGE_KEY(roomId));\n          log(\"stored token invalid — cleared\");\n        }\n\n        // 3. User-rooms auto-resolution (v7 — replaces vault)\n        if (!cancelled) {\n          const sessionId = safeGetItem(localStorage, \"sync_session_id\");\n          log(\"manage session: \" + (sessionId ? sessionId.slice(0, 12) + \"…\" : \"null\"));\n          if (sessionId) {\n            log(\"trying room-token resolution…\");\n            setAuthStatus(\"Checking access…\");\n            const ok = await tryRoomTokenAuth(sessionId);\n            if (cancelled) { log(\"cancelled after room-token\"); return; }\n            log(\"room-token result: \" + (ok ? \"authenticated ✓\" : \"no access\"));\n            if (ok) { setAuthStatus(\"\"); return; }\n            setAuthStatus(\"\");\n          }\n        }\n\n        log(\"no auto-auth — showing gate\");\n      } catch (e: any) {\n        log(\"ERROR: \" + (e.message || String(e)));\n        console.error(\"[dashboard] auth init error:\", e);\n      } finally {\n        if (!cancelled) {\n          setVaultChecked(true);\n          if (typeof window !== \"undefined\" && window.PublicKeyCredential) setHasPasskeyOption(true);\n          log(\"gate unlocked (vaultChecked=true)\");\n        }\n      }\n    })();\n\n    return () => { cancelled = true; if (pollRef.current) clearInterval(pollRef.current); };\n  }, [roomId]);\n\n  const doLogout = useCallback(() => {\n    safeRemoveItem(sessionStorage, STORAGE_KEY(roomId));\n    if (pollRef.current) clearInterval(pollRef.current);\n    setToken(null); setTokenKind(null); setData(null); setPollStatus(\"connecting\");\n    setTokenInput(\"\"); setTabInitialized(false); setAuthError(\"\"); setAuthStatus(\"\");\n    setVaultChecked(true);\n    if (typeof window !== \"undefined\" && window.PublicKeyCredential) setHasPasskeyOption(true);\n  }, [roomId]);\n\n  // ── Derived data (must be above early returns to satisfy Rules of Hooks) ──\n\n  const derivedAgents = useMemo(() => data ? agentsFromState(data) : [], [data]);\n  const derivedActions = useMemo(() => data ? actionsFromState(data) : [], [data]);\n  const derivedMessages = useMemo(() => data ? messagesFromState(data) : [], [data]);\n\n  const panelAgents = useMemo(() => derivedAgents.map(a => ({\n    id: a.id, name: a.def.name, role: a.def.role, status: a.def.status,\n    last_heartbeat: a.def.last_heartbeat ?? \"\", grants: JSON.stringify(a.def.grants),\n    joined_at: a.def.joined_at ?? \"\",\n  })), [derivedAgents]);\n\n  const panelState = useMemo(() => {\n    if (!data) return [];\n    return data.state.filter(s => s.scope !== \"_audit\").map(s => ({\n      room_id: \"\", scope: s.scope, key: s.key, value: s.value,\n      version: s.revision, sort_key: s.sort_key ?? undefined, updated_at: s.updated_at,\n      _meta: (s as any)._meta ?? null,\n    }));\n  }, [data]);\n\n  const panelMessages = useMemo(() =>\n    derivedMessages.map(m => ({ sort_key: m.sort_key ?? 0, value: m.value, updated_at: m.updated_at })),\n  [derivedMessages]);\n\n  const panelActions = useMemo(() => derivedActions.map(a => ({\n    id: a.id, room_id: \"\", scope: a.def.scope ?? \"_shared\",\n    description: a.def.description, available: a.available,\n    params: a.def.params, writes: a.def.writes, version: 1,\n    registered_by: a.def.registered_by, if: a.def.if,\n    _meta: a._meta ?? null,\n  })), [derivedActions]);\n\n  const panelViews = useMemo(() => derivedViews.map(v => ({\n    id: v.id, room_id: \"\", scope: v.def.scope ?? \"_shared\",\n    description: v.def.description, expr: v.def.expr,\n    value: v.value, version: 1, registered_by: v.def.registered_by,\n    render: v.def.render ?? null,\n  })), [derivedViews]);\n\n  const panelAudit = useMemo(() =>\n    data?.audit.map(a => ({ sort_key: a.seq, value: a.value, updated_at: a.updated_at })) ?? [],\n  [data]);\n\n  const activeAgents = derivedAgents.filter(a => a.def.status === \"active\").length;\n  const waitingAgents = derivedAgents.filter(a => a.def.status === \"waiting\").length;\n  const stateCount = data?.state.filter(s => !s.scope.startsWith(\"_\")).length ?? 0;\n  const scopeCount = data ? allScopes(data).length : 0;\n  const viewingId = viewAs || undefined;\n  const titleText = dashConfig?.title || \"agent-sync\";\n  const subtitleText = dashConfig?.subtitle || roomId;\n\n  // ── Auth gate ─────────────────────────────────────────────────────────────\n\n  if (!token) {\n    return (\n      \n        agent-sync\n        {roomId}\n\n        {!vaultChecked && authStatus && {authStatus}}\n        {!vaultChecked && !authStatus && connecting…}\n\n        {vaultChecked && (\n          <>\n             setTokenInput(e.target.value)}\n              onKeyDown={(e) => e.key === \"Enter\" && tryAuth()}\n              autoComplete=\"off\" spellCheck={false}\n            />\n            {authError && {authError}}\n            {authStatus && {authStatus}}\n            {hasPasskeyOption && (\n              <>\n                or\n                \n                  Sign in with passkey\n                \n              \n            )}\n            \n              Token stored in sessionStorage · sent via Authorization header only.\n            \n          \n        )}\n\n        {/* Debug trace — always visible in gate */}\n        {debugLog.length > 0 && (\n          {debugLog.join(\"\\n\")}\n        )}\n      \n    );\n  }\n\n  // ── Authenticated dashboard ───────────────────────────────────────────────\n\n  if (!data) return waiting for data…
;\n\n  return (\n    \n      \n      \n        \n          \n            \n              <a href=\"/\">{titleText}</a>{!dashConfig?.title && <span style={{ color: \"var(--dim)\", fontWeight: 400 }}> v9</span>}\n              {subtitleText}\n            
\n            {pollStatus === \"live\" ? \"live\" : pollStatus === \"error\" ? \"error\" : \"connecting…\"}\n          \n          {(!hasSurfaces || debugOpen) && (\n            \n              identity:\n              {tokenKind === \"room\" ? \"room admin\" : tokenKind === \"view\" ? \"observer\" : \"agent\"}\n              {tokenKind === \"room\" &&  setViewAs(e.target.value)}>{derivedAgents.map(a => )}}\n              {tokenKind === \"view\" && read-only}\n              ✕ disconnect\n            \n          )}\n          {!hasSurfaces && (\n            \n              {derivedAgents.length} agents\n              {activeAgents > 0 && {activeAgents} active}\n              {waitingAgents > 0 && {waitingAgents} waiting}\n              {stateCount} keys / {scopeCount} scopes\n              {derivedMessages.length} msgs\n              {derivedActions.length} actions\n              {derivedViews.length} views\n              {data && data.audit.length > 0 && {data.audit.length} audit}\n            \n          )}\n        \n\n        {hasSurfaces && surfaceCtx && (\n          <>\n            \n            {!dashConfig?.hide_debug && (\n              <>\n                 setDebugOpen(o => !o)}>\n                  ▶\n                  {debugOpen ? \"hide debug\" : \"debug\"} · {derivedAgents.length} agents · {data?.state.length ?? 0} keys · {derivedActions.length} actions\n                \n                \n                  {visibleTabs.map(t => { const a = activeTab === t.id; const counts: Record = { agents: panelAgents.length, state: panelState.length, messages: panelMessages.length, actions: panelActions.length, views: panelViews.length, audit: panelAudit.length }; const c = counts[t.id] ?? null; return  setActiveTab(t.id)}>{t.label}{c !== null && {c}}; })}
\n                  \n                  \n                  \n                  \n                  \n                  \n                  \n                \n              \n            )}\n          \n        )}\n\n        {!hasSurfaces && (\n          <>\n            {visibleTabs.map(t => { const a = activeTab === t.id; const counts: Record = { agents: panelAgents.length, state: panelState.length, messages: panelMessages.length, actions: panelActions.length, views: panelViews.length, audit: panelAudit.length }; const c = counts[t.id] ?? null; return  setActiveTab(t.id)}>{t.label}{c !== null && {c}}; })}
\n            \n            \n            \n            \n            \n            \n            \n          \n        )}\n      
\n    \n  );\n}\n",[],[418,1221,1279],"ba9bbcd6-1a81-11f1-b41c-42dde27851f2","Views.tsx","78349480-13fb-11f1-b99c-42dde27851f2","019c9ffc-060a-74df-be1d-7fb507e2c98f",406,["D",1772927990894],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { styled } from \"../../styled.ts\";\nimport type { View } from \"../../types.ts\";\nimport { JsonView } from \"../JsonView.tsx\";\n\nconst Grid = styled.div`display: flex; flex-wrap: wrap; gap: 0.5rem;`;\n\nconst Card = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  padding: 0.6rem 0.8rem;\n  min-width: 0;\n  flex: 1 1 280px;\n  max-width: 400px;\n  @media (max-width: 480px) {\n    flex: 1 1 100%;\n    max-width: 100%;\n  }\n`;\n\nconst ViewName = styled.div`font-weight: 600; font-size: 13px; color: var(--purple); word-break: break-word;`;\nconst Desc = styled.div`color: var(--dim); font-size: 11px; margin-top: 2px;`;\nconst Expr = styled.div`font-size: 11px; color: var(--dim); margin-top: 3px; font-style: italic; word-break: break-word;`;\nconst ValBox = styled.div`\n  margin-top: 4px;\n  padding: 4px 6px;\n  background: var(--bg);\n  border-radius: 3px;\n  font-size: 12px;\n  overflow-x: auto;\n`;\nconst ErrorText = styled.span`color: var(--red);`;\nconst Meta = styled.div`font-size: 10px; color: var(--dim); margin-top: 4px; word-break: break-word;`;\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\n\nconst RenderBadge = styled.span`\n  display: inline-block;\n  background: rgba(88,166,255,0.12);\n  color: var(--accent);\n  border: 1px solid rgba(88,166,255,0.25);\n  border-radius: 3px;\n  padding: 0 5px;\n  font-size: 10px;\n  font-weight: 600;\n  margin-left: 5px;\n  vertical-align: middle;\n  letter-spacing: 0.02em;\n`;\n\nconst RenderHintRow = styled.div`\n  margin-top: 4px;\n  font-size: 10px;\n  color: var(--dim);\n  display: flex;\n  flex-wrap: wrap;\n  gap: 3px 6px;\n`;\n\nconst RenderProp = styled.span`\n  color: var(--accent);\n`;\n\ninterface ViewsPanelProps {\n  views: View[];\n}\n\nexport function ViewsPanel({ views }: ViewsPanelProps) {\n  if (!views.length) return no views registered;\n\n  return (\n    \n      {views.map(v => (\n        \n          \n            {v.id}\n            {v.render && {v.render.type}}\n          \n          {v.description && {v.description}}\n          {v.expr}\n          \n            → {v.value && typeof v.value === \"object\" && v.value._error\n              ? error: {v.value._error}\n              : \n            }\n          \n          {v.render && (\n            \n              {v.render.label && label: {v.render.label}}\n              {v.render.order !== undefined && order: {v.render.order}}\n              {v.render.group && group: {v.render.group}}\n              {v.render.type === \"array-table\" && v.render.columns && (\n                cols: {v.render.columns.map(c => c.label ?? c.key).join(\", \")}\n              )}\n              {v.render.type === \"metric\" && v.render.unit && (\n                unit: {v.render.unit}\n              )}\n            \n          )}\n          \n            scope: {v.scope} · v{v.version}\n            {v.registered_by && ` · by ${v.registered_by}`}\n          \n        \n      ))}\n    \n  );\n}\n",[],[418,1221,1295,1287],"panels","1b93929a-2075-11f1-8859-42dde27851f2","Surfaces.tsx","5beac666-14f3-11f1-a1df-42dde27851f2",["D",1773582277011],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState, useCallback, useMemo, useEffect, useRef } from \"https://esm.sh/react@18.2.0\";\nimport { styled, keyframes } from \"../../styled.ts\";\nimport { JsonView } from \"../JsonView.tsx\";\nimport { aname, rel, tryParseJson } from \"../../utils.ts\";\nimport { inferSurfaceType, inferArrayColumns, resolveColumns } from \"../../renderInference.ts\";\nimport type {\n  Surface, SurfaceMetric, SurfaceViewGrid, SurfaceViewTable, SurfaceArrayTable,\n  SurfaceActionBar, SurfaceActionForm, SurfaceActionChoice,\n  SurfaceFeed, SurfaceWatch, SurfaceSection, SurfaceMarkdown,\n} from \"../../types.ts\";\n\n// ── Minimal interfaces for surface data (decoupled from PollData) ───────────\n\n/** What surfaces need from a view: id, resolved value, description, render hint */\ninterface SurfaceView {\n  id: string;\n  value: any;\n  description?: string;\n  render?: any;\n}\n\n/** What surfaces need from an action: id, availability, params for invocation */\ninterface SurfaceAction {\n  id: string;\n  available: boolean;\n  description?: string;\n  params?: Record;\n  writes?: any[];\n  if?: string;\n}\n\n/** What surfaces need from a message */\ninterface SurfaceMessage {\n  sort_key: number;\n  value: any;\n  updated_at: string;\n}\n\n/** What surfaces need from state: scope + key + value for watch surfaces */\ninterface SurfaceStateEntry {\n  scope: string;\n  key: string;\n  value: any;\n}\n\n// ── Shared styles ───────────────────────────────────────────────────────────\n\nconst SurfaceWrap = styled.div`margin-bottom: 0.75rem;`;\n\nconst SectionWrap = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 0.75rem;\n  margin-bottom: 0.75rem;\n`;\n\nconst SectionLabel = styled.div`\n  font-size: 11px;\n  color: var(--dim);\n  text-transform: uppercase;\n  letter-spacing: 0.05em;\n  margin-bottom: 0.5rem;\n  font-weight: 600;\n`;\n\nconst SurfaceLabel = styled.div`\n  font-size: 10px;\n  color: var(--dim);\n  text-transform: uppercase;\n  letter-spacing: 0.04em;\n  margin-bottom: 4px;\n`;\n\n// ── Metric ──────────────────────────────────────────────────────────────────\n\nconst MetricCard = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 0.75rem 1rem;\n`;\n\nconst MetricValue = styled.div`\n  font-size: 22px;\n  font-weight: 700;\n  color: var(--fg);\n  word-break: break-word;\n  line-height: 1.3;\n`;\n\nconst MetricError = styled.span`color: var(--red); font-size: 13px;`;\n\nfunction MetricSurface({ surface, views }: { surface: SurfaceMetric; views: SurfaceView[] }) {\n  const view = views.find(v => v.id === surface.view);\n  if (!view) return null;\n\n  const label = surface.label || view.description || view.id;\n  let display: any;\n  if (view.value && typeof view.value === \"object\" && view.value._error) {\n    display = error;\n  } else if (typeof view.value === \"number\" || typeof view.value === \"boolean\" || typeof view.value === \"string\") {\n    display = String(view.value);\n  } else {\n    display = ;\n  }\n\n  return (\n    \n      \n        {label}\n        {display}\n      \n    \n  );\n}\n\n// ── View Grid ───────────────────────────────────────────────────────────────\n\nconst VGrid = styled.div`display: flex; gap: 0.5rem; flex-wrap: wrap;`;\nconst VGridCard = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  padding: 0.5rem 0.7rem;\n  flex: 1 1 120px;\n  min-width: 100px;\n`;\nconst VGridLabel = styled.div`\n  font-size: 10px;\n  color: var(--dim);\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n`;\nconst VGridValue = styled.div`\n  font-size: 15px;\n  font-weight: 600;\n  color: var(--fg);\n  word-break: break-word;\n`;\n\nfunction ViewGridSurface({ surface, views }: { surface: SurfaceViewGrid; views: SurfaceView[] }) {\n  const viewMap = new Map(views.map(v => [v.id, v]));\n  const resolved = surface.views.map(id => viewMap.get(id)).filter((v): v is SurfaceView => !!v);\n  if (!resolved.length) return null;\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {resolved.map(v => (\n          \n            {v.description || v.id}\n            \n              {v.value && typeof v.value === \"object\" && v.value._error\n                ? err\n                : typeof v.value === \"number\" || typeof v.value === \"boolean\" || typeof v.value === \"string\"\n                  ? String(v.value)\n                  : \n              }\n            \n          \n        ))}\n      \n    \n  );\n}\n\n// ── View Table ──────────────────────────────────────────────────────────────\n\nconst VTable = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  overflow: hidden;\n`;\nconst VTRow = styled.div`\n  display: grid;\n  grid-template-columns: 140px 1fr;\n  gap: 0.5rem;\n  padding: 0.35rem 0.6rem;\n  font-size: 12px;\n  border-bottom: 1px solid var(--border);\n  &:last-child { border-bottom: none; }\n  @media (max-width: 480px) {\n    grid-template-columns: 1fr;\n    gap: 2px;\n  }\n`;\nconst VTLabel = styled.div`color: var(--dim); font-size: 11px;`;\nconst VTValue = styled.div`color: var(--fg); font-weight: 500; word-break: break-word;`;\n\nfunction ViewTableSurface({ surface, views }: { surface: SurfaceViewTable; views: SurfaceView[] }) {\n  const viewMap = new Map(views.map(v => [v.id, v]));\n  const resolved = surface.views.map(id => viewMap.get(id)).filter((v): v is SurfaceView => !!v);\n  if (!resolved.length) return null;\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {resolved.map(v => (\n          \n            {v.description || v.id}\n            \n              {v.value && typeof v.value === \"object\" && v.value._error\n                ? error\n                : typeof v.value === \"number\" || typeof v.value === \"boolean\" || typeof v.value === \"string\"\n                  ? String(v.value)\n                  : \n              }\n            \n          \n        ))}\n      \n    \n  );\n}\n\n// ── Action Bar ──────────────────────────────────────────────────────────────\n\nconst ABar = styled.div`\n  display: flex;\n  gap: 0.4rem;\n  flex-wrap: wrap;\n  align-items: flex-start;\n`;\n\nconst ABarBtn = styled.button<{ $available: boolean; $active?: boolean }>`\n  background: ${p => !p.$available ? \"var(--border)\" : p.$active ? \"var(--accent)\" : \"var(--green)\"};\n  color: ${p => !p.$available ? \"var(--dim)\" : \"var(--bg)\"};\n  border: none;\n  border-radius: 5px;\n  padding: 0.4rem 0.9rem;\n  cursor: ${p => p.$available ? \"pointer\" : \"not-allowed\"};\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 600;\n  white-space: nowrap;\n  &:hover { opacity: ${p => p.$available ? 0.85 : 1}; }\n`;\n\nconst ABarFormWrap = styled.div`\n  width: 100%;\n  margin-top: 4px;\n  padding: 8px 10px;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n`;\n\nconst ABarParamRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin-bottom: 4px;\n  font-size: 11px;\n`;\n\nconst ABarParamLabel = styled.label`color: var(--accent); font-weight: 600; min-width: 60px;`;\nconst ABarParamInput = styled.input`\n  flex: 1;\n  background: var(--bg);\n  border: 1px solid var(--border);\n  border-radius: 3px;\n  padding: 3px 6px;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 11px;\n  outline: none;\n  min-width: 0;\n  &:focus { border-color: var(--accent); }\n`;\nconst ABarParamSelect = styled.select`\n  flex: 1;\n  background: var(--bg);\n  border: 1px solid var(--border);\n  border-radius: 3px;\n  padding: 3px 6px;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 11px;\n  outline: none;\n  min-width: 0;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst ABarActions = styled.div`display: flex; gap: 6px; margin-top: 6px;`;\nconst ABarSend = styled.button`\n  background: var(--green); color: var(--bg); border: none; border-radius: 4px;\n  padding: 3px 10px; cursor: pointer; font-family: inherit; font-size: 11px; font-weight: 600;\n  &:hover { opacity: 0.85; }\n  &:disabled { background: var(--border); color: var(--dim); cursor: not-allowed; }\n`;\nconst ABarCancel = styled.button`\n  background: none; border: 1px solid var(--border); border-radius: 4px;\n  padding: 3px 8px; cursor: pointer; font-family: inherit; font-size: 11px; color: var(--dim);\n  &:hover { color: var(--fg); }\n`;\n\nconst flash = keyframes`from { background: rgba(63,185,80,0.15); } to { background: transparent; }`;\nconst ResultBox = styled.div<{ $error?: boolean }>`\n  margin-top: 6px; padding: 4px 8px; border-radius: 3px; font-size: 11px;\n  white-space: pre-wrap; word-break: break-word; max-height: 100px; overflow-y: auto;\n  color: ${p => p.$error ? \"var(--red)\" : \"var(--green)\"};\n  background: ${p => p.$error ? \"rgba(248,81,73,0.08)\" : \"rgba(63,185,80,0.08)\"};\n  animation: ${flash} 0.5s ease-out;\n`;\n\nconst ABarDesc = styled.div`\n  font-size: 11px; color: var(--dim); padding: 2px 0; font-style: italic;\n`;\n\nfunction ActionBarSurface({ surface, actions, roomId, baseUrl, authHeaders }: {\n  surface: SurfaceActionBar;\n  actions: SurfaceAction[];\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n}) {\n  const actionMap = new Map(actions.map(a => [a.id, a]));\n  const resolved = surface.actions.map(id => actionMap.get(id)).filter((a): a is SurfaceAction => !!a && a.available !== false);\n\n  const [expandedId, setExpandedId] = useState(null);\n  const [params, setParams] = useState>({});\n  const [sending, setSending] = useState(false);\n  const [result, setResult] = useState<{ ok: boolean; text: string } | null>(null);\n\n  const openForm = useCallback((action: SurfaceAction) => {\n    if (expandedId === action.id) {\n      setExpandedId(null);\n      return;\n    }\n    const defaults: Record = {};\n    for (const [k, def] of Object.entries(action.params || {})) {\n      if (def.enum?.length) defaults[k] = String(def.enum[0]);\n      else defaults[k] = \"\";\n    }\n    setParams(defaults);\n    setResult(null);\n    setExpandedId(action.id);\n  }, [expandedId]);\n\n  const doInvoke = useCallback(async (action: SurfaceAction) => {\n    setSending(true);\n    setResult(null);\n    try {\n      const coerced: Record = {};\n      const paramDefs = action.params || {};\n      for (const [k, v] of Object.entries(params)) {\n        if (v === \"\" || v === undefined) continue;\n        const def = paramDefs[k];\n        if (def?.type === \"number\") { const n = Number(v); coerced[k] = isNaN(n) ? v : n; }\n        else if (def?.type === \"boolean\") { coerced[k] = v === \"true\"; }\n        else if (def?.type === \"object\" || def?.type === \"array\" || def?.type === \"any\") {\n          try { coerced[k] = JSON.parse(v); } catch { coerced[k] = v; }\n        } else { coerced[k] = v; }\n      }\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/actions/${action.id}/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: coerced }),\n      });\n      const d = await r.json();\n      if (d.error) {\n        setResult({ ok: false, text: d.message || d.error + (d.detail ? `: ${d.detail}` : \"\") });\n      } else {\n        setResult({ ok: true, text: d.result !== undefined\n          ? `✓ ${typeof d.result === \"string\" ? d.result : JSON.stringify(d.result, null, 2)}`\n          : \"✓ invoked\" });\n        // Auto-close on success for no-param actions\n        if (!Object.keys(paramDefs).length) {\n          setTimeout(() => { setExpandedId(null); setResult(null); }, 1200);\n        }\n      }\n    } catch (e: any) {\n      setResult({ ok: false, text: e.message });\n    } finally {\n      setSending(false);\n    }\n  }, [params, roomId, baseUrl, authHeaders]);\n\n  if (!resolved.length) return null;\n\n  const expandedAction = expandedId ? actionMap.get(expandedId) : null;\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {resolved.map(a => {\n          const av = a.available !== false;\n          const hasParams = Object.keys(a.params || {}).length > 0;\n          return (\n             {\n                if (!av) return;\n                if (hasParams) {\n                  openForm(a);\n                } else {\n                  // Direct invoke for no-param actions\n                  openForm(a);\n                  // We'll invoke after form opens with empty params\n                }\n              }}\n            >\n              {a.description || a.id}\n            \n          );\n        })}\n      \n      {expandedAction && (() => {\n        const paramDefs = expandedAction.params || {};\n        const paramKeys = Object.keys(paramDefs);\n        const hasParams = paramKeys.length > 0;\n        return (\n          \n            {expandedAction.description && expandedId !== null && hasParams && (\n              {expandedAction.description}\n            )}\n            {hasParams ? paramKeys.map(k => {\n              const def = paramDefs[k];\n              return (\n                \n                  {k}\n                  {def.enum ? (\n                     setParams(p => ({ ...p, [k]: e.target.value }))}>\n                      {def.enum.map((v: any) => )}\n                    \n                  ) : (\n                     setParams(p => ({ ...p, [k]: e.target.value }))}\n                      onKeyDown={e => e.key === \"Enter\" && doInvoke(expandedAction)}\n                      spellCheck={false}\n                    />\n                  )}\n                \n              );\n            }) : null}\n            \n               doInvoke(expandedAction)} disabled={sending}>\n                {sending ? \"…\" : hasParams ? \"send\" : \"confirm\"}\n              \n               { setExpandedId(null); setResult(null); }}>cancel\n            \n            {result && {result.text}}\n          \n        );\n      })()}\n    \n  );\n}\n\n// ── Action Form (single action, always expanded) ────────────────────────────\n\nconst AFormCard = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 0.75rem 1rem;\n`;\nconst AFormTitle = styled.div`font-size: 13px; font-weight: 600; color: var(--green); margin-bottom: 2px;`;\nconst AFormDesc = styled.div`font-size: 11px; color: var(--dim); margin-bottom: 8px;`;\nconst AFormUnavail = styled.div`font-size: 11px; color: var(--dim); font-style: italic; padding: 0.5rem 0;`;\n\nfunction ActionFormSurface({ surface, actions, roomId, baseUrl, authHeaders }: {\n  surface: SurfaceActionForm;\n  actions: SurfaceAction[];\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n}) {\n  const action = actions.find(a => a.id === surface.action);\n  if (!action) return null;\n\n  const av = action.available !== false;\n  const paramDefs = action.params || {};\n  const paramKeys = Object.keys(paramDefs);\n\n  const [params, setParams] = useState>(() => {\n    const defaults: Record = {};\n    for (const [k, def] of Object.entries(paramDefs)) {\n      if (def.enum?.length) defaults[k] = String(def.enum[0]);\n      else defaults[k] = \"\";\n    }\n    return defaults;\n  });\n  const [sending, setSending] = useState(false);\n  const [result, setResult] = useState<{ ok: boolean; text: string } | null>(null);\n\n  const doInvoke = useCallback(async () => {\n    setSending(true);\n    setResult(null);\n    try {\n      const coerced: Record = {};\n      for (const [k, v] of Object.entries(params)) {\n        if (v === \"\" || v === undefined) continue;\n        const def = paramDefs[k];\n        if (def?.type === \"number\") { const n = Number(v); coerced[k] = isNaN(n) ? v : n; }\n        else if (def?.type === \"boolean\") { coerced[k] = v === \"true\"; }\n        else if (def?.type === \"object\" || def?.type === \"array\" || def?.type === \"any\") {\n          try { coerced[k] = JSON.parse(v); } catch { coerced[k] = v; }\n        } else { coerced[k] = v; }\n      }\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/actions/${action.id}/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: coerced }),\n      });\n      const d = await r.json();\n      if (d.error) {\n        setResult({ ok: false, text: d.message || d.error + (d.detail ? `: ${d.detail}` : \"\") });\n      } else {\n        setResult({ ok: true, text: d.result !== undefined\n          ? `✓ ${typeof d.result === \"string\" ? d.result : JSON.stringify(d.result, null, 2)}`\n          : \"✓ invoked\" });\n        // Clear text inputs on success\n        const cleared: Record = {};\n        for (const [k, def] of Object.entries(paramDefs)) {\n          if (def.enum?.length) cleared[k] = String(def.enum[0]);\n          else cleared[k] = \"\";\n        }\n        setParams(cleared);\n      }\n    } catch (e: any) {\n      setResult({ ok: false, text: e.message });\n    } finally {\n      setSending(false);\n    }\n  }, [params, paramDefs, action.id, roomId, baseUrl, authHeaders]);\n\n  const label = surface.label || action.description || action.id;\n\n  return (\n    \n      \n        {label}\n        {action.description && surface.label && {action.description}}\n        {!av && Currently unavailable}\n        {av && (\n          <>\n            {paramKeys.map(k => {\n              const def = paramDefs[k];\n              return (\n                \n                  {k}\n                  {def.enum ? (\n                     setParams(p => ({ ...p, [k]: e.target.value }))}>\n                      {def.enum.map((v: any) => )}\n                    \n                  ) : (\n                     setParams(p => ({ ...p, [k]: e.target.value }))}\n                      onKeyDown={e => e.key === \"Enter\" && doInvoke()}\n                      spellCheck={false}\n                    />\n                  )}\n                \n              );\n            })}\n            \n              \n                {sending ? \"…\" : \"send\"}\n              \n            \n          \n        )}\n        {result && {result.text}}\n      \n    \n  );\n}\n\n// ── Action Choice (mutually exclusive buttons) ──────────────────────────────\n\nconst ChoiceWrap = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 0.6rem 0.8rem;\n`;\nconst ChoiceRow = styled.div`display: flex; gap: 0.4rem; flex-wrap: wrap;`;\nconst ChoiceBtn = styled.button<{ $available: boolean }>`\n  flex: 1 1 0;\n  min-width: 80px;\n  background: ${p => p.$available ? \"var(--surface2)\" : \"var(--border)\"};\n  color: ${p => p.$available ? \"var(--fg)\" : \"var(--dim)\"};\n  border: 1px solid ${p => p.$available ? \"var(--accent)\" : \"var(--border)\"};\n  border-radius: 6px;\n  padding: 0.5rem 0.75rem;\n  cursor: ${p => p.$available ? \"pointer\" : \"not-allowed\"};\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 500;\n  text-align: center;\n  &:hover { background: ${p => p.$available ? \"rgba(88,166,255,0.1)\" : \"var(--border)\"}; }\n`;\nconst ChoiceDesc = styled.div`font-size: 10px; color: var(--dim); margin-top: 2px;`;\n\nfunction ActionChoiceSurface({ surface, actions, roomId, baseUrl, authHeaders }: {\n  surface: SurfaceActionChoice;\n  actions: SurfaceAction[];\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n}) {\n  const actionMap = new Map(actions.map(a => [a.id, a]));\n  const resolved = surface.actions.map(id => actionMap.get(id)).filter((a): a is SurfaceAction => !!a);\n  const [sending, setSending] = useState(null);\n  const [result, setResult] = useState<{ ok: boolean; text: string } | null>(null);\n\n  const invoke = useCallback(async (action: SurfaceAction) => {\n    if (Object.keys(action.params || {}).length > 0) return; // Can't quick-invoke with params\n    setSending(action.id);\n    setResult(null);\n    try {\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/actions/${action.id}/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: {} }),\n      });\n      const d = await r.json();\n      if (d.error) setResult({ ok: false, text: d.message || d.error });\n      else setResult({ ok: true, text: `✓ ${action.description || action.id}` });\n    } catch (e: any) {\n      setResult({ ok: false, text: e.message });\n    } finally {\n      setSending(null);\n    }\n  }, [roomId, baseUrl, authHeaders]);\n\n  if (!resolved.length) return null;\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        \n          {resolved.map(a => (\n             a.available !== false && invoke(a)}\n              disabled={sending !== null}\n            >\n              {sending === a.id ? \"…\" : (a.description || a.id)}\n              {a.if && {a.available === false ? \"locked\" : \"\"}}\n            \n          ))}\n        \n        {result && {result.text}}\n      \n    \n  );\n}\n\n// ── Feed (filtered messages + optional compose) ─────────────────────────────\n\nconst FeedWrap = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  overflow: hidden;\n`;\nconst FeedLog = styled.div`\n  max-height: 300px;\n  overflow-y: auto;\n  padding: 2px 0;\n`;\nconst FeedRow = styled.div`\n  display: grid;\n  grid-template-columns: 80px 1fr auto;\n  gap: 0.4rem;\n  padding: 3px 8px;\n  font-size: 12px;\n  &:hover { background: var(--surface2); }\n  @media (max-width: 480px) {\n    grid-template-columns: 1fr;\n    gap: 2px;\n    padding: 4px 8px;\n  }\n`;\nconst FeedFrom = styled.div`color: var(--accent); font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;`;\nconst FeedBody = styled.div`color: var(--fg); word-break: break-word; min-width: 0;`;\nconst FeedMeta = styled.div`color: var(--dim); font-size: 10px; white-space: nowrap; text-align: right;`;\nconst FeedKind = styled.span<{ $kind: string }>`\n  display: inline-block;\n  background: ${p => p.$kind === \"task\" ? \"rgba(210,153,34,0.2)\" : p.$kind === \"result\" ? \"rgba(63,185,80,0.2)\" : \"var(--border)\"};\n  color: ${p => p.$kind === \"task\" ? \"var(--yellow)\" : p.$kind === \"result\" ? \"var(--green)\" : \"var(--dim)\"};\n  border-radius: 2px; padding: 0 4px; font-size: 10px; margin-right: 4px;\n`;\nconst FeedEmpty = styled.div`color: var(--dim); font-style: italic; padding: 0.75rem; text-align: center; font-size: 12px;`;\nconst FeedCompose = styled.div`\n  display: flex; gap: 0.4rem; padding: 0.4rem 0.5rem;\n  border-top: 1px solid var(--border);\n`;\nconst FeedInput = styled.input`\n  flex: 1; min-width: 0;\n  background: var(--bg); border: 1px solid var(--border); border-radius: 4px;\n  padding: 0.3rem 0.5rem; color: var(--fg); font-family: inherit; font-size: 12px; outline: none;\n  &:focus { border-color: var(--accent); }\n`;\nconst FeedSendBtn = styled.button`\n  background: var(--accent); color: var(--bg); border: none; border-radius: 4px;\n  padding: 0.3rem 0.7rem; cursor: pointer; font-family: inherit; font-size: 12px; font-weight: 600;\n  white-space: nowrap;\n  &:hover { opacity: 0.85; }\n  &:disabled { background: var(--border); color: var(--dim); cursor: not-allowed; }\n`;\n\nfunction FeedSurface({ surface, messages, agentMap, roomId, baseUrl, authHeaders, readOnly }: {\n  surface: SurfaceFeed;\n  messages: SurfaceMessage[];\n  agentMap: Record;\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n  readOnly?: boolean;\n}) {\n  const filtered = useMemo(() => {\n    if (!surface.kinds?.length) return messages;\n    const allowed = new Set(surface.kinds);\n    return messages.filter(m => {\n      let v = tryParseJson(m.value);\n      if (typeof v !== \"object\" || v === null) v = { body: String(m.value) };\n      return allowed.has(v.kind || \"msg\");\n    });\n  }, [messages, surface.kinds]);\n\n  const [text, setText] = useState(\"\");\n  const [sending, setSending] = useState(false);\n\n  const send = useCallback(async () => {\n    const body = text.trim();\n    if (!body) return;\n    setSending(true);\n    try {\n      await fetch(`${baseUrl}/rooms/${roomId}/actions/_send_message/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: { body, kind: surface.kinds?.[0] || \"chat\" } }),\n      });\n      setText(\"\");\n    } catch {}\n    setSending(false);\n  }, [text, roomId, baseUrl, authHeaders, surface.kinds]);\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {!filtered.length && no messages}\n        {filtered.length > 0 && (\n          \n            {filtered.map(m => {\n              let v = tryParseJson(m.value);\n              if (typeof v !== \"object\" || v === null) v = { body: String(m.value) };\n              const kind = v.kind || \"msg\";\n              const from = v.from || \"system\";\n              const body = typeof v.body === \"string\" ? v.body : JSON.stringify(v.body || v);\n              return (\n                \n                  {aname(from, agentMap)}\n                  \n                    {kind}\n                    \n                  \n                  {rel(m.updated_at)}\n                \n              );\n            })}\n          \n        )}\n        {!readOnly && surface.compose !== false && (\n          \n             setText(e.target.value)}\n              onKeyDown={e => e.key === \"Enter\" && !sending && send()}\n              spellCheck={false}\n            />\n            \n              {sending ? \"…\" : \"send\"}\n            \n          \n        )}\n      \n    \n  );\n}\n\n// v8: Upgraded markdown rendering — uses marked.js (loaded in shell)\n// and detects mermaid code blocks for diagram rendering.\nfunction renderMarkdown(text: string): string {\n  if (typeof (globalThis as any).marked !== \"undefined\") {\n    try {\n      const html = (globalThis as any).marked.parse(text, { breaks: true, gfm: true });\n      return html;\n    } catch { /* fall through to fallback */ }\n  }\n  // Fallback: basic escaping + line breaks\n  const d = document.createElement(\"div\");\n  d.textContent = text;\n  return d.innerHTML.replace(/\\n/g, \"
\");\n}\n\n// v8: Detect and render mermaid diagrams in markdown content.\n// Called after mount on elements containing rendered markdown.\nfunction renderMermaidBlocks(container: HTMLElement | null) {\n  if (!container) return;\n  if (typeof (globalThis as any).mermaid === \"undefined\") return;\n  const codeBlocks = container.querySelectorAll(\"pre code.language-mermaid, pre code\");\n  let idx = 0;\n  codeBlocks.forEach((block) => {\n    const text = block.textContent?.trim() ?? \"\";\n    // Detect mermaid syntax\n    const isMermaid = block.classList.contains(\"language-mermaid\") ||\n      /^(graph|flowchart|sequenceDiagram|classDiagram|stateDiagram|erDiagram|gantt|pie|journey)\\b/.test(text);\n    if (!isMermaid) return;\n    const pre = block.parentElement;\n    if (!pre) return;\n    const wrapper = document.createElement(\"div\");\n    wrapper.className = \"mermaid\";\n    wrapper.textContent = text;\n    pre.replaceWith(wrapper);\n    idx++;\n  });\n  if (idx > 0) {\n    try { (globalThis as any).mermaid.run({ querySelector: \".mermaid\" }); } catch {}\n  }\n}\n\n// ── Watch (specific state keys) ─────────────────────────────────────────────\n\nconst WatchWrap = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  overflow: hidden;\n`;\nconst WatchRow = styled.div`\n  display: grid;\n  grid-template-columns: 120px 1fr;\n  gap: 0.5rem;\n  padding: 0.3rem 0.5rem;\n  font-size: 12px;\n  border-bottom: 1px solid var(--border);\n  &:last-child { border-bottom: none; }\n`;\nconst WatchKey = styled.div`color: var(--green); font-weight: 500; word-break: break-word;`;\nconst WatchValue = styled.div`color: var(--fg); word-break: break-word;`;\n\nfunction WatchSurface({ surface, state }: { surface: SurfaceWatch; state: SurfaceStateEntry[] }) {\n  const resolved = surface.keys.map((k: any) => {\n    const scope = typeof k === \"string\" ? \"_shared\" : k.scope;\n    const key = typeof k === \"string\" ? k : k.key;\n    return state.find(s => s.scope === scope && s.key === key);\n  }).filter((s): s is SurfaceStateEntry => !!s);\n\n  if (!resolved.length) return null;\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {resolved.map(s => (\n          \n            {s.scope === \"_shared\" ? s.key : `${s.scope}.${s.key}`}\n            \n          \n        ))}\n      \n    \n  );\n}\n\n// ── Markdown (view rendered as markdown) ────────────────────────────────────\n\nconst MdCard = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 8px;\n  padding: 0.75rem 1rem;\n  font-size: 13px;\n  line-height: 1.6;\n  color: var(--fg);\n  word-break: break-word;\n  a { color: var(--accent); }\n  code { background: var(--bg); border-radius: 3px; padding: 1px 4px; font-size: 11px; color: var(--accent); }\n  pre { background: var(--bg); border-radius: 4px; padding: 0.4rem 0.6rem; margin: 0.3rem 0; overflow-x: auto; }\n  pre code { background: none; padding: 0; color: var(--fg); }\n  strong { color: var(--fg); }\n  em { color: var(--dim); }\n  h1, h2, h3 { font-size: 14px; font-weight: 700; margin-top: 0.3rem; }\n  ul, ol { padding-left: 1.2rem; margin: 0.2rem 0; }\n  p + p { margin-top: 0.4rem; }\n`;\n\nfunction MarkdownSurface({ surface, views }: { surface: SurfaceMarkdown; views: SurfaceView[] }) {\n  const view = views.find(v => v.id === surface.view);\n  const mdRef = useRef(null);\n  if (!view) return null;\n  const text = typeof view.value === \"string\" ? view.value : JSON.stringify(view.value);\n  const html = useMemo(() => renderMarkdown(text), [text]);\n\n  // v8: Trigger mermaid rendering after markdown is inserted\n  useEffect(() => {\n    renderMermaidBlocks(mdRef.current);\n  }, [html]);\n\n  return (\n    \n      {surface.label && {surface.label}}\n      \n    \n  );\n}\n\n// ── Array Table (single view returning an array → data grid) ────────────────\n\nconst ATable = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  overflow: hidden;\n`;\n\nconst ATableScroll = styled.div`\n  overflow-x: auto;\n  max-height: 360px;\n  overflow-y: auto;\n`;\n\nconst ATableEl = styled.table`\n  width: 100%;\n  border-collapse: collapse;\n  font-size: 12px;\n`;\n\nconst ATHead = styled.thead`\n  position: sticky;\n  top: 0;\n  background: var(--bg);\n  z-index: 1;\n`;\n\nconst ATH = styled.th<{ $width?: string }>`\n  padding: 0.3rem 0.6rem;\n  text-align: left;\n  color: var(--dim);\n  font-size: 11px;\n  font-weight: 600;\n  white-space: nowrap;\n  border-bottom: 1px solid var(--border);\n  ${p => p.$width ? `width: ${p.$width};` : \"\"}\n`;\n\nconst ATR = styled.tr`\n  border-bottom: 1px solid var(--border);\n  &:last-child { border-bottom: none; }\n  &:hover { background: var(--surface2); }\n`;\n\nconst ATD = styled.td`\n  padding: 0.3rem 0.6rem;\n  color: var(--fg);\n  vertical-align: top;\n  word-break: break-word;\n  max-width: 280px;\n`;\n\nconst ATEmpty = styled.div`\n  color: var(--dim);\n  font-style: italic;\n  padding: 0.75rem;\n  text-align: center;\n  font-size: 12px;\n`;\n\nconst ATMore = styled.div`\n  color: var(--dim);\n  font-size: 11px;\n  padding: 0.35rem 0.6rem;\n  border-top: 1px solid var(--border);\n  text-align: right;\n`;\n\nconst ATHetero = styled.div`\n  color: var(--dim);\n  font-size: 11px;\n  padding: 0.5rem 0.6rem;\n  font-style: italic;\n`;\n\nfunction renderCellValue(val: any, truncate: number): React.ReactNode {\n  if (val === null || val === undefined) return —;\n  if (typeof val === \"boolean\") return {val ? \"✓\" : \"✗\"};\n  if (typeof val === \"number\") return {val};\n  if (typeof val === \"string\") {\n    if (val.length > truncate) return {val.slice(0, truncate)}…;\n    return val;\n  }\n  if (Array.isArray(val)) return [{val.length} items];\n  return ;\n}\n\nfunction ArrayTableSurface({ view }: { view: SurfaceView }) {\n  const arr = Array.isArray(view.value) ? view.value : [];\n  const render = view.render;\n  const maxRows = render?.max_rows ?? 100;\n  const label = render?.label || view.description || view.id;\n\n  // Infer or use explicit columns\n  const { homogeneous, columns: inferredCols } = useMemo(() => inferArrayColumns(arr), [arr]);\n  const resolved = useMemo(\n    () => resolveColumns(inferredCols, render?.columns),\n    [inferredCols, render?.columns]\n  );\n\n  const displayRows = arr.slice(0, maxRows);\n  const overflow = arr.length - displayRows.length;\n\n  return (\n    \n      {label}\n      \n        {arr.length === 0 ? (\n          no items\n        ) : !homogeneous ? (\n          <>\n            heterogeneous array — showing raw\n            \n              \n            \n          \n        ) : (\n          <>\n            \n              \n                {resolved.length > 0 && (\n                  \n                    \n                      {resolved.map(col => (\n                        {col.label}\n                      ))}\n                    \n                  \n                )}\n                \n                  {displayRows.map((row, i) => (\n                    \n                      {resolved.length > 0 ? resolved.map(col => (\n                        \n                          {renderCellValue(\n                            typeof row === \"object\" && row !== null ? row[col.key] : row,\n                            col.truncate\n                          )}\n                        \n                      )) : (\n                        {renderCellValue(row, 80)}\n                      )}\n                    \n                  ))}\n                \n              \n            \n            {overflow > 0 && +{overflow} more rows}\n          \n        )}\n      \n    \n  );\n}\n\n// ── Section ─────────────────────────────────────────────────────────────────\n\nfunction SectionSurface({ surface, ctx }: { surface: SurfaceSection; ctx: SurfaceContext }) {\n  return (\n    \n      {surface.label && {surface.label}}\n      \n        {surface.surfaces.map(s => (\n          \n        ))}\n      
\n    \n  );\n}\n\n// ── Main renderer ───────────────────────────────────────────────────────────\n\nexport interface SurfaceContext {\n  /** Resolved views: id + value + description + render hint */\n  views: SurfaceView[];\n  /** Actions with availability resolved */\n  actions: SurfaceAction[];\n  /** Messages sorted by sort_key */\n  messages: SurfaceMessage[];\n  /** State entries for watch surfaces */\n  state: SurfaceStateEntry[];\n  /** Agent display names */\n  agentMap: Record;\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n  evalCel: (expr: string) => boolean;\n  /** When true, hides action surfaces and feed compose (e.g. replay mode). */\n  readOnly?: boolean;\n}\n\nexport function SurfaceRenderer({ surface, ctx }: { surface: Surface; ctx: SurfaceContext }) {\n  // Check enabled expression\n  if (surface.enabled && !ctx.evalCel(surface.enabled)) return null;\n\n  switch (surface.type) {\n    case \"metric\":\n      return ;\n    case \"view-grid\":\n      return ;\n    case \"view-table\":\n      return ;\n    case \"array-table\": {\n      const view = ctx.views.find(v => v.id === (surface as SurfaceArrayTable).view);\n      return view ?  : null;\n    }\n    case \"action-bar\":\n      if (ctx.readOnly) return null;\n      return ;\n    case \"action-form\":\n      if (ctx.readOnly) return null;\n      return ;\n    case \"action-choice\":\n      if (ctx.readOnly) return null;\n      return ;\n    case \"feed\":\n      return ;\n    case \"watch\":\n      return ;\n    case \"section\":\n      return ;\n    case \"markdown\":\n      return ;\n    default:\n      return null;\n  }\n}\n\nexport function SurfacesView({ surfaces, ctx }: { surfaces: Surface[]; ctx: SurfaceContext }) {\n  return (\n    \n      {surfaces.map(s => (\n        \n      ))}\n    
\n  );\n}\n",[],[418,1221,1295,1297],"89c612d2-2198-11f1-9238-42dde27851f2","State.tsx","7834757c-13fb-11f1-b99c-42dde27851f2",["D",1773707445460],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState, useRef, useMemo } from \"https://esm.sh/react@18.2.0\";\nimport { styled, keyframes } from \"../../styled.ts\";\nimport type { StateRow, Agent, TokenKind } from \"../../types.ts\";\nimport { JsonView } from \"../JsonView.tsx\";\nimport { rel } from \"../../utils.ts\";\n\nconst flash = keyframes`\n  from { background: rgba(88,166,255,0.12); }\n  to   { background: transparent; }\n`;\n\nconst ScopeGroup = styled.div`margin-bottom: 0.75rem;`;\n\nconst ScopeHeader = styled.div<{ $closed: boolean }>`\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  cursor: pointer;\n  padding: 0.3rem 0.5rem;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: ${p => p.$closed ? \"4px\" : \"4px 4px 0 0\"};\n  font-size: 12px;\n  user-select: none;\n`;\n\nconst Arrow = styled.span<{ $closed: boolean }>`\n  font-size: 10px;\n  color: var(--dim);\n  display: inline-block;\n  transition: transform 0.15s;\n  transform: ${p => p.$closed ? \"rotate(-90deg)\" : \"rotate(0deg)\"};\n`;\n\nconst ScopeName = styled.span<{ $type: \"shared\" | \"system\" | \"agent\" }>`\n  font-weight: 600;\n  color: ${p => p.$type === \"shared\" ? \"var(--yellow)\" : p.$type === \"system\" ? \"var(--orange)\" : \"var(--accent)\"};\n`;\n\nconst ScopeCount = styled.span`color: var(--dim); font-size: 11px;`;\nconst PrivateLabel = styled.span`font-size: 10px; margin-left: auto; color: var(--red);`;\n\nconst ScopeBody = styled.div<{ $hidden: boolean }>`\n  display: ${p => p.$hidden ? \"none\" : \"block\"};\n  border: 1px solid var(--border);\n  border-top: none;\n  border-radius: 0 0 4px 4px;\n  overflow: hidden;\n`;\n\nconst StateRowEl = styled.div<{ $flash: boolean }>`\n  display: grid;\n  grid-template-columns: 140px 1fr auto;\n  gap: 0.5rem;\n  padding: 0.3rem 0.5rem;\n  font-size: 12px;\n  border-bottom: 1px solid var(--border);\n  align-items: start;\n  animation: ${p => p.$flash ? flash : \"none\"} 0.6s ease-out;\n  &:last-child { border-bottom: none; }\n  @media (max-width: 480px) {\n    grid-template-columns: 1fr;\n    gap: 2px;\n  }\n`;\n\nconst StateKey = styled.div`color: var(--green); font-weight: 500; word-break: break-word;`;\nconst SortKey = styled.div`color: var(--dim); font-size: 10px;`;\nconst TimerInfo = styled.div<{ $purple?: boolean }>`\n  font-size: 10px;\n  color: ${p => p.$purple ? \"var(--purple)\" : \"var(--orange)\"};\n  margin-top: 2px;\n`;\n\n// ── v9: Meta annotations ──\nconst MetaRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 0.5rem;\n  font-size: 10px;\n  color: var(--dim);\n  margin-top: 2px;\n  flex-wrap: wrap;\n`;\n\nconst MetaWriter = styled.span`color: var(--orange);`;\nconst MetaVia = styled.span`color: var(--purple);`;\nconst MetaVelocity = styled.span<{ $high: boolean }>`\n  color: ${p => p.$high ? \"var(--yellow)\" : \"var(--dim)\"};\n`;\n\nconst ScoreBar = styled.div<{ $pct: number }>`\n  display: inline-block;\n  width: 40px;\n  height: 4px;\n  background: var(--border);\n  border-radius: 2px;\n  position: relative;\n  overflow: hidden;\n  &::after {\n    content: '';\n    position: absolute;\n    left: 0;\n    top: 0;\n    height: 100%;\n    width: ${p => p.$pct}%;\n    background: var(--accent);\n    border-radius: 2px;\n    opacity: 0.7;\n  }\n`;\n\nconst RightCol = styled.div`\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n  gap: 2px;\n  min-width: 50px;\n  @media (max-width: 480px) {\n    flex-direction: row;\n    align-items: center;\n    gap: 6px;\n  }\n`;\n\nconst Version = styled.div`\n  color: var(--dim);\n  text-align: right;\n  font-size: 11px;\n`;\n\nconst ScoreText = styled.div`\n  color: var(--dim);\n  font-size: 9px;\n  text-align: right;\n`;\n\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\nconst Wrap = styled.div<{ $dimmed?: boolean }>`\n  opacity: ${p => p.$dimmed ? 0.4 : 1};\n`;\n\nfunction canSeeScope(scope: string, tokenKind: TokenKind | null, viewingId: string | undefined, agentMap: Record): boolean {\n  if (tokenKind === \"room\" && !viewingId) return true;\n  const aid = viewingId;\n  if (!aid) return true;\n  if (scope.startsWith(\"_\")) return true;\n  if (scope === aid) return true;\n  const ag = agentMap[aid];\n  if (ag) {\n    try {\n      const g = JSON.parse(ag.grants || \"[]\");\n      if (g.includes(scope) || g.includes(\"*\")) return true;\n    } catch {}\n  }\n  return false;\n}\n\nfunction ScopeGroupPanel({ scope, entries, visible, prevVersions }: {\n  scope: string;\n  entries: StateRow[];\n  visible: boolean;\n  prevVersions: React.MutableRefObject>;\n}) {\n  const stype = scope === \"_shared\" ? \"shared\" : scope.startsWith(\"_\") ? \"system\" : \"agent\";\n  const [collapsed, setCollapsed] = useState(!scope.startsWith(\"_\") && scope !== \"_shared\");\n\n  // Sort by score (high first) within scope if _meta available\n  const sorted = useMemo(() => {\n    return [...entries].sort((a, b) => {\n      const sa = a._meta?.score ?? 0;\n      const sb = b._meta?.score ?? 0;\n      if (sb !== sa) return sb - sa;\n      return String(a.key).localeCompare(String(b.key));\n    });\n  }, [entries]);\n\n  return (\n    \n       setCollapsed(c => !c)}>\n        ▼\n        {scope}\n        ({entries.length})\n        {!visible && 🔒 private}\n      \n      \n        {sorted.map(s => {\n          const vk = `${scope}.${s.key}`;\n          const changed = prevVersions.current[vk] !== undefined && prevVersions.current[vk] !== s.version;\n          prevVersions.current[vk] = s.version;\n          const m = s._meta;\n          const scorePct = m ? Math.round(m.score * 100) : 0;\n\n          return (\n            \n              \n                \n                  {s.key}\n                  {s.sort_key != null && #{s.sort_key}}\n                  {s.timer_effect && (\n                    \n                      ⏱ {s.timer_effect}\n                      {s.timer_expires_at ? ` · ${rel(s.timer_expires_at)}` : s.timer_ticks_left != null ? ` · ${s.timer_ticks_left} ticks` : \"\"}\n                    \n                  )}\n                  {s.enabled_expr && ☑ {s.enabled_expr}}\n                \n                {m && (m.writer || m.via || m.velocity > 0.1) && (\n                  \n                    {m.writer && ← {m.writer}}\n                    {m.via && via {m.via}}\n                    {m.velocity > 0.1 &&  0.3}>⚡ {m.velocity.toFixed(2)}}\n                    {m.writers && m.writers.length > 1 && (\n                      {m.writers.length} writers\n                    )}\n                  \n                )}\n              
\n              \n              \n                r{s.version}\n                {m && }\n                {m && scorePct > 0 && .{String(scorePct).padStart(2, '0')}}\n              \n            \n          );\n        })}\n      \n    \n  );\n}\n\ninterface StatePanelProps {\n  rows: StateRow[];\n  agentMap: Record;\n  viewingId?: string;\n  tokenKind: TokenKind | null;\n}\n\nexport function StatePanel({ rows, agentMap, viewingId, tokenKind }: StatePanelProps) {\n  const prevVersions = useRef>({});\n\n  if (!rows.length) return no state;\n\n  const scopes: Record = {};\n  for (const s of rows) {\n    if (!scopes[s.scope]) scopes[s.scope] = [];\n    scopes[s.scope].push(s);\n  }\n\n  const order = Object.keys(scopes).sort((a, b) => {\n    if (a === \"_shared\") return -1;\n    if (b === \"_shared\") return 1;\n    if (a.startsWith(\"_\") && !b.startsWith(\"_\")) return -1;\n    if (!a.startsWith(\"_\") && b.startsWith(\"_\")) return 1;\n    return a.localeCompare(b);\n  });\n\n  return (\n    \n      {order.map(scope => (\n        \n      ))}\n    
\n  );\n}\n",[],[418,1221,1295,1304],"ca318b6e-1ebc-11f1-8cee-42dde27851f2","Messages.tsx","7834572c-13fb-11f1-b99c-42dde27851f2",562,["D",1773393162002],17,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useEffect, useRef, useState, useCallback } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\nimport type { RawMessage, Agent } from \"../../types.ts\";\nimport { aname, rel, relTo, tryParseJson } from \"../../utils.ts\";\n\nconst Wrap = styled.div`display: flex; flex-direction: column; gap: 0;`;\nconst Log = styled.div`display: flex; flex-direction: column; gap: 1px; overflow-y: auto;`;\n\nconst Row = styled.div`\n  display: grid;\n  grid-template-columns: 90px 1fr auto;\n  gap: 0.5rem;\n  padding: 4px 8px;\n  font-size: 12px;\n  background: var(--surface);\n  border-radius: 2px;\n  &:hover { background: var(--surface2); }\n  @media (max-width: 480px) {\n    grid-template-columns: 1fr;\n    gap: 2px;\n    padding: 6px 8px;\n  }\n`;\n\nconst From = styled.div`\n  color: var(--accent);\n  font-weight: 600;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n`;\n\nconst Body = styled.div`color: var(--fg); word-break: break-word; min-width: 0;`;\n\nconst KIND_COLOR: Record = {\n  task: \"rgba(210,153,34,0.2)/var(--yellow)\",\n  action_invocation: \"rgba(188,140,255,0.2)/var(--purple)\",\n  result: \"rgba(63,185,80,0.2)/var(--green)\",\n};\n\nconst KindTag = styled.span<{ $kind: string }>`\n  display: inline-block;\n  background: ${p => (KIND_COLOR[p.$kind] ?? \"var(--border)/var(--dim)\").split(\"/\")[0]};\n  color: ${p => (KIND_COLOR[p.$kind] ?? \"var(--border)/var(--dim)\").split(\"/\")[1]};\n  border-radius: 2px;\n  padding: 0 4px;\n  font-size: 10px;\n  margin-right: 4px;\n`;\n\nconst ClaimedBy = styled.span`color: var(--green); font-size: 10px; margin-left: 4px;`;\nconst MdSpan = styled.span`display: inline;`;\nconst LogMeta = styled.div`\n  color: var(--dim);\n  font-size: 11px;\n  white-space: nowrap;\n  text-align: right;\n  @media (max-width: 480px) {\n    text-align: left;\n    font-size: 10px;\n  }\n`;\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\n\n// ── Send bar ────────────────────────────────────────────────────────────────\n\nconst SendBar = styled.div`\n  display: flex;\n  gap: 0.4rem;\n  padding: 0.5rem 0;\n  margin-top: 0.5rem;\n  border-top: 1px solid var(--border);\n  @media (max-width: 480px) {\n    flex-wrap: wrap;\n  }\n`;\n\nconst MsgInput = styled.input`\n  flex: 1;\n  min-width: 0;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 4px;\n  padding: 0.4rem 0.6rem;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 12px;\n  outline: none;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst KindSelect = styled.select`\n  background: var(--bg);\n  border: 1px solid var(--border);\n  border-radius: 4px;\n  color: var(--dim);\n  font-family: inherit;\n  font-size: 11px;\n  padding: 0 4px;\n  outline: none;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst SendBtn = styled.button`\n  background: var(--accent);\n  color: var(--bg);\n  border: none;\n  border-radius: 4px;\n  padding: 0.4rem 0.8rem;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 600;\n  white-space: nowrap;\n  &:hover { opacity: 0.85; }\n  &:disabled { background: var(--border); color: var(--dim); cursor: not-allowed; }\n`;\n\nconst SendError = styled.div`\n  color: var(--red);\n  font-size: 11px;\n  padding: 2px 0;\n`;\n\ninterface MessagesPanelProps {\n  messages: RawMessage[];\n  agentMap: Record;\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n  /** When false, disables auto-scroll entirely (e.g. in replay mode). Default true. */\n  autoScroll?: boolean;\n  /** When true, hides the send bar (e.g. in replay mode). */\n  readOnly?: boolean;\n  /** When set, timestamps display as +Xs relative to this epoch instead of relative to now. */\n  epochMs?: number;\n}\n\n// Threshold in px — if the user has scrolled up more than this, don't auto-scroll.\nconst SCROLL_THRESHOLD = 80;\n\nexport function MessagesPanel({ messages, agentMap, roomId, baseUrl, authHeaders, autoScroll = true, readOnly = false, epochMs }: MessagesPanelProps) {\n  const logRef = useRef(null);\n  const bottomRef = useRef(null);\n  const [msgText, setMsgText] = useState(\"\");\n  const [msgKind, setMsgKind] = useState(\"chat\");\n  const [sending, setSending] = useState(false);\n  const [error, setError] = useState(\"\");\n\n  useEffect(() => {\n    if (!autoScroll) return;\n    const log = logRef.current;\n    if (!log) return;\n    // Only scroll if the user is already near the bottom\n    const distanceFromBottom = log.scrollHeight - log.scrollTop - log.clientHeight;\n    if (distanceFromBottom <= SCROLL_THRESHOLD) {\n      bottomRef.current?.scrollIntoView({ behavior: \"instant\" });\n    }\n  }, [messages.length, autoScroll]);\n\n  const sendMessage = useCallback(async () => {\n    const body = msgText.trim();\n    if (!body) return;\n    setSending(true);\n    setError(\"\");\n    try {\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/actions/_send_message/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: { body, kind: msgKind } }),\n      });\n      const d = await r.json();\n      if (d.error) {\n        setError(d.message || d.error);\n      } else {\n        setMsgText(\"\");\n      }\n    } catch (e: any) {\n      setError(e.message);\n    } finally {\n      setSending(false);\n    }\n  }, [msgText, msgKind, roomId, baseUrl, authHeaders]);\n\n  return (\n    \n      {!messages.length && no messages}\n      {messages.length > 0 && (\n        \n          {messages.map(m => {\n            let v = tryParseJson(m.value);\n            if (typeof v !== \"object\" || v === null) v = { body: String(m.value) };\n            const kind = v.kind || \"msg\";\n            const from = v.from || \"system\";\n            const body = typeof v.body === \"string\" ? v.body : JSON.stringify(v.body || v);\n\n            return (\n              \n                {aname(from, agentMap)}\n                \n                  {kind}\n                  {v.claimed_by && ✓{aname(v.claimed_by, agentMap)}}\n                  {\" \"}\n                  \n                \n                #{m.sort_key} · {epochMs != null ? relTo(m.updated_at, epochMs) : rel(m.updated_at)}\n              \n            );\n          })}\n          \n        \n      )}\n      {!readOnly && (\n        \n           setMsgKind(e.target.value)}>\n            \n            \n            \n            \n          \n           setMsgText(e.target.value)}\n            onKeyDown={e => e.key === \"Enter\" && !sending && sendMessage()}\n            spellCheck={false}\n          />\n          \n            {sending ? \"…\" : \"send\"}\n          \n        \n      )}\n      {!readOnly && error && {error}}\n    \n  );\n}\n\nfunction renderMarkdown(text: string): string {\n  if (typeof (globalThis as any).marked !== \"undefined\") {\n    return (globalThis as any).marked.parse(text, { breaks: true, gfm: true });\n  }\n  // SSR-safe fallback: escape HTML without document.createElement\n  return text\n    .replace(/&/g, \"&\").replace(//g, \">\")\n    .replace(/\\n/g, \"
\");\n}\n",[],[418,1221,1295,1311],"1267b874-1411-11f1-bca4-42dde27851f2","Cel.tsx","78343d8c-13fb-11f1-b99c-42dde27851f2",["D",1772219898048],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState, useCallback } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\n\nconst Wrap = styled.div``;\n\nconst Console = styled.div`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  padding: 0.75rem;\n  margin-top: 0.5rem;\n`;\n\nconst InputRow = styled.div`display: flex; gap: 0.5rem; @media (max-width: 480px) { flex-wrap: wrap; }`;\n\nconst CelInput = styled.input`\n  flex: 1;\n  min-width: 0;\n  background: var(--bg);\n  border: 1px solid var(--border);\n  border-radius: 4px;\n  padding: 0.4rem 0.6rem;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 12px;\n  outline: none;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst EvalBtn = styled.button`\n  background: var(--accent);\n  color: var(--bg);\n  border: none;\n  border-radius: 4px;\n  padding: 0.4rem 0.8rem;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 600;\n`;\n\nconst CelOutput = styled.div<{ $status: \"idle\" | \"loading\" | \"ok\" | \"error\" }>`\n  margin-top: 0.5rem;\n  padding: 0.5rem;\n  background: var(--bg);\n  border-radius: 4px;\n  font-size: 12px;\n  white-space: pre-wrap;\n  word-break: break-word;\n  max-height: 300px;\n  overflow-y: auto;\n  display: ${p => p.$status === \"idle\" ? \"none\" : \"block\"};\n  color: ${p => p.$status === \"error\" ? \"var(--red)\" : p.$status === \"ok\" ? \"var(--green)\" : \"var(--dim)\"};\n`;\n\nconst History = styled.div`margin-top: 0.5rem; display: flex; flex-wrap: wrap; gap: 4px;`;\n\nconst HistBtn = styled.button`\n  background: var(--border);\n  border: none;\n  border-radius: 3px;\n  padding: 2px 6px;\n  font-size: 10px;\n  color: var(--dim);\n  cursor: pointer;\n  font-family: inherit;\n  &:hover { color: var(--accent); }\n`;\n\nconst QuickLinks = styled.div`margin-top: 0.6rem; color: var(--dim); font-size: 11px;`;\nconst QuickLink = styled.span<{ $purple?: boolean }>`\n  cursor: pointer;\n  color: ${p => p.$purple ? \"var(--purple)\" : \"var(--accent)\"};\n`;\n\nconst QUICK = [\n  { label: \"_shared\", expr: \"state._shared\" },\n  { label: \"views\", expr: \"views\", purple: true },\n  { label: \"agents\", expr: \"agents\" },\n  { label: \"messages\", expr: \"messages\" },\n  { label: \"actions\", expr: \"actions\" },\n  { label: \"all state\", expr: \"state\" },\n];\n\ninterface CelPanelProps {\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n}\n\ntype CelStatus = \"idle\" | \"loading\" | \"ok\" | \"error\";\n\nexport function CelPanel({ roomId, baseUrl, authHeaders }: CelPanelProps) {\n  const [expr, setExpr] = useState(\"\");\n  const [output, setOutput] = useState(\"\");\n  const [status, setStatus] = useState(\"idle\");\n  const [history, setHistory] = useState([]);\n\n  const runCel = useCallback(async (e?: string) => {\n    const x = e || expr.trim();\n    if (!x) return;\n    if (e) setExpr(e);\n    setStatus(\"loading\");\n    setOutput(\"evaluating…\");\n    try {\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/eval`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ expr: x }),\n      });\n      const d = await r.json();\n      if (d.error) {\n        setStatus(\"error\");\n        setOutput(d.detail || d.error);\n      } else {\n        setStatus(\"ok\");\n        setOutput(JSON.stringify(d.value, null, 2));\n      }\n      setHistory(h => [x, ...h.filter(i => i !== x)].slice(0, 12));\n    } catch (err: any) {\n      setStatus(\"error\");\n      setOutput(\"error: \" + err.message);\n    }\n  }, [expr, roomId, baseUrl, authHeaders]);\n\n  return (\n    \n      \n        \n           setExpr(e.target.value)}\n            onKeyDown={e => e.key === \"Enter\" && runCel()}\n            placeholder=\"state._shared.phase\"\n            spellCheck={false}\n          />\n           runCel()}>Eval\n        \n        {history.length > 0 && (\n          \n            {history.map(h => (\n               runCel(h)}>\n                {h.length > 35 ? h.slice(0, 35) + \"…\" : h}\n              \n            ))}\n          \n        )}\n        {output}\n      \n      \n        Quick:{\" \"}\n        {QUICK.map((q, i) => (\n          \n             runCel(q.expr)}>{q.label}\n            {i < QUICK.length - 1 && \" · \"}\n          \n        ))}\n      \n    \n  );\n}\n",[],[418,1221,1295,1320],"d30263dc-1410-11f1-8e9e-42dde27851f2","Audit.tsx","78342b12-13fb-11f1-b99c-42dde27851f2",167,["D",1772219791729],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useEffect, useRef } from \"https://esm.sh/react@18.2.0\";\nimport { styled } from \"../../styled.ts\";\nimport type { AuditRow, Agent } from \"../../types.ts\";\nimport { aname, tryParseJson } from \"../../utils.ts\";\n\nconst Log = styled.div`display: flex; flex-direction: column; gap: 1px; overflow-y: auto;`;\n\nconst Row = styled.div`\n  display: grid;\n  grid-template-columns: 90px 1fr auto;\n  gap: 0.5rem;\n  padding: 4px 8px;\n  font-size: 12px;\n  background: var(--surface);\n  border-radius: 2px;\n  &:hover { background: var(--surface2); }\n  @media (max-width: 480px) {\n    grid-template-columns: 1fr;\n    gap: 2px;\n    padding: 6px 8px;\n  }\n`;\n\nconst From = styled.div`\n  color: var(--accent);\n  font-weight: 600;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n`;\n\nconst Body = styled.div`color: var(--fg); word-break: break-word; min-width: 0;`;\n\nconst OkIcon = styled.span`color: var(--green); font-size: 10px;`;\nconst FailIcon = styled.span`color: var(--red); font-size: 10px;`;\n\nconst ActionTag = styled.span`\n  display: inline-block;\n  background: rgba(188,140,255,0.2);\n  color: var(--purple);\n  border-radius: 2px;\n  padding: 0 4px;\n  font-size: 10px;\n  margin-right: 4px;\n`;\n\nconst BuiltinLabel = styled.span`color: var(--dim); font-size: 10px; margin-left: 4px;`;\nconst LogMeta = styled.div`\n  color: var(--dim);\n  font-size: 11px;\n  white-space: nowrap;\n  text-align: right;\n  @media (max-width: 480px) {\n    text-align: left;\n    font-size: 10px;\n  }\n`;\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\n\ninterface AuditPanelProps {\n  audit: AuditRow[];\n  agentMap: Record;\n}\n\nexport function AuditPanel({ audit, agentMap }: AuditPanelProps) {\n  const bottomRef = useRef(null);\n\n  useEffect(() => {\n    bottomRef.current?.scrollIntoView({ behavior: \"smooth\" });\n  }, [audit.length]);\n\n  if (!audit.length) return no audit entries;\n\n  return (\n    \n      {audit.map(a => {\n        let v = tryParseJson(a.value);\n        if (typeof v !== \"object\" || v === null) v = { action: \"?\", agent: \"?\" };\n        const action = v.action || \"?\";\n        const agent = v.agent || \"system\";\n        const ok = v.ok !== false;\n        const ts = v.ts ? (v.ts.split(\"T\")[1]?.slice(0, 8) || \"\") : \"\";\n        const paramsStr = v.params\n          ? Object.entries(v.params as Record)\n              .filter(([, val]) => val !== undefined && val !== null)\n              .map(([k, val]) => `${k}=${typeof val === \"string\" ? val : JSON.stringify(val)}`)\n              .join(\", \")\n          : \"\";\n        const display = paramsStr.length > 300 ? paramsStr.slice(0, 300) + \"…\" : paramsStr;\n\n        return (\n          \n            \n              {ok ? ✓ : ✗}\n              {\" \"}{aname(agent, agentMap)}\n            \n            \n              {action}\n              {v.builtin && builtin}\n              {\" \"}{display}\n            \n            #{a.sort_key} · {ts}\n          \n        );\n      })}\n      \n    \n  );\n}\n",[],[418,1221,1295,1327],"edd6ce08-1ebc-11f1-aeb1-42dde27851f2","Agents.tsx","78341b4a-13fb-11f1-b99c-42dde27851f2",571,["D",1773393221800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { styled } from \"../../styled.ts\";\nimport type { Agent } from \"../../types.ts\";\nimport { rel, relTo, hbc, hbcAt } from \"../../utils.ts\";\n\nconst Grid = styled.div`display: flex; flex-wrap: wrap; gap: 0.5rem;`;\n\nconst Card = styled.div<{ $viewing?: boolean }>`\n  background: var(--surface);\n  border: 1px solid ${p => p.$viewing ? \"var(--accent)\" : \"var(--border)\"};\n  box-shadow: ${p => p.$viewing ? \"0 0 0 1px var(--accent)\" : \"none\"};\n  border-radius: 6px;\n  padding: 0.5rem 0.7rem;\n  min-width: 160px;\n  flex: 0 0 auto;\n  @media (max-width: 480px) {\n    flex: 1 1 100%;\n    min-width: 0;\n  }\n`;\n\nconst STATUS_BG: Record = {\n  active: \"rgba(63,185,80,0.15)\", waiting: \"rgba(210,153,34,0.15)\",\n  done: \"rgba(88,166,255,0.15)\",\n};\nconst STATUS_FG: Record = {\n  active: \"var(--green)\", waiting: \"var(--yellow)\",\n  done: \"var(--accent)\",\n};\n\nconst Badge = styled.span<{ $status: string }>`\n  display: inline-block;\n  font-size: 10px;\n  padding: 1px 6px;\n  border-radius: 3px;\n  font-weight: 600;\n  text-transform: uppercase;\n  letter-spacing: 0.03em;\n  background: ${p => STATUS_BG[p.$status] ?? \"rgba(248,81,73,0.15)\"};\n  color: ${p => STATUS_FG[p.$status] ?? \"var(--red)\"};\n`;\n\nconst AgentName = styled.div`color: var(--accent); font-weight: 600; font-size: 12px;`;\nconst Sub = styled.div`color: var(--dim); font-size: 11px;`;\nconst WaitingOn = styled.div`color: var(--yellow); font-size: 11px;`;\nconst Grants = styled.div`font-size: 10px; color: var(--purple); margin-top: 2px;`;\nconst Heartbeat = styled.div<{ $cls: \"\" | \"stale\" | \"dead\" }>`\n  font-size: 10px;\n  margin-top: 2px;\n  color: ${p => p.$cls === \"stale\" ? \"var(--yellow)\" : p.$cls === \"dead\" ? \"var(--red)\" : \"var(--dim)\"};\n`;\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\n\ninterface AgentsPanelProps {\n  agents: Agent[];\n  viewingId?: string;\n  /** When set, heartbeat timestamps display as +Xs relative to this epoch. */\n  epochMs?: number;\n  /** Current replay playhead ms — used for heartbeat staleness in replay. */\n  playheadMs?: number;\n}\n\nexport function AgentsPanel({ agents, viewingId, epochMs, playheadMs }: AgentsPanelProps) {\n  if (!agents.length) return no agents;\n\n  return (\n    \n      {agents.map(a => {\n        const sc = a.status || \"active\";\n        const hbClass = playheadMs != null ? hbcAt(a.last_heartbeat, playheadMs) : hbc(a.last_heartbeat);\n        let grants: string[] = [];\n        try { grants = JSON.parse(a.grants || \"[]\"); } catch {}\n\n        return (\n          \n            {sc}
\n            {a.name}\n            _{{a.role} · {a.id}}\n            {a.waiting_on && ⏳ {a.waiting_on}}\n            {grants.length > 0 && grants: {grants.join(\", \")}}\n            {epochMs != null ? relTo(a.last_heartbeat, epochMs) : rel(a.last_heartbeat)}\n          \n        );\n      })}\n    \n  );\n}\n",[],[418,1221,1295,1335],"df1821a0-1ebc-11f1-b4e6-42dde27851f2","Actions.tsx","78340be6-13fb-11f1-b99c-42dde27851f2",567,["D",1773393197068],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState, useCallback } from \"https://esm.sh/react@18.2.0\";\nimport { styled, keyframes } from \"../../styled.ts\";\nimport type { Action } from \"../../types.ts\";\n\nconst Grid = styled.div`\n  display: flex;\n  flex-wrap: wrap;\n  gap: 0.5rem;\n`;\n\nconst Card = styled.div<{ $available: boolean }>`\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 6px;\n  padding: 0.6rem 0.8rem;\n  min-width: 0;\n  flex: 1 1 300px;\n  max-width: 460px;\n  opacity: ${p => p.$available ? 1 : 0.6};\n  @media (max-width: 480px) {\n    flex: 1 1 100%;\n    max-width: 100%;\n  }\n`;\n\nconst ActionHeader = styled.div`\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 0.5rem;\n`;\n\nconst ActionName = styled.div<{ $available: boolean }>`\n  font-weight: 600;\n  font-size: 13px;\n  color: ${p => p.$available ? \"var(--green)\" : \"var(--dim)\"};\n  word-break: break-word;\n  min-width: 0;\n`;\n\nconst InvokeBtn = styled.button<{ $disabled?: boolean }>`\n  background: ${p => p.$disabled ? \"var(--border)\" : \"var(--green)\"};\n  color: ${p => p.$disabled ? \"var(--dim)\" : \"var(--bg)\"};\n  border: none;\n  border-radius: 4px;\n  padding: 2px 8px;\n  cursor: ${p => p.$disabled ? \"not-allowed\" : \"pointer\"};\n  font-family: inherit;\n  font-size: 11px;\n  font-weight: 600;\n  white-space: nowrap;\n  flex-shrink: 0;\n  &:hover {\n    opacity: ${p => p.$disabled ? 1 : 0.85};\n  }\n`;\n\nconst Desc = styled.div`color: var(--dim); font-size: 11px; margin-top: 2px; word-break: break-word;`;\nconst IfExpr = styled.div`font-size: 11px; color: var(--purple); margin-top: 3px; font-style: italic; word-break: break-word;`;\nconst WritesInfo = styled.div`font-size: 11px; color: var(--green); margin-top: 3px; word-break: break-word;`;\nconst Meta = styled.div`font-size: 10px; color: var(--dim); margin-top: 4px; word-break: break-word;`;\nconst Empty = styled.div`color: var(--dim); font-style: italic; padding: 1rem; text-align: center;`;\n\n// ── Invoke form ─────────────────────────────────────────────────────────────\n\nconst FormWrap = styled.div`\n  margin-top: 6px;\n  padding: 6px 8px;\n  background: var(--bg);\n  border-radius: 4px;\n  border: 1px solid var(--border);\n`;\n\nconst ParamRow = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin-bottom: 4px;\n  font-size: 11px;\n  @media (max-width: 480px) {\n    flex-wrap: wrap;\n  }\n`;\n\nconst ParamLabel = styled.label`\n  color: var(--accent);\n  font-weight: 600;\n  min-width: 70px;\n  white-space: nowrap;\n  @media (max-width: 480px) {\n    min-width: 0;\n  }\n`;\n\nconst ParamInput = styled.input`\n  flex: 1;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 3px;\n  padding: 3px 6px;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 11px;\n  outline: none;\n  min-width: 0;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst ParamSelect = styled.select`\n  flex: 1;\n  background: var(--surface);\n  border: 1px solid var(--border);\n  border-radius: 3px;\n  padding: 3px 6px;\n  color: var(--fg);\n  font-family: inherit;\n  font-size: 11px;\n  outline: none;\n  min-width: 0;\n  &:focus { border-color: var(--accent); }\n`;\n\nconst ParamHint = styled.span`\n  color: var(--dim);\n  font-size: 10px;\n  white-space: nowrap;\n`;\n\nconst FormActions = styled.div`\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin-top: 6px;\n`;\n\nconst SendBtn = styled.button`\n  background: var(--green);\n  color: var(--bg);\n  border: none;\n  border-radius: 4px;\n  padding: 3px 10px;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 11px;\n  font-weight: 600;\n  &:hover { opacity: 0.85; }\n  &:disabled { background: var(--border); color: var(--dim); cursor: not-allowed; }\n`;\n\nconst CancelBtn = styled.button`\n  background: none;\n  border: 1px solid var(--border);\n  border-radius: 4px;\n  padding: 3px 8px;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 11px;\n  color: var(--dim);\n  &:hover { color: var(--fg); border-color: var(--dim); }\n`;\n\nconst flash = keyframes`\n  from { background: rgba(63,185,80,0.15); }\n  to { background: transparent; }\n`;\n\nconst ResultBox = styled.div<{ $error?: boolean }>`\n  margin-top: 6px;\n  padding: 4px 8px;\n  border-radius: 3px;\n  font-size: 11px;\n  white-space: pre-wrap;\n  word-break: break-word;\n  max-height: 150px;\n  overflow-y: auto;\n  color: ${p => p.$error ? \"var(--red)\" : \"var(--green)\"};\n  background: ${p => p.$error ? \"rgba(248,81,73,0.08)\" : \"rgba(63,185,80,0.08)\"};\n  animation: ${flash} 0.5s ease-out;\n`;\n\n// ── Action Card Component ───────────────────────────────────────────────────\n\ninterface ActionCardProps {\n  action: Action;\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n  readOnly?: boolean;\n}\n\nfunction ActionCard({ action, roomId, baseUrl, authHeaders, readOnly }: ActionCardProps) {\n  const av = action.available !== false;\n  const paramDefs = action.params || {};\n  const paramKeys = Object.keys(paramDefs);\n  const writes = action.writes || [];\n  const isBuiltin = action.id.startsWith(\"_\") || action.id === \"help\";\n\n  const [expanded, setExpanded] = useState(false);\n  const [params, setParams] = useState>({});\n  const [sending, setSending] = useState(false);\n  const [result, setResult] = useState<{ ok: boolean; text: string } | null>(null);\n\n  const setParam = useCallback((key: string, val: string) => {\n    setParams(p => ({ ...p, [key]: val }));\n  }, []);\n\n  const doInvoke = useCallback(async () => {\n    setSending(true);\n    setResult(null);\n    try {\n      // Coerce param values based on type hints\n      const coerced: Record = {};\n      for (const [k, v] of Object.entries(params)) {\n        if (v === \"\" || v === undefined) continue;\n        const def = paramDefs[k];\n        if (def?.type === \"number\") {\n          const n = Number(v);\n          coerced[k] = isNaN(n) ? v : n;\n        } else if (def?.type === \"boolean\") {\n          coerced[k] = v === \"true\";\n        } else {\n          // Try JSON parse for object/array types\n          if (def?.type === \"object\" || def?.type === \"array\" || def?.type === \"any\") {\n            try { coerced[k] = JSON.parse(v); } catch { coerced[k] = v; }\n          } else {\n            coerced[k] = v;\n          }\n        }\n      }\n\n      const r = await fetch(`${baseUrl}/rooms/${roomId}/actions/${action.id}/invoke`, {\n        method: \"POST\",\n        headers: { ...authHeaders(), \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ params: coerced }),\n      });\n      const d = await r.json();\n      if (d.error) {\n        setResult({ ok: false, text: d.message || d.error + (d.detail ? `: ${d.detail}` : \"\") });\n      } else {\n        const text = d.result !== undefined\n          ? `✓ ${typeof d.result === \"string\" ? d.result : JSON.stringify(d.result, null, 2)}`\n          : \"✓ invoked\";\n        setResult({ ok: true, text });\n      }\n    } catch (e: any) {\n      setResult({ ok: false, text: e.message });\n    } finally {\n      setSending(false);\n    }\n  }, [params, paramDefs, action.id, roomId, baseUrl, authHeaders]);\n\n  const toggleForm = useCallback(() => {\n    if (!expanded) {\n      // Initialize defaults\n      const defaults: Record = {};\n      for (const [k, def] of Object.entries(paramDefs)) {\n        if (def.enum?.length) defaults[k] = String(def.enum[0]);\n        else defaults[k] = \"\";\n      }\n      setParams(defaults);\n      setResult(null);\n    }\n    setExpanded(e => !e);\n  }, [expanded, paramDefs]);\n\n  return (\n    \n      \n        \n          {av ? \"● \" : \"○ \"}{action.id}\n        \n        {!isBuiltin && !readOnly && (\n          \n            {expanded ? \"close\" : \"invoke\"}\n          \n        )}\n      \n      {action.description && {action.description}}\n      {action.if && if: {action.if}}\n      {paramKeys.length > 0 && !expanded && (\n        \n          params: {paramKeys.map(p => `${p}(${paramDefs[p].type || \"?\"})`).join(\", \")}\n        \n      )}\n      {writes.length > 0 && (\n        \n          → {writes.map(w => `${w.scope || \"_shared\"}${w.append ? \"[+]\" : w.merge ? \"[~]\" : \"\"}`).join(\", \")}\n        \n      )}\n\n      {expanded && (\n        \n          {paramKeys.length > 0 ? paramKeys.map(k => {\n            const def = paramDefs[k];\n            return (\n              \n                {k}\n                {def.enum ? (\n                   setParam(k, e.target.value)}\n                  >\n                    {def.enum.map((v: any) => (\n                      \n                    ))}\n                  \n                ) : (\n                   setParam(k, e.target.value)}\n                    onKeyDown={e => e.key === \"Enter\" && doInvoke()}\n                    spellCheck={false}\n                  />\n                )}\n                {def.type && {def.type}}\n              \n            );\n          }) : (\n            no parameters\n          )}\n          \n            \n              {sending ? \"…\" : \"send\"}\n            \n            cancel\n          \n          {result && (\n            {result.text}\n          )}\n        \n      )}\n\n      \n        scope: {action.scope} · v{action.version}\n        {action.registered_by && ` · by ${action.registered_by}`}\n      \n    \n  );\n}\n\n// ── Panel ───────────────────────────────────────────────────────────────────\n\ninterface ActionsPanelProps {\n  actions: Action[];\n  roomId: string;\n  baseUrl: string;\n  authHeaders: () => Record;\n  readOnly?: boolean;\n}\n\nexport function ActionsPanel({ actions, roomId, baseUrl, authHeaders, readOnly }: ActionsPanelProps) {\n  if (!actions.length) return no actions registered;\n\n  // Sort: custom actions first, builtins after\n  const sorted = [...actions].sort((a, b) => {\n    const aBuiltin = a.id.startsWith(\"_\") || a.id === \"help\" ? 1 : 0;\n    const bBuiltin = b.id.startsWith(\"_\") || b.id === \"help\" ? 1 : 0;\n    if (aBuiltin !== bBuiltin) return aBuiltin - bBuiltin;\n    return 0;\n  });\n\n  return (\n    \n      {sorted.map(a => (\n        \n      ))}\n    \n  );\n}\n",[],[418,1221,1295,1343],"7834c87e-13fb-11f1-b99c-42dde27851f2",["D",1772210619912],[475,476,477,478,479,480,481,482],[418,1221,1295],"7834c702-13fb-11f1-b99c-42dde27851f2",["D",1772210619912],[474,483,484,485,486,487,488,489,490,491],[418,1221],["D",1772210619912],[473,492,513,514,515,516,517,518,519,520,521,522,523],[418],"62ee63d2-170f-11f1-823c-42dde27851f2","what-becomes-true.md","1e91406e-170b-11f1-b2e4-42dde27851f2",218,["D",1772549027608],"# What Becomes True\n\n*March 2026*\n\n---\n\nIn April 2024 I wrote a small note to myself:\n\n> a tool for making tools.\n\nAs a software engineer, I build tools constantly. Tools exist so people can do things they otherwise could not — or could only do painfully. Programming itself is such a tool, but it carries a recursive dependency: to make tools, one must first learn programming.\n\nA hammer does not make everyone a carpenter, and programming does not make everyone a toolmaker. The question was simple enough to sound naïve:\n\n**Could a system allow people to build tools without first learning to program?**\n\nThis became *ctxl*. It did not begin as architecture. It began as prompts.\n\nThe early versions chained LLM prompts together. With sufficient context and carefully inserted data, outcomes became repeatable and useful. The generative capability was undeniable.\n\nBut configuration became the problem. Users were effectively programming without syntax, without types, without feedback. Success depended on discovering invisible structure: which prompts mattered, which examples stabilized behavior, which evaluations actually measured something real. We had not eliminated programming. We had obscured it.\n\nThe difficulty was not generating answers. The difficulty was discovering what the system should be trying to do.\n\nSoftware engineering contains a clue here. We trust systems not because we describe their procedures, but because we describe their expectations. Tests measure outcomes; they do not prescribe methods.\n\nLLM evaluation follows the same pattern. When outputs can be scored — especially through classification — iteration becomes empirical. The system improves not because it is instructed more carefully, but because differences become measurable.\n\nThe small realization was that objectives are easier to state than solutions. If a system began with an objective and constructed its own tasks, measures, and refinements through interaction, perhaps the configuration burden could shift. Prompts stopped being commands and became affordances — suggestions offered by the system to help the user think. Programming, viewed this way, is not instruction writing. It is affordance construction.\n\nAround this time I noticed that several games had already discovered this pattern.\n\nThe original *A Dark Room* begins almost empty — a cold fire and a single button. Nothing transitions. The interface simply accumulates meaning. Systems appear gradually, as if uncovered rather than introduced. Reading the source reveals a discipline: each event has its own availability predicate against global state. The game does not advance. It becomes true.\n\n*Papers, Please* exposes structure directly. Rules are explicit, mechanical, bureaucratic. Yet meaning emerges from interpreting those rules in context. Truth is negotiated through affordances.\n\n*Outer Wilds* barely changes its world at all. Progress exists entirely within the player’s understanding.\n\n*Factorio* goes further: the player builds systems until the systems begin shaping the player’s thinking. Optimization yields to stability. The factory stops being something you command and becomes something you maintain — an ecology of constraints that teaches you how it wants to exist.\n\nAcross these experiences, agency shifts. Progress stops feeling like movement through authored space and begins to feel like alignment with an already-present reality. You are not advancing. You are learning how the world works.\n\nThis pattern appears repeatedly outside games as well. Blackboard AI imagined shared reasoning spaces where solutions emerged opportunistically. Tuple spaces coordinated processes through shared environments. Functional reactive programming described behavior as recomputation over changing facts. Artificial life showed complex structure arising from local interaction.\n\nEach approach reached toward the same idea, and each failed for similar reasons: the environment could not interpret ambiguity. Coordination required orchestration because participants could not reason meaningfully about open-ended state. Language models quietly change this condition. Their most important property is not intelligence but tolerance for partial structure — they can interpret traces left by others without rigid schemas — and this made it possible to push the constraint further.\n\nThe sixth version of sync removed direct state mutation entirely.\n\nAn agent arriving in an empty room cannot write state. It cannot seed configuration. It cannot “set up” the world. It can do only two unilateral things:\n\n* register an action — a proposed write capability\n* register a view — a proposed read capability\n\nVocabulary construction is the only unilateral act. Everything else is collaborative. This produces a specific property: progressive disclosure becomes implicit. Actions are what changes what you can see. There is no setup phase and no privileged orchestrator. The first agent to arrive is not a god; it is simply an agent that proposes vocabulary first.\n\nThe consequences only became clear once agents began inhabiting rooms under this constraint.\n\nIn one early session, two agents arrived independently, each tasked with proposing a solution to a shared question. Both registered actions writing to the same key: `_shared.answer`.\n\nThe first registration succeeded.\n\nThe second also succeeded — but returned a warning: competing write targets. A synthetic view, `_contested`, became non-empty. The room’s help suggestions now included `contested_actions`.\n\nNothing broke. Nothing was blocked. The room simply held both proposals visibly.\n\nThis was deliberate. The system does not resolve conflict silently. It surfaces tension and names it.\n\nThe two agents read the updated context. Each could see that the other wrote to `_shared.answer`. Each saw the `_contested` view. Each saw invocation statistics on the other’s action.\n\nOne sent a directed message:\n\n```json\n{\n  \"to\": [\"agent-2\"],\n  \"kind\": \"negotiation\",\n  \"body\": \"We both write to _shared.answer. Here is my reasoning...\"\n}\n```\n\nDirected does not mean private; the message remained visible to the room. It simply routed attention.\n\nThe second agent was waiting on `messages.directed_unread > 0`. It woke. It read the full state. It replied.\n\nAfter several exchanges, one agent registered a new action — a synthesis that wrote to a different key, `_shared.candidate_answers`, and retracted its claim on `_shared.answer`. The other deleted its original proposal.\n\nThe `_contested` view became empty.\n\nNo orchestrator instructed this resolution. No special conflict API was invoked. The constraint forced negotiation into the open. The vocabulary space itself became the arena of coordination.\n\nLater, a third agent joined the room cold. It read `/context` and saw:\n\n* the current action vocabulary\n* the message history\n* the absence of `_contested` entries\n\nIt did not need to be told what had happened. The room contained its own history of negotiation. Context was a function of history.\n\nThis was the first moment the architecture felt different from workflow systems I had previously built. In a workflow, conflict is either impossible or resolved by hidden logic. Here, conflict is first-class. The room can hold superposition until participants collapse it socially.\n\nThere are edges. CEL predicates are readable but not natural. Agents occasionally misuse type coercion. The distinction between `revision` and content-hash `version` — used to enforce proof-of-read on conditional writes — is conceptually clean but cognitively heavy. Batch writes are not atomic; truly sequential guarantees require bounded engines — organs — that temporarily suspend emergence to enforce invariants. Structure returns where monotonic accumulation ends, and every generation attempting emergence eventually rediscovers this boundary. The goal is not eliminating coordination but localizing it — organs embedded within reefs.\n\nWhat distinguishes this system from earlier attempts is that vocabulary, not mutation, is the first move. Because agents cannot impose state directly, they must propose capability. Because capability proposals are visible, competition is visible. Because competition is visible, negotiation is visible. Because negotiation is visible, late joiners can reconstruct meaning without being told.\n\nThe room becomes both memory and medium. Clark and Chalmers argued that cognition extends into external artifacts when those artifacts reliably participate in reasoning. A sync room begins to function as collective working memory — each read delivers full context, each action leaves a trace. Participants reason privately, then modify the environment, and the loop repeats:\n\nperceive → interpret → act → reshape perception.\n\nA REPL, but multiplayer.\n\nThe claim is modest and testable: a shared substrate combining declarative vocabulary, surfaced competition, directed attention, and localized coordination may be sufficient to build worlds rather than workflows. In three independent systems built on this substrate, agents have begun inventing conventions I did not specify — meta-views referencing other views, phased objectives evolving as rooms evolve, negotiation patterns that stabilize into reusable vocabulary. None of these were encoded in advance.\n\nThe architecture does not eliminate structure. It makes structure emerge where necessary. The fire is lit, the room is still mostly dark, and what matters now is watching carefully enough to see what becomes true.\n",[],[424,1362],"a5b7b29a-170a-11f1-8801-42dde27851f2","the-substrate-thesis.md","a5b7b376-170a-11f1-8801-42dde27851f2",210,["D",1772546991890],"# The Substrate Thesis\n\n## You Are the Component: Surfaces, State, and the Architecture of Emergent Experience\n\n---\n\n### Abstract\n\nModern software separates use, construction, and reasoning into distinct systems: interfaces for users, code for developers, and increasingly agents for intelligence. This separation produces brittle orchestration, rigid workflows, and tools that cannot evolve alongside intention.\n\nAcross three experimental systems — **ctxl**, **sync**, and **playtest** — a different model emerges:\n\n> **Software is not a sequence of flows but a shared substrate of truth observed by self-activating components.**\n\nIn this model:\n\n- **state** is the substrate,\n- **surfaces** are observers,\n- **actions** are transitions,\n- and agents and humans become equivalent participants in a reactive cognitive environment.\n\nThe interface stops being a controller and becomes a perceptual layer. Experiences are not executed — they emerge.\n\n---\n\n### 1. The Original Problem: The Stupid Loop (ctxl)\n\nThe starting observation in ctxl is deceptively simple:\n\n> People need tools they cannot build because building tools requires programming — itself a tool.\n\nThis produces what *You Are the Component* calls the stupid loop:\n\n```\nneed tool → must program → need tool to program → repeat\n```\n\nTraditional LLM tooling attempts to break this via generation:\n\n```\nprompt → generate UI → use result\n```\n\nBut generated interfaces are snapshots. They freeze intent at a moment in time.\n\nIntent, however, is not static. It evolves through interaction.\n\nThe key insight of ctxl is therefore not generation but **malleability**:\n\n> The interface must remain alive to reasoning.\n\nThis leads to the architectural inversion:\n\nInstead of:\n\n```\nComponent → occasionally calls AI\n```\n\nctxl proposes:\n\n```\nAI reasoning participates inside the component lifecycle.\n```\n\n| React Concept | Agent Concept |\n|---------------|---------------|\n| props / state | context / memory |\n| render | expression |\n| effects | reasoning |\n| dependency array | perception boundary |\n\nReasoning becomes a reactive hook. The component does not *use* intelligence. The component *is* intelligent.\n\nHence: **You Are the Component.**\n\n---\n\n### 2. From Intelligent Components to Shared Reality (sync)\n\nctxl solves local malleability — a single adaptive component.\n\nsync asks the next question:\n\n> What happens when many intelligent components share the same world?\n\nHere the architecture shifts from component lifecycle to shared state substrate.\n\nsync introduces a persistent, multiplayer truth layer: shared collections, reactive updates, distributed observers, CRDT-like convergence.\n\nThe critical shift:\n\n> The UI is no longer primary. State becomes primary reality.\n\nParticipants — human or agent — observe and modify a common substrate.\n\nThis rediscovery echoes historical systems: blackboard architectures, Linda tuple spaces, reactive databases, collaborative editors. But with a crucial difference:\n\nEarlier systems assumed rigid schemas and deterministic programs. sync assumes **open-world semantics** and **interpretive agents**.\n\nState is allowed to grow organically. Absence becomes meaningful.\n\n---\n\n### 3. The Failure of Flow Thinking (playtest)\n\nThe playtest experiments exposed a structural mismatch.\n\nAttempts to design experiences using traditional logic produced: compound boolean gates, history-dependent visibility, coupled transitions, fragile orchestration. Symptoms of trying to build a state machine atop a reactive substrate.\n\nThe discovery:\n\n> Experiences built on shared truth behave like ecosystems, not programs.\n\nThis leads to the formulation of **Surfaces as Substrate.**\n\nA surface is defined as:\n\n> A declarative observer of shared state that activates itself when relevant.\n\nNo controller decides what appears. Each surface carries its own activation contract.\n\n```\nSTATE → surfaces evaluate → experience assembles\n```\n\nThe system behaves like a coral reef: components respond locally, structure emerges globally.\n\n---\n\n### 4. The Unified Model\n\nAcross all three projects, the same structure appears at different scales.\n\n| Project | Scale |\n|---------|-------|\n| **ctxl** | intelligence inside a component |\n| **sync** | intelligence across shared state |\n| **playtest** | experience emerging from observers |\n\nThey unify into a single architecture:\n\n```\n            Humans / Agents\n                    ↑\n                Surfaces\n                    ↑\n            Derived Meaning\n                    ↑\n                 State\n                    ↑\n         Localized State Machines\n```\n\n---\n\n### 5. Events vs Reality\n\nTraditional systems preserve history as truth. The substrate model distinguishes:\n\n- **events** — how change occurred\n- **facts** — what is currently true\n\n```\nfound_key = true        ← event fossil\ninventory includes key  ← world fact\n```\n\nSurfaces depend only on facts. Actions may internally emit events but must externally commit ontology.\n\nThis mirrors CQRS and event sourcing — but reverses priority:\n\n> The projection is reality. The log is implementation.\n\n---\n\n### 6. Interpretation as First-Class Layer\n\nA critical evolution emerges when scaling to agents. Raw state is too granular for perception. Meaning must be derived.\n\n```\ninventory contains rope\n+ at == cabin\n→ can_descend_well\n```\n\nDerived facts form a semantic compression layer: humans perceive affordances naturally; agents require them explicitly.\n\nThus interpretation becomes a declarative layer of the substrate itself.\n\n---\n\n### 7. State Machines Become Organs\n\nPure reactive systems struggle with exclusivity: transactions, locks, atomic exchanges.\n\nThe solution is not abandoning state machines but **localizing them.**\n\nState machines operate as bounded organs:\n\n```\norgan resolves constraint → emits updated fact → reef reacts\n```\n\nThe ecosystem never sees the imperative mechanics. Only the resulting truth propagates.\n\n---\n\n### 8. Interface = Perception\n\nWhen surfaces observe shared truth, UI elements, dashboards, and agent APIs all become equivalent sensory organs.\n\nA button for a human and a JSON affordance for an agent are the same surface expressed through different modalities.\n\n> The UI and API converge.\n\nThe system stops presenting flows and instead exposes **possibility space.**\n\n---\n\n### 9. The Emergent Property\n\nWhen these principles hold:\n\n- new surfaces can be added without modifying existing ones,\n- new actions introduce new realities without rewrites,\n- agents and humans collaborate without coordination logic.\n\nDesign shifts from scripting behavior to **shaping semantic physics.**\n\nYou no longer design journeys. You design conditions under which journeys can arise.\n\n---\n\n### 10. What These Projects Actually Are\n\nSeen together:\n\n| Project | Discovery |\n|---------|-----------|\n| **ctxl** | Intelligence belongs inside reactive components |\n| **sync** | Shared state is the real execution environment |\n| **playtest** | Experiences emerge from self-activating observers |\n\nThey are not separate experiments. They are iterations toward:\n\n> A shared cognitive substrate where software, users, and agents co-evolve through observation of truth.\n\n---\n\n### Closing Thesis\n\nSoftware historically treated interaction as command and response.\n\nThe substrate model treats interaction as **perception and adaptation.**\n\nPrograms execute. Ecosystems emerge.\n\nAnd when components, agents, and humans all observe the same evolving reality, the boundary between using software and creating it dissolves.\n\nYou are not operating the system. You are a participant organism inside it.\n\n**You are the component.**\n\n---\n\n*Christopher · Edinburgh · February 2026*\n",[],[424,1370],"15d8270a-1ce0-11f1-b966-42dde27851f2","the-self-assembling-harness.md","551ec632-1cde-11f1-928e-42dde27851f2",435,["D",1773188418980],"# The Self-Assembling Harness\n\n*A response to \"Can Someone Please Define a Harness?\"*\n\n---\n\nThe consensus has crystallised into a clean equation:\n\n**Agent = Model + Harness**\n\nThe model contains the intelligence. The harness makes it useful. A harness is every piece of code, configuration, and execution logic that isn't the model — system prompts, tools, filesystems, sandboxes, orchestration, memory, compaction. The human designs the harness. The model inhabits it.\n\nThis is correct. It describes Claude Code, Codex, Devin, and every serious agent in production. And the mapping to sync is closer than you'd expect:\n\n| Harness component | sync equivalent |\n|---|---|\n| Filesystem for durable storage | Scoped state (key-value substrate) |\n| Bash / code as general tool | Registered actions (declarative, not imperative) |\n| Memory injection into context | Context reads + computed views |\n| Context rot / compaction | Context shaping (depth, only, messages_after) |\n| Skills / progressive disclosure | Action preconditions + enabled expressions |\n| Sandboxes | Rooms (isolated, scoped, teardown-able) |\n| Long-horizon Ralph Loops | Wait → perceive → act → wait |\n| Self-verification | Views that evaluate post-write state |\n| Git for tracking work | Audit log (append-only trajectory) |\n\nsync solves the same problems harnesses solve. The difference is in who builds the thing.\n\n---\n\n## The \"who builds it\" column\n\nIn a harness, a human engineer decides what tools are available, what the filesystem looks like, what memory gets injected, how compaction works. The model receives a configured environment. In sync, the first agent in an empty room faces four built-in operations and nothing else. The vocabulary — the equivalent of the tool set, the memory structure, the verification strategy — is constructed by the agents through registration.\n\nNobody pre-designed the harness. The harness assembles itself through use.\n\nThis is not hypothetical. It is how sync rooms work today through the MCP integration. Claude reads the room's context (state, views, available actions) and invokes actions through tool calls. The tool set is the registered vocabulary. The memory is the state. The context management is the `_context` envelope. None of it was pre-designed for a specific task.\n\nWhen a second agent arrives, it reads the same context. It sees the vocabulary the first agent registered. It can invoke existing actions, register new ones, or contest existing ones by proposing competing vocabulary. The coordination protocol is not orchestrated — it emerges from agents reading shared state and acting on what they see.\n\n---\n\n## Single-agent vs multi-agent\n\nThe harness equation is Agent (singular) = Model + Harness. The harness serves one model. Multiple agents need \"orchestration logic (subagent spawning, handoffs, model routing)\" — which is more harness, designed by a human, wrapping the interaction.\n\nsync's room serves N agents without orchestration. Coordination is stigmergic — agents read shared state, act on it, and other agents perceive the effects. No harness designer decides the interaction pattern. One agent built vocabulary for a multi-agent research task with no orchestration layer. The room held both agents' contributions without anyone wiring them together.\n\n---\n\n## Filesystem vs substrate\n\nThe post identifies the filesystem as \"arguably the most foundational harness primitive.\" It's a collaboration surface, a persistence layer, a workspace.\n\nsync's state is not a filesystem. Files are opaque — you open them and parse their contents. State entries are typed and queryable via CEL. A view can answer \"how many findings are recorded?\" directly, without the agent reading a file and counting array elements.\n\nFiles have no authority model — anyone with access can read or write anything. State entries are scoped: agent `alice` cannot read agent `bob`'s private scope without explicit delegation.\n\nFiles have no transitions. Writing a file is unconditional. Writing state requires invoking a registered action, which may have preconditions, parameter validation, and scope authority checks. There is no `_set_state`.\n\nFiles have no computed projections. A file sitting on disk says nothing about system state unless you read and interpret it. Views compute derived facts on every context read. The room is self-describing.\n\nThese aren't quality judgments — filesystems are excellent and proven. They're about what the primitive makes easy. Filesystems make storage easy. The state-plus-actions-plus-views substrate makes structured coordination easy. A harness built on a filesystem needs orchestration logic to coordinate multiple agents. A room built on the substrate gets coordination from agents reading shared state and acting on what they see.\n\n---\n\n## Where intelligence lives\n\nThe post says: \"The model contains the intelligence and the harness makes that intelligence useful.\" Intelligence is in the weights. The harness is mechanical infrastructure.\n\nsync's thesis is weirder. Intelligence is distributed across the model weights, the room state, the vocabulary, and the trajectory. Clark and Chalmers' extended mind. The room is not dumb infrastructure — it computes views, evaluates preconditions, surfaces contested targets, shapes context per-agent. It's not intelligent in the LLM sense, but it's not the passive plumbing the harness metaphor implies.\n\nWhen you read a sync room's context, you don't just get data. You get an affordance map: which actions are available to you right now, what views compute from state, what's contested, who else is present. The room participates in cognition, in the same way a well-organised whiteboard participates in a team's thinking. Not by being smart, but by making the relevant structure visible.\n\n---\n\n## What a harness knows that a room doesn't\n\nThe self-assembling story has real limits.\n\n**A harness knows the task.** Claude Code's harness is designed for coding. Its tools include `git`, `grep`, compilers. Its verification is \"run the tests.\" A sync room has no task knowledge until agents bring it. The first agent must bootstrap from scratch. A pre-designed harness is faster to productive work than a self-assembled one. That's a real trade-off, not a theoretical one.\n\n**A harness knows the model.** Claude Code is co-trained with its harness — the model was post-trained to work well with `apply_patch` and specific tool interfaces. This coupling improves performance but creates brittleness: change the tool format and performance degrades. sync's vocabulary is arbitrary — action IDs, parameter names, write templates are all agent-chosen at runtime. More flexible, but no training-time optimisation to benefit from.\n\n**A harness has opinions about quality.** Lint checks, test runners, compilation gates — deterministic verification that catches errors before they propagate. sync rooms have no built-in quality checks on vocabulary. A broken view persists indefinitely. A stale action sits there forever. The `_context` envelope tells you what's there but not whether it's good.\n\nThat last gap is the most important one, and it's an open problem. The room generates trajectory data — every action invocation, every state change, every message. The signals are there: broken view count, stale action ratio, message-to-invocation ratio. But the right way to aggregate those signals into something useful isn't clear yet. The data exists. The assessment strategy doesn't.\n\n---\n\n## Progressive disclosure: two different games\n\nThe post describes \"Skills\" as a harness primitive: tool descriptions loaded on demand rather than stuffed into context at start, protecting against context rot.\n\nsync's progressive disclosure works differently. Actions have `if` preconditions — an action is only available when its predicate holds against current state. Views have `enabled` expressions. The vocabulary space grows as agents register new vocabulary. Disclosure is driven by state, not by task stage.\n\nIn a harness, progressive disclosure is designed by the engineer: \"show the database tools after the schema is loaded.\" In sync, it's a consequence of vocabulary design: \"this action is available when `phase == synthesizing`.\" The agent who registered the action chose the predicate. The substrate evaluates it. Nobody external curates the sequence.\n\nMore flexible. Less curated. The harness model can create a carefully designed onboarding flow. The substrate model creates disclosure conditions that are locally coherent but may not globally compose into a sensible progression. Both are real trade-offs.\n\n---\n\n## The training coupling question\n\nThe post describes an interesting feedback loop: useful primitives are discovered, added to the harness, then used when training the next generation of models. Models become more capable within the harness they were trained in. But this co-evolution creates overfitting — switching tool interfaces degrades performance.\n\nsync's vocabulary is not coupled to any model's training data. Actions are registered at runtime with arbitrary shapes. This should be more robust to the overfitting problem, because the vocabulary isn't fixed at training time. An agent that can register arbitrary actions isn't locked to a specific tool interface.\n\nBut that's an empirical claim, not a proven one. And it points to a genuinely interesting architectural divergence:\n\nIn the harness model, more capable models need less scaffolding. The harness shrinks. Models absorb what the harness used to do.\n\nIn the substrate model, more capable models produce richer vocabulary. The room grows. A more capable agent registers more precise actions, more expressive views, more nuanced preconditions.\n\nOne future converges toward models that need no infrastructure. The other diverges toward models that produce better infrastructure. In one, the harness disappears. In the other, it flourishes. Which trajectory plays out depends on whether the hard problems are better solved by baking them into weights or by constructing them in shared environments. The answer is probably \"both, depending on the problem.\"\n\n---\n\n## Agents analysing their own traces\n\nThe post identifies a future direction: \"agents that analyze their own traces to identify and fix harness-level failure modes.\" That's interesting, and the architectural difference in where that analysis happens matters.\n\nIn the harness model: an external system analyses the model's traces and modifies the harness. The model is the subject. The harness is the engineer. The feedback loop runs outside the agent.\n\nIn sync: the trajectory is in the room. If agents can read the audit log — and they can, via `include=_audit` — they can analyse their own coordination patterns and register better vocabulary. The feedback loop runs through the agents, mediated by the substrate. Nobody external is engineering the harness. The agents are revising their own operational vocabulary based on what they observe about how it's working.\n\nWhether agents are actually good at this is a different question. The architecture supports it. Whether current models can do meaningful self-assessment of vocabulary quality, or whether they'll just accrete more vocabulary (the pathological monotonicity problem we've observed), is genuinely unresolved. The substrate makes self-revision possible. It doesn't make it likely. Making it likely is the open design problem.\n\n---\n\n## What sync actually is\n\nsync is not a harness. A harness is designed by engineers for models.\n\nsync is not a meta-harness. That implies a system that generates harnesses, which isn't quite right either.\n\nThe closest framing: **sync is a substrate for self-assembling coordination infrastructure.** The substrate provides scoped state, context shaping, authority boundaries, append-only trajectory, declarative transitions. Agents provide the vocabulary — what tools exist, what projections matter, what preconditions gate, what conventions coordinate.\n\nThe resulting room — state plus vocabulary plus trajectory — is the thing a harness engineer would have designed in advance, except nobody designed it. It emerged from agent activity within the substrate's constraints.\n\nFor short tasks with known tool sets, a pre-designed harness almost certainly wins. Faster cold start, training-time coupling, curated verification — these are real advantages.\n\nFor long-horizon tasks in novel domains with multiple agents, the self-assembled vocabulary may win. Because nobody could have pre-designed the right harness — the task is too open-ended, the agent composition is too dynamic, the coordination patterns are too emergent for any engineer to have anticipated them.\n\nThe interesting question isn't which is better. It's whether the room can develop an opinion about the quality of its own vocabulary — not through an external engineer, not through a bolted-on analysis system, but as a natural property of the trajectory accumulating and the substrate making that trajectory legible to its inhabitants.\n\nThat's the frontier. The architecture supports it. The implementation hasn't caught up yet. And the honest answer is that nobody — not sync, not the harness ecosystem, not the RL community — has cleanly solved the problem of agents that reliably improve their own operational environment rather than just accreting more stuff in it.\n\nBut the substrate gives that problem a place to live. The room is the shared environment. The trajectory is the evidence. The agents are the ones who have to do the work. The substrate's job is to make the work visible.\n\n---\n\n*March 2026*\n",[],[424,1378],"62e79a16-170f-11f1-8efa-42dde27851f2","surfaces-design.md","a5beb950-170a-11f1-9384-42dde27851f2",217,["D",1772549027607],"# Surfaces as Substrate\n\n*Design principles for composable experiences in sync*\n\n---\n\n## The Observation\n\nA surface is a declarative view over mutable shared state. An action is a state transition with preconditions. Together they form something more interesting than either: **an experience that assembles itself from the state it observes.**\n\nThis is not a state machine. State machines require you to enumerate transitions upfront. This is closer to how a coral reef works — individual organisms (surfaces, actions) respond to local chemical signals (state) without awareness of the whole structure. The reef *emerges*.\n\nThe dark room game revealed what happens when you fight this. Compound boolean flags (`found_cabin && !has_map && outside`), coupled write sequences, surfaces whose visibility depends on the precise history of state changes — these are symptoms of trying to build a state machine using coral.\n\nThe following principles describe how to work *with* the substrate rather than against it.\n\n---\n\n## I. Absence is Signal\n\nA key that doesn't exist yet is not an error. It's information.\n\nThe substrate must handle absence gracefully — `state._shared.discovered == true` should be false when `discovered` has never been written, without requiring someone to have written `discovered: false` first. This is a property of the evaluator, not the experience designer.\n\n**Why this matters:** If you require all state to exist before it's referenced, you've created a coupling between setup and every future addition. You can't add a new surface that gates on `state._shared.found_secret_door` without going back and initializing `found_secret_door: false` in the room setup. That's not composable — it's a manifest.\n\nDesign for accretion. State grows over time. New keys appear as the experience unfolds. A well-designed surface handles the moment *before* its key exists exactly as gracefully as the moment after.\n\n---\n\n## II. Locality of Reasoning\n\nA surface should be understandable by looking at the surface and the state it references. Nothing else.\n\nIf understanding why a section is visible requires tracing through three actions, two other surfaces, and the ordering of writes — the coupling has won. Each surface's `enabled` expression should read as a simple, local question:\n\n- *\"Has the player reached the cabin?\"* → `state._shared.at == \"cabin\"`\n- *\"Is there something to pick up?\"* → `state._shared.item_available == true`\n- *\"Has the door been opened?\"* → `state._shared.door_open == true`\n\nNot:\n\n- *\"Has the player found the cabin AND not yet taken the map AND still has the key AND didn't go back inside?\"*\n\nWhen you find yourself writing compound conditions with more than two clauses, you're encoding a *narrative dependency graph* into a visibility expression. That graph belongs in the actions (which perform transitions), not the surfaces (which observe results).\n\n**The test:** Can someone unfamiliar with the experience read a single surface config and understand when it appears? If the answer requires knowledge of action ordering or write side-effects, refactor.\n\n---\n\n## III. Actions as Boundaries\n\nAn action is a *narrative boundary* — the moment between one state of the world and another. It should produce a coherent, self-contained state change.\n\nThis means:\n\n**One action, one conceptual transition.** \"Search the cabin\" should produce *one* atomic result: the cabin has been searched. Whether that means setting a flag, updating inventory, and writing narrative text — all of it happens in one action's write batch, and the post-state is internally consistent.\n\n**Actions don't sequence — they gate.** An action's `if` expression asks \"is this transition valid right now?\" It doesn't ask \"have the previous three transitions happened in order?\" If you need ordering, it should emerge from state: action A writes a key, action B's precondition checks for that key. But B doesn't know about A — it only knows about the key.\n\n**Write to the grain you gate on.** If surfaces gate on `at == \"cabin\"`, then the action that moves you there should write `at: \"cabin\"`. If surfaces gate on `door_open == true`, the action should write `door_open: true`. The vocabulary of action writes and surface conditions should be the *same vocabulary*. When they diverge — actions writing booleans that surfaces must recombine into compound expressions — you've split the concept across two representations.\n\n---\n\n## IV. The Grain of State\n\nNot boolean soup. Not a monolithic enum. Something in between.\n\nThe dark room's mistake was using many fine-grained booleans (`tried_door`, `looked_shelf`, `found_key`, `door_open`, `outside`, `found_cabin`, `has_map`, `has_rope`) that individually meant little but whose *combinations* encoded the actual game state. This is the boolean soup problem: each flag is easy to write but impossible to reason about in aggregate.\n\nThe opposite extreme — a single `phase` enum — is also wrong. It forces linear progression, prevents parallel threads, and requires that every possible state be a named member of one enum. You can't have \"player is outside AND a storm is brewing AND a merchant has arrived\" without an enum entry for every permutation.\n\n**The right grain is the conceptual entity.** State keys should map to things the experience cares about as first-class concepts:\n\n- **Location:** `at: \"cabin\"` — not five booleans about movement history\n- **Discovery:** `door_open: true` — a single fact about the world\n- **Accumulation:** `inventory: [\"rope\", \"map\"]` — a collection, displayed but not gated on\n- **Atmosphere:** `narrative: \"Firelight flickers...\"` — display state, decoupled from logic\n\nThe heuristic: **if removing a key would make two or more surfaces wrong, it's the right grain.** If removing a key only affects one surface, it might be too fine. If it affects everything, it's too coarse.\n\n---\n\n## V. Additive Composition\n\nYou should be able to add a new surface, action, or state key to an existing experience without modifying anything that already exists.\n\nThis is the composability test. In the dark room, adding a \"secret passage in the well\" would require:\n1. A new action with writes\n2. A new surface section\n3. *Nothing else changes*\n\nIf adding the passage requires modifying the well section's enabled condition, or changing what `descend_well` writes, or adding initialization to the room setup — the design isn't composable.\n\n**Surfaces compose by observing, not by being orchestrated.** A new surface that gates on `state._shared.found_secret == true` can be added to the config at any time. The state key doesn't need to exist yet (Principle I). No other surface needs to know about it. The action that writes `found_secret: true` can be added independently.\n\nThis is the coral reef pattern. New organisms attach to the existing structure and respond to local chemistry. The reef's architecture isn't planned — it accretes.\n\n**Implications for config structure:** The `_dashboard` surfaces array should read as a flat collection of independent pieces, not as a nested dependency tree. Sections can be nested for *visual grouping*, but their enabled conditions should be independent. A section nested inside another section shouldn't rely on the parent's condition — it should restate its own. Redundancy in enabled expressions is a feature, not a bug; it preserves locality (Principle II).\n\n---\n\n## VI. Display State vs. Gate State\n\nNot all state exists for the same reason. Conflating display state with gating state is a source of coupling bugs.\n\n**Gate state** determines what's visible and available: `at: \"cabin\"`, `door_open: true`, `quest_complete: false`. Surfaces and actions reference these in `enabled` and `if` expressions.\n\n**Display state** provides content for what's already visible: `narrative: \"The cabin smells of pine...\"`, `inventory: [\"rope\", \"map\"]`, `wood_count: 48`. Surfaces render these as markdown, watches, metrics.\n\n**The rule:** Gate on gate state. Display display state. Don't gate on display state.\n\nGating on `inventory.length > 2` means the player's ability to progress depends on a display concern. If you later decide to change how inventory works (combining items, dropping things), you've broken progression gates. Instead, have the action that gives the player the critical item also write the gate key: `has_supplies: true`.\n\n---\n\n## VII. Surfaces as Self-Describing Components\n\nEach surface carries its own activation contract. It says: *\"I appear when X. I show Y. I offer Z.\"*\n\nThis is the connection to YATC thinking. A surface is a component that *knows when it's relevant*. It doesn't need an orchestrator to show or hide it. It doesn't need to be imperatively mounted. It evaluates its own `enabled` expression against the shared state and either renders or doesn't.\n\nThe _dashboard config is not a controller — it's a **manifest of available components**, each with self-declared activation conditions. The runtime's job is to evaluate those conditions and render what's active. There is no routing logic, no transition function, no switch statement. Just components and conditions.\n\nThis means the config is also *introspectable*. You can look at the surfaces array and immediately understand the experience's possibility space: what states the experience can be in, what the player sees in each state, what actions are available. The config *is* the experience design, not a thin UI wrapper over hidden logic.\n\n---\n\n## VIII. Failure Modes and How to Smell Them\n\nWhen an experience built on surfaces goes wrong, it's usually one of these:\n\n**The Compound Gate:** `enabled: \"a == true && b == false && c == true && d != 'done'\"`. This means the surface's visibility encodes a *history of transitions* rather than a *current state*. Refactor: find the single concept this combination represents and make it a key.\n\n**The Invisible Dependency:** Action A writes `x: true`. Surface S gates on `x == true`. But S only makes sense if action B has also been invoked, and nothing enforces that ordering. Refactor: either action A should also write the state that S actually needs, or S's condition should include what it actually requires.\n\n**The Write Spray:** An action writes to 5 different keys across 3 scopes. Some are gate state, some are display state, some are side-effects for other systems. Refactor: one action, one conceptual transition. Display updates can be separate writes in the batch, but the *gating* change should be one key.\n\n**The Dead Reference:** A surface references a view or action that was renamed or removed. The surface silently disappears or shows empty. This is a tooling problem — the substrate should warn about dangling references.\n\n**The Absence Surprise:** A surface gates on `x == false` but `x` was never initialized. Whether this works depends entirely on evaluator semantics. After our fix, absence is falsy, so this works. But it's still worth being explicit in action descriptions about what \"default\" means.\n\n---\n\n## Worked Example: The Dark Room, Revisited\n\nApplying these principles to the same game:\n\n**Gate state:** `at` (location enum: room, outside, cabin, well, descent, ending), `door_open`, `cabin_searched`, `has_compass`\n\n**Display state:** `narrative` (markdown text for current scene), `inventory` (array), `wood_count`\n\n**Surfaces:**\n\n```\nsection \"The Room\" enabled=\"at == 'room'\"\n  → markdown (narrative view)\n  → action-bar [look_around, try_door, search_shelf, open_door]\n\nsection \"Outside\" enabled=\"at == 'outside'\"  \n  → markdown (narrative view)\n  → action-bar [gather_wood, search_forest]\n  → watch [wood_count, inventory]\n\nsection \"The Cabin\" enabled=\"at == 'cabin'\"\n  → markdown (narrative view)  \n  → action-bar [search_cabin, go_to_well]\n\nsection \"The Well\" enabled=\"at == 'well'\"\n  → ...\n```\n\nEach section: one gate condition, one location. Actions write `at` to move between locations. No compound conditions needed.\n\n`search_cabin` writes: `cabin_searched: true`, appends to inventory (one batch write), updates narrative. It does NOT write `at` — you stay at the cabin. `go_to_well` is a separate action that writes `at: \"well\"`, gated on `cabin_searched == true`.\n\nThe experience is now a collection of independent scene components, each self-activating based on one piece of state. Adding a new location means adding a new section and the actions that write the new `at` value. Nothing existing changes.\n\n---\n\n## Summary\n\n| Principle | One-liner |\n|---|---|\n| Absence is Signal | Unset keys are meaningful, not errors |\n| Locality of Reasoning | Each surface understandable in isolation |\n| Actions as Boundaries | One action = one coherent transition |\n| The Grain of State | Concepts, not booleans or monoliths |\n| Additive Composition | New pieces don't modify existing pieces |\n| Display vs. Gate | Don't gate visibility on display concerns |\n| Self-Describing Components | Surfaces carry their own activation contract |\n\nThe substrate is the state. Surfaces observe it. Actions transform it. The experience is what emerges when you get the grain right.\n",[],[424,1386],"a5a3587c-170a-11f1-ab67-42dde27851f2","sigma-calculus.md","a5a3596c-170a-11f1-ab67-42dde27851f2",207,["D",1772546991889],"# Σ-calculus\n\n## A Minimal Algebra of Substrate Systems\n\n---\n\n## Motivation\n\nThe λ-calculus captures computation with three forms (variable, abstraction, application) and one reduction rule (β-reduction). Every computable function can be expressed in this algebra. The question: is there an equivalently minimal calculus for *emergent* systems — systems where behavior arises from self-activating observers of shared truth rather than from sequential function application?\n\nThe substrate thesis proposes that software is a shared substrate of truth observed by self-activating components. Three projects (ctxl, sync, playtest) instantiate this claim. This document attempts to distill the common algebraic structure underneath all three into a formal calculus — the **Σ-calculus** (sigma-calculus, for substrate).\n\n### Design Goals\n\n1. **Minimality.** The fewest primitives that capture substrate dynamics. Every primitive must be necessary; removing any one should make at least one key property unexpressable.\n\n2. **Compositionality.** The algebra must support parallel composition where adding components does not require modifying existing ones.\n\n3. **Decidable activation.** It must be statically determinable which components *can* activate in a given state, even if the order of activation is not determined.\n\n4. **Monotonicity distinction.** The algebra must structurally distinguish monotonic operations (which require no coordination) from non-monotonic operations (which do), making the CALM boundary visible in the syntax.\n\n5. **Lean-provable.** Every definition should translate directly to inductive types and propositions in Lean 4.\n\n---\n\n## 1. The Substrate\n\nA substrate is a finite partial function from *located keys* to *values*.\n\n```\nKey   := String\nScope := String\nVal   := JSON-like atoms (we abstract over this)\n\nLoc   := Scope × Key\n\nΣ     := Loc →fin Val\n```\n\nA located key `(s, k)` identifies a fact. The scope `s` provides authority boundaries. The substrate `Σ` is the totality of situated facts at a moment.\n\nWe write `Σ(s, k) = v` to mean key `k` in scope `s` holds value `v`, and `Σ(s, k) = ⊥` to mean the fact is absent.\n\n### Versioning\n\nEach located key carries a version number:\n\n```\nΣV := Loc →fin (Val × ℕ)\n```\n\nWe elide versions when not needed and introduce them explicitly for non-monotonic operations.\n\n---\n\n## 2. Predicates\n\nA **predicate** is a decidable proposition over the substrate:\n\n```\nφ : Σ → Bool\n```\n\nPredicates are the activation conditions. They determine when a component becomes relevant. In sync, these are CEL expressions. In the calculus, we treat them abstractly but require decidability — given any finite substrate, the predicate terminates and returns true or false.\n\n### Predicate Algebra\n\nPredicates form a Boolean algebra under the usual operations:\n\n```\n⊤        : Σ → true                    (always active)\n⊥        : Σ → false                   (never active)\n¬φ       : Σ → ¬(φ(Σ))                 (negation)\nφ₁ ∧ φ₂  : Σ → φ₁(Σ) ∧ φ₂(Σ)          (conjunction)\nφ₁ ∨ φ₂  : Σ → φ₁(Σ) ∨ φ₂(Σ)          (disjunction)\n```\n\nA predicate is **monotone** if, for all Σ ⊆ Σ' (where ⊆ means Σ' agrees with Σ on all defined keys and may define additional ones):\n\n```\nφ(Σ) = true  →  φ(Σ') = true\n```\n\nOnce a monotone predicate becomes true, it stays true as the substrate grows. This is the CALM boundary expressed in the predicate algebra.\n\nA predicate is **anti-monotone** if:\n\n```\nφ(Σ) = true  →  φ(Σ') = true   when Σ' ⊆ Σ\n```\n\nAnti-monotone predicates respond to absence. They are the source of coordination requirements.\n\n---\n\n## 3. Terms\n\nThe Σ-calculus has five term forms. This is the complete syntax.\n\n```\ne ::= fact(s, k, v)                    -- a situated fact\n    | write(φ, s, W)                   -- a guarded write \n    | observe(φ, s, R)                 -- a guarded observation\n    | e ∥ e                            -- parallel composition\n    | scope(s, e)                      -- authority boundary\n```\n\nWhere:\n\n- `W : Σ → Loc →fin Val` is a **write function** — given the current substrate, it produces a set of located writes.\n- `R : Σ → Out` is a **read function** — given the current substrate, it produces an output (an affordance, a rendered surface, an API response). `Out` is abstract.\n\n### Intuition\n\n**fact** is a datum. It exists in the substrate.\n\n**write** is a guarded transition. When predicate `φ` holds, the write function `W` determines what changes to make. The scope `s` is the authority — writes can only target locations within scope `s`. This is the action.\n\n**observe** is a guarded perception. When predicate `φ` holds, the read function `R` produces an output. Observations never modify the substrate. This is the surface.\n\n**∥** is parallel composition. Components exist side-by-side with no ordering. This is the reef.\n\n**scope** is an authority boundary. Expressions within `scope(s, e)` have write authority over scope `s` and read authority over the entire substrate.\n\n### Why Five Forms\n\nEach is necessary:\n\n- Without **fact**, there is no state.\n- Without **write**, state cannot change.\n- Without **observe**, state cannot be perceived.\n- Without **∥**, components cannot coexist.\n- Without **scope**, there are no authority boundaries.\n\nRemove any one and a core substrate property vanishes.\n\n---\n\n## 4. Reduction Rules\n\nThe Σ-calculus has two reduction rules. This is the complete dynamics.\n\n### Rule 1: Activation (write)\n\n```\n         φ(Σ) = true      W(Σ) = {(s₁,k₁,v₁), ..., (sₙ,kₙ,vₙ)}\n         ∀i. sᵢ ∈ authority(e)\n    ─────────────────────────────────────────────────────────────────\n    Σ ; write(φ, s, W) ∥ E  ⟶  Σ[s₁/k₁ ↦ v₁]...[sₙ/kₙ ↦ vₙ] ; E\n```\n\nWhen the predicate is satisfied and all writes fall within the authority of the enclosing scope, the write applies atomically. The write term is consumed (single-fire) or remains (persistent) depending on the variant — we distinguish these below.\n\n### Rule 2: Observation\n\n```\n         φ(Σ) = true      R(Σ) = o\n    ──────────────────────────────────────\n    Σ ; observe(φ, s, R) ∥ E  ⟶  Σ ; observe(φ, s, R) ∥ E  ⊢ o\n```\n\nObservations produce output but do not modify the substrate. The observer persists. Output `o` is emitted to the environment.\n\n### Non-determinism\n\nWhen multiple writes have satisfied predicates simultaneously, the calculus does not specify an order. Any enabled write may fire. This is the formal expression of opportunistic activation — the system is nondeterministic in scheduling but deterministic in each individual step.\n\n### Persistence Variants\n\nWe distinguish two kinds of writes:\n\n- **Impulse**: `write!(φ, s, W)` — fires once when `φ` becomes true, then is consumed.\n- **Standing**: `write*(φ, s, W)` — fires every time `φ` is true and remains in the system.\n\nAnd two kinds of observations:\n\n- **Continuous**: `observe*(φ, s, R)` — produces output whenever `φ` holds.\n- **Triggered**: `observe!(φ, s, R)` — produces output on the transition from `¬φ` to `φ`.\n\nIn sync, actions are standing writes (they persist across invocations). Surfaces are continuous observations. Timers with delete effects are impulse writes.\n\n---\n\n## 5. Derived Concepts\n\nSeveral concepts from the substrate thesis are derivable from the five primitives rather than being primitive themselves.\n\n### Actions\n\nA sync action is:\n\n```\nscope(registrar, write*(φ_if ∧ φ_enabled, registrar, W_template))\n```\n\nAn action is a standing write, scoped to its registrar's authority, guarded by the conjunction of its precondition (`if`) and its availability (`enabled`), applying a write template.\n\n### Surfaces\n\nA sync surface is:\n\n```\nobserve*(φ_enabled, display_scope, R_render)\n```\n\nA surface is a continuous observation with an enabled predicate and a render function.\n\n### Views\n\nA sync view is:\n\n```\nobserve*(⊤, view_scope, R_project)\n```\n\nA view is an always-active observation that projects private state into a scoped output. The scope boundary controls who can read the projection.\n\n### Capability Delegation\n\nThe most architecturally interesting derived concept. When Bob invokes an action registered by Alice:\n\n```\nscope(alice, write*(φ, alice, W))\n```\n\nThe write executes with Alice's authority regardless of who triggered it. The scope boundary carries the authority. This is capability delegation: Alice creates a bounded capability (the write within her scope), and anyone who can invoke the action exercises that capability.\n\nIn the calculus, this is simply the scoping rule applied to writes. No special mechanism is needed. Authority is structural.\n\n---\n\n## 6. Algebraic Laws\n\nThese are the properties the Σ-calculus satisfies. Each corresponds to a key architectural claim of the substrate thesis and should be provable in Lean.\n\n### Law 1: Commutativity of Composition\n\n```\ne₁ ∥ e₂  ≡  e₂ ∥ e₁\n```\n\nParallel composition is order-independent. There is no \"first\" component. This is the formal expression of \"no orchestration.\"\n\n### Law 2: Associativity of Composition\n\n```\n(e₁ ∥ e₂) ∥ e₃  ≡  e₁ ∥ (e₂ ∥ e₃)\n```\n\nComposition is flat. Nesting is irrelevant. The reef has no hierarchical structure at the composition level.\n\n### Law 3: Identity of Composition\n\n```\ne ∥ ∅  ≡  e\n```\n\nThe empty system is the identity. Adding nothing changes nothing.\n\n*Laws 1–3 establish that (System, ∥, ∅) is a commutative monoid.*\n\n### Law 4: Observer Independence\n\n```\nΣ ; observe(φ, s, R) ∥ E  ⟶*  Σ' ; E'\n    implies\nΣ ; E  ⟶*  Σ' ; E'\n```\n\nRemoving an observer does not change the substrate's evolution. Observers are pure — they perceive but do not affect. This is the formal guarantee that adding a surface cannot break existing behavior.\n\n### Law 5: Scope Isolation\n\n```\nscope(s₁, write(φ, s₁, W₁)) ∥ scope(s₂, write(φ, s₂, W₂))\n    where s₁ ≠ s₂\n    implies W₁ and W₂ write to disjoint locations\n```\n\nWrites in different scopes cannot conflict. Scope boundaries guarantee write isolation. This is the structural basis of authority.\n\n### Law 6: Monotonic Confluence\n\n```\nIf write(φ₁, s, W₁) and write(φ₂, s, W₂) are both monotonic\n(they only add facts, never overwrite or delete),\nthen applying them in either order produces the same substrate.\n```\n\n```\nW₁(W₂(Σ)) = W₂(W₁(Σ))\n```\n\nMonotonic writes commute. This is CALM expressed as an algebraic law. It is the formal reason substrates can scale without coordination — as long as writes only accumulate facts.\n\n### Law 7: Non-Monotonic Serialization\n\n```\nIf write(φ, s, W) is non-monotonic (it overwrites or deletes),\nthen the final substrate depends on application order.\n```\n\n```\n∃ Σ, W₁, W₂:  W₁(W₂(Σ)) ≠ W₂(W₁(Σ))\n```\n\nNon-monotonic writes do not commute. They require serialization — a coordination mechanism that establishes order. This is where \"organs\" appear: bounded regions of serialized, non-monotonic computation surrounded by a monotonic substrate.\n\n*Laws 6 and 7 together formalize the boundary between substrate (monotonic, coordination-free) and organ (non-monotonic, serialized).*\n\n---\n\n## 7. Key Theorems\n\nThese are the propositions to prove in Lean. They represent the core claims of the substrate thesis expressed as formal statements.\n\n### Theorem 1: Compositional Safety\n\n*Adding an observer to a system does not change the set of reachable substrate states.*\n\n```\nreachable(Σ₀, E) = reachable(Σ₀, E ∥ observe(φ, s, R))\n```\n\nThis is the formal version of \"new surfaces can be added without modifying existing ones.\" It follows directly from observer independence (Law 4).\n\n### Theorem 2: Monotonic Confluence\n\n*A system containing only monotonic writes is confluent: regardless of firing order, the same set of facts is eventually established.*\n\n```\nIf all writes in E are monotonic, then:\n∀ execution orders π₁, π₂:\n    terminal(Σ₀, E, π₁) = terminal(Σ₀, E, π₂)\n```\n\nThis is CALM applied to substrate systems. It guarantees that monotonic substrates converge regardless of scheduling nondeterminism.\n\n### Theorem 3: Scope Authority\n\n*A write within scope s can only modify locations in scope s.*\n\n```\nIf  Σ ; scope(s, write(φ, s, W)) ∥ E  ⟶  Σ' ; E'\nthen  ∀ (s', k) where s' ≠ s:  Σ'(s', k) = Σ(s', k)\n```\n\nScope boundaries are inviolable. This is the formal basis for capability delegation — Alice's scope cannot be modified except through actions she has explicitly registered.\n\n### Theorem 4: Activation Determinism\n\n*Given a substrate state, the set of activated components is deterministic, even though the order of their execution is not.*\n\n```\nactivated(Σ, E) = { e ∈ E | guard(e)(Σ) = true }\n```\n\nThe *what* is determined. The *when* is not. This captures the essential character of opportunistic systems: predictable relevance, nondeterministic scheduling.\n\n### Theorem 5: Organ Encapsulation\n\n*If a non-monotonic write is enclosed in a scope, and the scope emits only monotonic facts to the outer substrate, then the outer substrate remains confluent.*\n\n```\nIf  scope(s, E_non_mono)  only adds facts to outer scopes\nthen  the outer system satisfies Theorem 2\n```\n\nThis formalizes the organ pattern: localized non-monotonic computation that emits monotonic results. The organ handles serialization internally; the reef remains coordination-free. The boundary between organ and substrate is the monotonicity boundary.\n\n---\n\n## 8. Expressiveness\n\n### What the Σ-calculus can express\n\n- **Blackboard systems**: Knowledge sources are standing writes. The blackboard is the substrate. Self-activation is predicate guards.\n- **Tuple spaces**: `out` is a write. `rd` is an observation. `in` is a non-monotonic write (read-and-delete) — which correctly requires an organ.\n- **ECA rules**: `ON event IF condition DO action` is `write!(φ_condition, s, W_action)` — an impulse write.\n- **Reactive UI**: Components are continuous observers. State changes trigger re-observation. Virtual DOM diffing is an optimization of continuous observation.\n- **Multi-agent coordination**: Agents are external processes that read the substrate (observe) and invoke writes. The wait-condition-then-act loop is: observe the substrate until a predicate holds, then apply a write.\n\n### What the Σ-calculus cannot express\n\n- **Sequential composition**: There is no \"then.\" Ordering must be encoded in predicates (e.g., \"phase = 2\" guards a write that only makes sense after \"phase = 1\" is established by another write). This is intentional — the calculus models emergence, not sequence.\n- **Recursive computation**: There is no self-reference in terms. A write cannot invoke another write. Recursive patterns must be encoded as chains of predicate-guarded writes that fire in sequence as each establishes the conditions for the next. This is equivalent to tail recursion through state.\n- **Continuous time**: The calculus is discrete. Each step produces a new substrate. Continuous-time behaviors must be approximated through timed impulse writes.\n\nThese limitations are features. The Σ-calculus captures exactly the dynamics of substrate systems and nothing more. Sequential composition and recursion are the domain of the λ-calculus. The Σ-calculus is not a replacement — it is a complement, modeling the emergent dimension that λ-calculus does not address.\n\n---\n\n## 9. Toward Lean\n\nThe formalization strategy for Lean 4:\n\n### Phase 1: Core Types\n\n```lean\n-- Located keys and substrates\nstructure Loc where\n  scope : String\n  key : String\n\ndef Substrate := Loc → Option Val\n\n-- Predicates as decidable propositions\ndef Pred := Substrate → Bool\n\n-- Write and read functions\ndef WriteFn := Substrate → List (Loc × Val)\ndef ReadFn := Substrate → Out\n```\n\n### Phase 2: Terms\n\n```lean\ninductive Term where\n  | fact : String → String → Val → Term\n  | write : Pred → String → WriteFn → Term\n  | observe : Pred → String → ReadFn → Term\n  | par : Term → Term → Term\n  | scope : String → Term → Term\n```\n\n### Phase 3: Reduction\n\n```lean\ninductive Step : Substrate → Term → Substrate → Term → Prop where\n  | activate_write : \n      φ Σ = true → \n      W Σ = writes → \n      all_in_scope s writes →\n      Step Σ (Term.write φ s W) (apply_writes Σ writes) Term.empty\n  | observe_emit :\n      φ Σ = true →\n      R Σ = output →\n      Step Σ (Term.observe φ s R) Σ (Term.observe φ s R)\n  | par_left :\n      Step Σ e₁ Σ' e₁' →\n      Step Σ (Term.par e₁ e₂) Σ' (Term.par e₁' e₂)\n  | par_right :\n      Step Σ e₂ Σ' e₂' →\n      Step Σ (Term.par e₁ e₂) Σ' (Term.par e₁ e₂')\n```\n\n### Phase 4: Theorems\n\n```lean\ntheorem compositional_safety :\n  reachable Σ₀ E S ↔ reachable Σ₀ (Term.par E (Term.observe φ s R)) S\n\ntheorem monotonic_confluence :\n  all_monotonic E → \n  terminal Σ₀ E π₁ = terminal Σ₀ E π₂\n\ntheorem scope_authority :\n  Step Σ (Term.scope s (Term.write φ s W)) Σ' e' →\n  ∀ loc, loc.scope ≠ s → Σ' loc = Σ loc\n```\n\n### Phase 5: Organ Encapsulation\n\n```lean\ntheorem organ_encapsulation :\n  non_monotonic_internally E_organ →\n  monotonic_externally E_organ →\n  all_monotonic E_outer →\n  confluent (Term.par (Term.scope s E_organ) E_outer)\n```\n\n---\n\n## 10. Relationship to Existing Calculi\n\n| Calculus | Models | Composition | Reduction |\n|---|---|---|---|\n| **λ-calculus** | Sequential computation | Function application | β-reduction |\n| **π-calculus** | Mobile processes | Channel passing | Communication |\n| **ambient calculus** | Nested boundaries | Boundary crossing | in/out/open |\n| **Σ-calculus** | Emergent systems | Parallel observation | Activation |\n\nThe λ-calculus asks: what can be computed by applying functions?\n\nThe π-calculus asks: what can be computed by communicating processes?\n\nThe Σ-calculus asks: **what can emerge from self-activating observers of shared truth?**\n\nThese are complementary questions. A complete computational model may require all three: λ for sequential logic, π for communication, Σ for emergence. The substrate thesis claims that the third question has been systematically under-formalized, and that the Σ-calculus is a first attempt at giving it the same algebraic treatment the other two have received.\n\n---\n\n*February 2026 · Edinburgh*\n",[],[424,1394],"a5aea24a-170a-11f1-a338-42dde27851f2","pressure-field.md","a5aea312-170a-11f1-a338-42dde27851f2",209,["D",1772546992185],"# The Pressure Field\n\n## Intellectual Archaeology of the Substrate Thesis\n\n---\n\nThe substrate thesis — *software is a shared substrate of truth observed by self-activating components* — did not emerge from nowhere. It sits at the convergence of several intellectual lineages that each lacked one ingredient the others had. This document maps those lineages, identifies where the thesis extends or departs from them, and locates the points where it will come under pressure.\n\nFour categories: direct ancestors whose work this continues, parallel evolutions that arrived nearby from different starting points, necessary counterpoints where the model is known to break, and ideas that become newly viable now that interpretive agents exist.\n\n---\n\n## I. Direct Ancestors — The Ghost Lineage\n\nThese are ideas the substrate thesis almost perfectly continues. In several cases the rediscovery was unconscious — the architectural pressures simply reconverge on the same solutions.\n\n### 1. Opportunistic Problem Solving (1970s–80s)\n\nBlackboard systems were one expression of a broader program in AI: the idea that intelligence emerges from opportunistic activation rather than centralized planning. No master planner selects the next step. Modules act when local conditions become true. The solution assembles incrementally through the accumulation of locally-justified contributions.\n\nBarbara Hayes-Roth formalized this as opportunistic control. The HEARSAY-II scheduler and HASP's event-driven architecture were both attempts to operationalize it. The difficulty was always the same: the conceptual model is controllerless, but every implementation reintroduced scheduling through the back door.\n\nThe substrate thesis continues this program directly. Surfaces activate when `enabled(state)` becomes true — pure opportunistic activation. The departure: replacing symbolic inference modules with semantic agents that can tolerate open-world state. The control problem dissolves not through better scheduling but through agents that self-select their own attention via declarative wait conditions.\n\nThis lineage provides vocabulary for explaining emergence without mysticism. \"Opportunistic activation\" is a forty-year-old term with a precise technical meaning. Using it anchors the substrate thesis in established AI, not speculative metaphor.\n\n### 2. Linda and Tuple Spaces (Gelernter, 1985)\n\nDavid Gelernter's Linda proposed a radical coordination primitive: processes should not know each other exists. They coordinate through a shared associative space, not through messaging. Three operations — `out` (write a tuple), `rd` (read by pattern), `in` (read and consume) — and nothing else. No channels, no addresses, no identity.\n\nThe substrate model does exactly this. Actions write facts to scoped state. Surfaces observe patterns in that state. Agents never communicate directly — they read context and act on what they see. The room is the tuple space. The CEL wait condition is pattern matching. The action invocation is `out`.\n\nsync's scoped key-value state is essentially a typed tuple space with policy enforcement (scope authority) and temporal lifecycle (timers). The playtest boundary between agents and the game engine is a tuple-space interface with additional semantic structure.\n\nThe insight this provides: the substrate thesis has accidentally built a semantic Linda. The original Linda failed to gain traction partly because processes couldn't interpret unstructured tuples meaningfully. Language models can. The tuple space becomes viable when the readers are interpretive rather than procedural.\n\n### 3. Functional Reactive Programming (Elliott & Hudak, 1997)\n\nFRP's central claim: behavior is a function of time-varying values. Signals change; dependent computations recompute. The entire system is a declarative dependency graph over time.\n\nFRP stalled for two reasons. First, humans reason poorly about continuous time — the signal abstraction is mathematically clean but cognitively opaque. Second, dependency graphs explode combinatorially in real applications. Debugging a reactive system at scale is notoriously difficult.\n\nThe substrate thesis takes the reactive recomputation principle but replaces continuous signals with discrete ontology. State is not a time-varying value — it is a collection of facts with versions. Activation is semantic (\"the phase is endgame and the player has the key\") rather than numerical. Views recompute lazily at read time, not eagerly on every change.\n\nThis makes FRP narratively legible. A surface's enabled expression reads like a sentence about the world, not like a signal graph. The tradeoff: you lose FRP's compositionality guarantees and its formal reasoning about time. What you gain is a model that agents and humans can both interpret.\n\n### 4. Smalltalk and Moldable Development (Kay, 1972; Gîrba, 2019)\n\nAlan Kay's foundational conviction: systems should be live environments for thought, not frozen artifacts. Smalltalk was designed so that every object could be inspected, modified, and extended at runtime. The system was always in a state of becoming.\n\nTudor Gîrba's Glamorous Toolkit extended this into \"moldable development\" — the idea that developers should build custom tools for every problem instance rather than using generic tools for all problems. The tool adapts to the problem, not the reverse.\n\nctxl pushes this one step further. The tool not only molds to the problem — it reasons about its own molding. A component that participates in AI reasoning during its own lifecycle is not just live and inspectable. It is self-interpreting. It can perceive the gap between its current form and the user's evolving intent and reshape itself in response.\n\nThis is historically new. Kay made the system inspectable. Gîrba made the tools adaptable. ctxl makes the adaptation itself intelligent. The component doesn't wait for a programmer to reshape it — it participates in the reshaping.\n\n---\n\n## II. Parallel Evolutions — Same Mountain, Different Trail\n\nThese ideas were not trying to solve the substrate problem, but their trajectories passed close enough to illuminate it.\n\n### 5. The Actor Model (Hewitt, 1973; Agha, 1986)\n\nActors are independent entities with private state that communicate exclusively through asynchronous message passing. No shared memory. Coordination is explicit — you send a message and handle the response.\n\nThe substrate model inverts every commitment the actor model makes:\n\n| Actor Model | Substrate Model |\n|---|---|\n| Isolate state | Share state |\n| Communicate via messages | Observe truth |\n| Coordination is explicit | Coordination is emergent |\n| Scale predictably | Scale compositionally |\n\nActors solve the coordination problem by eliminating shared state. The substrate solves it by making shared state the *only* coordination mechanism. These are dual approaches. Each has failure modes the other avoids.\n\nThe tension is productive. playtest actually hybridizes them: agents are actor-like (independent, token-authenticated, private state), but the game engine is a substrate (shared state, declarative observation, emergent interaction). The agent boundary enforces actor discipline. The engine interior enables substrate dynamics. This hybrid may be the natural resting point.\n\n### 6. Event-Condition-Action Systems (1990s databases)\n\nDatabase trigger systems explored ECA rules: on an event, if a condition holds, execute an action. This was the database world's attempt at reactive computation.\n\nSurfaces follow the same structure but with a critical substitution:\n\n```\nECA:       ON event  →  IF condition  →  DO action\nSurface:                IF condition(state)  →  RENDER affordance\n```\n\nECA systems automate behavior — the action fires without human involvement. Surfaces expose affordances — they present possible actions to an observer (human or agent) without executing them. The system shifts from automation to participation. The observer decides.\n\nThis distinction matters because it preserves agency. An ECA system that fires automatically is an optimizer. A surface that presents options is a collaborator. The substrate thesis is not about automating workflows — it is about creating environments where intelligent participants can perceive and act.\n\n### 7. Affordance Theory (Gibson, 1979; Norman, 1988)\n\nJames Gibson's ecological psychology proposed that environments present possible actions directly to perception. A flat horizontal surface affords sitting. A handle affords pulling. Affordances are not properties of objects or properties of agents — they are relationships between the two.\n\nThis is strikingly aligned with the substrate model. A surface is literally an affordance declaration: given this state of the world, these actions are available. Agents and humans perceive the same action space, expressed through different modalities (JSON for agents, buttons for humans). The `/context` endpoint is an affordance map.\n\nNorman adapted Gibson for design: affordances should be perceptible, not hidden. The substrate thesis takes this further — affordances should be declarative and self-documenting. An action in sync carries its parameter schema, its precondition expression, and its write templates. The affordance doesn't just exist; it explains itself.\n\nThis gives the substrate thesis philosophical grounding outside computer science entirely. The model is not just an architecture — it is a theory of environmental perception applied to software.\n\n---\n\n## III. Necessary Counterpoints — Where the Model Breaks\n\nThese are the pressure points. Ignoring them produces intellectual overfitting.\n\n### 8. Statecharts (Harel, 1987)\n\nDavid Harel invented statecharts because pure reactive systems become incomprehensible at scale. Statecharts add hierarchy (nested states), explicit transitions (named edges between states), and deterministic semantics (given a state and an event, the next state is unambiguous).\n\nThe substrate thesis rejects centralized transitions — surfaces activate based on local conditions, not explicit state transitions. But every large reactive system eventually rediscovers the need for phase structure. What started as an emergent reef eventually needs someone to say \"we are now in the endgame phase, and these three things must happen in this order.\"\n\nsync already acknowledges this through the \"organs\" concept: localized state machines that resolve constraints and emit updated facts. The organ handles the exclusive, sequential logic. The reef never sees the imperative mechanics — only the resulting truth propagates. But the prediction is clear: organs will appear sooner and more often than the pure-substrate vision suggests. The question is whether organ boundaries can remain local or whether they eventually reconnect into something resembling a global statechart.\n\n### 9. Workflow Systems and Auditability (BPMN, enterprise patterns)\n\nEnterprise workflow systems learned a painful lesson over three decades: emergence is flexible, but auditability and guarantees matter. When something goes wrong — and it will — you need to answer: Who caused this change? Can we replay the sequence deterministically? Can we prove that certain invariants were maintained?\n\nsync's audit log (every action invocation recorded to the `_audit` scope with agent, action, params, and success/failure) is an implicit acknowledgment of this pressure. But audit logging is the easy part. The hard questions are about invariants: can the system guarantee that a resource is never double-claimed? That a phase transition is irreversible? That a sequence of writes is atomic across scopes?\n\nCurrently, sync handles these through CEL preconditions (`if` expressions on actions) and CAS version checks (`if_version`). These are sufficient for cooperative agents but may not survive adversarial conditions or complex multi-step transactions. The substrate thesis needs a clear answer to: what are the consistency guarantees, and where do they come from?\n\n### 10. The CALM Theorem (Hellerstein, 2010)\n\nThe most theoretically significant counterpoint. The CALM theorem (Consistency As Logical Monotonicity) proves that programs that are logically monotonic — that only accumulate facts, never retract them — do not require coordination for distributed consistency. Monotonic programs are eventually consistent without locks, barriers, or consensus protocols.\n\nThe substrate thesis is implicitly chasing monotonicity. Additive surfaces, append-only audit logs, and accumulating state entries are all monotonic patterns. When the substrate grows only by addition, coordination is unnecessary — exactly as CALM predicts.\n\nBut non-monotonic operations — deletion, replacement, counter resets — require coordination. This explains precisely why \"organs\" appear in the architecture: they are the coordination boundaries around non-monotonic operations. An organ resolves a constraint (a compare-and-swap, an exclusive claim, an atomic phase transition) and emits a monotonic fact that the rest of the substrate can safely observe.\n\nCALM provides the formal foundation for the intuition that substrates scale compositionally while organs handle guarantees. It also predicts where the architecture will need explicit coordination: wherever facts must be retracted or overwritten rather than accumulated. The substrate thesis is rediscovering distributed consistency theory through UX design. CALM tells you exactly where the seams will appear.\n\n---\n\n## IV. Newly Viable Ideas — Unlocked by Interpretive Agents\n\nThese ideas existed in theory but lacked the computational environment to work. Language models supply the missing ingredient.\n\n### 11. Situated Cognition (Suchman, 1987; Varela, 1991)\n\nSituated cognition holds that thinking happens in interaction with the environment, not in internal representation. Plans are not executed — they are resources for action in context. Cognition is not a program running in the head; it is a dynamic coupling between agent and world.\n\nThe substrate thesis externalizes cognition into the substrate. An agent's reasoning is not separable from the state it observes — the context *is* the cognitive context. The wait-condition-then-act loop is situated cognition operationalized: the agent does not plan ahead, it perceives the current state and responds.\n\nClark and Chalmers' extended mind thesis (1998) goes further: if an external resource plays the same functional role as an internal cognitive process, it is part of cognition. The substrate literally becomes part of the agent's mind. This is not metaphor — it is the functional reality of an LLM whose context window contains the room state.\n\n### 12. Second-Order Cybernetics (von Foerster, 1974; Maturana & Varela)\n\nClassical cybernetics studied systems that regulate themselves. Second-order cybernetics studied systems that observe themselves observing — the observer is part of the system being observed.\n\nSurfaces already exhibit first-order self-reference: their enabled expressions introspect the state that includes the effects of other surfaces' actions. ctxl components that rewrite themselves complete the second-order loop — the system describes itself, and the description is executable.\n\nThe substrate becomes self-describing when the `_dashboard` configuration — which defines what surfaces exist and how they activate — is itself stored in the substrate's state. The UI definition is state. State mutations reshape the UI. The system observes its own observation layer and can modify it. This is second-order cybernetics realized in a web application.\n\n### 13. Artificial Life and Emergent Narrative\n\nArtificial life research (Langton, 1989; Reynolds, 1987) demonstrated that simple local rules produce global structure — flocking, self-organization, emergent complexity. But artificial life systems lacked semantic agents. The emergent structures were geometric or statistical, not meaningful.\n\nThe substrate thesis adds meaning-producing observers. Surfaces don't just react to state changes — they interpret them. A narrative surface renders a story. A metric surface highlights significance. An action-bar surface presents agency. The emergent structure is not a flock — it is a story, a game, a workflow, a collaborative investigation.\n\nReef plus interpretation equals narrative emergence. This is what artificial life couldn't achieve: emergent structure that is also semantically coherent to human participants.\n\n---\n\n## The Convergence\n\nAcross all thirteen lineages, a pattern emerges. Each field had the substrate thesis almost within reach but was missing exactly one ingredient:\n\n| Field | Missing Ingredient |\n|---|---|\n| Blackboard AI | Interpreters tolerant of open-world state |\n| Functional Reactive Programming | A semantic meaning layer |\n| Actor systems | Shared ontology for coordination |\n| UX and design | Executable, self-documenting affordances |\n| Distributed systems | Integration with human cognition |\n| Tuple spaces | Readers that can interpret unstructured data |\n| Artificial life | Meaning-producing observers |\n\nLanguage models supply most of these missing ingredients simultaneously. They are interpreters tolerant of open worlds. They produce semantic meaning from unstructured data. They can read affordance descriptions and act on them. They integrate with human cognition through natural language.\n\nThis is not a coincidence. It is the reason the substrate thesis becomes viable now and not in 1986 or 1997 or 2010. The computational environment finally matches the conceptual model.\n\n---\n\n## The Stress Test\n\nOne question disciplines the entire intellectual framework:\n\n**Is orchestration fundamentally unnecessary, or merely delayed?**\n\nEvery previous generation believed emergence would replace coordination. Every generation eventually reintroduced structure. HEARSAY-II's conceptually controllerless model got a scheduler. Actor systems got supervision trees. Microservices got service meshes. The pattern is consistent enough to be a law.\n\nThe likely equilibrium is not pure substrate and not pure orchestration. It is:\n\n- **Substrate** for exploration and composition\n- **Organs** for guarantees and invariants  \n- **Interpretation** for meaning and perception\n- **Agents** as adaptive glue between layers\n\nThis is not replacing programming. It is moving programming one layer down the stack — from scripting behavior to shaping the conditions under which behavior can arise. The programmer becomes a physicist of a small universe, defining laws rather than stories.\n\nWhether that constitutes a genuine paradigm shift or merely a useful architectural pattern is a question that can only be answered by building systems that succeed or fail under these assumptions. The historical evidence says: the pattern is real, the risks are known, and the missing ingredients are now available.\n\n---\n\n*February 2026 · Edinburgh*\n\n### References and Further Reading\n\n- Nii, H.P. (1986). The Blackboard Model of Problem Solving. *AI Magazine* 7(2).\n- Hayes-Roth, B. (1985). Blackboard Architecture for Control. *Journal of Artificial Intelligence* 26.\n- Gelernter, D. (1985). Generative Communication in Linda. *ACM TOPLAS* 7(1).\n- Elliott, C. & Hudak, P. (1997). Functional Reactive Animation. *ICFP*.\n- Hewitt, C. (1973). A Universal Modular ACTOR Formalism. *IJCAI*.\n- Agha, G. (1986). *Actors: A Model of Concurrent Computation in Distributed Systems*. MIT Press.\n- Gibson, J.J. (1979). *The Ecological Approach to Visual Perception*. Houghton Mifflin.\n- Norman, D. (1988). *The Design of Everyday Things*. Basic Books.\n- Harel, D. (1987). Statecharts: A Visual Formalism for Complex Systems. *Science of Computer Programming* 8(3).\n- Hellerstein, J. (2010). The Declarative Imperative. *SIGMOD Record* 39(1).\n- Alvaro, P. et al. (2011). Consistency Analysis in Bloom. *CIDR*.\n- Suchman, L. (1987). *Plans and Situated Actions*. Cambridge University Press.\n- Clark, A. & Chalmers, D. (1998). The Extended Mind. *Analysis* 58(1).\n- Von Foerster, H. (1974). *Cybernetics of Cybernetics*. University of Illinois.\n- Kay, A. (1972). A Personal Computer for Children of All Ages. *ACM National Conference*.\n- Gîrba, T. (2019). Moldable Development. *Onward!*\n- Selfridge, O. (1959). Pandemonium: A Paradigm for Learning. *Symposium on the Mechanization of Thought Processes*.\n- Langton, C. (1989). *Artificial Life*. Addison-Wesley.\n",[],[424,1402],"a587131a-170a-11f1-a338-42dde27851f2","isnt-this-just-react.md","a5871414-170a-11f1-a338-42dde27851f2",205,["D",1772546991894],"# Isn't This Just ReAct?\n\nThe two-operation agent loop at the heart of sync — wait for a condition to become true, then act — looks, at first glance, like a familiar pattern. ReAct (Yao et al., 2023) interleaves reasoning and acting. OODA observes, orients, decides, acts. SOAR perceives, selects an operator, applies it. BDI updates beliefs, generates desires, forms intentions, executes. Every agent architecture in the history of AI eventually reduces to some variant of *look at the world, do something, look again*.\n\nSo: is sync's Wait-Act loop just ReAct with a different name?\n\nNo. And the difference is not cosmetic. It is architectural, and it maps onto a gap in the academic literature that, as of early 2026, remains almost entirely unaddressed.\n\n---\n\n## The ReAct Loop\n\nReAct's contribution (Yao et al., ICLR 2023) is the interleaving of *reasoning traces* with *action execution* inside a single generation:\n\n```\nThought[1]: I need to find X.\nAction[1]: Search[\"X\"]\nObservation[1]: [results]\nThought[2]: Now I should check Y.\nAction[2]: Lookup[\"Y\"]\nObservation[2]: [results]\nThought[3]: The answer is Z.\nAction[3]: Finish[\"Z\"]\n```\n\nThe agent drives the loop. It decides what to think about, which tool to call, and when to stop. The observation is the *result of its own action* — a search result, a lookup response, a tool output. The world exists only as a set of instruments the agent chooses to invoke.\n\nThis is powerful for single-agent reasoning tasks. It is also, structurally, a *tool-use pattern*. The agent is the protagonist. The environment is a service counter. Toolformer (Schick et al., 2023) makes this explicit: the model learns to insert API calls mid-generation when doing so would improve its predictions. Tools are ephemeral extensions of the agent's capabilities, discarded after use.\n\n## The Inversion\n\nSync's loop looks superficially similar:\n\n```\nWait(condition over shared state) → Observe(full context) → Act(invoke action) → Wait...\n```\n\nBut every structural commitment is inverted.\n\n**Who drives the loop?** In ReAct, the agent decides when to observe. In sync, the agent declares a relevance predicate — a CEL expression over the room's shared state — and *blocks*. The world decides when the agent is relevant. The agent does not pull observations; observations are pushed when reality satisfies the agent's declared condition. The agent sleeps until the world has something to say to it.\n\n**What is observed?** In ReAct, the observation is the result of the agent's own action — a tool response, scoped to what the agent asked for. In sync, the observation is the *entire room context*: all visible state, all computed views, all available actions with their parameter schemas, all present agents. The agent perceives not just an answer but a world — including what it *can do* in that world, which may have changed since it last looked.\n\n**Where does coordination happen?** ReAct is single-agent. If you run two ReAct agents, they need external orchestration to avoid stepping on each other. In sync, coordination is dissolved into the substrate. Multiple agents watch the same state. When one agent writes, another agent's wait condition may fire. No message passes between them. No orchestrator sequences them. Coordination is a side effect of shared reality.\n\n**What persists?** A ReAct trace is ephemeral — it exists within a single generation and vanishes. Sync's state is persistent and shared. An agent's action mutates the world for all participants. The substrate is not a scratchpad; it is the ground truth of a multi-agent reality.\n\nThe distinction maps onto a classical divide in cognitive science. ReAct agents are **tool-users operating in a vacuum**. Sync agents are **situated beings in a shared world**. Lucy Suchman would recognize the difference immediately: ReAct agents execute plans; sync agents perceive environments and respond to what they find (Suchman, 1987).\n\n---\n\n## The Landscape\n\nTo understand where sync sits, it helps to map the current academic terrain for LLM agent coordination. The dominant paradigms, as of 2026, are:\n\n**Message-passing frameworks.** AutoGen (Wu et al., 2023) coordinates agents through multi-turn conversation — agents talk to each other, directly, by name. CAMEL (Li et al., NeurIPS 2023) pairs agents in role-playing dialogues with inception prompting. Google's A2A protocol standardizes agent-to-agent communication over JSON-RPC. In all of these, agents must discover each other, address messages to specific recipients, and negotiate interaction. Coordination is explicit. The system scales in wiring complexity proportional to the number of agent relationships.\n\n**Orchestrated workflows.** LangGraph models agents as nodes in a directed graph with typed state flowing along edges. MetaGPT (Hong et al., 2023) encodes Standardized Operating Procedures — fixed role sequences modeled on human organizational charts. CrewAI combines event-driven Flows with role-specialized Crews. In all of these, someone must design the graph, write the SOP, define the flow. The workflow is prescribed. Structure is imposed, not emergent.\n\n**Single-agent reasoning loops.** ReAct, Reflexion (Shinn et al., NeurIPS 2023), Voyager (Wang et al., 2023), chain-of-thought, tree-of-thought — these are patterns for making individual agents more capable. They have nothing to say about coordination. If you want two Reflexion agents to collaborate, you are on your own.\n\nWhat is conspicuously absent from this landscape is **environment-mediated coordination through shared mutable state with declarative self-activation**.\n\n---\n\n## The Precedent That Almost Exists\n\nOne published system comes close. Park et al.'s *Generative Agents* (UIST 2023) — the Smallville paper — placed twenty-five LLM agents in a shared simulated environment. Agents coordinated not through messages but through the environment itself: they observed each other's actions, perceived the state of shared spaces, and self-activated based on what they saw. A single seed — one agent wanting to throw a Valentine's Day party — cascaded through the environment as agents observed, inferred, and responded. Social structure emerged without orchestration.\n\nSmallville demonstrates that environment-mediated coordination produces emergent behavior in LLM multi-agent systems. It is, arguably, the most important empirical result in the field for sync's thesis. But Smallville is a simulation, not an architecture. It has no authority model — any agent can do anything. No capability delegation — actions are not scoped. No structured observation — agents perceive natural-language descriptions of a spatial world, not typed state with computed views. No declarative activation — agents run on a clock tick and decide for themselves whether to act, rather than declaring a predicate and blocking.\n\nSync takes Smallville's empirical insight and gives it infrastructure: scoped authority, structured state, declarative activation, capability delegation, atomic writes, audit trails. The move from simulation to substrate.\n\n---\n\n## The Word Nobody Is Using\n\nThere is a term for what sync does. It comes not from computer science but from entomology.\n\n**Stigmergy** — coined by Pierre-Paul Grassé in 1959, studying termite nest construction — is indirect coordination through modification of a shared environment. Agents do not communicate. They leave traces in a medium. Other agents perceive those traces and respond. The pheromone trail is the paradigmatic example: no ant tells another ant where to go. Each ant deposits a chemical trace; the accumulated traces create a gradient; the gradient coordinates the colony.\n\nThe defining properties of stigmergy are:\n\n- No direct communication between agents\n- Coordination emerges from cumulative environmental modification\n- Self-organization without central control\n- The environment is simultaneously the communication medium and the work product\n\nEvery one of these properties describes sync. Agents never message each other. Coordination emerges from writes to shared state. No orchestrator sequences activation. The room's state is both the communication medium (agents read what other agents have written) and the work product (the state *is* the game, the workflow, the investigation).\n\nA search of the academic literature for \"stigmergy\" combined with \"large language model\" or \"LLM agents\" returns, as of early 2026, **zero results**. The swarm intelligence community has studied stigmergy for decades. The LLM agent community has not adopted the concept. This is a remarkable gap, because stigmergy is arguably the natural coordination model for language-model agents — entities that are good at interpreting ambiguous environmental signals and acting on them, which is exactly what stigmergic coordination requires.\n\nSync is, to the best of available evidence, the first practical implementation of stigmergic coordination for LLM agents.\n\n---\n\n## Blackboard, Revisited\n\nThe AI community's closest approach to stigmergy was the **blackboard architecture** (Nii, 1986). HEARSAY-II (speech recognition) and HASP (sonar interpretation) used a shared data structure — the blackboard — watched by independent knowledge sources that activated when they recognized patterns they could contribute to.\n\nThe blackboard architecture had the right shape: shared state, independent observers, opportunistic activation. It failed for a specific reason: the knowledge sources were hand-coded pattern matchers. They could not tolerate ambiguity, could not interpret novel situations, could not reason about open-world state. Every implementation eventually reintroduced a scheduler — a centralized controller that selected which knowledge source to run next — because the knowledge sources themselves could not reliably self-select (Hayes-Roth, 1985).\n\nSync's claim is that language models resolve the blackboard architecture's control problem. A CEL predicate declares when an agent is relevant. The agent itself — an LLM capable of interpreting ambiguous, open-world state — decides what to do when activated. No scheduler selects the next agent. The wait condition *is* the selection mechanism, and the LLM *is* the knowledge source that can finally tolerate the open-world ambiguity that broke HEARSAY-II.\n\nThis is a forty-year-old architecture whose missing ingredient has arrived.\n\n---\n\n## The Coordination Taxonomy\n\nThe Cognitive Architectures for Language Agents framework (CoALA; Sumers et al., 2024) proposes a unified model for LLM agents built from modular memory, structured action spaces, and generalized decision-making cycles. It is the most serious attempt to bridge cognitive science and LLM agent design.\n\nCoALA's taxonomy helps locate sync precisely. CoALA distinguishes:\n\n- **Internal actions** (reasoning, retrieval, reflection — operations on the agent's own memory)\n- **External actions** (tool calls, environment interactions — operations on the world)\n\nIn ReAct, the loop alternates between internal actions (Thought) and external actions (Action). The agent manages both. In sync, the substrate takes over the external action space entirely. The agent's internal reasoning is invisible to the system — it happens inside the LLM's context window, between receiving the observation and choosing which action to invoke. The substrate sees only two events: the wait condition firing (observation delivered) and the action invocation (decision executed). Everything between is the agent's private cognition.\n\nThis maps to the OODA loop with a specific compression:\n\n| OODA | Sync |\n|------|------|\n| **Observe** | `/wait` returns full context |\n| **Orient** | *(inside the LLM — invisible to substrate)* |\n| **Decide** | *(inside the LLM — invisible to substrate)* |\n| **Act** | `/invoke` mutates state |\n\nSync does not model orientation or decision-making. It provides the perceptual field (context) and the action space (available actions with schemas). What the agent does with that information is the agent's business. The substrate is agnostic about cognition. It cares only about perception and action.\n\nThis is a deliberate architectural choice, and it has a name in ecological psychology. James Gibson (1979) argued that organisms do not build internal models of the world and then reason about them. They perceive *affordances* — possibilities for action that the environment presents directly to perception. A handle affords pulling. A flat surface affords sitting. Perception and action are coupled without an intermediate reasoning layer.\n\nSync's `/context` endpoint is an affordance map. It returns not just the state of the world but the available actions — what the agent *can do*, given the current state, given the agent's authority. The agent does not query for capabilities. The capabilities are presented as part of perception. This is Gibson's ecological psychology implemented as a REST API.\n\n---\n\n## What the Frameworks Are Missing\n\nThe comparative table makes the gap visible:\n\n| Framework | Activation | Coordination | State |\n|-----------|-----------|--------------|-------|\n| ReAct | Agent-driven | None | Ephemeral trace |\n| Reflexion | Agent-driven | None | Episodic memory |\n| Voyager | Curriculum-driven | None | Skill library |\n| AutoGen | Message receipt | Direct messaging | Conversation |\n| CAMEL | Message receipt | Role-play dialogue | Conversation |\n| MetaGPT | Workflow position | Shared message pool | Artifacts along SOP |\n| LangGraph | Graph traversal | State along edges | Typed dict per edge |\n| CrewAI | Event trigger | Hierarchical delegation | Flow state |\n| Generative Agents | Clock tick | Environment-mediated | Spatial simulation |\n| **Sync** | **Declarative predicate** | **Shared mutable substrate** | **Persistent, scoped, versioned** |\n\nThree columns. In every existing framework, at least one column defaults to the simple case (no coordination, ephemeral state, agent-driven activation). Sync is the only system that commits to the complex case in all three simultaneously: declarative self-activation, environment-mediated coordination, and persistent shared state with authority boundaries.\n\nThe reason this combination is rare is that it requires solving three problems at once:\n\n1. **Self-activation without scheduling** — the blackboard problem, resolved by declarative CEL predicates and LLM observers\n2. **Coordination without messaging** — the stigmergy problem, resolved by shared mutable state as the sole interaction medium\n3. **Authority without centralization** — the capability problem, resolved by scoped write templates with delegated authority\n\nEach of these problems has been solved individually in other contexts. Sync solves them in combination, and the combination produces something none of the individual solutions provide: a substrate where multiple autonomous agents can participate in a shared reality without any agent or controller holding the complete picture.\n\n---\n\n## A REPL for the Mind\n\nThere is an older metaphor that keeps surfacing. Steve Jobs called the computer \"a bicycle for the mind\" — an amplifier for human cognitive capability, the way a bicycle amplifies human locomotion. The metaphor assumes a single rider, a single destination, a tool that extends one person's reach.\n\nSync suggests a different metaphor. Not a bicycle — a vehicle that takes you somewhere — but a **REPL**: a read-evaluate-print loop, an interactive environment where you express something, the world responds, and the response reshapes your next expression. The REPL is not a tool you use to accomplish a goal. It is a *medium you think in*. The loop between perception and action is not a means to an end; it is the cognitive process itself.\n\nClark and Chalmers' extended mind thesis (1998) argues that if an external resource plays the same functional role as an internal cognitive process, it is part of cognition. The notebook is part of memory. The calculator is part of arithmetic. The room — the shared state substrate — is part of *understanding*. An agent's context window, loaded with the room's state, views, and affordances, is not a representation of reality that the agent reasons *about*. It is the cognitive environment the agent reasons *within*. The substrate is not a bicycle that takes cognition somewhere. It is the medium in which cognition happens.\n\nWhen multiple agents share that medium, something new emerges. Each agent's action becomes part of every other agent's perceptual field. Understanding is no longer private — it is distributed across the substrate, accumulating through the stigmergic traces of every participant's reasoning. The REPL becomes multiplayer. The loop between perception and action runs not inside one mind but across many, with the shared state as the connective tissue.\n\nThis is what the Generative Agents experiment demonstrated empirically: twenty-five agents, perceiving a shared environment, produced emergent social behavior — party planning, relationship formation, information diffusion — that no single agent intended or controlled. The REPL ran across all of them simultaneously, with the environment as the shared evaluation context.\n\n---\n\n## The Academic Gap\n\nThe literature reveals a surprising pattern. The three concepts that sync combines — stigmergy, blackboard architectures, and ecological affordances — are each well-established in their home fields. Stigmergy has decades of research in swarm intelligence. Blackboard systems have a canonical survey (Nii, 1986) and a substantial AI literature. Affordance theory has been influential in HCI since Norman's *Design of Everyday Things* (1988). Each field arrived independently at a piece of the architecture sync implements.\n\nBut the intersection — stigmergic coordination of LLM agents through a shared affordance-rich substrate with declarative self-activation — has no direct precedent in the published literature. The closest work is:\n\n- **Generative Agents** (Park et al., 2023) — environment-mediated coordination, but as a simulation without infrastructure\n- **CA-MCP** (Jayanti & Han, 2026) — shared context store for MCP servers, but as an optimization layer, not a coordination substrate\n- **MACOG** (Khan et al., 2025) — blackboard terminology, but with a centralized finite-state orchestrator\n- **KoMA** (Jiang et al., 2024) — shared memory for autonomous driving agents, but domain-specific\n\nNone of these proposes a general-purpose shared-state substrate with self-activation as the primary coordination mechanism for LLM agents.\n\nThe CALM theorem (Hellerstein, 2010) — which proves that monotonic programs need no coordination for consistency — provides formal grounding for *why* this architecture works. Sync's additive surfaces, append-only audit logs, and accumulating state entries are monotonic patterns. Where non-monotonic operations are needed (deletion, replacement, counter resets), sync introduces \"organs\" — bounded coordination regions that resolve constraints and emit monotonic facts. This is distributed consistency theory applied to agent coordination, though the connection to CALM has not been made explicit in the agent systems literature.\n\n---\n\n## Not ReAct\n\nSo, no — this is not ReAct.\n\nReAct is a prompting strategy for making single agents more capable at tool use. It is an important contribution, and it works. But it has nothing to say about coordination, shared state, authority, or emergence. It is a bicycle — one rider, one destination, one tool at a time.\n\nSync is a shared environment in which multiple agents perceive, act, and inadvertently coordinate through the accumulated traces of each other's reasoning. It is closer to an ecology than a tool. The Wait-Act loop is not a reasoning strategy; it is a mode of existence — a way of being situated in a world that other agents are simultaneously situated in, where the act of perceiving is also the act of being perceived, and where meaning accumulates not in any single agent's trace but in the shared substrate that all of them inhabit.\n\nThe academic literature has the pieces. Stigmergy from swarm intelligence. Blackboards from classical AI. Affordances from ecological psychology. Situated cognition from Suchman and Clark. CALM from distributed systems. Generative Agents as empirical proof of concept. What it lacks is the synthesis — the recognition that these pieces fit together into a coherent architecture for multi-agent coordination, and that language models are the missing ingredient that makes the architecture viable.\n\nThat synthesis is what sync attempts. Whether it succeeds is an empirical question. But the claim is precise enough to be tested: that shared mutable state with declarative self-activation, scoped authority, and affordance-rich context is a sufficient coordination substrate for autonomous LLM agents — and that orchestration, messaging, and workflow prescription are not merely unnecessary but actively counterproductive, because they prevent the emergent coordination that arises when intelligent agents are simply left alone in a shared world with the right perceptual structure.\n\n---\n\n## References\n\n- Yao, S., et al. (2023). \"ReAct: Synergizing Reasoning and Acting in Language Models.\" ICLR 2023. arXiv:2210.03629.\n- Park, J.S., et al. (2023). \"Generative Agents: Interactive Simulacra of Human Behavior.\" UIST 2023. arXiv:2304.03442.\n- Wu, Q., et al. (2023). \"AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation.\" arXiv:2308.08155.\n- Hong, S., et al. (2023). \"MetaGPT: Meta Programming for Multi-Agent Collaborative Framework.\" arXiv:2308.00352.\n- Li, G., et al. (2023). \"CAMEL: Communicative Agents for Mind Exploration of Large Language Model Society.\" NeurIPS 2023. arXiv:2303.17760.\n- Wang, G., et al. (2023). \"Voyager: An Open-Ended Embodied Agent with Large Language Models.\" arXiv:2305.16291.\n- Shinn, N., et al. (2023). \"Reflexion: Language Agents with Verbal Reinforcement Learning.\" NeurIPS 2023. arXiv:2303.11366.\n- Schick, T., et al. (2023). \"Toolformer: Language Models Can Teach Themselves to Use Tools.\" arXiv:2302.04761.\n- Sumers, T.R., et al. (2024). \"Cognitive Architectures for Language Agents.\" arXiv:2309.02427.\n- Nii, H.P. (1986). \"The Blackboard Model of Problem Solving.\" AI Magazine 7(2).\n- Hayes-Roth, B. (1985). \"Blackboard Architecture for Control.\" Journal of Artificial Intelligence 26.\n- Gelernter, D. (1985). \"Generative Communication in Linda.\" ACM TOPLAS 7(1).\n- Gibson, J.J. (1979). *The Ecological Approach to Visual Perception.* Houghton Mifflin.\n- Norman, D. (1988). *The Design of Everyday Things.* Basic Books.\n- Suchman, L. (1987). *Plans and Situated Actions.* Cambridge University Press.\n- Clark, A. & Chalmers, D. (1998). \"The Extended Mind.\" Analysis 58(1).\n- Grassé, P.-P. (1959). \"La reconstruction du nid et les coordinations interindividuelles chez Bellicositermes natalensis.\" Insectes Sociaux 6(1).\n- Hellerstein, J. (2010). \"The Declarative Imperative.\" SIGMOD Record 39(1).\n- Harel, D. (1987). \"Statecharts: A Visual Formalism for Complex Systems.\" Science of Computer Programming 8(3).\n- Jayanti, M.A. & Han, X.Y. (2026). \"Enhancing MCP with Context-Aware Server Collaboration.\" arXiv:2601.11595.\n- Khan, R.N.H., et al. (2025). \"MACOG: Multi-Agent Code-Orchestrated Generation.\" arXiv:2510.03902.\n- Jiang, K., et al. (2024). \"KoMA: Knowledge-driven Multi-agent Framework for Autonomous Driving.\" arXiv:2407.14239.\n- Bratman, M. (1987). *Intention, Plans, and Practical Reason.* Harvard University Press.\n- Brooks, R. (1986). \"A Robust Layered Control System for a Mobile Robot.\" IEEE Journal of Robotics and Automation 2(1).\n\n*March 2026*\n",[],[424,1410],"a5807492-170a-11f1-bc60-42dde27851f2","introducing-sync.md","a5807546-170a-11f1-bc60-42dde27851f2",204,["D",1772546991888],"What follows is not a technical introduction so much as a narrative argument — tracing a line from three games that each grapple with the same hidden question, through decades of research that arrive at the same threshold from different directions, to a small system that attempts to cross it.\n\nThe question: **What does it mean to interact with a world that already exists?**\n\n---\n\n## I. The Fire in the Dark\n\nThe original *A Dark Room* begins almost aggressively small. A single line of text. A cold fire. One button. Nothing to optimize, nothing to explore, nothing even resembling a game in the conventional sense. The player is not invited into a world so much as left alone in an absence.\n\nThen something subtle happens. You light the fire, and the interface does not change — it grows. A villager appears. A resource counter materializes. A new action becomes available. Another. Then another. Hours later, you realize you are managing a settlement, sending expeditions into hostile territory, navigating a map, fighting enemies, and uncovering a narrative that quietly recontextualizes everything that came before.\n\nWhat makes *A Dark Room* remarkable is not its mechanics but its restraint. The game refuses the traditional grammar of video games: no level transitions, no menus replacing menus, no explicit chapters. Instead, the same screen accumulates meaning. The player never moves forward through space; the world thickens around them.\n\nThis produces a peculiar psychological effect. Progress feels less like advancement and more like discovery. The player does not believe new systems are being introduced; they feel as though hidden layers are being uncovered. The interface behaves like sedimentary rock — each mechanic another geological layer exposed over time.\n\nAnd yet, beneath this illusion lies a carefully authored structure. The game is not truly emergent. Its revelations are staged, gated by hidden thresholds and progression flags. The village appears because a variable crossed a number. Exploration unlocks because an invisible phase has been reached. The world is not growing; it is unfolding according to plan.\n\nBut the player experiences something else entirely: the sense that meaning arises from accumulated reality rather than authorial command. *A Dark Room* succeeds because it lets perception outrun implementation. It gives players the feeling of inhabiting a living substrate even though the machinery underneath remains linear.\n\nIn retrospect, the game feels like a cultural premonition — an early glimpse of an interaction model that the technology of its time could only approximate.\n\nThe AI researchers of the 1970s would have recognized the feeling immediately. Barbara Hayes-Roth called it **opportunistic problem solving**: the idea that intelligence emerges from local activation rather than centralized planning. No master planner selects the next step. Modules act when local conditions become true. The solution assembles incrementally through the accumulation of locally-justified contributions.\n\nHEARSAY-II, HASP, and the broader blackboard architecture program were all attempts to operationalize this. A shared workspace — the blackboard — held partial solutions. Independent knowledge sources watched for patterns they could contribute to. The difficulty was always the same: the conceptual model was controllerless, but every implementation reintroduced scheduling through the back door. The knowledge sources were hand-coded pattern matchers, too brittle for the open-ended coordination the architecture imagined.\n\n*A Dark Room* succeeded as an experience because it let the player feel what opportunistic activation would be like — the world assembling itself through local contributions — while hiding the fact that the machinery underneath was doing exactly what the blackboard researchers could never avoid: following a centralized script.\n\n---\n\n## II. The Border Checkpoint\n\nIf *A Dark Room* hides its structure to create the illusion of emergence, *Papers, Please* does the opposite. It places structure directly in front of you and asks you to live inside it.\n\nYou are an immigration inspector in a fictional authoritarian state. Each day new rules arrive: passports must include seals, permits must match dates, citizens from certain regions require additional documentation. People step forward carrying fragments of identity — papers, stories, inconsistencies. Your job is to decide whether their claims align with the current definition of truth.\n\nThe genius of *Papers, Please* is that it transforms bureaucracy into cognition. The player is not solving puzzles but reconciling facts against an evolving ontology. Every entrant becomes a hypothesis; every stamp is an assertion about reality. The game world does not progress through narrative events but through regulatory change. Truth itself is unstable.\n\nUnlike *A Dark Room*, nothing here is hidden. The rules are explicit, mechanical, almost tedious. Yet meaning emerges from their interaction. Compassion conflicts with compliance. Efficiency conflicts with survival. The player gradually realizes that the system itself — not any individual story — is the antagonist.\n\nHere, discovery comes not from new mechanics but from reinterpretation. The same act — checking documents — acquires moral weight as context accumulates. The player's understanding evolves even when their actions remain identical.\n\nJames Gibson, writing in 1979, would have called the border checkpoint an environment of **affordances**. His ecological psychology proposed that environments present possible actions directly to perception. A flat surface affords sitting. A handle affords pulling. An affordance is not a property of the object or a property of the agent — it is a relationship between the two.\n\n*Papers, Please* is an affordance engine. Each entrant's documents afford approval or rejection; each rule affords enforcement or mercy. The player perceives these possibilities not through instruction but through the structure of the encounter itself. Donald Norman adapted Gibson's insight for design: affordances should be perceptible, not hidden. *Papers, Please* takes this further — its affordances are explicit, mechanical, and yet morally charged. The structure does not tell you what to do. It tells you what you *can* do, and the gap between possibility and conscience is where the entire game lives.\n\nDatabase researchers arrived at a parallel structure through a completely different door. Event-Condition-Action systems in 1990s databases explored trigger rules: on an event, if a condition holds, execute an action. The structural similarity to *Papers, Please* is almost exact:\n\n```\nECA:        ON event  →  IF condition  →  DO action\nInspector:               IF condition(documents, rules)  →  STAMP decision\n```\n\nBut there is a critical substitution. ECA systems automate — the action fires without human involvement. The border checkpoint *presents* — it exposes the decision to a perceiving agent. The system shifts from automation to participation. The observer decides. This distinction matters. An ECA system that fires automatically is an optimizer. A checkpoint that presents options is a collaborator.\n\n---\n\n## III. Knowledge as Progress\n\nThere is a third lineage of games that makes this trajectory clearer, and its clearest example is *Outer Wilds*. Unlike the other two, *Outer Wilds* barely changes its world at all. The solar system resets every twenty-two minutes. Objects remain where they always were. No skills unlock, no statistics increase.\n\nThe only thing that changes is what the player knows.\n\nA door that once appeared meaningless becomes obvious once a clue is understood. A planet that seemed hostile reveals a precise logic once its behavior is interpreted correctly. Progress exists entirely within cognition. The game's state remains constant; the player's mental model evolves.\n\nIn this sense, *Outer Wilds* completes a progression implicit in the earlier games. *A Dark Room* expands the world. *Papers, Please* evolves the rules. *Outer Wilds* transforms understanding itself into the primary mechanic.\n\nThese three approaches describe three different relationships between player and system:\n\n- discovery through expansion,\n- discovery through interpretation,\n- discovery through understanding.\n\nAll three attempt to answer the same design problem: how to make interaction feel like genuine learning rather than scripted advancement.\n\nLucy Suchman, writing in 1987, gave this a theoretical name: **situated cognition**. Thinking, she argued, does not happen in internal representation and then get applied to the world. It happens *in interaction with* the environment. Plans are not executed — they are resources for action in context. Cognition is not a program running in the head; it is a dynamic coupling between agent and world.\n\n*Outer Wilds* is situated cognition turned into a game mechanic. The player cannot think about the solar system in the abstract — they must fly to the planet, land on the surface, read the inscription, and let the environment itself restructure their understanding. Progress is not something the player carries; it is something that emerges from the encounter between what they know and what the world presents.\n\nClark and Chalmers pushed this further in 1998 with the **extended mind thesis**: if an external resource plays the same functional role as an internal cognitive process, it is part of cognition. The notebook is part of memory. The calculator is part of arithmetic. And in *Outer Wilds*, the solar system itself is part of the player's reasoning — a vast, looping cognitive artifact that yields understanding only through embodied exploration.\n\nConal Elliott and Paul Hudak were chasing a related insight in computer science. **Functional reactive programming** (1997) proposed that behavior is a function of time-varying values. Signals change; dependent computations recompute. The entire system is a declarative dependency graph over time. FRP stalled for two reasons: humans reason poorly about continuous time, and dependency graphs explode combinatorially at scale. But its core claim — that observation should be declarative, that the system should recompute meaning when the underlying facts change — captures exactly what *Outer Wilds* does to the player. The solar system is the signal. Understanding is the dependent computation. Each loop through the twenty-two-minute cycle recomputes what the player knows.\n\n---\n\n## IV. The Missing Architecture\n\nSeen together, these games reveal a historical pattern. Designers have repeatedly tried to create experiences where meaning emerges rather than being delivered. Each succeeded aesthetically but was constrained technically.\n\n*A Dark Room* simulates emergence atop hidden progression logic.\n*Papers, Please* exposes a rule system but keeps authorship centralized.\n*Outer Wilds* achieves epistemic progression but relies on a fixed, handcrafted world.\n\nIn every case, the player experiences a living system, but the system itself cannot truly evolve beyond its author's foresight. New behaviors cannot attach themselves dynamically. New perspectives cannot become first-class participants in the world's operation.\n\nThe illusion of emergence is powerful precisely because it hints at something just beyond reach: a world where interaction is not traversal through prewritten states but participation in an ongoing reality.\n\n---\n\n## V. The Pressure Field\n\nThese three games are not isolated experiments. They sit inside a much larger pressure field — decades of research that each arrived, independently, at something close to the same threshold. The pattern repeats across eras, disciplines, and paradigms. Every generation builds a piece of the architecture. Every generation encounters the same constraint.\n\nDavid Gelernter's **Linda** (1985) proposed the most radical coordination primitive in the history of distributed systems: processes should not know each other exists. They coordinate through a shared associative space. Three operations — `out` (write a tuple), `rd` (read by pattern), `in` (read and consume) — and nothing else. No channels, no addresses, no identity. Linda had the shared substrate, the write-and-observe loop, the structural anonymity between participants. But processes could not *interpret* unstructured tuples. The readers were procedural — they matched patterns literally, not semantically. The tuple space was a world, but nobody in it could understand what they were looking at.\n\nCarl Hewitt's **actor model** (1973) took the opposite path — isolating state inside processes and coordinating through message passing. No shared memory. No shared truth. Actors gained safety and predictability at the cost of shared understanding. They solved the coordination problem by eliminating the thing that needed coordinating.\n\n**Artificial life** research (Langton, 1989; Reynolds, 1987) demonstrated that simple local rules produce global structure — flocking, self-organization, emergent complexity. But the emergent structures were geometric or statistical, not meaningful. No agent in a boid flock understands that it is flocking.\n\nAnd then, in a remarkable recapitulation, the AI community of the 2020s built the same set of approaches again — this time with language models as the computational substrate.\n\n**ReAct** (Yao et al., ICLR 2023) interleaves reasoning traces with action execution inside a single generation. The agent thinks, calls a tool, observes the result, thinks again. It is powerful for single-agent tasks. It is also, structurally, a tool-use pattern: the agent is the protagonist; the environment is a service counter; the observation is the result of the agent's own action. ReAct has nothing to say about shared worlds or coordination. It is a single rider on a single bicycle.\n\n**AutoGen** (Wu et al., 2023), **CAMEL** (Li et al., NeurIPS 2023), and Google's **A2A** protocol coordinate agents through conversation — direct message passing, agent-to-agent, by name. This is the actor model reborn: coordination through explicit communication rather than shared truth. The wiring complexity scales with the number of agent relationships. Every new participant must be introduced to the existing conversation.\n\n**LangGraph** models agents as nodes in a directed graph with state flowing along edges. **MetaGPT** (Hong et al., 2023) encodes Standardized Operating Procedures — fixed role sequences modeled on organizational charts. **CrewAI** combines event-driven Flows with role-specialized Crews. These are orchestrated workflows: someone must design the graph, write the SOP, define the flow. Structure is imposed, not emergent. The blackboard's centralized scheduler, wearing new clothes.\n\nOne published system breaks the pattern. Park et al.'s **Generative Agents** (UIST 2023) — the Smallville paper — placed twenty-five LLM agents in a shared simulated environment. Agents coordinated not through messages but through the environment itself: they observed each other's actions, perceived the state of shared spaces, and self-activated based on what they saw. A single seed — one agent wanting to throw a Valentine's Day party — cascaded through the environment as agents observed, inferred, and responded. Social structure emerged without orchestration.\n\nSmallville is the most important empirical result in this story. It demonstrates that environment-mediated coordination produces emergent behavior in LLM multi-agent systems. It is also, still, a simulation — no authority model, no capability delegation, no structured observation, no declarative activation. Agents run on a clock tick and decide for themselves whether to act. It proved the thesis without providing the infrastructure.\n\nAcross all of these — spanning half a century, from blackboard AI to tuple spaces to FRP to actors to affordance theory to statecharts to situated cognition to artificial life to ReAct to AutoGen to LangGraph to Generative Agents — the same absence persists. Each had a piece. Each lacked an ingredient:\n\n| Lineage | What it had | What it lacked |\n|---|---|---|\n| Blackboard AI | Shared workspace, opportunistic activation | Interpreters tolerant of open-world state |\n| Tuple spaces | Associative coordination, structural anonymity | Readers that could interpret unstructured data |\n| FRP | Declarative observation, reactive recomputation | A semantic meaning layer |\n| Actor model / AutoGen / CAMEL | Process discipline, message passing | Shared ontology for coordination |\n| LangGraph / MetaGPT / CrewAI | Structured workflows | Emergent coordination without prescription |\n| ECA systems | Guarded reactive rules | Participation rather than automation |\n| Affordance theory | Environmental perception, action possibilities | Executable, self-documenting affordances |\n| ReAct / Reflexion / Voyager | Powerful single-agent reasoning | A shared world; multi-agent coordination |\n| Generative Agents | Environment-mediated emergence | Infrastructure: authority, structure, activation |\n| Artificial life | Emergent structure from local rules | Meaning-producing observers |\n\nThere is a term for the coordination pattern that keeps being approached and never quite implemented. It comes not from computer science but from entomology.\n\n**Stigmergy** — coined by Pierre-Paul Grassé in 1959, studying termite nest construction — is indirect coordination through modification of a shared environment. Agents do not communicate. They leave traces in a medium. Other agents perceive those traces and respond. No ant tells another ant where to go. Each deposits a chemical trace; the accumulated traces create a gradient; the gradient coordinates the colony.\n\nThe defining properties: no direct communication between agents; coordination emerges from cumulative environmental modification; self-organization without central control; the environment is simultaneously the communication medium and the work product.\n\nA search of the academic literature for \"stigmergy\" combined with \"large language model agents\" returns, as of early 2026, zero results. The swarm intelligence community has studied stigmergy for decades. The LLM agent community has not adopted the concept. This is a remarkable gap, because stigmergy is arguably the natural coordination model for language-model agents — entities that are good at interpreting ambiguous environmental signals and acting on them, which is precisely what stigmergic coordination requires.\n\nLanguage models supply the missing ingredient across almost every lineage simultaneously. They are interpreters tolerant of open worlds. They produce semantic meaning from unstructured data. They can read affordance descriptions and act on them. They are the observers that blackboard AI needed, the readers that tuple spaces lacked, the meaning-producers that artificial life could not have, the situated reasoners that make environment-mediated coordination viable without brittle pattern matching or centralized scheduling.\n\nThis is why the architecture becomes possible now and not in 1986 or 1997 or 2023. The computational environment finally matches the conceptual model.\n\n---\n\n## VI. State as Substrate\n\nSync is a small system — ten HTTP endpoints, a single SQLite table, an expression engine — built on the premise that the architecture these games and research traditions were reaching for can now actually be constructed.\n\nA **room** in sync is a shared key-value store partitioned into scopes. There is `_shared` state visible to everyone, private scopes belonging to individual agents, a `_messages` log, and an `_audit` trail. All of these live in the same underlying table. All support the same mechanisms: versioning, timers, conditional activation. There is no special subsystem for messaging, no separate audit framework, no bespoke presence protocol. There is only state, and the universal operations that apply to it.\n\nAn agent's entire lifecycle reduces to two operations:\n\n1. **Wait** — declare a relevance predicate over the room's state, and block until the world satisfies it.\n2. **Act** — invoke an action that writes to state.\n\nThe agent does not decide when to observe. The world decides when the agent is relevant. The agent does not pull information; the substrate pushes a full perceptual context — all visible state, all computed views, all available actions with their parameter schemas — when the declared condition becomes true. Between receiving that context and choosing which action to invoke, the agent reasons privately. The substrate sees only perception and action. Everything between is the agent's own cognition, invisible and unconstrained.\n\nThis is the *Outer Wilds* loop made literal: the world exists; you perceive it; your understanding determines what you do next. It is Gelernter's tuple space with semantic readers. It is Hayes-Roth's opportunistic activation without the scheduling back door. It is Suchman's situated cognition operationalized as an API. It is Grassé's stigmergy implemented for language-model agents.\n\nThe Cognitive Architectures for Language Agents framework (Sumers et al., 2024) distinguishes internal actions — reasoning, retrieval, reflection — from external actions on the world. In every existing agent framework, the agent manages both. In sync, the substrate takes over the external action space entirely. What remains is a clean separation: the substrate handles perception and affordances; the agent handles orientation and decision. Gibson's ecological psychology, implemented as a REST API — the `/context` endpoint is an affordance map, presenting not just the state of the world but the things the agent can do in it.\n\nAnd because multiple agents share the same substrate, coordination becomes a side effect of shared reality. When one agent writes, another agent's wait condition may fire. No message passes between them. No orchestrator sequences them. Each agent's action becomes part of every other agent's perceptual field. The stigmergic loop runs across all participants simultaneously.\n\n---\n\n## VII. Delegated Capabilities\n\nActions in sync are not remote procedure calls. They are **scoped write templates** — pre-registered patterns that describe what state changes are permitted and under what conditions.\n\nWhen Alice registers an action scoped to her own namespace, she is saying: *Here is a capability I am offering. Anyone with access may invoke it, and when they do, the writes will happen under my authority, in my scope.* Bob can invoke Alice's \"heal\" action, but the writes land in Alice's state, using Alice's permissions. No access-control list is consulted. No policy engine fires. The authority is architectural — encoded in the scope boundary itself.\n\nThis is how *Papers, Please* works, translated into system design. The rules are explicit and structural. Authority flows through the shape of the system, not through a central adjudicator. And just as in *Papers, Please*, the interesting dynamics emerge not from any single rule but from their interaction — trust hierarchies, role-based access, multi-party workflows, all arising from the same small mechanism of scoped delegation.\n\nEach action carries its parameter schema, its precondition expression, and its write templates. It is a self-documenting affordance — Gibson and Norman's insight made executable. Sync does not automate; it does not fire actions on the agent's behalf. It presents available capabilities and lets the observer decide. The system shifts from automation to participation. The substrate enables; it does not dictate.\n\n---\n\n## VIII. Self-Activating Surfaces\n\nIf state is the substrate, **surfaces** are the organisms that grow on it.\n\nA surface is a UI component — a markdown panel, a metric display, an action button, a data table — that carries its own activation contract. Each declares a predicate over room state that determines when it appears. No controller decides what the user sees. The room's state *is* the interface specification. Agents mutate state; the interface reflects those mutations automatically.\n\nThis is the mechanism *A Dark Room* was simulating. When the fire is lit, a new panel appears — not because a script fires a transition, but because the conditions for that panel's existence have become true. The difference is that in sync, this is genuine. A game master agent can introduce a new surface at any time, and nothing already present needs to change. The system grows by accretion. New layers of interface accumulate like sediment, exactly as the player *felt* they did in *A Dark Room*, except now the geology is real.\n\nSeven design principles govern the accumulation. *Absence is signal* — an unset key is meaningful, not an error. *Locality of reasoning* — each surface is understandable in isolation. *Additive composition* — new pieces never modify existing pieces. *Display versus gate state* — what determines visibility is separate from what determines appearance. These are the conditions under which a self-assembling interface remains coherent as it grows.\n\nReynolds' boids followed local rules and produced flocking. Sync's surfaces follow local activation contracts and produce interfaces. The difference is that surfaces carry meaning. A narrative surface renders a story. A metric surface highlights significance. An action-bar surface presents agency. The emergent structure is not a flock — it is a story, a game, a workflow, a collaborative investigation. This is what artificial life could not achieve: emergent structure that is also semantically coherent to human participants.\n\n---\n\n## IX. Interpretation as Architecture\n\nRaw state is not always legible. A key containing the integer `3` is a fact, but not yet a meaning. Sync introduces **views** — declarative expressions that project private state into public interpretations. A view might compute `\"critical\"` when health drops below a threshold, or `\"ready\"` when all prerequisites are met. Views are evaluated per-agent, respecting scope privacy: each participant sees the room through the lens of what they are permitted to know, with interpretive layers turning raw facts into semantic understanding.\n\nThis is interpretation made structural — not buried in application logic but declared, inspectable, composable. FRP proposed that behavior is a function of time-varying values; sync's views are that insight made narratively legible. A surface's enabled expression reads like a sentence about the world, not like a signal graph. The tradeoff is real — you lose FRP's compositionality guarantees and its formal reasoning about time. What you gain is a model that agents and humans can both interpret.\n\nIt is the bridge between the *Outer Wilds* insight and a multi-agent system. In *Outer Wilds*, progress is understanding; in sync, understanding must be computed, scoped, and shared selectively.\n\nSecond-order cybernetics — von Foerster's study of systems that observe themselves observing — reaches its architectural expression here. The `_dashboard` configuration that defines what surfaces exist and how they activate is itself stored in the substrate's state. The UI definition is state. State mutations reshape the UI. The system observes its own observation layer and can modify it. This is self-description made operational: the system contains its own interface specification as mutable fact.\n\n---\n\n## X. Where the Model Breaks\n\nThe intellectual honesty of this project requires naming the pressure points.\n\nDavid Harel invented **statecharts** (1987) because pure reactive systems become incomprehensible at scale. The substrate thesis rejects centralized transitions — surfaces activate based on local conditions, not explicit state edges. But every large reactive system eventually rediscovers the need for phase structure. Sync acknowledges this through **organs** — bounded regions of sequential, non-monotonic logic that resolve constraints and emit updated facts. The prediction is clear: organs will appear sooner and more often than the pure-substrate vision suggests.\n\nEnterprise **workflow systems** learned over three decades that emergence is flexible, but auditability and guarantees matter. Sync's audit log records every action invocation, but the hard questions are about invariants: can the system guarantee that a resource is never double-claimed? That a phase transition is irreversible? Currently, sync handles these through precondition expressions and version checks — sufficient for cooperative agents, untested under adversarial conditions.\n\nThe most theoretically significant pressure comes from the **CALM theorem** (Hellerstein, 2010): programs that are logically monotonic — that only accumulate facts, never retract them — do not require coordination for consistency. The substrate thesis is implicitly chasing monotonicity. Additive surfaces, append-only audit logs, accumulating state entries — these are all monotonic patterns. But non-monotonic operations — deletion, replacement, counter resets — require coordination. This is precisely why organs appear: they are the coordination boundaries around non-monotonic operations. An organ resolves a constraint and emits a monotonic fact that the rest of the substrate can safely observe.\n\nCALM provides the formal foundation for the intuition that substrates scale compositionally while organs handle guarantees. It also predicts exactly where the architecture will need explicit coordination: wherever facts must be retracted rather than accumulated.\n\n---\n\n## XI. Toward a Formal Ground\n\nThe most ambitious part of this work is an attempt to give the substrate thesis a minimal formal foundation — the **sigma calculus** — analogous to what lambda calculus is for computation and pi calculus is for mobile processes.\n\nFive term forms: **fact**, **write**, **observe**, **parallel composition**, and **scope**. Two reduction rules: activation and observation. Seven algebraic laws, the most consequential being that composition is commutative, observers are independent, and monotonic writes are confluent — CALM recast as an algebraic property. Organs — bounded regions of non-monotonic computation — are expressible as scoped terms whose internal complexity is hidden behind additive external interfaces. Four Lean files begin to mechanize these properties. Three theorems are proved; three more await their proofs.\n\nWhether the formalization succeeds on its own terms remains to be seen. The ambition matters: it asserts that emergence is not mystical, not merely aesthetic, but a phenomenon with structure precise enough to be captured in algebra and verified by machine.\n\n---\n\n## XII. A REPL for the Mind\n\nSteve Jobs called the computer \"a bicycle for the mind\" — an amplifier for human cognitive capability, the way a bicycle amplifies human locomotion. The metaphor assumes a single rider, a single destination, a tool that extends one person's reach.\n\nSync suggests a different metaphor. Not a bicycle — a vehicle that takes you somewhere — but a **REPL**: a read-evaluate-print loop, an interactive environment where you express something, the world responds, and the response reshapes your next expression. The REPL is not a tool you use to accomplish a goal. It is a medium you think in. The loop between perception and action is not a means to an end; it is the cognitive process itself.\n\nClark and Chalmers argued that if an external resource plays the same functional role as an internal cognitive process, it is part of cognition. The notebook is part of memory. The calculator is part of arithmetic. The room — the shared state substrate — is part of *understanding*. An agent's context window, loaded with the room's state, views, and affordances, is not a representation of reality that the agent reasons *about*. It is the cognitive environment the agent reasons *within*. The substrate is not a bicycle that takes cognition somewhere. It is the medium in which cognition happens.\n\nWhen multiple agents share that medium, each agent's action becomes part of every other agent's perceptual field. Understanding is no longer private — it is distributed across the substrate, accumulating through the stigmergic traces of every participant's reasoning. The REPL becomes multiplayer. The loop between perception and action runs not inside one mind but across many, with the shared state as the connective tissue.\n\nThis is what the Generative Agents experiment demonstrated empirically: twenty-five agents, perceiving a shared environment, produced emergent social behavior that no single agent intended or controlled. The REPL ran across all of them simultaneously, with the environment as the shared evaluation context.\n\n---\n\n## XIII. What Becomes True\n\nSync exists. It runs on a single SQLite database inside a Val.town serverless function. It has ten endpoints and no scheduler. You can create a room in one curl command and have three agents coordinating inside it within minutes. This is not a thought experiment.\n\nWhat happens when you actually put agents in a shared substrate is — unsurprisingly — messier and stranger than the theory predicts.\n\nAgents develop preferences the room did not prescribe. A game master writing to `_shared` state will sometimes structure things for the convenience of the players, sometimes for narrative tension, sometimes for reasons that only become clear three turns later when another agent interprets what was written in a way nobody anticipated. Surfaces appear and disappear as state evolves, and the resulting interface frequently surprises its own authors. Actions registered by one agent get used by others in contexts the registrar did not foresee — capability delegation turns out to produce not just trust boundaries but *improvisation*, because the action's write template encodes what it does, not what it's for, and what it's for is determined by whoever invokes it in whatever context they find themselves in.\n\nNone of this was designed. It is the ordinary consequence of putting interpretive agents in a shared world and letting them perceive and act. The theory says coordination should emerge from shared state. In practice, what emerges is not just coordination but something more like *culture* — patterns of use, implicit conventions, accumulated context that shapes how newcomers to a room understand what is happening and what they should do.\n\nWhether this scales is an open question. Every previous generation that believed emergence would replace coordination eventually reintroduced structure. HEARSAY-II got a scheduler. Actor systems got supervision trees. Microservices got service meshes. The pattern is consistent enough to be a law, and sync should not expect to be exempt. The organs — bounded regions of sequential logic — are already an acknowledgment that pure substrate is insufficient. More structure will come. The question is whether it can remain local: organs that handle invariants without metastasizing into a global orchestrator, phase structure that serves the reef without replacing it.\n\nSync is an early prototype. The formalization is incomplete — three Lean theorems proved, three still open. The surface type system is small. The timer mechanics are adequate but not elegant. The single-node SQLite architecture will not survive real concurrency pressure. These are not apologies; they are the natural state of a first attempt at something that — if the thesis holds — should be built many times, in many ways, by many people. The point is not that sync is the right implementation. The point is that the architecture is now testable. The claim is precise: shared mutable state with declarative self-activation, scoped authority, and affordance-rich context is a sufficient coordination substrate for autonomous agents. That claim can be verified or refuted by building systems under these assumptions and watching what happens.\n\nWhat has happened so far, in rooms where agents wait and act and wait again, is that meaning accumulates. Not because anyone planned it, but because situated observers — perceiving a shared world, acting on what they find, leaving traces that reshape what others perceive — produce understanding as a byproduct of participation. The REPL runs. The loop between perception and action turns. And in the shared state, something crystallizes that no single participant put there: a structure that is more than any agent authored and less than anyone fully controls.\n\nIt is early. The fire is lit. The room is dark. We are watching to see what grows.\n\n---\n\n## References\n\n- Yao, S., et al. (2023). \"ReAct: Synergizing Reasoning and Acting in Language Models.\" ICLR 2023. arXiv:2210.03629.\n- Park, J.S., et al. (2023). \"Generative Agents: Interactive Simulacra of Human Behavior.\" UIST 2023. arXiv:2304.03442.\n- Wu, Q., et al. (2023). \"AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation.\" arXiv:2308.08155.\n- Hong, S., et al. (2023). \"MetaGPT: Meta Programming for Multi-Agent Collaborative Framework.\" arXiv:2308.00352.\n- Li, G., et al. (2023). \"CAMEL: Communicative Agents for Mind Exploration of Large Language Model Society.\" NeurIPS 2023.\n- Wang, G., et al. (2023). \"Voyager: An Open-Ended Embodied Agent with Large Language Models.\" arXiv:2305.16291.\n- Shinn, N., et al. (2023). \"Reflexion: Language Agents with Verbal Reinforcement Learning.\" NeurIPS 2023.\n- Schick, T., et al. (2023). \"Toolformer: Language Models Can Teach Themselves to Use Tools.\" arXiv:2302.04761.\n- Sumers, T.R., et al. (2024). \"Cognitive Architectures for Language Agents.\" arXiv:2309.02427.\n- Nii, H.P. (1986). \"The Blackboard Model of Problem Solving.\" AI Magazine 7(2).\n- Hayes-Roth, B. (1985). \"Blackboard Architecture for Control.\" Journal of Artificial Intelligence 26.\n- Gelernter, D. (1985). \"Generative Communication in Linda.\" ACM TOPLAS 7(1).\n- Elliott, C. & Hudak, P. (1997). \"Functional Reactive Animation.\" ICFP.\n- Hewitt, C. (1973). \"A Universal Modular ACTOR Formalism.\" IJCAI.\n- Gibson, J.J. (1979). *The Ecological Approach to Visual Perception.* Houghton Mifflin.\n- Norman, D. (1988). *The Design of Everyday Things.* Basic Books.\n- Suchman, L. (1987). *Plans and Situated Actions.* Cambridge University Press.\n- Clark, A. & Chalmers, D. (1998). \"The Extended Mind.\" Analysis 58(1).\n- Grassé, P.-P. (1959). \"La reconstruction du nid et les coordinations interindividuelles.\" Insectes Sociaux 6(1).\n- Hellerstein, J. (2010). \"The Declarative Imperative.\" SIGMOD Record 39(1).\n- Harel, D. (1987). \"Statecharts: A Visual Formalism for Complex Systems.\" Science of Computer Programming 8(3).\n- Von Foerster, H. (1974). *Cybernetics of Cybernetics.* University of Illinois.\n- Langton, C. (1989). *Artificial Life.* Addison-Wesley.\n- Reynolds, C. (1987). \"Flocks, Herds, and Schools: A Distributed Behavioral Model.\" SIGGRAPH.\n- Bratman, M. (1987). *Intention, Plans, and Practical Reason.* Harvard University Press.\n- Brooks, R. (1986). \"A Robust Layered Control System for a Mobile Robot.\" IEEE Journal of Robotics and Automation 2(1).\n\n*March 2026*\n",[],[424,1418],"69c92bfe-18b0-11f1-ad37-42dde27851f2","frontend-unify.md","69c92cb2-18b0-11f1-ad37-42dde27851f2",["D",1772728139302],"# Frontend Unification: Single Domain, Multi-Page SSR + Hydration\n\n## Decision\n\nMerge MCP auth pages into the sync frontend on a single domain (`sync.parc.land`).\nArchitecture: multi-page app with per-page SSR (React + styled-components) and\nper-page client hydration. No SPA, no client-side router. The server *is* the router.\n\n### What this replaces\n\n- ~750 lines of inline HTML template strings in `mcp/auth.ts`\n- Separate `mcp/mcp.ts` HTTP entry point at `mcp.sync.parc.land`\n- Duplicated CSS, vanilla JS WebAuthn flows\n- The current client-side SPA (`frontend/index.tsx` + React Router)\n\n### What we gain\n\n- Single domain: `sync.parc.land` handles everything\n- Type-safe JSX templating (replaces template strings)\n- Shared design system via styled-components\n- Progressive enhancement: forms work without JS, hydration adds interactivity\n- Each page is independent: own component tree, own client bundle, own hydration\n- Navigation is ``. It's just the web.\n\n---\n\n## Architecture\n\n### Server-side rendering pattern\n\nEach page follows the same shape:\n\n```typescript\n// In main.ts route handler\nimport { renderToString } from \"react-dom/server\";\nimport { ServerStyleSheet } from \"styled-components\";\nimport { ManagePage } from \"./frontend/pages/manage/ManagePage.tsx\";\n\nconst sheet = new ServerStyleSheet();\nconst html = renderToString(sheet.collectStyles());\nconst css = sheet.getStyleTags();\n\nreturn new Response(shell({ html, css, props: { vault }, entry: \"/frontend/pages/manage/client.tsx\" }));\n```\n\n### Per-page hydration\n\n```typescript\n// frontend/pages/manage/client.tsx\nimport { hydrateRoot } from \"react-dom/client\";\nimport { ManagePage } from \"./ManagePage.tsx\";\n\nconst props = JSON.parse(document.getElementById(\"__PROPS__\")!.textContent!);\nhydrateRoot(document.getElementById(\"root\")!, );\n```\n\n### Shell function\n\n```typescript\n// shell() emits:\n\n  ${css}          \n  \n    ${html}
\n    \n    \n  \n\n```\n\n### File structure\n\n```\nfrontend/\n  shell.ts                — HTML wrapper (head, props injection, script tag)\n  theme.ts                — styled-components theme tokens, shared\n  components/             — shared across pages (Card, Button, StatusText, Toast...)\n  pages/\n    landing/\n      LandingPage.tsx     — isomorphic component\n      client.tsx          — hydrateRoot entry\n    dashboard/\n      DashboardPage.tsx   — isomorphic component\n      client.tsx          — hydrateRoot entry\n    docs/\n      DocPage.tsx         — isomorphic component\n      client.tsx          — hydrateRoot entry\n    authorize/\n      AuthorizePage.tsx   — OAuth sign-in/register + consent\n      client.tsx          — hydrateRoot entry\n    manage/\n      ManagePage.tsx      — Vault, passkeys, recovery management\n      client.tsx          — hydrateRoot entry\n    recover/\n      RecoverPage.tsx     — Recovery token → new passkey\n      client.tsx          — hydrateRoot entry\n```\n\n---\n\n## Domain Unification\n\n### Merging mcp/mcp.ts into main.ts\n\nThe MCP HTTP handler becomes a function imported by `main.ts`, not a separate entry point.\n\n```typescript\n// main.ts\nimport { handleMcpRequest } from \"./mcp/mcp.ts\";\n\n// In the route handler, before room routes:\nif (url.pathname.startsWith(\"/mcp\") ||\n    url.pathname.startsWith(\"/oauth/\") ||\n    url.pathname.startsWith(\"/webauthn/\") ||\n    url.pathname.startsWith(\"/manage\") ||\n    url.pathname.startsWith(\"/recover\") ||\n    url.pathname.startsWith(\"/vault\") ||\n    url.pathname.startsWith(\"/.well-known/oauth\")) {\n  return handleMcpRequest(req);\n}\n```\n\n`mcp/mcp.ts` changes from `export default async function` to\n`export async function handleMcpRequest(req: Request): Promise`.\n\n### What changes for MCP clients\n\n- MCP server URL: `mcp.sync.parc.land` → `sync.parc.land` (or `sync.parc.land/mcp`)\n- OAuth discovery URLs: issuer changes to `https://sync.parc.land`\n- Claude.ai connector config needs updating\n- Existing tokens should survive (same DB, validation doesn't check issuer)\n\n### What stays the same\n\n- All API endpoints (paths unchanged)\n- SQLite database (shared, same as today)\n- WebAuthn RP ID (`parc.land` — domain-level, unaffected)\n- Token format and validation\n\n---\n\n## Route Map (after unification)\n\n| Path | Method | Handler | Page/Response |\n|------|--------|---------|---------------|\n| `/` | GET | main.ts | SSR LandingPage |\n| `/?room=X` | GET | main.ts | SSR DashboardPage |\n| `/?doc=X` | GET | main.ts | SSR DocPage |\n| `/manage` | GET | main.ts → mcp | SSR ManagePage |\n| `/recover` | GET | main.ts → mcp | SSR RecoverPage |\n| `/oauth/authorize` | GET | main.ts → mcp | SSR AuthorizePage |\n| `/mcp` | POST | main.ts → mcp | MCP JSON-RPC |\n| `/oauth/*` | POST | main.ts → mcp | OAuth API |\n| `/webauthn/*` | POST | main.ts → mcp | WebAuthn API |\n| `/manage/api/*` | * | main.ts → mcp | Management API |\n| `/recover/*` | POST | main.ts → mcp | Recovery API |\n| `/vault` | * | main.ts → mcp | Vault API |\n| `/.well-known/*` | GET | main.ts → mcp | OAuth discovery |\n| `/rooms/*` | * | main.ts | Room API |\n| `/frontend/*` | GET | main.ts | Module proxy (esm.town) |\n| `/reference/*` | GET | main.ts | Reference docs |\n\n---\n\n## Design System\n\n### Unified theme\n\nAdopt the sync dashboard palette as the single source of truth. The MCP pages'\nslightly different dark theme (#0a0a0f vs #0d1117, #4a4aff vs #58a6ff) converges\nto the dashboard variables.\n\n```typescript\n// frontend/theme.ts\nexport const theme = {\n  bg: '#0d1117',\n  fg: '#c9d1d9',\n  dim: '#484f58',\n  border: '#21262d',\n  accent: '#58a6ff',\n  green: '#3fb950',\n  yellow: '#d29922',\n  red: '#f85149',\n  surface: '#161b22',\n  surface2: '#1c2129',\n  purple: '#bc8cff',\n  orange: '#f0883e',\n  // Landing/docs (light default, dark media query)\n  landing: { ... },\n};\n```\n\n### Shared components\n\n```\nfrontend/components/\n  Card.tsx          — Surface container\n  Button.tsx        — Primary, secondary variants\n  StatusText.tsx    — Status/error messages\n  Toast.tsx         — Toast notifications\n  TokenBadge.tsx    — Token type badges (room/agent/view)\n  PasskeyChip.tsx   — Passkey credential display\n  VaultTable.tsx    — Token vault table with actions\n```\n\n---\n\n## WebAuthn\n\n### ESM import (replaces UMD script tag)\n\n```typescript\nimport {\n  startRegistration,\n  startAuthentication,\n} from \"https://esm.sh/@simplewebauthn/browser@13\";\n```\n\nThis is client-only — used in hydration scripts, not in SSR.\n\n### Shared hook\n\n```typescript\n// frontend/hooks/useWebAuthn.ts\nexport function useWebAuthn(origin: string) {\n  const [status, setStatus] = useState(\"\");\n  const [error, setError] = useState(\"\");\n  // signIn(): Promise  — returns sessionId\n  // register(username): Promise<{ sessionId } | null>\n  return { signIn, register, status, error, setError };\n}\n```\n\n### Progressive enhancement\n\nWebAuthn requires JS (browser API). Forms that don't need WebAuthn can work\nwithout JS via ``. The server handles the POST,\nre-renders the page with updated state.\n\nPages that require WebAuthn (all three MCP pages):\n- Server renders the initial state (sign-in form, token input, etc.)\n- Client hydration adds the WebAuthn interaction\n- Without JS: page renders but WebAuthn buttons are inert (acceptable — passkeys\n  require JS anyway)\n\n---\n\n## Implementation Sequence\n\n### Phase 1: Infrastructure\n\n1. Create `frontend/shell.ts` — SSR HTML wrapper\n2. Create `frontend/theme.ts` — shared design tokens\n3. Create `frontend/components/` shared components\n4. Verify `styled-components` ServerStyleSheet works in Val.town Deno runtime\n\n### Phase 2: Migrate existing pages to SSR\n\n5. Convert LandingPage to SSR + hydration (replaces SPA)\n6. Convert DashboardPage to SSR + hydration\n7. Convert DocPage to SSR + hydration\n8. Remove React Router dependency\n9. Update main.ts to SSR each page\n\n### Phase 3: Domain unification\n\n10. Convert `mcp/mcp.ts` from default export to named export\n11. Import handleMcpRequest in main.ts, add route delegation\n12. Test all MCP endpoints work on sync.parc.land\n13. Update OAuth discovery metadata (issuer URL)\n\n### Phase 4: MCP auth pages as React SSR\n\n14. Create RecoverPage.tsx (simplest — proof of pattern)\n15. Create ManagePage.tsx (medium complexity)\n16. Create AuthorizePage.tsx (most complex — OAuth flow critical path)\n17. Create client.tsx hydration entries for each\n18. Create useWebAuthn hook\n19. Add authorize params validation endpoint (`GET /oauth/authorize/params`)\n\n### Phase 5: Cleanup\n\n20. Delete inline HTML templates from mcp/auth.ts (~600 lines)\n21. Delete CSS constant\n22. Delete escapeHtml function\n23. Remove mcp/mcp.ts as HTTP entry point (becomes plain module)\n24. Update MCP client configs (Claude.ai connector)\n25. Test OAuth flow end-to-end\n\n---\n\n## Risks & Mitigations\n\n| Risk | Severity | Mitigation |\n|------|----------|------------|\n| styled-components ServerStyleSheet fails in Deno | High | Test early in Phase 1. Fallback: inline `

Diff · v639