agl 43.8.0 → 43.9.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 (45) hide show
  1. package/changelog.md +16 -0
  2. package/dist_serve/bundle.js +317 -304
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/aglapi/aglapisurface.document.js +824 -6
  6. package/dist_ts/aglapi/interfaces.d.ts +8 -0
  7. package/dist_ts/aglapi/interfaces.js +3 -1
  8. package/dist_ts/classes.mcpclient.js +3 -3
  9. package/dist_ts/classes.mcpcontrollerhost.js +3 -2
  10. package/dist_ts/classes.mcptools.d.ts +1 -1
  11. package/dist_ts/classes.mcptools.js +2 -1
  12. package/dist_ts/classes.ticketstore.d.ts +3 -3
  13. package/dist_ts/classes.ticketstore.js +23 -4
  14. package/dist_ts/functions.deviceapi.js +3 -1
  15. package/dist_ts/functions.mcptickettools.d.ts +60 -0
  16. package/dist_ts/functions.mcptickettools.js +4 -3
  17. package/dist_ts/functions.ticketcli.d.ts +4 -2
  18. package/dist_ts/functions.ticketcli.js +70 -4
  19. package/dist_ts/functions.ticketlisting.d.ts +38 -0
  20. package/dist_ts/functions.ticketlisting.js +211 -0
  21. package/dist_ts/functions.ticketvalidation.d.ts +62 -0
  22. package/dist_ts/functions.ticketvalidation.js +41 -3
  23. package/dist_ts_interfaces/mcprequests.d.ts +1 -1
  24. package/dist_ts_interfaces/requests.tickets.d.ts +31 -3
  25. package/dist_ts_interfaces/requests.tickets.js +2 -2
  26. package/dist_ts_interfaces/tickets.d.ts +174 -2
  27. package/dist_ts_interfaces/tickets.js +20 -2
  28. package/package.json +2 -2
  29. package/readme.md +31 -3
  30. package/ts/00_commitinfo_data.ts +1 -1
  31. package/ts/aglapi/aglapisurface.document.ts +823 -5
  32. package/ts/aglapi/interfaces.ts +2 -0
  33. package/ts/classes.mcpclient.ts +2 -2
  34. package/ts/classes.mcpcontrollerhost.ts +2 -1
  35. package/ts/classes.mcptools.ts +1 -0
  36. package/ts/classes.ticketstore.ts +21 -3
  37. package/ts/functions.deviceapi.ts +2 -0
  38. package/ts/functions.mcptickettools.ts +3 -2
  39. package/ts/functions.ticketcli.ts +70 -5
  40. package/ts/functions.ticketlisting.ts +214 -0
  41. package/ts/functions.ticketvalidation.ts +41 -2
  42. package/ts_interfaces/requests.tickets.ts +32 -2
  43. package/ts_interfaces/tickets.ts +136 -3
  44. package/ts_web/00_commitinfo_data.ts +1 -1
  45. package/ts_web/elements.inbox.ts +50 -9
package/readme.md CHANGED
@@ -1217,7 +1217,8 @@ Agent messages are attribution and the owner's control, not a security boundary:
1217
1217
  | `workspace_reveal` | Show one path in a workspace attached to the calling chat: a file opens in the editor, a directory in the file tree. The path is project-relative and must lie inside the workspace's base directory. The reply is an acknowledgement and the entry type; the tool never reads a file. |
1218
1218
  | `job_start`, `jobs_list`, `job_status` | Start a host command as a managed job that outlives chats and controller restarts, list a project's newest jobs, or read one job's state, exit code or signal, times and log size. |
1219
1219
  | `job_tail`, `job_wait`, `job_stop` | Read a bounded range of a job's log, wait up to four minutes for it to end, or stop its whole process group. |
1220
- | `tickets_list`, `ticket_get`, `ticket_create`, `ticket_update`, `ticket_move`, `ticket_comment`, `ticket_link` | Capture and progress shared project tickets with verified worker identity, atomic board ordering, comments, activity and branch evidence for Review. |
1220
+ | `board_overview`, `tickets_list` | Read the board at a glance (counts by column, priority, project and assignee, epic progress, what needs someone) and list it in pages of ticket summaries with filters and a sort. |
1221
+ | `ticket_get`, `ticket_create`, `ticket_update`, `ticket_move`, `ticket_comment`, `ticket_link` | Capture and progress shared project tickets with verified worker identity, atomic board ordering, comments, activity and branch evidence for Review. |
1221
1222
  | `ticket_question_ask` | Ask the owner a question on the caller's own assigned ticket, with optional choices; the answer arrives in the caller's session as a ticket notice. |
1222
1223
 
1223
1224
  To work with resources for an externally launched task, call `context_resolve` with its absolute `directory` and optional `{ harnessId, nativeId }` task ID. A raw Codex thread ID is accepted only if exactly one configured connection matches; an ambiguous ID requires selecting the qualified ID returned by `sessions_list`. Discovery records the verified native task in AGL without resuming it or acquiring its Codex writer. Subsequent operations reuse the normal UI validation, audit, admission, and ownership checks. Targets must belong to the exact project and configured native connection. Adding a project does not connect an arbitrary external harness server.
@@ -2477,7 +2478,7 @@ no generated-native-file edit is needed. The master must contain one non-secret
2477
2478
  entry. Ambiguous entries, wrapper commands, static caller credentials and secret `envFrom`
2478
2479
  definitions fail closed. Fleet owns spawning, native observations and hook calls.
2479
2480
 
