conductor-remote 1.109.0 → 1.111.0

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

@@ -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) => {

package/docs/voice-setup.md

@@ -5,19 +5,28 @@
 The primary foreground voice mode is one fleet-wide control room. In the
 workspace-list header, tap the phone immediately left of **+**, then start the
 call. The orchestrator surveys every workspace, presents one bounded decision
-at a time, and can queue an exact prompt only after it reads the target and text
-back and you confirm. It is not owned by the chat currently on screen: hide the
-sheet or move between workspaces and the same call continues.
+at a time, creates new workspaces, and queues exact prompts. Both writes happen
+only after it reads the target and text back and you confirm. It is not owned by
+the chat currently on screen: hide the sheet or move between workspaces and the
+same call continues.
 
 Live captions keep both sides readable, and the text box in the call sheet is a
-fallback when speaking is inconvenient. The five available actions are roll
-call, fresh workspace overview, next decision, send preview, and confirmed send.
-They use the same preview/confirmation gate as the dial-in orchestrator.
+fallback when speaking is inconvenient. The eight available actions are roll
+call, fresh workspace overview, next decision, repository list, workspace-create
+preview and confirmed creation, plus send preview and confirmed send. The two
+writes use the same persisted, one-use preview/confirmation gate as the dial-in
+orchestrator.
+
+An ordinary overview excludes workspaces marked **Done** or whose pull request
+is merged. Ask to include either when completed work is relevant. Overview
+requests can also filter by repository, live agent status, workspace status, PR
+status, and an `updated_since`/`updated_before` time window; each spoken row says
+how recently its selected chat changed.
 
 This path needs the managed relay, its usual private phone URL, and an OpenAI API
 key. It does **not** need a phone number, SIP, a webhook, Funnel, or any other
 public endpoint. The permanent key stays on the Mac: the relay creates the
-WebRTC call, then executes those five tools over its private sideband connection.
+WebRTC call, then executes those eight tools over its private sideband connection.
 
 Store the key without leaving it in shell history:
 
@@ -46,9 +55,12 @@ screen locked, so use the optional dial-in transport for a pocketed commute.
 
 ## Optional dial-in orchestrator
 
-The optional voice listener turns a phone call into a small Conductor control room: hear a bounded fleet tally, walk one decision at a time, and dispatch an exact prompt after a spoken read-back and explicit confirmation. It does not expose the PWA or the relay API publicly.
+The optional voice listener turns a phone call into a small Conductor control room: hear a bounded fleet tally, walk one decision at a time, create a workspace, and dispatch an exact prompt after a spoken read-back and explicit confirmation. It does not expose the PWA or the relay API publicly.
 
-This first milestone has five tools: roll call, a fresh paged workspace overview, next decision, send preview, and send. Forward-to-owner answers, redial cursor resume, artifact pushes, and voice grooming remain later milestones.
+The scoped endpoint has eight tools: roll call, a fresh paged workspace overview,
+next decision, repository list, create preview, confirmed create, send preview,
+and confirmed send. Forward-to-owner answers, artifact pushes, and voice grooming
+remain later milestones.
 
 ## What you need
 
@@ -142,7 +154,7 @@ conductor-remote config set voice.webhook-secret "$OPENAI_WEBHOOK_SECRET"
 unset OPENAI_WEBHOOK_SECRET
 ```
 
-The relay accepts a valid incoming call through `POST /v1/realtime/calls/{call_id}/accept`, attaches an authenticated sideband WebSocket, and gives the session only the five scoped remote MCP tools. Remote MCP follow-up responses are driven by the broker only after both the response and every tool call in it have finished, as required by OpenAI's [Realtime MCP guide](https://developers.openai.com/api/docs/guides/realtime-mcp).
+The relay accepts a valid incoming call through `POST /v1/realtime/calls/{call_id}/accept`, attaches an authenticated sideband WebSocket, and gives the session only the eight scoped remote MCP tools. Remote MCP follow-up responses are driven by the broker only after both the response and every tool call in it have finished, as required by OpenAI's [Realtime MCP guide](https://developers.openai.com/api/docs/guides/realtime-mcp).
 
 ## 5. Configure the Twilio number
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "conductor-remote",
-	"version": "1.109.0",
+	"version": "1.111.0",
 	"type": "module",
 	"packageManager": "yarn@4.15.0",
 	"description": "Phone control panel for local Conductor agents. Reads ride SQLite + git; prompts ride Conductor's own dispatch path.",