@yu_robotics/remote-cli 1.6.158 → 1.6.166

package/dist/session/SessionCatalog.js.map

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

package/dist/session/SessionControl.d.ts

@@ -0,0 +1,56 @@
+import type { IExecutor } from '../executor/IExecutor';
+import type { BackendKey } from '../types/config';
+import type { SessionCatalog } from './SessionCatalog';
+import type { PiSessionLocator } from './adapters/PiSessionCatalog';
+import { SessionMenuStore } from './SessionMenu';
+export interface SessionControlResponse {
+    success: boolean;
+    output?: string;
+    error?: string;
+}
+/** Local binding state recorded in the thread's Pi pointer. */
+export interface PiBindingState {
+    id?: string;
+    adopted: boolean;
+}
+/** Everything the service needs from the daemon; injected for isolated tests. */
+export interface SessionControlDeps {
+    sharingConfig(): unknown;
+    backendOf(threadId: string): BackendKey;
+    /** Canonical, allowed thread workspace, or undefined when unavailable. */
+    workingDirectory(threadId: string): string | undefined;
+    threadName(threadId: string): string | undefined;
+    isBusy(threadId: string): boolean;
+    setBusy(threadId: string, busy: boolean): void;
+    executor(threadId: string): IExecutor;
+    readCatalog(backend: BackendKey, workingDirectory: string): SessionCatalog | undefined;
+    resolvePi(workingDirectory: string, id: string): PiSessionLocator | undefined;
+    piHolder(file: string, threadId: string): string | undefined;
+    piBinding(threadId: string): PiBindingState | undefined;
+}
+export interface SessionControlContext {
+    openId?: string;
+    threadId: string;
+}
+/**
+ * Owns `/resume` and `/session`. Listing and paging are read-only; only a
+ * confirmed, scope-bound, single-use token reaches executor adoption, and only
+ * for backends whose strict native resume is implemented.
+ */
+export declare class SessionControl {
+    private readonly deps;
+    private readonly menus;
+    /** In-flight native files, including quarantined outcomes, shared across this daemon's threads. */
+    private readonly sessionReservations;
+    constructor(deps: SessionControlDeps, menus?: SessionMenuStore);
+    handle(content: string, context: SessionControlContext): Promise<SessionControlResponse>;
+    private render;
+    private handleMenu;
+    /** Validate a selection and issue a mutation-free confirmation. */
+    private prepare;
+    private checkTarget;
+    /** Execute a confirmed adoption after revalidating everything the confirmation captured. */
+    private adopt;
+    private handleBinding;
+}
+//# sourceMappingURL=SessionControl.d.ts.map

package/dist/session/SessionControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionControl.d.ts","sourceRoot":"","sources":["../../src/session/SessionControl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAUpE,OAAO,EAEL,gBAAgB,EAOjB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,aAAa,IAAI,OAAO,CAAC;IACzB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IACxC,0EAA0E;IAC1E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACvF,SAAS,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD;;;;GAIG;AACH,qBAAa,cAAc;IAKb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;gBAEpC,IAAI,EAAE,kBAAkB,EAAE,KAAK,mBAAyB;IAI/E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA2B9F,OAAO,CAAC,MAAM;YAOA,UAAU;IAyCxB,mEAAmE;IACnE,OAAO,CAAC,OAAO;IAiCf,OAAO,CAAC,WAAW;IAkBnB,4FAA4F;YAC9E,KAAK;YAwCL,aAAa;CAyD5B"}

