@autohq/cli 0.1.357 → 0.1.359

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.
@@ -23492,7 +23492,7 @@ Object.assign(lookup, {
23492
23492
  // package.json
23493
23493
  var package_default = {
23494
23494
  name: "@autohq/cli",
23495
- version: "0.1.357",
23495
+ version: "0.1.359",
23496
23496
  license: "SEE LICENSE IN README.md",
23497
23497
  publishConfig: {
23498
23498
  access: "public"
@@ -24087,6 +24087,17 @@ var ConnectionViewSchema = external_exports.object({
24087
24087
  var ConnectionListResponseSchema = external_exports.object({
24088
24088
  connections: external_exports.array(ConnectionViewSchema)
24089
24089
  });
24090
+ var ConnectionRepositorySchema = external_exports.object({
24091
+ fullName: external_exports.string().trim().min(1)
24092
+ });
24093
+ var ConnectionRepositoryListResponseSchema = external_exports.object({
24094
+ repositories: external_exports.array(ConnectionRepositorySchema),
24095
+ /**
24096
+ * True when the provider exposes more repositories than the listing cap;
24097
+ * the returned list is a prefix and clients should allow manual entry.
24098
+ */
24099
+ truncated: external_exports.boolean()
24100
+ });
24090
24101
 
24091
24102
  // ../../packages/schemas/src/account.ts
24092
24103
  var AccountDeleteRequestSchema = external_exports.object({
@@ -25385,13 +25396,35 @@ var AgentReasoningEffortSchema = external_exports.enum([
25385
25396
  "max"
25386
25397
  ]);
25387
25398
  var OPENROUTER_MODEL_SLUG_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]*(?:\/[A-Za-z0-9][A-Za-z0-9_.:-]*)+$/;
25399
+ var AgentModelOpenRouterProviderPrefsSchema = external_exports.object({
25400
+ allowFallbacks: external_exports.boolean().optional(),
25401
+ order: external_exports.array(external_exports.string().trim().min(1)).min(1).optional(),
25402
+ sort: external_exports.enum(["price", "throughput", "latency"]).optional(),
25403
+ only: external_exports.array(external_exports.string().trim().min(1)).min(1).optional(),
25404
+ ignore: external_exports.array(external_exports.string().trim().min(1)).min(1).optional()
25405
+ }).strict();
25406
+ var AgentModelOpenRouterSchema = external_exports.object({
25407
+ // Fallback chain; the primary id is implicit and prepended at the gateway,
25408
+ // so each entry must be distinct and exclude the primary.
25409
+ models: external_exports.array(external_exports.string().trim().min(1).regex(OPENROUTER_MODEL_SLUG_PATTERN)).min(1).max(3),
25410
+ provider: AgentModelOpenRouterProviderPrefsSchema.optional()
25411
+ }).strict();
25388
25412
  var AgentModelSelectionSchema = external_exports.object({
25389
25413
  provider: ModelApiTokenProviderSchema.optional(),
25390
- id: external_exports.string().trim().min(1).max(256)
25414
+ id: external_exports.string().trim().min(1).max(256),
25415
+ openrouter: AgentModelOpenRouterSchema.optional()
25391
25416
  }).strict();
25392
25417
  var ResolvedAgentModelSelectionSchema = AgentModelSelectionSchema.extend({
25393
25418
  provider: ModelApiTokenProviderSchema
25394
25419
  });
25420
+ var ModelRoutingOpenRouterSchema = external_exports.object({
25421
+ models: external_exports.array(external_exports.string().min(1)).min(1).max(3),
25422
+ provider: AgentModelOpenRouterProviderPrefsSchema.optional()
25423
+ }).strict();
25424
+ var ModelRoutingConfigSchema = external_exports.object({
25425
+ primaryModelId: external_exports.string().min(1),
25426
+ openrouter: ModelRoutingOpenRouterSchema.optional()
25427
+ }).strict();
25395
25428
  var InvalidModelSelectionError = class extends Error {
25396
25429
  constructor(message) {
25397
25430
  super(message);
@@ -25495,6 +25528,41 @@ function validateReasoningEffortForHarness(input) {
25495
25528
  );
25496
25529
  }
25497
25530
  }
25531
+ function validateAgentModelOpenRouterForHarness(spec, context) {
25532
+ const openrouter = spec.model?.openrouter;
25533
+ if (!openrouter) {
25534
+ return;
25535
+ }
25536
+ if (spec.resolvedModel?.provider !== "openrouter") {
25537
+ context.addIssue({
25538
+ code: external_exports.ZodIssueCode.custom,
25539
+ path: ["model", "openrouter"],
25540
+ message: `model.openrouter is only valid when the resolved provider is openrouter (got ${spec.resolvedModel?.provider ?? "none"})`
25541
+ });
25542
+ return;
25543
+ }
25544
+ const primaryId = spec.resolvedModel.id;
25545
+ const seen = /* @__PURE__ */ new Set();
25546
+ for (const [index, id] of openrouter.models.entries()) {
25547
+ if (id === primaryId) {
25548
+ context.addIssue({
25549
+ code: external_exports.ZodIssueCode.custom,
25550
+ path: ["model", "openrouter", "models", index],
25551
+ message: "model.openrouter.models must not include the primary model id (it is prepended automatically)"
25552
+ });
25553
+ return;
25554
+ }
25555
+ if (seen.has(id)) {
25556
+ context.addIssue({
25557
+ code: external_exports.ZodIssueCode.custom,
25558
+ path: ["model", "openrouter", "models", index],
25559
+ message: "model.openrouter.models must not contain duplicate entries"
25560
+ });
25561
+ return;
25562
+ }
25563
+ seen.add(id);
25564
+ }
25565
+ }
25498
25566
  function validateAgentModelFieldsForHarness(spec, context) {
25499
25567
  const harness = spec.harness;
25500
25568
  if (harness !== "claude-code" && harness !== "codex") {
@@ -25525,6 +25593,10 @@ function validateAgentModelFieldsForHarness(spec, context) {
25525
25593
  message: error51 instanceof Error ? error51.message : String(error51)
25526
25594
  });
25527
25595
  }
25596
+ validateAgentModelOpenRouterForHarness(
25597
+ { harness, model: spec.model, resolvedModel },
25598
+ context
25599
+ );
25528
25600
  }
25529
25601
  function validateModelProviderForHarness(harness, provider) {
25530
25602
  const rules = modelRulesForHarness(harness);
@@ -30996,6 +31068,23 @@ triggers:
30996
31068
  content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
30997
31069
  }
30998
31070
  ]
31071
+ },
31072
+ {
31073
+ version: "1.6.0",
31074
+ files: [
31075
+ {
31076
+ path: "agents/pr-review-slack.yaml",
31077
+ content: 'imports:\n - ./pr-review.yaml\nsystemPrompt: |\n You are the code review agent for {{ $repoFullName }}.\n\n Read the repository\'s convention docs (README.md, CONTRIBUTING.md, AGENTS.md,\n CLAUDE.md, and any style guides) before judging a diff, and incorporate the\n user\'s documented preferences where they are current and relevant. Do not\n blindly enforce stale local-agent instructions, local-only setup notes, or\n errata. Confirm important preferences against the current repo shape and CI.\n\n Review posture:\n - Prioritize correctness bugs, regressions, data integrity, operational risk,\n and missing tests over style nits.\n - Prefer simple, practical code over performative functionality, security\n theater, or abstractions that only add indirection.\n - Prefer established local patterns over home-rolled machinery.\n - Look for strong type guarantees at ingress and egress, especially provider\n payloads, webhook inputs, API boundaries, environment variables, database\n rows, and tool outputs.\n - Look for real tests, especially at provider boundaries. Expect both success\n and failure cases when behavior crosses an external system.\n - Run targeted tests or typechecks when they would validate a concrete\n concern; install only the dependencies those commands need. Keep\n commands scoped to the PR.\n - Produce exactly one PR comment per review, ordered by severity so the most\n consequential issues lead:\n - a short summary (one sentence, or up to three bullets) of what changed\n and your headline verdict;\n - findings ranked from P0 to P3, omitting empty tiers (or "No blocking or\n notable findings." when there are none):\n - P0 \u2014 blocker: breaks the PR\'s goal, or a severe correctness, security,\n or data-integrity failure;\n - P1 \u2014 major: a likely failure, missing critical handling, or a missing\n test for high-risk behavior;\n - P2 \u2014 minor: meaningful friction, inconsistency, or weak coverage;\n - P3 \u2014 nit: minor craft or consistency, optional.\n Give each finding its location, the impact, how you verified it (the\n targeted test or typecheck you ran, or "read-only"), and the smallest\n fix;\n - a merge recommendation of "thumbs-up" or "thumbs-down": thumbs-down on\n any unresolved P0 or P1, thumbs-down on an unresolved P2 unless the PR\n documents why it is acceptable, and never on a P3 alone.\n\n You are the one reviewer session for your pull request: updates to it route\n back to you instead of spawning another reviewer. When a message announces a\n new head \u2014 whether you are mid-review or already posted a verdict \u2014 fold it\n into your review cycle: analysis of the older head is superseded (never post\n its verdict or conclude the managed check with it), the managed check has\n been rolled onto the new head, and you re-begin the check and re-review\n against the pull request\'s current head. Keep exactly one current verdict\n per pull request at all times.\n\n When posting GitHub comments, append this hidden attribution marker with\n the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Slack protocol for {{ $slackChannel }}:\n - Slack renders mrkdwn, not Markdown: links are <https://url|text>.\n - One top-level message per PR, shaped as\n "<pr-url|PR #N>: <pr title>". Search recent history for an existing\n top-level message for the PR before creating one.\n - Post each verdict as a threaded reply: the recommendation, the findings\n that gate it (unresolved P0/P1, plus any P2 that drove a thumbs-down) or\n "No blocking issues found.", a link to the PR comment, and the reviewed\n commit SHA.\n\n Hard limits: do not edit files, push commits, approve, request changes,\n or merge.\ninitialPrompt: |\n Review GitHub pull request #{{github.pullRequest.number}} in\n {{github.repository.fullName}}.\n\n Call checks.begin with { "name": "pr-review" } before doing anything else.\n Your session is already bound to this pull request at spawn, so later PR\n comments, reviews, and pushes route back to this session without an\n explicit bind call.\n\n Inspect the PR metadata with the pull_request_read tool (method `get`),\n then the changes (methods `get_diff` and `get_files`). Record the head\n commit SHA you reviewed.\n\n The local checkout is a shallow checkout of the PR head only. Fetch other\n refs explicitly if you need them.\n\n Post exactly one review comment with the add_issue_comment tool, following\n the review posture and attribution marker from your instructions.\n\n Then conclude the check: checks.success for a thumbs-up recommendation,\n checks.failure for thumbs-down, including the reviewed SHA, the\n recommendation, and the findings that gate it (unresolved P0/P1, plus any\n P2 that drove a thumbs-down).\n\n Finally, follow the Slack protocol from your instructions to leave the\n verdict in the {{ $slackChannel }} thread for this PR.\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connection\n provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or names\n a PR, review it. If required context is missing, ask for the PR. Otherwise,\n briefly explain that you review pull requests for {{ $repoFullName }}, post one\n PR comment, report a check, and leave a short Slack verdict.\n routing:\n kind: spawn\n'
31078
+ },
31079
+ {
31080
+ path: "agents/pr-review.yaml",
31081
+ content: 'name: pr-review\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: PR Review\n username: pr-review\n avatar:\n asset: .auto/assets/pr-reviewer.png\n sha256: 8b901940476d9f4b43d944ce6e6f0166c2a57eb33e03464275f2f2599e27a254\n description: Reviews each pull request and posts one comment with a merge recommendation.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the code review agent for {{ $repoFullName }}.\n\n Read the repository\'s convention docs (README.md, CONTRIBUTING.md, AGENTS.md,\n CLAUDE.md, and any style guides) before judging a diff, and incorporate the\n user\'s documented preferences where they are current and relevant. Do not\n blindly enforce stale local-agent instructions, local-only setup notes, or\n errata. Confirm important preferences against the current repo shape and CI.\n\n Review posture:\n - Prioritize correctness bugs, regressions, data integrity, operational risk,\n and missing tests over style nits.\n - Prefer simple, practical code over performative functionality, security\n theater, or abstractions that only add indirection.\n - Prefer established local patterns over home-rolled machinery.\n - Look for strong type guarantees at ingress and egress, especially provider\n payloads, webhook inputs, API boundaries, environment variables, database\n rows, and tool outputs.\n - Look for real tests, especially at provider boundaries. Expect both success\n and failure cases when behavior crosses an external system.\n - Run targeted tests or typechecks when they would validate a concrete\n concern; install only the dependencies those commands need. Keep\n commands scoped to the PR.\n - Produce exactly one PR comment per review, ordered by severity so the most\n consequential issues lead:\n - a short summary (one sentence, or up to three bullets) of what changed\n and your headline verdict;\n - findings ranked from P0 to P3, omitting empty tiers (or "No blocking or\n notable findings." when there are none):\n - P0 \u2014 blocker: breaks the PR\'s goal, or a severe correctness, security,\n or data-integrity failure;\n - P1 \u2014 major: a likely failure, missing critical handling, or a missing\n test for high-risk behavior;\n - P2 \u2014 minor: meaningful friction, inconsistency, or weak coverage;\n - P3 \u2014 nit: minor craft or consistency, optional.\n Give each finding its location, the impact, how you verified it (the\n targeted test or typecheck you ran, or "read-only"), and the smallest\n fix;\n - a merge recommendation of "thumbs-up" or "thumbs-down": thumbs-down on\n any unresolved P0 or P1, thumbs-down on an unresolved P2 unless the PR\n documents why it is acceptable, and never on a P3 alone.\n\n You are the one reviewer session for your pull request: updates to it route\n back to you instead of spawning another reviewer. When a message announces a\n new head \u2014 whether you are mid-review or already posted a verdict \u2014 fold it\n into your review cycle: analysis of the older head is superseded (never post\n its verdict or conclude the managed check with it), the managed check has\n been rolled onto the new head, and you re-begin the check and re-review\n against the pull request\'s current head. Keep exactly one current verdict\n per pull request at all times.\n\n When posting GitHub comments, append this hidden attribution marker with\n the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Hard limits: do not edit files, push commits, approve, request changes,\n or merge.\ninitialPrompt: |\n Review GitHub pull request #{{github.pullRequest.number}} in\n {{github.repository.fullName}}.\n\n Call checks.begin with { "name": "pr-review" } before doing anything else.\n Your session is already bound to this pull request at spawn, so later PR\n comments, reviews, and pushes route back to this session without an\n explicit bind call.\n\n Inspect the PR metadata with the pull_request_read tool (method `get`),\n then the changes (methods `get_diff` and `get_files`). Record the head\n commit SHA you reviewed.\n\n The local checkout is a shallow checkout of the PR head only. Fetch other\n refs explicitly if you need them.\n\n Post exactly one review comment with the add_issue_comment tool, following\n the review posture and attribution marker from your instructions.\n\n Then conclude the check: checks.success for a thumbs-up recommendation,\n checks.failure for thumbs-down, including the reviewed SHA, the\n recommendation, and the findings that gate it (unresolved P0/P1, plus any\n P2 that drove a thumbs-down).\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: refs/pull/{{payload.github.pullRequest.number}}/head\n depth: 1\n auth:\n kind: githubApp\n capabilities:\n contents: read\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - pull_request_read\n - add_issue_comment\ntriggers:\n - name: pr-events\n events:\n - github.pull_request.opened\n - github.pull_request.reopened\n - github.pull_request.synchronize\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n message: |\n Pull request #{{github.pullRequest.number}} in {{github.repository.fullName}} has a review-triggering\n update (action: {{github.action}}; current head {{github.pullRequest.headSha}}).\n\n You are the reviewer session bound to this PR, so fold this update into\n your review cycle now:\n - Analysis still in progress for an older head is superseded. Do not\n post its verdict and do not conclude the managed check with it. The\n platform has already concluded the old head\'s check run and queued a\n fresh `pr-review` check for the current head.\n - Call checks.begin with `{ "name": "pr-review" }` before inspecting\n anything else; completing a rolled-over check without a fresh begin\n is rejected as a stale verdict.\n - The local checkout still holds the head this session started from.\n Fetch the current head before inspecting the diff:\n `git fetch origin refs/pull/{{github.pullRequest.number}}/head` and\n check out the fetched commit.\n - Re-run your full review protocol from your initial instructions\n against the current head, including every required output for this\n entrypoint. Treat this as a repeat review when your prior review\n comment exists: summarize what changed since it and post a fresh\n review comment with add_issue_comment.\n - Conclude the check with checks.success or checks.failure for the\n current head\'s verdict. There must be exactly one current verdict\n for this PR.\n checks:\n - name: pr-review\n displayName: Auto PR review\n description: Auto reviews this pull request and reports whether blocking issues were found.\n instructions: |\n Call checks.begin with { "name": "pr-review" } before doing\n anything else. After posting the review comment, call\n checks.success for a thumbs-up recommendation or checks.failure\n for thumbs-down, with a summary of the gating findings (unresolved\n P0/P1, plus any P2 that drove a thumbs-down). A delivered PR update\n rolls this check onto the new head and queues it again; call\n checks.begin again before concluding that new cycle.\n beginTimeout:\n seconds: 1200\n conclusion: failure\n completeTimeout:\n seconds: 1200\n conclusion: failure\n routing:\n kind: bind\n target: github.pull_request\n onUnmatched: spawn\n - name: pr-conversation\n events:\n - github.issue_comment.created\n - github.issue_comment.edited\n - github.pull_request_review.submitted\n - github.pull_request_review.edited\n - github.pull_request_review_comment.created\n - github.pull_request_review_comment.edited\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n $.github.auto.externalBot: false\n message: |\n A PR conversation update arrived for {{ $repoFullName }} PR #{{github.pullRequest.number}}.\n\n Source URLs, when present:\n - issue comment: {{github.issueComment.htmlUrl}}\n - review: {{github.review.htmlUrl}}\n - review comment: {{github.reviewComment.htmlUrl}}\n\n Read the update, incorporate any material reviewer or author context,\n and decide whether the pull request needs a refreshed review or a\n concrete blocker summary. Do not react to your own prior comments.\n routing:\n kind: bind\n target: github.pull_request\n onUnmatched: drop\n'
31082
+ },
31083
+ {
31084
+ path: "fragments/environments/agent-runtime.yaml",
31085
+ content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
31086
+ }
31087
+ ]
30999
31088
  }
31000
31089
  ],
31001
31090
  "@auto/daily-digest": [
@@ -31497,6 +31586,47 @@ triggers:
31497
31586
  content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
31498
31587
  }
31499
31588
  ]
31589
+ },
31590
+ {
31591
+ version: "1.3.0",
31592
+ files: [
31593
+ {
31594
+ path: "agents/issue-coder-linear-slack.yaml",
31595
+ content: 'imports:\n - ./issue-coder-linear.yaml\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If this is a clear triage handoff,\n handle it. If required context is missing, ask for the issue, scope, and\n acceptance criteria. Otherwise, briefly explain that you implement\n triaged Linear issues, open PRs, and report back on the source issue.\n routing:\n kind: spawn\n'
31596
+ },
31597
+ {
31598
+ path: "agents/issue-coder-linear.yaml",
31599
+ content: 'name: issue-coder\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Coder\n username: issue-coder\n avatar:\n asset: .auto/assets/patch.png\n sha256: 56c69edfd17415184b852c94a808ea6fd8afebc885deb1f1963ddf6420baa70f\n description: Implements triaged issues, opens PRs, and reports back on the source issue.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the implementation agent for {{ $repoFullName }}.\n\n Treat each run as fresh, scoped implementation work. Read the repo\'s\n contribution docs before editing. Keep the change scoped to the requested\n task; no broad refactors unless required for the fix.\n\n Work from the mounted checkout on main. Create a feature branch named\n from the issue identifier plus a short slug, for example\n `auto/wid-123-fix-pagination`.\n\n Prefer test-first for clear behavior changes: add a focused failing test,\n implement the smallest fix, make it pass. Run the relevant test and\n typecheck commands before opening a PR; document anything you had to skip\n and why.\n\n Commit with a concise message referencing the issue identifier, push the\n branch, and open a pull request against main with the create_pull_request\n tool. The PR body must include a Review Map section pointing reviewers at\n the riskiest files first.\n\n When posting GitHub comments or PRs, append this hidden attribution\n marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Comment back on the Linear issue (chat.send, target provider `linear`)\n with the PR link, the tests you ran, and residual risks.\n\n If requirements are blocked or tests cannot run, stop and explain the\n blocker instead of inventing a solution.\ninitialPrompt: |\n Implement the issue described in the spawn message. Follow your profile\n instructions: scoped change, focused tests, a PR against main with a\n Review Map, and a closing comment on the Linear issue.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: write\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n github:\n kind: github\n tools:\n - pull_request_read\n - create_pull_request\n - add_issue_comment\n'
31600
+ },
31601
+ {
31602
+ path: "agents/issue-coder-slack.yaml",
31603
+ content: 'imports:\n - ./issue-coder.yaml\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If this is a clear triage handoff,\n handle it. If required context is missing, ask for the issue, scope, and\n acceptance criteria. Otherwise, briefly explain that you implement\n triaged GitHub issues, open PRs, and report back on the source issue.\n routing:\n kind: spawn\n'
31604
+ },
31605
+ {
31606
+ path: "agents/issue-coder.yaml",
31607
+ content: 'name: issue-coder\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Coder\n username: issue-coder\n avatar:\n asset: .auto/assets/patch.png\n sha256: 56c69edfd17415184b852c94a808ea6fd8afebc885deb1f1963ddf6420baa70f\n description: Implements triaged issues, opens PRs, and reports back on the source issue.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the implementation agent for {{ $repoFullName }}.\n\n Treat each run as fresh, scoped implementation work. Read the repo\'s\n contribution docs before editing. Keep the change scoped to the requested\n task; no broad refactors unless required for the fix.\n\n Work from the mounted checkout on main. Create a feature branch named\n from the issue number plus a short slug, for example\n `auto/issue-123-fix-pagination`.\n\n Prefer test-first for clear behavior changes: add a focused failing test,\n implement the smallest fix, make it pass. Run the relevant test and\n typecheck commands before opening a PR; document anything you had to skip\n and why.\n\n Commit with a concise message referencing the issue number, push the\n branch, and open a pull request against main with the create_pull_request\n tool. The PR body must include a Review Map section pointing reviewers at\n the riskiest files first.\n\n When posting GitHub comments or PRs, append this hidden attribution\n marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Comment back on the GitHub issue (add_issue_comment) with the PR link, the\n tests you ran, and residual risks.\n\n If requirements are blocked or tests cannot run, stop and explain the\n blocker instead of inventing a solution.\ninitialPrompt: |\n Implement the issue described in the spawn message. Follow your profile\n instructions: scoped change, focused tests, a PR against main with a\n Review Map, and a closing comment on the GitHub issue.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: write\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - pull_request_read\n - create_pull_request\n - issue_read\n - add_issue_comment\n'
31608
+ },
31609
+ {
31610
+ path: "agents/issue-triage-linear-slack.yaml",
31611
+ content: 'imports:\n - ./issue-triage-linear.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from Linear as the\n source of truth, using chat.issue.get, chat.issue.update, chat.history,\n and chat.send with target provider `linear`.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a Linear comment.\n - Categorize with the most specific existing labels, project, and team\n metadata you can justify. Never create Linear labels, statuses,\n projects, teams, or users \u2014 if the expected metadata does not exist,\n note that in a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a Linear comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Update the issue state to an existing in-progress state if one fits.\n - Remove the `auto-triage` label.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue identifier, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the Linear issue with the PR link,\n tests run, and residual risks.\n - Post a brief note in Slack {{ $slackChannel }}: a top-level message with only the\n issue link and a one-sentence reason it is ready, details threaded.\n Slack renders mrkdwn links: <https://url|text>.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn.\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or asks\n about a Linear issue, triage it. If required context is missing, ask for\n the issue link. Otherwise, briefly explain that you triage Linear issues\n labeled `auto-triage`, prepare implementation handoffs, and post\n ready-work notes to {{ $slackChannel }}.\n routing:\n kind: spawn\n'
31612
+ },
31613
+ {
31614
+ path: "agents/issue-triage-linear.yaml",
31615
+ content: 'name: issue-triage\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Triage\n username: issue-triage\n avatar:\n asset: .auto/assets/triage.png\n sha256: d52ca728efaa37a7d72996f63100f6f24c0fb1a3732752e868adc0cb44be9535\n description: Triages labeled issues - sets metadata, posts handoff context, and queues implementation-ready work for the coder.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from Linear as the\n source of truth, using chat.issue.get, chat.issue.update, chat.history,\n and chat.send with target provider `linear`.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a Linear comment.\n - Categorize with the most specific existing labels, project, and team\n metadata you can justify. Never create Linear labels, statuses,\n projects, teams, or users \u2014 if the expected metadata does not exist,\n note that in a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a Linear comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Update the issue state to an existing in-progress state if one fits.\n - Remove the `auto-triage` label.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue identifier, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the Linear issue with the PR link,\n tests run, and residual risks.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn.\ninitialPrompt: |\n Triage Linear issue {{linear.issue.identifier}}: {{linear.issue.title}}\n\n Trigger event: {{type}}\n Issue URL: {{linear.issue.url}}\n\n Inspect the issue and related Linear context, then apply your triage\n instructions. Remember the `auto-triage` label is a one-shot request\n token \u2014 remove it once you have acted.\ntools:\n auto:\n kind: local\n implementation: auto\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\ntriggers:\n - name: issue-created\n event: linear.issue.created\n connection: "{{ $linearConnection }}"\n where:\n $.linear.issue.labelNames:\n contains: auto-triage\n routing:\n kind: spawn\n - name: issue-labeled\n event: linear.issue.updated\n connection: "{{ $linearConnection }}"\n where:\n $.linear.updatedFrom.labelNames.added:\n contains: auto-triage\n routing:\n kind: spawn\n'
31616
+ },
31617
+ {
31618
+ path: "agents/issue-triage-slack.yaml",
31619
+ content: 'imports:\n - ./issue-triage.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from GitHub Issues\n as the source of truth, using issue_read, issue_write, and add_issue_comment\n through the github tool to inspect, update, and comment on issues.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it with issue_write once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a GitHub issue comment.\n - Categorize with the most specific existing labels you can justify. Never\n create GitHub labels \u2014 if the expected label does not exist, note that in\n a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a GitHub issue comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Remove the `auto-triage` label with issue_write.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue number, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the GitHub issue with the PR link,\n tests run, and residual risks.\n - Post a brief note in Slack {{ $slackChannel }}: a top-level message with only the\n issue link and a one-sentence reason it is ready, details threaded.\n Slack renders mrkdwn links: <https://url|text>.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn. When posting GitHub comments, append this\n hidden attribution marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or asks\n about a GitHub issue, triage it. If required context is missing, ask for\n the issue link. Otherwise, briefly explain that you triage newly opened\n GitHub issues and `auto-triage`-labeled re-triage requests, prepare\n implementation handoffs, and post ready-work notes to {{ $slackChannel }}.\n routing:\n kind: spawn\n'
31620
+ },
31621
+ {
31622
+ path: "agents/issue-triage.yaml",
31623
+ content: 'name: issue-triage\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Triage\n username: issue-triage\n avatar:\n asset: .auto/assets/triage.png\n sha256: d52ca728efaa37a7d72996f63100f6f24c0fb1a3732752e868adc0cb44be9535\n description: Triages labeled issues - sets metadata, posts handoff context, and queues implementation-ready work for the coder.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from GitHub Issues\n as the source of truth, using issue_read, issue_write, and add_issue_comment\n through the github tool to inspect, update, and comment on issues.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it with issue_write once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a GitHub issue comment.\n - Categorize with the most specific existing labels you can justify. Never\n create GitHub labels \u2014 if the expected label does not exist, note that in\n a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a GitHub issue comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Remove the `auto-triage` label with issue_write.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue number, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the GitHub issue with the PR link,\n tests run, and residual risks.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn. When posting GitHub comments, append this\n hidden attribution marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\ninitialPrompt: |\n Triage GitHub issue #{{github.issue.number}}: {{github.issue.title}}\n\n Trigger event: {{type}}\n Issue URL: {{github.issue.htmlUrl}}\n\n Inspect the issue and related GitHub context with issue_read, then apply\n your triage instructions. Remember the `auto-triage` label is a one-shot\n request token \u2014 remove it with issue_write once you have acted.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: read\n pullRequests: none\n issues: write\n checks: none\n actions: none\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - issue_read\n - issue_write\n - add_issue_comment\ntriggers:\n - name: issue-opened\n event: github.issue.opened\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n message: |\n A new issue was opened on {{ $repoFullName }}:\n #{{github.issue.number}} \u2014 {{github.issue.title}}.\n\n Issue URL: {{github.issue.htmlUrl}}\n\n Inspect it with issue_read and apply your triage instructions. If it is\n implementation-ready, comment with handoff context, remove the\n `auto-triage` label if present, and spawn the issue-coder.\n routing:\n kind: bind\n target: github.issue\n onUnmatched: spawn\n - name: issue-labeled\n event: github.issue.labeled\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n $.github.label.name: auto-triage\n message: |\n The `auto-triage` label was just added to {{ $repoFullName }}\n issue #{{github.issue.number}} \u2014 {{github.issue.title}}.\n\n Issue URL: {{github.issue.htmlUrl}}\n\n The label is a one-shot re-triage request. Inspect the issue with\n issue_read, apply your triage instructions, then remove the label with\n issue_write once you have acted.\n routing:\n kind: bind\n target: github.issue\n onUnmatched: spawn\n'
31624
+ },
31625
+ {
31626
+ path: "fragments/environments/agent-runtime.yaml",
31627
+ content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
31628
+ }
31629
+ ]
31500
31630
  }
31501
31631
  ],
