@ai-agent-forge/plugin-overflow-policy 0.88.1

package/README.md

@@ -0,0 +1,3 @@
+# @agent-forge/plugin-overflow-policy
+
+Agent Forge 出厂默认溢出策略插件（context overflow 与 recoverable length 分类 decide），bundled 分发，宿主通过 manifest 加载并经供给基座注入共享模块。

package/agent-forge.json

@@ -0,0 +1,19 @@
+{
+	"packageFormatVersion": 1,
+	"id": "agent-forge.plugin.overflow-policy",
+	"pluginVersion": "0.88.1",
+	"apiVersion": "1",
+	"minHostVersion": "0.88.0",
+	"platform": {
+		"os": [
+			"windows",
+			"macos",
+			"linux"
+		],
+		"runtime": [
+			{
+				"name": "node"
+			}
+		]
+	}
+}

package/dist/entry.d.ts

@@ -0,0 +1,16 @@
+import type { CapabilityAPI } from "@agent-forge/plugin-sdk";
+/** Policy name under the `overflow-policy` capability; matches the host's embedded default name. */
+export declare const DEFAULT_OVERFLOW_POLICY_NAME = "default";
+/**
+ * Default-export factory consumed by the host's manifest plugin loader.
+ *
+ * Registers the current provider classification (overflow and recoverable-length
+ * logic migrated verbatim from the host's embedded `bootstrap-overflow-policy.ts`,
+ * D-082 batch 3) under the fixed default name: rerouting via overflowPolicyName
+ * config selects a different policy, while a same-name registration competes by
+ * load order — it is not a replacement mechanism.
+ */
+export default function createOverflowPolicyPluginEntry(api: CapabilityAPI): Promise<{
+    dispose: () => void;
+}>;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,yBAAyB,CAAC;AAEpF,oGAAoG;AACpG,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAEtD;;;;;;;;GAQG;AACH,wBAA8B,+BAA+B,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAoBlH","sourcesContent":["import { type AssistantMessage, isContextOverflow, isRecoverableLength } from \"@agent-forge/ai/compat\";\nimport { t } from \"@agent-forge/host/i18n\";\nimport type { CapabilityAPI, OverflowPolicyRequest } from \"@agent-forge/plugin-sdk\";\n\n/** Policy name under the `overflow-policy` capability; matches the host's embedded default name. */\nexport const DEFAULT_OVERFLOW_POLICY_NAME = \"default\";\n\n/**\n * Default-export factory consumed by the host's manifest plugin loader.\n *\n * Registers the current provider classification (overflow and recoverable-length\n * logic migrated verbatim from the host's embedded `bootstrap-overflow-policy.ts`,\n * D-082 batch 3) under the fixed default name: rerouting via overflowPolicyName\n * config selects a different policy, while a same-name registration competes by\n * load order — it is not a replacement mechanism.\n */\nexport default async function createOverflowPolicyPluginEntry(api: CapabilityAPI): Promise<{ dispose: () => void }> {\n\tconst registration = api.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {\n\t\tdecide: (request: OverflowPolicyRequest) => {\n\t\t\tif (!request.message || typeof request.message !== \"object\") {\n\t\t\t\tthrow new Error(t(\"Overflow policy requires an assistant message object\"));\n\t\t\t}\n\t\t\tconst message = request.message as AssistantMessage;\n\t\t\treturn {\n\t\t\t\tcontextOverflow: isContextOverflow(message, request.contextWindow),\n\t\t\t\trecoverableLength: isRecoverableLength(message, request.desiredMaxOutput),\n\t\t\t};\n\t\t},\n\t});\n\treturn {\n\t\tdispose: () => {\n\t\t\t// Registration disposal in the capability runtime is synchronous;\n\t\t\t// void consumes the declared Promise possibility of the contract.\n\t\t\tvoid registration.dispose();\n\t\t},\n\t};\n}\n"]}

package/dist/entry.js

