@arnilo/prism-coding-agent 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -29,7 +29,7 @@ export { createMoveTool } from "./move.js";
 export type { ReadOperations, ReadTextOptions, ReadTextResult, ReadToolOptions, TransformImage, TransformImageInput, } from "./read.js";
 export { createReadTool, DEFAULT_MAX_IMAGE_BYTES, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, } from "./read.js";
 export type { ReadPathSet } from "./read-path-set.js";
-export { createReadPathSet } from "./read-path-set.js";
+export { createReadPathSet, createReadPathSetPersistence, DEFAULT_MAX_PERSISTED_READ_PATHS, DEFAULT_MAX_PERSISTED_READ_PATH_CHARS, READ_PATH_SET_NAMESPACE, } from "./read-path-set.js";
 export type { RepoEntryKind, RepoListEntry, RepositoryGlobRequest, RepositoryGlobResult, RepositoryLimitOptions, RepositoryListRequest, RepositoryListResult, RepositoryOperations, RepoSearchOutputMode, RepositorySearchMatch, RepositorySearchRequest, RepositorySearchResult, ResolvedRepositoryLimits, RepositoryWalk, RepositoryWalkEvent, RepositoryWalkLimits, } from "./repository.js";
 export { compileSearchPattern, createLocalRepositoryOperations, DEFAULT_REPO_EXCLUDE, isBinaryBuffer, RepositoryError, resolveRepoPath, resolveRepositoryLimits, toRepoRelative, } from "./repository.js";
 export type { GitAwareRepositoryOptions } from "./git-aware-repository.js";

package/dist/index.js

@@ -20,7 +20,7 @@ export { matchGlobPattern, validateGlobPattern } from "./glob-match.js";
 export { createRepoListTool } from "./list.js";
 export { createMoveTool } from "./move.js";
 export { createReadTool, DEFAULT_MAX_IMAGE_BYTES, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, } from "./read.js";
-export { createReadPathSet } from "./read-path-set.js";
+export { createReadPathSet, createReadPathSetPersistence, DEFAULT_MAX_PERSISTED_READ_PATHS, DEFAULT_MAX_PERSISTED_READ_PATH_CHARS, READ_PATH_SET_NAMESPACE, } from "./read-path-set.js";
 export { compileSearchPattern, createLocalRepositoryOperations, DEFAULT_REPO_EXCLUDE, isBinaryBuffer, RepositoryError, resolveRepoPath, resolveRepositoryLimits, toRepoRelative, } from "./repository.js";
 export { createGitAwareRepositoryOperations, parseGitLsFilesZ } from "./git-aware-repository.js";
 export { applyTextEdits, createLanguageIntelligence, encodeLspFrame, LanguageIntelligenceError, LspFrameError, LspFrameReader, resolveLanguageIntelligenceLimits, } from "./language/index.js";

package/dist/read-path-set.d.ts

@@ -12,3 +12,31 @@ export interface ReadBeforeWriteOptions {
 }
 /** Returns refusal message, or null when the mutation may proceed. */
 export declare function refuseReadBeforeWrite(operation: "write" | "edit", displayPath: string, absolutePath: string, options: ReadBeforeWriteOptions | undefined, force: boolean): string | null;
+/** Checkpoint namespace for the host-owned read-path set (plan 015 Task 4). */
+export declare const READ_PATH_SET_NAMESPACE: "prism.coding-agent.read-path-set";
+/** Persistence bounds (plan 015 Task 4): paths are names, not contents. */
+export declare const DEFAULT_MAX_PERSISTED_READ_PATHS = 1024;
+export declare const DEFAULT_MAX_PERSISTED_READ_PATH_CHARS = 1024;
+export interface CreateReadPathSetPersistenceOptions {
+    /** Host-owned generic checkpoint store (ownership-scoped). */
+    readonly checkpoints: import("@arnilo/prism").CheckpointStore;
+    /** Checkpoint key, typically the session id. */
+    readonly key: string;
+    /** Ownership scope; part of the trust boundary — restore under another scope fails closed. */
+    readonly ownership?: import("@arnilo/prism").OwnershipScope;
+    /** Path-count cap (default 1024). */
+    readonly maxPaths?: number;
+    /** Per-path char cap (default 1024). */
+    readonly maxPathChars?: number;
+}
+export interface ReadPathSetPersistence {
+    /** Write the current set (CAS read-modify-write; conflicts surface to the host). */
+    save(set: ReadPathSet): Promise<void>;
+    /** Read persisted paths back into the set; returns how many were restored. */
+    restore(set: ReadPathSet): Promise<number>;
+}
+/**
+ * Opt-in persistence for the host-owned read-path set (plan 015 Task 4): names only,
+ * bounded, ownership-scoped, fail-closed on malformed or oversized payloads. Default off.
+ */
+export declare function createReadPathSetPersistence(options: CreateReadPathSetPersistenceOptions): ReadPathSetPersistence;