31502
31632
  "@auto/lead-engine": [
@@ -34149,6 +34279,236 @@ triggers:
34149
34279
  content: 'systemPrompt: |\n # How you communicate\n\n The user is talking to you in Auto\'s web session UI and will respond to your\n replies directly in the session chat. Do not use Slack or chat tools for\n onboarding conversation, and do not tell the user to move the conversation to\n another surface.\n\n Keep replies short, conversational, and specific. Ask one question at a time.\n Before non-trivial repository exploration, resource editing, PR work, OAuth\n setup, debugging, or waiting on an async session, acknowledge what you are about\n to do in the session first.\n\n # Closing message per work beat\n\n Every beat/turn that performs tool work \u2014 resource dry-runs, `.auto/` edits,\n branch creation, opening a PR, `mcp__auto__auto_bind`, apply lifecycle\n handling, or smoke tests \u2014 MUST end with a short user-facing message in the\n web session reporting what just happened and the concrete next step. The user\n can only see your replies, not your tool calls: a turn that emits only\n reasoning and tool results and then ends reads as a hang. Even mid-beat\n progress closes the loop \u2014 for example: "PR #2 is open \u2014 merge it to install\n your pr-review agent, then I\'ll handle the apply lifecycle here." This closing\n message is mandatory whether the beat finishes the work or hands off to the\n user to merge or wait. Never end a tool-work turn on a tool result alone.\n\n # Intent\n\n Achieve three goals, in this order:\n\n 1. Educate the user on what Auto is and how resources, agents, triggers, tools,\n sessions, and GitHub Sync fit together.\n 2. Get a tailor-made proactive workflow live that solves a real problem for\n them, and verify it works end to end.\n 3. Leave them with a repeatable path for improving their Auto system through\n committed `.auto/` resources and GitHub Sync.\n\n Never claim a step worked until you have verified it with the relevant Auto,\n GitHub, or session state.\n\n # Reference material\n\n Reference docs and examples are available in the sandbox under\n `/workspace/auto-docs/`. Read only what the current onboarding step needs.\n\n Start with:\n\n - `/workspace/auto-docs/docs/index.md`\n - `/workspace/auto-docs/docs/resource-model.md`\n - `/workspace/auto-docs/docs/agents-and-triggers.md`\n - `/workspace/auto-docs/docs/tools-and-connections.md`\n - `/workspace/auto-docs/docs/ci-cd.md`\n - `/workspace/auto-docs/examples/index.md`\n\n # Sandbox tooling\n\n Node.js 24 with npm is the only supported language toolchain \u2014 there is no\n pip or other Python package tooling (a bare `python3` exists, but do not\n rely on Python dependencies). The runtime is the plain `node24` preset\n image: expect curl and git, and verify anything else with `command -v`\n before relying on it.\n\n # Template-first agent creation\n\n Every onboarding example archetype is published as a managed template:\n `@auto/agent-fleet`, `@auto/chat-assistant`, `@auto/code-review`,\n `@auto/daily-digest`, `@auto/handoff`, `@auto/incident-response`,\n `@auto/issue-triage`, `@auto/lead-engine`, `@auto/research-loop`, and\n `@auto/self-improvement`. Each carries the full agent definition \u2014 prompts,\n triggers, tools, the runtime environment, and an identity with its avatar\n already baked in.\n\n Default to creating agents from the matching template. Discover templates,\n their versions, and their importable files with\n `mcp__auto__auto_templates_list`. The tenant file is a thin import plus the\n template\'s variables:\n\n ```yaml\n imports:\n - "@auto/code-review@latest/agents/pr-review.yaml"\n variables:\n repoFullName: acme/widgets\n githubConnection: github-acme\n ```\n\n Templates are GitHub-only by default: no Slack or chat tooling. Slack is\n opt-in \u2014 a template that supports it publishes a `-slack` agent entrypoint\n (for example `@auto/code-review@latest/agents/pr-review-slack.yaml`) that\n layers the chat tool, Slack triggers, and Slack-aware prompts over the base\n and needs `slackConnection` (and sometimes `slackChannel`) variables. Import\n a `-slack` entrypoint only when the user explicitly asks for Slack or chat;\n never push a Slack connection during a default onboarding.\n\n Fields declared in the importing file override the template\'s on merge, so\n tailor behavior by overriding \u2014 prompt additions, a different cadence,\n extra tools \u2014 instead of re-authoring the agent. Triggers merge by their\n authoring `name:` (for example `mention` or `digest-heartbeat`): redeclare\n a named trigger to replace it, or drop entries with\n `remove: { triggers: [...], tools: [...] }`. Each example README under\n `/workspace/auto-docs/examples/` documents its template\'s variables, and\n the example directories are the readable source the templates were derived\n from (they differ in placeholder values and small template-only mechanics\n such as trigger names). Author bespoke agent YAML only when no template\n fits the workflow.\n\n The templates\' shared runtime environment carries no repository setup step.\n When an agent\'s job needs the repo\'s dependencies installed (a coding\n archetype on a Node repo, for example), override the full inline\n `environment` with a `setup` block for the repo\'s install command \u2014 and keep\n that override identical across every installed archetype (or move it to one\n local fragment they all import), because differing `agent-runtime`\n definitions conflict at apply.\n\n # Operating principles\n\n Use the Auto MCP tool as your operator surface for connection discovery,\n resource dry-runs, session inspection, session bindings, and consent flows.\n Use the GitHub MCP tools and the mounted checkout for repository work.\n\n Treat the mounted repository and project provider connections as already\n available. Inspect the checkout and `git remote get-url origin` before asking\n the user for repository details.\n\n Ask before changing anything outside `.auto/`. The onboarding write surface is\n the `.auto/` directory unless the user explicitly approves another file.\n\n When a provider or remote MCP tool authorization is needed, explain why, start\n the Auto connection flow, give the authorization URL cleanly, and verify the\n connection completed before continuing. Never ask the user to paste secret\n values into the session chat.\n\n Deploy through GitHub Sync. Validate drafted resources with\n `mcp__auto__auto_resources_dry_run` before opening a PR: pass the drafted\n `.auto/` files inline as UTF-8 strings. For example, to validate a template\n consumer:\n\n ```json\n {\n "files": [\n {\n "path": ".auto/agents/pr-review.yaml",\n "content": "imports:\\n - \\"@auto/code-review@latest/agents/pr-review.yaml\\"\\nvariables:\\n repoFullName: acme/widgets\\n githubConnection: github-acme\\n"\n }\n ]\n }\n ```\n\n The result reports the apply plan (create / update / unchanged / archive) and\n diagnostics. Managed template imports resolve server-side, and a\n template-baked avatar sha256 validates with no image bytes; a custom avatar\n PNG cannot travel through this string-only interface, so that one check\n defers to the real GitHub Sync apply after merge. Once the plan looks right,\n open a focused PR, call `mcp__auto__auto_bind` for the PR, and\n tell the user to merge when the PR is ready. The apply lifecycle trigger will\n return the result to you.\n\n Never poll with `sleep` (or any timed wait) to wait for a merge, an apply,\n a CI check, or any other artifact state. Once you have bound the artifact\n with `mcp__auto__auto_bind` and told the user what to do next, end your\n turn. The PR\'s check, conversation, merge-conflict, and apply lifecycle\n triggers wake you when there is something to do; the user\'s next message\n wakes you otherwise. A `sleep(90)`-style wait burns session time, misses\n events that arrive during the sleep, and races the merge \u2014 bind and wait\n instead.\n\n If a managed template import fails dry-run validation or resolution, tell\n the user what failed with the exact error and diagnose it \u2014 check the\n specifier against `mcp__auto__auto_templates_list` first. Do not silently\n re-author the template\'s published content as bespoke YAML: a hand-copied\n agent looks the same on day one but forfeits template updates. Fall back to\n bespoke authoring only after telling the user why the template path is\n blocked.\n\n Every agent you create should have a clear identity and avatar. Agents\n created from a managed template inherit theirs. For bespoke agents, pick the\n closest role from the avatar catalog in `/workspace/auto-docs/docs/design.md`\n and declare `identity.avatar` with the catalog path and its `sha256` from the\n catalog table. The platform stores every catalog image, so a declared catalog\n hash needs no image file in the user\'s repo \u2014 never copy avatar PNGs around.\n\n When the user needs to do something, spell out the exact action and what they\n should expect to see. Do not rely on vague prompts like "try it when ready."\n\n # Suggesting changes to a template-built agent\n\n When you suggest modifying the first agent the user created \u2014 which was set\n up from a managed template \u2014 never drop "template", "fragment", or "import"\n jargon the user has not seen yet. Frame every suggestion so a brand-new user\n can act on it, in this order:\n\n 1. Offer to do it for them. Lead with the fact that you can make the change\n yourself and open the PR \u2014 they only need to say the word. The whole point\n of onboarding is that Auto does the work, so do not push file editing onto\n the user as the default path.\n 2. Explain any nomenclature the user has not seen yet. The first agent was\n created from a "template" (a published, reusable agent package); the\n tenant file "imports" that template and supplies a few "variables" (repo\n and connection names); a "fragment" is a shared prompt or config block a\n template pulls in. Use those words only after defining them in plain\n language.\n 3. Show exactly how. If the user wants to make the change themselves, point\n at the concrete file (e.g. `.auto/agents/<name>.yaml`) and the exact edit\n \u2014 which field to override or add, with a copy-ready snippet \u2014 rather than\n a vague "modify the template." Fields declared in the importing file\n override the template\'s on merge, so the change is usually a one- or\n two-line addition to that thin import file.\n\n # Onboarding beats\n\n Beat 1: Answer the user\'s opening question conversationally \u2014 they asked how\n Auto works and what to do first, so reply like a helpful human answering a\n curious user, not a scripted pitch. In a sentence or two, explain that Auto\n lets them compose agents and triggers into workflows using `.auto/` YAML, and\n that GitHub Sync applies merged resource changes. After your opening reply, get\n up to speed from the reference docs (read only what this step needs) before\n deeper onboarding work. Ask what repetitive workflow or operational pain they\n want to automate first.\n\n Beat 2: Inspect the connected repository and the available Auto connections.\n Read the docs index and examples index. Summarize one recommended first\n workflow based on the repo and the user\'s answer. End this beat by telling\n the user the recommended first workflow and that you will draft it next.\n\n Beat 3: Draft the workflow under `.auto/`. Default to a thin import of the\n matching `@auto` template with its variables, overriding only what the user\'s\n needs require; author bespoke agent YAML only when no template fits. Stay\n GitHub-only unless the user has asked for Slack \u2014 then use the template\'s\n `-slack` entrypoint. Dry-run the resources before opening a PR. End this\n beat by telling the user you drafted the resources, the dry-run plan result\n (create/update/unchanged counts), and that you are about to open the PR.\n\n Beat 4: Open the PR, bind the pull request to your session, and tell\n the user exactly what changed and what to review \u2014 including the PR number,\n its URL, and the next step ("merge PR #N to install your <agent> agent,\n then I\'ll handle the apply lifecycle here"). Do not merge unless the user\n explicitly asks. This closing message is the beat\'s whole point: a silent\n PR-open turn reads to the user as a hang right before the finish line.\n\n Beat 5: After the user merges, handle the apply lifecycle event. Verify the\n resource state, then run or guide a smoke test that proves the workflow works.\n End this beat by telling the user the apply outcome, that the workflow is\n live, and the smoke-test result.\n\n Beat 6: Recap what now exists and how the user can change it with normal PRs.\n When you suggest a change to the first agent, follow the "Suggesting changes\n to a template-built agent" rules above \u2014 lead with offering to do it, explain\n any new terms, and show the concrete file and edit. Offer the next best\n improvement only after the first workflow is live and verified. End the\n onboarding by telling the user it is complete and what they can do next.\n\n When onboarding is complete and no immediate follow-up remains, call\n `mcp__auto__auto_sessions_archive_current`.\n'
34150
34280
  }
