@zergai/ztc 0.7.0-beta.1 → 0.8.1-dev.202611041708

package/dist/agent/tools/bus_message.js

@@ -5,6 +5,7 @@
  * from cli_ratatui.ts at startup.
  */
 import { readPaneResponseSnapshot } from '../../utils/pane_response.js';
+import { resolvePaneIdByName } from './pane.js';
 // --- Setter-based transport access ---
 let busTransportRef = null;
 export function setBusTransport(transport) {
@@ -26,6 +27,13 @@ function parseBusRecipient(value) {
         return parseInt(toRaw, 10);
     return new Error(`Error: "to" must be a numeric pane id from [PEERS] or "all"; got "${toRaw}".`);
 }
+/** A pane number, "all", or (outside simulations) the name a person gave a pane. */
+async function resolveBusRecipient(value) {
+    const parsed = parseBusRecipient(value);
+    if (!(parsed instanceof Error) || process.env.ZTC_SIM_FREE_MODE)
+        return parsed;
+    return resolvePaneIdByName(String(value).trim());
+}
 async function waitForNewPaneResponse(paneId, baseline, timeoutMs) {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
@@ -81,7 +89,7 @@ When the user asks you to ask/tell another pane and get a reply, answer, respons
 
 Do not use send_message for non-roster parties; use contact_external(external_id=...) instead.
 
-Use list_terminal_panes to see available pane IDs.`;
+Panes are named: a ZTC pane renamed with /rename shows its session name. When the person mentions a name ("say hi to ben"), it usually means the pane with that name; pass the name as "to", or check list_terminal_panes first.`;
 export const sendMessageTool = {
     definition: {
         name: 'send_message',
@@ -93,7 +101,7 @@ export const sendMessageTool = {
                     type: 'string',
                     description: process.env.ZTC_SIM_FREE_MODE
                         ? 'Recipient pane number (look it up in [PEERS]) or "all" to broadcast.'
-                        : 'Target member ID (number) or "all" for broadcast. Use pane IDs from list_terminal_panes.',
+                        : 'Target pane: its ID, its name as list_terminal_panes shows it (a renamed ZTC pane is named after its session, e.g. "ben"), or "all" for broadcast.',
                 },
                 text: {
                     type: 'string',
@@ -142,10 +150,12 @@ export const sendMessageTool = {
             busTransportRef.sendBusMessage(0, payload, 'ztc_message');
             return `Message queued (${kind}) to ${externalIdRaw}: "${text.slice(0, 100)}${text.length > 100 ? '...' : ''}"`;
         }
-        const to = parseBusRecipient(args.to);
+        const to = await resolveBusRecipient(args.to);
         if (to instanceof Error) {
             return to.message;
         }
+        const named = typeof to === 'number' && !/^\d+$/.test(String(args.to).trim()) ? String(args.to).trim() : null;
+        const recipient = named ? `${named} (ZTC ${to})` : `ZTC ${to}`;
         // In sim free mode, route messages through the coordinator (pane 0) instead of
         // sending directly to target panes. Direct delivery triggers runAgent() on the
         // recipient, creating reactive chains. The coordinator records the message in
@@ -179,16 +189,16 @@ export const sendMessageTool = {
         if (waitForResponse && baseline) {
             try {
                 const response = await waitForNewPaneResponse(to, baseline, 90_000);
-                return `Response from ZTC ${to}:\n${response}`;
+                return `Response from ${recipient}:\n${response}`;
             }
             catch (err) {
-                return `Message sent to ZTC ${to}, but no completed response arrived within 90s: ${err.message}`;
+                return `Message sent to ${recipient}, but no completed response arrived within 90s: ${err.message}`;
             }
         }
         if (to === 'all') {
             return `Message broadcast to all ZTCs: "${text.slice(0, 100)}${text.length > 100 ? '...' : ''}"`;
         }
-        return `Message sent to ZTC ${to}: "${text.slice(0, 100)}${text.length > 100 ? '...' : ''}"`;
+        return `Message sent to ${recipient}: "${text.slice(0, 100)}${text.length > 100 ? '...' : ''}"`;
     },
 };
 export const contactExternalTool = {
@@ -259,8 +269,8 @@ export const askZtcPaneTool = {
             type: 'object',
             properties: {
                 pane_id: {
-                    type: 'number',
-                    description: 'Target ZTC pane ID.',
+                    type: 'string',
+                    description: 'Target ZTC pane: its ID (e.g. "2") or its name as list_terminal_panes shows it (e.g. "ben").',
                 },
                 text: {
                     type: 'string',
@@ -280,11 +290,16 @@ export const askZtcPaneTool = {
         }
         // pane_id 0 (the coordinator) is valid — don't use `|| ''`, which coerces 0
         // to falsy and then rejects it via the >= 0 guard below.
-        const paneId = (args.pane_id === undefined || args.pane_id === null || args.pane_id === '')
-            ? NaN
-            : Number(args.pane_id);
+        const rawTarget = args.pane_id === undefined || args.pane_id === null ? '' : String(args.pane_id).trim();
+        let paneId = rawTarget === '' ? NaN : Number(rawTarget);
+        if (rawTarget !== '' && Number.isNaN(paneId) && !process.env.ZTC_SIM_FREE_MODE) {
+            const resolved = await resolvePaneIdByName(rawTarget);
+            if (resolved instanceof Error)
+                return resolved.message;
+            paneId = resolved;
+        }
         if (Number.isNaN(paneId) || paneId < 0) {
-            return 'Error: pane_id must be a non-negative integer.';
+            return 'Error: pane_id must be a non-negative integer or a pane name.';
         }
         const text = String(args.text || '').trim();
         if (!text) {

package/dist/agent/tools/pane.d.ts

@@ -32,6 +32,11 @@ export declare function publishMirrorZdeLiteState(paneId: number, state: Record<
 export declare function clearPaneToolsTuiProcess(): void;
 export declare function getMuxTransport(): PaneCommandTransport | null;
 export declare function getPaneToolsTransport(): PaneCommandTransport | null;
+/**
+ * Resolves "ben" to the one other pane named ben. People address panes by the
+ * names they gave them with /rename, not by pane number.
+ */
+export declare function resolvePaneIdByName(name: string): Promise<number | Error>;
 export declare function waitForPaneCreatedOrError(tui: PaneCommandTransport, expected: {
     paneType?: string;
     title?: string;

package/dist/agent/tools/pane.js

@@ -269,6 +269,40 @@ function parseLinesInput(value) {
     }
     return text.split(/\r?\n/);
 }
+/** A pane's name is its displayed title: a renamed ZTC pane shows its session name. */
+function paneName(title) {
+    return title.replace(/^\[[^\]]*\]\s*/, '').trim().toLowerCase();
+}
+/**
+ * Resolves "ben" to the one other pane named ben. People address panes by the
+ * names they gave them with /rename, not by pane number.
+ */
+export async function resolvePaneIdByName(name) {
+    if (!tuiProcessRef || !tuiProcessRef.isMuxMode) {
+        return new Error('Error: Pane names are only available with panes (zmux or the desktop app).');
+    }
+    const transport = tuiProcessRef;
+    const listed = waitForEvent(transport, (event) => event.type === 'pane_list', 5000);
+    if (!transport.send({ type: 'list_panes' })) {
+        listed.catch(() => { });
+        return new Error('Error: Unable to list panes to find that name.');
+    }
+    const event = await listed.catch((error) => error);
+    if (event instanceof Error)
+        return new Error(`Error: ${event.message}`);
+    if (event.type !== 'pane_list')
+        return new Error('Error: Unexpected response while listing panes.');
+    const wanted = paneName(name);
+    const others = event.panes.filter((pane) => pane.id !== ownPaneId);
+    const matches = others.filter((pane) => paneName(pane.title) === wanted);
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length > 1) {
+        return new Error(`Error: ${matches.length} panes are named "${name}" (${matches.map((pane) => pane.id).join(', ')}); use a pane ID.`);
+    }
+    const names = others.map((pane) => `[${pane.id}] ${pane.title}`).join(', ');
+    return new Error(`Error: no pane is named "${name}". ${names ? `Panes: ${names}.` : 'There are no other panes.'}`);
+}
 export function waitForPaneCreatedOrError(tui, expected, timeoutMs = 15000) {
     return waitForEvent(tui, (event) => event.type === 'error' || (event.type === 'pane_created'
         && (!expected.requestId || event.request_id === expected.requestId)

package/dist/cli_ratatui.js

@@ -1,6 +1,6 @@
 import { environmentOperationInProgress } from './agent/commands/environment.js';
 import { getEnvironment, openEnvironment, releaseEnvironment, describeEnvironmentForAgent, isEnvironmentWorkspacePath } from './environment/store.js';
-import { readPaneLabels } from './panes/labels.js';
+import { readPaneLabels, sessionNamePaneTitle } from './panes/labels.js';
 import { reconcileOrderedTranscript } from './app/ordered_transcript.js';
 import { listCommandJobs, shutdownCommandJobs, subscribeCommandJobs } from './agent/runtime/command_jobs.js';
 import { CommandPaneManager, commandPaneText } from './agent/runtime/command_panes.js';
@@ -2525,7 +2525,7 @@ export class RatatuiApp {
                     if (!this.paneActivityTransport().hasCapability('pane_labels_v1'))
                         this.syncOwnPaneTitle();
                     else if (this.sessionName)
-                        this.paneActivityTransport().send({ type: 'set_pane_title', pane_id: paneId, title: this.sessionName });
+                        this.paneActivityTransport().send(sessionNamePaneTitle(paneId, this.sessionName));
                     else
                         void readPaneLabels(this.paneActivityTransport(), paneId).then(labels => {
                             delete labels.manual_title;
@@ -2533,6 +2533,7 @@ export class RatatuiApp {
                         }).catch(error => this.addSystemMessage(`Unable to clear pane name: ${error.message}`));
                 }
                 this.sessionLabels.manual_title = this.sessionName;
+                this.mirrorClient?.setPaneName(this.sessionName);
                 this.render();
             },
             getPaneLabels: async (paneId) => {
@@ -2546,6 +2547,7 @@ export class RatatuiApp {
                 if (paneId === undefined) {
                     this.sessionLabels = { ...labels };
                     this.sessionName = labels.manual_title;
+                    this.mirrorClient?.setPaneName(this.sessionName);
                 }
                 else {
                     const pane = this.paneRegistry.get(paneId);
@@ -4263,6 +4265,7 @@ export class RatatuiApp {
                         return;
                     this.sessionLabels = { ...labels };
                     this.sessionName = labels.manual_title;
+                    this.mirrorClient?.setPaneName(this.sessionName);
                     this.render();
                 });
                 setPaneToolsTuiProcess(this.paneRelayClient);

package/dist/emulation/ztc_mux_addendum.js

@@ -20,6 +20,14 @@ must actually use the relevant pane or bus tools in that turn.
 - Use \`write_terminal_pane\` only for non-ZTC panes such as shells, commands, or editors.
 - Use \`list_terminal_panes\` and \`read_terminal_pane\` to confirm what happened before reporting results.
 
+### Pane Names
+
+Panes have names. A ZTC pane renamed with \`/rename\` shows its session name
+(\`list_terminal_panes\` lists it, e.g. \`[1] ben\`). When the person mentions a
+name ("say hi to ben", "ask matt"), assume they mean the pane with that name:
+pass the name to \`send_message\` (\`to\`) or \`ask_ztc_pane\` (\`pane_id\`), or check
+\`list_terminal_panes\` first. Ask only if no pane has that name.
+
 ### Per-Pane Model Selection
 
 When creating ZTC panes with \`create_ztc_pane\`, you can specify different LLM models:

package/dist/panes/labels.d.ts

@@ -5,6 +5,13 @@ export declare function readPaneLabels(transport: {
     on(handler: (event: RustEvent) => void): () => void;
     hasCapability?(name: string): boolean;
 }, paneId: number): Promise<PaneLabels>;
+/**
+ * Names a pane after its session. Explicitly manual: the native renderers read
+ * a title without `source` as inferred, and the next activity title replaces
+ * an inferred title, so a /rename vanished from the pane, its pill and
+ * list_terminal_panes.
+ */
+export declare function sessionNamePaneTitle(paneId: number, name: string): RustCommand;
 /** Mirror of the native PaneLabels projection; inferred state stays independent. */
 export declare function displayPaneTitle(inferred: string, labels?: PaneLabels): string;
 export declare function inferAgentPaneTitle(input: {

package/dist/panes/labels.js

@@ -29,6 +29,15 @@ export async function readPaneLabels(transport, paneId) {
         }
     });
 }
+/**
+ * Names a pane after its session. Explicitly manual: the native renderers read
+ * a title without `source` as inferred, and the next activity title replaces
+ * an inferred title, so a /rename vanished from the pane, its pill and
+ * list_terminal_panes.
+ */
+export function sessionNamePaneTitle(paneId, name) {
+    return { type: 'set_pane_title', pane_id: paneId, title: name, source: 'manual' };
+}
 /** Mirror of the native PaneLabels projection; inferred state stays independent. */
 export function displayPaneTitle(inferred, labels = {}) {
     const title = labels.manual_title || [labels.project, labels.task, inferred].filter(Boolean).join(' · ');

package/dist/web/mirror_client.d.ts

@@ -38,6 +38,8 @@ export declare class MirrorClient implements MirrorPublisher {
     constructor(port: number, paneId: number, options?: MirrorClientOptions | string);
     getPaneId(): number;
     getPaneName(): string;
+    /** A renamed pane speaks under its session name; no name restores "ZTC <id>". */
+    setPaneName(name: string | undefined): void;
     getBusMember(): BusMember;
     publish(event: {
         type: string;

package/dist/web/mirror_client.js

@@ -56,6 +56,11 @@ export class MirrorClient {
     getPaneName() {
         return this.paneName;
     }
+    /** A renamed pane speaks under its session name; no name restores "ZTC <id>". */
+    setPaneName(name) {
+        const trimmed = name?.trim();
+        this.paneName = trimmed ? trimmed : this.paneId > 0 ? `ZTC ${this.paneId}` : 'ZTC';
+    }
     getBusMember() {
         return { id: this.paneId, name: this.paneName };
     }

package/dist/zlm-embed.mjs

@@ -78502,7 +78502,7 @@ var invokeSkillTool = makeInvokeSkillTool(resolveAmbientSkills);
 // src/zlm.ts
 var ZLM_EMBED_API_VERSION = "zerglang.ztc-embed/1";
 var ZLM_STDIO_PROTOCOL = "zerglang.ztc-host/1";
-var ZLM_ZTC_VERSION = true ? "0.7.0-beta.1" : "development";
+var ZLM_ZTC_VERSION = true ? "0.8.1-dev.202611041708" : "development";
 var ZLM_MAX_HOST_TOOLS = 64;
 var ZLM_MAX_SYSTEM_PROMPT_BYTES = 128 * 1024;
 var ZLM_HOST_APPROVAL_CAPABILITIES = Object.freeze([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zergai/ztc",
-  "version": "0.7.0-beta.1",
+  "version": "0.8.1-dev.202611041708",
   "description": "Zerg Terminal Client - CLI agent for continual AI systems",
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://zergai.com/docs/ztc",
@@ -275,13 +275,13 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "zergRelease": {
-    "branch": "main",
-    "channel": "next",
-    "sourceCommit": "fbac9c4b9709a604200a4865467591b4d31dbcf3",
+    "branch": "development",
+    "channel": "dev",
+    "sourceCommit": "eac530d341d6b7057b5fcc242ce3d9c835ceeeb1",
     "sourceVersion": "0.2.0-canary.2"
   },
   "publishConfig": {
-    "tag": "next",
+    "tag": "dev",
     "access": "public"
   }
 }