@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/session/remote-session-client.d.ts

@@ -0,0 +1,83 @@
+import type { FileEntry, SessionInfo } from "./types.ts";
+export type RemoteSessionInfo = Omit<SessionInfo, "path" | "created" | "modified"> & {
+    path?: string;
+    created: Date | string;
+    modified: Date | string;
+};
+export interface RemoteSessionClientOptions {
+    baseUrl: string;
+    token: string;
+    fetch?: typeof fetch;
+}
+export interface RemoteSessionSnapshot {
+    reference: string;
+    id: string;
+    version?: number;
+    entries: FileEntry[];
+    etag?: string;
+}
+export interface CreateRemoteSessionRequest {
+    id?: string;
+    cwd: string;
+    projectId?: string;
+    parentSession?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AppendRemoteSessionEntriesRequest {
+    baseEtag?: string;
+    entries: FileEntry[];
+}
+export interface AppendRemoteSessionEntriesResponse {
+    etag?: string;
+    accepted: number;
+}
+export interface ReplaceRemoteSessionSnapshotRequest {
+    baseEtag?: string;
+    entries: FileEntry[];
+}
+export interface ReplaceRemoteSessionSnapshotResponse {
+    etag?: string;
+}
+export interface ForkRemoteSessionRequest {
+    cwd: string;
+    projectId?: string;
+    leafId?: string;
+}
+export interface ImportRemoteSessionJsonlRequest {
+    cwd: string;
+    projectId?: string;
+    sourceName?: string;
+    entries: FileEntry[];
+    metadata?: Record<string, unknown>;
+}
+export interface ListRemoteSessionsResponse {
+    sessions: RemoteSessionInfo[];
+}
+export type RemoteSessionOperation = "create" | "open" | "recent" | "fork" | "import" | "list" | "append" | "replace";
+export declare class RemoteSessionClientError extends Error {
+    readonly status: number;
+    readonly responseText: string;
+    constructor(status: number, responseText: string);
+}
+export declare class RemoteSessionProtocolError extends Error {
+    readonly operation: RemoteSessionOperation;
+    constructor(operation: RemoteSessionOperation, message: string, cause?: unknown);
+}
+export declare class RemoteSessionClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(options: RemoteSessionClientOptions);
+    createSession(request: CreateRemoteSessionRequest): Promise<RemoteSessionSnapshot>;
+    openSession(sessionIdOrReference: string): Promise<RemoteSessionSnapshot>;
+    appendEntries(sessionIdOrReference: string, request: AppendRemoteSessionEntriesRequest): Promise<AppendRemoteSessionEntriesResponse>;
+    replaceSnapshot(sessionIdOrReference: string, request: ReplaceRemoteSessionSnapshotRequest): Promise<ReplaceRemoteSessionSnapshotResponse>;
+    listSessions(): Promise<ListRemoteSessionsResponse>;
+    getRecentSession(): Promise<RemoteSessionSnapshot>;
+    forkSession(sessionIdOrReference: string, request: ForkRemoteSessionRequest): Promise<RemoteSessionSnapshot>;
+    importJsonl(request: ImportRemoteSessionJsonlRequest): Promise<RemoteSessionSnapshot>;
+    private request;
+}
+export declare function parseRemoteSessionId(reference: string): string;
+export declare function formatRemoteSessionReference(sessionId: string): string;
+//# sourceMappingURL=remote-session-client.d.ts.map

