luca 1.1.2 → 3.0.0

package/dist/agi/features/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/agi/features/claude-code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,iBAAiB;QACzB,UAAU,EAAE,OAAO,UAAU,CAAA;KAC9B;CACF;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,WAAW,CAAA;QACjB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,IAAI,EAAE,UAAU,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,CAAA;SAAE,CAAC,CAAA;QAC3G,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,KAAK,EAAE;YACL,YAAY,EAAE,MAAM,CAAA;YACpB,aAAa,EAAE,MAAM,CAAA;YACrB,uBAAuB,CAAC,EAAE,MAAM,CAAA;YAChC,2BAA2B,CAAC,EAAE,MAAM,CAAA;SACrC,CAAA;KACF,CAAA;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,eAAe,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,eAAe,GAAG,cAAc,CAAA;QAC/H,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACvC,aAAa,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC/C,OAAO,CAAC,EAAE,GAAG,CAAA;QACb,KAAK,CAAC,EAAE,GAAG,CAAA;KACZ,CAAA;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,SAAS,GAAG,OAAO,CAAA;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,sBAAsB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA;AAIpK,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,sBAAsB,EAAE,CAAA;IAClC,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,CAAA;AAI3E,eAAO,MAAM,qBAAqB;;;;;;iBAShC,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;EAE9B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDlC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAaH,CAAA;AAEhC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAA;IACrF,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,0HAA0H;IAC1H,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC5C,oEAAoE;IACpE,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,yCAAyC;IACzC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,SAAQ,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC;IACzE,OAAgB,WAAW;;;;;;sBAAwB;IACnD,OAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAA0B;IACvD,OAAgB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAyB;IACrD,OAAgB,QAAQ,EAAG,qBAAqB,CAAS;IACzD,OAAgB,OAAO,WAAa;IAIpC,IAAa,YAAY,IAAI,eAAe,CAO3C;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAsB;IAEjD,IAAI,UAAU,IAAI,MAAM,CASvB;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAM/E;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQpD;;;;;;;;;;OAUG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IA6B3C,uDAAuD;IACvD,OAAO,CAAC,YAAY,CAAe;IAEnC,+CAA+C;IAC/C,OAAO,CAAC,eAAe,CAAgE;IAEvF;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;;;OAOG;YACW,aAAa;IAkB3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAS;IAajB;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAS/E;;;;;;OAMG;YACW,SAAS;IAmHvB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IASrB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAoEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IA0C3E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CtE;;;;;OAKG;YACW,aAAa;IAkG3B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB9B;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD;;;;;;;;;;;;OAYG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB/D;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;gBAYM,MAAM;qBAAW,MAAM;mBAAS,MAAM;yBAAe,MAAM;0BAAgB,MAAM;oBAAU,MAAM;;;IAuD/H;;;;;;;;;;;;OAYG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAWlC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBhE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkExB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;;;;;OAWG;IACG,mBAAmB,IAAI,OAAO,CAAC,KAAK,CAAC;QACzC,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,OAAO,CAAA;KACf,CAAC,CAAC;IAmCH;;;;;;;;;OASG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5C,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAA;KACnB,GAAG,IAAI,CAAC;IAWT;;;;;;;;;;;;;;;OAeG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAiB7E;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QACpD,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAC,CAAC;IA+BH;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1C;;;;;OAKG;IACY,MAAM,CAAC,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxD;AAED,eAAe,UAAU,CAAA"}

package/dist/agi/features/conversation-history.d.ts