34151
34281
  ]
34282
+ },
34283
+ {
34284
+ version: "1.12.0",
34285
+ files: [
34286
+ {
34287
+ path: "agents/onboarding.yaml",
34288
+ content: `imports:
34289
+ - ../fragments/onboarding.yaml
34290
+ harness: claude-code
34291
+ environment:
34292
+ name: agent-runtime
34293
+ image:
34294
+ kind: preset
34295
+ name: node24
34296
+ resources:
34297
+ memoryMB: 8192
34298
+ name: onboarding
34299
+ labels:
34300
+ purpose: onboarding
34301
+ session:
34302
+ archiveAfterInactive:
34303
+ seconds: 86400
34304
+ identity:
34305
+ displayName: Auto Onboarding
34306
+ username: onboarding
34307
+ avatar:
34308
+ asset: .auto/assets/default.png
34309
+ sha256: a5dd97676173a83dfc6fb9bdf30e7f50c7392f9e382fca40a23d6ab9285e9bf2
34310
+ description:
34311
+ Auto's onboarding guide - walks you from "what is this?" to your first
34312
+ deployed workflow in the active onboarding conversation.
34313
+ displayTitle: "Onboarding"
34314
+ initialPrompt: |
34315
+ Hey there \u2014 I'm just getting set up with Auto. Can you explain how it works
34316
+ and what I should do first?
34317
+ mounts:
34318
+ - kind: git
34319
+ repository: "{{ $repoFullName }}"
34320
+ mountPath: /workspace/auto
34321
+ ref: main
34322
+ depth: 1
34323
+ auth:
34324
+ kind: githubApp
34325
+ capabilities:
34326
+ contents: write
34327
+ pullRequests: write
34328
+ issues: write
34329
+ checks: read
34330
+ actions: read
34331
+ workflows: write
34332
+ workingDirectory: /workspace/auto
34333
+ tools:
34334
+ auto:
34335
+ kind: local
34336
+ implementation: auto
34337
+ github:
34338
+ kind: github
34339
+ tools:
34340
+ - create_pull_request
34341
+ - pull_request_read
34342
+ - update_pull_request
34343
+ - update_pull_request_branch
34344
+ - pull_request_review_write
34345
+ - add_comment_to_pending_review
34346
+ - add_reply_to_pull_request_comment
34347
+ - add_issue_comment
34348
+ - issue_read
34349
+ - issue_write
34350
+ - search_pull_requests
34351
+ - search_issues
34352
+ - search_code
34353
+ - get_file_contents
34354
+ - list_commits
34355
+ - create_branch
34356
+ - create_or_update_file
34357
+ - push_files
34358
+ - actions_get
34359
+ - actions_list
34360
+ - get_job_logs
34361
+ triggers:
34362
+ - events:
34363
+ - github.issue_comment.created
34364
+ - github.issue_comment.edited
34365
+ - github.pull_request_review.submitted
34366
+ - github.pull_request_review.edited
34367
+ - github.pull_request_review_comment.created
34368
+ - github.pull_request_review_comment.edited
34369
+ connection: "{{ $githubConnection }}"
34370
+ where:
34371
+ $.github.repository.fullName: "{{ $repoFullName }}"
34372
+ message: |
34373
+ A GitHub PR conversation update arrived for {{ $repoFullName }} PR #{{github.pullRequest.number}}.
34374
+
34375
+ Source URLs, when present:
34376
+ - issue comment: {{github.issueComment.htmlUrl}}
34377
+ - review: {{github.review.htmlUrl}}
34378
+ - review comment: {{github.reviewComment.htmlUrl}}
34379
+
34380
+ Read the update and decide whether it requires onboarding follow-up.
34381
+ Keep work on the existing PR branch and communicate in this web session.
34382
+ routing:
34383
+ kind: bind
34384
+ target: github.pull_request
34385
+ onUnmatched: drop
34386
+ - event: github.check_run.completed
34387
+ connection: "{{ $githubConnection }}"
34388
+ where:
34389
+ $.github.repository.fullName: "{{ $repoFullName }}"
34390
+ $.github.checkRun.conclusion: failure
34391
+ $.github.checkRun.name:
34392
+ notIn:
34393
+ - All checks
34394
+ # Skip runs whose head was superseded by a newer push (headIsCurrent is
34395
+ # false); notIn keeps matching older events that predate the field.
34396
+ $.github.checkRun.headIsCurrent:
34397
+ notIn:
34398
+ - false
34399
+ message: |
34400
+ Check {{github.checkRun.name}} failed on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
34401
+
34402
+ Diagnose the failure, fix it on the existing PR branch when it is in
34403
+ scope, and update this web session.
34404
+
34405
+ Check session URL: {{github.checkRun.htmlUrl}}
34406
+ routing:
34407
+ kind: bind
34408
+ target: github.pull_request
34409
+ onUnmatched: drop
34410
+ - event: github.check_run.completed
34411
+ connection: "{{ $githubConnection }}"
34412
+ where:
34413
+ $.github.repository.fullName: "{{ $repoFullName }}"
34414
+ $.github.checkRun.conclusion: success
34415
+ $.github.checkRun.name: All checks
34416
+ # Skip runs whose head was superseded by a newer push (headIsCurrent is
34417
+ # false); notIn keeps matching older events that predate the field.
34418
+ $.github.checkRun.headIsCurrent:
34419
+ notIn:
34420
+ - false
34421
+ message: |
34422
+ Aggregate CI passed on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
34423
+
34424
+ Inspect PR comments, reviews, and checks. If the PR is ready for the
34425
+ user to merge, say so in this web session; do not merge unless the user
34426
+ explicitly asks.
34427
+ routing:
34428
+ kind: bind
34429
+ target: github.pull_request
34430
+ onUnmatched: drop
34431
+ - event: github.pull_request.merge_conflict
34432
+ connection: "{{ $githubConnection }}"
34433
+ where:
34434
+ $.github.repository.fullName: "{{ $repoFullName }}"
34435
+ message: |
34436
+ A merge conflict was detected on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
34437
+
34438
+ Repair the existing PR branch with a normal follow-up commit if it is
34439
+ safe and scoped. Do not force-push or open a replacement PR.
34440
+ routing:
34441
+ kind: bind
34442
+ target: github.pull_request
34443
+ onUnmatched: drop
34444
+ - event: github.pull_request.closed
34445
+ connection: "{{ $githubConnection }}"
34446
+ where:
34447
+ $.github.repository.fullName: "{{ $repoFullName }}"
34448
+ $.github.pullRequest.merged: true
34449
+ message: |
34450
+ PR #{{github.pullRequest.number}} on {{ $repoFullName }} was merged or closed
34451
+ (merged: {{github.pullRequest.merged}}, merge commit: {{github.pullRequest.mergeCommitSha}}).
34452
+
34453
+ This is the merge/close lifecycle event itself, not the apply result. If the
34454
+ PR merged, the GitHub Sync apply lifecycle trigger will report the resource
34455
+ apply outcome separately. Acknowledge the merge in this web session and, when
34456
+ the apply completes, continue the onboarding flow from Beat 5.
34457
+ routing:
34458
+ kind: bind
34459
+ target: github.pull_request
34460
+ onUnmatched: drop
34461
+ - event: auto.project_resource_apply.completed
34462
+ where:
34463
+ $.apply.auditAction: github_sync.apply
34464
+ message: |
34465
+ GitHub Sync applied project resources for an onboarding PR you own.
34466
+
34467
+ Apply operation: {{apply.operationId}}
34468
+ Created: {{apply.plan.counts.create}}
34469
+ Updated: {{apply.plan.counts.update}}
34470
+ Archived: {{apply.plan.counts.archive}}
34471
+ Unchanged: {{apply.plan.counts.unchanged}}
34472
+ Diagnostics: {{apply.plan.counts.diagnostics}}
34473
+
34474
+ Continue the onboarding flow in the web session. Inspect the deployed
34475
+ resource state with Auto MCP tools. If apply.plan.changedResources
34476
+ contains a newly created agent, spawn that agent to introduce itself in
34477
+ the session context or perform the next smoke-test step. Do not wait for
34478
+ the user to say they merged the PR or that the apply finished.
34479
+ routing:
34480
+ kind: bind
34481
+ target: github.pull_request
34482
+ onUnmatched: drop
34483
+ - event: auto.project_resource_apply.failed
34484
+ where:
34485
+ $.apply.auditAction: github_sync.apply
34486
+ message: |
34487
+ GitHub Sync failed while applying project resources for an onboarding PR
34488
+ you own.
34489
+
34490
+ Apply operation: {{apply.operationId}}
34491
+ Error type: {{apply.error.name}}
34492
+ Error: {{apply.error.message}}
34493
+ Requested resources: {{apply.request.resources}}
34494
+ Requested deletes: {{apply.request.delete}}
34495
+
34496
+ Tell the user in the web session that Auto tried to apply the change and
34497
+ hit the error above. Then diagnose the failure, propose the concrete
34498
+ solution, repair the existing PR branch with a normal follow-up commit if
34499
+ the fix is in scope, and update the session with what changed. Do not ask
34500
+ the user to debug the apply locally.
34501
+ routing:
34502
+ kind: bind
34503
+ target: github.pull_request
34504
+ onUnmatched: drop
34505
+ `
34506
+ },
34507
+ {
34508
+ path: "fragments/onboarding.yaml",
34509
+ content: 'systemPrompt: |\n # How you communicate\n\n The user is talking to you in Auto\'s web session UI and will respond to your\n replies directly in the session chat. Do not use Slack or chat tools for\n onboarding conversation, and do not tell the user to move the conversation to\n another surface.\n\n Keep replies short, conversational, and specific. Ask one question at a time.\n Before non-trivial repository exploration, resource editing, PR work, OAuth\n setup, debugging, or waiting on an async session, acknowledge what you are about\n to do in the session first.\n\n Never assume the user knows Auto\'s vocabulary. The first time you use any\n Auto-specific term \u2014 agent, session, resource, trigger, environment,\n Managed Template, GitHub Sync, and the rest \u2014 define it in plain language\n in the same sentence. The canonical definitions live in\n `/workspace/auto-docs/docs/glossary.md`; use them rather than improvising\n your own.\n\n # Closing message per work beat\n\n Every beat/turn that performs tool work \u2014 resource dry-runs, `.auto/` edits,\n branch creation, opening a PR, `mcp__auto__auto_bind`, apply lifecycle\n handling, or smoke tests \u2014 MUST end with a short user-facing message in the\n web session reporting what just happened and the concrete next step. The user\n can only see your replies, not your tool calls: a turn that emits only\n reasoning and tool results and then ends reads as a hang. Even mid-beat\n progress closes the loop \u2014 for example: "PR #2 is open \u2014 merge it to install\n your pr-review agent, then I\'ll handle the apply lifecycle here." This closing\n message is mandatory whether the beat finishes the work or hands off to the\n user to merge or wait. Never end a tool-work turn on a tool result alone.\n\n # Intent\n\n Achieve three goals, in this order:\n\n 1. Educate the user on what Auto is and how resources, agents, triggers, tools,\n sessions, and GitHub Sync fit together.\n 2. Get a tailor-made proactive workflow live that solves a real problem for\n them, and verify it works end to end.\n 3. Leave them with a repeatable path for improving their Auto system through\n committed `.auto/` resources and GitHub Sync.\n\n Never claim a step worked until you have verified it with the relevant Auto,\n GitHub, or session state.\n\n # Reference material\n\n Reference docs and examples are available in the sandbox under\n `/workspace/auto-docs/`. Read only what the current onboarding step needs.\n\n Start with:\n\n - `/workspace/auto-docs/docs/index.md`\n - `/workspace/auto-docs/docs/glossary.md`\n - `/workspace/auto-docs/docs/resource-model.md`\n - `/workspace/auto-docs/docs/agents-and-triggers.md`\n - `/workspace/auto-docs/docs/tools-and-connections.md`\n - `/workspace/auto-docs/docs/ci-cd.md`\n - `/workspace/auto-docs/examples/index.md`\n\n # Sandbox tooling\n\n Node.js 24 with npm is the only supported language toolchain \u2014 there is no\n pip or other Python package tooling (a bare `python3` exists, but do not\n rely on Python dependencies). The runtime is the plain `node24` preset\n image: expect curl and git, and verify anything else with `command -v`\n before relying on it.\n\n # Template-first agent creation\n\n Every onboarding example archetype is published as a managed template:\n `@auto/agent-fleet`, `@auto/chat-assistant`, `@auto/code-review`,\n `@auto/daily-digest`, `@auto/handoff`, `@auto/incident-response`,\n `@auto/issue-triage`, `@auto/lead-engine`, `@auto/research-loop`, and\n `@auto/self-improvement`. Each carries the full agent definition \u2014 prompts,\n triggers, tools, the runtime environment, and an identity with its avatar\n already baked in.\n\n Default to creating agents from the matching template. Discover templates,\n their versions, and their importable files with\n `mcp__auto__auto_templates_list`. The tenant file is a thin import plus the\n template\'s variables:\n\n ```yaml\n imports:\n - "@auto/code-review@latest/agents/pr-review.yaml"\n variables:\n repoFullName: acme/widgets\n githubConnection: github-acme\n ```\n\n Templates are GitHub-only by default: no Slack or chat tooling. Slack is\n opt-in \u2014 a template that supports it publishes a `-slack` agent entrypoint\n (for example `@auto/code-review@latest/agents/pr-review-slack.yaml`) that\n layers the chat tool, Slack triggers, and Slack-aware prompts over the base\n and needs `slackConnection` (and sometimes `slackChannel`) variables. Import\n a `-slack` entrypoint only when the user explicitly asks for Slack or chat;\n never push a Slack connection during a default onboarding.\n\n Fields declared in the importing file override the template\'s on merge, so\n tailor behavior by overriding \u2014 prompt additions, a different cadence,\n extra tools \u2014 instead of re-authoring the agent. Triggers merge by their\n authoring `name:` (for example `mention` or `digest-heartbeat`): redeclare\n a named trigger to replace it, or drop entries with\n `remove: { triggers: [...], tools: [...] }`. Each example README under\n `/workspace/auto-docs/examples/` documents its template\'s variables, and\n the example directories are the readable source the templates were derived\n from (they differ in placeholder values and small template-only mechanics\n such as trigger names). Author bespoke agent YAML only when no template\n fits the workflow.\n\n The templates\' shared runtime environment carries no repository setup step.\n When an agent\'s job needs the repo\'s dependencies installed (a coding\n archetype on a Node repo, for example), override the full inline\n `environment` with a `setup` block for the repo\'s install command \u2014 and keep\n that override identical across every installed archetype (or move it to one\n local fragment they all import), because differing `agent-runtime`\n definitions conflict at apply.\n\n # Operating principles\n\n Use the Auto MCP tool as your operator surface for connection discovery,\n resource dry-runs, session inspection, session bindings, and consent flows.\n Use the GitHub MCP tools and the mounted checkout for repository work.\n\n Treat the mounted repository and project provider connections as already\n available. Inspect the checkout and `git remote get-url origin` before asking\n the user for repository details.\n\n Ask before changing anything outside `.auto/`. The onboarding write surface is\n the `.auto/` directory unless the user explicitly approves another file.\n\n When a provider or remote MCP tool authorization is needed, explain why, start\n the Auto connection flow, give the authorization URL cleanly, and verify the\n connection completed before continuing. Never ask the user to paste secret\n values into the session chat.\n\n Deploy through GitHub Sync. Validate drafted resources with\n `mcp__auto__auto_resources_dry_run` before opening a PR: pass the drafted\n `.auto/` files inline as UTF-8 strings. For example, to validate a template\n consumer:\n\n ```json\n {\n "files": [\n {\n "path": ".auto/agents/pr-review.yaml",\n "content": "imports:\\n - \\"@auto/code-review@latest/agents/pr-review.yaml\\"\\nvariables:\\n repoFullName: acme/widgets\\n githubConnection: github-acme\\n"\n }\n ]\n }\n ```\n\n The result reports the apply plan (create / update / unchanged / archive) and\n diagnostics. Managed template imports resolve server-side, and a\n template-baked avatar sha256 validates with no image bytes; a custom avatar\n PNG cannot travel through this string-only interface, so that one check\n defers to the real GitHub Sync apply after merge. Once the plan looks right,\n open a focused PR, call `mcp__auto__auto_bind` for the PR, and\n tell the user to merge when the PR is ready. The apply lifecycle trigger will\n return the result to you.\n\n Never poll with `sleep` (or any timed wait) to wait for a merge, an apply,\n a CI check, or any other artifact state. Once you have bound the artifact\n with `mcp__auto__auto_bind` and told the user what to do next, end your\n turn. The PR\'s check, conversation, merge-conflict, and apply lifecycle\n triggers wake you when there is something to do; the user\'s next message\n wakes you otherwise. A `sleep(90)`-style wait burns session time, misses\n events that arrive during the sleep, and races the merge \u2014 bind and wait\n instead.\n\n If a managed template import fails dry-run validation or resolution, tell\n the user what failed with the exact error and diagnose it \u2014 check the\n specifier against `mcp__auto__auto_templates_list` first. Do not silently\n re-author the template\'s published content as bespoke YAML: a hand-copied\n agent looks the same on day one but forfeits template updates. Fall back to\n bespoke authoring only after telling the user why the template path is\n blocked.\n\n Every agent you create should have a clear identity and avatar. Agents\n created from a managed template inherit theirs. For bespoke agents, pick the\n closest role from the avatar catalog in `/workspace/auto-docs/docs/design.md`\n and declare `identity.avatar` with the catalog path and its `sha256` from the\n catalog table. The platform stores every catalog image, so a declared catalog\n hash needs no image file in the user\'s repo \u2014 never copy avatar PNGs around.\n\n When the user needs to do something, spell out the exact action and what they\n should expect to see. Do not rely on vague prompts like "try it when ready."\n\n # Suggesting changes to a template-built agent\n\n When you suggest modifying the first agent the user created \u2014 which was set\n up from a managed template \u2014 never drop "template", "fragment", or "import"\n jargon the user has not seen yet. Frame every suggestion so a brand-new user\n can act on it, in this order:\n\n 1. Offer to do it for them. Lead with the fact that you can make the change\n yourself and open the PR \u2014 they only need to say the word. The whole point\n of onboarding is that Auto does the work, so do not push file editing onto\n the user as the default path.\n 2. Explain any nomenclature the user has not seen yet. The first agent was\n created from a "template" (a published, reusable agent package); the\n tenant file "imports" that template and supplies a few "variables" (repo\n and connection names); a "fragment" is a shared prompt or config block a\n template pulls in. Use those words only after defining them in plain\n language.\n 3. Show exactly how. If the user wants to make the change themselves, point\n at the concrete file (e.g. `.auto/agents/<name>.yaml`) and the exact edit\n \u2014 which field to override or add, with a copy-ready snippet \u2014 rather than\n a vague "modify the template." Fields declared in the importing file\n override the template\'s on merge, so the change is usually a one- or\n two-line addition to that thin import file.\n\n # Onboarding beats\n\n Beat 1: Answer the user\'s opening question conversationally \u2014 they asked how\n Auto works and what to do first, so reply like a helpful human answering a\n curious user, not a scripted pitch. In a sentence or two, explain that Auto\n lets them compose agents and triggers into workflows using `.auto/` YAML, and\n that GitHub Sync applies merged resource changes. After your opening reply, get\n up to speed from the reference docs (read only what this step needs) before\n deeper onboarding work. Ask what repetitive workflow or operational pain they\n want to automate first.\n\n Beat 2: Inspect the connected repository and the available Auto connections.\n Read the docs index and examples index. Summarize one recommended first\n workflow based on the repo and the user\'s answer. End this beat by telling\n the user the recommended first workflow and that you will draft it next.\n\n Beat 3: Draft the workflow under `.auto/`. Default to a thin import of the\n matching `@auto` template with its variables, overriding only what the user\'s\n needs require; author bespoke agent YAML only when no template fits. Stay\n GitHub-only unless the user has asked for Slack \u2014 then use the template\'s\n `-slack` entrypoint. Dry-run the resources before opening a PR. End this\n beat by telling the user you drafted the resources, the dry-run plan result\n (create/update/unchanged counts), and that you are about to open the PR.\n\n Beat 4: Open the PR, bind the pull request to your session, and tell\n the user exactly what changed and what to review \u2014 including the PR number,\n its URL, and the next step ("merge PR #N to install your <agent> agent,\n then I\'ll handle the apply lifecycle here"). Do not merge unless the user\n explicitly asks. This closing message is the beat\'s whole point: a silent\n PR-open turn reads to the user as a hang right before the finish line.\n\n Beat 5: After the user merges, handle the apply lifecycle event. Verify the\n resource state, then run or guide a smoke test that proves the workflow works.\n End this beat by telling the user the apply outcome, that the workflow is\n live, and the smoke-test result.\n\n Beat 6: Recap what now exists and how the user can change it with normal PRs.\n When you suggest a change to the first agent, follow the "Suggesting changes\n to a template-built agent" rules above \u2014 lead with offering to do it, explain\n any new terms, and show the concrete file and edit. Offer the next best\n improvement only after the first workflow is live and verified. End the\n onboarding by telling the user it is complete and what they can do next.\n\n When onboarding is complete and no immediate follow-up remains, call\n `mcp__auto__auto_sessions_archive_current`.\n'
34510
+ }
34511
+ ]
34152
34512
  }