package/dist/core/session/remote-session-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session-client.d.ts","sourceRoot":"","sources":["../../../src/core/session/remote-session-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { validateSessionId } from \"./ids.ts\";\nimport type { FileEntry, SessionInfo } from \"./types.ts\";\n\nexport type RemoteSessionInfo = Omit<SessionInfo, \"path\" | \"created\" | \"modified\"> & {\n\tpath?: string;\n\tcreated: Date | string;\n\tmodified: Date | string;\n};\n\nexport interface RemoteSessionClientOptions {\n\tbaseUrl: string;\n\ttoken: string;\n\tfetch?: typeof fetch;\n}\n\nexport interface RemoteSessionSnapshot {\n\treference: string;\n\tid: string;\n\tversion?: number;\n\tentries: FileEntry[];\n\tetag?: string;\n}\n\nexport interface CreateRemoteSessionRequest {\n\tid?: string;\n\tcwd: string;\n\tprojectId?: string;\n\tparentSession?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface AppendRemoteSessionEntriesRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface AppendRemoteSessionEntriesResponse {\n\tetag?: string;\n\taccepted: number;\n}\n\n// grip-ignore noNearIdenticalDataStructures: Snapshot replacement atomically rewrites complete state, while append applies incremental entries; their endpoint validation and concurrency contracts evolve independently.\nexport interface ReplaceRemoteSessionSnapshotRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface ReplaceRemoteSessionSnapshotResponse {\n\tetag?: string;\n}\n\nexport interface ForkRemoteSessionRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tleafId?: string;\n}\n\nexport interface ImportRemoteSessionJsonlRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tsourceName?: string;\n\tentries: FileEntry[];\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface ListRemoteSessionsResponse {\n\tsessions: RemoteSessionInfo[];\n}\n\nexport type RemoteSessionOperation = \"create\" | \"open\" | \"recent\" | \"fork\" | \"import\" | \"list\" | \"append\" | \"replace\";\n\nexport class RemoteSessionClientError extends Error {\n\treadonly status: number;\n\treadonly responseText: string;\n\n\tconstructor(status: number, responseText: string) {\n\t\tsuper(`Remote session request failed with status ${status}: ${responseText}`);\n\t\tthis.name = \"RemoteSessionClientError\";\n\t\tthis.status = status;\n\t\tthis.responseText = responseText;\n\t}\n}\n\nexport class RemoteSessionProtocolError extends Error {\n\treadonly operation: RemoteSessionOperation;\n\n\tconstructor(operation: RemoteSessionOperation, message: string, cause?: unknown) {\n\t\tsuper(`Invalid remote session ${operation} response: ${message}`, { cause });\n\t\tthis.name = \"RemoteSessionProtocolError\";\n\t\tthis.operation = operation;\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction requiredString(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string`);\n\t}\n\treturn value;\n}\n\nfunction stringValue(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\") {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a string`);\n\t}\n\treturn value;\n}\n\nfunction requiredSessionId(record: Record<string, unknown>, operation: RemoteSessionOperation): string {\n\tconst id = requiredString(record, \"id\", operation);\n\ttry {\n\t\tvalidateSessionId(id);\n\t} catch (error) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"id is not a valid session id\", error);\n\t}\n\treturn id;\n}\n\nfunction optionalString(\n\trecord: Record<string, unknown>,\n\tkey: string,\n\toperation: RemoteSessionOperation,\n): string | undefined {\n\tconst value = record[key];\n\tif (value === undefined) return undefined;\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string when present`);\n\t}\n\treturn value;\n}\n\nfunction decodeSnapshot(value: unknown, operation: RemoteSessionOperation, expectedId?: string): RemoteSessionSnapshot {\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"snapshot must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = requiredString(value, \"reference\", operation);\n\tif (parseRemoteSessionId(reference) !== id) {\n\t\tthrow new RemoteSessionProtocolError(operation, `reference ${reference} does not identify snapshot id ${id}`);\n\t}\n\tif (expectedId !== undefined && id !== expectedId) {\n\t\tthrow new RemoteSessionProtocolError(operation, `snapshot id ${id} does not match requested id ${expectedId}`);\n\t}\n\tif (!Array.isArray(value.entries) || value.entries.length === 0 || value.entries.some((entry) => !isRecord(entry))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must be a non-empty array of objects\");\n\t}\n\tconst header = value.entries[0];\n\tif (\n\t\t!isRecord(header) ||\n\t\theader.type !== \"session\" ||\n\t\theader.id !== id ||\n\t\ttypeof header.cwd !== \"string\" ||\n\t\ttypeof header.timestamp !== \"string\"\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must begin with a matching session header\");\n\t}\n\tconst version = value.version;\n\tif (\n\t\tversion !== undefined &&\n\t\t(typeof version !== \"number\" || !Number.isInteger(version) || version < 1 || version !== header.version)\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"version must be a positive integer matching the session header\");\n\t}\n\treturn {\n\t\treference,\n\t\tid,\n\t\tversion: version as number | undefined,\n\t\tentries: value.entries as FileEntry[],\n\t\tetag: optionalString(value, \"etag\", operation),\n\t};\n}\n\nfunction decodeForkSnapshot(value: unknown, sourceId: string): RemoteSessionSnapshot {\n\tconst snapshot = decodeSnapshot(value, \"fork\");\n\tif (snapshot.id === sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", \"fork snapshot must have a new session id\");\n\t}\n\tconst header = snapshot.entries[0];\n\tif (header?.type !== \"session\" || !header.parentSession || parseRemoteSessionId(header.parentSession) !== sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", `fork header must reference source session ${sourceId}`);\n\t}\n\treturn snapshot;\n}\n\nfunction decodeAppendResponse(value: unknown): AppendRemoteSessionEntriesResponse {\n\tconst operation = \"append\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\tif (!Number.isInteger(value.accepted)) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"accepted must be an integer\");\n\t}\n\treturn { accepted: value.accepted as number, etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeReplaceResponse(value: unknown): ReplaceRemoteSessionSnapshotResponse {\n\tconst operation = \"replace\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\treturn { etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeSessionInfo(value: unknown): RemoteSessionInfo {\n\tconst operation = \"list\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"each session must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = optionalString(value, \"reference\", operation);\n\tconst path = optionalString(value, \"path\", operation);\n\tfor (const candidate of [reference, path]) {\n\t\tif (candidate !== undefined && parseRemoteSessionId(candidate) !== id) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, `reference ${candidate} does not identify session id ${id}`);\n\t\t}\n\t}\n\tconst created = requiredString(value, \"created\", operation);\n\tconst modified = requiredString(value, \"modified\", operation);\n\tif (!Number.isFinite(Date.parse(created)) || !Number.isFinite(Date.parse(modified))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"created and modified must be valid date strings\");\n\t}\n\tif (!Number.isInteger(value.messageCount) || (value.messageCount as number) < 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"messageCount must be a non-negative integer\");\n\t}\n\treturn {\n\t\treference,\n\t\tpath,\n\t\tid,\n\t\tcwd: stringValue(value, \"cwd\", operation),\n\t\tname: optionalString(value, \"name\", operation),\n\t\tparentSessionPath: optionalString(value, \"parentSessionPath\", operation),\n\t\tcreated,\n\t\tmodified,\n\t\tmessageCount: value.messageCount as number,\n\t\tfirstMessage: stringValue(value, \"firstMessage\", operation),\n\t\tallMessagesText: stringValue(value, \"allMessagesText\", operation),\n\t};\n}\n\nfunction decodeListResponse(value: unknown): ListRemoteSessionsResponse {\n\tif (!isRecord(value) || !Array.isArray(value.sessions)) {\n\t\tthrow new RemoteSessionProtocolError(\"list\", \"sessions must be an array\");\n\t}\n\treturn { sessions: value.sessions.map((session) => decodeSessionInfo(session)) };\n}\n\nexport class RemoteSessionClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly token: string;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tconstructor(options: RemoteSessionClientOptions) {\n\t\tthis.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n\t\tthis.token = options.token;\n\t\tthis.fetchImpl = options.fetch ?? fetch;\n\t}\n\n\tcreateSession(request: CreateRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions\", request, \"create\", (value) =>\n\t\t\tdecodeSnapshot(value, \"create\", request.id),\n\t\t);\n\t}\n\n\topenSession(sessionIdOrReference: string): Promise<RemoteSessionSnapshot> {\n\t\tconst id = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"GET\", `/v1/sessions/${encodeURIComponent(id)}`, undefined, \"open\", (value) =>\n\t\t\tdecodeSnapshot(value, \"open\", id),\n\t\t);\n\t}\n\n\tappendEntries(\n\t\tsessionIdOrReference: string,\n\t\trequest: AppendRemoteSessionEntriesRequest,\n\t): Promise<AppendRemoteSessionEntriesResponse> {\n\t\treturn this.request(\n\t\t\t\"POST\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/entries`,\n\t\t\trequest,\n\t\t\t\"append\",\n\t\t\tdecodeAppendResponse,\n\t\t);\n\t}\n\n\treplaceSnapshot(\n\t\tsessionIdOrReference: string,\n\t\trequest: ReplaceRemoteSessionSnapshotRequest,\n\t): Promise<ReplaceRemoteSessionSnapshotResponse> {\n\t\treturn this.request(\n\t\t\t\"PUT\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/snapshot`,\n\t\t\trequest,\n\t\t\t\"replace\",\n\t\t\tdecodeReplaceResponse,\n\t\t);\n\t}\n\n\tlistSessions(): Promise<ListRemoteSessionsResponse> {\n\t\treturn this.request(\"GET\", \"/v1/sessions\", undefined, \"list\", decodeListResponse);\n\t}\n\n\tgetRecentSession(): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"GET\", \"/v1/sessions/recent\", undefined, \"recent\", (value) =>\n\t\t\tdecodeSnapshot(value, \"recent\"),\n\t\t);\n\t}\n\n\tforkSession(sessionIdOrReference: string, request: ForkRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\tconst sourceId = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"POST\", `/v1/sessions/${encodeURIComponent(sourceId)}/fork`, request, \"fork\", (value) =>\n\t\t\tdecodeForkSnapshot(value, sourceId),\n\t\t);\n\t}\n\n\timportJsonl(request: ImportRemoteSessionJsonlRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions/import-jsonl\", request, \"import\", (value) =>\n\t\t\tdecodeSnapshot(value, \"import\"),\n\t\t);\n\t}\n\n\tprivate async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody: unknown,\n\t\toperation: RemoteSessionOperation,\n\t\tdecode: (value: unknown) => T,\n\t): Promise<T> {\n\t\tconst response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${this.token}`,\n\t\t\t\tAccept: \"application/json\",\n\t\t\t\t...(body === undefined ? {} : { \"Content-Type\": \"application/json\" }),\n\t\t\t},\n\t\t\tbody: body === undefined ? undefined : JSON.stringify(body),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow new RemoteSessionClientError(response.status, await response.text());\n\t\t}\n\t\tif (response.status === 204) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"response body is required\");\n\t\t}\n\n\t\tlet value: unknown;\n\t\ttry {\n\t\t\tvalue = await response.json();\n\t\t} catch (error) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"body is not valid JSON\", error);\n\t\t}\n\t\treturn decode(value);\n\t}\n}\n\nexport function parseRemoteSessionId(reference: string): string {\n\treturn reference.startsWith(\"remote:\") ? reference.slice(\"remote:\".length) : reference;\n}\n\nexport function formatRemoteSessionReference(sessionId: string): string {\n\treturn sessionId.startsWith(\"remote:\") ? sessionId : `remote:${sessionId}`;\n}\n"]}

