ftown 0.19.66 → 0.19.68

package/dist/preview-chat-protocol.js

@@ -0,0 +1,9 @@
+/** Shared preview conversation wire contract. No terminal transcript or iframe messages. */
+export const PREVIEW_CHAT_TEXT_BYTES = 4096;
+export const PREVIEW_CHAT_PAGE_BYTES = 65536;
+export const PREVIEW_CHAT_PAGE_TURNS = 25;
+export const PREVIEW_CHAT_MAX_TURNS = 1000;
+export const PREVIEW_CHAT_STORE_BYTES = 4 * 1024 * 1024;
+export const PREVIEW_CHAT_POLL_MS = 1500;
+export const PREVIEW_CHAT_AGENT_SHELLS = ['claude', 'cursor', 'codex', 'zai', 'kimi', 'opencode', 'deepseek', 'fireworks', 'grok', 'pi', 'kimi-code', 'muse'];
+//# sourceMappingURL=preview-chat-protocol.js.map

package/dist/preview-chat-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-chat-protocol.js","sourceRoot":"","sources":["../src/preview-chat-protocol.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC"}

package/dist/preview-chat.d.ts

@@ -0,0 +1,18 @@
+import type { PreviewChatErrorCode, PreviewChatInput, PreviewChatPage, PreviewChatTurn } from './preview-chat-protocol.js';
+export declare class PreviewChatError extends Error {
+    readonly code: PreviewChatErrorCode;
+    constructor(code: PreviewChatErrorCode, message: string);
+}
+export declare function validateChatInput(input: PreviewChatInput): void;
+/** Caller serializes all methods with the session lifecycle queue. */
+export declare class PreviewChatStore {
+    private readonly sessionDir;
+    constructor(sessionDir: (id: string) => string);
+    private path;
+    private load;
+    private save;
+    find(id: string, input: PreviewChatInput, role: PreviewChatTurn['role']): Promise<PreviewChatTurn | null>;
+    reserve(id: string, input: PreviewChatInput, role: PreviewChatTurn['role']): Promise<PreviewChatTurn>;
+    markQueued(id: string, turnId: string): Promise<PreviewChatTurn>;
+    list(id: string, cursor?: string): Promise<PreviewChatPage>;
+}

package/dist/preview-chat.js