package/dist/read-path-set.js

@@ -23,4 +23,62 @@ export function refuseReadBeforeWrite(operation, displayPath, absolutePath, opti
         return null;
     return `Refusing ${operation} to ${displayPath}: not read in this session. Read first or pass force=true.`;
 }
+/** Checkpoint namespace for the host-owned read-path set (plan 015 Task 4). */
+export const READ_PATH_SET_NAMESPACE = "prism.coding-agent.read-path-set";
+/** Persistence bounds (plan 015 Task 4): paths are names, not contents. */
+export const DEFAULT_MAX_PERSISTED_READ_PATHS = 1024;
+export const DEFAULT_MAX_PERSISTED_READ_PATH_CHARS = 1024;
+/**
+ * Opt-in persistence for the host-owned read-path set (plan 015 Task 4): names only,
+ * bounded, ownership-scoped, fail-closed on malformed or oversized payloads. Default off.
+ */
+export function createReadPathSetPersistence(options) {
+    const maxPaths = Math.max(1, options.maxPaths ?? DEFAULT_MAX_PERSISTED_READ_PATHS);
+    const maxPathChars = Math.max(1, options.maxPathChars ?? DEFAULT_MAX_PERSISTED_READ_PATH_CHARS);
+    return {
+        async save(set) {
+            const paths = set.list();
+            if (paths.length > maxPaths) {
+                throw new Error(`Read-path set exceeds ${maxPaths} persisted paths (${paths.length})`);
+            }
+            for (const path of paths) {
+                if (typeof path !== "string" || path.length > maxPathChars) {
+                    throw new Error(`Read-path exceeds ${maxPathChars} chars and cannot be persisted`);
+                }
+            }
+            const existing = await options.checkpoints.loadCheckpoint({
+                namespace: READ_PATH_SET_NAMESPACE,
+                key: options.key,
+                ...options.ownership,
+            });
+            await options.checkpoints.saveCheckpoint({
+                namespace: READ_PATH_SET_NAMESPACE,
+                key: options.key,
+                version: (existing?.version ?? 0) + 1,
+                expectedVersion: existing?.version ?? 0,
+                value: paths,
+                category: "session-state",
+                ...options.ownership,
+            });
+        },
+        async restore(set) {
+            const record = await options.checkpoints.loadCheckpoint({
+                namespace: READ_PATH_SET_NAMESPACE,
+                key: options.key,
+                ...options.ownership,
+            });
+            if (!record?.value)
+                return 0;
+            const paths = record.value;
+            if (!Array.isArray(paths) ||
+                paths.length > maxPaths ||
+                paths.some((path) => typeof path !== "string" || path.length > maxPathChars)) {
+                throw new Error("Persisted read-path set is malformed or exceeds bounds; refusing to restore");
+            }
+            for (const path of paths)
+                set.add(path);
+            return paths.length;
+        },
+    };
+}
 //# sourceMappingURL=read-path-set.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arnilo/prism-coding-agent",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Optional coding-agent tools (shell, read, write, edit, repo_list, repo_search, glob, delete, move, opt-in Git/check/ask-user-decision, and durable plan/checkpoint helpers) package for Prism.",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,8 @@
     "diff": "^9.0.0"
   },
   "peerDependencies": {
-    "@arnilo/prism": "0.1.2",
-    "@arnilo/prism-workflows": "0.1.2"
+    "@arnilo/prism": "0.1.3",
+    "@arnilo/prism-workflows": "0.1.3"
   },
   "devDependencies": {
     "@arnilo/prism": "file:../..",