package/dist/core/session/remote-session-client.js

@@ -0,0 +1,224 @@
+import { validateSessionId } from "./ids.js";
+export class RemoteSessionClientError extends Error {
+    status;
+    responseText;
+    constructor(status, responseText) {
+        super(`Remote session request failed with status ${status}: ${responseText}`);
+        this.name = "RemoteSessionClientError";
+        this.status = status;
+        this.responseText = responseText;
+    }
+}
+export class RemoteSessionProtocolError extends Error {
+    operation;
+    constructor(operation, message, cause) {
+        super(`Invalid remote session ${operation} response: ${message}`, { cause });
+        this.name = "RemoteSessionProtocolError";
+        this.operation = operation;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requiredString(record, key, operation) {
+    const value = record[key];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new RemoteSessionProtocolError(operation, `${key} must be a non-empty string`);
+    }
+    return value;
+}
+function stringValue(record, key, operation) {
+    const value = record[key];
+    if (typeof value !== "string") {
+        throw new RemoteSessionProtocolError(operation, `${key} must be a string`);
+    }
+    return value;
+}
+function requiredSessionId(record, operation) {
+    const id = requiredString(record, "id", operation);
+    try {
+        validateSessionId(id);
+    }
+    catch (error) {
+        throw new RemoteSessionProtocolError(operation, "id is not a valid session id", error);
+    }
+    return id;
+}
+function optionalString(record, key, operation) {
+    const value = record[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0) {
+        throw new RemoteSessionProtocolError(operation, `${key} must be a non-empty string when present`);
+    }
+    return value;
+}
+function decodeSnapshot(value, operation, expectedId) {
+    if (!isRecord(value))
+        throw new RemoteSessionProtocolError(operation, "snapshot must be an object");
+    const id = requiredSessionId(value, operation);
+    const reference = requiredString(value, "reference", operation);
+    if (parseRemoteSessionId(reference) !== id) {
+        throw new RemoteSessionProtocolError(operation, `reference ${reference} does not identify snapshot id ${id}`);
+    }
+    if (expectedId !== undefined && id !== expectedId) {
+        throw new RemoteSessionProtocolError(operation, `snapshot id ${id} does not match requested id ${expectedId}`);
+    }
+    if (!Array.isArray(value.entries) || value.entries.length === 0 || value.entries.some((entry) => !isRecord(entry))) {
+        throw new RemoteSessionProtocolError(operation, "entries must be a non-empty array of objects");
+    }
+    const header = value.entries[0];
+    if (!isRecord(header) ||
+        header.type !== "session" ||
+        header.id !== id ||
+        typeof header.cwd !== "string" ||
+        typeof header.timestamp !== "string") {
+        throw new RemoteSessionProtocolError(operation, "entries must begin with a matching session header");
+    }
+    const version = value.version;
+    if (version !== undefined &&
+        (typeof version !== "number" || !Number.isInteger(version) || version < 1 || version !== header.version)) {
+        throw new RemoteSessionProtocolError(operation, "version must be a positive integer matching the session header");
+    }
+    return {
+        reference,
+        id,
+        version: version,
+        entries: value.entries,
+        etag: optionalString(value, "etag", operation),
+    };
+}
+function decodeForkSnapshot(value, sourceId) {
+    const snapshot = decodeSnapshot(value, "fork");
+    if (snapshot.id === sourceId) {
+        throw new RemoteSessionProtocolError("fork", "fork snapshot must have a new session id");
+    }
+    const header = snapshot.entries[0];
+    if (header?.type !== "session" || !header.parentSession || parseRemoteSessionId(header.parentSession) !== sourceId) {
+        throw new RemoteSessionProtocolError("fork", `fork header must reference source session ${sourceId}`);
+    }
+    return snapshot;
+}
+function decodeAppendResponse(value) {
+    const operation = "append";
+    if (!isRecord(value))
+        throw new RemoteSessionProtocolError(operation, "response must be an object");
+    if (!Number.isInteger(value.accepted)) {
+        throw new RemoteSessionProtocolError(operation, "accepted must be an integer");
+    }
+    return { accepted: value.accepted, etag: optionalString(value, "etag", operation) };
+}
+function decodeReplaceResponse(value) {
+    const operation = "replace";
+    if (!isRecord(value))
+        throw new RemoteSessionProtocolError(operation, "response must be an object");
+    return { etag: optionalString(value, "etag", operation) };
+}
+function decodeSessionInfo(value) {
+    const operation = "list";
+    if (!isRecord(value))
+        throw new RemoteSessionProtocolError(operation, "each session must be an object");
+    const id = requiredSessionId(value, operation);
+    const reference = optionalString(value, "reference", operation);
+    const path = optionalString(value, "path", operation);
+    for (const candidate of [reference, path]) {
+        if (candidate !== undefined && parseRemoteSessionId(candidate) !== id) {
+            throw new RemoteSessionProtocolError(operation, `reference ${candidate} does not identify session id ${id}`);
+        }
+    }
+    const created = requiredString(value, "created", operation);
+    const modified = requiredString(value, "modified", operation);
+    if (!Number.isFinite(Date.parse(created)) || !Number.isFinite(Date.parse(modified))) {
+        throw new RemoteSessionProtocolError(operation, "created and modified must be valid date strings");
+    }
+    if (!Number.isInteger(value.messageCount) || value.messageCount < 0) {
+        throw new RemoteSessionProtocolError(operation, "messageCount must be a non-negative integer");
+    }
+    return {
+        reference,
+        path,
+        id,
+        cwd: stringValue(value, "cwd", operation),
+        name: optionalString(value, "name", operation),
+        parentSessionPath: optionalString(value, "parentSessionPath", operation),
+        created,
+        modified,
+        messageCount: value.messageCount,
+        firstMessage: stringValue(value, "firstMessage", operation),
+        allMessagesText: stringValue(value, "allMessagesText", operation),
+    };
+}
+function decodeListResponse(value) {
+    if (!isRecord(value) || !Array.isArray(value.sessions)) {
+        throw new RemoteSessionProtocolError("list", "sessions must be an array");
+    }
+    return { sessions: value.sessions.map((session) => decodeSessionInfo(session)) };
+}
+export class RemoteSessionClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.token = options.token;
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    createSession(request) {
+        return this.request("POST", "/v1/sessions", request, "create", (value) => decodeSnapshot(value, "create", request.id));
+    }
+    openSession(sessionIdOrReference) {
+        const id = parseRemoteSessionId(sessionIdOrReference);
+        return this.request("GET", `/v1/sessions/${encodeURIComponent(id)}`, undefined, "open", (value) => decodeSnapshot(value, "open", id));
+    }
+    appendEntries(sessionIdOrReference, request) {
+        return this.request("POST", `/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/entries`, request, "append", decodeAppendResponse);
+    }
+    replaceSnapshot(sessionIdOrReference, request) {
+        return this.request("PUT", `/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/snapshot`, request, "replace", decodeReplaceResponse);
+    }
+    listSessions() {
+        return this.request("GET", "/v1/sessions", undefined, "list", decodeListResponse);
+    }
+    getRecentSession() {
+        return this.request("GET", "/v1/sessions/recent", undefined, "recent", (value) => decodeSnapshot(value, "recent"));
+    }
+    forkSession(sessionIdOrReference, request) {
+        const sourceId = parseRemoteSessionId(sessionIdOrReference);
+        return this.request("POST", `/v1/sessions/${encodeURIComponent(sourceId)}/fork`, request, "fork", (value) => decodeForkSnapshot(value, sourceId));
+    }
+    importJsonl(request) {
+        return this.request("POST", "/v1/sessions/import-jsonl", request, "import", (value) => decodeSnapshot(value, "import"));
+    }
+    async request(method, path, body, operation, decode) {
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                Accept: "application/json",
+                ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new RemoteSessionClientError(response.status, await response.text());
+        }
+        if (response.status === 204) {
+            throw new RemoteSessionProtocolError(operation, "response body is required");
+        }
+        let value;
+        try {
+            value = await response.json();
+        }
+        catch (error) {
+            throw new RemoteSessionProtocolError(operation, "body is not valid JSON", error);
+        }
+        return decode(value);
+    }
+}
+export function parseRemoteSessionId(reference) {
+    return reference.startsWith("remote:") ? reference.slice("remote:".length) : reference;
+}
+export function formatRemoteSessionReference(sessionId) {
+    return sessionId.startsWith("remote:") ? sessionId : `remote:${sessionId}`;
+}
+//# sourceMappingURL=remote-session-client.js.map

