@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/harness/piWrapper/instructionPrompts.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverRepoInstructionPrompts = discoverRepoInstructionPrompts;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const CLAUDE_MD_FILENAME = "CLAUDE.md";
+const AGENTS_MD_FILENAME = "AGENTS.md";
+function pathExistsAsFile(filePath) {
+    try {
+        return (0, node_fs_1.statSync)(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function findInstructionTraversalRoot(startDir) {
+    let current = path.resolve(startDir);
+    for (;;) {
+        if ((0, node_fs_1.existsSync)(path.join(current, ".git"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return path.resolve(startDir);
+        }
+        current = parent;
+    }
+}
+function discoverRepoInstructionPrompts(startDir) {
+    const resolvedStart = path.resolve(startDir);
+    const traversalRoot = findInstructionTraversalRoot(resolvedStart);
+    const directories = [];
+    let current = resolvedStart;
+    for (;;) {
+        directories.push(current);
+        if (current === traversalRoot) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    const prompts = [];
+    for (const dir of directories.reverse()) {
+        const claudePath = path.join(dir, CLAUDE_MD_FILENAME);
+        const agentsPath = path.join(dir, AGENTS_MD_FILENAME);
+        const selectedPath = pathExistsAsFile(claudePath)
+            ? claudePath
+            : pathExistsAsFile(agentsPath)
+                ? agentsPath
+                : undefined;
+        if (!selectedPath) {
+            continue;
+        }
+        const relativeLabel = path.relative(traversalRoot, selectedPath) || path.basename(selectedPath);
+        prompts.push([
+            `Repository instructions from ${relativeLabel}:`,
+            (0, node_fs_1.readFileSync)(selectedPath, "utf8"),
+        ].join("\n"));
+    }
+    return prompts;
+}

package/dist/harness/piWrapper/moduleSupport.d.ts

@@ -0,0 +1,77 @@
+import type { AgentCoreSessionEvent } from "../types";
+interface PiModelRegistry {
+    find(provider: string, modelId: string): PiModelEntry | undefined;
+    getAll(): PiModelEntry[];
+    getApiKey?(model: PiModelEntry): Promise<string | null>;
+    hasConfiguredAuth?(model: PiModelEntry): boolean;
+    getApiKeyAndHeaders?(model: PiModelEntry): Promise<{
+        ok: boolean;
+        apiKey?: string;
+        headers?: Record<string, string>;
+        error?: string;
+    }>;
+    getApiKeyForProvider?(provider: string): Promise<string | undefined>;
+}
+export interface PiModelEntry {
+    id: string;
+    provider: string;
+    api: string;
+    baseUrl: string;
+    [key: string]: unknown;
+}
+interface PiAuthStorage {
+    create(path?: string): PiAuthStorage;
+}
+export interface PiCodingAgentModule {
+    createAgentSession: (options?: Record<string, unknown>) => Promise<{
+        session: PiAgentSession;
+        extensionsResult?: unknown;
+        modelFallbackMessage?: string;
+    }>;
+    DefaultResourceLoader: new (options?: Record<string, unknown>) => {
+        reload(): Promise<void>;
+    };
+    AuthStorage: PiAuthStorage & {
+        create(path?: string): PiAuthStorage;
+    };
+    ModelRegistry: new (auth: PiAuthStorage, modelsPath?: string) => PiModelRegistry;
+    SessionManager: {
+        inMemory(): unknown;
+    };
+    SettingsManager: {
+        inMemory(settings?: Record<string, unknown>): unknown;
+    };
+    createBashToolDefinition?: (cwd: string, options?: Record<string, unknown>) => unknown;
+    codingTools?: unknown[];
+    readOnlyTools?: unknown[];
+    createCodingTools?: (cwd: string, options?: Record<string, unknown>) => unknown[];
+    createReadOnlyTools?: (cwd: string, options?: Record<string, unknown>) => unknown[];
+}
+export interface PiAgentSession {
+    prompt(text: string, options?: Record<string, unknown>): Promise<void>;
+    steer(text: string): Promise<void>;
+    followUp(text: string): Promise<void>;
+    subscribe(listener: (event: AgentCoreSessionEvent) => void): () => void;
+    bindExtensions?(bindings: {
+        uiContext?: unknown;
+    }): Promise<void>;
+    executeBash(command: string, onChunk?: (chunk: string) => void, options?: Record<string, unknown>): Promise<{
+        output: string;
+        exitCode: number | undefined;
+        cancelled: boolean;
+        truncated: boolean;
+    }>;
+    abort(): Promise<void>;
+    dispose(): void;
+    getLastAssistantText(): string | undefined;
+    get sessionId(): string;
+    get isStreaming(): boolean;
+    get messages(): unknown[];
+}
+export declare function loadPiModule(): Promise<PiCodingAgentModule>;
+export declare function configureAzureOpenAiEnvDefaults(requestedModel?: string): void;
+export declare function extractAssistantFailure(messages: unknown[] | undefined): string | undefined;
+export declare function resolvePiModel(mod: PiCodingAgentModule, modelStr: string): Promise<PiModelEntry | undefined>;
+export declare function describePiModelResolutionFailure(modelStr: string): string;
+export {};
+//# sourceMappingURL=moduleSupport.d.ts.map

package/dist/harness/piWrapper/moduleSupport.d.ts.map

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

package/dist/harness/piWrapper/moduleSupport.js

@@ -0,0 +1,204 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPiModule = loadPiModule;
+exports.configureAzureOpenAiEnvDefaults = configureAzureOpenAiEnvDefaults;
+exports.extractAssistantFailure = extractAssistantFailure;
+exports.resolvePiModel = resolvePiModel;
+exports.describePiModelResolutionFailure = describePiModelResolutionFailure;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const PI_MODULE_ID = "@mariozechner/pi-coding-agent";
+const dynamicImportPi = (() => {
+    if (process.env.VITEST) {
+        return (specifier) => Promise.resolve(`${specifier}`).then(s => __importStar(require(s)));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    return new Function("id", "return import(id)");
+})();
+async function loadPiModule() {
+    try {
+        const mod = await dynamicImportPi(PI_MODULE_ID);
+        return mod;
+    }
+    catch {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("PiModuleNotFound", "Cannot load @mariozechner/pi-coding-agent — is the package installed?", { category: babysitter_sdk_1.ErrorCategory.Configuration });
+    }
+}
+function normalizeAzureOpenAiBaseUrl(value) {
+    const trimmed = value.trim().replace(/\/+$/, "");
+    if (!trimmed) {
+        return trimmed;
+    }
+    try {
+        const parsed = new URL(trimmed);
+        const normalizedPath = parsed.pathname.replace(/\/+$/, "");
+        const isAzureOpenAiHost = /\.openai\.azure\.com$/i.test(parsed.hostname);
+        if (normalizedPath === "/openai/v1") {
+            return `${parsed.origin}${normalizedPath}`;
+        }
+        if (normalizedPath === "/openai") {
+            return `${parsed.origin}/openai/v1`;
+        }
+        if (isAzureOpenAiHost && (normalizedPath === "" || normalizedPath === "/")) {
+            return `${parsed.origin}/openai/v1`;
+        }
+    }
+    catch {
+        // Fall back to the raw value when the URL cannot be parsed.
+    }
+    return trimmed;
+}
+function configureAzureOpenAiEnvDefaults(requestedModel) {
+    const resourceName = process.env.AZURE_OPENAI_RESOURCE_NAME || process.env.AZURE_OPENAI_PROJECT_NAME;
+    if (!process.env.AZURE_OPENAI_RESOURCE_NAME && process.env.AZURE_OPENAI_PROJECT_NAME) {
+        process.env.AZURE_OPENAI_RESOURCE_NAME = process.env.AZURE_OPENAI_PROJECT_NAME;
+    }
+    if (process.env.AZURE_OPENAI_BASE_URL) {
+        process.env.AZURE_OPENAI_BASE_URL = normalizeAzureOpenAiBaseUrl(process.env.AZURE_OPENAI_BASE_URL);
+    }
+    else if (resourceName) {
+        process.env.AZURE_OPENAI_BASE_URL = normalizeAzureOpenAiBaseUrl(`https://${resourceName}.openai.azure.com`);
+    }
+    if (requestedModel &&
+        !requestedModel.includes(":") &&
+        process.env.AZURE_OPENAI_DEPLOYMENT &&
+        !process.env.AZURE_OPENAI_DEPLOYMENT_NAME_MAP) {
+        process.env.AZURE_OPENAI_DEPLOYMENT_NAME_MAP = `${requestedModel}=${process.env.AZURE_OPENAI_DEPLOYMENT}`;
+    }
+}
+function synthesizeAzureModelEntry(modelId) {
+    if (!process.env.AZURE_OPENAI_API_KEY) {
+        return undefined;
+    }
+    const resourceName = process.env.AZURE_OPENAI_RESOURCE_NAME || process.env.AZURE_OPENAI_PROJECT_NAME;
+    const baseUrl = process.env.AZURE_OPENAI_BASE_URL
+        ? normalizeAzureOpenAiBaseUrl(process.env.AZURE_OPENAI_BASE_URL)
+        : (resourceName ? normalizeAzureOpenAiBaseUrl(`https://${resourceName}.openai.azure.com`) : undefined);
+    if (!baseUrl) {
+        return undefined;
+    }
+    return {
+        id: modelId,
+        name: modelId,
+        provider: "azure-openai-responses",
+        api: "openai-responses",
+        baseUrl,
+        reasoning: true,
+        input: ["text"],
+        contextWindow: 128000,
+        maxTokens: 16384,
+        cost: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+        },
+    };
+}
+function extractAssistantFailure(messages) {
+    if (!Array.isArray(messages) || messages.length === 0) {
+        return undefined;
+    }
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (!message || typeof message !== "object") {
+            continue;
+        }
+        const candidate = message;
+        if (candidate.role !== "assistant") {
+            continue;
+        }
+        if (candidate.stopReason === "error" && typeof candidate.errorMessage === "string" && candidate.errorMessage.trim()) {
+            return candidate.errorMessage.trim();
+        }
+    }
+    return undefined;
+}
+async function modelHasUsableAuth(registry, model) {
+    if (typeof registry.hasConfiguredAuth === "function") {
+        return registry.hasConfiguredAuth(model);
+    }
+    if (typeof registry.getApiKey === "function") {
+        const key = await registry.getApiKey(model);
+        return Boolean(key);
+    }
+    if (typeof registry.getApiKeyAndHeaders === "function") {
+        const result = await registry.getApiKeyAndHeaders(model);
+        return Boolean(result.ok &&
+            ((typeof result.apiKey === "string" && result.apiKey.length > 0) ||
+                (result.headers && Object.keys(result.headers).length > 0)));
+    }
+    if (typeof registry.getApiKeyForProvider === "function") {
+        const key = await registry.getApiKeyForProvider(model.provider);
+        return Boolean(key);
+    }
+    return false;
+}
+async function resolvePiModel(mod, modelStr) {
+    const auth = mod.AuthStorage.create();
+    const registry = new mod.ModelRegistry(auth);
+    let resolved;
+    if (modelStr.includes(":")) {
+        const [provider, modelId] = modelStr.split(":", 2);
+        resolved = registry.find(provider, modelId);
+    }
+    if (!resolved) {
+        for (const model of registry.getAll()) {
+            if (model.id === modelStr || model.id === modelStr.split(":").pop()) {
+                if (await modelHasUsableAuth(registry, model)) {
+                    resolved = model;
+                    break;
+                }
+            }
+        }
+    }
+    return resolved ?? synthesizeAzureModelEntry(modelStr);
+}
+function describePiModelResolutionFailure(modelStr) {
+    const requestedModel = modelStr.trim();
+    const normalized = requestedModel.toLowerCase();
+    if (normalized.includes("gemini") ||
+        normalized.startsWith("google:") ||
+        normalized.startsWith("gemini:")) {
+        return [
+            `Explicit model "${requestedModel}" could not be resolved to a configured internal agent-core model.`,
+            "Configure GOOGLE_API_KEY or GEMINI_API_KEY for Gemini/Google models, or choose a model available in the PI model registry.",
+        ].join(" ");
+    }
+    return [
+        `Explicit model "${requestedModel}" could not be resolved to a configured internal agent-core model.`,
+        "Configure auth for that model, or choose a model available in the PI model registry.",
+    ].join(" ");
+}

package/dist/harness/piWrapper.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Pi programmatic API wrapper.
+ *
+ * Wraps `@mariozechner/pi-coding-agent`'s `createAgentSession()` to expose
+ * a persistent `AgentSession` through a babysitter-friendly interface.
+ *
+ * The session is lazily initialized on first use and reused across prompts.
+ * Events are forwarded through the `subscribe()` method.
+ */
+import type { AgentCoreSessionOptions, AgentCorePromptResult, AgentCoreSessionEvent } from "./types";
+/** Listener for Pi session events. */
+export type AgentCoreEventListener = (event: AgentCoreSessionEvent) => void;
+/**
+ * Handle for interacting with the Pi coding agent programmatically.
+ *
+ * Wraps `AgentSession` from `@mariozechner/pi-coding-agent`. The underlying
+ * session is created lazily on first `prompt()` call and reused thereafter.
+ */
+export declare class AgentCoreSessionHandle {
+    private readonly options;
+    private session;
+    private initPromise;
+    private readonly cleanupTasks;
+    constructor(options?: AgentCoreSessionOptions);
+    /**
+     * Initialize the underlying AgentSession.
+     *
+     * Called automatically by `prompt()` if the session hasn't been created yet.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Send a prompt to the Pi agent and wait for completion.
+     *
+     * Initializes the session if needed, sends the prompt, waits for the
+     * `agent_end` event, and returns collected output.
+     */
+    prompt(text: string, timeout?: number): Promise<AgentCorePromptResult>;
+    /**
+     * Steer the running agent with an instruction.
+     *
+     * Steering messages are delivered immediately to the agent while it is
+     * processing a prompt.
+     */
+    steer(text: string): Promise<void>;
+    /** Queue a follow-up message for after the current turn completes. */
+    followUp(text: string): Promise<void>;
+    /**
+     * Subscribe to session events.
+     *
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener: AgentCoreEventListener): () => void;
+    /** Execute a bash command through the agent's sandbox. */
+    executeBash(command: string, onChunk?: (chunk: string) => void): Promise<{
+        output: string;
+        exitCode: number | undefined;
+        cancelled: boolean;
+    }>;
+    /** Abort the current prompt execution. */
+    abort(): Promise<void>;
+    /** Dispose of the session and release resources. */
+    dispose(): void;
+    /** The underlying pi session ID, if initialized. */
+    get sessionId(): string | undefined;
+    /** Whether the session is currently streaming a response. */
+    get isStreaming(): boolean;
+    /** Whether the session has been initialized. */
+    get isInitialized(): boolean;
+    private cleanupPendingTasks;
+    private doInitialize;
+    private requireSession;
+}
+/**
+ * Create a new Pi session handle.
+ *
+ * The underlying `AgentSession` is created lazily on first use.
+ */
+export declare function createAgentCoreSession(options?: AgentCoreSessionOptions): AgentCoreSessionHandle;
+//# sourceMappingURL=piWrapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"piWrapper.d.ts","sourceRoot":"","sources":["../../src/harness/piWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA4BrG,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAoB5E;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAC1D,OAAO,GAAE,uBAA4B;IAGjD;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgG5E;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,sEAAsE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAIvD,0DAA0D;IACpD,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAUhF,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,oDAAoD;IACpD,OAAO,IAAI,IAAI;IAiBf,oDAAoD;IACpD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IACD,6DAA6D;IAC7D,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,gDAAgD;IAChD,IAAI,aAAa,IAAI,OAAO,CAE3B;YAIa,mBAAmB;YAQnB,YAAY;IAqH1B,OAAO,CAAC,cAAc;CAUvB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CAEhG"}