qlogicagent 2.10.49 → 2.11.1

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

@@ -0,0 +1,62 @@
+/**
+ * MemoryAttachmentStore — persistent attachment storage for long-term memory.
+ *
+ * Files live beside the memory DB, with no expiry:
+ *   ~/.qlogicagent/profiles/<owner>/memory/attachments/<id><ext>
+ * The DB (`memory_attachments` table, via LocalMemoryStore) is the index;
+ * this class owns the on-disk bytes + ties index rows to files.
+ *
+ * Lifecycle: an attachment is `adopt`ed at upload time (orphan, memory_id=''),
+ * then `link`ed to a memory at commit; on memory delete the files+rows are
+ * removed; long-orphaned uploads are purged.
+ */
+import type { LocalMemoryStore, MemoryAttachmentRef, MemoryAttachmentRow } from "./local-store.js";
+export declare const MAX_ATTACHMENT_BYTES: number;
+export type AttachmentKind = "image" | "audio" | "video" | "doc" | "file";
+export declare function attachmentKindFromMime(mimeType: string, filename?: string): AttachmentKind;
+export interface AdoptedAttachment {
+    id: string;
+    kind: AttachmentKind;
+    filename: string;
+    mimeType: string;
+    size: number;
+    url: string;
+}
+export interface AdoptInput {
+    /** Raw bytes (preferred). */
+    data?: Buffer;
+    /** Or a URL the store fetches (e.g. the gateway's temp MediaStore url). */
+    sourceUrl?: string;
+    filename: string;
+    mimeType: string;
+    userId: string;
+}
+export declare class MemoryAttachmentStore {
+    private readonly store;
+    private readonly dir;
+    constructor(store: LocalMemoryStore, dir: string);
+    urlFor(id: string): string;
+    toRef(row: MemoryAttachmentRow): MemoryAttachmentRef;
+    /** Persist an uploaded file + create an orphan index row (memory_id=''). */
+    adopt(input: AdoptInput): Promise<AdoptedAttachment>;
+    /** Read an attachment's bytes + mime (for multimodal understanding). */
+    readBytes(id: string): Promise<{
+        bytes: Buffer;
+        mimeType: string;
+    } | null>;
+    /** Resolve an attachment to an absolute on-disk path (for serving). Guards traversal. */
+    locate(id: string): Promise<{
+        absPath: string;
+        mimeType: string;
+        filename: string;
+    } | null>;
+    link(memoryId: string, attachmentIds: string[], userId: string): number;
+    setExtractedText(id: string, text: string): void;
+    refsForMemory(memoryId: string): MemoryAttachmentRef[];
+    /** Map of memoryId → refs, for atlas windows. */
+    refsForMemories(memoryIds: string[]): Map<string, MemoryAttachmentRef[]>;
+    /** Remove all files + index rows for a deleted memory. */
+    removeByMemoryId(memoryId: string): Promise<void>;
+    /** Purge uploads that were never linked to a saved memory. */
+    purgeOrphans(olderThanMs?: number): Promise<void>;
+}

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

@@ -7,6 +7,8 @@ export interface ExtractedMemoryItem {
     speaker?: string;
     event_date?: string;
     tags?: string[];
+    /** Ids of already-uploaded attachments to link to this memory on commit. */
+    attachmentIds?: string[];
 }
 export interface MemoryConsolidationOptions {
     source?: string;

package/dist/types/skills/memory/memory-db-path.d.ts

@@ -5,3 +5,9 @@ import type { PathService } from "../../runtime/ports/index.js";
  * profile at ~/.qlogicagent/profiles/<owner_user_id>/memory/.
  */
 export declare function resolveMemoryDbPath(ownerUserId?: string, pathService?: PathService): string;
+/**
+ * Persistent attachment directory for long-term memory, beside the memory DB:
+ * ~/.qlogicagent/profiles/<owner_user_id>/memory/attachments/
+ * Files here live as long as the memories that reference them (no expiry).
+ */
+export declare function resolveMemoryAttachmentsDir(ownerUserId?: string, pathService?: PathService): 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 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  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/tools/petdex-create-tool.d.ts

@@ -0,0 +1,61 @@
+import type { PortableTool } from "../portable-tool.js";
+import { type GeneratePetdexImage, type UploadPetdexReferenceImage } from "../../runtime/pet/petdex-forge-service.js";
+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;
+    refine_animation_id?: string;
+    refine_frame_indexes?: number[];
+    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 for targeted row/frame refinement.";
+        };
+        readonly refine_animation_id: {
+            readonly type: "string";
+            readonly enum: readonly ["idle", "thinking", "working", "done", "happy", "error", "attention", "dragging", "sleeping"];
+            readonly description: "Optional canonical animation id to regenerate against base_spritesheet_path.";
+        };
+        readonly refine_frame_indexes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+            };
+            readonly description: "Optional frame indexes to replace for targeted refinement. Accepts row-local 0..7, global 0..71, or global 1..72.";
+        };
+        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/transport/acp-server.d.ts

