@ai-agent-forge/plugin-test-runner 0.85.0

package/dist/shell-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Inlined from agent-forge `src/utils/shell.ts` (D-075 S3 extraction) so this
+ * package keeps its dependency closure limited to the plugin SDK and typebox.
+ * Semantics are unchanged.
+ */
+/**
+ * Sanitize binary output for display/storage.
+ * Removes characters that crash string-width or cause display issues:
+ * - Control characters (except tab, newline, carriage return)
+ * - Lone surrogates
+ * - Unicode Format characters (crash string-width due to a bug)
+ * - Characters with undefined code points
+ */
+export declare function sanitizeBinaryOutput(str: string): string;
+//# sourceMappingURL=shell-utils.d.ts.map

package/dist/shell-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-utils.d.ts","sourceRoot":"","sources":["../src/shell-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA8BxD","sourcesContent":["/**\n * Inlined from agent-forge `src/utils/shell.ts` (D-075 S3 extraction) so this\n * package keeps its dependency closure limited to the plugin SDK and typebox.\n * Semantics are unchanged.\n */\n\n/**\n * Sanitize binary output for display/storage.\n * Removes characters that crash string-width or cause display issues:\n * - Control characters (except tab, newline, carriage return)\n * - Lone surrogates\n * - Unicode Format characters (crash string-width due to a bug)\n * - Characters with undefined code points\n */\nexport function sanitizeBinaryOutput(str: string): string {\n\t// Use Array.from to properly iterate over code points (not code units)\n\t// This handles surrogate pairs correctly and catches edge cases where\n\t// codePointAt() might return undefined\n\treturn Array.from(str)\n\t\t.filter((char) => {\n\t\t\t// Filter out characters that cause string-width to crash\n\t\t\t// This includes:\n\t\t\t// - Unicode format characters\n\t\t\t// - Lone surrogates (already filtered by Array.from)\n\t\t\t// - Control chars except \\t \\n \\r\n\t\t\t// - Characters with undefined code points\n\n\t\t\tconst code = char.codePointAt(0);\n\n\t\t\t// v8 ignore next -- Array.from iterating over a legal string, codePointAt will not return undefined\n\t\t\tif (code === undefined) return false;\n\n\t\t\t// Allow tab, newline, carriage return\n\t\t\tif (code === 0x09 || code === 0x0a || code === 0x0d) return true;\n\n\t\t\t// Filter out control characters (0x00-0x1F, except 0x09, 0x0a, 0x0d)\n\t\t\tif (code <= 0x1f) return false;\n\n\t\t\t// Filter out Unicode format characters\n\t\t\tif (code >= 0xfff9 && code <= 0xfffb) return false;\n\n\t\t\treturn true;\n\t\t})\n\t\t.join(\"\");\n}\n"]}

package/dist/shell-utils.js

@@ -0,0 +1,43 @@
+/**
+ * Inlined from agent-forge `src/utils/shell.ts` (D-075 S3 extraction) so this
+ * package keeps its dependency closure limited to the plugin SDK and typebox.
+ * Semantics are unchanged.
+ */
+/**
+ * Sanitize binary output for display/storage.
+ * Removes characters that crash string-width or cause display issues:
+ * - Control characters (except tab, newline, carriage return)
+ * - Lone surrogates
+ * - Unicode Format characters (crash string-width due to a bug)
+ * - Characters with undefined code points
+ */
+export function sanitizeBinaryOutput(str) {
+    // Use Array.from to properly iterate over code points (not code units)
+    // This handles surrogate pairs correctly and catches edge cases where
+    // codePointAt() might return undefined
+    return Array.from(str)
+        .filter((char) => {
+        // Filter out characters that cause string-width to crash
+        // This includes:
+        // - Unicode format characters
+        // - Lone surrogates (already filtered by Array.from)
+        // - Control chars except \t \n \r
+        // - Characters with undefined code points
+        const code = char.codePointAt(0);
+        // v8 ignore next -- Array.from iterating over a legal string, codePointAt will not return undefined
+        if (code === undefined)
+            return false;
+        // Allow tab, newline, carriage return
+        if (code === 0x09 || code === 0x0a || code === 0x0d)
+            return true;
+        // Filter out control characters (0x00-0x1F, except 0x09, 0x0a, 0x0d)
+        if (code <= 0x1f)
+            return false;
+        // Filter out Unicode format characters
+        if (code >= 0xfff9 && code <= 0xfffb)
+            return false;
+        return true;
+    })
+        .join("");
+}
+//# sourceMappingURL=shell-utils.js.map

package/dist/shell-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-utils.js","sourceRoot":"","sources":["../src/shell-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAU;IACzD,uEAAuE;IACvE,sEAAsE;IACtE,uCAAuC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,yDAAyD;QACzD,iBAAiB;QACjB,8BAA8B;QAC9B,qDAAqD;QACrD,kCAAkC;QAClC,0CAA0C;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAEjC,oGAAoG;QACpG,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAErC,sCAAsC;QACtC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEjE,qEAAqE;QACrE,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAE/B,uCAAuC;QACvC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC;QAEnD,OAAO,IAAI,CAAC;IAAA,CACZ,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AAAA,CACX","sourcesContent":["/**\n * Inlined from agent-forge `src/utils/shell.ts` (D-075 S3 extraction) so this\n * package keeps its dependency closure limited to the plugin SDK and typebox.\n * Semantics are unchanged.\n */\n\n/**\n * Sanitize binary output for display/storage.\n * Removes characters that crash string-width or cause display issues:\n * - Control characters (except tab, newline, carriage return)\n * - Lone surrogates\n * - Unicode Format characters (crash string-width due to a bug)\n * - Characters with undefined code points\n */\nexport function sanitizeBinaryOutput(str: string): string {\n\t// Use Array.from to properly iterate over code points (not code units)\n\t// This handles surrogate pairs correctly and catches edge cases where\n\t// codePointAt() might return undefined\n\treturn Array.from(str)\n\t\t.filter((char) => {\n\t\t\t// Filter out characters that cause string-width to crash\n\t\t\t// This includes:\n\t\t\t// - Unicode format characters\n\t\t\t// - Lone surrogates (already filtered by Array.from)\n\t\t\t// - Control chars except \\t \\n \\r\n\t\t\t// - Characters with undefined code points\n\n\t\t\tconst code = char.codePointAt(0);\n\n\t\t\t// v8 ignore next -- Array.from iterating over a legal string, codePointAt will not return undefined\n\t\t\tif (code === undefined) return false;\n\n\t\t\t// Allow tab, newline, carriage return\n\t\t\tif (code === 0x09 || code === 0x0a || code === 0x0d) return true;\n\n\t\t\t// Filter out control characters (0x00-0x1F, except 0x09, 0x0a, 0x0d)\n\t\t\tif (code <= 0x1f) return false;\n\n\t\t\t// Filter out Unicode format characters\n\t\t\tif (code >= 0xfff9 && code <= 0xfffb) return false;\n\n\t\t\treturn true;\n\t\t})\n\t\t.join(\"\");\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+import type { PluginErrorV1, PluginResultStatusV1 } from "@agent-forge/plugin-sdk";
+export declare const TEST_RUNNER_PLUGIN_ID_V1: "agent-forge.plugin.test-runner";
+export declare const TEST_RUNNER_CAPABILITY_VERSION_V1: 1;
+export declare const TEST_RUNNER_HOST_ADAPTER_ID_V1: "node-test-runner";
+export declare const TEST_RUNNER_HOST_ADAPTER_VERSION_V1: "1.0.0";
+export type TestRunnerFrameworkV1 = "vitest" | "jest" | "node-test" | "pytest";
+export interface TestRunRequestV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    /** Opaque host-owned workspace handle, never a local path. */
+    readonly workspaceRef: string;
+    readonly framework: TestRunnerFrameworkV1;
+    /** A framework-specific selector. The host converts this to fixed argv. */
+    readonly target: string;
+    readonly timeoutMs?: number;
+    readonly maxFailures?: number;
+}
+export interface TestRunSummaryV1 {
+    readonly total: number;
+    readonly passed: number;
+    readonly failed: number;
+    readonly skipped: number;
+    readonly flaky: number;
+}
+/** A relative test identifier, not an absolute host path or a raw stack trace. */
+export interface TestRunFailureV1 {
+    readonly file: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly message: string;
+}
+/**
+ * Structured model-facing test result. Full framework stdout/stderr stays in
+ * host-owned reports and is never part of this DTO.
+ */
+export interface TestRunResultV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly status: PluginResultStatusV1;
+    readonly summary: TestRunSummaryV1;
+    readonly failures: readonly TestRunFailureV1[];
+    readonly failuresTruncated: boolean;
+    readonly exitCode?: number;
+    readonly reportArtifactRef?: string;
+    readonly error?: PluginErrorV1;
+}
+/** A command identity and argv resolved exclusively by the host. */
+export interface TestRunnerCommandV1 {
+    readonly commandId: string;
+    readonly args: readonly string[];
+}
+export interface TestRunnerCommandResolverV1 {
+    resolve(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunnerCommandV1 | undefined>;
+}
+/** The runner owns executable path, cwd, environment, parsing, and raw logs. */
+export interface TestRunnerCommandRunnerV1 {
+    run(input: {
+        readonly command: TestRunnerCommandV1;
+        readonly timeoutMs: number;
+        readonly signal: AbortSignal;
+    }): Promise<TestRunnerCommandResultV1>;
+}
+/** Host-private parsed result. It intentionally has no stdout/stderr fields. */
+export type TestRunnerCommandResultV1 = {
+    readonly status: "completed";
+    readonly exitCode: number;
+    readonly summary: TestRunSummaryV1;
+    readonly failures?: readonly TestRunFailureV1[];
+    readonly reportArtifactRef?: string;
+} | {
+    readonly status: "unsupported";
+};
+export interface TestRunnerAdapterV1 {
+    readonly adapterId: string;
+    readonly adapterVersion: string;
+    run(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunResultV1>;
+}
+export interface TestRunnerDeterministicFixtureV1 {
+    readonly workspaceRef: string;
+    readonly framework: TestRunnerFrameworkV1;
+    readonly target: string;
+    readonly result: TestRunnerCommandResultV1;
+}
+export interface TestRunnerPluginManifestV1 {
+    readonly id: typeof TEST_RUNNER_PLUGIN_ID_V1;
+    readonly pluginVersion: string;
+    readonly apiVersion: "1";
+    readonly capabilityRefs: readonly {
+        readonly id: "test.run";
+        readonly version: 1;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginErrorV1, PluginResultStatusV1 } from \"@agent-forge/plugin-sdk\";\n\nexport const TEST_RUNNER_PLUGIN_ID_V1 = \"agent-forge.plugin.test-runner\" as const;\nexport const TEST_RUNNER_CAPABILITY_VERSION_V1 = 1 as const;\nexport const TEST_RUNNER_HOST_ADAPTER_ID_V1 = \"node-test-runner\" as const;\nexport const TEST_RUNNER_HOST_ADAPTER_VERSION_V1 = \"1.0.0\" as const;\n\nexport type TestRunnerFrameworkV1 = \"vitest\" | \"jest\" | \"node-test\" | \"pytest\";\n\nexport interface TestRunRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\t/** Opaque host-owned workspace handle, never a local path. */\n\treadonly workspaceRef: string;\n\treadonly framework: TestRunnerFrameworkV1;\n\t/** A framework-specific selector. The host converts this to fixed argv. */\n\treadonly target: string;\n\treadonly timeoutMs?: number;\n\treadonly maxFailures?: number;\n}\n\nexport interface TestRunSummaryV1 {\n\treadonly total: number;\n\treadonly passed: number;\n\treadonly failed: number;\n\treadonly skipped: number;\n\treadonly flaky: number;\n}\n\n/** A relative test identifier, not an absolute host path or a raw stack trace. */\nexport interface TestRunFailureV1 {\n\treadonly file: string;\n\treadonly line?: number;\n\treadonly column?: number;\n\treadonly message: string;\n}\n\n/**\n * Structured model-facing test result. Full framework stdout/stderr stays in\n * host-owned reports and is never part of this DTO.\n */\nexport interface TestRunResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly summary: TestRunSummaryV1;\n\treadonly failures: readonly TestRunFailureV1[];\n\treadonly failuresTruncated: boolean;\n\treadonly exitCode?: number;\n\treadonly reportArtifactRef?: string;\n\treadonly error?: PluginErrorV1;\n}\n\n/** A command identity and argv resolved exclusively by the host. */\nexport interface TestRunnerCommandV1 {\n\treadonly commandId: string;\n\treadonly args: readonly string[];\n}\n\nexport interface TestRunnerCommandResolverV1 {\n\tresolve(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunnerCommandV1 | undefined>;\n}\n\n/** The runner owns executable path, cwd, environment, parsing, and raw logs. */\nexport interface TestRunnerCommandRunnerV1 {\n\trun(input: {\n\t\treadonly command: TestRunnerCommandV1;\n\t\treadonly timeoutMs: number;\n\t\treadonly signal: AbortSignal;\n\t}): Promise<TestRunnerCommandResultV1>;\n}\n\n/** Host-private parsed result. It intentionally has no stdout/stderr fields. */\nexport type TestRunnerCommandResultV1 =\n\t| {\n\t\t\treadonly status: \"completed\";\n\t\t\treadonly exitCode: number;\n\t\t\treadonly summary: TestRunSummaryV1;\n\t\t\treadonly failures?: readonly TestRunFailureV1[];\n\t\t\treadonly reportArtifactRef?: string;\n\t  }\n\t| { readonly status: \"unsupported\" };\n\nexport interface TestRunnerAdapterV1 {\n\treadonly adapterId: string;\n\treadonly adapterVersion: string;\n\trun(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunResultV1>;\n}\n\nexport interface TestRunnerDeterministicFixtureV1 {\n\treadonly workspaceRef: string;\n\treadonly framework: TestRunnerFrameworkV1;\n\treadonly target: string;\n\treadonly result: TestRunnerCommandResultV1;\n}\n\nexport interface TestRunnerPluginManifestV1 {\n\treadonly id: typeof TEST_RUNNER_PLUGIN_ID_V1;\n\treadonly pluginVersion: string;\n\treadonly apiVersion: \"1\";\n\treadonly capabilityRefs: readonly { readonly id: \"test.run\"; readonly version: 1 }[];\n}\n"]}

package/dist/types.js

@@ -0,0 +1,5 @@
+export const TEST_RUNNER_PLUGIN_ID_V1 = "agent-forge.plugin.test-runner";
+export const TEST_RUNNER_CAPABILITY_VERSION_V1 = 1;
+export const TEST_RUNNER_HOST_ADAPTER_ID_V1 = "node-test-runner";
+export const TEST_RUNNER_HOST_ADAPTER_VERSION_V1 = "1.0.0";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG,gCAAyC,CAAC;AAClF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,kBAA2B,CAAC;AAC1E,MAAM,CAAC,MAAM,mCAAmC,GAAG,OAAgB,CAAC","sourcesContent":["import type { PluginErrorV1, PluginResultStatusV1 } from \"@agent-forge/plugin-sdk\";\n\nexport const TEST_RUNNER_PLUGIN_ID_V1 = \"agent-forge.plugin.test-runner\" as const;\nexport const TEST_RUNNER_CAPABILITY_VERSION_V1 = 1 as const;\nexport const TEST_RUNNER_HOST_ADAPTER_ID_V1 = \"node-test-runner\" as const;\nexport const TEST_RUNNER_HOST_ADAPTER_VERSION_V1 = \"1.0.0\" as const;\n\nexport type TestRunnerFrameworkV1 = \"vitest\" | \"jest\" | \"node-test\" | \"pytest\";\n\nexport interface TestRunRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\t/** Opaque host-owned workspace handle, never a local path. */\n\treadonly workspaceRef: string;\n\treadonly framework: TestRunnerFrameworkV1;\n\t/** A framework-specific selector. The host converts this to fixed argv. */\n\treadonly target: string;\n\treadonly timeoutMs?: number;\n\treadonly maxFailures?: number;\n}\n\nexport interface TestRunSummaryV1 {\n\treadonly total: number;\n\treadonly passed: number;\n\treadonly failed: number;\n\treadonly skipped: number;\n\treadonly flaky: number;\n}\n\n/** A relative test identifier, not an absolute host path or a raw stack trace. */\nexport interface TestRunFailureV1 {\n\treadonly file: string;\n\treadonly line?: number;\n\treadonly column?: number;\n\treadonly message: string;\n}\n\n/**\n * Structured model-facing test result. Full framework stdout/stderr stays in\n * host-owned reports and is never part of this DTO.\n */\nexport interface TestRunResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly summary: TestRunSummaryV1;\n\treadonly failures: readonly TestRunFailureV1[];\n\treadonly failuresTruncated: boolean;\n\treadonly exitCode?: number;\n\treadonly reportArtifactRef?: string;\n\treadonly error?: PluginErrorV1;\n}\n\n/** A command identity and argv resolved exclusively by the host. */\nexport interface TestRunnerCommandV1 {\n\treadonly commandId: string;\n\treadonly args: readonly string[];\n}\n\nexport interface TestRunnerCommandResolverV1 {\n\tresolve(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunnerCommandV1 | undefined>;\n}\n\n/** The runner owns executable path, cwd, environment, parsing, and raw logs. */\nexport interface TestRunnerCommandRunnerV1 {\n\trun(input: {\n\t\treadonly command: TestRunnerCommandV1;\n\t\treadonly timeoutMs: number;\n\t\treadonly signal: AbortSignal;\n\t}): Promise<TestRunnerCommandResultV1>;\n}\n\n/** Host-private parsed result. It intentionally has no stdout/stderr fields. */\nexport type TestRunnerCommandResultV1 =\n\t| {\n\t\t\treadonly status: \"completed\";\n\t\t\treadonly exitCode: number;\n\t\t\treadonly summary: TestRunSummaryV1;\n\t\t\treadonly failures?: readonly TestRunFailureV1[];\n\t\t\treadonly reportArtifactRef?: string;\n\t  }\n\t| { readonly status: \"unsupported\" };\n\nexport interface TestRunnerAdapterV1 {\n\treadonly adapterId: string;\n\treadonly adapterVersion: string;\n\trun(request: TestRunRequestV1, signal?: AbortSignal): Promise<TestRunResultV1>;\n}\n\nexport interface TestRunnerDeterministicFixtureV1 {\n\treadonly workspaceRef: string;\n\treadonly framework: TestRunnerFrameworkV1;\n\treadonly target: string;\n\treadonly result: TestRunnerCommandResultV1;\n}\n\nexport interface TestRunnerPluginManifestV1 {\n\treadonly id: typeof TEST_RUNNER_PLUGIN_ID_V1;\n\treadonly pluginVersion: string;\n\treadonly apiVersion: \"1\";\n\treadonly capabilityRefs: readonly { readonly id: \"test.run\"; readonly version: 1 }[];\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@ai-agent-forge/plugin-test-runner",
+	"version": "0.85.0",
+	"description": "Test runner capability plugin for Agent Forge (full-control test_run tool over vitest/jest/node-test/pytest)",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.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",
+		"test",
+		"runner"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/test-runner"
+	},
+	"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": {
+		"@agent-forge/plugin-sdk": "^0.85.0",
+		"typebox": "1.3.27"
+	},
+	"devDependencies": {
+		"@agent-forge/agent-forge": "^0.85.0",
+		"shx": "0.4.0",
+		"vitest": "4.1.9"
+	}
+}

package/plugin.json

@@ -0,0 +1,9 @@
+{
+	"id": "agent-forge.plugin.test-runner",
+	"version": "0.84.4",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.84.4",
+	"requiredCapabilities": ["tools"],
+	"provides": [{ "id": "test.run", "version": 1, "kind": "contribution" }]
+}