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

package/graph/nodes/hooks-and-plugins/hook-surfaces.yaml

@@ -0,0 +1,160 @@
+kind: NodeDocument
+documentPath: nodes/hooks-and-plugins/hook-surfaces.yaml
+generatedAt: 2026-04-23T00:00:00.000Z
+nodes:
+  - id: hook:session-start
+    kind: HookSurface
+    hookId: session-start
+    canonicalName: SessionStart
+    phase: session
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:stop
+    kind: HookSurface
+    hookId: stop
+    canonicalName: Stop
+    phase: agent
+    blocking: true
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:user-prompt-submit
+    kind: HookSurface
+    hookId: user-prompt-submit
+    canonicalName: UserPromptSubmit
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:pre-tool-use
+    kind: HookSurface
+    hookId: pre-tool-use
+    canonicalName: PreToolUse
+    phase: tool
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:post-tool-use
+    kind: HookSurface
+    hookId: post-tool-use
+    canonicalName: PostToolUse
+    phase: tool
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:after-agent
+    kind: HookSurface
+    hookId: after-agent
+    canonicalName: AfterAgent
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+      - repo-target-gemini
+  - id: hook:session-end
+    kind: HookSurface
+    hookId: session-end
+    canonicalName: SessionEnd
+    phase: session
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+      - repo-target-copilot
+  - id: hook:session-idle
+    kind: HookSurface
+    hookId: session-idle
+    canonicalName: SessionIdle
+    phase: session
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:shell-env
+    kind: HookSurface
+    hookId: shell-env
+    canonicalName: ShellEnv
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:before-prompt-build
+    kind: HookSurface
+    hookId: before-prompt-build
+    canonicalName: BeforePromptBuild
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:subagent-stop
+    kind: HookSurface
+    hookId: subagent-stop
+    canonicalName: SubagentStop
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:notification
+    kind: HookSurface
+    hookId: notification
+    canonicalName: Notification
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:pre-compact
+    kind: HookSurface
+    hookId: pre-compact
+    canonicalName: PreCompact
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index
+  - id: hook:before-provider-request
+    kind: HookSurface
+    hookId: before-provider-request
+    canonicalName: BeforeProviderRequest
+    phase: agent
+    blocking: false
+    payloadSchemaHint: runtime-specific
+    resultSchemaHint: runtime-specific
+    requiresRuntimeHooks: true
+    evidenceRefs:
+      - repo-target-index

package/graph/nodes/hooks-and-plugins/plugin-artifacts.yaml

@@ -0,0 +1,229 @@
+kind: NodeDocument
+documentPath: nodes/hooks-and-plugins/plugin-artifacts.yaml
+generatedAt: 2026-04-23T00:00:00.000Z
+nodes:
+  - id: pluginArtifact:claude-code:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:claude-code:manifest
+    targetId: claude-code
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/claude-code.ts
+    scriptVariants:
+      - markdown-commands
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/claude-code.ts
+    installerSurface: plugin.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:claude-code:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:claude-code:container-image
+    targetId: claude-code
+    artifactKind: container-image
+    pathPattern: ghcr.io/anthropics/claude-code
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:codex:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:codex:manifest
+    targetId: codex
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/codex.ts
+    scriptVariants:
+      - package-json commands
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/codex.ts
+    installerSurface: package.json + hooks.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:codex:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:codex:container-image
+    targetId: codex
+    artifactKind: container-image
+    pathPattern: ghcr.io/openai/codex
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:cursor:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:cursor:manifest
+    targetId: cursor
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/cursor.ts
+    scriptVariants:
+      - markdown-commands
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/cursor.ts
+    installerSurface: plugin.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:cursor:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:cursor:container-image
+    targetId: cursor
+    artifactKind: container-image
+    pathPattern: ghcr.io/cursor/cursor-agent
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:gemini:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:gemini:manifest
+    targetId: gemini
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/gemini.ts
+    scriptVariants:
+      - extension-manifest
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/gemini.ts
+    installerSurface: plugin.json + gemini-extension.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:gemini:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:gemini:container-image
+    targetId: gemini
+    artifactKind: container-image
+    pathPattern: ghcr.io/google/gemini-cli
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:github-copilot:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:github-copilot:manifest
+    targetId: github-copilot
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/github-copilot.ts
+    scriptVariants:
+      - markdown-commands
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/github-copilot.ts
+    installerSurface: plugin.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:github-copilot:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:github-copilot:container-image
+    targetId: github-copilot
+    artifactKind: container-image
+    pathPattern: ghcr.io/github/copilot-cli
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:pi:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:pi:manifest
+    targetId: pi
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/pi.ts
+    scriptVariants:
+      - none
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/pi.ts
+    installerSurface: state-only
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:pi:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:pi:container-image
+    targetId: pi
+    artifactKind: container-image
+    pathPattern: ghcr.io/a5c-ai/pi
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:oh-my-pi:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:oh-my-pi:manifest
+    targetId: oh-my-pi
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/oh-my-pi.ts
+    scriptVariants:
+      - none
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/oh-my-pi.ts
+    installerSurface: state-only
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:oh-my-pi:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:oh-my-pi:container-image
+    targetId: oh-my-pi
+    artifactKind: container-image
+    pathPattern: ghcr.io/a5c-ai/omp
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:opencode:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:opencode:manifest
+    targetId: opencode
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/opencode.ts
+    scriptVariants:
+      - event-hooks
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/opencode.ts
+    installerSurface: plugin.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:opencode:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:opencode:container-image
+    targetId: opencode
+    artifactKind: container-image
+    pathPattern: ghcr.io/anomalyco/opencode
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback
+  - id: pluginArtifact:openclaw:manifest
+    kind: PluginArtifact
+    artifactId: pluginArtifact:openclaw:manifest
+    targetId: openclaw
+    artifactKind: manifest
+    pathPattern: packages/agent-plugins-mux/src/targets/openclaw.ts
+    scriptVariants:
+      - event-hooks
+    contextFiles:
+      - packages/agent-plugins-mux/src/targets/openclaw.ts
+    installerSurface: plugin.json
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginArtifact:openclaw:container-image
+    kind: PluginArtifact
+    artifactId: pluginArtifact:openclaw:container-image
+    targetId: openclaw
+    artifactKind: container-image
+    pathPattern: ghcr.io/openclaw/openclaw
+    scriptVariants:
+      - preinstalled
+    contextFiles: []
+    installerSurface: latest
+    evidenceRefs:
+      - repo-sdk-fallback

