dsh-cliworker-now 0.0.0-stage → 0.7.7

package/lib/types/client/worker-model-menu.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Button, StateDot, Input, Menu, MenuItemButton, IconChevronDownOutlineRegular, IconChevronRightOutlineRegular, IconCheckOutlineRegular, } from '@deepseek-ai/dsh-client-ui-primitives';
+import { active, cliOf, CLI_LABELS, effortLabel, } from "../shared/types.js";
+import { modelName } from "../shared/models.js";
+import { displayModelName, visibleModelChoices } from "../shared/model-presentation.js";
+import { value } from "./workers.js";
+import { operationMessage } from "./operation-error.js";
+/** Native menu primitive with the same model / effort drill-in flow as Harness ModelSelect. */
+export function WorkerModelMenu({ worker, api, sessionId, disabled, }) {
+    const cli = cliOf(worker.preference);
+    const [open, setOpen] = useState(false);
+    const [pane, setPane] = useState('root');
+    const [catalog, setCatalog] = useState();
+    const [error, setError] = useState('');
+    const [attempt, retry] = useState(0);
+    const [saving, setSaving] = useState(false);
+    const [loading, setLoading] = useState(false);
+    const [query, setQuery] = useState('');
+    const alive = useRef(true);
+    useEffect(() => {
+        alive.current = true;
+        return () => {
+            alive.current = false;
+        };
+    }, []);
+    useEffect(() => {
+        if (!open)
+            return;
+        const controller = new AbortController();
+        setLoading(true);
+        setCatalog(undefined);
+        setError('');
+        void api.cliworker
+            .catalogForCli(sessionId, cli, controller.signal)
+            .then((result) => {
+            if (controller.signal.aborted)
+                return;
+            const next = JSON.parse(value(result));
+            if (next.cli !== cli)
+                throw new Error('收到不匹配的 CLI 模型目录，请重试');
+            if (!Array.isArray(next.models) || !next.models.length)
+                throw new Error(next.notice || '此 CLI 未返回可用模型，请登录或刷新重试');
+            setCatalog(next);
+        })
+            .catch((e) => {
+            if (!controller.signal.aborted) {
+                setCatalog(undefined);
+                setError(operationMessage(e));
+            }
+        })
+            .finally(() => {
+            if (!controller.signal.aborted)
+                setLoading(false);
+        });
+        return () => controller.abort();
+    }, [open, api, sessionId, cli, attempt]);
+    const identity = modelName(worker.preference);
+    const chosen = catalog?.models.find((m) => m.id === identity || Object.values(m.variants ?? {}).includes(worker.preference.model));
+    const visible = visibleModelChoices(catalog?.models ?? [], worker.preference.model);
+    const name = visible.find((model) => model.id === chosen?.id)?.label ?? displayModelName(worker.preference);
+    const locked = disabled || saving || active(worker.status);
+    const choicesLocked = locked || loading || !catalog || !!error;
+    const close = () => {
+        if (!saving) {
+            setOpen(false);
+            setPane('root');
+            setQuery('');
+        }
+    };
+    const save = async (next) => {
+        if (choicesLocked ||
+            next.cli !== cli ||
+            !catalog?.models.some((item) => item.id === next.model && item.efforts?.includes(next.effort)))
+            return;
+        setSaving(true);
+        setError('');
+        try {
+            value(await api.cliworker.configureWorker(sessionId, worker.id, JSON.stringify(next)));
+            if (alive.current) {
+                setOpen(false);
+                setPane('root');
+                setQuery('');
+            }
+        }
+        catch (e) {
+            if (alive.current)
+                setError(operationMessage(e));
+        }
+        finally {
+            if (alive.current)
+                setSaving(false);
+        }
+    };
+    const cell = (label, text) => (_jsxs("span", { className: "cwn-model-cell", children: [_jsx("span", { children: label }), _jsx("span", { className: "cwn-model-cell-value", children: text }), _jsx(IconChevronRightOutlineRegular, { size: 12 })] }));
+    const items = pane === 'root'
+        ? [
+            { id: 'model', label: cell('模型', name), disabled: choicesLocked },
+            {
+                id: 'effort',
+                label: cell('思考强度', effortLabel(worker.preference.effort)),
+                disabled: choicesLocked || !chosen,
+            },
+        ]
+        : [
+            { id: 'back', label: '‹ 返回', disabled: saving },
+            ...(pane === 'effort'
+                ? (chosen?.efforts ?? []).map((e) => ({ id: e, label: effortLabel(e), disabled: choicesLocked }))
+                : []),
+        ];
+    return (_jsxs(Menu, { open: open, portal: true, align: "end", side: "top", className: "cwn-model-menu", listClassName: "cwn-model-popover", items: items, selectedId: pane === 'effort' ? worker.preference.effort : undefined, onClose: close, onSelect: (id) => {
+            if (id === 'back') {
+                setPane('root');
+                return;
+            }
+            if (choicesLocked)
+                return;
+            if (pane === 'root') {
+                setPane(id);
+                return;
+            }
+            if (pane === 'effort' && chosen?.efforts?.includes(id))
+                void save({ cli, model: chosen.id, effort: id });
+        }, anchor: _jsxs(Button, { type: "button", variant: "ghost", size: "sm", className: "cwn-compose-model", disabled: locked, "aria-label": "\u6A21\u578B\u4E0E\u5F3A\u5EA6", "aria-haspopup": "menu", "aria-expanded": open, onClick: () => (open ? close() : setOpen(true)), title: active(worker.status)
+                ? '本轮结束后可以修改模型与强度'
+                : `${name} · ${effortLabel(worker.preference.effort)}`, children: [_jsx("span", { children: name }), _jsx("span", { className: "cwn-model-effort", children: effortLabel(worker.preference.effort) }), _jsx(IconChevronDownOutlineRegular, { className: "cwn-model-chevron", size: 12 })] }), children: [pane === 'model' && (_jsxs(_Fragment, { children: [_jsx(Input, { className: "cwn-model-search", "aria-label": "\u641C\u7D22\u6A21\u578B", placeholder: "\u641C\u7D22\u6A21\u578B", value: query, onChange: (e) => setQuery(e.target.value) }), _jsx("div", { className: "cwn-model-provider", children: CLI_LABELS[cli] }), visible
+                        .filter((m) => `${m.id} ${m.label}`.toLowerCase().includes(query.toLowerCase()))
+                        .map((m) => (_jsx(MenuItemButton, { disabled: choicesLocked, onSelect: () => {
+                            const effort = m.efforts?.includes(worker.preference.effort)
+                                ? worker.preference.effort
+                                : m.efforts?.[0];
+                            if (effort)
+                                void save({ cli, model: m.id, effort });
+                        }, children: _jsxs("span", { className: "cwn-model-cell", children: [_jsx("span", { title: m.label, children: m.label }), m.id === chosen?.id && _jsx(IconCheckOutlineRegular, { size: 14 })] }) }, m.id)))] })), loading && (_jsxs("div", { className: "cwn-model-provider", role: "status", children: [_jsx(StateDot, { state: "ongoing", size: 14 }), " \u6B63\u5728\u8BFB\u53D6 CLI \u6A21\u578B\u2026"] })), saving && (_jsxs("div", { className: "cwn-model-provider", role: "status", children: [_jsx(StateDot, { state: "ongoing", size: 14 }), " \u6B63\u5728\u4FDD\u5B58\u6A21\u578B\u8BBE\u7F6E\u2026"] })), error && (_jsxs("div", { className: "cwn-model-feedback", role: "status", children: [error, _jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => retry((n) => n + 1), children: "\u91CD\u8BD5" })] }))] }));
+}
+//# sourceMappingURL=worker-model-menu.js.map

