@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/plus/agents/agentCapabilities.js

@@ -1,197 +1,162 @@
-import { canonicalBlockingHookEvents, canonicalNonBlockingHookEvents } from './types.js';
-const canonicalHookEvents = new Set([...canonicalNonBlockingHookEvents, ...canonicalBlockingHookEvents]);
+import { canonicalBlockingHookEvents, canonicalNonBlockingHookEvents } from "./types.js";
+import * as l10n from "@vscode/l10n";
+//#region ../plus/agents/src/agentCapabilities.ts
+const canonicalHookEvents = /* @__PURE__ */ new Set([...canonicalNonBlockingHookEvents, ...canonicalBlockingHookEvents]);
 function asRecord(value) {
-    return typeof value === 'object' && value != null ? value : undefined;
+	return typeof value === "object" && value != null ? value : void 0;
 }
 function isCanonicalHookEvent(event) {
-    return canonicalHookEvents.has(event);
+	return canonicalHookEvents.has(event);
 }
-/** Claude Code's install set: its full native vocabulary minus the worktree events, which the CLI
- *  also skips by default (`skippedDefaultEvents` in its `events.json`) and GitLens has no use for. */
-const claudeCodeInstallEvents = canonicalNonBlockingHookEvents.filter(e => e !== 'WorktreeCreate' && e !== 'WorktreeRemove');
 /** Exported because Claude Code is the wire default: an event with no `providerId` comes from a CLI
- *  too old to stamp one, which predates every other client. */
-export const claudeCodeCapabilities = {
-    hookClientId: 'claude-code',
-    providerId: 'claudeCode',
-    displayName: 'Claude Code',
-    icon: 'claude',
-    // No `eventMap`/`toolNameMap` — Claude Code's vocabulary IS the canonical one.
-    installEvents: claudeCodeInstallEvents,
-    installBlockingEvents: canonicalBlockingHookEvents,
-    supportsBlockingPermissions: true,
-    supportsTranscripts: true,
-    supportsResume: true,
-    sharesPids: false,
+*  too old to stamp one, which predates every other client. */
+const claudeCodeCapabilities = {
+	hookClientId: "claude-code",
+	providerId: "claudeCode",
+	displayName: "Claude Code",
+	icon: "claude",
+	installEvents: canonicalNonBlockingHookEvents.filter((e) => e !== "WorktreeCreate" && e !== "WorktreeRemove"),
+	installBlockingEvents: canonicalBlockingHookEvents,
+	supportsBlockingPermissions: true,
+	supportsTranscripts: true,
+	supportsResume: true,
+	sharesPids: false,
+	cli: {
+		agentName: "claude-cli",
+		command: "claude",
+		resumeArgs: (sessionId) => ["--resume", sessionId]
+	}
 };
 const codexCapabilities = {
-    hookClientId: 'codex',
-    providerId: 'codex',
-    displayName: 'Codex',
-    icon: 'openai',
-    // No `eventMap` — Codex emits canonical event names already.
-    toolNameMap: {
-        apply_patch: 'Edit',
-        // `update_plan` is deliberately NOT mapped to `ExitPlanMode`: it's a todo-list update, not a
-        // plan-approval ask, and mapping it would classify routine progress as a permission prompt.
-        // Left unmapped so it falls through to the generic tool path.
-    },
-    // `undefined` install sets: let `gk` apply its per-client defaults for now. Blocking permissions
-    // are supported by the client but not requested until a later phase.
-    supportsBlockingPermissions: true,
-    supportsTranscripts: false,
-    supportsResume: false,
-    // The CLI lists codex in `pidSharingClients` — it multiplexes sessions in one process.
-    sharesPids: true,
-    // Verified empirically, not speculative: running an identical Codex session with
-    // `--dangerously-bypass-hook-trust` fires the installed hooks immediately (a session record
-    // appears); without that flag, zero records — Codex silently refuses to run command hooks it
-    // hasn't trusted yet, with no log line or warning of any kind. Trust is granted via `/hooks`
-    // inside interactive Codex and is bound to the hook's hash, so a reinstall invalidates it. There
-    // is no known way to detect trust state from outside Codex, so this hint is unconditional.
-    manualActivation: "Codex won't run these hooks until you trust them — run `/hooks` in Codex. You'll need to trust them again if the hooks are reinstalled.",
+	hookClientId: "codex",
+	providerId: "codex",
+	displayName: "Codex",
+	icon: "openai",
+	toolNameMap: { apply_patch: "Edit" },
+	supportsBlockingPermissions: true,
+	supportsTranscripts: false,
+	supportsResume: true,
+	cli: {
+		agentName: "codex",
+		command: "codex",
+		resumeArgs: (sessionId) => ["resume", sessionId]
+	},
+	sharesPids: true,
+	manualActivation: l10n.t("Codex won't run these hooks until you trust them — run `/hooks` in Codex. You'll need to trust them again if the hooks are reinstalled.")
 };
 const copilotCapabilities = {
-    hookClientId: 'copilot',
-    providerId: 'copilot',
-    displayName: 'GitHub Copilot CLI',
-    icon: 'copilot',
-    eventMap: {
-        // Copilot's event names are otherwise canonical; `ErrorOccurred` is the one with no canonical
-        // equivalent, so it maps onto Claude's turn-ended-in-error event (which derives to `idle`).
-        ErrorOccurred: 'StopFailure',
-    },
-    // Copilot's own documented tool alias table.
-    toolNameMap: {
-        bash: 'Bash',
-        // `powershell` is deliberately absent. Aliasing it to `Bash` would only be worth the lost
-        // label fidelity (a PowerShell call rendering as `Bash(...)`) if it bought the command detail
-        // `describeToolInput` extracts for shells — and it can't: Copilot relays its args as
-        // `hookInput.toolInput` (camelCase), a key nothing here reads, so no tool input reaches us at
-        // all. Pure label loss today; revisit if Copilot's tool inputs ever become readable.
-        view: 'Read',
-        create: 'Write',
-        edit: 'Edit',
-        str_replace_editor: 'Edit',
-        apply_patch: 'Edit',
-        grep: 'Grep',
-        rg: 'Grep',
-        glob: 'Glob',
-        web_fetch: 'WebFetch',
-        web_search: 'WebSearch',
-        ask_user: 'AskUserQuestion',
-    },
-    supportsBlockingPermissions: true,
-    supportsTranscripts: false,
-    supportsResume: false,
-    sharesPids: false,
+	hookClientId: "copilot",
+	providerId: "copilot",
+	displayName: "GitHub Copilot CLI",
+	icon: "copilot",
+	eventMap: { ErrorOccurred: "StopFailure" },
+	toolNameMap: {
+		bash: "Bash",
+		view: "Read",
+		create: "Write",
+		edit: "Edit",
+		str_replace_editor: "Edit",
+		apply_patch: "Edit",
+		grep: "Grep",
+		rg: "Grep",
+		glob: "Glob",
+		web_fetch: "WebFetch",
+		web_search: "WebSearch",
+		ask_user: "AskUserQuestion"
+	},
+	supportsBlockingPermissions: true,
+	supportsTranscripts: false,
+	supportsResume: true,
+	cli: {
+		agentName: "copilot",
+		command: "copilot",
+		resumeArgs: (sessionId) => [`--resume=${sessionId}`]
+	},
+	sharesPids: false
 };
 /** Reads the status type out of an OpenCode `session.status` hook input. The CLI's generated
- *  OpenCode plugin nests the raw SDK event under `hook_payload.event` (`buildHookInput` sets
- *  `hook_payload: payload`, and the generic event hook passes `{ event }`), so the full path from
- *  the hook-input root is `hook_payload.event.properties.status.type`. The payload is untyped JSON,
- *  so every hop is checked rather than cast. */
+*  OpenCode plugin nests the raw SDK event under `hook_payload.event` (`buildHookInput` sets
+*  `hook_payload: payload`, and the generic event hook passes `{ event }`), so the full path from
+*  the hook-input root is `hook_payload.event.properties.status.type`. The payload is untyped JSON,
+*  so every hop is checked rather than cast. */
 function getOpenCodeSessionStatusType(hookInput) {
-    const hookPayload = asRecord(hookInput?.hook_payload);
-    const event = asRecord(hookPayload?.event);
-    const properties = asRecord(event?.properties);
-    const status = asRecord(properties?.status);
-    const type = status?.type;
-    return typeof type === 'string' ? type : undefined;
+	const type = asRecord(asRecord(asRecord(asRecord(hookInput?.hook_payload)?.event)?.properties)?.status)?.type;
+	return typeof type === "string" ? type : void 0;
 }
-const openCodeCapabilities = {
-    hookClientId: 'opencode',
-    providerId: 'opencode',
-    displayName: 'OpenCode',
-    icon: 'gitlens-provider-opencode',
-    eventMap: {
-        'session.created': 'SessionStart',
-        'session.deleted': 'SessionEnd',
-        // `session.idle` is deprecated in OpenCode's own source in favor of `session.status`, which is
-        // why both are handled — older builds still emit it.
-        'session.idle': 'Stop',
-        'session.error': 'StopFailure',
-        'session.compacted': 'PostCompact',
-        'permission.asked': 'PermissionRequest',
-        'permission.replied': 'ElicitationResult',
-        'tool.execute.before': 'PreToolUse',
-        'tool.execute.after': 'PostToolUse',
-        // `session.updated` is intentionally absent — it has no canonical analogue.
-        // `session.status` is resolved by `resolveEvent` below, since its meaning is in the payload.
-    },
-    // Only `idle` resolves. `busy` is deliberately unmapped, and so is everything else (`retry`
-    // included): the canonical event this returns doesn't just pick a status, it selects a branch of
-    // the provider's state-machine switch, so a mapping inherits that event's ENTIRE handler. Naming
-    // `PostToolUse` here would also clear a pending permission ask, decrement the parallel-tool
-    // refcount, and schedule file decorations away — all wrong for a tick OpenCode emits
-    // independently of any tool lifecycle, and the ask-clearing is visibly wrong (the agent is still
-    // blocked on it). There is no tool-free canonical event meaning "resumed working", and `busy`
-    // carries no tool semantics to justify inventing one.
-    resolveEvent: (nativeEvent, hookInput) => {
-        if (nativeEvent !== 'session.status')
-            return undefined;
-        return getOpenCodeSessionStatusType(hookInput) === 'idle' ? 'Stop' : undefined;
-    },
-    toolNameMap: {
-        bash: 'Bash',
-        read: 'Read',
-        write: 'Write',
-        edit: 'Edit',
-        grep: 'Grep',
-        glob: 'Glob',
-        webfetch: 'WebFetch',
-        websearch: 'WebSearch',
-        apply_patch: 'Edit',
-    },
-    // The CLI hard-errors when asked to install blocking events for opencode.
-    supportsBlockingPermissions: false,
-    supportsTranscripts: false,
-    supportsResume: false,
-    sharesPids: false,
-    // OpenCode's tool hooks carry no per-call cwd: the CLI's generated plugin supplies the
-    // plugin-init directory once, so a session's reported cwd is frozen at that value and never
-    // reflects later movement. Deliberately prose and NOT a capability flag — it was one, and
-    // nothing could be built on it. Every cwd-driven path in `gkAgentProvider` (the
-    // visited-worktree unions, `cwdTimeline` resolution, the `cliSeatedWorktree` unexplained-move
-    // clear) reacts only to an OBSERVED difference between successive cwds, so a frozen cwd
-    // degrades each one to its already-correct single-value no-op. A flag hands that code no fact
-    // it can act on: it explains why the diff never fires, it does not supply the directory the
-    // hooks never sent. Promote it back to a field if a surface ever needs to caveat the
-    // attribution to the user — that would be its first real consumer.
-};
 /** Every supported hook client, in registry order. */
-export const agentCapabilities = [
-    claudeCodeCapabilities,
-    codexCapabilities,
-    copilotCapabilities,
-    openCodeCapabilities,
+const agentCapabilities = [
+	claudeCodeCapabilities,
+	codexCapabilities,
+	copilotCapabilities,
+	{
+		hookClientId: "opencode",
+		providerId: "opencode",
+		displayName: "OpenCode",
+		icon: "gitlens-provider-opencode",
+		eventMap: {
+			"session.created": "SessionStart",
+			"session.deleted": "SessionEnd",
+			"session.idle": "Stop",
+			"session.error": "StopFailure",
+			"session.compacted": "PostCompact",
+			"permission.asked": "PermissionRequest",
+			"permission.replied": "ElicitationResult",
+			"tool.execute.before": "PreToolUse",
+			"tool.execute.after": "PostToolUse"
+		},
+		resolveEvent: (nativeEvent, hookInput) => {
+			if (nativeEvent !== "session.status") return void 0;
+			return getOpenCodeSessionStatusType(hookInput) === "idle" ? "Stop" : void 0;
+		},
+		toolNameMap: {
+			bash: "Bash",
+			read: "Read",
+			write: "Write",
+			edit: "Edit",
+			grep: "Grep",
+			glob: "Glob",
+			webfetch: "WebFetch",
+			websearch: "WebSearch",
+			apply_patch: "Edit"
+		},
+		supportsBlockingPermissions: false,
+		supportsTranscripts: false,
+		supportsResume: true,
+		cli: {
+			agentName: "opencode",
+			command: "opencode",
+			resumeArgs: (sessionId) => ["--session", sessionId]
+		},
+		sharesPids: false
+	}
 ];
 /** Looks up capabilities by `gk ai hook` client id. Returns `undefined` for clients GitLens has no
- *  descriptor for (the CLI supports more than this table does). */
-export function getAgentCapabilities(hookClientId) {
-    return agentCapabilities.find(c => c.hookClientId === hookClientId);
+*  descriptor for (the CLI supports more than this table does). */
+function getAgentCapabilities(hookClientId) {
+	return agentCapabilities.find((c) => c.hookClientId === hookClientId);
 }
 /** Looks up capabilities by GitLens session provider id. */
-export function getAgentCapabilitiesByProviderId(providerId) {
-    return agentCapabilities.find(c => c.providerId === providerId);
+function getAgentCapabilitiesByProviderId(providerId) {
+	return agentCapabilities.find((c) => c.providerId === providerId);
 }
 /**
- * Translates an agent's native hook event name into the canonical vocabulary: `resolveEvent` first,
- * then `eventMap`, then an identity pass-through for names that are already canonical. Returns
- * `undefined` for anything else — unknown strings are never assumed to be canonical events.
- */
-export function resolveCanonicalHookEvent(capabilities, nativeEvent, hookInput) {
-    const resolved = capabilities.resolveEvent?.(nativeEvent, hookInput);
-    if (resolved != null)
-        return resolved;
-    const mapped = capabilities.eventMap?.[nativeEvent];
-    if (mapped != null)
-        return mapped;
-    return isCanonicalHookEvent(nativeEvent) ? nativeEvent : undefined;
+* Translates an agent's native hook event name into the canonical vocabulary: `resolveEvent` first,
+* then `eventMap`, then an identity pass-through for names that are already canonical. Returns
+* `undefined` for anything else — unknown strings are never assumed to be canonical events.
+*/
+function resolveCanonicalHookEvent(capabilities, nativeEvent, hookInput) {
+	const resolved = capabilities.resolveEvent?.(nativeEvent, hookInput);
+	if (resolved != null) return resolved;
+	const mapped = capabilities.eventMap?.[nativeEvent];
+	if (mapped != null) return mapped;
+	return isCanonicalHookEvent(nativeEvent) ? nativeEvent : void 0;
 }
 /** Translates an agent's native tool name into the canonical (Claude Code) tool name, falling back
- *  to the input unchanged when the agent has no alias for it. */
-export function resolveCanonicalToolName(capabilities, nativeToolName) {
-    return capabilities.toolNameMap?.[nativeToolName] ?? nativeToolName;
+*  to the input unchanged when the agent has no alias for it. */
+function resolveCanonicalToolName(capabilities, nativeToolName) {
+	return capabilities.toolNameMap?.[nativeToolName] ?? nativeToolName;
 }
+//#endregion
+export { agentCapabilities, claudeCodeCapabilities, getAgentCapabilities, getAgentCapabilitiesByProviderId, resolveCanonicalHookEvent, resolveCanonicalToolName };
+
 //# sourceMappingURL=agentCapabilities.js.map

package/dist/plus/agents/agentCapabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentCapabilities.js","sourceRoot":"","sources":["../../../src/plus/agents/agentCapabilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agentCapabilities.js","names":[],"sources":["../../../../plus/agents/src/agentCapabilities.ts"],"sourcesContent":["import * as l10n from '@vscode/l10n';\nimport type { AgentHookEvent } from './types.js';\nimport { canonicalBlockingHookEvents, canonicalNonBlockingHookEvents } from './types.js';\n\n/** `gk ai hook` client id — the id the GitKraken CLI stamps onto every relayed hook event. NOT\n *  the same namespace as {@link AgentProviderId}. */\nexport type AgentHookClientId = 'claude-code' | 'codex' | 'copilot' | 'opencode';\n\n/** GitLens session provider id — what lands on `AgentSession.providerId` and in telemetry. NOT\n *  the same namespace as {@link AgentHookClientId}. */\nexport type AgentProviderId = 'claudeCode' | 'codex' | 'copilot' | 'opencode';\n\n/** Icon-font glyph name used to badge the agent in the UI. Every member must name a `ThemeIcon` id\n *  that actually exists: either a codicon glyph name (`codicons-map.ts` is generated from VS Code's\n *  own font, so it isn't ours to extend) or a GitLens-contributed `gitlens-*` id from the `glicons`\n *  font, built from SVGs in `images/icons/`. An agent with no mark of its own uses `robot` — a name\n *  with no glyph renders as tofu, it does not fall back. */\nexport type AgentIconName = 'claude' | 'openai' | 'copilot' | 'gitlens-provider-opencode' | 'robot';\n\n/** How to reach an agent from a terminal, and which arguments reattach it to a past session. */\nexport interface AgentCliCapabilities {\n\t/** The agent's name in `gk agents list`, where the detected executable path comes from. */\n\treadonly agentName: string;\n\t/** Bare command to run when gkcli reports no usable executable. */\n\treadonly command: string;\n\t/** Arguments that reattach the agent to a past session by id. */\n\treadonly resumeArgs: (sessionId: string) => readonly string[];\n}\n\n/**\n * Flat, data-only description of one supported `gk ai hook` client. Mirrors how the GitKraken CLI\n * models its own clients (`internal/actions/aihook/events.json` + `registry.go`) so the two stay\n * comparable: the CLI relays each agent's native event and tool names verbatim, and this table is\n * what translates them into the canonical (Claude Code) vocabulary.\n */\nexport interface AgentCapabilities {\n\t/** The `gk ai hook` client id events arrive stamped with. */\n\treadonly hookClientId: AgentHookClientId;\n\t/** The GitLens session provider id — see {@link AgentProviderId}. */\n\treadonly providerId: AgentProviderId;\n\treadonly displayName: string;\n\treadonly icon: AgentIconName;\n\n\t/** Native event name → canonical event. Omitted when the agent's native names are already\n\t *  canonical. */\n\treadonly eventMap?: Readonly<Record<string, AgentHookEvent>>;\n\t/** Escape hatch for the cases where the native event name alone can't determine the canonical\n\t *  event and the payload has to be consulted. Tried BEFORE {@link eventMap}; returning\n\t *  `undefined` falls through to it. `hookInput` is the ROOT of the JSON the agent piped to\n\t *  `gk ai hook run` (what the CLI relays verbatim as `hookInput`), not a pre-unwrapped payload —\n\t *  navigate the agent's own nesting from there. */\n\treadonly resolveEvent?: (\n\t\tnativeEvent: string,\n\t\thookInput: Record<string, unknown> | undefined,\n\t) => AgentHookEvent | undefined;\n\t/** Native tool name → canonical (Claude Code) tool name. Omitted when already canonical. */\n\treadonly toolNameMap?: Readonly<Record<string, string>>;\n\n\t/** Native event names to register as non-blocking hooks at install time. `undefined` means\n\t *  \"pass no event flags and let `gk` apply its own per-client defaults\". */\n\treadonly installEvents?: readonly string[];\n\t/** Native event names to register as blocking hooks at install time. `undefined` means\n\t *  \"pass no event flags and let `gk` apply its own per-client defaults\". */\n\treadonly installBlockingEvents?: readonly string[];\n\n\t/** The agent can be installed with blocking hooks, so GitLens can answer a permission ask. */\n\treadonly supportsBlockingPermissions: boolean;\n\t/** The agent writes an on-disk transcript GitLens can tail for titles/prompts. */\n\treadonly supportsTranscripts: boolean;\n\t/** A past session can be resumed from its cwd via {@link cli}. */\n\treadonly supportsResume: boolean;\n\t/** The agent multiplexes concurrent sessions in one process, so a pid does not identify a\n\t *  session (matches the CLI's `pidSharingClients`). */\n\treadonly sharesPids: boolean;\n\n\t/** How to reach the agent from a terminal. Omitted when GitLens cannot launch the agent itself. */\n\treadonly cli?: AgentCliCapabilities;\n\n\t/** Extra step the agent's own host requires before installed hooks will actually fire. Undefined\n\t *  when installing is sufficient. Not a computed state — we cannot detect whether the step has been\n\t *  done, so consumers surface this unconditionally whenever hooks are installed. */\n\treadonly manualActivation?: string;\n}\n\nconst canonicalHookEvents = new Set<string>([...canonicalNonBlockingHookEvents, ...canonicalBlockingHookEvents]);\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n\treturn typeof value === 'object' && value != null ? (value as Record<string, unknown>) : undefined;\n}\n\nfunction isCanonicalHookEvent(event: string): event is AgentHookEvent {\n\treturn canonicalHookEvents.has(event);\n}\n\n/** Claude Code's install set: its full native vocabulary minus the worktree events, which the CLI\n *  also skips by default (`skippedDefaultEvents` in its `events.json`) and GitLens has no use for. */\nconst claudeCodeInstallEvents: readonly AgentHookEvent[] = canonicalNonBlockingHookEvents.filter(\n\te => e !== 'WorktreeCreate' && e !== 'WorktreeRemove',\n);\n\n/** Exported because Claude Code is the wire default: an event with no `providerId` comes from a CLI\n *  too old to stamp one, which predates every other client. */\nexport const claudeCodeCapabilities: AgentCapabilities = {\n\thookClientId: 'claude-code',\n\tproviderId: 'claudeCode',\n\tdisplayName: 'Claude Code',\n\ticon: 'claude',\n\t// No `eventMap`/`toolNameMap` — Claude Code's vocabulary IS the canonical one.\n\tinstallEvents: claudeCodeInstallEvents,\n\tinstallBlockingEvents: canonicalBlockingHookEvents,\n\tsupportsBlockingPermissions: true,\n\tsupportsTranscripts: true,\n\tsupportsResume: true,\n\tsharesPids: false,\n\tcli: { agentName: 'claude-cli', command: 'claude', resumeArgs: sessionId => ['--resume', sessionId] },\n};\n\nconst codexCapabilities: AgentCapabilities = {\n\thookClientId: 'codex',\n\tproviderId: 'codex',\n\tdisplayName: 'Codex',\n\ticon: 'openai',\n\t// No `eventMap` — Codex emits canonical event names already.\n\ttoolNameMap: {\n\t\tapply_patch: 'Edit',\n\t\t// `update_plan` is deliberately NOT mapped to `ExitPlanMode`: it's a todo-list update, not a\n\t\t// plan-approval ask, and mapping it would classify routine progress as a permission prompt.\n\t\t// Left unmapped so it falls through to the generic tool path.\n\t},\n\t// `undefined` install sets: let `gk` apply its per-client defaults for now. Blocking permissions\n\t// are supported by the client but not requested until a later phase.\n\tsupportsBlockingPermissions: true,\n\tsupportsTranscripts: false,\n\tsupportsResume: true,\n\tcli: { agentName: 'codex', command: 'codex', resumeArgs: sessionId => ['resume', sessionId] },\n\t// The CLI lists codex in `pidSharingClients` — it multiplexes sessions in one process.\n\tsharesPids: true,\n\t// Verified empirically, not speculative: running an identical Codex session with\n\t// `--dangerously-bypass-hook-trust` fires the installed hooks immediately (a session record\n\t// appears); without that flag, zero records — Codex silently refuses to run command hooks it\n\t// hasn't trusted yet, with no log line or warning of any kind. Trust is granted via `/hooks`\n\t// inside interactive Codex and is bound to the hook's hash, so a reinstall invalidates it. There\n\t// is no known way to detect trust state from outside Codex, so this hint is unconditional.\n\tmanualActivation: l10n.t(\n\t\t\"Codex won't run these hooks until you trust them — run `/hooks` in Codex. You'll need to trust them again if the hooks are reinstalled.\",\n\t),\n};\n\nconst copilotCapabilities: AgentCapabilities = {\n\thookClientId: 'copilot',\n\tproviderId: 'copilot',\n\tdisplayName: 'GitHub Copilot CLI',\n\ticon: 'copilot',\n\teventMap: {\n\t\t// Copilot's event names are otherwise canonical; `ErrorOccurred` is the one with no canonical\n\t\t// equivalent, so it maps onto Claude's turn-ended-in-error event (which derives to `idle`).\n\t\tErrorOccurred: 'StopFailure',\n\t},\n\t// Copilot's own documented tool alias table.\n\ttoolNameMap: {\n\t\tbash: 'Bash',\n\t\t// `powershell` is deliberately absent. Aliasing it to `Bash` would only be worth the lost\n\t\t// label fidelity (a PowerShell call rendering as `Bash(...)`) if it bought the command detail\n\t\t// `describeToolInput` extracts for shells — and it can't: Copilot relays its args as\n\t\t// `hookInput.toolInput` (camelCase), a key nothing here reads, so no tool input reaches us at\n\t\t// all. Pure label loss today; revisit if Copilot's tool inputs ever become readable.\n\t\tview: 'Read',\n\t\tcreate: 'Write',\n\t\tedit: 'Edit',\n\t\tstr_replace_editor: 'Edit',\n\t\tapply_patch: 'Edit',\n\t\tgrep: 'Grep',\n\t\trg: 'Grep',\n\t\tglob: 'Glob',\n\t\tweb_fetch: 'WebFetch',\n\t\tweb_search: 'WebSearch',\n\t\task_user: 'AskUserQuestion',\n\t},\n\tsupportsBlockingPermissions: true,\n\tsupportsTranscripts: false,\n\tsupportsResume: true,\n\tcli: { agentName: 'copilot', command: 'copilot', resumeArgs: sessionId => [`--resume=${sessionId}`] },\n\tsharesPids: false,\n};\n\n/** Reads the status type out of an OpenCode `session.status` hook input. The CLI's generated\n *  OpenCode plugin nests the raw SDK event under `hook_payload.event` (`buildHookInput` sets\n *  `hook_payload: payload`, and the generic event hook passes `{ event }`), so the full path from\n *  the hook-input root is `hook_payload.event.properties.status.type`. The payload is untyped JSON,\n *  so every hop is checked rather than cast. */\nfunction getOpenCodeSessionStatusType(hookInput: Record<string, unknown> | undefined): string | undefined {\n\tconst hookPayload = asRecord(hookInput?.hook_payload);\n\tconst event = asRecord(hookPayload?.event);\n\tconst properties = asRecord(event?.properties);\n\tconst status = asRecord(properties?.status);\n\tconst type = status?.type;\n\n\treturn typeof type === 'string' ? type : undefined;\n}\n\nconst openCodeCapabilities: AgentCapabilities = {\n\thookClientId: 'opencode',\n\tproviderId: 'opencode',\n\tdisplayName: 'OpenCode',\n\ticon: 'gitlens-provider-opencode',\n\teventMap: {\n\t\t'session.created': 'SessionStart',\n\t\t'session.deleted': 'SessionEnd',\n\t\t// `session.idle` is deprecated in OpenCode's own source in favor of `session.status`, which is\n\t\t// why both are handled — older builds still emit it.\n\t\t'session.idle': 'Stop',\n\t\t'session.error': 'StopFailure',\n\t\t'session.compacted': 'PostCompact',\n\t\t'permission.asked': 'PermissionRequest',\n\t\t'permission.replied': 'ElicitationResult',\n\t\t'tool.execute.before': 'PreToolUse',\n\t\t'tool.execute.after': 'PostToolUse',\n\t\t// `session.updated` is intentionally absent — it has no canonical analogue.\n\t\t// `session.status` is resolved by `resolveEvent` below, since its meaning is in the payload.\n\t},\n\t// Only `idle` resolves. `busy` is deliberately unmapped, and so is everything else (`retry`\n\t// included): the canonical event this returns doesn't just pick a status, it selects a branch of\n\t// the provider's state-machine switch, so a mapping inherits that event's ENTIRE handler. Naming\n\t// `PostToolUse` here would also clear a pending permission ask, decrement the parallel-tool\n\t// refcount, and schedule file decorations away — all wrong for a tick OpenCode emits\n\t// independently of any tool lifecycle, and the ask-clearing is visibly wrong (the agent is still\n\t// blocked on it). There is no tool-free canonical event meaning \"resumed working\", and `busy`\n\t// carries no tool semantics to justify inventing one.\n\tresolveEvent: (nativeEvent, hookInput) => {\n\t\tif (nativeEvent !== 'session.status') return undefined;\n\n\t\treturn getOpenCodeSessionStatusType(hookInput) === 'idle' ? 'Stop' : undefined;\n\t},\n\ttoolNameMap: {\n\t\tbash: 'Bash',\n\t\tread: 'Read',\n\t\twrite: 'Write',\n\t\tedit: 'Edit',\n\t\tgrep: 'Grep',\n\t\tglob: 'Glob',\n\t\twebfetch: 'WebFetch',\n\t\twebsearch: 'WebSearch',\n\t\tapply_patch: 'Edit',\n\t},\n\t// The CLI hard-errors when asked to install blocking events for opencode.\n\tsupportsBlockingPermissions: false,\n\tsupportsTranscripts: false,\n\tsupportsResume: true,\n\tcli: { agentName: 'opencode', command: 'opencode', resumeArgs: sessionId => ['--session', sessionId] },\n\tsharesPids: false,\n\t// OpenCode's tool hooks carry no per-call cwd: the CLI's generated plugin supplies the\n\t// plugin-init directory once, so a session's reported cwd is frozen at that value and never\n\t// reflects later movement. Deliberately prose and NOT a capability flag — it was one, and\n\t// nothing could be built on it. Every cwd-driven path in `gkAgentProvider` (the\n\t// visited-worktree unions, `cwdTimeline` resolution, the `cliSeatedWorktree` unexplained-move\n\t// clear) reacts only to an OBSERVED difference between successive cwds, so a frozen cwd\n\t// degrades each one to its already-correct single-value no-op. A flag hands that code no fact\n\t// it can act on: it explains why the diff never fires, it does not supply the directory the\n\t// hooks never sent. Promote it back to a field if a surface ever needs to caveat the\n\t// attribution to the user — that would be its first real consumer.\n};\n\n/** Every supported hook client, in registry order. */\nexport const agentCapabilities: readonly AgentCapabilities[] = [\n\tclaudeCodeCapabilities,\n\tcodexCapabilities,\n\tcopilotCapabilities,\n\topenCodeCapabilities,\n];\n\n/** Looks up capabilities by `gk ai hook` client id. Returns `undefined` for clients GitLens has no\n *  descriptor for (the CLI supports more than this table does). */\nexport function getAgentCapabilities(hookClientId: string): AgentCapabilities | undefined {\n\treturn agentCapabilities.find(c => c.hookClientId === hookClientId);\n}\n\n/** Looks up capabilities by GitLens session provider id. */\nexport function getAgentCapabilitiesByProviderId(providerId: string): AgentCapabilities | undefined {\n\treturn agentCapabilities.find(c => c.providerId === providerId);\n}\n\n/**\n * Translates an agent's native hook event name into the canonical vocabulary: `resolveEvent` first,\n * then `eventMap`, then an identity pass-through for names that are already canonical. Returns\n * `undefined` for anything else — unknown strings are never assumed to be canonical events.\n */\nexport function resolveCanonicalHookEvent(\n\tcapabilities: AgentCapabilities,\n\tnativeEvent: string,\n\thookInput?: Record<string, unknown>,\n): AgentHookEvent | undefined {\n\tconst resolved = capabilities.resolveEvent?.(nativeEvent, hookInput);\n\tif (resolved != null) return resolved;\n\n\tconst mapped = capabilities.eventMap?.[nativeEvent];\n\tif (mapped != null) return mapped;\n\n\treturn isCanonicalHookEvent(nativeEvent) ? nativeEvent : undefined;\n}\n\n/** Translates an agent's native tool name into the canonical (Claude Code) tool name, falling back\n *  to the input unchanged when the agent has no alias for it. */\nexport function resolveCanonicalToolName(capabilities: AgentCapabilities, nativeToolName: string): string {\n\treturn capabilities.toolNameMap?.[nativeToolName] ?? nativeToolName;\n}\n"],"mappings":"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"}