@agents-ensemble/core 0.6.5 → 0.8.0

package/dist/conductor/pi-conductor-session.js

@@ -0,0 +1,60 @@
+import { JsonlSessionRepo, NodeExecutionEnv } from '@earendil-works/pi-agent-core/node';
+/** Project-local Pi transcript storage used by the conductor backend. */
+export const PI_SESSION_ROOT = '.ensemble/pi/sessions';
+/**
+ * The Pi Agent Core `Agent` keeps its transcript in memory. This small adapter
+ * persists the same messages through Pi's JSONL session API so a new process
+ * can rebuild `Agent.state.messages` for `--resume`.
+ */
+export class PiConductorSession {
+    session;
+    persistedMessages;
+    writeQueue = Promise.resolve();
+    constructor(session, messages) {
+        this.session = session;
+        this.persistedMessages = [...messages];
+    }
+    static async create(cwd, sessionId) {
+        const repo = createSessionRepo(cwd);
+        const session = await repo.create({ cwd, id: sessionId });
+        return new PiConductorSession(session, []);
+    }
+    static async resume(cwd, sessionId) {
+        const repo = createSessionRepo(cwd);
+        const metadata = (await repo.list({ cwd })).find((candidate) => candidate.id === sessionId);
+        if (!metadata) {
+            throw new Error(`Pi session not found for resume (sessionId=${sessionId}, cwd=${cwd}, ` +
+                `sessionsRoot=${PI_SESSION_ROOT})`);
+        }
+        const session = await repo.open(metadata);
+        const context = await session.buildContext();
+        return new PiConductorSession(session, context.messages);
+    }
+    get messages() {
+        return this.persistedMessages;
+    }
+    /** Append only the suffix not already written to the JSONL transcript. */
+    async appendNewMessages(messages) {
+        const write = this.writeQueue.then(async () => {
+            const newMessages = messages.slice(this.persistedMessages.length);
+            for (const message of newMessages) {
+                await this.session.appendMessage(message);
+            }
+            if (newMessages.length > 0) {
+                this.persistedMessages = [
+                    ...this.persistedMessages,
+                    ...newMessages,
+                ];
+            }
+        });
+        this.writeQueue = write.catch(() => { });
+        await write;
+    }
+}
+function createSessionRepo(cwd) {
+    return new JsonlSessionRepo({
+        fs: new NodeExecutionEnv({ cwd }),
+        sessionsRoot: PI_SESSION_ROOT,
+    });
+}
+//# sourceMappingURL=pi-conductor-session.js.map

package/dist/conductor/pi-conductor-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-conductor-session.js","sourceRoot":"","sources":["../../src/conductor/pi-conductor-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGxF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAKV;IAJX,iBAAiB,CAAiB;IAClC,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YACmB,OAAgB,EACjC,QAAwB;QADP,YAAO,GAAP,OAAO,CAAS;QAGjC,IAAI,CAAC,iBAAiB,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,SAAiB;QAChD,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,SAAiB;QAChD,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAC9C,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAC1C,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,8CAA8C,SAAS,SAAS,GAAG,IAAI;gBACrE,gBAAgB,eAAe,GAAG,CACrC,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,iBAAiB,CAAC,QAAiC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAClE,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,iBAAiB,GAAG;oBACvB,GAAG,IAAI,CAAC,iBAAiB;oBACzB,GAAG,WAAW;iBACf,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC;IACd,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,IAAI,gBAAgB,CAAC;QAC1B,EAAE,EAAE,IAAI,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;QACjC,YAAY,EAAE,eAAe;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/dist/conductor/pi-mcp-bridge.d.ts