package/lib/types/client/worker-model-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-model-menu.js","sourceRoot":"","sources":["../../../src/client/worker-model-menu.tsx"],"names":[],"mappings":"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"}

package/lib/types/client/workers.d.ts

@@ -0,0 +1,21 @@
+import type { ClientRemote } from '@deepseek-ai/dsh-api-remotes/client';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { WorkerSnapshot } from '../shared/types.ts';
+export type Snapshot = WorkerSnapshot & {
+    configuring?: boolean;
+};
+export type API = Pick<ClientRemote, '$stream' | 'cliworker'>;
+export declare const value: <T>(result: RemoteResult<T>) => T;
+export declare function useWorkers(api: API, session: string, selected?: string): {
+    reconnect: () => void;
+    key: string;
+    session: string;
+    snapshot: Snapshot;
+    error: string;
+    connecting: boolean;
+} | {
+    reconnect: () => void;
+    snapshot: Snapshot;
+    error: string;
+    connecting: boolean;
+};

package/lib/types/client/workers.js

@@ -0,0 +1,59 @@
+import { useEffect, useState } from 'react';
+export const value = (result) => {
+    if (!result.ok)
+        throw new Error(result.error.message);
+    return result.value;
+};
+const empty = (workers = []) => ({ workers, timeline: [], revision: 0, truncated: false });
+export function useWorkers(api, session, selected = '') {
+    const key = JSON.stringify([session, selected]);
+    const [attempt, retry] = useState(0);
+    const [state, setState] = useState(() => ({ key, session, snapshot: empty(), error: '', connecting: true }));
+    useEffect(() => {
+        let alive = true;
+        setState((old) => ({
+            key,
+            session,
+            snapshot: old.key === key ? old.snapshot : empty(old.session === session ? old.snapshot.workers : []),
+            error: '',
+            connecting: true,
+        }));
+        const stream = api.$stream({
+            name: `CLI Worker ${session}`,
+            open: (signal) => api.cliworker.watch(session, selected, signal),
+            ended: () => new Error('连接已结束'),
+        });
+        void (async () => {
+            try {
+                for await (const item of stream) {
+                    const snapshot = JSON.parse(item.value);
+                    if (snapshot.selected && snapshot.selected.id !== selected)
+                        throw new Error('收到不匹配的任务记录');
+                    if (alive)
+                        setState({ key, session, snapshot, error: '', connecting: false });
+                    item.accept();
+                }
+                if (alive)
+                    throw new Error('连接已结束');
+            }
+            catch (error) {
+                if (alive)
+                    setState((old) => ({ ...old, error: String(error), connecting: false }));
+            }
+        })();
+        return () => {
+            alive = false;
+            void stream.dispose().catch(() => undefined);
+        };
+    }, [api, session, selected, key, attempt]);
+    // React effects run after paint: never show the previous worker during that gap.
+    const current = state.key === key
+        ? state
+        : {
+            snapshot: empty(state.session === session ? state.snapshot.workers : []),
+            error: '',
+            connecting: true,
+        };
+    return { ...current, reconnect: () => retry((n) => n + 1) };
+}
+//# sourceMappingURL=workers.js.map

