@timurproko/a1 0.1.8-dev.50ebb19 → 0.1.8-dev.512

package/dist/src/foundation/pi-engine-adapter/conformance.d.ts

@@ -1,37 +0,0 @@
-export interface PiCapabilityConformanceResult {
-    readonly capability: string;
-    readonly operations: readonly string[];
-    readonly passed: boolean;
-}
-export declare const REQUIRED_PI_CAPABILITY_OPERATIONS: Readonly<{
-    readonly "public-exports": readonly ["services.create", "session.create", "runtime.create"];
-    readonly "session-lifecycle": readonly ["session.new", "session.resume", "session.rebind", "session.dispose"];
-    readonly "commands-events": readonly ["prompt", "steer", "followUp", "abort", "compact", "setModel", "setThinkingLevel", "subscribe", "dispose"];
-    readonly "models-authentication": readonly ["models.list", "models.refresh", "auth.status", "auth.login", "auth.logout", "auth.cancel"];
-    readonly settings: readonly ["settings.read", "settings.write", "settings.flush"];
-    readonly "resources-extensions": readonly ["resources.discover", "extensions.bind", "extensions.reload", "renderers.invoke"];
-    readonly workflows: readonly ["workflow.route", "workflow.validate", "workflow.diagnostics"];
-    readonly disposal: readonly ["subscription.dispose", "session.dispose", "services.cleanup"];
-}>;
-export declare class PiCapabilityCompatibilityError extends Error {
-    readonly packageVersion: string;
-    readonly capability: string;
-    readonly operation: string;
-    constructor(packageVersion: string, capability: string, operation: string, detail: string);
-}
-export interface PiUpgradeConformanceReport {
-    readonly schema: "pi-engine-conformance-v1";
-    readonly packageName: "@earendil-works/pi-coding-agent";
-    readonly packageVersion: string;
-    readonly ownedUiContractVersion: number;
-    readonly serviceDiagnostics: number;
-    readonly sessionId: string;
-    readonly commandSurface: readonly string[];
-    readonly capabilities: readonly PiCapabilityConformanceResult[];
-}
-export declare class PiUpgradeConformanceError extends Error {
-    readonly stage: "exports" | "services" | "session";
-    constructor(stage: "exports" | "services" | "session", cause: unknown);
-}
-export declare function runPiUpgradeConformance(): Promise<PiUpgradeConformanceReport>;
-export declare function validatePiCapabilityResults(packageVersion: string, results: readonly PiCapabilityConformanceResult[]): void;

package/dist/src/foundation/pi-engine-adapter/conformance.js

