@agntk/core 0.1.0

package/dist/tools/browser/types.d.ts

@@ -0,0 +1,216 @@
+/**
+ * @fileoverview Types and Zod schemas for the browser tool.
+ * Wraps the agent-browser CLI with typed action schemas.
+ */
+import { z } from 'zod';
+export declare const browserInputSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<"open">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "open";
+    url: string;
+}, {
+    action: "open";
+    url: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"snapshot">;
+    interactive: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    action: "snapshot";
+    interactive?: boolean | undefined;
+}, {
+    action: "snapshot";
+    interactive?: boolean | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"click">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "click";
+    selector: string;
+}, {
+    action: "click";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"dblclick">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "dblclick";
+    selector: string;
+}, {
+    action: "dblclick";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"fill">;
+    selector: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    action: "fill";
+    selector: string;
+}, {
+    text: string;
+    action: "fill";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"type">;
+    selector: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    action: "type";
+    selector: string;
+}, {
+    text: string;
+    action: "type";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"select">;
+    selector: z.ZodString;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    action: "select";
+    selector: string;
+}, {
+    value: string;
+    action: "select";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"press">;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "press";
+    key: string;
+}, {
+    action: "press";
+    key: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"hover">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "hover";
+    selector: string;
+}, {
+    action: "hover";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"scroll">;
+    direction: z.ZodEnum<["up", "down", "left", "right"]>;
+    pixels: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    action: "scroll";
+    direction: "up" | "down" | "left" | "right";
+    pixels?: number | undefined;
+}, {
+    action: "scroll";
+    direction: "up" | "down" | "left" | "right";
+    pixels?: number | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"screenshot">;
+    path: z.ZodOptional<z.ZodString>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    action: "screenshot";
+    path?: string | undefined;
+    fullPage?: boolean | undefined;
+}, {
+    action: "screenshot";
+    path?: string | undefined;
+    fullPage?: boolean | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"getText">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "getText";
+    selector: string;
+}, {
+    action: "getText";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"getUrl">;
+}, "strip", z.ZodTypeAny, {
+    action: "getUrl";
+}, {
+    action: "getUrl";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"getTitle">;
+}, "strip", z.ZodTypeAny, {
+    action: "getTitle";
+}, {
+    action: "getTitle";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"wait">;
+    selector: z.ZodOptional<z.ZodString>;
+    ms: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "wait";
+    text?: string | undefined;
+    url?: string | undefined;
+    selector?: string | undefined;
+    ms?: number | undefined;
+    load?: "load" | "domcontentloaded" | "networkidle" | undefined;
+}, {
+    action: "wait";
+    text?: string | undefined;
+    url?: string | undefined;
+    selector?: string | undefined;
+    ms?: number | undefined;
+    load?: "load" | "domcontentloaded" | "networkidle" | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"eval">;
+    js: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "eval";
+    js: string;
+}, {
+    action: "eval";
+    js: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"check">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "check";
+    selector: string;
+}, {
+    action: "check";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"uncheck">;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "uncheck";
+    selector: string;
+}, {
+    action: "uncheck";
+    selector: string;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"close">;
+}, "strip", z.ZodTypeAny, {
+    action: "close";
+}, {
+    action: "close";
+}>]>;
+export type BrowserInput = z.infer<typeof browserInputSchema>;
+export type BrowserAction = BrowserInput['action'];
+export interface BrowserResult {
+    output: string;
+    exitCode: number;
+    action: BrowserAction;
+    durationMs: number;
+}
+export interface BrowserConfig {
+    /** Timeout for browser commands in ms. Default: 30000 */
+    timeout?: number;
+    /** Session name for persistent browser state */
+    session?: string;
+    /** Connect to a remote browser via CDP URL */
+    cdpUrl?: string;
+    /** Headless mode. Default: true */
+    headless?: boolean;
+}
+export declare const BROWSER_ACTIONS: readonly ["open", "snapshot", "click", "dblclick", "fill", "type", "select", "press", "hover", "scroll", "screenshot", "getText", "getUrl", "getTitle", "wait", "eval", "check", "uncheck", "close"];
+export declare const BROWSER_TOOL_DESCRIPTION = "Browse the web, interact with pages, and extract content using the agent-browser CLI.\n\nAvailable actions:\n- open: Navigate to a URL\n- snapshot: Get page accessibility tree with element refs (@e1, @e2...)\n- click/dblclick: Click elements by ref or selector\n- fill: Clear and fill input fields\n- type: Type text into elements\n- select: Choose dropdown options\n- press: Press keyboard keys\n- hover: Hover over elements\n- scroll: Scroll the page\n- screenshot: Capture page screenshot\n- getText: Extract text content from elements\n- getUrl/getTitle: Get current page URL or title\n- wait: Wait for elements, text, URL patterns, or time\n- eval: Run JavaScript in the page\n- check/uncheck: Toggle checkboxes\n- close: Close the browser\n\nWorkflow: open URL \u2192 snapshot to see refs \u2192 interact using refs \u2192 close.";
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/browser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsHxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAMnD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,sMAIlB,CAAC;AAEX,eAAO,MAAM,wBAAwB,w0BAoBoC,CAAC"}

