@ai-agent-forge/plugin-workspace-files 0.85.0

package/README.md

@@ -0,0 +1,41 @@
+# @agent-forge/plugin-workspace-files
+
+Workspace files capability plugin for [Agent Forge](https://github.com/agent-forge/agent-forge), extracted from the
+host's `src/plugins/workspace-files` (D-075 S3). It registers three read-only tools — `workspace_list`,
+`workspace_read`, `workspace_find` — which operate purely through opaque host-owned workspace references; the model
+never supplies or receives a local path.
+
+The plugin has no standalone filesystem binding at load time. Without host-injected list/read/find seams the tools
+report an explicit `unsupported` result; hosts that want real file access bind their own opaque-ref file host through
+their profile machinery.
+
+## Install
+
+```sh
+# from a local checkout
+agent-forge plugin install ./plugins/workspace-files
+
+# from npm
+agent-forge plugin install @agent-forge/plugin-workspace-files
+```
+
+The package ships two manifests: `agent-forge.json` (ecosystem manifest for the deterministic plugin resolver) and
+`plugin.json` (host-load manifest consumed by `loadCapabilityPluginFromManifest`, entry `./dist/entry.js`).
+
+## Library surface
+
+`import { createNodeWorkspaceFilesAdapterV1, createWorkspaceFilesCapabilityFactoryV1 } from "@agent-forge/plugin-workspace-files";`
+
+- `createNodeWorkspaceFilesAdapterV1(options?)` — read-only adapter; requires host-injected `list`/`read`/`find`
+  callbacks to produce results, otherwise returns `unsupported`.
+- `sanitizeWorkspaceFilesTextV1(value, maximum?)` — redacts credentials and host paths from previews.
+- `createWorkspaceFilesCapabilityFactoryV1(adapter)` — registers the three workspace tools on a `CapabilityAPI`.
+- Default export of `dist/entry.js` — the precomposed factory used by external plugin loading.
+
+## Development
+
+```sh
+npm install --ignore-scripts        # repo root, creates the workspace symlink
+npm run build                       # plugins/workspace-files (tsgo)
+npm test                            # vitest; the entry fidelity test requires `npm run build` first
+```

package/agent-forge.json

@@ -0,0 +1,12 @@
+{
+	"packageFormatVersion": 1,
+	"id": "agent-forge.plugin.workspace-files",
+	"pluginVersion": "0.84.4",
+	"apiVersion": "1",
+	"minHostVersion": "0.84.4",
+	"capabilityRefs": [{ "id": "workspace.files", "version": 1 }],
+	"platform": {
+		"os": ["windows", "macos", "linux"],
+		"runtime": [{ "name": "node" }]
+	}
+}

package/dist/capability.d.ts

@@ -0,0 +1,5 @@
+import type { CapabilityPluginSyncFactory } from "@agent-forge/plugin-sdk";
+import type { WorkspaceFilesAdapterV1 } from "./types.ts";
+/** Registers bounded workspace reads using only opaque host-owned references. */
+export declare function createWorkspaceFilesCapabilityFactoryV1(runtime: WorkspaceFilesAdapterV1): CapabilityPluginSyncFactory;
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAY3E,OAAO,KAAK,EACX,uBAAuB,EAIvB,MAAM,YAAY,CAAC;AA+NpB,iFAAiF;AACjF,wBAAgB,uCAAuC,CAAC,OAAO,EAAE,uBAAuB,GAAG,2BAA2B,CAiGrH","sourcesContent":["import type { CapabilityPluginSyncFactory } from \"@agent-forge/plugin-sdk\";\nimport { Type } from \"typebox\";\nimport {\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tsanitizeWorkspaceFilesTextV1,\n\tWORKSPACE_FILES_MAX_MATCHES_V1,\n\tWORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1,\n\tWORKSPACE_FILES_MAX_QUERY_CHARS_V1,\n\tWORKSPACE_FILES_MAX_READ_BYTES_V1,\n} from \"./node-adapter.ts\";\nimport type {\n\tWorkspaceFilesAdapterV1,\n\tWorkspaceFilesFindResultV1,\n\tWorkspaceFilesListResultV1,\n\tWorkspaceFilesReadResultV1,\n} from \"./types.ts\";\n\nconst refSchema = Type.String({ minLength: 1, maxLength: 256, pattern: \"^[A-Za-z0-9][A-Za-z0-9._:-]*$\" });\nconst listSchema = Type.Object(\n\t{\n\t\tworkspaceRef: refSchema,\n\t\tdirectoryRef: Type.Optional(refSchema),\n\t\tlimit: Type.Optional(Type.Integer({ minimum: 1, maximum: 256 })),\n\t},\n\t{ additionalProperties: false },\n);\nconst readSchema = Type.Object(\n\t{\n\t\tfileRef: refSchema,\n\t\tmaxBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_READ_BYTES_V1 })),\n\t},\n\t{ additionalProperties: false },\n);\nconst findSchema = Type.Object(\n\t{\n\t\tworkspaceRef: refSchema,\n\t\tquery: Type.String({ minLength: 1, maxLength: WORKSPACE_FILES_MAX_QUERY_CHARS_V1 }),\n\t\tlimit: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_MATCHES_V1 })),\n\t},\n\t{ additionalProperties: false },\n);\n\ntype Result = WorkspaceFilesListResultV1 | WorkspaceFilesReadResultV1 | WorkspaceFilesFindResultV1;\n\nfunction input(\n\tfirst: unknown,\n\tsecond: unknown,\n): { readonly request: Record<string, unknown>; readonly operationId: string } {\n\tconst value = second === undefined ? first : second;\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value))\n\t\tthrow new Error(\"workspace input must be an object\");\n\tconst operationId =\n\t\ttypeof first === \"string\" && first.trim() !== \"\" && first.length <= WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t\t\t? first\n\t\t\t: \"profile-runtime-tool-call\";\n\tconst outer = value as Record<string, unknown>;\n\tif (outer.request === null || typeof outer.request !== \"object\" || Array.isArray(outer.request))\n\t\tthrow new Error(\"workspace request must be an object\");\n\treturn { request: outer.request as Record<string, unknown>, operationId };\n}\n\nfunction signalFrom(value: unknown): AbortSignal | undefined {\n\treturn value instanceof AbortSignal ? value : undefined;\n}\n\nconst NON_SUCCESS_STATUSES = new Set([\"failed\", \"cancelled\", \"needs_user\", \"unsupported\"]);\n\nfunction nonSuccessError(value: unknown): WorkspaceFilesListResultV1[\"error\"] | undefined {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst error = value as Record<string, unknown>;\n\tif (\n\t\terror.version !== 1 ||\n\t\ttypeof error.code !== \"string\" ||\n\t\t!/^[a-z][a-z0-9_]{0,127}$/u.test(error.code) ||\n\t\ttypeof error.message !== \"string\" ||\n\t\terror.message.trim() === \"\" ||\n\t\terror.message.length > 512\n\t)\n\t\treturn undefined;\n\treturn { version: 1, code: error.code, message: sanitizeWorkspaceFilesTextV1(error.message, 512) };\n}\n\nfunction projectNonSuccess(value: unknown, operationId: string, kind: \"list\" | \"read\" | \"find\"): Result | undefined {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst result = value as Record<string, unknown>;\n\tif (result.version !== 1 || result.operationId !== operationId || typeof result.status !== \"string\")\n\t\treturn undefined;\n\tif (!NON_SUCCESS_STATUSES.has(result.status)) return undefined;\n\tconst error = nonSuccessError(result.error);\n\tif (error === undefined) return undefined;\n\tif (kind === \"list\") {\n\t\tif (\n\t\t\tObject.keys(result).some(\n\t\t\t\t(key) => ![\"version\", \"operationId\", \"status\", \"entries\", \"entriesTruncated\", \"error\"].includes(key),\n\t\t\t) ||\n\t\t\t!Array.isArray(result.entries) ||\n\t\t\tresult.entries.length !== 0 ||\n\t\t\tresult.entriesTruncated !== false\n\t\t)\n\t\t\treturn undefined;\n\t\treturn {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: result.status as WorkspaceFilesListResultV1[\"status\"],\n\t\t\tentries: [],\n\t\t\tentriesTruncated: false,\n\t\t\terror,\n\t\t};\n\t}\n\tif (kind === \"read\") {\n\t\tif (\n\t\t\tObject.keys(result).some(\n\t\t\t\t(key) =>\n\t\t\t\t\t![\n\t\t\t\t\t\t\"version\",\n\t\t\t\t\t\t\"operationId\",\n\t\t\t\t\t\t\"status\",\n\t\t\t\t\t\t\"contentPreview\",\n\t\t\t\t\t\t\"contentBytes\",\n\t\t\t\t\t\t\"contentTruncated\",\n\t\t\t\t\t\t\"artifactRef\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t].includes(key),\n\t\t\t) ||\n\t\t\tresult.contentPreview !== \"\" ||\n\t\t\tresult.contentBytes !== 0 ||\n\t\t\tresult.contentTruncated !== false\n\t\t)\n\t\t\treturn undefined;\n\t\treturn {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: result.status as WorkspaceFilesReadResultV1[\"status\"],\n\t\t\tcontentPreview: \"\",\n\t\t\tcontentBytes: 0,\n\t\t\tcontentTruncated: false,\n\t\t\terror,\n\t\t};\n\t}\n\tif (\n\t\tObject.keys(result).some(\n\t\t\t(key) => ![\"version\", \"operationId\", \"status\", \"matches\", \"matchesTruncated\", \"error\"].includes(key),\n\t\t) ||\n\t\t!Array.isArray(result.matches) ||\n\t\tresult.matches.length !== 0 ||\n\t\tresult.matchesTruncated !== false\n\t)\n\t\treturn undefined;\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: result.status as WorkspaceFilesFindResultV1[\"status\"],\n\t\tmatches: [],\n\t\tmatchesTruncated: false,\n\t\terror,\n\t};\n}\n\nfunction projectListResult(value: unknown, operationId: string): WorkspaceFilesListResultV1 | undefined {\n\treturn (\n\t\tprojectList(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"list\") as WorkspaceFilesListResultV1 | undefined)\n\t);\n}\n\nfunction projectReadResult(value: unknown, operationId: string): WorkspaceFilesReadResultV1 | undefined {\n\treturn (\n\t\tprojectRead(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"read\") as WorkspaceFilesReadResultV1 | undefined)\n\t);\n}\n\nfunction projectFindResult(value: unknown, operationId: string): WorkspaceFilesFindResultV1 | undefined {\n\treturn (\n\t\tprojectFind(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"find\") as WorkspaceFilesFindResultV1 | undefined)\n\t);\n}\n\nfunction errorFor(status: \"failed\" | \"cancelled\") {\n\tconst error = {\n\t\tversion: 1 as const,\n\t\tcode: status === \"cancelled\" ? \"cancelled\" : \"adapter_failed\",\n\t\tmessage: status === \"cancelled\" ? \"Workspace operation was cancelled\" : \"Workspace file adapter failed\",\n\t};\n\treturn error;\n}\n\nfunction listFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesListResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tentries: [],\n\t\tentriesTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nfunction readFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesReadResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tcontentPreview: \"\",\n\t\tcontentBytes: 0,\n\t\tcontentTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nfunction findFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesFindResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tmatches: [],\n\t\tmatchesTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nasync function execute<T extends Result>(\n\toperationId: string,\n\tsignal: AbortSignal | undefined,\n\trun: () => Promise<T>,\n\tproject: (value: unknown, operationId: string) => T | undefined,\n\tfallbackResult: (status: \"failed\" | \"cancelled\") => T,\n): Promise<T> {\n\tif (signal?.aborted) return fallbackResult(\"cancelled\");\n\ttry {\n\t\tconst result = await run();\n\t\treturn project(result, operationId) ?? fallbackResult(\"failed\");\n\t} catch {\n\t\treturn fallbackResult(\"failed\");\n\t}\n}\n\n/** Registers bounded workspace reads using only opaque host-owned references. */\nexport function createWorkspaceFilesCapabilityFactoryV1(runtime: WorkspaceFilesAdapterV1): CapabilityPluginSyncFactory {\n\treturn (api) => {\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_list\",\n\t\t\tlabel: \"List workspace files\",\n\t\t\tdescription: \"List bounded workspace entries through host-owned opaque references\",\n\t\t\tparameters: Type.Object({ request: listSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.list(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tworkspaceRef: request.workspaceRef as string,\n\t\t\t\t\t\t\t\t\t...(request.directoryRef === undefined\n\t\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t\t: { directoryRef: request.directoryRef as string }),\n\t\t\t\t\t\t\t\t\t...(request.limit === undefined ? {} : { limit: request.limit as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectListResult(value, id),\n\t\t\t\t\t\t(status) => listFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn listFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_read\",\n\t\t\tlabel: \"Read workspace file\",\n\t\t\tdescription: \"Read a bounded preview from a host-owned workspace file reference\",\n\t\t\tparameters: Type.Object({ request: readSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.read(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tfileRef: request.fileRef as string,\n\t\t\t\t\t\t\t\t\t...(request.maxBytes === undefined ? {} : { maxBytes: request.maxBytes as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectReadResult(value, id),\n\t\t\t\t\t\t(status) => readFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn readFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_find\",\n\t\t\tlabel: \"Find in workspace\",\n\t\t\tdescription: \"Return bounded workspace matches without injecting the full file contents\",\n\t\t\tparameters: Type.Object({ request: findSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.find(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tworkspaceRef: request.workspaceRef as string,\n\t\t\t\t\t\t\t\t\tquery: request.query as string,\n\t\t\t\t\t\t\t\t\t...(request.limit === undefined ? {} : { limit: request.limit as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectFindResult(value, id),\n\t\t\t\t\t\t(status) => findFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn findFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t};\n}\n"]}