package/dist/core/session/remote-session-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session-client.js","sourceRoot":"","sources":["../../../src/core/session/remote-session-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { validateSessionId } from \"./ids.ts\";\nimport type { FileEntry, SessionInfo } from \"./types.ts\";\n\nexport type RemoteSessionInfo = Omit<SessionInfo, \"path\" | \"created\" | \"modified\"> & {\n\tpath?: string;\n\tcreated: Date | string;\n\tmodified: Date | string;\n};\n\nexport interface RemoteSessionClientOptions {\n\tbaseUrl: string;\n\ttoken: string;\n\tfetch?: typeof fetch;\n}\n\nexport interface RemoteSessionSnapshot {\n\treference: string;\n\tid: string;\n\tversion?: number;\n\tentries: FileEntry[];\n\tetag?: string;\n}\n\nexport interface CreateRemoteSessionRequest {\n\tid?: string;\n\tcwd: string;\n\tprojectId?: string;\n\tparentSession?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface AppendRemoteSessionEntriesRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface AppendRemoteSessionEntriesResponse {\n\tetag?: string;\n\taccepted: number;\n}\n\n// grip-ignore noNearIdenticalDataStructures: Snapshot replacement atomically rewrites complete state, while append applies incremental entries; their endpoint validation and concurrency contracts evolve independently.\nexport interface ReplaceRemoteSessionSnapshotRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface ReplaceRemoteSessionSnapshotResponse {\n\tetag?: string;\n}\n\nexport interface ForkRemoteSessionRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tleafId?: string;\n}\n\nexport interface ImportRemoteSessionJsonlRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tsourceName?: string;\n\tentries: FileEntry[];\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface ListRemoteSessionsResponse {\n\tsessions: RemoteSessionInfo[];\n}\n\nexport type RemoteSessionOperation = \"create\" | \"open\" | \"recent\" | \"fork\" | \"import\" | \"list\" | \"append\" | \"replace\";\n\nexport class RemoteSessionClientError extends Error {\n\treadonly status: number;\n\treadonly responseText: string;\n\n\tconstructor(status: number, responseText: string) {\n\t\tsuper(`Remote session request failed with status ${status}: ${responseText}`);\n\t\tthis.name = \"RemoteSessionClientError\";\n\t\tthis.status = status;\n\t\tthis.responseText = responseText;\n\t}\n}\n\nexport class RemoteSessionProtocolError extends Error {\n\treadonly operation: RemoteSessionOperation;\n\n\tconstructor(operation: RemoteSessionOperation, message: string, cause?: unknown) {\n\t\tsuper(`Invalid remote session ${operation} response: ${message}`, { cause });\n\t\tthis.name = \"RemoteSessionProtocolError\";\n\t\tthis.operation = operation;\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction requiredString(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string`);\n\t}\n\treturn value;\n}\n\nfunction stringValue(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\") {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a string`);\n\t}\n\treturn value;\n}\n\nfunction requiredSessionId(record: Record<string, unknown>, operation: RemoteSessionOperation): string {\n\tconst id = requiredString(record, \"id\", operation);\n\ttry {\n\t\tvalidateSessionId(id);\n\t} catch (error) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"id is not a valid session id\", error);\n\t}\n\treturn id;\n}\n\nfunction optionalString(\n\trecord: Record<string, unknown>,\n\tkey: string,\n\toperation: RemoteSessionOperation,\n): string | undefined {\n\tconst value = record[key];\n\tif (value === undefined) return undefined;\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string when present`);\n\t}\n\treturn value;\n}\n\nfunction decodeSnapshot(value: unknown, operation: RemoteSessionOperation, expectedId?: string): RemoteSessionSnapshot {\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"snapshot must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = requiredString(value, \"reference\", operation);\n\tif (parseRemoteSessionId(reference) !== id) {\n\t\tthrow new RemoteSessionProtocolError(operation, `reference ${reference} does not identify snapshot id ${id}`);\n\t}\n\tif (expectedId !== undefined && id !== expectedId) {\n\t\tthrow new RemoteSessionProtocolError(operation, `snapshot id ${id} does not match requested id ${expectedId}`);\n\t}\n\tif (!Array.isArray(value.entries) || value.entries.length === 0 || value.entries.some((entry) => !isRecord(entry))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must be a non-empty array of objects\");\n\t}\n\tconst header = value.entries[0];\n\tif (\n\t\t!isRecord(header) ||\n\t\theader.type !== \"session\" ||\n\t\theader.id !== id ||\n\t\ttypeof header.cwd !== \"string\" ||\n\t\ttypeof header.timestamp !== \"string\"\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must begin with a matching session header\");\n\t}\n\tconst version = value.version;\n\tif (\n\t\tversion !== undefined &&\n\t\t(typeof version !== \"number\" || !Number.isInteger(version) || version < 1 || version !== header.version)\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"version must be a positive integer matching the session header\");\n\t}\n\treturn {\n\t\treference,\n\t\tid,\n\t\tversion: version as number | undefined,\n\t\tentries: value.entries as FileEntry[],\n\t\tetag: optionalString(value, \"etag\", operation),\n\t};\n}\n\nfunction decodeForkSnapshot(value: unknown, sourceId: string): RemoteSessionSnapshot {\n\tconst snapshot = decodeSnapshot(value, \"fork\");\n\tif (snapshot.id === sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", \"fork snapshot must have a new session id\");\n\t}\n\tconst header = snapshot.entries[0];\n\tif (header?.type !== \"session\" || !header.parentSession || parseRemoteSessionId(header.parentSession) !== sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", `fork header must reference source session ${sourceId}`);\n\t}\n\treturn snapshot;\n}\n\nfunction decodeAppendResponse(value: unknown): AppendRemoteSessionEntriesResponse {\n\tconst operation = \"append\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\tif (!Number.isInteger(value.accepted)) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"accepted must be an integer\");\n\t}\n\treturn { accepted: value.accepted as number, etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeReplaceResponse(value: unknown): ReplaceRemoteSessionSnapshotResponse {\n\tconst operation = \"replace\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\treturn { etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeSessionInfo(value: unknown): RemoteSessionInfo {\n\tconst operation = \"list\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"each session must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = optionalString(value, \"reference\", operation);\n\tconst path = optionalString(value, \"path\", operation);\n\tfor (const candidate of [reference, path]) {\n\t\tif (candidate !== undefined && parseRemoteSessionId(candidate) !== id) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, `reference ${candidate} does not identify session id ${id}`);\n\t\t}\n\t}\n\tconst created = requiredString(value, \"created\", operation);\n\tconst modified = requiredString(value, \"modified\", operation);\n\tif (!Number.isFinite(Date.parse(created)) || !Number.isFinite(Date.parse(modified))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"created and modified must be valid date strings\");\n\t}\n\tif (!Number.isInteger(value.messageCount) || (value.messageCount as number) < 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"messageCount must be a non-negative integer\");\n\t}\n\treturn {\n\t\treference,\n\t\tpath,\n\t\tid,\n\t\tcwd: stringValue(value, \"cwd\", operation),\n\t\tname: optionalString(value, \"name\", operation),\n\t\tparentSessionPath: optionalString(value, \"parentSessionPath\", operation),\n\t\tcreated,\n\t\tmodified,\n\t\tmessageCount: value.messageCount as number,\n\t\tfirstMessage: stringValue(value, \"firstMessage\", operation),\n\t\tallMessagesText: stringValue(value, \"allMessagesText\", operation),\n\t};\n}\n\nfunction decodeListResponse(value: unknown): ListRemoteSessionsResponse {\n\tif (!isRecord(value) || !Array.isArray(value.sessions)) {\n\t\tthrow new RemoteSessionProtocolError(\"list\", \"sessions must be an array\");\n\t}\n\treturn { sessions: value.sessions.map((session) => decodeSessionInfo(session)) };\n}\n\nexport class RemoteSessionClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly token: string;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tconstructor(options: RemoteSessionClientOptions) {\n\t\tthis.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n\t\tthis.token = options.token;\n\t\tthis.fetchImpl = options.fetch ?? fetch;\n\t}\n\n\tcreateSession(request: CreateRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions\", request, \"create\", (value) =>\n\t\t\tdecodeSnapshot(value, \"create\", request.id),\n\t\t);\n\t}\n\n\topenSession(sessionIdOrReference: string): Promise<RemoteSessionSnapshot> {\n\t\tconst id = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"GET\", `/v1/sessions/${encodeURIComponent(id)}`, undefined, \"open\", (value) =>\n\t\t\tdecodeSnapshot(value, \"open\", id),\n\t\t);\n\t}\n\n\tappendEntries(\n\t\tsessionIdOrReference: string,\n\t\trequest: AppendRemoteSessionEntriesRequest,\n\t): Promise<AppendRemoteSessionEntriesResponse> {\n\t\treturn this.request(\n\t\t\t\"POST\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/entries`,\n\t\t\trequest,\n\t\t\t\"append\",\n\t\t\tdecodeAppendResponse,\n\t\t);\n\t}\n\n\treplaceSnapshot(\n\t\tsessionIdOrReference: string,\n\t\trequest: ReplaceRemoteSessionSnapshotRequest,\n\t): Promise<ReplaceRemoteSessionSnapshotResponse> {\n\t\treturn this.request(\n\t\t\t\"PUT\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/snapshot`,\n\t\t\trequest,\n\t\t\t\"replace\",\n\t\t\tdecodeReplaceResponse,\n\t\t);\n\t}\n\n\tlistSessions(): Promise<ListRemoteSessionsResponse> {\n\t\treturn this.request(\"GET\", \"/v1/sessions\", undefined, \"list\", decodeListResponse);\n\t}\n\n\tgetRecentSession(): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"GET\", \"/v1/sessions/recent\", undefined, \"recent\", (value) =>\n\t\t\tdecodeSnapshot(value, \"recent\"),\n\t\t);\n\t}\n\n\tforkSession(sessionIdOrReference: string, request: ForkRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\tconst sourceId = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"POST\", `/v1/sessions/${encodeURIComponent(sourceId)}/fork`, request, \"fork\", (value) =>\n\t\t\tdecodeForkSnapshot(value, sourceId),\n\t\t);\n\t}\n\n\timportJsonl(request: ImportRemoteSessionJsonlRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions/import-jsonl\", request, \"import\", (value) =>\n\t\t\tdecodeSnapshot(value, \"import\"),\n\t\t);\n\t}\n\n\tprivate async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody: unknown,\n\t\toperation: RemoteSessionOperation,\n\t\tdecode: (value: unknown) => T,\n\t): Promise<T> {\n\t\tconst response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${this.token}`,\n\t\t\t\tAccept: \"application/json\",\n\t\t\t\t...(body === undefined ? {} : { \"Content-Type\": \"application/json\" }),\n\t\t\t},\n\t\t\tbody: body === undefined ? undefined : JSON.stringify(body),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow new RemoteSessionClientError(response.status, await response.text());\n\t\t}\n\t\tif (response.status === 204) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"response body is required\");\n\t\t}\n\n\t\tlet value: unknown;\n\t\ttry {\n\t\t\tvalue = await response.json();\n\t\t} catch (error) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"body is not valid JSON\", error);\n\t\t}\n\t\treturn decode(value);\n\t}\n}\n\nexport function parseRemoteSessionId(reference: string): string {\n\treturn reference.startsWith(\"remote:\") ? reference.slice(\"remote:\".length) : reference;\n}\n\nexport function formatRemoteSessionReference(sessionId: string): string {\n\treturn sessionId.startsWith(\"remote:\") ? sessionId : `remote:${sessionId}`;\n}\n"]}

