tesseract-agent 0.10.4 → 0.10.6

package/dist-bundle/cli.js

@@ -3961,6 +3961,61 @@ var init_permissions = __esm({
   }
 });
 
+// ../../packages/shared/dist/app-elements.js
+var APP_ELEMENTS, byId, APP_ELEMENT_IDS;
+var init_app_elements = __esm({
+  "../../packages/shared/dist/app-elements.js"() {
+    "use strict";
+    APP_ELEMENTS = [
+      {
+        id: "composer.input",
+        area: "composer",
+        title: "The message box",
+        // The composer is MOUNTED but not LAID OUT until a conversation is open — zero rect, no
+        // offsetParent — so without this a tour step pointing at it on a fresh Files view resolves
+        // nothing. Found by running the tour in the app; no amount of type-checking would show it.
+        reveal: "app.newConversation",
+        description: "Where you type what you want the AI to do. The main way you talk to Tesseract."
+      },
+      {
+        id: "titlebar.search",
+        area: "titlebar",
+        title: "Search",
+        description: "Opens search and the command palette \u2014 the fastest way to find anything."
+      },
+      {
+        id: "titlebar.settings",
+        area: "titlebar",
+        title: "Settings",
+        reveal: "app.openSettings",
+        description: "Opens Settings, where models, voice, appearance and permissions live."
+      },
+      {
+        id: "titlebar.tasksRail",
+        area: "titlebar",
+        title: "The work panel button",
+        description: "Shows or hides the panel listing what the AI is working on."
+      },
+      {
+        id: "home.gettingStarted",
+        area: "home",
+        title: "The getting-started list",
+        reveal: "app.openHome",
+        description: "The first-run checklist on Home. Ticks itself off as you go."
+      },
+      {
+        id: "rail.tasks",
+        area: "rail",
+        title: "The work panel",
+        reveal: "app.toggleTasksRail",
+        description: "Lists running and past work, so you can follow along or come back to it."
+      }
+    ];
+    byId = new Map(APP_ELEMENTS.map((e) => [e.id, e]));
+    APP_ELEMENT_IDS = APP_ELEMENTS.map((e) => e.id);
+  }
+});
+
 // ../../packages/shared/dist/ws-protocol.js
 var RV_MAX_CYCLES, RV_GRADE_ATTEMPTS, RV_GRADE_TIMEOUT_MS, RV_GRADE_BACKOFF_MS, RV_VERDICT_GRACE_MS, MIRRORED_AGENT_EVENTS, OWN_STUN_HOST, OWN_STUN_PORT, OWN_STUN_URL, PUBLIC_STUN_URLS, DEFAULT_ICE_SERVERS;
 var init_ws_protocol = __esm({
@@ -7137,6 +7192,7 @@ var init_dist = __esm({
     "use strict";
     init_surface_merge();
     init_permissions();
+    init_app_elements();
     init_ws_protocol();
     init_context_overflow();
     init_engine_api_error();
@@ -27639,6 +27695,47 @@ var init_capabilities = __esm({
         help: "What the model is told the `present.end` App-Control capability does (present domain, write).",
         vars: [],
         content: `Stop the live presentation.`
+      },
+      // ── Guided tour ──
+      {
+        id: "capability.tour.start",
+        group: "tools",
+        label: "Start the guided tour",
+        help: "What the model is told the `tour.start` App-Control capability does (tour domain, write).",
+        vars: [],
+        content: `Start the app's guided tour \u2014 a short walkthrough that dims the screen, highlights one thing at a time, and explains it. Use it when someone asks to be shown around, or is plainly lost about where things are. Pass stepId to drop them at a specific point instead of the beginning.`
+      },
+      {
+        id: "capability.tour.stop",
+        group: "tools",
+        label: "Stop the guided tour",
+        help: "What the model is told the `tour.stop` App-Control capability does (tour domain, write).",
+        vars: [],
+        content: `Stop the guided tour and clear its overlay. Use it as soon as the person says they are done, or when you are about to do something they need the whole screen for.`
+      },
+      {
+        id: "capability.tour.state",
+        group: "tools",
+        label: "Where the tour is",
+        help: "What the model is told the `tour.state` App-Control capability does (tour domain, read).",
+        vars: [],
+        content: `Read where the guided tour is: which step, its title, how many are left, whether the thing it points at was actually found, and whether it is the person's turn to act. Call this before moving the tour rather than assuming where it got to.`
+      },
+      {
+        id: "capability.tour.control",
+        group: "tools",
+        label: "Drive the guided tour",
+        help: "What the model is told the `tour.control` App-Control capability does (tour domain, write). The action list is fixed in the registry; only the wording is tunable here.",
+        vars: [],
+        content: `Drive a running tour: move between steps (tour_move with by or to), read where it is (tour_state), end it (tour_end), change the pace (tour_set_pace), point at part of the app (highlight), draw a mark on it (annotate), or go quiet and let the person work (stop_talking). Targets are names from the app's element list, never CSS selectors. There is deliberately no way to click things on the person's behalf here \u2014 point at what they should do and let them do it.`
+      },
+      {
+        id: "capability.tour.reset",
+        group: "tools",
+        label: "Offer the tour again",
+        help: "What the model is told the `tour.reset` App-Control capability does (tour domain, write).",
+        vars: [],
+        content: `Clear the record of the person having seen the tour, so it is offered again on the Home screen. Use it when someone asks to see the introduction from scratch.`
       }
     ];
   }
@@ -30488,7 +30585,7 @@ var init_computer_control_tools = __esm({
 
 // ../../packages/agent-core/dist/app-control/registry.js
 function capabilityById(id) {
-  return byId.get(id);
+  return byId2.get(id);
 }
 function capabilitiesByDomain(d) {
   return APP_CAPABILITIES.filter((c) => c.domain === d);
@@ -30523,7 +30620,7 @@ function describeCapabilityInput(obj) {
   }
   return out;
 }
-var ENGINE_ID, IMAGE_PROVIDER, VOICE_PROVIDER, MARKETPLACE_FAMILY, PERMISSION_ID, APP_CAPABILITY_SHAPES, APP_CAPABILITIES, byId, APP_CONTROL_DOMAINS;
+var ENGINE_ID, IMAGE_PROVIDER, VOICE_PROVIDER, MARKETPLACE_FAMILY, PERMISSION_ID, APP_CAPABILITY_SHAPES, APP_CAPABILITIES, byId2, APP_CONTROL_DOMAINS;
 var init_registry = __esm({
   "../../packages/agent-core/dist/app-control/registry.js"() {
     "use strict";
@@ -31228,10 +31325,68 @@ ${JSON.stringify(r, null, 2)}`
         mutation: "write",
         availability: "daemon",
         binding: { kind: "ipc", channel: "present", verb: "end" }
+      },
+      // ── Guided tour (the app's own onboarding walkthrough) ──
+      // All 'desktop': the tour engine and its overlay live in the renderer, so every one of these
+      // round-trips to the window. `tour.state` relies on the nav ack carrying the command's RETURN
+      // value (see apps/desktop/src/main/app-control.ts) — a read capability that could only report
+      // "ok" would be useless.
+      {
+        id: "tour.start",
+        domain: "tour",
+        title: "Start the guided tour",
+        input: external_exports.object({
+          stepId: external_exports.string().optional().describe("Step to start at. Omit to start at the beginning.")
+        }),
+        mutation: "write",
+        availability: "desktop",
+        binding: { kind: "command", command: "app.tour.start" },
+        summarize: () => "Started the tour."
+      },
+      {
+        id: "tour.stop",
+        domain: "tour",
+        title: "Stop the guided tour",
+        input: external_exports.object({}),
+        mutation: "write",
+        availability: "desktop",
+        binding: { kind: "command", command: "app.tour.stop" },
+        summarize: () => "Stopped the tour."
+      },
+      {
+        id: "tour.state",
+        domain: "tour",
+        title: "Where the tour is",
+        input: external_exports.object({}),
+        mutation: "read",
+        availability: "desktop",
+        binding: { kind: "command", command: "app.tour.state" }
+      },
+      {
+        id: "tour.control",
+        domain: "tour",
+        title: "Drive the guided tour",
+        input: external_exports.object({
+          name: external_exports.enum(["tour_move", "tour_state", "tour_end", "tour_set_pace", "highlight", "annotate", "stop_talking"]).describe("Which tour action to run."),
+          args: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe('Arguments for that action, e.g. {"by":1} or {"target":"composer.input"}.')
+        }),
+        mutation: "write",
+        availability: "desktop",
+        binding: { kind: "command", command: "app.tour.control" }
+      },
+      {
+        id: "tour.reset",
+        domain: "tour",
+        title: "Offer the tour again",
+        input: external_exports.object({}),
+        mutation: "write",
+        availability: "desktop",
+        binding: { kind: "command", command: "app.tour.reset" },
+        summarize: () => "The tour will be offered again."
       }
     ];
     APP_CAPABILITIES = describedBy("capability", APP_CAPABILITY_SHAPES, (c) => c.id);
-    byId = new Map(APP_CAPABILITIES.map((c) => [c.id, c]));
+    byId2 = new Map(APP_CAPABILITIES.map((c) => [c.id, c]));
     APP_CONTROL_DOMAINS = (() => {
       const seen = [];
       for (const c of APP_CAPABILITIES)
@@ -32600,9 +32755,9 @@ async function findEngines(query2, catalog, opts = {}) {
       note = `Semantic re-rank unavailable (${e instanceof Error ? e.message : String(e)}); ranked lexically.`;
     }
   }
-  const byId2 = new Map(pool.map((e) => [e.id, e]));
+  const byId3 = new Map(pool.map((e) => [e.id, e]));
   if (!semantic?.length) {
-    const hits2 = lexOrder.map((id) => ({ ...byId2.get(id), score: (lex.get(id) ?? 0) * (byId2.get(id).status ? 0.1 : 1) })).sort((a, b) => b.score - a.score).slice(0, limit);
+    const hits2 = lexOrder.map((id) => ({ ...byId3.get(id), score: (lex.get(id) ?? 0) * (byId3.get(id).status ? 0.1 : 1) })).sort((a, b) => b.score - a.score).slice(0, limit);
     return { hits: hits2, mode: "lexical", ...note ? { note } : {} };
   }
   const lexPoints = rrfPoints([...lex.entries()].map(([id, score]) => ({ id, score })), false);
@@ -32613,7 +32768,7 @@ async function findEngines(query2, catalog, opts = {}) {
   for (const e of pool)
     if (e.status)
       fused.set(e.id, (fused.get(e.id) ?? 0) * 0.1);
-  const hits = [...fused.entries()].sort((a, b) => b[1] - a[1]).slice(0, limit).map(([id, score]) => ({ ...byId2.get(id), score })).filter((h) => h.id);
+  const hits = [...fused.entries()].sort((a, b) => b[1] - a[1]).slice(0, limit).map(([id, score]) => ({ ...byId3.get(id), score })).filter((h) => h.id);
   return { hits, mode: "hybrid" };
 }
 var STOP, cosine, RRF_K;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tesseract-agent",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public",