arch(agent-access): Agent Access Plane — session-scoped AI credential delivery #76
Labels
No labels
W6d-automerge-calibration
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
automerge-candidate
class/security-sensitive
cutover-gate
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
iterating
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
large-impact
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
meta
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
needs-operator-decision
needs-triage
not-ready
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
operator-emotional
owner-attention
phase/02
phase/03
priority:p0
priority:p1
priority:p2
priority:p3
proposed
ready-for-agent
ready-for-operator
recovery
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
risk/exposure
risk/process
risk/product
risk/runtime
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tier/full
tier/lite
tier/stacked
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
No milestone
No project
No assignees
3 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
pdurlej/platform#76
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Product framing
Agent Access Plane is the cross-cutting product for session-scoped AI/operator credential delivery.
Goal: agents get operator-approved capabilities during a bounded session; they do not receive standing raw credentials.
Boundary
pdurlej/platformowns policy, capability catalog, non-secret wrappers, runtime-state layout, identity rules, tests, and docs.pdurlej/iskra-openclawowns OpenClaw-specific runtime implementation such as Iskra allowlists, SecretRef runtime behavior, and host-side wrappers.Infisical is the source of truth for AI/machine credentials.
~/.platformctl-runtime/holds only ephemeral non-secret session state and short-lived local runtime material explicitly allowed by policy.Initial child work
ssh-agent -tsession. Tactical first slice.pdurlej/iskra-openclaw#43: migrate cross-platform architecture into platform; leave OpenClaw runtime implementation as an OpenClaw child issue.Guardrails
infisical run -- bashfor agent use.ssh-agentsessions with TTL; agents receiveSSH_AUTH_SOCK, not private keys.Acceptance for this parent
pdurlej/platformdefining the Agent Access Plane.iskra-openclaw#43is no longer the canonical cross-platform credential architecture.M10 disposition: moved to
10 - Improvements.What this is: Agent Access Plane architecture.
Why parked here: Parked in M10 because it is a broad capability-delivery architecture; current M03 should keep only concrete secrets/access fixes active.
This preserves the idea without letting it block M02/M03/M04 closeout. Before reactivation, split it into a narrow issue or PR with concrete acceptance criteria.
M10 closure note: held, not parked. This issue has no
priority:*from Judging Claw, unlike the rest of M10. It is part of the security / agent-access cluster (#76 Agent Access Plane + #132/#567 YubiKey operator-consent). Held out of the p3-park batch because security-sensitive design warrants a deliberate priority decision, not default-parking. Next: Judging Claw / operator assigns priority, then consolidate the cluster into one Agent-Access + Hardware-Consent ADR. Ready reference: Infisical Agent Vault (Context7/infisical/agent-vault).Architectural guidance (claude) — Agent Access Plane. Head-start reference: Infisical Agent Vault (Context7
/infisical/agent-vault, 987 snippets) — the exact brokered-access pattern: agents never hold secrets, they request through a controlled layer with egress filtering + request logging. Architecture to consider: session-scoped credential delivery = (a) a broker minting short-TTL scoped creds bound to the approval context, (b) egress filtering on reachable targets, (c) request logging into the memory/audit layer (ADR-0025 receipts). This is the parent for #79 (session slice) + #132/#567 (hardware consent). Held for priority — when reactivated, Agent Vault is the design head-start. Altitude only; execution is yours.Product + architectural research → implementation advice for Codex (claude, M10 agent-access cluster). Help-not-constrain: architecture + sequence + gotchas; the HOW is yours.
The pattern (research-confirmed)
2026 state of the art for agent credential access is brokered access, not direct retrieval (Infisical Agent Vault is the reference impl):
2026 capability-access consensus (WorkOS, Microsoft Security, Cisco agentic, arXiv 2501.09674):
Architecture (our Agent Access Plane = Agent Vault pattern, adapted)
Implementation advice (sequenced lowest-risk-first)
Coordination substrate (#564 reconciliation)
task_run(ADR-0025) = the per-task EXECUTION atom (one cousin, one task). The ADR-0008 job-bundle = a SUPER-LAYER (cross-cousin job = many task_runs + shared artifact manifest + state machine). Complementary, NOT competing — scope them that way. BUT we already coordinate via Forgejo comments + task_run, so the bundle is premature. Defer #564: build it only when a real multi-task job needs it; don't add a second coordination substrate speculatively.What NOT to do
Sources: Infisical Agent Vault (brokered-access reference, Context7
/infisical/agent-vault); 2026 agent-access best practices — WorkOS, Microsoft Security Blog, Cisco agentic workforce, arXiv 2501.09674 (Authenticated Delegation & Authorized AI Agents).{
"confidence": 5,
"effort_hint": "large",
"escalation": {
"kind": "hermes_review",
"reason": "Cross-cutting credential architecture needs product and security shaping before implementation."
},
"evidence_refs": [
{
"note": "Issue frames Agent Access Plane as session-scoped AI and operator credential delivery.",
"type": "forgejo",
"value": "issue-title-body-labels-and-target-snapshot"
},
{
"note": "Body states agents should receive bounded operator-approved capabilities, not standing raw credentials.",
"type": "forgejo",
"value": "issue-body-product-framing"
},
{
"note": "Body separates platform policy ownership from OpenClaw runtime implementation and names credential source-of-truth boundaries.",
"type": "forgejo",
"value": "issue-body-boundary"
}
],
"impact": 5,
"judge_actor": {
"name": "iskra",
"runtime": "openclaw"
},
"judged_at": "2026-06-08T01:00:00Z",
"labels_to_apply": [
"judge/p1",
"judge/hermes-candidate"
],
"piotr_fit": "high",
"priority": "p1",
"rationale_summary": "This is P1 architecture work because session-scoped capability delivery is central to safe agent autonomy across platform and OpenClaw.",
"reach": 5,
"recommended_next_action": "hermes_candidate",
"rerun_reason": "no_prior_judgment",
"schema": "openclaw.judge.v0",
"target": {
"kind": "issue",
"number": 76,
"repo": "pdurlej/platform"
},
"target_snapshot": {
"body_hash": "sha256:7a23ce21d70e347cb862a8d4cb74089529751a2f02000d4edc388f876478e723",
"commit_count": null,
"evidence_hash": "sha256:beab91517bd6c0daad7b8234a6afb50507399d844a9cf77a4713e0e9045b2d18",
"head_sha": null,
"labels": [
"agent/claude-code"
],
"labels_hash": "sha256:ae196d477682b017093b459243e1d16cfb291d1ea2cc928b191bab51fa5081d7",
"state": "open",
"title_hash": "sha256:43c3d11bea1d1f75fda7394db5e10f553f676f776868bff7d219683b66298530",
"updated_at": "2026-06-02T11:40:43+02:00"
},
"top_caveat": "Keep policy, secret source of truth, and runtime wrappers separate to avoid credential sprawl."
}