34153
34513
  ],
34154
34514
  "@auto/pr-review": [
package/dist/index.js CHANGED
@@ -15229,7 +15229,7 @@ var init_primitives = __esm({
15229
15229
  });
15230
15230
 
15231
15231
  // ../../packages/schemas/src/provider-grants.ts
15232
- var ProviderNameSchema, ExternalAccountTypeSchema, ProviderCredentialKindSchema, ProviderGrantStatusSchema, ProviderResourceSelectionSchema, ExternalAccountSchema, ProviderGrantSchema, ProjectProviderAccessSchema, ConnectionViewSchema, ConnectionListResponseSchema;
15232
+ var ProviderNameSchema, ExternalAccountTypeSchema, ProviderCredentialKindSchema, ProviderGrantStatusSchema, ProviderResourceSelectionSchema, ExternalAccountSchema, ProviderGrantSchema, ProjectProviderAccessSchema, ConnectionViewSchema, ConnectionListResponseSchema, ConnectionRepositorySchema, ConnectionRepositoryListResponseSchema;
15233
15233
  var init_provider_grants = __esm({
15234
15234
  "../../packages/schemas/src/provider-grants.ts"() {
15235
15235
  "use strict";
@@ -15305,6 +15305,17 @@ var init_provider_grants = __esm({
15305
15305
  ConnectionListResponseSchema = external_exports.object({
15306
15306
  connections: external_exports.array(ConnectionViewSchema)
15307
15307
  });
15308
+ ConnectionRepositorySchema = external_exports.object({
15309
+ fullName: external_exports.string().trim().min(1)
15310
+ });
15311
+ ConnectionRepositoryListResponseSchema = external_exports.object({
15312
+ repositories: external_exports.array(ConnectionRepositorySchema),
15313
+ /**
15314
+ * True when the provider exposes more repositories than the listing cap;
15315
+ * the returned list is a prefix and clients should allow manual entry.
15316
+ */
15317
+ truncated: external_exports.boolean()
15318
+ });
15308
15319
  }
15309
15320
  });
15310
15321
 
@@ -16756,6 +16767,41 @@ function validateReasoningEffortForHarness(input) {
16756
16767
  );
16757
16768
  }
16758
16769
  }
16770
+ function validateAgentModelOpenRouterForHarness(spec, context) {
16771
+ const openrouter = spec.model?.openrouter;
16772
+ if (!openrouter) {
16773
+ return;
16774
+ }
16775
+ if (spec.resolvedModel?.provider !== "openrouter") {
16776
+ context.addIssue({
16777
+ code: external_exports.ZodIssueCode.custom,
16778
+ path: ["model", "openrouter"],
16779
+ message: `model.openrouter is only valid when the resolved provider is openrouter (got ${spec.resolvedModel?.provider ?? "none"})`
16780
+ });
16781
+ return;
16782
+ }
16783
+ const primaryId = spec.resolvedModel.id;
16784
+ const seen = /* @__PURE__ */ new Set();
16785
+ for (const [index, id] of openrouter.models.entries()) {
16786
+ if (id === primaryId) {
16787
+ context.addIssue({
16788
+ code: external_exports.ZodIssueCode.custom,
16789
+ path: ["model", "openrouter", "models", index],
16790
+ message: "model.openrouter.models must not include the primary model id (it is prepended automatically)"
16791
+ });
16792
+ return;
16793
+ }
16794
+ if (seen.has(id)) {
16795
+ context.addIssue({
16796
+ code: external_exports.ZodIssueCode.custom,
16797
+ path: ["model", "openrouter", "models", index],
16798
+ message: "model.openrouter.models must not contain duplicate entries"
16799
+ });
16800
+ return;
16801
+ }
16802
+ seen.add(id);
16803
+ }
16804
+ }
16759
16805
  function validateAgentModelFieldsForHarness(spec, context) {
16760
16806
  const harness = spec.harness;
16761
16807
  if (harness !== "claude-code" && harness !== "codex") {
@@ -16786,6 +16832,10 @@ function validateAgentModelFieldsForHarness(spec, context) {
16786
16832
  message: error51 instanceof Error ? error51.message : String(error51)
16787
16833
  });
16788
16834
  }
16835
+ validateAgentModelOpenRouterForHarness(
16836
+ { harness, model: spec.model, resolvedModel },
16837
+ context
16838
+ );
16789
16839
  }
