qlogicagent 2.18.8 → 2.18.10

package/dist/types/skills/memory/local-memory-provider.d.ts

@@ -1,325 +0,0 @@
-/**
- * Local Memory Provider - implements MemoryProvider using local SQLite store.
- *
- * This is the default provider for desktop use. Requires no external service.
- * Uses FTS5 for keyword search and optionally embedding API for vector search.
- *
- * Falls back gracefully:
- *   - With embedding API configured: hybrid search (FTS + vector)
- *   - Without embedding: FTS-only search (still useful for exact/keyword matches)
- */
-import type { MemoryProvider, MemorySearchResult, MemorySearchOptions, MemoryIngestOptions } from "../../protocol/wire/index.js";
-import type { MemoryClaimRecord, MemoryConflictRecord, MemoryProposalRecord, MemoryUpdateInput, SqliteDatabase } from "./local-store.js";
-import { type AdoptedAttachment } from "./memory-attachment-store.js";
-import { type LocalEmbeddingConfig } from "./local-embedding.js";
-import { type ExtractedMemoryItem, type MemoryConsolidationResult } from "./memory-consolidation.js";
-export type { ExtractedMemoryItem } from "./memory-consolidation.js";
-export interface LocalMemoryProviderConfig {
-    /** Active owner profile. Determines the physical SQLite database location. */
-    ownerUserId?: string;
-    /** Embedding configuration. If omitted, uses FTS-only search. */
-    embedding?: LocalEmbeddingConfig;
-    /** User ID prefix for multi-tenant isolation. */
-    userIdPrefix?: string;
-    /** Factory function to create the SQLite database instance. */
-    createDatabase?: (dbPath: string) => SqliteDatabase;
-}
-export declare class LocalMemoryProvider implements MemoryProvider {
-    readonly providerId = "qmemory-local";
-    private store;
-    private embedding;
-    private consolidator;
-    private attachmentStore;
-    private userIdPrefix;
-    private dbPath;
-    private attachmentsDir;
-    /** Active embedding model id — stamped onto stored vectors and used to skip
-     * incomparable vectors at search time (model switch = silent noise otherwise). */
-    private embeddingModelId;
-    /** One-shot flag: the embedding-degradation trace is logged once per provider instance. */
-    private embeddingFailureLogged;
-    constructor(config: LocalMemoryProviderConfig);
-    /** Persist an uploaded attachment (orphan until linked at commit). */
-    adoptAttachment(input: {
-        data?: Buffer;
-        sourceUrl?: string;
-        filename: string;
-        mimeType: string;
-        userId: string;
-    }): Promise<AdoptedAttachment>;
-    /** Resolve an attachment id to its on-disk path (for serving). */
-    locateAttachment(id: string): Promise<{
-        absPath: string;
-        mimeType: string;
-        filename: string;
-    } | null>;
-    /** Drop uploads that were never saved to a memory. */
-    purgeOrphanAttachments(): Promise<void>;
-    /** Read an attachment's bytes + mime (P2 multimodal understanding). */
-    readAttachmentBytes(id: string): Promise<{
-        bytes: Buffer;
-        mimeType: string;
-    } | null>;
-    /** Persist the understood/extracted text on an attachment row. */
-    setAttachmentText(id: string, text: string): void;
-    private resolveUserId;
-    /**
-     * The embedding API failing silently downgrades every search to FTS-only —
-     * leave one error-level trace per provider instance (deduped so a broken
-     * endpoint does not flood the log on every query).
-     */
-    private noteEmbeddingFailure;
-    private buildEmbedding;
-    search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
-    /** Public embedding access for task-distillation signatures (R3). Null when
-     * the embedding provider is unavailable — callers must degrade, not throw.
-     * B3(X7): returns number[] (not Float32Array) — this method is on the 16-method
-     * host-state proxy surface and its result crosses the x/host.request JSON wire
-     * in host mode; typed arrays do not survive JSON serialization. */
-    embedText(text: string): Promise<number[] | null>;
-    addText(text: string, userId: string, options?: MemoryIngestOptions & {
-        category?: string;
-        importance?: number;
-    }): Promise<{
-        memoriesAdded: number;
-    }>;
-    remove(memoryId: string): Promise<boolean>;
-    update(memoryId: string, input: MemoryUpdateInput): Promise<boolean>;
-    /**
-     * Prompt-injection screen for L2 writes. The memory-tool path already checks
-     * this, but implicit extraction / distillation / RPC ingestion used to write
-     * UNSCREENED — recalled memories land in a system message, so this is the
-     * last write-side gate. Rejections are traced, never silent.
-     */
-    private screenUnsafeItems;
-    /**
-     * Commit extracted memory items through the single consolidation pipeline.
-     */
-    ingestExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    observeExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    proposeExtracted(items: ExtractedMemoryItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationResult>;
-    /**
-     * Consume the pending-proposal backlog (the "proposals black hole" fix).
-     *
-     * Trust ladder, mirroring V3's graduated autonomy:
-     *   - CORROBORATED facts — the same fact proposed again from an independent
-     *     context (different session or different source) — commit automatically,
-     *     with a trace. Evidence, not a confidence score, is the auto gate.
-     *   - Feedback-distillation proposals commit alone: their >=2-evidence bar
-     *     was already enforced upstream (idempotency-keyed sweep, §10).
-     *   - dream-source proposals never commit alone; they only corroborate.
-     *   - Everything else waits for corroboration and EXPIRES after the TTL —
-     *     visibly (status=expired), not by silent deletion.
-     */
-    consumePendingProposals(userId: string, opts?: {
-        now?: number;
-        ttlMs?: number;
-        maxCommitsPerPass?: number;
-    }): Promise<{
-        committed: number;
-        merged: number;
-        expiredIds: string[];
-        pendingLeft: number;
-    }>;
-    /** Proposals for the memory candidate surface: pending (default) or the
-     * read-only expired history. Other statuses stay internal. */
-    listPendingProposals(userId: string, limit?: number, status?: "pending" | "expired"): MemoryProposalRecord[];
-    /** Resolve one pending proposal from the UI: confirm -> commit now; dismiss -> rejected. */
-    resolveProposal(userId: string, proposalId: string, action: "confirm" | "dismiss"): Promise<boolean>;
-    listClaims(userId: string): MemoryClaimRecord[];
-    listConflicts(userId: string): MemoryConflictRecord[];
-    /**
-     * Drain the consolidation backlog: auto-resolve open conflicts and promote
-     * corroborated pending claims. Called by dream after consolidation so the
-     * observation→proposal→claim pipeline doesn't accumulate unresolved state
-     * forever (the "proposals black hole").
-     *
-     * Conflict winner = higher source priority, then confidence, then recency.
-     * The loser claim is superseded and its backing memory archived.
-     */
-    resolveConflicts(userId: string, opts?: {
-        minEvidenceToPromote?: number;
-    }): Promise<{
-        conflictsResolved: number;
-        claimsPromoted: number;
-    }>;
-    /**
-     * Trigger memory decay - multi-strategy (temporal + staleness + noise).
-     * Also enforces capacity limit and runs vacuum for space reclamation.
-     */
-    triggerDecay(userId: string): Promise<{
-        decayed: number;
-    }>;
-    /**
-     * Apply feedback to a memory (useful/irrelevant/outdated/wrong).
-     * Adjusts importance or archives/deletes based on signal.
-     */
-    /** V3 promote/demote: archive(技能接棒,记忆退役)与 unarchive(降格回归)成对。
-     * claims 状态随动,防 archived 记忆的 claim 继续参与冲突/召回。
-     * B3(X7)异步化:16 面 host-state proxy 方法,签名统一 Promise(实现体仍同步)。 */
-    setMemoryArchived(memoryId: string, archived: boolean): Promise<boolean>;
-    feedback(memoryIds: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong"): Promise<{
-        affected: number;
-    }>;
-    /**
-     * Get a user profile value.
-     */
-    getProfile(userId: string, key: string): string | null;
-    /**
-     * Set a user profile value (upsert).
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    setProfile(userId: string, key: string, value: string): Promise<void>;
-    /**
-     * Get all profile entries for a user.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getAllProfiles(userId: string): Promise<Record<string, string>>;
-    /**
-     * Delete a profile entry.
-     */
-    deleteProfile(userId: string, key: string): boolean;
-    /**
-     * Get memories within a time range, grouped by day.
-     * Powers "what happened last week" type queries.
-     */
-    getTemporalSlice(userId: string, startMs: number, endMs: number, options?: {
-        category?: string;
-        limit?: number;
-    }): {
-        date: string;
-        memories: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-        }>;
-    }[];
-    /**
-     * Get activity summary over recent N days (daily counts + highlights).
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getActivitySummary(userId: string, days?: number): Promise<{
-        dailyCounts: Array<{
-            date: string;
-            count: number;
-        }>;
-        highlights: Array<{
-            id: string;
-            text: string;
-            category: string;
-            importance: number;
-            date: string;
-        }>;
-    }>;
-    /**
-     * List full memory records for a user (paginated). Used by the memory atlas
-     * visualization, which needs the complete record shape (confidence, importance,
-     * accessCount, timestamps, tags) to drive its 3D rendering.
-     */
-    list(userId: string, options?: {
-        page?: number;
-        pageSize?: number;
-        activeOnly?: boolean;
-    }): import("./local-store-records.js").MemoryRecord[];
-    /**
-     * Return the final atlas payload: a bounded interactive record window plus
-     * whole-history buckets/clusters for large timelines.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    getAtlas(userId: string, options?: {
-        pageSize?: number;
-        windowStartAt?: number;
-        windowEndAt?: number;
-        windowCenterAt?: number;
-        bucketCount?: number;
-        clusterLimit?: number;
-        activeOnly?: boolean;
-    }): Promise<import("./local-store-records.js").MemoryAtlasResult>;
-    /** Complete tag-scoped listing (resident refresh / onboarding purge) — see store.listByTag. */
-    listMemoriesByTag(userId: string, tag: string): import("./local-store-records.js").MemoryRecord[];
-    /**
-     * Find related memories (event continuity detection).
-     * Given a new memory, finds existing memories that are semantically related
-     * (cosine 0.6-0.82) and from the past 14 days. These represent continuations
-     * of an ongoing event/thread.
-     *
-     * Example: "interviewed with ByteDance on Monday" -> finds "sent ByteDance resume last week" -> linked event chain.
-     */
-    findRelatedEvents(text: string, userId: string, options?: {
-        maxDaysBack?: number;
-        minSimilarity?: number;
-        maxSimilarity?: number;
-        limit?: number;
-    }): Promise<Array<{
-        id: string;
-        text: string;
-        score: number;
-        date: string;
-    }>>;
-    /**
-     * Synthesize a temporal narrative from memories in a time range.
-     * Returns a structured timeline suitable for prompt injection.
-     * B3(X7)异步化:16 面 host-state proxy 方法。
-     */
-    synthesizeTimeline(userId: string, startMs: number, endMs: number): Promise<string>;
-    /**
-     * Rerank search results by applying recency boost, access frequency,
-     * and importance weighting. No LLM needed - pure scoring heuristics.
-     *
-     * This goes beyond basic search scoring by considering:
-     *   - Temporal proximity (recent memories get boosted)
-     *   - Access frequency (frequently recalled = more relevant)
-     *   - Category alignment (if preferredCategories specified)
-     */
-    rerank(results: Array<{
-        id: string;
-        text: string;
-        score: number;
-        category?: string;
-        metadata?: Record<string, unknown>;
-    }>, options?: {
-        preferredCategories?: string[];
-        recencyBoostDays?: number;
-    }): Array<{
-        id: string;
-        text: string;
-        score: number;
-        category?: string;
-        metadata?: Record<string, unknown>;
-    }>;
-    /**
-     * Health check — a real probe, not a constant: reports the actual active row
-     * count and turns DB access errors into status "error" instead of "healthy".
-     */
-    health(): Promise<{
-        status: string;
-        memoryCount: number;
-        dbPath: string;
-    }>;
-    /**
-     * Get memory count for a user.
-     */
-    count(userId: string): number;
-    /**
-     * Reset ALL long-term memory state for a user: every SQLite table (memories,
-     * observations, proposals, claims, conflicts, attachments index, profile KV),
-     * the attachment files on disk, and the task-distillation working stores
-     * (candidate prompts are stored in clear text — they are memory-domain data
-     * and must not survive a "clear my memory"). promotion-proposals.json is
-     * deliberately KEPT: it is the audit trail of the user's own promote/demote
-     * decisions and the demote map for already-created skills.
-     *
-     * Returns the number of memory rows removed (wire-compat with the old shape).
-     */
-    resetUser(userId: string): Promise<number>;
-    /**
-     * Close the database connection.
-     */
-    close(): void;
-}
-/**
- * Create a local memory provider (convenience factory).
- * Caller must provide the createDatabase factory to avoid hard dependency on better-sqlite3.
- */
-export declare function createLocalMemoryProvider(config: LocalMemoryProviderConfig): LocalMemoryProvider;

