@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardPersistence.d.ts

@@ -0,0 +1,24 @@
+import type { IAgentRuntime, Memory } from "../../../../types/index.ts";
+import type { AddTaskClipboardItemInput, TaskClipboardItem, TaskClipboardSnapshot } from "../types.ts";
+type TaskClipboardPersistenceInput = AddTaskClipboardItemInput & {
+    fallbackTitle?: string;
+};
+export type TaskClipboardPersistenceResult = {
+    requested: false;
+    stored: false;
+} | {
+    requested: true;
+    stored: true;
+    replaced: boolean;
+    item: TaskClipboardItem;
+    snapshot: TaskClipboardSnapshot;
+} | {
+    requested: true;
+    stored: false;
+    reason: string;
+};
+export declare function shouldAddToClipboard(message: Memory): boolean;
+export declare function resolveClipboardTitle(message: Memory, fallbackTitle?: string): string | undefined;
+export declare function maybeStoreTaskClipboardItem(runtime: IAgentRuntime, message: Memory, input: TaskClipboardPersistenceInput): Promise<TaskClipboardPersistenceResult>;
+export {};
+//# sourceMappingURL=taskClipboardPersistence.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskClipboardPersistence.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACX,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,MAAM,aAAa,CAAC;AAGrB,KAAK,6BAA6B,GAAG,yBAAyB,GAAG;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GACvC;IACA,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;CACb,GACD;IACA,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;CAC/B,GACD;IACA,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACd,CAAC;AAgBL,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,6BAA6B,GAClC,OAAO,CAAC,8BAA8B,CAAC,CA4CzC"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardPersistence.js