@@ -0,0 +1,65 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { McpServerConfigMap } from '../mcp/load-mcp-config.js';
+/** The bridge dependency is intentionally exact-pinned in packages/core. */
+export declare const PI_MCP_SDK_VERSION = "1.30.0";
+interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+interface McpClient {
+    connect(transport: unknown): Promise<void>;
+    listTools(): Promise<{
+        tools: McpToolDefinition[];
+    }>;
+    callTool(params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, resultSchema?: unknown, options?: {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    close(): Promise<void>;
+}
+export interface PiMcpBridgeSdk {
+    Client: new (info: {
+        name: string;
+        version: string;
+    }) => McpClient;
+    StdioClientTransport: new (options: {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+    }) => unknown;
+    StreamableHTTPClientTransport: new (url: URL, options?: {
+        requestInit?: RequestInit;
+    }) => unknown;
+    SSEClientTransport: new (url: URL, options?: {
+        requestInit?: RequestInit;
+    }) => unknown;
+}
+/** Injectable only for unit tests; production uses the pinned SDK loader. */
+export interface PiMcpBridgeDependencies {
+    sdk?: PiMcpBridgeSdk;
+    loadSdk?: () => Promise<PiMcpBridgeSdk>;
+}
+export interface PiMcpBridgeOptions {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface PiMcpBridge {
+    readonly tools: AgentTool[];
+    close(): Promise<void>;
+}
+/**
+ * Load the harness-owned in-process Pi MCP bridge for one resolved mcp.json
+ * snapshot. This is not a Pi ExtensionAPI extension.
+ *
+ * The bridge is deliberately in-memory: it does not write `.pi/mcp.json` or
+ * mutate Pi settings. The Pi resource loader resolves user/project Pi
+ * resources separately; this bridge remains the harness-owned connection for
+ * the already-resolved ensemble MCP map.
+ */
+export declare function createPiMcpBridge(mcpServers: McpServerConfigMap | undefined, options: PiMcpBridgeOptions, dependencies?: PiMcpBridgeDependencies): Promise<PiMcpBridge | undefined>;
+export {};
+//# sourceMappingURL=pi-mcp-bridge.d.ts.map

package/dist/conductor/pi-mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-mcp-bridge.d.ts","sourceRoot":"","sources":["../../src/conductor/pi-mcp-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA8CD,UAAU,SAAS;IACjB,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;IACrD,QAAQ,CACN,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAC7D,YAAY,CAAC,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;IACnE,oBAAoB,EAAE,KAAK,OAAO,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,KAAK,OAAO,CAAC;IACd,6BAA6B,EAAE,KAC7B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,KACpC,OAAO,CAAC;IACb,kBAAkB,EAAE,KAClB,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,KACpC,OAAO,CAAC;CACd;AAED,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAOD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,kBAAkB,EAC3B,YAAY,GAAE,uBAA4B,GACzC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAoClC"}

package/dist/conductor/pi-mcp-bridge.js

@@ -0,0 +1,259 @@
+/** The bridge dependency is intentionally exact-pinned in packages/core. */
+export const PI_MCP_SDK_VERSION = '1.30.0';
+/**
+ * Load the harness-owned in-process Pi MCP bridge for one resolved mcp.json
+ * snapshot. This is not a Pi ExtensionAPI extension.
+ *
+ * The bridge is deliberately in-memory: it does not write `.pi/mcp.json` or
+ * mutate Pi settings. The Pi resource loader resolves user/project Pi
+ * resources separately; this bridge remains the harness-owned connection for
+ * the already-resolved ensemble MCP map.
+ */
+export async function createPiMcpBridge(mcpServers, options, dependencies = {}) {
+    if (!mcpServers || Object.keys(mcpServers).length === 0) {
+        return undefined;
+    }
+    const sdk = dependencies.sdk ?? (await loadMcpSdk(dependencies.loadSdk));
+    const connectedServers = [];
+    const tools = [];
+    const usedToolNames = new Set();
+    try {
+        for (const [serverName, config] of Object.entries(mcpServers)) {
+            const client = new sdk.Client({
+                name: 'agents-ensemble-pi-conductor',
+                version: PI_MCP_SDK_VERSION,
+            });
+            connectedServers.push({ name: serverName, client });
+            const transport = createTransport(sdk, serverName, config, options);
+            await client.connect(transport);
+            const listed = await client.listTools();
+            for (const tool of listed.tools) {
+                const exposedName = uniqueToolName(serverName, tool.name, usedToolNames);
+                tools.push(createPiMcpTool(client, serverName, tool, exposedName));
+            }
+        }
+    }
+    catch (error) {
+        await closeClients(connectedServers);
+        throw new Error(`Pi MCP bridge failed while loading server configuration: ${errorMessage(error)}`, { cause: error });
+    }
+    return new LoadedPiMcpBridge(tools, connectedServers);
+}
+class LoadedPiMcpBridge {
+    tools;
+    connectedServers;
+    closed = false;
+    constructor(tools, connectedServers) {
+        this.tools = tools;
+        this.connectedServers = connectedServers;
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await closeClients(this.connectedServers);
+    }
+}
+async function loadMcpSdk(loader = importMcpSdk) {
+    try {
+        return await loader();
+    }
+    catch (error) {
+        throw new Error(`Pi MCP bridge is unavailable. Install @modelcontextprotocol/sdk@${PI_MCP_SDK_VERSION} and reinstall @agents-ensemble/core.`, { cause: error });
+    }
+}
+async function importMcpSdk() {
+    const [client, stdio, streamableHttp, sse] = await Promise.all([
+        import('@modelcontextprotocol/sdk/client/index.js'),
+        import('@modelcontextprotocol/sdk/client/stdio.js'),
+        import('@modelcontextprotocol/sdk/client/streamableHttp.js'),
+        import('@modelcontextprotocol/sdk/client/sse.js'),
+    ]);
+    return {
+        Client: client.Client,
+        StdioClientTransport: stdio.StdioClientTransport,
+        StreamableHTTPClientTransport: streamableHttp.StreamableHTTPClientTransport,
+        SSEClientTransport: sse.SSEClientTransport,
+    };
+}
+function createTransport(sdk, serverName, config, options) {
+    if (config.auth) {
+        throw new Error(`MCP server "${serverName}" uses OAuth auth, which the Pi bridge does not support yet. Remove auth from the definition or use the Cursor backend.`);
+    }
+    const env = options.env ?? process.env;
+    const type = config.type ?? (config.command ? 'stdio' : 'http');
+    if (type === 'stdio') {
+        if (!config.command) {
+            throw new Error(`MCP server "${serverName}" is missing command.`);
+        }
+        return new sdk.StdioClientTransport({
+            command: expand(config.command, options.cwd, env),
+            ...(config.args
+                ? { args: config.args.map((value) => expand(value, options.cwd, env)) }
+                : {}),
+            env: mergeProcessEnvironment(config.env, options.cwd, env),
+            cwd: config.cwd
+                ? expand(config.cwd, options.cwd, env)
+                : options.cwd,
+        });
+    }
+    if (!config.url) {
+        throw new Error(`MCP server "${serverName}" is missing url.`);
+    }
+    const requestInit = config.headers
+        ? { headers: expandRecord(config.headers, options.cwd, env) }
+        : undefined;
+    const url = new URL(expand(config.url, options.cwd, env));
+    if (type === 'sse') {
+        return new sdk.SSEClientTransport(url, requestInit ? { requestInit } : undefined);
+    }
+    if (type === 'http') {
+        return new sdk.StreamableHTTPClientTransport(url, requestInit ? { requestInit } : undefined);
+    }
+    throw new Error(`MCP server "${serverName}" uses unsupported transport type "${type}".`);
+}
+function createPiMcpTool(client, serverName, tool, exposedName) {
+    return {
+        name: exposedName,
+        label: exposedName,
+        description: tool.description
+            ? `[MCP ${serverName}] ${tool.description}`
+            : `MCP tool ${serverName}/${tool.name}`,
+        // MCP input schemas are JSON Schema objects and are structurally
+        // compatible with the TypeBox schema consumed by pi-agent-core.
+        parameters: tool.inputSchema,
+        execute: async (_toolCallId, params, signal) => {
+            const result = toMcpToolResult(await client.callTool({
+                name: tool.name,
+                arguments: isRecord(params) ? params : {},
+            }, undefined, signal ? { signal } : undefined));
+            if (result.isError) {
+                throw new Error(`MCP tool ${serverName}/${tool.name} returned an error: ${mcpErrorDetail(result)}`);
+            }
+            return {
+                content: toPiContent(result),
+                details: {
+                    mcpServer: serverName,
+                    mcpTool: tool.name,
+                    ...(result.structuredContent
+                        ? { structuredContent: result.structuredContent }
+                        : {}),
+                },
+            };
+        },
+    };
+}
+function toPiContent(result) {
+    const content = [];
+    for (const item of result.content ?? []) {
+        if (item.type === 'text') {
+            content.push({ type: 'text', text: item.text });
+        }
+        else if (item.type === 'image') {
+            content.push({ type: 'image', data: item.data, mimeType: item.mimeType });
+        }
+        else if (item.type === 'resource') {
+            content.push({ type: 'text', text: resourceText(item) });
+        }
+        else if (item.type === 'resource_link') {
+            content.push({
+                type: 'text',
+                text: `${item.name}: ${item.uri}${item.description ? ` (${item.description})` : ''}`,
+            });
+        }
+        else if (item.type === 'audio') {
+            content.push({
+                type: 'text',
+                text: `[MCP audio ${item.mimeType}] ${item.data}`,
+            });
+        }
+    }
+    if (content.length === 0 && result.structuredContent) {
+        content.push({
+            type: 'text',
+            text: JSON.stringify(result.structuredContent),
+        });
+    }
+    if (content.length === 0) {
+        content.push({ type: 'text', text: '(MCP tool returned no content.)' });
+    }
+    return content;
+}
+function resourceText(item) {
+    if ('text' in item.resource) {
+        return item.resource.text;
+    }
+    return `[MCP resource ${item.resource.uri}] ${item.resource.blob}`;
+}
+function uniqueToolName(serverName, toolName, usedNames) {
+    const base = `mcp_${sanitizeToolNamePart(serverName)}_${sanitizeToolNamePart(toolName)}`;
+    let candidate = base;
+    let suffix = 2;
+    while (usedNames.has(candidate)) {
+        candidate = `${base}_${suffix}`;
+        suffix += 1;
+    }
+    usedNames.add(candidate);
+    return candidate;
+}
+function sanitizeToolNamePart(value) {
+    const sanitized = value.replace(/[^a-zA-Z0-9_]/g, '_');
+    if (!sanitized)
+        return 'tool';
+    return /^[a-zA-Z_]/.test(sanitized) ? sanitized : `_${sanitized}`;
+}
+function mergeProcessEnvironment(configured, cwd, env) {
+    const inherited = Object.fromEntries(Object.entries(env)
+        .filter((entry) => entry[1] !== undefined));
+    return {
+        ...inherited,
+        ...(configured ? expandRecord(configured, cwd, env) : {}),
+    };
+}
+function expandRecord(record, cwd, env) {
+    return Object.fromEntries(Object.entries(record).map(([key, value]) => [
+        key,
+        expand(value, cwd, env),
+    ]));
+}
+function expand(value, cwd, env) {
+    return value
+        .replace(/\$\{env:([^}]+)\}/g, (_match, name) => env[name] ?? '')
+        .replace(/\$\{workspaceFolder\}/g, cwd);
+}
+async function closeClients(servers) {
+    await Promise.allSettled(servers.map(({ client }) => client.close()));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function toMcpToolResult(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    return {
+        ...(Array.isArray(value.content)
+            ? { content: value.content }
+            : {}),
+        ...(isRecord(value.structuredContent)
+            ? { structuredContent: value.structuredContent }
+            : {}),
+        ...(value.isError === true ? { isError: true } : {}),
+    };
+}
+function mcpErrorDetail(result) {
+    const text = (result.content ?? [])
+        .filter((item) => item.type === 'text')
+        .map((item) => item.text)
+        .join('\n');
+    if (text)
+        return text;
+    if (result.structuredContent)
+        return JSON.stringify(result.structuredContent);
+    return 'the MCP server reported an error';
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=pi-mcp-bridge.js.map

package/dist/conductor/pi-mcp-bridge.js.map

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

package/dist/conductor/pi-resource-loader.d.ts

@@ -0,0 +1,148 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+/** The Pi settings fields used by model/auth resolution and resource loading. */
+export interface PiSettingsFile {
+    [key: string]: unknown;
+    defaultProvider?: unknown;
+    defaultModel?: unknown;
+    model?: unknown;
+    modelId?: unknown;
+    apiKey?: unknown;
+    apiKeys?: unknown;
+    extensions?: unknown;
+    skills?: unknown;
+    prompts?: unknown;
+    themes?: unknown;
+}
+export type PiAuthFile = Record<string, unknown>;
+export interface PiModelsFile {
+    providers: Record<string, PiProviderConfig>;
+}
+export interface PiProviderConfig {
+    name?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    api?: string;
+    headers?: Record<string, string>;
+    authHeader?: boolean;
+    compat?: Record<string, unknown>;
+    models?: PiModelDefinition[];
+    modelOverrides?: Record<string, PiModelOverride>;
+}
+export interface PiModelDefinition {
+    id: string;
+    name?: string;
+    api?: string;
+    baseUrl?: string;
+    reasoning?: boolean;
+    thinkingLevelMap?: Record<string, string | null>;
+    input?: Array<'text' | 'image'>;
+    cost?: PiModelCost;
+    contextWindow?: number;
+    maxTokens?: number;
+    headers?: Record<string, string>;
+    compat?: Record<string, unknown>;
+}
+export interface PiModelOverride {
+    name?: string;
+    reasoning?: boolean;
+    thinkingLevelMap?: Record<string, string | null>;
+    input?: Array<'text' | 'image'>;
+    cost?: Partial<PiModelCost>;
+    contextWindow?: number;
+    maxTokens?: number;
+    headers?: Record<string, string>;
+    compat?: Record<string, unknown>;
+}
+export interface PiModelCost {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    tiers?: Array<PiModelCostTier>;
+}
+export interface PiModelCostTier {
+    inputTokensAbove: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+export interface PiSkillResource {
+    name: string;
+    description: string;
+    filePath: string;
+    content: string;
+    disableModelInvocation: boolean;
+}
+export interface PiPromptResource {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    filePath: string;
+    content: string;
+}
+export interface PiThemeResource {
+    name: string;
+    filePath: string;
+    value: Record<string, unknown>;
+}
+export interface PiResourceRoots {
+    agentDir: string;
+    projectDir: string;
+}
+export interface PiResourceLoaderOptions {
+    cwd: string;
+    pi?: {
+        agentDir?: string;
+        projectDir?: string;
+    };
+    /** Injectable environment/home for tests; production uses process defaults. */
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+}
+export interface PiResources {
+    roots: PiResourceRoots;
+    settings: PiSettingsFile;
+    auth: PiAuthFile;
+    /** Unmerged layers, in user → project order, for provider-level precedence. */
+    authLayers: PiAuthFile[];
+    /** Unmerged model layers, in user → project order, for provider-level precedence. */
+    modelsLayers: PiModelsFile[];
+    models: PiModelsFile;
+    extensionTools: AgentTool[];
+    extensionPaths: string[];
+    skillPaths: string[];
+    promptPaths: string[];
+    themePaths: string[];
+    skills: PiSkillResource[];
+    prompts: PiPromptResource[];
+    themes: PiThemeResource[];
+}
+/**
+ * Resolve the two Pi resource roots used by the conductor.
+ *
+ * `agentDir` is the user root and defaults to `~/.ensemble/pi`; `projectDir`
+ * is the repository root and defaults to `<cwd>/.ensemble/pi`. The optional
+ * environment variable is retained for compatibility with Pi's launcher.
+ */
+export declare function resolvePiResourceRoots(options: PiResourceLoaderOptions): PiResourceRoots;
+/**
+ * Load Pi's standard file resources for a conductor.
+ *
+ * User resources are read first and project resources second. Settings/auth
+ * objects are deep-merged, project extension tools replace same-named user
+ * tools, and extension loading failures are isolated so a broken optional
+ * local extension cannot prevent the fixed harness tools from starting.
+ *
+ * The conductor loop intentionally runs on low-level `pi-agent-core`; it uses
+ * `pi-coding-agent` only for its compatible AuthStorage/ModelRegistry services.
+ * This loader mirrors the coding-agent resource roots and extension
+ * registration boundary without starting its interactive UI or adding Pi's
+ * built-in coding tools to the conductor.
+ */
+export declare function loadPiResources(options: PiResourceLoaderOptions): Promise<PiResources>;
+/** Add usable Pi skills to the compiled conductor prompt. */
+export declare function formatPiSkillsForPrompt(skills: PiSkillResource[]): string;
+/** Expand Pi prompt templates and explicit skill invocations for headless sends. */
+export declare function expandPiResourcePrompt(prompt: string, resources: Pick<PiResources, 'prompts' | 'skills'>): string;
+//# sourceMappingURL=pi-resource-loader.d.ts.map

package/dist/conductor/pi-resource-loader.d.ts.map

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