qlogicagent 2.14.9 → 2.15.1

package/dist/types/cli/handlers/pinned-skill-context.d.ts

@@ -0,0 +1 @@
+export declare function buildPinnedSkillContext(activeSkills: unknown, log?: (m: string) => void): string;

package/dist/types/protocol/wire/acp-protocol.d.ts

@@ -114,6 +114,9 @@ export interface AcpSessionMeta {
     /** Runtime turn-config tweaks applied via session/set_config_option. */
     temperature?: number;
     maxRounds?: number;
+    /** Skills the user explicitly pinned for this turn (scope:name or name). The turn pipeline
+     *  force-loads each one's SKILL.md, identically to the `skill` tool's invoke (cc-parity). */
+    activeSkills?: string[];
 }
 export interface AcpSessionNewParams {
     /** Working directory for the session (standard ACP field from host). */

package/dist/types/runtime/infra/agent-paths.d.ts

@@ -7,12 +7,29 @@
  */
 /** Dot-directory name used for both user-level and project-level storage. */
 export declare const AGENT_DOT_DIR = ".qlogicagent";
+/**
+ * Derive a project's stable id from its workspaceDir — the mainstream path-derived model
+ * (VS Code / Claude Code / cc-haha): same folder → same id, deterministic, recomputable, no random
+ * UUID and no central-registry dependency. A short SHA-256 prefix of the resolved, lowercased path
+ * keeps the id length-safe on Windows (260-char path limit) while staying collision-free in
+ * practice. NOTE: deliberately NO ctime salt (VS Code salts single-folder ids so recreating a folder
+ * yields fresh state — a footgun for us; we want a recreated/rebound folder to map back to its data).
+ * This is a leaf helper (crypto + path only) so project-store and project-data-paths can both import
+ * it without a dependency cycle.
+ */
+export declare function deriveProjectId(workspaceDir: string): string;
 /** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
 export declare function getUserAgentHome(): string;
 export declare function resolveActiveOwnerUserId(): string;
 export declare function encodeOwnerProfileSegment(ownerUserId: string): string;
 export declare function getOwnerProfileDir(ownerUserId?: string): string;
 export declare function getProfileMemoryDir(ownerUserId?: string): string;
+/** Dir name for our per-project companion data (sessions/checkpoints/uploads). */
+export declare const PROJECT_DATA_DIRNAME = "projectData";
+/** Root of the projectData tree for the current owner. */
+export declare function getProjectDataRoot(): string;
+/** `profiles/<owner>/projectData/<projectId>/` (projectId is the path-derived key). */
+export declare function getProjectDataDirById(projectId: string): string;
 /**
  * Ensure the user agent home directory exists and is writable.
  * Returns the path if accessible, throws with a friendly message otherwise.
@@ -57,11 +74,5 @@ export declare function getProjectSettingsPath(cwd: string): string;
 export declare function getProjectInstructionsPath(cwd: string): string;
 /** `<cwd>/.qlogicagent/rules/` — unified rules + instructions directory */
 export declare function getProjectRulesDir(cwd: string): string;
-/** `<cwd>/.qlogicagent/sessions/` */
-export declare function getProjectSessionsRoot(cwd: string): string;
-/** `<cwd>/.qlogicagent/sessions/{sessionId}` */
-export declare function getProjectSessionDir(cwd: string, sessionId: string): string;
-/** `<cwd>/.qlogicagent/checkpoints/` or `<cwd>/.qlogicagent/checkpoints/{sessionId}` */
-export declare function getProjectCheckpointsDir(cwd: string, sessionId?: string): string;
 /** `<gitRoot>/.qlogicagent/hooks/` */
 export declare function getGitRootHooksDir(gitRoot: string): string;

package/dist/types/runtime/infra/checkpoint-backend.d.ts

@@ -1,8 +1,9 @@
 /**
  * Local Checkpoint Backend — git-based shadow repo implementation.
  *
- * Creates and manages checkpoint snapshots in `<project>/.qlogicagent/checkpoints/<sessionId>/`
- * using a shadow git repository independent of the user's project .git.
+ * Creates and manages checkpoint snapshots in the centralized companion store
+ * `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/checkpoints/<sessionId>/`
+ * (NOT inside the user's workspace) using a shadow git repository independent of the user's .git.
  */
 import type { CheckpointBackend } from "../ports/checkpoint-contracts.js";
 export declare function createLocalCheckpointBackend(projectRoot: string, sessionId: string): CheckpointBackend;

package/dist/types/runtime/infra/default-path-service.d.ts

@@ -28,6 +28,6 @@ export declare class DefaultPathService implements PathService {
     getProjectInstructionsPath(projectRoot?: string): string;
     getProjectPluginsDir(projectRoot?: string): string;
     getProjectRulesDir(projectRoot?: string): string;
-    getProjectSessionsRoot(projectRoot?: string): string;
+    getProjectSessionsRoot(projectKey?: string): string;
 }
 export declare function getDefaultPathService(): PathService;

package/dist/types/runtime/infra/project-data-gc.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Project Data GC — best-effort startup reclamation of the companion-data tree, mirroring VS Code's
+ * UnusedWorkspaceStorageDataCleaner. A projectData/<id> dir is KEPT when it's either in projects.json
+ * OR carries a `project.json` back-ref (the durable truth — rebuildIndexFromBackrefs runs first and
+ * re-indexes it). Only a dir with NEITHER (truly corrupt/orphaned — crashed mid-create) is reclaimed.
+ * This makes the registry non-load-bearing for recovery: a lost projects.json never causes data loss.
+ * Also prunes stale deletion tombstones. NEVER touches live projects' data or the user's workspace.
+ */
+export declare function gcOrphanProjectData(): void;

package/dist/types/runtime/infra/project-data-paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Project Data Paths — centralized location for our per-project COMPANION data (the "account
+ * book"): session transcripts/metadata, checkpoint shadow repos, uploaded attachments, deletion
+ * tombstones. Mirrors VS Code's workspaceStorage: this data is OURS and lives in a centralized,
+ * per-project-id, physically-isolated dir under the owner profile — NEVER inside the user's
+ * workspace folder. The workspace folder holds only user work product (code/docs/generated media).
+ *
+ *   ~/.qlogicagent/profiles/<owner>/projectData/<projectId>/{sessions,checkpoints,uploads}/
+ *
+ * projectId is the PATH-DERIVED key (deriveProjectId(workspaceDir), see agent-paths) — the
+ * mainstream model (VS Code / cc-haha): same folder → same id, deterministic, recomputable, no
+ * central-registry dependency for the storage key. Deleting a project = `rm` projectData/<id>/.
+ */
+export { getProjectDataDirById, getProjectDataRoot } from "./agent-paths.js";
+/** `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/` (key = projectId or workspaceDir). */
+export declare function getProjectDataDir(key: string): string;
+/** `projectData/<id>/sessions/` */
+export declare function getProjectDataSessionsRoot(key: string): string;
+/** `projectData/<id>/checkpoints/` or `.../checkpoints/<sessionId>` */
+export declare function getProjectDataCheckpointsDir(key: string, sessionId?: string): string;
+/** `projectData/<id>/uploads/` or `.../uploads/<sessionId>` */
+export declare function getProjectDataUploadsDir(key: string, sessionId?: string): string;

package/dist/types/runtime/infra/project-store.d.ts

@@ -7,6 +7,12 @@
  * Direction A: Agent is the source of truth for project state.
  */
 import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
+/**
+ * Rebuild projects.json from the per-project `project.json` back-refs (the durable truth). Self-heals
+ * a lost/corrupted index: any projectData/<id> with a back-ref not present in projects.json is
+ * re-added. Called at startup before the default-project bootstrap.
+ */
+export declare function rebuildIndexFromBackrefs(): void;
 export declare function createProject(params: {
     name: string;
     workspaceDir: string;
@@ -15,14 +21,6 @@ export declare function createProject(params: {
     skipAutoSwitch?: boolean;
 }): ProjectInfo;
 export declare function listProjects(): ProjectInfo[];
-/**
- * True when another project (active OR archived) still references this workspaceDir. Solo/Product
- * plan projects deliberately share their host project's workspaceDir — the run executes inside the
- * user's real workspace, isolated per-agent via git worktrees — so deleting one plan project must
- * never rmSync the shared directory: that would wipe the host project and every sibling plan. Pass
- * excludeProjectId to ignore a project that's still in the store at check time.
- */
-export declare function isWorkspaceDirShared(workspaceDir: string, excludeProjectId?: string): boolean;
 export declare function getActiveProject(): ProjectInfo | null;
 export declare function getDefaultProject(): ProjectInfo | null;
 export declare function getProjectById(projectId: string): ProjectInfo | null;

package/dist/types/runtime/session/inbound-upload-persistence.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Inbound Upload Persistence (decision A) — the agent owns its companion data, so user-uploaded
+ * attachments are persisted by the AGENT (not the gateway) into the session's projectData uploads
+ * dir, where they become part of the session record and are cleaned up on session/project delete.
+ *
+ * The gateway puts an inbound attachment in its short-lived transport cache and hands the agent a
+ * `http://127.0.0.1:<port>/media/<id>` URL. We fetch those bytes once, write them under
+ * projectData/<projectId>/uploads/<sessionId>/, and rewrite the reference to a gateway local-media
+ * proxy URL pointing at the persisted file (same `/api/media/local?src=file://…` shape the gateway
+ * used before — provider-core still sees a 127.0.0.1 local URL for cloud upload, and the frontend
+ * still GETs it). Any failure degrades gracefully to the original URL (the turn still works off the
+ * transport cache; only long-term persistence is skipped).
+ */
+import type { ChatMessage } from "../../protocol/wire/index.js";
+/**
+ * Persist a single inbound upload URL to projectData uploads and return the rewritten proxy URL.
+ * Non-transport URLs (already-persisted, remote, file://) and any failure return the input unchanged.
+ */
+export declare function persistInboundUploadUrl(url: string, projectId: string, sessionId: string): Promise<string>;
+/**
+ * Persist + rewrite the inbound uploads on the LAST user message of a turn (the new message;
+ * resumed history already carries persisted local URLs). Mutates and returns the message array.
+ */
+export declare function persistInboundUploadsForTurn(messages: ChatMessage[], projectId: string | undefined, sessionId: string | undefined): Promise<ChatMessage[]>;

package/dist/types/runtime/session/session-paths.d.ts

@@ -1,6 +1,5 @@
 export declare const TRANSCRIPT_FILE = "transcript.jsonl";
 export declare const METADATA_FILE = "metadata.json";
-export declare const LEGACY_STATE_FILE = "state.json";
 export declare function sanitizeSessionId(sessionId: string): string;
 export declare function getSessionsRoot(projectRoot: string): string;
 export declare function getSessionDir(sessionId: string, projectRoot: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.14.9",
+  "version": "2.15.1",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -90,7 +90,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/pet-core": "0.1.2",
-    "@xiaozhiclaw/provider-core": "^0.1.18",
+    "@xiaozhiclaw/provider-core": "^0.1.19",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",

package/dist/types/cli/mcp-plugin-bootstrap.d.ts

@@ -1,2 +0,0 @@
-export { buildMcpBootstrapEntries, configureMcpBootstrap, type McpBootstrapDeps, } from "./mcp-bootstrap.js";
-export { configurePluginBootstrap, type PluginBootstrapDeps, } from "./plugin-bootstrap.js";

package/dist/types/cli/tool-bootstrap-providers.d.ts

@@ -1,3 +0,0 @@
-import type { RuntimeToolContract, ToolBootstrapProvider, ToolBootstrapProviderContext, ToolRegistrationModuleKind } from "../runtime/ports/index.js";
-export declare function runToolBootstrapProviders(providers: readonly ToolBootstrapProvider[], context: ToolBootstrapProviderContext): RuntimeToolContract[];
-export declare function createToolBootstrapProvider(id: string, register: ToolBootstrapProvider["register"], kind?: ToolRegistrationModuleKind): ToolBootstrapProvider;

package/dist/types/skills/memory/categories.d.ts

@@ -1 +0,0 @@
-export type { QMemoryCategory } from "../../runtime/memory/categories.js";

package/dist/types/skills/memory/find-relevant-memories.d.ts

@@ -1 +0,0 @@
-export * from "../../runtime/memory/find-relevant-memories.js";

package/dist/types/skills/memory/implicit-extraction.d.ts

@@ -1 +0,0 @@
-export * from "../../runtime/memory/implicit-extraction.js";

package/dist/types/skills/memory/recall-category-filter.d.ts

@@ -1 +0,0 @@
-export * from "../../runtime/memory/recall-category-filter.js";