@@ -1,130 +0,0 @@
-import { mkdtemp, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, ModelRuntime, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_CONTRACT_VERSION } from "../owned-ui-contracts/index.js";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
-export const REQUIRED_PI_CAPABILITY_OPERATIONS = Object.freeze({
-    "public-exports": ["services.create", "session.create", "runtime.create"],
-    "session-lifecycle": ["session.new", "session.resume", "session.rebind", "session.dispose"],
-    "commands-events": ["prompt", "steer", "followUp", "abort", "compact", "setModel", "setThinkingLevel", "subscribe", "dispose"],
-    "models-authentication": ["models.list", "models.refresh", "auth.status", "auth.login", "auth.logout", "auth.cancel"],
-    settings: ["settings.read", "settings.write", "settings.flush"],
-    "resources-extensions": ["resources.discover", "extensions.bind", "extensions.reload", "renderers.invoke"],
-    workflows: ["workflow.route", "workflow.validate", "workflow.diagnostics"],
-    disposal: ["subscription.dispose", "session.dispose", "services.cleanup"],
-});
-export class PiCapabilityCompatibilityError extends Error {
-    packageVersion;
-    capability;
-    operation;
-    constructor(packageVersion, capability, operation, detail) {
-        super(`Pi ${packageVersion} capability ${capability} operation ${operation} is incompatible: ${detail}`);
-        this.packageVersion = packageVersion;
-        this.capability = capability;
-        this.operation = operation;
-        this.name = "PiCapabilityCompatibilityError";
-    }
-}
-export class PiUpgradeConformanceError extends Error {
-    stage;
-    constructor(stage, cause) {
-        super(`Pi upgrade conformance failed during ${stage}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
-        this.stage = stage;
-        this.name = "PiUpgradeConformanceError";
-    }
-}
-export async function runPiUpgradeConformance() {
-    try {
-        if (typeof createAgentSessionRuntime !== "function"
-            || typeof createAgentSessionServices !== "function"
-            || typeof createAgentSessionFromServices !== "function"
-            || typeof ModelRuntime.create !== "function"
-            || typeof SessionManager.inMemory !== "function") {
-            throw new Error("required public SDK exports are missing");
-        }
-    }
-    catch (error) {
-        throw new PiUpgradeConformanceError("exports", error);
-    }
-    const root = await mkdtemp(join(tmpdir(), `${PRODUCT_IDENTITY.filesystem.temporaryPrefix}pi-conformance-`));
-    try {
-        let services;
-        try {
-            const modelRuntime = await ModelRuntime.create({
-                authPath: join(root, "agent", "auth.json"),
-                modelsPath: null,
-                refreshOnCreate: false,
-                allowModelNetwork: false,
-            });
-            services = await createAgentSessionServices({
-                cwd: root,
-                agentDir: join(root, "agent"),
-                modelRuntime,
-            });
-        }
-        catch (error) {
-            throw new PiUpgradeConformanceError("services", error);
-        }
-        let sessionId;
-        try {
-            const created = await createAgentSessionFromServices({
-                services,
-                sessionManager: SessionManager.inMemory(root),
-                noTools: "all",
-            });
-            const session = created.session;
-            sessionId = session.sessionId;
-            requireMethods(session, "session commands", ["prompt", "steer", "followUp", "abort", "compact", "setModel", "setThinkingLevel", "subscribe", "dispose"]);
-            requireMethods(services.modelRuntime, "models/authentication", ["getModels", "getModel", "checkAuth", "login", "logout", "refresh"]);
-            requireMethods(services.settingsManager, "settings", ["getGlobalSettings", "getProjectSettings", "flush"]);
-            requireMethods(services.resourceLoader, "resources/extensions", ["getExtensions", "getSkills", "getPrompts", "getThemes", "reload"]);
-            const unsubscribe = session.subscribe(() => undefined);
-            unsubscribe();
-            session.dispose();
-        }
-        catch (error) {
-            throw new PiUpgradeConformanceError("session", error);
-        }
-        const commandSurface = ["prompt", "steer", "followUp", "abort", "compact", "setModel", "setThinkingLevel", "subscribe", "dispose"];
-        const capabilities = Object.entries(REQUIRED_PI_CAPABILITY_OPERATIONS)
-            .map(([capabilityName, operations]) => capability(capabilityName, operations));
-        validatePiCapabilityResults(VERSION, capabilities);
-        return {
-            schema: "pi-engine-conformance-v1",
-            packageName: "@earendil-works/pi-coding-agent",
-            packageVersion: VERSION,
-            ownedUiContractVersion: OWNED_UI_CONTRACT_VERSION,
-            serviceDiagnostics: services.diagnostics.length,
-            sessionId,
-            commandSurface,
-            capabilities,
-        };
-    }
-    finally {
-        await rm(root, { recursive: true, force: true });
-    }
-}
-function requireMethods(target, capabilityName, operations) {
-    const surface = target;
-    for (const operation of operations) {
-        if (typeof surface[operation] !== "function")
-            throw new Error(`${capabilityName}.${operation} is unavailable`);
-    }
-}
-function capability(capabilityName, operations) {
-    return { capability: capabilityName, operations, passed: true };
-}
-export function validatePiCapabilityResults(packageVersion, results) {
-    for (const [capabilityName, requiredOperations] of Object.entries(REQUIRED_PI_CAPABILITY_OPERATIONS)) {
-        const result = results.find(candidate => candidate.capability === capabilityName);
-        if (!result)
-            throw new PiCapabilityCompatibilityError(packageVersion, capabilityName, requiredOperations[0], "capability result is missing");
-        if (!result.passed)
-            throw new PiCapabilityCompatibilityError(packageVersion, capabilityName, requiredOperations[0], "capability reported failure");
-        for (const operation of requiredOperations) {
-            if (!result.operations.includes(operation))
-                throw new PiCapabilityCompatibilityError(packageVersion, capabilityName, operation, "required operation is missing");
-        }
-    }
-}

package/dist/src/foundation/pi-engine-adapter/index.d.ts

@@ -1,10 +0,0 @@
-export * from "./adapter.js";
-export * from "./conformance.js";
-export * from "./runtime-integration.js";
-export * from "./session-integration.js";
-export * from "./model-auth-integration.js";
-export * from "./settings-integration.js";
-export * from "./package-integration.js";
-export * from "./resource-extension-integration.js";
-export * from "./workflow-controllers.js";
-export * from "./workflows.js";

package/dist/src/foundation/pi-engine-adapter/index.js

@@ -1,10 +0,0 @@
-export * from "./adapter.js";
-export * from "./conformance.js";
-export * from "./runtime-integration.js";
-export * from "./session-integration.js";
-export * from "./model-auth-integration.js";
-export * from "./settings-integration.js";
-export * from "./package-integration.js";
-export * from "./resource-extension-integration.js";
-export * from "./workflow-controllers.js";
-export * from "./workflows.js";

package/dist/src/foundation/pi-engine-adapter/model-auth-integration.d.ts

@@ -1,30 +0,0 @@
-import type { ModelRuntime } from "@earendil-works/pi-coding-agent";
-import type { AgentAuthenticationPort, AgentModelDescriptor, AgentModelPort } from "../agent-engine-contracts/index.js";
-export type PiDocumentedModelRuntime = Pick<ModelRuntime, "getAvailableSnapshot" | "getModel" | "getProvider" | "hasConfiguredAuth" | "refresh" | "logout">;
-export interface PiModelAuthenticationOptions {
-    readonly runtime: PiDocumentedModelRuntime;
-    readonly currentModel: () => AgentModelDescriptor | null;
-    readonly selectModel: (model: ReturnType<PiDocumentedModelRuntime["getModel"]> extends infer T ? Exclude<T, undefined> : never) => Promise<void>;
-    readonly login: (providerId: string, signal: AbortSignal) => Promise<void>;
-    readonly timeoutMs?: number;
-    readonly scopedModelIds?: () => readonly string[] | undefined;
-}
-export declare class PiModelAuthenticationIntegration implements AgentModelPort, AgentAuthenticationPort {
-    #private;
-    private readonly options;
-    readonly capabilities: {
-        selection: boolean;
-        refresh: boolean;
-        scopedCatalog: boolean;
-        login: boolean;
-        logout: boolean;
-    };
-    constructor(options: PiModelAuthenticationOptions);
-    listModels(): Promise<readonly AgentModelDescriptor[]>;
-    currentModel(): Promise<AgentModelDescriptor | null>;
-    selectModel(providerId: string, modelId: string): Promise<void>;
-    refreshModels(): Promise<void>;
-    status(providerId: string): Promise<"authenticated" | "unauthenticated" | "unavailable">;
-    login(providerId: string, signal?: AbortSignal): Promise<void>;
-    logout(providerId: string): Promise<void>;
-}

package/dist/src/foundation/pi-engine-adapter/model-auth-integration.js

@@ -1,61 +0,0 @@
-export class PiModelAuthenticationIntegration {
-    options;
-    capabilities = { selection: true, refresh: true, scopedCatalog: true, login: true, logout: true };
-    #timeoutMs;
-    constructor(options) {
-        this.options = options;
-        this.#timeoutMs = options.timeoutMs ?? 30_000;
-    }
-    async listModels() {
-        const scope = this.options.scopedModelIds?.();
-        const selected = scope ? new Set(scope) : null;
-        return this.options.runtime.getAvailableSnapshot()
-            .filter(model => !selected || selected.has(`${model.provider}/${model.id}`))
-            .map(model => ({
-            providerId: model.provider,
-            modelId: model.id,
-            displayName: model.name,
-            contextWindow: model.contextWindow,
-            thinkingLevels: [],
-        }));
-    }
-    async currentModel() { return this.options.currentModel(); }
-    async selectModel(providerId, modelId) {
-        const model = this.options.runtime.getModel(providerId, modelId);
-        if (!model)
-            throw new Error(`model is unavailable: ${providerId}/${modelId}`);
-        await this.options.selectModel(model);
-    }
-    async refreshModels() {
-        await this.options.runtime.refresh();
-    }
-    async status(providerId) {
-        return this.options.runtime.getProvider(providerId) === undefined
-            ? "unavailable"
-            : this.options.runtime.hasConfiguredAuth(providerId) ? "authenticated" : "unauthenticated";
-    }
-    async login(providerId, signal) {
-        await boundedOperation(inner => this.options.login(providerId, inner), this.#timeoutMs, signal);
-    }
-    async logout(providerId) {
-        await boundedOperation(signal => this.options.runtime.logout(providerId, { signal }), this.#timeoutMs);
-    }
-}
-async function boundedOperation(operation, timeoutMs, outer) {
-    const controller = new AbortController();
-    const abort = () => controller.abort(outer?.reason);
-    outer?.addEventListener("abort", abort, { once: true });
-    const timer = setTimeout(() => controller.abort(new Error(`model/authentication operation timed out after ${timeoutMs}ms`)), timeoutMs);
-    try {
-        if (outer?.aborted)
-            abort();
-        await Promise.race([
-            operation(controller.signal),
-            new Promise((_, reject) => controller.signal.addEventListener("abort", () => reject(controller.signal.reason ?? new Error("model/authentication operation cancelled")), { once: true })),
-        ]);
-    }
-    finally {
-        clearTimeout(timer);
-        outer?.removeEventListener("abort", abort);
-    }
-}

package/dist/src/foundation/pi-engine-adapter/package-integration.d.ts

@@ -1,13 +0,0 @@
-import { type AgentPackagesPort, type AgentPackagesPortInput } from "../agent-engine-contracts/index.js";
-/**
- * Pinned Pi's package manager already takes the profile root as an argument, so
- * this binds it to the root A1 chose rather than to whatever the configuration-root
- * environment variable happens to say. Pi's own package command handler is not used:
- * it prints Pi's command names and ends the process, and both of those belong to
- * whichever A1 command is running.
- *
- * The settings manager is created with project trust withheld, which is what keeps
- * every operation to the user scope of the selected profile — a project-local
- * `packages` list is never read, so it can never be written either.
- */
-export declare function createPiPackagesPort(input: AgentPackagesPortInput): AgentPackagesPort;

package/dist/src/foundation/pi-engine-adapter/package-integration.js

@@ -1,112 +0,0 @@
-import { join } from "node:path";
-import { DefaultPackageManager, ModelRuntime, SettingsManager } from "@earendil-works/pi-coding-agent";
-import { agentPackageOutcome, } from "../agent-engine-contracts/index.js";
-const MODEL_REFRESH_TIMEOUT_MS = 15_000;
-/**
- * Pinned Pi's package manager already takes the profile root as an argument, so
- * this binds it to the root A1 chose rather than to whatever the configuration-root
- * environment variable happens to say. Pi's own package command handler is not used:
- * it prints Pi's command names and ends the process, and both of those belong to
- * whichever A1 command is running.
- *
- * The settings manager is created with project trust withheld, which is what keeps
- * every operation to the user scope of the selected profile — a project-local
- * `packages` list is never read, so it can never be written either.
- */
-export function createPiPackagesPort(input) {
-    const { profileRoot, cwd } = input;
-    const settingsManager = SettingsManager.create(cwd, profileRoot, { projectTrusted: false });
-    const packageManager = new DefaultPackageManager({ cwd, agentDir: profileRoot, settingsManager });
-    packageManager.setProgressCallback(event => {
-        if (event.type !== "start" || !event.message)
-            return;
-        input.onProgress?.({ operation: operationFor(event.action), message: event.message });
-    });
-    const configured = () => packageManager.listConfiguredPackages()
-        .filter(entry => entry.scope === "user")
-        .map(entry => Object.freeze({
-        source: entry.source,
-        installedPath: entry.installedPath ?? null,
-        filtered: entry.filtered,
-    }));
-    const isConfigured = (source) => configured().some(entry => entry.source === source || entry.source.startsWith(`${source}@`));
-    return Object.freeze({
-        capabilities: Object.freeze({ install: true, remove: true, update: true, refreshModels: true }),
-        profileRoot,
-        async list() {
-            return await attempt("list", null, async () => agentPackageOutcome("list", "completed", null, null, configured()));
-        },
-        async install(source) {
-            return await attempt("install", source, async () => {
-                await packageManager.installAndPersist(source);
-                return agentPackageOutcome("install", "completed", null, source, configured());
-            });
-        },
-        async remove(source) {
-            return await attempt("remove", source, async () => {
-                const removed = await packageManager.removeAndPersist(source);
-                if (!removed)
-                    return agentPackageOutcome("remove", "not-found", null, source);
-                return agentPackageOutcome("remove", "completed", null, source, configured());
-            });
-        },
-        async update(source) {
-            return await attempt("update", source ?? null, async () => {
-                // Asking first keeps "that package is not installed here" a structural
-                // answer rather than a string a caller would have to recognize.
-                if (source !== undefined && !isConfigured(source))
-                    return agentPackageOutcome("update", "not-found", null, source);
-                await packageManager.update(source);
-                return agentPackageOutcome("update", "completed", null, source ?? null, configured());
-            });
-        },
-        async refreshModels() {
-            return await attempt("refresh-models", null, async () => {
-                await refreshModelCatalogs(profileRoot);
-                return agentPackageOutcome("refresh-models", "completed");
-            });
-        },
-    });
-}
-async function attempt(operation, source, run) {
-    try {
-        return await run();
-    }
-    catch (error) {
-        return agentPackageOutcome(operation, "failed", describe(error), source);
-    }
-}
-async function refreshModelCatalogs(profileRoot) {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), MODEL_REFRESH_TIMEOUT_MS);
-    try {
-        const modelRuntime = await ModelRuntime.create({
-            authPath: join(profileRoot, "auth.json"),
-            modelsPath: join(profileRoot, "models.json"),
-            allowModelNetwork: false,
-            signal: controller.signal,
-        });
-        const result = await modelRuntime.refresh({ allowNetwork: true, force: true, signal: controller.signal });
-        if (result.aborted)
-            throw new Error(`model catalog refresh timed out after ${MODEL_REFRESH_TIMEOUT_MS}ms`);
-        if (result.errors.size > 0) {
-            throw new Error(Array.from(result.errors, ([provider, error]) => `${provider}: ${error.message}`).join("; "));
-        }
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-function operationFor(action) {
-    if (action === "install")
-        return "install";
-    if (action === "remove")
-        return "remove";
-    return "update";
-}
-function describe(error) {
-    const message = (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim();
-    if (message.length === 0)
-        return "unknown package failure";
-    return message.length > 600 ? `${message.slice(0, 597)}...` : message;
-}