@vibesdotdev/integrations-pi 0.0.0-stage → 1.0.0-rc.1

package/dist/harness/preflight.js

@@ -0,0 +1,163 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { PiPreflightInputSchema } from "../schemas/installer.js";
+/**
+ * Read-only preflight for a Pi harness install.
+ *
+ * Every check runs before the first byte is written, so a missing Pi, an
+ * missing optional vibes CLI, or a settings file we cannot merge comes back as a list
+ * of remedies instead of a half-written configuration. Warnings never block an
+ * install; they say what could not be proven.
+ */
+import { statChecked } from '@vibesdotdev/filesystem';
+import { findPiCommand, piInstallHost, resolvePiPackage } from "./runtime.js";
+export const PREFLIGHT_CHECK_IDS = [
+    'pi-cli',
+    'vibes-cli',
+    'bun',
+    'package-resolution',
+    'writability',
+    'merge-safety'
+];
+function skipped(id, skip) {
+    return (skip ?? []).includes(id);
+}
+export async function runPiInstallPreflight(rawInput) {
+    const admitted = PiPreflightInputSchema.safeParse(rawInput);
+    if (!admitted.success)
+        throw new CapabilityError('Pi preflight input is invalid.', 'INVALID_INPUT', { reason: 'pi-preflight-input-invalid', cause: admitted.error });
+    const input = admitted.data;
+    const env = input.env;
+    const find = input.probes?.findCommand ?? ((name) => findPiCommand(input.runtime, name, env));
+    const resolvePackage = input.probes?.resolvePackage ?? ((specifier) => resolvePiPackage(input.runtime, specifier, input.paths.root));
+    const checks = [];
+    if (skipped('pi-cli', input.skip)) {
+        checks.push({
+            id: 'pi-cli',
+            status: 'warn',
+            message: 'Pi presence check skipped',
+            remedy: 'Re-run without the skip once Pi is installed.'
+        });
+    }
+    else {
+        const pi = await find('pi', env);
+        checks.push(pi === null
+            ? {
+                id: 'pi-cli',
+                status: 'fail',
+                message: 'The pi command was not found on PATH',
+                remedy: 'Install @earendil-works/pi-coding-agent, or skip this check to write config for another machine.'
+            }
+            : { id: 'pi-cli', status: 'ok', message: 'Pi found at ' + pi });
+    }
+    if (skipped('vibes-cli', input.skip)) {
+        checks.push({
+            id: 'vibes-cli',
+            status: 'warn',
+            message: 'vibes CLI reachability check skipped',
+            remedy: 'Re-run without the skip on the machine that will run Pi.'
+        });
+    }
+    else {
+        const command = env.VIBES_BIN ?? await find('vibes', env);
+        const capability = command === null ? { available: false, reason: 'no vibes binary on PATH and VIBES_BIN unset' } : { available: true, command };
+        checks.push(capability.available
+            ? { id: 'vibes-cli', status: 'ok', message: 'vibes CLI found at ' + capability.command }
+            : {
+                id: 'vibes-cli',
+                status: 'warn',
+                message: 'The optional vibes CLI is not reachable: ' + capability.reason,
+                remedy: 'The extension runs tools and commands in-process. Install vibes or set VIBES_BIN only for standalone CLI use.'
+            });
+    }
+    if (skipped('bun', input.skip)) {
+        checks.push({ id: 'bun', status: 'warn', message: 'bun check skipped' });
+    }
+    else {
+        const bun = await find('bun', env);
+        checks.push(bun === null
+            ? {
+                id: 'bun',
+                status: 'warn',
+                message: 'bun was not found on PATH',
+                remedy: 'Pi bundles its own runtime, so this may be fine; install bun to run the harness checks locally.'
+            }
+            : { id: 'bun', status: 'ok', message: 'bun found at ' + bun });
+    }
+    if (skipped('package-resolution', input.skip)) {
+        checks.push({
+            id: 'package-resolution',
+            status: 'warn',
+            message: 'package resolution check skipped',
+            remedy: 'Pi must be able to resolve ' + input.packageName + ' where it runs.'
+        });
+    }
+    else {
+        checks.push(await resolvePackage(input.packageName)
+            ? {
+                id: 'package-resolution',
+                status: 'ok',
+                message: input.packageName + ' resolves from this checkout'
+            }
+            : {
+                id: 'package-resolution',
+                status: 'warn',
+                message: input.packageName + ' does not resolve from this process',
+                remedy: 'Install @vibesdotdev/integrations-pi where Pi runs. Written config is not proof: only loading Pi verifies it.'
+            });
+    }
+    const writability = skipped('writability', input.skip) ? null : await checkWritability(input.paths, input.runtime);
+    checks.push(skipped('writability', input.skip) ? { id: 'writability', status: 'warn', message: 'Writability check skipped' } : writability === null
+        ? { id: 'writability', status: 'ok', message: 'All targets are writable' }
+        : { id: 'writability', status: 'fail', message: writability, remedy: 'Fix the permissions on that path and re-run.' });
+    const conflicts = input.conflicts ?? [];
+    checks.push(conflicts.length === 0
+        ? { id: 'merge-safety', status: 'ok', message: 'Existing files can be merged without loss' }
+        : {
+            id: 'merge-safety',
+            status: 'fail',
+            message: conflicts.map((conflict) => conflict.reason).join('; '),
+            remedy: conflicts.map((conflict) => conflict.remedy).join('; ')
+        });
+    return { ok: checks.every((check) => check.status !== 'fail'), checks };
+}
+/**
+ * Returns the first problem, or null when every target is reachable and
+ * writable. Never creates a directory: a preflight that writes has already
+ * failed its own contract.
+ */
+async function checkWritability(paths, runtime) {
+    const host = await piInstallHost(runtime);
+    const targets = [paths.extensionPath, paths.systemPromptPath, paths.settingsPath,
+        ...['vibes-dark.json', 'vibes-light.json', 'vibes-high-contrast.json'].map(name => host.paths.join(paths.themesDir, name))];
+    for (const target of targets) {
+        const entry = await statChecked(host.fs, target);
+        if (entry.found) {
+            if (entry.stat.kind !== 'file')
+                return target + ' exists but is not a regular file';
+            if (!entry.stat.writable)
+                return target + ' is not writable';
+            continue;
+        }
+        const problem = await checkAncestor(host.fs, host.paths.dirname(target));
+        if (problem !== null)
+            return problem;
+    }
+    return null;
+}
+/** Follow the owner's parent operation until an existing directory or the root. No writes. */
+async function checkAncestor(fs, path) {
+    let current = path;
+    for (;;) {
+        const entry = await statChecked(fs, current);
+        if (entry.found) {
+            if (entry.stat.kind !== 'directory')
+                return current + ' is in the way';
+            return entry.stat.writable ? null : current + ' is not writable';
+        }
+        const parent = fs.dirname(current);
+        if (parent === current)
+            return current + ' cannot be created';
+        current = parent;
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/harness/preflight.js.map

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

package/dist/harness/prompt.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pi projection of the harness system prompt.
+ *
+ * The canonical prompt text and the live-surface builder are host-neutral and
+ * live in `@vibesdotdev/external/harness`. Pi's own part is the namespace
+ * label and the note that the underscore projections, not the registry ids,
+ * are the names the model must emit.
+ */
+import { type LivePromptEntry } from '@vibesdotdev/external/harness';
+/** Live Pi briefing over underscore projections, with the session's workspace root. */
+export declare function buildLivePiHarnessPrompt(entries: readonly LivePromptEntry[], workspace?: {
+    root: string;
+}): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/harness/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/harness/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGN,KAAK,eAAe,EACpB,MAAM,+BAA+B,CAAC;AAKvC,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAElH"}

package/dist/harness/prompt.js

@@ -0,0 +1,15 @@
+/**
+ * Pi projection of the harness system prompt.
+ *
+ * The canonical prompt text and the live-surface builder are host-neutral and
+ * live in `@vibesdotdev/external/harness`. Pi's own part is the namespace
+ * label and the note that the underscore projections, not the registry ids,
+ * are the names the model must emit.
+ */
+import { buildHarnessSystemPrompt, livePromptSurface } from '@vibesdotdev/external/harness';
+const PI_PROMPT_NOTE = 'These are the only callable Vibes tool names in this host. The canonical registry\nids (for example workspace-fs) are CLI routing identity; never\nemit one as a tool name.';
+/** Live Pi briefing over underscore projections, with the session's workspace root. */
+export function buildLivePiHarnessPrompt(entries, workspace) {
+    return buildHarnessSystemPrompt(livePromptSurface('vibes_*', entries, PI_PROMPT_NOTE), workspace);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/harness/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/harness/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EAEjB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,cAAc,GACnB,6KAA6K,CAAC;AAE/K,uFAAuF;AACvF,MAAM,UAAU,wBAAwB,CAAC,OAAmC,EAAE,SAA4B;IACzG,OAAO,wBAAwB,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;AACnG,CAAC"}

package/dist/harness/runtime.d.ts

@@ -0,0 +1,137 @@
+import { type FileSystemAdapterInterface } from '@vibesdotdev/filesystem';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export declare function requirePiRuntime(runtime: RuntimeRef | undefined): RuntimeRef;
+export declare function piInstallHost(runtime: RuntimeRef | undefined): Promise<{
+    runtime: RuntimeRef;
+    fs: {
+        descriptor: {
+            id: string;
+            kind: "filesystem/adapter";
+            protocols: ("file" | "directory" | "symlink" | "special")[];
+            capabilities: ("link" | "read" | "write" | "stat" | "list" | "realpath" | "watch" | "move" | "copy" | "trash" | "glob" | "glob-pruning" | "versioned-file" | "file-observation" | "exclusive-create" | "temporary-directory" | "owner-private" | "stream-write" | "chmod" | "append" | "append-stream" | "read-range" | "read-sync" | "mutation-sync" | "touch" | "special-entry-type" | "recursive-watch" | "volume-capacity")[];
+            supportsRecursive: boolean;
+            supportsWatch: boolean;
+            supportsSymlinks: boolean;
+            supportsHardLinks: boolean;
+            supportsPermissions: boolean;
+            supportsOwnership: boolean;
+            supportsExtendedAttributes: boolean;
+            persistent: boolean;
+            supportsTransactions: boolean;
+            supportsAtomic: boolean;
+            cloudNative: boolean;
+            supportsVersioning: boolean;
+            supportsGit: boolean;
+            supportsEncryption: boolean;
+            supportsCompression: boolean;
+            supportsQuota: boolean;
+            supportsACL: boolean;
+            supportsSearch: boolean;
+            name?: string | undefined;
+            description?: string | undefined;
+            tags?: string[] | undefined;
+            hardware?: string[] | undefined;
+            enabled?: boolean | undefined;
+            priority?: number | undefined;
+            capabilityId?: string | undefined;
+            requiredContext?: string[] | undefined;
+            optionalContext?: string[] | undefined;
+            config?: unknown;
+            retention?: string | {
+                reason: string;
+                maxAgeDays?: number | undefined;
+                maxEntries?: number | undefined;
+                maxBytes?: number | undefined;
+                cascadeFrom?: string | undefined;
+                ageField?: string | undefined;
+                enforcedBy?: string | undefined;
+            } | undefined;
+            versionedFile?: {
+                revisionScheme: string;
+                revisionScope: "file-content";
+                conditionalWrite?: {
+                    consistency: "process-cooperative" | "cross-process-cooperative" | "backend-atomic";
+                    writerSet: "adapter-instance-versioned-api" | "process-versioned-api" | "backend-all-writers";
+                    externalWritersFenced: boolean;
+                } | undefined;
+            } | undefined;
+        };
+        exists: (path: string) => Promise<boolean>;
+        stat: (path: string) => Promise<import("@vibesdotdev/filesystem").FileSystemStat>;
+        readFile: (path: string, encoding?: import("@vibesdotdev/filesystem").FileEncoding) => Promise<string | Uint8Array>;
+        writeFile: (path: string, data: string | Uint8Array, options?: import("@vibesdotdev/filesystem").FileEncoding | {
+            encoding?: import("@vibesdotdev/filesystem").FileEncoding;
+            mode?: number;
+        }) => Promise<void>;
+        list: (path: string) => Promise<import("@vibesdotdev/filesystem").FileSystemEntry[]>;
+        mkdir: (path: string, options?: {
+            recursive?: boolean;
+            mode?: number;
+        }) => Promise<void>;
+        remove: (path: string, options?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+        rename: (oldPath: string, newPath: string) => Promise<void>;
+        copy: (source: string, destination: string, options?: {
+            recursive?: boolean;
+        }) => Promise<void>;
+        watch: (path: string, callback: import("@vibesdotdev/filesystem").FileSystemWatchCallback) => Promise<() => void>;
+        glob: (pattern: string, options?: {
+            cwd?: string;
+            absolute?: boolean;
+            ignore?: string[];
+        }) => Promise<string[]>;
+        resolve: (...pathSegments: string[]) => string;
+        dirname: (path: string) => string;
+        basename: (path: string, ext?: string) => string;
+        join: (...pathSegments: string[]) => string;
+        relative: (from: string, to: string) => string;
+        isAbsolute: (path: string) => boolean;
+        normalize: (path: string) => string;
+        extname: (path: string) => string;
+        createSynchronousMutationPort?: (() => import("@vibesdotdev/filesystem").FileSystemSynchronousMutationPort) | undefined;
+        createSynchronousReadPort?: ((rootDir: string) => import("@vibesdotdev/filesystem").FileSystemSynchronousReadPort) | undefined;
+        createTemporaryDirectory?: (() => Promise<import("@vibesdotdev/filesystem").FileSystemTemporaryDirectory>) | undefined;
+        volumeCapacity?: ((path: string) => Promise<import("@vibesdotdev/filesystem").FileSystemVolumeCapacity>) | undefined;
+        chmod?: ((path: string, mode: number) => Promise<void>) | undefined;
+        readFileRange?: ((path: string, options: import("@vibesdotdev/filesystem").FileSystemReadRangeOptions) => Promise<Uint8Array>) | undefined;
+        appendFile?: ((path: string, data: string | Uint8Array, encoding?: import("@vibesdotdev/filesystem").FileEncoding) => Promise<void>) | undefined;
+        openAppendFile?: ((path: string) => Promise<import("@vibesdotdev/filesystem").FileSystemAppendHandle>) | undefined;
+        realpath?: ((path: string) => Promise<string>) | undefined;
+        touch?: ((path: string) => Promise<boolean>) | undefined;
+        writeFileStream?: ((path: string, source: ReadableStream<Uint8Array>, options?: import("@vibesdotdev/filesystem").FileStreamWriteOptions) => Promise<number>) | undefined;
+        writeFileNoFollow?: ((path: string, data: string | Uint8Array, encoding?: import("@vibesdotdev/filesystem").FileEncoding) => Promise<void>) | undefined;
+        readFileNoFollow?: ((path: string) => Promise<import("@vibesdotdev/filesystem").NoFollowFileRead>) | undefined;
+        createFileExclusive?: ((path: string, data: string | Uint8Array, encoding?: import("@vibesdotdev/filesystem").FileEncoding) => Promise<boolean>) | undefined;
+        writeFilePrivate?: ((path: string, data: string | Uint8Array, encoding?: import("@vibesdotdev/filesystem").FileEncoding) => Promise<void>) | undefined;
+        readFilePrivate?: ((path: string, maxBytes: number) => Promise<Uint8Array>) | undefined;
+        removeFilePrivateIfContent?: ((path: string, expected: Uint8Array) => Promise<boolean>) | undefined;
+        createSymlink?: ((target: string, path: string) => Promise<boolean>) | undefined;
+        readFileVersioned?: ((path: string, options: import("@vibesdotdev/filesystem").VersionedReadOptions) => Promise<import("@vibesdotdev/filesystem").VersionedReadResult>) | undefined;
+        observeFile?: ((path: string) => Promise<import("@vibesdotdev/filesystem").FileObservationResult>) | undefined;
+        readFileObserved?: ((path: string, options: import("@vibesdotdev/filesystem").ObservedReadOptions) => Promise<import("@vibesdotdev/filesystem").ObservedReadResult>) | undefined;
+        writeFileConditional?: ((path: string, data: Uint8Array, options: import("@vibesdotdev/filesystem").ConditionalWriteOptions) => Promise<import("@vibesdotdev/filesystem").ConditionalWriteResult>) | undefined;
+        watchRecursive?: ((path: string, callback: import("@vibesdotdev/filesystem").FileSystemWatchCallback) => Promise<() => void>) | undefined;
+        clear?: (() => Promise<void>) | undefined;
+        exportTree?: ((path?: string) => Promise<import("@vibesdotdev/filesystem").FileSystemTreeEntry[]>) | undefined;
+        importTree?: ((entries: import("@vibesdotdev/filesystem").FileSystemTreeEntry[], options?: import("@vibesdotdev/filesystem").FileSystemTreeImportOptions) => Promise<void>) | undefined;
+    };
+    paths: {
+        join: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[], import("zod").ZodString>, import("zod").ZodString>;
+        resolve: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[], import("zod").ZodString>, import("zod").ZodString>;
+        relative: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString, import("zod").ZodString], null>, import("zod").ZodString>;
+        dirname: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString], null>, import("zod").ZodString>;
+        basename: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString, import("zod").ZodOptional<import("zod").ZodString>], null>, import("zod").ZodString>;
+        extname: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString], null>, import("zod").ZodString>;
+        isAbsolute: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString], null>, import("zod").ZodBoolean>;
+        normalize: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString], null>, import("zod").ZodString>;
+        fileURLToPath: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodInstanceOf<URL>]>], null>, import("zod").ZodString>;
+        homedir: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[], null>, import("zod").ZodString>;
+        tmpdir: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[], null>, import("zod").ZodString>;
+        pathToFileURL?: import("zod/v4/core").$InferOuterFunctionType<import("zod").ZodTuple<[import("zod").ZodString], null>, import("zod").ZodInstanceOf<URL>> | undefined;
+    };
+}>;
+export declare function findPiCommand(runtime: RuntimeRef | undefined, command: string, env: Readonly<Record<string, string | undefined>>): Promise<string | null>;
+export declare function resolvePiPackage(runtime: RuntimeRef | undefined, specifier: string, from: string): Promise<boolean>;
+export declare function readPiText(fs: FileSystemAdapterInterface, path: string): Promise<string | undefined>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/harness/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/harness/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC/G,OAAO,EAGP,KAAK,UAAU,EACd,MAAM,qBAAqB,CAAC;AAI7B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAK5E;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;gBAYzC,CAAC;uBACV,CAAC;gBAAkC,CAAC;oBAAwC,CAAC;mBAChF,CAAC;oBAEV,CAAC;wBAA0C,CAAC;2BAC/B,CAAA;2BACgB,CAAC;kBAAsC,CAAC;qBACpD,CAAC;;0BACpB,CAAC;0BAA4C,CAAC;wBAA0C,CAAC;2BAC5F,CAAA;wBAEuC,CAAC;0BAA4C,CAAC;;yBAC5C,CAAC;;;gCAE8B,CAAC;;;;;;;;;yCAYoB,CAAC;oEAAiJ,CAAC;oBAAmE,CAAC;gBAA4D,CAAC;;;qCAA8J,CAAC;qBAAqB,CAAC;gBAAuB,CAAC;;sCAAqE,CAAC;qBAAqB,CAAC;;;2DAA4J,CAAC;qBAAqB,CAAC;;;uCAA4L,CAAC;eAAe,CAAC;oBAA0B,CAAC;kBAAyB,CAAC;;kBAAuD,GAAG;;oCAA0G,CAAC;eAAgC,GAAG;;;;;;;;;;;wEAAo9B,CAAC;;;;qFAAoZ,CAAC;+EAAsK,CAAC;;iFAA8Q,CAAC;8EAA4J,CAAC;;;;;;;;;;2BAAytC,CAAC;gGAAkL,CAAC;;;;;;;;;;;;;;;;GAlChmJ;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,0BAEtI;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzH;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc1G"}

