@xoxoai/checkmate 0.4.28 → 0.5.0

package/dist/playwright.d.ts

@@ -1,102 +0,0 @@
-import { expect, Page } from '@playwright/test';
-import { CheckmateRunner } from './runtime/runner.js';
-import { CheckmateExtension } from './runtime/extension.js';
-/**
- * Capability names published by the Playwright web extension.
- *
- * Use these in custom extensions that need access to the active Playwright page
- * or the browser tool runtime.
- *
- * @example
- * ```ts
- * const extension = defineExtension({
- *   name: 'custom-web-policy',
- *   setup(api) {
- *     const page = api.getCapability<Page>(PlaywrightCapability.PAGE)
- *     api.addInstruction(`Current page url is ${page.url()}`)
- *   },
- * })
- * ```
- */
-export declare const PlaywrightCapability: {
-    readonly PAGE: "checkmate.playwright.page";
-    readonly BROWSER_RUNTIME: "checkmate.playwright.browser-runtime";
-};
-/**
- * Fixture type exported by `@xoxoai/checkmate/playwright`.
- *
- * @example
- * ```ts
- * test('checkout flow', async ({ ai }) => {
- *   await ai.run({ action: 'Open checkout', expect: 'Checkout page is visible' })
- * })
- * ```
- */
-export type CheckmateFixtures = {
-    /**
-     * Runner composed with the built-in web extension.
-     */
-    ai: CheckmateRunner;
-};
-/**
- * Options for the built-in web extension.
- *
- * @example
- * ```ts
- * const extension = web({ page })
- * ```
- */
-export type WebExtensionOptions = {
-    /**
-     * Active Playwright page used for browser automation.
-     */
-    page: Page;
-};
-/**
- * Creates the built-in web extension.
- *
- * This extension adds browser tools, initial snapshots, and post-tool screenshot handling.
- *
- * @example
- * ```ts
- * import { createRunner } from '@xoxoai/checkmate/core'
- * import { web } from '@xoxoai/checkmate/playwright'
- *
- * const ai = createRunner({
- *   extensions: [web({ page })],
- * })
- * ```
- */
-export declare function web({ page }: WebExtensionOptions): CheckmateExtension;
-/**
- * Creates a runner composed with the built-in web extension.
- *
- * @example
- * ```ts
- * import { createPlaywrightRunner } from '@xoxoai/checkmate/playwright'
- *
- * const ai = createPlaywrightRunner(page)
- * ```
- */
-export declare function createPlaywrightRunner(page: Page): CheckmateRunner;
-/**
- * Playwright Test fixture with the `ai` runner.
- *
- * @example
- * ```ts
- * import { test } from '@xoxoai/checkmate/playwright'
- *
- * test('search flow', async ({ ai }) => {
- *   await ai.run({
- *     action: 'Search for playwright docs',
- *     expect: 'Search results are displayed',
- *   })
- * })
- * ```
- */
-export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & CheckmateFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
-/**
- * Re-export of Playwright's `expect` for convenience.
- */
-export { expect };
-//# sourceMappingURL=playwright.d.ts.map

package/dist/playwright.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAgB,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAmB,MAAM,wBAAwB,CAAA;AAK5E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAA;AAEV;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,EAAE,EAAE,eAAe,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC;;OAEG;IACH,IAAI,EAAE,IAAI,CAAA;CACV,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,mBAAmB,GAAG,kBAAkB,CAmCrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CAElE;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,iQAMf,CAAA;AAEF;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/playwright.js

