@sinoia/hubdoc-tools 1.10.0 → 1.11.0

package/cli.js

@@ -95034,7 +95034,7 @@ var require_bignumber = __commonJS({
   "node_modules/bignumber.js/bignumber.js"(exports2, module2) {
     (function(globalObject) {
       "use strict";
-      var BigNumber, isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i, mathceil = Math.ceil, mathfloor = Math.floor, bignumberError = "[BigNumber Error] ", tooManyDigits = bignumberError + "Number primitive has more than 15 significant digits: ", BASE4 = 1e14, LOG_BASE = 14, MAX_SAFE_INTEGER = 9007199254740991, POWS_TEN = [1, 10, 100, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, 1e13], SQRT_BASE = 1e7, MAX = 1e9;
+      var BigNumber, isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i, mathceil = Math.ceil, mathfloor = Math.floor, bignumberError = "[BigNumber Error] ", tooManyDigits = bignumberError + "Number primitive has more than 15 significant digits: ", BASE5 = 1e14, LOG_BASE = 14, MAX_SAFE_INTEGER = 9007199254740991, POWS_TEN = [1, 10, 100, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, 1e13], SQRT_BASE = 1e7, MAX = 1e9;
       function clone(configObject) {
         var div, convertBase, parseNumeric, P = BigNumber2.prototype = { constructor: BigNumber2, toString: null, valueOf: null }, ONE = new BigNumber2(1), DECIMAL_PLACES = 20, ROUNDING_MODE = 4, TO_EXP_NEG = -7, TO_EXP_POS = 21, MIN_EXP = -1e7, MAX_EXP = 1e7, CRYPTO = false, MODULO_MODE = 1, POW_PRECISION = 0, FORMAT = {
           prefix: "",
@@ -95286,7 +95286,7 @@ var require_bignumber = __commonJS({
               if (String(c3[0]).length == i3) {
                 for (i3 = 0; i3 < c3.length; i3++) {
                   n3 = c3[i3];
-                  if (n3 < 0 || n3 >= BASE4 || n3 !== mathfloor(n3)) break out;
+                  if (n3 < 0 || n3 >= BASE5 || n3 !== mathfloor(n3)) break out;
                 }
                 if (n3 !== 0) return true;
               }
@@ -95503,7 +95503,7 @@ var require_bignumber = __commonJS({
             e3 = x3.e - y2.e;
             s3 = dp + e3 + 1;
             if (!base) {
-              base = BASE4;
+              base = BASE5;
               e3 = bitFloor(x3.e / LOG_BASE) - bitFloor(y2.e / LOG_BASE);
               s3 = s3 / LOG_BASE | 0;
             }
@@ -95582,7 +95582,7 @@ var require_bignumber = __commonJS({
               more = rem[0] != null;
               if (!qc[0]) qc.splice(0, 1);
             }
-            if (base == BASE4) {
+            if (base == BASE5) {
               for (i3 = 1, s3 = qc[0]; s3 >= 10; s3 /= 10, i3++) ;
               round(q3, dp + (q3.e = i3 + e3 * LOG_BASE - 1) + 1, rm, more);
             } else {
@@ -95741,12 +95741,12 @@ var require_bignumber = __commonJS({
                     for (k3 = 1; j3 >= 10; j3 /= 10, k3++) ;
                     if (i3 != k3) {
                       x3.e++;
-                      if (xc[0] == BASE4) xc[0] = 1;
+                      if (xc[0] == BASE5) xc[0] = 1;
                     }
                     break;
                   } else {
                     xc[ni] += k3;
-                    if (xc[ni] != BASE4) break;
+                    if (xc[ni] != BASE5) break;
                     xc[ni--] = 0;
                     k3 = 1;
                   }
@@ -95955,12 +95955,12 @@ var require_bignumber = __commonJS({
           }
           b3 = (j3 = yc.length) - (i3 = xc.length);
           if (b3 > 0) for (; b3--; xc[i3++] = 0) ;
-          b3 = BASE4 - 1;
+          b3 = BASE5 - 1;
           for (; j3 > a3; ) {
             if (xc[--j3] < yc[j3]) {
               for (i3 = j3; i3 && !xc[--i3]; xc[i3] = b3) ;
               --xc[i3];
-              xc[j3] += BASE4;
+              xc[j3] += BASE5;
             }
             xc[j3] -= yc[j3];
           }
@@ -96022,7 +96022,7 @@ var require_bignumber = __commonJS({
             ycL = i3;
           }
           for (i3 = xcL + ycL, zc = []; i3--; zc.push(0)) ;
-          base = BASE4;
+          base = BASE5;
           sqrtBase = SQRT_BASE;
           for (i3 = ycL; --i3 >= 0; ) {
             c3 = 0;
@@ -96088,8 +96088,8 @@ var require_bignumber = __commonJS({
             b3 = a3;
           }
           for (a3 = 0; b3; ) {
-            a3 = (xc[--b3] = xc[b3] + yc[b3] + a3) / BASE4 | 0;
-            xc[b3] = BASE4 === xc[b3] ? 0 : xc[b3] % BASE4;
+            a3 = (xc[--b3] = xc[b3] + yc[b3] + a3) / BASE5 | 0;
+            xc[b3] = BASE5 === xc[b3] ? 0 : xc[b3] % BASE5;
           }
           if (a3) {
             xc = [a3].concat(xc);
@@ -733822,7 +733822,7 @@ var PERM_COLUMNS = [
   { header: "ID", key: "id" },
   { header: "Actor", key: "actor_type", format: (v6, row) => `${v6}:${row.actor?.display_name ?? row.actor_id?.substring(0, 8)}` },
   { header: "Level", key: "level" },
-  { header: "On", key: "permissible_type", format: (v6) => v6?.replace(/^Documents::/, "") ?? "" },
+  { header: "On", key: "permissible_type", format: (v6) => v6?.replace(/^(Documents|Projects)::/, "") ?? "" },
   { header: "Resource ID", key: "permissible_id" },
   { header: "Updated", key: "updated_at" }
 ];
@@ -733831,7 +733831,8 @@ var PERMISSIBLE_ALIASES = {
   workspace: "Documents::Workspace",
   folder: "Documents::Folder",
   file: "Documents::File",
-  share_link: "Documents::ShareLink"
+  share_link: "Documents::ShareLink",
+  project: "Projects::Project"
 };
 var ACTOR_ALIASES = {
   user: "User",
@@ -733841,10 +733842,10 @@ var ACTOR_ALIASES = {
 function normalizePermissibleType(input, out) {
   const lower = input.toLowerCase();
   if (PERMISSIBLE_ALIASES[lower]) return PERMISSIBLE_ALIASES[lower];
-  if (input.startsWith("Documents::")) return input;
+  if (input.startsWith("Documents::") || input.startsWith("Projects::")) return input;
   out.fail(
     new Error(
-      `Invalid --on-type: '${input}'. Use workspace/folder/file/share_link or a fully-qualified Documents::\u2026 class name.`
+      `Invalid --on-type: '${input}'. Use workspace/folder/file/share_link/project or a fully-qualified Documents::\u2026 / Projects::\u2026 class name.`
     )
   );
   return "";
@@ -734334,7 +734335,7 @@ async function handleTicketsShow(id, opts) {
     out.fail(err);
   }
 }
-function ticketBodyFromOpts(opts, includeAll) {
+function ticketBodyFromOpts(opts, out) {
   const body2 = {};
   if (opts.title !== void 0) body2.title = opts.title;
   if (opts.description !== void 0) body2.description = opts.description;
@@ -734355,14 +734356,21 @@ function ticketBodyFromOpts(opts, includeAll) {
   const labels = parseLabels(opts.labels);
   if (labels !== void 0) body2.labels = labels;
   if (opts.column !== void 0) body2.column_status = opts.column;
-  return includeAll ? body2 : body2;
+  if (opts.agentConfig !== void 0) {
+    try {
+      body2.agent_config = JSON.parse(opts.agentConfig);
+    } catch (err) {
+      out.fail(new Error(`Invalid JSON for --agent-config: ${err.message}`));
+    }
+  }
+  return body2;
 }
 async function handleTicketsCreate(opts) {
   const out = output(opts);
   requireProject2(opts, out);
   const ctx = await buildApiContext(out);
   if (!opts.title) out.fail(new Error("--title is required"));
-  const body2 = ticketBodyFromOpts(opts, true);
+  const body2 = ticketBodyFromOpts(opts, out);
   try {
     const res = await ctx.axios.post(ticketsBase(opts.project), body2);
     const ticket = res.data?.ticket ?? res.data;
@@ -734375,7 +734383,7 @@ async function handleTicketsUpdate(id, opts) {
   const out = output(opts);
   requireProject2(opts, out);
   const ctx = await buildApiContext(out);
-  const body2 = ticketBodyFromOpts(opts, true);
+  const body2 = ticketBodyFromOpts(opts, out);
   if (Object.keys(body2).length === 0) out.fail(new Error("No fields to update"));
   try {
     const res = await ctx.axios.patch(
@@ -734414,6 +734422,34 @@ async function handleTicketsDelete(id, opts) {
     out.fail(err);
   }
 }
+async function handleTicketsSetAgent(id, opts) {
+  const out = output(opts);
+  requireProject2(opts, out);
+  const ctx = await buildApiContext(out);
+  if (opts.agent === void 0) out.fail(new Error("--agent <agent-id|null> is required"));
+  const body2 = {
+    assignee_id: opts.agent === "null" ? null : opts.agent
+  };
+  if (opts.agentConfig !== void 0) {
+    try {
+      body2.agent_config = JSON.parse(opts.agentConfig);
+    } catch (err) {
+      out.fail(new Error(`Invalid JSON for --agent-config: ${err.message}`));
+    }
+  }
+  try {
+    const res = await ctx.axios.patch(
+      `${ticketsBase(opts.project)}/${encodeURIComponent(id)}`,
+      body2
+    );
+    out.ok(
+      body2.assignee_id === null ? `Ticket ${id} agent cleared` : `Ticket ${id} agent set to ${body2.assignee_id}`,
+      res.data?.ticket ?? res.data
+    );
+  } catch (err) {
+    out.fail(err);
+  }
+}
 async function handleTicketsAssign(id, opts) {
   const out = output(opts);
   requireProject2(opts, out);
@@ -734604,6 +734640,49 @@ async function handleTicketsDispatch(id, opts) {
   }
 }
 
+// apps/cli/cli/handlers/agent-handlers.ts
+var BASE4 = "/api/v1/agents";
+var AGENT_COLUMNS = [
+  { header: "ID", key: "id" },
+  { header: "Key", key: "key" },
+  { header: "Name", key: "name", maxWidth: 30 },
+  { header: "Type", key: "type", format: (v6) => v6?.replace(/^Agents::/, "") ?? "" },
+  { header: "Active", key: "active", format: (v6) => v6 ? "\u2714" : "" }
+];
+async function handleAgentsList(opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  const params = {};
+  if (opts.active !== void 0) params.active = opts.active;
+  if (opts.page) params.page = Number(opts.page);
+  if (opts.perPage) params.per_page = Number(opts.perPage);
+  try {
+    const res = await ctx.axios.get(BASE4, { params });
+    const items = Array.isArray(res.data) ? res.data : [];
+    const pagination = extractPagination(res.headers, items.length);
+    if (opts.json) {
+      out.show({ items, pagination });
+      return;
+    }
+    out.list(items, AGENT_COLUMNS);
+    if (pagination.pages > 1) {
+      out.note(`page ${pagination.page}/${pagination.pages} (${pagination.count} total)`);
+    }
+  } catch (err) {
+    out.fail(err);
+  }
+}
+async function handleAgentsShow(id, opts) {
+  const out = output(opts);
+  const ctx = await buildApiContext(out);
+  try {
+    const res = await ctx.axios.get(`${BASE4}/${encodeURIComponent(id)}`);
+    out.show(res.data?.agent ?? res.data, { title: `Agent ${id}` });
+  } catch (err) {
+    out.fail(err);
+  }
+}
+
 // apps/cli/cli/handlers/task-handlers.ts
 var tasksBase = (pid, tid) => `/api/v1/projects/${encodeURIComponent(pid)}/tickets/${encodeURIComponent(tid)}/tasks`;
 var TASK_COLUMNS = [
@@ -734778,7 +734857,7 @@ async function handleTasksReorder(opts) {
 // apps/cli/cli.ts
 var getVersion = () => {
   try {
-    if (true) return "1.10.0";
+    if (true) return "1.11.0";
   } catch {
   }
   for (const candidate of [
@@ -735123,10 +735202,10 @@ tickets.command("ls").alias("list").description("List tickets").requiredOption("
 tickets.command("show <id>").description("Show a ticket (with tasks, subtasks, deliverables)").requiredOption("--project <id>", "Parent project id").action(async (id, options) => {
   await handleTicketsShow(id, withGlobals(options));
 });
-tickets.command("create").description("Create a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--title <text>").option("--description <text>").option("--type <ticket_type>", "task (default) | bug | story | epic | \u2026").option("--sprint <id>", "Attach to a sprint; omit to leave in backlog").option("--assignee <id>", "Assign to a user id").option("--priority <priority>", "lowest | low | medium | high | highest").option("--status <status>").option("--parent <id>", "Parent ticket id (for subtasks)").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>", "Comma-separated labels").option("--column <column_status>").action(async (options) => {
+tickets.command("create").description("Create a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--title <text>").option("--description <text>").option("--type <ticket_type>", "task (default) | bug | story | epic | \u2026").option("--sprint <id>", "Attach to a sprint; omit to leave in backlog").option("--assignee <id>", "Assign to a user id").option("--priority <priority>", "lowest | low | medium | high | highest").option("--status <status>").option("--parent <id>", "Parent ticket id (for subtasks)").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>", "Comma-separated labels").option("--column <column_status>").option("--agent-config <json>", "JSON payload written to the ticket agent_config (corex#591)").action(async (options) => {
   await handleTicketsCreate(withGlobals(options));
 });
-tickets.command("update <id>").description("Update a ticket").requiredOption("--project <id>", "Parent project id").option("--title <text>").option("--description <text>").option("--type <ticket_type>").option("--sprint <id>", 'Move to a sprint; use "null" for backlog').option("--assignee <id>", 'Reassign; use "null" to unassign').option("--priority <priority>").option("--status <status>").option("--parent <id>").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>").option("--column <column_status>").action(async (id, options) => {
+tickets.command("update <id>").description("Update a ticket").requiredOption("--project <id>", "Parent project id").option("--title <text>").option("--description <text>").option("--type <ticket_type>").option("--sprint <id>", 'Move to a sprint; use "null" for backlog').option("--assignee <id>", 'Reassign; use "null" to unassign').option("--priority <priority>").option("--status <status>").option("--parent <id>").option("--due <YYYY-MM-DD>").option("--story-points <n>").option("--labels <a,b,c>").option("--column <column_status>").option("--agent-config <json>", "JSON payload written to the ticket agent_config (corex#591)").action(async (id, options) => {
   await handleTicketsUpdate(id, withGlobals(options));
 });
 tickets.command("delete <id>").description("Delete a ticket (drops its tasks, deliverables, activities)").requiredOption("--project <id>", "Parent project id").option("--yes", "Skip the interactive confirmation").action(async (id, options) => {
@@ -735135,6 +735214,9 @@ tickets.command("delete <id>").description("Delete a ticket (drops its tasks, de
 tickets.command("assign <id>").description("Assign a ticket to a user; --to null to unassign").requiredOption("--project <id>", "Parent project id").requiredOption("--to <user-id|null>").action(async (id, options) => {
   await handleTicketsAssign(id, withGlobals(options));
 });
+tickets.command("set-agent <id>").description("Configure the ticket with an agent (assignee + agent_config in one PATCH) \u2014 needed before `dispatch` (corex#591)").requiredOption("--project <id>", "Parent project id").requiredOption("--agent <agent-id|null>", 'Agents::Agent UUID (use "null" to clear)').option("--agent-config <json>", "Optional JSON payload merged into agent_config").action(async (id, options) => {
+  await handleTicketsSetAgent(id, withGlobals(options));
+});
 tickets.command("status <id>").description("Change a ticket status (optionally pin the kanban column with --column)").requiredOption("--project <id>", "Parent project id").requiredOption("--to <status>", "open | in_progress | done | blocked | awaiting_human | cancelled | failed").option("--column <column_status>", "Optionally set the kanban column at the same time").action(async (id, options) => {
   await handleTicketsStatus(id, withGlobals(options));
 });
@@ -735178,6 +735260,13 @@ tasks.command("complete <id>").description("Mark a task as completed (or re-open
 tasks.command("reorder").description("Reorder tasks under a ticket").requiredOption("--project <id>", "Parent project id").requiredOption("--ticket <id>", "Parent ticket id").requiredOption("--order <ids>", "Comma-separated task ids in the desired order").action(async (options) => {
   await handleTasksReorder(withGlobals(options));
 });
+var agents = program2.command("agents").description("List agents dispatchable on tickets (corex#591)");
+agents.command("ls").alias("list").description("List agents").option("--active", "Only agents whose config is active").option("--page <n>").option("--per-page <n>").action(async (options) => {
+  await handleAgentsList(withGlobals(options));
+});
+agents.command("show <id>").description("Show an agent").action(async (id, options) => {
+  await handleAgentsShow(id, withGlobals(options));
+});
 program2.parse();
 /*! Bundled license information:
 

package/docs/llm-usage.md

@@ -377,16 +377,36 @@ themselves. All commands support `--json` for machine parsing.
 | start | complete`.
 
 `hubdoc tickets --project=<pid>` — `ls | show | create | update | delete
-| assign | status | move | activities | deliverable | dispatch |
-comment | comments`. Every verb requires `--project=<pid>`. `ls
---backlog` (or `ls --sprint null`) lists the backlog. `assign --to null`
-unassigns. `status --to <state> [--column <col>]` uses the canonical
-statuses: `open | in_progress | done | blocked | awaiting_human |
-cancelled | failed` and optionally pins the kanban column at the same
-time. `comment <id> --body <text>` (or `--body-file <path>`) posts a
-message on the ticket's discussion thread (visible in Corex / Agoria,
-attributed to the token holder); `comments <id>` reads the thread
-oldest-first (paginated like `activities`).
+| assign | set-agent | status | move | activities | deliverable |
+dispatch | comment | comments`. Every verb requires `--project=<pid>`.
+`ls --backlog` (or `ls --sprint null`) lists the backlog. `assign --to
+null` unassigns. `status --to <state> [--column <col>]` uses the
+canonical statuses: `open | in_progress | done | blocked |
+awaiting_human | cancelled | failed` and optionally pins the kanban
+column at the same time. `comment <id> --body <text>` (or `--body-file
+<path>`) posts a message on the ticket's discussion thread (visible in
+Corex / Agoria, attributed to the token holder); `comments <id>` reads
+the thread oldest-first (paginated like `activities`).
+
+**Agent configuration on tickets** (corex#591) : `create` and `update`
+both accept `--agent-config <json>` — free-form jsonb persisted on the
+ticket and read back by `dispatch_agent` / the agent runner (canonical
+keys: `agent_role: planner|executor|…`, `instructions`). The convenience
+verb `tickets set-agent <id> --project <pid> --agent <agent-id>
+[--agent-config <json>]` PATCHes `assignee_id` and (optionally)
+`agent_config` in one call — the shortest path from "empty ticket" to
+"dispatchable". Use `hubdoc agents ls [--active]` to discover
+dispatchable agent UUIDs (STI: `Agents::Planner`, `Agents::Executor`,
+`Agents::Classifier`, `Agents::Conversational`, …).
+
+**Project ACL** (hubdoc-tools#15) : the `permissions` verbs now accept
+`--on-type project` (alias of `Projects::Project`) — the corex
+`/api/v1/permissions` controller is polymorphic and `Projects::Project`
+includes `HasPermissionsConcern`. This lets an agent share a **standalone
+project** (no workspace attached) with a colleague or another agent
+without going through a workspace-scoped ACL. Example:
+`hubdoc permissions grant --to <user-id> --to-type user --on <project-id>
+--on-type project --level admin`.
 
 `hubdoc tasks --project=<pid> --ticket=<tid>` — `ls | show | create |
 update | delete | complete | reorder`. Sub-tasks live under a ticket;
@@ -444,7 +464,13 @@ hubdoc tasks create --project "$PID" --ticket "$TID" \
 hubdoc tasks create --project "$PID" --ticket "$TID" \
     --title "Rédiger devis" --priority high --due 2026-07-16 --json
 
-# 5. Dispatch the agent already configured on the ticket.
+# 5. Pick a dispatchable agent then set it on the ticket in one shot.
+AGENT_ID=$(hubdoc agents ls --active --json | jq -r '.items[] | select(.key=="planner") | .id')
+hubdoc tickets set-agent "$TID" --project "$PID" \
+    --agent "$AGENT_ID" \
+    --agent-config '{"agent_role":"planner","instructions":"Rédige un devis à partir des PJ."}' --json
+
+# 5b. Now `dispatch` can actually fire (agent + agent_config both set).
 hubdoc tickets dispatch "$TID" --project "$PID" --json
 
 # 6. Later — post a follow-up on the ticket thread (visible to the human):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinoia/hubdoc-tools",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Professional command-line tool for HubDoc document management and bulk import/export",
   "main": "cli.js",
   "bin": {