@@ -0,0 +1,63 @@
+import { createTaskClipboardService } from "./taskClipboardService.js";
+function isTruthyFlag(value) {
+    if (value === true) {
+        return true;
+    }
+    if (typeof value === "string") {
+        return /^(true|1|yes|y|on)$/i.test(value.trim());
+    }
+    return false;
+}
+function normalizeTitle(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+export function shouldAddToClipboard(message) {
+    return (isTruthyFlag(message.content.addToClipboard) ||
+        isTruthyFlag(message.content.persistToClipboard) ||
+        isTruthyFlag(message.content.saveToClipboard));
+}
+export function resolveClipboardTitle(message, fallbackTitle) {
+    return (normalizeTitle(message.content.clipboardTitle) ??
+        normalizeTitle(message.content.title) ??
+        normalizeTitle(fallbackTitle) ??
+        undefined);
+}
+export async function maybeStoreTaskClipboardItem(runtime, message, input) {
+    if (!shouldAddToClipboard(message)) {
+        return {
+            requested: false,
+            stored: false,
+        };
+    }
+    const content = input.content.trim();
+    if (!content) {
+        return {
+            requested: true,
+            stored: false,
+            reason: "No stored content was available to save in the clipboard.",
+        };
+    }
+    try {
+        const entityId = typeof message.entityId === "string" ? message.entityId : undefined;
+        const service = createTaskClipboardService(runtime);
+        const { item, replaced, snapshot } = await service.addItem({
+            ...input,
+            content,
+            title: input.title ?? resolveClipboardTitle(message, input.fallbackTitle),
+        }, entityId);
+        return {
+            requested: true,
+            stored: true,
+            replaced,
+            item,
+            snapshot,
+        };
+    }
+    catch (error) {
+        return {
+            requested: true,
+            stored: false,
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardService.d.ts

@@ -0,0 +1,29 @@
+import type { IAgentRuntime } from "../../../../types/index.ts";
+import type { AddTaskClipboardItemInput, ClipboardConfig, TaskClipboardItem, TaskClipboardSnapshot } from "../types.ts";
+export declare class TaskClipboardService {
+    private readonly config;
+    constructor(runtime: IAgentRuntime, config?: Partial<ClipboardConfig>);
+    private ensureDirectory;
+    /**
+     * Resolve the store file path. When entityId is provided, the clipboard
+     * is scoped per-entity under a `clipboard/` subdirectory. Without an
+     * entityId the legacy global path is used.
+     */
+    private getStorePath;
+    private readStore;
+    private writeStore;
+    getSnapshot(entityId?: string): Promise<TaskClipboardSnapshot>;
+    listItems(entityId?: string): Promise<TaskClipboardItem[]>;
+    getItem(id: string, entityId?: string): Promise<TaskClipboardItem | null>;
+    addItem(input: AddTaskClipboardItemInput, entityId?: string): Promise<{
+        item: TaskClipboardItem;
+        replaced: boolean;
+        snapshot: TaskClipboardSnapshot;
+    }>;
+    removeItem(id: string, entityId?: string): Promise<{
+        removed: boolean;
+        snapshot: TaskClipboardSnapshot;
+    }>;
+}
+export declare function createTaskClipboardService(runtime: IAgentRuntime, config?: Partial<ClipboardConfig>): TaskClipboardService;
+//# sourceMappingURL=taskClipboardService.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskClipboardService.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EACX,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,MAAM,aAAa,CAAC;AAsDrB,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;YAIvD,eAAe;IAO7B;;;;OAIG;IACH,OAAO,CAAC,YAAY;YAQN,SAAS;YA8CT,UAAU;IAgBlB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQ9D,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK1D,OAAO,CACZ,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAK9B,OAAO,CACZ,KAAK,EAAE,yBAAyB,EAChC,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QACV,IAAI,EAAE,iBAAiB,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,qBAAqB,CAAC;KAChC,CAAC;IA0DI,UAAU,CACf,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,qBAAqB,CAAC;KAChC,CAAC;CAsBF;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,oBAAoB,CAEtB"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/services/taskClipboardService.js

@@ -0,0 +1,195 @@
+import crypto from "node:crypto";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { logger } from "../../../../types/index.js";
+import { TASK_CLIPBOARD_MAX_ITEMS } from "../types.js";
+import { resolveClipboardConfig } from "./clipboardService.js";
+const TASK_CLIPBOARD_FILE = "clipboard.json";
+const CLIPBOARD_DIR = "clipboard";
+const DEFAULT_STORE = {
+    version: 1,
+    maxItems: TASK_CLIPBOARD_MAX_ITEMS,
+    items: [],
+};
+function createDefaultStore() {
+    return {
+        version: DEFAULT_STORE.version,
+        maxItems: DEFAULT_STORE.maxItems,
+        items: [],
+    };
+}
+function sanitizeTitle(value) {
+    return value.replace(/\s+/g, " ").trim().slice(0, 120);
+}
+function defaultTitleForInput(input) {
+    if (input.title?.trim()) {
+        return sanitizeTitle(input.title);
+    }
+    if (input.sourceType === "command") {
+        return sanitizeTitle(input.sourceLabel ?? input.sourceId ?? "Command");
+    }
+    if (input.sourceType === "attachment" ||
+        input.sourceType === "image_attachment") {
+        return sanitizeTitle(input.sourceLabel ?? input.sourceId ?? "Attachment");
+    }
+    if (input.sourceType === "file") {
+        return sanitizeTitle(input.sourceLabel ?? input.sourceId ?? "File");
+    }
+    return "Clipboard Item";
+}
+function normalizeContent(content) {
+    return content.replace(/\r\n/g, "\n").trim();
+}
+export class TaskClipboardService {
+    config;
+    constructor(runtime, config) {
+        this.config = resolveClipboardConfig(config, runtime);
+    }
+    async ensureDirectory(subdir) {
+        const dir = subdir
+            ? path.join(this.config.basePath, subdir)
+            : this.config.basePath;
+        await fs.mkdir(dir, { recursive: true });
+    }
+    /**
+     * Resolve the store file path. When entityId is provided, the clipboard
+     * is scoped per-entity under a `clipboard/` subdirectory. Without an
+     * entityId the legacy global path is used.
+     */
+    getStorePath(entityId) {
+        if (entityId) {
+            const safeId = entityId.replace(/[^a-zA-Z0-9_-]/g, "_");
+            return path.join(this.config.basePath, CLIPBOARD_DIR, `${safeId}.json`);
+        }
+        return path.join(this.config.basePath, TASK_CLIPBOARD_FILE);
+    }
+    async readStore(entityId) {
+        const storePath = this.getStorePath(entityId);
+        const dir = path.dirname(storePath);
+        await this.ensureDirectory(dir === this.config.basePath
+            ? undefined
+            : path.relative(this.config.basePath, dir));
+        try {
+            const raw = await fs.readFile(storePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || !Array.isArray(parsed.items)) {
+                return createDefaultStore();
+            }
+            return {
+                version: 1,
+                maxItems: typeof parsed.maxItems === "number" && parsed.maxItems > 0
+                    ? parsed.maxItems
+                    : TASK_CLIPBOARD_MAX_ITEMS,
+                items: parsed.items
+                    .filter((item) => Boolean(item &&
+                    typeof item.id === "string" &&
+                    typeof item.title === "string" &&
+                    typeof item.content === "string" &&
+                    typeof item.sourceType === "string" &&
+                    typeof item.createdAt === "string" &&
+                    typeof item.updatedAt === "string"))
+                    .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt)),
+            };
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return createDefaultStore();
+            }
+            logger.warn("[TaskClipboardService] Failed to read task clipboard store:", error instanceof Error ? error.message : String(error));
+            return createDefaultStore();
+        }
+    }
+    async writeStore(store, entityId) {
+        const storePath = this.getStorePath(entityId);
+        const dir = path.dirname(storePath);
+        await this.ensureDirectory(dir === this.config.basePath
+            ? undefined
+            : path.relative(this.config.basePath, dir));
+        const tempPath = `${storePath}.tmp-${crypto.randomUUID()}`;
+        await fs.writeFile(tempPath, JSON.stringify(store, null, 2), "utf8");
+        await fs.rename(tempPath, storePath);
+    }
+    async getSnapshot(entityId) {
+        const store = await this.readStore(entityId);
+        return {
+            maxItems: store.maxItems,
+            items: [...store.items],
+        };
+    }
+    async listItems(entityId) {
+        const snapshot = await this.getSnapshot(entityId);
+        return snapshot.items;
+    }
+    async getItem(id, entityId) {
+        const items = await this.listItems(entityId);
+        return items.find((item) => item.id === id) ?? null;
+    }
+    async addItem(input, entityId) {
+        const content = normalizeContent(input.content);
+        if (!content) {
+            throw new Error("Clipboard items require non-empty content.");
+        }
+        const store = await this.readStore(entityId);
+        const now = new Date().toISOString();
+        const replacementIndex = input.sourceType && input.sourceId
+            ? store.items.findIndex((item) => item.sourceType === input.sourceType &&
+                item.sourceId === input.sourceId)
+            : -1;
+        if (replacementIndex === -1 && store.items.length >= store.maxItems) {
+            throw new Error(`Clipboard is full (${store.items.length}/${store.maxItems}). Remove an unused item before adding another.`);
+        }
+        const existing = replacementIndex >= 0 ? store.items[replacementIndex] : null;
+        const item = {
+            id: existing?.id ?? `cb-${crypto.randomUUID().slice(0, 8)}`,
+            title: defaultTitleForInput(input),
+            content,
+            sourceType: input.sourceType ?? "manual",
+            ...(input.sourceId ? { sourceId: input.sourceId } : {}),
+            ...(input.sourceLabel ? { sourceLabel: input.sourceLabel } : {}),
+            ...(input.mimeType ? { mimeType: input.mimeType } : {}),
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+        if (replacementIndex >= 0) {
+            store.items[replacementIndex] = item;
+        }
+        else {
+            store.items.unshift(item);
+        }
+        store.items.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+        await this.writeStore(store, entityId);
+        return {
+            item,
+            replaced: replacementIndex >= 0,
+            snapshot: {
+                maxItems: store.maxItems,
+                items: [...store.items],
+            },
+        };
+    }
+    async removeItem(id, entityId) {
+        const store = await this.readStore(entityId);
+        const nextItems = store.items.filter((item) => item.id !== id);
+        if (nextItems.length === store.items.length) {
+            return {
+                removed: false,
+                snapshot: {
+                    maxItems: store.maxItems,
+                    items: [...store.items],
+                },
+            };
+        }
+        store.items = nextItems;
+        await this.writeStore(store, entityId);
+        return {
+            removed: true,
+            snapshot: {
+                maxItems: store.maxItems,
+                items: [...store.items],
+            },
+        };
+    }
+}
+export function createTaskClipboardService(runtime, config) {
+    return new TaskClipboardService(runtime, config);
+}

package/packages/typescript/src/features/advanced-capabilities/clipboard/specs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Action specs for clipboard actions (inlined from plugin-clipboard generated specs)
+ */
+export interface ActionSpec {
+    name: string;
+    description: string;
+    similes?: string[];
+    examples?: Array<Array<{
+        role: string;
+        content: string;
+    }>>;
+}
+export declare const actionSpecs: Record<string, ActionSpec>;
+export declare function requireActionSpec(name: string): ActionSpec;
+//# sourceMappingURL=specs.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/clipboard/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA2KlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAM1D"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/specs.js

@@ -0,0 +1,164 @@
+/**
+ * Action specs for clipboard actions (inlined from plugin-clipboard generated specs)
+ */
+export const actionSpecs = {
+    CLIPBOARD_WRITE: {
+        name: "CLIPBOARD_WRITE",
+        description: "Write a new note or memory to the clipboard. Use this to save information for later retrieval.",
+        similes: [
+            "SAVE_NOTE",
+            "CREATE_NOTE",
+            "WRITE_NOTE",
+            "REMEMBER_THIS",
+            "SAVE_MEMORY",
+            "JOT_DOWN",
+            "NOTE_THIS",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "Please save a note about the meeting tomorrow at 3pm with John about the marketing strategy.",
+                },
+                {
+                    role: "assistant",
+                    content: "I've saved a note about your meeting. Title: 'Meeting with John - Marketing Strategy'. You can retrieve it later.",
+                },
+            ],
+            [
+                {
+                    role: "user",
+                    content: "Remember that the API key for the service is stored in the .env file.",
+                },
+                {
+                    role: "assistant",
+                    content: "I've noted that the API key is stored in the .env file. I'll remember this for future reference.",
+                },
+            ],
+        ],
+    },
+    CLIPBOARD_READ: {
+        name: "CLIPBOARD_READ",
+        description: "Read the content of a specific clipboard entry. Use after searching to retrieve full details.",
+        similes: [
+            "GET_NOTE",
+            "READ_NOTE",
+            "RETRIEVE_NOTE",
+            "GET_MEMORY",
+            "FETCH_NOTE",
+            "OPEN_NOTE",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "Can you show me the note about the marketing meeting?",
+                },
+                {
+                    role: "assistant",
+                    content: "Here's the note 'Meeting with John - Marketing Strategy': Meeting scheduled for tomorrow at 3pm...",
+                },
+            ],
+        ],
+    },
+    CLIPBOARD_SEARCH: {
+        name: "CLIPBOARD_SEARCH",
+        description: "Search through clipboard entries for relevant information. Returns matching snippets with relevance scores.",
+        similes: [
+            "FIND_NOTE",
+            "SEARCH_NOTES",
+            "LOOKUP_MEMORY",
+            "FIND_MEMORY",
+            "SEARCH_MEMORY",
+            "RECALL",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "What notes do I have about marketing?",
+                },
+                {
+                    role: "assistant",
+                    content: "I found 2 clipboard entries mentioning marketing: 1) 'Meeting with John - Marketing Strategy' (score: 0.85)...",
+                },
+            ],
+        ],
+    },
+    CLIPBOARD_LIST: {
+        name: "CLIPBOARD_LIST",
+        description: "List all clipboard entries with their titles and modification dates.",
+        similes: [
+            "SHOW_NOTES",
+            "LIST_NOTES",
+            "ALL_NOTES",
+            "MY_NOTES",
+            "SHOW_MEMORIES",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "Show me all my saved notes.",
+                },
+                {
+                    role: "assistant",
+                    content: "You have 5 clipboard entries: 1) Meeting notes (modified today), 2) API documentation (modified yesterday)...",
+                },
+            ],
+        ],
+    },
+    CLIPBOARD_DELETE: {
+        name: "CLIPBOARD_DELETE",
+        description: "Delete a clipboard entry by its ID.",
+        similes: [
+            "REMOVE_NOTE",
+            "DELETE_NOTE",
+            "FORGET_NOTE",
+            "ERASE_NOTE",
+            "REMOVE_MEMORY",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "Delete the note about the old meeting.",
+                },
+                {
+                    role: "assistant",
+                    content: "I've deleted the clipboard entry 'old-meeting'. The note has been removed.",
+                },
+            ],
+        ],
+    },
+    CLIPBOARD_APPEND: {
+        name: "CLIPBOARD_APPEND",
+        description: "Append additional content to an existing clipboard entry.",
+        similes: [
+            "ADD_TO_NOTE",
+            "UPDATE_NOTE",
+            "APPEND_NOTE",
+            "EXTEND_NOTE",
+            "ADD_MORE",
+        ],
+        examples: [
+            [
+                {
+                    role: "user",
+                    content: "Add to the meeting notes that we decided on a $50k budget.",
+                },
+                {
+                    role: "assistant",
+                    content: "I've appended the budget decision to the meeting notes. The note now includes the $50k budget information.",
+                },
+            ],
+        ],
+    },
+};
+export function requireActionSpec(name) {
+    const spec = actionSpecs[name];
+    if (!spec) {
+        throw new Error(`Action spec not found: ${name}`);
+    }
+    return spec;
+}