package/dist/types/skills/memory/memory-provider-factory.d.ts

@@ -1,33 +0,0 @@
-/**
- * Memory Provider Factory — creates local SQLite memory provider.
- *
- * No remote/cloud memory service exists. Memory is always local.
- * This factory is the single integration point for stdio-server.ts.
- */
-import type { LocalMemoryProvider } from "./local-memory-provider.js";
-import { type MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-export type { MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
-export interface MemoryProviderFactoryResult {
-    provider: LocalMemoryProvider | null;
-    mode: "local" | "none";
-    error?: string;
-}
-/**
- * Create the local SQLite memory provider.
- * Returns null (mode "none") only if better-sqlite3 is not available.
- */
-export declare function createMemoryProvider(config: MemoryProviderFactoryConfig): MemoryProviderFactoryResult;
-/**
- * Build MemoryProviderFactoryConfig from environment variables.
- * Used by stdio-server to auto-configure memory.
- *
- * Environment variables:
- *   QMEMORY_EMBEDDING_TIMEOUT_MS — embedding request timeout (default: 1500)
- *   QMEMORY_USER_PREFIX        — user ID prefix for multi-tenant
- *
- * Fixed embedding resolution:
- *   Layer 0: Explicit ModelRegistry "embedding" binding
- *   Layer 1: LLM Router default embedding endpoint (BAAI/bge-m3)
- *   Layer 2: FTS5 pure text (NullEmbeddingProvider)
- */
-export declare function resolveMemoryConfigFromEnv(): MemoryProviderFactoryConfig;

package/dist/types/skills/tools/cron-tool.d.ts

@@ -1,96 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const CRON_TOOL_NAME: "cron";
-export type CronAction = "create" | "list" | "get" | "update" | "delete" | "pause" | "resume" | "trigger";
-export interface CronToolParams {
-    action: CronAction;
-    /** Job ID (required for get/update/delete/pause/resume/trigger) */
-    jobId?: string;
-    /** Task prompt to execute on schedule */
-    prompt?: string;
-    /** Cron expression or shorthand ('5m', '1h', '0 9 * * *') */
-    schedule?: string;
-    /** Human-readable job name */
-    name?: string;
-    /** Whether the job is enabled */
-    enabled?: boolean;
-}
-export declare const CRON_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["create", "list", "get", "update", "delete", "pause", "resume", "trigger"];
-            readonly description: "Workflow-backed action: create/list/get/update/delete/pause/resume/trigger.";
-        };
-        readonly jobId: {
-            readonly type: "string";
-            readonly description: "Job ID. Required for get/update/delete/pause/resume/trigger.";
-        };
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Task prompt to execute on schedule. Required for create.";
-        };
-        readonly schedule: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly name: {
-            readonly type: "string";
-            readonly description: "Human-readable job name.";
-        };
-        readonly enabled: {
-            readonly type: "boolean";
-            readonly description: "Whether the job is enabled (for update).";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface CronJob {
-    id: string;
-    name: string;
-    prompt: string;
-    schedule: string;
-    scheduleDisplay: string;
-    state: "scheduled" | "paused";
-    enabled: boolean;
-    nextRunAt?: string;
-    lastRunAt?: string;
-    lastStatus?: "success" | "error" | null;
-}
-export interface CronResult {
-    success: boolean;
-    job?: CronJob;
-    jobs?: CronJob[];
-    error?: string;
-}
-/**
- * Host-provided cron scheduler backend.
- * Jobs are persisted locally and survive restarts.
- */
-export interface CronToolDeps {
-    createJob(params: {
-        prompt: string;
-        schedule: string;
-        name?: string;
-        repeat?: number | null;
-        allowedTools?: string[];
-    }): Promise<CronResult>;
-    listJobs(): Promise<CronResult>;
-    getJob(jobId: string): Promise<CronResult>;
-    updateJob(jobId: string, updates: Partial<{
-        prompt: string;
-        schedule: string;
-        name: string;
-        enabled: boolean;
-        repeat: number | null;
-        allowedTools: string[];
-    }>): Promise<CronResult>;
-    deleteJob(jobId: string): Promise<CronResult>;
-    pauseJob(jobId: string): Promise<CronResult>;
-    resumeJob(jobId: string): Promise<CronResult>;
-    triggerJob(jobId: string): Promise<CronResult>;
-    /** Validate cron schedule expression. Returns error or null. */
-    validateSchedule?(schedule: string): string | null;
-}
-export declare const MAX_CRON_JOBS = 50;
-export declare function createCronTool(deps: CronToolDeps): PortableTool<CronToolParams>;

package/dist/types/skills/tools/petdex-create-tool.d.ts

@@ -1,47 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { GeneratePetdexImage, UploadPetdexReferenceImage } from "@xiaozhiclaw/pet-core";
-export declare const PETDEX_CREATE_TOOL_NAME: "petdex_create";
-export interface PetdexCreateToolParams {
-    name?: string;
-    description: string;
-    prompt?: string;
-    reference_image_url?: string;
-    base_spritesheet_path?: string;
-    output_dir?: string;
-}
-export interface PetdexCreateToolDeps {
-    generateImage: GeneratePetdexImage;
-    uploadReferenceImage?: UploadPetdexReferenceImage;
-    resolveOutputDir(outputDir?: string): string;
-}
-export declare const PETDEX_CREATE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly name: {
-            readonly type: "string";
-            readonly description: "Short display name for the generated desktop pet. Defaults to a short name derived from description.";
-        };
-        readonly description: {
-            readonly type: "string";
-            readonly description: "Canonical character description for the Petdex desktop pet.";
-        };
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Optional extra visual direction. The tool will embed it into a strict Petdex 8x9 atlas prompt.";
-        };
-        readonly reference_image_url: {
-            readonly type: "string";
-            readonly description: "Optional publicly accessible HTTP/HTTPS reference image URL for image-to-image generation.";
-        };
-        readonly base_spritesheet_path: {
-            readonly type: "string";
-            readonly description: "Optional existing spritesheet.webp path; used as the identity reference to regenerate the whole atlas while keeping the same character.";
-        };
-        readonly output_dir: {
-            readonly type: "string";
-            readonly description: "Optional output directory. Defaults to the workspace Petdex asset output directory.";
-        };
-    };
-    readonly required: readonly ["description"];
-};
-export declare function createPetdexCreateTool(deps: PetdexCreateToolDeps): PortableTool<PetdexCreateToolParams>;

