eve-hub 0.16.42 → 0.16.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-hub",
-  "version": "0.16.42",
+  "version": "0.16.43",
   "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/tools/post_message.d.ts

@@ -20,6 +20,20 @@ export declare const artifactInput: z.ZodObject<{
     }>;
     title: z.ZodString;
 }, z.core.$strip>;
+export declare const trackerRow: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    state: z.ZodEnum<{
+        backlog: "backlog";
+        canceled: "canceled";
+        completed: "completed";
+        started: "started";
+        unstarted: "unstarted";
+    }>;
+    owner: z.ZodString;
+    waitsOn: z.ZodOptional<z.ZodString>;
+    ref: z.ZodString;
+}, z.core.$strip>;
 /** An artifact's link: the one given (a sandbox path uploaded), else the post's first link, else its PR. */
 export declare function artifactUrl(given: string | undefined, text: string, pr: string | undefined, open: (path: string) => Promise<string>): Promise<string>;
 declare const _default: import("eve/tools").ToolDefinition<{
@@ -47,6 +61,14 @@ declare const _default: import("eve/tools").ToolDefinition<{
         title: string;
         url?: string | undefined;
     } | undefined;
+    step?: {
+        id: string;
+        title: string;
+        state: "backlog" | "canceled" | "completed" | "started" | "unstarted";
+        owner: string;
+        waitsOn?: string | undefined;
+        ref?: string | undefined;
+    } | undefined;
 }, {
     messageId: string;
     threadId: string;
@@ -78,6 +100,14 @@ declare const _default: import("eve/tools").ToolDefinition<{
             title: string;
             url?: string | undefined;
         } | undefined;
+        step?: {
+            id: string;
+            title: string;
+            state: "backlog" | "canceled" | "completed" | "started" | "unstarted";
+            owner: string;
+            waitsOn?: string | undefined;
+            ref?: string | undefined;
+        } | undefined;
     }, ctx: import("eve/tools").ToolContext): Promise<{
         messageId: string;
         threadId: string;

package/tools/post_message.js

@@ -133,6 +133,15 @@ export const artifactInput = z.object({
     kind: z.enum(["walkthrough", "sitrep", "plan", "review", "pr", "decision", "doc"]).describe("What the artifact is."),
     title: z.string().min(1).max(80).describe("Names the thing, at most 80 characters, e.g. 'First-sync walk-through'. A newer post under the same kind and title is marked as the latest version; older versions stay listed."),
 });
+// The hub checks each row again (packages/wire/src/state.ts TrackerRow); this is what the model reads.
+export const trackerRow = z.object({
+    id: z.string().describe("Your stable id for the row, e.g. 'review'. Send the same id again to move the row; the hub merges by id."),
+    title: z.string().describe("What the work is, in a few words, e.g. 'Review the fix'."),
+    state: z.enum(["backlog", "unstarted", "started", "completed", "canceled"]).describe("started: being worked on now; unstarted: next, ready to start; backlog: needed before the goal is done, not next; completed: done; canceled: dropped."),
+    owner: z.string().describe("Who acts on it: a bot name or the human's handle."),
+    waitsOn: z.string().optional().describe("Who or what it is blocked on, e.g. 'rconti' or 'an eve maintainer'."),
+    ref: z.string().describe("What the row opens; every row needs one: a post as thr_ID#msg_ID (a hash, never a slash), a PR or issue as owner/repo#N or its github.com URL, or an https URL."),
+});
 /** An artifact's link: the one given (a sandbox path uploaded), else the post's first link, else its PR. */
 export async function artifactUrl(given, text, pr, open) {
     if (given)
@@ -177,8 +186,12 @@ export default defineTool({
             .extend({ url: z.string().optional().describe("What a tap opens: a sandbox path (uploaded), hub://upload link or https URL. Default: the post's first link, else metadata.pr.") })
             .optional()
             .describe("Tags this post as one of the thread's artifacts, shown in the thread's Artifacts pane: a walk-through, sitrep, plan, review, PR, decision or doc. The pane lists every version and marks the newest per kind and title as latest, so post a new version under the same title to supersede the old one."),
+        step: trackerRow
+            .extend({ ref: z.string().optional().describe("What the row opens. Default: this post.") })
+            .optional()
+            .describe("The thread's tracker row this post marks, written with the post: e.g. on a status post handing a PR to review, {id: 'review', title: 'Review the fix', state: 'started', owner: 'reviewer'}. The hub merges it by id, so the same id on a later post moves the same row, and stamps the time and your name when its state, owner or wait changes. Optional."),
     }),
-    async execute({ threadId, agent, text, images, policy, status, metadata, verdict, decisions, tested, artifact }, ctx) {
+    async execute({ threadId, agent, text, images, policy, status, metadata, verdict, decisions, tested, artifact, step }, ctx) {
         const bad = textError(text);
         if (bad)
             throw new Error(bad);
@@ -194,7 +207,7 @@ export default defineTool({
         const res = await registryFetch(`/api/threads/${encodeURIComponent(target)}/messages`, {
             method: "POST",
             headers: { "content-type": "application/json" },
-            body: JSON.stringify({ text: posted, sessionId: ctx.session.id, ...(attachments.length ? { attachments: attachments.map(({ id, name }) => ({ id, name })) } : {}), ...(policy ? { policy } : {}), ...(status ? { status } : {}), ...(metadata ? { metadata } : {}), ...(verdict ? { verdict } : {}), ...(decisions ? { decisions } : {}), ...(tested ? { tested } : {}), ...(tagged ? { artifact: tagged } : {}) }),
+            body: JSON.stringify({ text: posted, sessionId: ctx.session.id, ...(attachments.length ? { attachments: attachments.map(({ id, name }) => ({ id, name })) } : {}), ...(policy ? { policy } : {}), ...(status ? { status } : {}), ...(metadata ? { metadata } : {}), ...(verdict ? { verdict } : {}), ...(decisions ? { decisions } : {}), ...(tested ? { tested } : {}), ...(tagged ? { artifact: tagged } : {}), ...(step ? { step } : {}) }),
         });
         if (!res.ok)
             throw new Error(`post_message failed: ${res.status} ${await res.text()}`);

package/tools/update_thread.d.ts

@@ -9,7 +9,6 @@ declare const _default: import("eve/tools").ToolDefinition<{
         state: "backlog" | "canceled" | "completed" | "started" | "unstarted";
         owner: string;
         waitsOn?: string | undefined;
-        since?: string | undefined;
         ref: string;
     }[] | undefined;
     pathLabel?: string | undefined;
@@ -32,7 +31,6 @@ declare const _default: import("eve/tools").ToolDefinition<{
             state: "backlog" | "canceled" | "completed" | "started" | "unstarted";
             owner: string;
             waitsOn?: string | undefined;
-            since?: string | undefined;
             ref: string;
         }[] | undefined;
         pathLabel?: string | undefined;

package/tools/update_thread.js

@@ -9,17 +9,7 @@ import { defineTool } from "eve/tools";
 import { z } from "zod";
 import { registryFetch } from "../registry-fetch.mjs";
 import { documentUrl } from "../hub-upload.js";
-import { artifactInput, artifactUrl } from "./post_message.js";
-// The hub checks each row again (packages/wire/src/state.ts TrackerRow); this is what the model reads.
-const trackerRow = z.object({
-    id: z.string().describe("Your stable id for the row, unique in the list, e.g. 'server-step-12'. Keep it across rewrites."),
-    title: z.string().describe("What the work is, in a few words, e.g. 'Build server step 12'."),
-    state: z.enum(["backlog", "unstarted", "started", "completed", "canceled"]).describe("started: being worked on now; unstarted: next, ready to start; backlog: needed before the goal is done, not next; completed: done; canceled: dropped."),
-    owner: z.string().describe("Who acts on it: a bot name or the human's handle."),
-    waitsOn: z.string().optional().describe("Who or what it is blocked on, e.g. 'rconti' or 'an eve maintainer'."),
-    since: z.string().optional().describe("With waitsOn: the ISO date the wait began, e.g. '2026-11-03'."),
-    ref: z.string().describe("What the row opens; every row needs one: a post as thr_ID#msg_ID (a hash, never a slash), a PR or issue as owner/repo#N or its github.com URL, or an https URL."),
-});
+import { artifactInput, artifactUrl, trackerRow } from "./post_message.js";
 export default defineTool({
     description: "Update a workspace thread you're in: its title, track, issue type and tracker, in one call. Retitle when the work's scope has changed and the old title no longer fits: everyone sees a short 'renamed this thread: old → new' line; the history is kept. Keep titles short (at most 80 characters). File it on a path (project/track, e.g. 'web/checkout': the first segment is the project, the second the track) and tag an issue type (the kind of work, e.g. 'feature', 'bugfix', 'infra'). Reuse a project, track and issue type in use whenever one fits. File under the project alone until at least 3 threads share a track. For a new tag, also give its display name (projectLabel, pathLabel or issueTypeLabel, e.g. 'Payments API'). The thread's summary isn't yours to write: the hub derives where it stands from its posts after each one. The reply's `inUse` lists the tags in use with their thread counts and flags a tag no other thread uses; when one in use fits better than yours, call update_thread again with it. Tags a human set by hand stay. DMs and archived threads can't be updated.",
     inputSchema: z.object({
@@ -31,7 +21,7 @@ export default defineTool({
             .array(trackerRow)
             .max(50)
             .optional()
-            .describe("The thread's whole tracker: every piece of work toward its goal, one row each, drawn as the Artifacts pane's Pending now (started, unstarted), Pending until done (backlog), Done (completed) and Dropped (canceled) lists. Replaces the previous list; [] clears it. Omit to leave it. Keep it current: send the whole list again whenever a row's state, owner or wait changes. A row whose ref is a PR moves to Done or Dropped by itself when the PR merges or closes."),
+            .describe("Tracker rows to add or change: the thread's pieces of work toward its goal, one row each, drawn as the Artifacts pane's Done (completed), Pending now (started, unstarted), Pending until done (backlog) and Dropped (canceled) lists. The hub merges them by id: a row with a known id is replaced, a new id is added, and rows you don't send stay as they are, so send only the rows that changed. To drop a row, send it as canceled. The hub stamps the time and your name on each row whose state, owner or wait changes. For a step that has its own post, prefer post_message's `step`. A row whose ref is a PR moves to Done or Dropped by itself when the PR merges or closes."),
         pathLabel: z.string().optional().describe("Display name for a new path's last segment, e.g. 'Cart'. Only names a path that has none yet."),
         projectLabel: z.string().optional().describe("Display name for a new project (a path's first segment), shown as its sidebar group, e.g. 'Payments API' for payments-api. Only names a project that has none yet."),
         issueTypeLabel: z.string().optional().describe("Display name for a new issue type tag, e.g. 'Bug fixes' for bugfix. Only names a tag that has none yet."),