package/dist/session/SessionControl.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionControl = void 0;
+const SessionResumeService_1 = require("./SessionResumeService");
+const SessionMenu_1 = require("./SessionMenu");
+const NOTHING_SENT = 'No task was sent.';
+function describe(candidate) {
+    const title = candidate.name ?? `Session ${candidate.id.slice(0, 8)}`;
+    const updated = new Date(candidate.modifiedAt).toISOString().slice(0, 16).replace('T', ' ');
+    const count = candidate.countComplete ? `${candidate.messageCount} messages` : 'messages unavailable';
+    return `${title} \u00b7 \`${candidate.id}\` \u00b7 ${count} \u00b7 updated ${updated} UTC`;
+}
+/**
+ * Owns `/resume` and `/session`. Listing and paging are read-only; only a
+ * confirmed, scope-bound, single-use token reaches executor adoption, and only
+ * for backends whose strict native resume is implemented.
+ */
+class SessionControl {
+    deps;
+    menus;
+    /** In-flight native files, including quarantined outcomes, shared across this daemon's threads. */
+    sessionReservations = new Map();
+    constructor(deps, menus = new SessionMenu_1.SessionMenuStore()) {
+        this.deps = deps;
+        this.menus = menus;
+    }
+    async handle(content, context) {
+        const { threadId } = context;
+        const backend = this.deps.backendOf(threadId);
+        const cwd = this.deps.workingDirectory(threadId);
+        const scope = { openId: context.openId, threadId, workingDirectory: cwd ?? '' };
+        const binding = (0, SessionMenu_1.parseSessionBindingCommand)(content);
+        if (binding) {
+            if (binding.kind === 'invalid')
+                return { success: false, error: binding.error };
+            return this.handleBinding(binding.kind, 'token' in binding ? binding.token : undefined, backend, scope, content);
+        }
+        const menu = (0, SessionMenu_1.parseSessionMenuCommand)(content);
+        if (menu)
+            return this.handleMenu(menu, backend, cwd, scope);
+        const result = (0, SessionResumeService_1.sessionResumeGate)(content, backend, this.deps.sharingConfig());
+        const target = (0, SessionResumeService_1.catalogTarget)(content, backend);
+        if (result.code !== 'native_capability_unavailable' || !target || !SessionResumeService_1.CATALOG_BACKENDS.includes(target)) {
+            return { success: false, error: result.error };
+        }
+        const catalog = cwd ? this.deps.readCatalog(target, cwd) : undefined;
+        if (!cwd || !catalog) {
+            return { success: false, error: 'The thread working directory is not allowed or not set. No session was loaded or task sent.' };
+        }
+        return { success: true, output: this.render(this.menus.create(target, scope, catalog), 1, backend) };
+    }
+    render(snapshot, page, threadBackend) {
+        return (0, SessionResumeService_1.formatCatalog)(snapshot.catalog, snapshot.backend, {
+            token: snapshot.token, page, pageSize: SessionMenu_1.SESSION_MENU_PAGE_SIZE, query: snapshot.query,
+            connectable: SessionResumeService_1.NATIVE_RESUME_BACKENDS.includes(snapshot.backend) && snapshot.backend === threadBackend,
+        });
+    }
+    async handleMenu(command, backend, cwd, scope) {
+        if (command.kind === 'invalid')
+            return { success: false, error: command.error };
+        const expired = 'This session menu has expired or belongs to another thread, workspace or user. Send /resume to list sessions again.';
+        if (command.kind === 'confirm' || command.kind === 'cancel') {
+            const pending = this.menus.take(command.token, scope, 'resume');
+            if (!pending)
+                return { success: false, error: 'This confirmation has expired, was already used, or belongs to another thread, workspace or user. Nothing was changed.' };
+            if (command.kind === 'cancel')
+                return { success: true, output: 'Cancelled. Nothing was changed.' };
+            return this.adopt(pending.sessionId, pending.revision, backend, cwd, scope, pending.replaces);
+        }
+        if (command.kind === 'id') {
+            const denied = (0, SessionResumeService_1.sessionSharingDenied)(backend, this.deps.sharingConfig());
+            if (denied)
+                return { success: false, error: denied.error };
+            if (!SessionResumeService_1.NATIVE_RESUME_BACKENDS.includes(backend) || !cwd)
+                return this.prepare(backend, backend, undefined, cwd, scope);
+            const catalog = this.deps.readCatalog(backend, cwd);
+            const candidate = catalog?.candidates.find(item => item.id === command.id);
+            if (!candidate)
+                return { success: false, error: `No ${(0, SessionResumeService_1.sessionBackendLabel)(backend)} session with that ID was found for this workspace. Send /resume to list sessions.` };
+            return this.prepare(backend, backend, candidate, cwd, scope);
+        }
+        const source = this.menus.get(command.token, scope);
+        if (!source)
+            return { success: false, error: expired };
+        const denied = (0, SessionResumeService_1.sessionSharingDenied)(source.backend, this.deps.sharingConfig());
+        if (denied)
+            return { success: false, error: denied.error };
+        if (command.kind === 'select') {
+            const candidate = source.catalog.candidates[command.row - 1];
+            if (!candidate)
+                return { success: false, error: `Row ${command.row} is not in this session menu.` };
+            return this.prepare(source.backend, backend, candidate, cwd, scope);
+        }
+        const snapshot = command.kind === 'search' ? this.menus.search(command.token, scope, command.text) : source;
+        const pages = (0, SessionMenu_1.sessionMenuPageCount)(snapshot);
+        if (command.kind === 'page' && command.page > pages) {
+            return { success: false, error: `This session menu has ${pages} page${pages === 1 ? '' : 's'}.` };
+        }
+        return { success: true, output: this.render(snapshot, command.kind === 'page' ? command.page : 1, backend) };
+    }
+    /** Validate a selection and issue a mutation-free confirmation. */
+    prepare(target, threadBackend, candidate, cwd, scope) {
+        if (!SessionResumeService_1.NATIVE_RESUME_BACKENDS.includes(target)) {
+            return { success: false, error: `${(0, SessionResumeService_1.sessionBackendLabel)(target)} native resume is not available in this release. Only Pi sessions can be connected so far. No session was loaded or task sent.` };
+        }
+        if (threadBackend !== target) {
+            return { success: false, error: `This thread uses ${(0, SessionResumeService_1.sessionBackendLabel)(threadBackend)}. Switch this thread to ${(0, SessionResumeService_1.sessionBackendLabel)(target)} with \`/backend <index> @\` first, then send /resume again. Nothing was changed.` };
+        }
+        if (!cwd || !candidate)
+            return { success: false, error: 'The thread working directory is not allowed or not set. Nothing was changed.' };
+        const checked = this.checkTarget(candidate.id, scope.threadId, cwd);
+        if ('error' in checked)
+            return { success: false, error: checked.error };
+        const replaces = this.deps.piBinding(scope.threadId);
+        const replaced = replaces?.adopted && replaces.id && replaces.id !== candidate.id ? replaces.id : undefined;
+        const pending = this.menus.confirm({ action: 'resume', backend: target, scope, sessionId: candidate.id, revision: checked.locator.revision, replaces: replaced });
+        return {
+            success: true,
+            output: [
+                `Connect this thread to the ${(0, SessionResumeService_1.sessionBackendLabel)(target)} session below?`,
+                '',
+                describe(candidate),
+                '',
+                ...(replaced ? [`- This replaces this thread's current connection to session \`${replaced}\`; that session's history is kept.`, ''] : []),
+                '- Its existing history is kept. Later /clear or /thread delete in this thread will not delete it.',
+                '- Connecting sends no task. Your next message continues this session.',
+                '- Local Pi may stay open, but keep it idle while this thread runs. Resume the same file locally before switching back; concurrent writes can create separate branches.',
+                '- This thread\'s model or effort override, if set, applies to new turns.',
+                '',
+                `Confirm: \`/resume confirm ${pending.token}\``,
+                `Cancel: \`/resume cancel ${pending.token}\` (expires in 5 minutes)`,
+            ].join('\n'),
+        };
+    }
+    checkTarget(id, threadId, cwd) {
+        const locator = this.deps.resolvePi(cwd, id);
+        if (!locator)
+            return { error: 'This session is no longer listed for this workspace. Send /resume to list sessions again. Nothing was changed.' };
+        if (this.sessionReservations.has(locator.file)) {
+            return { error: 'This Pi session is being connected or requires process cleanup. Retry after the operation finishes; uncertain cleanup requires restarting the client after Pi exits.' };
+        }
+        const holder = this.deps.piHolder(locator.file, threadId);
+        if (holder) {
+            const name = this.deps.threadName(holder);
+            return { error: `This session is already used by ${name ? `thread "${name}"` : 'another remote-cli thread'}. Detach it there first. Nothing was changed.` };
+        }
+        const current = this.deps.piBinding(threadId);
+        if (current?.adopted && current.id === id) {
+            return { error: 'This thread is already connected to that session. Send your next instruction to continue it.' };
+        }
+        return { locator };
+    }
+    /** Execute a confirmed adoption after revalidating everything the confirmation captured. */
+    async adopt(sessionId, revision, backend, cwd, scope, replaces) {
+        const denied = (0, SessionResumeService_1.sessionSharingDenied)(backend, this.deps.sharingConfig());
+        if (denied)
+            return { success: false, error: denied.error };
+        if (!SessionResumeService_1.NATIVE_RESUME_BACKENDS.includes(backend) || !cwd) {
+            return { success: false, error: 'This thread can no longer connect that session (its backend or workspace changed). Nothing was changed.' };
+        }
+        if (this.deps.isBusy(scope.threadId)) {
+            return { success: false, error: 'This thread is running a task. Wait for it to finish (or send /abort), then select the session again. Nothing was changed.' };
+        }
+        const checked = this.checkTarget(sessionId, scope.threadId, cwd);
+        if ('error' in checked)
+            return { success: false, error: checked.error };
+        if (checked.locator.revision !== revision) {
+            return { success: false, error: 'The session changed after you selected it (for example a local Pi wrote to it). Wait for local work to finish, send /resume and select it again. Nothing was changed.' };
+        }
+        const executor = this.deps.executor(scope.threadId);
+        if (!executor.adoptNativeSession)
+            return { success: false, error: 'This backend cannot connect native sessions. Nothing was changed.' };
+        // Reserve before the first asynchronous native operation, not after pointer publication.
+        this.sessionReservations.set(checked.locator.file, scope.threadId);
+        let releaseReservation = false;
+        try {
+            this.deps.setBusy(scope.threadId, true);
+            const result = await executor.adoptNativeSession({ sessionId, sessionFile: checked.locator.file });
+            releaseReservation = result.success || !result.recoveryRequired;
+            if (!result.success)
+                return { success: false, error: result.error };
+        }
+        finally {
+            if (releaseReservation)
+                this.sessionReservations.delete(checked.locator.file);
+            this.deps.setBusy(scope.threadId, false);
+        }
+        return {
+            success: true,
+            output: [
+                `\u2705 Connected to Pi session \`${sessionId}\`. ${NOTHING_SENT}`,
+                ...(replaces ? [`The previous connection to \`${replaces}\` was replaced; its history is kept.`] : []),
+                'Send your next instruction to continue it.',
+                'Remote turns reload this session automatically. Before local work, wait for this thread to finish and resume the same file locally.',
+            ].join('\n'),
+        };
+    }
+    async handleBinding(kind, token, backend, scope, content) {
+        // An existing binding stays inspectable and detachable even if sharing was disabled later.
+        const state = backend === 'pi' ? this.deps.piBinding(scope.threadId) : undefined;
+        if (!state?.adopted) {
+            const denied = (0, SessionResumeService_1.sessionSharingDenied)(backend, this.deps.sharingConfig());
+            if (kind === 'status' || denied)
+                return { success: false, error: (denied ?? (0, SessionResumeService_1.sessionResumeGate)(content, backend, this.deps.sharingConfig())).error };
+            if (kind === 'confirm' || kind === 'cancel')
+                this.menus.take(token, scope, 'detach');
+            return { success: false, error: 'This thread is not connected to a native session. Send /resume to list sessions.' };
+        }
+        const id = state.id ?? 'unknown';
+        if (kind === 'status') {
+            return { success: true, output: [
+                    `This thread is connected to Pi session \`${id}\` (reloads before every remote turn).`,
+                    'Local Pi may stay open. Use only one side at a time; resume the same file locally before the next local turn.',
+                    'Send /session detach to start a fresh conversation here without deleting native history.',
+                    'On this computer, run \`remote-cli session show --thread <thread-name> --backend pi\` for local reopen guidance.',
+                ].join('\n') };
+        }
+        if (kind === 'detach') {
+            const pending = this.menus.confirm({ action: 'detach', backend, scope, sessionId: id });
+            return {
+                success: true,
+                output: [
+                    `Stop using Pi session \`${id}\` in this thread?`,
+                    'Its history stays on the computer and is not deleted. The next message here starts a fresh conversation.',
+                    '',
+                    `Confirm: \`/session confirm ${pending.token}\``,
+                    `Cancel: \`/session cancel ${pending.token}\` (expires in 5 minutes)`,
+                ].join('\n'),
+            };
+        }
+        if (kind === 'confirm' || kind === 'cancel') {
+            const pending = this.menus.take(token, scope, 'detach');
+            if (!pending || pending.sessionId !== id) {
+                return { success: false, error: 'This confirmation has expired, was already used, or no longer matches this thread. Nothing was changed.' };
+            }
+            if (kind === 'cancel')
+                return { success: true, output: 'Cancelled. Nothing was changed.' };
+        }
+        if (this.deps.isBusy(scope.threadId)) {
+            return { success: false, error: 'This thread is running a task. Wait for it to finish (or send /abort) first. Nothing was changed.' };
+        }
+        const executor = this.deps.executor(scope.threadId);
+        const operation = executor.detachNativeSession;
+        if (!operation)
+            return { success: false, error: 'This backend cannot detach native sessions. Nothing was changed.' };
+        this.deps.setBusy(scope.threadId, true);
+        try {
+            const result = await operation.call(executor);
+            if (!result.success)
+                return { success: false, error: result.error };
+        }
+        finally {
+            this.deps.setBusy(scope.threadId, false);
+        }
+        return {
+            success: true,
+            output: `Detached Pi session \`${id}\`. Its history is kept on the computer; the next message here starts a fresh conversation.`,
+        };
+    }
+}
+exports.SessionControl = SessionControl;
+//# sourceMappingURL=SessionControl.js.map