package/dist/capability.js

@@ -0,0 +1,246 @@
+import { Type } from "typebox";
+import { projectFind, projectList, projectRead, sanitizeWorkspaceFilesTextV1, WORKSPACE_FILES_MAX_MATCHES_V1, WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1, WORKSPACE_FILES_MAX_QUERY_CHARS_V1, WORKSPACE_FILES_MAX_READ_BYTES_V1, } from "./node-adapter.js";
+const refSchema = Type.String({ minLength: 1, maxLength: 256, pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]*$" });
+const listSchema = Type.Object({
+    workspaceRef: refSchema,
+    directoryRef: Type.Optional(refSchema),
+    limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 256 })),
+}, { additionalProperties: false });
+const readSchema = Type.Object({
+    fileRef: refSchema,
+    maxBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_READ_BYTES_V1 })),
+}, { additionalProperties: false });
+const findSchema = Type.Object({
+    workspaceRef: refSchema,
+    query: Type.String({ minLength: 1, maxLength: WORKSPACE_FILES_MAX_QUERY_CHARS_V1 }),
+    limit: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_MATCHES_V1 })),
+}, { additionalProperties: false });
+function input(first, second) {
+    const value = second === undefined ? first : second;
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new Error("workspace input must be an object");
+    const operationId = typeof first === "string" && first.trim() !== "" && first.length <= WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1
+        ? first
+        : "profile-runtime-tool-call";
+    const outer = value;
+    if (outer.request === null || typeof outer.request !== "object" || Array.isArray(outer.request))
+        throw new Error("workspace request must be an object");
+    return { request: outer.request, operationId };
+}
+function signalFrom(value) {
+    return value instanceof AbortSignal ? value : undefined;
+}
+const NON_SUCCESS_STATUSES = new Set(["failed", "cancelled", "needs_user", "unsupported"]);
+function nonSuccessError(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const error = value;
+    if (error.version !== 1 ||
+        typeof error.code !== "string" ||
+        !/^[a-z][a-z0-9_]{0,127}$/u.test(error.code) ||
+        typeof error.message !== "string" ||
+        error.message.trim() === "" ||
+        error.message.length > 512)
+        return undefined;
+    return { version: 1, code: error.code, message: sanitizeWorkspaceFilesTextV1(error.message, 512) };
+}
+function projectNonSuccess(value, operationId, kind) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const result = value;
+    if (result.version !== 1 || result.operationId !== operationId || typeof result.status !== "string")
+        return undefined;
+    if (!NON_SUCCESS_STATUSES.has(result.status))
+        return undefined;
+    const error = nonSuccessError(result.error);
+    if (error === undefined)
+        return undefined;
+    if (kind === "list") {
+        if (Object.keys(result).some((key) => !["version", "operationId", "status", "entries", "entriesTruncated", "error"].includes(key)) ||
+            !Array.isArray(result.entries) ||
+            result.entries.length !== 0 ||
+            result.entriesTruncated !== false)
+            return undefined;
+        return {
+            version: 1,
+            operationId,
+            status: result.status,
+            entries: [],
+            entriesTruncated: false,
+            error,
+        };
+    }
+    if (kind === "read") {
+        if (Object.keys(result).some((key) => ![
+            "version",
+            "operationId",
+            "status",
+            "contentPreview",
+            "contentBytes",
+            "contentTruncated",
+            "artifactRef",
+            "error",
+        ].includes(key)) ||
+            result.contentPreview !== "" ||
+            result.contentBytes !== 0 ||
+            result.contentTruncated !== false)
+            return undefined;
+        return {
+            version: 1,
+            operationId,
+            status: result.status,
+            contentPreview: "",
+            contentBytes: 0,
+            contentTruncated: false,
+            error,
+        };
+    }
+    if (Object.keys(result).some((key) => !["version", "operationId", "status", "matches", "matchesTruncated", "error"].includes(key)) ||
+        !Array.isArray(result.matches) ||
+        result.matches.length !== 0 ||
+        result.matchesTruncated !== false)
+        return undefined;
+    return {
+        version: 1,
+        operationId,
+        status: result.status,
+        matches: [],
+        matchesTruncated: false,
+        error,
+    };
+}
+function projectListResult(value, operationId) {
+    return (projectList(value, operationId) ??
+        projectNonSuccess(value, operationId, "list"));
+}
+function projectReadResult(value, operationId) {
+    return (projectRead(value, operationId) ??
+        projectNonSuccess(value, operationId, "read"));
+}
+function projectFindResult(value, operationId) {
+    return (projectFind(value, operationId) ??
+        projectNonSuccess(value, operationId, "find"));
+}
+function errorFor(status) {
+    const error = {
+        version: 1,
+        code: status === "cancelled" ? "cancelled" : "adapter_failed",
+        message: status === "cancelled" ? "Workspace operation was cancelled" : "Workspace file adapter failed",
+    };
+    return error;
+}
+function listFallback(operationId, status) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        entries: [],
+        entriesTruncated: false,
+        error: errorFor(status),
+    };
+}
+function readFallback(operationId, status) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        contentPreview: "",
+        contentBytes: 0,
+        contentTruncated: false,
+        error: errorFor(status),
+    };
+}
+function findFallback(operationId, status) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        matches: [],
+        matchesTruncated: false,
+        error: errorFor(status),
+    };
+}
+async function execute(operationId, signal, run, project, fallbackResult) {
+    if (signal?.aborted)
+        return fallbackResult("cancelled");
+    try {
+        const result = await run();
+        return project(result, operationId) ?? fallbackResult("failed");
+    }
+    catch {
+        return fallbackResult("failed");
+    }
+}
+/** Registers bounded workspace reads using only opaque host-owned references. */
+export function createWorkspaceFilesCapabilityFactoryV1(runtime) {
+    return (api) => {
+        api.registerTool({
+            name: "workspace_list",
+            label: "List workspace files",
+            description: "List bounded workspace entries through host-owned opaque references",
+            parameters: Type.Object({ request: listSchema }, { additionalProperties: false }),
+            execute: async (first, second, third) => {
+                try {
+                    const { request, operationId } = input(first, second);
+                    const signal = signalFrom(third);
+                    return execute(operationId, signal, () => runtime.list({
+                        version: 1,
+                        operationId,
+                        workspaceRef: request.workspaceRef,
+                        ...(request.directoryRef === undefined
+                            ? {}
+                            : { directoryRef: request.directoryRef }),
+                        ...(request.limit === undefined ? {} : { limit: request.limit }),
+                    }, signal), (value, id) => projectListResult(value, id), (status) => listFallback(operationId, status));
+                }
+                catch {
+                    return listFallback("profile-runtime-tool-call", "failed");
+                }
+            },
+        });
+        api.registerTool({
+            name: "workspace_read",
+            label: "Read workspace file",
+            description: "Read a bounded preview from a host-owned workspace file reference",
+            parameters: Type.Object({ request: readSchema }, { additionalProperties: false }),
+            execute: async (first, second, third) => {
+                try {
+                    const { request, operationId } = input(first, second);
+                    const signal = signalFrom(third);
+                    return execute(operationId, signal, () => runtime.read({
+                        version: 1,
+                        operationId,
+                        fileRef: request.fileRef,
+                        ...(request.maxBytes === undefined ? {} : { maxBytes: request.maxBytes }),
+                    }, signal), (value, id) => projectReadResult(value, id), (status) => readFallback(operationId, status));
+                }
+                catch {
+                    return readFallback("profile-runtime-tool-call", "failed");
+                }
+            },
+        });
+        api.registerTool({
+            name: "workspace_find",
+            label: "Find in workspace",
+            description: "Return bounded workspace matches without injecting the full file contents",
+            parameters: Type.Object({ request: findSchema }, { additionalProperties: false }),
+            execute: async (first, second, third) => {
+                try {
+                    const { request, operationId } = input(first, second);
+                    const signal = signalFrom(third);
+                    return execute(operationId, signal, () => runtime.find({
+                        version: 1,
+                        operationId,
+                        workspaceRef: request.workspaceRef,
+                        query: request.query,
+                        ...(request.limit === undefined ? {} : { limit: request.limit }),
+                    }, signal), (value, id) => projectFindResult(value, id), (status) => findFallback(operationId, status));
+                }
+                catch {
+                    return findFallback("profile-runtime-tool-call", "failed");
+                }
+            },
+        });
+    };
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CapabilityPluginSyncFactory } from \"@agent-forge/plugin-sdk\";\nimport { Type } from \"typebox\";\nimport {\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tsanitizeWorkspaceFilesTextV1,\n\tWORKSPACE_FILES_MAX_MATCHES_V1,\n\tWORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1,\n\tWORKSPACE_FILES_MAX_QUERY_CHARS_V1,\n\tWORKSPACE_FILES_MAX_READ_BYTES_V1,\n} from \"./node-adapter.ts\";\nimport type {\n\tWorkspaceFilesAdapterV1,\n\tWorkspaceFilesFindResultV1,\n\tWorkspaceFilesListResultV1,\n\tWorkspaceFilesReadResultV1,\n} from \"./types.ts\";\n\nconst refSchema = Type.String({ minLength: 1, maxLength: 256, pattern: \"^[A-Za-z0-9][A-Za-z0-9._:-]*$\" });\nconst listSchema = Type.Object(\n\t{\n\t\tworkspaceRef: refSchema,\n\t\tdirectoryRef: Type.Optional(refSchema),\n\t\tlimit: Type.Optional(Type.Integer({ minimum: 1, maximum: 256 })),\n\t},\n\t{ additionalProperties: false },\n);\nconst readSchema = Type.Object(\n\t{\n\t\tfileRef: refSchema,\n\t\tmaxBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_READ_BYTES_V1 })),\n\t},\n\t{ additionalProperties: false },\n);\nconst findSchema = Type.Object(\n\t{\n\t\tworkspaceRef: refSchema,\n\t\tquery: Type.String({ minLength: 1, maxLength: WORKSPACE_FILES_MAX_QUERY_CHARS_V1 }),\n\t\tlimit: Type.Optional(Type.Integer({ minimum: 1, maximum: WORKSPACE_FILES_MAX_MATCHES_V1 })),\n\t},\n\t{ additionalProperties: false },\n);\n\ntype Result = WorkspaceFilesListResultV1 | WorkspaceFilesReadResultV1 | WorkspaceFilesFindResultV1;\n\nfunction input(\n\tfirst: unknown,\n\tsecond: unknown,\n): { readonly request: Record<string, unknown>; readonly operationId: string } {\n\tconst value = second === undefined ? first : second;\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value))\n\t\tthrow new Error(\"workspace input must be an object\");\n\tconst operationId =\n\t\ttypeof first === \"string\" && first.trim() !== \"\" && first.length <= WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t\t\t? first\n\t\t\t: \"profile-runtime-tool-call\";\n\tconst outer = value as Record<string, unknown>;\n\tif (outer.request === null || typeof outer.request !== \"object\" || Array.isArray(outer.request))\n\t\tthrow new Error(\"workspace request must be an object\");\n\treturn { request: outer.request as Record<string, unknown>, operationId };\n}\n\nfunction signalFrom(value: unknown): AbortSignal | undefined {\n\treturn value instanceof AbortSignal ? value : undefined;\n}\n\nconst NON_SUCCESS_STATUSES = new Set([\"failed\", \"cancelled\", \"needs_user\", \"unsupported\"]);\n\nfunction nonSuccessError(value: unknown): WorkspaceFilesListResultV1[\"error\"] | undefined {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst error = value as Record<string, unknown>;\n\tif (\n\t\terror.version !== 1 ||\n\t\ttypeof error.code !== \"string\" ||\n\t\t!/^[a-z][a-z0-9_]{0,127}$/u.test(error.code) ||\n\t\ttypeof error.message !== \"string\" ||\n\t\terror.message.trim() === \"\" ||\n\t\terror.message.length > 512\n\t)\n\t\treturn undefined;\n\treturn { version: 1, code: error.code, message: sanitizeWorkspaceFilesTextV1(error.message, 512) };\n}\n\nfunction projectNonSuccess(value: unknown, operationId: string, kind: \"list\" | \"read\" | \"find\"): Result | undefined {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst result = value as Record<string, unknown>;\n\tif (result.version !== 1 || result.operationId !== operationId || typeof result.status !== \"string\")\n\t\treturn undefined;\n\tif (!NON_SUCCESS_STATUSES.has(result.status)) return undefined;\n\tconst error = nonSuccessError(result.error);\n\tif (error === undefined) return undefined;\n\tif (kind === \"list\") {\n\t\tif (\n\t\t\tObject.keys(result).some(\n\t\t\t\t(key) => ![\"version\", \"operationId\", \"status\", \"entries\", \"entriesTruncated\", \"error\"].includes(key),\n\t\t\t) ||\n\t\t\t!Array.isArray(result.entries) ||\n\t\t\tresult.entries.length !== 0 ||\n\t\t\tresult.entriesTruncated !== false\n\t\t)\n\t\t\treturn undefined;\n\t\treturn {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: result.status as WorkspaceFilesListResultV1[\"status\"],\n\t\t\tentries: [],\n\t\t\tentriesTruncated: false,\n\t\t\terror,\n\t\t};\n\t}\n\tif (kind === \"read\") {\n\t\tif (\n\t\t\tObject.keys(result).some(\n\t\t\t\t(key) =>\n\t\t\t\t\t![\n\t\t\t\t\t\t\"version\",\n\t\t\t\t\t\t\"operationId\",\n\t\t\t\t\t\t\"status\",\n\t\t\t\t\t\t\"contentPreview\",\n\t\t\t\t\t\t\"contentBytes\",\n\t\t\t\t\t\t\"contentTruncated\",\n\t\t\t\t\t\t\"artifactRef\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t].includes(key),\n\t\t\t) ||\n\t\t\tresult.contentPreview !== \"\" ||\n\t\t\tresult.contentBytes !== 0 ||\n\t\t\tresult.contentTruncated !== false\n\t\t)\n\t\t\treturn undefined;\n\t\treturn {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: result.status as WorkspaceFilesReadResultV1[\"status\"],\n\t\t\tcontentPreview: \"\",\n\t\t\tcontentBytes: 0,\n\t\t\tcontentTruncated: false,\n\t\t\terror,\n\t\t};\n\t}\n\tif (\n\t\tObject.keys(result).some(\n\t\t\t(key) => ![\"version\", \"operationId\", \"status\", \"matches\", \"matchesTruncated\", \"error\"].includes(key),\n\t\t) ||\n\t\t!Array.isArray(result.matches) ||\n\t\tresult.matches.length !== 0 ||\n\t\tresult.matchesTruncated !== false\n\t)\n\t\treturn undefined;\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: result.status as WorkspaceFilesFindResultV1[\"status\"],\n\t\tmatches: [],\n\t\tmatchesTruncated: false,\n\t\terror,\n\t};\n}\n\nfunction projectListResult(value: unknown, operationId: string): WorkspaceFilesListResultV1 | undefined {\n\treturn (\n\t\tprojectList(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"list\") as WorkspaceFilesListResultV1 | undefined)\n\t);\n}\n\nfunction projectReadResult(value: unknown, operationId: string): WorkspaceFilesReadResultV1 | undefined {\n\treturn (\n\t\tprojectRead(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"read\") as WorkspaceFilesReadResultV1 | undefined)\n\t);\n}\n\nfunction projectFindResult(value: unknown, operationId: string): WorkspaceFilesFindResultV1 | undefined {\n\treturn (\n\t\tprojectFind(value, operationId) ??\n\t\t(projectNonSuccess(value, operationId, \"find\") as WorkspaceFilesFindResultV1 | undefined)\n\t);\n}\n\nfunction errorFor(status: \"failed\" | \"cancelled\") {\n\tconst error = {\n\t\tversion: 1 as const,\n\t\tcode: status === \"cancelled\" ? \"cancelled\" : \"adapter_failed\",\n\t\tmessage: status === \"cancelled\" ? \"Workspace operation was cancelled\" : \"Workspace file adapter failed\",\n\t};\n\treturn error;\n}\n\nfunction listFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesListResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tentries: [],\n\t\tentriesTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nfunction readFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesReadResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tcontentPreview: \"\",\n\t\tcontentBytes: 0,\n\t\tcontentTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nfunction findFallback(operationId: string, status: \"failed\" | \"cancelled\"): WorkspaceFilesFindResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus,\n\t\tmatches: [],\n\t\tmatchesTruncated: false,\n\t\terror: errorFor(status),\n\t};\n}\n\nasync function execute<T extends Result>(\n\toperationId: string,\n\tsignal: AbortSignal | undefined,\n\trun: () => Promise<T>,\n\tproject: (value: unknown, operationId: string) => T | undefined,\n\tfallbackResult: (status: \"failed\" | \"cancelled\") => T,\n): Promise<T> {\n\tif (signal?.aborted) return fallbackResult(\"cancelled\");\n\ttry {\n\t\tconst result = await run();\n\t\treturn project(result, operationId) ?? fallbackResult(\"failed\");\n\t} catch {\n\t\treturn fallbackResult(\"failed\");\n\t}\n}\n\n/** Registers bounded workspace reads using only opaque host-owned references. */\nexport function createWorkspaceFilesCapabilityFactoryV1(runtime: WorkspaceFilesAdapterV1): CapabilityPluginSyncFactory {\n\treturn (api) => {\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_list\",\n\t\t\tlabel: \"List workspace files\",\n\t\t\tdescription: \"List bounded workspace entries through host-owned opaque references\",\n\t\t\tparameters: Type.Object({ request: listSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.list(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tworkspaceRef: request.workspaceRef as string,\n\t\t\t\t\t\t\t\t\t...(request.directoryRef === undefined\n\t\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t\t: { directoryRef: request.directoryRef as string }),\n\t\t\t\t\t\t\t\t\t...(request.limit === undefined ? {} : { limit: request.limit as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectListResult(value, id),\n\t\t\t\t\t\t(status) => listFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn listFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_read\",\n\t\t\tlabel: \"Read workspace file\",\n\t\t\tdescription: \"Read a bounded preview from a host-owned workspace file reference\",\n\t\t\tparameters: Type.Object({ request: readSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.read(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tfileRef: request.fileRef as string,\n\t\t\t\t\t\t\t\t\t...(request.maxBytes === undefined ? {} : { maxBytes: request.maxBytes as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectReadResult(value, id),\n\t\t\t\t\t\t(status) => readFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn readFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\tapi.registerTool({\n\t\t\tname: \"workspace_find\",\n\t\t\tlabel: \"Find in workspace\",\n\t\t\tdescription: \"Return bounded workspace matches without injecting the full file contents\",\n\t\t\tparameters: Type.Object({ request: findSchema }, { additionalProperties: false }),\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { request, operationId } = input(first, second);\n\t\t\t\t\tconst signal = signalFrom(third);\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\toperationId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t() =>\n\t\t\t\t\t\t\truntime.find(\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\t\t\t\toperationId,\n\t\t\t\t\t\t\t\t\tworkspaceRef: request.workspaceRef as string,\n\t\t\t\t\t\t\t\t\tquery: request.query as string,\n\t\t\t\t\t\t\t\t\t...(request.limit === undefined ? {} : { limit: request.limit as number }),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t(value, id) => projectFindResult(value, id),\n\t\t\t\t\t\t(status) => findFallback(operationId, status),\n\t\t\t\t\t);\n\t\t\t\t} catch {\n\t\t\t\t\treturn findFallback(\"profile-runtime-tool-call\", \"failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t};\n}\n"]}

