@ai-agent-forge/agent-forge 0.85.0

package/examples/extensions/permission-gate/index.ts

@@ -0,0 +1,55 @@
+/**
+ * Permission Gate Extension (capability plugin form)
+ *
+ * Prompts for confirmation before running potentially dangerous bash commands.
+ * Patterns checked: rm -rf, sudo, chmod/chown 777
+ *
+ * Install: copy this directory (with plugin.json) to ~/.agent-forge/agent/plugins
+ * or <cwd>/.agent-forge/plugins for auto-discovery.
+ *
+ * Migrated to the capability plugin form (D-056 block-semantics batch, 2026-09-21):
+ * `pi.on("tool_call")` maps to `api.registerLoopHook("beforeToolCall", ...)` — a
+ * returned `{ block: true, reason }` short-circuits the tool call into an isError
+ * tool result carrying the reason, the same visible behavior the legacy event's
+ * block return produced. `ctx.hasUI` folds into `api.interaction` availability and
+ * `ctx.ui.select` into `api.interaction.request({ kind: "select" })`; any outcome
+ * other than an answered "Yes" (dismissed, cancelled, or no interaction host at
+ * all) takes the legacy block path, so an interaction-less host keeps the old
+ * block-by-default behavior.
+ */
+
+import type { CapabilityAPI } from "@agent-forge/agent-forge";
+
+export default function permissionGateExample(api: CapabilityAPI): void {
+	const dangerousPatterns = [/\brm\s+(-rf?|--recursive)/i, /\bsudo\b/i, /\b(chmod|chown)\b.*777/i];
+
+	api.registerLoopHook("beforeToolCall", async (input) => {
+		if (input.toolName !== "bash") return undefined;
+
+		const command =
+			typeof input.args === "object" && input.args !== null && "command" in input.args
+				? String((input.args as Record<string, unknown>).command)
+				: "";
+		const isDangerous = dangerousPatterns.some((p) => p.test(command));
+
+		if (isDangerous) {
+			if (api.interaction === undefined) {
+				// In non-interactive mode, block by default
+				return { block: true, reason: "Dangerous command blocked (no UI for confirmation)" };
+			}
+
+			const outcome = await api.interaction.request({
+				kind: "select",
+				title: `⚠️ Dangerous command:\n\n  ${command}\n\nAllow?`,
+				options: ["Yes", "No"],
+			});
+			const choice = outcome.status === "answered" && typeof outcome.value === "string" ? outcome.value : undefined;
+
+			if (choice !== "Yes") {
+				return { block: true, reason: "Blocked by user" };
+			}
+		}
+
+		return undefined;
+	});
+}

package/examples/extensions/permission-gate/plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "agent-forge.example.permission-gate",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": [],
+  "optionalCapabilities": [
+    "interaction"
+  ]
+}

package/examples/extensions/pirate/index.ts