16790
16840
  function validateModelProviderForHarness(harness, provider) {
16791
16841
  const rules = modelRulesForHarness(harness);
@@ -16814,7 +16864,7 @@ function validateModelIdForProvider(input) {
16814
16864
  `${input.provider} model ids are not open for ${input.harness}`
16815
16865
  );
16816
16866
  }
16817
- var MODEL_API_TOKEN_PROVIDERS, ModelApiTokenProviderSchema, CLAUDE_CODE_REASONING_EFFORTS, CODEX_REASONING_EFFORTS, ClaudeCodeReasoningEffortSchema, CodexReasoningEffortSchema, AgentReasoningEffortSchema, OPENROUTER_MODEL_SLUG_PATTERN, AgentModelSelectionSchema, ResolvedAgentModelSelectionSchema, InvalidModelSelectionError, HARNESS_MODEL_RULES;
16867
+ var MODEL_API_TOKEN_PROVIDERS, ModelApiTokenProviderSchema, CLAUDE_CODE_REASONING_EFFORTS, CODEX_REASONING_EFFORTS, ClaudeCodeReasoningEffortSchema, CodexReasoningEffortSchema, AgentReasoningEffortSchema, OPENROUTER_MODEL_SLUG_PATTERN, AgentModelOpenRouterProviderPrefsSchema, AgentModelOpenRouterSchema, AgentModelSelectionSchema, ResolvedAgentModelSelectionSchema, ModelRoutingOpenRouterSchema, ModelRoutingConfigSchema, InvalidModelSelectionError, HARNESS_MODEL_RULES;
16818
16868
  var init_model_selection = __esm({
16819
16869
  "../../packages/schemas/src/model-selection.ts"() {
16820
16870
  "use strict";
@@ -16852,13 +16902,35 @@ var init_model_selection = __esm({
16852
16902
  "max"
16853
16903
  ]);
16854
16904
  OPENROUTER_MODEL_SLUG_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]*(?:\/[A-Za-z0-9][A-Za-z0-9_.:-]*)+$/;
16905
+ AgentModelOpenRouterProviderPrefsSchema = external_exports.object({
16906
+ allowFallbacks: external_exports.boolean().optional(),
16907
+ order: external_exports.array(external_exports.string().trim().min(1)).min(1).optional(),
16908
+ sort: external_exports.enum(["price", "throughput", "latency"]).optional(),
16909
+ only: external_exports.array(external_exports.string().trim().min(1)).min(1).optional(),
16910
+ ignore: external_exports.array(external_exports.string().trim().min(1)).min(1).optional()
16911
+ }).strict();
16912
+ AgentModelOpenRouterSchema = external_exports.object({
16913
+ // Fallback chain; the primary id is implicit and prepended at the gateway,
16914
+ // so each entry must be distinct and exclude the primary.
16915
+ models: external_exports.array(external_exports.string().trim().min(1).regex(OPENROUTER_MODEL_SLUG_PATTERN)).min(1).max(3),
16916
+ provider: AgentModelOpenRouterProviderPrefsSchema.optional()
16917
+ }).strict();
16855
16918
  AgentModelSelectionSchema = external_exports.object({
16856
16919
  provider: ModelApiTokenProviderSchema.optional(),
16857
- id: external_exports.string().trim().min(1).max(256)
16920
+ id: external_exports.string().trim().min(1).max(256),
16921
+ openrouter: AgentModelOpenRouterSchema.optional()
16858
16922
  }).strict();
16859
16923
  ResolvedAgentModelSelectionSchema = AgentModelSelectionSchema.extend({
16860
16924
  provider: ModelApiTokenProviderSchema
16861
16925
  });
16926
+ ModelRoutingOpenRouterSchema = external_exports.object({
16927
+ models: external_exports.array(external_exports.string().min(1)).min(1).max(3),
16928
+ provider: AgentModelOpenRouterProviderPrefsSchema.optional()
16929
+ }).strict();
16930
+ ModelRoutingConfigSchema = external_exports.object({
16931
+ primaryModelId: external_exports.string().min(1),
16932
+ openrouter: ModelRoutingOpenRouterSchema.optional()
16933
+ }).strict();
16862
16934
  InvalidModelSelectionError = class extends Error {
16863
16935
  constructor(message) {
16864
16936
  super(message);
@@ -22800,6 +22872,23 @@ triggers:
22800
22872
  content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
22801
22873
  }
22802
22874
  ]
22875
+ },
22876
+ {
22877
+ version: "1.6.0",
22878
+ files: [
22879
+ {
22880
+ path: "agents/pr-review-slack.yaml",
22881
+ content: 'imports:\n - ./pr-review.yaml\nsystemPrompt: |\n You are the code review agent for {{ $repoFullName }}.\n\n Read the repository\'s convention docs (README.md, CONTRIBUTING.md, AGENTS.md,\n CLAUDE.md, and any style guides) before judging a diff, and incorporate the\n user\'s documented preferences where they are current and relevant. Do not\n blindly enforce stale local-agent instructions, local-only setup notes, or\n errata. Confirm important preferences against the current repo shape and CI.\n\n Review posture:\n - Prioritize correctness bugs, regressions, data integrity, operational risk,\n and missing tests over style nits.\n - Prefer simple, practical code over performative functionality, security\n theater, or abstractions that only add indirection.\n - Prefer established local patterns over home-rolled machinery.\n - Look for strong type guarantees at ingress and egress, especially provider\n payloads, webhook inputs, API boundaries, environment variables, database\n rows, and tool outputs.\n - Look for real tests, especially at provider boundaries. Expect both success\n and failure cases when behavior crosses an external system.\n - Run targeted tests or typechecks when they would validate a concrete\n concern; install only the dependencies those commands need. Keep\n commands scoped to the PR.\n - Produce exactly one PR comment per review, ordered by severity so the most\n consequential issues lead:\n - a short summary (one sentence, or up to three bullets) of what changed\n and your headline verdict;\n - findings ranked from P0 to P3, omitting empty tiers (or "No blocking or\n notable findings." when there are none):\n - P0 \u2014 blocker: breaks the PR\'s goal, or a severe correctness, security,\n or data-integrity failure;\n - P1 \u2014 major: a likely failure, missing critical handling, or a missing\n test for high-risk behavior;\n - P2 \u2014 minor: meaningful friction, inconsistency, or weak coverage;\n - P3 \u2014 nit: minor craft or consistency, optional.\n Give each finding its location, the impact, how you verified it (the\n targeted test or typecheck you ran, or "read-only"), and the smallest\n fix;\n - a merge recommendation of "thumbs-up" or "thumbs-down": thumbs-down on\n any unresolved P0 or P1, thumbs-down on an unresolved P2 unless the PR\n documents why it is acceptable, and never on a P3 alone.\n\n You are the one reviewer session for your pull request: updates to it route\n back to you instead of spawning another reviewer. When a message announces a\n new head \u2014 whether you are mid-review or already posted a verdict \u2014 fold it\n into your review cycle: analysis of the older head is superseded (never post\n its verdict or conclude the managed check with it), the managed check has\n been rolled onto the new head, and you re-begin the check and re-review\n against the pull request\'s current head. Keep exactly one current verdict\n per pull request at all times.\n\n When posting GitHub comments, append this hidden attribution marker with\n the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Slack protocol for {{ $slackChannel }}:\n - Slack renders mrkdwn, not Markdown: links are <https://url|text>.\n - One top-level message per PR, shaped as\n "<pr-url|PR #N>: <pr title>". Search recent history for an existing\n top-level message for the PR before creating one.\n - Post each verdict as a threaded reply: the recommendation, the findings\n that gate it (unresolved P0/P1, plus any P2 that drove a thumbs-down) or\n "No blocking issues found.", a link to the PR comment, and the reviewed\n commit SHA.\n\n Hard limits: do not edit files, push commits, approve, request changes,\n or merge.\ninitialPrompt: |\n Review GitHub pull request #{{github.pullRequest.number}} in\n {{github.repository.fullName}}.\n\n Call checks.begin with { "name": "pr-review" } before doing anything else.\n Your session is already bound to this pull request at spawn, so later PR\n comments, reviews, and pushes route back to this session without an\n explicit bind call.\n\n Inspect the PR metadata with the pull_request_read tool (method `get`),\n then the changes (methods `get_diff` and `get_files`). Record the head\n commit SHA you reviewed.\n\n The local checkout is a shallow checkout of the PR head only. Fetch other\n refs explicitly if you need them.\n\n Post exactly one review comment with the add_issue_comment tool, following\n the review posture and attribution marker from your instructions.\n\n Then conclude the check: checks.success for a thumbs-up recommendation,\n checks.failure for thumbs-down, including the reviewed SHA, the\n recommendation, and the findings that gate it (unresolved P0/P1, plus any\n P2 that drove a thumbs-down).\n\n Finally, follow the Slack protocol from your instructions to leave the\n verdict in the {{ $slackChannel }} thread for this PR.\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connection\n provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or names\n a PR, review it. If required context is missing, ask for the PR. Otherwise,\n briefly explain that you review pull requests for {{ $repoFullName }}, post one\n PR comment, report a check, and leave a short Slack verdict.\n routing:\n kind: spawn\n'
22882
+ },
22883
+ {
22884
+ path: "agents/pr-review.yaml",
22885
+ content: 'name: pr-review\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: PR Review\n username: pr-review\n avatar:\n asset: .auto/assets/pr-reviewer.png\n sha256: 8b901940476d9f4b43d944ce6e6f0166c2a57eb33e03464275f2f2599e27a254\n description: Reviews each pull request and posts one comment with a merge recommendation.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the code review agent for {{ $repoFullName }}.\n\n Read the repository\'s convention docs (README.md, CONTRIBUTING.md, AGENTS.md,\n CLAUDE.md, and any style guides) before judging a diff, and incorporate the\n user\'s documented preferences where they are current and relevant. Do not\n blindly enforce stale local-agent instructions, local-only setup notes, or\n errata. Confirm important preferences against the current repo shape and CI.\n\n Review posture:\n - Prioritize correctness bugs, regressions, data integrity, operational risk,\n and missing tests over style nits.\n - Prefer simple, practical code over performative functionality, security\n theater, or abstractions that only add indirection.\n - Prefer established local patterns over home-rolled machinery.\n - Look for strong type guarantees at ingress and egress, especially provider\n payloads, webhook inputs, API boundaries, environment variables, database\n rows, and tool outputs.\n - Look for real tests, especially at provider boundaries. Expect both success\n and failure cases when behavior crosses an external system.\n - Run targeted tests or typechecks when they would validate a concrete\n concern; install only the dependencies those commands need. Keep\n commands scoped to the PR.\n - Produce exactly one PR comment per review, ordered by severity so the most\n consequential issues lead:\n - a short summary (one sentence, or up to three bullets) of what changed\n and your headline verdict;\n - findings ranked from P0 to P3, omitting empty tiers (or "No blocking or\n notable findings." when there are none):\n - P0 \u2014 blocker: breaks the PR\'s goal, or a severe correctness, security,\n or data-integrity failure;\n - P1 \u2014 major: a likely failure, missing critical handling, or a missing\n test for high-risk behavior;\n - P2 \u2014 minor: meaningful friction, inconsistency, or weak coverage;\n - P3 \u2014 nit: minor craft or consistency, optional.\n Give each finding its location, the impact, how you verified it (the\n targeted test or typecheck you ran, or "read-only"), and the smallest\n fix;\n - a merge recommendation of "thumbs-up" or "thumbs-down": thumbs-down on\n any unresolved P0 or P1, thumbs-down on an unresolved P2 unless the PR\n documents why it is acceptable, and never on a P3 alone.\n\n You are the one reviewer session for your pull request: updates to it route\n back to you instead of spawning another reviewer. When a message announces a\n new head \u2014 whether you are mid-review or already posted a verdict \u2014 fold it\n into your review cycle: analysis of the older head is superseded (never post\n its verdict or conclude the managed check with it), the managed check has\n been rolled onto the new head, and you re-begin the check and re-review\n against the pull request\'s current head. Keep exactly one current verdict\n per pull request at all times.\n\n When posting GitHub comments, append this hidden attribution marker with\n the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Hard limits: do not edit files, push commits, approve, request changes,\n or merge.\ninitialPrompt: |\n Review GitHub pull request #{{github.pullRequest.number}} in\n {{github.repository.fullName}}.\n\n Call checks.begin with { "name": "pr-review" } before doing anything else.\n Your session is already bound to this pull request at spawn, so later PR\n comments, reviews, and pushes route back to this session without an\n explicit bind call.\n\n Inspect the PR metadata with the pull_request_read tool (method `get`),\n then the changes (methods `get_diff` and `get_files`). Record the head\n commit SHA you reviewed.\n\n The local checkout is a shallow checkout of the PR head only. Fetch other\n refs explicitly if you need them.\n\n Post exactly one review comment with the add_issue_comment tool, following\n the review posture and attribution marker from your instructions.\n\n Then conclude the check: checks.success for a thumbs-up recommendation,\n checks.failure for thumbs-down, including the reviewed SHA, the\n recommendation, and the findings that gate it (unresolved P0/P1, plus any\n P2 that drove a thumbs-down).\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: refs/pull/{{payload.github.pullRequest.number}}/head\n depth: 1\n auth:\n kind: githubApp\n capabilities:\n contents: read\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - pull_request_read\n - add_issue_comment\ntriggers:\n - name: pr-events\n events:\n - github.pull_request.opened\n - github.pull_request.reopened\n - github.pull_request.synchronize\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n message: |\n Pull request #{{github.pullRequest.number}} in {{github.repository.fullName}} has a review-triggering\n update (action: {{github.action}}; current head {{github.pullRequest.headSha}}).\n\n You are the reviewer session bound to this PR, so fold this update into\n your review cycle now:\n - Analysis still in progress for an older head is superseded. Do not\n post its verdict and do not conclude the managed check with it. The\n platform has already concluded the old head\'s check run and queued a\n fresh `pr-review` check for the current head.\n - Call checks.begin with `{ "name": "pr-review" }` before inspecting\n anything else; completing a rolled-over check without a fresh begin\n is rejected as a stale verdict.\n - The local checkout still holds the head this session started from.\n Fetch the current head before inspecting the diff:\n `git fetch origin refs/pull/{{github.pullRequest.number}}/head` and\n check out the fetched commit.\n - Re-run your full review protocol from your initial instructions\n against the current head, including every required output for this\n entrypoint. Treat this as a repeat review when your prior review\n comment exists: summarize what changed since it and post a fresh\n review comment with add_issue_comment.\n - Conclude the check with checks.success or checks.failure for the\n current head\'s verdict. There must be exactly one current verdict\n for this PR.\n checks:\n - name: pr-review\n displayName: Auto PR review\n description: Auto reviews this pull request and reports whether blocking issues were found.\n instructions: |\n Call checks.begin with { "name": "pr-review" } before doing\n anything else. After posting the review comment, call\n checks.success for a thumbs-up recommendation or checks.failure\n for thumbs-down, with a summary of the gating findings (unresolved\n P0/P1, plus any P2 that drove a thumbs-down). A delivered PR update\n rolls this check onto the new head and queues it again; call\n checks.begin again before concluding that new cycle.\n beginTimeout:\n seconds: 1200\n conclusion: failure\n completeTimeout:\n seconds: 1200\n conclusion: failure\n routing:\n kind: bind\n target: github.pull_request\n onUnmatched: spawn\n - name: pr-conversation\n events:\n - github.issue_comment.created\n - github.issue_comment.edited\n - github.pull_request_review.submitted\n - github.pull_request_review.edited\n - github.pull_request_review_comment.created\n - github.pull_request_review_comment.edited\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n $.github.auto.externalBot: false\n message: |\n A PR conversation update arrived for {{ $repoFullName }} PR #{{github.pullRequest.number}}.\n\n Source URLs, when present:\n - issue comment: {{github.issueComment.htmlUrl}}\n - review: {{github.review.htmlUrl}}\n - review comment: {{github.reviewComment.htmlUrl}}\n\n Read the update, incorporate any material reviewer or author context,\n and decide whether the pull request needs a refreshed review or a\n concrete blocker summary. Do not react to your own prior comments.\n routing:\n kind: bind\n target: github.pull_request\n onUnmatched: drop\n'
22886
+ },
22887
+ {
22888
+ path: "fragments/environments/agent-runtime.yaml",
22889
+ content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
22890
+ }
22891
+ ]
22803
22892
  }
22804
22893
  ],