@@ -1,116 +0,0 @@
-import { expect, test as base } from '@playwright/test';
-import { MessageHistory } from './ai/message-history.js';
-import { createRunner } from './runtime/runner.js';
-import { defineExtension } from './runtime/extension.js';
-import { BrowserScreenshotService } from './tools/browser/screenshot-service.js';
-import { BrowserTool, BrowserToolRuntime, createBrowserTools } from './tools/browser/tool.js';
-import { SnapshotService } from './tools/browser/snapshot-service.js';
-/**
- * Capability names published by the Playwright web extension.
- *
- * Use these in custom extensions that need access to the active Playwright page
- * or the browser tool runtime.
- *
- * @example
- * ```ts
- * const extension = defineExtension({
- *   name: 'custom-web-policy',
- *   setup(api) {
- *     const page = api.getCapability<Page>(PlaywrightCapability.PAGE)
- *     api.addInstruction(`Current page url is ${page.url()}`)
- *   },
- * })
- * ```
- */
-export const PlaywrightCapability = {
-    PAGE: 'checkmate.playwright.page',
-    BROWSER_RUNTIME: 'checkmate.playwright.browser-runtime',
-};
-/**
- * Creates the built-in web extension.
- *
- * This extension adds browser tools, initial snapshots, and post-tool screenshot handling.
- *
- * @example
- * ```ts
- * import { createRunner } from '@xoxoai/checkmate/core'
- * import { web } from '@xoxoai/checkmate/playwright'
- *
- * const ai = createRunner({
- *   extensions: [web({ page })],
- * })
- * ```
- */
-export function web({ page }) {
-    return defineExtension({
-        name: 'web',
-        instructions: [
-            `If you cannot find elements, call '${BrowserTool.TOOL_SNAPSHOT}' to fetch the latest full snapshot of the page.`,
-        ],
-        setup(api) {
-            const browserRuntime = new BrowserToolRuntime(page);
-            api.setCapability(PlaywrightCapability.PAGE, page);
-            api.setCapability(PlaywrightCapability.BROWSER_RUNTIME, browserRuntime);
-            api.addTool(createBrowserTools(browserRuntime));
-        },
-        buildInitialMessages: async ({ step }) => {
-            const snapshot = await new SnapshotService(page, step).get();
-            return [new MessageHistory().createSnapshotMessage(snapshot)];
-        },
-        handleToolResponses: async ({ aiClient, toolResponses }) => {
-            let latestSnapshot = null;
-            for (const { toolResponse } of toolResponses) {
-                if (toolResponse.snapshot) {
-                    latestSnapshot = toolResponse.snapshot;
-                }
-            }
-            if (latestSnapshot) {
-                await aiClient.addCurrentSnapshotMessage(latestSnapshot);
-            }
-            if (aiClient.getRuntimeConfig().includeScreenshotInSnapshot()) {
-                const screenshot = await new BrowserScreenshotService(page).getCompressedScreenshot();
-                await aiClient.addCurrentScreenshotMessage(screenshot.data, screenshot.mimeType ?? 'image/png');
-            }
-        },
-    });
-}
-/**
- * Creates a runner composed with the built-in web extension.
- *
- * @example
- * ```ts
- * import { createPlaywrightRunner } from '@xoxoai/checkmate/playwright'
- *
- * const ai = createPlaywrightRunner(page)
- * ```
- */
-export function createPlaywrightRunner(page) {
-    return createRunner({ extensions: [web({ page })] });
-}
-/**
- * Playwright Test fixture with the `ai` runner.
- *
- * @example
- * ```ts
- * import { test } from '@xoxoai/checkmate/playwright'
- *
- * test('search flow', async ({ ai }) => {
- *   await ai.run({
- *     action: 'Search for playwright docs',
- *     expect: 'Search results are displayed',
- *   })
- * })
- * ```
- */
-export const test = base.extend({
-    ai: async ({ page }, use) => {
-        const ai = createPlaywrightRunner(page);
-        await use(ai);
-        await ai.teardown();
-    },
-});
-/**
- * Re-export of Playwright's `expect` for convenience.
- */
-export { expect };
-//# sourceMappingURL=playwright.js.map

package/dist/playwright.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAQ,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAsB,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAErE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,IAAI,EAAE,2BAA2B;IACjC,eAAe,EAAE,sCAAsC;CAC9C,CAAA;AAkCV;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAuB;IAChD,OAAO,eAAe,CAAC;QACtB,IAAI,EAAE,KAAK;QACX,YAAY,EAAE;YACb,sCAAsC,WAAW,CAAC,aAAa,kDAAkD;SACjH;QACD,KAAK,CAAC,GAAG;YACR,MAAM,cAAc,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAA;YACnD,GAAG,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAClD,GAAG,CAAC,aAAa,CAAC,oBAAoB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAA;YACvE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAA;QAChD,CAAC;QACD,oBAAoB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;YAC5D,OAAO,CAAC,IAAI,cAAc,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC9D,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;YAC1D,IAAI,cAAc,GAAkB,IAAI,CAAA;YAExC,KAAK,MAAM,EAAE,YAAY,EAAE,IAAI,aAAa,EAAE,CAAC;gBAC9C,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;oBAC3B,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAA;gBACvC,CAAC;YACF,CAAC;YAED,IAAI,cAAc,EAAE,CAAC;gBACpB,MAAM,QAAQ,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAA;YACzD,CAAC;YAED,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC,2BAA2B,EAAE,EAAE,CAAC;gBAC/D,MAAM,UAAU,GAAG,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,uBAAuB,EAAE,CAAA;gBACrF,MAAM,QAAQ,CAAC,2BAA2B,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAA;YAChG,CAAC;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAChD,OAAO,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;AACrD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAoB;IAClD,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;QACb,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAA;IACpB,CAAC;CACD,CAAC,CAAA;AAEF;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/runtime/extension.d.ts

