agl 42.2.2 → 43.0.1

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 (179) hide show
  1. package/changelog.md +24 -0
  2. package/dist_serve/bundle.js +6697 -5287
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +29 -29
  5. package/dist_serve/bundle.js.third-party-notices.txt +29 -29
  6. package/dist_serve/third-party-notices.md +597 -8
  7. package/dist_ts/00_commitinfo_data.js +1 -1
  8. package/dist_ts/aglapi/aglapisurface.document.js +114 -16
  9. package/dist_ts/aglapi/interfaces.d.ts +30 -0
  10. package/dist_ts/aglapi/interfaces.js +7 -1
  11. package/dist_ts/classes.authstore.d.ts +7 -0
  12. package/dist_ts/classes.authstore.js +12 -1
  13. package/dist_ts/classes.browserpainttransport.d.ts +2 -2
  14. package/dist_ts/classes.browserpainttransport.js +9 -8
  15. package/dist_ts/classes.browserresourcehost.js +30 -20
  16. package/dist_ts/classes.cli.js +10 -1
  17. package/dist_ts/classes.controller.d.ts +41 -11
  18. package/dist_ts/classes.controller.js +232 -52
  19. package/dist_ts/classes.harnessoperationmanager.d.ts +44 -0
  20. package/dist_ts/classes.harnessoperationmanager.js +15 -10
  21. package/dist_ts/classes.mcpclient.d.ts +5 -0
  22. package/dist_ts/classes.mcpclient.js +15 -3
  23. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
  24. package/dist_ts/classes.mcpcontrollerhost.js +17 -3
  25. package/dist_ts/classes.mcptools.d.ts +4 -3
  26. package/dist_ts/classes.mcptools.js +20 -1
  27. package/dist_ts/classes.mcpvalidation.js +4 -1
  28. package/dist_ts/classes.ticketstore.d.ts +71 -3
  29. package/dist_ts/classes.ticketstore.js +299 -12
  30. package/dist_ts/classes.validation.d.ts +2 -0
  31. package/dist_ts/classes.validation.js +27 -5
  32. package/dist_ts/driver/classes.directreports.d.ts +23 -3
  33. package/dist_ts/driver/classes.directreports.js +59 -2
  34. package/dist_ts/driver/classes.drivereventrelay.js +3 -2
  35. package/dist_ts/driver/functions.driverinstructions.d.ts +1 -1
  36. package/dist_ts/driver/functions.driverinstructions.js +12 -3
  37. package/dist_ts/driver/functions.drivertools.d.ts +4 -0
  38. package/dist_ts/driver/functions.drivertools.js +8 -2
  39. package/dist_ts/fleet/classes.boardpump.d.ts +53 -3
  40. package/dist_ts/fleet/classes.boardpump.js +237 -32
  41. package/dist_ts/fleet/classes.claudeworkers.d.ts +10 -3
  42. package/dist_ts/fleet/classes.claudeworkers.js +43 -19
  43. package/dist_ts/fleet/classes.codexworkers.d.ts +5 -3
  44. package/dist_ts/fleet/classes.codexworkers.js +26 -9
  45. package/dist_ts/fleet/classes.deploymonitor.d.ts +253 -0
  46. package/dist_ts/fleet/classes.deploymonitor.js +821 -0
  47. package/dist_ts/fleet/classes.gitfacts.d.ts +61 -0
  48. package/dist_ts/fleet/classes.gitfacts.js +125 -0
  49. package/dist_ts/fleet/classes.releasereconciler.d.ts +51 -0
  50. package/dist_ts/fleet/classes.releasereconciler.js +101 -0
  51. package/dist_ts/fleet/classes.service.d.ts +13 -1
  52. package/dist_ts/fleet/classes.service.js +76 -7
  53. package/dist_ts/fleet/classes.ticketeffects.d.ts +13 -0
  54. package/dist_ts/fleet/classes.ticketeffects.js +42 -8
  55. package/dist_ts/fleet/classes.workers.d.ts +10 -3
  56. package/dist_ts/fleet/classes.workers.js +18 -3
  57. package/dist_ts/fleet/functions.controllerbuild.d.ts +23 -0
  58. package/dist_ts/fleet/functions.controllerbuild.js +75 -0
  59. package/dist_ts/fleet/functions.deployprobes.d.ts +39 -0
  60. package/dist_ts/fleet/functions.deployprobes.js +82 -0
  61. package/dist_ts/fleet/functions.deployvalidation.d.ts +27 -0
  62. package/dist_ts/fleet/functions.deployvalidation.js +43 -0
  63. package/dist_ts/fleet/functions.release.d.ts +2 -1
  64. package/dist_ts/fleet/functions.release.js +32 -5
  65. package/dist_ts/fleet/functions.releasefacts.d.ts +42 -0
  66. package/dist_ts/fleet/functions.releasefacts.js +46 -0
  67. package/dist_ts/fleet/functions.validation.d.ts +3 -3
  68. package/dist_ts/fleet/functions.validation.js +4 -7
  69. package/dist_ts/fleet/functions.watchprobes.js +7 -9
  70. package/dist_ts/fleet/functions.workervalidation.js +4 -3
  71. package/dist_ts/fleet/interfaces.workers.d.ts +30 -3
  72. package/dist_ts/fleet/interfaces.workers.js +14 -1
  73. package/dist_ts/functions.deploycli.d.ts +36 -0
  74. package/dist_ts/functions.deploycli.js +157 -0
  75. package/dist_ts/functions.mcpdeploytools.d.ts +13 -0
  76. package/dist_ts/functions.mcpdeploytools.js +16 -0
  77. package/dist_ts/functions.mcptickettools.d.ts +54 -0
  78. package/dist_ts/functions.mcptickettools.js +8 -7
  79. package/dist_ts/functions.ticketautolabels.d.ts +2 -0
  80. package/dist_ts/functions.ticketautolabels.js +9 -3
  81. package/dist_ts/functions.ticketcli.d.ts +16 -2
  82. package/dist_ts/functions.ticketcli.js +105 -27
  83. package/dist_ts/functions.ticketvalidation.d.ts +55 -0
  84. package/dist_ts/functions.ticketvalidation.js +26 -8
  85. package/dist_ts_interfaces/deployments.d.ts +241 -0
  86. package/dist_ts_interfaces/deployments.js +5 -6
  87. package/dist_ts_interfaces/fleet.d.ts +12 -0
  88. package/dist_ts_interfaces/fleetworkers.d.ts +21 -1
  89. package/dist_ts_interfaces/functions.fleetversion.d.ts +4 -0
  90. package/dist_ts_interfaces/functions.fleetversion.js +25 -0
  91. package/dist_ts_interfaces/interfaces.d.ts +4 -2
  92. package/dist_ts_interfaces/interfaces.js +4 -2
  93. package/dist_ts_interfaces/mcprequests.d.ts +3 -2
  94. package/dist_ts_interfaces/mcprequests.js +3 -1
  95. package/dist_ts_interfaces/requests.d.ts +3 -2
  96. package/dist_ts_interfaces/requests.directreports.d.ts +58 -6
  97. package/dist_ts_interfaces/requests.js +1 -1
  98. package/dist_ts_interfaces/requests.tickets.d.ts +25 -5
  99. package/dist_ts_interfaces/requests.tickets.js +2 -2
  100. package/dist_ts_interfaces/tickets.d.ts +71 -6
  101. package/dist_ts_interfaces/tickets.js +34 -6
  102. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +7 -0
  103. package/dist_ts_migration/classes.documentmigrationrunner.js +14 -1
  104. package/dist_ts_migration/index.d.ts +2 -0
  105. package/dist_ts_migration/index.js +3 -1
  106. package/dist_ts_migration/v41_ticketclosedcolumn.d.ts +20 -0
  107. package/dist_ts_migration/v41_ticketclosedcolumn.js +118 -0
  108. package/dist_ts_migration/v41_ticketlinkrepos.d.ts +24 -0
  109. package/dist_ts_migration/v41_ticketlinkrepos.js +101 -0
  110. package/package.json +6 -2
  111. package/readme.md +308 -36
  112. package/third-party-notices.md +597 -8
  113. package/ts/00_commitinfo_data.ts +1 -1
  114. package/ts/aglapi/aglapisurface.document.ts +113 -15
  115. package/ts/aglapi/interfaces.ts +6 -0
  116. package/ts/classes.authstore.ts +13 -0
  117. package/ts/classes.browserpainttransport.ts +8 -7
  118. package/ts/classes.browserresourcehost.ts +38 -14
  119. package/ts/classes.cli.ts +9 -0
  120. package/ts/classes.controller.ts +244 -61
  121. package/ts/classes.harnessoperationmanager.ts +20 -14
  122. package/ts/classes.mcpclient.ts +17 -2
  123. package/ts/classes.mcpcontrollerhost.ts +18 -2
  124. package/ts/classes.mcptools.ts +21 -2
  125. package/ts/classes.mcpvalidation.ts +2 -0
  126. package/ts/classes.ticketstore.ts +312 -13
  127. package/ts/classes.validation.ts +28 -4
  128. package/ts/driver/classes.directreports.ts +58 -3
  129. package/ts/driver/classes.drivereventrelay.ts +2 -1
  130. package/ts/driver/functions.driverinstructions.ts +11 -2
  131. package/ts/driver/functions.drivertools.ts +10 -2
  132. package/ts/fleet/classes.boardpump.ts +235 -28
  133. package/ts/fleet/classes.claudeworkers.ts +36 -15
  134. package/ts/fleet/classes.codexworkers.ts +24 -7
  135. package/ts/fleet/classes.deploymonitor.ts +854 -0
  136. package/ts/fleet/classes.gitfacts.ts +135 -0
  137. package/ts/fleet/classes.releasereconciler.ts +103 -0
  138. package/ts/fleet/classes.service.ts +81 -8
  139. package/ts/fleet/classes.ticketeffects.ts +38 -6
  140. package/ts/fleet/classes.workers.ts +19 -5
  141. package/ts/fleet/functions.controllerbuild.ts +84 -0
  142. package/ts/fleet/functions.deployprobes.ts +84 -0
  143. package/ts/fleet/functions.deployvalidation.ts +50 -0
  144. package/ts/fleet/functions.release.ts +32 -3
  145. package/ts/fleet/functions.releasefacts.ts +74 -0
  146. package/ts/fleet/functions.validation.ts +3 -6
  147. package/ts/fleet/functions.watchprobes.ts +6 -8
  148. package/ts/fleet/functions.workervalidation.ts +3 -2
  149. package/ts/fleet/interfaces.workers.ts +23 -3
  150. package/ts/functions.deploycli.ts +156 -0
  151. package/ts/functions.mcpdeploytools.ts +18 -0
  152. package/ts/functions.mcptickettools.ts +7 -6
  153. package/ts/functions.ticketautolabels.ts +10 -2
  154. package/ts/functions.ticketcli.ts +100 -24
  155. package/ts/functions.ticketvalidation.ts +26 -7
  156. package/ts_interfaces/deployments.ts +194 -0
  157. package/ts_interfaces/fleet.ts +17 -2
  158. package/ts_interfaces/fleetworkers.ts +20 -0
  159. package/ts_interfaces/functions.fleetversion.ts +20 -0
  160. package/ts_interfaces/interfaces.ts +3 -1
  161. package/ts_interfaces/mcprequests.ts +3 -0
  162. package/ts_interfaces/requests.directreports.ts +52 -8
  163. package/ts_interfaces/requests.tickets.ts +20 -4
  164. package/ts_interfaces/requests.ts +6 -1
  165. package/ts_interfaces/tickets.ts +53 -6
  166. package/ts_migration/classes.documentmigrationrunner.ts +15 -0
  167. package/ts_migration/index.ts +2 -0
  168. package/ts_migration/v41_ticketclosedcolumn.ts +106 -0
  169. package/ts_migration/v41_ticketlinkrepos.ts +91 -0
  170. package/ts_web/00_commitinfo_data.ts +1 -1
  171. package/ts_web/elements.deployments.ts +1066 -0
  172. package/ts_web/elements.directreport.ts +2 -2
  173. package/ts_web/elements.directreportsession.ts +5 -5
  174. package/ts_web/elements.harnesscontrollerapp.ts +179 -13
  175. package/ts_web/elements.makedirectreport.ts +444 -0
  176. package/ts_web/elements.nativesession.ts +29 -1
  177. package/ts_web/elements.ticketboard.ts +74 -18
  178. package/ts_web/functions.deployments.ts +231 -0
  179. package/ts_web/functions.sessionchat.ts +2 -0
