A desktop coding agent with free access to frontier models.
TypeScript
import type { TokenScope } from "./types.js";
import { shortId } from "./utils.js";
export type FileSessionEventType = "write" | "delete" | "rename" | "mkdir";
export type FileSessionEvent = {
id: string;
seq: number;
workspaceId: string;
type: FileSessionEventType;
path: string;
toPath?: string;
revision?: string;
timestamp: number;
};
export type FileSessionRecord = {
id: string;
workspaceId: string;
workspaceRoot: string;
actorTokenHash: string;
actorScope: TokenScope;
canWrite: boolean;
createdAt: number;
expiresAt: number;
};
type WorkspaceEventState = {
seq: number;
events: FileSessionEvent[];
};
export class FileSessionStore {
private sessions = new Map<string, FileSessionRecord>();
private workspaceEvents = new Map<string, WorkspaceEventState>();
private maxSessions: number;
private maxEventsPerWorkspace: number;
constructor(options?: { maxSessions?: number; maxEventsPerWorkspace?: number }) {
this.maxSessions = options?.maxSessions ?? 256;
this.maxEventsPerWorkspace = options?.maxEventsPerWorkspace ?? 500;
}
create(input: {
workspaceId: string;
workspaceRoot: string;
actorTokenHash: string;
actorScope: TokenScope;
canWrite: boolean;
ttlMs: number;
}): FileSessionRecord {
this.pruneExpired();
this.evictIfNeeded();
const now = Date.now();
const record: FileSessionRecord = {
id: shortId(),
workspaceId: input.workspaceId,
workspaceRoot: input.workspaceRoot,
actorTokenHash: input.actorTokenHash,
actorScope: input.actorScope,
canWrite: input.canWrite,
createdAt: now,
expiresAt: now + input.ttlMs,
};
this.sessions.set(record.id, record);
return record;
}
get(sessionId: string): FileSessionRecord | null {
this.pruneExpired();
const value = this.sessions.get(sessionId);
return value ?? null;
}
close(sessionId: string): boolean {
return this.sessions.delete(sessionId);
}
recordWorkspaceEvent(input: {
workspaceId: string;
type: FileSessionEventType;
path: string;
toPath?: string;
revision?: string;
}): FileSessionEvent {
const state = this.workspaceEvents.get(input.workspaceId) ?? { seq: 0, events: [] };
const event: FileSessionEvent = {
id: shortId(),
seq: state.seq + 1,
workspaceId: input.workspaceId,
type: input.type,
path: input.path,
toPath: input.toPath,
revision: input.revision,
timestamp: Date.now(),
};
state.seq = event.seq;
state.events.push(event);
if (state.events.length > this.maxEventsPerWorkspace) {
state.events.splice(0, state.events.length - this.maxEventsPerWorkspace);
}
this.workspaceEvents.set(input.workspaceId, state);
return event;
}
listWorkspaceEvents(workspaceId: string, since = 0): { items: FileSessionEvent[]; cursor: number } {
const state = this.workspaceEvents.get(workspaceId);
if (!state) {
return { items: [], cursor: 0 };
}
const cursor = Number.isFinite(since) && since > 0 ? since : 0;
const items = state.events.filter((item) => item.seq > cursor);
return { items, cursor: state.seq };
}
private pruneExpired(): void {
const now = Date.now();
for (const [id, session] of this.sessions) {
if (session.expiresAt <= now) {
this.sessions.delete(id);
}
}
}
private evictIfNeeded(): void {
if (this.sessions.size < this.maxSessions) return;
let oldestId: string | null = null;
let oldestExpiry = Number.POSITIVE_INFINITY;
for (const [id, session] of this.sessions) {
if (session.expiresAt < oldestExpiry) {
oldestExpiry = session.expiresAt;
oldestId = id;
}
}
if (oldestId) {
this.sessions.delete(oldestId);
}
}
}