You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit affd7dd
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/architecture/rfcs/agent-session-execution-modes-v0.md
+58-1Lines changed: 58 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -221,6 +221,54 @@ monitor, or lifecycle truth; conversation text as a receipt; a second scheduler
221
221
for the same binding; a Goal-wide default binding; and a mode change inferred
222
222
from a probe, a transport, or a prompt.
223
223
224
+
### Reusable Agent operations and continuation ownership
225
+
226
+
This proposed extension refines the managed-team delivery contract; it does not
227
+
add CLI flags, promote a host, or change existing session/profile defaults.
228
+
Keep three identities separate: the registered Agent, its current host session
229
+
and execution generation, and each work request/attempt. Creating an Agent is
230
+
not starting a process, attaching a session is not claiming work, and a returned
231
+
artifact is not accepted work.
232
+
233
+
| Operation family | Existing owner to reuse | Required observation |
234
+
| --- | --- | --- |
235
+
| Discover/create/reuse an Agent | Registry, directory, onboarding and configured execution profile | Stable Agent identity, effective scope and supported capabilities; repeated creation does not duplicate the identity |
236
+
| Attach/start/resume/stop | This RFC's binding and the selected host adapter | Exact session/generation, actual running or blocked state, cancellation and replacement readback; attached hosts never acquire a substitute executor |
237
+
| Send/receive/return | Collaboration request owner and the [ingress policies](desktop-execution-frontends-v0.md#agent-scoped-bot-ingress-modes)| Requested/effective inbox, queue or steer semantics; delivery, consumption and work adoption remain distinct |
238
+
| Claim/validate/settle | Existing Todo, lease, acceptance and quota owners | Current execution proof and independent acceptance; a host cannot certify its own completion |
239
+
240
+
These are semantic operation families, not a new universal adapter API. Both a
241
+
lead Agent and an authorized managed worker may call them. Host lifecycle
242
+
differences remain explicit; a coordination role grants no extra authority.
243
+
244
+
**Continuation ownership is a separate axis from session mode and provider.**
245
+
Each binding has one qualified owner of the next execution opportunity:
246
+
247
+
-**LoopX-governed Turn:** the existing runtime/scheduler admits a complete
248
+
bounded work unit; the host runs its own model/tool loop and returns a typed
249
+
candidate for independent validation and settlement. Local and cloud hosts
250
+
may implement the same contract. A Turn is not one model call or a scripted
251
+
business phase; the Agent may investigate, delegate and revise within scope.
252
+
-**Native Goal runtime:** submit one Goal/task body and let that runtime own
253
+
continuation, with qualified handling of LoopX continue/defer/complete,
254
+
cancellation, budget and result readback. A prompt alone is not a scheduler;
255
+
provider Goal evaluation does not replace LoopX work acceptance.
256
+
-**Same-session host driver:** an explicitly activated host integration can
257
+
obtain fresh LoopX admission and enqueue the next task in the existing
258
+
session. Qualify this separately from a provider's native Goal evaluator.
259
+
260
+
Never wrap a self-continuing native Goal in repeated externally driven Turns on
261
+
the same binding. To change the continuation owner, stop new admission, reconcile
262
+
pending tools and uncertain effects, fence the old executor, and read back the
263
+
new binding before execution. Disconnection does not authorize that switch.
264
+
265
+
For the first mixed managed cohort, qualify a cloud adapter against the same
266
+
governed Turn contract as the local worker before expanding native Goal profiles.
267
+
This is a delivery priority, not a default migration. The
Copy file name to clipboardExpand all lines: docs/architecture/rfcs/capable-manager-semantic-handoff-v0.md
+34Lines changed: 34 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -152,6 +152,14 @@ The durable semantic context consists of a small typed identity/control header p
152
152
153
153
Prefer one cohesive replacement to compatibility wrappers that preserve duplicate decisions. Inventory every existing producer/reader, migrate with lossless mappings, switch one writer and delete the replaced rules. Reusing contracts and data is required; reusing every current class, JSON directory and prompt is not.
154
154
155
+
The lead Agent owns task decomposition, investigation, delegation, revision and
156
+
synthesis. Host services execute admitted operations and recover their receipts;
157
+
they do not encode the scenario's next business phase. A managed worker may
158
+
coordinate other Agents through the same scoped creation, session and request
159
+
operations defined by the [session execution RFC](agent-session-execution-modes-v0.md#reusable-agent-operations-and-continuation-ownership).
160
+
Keep the manager application thin and shared state transitions in their typed
161
+
owners. Do not build a second scheduler in the manager or provider adapter.
162
+
155
163
### 5.3 Authority that enables work
156
164
157
165
Resolve a request from authenticated principal, origin/audience, resource scope and requested effect, then match the existing persistent grant. A grant is reused across turns and restarts until revoked, expired or outside scope. Authorized delegation may carry an attenuated reference to a real standing grant; handoff is not inherently powerless. The receiver verifies the grant chain, target/action scope and its own host authority. It neither trusts a model-written permission string nor requires the user to approve the same in-scope work again. Read-only discovery, direct reversible effects and protected operations keep their actual permission semantics; none is forced through a second confirmation merely because the entrypoint is chat.
@@ -212,6 +220,32 @@ At-least-once delivery with idempotent Core effects is the target. Do not promis
212
220
213
221
The receiver commits result/evidence links and audience-ready text. The manager may synthesize multiple worker outcomes into one answer, maintaining request-level coverage. A deterministic outbox delivers an already committed result even if the manager model is unavailable. If synthesis is required, persist that duty; do not let an optional synthesis step erase the worker's result. Model retries never replay an already accepted action.
214
222
223
+
#### Hierarchical delegation and autonomous progress
224
+
225
+
An Agent may delegate a bounded subproblem and remain responsible for integrating
226
+
its result. Record parent/request lineage without treating it as a grant. At
227
+
each hop, scope, allowed effects, depth, total fanout and shared budget remain
228
+
within effective authorization; child creation does not multiply the team's
229
+
resource allowance. Reuse an existing peer when appropriate. Cancelling one
230
+
request affects only its owned descendant executions, not a shared Agent's
231
+
unrelated work. Detect wait cycles and release unnecessary execution slots
232
+
while awaiting children, so parents cannot consume all child capacity.
233
+
234
+
Return follows the real dependency: child artifact -> receiver validation and
235
+
adoption/rejection -> parent integration -> original requester. Directly
236
+
forwarding a grandchild's output to the lead does not prove the intermediate
237
+
Agent coordinated or accepted it. Messages use the shared inbox/queue/steer
238
+
policies; receiving a message cannot grant a claim, alter intent or accept work.
239
+
240
+
Extend A6/A8/A13 with a three-level synthetic journey and two input revisions.
241
+
The lead retains substantive work of its own; an intermediate worker decides
242
+
whether another peer is needed. Freeze the objective, constraints and injected
243
+
failure, not the team roster or phase sequence. At least one revised delegation
244
+
must originate from an Agent's response to contradictory evidence. Record
245
+
request/decision references and adoption facts, not private reasoning traces.
246
+
The harness may inject faults and check invariants; it must not supply every
247
+
next phase, manually forward results or certify success from message counts.
248
+
215
249
### 5.7 Session and product continuity
216
250
217
251
**Cross-session continuation is a first-class product journey, not transcript forwarding.** A user can ask “continue in another session/agent and report back here” once. Within existing authorization, the host prepares the context, selects the supported continuation path, presents it to the receiver and returns the conclusion automatically. The receiver reassesses the work; the user need not export JSON, repeat the background or approve routine restoration. This applies to manager and worker sessions alike.
0 commit comments