feat: add copilot-sdk engine front matter field by Copilot · Pull Request #35936 · github/gh-aw

Copilot · 2026-05-30T14:44:28Z

Adds a copilot-sdk boolean field to the Copilot engine front matter. When enabled, the harness starts and stops a separate headless Copilot CLI sidecar on the configured localhost port and propagates COPILOT_SDK_URI to child processes. The @github/copilot-sdk package is already bundled with the Copilot CLI, so no additional installation step is required. The feature is marked as experimental: the schema labels it accordingly and the compiler emits an experimental warning when engine.copilot-sdk is enabled.

engine:
  id: copilot
  copilot-sdk: true

Constants

DefaultCopilotSDKPort = 3002 in constants.go
CopilotSDKURIEnvVar (COPILOT_SDK_URI) in engine_constants.go

Compiler / workflow engine

Execution (copilot_engine_execution.go): injects COPILOT_SDK_URI=http://127.0.0.1:3002 into the step env, without changing the main Copilot CLI invocation into transport mode
Schema (main_workflow_schema.json): copilot-sdk boolean added to the extended engine config object with updated behavior description and experimental labeling
Validation (compiler_validators.go): emits Using experimental feature: engine.copilot-sdk when the field is enabled

JS harnesses

process_runner.cjs: exported buildCopilotSDKEnv() helper returns { COPILOT_SDK_URI } when COPILOT_SDK_URI is set, {} otherwise
copilot_sdk_sidecar.cjs: owns the Copilot SDK sidecar URL/port parsing plus spawn, readiness, and shutdown helpers
copilot_harness.cjs: starts a separate headless Copilot CLI sidecar with --headless --no-auto-update --port <configured-port>, waits for the port to become ready, forwards COPILOT_SDK_URI to child processes, and stops the sidecar when the run completes
Tests: added focused Go and JS coverage for the updated SDK sidecar lifecycle, compiler contract, and experimental warning behavior

> Generated by 👨‍🍳 PR Sous Chef · gpt54 23.8M · ◷

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-05-30T14:54:15Z

@copilot

merge main and recompile
find latest release version in github/copilot-sdk

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T15:21:00Z

@copilot

merge main and recompile

find latest release version in github/copilot-sdk

Done in b251421:

Merged main (resolved conflicts in the two lock files)
Latest @github/copilot-sdk npm release is v1.0.0-beta.10 — updated DefaultCopilotSDKVersion accordingly
Recompiled all 236 workflow lock files (0 errors)

pelikhan · 2026-05-30T15:23:19Z

@copilot copilot-sdk is installed by default with copilot-cli so the step does not need to be added when the copilot engine is used.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T15:30:58Z

@copilot copilot-sdk is installed by default with copilot-cli so the step does not need to be added when the copilot engine is used.

Done in the latest commit — removed the @github/copilot-sdk install step from GetInstallationSteps and cleaned up the now-unused DefaultCopilotSDKVersion / DefaultCopilotSDKPackage constants.

pelikhan · 2026-05-30T15:51:16Z

@copilot merge main and recompile

…-to-engine Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T16:07:31Z

@copilot merge main and recompile

Checked on 00c12b4375: this branch is already up to date with main, and make recompile completed cleanly with no diff.

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

github-actions · 2026-05-30T16:54:09Z

@copilot summarize the remaining blockers and rerun checks.

Generated by 👨‍🍳 PR Sous Chef · gpt54 24.3M · ◷

pelikhan · 2026-05-30T18:03:49Z

@copilot when the copilot-sdk is enabled, the copilot harness should start and stop a copilot cli process in headless mode with the correct port.

pelikhan · 2026-05-30T18:53:11Z

@copilot review all changes apply DRY / SOLID

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T19:08:31Z

@copilot review all changes apply DRY / SOLID

Addressed in 42a562b — centralized the copilot-sdk enablement check, made the sidecar lifecycle cleanup deterministic on startup/runtime failures, and tightened the lifecycle tests around listener cleanup.

pelikhan · 2026-05-30T19:11:41Z

+	// GHAWCopilotSDKEnvVar is the internal signal variable set by the compiler to tell
+	// the harness that copilot-sdk mode is active. The harness starts and stops the
+	// Copilot CLI headless sidecar and ensures COPILOT_SDK_URI is forwarded to child processes.
+	GHAWCopilotSDKEnvVar = "GH_AW_COPILOT_SDK"


@copilot this one is not needed, use copilot_sdk_uri

Fixed in a028e1a — removed the extra GH_AW_COPILOT_SDK signal and now use COPILOT_SDK_URI as the copilot-sdk activation signal in the compiler, harness helpers, and tests.