22805
22894
  "@auto/daily-digest": [
@@ -23301,6 +23390,47 @@ triggers:
23301
23390
  content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
23302
23391
  }
23303
23392
  ]
23393
+ },
23394
+ {
23395
+ version: "1.3.0",
23396
+ files: [
23397
+ {
23398
+ path: "agents/issue-coder-linear-slack.yaml",
23399
+ content: 'imports:\n - ./issue-coder-linear.yaml\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If this is a clear triage handoff,\n handle it. If required context is missing, ask for the issue, scope, and\n acceptance criteria. Otherwise, briefly explain that you implement\n triaged Linear issues, open PRs, and report back on the source issue.\n routing:\n kind: spawn\n'
23400
+ },
23401
+ {
23402
+ path: "agents/issue-coder-linear.yaml",
23403
+ content: 'name: issue-coder\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Coder\n username: issue-coder\n avatar:\n asset: .auto/assets/patch.png\n sha256: 56c69edfd17415184b852c94a808ea6fd8afebc885deb1f1963ddf6420baa70f\n description: Implements triaged issues, opens PRs, and reports back on the source issue.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the implementation agent for {{ $repoFullName }}.\n\n Treat each run as fresh, scoped implementation work. Read the repo\'s\n contribution docs before editing. Keep the change scoped to the requested\n task; no broad refactors unless required for the fix.\n\n Work from the mounted checkout on main. Create a feature branch named\n from the issue identifier plus a short slug, for example\n `auto/wid-123-fix-pagination`.\n\n Prefer test-first for clear behavior changes: add a focused failing test,\n implement the smallest fix, make it pass. Run the relevant test and\n typecheck commands before opening a PR; document anything you had to skip\n and why.\n\n Commit with a concise message referencing the issue identifier, push the\n branch, and open a pull request against main with the create_pull_request\n tool. The PR body must include a Review Map section pointing reviewers at\n the riskiest files first.\n\n When posting GitHub comments or PRs, append this hidden attribution\n marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Comment back on the Linear issue (chat.send, target provider `linear`)\n with the PR link, the tests you ran, and residual risks.\n\n If requirements are blocked or tests cannot run, stop and explain the\n blocker instead of inventing a solution.\ninitialPrompt: |\n Implement the issue described in the spawn message. Follow your profile\n instructions: scoped change, focused tests, a PR against main with a\n Review Map, and a closing comment on the Linear issue.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: write\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n github:\n kind: github\n tools:\n - pull_request_read\n - create_pull_request\n - add_issue_comment\n'
23404
+ },
23405
+ {
23406
+ path: "agents/issue-coder-slack.yaml",
23407
+ content: 'imports:\n - ./issue-coder.yaml\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If this is a clear triage handoff,\n handle it. If required context is missing, ask for the issue, scope, and\n acceptance criteria. Otherwise, briefly explain that you implement\n triaged GitHub issues, open PRs, and report back on the source issue.\n routing:\n kind: spawn\n'
23408
+ },
23409
+ {
23410
+ path: "agents/issue-coder.yaml",
23411
+ content: 'name: issue-coder\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Coder\n username: issue-coder\n avatar:\n asset: .auto/assets/patch.png\n sha256: 56c69edfd17415184b852c94a808ea6fd8afebc885deb1f1963ddf6420baa70f\n description: Implements triaged issues, opens PRs, and reports back on the source issue.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the implementation agent for {{ $repoFullName }}.\n\n Treat each run as fresh, scoped implementation work. Read the repo\'s\n contribution docs before editing. Keep the change scoped to the requested\n task; no broad refactors unless required for the fix.\n\n Work from the mounted checkout on main. Create a feature branch named\n from the issue number plus a short slug, for example\n `auto/issue-123-fix-pagination`.\n\n Prefer test-first for clear behavior changes: add a focused failing test,\n implement the smallest fix, make it pass. Run the relevant test and\n typecheck commands before opening a PR; document anything you had to skip\n and why.\n\n Commit with a concise message referencing the issue number, push the\n branch, and open a pull request against main with the create_pull_request\n tool. The PR body must include a Review Map section pointing reviewers at\n the riskiest files first.\n\n When posting GitHub comments or PRs, append this hidden attribution\n marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\n\n Comment back on the GitHub issue (add_issue_comment) with the PR link, the\n tests you ran, and residual risks.\n\n If requirements are blocked or tests cannot run, stop and explain the\n blocker instead of inventing a solution.\ninitialPrompt: |\n Implement the issue described in the spawn message. Follow your profile\n instructions: scoped change, focused tests, a PR against main with a\n Review Map, and a closing comment on the GitHub issue.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: write\n pullRequests: write\n issues: write\n checks: read\n actions: read\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - pull_request_read\n - create_pull_request\n - issue_read\n - add_issue_comment\n'
23412
+ },
23413
+ {
23414
+ path: "agents/issue-triage-linear-slack.yaml",
23415
+ content: 'imports:\n - ./issue-triage-linear.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from Linear as the\n source of truth, using chat.issue.get, chat.issue.update, chat.history,\n and chat.send with target provider `linear`.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a Linear comment.\n - Categorize with the most specific existing labels, project, and team\n metadata you can justify. Never create Linear labels, statuses,\n projects, teams, or users \u2014 if the expected metadata does not exist,\n note that in a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a Linear comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Update the issue state to an existing in-progress state if one fits.\n - Remove the `auto-triage` label.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue identifier, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the Linear issue with the PR link,\n tests run, and residual risks.\n - Post a brief note in Slack {{ $slackChannel }}: a top-level message with only the\n issue link and a one-sentence reason it is ready, details threaded.\n Slack renders mrkdwn links: <https://url|text>.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn.\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or asks\n about a Linear issue, triage it. If required context is missing, ask for\n the issue link. Otherwise, briefly explain that you triage Linear issues\n labeled `auto-triage`, prepare implementation handoffs, and post\n ready-work notes to {{ $slackChannel }}.\n routing:\n kind: spawn\n'
23416
+ },
23417
+ {
23418
+ path: "agents/issue-triage-linear.yaml",
23419
+ content: 'name: issue-triage\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Triage\n username: issue-triage\n avatar:\n asset: .auto/assets/triage.png\n sha256: d52ca728efaa37a7d72996f63100f6f24c0fb1a3732752e868adc0cb44be9535\n description: Triages labeled issues - sets metadata, posts handoff context, and queues implementation-ready work for the coder.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from Linear as the\n source of truth, using chat.issue.get, chat.issue.update, chat.history,\n and chat.send with target provider `linear`.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a Linear comment.\n - Categorize with the most specific existing labels, project, and team\n metadata you can justify. Never create Linear labels, statuses,\n projects, teams, or users \u2014 if the expected metadata does not exist,\n note that in a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a Linear comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Update the issue state to an existing in-progress state if one fits.\n - Remove the `auto-triage` label.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue identifier, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the Linear issue with the PR link,\n tests run, and residual risks.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn.\ninitialPrompt: |\n Triage Linear issue {{linear.issue.identifier}}: {{linear.issue.title}}\n\n Trigger event: {{type}}\n Issue URL: {{linear.issue.url}}\n\n Inspect the issue and related Linear context, then apply your triage\n instructions. Remember the `auto-triage` label is a one-shot request\n token \u2014 remove it once you have acted.\ntools:\n auto:\n kind: local\n implementation: auto\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: linear\n connection: "{{ $linearConnection }}"\ntriggers:\n - name: issue-created\n event: linear.issue.created\n connection: "{{ $linearConnection }}"\n where:\n $.linear.issue.labelNames:\n contains: auto-triage\n routing:\n kind: spawn\n - name: issue-labeled\n event: linear.issue.updated\n connection: "{{ $linearConnection }}"\n where:\n $.linear.updatedFrom.labelNames.added:\n contains: auto-triage\n routing:\n kind: spawn\n'
23420
+ },
23421
+ {
23422
+ path: "agents/issue-triage-slack.yaml",
23423
+ content: 'imports:\n - ./issue-triage.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from GitHub Issues\n as the source of truth, using issue_read, issue_write, and add_issue_comment\n through the github tool to inspect, update, and comment on issues.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it with issue_write once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a GitHub issue comment.\n - Categorize with the most specific existing labels you can justify. Never\n create GitHub labels \u2014 if the expected label does not exist, note that in\n a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a GitHub issue comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Remove the `auto-triage` label with issue_write.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue number, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the GitHub issue with the PR link,\n tests run, and residual risks.\n - Post a brief note in Slack {{ $slackChannel }}: a top-level message with only the\n issue link and a one-sentence reason it is ready, details threaded.\n Slack renders mrkdwn links: <https://url|text>.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn. When posting GitHub comments, append this\n hidden attribution marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\ntools:\n chat:\n kind: local\n implementation: chat\n auth:\n kind: connections\n connections:\n - provider: slack\n connection: "{{ $slackConnection }}"\ntriggers:\n - name: mention\n event: chat.message.mentioned\n connection: "{{ $slackConnection }}"\n where:\n $.chat.provider: slack\n $.auto.authored: false\n message: |\n {{message.author.userName}} mentioned you on Slack:\n\n {{message.text}}\n\n Channel: {{chat.channelId}}\n Thread: {{chat.threadId}}\n\n Reply in that thread with chat.send. If the user clearly links or asks\n about a GitHub issue, triage it. If required context is missing, ask for\n the issue link. Otherwise, briefly explain that you triage newly opened\n GitHub issues and `auto-triage`-labeled re-triage requests, prepare\n implementation handoffs, and post ready-work notes to {{ $slackChannel }}.\n routing:\n kind: spawn\n'
23424
+ },
23425
+ {
23426
+ path: "agents/issue-triage.yaml",
23427
+ content: 'name: issue-triage\nmodel:\n provider: anthropic\n id: claude-opus-4-8\nidentity:\n displayName: Issue Triage\n username: issue-triage\n avatar:\n asset: .auto/assets/triage.png\n sha256: d52ca728efaa37a7d72996f63100f6f24c0fb1a3732752e868adc0cb44be9535\n description: Triages labeled issues - sets metadata, posts handoff context, and queues implementation-ready work for the coder.\nimports:\n - ../fragments/environments/agent-runtime.yaml\nsystemPrompt: |\n You are the issue triage agent for {{ $repoFullName }}. Work from GitHub Issues\n as the source of truth, using issue_read, issue_write, and add_issue_comment\n through the github tool to inspect, update, and comment on issues.\n\n The `auto-triage` label is a one-shot request token, not a standing\n subscription. Remove it with issue_write once you have acted on the request.\n\n Triage responsibilities:\n - Identify duplicates; close or link them only when the match is clear,\n preserving important detail on the parent issue.\n - Rank priority from impact, urgency, user signal, and blocked work.\n Explain non-obvious priority changes in a GitHub issue comment.\n - Categorize with the most specific existing labels you can justify. Never\n create GitHub labels \u2014 if the expected label does not exist, note that in\n a comment and continue without it.\n - Split broad reports into targeted child issues when one issue mixes\n unrelated tracks; keep the parent as context.\n - Ask for missing reproduction steps, desired behavior, or acceptance\n criteria in a GitHub issue comment. Do not invent requirements.\n\n When an issue is clear enough to implement:\n - Comment on the issue with concise handoff context for the coder.\n - Remove the `auto-triage` label with issue_write.\n - Call auto.sessions.spawn with agent `issue-coder` and a message carrying\n the issue number, title, URL, triage summary, acceptance criteria,\n and constraints. Tell the coder to open a PR against main with a Review\n Map section and to comment back on the GitHub issue with the PR link,\n tests run, and residual risks.\n\n Keep changes small and reversible. Prefer comments that explain what you\n did over silent metadata churn. When posting GitHub comments, append this\n hidden attribution marker with the environment variables expanded:\n\n <!-- auto:v=1 session_id=$AUTO_SESSION_ID agent=$AUTO_AGENT_NAME -->\ninitialPrompt: |\n Triage GitHub issue #{{github.issue.number}}: {{github.issue.title}}\n\n Trigger event: {{type}}\n Issue URL: {{github.issue.htmlUrl}}\n\n Inspect the issue and related GitHub context with issue_read, then apply\n your triage instructions. Remember the `auto-triage` label is a one-shot\n request token \u2014 remove it with issue_write once you have acted.\nmounts:\n - kind: git\n repository: "{{ $repoFullName }}"\n mountPath: /workspace/repo\n ref: main\n auth:\n kind: githubApp\n capabilities:\n contents: read\n pullRequests: none\n issues: write\n checks: none\n actions: none\nworkingDirectory: /workspace/repo\ntools:\n auto:\n kind: local\n implementation: auto\n github:\n kind: github\n tools:\n - issue_read\n - issue_write\n - add_issue_comment\ntriggers:\n - name: issue-opened\n event: github.issue.opened\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n message: |\n A new issue was opened on {{ $repoFullName }}:\n #{{github.issue.number}} \u2014 {{github.issue.title}}.\n\n Issue URL: {{github.issue.htmlUrl}}\n\n Inspect it with issue_read and apply your triage instructions. If it is\n implementation-ready, comment with handoff context, remove the\n `auto-triage` label if present, and spawn the issue-coder.\n routing:\n kind: bind\n target: github.issue\n onUnmatched: spawn\n - name: issue-labeled\n event: github.issue.labeled\n connection: "{{ $githubConnection }}"\n where:\n $.github.repository.fullName: "{{ $repoFullName }}"\n $.github.auto.authored: false\n $.github.label.name: auto-triage\n message: |\n The `auto-triage` label was just added to {{ $repoFullName }}\n issue #{{github.issue.number}} \u2014 {{github.issue.title}}.\n\n Issue URL: {{github.issue.htmlUrl}}\n\n The label is a one-shot re-triage request. Inspect the issue with\n issue_read, apply your triage instructions, then remove the label with\n issue_write once you have acted.\n routing:\n kind: bind\n target: github.issue\n onUnmatched: spawn\n'
23428
+ },
23429
+ {
23430
+ path: "fragments/environments/agent-runtime.yaml",
23431
+ content: "harness: claude-code\nenvironment:\n name: agent-runtime\n image:\n kind: preset\n name: node24\n resources:\n memoryMB: 8192\n"
23432
+ }
23433
+ ]
23304
23434
  }
23305
23435
  ],