package/dist/core/session/remote-session-manager.d.ts

@@ -0,0 +1,32 @@
+import { RemoteSession } from "./remote-session.ts";
+import type { Session } from "./session.ts";
+import type { OpenSessionOptions, SessionManager } from "./session-manager.ts";
+import type { NewSessionOptions, SessionInfo, SessionListProgress } from "./types.ts";
+export interface RemoteSessionManagerOptions {
+    baseUrl: string;
+    token: string;
+    cwd: string;
+    projectId?: string;
+    fetch?: typeof fetch;
+}
+/**
+ * Remote session manager skeleton.
+ *
+ * Lifecycle methods are async-compatible through SessionManager so this backend
+ * can fetch/create snapshots before returning an active Session.
+ */
+export declare class RemoteSessionManager implements SessionManager {
+    private readonly client;
+    private readonly cwd;
+    private readonly projectId;
+    constructor(options: RemoteSessionManagerOptions);
+    create(options?: NewSessionOptions): Promise<RemoteSession>;
+    openReference(reference: string, options?: OpenSessionOptions): Promise<RemoteSession>;
+    continueRecent(): Promise<RemoteSession>;
+    forkFrom(reference: string): Promise<RemoteSession>;
+    forkSession(source: Session, targetLeafId: string | null): Promise<RemoteSession>;
+    importJsonl(inputPath: string, options?: OpenSessionOptions): Promise<RemoteSession>;
+    list(_onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+}
+//# sourceMappingURL=remote-session-manager.d.ts.map

package/dist/core/session/remote-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session-manager.d.ts","sourceRoot":"","sources":["../../../src/core/session/remote-session-manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAiB,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErG,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAuBD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,YAAY,OAAO,EAAE,2BAA2B,EAI/C;IAEK,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAWhE;IAEK,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ3F;IAEK,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAQ7C;IAEK,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAMxD;IAEK,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAetF;IAEK,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqCzF;IAEK,IAAI,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAGpE;IAEK,OAAO,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAGvE;CACD","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport type { JsonlErrorPhase } from \"./jsonl-errors.ts\";\nimport { createJsonlSessionDecodeError } from \"./jsonl-errors.ts\";\nimport { loadEntriesFromFile } from \"./jsonl-helpers.ts\";\nimport { migrateToCurrentVersion } from \"./migrations.ts\";\nimport { RemoteSession } from \"./remote-session.ts\";\nimport type { RemoteSessionInfo, RemoteSessionSnapshot } from \"./remote-session-client.ts\";\nimport { RemoteSessionClient } from \"./remote-session-client.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport { getJsonlEntryLocations, validateCurrentSessionEntries } from \"./stores/jsonl-session-store.ts\";\nimport type { NewSessionOptions, SessionHeader, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport interface RemoteSessionManagerOptions {\n\tbaseUrl: string;\n\ttoken: string;\n\tcwd: string;\n\tprojectId?: string;\n\tfetch?: typeof fetch;\n}\n\nfunction getSnapshotCwd(snapshot: RemoteSessionSnapshot, fallback: string): string {\n\tconst header = snapshot.entries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\treturn typeof header?.cwd === \"string\" ? header.cwd : fallback;\n}\n\nfunction validateRemoteSnapshot(snapshot: RemoteSessionSnapshot, phase: JsonlErrorPhase): RemoteSessionSnapshot {\n\tvalidateCurrentSessionEntries(snapshot.entries, snapshot.reference, { phase });\n\treturn snapshot;\n}\n\nfunction normalizeRemoteSessionInfo(session: RemoteSessionInfo): SessionInfo {\n\tconst reference = session.reference ?? session.path;\n\treturn {\n\t\t...session,\n\t\treference,\n\t\tpath: session.path ?? reference ?? session.id,\n\t\tcreated: session.created instanceof Date ? session.created : new Date(session.created),\n\t\tmodified: session.modified instanceof Date ? session.modified : new Date(session.modified),\n\t};\n}\n\n/**\n * Remote session manager skeleton.\n *\n * Lifecycle methods are async-compatible through SessionManager so this backend\n * can fetch/create snapshots before returning an active Session.\n */\nexport class RemoteSessionManager implements SessionManager {\n\tprivate readonly client: RemoteSessionClient;\n\tprivate readonly cwd: string;\n\tprivate readonly projectId: string | undefined;\n\n\tconstructor(options: RemoteSessionManagerOptions) {\n\t\tthis.client = new RemoteSessionClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });\n\t\tthis.cwd = options.cwd;\n\t\tthis.projectId = options.projectId;\n\t}\n\n\tasync create(options?: NewSessionOptions): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.createSession({\n\t\t\t\tid: options?.id,\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tparentSession: options?.parentSession,\n\t\t\t}),\n\t\t\t\"create\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync openReference(reference: string, options?: OpenSessionOptions): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(await this.client.openSession(reference), \"open\");\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: options?.cwdOverride ?? getSnapshotCwd(snapshot, this.cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync continueRecent(): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(await this.client.getRecentSession(), \"open\");\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: getSnapshotCwd(snapshot, this.cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync forkFrom(reference: string): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.forkSession(reference, { cwd: this.cwd, projectId: this.projectId }),\n\t\t\t\"fork\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync forkSession(source: Session, targetLeafId: string | null): Promise<RemoteSession> {\n\t\tif (source instanceof RemoteSession) await source.flushPendingSync();\n\t\tconst reference = source.getSessionReference();\n\t\tif (!reference) {\n\t\t\tthrow new Error(\"Cannot fork a remote session without a session reference\");\n\t\t}\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.forkSession(reference, {\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tleafId: targetLeafId ?? undefined,\n\t\t\t}),\n\t\t\t\"fork\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync importJsonl(inputPath: string, options?: OpenSessionOptions): Promise<RemoteSession> {\n\t\tconst resolvedPath = resolve(inputPath);\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tthrow new Error(`File not found: ${resolvedPath}`);\n\t\t}\n\n\t\tconst entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: \"import\" });\n\t\tif (entries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(\n\t\t\t\tresolvedPath,\n\t\t\t\t\"import\",\n\t\t\t\t\"schema\",\n\t\t\t\t`Cannot import empty or invalid session JSONL: ${resolvedPath}`,\n\t\t\t);\n\t\t}\n\t\tmigrateToCurrentVersion(entries);\n\t\tvalidateCurrentSessionEntries(entries, resolvedPath, {\n\t\t\tphase: \"import\",\n\t\t\tlocations: getJsonlEntryLocations(entries),\n\t\t});\n\n\t\tconst cwd = options?.cwdOverride ?? getSnapshotCwd({ id: \"\", reference: \"\", entries }, this.cwd);\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.importJsonl({\n\t\t\t\tcwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tsourceName: basename(resolvedPath),\n\t\t\t\tentries,\n\t\t\t}),\n\t\t\t\"import\",\n\t\t);\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: getSnapshotCwd(snapshot, cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync list(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst response = await this.client.listSessions();\n\t\treturn response.sessions.map((session) => normalizeRemoteSessionInfo(session));\n\t}\n\n\tasync listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst response = await this.client.listSessions();\n\t\treturn response.sessions.map((session) => normalizeRemoteSessionInfo(session));\n\t}\n}\n"]}

