@yu_robotics/remote-cli 1.6.156 → 1.6.165

package/dist/session/SessionMenu.d.ts

@@ -0,0 +1,102 @@
+import type { BackendKey } from '../types/config';
+import { type SessionCatalog } from './SessionCatalog';
+/** Initial UI limits from the session handoff specification. */
+export declare const SESSION_MENU_PAGE_SIZE = 8;
+export declare const SESSION_MENU_TTL_MS: number;
+/** Bounded number of live snapshots kept in memory per CLI process. */
+export declare const SESSION_MENU_LIMIT = 64;
+/** Who may use a snapshot: the original requester, thread and workspace. */
+export interface SessionMenuScope {
+    openId?: string;
+    threadId: string;
+    workingDirectory: string;
+}
+export interface SessionMenuSnapshot {
+    token: string;
+    backend: BackendKey;
+    scope: SessionMenuScope;
+    catalog: SessionCatalog;
+    /** Sanitized search text that produced this snapshot, if any. */
+    query?: string;
+    createdAt: number;
+}
+export type SessionMenuCommand = {
+    kind: 'page';
+    token: string;
+    page: number;
+} | {
+    kind: 'search';
+    token: string;
+    text: string;
+} | {
+    kind: 'select';
+    token: string;
+    row: number;
+} | {
+    kind: 'id';
+    id: string;
+} | {
+    kind: 'confirm' | 'cancel';
+    token: string;
+} | {
+    kind: 'invalid';
+    error: string;
+};
+/** `/session` subcommands; a bare `/session` is the status view. */
+export type SessionBindingCommand = {
+    kind: 'status';
+} | {
+    kind: 'detach';
+} | {
+    kind: 'confirm' | 'cancel';
+    token: string;
+} | {
+    kind: 'invalid';
+    error: string;
+};
+/** A pending, single-use confirmation. Locators stay local to the CLI. */
+export interface SessionConfirmation {
+    token: string;
+    action: 'resume' | 'detach';
+    backend: BackendKey;
+    scope: SessionMenuScope;
+    sessionId: string;
+    /** Adapter revision captured at selection; a later change requires reselection. */
+    revision?: string;
+    /** Session this confirmation replaces on the same thread, when it had one. */
+    replaces?: string;
+    createdAt: number;
+}
+/**
+ * Parse snapshot-bound chooser commands. Returns undefined for anything that is
+ * not a menu command so the regular session gate keeps handling it.
+ */
+export declare function parseSessionMenuCommand(content: string): SessionMenuCommand | undefined;
+/** Parse `/session [detach|confirm <token>|cancel <token>]`. */
+export declare function parseSessionBindingCommand(content: string): SessionBindingCommand | undefined;
+/**
+ * In-memory, read-only chooser snapshots. Tokens are unguessable, expire after
+ * five minutes, and only resolve for the original requester, thread and
+ * workspace, so an old list never redirects to another context. Snapshots never
+ * authorize a native action; they only fix the rows a user is paging through.
+ */
+export declare class SessionMenuStore {
+    private readonly now;
+    private readonly snapshots;
+    private readonly confirmations;
+    constructor(now?: () => number);
+    create(backend: BackendKey, scope: SessionMenuScope, catalog: SessionCatalog, query?: string): SessionMenuSnapshot;
+    /** Resolve a token for the same scope; any mismatch is indistinguishable from expiry. */
+    get(token: string, scope: SessionMenuScope): SessionMenuSnapshot | undefined;
+    /** Search returns a new snapshot; the original rows and token stay unchanged. */
+    search(token: string, scope: SessionMenuScope, text: string): SessionMenuSnapshot | undefined;
+    get size(): number;
+    /** Issue a confirmation; any earlier pending confirmation for the same thread is superseded. */
+    confirm(pending: Omit<SessionConfirmation, 'token' | 'createdAt'>): SessionConfirmation;
+    /** Single use: a matching confirmation is removed whether it is confirmed or cancelled. */
+    take(token: string, scope: SessionMenuScope, action: SessionConfirmation['action']): SessionConfirmation | undefined;
+    get pendingConfirmations(): number;
+    private evict;
+}
+export declare function sessionMenuPageCount(snapshot: SessionMenuSnapshot): number;
+//# sourceMappingURL=SessionMenu.d.ts.map

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

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

