feat(maestro-case): delegate HITL action task authoring#2116
Draft
song-zhao-25 wants to merge 3 commits into
Draft
feat(maestro-case): delegate HITL action task authoring#2116song-zhao-25 wants to merge 3 commits into
song-zhao-25 wants to merge 3 commits into
Conversation
When a HITL action task has no resolvable deployed Action Center app, the case skill now authors an inline QuickForm (a <Label>.hitl.json schema + data.context[hitlType]="quick") instead of a placeholder. App-based tasks (a named app that resolves in action-apps-index.json) are unchanged; a named-but-missing app prompts QuickForm-or-placeholder. No coded-app sibling is built: QuickForm creates no tenant resource, no root bindings, and no sibling project. Interface matches uipath-human-in-the-loop's Case surface (PR #2056 Path 1). Core: action/planning.md (Path Selection + field derivation from wired I/O), action/impl-json.md (QuickForm task + .hitl.json shapes, case-vocab type map). Parity: SKILL.md, sdd-generation-rules.md, sdd-template.md, phase-0-interview.md, implementation.md, bindings/impl-json.md, registry-discovery.md — action leaves the placeholder-only category, QuickForm sits outside the agent/api sibling-create gate, with producer-scan and closure-audit exemptions. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.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.
What
Refactors the
uipath-maestro-caseaction path so Case owns orchestration intent and delegates HITL resource authoring touipath-human-in-the-loop.Every approved, non-placeholder
actiontask is handed to the HITL skill during Phase 2. Case no longer carries a private QuickForm/App JSON recipe or constructs action sidecars, context, resource bindings, recipients, or runtime I/O itself.Ownership boundary
uipath-human-in-the-loopownsDelegations run sequentially against the shared
caseplan.json. Case re-reads and verifies target placement, IDs, non-empty action data, and returned artifacts after each delegation. If the skill is unavailable or the result cannot be verified, Case writes the standard structuralactionplaceholder withdata: {}and records a build issue. It never improvises HITL JSON.This follows the repository isolation rule: there is no structural cross-skill dependency and Case never reads or copies sibling skill files. The dependency is a runtime handoff with a graceful placeholder fallback.
Planning and I/O handoff
The approved SDD remains the business contract.
tasks.mdpreserves:QuickFormor deployed Action App path;actionType;outputs:producer rows for lineage and cross-task references;tasks describeI/O contract.That information is passed to the HITL delegate as a self-contained brief. Case does not translate it into field directions, native HITL types, sidecar properties, context entries, or runtime arrays.
Relationship to #2056
This PR has a strong behavioral/runtime dependency on #2056, but no file-level dependency.
#2056 is intentionally out of scope for this PR and will be fixed by its owning team. Keep #2116 draft/held until the compatible #2056 fix is available in the integration base.
Regression coverage
The existing
quickform_runtime_iointegration task now verifies both halves of the contract:skill_triggeredrequiresuipath-human-in-the-loopto be invoked by the Case build;HitlTaskArgumentsinput and output mappings in BPMN;Verification
Passed locally:
git diff --checkquick_validate.py skills/uipath-maestro-casenpm run version:checkpython3 scripts/check-skill-status.py --check-readmecoder-eval planforquickform_runtime_io.yamlA full local coder-eval execution still requires an authenticated Claude CLI and the compatible #2056 implementation. The existing
maestro-case checker unit testsCI failure is an unrelated pytest collection collision between two pre-existingtest_checkers.pymodules; this PR does not modify either module.