@@ -9,6 +9,8 @@ import { assertFleetOperation, assertFleetWireRequest } from './fleet/functions.
9
9
  import { readTicketRevisionConflict, ticketErrorMessages, type TTicketClientErrorCode, type TTicketOperation, type TTicketRequest, type TTicketResponse } from '../ts_interfaces/tickets.js';
10
10
  import { assertMcpTicketRequest, assertTicketResponse } from './functions.ticketvalidation.js';
11
11
  import { assertSessionFeedWireRequest, assertSessionFeedWireResponse } from './functions.sessionfeedvalidation.js';
12
+ import { assertFleetDeployResponse, assertFleetDeployWireRequest } from './fleet/functions.deployvalidation.js';
13
+ import type { IFleetDeployOperations, TFleetDeployOperation } from '../ts_interfaces/deployments.js';
12
14
  import type { IReq_ControllerMcpSessionFeedAcknowledge, IReq_ControllerMcpSessionFeedList } from '../ts_interfaces/sessionfeed.js';
13
15
  import {
14
16
  controllerMcpSessionDetailFields,
@@ -338,6 +340,10 @@ const assertResponsePayload = (
338
340
  assertSessionFeedWireResponse(methodArg, valueArg);
339
341
  return;
340
342
  }
343
+ if (methodArg.startsWith('agl.mcp.deploy.')) {
344
+ assertFleetDeployResponse(methodArg, valueArg);
345
+ return;
346
+ }
341
347
  if (methodArg.startsWith('agl.mcp.ticket.')) {
342
348
  assertTicketResponse(methodArg, valueArg);
343
349
  return;
@@ -719,7 +725,7 @@ export class ControllerMcpClient {
719
725
  const method = `agl.mcp.ticket.${methodArg}` as const;
720
726
  const request = assertMcpTicketRequest(method, requestArg);
721
727
  return this.dispatchAfterHandshake(method, request as never, signalArg,
722
- ['create', 'update', 'move', 'comment', 'link', 'ask', 'answer'].includes(methodArg)) as Promise<TTicketResponse<TMethod>>;
728
+ ['create', 'update', 'move', 'comment', 'link', 'unlink', 'ask', 'answer'].includes(methodArg)) as Promise<TTicketResponse<TMethod>>;
723
729
  }
724
730
 
725
731
  public async fleetWorker<T extends TFleetWorkerAction>(action: T, request: TFleetWorkerRequest<T> & { ownerToken: string }, signal?: AbortSignal): Promise<TFleetWorkerResponse<T>> {
@@ -738,6 +744,14 @@ export class ControllerMcpClient {
738
744
  const wireRequest = assertSessionFeedWireRequest('agl.mcp.sessionfeed.acknowledge', request);
739
745
  return this.dispatchAfterHandshake('agl.mcp.sessionfeed.acknowledge', wireRequest as IReq_ControllerMcpSessionFeedAcknowledge['request'], signal, true);
740
746
  }
747
+ /** Deploy status, history, a probe now or release state as the local owner reads them (`agl deploy`, `agl release status`). */
748
+ public async deploy<TOperation extends TFleetDeployOperation>(operation: TOperation,
749
+ request: IFleetDeployOperations[TOperation]['request'] & { ownerToken: string }, signal?: AbortSignal,
750
+ ): Promise<IFleetDeployOperations[TOperation]['response']> {
751
+ const method = `agl.mcp.deploy.${operation}` as const;
752
+ const wireRequest = assertFleetDeployWireRequest(method, request);
753
+ return this.dispatchAfterHandshake(method, wireRequest as never, signal, operation === 'probe') as Promise<IFleetDeployOperations[TOperation]['response']>;
754
+ }
741
755
  public async fleetStatus(id: string, ownerToken: string, signal?: AbortSignal, ticketKey?: string): Promise<IFleetOperation> {
742
756
  return this.dispatchAfterHandshake('agl.mcp.fleet.status', { id, ownerToken, ...(ticketKey ? { ticketKey } : {}) }, signal, false);
743
757
  }
@@ -916,7 +930,8 @@ export class ControllerMcpClient {
916
930
  || decoded.method !== methodArg
917
931
  || !plugins.util.isDeepStrictEqual(
918
932
  decoded.request,
919
- (methodArg.startsWith('agl.mcp.configuration.') || methodArg.startsWith('agl.mcp.ticket.') || methodArg.startsWith('agl.mcp.fleet.'))
933
+ (methodArg.startsWith('agl.mcp.configuration.') || methodArg.startsWith('agl.mcp.ticket.') || methodArg.startsWith('agl.mcp.fleet.')
934
+ || methodArg.startsWith('agl.mcp.deploy.'))
920
935
  ? { ...requestArg, ...(Object.hasOwn(requestArg, 'ownerToken') ? { ownerToken: '[redacted]' } : {}),
921
936
  ...(methodArg === 'agl.mcp.configuration.master.save' ? { masterJson: '[redacted]' } : {}) }
922
937
  : requestArg,
@@ -29,6 +29,8 @@ import { controllerMcpFleetMethods, type TControllerMcpFleetTypedRequest } from
29
29
  import type { IFleetOperation } from '../ts_interfaces/fleet.js';
30
30
  import { controllerMcpTicketMethods, type TControllerMcpTicketTypedRequest } from '../ts_interfaces/requests.tickets.js';
31
31
  import type { IReq_ControllerMcpSessionFeedAcknowledge, IReq_ControllerMcpSessionFeedList } from '../ts_interfaces/sessionfeed.js';
32
+ import { controllerMcpDeployMethods, type TControllerMcpDeployMethod, type TControllerMcpDeployTypedRequest } from '../ts_interfaces/deployments.js';
33
+ import { deployErrorCodes } from './fleet/classes.deploymonitor.js';
32
34
  import { readTicketRevisionConflict, ticketErrorMessages, type TTicketOperation, type TTicketRequest, type TTicketResponse } from '../ts_interfaces/tickets.js';
33
35
  import { ticketOperation } from './functions.ticketvalidation.js';
34
36
  import { controllerFailureJournal } from './classes.failurejournal.js';
@@ -88,6 +90,8 @@ import {
88
90
  export interface IControllerMcpPrivateApi {
89
91
  fleetWorkers?: (method: string, request: Record<string, unknown>, signal: AbortSignal) => Promise<TFleetWorkerResponse<TFleetWorkerAction>>;
90
92
  fleet?: (method: string, request: Record<string, unknown>, signal: AbortSignal) => Promise<IFleetOperation>;
93
+ /** Deploy status, history, a probe now and release state for the local owner (`agl deploy`, `agl release status`). */
94
+ deploy?: (method: TControllerMcpDeployMethod, request: Record<string, unknown>, signal: AbortSignal) => Promise<unknown>;
91
95
  /** The session feed for the local owner; each call verifies the owner capability it carries. */
92
96
  sessionFeed?: {
93
97
  list(request: IReq_ControllerMcpSessionFeedList['request'], signal: AbortSignal): Promise<IReq_ControllerMcpSessionFeedList['response']>;
@@ -238,7 +242,7 @@ class ControllerMcpBoundedTypedRouter extends plugins.typedrequest.TypedRouter {
238
242
  // returned the `{}` the client sent (an error, a handler that returns nothing), so the host restores it here.
239
243
  if (response.response === null) (response as plugins.typedrequestInterfaces.ITypedRequest).response = {};
240
244
  if (typeof response.method === 'string' && (response.method.startsWith('agl.mcp.configuration.')
241
- || response.method.startsWith('agl.mcp.ticket.') || response.method.startsWith('agl.mcp.fleet.'))) {
245
+ || response.method.startsWith('agl.mcp.ticket.') || response.method.startsWith('agl.mcp.fleet.') || response.method.startsWith('agl.mcp.deploy.'))) {
242
246
  // TypedRequest normally echoes the request. The owner capability must not travel back in
243
247
  // that echo, including on rejected operations.
244
248
  const request = response.request as Record<string, unknown>;
@@ -292,6 +296,9 @@ const safeTypedResponseError = (
292
296
  if (methodArg.startsWith('agl.mcp.configuration.') && (configurationErrorCodes as readonly unknown[]).includes(code)) {
293
297
  return new plugins.typedrequest.TypedResponseError(errorArg.message, { code });
294
298
  }
299
+ if (methodArg.startsWith('agl.mcp.deploy.') && (deployErrorCodes as readonly unknown[]).includes(code)) {
300
+ return new plugins.typedrequest.TypedResponseError(errorArg.message.slice(0, 1024), { code });
301
+ }
295
302
  if (typeof code === 'string' && /^[a-z0-9_]{1,64}$/.test(code)) {
296
303
  const messages: Record<string, string> = {
297
304
  ...ticketErrorMessages,
@@ -388,7 +395,9 @@ export class ControllerMcpHost {
388
395
  port: 0,
389
396
  listenHostname: '127.0.0.1',
390
397
  cors: false,
391
- connectionTimeout: 30_000,
398
+ // A local deploy CLI may legitimately wait up to two minutes for joined Git/probe reads.
399
+ // Body and header admission stay short; each caller still owns its request deadline.
400
+ connectionTimeout: 125_000,
392
401
  headersTimeout: 5_000,
393
402
  requestTimeout: 30_000,
394
403
  cleanupTimeoutMs: 5_000,
@@ -664,6 +673,13 @@ export class ControllerMcpHost {
664
673
  return this.options.api.fleet(method, request as unknown as Record<string, unknown>, tools?.abortSignal ?? new AbortController().signal);
665
674
  })));
666
675
  }
676
+ for (const method of controllerMcpDeployMethods) {
677
+ routerArg.addTypedHandler(new plugins.typedrequest.TypedHandler<TControllerMcpDeployTypedRequest>(method,
678
+ async (request, tools) => run(method, async () => {
679
+ if (!this.options.api.deploy) throw new Error('Deploy API is unavailable.');
680
+ return this.options.api.deploy(method, request as unknown as Record<string, unknown>, tools?.abortSignal ?? new AbortController().signal) as never;
681
+ })));
682
+ }
667
683
  routerArg.addTypedHandler(new plugins.typedrequest.TypedHandler<IReq_ControllerMcpSessionFeedList>(
668
684
  'agl.mcp.sessionfeed.list', async (requestArg, toolsArg) => run('agl.mcp.sessionfeed.list', async () => {
669
685
  if (!this.options.api.sessionFeed) throw new Error('Session feed API is unavailable.');
@@ -23,6 +23,7 @@ import type { IAglMcpUpgradeRefusal, IAglMcpUpgradeRequest } from './classes.mcp
23
23
  import { jobToolDefinitions, jobWaitToolDefinition, waitForJob } from './functions.mcpjobtools.js';
24
24
  import { ticketToolDefinitions } from './functions.mcptickettools.js';
25
25
  import { fleetToolDefinitions } from './functions.mcpfleettools.js';
26
+ import { deployToolDefinitions } from './functions.mcpdeploytools.js';
26
27
  import { withLocalConfigurationOwner } from './functions.configurationowner.js';
27
28
  import { McpWorkerCaller, workerCallerEnrollmentToolName } from './classes.mcpworkercaller.js';
28
29
  import { ticketClientErrorMessages } from '../ts_interfaces/tickets.js';
@@ -70,6 +71,7 @@ export const aglMcpToolNames = [
70
71
  'ticket_comment',
71
72
  'ticket_link',
72
73
  'ticket_question_ask',
74
+ 'ticket_unlink',
73
75
  'fleet_land',
74
76
  'fleet_release',
75
77
  'fleet_tooling',
@@ -90,6 +92,10 @@ export const aglMcpToolNames = [
90
92
  'fleet_worker_status',
91
93
  'fleet_watch',
92
94
  'fleet_worker_native_message',
95
+ 'deploy_status',
96
+ 'deploy_history',
97
+ 'deploy_probe',
98
+ 'release_status',
93
99
  ] as const;
94
100
 
95
101
  interface IAglMcpToolResult {
@@ -123,7 +129,7 @@ export interface IAglMcpToolsOptions {
123
129
  | 'messageSession'
124
130
  | 'readSessionScratchpad'
125
131
  | 'updateSessionScratchpad'
126
- > & Partial<Pick<ControllerMcpClient, 'ticket' | 'fleet' | 'fleetStart' | 'fleetStatus' | 'fleetWorker'>>;
132
+ > & Partial<Pick<ControllerMcpClient, 'ticket' | 'fleet' | 'fleetStart' | 'fleetStatus' | 'fleetWorker' | 'deploy'>>;
127
133
  }
128
134
 
129
135
  const maximumIdentifierBytes = 1024;
@@ -356,7 +362,7 @@ export class AglMcpTools {
356
362
  | 'messageSession'
357
363
  | 'readSessionScratchpad'
358
364
  | 'updateSessionScratchpad'
359
- > & Partial<Pick<ControllerMcpClient, 'ticket' | 'fleet' | 'fleetStart' | 'fleetStatus' | 'fleetWorker'>>;
365
+ > & Partial<Pick<ControllerMcpClient, 'ticket' | 'fleet' | 'fleetStart' | 'fleetStatus' | 'fleetWorker' | 'deploy'>>;
360
366
  private readonly withFleetOwner: <T>(operation: (token: string) => Promise<T>) => Promise<T>;
361
367
  private readonly onControllerUpgraded?: IAglMcpToolsOptions['onControllerUpgraded'];
362
368
  private readonly workerCaller?: McpWorkerCaller;
@@ -598,6 +604,7 @@ export class AglMcpTools {
598
604
  this.registerTicketTools(serverArg, registeredTools);
599
605
  this.registerFleetTools(serverArg, registeredTools);
600
606
  this.registerFleetWorkerTools(serverArg, registeredTools);
607
+ this.registerDeployTools(serverArg, registeredTools);
601
608
  } catch (errorArg) {
602
609
  const failedTools: plugins.RegisteredTool[] = [];
603
610
  const rollbackErrors: unknown[] = [];
@@ -667,6 +674,18 @@ export class AglMcpTools {
667
674
  }
668
675
  }
669
676
 
677
+ private registerDeployTools(server: InstanceType<typeof plugins.McpServer>, registered: plugins.RegisteredTool[]): void {
678
+ for (const definition of deployToolDefinitions) {
679
+ registered.push(server.registerTool<plugins.z.ZodType, plugins.z.ZodType>(definition.name, {
680
+ description: definition.description, inputSchema: definition.inputSchema,
681
+ annotations: { readOnlyHint: definition.readOnly, destructiveHint: false, openWorldHint: true },
682
+ }, async (input, extra) => this.runToolCall(extra, async () => this.withFleetOwner(async (ownerToken) => {
683
+ if (!this.client.deploy) throw new Error('Deploy API is unavailable.');
684
+ return this.client.deploy(definition.operation, { ...input as Record<string, unknown>, ownerToken } as never, extra.signal);
685
+ }))));
686
+ }
687
+ }
688
+
670
689
  private registerJobTools(
671
690
  serverArg: InstanceType<typeof plugins.McpServer>,
672
691
  registeredToolsArg: plugins.RegisteredTool[],
@@ -27,6 +27,7 @@ import * as plugins from './plugins.js';
27
27
  import { assertMcpTicketRequest } from './functions.ticketvalidation.js';
28
28
  import { assertFleetWireRequest } from './fleet/functions.validation.js';
29
29
  import { assertSessionFeedWireRequest } from './functions.sessionfeedvalidation.js';
30
+ import { assertFleetDeployWireRequest } from './fleet/functions.deployvalidation.js';
30
31
 
31
32
  const maximumIdBytes = 1024;
32
33
  const maximumModelPartBytes = 512;
@@ -142,6 +143,7 @@ const assertMethodRequest = (
142
143
  if (methodArg === 'agl.mcp.sessionfeed.list' || methodArg === 'agl.mcp.sessionfeed.acknowledge') {
143
144
  return assertSessionFeedWireRequest(methodArg, requestArg);
144
145
  }
146
+ if (methodArg.startsWith('agl.mcp.deploy.')) return assertFleetDeployWireRequest(methodArg, requestArg);
145
147
  if (methodArg.startsWith('agl.mcp.configuration.')) {
146
148
  // The authority validates the master document itself; this admits the request's shape.
147
149
  const required: Partial<Record<TControllerMcpMethod, string[]>> = {