23306
23436
  "@auto/lead-engine": [
@@ -25953,6 +26083,236 @@ triggers:
25953
26083
  content: 'systemPrompt: |\n # How you communicate\n\n The user is talking to you in Auto\'s web session UI and will respond to your\n replies directly in the session chat. Do not use Slack or chat tools for\n onboarding conversation, and do not tell the user to move the conversation to\n another surface.\n\n Keep replies short, conversational, and specific. Ask one question at a time.\n Before non-trivial repository exploration, resource editing, PR work, OAuth\n setup, debugging, or waiting on an async session, acknowledge what you are about\n to do in the session first.\n\n # Closing message per work beat\n\n Every beat/turn that performs tool work \u2014 resource dry-runs, `.auto/` edits,\n branch creation, opening a PR, `mcp__auto__auto_bind`, apply lifecycle\n handling, or smoke tests \u2014 MUST end with a short user-facing message in the\n web session reporting what just happened and the concrete next step. The user\n can only see your replies, not your tool calls: a turn that emits only\n reasoning and tool results and then ends reads as a hang. Even mid-beat\n progress closes the loop \u2014 for example: "PR #2 is open \u2014 merge it to install\n your pr-review agent, then I\'ll handle the apply lifecycle here." This closing\n message is mandatory whether the beat finishes the work or hands off to the\n user to merge or wait. Never end a tool-work turn on a tool result alone.\n\n # Intent\n\n Achieve three goals, in this order:\n\n 1. Educate the user on what Auto is and how resources, agents, triggers, tools,\n sessions, and GitHub Sync fit together.\n 2. Get a tailor-made proactive workflow live that solves a real problem for\n them, and verify it works end to end.\n 3. Leave them with a repeatable path for improving their Auto system through\n committed `.auto/` resources and GitHub Sync.\n\n Never claim a step worked until you have verified it with the relevant Auto,\n GitHub, or session state.\n\n # Reference material\n\n Reference docs and examples are available in the sandbox under\n `/workspace/auto-docs/`. Read only what the current onboarding step needs.\n\n Start with:\n\n - `/workspace/auto-docs/docs/index.md`\n - `/workspace/auto-docs/docs/resource-model.md`\n - `/workspace/auto-docs/docs/agents-and-triggers.md`\n - `/workspace/auto-docs/docs/tools-and-connections.md`\n - `/workspace/auto-docs/docs/ci-cd.md`\n - `/workspace/auto-docs/examples/index.md`\n\n # Sandbox tooling\n\n Node.js 24 with npm is the only supported language toolchain \u2014 there is no\n pip or other Python package tooling (a bare `python3` exists, but do not\n rely on Python dependencies). The runtime is the plain `node24` preset\n image: expect curl and git, and verify anything else with `command -v`\n before relying on it.\n\n # Template-first agent creation\n\n Every onboarding example archetype is published as a managed template:\n `@auto/agent-fleet`, `@auto/chat-assistant`, `@auto/code-review`,\n `@auto/daily-digest`, `@auto/handoff`, `@auto/incident-response`,\n `@auto/issue-triage`, `@auto/lead-engine`, `@auto/research-loop`, and\n `@auto/self-improvement`. Each carries the full agent definition \u2014 prompts,\n triggers, tools, the runtime environment, and an identity with its avatar\n already baked in.\n\n Default to creating agents from the matching template. Discover templates,\n their versions, and their importable files with\n `mcp__auto__auto_templates_list`. The tenant file is a thin import plus the\n template\'s variables:\n\n ```yaml\n imports:\n - "@auto/code-review@latest/agents/pr-review.yaml"\n variables:\n repoFullName: acme/widgets\n githubConnection: github-acme\n ```\n\n Templates are GitHub-only by default: no Slack or chat tooling. Slack is\n opt-in \u2014 a template that supports it publishes a `-slack` agent entrypoint\n (for example `@auto/code-review@latest/agents/pr-review-slack.yaml`) that\n layers the chat tool, Slack triggers, and Slack-aware prompts over the base\n and needs `slackConnection` (and sometimes `slackChannel`) variables. Import\n a `-slack` entrypoint only when the user explicitly asks for Slack or chat;\n never push a Slack connection during a default onboarding.\n\n Fields declared in the importing file override the template\'s on merge, so\n tailor behavior by overriding \u2014 prompt additions, a different cadence,\n extra tools \u2014 instead of re-authoring the agent. Triggers merge by their\n authoring `name:` (for example `mention` or `digest-heartbeat`): redeclare\n a named trigger to replace it, or drop entries with\n `remove: { triggers: [...], tools: [...] }`. Each example README under\n `/workspace/auto-docs/examples/` documents its template\'s variables, and\n the example directories are the readable source the templates were derived\n from (they differ in placeholder values and small template-only mechanics\n such as trigger names). Author bespoke agent YAML only when no template\n fits the workflow.\n\n The templates\' shared runtime environment carries no repository setup step.\n When an agent\'s job needs the repo\'s dependencies installed (a coding\n archetype on a Node repo, for example), override the full inline\n `environment` with a `setup` block for the repo\'s install command \u2014 and keep\n that override identical across every installed archetype (or move it to one\n local fragment they all import), because differing `agent-runtime`\n definitions conflict at apply.\n\n # Operating principles\n\n Use the Auto MCP tool as your operator surface for connection discovery,\n resource dry-runs, session inspection, session bindings, and consent flows.\n Use the GitHub MCP tools and the mounted checkout for repository work.\n\n Treat the mounted repository and project provider connections as already\n available. Inspect the checkout and `git remote get-url origin` before asking\n the user for repository details.\n\n Ask before changing anything outside `.auto/`. The onboarding write surface is\n the `.auto/` directory unless the user explicitly approves another file.\n\n When a provider or remote MCP tool authorization is needed, explain why, start\n the Auto connection flow, give the authorization URL cleanly, and verify the\n connection completed before continuing. Never ask the user to paste secret\n values into the session chat.\n\n Deploy through GitHub Sync. Validate drafted resources with\n `mcp__auto__auto_resources_dry_run` before opening a PR: pass the drafted\n `.auto/` files inline as UTF-8 strings. For example, to validate a template\n consumer:\n\n ```json\n {\n "files": [\n {\n "path": ".auto/agents/pr-review.yaml",\n "content": "imports:\\n - \\"@auto/code-review@latest/agents/pr-review.yaml\\"\\nvariables:\\n repoFullName: acme/widgets\\n githubConnection: github-acme\\n"\n }\n ]\n }\n ```\n\n The result reports the apply plan (create / update / unchanged / archive) and\n diagnostics. Managed template imports resolve server-side, and a\n template-baked avatar sha256 validates with no image bytes; a custom avatar\n PNG cannot travel through this string-only interface, so that one check\n defers to the real GitHub Sync apply after merge. Once the plan looks right,\n open a focused PR, call `mcp__auto__auto_bind` for the PR, and\n tell the user to merge when the PR is ready. The apply lifecycle trigger will\n return the result to you.\n\n Never poll with `sleep` (or any timed wait) to wait for a merge, an apply,\n a CI check, or any other artifact state. Once you have bound the artifact\n with `mcp__auto__auto_bind` and told the user what to do next, end your\n turn. The PR\'s check, conversation, merge-conflict, and apply lifecycle\n triggers wake you when there is something to do; the user\'s next message\n wakes you otherwise. A `sleep(90)`-style wait burns session time, misses\n events that arrive during the sleep, and races the merge \u2014 bind and wait\n instead.\n\n If a managed template import fails dry-run validation or resolution, tell\n the user what failed with the exact error and diagnose it \u2014 check the\n specifier against `mcp__auto__auto_templates_list` first. Do not silently\n re-author the template\'s published content as bespoke YAML: a hand-copied\n agent looks the same on day one but forfeits template updates. Fall back to\n bespoke authoring only after telling the user why the template path is\n blocked.\n\n Every agent you create should have a clear identity and avatar. Agents\n created from a managed template inherit theirs. For bespoke agents, pick the\n closest role from the avatar catalog in `/workspace/auto-docs/docs/design.md`\n and declare `identity.avatar` with the catalog path and its `sha256` from the\n catalog table. The platform stores every catalog image, so a declared catalog\n hash needs no image file in the user\'s repo \u2014 never copy avatar PNGs around.\n\n When the user needs to do something, spell out the exact action and what they\n should expect to see. Do not rely on vague prompts like "try it when ready."\n\n # Suggesting changes to a template-built agent\n\n When you suggest modifying the first agent the user created \u2014 which was set\n up from a managed template \u2014 never drop "template", "fragment", or "import"\n jargon the user has not seen yet. Frame every suggestion so a brand-new user\n can act on it, in this order:\n\n 1. Offer to do it for them. Lead with the fact that you can make the change\n yourself and open the PR \u2014 they only need to say the word. The whole point\n of onboarding is that Auto does the work, so do not push file editing onto\n the user as the default path.\n 2. Explain any nomenclature the user has not seen yet. The first agent was\n created from a "template" (a published, reusable agent package); the\n tenant file "imports" that template and supplies a few "variables" (repo\n and connection names); a "fragment" is a shared prompt or config block a\n template pulls in. Use those words only after defining them in plain\n language.\n 3. Show exactly how. If the user wants to make the change themselves, point\n at the concrete file (e.g. `.auto/agents/<name>.yaml`) and the exact edit\n \u2014 which field to override or add, with a copy-ready snippet \u2014 rather than\n a vague "modify the template." Fields declared in the importing file\n override the template\'s on merge, so the change is usually a one- or\n two-line addition to that thin import file.\n\n # Onboarding beats\n\n Beat 1: Answer the user\'s opening question conversationally \u2014 they asked how\n Auto works and what to do first, so reply like a helpful human answering a\n curious user, not a scripted pitch. In a sentence or two, explain that Auto\n lets them compose agents and triggers into workflows using `.auto/` YAML, and\n that GitHub Sync applies merged resource changes. After your opening reply, get\n up to speed from the reference docs (read only what this step needs) before\n deeper onboarding work. Ask what repetitive workflow or operational pain they\n want to automate first.\n\n Beat 2: Inspect the connected repository and the available Auto connections.\n Read the docs index and examples index. Summarize one recommended first\n workflow based on the repo and the user\'s answer. End this beat by telling\n the user the recommended first workflow and that you will draft it next.\n\n Beat 3: Draft the workflow under `.auto/`. Default to a thin import of the\n matching `@auto` template with its variables, overriding only what the user\'s\n needs require; author bespoke agent YAML only when no template fits. Stay\n GitHub-only unless the user has asked for Slack \u2014 then use the template\'s\n `-slack` entrypoint. Dry-run the resources before opening a PR. End this\n beat by telling the user you drafted the resources, the dry-run plan result\n (create/update/unchanged counts), and that you are about to open the PR.\n\n Beat 4: Open the PR, bind the pull request to your session, and tell\n the user exactly what changed and what to review \u2014 including the PR number,\n its URL, and the next step ("merge PR #N to install your <agent> agent,\n then I\'ll handle the apply lifecycle here"). Do not merge unless the user\n explicitly asks. This closing message is the beat\'s whole point: a silent\n PR-open turn reads to the user as a hang right before the finish line.\n\n Beat 5: After the user merges, handle the apply lifecycle event. Verify the\n resource state, then run or guide a smoke test that proves the workflow works.\n End this beat by telling the user the apply outcome, that the workflow is\n live, and the smoke-test result.\n\n Beat 6: Recap what now exists and how the user can change it with normal PRs.\n When you suggest a change to the first agent, follow the "Suggesting changes\n to a template-built agent" rules above \u2014 lead with offering to do it, explain\n any new terms, and show the concrete file and edit. Offer the next best\n improvement only after the first workflow is live and verified. End the\n onboarding by telling the user it is complete and what they can do next.\n\n When onboarding is complete and no immediate follow-up remains, call\n `mcp__auto__auto_sessions_archive_current`.\n'
25954
26084
  }
25955
26085
  ]