pelikhan · 2026-05-30T19:17:07Z

@copilot merge main, recompile, fix conflicts

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

github-actions · 2026-05-30T19:24:50Z

@copilot review all comments and address unresolved review feedback.

Generated by 👨‍🍳 PR Sous Chef · gpt54 23.8M · ◷

github-actions · 2026-05-30T19:24:51Z

Please refresh the branch, rerun checks, and summarize any remaining blockers.

Generated by 👨‍🍳 PR Sous Chef · gpt54 23.8M · ◷

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T19:34:51Z

@copilot merge main, recompile, fix conflicts

Done in a2ca54c — merged main, resolved the copilot_harness.cjs conflict, and ran make recompile successfully on the merged tree.

github-actions · 2026-05-30T19:53:31Z

@copilot refresh the branch and rerun checks, then summarize the remaining blockers.

Generated by 👨‍🍳 PR Sous Chef · gpt54 9.9M · ◷

pelikhan · 2026-05-30T20:08:11Z

@copilot mark as experimental

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-30T20:17:16Z

@copilot mark as experimental

Done in 8046680 — engine.copilot-sdk now emits an experimental compiler warning when enabled, and the schema text marks it as experimental.

github-actions · 2026-05-30T20:22:02Z

@copilot review all comments and address unresolved review feedback.

Generated by 👨‍🍳 PR Sous Chef · gpt54 5.8M · ◷

github-actions · 2026-05-30T20:22:02Z

@copilot summarize the remaining blockers and next steps.

Generated by 👨‍🍳 PR Sous Chef · gpt54 5.8M · ◷

Copilot AI and others added 3 commits May 30, 2026 14:35

chore: begin copilot-sdk feature implementation

549da6d

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

feat: add copilot-sdk engine front matter field

8f3bbb0

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

fix: improve schema example for copilot-sdk field

8be81b5

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI assigned Copilot and pelikhan May 30, 2026

Copilot created this pull request from a session on behalf of pelikhan May 30, 2026 14:44 View session

Copilot AI requested a review from pelikhan May 30, 2026 14:44

Copilot finished work on behalf of pelikhan May 30, 2026 14:44

Copilot started work on behalf of pelikhan May 30, 2026 15:12 View session

chore: merge main and update copilot-sdk version to 1.0.0-beta.10

b251421

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 15:21

Copilot started work on behalf of pelikhan May 30, 2026 15:23 View session

fix: remove copilot-sdk install step (bundled with copilot-cli)

afdd709

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 15:31

pelikhan marked this pull request as ready for review May 30, 2026 15:51

Copilot AI review requested due to automatic review settings May 30, 2026 15:51

Copilot started reviewing on behalf of pelikhan May 30, 2026 15:51 View session

Copilot started work on behalf of pelikhan May 30, 2026 15:56 View session

Merge remote-tracking branch 'origin/main' into copilot/add-sdk-field…

00c12b4

…-to-engine Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 16:07

Copilot AI reviewed May 30, 2026

View reviewed changes

Copilot started work on behalf of pelikhan May 30, 2026 18:04 View session

Copilot started work on behalf of pelikhan May 30, 2026 18:53 View session

Copilot AI and others added 4 commits May 30, 2026 19:05

fix: tighten copilot-sdk sidecar lifecycle

7aad140

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

fix: clean up copilot-sdk startup listeners

63e094a

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

test: annotate copilot-sdk startup hook

6e3fb9a

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

test: harden copilot-sdk lifecycle checks

42a562b

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 19:08

pelikhan reviewed May 30, 2026

View reviewed changes

Copilot started work on behalf of pelikhan May 30, 2026 19:11 View session

fix: use COPILOT_SDK_URI as copilot-sdk signal

a028e1a

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 19:22

Copilot AI requested a review from pelikhan May 30, 2026 19:22

Copilot started work on behalf of pelikhan May 30, 2026 19:22 View session

Merge main and recompile

a2ca54c

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 19:35

Copilot started work on behalf of pelikhan May 30, 2026 20:08 View session

Warn on experimental copilot-sdk

8046680

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 30, 2026 20:17

pelikhan merged commit b1ae2f1 into main May 30, 2026

pelikhan deleted the copilot/add-sdk-field-to-engine branch May 30, 2026 20:19

Conversation

Copilot AI commented May 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Constants

Compiler / workflow engine

JS harnesses

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

pelikhan May 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI May 30, 2026

Choose a reason for hiding this comment

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

pelikhan commented May 30, 2026

Uh oh!

Copilot AI commented May 30, 2026

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

github-actions Bot commented May 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 30, 2026 •

edited

Loading