@@ -0,0 +1,75 @@
+/**
+ * Pirate Extension (capability plugin form)
+ *
+ * Demonstrates modifying the system prompt per turn through the
+ * `before.agent.start`@2 candidate transform (the catalog's
+ * `BEFORE_AGENT_START_EVENT_ID`/`BEFORE_AGENT_START_EVENT_VERSION_V2` pair in
+ * src/core/extensions/lifecycle-catalog.ts), replacing the legacy
+ * `pi.on("before_agent_start")` `{ systemPrompt }` return: the transform
+ * receives `{ version: 2, sessionId, systemPrompt, systemPromptOptions }` and
+ * returns the full envelope with a replaced `systemPrompt`; returning the
+ * input verbatim means "no replacement". The legacy `pi.registerCommand`
+ * + `ctx.ui.notify` pair maps to `api.registerCommand` +
+ * `api.interaction?.notify` (silent on hosts without an interaction surface).
+ *
+ * Usage:
+ * 1. Copy this directory (with plugin.json) to ~/.agent-forge/agent/plugins
+ *    or <cwd>/.agent-forge/plugins for auto-discovery.
+ * 2. Use /pirate to toggle pirate mode
+ * 3. When enabled, the agent will respond like a pirate
+ */
+
+import type { BuildSystemPromptOptions, CapabilityAPI } from "@agent-forge/agent-forge";
+
+/** Shape of the `before.agent.start`@2 envelope (lifecycle catalog). */
+interface BeforeAgentStartDataV2 {
+	version: 2;
+	sessionId: string;
+	systemPrompt: string;
+	systemPromptOptions: BuildSystemPromptOptions;
+}
+
+// Appended to the system prompt while pirate mode is enabled.
+const PIRATE_APPENDIX = `
+
+IMPORTANT: You are now in PIRATE MODE. You must:
+- Speak like a stereotypical pirate in all responses
+- Use phrases like "Arrr!", "Ahoy!", "Shiver me timbers!", "Avast!", "Ye scurvy dog!"
+- Replace "my" with "me", "you" with "ye", "your" with "yer"
+- Refer to the user as "matey" or "landlubber"
+- End sentences with nautical expressions
+- Still complete the actual task correctly, just in pirate speak
+`;
+
+export default function pirateExtension(api: CapabilityAPI): void {
+	let pirateMode = false;
+
+	// Register /pirate command to toggle pirate mode
+	api.registerCommand({
+		name: "pirate",
+		description: "Toggle pirate mode (agent speaks like a pirate)",
+		execute: (): undefined => {
+			pirateMode = !pirateMode;
+			api.interaction?.notify({
+				message: pirateMode ? "Arrr! Pirate mode enabled!" : "Pirate mode disabled",
+				level: "info",
+			});
+			return undefined;
+		},
+	});
+
+	// Append the pirate appendix to the system prompt while pirate mode is on
+	api.lifecycle.registerTransform<BeforeAgentStartDataV2>(
+		"before.agent.start",
+		(event) => {
+			if (!pirateMode) {
+				return event.data;
+			}
+			return {
+				...event.data,
+				systemPrompt: event.data.systemPrompt + PIRATE_APPENDIX,
+			};
+		},
+		2,
+	);
+}

package/examples/extensions/pirate/plugin.json

@@ -0,0 +1,8 @@
+{
+  "id": "agent-forge.example.pirate",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": []
+}

package/examples/extensions/plan/README.md

@@ -0,0 +1,16 @@
+# Plan 示例插件
+
+单一职责的 Plan 示例：只提供 `plan_set` 一个工具，通过 `CapabilityAPI` 注册，通过 `SessionAPI` 把 branch-local 状态写入 `plan.state` custom entry，并通过 `publish()` 发送 `plan.changed` 结构化变更事件。
+
+内核不认识 Plan 业务对象，也不强制模型使用计划。revision、证据引用和状态转换由插件自行定义；是否加载、是否允许写入由宿主选择 `readonly` 或 `full-control` 以及用户安装的外部策略决定。
+
+`goalId` 是字符串软引用：本插件只校验它是非空字符串，不校验对应 goal 是否存在，也不依赖 `../goal` 插件安装。
+
+状态机为 `draft → active → completed / cancelled`。`completed` 是终态：写入必须至少提供一条证据引用（`evidence`），终态不允许通过更高 revision 回退；`revision` 必须递增。校验失败不会追加 session 条目。
+
+该目录包含可直接加载的 `plugin.json`。将整个目录复制到以下任一位置，新的 `AgentSession` 会自动加载它：
+
+- `<agentDir>/plugins/plan`
+- `<project>/.agent-forge/plugins/plan`
+
+加载顺序固定为用户目录、项目目录、显式 manifest 路径。两个副本使用同一 plugin ID 时会明确失败，不会按目录优先级静默覆盖。

package/examples/extensions/plan/index.ts

