@xoxoai/checkmate 0.4.0

package/dist/tools/browser/tool.js.map

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

package/dist/tools/browser/transient-state-tracker.d.ts

@@ -0,0 +1,16 @@
+import { Page } from '@playwright/test';
+type Clock = () => number;
+export declare class TransientStateTracker {
+    private readonly page;
+    static readonly LOG_PREFIX = "__CHECKMATE_MUTATION__";
+    private readonly timeline;
+    private readonly mutationObserver;
+    private readonly eventManager;
+    private isTracking;
+    constructor(page: Page, clock?: Clock);
+    start(): Promise<void>;
+    stop(): Promise<string[]>;
+    formatTimeline(): string;
+}
+export {};
+//# sourceMappingURL=transient-state-tracker.d.ts.map

package/dist/tools/browser/transient-state-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-state-tracker.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/transient-state-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAGtE,KAAK,KAAK,GAAG,MAAM,MAAM,CAAA;AAkQzB,qBAAa,qBAAqB;IAShC,OAAO,CAAC,QAAQ,CAAC,IAAI;IARtB,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;IAEhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,UAAU,CAAQ;gBAGR,IAAI,EAAE,IAAI,EAC3B,KAAK,GAAE,KAAwB;IAiB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/B,cAAc,IAAI,MAAM;CAGxB"}

package/dist/tools/browser/transient-state-tracker.js