package/lib/types/client/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","sourceRoot":"","sources":["../../../src/client/workers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAO3C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,MAAuB,EAAK,EAAE;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACrD,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC,CAAA;AACD,MAAM,KAAK,GAAG,CAAC,UAAoB,EAAE,EAAY,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;AAE9G,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,OAAe,EAAE,QAAQ,GAAG,EAAE;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC/C,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5G,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,GAAG,IAAI,CAAA;QAChB,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjB,GAAG;YACH,OAAO;YACP,QAAQ,EAAE,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrG,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC,CAAA;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAS;YACjC,IAAI,EAAE,cAAc,OAAO,EAAE;YAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;YAChE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;SAChC,CAAC,CAAA;QACF,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAChC,MAAM,QAAQ,GAAa,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBACjD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ;wBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;oBACzF,IAAI,KAAK;wBAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;oBAC7E,IAAI,CAAC,MAAM,EAAE,CAAA;gBACf,CAAC;gBACD,IAAI,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK;oBAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;YACrF,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;QACJ,OAAO,GAAG,EAAE;YACV,KAAK,GAAG,KAAK,CAAA;YACb,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC9C,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1C,iFAAiF;IACjF,MAAM,OAAO,GACX,KAAK,CAAC,GAAG,KAAK,GAAG;QACf,CAAC,CAAC,KAAK;QACP,CAAC,CAAC;YACE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,IAAI;SACjB,CAAA;IACP,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;AAC7D,CAAC"}