package/packages/typescript/src/features/advanced-capabilities/clipboard/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Clipboard file-based memory types
+ */
+export interface ClipboardEntry {
+    /** Unique identifier (filename without extension) */
+    id: string;
+    /** Full path to the clipboard file */
+    path: string;
+    /** Title/name of the clipboard entry */
+    title: string;
+    /** Content of the clipboard entry */
+    content: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last modified timestamp */
+    modifiedAt: Date;
+    /** Optional tags for categorization */
+    tags?: string[];
+}
+export interface ClipboardSearchResult {
+    /** Path to the file */
+    path: string;
+    /** Starting line number of the match */
+    startLine: number;
+    /** Ending line number of the match */
+    endLine: number;
+    /** Relevance score (0-1) */
+    score: number;
+    /** The matching snippet */
+    snippet: string;
+    /** Entry ID (filename without extension) */
+    entryId: string;
+}
+export interface ClipboardReadOptions {
+    /** Starting line number (1-indexed) */
+    from?: number;
+    /** Number of lines to read */
+    lines?: number;
+}
+export interface ClipboardWriteOptions {
+    /** Tags to associate with the entry */
+    tags?: string[];
+    /** Whether to append to existing content */
+    append?: boolean;
+}
+export interface ClipboardSearchOptions {
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Minimum relevance score (0-1) */
+    minScore?: number;
+}
+export interface ClipboardConfig {
+    /** Base directory for clipboard files */
+    basePath: string;
+    /** Maximum file size in bytes */
+    maxFileSize?: number;
+    /** Allowed file extensions */
+    allowedExtensions?: string[];
+}
+export declare const TASK_CLIPBOARD_MAX_ITEMS = 5;
+export type TaskClipboardSourceType = "manual" | "command" | "file" | "attachment" | "image_attachment" | "channel" | "conversation_search" | "entity" | "entity_search";
+export interface TaskClipboardItem {
+    /** Stable clipboard item ID exposed to the agent context. */
+    id: string;
+    /** Short label for the item. */
+    title: string;
+    /** Stored working-memory content. */
+    content: string;
+    /** Where the item came from. */
+    sourceType: TaskClipboardSourceType;
+    /** Original file path or attachment ID when applicable. */
+    sourceId?: string;
+    /** Human-readable locator such as a file path or attachment name. */
+    sourceLabel?: string;
+    /** Optional MIME type when sourced from an attachment. */
+    mimeType?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TaskClipboardSnapshot {
+    maxItems: number;
+    items: TaskClipboardItem[];
+}
+export interface AddTaskClipboardItemInput {
+    title?: string;
+    content: string;
+    sourceType?: TaskClipboardSourceType;
+    sourceId?: string;
+    sourceLabel?: string;
+    mimeType?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/clipboard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC9B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,IAAI,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACrC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAChC,QAAQ,GACR,SAAS,GACT,MAAM,GACN,YAAY,GACZ,kBAAkB,GAClB,SAAS,GACT,qBAAqB,GACrB,QAAQ,GACR,eAAe,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IACjC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,uBAAuB,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/types.js

@@ -0,0 +1,4 @@
+/**
+ * Clipboard file-based memory types
+ */
+export const TASK_CLIPBOARD_MAX_ITEMS = 5;

package/packages/typescript/src/features/advanced-capabilities/evaluators/factRefinement.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FactRefinementEvaluator
+ *
+ * Honcho-style dialectic refinement for the facts memory store. Runs on the
+ * same trigger as the summarization evaluator: when a fresh summary lands we
+ * compare every existing fact for the relevant entity against the summary
+ * and classify the implication:
+ *
+ *   - add         → new fact memory
+ *   - strengthen  → bump confidence and update lastReinforced
+ *   - decay       → drop confidence; delete when below FACT_DECAY_FLOOR
+ *   - merge       → write to fact_candidates for human review
+ *   - contradict  → write to fact_candidates for human review
+ *
+ * The schema-level `fact_candidates` table receives anything we cannot apply
+ * automatically. The Facts UI surfaces those as "I noticed conflicting info".
+ */
+import type { Evaluator } from "../../../types/index.ts";
+export declare const factRefinementEvaluator: Evaluator;
+//# sourceMappingURL=factRefinement.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/evaluators/factRefinement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factRefinement.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/evaluators/factRefinement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAEX,SAAS,EAKT,MAAM,yBAAyB,CAAC;AAoTjC,eAAO,MAAM,uBAAuB,EAAE,SAmIrC,CAAC"}