package/dist/entry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Default-export factory consumed by the host's `loadCapabilityPluginFromManifest`.
+ *
+ * The adapter is deliberately constructed without host injection: workspace
+ * listing, reading, and search are host-owned per workspace (list/read/find
+ * seams resolve opaque refs to real files), so the registered
+ * `workspace_list`/`workspace_read`/`workspace_find` tools report an explicit
+ * `unsupported` result until a host binds a real file host through its own
+ * profile machinery (fail-closed by design, same contract as the embedded
+ * build).
+ */
+declare const _default: import("@agent-forge/plugin-sdk").CapabilityPluginSyncFactory;
+export default _default;
+//# 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":"AAGA;;;;;;;;;;GAUG;;AACH,wBAA4F","sourcesContent":["import { createWorkspaceFilesCapabilityFactoryV1 } from \"./capability.ts\";\nimport { createNodeWorkspaceFilesAdapterV1 } from \"./node-adapter.ts\";\n\n/**\n * Default-export factory consumed by the host's `loadCapabilityPluginFromManifest`.\n *\n * The adapter is deliberately constructed without host injection: workspace\n * listing, reading, and search are host-owned per workspace (list/read/find\n * seams resolve opaque refs to real files), so the registered\n * `workspace_list`/`workspace_read`/`workspace_find` tools report an explicit\n * `unsupported` result until a host binds a real file host through its own\n * profile machinery (fail-closed by design, same contract as the embedded\n * build).\n */\nexport default createWorkspaceFilesCapabilityFactoryV1(createNodeWorkspaceFilesAdapterV1());\n"]}

package/dist/entry.js