@@ -0,0 +1,266 @@
+import { logger } from '../../logging';
+const TIMELINE_HEADER = 'Timeline of events after last function call:';
+const MUTATION_LOG_PREFIX = '__CHECKMATE_MUTATION__';
+const MUTATION_OBSERVER_KEY = '__checkmate_mutation_observer';
+class TimelineRecorder {
+    clock;
+    events = [];
+    startTime = 0;
+    lastMessage = null;
+    constructor(clock) {
+        this.clock = clock;
+    }
+    start() {
+        this.startTime = this.clock();
+        this.events = [];
+        this.lastMessage = null;
+    }
+    clearEvents() {
+        this.events = [];
+        this.lastMessage = null;
+    }
+    record(message) {
+        this.events.push(this.withElapsed(message));
+        this.lastMessage = message;
+    }
+    recordUnique(message) {
+        if (this.lastMessage !== message) {
+            this.record(message);
+        }
+    }
+    replaceWith(message) {
+        this.clearEvents();
+        this.record(message);
+    }
+    list() {
+        return [...this.events];
+    }
+    format() {
+        return this.events.length === 0 ? '' : `${TIMELINE_HEADER}\n${this.events.join('\n')}\n`;
+    }
+    withElapsed(message) {
+        return `[${this.clock() - this.startTime}ms] ${message}`;
+    }
+}
+class MutationObserverController {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    async attach() {
+        await this.page
+            .evaluate(setupMutationObserver, { logPrefix: MUTATION_LOG_PREFIX, observerKey: MUTATION_OBSERVER_KEY })
+            .catch(() => { });
+    }
+    async detach() {
+        await this.page.evaluate(teardownMutationObserver, MUTATION_OBSERVER_KEY).catch((error) => {
+            logger.debug(`failed to remove MutationObserver from page due to error:\n${JSON.stringify(error, null, 2)}`);
+        });
+    }
+}
+class PageEventManager {
+    page;
+    timeline;
+    isTracking;
+    onMainFrameNavigation;
+    mutationLogPrefix;
+    constructor(page, timeline, isTracking, onMainFrameNavigation, mutationLogPrefix) {
+        this.page = page;
+        this.timeline = timeline;
+        this.isTracking = isTracking;
+        this.onMainFrameNavigation = onMainFrameNavigation;
+        this.mutationLogPrefix = mutationLogPrefix;
+    }
+    attach() {
+        this.page.on('dialog', this.handleDialog);
+        this.page.on('console', this.handleConsole);
+        this.page.on('framenavigated', this.handleNavigation);
+    }
+    detach() {
+        this.page.off('dialog', this.handleDialog);
+        this.page.off('console', this.handleConsole);
+        this.page.off('framenavigated', this.handleNavigation);
+    }
+    handleDialog = (dialog) => {
+        if (!this.isTracking()) {
+            return;
+        }
+        this.timeline.record(`Dialog appeared: "${dialog.message()}" (Type: ${dialog.type()}) and automatically dismissed.`);
+        dialog.dismiss().catch(() => { });
+    };
+    handleConsole = (message) => {
+        if (!this.isTracking()) {
+            return;
+        }
+        const text = message.text();
+        if (text.startsWith(this.mutationLogPrefix)) {
+            this.timeline.recordUnique(text.substring(this.mutationLogPrefix.length));
+            return;
+        }
+        if (message.type() === 'error') {
+            this.timeline.record(`Console Error: ${text.substring(0, 200)}`);
+        }
+    };
+    handleNavigation = (frame) => {
+        if (!this.isTracking()) {
+            return;
+        }
+        if (frame === this.page.mainFrame()) {
+            this.timeline.replaceWith(`Navigated to: ${frame.url()}`);
+            this.onMainFrameNavigation();
+        }
+    };
+}
+function setupMutationObserver({ logPrefix, observerKey }) {
+    const win = window;
+    const skipTags = new Set(['INS', 'IFRAME', 'SCRIPT', 'STYLE']);
+    if (win[observerKey]) {
+        win[observerKey].disconnect();
+    }
+    const getTextContent = (node) => {
+        if (node.nodeType === 3)
+            return (node.textContent || '').trim();
+        if (node.nodeType === 1)
+            return (node.textContent || '').trim().replace(/\s+/g, ' ');
+        return '';
+    };
+    const isSkippableElement = (element) => {
+        return !!element && skipTags.has(element.tagName);
+    };
+    const observer = new MutationObserver((mutations) => {
+        const appearedTexts = [];
+        const disappearedTexts = [];
+        const attributeChanges = [];
+        mutations.forEach((mutation) => {
+            try {
+                if (mutation.type === 'attributes') {
+                    const element = mutation.target;
+                    if (isSkippableElement(element)) {
+                        return;
+                    }
+                    const text = getTextContent(element);
+                    if (!text || text.length <= 2) {
+                        return;
+                    }
+                    const attrName = mutation.attributeName;
+                    const oldValue = mutation.oldValue || '';
+                    const newValue = element.getAttribute(attrName) || '';
+                    let changes = '';
+                    if (attrName === 'class') {
+                        const oldClasses = oldValue.split(' ').filter(Boolean);
+                        const newClasses = newValue.split(' ').filter(Boolean);
+                        const added = newClasses.filter((item) => !oldClasses.includes(item));
+                        const removed = oldClasses.filter((item) => !newClasses.includes(item));
+                        if (added.length)
+                            changes += `+${added.join(',')}`;
+                        if (removed.length)
+                            changes += `${changes ? ' ' : ''}-${removed.join(',')}`;
+                    }
+                    else if (!oldValue && newValue) {
+                        changes = `+${attrName}=${newValue.substring(0, 50)}`;
+                    }
+                    else if (oldValue && !newValue) {
+                        changes = `-${attrName}`;
+                    }
+                    else {
+                        changes = `~${attrName}=${newValue.substring(0, 50)}`;
+                    }
+                    if (changes) {
+                        attributeChanges.push(`${text.substring(0, 100)} [${changes}]`);
+                    }
+                    return;
+                }
+                if (mutation.type !== 'childList') {
+                    return;
+                }
+                mutation.addedNodes.forEach((node) => {
+                    const element = node.nodeType === 1 ? node : node.parentElement;
+                    if (isSkippableElement(element)) {
+                        return;
+                    }
+                    if (element && typeof element.checkVisibility === 'function' && !element.checkVisibility()) {
+                        return;
+                    }
+                    const text = getTextContent(node);
+                    if (text && text.length > 2) {
+                        appearedTexts.push(text.substring(0, 100));
+                    }
+                });
+                mutation.removedNodes.forEach((node) => {
+                    const element = node.nodeType === 1 ? node : node.parentElement;
+                    if (isSkippableElement(element)) {
+                        return;
+                    }
+                    const text = getTextContent(node);
+                    if (text && text.length > 2) {
+                        disappearedTexts.push(text.substring(0, 100));
+                    }
+                });
+            }
+            catch {
+                /* empty */
+            }
+        });
+        const uniqueAppeared = [...new Set(appearedTexts)];
+        const uniqueDisappeared = [...new Set(disappearedTexts)];
+        const uniqueAttributeChanges = [...new Set(attributeChanges)];
+        if (uniqueAppeared.length > 0) {
+            console.log(`${logPrefix}Appeared: ${uniqueAppeared.join(' | ').substring(0, 300)}`);
+        }
+        if (uniqueDisappeared.length > 0) {
+            console.log(`${logPrefix}Disappeared: ${uniqueDisappeared.join(' | ').substring(0, 300)}`);
+        }
+        if (uniqueAttributeChanges.length > 0) {
+            console.log(`${logPrefix}Changed: ${uniqueAttributeChanges.join(' | ').substring(0, 400)}`);
+        }
+    });
+    observer.observe(document, { childList: true, subtree: true, attributes: true, attributeOldValue: true });
+    win[observerKey] = observer;
+}
+function teardownMutationObserver(observerKey) {
+    const win = window;
+    if (win[observerKey]) {
+        win[observerKey].disconnect();
+        delete win[observerKey];
+    }
+}
+export class TransientStateTracker {
+    page;
+    static LOG_PREFIX = MUTATION_LOG_PREFIX;
+    timeline;
+    mutationObserver;
+    eventManager;
+    isTracking = false;
+    constructor(page, clock = () => Date.now()) {
+        this.page = page;
+        this.timeline = new TimelineRecorder(clock);
+        this.mutationObserver = new MutationObserverController(page);
+        this.eventManager = new PageEventManager(page, this.timeline, () => this.isTracking, () => {
+            if (this.isTracking) {
+                void this.stop();
+            }
+        }, MUTATION_LOG_PREFIX);
+    }
+    async start() {
+        if (this.isTracking) {
+            await this.stop();
+        }
+        this.timeline.start();
+        this.isTracking = true;
+        this.eventManager.attach();
+        await this.mutationObserver.attach();
+    }
+    async stop() {
+        if (!this.isTracking) {
+            return this.timeline.list();
+        }
+        this.isTracking = false;
+        this.eventManager.detach();
+        await this.mutationObserver.detach();
+        return this.timeline.list();
+    }
+    formatTimeline() {
+        return this.timeline.format();
+    }
+}
+//# sourceMappingURL=transient-state-tracker.js.map