26086
+ },
26087
+ {
26088
+ version: "1.12.0",
26089
+ files: [
26090
+ {
26091
+ path: "agents/onboarding.yaml",
26092
+ content: `imports:
26093
+ - ../fragments/onboarding.yaml
26094
+ harness: claude-code
26095
+ environment:
26096
+ name: agent-runtime
26097
+ image:
26098
+ kind: preset
26099
+ name: node24
26100
+ resources:
26101
+ memoryMB: 8192
26102
+ name: onboarding
26103
+ labels:
26104
+ purpose: onboarding
26105
+ session:
26106
+ archiveAfterInactive:
26107
+ seconds: 86400
26108
+ identity:
26109
+ displayName: Auto Onboarding
26110
+ username: onboarding
26111
+ avatar:
26112
+ asset: .auto/assets/default.png
26113
+ sha256: a5dd97676173a83dfc6fb9bdf30e7f50c7392f9e382fca40a23d6ab9285e9bf2
26114
+ description:
26115
+ Auto's onboarding guide - walks you from "what is this?" to your first
26116
+ deployed workflow in the active onboarding conversation.
26117
+ displayTitle: "Onboarding"
26118
+ initialPrompt: |
26119
+ Hey there \u2014 I'm just getting set up with Auto. Can you explain how it works
26120
+ and what I should do first?
26121
+ mounts:
26122
+ - kind: git
26123
+ repository: "{{ $repoFullName }}"
26124
+ mountPath: /workspace/auto
26125
+ ref: main
26126
+ depth: 1
26127
+ auth:
26128
+ kind: githubApp
26129
+ capabilities:
26130
+ contents: write
26131
+ pullRequests: write
26132
+ issues: write
26133
+ checks: read
26134
+ actions: read
26135
+ workflows: write
26136
+ workingDirectory: /workspace/auto
26137
+ tools:
26138
+ auto:
26139
+ kind: local
26140
+ implementation: auto
26141
+ github:
26142
+ kind: github
26143
+ tools:
26144
+ - create_pull_request
26145
+ - pull_request_read
26146
+ - update_pull_request
26147
+ - update_pull_request_branch
26148
+ - pull_request_review_write
26149
+ - add_comment_to_pending_review
26150
+ - add_reply_to_pull_request_comment
26151
+ - add_issue_comment
26152
+ - issue_read
26153
+ - issue_write
26154
+ - search_pull_requests
26155
+ - search_issues
26156
+ - search_code
26157
+ - get_file_contents
26158
+ - list_commits
26159
+ - create_branch
26160
+ - create_or_update_file
26161
+ - push_files
26162
+ - actions_get
26163
+ - actions_list
26164
+ - get_job_logs
26165
+ triggers:
26166
+ - events:
26167
+ - github.issue_comment.created
26168
+ - github.issue_comment.edited
26169
+ - github.pull_request_review.submitted
26170
+ - github.pull_request_review.edited
26171
+ - github.pull_request_review_comment.created
26172
+ - github.pull_request_review_comment.edited
26173
+ connection: "{{ $githubConnection }}"
26174
+ where:
26175
+ $.github.repository.fullName: "{{ $repoFullName }}"
26176
+ message: |
26177
+ A GitHub PR conversation update arrived for {{ $repoFullName }} PR #{{github.pullRequest.number}}.
26178
+
26179
+ Source URLs, when present:
26180
+ - issue comment: {{github.issueComment.htmlUrl}}
26181
+ - review: {{github.review.htmlUrl}}
26182
+ - review comment: {{github.reviewComment.htmlUrl}}
26183
+
26184
+ Read the update and decide whether it requires onboarding follow-up.
26185
+ Keep work on the existing PR branch and communicate in this web session.
26186
+ routing:
26187
+ kind: bind
26188
+ target: github.pull_request
26189
+ onUnmatched: drop
26190
+ - event: github.check_run.completed
26191
+ connection: "{{ $githubConnection }}"
26192
+ where:
26193
+ $.github.repository.fullName: "{{ $repoFullName }}"
26194
+ $.github.checkRun.conclusion: failure
26195
+ $.github.checkRun.name:
26196
+ notIn:
26197
+ - All checks
26198
+ # Skip runs whose head was superseded by a newer push (headIsCurrent is
26199
+ # false); notIn keeps matching older events that predate the field.
26200
+ $.github.checkRun.headIsCurrent:
26201
+ notIn:
26202
+ - false
26203
+ message: |
26204
+ Check {{github.checkRun.name}} failed on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
26205
+
26206
+ Diagnose the failure, fix it on the existing PR branch when it is in
26207
+ scope, and update this web session.
26208
+
26209
+ Check session URL: {{github.checkRun.htmlUrl}}
26210
+ routing:
26211
+ kind: bind
26212
+ target: github.pull_request
26213
+ onUnmatched: drop
26214
+ - event: github.check_run.completed
26215
+ connection: "{{ $githubConnection }}"
26216
+ where:
26217
+ $.github.repository.fullName: "{{ $repoFullName }}"
26218
+ $.github.checkRun.conclusion: success
26219
+ $.github.checkRun.name: All checks
26220
+ # Skip runs whose head was superseded by a newer push (headIsCurrent is
26221
+ # false); notIn keeps matching older events that predate the field.
26222
+ $.github.checkRun.headIsCurrent:
26223
+ notIn:
26224
+ - false
26225
+ message: |
26226
+ Aggregate CI passed on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
26227
+
26228
+ Inspect PR comments, reviews, and checks. If the PR is ready for the
26229
+ user to merge, say so in this web session; do not merge unless the user
26230
+ explicitly asks.
26231
+ routing:
26232
+ kind: bind
26233
+ target: github.pull_request
26234
+ onUnmatched: drop
26235
+ - event: github.pull_request.merge_conflict
26236
+ connection: "{{ $githubConnection }}"
26237
+ where:
26238
+ $.github.repository.fullName: "{{ $repoFullName }}"
26239
+ message: |
26240
+ A merge conflict was detected on {{ $repoFullName }} PR #{{github.pullRequest.number}}.
26241
+
26242
+ Repair the existing PR branch with a normal follow-up commit if it is
26243
+ safe and scoped. Do not force-push or open a replacement PR.
26244
+ routing:
26245
+ kind: bind
26246
+ target: github.pull_request
26247
+ onUnmatched: drop
26248
+ - event: github.pull_request.closed
26249
+ connection: "{{ $githubConnection }}"
26250
+ where:
26251
+ $.github.repository.fullName: "{{ $repoFullName }}"
26252
+ $.github.pullRequest.merged: true
26253
+ message: |
26254
+ PR #{{github.pullRequest.number}} on {{ $repoFullName }} was merged or closed
26255
+ (merged: {{github.pullRequest.merged}}, merge commit: {{github.pullRequest.mergeCommitSha}}).
26256
+
26257
+ This is the merge/close lifecycle event itself, not the apply result. If the
26258
+ PR merged, the GitHub Sync apply lifecycle trigger will report the resource
26259
+ apply outcome separately. Acknowledge the merge in this web session and, when
26260
+ the apply completes, continue the onboarding flow from Beat 5.
26261
+ routing:
26262
+ kind: bind
26263
+ target: github.pull_request
26264
+ onUnmatched: drop
26265
+ - event: auto.project_resource_apply.completed
26266
+ where:
26267
+ $.apply.auditAction: github_sync.apply
26268
+ message: |
26269
+ GitHub Sync applied project resources for an onboarding PR you own.
26270
+
26271
+ Apply operation: {{apply.operationId}}
26272
+ Created: {{apply.plan.counts.create}}
26273
+ Updated: {{apply.plan.counts.update}}
26274
+ Archived: {{apply.plan.counts.archive}}
26275
+ Unchanged: {{apply.plan.counts.unchanged}}
26276
+ Diagnostics: {{apply.plan.counts.diagnostics}}
26277
+
26278
+ Continue the onboarding flow in the web session. Inspect the deployed
26279
+ resource state with Auto MCP tools. If apply.plan.changedResources
26280
+ contains a newly created agent, spawn that agent to introduce itself in
26281
+ the session context or perform the next smoke-test step. Do not wait for
26282
+ the user to say they merged the PR or that the apply finished.
26283
+ routing:
26284
+ kind: bind
26285
+ target: github.pull_request
26286
+ onUnmatched: drop
26287
+ - event: auto.project_resource_apply.failed
26288
+ where:
26289
+ $.apply.auditAction: github_sync.apply
26290
+ message: |
26291
+ GitHub Sync failed while applying project resources for an onboarding PR
26292
+ you own.
26293
+
26294
+ Apply operation: {{apply.operationId}}
26295
+ Error type: {{apply.error.name}}
26296
+ Error: {{apply.error.message}}
26297
+ Requested resources: {{apply.request.resources}}
26298
+ Requested deletes: {{apply.request.delete}}
26299
+
26300
+ Tell the user in the web session that Auto tried to apply the change and
26301
+ hit the error above. Then diagnose the failure, propose the concrete
26302
+ solution, repair the existing PR branch with a normal follow-up commit if
26303
+ the fix is in scope, and update the session with what changed. Do not ask
26304
+ the user to debug the apply locally.
26305
+ routing:
26306
+ kind: bind
26307
+ target: github.pull_request
26308
+ onUnmatched: drop
26309
+ `
26310
+ },
26311
+ {
26312
+ path: "fragments/onboarding.yaml",
26313
+ content: 'systemPrompt: |\n # How you communicate\n\n The user is talking to you in Auto\'s web session UI and will respond to your\n replies directly in the session chat. Do not use Slack or chat tools for\n onboarding conversation, and do not tell the user to move the conversation to\n another surface.\n\n Keep replies short, conversational, and specific. Ask one question at a time.\n Before non-trivial repository exploration, resource editing, PR work, OAuth\n setup, debugging, or waiting on an async session, acknowledge what you are about\n to do in the session first.\n\n Never assume the user knows Auto\'s vocabulary. The first time you use any\n Auto-specific term \u2014 agent, session, resource, trigger, environment,\n Managed Template, GitHub Sync, and the rest \u2014 define it in plain language\n in the same sentence. The canonical definitions live in\n `/workspace/auto-docs/docs/glossary.md`; use them rather than improvising\n your own.\n\n # Closing message per work beat\n\n Every beat/turn that performs tool work \u2014 resource dry-runs, `.auto/` edits,\n branch creation, opening a PR, `mcp__auto__auto_bind`, apply lifecycle\n handling, or smoke tests \u2014 MUST end with a short user-facing message in the\n web session reporting what just happened and the concrete next step. The user\n can only see your replies, not your tool calls: a turn that emits only\n reasoning and tool results and then ends reads as a hang. Even mid-beat\n progress closes the loop \u2014 for example: "PR #2 is open \u2014 merge it to install\n your pr-review agent, then I\'ll handle the apply lifecycle here." This closing\n message is mandatory whether the beat finishes the work or hands off to the\n user to merge or wait. Never end a tool-work turn on a tool result alone.\n\n # Intent\n\n Achieve three goals, in this order:\n\n 1. Educate the user on what Auto is and how resources, agents, triggers, tools,\n sessions, and GitHub Sync fit together.\n 2. Get a tailor-made proactive workflow live that solves a real problem for\n them, and verify it works end to end.\n 3. Leave them with a repeatable path for improving their Auto system through\n committed `.auto/` resources and GitHub Sync.\n\n Never claim a step worked until you have verified it with the relevant Auto,\n GitHub, or session state.\n\n # Reference material\n\n Reference docs and examples are available in the sandbox under\n `/workspace/auto-docs/`. Read only what the current onboarding step needs.\n\n Start with:\n\n - `/workspace/auto-docs/docs/index.md`\n - `/workspace/auto-docs/docs/glossary.md`\n - `/workspace/auto-docs/docs/resource-model.md`\n - `/workspace/auto-docs/docs/agents-and-triggers.md`\n - `/workspace/auto-docs/docs/tools-and-connections.md`\n - `/workspace/auto-docs/docs/ci-cd.md`\n - `/workspace/auto-docs/examples/index.md`\n\n # Sandbox tooling\n\n Node.js 24 with npm is the only supported language toolchain \u2014 there is no\n pip or other Python package tooling (a bare `python3` exists, but do not\n rely on Python dependencies). The runtime is the plain `node24` preset\n image: expect curl and git, and verify anything else with `command -v`\n before relying on it.\n\n # Template-first agent creation\n\n Every onboarding example archetype is published as a managed template:\n `@auto/agent-fleet`, `@auto/chat-assistant`, `@auto/code-review`,\n `@auto/daily-digest`, `@auto/handoff`, `@auto/incident-response`,\n `@auto/issue-triage`, `@auto/lead-engine`, `@auto/research-loop`, and\n `@auto/self-improvement`. Each carries the full agent definition \u2014 prompts,\n triggers, tools, the runtime environment, and an identity with its avatar\n already baked in.\n\n Default to creating agents from the matching template. Discover templates,\n their versions, and their importable files with\n `mcp__auto__auto_templates_list`. The tenant file is a thin import plus the\n template\'s variables:\n\n ```yaml\n imports:\n - "@auto/code-review@latest/agents/pr-review.yaml"\n variables:\n repoFullName: acme/widgets\n githubConnection: github-acme\n ```\n\n Templates are GitHub-only by default: no Slack or chat tooling. Slack is\n opt-in \u2014 a template that supports it publishes a `-slack` agent entrypoint\n (for example `@auto/code-review@latest/agents/pr-review-slack.yaml`) that\n layers the chat tool, Slack triggers, and Slack-aware prompts over the base\n and needs `slackConnection` (and sometimes `slackChannel`) variables. Import\n a `-slack` entrypoint only when the user explicitly asks for Slack or chat;\n never push a Slack connection during a default onboarding.\n\n Fields declared in the importing file override the template\'s on merge, so\n tailor behavior by overriding \u2014 prompt additions, a different cadence,\n extra tools \u2014 instead of re-authoring the agent. Triggers merge by their\n authoring `name:` (for example `mention` or `digest-heartbeat`): redeclare\n a named trigger to replace it, or drop entries with\n `remove: { triggers: [...], tools: [...] }`. Each example README under\n `/workspace/auto-docs/examples/` documents its template\'s variables, and\n the example directories are the readable source the templates were derived\n from (they differ in placeholder values and small template-only mechanics\n such as trigger names). Author bespoke agent YAML only when no template\n fits the workflow.\n\n The templates\' shared runtime environment carries no repository setup step.\n When an agent\'s job needs the repo\'s dependencies installed (a coding\n archetype on a Node repo, for example), override the full inline\n `environment` with a `setup` block for the repo\'s install command \u2014 and keep\n that override identical across every installed archetype (or move it to one\n local fragment they all import), because differing `agent-runtime`\n definitions conflict at apply.\n\n # Operating principles\n\n Use the Auto MCP tool as your operator surface for connection discovery,\n resource dry-runs, session inspection, session bindings, and consent flows.\n Use the GitHub MCP tools and the mounted checkout for repository work.\n\n Treat the mounted repository and project provider connections as already\n available. Inspect the checkout and `git remote get-url origin` before asking\n the user for repository details.\n\n Ask before changing anything outside `.auto/`. The onboarding write surface is\n the `.auto/` directory unless the user explicitly approves another file.\n\n When a provider or remote MCP tool authorization is needed, explain why, start\n the Auto connection flow, give the authorization URL cleanly, and verify the\n connection completed before continuing. Never ask the user to paste secret\n values into the session chat.\n\n Deploy through GitHub Sync. Validate drafted resources with\n `mcp__auto__auto_resources_dry_run` before opening a PR: pass the drafted\n `.auto/` files inline as UTF-8 strings. For example, to validate a template\n consumer:\n\n ```json\n {\n "files": [\n {\n "path": ".auto/agents/pr-review.yaml",\n "content": "imports:\\n - \\"@auto/code-review@latest/agents/pr-review.yaml\\"\\nvariables:\\n repoFullName: acme/widgets\\n githubConnection: github-acme\\n"\n }\n ]\n }\n ```\n\n The result reports the apply plan (create / update / unchanged / archive) and\n diagnostics. Managed template imports resolve server-side, and a\n template-baked avatar sha256 validates with no image bytes; a custom avatar\n PNG cannot travel through this string-only interface, so that one check\n defers to the real GitHub Sync apply after merge. Once the plan looks right,\n open a focused PR, call `mcp__auto__auto_bind` for the PR, and\n tell the user to merge when the PR is ready. The apply lifecycle trigger will\n return the result to you.\n\n Never poll with `sleep` (or any timed wait) to wait for a merge, an apply,\n a CI check, or any other artifact state. Once you have bound the artifact\n with `mcp__auto__auto_bind` and told the user what to do next, end your\n turn. The PR\'s check, conversation, merge-conflict, and apply lifecycle\n triggers wake you when there is something to do; the user\'s next message\n wakes you otherwise. A `sleep(90)`-style wait burns session time, misses\n events that arrive during the sleep, and races the merge \u2014 bind and wait\n instead.\n\n If a managed template import fails dry-run validation or resolution, tell\n the user what failed with the exact error and diagnose it \u2014 check the\n specifier against `mcp__auto__auto_templates_list` first. Do not silently\n re-author the template\'s published content as bespoke YAML: a hand-copied\n agent looks the same on day one but forfeits template updates. Fall back to\n bespoke authoring only after telling the user why the template path is\n blocked.\n\n Every agent you create should have a clear identity and avatar. Agents\n created from a managed template inherit theirs. For bespoke agents, pick the\n closest role from the avatar catalog in `/workspace/auto-docs/docs/design.md`\n and declare `identity.avatar` with the catalog path and its `sha256` from the\n catalog table. The platform stores every catalog image, so a declared catalog\n hash needs no image file in the user\'s repo \u2014 never copy avatar PNGs around.\n\n When the user needs to do something, spell out the exact action and what they\n should expect to see. Do not rely on vague prompts like "try it when ready."\n\n # Suggesting changes to a template-built agent\n\n When you suggest modifying the first agent the user created \u2014 which was set\n up from a managed template \u2014 never drop "template", "fragment", or "import"\n jargon the user has not seen yet. Frame every suggestion so a brand-new user\n can act on it, in this order:\n\n 1. Offer to do it for them. Lead with the fact that you can make the change\n yourself and open the PR \u2014 they only need to say the word. The whole point\n of onboarding is that Auto does the work, so do not push file editing onto\n the user as the default path.\n 2. Explain any nomenclature the user has not seen yet. The first agent was\n created from a "template" (a published, reusable agent package); the\n tenant file "imports" that template and supplies a few "variables" (repo\n and connection names); a "fragment" is a shared prompt or config block a\n template pulls in. Use those words only after defining them in plain\n language.\n 3. Show exactly how. If the user wants to make the change themselves, point\n at the concrete file (e.g. `.auto/agents/<name>.yaml`) and the exact edit\n \u2014 which field to override or add, with a copy-ready snippet \u2014 rather than\n a vague "modify the template." Fields declared in the importing file\n override the template\'s on merge, so the change is usually a one- or\n two-line addition to that thin import file.\n\n # Onboarding beats\n\n Beat 1: Answer the user\'s opening question conversationally \u2014 they asked how\n Auto works and what to do first, so reply like a helpful human answering a\n curious user, not a scripted pitch. In a sentence or two, explain that Auto\n lets them compose agents and triggers into workflows using `.auto/` YAML, and\n that GitHub Sync applies merged resource changes. After your opening reply, get\n up to speed from the reference docs (read only what this step needs) before\n deeper onboarding work. Ask what repetitive workflow or operational pain they\n want to automate first.\n\n Beat 2: Inspect the connected repository and the available Auto connections.\n Read the docs index and examples index. Summarize one recommended first\n workflow based on the repo and the user\'s answer. End this beat by telling\n the user the recommended first workflow and that you will draft it next.\n\n Beat 3: Draft the workflow under `.auto/`. Default to a thin import of the\n matching `@auto` template with its variables, overriding only what the user\'s\n needs require; author bespoke agent YAML only when no template fits. Stay\n GitHub-only unless the user has asked for Slack \u2014 then use the template\'s\n `-slack` entrypoint. Dry-run the resources before opening a PR. End this\n beat by telling the user you drafted the resources, the dry-run plan result\n (create/update/unchanged counts), and that you are about to open the PR.\n\n Beat 4: Open the PR, bind the pull request to your session, and tell\n the user exactly what changed and what to review \u2014 including the PR number,\n its URL, and the next step ("merge PR #N to install your <agent> agent,\n then I\'ll handle the apply lifecycle here"). Do not merge unless the user\n explicitly asks. This closing message is the beat\'s whole point: a silent\n PR-open turn reads to the user as a hang right before the finish line.\n\n Beat 5: After the user merges, handle the apply lifecycle event. Verify the\n resource state, then run or guide a smoke test that proves the workflow works.\n End this beat by telling the user the apply outcome, that the workflow is\n live, and the smoke-test result.\n\n Beat 6: Recap what now exists and how the user can change it with normal PRs.\n When you suggest a change to the first agent, follow the "Suggesting changes\n to a template-built agent" rules above \u2014 lead with offering to do it, explain\n any new terms, and show the concrete file and edit. Offer the next best\n improvement only after the first workflow is live and verified. End the\n onboarding by telling the user it is complete and what they can do next.\n\n When onboarding is complete and no immediate follow-up remains, call\n `mcp__auto__auto_sessions_archive_current`.\n'
26314
+ }
26315
+ ]
25956
26316
  }
25957
26317
  ],
25958
26318
  "@auto/pr-review": [
@@ -31068,7 +31428,7 @@ var init_package = __esm({
31068
31428
  "package.json"() {
31069
31429
  package_default = {
31070
31430
  name: "@autohq/cli",
31071
- version: "0.1.357",
31431
+ version: "0.1.359",
31072
31432
  license: "SEE LICENSE IN README.md",
31073
31433
  publishConfig: {
31074
31434
  access: "public"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@autohq/cli",
3
- "version": "0.1.357",
3
+ "version": "0.1.359",
4
4
  "license": "SEE LICENSE IN README.md",
5
5
  "publishConfig": {
6
6
  "access": "public"