drafted 1.11.31 → 1.11.33

package/cli/drafted.mjs

@@ -2014,6 +2014,43 @@ collectorCmd
   .option('--format <fmt>', 'output format: json or text', 'text')
   .action((id, opts) => collectorSetEnabled(id, false, opts.format));
 
+async function collectorTestPost(id, path, body, format) {
+  requireLogin();
+  const server = getServerUrl().replace(/\/$/, '');
+  const res = await authFetch(`${server}/api/collectors/${encodeURIComponent(id)}/${path}`, {
+    method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body || {}),
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    if (format === 'json') console.log(JSON.stringify({ status: res.status === 404 ? 'not-found' : 'error', error: data.error || `HTTP ${res.status}` }));
+    else console.log(['error', data.error || `HTTP ${res.status}`].join('\t'));
+    process.exit(1);
+  }
+  console.log(JSON.stringify(data));
+}
+
+collectorCmd
+  .command('test-start <id>')
+  .description('QA: start (or resume) a test run of a collector you own — works even when disabled. --fresh for a new run.')
+  .option('--fresh', 'start a brand-new run instead of resuming', false)
+  .option('--format <fmt>', 'output format: json (default)', 'json')
+  .action((id, opts) => collectorTestPost(id, 'test-start', { fresh: !!opts.fresh }, opts.format));
+
+collectorCmd
+  .command('test-say <id>')
+  .description('QA: send a text answer to your test run; returns the agent reply, checklist state, pending actions.')
+  .requiredOption('--text <text>', 'the consumer message to send')
+  .option('--format <fmt>', 'output format: json (default)', 'json')
+  .action((id, opts) => collectorTestPost(id, 'test-message', { content: opts.text }, opts.format));
+
+collectorCmd
+  .command('test-resolve <id>')
+  .description('QA: approve or reject a pending destructive action in your test run.')
+  .requiredOption('--action <actionId>', 'the pending action id')
+  .option('--reject', 'reject instead of approve', false)
+  .option('--format <fmt>', 'output format: json (default)', 'json')
+  .action((id, opts) => collectorTestPost(id, 'test-resolve', { actionId: opts.action, approve: !opts.reject }, opts.format));
+
 collectorCmd
   .command('delete <id>')
   .description('Delete a collector (past submissions are kept as history)')

package/install-mcp.sh