package/dist/tools/browser/transient-state-tracker.js.map

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

package/dist/tools/define-agent-tool.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod/v4';
+import { AgentTool, AgentToolContext, AgentToolResult } from './types';
+type ToolConfig<TSchema extends z.ZodType> = {
+    name: string;
+    description: string;
+    schema: TSchema;
+    strict?: boolean;
+    handler: (args: z.infer<TSchema>, context: AgentToolContext) => Promise<AgentToolResult> | AgentToolResult;
+};
+/**
+ * Creates a typed Checkmate tool from a Zod schema and handler.
+ *
+ * @example
+ * ```ts
+ * import { defineAgentTool } from '@xoxoai/checkmate/core'
+ * import { z } from 'zod/v4'
+ *
+ * const apiHealthTool = defineAgentTool({
+ *   name: 'check_api_health',
+ *   description: 'Check whether the API is healthy',
+ *   schema: z.object({ url: z.string() }).strict(),
+ *   handler: async ({ url }) => `API health is good for ${url}`,
+ * })
+ * ```
+ */
+export declare function defineAgentTool<TSchema extends z.ZodType>(toolConfig: ToolConfig<TSchema>): AgentTool;
+/**
+ * Preferred alias for `defineAgentTool()`.
+ *
+ * @example
+ * ```ts
+ * import { defineTool } from '@xoxoai/checkmate/core'
+ * import { z } from 'zod/v4'
+ *
+ * const tool = defineTool({
+ *   name: 'check_api_health',
+ *   description: 'Check whether the API is healthy',
+ *   schema: z.object({ url: z.string() }).strict(),
+ *   handler: async ({ url }) => `API health is good for ${url}`,
+ * })
+ * ```
+ */
+export declare const defineTool: typeof defineAgentTool;
+export {};
+//# sourceMappingURL=define-agent-tool.d.ts.map

package/dist/tools/define-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAuB,eAAe,EAAE,MAAM,SAAS,CAAA;AAE3F,KAAK,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,IAAI;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;CAC1G,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,SAAS,CAsBrG;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,wBAAkB,CAAA"}

