Repository navigation
feat(servicenow): Connect auto-Setup handoff, merged connection step and Test/Prod realm workflow - #507
Open
DapheneShao wants to merge 32 commits into
Open
feat(servicenow): Connect auto-Setup handoff, merged connection step and Test/Prod realm workflow#507DapheneShao wants to merge 32 commits into
DapheneShao wants to merge 32 commits into
Conversation
…orkspace or agent is not prepared Chooser returns an automatic Setup handoff for an unprepared workspace (with or without a pasted agent link) and for a link to an agent new to the workspace. Entry docs follow the Workday prepare-at-entry pattern and the UX continue copy. Replaces the unpushed copy-only commit b303ba7a. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b83a72e2-ae5b-43db-a6be-06dd7e2dcdd8
…er to resume Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b83a72e2-ae5b-43db-a6be-06dd7e2dcdd8
…arate cancel wording Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b83a72e2-ae5b-43db-a6be-06dd7e2dcdd8
Use the design wording for the first handoff message, hand off to Setup's conflicting-environment flow for links in a different environment, return directly to Connect without Setup's summary, and name the canonical environment display-name source. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b83a72e2-ae5b-43db-a6be-06dd7e2dcdd8
Add a setup-incomplete chooser status so a Dev agent with pending Setup steps is not reported as unavailable. Connect resumes Setup's readiness checks once per invocation, confirms the agent only after the chooser returns ready, and passes the environment display name to Setup's attach command. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: b83a72e2-ae5b-43db-a6be-06dd7e2dcdd8
Add a full-steps Learn link below each administrator instruction heading and update the pinned instruction hashes and a structure assertion in tests. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…clause Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…o agent reply - Reword the Maker configuration availability question to include the ESS Maker / Agent Developer role; the phase-start Yes is recorded by the controller as the lifecycle role attestation, so agent-connection, topics and portal-url no longer show the Confirm role prompt. - topic-action-handoff returns replyBeforeQuestion (agent, environment, hash, inventory and inactive topic list) to show before the card; the card question is reduced to the enable/keep decision. - Align the two legend assertions with the shortened legend text. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Discover the promoted Test or Prod sibling of the recorded Dev agent from natural language or an agent link, reuse the Dev tenant foundation, and check Connections, Runtime configuration and Maker validation per realm. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
4 tasks done
… message 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>
…he copy block Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add short wording before the fenced message for the HRSD plugin card, the Entra handoff and the ServiceNow handoff. Fenced bodies unchanged. 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>
…st-result finish Wording only: connection, agent-connection, portal-url and test lead-ins; new first sentence of the portal URL question; final text states what the Maker-reported Test result covers. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Merge the credential and agent-connection phases into a single 'Create and connect ServiceNow' phase (HRSD 9->8, ITSM 8->7). - One instruction card; the maker confirms the connection is created and Connected. - One merged CREDENTIAL-001 flightcheck: connector-scoped inventory proof AND the agent's saved draft connection-reference proof. No manual attestation gate. - Recovery wording for not-selected, bound-elsewhere and binding-mismatch. - Lifecycle schema v13 migrates old credential + agent-connection states. - Merge prepare-credential.md and connect-agent.md; update docs and tests. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Remove Current task, Where and how, Expected nonsecret evidence, and Completion boundary from maker-visible cards (HR + ITSM). Cards now keep the main-journey lead-in, numbered steps or Ready-to-send message. Internal facts stay in controller JSON and action docs. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Portal URL, portal fallback, reuse, test, credential, plugin and topics questions no longer show key/value headers; portal question is one plain paragraph. Wording only. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…sages Add the unsupported-agent chooser result and entry-doc Messages for permission denied/unavailable, HR plugin not ready, admin pause/resume, conflicting Client IDs, unconfirmed custom claim, and existing SSO/Graph conflict, with tests. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Remove the Dev-Ready and Test-Ready gates; Dev record is an optional reference. Per-item read-only connection, topic and portal checks per realm. Connection problems are blocked with no repair or handoff and never reuse the Dev connection. Admin-confirmed values are retained only when they still apply to the agent, tenant and instance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the realm intro, Test-pane request, Done follow-up, completion scope, destination question, denied vs inconclusive access, and J/K/L/M recovery wording. Wording only; no state changes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…onal flow S5 Copy-only alignment with the S5 spec (rev 11): spec-form completion message, 'Validation is paused' connection findings, 'Retry the access check', recovery sentences for Dev-connection offers, untested Dev, realm changes, different instance, empty results and the full sign-in admin message. Tone cleanup: no all-caps BLOCKED, 'we' instead of 'Connect', 'your own deployment process' instead of ALM. No logic changes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Replace the technical timeout wording in the maker-visible preflight message with a short conversational sentence. Agent-facing progress-marker instructions are unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the maker-visible message before the portal URL question in both HR and IT action docs, and use 'ticket' wording in the IT controller lead-in. Wording only. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add an untested outcome for realm maker validation: saved in realms.json, never counted as a pass, shown as untested in status, and replaced by a later pass or fail run. Dev flow is unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Stop asking the maker for the User Claim up front; read it from the Entra administrator reply and ask a follow-up only when it is missing. Add the S4 coordination asks to the Entra handoff lead-in and S3/S4 branch Messages to the shared entry guide. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Remove the tenant ID from the maker-supplied values, the realms re-approval trigger, the ServiceNow OIDC guide and the servicenow-stage error. The OIDC Metadata URL stays auto-filled from the verified environment tenant and a mismatching admin-supplied tenant is still rejected. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
ServiceNow Connect (HR and IT) for
solutions/ess-maker-skills. This PR combines two parts: the Setup handoff, UX and wording work (formerly this PR) and the independent Test/Prod realm workflow (formerly #509, merged into this branch with no conflicts).Part 1: Setup handoff, UX and wording
/setuptyping), follows the UX design copy for message 1, and resumes when Setup is incomplete. Setup cancel or blocked wording asks the maker to fix the blocker and then ask to finish setup and connect again. Links to a different environment go through Setup's conflicting-environment flow. Setup's final summary is skipped when resumed from Connect. Supersedes the earlierb303ba7aidea.credential; HR 9 to 8 steps, IT 8 to 7). The maker confirms the connection is created and shows Connected. One merged CREDENTIAL-001 flightcheck verifies the connection inventory and the agent's saved connection reference, with specific recovery wording. Lifecycle schema v13 migrates existing state automatically.Part 2: Independent Test and Prod realm workflow (from #509)
The maker says the agent was promoted to Test or Prod, or pastes the Test or Prod agent link, in the same
/connectServiceNow flow (no new slash commands). The controller proves the exact promoted sibling of the recorded Dev agent; a Dev link or a link outside the family is rejected.BEFORE / AFTER
/setup; credential and binding were two steps with a manual attestation; cards showed internal blocks; Test and Prod could not be checked independently.Unverified and open items
Unchanged: Workday, the Entra/ServiceNow administrator instruction files and their SHA pins.
Related issue
Combines #507 and #509 (no GitHub issue).
Type of change
Testing
python -m ruff check solutions tests/scripts tests/setup tests/flightcheck: passed.python -m pytest tests/scripts/test_connect_servicenow_da.py tests/scripts/test_connect_servicenow_realms.py tests/scripts/test_connect_lifecycle.py tests/setup tests/flightcheck(plus telemetry tests): 3410 passed, 2 skipped, 1 failed.tests/setup/test_workday_da_orchestration.py::test_workday_topic_activation_uses_complete_mapped_scope, is pre-existing onmainand unrelated.Checklist
Static validation (samples/ only)
Not applicable: this PR does not touch
samples/.S5 wording alignment
Copy-only alignment of the Test/Prod realm wording to conversational_flow.md S5 (spec rev 11): spec-form completion message, "Validation is paused" connection findings, "Retry the access check", new recovery sentences (Dev connection offered, Dev untested, realm change, different instance, empty results, full sign-in admin message), and tone cleanup (no all-caps BLOCKED, "we" instead of "Connect", "your own deployment process" instead of ALM). No logic, state, SHA-pin or administrator-doc changes.
Also replaced the technical preflight discovery message (HTTP timeout wording) with a plain conversational sentence in both admin-preflight actions.
The portal-URL step now shows "Next, we'll make sure the agent's HR case / IT ticket links open in the right employee portal." as a normal reply before the question (HR and IT).
Test/Prod: finish without testing is saved as untested, never counted as a pass, and can be resumed later.
S3/S4: the claim name is now read from the Entra administrator's reply (no up-front claim question), and custom-claim and Knowledge-coexistence recovery messages were added to the Dev flow.
Tenant ID is no longer requested from the maker or administrators; the ServiceNow OIDC Metadata URL is filled from the verified environment tenant, and a mismatching tenant in an admin reply is still rejected.