package/dist/tools/browser/types.js

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Types and Zod schemas for the browser tool.
+ * Wraps the agent-browser CLI with typed action schemas.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Selector Description (shared across actions)
+// ============================================================================
+const selectorDesc = 'Element selector: ref (@e1), CSS (.class), or text ("Submit")';
+// ============================================================================
+// Action Schemas (discriminated union on `action`)
+// ============================================================================
+const openSchema = z.object({
+    action: z.literal('open'),
+    url: z.string().describe('URL to navigate to'),
+});
+const snapshotSchema = z.object({
+    action: z.literal('snapshot'),
+    interactive: z.boolean().optional().describe('Only show interactive elements (-i flag)'),
+});
+const clickSchema = z.object({
+    action: z.literal('click'),
+    selector: z.string().describe(selectorDesc),
+});
+const dblclickSchema = z.object({
+    action: z.literal('dblclick'),
+    selector: z.string().describe(selectorDesc),
+});
+const fillSchema = z.object({
+    action: z.literal('fill'),
+    selector: z.string().describe(selectorDesc),
+    text: z.string().describe('Text to fill into the element'),
+});
+const typeSchema = z.object({
+    action: z.literal('type'),
+    selector: z.string().describe(selectorDesc),
+    text: z.string().describe('Text to type into the element'),
+});
+const selectSchema = z.object({
+    action: z.literal('select'),
+    selector: z.string().describe(selectorDesc),
+    value: z.string().describe('Option value to select'),
+});
+const pressSchema = z.object({
+    action: z.literal('press'),
+    key: z.string().describe('Key to press (Enter, Tab, Control+a, etc.)'),
+});
+const hoverSchema = z.object({
+    action: z.literal('hover'),
+    selector: z.string().describe(selectorDesc),
+});
+const scrollSchema = z.object({
+    action: z.literal('scroll'),
+    direction: z.enum(['up', 'down', 'left', 'right']).describe('Scroll direction'),
+    pixels: z.number().optional().describe('Pixels to scroll (default: viewport)'),
+});
+const screenshotSchema = z.object({
+    action: z.literal('screenshot'),
+    path: z.string().optional().describe('File path for screenshot (default: auto-generated)'),
+    fullPage: z.boolean().optional().describe('Capture full page instead of viewport'),
+});
+const getTextSchema = z.object({
+    action: z.literal('getText'),
+    selector: z.string().describe(selectorDesc),
+});
+const getUrlSchema = z.object({
+    action: z.literal('getUrl'),
+});
+const getTitleSchema = z.object({
+    action: z.literal('getTitle'),
+});
+const waitSchema = z.object({
+    action: z.literal('wait'),
+    selector: z.string().optional().describe('Wait for element to appear'),
+    ms: z.number().optional().describe('Wait for milliseconds'),
+    text: z.string().optional().describe('Wait for text to appear on page'),
+    url: z.string().optional().describe('Wait for URL pattern'),
+    load: z.enum(['load', 'domcontentloaded', 'networkidle']).optional()
+        .describe('Wait for page load state'),
+});
+const evalSchema = z.object({
+    action: z.literal('eval'),
+    js: z.string().describe('JavaScript code to evaluate in the page'),
+});
+const checkSchema = z.object({
+    action: z.literal('check'),
+    selector: z.string().describe(selectorDesc),
+});
+const uncheckSchema = z.object({
+    action: z.literal('uncheck'),
+    selector: z.string().describe(selectorDesc),
+});
+const closeSchema = z.object({
+    action: z.literal('close'),
+});
+// ============================================================================
+// Combined Input Schema
+// ============================================================================
+export const browserInputSchema = z.discriminatedUnion('action', [
+    openSchema,
+    snapshotSchema,
+    clickSchema,
+    dblclickSchema,
+    fillSchema,
+    typeSchema,
+    selectSchema,
+    pressSchema,
+    hoverSchema,
+    scrollSchema,
+    screenshotSchema,
+    getTextSchema,
+    getUrlSchema,
+    getTitleSchema,
+    waitSchema,
+    evalSchema,
+    checkSchema,
+    uncheckSchema,
+    closeSchema,
+]);
+export const BROWSER_ACTIONS = [
+    'open', 'snapshot', 'click', 'dblclick', 'fill', 'type', 'select',
+    'press', 'hover', 'scroll', 'screenshot', 'getText', 'getUrl',
+    'getTitle', 'wait', 'eval', 'check', 'uncheck', 'close',
+];
+export const BROWSER_TOOL_DESCRIPTION = `Browse the web, interact with pages, and extract content using the agent-browser CLI.
+
+Available actions:
+- open: Navigate to a URL
+- snapshot: Get page accessibility tree with element refs (@e1, @e2...)
+- click/dblclick: Click elements by ref or selector
+- fill: Clear and fill input fields
+- type: Type text into elements
+- select: Choose dropdown options
+- press: Press keyboard keys
+- hover: Hover over elements
+- scroll: Scroll the page
+- screenshot: Capture page screenshot
+- getText: Extract text content from elements
+- getUrl/getTitle: Get current page URL or title
+- wait: Wait for elements, text, URL patterns, or time
+- eval: Run JavaScript in the page
+- check/uncheck: Toggle checkboxes
+- close: Close the browser
+
+Workflow: open URL → snapshot to see refs → interact using refs → close.`;
+//# sourceMappingURL=types.js.map

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

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