package/dist/tools/define-agent-tool.js

@@ -0,0 +1,55 @@
+import { z } from 'zod/v4';
+/**
+ * Creates a typed Checkmate tool from a Zod schema and handler.
+ *
+ * @example
+ * ```ts
+ * import { defineAgentTool } from '@xoxoai/checkmate/core'
+ * import { z } from 'zod/v4'
+ *
+ * const apiHealthTool = defineAgentTool({
+ *   name: 'check_api_health',
+ *   description: 'Check whether the API is healthy',
+ *   schema: z.object({ url: z.string() }).strict(),
+ *   handler: async ({ url }) => `API health is good for ${url}`,
+ * })
+ * ```
+ */
+export function defineAgentTool(toolConfig) {
+    const jsonSchema = z.toJSONSchema(toolConfig.schema);
+    delete jsonSchema.$schema;
+    const definition = {
+        name: toolConfig.name,
+        description: toolConfig.description,
+        parameters: jsonSchema,
+        strict: toolConfig.strict ?? true,
+    };
+    return {
+        definition,
+        execute: async (args, context) => {
+            const parsed = toolConfig.schema.safeParse(args);
+            if (!parsed.success) {
+                return JSON.stringify({ error: `Invalid args for '${toolConfig.name}': ${parsed.error.message}` });
+            }
+            return toolConfig.handler(parsed.data, context);
+        },
+    };
+}
+/**
+ * Preferred alias for `defineAgentTool()`.
+ *
+ * @example
+ * ```ts
+ * import { defineTool } from '@xoxoai/checkmate/core'
+ * import { z } from 'zod/v4'
+ *
+ * const tool = defineTool({
+ *   name: 'check_api_health',
+ *   description: 'Check whether the API is healthy',
+ *   schema: z.object({ url: z.string() }).strict(),
+ *   handler: async ({ url }) => `API health is good for ${url}`,
+ * })
+ * ```
+ */
+export const defineTool = defineAgentTool;
+//# sourceMappingURL=define-agent-tool.js.map

package/dist/tools/define-agent-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-agent-tool.js","sourceRoot":"","sources":["../../src/tools/define-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAA4B,UAA+B;IACzF,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAA4B,CAAA;IAC/E,OAAO,UAAU,CAAC,OAAO,CAAA;IAEzB,MAAM,UAAU,GAAwB;QACvC,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;KACjC,CAAA;IAED,OAAO;QACN,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,OAAyB,EAAE,EAAE;YAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,UAAU,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;YACnG,CAAC;YAED,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAChD,CAAC;KACD,CAAA;AACF,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAA"}

package/dist/tools/dispatcher.d.ts