@@ -1,274 +0,0 @@
-import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
-import { RuntimeConfig } from '../config/runtime-config.js';
-import { ToolRegistry, ToolResponse } from '../tools/registry.js';
-import { AgentTool, ToolCall } from '../tools/types.js';
-import { ResolveStepResult, Step } from './types.js';
-import type { AiClient } from '../ai/client.js';
-/**
- * One tool execution observed during the runner loop.
- *
- * Extensions receive these objects in post-tool hooks.
- *
- * @example
- * ```ts
- * const execution: ToolExecution = {
- *   toolCallId: 'call_1',
- *   toolCall: { name: 'browser_navigate', arguments: { url: 'https://example.com' } },
- *   toolResponse: { response: 'Navigated to example.com', status: 'success' },
- * }
- * ```
- */
-export type ToolExecution = {
-    /**
-     * Provider-issued id for the tool call.
-     */
-    toolCallId: string;
-    /**
-     * Normalized tool call request.
-     */
-    toolCall: ToolCall;
-    /**
-     * Normalized tool response returned by Checkmate.
-     */
-    toolResponse: ToolResponse;
-};
-/**
- * Builds additional initial messages for a step.
- *
- * Use this to inject snapshots, screenshots, or custom context before the first model request.
- *
- * @example
- * ```ts
- * const buildInitialMessages: ExtensionInitialMessagesBuilder = async ({ step }) => [
- *   { role: 'user', content: `Current business area: checkout for ${step.action}` },
- * ]
- * ```
- */
-export type ExtensionInitialMessagesBuilder = (context: {
-    /**
-     * Step being executed.
-     */
-    step: Step;
-}) => Promise<ChatCompletionMessageParam[]> | ChatCompletionMessageParam[];
-/**
- * Runs after one or more tools finish.
- *
- * Use this to append fresh snapshots, screenshots, or any other ephemeral follow-up context.
- *
- * @example
- * ```ts
- * const handleToolResponses: ExtensionToolResponsesHook = async ({ aiClient, toolResponses }) => {
- *   const snapshot = toolResponses.at(-1)?.toolResponse.snapshot
- *   if (snapshot) {
- *     await aiClient.addCurrentSnapshotMessage(snapshot)
- *   }
- * }
- * ```
- */
-export type ExtensionToolResponsesHook = (context: {
-    /**
-     * Active AI client for the current step.
-     */
-    aiClient: AiClient;
-    /**
-     * Step being executed.
-     */
-    step: Step;
-    /**
-     * Callback used to finish the step.
-     */
-    resolveStepResult: ResolveStepResult;
-    /**
-     * Tool executions that just completed.
-     */
-    toolResponses: ToolExecution[];
-}) => Promise<void> | void;
-/**
- * Cleans up resources created by an extension.
- *
- * @example
- * ```ts
- * const teardown: ExtensionTeardown = async () => {
- *   await browser.close()
- * }
- * ```
- */
-export type ExtensionTeardown = () => Promise<void> | void;
-/**
- * API exposed to an extension during setup.
- *
- * @example
- * ```ts
- * const extension = defineExtension({
- *   name: 'custom',
- *   setup(api) {
- *     api.addInstruction('Prefer visible labels over generated ids.')
- *   },
- * })
- * ```
- */
-export type ExtensionSetupApi = {
-    /**
-     * Runtime config used by the current runner.
-     */
-    runtimeConfig: RuntimeConfig;
-    /**
-     * Registers one or more tools.
-     */
-    addTool: (tool: AgentTool | AgentTool[]) => void;
-    /**
-     * Appends a system-level instruction for the model.
-     */
-    addInstruction: (instruction: string) => void;
-    /**
-     * Adds a builder for extra initial messages.
-     */
-    addInitialMessages: (builder: ExtensionInitialMessagesBuilder) => void;
-    /**
-     * Adds a hook that runs after tool execution.
-     */
-    addToolResponsesHook: (hook: ExtensionToolResponsesHook) => void;
-    /**
-     * Publishes a capability for other extensions to consume.
-     */
-    setCapability: (name: string, value: unknown) => void;
-    /**
-     * Reads a capability published by another extension.
-     */
-    getCapability: <T>(name: string) => T;
-    /**
-     * Registers teardown work for the runner lifecycle.
-     */
-    onTeardown: (teardown: ExtensionTeardown) => void;
-};
-/**
- * Shape used to define a Checkmate extension.
- *
- * @example
- * ```ts
- * const extension = defineExtension({
- *   name: 'api-health',
- *   instructions: ['Check API health before asserting UI state.'],
- *   tools: [apiHealthTool],
- * })
- * ```
- */
-export type ExtensionDefinition = {
-    /**
-     * Stable extension name.
-     */
-    name: string;
-    /**
-     * Tools contributed by this extension.
-     */
-    tools?: AgentTool | AgentTool[];
-    /**
-     * Additional system instructions for the model.
-     */
-    instructions?: string[];
-    /**
-     * Setup hook used to register capabilities, tools, and hooks.
-     */
-    setup?: (api: ExtensionSetupApi) => void;
-    /**
-     * Optional builder for initial step messages.
-     */
-    buildInitialMessages?: ExtensionInitialMessagesBuilder;
-    /**
-     * Optional hook that runs after tool execution.
-     */
-    handleToolResponses?: ExtensionToolResponsesHook;
-    /**
-     * Optional teardown hook.
-     */
-    teardown?: ExtensionTeardown;
-};
-/**
- * Additional behavior layered on top of an existing extension.
- *
- * @example
- * ```ts
- * const customWeb = web({ page }).extend({
- *   instructions: ['Prefer visible labels over generated ids.'],
- * })
- * ```
- */
-export type ExtensionOverride = Omit<ExtensionDefinition, 'name'> & {
-    /**
-     * Optional replacement name for the derived extension.
-     */
-    name?: string;
-};
-/**
- * A composable Checkmate extension.
- *
- * Use `defineExtension()` to create one, then pass it to `createRunner()`.
- *
- * @example
- * ```ts
- * const extension = defineExtension({
- *   name: 'custom',
- *   instructions: ['Prefer visible labels over generated ids.'],
- * })
- * ```
- */
-export type CheckmateExtension = {
-    /**
-     * Stable extension name.
-     */
-    name: string;
-    /**
-     * Applies the extension to the runner host.
-     */
-    apply: (api: ExtensionSetupApi) => void;
-    /**
-     * Derives a new extension by layering more behavior on top.
-     *
-     * @example
-     * ```ts
-     * const customWeb = web({ page }).extend({
-     *   instructions: ['Use customer-specific naming where available.'],
-     * })
-     * ```
-     */
-    extend: (override: ExtensionOverride) => CheckmateExtension;
-};
-/**
- * Creates a composable Checkmate extension.
- *
- * @example
- * ```ts
- * import { createRunner, defineExtension } from '@xoxoai/checkmate/core'
- * import { web } from '@xoxoai/checkmate/playwright'
- *
- * const extension = defineExtension({
- *   name: 'checkout-policy',
- *   instructions: ['Prefer visible checkout totals over inferred values.'],
- * })
- *
- * const ai = createRunner({
- *   extensions: [web({ page }), extension],
- * })
- * ```
- */
-export declare function defineExtension(definition: ExtensionDefinition): CheckmateExtension;
-export declare class ExtensionHost {
-    private readonly runtimeConfig;
-    private readonly toolRegistry;
-    private readonly instructions;
-    private readonly initialMessagesBuilders;
-    private readonly toolResponsesHooks;
-    private readonly teardowns;
-    private readonly capabilities;
-    constructor(runtimeConfig: RuntimeConfig, toolRegistry: ToolRegistry, extensions: CheckmateExtension[]);
-    getInstructions(): string[];
-    buildInitialMessages(step: Step): Promise<ChatCompletionMessageParam[]>;
-    handleToolResponses(context: {
-        aiClient: AiClient;
-        step: Step;
-        resolveStepResult: ResolveStepResult;
-        toolResponses: ToolExecution[];
-    }): Promise<void>;
-    teardown(): Promise<void>;
-}
-//# sourceMappingURL=extension.d.ts.map

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

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

