overlord-cli 0.2606060757.0 → 0.2606070914.0

package/bin/_cli/protocol.mjs

@@ -2242,6 +2242,24 @@ async function protocolListExecutionRequests(args) {
   console.log(JSON.stringify(data, null, 2));
 }
 
+async function protocolListExecutionTargets(args) {
+  const flags = parseFlags(args);
+  const { platformUrl, bearerToken, localSecret, organizationId } =
+    await resolveProtocolAuthForFlags(flags);
+  const timeoutMs = resolveTimeout(flags);
+
+  const data = await apiPost(
+    platformUrl,
+    bearerToken,
+    localSecret,
+    organizationId,
+    '/api/protocol/list-execution-targets',
+    {},
+    timeoutMs
+  );
+  console.log(JSON.stringify(data, null, 2));
+}
+
 async function protocolClearExecutionRequests(args) {
   const flags = parseFlags(args);
   const { platformUrl, bearerToken, localSecret, organizationId } =
@@ -2471,6 +2489,7 @@ async function protocolPrompt(args) {
     ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
     ...(forHuman !== undefined ? { forHuman } : {}),
     delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier),
+    ...(flags['assigned-to'] ? { assignedTo: String(flags['assigned-to']) } : {}),
     ...(flags['parent-session-key']
       ? { parentSessionKey: String(flags['parent-session-key']) }
       : {}),
@@ -2559,7 +2578,8 @@ async function protocolCreateTicket(args) {
         : {}),
       ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
       ...(forHuman !== undefined ? { forHuman } : {}),
-      delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier)
+      delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier),
+      ...(flags['assigned-to'] ? { assignedTo: String(flags['assigned-to']) } : {})
     };
 
     const data = await apiPost(
@@ -2599,7 +2619,8 @@ async function protocolCreateTicket(args) {
       : {}),
     ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
     ...(forHuman !== undefined ? { forHuman } : {}),
-    delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier)
+    delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier),
+    ...(flags['assigned-to'] ? { assignedTo: String(flags['assigned-to']) } : {})
   };
 
   const data = await apiPost(
@@ -2694,7 +2715,8 @@ async function protocolRecordWork(args) {
       ? { acceptanceCriteria: String(flags['acceptance-criteria']) }
       : {}),
     ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
-    delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier)
+    delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier),
+    ...(flags['assigned-to'] ? { assignedTo: String(flags['assigned-to']) } : {})
   };
 
   const { platformUrl, bearerToken, localSecret, organizationId } =
@@ -2867,6 +2889,7 @@ Subcommands:
   claim-execution           Claim one queued execution request for this device
   list-organizations        List organizations the authenticated user belongs to
   list-execution-requests   List active execution requests in the runner queue
+  list-execution-targets    List execution targets (runner devices) the user has access to
   clear-execution-requests  Clear active execution requests by objective or wholesale
   complete-execution-launch Mark a claimed execution request launched
   fail-execution-launch     Mark a claimed execution request failed
@@ -3145,6 +3168,7 @@ prompt:
     --for-human               Mark the new ticket as requiring a human
     --execution-target <t>    Deprecated alias: agent | human
     --delegate <model>        Model or delegate identifier that created the ticket
+    --assigned-to <member>    Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator)
     --parent-session-key <key>
     --parent-ticket-id <ticket_id>
     --agent <identifier>
@@ -3185,6 +3209,7 @@ create:
     --for-human               Mark the new ticket as requiring a human
     --execution-target <t>    Deprecated alias: agent | human
     --delegate <model>        Model or delegate identifier that created the ticket
+    --assigned-to <member>    Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator)
     --agent <identifier>
     --model <identifier>
   Returns:
@@ -3233,6 +3258,7 @@ record-work:
     --acceptance-criteria <text>
     --available-tools <text>
     --delegate <model>
+    --assigned-to <member>    Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator)
     --agent <identifier>
     --model <identifier>
   Notes:
@@ -3398,6 +3424,13 @@ list-execution-requests:
     --device-fingerprint <fp>  Filter queue visibility to one execution target
     --project-id <uuid>        Restrict to one project
 
+list-execution-targets:
+  Purpose:
+    List all execution targets (runner devices) accessible to the authenticated user
+    in the current organization, including their label and id.
+  Returns:
+    JSON with { targets: [ { id, label, host, platform, transport, is_placeholder, last_seen_at } ] }
+
 clear-execution-requests:
   Purpose:
     Clear active execution requests from the runner queue by marking them failed.