package/dist/harness/runtime.js

@@ -0,0 +1,53 @@
+import { resolveFileSystemAdapter, statChecked } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure, settleNow } from '@vibesdotdev/kernel';
+import { whichCommand } from '@vibesdotdev/kernel/execution';
+import { getRuntimePath } from '@vibesdotdev/paths';
+export function requirePiRuntime(runtime) {
+    if (!runtime)
+        throw new CapabilityError('Pi installation requires the caller runtime.', 'UNAVAILABLE', {
+            reason: 'pi-runtime-required', retryable: false
+        });
+    return runtime;
+}
+export async function piInstallHost(runtime) {
+    const owner = requirePiRuntime(runtime);
+    const [fs, paths] = await Promise.all([resolveFileSystemAdapter(owner, { binding: false }), getRuntimePath(owner)]);
+    return { runtime: owner, fs, paths };
+}
+export async function findPiCommand(runtime, command, env) {
+    return whichCommand(requirePiRuntime(runtime), command, { env: { ...env } });
+}
+export async function resolvePiPackage(runtime, specifier, from) {
+    const loader = await requirePiRuntime(runtime).query('runtime/loader')
+        .withId('runtime/loader.environment').resolve();
+    if (!loader?.resolveSpecifier)
+        throw new CapabilityError('The host loader cannot resolve packages.', 'UNAVAILABLE', {
+            reason: 'pi-package-resolver-unavailable'
+        });
+    const resolved = settleNow(() => loader.resolveSpecifier(specifier, from));
+    if (resolved.ok)
+        return true;
+    const code = valueFreeFailure(CaughtFailureSchema.parse(resolved.cause)).code;
+    if (code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND')
+        return false;
+    throw new CapabilityError('Pi package resolution failed.', 'UNAVAILABLE', { reason: 'pi-package-resolution-failed', cause: resolved.cause });
+}
+export async function readPiText(fs, path) {
+    const entry = await statChecked(fs, path);
+    if (!entry.found)
+        return undefined;
+    if (entry.stat.kind !== 'file')
+        throw new CapabilityError('An install target is not a regular file.', 'CONFLICT', {
+            reason: 'pi-file-not-regular'
+        });
+    try {
+        const content = await fs.readFile(path, 'utf8');
+        return content instanceof Uint8Array ? new TextDecoder().decode(content) : content;
+    }
+    catch (cause) {
+        throw new CapabilityError('A Pi install target could not be read; it was preserved.', 'UNAVAILABLE', {
+            reason: 'pi-file-read-failed', cause
+        });
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/harness/runtime.js.map

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

package/dist/harness/scope.d.ts

@@ -0,0 +1,11 @@
+import type { PiScope, PiScopePaths } from '../schemas/installer.ts';
+import { PiScopeSchema } from '../schemas/installer.ts';
+export type { PiScope, PiScopePaths } from '../schemas/installer.ts';
+import type { RuntimePath } from '@vibesdotdev/paths';
+export declare const PI_SCOPES: readonly ["project", "global"];
+export declare function isPiScope(value: Parameters<typeof PiScopeSchema.safeParse>[0]): value is PiScope;
+export declare function resolvePiScopePaths(scope: PiScope, options: {
+    cwd?: string;
+    home?: string;
+}, paths?: Pick<RuntimePath, 'join'>): PiScopePaths;
+//# sourceMappingURL=scope.d.ts.map

package/dist/harness/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/harness/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAC,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,OAAO,EAAC,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAWpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWtD,eAAO,MAAM,SAAS,gCAAiC,CAAC;AAGxD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,CAEhG;AAuBD,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAC/B,YAAY,CAed"}

package/dist/harness/scope.js

@@ -0,0 +1,47 @@
+import { PiScopeSchema } from "../schemas/installer.js";
+/**
+ * Pi configuration scopes.
+ *
+ * Pi reads project config from `.pi/` and agent-global config from
+ * `~/.pi/agent/`. The layout is identical, so one resolver serves both and no
+ * caller has to know which directory won.
+ */
+import { join as portableJoin } from '@vibesdotdev/filesystem';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { PI_DIR, PI_EXTENSION_FILE, PI_EXTENSION_REF, PI_GLOBAL_RELATIVE_DIR, PI_SETTINGS_FILE, PI_SYSTEM_PROMPT_FILE } from "./constants.js";
+import { PI_THEMES_DIR } from "./themes.js";
+export const PI_SCOPES = ['project', 'global'];
+export function isPiScope(value) {
+    return PiScopeSchema.safeParse(value).success;
+}
+/**
+ * The scope's directory: the project directory for `project`, the host's user
+ * home (`paths/roots` `userHome`) for `global`. The caller supplies the one
+ * the scope needs; nothing is taken from the process.
+ */
+function scopeBase(scope, options) {
+    const base = scope === 'global' ? options.home : options.cwd;
+    if (!base) {
+        throw new CapabilityError(scope === 'global'
+            ? 'A global Pi install needs the user home.'
+            : 'A project Pi install needs the project directory.', 'INVALID_INPUT', { reason: 'pi-scope-root-missing', details: { scope } });
+    }
+    return base;
+}
+export function resolvePiScopePaths(scope, options, paths) {
+    const join = paths ? (...segments) => paths.join(...segments) : portableJoin;
+    const base = scopeBase(scope, options);
+    const root = scope === 'global' ? join(base, ...PI_GLOBAL_RELATIVE_DIR) : join(base, PI_DIR);
+    const extensionsDir = join(root, 'extensions');
+    return {
+        scope,
+        root,
+        extensionsDir,
+        extensionPath: join(extensionsDir, PI_EXTENSION_FILE),
+        systemPromptPath: join(root, PI_SYSTEM_PROMPT_FILE),
+        settingsPath: join(root, PI_SETTINGS_FILE),
+        themesDir: join(root, PI_THEMES_DIR),
+        extensionRef: PI_EXTENSION_REF
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/harness/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/harness/scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAGxD,MAAM,UAAU,SAAS,CAAC,KAAoD;IAC7E,OAAO,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAID;;;;GAIG;AACH,SAAS,SAAS,CAAC,KAAc,EAAE,OAAwC;IAC1E,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACxB,KAAK,KAAK,QAAQ;YACjB,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,mDAAmD,EACtD,eAAe,EACf,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CACvD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,KAAc,EACd,OAAwC,EACxC,KAAiC;IAEjC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACvF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7F,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC/C,OAAO;QACN,KAAK;QACL,IAAI;QACJ,aAAa;QACb,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC;QACrD,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACnD,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QACpC,YAAY,EAAE,gBAAgB;KAC9B,CAAC;AACH,CAAC"}

package/dist/harness/themes.d.ts

@@ -0,0 +1,30 @@
+import type { PiThemeFile, PiVibesThemeName } from '../schemas/installer.ts';
+import { PiThemeNameSchema } from '../schemas/installer.ts';
+export type { PiThemeFile, PiVibesThemeName } from '../schemas/installer.ts';
+/**
+ * Pi theme files projected from the Studio semantic palettes.
+ *
+ * Source of the hex values: `@vibesdotdev/tui` `src/theme.semantic.ts`.
+ * Pi cannot load OpenTUI, so this package stores the host-native JSON copy
+ * rather than importing `@vibesdotdev/tui/theme`.
+ */
+export declare const PI_THEMES_DIR = "themes";
+export declare const PI_THEME_NAMES: readonly ["vibes-dark", "vibes-light", "vibes-high-contrast"];
+/**
+ * Where the build emits the theme JSON that `package.json` `pi.themes` names.
+ *
+ * Pi loads a published package's themes by path, so the themes ship as files
+ * inside the package instead of being copied into the user's project by the
+ * installer. `scripts/emit-pi-themes.ts` writes them from the palettes below;
+ * nothing hand-maintains them.
+ */
+export declare const PI_THEME_DIST_DIR = "dist/themes";
+/** One theme as the `pi.themes` manifest spells it: package-root relative. */
+export declare function piThemePackagePath(filename: string): string;
+export declare const DEFAULT_PI_VIBES_THEME: PiVibesThemeName;
+export declare const PI_THEME_REF = "./themes";
+export declare const PI_THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "scrollbarTrack", "scrollbarThumb", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode"];
+/** Exact bytes the installer writes for each Vibes Pi theme. */
+export declare function renderPiVibesThemes(): readonly PiThemeFile[];
+export declare function isPiVibesThemeName(value: Parameters<typeof PiThemeNameSchema.safeParse>[0]): value is PiVibesThemeName;
+//# sourceMappingURL=themes.d.ts.map

package/dist/harness/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/harness/themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAC,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAC,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC5E;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC,eAAO,MAAM,cAAc,+DAAgE,CAAC;AAE5F;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,eAAO,MAAM,sBAAsB,EAAE,gBAA+B,CAAC;AACrE,eAAO,MAAM,YAAY,aAAa,CAAC;AAqFvC,eAAO,MAAM,mBAAmB,6yBAsDtB,CAAC;AAsFX,gEAAgE;AAChE,wBAAgB,mBAAmB,IAAI,SAAS,WAAW,EAAE,CAM5D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,gBAAgB,CAEtH"}