ocuclaw 1.3.1 → 1.3.3

package/dist/tools/session-title-tool.test.js

@@ -0,0 +1,53 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createSessionTitleToolHandler, TOOL_DESCRIPTION } from "./session-title-tool.ts";
+
+function deps(over = {}) {
+  const calls = [];
+  return {
+    calls,
+    peekSessionKey: () => "ocuclaw:123",
+    setSessionTitle: (k, t, o) => { calls.push({ k, t, o }); return { ok: true }; },
+    ...over,
+  };
+}
+
+test("description is explicit-rename-only", () => {
+  assert.match(TOOL_DESCRIPTION, /explicitly asks to rename|user explicitly/i);
+});
+
+test("explicit rename passes origin user_tool", async () => {
+  const d = deps();
+  const h = createSessionTitleToolHandler(d);
+  await h.setSessionTitle({ title: "Trip Planning" });
+  assert.equal(d.calls[0].o.origin, "user_tool");
+});
+
+test("a user-locked session can STILL be renamed via the tool", async () => {
+  const d = deps({
+    setSessionTitle: (k, t, o) => {
+      // service-layer would allow user_tool over a lock; tool must not pre-block
+      return { ok: true };
+    },
+  });
+  const h = createSessionTitleToolHandler(d);
+  const r = await h.setSessionTitle({ title: "New Name" });
+  assert.deepEqual(r, { ok: true });
+});
+
+test("feature-disabled does NOT block an explicit rename", async () => {
+  const d = deps({ isNeuralSessionNamesEnabled: () => false });
+  const h = createSessionTitleToolHandler(d);
+  const r = await h.setSessionTitle({ title: "Anything" });
+  assert.deepEqual(r, { ok: true });
+});
+
+test("still rejects an empty title", async () => {
+  const h = createSessionTitleToolHandler(deps());
+  await assert.rejects(() => h.setSessionTitle({ title: "   " }), /title_empty/);
+});
+
+test("still rejects when no active session", async () => {
+  const h = createSessionTitleToolHandler(deps({ peekSessionKey: () => "" }));
+  await assert.rejects(() => h.setSessionTitle({ title: "X" }), /no_active_session/);
+});

package/dist/version.js

@@ -1,2 +1,2 @@
-export const PLUGIN_VERSION = "1.3.1";
-export const REQUIRES_CLIENT_VERSION = "1.3.1";
+export const PLUGIN_VERSION = "1.3.3";
+export const REQUIRES_CLIENT_VERSION = "1.3.3";

package/openclaw.plugin.json

@@ -43,6 +43,11 @@
       "help": "Optional extra system prompt appended to Even AI runs only.",
       "advanced": true
     },
+    "sessionTitleModel": {
+      "label": "Session-title model",
+      "help": "Optional model override (\"provider/model\") for the background session-title distiller. Leave blank to use your normal model.",
+      "advanced": true
+    },
     "evenAiRoutingMode": {
       "label": "Even AI routing mode",
       "help": "active = current session; background = dedicated background session; background_new = fresh background session per request.",
@@ -226,6 +231,10 @@
         "maximum": 8000,
         "default": 5000,
         "description": "How long (ms) a fresh agent summary stays preferred over a tool label in the glasses activity status. Clamped 3000-8000."
+      },
+      "sessionTitleModel": {
+        "type": "string",
+        "description": "Optional model override (\"provider/model\") for the background session-title distiller. When absent, the user's normal model is used."
       }
     },
     "if": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ocuclaw",
-  "version": "1.3.1",
-  "requiresClientVersion": "1.3.1",
+  "version": "1.3.3",
+  "requiresClientVersion": "1.3.3",
   "description": "OcuClaw for Even Realities G2 smart glasses.",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,6 +40,7 @@
   },
   "scripts": {
     "build": "node ./scripts/build.mjs",
-    "prepare": "node ./scripts/build.mjs"
+    "prepare": "node ./scripts/build.mjs",
+    "test:unit": "node --import ./scripts/test-loader.mjs --test --test-force-exit \"src/**/*.test.ts\""
   }
 }

package/skills/glasses-ui/SKILL.md

@@ -6,7 +6,14 @@ user-invocable: false
 
 # Authoring glasses surfaces with `render_glasses_ui`
 