@@ -3456,6 +3489,7 @@ Examples:
   ovld protocol claim-execution --device-fingerprint $OVERLORD_DEVICE_FINGERPRINT
   ovld protocol list-organizations
   ovld protocol list-execution-requests --device-fingerprint $OVERLORD_DEVICE_FINGERPRINT
+  ovld protocol list-execution-targets
   ovld protocol clear-execution-requests --objective-id <objective-uuid>
   ovld protocol clear-execution-requests --clear-all
   ovld protocol deliver --session-key <key> --ticket-id <ticket_id> --summary "Done"
@@ -3587,6 +3621,10 @@ EOF
     await protocolListExecutionRequests(args);
     return;
   }
+  if (subcommand === 'list-execution-targets') {
+    await protocolListExecutionTargets(args);
+    return;
+  }
   if (subcommand === 'clear-execution-requests') {
     await protocolClearExecutionRequests(args);
     return;

package/bin/_cli/runner.mjs

@@ -22,6 +22,7 @@ function printRunnerHelp(primaryCommand = 'ovld') {
   ${primaryCommand} runner once [options]
   ${primaryCommand} runner start [options]
   ${primaryCommand} runner status [options]
+  ${primaryCommand} runner targets [options]
   ${primaryCommand} runner clear <objective_id> [options]
   ${primaryCommand} runner clear-all [options]
 
@@ -147,6 +148,12 @@ function clearExecutionRequests(flags, deviceFingerprint, organizationId, option
   });
 }
 
