npm - conductor-remote - Versions diffs - 1.110.0 → 1.111.0 - Mend

conductor-remote 1.110.0 → 1.111.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md +3 -3
package/dist/assets/{PierrePatch-YcYgYId9.js → PierrePatch-QISkVnaE.js} +1 -1
package/dist/assets/{index-Bi66ei7k.js → index-Dg6_e4df.js} +2 -2
package/dist/index.html +1 -1
package/dist/sw.js +1 -1
package/dist-node/src/server.js +46 -3
package/dist-node/src/voice/brief.js +157 -10
package/dist-node/src/voice/preview.js +49 -6
package/dist-node/src/voice/prompt.js +3 -1
package/dist-node/src/voice/tools.js +164 -7
package/docs/voice-setup.md +22 -10
package/package.json +1 -1

package/dist/index.html CHANGED Viewed

@@ -25,7 +25,7 @@
 		<title>Conductor Remote</title>
 		<!-- Runs before the module bundle so it can catch a stale shell that fails to boot. -->
 		<script src="/self-heal.js"></script>
-		<script type="module" crossorigin src="/assets/index-Bi66ei7k.js"></script>
+		<script type="module" crossorigin src="/assets/index-Dg6_e4df.js"></script>
 		<link rel="stylesheet" crossorigin href="/assets/index-iryu1HEQ.css">
 	<link rel="manifest" href="/manifest.webmanifest"></head>
 	<body>

package/dist/sw.js CHANGED Viewed

	@@ -1 +1 @@