package/dist/runtime/extension.js

@@ -1,171 +0,0 @@
-/**
- * Creates a composable Checkmate extension.
- *
- * @example
- * ```ts
- * import { createRunner, defineExtension } from '@xoxoai/checkmate/core'
- * import { web } from '@xoxoai/checkmate/playwright'
- *
- * const extension = defineExtension({
- *   name: 'checkout-policy',
- *   instructions: ['Prefer visible checkout totals over inferred values.'],
- * })
- *
- * const ai = createRunner({
- *   extensions: [web({ page }), extension],
- * })
- * ```
- */
-export function defineExtension(definition) {
-    return {
-        name: definition.name,
-        apply(api) {
-            registerExtension(api, definition);
-        },
-        extend(override) {
-            return defineExtension(mergeExtensionDefinition(definition, override));
-        },
-    };
-}
-export class ExtensionHost {
-    runtimeConfig;
-    toolRegistry;
-    instructions = [];
-    initialMessagesBuilders = [];
-    toolResponsesHooks = [];
-    teardowns = [];
-    capabilities = new Map();
-    constructor(runtimeConfig, toolRegistry, extensions) {
-        this.runtimeConfig = runtimeConfig;
-        this.toolRegistry = toolRegistry;
-        const api = {
-            runtimeConfig,
-            addTool: (tool) => this.toolRegistry.register(tool),
-            addInstruction: (instruction) => {
-                if (instruction.trim().length > 0) {
-                    this.instructions.push(instruction);
-                }
-            },
-            addInitialMessages: (builder) => {
-                this.initialMessagesBuilders.push(builder);
-            },
-            addToolResponsesHook: (hook) => {
-                this.toolResponsesHooks.push(hook);
-            },
-            setCapability: (name, value) => {
-                this.capabilities.set(name, value);
-            },
-            getCapability: (name) => {
-                if (!this.capabilities.has(name)) {
-                    throw new Error(`Extension capability '${name}' is not available`);
-                }
-                return this.capabilities.get(name);
-            },
-            onTeardown: (teardown) => {
-                this.teardowns.push(teardown);
-            },
-        };
-        for (const extension of extensions) {
-            extension.apply(api);
-        }
-    }
-    getInstructions() {
-        return [...this.instructions];
-    }
-    async buildInitialMessages(step) {
-        const messages = [];
-        for (const buildInitialMessages of this.initialMessagesBuilders) {
-            messages.push(...(await buildInitialMessages({ step })));
-        }
-        return messages;
-    }
-    async handleToolResponses(context) {
-        for (const handleToolResponses of this.toolResponsesHooks) {
-            await handleToolResponses(context);
-        }
-    }
-    async teardown() {
-        for (const teardown of [...this.teardowns].reverse()) {
-            await teardown();
-        }
-    }
-}
-function registerExtension(api, definition) {
-    for (const tool of asArray(definition.tools)) {
-        api.addTool(tool);
-    }
-    for (const instruction of definition.instructions ?? []) {
-        api.addInstruction(instruction);
-    }
-    if (definition.buildInitialMessages) {
-        api.addInitialMessages(definition.buildInitialMessages);
-    }
-    if (definition.handleToolResponses) {
-        api.addToolResponsesHook(definition.handleToolResponses);
-    }
-    if (definition.teardown) {
-        api.onTeardown(definition.teardown);
-    }
-    definition.setup?.(api);
-}
-function mergeExtensionDefinition(base, override) {
-    return {
-        name: override.name ?? base.name,
-        tools: [...asArray(base.tools), ...asArray(override.tools)],
-        instructions: [...(base.instructions ?? []), ...(override.instructions ?? [])],
-        setup: chainSync(base.setup, override.setup),
-        buildInitialMessages: combineInitialMessages(base.buildInitialMessages, override.buildInitialMessages),
-        handleToolResponses: chainAsync(base.handleToolResponses, override.handleToolResponses),
-        teardown: chainAsync(base.teardown, override.teardown),
-    };
-}
-function chainSync(first, second) {
-    if (!first) {
-        return second;
-    }
-    if (!second) {
-        return (...args) => {
-            first(...args);
-        };
-    }
-    return (...args) => {
-        first(...args);
-        second(...args);
-    };
-}
-function chainAsync(first, second) {
-    if (!first) {
-        return second
-            ? async (...args) => {
-                await second(...args);
-            }
-            : undefined;
-    }
-    if (!second) {
-        return async (...args) => {
-            await first(...args);
-        };
-    }
-    return async (...args) => {
-        await first(...args);
-        await second(...args);
-    };
-}
-function combineInitialMessages(first, second) {
-    if (!first) {
-        return second;
-    }
-    if (!second) {
-        return first;
-    }
-    return async (context) => {
-        return [...(await first(context)), ...(await second(context))];
-    };
-}
-function asArray(value) {
-    if (!value) {
-        return [];
-    }
-    return Array.isArray(value) ? value : [value];
-}
-//# sourceMappingURL=extension.js.map

package/dist/runtime/extension.js.map

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