package/dist/session/SessionMenu.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMenuStore = exports.SESSION_MENU_LIMIT = exports.SESSION_MENU_TTL_MS = exports.SESSION_MENU_PAGE_SIZE = void 0;
+exports.parseSessionMenuCommand = parseSessionMenuCommand;
+exports.parseSessionBindingCommand = parseSessionBindingCommand;
+exports.sessionMenuPageCount = sessionMenuPageCount;
+const crypto_1 = require("crypto");
+const SessionCatalog_1 = require("./SessionCatalog");
+/** Initial UI limits from the session handoff specification. */
+exports.SESSION_MENU_PAGE_SIZE = 8;
+exports.SESSION_MENU_TTL_MS = 5 * 60 * 1000;
+/** Bounded number of live snapshots kept in memory per CLI process. */
+exports.SESSION_MENU_LIMIT = 64;
+const TOKEN = /^[A-Za-z0-9_-]{12}$/;
+const NATIVE_ID = /^[A-Za-z0-9._:-]{1,128}$/;
+/**
+ * Parse snapshot-bound chooser commands. Returns undefined for anything that is
+ * not a menu command so the regular session gate keeps handling it.
+ */
+function parseSessionMenuCommand(content) {
+    const parts = content.trim().split(/\s+/);
+    if (!/^\/(?:resume|r)$/i.test(parts[0]) || !['page', 'search', 'select', 'id', 'confirm', 'cancel'].includes(parts[1]))
+        return undefined;
+    if (parts[1] === 'id') {
+        if (parts.length !== 3 || !NATIVE_ID.test(parts[2]))
+            return { kind: 'invalid', error: 'Expected /resume id <native-session-id>.' };
+        return { kind: 'id', id: parts[2] };
+    }
+    const token = parts[2];
+    if (!token || !TOKEN.test(token))
+        return { kind: 'invalid', error: 'Expected a menu token from a /resume list.' };
+    if (parts[1] === 'confirm' || parts[1] === 'cancel') {
+        if (parts.length !== 3)
+            return { kind: 'invalid', error: `Expected /resume ${parts[1]} <token>.` };
+        return { kind: parts[1], token };
+    }
+    if (parts[1] === 'select') {
+        if (parts.length !== 4 || !/^[1-9]\d{0,3}$/.test(parts[3]))
+            return { kind: 'invalid', error: 'Expected /resume select <menu-token> <row-number>.' };
+        return { kind: 'select', token, row: Number(parts[3]) };
+    }
+    if (parts[1] === 'page') {
+        if (parts.length !== 4 || !/^[1-9]\d{0,3}$/.test(parts[3]))
+            return { kind: 'invalid', error: 'Expected /resume page <menu-token> <page-number>.' };
+        return { kind: 'page', token, page: Number(parts[3]) };
+    }
+    const text = (0, SessionCatalog_1.safeSessionLabel)(parts.slice(3).join(' '));
+    if (!text)
+        return { kind: 'invalid', error: 'Expected /resume search <menu-token> <text>.' };
+    return { kind: 'search', token, text };
+}
+/** Parse `/session [detach|confirm <token>|cancel <token>]`. */
+function parseSessionBindingCommand(content) {
+    const parts = content.trim().split(/\s+/);
+    if (!/^\/session$/i.test(parts[0]))
+        return undefined;
+    if (parts.length === 1)
+        return { kind: 'status' };
+    if (parts[1] === 'detach' && parts.length === 2)
+        return { kind: 'detach' };
+    if ((parts[1] === 'confirm' || parts[1] === 'cancel') && parts.length === 3 && TOKEN.test(parts[2]))
+        return { kind: parts[1], token: parts[2] };
+    return { kind: 'invalid', error: 'Expected /session, /session detach, /session confirm <token> or /session cancel <token>.' };
+}
+function sameScope(a, b) {
+    return a.openId === b.openId && a.threadId === b.threadId && a.workingDirectory === b.workingDirectory;
+}
+/**
+ * In-memory, read-only chooser snapshots. Tokens are unguessable, expire after
+ * five minutes, and only resolve for the original requester, thread and
+ * workspace, so an old list never redirects to another context. Snapshots never
+ * authorize a native action; they only fix the rows a user is paging through.
+ */
+class SessionMenuStore {
+    now;
+    snapshots = new Map();
+    confirmations = new Map();
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    create(backend, scope, catalog, query) {
+        this.evict();
+        const token = (0, crypto_1.randomBytes)(9).toString('base64url');
+        const snapshot = { token, backend, scope: { ...scope }, catalog, query, createdAt: this.now() };
+        this.snapshots.set(token, snapshot);
+        while (this.snapshots.size > exports.SESSION_MENU_LIMIT)
+            this.snapshots.delete(this.snapshots.keys().next().value);
+        return snapshot;
+    }
+    /** Resolve a token for the same scope; any mismatch is indistinguishable from expiry. */
+    get(token, scope) {
+        this.evict();
+        const snapshot = this.snapshots.get(token);
+        return snapshot && sameScope(snapshot.scope, scope) ? snapshot : undefined;
+    }
+    /** Search returns a new snapshot; the original rows and token stay unchanged. */
+    search(token, scope, text) {
+        const source = this.get(token, scope);
+        if (!source)
+            return undefined;
+        const needle = text.toLowerCase();
+        const candidates = source.catalog.candidates.filter(item => item.id.toLowerCase().includes(needle) || (item.name ?? '').toLowerCase().includes(needle));
+        return this.create(source.backend, scope, { ...source.catalog, candidates }, text);
+    }
+    get size() { return this.snapshots.size; }
+    /** Issue a confirmation; any earlier pending confirmation for the same thread is superseded. */
+    confirm(pending) {
+        this.evict();
+        for (const [token, existing] of this.confirmations) {
+            if (existing.scope.threadId === pending.scope.threadId)
+                this.confirmations.delete(token);
+        }
+        const confirmation = { ...pending, scope: { ...pending.scope },
+            token: (0, crypto_1.randomBytes)(9).toString('base64url'), createdAt: this.now() };
+        this.confirmations.set(confirmation.token, confirmation);
+        while (this.confirmations.size > exports.SESSION_MENU_LIMIT)
+            this.confirmations.delete(this.confirmations.keys().next().value);
+        return confirmation;
+    }
+    /** Single use: a matching confirmation is removed whether it is confirmed or cancelled. */
+    take(token, scope, action) {
+        this.evict();
+        const confirmation = this.confirmations.get(token);
+        if (!confirmation || confirmation.action !== action || !sameScope(confirmation.scope, scope))
+            return undefined;
+        this.confirmations.delete(token);
+        return confirmation;
+    }
+    get pendingConfirmations() { return this.confirmations.size; }
+    evict() {
+        const cutoff = this.now() - exports.SESSION_MENU_TTL_MS;
+        for (const [token, snapshot] of this.snapshots)
+            if (snapshot.createdAt <= cutoff)
+                this.snapshots.delete(token);
+        for (const [token, pending] of this.confirmations)
+            if (pending.createdAt <= cutoff)
+                this.confirmations.delete(token);
+    }
+}
+exports.SessionMenuStore = SessionMenuStore;
+function sessionMenuPageCount(snapshot) {
+    return Math.max(1, Math.ceil(snapshot.catalog.candidates.length / exports.SESSION_MENU_PAGE_SIZE));
+}
+//# sourceMappingURL=SessionMenu.js.map

