@ai-workbench/connect 0.7.7 → 0.7.11

package/lib/auth-status.js

@@ -1,18 +1,31 @@
-import { fail, ok } from "./needs.js";
+import { ok } from "./needs.js";
+import { authFailure, outputSummary } from "./auth-diagnostics.js";
 export function parseLoginStatus(provider, result) {
+    const invalid = (reason, details = {}) => authFailure('auth-status', reason, { exitCode: result.exitCode, ...(result.stderr !== '' ? { stderr: outputSummary(result.stderr) } : {}), ...details });
     let v;
     try {
         v = JSON.parse(result.stdout);
     }
-    catch {
-        return fail('AUTH_STATUS_INVALID');
+    catch (error) {
+        return invalid('STATUS_JSON_INVALID', { output: outputSummary(result.stdout), errorName: error instanceof SyntaxError ? 'SyntaxError' : 'UnknownError' });
     }
-    if (!v || typeof v !== 'object' || Array.isArray(v) || Object.keys(v).sort().join(',') !== 'exitCode,loggedIn,protocolVersion,provider')
-        return fail('AUTH_STATUS_INVALID');
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return invalid('STATUS_OBJECT_INVALID');
+    const expected = ['exitCode', 'loggedIn', 'protocolVersion', 'provider'];
+    if (Object.keys(v).sort().join(',') !== expected.join(','))
+        return invalid('STATUS_KEYS_INVALID', { missing: expected.filter(key => !Object.hasOwn(v, key)), unexpectedCount: Object.keys(v).filter(key => !expected.includes(key)).length });
     const status = v;
-    if (status.protocolVersion !== 1 || status.provider !== provider || status.exitCode !== result.exitCode || typeof status.loggedIn !== 'boolean' || result.stderr !== '')
-        return fail('AUTH_STATUS_INVALID');
+    if (status.protocolVersion !== 1)
+        return invalid('STATUS_VERSION_INVALID');
+    if (status.provider !== provider)
+        return invalid('STATUS_PROVIDER_INVALID');
+    if (status.exitCode !== result.exitCode)
+        return invalid('STATUS_EXIT_MISMATCH');
+    if (typeof status.loggedIn !== 'boolean')
+        return invalid('STATUS_LOGGED_IN_INVALID', { loggedInType: status.loggedIn === null ? 'null' : typeof status.loggedIn });
+    if (result.stderr !== '')
+        return invalid('STATUS_STDERR_NONEMPTY', { stderr: outputSummary(result.stderr) });
     if (status.loggedIn ? result.exitCode !== 0 : provider === 'codex' ? result.exitCode !== 1 : result.exitCode !== 0 && result.exitCode !== 1)
-        return fail('AUTH_STATUS_INVALID');
+        return invalid('STATUS_EXIT_INVALID');
     return ok({ provider, loggedIn: status.loggedIn });
 }

package/lib/components.d.ts

@@ -7,4 +7,4 @@ export interface ComponentInventory {
     claude: string;
     codex?: string;
 }
-export declare function registerComponents(ctx: Context, inventory?: ComponentInventory, temporaryDataParent?: string, component?: ComponentProgressStore, sources?: ComponentSources, observationIntervalMs?: number): void;
+export declare function registerComponents(ctx: Context, inventory?: ComponentInventory, temporaryDataParent?: string, component?: ComponentProgressStore, sources?: ComponentSources, observationIntervalMs?: number, metadataMaxBytes?: number): void;

package/lib/components.js

@@ -2,11 +2,12 @@ import { ComponentDownloadError } from "./component-download.js";
 import { L_DEFAULTS } from "./defaults.js";
 import { fail } from "./needs.js";
 import { employeeMessage } from "./startup.js";
-export function registerComponents(ctx, inventory, temporaryDataParent, component, sources, observationIntervalMs = L_DEFAULTS.componentObservationIntervalMs) {
+export function registerComponents(ctx, inventory, temporaryDataParent, component, sources, observationIntervalMs = L_DEFAULTS.componentObservationIntervalMs, metadataMaxBytes = L_DEFAULTS.enrollmentMetadataMaxBytes) {
+    const detailSettings = () => ctx.get('aiWorkbenchConversationDetailSettings');
     const api = () => ctx.get('aiWorkbenchConnect');
     const getState = () => {
         const network = ctx.get('aiWorkbenchNetwork'), connect = api(), state = connect?.getState(), networkState = network?.getState();
-        return { workspaceBindings: connect?.getWorkspaceBindingState?.() ?? null, loginComponent: { temporaryDataParent: temporaryDataParent ?? null, download: component?.getState() ?? null, source: sources?.getState() ?? null, observationIntervalMs }, startup: connect?.getLoginPromptState?.() ?? null, inventory: inventory ?? null, network: { serviceProvided: !!network, phase: networkState?.phase ?? 'missing', needCode: networkState?.error?.code ?? networkState?.need?.code }, enrollment: connect?.getEnrollmentState?.() ?? null, connection: connect?.getConnectionState?.() ?? null, connect: { serviceProvided: !!connect, phase: state?.phase ?? 'missing', message: state?.need ? employeeMessage(state.need.code) : '连接服务等待就绪' }, codex: inventory?.codex ? { installed: true, message: 'Codex 组件已安装' } : { installed: null, message: '组件清单未装配' } };
+        return { loginDiagnostics: connect?.getLoginDiagnosticState?.() ?? null, conversationDetails: connect?.getRemoteConversationDetailState?.() ?? null, conversationDetailSettings: detailSettings() ? { ...detailSettings().getState(), metadataMaxBytes } : null, workspaceBindings: connect?.getWorkspaceBindingState?.() ?? null, loginComponent: { temporaryDataParent: temporaryDataParent ?? null, download: component?.getState() ?? null, source: sources?.getState() ?? null, observationIntervalMs }, startup: connect?.getLoginPromptState?.() ?? null, inventory: inventory ?? null, network: { serviceProvided: !!network, phase: networkState?.phase ?? 'missing', needCode: networkState?.error?.code ?? networkState?.need?.code }, enrollment: connect?.getEnrollmentState?.() ?? null, connection: connect?.getConnectionState?.() ?? null, connect: { serviceProvided: !!connect, phase: state?.phase ?? 'missing', message: state?.need ? employeeMessage(state.need.code) : '连接服务等待就绪' }, codex: inventory?.codex ? { installed: true, message: 'Codex 组件已安装' } : { installed: null, message: '组件清单未装配' } };
     };
     ctx.provide('aiWorkbenchComponents', { getState });
     ctx.inject(['webServer', 'connection'], host => {
@@ -27,9 +28,9 @@ export function registerComponents(ctx, inventory, temporaryDataParent, componen
                         res.setHeader('Content-Type', 'text/event-stream; charset=utf-8');
                         res.statusCode = 200;
                         let closed = false;
-                        let unprompt = () => { }, unconnection = () => { }, unenrollment = () => { }, unnative = () => { }, undownload = () => { }, unsource = () => { };
+                        let unprompt = () => { }, unconnection = () => { }, unenrollment = () => { }, unnative = () => { }, undownload = () => { }, unsource = () => { }, undetails = () => { }, unloginDetails = () => { }, undetailsettings = () => { };
                         const close = () => { if (closed)
-                            return; closed = true; unprompt(); unconnection(); unenrollment(); unnative(); undownload(); unsource(); streams.delete(close); res.end(); };
+                            return; closed = true; unprompt(); unconnection(); unenrollment(); unnative(); undownload(); unsource(); undetails(); unloginDetails(); undetailsettings(); streams.delete(close); res.end(); };
                         const send = () => { if (closed)
                             return; try {
                             if (!res.write('data: ' + JSON.stringify(getState()) + '\n\n'))
@@ -44,11 +45,78 @@ export function registerComponents(ctx, inventory, temporaryDataParent, componen
                         unnative = service.onWorkspaceBindingState?.(send) ?? (() => { });
                         undownload = component?.onState(send) ?? (() => { });
                         unsource = sources?.onState(send) ?? (() => { });
+                        undetails = service.onRemoteConversationDetailState?.(send) ?? (() => { });
+                        unloginDetails = service.onLoginDiagnosticState?.(send) ?? (() => { });
+                        undetailsettings = detailSettings()?.onState(send) ?? (() => { });
                         streams.add(close);
                         res.once('close', close);
                         send();
                         return;
                     }
+                    if (req.method === 'GET' && ['/ai-workbench-connect/login-diagnostics', '/ai-workbench-connect/login-diagnostic-receipt'].includes(path)) {
+                        res.setHeader('Content-Type', 'application/json; charset=utf-8');
+                        const unavailable = () => { res.statusCode = 503; res.end(JSON.stringify(fail('DEPENDENCY_REQUIRED'))); };
+                        try {
+                            const isReceipt = path.endsWith('-receipt');
+                            if (!service || typeof service.getContractInfo !== 'function' || service.getContractInfo()?.loginDiagnostics !== 1 || typeof (isReceipt ? service.getLoginDiagnosticReceipt : service.listLoginDiagnostics) !== 'function') {
+                                unavailable();
+                                return;
+                            }
+                            const params = new URL(req.url ?? '/', 'http://dsh').searchParams, allowed = isReceipt ? ['sessionId', 'provider', 'eventId'] : ['sessionId', 'provider', 'cursor'];
+                            if ([...params.keys()].some(k => !allowed.includes(k) || params.getAll(k).length !== 1)) {
+                                res.statusCode = 400;
+                                res.end(JSON.stringify(fail('REMOTE_DETAIL_INVALID')));
+                                return;
+                            }
+                            const query = { sessionId: params.get('sessionId') ?? '', provider: params.get('provider') };
+                            const result = isReceipt ? await service.getLoginDiagnosticReceipt({ ...query, eventId: params.get('eventId') ?? '' }) : await service.listLoginDiagnostics({ ...query, ...(params.has('cursor') ? { cursor: params.get('cursor') } : {}) });
+                            res.statusCode = result.ok ? 200 : 409;
+                            res.end(JSON.stringify(result));
+                        }
+                        catch {
+                            unavailable();
+                        }
+                        return;
+                    }
+                    if (req.method === 'GET' && ['/ai-workbench-connect/conversation-details', '/ai-workbench-connect/conversation-detail-receipt'].includes(path) && service) {
+                        const params = new URL(req.url ?? '/', 'http://dsh').searchParams, isReceipt = path.endsWith('/conversation-detail-receipt'), allowed = isReceipt ? ['sessionId', 'provider', 'eventId'] : ['sessionId', 'provider', 'cursor'];
+                        res.setHeader('Content-Type', 'application/json; charset=utf-8');
+                        if ([...params.keys()].some(k => !allowed.includes(k) || params.getAll(k).length !== 1)) {
+                            res.statusCode = 400;
+                            res.end(JSON.stringify(fail('REMOTE_DETAIL_INVALID')));
+                            return;
+                        }
+                        const query = { sessionId: params.get('sessionId') ?? '', provider: params.get('provider') };
+                        const result = isReceipt ? await service.getRemoteConversationDetailReceipt({ ...query, eventId: params.get('eventId') ?? '' }) : await service.listRemoteConversationDetails({ ...query, ...(params.has('cursor') ? { cursor: params.get('cursor') } : {}) });
+                        res.statusCode = result.ok ? 200 : 409;
+                        res.end(JSON.stringify(result));
+                        return;
+                    }
+                    if (req.method === 'POST' && path === '/ai-workbench-connect/conversation-detail-settings' && detailSettings()) {
+                        res.setHeader('Content-Type', 'application/json; charset=utf-8');
+                        try {
+                            const chunks = [];
+                            let bytes = 0;
+                            for await (const chunk of req) {
+                                const data = Buffer.from(chunk);
+                                bytes += data.length;
+                                if (!Number.isSafeInteger(metadataMaxBytes) || metadataMaxBytes < 1 || bytes > metadataMaxBytes) {
+                                    res.statusCode = 400;
+                                    res.end(JSON.stringify({ ...getState(), actionErrorCode: 'SETTINGS_REQUIRED', actionError: '设置未保存：输入超出 enrollmentMetadataMaxBytes，请仅提交两项正安全整数。' }));
+                                    return;
+                                }
+                                chunks.push(data);
+                            }
+                            const result = await detailSettings().save(JSON.parse(Buffer.concat(chunks).toString('utf8')));
+                            res.statusCode = result.ok ? 200 : 409;
+                            res.end(JSON.stringify({ ...getState(), ...(!result.ok ? { actionErrorCode: result.error.code, actionError: result.error.message } : {}) }));
+                        }
+                        catch {
+                            res.statusCode = 400;
+                            res.end(JSON.stringify({ ...getState(), actionErrorCode: 'SETTINGS_REQUIRED', actionError: '设置未保存：请输入两项正安全整数。' }));
+                        }
+                        return;
+                    }
                     if (req.method === 'POST' && /^\/ai-workbench-connect\/component-download\/cancel\/[a-zA-Z0-9-]+$/.test(path) && component) {
                         res.setHeader('Content-Type', 'application/json; charset=utf-8');
                         if (Number(req.headers?.['content-length'] ?? 0) > 0 || req.headers?.['transfer-encoding']) {

package/lib/connect.js

@@ -3,6 +3,7 @@ import { dependency, fail, ok, need } from "./needs.js";
 import { isProjectName } from "./projects.js";
 import { createStartup } from "./startup.js";
 import { parseLoginStatus } from "./auth-status.js";
+import { authFailure } from "./auth-diagnostics.js";
 export function validEnrollment(e) {
     return typeof e === 'object' && e !== null && typeof e.host === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9.-]*$/.test(e.host)
         && typeof e.username === 'string' && /^emp-[a-z0-9][a-z0-9-]*$/.test(e.username)
@@ -14,6 +15,7 @@ export function validEnrollment(e) {
 export function createConnect(ports, emit, options = {}) {
     let state = { phase: 'idle' }, generation = 0, disposed = false;
     let flight;
+    let trustedTarget;
     const instanceId = randomUUID();
     let connection = { instanceId, phase: 'unavailable', epoch: 0 };
     const connectionListeners = new Set();
@@ -22,6 +24,8 @@ export function createConnect(ports, emit, options = {}) {
         const next = { instanceId, phase, epoch: generation, ...(need ? { need } : {}) };
         if (JSON.stringify(next) === JSON.stringify(connection))
             return;
+        if (phase !== 'connected')
+            trustedTarget = undefined;
         connection = structuredClone(next);
         startup?.connectionChanged(next);
         options.onConnectionState?.(structuredClone(next));
@@ -48,21 +52,27 @@ export function createConnect(ports, emit, options = {}) {
         loginFlights.clear();
     } const value = block(r); if (!r.ok && !disposed)
         setConnection('unavailable', r.error); return value; };
-    const connect = () => {
+    const connect = (reuseTrusted = false) => {
         if (disposed)
             return Promise.resolve(fail('DISPOSED'));
-        if (state.target)
-            return Promise.resolve(ok(structuredClone(state.target)));
+        if ((state.target || reuseTrusted) && connection.phase === 'connected' && trustedTarget)
+            return Promise.resolve(ok(structuredClone(trustedTarget)));
         if (flight)
             return flight;
+        // Replacing an established transport is a new trusted generation, even without a network-lost event.
+        if (connection.phase === 'connected') {
+            generation++;
+            controller.abort();
+            controller = new AbortController();
+            loginFlights.clear();
+        }
         const g = generation, signal = controller.signal;
-        if (connection.phase !== 'connected')
-            setConnection('connecting');
+        setConnection('connecting');
         const run = async () => {
             if (!ports.enrollment)
-                return transportBlock(dependency('S host-layout/enroll.json 适配器'));
+                return transportBlock(dependency('管理员发放的主机连接资料'));
             if (!ports.network)
-                return transportBlock(dependency('N net-helper 生命周期/状态适配器'));
+                return transportBlock(dependency('远程网络连接服务'));
             if (!ports.ssh)
                 return transportBlock(dependency('系统 SSH 适配器'));
             try {
@@ -83,7 +93,7 @@ export function createConnect(ports, emit, options = {}) {
                 if (!n.ok)
                     return transportBlock(n);
                 if (typeof n.value.proxyCommand !== 'string' || n.value.proxyCommand.length === 0 || /[\r\n\x00]/.test(n.value.proxyCommand))
-                    return transportBlock(dependency('有效的 N ProxyCommand'));
+                    return transportBlock(dependency('有效的远程网络连接通道'));
                 const { host, username, port, projectRoot, knownHostsFile, session, hostContext } = e.value;
                 const target = { host, username, port, projectRoot, knownHostsFile, session, ...(hostContext ? { hostContext } : {}), proxyCommand: n.value.proxyCommand };
                 publish({ phase: 'ssh' });
@@ -94,11 +104,12 @@ export function createConnect(ports, emit, options = {}) {
                 if (!verified.ok)
                     return transportBlock(verified);
                 publish({ phase: 'connected', target });
+                trustedTarget = structuredClone(target);
                 setConnection('connected');
                 return ok(structuredClone(target));
             }
             catch {
-                return invalid(g) ?? transportBlock(dependency('提供方调用失败，根因未查明；请检查 S/N/SSH 适配器'));
+                return invalid(g) ?? transportBlock(dependency('连接服务调用失败，根因未查明；请管理员检查连接资料、网络连接服务和 SSH 通道'));
             }
         };
         const promise = track(run());
@@ -108,30 +119,46 @@ export function createConnect(ports, emit, options = {}) {
         void promise.then(clear, clear);
         return promise;
     };
-    const checkLogin = async (provider) => {
+    const checkLogin = async (provider, reuseTrusted = false) => {
         if (provider !== 'claude' && provider !== 'codex')
             return fail('AUTH_STATUS_INVALID');
-        const g = generation;
-        const connected = await connect();
+        const connecting = connect(reuseTrusted), g = generation;
+        const connected = await connecting;
         const staleConnection = invalid(g);
         if (staleConnection)
             return staleConnection;
         if (!connected.ok)
             return connected;
+        const signal = controller.signal;
         publish({ phase: 'checking-login', target: connected.value, provider });
+        const stalePublish = invalid(g);
+        if (stalePublish)
+            return stalePublish;
+        const ticket = startup.beginCheck(provider);
+        const staleTicket = invalid(g);
+        if (staleTicket)
+            return staleTicket;
         try {
-            const raw = await ports.ssh.status(connected.value, provider, controller.signal);
+            const raw = await ports.ssh.status(connected.value, provider, signal);
             const stale = invalid(g);
             if (stale)
                 return stale;
             const status = raw.ok ? parseLoginStatus(provider, raw.value) : raw;
+            if (!startup.finishCheck(ticket, status))
+                return invalid(g) ?? authFailure('connect-check-login', 'STATUS_SUPERSEDED');
             if (!status.ok)
                 return ['network', 'ssh', 'enrollment'].includes(status.error.layer) ? transportBlock(status) : block(status);
             publish(status.value.loggedIn ? { phase: 'ready', target: connected.value, provider } : { phase: 'connected', target: connected.value, provider });
-            return status;
+            return invalid(g) ?? status;
         }
-        catch {
-            return invalid(g) ?? block(fail('AUTH_STATUS_INVALID'));
+        catch (error) {
+            const stale = invalid(g);
+            if (stale)
+                return stale;
+            const failure = authFailure('connect-check-login', 'STATUS_EXCEPTION', {}, error);
+            if (!startup.finishCheck(ticket, failure))
+                return authFailure('connect-check-login', 'STATUS_SUPERSEDED');
+            return block(failure);
         }
     };
     const login = (provider) => {
@@ -143,8 +170,8 @@ export function createConnect(ports, emit, options = {}) {
         if (prior)
             return prior;
         const run = async () => {
-            const g = generation;
-            const connected = await connect();
+            const connecting = connect(), g = generation;
+            const connected = await connecting;
             const staleConnection = invalid(g);
             if (staleConnection)
                 return staleConnection;
@@ -152,19 +179,39 @@ export function createConnect(ports, emit, options = {}) {
                 return connected;
             if (!ports.login)
                 return block(dependency('Electron 登录助手及已确认设置'));
+            const owner = startup.captureCheck(provider), signal = controller.signal;
             publish({ phase: 'login', target: connected.value, provider });
+            const stalePublish = invalid(g);
+            if (stalePublish)
+                return stalePublish;
+            if (!startup.currentTicket(owner))
+                return authFailure('connect-check-login', 'STATUS_SUPERSEDED');
             try {
-                const r = await ports.login.run(connected.value, provider, controller.signal);
+                const r = await ports.login.run(connected.value, provider, signal);
                 const stale = invalid(g);
                 if (stale)
                     return stale;
+                if (!startup.currentTicket(owner))
+                    return authFailure('connect-check-login', 'STATUS_SUPERSEDED');
                 if (!r.ok)
                     return ['network', 'ssh', 'enrollment'].includes(r.error.layer) ? transportBlock(r) : block(r);
-                const checked = await checkLogin(provider);
-                return checked.ok && !checked.value.loggedIn ? block(fail('LOGIN_FAILED')) : checked;
+                const checked = await checkLogin(provider), staleChecked = invalid(g);
+                if (staleChecked)
+                    return staleChecked;
+                if (checked.ok && !checked.value.loggedIn) {
+                    const failed = block(fail('LOGIN_FAILED'));
+                    startup.inheritCheck(checked, failed);
+                    return failed;
+                }
+                return checked;
             }
             catch {
-                return invalid(g) ?? block(fail('LOGIN_FAILED'));
+                const stale = invalid(g);
+                if (stale)
+                    return stale;
+                if (!startup.currentTicket(owner))
+                    return authFailure('connect-check-login', 'STATUS_SUPERSEDED');
+                return block(fail('LOGIN_FAILED'));
             }
         };
         const promise = track(run());
@@ -179,7 +226,7 @@ export function createConnect(ports, emit, options = {}) {
             return fail('DISPOSED');
         if (operation === 'create' && !isProjectName(name))
             return fail('PROJECT_NAME_INVALID');
-        const g = generation, connected = await connect();
+        const connecting = connect(), g = generation, connected = await connecting;
         const stale = invalid(g);
         if (stale)
             return stale;
@@ -212,9 +259,27 @@ export function createConnect(ports, emit, options = {}) {
         }
     });
     const operations = { getState: () => structuredClone(state), connect, checkLogin: provider => track(checkLogin(provider)), login };
-    startup = createStartup(operations, options.providers ?? ['codex', 'claude'], options.onPromptState, options.onPromptResult, instanceId);
+    startup = createStartup({ ...operations, connect: () => connect(true), checkLogin: provider => track(checkLogin(provider, true)) }, options.providers ?? ['codex', 'claude'], options.onPromptState, options.onPromptResult, instanceId);
     return {
         ...operations,
+        getModelCatalogTarget: provider => {
+            if (disposed)
+                return fail('DISPOSED');
+            if (provider !== 'claude' && provider !== 'codex')
+                return fail('MODEL_CATALOG_CONTEXT_INVALID');
+            if (connection.phase !== 'connected' || !trustedTarget)
+                return fail('CONNECTION_LOST');
+            return ok({ version: 1, purpose: 'model-catalog', scope: 'host-user', instanceId, epoch: connection.epoch, provider, target: structuredClone(trustedTarget) });
+        },
+        appendRemoteConversationDetail: async () => dependency('官方会话存储与持久诊断记录'),
+        appendLoginDiagnostic: async () => dependency('官方会话存储与持久登录诊断记录'),
+        getLoginDiagnosticReceipt: async () => dependency('官方会话存储与持久登录诊断记录'),
+        listLoginDiagnostics: async () => dependency('官方会话存储与持久登录诊断记录'),
+        getLoginDiagnosticState: () => ({ instanceId, epoch: connection.epoch, revision: 0, phase: disposed ? 'disposed' : 'unavailable', sessions: [], need: need(disposed ? 'DISPOSED' : 'DEPENDENCY_REQUIRED') }),
+        onLoginDiagnosticState: () => () => { },
+        getRemoteConversationDetailReceipt: async () => dependency('官方会话存储与持久诊断记录'),
+        getRemoteConversationDetailState: () => ({ instanceId, epoch: connection.epoch, revision: 0, phase: disposed ? 'disposed' : 'unavailable', sessions: [], need: need(disposed ? 'DISPOSED' : 'DEPENDENCY_REQUIRED') }),
+        onRemoteConversationDetailState: () => () => { }, listRemoteConversationDetails: async () => dependency('官方会话存储与持久诊断记录'),
         getContractInfo: () => ({ apiVersion: '0.7.0', status: 'implemented', workspaceBinding: 'native-local-v1' }),
         getEnrollmentState: () => ({ instanceId, revision: 0, phase: 'blocked', need: need('DEPENDENCY_REQUIRED') }), onEnrollmentState: () => () => { },
         importEnrollment: async () => dependency('官方profileContext与原生目录选择服务'),
@@ -227,8 +292,8 @@ export function createConnect(ports, emit, options = {}) {
         login: async (provider) => { const request = await startup.request(provider, 'automatic'); if (!request.ok)
             return request; return request.value.logins[provider] === true ? ok({ provider, loggedIn: true }) : fail('LOGIN_REQUIRED'); },
         ensureReady: provider => track((async () => {
-            const g = generation;
-            const r = await checkLogin(provider);
+            const checking = checkLogin(provider), g = generation;
+            const r = await checking;
             const stale = invalid(g);
             if (stale)
                 return stale;
@@ -238,7 +303,8 @@ export function createConnect(ports, emit, options = {}) {
                 const request = await startup.request(provider, 'automatic');
                 return invalid(g) ?? (!request.ok ? request : fail('LOGIN_REQUIRED'));
             }
-            return connect();
+            const connected = await connect();
+            return invalid(g) ?? connected;
         })()),
         dispose: () => { if (disposal)
             return disposal; startup.stop(); disposed = true; generation++; controller.abort(); unsubscribe?.(); publish({ phase: 'disposed' }); setConnection('disposed'); connectionListeners.clear(); disposal = Promise.allSettled([...pending]).then(() => startup.dispose()); return disposal; },

package/lib/conversation-detail-settings.d.ts

@@ -0,0 +1,32 @@
+export interface ConversationDetailSettingsValues {
+    maxEventBytes: number;
+    pageSize: number;
+}
+export interface ConversationDetailSettingsState {
+    instanceId: string;
+    revision: number;
+    phase: 'loading' | 'ready' | 'saving' | 'failed' | 'disposed';
+    values?: ConversationDetailSettingsValues;
+    source: 'config' | 'saved';
+    errorCode?: 'SETTINGS_REQUIRED' | 'REMOTE_DETAIL_STORAGE_FAILED';
+}
+export declare function validDetailSettings(v: any): v is ConversationDetailSettingsValues;
+export declare function createConversationDetailSettings(options: {
+    profileDir?: string;
+    initial?: Partial<ConversationDetailSettingsValues>;
+    metadataMaxBytes?: number;
+}): {
+    ready: Promise<void>;
+    getState: () => ConversationDetailSettingsState;
+    values: () => ConversationDetailSettingsValues | undefined;
+    onState(fn: () => void): () => void;
+    save: (input: ConversationDetailSettingsValues) => Promise<{
+        ok: false;
+        error: import("./api.ts").ConnectNeed;
+    } | {
+        ok: true;
+        value: undefined;
+    }>;
+    dispose(): Promise<void>;
+};
+export type ConversationDetailSettings = ReturnType<typeof createConversationDetailSettings>;

package/lib/conversation-detail-settings.js

@@ -0,0 +1,119 @@
+import { join, isAbsolute } from 'node:path';
+import { lstat, open, realpath, rename, rm } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { CONVERSATION_DETAIL_DEFAULTS, L_DEFAULTS } from "./defaults.js";
+import { privateDirectory, readPrivate } from "./private-files.js";
+import { fail, ok } from "./needs.js";
+const queues = new Map();
+export function validDetailSettings(v) { return !!v && typeof v === 'object' && Object.keys(v).sort().join(',') === 'maxEventBytes,pageSize' && [v.maxEventBytes, v.pageSize].every(n => Number.isSafeInteger(n) && n > 0); }
+export function createConversationDetailSettings(options) {
+    const root = options.profileDir ? join(options.profileDir, 'ai-workbench-connect') : undefined, file = root ? join(root, 'conversation-detail-settings.json') : undefined;
+    let state = { instanceId: randomUUID(), revision: 0, phase: 'loading', source: 'config' }, disposed = false, tail = Promise.resolve();
+    const listeners = new Set();
+    function publish(next) { state = { ...state, ...next, revision: state.revision + 1 }; for (const fn of listeners)
+        fn(); }
+    async function directory() { if (!options.profileDir || !root || !isAbsolute(options.profileDir) || await realpath(options.profileDir) !== options.profileDir)
+        throw Error('SETTINGS_PROFILE_INVALID'); await privateDirectory(root); if (await realpath(root) !== root)
+        throw Error('SETTINGS_PATH_INVALID'); const st = await lstat(root); if ((st.mode & 0o777) !== 0o700)
+        throw Error('SETTINGS_PATH_INVALID'); const parent = await open(options.profileDir, constants.O_RDONLY | constants.O_NOFOLLOW); try {
+        await parent.sync();
+    }
+    finally {
+        await parent.close();
+    } }
+    async function existing() { const st = await lstat(file); if (!st.isFile() || st.isSymbolicLink() || st.nlink !== 1 || (st.mode & 0o777) !== 0o600)
+        throw Error('SETTINGS_PATH_INVALID'); }
+    const ready = (async () => {
+        try {
+            await directory();
+            let values = { ...CONVERSATION_DETAIL_DEFAULTS, ...options.initial }, source = 'config';
+            try {
+                await existing();
+                const saved = JSON.parse(await readPrivate(file, options.metadataMaxBytes ?? L_DEFAULTS.enrollmentMetadataMaxBytes));
+                if (saved.version !== 1 || !validDetailSettings(saved.values))
+                    throw Error('SETTINGS_INVALID');
+                values = saved.values;
+                source = 'saved';
+            }
+            catch (e) {
+                if (e.code !== 'ENOENT')
+                    throw e;
+            }
+            if (!validDetailSettings(values))
+                throw Error('SETTINGS_INVALID');
+            if (!disposed)
+                publish({ phase: 'ready', values, source });
+        }
+        catch {
+            if (!disposed)
+                publish({ phase: 'failed', values: undefined, errorCode: 'REMOTE_DETAIL_STORAGE_FAILED' });
+        }
+    })();
+    function save(input) {
+        if (!validDetailSettings(input))
+            return Promise.resolve(fail('SETTINGS_REQUIRED'));
+        const values = structuredClone(input);
+        const task = (queues.get(file ?? '') ?? Promise.resolve()).then(async () => {
+            await ready;
+            if (disposed)
+                return fail('DISPOSED');
+            if (state.phase === 'failed')
+                return fail('REMOTE_DETAIL_STORAGE_FAILED');
+            publish({ phase: 'saving', errorCode: undefined });
+            let temp;
+            try {
+                await directory();
+                try {
+                    await existing();
+                }
+                catch (e) {
+                    if (e.code !== 'ENOENT')
+                        throw e;
+                }
+                const bytes = JSON.stringify({ version: 1, values }) + '\n';
+                if (Buffer.byteLength(bytes) > (options.metadataMaxBytes ?? L_DEFAULTS.enrollmentMetadataMaxBytes))
+                    throw Error('SETTINGS_LIMIT');
+                temp = join(root, '.conversation-detail-settings-' + randomUUID());
+                const h = await open(temp, 'wx', 0o600);
+                try {
+                    await h.writeFile(bytes);
+                    await h.sync();
+                }
+                finally {
+                    await h.close();
+                }
+                if (disposed)
+                    return fail('DISPOSED');
+                await rename(temp, file);
+                temp = undefined;
+                const dir = await open(root, constants.O_RDONLY | constants.O_NOFOLLOW);
+                try {
+                    await dir.sync();
+                }
+                finally {
+                    await dir.close();
+                }
+                if (disposed)
+                    return fail('DISPOSED');
+                publish({ phase: 'ready', values, source: 'saved', errorCode: undefined });
+                return ok(undefined);
+            }
+            catch {
+                publish({ phase: 'failed', values: undefined, errorCode: 'REMOTE_DETAIL_STORAGE_FAILED' });
+                return fail('REMOTE_DETAIL_STORAGE_FAILED');
+            }
+            finally {
+                if (temp)
+                    await rm(temp, { force: true });
+            }
+        });
+        const done = task.then(() => { }, () => { });
+        queues.set(file ?? '', done);
+        tail = done;
+        void done.then(() => { if (queues.get(file ?? '') === done)
+            queues.delete(file ?? ''); });
+        return task;
+    }
+    return { ready, getState: () => structuredClone(state), values: () => state.phase === 'ready' ? structuredClone(state.values) : undefined, onState(fn) { listeners.add(fn); return () => { listeners.delete(fn); }; }, save, async dispose() { disposed = true; await ready; await tail; publish({ phase: 'disposed', values: undefined }); listeners.clear(); } };
+}

package/lib/conversation-details.d.ts

@@ -0,0 +1,24 @@
+import type { ConnectApi, ConnectionState, Provider, RemoteConversationDetail, RemoteConversationDetailState, Result } from './api.ts';
+export interface ConversationDetailOptions {
+    profileDir: string;
+    maxEventBytes: number;
+    pageSize: number;
+    storageName?: 'conversation-details' | 'login-diagnostics';
+    validate?: (detail: RemoteConversationDetail) => boolean;
+    knownKinds?: readonly string[];
+    getConnectionState: () => ConnectionState;
+    context: () => Promise<Result<{
+        identity: string;
+    }>>;
+    scope: (sessionId: string, provider: Provider) => Promise<Result<{
+        identity: string;
+    }>>;
+    onState?: (state: RemoteConversationDetailState) => void;
+}
+export declare function validRemoteConversationDetail(v: any): v is RemoteConversationDetail;
+type DetailsApi = Pick<ConnectApi, 'appendRemoteConversationDetail' | 'getRemoteConversationDetailReceipt' | 'getRemoteConversationDetailState' | 'onRemoteConversationDetailState' | 'listRemoteConversationDetails'>;
+export declare function createConversationDetails(options: ConversationDetailOptions): DetailsApi & {
+    observeConnection: (state: ConnectionState) => void;
+    dispose: () => Promise<void>;
+};
+export {};