eve-hub 0.6.3 → 0.6.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # eve-hub
 
+## 0.6.5
+
+### Patch Changes
+
+- Bots learn forms: the protocol now teaches flow, sequence, chart and ask figures.
+
+## 0.6.4
+
+### Patch Changes
+
+- A running tool's input in the live activity keeps every field when it's long: long string values are cut before the input is stringified, so the JSON still parses.
+
 ## 0.6.3
 
 ### Patch Changes

package/main-instructions.mjs

@@ -1,6 +1,6 @@
 // main's instructions, rendered from the kit's templates: templates/main-instructions.md,
-// then the shared protocol (templates/workspace-protocol.md, then the engineering
-// page, templates/engineering.md). One source for
+// then the shared protocol (templates/workspace-protocol.md, the forms guide,
+// templates/forms.md, then the engineering page, templates/engineering.md). One source for
 // `hub workspace init` (lib/agent-template.mjs) and for every workspace's main,
 // which imports it (instructions/main.ts) instead of carrying a copy, so a
 // template edit reaches each workspace on main's next build. Every other bot
@@ -12,6 +12,7 @@ import { findWorkspaceRoot } from "./workspace.mjs";
 
 const HEAD = "main-instructions.md";
 const PROTOCOL = "workspace-protocol.md";
+const FORMS = "forms.md";
 const ENGINEERING = "engineering.md";
 const templatesOf = (kitDir) => join(kitDir, "templates");
 
@@ -42,5 +43,5 @@ export function engineeringPage(options) {
 // The shared protocol: every bot but main appends it after its own
 // instructions.md (agent/instructions/protocol.ts re-exports instructions/protocol.ts).
 export function workspaceProtocol(options) {
-  return `${readFileSync(join(templatesDir(options), PROTOCOL), "utf8")}\n${engineeringPage(options)}`;
+  return `${readFileSync(join(templatesDir(options), PROTOCOL), "utf8")}${readFileSync(join(templatesDir(options), FORMS), "utf8")}\n${engineeringPage(options)}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-hub",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "license": "Apache-2.0",
   "description": "Bot-side code shared by every hub agent: registry tools, the roster hook, the eve channel, the host sandbox and browser, and model helpers.",
   "type": "module",

package/templates/forms.md

@@ -0,0 +1,48 @@
+
+## Forms
+
+A form is an interactive figure the app draws from a fenced block with a JSON body. Use one only when the shape is the point: a path through parts (`flow`), an order of events (`sequence`), numbers to compare (`chart`), a choice you need from the human (`ask`). Everything else is plain prose. At most one or two forms per message.
+
+- Claim first: a sentence that says what the form shows comes before it. A chart's `title` is its claim.
+- Link a word in your prose to a part with `[word](#id)`. Ids are lowercase slugs (`a-z`, `0-9`, `-`, up to 32 characters), unique in the whole message.
+- Put the explanation of a part in `note` (up to 240 characters), which the human sees when they point at or step to it. Keep labels short.
+- `hi: true` marks the one part that matters, at most one per form. Unknown keys are rejected.
+- Send a form with `post_message`, never in your end-of-turn reply. The hub checks a posted form and rejects a bad one (400) with what's wrong: fix it and post again. Nothing checks a final reply, so a bad form there shows as raw JSON.
+
+A request leaves the [app](#app), the [hub](#hub) routes it, and a [bot](#bot) answers. `flow`: nodes 2–12 (`role`, `group`, `ref` as file:line), edges 1–24 (`from`, `to`, `label` up to 16, `fail` for a failure path), optional `groups`. Steps follow node order.
+
+```flow
+{"nodes": [
+  {"id": "app", "label": "App", "role": "on your Mac"},
+  {"id": "hub", "label": "Hub", "role": "threads, routing", "hi": true, "ref": "server.mjs:5323", "note": "Stores the message, then wakes the bot."},
+  {"id": "bot", "label": "Bot", "role": "one turn"}],
+ "edges": [{"from": "app", "to": "hub", "label": "send"}, {"from": "hub", "to": "bot", "label": "wake"}, {"from": "bot", "to": "hub", "label": "post"}]}
+```
+
+The stream [drops](#drop) before the client [retries](#retry). `sequence`: actors 2–6, messages 1–16 (`from`, `to`, `label` up to 32, `fail` where it breaks, `ref` as file:line). Steps follow message order.
+
+```sequence
+{"actors": [{"id": "hub", "label": "Hub"}, {"id": "client", "label": "Client"}],
+ "messages": [
+  {"id": "drop", "from": "hub", "to": "client", "label": "stream drops", "fail": true, "ref": "Client.swift:257"},
+  {"id": "retry", "from": "client", "to": "hub", "label": "reconnects", "note": "Resumes from the last event id."}]}
+```
+
+First token is under 2 s everywhere but [Sydney](#syd). `chart`: `title` (the claim) and `points` 1–24, each with an id and `label`. `type` is one of four:
+- `bar`: `value`; optional `unit`, `target`.
+- `scatter`: axis titles `x`, `y`; points have numeric `x`, `y`.
+- `budget`: `value` > 0; optional `total`; `spare: true` for unused room.
+- `schedule`: `row` (up to 8 rows), `start` < `end`; optional `unit`.
+
+```chart
+{"type": "bar", "title": "First token is under 2 s everywhere but Sydney", "unit": "s", "target": 2,
+ "points": [{"id": "sfo", "label": "San Francisco", "value": 0.9}, {"id": "syd", "label": "Sydney", "value": 2.6, "hi": true, "note": "No region near it."}]}
+```
+
+You need a decision, so I'm asking you to pick one. `ask`: 2–5 `options`, each with `id`, `label` (up to 40) and an optional one-line `line` (up to 160). Choosing one sends its label back as the human's reply, so write labels you can act on.
+
+```ask
+{"options": [
+  {"id": "heron", "label": "Heron Lodge", "line": "Lake house 90 minutes north. Rooms for all 14, $5,400."},
+  {"id": "pines", "label": "The Pines", "line": "In town, walkable. Sleeps 10, so 4 need a hotel."}]}
+```

package/world.mjs

@@ -357,7 +357,11 @@ function summarize(input2) {
   if (input2 == null) return "";
   if (typeof input2 === "string") return input2.slice(0, 160);
   const value = input2.message ?? input2.command ?? input2.query ?? input2.path ?? input2.title ?? input2.url;
-  return String(value ?? JSON.stringify(input2)).slice(0, 2e3);
+  if (value != null) return String(value).slice(0, 2e3);
+  for (let cap = 2e3; ; cap = Math.floor(cap / 2)) {
+    const json2 = JSON.stringify(input2, (_, v) => typeof v === "string" && v.length > cap ? v.slice(0, cap) + "\u2026" : v);
+    if (json2.length <= 2e3 || cap < 16) return json2;
+  }
 }
 function reduceChild(member, { type, data = {}, meta: meta4 }, at = Date.parse(meta4?.at ?? "") || Date.now(), onCutOff) {
   member.card ??= emptyCard();