package/dist/tools/deep-reasoning/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deep reasoning tool constants
+ */
+export declare const DEEP_REASONING_DESCRIPTION = "Think through complex problems step-by-step with deep reasoning. \nUse when you need to analyze, debug, or understand something before acting.\n\nWhen to use:\n- Complex debugging or troubleshooting\n- Architectural decisions\n- Understanding unfamiliar code\n- Multi-step problem solving\n- When you need to think before acting\n\nHow to use:\nCall repeatedly with your reasoning steps. Each call records one thought.\n- thought: Your current reasoning step - one clear idea or observation\n- thoughtNumber: Current step number (1, 2, 3...)\n- totalThoughts: Estimate of steps needed (adjustable as you go)\n- nextThoughtNeeded: true to continue reasoning, false when done\n\nAdvanced features:\n- isRevision + revisesThought: Reconsider an earlier thought\n- branchFromThought + branchId: Explore alternative reasoning paths\n\nYou can use other tools between thoughts to gather information.\nNOT for task tracking\u2014use plan tool for that.";
+export declare const DEFAULT_MAX_HISTORY = 1000;
+export declare const DEFAULT_MAX_BRANCH_SIZE = 100;
+/**
+ * When enabled, the agent uses unlimited step reasoning by default
+ */
+export declare const UNRESTRICTED_MODE_DESCRIPTION = "Deep reasoning mode is ENABLED. \nYou have unlimited thinking steps - use as many as needed to fully analyze the problem.\nThere are no step restrictions. Think deeply and thoroughly.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/deep-reasoning/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,0BAA0B,s7BAsBO,CAAC;AAE/C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,6BAA6B,4LAEmB,CAAC"}

package/dist/tools/deep-reasoning/constants.js

@@ -0,0 +1,35 @@
+/**
+ * Deep reasoning tool constants
+ */
+export const DEEP_REASONING_DESCRIPTION = `Think through complex problems step-by-step with deep reasoning. 
+Use when you need to analyze, debug, or understand something before acting.
+
+When to use:
+- Complex debugging or troubleshooting
+- Architectural decisions
+- Understanding unfamiliar code
+- Multi-step problem solving
+- When you need to think before acting
+
+How to use:
+Call repeatedly with your reasoning steps. Each call records one thought.
+- thought: Your current reasoning step - one clear idea or observation
+- thoughtNumber: Current step number (1, 2, 3...)
+- totalThoughts: Estimate of steps needed (adjustable as you go)
+- nextThoughtNeeded: true to continue reasoning, false when done
+
+Advanced features:
+- isRevision + revisesThought: Reconsider an earlier thought
+- branchFromThought + branchId: Explore alternative reasoning paths
+
+You can use other tools between thoughts to gather information.
+NOT for task tracking—use plan tool for that.`;
+export const DEFAULT_MAX_HISTORY = 1000;
+export const DEFAULT_MAX_BRANCH_SIZE = 100;
+/**
+ * When enabled, the agent uses unlimited step reasoning by default
+ */
+export const UNRESTRICTED_MODE_DESCRIPTION = `Deep reasoning mode is ENABLED. 
+You have unlimited thinking steps - use as many as needed to fully analyze the problem.
+There are no step restrictions. Think deeply and thoroughly.`;
+//# sourceMappingURL=constants.js.map