2480
- MCP tools are `tickets_list` (mine/project/status/label/text filters), `ticket_get` (ticket,
2481
+ MCP tools are `board_overview` (the board at a glance), `tickets_list` (pages of summaries; filters, sort and cursor below), `ticket_get` (ticket,
2481
2482
  questions and one page of history), `ticket_create`, `ticket_update`, `ticket_move`,
2482
2483
  `ticket_comment`, `ticket_link` and `ticket_question_ask`. `ticket_comment.body` accepts markdown text or the
2483
2484
  kanban's text/reference-content array. A Claude worker's assignment uses
@@ -2490,6 +2491,10 @@ cannot mutate assigned tickets, but verified callers can still read/create/comme
2490
2491
  agl ticket create --project agl --title 'Add the shared board' --source 'The owner’s words' --json
2491
2492
  agl ticket assign AGL-1 --expected-revision <revision-from-get> --session-id codex:<native-id> --name 'Backend worker' --json
2492
2493
  agl ticket move AGL-1 --column ready --json
2494
+ agl ticket overview --json
2495
+ agl ticket page --project agl --open --sort priority --limit 20 --json
2496
+ agl ticket page --project agl --open --sort priority --limit 20 --cursor <nextCursor> --json
2497
+ agl ticket page --parent AGL-7 --json
2493
2498
  agl ticket list --project agl --json
2494
2499
  agl ticket link AGL-1 --repo modelprofile.com/agl --branch feat/tickets --sha <full-sha> --json
2495
2500
  agl ticket move AGL-1 --column review --json
@@ -2503,6 +2508,29 @@ agl ticket list --label openQuestion --json
2503
2508
  agl ticket answer AGL-1 --question Q1 --choice 2 --text 'Keep it **small**.' --json
2504
2509
  ```
2505
2510
 
2511
+ `board_overview` (`agl ticket overview`, `agl.mcp.ticket.overview`, `controller.ticket.overview`) answers the
2512
+ whole board in one bounded reply without any ticket's texts: `total`, `open`, counts by column, by priority
2513
+ (open tickets) and by AutoLabel, `projects` and `assignees` (most open work first, at most 50 beside
2514
+ `projectsTotal` and `assigneesTotal`), `unassignedOpen`, every open epic with its direct children (`children`,
2515
+ `done`, `columns`), and under `attention` the tickets that need someone: `urgent`, `needsInput`,
2516
+ `openQuestions`, `review`, `unassignedReady` and `stale` (in_progress, needs_input or review work without a
2517
+ change for `staleDays`, default 3, oldest first). `recent` holds the tickets changed last. Each list holds at
2518
+ most `limit` tickets (default 5, at most 50) and its `total` counts all of them. `project` and `mine` narrow it.
2519
+
2520
+ `tickets_list` (`agl ticket page`, `agl.mcp.ticket.page`, `controller.ticket.page`) lists the board in pages of
2521
+ `limit` tickets (default 50, at most 200; a page also ends at 256 KiB). A ticket is a summary: `key`,
2522
+ `revision`, `project`, `kind`, `title`, `columnId`, `priority`, `updatedAt` and, where present, `assignee`,
2523
+ `parentId`, `labels`, `autoLabels`, `links` (a count per kind), `releasePlan`, `deployPlan`,
2524
+ `maintenanceWindow` and `openQuestions`; `view: "full"` returns whole tickets. `total` and `columns` count
2525
+ everything the filters match, on every page. Filters: `mine`, `project`, `status`, `statuses`, `open`
2526
+ (`true` leaves out released and closed tickets, `false` keeps only those), `kind`, `priorities`, `parent`
2527
+ (direct children), `assignee` (a person id or a session id), `unassigned`, `keys` (up to 200), `updatedSince`,
2528
+ `label` and `text`. `sort` is `board` (default), `updated`, `created` or `priority`. `nextCursor` continues
2529
+ with the same filters, sort and view (`TICKET_CURSOR_MISMATCH` otherwise, `TICKET_CURSOR_INVALID` for anything
2530
+ that is no cursor). A cursor is a position, not a snapshot: `moved: true` tells that the board changed since
2531
+ the first page, so a ticket that changed its place meanwhile may be missing or shown twice. The unpaged
2532
+ `agl ticket list` (`agl.mcp.ticket.list`) still returns every matching ticket whole.
2533
+
2506
2534
  `ticket_get` (`agl ticket get`, `agl.mcp.ticket.get`, `controller.ticket.get`) returns the
2507
2535
  ticket, all its questions and the newest page of its history, oldest first: `activity` holds
2508
2536
  up to `limit` entries (default 50, at most 500), cut earlier so that the entries and the comments
@@ -3513,7 +3541,7 @@ agl restart [--port 4097]
3513
3541
  agl service install [startup options] | status [--json] | uninstall | protect
3514
3542
  agl upgrade [--port 4097] [--registry <url>] [--grace-period-seconds 300] [--continue-sessions] [--json]
3515
3543
  agl mcp [--port 4097]
3516
- agl ticket list|get|create|update|move|comment|link|unlink|assign|ask|answer [options] [--json]
3544
+ agl ticket overview|page|list|get|create|update|move|comment|link|unlink|assign|ask|answer [options] [--json]
3517
3545
  agl deploy status [TARGET] | history TARGET | probe TARGET [--json]
3518
3546
  agl release status [REPO] [--json]
3519
3547
  agl push status [--json] | apns set|unset | fcm set|unset | previews on|off | test [--port 4097] [options]
@@ -3,6 +3,6 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: 'agl',
6
- version: '43.8.0',
6
+ version: '43.9.0',
7
7
  description: 'Agent Gateway Layer for OpenCode, FlexHarness, and Codex sessions'
8
8
  }