+function listExecutionTargets(deviceFingerprint) {
+  return protocolJson('list-execution-targets', [], {
+    OVERLORD_DEVICE_FINGERPRINT: deviceFingerprint
+  });
+}
+
 function listOrganizationIds(deviceFingerprint) {
   const data = protocolJson('list-organizations', [], {
     OVERLORD_DEVICE_FINGERPRINT: deviceFingerprint
@@ -583,6 +590,12 @@ export async function runRunnerCommand(subcommand, args, primaryCommand = 'ovld'
   const flags = parseFlags(args);
   const deviceFingerprint = readOrCreateDeviceFingerprint(flags);
 
+  if (subcommand === 'targets') {
+    const data = listExecutionTargets(deviceFingerprint);
+    console.log(JSON.stringify({ ok: true, targets: data.targets ?? [] }, null, 2));
+    return;
+  }
+
   if (subcommand === 'status') {
     const organizationScope = createOrganizationScope(flags, deviceFingerprint);
     const data = protocolJson(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "0.2606060757.0",
+  "version": "0.2606070914.0",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "homepage": "https://www.ovld.ai/docs/",
   "type": "module",

package/plugins/claude/commands/create.md

@@ -8,7 +8,7 @@ Create a draft Overlord ticket from the user's request.
 
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol create --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, `--assigned-to`, or `--for-human`, pass those flags through after `ovld protocol create --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol create --agent claude-code --objective "<objective>"`
 

package/plugins/claude/commands/prompt.md

@@ -8,7 +8,7 @@ Create a new Overlord ticket from the user's request.
 
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, `--assigned-to`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol prompt --agent claude-code --objective "<objective>"`
 

package/plugins/claude/commands/spawn.md

@@ -9,7 +9,7 @@ This command is deprecated. Use `/overlord:prompt` instead.
 Create a new Overlord ticket from the user's request.
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, `--assigned-to`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol prompt --agent claude-code --objective "<objective>"`
 

package/plugins/claude/skills/overlord-ticket/reference/cli.md

@@ -118,6 +118,7 @@ When creating tickets from within a repository:
 - Create multiple tickets when each prompt represents a different feature or goal.
 - Add objectives to the same ticket when each prompt is a sequential step toward the same feature or goal; use `ovld protocol add-objectives --ticket-id <ticket_id> --objectives-json '[{"objective":"..."}]'`.
 - `create`, `prompt`, and `record-work` require `--objectives-json` or `--objectives-file` with an ordered array of `{ "objective": "...", "title": "...", "autoAdvance": true }` objects. A single objective is just an array with one item.
+- `create`, `prompt`, `create-ticket`, and `record-work` accept `--assigned-to <member>` to set the ticket's human owner. Accepts a username, an email, a user-id UUID, or the `orgid:username` member ID. When omitted, the assignee defaults to the ticket creator.
 
 ```bash
 ovld protocol create --agent claude-code --objectives-json '[{"objective":"Capture follow-up work from this repository"}]'

package/plugins/cursor/skills/overlord-ticket/reference/cli.md

@@ -118,6 +118,7 @@ When creating tickets from within a repository:
 - Create multiple tickets when each prompt represents a different feature or goal.
 - Add objectives to the same ticket when each prompt is a sequential step toward the same feature or goal; use `ovld protocol add-objectives --ticket-id <ticket_id> --objectives-json '[{"objective":"..."}]'`.
 - `create`, `prompt`, and `record-work` require `--objectives-json` or `--objectives-file` with an ordered array of `{ "objective": "...", "title": "...", "autoAdvance": true }` objects. A single objective is just an array with one item.
+- `create`, `prompt`, `create-ticket`, and `record-work` accept `--assigned-to <member>` to set the ticket's human owner. Accepts a username, an email, a user-id UUID, or the `orgid:username` member ID. When omitted, the assignee defaults to the ticket creator.
 
 ```bash
 ovld protocol create --agent cursor --objectives-json '[{"objective":"Capture follow-up work from this repository"}]'

package/plugins/overlord/scripts/overlord-mcp.mjs

@@ -244,6 +244,11 @@ const tools = [
         available_tools: { type: 'string' },
         for_human: { type: 'boolean' },
         delegate: { type: 'string' },
+        assigned_to: {
+          type: 'string',
+          description:
+            'Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator).'
+        },
         parent_session_key: { type: 'string' },
         parent_ticket_id: { type: 'string' },
         agent: { type: 'string' },
@@ -262,6 +267,7 @@ const tools = [
       'available-tools': args.available_tools,
       'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
+      'assigned-to': args.assigned_to,
       'parent-session-key': args.parent_session_key,
       'parent-ticket-id': args.parent_ticket_id,
       agent: args.agent,
@@ -286,6 +292,11 @@ const tools = [
         available_tools: { type: 'string' },
         for_human: { type: 'boolean' },
         delegate: { type: 'string' },
+        assigned_to: {
+          type: 'string',
+          description:
+            'Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator).'
+        },
         session_key: { type: 'string' },
         ticket_id: { type: 'string' },
         agent: { type: 'string' }
@@ -303,6 +314,7 @@ const tools = [
       'available-tools': args.available_tools,
       'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
+      'assigned-to': args.assigned_to,
       'session-key': args.session_key,
       'ticket-id': args.ticket_id,
       agent: args.agent
@@ -628,6 +640,11 @@ const tools = [
         acceptance_criteria: { type: 'string' },
         available_tools: { type: 'string' },
         delegate: { type: 'string' },
+        assigned_to: {
+          type: 'string',
+          description:
+            'Assign the ticket to a member: username, email, user-id, or orgid:username (defaults to creator).'
+        },
         agent: { type: 'string' },
         skip_file_change_check: { type: 'boolean' }
       },
@@ -643,6 +660,7 @@ const tools = [
       'acceptance-criteria': args.acceptance_criteria,
       'available-tools': args.available_tools,
       delegate: args.delegate,
+      'assigned-to': args.assigned_to,
       agent: args.agent,
       'skip-file-change-check': args.skip_file_change_check
     }),
@@ -1090,6 +1108,16 @@ const tools = [
     }),
     subcommand: 'list-execution-requests'
   },
+  {
+    name: 'list_execution_targets',
+    description: 'List execution targets (runner devices) the authenticated user has access to, including their label and id.',
+    inputSchema: {
+      type: 'object',
+      properties: {}
+    },
+    toCliFlags: () => ({}),
+    subcommand: 'list-execution-targets'
+  },
   {
     name: 'clear_execution_requests',
     description: 'Clear active execution requests from the local runner queue.',

package/plugins/overlord/skills/overlord-ticket/reference/cli.md

@@ -118,6 +118,7 @@ When creating tickets from within a repository:
 - Create multiple tickets when each prompt represents a different feature or goal.
 - Add objectives to the same ticket when each prompt is a sequential step toward the same feature or goal; use `ovld protocol add-objectives --ticket-id <ticket_id> --objectives-json '[{"objective":"..."}]'`.
 - `create`, `prompt`, and `record-work` require `--objectives-json` or `--objectives-file` with an ordered array of `{ "objective": "...", "title": "...", "autoAdvance": true }` objects. A single objective is just an array with one item.
+- `create`, `prompt`, `create-ticket`, and `record-work` accept `--assigned-to <member>` to set the ticket's human owner. Accepts a username, an email, a user-id UUID, or the `orgid:username` member ID. When omitted, the assignee defaults to the ticket creator.
 
 ```bash
 ovld protocol create --agent codex --objectives-json '[{"objective":"Capture follow-up work from this repository"}]'