@@ -0,0 +1,155 @@
+import { randomUUID } from 'node:crypto';
+import { open, rename, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { PREVIEW_CHAT_MAX_TURNS, PREVIEW_CHAT_PAGE_BYTES, PREVIEW_CHAT_PAGE_TURNS, PREVIEW_CHAT_STORE_BYTES, PREVIEW_CHAT_TEXT_BYTES } from './preview-chat-protocol.js';
+const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const session = /^[A-Za-z0-9_-]{1,200}$/;
+export class PreviewChatError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export function validateChatInput(input) {
+    if (!input || typeof input.id !== 'string' || !uuid.test(input.id) || typeof input.text !== 'string' || !input.text.trim()
+        || /[\x00-\x08\x0b-\x1f\x7f-\x9f]/.test(input.text))
+        throw new PreviewChatError('invalid', 'Invalid conversation message');
+    if (Buffer.byteLength(input.text, 'utf8') > PREVIEW_CHAT_TEXT_BYTES)
+        throw new PreviewChatError('too_large', 'Conversation message is too large');
+}
+const turnSchema = z.object({ id: z.string().regex(uuid), sequence: z.number().int().positive(), text: z.string(), createdAt: z.iso.datetime(),
+    role: z.enum(['user', 'agent']), delivery: z.enum(['unconfirmed', 'queued', 'recorded']) }).strict();
+const ledgerSchema = z.object({ schema: z.literal(1), turns: z.array(turnSchema).max(PREVIEW_CHAT_MAX_TURNS) }).strict();
+/** Caller serializes all methods with the session lifecycle queue. */
+export class PreviewChatStore {
+    sessionDir;
+    constructor(sessionDir) {
+        this.sessionDir = sessionDir;
+    }
+    path(id) { return join(this.sessionDir(id), 'preview-chat.json'); }
+    async load(id) {
+        if (!session.test(id))
+            throw new PreviewChatError('invalid', 'Invalid session');
+        let raw;
+        try {
+            const file = await open(this.path(id), 'r');
+            try {
+                if (!(await file.stat()).isFile())
+                    throw new Error('invalid file');
+                const buffer = Buffer.alloc(PREVIEW_CHAT_STORE_BYTES + 1);
+                let used = 0;
+                while (used < buffer.length) {
+                    const { bytesRead } = await file.read(buffer, used, buffer.length - used, used);
+                    if (!bytesRead)
+                        break;
+                    used += bytesRead;
+                }
+                if (used > PREVIEW_CHAT_STORE_BYTES)
+                    throw new Error('oversize');
+                raw = new TextDecoder('utf-8', { fatal: true }).decode(buffer.subarray(0, used));
+            }
+            finally {
+                await file.close();
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw new PreviewChatError('unavailable', 'Conversation storage unavailable');
+        }
+        try {
+            if (Buffer.byteLength(raw) > PREVIEW_CHAT_STORE_BYTES)
+                throw new Error('oversize');
+            const value = ledgerSchema.parse(JSON.parse(raw));
+            const ids = new Set();
+            return value.turns.map((turn, index) => {
+                validateChatInput(turn);
+                if (turn.sequence !== index + 1 || ids.has(turn.id.toLowerCase()) || (turn.role === 'user' ? turn.delivery === 'recorded' : turn.delivery !== 'recorded'))
+                    throw new Error('invalid turn');
+                ids.add(turn.id.toLowerCase());
+                if (turn.role === 'agent')
+                    return { ...turn, role: 'agent', delivery: 'recorded' };
+                if (turn.delivery === 'unconfirmed' || turn.delivery === 'queued')
+                    return { ...turn, role: 'user', delivery: turn.delivery };
+                throw new Error('invalid turn');
+            });
+        }
+        catch {
+            throw new PreviewChatError('unavailable', 'Conversation storage unavailable');
+        }
+    }
+    async save(id, turns) {
+        const data = JSON.stringify({ schema: 1, turns });
+        if (turns.length > PREVIEW_CHAT_MAX_TURNS || Buffer.byteLength(data) > PREVIEW_CHAT_STORE_BYTES)
+            throw new PreviewChatError('capacity_exceeded', 'Conversation is full');
+        const path = this.path(id);
+        const temp = `${path}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temp, data, { flag: 'wx', mode: 0o600 });
+            await rename(temp, path);
+        }
+        catch {
+            await rm(temp, { force: true }).catch(() => { });
+            throw new PreviewChatError('unavailable', 'Conversation storage unavailable');
+        }
+    }
+    async find(id, input, role) {
+        validateChatInput(input);
+        const found = (await this.load(id)).find(turn => turn.id.toLowerCase() === input.id.toLowerCase());
+        if (found && (found.role !== role || found.text !== input.text))
+            throw new PreviewChatError('conflict', 'Message ID already used');
+        return found ?? null;
+    }
+    async reserve(id, input, role) {
+        validateChatInput(input);
+        const turns = await this.load(id);
+        const existing = turns.find(turn => turn.id.toLowerCase() === input.id.toLowerCase());
+        if (existing) {
+            if (existing.role !== role || existing.text !== input.text)
+                throw new PreviewChatError('conflict', 'Message ID already used');
+            return existing;
+        }
+        const base = { id: input.id, text: input.text, sequence: turns.length + 1, createdAt: new Date().toISOString() };
+        const turn = role === 'user' ? { ...base, role, delivery: 'unconfirmed' } : { ...base, role, delivery: 'recorded' };
+        await this.save(id, [...turns, turn]);
+        return turn;
+    }
+    async markQueued(id, turnId) {
+        const turns = await this.load(id);
+        const index = turns.findIndex(turn => turn.id.toLowerCase() === turnId.toLowerCase());
+        if (index < 0 || turns[index].role !== 'user')
+            throw new PreviewChatError('unavailable', 'Conversation storage unavailable');
+        const turn = turns[index];
+        if (turn.role !== 'user')
+            throw new PreviewChatError('unavailable', 'Conversation storage unavailable');
+        const queued = { ...turn, delivery: 'queued' };
+        turns[index] = queued;
+        await this.save(id, turns);
+        return queued;
+    }
+    async list(id, cursor) {
+        const turns = await this.load(id);
+        const prefix = `${id}:`;
+        let offset = 0;
+        if (cursor !== undefined) {
+            if (!cursor.startsWith(prefix) || !/^(0|[1-9]\d*)$/.test(cursor.slice(prefix.length)))
+                throw new PreviewChatError('invalid', 'Invalid conversation cursor');
+            offset = Number(cursor.slice(prefix.length));
+            if (!Number.isSafeInteger(offset) || offset > turns.length)
+                throw new PreviewChatError('invalid', 'Invalid conversation cursor');
+        }
+        const page = { sessionId: id, turns: [], cursor: `${id}:${offset}`, hasMore: offset < turns.length };
+        for (const turn of turns.slice(offset, offset + PREVIEW_CHAT_PAGE_TURNS)) {
+            const candidate = { sessionId: id, turns: [...page.turns, turn], cursor: `${id}:${turn.sequence}`, hasMore: turn.sequence < turns.length };
+            if (Buffer.byteLength(JSON.stringify(candidate), 'utf8') > PREVIEW_CHAT_PAGE_BYTES)
+                break;
+            Object.assign(page, candidate);
+        }
+        if (page.hasMore && !page.turns.length)
+            throw new PreviewChatError('unavailable', 'Conversation page unavailable');
+        return page;
+    }
+}
+//# sourceMappingURL=preview-chat.js.map

package/dist/preview-chat.js.map

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

package/dist/pull-request-events.d.ts

@@ -0,0 +1,40 @@
+import type { SessionStore } from './session-store.js';
+import type { Session } from './types.js';
+import type { PullRequestStatusService } from './pull-request-status.js';
+import type { MailStore } from './mail-store.js';
+type Timer = ReturnType<typeof setTimeout>;
+interface Options {
+    bridgeId: string;
+    store: Pick<SessionStore, 'listSessions' | 'loadSession' | 'saveSession'>;
+    withSessionMutation: (id: string, task: () => Promise<void>) => Promise<void>;
+    statusService: Pick<PullRequestStatusService, 'getObservations' | 'setBackgroundUrls'>;
+    mailStore: Pick<MailStore, 'commitPullRequestObservation'>;
+    notifyCommitted: (session: Session, sender: string) => Promise<void>;
+    now?: () => number;
+    setTimeout?: (fn: () => void, ms: number) => Timer;
+    clearTimeout?: (timer: Timer) => void;
+}
+/** Polls only observed changes using the same cache and quota as dashboard reads. */
+export declare class PullRequestEventWatcher {
+    private readonly options;
+    private stopped;
+    private started;
+    private epoch;
+    private flight?;
+    private timer?;
+    private group;
+    private baseline;
+    private cursor;
+    private pendingWake;
+    private nextDelay;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    constructor(options: Options);
+    start(): void;
+    private schedule;
+    stop(): Promise<void>;
+    runOnce(): Promise<void>;
+    private scan;
+}
+export {};

package/dist/pull-request-events.js

@@ -0,0 +1,205 @@
+import { randomUUID } from 'node:crypto';
+import { normalizePullRequestUrl } from './pull-request-url.js';
+function canonical(value) {
+    if (!value)
+        return undefined;
+    try {
+        const url = normalizePullRequestUrl(value);
+        return Number(url.slice(url.lastIndexOf('/') + 1)) <= 2_147_483_647 ? url : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function eligible(session, bridgeId) {
+    return !!session && session.bridgeId === bridgeId && session.shellType !== 'shell' && !!canonical(session.pullRequestUrl);
+}
+/** Polls only observed changes using the same cache and quota as dashboard reads. */
+export class PullRequestEventWatcher {
+    options;
+    stopped = false;
+    started = false;
+    epoch = 0;
+    flight;
+    timer;
+    group = [];
+    baseline = new Map();
+    cursor = '';
+    pendingWake = new Map();
+    nextDelay = 60_000;
+    now;
+    setTimer;
+    clearTimer;
+    constructor(options) {
+        this.options = options;
+        this.now = options.now ?? Date.now;
+        this.setTimer = options.setTimeout ?? ((fn, ms) => setTimeout(fn, ms));
+        this.clearTimer = options.clearTimeout ?? (timer => clearTimeout(timer));
+    }
+    start() {
+        if (this.started || this.stopped)
+            return;
+        this.started = true;
+        void this.runOnce().catch(error => console.error('[PR events] Scan failed:', error)).finally(() => this.schedule());
+    }
+    schedule() {
+        if (!this.started || this.stopped || this.timer)
+            return;
+        this.timer = this.setTimer(() => { this.timer = undefined; void this.runOnce().catch(error => console.error('[PR events] Scan failed:', error)).finally(() => this.schedule()); }, Math.max(60_000, this.nextDelay));
+        this.timer.unref?.();
+    }
+    async stop() {
+        this.stopped = true;
+        this.epoch++;
+        if (this.timer) {
+            this.clearTimer(this.timer);
+            this.timer = undefined;
+        }
+        await this.flight?.catch(() => { });
+        this.options.statusService.setBackgroundUrls([]);
+    }
+    runOnce() {
+        if (this.stopped)
+            return Promise.resolve();
+        if (this.flight)
+            return this.flight;
+        const epoch = this.epoch;
+        this.flight = this.scan(epoch).finally(() => { this.flight = undefined; });
+        return this.flight;
+    }
+    async scan(epoch) {
+        const { store, bridgeId, withSessionMutation, statusService, mailStore, notifyCommitted } = this.options;
+        const active = () => !this.stopped && this.epoch === epoch;
+        const links = [];
+        for (const candidate of await store.listSessions()) {
+            if (!active())
+                return;
+            if (!eligible(candidate, bridgeId))
+                continue;
+            try {
+                await withSessionMutation(candidate.id, async () => {
+                    if (!active())
+                        return;
+                    const session = await store.loadSession(candidate.id);
+                    if (!eligible(session, bridgeId))
+                        return;
+                    const url = canonical(session.pullRequestUrl);
+                    const linkId = session.pullRequestLinkId ?? randomUUID();
+                    if (!session.pullRequestLinkId)
+                        await store.saveSession({ ...session, pullRequestLinkId: linkId });
+                    links.push({ id: session.id, url, key: url.toLowerCase(), linkId });
+                });
+            }
+            catch {
+                // One damaged session must not prevent unrelated links from being scanned.
+                console.error(`[PR events] Could not inspect session ${candidate.id}`);
+            }
+        }
+        if (!active())
+            return;
+        // A committed message survives a failed wake; retry without depending on a fresh gh result.
+        for (const [id, pending] of this.pendingWake) {
+            let sessionForWake;
+            try {
+                await withSessionMutation(id, async () => {
+                    if (!active())
+                        return;
+                    const session = await store.loadSession(id);
+                    if (eligible(session, bridgeId) && canonical(session.pullRequestUrl)?.toLowerCase() === pending.key && session.pullRequestLinkId === pending.linkId)
+                        sessionForWake = session;
+                });
+            }
+            catch {
+                // Keep the retry pending; other sessions and status groups can still progress.
+                console.error(`[PR events] Could not inspect session ${id}`);
+                continue;
+            }
+            if (!active())
+                return;
+            if (!sessionForWake) {
+                this.pendingWake.delete(id);
+                continue;
+            }
+            try {
+                await notifyCommitted(sessionForWake, 'FTown PR updates');
+                this.pendingWake.delete(id);
+            }
+            catch { /* Retry on the next scan. */ }
+        }
+        const urls = [...new Map(links.map(link => [link.key, link.url])).entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+        const keys = new Set(urls.map(([key]) => key));
+        if (this.group.some(key => !keys.has(key))) {
+            this.group = [];
+            this.baseline.clear();
+        }
+        if (!this.group.length && urls.length) {
+            let start = urls.findIndex(([key]) => key > this.cursor);
+            if (start < 0)
+                start = 0;
+            const selected = [...urls.slice(start), ...urls.slice(0, start)].slice(0, 20);
+            this.group = selected.map(([key]) => key);
+            // Capture attempt ordinals before pinning: a quota-blocked read must not advance the group.
+            const before = await statusService.getObservations(selected.map(([, url]) => url));
+            if (!active())
+                return;
+            this.baseline = new Map(before.observations.map(item => [item.url.toLowerCase(), item.attempt]));
+            statusService.setBackgroundUrls(selected.map(([, url]) => url));
+        }
+        if (!this.group.length) {
+            statusService.setBackgroundUrls([]);
+            this.nextDelay = 60_000;
+            return;
+        }
+        const selectedUrls = this.group.map(key => urls.find(([entry]) => entry === key)?.[1]).filter((url) => !!url);
+        const result = await statusService.getObservations(selectedUrls);
+        if (!active())
+            return;
+        this.nextDelay = Math.max(60_000, Date.parse(result.nextRefreshAt) - this.now() || 60_000);
+        const observed = new Map(result.observations.map(item => [item.url.toLowerCase(), item]));
+        for (const link of links) {
+            const observation = observed.get(link.key);
+            if (!observation || observation.stale || observation.reason || !observation.checkedAt || !['in_progress', 'failed', 'passed', 'merged'].includes(observation.state))
+                continue;
+            let sessionForWake;
+            let attemptingCommit = false;
+            try {
+                await withSessionMutation(link.id, async () => {
+                    if (!active())
+                        return;
+                    const session = await store.loadSession(link.id);
+                    if (!eligible(session, bridgeId) || canonical(session.pullRequestUrl)?.toLowerCase() !== link.key || session.pullRequestLinkId !== link.linkId)
+                        return;
+                    attemptingCommit = true;
+                    await mailStore.commitPullRequestObservation(session.id, link.linkId, observation);
+                    if (active())
+                        sessionForWake = session;
+                });
+            }
+            catch {
+                // A failed atomic commit may have renamed successfully before reporting an error.
+                if (active() && attemptingCommit)
+                    this.pendingWake.set(link.id, { key: link.key, linkId: link.linkId });
+                console.error(`[PR events] Could not commit observation for session ${link.id}`);
+                continue;
+            }
+            if (active() && sessionForWake) {
+                try {
+                    await notifyCommitted(sessionForWake, 'FTown PR updates');
+                    this.pendingWake.delete(link.id);
+                }
+                catch {
+                    this.pendingWake.set(link.id, { key: link.key, linkId: link.linkId });
+                }
+            }
+        }
+        if (this.group.every(key => { const observation = observed.get(key); return !!observation && ((!observation.stale && !!observation.checkedAt && !observation.reason) || observation.attempt !== (this.baseline.get(key) ?? 0)); })) {
+            this.cursor = this.group.at(-1);
+            this.group = [];
+            this.baseline.clear();
+            statusService.setBackgroundUrls([]);
+            // Keep discovering new links and rotating other groups at the shared quota cadence.
+            this.nextDelay = 60_000;
+        }
+    }
+}
+//# sourceMappingURL=pull-request-events.js.map

package/dist/pull-request-events.js.map

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

package/dist/pull-request-status.d.ts

@@ -1,10 +1,14 @@
-import type { PullRequestStatusesResponse } from './pull-request-status-protocol.js';
+import type { PullRequestStatus, PullRequestStatusesResponse } from './pull-request-status-protocol.js';
 type RunnerResult = {
     stdout: string;
     stderr: string;
     exitCode: number;
 };
 type Runner = (input: string) => Promise<RunnerResult>;
+export interface PullRequestObservation extends PullRequestStatus {
+    headOid?: string;
+    attempt: number;
+}
 /** Run a single bounded gh process; credentials stay in gh's environment. */
 export declare function runGh(input: string): Promise<RunnerResult>;
 /** Process-wide, demand-driven PR status cache and quota gate. */
@@ -16,8 +20,19 @@ export declare class PullRequestStatusService {
     private cooldown;
     private flight;
     private sequence;
+    private attemptSequence;
+    private background;
+    private inFlight;
     constructor(now?: () => number, runner?: Runner);
+    private entry;
+    private evict;
+    setBackgroundUrls(urls: readonly string[]): void;
     get(urls: readonly string[]): Promise<Pick<PullRequestStatusesResponse, 'statuses' | 'nextRefreshAt'>>;
+    getObservations(urls: readonly string[]): Promise<{
+        observations: PullRequestObservation[];
+        nextRefreshAt: string;
+    }>;
+    private read;
     private refresh;
 }
 export {};