@@ -0,0 +1,136 @@
+import type { CapabilityAPI, DisposableRegistration, EventEnvelope } from "@agent-forge/agent-forge";
+import { Type } from "typebox";
+
+export interface PlanRecord {
+	id: string;
+	/** Soft reference: a plain string, not validated against any goal plugin. */
+	goalId: string;
+	title: string;
+	status: "draft" | "active" | "completed" | "cancelled";
+	revision: number;
+	evidence: string[];
+}
+
+export interface PlanState {
+	plans: PlanRecord[];
+}
+
+export interface PlanPluginHandle {
+	readonly tools: readonly DisposableRegistration[];
+	dispose(): Promise<void>;
+}
+
+const stateEntry = "plan.state";
+
+const planSchema = Type.Object({
+	id: Type.String({ description: "Stable id of the plan to create or update" }),
+	goalId: Type.String({
+		description: "Soft reference: a plain goal id string, never validated against the goal plugin's state",
+	}),
+	title: Type.String({ description: "Human-readable plan title" }),
+	revision: Type.Integer({
+		description: "New revision counter; must be greater than the stored revision of an existing plan",
+		minimum: 0,
+	}),
+	status: Type.Optional(
+		Type.Union(
+			[Type.Literal("draft"), Type.Literal("active"), Type.Literal("completed"), Type.Literal("cancelled")],
+			{ description: "Next status; defaults to the stored status for existing plans, otherwise draft" },
+		),
+	),
+	evidence: Type.Optional(
+		Type.Array(Type.String(), {
+			description: "Evidence references; at least one is required when status is completed",
+		}),
+	),
+});
+
+function objectInput(first: unknown, second: unknown): Record<string, unknown> {
+	const value = second === undefined ? first : second;
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Plan input must be an object");
+	return value as Record<string, unknown>;
+}
+
+function text(value: unknown, name: string): string {
+	if (typeof value !== "string" || value.trim() === "") throw new Error(`${name} must be a non-empty string`);
+	return value;
+}
+
+function revision(value: unknown): number {
+	if (!Number.isInteger(value) || (value as number) < 0) throw new Error("revision must be a non-negative integer");
+	return value as number;
+}
+
+function evidence(value: unknown): string[] {
+	if (value === undefined) return [];
+	if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item.trim() === "")) {
+		throw new Error("evidence must be a string array");
+	}
+	return [...(value as string[])];
+}
+
+function loadState(api: CapabilityAPI): PlanState {
+	const entries = api.session?.getBranchEntries() ?? [];
+	const entry = [...entries].reverse().find((item) => item.customType === stateEntry);
+	if (!entry?.data || typeof entry.data !== "object") return { plans: [] };
+	const data = entry.data as Partial<PlanState>;
+	return { plans: Array.isArray(data.plans) ? [...data.plans] : [] };
+}
+
+export function createPlanPlugin(api: CapabilityAPI): PlanPluginHandle {
+	let state = loadState(api);
+	const tools: DisposableRegistration[] = [];
+
+	const persist = async (): Promise<PlanState> => {
+		api.session?.appendEntry(stateEntry, state);
+		await api.publish({ type: "plan.changed", version: 1, correlationId: stateEntry, data: state });
+		return state;
+	};
+
+	tools.push(
+		api.registerTool({
+			name: "plan_set",
+			label: "Set plan",
+			description: "Create or update a plan that softly references a goal by id",
+			parameters: planSchema,
+			execute: async (first: unknown, second?: unknown) => {
+				const input = objectInput(first, second);
+				const id = text(input.id, "id");
+				const goalId = text(input.goalId, "goalId");
+				const title = text(input.title, "title");
+				const nextRevision = revision(input.revision);
+				const current = state.plans.find((item) => item.id === id);
+				if (current && nextRevision <= current.revision) throw new Error(`stale plan revision: ${id}`);
+				if (current?.status === "completed" || current?.status === "cancelled") {
+					throw new Error(`plan is terminal and cannot be updated: ${id}`);
+				}
+				const status =
+					input.status === undefined
+						? (current?.status ?? "draft")
+						: (text(input.status, "status") as PlanRecord["status"]);
+				if (!["draft", "active", "completed", "cancelled"].includes(status)) throw new Error("invalid plan status");
+				const values = evidence(input.evidence);
+				if (status === "completed" && values.length === 0) {
+					throw new Error("plan completion requires at least one evidence reference");
+				}
+				const record: PlanRecord = { id, goalId, title, status, revision: nextRevision, evidence: values };
+				state = { ...state, plans: [...state.plans.filter((item) => item.id !== id), record] };
+				return persist();
+			},
+		}),
+	);
+
+	return {
+		tools,
+		dispose: async () => {
+			for (const tool of tools) await tool.dispose();
+		},
+	};
+}
+
+/** Manifest entry for the self-contained Plan example plugin. */
+export default function planExample(api: CapabilityAPI): PlanPluginHandle {
+	return createPlanPlugin(api);
+}
+
+export type PlanEvent = EventEnvelope<PlanState>;