package/dist/session/SessionMenu.js.map

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

package/dist/session/SessionResumeService.d.ts

@@ -0,0 +1,38 @@
+import type { BackendKey } from '../types/config';
+import type { SessionCatalog } from './SessionCatalog';
+export declare const SESSION_BACKENDS: readonly ["claude", "codex", "agy", "opencode", "kimi", "zcode", "pi", "dsh"];
+export interface ResumeGateResult {
+    success: false;
+    code: 'sharing_disabled' | 'invalid_session_configuration' | 'native_capability_unavailable' | 'invalid_session_command';
+    error: string;
+}
+/** User-facing backend name. */
+export declare function sessionBackendLabel(backend: BackendKey): string;
+/** Backends whose strict native resume is verified and implemented. */
+export declare const NATIVE_RESUME_BACKENDS: readonly BackendKey[];
+/** Validate the opt-in without resetting unrelated configuration on malformed input. */
+export declare function validateSessionSharing(value: unknown): string | undefined;
+/** Backends whose read-only catalog has been implemented; connecting remains unavailable. */
+export declare const CATALOG_BACKENDS: readonly BackendKey[];
+/** Optional paging view for a tokenized snapshot. */
+export interface CatalogView {
+    token: string;
+    page: number;
+    pageSize: number;
+    query?: string;
+    /** Rows can be selected for a confirmed native connection. */
+    connectable?: boolean;
+}
+/** Read-only menu rendering shared by the implemented catalog backends. */
+export declare function formatCatalog(catalog: SessionCatalog, backend: BackendKey, view?: CatalogView): string;
+/** Re-check local opt-in for a backend without parsing a command (menu actions). */
+export declare function sessionSharingDenied(backend: BackendKey, configuration: unknown): ResumeGateResult | undefined;
+/** Backwards-compatible alias for the Pi-only renderer used by earlier releases. */
+export declare function formatPiCatalog(catalog: SessionCatalog): string;
+/** Return the target backend for a bare chooser request, or undefined for other session controls. */
+export declare function catalogTarget(content: string, currentBackend: BackendKey): BackendKey | undefined;
+/** Recognize session controls before executor construction or slash passthrough. */
+export declare function isSessionControl(content: string): boolean;
+/** Fail closed until discovery, ownership, preservation and native identity are certified. */
+export declare function sessionResumeGate(content: string, currentBackend: BackendKey, configuration: unknown): ResumeGateResult;
+//# sourceMappingURL=SessionResumeService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionResumeService.d.ts","sourceRoot":"","sources":["../../src/session/SessionResumeService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,eAAO,MAAM,gBAAgB,+EAAgF,CAAC;AAE9G,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,kBAAkB,GAAG,+BAA+B,GAAG,+BAA+B,GAAG,yBAAyB,CAAC;IACzH,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,gCAAgC;AAChC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,SAAS,UAAU,EAAW,CAAC;AAMpE,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAczE;AAED,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAyD,CAAC;AAI5G,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CA6BtG;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAW9G;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAMjG;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,GAAG,gBAAgB,CA6BvH"}

