fold-agent 0.1.0

package/dist/rooms/proposals.js

@@ -0,0 +1,254 @@
+import { randomUUID } from 'node:crypto';
+import { summarizeMarkdown } from './markdown-snapshot.js';
+import { assignPersona } from './personas.js';
+import { normalizeProjectSnapshot, summarizeProject, } from './project-state.js';
+import { createTimelineEvent, decryptTimelineEvent, TIMELINE_EVENT_SENDER_ID_PREFIX, } from './timeline.js';
+import { decryptJsonRecord, encryptJsonRecord } from './encrypted-records.js';
+import { CLI_COMMENT_EVENT_SENDER_ID_PREFIX, COMMENT_EVENT_SENDER_ID_PREFIX, } from './comments.js';
+import { assertContiguousRecords } from './append-log-validation.js';
+export const PROPOSAL_SCHEMA = 'fold.proposal.v1';
+export const PROPOSAL_SENDER_ID_PREFIX = 'fold-cli:proposal';
+export const DEFAULT_AGENT_PARTICIPANT_FINGERPRINT = 'fold-cli:proposal';
+export async function createEncryptedProposalRecord(options) {
+    const createdAt = new Date().toISOString();
+    const id = randomUUID();
+    const base = summarizeMarkdown(options.baseMarkdown);
+    const proposed = summarizeMarkdown(options.proposedMarkdown);
+    const proposedProject = options.proposedProject ? normalizeProjectSnapshot(options.proposedProject) : undefined;
+    const baseProject = options.baseProject ? summarizeProject(options.baseProject) : undefined;
+    const persona = assignPersona({
+        roomId: options.access.roomId,
+        participantKind: 'agent',
+        participantFingerprint: options.participantFingerprint ?? DEFAULT_AGENT_PARTICIPANT_FINGERPRINT,
+    });
+    const record = {
+        schema: PROPOSAL_SCHEMA,
+        id,
+        kind: options.path
+            ? 'file-replacement'
+            : proposedProject
+                ? 'project-replacement'
+                : 'whole-document-replacement',
+        createdAt,
+        updatedAt: createdAt,
+        title: options.title ?? defaultProposalTitle(options.baseMarkdown, options.proposedMarkdown),
+        comment: options.comment ?? '',
+        authorKind: 'agent',
+        authorPersonaId: persona.id,
+        persona,
+        baseVersionId: base.sha256,
+        base,
+        proposed: {
+            ...proposed,
+            markdown: options.proposedMarkdown,
+        },
+        proposedMarkdown: options.proposedMarkdown,
+        baseProject,
+        proposedProject,
+        path: options.path,
+        diff: proposedProject && options.baseProject
+            ? projectDiff(options.baseProject, proposedProject)
+            : wholeDocumentDiff(options.baseMarkdown, options.proposedMarkdown),
+        discussionThreadIds: [],
+    };
+    const timelineEvent = createTimelineEvent({
+        idSeed: `proposal:${id}`,
+        type: 'proposal_submitted',
+        createdAt,
+        actorPersonaId: persona.id,
+        proposalId: id,
+        documentSha256: record.proposed.sha256,
+        message: record.title,
+    });
+    const proposal = {
+        ...record,
+        status: 'pending',
+        statusUpdatedAt: createdAt,
+    };
+    return {
+        update: await encryptJsonRecord(options.access, `${PROPOSAL_SENDER_ID_PREFIX}:${randomUUID()}`, record),
+        proposal,
+        timelineEvent,
+    };
+}
+export async function createProposalAcceptedEvent(access, proposal, documentSha256, actorPersonaId, acceptedProject) {
+    const event = createTimelineEvent({
+        idSeed: `proposal:${proposal.id}:accepted`,
+        type: 'proposal_accepted',
+        actorPersonaId,
+        proposalId: proposal.id,
+        documentSha256,
+        message: `Accepted ${proposal.title}`,
+        acceptedProject: acceptedProject ?? proposal.proposedProject,
+    });
+    return encryptJsonRecord(access, `${TIMELINE_EVENT_SENDER_ID_PREFIX}:${event.id}`, event);
+}
+export async function createProposalRejectedEvent(access, proposal, actorPersonaId, reason) {
+    const event = createTimelineEvent({
+        idSeed: `proposal:${proposal.id}:rejected`,
+        type: 'proposal_rejected',
+        actorPersonaId,
+        proposalId: proposal.id,
+        documentSha256: null,
+        message: reason ? `Rejected ${proposal.title}: ${reason}` : `Rejected ${proposal.title}`,
+    });
+    return encryptJsonRecord(access, `${TIMELINE_EVENT_SENDER_ID_PREFIX}:${event.id}`, event);
+}
+export async function replayProposalsFromRecords(access, records) {
+    assertContiguousRecords(records, access.roomId);
+    const proposals = new Map();
+    const timeline = [];
+    for (const record of records) {
+        if (record.senderId.startsWith(PROPOSAL_SENDER_ID_PREFIX)) {
+            const proposal = await decryptProposalRecord(access, record, record.senderId);
+            if (proposals.has(proposal.id))
+                continue;
+            proposals.set(proposal.id, {
+                ...proposal,
+                status: 'pending',
+                statusUpdatedAt: proposal.updatedAt,
+                replies: [],
+            });
+            continue;
+        }
+        if (isProposalDiscussionEventSender(record.senderId)) {
+            const event = await decryptJsonRecord(access, record, record.senderId);
+            if (!isProposalReplyEvent(event))
+                continue;
+            const current = proposals.get(event.proposalId);
+            if (!current)
+                continue;
+            const replies = current.replies || [];
+            if (replies.some((reply) => reply.id === event.reply.id))
+                continue;
+            proposals.set(current.id, {
+                ...current,
+                replies: [...replies, event.reply].sort((left, right) => left.createdAt.localeCompare(right.createdAt)),
+            });
+            continue;
+        }
+        if (!record.senderId.startsWith(TIMELINE_EVENT_SENDER_ID_PREFIX))
+            continue;
+        const event = await decryptTimelineEvent(access, record, record.senderId);
+        timeline.push(event);
+        if (!event.proposalId)
+            continue;
+        const current = proposals.get(event.proposalId);
+        if (!current || current.status !== 'pending')
+            continue;
+        if (event.type === 'proposal_accepted') {
+            proposals.set(current.id, {
+                ...current,
+                status: 'accepted',
+                statusUpdatedAt: event.createdAt,
+            });
+        }
+        else if (event.type === 'proposal_rejected') {
+            proposals.set(current.id, {
+                ...current,
+                status: 'rejected',
+                statusUpdatedAt: event.createdAt,
+            });
+        }
+    }
+    return {
+        proposals: [...proposals.values()].sort((left, right) => left.createdAt.localeCompare(right.createdAt)),
+        timeline: timeline.sort((left, right) => left.createdAt.localeCompare(right.createdAt)),
+    };
+}
+function isProposalDiscussionEventSender(senderId) {
+    return senderId.startsWith(COMMENT_EVENT_SENDER_ID_PREFIX) || senderId.startsWith(CLI_COMMENT_EVENT_SENDER_ID_PREFIX);
+}
+function isProposalReplyEvent(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    const reply = candidate.reply;
+    return candidate.type === 'proposal_replied'
+        && typeof candidate.proposalId === 'string'
+        && Boolean(reply)
+        && typeof reply?.id === 'string'
+        && typeof reply.authorPersonaId === 'string'
+        && reply.persona?.schema === 'fold.persona.v1'
+        && typeof reply.text === 'string'
+        && typeof reply.createdAt === 'string';
+}
+export async function decryptProposalRecord(access, payload, senderId) {
+    const value = await decryptJsonRecord(access, payload, senderId);
+    if (!isProposalRecord(value)) {
+        throw new Error('Invalid encrypted proposal payload');
+    }
+    return value;
+}
+function wholeDocumentDiff(baseMarkdown, proposedMarkdown) {
+    if (baseMarkdown === proposedMarkdown)
+        return '';
+    return [
+        '--- current.md',
+        '+++ proposed.md',
+        '@@ whole-document-replacement @@',
+        ...baseMarkdown.split('\n').map((line) => `-${line}`),
+        ...proposedMarkdown.split('\n').map((line) => `+${line}`),
+    ].join('\n');
+}
+function defaultProposalTitle(baseMarkdown, proposedMarkdown) {
+    const baseLines = lineCount(baseMarkdown);
+    const proposedLines = lineCount(proposedMarkdown);
+    return `Whole-document proposal (${baseLines} lines -> ${proposedLines} lines)`;
+}
+function lineCount(markdown) {
+    if (!markdown)
+        return 0;
+    return markdown.split('\n').length;
+}
+function isProposalRecord(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (candidate.schema === PROPOSAL_SCHEMA &&
+        (candidate.kind === 'whole-document-replacement' ||
+            candidate.kind === 'file-replacement' ||
+            candidate.kind === 'project-replacement') &&
+        typeof candidate.id === 'string' &&
+        typeof candidate.createdAt === 'string' &&
+        typeof candidate.updatedAt === 'string' &&
+        typeof candidate.title === 'string' &&
+        typeof candidate.comment === 'string' &&
+        candidate.authorKind === 'agent' &&
+        typeof candidate.authorPersonaId === 'string' &&
+        Boolean(candidate.persona) &&
+        typeof candidate.persona?.id === 'string' &&
+        typeof candidate.baseVersionId === 'string' &&
+        Boolean(candidate.base) &&
+        typeof candidate.base?.sha256 === 'string' &&
+        Boolean(candidate.proposed) &&
+        typeof candidate.proposed?.sha256 === 'string' &&
+        typeof candidate.proposed?.markdown === 'string' &&
+        typeof candidate.proposedMarkdown === 'string' &&
+        (candidate.path === undefined || typeof candidate.path === 'string') &&
+        (candidate.baseProject === undefined || typeof candidate.baseProject.sha256 === 'string') &&
+        (candidate.proposedProject === undefined || Array.isArray(candidate.proposedProject.files)) &&
+        typeof candidate.diff === 'string' &&
+        Array.isArray(candidate.discussionThreadIds));
+}
+function projectDiff(baseProject, proposedProject) {
+    const base = new Map(normalizeProjectSnapshot(baseProject).files.map((file) => [file.path, file.markdown]));
+    const proposed = new Map(normalizeProjectSnapshot(proposedProject).files.map((file) => [file.path, file.markdown]));
+    const paths = [...new Set([...base.keys(), ...proposed.keys()])].sort();
+    const lines = [];
+    for (const path of paths) {
+        const before = base.get(path);
+        const after = proposed.get(path);
+        if (before === after)
+            continue;
+        lines.push(`--- ${path}`);
+        lines.push(`+++ ${path}`);
+        lines.push('@@ file-replacement @@');
+        if (before !== undefined)
+            lines.push(...before.split('\n').map((line) => `-${line}`));
+        if (after !== undefined)
+            lines.push(...after.split('\n').map((line) => `+${line}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=proposals.js.map

package/dist/rooms/proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../../../src/rooms/proposals.ts"],"names":[],"mappings":"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"}

package/dist/rooms/replay.d.ts

@@ -0,0 +1,13 @@
+import type { EncryptedUpdateRecord } from '../server/append-log.js';
+import { type RoomComment } from './comments.js';
+import { type ProjectSnapshot } from './project-state.js';
+import { type ProposalReplay } from './proposals.js';
+import type { RoomAccess } from './room-reference.js';
+import { type TimelineEvent } from './timeline.js';
+export interface RoomReplay {
+    projectSnapshots: ProjectSnapshot[];
+    proposals: ProposalReplay;
+    comments: RoomComment[];
+    timeline: TimelineEvent[];
+}
+export declare function replayRoomRecords(access: RoomAccess, records: EncryptedUpdateRecord[]): Promise<RoomReplay>;

package/dist/rooms/replay.js

@@ -0,0 +1,19 @@
+import { replayCommentsFromRecords } from './comments.js';
+import { decryptProjectSnapshotsFromRecords } from './project-state.js';
+import { replayProposalsFromRecords } from './proposals.js';
+import { decryptTimelineEventsFromRecords } from './timeline.js';
+export async function replayRoomRecords(access, records) {
+    const [projectSnapshots, proposals, comments, timeline] = await Promise.all([
+        decryptProjectSnapshotsFromRecords(access, records),
+        replayProposalsFromRecords(access, records),
+        replayCommentsFromRecords(access, records),
+        decryptTimelineEventsFromRecords(access, records),
+    ]);
+    return {
+        projectSnapshots,
+        proposals,
+        comments,
+        timeline,
+    };
+}
+//# sourceMappingURL=replay.js.map

package/dist/rooms/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../../src/rooms/replay.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAoB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kCAAkC,EAAwB,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAuB,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,gCAAgC,EAAsB,MAAM,eAAe,CAAC;AASrF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAkB,EAClB,OAAgC;IAEhC,MAAM,CAAC,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1E,kCAAkC,CAAC,MAAM,EAAE,OAAO,CAAC;QACnD,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3C,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC;QAC1C,gCAAgC,CAAC,MAAM,EAAE,OAAO,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,gBAAgB;QAChB,SAAS;QACT,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/rooms/room-reference.d.ts

@@ -0,0 +1,21 @@
+export declare const ROOM_TOKEN_PREFIX = "fold:v1:";
+export declare const DEFAULT_SERVER_URL = "http://localhost:8787";
+export interface RoomAccess {
+    roomId: string;
+    roomSecret: string;
+    appUrl: string;
+    syncUrl: string;
+    serverUrl: string;
+}
+export interface ParsedRoomReference extends RoomAccess {
+    kind: 'token' | 'url';
+    roomUrl: string;
+    serverRoomUrl: string;
+}
+export declare function createRoomAccess(serverUrl?: string, appUrl?: string, syncUrl?: string): RoomAccess;
+export declare function createRoomToken(access: RoomAccess): string;
+export declare function parseRoomReference(input: string): ParsedRoomReference;
+export declare function roomUrlForAccess(access: RoomAccess): string;
+export declare function serverRoomUrlForAccess(access: RoomAccess): string;
+export declare function appRoomUrlForAccess(access: RoomAccess): string;
+export declare function normalizeServerUrl(input: string): string;

package/dist/rooms/room-reference.js

@@ -0,0 +1,142 @@
+import { webcrypto } from 'node:crypto';
+export const ROOM_TOKEN_PREFIX = 'fold:v1:';
+export const DEFAULT_SERVER_URL = 'http://localhost:8787';
+export function createRoomAccess(serverUrl = DEFAULT_SERVER_URL, appUrl = serverUrl, syncUrl = serverUrl) {
+    return {
+        roomId: randomBase64Url(16),
+        roomSecret: randomBase64Url(32),
+        appUrl: normalizeServerUrl(appUrl),
+        syncUrl: normalizeServerUrl(syncUrl),
+        serverUrl: normalizeServerUrl(syncUrl),
+    };
+}
+export function createRoomToken(access) {
+    const token = {
+        v: 1,
+        roomId: access.roomId,
+        roomSecret: access.roomSecret,
+        appUrl: normalizeServerUrl(access.appUrl ?? access.serverUrl),
+        syncUrl: normalizeServerUrl(access.syncUrl ?? access.serverUrl),
+    };
+    return `${ROOM_TOKEN_PREFIX}${Buffer.from(JSON.stringify(token), 'utf8').toString('base64url')}`;
+}
+export function parseRoomReference(input) {
+    if (input.startsWith(ROOM_TOKEN_PREFIX)) {
+        return parsedFromAccess(parseRoomToken(input), 'token');
+    }
+    return parseRoomUrl(input);
+}
+export function roomUrlForAccess(access) {
+    return `${appRoomUrlForAccess(access)}#key=${encodeURIComponent(access.roomSecret)}`;
+}
+export function serverRoomUrlForAccess(access) {
+    return appRoomUrlForAccess(access);
+}
+export function appRoomUrlForAccess(access) {
+    return `${normalizeServerUrl(access.appUrl ?? access.serverUrl)}/room/${encodeURIComponent(access.roomId)}`;
+}
+export function normalizeServerUrl(input) {
+    let parsed;
+    try {
+        parsed = new URL(input);
+    }
+    catch (error) {
+        throw new Error(`Invalid server URL ${JSON.stringify(input)}`, { cause: error });
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`Server URL must use http or https: ${JSON.stringify(input)}`);
+    }
+    parsed.hash = '';
+    parsed.search = '';
+    parsed.pathname = parsed.pathname.replace(/\/+$/, '');
+    return parsed.toString().replace(/\/$/, '');
+}
+function parseRoomToken(input) {
+    const encoded = input.slice(ROOM_TOKEN_PREFIX.length);
+    let raw;
+    try {
+        raw = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    }
+    catch (error) {
+        throw new Error('Invalid fold token encoding', { cause: error });
+    }
+    if (!isEncodedRoomToken(raw)) {
+        throw new Error('Invalid fold token schema');
+    }
+    return {
+        roomId: raw.roomId,
+        roomSecret: raw.roomSecret,
+        appUrl: normalizeServerUrl(raw.appUrl ?? raw.serverUrl ?? DEFAULT_SERVER_URL),
+        syncUrl: normalizeServerUrl(raw.syncUrl ?? raw.serverUrl ?? raw.appUrl ?? DEFAULT_SERVER_URL),
+        serverUrl: normalizeServerUrl(raw.syncUrl ?? raw.serverUrl ?? raw.appUrl ?? DEFAULT_SERVER_URL),
+    };
+}
+function parseRoomUrl(input) {
+    let parsed;
+    try {
+        parsed = new URL(input);
+    }
+    catch (error) {
+        throw new Error('Room must be a fold token or room URL', { cause: error });
+    }
+    const roomPath = roomPathFromUrl(parsed);
+    const fragment = new URLSearchParams(parsed.hash.startsWith('#') ? parsed.hash.slice(1) : parsed.hash);
+    const roomSecret = fragment.get('key');
+    if (!roomPath) {
+        throw new Error('Room URL must contain /room/:roomId');
+    }
+    if (!roomSecret) {
+        throw new Error('Room URL must contain client-side key material in #key=...');
+    }
+    return parsedFromAccess({
+        roomId: roomPath.roomId,
+        roomSecret,
+        appUrl: roomPath.serverUrl,
+        syncUrl: roomPath.serverUrl,
+        serverUrl: roomPath.serverUrl,
+    }, 'url');
+}
+function parsedFromAccess(access, kind) {
+    const normalized = {
+        ...access,
+        appUrl: normalizeServerUrl(access.appUrl ?? access.serverUrl),
+        syncUrl: normalizeServerUrl(access.syncUrl ?? access.serverUrl),
+        serverUrl: normalizeServerUrl(access.syncUrl ?? access.serverUrl),
+    };
+    return {
+        ...normalized,
+        kind,
+        roomUrl: roomUrlForAccess(normalized),
+        serverRoomUrl: serverRoomUrlForAccess(normalized),
+    };
+}
+function roomPathFromUrl(url) {
+    const parts = url.pathname.split('/').filter(Boolean);
+    const roomIndex = parts.lastIndexOf('room');
+    if (roomIndex === -1 || roomIndex === parts.length - 1)
+        return null;
+    const serverPath = parts.slice(0, roomIndex).join('/');
+    const serverUrl = serverPath ? `${url.origin}/${serverPath}` : url.origin;
+    return {
+        roomId: decodeURIComponent(parts[roomIndex + 1] ?? ''),
+        serverUrl,
+    };
+}
+function isEncodedRoomToken(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (candidate.v === 1 &&
+        typeof candidate.roomId === 'string' &&
+        candidate.roomId.length > 0 &&
+        typeof candidate.roomSecret === 'string' &&
+        candidate.roomSecret.length > 0 &&
+        ((typeof candidate.serverUrl === 'string' && candidate.serverUrl.length > 0) ||
+            (typeof candidate.appUrl === 'string' && candidate.appUrl.length > 0) ||
+            (typeof candidate.syncUrl === 'string' && candidate.syncUrl.length > 0)));
+}
+function randomBase64Url(byteLength) {
+    const bytes = webcrypto.getRandomValues(new Uint8Array(byteLength));
+    return Buffer.from(bytes).toString('base64url');
+}
+//# sourceMappingURL=room-reference.js.map

package/dist/rooms/room-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-reference.js","sourceRoot":"","sources":["../../../../src/rooms/room-reference.ts"],"names":[],"mappings":"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"}

package/dist/rooms/timeline.d.ts

@@ -0,0 +1,26 @@
+import type { EncryptedPayload } from './crypto.js';
+import type { EncryptedUpdateRecord, IncomingEncryptedUpdate } from '../server/append-log.js';
+import type { ProjectSnapshot } from './project-state.js';
+import type { RoomAccess } from './room-reference.js';
+export declare const TIMELINE_EVENT_SCHEMA = "fold.timeline-event.v1";
+export declare const TIMELINE_EVENT_SENDER_ID_PREFIX = "fold-cli:event";
+export type TimelineEventType = 'publish' | 'file_posted' | 'proposal_submitted' | 'proposal_accepted' | 'proposal_rejected' | 'export';
+export interface TimelineEvent {
+    schema: typeof TIMELINE_EVENT_SCHEMA;
+    id: string;
+    type: TimelineEventType;
+    createdAt: string;
+    actorPersonaId: string;
+    proposalId: string | null;
+    documentSha256: string | null;
+    message: string;
+    acceptedProject?: ProjectSnapshot;
+}
+export declare function createEncryptedTimelineEvent(access: RoomAccess, event: TimelineEvent): Promise<IncomingEncryptedUpdate>;
+export declare function createTimelineEvent(input: Omit<TimelineEvent, 'schema' | 'id' | 'createdAt'> & {
+    idSeed?: string;
+    createdAt?: string;
+}): TimelineEvent;
+export declare function decryptTimelineEventsFromRecords(access: RoomAccess, records: EncryptedUpdateRecord[]): Promise<TimelineEvent[]>;
+export declare function replayTimelineEvents(events: TimelineEvent[]): TimelineEvent[];
+export declare function decryptTimelineEvent(access: RoomAccess, payload: EncryptedPayload, senderId: string): Promise<TimelineEvent>;

package/dist/rooms/timeline.js

@@ -0,0 +1,68 @@
+import { randomUUID } from 'node:crypto';
+import { decryptJsonRecord, encryptJsonRecord } from './encrypted-records.js';
+export const TIMELINE_EVENT_SCHEMA = 'fold.timeline-event.v1';
+export const TIMELINE_EVENT_SENDER_ID_PREFIX = 'fold-cli:event';
+export async function createEncryptedTimelineEvent(access, event) {
+    const senderId = `${TIMELINE_EVENT_SENDER_ID_PREFIX}:${event.id}`;
+    return encryptJsonRecord(access, senderId, event);
+}
+export function createTimelineEvent(input) {
+    const createdAt = input.createdAt ?? new Date().toISOString();
+    return {
+        schema: TIMELINE_EVENT_SCHEMA,
+        id: randomUUID(),
+        type: input.type,
+        createdAt,
+        actorPersonaId: input.actorPersonaId,
+        proposalId: input.proposalId,
+        documentSha256: input.documentSha256,
+        message: input.message,
+        acceptedProject: input.acceptedProject,
+    };
+}
+export async function decryptTimelineEventsFromRecords(access, records) {
+    const events = [];
+    for (const record of records) {
+        if (!record.senderId.startsWith(TIMELINE_EVENT_SENDER_ID_PREFIX))
+            continue;
+        events.push(await decryptTimelineEvent(access, record, record.senderId));
+    }
+    return replayTimelineEvents(events);
+}
+export function replayTimelineEvents(events) {
+    return [...events].sort((left, right) => left.createdAt.localeCompare(right.createdAt));
+}
+export async function decryptTimelineEvent(access, payload, senderId) {
+    const value = await decryptJsonRecord(access, payload, senderId);
+    if (!isTimelineEvent(value)) {
+        throw new Error('Invalid encrypted timeline event payload');
+    }
+    return value;
+}
+function isTimelineEvent(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (candidate.schema === TIMELINE_EVENT_SCHEMA &&
+        isTimelineEventType(candidate.type) &&
+        typeof candidate.id === 'string' &&
+        typeof candidate.createdAt === 'string' &&
+        typeof candidate.actorPersonaId === 'string' &&
+        (typeof candidate.proposalId === 'string' || candidate.proposalId === null) &&
+        (typeof candidate.documentSha256 === 'string' || candidate.documentSha256 === null) &&
+        typeof candidate.message === 'string' &&
+        (candidate.acceptedProject === undefined ||
+            (candidate.acceptedProject.schema === 'fold.project.v1' &&
+                typeof candidate.acceptedProject.primaryPath === 'string' &&
+                typeof candidate.acceptedProject.updatedAt === 'string' &&
+                Array.isArray(candidate.acceptedProject.files))));
+}
+function isTimelineEventType(value) {
+    return (value === 'publish' ||
+        value === 'file_posted' ||
+        value === 'proposal_submitted' ||
+        value === 'proposal_accepted' ||
+        value === 'proposal_rejected' ||
+        value === 'export');
+}
+//# sourceMappingURL=timeline.js.map

package/dist/rooms/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../../src/rooms/timeline.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "fold-agent",
+  "version": "0.1.0",
+  "description": "Fold CLI for encrypted Markdown project rooms used by humans and agents.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "fold-agent": "./bin/fold-agent.js"
+  },
+  "files": [
+    "bin",
+    "dist/cli",
+    "dist/deploy",
+    "dist/rooms",
+    "skills/fold",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@stricli/core": "^1.2.7",
+    "prosemirror-markdown": "^1.13.4",
+    "prosemirror-model": "^1.25.7",
+    "ws": "^8.18.0",
+    "yjs": "^13.6.23"
+  }
+}