qlogicagent 2.14.9 → 2.14.10

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

@@ -57,11 +57,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,7 @@
+/**
+ * Project Data GC — best-effort startup reclamation of the companion-data tree, mirroring VS Code's
+ * UnusedWorkspaceStorageDataCleaner: it only removes data that is clearly unowned (a projectData/<id>
+ * dir whose projectId has no projects.json entry — orphaned by a crash or an incomplete delete) and
+ * prunes stale deletion tombstones. It 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,28 @@
+/**
+ * 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}/
+ *
+ * Keying by projectId (not workspaceDir) decouples bookkeeping from the user's folder, so:
+ *   - deleting a project = `rm` projectData/<id>/ (always safe; never touches the user's files);
+ *   - sessions/checkpoints can never leak into, or orphan inside, an external user folder.
+ *
+ * This module is the ONE place that imports project-store for the workspaceDir→projectId reverse
+ * lookup; the low-level agent-paths stays dependency-free (no project-store cycle).
+ */
+/** `~/.qlogicagent/profiles/<owner>/projectData/<projectId>/` (key = projectId or workspaceDir). */
+export declare function getProjectDataDir(key: string): string;
+/** Direct projectData dir for a known projectId (no reverse lookup) — used by project delete/GC. */
+export declare function getProjectDataDirById(projectId: string): string;
+/** Root of the project-data tree for the current owner (for orphan GC). */
+export declare function getProjectDataRoot(): 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

@@ -48,6 +48,12 @@ export declare function findByGroupId(groupId: string): ProjectInfo | null;
  * a cwd that maps to no project is ignored rather than silently leaking files outside any project.
  */
 export declare function findByWorkspaceDir(dir: string): ProjectInfo | null;
+/**
+ * Reverse-lookup a workspaceDir to its owning projectId across ALL projects (active + archived).
+ * Used for projectData storage keying so a session/checkpoint dir resolves correctly even for an
+ * archived project (findByWorkspaceDir matches active-only and would miss it).
+ */
+export declare function findProjectIdByWorkspaceDirAnyStatus(dir: string): string | undefined;
 export declare function archiveByGroupId(groupId: string): {
     archived: boolean;
     projectId?: string;

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.14.10",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",