package/dist/session/SessionResumeService.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATALOG_BACKENDS = exports.NATIVE_RESUME_BACKENDS = exports.SESSION_BACKENDS = void 0;
+exports.sessionBackendLabel = sessionBackendLabel;
+exports.validateSessionSharing = validateSessionSharing;
+exports.formatCatalog = formatCatalog;
+exports.sessionSharingDenied = sessionSharingDenied;
+exports.formatPiCatalog = formatPiCatalog;
+exports.catalogTarget = catalogTarget;
+exports.isSessionControl = isSessionControl;
+exports.sessionResumeGate = sessionResumeGate;
+const adapters_1 = require("./adapters");
+exports.SESSION_BACKENDS = ['claude', 'codex', 'agy', 'opencode', 'kimi', 'zcode', 'pi', 'dsh'];
+const BACKEND_LABELS = {
+    claude: 'Claude Code', codex: 'Codex', agy: 'AGY', opencode: 'OpenCode',
+    kimi: 'Kimi', zcode: 'ZCode', pi: 'Pi', dsh: 'DSH',
+};
+/** User-facing backend name. */
+function sessionBackendLabel(backend) {
+    return BACKEND_LABELS[backend];
+}
+/** Backends whose strict native resume is verified and implemented. */
+exports.NATIVE_RESUME_BACKENDS = ['pi'];
+function object(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/** Validate the opt-in without resetting unrelated configuration on malformed input. */
+function validateSessionSharing(value) {
+    if (value === undefined)
+        return undefined;
+    if (!object(value) || Object.keys(value).some(key => !['enabled', 'backends'].includes(key)))
+        return 'Invalid session-sharing configuration.';
+    if (value.enabled !== undefined && typeof value.enabled !== 'boolean')
+        return 'Session-sharing enabled must be a boolean.';
+    if (value.backends === undefined)
+        return undefined;
+    if (!object(value.backends))
+        return 'Session-sharing backends must be an object.';
+    for (const [backend, options] of Object.entries(value.backends)) {
+        if (!exports.SESSION_BACKENDS.includes(backend) || !object(options)
+            || Object.keys(options).some(key => key !== 'enabled')
+            || (options.enabled !== undefined && typeof options.enabled !== 'boolean')) {
+            return 'Invalid session-sharing backend configuration.';
+        }
+    }
+    return undefined;
+}
+/** Backends whose read-only catalog has been implemented; connecting remains unavailable. */
+exports.CATALOG_BACKENDS = Object.keys(adapters_1.SESSION_CATALOG_READERS);
+const CATALOG_LABELS = { pi: 'Pi', codex: 'Codex', claude: 'Claude Code' };
+/** Read-only menu rendering shared by the implemented catalog backends. */
+function formatCatalog(catalog, backend, view) {
+    const label = CATALOG_LABELS[backend] ?? BACKEND_LABELS[backend];
+    const pageSize = view?.pageSize ?? 8;
+    const pages = Math.max(1, Math.ceil(catalog.candidates.length / pageSize));
+    const page = Math.min(Math.max(view?.page ?? 1, 1), pages);
+    const offset = (page - 1) * pageSize;
+    const rows = catalog.candidates.slice(offset, offset + pageSize).map((item, index) => {
+        const title = item.name ?? `Session ${item.id.slice(0, 8)}`;
+        const updated = new Date(item.modifiedAt).toISOString().slice(0, 16).replace('T', ' ');
+        const count = item.countComplete ? `${item.messageCount} messages` : 'messages unavailable';
+        return `${offset + index + 1}. ${title} · \`${item.id}\` · ${count} · ${item.source} · updated ${updated} UTC`;
+    });
+    const hidden = catalog.candidates.length - (offset + rows.length);
+    const more = !view && hidden > 0 ? [`… ${hidden} more not shown.`] : [];
+    const body = rows.length ? rows.join('\n')
+        : view?.query ? `No ${label} sessions match "${view.query}".` : `No ${label} sessions were found for this workspace.`;
+    const coverage = catalog.complete ? [] : ['Coverage may be incomplete.'];
+    const navigation = view ? [
+        `Page ${page}/${pages}${view.query ? ` · search "${view.query}"` : ''} · menu \`${view.token}\` (expires in 5 minutes).`,
+        ...(view.connectable && rows.length ? [`Select: \`/resume select ${view.token} <row-number>\``] : []),
+        ...(page < pages ? [`Next: \`/resume page ${view.token} ${page + 1}\``] : []),
+        `Search: \`/resume search ${view.token} <text>\``,
+    ] : [];
+    const footer = [...more, ...navigation, ...coverage, ...catalog.notes.map(note => `Note: ${note}`)];
+    return [`🗂️ ${label} sessions in this workspace (read-only):`, '', body,
+        ...(footer.length ? ['', ...footer] : []), '', view?.connectable
+            ? 'Selecting a row only shows a confirmation; nothing is loaded and no task is sent until you confirm.'
+            : 'Connecting to a session is not available yet: ownership and history-preserving handoff are still being verified. No session was loaded or task sent.']
+        .join('\n');
+}
+/** Re-check local opt-in for a backend without parsing a command (menu actions). */
+function sessionSharingDenied(backend, configuration) {
+    const invalid = validateSessionSharing(configuration);
+    if (invalid)
+        return { success: false, code: 'invalid_session_configuration', error: invalid };
+    const config = configuration;
+    if (config?.enabled !== true) {
+        return { success: false, code: 'sharing_disabled', error: 'Session sharing is disabled. Native resume is not yet available; enabling configuration does not certify an adapter.' };
+    }
+    if (config.backends?.[backend]?.enabled === false) {
+        return { success: false, code: 'sharing_disabled', error: `Session sharing is disabled for ${BACKEND_LABELS[backend]}.` };
+    }
+    return undefined;
+}
+/** Backwards-compatible alias for the Pi-only renderer used by earlier releases. */
+function formatPiCatalog(catalog) {
+    return formatCatalog(catalog, 'pi');
+}
+/** Return the target backend for a bare chooser request, or undefined for other session controls. */
+function catalogTarget(content, currentBackend) {
+    const parts = content.trim().split(/\s+/);
+    if (!/^\/(?:resume|r)$/i.test(parts[0]))
+        return undefined;
+    if (parts.length === 1)
+        return currentBackend;
+    if (parts.length === 3 && parts[1] === 'backend' && exports.SESSION_BACKENDS.includes(parts[2]))
+        return parts[2];
+    return undefined;
+}
+/** Recognize session controls before executor construction or slash passthrough. */
+function isSessionControl(content) {
+    return /^\/(?:resume|r|session)(?:\s|$)/i.test(content.trim());
+}
+/** Fail closed until discovery, ownership, preservation and native identity are certified. */
+function sessionResumeGate(content, currentBackend, configuration) {
+    const invalid = validateSessionSharing(configuration);
+    if (invalid)
+        return { success: false, code: 'invalid_session_configuration', error: invalid };
+    const config = configuration;
+    if (config?.enabled !== true) {
+        return { success: false, code: 'sharing_disabled', error: 'Session sharing is disabled. Native resume is not yet available; enabling configuration does not certify an adapter.' };
+    }
+    const parts = content.trim().split(/\s+/);
+    let backend = currentBackend;
+    const sessionStatus = /^\/session$/i.test(parts[0]);
+    if (/^\/(?:resume|r)$/i.test(parts[0]) && parts[1] === 'backend') {
+        if (!parts[2] || !exports.SESSION_BACKENDS.includes(parts[2])) {
+            return { success: false, code: 'invalid_session_command', error: `Expected a backend key: ${exports.SESSION_BACKENDS.join(', ')}.` };
+        }
+        backend = parts[2];
+    }
+    if (config?.backends?.[backend]?.enabled === false) {
+        return { success: false, code: 'sharing_disabled', error: `Session sharing is disabled for ${BACKEND_LABELS[backend]}.` };
+    }
+    if (sessionStatus) {
+        return {
+            success: false, code: 'native_capability_unavailable',
+            error: `No native session is bound to this thread. ${BACKEND_LABELS[backend]} session status and detach become available after native resume is verified. No session was loaded or task sent.\n\nOn this computer, run \`remote-cli session show --thread <thread-name> --backend ${backend}\` for local-only reopen guidance; it never starts a backend.`,
+        };
+    }
+    return {
+        success: false, code: 'native_capability_unavailable',
+        error: `${BACKEND_LABELS[backend]} native resume is not available in this release. Session discovery, ownership and history-preserving handoff are still being verified. No session was loaded or task sent.`,
+    };
+}
+//# sourceMappingURL=SessionResumeService.js.map

package/dist/session/SessionResumeService.js.map

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

package/dist/session/adapters/ClaudeSessionCatalog.d.ts

@@ -0,0 +1,10 @@
+import { type SessionCatalog, type SessionCatalogOptions } from '../SessionCatalog';
+/** Project directory name: leading separator dropped, separators replaced with `-`. */
+export declare function claudeProjectDirectoryName(cwd: string): string;
+/**
+ * Read-only discovery of Claude Code sessions whose recorded workspace equals the
+ * thread workspace. It never starts Claude Code, reads further than the bounded
+ * head, migrates files, or writes anything. Counts stay unavailable.
+ */
+export declare function listClaudeSessions(workingDirectory: string, options?: SessionCatalogOptions): SessionCatalog;
+//# sourceMappingURL=ClaudeSessionCatalog.d.ts.map

package/dist/session/adapters/ClaudeSessionCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeSessionCatalog.d.ts","sourceRoot":"","sources":["../../../src/session/adapters/ClaudeSessionCatalog.ts"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAE3B,MAAM,mBAAmB,CAAC;AAc3B,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAiED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA+BhH"}

