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

package/dist/external/pi/bootstrap.js

@@ -0,0 +1,238 @@
+import { PiBootstrapOptionsSchema } from "../../schemas/installer.js";
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { runCapture } from '@vibesdotdev/kernel/execution';
+import { findPiCommand, requirePiRuntime } from "../../harness/runtime.js";
+import { PiOperationOptionsSchema } from "../../schemas/installer.js";
+import { piScopeRoots } from "./installer.js";
+import { installPiVibesExtension } from "./installers/extension.js";
+/** The documented Pi CLI package, named by the harness preflight remedy. */
+export const PI_CLI_PACKAGE = '@earendil-works/pi-coding-agent';
+/** Raised for a refused bootstrap: missing prerequisite, failed install, or failed integration. */
+export class PiBootstrapError extends CapabilityError {
+    checks;
+    constructor(message, checks, cause) {
+        super(message, 'UNAVAILABLE', { reason: checks.some(check => check.id === 'integration' && check.status === 'fail') ? 'pi-bootstrap-integration-failed' : 'pi-bootstrap-binary-failed', cause, details: { failedChecks: checks.filter(check => check.status === 'fail').map(check => check.id) } });
+        this.name = 'PiBootstrapError';
+        this.checks = checks;
+    }
+}
+function formatPiBootstrapCommand(command) {
+    return [command.command, ...command.args].join(' ');
+}
+function failureMessage(checks) {
+    return ('Pi bootstrap failed:\n' +
+        checks
+            .map((check) => `  ${check.id}: ${check.status} - ${check.message}` +
+            (check.remedy ? `\n    remedy: ${check.remedy}` : ''))
+            .join('\n'));
+}
+function integrationNotAttempted(reason) {
+    return {
+        id: 'integration',
+        status: 'warn',
+        message: `Vibes Pi harness install not attempted: ${reason}`
+    };
+}
+/**
+ * The documented global install for the Pi CLI. bun is preferred when present;
+ * npm is the fallback. Null when neither package manager is on PATH.
+ */
+async function piCliInstallCommand(env, find) {
+    if (await find('bun', env) !== null)
+        return { command: 'bun', args: ['add', '-g', PI_CLI_PACKAGE] };
+    if (await find('npm', env) !== null)
+        return { command: 'npm', args: ['install', '-g', PI_CLI_PACKAGE] };
+    return null;
+}
+/**
+ * Check the Pi binary, install it when missing, then apply the Vibes harness.
+ * Throws PiBootstrapError (carrying both checks) on the first failed step.
+ */
+export async function runPiBootstrap(rawOptions) {
+    const admitted = PiBootstrapOptionsSchema.safeParse(rawOptions);
+    if (!admitted.success)
+        throw new CapabilityError('Pi bootstrap options are invalid.', 'INVALID_INPUT', { reason: 'pi-bootstrap-options-invalid', cause: admitted.error });
+    const options = admitted.data;
+    const env = options.env;
+    const find = options.probes?.findCommand ?? ((name) => findPiCommand(options.runtime, name, env));
+    const run = options.probes?.runCommand ?? ((command) => runCapture(requirePiRuntime(options.runtime), command.command, command.args, { envMode: 'replace', env }));
+    const apply = options.probes?.applyIntegration ?? installPiVibesExtension;
+    const scope = options.scope ?? 'project';
+    const dryRun = options.dryRun ?? false;
+    const checks = [];
+    const integrationOptions = {
+        scope,
+        cwd: options.cwd,
+        home: options.home,
+        dryRun: false,
+        skipChecks: options.skipChecks ?? [],
+        env,
+        profile: options.profile,
+        runtime: options.runtime
+    };
+    let binaryPath = await find('pi', env);
+    let installCommand = null;
+    if (dryRun) {
+        if (binaryPath !== null) {
+            checks.push({
+                id: 'binary',
+                status: 'ok',
+                message: `Pi found at ${binaryPath}; no install needed`
+            });
+        }
+        else {
+            installCommand = await piCliInstallCommand(env, find);
+            checks.push(installCommand === null
+                ? {
+                    id: 'binary',
+                    status: 'warn',
+                    message: 'The pi command was not found on PATH and neither bun nor npm is available, so a real bootstrap would stop here',
+                    remedy: `Install ${PI_CLI_PACKAGE} with bun or npm, then re-run.`
+                }
+                : {
+                    id: 'binary',
+                    status: 'warn',
+                    message: `The pi command was not found on PATH; would install: ${formatPiBootstrapCommand(installCommand)}`,
+                    remedy: 'A dry run installs nothing.'
+                });
+        }
+        checks.push({
+            id: 'integration',
+            status: 'warn',
+            message: `Dry run: would apply the Vibes Pi harness (${scope} scope) after the binary step`
+        });
+        return {
+            ok: true,
+            dryRun: true,
+            scope,
+            binaryPath,
+            installCommand,
+            checks,
+            integration: null,
+            message: 'Dry run: Pi bootstrap plan - ' +
+                checks
+                    .map((check) => `${check.id}: ${check.message}` +
+                    (check.remedy ? ` (${check.remedy})` : ''))
+                    .join('; ')
+        };
+    }
+    if (binaryPath === null) {
+        installCommand = await piCliInstallCommand(env, find);
+        if (installCommand === null) {
+            checks.push({
+                id: 'binary',
+                status: 'fail',
+                message: 'The pi command was not found on PATH and neither bun nor npm is available to install it',
+                remedy: `Install ${PI_CLI_PACKAGE} with bun or npm, then re-run.`
+            });
+            checks.push(integrationNotAttempted('the pi binary is missing'));
+            throw new PiBootstrapError(failureMessage(checks), checks);
+        }
+        let installResult;
+        try {
+            installResult = await run(installCommand, env);
+        }
+        catch (error) {
+            checks.push({
+                id: 'binary',
+                status: 'fail',
+                message: `${formatPiBootstrapCommand(installCommand)} could not run: ${error instanceof Error ? error.message : String(error)}`,
+                remedy: `Install ${PI_CLI_PACKAGE} manually, then re-run.`
+            });
+            checks.push(integrationNotAttempted('the pi binary install failed to start'));
+            throw new PiBootstrapError(failureMessage(checks), checks, error);
+        }
+        if (installResult.exitCode !== 0) {
+            const detail = installResult.stderr.trim() || installResult.stdout.trim() || 'no output';
+            checks.push({
+                id: 'binary',
+                status: 'fail',
+                message: `${formatPiBootstrapCommand(installCommand)} exited with code ${installResult.exitCode}: ${detail}`,
+                remedy: `Install ${PI_CLI_PACKAGE} manually, then re-run.`
+            });
+            checks.push(integrationNotAttempted('the pi binary install failed'));
+            throw new PiBootstrapError(failureMessage(checks), checks);
+        }
+        binaryPath = await find('pi', env);
+        if (binaryPath === null) {
+            checks.push({
+                id: 'binary',
+                status: 'fail',
+                message: `${formatPiBootstrapCommand(installCommand)} exited 0, but the pi command is still not on PATH`,
+                remedy: 'Add the package manager global bin directory to PATH, then re-run.'
+            });
+            checks.push(integrationNotAttempted('the pi binary is not on PATH'));
+            throw new PiBootstrapError(failureMessage(checks), checks);
+        }
+        checks.push({
+            id: 'binary',
+            status: 'ok',
+            message: `Installed Pi with ${formatPiBootstrapCommand(installCommand)}; pi found at ${binaryPath}`
+        });
+    }
+    else {
+        checks.push({
+            id: 'binary',
+            status: 'ok',
+            message: `Pi found at ${binaryPath}; no install needed`
+        });
+    }
+    try {
+        const integration = await apply(integrationOptions);
+        checks.push({ id: 'integration', status: 'ok', message: integration.message });
+        return {
+            ok: true,
+            dryRun: false,
+            scope,
+            binaryPath,
+            installCommand,
+            checks,
+            integration,
+            message: 'Pi bootstrap complete.'
+        };
+    }
+    catch (error) {
+        checks.push({
+            id: 'integration',
+            status: 'fail',
+            message: `Vibes Pi harness install failed: ${error instanceof Error ? error.message : String(error)}`,
+            remedy: 'Resolve the named conflict or preflight failure, then re-run.'
+        });
+        throw new PiBootstrapError(failureMessage(checks), checks, error);
+    }
+}
+/** Operation factory; probes are injected by tests, never by the CLI. */
+export function createPiBootstrapOperation(probes = {}) {
+    return {
+        async execute(input, context, services) {
+            const parsed = PiOperationOptionsSchema.safeParse(input.options);
+            if (!parsed.success)
+                throw new CapabilityError('Pi bootstrap options are invalid.', 'INVALID_INPUT', {
+                    reason: 'pi-operation-options-invalid', cause: parsed.error
+                });
+            const { profile, skipCheck } = parsed.data;
+            const result = await runPiBootstrap({
+                scope: context.global ? 'global' : 'project',
+                ...piScopeRoots(context, services),
+                env: services.runtime.getEnvSnapshot(),
+                profile,
+                runtime: services.runtime,
+                dryRun: context.dryRun,
+                skipChecks: skipCheck,
+                probes
+            });
+            return {
+                status: 'ok',
+                message: result.message,
+                changed: !result.dryRun &&
+                    (result.installCommand !== null ||
+                        (result.integration?.changes.length ?? 0) > 0),
+                changes: result.integration?.changes,
+                checks: result.checks,
+                data: result
+            };
+        }
+    };
+}
+export const piBootstrapOperation = createPiBootstrapOperation();
+//# sourceMappingURL=bootstrap.js.map

