@nexus-cortex/types 4.26.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,2 @@
+Nexus Cortex
+Copyright 2026 Spitfire-Products

package/README.md

@@ -0,0 +1,13 @@
+# @nexus-cortex/types
+
+Shared TypeScript types for Nexus Cortex - breaks circular dependency between core and executors
+
+Part of **[Nexus Cortex](https://github.com/Spitfire-Products/nexus-cortex)** — a multi-provider AI agent harness (direct library, optional HTTP server, terminal UIs).
+
+```bash
+npm install @nexus-cortex/types
+```
+
+See the [main README](https://github.com/Spitfire-Products/nexus-cortex#readme) for usage, architecture, and the full package list.
+
+Apache-2.0 © Spitfire-Products

package/dist/adapters.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Adapter Interface Type Definitions
+ *
+ * @packageDocumentation
+ * @module @nexus-cortex/types/adapters
+ *
+ * This module contains adapter interface types for the Nexus Cortex system.
+ * These are contract definitions for bidirectional conversion between canonical
+ * and provider-specific formats.
+ *
+ * Phase 1.5: Multi-Provider Architecture
+ */
+import type { CanonicalTool, CanonicalToolUse, CanonicalToolResult } from './tools';
+import type { CanonicalMessage } from './messages';
+import type { ModelConfig } from './models';
+/**
+ * FormatAdapter Interface
+ *
+ * Bidirectional conversion between canonical and provider-specific formats.
+ *
+ * Each adapter handles one API pattern:
+ * - GeminiGenerativeAIToolsAdapter: parametersJsonSchema, snake_case
+ * - AnthropicMessagesToolsAdapter: input_schema, snake_case
+ * - OpenAIFunctionsToolsAdapter: parameters, PascalCase/snake_case
+ */
+export interface FormatAdapter {
+    /**
+     * Adapter name (matches ModelConfig.tools.adapter)
+     */
+    readonly name: string;
+    /**
+     * API patterns this adapter supports
+     */
+    readonly apiPatterns: string[];
+    /**
+     * Convert canonical messages to provider-specific format
+     *
+     * @param messages - Canonical messages
+     * @param modelConfig - Model configuration
+     * @returns Provider-specific message format
+     */
+    toProviderMessages(messages: CanonicalMessage[], modelConfig: ModelConfig): unknown[];
+    /**
+     * Convert provider-specific messages to canonical format
+     *
+     * @param providerMessages - Provider-specific messages
+     * @param modelConfig - Model configuration
+     * @param sessionContext - Session context for timeline tracking
+     * @returns Canonical messages
+     */
+    fromProviderMessages(providerMessages: unknown[], modelConfig: ModelConfig, sessionContext: {
+        sessionId: string;
+        conversationId: string;
+        turnNumber: number;
+    }): CanonicalMessage[];
+    /**
+     * Convert canonical tools to provider-specific format
+     *
+     * @param tools - Canonical tool definitions
+     * @param modelConfig - Model configuration (for naming convention, etc.)
+     * @returns Provider-specific tool format
+     */
+    toProviderTools(tools: CanonicalTool[], modelConfig: ModelConfig): unknown[];
+    /**
+     * Convert provider-specific tools to canonical format
+     *
+     * @param providerTools - Provider-specific tool definitions
+     * @param modelConfig - Model configuration
+     * @returns Canonical tool definitions
+     */
+    fromProviderTools(providerTools: unknown[], modelConfig: ModelConfig): CanonicalTool[];
+    /**
+     * Convert canonical tool use to provider-specific format
+     *
+     * @param toolUse - Canonical tool use
+     * @param modelConfig - Model configuration
+     * @returns Provider-specific tool use format
+     */
+    toProviderToolUse(toolUse: CanonicalToolUse, modelConfig: ModelConfig): unknown;
+    /**
+     * Convert provider-specific tool use to canonical format
+     *
+     * @param providerToolUse - Provider-specific tool use
+     * @param modelConfig - Model configuration
+     * @returns Canonical tool use
+     */
+    fromProviderToolUse(providerToolUse: unknown, modelConfig: ModelConfig): CanonicalToolUse;
+    /**
+     * Convert canonical tool result to provider-specific format
+     *
+     * @param toolResult - Canonical tool result
+     * @param modelConfig - Model configuration
+     * @returns Provider-specific tool result format
+     */
+    toProviderToolResult(toolResult: CanonicalToolResult, modelConfig: ModelConfig): unknown;
+    /**
+     * Convert provider-specific tool result to canonical format
+     *
+     * @param providerToolResult - Provider-specific tool result
+     * @param modelConfig - Model configuration
+     * @returns Canonical tool result
+     */
+    fromProviderToolResult(providerToolResult: unknown, modelConfig: ModelConfig): CanonicalToolResult;
+    /**
+     * Validate tool schema for this adapter
+     *
+     * @param tool - Tool to validate
+     * @param modelConfig - Model configuration
+     * @returns Validation result with errors if invalid
+     */
+    validateTool(tool: CanonicalTool, modelConfig: ModelConfig): {
+        valid: boolean;
+        errors?: string[];
+    };
+    /**
+     * Get maximum number of tools supported
+     *
+     * @param modelConfig - Model configuration
+     * @returns Maximum tool count (or Infinity if unlimited)
+     */
+    getMaxTools(modelConfig: ModelConfig): number;
+    /**
+     * Check if parallel tool calls are supported
+     *
+     * @param modelConfig - Model configuration
+     * @returns true if parallel tool calls supported
+     */
+    supportsParallelToolCalls(modelConfig: ModelConfig): boolean;
+}
+/**
+ * Adapter Registry Interface
+ *
+ * Registry for managing format adapters.
+ */
+export interface AdapterRegistry {
+    /**
+     * Register a format adapter
+     *
+     * @param adapter - The adapter to register
+     */
+    registerAdapter(adapter: FormatAdapter): void;
+    /**
+     * Get an adapter by name
+     *
+     * @param adapterName - Adapter name
+     * @returns The adapter
+     * @throws Error if adapter not found
+     */
+    getAdapter(adapterName: string): FormatAdapter;
+    /**
+     * Get adapter for model
+     *
+     * @param modelConfig - Model configuration
+     * @returns Adapter implementation
+     * @throws Error if adapter not found
+     */
+    getAdapterForModel(modelConfig: ModelConfig): FormatAdapter;
+    /**
+     * Check if an adapter is registered
+     *
+     * @param adapterName - Adapter name
+     * @returns true if the adapter is registered
+     */
+    hasAdapter(adapterName: string): boolean;
+    /**
+     * List all registered adapter names
+     *
+     * @returns Array of adapter names
+     */
+    listAdapters(): string[];
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;;OAMG;IACH,kBAAkB,CAChB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,WAAW,EAAE,WAAW,GACvB,OAAO,EAAE,CAAC;IAEb;;;;;;;OAOG;IACH,oBAAoB,CAClB,gBAAgB,EAAE,OAAO,EAAE,EAC3B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,GACA,gBAAgB,EAAE,CAAC;IAEtB;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,EAAE,CAAC;IAEb;;;;;;OAMG;IACH,iBAAiB,CACf,aAAa,EAAE,OAAO,EAAE,EACxB,WAAW,EAAE,WAAW,GACvB,aAAa,EAAE,CAAC;IAEnB;;;;;;OAMG;IACH,iBAAiB,CACf,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAEX;;;;;;OAMG;IACH,mBAAmB,CACjB,eAAe,EAAE,OAAO,EACxB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CAAC;IAEpB;;;;;;OAMG;IACH,oBAAoB,CAClB,UAAU,EAAE,mBAAmB,EAC/B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAEX;;;;;;OAMG;IACH,sBAAsB,CACpB,kBAAkB,EAAE,OAAO,EAC3B,WAAW,EAAE,WAAW,GACvB,mBAAmB,CAAC;IAEvB;;;;;;OAMG;IACH,YAAY,CACV,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,WAAW,GACvB;QACD,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC;IAE9C;;;;;OAKG;IACH,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;CAC9D;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAE9C;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC;IAE/C;;;;;;OAMG;IACH,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IAE5D;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzC;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE,CAAC;CAC1B"}

package/dist/adapters.js

@@ -0,0 +1,14 @@
+/**
+ * Adapter Interface Type Definitions
+ *
+ * @packageDocumentation
+ * @module @nexus-cortex/types/adapters
+ *
+ * This module contains adapter interface types for the Nexus Cortex system.
+ * These are contract definitions for bidirectional conversion between canonical
+ * and provider-specific formats.
+ *
+ * Phase 1.5: Multi-Provider Architecture
+ */
+export {};
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/historical.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Historical Tool Types
+ *
+ * Type definitions for historical context and conversation tools.
+ * Extracted from @nexus-cortex/core to eliminate circular dependencies.
+ *
+ * These types are COPIED from the core implementations to maintain compatibility.
+ */
+/**
+ * Input schema for GetConversationSegment tool
+ */
+export interface GetConversationSegmentInput {
+    /** Turn range to retrieve */
+    turnRange?: {
+        start: number;
+        end: number;
+    };
+    /** Checkpoint ID to retrieve from */
+    checkpointId?: string;
+    /** Format of the returned segment */
+    format?: 'full' | 'summary' | 'compressed';
+}
+/**
+ * Conversation segment result
+ * NOTE: Uses 'any' for messages to avoid circular dependency with Message types
+ */
+export interface ConversationSegment {
+    /** Messages in the segment (if full format) */
+    messages?: any[];
+    /** Summary of the segment (if summary/compressed format) */
+    summary?: string;
+    /** Metadata about the segment */
+    metadata: {
+        /** Total estimated tokens in segment */
+        totalTokens: number;
+        /** Turn range of the segment */
+        turnRange: {
+            start: number;
+            end: number;
+        };
+        /** Whether segment includes compacted messages */
+        hasCompactions: boolean;
+        /** Number of messages in segment */
+        messageCount: number;
+    };
+}
+/**
+ * Input schema for ListCompactionBoundaries tool
+ */
+export interface ListCompactionBoundariesInput {
+    /** Include detailed metadata in response */
+    includeMetadata?: boolean;
+}
+/**
+ * Compaction boundary information
+ */
+export interface CompactionBoundary {
+    /** Unique identifier for the compaction */
+    id: string;
+    /** Timestamp when compaction occurred */
+    timestamp: Date;
+    /** Turn range that was compacted */
+    turnRange: {
+        start: number;
+        end: number;
+    };
+    /** Token counts */
+    tokens: {
+        /** Original token count before compaction */
+        original: number;
+        /** Compressed token count after compaction */
+        compressed: number;
+        /** Tokens saved by compaction */
+        saved: number;
+    };
+    /** Type of compaction */
+    type: 'auto' | 'manual' | 'helper-fallback';
+    /** Optional metadata if requested */
+    metadata?: {
+        /** Topics covered in this segment */
+        topics: string[];
+        /** Main decisions or outcomes */
+        decisions: string[];
+        /** Tools used in this segment */
+        toolsUsed: string[];
+        /** Model used for compaction */
+        helperModel: string;
+        /** Cost of compaction operation */
+        cost: number;
+        /** Summary of the compacted section */
+        summary: string;
+    };
+}
+/**
+ * Input schema for RequestHistoricalContext tool
+ */
+export interface RequestHistoricalContextInput {
+    /** Query describing what historical context is needed */
+    query: string;
+    /** Detail level for the response */
+    detailLevel?: 'brief' | 'standard' | 'detailed';
+    /** Maximum tokens for the response */
+    maxTokens?: number;
+    /** Whether to use helper model (vs main model) */
+    useHelperModel?: boolean;
+}
+/**
+ * Historical context result
+ */
+export interface HistoricalContextResult {
+    /** Generated context based on the query */
+    context: string;
+    /** Sources used to generate the context */
+    sources: Array<{
+        /** Turn number in conversation */
+        turnNumber: number;
+        /** Timestamp of the source */
+        timestamp: Date;
+        /** Whether source is from compacted section */
+        isCompacted: boolean;
+        /** Compaction ID if applicable */
+        compactionId?: string;
+    }>;
+    /** Estimated tokens used */
+    tokensUsed: number;
+    /** Model used to generate context */
+    modelUsed: string;
+    /** Processing cost (usually $0 for Gemma) */
+    cost: number;
+    /** Processing time in milliseconds */
+    processingTime: number;
+}
+/**
+ * Input schema for SearchConversationHistory tool
+ */
+export interface SearchConversationHistoryInput {
+    /** Search query string */
+    query: string;
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Time range filter */
+    timeRange?: {
+        start: Date;
+        end: Date;
+    };
+    /** Include compacted messages in search */
+    includeCompacted?: boolean;
+}
+/**
+ * Search result from conversation history
+ */
+export interface SearchResult {
+    /** Session ID this result came from */
+    sessionId: string;
+    /** Turn number in conversation */
+    turnNumber: number;
+    /** Timestamp of the message */
+    timestamp: Date;
+    /** Preview of the content */
+    preview: string;
+    /** Relevance score (0-100) */
+    relevanceScore: number;
+    /** Whether this result is from a compacted section */
+    isCompacted: boolean;
+    /** Compaction ID if applicable */
+    compactionId?: string;
+    /** Message ID */
+    messageId?: string;
+}
+/**
+ * Input schema for ListSessions tool
+ */
+export interface ListSessionsInput {
+    /** Maximum number of sessions to return (default: 50) */
+    limit?: number;
+    /** Filter by minimum age in days */
+    minAgeDays?: number;
+    /** Filter by maximum age in days */
+    maxAgeDays?: number;
+    /** Sort order: 'newest' or 'oldest' */
+    sortBy?: 'newest' | 'oldest';
+}
+/**
+ * Session summary information
+ */
+export interface SessionSummary {
+    /** Unique session identifier */
+    sessionId: string;
+    /** When session was created */
+    createdAt: string;
+    /** Last activity timestamp */
+    lastModified: string;
+    /** Number of messages in session */
+    messageCount: number;
+    /** File size in bytes */
+    fileSize: number;
+    /** Number of compactions in this session */
+    compactionCount: number;
+    /** Age in days */
+    ageDays: number;
+    /** Auto-generated session title (from helper model) */
+    title?: string;
+}
+/**
+ * Input schema for LoadSession tool
+ */
+export interface LoadSessionInput {
+    /** Session ID to load */
+    sessionId: string;
+    /** Maximum number of messages to return (default: 100) */
+    limit?: number;
+    /** Start from message offset (for pagination) */
+    offset?: number;
+    /** Include system messages */
+    includeSystemMessages?: boolean;
+}
+/**
+ * Session load result
+ */
+export interface SessionLoadResult {
+    /** Session ID */
+    sessionId: string;
+    /** Messages from the session */
+    messages: any[];
+    /** Total message count in session */
+    totalMessageCount: number;
+    /** Number of messages returned */
+    returnedMessageCount: number;
+    /** Whether there are more messages */
+    hasMore: boolean;
+    /** Session metadata */
+    metadata: {
+        createdAt: string;
+        lastModified: string;
+        compactionCount: number;
+    };
+}
+//# sourceMappingURL=historical.d.ts.map

package/dist/historical.d.ts.map

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

package/dist/historical.js

@@ -0,0 +1,10 @@
+/**
+ * Historical Tool Types
+ *
+ * Type definitions for historical context and conversation tools.
+ * Extracted from @nexus-cortex/core to eliminate circular dependencies.
+ *
+ * These types are COPIED from the core implementations to maintain compatibility.
+ */
+export {};
+//# sourceMappingURL=historical.js.map

package/dist/historical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical.js","sourceRoot":"","sources":["../src/historical.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}