package/dist/session/SessionControl.js.map

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

package/dist/session/SessionLocalInfo.d.ts

@@ -0,0 +1,48 @@
+import type { BackendKey } from '../types/config';
+/**
+ * Local-only session inspection. This module never starts a backend, never reads
+ * transcript content, and never writes anything: it reads the local pointer files
+ * remote-cli itself wrote, so a user can reopen the same native session in a
+ * terminal. Native locators deliberately stay on this machine; nothing here is
+ * meant to be rendered in Feishu.
+ */
+/** Pointer namespaces written by each executor, keyed by stable backend key. */
+export declare const SESSION_POINTER_NAMESPACES: Record<BackendKey, string>;
+export interface LocalSessionInfoOptions {
+    /** Remote thread identity, from `threads.json`. */
+    threadId: string;
+    threadName: string;
+    workingDirectory: string;
+    backend: BackendKey;
+    /** Account home; defaults to the current user's. */
+    home?: string;
+    /** Optional remote-cli state root override (defaults to `<home>/.remote-cli`). */
+    remoteCliDirectory?: string;
+}
+export interface LocalSessionInfo {
+    backend: BackendKey;
+    threadName: string;
+    workingDirectory: string;
+    /** Where the pointer record lives, relative to the remote-cli state root. */
+    pointerLabel: string;
+    record: 'missing' | 'unreadable' | 'present';
+    /** Exact native identity, local-only. */
+    nativeId?: string;
+    sessionFile?: string;
+    savedAt?: string;
+    /** Exact reopen guidance, only when the installed release's flags are verified. */
+    reopen?: {
+        command: string;
+        verified: string;
+    };
+    notes: string[];
+}
+/**
+ * Read one thread/backend pointer. Returns `missing` when no native session was
+ * ever recorded, so callers never suggest a selector that would create an empty
+ * conversation. Never executes a backend.
+ */
+export declare function readLocalSessionInfo(options: LocalSessionInfoOptions): LocalSessionInfo;
+/** Local-only rendering. Never send this text to a chat service. */
+export declare function formatLocalSessionInfo(info: LocalSessionInfo): string;
+//# sourceMappingURL=SessionLocalInfo.d.ts.map