@@ -0,0 +1,11 @@
+import { ToolRegistry, ToolResponse } from './registry';
+import { AgentToolContext, ToolCall } from './types';
+export declare class ToolDispatcher {
+    private readonly toolRegistry;
+    private readonly loopDetector;
+    constructor(toolRegistry: ToolRegistry);
+    getToolRegistry(): ToolRegistry;
+    dispatch(toolCall: ToolCall, context: AgentToolContext): Promise<ToolResponse | null>;
+    private normalizeToolResponse;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/tools/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/tools/dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAmB,QAAQ,EAAE,MAAM,SAAS,CAAA;AAErE,qBAAa,cAAc;IAGd,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAEd,YAAY,EAAE,YAAY;IAIvD,eAAe,IAAI,YAAY;IAIzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAa3F,OAAO,CAAC,qBAAqB;CAqB7B"}

package/dist/tools/dispatcher.js

@@ -0,0 +1,49 @@
+import { logger } from '../logging';
+import { LoopDetector } from './loop-detector';
+export class ToolDispatcher {
+    toolRegistry;
+    loopDetector;
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+        this.loopDetector = new LoopDetector(toolRegistry.getRuntimeConfig().getLoopMaxRepetitions());
+    }
+    getToolRegistry() {
+        return this.toolRegistry;
+    }
+    async dispatch(toolCall, context) {
+        this.loopDetector.recordToolCall(toolCall);
+        logger.info(`executing tool: ${toolCall.name}:\n${JSON.stringify(toolCall.arguments ?? {}, null, 2)}`);
+        const tool = this.toolRegistry.resolve(toolCall.name);
+        if (!tool) {
+            throw new Error(`Invalid tool name, received call\n: ${JSON.stringify(toolCall, null, 2)}`);
+        }
+        const result = await tool.execute(toolCall.arguments, context);
+        return this.normalizeToolResponse(toolCall.name, result);
+    }
+    normalizeToolResponse(toolName, result) {
+        if (result === undefined) {
+            return null;
+        }
+        if (typeof result === 'string') {
+            return { name: toolName, response: result, status: inferToolResponseStatus(result) };
+        }
+        const normalizedResult = (result ?? { response: '' });
+        return {
+            name: toolName,
+            response: normalizedResult.response,
+            snapshot: normalizedResult.snapshot ?? null,
+            status: normalizedResult.status ?? 'success',
+        };
+    }
+}
+function inferToolResponseStatus(response) {
+    const normalizedResponse = response.trim().toLowerCase();
+    if (normalizedResponse.startsWith('failed') ||
+        normalizedResponse.startsWith('error') ||
+        normalizedResponse.startsWith('tool call error') ||
+        normalizedResponse.startsWith('{"error"')) {
+        return 'error';
+    }
+    return 'success';
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/tools/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/tools/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI9C,MAAM,OAAO,cAAc;IAGG;IAFZ,YAAY,CAAc;IAE3C,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;QACtD,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAA;IAC9F,CAAC;IAED,eAAe;QACd,OAAO,IAAI,CAAC,YAAY,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAkB,EAAE,OAAyB;QAC3D,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAEtG,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAC5F,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACzD,CAAC;IAEO,qBAAqB,CAAC,QAAgB,EAAE,MAAuB;QACtE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAA;QACrF,CAAC;QAED,MAAM,gBAAgB,GAAG,CAAC,MAAM,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAInD,CAAA;QACD,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YACnC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,IAAI,IAAI;YAC3C,MAAM,EAAE,gBAAgB,CAAC,MAAM,IAAI,SAAS;SAC5C,CAAA;IACF,CAAC;CACD;AAED,SAAS,uBAAuB,CAAC,QAAgB;IAChD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACxD,IACC,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC;QACvC,kBAAkB,CAAC,UAAU,CAAC,OAAO,CAAC;QACtC,kBAAkB,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAChD,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,EACxC,CAAC;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/dist/tools/loop-detector.d.ts

@@ -0,0 +1,27 @@
+import { ToolCall } from './tool-contract';
+export type LoopDetectionResult = {
+    loopDetected: boolean;
+    patternLength: number;
+    repetitions: number;
+    pattern: string[];
+};
+export declare class LoopDetectedError extends Error {
+    readonly loopResult: LoopDetectionResult;
+    static readonly STATUS = "TOOL_CALL_LOOP";
+    readonly status: string;
+    constructor(loopResult: LoopDetectionResult);
+}
+export declare class LoopDetector {
+    private readonly maxRepetitions;
+    private toolCallHistory;
+    constructor(maxRepetitions: number);
+    reset(): void;
+    recordToolCall(toolCall: ToolCall): void;
+    detectLoop(): void;
+    private checkPatternRepetition;
+    private patternsMatch;
+    private createToolSignature;
+    getHistory(): string[];
+    getHistoryLength(): number;
+}
+//# sourceMappingURL=loop-detector.d.ts.map

package/dist/tools/loop-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detector.d.ts","sourceRoot":"","sources":["../../src/tools/loop-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,MAAM,MAAM,mBAAmB,GAAG;IACjC,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAIf,UAAU,EAAE,mBAAmB;IAH3D,MAAM,CAAC,QAAQ,CAAC,MAAM,oBAAmB;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEK,UAAU,EAAE,mBAAmB;CAO3D;AAED,qBAAa,YAAY;IAGZ,OAAO,CAAC,QAAQ,CAAC,cAAc;IAF3C,OAAO,CAAC,eAAe,CAAe;gBAET,cAAc,EAAE,MAAM;IAEnD,KAAK,IAAI,IAAI;IAIb,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKxC,UAAU;IAWV,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,mBAAmB;IAY3B,UAAU,IAAI,MAAM,EAAE;IAItB,gBAAgB,IAAI,MAAM;CAG1B"}

package/dist/tools/loop-detector.js

@@ -0,0 +1,76 @@
+export class LoopDetectedError extends Error {
+    loopResult;
+    static STATUS = 'TOOL_CALL_LOOP';
+    status;
+    constructor(loopResult) {
+        super(`detected tool call loop pattern [${loopResult.pattern.join(' -> ')}] repeated ${loopResult.repetitions} times`);
+        this.loopResult = loopResult;
+        this.name = 'LoopDetectedError';
+        this.status = LoopDetectedError.STATUS;
+    }
+}
+export class LoopDetector {
+    maxRepetitions;
+    toolCallHistory = [];
+    constructor(maxRepetitions) {
+        this.maxRepetitions = maxRepetitions;
+    }
+    reset() {
+        this.toolCallHistory = [];
+    }
+    recordToolCall(toolCall) {
+        this.toolCallHistory.push(this.createToolSignature(toolCall));
+        this.detectLoop();
+    }
+    detectLoop() {
+        const history = this.toolCallHistory;
+        for (let patternLength = 1; patternLength <= Math.floor(history.length / 2); patternLength++) {
+            const result = this.checkPatternRepetition(patternLength);
+            if (result.loopDetected) {
+                this.reset();
+                throw new LoopDetectedError(result);
+            }
+        }
+    }
+    checkPatternRepetition(patternLength) {
+        const history = this.toolCallHistory;
+        if (history.length < patternLength * this.maxRepetitions) {
+            return { loopDetected: false, patternLength: 0, repetitions: 0, pattern: [] };
+        }
+        const pattern = history.slice(-patternLength);
+        let repetitions = 1;
+        for (let index = history.length - patternLength * 2; index >= 0; index -= patternLength) {
+            const slice = history.slice(index, index + patternLength);
+            if (this.patternsMatch(pattern, slice)) {
+                repetitions++;
+            }
+            else {
+                break;
+            }
+        }
+        if (repetitions >= this.maxRepetitions) {
+            return { loopDetected: true, patternLength, repetitions, pattern };
+        }
+        return { loopDetected: false, patternLength: 0, repetitions: 0, pattern: [] };
+    }
+    patternsMatch(pattern1, pattern2) {
+        return pattern1.length === pattern2.length && pattern1.every((item, index) => item === pattern2[index]);
+    }
+    createToolSignature(toolCall) {
+        const args = typeof toolCall.arguments === 'object' && toolCall.arguments !== null
+            ? toolCall.arguments
+            : {};
+        const sortedArgs = Object.keys(args)
+            .sort()
+            .map((key) => `${key}:${JSON.stringify(args[key])}`)
+            .join(',');
+        return `${toolCall.name}(${sortedArgs})`;
+    }
+    getHistory() {
+        return [...this.toolCallHistory];
+    }
+    getHistoryLength() {
+        return this.toolCallHistory.length;
+    }
+}
+//# sourceMappingURL=loop-detector.js.map

package/dist/tools/loop-detector.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,21 @@
+import { ChatCompletionFunctionTool } from 'openai/resources/chat/completions';
+import { RuntimeConfig } from '../config/runtime-config';
+import { AgentTool } from './types';
+export type ToolResponse = {
+    name?: string;
+    response: string;
+    snapshot?: string | null;
+    status: 'success' | 'error';
+};
+export declare class ToolRegistry {
+    private readonly runtimeConfig;
+    private readonly tools;
+    private readonly toolsByName;
+    constructor(runtimeConfig: RuntimeConfig);
+    register(tool: AgentTool | AgentTool[]): void;
+    getRuntimeConfig(): RuntimeConfig;
+    resolve(toolName: string): AgentTool | undefined;
+    getTools(): Promise<ChatCompletionFunctionTool[]>;
+    private toOpenAiTool;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,SAAS,EAAe,MAAM,SAAS,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;CAC3B,CAAA;AAED,qBAAa,YAAY;IAIZ,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;gBAE9B,aAAa,EAAE,aAAa;IAEzD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,IAAI;IAc7C,gBAAgB,IAAI,aAAa;IAIjC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C,QAAQ,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAWvD,OAAO,CAAC,YAAY;CAWpB"}