package/dist/tools/deep-reasoning/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;8CAsBI,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;;6DAEgB,CAAC"}

package/dist/tools/deep-reasoning/engine.d.ts

@@ -0,0 +1,20 @@
+import type { ThoughtData, ReasoningResult, DeepReasoningConfig } from './types.js';
+export declare class DeepReasoningEngine {
+    private thoughtHistory;
+    private branches;
+    private maxHistorySize;
+    private maxBranchSize;
+    constructor(options?: {
+        maxHistorySize?: number;
+        maxBranchSize?: number;
+    });
+    processThought(input: ThoughtData): ReasoningResult;
+    getHistory(): ThoughtData[];
+    getBranches(): Record<string, ThoughtData[]>;
+    reset(): void;
+}
+export declare function configureDeepReasoning(config: DeepReasoningConfig): void;
+export declare function isDeepReasoningEnabled(): boolean;
+export declare function getDeepReasoningEngine(): DeepReasoningEngine;
+export declare function resetDeepReasoningEngine(): void;
+//# sourceMappingURL=engine.d.ts.map

package/dist/tools/deep-reasoning/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO;IAK7E,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe;IAkCnD,UAAU,IAAI,WAAW,EAAE;IAI3B,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAI5C,KAAK,IAAI,IAAI;CAId;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAWxE;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/tools/deep-reasoning/engine.js

@@ -0,0 +1,77 @@
+import { DEFAULT_MAX_HISTORY, DEFAULT_MAX_BRANCH_SIZE } from './constants.js';
+export class DeepReasoningEngine {
+    thoughtHistory = [];
+    branches = {};
+    maxHistorySize;
+    maxBranchSize;
+    constructor(options = {}) {
+        this.maxHistorySize = options.maxHistorySize ?? DEFAULT_MAX_HISTORY;
+        this.maxBranchSize = options.maxBranchSize ?? DEFAULT_MAX_BRANCH_SIZE;
+    }
+    processThought(input) {
+        if (input.thoughtNumber > input.totalThoughts) {
+            input.totalThoughts = input.thoughtNumber;
+        }
+        this.thoughtHistory.push(input);
+        if (this.thoughtHistory.length > this.maxHistorySize) {
+            this.thoughtHistory.shift();
+        }
+        if (input.branchFromThought && input.branchId) {
+            if (!this.branches[input.branchId]) {
+                this.branches[input.branchId] = [];
+            }
+            const branch = this.branches[input.branchId];
+            if (branch) {
+                branch.push(input);
+                if (branch.length > this.maxBranchSize) {
+                    branch.shift();
+                }
+            }
+        }
+        return {
+            thoughtNumber: input.thoughtNumber,
+            totalThoughts: input.totalThoughts,
+            nextThoughtNeeded: input.nextThoughtNeeded,
+            branches: Object.keys(this.branches),
+            thoughtHistoryLength: this.thoughtHistory.length,
+        };
+    }
+    getHistory() {
+        return [...this.thoughtHistory];
+    }
+    getBranches() {
+        return { ...this.branches };
+    }
+    reset() {
+        this.thoughtHistory = [];
+        this.branches = {};
+    }
+}
+// Global configuration state
+let isEnabled = false;
+let globalEngine = null;
+export function configureDeepReasoning(config) {
+    isEnabled = config.enabled;
+    if (config.enabled) {
+        globalEngine = new DeepReasoningEngine({
+            maxHistorySize: config.maxHistorySize,
+            maxBranchSize: config.maxBranchSize,
+        });
+    }
+    else {
+        globalEngine = null;
+    }
+}
+export function isDeepReasoningEnabled() {
+    return isEnabled;
+}
+export function getDeepReasoningEngine() {
+    if (!globalEngine) {
+        globalEngine = new DeepReasoningEngine();
+    }
+    return globalEngine;
+}
+export function resetDeepReasoningEngine() {
+    globalEngine?.reset();
+}
+//# sourceMappingURL=engine.js.map