@@ -664,14 +664,12 @@ install_desktop_app() {
   <string>live.drafted.desktop</string>
   <key>ProgramArguments</key>
   <array>
-    <string>open</string>
-    <string>-a</string>
-    <string>$app_bundle</string>
+    <string>$app_exe</string>
   </array>
   <key>RunAtLoad</key>
   <true/>
   <key>KeepAlive</key>
-  <false/>
+  <true/>
 </dict>
 </plist>
 PLIST

package/mcp/server.mjs

@@ -249,7 +249,7 @@ const TOOL_ANNOTATIONS = {
   wiki:                { title: 'Wiki',                readOnlyHint: false, destructiveHint: true,  openWorldHint: false, description: 'Per-org wiki. Markdown pages with paths as hierarchy. Dispatch by `action`.' },
 
   // Collectors — checklist-driven, Minion-run intake surfaces bound to a project
-  collector:           { title: 'Collectors',          readOnlyHint: false, destructiveHint: true,  openWorldHint: false, description: 'Manage Collectors: checklist-driven intake surfaces that guide a consumer through a checklist (via a shareable /c/<slug> link) and then write a producible into the project. Dispatch by `action`: meta (discover layers/lanes/frames), list, get, create, update, enable, disable, delete. Requires the agent allowlist (same gate as Minion).' },
+  collector:           { title: 'Collectors',          readOnlyHint: false, destructiveHint: true,  openWorldHint: false, description: 'Manage Collectors: checklist-driven intake surfaces that guide a consumer through a checklist (via a shareable /c/<slug> link) and then write a producible into the project. Dispatch by `action`: meta (discover layers/lanes/frames), list, get, create, update, enable, disable, delete. QA your own collectors with test_start/test_say/test_resolve — drive the checklist conversation yourself (works even when disabled) and verify it produces the right Doc/Sheet output. Requires the agent allowlist (same gate as Minion).' },
 };
 
 function isMutatingToolCall(name, args = {}) {
@@ -276,7 +276,7 @@ function isMutatingToolCall(name, args = {}) {
     case 'wiki':
       return ['log', 'write', 'edit', 'mv', 'rm', 'source-register', 'bulk-write'].includes(action);
     case 'collector':
-      return ['create', 'update', 'enable', 'disable', 'delete'].includes(action);
+      return ['create', 'update', 'enable', 'disable', 'delete', 'test_start', 'test_say', 'test_resolve'].includes(action);
     case 'rm':
     case 'shape':
     case 'group':
@@ -709,8 +709,14 @@ function schedulePendingAuthPoll(delayMs = 2000) {
 // session before any operation runs.
 function getAuthHeaders() {
   const sid = getState().sessionId;
-  if (sid) return { Cookie: `gc_session=${sid}` };
-  return {};
+  const headers = {};
+  if (sid) headers.Cookie = `gc_session=${sid}`;
+  // Stable human name for this agent (DRAFTED_AGENT_NAME), so the server names this
+  // session's surface tab by the AGENT, not the project — lets the user tell concurrent
+  // agents apart even in the same project.
+  const agentName = (process.env.DRAFTED_AGENT_NAME || '').trim();
+  if (agentName) headers['X-Drafted-Agent'] = agentName;
+  return headers;
 }
 
 // Mint a fresh per-instance child session from the shared root login and bind it
@@ -724,9 +730,15 @@ async function cloneSession() {
   if (!bootstrapId) return false;
 
   try {
+    // A named agent (DRAFTED_AGENT_NAME) gets a STABLE child session: the server
+    // returns the same session for the same (user, agentKey) across reconnects, so a
+    // restarted agent reconnects its existing named session instead of churning a new
+    // one. Anonymous clients send no key and keep a fresh-per-process session.
+    const agentKey = (process.env.DRAFTED_AGENT_NAME || '').trim();
     const res = await fetch(`${getServerUrl()}/auth/session/clone`, {
       method: 'POST',
-      headers: { Cookie: `gc_session=${bootstrapId}` },
+      headers: { 'Content-Type': 'application/json', Cookie: `gc_session=${bootstrapId}` },
+      body: JSON.stringify({ agentKey }),
     });
     if (res.ok) {
       const data = await res.json();
@@ -1033,6 +1045,9 @@ async function connectAgentWs() {
 
   agentWs.on('open', () => {
     console.error('[MCP-WS] Connected');
+    // Announce presence immediately so the agent surfaces (greyed/idle, no project) the
+    // moment it connects — before opening any project. Project work later flips it active.
+    try { agentWs.send(JSON.stringify({ type: 'agent-hello', agentLabel: getAgentLabel() })); } catch {}
     if (getState().projectId) {
       agentWs.send(JSON.stringify({ type: 'join', projectId: getState().projectId, agent: true, agentLabel: getAgentLabel() }));
     }
@@ -3651,8 +3666,12 @@ function collectorGateError(e) {
 }
 
 tool('collector', {
-  action: z.enum(['meta', 'list', 'get', 'create', 'update', 'enable', 'disable', 'delete']).describe('Operation to perform.'),
-  id: z.string().optional().describe('[get|update|enable|disable|delete] collector ID (UUID)'),
+  action: z.enum(['meta', 'list', 'get', 'create', 'update', 'enable', 'disable', 'delete', 'test_start', 'test_say', 'test_resolve']).describe('Operation to perform. test_* drive a QA conversation against a collector you own (even disabled) to verify it end-to-end.'),
+  id: z.string().optional().describe('[get|update|enable|disable|delete|test_*] collector ID (UUID)'),
+  text: z.string().optional().describe('[test_say] the consumer message to send to your test run'),
+  fresh: z.boolean().optional().describe('[test_start] start a brand-new run instead of resuming your latest'),
+  actionId: z.string().optional().describe('[test_resolve] id of the pending action to resolve'),
+  approve: z.boolean().optional().describe('[test_resolve] approve (default true) or reject the pending action'),
   projectId: z.string().optional().describe('[create|meta] project to bind/scope to (defaults to the active project). Operates on the session’s active org — open the target project first via project(action="open"), or get_org(action="switch") to change org.'),
   name: z.string().optional().describe('[create|update] collector name'),
   description: z.string().optional().describe('[create|update] one-line description shown to the consumer'),
@@ -3676,6 +3695,11 @@ tool('collector', {
     filenameTemplate: z.string().optional().describe('e.g. "<id>.md"'),
     skillSlug: z.string().optional().describe('skill that shapes the produced frame'),
     grouping: z.string().optional().describe('"lane" gives each submission its own lane'),
+    format: z.enum(['markdown', 'google-doc', 'google-sheet', 'google-slide']).optional().describe('primary producible format; google-* require the org Drive connected (default markdown)'),
+    register: z.object({
+      sheet: z.string().describe('existing Google Sheet frame path or id to append rows to'),
+      columns: z.array(z.string()).optional().describe('columns in order; a link to the produced record is included'),
+    }).optional().describe('also append one row per submission to an existing sheet, linking the produced record'),
   }).optional().describe('[create|update] where/how the producible lands'),
   limit: z.number().optional().describe('[list] max results per page (default 25, max 100)'),
   offset: z.number().optional().describe('[list] skip N results for pagination (default 0)'),
@@ -3733,6 +3757,20 @@ tool('collector', {
         if (!args.id) throw new Error('id is required for action=delete');
         return ok(await api('DELETE', `/api/collectors/${args.id}`));
       }
+      case 'test_start': {
+        if (!args.id) throw new Error('id is required for action=test_start');
+        return ok(await api('POST', `/api/collectors/${args.id}/test-start`, { fresh: !!args.fresh }));
+      }
+      case 'test_say': {
+        if (!args.id) throw new Error('id is required for action=test_say');
+        if (!args.text) throw new Error('text is required for action=test_say');
+        return ok(await api('POST', `/api/collectors/${args.id}/test-message`, { content: args.text }));
+      }
+      case 'test_resolve': {
+        if (!args.id) throw new Error('id is required for action=test_resolve');
+        if (!args.actionId) throw new Error('actionId is required for action=test_resolve');
+        return ok(await api('POST', `/api/collectors/${args.id}/test-resolve`, { actionId: args.actionId, approve: args.approve !== false }));
+      }
       default:
         throw new Error(`Unknown collector action: ${action}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.11.31",
+  "version": "1.11.33",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [