qlogicagent 2.16.5 → 2.16.7

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

@@ -12,36 +12,9 @@
  *   - memories_fts: FTS5 full-text index for keyword search
  *   - profiles: user profile KV (future)
  */
+import type { MemoryAtlasResult, MemoryClaimInput, MemoryClaimRecord, MemoryClaimStatus, MemoryConflictRecord, MemoryInsertInput, MemoryObservationInput, MemoryProposalInput, MemoryProposalStatus, MemoryRecord, MemorySearchHit, MemoryUpdateInput, SqliteDatabase } from "./local-store-records.js";
 export { resolveMemoryDbPath } from "./memory-db-path.js";
-export interface MemoryRecord {
-    id: string;
-    text: string;
-    userId: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sessionId: string;
-    eventDate: string;
-    tags: string[];
-    embedding: Float32Array | null;
-    createdAt: number;
-    updatedAt: number;
-    accessCount: number;
-    lastAccessedAt: number;
-    isArchived: boolean;
-    /** Lightweight attachment refs (populated by the provider for atlas/detail). */
-    attachments?: MemoryAttachmentRef[];
-}
-/** Lightweight attachment reference carried on records / atlas wire (no bytes, no extractedText). */
-export interface MemoryAttachmentRef {
-    id: string;
-    kind: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    url: string;
-}
+export type { MemoryAtlasBucket, MemoryAtlasCluster, MemoryAtlasResult, MemoryAtlasWindowCursor, MemoryAttachmentRef, MemoryClaimInput, MemoryClaimRecord, MemoryClaimStatus, MemoryConflictRecord, MemoryInsertInput, MemoryObservationInput, MemoryObservationRecord, MemoryProposalInput, MemoryProposalRecord, MemoryProposalStatus, MemoryRecord, MemorySearchHit, MemorySourceKind, MemoryUpdateInput, SqliteDatabase, SqliteStatement, } from "./local-store-records.js";
 /** Full attachment index row (DB-backed; file bytes live on disk under the attachments dir). */
 export interface MemoryAttachmentRow {
     id: string;
@@ -66,172 +39,6 @@ export interface MemoryAttachmentInsert {
     extractedText?: string;
     memoryId?: string;
 }
-export interface MemoryInsertInput {
-    text: string;
-    userId: string;
-    category?: string;
-    importance?: number;
-    confidence?: number;
-    source?: string;
-    sessionId?: string;
-    eventDate?: string;
-    tags?: string[];
-    embedding?: Float32Array;
-}
-export interface MemoryUpdateInput {
-    text?: string;
-    category?: string;
-    importance?: number;
-    source?: string;
-    eventDate?: string;
-    tags?: string[];
-    embedding?: Float32Array | null;
-}
-export interface MemorySearchHit {
-    id: string;
-    text: string;
-    score: number;
-    category: string;
-    importance: number;
-    metadata: Record<string, unknown>;
-}
-export interface MemoryAtlasBucket {
-    id: string;
-    startAt: number;
-    endAt: number;
-    count: number;
-    avgImportance: number;
-    avgConfidence: number;
-    topCategory: string;
-}
-export interface MemoryAtlasCluster {
-    id: string;
-    label: string;
-    kind: "source" | "category" | "tag";
-    count: number;
-    startAt: number;
-    endAt: number;
-    avgImportance: number;
-    avgConfidence: number;
-    topCategory: string;
-}
-export interface MemoryAtlasWindowCursor {
-    startAt: number;
-    endAt: number;
-    centerAt: number;
-    pageSize: number;
-    hasBefore: boolean;
-    hasAfter: boolean;
-}
-export interface MemoryAtlasResult {
-    totalCount: number;
-    records: MemoryRecord[];
-    buckets: MemoryAtlasBucket[];
-    clusters: MemoryAtlasCluster[];
-    windowCursor: MemoryAtlasWindowCursor | null;
-    timeRange: {
-        startAt: number;
-        endAt: number;
-    } | null;
-}
-export type MemorySourceKind = "manual" | "explicit" | "document" | "image" | "video" | "auto" | "turn" | "dream" | "agent";
-export type MemoryClaimStatus = "active" | "superseded" | "conflicted" | "archived" | "pending_confirmation";
-export type MemoryProposalStatus = "pending" | "accepted" | "merged" | "conflicted" | "rejected";
-export interface MemoryObservationInput {
-    userId: string;
-    text: string;
-    source: string;
-    sourcePriority: number;
-    sessionId?: string;
-    evidenceType?: string;
-    payload?: Record<string, unknown>;
-}
-export interface MemoryObservationRecord extends Required<Omit<MemoryObservationInput, "payload" | "sessionId" | "evidenceType">> {
-    id: string;
-    sessionId: string;
-    evidenceType: string;
-    payload: Record<string, unknown>;
-    createdAt: number;
-}
-export interface MemoryProposalInput {
-    userId: string;
-    observationIds: string[];
-    text: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sourcePriority: number;
-    entity: string;
-    predicate: string;
-    value: Record<string, unknown>;
-    validTime?: string;
-    tags?: string[];
-    status?: MemoryProposalStatus;
-    relatedClaimIds?: string[];
-}
-export interface MemoryProposalRecord extends Omit<MemoryProposalInput, "value" | "validTime" | "tags" | "status" | "relatedClaimIds"> {
-    id: string;
-    value: Record<string, unknown>;
-    validTime: string;
-    tags: string[];
-    status: MemoryProposalStatus;
-    relatedClaimIds: string[];
-    createdAt: number;
-    updatedAt: number;
-}
-export interface MemoryClaimInput {
-    userId: string;
-    memoryId?: string;
-    entity: string;
-    predicate: string;
-    value: Record<string, unknown>;
-    text: string;
-    category: string;
-    importance: number;
-    confidence: number;
-    source: string;
-    sourcePriority: number;
-    status: MemoryClaimStatus;
-    validTime?: string;
-    evidenceIds: string[];
-    supersedesClaimId?: string;
-    conflictGroupId?: string;
-}
-export interface MemoryClaimRecord extends Omit<MemoryClaimInput, "memoryId" | "value" | "validTime" | "supersedesClaimId" | "conflictGroupId"> {
-    id: string;
-    memoryId: string;
-    value: Record<string, unknown>;
-    validTime: string;
-    supersedesClaimId: string;
-    conflictGroupId: string;
-    createdAt: number;
-    updatedAt: number;
-}
-export interface MemoryConflictRecord {
-    id: string;
-    userId: string;
-    claimAId: string;
-    claimBId: string;
-    reason: string;
-    status: "open" | "resolved" | "dismissed";
-    createdAt: number;
-    updatedAt: number;
-}
-export interface SqliteDatabase {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement;
-    pragma(pragma: string): unknown;
-    close(): void;
-}
-export interface SqliteStatement {
-    run(...params: unknown[]): {
-        changes: number;
-        lastInsertRowid: number | bigint;
-    };
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-}
 export declare class LocalMemoryStore {
     private db;
     constructor(db: SqliteDatabase);
@@ -438,6 +245,12 @@ export declare class LocalMemoryStore {
     enforceCapacityLimit(userId: string, maxCount?: number): number;
     insertObservation(input: MemoryObservationInput): string;
     insertProposal(input: MemoryProposalInput): string;
+    /**
+     * Look up an existing proposal by its idempotency key (feedback distillation — §10). Returns the
+     * proposal id if one already exists for this user + key, else null, letting proposeExtracted skip
+     * a duplicate crash-safely (the key survives a worker restart mid-sweep).
+     */
+    findProposalByIdempotencyKey(userId: string, idempotencyKey: string): string | null;
     updateProposalStatus(id: string, status: MemoryProposalStatus, relatedClaimIds?: string[]): boolean;
     insertClaim(input: MemoryClaimInput): string;
     listClaims(userId: string, statuses?: MemoryClaimStatus[]): MemoryClaimRecord[];

package/dist/types/skills/memory/memory-consolidation.d.ts

@@ -9,6 +9,20 @@ export interface ExtractedMemoryItem {
     tags?: string[];
     /** Ids of already-uploaded attachments to link to this memory on commit. */
     attachmentIds?: string[];
+    /**
+     * Explicit confidence for evidence-bearing sources (feedback distillation — §10). When set,
+     * proposeExtracted uses it verbatim instead of the source-derived default. Other callers omit it.
+     */
+    confidence?: number;
+    /**
+     * Evidence trail for distillation-style sources. `refs` (e.g. feedbackIds + turn:<id>) is stored
+     * on the observation for audit; `idempotencyKey` makes the proposal insert crash-safe + dedup'd.
+     */
+    evidence?: {
+        kind: string;
+        refs: string[];
+        idempotencyKey: string;
+    };
 }
 export interface MemoryConsolidationOptions {
     source?: string;

package/dist/types/skills/memory/sqlite-memory-schema.d.ts

@@ -1,3 +1,3 @@
 import type { SqliteDatabase } from "./local-store-records.js";
-export declare const MEMORY_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  text TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  source TEXT NOT NULL DEFAULT 'agent',\n  session_id TEXT NOT NULL DEFAULT '',\n  event_date TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  embedding BLOB,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed_at INTEGER NOT NULL DEFAULT 0,\n  is_archived INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);\nCREATE INDEX IF NOT EXISTS idx_memories_user_category ON memories(user_id, category);\nCREATE INDEX IF NOT EXISTS idx_memories_user_importance ON memories(user_id, importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);\n\nCREATE TABLE IF NOT EXISTS memory_observations (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  session_id TEXT NOT NULL DEFAULT '',\n  evidence_type TEXT NOT NULL DEFAULT 'text',\n  payload TEXT NOT NULL DEFAULT '{}',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_observations_user_created ON memory_observations(user_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_memory_observations_source ON memory_observations(user_id, source);\n\nCREATE TABLE IF NOT EXISTS memory_proposals (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  observation_ids TEXT NOT NULL DEFAULT '[]',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  valid_time TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  status TEXT NOT NULL DEFAULT 'pending',\n  related_claim_ids TEXT NOT NULL DEFAULT '[]',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_user_status ON memory_proposals(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_fact ON memory_proposals(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_claims (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'active',\n  valid_time TEXT NOT NULL DEFAULT '',\n  evidence_ids TEXT NOT NULL DEFAULT '[]',\n  supersedes_claim_id TEXT NOT NULL DEFAULT '',\n  conflict_group_id TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_claims_user_status ON memory_claims(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_memory ON memory_claims(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_fact ON memory_claims(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_conflicts (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  claim_a_id TEXT NOT NULL,\n  claim_b_id TEXT NOT NULL,\n  reason TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'open',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_conflicts_user_status ON memory_conflicts(user_id, status);\n\nCREATE TABLE IF NOT EXISTS memory_attachments (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'file',\n  filename TEXT NOT NULL DEFAULT '',\n  mime_type TEXT NOT NULL DEFAULT '',\n  size INTEGER NOT NULL DEFAULT 0,\n  rel_path TEXT NOT NULL,\n  extracted_text TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_memory ON memory_attachments(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_orphan ON memory_attachments(user_id, memory_id, created_at);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(\n  id UNINDEXED,\n  user_id UNINDEXED,\n  text,\n  category,\n  tags,\n  content=memories,\n  content_rowid=rowid,\n  tokenize='unicode61 remove_diacritics 2'\n);\n\nCREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n";
+export declare const MEMORY_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  text TEXT NOT NULL,\n  user_id TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  source TEXT NOT NULL DEFAULT 'agent',\n  session_id TEXT NOT NULL DEFAULT '',\n  event_date TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  embedding BLOB,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed_at INTEGER NOT NULL DEFAULT 0,\n  is_archived INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);\nCREATE INDEX IF NOT EXISTS idx_memories_user_category ON memories(user_id, category);\nCREATE INDEX IF NOT EXISTS idx_memories_user_importance ON memories(user_id, importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);\n\nCREATE TABLE IF NOT EXISTS memory_observations (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  text TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  session_id TEXT NOT NULL DEFAULT '',\n  evidence_type TEXT NOT NULL DEFAULT 'text',\n  payload TEXT NOT NULL DEFAULT '{}',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_observations_user_created ON memory_observations(user_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_memory_observations_source ON memory_observations(user_id, source);\n\nCREATE TABLE IF NOT EXISTS memory_proposals (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  observation_ids TEXT NOT NULL DEFAULT '[]',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  valid_time TEXT NOT NULL DEFAULT '',\n  tags TEXT NOT NULL DEFAULT '[]',\n  status TEXT NOT NULL DEFAULT 'pending',\n  related_claim_ids TEXT NOT NULL DEFAULT '[]',\n  idempotency_key TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_user_status ON memory_proposals(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_proposals_fact ON memory_proposals(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_claims (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  entity TEXT NOT NULL DEFAULT '',\n  predicate TEXT NOT NULL DEFAULT '',\n  value_json TEXT NOT NULL DEFAULT '{}',\n  text TEXT NOT NULL,\n  category TEXT NOT NULL DEFAULT 'general',\n  importance REAL NOT NULL DEFAULT 0.5,\n  confidence REAL NOT NULL DEFAULT 0.5,\n  source TEXT NOT NULL DEFAULT 'agent',\n  source_priority INTEGER NOT NULL DEFAULT 0,\n  status TEXT NOT NULL DEFAULT 'active',\n  valid_time TEXT NOT NULL DEFAULT '',\n  evidence_ids TEXT NOT NULL DEFAULT '[]',\n  supersedes_claim_id TEXT NOT NULL DEFAULT '',\n  conflict_group_id TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_claims_user_status ON memory_claims(user_id, status);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_memory ON memory_claims(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_claims_fact ON memory_claims(user_id, entity, predicate, valid_time);\n\nCREATE TABLE IF NOT EXISTS memory_conflicts (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL,\n  claim_a_id TEXT NOT NULL,\n  claim_b_id TEXT NOT NULL,\n  reason TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'open',\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_conflicts_user_status ON memory_conflicts(user_id, status);\n\nCREATE TABLE IF NOT EXISTS memory_attachments (\n  id TEXT PRIMARY KEY,\n  memory_id TEXT NOT NULL DEFAULT '',\n  user_id TEXT NOT NULL,\n  kind TEXT NOT NULL DEFAULT 'file',\n  filename TEXT NOT NULL DEFAULT '',\n  mime_type TEXT NOT NULL DEFAULT '',\n  size INTEGER NOT NULL DEFAULT 0,\n  rel_path TEXT NOT NULL,\n  extracted_text TEXT NOT NULL DEFAULT '',\n  created_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_memory ON memory_attachments(memory_id);\nCREATE INDEX IF NOT EXISTS idx_memory_attachments_orphan ON memory_attachments(user_id, memory_id, created_at);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(\n  id UNINDEXED,\n  user_id UNINDEXED,\n  text,\n  category,\n  tags,\n  content=memories,\n  content_rowid=rowid,\n  tokenize='unicode61 remove_diacritics 2'\n);\n\nCREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN\n  INSERT INTO memories_fts(memories_fts, rowid, id, user_id, text, category, tags)\n  VALUES ('delete', old.rowid, old.id, old.user_id, old.text, old.category, old.tags);\n  INSERT INTO memories_fts(rowid, id, user_id, text, category, tags)\n  VALUES (new.rowid, new.id, new.user_id, new.text, new.category, new.tags);\nEND;\n";
 export declare function initializeMemorySchema(db: SqliteDatabase): void;

package/dist/types/skills/skill-system/skill-bundles.d.ts

@@ -0,0 +1,8 @@
+export interface SkillBundle {
+    name: string;
+    skills: string[];
+    filePath: string;
+}
+export declare function getSkillBundlesDir(): string;
+export declare function listSkillBundles(bundleDir?: string): SkillBundle[];
+export declare function resolveSkillBundle(name: string, bundleDir?: string): SkillBundle | undefined;

package/dist/types/skills/skill-system/skill-frontmatter.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedSkillFrontmatter, SkillInvocationPolicy, SkillMetadata } from "./skill-types.js";
+import type { ParsedSkillFrontmatter, SkillMetadata } from "./skill-types.js";
 /**
  * Parse a YAML-like frontmatter block into a flat key→value record.
  * Uses a lightweight line parser to avoid a YAML library dependency.
@@ -9,10 +9,6 @@ export declare function parseFrontmatter(content: string): ParsedSkillFrontmatte
  * Expects `metadata: {"openclaw": {...}}` (JSON format).
  */
 export declare function resolveSkillMetadata(frontmatter: ParsedSkillFrontmatter): SkillMetadata | undefined;
-/**
- * Resolve invocation policy from frontmatter fields.
- */
-export declare function resolveSkillInvocationPolicy(frontmatter: ParsedSkillFrontmatter): SkillInvocationPolicy;
 /**
  * Get the canonical key for a skill (metadata.skillKey or skill.name).
  */

package/dist/types/skills/skill-system/skill-lifecycle.d.ts

@@ -10,6 +10,8 @@ export interface SkillLifecycleRecord {
     archivedAt?: string;
     pinned: boolean;
     useCount: number;
+    positiveCount?: number;
+    negativeCount?: number;
     source: "learned" | "created" | "installed" | "promoted";
     resourceType?: string;
     launcherRequired?: boolean;
@@ -28,6 +30,14 @@ export interface SkillLifecycleStore {
     version: 1;
     records: Record<string, SkillLifecycleRecord>;
 }
+export interface SkillUsageStats {
+    invokeCount: number;
+    activeCount: number;
+    positiveCount: number;
+    negativeCount: number;
+    lastUsedAt?: string;
+    successRate?: number;
+}
 export interface CuratorResult {
     transitioned: Array<{
         name: string;
@@ -45,7 +55,7 @@ export declare function ensureRecord(store: SkillLifecycleStore, name: string, s
 /**
  * Record a skill invocation — resets to active if stale.
  */
-export declare function recordInvocation(store: SkillLifecycleStore, name: string): void;
+export declare function recordInvocation(store: SkillLifecycleStore, name: string, success?: boolean): void;
 /**
  * Record that a skill was viewed/listed.
  */
@@ -87,6 +97,8 @@ export declare function getSkillsByState(store: SkillLifecycleStore, state: Skil
  * Get lifecycle record for a skill. Returns undefined if not tracked.
  */
 export declare function getLifecycleRecord(store: SkillLifecycleStore, name: string): SkillLifecycleRecord | undefined;
+export declare function getLifecycleSkillStats(store: SkillLifecycleStore, name: string): SkillUsageStats | undefined;
+export declare function getAllLifecycleSkillStats(store: SkillLifecycleStore): Record<string, SkillUsageStats>;
 /**
  * Remove a lifecycle record (e.g., when skill is deleted).
  */

package/dist/types/skills/skill-system/skill-preprocessing.d.ts

@@ -0,0 +1,11 @@
+export interface SkillTemplateVars {
+    skillDir?: string;
+    sessionId?: string;
+}
+export interface SkillPreprocessOptions extends SkillTemplateVars {
+    inlineShell?: boolean;
+    runInlineShellCommand?: (command: string) => Promise<string>;
+    maxInlineShellOutput?: number;
+}
+export declare function preprocessSkillContent(content: string, options?: SkillPreprocessOptions): Promise<string>;
+export declare function substituteSkillTemplateVars(content: string, vars?: SkillTemplateVars): string;

package/dist/types/skills/skill-system/skill-types.d.ts

@@ -63,78 +63,3 @@ export interface SkillMetadata {
     };
     install?: SkillInstallSpec[];
 }
-/**
- * Controls how a skill may be activated by user commands or model tool calls.
- */
-export interface SkillInvocationPolicy {
-    /** Whether users can directly invoke this skill via slash-command. */
-    userInvocable: boolean;
-    /** If true, the model cannot trigger this skill autonomously. */
-    disableModelInvocation: boolean;
-}
-/**
- * Slash-command dispatch specification for a skill.
- */
-export interface SkillCommandDispatchSpec {
-    kind: "tool";
-    toolName: string;
-    argMode?: "raw";
-}
-/**
- * A skill-derived slash-command for IM platforms.
- */
-export interface SkillCommandSpec {
-    name: string;
-    skillName: string;
-    description: string;
-    dispatch?: SkillCommandDispatchSpec;
-}
-export type SkillScanSeverity = "info" | "warn" | "critical";
-export interface SkillScanFinding {
-    ruleId: string;
-    severity: SkillScanSeverity;
-    file: string;
-    line: number;
-    message: string;
-    evidence: string;
-}
-export interface SkillScanSummary {
-    scannedFiles: number;
-    critical: number;
-    warn: number;
-    info: number;
-    findings: SkillScanFinding[];
-}
-export interface SkillScanOptions {
-    includeFiles?: string[];
-    maxFiles?: number;
-    maxFileBytes?: number;
-}
-/**
- * Filesystem dependencies injected by the host runtime.
- * Keeps the skill system decoupled from Node.js `fs` / `path`.
- */
-export interface SkillFsDeps {
-    readFileSync(path: string, encoding: "utf-8"): string;
-    readFile(path: string, encoding: "utf-8"): Promise<string>;
-    existsSync(path: string): boolean;
-    statSync(path: string): {
-        size: number;
-        mtimeMs: number;
-        isDirectory(): boolean;
-    };
-    readdirSync(path: string, opts: {
-        withFileTypes: true;
-    }): Array<{
-        name: string;
-        isDirectory(): boolean;
-        isSymbolicLink(): boolean;
-    }>;
-    realpathSync(path: string): string;
-}
-export interface SkillPathDeps {
-    join(...segments: string[]): string;
-    resolve(...segments: string[]): string;
-    extname(p: string): string;
-    sep: string;
-}

package/dist/types/skills/skill-system/skill-validation.d.ts

@@ -5,6 +5,7 @@ export interface FrontmatterValidationResult {
     /** Parsed frontmatter if valid. */
     parsed?: Record<string, string>;
 }
+export declare const MAX_DESCRIPTION_LENGTH = 60;
 /**
  * Validate SKILL.md content for required frontmatter structure.
  * Used before persisting agent-created skills.

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

@@ -27,7 +27,7 @@ export declare const SKILL_VIEW_TOOL_SCHEMA: {
     readonly properties: {
         readonly name: {
             readonly type: "string";
-            readonly description: "The skill to use. Calling skill_view(name='X') loads that skill and you follow its instructions in THIS turn — that single call is all you need to USE a skill.";
+            readonly description: "The skill to use. For a matching workflow, call skill_view before read/search/exec/MCP. Calling skill_view(name='X') loads that skill and you follow its instructions in THIS turn - that single call is all you need to USE a skill.";
         };
         readonly args: {
             readonly type: "string";
@@ -104,6 +104,7 @@ export interface SkillListOutput {
 export interface SkillViewOutput {
     name: string;
     content: string;
+    skillDir?: string;
     referenceFiles?: string[];
 }
 export interface SkillManageResult {
@@ -121,7 +122,7 @@ export interface SkillToolDeps {
     /** View skill with optional file path. */
     viewSkill(name: string, filePath?: string): Promise<SkillViewOutput | null>;
     /** Run a skill — returns its instructions for the main model to follow inline (mainstream, no sub-turn). */
-    runSkillInvocation?(skillName: string, skillContent: string, userArgs: string | undefined, signal?: AbortSignal): Promise<string>;
+    runSkillInvocation(skillName: string, skillContent: string, userArgs: string | undefined, skillDir: string | undefined, signal?: AbortSignal): Promise<string>;
     /** Manage skill (create/edit/patch/delete). */
     manageSkill(params: {
         action: string;