mirror of
https://github.com/getpaseo/paseo.git
synced 2026-10-14 13:22:37 +00:00
Document scoped credentials during Hub continuation (#4607)
* docs(hub): explain scoped credentials during agent continuation * docs(hub): align credential lifetime across trigger guides * docs(hub): centralize continuation credential lifecycle * docs(hub): keep continuation guidance focused on agent reuse * docs(hub): state when shared tokens are revoked
This commit is contained in:
@@ -271,7 +271,7 @@ Keys use the existing expression syntax and must resolve to a non-empty string o
|
||||
|
||||
An existing session keeps its daemon, agent configuration, target, environment, and tool contracts. Changing those settings for the same key fails with an explanation; choose a different key or **New agent**. Prompts and output destinations belong to each arrival and may change. A worktree branch is chosen when the session is first created and reused on later arrivals.
|
||||
|
||||
Triggers that mint temporary environment credentials, including a `run.github` grant or a connection token in `run.env`, must choose **New agent** when the event has a conversation or uses a custom key. These credentials expire with the execution, and an existing agent's environment cannot be refreshed. Hub-managed reply tools remain available with continuation.
|
||||
A follow-up steers the active agent without extending its runtime deadline or credential expiry. With a `run.github` grant or connection token in `run.env`, follow-ups share the active agent’s credentials. Once all requests finish, Hub revokes leased tokens; the next arrival starts a new agent with fresh credentials. Agents without temporary credentials can be reused after completion.
|
||||
|
||||
### Upgrading
|
||||
|
||||
|
||||
@@ -37,7 +37,7 @@ steps:
|
||||
${{ paseo.prompt }}
|
||||
```
|
||||
|
||||
The agent can use `git` and `gh` within the declared repositories and permissions. Hub mints the token when the step starts and revokes it when execution ends.
|
||||
The agent can use `git` and `gh` within the declared repositories and permissions. See [agent continuation](/docs/hub/configuration/hub-yml#agent-continuation) for the token lifecycle when requests continue an agent.
|
||||
|
||||
## Fields
|
||||
|
||||
@@ -73,4 +73,4 @@ env:
|
||||
SOME_TOKEN: "${{ paseo.connections.some-connection.token }}"
|
||||
```
|
||||
|
||||
Hub resolves the value for the step and does not persist it. See [Hub security](/docs/hub/security) for provider and host boundaries.
|
||||
Hub resolves the value when it prepares the agent's environment. See [Hub security](/docs/hub/security) for provider and host boundaries.
|
||||
|
||||
@@ -44,7 +44,7 @@ If the daemon is offline or needs a newer Paseo version, the agent selectors sho
|
||||
|
||||
Dashboard triggers default to **Same conversation**. Messages in the same Slack or Discord thread, events on the same GitHub issue or pull request, and events on the same Linear issue continue the existing agent in that project. An event without a conversation starts a new agent.
|
||||
|
||||
If the agent is busy, the new prompt steers its current work. If its workspace is archived, Hub asks Paseo to restore it before sending the prompt. Each arrival still has its own deadline, output limits, and completion status.
|
||||
If the agent is busy, the new prompt steers its current work. Each arrival keeps its own output limits and completion status. If a reusable workspace is archived, Hub asks Paseo to restore it before sending the prompt.
|
||||
|
||||
Choose **Custom key** to group arrivals by an input, or **New agent** to keep them separate. A self-contained trigger document can express the same choice:
|
||||
|
||||
@@ -67,7 +67,7 @@ run:
|
||||
prompt: Handle this request and call finish_execution when complete.
|
||||
```
|
||||
|
||||
The [continuation reference](/docs/hub/configuration/hub-yml#agent-continuation) describes keys and compatibility. The run detail shows whether each arrival created, continued, or restored an agent.
|
||||
The [continuation reference](/docs/hub/configuration/hub-yml#agent-continuation) covers keys and agent reuse. The run detail shows whether each arrival created, continued, or restored an agent.
|
||||
|
||||
Hub includes an `executionId` in each prompt. When using a continuing agent, pass that ID to `reply` and `finish_execution`. These tools act on that arrival's destination and contract; an old or unrelated execution ID is rejected.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user