@arnilo/prism 0.1.3 → 0.1.5

package/dist/contracts-core.js

@@ -0,0 +1,119 @@
+export const SESSION_ENTRY_KINDS = [
+    "message",
+    "event",
+    "summary",
+    "metadata",
+    "model_change",
+    "label",
+    "custom",
+    "compaction",
+];
+const SESSION_ENTRY_KIND_SET = new Set(SESSION_ENTRY_KINDS);
+export const SESSION_ENTRY_SCHEMA_VERSION = 1;
+export function isSessionEntryKind(value) {
+    return typeof value === "string" && SESSION_ENTRY_KIND_SET.has(value);
+}
+/** Host-written `SessionRecord.metadata` / session metadata key for workspace filtering. */
+export const SESSION_SEARCH_WORKSPACE_METADATA_KEY = "workspaceRoot";
+export const DEFAULT_SESSION_SEARCH_LIMIT = 20;
+export const HARD_MAX_SESSION_SEARCH_LIMIT = 100;
+export const DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES = 4 * 1024;
+export const HARD_MAX_SESSION_SEARCH_QUERY_BYTES = 16 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES = 512;
+export const HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES = 4 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES = 1 * 1024;
+export const HARD_MAX_SESSION_SEARCH_CURSOR_BYTES = 4 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 1_000;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 5_000;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 10_000;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 50_000;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES = 8 * 1024 * 1024;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_BYTES = 64 * 1024 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES = 1_000;
+export const HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES = 5_000;
+/**
+ * O(1) validation before any scan/query. Applies default page limit; rejects NaN,
+ * non-positive limits, oversize query/cursor/filter strings, and invalid order.
+ */
+export function resolveSessionSearchQuery(query) {
+    const limit = query.limit === undefined ? DEFAULT_SESSION_SEARCH_LIMIT : query.limit;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > HARD_MAX_SESSION_SEARCH_LIMIT) {
+        throw new TypeError(`SessionSearchQuery.limit must be a safe integer from 1 to ${HARD_MAX_SESSION_SEARCH_LIMIT}`);
+    }
+    const order = query.order ?? "desc";
+    if (order !== "asc" && order !== "desc") {
+        throw new TypeError('SessionSearchQuery.order must be "asc" or "desc"');
+    }
+    assertSearchStringBytes(query.query, "query", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.cursor, "cursor", HARD_MAX_SESSION_SEARCH_CURSOR_BYTES);
+    assertSearchStringBytes(query.workspaceRoot, "workspaceRoot", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.provider, "provider", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.model, "model", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.label, "label", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.summary, "summary", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.tenantId, "tenantId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.accountId, "accountId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.userId, "userId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.fromUpdatedAt, "fromUpdatedAt", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.toUpdatedAt, "toUpdatedAt", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    return { ...query, limit, order };
+}
+function assertSearchStringBytes(value, name, hardMax) {
+    if (value === undefined)
+        return;
+    if (typeof value !== "string") {
+        throw new TypeError(`SessionSearchQuery.${name} must be a string`);
+    }
+    // ponytail: UTF-8 byte length via TextEncoder; upgrade only if a non-Unicode host appears.
+    const bytes = new TextEncoder().encode(value).byteLength;
+    if (bytes > hardMax) {
+        throw new TypeError(`SessionSearchQuery.${name} exceeds ${hardMax} bytes`);
+    }
+}
+export const SESSION_SEARCH_UNSUPPORTED_CODE = "session_search_unsupported";
+/** Thrown when a store opts out of `searchSessions` (memory `unsupported`, JSONL). */
+export class SessionSearchUnsupportedError extends Error {
+    code = SESSION_SEARCH_UNSUPPORTED_CODE;
+    constructor(message = "session search is unsupported by this store") {
+        super(message);
+        this.name = "SessionSearchUnsupportedError";
+    }
+}
+export function isSessionSearchUnsupported(error) {
+    return error instanceof Error && error.code === SESSION_SEARCH_UNSUPPORTED_CODE;
+}
+/** Stable error code carried by `SessionAppendConflictError`. */
+export const SESSION_APPEND_CONFLICT_CODE = "session_append_conflict";
+/**
+ * Thrown when `SessionStore.append` rejects an entry under `SessionAppendOptions`
+ * (dangling/stale `expectedParentId`, stricter adapter CAS failure, or duplicate
+ * idempotency key for the same parent). Recognize via the stable `code` and
+ * `isSessionAppendConflict`, not message text.
+ */
+export class SessionAppendConflictError extends Error {
+    conflict;
+    code = SESSION_APPEND_CONFLICT_CODE;
+    constructor(conflict) {
+        const detail = conflict.idempotencyDuplicate
+            ? `idempotency key already used`
+            : conflict.currentLeafId !== undefined
+                ? `expected parent ${conflict.expectedParentId ?? "<none>"} does not match current leaf ${conflict.currentLeafId}`
+                : `expected parent ${conflict.expectedParentId ?? "<none>"} is unavailable`;
+        super(`session append conflict: ${detail}`);
+        this.conflict = conflict;
+        this.name = "SessionAppendConflictError";
+    }
+}
+/** Type guard keyed off the stable `code` (works across bundles; not message text). */
+export function isSessionAppendConflict(error) {
+    return error instanceof Error && error.code === SESSION_APPEND_CONFLICT_CODE;
+}
+const SESSION_METADATA_KEY_PATTERN = /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/;
+/** Validate a top-level `SessionRecord.metadata` key used by `SessionQuery.metadataKey` filters. */
+export function assertSessionMetadataKey(key) {
+    if (typeof key !== "string" || !SESSION_METADATA_KEY_PATTERN.test(key)) {
+        throw new RangeError("metadataKey must match /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/");
+    }
+    return key;
+}
+//# sourceMappingURL=contracts-core.js.map