@@ -0,0 +1,35 @@
+import { isContextOverflow, isRecoverableLength } from "@agent-forge/ai/compat";
+import { t } from "@agent-forge/host/i18n";
+/** Policy name under the `overflow-policy` capability; matches the host's embedded default name. */
+export const DEFAULT_OVERFLOW_POLICY_NAME = "default";
+/**
+ * Default-export factory consumed by the host's manifest plugin loader.
+ *
+ * Registers the current provider classification (overflow and recoverable-length
+ * logic migrated verbatim from the host's embedded `bootstrap-overflow-policy.ts`,
+ * D-082 batch 3) under the fixed default name: rerouting via overflowPolicyName
+ * config selects a different policy, while a same-name registration competes by
+ * load order — it is not a replacement mechanism.
+ */
+export default async function createOverflowPolicyPluginEntry(api) {
+    const registration = api.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {
+        decide: (request) => {
+            if (!request.message || typeof request.message !== "object") {
+                throw new Error(t("Overflow policy requires an assistant message object"));
+            }
+            const message = request.message;
+            return {
+                contextOverflow: isContextOverflow(message, request.contextWindow),
+                recoverableLength: isRecoverableLength(message, request.desiredMaxOutput),
+            };
+        },
+    });
+    return {
+        dispose: () => {
+            // Registration disposal in the capability runtime is synchronous;
+            // void consumes the declared Promise possibility of the contract.
+            void registration.dispose();
+        },
+    };
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,oGAAoG;AACpG,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,+BAA+B,CAAC,GAAkB,EAAoC;IACnH,MAAM,YAAY,GAAG,GAAG,CAAC,sBAAsB,CAAC,4BAA4B,EAAE;QAC7E,MAAM,EAAE,CAAC,OAA8B,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,sDAAsD,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAA2B,CAAC;YACpD,OAAO;gBACN,eAAe,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC;gBAClE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC;aACzE,CAAC;QAAA,CACF;KACD,CAAC,CAAC;IACH,OAAO;QACN,OAAO,EAAE,GAAG,EAAE,CAAC;YACd,kEAAkE;YAClE,kEAAkE;YAClE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;QAAA,CAC5B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { type AssistantMessage, isContextOverflow, isRecoverableLength } from \"@agent-forge/ai/compat\";\nimport { t } from \"@agent-forge/host/i18n\";\nimport type { CapabilityAPI, OverflowPolicyRequest } from \"@agent-forge/plugin-sdk\";\n\n/** Policy name under the `overflow-policy` capability; matches the host's embedded default name. */\nexport const DEFAULT_OVERFLOW_POLICY_NAME = \"default\";\n\n/**\n * Default-export factory consumed by the host's manifest plugin loader.\n *\n * Registers the current provider classification (overflow and recoverable-length\n * logic migrated verbatim from the host's embedded `bootstrap-overflow-policy.ts`,\n * D-082 batch 3) under the fixed default name: rerouting via overflowPolicyName\n * config selects a different policy, while a same-name registration competes by\n * load order — it is not a replacement mechanism.\n */\nexport default async function createOverflowPolicyPluginEntry(api: CapabilityAPI): Promise<{ dispose: () => void }> {\n\tconst registration = api.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {\n\t\tdecide: (request: OverflowPolicyRequest) => {\n\t\t\tif (!request.message || typeof request.message !== \"object\") {\n\t\t\t\tthrow new Error(t(\"Overflow policy requires an assistant message object\"));\n\t\t\t}\n\t\t\tconst message = request.message as AssistantMessage;\n\t\t\treturn {\n\t\t\t\tcontextOverflow: isContextOverflow(message, request.contextWindow),\n\t\t\t\trecoverableLength: isRecoverableLength(message, request.desiredMaxOutput),\n\t\t\t};\n\t\t},\n\t});\n\treturn {\n\t\tdispose: () => {\n\t\t\t// Registration disposal in the capability runtime is synchronous;\n\t\t\t// void consumes the declared Promise possibility of the contract.\n\t\t\tvoid registration.dispose();\n\t\t},\n\t};\n}\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@ai-agent-forge/plugin-overflow-policy",
+	"version": "0.88.1",
+	"description": "Default overflow policy plugin for Agent Forge (context-overflow and recoverable-length classification)",
+	"type": "module",
+	"main": "./dist/entry.js",
+	"types": "./dist/entry.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/entry.d.ts",
+			"import": "./dist/entry.js"
+		}
+	},
+	"files": [
+		"dist",
+		"agent-forge.json",
+		"plugin.json",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"agent-forge",
+		"plugin",
+		"overflow-policy"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/overflow-policy"
+	},
+	"bugs": {
+		"url": "https://github.com/agent-forge/agent-forge/issues"
+	},
+	"homepage": "https://github.com/agent-forge/agent-forge#readme",
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {},
+	"devDependencies": {
+		"shx": "0.4.0",
+		"vitest": "4.1.11"
+	}
+}

package/plugin.json

@@ -0,0 +1,10 @@
+{
+	"id": "agent-forge.plugin.overflow-policy",
+	"version": "0.88.1",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.88.0",
+	"requiredCapabilities": [
+		"overflow-policy"
+	]
+}