@@ -0,0 +1,15 @@
+import { createWorkspaceFilesCapabilityFactoryV1 } from "./capability.js";
+import { createNodeWorkspaceFilesAdapterV1 } from "./node-adapter.js";
+/**
+ * Default-export factory consumed by the host's `loadCapabilityPluginFromManifest`.
+ *
+ * The adapter is deliberately constructed without host injection: workspace
+ * listing, reading, and search are host-owned per workspace (list/read/find
+ * seams resolve opaque refs to real files), so the registered
+ * `workspace_list`/`workspace_read`/`workspace_find` tools report an explicit
+ * `unsupported` result until a host binds a real file host through its own
+ * profile machinery (fail-closed by design, same contract as the embedded
+ * build).
+ */
+export default createWorkspaceFilesCapabilityFactoryV1(createNodeWorkspaceFilesAdapterV1());
+//# 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,EAAE,uCAAuC,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAe,uCAAuC,CAAC,iCAAiC,EAAE,CAAC,CAAC","sourcesContent":["import { createWorkspaceFilesCapabilityFactoryV1 } from \"./capability.ts\";\nimport { createNodeWorkspaceFilesAdapterV1 } from \"./node-adapter.ts\";\n\n/**\n * Default-export factory consumed by the host's `loadCapabilityPluginFromManifest`.\n *\n * The adapter is deliberately constructed without host injection: workspace\n * listing, reading, and search are host-owned per workspace (list/read/find\n * seams resolve opaque refs to real files), so the registered\n * `workspace_list`/`workspace_read`/`workspace_find` tools report an explicit\n * `unsupported` result until a host binds a real file host through its own\n * profile machinery (fail-closed by design, same contract as the embedded\n * build).\n */\nexport default createWorkspaceFilesCapabilityFactoryV1(createNodeWorkspaceFilesAdapterV1());\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createWorkspaceFilesCapabilityFactoryV1 } from "./capability.ts";
+export { contextSafe, createNodeWorkspaceFilesAdapterV1, projectFind, projectList, projectRead, sanitizeWorkspaceFilesTextV1, validateFindRequest, validateListRequest, validateReadRequest, WORKSPACE_FILES_MAX_ENTRIES_V1, WORKSPACE_FILES_MAX_MATCHES_V1, WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1, WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1, WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1, WORKSPACE_FILES_MAX_QUERY_CHARS_V1, WORKSPACE_FILES_MAX_READ_BYTES_V1, } from "./node-adapter.ts";
+export type * from "./types.ts";
+export type { NodeWorkspaceFilesAdapterOptionsV1 } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,iCAAiC,EACjC,WAAW,EACX,WAAW,EACX,WAAW,EACX,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,yCAAyC,EACzC,mCAAmC,EACnC,oCAAoC,EACpC,kCAAkC,EAClC,iCAAiC,GACjC,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,YAAY,CAAC;AAChC,YAAY,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { createWorkspaceFilesCapabilityFactoryV1 } from \"./capability.ts\";\nexport {\n\tcontextSafe,\n\tcreateNodeWorkspaceFilesAdapterV1,\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tsanitizeWorkspaceFilesTextV1,\n\tvalidateFindRequest,\n\tvalidateListRequest,\n\tvalidateReadRequest,\n\tWORKSPACE_FILES_MAX_ENTRIES_V1,\n\tWORKSPACE_FILES_MAX_MATCHES_V1,\n\tWORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1,\n\tWORKSPACE_FILES_MAX_OUTPUT_BYTES_V1,\n\tWORKSPACE_FILES_MAX_PREVIEW_CHARS_V1,\n\tWORKSPACE_FILES_MAX_QUERY_CHARS_V1,\n\tWORKSPACE_FILES_MAX_READ_BYTES_V1,\n} from \"./node-adapter.ts\";\nexport type * from \"./types.ts\";\nexport type { NodeWorkspaceFilesAdapterOptionsV1 } from \"./types.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createWorkspaceFilesCapabilityFactoryV1 } from "./capability.js";
+export { contextSafe, createNodeWorkspaceFilesAdapterV1, projectFind, projectList, projectRead, sanitizeWorkspaceFilesTextV1, validateFindRequest, validateListRequest, validateReadRequest, WORKSPACE_FILES_MAX_ENTRIES_V1, WORKSPACE_FILES_MAX_MATCHES_V1, WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1, WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1, WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1, WORKSPACE_FILES_MAX_QUERY_CHARS_V1, WORKSPACE_FILES_MAX_READ_BYTES_V1, } from "./node-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,iCAAiC,EACjC,WAAW,EACX,WAAW,EACX,WAAW,EACX,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,yCAAyC,EACzC,mCAAmC,EACnC,oCAAoC,EACpC,kCAAkC,EAClC,iCAAiC,GACjC,MAAM,mBAAmB,CAAC","sourcesContent":["export { createWorkspaceFilesCapabilityFactoryV1 } from \"./capability.ts\";\nexport {\n\tcontextSafe,\n\tcreateNodeWorkspaceFilesAdapterV1,\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tsanitizeWorkspaceFilesTextV1,\n\tvalidateFindRequest,\n\tvalidateListRequest,\n\tvalidateReadRequest,\n\tWORKSPACE_FILES_MAX_ENTRIES_V1,\n\tWORKSPACE_FILES_MAX_MATCHES_V1,\n\tWORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1,\n\tWORKSPACE_FILES_MAX_OUTPUT_BYTES_V1,\n\tWORKSPACE_FILES_MAX_PREVIEW_CHARS_V1,\n\tWORKSPACE_FILES_MAX_QUERY_CHARS_V1,\n\tWORKSPACE_FILES_MAX_READ_BYTES_V1,\n} from \"./node-adapter.ts\";\nexport type * from \"./types.ts\";\nexport type { NodeWorkspaceFilesAdapterOptionsV1 } from \"./types.ts\";\n"]}

package/dist/node-adapter.d.ts

@@ -0,0 +1,21 @@
+import { type NodeWorkspaceFilesAdapterOptionsV1, type WorkspaceFilesAdapterV1, type WorkspaceFilesFindRequestV1, type WorkspaceFilesFindResultV1, type WorkspaceFilesListRequestV1, type WorkspaceFilesListResultV1, type WorkspaceFilesReadRequestV1, type WorkspaceFilesReadResultV1 } from "./types.ts";
+export declare const WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1 = 256;
+export declare const WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1: number;
+export declare const WORKSPACE_FILES_MAX_ENTRIES_V1 = 256;
+export declare const WORKSPACE_FILES_MAX_MATCHES_V1 = 128;
+export declare const WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 = 4096;
+export declare const WORKSPACE_FILES_MAX_REF_CHARS_V1 = 256;
+export declare const WORKSPACE_FILES_MAX_NAME_CHARS_V1 = 256;
+export declare const WORKSPACE_FILES_MAX_QUERY_CHARS_V1 = 512;
+export declare const WORKSPACE_FILES_MAX_READ_BYTES_V1: number;
+export declare function sanitizeWorkspaceFilesTextV1(value: string, maximum?: number): string;
+declare function validateListRequest(request: WorkspaceFilesListRequestV1): string | undefined;
+declare function validateReadRequest(request: WorkspaceFilesReadRequestV1): string | undefined;
+declare function validateFindRequest(request: WorkspaceFilesFindRequestV1): string | undefined;
+declare function projectList(value: unknown, operationId: string): WorkspaceFilesListResultV1 | undefined;
+declare function projectRead(value: unknown, operationId: string): WorkspaceFilesReadResultV1 | undefined;
+declare function projectFind(value: unknown, operationId: string): WorkspaceFilesFindResultV1 | undefined;
+declare function contextSafe(operationId: string, items: readonly object[], truncated: boolean, outputArtifactRef?: string): boolean;
+export declare function createNodeWorkspaceFilesAdapterV1(options?: NodeWorkspaceFilesAdapterOptionsV1): WorkspaceFilesAdapterV1;
+export { contextSafe, projectFind, projectList, projectRead, validateFindRequest, validateListRequest, validateReadRequest, };
+//# sourceMappingURL=node-adapter.d.ts.map

