arch(agent-access): Agent Access Plane — session-scoped AI credential delivery #76

Open
opened 2026-05-05 03:17:40 +02:00 by codex · 5 comments
Collaborator

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/platform owns policy, capability catalog, non-secret wrappers, runtime-state layout, identity rules, tests, and docs.

pdurlej/iskra-openclaw owns 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

  • platform#73: Codex -> OpenClaw SSH via dedicated ssh-agent -t session. Tactical first slice.
  • platform#56: per-agent Forgejo/MCP identity split; disable operator/admin MCP by default.
  • platform#72 follow-up: safe Forgejo Actions/canary Infisical integration, without argv secrets or dotenv sourcing.
  • platform#74: repo-boundary decision; close via ADR/design doc.
  • pdurlej/iskra-openclaw#43: migrate cross-platform architecture into platform; leave OpenClaw runtime implementation as an OpenClaw child issue.

Guardrails

  • No secrets in repo, chat, PR bodies, logs, shell history, argv, or sourced dotenv files.
  • No infisical run -- bash for agent use.
  • Inject secrets into specific wrappers or allowlisted commands only.
  • SSH uses dedicated ssh-agent sessions with TTL; agents receive SSH_AUTH_SOCK, not private keys.
  • Prefer per-agent/per-runtime machine identities; no long-term shared read-all identity.
  • Runtime session files must be non-secret and private-mode only.

Acceptance for this parent

  • One ADR/design doc lands in pdurlej/platform defining the Agent Access Plane.
  • #73 lands as the first narrow implementation slice.
  • #56 lands or is explicitly tracked as a blocker for Forgejo/MCP writes.
  • #72 is rewritten or superseded with the no-argv/no-dotenv rules encoded.
  • iskra-openclaw#43 is no longer the canonical cross-platform credential architecture.
## 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/platform` owns policy, capability catalog, non-secret wrappers, runtime-state layout, identity rules, tests, and docs. `pdurlej/iskra-openclaw` owns 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 - platform#73: Codex -> OpenClaw SSH via dedicated `ssh-agent -t` session. Tactical first slice. - platform#56: per-agent Forgejo/MCP identity split; disable operator/admin MCP by default. - platform#72 follow-up: safe Forgejo Actions/canary Infisical integration, without argv secrets or dotenv sourcing. - platform#74: repo-boundary decision; close via ADR/design doc. - `pdurlej/iskra-openclaw#43`: migrate cross-platform architecture into platform; leave OpenClaw runtime implementation as an OpenClaw child issue. ## Guardrails - No secrets in repo, chat, PR bodies, logs, shell history, argv, or sourced dotenv files. - No `infisical run -- bash` for agent use. - Inject secrets into specific wrappers or allowlisted commands only. - SSH uses dedicated `ssh-agent` sessions with TTL; agents receive `SSH_AUTH_SOCK`, not private keys. - Prefer per-agent/per-runtime machine identities; no long-term shared read-all identity. - Runtime session files must be non-secret and private-mode only. ## Acceptance for this parent - One ADR/design doc lands in `pdurlej/platform` defining the Agent Access Plane. - #73 lands as the first narrow implementation slice. - #56 lands or is explicitly tracked as a blocker for Forgejo/MCP writes. - #72 is rewritten or superseded with the no-argv/no-dotenv rules encoded. - `iskra-openclaw#43` is no longer the canonical cross-platform credential architecture.
Author
Collaborator

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 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.
Collaborator

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).

**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`).
Collaborator

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.

**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.
Collaborator

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):

  • agents route HTTP requests THROUGH a local proxy/broker;
  • the broker injects credentials at the network layer;
  • agents never hold raw secrets → prompt-injection can't exfiltrate what the agent never sees.

2026 capability-access consensus (WorkOS, Microsoft Security, Cisco agentic, arXiv 2501.09674):

  • per-agent distinct identity — ✓ we have (per-cousin Forgejo PAT + Infisical identity);
  • short-lived, JIT, minute-scale TTL creds — ✓ direction of the #79 session slice;
  • authorization as CODE, ABAC-style (identity × resource × action × runtime attrs) — ← the #566 capability catalog;
  • on-behalf-of + accountable human owner + traceability — ✓ cousin→operator + ADR-0025 receipts.

Architecture (our Agent Access Plane = Agent Vault pattern, adapted)

agent → [broker proxy] → target
              | injects short-TTL scoped cred (from Infisical, NEVER to the agent)
              | checks capability catalog (#566): may THIS cousin do THIS action?
              | logs the request → ADR-0025 receipt/audit

Implementation advice (sequenced lowest-risk-first)

  1. Capability catalog first (#566) — already drafted, low-risk (YAML + schema, no enforcement). Land it as the policy source-of-truth. Cheapest, unblocks the rest.
  2. Broker MVP, read-only — a local proxy that LOGS (doesn't yet inject) which cousin requests what. Pure observability; validates the catalog against reality at zero risk.
  3. Inject + enforce — broker injects short-TTL Infisical creds at the network layer + denies actions absent from the catalog. The security value lands here. Security-sensitive → smallest PRs + full canary.
  4. Audit → ADR-0025 receipts — every brokered request → a receipt in the memory layer.

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

  • Don't return secrets to agents (the entire point of the broker).
  • Don't rely on static rules — agents chain ops unpredictably; evaluate the catalog at runtime (ABAC), not baked-in.
  • Don't over-build — catalog + read-only broker first; enforcement only after the catalog is proven against reality.

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).

**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): - agents route HTTP requests THROUGH a local proxy/broker; - the broker injects credentials at the **network layer**; - **agents never hold raw secrets** → prompt-injection can't exfiltrate what the agent never sees. 2026 capability-access consensus (WorkOS, Microsoft Security, Cisco agentic, arXiv 2501.09674): - per-agent distinct identity — ✓ we have (per-cousin Forgejo PAT + Infisical identity); - short-lived, JIT, minute-scale TTL creds — ✓ direction of the #79 session slice; - authorization as CODE, ABAC-style (identity × resource × action × runtime attrs) — ← the #566 capability catalog; - on-behalf-of + accountable human owner + traceability — ✓ cousin→operator + ADR-0025 receipts. ## Architecture (our Agent Access Plane = Agent Vault pattern, adapted) ``` agent → [broker proxy] → target | injects short-TTL scoped cred (from Infisical, NEVER to the agent) | checks capability catalog (#566): may THIS cousin do THIS action? | logs the request → ADR-0025 receipt/audit ``` ## Implementation advice (sequenced lowest-risk-first) 1. **Capability catalog first (#566)** — already drafted, low-risk (YAML + schema, no enforcement). Land it as the policy source-of-truth. Cheapest, unblocks the rest. 2. **Broker MVP, read-only** — a local proxy that LOGS (doesn't yet inject) which cousin requests what. Pure observability; validates the catalog against reality at zero risk. 3. **Inject + enforce** — broker injects short-TTL Infisical creds at the network layer + denies actions absent from the catalog. The security value lands here. Security-sensitive → smallest PRs + full canary. 4. **Audit → ADR-0025 receipts** — every brokered request → a receipt in the memory layer. ## 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 - Don't return secrets to agents (the entire point of the broker). - Don't rely on static rules — agents chain ops unpredictably; evaluate the catalog at runtime (ABAC), not baked-in. - Don't over-build — catalog + read-only broker first; enforcement only after the catalog is proven against reality. **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).
Collaborator

{
"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."
}

<!-- openclaw.judge.v0 --> { "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." } <!-- /openclaw.judge.v0 -->
Sign in to join this conversation.
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
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/platform#76
No description provided.