package/dist/core/session/remote-session-manager.js

@@ -0,0 +1,124 @@
+import { existsSync } from "node:fs";
+import { basename, resolve } from "node:path";
+import { createJsonlSessionDecodeError } from "./jsonl-errors.js";
+import { loadEntriesFromFile } from "./jsonl-helpers.js";
+import { migrateToCurrentVersion } from "./migrations.js";
+import { RemoteSession } from "./remote-session.js";
+import { RemoteSessionClient } from "./remote-session-client.js";
+import { getJsonlEntryLocations, validateCurrentSessionEntries } from "./stores/jsonl-session-store.js";
+function getSnapshotCwd(snapshot, fallback) {
+    const header = snapshot.entries.find((entry) => entry.type === "session");
+    return typeof header?.cwd === "string" ? header.cwd : fallback;
+}
+function validateRemoteSnapshot(snapshot, phase) {
+    validateCurrentSessionEntries(snapshot.entries, snapshot.reference, { phase });
+    return snapshot;
+}
+function normalizeRemoteSessionInfo(session) {
+    const reference = session.reference ?? session.path;
+    return {
+        ...session,
+        reference,
+        path: session.path ?? reference ?? session.id,
+        created: session.created instanceof Date ? session.created : new Date(session.created),
+        modified: session.modified instanceof Date ? session.modified : new Date(session.modified),
+    };
+}
+/**
+ * Remote session manager skeleton.
+ *
+ * Lifecycle methods are async-compatible through SessionManager so this backend
+ * can fetch/create snapshots before returning an active Session.
+ */
+export class RemoteSessionManager {
+    client;
+    cwd;
+    projectId;
+    constructor(options) {
+        this.client = new RemoteSessionClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });
+        this.cwd = options.cwd;
+        this.projectId = options.projectId;
+    }
+    async create(options) {
+        const snapshot = validateRemoteSnapshot(await this.client.createSession({
+            id: options?.id,
+            cwd: this.cwd,
+            projectId: this.projectId,
+            parentSession: options?.parentSession,
+        }), "create");
+        return new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });
+    }
+    async openReference(reference, options) {
+        const snapshot = validateRemoteSnapshot(await this.client.openSession(reference), "open");
+        return new RemoteSession({
+            client: this.client,
+            cwd: options?.cwdOverride ?? getSnapshotCwd(snapshot, this.cwd),
+            snapshot,
+            sessionManager: this,
+        });
+    }
+    async continueRecent() {
+        const snapshot = validateRemoteSnapshot(await this.client.getRecentSession(), "open");
+        return new RemoteSession({
+            client: this.client,
+            cwd: getSnapshotCwd(snapshot, this.cwd),
+            snapshot,
+            sessionManager: this,
+        });
+    }
+    async forkFrom(reference) {
+        const snapshot = validateRemoteSnapshot(await this.client.forkSession(reference, { cwd: this.cwd, projectId: this.projectId }), "fork");
+        return new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });
+    }
+    async forkSession(source, targetLeafId) {
+        if (source instanceof RemoteSession)
+            await source.flushPendingSync();
+        const reference = source.getSessionReference();
+        if (!reference) {
+            throw new Error("Cannot fork a remote session without a session reference");
+        }
+        const snapshot = validateRemoteSnapshot(await this.client.forkSession(reference, {
+            cwd: this.cwd,
+            projectId: this.projectId,
+            leafId: targetLeafId ?? undefined,
+        }), "fork");
+        return new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });
+    }
+    async importJsonl(inputPath, options) {
+        const resolvedPath = resolve(inputPath);
+        if (!existsSync(resolvedPath)) {
+            throw new Error(`File not found: ${resolvedPath}`);
+        }
+        const entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: "import" });
+        if (entries.length === 0) {
+            throw createJsonlSessionDecodeError(resolvedPath, "import", "schema", `Cannot import empty or invalid session JSONL: ${resolvedPath}`);
+        }
+        migrateToCurrentVersion(entries);
+        validateCurrentSessionEntries(entries, resolvedPath, {
+            phase: "import",
+            locations: getJsonlEntryLocations(entries),
+        });
+        const cwd = options?.cwdOverride ?? getSnapshotCwd({ id: "", reference: "", entries }, this.cwd);
+        const snapshot = validateRemoteSnapshot(await this.client.importJsonl({
+            cwd,
+            projectId: this.projectId,
+            sourceName: basename(resolvedPath),
+            entries,
+        }), "import");
+        return new RemoteSession({
+            client: this.client,
+            cwd: getSnapshotCwd(snapshot, cwd),
+            snapshot,
+            sessionManager: this,
+        });
+    }
+    async list(_onProgress) {
+        const response = await this.client.listSessions();
+        return response.sessions.map((session) => normalizeRemoteSessionInfo(session));
+    }
+    async listAll(_onProgress) {
+        const response = await this.client.listSessions();
+        return response.sessions.map((session) => normalizeRemoteSessionInfo(session));
+    }
+}
+//# sourceMappingURL=remote-session-manager.js.map