package/dist/node-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.d.ts","sourceRoot":"","sources":["../src/node-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,kCAAkC,EAKvC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,yCAAyC,MAAM,CAAC;AAC7D,eAAO,MAAM,mCAAmC,QAAY,CAAC;AAC7D,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,oCAAoC,OAAO,CAAC;AACzD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,kCAAkC,MAAM,CAAC;AACtD,eAAO,MAAM,iCAAiC,QAAkB,CAAC;AAwCjE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAuC,GAAG,MAAM,CAElH;AAmDD,iBAAS,mBAAmB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAcrF;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAYrF;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAkBrF;AAuBD,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAuBhG;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CA6BhG;AAeD,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAuBhG;AAMD,iBAAS,WAAW,CACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,OAAO,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACxB,OAAO,CAiBT;AAuDD,wBAAgB,iCAAiC,CAChD,OAAO,GAAE,kCAAuC,GAC9C,uBAAuB,CA4DzB;AAED,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACnB,CAAC","sourcesContent":["import type { JsonValue } from \"@agent-forge/plugin-sdk\";\nimport { projectPluginContextV1 } from \"@agent-forge/plugin-sdk\";\nimport {\n\ttype NodeWorkspaceFilesAdapterOptionsV1,\n\tWORKSPACE_FILES_HOST_ADAPTER_ID_V1,\n\tWORKSPACE_FILES_HOST_ADAPTER_VERSION_V1,\n\ttype WorkspaceFileEntryV1,\n\ttype WorkspaceFileMatchV1,\n\ttype WorkspaceFilesAdapterV1,\n\ttype WorkspaceFilesFindRequestV1,\n\ttype WorkspaceFilesFindResultV1,\n\ttype WorkspaceFilesListRequestV1,\n\ttype WorkspaceFilesListResultV1,\n\ttype WorkspaceFilesReadRequestV1,\n\ttype WorkspaceFilesReadResultV1,\n} from \"./types.ts\";\n\nexport const WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1 = 64 * 1024;\nexport const WORKSPACE_FILES_MAX_ENTRIES_V1 = 256;\nexport const WORKSPACE_FILES_MAX_MATCHES_V1 = 128;\nexport const WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 = 4096;\nexport const WORKSPACE_FILES_MAX_REF_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_NAME_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_QUERY_CHARS_V1 = 512;\nexport const WORKSPACE_FILES_MAX_READ_BYTES_V1 = 4 * 1024 * 1024;\n\nconst OPAQUE_REF_V1 = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u;\nconst SAFE_NAME_V1 = /^[^\\u0000\\r\\n\\\\/]{1,256}$/u;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n\treturn Object.keys(value).every((key) => keys.includes(key));\n}\n\nfunction safeRef(value: unknown): value is string {\n\treturn typeof value === \"string\" && OPAQUE_REF_V1.test(value);\n}\n\nfunction safeArtifactRef(value: unknown): value is string {\n\treturn value === undefined || safeRef(value);\n}\n\nfunction positiveInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 1 && (value as number) <= maximum;\n}\n\nfunction nonNegativeInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0 && (value as number) <= maximum;\n}\n\nfunction sanitizeText(value: string, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1): string {\n\tconst sanitized = value\n\t\t.replace(\n\t\t\t/((?:api[-_ ]?key|access[-_ ]?token|auth(?:orization)?|bearer|password|passwd|secret|token)\\s*[:=]\\s*)([^\\s,;]+)/giu,\n\t\t\t\"$1[redacted-secret]\",\n\t\t)\n\t\t.replace(/(?:[A-Za-z]:[\\\\/]|\\\\\\\\|\\/(?:home|Users|private|tmp|var|workspace)\\/)[^\\s\"'<>]*/gu, \"[redacted-path]\");\n\tconst characters = [...sanitized];\n\treturn characters.length <= maximum ? sanitized : characters.slice(0, maximum).join(\"\");\n}\n\nexport function sanitizeWorkspaceFilesTextV1(value: string, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1): string {\n\treturn sanitizeText(value, maximum);\n}\n\nfunction error(\n\toperationId: string,\n\tstatus: WorkspaceFilesListResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesListResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tentries: [] as readonly WorkspaceFileEntryV1[],\n\t\tentriesTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction readError(\n\toperationId: string,\n\tstatus: WorkspaceFilesReadResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesReadResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tcontentPreview: \"\",\n\t\tcontentBytes: 0,\n\t\tcontentTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction findError(\n\toperationId: string,\n\tstatus: WorkspaceFilesFindResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesFindResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tmatches: [] as readonly WorkspaceFileMatchV1[],\n\t\tmatchesTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction validateListRequest(request: WorkspaceFilesListRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.workspaceRef)) return \"workspaceRef must be an opaque host handle\";\n\tif (request.directoryRef !== undefined && !safeRef(request.directoryRef))\n\t\treturn \"directoryRef must be an opaque host handle\";\n\tif (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_ENTRIES_V1))\n\t\treturn \"limit is invalid\";\n\treturn undefined;\n}\n\nfunction validateReadRequest(request: WorkspaceFilesReadRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.fileRef)) return \"fileRef must be an opaque host handle\";\n\tif (request.maxBytes !== undefined && !positiveInteger(request.maxBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))\n\t\treturn \"maxBytes is invalid\";\n\treturn undefined;\n}\n\nfunction validateFindRequest(request: WorkspaceFilesFindRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.workspaceRef)) return \"workspaceRef must be an opaque host handle\";\n\tif (\n\t\ttypeof request.query !== \"string\" ||\n\t\trequest.query.trim() === \"\" ||\n\t\trequest.query.length > WORKSPACE_FILES_MAX_QUERY_CHARS_V1\n\t)\n\t\treturn \"query is invalid\";\n\tif (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_MATCHES_V1))\n\t\treturn \"limit is invalid\";\n\treturn undefined;\n}\n\nfunction projectEntry(value: unknown): WorkspaceFileEntryV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"version\", \"fileRef\", \"name\", \"kind\", \"sizeBytes\"])) return undefined;\n\tif (\n\t\tvalue.version !== 1 ||\n\t\t!safeRef(value.fileRef) ||\n\t\ttypeof value.name !== \"string\" ||\n\t\t!SAFE_NAME_V1.test(value.name)\n\t)\n\t\treturn undefined;\n\tif (value.kind !== \"file\" && value.kind !== \"directory\") return undefined;\n\tif (value.sizeBytes !== undefined && !nonNegativeInteger(value.sizeBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))\n\t\treturn undefined;\n\treturn {\n\t\tversion: 1,\n\t\tfileRef: value.fileRef,\n\t\tname: sanitizeText(value.name, WORKSPACE_FILES_MAX_NAME_CHARS_V1),\n\t\tkind: value.kind,\n\t\t...(value.sizeBytes === undefined ? {} : { sizeBytes: value.sizeBytes }),\n\t};\n}\n\nfunction projectList(value: unknown, operationId: string): WorkspaceFilesListResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\t!Array.isArray(value.entries) ||\n\t\tvalue.entries.length > WORKSPACE_FILES_MAX_ENTRIES_V1 ||\n\t\ttypeof value.entriesTruncated !== \"boolean\"\n\t)\n\t\treturn undefined;\n\tconst entries = value.entries.map(projectEntry);\n\tif (entries.some((entry) => entry === undefined)) return undefined;\n\tfor (let count = entries.length; count >= 0; count -= 1) {\n\t\tconst projected: WorkspaceFilesListResultV1 = {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: \"succeeded\",\n\t\t\tentries: (entries as WorkspaceFileEntryV1[]).slice(0, count),\n\t\t\tentriesTruncated: value.entriesTruncated || count < entries.length,\n\t\t};\n\t\tif (boundedResult(projected) && contextSafe(operationId, projected.entries, projected.entriesTruncated))\n\t\t\treturn projected;\n\t}\n\treturn undefined;\n}\n\nfunction projectRead(value: unknown, operationId: string): WorkspaceFilesReadResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\ttypeof value.contentPreview !== \"string\" ||\n\t\tvalue.contentPreview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 ||\n\t\t!nonNegativeInteger(value.contentBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1) ||\n\t\ttypeof value.contentTruncated !== \"boolean\" ||\n\t\t!safeArtifactRef(value.artifactRef)\n\t)\n\t\treturn undefined;\n\tconst projected: WorkspaceFilesReadResultV1 = {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"succeeded\",\n\t\tcontentPreview: sanitizeText(value.contentPreview),\n\t\tcontentBytes: value.contentBytes,\n\t\tcontentTruncated: value.contentTruncated,\n\t\t...(value.artifactRef === undefined ? {} : { artifactRef: value.artifactRef }),\n\t};\n\treturn boundedResult(projected) &&\n\t\tcontextSafe(\n\t\t\toperationId,\n\t\t\t[{ contentPreview: projected.contentPreview }],\n\t\t\tprojected.contentTruncated,\n\t\t\tprojected.artifactRef,\n\t\t)\n\t\t? projected\n\t\t: undefined;\n}\n\nfunction projectMatch(value: unknown): WorkspaceFileMatchV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"fileRef\", \"line\", \"column\", \"preview\"])) return undefined;\n\tif (\n\t\t!safeRef(value.fileRef) ||\n\t\t!positiveInteger(value.line, 10_000_000) ||\n\t\t!positiveInteger(value.column, 10_000_000)\n\t)\n\t\treturn undefined;\n\tif (typeof value.preview !== \"string\" || value.preview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1)\n\t\treturn undefined;\n\treturn { fileRef: value.fileRef, line: value.line, column: value.column, preview: sanitizeText(value.preview) };\n}\n\nfunction projectFind(value: unknown, operationId: string): WorkspaceFilesFindResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\t!Array.isArray(value.matches) ||\n\t\tvalue.matches.length > WORKSPACE_FILES_MAX_MATCHES_V1 ||\n\t\ttypeof value.matchesTruncated !== \"boolean\"\n\t)\n\t\treturn undefined;\n\tconst matches = value.matches.map(projectMatch);\n\tif (matches.some((match) => match === undefined)) return undefined;\n\tfor (let count = matches.length; count >= 0; count -= 1) {\n\t\tconst projected: WorkspaceFilesFindResultV1 = {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: \"succeeded\",\n\t\t\tmatches: (matches as WorkspaceFileMatchV1[]).slice(0, count),\n\t\t\tmatchesTruncated: value.matchesTruncated || count < matches.length,\n\t\t};\n\t\tif (boundedResult(projected) && contextSafe(operationId, projected.matches, projected.matchesTruncated))\n\t\t\treturn projected;\n\t}\n\treturn undefined;\n}\n\nfunction boundedResult(value: object): boolean {\n\treturn new TextEncoder().encode(JSON.stringify(value)).byteLength <= WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1;\n}\n\nfunction contextSafe(\n\toperationId: string,\n\titems: readonly object[],\n\ttruncated: boolean,\n\toutputArtifactRef?: string,\n): boolean {\n\treturn (\n\t\tprojectPluginContextV1(\n\t\t\t{\n\t\t\t\tversion: 1,\n\t\t\t\toperationId,\n\t\t\t\titems: items as unknown as JsonValue[],\n\t\t\t\ttruncated,\n\t\t\t\t...(outputArtifactRef === undefined ? {} : { outputArtifactRef }),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmaxOutputBytes: WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1,\n\t\t\t\tmaxInlineItems: WORKSPACE_FILES_MAX_ENTRIES_V1,\n\t\t\t\tmaxCellChars: 4096,\n\t\t\t},\n\t\t).status === \"succeeded\"\n\t);\n}\n\nfunction timeoutMs(value: number | undefined): number {\n\tif (value === undefined) return 30_000;\n\tif (!Number.isSafeInteger(value) || value < 1 || value > 120_000) throw new Error(\"defaultTimeoutMs is invalid\");\n\treturn value;\n}\n\nasync function runHost<T>(\n\tcallback: ((signal: AbortSignal) => Promise<unknown>) | undefined,\n\ttimeout: number,\n\tproject: (value: unknown) => T | undefined,\n\tunsupported: () => T,\n\tsignal: AbortSignal | undefined,\n): Promise<T> {\n\tif (callback === undefined) return unsupported();\n\tif (signal?.aborted) return unsupported();\n\tconst controller = new AbortController();\n\tlet stop: \"timeout\" | \"cancelled\" | undefined;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tlet removeExternalAbort: (() => void) | undefined;\n\tconst stopPromise = new Promise<{ readonly kind: \"stop\" }>((resolve) => {\n\t\tconst cancel = () => {\n\t\t\tstop ??= \"cancelled\";\n\t\t\tcontroller.abort();\n\t\t\tresolve({ kind: \"stop\" });\n\t\t};\n\t\tif (signal !== undefined) {\n\t\t\tsignal.addEventListener(\"abort\", cancel, { once: true });\n\t\t\tremoveExternalAbort = () => signal.removeEventListener(\"abort\", cancel);\n\t\t}\n\t\ttimer = setTimeout(() => {\n\t\t\tif (stop === undefined) {\n\t\t\t\tstop = \"timeout\";\n\t\t\t\tcontroller.abort();\n\t\t\t\tresolve({ kind: \"stop\" });\n\t\t\t}\n\t\t}, timeout);\n\t});\n\tconst callbackPromise = callback(controller.signal).then(\n\t\t(value) => ({ kind: \"value\" as const, value }),\n\t\t() => ({ kind: \"failed\" as const }),\n\t);\n\ttry {\n\t\tconst outcome = await Promise.race([callbackPromise, stopPromise]);\n\t\tif (outcome.kind !== \"value\" || stop !== undefined) return unsupported();\n\t\treturn project(outcome.value) ?? unsupported();\n\t} catch {\n\t\treturn unsupported();\n\t} finally {\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t\tremoveExternalAbort?.();\n\t}\n}\n\nexport function createNodeWorkspaceFilesAdapterV1(\n\toptions: NodeWorkspaceFilesAdapterOptionsV1 = {},\n): WorkspaceFilesAdapterV1 {\n\tconst timeout = timeoutMs(options.defaultTimeoutMs);\n\tconst listHost = options.list;\n\tconst readHost = options.read;\n\tconst findHost = options.find;\n\treturn {\n\t\tadapterId: WORKSPACE_FILES_HOST_ADAPTER_ID_V1,\n\t\tadapterVersion: WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1,\n\t\tlist: async (request, signal) => {\n\t\t\tconst invalid = validateListRequest(request);\n\t\t\tif (invalid !== undefined) return error(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\tlistHost === undefined ? undefined : (hostSignal) => listHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectList(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\terror(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t\tread: async (request, signal) => {\n\t\t\tconst invalid = validateReadRequest(request);\n\t\t\tif (invalid !== undefined) return readError(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\treadHost === undefined ? undefined : (hostSignal) => readHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectRead(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\treadError(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t\tfind: async (request, signal) => {\n\t\t\tconst invalid = validateFindRequest(request);\n\t\t\tif (invalid !== undefined) return findError(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\tfindHost === undefined ? undefined : (hostSignal) => findHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectFind(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\tfindError(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t};\n}\n\nexport {\n\tcontextSafe,\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tvalidateFindRequest,\n\tvalidateListRequest,\n\tvalidateReadRequest,\n};\n"]}

package/dist/node-adapter.js