package/lib/types/client/zcode-login-link-provider.d.ts

@@ -0,0 +1,9 @@
+import type { ILinkProvider, Terminal } from '@xterm/xterm';
+type TerminalBuffer = Pick<Terminal, 'buffer' | 'cols'>;
+/**
+ * The caller supplies only the active ZCode login parser's approved URL and
+ * disposes its registerLinkProvider handle on close. No URL discovery, browser
+ * opening, output logging, or persistence happens while links are requested.
+ */
+export declare function createZcodeLoginLinkProvider(terminal: TerminalBuffer, currentUrl: () => string | undefined, open: (url: string) => void): ILinkProvider;
+export {};

package/lib/types/client/zcode-login-link-provider.js

@@ -0,0 +1,105 @@
+const maxUrlLength = 8_192;
+const maxCells = 16_384;
+const maxWrappedLines = 512;
+/** Resolve only a complete displayed copy of an already approved native URL. */
+function displayedUrlRange(terminal, bufferLineNumber, url) {
+    if (!url || url.length > maxUrlLength || !Number.isInteger(bufferLineNumber))
+        return undefined;
+    const buffer = terminal.buffer.active;
+    const index = bufferLineNumber - 1;
+    if (index < 0 || index >= buffer.length || terminal.cols < 1)
+        return undefined;
+    let first = index;
+    while (buffer.getLine(first)?.isWrapped) {
+        if (first === 0 || index - first >= maxWrappedLines)
+            return undefined;
+        first--;
+    }
+    let text = '';
+    let cellCount = 0;
+    const positions = [];
+    for (let row = first; row < buffer.length; row++) {
+        if (row - first >= maxWrappedLines)
+            return undefined;
+        const line = buffer.getLine(row);
+        if (!line)
+            return undefined;
+        if (row !== first && !line.isWrapped)
+            break;
+        const columns = Math.min(terminal.cols, line.length);
+        if (!Number.isInteger(columns) || columns < 0 || cellCount + columns > maxCells)
+            return undefined;
+        cellCount += columns;
+        for (let column = 0; column < columns; column++) {
+            const cell = line.getCell(column);
+            if (!cell)
+                return undefined;
+            const width = cell.getWidth();
+            if (width === 0)
+                continue;
+            if (width !== 1 && width !== 2)
+                return undefined;
+            const chars = cell.getChars() || ' ';
+            if (text.length + chars.length > maxCells)
+                return undefined;
+            const position = {
+                start: { x: column + 1, y: row + 1 },
+                end: { x: column + width, y: row + 1 },
+            };
+            for (let character = 0; character < chars.length; character++)
+                positions.push(position);
+            text += chars;
+        }
+    }
+    // Native --no-browser prints the URL on its own logical line. A known URL
+    // embedded in arbitrary output or a different URL must not become a link.
+    if (text.trim() !== url)
+        return undefined;
+    const offset = text.length - text.trimStart().length;
+    const start = positions[offset]?.start;
+    const end = positions[offset + url.length - 1]?.end;
+    if (!start || !end || bufferLineNumber < start.y || bufferLineNumber > end.y)
+        return undefined;
+    return { start, end };
+}
+/**
+ * The caller supplies only the active ZCode login parser's approved URL and
+ * disposes its registerLinkProvider handle on close. No URL discovery, browser
+ * opening, output logging, or persistence happens while links are requested.
+ */
+export function createZcodeLoginLinkProvider(terminal, currentUrl, open) {
+    return {
+        provideLinks(bufferLineNumber, callback) {
+            const url = currentUrl();
+            const range = url ? displayedUrlRange(terminal, bufferLineNumber, url) : undefined;
+            if (!url || !range) {
+                callback(undefined);
+                return;
+            }
+            let disposed = false;
+            callback([
+                {
+                    range,
+                    text: url,
+                    activate() {
+                        if (disposed || currentUrl() !== url)
+                            return;
+                        // A cached hover may outlive a resize, buffer rewrite or session close.
+                        const current = displayedUrlRange(terminal, bufferLineNumber, url);
+                        if (!current ||
+                            current.start.x !== range.start.x ||
+                            current.start.y !== range.start.y ||
+                            current.end.x !== range.end.x ||
+                            current.end.y !== range.end.y)
+                            return;
+                        open(url);
+                    },
+                    dispose() {
+                        disposed = true;
+                    },
+                },
+            ]);
+        },
+    };
+}
+//# sourceMappingURL=zcode-login-link-provider.js.map