@@ -0,0 +1,245 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { DiskCache } from '@soederpop/luca/node/container';
+import type { Message } from './conversation';
+declare module '@soederpop/luca/feature' {
+    interface AvailableFeatures {
+        conversationHistory: typeof ConversationHistory;
+    }
+}
+export interface ConversationRecord {
+    id: string;
+    title: string;
+    model: string;
+    messages: Message[];
+    tags: string[];
+    thread: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+    metadata: Record<string, any>;
+}
+export type ConversationMeta = Omit<ConversationRecord, 'messages'>;
+export interface SearchOptions {
+    tag?: string;
+    tags?: string[];
+    thread?: string;
+    model?: string;
+    before?: string | Date;
+    after?: string | Date;
+    query?: string;
+    limit?: number;
+    offset?: number;
+}
+export declare const ConversationHistoryOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    cachePath: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ConversationHistoryStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    conversationCount: z.ZodNumber;
+    lastSaved: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const ConversationHistoryEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    saved: z.ZodTuple<[z.ZodString], null>;
+    deleted: z.ZodTuple<[z.ZodString], null>;
+}, z.core.$strip>;
+export type ConversationHistoryOptions = z.infer<typeof ConversationHistoryOptionsSchema>;
+export type ConversationHistoryState = z.infer<typeof ConversationHistoryStateSchema>;
+/**
+ * Persists conversations to disk using the diskCache feature (cacache).
+ * Each conversation is stored as a JSON blob keyed by ID, with metadata
+ * stored alongside for efficient listing and search without loading full message arrays.
+ *
+ * @extends Feature
+ *
+ * @example
+ * ```typescript
+ * const history = container.feature('conversationHistory', {
+ *   namespace: 'my-app',
+ *   cachePath: '/tmp/conversations'
+ * })
+ *
+ * // Create and retrieve conversations
+ * const record = await history.create({ messages, title: 'My Chat' })
+ * const loaded = await history.load(record.id)
+ *
+ * // Search and filter
+ * const results = await history.search({ tag: 'important', limit: 10 })
+ * ```
+ */
+export declare class ConversationHistory extends Feature<ConversationHistoryState, ConversationHistoryOptions> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        conversationCount: z.ZodNumber;
+        lastSaved: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        cachePath: z.ZodOptional<z.ZodString>;
+        namespace: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        saved: z.ZodTuple<[z.ZodString], null>;
+        deleted: z.ZodTuple<[z.ZodString], null>;
+    }, z.core.$strip>;
+    static shortcut: "features.conversationHistory";
+    /** @returns Default state with zero conversations and no last-saved timestamp. */
+    get initialState(): ConversationHistoryState;
+    /** @returns The diskCache feature instance used for persistence, configured with the optional cachePath. */
+    get diskCache(): DiskCache;
+    /** @returns The namespace prefix used for all cache keys, defaults to 'conversation-history'. */
+    get namespace(): string;
+    private buildCacheKey;
+    private metaKey;
+    private indexKey;
+    /**
+     * Save a conversation. Creates or overwrites by ID.
+     *
+     * @param {ConversationRecord} record - The full conversation record to persist
+     * @returns {Promise<void>}
+     */
+    save(record: ConversationRecord): Promise<void>;
+    /**
+     * Create a new conversation from messages, returning the saved record.
+     *
+     * @param {object} opts - Creation options including messages, optional title, model, tags, thread, and metadata
+     * @returns {Promise<ConversationRecord>} The newly created and persisted conversation record
+     */
+    create(opts: {
+        id?: string;
+        title?: string;
+        model?: string;
+        messages: Message[];
+        tags?: string[];
+        thread?: string;
+        metadata?: Record<string, any>;
+    }): Promise<ConversationRecord>;
+    /**
+     * Load a full conversation by ID, including all messages.
+     *
+     * @param {string} id - The conversation ID
+     * @returns {Promise<ConversationRecord | null>} The full record, or null if not found
+     */
+    load(id: string): Promise<ConversationRecord | null>;
+    /**
+     * Load just the metadata for a conversation (no messages).
+     *
+     * @param {string} id - The conversation ID
+     * @returns {Promise<ConversationMeta | null>} The lightweight metadata record, or null if not found
+     */
+    getMeta(id: string): Promise<ConversationMeta | null>;
+    /**
+     * Append messages to an existing conversation.
+     *
+     * @param {string} id - The conversation ID to append to
+     * @param {Message[]} messages - The messages to append
+     * @returns {Promise<ConversationRecord | null>} The updated record, or null if the conversation was not found
+     */
+    append(id: string, messages: Message[]): Promise<ConversationRecord | null>;
+    /**
+     * Delete a conversation by ID.
+     *
+     * @param {string} id - The conversation ID to delete
+     * @returns {Promise<boolean>} True if the conversation existed and was deleted
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * List all conversation metadata, with optional search/filter.
+     * Loads only the lightweight meta records, never the full messages.
+     *
+     * @param {SearchOptions} [options] - Optional filters for tag, thread, model, date range, and text query
+     * @returns {Promise<ConversationMeta[]>} Filtered and sorted metadata records (newest first)
+     */
+    list(options?: SearchOptions): Promise<ConversationMeta[]>;
+    /**
+     * Search conversations by text query across titles, tags, and metadata.
+     * Also supports filtering by tag, thread, model, and date range.
+     *
+     * @param {SearchOptions} options - Search and filter criteria
+     * @returns {Promise<ConversationMeta[]>} Matching metadata records (newest first)
+     */
+    search(options: SearchOptions): Promise<ConversationMeta[]>;
+    /**
+     * Get all unique tags across all conversations.
+     *
+     * @returns {Promise<string[]>} Sorted array of unique tag strings
+     */
+    allTags(): Promise<string[]>;
+    /**
+     * Get all unique threads across all conversations.
+     *
+     * @returns {Promise<string[]>} Sorted array of unique thread identifiers
+     */
+    allThreads(): Promise<string[]>;
+    /**
+     * Tag a conversation. Adds tags without duplicates.
+     *
+     * @param {string} id - The conversation ID
+     * @param {...string} tags - One or more tags to add
+     * @returns {Promise<boolean>} True if the conversation was found and updated
+     */
+    tag(id: string, ...tags: string[]): Promise<boolean>;
+    /**
+     * Remove tags from a conversation.
+     *
+     * @param {string} id - The conversation ID
+     * @param {...string} tags - One or more tags to remove
+     * @returns {Promise<boolean>} True if the conversation was found and updated
+     */
+    untag(id: string, ...tags: string[]): Promise<boolean>;
+    /**
+     * Update metadata on a conversation without touching messages.
+     *
+     * @param {string} id - The conversation ID
+     * @param {object} updates - Partial updates for title, tags, thread, and/or metadata
+     * @returns {Promise<boolean>} True if the conversation was found and updated
+     */
+    updateMeta(id: string, updates: Partial<Pick<ConversationRecord, 'title' | 'tags' | 'thread' | 'metadata'>>): Promise<boolean>;
+    /**
+     * Find the most recent conversation for an exact thread ID.
+     *
+     * @param {string} thread - The exact thread ID to match
+     * @returns {Promise<ConversationRecord | null>} The full record with messages, or null if none found
+     */
+    findByThread(thread: string): Promise<ConversationRecord | null>;
+    /**
+     * Find all conversations whose thread starts with a prefix.
+     *
+     * @param {string} prefix - The thread prefix to match
+     * @returns {Promise<ConversationMeta[]>} Matching metadata records (newest first)
+     */
+    findByThreadPrefix(prefix: string): Promise<ConversationMeta[]>;
+    /**
+     * Delete all conversations for an exact thread.
+     *
+     * @param {string} thread - The exact thread ID
+     * @returns {Promise<number>} Number of conversations deleted
+     */
+    deleteThread(thread: string): Promise<number>;
+    /**
+     * Delete all conversations matching a thread prefix.
+     *
+     * @param {string} prefix - The thread prefix to match
+     * @returns {Promise<number>} Number of conversations deleted
+     */
+    deleteByThreadPrefix(prefix: string): Promise<number>;
+    private getIndex;
+    private setIndex;
+    private addToIndex;
+    private removeFromIndex;
+    private applyFilters;
+}
+export default ConversationHistory;
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/agi/features/conversation-history.d.ts.map

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