package/examples/extensions/plan/plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "agent-forge.example.plan",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": [
+    "session",
+    "events",
+    "tools"
+  ]
+}

package/examples/extensions/prompt-customizer/index.ts

@@ -0,0 +1,117 @@
+/**
+ * Prompt Customizer Extension (capability plugin form)
+ *
+ * Demonstrates using systemPromptOptions to make informed, context-aware
+ * modifications to the system prompt without re-discovering resources.
+ *
+ * This extension adds tool-specific guidance based on what tools and skills
+ * are currently active, respecting whatever the user has configured.
+ *
+ * The legacy `pi.on("before_agent_start")` reader of `event.systemPromptOptions`
+ * maps to the `before.agent.start`@2 candidate transform: the envelope carries
+ * the same `BuildSystemPromptOptions` snapshot in
+ * `event.data.systemPromptOptions`, and the transform returns the full
+ * envelope with a replaced `systemPrompt`.
+ *
+ * Usage:
+ * 1. Copy this directory (with plugin.json) to ~/.agent-forge/agent/plugins
+ *    or <cwd>/.agent-forge/plugins for auto-discovery.
+ * 2. Use the extension — it automatically adapts to your active tools and skills
+ */
+
+import type { BuildSystemPromptOptions, CapabilityAPI } from "@agent-forge/agent-forge";
+
+/** Shape of the `before.agent.start`@2 envelope (lifecycle catalog). */
+interface BeforeAgentStartDataV2 {
+	version: 2;
+	sessionId: string;
+	systemPrompt: string;
+	systemPromptOptions: BuildSystemPromptOptions;
+}
+
+/**
+ * Adds tool-specific guidance that adapts to the active tool set.
+ * Instead of appending one-size-fits-all instructions, this reads what's
+ * actually loaded and tailors the guidance accordingly.
+ */
+function addToolGuidance(options: BuildSystemPromptOptions, basePrompt: string): string {
+	const hasTool = (name: string) => options.selectedTools?.includes(name) ?? false;
+
+	const parts: string[] = [];
+
+	if (hasTool("read")) {
+		parts.push(
+			"• Use the `read` tool for file contents (supports text and images).",
+			"  - For large files, use `offset` and `limit` to read in chunks.",
+		);
+	}
+
+	if (hasTool("bash")) {
+		parts.push("• Execute commands with the `bash` tool. Use it for file operations like `ls`, `find`, `grep`.");
+	}
+
+	if (hasTool("edit")) {
+		parts.push(
+			"• Use the `edit` tool for precise text replacements in files. Match exact content including whitespace.",
+		);
+	}
+
+	if (hasTool("write")) {
+		parts.push("• Use the `write` tool to create new files or overwrite existing ones completely.");
+	}
+
+	if (options.skills && options.skills.length > 0) {
+		const skillNames = options.skills.map((s) => s.name).join(", ");
+		parts.push(`\nAvailable skills: ${skillNames}`, "Use skill documentation for best practices on specific tools.");
+	}
+
+	if (parts.length === 0) {
+		return basePrompt;
+	}
+
+	return `${basePrompt}
+
+## Tool Guidance
+
+${parts.join("\n")}
+`;
+}
+
+/**
+ * Merges extension instructions with user-provided append prompts.
+ * This respects whatever the user configured via --append-system-prompt
+ * flags or files, rather than duplicating that work.
+ */
+function mergeWithUserAppend(options: BuildSystemPromptOptions): string {
+	const userAppend = options.appendSystemPrompt;
+	const extensionSpecific = `
+## Extension-Added Context
+
+This prompt includes tool guidance and skill information loaded dynamically.
+If you have additional requirements, configure them via --append-system-prompt or project context files.
+`;
+
+	if (userAppend) {
+		return `${userAppend}\n\n${extensionSpecific}`;
+	}
+
+	return extensionSpecific;
+}
+
+export default function promptCustomizerExample(api: CapabilityAPI): void {
+	api.lifecycle.registerTransform<BeforeAgentStartDataV2>(
+		"before.agent.start",
+		(event) => {
+			const { systemPrompt, systemPromptOptions } = event.data;
+
+			const customPrompt = addToolGuidance(systemPromptOptions, systemPrompt);
+			const appendSection = mergeWithUserAppend(systemPromptOptions);
+
+			return {
+				...event.data,
+				systemPrompt: `${customPrompt}${appendSection}`,
+			};
+		},
+		2,
+	);
+}