@@ -0,0 +1,313 @@
+import { projectPluginContextV1 } from "@agent-forge/plugin-sdk";
+import { WORKSPACE_FILES_HOST_ADAPTER_ID_V1, WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1, } from "./types.js";
+export const WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1 = 256;
+export const WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1 = 64 * 1024;
+export const WORKSPACE_FILES_MAX_ENTRIES_V1 = 256;
+export const WORKSPACE_FILES_MAX_MATCHES_V1 = 128;
+export const WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 = 4096;
+export const WORKSPACE_FILES_MAX_REF_CHARS_V1 = 256;
+export const WORKSPACE_FILES_MAX_NAME_CHARS_V1 = 256;
+export const WORKSPACE_FILES_MAX_QUERY_CHARS_V1 = 512;
+export const WORKSPACE_FILES_MAX_READ_BYTES_V1 = 4 * 1024 * 1024;
+const OPAQUE_REF_V1 = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u;
+const SAFE_NAME_V1 = /^[^\u0000\r\n\\/]{1,256}$/u;
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOnlyKeys(value, keys) {
+    return Object.keys(value).every((key) => keys.includes(key));
+}
+function safeRef(value) {
+    return typeof value === "string" && OPAQUE_REF_V1.test(value);
+}
+function safeArtifactRef(value) {
+    return value === undefined || safeRef(value);
+}
+function positiveInteger(value, maximum) {
+    return Number.isSafeInteger(value) && value >= 1 && value <= maximum;
+}
+function nonNegativeInteger(value, maximum) {
+    return Number.isSafeInteger(value) && value >= 0 && value <= maximum;
+}
+function sanitizeText(value, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1) {
+    const sanitized = value
+        .replace(/((?:api[-_ ]?key|access[-_ ]?token|auth(?:orization)?|bearer|password|passwd|secret|token)\s*[:=]\s*)([^\s,;]+)/giu, "$1[redacted-secret]")
+        .replace(/(?:[A-Za-z]:[\\/]|\\\\|\/(?:home|Users|private|tmp|var|workspace)\/)[^\s"'<>]*/gu, "[redacted-path]");
+    const characters = [...sanitized];
+    return characters.length <= maximum ? sanitized : characters.slice(0, maximum).join("");
+}
+export function sanitizeWorkspaceFilesTextV1(value, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1) {
+    return sanitizeText(value, maximum);
+}
+function error(operationId, status, code, message) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        entries: [],
+        entriesTruncated: false,
+        error: { version: 1, code, message },
+    };
+}
+function readError(operationId, status, code, message) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        contentPreview: "",
+        contentBytes: 0,
+        contentTruncated: false,
+        error: { version: 1, code, message },
+    };
+}
+function findError(operationId, status, code, message) {
+    return {
+        version: 1,
+        operationId,
+        status,
+        matches: [],
+        matchesTruncated: false,
+        error: { version: 1, code, message },
+    };
+}
+function validateListRequest(request) {
+    if (request.version !== 1)
+        return "version must be 1";
+    if (typeof request.operationId !== "string" ||
+        request.operationId.trim() === "" ||
+        request.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1)
+        return "operationId is invalid";
+    if (!safeRef(request.workspaceRef))
+        return "workspaceRef must be an opaque host handle";
+    if (request.directoryRef !== undefined && !safeRef(request.directoryRef))
+        return "directoryRef must be an opaque host handle";
+    if (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_ENTRIES_V1))
+        return "limit is invalid";
+    return undefined;
+}
+function validateReadRequest(request) {
+    if (request.version !== 1)
+        return "version must be 1";
+    if (typeof request.operationId !== "string" ||
+        request.operationId.trim() === "" ||
+        request.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1)
+        return "operationId is invalid";
+    if (!safeRef(request.fileRef))
+        return "fileRef must be an opaque host handle";
+    if (request.maxBytes !== undefined && !positiveInteger(request.maxBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))
+        return "maxBytes is invalid";
+    return undefined;
+}
+function validateFindRequest(request) {
+    if (request.version !== 1)
+        return "version must be 1";
+    if (typeof request.operationId !== "string" ||
+        request.operationId.trim() === "" ||
+        request.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1)
+        return "operationId is invalid";
+    if (!safeRef(request.workspaceRef))
+        return "workspaceRef must be an opaque host handle";
+    if (typeof request.query !== "string" ||
+        request.query.trim() === "" ||
+        request.query.length > WORKSPACE_FILES_MAX_QUERY_CHARS_V1)
+        return "query is invalid";
+    if (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_MATCHES_V1))
+        return "limit is invalid";
+    return undefined;
+}
+function projectEntry(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["version", "fileRef", "name", "kind", "sizeBytes"]))
+        return undefined;
+    if (value.version !== 1 ||
+        !safeRef(value.fileRef) ||
+        typeof value.name !== "string" ||
+        !SAFE_NAME_V1.test(value.name))
+        return undefined;
+    if (value.kind !== "file" && value.kind !== "directory")
+        return undefined;
+    if (value.sizeBytes !== undefined && !nonNegativeInteger(value.sizeBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))
+        return undefined;
+    return {
+        version: 1,
+        fileRef: value.fileRef,
+        name: sanitizeText(value.name, WORKSPACE_FILES_MAX_NAME_CHARS_V1),
+        kind: value.kind,
+        ...(value.sizeBytes === undefined ? {} : { sizeBytes: value.sizeBytes }),
+    };
+}
+function projectList(value, operationId) {
+    if (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== "succeeded")
+        return undefined;
+    if (!Array.isArray(value.entries) ||
+        value.entries.length > WORKSPACE_FILES_MAX_ENTRIES_V1 ||
+        typeof value.entriesTruncated !== "boolean")
+        return undefined;
+    const entries = value.entries.map(projectEntry);
+    if (entries.some((entry) => entry === undefined))
+        return undefined;
+    for (let count = entries.length; count >= 0; count -= 1) {
+        const projected = {
+            version: 1,
+            operationId,
+            status: "succeeded",
+            entries: entries.slice(0, count),
+            entriesTruncated: value.entriesTruncated || count < entries.length,
+        };
+        if (boundedResult(projected) && contextSafe(operationId, projected.entries, projected.entriesTruncated))
+            return projected;
+    }
+    return undefined;
+}
+function projectRead(value, operationId) {
+    if (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== "succeeded")
+        return undefined;
+    if (typeof value.contentPreview !== "string" ||
+        value.contentPreview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 ||
+        !nonNegativeInteger(value.contentBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1) ||
+        typeof value.contentTruncated !== "boolean" ||
+        !safeArtifactRef(value.artifactRef))
+        return undefined;
+    const projected = {
+        version: 1,
+        operationId,
+        status: "succeeded",
+        contentPreview: sanitizeText(value.contentPreview),
+        contentBytes: value.contentBytes,
+        contentTruncated: value.contentTruncated,
+        ...(value.artifactRef === undefined ? {} : { artifactRef: value.artifactRef }),
+    };
+    return boundedResult(projected) &&
+        contextSafe(operationId, [{ contentPreview: projected.contentPreview }], projected.contentTruncated, projected.artifactRef)
+        ? projected
+        : undefined;
+}
+function projectMatch(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["fileRef", "line", "column", "preview"]))
+        return undefined;
+    if (!safeRef(value.fileRef) ||
+        !positiveInteger(value.line, 10_000_000) ||
+        !positiveInteger(value.column, 10_000_000))
+        return undefined;
+    if (typeof value.preview !== "string" || value.preview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1)
+        return undefined;
+    return { fileRef: value.fileRef, line: value.line, column: value.column, preview: sanitizeText(value.preview) };
+}
+function projectFind(value, operationId) {
+    if (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== "succeeded")
+        return undefined;
+    if (!Array.isArray(value.matches) ||
+        value.matches.length > WORKSPACE_FILES_MAX_MATCHES_V1 ||
+        typeof value.matchesTruncated !== "boolean")
+        return undefined;
+    const matches = value.matches.map(projectMatch);
+    if (matches.some((match) => match === undefined))
+        return undefined;
+    for (let count = matches.length; count >= 0; count -= 1) {
+        const projected = {
+            version: 1,
+            operationId,
+            status: "succeeded",
+            matches: matches.slice(0, count),
+            matchesTruncated: value.matchesTruncated || count < matches.length,
+        };
+        if (boundedResult(projected) && contextSafe(operationId, projected.matches, projected.matchesTruncated))
+            return projected;
+    }
+    return undefined;
+}
+function boundedResult(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength <= WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1;
+}
+function contextSafe(operationId, items, truncated, outputArtifactRef) {
+    return (projectPluginContextV1({
+        version: 1,
+        operationId,
+        items: items,
+        truncated,
+        ...(outputArtifactRef === undefined ? {} : { outputArtifactRef }),
+    }, {
+        maxOutputBytes: WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1,
+        maxInlineItems: WORKSPACE_FILES_MAX_ENTRIES_V1,
+        maxCellChars: 4096,
+    }).status === "succeeded");
+}
+function timeoutMs(value) {
+    if (value === undefined)
+        return 30_000;
+    if (!Number.isSafeInteger(value) || value < 1 || value > 120_000)
+        throw new Error("defaultTimeoutMs is invalid");
+    return value;
+}
+async function runHost(callback, timeout, project, unsupported, signal) {
+    if (callback === undefined)
+        return unsupported();
+    if (signal?.aborted)
+        return unsupported();
+    const controller = new AbortController();
+    let stop;
+    let timer;
+    let removeExternalAbort;
+    const stopPromise = new Promise((resolve) => {
+        const cancel = () => {
+            stop ??= "cancelled";
+            controller.abort();
+            resolve({ kind: "stop" });
+        };
+        if (signal !== undefined) {
+            signal.addEventListener("abort", cancel, { once: true });
+            removeExternalAbort = () => signal.removeEventListener("abort", cancel);
+        }
+        timer = setTimeout(() => {
+            if (stop === undefined) {
+                stop = "timeout";
+                controller.abort();
+                resolve({ kind: "stop" });
+            }
+        }, timeout);
+    });
+    const callbackPromise = callback(controller.signal).then((value) => ({ kind: "value", value }), () => ({ kind: "failed" }));
+    try {
+        const outcome = await Promise.race([callbackPromise, stopPromise]);
+        if (outcome.kind !== "value" || stop !== undefined)
+            return unsupported();
+        return project(outcome.value) ?? unsupported();
+    }
+    catch {
+        return unsupported();
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        removeExternalAbort?.();
+    }
+}
+export function createNodeWorkspaceFilesAdapterV1(options = {}) {
+    const timeout = timeoutMs(options.defaultTimeoutMs);
+    const listHost = options.list;
+    const readHost = options.read;
+    const findHost = options.find;
+    return {
+        adapterId: WORKSPACE_FILES_HOST_ADAPTER_ID_V1,
+        adapterVersion: WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1,
+        list: async (request, signal) => {
+            const invalid = validateListRequest(request);
+            if (invalid !== undefined)
+                return error(request.operationId, "failed", "invalid_input", invalid);
+            return runHost(listHost === undefined ? undefined : (hostSignal) => listHost(request, hostSignal), timeout, (value) => projectList(value, request.operationId), () => error(request.operationId, "unsupported", "workspace_files_unavailable", "No workspace file host is bound"), signal);
+        },
+        read: async (request, signal) => {
+            const invalid = validateReadRequest(request);
+            if (invalid !== undefined)
+                return readError(request.operationId, "failed", "invalid_input", invalid);
+            return runHost(readHost === undefined ? undefined : (hostSignal) => readHost(request, hostSignal), timeout, (value) => projectRead(value, request.operationId), () => readError(request.operationId, "unsupported", "workspace_files_unavailable", "No workspace file host is bound"), signal);
+        },
+        find: async (request, signal) => {
+            const invalid = validateFindRequest(request);
+            if (invalid !== undefined)
+                return findError(request.operationId, "failed", "invalid_input", invalid);
+            return runHost(findHost === undefined ? undefined : (hostSignal) => findHost(request, hostSignal), timeout, (value) => projectFind(value, request.operationId), () => findError(request.operationId, "unsupported", "workspace_files_unavailable", "No workspace file host is bound"), signal);
+        },
+    };
+}
+export { contextSafe, projectFind, projectList, projectRead, validateFindRequest, validateListRequest, validateReadRequest, };
+//# sourceMappingURL=node-adapter.js.map