package/dist/session/SessionLocalInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLocalInfo.d.ts","sourceRoot":"","sources":["../../src/session/SessionLocalInfo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AAEH,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CASjE,CAAC;AAiBF,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7C,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA0BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CA+CvF;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAkBrE"}

package/dist/session/SessionLocalInfo.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_POINTER_NAMESPACES = void 0;
+exports.readLocalSessionInfo = readLocalSessionInfo;
+exports.formatLocalSessionInfo = formatLocalSessionInfo;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Local-only session inspection. This module never starts a backend, never reads
+ * transcript content, and never writes anything: it reads the local pointer files
+ * remote-cli itself wrote, so a user can reopen the same native session in a
+ * terminal. Native locators deliberately stay on this machine; nothing here is
+ * meant to be rendered in Feishu.
+ */
+/** Pointer namespaces written by each executor, keyed by stable backend key. */
+exports.SESSION_POINTER_NAMESPACES = {
+    claude: 'claude-sessions',
+    codex: 'codex-sessions',
+    agy: 'agy-sessions',
+    opencode: 'opencode-sessions',
+    kimi: 'kimi-sessions',
+    zcode: 'zcode-sessions',
+    pi: 'pi-sessions',
+    dsh: 'dsh-sessions',
+};
+const REOPEN_RULES = {
+    claude: { command: id => `claude --resume ${id}`, verified: 'verified against the installed Claude Code --help' },
+    codex: { command: id => `codex resume ${id}`, verified: 'verified against the installed Codex CLI resume help' },
+    opencode: { command: id => `opencode --session ${id}`, verified: 'verified against the installed OpenCode --session flag' },
+    pi: { command: (id, sessionFile) => `pi --session '${(sessionFile ?? id).replace(/'/g, "'\\''")}'`, verified: 'verified against the installed Pi --session flag' },
+};
+function pointerFile(directory, threadId) {
+    return path_1.default.join(directory, `${threadId}.json`);
+}
+/** Bounded, symlink-free read of one pointer record. */
+function readPointer(file) {
+    let fd;
+    try {
+        const before = fs_1.default.lstatSync(file);
+        if (!before.isFile() || before.isSymbolicLink() || before.nlink !== 1 || before.size === 0 || before.size > 64 * 1024) {
+            return { record: 'unreadable' };
+        }
+        fd = fs_1.default.openSync(file, fs_1.default.constants.O_RDONLY | (fs_1.default.constants.O_NOFOLLOW ?? 0));
+        const stat = fs_1.default.fstatSync(fd);
+        if (stat.ino !== before.ino || stat.dev !== before.dev)
+            return { record: 'unreadable' };
+        const value = JSON.parse(fs_1.default.readFileSync(fd, 'utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return { record: 'invalid' };
+        return { record: 'ok', value: value };
+    }
+    catch (error) {
+        return { record: error.code === 'ENOENT' ? 'invalid' : 'unreadable' };
+    }
+    finally {
+        if (fd !== undefined)
+            fs_1.default.closeSync(fd);
+    }
+}
+/**
+ * Read one thread/backend pointer. Returns `missing` when no native session was
+ * ever recorded, so callers never suggest a selector that would create an empty
+ * conversation. Never executes a backend.
+ */
+function readLocalSessionInfo(options) {
+    const home = options.home ?? os_1.default.homedir();
+    const root = options.remoteCliDirectory ?? path_1.default.join(home, '.remote-cli');
+    const namespace = exports.SESSION_POINTER_NAMESPACES[options.backend];
+    const directory = path_1.default.join(root, namespace);
+    const file = pointerFile(directory, options.threadId);
+    const info = {
+        backend: options.backend,
+        threadName: options.threadName,
+        workingDirectory: options.workingDirectory,
+        pointerLabel: `${namespace}/${options.threadId}.json`,
+        record: 'missing',
+        notes: [],
+    };
+    const exists = fs_1.default.existsSync(file);
+    const read = readPointer(file);
+    if (!exists) {
+        info.notes.push('No persisted session pointer exists for this thread. Do not run a native picker expecting history; no empty session was created.');
+        return info;
+    }
+    if (read.record !== 'ok') {
+        info.record = 'unreadable';
+        info.notes.push('The local session pointer exists but could not be read safely; inspect it on this computer before reopening anything.');
+        return info;
+    }
+    const id = read.value.id;
+    const sessionFile = read.value.sessionFile;
+    const cwd = read.value.cwd;
+    if (typeof id !== 'string' || !id) {
+        info.record = 'unreadable';
+        info.notes.push('The local session pointer has no usable native session identity.');
+        return info;
+    }
+    info.record = 'present';
+    info.nativeId = id;
+    if (typeof sessionFile === 'string' && sessionFile)
+        info.sessionFile = sessionFile;
+    if (typeof read.value.savedAt === 'string')
+        info.savedAt = read.value.savedAt;
+    if (typeof cwd === 'string' && cwd && cwd !== options.workingDirectory) {
+        info.notes.push('The pointer records a different working directory than the thread; reopen it in the recorded project, not in the current one.');
+    }
+    const rule = REOPEN_RULES[options.backend];
+    if (rule) {
+        info.reopen = { command: rule.command(id, info.sessionFile), verified: rule.verified };
+    }
+    else {
+        info.notes.push(`Reopen guidance for ${options.backend} is not verified on this release, so no command is suggested.`);
+    }
+    return info;
+}
+/** Local-only rendering. Never send this text to a chat service. */
+function formatLocalSessionInfo(info) {
+    const lines = [
+        `Thread: ${info.threadName} (${info.backend})`,
+        `Workspace: ${info.workingDirectory}`,
+        `Local pointer: ${info.pointerLabel} (${info.record})`,
+    ];
+    if (info.nativeId)
+        lines.push(`Native session: ${info.nativeId}`);
+    if (info.sessionFile)
+        lines.push(`Session file: ${info.sessionFile}`);
+    if (info.savedAt)
+        lines.push(`Recorded at: ${info.savedAt}`);
+    if (info.reopen) {
+        lines.push('', 'Reopen on this computer (no model task is started by remote-cli):', `  ${info.reopen.command}`);
+        lines.push(`  (${info.reopen.verified})`);
+    }
+    else if (info.record === 'present') {
+        lines.push('', 'No reopen command is suggested for this backend on this release.');
+    }
+    if (info.notes.length)
+        lines.push('', ...info.notes.map(note => `Note: ${note}`));
+    lines.push('', 'remote-cli does not verify that the native release preserves history on reopen, and it does not hold an ownership lease over a plain terminal process. Close the remote runtime before working locally, then reacquire explicitly.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=SessionLocalInfo.js.map

package/dist/session/SessionLocalInfo.js.map

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