package/dist/tools/deep-reasoning/engine.js.map

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

package/dist/tools/deep-reasoning/index.d.ts

@@ -0,0 +1,5 @@
+export { createDeepReasoningTool } from './tools.js';
+export { DeepReasoningEngine, configureDeepReasoning, isDeepReasoningEnabled, getDeepReasoningEngine, resetDeepReasoningEngine, } from './engine.js';
+export type { ThoughtData, ReasoningResult, DeepReasoningConfig, DeepReasoningInput, } from './types.js';
+export { DEEP_REASONING_DESCRIPTION, UNRESTRICTED_MODE_DESCRIPTION, DEFAULT_MAX_HISTORY, DEFAULT_MAX_BRANCH_SIZE, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/deep-reasoning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/tools/deep-reasoning/index.js

@@ -0,0 +1,7 @@
+// Tool exports
+export { createDeepReasoningTool } from './tools.js';
+// Engine exports
+export { DeepReasoningEngine, configureDeepReasoning, isDeepReasoningEnabled, getDeepReasoningEngine, resetDeepReasoningEngine, } from './engine.js';
+// Constant exports
+export { DEEP_REASONING_DESCRIPTION, UNRESTRICTED_MODE_DESCRIPTION, DEFAULT_MAX_HISTORY, DEFAULT_MAX_BRANCH_SIZE, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/deep-reasoning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAUlB,mBAAmB;AACnB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/tools/deep-reasoning/tools.d.ts

@@ -0,0 +1,12 @@
+export declare function createDeepReasoningTool(): import("ai").Tool<{
+    thought: string;
+    nextThoughtNeeded: boolean;
+    thoughtNumber: number;
+    totalThoughts: number;
+    isRevision?: boolean | undefined;
+    revisesThought?: number | undefined;
+    branchFromThought?: number | undefined;
+    branchId?: string | undefined;
+    needsMoreThoughts?: boolean | undefined;
+}, string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools/deep-reasoning/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/tools.ts"],"names":[],"mappings":"AASA,wBAAgB,uBAAuB;;;;;;;;;;WAgBtC"}

package/dist/tools/deep-reasoning/tools.js

@@ -0,0 +1,23 @@
+import { tool } from 'ai';
+import { createLogger } from '@agntk/logger';
+import { DEEP_REASONING_DESCRIPTION, UNRESTRICTED_MODE_DESCRIPTION } from './constants.js';
+import { getDeepReasoningEngine, isDeepReasoningEnabled } from './engine.js';
+import { deepReasoningInputSchema } from './types.js';
+const log = createLogger('@agntk/core:reasoning');
+export function createDeepReasoningTool() {
+    const description = isDeepReasoningEnabled()
+        ? `${DEEP_REASONING_DESCRIPTION}\n\n${UNRESTRICTED_MODE_DESCRIPTION}`
+        : DEEP_REASONING_DESCRIPTION;
+    return tool({
+        description,
+        inputSchema: deepReasoningInputSchema,
+        execute: async (input) => {
+            log.debug('deep reasoning', { thought: input.thoughtNumber, total: input.totalThoughts });
+            const engine = getDeepReasoningEngine();
+            const result = engine.processThought(input);
+            log.debug('deep reasoning result', { nextNeeded: result.nextThoughtNeeded });
+            return JSON.stringify(result);
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools/deep-reasoning/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/tools/deep-reasoning/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAoB,MAAM,SAAS,CAAC;AAErE,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAElD,MAAM,UAAU,uBAAuB;IACrC,MAAM,WAAW,GAAG,sBAAsB,EAAE;QAC1C,CAAC,CAAC,GAAG,0BAA0B,OAAO,6BAA6B,EAAE;QACrE,CAAC,CAAC,0BAA0B,CAAC;IAE/B,OAAO,IAAI,CAAC;QACV,WAAW;QACX,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAG,KAAqB,CAAC,aAAa,EAAE,KAAK,EAAG,KAAqB,CAAC,aAAa,EAAE,CAAC,CAAC;YAC5H,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,KAAoB,CAAC,CAAC;YAC3D,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}