package/dist/node-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.js","sourceRoot":"","sources":["../src/node-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonValue } from \"@agent-forge/plugin-sdk\";\nimport { projectPluginContextV1 } from \"@agent-forge/plugin-sdk\";\nimport {\n\ttype NodeWorkspaceFilesAdapterOptionsV1,\n\tWORKSPACE_FILES_HOST_ADAPTER_ID_V1,\n\tWORKSPACE_FILES_HOST_ADAPTER_VERSION_V1,\n\ttype WorkspaceFileEntryV1,\n\ttype WorkspaceFileMatchV1,\n\ttype WorkspaceFilesAdapterV1,\n\ttype WorkspaceFilesFindRequestV1,\n\ttype WorkspaceFilesFindResultV1,\n\ttype WorkspaceFilesListRequestV1,\n\ttype WorkspaceFilesListResultV1,\n\ttype WorkspaceFilesReadRequestV1,\n\ttype WorkspaceFilesReadResultV1,\n} from \"./types.ts\";\n\nexport const WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1 = 64 * 1024;\nexport const WORKSPACE_FILES_MAX_ENTRIES_V1 = 256;\nexport const WORKSPACE_FILES_MAX_MATCHES_V1 = 128;\nexport const WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 = 4096;\nexport const WORKSPACE_FILES_MAX_REF_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_NAME_CHARS_V1 = 256;\nexport const WORKSPACE_FILES_MAX_QUERY_CHARS_V1 = 512;\nexport const WORKSPACE_FILES_MAX_READ_BYTES_V1 = 4 * 1024 * 1024;\n\nconst OPAQUE_REF_V1 = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u;\nconst SAFE_NAME_V1 = /^[^\\u0000\\r\\n\\\\/]{1,256}$/u;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n\treturn Object.keys(value).every((key) => keys.includes(key));\n}\n\nfunction safeRef(value: unknown): value is string {\n\treturn typeof value === \"string\" && OPAQUE_REF_V1.test(value);\n}\n\nfunction safeArtifactRef(value: unknown): value is string {\n\treturn value === undefined || safeRef(value);\n}\n\nfunction positiveInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 1 && (value as number) <= maximum;\n}\n\nfunction nonNegativeInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0 && (value as number) <= maximum;\n}\n\nfunction sanitizeText(value: string, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1): string {\n\tconst sanitized = value\n\t\t.replace(\n\t\t\t/((?:api[-_ ]?key|access[-_ ]?token|auth(?:orization)?|bearer|password|passwd|secret|token)\\s*[:=]\\s*)([^\\s,;]+)/giu,\n\t\t\t\"$1[redacted-secret]\",\n\t\t)\n\t\t.replace(/(?:[A-Za-z]:[\\\\/]|\\\\\\\\|\\/(?:home|Users|private|tmp|var|workspace)\\/)[^\\s\"'<>]*/gu, \"[redacted-path]\");\n\tconst characters = [...sanitized];\n\treturn characters.length <= maximum ? sanitized : characters.slice(0, maximum).join(\"\");\n}\n\nexport function sanitizeWorkspaceFilesTextV1(value: string, maximum = WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1): string {\n\treturn sanitizeText(value, maximum);\n}\n\nfunction error(\n\toperationId: string,\n\tstatus: WorkspaceFilesListResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesListResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tentries: [] as readonly WorkspaceFileEntryV1[],\n\t\tentriesTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction readError(\n\toperationId: string,\n\tstatus: WorkspaceFilesReadResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesReadResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tcontentPreview: \"\",\n\t\tcontentBytes: 0,\n\t\tcontentTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction findError(\n\toperationId: string,\n\tstatus: WorkspaceFilesFindResultV1[\"status\"],\n\tcode: string,\n\tmessage: string,\n): WorkspaceFilesFindResultV1 {\n\treturn {\n\t\tversion: 1 as const,\n\t\toperationId,\n\t\tstatus,\n\t\tmatches: [] as readonly WorkspaceFileMatchV1[],\n\t\tmatchesTruncated: false,\n\t\terror: { version: 1 as const, code, message },\n\t};\n}\n\nfunction validateListRequest(request: WorkspaceFilesListRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.workspaceRef)) return \"workspaceRef must be an opaque host handle\";\n\tif (request.directoryRef !== undefined && !safeRef(request.directoryRef))\n\t\treturn \"directoryRef must be an opaque host handle\";\n\tif (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_ENTRIES_V1))\n\t\treturn \"limit is invalid\";\n\treturn undefined;\n}\n\nfunction validateReadRequest(request: WorkspaceFilesReadRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.fileRef)) return \"fileRef must be an opaque host handle\";\n\tif (request.maxBytes !== undefined && !positiveInteger(request.maxBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))\n\t\treturn \"maxBytes is invalid\";\n\treturn undefined;\n}\n\nfunction validateFindRequest(request: WorkspaceFilesFindRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > WORKSPACE_FILES_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (!safeRef(request.workspaceRef)) return \"workspaceRef must be an opaque host handle\";\n\tif (\n\t\ttypeof request.query !== \"string\" ||\n\t\trequest.query.trim() === \"\" ||\n\t\trequest.query.length > WORKSPACE_FILES_MAX_QUERY_CHARS_V1\n\t)\n\t\treturn \"query is invalid\";\n\tif (request.limit !== undefined && !positiveInteger(request.limit, WORKSPACE_FILES_MAX_MATCHES_V1))\n\t\treturn \"limit is invalid\";\n\treturn undefined;\n}\n\nfunction projectEntry(value: unknown): WorkspaceFileEntryV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"version\", \"fileRef\", \"name\", \"kind\", \"sizeBytes\"])) return undefined;\n\tif (\n\t\tvalue.version !== 1 ||\n\t\t!safeRef(value.fileRef) ||\n\t\ttypeof value.name !== \"string\" ||\n\t\t!SAFE_NAME_V1.test(value.name)\n\t)\n\t\treturn undefined;\n\tif (value.kind !== \"file\" && value.kind !== \"directory\") return undefined;\n\tif (value.sizeBytes !== undefined && !nonNegativeInteger(value.sizeBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1))\n\t\treturn undefined;\n\treturn {\n\t\tversion: 1,\n\t\tfileRef: value.fileRef,\n\t\tname: sanitizeText(value.name, WORKSPACE_FILES_MAX_NAME_CHARS_V1),\n\t\tkind: value.kind,\n\t\t...(value.sizeBytes === undefined ? {} : { sizeBytes: value.sizeBytes }),\n\t};\n}\n\nfunction projectList(value: unknown, operationId: string): WorkspaceFilesListResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\t!Array.isArray(value.entries) ||\n\t\tvalue.entries.length > WORKSPACE_FILES_MAX_ENTRIES_V1 ||\n\t\ttypeof value.entriesTruncated !== \"boolean\"\n\t)\n\t\treturn undefined;\n\tconst entries = value.entries.map(projectEntry);\n\tif (entries.some((entry) => entry === undefined)) return undefined;\n\tfor (let count = entries.length; count >= 0; count -= 1) {\n\t\tconst projected: WorkspaceFilesListResultV1 = {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: \"succeeded\",\n\t\t\tentries: (entries as WorkspaceFileEntryV1[]).slice(0, count),\n\t\t\tentriesTruncated: value.entriesTruncated || count < entries.length,\n\t\t};\n\t\tif (boundedResult(projected) && contextSafe(operationId, projected.entries, projected.entriesTruncated))\n\t\t\treturn projected;\n\t}\n\treturn undefined;\n}\n\nfunction projectRead(value: unknown, operationId: string): WorkspaceFilesReadResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\ttypeof value.contentPreview !== \"string\" ||\n\t\tvalue.contentPreview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1 ||\n\t\t!nonNegativeInteger(value.contentBytes, WORKSPACE_FILES_MAX_READ_BYTES_V1) ||\n\t\ttypeof value.contentTruncated !== \"boolean\" ||\n\t\t!safeArtifactRef(value.artifactRef)\n\t)\n\t\treturn undefined;\n\tconst projected: WorkspaceFilesReadResultV1 = {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"succeeded\",\n\t\tcontentPreview: sanitizeText(value.contentPreview),\n\t\tcontentBytes: value.contentBytes,\n\t\tcontentTruncated: value.contentTruncated,\n\t\t...(value.artifactRef === undefined ? {} : { artifactRef: value.artifactRef }),\n\t};\n\treturn boundedResult(projected) &&\n\t\tcontextSafe(\n\t\t\toperationId,\n\t\t\t[{ contentPreview: projected.contentPreview }],\n\t\t\tprojected.contentTruncated,\n\t\t\tprojected.artifactRef,\n\t\t)\n\t\t? projected\n\t\t: undefined;\n}\n\nfunction projectMatch(value: unknown): WorkspaceFileMatchV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"fileRef\", \"line\", \"column\", \"preview\"])) return undefined;\n\tif (\n\t\t!safeRef(value.fileRef) ||\n\t\t!positiveInteger(value.line, 10_000_000) ||\n\t\t!positiveInteger(value.column, 10_000_000)\n\t)\n\t\treturn undefined;\n\tif (typeof value.preview !== \"string\" || value.preview.length > WORKSPACE_FILES_MAX_PREVIEW_CHARS_V1)\n\t\treturn undefined;\n\treturn { fileRef: value.fileRef, line: value.line, column: value.column, preview: sanitizeText(value.preview) };\n}\n\nfunction projectFind(value: unknown, operationId: string): WorkspaceFilesFindResultV1 | undefined {\n\tif (!isRecord(value) || value.version !== 1 || value.operationId !== operationId || value.status !== \"succeeded\")\n\t\treturn undefined;\n\tif (\n\t\t!Array.isArray(value.matches) ||\n\t\tvalue.matches.length > WORKSPACE_FILES_MAX_MATCHES_V1 ||\n\t\ttypeof value.matchesTruncated !== \"boolean\"\n\t)\n\t\treturn undefined;\n\tconst matches = value.matches.map(projectMatch);\n\tif (matches.some((match) => match === undefined)) return undefined;\n\tfor (let count = matches.length; count >= 0; count -= 1) {\n\t\tconst projected: WorkspaceFilesFindResultV1 = {\n\t\t\tversion: 1,\n\t\t\toperationId,\n\t\t\tstatus: \"succeeded\",\n\t\t\tmatches: (matches as WorkspaceFileMatchV1[]).slice(0, count),\n\t\t\tmatchesTruncated: value.matchesTruncated || count < matches.length,\n\t\t};\n\t\tif (boundedResult(projected) && contextSafe(operationId, projected.matches, projected.matchesTruncated))\n\t\t\treturn projected;\n\t}\n\treturn undefined;\n}\n\nfunction boundedResult(value: object): boolean {\n\treturn new TextEncoder().encode(JSON.stringify(value)).byteLength <= WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1;\n}\n\nfunction contextSafe(\n\toperationId: string,\n\titems: readonly object[],\n\ttruncated: boolean,\n\toutputArtifactRef?: string,\n): boolean {\n\treturn (\n\t\tprojectPluginContextV1(\n\t\t\t{\n\t\t\t\tversion: 1,\n\t\t\t\toperationId,\n\t\t\t\titems: items as unknown as JsonValue[],\n\t\t\t\ttruncated,\n\t\t\t\t...(outputArtifactRef === undefined ? {} : { outputArtifactRef }),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmaxOutputBytes: WORKSPACE_FILES_MAX_OUTPUT_BYTES_V1,\n\t\t\t\tmaxInlineItems: WORKSPACE_FILES_MAX_ENTRIES_V1,\n\t\t\t\tmaxCellChars: 4096,\n\t\t\t},\n\t\t).status === \"succeeded\"\n\t);\n}\n\nfunction timeoutMs(value: number | undefined): number {\n\tif (value === undefined) return 30_000;\n\tif (!Number.isSafeInteger(value) || value < 1 || value > 120_000) throw new Error(\"defaultTimeoutMs is invalid\");\n\treturn value;\n}\n\nasync function runHost<T>(\n\tcallback: ((signal: AbortSignal) => Promise<unknown>) | undefined,\n\ttimeout: number,\n\tproject: (value: unknown) => T | undefined,\n\tunsupported: () => T,\n\tsignal: AbortSignal | undefined,\n): Promise<T> {\n\tif (callback === undefined) return unsupported();\n\tif (signal?.aborted) return unsupported();\n\tconst controller = new AbortController();\n\tlet stop: \"timeout\" | \"cancelled\" | undefined;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tlet removeExternalAbort: (() => void) | undefined;\n\tconst stopPromise = new Promise<{ readonly kind: \"stop\" }>((resolve) => {\n\t\tconst cancel = () => {\n\t\t\tstop ??= \"cancelled\";\n\t\t\tcontroller.abort();\n\t\t\tresolve({ kind: \"stop\" });\n\t\t};\n\t\tif (signal !== undefined) {\n\t\t\tsignal.addEventListener(\"abort\", cancel, { once: true });\n\t\t\tremoveExternalAbort = () => signal.removeEventListener(\"abort\", cancel);\n\t\t}\n\t\ttimer = setTimeout(() => {\n\t\t\tif (stop === undefined) {\n\t\t\t\tstop = \"timeout\";\n\t\t\t\tcontroller.abort();\n\t\t\t\tresolve({ kind: \"stop\" });\n\t\t\t}\n\t\t}, timeout);\n\t});\n\tconst callbackPromise = callback(controller.signal).then(\n\t\t(value) => ({ kind: \"value\" as const, value }),\n\t\t() => ({ kind: \"failed\" as const }),\n\t);\n\ttry {\n\t\tconst outcome = await Promise.race([callbackPromise, stopPromise]);\n\t\tif (outcome.kind !== \"value\" || stop !== undefined) return unsupported();\n\t\treturn project(outcome.value) ?? unsupported();\n\t} catch {\n\t\treturn unsupported();\n\t} finally {\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t\tremoveExternalAbort?.();\n\t}\n}\n\nexport function createNodeWorkspaceFilesAdapterV1(\n\toptions: NodeWorkspaceFilesAdapterOptionsV1 = {},\n): WorkspaceFilesAdapterV1 {\n\tconst timeout = timeoutMs(options.defaultTimeoutMs);\n\tconst listHost = options.list;\n\tconst readHost = options.read;\n\tconst findHost = options.find;\n\treturn {\n\t\tadapterId: WORKSPACE_FILES_HOST_ADAPTER_ID_V1,\n\t\tadapterVersion: WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1,\n\t\tlist: async (request, signal) => {\n\t\t\tconst invalid = validateListRequest(request);\n\t\t\tif (invalid !== undefined) return error(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\tlistHost === undefined ? undefined : (hostSignal) => listHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectList(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\terror(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t\tread: async (request, signal) => {\n\t\t\tconst invalid = validateReadRequest(request);\n\t\t\tif (invalid !== undefined) return readError(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\treadHost === undefined ? undefined : (hostSignal) => readHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectRead(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\treadError(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t\tfind: async (request, signal) => {\n\t\t\tconst invalid = validateFindRequest(request);\n\t\t\tif (invalid !== undefined) return findError(request.operationId, \"failed\", \"invalid_input\", invalid);\n\t\t\treturn runHost(\n\t\t\t\tfindHost === undefined ? undefined : (hostSignal) => findHost(request, hostSignal),\n\t\t\t\ttimeout,\n\t\t\t\t(value) => projectFind(value, request.operationId),\n\t\t\t\t() =>\n\t\t\t\t\tfindError(\n\t\t\t\t\t\trequest.operationId,\n\t\t\t\t\t\t\"unsupported\",\n\t\t\t\t\t\t\"workspace_files_unavailable\",\n\t\t\t\t\t\t\"No workspace file host is bound\",\n\t\t\t\t\t),\n\t\t\t\tsignal,\n\t\t\t);\n\t\t},\n\t};\n}\n\nexport {\n\tcontextSafe,\n\tprojectFind,\n\tprojectList,\n\tprojectRead,\n\tvalidateFindRequest,\n\tvalidateListRequest,\n\tvalidateReadRequest,\n};\n"]}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+import type { PluginErrorV1, PluginResultStatusV1 } from "@agent-forge/plugin-sdk";
+export declare const WORKSPACE_FILES_PLUGIN_ID_V1: "agent-forge.plugin.workspace-files";
+export declare const WORKSPACE_FILES_CAPABILITY_VERSION_V1: 1;
+export declare const WORKSPACE_FILES_HOST_ADAPTER_ID_V1: "node-workspace-files";
+export declare const WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1: "1.0.0";
+export type WorkspaceFileKindV1 = "file" | "directory";
+export interface WorkspaceFilesListRequestV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly workspaceRef: string;
+    readonly directoryRef?: string;
+    readonly limit?: number;
+}
+export interface WorkspaceFilesReadRequestV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly fileRef: string;
+    readonly maxBytes?: number;
+}
+export interface WorkspaceFilesFindRequestV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly workspaceRef: string;
+    readonly query: string;
+    readonly limit?: number;
+}
+export interface WorkspaceFileEntryV1 {
+    readonly version: 1;
+    readonly fileRef: string;
+    readonly name: string;
+    readonly kind: WorkspaceFileKindV1;
+    readonly sizeBytes?: number;
+}
+export interface WorkspaceFileMatchV1 {
+    readonly fileRef: string;
+    readonly line: number;
+    readonly column: number;
+    readonly preview: string;
+}
+export interface WorkspaceFilesListResultV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly status: PluginResultStatusV1;
+    readonly entries: readonly WorkspaceFileEntryV1[];
+    readonly entriesTruncated: boolean;
+    readonly error?: PluginErrorV1;
+}
+export interface WorkspaceFilesReadResultV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly status: PluginResultStatusV1;
+    readonly contentPreview: string;
+    readonly contentBytes: number;
+    readonly contentTruncated: boolean;
+    readonly artifactRef?: string;
+    readonly error?: PluginErrorV1;
+}
+export interface WorkspaceFilesFindResultV1 {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly status: PluginResultStatusV1;
+    readonly matches: readonly WorkspaceFileMatchV1[];
+    readonly matchesTruncated: boolean;
+    readonly error?: PluginErrorV1;
+}
+export interface WorkspaceFilesAdapterV1 {
+    readonly adapterId: string;
+    readonly adapterVersion: string;
+    readonly list: (request: WorkspaceFilesListRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesListResultV1>;
+    readonly read: (request: WorkspaceFilesReadRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesReadResultV1>;
+    readonly find: (request: WorkspaceFilesFindRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesFindResultV1>;
+}
+export interface NodeWorkspaceFilesAdapterOptionsV1 {
+    /** Host-owned resolver; the model never supplies a local path. */
+    readonly list?: (request: WorkspaceFilesListRequestV1, signal: AbortSignal) => Promise<unknown>;
+    readonly read?: (request: WorkspaceFilesReadRequestV1, signal: AbortSignal) => Promise<unknown>;
+    readonly find?: (request: WorkspaceFilesFindRequestV1, signal: AbortSignal) => Promise<unknown>;
+    readonly defaultTimeoutMs?: number;
+}
+//# 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 WORKSPACE_FILES_PLUGIN_ID_V1 = \"agent-forge.plugin.workspace-files\" as const;\nexport const WORKSPACE_FILES_CAPABILITY_VERSION_V1 = 1 as const;\nexport const WORKSPACE_FILES_HOST_ADAPTER_ID_V1 = \"node-workspace-files\" as const;\nexport const WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1 = \"1.0.0\" as const;\n\nexport type WorkspaceFileKindV1 = \"file\" | \"directory\";\n\nexport interface WorkspaceFilesListRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly workspaceRef: string;\n\treadonly directoryRef?: string;\n\treadonly limit?: number;\n}\n\nexport interface WorkspaceFilesReadRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly fileRef: string;\n\treadonly maxBytes?: number;\n}\n\nexport interface WorkspaceFilesFindRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly workspaceRef: string;\n\treadonly query: string;\n\treadonly limit?: number;\n}\n\nexport interface WorkspaceFileEntryV1 {\n\treadonly version: 1;\n\treadonly fileRef: string;\n\treadonly name: string;\n\treadonly kind: WorkspaceFileKindV1;\n\treadonly sizeBytes?: number;\n}\n\nexport interface WorkspaceFileMatchV1 {\n\treadonly fileRef: string;\n\treadonly line: number;\n\treadonly column: number;\n\treadonly preview: string;\n}\n\nexport interface WorkspaceFilesListResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly entries: readonly WorkspaceFileEntryV1[];\n\treadonly entriesTruncated: boolean;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesReadResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly contentPreview: string;\n\treadonly contentBytes: number;\n\treadonly contentTruncated: boolean;\n\treadonly artifactRef?: string;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesFindResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly matches: readonly WorkspaceFileMatchV1[];\n\treadonly matchesTruncated: boolean;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesAdapterV1 {\n\treadonly adapterId: string;\n\treadonly adapterVersion: string;\n\treadonly list: (request: WorkspaceFilesListRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesListResultV1>;\n\treadonly read: (request: WorkspaceFilesReadRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesReadResultV1>;\n\treadonly find: (request: WorkspaceFilesFindRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesFindResultV1>;\n}\n\nexport interface NodeWorkspaceFilesAdapterOptionsV1 {\n\t/** Host-owned resolver; the model never supplies a local path. */\n\treadonly list?: (request: WorkspaceFilesListRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly read?: (request: WorkspaceFilesReadRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly find?: (request: WorkspaceFilesFindRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly defaultTimeoutMs?: number;\n}\n"]}

package/dist/types.js

@@ -0,0 +1,5 @@
+export const WORKSPACE_FILES_PLUGIN_ID_V1 = "agent-forge.plugin.workspace-files";
+export const WORKSPACE_FILES_CAPABILITY_VERSION_V1 = 1;
+export const WORKSPACE_FILES_HOST_ADAPTER_ID_V1 = "node-workspace-files";
+export const WORKSPACE_FILES_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,4BAA4B,GAAG,oCAA6C,CAAC;AAC1F,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAU,CAAC;AAChE,MAAM,CAAC,MAAM,kCAAkC,GAAG,sBAA+B,CAAC;AAClF,MAAM,CAAC,MAAM,uCAAuC,GAAG,OAAgB,CAAC","sourcesContent":["import type { PluginErrorV1, PluginResultStatusV1 } from \"@agent-forge/plugin-sdk\";\n\nexport const WORKSPACE_FILES_PLUGIN_ID_V1 = \"agent-forge.plugin.workspace-files\" as const;\nexport const WORKSPACE_FILES_CAPABILITY_VERSION_V1 = 1 as const;\nexport const WORKSPACE_FILES_HOST_ADAPTER_ID_V1 = \"node-workspace-files\" as const;\nexport const WORKSPACE_FILES_HOST_ADAPTER_VERSION_V1 = \"1.0.0\" as const;\n\nexport type WorkspaceFileKindV1 = \"file\" | \"directory\";\n\nexport interface WorkspaceFilesListRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly workspaceRef: string;\n\treadonly directoryRef?: string;\n\treadonly limit?: number;\n}\n\nexport interface WorkspaceFilesReadRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly fileRef: string;\n\treadonly maxBytes?: number;\n}\n\nexport interface WorkspaceFilesFindRequestV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly workspaceRef: string;\n\treadonly query: string;\n\treadonly limit?: number;\n}\n\nexport interface WorkspaceFileEntryV1 {\n\treadonly version: 1;\n\treadonly fileRef: string;\n\treadonly name: string;\n\treadonly kind: WorkspaceFileKindV1;\n\treadonly sizeBytes?: number;\n}\n\nexport interface WorkspaceFileMatchV1 {\n\treadonly fileRef: string;\n\treadonly line: number;\n\treadonly column: number;\n\treadonly preview: string;\n}\n\nexport interface WorkspaceFilesListResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly entries: readonly WorkspaceFileEntryV1[];\n\treadonly entriesTruncated: boolean;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesReadResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly contentPreview: string;\n\treadonly contentBytes: number;\n\treadonly contentTruncated: boolean;\n\treadonly artifactRef?: string;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesFindResultV1 {\n\treadonly version: 1;\n\treadonly operationId: string;\n\treadonly status: PluginResultStatusV1;\n\treadonly matches: readonly WorkspaceFileMatchV1[];\n\treadonly matchesTruncated: boolean;\n\treadonly error?: PluginErrorV1;\n}\n\nexport interface WorkspaceFilesAdapterV1 {\n\treadonly adapterId: string;\n\treadonly adapterVersion: string;\n\treadonly list: (request: WorkspaceFilesListRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesListResultV1>;\n\treadonly read: (request: WorkspaceFilesReadRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesReadResultV1>;\n\treadonly find: (request: WorkspaceFilesFindRequestV1, signal?: AbortSignal) => Promise<WorkspaceFilesFindResultV1>;\n}\n\nexport interface NodeWorkspaceFilesAdapterOptionsV1 {\n\t/** Host-owned resolver; the model never supplies a local path. */\n\treadonly list?: (request: WorkspaceFilesListRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly read?: (request: WorkspaceFilesReadRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly find?: (request: WorkspaceFilesFindRequestV1, signal: AbortSignal) => Promise<unknown>;\n\treadonly defaultTimeoutMs?: number;\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@ai-agent-forge/plugin-workspace-files",
+	"version": "0.85.0",
+	"description": "Workspace files capability plugin for Agent Forge (read-only workspace_list/workspace_read/workspace_find tools)",
+	"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",
+		"workspace",
+		"files"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/workspace-files"
+	},
+	"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.workspace-files",
+	"version": "0.84.4",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.84.4",
+	"requiredCapabilities": ["tools"],
+	"provides": [{ "id": "workspace.files", "version": 1, "kind": "contribution" }]
+}