1	- if(!self.define){let e,s={};const i=(i,n)=>(i=new URL(i+".js",n).href,s[i]\|\|new Promise(s=>{if("document"in self){const e=document.createElement("script");e.src=i,e.onload=s,document.head.appendChild(e)}else e=i,importScripts(i),s()}).then(()=>{let e=s[i];if(!e)throw new Error(`Module ${i} didn’t register its module`);return e}));self.define=(n,r)=>{const l=e\|\|("document"in self?document.currentScript.src:"")\|\|location.href;if(s[l])return;let o={};const t=e=>i(e,l),a={module:{uri:l},exports:o,require:t};s[l]=Promise.all(n.map(e=>a[e]\|\|t(e))).then(e=>(r(...e),o))}}define(["./workbox-dcde9eb3"],function(e){"use strict";importScripts("/push-sw.js"),self.addEventListener("message",e=>{e.data&&"SKIP_WAITING"===e.data.type&&self.skipWaiting()}),e.clientsClaim(),e.precacheAndRoute([{url:"self-heal.js",revision:"49bd63adb25a09341f8d2610e8bd3c76"},{url:"push-sw.js",revision:"e7ef44deca46c0539e6ff7bba5eb815e"},{url:"index.html",revision:"~~e3a14ecc2f253f78577bed2a5529438c~~"},{url:"assets/workbox-window.prod.es5-BBnX5xw4.js",revision:null},{url:"assets/pierre-shiki-wasm-C8ETeZem.js",revision:null},{url:"assets/pierre-light-480U9XYS.js",revision:null},{url:"assets/pierre-dark-CyvmCCZW.js",revision:null},{url:"assets/index-iryu1HEQ.css",revision:null},{url:"assets/index-~~Bi66ei7k~~.js",revision:null},{url:"assets/PierrePatch-~~YcYgYId9~~.js",revision:null},{url:"apple-touch-icon.png",revision:"1127bb396b4648add53dce3f22c92aee"},{url:"icon-192.png",revision:"c5e01ac58768627e18ee7b8b6a9239ef"},{url:"icon-512.png",revision:"a40638c55e310312457a621c9a0002c8"},{url:"icon-maskable-512.png",revision:"a9b0d962686287452216492cd2247499"},{url:"icon.svg",revision:"c1aee186821798733dd477e69a0ef243"},{url:"manifest.webmanifest",revision:"cf88fbc5755108a7fe0616fa160a8a15"}],{}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("/index.html"),{denylist:[/^\/api\//]})),e.registerRoute(({url:e})=>e.pathname.startsWith("/assets/diff-syntax/"),new e.CacheFirst({cacheName:"diff-syntax",plugins:[new e.ExpirationPlugin({maxEntries:32,maxAgeSeconds:31536e3})]}),"GET")});
1	+ if(!self.define){let e,s={};const i=(i,n)=>(i=new URL(i+".js",n).href,s[i]\|\|new Promise(s=>{if("document"in self){const e=document.createElement("script");e.src=i,e.onload=s,document.head.appendChild(e)}else e=i,importScripts(i),s()}).then(()=>{let e=s[i];if(!e)throw new Error(`Module ${i} didn’t register its module`);return e}));self.define=(n,r)=>{const l=e\|\|("document"in self?document.currentScript.src:"")\|\|location.href;if(s[l])return;let o={};const t=e=>i(e,l),a={module:{uri:l},exports:o,require:t};s[l]=Promise.all(n.map(e=>a[e]\|\|t(e))).then(e=>(r(...e),o))}}define(["./workbox-dcde9eb3"],function(e){"use strict";importScripts("/push-sw.js"),self.addEventListener("message",e=>{e.data&&"SKIP_WAITING"===e.data.type&&self.skipWaiting()}),e.clientsClaim(),e.precacheAndRoute([{url:"self-heal.js",revision:"49bd63adb25a09341f8d2610e8bd3c76"},{url:"push-sw.js",revision:"e7ef44deca46c0539e6ff7bba5eb815e"},{url:"index.html",revision:"5c4dca29374e8cbef37b975e6844f509"},{url:"assets/workbox-window.prod.es5-BBnX5xw4.js",revision:null},{url:"assets/pierre-shiki-wasm-C8ETeZem.js",revision:null},{url:"assets/pierre-light-480U9XYS.js",revision:null},{url:"assets/pierre-dark-CyvmCCZW.js",revision:null},{url:"assets/index-iryu1HEQ.css",revision:null},{url:"assets/index-Dg6_e4df.js",revision:null},{url:"assets/PierrePatch-QISkVnaE.js",revision:null},{url:"apple-touch-icon.png",revision:"1127bb396b4648add53dce3f22c92aee"},{url:"icon-192.png",revision:"c5e01ac58768627e18ee7b8b6a9239ef"},{url:"icon-512.png",revision:"a40638c55e310312457a621c9a0002c8"},{url:"icon-maskable-512.png",revision:"a9b0d962686287452216492cd2247499"},{url:"icon.svg",revision:"c1aee186821798733dd477e69a0ef243"},{url:"manifest.webmanifest",revision:"cf88fbc5755108a7fe0616fa160a8a15"}],{}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("/index.html"),{denylist:[/^\/api\//]})),e.registerRoute(({url:e})=>e.pathname.startsWith("/assets/diff-syntax/"),new e.CacheFirst({cacheName:"diff-syntax",plugins:[new e.ExpirationPlugin({maxEntries:32,maxAgeSeconds:31536e3})]}),"GET")});

package/dist-node/src/server.js CHANGED Viewed

@@ -224,14 +224,31 @@ function voiceBoard(callId) {
     let board = voiceBoards.get(callId);
     if (board)
         return board;
-    board = new VoiceBriefBoard({ reads, locked: async () => (await screenLocked()) === true, readPrefs, writePrefs });
+    board = new VoiceBriefBoard({
+        reads: {
+            listWorkspaces: () => {
+                const workspaces = reads.listWorkspaces();
+                attachPrStatus(workspaces);
+                return workspaces;
+            },
+            listSessionStates: () => reads.listSessionStates(),
+            lastAssistantText: sessionId => reads.lastAssistantText(sessionId),
+            lastQuestionInput: sessionId => reads.lastQuestionInput(sessionId)
+        },
+        locked: async () => (await screenLocked()) === true,
+        readPrefs,
+        writePrefs
+    });
     voiceBoards.set(callId, board);
     return board;
 }
-async function dispatchVoicePreview(preview) {
+function voiceRelayOrigin() {
     const host = !cfg.host || cfg.host === '0.0.0.0' || cfg.host === '::' ? '127.0.0.1' : cfg.host;
+    return `http://${host}:${cfg.port}`;
+}
+async function dispatchVoicePreview(preview) {
     const timeoutMs = 75_000;
-    const res = await fetch(`http://${host}:${cfg.port}${routes.sendPrompt.path(preview.sessionId)}`, {
+    const res = await fetch(`${voiceRelayOrigin()}${routes.sendPrompt.path(preview.sessionId)}`, {
         method: routes.sendPrompt.method,
         signal: AbortSignal.timeout(timeoutMs),
         headers: {
@@ -253,12 +270,38 @@ async function dispatchVoicePreview(preview) {
         error: payload.error ?? (!res.ok ? `HTTP ${res.status}` : undefined)
     };
 }
+async function createVoiceWorkspace(preview) {
+    // Creation runs behind the shared Conductor UI lease. The call already returned
+    // "queued", so keep enough room for one in-flight interactive action to finish
+    // before the deep link and its workspace-row receipt run.
+    const timeoutMs = 75_000;
+    const res = await fetch(`${voiceRelayOrigin()}${routes.createWorkspace.path()}`, {
+        method: routes.createWorkspace.method,
+        signal: AbortSignal.timeout(timeoutMs),
+        headers: {
+            authorization: `Bearer ${cfg.token}`,
+            'content-type': 'application/json',
+            'x-relay-client': 'voice',
+            'x-client-timeout-ms': String(timeoutMs)
+        },
+        body: JSON.stringify({ repo: preview.repo, prompt: preview.prompt, sendImmediately: true })
+    });
+    const payload = (await res.json().catch(() => ({})));
+    return {
+        ok: res.ok && payload.ok === true,
+        workspaceId: payload.workspaceId,
+        warning: payload.warning,
+        error: payload.error ?? (!res.ok ? `HTTP ${res.status}` : undefined)
+    };
+}
 function voiceToolsForCall(callId) {
     return createVoiceTools({
         callId,
         board: voiceBoard(callId),
         previews: voicePreviews,
         findSession: sessionId => reads.listSessionStates().find(state => state.sessionId === sessionId) ?? null,
+        listRepos: () => reads.listRepos().map(repo => ({ name: repo.name, defaultBranch: repo.default_branch })),
+        createWorkspace: createVoiceWorkspace,
         dispatch: dispatchVoicePreview,
         announce: spoken => {
             if (!voiceBroker?.inject(callId, spoken))

package/dist-node/src/voice/brief.js CHANGED Viewed

@@ -2,6 +2,7 @@ import { clipExact, oneLine, speechText } from "../speech.js";
 const DORMANT_MS = 7 * 24 * 60 * 60 * 1000;
 const DORMANT_LABELS = new Set(['backlog', 'done', 'canceled', 'cancelled']);
 const OVERVIEW_PAGE_SIZE = 3;
+const OVERVIEW_AGENT_STATUSES = new Set(['working', 'idle', 'error', 'needs-you']);
 function clean(text) {
     return text
         .replace(/[*_`#]+/g, '')
@@ -74,12 +75,102 @@ function parseDate(value) {
 function statusLabel(workspace) {
     return workspace.manual_status ?? workspace.derived_status;
 }
-function isDormant(state, workspace, now) {
+function normalizedStatus(value) {
+    return (value ?? '').trim().toLowerCase().replaceAll('_', '-').replaceAll(' ', '-');
+}
+function isDormant(state, workspace, now, options = {}) {
     if (state.status !== 'idle' && state.status)
         return false;
     const old = now - parseDate(state.updatedAt) > DORMANT_MS;
-    const labelled = DORMANT_LABELS.has((statusLabel(workspace) ?? '').toLowerCase());
-    return old || labelled;
+    const label = normalizedStatus(statusLabel(workspace));
+    const explicitlyIncluded = options.includedWorkspaceStatus === label || (options.includeDone && label === 'done');
+    const labelled = DORMANT_LABELS.has(label) && !explicitlyIncluded;
+    return (!options.ignoreAge && old) || labelled;
+}
+function isDone(workspace) {
+    return normalizedStatus(statusLabel(workspace)) === 'done';
+}
+function isMerged(workspace) {
+    return workspace.pr_status === 'merged';
+}
+function parseOverviewDate(value, now, field) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'today' ||
+        normalized === 'yesterday' ||
+        normalized === 'this-week' ||
+        normalized === 'this-month') {
+        const current = new Date(now);
+        const boundary = new Date(current.getFullYear(), current.getMonth(), current.getDate());
+        if (normalized === 'yesterday')
+            boundary.setDate(boundary.getDate() - 1);
+        if (normalized === 'this-week') {
+            const daysSinceMonday = (boundary.getDay() + 6) % 7;
+            boundary.setDate(boundary.getDate() - daysSinceMonday);
+        }
+        if (normalized === 'this-month')
+            boundary.setDate(1);
+        return boundary.getTime();
+    }
+    const relative = /^(\d+)(h|d|w)$/.exec(normalized);
+    if (relative) {
+        const amount = Number(relative[1]);
+        const unit = relative[2];
+        const multiplier = unit === 'h' ? 60 * 60 * 1000 : unit === 'd' ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;
+        if (amount > 0 && amount <= 10_000)
+            return now - amount * multiplier;
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(normalized)) {
+        const [year, month, day] = normalized.split('-').map(Number);
+        const date = new Date(year, month - 1, day);
+        if (date.getFullYear() === year && date.getMonth() === month - 1 && date.getDate() === day)
+            return date.getTime();
+    }
+    const parsed = Date.parse(value);
+    if (Number.isFinite(parsed))
+        return parsed;
+    throw new Error(`${field} must be today, yesterday, this-week, this-month, a duration like 24h or 7d, or an ISO date/time`);
+}
+function agentStatus(state) {
+    if (state.status === 'needs_user_input' || state.status === 'needs_plan_response')
+        return 'needs-you';
+    if (state.status === 'working' || state.status === 'error')
+        return state.status;
+    return 'idle';
+}
+function spokenUpdateAge(value, now) {
+    const at = parseDate(value);
+    if (!at)
+        return 'Update time unavailable.';
+    const elapsed = Math.max(0, now - at);
+    const minutes = Math.floor(elapsed / (60 * 1000));
+    if (minutes < 1)
+        return 'Updated just now.';
+    if (minutes < 60)
+        return `Updated ${minutes} minute${minutes === 1 ? '' : 's'} ago.`;
+    const hours = Math.floor(elapsed / (60 * 60 * 1000));
+    if (hours < 24)
+        return `Updated ${hours} hour${hours === 1 ? '' : 's'} ago.`;
+    const days = Math.floor(elapsed / (24 * 60 * 60 * 1000));
+    if (days === 1)
+        return 'Updated yesterday.';
+    if (days < 31)
+        return `Updated ${days} days ago.`;
+    const date = new Date(at);
+    const month = [
+        'January',
+        'February',
+        'March',
+        'April',
+        'May',
+        'June',
+        'July',
+        'August',
+        'September',
+        'October',
+        'November',
+        'December'
+    ][date.getUTCMonth()];
+    return `Updated on ${month} ${date.getUTCDate()}, ${date.getUTCFullYear()}.`;
 }
 function overviewRank(state) {
     if (state.status === 'error')
@@ -182,7 +273,22 @@ export class VoiceBriefBoard {
         return this.cached;
     }
     /** A deliberately uncached read: a new overview must not replay the call-opening tally. */
-    async workspaceOverview(cursor = 0) {
+    async workspaceOverview(cursor = 0, filters = {}) {
+        if (filters.agentStatus && !OVERVIEW_AGENT_STATUSES.has(filters.agentStatus))
+            throw new Error('agent_status must be working, idle, error, or needs-you');
+        const now = this.now();
+        const updatedSince = filters.updatedSince ? parseOverviewDate(filters.updatedSince, now, 'updated_since') : null;
+        const updatedBefore = filters.updatedBefore ? parseOverviewDate(filters.updatedBefore, now, 'updated_before') : null;
+        if (updatedSince !== null && updatedBefore !== null && updatedSince >= updatedBefore)
+            throw new Error('updated_since must be earlier than updated_before');
+        const wantedWorkspaceStatus = filters.workspaceStatus ? normalizedStatus(filters.workspaceStatus) : null;
+        const completedOnly = wantedWorkspaceStatus === 'done' || filters.prStatus === 'merged';
+        const includeDone = filters.includeDone === true || completedOnly;
+        const includeMerged = filters.includeMerged === true || completedOnly;
+        const ignoreDormantAge = updatedSince !== null ||
+            updatedBefore !== null ||
+            wantedWorkspaceStatus !== null ||
+            filters.prStatus !== undefined;
         const workspaces = new Map(this.deps.reads.listWorkspaces().map(workspace => [workspace.id, workspace]));
         const grouped = new Map();
         for (const state of this.deps.reads.listSessionStates()) {
@@ -193,20 +299,56 @@ export class VoiceBriefBoard {
             grouped.set(state.workspaceId, states);
         }
         let dormant = 0;
+        let completed = 0;
+        let filtered = 0;
         const items = [];
         for (const [workspaceId, workspace] of workspaces) {
-            const current = (grouped.get(workspaceId) ?? []).filter(state => !isDormant(state, workspace, this.now()));
-            if (!current.length) {
+            if (filters.repo && workspace.repo_name?.toLowerCase() !== filters.repo.toLowerCase()) {
+                filtered++;
+                continue;
+            }
+            if (wantedWorkspaceStatus && normalizedStatus(statusLabel(workspace)) !== wantedWorkspaceStatus) {
+                filtered++;
+                continue;
+            }
+            if (filters.prStatus && (workspace.pr_status ?? 'none') !== filters.prStatus) {
+                filtered++;
+                continue;
+            }
+            if ((!includeDone && isDone(workspace)) || (!includeMerged && isMerged(workspace))) {
+                completed++;
+                continue;
+            }
+            const live = (grouped.get(workspaceId) ?? []).filter(state => !isDormant(state, workspace, now, {
+                ignoreAge: ignoreDormantAge,
+                includeDone,
+                includedWorkspaceStatus: wantedWorkspaceStatus ?? undefined
+            }));
+            if (!live.length) {
                 dormant++;
                 continue;
             }
+            const current = live.filter(state => {
+                if (filters.agentStatus && agentStatus(state) !== filters.agentStatus)
+                    return false;
+                const at = parseDate(state.updatedAt);
+                if (updatedSince !== null && at < updatedSince)
+                    return false;
+                if (updatedBefore !== null && at >= updatedBefore)
+                    return false;
+                return true;
+            });
+            if (!current.length) {
+                filtered++;
+                continue;
+            }
             current.sort((a, b) => overviewRank(a) - overviewRank(b) || parseDate(b.updatedAt) - parseDate(a.updatedAt));
             const state = current[0];
             const said = this.deps.reads.lastAssistantText(state.sessionId) ?? '';
             items.push({
                 workspaceId,
                 sessionId: state.sessionId,
-                title: state.sessionTitle ? `${state.workspaceTitle}, ${state.sessionTitle}` : state.workspaceTitle,
+                title: oneLine(state.sessionTitle ? `${state.workspaceTitle}, ${state.sessionTitle}` : state.workspaceTitle, 100),
                 status: overviewStatus(state, workspace),
                 updatedAt: state.updatedAt,
                 update: oneLine(speechText(said, 150), 150),
@@ -219,13 +361,18 @@ export class VoiceBriefBoard {
         const page = rankedPage.map(({ rank: _rank, ...item }) => item);
         const next = offset + page.length < items.length ? offset + page.length : null;
         const noun = items.length === 1 ? 'workspace' : 'workspaces';
-        const lines = page.map(item => `${item.title} ${item.status}.${item.update ? ` ${item.update}` : ' No agent update yet.'}`);
+        const lines = page.map(item => `${item.title} ${item.status}. ${spokenUpdateAge(item.updatedAt, now)}${item.update ? ` ${item.update}` : ' No agent update yet.'}`);
         const more = next === null ? '' : ` ${items.length - next} more current; ask me to continue.`;
-        const none = items.length ? '' : ' Nothing is active right now.';
+        const none = items.length ? '' : filtered ? ' Nothing matches those filters.' : ' Nothing is active right now.';
+        const completedSummary = completed ? `, ${completed} completed hidden` : '';
+        const filteredSummary = filtered ? `, ${filtered} outside filters` : '';
         return {
-            spoken: clipExact(`Fresh overview: ${items.length} current ${noun}, ${dormant} dormant. ${lines.join(' ')}${more}${none}`.trim(), 700),
+            spoken: clipExact(`Fresh overview: ${items.length} current ${noun}${completedSummary}${filteredSummary}, ${dormant} dormant. ${lines.join(' ')}${more}${none}`.trim(), 700),
+            asOf: new Date(now).toISOString(),
             current: items.length,
             dormant,
+            completed,
+            filtered,
             cursor: next,
             workspaces: page
         };

package/dist-node/src/voice/preview.js CHANGED Viewed

@@ -16,7 +16,9 @@ export class PreviewStore {
             return this.previews;
         try {
             const parsed = JSON.parse(fs.readFileSync(this.file, 'utf8'));
-            this.previews = Array.isArray(parsed) ? parsed : [];
+            this.previews = Array.isArray(parsed)
+                ? parsed.map(preview => preview.kind ? preview : { ...preview, kind: 'send_prompt' })
+                : [];
         }
         catch {
             this.previews = [];
@@ -32,6 +34,7 @@ export class PreviewStore {
         const createdAt = this.now();
         const preview = {
             ...input,
+            kind: 'send_prompt',
             token: crypto.randomBytes(18).toString('base64url'),
             createdAt,
             expiresAt: createdAt + PREVIEW_TTL_MS,
@@ -44,7 +47,22 @@ export class PreviewStore {
         this.write();
         return preview;
     }
-    claim(token, input) {
+    createWorkspace(input) {
+        const createdAt = this.now();
+        const preview = {
+            ...input,
+            kind: 'create_workspace',
+            token: crypto.randomBytes(18).toString('base64url'),
+            createdAt,
+            expiresAt: createdAt + PREVIEW_TTL_MS,
+            status: 'ready'
+        };
+        this.previews = this.read().filter(candidate => candidate.expiresAt >= createdAt);
+        this.previews.push(preview);
+        this.write();
+        return preview;
+    }
+    available(token, callId) {
         const preview = this.read().find(candidate => candidate.token === token);
         if (!preview)
             return { ok: false, reason: 'unknown' };
@@ -52,16 +70,41 @@ export class PreviewStore {
             return { ok: false, reason: 'expired' };
         if (preview.status !== 'ready')
             return { ok: false, reason: 'already-used' };
-        if (preview.callId !== input.callId)
+        if (preview.callId !== callId)
             return { ok: false, reason: 'foreign-call' };
+        return { ok: true, preview };
+    }
+    markClaimed(preview) {
+        preview.status = 'claimed';
+        this.write();
+        return { ...preview };
+    }
+    claim(token, input) {
+        const found = this.available(token, input.callId);
+        if (!found.ok)
+            return found;
+        const preview = found.preview;
+        if (preview.kind !== 'send_prompt')
+            return { ok: false, reason: 'wrong-action' };
         if (preview.sessionId !== input.sessionId)
             return { ok: false, reason: 'foreign-session' };
         if (preview.text !== input.text)
             return { ok: false, reason: 'text-mismatch' };
         // Persist the claim before any caller starts an async UI delivery. A crash can lose a
         // send, but cannot replay one whose outcome became unknowable.
-        preview.status = 'claimed';
-        this.write();
-        return { ok: true, preview: { ...preview } };
+        return { ok: true, preview: this.markClaimed(preview) };
+    }
+    claimWorkspace(token, input) {
+        const found = this.available(token, input.callId);
+        if (!found.ok)
+            return found;
+        const preview = found.preview;
+        if (preview.kind !== 'create_workspace')
+            return { ok: false, reason: 'wrong-action' };
+        if (preview.repo !== input.repo)
+            return { ok: false, reason: 'foreign-repo' };
+        if (preview.prompt !== input.prompt)
+            return { ok: false, reason: 'prompt-mismatch' };
+        return { ok: true, preview: this.markClaimed(preview) };
     }
 }

package/dist-node/src/voice/prompt.js CHANGED Viewed

@@ -3,7 +3,9 @@ export const VOICE_INSTRUCTIONS = `You are a voice switchboard for the user's Co
 Start with voice_roll_call. Work through one decision at a time with voice_next_decision. Speak only the tool result's spoken field; never read ids, cursors, JSON keys, or tokens aloud. Keep replies short enough for someone walking.
-Every time the user asks for a workspace overview, status, progress, or what is happening across the fleet, call voice_workspace_overview starting at cursor zero. This is a fresh read, so never answer that request from the opening roll call or an earlier overview. If they ask to continue, pass the cursor returned by the prior overview.
+Every time the user asks for a workspace overview, status, progress, or what is happening across the fleet, call voice_workspace_overview starting at cursor zero. This is a fresh read, so never answer from the opening roll call or an earlier overview. Merged and Done workspaces are hidden by default; include either only when the user asks for completed work or explicitly names that state. Translate time requests into updated_since or updated_before, and use repo, agent_status, workspace_status, or pr_status when requested. If they ask to continue, pass the prior cursor and the same filters.
+When the user wants a new workspace, call voice_list_repos to resolve its exact repository, then voice_create_workspace_preview with the exact first prompt. Read the exact repository and prompt back and ask for yes. Only after yes, call voice_create_workspace with the returned token and unchanged repository and prompt. Creation runs asynchronously and its result will be announced.
 When the user wants to dispatch text, call voice_send_preview with the exact target and text. Read the exact preview back, including the target, and ask for an explicit yes. Only after yes, call voice_send with the returned token and exactly the same session and text. Never call voice_send without that confirmation. A send queues asynchronously; success is silent, while parked or failed delivery will be announced.

package/dist-node/src/voice/tools.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { oneLine } from "../speech.js";
+import { clipExact, oneLine } from "../speech.js";
 /**
  * One definition table feeds both transports: SIP exposes it through the scoped
  * MCP server, while the PWA's private sideband exposes the same entries as
@@ -9,6 +9,9 @@ export const VOICE_TOOL_NAMES = [
     'voice_roll_call',
     'voice_workspace_overview',
     'voice_next_decision',
+    'voice_list_repos',
+    'voice_create_workspace_preview',
+    'voice_create_workspace',
     'voice_send_preview',
     'voice_send'
 ];
@@ -20,11 +23,37 @@ export const VOICE_TOOL_DEFINITIONS = [
     },
     {
         name: 'voice_workspace_overview',
-        description: 'Get a fresh overview of current workspaces with each latest agent update. Call this every time the user asks for an overview or workspace status, even if one was already given. Pass the returned cursor to continue.',
+        description: 'Get a fresh, dated overview of current workspaces with filters and the relay as-of time. Merged and Done workspaces are excluded unless explicitly included. Call this every time the user asks for an overview or workspace status, even if one was already given. Pass the same filters with the returned cursor to continue.',
         inputSchema: {
             type: 'object',
             properties: {
-                cursor: { type: 'number', description: 'The cursor returned by the previous overview page; default 0.' }
+                cursor: { type: 'number', description: 'The cursor returned by the previous overview page; default 0.' },
+                repo: { type: 'string', description: 'Only this exact repository name.' },
+                agent_status: {
+                    type: 'string',
+                    enum: ['working', 'idle', 'error', 'needs-you'],
+                    description: 'Only workspaces whose matching chat has this live agent status.'
+                },
+                workspace_status: {
+                    type: 'string',
+                    enum: ['backlog', 'in-progress', 'in-review', 'done', 'canceled'],
+                    description: 'Only workspaces in this Conductor sidebar status. Requesting done includes Done workspaces.'
+                },
+                pr_status: {
+                    type: 'string',
+                    enum: ['merged', 'draft', 'conflicts', 'checks_failed', 'checks_pending', 'mergeable', 'none'],
+                    description: 'Only workspaces with this pull-request status. Requesting merged includes merged workspaces.'
+                },
+                updated_since: {
+                    type: 'string',
+                    description: 'Only chat activity since today, yesterday, this-week, this-month, a relative duration like 24h or 7d, or an ISO date/time.'
+                },
+                updated_before: {
+                    type: 'string',
+                    description: 'Only chat activity before this exclusive named boundary, relative duration, ISO date/time, or date. For yesterday alone, use updated_since yesterday and updated_before today.'
+                },
+                include_done: { type: 'boolean', description: 'Include Done workspaces; default false.' },
+                include_merged: { type: 'boolean', description: 'Include merged workspaces; default false.' }
             }
         }
     },
@@ -42,6 +71,36 @@ export const VOICE_TOOL_DEFINITIONS = [
             }
         }
     },
+    {
+        name: 'voice_list_repos',
+        description: 'List the repositories where Conductor can create a workspace. Use before a creation preview.',
+        inputSchema: { type: 'object', properties: {} }
+    },
+    {
+        name: 'voice_create_workspace_preview',
+        description: 'Create a two-minute preview for a new workspace in an exact repository, with an optional first prompt. Speak its exact target and prompt and ask for yes before using voice_create_workspace.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: { type: 'string', description: 'Exact repository name from voice_list_repos.' },
+                prompt: { type: 'string', description: 'Optional first prompt. Omit to create an empty workspace.' }
+            },
+            required: ['repo']
+        }
+    },
+    {
+        name: 'voice_create_workspace',
+        description: 'Create an exact workspace preview after the user said yes. Requires its token, repository, and unchanged prompt; never accepts raw unpreviewed creation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                token: { type: 'string' },
+                repo: { type: 'string' },
+                prompt: { type: 'string', description: 'The unchanged preview prompt; omit only when the preview was empty.' }
+            },
+            required: ['token', 'repo']
+        }
+    },
     {
         name: 'voice_send_preview',
         description: 'Create a two-minute exact-text send preview. Speak its exact target and text and ask for yes before using voice_send.',
@@ -84,23 +143,33 @@ function need(args, key) {
         throw new Error(`${key} is required`);
     return value.trim();
 }
+function optional(args, key) {
+    const value = args[key];
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
 function answer(value) {
     return JSON.stringify(value);
 }
 function refusal(reason) {
     switch (reason) {
         case 'expired':
-            return 'That preview expired. Read the exact target and text back again before sending.';
+            return 'That preview expired. Read the exact action back again before approving it.';
         case 'foreign-call':
             return 'That preview belongs to another call and cannot be used here.';
         case 'foreign-session':
             return 'That preview belongs to a different chat. Preview this target again.';
+        case 'foreign-repo':
+            return 'That preview belongs to a different repository. Preview this workspace again.';
         case 'text-mismatch':
             return 'The send text does not exactly match the preview. Preview the changed text first.';
+        case 'prompt-mismatch':
+            return 'The first prompt does not exactly match the preview. Preview the changed workspace first.';
+        case 'wrong-action':
+            return 'That preview is for a different action. Make a new preview first.';
         case 'already-used':
-            return 'That preview was already used. The relay will not send it twice.';
+            return 'That preview was already used. The relay will not run it twice.';
         case 'unknown':
-            return 'That preview token is unknown. Make a new preview before sending.';
+            return 'That preview token is unknown. Make a new preview before continuing.';
     }
 }
 function later(task) {
@@ -123,7 +192,30 @@ export function createVoiceTools(context) {
             ...definition('voice_workspace_overview'),
             run: async (args) => {
                 const cursor = typeof args.cursor === 'number' && Number.isFinite(args.cursor) ? args.cursor : 0;
-                return answer(await context.board.workspaceOverview(cursor));
+                const filters = {};
+                const repo = optional(args, 'repo');
+                const agentStatus = optional(args, 'agent_status');
+                const workspaceStatus = optional(args, 'workspace_status');
+                const prStatus = optional(args, 'pr_status');
+                const updatedSince = optional(args, 'updated_since');
+                const updatedBefore = optional(args, 'updated_before');
+                if (repo)
+                    filters.repo = repo;
+                if (agentStatus)
+                    filters.agentStatus = agentStatus;
+                if (workspaceStatus)
+                    filters.workspaceStatus = workspaceStatus;
+                if (prStatus)
+                    filters.prStatus = prStatus;
+                if (updatedSince)
+                    filters.updatedSince = updatedSince;
+                if (updatedBefore)
+                    filters.updatedBefore = updatedBefore;
+                if (typeof args.include_done === 'boolean')
+                    filters.includeDone = args.include_done;
+                if (typeof args.include_merged === 'boolean')
+                    filters.includeMerged = args.include_merged;
+                return answer(await context.board.workspaceOverview(cursor, filters));
             }
         },
         {
@@ -136,6 +228,71 @@ export function createVoiceTools(context) {
                 return answer(next ?? { spoken: 'There are no more decisions in this call.', cursor, done: true });
             }
         },
+        {
+            ...definition('voice_list_repos'),
+            run: async () => {
+                const repos = context.listRepos();
+                return answer({
+                    spoken: repos.length
+                        ? clipExact(`Available repositories: ${repos.map(repo => repo.name).join(', ')}.`, 600)
+                        : 'Conductor has no repository available for a new workspace.',
+                    repos
+                });
+            }
+        },
+        {
+            ...definition('voice_create_workspace_preview'),
+            run: async (args) => {
+                const requestedRepo = need(args, 'repo');
+                const repo = context.listRepos().find(candidate => candidate.name.toLowerCase() === requestedRepo.toLowerCase());
+                if (!repo)
+                    return answer({
+                        status: 'refused',
+                        spoken: `I could not find the ${oneLine(requestedRepo, 80)} repository. Ask me to list repositories first.`
+                    });
+                const prompt = optional(args, 'prompt') ?? '';
+                const preview = context.previews.createWorkspace({ callId: context.callId, repo: repo.name, prompt });
+                const detail = prompt ? ` with this first prompt: “${oneLine(prompt, 220)}”` : ' with no first prompt.';
+                return answer({
+                    status: 'preview',
+                    token: preview.token,
+                    repo: repo.name,
+                    prompt,
+                    spoken: `Create a new workspace in ${oneLine(repo.name, 80)}${detail} Say yes to create it.`
+                });
+            }
+        },
+        {
+            ...definition('voice_create_workspace'),
+            run: async (args) => {
+                const token = need(args, 'token');
+                const repo = need(args, 'repo');
+                const prompt = optional(args, 'prompt') ?? '';
+                const claimed = context.previews.claimWorkspace(token, { callId: context.callId, repo, prompt });
+                if (!claimed.ok)
+                    return answer({ status: 'refused', spoken: refusal(claimed.reason) });
+                later(async () => {
+                    try {
+                        const result = await context.createWorkspace(claimed.preview);
+                        if (!result.ok) {
+                            await context.announce(`The new ${oneLine(repo, 80)} workspace was not created. ${oneLine(result.error ?? 'Try again later.', 220)}`);
+                            return;
+                        }
+                        const created = prompt
+                            ? `Created a new ${oneLine(repo, 80)} workspace and queued its first prompt.`
+                            : `Created a new empty ${oneLine(repo, 80)} workspace.`;
+                        await context.announce(result.warning ? `${created} ${oneLine(result.warning, 220)}` : created);
+                    }
+                    catch (error) {
+                        await context.announce(`The new ${oneLine(repo, 80)} workspace was not created. ${oneLine(error instanceof Error ? error.message : String(error), 220)}`);
+                    }
+                });
+                return answer({
+                    status: 'queued',
+                    spoken: `Creating a new workspace in ${oneLine(repo, 80)}. I will say when it is ready.`
+                });
+            }
+        },
         {
             ...definition('voice_send_preview'),
             run: async (args) => {