package/examples/extensions/prompt-customizer/plugin.json

@@ -0,0 +1,8 @@
+{
+  "id": "agent-forge.example.prompt-customizer",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": []
+}

package/examples/extensions/protected-paths/index.ts

@@ -0,0 +1,44 @@
+/**
+ * Protected Paths Extension (capability plugin form)
+ *
+ * Blocks write and edit operations to protected paths.
+ * Useful for preventing accidental modifications to sensitive files.
+ *
+ * Install: copy this directory (with plugin.json) to ~/.agent-forge/agent/plugins
+ * or <cwd>/.agent-forge/plugins for auto-discovery.
+ *
+ * Migrated to the capability plugin form (D-056 block-semantics batch, 2026-09-21):
+ * `pi.on("tool_call")` maps to `api.registerLoopHook("beforeToolCall", ...)` — a
+ * returned `{ block: true, reason }` short-circuits the tool call into an isError
+ * tool result carrying the reason, the same visible behavior the legacy event's
+ * block return produced. `ctx.hasUI` folds into `api.interaction` availability and
+ * `ctx.ui.notify` into `api.interaction.notify` (silent when the host has none),
+ * keeping the warning text verbatim.
+ */
+
+import type { CapabilityAPI } from "@agent-forge/agent-forge";
+
+export default function protectedPathsExample(api: CapabilityAPI): void {
+	const protectedPaths = [".env", ".git/", "node_modules/"];
+
+	api.registerLoopHook("beforeToolCall", async (input) => {
+		if (input.toolName !== "write" && input.toolName !== "edit") {
+			return undefined;
+		}
+
+		const path =
+			typeof input.args === "object" && input.args !== null && "path" in input.args
+				? String((input.args as Record<string, unknown>).path)
+				: "";
+		const isProtected = protectedPaths.some((p) => path.includes(p));
+
+		if (isProtected) {
+			if (api.interaction !== undefined) {
+				api.interaction.notify({ message: `Blocked write to protected path: ${path}`, level: "warning" });
+			}
+			return { block: true, reason: `Path "${path}" is protected` };
+		}
+
+		return undefined;
+	});
+}

package/examples/extensions/protected-paths/plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "agent-forge.example.protected-paths",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": [],
+  "optionalCapabilities": [
+    "interaction"
+  ]
+}

package/examples/extensions/provider-attribution/README.md

@@ -0,0 +1,12 @@
+# Provider Attribution 示例插件
+
+这是可选的 provider request header 策略。内核不包含 OpenRouter、NVIDIA、Cloudflare 或 OpenCode 的归因规则；只有显式安装并加载本目录的 `plugin.json` 后，才会在请求发送前添加相应 header。
+
+插件通过 experimental `ProviderHeaderTransform` capability 接收模型、可选 session ID 与已经组装的 headers。它按大小写不敏感的 header 名检查已有值，因此不会覆盖用户、provider 或上游插件设置的等价 header；已有的 `null` 也被保留，以维持删除 header 的语义。
+
+将整个目录复制到以下任一位置，新建 `AgentSession` 会自动发现并加载它：
+
+- `<agentDir>/plugins/provider-attribution`
+- `<project>/.agent-forge/plugins/provider-attribution`
+
+这只是第一方示例而非默认行为。需要不同归因、审计或 header 策略时，请实现自己的 capability plugin。

package/examples/extensions/provider-attribution/index.ts

