Repository navigation
Add declarative connectors and migrate native provider integrations - #74077
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ures Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contract tests, build, format, Go lint and custom lint pass. Existing full-workflow drift gate reports unrelated lockfile drift; no workflow sources or compiler behavior changed. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add real HTTP MCP registration and constrained SDK adapter, typed safe-output staging and execution, JSON Patch, resource/evidence checks and untrusted context projection. Integration tests exercise all capability types with local TLS/MCP services only. Focused lint passes; required gate attempted, blocked by shared linter lock and pre-existing unrelated workflow drift. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add bounded nested input binding, trusted Jira ADF/Confluence storage encoders, response/request identity checks, native evidence type checks, recursive JSON Schema, and adversarial tests. Full connector race tests and impacted tests pass; final required gate attempted, blocked by another session's golangci-lint lock. Focused standard/custom lint passes with safe parallel runner configuration. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…tter Resolve independently selected connector reads, context and effects into phase-restricted frozen runtime hosts. Preserve lossless structured values and full typed effect schemas; fail closed for unsupported ingress and work-queue effects. Focused connector/compiler/runtime tests pass. Required publication gates were attempted: branch-baseline cmd/gh-aw/main.go analyzer findings and a missing Azure provider spec fixture still block the complete gate. This is a shared integration checkpoint, not a fully validated release. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…clarations Exercise the shared contract and runtime with scoped Graph reads, local MCP facades, separate Bot Connector reply/card staging and offline positive/negative fixtures. Keep notification verification and bot conversation attestation explicitly unavailable until trusted deployment integration exists. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Keep external v1 definitions unchanged. Cover literal context recipes, independently omitted capabilities, documentation parity, and a native-ingress expected-failure artifact. New-grammar compiler checks await the shared compiler revision. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ures Add scoped Azure DevOps definitions, connection and binding fixtures, JSON Patch safe outputs, read-only remote MCP and authenticated context coverage. Document unified workflow selection and fail-closed ingress. Provider/runtime tests pass; the repository gate remains blocked by unrelated pre-existing workflow lock drift. New-grammar compiler coverage awaits the shared compiler dependency. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add centralized connector AW fixtures, strict compilation and phase-boundary regressions, local trusted-TLS execution, and authoring reference. Focused integration checks pass; the full gate remains blocked by concurrent golangci-lint and inherited cmd/gh-aw/main.go custom-linter findings. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Compile manual combined and context-only selections, assert phase-separated credential emission, and reject unavailable native ingress and out-of-scope context. Clarify that raw YAML fixtures need a Markdown frontmatter wrapper and document actual offline compiler evidence. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add Jira Cloud declarations, scoped auth and resource fixtures, centralized workflow examples, and offline provider/runtime/compiler conformance coverage. Preserve built-ins and document unavailable ingress, lifecycle predicates, and temporary-ID activation. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…low interface Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…interface Add scoped Confluence REST reads, bounded runbook context, fixed storage creates, Forge projection declarations, and grouped workflow examples. Exercise positive and negative parser/runtime/MCP/compiler behavior without live provider access. Hosted native MCP, verified ingress activation, and version-preflight updates remain explicit limitations. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ction Provider-only integration checkpoint, not release-ready. Offline Sentry new-grammar positive/negative compilation tests, full connectors tests, and scoped connectors/workflow golangci-lint pass. No live operations performed. Final make agent-report-progress gate: build/schema/impacted tests passed; broad Go lint blocked by shared runner lock and custom lint reports pre-existing cmd/gh-aw/main.go unchecked output/bounds findings. Earlier full drift gate reported unrelated existing workflow lock drift; no generated locks retained or repaired. Consolidated baseline verification remains with the coordinator. Known operational gaps: no approved webhook receiver/replay admission, nested stack scrubbing, automatic project preflight or event-bound effect authorization, OAuth acquisition/refresh. Hosted MCP content is not scrubbed context. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add scoped incident/requested-item manifests, phase-separated connection fixtures, manual capability selections, ingress rejection examples, bounded Table API runtime and real MCP adapter tests, and compiler credential boundary checks. Exclude state transitions and native remote MCP pending tenant-specific support. Validation: focused provider/compiler tests, race tests, and four CLI no-emit examples pass. Final required gate attempted; blocked by concurrent golangci-lint and existing cmd/gh-aw/main.go analyzer findings. Earlier whole-repository workflow drift also fails; generated files are preserved unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…undaries Add centralized Slack workflow examples, approved-channel thread reads and replies, isolated credentials, typed event/response IDs, and offline positive/negative runtime and compiler fixtures. Validation: focused shared/runtime/compiler tests, formatter, Go/custom lint, schema freshness and impacted unit tests pass. Final gate reports baseline-wide lock drift after recompilation; original locks preserved, no workflow sources changed. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Register external or inline connector specs through existing uses/with imports, select capabilities from native workflow sections, and reject reserved or ambiguous prefixes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Reuse ordinary imports with inline authority and scoped read/write capabilities. Remove configurable context and keep gateway events reference-only; custom ingress remains unavailable. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the shared embedded loader, exact resource bindings, authenticated created-resource receipts, all three native integration removals, and faithful Jira/Linear smoke consumers. Preserve explicit token, GitHub App, and GitHub OIDC routes and keep development runtime pins stable across generated-lock-only commits. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Canonicalize the authored HTTP MCP endpoint before fetch and response URL checks, preserving fixed-path and no-redirect guards. Interpret omitted protocol arguments as an empty object in Go and Node while retaining required-input and explicit-null rejection. Add regression coverage for root and normalized HTTPS URLs, same-origin endpoint changes, no-input local/remote tools, and required/invalid argument denial; document the protocol behavior. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
🍳 A little prep to help this PR along! Copilot assignment requested for the following outstanding work:
Keeping the changes focused; human review and CI get the final taste test. No merging or CI triggering. Structured data{
"completed_task": 0,
"head": "53f43743fa33edf707163ba98cabeb55d986a0dd",
"kind": "requested",
"schema_version": "1",
"state": "1f9f414547c18ac3330304d7069d6750d58bd765d2431d12754aee8012697ac1",
"work": [
"51e2287c3d1ee41b7e13769862add61dcd292a623cf943abc5968c984e246bcf",
"c7cf93e497befdd5e698d00101b0703e4101fe4133d86d433f7c170d07402b7e"
],
"workflow": "pr-sous-chef"
}
|
Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com>
Merge main at ef36c0c while preserving newer branch history and connector prompt/authority safeguards. Regenerate the conflicted smoke-issues lock from merged source, recompile365 workflows and refresh the canonical connector guide inventory. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Visual regression check: blockedThe docs page could not be loaded from the sandbox, so no screenshots were captured and no visual or accessibility comparison was done.
Screenshot status
Next actions
Warning Firewall blocked 2 domainsThe following domains were blocked by the firewall during workflow execution:
To allow these domains, add them to the network:
allowed:
- defaults
- "host.docker.internal"
- "update.googleapis.com"See Network Configuration for more information.
|
|
🍳 A little prep to help this PR along! Copilot assignment requested for the following outstanding work:
Keeping the changes focused; human review and CI get the final taste test. No merging or CI triggering. Structured data{
"completed_task": 0,
"head": "08f84d107365db842d35009828dc9ebc652085cf",
"kind": "requested",
"schema_version": "1",
"state": "50cc634757572e652f1f610116f55e6350f3cbb3456df537cc5a909625375dd7",
"work": [
"51e2287c3d1ee41b7e13769862add61dcd292a623cf943abc5968c984e246bcf"
],
"workflow": "pr-sous-chef"
}
|
Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com>
|
@copilot resolve the merge conflicts in this pull request |
…terface-design # Conflicts: # pkg/workflow/compiler_validators.go Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Merged |
|
🍳 A little prep to help this PR along! Copilot assignment requested for the following outstanding work:
Keeping the changes focused; human review and CI get the final taste test. No merging or CI triggering. Structured data{
"completed_task": 0,
"head": "8d951d7c193d6824f8f58ded68434cf3f6db658f",
"kind": "requested",
"schema_version": "1",
"state": "2884f1ca3d78d77ecbad1213cc1c13a56abfd9bfd18701ea3dcdcca580a4784e",
"work": [
"42e5d572d9d75b7168fe7d0aeda0717cc07e65ed240f6d299e6fec661214f1ac"
],
"workflow": "pr-sous-chef"
}
|
Merge main at 40af6db. Preserve both connector and OpenAI WIF version validator imports, regenerate all365 workflows and restore the canonical connector guide inventory. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Preserve the concurrently published identical main merge without overwriting remote history. The validated source tree is unchanged, including canonical connector guide inventory. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Merge main at 5b0c3b8. Resolve shared safe-output registration conflicts by retaining new advisory outputs and identity-bound local diagnostics alongside connector budgets and threat-warning policies, without restoring removed native provider handlers. Preserve both guidance tests and regenerate compiled workflows from merged sources. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Visual regression checkPreview served from the built docs at `(127.0.0.1/redacted) and checked in the sandbox with Playwright CLI.
Comparison: no authorized baseline is provisioned for this workflow, so no visual diff was made. These results are not evidence of "unchanged". Accessibility: the page snapshot exposes alt text on the landing-page images, including the Copilot prompt, terminal and Actions run screenshots, and the agent logos. The snapshot was only partly reviewed (targeted grep for image and unlabeled elements), so this is not a complete accessibility audit. Console: 0 errors and 3 to 4 warnings on load. Some shell reads (dependency directory check, readiness curl, snapshot scan) were denied by workflow tool permissions. The preview still answered and the page loaded through Playwright, so capture was not blocked. Warning Firewall blocked 1 domainThe following domain was blocked by the firewall during workflow execution:
To allow these domains, add them to the network:
allowed:
- defaults
- "update.googleapis.com"See Network Configuration for more information.
|
Use bounded exact Azure branch membership and numeric Sentry gateway evidence. Align Jira echoed-comment response bounds, setup recipes and safe observed HTTP diagnostics without exposing provider payloads. Repair Datadog network and Teams resource guidance, and include ServiceNow provisioning XML in setup output. Add explicit plain and compact-plain body publication using the shared sanitizer, typed redaction, protected attribution and code-point sizing. Jira ADF preserves literal text; Zendesk prepares documented whitespace and non-HTML provenance before staging and sending while retaining exact private/ticket/audit/body checks and no ambiguous retries. Regenerate affected workflow plans and cover the fixes through actual compiler/runtime regressions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Visual regression check: docs landing pageBuilt docs preview captured at three viewports inside the sandbox. No authorized baseline is provisioned, so visual comparison is unavailable for every capture. No capture was marked unchanged.
Accessibility observations
ConsoleNo errors. Four WebGL GPU stall warnings appeared on first load. These are not accessibility issues. Scope and limitations
Next actions
References: §42975960967 Warning Firewall blocked 1 domainThe following domain was blocked by the firewall during workflow execution:
To allow these domains, add them to the network:
allowed:
- defaults
- "update.googleapis.com"See Network Configuration for more information.
|
Validate all13 public provider declarations as compiler-normalized JSON through the registered Cobra command. Add real binary integration coverage for YAML/JSON inputs, paths with spaces, mixed valid/invalid/missing definitions, required arguments, process exit statuses and JSON-only stdout with error summaries on stderr. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Visual regression check: docs home pageCaptured the built docs preview at
Accessibility observations
This is a partial inspection of the snapshot output, not an exhaustive accessibility audit. No automated accessibility rules were run. Run details
Warning Firewall blocked 1 domainThe following domain was blocked by the firewall during workflow execution:
To allow these domains, add them to the network:
allowed:
- defaults
- "update.googleapis.com"See Network Configuration for more information.
|
Extend the existing connector setup command with explicit read-only repository name inventory and targeted provisioning commands. Derive phase-specific token, trusted-input and GitHub App settings from declaration metadata, preserve offline guidance, and report unknown inventory on errors without collecting values or changing settings. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Visual regression check: docs previewOverview: All three viewports were captured successfully. Visual comparison is unavailable because no authorized baseline is provisioned for this workflow, so no page is reported as unchanged. Accessibility inspection found items to verify. Capture and comparison
Screenshots were saved inside the sandbox at /tmp/gh-aw/agent/ (screenshot-mobile.png, screenshot-tablet.png, screenshot-desktop.png). They are not attached to this comment. Accessibility observationsBased on one accessibility snapshot taken at the desktop viewport. This is not an exhaustive compliance audit.
Run details
References: §42981008261 Warning Firewall blocked 1 domainThe following domain was blocked by the firewall during workflow execution:
To allow these domains, add them to the network:
allowed:
- defaults
- "update.googleapis.com"See Network Configuration for more information.
|
Add a bounded Asana task reader and separately authorized plain-text comment append with task/workspace correlation and a writer-owned membership check. Include scoped OAuth setup guidance, a staged source-only golden consumer, and actual frozen Go/Node conformance with identity, publication, response, and credential-free staging coverage. Register Asana in the existing compiler, documentation, setup, and CLI validation matrices without provider-specific runtime code or live ingress. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
🎉 This pull request is included in a new release. Release: |
ADR: ADR-74077: Declarative Connectors Replace Native Provider Integrations - Proposed, pending maintainer review; no approval is implied.
Motivation
Replace provider-specific compiler/runtime handlers with editable declarative connectors and a shared execution boundary. Keep the exposed MCP tool set small and targeted; exhaustive historical parity is not the goal.
Authoring and selection
Declarations live under
.github/workflows/connectors/<id>.mdand use ordinary local or reviewed pinned remoteimportswithuses/with. There is no built-in provider catalog, hidden fallback, generated provider bundle or compiler rebuild requirement for downstream declaration edits. The 13 experimental examples are Linear, Jira, Azure DevOps, Slack, Teams, Confluence, Sentry, ServiceNow, GitLab, PagerDuty, Datadog, Zendesk and Notion. Each cites official sources and includes XML authoring documentation and consumer examples.Importing selects nothing and grants no provider access. Select bounded REST/GraphQL reads, reviewed hosted MCP methods, safe outputs and protected gateway triggers independently. Only selected phase capabilities, endpoint/resource grants and credential references enter content-addressed runtime snapshots. Provider evidence comes through selected reads, not automatic context hydration.
Consumer example: bind resources and select capabilities
Keep a reviewed copy of the complete Notion declaration at
.github/workflows/connectors/notion.md. A consumer can expose one metadata reader and one staged comment:Save the consumer as
.github/workflows/notion-page-check.mdand replace the specimen page UUID in both the grant and prompt.reader-secretandwriter-secretare Actions secret names, never token values. For this Notion route, the reader connection needs Read content and the approved page must be shared with it. A separately authorized live-comment deployment needs its own Insert comments connection and page sharing. Staging needs no writer secret and publishes no comment; it does not suppress the metadata read.copilot-requests: writeauthorizes model inference, not provider writes.The same import can be pinned instead of copied locally:
Declaration configuration: author-owned endpoint, credentials and grants
The provider declaration defines the contract;
import-schemadefines the consumer's configurable bindings. This configuration excerpt comes from the Notion declaration; its typed reader, mutation, fixed request and response-validation definitions are omitted here and remain in the complete linked file:secretis the supported shorthand fortoken.secret; provider scopes describe requirements, not permission grants. The complete declaration bindspage-idtopages, rejects out-of-grant targets before credentials, and validates returned identities. The YAML selectorget-pagemaps to the existing callable readerget_page; the selected effect is callednotion_add_comment. No provider-specific executable code is needed.Use
gh aw connector notion setupfor offline binding/authentication guidance andgh aw compile notion-page-check --strict --no-emitfor configuration validation; neither dispatches a run. The connector specification and create-connector skill cover adding another provider. Linear's current GraphQL defaults are separately namedLINEAR_READ_API_KEYandLINEAR_WRITE_API_KEY; shared-key compatibility requires explicitly binding both inputs toLINEAR_API_KEY, with no automatic fallback.Compile-only evidence and credential review: the complete consumer above compiled with
--strict --no-emitagainst the pinned declaration. The compiler reported experimental-connector and new restrictedNOTION_READ_TOKENnotices. That reference is the declared agent-phase reader credential for the fixedapi.notion.comroute; the staged writer is not delivered. No new action or redirect changes were reported, no secret values were read, and no workflow or provider call was started. Actual connection permissions, page sharing and token validity remain deployment checks, not established by compilation.Hosted MCP example: select one native method
This configuration excerpt exposes one hosted Jira method without JQL search:
Replace specimen IDs and provision the named reader credential. Unknown methods, wildcards, duplicates and empty subsets reject; typed arguments, exact grants and phase credentials remain enforced. The service-account profile supports the same subset syntax. Legacy full-profile selections remain available when deliberately needed; fixed local reads keep list syntax.
Providers and practical scenarios
All 13 providers are experimental editable declarations, not built-in integrations or live-readiness certifications. Importing enables nothing: consumers independently select reads, safe outputs and protected triggers. The table describes the narrow golden scenario for each provider; declarations may expose additional explicitly selected capabilities.
personal: [getJiraIssue]read for first-response triage; independent bounded REST readers are also declared.ado-*handlers are not restored.sys_idresponse does not prove journal persistence.Golden consumer fixtures live under
pkg/cli/workflows/<provider>-golden.md; schema-enabled compiler tests andmake compile-cli-workflowscompile every one in an isolated deployment layout. Each golden selects a small reader surface and onemax: 1staged task effect. Staging suppresses writes and writer credential delivery, not reads. Provider provisioning, consent, refresh, actual visibility, and receiver deployment/enrollment remain external; protected trigger compilation is not working webhook ingress.Source-only golden workflow fixtures
All 13 common-scenario goldens live beside CLI test workflows at
pkg/cli/workflows/<provider>-golden.md, not in the active Actions workflow directory. Their contents were preserved byte-for-byte during relocation; their 13 generated active.lock.ymlfiles were removed. Editable provider declarations remain at their original paths.The goldens cover issue triage, a work-item engineering handoff, short-thread decisions/actions, approved Teams tasks, runbook readiness, known-error investigation, incident shift handoff, MR intake, responder checks, monitor investigation, private support-to-engineering ownership, and timestamp-based reference maintenance. Each uses manual dispatch, exact specimen grants, a minimal provider read surface, one
max: 1staged task effect, and Bash/edit/CLI proxy disabled. GitHub readers are disabled except for Confluence's two explicit duplicate-check methods. Framework reporting/noop tools are not counted as task effects.TestConnectorGoldenWorkflowsactually compiles every source with schema validation in an isolated.github/workflowsdeployment layout, preserving import confinement, exact advertisement/reader/credential/effect assertions, exhaustive fixture matching and staged writer omission.make compile-cli-workflowsindependently compiles all 13 source-only goldens with--validate --strict --no-emit, without relying on companion lock discovery. Setup still discovers the local fixtures offline. Adopting a fixture means copying it into the deployment layout with the reviewed declaration and replacing all specimen bindings; these files do not themselves add active Actions workflows.The existing examples comment remains pinned to its historical source revision. Current paths, integration evidence and setup limits are documented in the human reference and
.github/aw/connectors.md. Metadata-only sources do not become diagnostic/body readers through prompting; some goldens deliberately use a GitHub handoff rather than a placeholder or insufficiently verified provider writer.Connector safe-output samples
Connector selections accept the existing deterministic MCP replay samples contract: a single argument object or an array of objects, validated against the generated connector tool input schema. For example, with a matching declared operation:
features.samples: trueorgh aw compile --use-samplesuses the ordinary MCPtools/callreplay path instead of the agent. Declaring samples alone does not enable replay or change tool advertisement. Built-ins retain their existing replay order, then connector tools are sorted by name and samples retain authored order. Missing-sample coverage warnings include connector selections.Replay is not staging or a dry run. Samples are data, not instructions, resource grants or delivery policy. Exact resources, phase credentials, sanitization, threat policy and proposal budgets still apply; excess samples do not increase
max. Generated plans/digests, tool schemas, scripts and handler policy are unchanged by sample data. Keep previews staged.Runtime expression values now travel separately from static replay JSON and are bound only to authored string slots after parsing. Event text cannot create a different tool, argument object or patch sidecar. Schema normalization matches built-in placeholder validation for enums and length limits. Regressions cover invalid shapes/payloads, required fields/types/lengths/enums/patterns, unknown authority/control arguments, feature/flag modes, expression validation, built-in coexistence, credential-free resource denial and real offline stdio MCP replay, including crafted text that previously could inject replay control fields.
Connector-aware repository configuration
gh aw init,gh aw newandgh aw secrets bootstrapdiscover repository-local declarations, wrappers and importing consumers/goldens offline, without displaying binding values or fetching remote imports.gh aw connector <id> setupshows input types/required/default availability, declared endpoints, phase credentials/scopes, andcredentialsplusauthenticationXML metadata, including normal local/cached pinned wrappers. Required bindings use--input name=JSON; Zendesk needs both a subdomain and a string ticket ID. Extracted setup documentation is clearly marked as untrusted and fenced with collision-safe delimiters at the final presentation boundary; this is a trust cue, not a guarantee of immunity to prompt injection.gh aw edit --add-import/--remove-importaccept schema-validated normaluses/withobjects. Adding an import does not select tools, network permissions or grants. Setup/discovery do not activate capabilities or ingress. Bootstrap checks engine/system prerequisites only: provider provisioning, consent, refresh, ACLs and authorization remain external.An integrated CLI regression exercises setup against the actual bindings of all 13 relocated goldens. Init/new nonactivation, import edits, bounds/symlinks, cached pinned metadata and bootstrap messaging remain covered.
Shared execution and authority
The Node runtime ships with
actions/setup; no provider-specific checkout, runtime build or CLI installation is required. Go/Node enforce frozen typed plans, bounded transport, exact response/resource evidence, and separate character/byte limits. Selected reads do not create write grants, and independent grants do not prove parent/tenant/tuple membership.Staging suppresses mutations, writer credentials, preflights and creation receipts, not selected reads or arbitrary authored scripts. Global/compiler staging cannot be disabled by per-operation
false. Attempts use private dispatcher budgets (max1-100, default 1). Optional bounded retries never replay authorization failures, uncertain transport or evidence failures; writes additionally require explicitly repeat-safe idempotent PUT/PATCH/DELETE semantics. POST creates/appends cannot opt in.Human text uses shared trusted publication sanitizers and protected attribution/footers. Trusted destinations, bounded lookups/checks, authenticated creation receipts, fixed patch additions and content-addressed binary staging remain separate from agent-controlled text and returned URLs. Staged proposals never establish creation or follow-up authority. Node guarded file I/O requires Linux.
Matching connector XML is removed before substitution/prompt assembly; scanner path exemptions remain removed. Automatic legacy context fetching and agent-job context-file writes are removed, while selected reader App/OIDC credential minting remains intact. Legacy context input validation does not deliver context credentials or fetched output. The prompt's untrusted-data instruction now covers every selected connector, including read-only tools without context selection. Runtime URL imports remain rejected; reviewed pinned compile-time imports remain supported. Connector staging artifacts require successful built-in/custom redactors and initial recovery validation; later agent archives additionally require final recovery validation. Failed/skipped/cancelled validators do not permit upload.
Manifest provenance preserves the trusted handler result's connector identity before GitHub fallback, retaining explicit provider precedence without tool-prefix guessing. Staged proposals are not recorded as applied writes.
Protected triggers, separate ingress deployment
Flat
on.gateway-dispatch.<id>and qualified root selections lower to the same protected route; the removedconnectorswrapper is rejected. Repository opt-in, exclusive gateway routing, exact source grants, declared resource origins, approved App provenance and hash-bound admission are required. The obsolete nativejira-issueselection and its stale integration expectations are removed; this does not remove declarative Jira connector triggers.Seven Linear, seven Jira and eight Azure lifecycle selections use bounded typed source predicates and independent narrowing filters. Frozen predicates enforce 64 nodes, depth six, 100 array/membership values and 6,400 evaluation visits; exhaustion is unknown/nonmatching. UTF-8 ordering and semicolon URL handling are deterministic across Go/Node. Jira's shared native tool schema and Confluence's common page-trigger contract use YAML anchors with explicit event overrides; regression tests verify equivalent frozen plans and distinct event behavior across the import/Go/Node paths.
Compilation emits digest-bound subscriptions and admission gates; it does not deploy receivers, enroll sources, establish replay storage or authenticate actual provider deliveries. No provider dispatch or receiver deployment was performed.
Migration and practical limits
This is a breaking replacement of native Linear/Jira/Azure handlers and automatic credential wiring, not a legacy alias layer. Linear deliberately omits six long-tail reader families rather than adding an arbitrary forwarding proxy; bounded Jira and Azure capabilities retain explicit resource/identity evidence and independently selected methods.
After API-token authentication was enabled, the observed Jira MCP read changed from a policy denial to a tool-level 401 because the session token lacks the required scope claim. Historical REST writes do not establish hosted MCP authorization, and no identity fallback was added. Datadog OAuth eligibility is restricted to approved partner clients; ordinary API/application-key pairs are unsupported. Zendesk live-note normalization/event-order verification remains restrictive, so its golden uses a GitHub handoff. These are narrow experimental building blocks, not live-readiness certifications.
Validation and publication
Latest published branch:
ac84e5e721d680b98330d5acb29b6a348278ac57, withorigin/mainmerged throughf9185ad0c678540675ca6fa66d7043ad42c3dc5f. All 365 active workflow sources recompiled and all 13 source-only provider goldens compile. Connector-authoring normalization added complete binding descriptions and safe schema reuse; compiler-normalized contracts remain equivalent apart from the deliberate Linear credential-default separation documented above. Relevant Go/Node, TypeScript, documentation/link and scoped publication checks passed for this revision. Earlier validation below is historical evidence for its recorded snapshot, not a claim that all current hosted checks are green.Published review batch:
c48f0edda4840e7334c8706dd3d763364fd361dc, based on72cb5088a6ewith main merged through4f55248ba0c43e250147c7dc6a0988756a5fee53. Parent reviewed the parallel task results and made the final commit/push once. The ADR draft claimed by automation was absent; the proposed record is now actually published and linked above. No workflow allowlist was relaxed or skipped publication treated as success.The combined workflow/parser/CLI/connectors regression selector passes, including schema-enabled compilation of all relocated goldens, sample replay and provider authority boundaries. All 355 active workflows compile with zero lock drift; all 13 source-only CLI goldens compile separately. The tagged gateway integration suite passes against the source-built binary. Native/WASM builds, typecheck and 363 targeted JavaScript tests pass (three existing skips). Standard Go lint reports zero issues; schema freshness and JavaScript lint pass.
The final combined no-test gate remains nonzero for 15 custom-linter findings in unchanged existing
samples_replay.go/samples_validation.golines. All 15 map to exact pre-batch source lines in72cb5088a6e; no checks were disabled. New lint findings introduced during implementation were corrected. Earlier baseline init/edit/bootstrap findings remain outside this batch's scope. Child impacted-test gates and recorded focused parent validation passed;test-unitwas not repeatedly rerun.Earlier PR-caused CI fixes repair stale docs links/glossary, standalone session-parser bundled modules, checked-in agent guidance, lifecycle-context isolation and nested provider aliases without loosening alias safeguards. All four hosted JS shards passed at
acd76a6in run 41586423824. Main's Agy and WASM golden corrections are now merged. Visual gallery setup remains a separate pre-existing issue tracked in #74384. New hosted results for the latest head are not yet established.Credential/action compilation review
Golden reader references are names only:
AZURE_DEVOPS_READ_TOKEN,CONFLUENCE_READ_ACCESS_TOKEN,DATADOG_MONITOR_READ_OAUTH_TOKEN,GITLAB_READ_TOKEN,JIRA_MCP_PERSONAL_BASIC_AUTH,LINEAR_READ_API_KEY,NOTION_READ_TOKEN,PAGERDUTY_READ_AUTHORIZATION,SENTRY_MCP_OAUTH_TOKEN,SERVICENOW_READ_TOKEN,SLACK_READ_TOKEN,TEAMS_GRAPH_READ_ACCESS_TOKEN,ZENDESK_READ_OAUTH_TOKEN.Each reference was reviewed against its explicitly selected read phase, approved specimen resources and declared provider route; none introduces a writer credential into staged output or an arbitrary credential destination. Golden action references already existed in baseline workflows. This review batch adds no credential references, action repositories/pins or redirect changes; removing automatic legacy context fetches also removes those context credentials from agent-job delivery. No secret values were read or committed. Actual identity permissions, OAuth eligibility, consent, expiry and provider compatibility cannot be established offline and require author/human review before deployment.
Compiler/mock/fixture results are not LLM-output quality evidence or proof of real provider authentication or mutation delivery. No provider credentials were provisioned, provider mutations executed or ingress installed. A separately authorized read-only Jira smoke rerun was performed; its failed authorization does not establish successful provider access.