package/dist/session/adapters/ClaudeSessionCatalog.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeProjectDirectoryName = claudeProjectDirectoryName;
+exports.listClaudeSessions = listClaudeSessions;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const SessionCatalog_1 = require("../SessionCatalog");
+/**
+ * Claude Code stores one JSONL transcript per session under
+ * `<config-dir>/projects/<encoded-cwd>/<session-id>.jsonl`. A transcript record
+ * is large and `cwd` first appears after ~2.5 KiB in the observed release, so a
+ * bounded head read is used instead of the shared 64 KiB header budget. The cap
+ * stays a hard resource bound; an oversized head becomes a coverage gap.
+ */
+const CLAUDE_HEAD_MAX_BYTES = 256 * 1024;
+/** Reject a transcript that cannot show its recorded workspace inside the head. */
+const CLAUDE_CWD_MARKER = '"cwd"';
+const CLAUDE_MAX_RECORD_BYTES = 64 * 1024;
+/** Project directory name: leading separator dropped, separators replaced with `-`. */
+function claudeProjectDirectoryName(cwd) {
+    return `-${path_1.default.resolve(cwd).replace(/^[/\\]/, '').replace(/[/\\:]/g, '-')}`;
+}
+/** Read a bounded head of a private single-link regular file; never follows a symlink. */
+function readHead(file, maxBytes) {
+    let fd;
+    try {
+        const before = fs_1.default.lstatSync(file);
+        if (!before.isFile() || before.isSymbolicLink() || before.nlink !== 1 || before.size === 0)
+            return undefined;
+        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 undefined;
+        const size = Math.min(stat.size, maxBytes);
+        const buffer = Buffer.alloc(size);
+        const length = fs_1.default.readSync(fd, buffer, 0, size, 0);
+        return { text: buffer.subarray(0, length).toString('utf8'), truncated: stat.size > maxBytes };
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        if (fd !== undefined)
+            fs_1.default.closeSync(fd);
+    }
+}
+/**
+ * Parse the bounded head of one transcript. Only whole newline-terminated records
+ * are considered, so a partially read trailing record can never be misread.
+ */
+function headOf(file, expectedDirectory) {
+    const head = readHead(file, CLAUDE_HEAD_MAX_BYTES);
+    if (!head)
+        return undefined;
+    const lines = head.text.split('\n');
+    if (head.truncated)
+        lines.pop();
+    const sessionIdFromName = path_1.default.basename(file, '.jsonl');
+    let sessionId;
+    let cwd;
+    let sidechain = false;
+    let lastPrompt;
+    for (const line of lines) {
+        if (!line || line.length > CLAUDE_MAX_RECORD_BYTES)
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (typeof record.sessionId === 'string' && record.sessionId) {
+            // Later records can belong to another session; a transcript must stay single-session.
+            if (!sessionId)
+                sessionId = record.sessionId;
+            else if (record.sessionId !== sessionId)
+                return undefined;
+        }
+        if (typeof record.cwd === 'string' && record.cwd)
+            cwd ??= record.cwd;
+        if (record.isSidechain === true)
+            sidechain = true;
+        if (record.type === 'last-prompt' && typeof record.lastPrompt === 'string')
+            lastPrompt = record.lastPrompt;
+    }
+    if (!sessionId || sessionId !== sessionIdFromName || sessionId.length > SessionCatalog_1.SESSION_CATALOG_MAX_ID
+        || /[\u0000-\u001f\u007f\s`]/.test(sessionId) || SessionCatalog_1.SYNTHETIC_SESSION.test(sessionId))
+        return undefined;
+    if (!cwd || !path_1.default.isAbsolute(cwd))
+        return undefined;
+    // The containing directory must itself encode this recorded workspace.
+    if (path_1.default.basename(expectedDirectory) !== claudeProjectDirectoryName(cwd))
+        return undefined;
+    let modifiedAt;
+    try {
+        modifiedAt = fs_1.default.lstatSync(file).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+    if (!Number.isFinite(modifiedAt) || modifiedAt - Date.now() > SessionCatalog_1.SESSION_CATALOG_MAX_MODIFIED_SKEW_MS)
+        return undefined;
+    return { sessionId, cwd, modifiedAt, sidechain, summary: lastPrompt ? (0, SessionCatalog_1.safeSessionLabel)(lastPrompt) : undefined };
+}
+/**
+ * Read-only discovery of Claude Code sessions whose recorded workspace equals the
+ * thread workspace. It never starts Claude Code, reads further than the bounded
+ * head, migrates files, or writes anything. Counts stay unavailable.
+ */
+function listClaudeSessions(workingDirectory, options = {}) {
+    const home = options.home ?? os_1.default.homedir();
+    const env = options.env ?? process.env;
+    const remoteDirectory = options.remoteCliDirectory ?? path_1.default.join(home, '.remote-cli');
+    const notes = [];
+    const threadCwd = (0, SessionCatalog_1.canonicalPath)(workingDirectory);
+    if (!threadCwd)
+        return { candidates: [], complete: false, notes: ['The thread working directory is unavailable.'] };
+    const configured = env.CLAUDE_CONFIG_DIR ? (0, SessionCatalog_1.expandHomePath)(env.CLAUDE_CONFIG_DIR, home) : undefined;
+    if (env.CLAUDE_CONFIG_DIR && !configured)
+        notes.push('A relative Claude config directory override was ignored.');
+    const configDirectory = configured ?? path_1.default.join(home, '.claude');
+    const projectDirectory = path_1.default.join(configDirectory, 'projects', claudeProjectDirectoryName(threadCwd));
+    if (env.CLAUDE_CONFIG_DIR && !configured) {
+        return { candidates: [], complete: false,
+            notes: [...notes, 'The native Claude config directory could not be resolved.'] };
+    }
+    const stores = [{ directory: projectDirectory, source: 'native-local' }];
+    const scan = (0, SessionCatalog_1.scanSessionCatalogs)(stores, (file, root, store) => {
+        let head;
+        try {
+            head = headOf(file, root);
+        }
+        catch {
+            head = undefined;
+        }
+        if (!head || head.sidechain || (0, SessionCatalog_1.canonicalPath)(head.cwd) !== threadCwd)
+            return undefined;
+        return { id: head.sessionId, name: head.summary, source: store.source,
+            modifiedAt: head.modifiedAt, messageCount: 0, countComplete: false };
+    }, { onGap: reason => notes.push(reason === 'truncated'
+            ? 'Some Claude session storage could not be fully scanned.'
+            : 'The Claude project store could not be read safely.') });
+    if (scan.duplicates)
+        notes.push(`${scan.duplicates} duplicated session ID(s) were hidden.`);
+    if (scan.candidates.length)
+        notes.push('Claude message counts are not available without reading native transcripts.');
+    if (scan.complete && !scan.candidates.length)
+        notes.push('No Claude Code sessions were found for this workspace.');
+    return { candidates: scan.candidates, complete: scan.complete, notes };
+}
+//# sourceMappingURL=ClaudeSessionCatalog.js.map