package/dist/external/pi/bootstrap.js.map

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

package/dist/external/pi/guide.d.ts

@@ -0,0 +1,3 @@
+import type { ExternalOperation } from '@vibesdotdev/external';
+export declare const piGuideOperation: ExternalOperation;
+//# sourceMappingURL=guide.d.ts.map

package/dist/external/pi/guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../../src/external/pi/guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAkB/D,eAAO,MAAM,gBAAgB,EAAE,iBAe9B,CAAC"}

package/dist/external/pi/guide.js

@@ -0,0 +1,33 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { replaceManagedBlock } from '@vibesdotdev/external/harness';
+import { piInstallHost, readPiText } from "../../harness/runtime.js";
+import { applyPiChanges } from "./installers/transaction.js";
+const GUIDE = `# Vibes + Pi (mcporter)
+
+Pi does not embed MCP directly. Use [mcporter](https://github.com/modelcontextprotocol/mcporter) to bridge the vibes MCP server:
+
+1. Configure mcporter with your vibes MCP server (see \`vibes dev mcp serve --client pi\`)
+2. Configure mcporter to forward stdio MCP to the \`vibes\` server entry
+3. Run \`vibes dev mcp serve --client pi\` in a terminal or via mcporter spawn
+
+See {{docsOrigin}}/external for agent-pack details.
+`;
+export const piGuideOperation = {
+    async execute(_input, context, services) {
+        const service = await services.runtime.query('infra/service').withId('docs').resolve();
+        if (!service)
+            throw new CapabilityError('Compose the documentation service before applying the Pi guide.', 'UNAVAILABLE', {
+                reason: 'pi-docs-service-unavailable'
+            });
+        const { origin } = await service.target('primary');
+        const host = await piInstallHost(services.runtime);
+        const path = host.paths.join(context.projectDir, 'AGENTS.md');
+        const previous = await readPiText(host.fs, path) ?? '';
+        const content = replaceManagedBlock(previous, 'pi-mcporter-guide', GUIDE.replaceAll('{{docsOrigin}}', origin));
+        const changed = content !== previous;
+        if (!context.dryRun && changed)
+            await applyPiChanges(host.fs, [{ path, content }]);
+        return { status: 'ok', changed: !context.dryRun && changed, message: context.dryRun ? 'Dry run: would write the Pi mcporter guide.' : 'Wrote the Pi mcporter guide.' };
+    }
+};
+//# sourceMappingURL=guide.js.map