package/dist/types/skills/tools/workflow-tool.d.ts

@@ -1,45 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export type WorkflowAction = "list" | "get" | "describe" | "create" | "patch" | "setActive" | "run" | "delete";
-export interface WorkflowToolParams {
-    action: WorkflowAction;
-    workflowId?: string;
-    name?: string;
-    def?: Record<string, unknown>;
-    patch?: unknown[];
-    baseRev?: number;
-    scope?: string[];
-    active?: boolean;
-}
-export interface WorkflowToolRecord {
-    id: string;
-    name?: string;
-    rev?: number;
-    active?: boolean;
-}
-export interface WorkflowRunOutcome {
-    status?: string;
-}
-export interface WorkflowToolService {
-    list(): Promise<WorkflowToolRecord[]>;
-    get(id: string): Promise<unknown>;
-    describe(id: string): Promise<string>;
-    create(input: {
-        id: string;
-        name: string;
-        def: Record<string, unknown>;
-        active: boolean;
-    }): Promise<WorkflowToolRecord>;
-    patch(id: string, envelope: {
-        patch: unknown[];
-        baseRev?: number;
-        scope?: string[];
-    }): Promise<unknown>;
-    setActive(id: string, active: boolean): Promise<WorkflowToolRecord>;
-    run(id: string): Promise<WorkflowRunOutcome>;
-    delete(id: string): Promise<void>;
-}
-export interface WorkflowToolDeps {
-    /** Resolve the host-owned workflow service port. Keeps skills independent from orchestration internals. */
-    getService(): WorkflowToolService;
-}
-export declare function createWorkflowTool(deps: WorkflowToolDeps): PortableTool<WorkflowToolParams>;