package/graph/nodes/hooks-and-plugins/plugin-targets.yaml

@@ -0,0 +1,330 @@
+kind: NodeDocument
+documentPath: nodes/hooks-and-plugins/plugin-targets.yaml
+generatedAt: 2026-04-23T00:00:00.000Z
+nodes:
+  - id: pluginTarget:claude-code
+    kind: PluginTarget
+    targetId: claude-code
+    displayName: Claude Code
+    adapterName: claude
+    pluginRootEnvVar: CLAUDE_PLUGIN_ROOT
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json + openclaw.plugin.json
+    commandFormat: markdown-commands
+    skillHandling: native
+    hookRegistrationFormat: claude-code
+    scriptVariants:
+      - bash
+    adapterFamily: shell-hook
+    distribution: marketplace
+    distributionModel: workspace-generated
+    marketplacePath: .claude-plugin/marketplace.json
+    installLayout:
+      harnessHomeRelative: null
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: none
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts: {}
+      emitCjsWrappers: false
+    componentSupport:
+      agents: unsupported
+      context: unsupported
+    npmPublishable: false
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:codex
+    kind: PluginTarget
+    targetId: codex
+    displayName: Codex
+    adapterName: codex
+    pluginRootEnvVar: null
+    pluginRootEnvVarForExtension: null
+    manifestFormat: package.json + hooks.json
+    commandFormat: package-json commands
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: codex
+    scriptVariants:
+      - bash
+    adapterFamily: shell-hook
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: .agents/plugins/marketplace.json
+    npmPublishable: false
+    installLayout:
+      harnessHomeRelative: .codex
+      pluginsDirRelative: .agents/plugins
+      marketplacePathRelative: .agents/plugins/marketplace.json
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: none
+      activationMessage: codex-open-plugins
+      extraPackageFiles: []
+      extraScripts: {}
+      emitCjsWrappers: false
+    componentSupport:
+      agents: unsupported
+      context: unsupported
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:cursor
+    kind: PluginTarget
+    targetId: cursor
+    displayName: Cursor
+    adapterName: cursor
+    pluginRootEnvVar: CURSOR_PLUGIN_ROOT
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json
+    commandFormat: markdown-commands
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: cursor
+    scriptVariants:
+      - bash
+      - powershell
+    adapterFamily: shell-hook
+    distribution: both
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: false
+    installLayout:
+      harnessHomeRelative: .cursor
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: postinstall
+      activationMessage: restart
+      extraPackageFiles:
+        - hooks.json
+      extraScripts: {}
+      emitCjsWrappers: false
+    componentSupport:
+      agents: unsupported
+      context: unsupported
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:gemini
+    kind: PluginTarget
+    targetId: gemini
+    displayName: Gemini CLI
+    adapterName: gemini
+    pluginRootEnvVar: GEMINI_EXTENSION_PATH
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json + gemini-extension.json
+    commandFormat: extension-manifest
+    skillHandling: native
+    hookRegistrationFormat: gemini
+    scriptVariants:
+      - bash
+    adapterFamily: shell-hook
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: false
+    installLayout:
+      harnessHomeRelative: null
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: plugin-scripts
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts: {}
+      emitCjsWrappers: false
+    componentSupport:
+      agents: unsupported
+      context: native
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:github-copilot
+    kind: PluginTarget
+    targetId: github-copilot
+    displayName: GitHub Copilot
+    adapterName: copilot
+    pluginRootEnvVar: COPILOT_PLUGIN_DIR
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json
+    commandFormat: markdown-commands
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: github-copilot
+    scriptVariants:
+      - bash
+      - powershell
+    adapterFamily: shell-hook
+    distribution: both
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: true
+    installLayout:
+      harnessHomeRelative: .copilot
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: plugin-scripts
+      activationMessage: restart
+      extraPackageFiles:
+        - hooks.json
+        - AGENTS.md
+      extraScripts: {}
+      emitCjsWrappers: false
+    componentSupport:
+      agents: native
+      context: native
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:pi
+    kind: PluginTarget
+    targetId: pi
+    displayName: Pi
+    adapterName: pi
+    pluginRootEnvVar: null
+    pluginRootEnvVarForExtension: PI_PLUGIN_ROOT
+    manifestFormat: state-only
+    commandFormat: markdown-commands
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: null
+    scriptVariants:
+      - javascript
+    adapterFamily: programmatic
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: true
+    installLayout:
+      harnessHomeRelative: null
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: module
+      binScriptExt: .cjs
+      installLifecycle: none
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts: {}
+      peerDependencyPackage: '@mariozechner/pi-coding-agent'
+      emitCjsWrappers: false
+    componentSupport:
+      agents: native
+      context: native
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:oh-my-pi
+    kind: PluginTarget
+    targetId: oh-my-pi
+    displayName: Oh-My-Pi
+    adapterName: omp
+    pluginRootEnvVar: null
+    pluginRootEnvVarForExtension: OMP_PLUGIN_ROOT
+    manifestFormat: state-only
+    commandFormat: markdown-commands
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: null
+    scriptVariants:
+      - javascript
+    adapterFamily: programmatic
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: true
+    installLayout:
+      harnessHomeRelative: null
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: module
+      binScriptExt: .cjs
+      installLifecycle: none
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts: {}
+      peerDependencyPackage: '@oh-my-pi/pi-coding-agent'
+      emitCjsWrappers: false
+    componentSupport:
+      agents: native
+      context: native
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:opencode
+    kind: PluginTarget
+    targetId: opencode
+    displayName: OpenCode
+    adapterName: opencode
+    pluginRootEnvVar: OPENCODE_PLUGIN_ROOT
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json
+    commandFormat: event-hooks
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: opencode
+    scriptVariants:
+      - javascript
+    adapterFamily: programmatic
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: false
+    installLayout:
+      harnessHomeRelative: .opencode
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: commonjs
+      binScriptExt: .js
+      installLifecycle: postinstall
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts:
+        test: node test/integration.test.js
+        "sync:commands": node scripts/sync-command-docs.cjs
+      emitCjsWrappers: true
+    componentSupport:
+      agents: unsupported
+      context: unsupported
+    evidenceRefs:
+      - repo-target-index
+  - id: pluginTarget:openclaw
+    kind: PluginTarget
+    targetId: openclaw
+    displayName: OpenClaw
+    adapterName: openclaw
+    pluginRootEnvVar: null
+    pluginRootEnvVarForExtension: null
+    manifestFormat: plugin.json
+    commandFormat: event-hooks
+    skillHandling: derived-from-commands
+    hookRegistrationFormat: openclaw
+    scriptVariants:
+      - bash
+      - typescript
+    adapterFamily: programmatic
+    distribution: npm-cli
+    distributionModel: workspace-generated
+    marketplacePath: null
+    npmPublishable: false
+    installLayout:
+      harnessHomeRelative: .openclaw
+      pluginsDirRelative: null
+      marketplacePathRelative: null
+    packageMetadata:
+      moduleType: module
+      binScriptExt: .cjs
+      installLifecycle: none
+      activationMessage: restart
+      extraPackageFiles: []
+      extraScripts: {}
+      peerDependencyPackage: openclaw
+      emitCjsWrappers: false
+    componentSupport:
+      agents: unsupported
+      context: unsupported
+    evidenceRefs:
+      - repo-target-index