package/dist/core/session/remote-session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session-manager.js","sourceRoot":"","sources":["../../../src/core/session/remote-session-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport type { JsonlErrorPhase } from \"./jsonl-errors.ts\";\nimport { createJsonlSessionDecodeError } from \"./jsonl-errors.ts\";\nimport { loadEntriesFromFile } from \"./jsonl-helpers.ts\";\nimport { migrateToCurrentVersion } from \"./migrations.ts\";\nimport { RemoteSession } from \"./remote-session.ts\";\nimport type { RemoteSessionInfo, RemoteSessionSnapshot } from \"./remote-session-client.ts\";\nimport { RemoteSessionClient } from \"./remote-session-client.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport { getJsonlEntryLocations, validateCurrentSessionEntries } from \"./stores/jsonl-session-store.ts\";\nimport type { NewSessionOptions, SessionHeader, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport interface RemoteSessionManagerOptions {\n\tbaseUrl: string;\n\ttoken: string;\n\tcwd: string;\n\tprojectId?: string;\n\tfetch?: typeof fetch;\n}\n\nfunction getSnapshotCwd(snapshot: RemoteSessionSnapshot, fallback: string): string {\n\tconst header = snapshot.entries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\treturn typeof header?.cwd === \"string\" ? header.cwd : fallback;\n}\n\nfunction validateRemoteSnapshot(snapshot: RemoteSessionSnapshot, phase: JsonlErrorPhase): RemoteSessionSnapshot {\n\tvalidateCurrentSessionEntries(snapshot.entries, snapshot.reference, { phase });\n\treturn snapshot;\n}\n\nfunction normalizeRemoteSessionInfo(session: RemoteSessionInfo): SessionInfo {\n\tconst reference = session.reference ?? session.path;\n\treturn {\n\t\t...session,\n\t\treference,\n\t\tpath: session.path ?? reference ?? session.id,\n\t\tcreated: session.created instanceof Date ? session.created : new Date(session.created),\n\t\tmodified: session.modified instanceof Date ? session.modified : new Date(session.modified),\n\t};\n}\n\n/**\n * Remote session manager skeleton.\n *\n * Lifecycle methods are async-compatible through SessionManager so this backend\n * can fetch/create snapshots before returning an active Session.\n */\nexport class RemoteSessionManager implements SessionManager {\n\tprivate readonly client: RemoteSessionClient;\n\tprivate readonly cwd: string;\n\tprivate readonly projectId: string | undefined;\n\n\tconstructor(options: RemoteSessionManagerOptions) {\n\t\tthis.client = new RemoteSessionClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });\n\t\tthis.cwd = options.cwd;\n\t\tthis.projectId = options.projectId;\n\t}\n\n\tasync create(options?: NewSessionOptions): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.createSession({\n\t\t\t\tid: options?.id,\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tparentSession: options?.parentSession,\n\t\t\t}),\n\t\t\t\"create\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync openReference(reference: string, options?: OpenSessionOptions): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(await this.client.openSession(reference), \"open\");\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: options?.cwdOverride ?? getSnapshotCwd(snapshot, this.cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync continueRecent(): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(await this.client.getRecentSession(), \"open\");\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: getSnapshotCwd(snapshot, this.cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync forkFrom(reference: string): Promise<RemoteSession> {\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.forkSession(reference, { cwd: this.cwd, projectId: this.projectId }),\n\t\t\t\"fork\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync forkSession(source: Session, targetLeafId: string | null): Promise<RemoteSession> {\n\t\tif (source instanceof RemoteSession) await source.flushPendingSync();\n\t\tconst reference = source.getSessionReference();\n\t\tif (!reference) {\n\t\t\tthrow new Error(\"Cannot fork a remote session without a session reference\");\n\t\t}\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.forkSession(reference, {\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tleafId: targetLeafId ?? undefined,\n\t\t\t}),\n\t\t\t\"fork\",\n\t\t);\n\t\treturn new RemoteSession({ client: this.client, cwd: this.cwd, snapshot, sessionManager: this });\n\t}\n\n\tasync importJsonl(inputPath: string, options?: OpenSessionOptions): Promise<RemoteSession> {\n\t\tconst resolvedPath = resolve(inputPath);\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tthrow new Error(`File not found: ${resolvedPath}`);\n\t\t}\n\n\t\tconst entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: \"import\" });\n\t\tif (entries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(\n\t\t\t\tresolvedPath,\n\t\t\t\t\"import\",\n\t\t\t\t\"schema\",\n\t\t\t\t`Cannot import empty or invalid session JSONL: ${resolvedPath}`,\n\t\t\t);\n\t\t}\n\t\tmigrateToCurrentVersion(entries);\n\t\tvalidateCurrentSessionEntries(entries, resolvedPath, {\n\t\t\tphase: \"import\",\n\t\t\tlocations: getJsonlEntryLocations(entries),\n\t\t});\n\n\t\tconst cwd = options?.cwdOverride ?? getSnapshotCwd({ id: \"\", reference: \"\", entries }, this.cwd);\n\t\tconst snapshot = validateRemoteSnapshot(\n\t\t\tawait this.client.importJsonl({\n\t\t\t\tcwd,\n\t\t\t\tprojectId: this.projectId,\n\t\t\t\tsourceName: basename(resolvedPath),\n\t\t\t\tentries,\n\t\t\t}),\n\t\t\t\"import\",\n\t\t);\n\t\treturn new RemoteSession({\n\t\t\tclient: this.client,\n\t\t\tcwd: getSnapshotCwd(snapshot, cwd),\n\t\t\tsnapshot,\n\t\t\tsessionManager: this,\n\t\t});\n\t}\n\n\tasync list(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst response = await this.client.listSessions();\n\t\treturn response.sessions.map((session) => normalizeRemoteSessionInfo(session));\n\t}\n\n\tasync listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst response = await this.client.listSessions();\n\t\treturn response.sessions.map((session) => normalizeRemoteSessionInfo(session));\n\t}\n}\n"]}