-`render_glasses_ui` paints an interactive surface on the user's Even G2 HUD instead of a text reply. The call blocks until the user selects, dismisses, or backs out. This skill is the source of truth for **authoring** surfaces; the tool description is deliberately lean.
+`render_glasses_ui` paints an interactive surface on the user's Even G2 HUD instead of a text reply. Think in two verbs: the render **paints** (the surface lives on glass, ticking, until the user exits or its refresh budget ends) and the call carries **one one-shot listen** (a bounded window in which a tap resolves your call live). The paint outlives the listen by design. This skill is the source of truth for **authoring** surfaces; the tool description is deliberately lean.
+
+## Before you author: is the tool loaded?
+
+`render_glasses_ui` is a plugin tool, and depending on the host runtime it may not sit in your initial tool list:
+
+1. **Not listed but searchable** — some runtimes (e.g. the Codex harness) defer OpenClaw dynamic tools behind tool search. Search your available/deferred tools for `render_glasses_ui` (it surfaces under the `openclaw` namespace), load it, and proceed.
+2. **Not findable at all** — the host's tool policy is filtering plugin tools. Newer OpenClaw versions (2026.6+) default `tools.profile` to `"coding"`, a base allowlist that strips plugin-owned tools; skills are not policy-filtered, which is why you can read this guide for a tool you cannot call. Don't improvise a workaround: tell the user to run `openclaw config set tools.alsoAllow '["ocuclaw"]' --strict-json` (merging `"ocuclaw"` into any existing `alsoAllow` list rather than overwriting) and restart the gateway, then try again.
 
 ## Surface kinds
 
@@ -135,6 +142,20 @@ render_glasses_ui({
 })
 ```
 
+## The interaction window (the listen)
+
+Every call carries **one one-shot listen**: the host waits **90 seconds by default** for the user to act, **up to 600000 ms (10 min) via the optional `timeoutMs` param**. Pass `timeoutMs: 300000–600000` when you expect the user to read or decide; omit it for fire-and-forget paints; never go below 60000 for anything interactive. The listen is **never renewed automatically** — re-rendering opens a fresh one.
+
+When the listen ends without a tap you get a **non-terminal** `{ result: "window_expired", surface_still_live: true }`. **This is not an error and not a paint event** — the surface stays on glass and keeps ticking. From there:
+
+- Taps now **park** (the user sees their tap acknowledged; nothing is lost). Re-render the same surface (`update: "patch"`) to collect parked taps in this run — chain a couple of these listens if you are actively waiting, then stop.
+- Or simply **end your turn** — parked taps **wake you** (one agent turn per real parked gesture, delivered as a refs-only plugin notification; re-render to collect) or ride your next turn. Ending your turn with a surface parked is a normal, cheap state, not an abandonment.
+- **Silence-as-consent**: the window doubles as a default-action deadline. Put the deadline in the body copy ("Merging in 5 min unless you stop me"), give it a matching `timeoutMs`, and treat `window_expired` as consent.
+
+Parked deliveries arrive annotated: `surfaceUuid`, `eventId`, `origin`, `actor`, `queuedAtMs`, `parkedForMs`. For taps that **actuate** something (sell/approve/unlock), declare `staleAfterMs` per render — a tap parked longer arrives with `stale: true`: treat it as a re-confirm prompt, **never** execute it as-is.
+
+(The `await`/listen-without-repaint verb namespace is reserved for a future version — don't repurpose those words in surface copy or tooling.)
+
 ## Outcomes (the `result` you get back)
 
 | result | meaning |
@@ -142,15 +163,17 @@ render_glasses_ui({
 | `selected` | user picked a list item; `selected_index` + `selected_text` returned |
 | `back` | user double-tapped above the root; they want to revise — re-render the previous step or pivot |
 | `dismissed` | dismissed at root, or no selection made |
-| `timeout` | no interaction within the window (non-refresh default 30 min; refresh ends at `maxDurationMs`) |
+| `window_expired` | **non-terminal** — the listen ended, the surface is still live; taps park (see the interaction-window section) |
+| `timeout` | terminal hygiene cap (rare); a refresh surface ends at `maxDurationMs` |
 | `recipe_failed` | refresh only — initial smoke tick failed, the consecutive-failure breaker fired, or `onError:stop`; `failureReason` carries the last error |
 | `glasses_disconnected` | refresh only — the glasses client dropped mid-cron |
 
-Refresh results also carry: `ticks: { count, succeeded, failed, lastSuccessAt, lastFailureAt? }`, `lastBody`, `lastItems`, and `failureReason` (on `recipe_failed`).
+Every delivery carries the surface's durable `surfaceUuid` plus `origin` (`gesture` for wearer actions, `system` for plugin-initiated outcomes) and an `actor` slot. Refresh results also carry: `ticks: { count, succeeded, failed, lastSuccessAt, lastFailureAt? }`, `lastBody`, `lastItems`, and `failureReason` (on `recipe_failed`).
 
 ## Quick reference
 
 - Pick the **lowest tier**: host metrics → `system-stats`; pure data API → `http` (not enabled yet). Needs interpretation → render once from your turn.
 - `update` default is `replace` (in-place). Use `push` to drill in without losing the parent; `patch` to edit fields while the cron keeps ticking.
+- The listen is one-shot: default 90 s, `timeoutMs` up to 600000 (use 300000–600000 for read-or-decide). `window_expired` ≠ error — re-render to collect parked taps, or end your turn (they wake you / ride the next turn).
 - `intervalMs` ≥ 1000. Read `failureReason` on `recipe_failed` and fix the recipe.
 - After a surface resolves, a short text reply exits to chat; another render replaces; silence lets it linger.