@a5c-ai/agent-catalog 5.0.1-staging.c9bb2c61

package/graph/nodes/runtime-semantics/session-semantics.yaml

@@ -0,0 +1,214 @@
+kind: NodeDocument
+documentPath: nodes/runtime-semantics/session-semantics.yaml
+generatedAt: 2026-04-23T00:00:00.000Z
+nodes:
+  - id: sessionSemantics:claude:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:claude:ge-0-0-0
+    agentId: claude
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - CLAUDE_ENV_FILE
+      - CLAUDE_CODE_SESSION_ID
+    resumeSemantics: Session binding is mediated by Claude env files plus a shared .a5c run directory.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - CLAUDE_CODE_SESSION_ID
+      - key: env_file
+        envVars:
+          - CLAUDE_ENV_FILE
+      - key: project_dir
+        envVars:
+          - CLAUDE_PROJECT_DIR
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: sessionSemantics:codex:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:codex:ge-0-0-0
+    agentId: codex
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - CODEX_THREAD_ID
+      - CODEX_SESSION_ID
+      - CODEX_PLUGIN_ROOT
+    resumeSemantics: Codex session binding relies on thread/session IDs and plugin-root state.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - CODEX_SESSION_ID
+      - key: run_id
+        envVars:
+          - CODEX_RUN_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-hooks-detector
+  - id: sessionSemantics:cursor:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:cursor:ge-0-0-0
+    agentId: cursor
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - CURSOR_PROJECT_DIR
+      - CURSOR_VERSION
+    resumeSemantics: Cursor detection is environment-driven and anchored to project-directory signals.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - CURSOR_SESSION
+          - CURSOR_AGENT_SESSION
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-hooks-detector
+  - id: sessionSemantics:gemini:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:gemini:ge-0-0-0
+    agentId: gemini
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - GEMINI_SESSION_ID
+      - GEMINI_CWD
+      - GEMINI_PROJECT_DIR
+    resumeSemantics: Gemini sessions are detected from CLI extension/runtime environment variables.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - GEMINI_SESSION_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-hooks-detector
+  - id: sessionSemantics:copilot:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:copilot:ge-0-0-0
+    agentId: copilot
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - COPILOT_SESSION_ID
+      - COPILOT_CLI_SESSION
+      - GH_COPILOT_SESSION
+    resumeSemantics: Copilot surfaces session IDs from CLI and GitHub session variables.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - COPILOT_CLI_SESSION
+          - GH_COPILOT_SESSION
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: sessionSemantics:pi:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:pi:ge-0-0-0
+    agentId: pi
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - PI_SESSION_ID
+      - PI_RUN_ID
+    resumeSemantics: Pi sessions are keyed by explicit run/session identifiers.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - PI_SESSION_ID
+      - key: run_id
+        envVars:
+          - PI_RUN_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: sessionSemantics:omp:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:omp:ge-0-0-0
+    agentId: omp
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - OMP_SESSION_ID
+      - OMP_RUN_ID
+    resumeSemantics: Oh-My-Pi reuses Pi-style run/session identifiers.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - OMP_SESSION_ID
+      - key: run_id
+        envVars:
+          - OMP_RUN_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: sessionSemantics:opencode:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:opencode:ge-0-0-0
+    agentId: opencode
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - AGENT_SESSION_ID
+      - OPENCODE_SESSION_ID
+      - OPENCODE_RUN_ID
+    resumeSemantics: OpenCode uses agent session IDs with optional run IDs for shell and hook flows.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - OPENCODE_SESSION
+      - key: run_id
+        envVars:
+          - OPENCODE_RUN_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: sessionSemantics:openclaw:ge-0-0-0
+    kind: SessionSemantics
+    sessionSemanticsId: sessionSemantics:openclaw:ge-0-0-0
+    agentId: openclaw
+    versionRange: ">=0.0.0"
+    sessionDirStrategy: .a5c/runs
+    sessionIdSources:
+      - OPENCLAW_SESSION
+      - OPENCLAW_RUN_ID
+      - OPENCLAW_SHELL
+      - OPENCLAW_HOME
+    resumeSemantics: OpenClaw detection is currently env-driven with no shared runtime-hook support in fallback metadata.
+    stateFilePatterns:
+      - .a5c/runs/**
+    pidMarkerPolicy: env-or-run-dir
+    metadataFields:
+      - key: session_id
+        envVars:
+          - OPENCLAW_SESSION
+      - key: run_id
+        envVars:
+          - OPENCLAW_RUN_ID
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-hooks-detector
+      - repo-agent-mux-host

package/graph/nodes/transports.yaml

@@ -0,0 +1,202 @@
+kind: NodeDocument
+documentPath: nodes/transports.yaml
+generatedAt: 2026-04-23T00:00:00.000Z
+nodes:
+  - id: transportProtocol:terminal-cli
+    kind: TransportProtocol
+    transportId: terminal-cli
+    label: Interactive terminal CLI
+    protocolKind: cli-stdio
+    interactive: true
+    streaming: true
+    requestShape: stdin / CLI arguments
+    responseShape: stdout / terminal session
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: transportProtocol:shell-hook-runtime
+    kind: TransportProtocol
+    transportId: shell-hook-runtime
+    label: Shell hook lifecycle runtime
+    protocolKind: shell-hooks
+    interactive: true
+    streaming: true
+    requestShape: hook invocation payload
+    responseShape: shell hook status and output
+    evidenceRefs:
+      - repo-target-index
+      - repo-target-claude
+      - repo-target-codex
+  - id: transportProtocol:anthropic
+    kind: TransportProtocol
+    transportId: anthropic
+    label: Anthropic Messages API
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /v1/messages
+    responseShape: Anthropic message response
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:openai-chat
+    kind: TransportProtocol
+    transportId: openai-chat
+    label: OpenAI Chat Completions
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /v1/chat/completions
+    responseShape: chat.completion
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-migration
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:openai-responses
+    kind: TransportProtocol
+    transportId: openai-responses
+    label: OpenAI Responses API
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /v1/responses
+    responseShape: response
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-migration
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:google
+    kind: TransportProtocol
+    transportId: google
+    label: Google GenerateContent
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /v1beta/models/*
+    responseShape: candidates[]
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:passthrough
+    kind: TransportProtocol
+    transportId: passthrough
+    label: Passthrough upstream protocol
+    status: scorecard-gated
+    protocolKind: http-proxy
+    interactive: false
+    streaming: true
+    requestShape: provider-native path
+    responseShape: provider-native response
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:bedrock-converse
+    kind: TransportProtocol
+    transportId: bedrock-converse
+    label: Bedrock Converse
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /converse
+    responseShape: Bedrock output.message
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:vertex-native
+    kind: TransportProtocol
+    transportId: vertex-native
+    label: Vertex native GenerateContent
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /v1/projects/...:generateContent
+    responseShape: Vertex candidates[]
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-scorecard
+  - id: transportProtocol:azure-foundry
+    kind: TransportProtocol
+    transportId: azure-foundry
+    label: Azure Foundry Chat Completions
+    status: scorecard-gated
+    protocolKind: http-json
+    interactive: false
+    streaming: true
+    requestShape: POST /models/chat/completions
+    responseShape: Azure Foundry chat completion
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-scorecard
+  - id: transportRuntime:terminal-cli
+    kind: TransportRuntime
+    runtimeId: terminal-cli
+    transportId: terminal-cli
+    label: Interactive terminal CLI runtime
+    runtimeKind: local-process
+    persistentSession: true
+    stdinInjection: true
+    blockingStopHook: false
+    mcpSupport: false
+    containerizable: true
+    evidenceRefs:
+      - repo-sdk-fallback
+      - repo-agent-mux-host
+  - id: transportRuntime:shell-hook-runtime
+    kind: TransportRuntime
+    runtimeId: shell-hook-runtime
+    transportId: shell-hook-runtime
+    label: Runtime hook execution surface
+    runtimeKind: shell-hooks
+    persistentSession: true
+    stdinInjection: true
+    blockingStopHook: true
+    mcpSupport: false
+    containerizable: false
+    evidenceRefs:
+      - repo-target-index
+      - repo-target-claude
+      - repo-target-codex
+  - id: transportRuntime:amux-proxy
+    kind: TransportRuntime
+    runtimeId: amux-proxy
+    transportId: openai-responses
+    label: amux-proxy protocol/provider bridge
+    status: scorecard-gated
+    runtimeKind: http-proxy-bridge
+    persistentSession: false
+    stdinInjection: false
+    blockingStopHook: false
+    mcpSupport: false
+    containerizable: true
+    exposedTransportIds:
+      - anthropic
+      - openai-chat
+      - openai-responses
+      - google
+      - passthrough
+      - bedrock-converse
+      - vertex-native
+      - azure-foundry
+    providerIds:
+      - openai
+      - anthropic
+      - google
+      - bedrock
+      - vertex
+      - foundry
+    evidenceRefs:
+      - repo-transport-mux-readme
+      - repo-transport-mux-architecture
+      - repo-transport-mux-migration
+      - repo-transport-mux-scorecard