package/dist/core/session/remote-session.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteSessionClient, RemoteSessionSnapshot } from "./remote-session-client.ts";
+import { Session } from "./session.ts";
+import type { SessionManager } from "./session-manager.ts";
+import type { NewSessionOptions } from "./types.ts";
+export interface RemoteSessionOptions {
+    client: RemoteSessionClient;
+    cwd: string;
+    reference?: string;
+    snapshot?: RemoteSessionSnapshot;
+    sessionManager?: SessionManager;
+}
+export declare class RemoteSession extends Session {
+    private remoteStore;
+    constructor(options: RemoteSessionOptions);
+    protected prepareNewSessionReference(_sessionDir: string, sessionId: string, _timestamp: string): string | undefined;
+    newSession(options?: NewSessionOptions): string | undefined;
+    flushPendingSync(): Promise<void>;
+    getLastSyncError(): unknown;
+}
+//# sourceMappingURL=remote-session.d.ts.map

package/dist/core/session/remote-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session.d.ts","sourceRoot":"","sources":["../../../src/core/session/remote-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAE7F,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,qBAAa,aAAc,SAAQ,OAAO;IACzC,OAAO,CAAC,WAAW,CAAiC;IAEpD,YAAY,OAAO,EAAE,oBAAoB,EAYxC;IAED,SAAS,CAAC,0BAA0B,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAEpB;IAEQ,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAInE;IAED,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAED,gBAAgB,IAAI,OAAO,CAE1B;CACD","sourcesContent":["import type { RemoteSessionClient, RemoteSessionSnapshot } from \"./remote-session-client.ts\";\nimport { formatRemoteSessionReference } from \"./remote-session-client.ts\";\nimport { Session } from \"./session.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { RemoteSessionStore } from \"./stores/remote-session-store.ts\";\nimport type { NewSessionOptions } from \"./types.ts\";\n\nexport interface RemoteSessionOptions {\n\tclient: RemoteSessionClient;\n\tcwd: string;\n\treference?: string;\n\tsnapshot?: RemoteSessionSnapshot;\n\tsessionManager?: SessionManager;\n}\n\nexport class RemoteSession extends Session {\n\tprivate remoteStore: RemoteSessionStore | undefined;\n\n\tconstructor(options: RemoteSessionOptions) {\n\t\tconst reference =\n\t\t\toptions.reference ??\n\t\t\toptions.snapshot?.reference ??\n\t\t\t(options.snapshot ? formatRemoteSessionReference(options.snapshot.id) : undefined);\n\t\tconst store = new RemoteSessionStore({\n\t\t\tclient: options.client,\n\t\t\treference,\n\t\t\tsnapshot: options.snapshot,\n\t\t});\n\t\tsuper(options.cwd, \"\", reference, store, options.sessionManager);\n\t\tthis.remoteStore = store;\n\t}\n\n\tprotected prepareNewSessionReference(\n\t\t_sessionDir: string,\n\t\tsessionId: string,\n\t\t_timestamp: string,\n\t): string | undefined {\n\t\treturn this.getSessionReference() ?? formatRemoteSessionReference(sessionId);\n\t}\n\n\toverride newSession(options?: NewSessionOptions): string | undefined {\n\t\tconst reference = super.newSession(options);\n\t\tthis.remoteStore?.saveSnapshot();\n\t\treturn reference;\n\t}\n\n\tflushPendingSync(): Promise<void> {\n\t\treturn this.remoteStore?.flushPendingSync() ?? Promise.resolve();\n\t}\n\n\tgetLastSyncError(): unknown {\n\t\treturn this.remoteStore?.getLastSyncError();\n\t}\n}\n"]}