package/lib/types/client/zcode-login-link-provider.js.map

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

package/lib/types/client/zcode-login-link.d.ts

@@ -0,0 +1,16 @@
+import type { ZCodeLoginProvider } from '../shared/accounts.ts';
+export interface ZcodeLoginLinkParser {
+    /** Returns only a newly completed native URL, never a partial line. Does not open or log it. */
+    write(chunk: string): string | undefined;
+    /** Forget pending ANSI/line state and the last URL on finish, close, retry or unmount. */
+    reset(): void;
+}
+/**
+ * The caller must enable this only for a ZCode login session and pass the selected
+ * provider so one region cannot open the other region's URL. URLs stay in memory.
+ * Accept a single complete line immediately after the fixed native --no-browser
+ * prompt. SGR/cursor visibility do not affect text. The observed ConPTY blank
+ * screen initialization is accepted only before any prompt/URL text; arbitrary
+ * cursor edits do not become trusted text. OSC payloads are never stored.
+ */
+export declare function createZcodeLoginLinkParser(provider?: ZCodeLoginProvider): ZcodeLoginLinkParser;

package/lib/types/client/zcode-login-link.js

@@ -0,0 +1,194 @@
+const nativePrompt = 'Open this URL to sign in:';
+const maxLineLength = 8_192;
+// Fixed endpoints observed from the official CLI's provider-specific device
+// flows. Preserve the server-returned URL; never construct or rewrite one.
+const nativeEndpoints = {
+    zai: {
+        prefix: /^https:\/\/chat\.z\.ai(?::443)?\/api\/oauth\/authorize\?/,
+        origin: 'https://chat.z.ai',
+        path: '/api/oauth/authorize',
+        parameters: ['client_id', 'redirect_uri', 'state', 'response_type'],
+    },
+    bigmodel: {
+        prefix: /^https:\/\/bigmodel\.cn(?::443)?\/login\?/,
+        origin: 'https://bigmodel.cn',
+        path: '/login',
+        parameters: ['appId', 'redirect', 'state'],
+    },
+};
+/** Validate only the observed native authorization endpoint; return the original bytes. */
+function nativeLoginUrl(line, provider) {
+    // Older callers retain their Z.AI-only contract. Unknown providers never
+    // broaden navigation to either region or a caller-supplied destination.
+    const selected = provider === undefined ? 'zai' : provider;
+    if (selected !== 'zai' && selected !== 'bigmodel')
+        return undefined;
+    const endpoint = nativeEndpoints[selected];
+    if (line.length > maxLineLength || !endpoint.prefix.test(line) || /[\s\p{C}<>"'\\#]/u.test(line))
+        return undefined;
+    try {
+        const url = new URL(line);
+        if (url.protocol !== 'https:' ||
+            url.origin !== endpoint.origin ||
+            url.pathname !== endpoint.path ||
+            url.username ||
+            url.password ||
+            url.hash ||
+            (url.port && url.port !== '443'))
+            return undefined;
+        for (const parameter of endpoint.parameters) {
+            const values = url.searchParams.getAll(parameter);
+            if (values.length !== 1 || !values[0]?.trim())
+                return undefined;
+        }
+        return line;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The caller must enable this only for a ZCode login session and pass the selected
+ * provider so one region cannot open the other region's URL. URLs stay in memory.
+ * Accept a single complete line immediately after the fixed native --no-browser
+ * prompt. SGR/cursor visibility do not affect text. The observed ConPTY blank
+ * screen initialization is accepted only before any prompt/URL text; arbitrary
+ * cursor edits do not become trusted text. OSC payloads are never stored.
+ */
+export function createZcodeLoginLinkParser(provider) {
+    let mode = 'text';
+    let line = '';
+    let invalidLine = false;
+    let carriageReturn = false;
+    let csiParameters = true;
+    let csiLength = 0;
+    let csiSequence = '';
+    let oscCommand = '';
+    let oscCommandComplete = false;
+    let oscInitialization = false;
+    let awaitingUrl = false;
+    let previousUrl;
+    const reset = () => {
+        mode = 'text';
+        line = '';
+        invalidLine = false;
+        carriageReturn = false;
+        csiParameters = true;
+        csiLength = 0;
+        csiSequence = '';
+        oscCommand = '';
+        oscCommandComplete = false;
+        oscInitialization = false;
+        awaitingUrl = false;
+        previousUrl = undefined;
+    };
+    const finishLine = () => {
+        const complete = invalidLine ? '' : line.trim();
+        line = '';
+        invalidLine = false;
+        carriageReturn = false;
+        if (complete === nativePrompt) {
+            awaitingUrl = true;
+            return undefined;
+        }
+        const candidate = awaitingUrl ? nativeLoginUrl(complete, provider) : undefined;
+        awaitingUrl = false;
+        if (!candidate || candidate === previousUrl)
+            return undefined;
+        previousUrl = candidate;
+        return candidate;
+    };
+    return {
+        reset,
+        write(chunk) {
+            let result;
+            for (const character of chunk) {
+                if (mode === 'osc' || mode === 'osc-escape') {
+                    if (character === '\x07' || (mode === 'osc-escape' && character === '\\')) {
+                        // Only startup OSC 0/2 title metadata is inert here. In particular,
+                        // OSC 8 hyperlink targets never supply or decorate a login link.
+                        if (!oscInitialization || !oscCommandComplete || !['0', '2'].includes(oscCommand))
+                            invalidLine = true;
+                        mode = 'text';
+                    }
+                    else {
+                        if (!oscCommandComplete) {
+                            if (character === ';')
+                                oscCommandComplete = true;
+                            else if (oscCommand.length < 2)
+                                oscCommand += character;
+                            else
+                                oscInitialization = false;
+                        }
+                        mode = character === '\x1b' ? 'osc-escape' : 'osc';
+                    }
+                    continue;
+                }
+                if (mode === 'escape') {
+                    if (character === '[') {
+                        mode = 'csi';
+                        csiParameters = true;
+                        csiLength = 0;
+                        csiSequence = '';
+                        continue;
+                    }
+                    if (character === ']') {
+                        oscInitialization = !line && !awaitingUrl && !invalidLine;
+                        oscCommand = '';
+                        oscCommandComplete = false;
+                        mode = 'osc';
+                    }
+                    else {
+                        invalidLine = true;
+                        mode = 'text';
+                    }
+                    if (character !== '\n')
+                        continue;
+                }
+                else if (mode === 'csi') {
+                    csiLength++;
+                    if (character >= '@' && character <= '~') {
+                        const sequence = csiSequence + character;
+                        const decoration = character === 'm' && csiParameters;
+                        const visibility = /^\?25[hl]$/.test(sequence);
+                        const initialization = !line && !awaitingUrl && !invalidLine && /^(?:2J|0?K|(?:1;1)?H)$/.test(sequence);
+                        if (csiLength > 64 || (!decoration && !visibility && !initialization))
+                            invalidLine = true;
+                        mode = 'text';
+                        continue;
+                    }
+                    csiParameters &&= /^[0-9;:]$/.test(character);
+                    if (csiLength <= 64)
+                        csiSequence += character;
+                    if (character !== '\n')
+                        continue;
+                    invalidLine = true;
+                    mode = 'text';
+                }
+                if (character === '\n') {
+                    const found = finishLine();
+                    if (found)
+                        result = found;
+                    continue;
+                }
+                if (carriageReturn)
+                    invalidLine = true;
+                carriageReturn = character === '\r';
+                if (carriageReturn)
+                    continue;
+                if (character === '\x1b') {
+                    mode = 'escape';
+                    continue;
+                }
+                if (/[\p{C}]/u.test(character))
+                    invalidLine = true;
+                if (line.length + character.length > maxLineLength)
+                    invalidLine = true;
+                if (!invalidLine)
+                    line += character;
+            }
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=zcode-login-link.js.map

package/lib/types/client/zcode-login-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode-login-link.js","sourceRoot":"","sources":["../../../src/client/zcode-login-link.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,2BAA2B,CAAA;AAChD,MAAM,aAAa,GAAG,KAAK,CAAA;AAC3B,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,eAAe,GAAG;IACtB,GAAG,EAAE;QACH,MAAM,EAAE,0DAA0D;QAClE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,CAAC;KACpE;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,MAAM,EAAE,qBAAqB;QAC7B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC;KAC3C;CACO,CAAA;AAEV,2FAA2F;AAC3F,SAAS,cAAc,CAAC,IAAY,EAAE,QAAwC;IAC5E,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,QAAQ,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC1D,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IAC1C,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9F,OAAO,SAAS,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAA;QACzB,IACE,GAAG,CAAC,QAAQ,KAAK,QAAQ;YACzB,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAC9B,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI;YAC9B,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,IAAI;YACR,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC;YAEhC,OAAO,SAAS,CAAA;QAClB,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;gBAAE,OAAO,SAAS,CAAA;QACjE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAA6B;IACtE,IAAI,IAAI,GAAqD,MAAM,CAAA;IACnE,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,IAAI,cAAc,GAAG,KAAK,CAAA;IAC1B,IAAI,aAAa,GAAG,IAAI,CAAA;IACxB,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,IAAI,WAAW,GAAG,EAAE,CAAA;IACpB,IAAI,UAAU,GAAG,EAAE,CAAA;IACnB,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,IAAI,iBAAiB,GAAG,KAAK,CAAA;IAC7B,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,IAAI,WAA+B,CAAA;IAEnC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,GAAG,MAAM,CAAA;QACb,IAAI,GAAG,EAAE,CAAA;QACT,WAAW,GAAG,KAAK,CAAA;QACnB,cAAc,GAAG,KAAK,CAAA;QACtB,aAAa,GAAG,IAAI,CAAA;QACpB,SAAS,GAAG,CAAC,CAAA;QACb,WAAW,GAAG,EAAE,CAAA;QAChB,UAAU,GAAG,EAAE,CAAA;QACf,kBAAkB,GAAG,KAAK,CAAA;QAC1B,iBAAiB,GAAG,KAAK,CAAA;QACzB,WAAW,GAAG,KAAK,CAAA;QACnB,WAAW,GAAG,SAAS,CAAA;IACzB,CAAC,CAAA;IACD,MAAM,UAAU,GAAG,GAAuB,EAAE;QAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC/C,IAAI,GAAG,EAAE,CAAA;QACT,WAAW,GAAG,KAAK,CAAA;QACnB,cAAc,GAAG,KAAK,CAAA;QACtB,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,WAAW,GAAG,IAAI,CAAA;YAClB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9E,WAAW,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,WAAW;YAAE,OAAO,SAAS,CAAA;QAC7D,WAAW,GAAG,SAAS,CAAA;QACvB,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IACD,OAAO;QACL,KAAK;QACL,KAAK,CAAC,KAAK;YACT,IAAI,MAA0B,CAAA;YAC9B,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;gBAC9B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC5C,IAAI,SAAS,KAAK,MAAM,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,KAAK,IAAI,CAAC,EAAE,CAAC;wBAC1E,oEAAoE;wBACpE,iEAAiE;wBACjE,IAAI,CAAC,iBAAiB,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;4BAC/E,WAAW,GAAG,IAAI,CAAA;wBACpB,IAAI,GAAG,MAAM,CAAA;oBACf,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,kBAAkB,EAAE,CAAC;4BACxB,IAAI,SAAS,KAAK,GAAG;gCAAE,kBAAkB,GAAG,IAAI,CAAA;iCAC3C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gCAAE,UAAU,IAAI,SAAS,CAAA;;gCAClD,iBAAiB,GAAG,KAAK,CAAA;wBAChC,CAAC;wBACD,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAA;oBACpD,CAAC;oBACD,SAAQ;gBACV,CAAC;gBACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;wBACtB,IAAI,GAAG,KAAK,CAAA;wBACZ,aAAa,GAAG,IAAI,CAAA;wBACpB,SAAS,GAAG,CAAC,CAAA;wBACb,WAAW,GAAG,EAAE,CAAA;wBAChB,SAAQ;oBACV,CAAC;oBACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;wBACtB,iBAAiB,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAA;wBACzD,UAAU,GAAG,EAAE,CAAA;wBACf,kBAAkB,GAAG,KAAK,CAAA;wBAC1B,IAAI,GAAG,KAAK,CAAA;oBACd,CAAC;yBAAM,CAAC;wBACN,WAAW,GAAG,IAAI,CAAA;wBAClB,IAAI,GAAG,MAAM,CAAA;oBACf,CAAC;oBACD,IAAI,SAAS,KAAK,IAAI;wBAAE,SAAQ;gBAClC,CAAC;qBAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;oBAC1B,SAAS,EAAE,CAAA;oBACX,IAAI,SAAS,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;wBACzC,MAAM,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;wBACxC,MAAM,UAAU,GAAG,SAAS,KAAK,GAAG,IAAI,aAAa,CAAA;wBACrD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;wBAC9C,MAAM,cAAc,GAClB,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,IAAI,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;wBAClF,IAAI,SAAS,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC;4BAAE,WAAW,GAAG,IAAI,CAAA;wBACzF,IAAI,GAAG,MAAM,CAAA;wBACb,SAAQ;oBACV,CAAC;oBACD,aAAa,KAAK,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;oBAC7C,IAAI,SAAS,IAAI,EAAE;wBAAE,WAAW,IAAI,SAAS,CAAA;oBAC7C,IAAI,SAAS,KAAK,IAAI;wBAAE,SAAQ;oBAChC,WAAW,GAAG,IAAI,CAAA;oBAClB,IAAI,GAAG,MAAM,CAAA;gBACf,CAAC;gBACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;oBAC1B,IAAI,KAAK;wBAAE,MAAM,GAAG,KAAK,CAAA;oBACzB,SAAQ;gBACV,CAAC;gBACD,IAAI,cAAc;oBAAE,WAAW,GAAG,IAAI,CAAA;gBACtC,cAAc,GAAG,SAAS,KAAK,IAAI,CAAA;gBACnC,IAAI,cAAc;oBAAE,SAAQ;gBAC5B,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;oBACzB,IAAI,GAAG,QAAQ,CAAA;oBACf,SAAQ;gBACV,CAAC;gBACD,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;oBAAE,WAAW,GAAG,IAAI,CAAA;gBAClD,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,aAAa;oBAAE,WAAW,GAAG,IAAI,CAAA;gBACtE,IAAI,CAAC,WAAW;oBAAE,IAAI,IAAI,SAAS,CAAA;YACrC,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/types/host/account-identity.d.ts

@@ -0,0 +1,16 @@
+import type { CliId } from '../shared/types.ts';
+import type { AccountStatus } from '../shared/accounts.ts';
+export type AccountIdentity = Pick<AccountStatus, 'state' | 'summary' | 'authMethod' | 'accountLabel' | 'verification' | 'logins'>;
+export type AccountIdentitySource = (cli: CliId, signal: AbortSignal) => Promise<AccountIdentity | undefined>;
+/** Only email is allowlisted. Reject controls/markup/credential-shaped strings outright. */
+export declare function accountEmail(value: unknown): string | undefined;
+/** Local expiry is negative evidence only; an unsigned claim never proves login. */
+export declare function localTokenExpired(value: unknown, now?: number): boolean;
+/**
+ * This format/path is verified from the installed AGY CLI. Reading is
+ * bounded and ephemeral. No credential leaves this function; ID tokens are decoded
+ * only for a display email, never treated as a remotely verified assertion.
+ */
+export declare function localAccountIdentity(options?: {
+    home?: string;
+}): AccountIdentitySource;