@pi-harness/plugin-api 0.1.27

package/README.md

@@ -0,0 +1,56 @@
+# @pi-harness/plugin-api
+
+The contract a [Pi Harness](https://github.com/pi-harness/pi-harness) plugin is written against. A plugin is an ordinary [Cordis](https://github.com/deepseek-ai/cordis) plugin; this package supplies the service types the harness puts on the Cordis `Context`, the helpers for declaring plugin configuration, and the bounded file access the harness expects a plugin to use when it touches the workspace.
+
+It carries no launcher, no HTTP server and no bundled runtime, so installing it does not pull the harness itself.
+
+## Install
+
+```sh
+npm install @pi-harness/plugin-api @deepseek-ai/cordis @deepseek-ai/schemastery @earendil-works/pi-ai @earendil-works/pi-coding-agent
+```
+
+The four runtimes are `peerDependencies`. They appear in this package's published type surface, so the plugin and the harness have to resolve the same copy of each: a second copy of `@deepseek-ai/cordis` detaches the `declare module` augmentation and the plugin compiles against a `Context` that carries none of the harness services. Match the versions declared here and npm reports any conflict at install time.
+
+## Use
+
+```ts
+import type { Context } from "@deepseek-ai/cordis";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import type {} from "@pi-harness/plugin-api";
+
+export const helloTool = defineTool({
+  name: "hello",
+  label: "Hello",
+  description: "Greet a person by name.",
+  parameters: Type.Object({ name: Type.String({ description: "The name to greet." }) }),
+  execute(_toolCallId, params) {
+    return Promise.resolve({ content: [{ type: "text", text: `Hello, ${params.name}!` }], details: undefined });
+  },
+});
+
+export default {
+  name: "pi-hello",
+  inject: ["piTools"],
+  apply(context: Context) {
+    context.effect(() => context.piTools.register(helloTool));
+  },
+};
+```
+
+The bare `import type {} from "@pi-harness/plugin-api"` is what applies the `Context` augmentation; without it `context.piTools` does not exist as far as TypeScript is concerned.
+
+`examples/plugin-hello` in the repository is this plugin with its tests.
+
+## Exports
+
+- **Services** — the service interfaces the harness puts on the Cordis `Context` (`PiToolsSnapshot`, `PiSessionService`, `PiModelsService`, `PiRuntimeService`, `PiResourcesService`, `PiMcpService`, `PiTelemetryService`, `PiHarnessLaunch`), the `declare module` augmentation that attaches them, and the `PiToolRegistry` / `PiPluginUiRegistry` a test can construct directly.
+- **Config** — `EmptyConfig` for a plugin that takes no options, and `assertKnownConfigKeys` for rejecting unknown keys with a message that lists the supported ones. Both are built on [Schemastery](https://github.com/shigma/schemastery).
+- **Workspace paths** — `resolveExistingWorkspacePath`, `resolveWorkspaceFilePath`, `prepareWorkspaceFile` and `isPathInside`, which keep a plugin from escaping the workspace root through symlinks or `..`.
+- **Bounded file access** — `readBoundedFile` and `readBoundedTextFile` with their `BoundedFileSizeError` / `BoundedFileTypeError`, which refuse oversized files, directories, FIFOs and symlinks rather than stranding the process on them.
+- **Atomic writes** — `atomicWriteFile`, which serialises concurrent writes to the same path, preserves an existing target's permission bits and fsyncs the containing directory.
+
+## License
+
+MIT

package/dist/atomic-write.d.ts

@@ -0,0 +1,9 @@
+export interface AtomicWriteOptions {
+    encoding?: BufferEncoding | null;
+    /** Permission bits for the written file. Defaults to the existing regular target's own bits, or 0o600 for a new file. */
+    mode?: number;
+    overwrite?: boolean;
+    signal?: AbortSignal;
+}
+export declare function atomicWriteFile(target: string, data: string | NodeJS.ArrayBufferView, options?: AtomicWriteOptions): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../src/atomic-write.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,yHAAyH;IACzH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAsED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtI"}

package/dist/atomic-write.js

@@ -0,0 +1,85 @@
+import { randomUUID } from "node:crypto";
+import { link, lstat, open, rename, rm } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+const writeQueues = new Map();
+// Only operating-system failures are tolerated below; a programmer error (TypeError and friends) carries no errno and must still surface.
+function isErrno(error) {
+    return error instanceof Error && typeof error.code === "string";
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted !== true)
+        return;
+    throw signal.reason instanceof Error ? signal.reason : new Error("Atomic write was cancelled", { cause: signal.reason });
+}
+// Directory fsync makes the rename itself durable. Windows has no directory handles to sync, and some filesystems reject opening or fsyncing a directory descriptor; every such case degrades to the file-level guarantee instead of failing a write that already committed.
+async function syncDirectory(path) {
+    if (process.platform === "win32")
+        return;
+    let handle;
+    try {
+        handle = await open(path, "r");
+        await handle.sync();
+    }
+    catch (error) {
+        if (!isErrno(error))
+            throw error;
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+// The commit replaces the target inode, so the temporary file's permission bits become the target's. A caller that only replaces content must not silently downgrade an existing file, so its current bits are carried over unless the caller pins a mode explicitly.
+async function targetFileMode(target) {
+    try {
+        const info = await lstat(target);
+        return info.isFile() ? info.mode & 0o777 : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeAtomic(target, data, options) {
+    throwIfAborted(options.signal);
+    const temporary = join(dirname(target), `.${basename(target)}.${randomUUID()}.tmp`);
+    const mode = options.mode ?? (await targetFileMode(target)) ?? 0o600;
+    let committed = false;
+    try {
+        // The temporary file must reach stable storage before it is renamed over the target, otherwise a power loss can commit the directory entry while the data blocks are still only in the page cache, leaving an empty or truncated target after the old contents are already gone.
+        const handle = await open(temporary, "wx", mode);
+        try {
+            // open() masks the requested bits with the process umask, so the mode is restated on the handle to land exactly the requested permissions.
+            await handle.chmod(mode);
+            const bytes = typeof data === "string" ? data : Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+            await handle.writeFile(bytes, { encoding: options.encoding, signal: options.signal });
+            throwIfAborted(options.signal);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        throwIfAborted(options.signal);
+        if (options.overwrite === false) {
+            await link(temporary, target);
+            await rm(temporary);
+        }
+        else {
+            await rename(temporary, target);
+        }
+        committed = true;
+        await syncDirectory(dirname(target));
+    }
+    finally {
+        if (!committed)
+            await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+export function atomicWriteFile(target, data, options = {}) {
+    const previous = writeQueues.get(target);
+    const operation = (previous === undefined ? Promise.resolve() : previous.catch(() => undefined)).then(async () => writeAtomic(target, data, options));
+    writeQueues.set(target, operation);
+    return operation.finally(() => {
+        if (writeQueues.get(target) === operation)
+            writeQueues.delete(target);
+    });
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../src/atomic-write.ts"],"names":[],"mappings":"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"}

package/dist/bounded-file.d.ts

@@ -0,0 +1,7 @@
+export declare class BoundedFileSizeError extends Error {
+}
+export declare class BoundedFileTypeError extends Error {
+}
+export declare function readBoundedFile(path: string, maxBytes: number, label: string): Promise<Buffer>;
+export declare function readBoundedTextFile(path: string, maxBytes: number, label: string): Promise<string>;
+//# sourceMappingURL=bounded-file.d.ts.map

package/dist/bounded-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-file.d.ts","sourceRoot":"","sources":["../src/bounded-file.ts"],"names":[],"mappings":"AAGA,qBAAa,oBAAqB,SAAQ,KAAK;CAAG;AAClD,qBAAa,oBAAqB,SAAQ,KAAK;CAAG;AAElD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BpG;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxG"}

package/dist/bounded-file.js

@@ -0,0 +1,51 @@
+import { constants } from "node:fs";
+import { open } from "node:fs/promises";
+export class BoundedFileSizeError extends Error {
+}
+export class BoundedFileTypeError extends Error {
+}
+export async function readBoundedFile(path, maxBytes, label) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 0)
+        throw new Error("Bounded file size must be a non-negative safe integer");
+    let handle;
+    try {
+        // O_NOFOLLOW only rejects symbolic links. Without O_NONBLOCK a FIFO or a blocking device node would suspend the open until a writer appears, so the regular-file check below would never run and the libuv thread serving the call would be lost for the life of the process.
+        handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const metadata = await handle.stat();
+        if (!metadata.isFile())
+            throw new BoundedFileTypeError(`${label} must be a regular file`);
+        if (metadata.size > maxBytes)
+            throw new BoundedFileSizeError(`${label} exceeds the ${maxBytes}-byte limit`);
+        const chunks = [];
+        let total = 0;
+        while (total <= maxBytes) {
+            const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, maxBytes + 1 - total));
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, null);
+            if (bytesRead === 0)
+                break;
+            chunks.push(buffer.subarray(0, bytesRead));
+            total += bytesRead;
+        }
+        if (total > maxBytes)
+            throw new BoundedFileSizeError(`${label} exceeds the ${maxBytes}-byte limit`);
+        return Buffer.concat(chunks, total);
+    }
+    catch (error) {
+        if (error.code === "ELOOP")
+            throw new BoundedFileTypeError(`${label} cannot be a symbolic link`, { cause: error });
+        throw error;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+export async function readBoundedTextFile(path, maxBytes, label) {
+    const bytes = await readBoundedFile(path, maxBytes, label);
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new Error(`${label} must contain valid UTF-8`, { cause: error });
+    }
+}
+//# sourceMappingURL=bounded-file.js.map

package/dist/bounded-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-file.js","sourceRoot":"","sources":["../src/bounded-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,OAAO,oBAAqB,SAAQ,KAAK;CAAG;AAClD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;CAAG;AAElD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IACjF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC9H,IAAI,MAAoD,CAAC;IACzD,IAAI,CAAC;QACH,8QAA8Q;QAC9Q,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAC5F,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,yBAAyB,CAAC,CAAC;QAC1F,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,gBAAgB,QAAQ,aAAa,CAAC,CAAC;QAC5G,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxE,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3C,KAAK,IAAI,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,KAAK,GAAG,QAAQ;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,gBAAgB,QAAQ,aAAa,CAAC,CAAC;QACpG,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,4BAA4B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9I,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IACrF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import z from "@deepseek-ai/schemastery";
+export declare const EmptyConfig: z<any, {}>;
+export declare function assertKnownConfigKeys(plugin: string, config: unknown, known: readonly string[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAEzC,eAAO,MAAM,WAAW,YActB,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAKrG"}

package/dist/config.js

@@ -0,0 +1,29 @@
+import z from "@deepseek-ai/schemastery";
+export const EmptyConfig = z.transform(z.any(), (value) => {
+    if (value === undefined || value === null)
+        return {};
+    if (typeof value !== "object" || Array.isArray(value))
+        throw new Error("expected an object");
+    let prototype;
+    let keys;
+    try {
+        prototype = Object.getPrototypeOf(value);
+        keys = Reflect.ownKeys(value);
+    }
+    catch (error) {
+        throw new Error("configuration could not be inspected safely", { cause: error });
+    }
+    if (prototype !== Object.prototype && prototype !== null)
+        throw new Error("configuration must be a plain object");
+    if (keys.length > 0)
+        throw new Error(`unknown config keys: ${keys.map((key) => String(key)).join(", ")}`);
+    return {};
+});
+export function assertKnownConfigKeys(plugin, config, known) {
+    if (config === undefined || config === null || typeof config !== "object")
+        return;
+    const unknown = Object.keys(config).filter((key) => !known.includes(key));
+    if (unknown.length > 0)
+        throw new Error(`Unknown ${plugin} config keys: ${unknown.join(", ")}; supported keys are ${known.length === 0 ? "(none)" : known.join(", ")}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAc,EAAE,EAAE;IACjE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC7F,IAAI,SAAkB,CAAC;IACvB,IAAI,IAA4B,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAClH,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,MAAe,EAAE,KAAwB;IAC7F,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO;IAClF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpJ,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type HarnessContext = Context;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./atomic-write.js";
+export * from "./bounded-file.js";
+export * from "./config.js";
+export type * from "./context.js";
+export * from "./services.js";
+export * from "./workspace-path.js";
+//# 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,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,mBAAmB,cAAc,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./atomic-write.js";
+export * from "./bounded-file.js";
+export * from "./config.js";
+export * from "./services.js";
+export * from "./workspace-path.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,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAE5B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/dist/services.d.ts

@@ -0,0 +1,118 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { AgentSession, AgentSessionEvent, AgentSessionRuntime, AgentSessionServices, ExtensionError, SessionManager, ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ModelRuntime } from "@earendil-works/pi-coding-agent";
+export interface PiHarnessLaunch {
+    readonly cwd: string;
+    readonly cwdUrl?: string;
+    readonly agentDir: string;
+    readonly configPath?: string;
+    readonly args: readonly string[];
+    requestExit(code: number): void;
+}
+export interface PiModelsService {
+    readonly runtime: ModelRuntime;
+    readonly model: Model<Api>;
+}
+export interface PiModelRuntimeService {
+    readonly runtime: ModelRuntime;
+    readonly provider: string;
+    readonly model: string;
+}
+export type PiResourcesService = AgentSessionServices & {
+    createForCwd(cwd: string): Promise<AgentSessionServices>;
+};
+export interface PiSessionService {
+    readonly manager: SessionManager;
+}
+export interface PiMcpServerSnapshot {
+    readonly id: string;
+    readonly command: readonly string[];
+    readonly status: string;
+    readonly startedAt: number;
+}
+export interface PiMcpService {
+    snapshot(): {
+        readonly servers: readonly PiMcpServerSnapshot[];
+    };
+}
+export interface PiRuntimeService {
+    readonly session: AgentSession;
+    readonly sessionRuntime: AgentSessionRuntime;
+    prompt(text: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): Promise<void>;
+}
+export interface PiTelemetryEvent {
+    readonly name: string;
+    readonly properties?: Readonly<Record<string, unknown>>;
+}
+export interface PiTelemetryService {
+    readonly enabled: false;
+    send(event: PiTelemetryEvent): {
+        blocked: true;
+        name: string;
+    };
+    snapshot(): {
+        blocked: number;
+        names: readonly string[];
+    };
+}
+export interface PiToolsSnapshot {
+    readonly names: string[];
+    readonly customTools: ToolDefinition[];
+}
+export interface PiToolsLease extends PiToolsSnapshot {
+    release(): void;
+}
+export declare class PiToolRegistry {
+    #private;
+    constructor(names?: readonly string[]);
+    register(tool: ToolDefinition): () => void;
+    snapshot(): PiToolsSnapshot;
+    acquire(): PiToolsLease;
+}
+export interface PiPluginPanel {
+    readonly id: string;
+    readonly pluginId: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly visible?: () => boolean | Promise<boolean>;
+    readonly read: () => unknown;
+}
+export interface PiPluginPanelSnapshot {
+    readonly id: string;
+    readonly pluginId: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly data?: unknown;
+    readonly error?: string;
+}
+export declare class PiPluginUiRegistry {
+    #private;
+    register(panel: PiPluginPanel): () => void;
+    snapshot(): Promise<readonly PiPluginPanelSnapshot[]>;
+}
+declare module "@deepseek-ai/cordis" {
+    interface Context {
+        piHarnessLaunch: PiHarnessLaunch;
+        piModelRuntime: PiModelRuntimeService;
+        piModels: PiModelsService;
+        piResources: PiResourcesService;
+        piSession: PiSessionService;
+        piMcp: PiMcpService;
+        piTools: PiToolRegistry;
+        piPluginUi: PiPluginUiRegistry;
+        piRuntime: PiRuntimeService;
+        piTelemetry: PiTelemetryService;
+    }
+    interface Events {
+        "pi/session-event"(event: AgentSessionEvent): void;
+        "pi/extension-error"(error: ExtensionError): void;
+        "pi/telemetry"(event: PiTelemetryEvent): void;
+    }
+}
+export declare function provideLaunchContext(context: Context, launch: PiHarnessLaunch): () => void;
+//# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"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"}

package/dist/services.js

@@ -0,0 +1,115 @@
+import { isAbsolute } from "node:path";
+import { pathToFileURL } from "node:url";
+const PI_BUILTIN_TOOL_NAMES = ["read", "bash", "powershell", "edit", "write", "grep", "find", "ls"];
+const MAX_PI_TOOL_NAMES = 256;
+const MAX_PI_TOOL_NAME_LENGTH = 128;
+const PI_TOOL_NAME_PATTERN = /^[^\s\p{Cc}]+$/u;
+function assertPiToolName(name) {
+    if (typeof name !== "string" || name.length === 0 || name.length > MAX_PI_TOOL_NAME_LENGTH || !PI_TOOL_NAME_PATTERN.test(name))
+        throw new Error(`Pi tool name must contain 1-${MAX_PI_TOOL_NAME_LENGTH} non-whitespace, non-control characters`);
+}
+export class PiToolRegistry {
+    #names;
+    #customTools = new Map();
+    #leases = 0;
+    constructor(names = []) {
+        const uncheckedNames = names;
+        if (!Array.isArray(uncheckedNames) || uncheckedNames.length > MAX_PI_TOOL_NAMES)
+            throw new Error(`Pi tool names must contain at most ${MAX_PI_TOOL_NAMES} entries`);
+        const validatedNames = [];
+        for (const name of uncheckedNames) {
+            const uncheckedName = name;
+            assertPiToolName(uncheckedName);
+            validatedNames.push(uncheckedName);
+        }
+        if (new Set(validatedNames).size !== validatedNames.length)
+            throw new Error("Pi tool names must be unique");
+        this.#names = validatedNames;
+    }
+    register(tool) {
+        assertPiToolName(tool.name);
+        if (this.#leases > 0)
+            throw new Error(`Pi tool registry is leased by pi-runtime; declare a Cordis injection that activates ${tool.name} before pi-runtime`);
+        if (this.#names.includes(tool.name) || this.#customTools.has(tool.name))
+            throw new Error(`Pi tool is already registered: ${tool.name}`);
+        if (PI_BUILTIN_TOOL_NAMES.includes(tool.name))
+            throw new Error(`Pi tool name is reserved by a built-in tool: ${tool.name}`);
+        this.#customTools.set(tool.name, tool);
+        return () => {
+            if (this.#customTools.get(tool.name) === tool)
+                this.#customTools.delete(tool.name);
+        };
+    }
+    snapshot() {
+        return { names: [...this.#names], customTools: [...this.#customTools.values()] };
+    }
+    acquire() {
+        this.#leases += 1;
+        let released = false;
+        return {
+            ...this.snapshot(),
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                this.#leases -= 1;
+            },
+        };
+    }
+}
+export class PiPluginUiRegistry {
+    #panels = new Map();
+    register(panel) {
+        if (panel.id.trim() === "" || panel.pluginId.trim() === "" || panel.title.trim() === "")
+            throw new Error("Plugin UI panel id, pluginId, and title are required");
+        if (this.#panels.has(panel.id))
+            throw new Error(`Plugin UI panel is already registered: ${panel.id}`);
+        this.#panels.set(panel.id, panel);
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            if (this.#panels.get(panel.id) === panel)
+                this.#panels.delete(panel.id);
+        };
+    }
+    async snapshot() {
+        const snapshots = [];
+        for (const panel of this.#panels.values()) {
+            if (panel.visible !== undefined && !(await panel.visible()))
+                continue;
+            try {
+                const data = await panel.read();
+                snapshots.push({
+                    id: panel.id,
+                    pluginId: panel.pluginId,
+                    title: panel.title,
+                    ...(panel.description === undefined ? {} : { description: panel.description }),
+                    ...(panel.icon === undefined ? {} : { icon: panel.icon }),
+                    data: structuredClone(data),
+                });
+            }
+            catch (error) {
+                snapshots.push({
+                    id: panel.id,
+                    pluginId: panel.pluginId,
+                    title: panel.title,
+                    ...(panel.description === undefined ? {} : { description: panel.description }),
+                    ...(panel.icon === undefined ? {} : { icon: panel.icon }),
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return snapshots;
+    }
+}
+export function provideLaunchContext(context, launch) {
+    if (!isAbsolute(launch.cwd))
+        throw new Error(`Pi Harness launch cwd must be an absolute path: ${launch.cwd}`);
+    if (!isAbsolute(launch.agentDir))
+        throw new Error(`Pi Harness agent directory must be an absolute path: ${launch.agentDir}`);
+    const value = Object.freeze({ ...launch, cwdUrl: pathToFileURL(launch.cwd).href, args: Object.freeze([...launch.args]) });
+    return context.provide("piHarnessLaunch", value);
+}
+//# sourceMappingURL=services.js.map

package/dist/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"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"}

package/dist/workspace-path.d.ts

@@ -0,0 +1,13 @@
+export interface WorkspacePath {
+    readonly root: string;
+    readonly target: string;
+    readonly relativePath: string;
+}
+export interface WorkspaceFilePath extends WorkspacePath {
+    readonly exists: boolean;
+}
+export declare function isPathInside(root: string, target: string): boolean;
+export declare function resolveExistingWorkspacePath(root: string, requested: string, message: string): Promise<WorkspacePath>;
+export declare function resolveWorkspaceFilePath(root: string, requested: string, message: string): Promise<WorkspacePath>;
+export declare function prepareWorkspaceFile(root: string, requested: string, message: string): Promise<WorkspaceFilePath>;
+//# sourceMappingURL=workspace-path.d.ts.map

package/dist/workspace-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-path.d.ts","sourceRoot":"","sources":["../src/workspace-path.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGlE;AAMD,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAO3H;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQvH;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqCvH"}

package/dist/workspace-path.js

@@ -0,0 +1,71 @@
+import { lstat, mkdir, realpath, stat } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+export function isPathInside(root, target) {
+    const remainder = relative(root, target);
+    return remainder === "" || (remainder !== ".." && !remainder.startsWith(`..${sep}`) && !isAbsolute(remainder));
+}
+function assertInside(root, target, message) {
+    if (!isPathInside(root, target))
+        throw new Error(message);
+}
+export async function resolveExistingWorkspacePath(root, requested, message) {
+    const canonicalRoot = await realpath(resolve(root));
+    const lexicalTarget = resolve(canonicalRoot, requested);
+    assertInside(canonicalRoot, lexicalTarget, message);
+    const target = await realpath(lexicalTarget);
+    assertInside(canonicalRoot, target, message);
+    return { root: canonicalRoot, target, relativePath: relative(canonicalRoot, target) || "." };
+}
+export async function resolveWorkspaceFilePath(root, requested, message) {
+    const canonicalRoot = await realpath(resolve(root));
+    const lexicalTarget = resolve(canonicalRoot, requested);
+    assertInside(canonicalRoot, lexicalTarget, message);
+    const canonicalParent = await realpath(dirname(lexicalTarget));
+    assertInside(canonicalRoot, canonicalParent, message);
+    const target = join(canonicalParent, basename(lexicalTarget));
+    return { root: canonicalRoot, target, relativePath: relative(canonicalRoot, target) || "." };
+}
+export async function prepareWorkspaceFile(root, requested, message) {
+    const canonicalRoot = await realpath(resolve(root));
+    const lexicalTarget = resolve(canonicalRoot, requested);
+    assertInside(canonicalRoot, lexicalTarget, message);
+    let ancestor = dirname(lexicalTarget);
+    const missing = [];
+    let canonicalAncestor;
+    for (;;) {
+        try {
+            canonicalAncestor = await realpath(ancestor);
+            break;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            const parent = dirname(ancestor);
+            if (parent === ancestor)
+                throw error;
+            missing.unshift(basename(ancestor));
+            ancestor = parent;
+        }
+    }
+    assertInside(canonicalRoot, canonicalAncestor, message);
+    if (!(await stat(canonicalAncestor)).isDirectory())
+        throw new Error(message);
+    const parent = join(canonicalAncestor, ...missing);
+    await mkdir(parent, { recursive: true });
+    const canonicalParent = await realpath(parent);
+    assertInside(canonicalRoot, canonicalParent, message);
+    const target = join(canonicalParent, basename(lexicalTarget));
+    let exists = false;
+    try {
+        const metadata = await lstat(target);
+        if (metadata.isSymbolicLink() || !metadata.isFile())
+            throw new Error(message);
+        exists = true;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    return { root: canonicalRoot, target, relativePath: relative(canonicalRoot, target), exists };
+}
+//# sourceMappingURL=workspace-path.js.map

package/dist/workspace-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-path.js","sourceRoot":"","sources":["../src/workspace-path.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pi-harness/plugin-api",
+  "version": "0.1.27",
+  "description": "Public contract for authoring Pi Harness plugins: Cordis context services, plugin configuration helpers, and bounded workspace file access",
+  "keywords": [
+    "agent",
+    "cordis",
+    "pi-harness",
+    "plugin"
+  ],
+  "homepage": "https://github.com/pi-harness/pi-harness/tree/main/packages/plugin-api#readme",
+  "bugs": {
+    "url": "https://github.com/pi-harness/pi-harness/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pi-harness/pi-harness.git",
+    "directory": "packages/plugin-api"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  }
+}