@@ -0,0 +1,86 @@
+import type { CapabilityAPI, DisposableRegistration, ProviderHeaderTransformRequest } from "@agent-forge/agent-forge";
+
+const OPENROUTER_HOST = "openrouter.ai";
+const NVIDIA_NIM_HOST = "integrate.api.nvidia.com";
+const CLOUDFLARE_API_HOST = "api.cloudflare.com";
+const CLOUDFLARE_AI_GATEWAY_HOST = "gateway.ai.cloudflare.com";
+const OPENCODE_HOST = "opencode.ai";
+
+interface ProviderModel {
+	provider?: unknown;
+	baseUrl?: unknown;
+}
+
+function modelInfo(model: unknown): { provider: string; baseUrl: string } {
+	if (!model || typeof model !== "object") return { provider: "", baseUrl: "" };
+	const value = model as ProviderModel;
+	return {
+		provider: typeof value.provider === "string" ? value.provider : "",
+		baseUrl: typeof value.baseUrl === "string" ? value.baseUrl : "",
+	};
+}
+
+function matchesHost(baseUrl: string, expectedHost: string): boolean {
+	try {
+		return new URL(baseUrl).hostname === expectedHost;
+	} catch {
+		return false;
+	}
+}
+
+function hasHeader(headers: Record<string, string | null>, name: string): boolean {
+	const normalized = name.toLowerCase();
+	return Object.keys(headers).some((current) => current.toLowerCase() === normalized);
+}
+
+function setIfMissing(headers: Record<string, string | null>, name: string, value: string): void {
+	if (!hasHeader(headers, name)) headers[name] = value;
+}
+
+function applyAttribution(request: ProviderHeaderTransformRequest): Record<string, string | null> {
+	const headers = { ...request.headers };
+	const { provider, baseUrl } = modelInfo(request.model);
+
+	if (provider === "openrouter" || baseUrl.includes(OPENROUTER_HOST)) {
+		setIfMissing(headers, "X-OpenRouter-Title", "agent-forge");
+		setIfMissing(headers, "X-OpenRouter-Categories", "cli-agent");
+	} else if (provider === "nvidia" || matchesHost(baseUrl, NVIDIA_NIM_HOST)) {
+		setIfMissing(headers, "X-BILLING-INVOKE-ORIGIN", "Agent Forge");
+	} else if (
+		provider === "cloudflare-workers-ai" ||
+		provider === "cloudflare-ai-gateway" ||
+		matchesHost(baseUrl, CLOUDFLARE_API_HOST) ||
+		matchesHost(baseUrl, CLOUDFLARE_AI_GATEWAY_HOST)
+	) {
+		setIfMissing(headers, "User-Agent", "agent-forge-coding-agent");
+	}
+
+	if (
+		request.sessionId &&
+		(provider === "opencode" || provider === "opencode-go" || matchesHost(baseUrl, OPENCODE_HOST))
+	) {
+		setIfMissing(headers, "x-opencode-session", request.sessionId);
+		setIfMissing(headers, "x-opencode-client", "agent-forge");
+	}
+
+	return headers;
+}
+
+export interface ProviderAttributionPluginHandle {
+	readonly headerTransform: DisposableRegistration;
+	dispose(): void | Promise<void>;
+}
+
+/**
+ * Optional provider attribution policy. Loading this plugin is the explicit
+ * opt-in; the core only transports generic header transforms.
+ */
+export function createProviderAttributionPlugin(api: CapabilityAPI): ProviderAttributionPluginHandle {
+	const headerTransform = api.registerProviderHeaderTransform("provider-attribution", applyAttribution);
+	return { headerTransform, dispose: () => headerTransform.dispose() };
+}
+
+/** Manifest entry for the opt-in provider attribution example plugin. */
+export default function providerAttributionExample(api: CapabilityAPI): ProviderAttributionPluginHandle {
+	return createProviderAttributionPlugin(api);
+}

package/examples/extensions/provider-attribution/plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "agent-forge.example.provider-attribution",
+  "version": "0.1.0",
+  "hostVersion": ">=0.84.0",
+  "apiVersion": "1-draft",
+  "entry": "./index.ts",
+  "requiredCapabilities": [
+    "provider-headers"
+  ]
+}