package/dist/external/pi/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../../src/external/pi/guide.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,KAAK,GAAG;;;;;;;;;CASb,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IAClD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ;QACtC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAiC,eAAe,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACvH,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,iEAAiE,EAAE,aAAa,EAAE;gBACzH,MAAM,EAAE,6BAA6B;aACrC,CAAC,CAAC;QACH,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/G,MAAM,OAAO,GAAG,OAAO,KAAK,QAAQ,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO;YAAE,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAC,IAAI,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC;QACjF,OAAO,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,8BAA8B,EAAC,CAAC;IACtK,CAAC;CACD,CAAC"}

package/dist/external/pi/index.d.ts

@@ -0,0 +1,162 @@
+import { piManifest } from './manifest.ts';
+export { piManifest };
+declare const _default: {
+    id: string;
+    kind: "external/host";
+    manifest: {
+        schemaVersion: "1.0";
+        id: string;
+        name: string;
+        description: string;
+        category: "cli" | "ide-extension" | "ide-native";
+        website: string;
+        platforms: ("win32" | "darwin" | "linux" | "all")[];
+        configs: {
+            path: string;
+            format: "json" | "yaml" | "toml" | "jsonc";
+            scope: "global" | "project";
+            platform?: "win32" | "darwin" | "linux" | "all" | undefined;
+            mcpPath?: string | undefined;
+        }[];
+        mcp: {
+            supported: boolean;
+            transports: ("http" | "stdio" | "sse")[];
+            defaultServerName: string;
+            projectConfig: boolean;
+            envVarsInConfig: boolean;
+            options?: {
+                startupTimeout?: number | undefined;
+                toolTimeout?: number | undefined;
+                autoRestart?: boolean | undefined;
+            } | undefined;
+        };
+        hooks: {
+            supported: boolean;
+            events: ("session.start" | "session.end" | "prompt.submit" | "tool.before" | "tool.after" | "context.beforeCompact" | "context.afterCompact" | "permission.request" | "agent.stop" | "subagent.stop" | "notification")[];
+            nativeEventMap: Record<string, "session.start" | "session.end" | "prompt.submit" | "tool.before" | "tool.after" | "context.beforeCompact" | "context.afterCompact" | "permission.request" | "agent.stop" | "subagent.stop" | "notification">;
+            structuredInput: boolean;
+            canModify: boolean;
+            format?: "json" | "typescript" | "shell" | "python" | undefined;
+            trust?: {
+                step: string;
+            } | undefined;
+        };
+        plugins: {
+            supported: boolean;
+            format?: "typescript" | "python" | "javascript" | "lua" | undefined;
+            entryPoint?: string | undefined;
+            manifestFile?: string | undefined;
+        };
+        skills: {
+            supported: boolean;
+            format: "agents-md";
+            projectScoped: boolean;
+            globalPath?: string | undefined;
+            projectPath?: string | undefined;
+        };
+        detection: {
+            command?: string | undefined;
+            altCommands?: string[] | undefined;
+            configDir?: string | undefined;
+            binaryPath?: string | undefined;
+            versionArgs?: string[] | undefined;
+            versionRegex?: string | undefined;
+            platformPaths?: {
+                darwin?: {
+                    binaryPath?: string | undefined;
+                    configDir?: string | undefined;
+                } | undefined;
+                linux?: {
+                    binaryPath?: string | undefined;
+                    configDir?: string | undefined;
+                } | undefined;
+                win32?: {
+                    binaryPath?: string | undefined;
+                    configDir?: string | undefined;
+                } | undefined;
+            } | undefined;
+            extensionMatch?: {
+                dir: string;
+                prefixes: string[];
+            } | undefined;
+        };
+        integration: {
+            mcp?: {
+                installer?: string | undefined;
+                configTemplate?: Record<string, import("@vibesdotdev/kernel/bootstrap").JsonValue> | undefined;
+            } | undefined;
+            hooks?: {
+                defaultPromptPolicy: "default" | "none" | "custom-only";
+                installer?: string | undefined;
+                templates?: Partial<Record<"session.start" | "session.end" | "prompt.submit" | "tool.before" | "tool.after" | "context.beforeCompact" | "context.afterCompact" | "permission.request" | "agent.stop" | "subagent.stop" | "notification", string>> | undefined;
+                handlerOptions?: Partial<Record<"session.start" | "session.end" | "prompt.submit" | "tool.before" | "tool.after" | "context.beforeCompact" | "context.afterCompact" | "permission.request" | "agent.stop" | "subagent.stop" | "notification", Record<string, import("@vibesdotdev/kernel/bootstrap").JsonValue>>> | undefined;
+                hookAdapterId?: string | undefined;
+                workspaceRootEnv?: string | undefined;
+            } | undefined;
+            plugins?: {
+                installer?: string | undefined;
+                template?: string | undefined;
+            } | undefined;
+            presets?: {
+                available: string[];
+                default?: string | undefined;
+            } | undefined;
+        };
+        version: string;
+        hostAliases?: string[] | undefined;
+        shortName?: string | undefined;
+        assets?: {
+            hooks?: string | undefined;
+            plugins?: string | undefined;
+            commands?: string | undefined;
+            agents?: string | undefined;
+            templates?: string | undefined;
+            skills?: string | undefined;
+            settings?: string | undefined;
+            globalSettings?: string | undefined;
+        } | undefined;
+        launch?: {
+            defaultMode: string;
+            modes: Record<string, string[] | {
+                argv: (string | {
+                    when: string;
+                    args: string[];
+                })[];
+                stdin: "null" | "inherit";
+                command?: string | undefined;
+                structuredOutput?: {
+                    field: string;
+                    schemaTarget?: "draft-2020-12" | "draft-7" | undefined;
+                    wrap?: string | undefined;
+                } | undefined;
+            }>;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    };
+    adapters: {
+        adapter: string;
+        supported: boolean;
+        config: Record<string, unknown>;
+    }[];
+    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;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/external/pi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/external/pi/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACtB,wBAEG"}

package/dist/external/pi/index.js

@@ -0,0 +1,7 @@
+import { externalHostDescriptorFromManifest } from '@vibesdotdev/external';
+import { piManifest } from "./manifest.js";
+export { piManifest };
+export default externalHostDescriptorFromManifest(piManifest, {
+    tags: ['external', 'host', 'dev', 'acp', 'agent-pack']
+});
+//# sourceMappingURL=index.js.map

package/dist/external/pi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/external/pi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,kCAAkC,CAAC,UAAU,EAAE;IAC7D,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;CACtD,CAAC,CAAC"}

package/dist/external/pi/installer.d.ts

@@ -0,0 +1,19 @@
+import type { ExecutionContext, ExternalOperation, ExternalRuntimeServices } from '@vibesdotdev/external';
+import { type PreflightCheckId } from '../../harness/preflight.ts';
+/** Parse `--skip-check` values, refusing unknown check ids. */
+export declare function parsePiSkipChecks(value: unknown): PreflightCheckId[];
+/**
+ * The scope's root: the operation's project directory, or for a global install
+ * the runtime's user home (`paths/roots`).
+ */
+export declare function piScopeRoots(context: ExecutionContext, services: ExternalRuntimeServices): {
+    cwd: string;
+} | {
+    home: string;
+};
+export declare const piInstallOperation: ExternalOperation;
+export declare const piRepairOperation: ExternalOperation;
+export declare const piUpgradeOperation: ExternalOperation;
+export declare const piStatusOperation: ExternalOperation;
+export declare const piUninstallOperation: ExternalOperation;
+//# sourceMappingURL=installer.d.ts.map

package/dist/external/pi/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/external/pi/installer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACZ,gBAAgB,EAChB,iBAAiB,EAGjB,uBAAuB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAanE,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAMpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,uBAAuB,GAC/B;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAIpC;AAmCD,eAAO,MAAM,kBAAkB,EAAE,iBAIhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAI/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,iBAIhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAW/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC"}