@integrity-labs/agt-cli 0.27.167 → 0.27.169

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.
package/dist/bin/agt.js CHANGED
@@ -33,7 +33,7 @@ import {
33
33
  success,
34
34
  table,
35
35
  warn
36
- } from "../chunk-IU32SVV7.js";
36
+ } from "../chunk-4DWE64OJ.js";
37
37
  import {
38
38
  CHANNEL_REGISTRY,
39
39
  DEPLOYMENT_TEMPLATES,
@@ -60,7 +60,7 @@ import {
60
60
  renderTemplate,
61
61
  resolveChannels,
62
62
  serializeManifestForSlackCli
63
- } from "../chunk-3A2H4ZLD.js";
63
+ } from "../chunk-L2UTBXZS.js";
64
64
 
65
65
  // src/bin/agt.ts
66
66
  import { join as join21 } from "path";
@@ -5019,7 +5019,7 @@ import { execFileSync, execSync } from "child_process";
5019
5019
  import { existsSync as existsSync10, realpathSync as realpathSync2 } from "fs";
5020
5020
  import chalk18 from "chalk";
5021
5021
  import ora16 from "ora";
5022
- var cliVersion = true ? "0.27.167" : "dev";
5022
+ var cliVersion = true ? "0.27.169" : "dev";
5023
5023
  async function fetchLatestVersion() {
5024
5024
  const host2 = getHost();
5025
5025
  if (!host2) return null;
@@ -5942,7 +5942,7 @@ function handleError(err) {
5942
5942
  }
5943
5943
 
5944
5944
  // src/bin/agt.ts
5945
- var cliVersion2 = true ? "0.27.167" : "dev";
5945
+ var cliVersion2 = true ? "0.27.169" : "dev";
5946
5946
  var program = new Command();
5947
5947
  program.name("agt").description("Augmented CLI \u2014 agent provisioning and management").version(cliVersion2).option("--json", "Emit machine-readable JSON output (suppress spinners and colors)").option("--skip-update-check", "Skip the automatic update check on startup");
5948
5948
  program.hook("preAction", async (thisCommand, actionCommand) => {
@@ -14,7 +14,7 @@ import {
14
14
  registerFramework,
15
15
  resolveAvatarEnvUrl,
16
16
  wrapScheduledTaskPrompt
17
- } from "./chunk-3A2H4ZLD.js";
17
+ } from "./chunk-L2UTBXZS.js";
18
18
 
19
19
  // ../../packages/core/dist/integrations/registry.js
20
20
  var INTEGRATION_REGISTRY = [
@@ -3390,32 +3390,43 @@ acknowledge before you start.
3390
3390
  - **FAST (< 60s):** handle inline. Reply via the channel tool
3391
3391
  (slack.reply / telegram.reply / directchat.reply) and end your turn.
3392
3392
 
3393
- - **SLOW (\u2265 60s):** acknowledge first, then handle inline.
3393
+ - **SLOW (\u2265 60s):** acknowledge, dispatch to background, stay responsive.
3394
3394
  1. Send a one-line acknowledgement via the channel tool \u2014 short, warm,
3395
3395
  and tell the user you'll come back. Example shape (don't copy verbatim,
3396
3396
  match your voice): "On it \u2014 this'll take a minute or two, I'll ping
3397
3397
  when it's done."
3398
- 2. Do the work yourself in this same session. Use whatever tools you
3399
- need (MCP, skills, file reads, etc.) \u2014 your parent session has the
3400
- full MCP surface bound.
3401
- 3. Reply with the result via the channel tool (\`slack.reply\` /
3402
- \`telegram.reply\` / \`directchat.reply\`), addressing the same thread
3403
- / chat / conversation you acknowledged in step 1.
3404
-
3405
- > **Why inline and not sub-agent dispatch right now:** there is an
3406
- > upstream Claude Code bug
3407
- > ([anthropics/claude-code#64909](https://github.com/anthropics/claude-code/issues/64909))
3408
- > where sub-agents dispatched via the Task tool with an explicit
3409
- > \`tools:\` allowlist (which is the shape \`channel-message-handler\`
3410
- > uses) get an **empty MCP tool registry** \u2014 every \`mcp__*\` call
3411
- > returns "No such tool available", including the channel reply tools.
3412
- > Dispatching a slow channel reply to \`channel-message-handler\` will
3413
- > therefore silently fail to land: you'd post the one-line ack, the
3414
- > sub-agent would do the analysis fine, but its \`slack.reply\` call
3415
- > would error and the user would never see the substantive reply.
3416
- > Empirically confirmed 2026-06-03 with a 6-tool probe: 0/6 MCP tools
3417
- > bound inside \`channel-message-handler\`. Until Anthropic ships the
3418
- > fix, handling slow channel replies inline is the only working path.
3398
+ 2. Dispatch the work to a background sub-agent: the Agent tool with
3399
+ \`subagent_type: general-purpose\` AND \`run_in_background: true\`.
3400
+ Put EVERYTHING the worker needs in the dispatch prompt \u2014 the user's
3401
+ full request, relevant thread context, which integrations/tools to
3402
+ use, and the exact shape of result you want back. The worker inherits
3403
+ your full MCP tool surface but NOT your conversation context.
3404
+ 3. End your turn after dispatching. This is the point: you stay free to
3405
+ answer other messages while the worker grinds. Do NOT wait, poll, or
3406
+ dispatch the same work synchronously \u2014 a synchronous dispatch blocks
3407
+ your turn and defeats the purpose.
3408
+ 4. When the worker's completion notification arrives (it lands
3409
+ automatically as a system message), read its result and reply via the
3410
+ channel tool (\`slack.reply\` / \`telegram.reply\` / \`directchat.reply\`)
3411
+ to the same thread / chat / conversation you acknowledged in step 1.
3412
+ **You post the substantive reply \u2014 the worker has no channel tools.**
3413
+ 5. If the completion notification reports a failure or an unusable
3414
+ result, tell the user what happened and either re-dispatch with a
3415
+ better prompt or handle it inline \u2014 never go silent.
3416
+
3417
+ > **Why background dispatch (and why \`general-purpose\`):** validated
3418
+ > 2026-06-10 on Claude Code 2.1.170 (ENG-6274 spike,
3419
+ > \`docs/spikes/ENG-6274-run-in-background-dispatch.md\`): background
3420
+ > dispatch returns immediately, your turn ends, inbound messages get
3421
+ > answered in seconds while the worker runs, and the completion arrives
3422
+ > as a notification you handle like any other turn. Use
3423
+ > \`subagent_type: general-purpose\` (inherit-all tools) \u2014 NOT
3424
+ > \`channel-message-handler\` or \`augmented-worker\` \u2014 until ENG-6273
3425
+ > re-verifies on this host that the upstream allowlist bug
3426
+ > ([anthropics/claude-code#64909](https://github.com/anthropics/claude-code/issues/64909),
3427
+ > empirically 0/6 MCP tools in named sub-agents on 2026-06-03) is fixed
3428
+ > at the fleet's pinned Claude Code version. \`general-purpose\` escapes
3429
+ > that bug by construction either way.
3419
3430
 
3420
3431
  **Why this triage decision still matters more than any other instruction
3421
3432
  below:** if you skip the acknowledgement and just dive into slow work
@@ -3437,25 +3448,29 @@ For background tool work that **isn't** a channel reply \u2014 multi-step data
3437
3448
  pulls, CRM enrichments, research workflows, cross-MCP orchestration \u2014 use
3438
3449
  \`subagent_type: general-purpose\` (Anthropic's built-in). It inherits the
3439
3450
  full MCP tool surface from this session and reliably binds every
3440
- \`mcp__*\` server you have available.
3451
+ \`mcp__*\` server you have available. For anything expected to take more
3452
+ than a minute, add \`run_in_background: true\` so your turn ends and you
3453
+ stay responsive; the completion notification brings you the result.
3454
+ Don't background-dispatch trivial work \u2014 each dispatch is a fresh
3455
+ context and costs real tokens.
3441
3456
 
3442
3457
  **Why not \`augmented-worker\` for now:** there is an upstream Claude Code
3443
3458
  bug ([anthropics/claude-code#64909](https://github.com/anthropics/claude-code/issues/64909))
3444
3459
  where sub-agents with an explicit \`tools:\` allowlist get an empty MCP
3445
3460
  tool registry \u2014 every \`mcp__*\` call returns "No such tool available."
3446
3461
  \`general-purpose\` uses \`tools: *\` (inherit-all) and escapes the bug.
3447
- Once Anthropic ships the fix, \`augmented-worker\` becomes preferred again
3448
- (restricted tool surface for safety + working MCP binding); the dispatch
3449
- recommendation here will flip back automatically.
3462
+ The fix appears to have shipped upstream (verified locally on Claude Code
3463
+ 2.1.170, 2026-06-10 \u2014 ENG-6269 spike); once ENG-6273 re-verifies it on
3464
+ this host's pinned version, \`augmented-worker\` becomes preferred again
3465
+ (restricted tool surface for safety + working MCP binding) and
3466
+ \`channel-message-handler\` returns as a dispatch target. Until then,
3467
+ \`general-purpose\` only.
3450
3468
 
3451
3469
  For slow **channel** replies, see \xA7 FIRST ACTION above \u2014 those are
3452
- currently handled inline (not dispatched) because \`channel-message-handler\`
3453
- shares the explicit-allowlist shape and so suffers the same upstream
3454
- bug. Empirically confirmed 2026-06-03 on agt-aws-1 with a 6-tool probe:
3455
- 0/6 MCP tools bound inside \`channel-message-handler\` (matching the
3456
- \`augmented-worker\` result). When Anthropic ships the upstream fix, both
3457
- named sub-agents will work again and the FIRST ACTION triage will switch
3458
- back to dispatch.
3470
+ dispatched as background \`general-purpose\` workers and **you** post the
3471
+ result back to the channel when the completion notification arrives
3472
+ (\`channel-message-handler\` is not yet the dispatch target for the same
3473
+ ENG-6273-pending reason).
3459
3474
 
3460
3475
  ${activeTasksSection}${personalitySection}## Identity
3461
3476
 
@@ -8222,4 +8237,4 @@ export {
8222
8237
  managerInstallSystemUnitCommand,
8223
8238
  managerUninstallSystemUnitCommand
8224
8239
  };
8225
- //# sourceMappingURL=chunk-IU32SVV7.js.map
8240
+ //# sourceMappingURL=chunk-4DWE64OJ.js.map