@@ -7,7 +7,7 @@
  * Protocol: ACP v1 over JSON-RPC 2.0 / stdio (line-delimited JSON).
  *
  * Responsibilities:
- * - Accepts ACP standard methods: initialize, session/new, session/prompt, session/end
+ * - Accepts ACP standard methods: initialize, session/new, session/prompt, session/close
  * - Accepts x/ extended methods: x/abort, x/dream, x/solo.*, x/product.*
  * - Emits ACP session/update notifications (standard + x_ extended)
  * - Translates host permission responses back to the agent
@@ -17,7 +17,7 @@
  * existing internal handlers.
  */
 import type { Transport } from "./io-transport.js";
-import { type AcpInitializeParams, type AcpInitializeResult, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionEndParams, type AcpSessionSetConfigParams, type AcpSessionUpdateType, type AcpPermissionRequestParams, type AcpPermissionRequestResult } from "../protocol/wire/index.js";
+import { type AcpInitializeParams, type AcpInitializeResult, type AcpSessionNewParams, type AcpSessionLoadParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionCloseParams, type AcpSessionSetConfigParams, type AcpSessionUpdateType, type AcpPermissionRequestParams, type AcpPermissionRequestResult } from "../protocol/wire/index.js";
 export declare const ACP_ERROR_CODES: {
     readonly PARSE_ERROR: -32700;
     readonly INVALID_REQUEST: -32600;
@@ -39,10 +39,26 @@ export interface AcpRequestHandler {
     handleAcpInitialize(params: AcpInitializeParams): Promise<AcpInitializeResult>;
     handleAcpSessionNew(params: AcpSessionNewParams): Promise<AcpSessionNewResult>;
     handleAcpSessionPrompt(params: AcpSessionPromptParams): Promise<AcpSessionPromptResult>;
-    handleAcpSessionEnd(params: AcpSessionEndParams): Promise<void>;
+    handleAcpSessionClose(params: AcpSessionCloseParams): Promise<void>;
     handleAcpSessionSetConfig(params: AcpSessionSetConfigParams): Promise<void>;
     handleAcpSessionSetModel(sessionId: string, model: string): Promise<void>;
-    handleAcpSessionSetMode(sessionId: string, mode: string): Promise<void>;
+    handleAcpSessionSetMode(sessionId: string, modeId: string): Promise<string>;
+    handleAcpSessionLoad(params: AcpSessionLoadParams): Promise<{
+        replay: Array<{
+            type: "user_message_chunk" | "agent_message_chunk";
+            content: string;
+        }>;
+    }>;
+    /** Single source of truth for advertised slash commands (also summarized by /help). */
+    buildAvailableCommands(): Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Pre-prompt slash-command intercept. Returns {handled,reply}; server emits + acks. */
+    tryDispatchCommand(params: AcpSessionPromptParams): Promise<{
+        handled: boolean;
+        reply?: string;
+    }>;
     handleAcpPermissionResponse(permissionId: string, optionId: string): void;
     handleAcpAbort(params: {
         sessionId: string;
@@ -86,7 +102,7 @@ export interface AcpServerConfig {
  * 2. Host sends `initialize` -> agent responds with capabilities
  * 3. Host sends `session/new` -> session created
  * 4. Host sends `session/prompt` -> agent runs turn, emits session/update notifications
- * 5. Host sends `session/end` -> session cleaned up
+ * 5. Host sends `session/close` -> session cleaned up
  */
 export declare class AcpServer {
     private transport;
@@ -113,8 +129,8 @@ export declare class AcpServer {
     dispatchMessage(raw: unknown): boolean;
     /**
      * Emit an ACP session/update notification to the host.
-     * Standard update types are always sent; x_ types only if host declared
-     * capabilities.extendedEvents = true.
+     * Standard update types are always sent; x_ types only if the host declared
+     * the qlogicagent capability with events enabled.
      */
     emitSessionUpdate(sessionId: string, type: AcpSessionUpdateType, payload: Record<string, unknown>): void;
     /**
@@ -133,9 +149,11 @@ export declare class AcpServer {
     private handleResponse;
     private onInitialize;
     private onSessionNew;
+    private onSessionLoad;
     private onSessionPrompt;
-    private onSessionEnd;
+    private onSessionClose;
     private onSessionSetConfig;
+    private onSessionSetMode;
     private onAbort;
     private onCancel;
     private onDream;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.10.49",
+  "version": "2.11.1",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,10 @@
     "./permissions": {
       "types": "./dist/types/permissions.d.ts",
       "default": "./dist/permissions.js"
+    },
+    "./pet-contracts": {
+      "types": "./dist/types/pet-contracts.d.ts",
+      "default": "./dist/pet-contracts.js"
     }
   },
   "files": [
@@ -52,6 +56,9 @@
       ],
       "permissions": [
         "./dist/types/permissions.d.ts"
+      ],
+      "pet-contracts": [
+        "./dist/types/pet-contracts.d.ts"
       ]
     }
   },
@@ -78,7 +85,8 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@xiaozhiclaw/provider-core": "^0.1.1",
+    "@napi-rs/canvas": "0.1.100",
+    "@xiaozhiclaw/provider-core": "0.1.2",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "nanoid": "^5.1.5",
@@ -88,6 +96,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.15.0",
+    "@zed-industries/agent-client-protocol": "0.4.5",
     "esbuild": "^0.28.0",
     "oxlint": "1.67.0",
     "tsx": "^4.19.0",

package/dist/types/runtime/pet/pet-consistency.d.ts

@@ -1,79 +0,0 @@
-/**
- * Pet Consistency Scorer — Vision model evaluation for character consistency (design §14.4).
- *
- * After generating SVGs (via skeleton or direct LLM), this module:
- *   1. Renders each SVG state to compare against the reference/base
- *   2. Uses Vision model to score visual consistency (0-10)
- *   3. Retries generation if score < threshold
- *
- * Strategies used:
- *   - Structured Prompt: fixed character description + only vary action
- *   - Post-processing validation: Vision model scores after generation
- *   - Part presence check: verify required DOM structure exists
- */
-export interface ConsistencyResult {
-    state: string;
-    score: number;
-    passed: boolean;
-    feedback?: string;
-}
-export interface ConsistencyReport {
-    overallScore: number;
-    results: ConsistencyResult[];
-    passedAll: boolean;
-    retryStates: string[];
-}
-export interface ConsistencyOptions {
-    /** Minimum score to pass (0-10). Default: 6 */
-    threshold?: number;
-    /** Max retries per state. Default: 2 */
-    maxRetries?: number;
-    /** Reference SVG (base/idle state) to compare against */
-    referenceSvg: string;
-    /** Character description for context */
-    characterDesc: string;
-}
-declare const DEFAULT_THRESHOLD = 6;
-declare const DEFAULT_MAX_RETRIES = 2;
-/**
- * Quick structural check: verify the SVG has consistent DOM structure.
- * Returns a score 0-10 based on structural similarity to reference.
- */
-export declare function structuralConsistencyScore(referenceSvg: string, candidateSvg: string): number;
-/**
- * Build the Vision model prompt for consistency scoring.
- */
-export declare function buildConsistencyPrompt(characterDesc: string, stateName: string): string;
-/**
- * Parse Vision model response to extract score and feedback.
- */
-export declare function parseConsistencyResponse(response: string): {
-    score: number;
-    feedback: string;
-};
-/**
- * Run the full consistency check pipeline.
- * Takes generated SVGs, scores each against reference, returns report.
- *
- * The `visionScore` callback is optional — if not provided, only structural
- * scoring is used (faster, no LLM cost, but less accurate).
- */
-export declare function evaluateConsistency(referenceSvg: string, stateSvgs: Record<string, string>, options?: {
-    threshold?: number;
-}): ConsistencyReport;
-/**
- * Async consistency evaluation using Vision model for high-accuracy scoring.
- * Falls back to structural scoring if Vision call fails.
- */
-export declare function evaluateConsistencyWithVision(referenceSvg: string, stateSvgs: Record<string, string>, visionScore: (referenceSvg: string, candidateSvg: string, state: string) => Promise<{
-    score: number;
-    feedback: string;
-}>, options?: {
-    threshold?: number;
-}): Promise<ConsistencyReport>;
-/**
- * Retry strategy: regenerate failed states with enhanced prompt.
- * Returns a prompt modifier string that emphasizes consistency.
- */
-export declare function buildRetryPrompt(characterDesc: string, state: string, feedback: string, attempt: number): string;
-export { DEFAULT_THRESHOLD, DEFAULT_MAX_RETRIES };

package/dist/types/runtime/pet/pet-skeleton.d.ts

@@ -1,70 +0,0 @@
-/**
- * PetSkeleton — SVG skeleton parameterization system (design §14.3 Plan A).
- *
- * Core idea: generate ONE base skeleton via LLM, then render each state by
- * only varying animation parameters (pose, expression, effects).
- * This ensures visual consistency across states without repeated LLM calls.
- *
- * Pipeline:
- *   1. LLM generates a base SVG skeleton with labeled parts
- *   2. We parse and decompose it into movable parts
- *   3. Each state applies different CSS @keyframes to the same skeleton
- */
-export interface PetSkeleton {
-    /** Raw SVG of the base pose (idle-like neutral pose) */
-    baseSvg: string;
-    /** Extracted part IDs found in the SVG */
-    parts: SkeletonPart[];
-    /** Color palette extracted from the base SVG */
-    colors: {
-        primary: string;
-        secondary: string;
-        accent?: string;
-    };
-    /** Character description used to generate this skeleton */
-    characterDesc: string;
-}
-export interface SkeletonPart {
-    id: string;
-    type: "body" | "head" | "left-eye" | "right-eye" | "left-arm" | "right-arm" | "accessory" | "effect";
-    /** CSS selector for this part within the SVG */
-    selector: string;
-}
-export interface StateAnimationParams {
-    body: BodyAnimation;
-    eyes: EyeExpression;
-    arms: ArmPose;
-    effects?: EffectOverlay[];
-}
-export type BodyAnimation = "breathe" | "sway" | "lean" | "tilt" | "shrink" | "bounce" | "still" | "float";
-export type EyeExpression = "blink" | "lookup" | "focus" | "closed" | "wide" | "sparkle" | "dizzy" | "sleepy";
-export type ArmPose = "sway" | "still" | "hammer" | "wave" | "raised" | "covering" | "hold" | "eat";
-export type EffectOverlay = "zzz" | "sparkle" | "sweat" | "question" | "ellipsis" | "heart" | "exclaim" | "music";
-export declare const STATE_ANIMATION_MAP: Record<string, StateAnimationParams>;
-/**
- * Generate the base skeleton prompt for LLM.
- * The LLM generates ONE SVG with labeled groups that we can animate differently per state.
- */
-export declare function buildSkeletonPrompt(characterDesc: string): string;
-/**
- * Parse a skeleton SVG and identify parts.
- */
-export declare function parseSkeleton(svgText: string): SkeletonPart[];
-/**
- * Render a specific state by injecting CSS animations into the skeleton SVG.
- * The skeleton remains identical — only the <style> block changes.
- */
-export declare function renderState(skeleton: PetSkeleton, state: string): string;
-/**
- * Extract primary/secondary colors from an SVG string.
- * Looks for fill/stop-color attributes and picks the two most frequent.
- */
-export declare function extractColors(svgText: string): {
-    primary: string;
-    secondary: string;
-};
-/**
- * Validate that a skeleton SVG has the required part structure.
- * Returns list of missing parts (empty = valid).
- */
-export declare function validateSkeleton(svgText: string): string[];