shortcutxl 0.3.81 → 0.3.83

package/BINARY-INVENTORY.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-08-12T04:56:55.420Z",
+  "generatedAt": "2026-08-14T08:00:44.785Z",
   "package": "shortcutxl",
   "build": {
     "builder": "github-actions",
     "repository": "lyfegame/shortcut",
-    "sourceRef": "refs/heads/codex/native-resources-and-clipboard",
-    "sourceCommit": "ff226182eb12799fcc6c1a9b8ede4fbfb18bfa7e",
-    "workflowRef": "lyfegame/shortcut/.github/workflows/release-shortcutxl.yml@refs/heads/codex/native-resources-and-clipboard",
-    "runId": "31564834411",
+    "sourceRef": "refs/heads/fix/native-tab-lifecycle-e2e",
+    "sourceCommit": "05b4e8d19e60e7761e4839f723e34f10aec5732b",
+    "workflowRef": "lyfegame/shortcut/.github/workflows/release-shortcutxl.yml@refs/heads/fix/native-tab-lifecycle-e2e",
+    "runId": "31782090568",
     "runnerOs": "Windows",
     "runnerImage": "win25-vs2026",
     "runnerImageVersion": "20260803.193.1"
@@ -22,7 +22,7 @@
   "files": [
     {
       "path": "xll/ShortcutXL.xll",
-      "sha256": "f5bffdeda390326397a23c83648c8de66b3d58a51d1af7e2ea936fed18ec754c",
+      "sha256": "184bd94bf10a566d242761aed8036e3db819447dcf2f65c94b39a55d91985e68",
       "source": "ShortcutXL native XLL build",
       "version": "package",
       "builtBy": "shortcut",
@@ -534,7 +534,7 @@
     },
     {
       "path": "xll/python/Scripts/httpx.exe",
-      "sha256": "0e2294a43a498d892ab8e5191e5a301aebc3f19879f23ea257fff5f52a1f7b32",
+      "sha256": "65250768d249e621c8d772506fb01447e82fe9ee4f886e7652d20c76257df743",
       "source": "httpx console launcher installed into embedded Python",
       "version": "see packaged httpx distribution",
       "builtBy": "third-party",
@@ -542,7 +542,7 @@
     },
     {
       "path": "xll/python/Scripts/idna.exe",
-      "sha256": "502b2aeaa0c5b515150137bc35ec134d12f5df43b4b4af262e5115f030994ce7",
+      "sha256": "b62b33859e93f2f5e3aec1d90810fe89f3798c4b60e52e40587b134f87268241",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",
@@ -550,7 +550,7 @@
     },
     {
       "path": "xll/python/Scripts/pip.exe",
-      "sha256": "5b29e4cd0dea0c8698301ff87d6c9c228cfcdf5ca56635e3c4e3d22bdcd1c21d",
+      "sha256": "cdf622bf555bb3f7d192501f331010f7ef29dd70a13dcec2df8e3e160cb5626e",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -558,7 +558,7 @@
     },
     {
       "path": "xll/python/Scripts/pip3.13.exe",
-      "sha256": "5b29e4cd0dea0c8698301ff87d6c9c228cfcdf5ca56635e3c4e3d22bdcd1c21d",
+      "sha256": "cdf622bf555bb3f7d192501f331010f7ef29dd70a13dcec2df8e3e160cb5626e",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -566,7 +566,7 @@
     },
     {
       "path": "xll/python/Scripts/pip3.exe",
-      "sha256": "5b29e4cd0dea0c8698301ff87d6c9c228cfcdf5ca56635e3c4e3d22bdcd1c21d",
+      "sha256": "cdf622bf555bb3f7d192501f331010f7ef29dd70a13dcec2df8e3e160cb5626e",
       "source": "pip console launcher installed into embedded Python",
       "version": "see packaged pip distribution",
       "builtBy": "third-party",
@@ -574,7 +574,7 @@
     },
     {
       "path": "xll/python/Scripts/pywin32_postinstall.exe",
-      "sha256": "7cd7d1f3296f6fcf00e56f758b363100a519be237729070b67c544d3d2948f59",
+      "sha256": "05901aedb7c65ac48a31dede95ccc8a7daf8cef8cf923af364635310c57f2c45",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",
@@ -582,7 +582,7 @@
     },
     {
       "path": "xll/python/Scripts/pywin32_testall.exe",
-      "sha256": "34fbc20da3daac9f50f77884dabb243ec47e301dcd3d7b40e5fe483bc9e1a9d6",
+      "sha256": "af7a61cb9722914d056923434850b756fda5cc388f6c9d3b47586efac880848c",
       "source": "Python package console launcher installed into embedded Python",
       "version": "see owning Python package metadata in site-packages",
       "builtBy": "third-party",

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.3.83]
+
+- **More reliable native app chats**
+
+## [0.3.82]
+
+- **Safer CLI and app updates**
+- **More reliable native chats for app**
+- **Drag and drop file attachments for app**
+
 ## [0.3.81]
 
 - **Smoother native setup and upgrades** - `shortcut app` now guides first-run prerequisites and required Excel integration updates directly in the app.

package/dist/app/extensions/wrapper.js

@@ -4,14 +4,14 @@
  * Wraps ToolDefinitions with tool_call / tool_result event hooks so
  * extensions can block or modify tool execution.
  */
+import { cloneToolDefinition } from '../../core/tool-definition.js';
 /**
  * Wrap a tool with extension callbacks for interception.
  * - Emits tool_call event before execution (can block)
  * - Emits tool_result event after execution (can modify result)
  */
 export function wrapToolWithExtensions(tool, runner) {
-    return {
-        ...tool,
+    return cloneToolDefinition(tool, {
         execute: async (toolCallId, params, signal, onUpdate, ctx) => {
             // Emit tool_call event - extensions can block execution
             if (runner.hasHandlers('tool_call')) {
@@ -73,7 +73,7 @@ export function wrapToolWithExtensions(tool, runner) {
                 throw err;
             }
         }
-    };
+    });
 }
 /**
  * Wrap all tools with extension callbacks.

package/dist/app/modes/action/agent.d.ts

@@ -5,7 +5,7 @@
  * Can switch to plan or installation mode.
  */
 import type { AgentDefinition } from '../../agent-definition.js';
-export declare const ACTION_AGENT_TOOL_NAMES: ("write" | "execute_code" | "execute_tool" | "get_tool_info" | "mcp" | "refresh_context" | "send_message" | "take_screenshot" | "task" | "bash" | "switch_from_action_mode")[];
+export declare const ACTION_AGENT_TOOL_NAMES: ("bash" | "write" | "execute_code" | "execute_tool" | "get_tool_info" | "mcp" | "refresh_context" | "send_message" | "take_screenshot" | "task" | "switch_from_action_mode")[];
 /** Construct the action-mode agent definition with the full execution toolset. */
 export declare function actionAgent(): AgentDefinition;
 //# sourceMappingURL=agent.d.ts.map

package/dist/app/modes/index.js

@@ -10,7 +10,7 @@ export { installationAgent } from './installation/agent.js';
 export { manageAgent } from './manage/agent.js';
 export { planAgent } from './plan/agent.js';
 export { reviewAgent } from './review/agent.js';
-import { MODE } from '../../mode-names.js';
+import { isAgentMode, MODE } from '../../mode-names.js';
 import { actionAgent } from './action/agent.js';
 import { askAgent } from './ask/agent.js';
 import { installationAgent } from './installation/agent.js';
@@ -18,25 +18,24 @@ import { manageAgent } from './manage/agent.js';
 import { MODE_METADATA } from './metadata.js';
 import { planAgent } from './plan/agent.js';
 import { reviewAgent } from './review/agent.js';
-const MODE_FACTORIES = new Map([
-    [MODE.INSTALLATION, installationAgent],
-    [MODE.ACTION, actionAgent],
-    [MODE.PLAN, planAgent],
-    [MODE.ASK, askAgent],
-    [MODE.MANAGE, manageAgent],
-    [MODE.REVIEW, reviewAgent]
-]);
+const MODE_FACTORIES = {
+    [MODE.INSTALLATION]: installationAgent,
+    [MODE.ACTION]: actionAgent,
+    [MODE.PLAN]: planAgent,
+    [MODE.ASK]: askAgent,
+    [MODE.MANAGE]: manageAgent,
+    [MODE.REVIEW]: reviewAgent
+};
 export function getModes() {
     return MODE_METADATA.map((metadata) => {
-        const factory = MODE_FACTORIES.get(metadata.name);
-        if (!factory) {
+        if (!isAgentMode(metadata.name)) {
             throw new Error(`No mode factory registered for "${metadata.name}".`);
         }
-        return factory();
+        return MODE_FACTORIES[metadata.name]();
     });
 }
 export function getMode(name) {
-    return MODE_FACTORIES.get(name)?.();
+    return isAgentMode(name) ? MODE_FACTORIES[name]() : undefined;
 }
 export function getModeNames() {
     return MODE_METADATA.map((mode) => mode.name);

package/dist/app/resources/skills.js

@@ -200,7 +200,10 @@ export function loadSkillsFromDir(options) {
     const { dir, source } = options;
     const skills = [];
     const diagnostics = [];
+    const archivedUserSkillsPrefix = `${resolve(dir, '_archive')}${sep}`;
     for (const filePath of discoverSkillFiles(dir)) {
+        if (source === 'user' && resolve(filePath).startsWith(archivedUserSkillsPrefix))
+            continue;
         const result = loadSkillFromFile(filePath, source);
         if (result.skill) {
             skills.push(result.skill);

package/dist/app/session/session-catalog.d.ts

@@ -11,8 +11,10 @@ export interface SessionInfo {
     created: Date;
     modified: Date;
     messageCount: number;
-    firstMessage: string;
-    lastMessage: string;
+    /** First user message text, absent when the session has no readable messages. */
+    firstMessage?: string;
+    /** Most recent user message text, absent when the session has no readable messages. */
+    lastMessage?: string;
     allMessagesText: string;
 }
 export declare function buildSessionInfo(filePath: string): Promise<SessionInfo | null>;

package/dist/app/session/session-catalog.js

@@ -3,53 +3,8 @@ import { existsSync } from 'fs';
 import { readdir, readFile, stat } from 'fs/promises';
 import { join } from 'path';
 import { getSessionsDir } from '../../config.js';
+import { analyzeSessionEntries } from './session-metadata.js';
 import { getDefaultSessionDir } from './session-paths.js';
-function isMessageWithContent(message) {
-    return typeof message.role === 'string' && 'content' in message;
-}
-function extractTextContent(message) {
-    const content = message.content;
-    if (typeof content === 'string') {
-        return content;
-    }
-    return content
-        .filter((block) => block.type === 'text')
-        .map((block) => block.text)
-        .join(' ');
-}
-function getLastActivityTime(entries) {
-    let lastActivityTime;
-    for (const entry of entries) {
-        if (entry.type !== 'message')
-            continue;
-        const message = entry.message;
-        if (!isMessageWithContent(message))
-            continue;
-        if (message.role !== 'user' && message.role !== 'assistant')
-            continue;
-        const msgTimestamp = message.timestamp;
-        if (typeof msgTimestamp === 'number') {
-            lastActivityTime = Math.max(lastActivityTime ?? 0, msgTimestamp);
-            continue;
-        }
-        const entryTimestamp = entry.timestamp;
-        if (typeof entryTimestamp === 'string') {
-            const t = new Date(entryTimestamp).getTime();
-            if (!Number.isNaN(t)) {
-                lastActivityTime = Math.max(lastActivityTime ?? 0, t);
-            }
-        }
-    }
-    return lastActivityTime;
-}
-function getSessionModifiedDate(entries, header, statsMtime) {
-    const lastActivityTime = getLastActivityTime(entries);
-    if (typeof lastActivityTime === 'number' && lastActivityTime > 0) {
-        return new Date(lastActivityTime);
-    }
-    const headerTime = typeof header.timestamp === 'string' ? new Date(header.timestamp).getTime() : NaN;
-    return !Number.isNaN(headerTime) ? new Date(headerTime) : statsMtime;
-}
 export async function buildSessionInfo(filePath) {
     try {
         const content = await readFile(filePath, 'utf8');
@@ -71,51 +26,22 @@ export async function buildSessionInfo(filePath) {
         if (header.type !== 'session')
             return null;
         const stats = await stat(filePath);
-        let messageCount = 0;
-        let firstMessage = '';
-        let lastMessage = '';
-        const allMessages = [];
-        let name;
-        for (const entry of entries) {
-            if (entry.type === 'session_info') {
-                const infoEntry = entry;
-                if (infoEntry.name) {
-                    name = infoEntry.name.trim();
-                }
-            }
-            if (entry.type !== 'message')
-                continue;
-            messageCount++;
-            const message = entry.message;
-            if (!isMessageWithContent(message))
-                continue;
-            if (message.role !== 'user' && message.role !== 'assistant')
-                continue;
-            const textContent = extractTextContent(message);
-            if (!textContent)
-                continue;
-            allMessages.push(textContent);
-            if (!firstMessage && message.role === 'user') {
-                firstMessage = textContent;
-            }
-            if (message.role === 'user') {
-                lastMessage = textContent;
-            }
-        }
-        const sessionHeader = header;
-        const modified = getSessionModifiedDate(entries, sessionHeader, stats.mtime);
+        const metadata = analyzeSessionEntries(entries, {
+            fallbackTimestamp: stats.mtime,
+            searchText: true
+        });
         return {
             path: filePath,
-            id: sessionHeader.id,
-            cwd: typeof sessionHeader.cwd === 'string' ? sessionHeader.cwd : '',
-            name,
-            parentSessionPath: sessionHeader.parentSession,
-            created: new Date(sessionHeader.timestamp),
-            modified,
-            messageCount,
-            firstMessage: firstMessage || '(no messages)',
-            lastMessage: lastMessage || firstMessage || '(no messages)',
-            allMessagesText: allMessages.join(' ')
+            id: header.id,
+            cwd: typeof header.cwd === 'string' ? header.cwd : '',
+            name: metadata.name,
+            parentSessionPath: header.parentSession,
+            created: new Date(metadata.createdAt),
+            modified: new Date(metadata.modifiedAt),
+            messageCount: metadata.messageCount,
+            firstMessage: metadata.firstMessage,
+            lastMessage: metadata.lastMessage,
+            allMessagesText: metadata.allMessagesText ?? ''
         };
     }
     catch {

package/dist/app/session/session-manager.d.ts

@@ -1,6 +1,7 @@
 import type { ImageContent, Message, TextContent } from '../../ai/types.js';
 import { type NewSessionOptions, type SessionContext, type SessionEntry, type SessionHeader, type SessionTreeNode } from '../../core/session-schema.js';
 import { type CustomMessage } from '../messages.js';
+import { type SessionMetadata } from './session-metadata.js';
 import type { SessionPersistenceBackend } from './session-persistence-backend.js';
 /**
  * Manages conversation sessions as append-only trees stored in JSONL files.
@@ -36,6 +37,7 @@ export declare class SessionManager {
     getSessionDir(): string;
     getSessionId(): string;
     getSessionFile(): string | undefined;
+    getSessionMetadata(): SessionMetadata;
     _persist(entry: SessionEntry): void;
     private _appendEntry;
     private _reloadPersistedArchive;

package/dist/app/session/session-manager.js

@@ -1,6 +1,7 @@
 /** Owns app-session lifecycle, persistence, and turn execution outside the browser embedded worker. */
 import { randomUUID } from 'crypto';
 import { buildSessionContext, CURRENT_SESSION_VERSION } from '../../core/session-schema.js';
+import { analyzeSessionEntries } from './session-metadata.js';
 import { migrateSessionEntries } from './session-schema-node-io.js';
 /** Generate a unique short ID (8 hex chars, collision-checked) */
 function generateId(byId) {
@@ -164,6 +165,9 @@ export class SessionManager {
     getSessionFile() {
         return this.sessionFile;
     }
+    getSessionMetadata() {
+        return analyzeSessionEntries(this.fileEntries);
+    }
     _persist(entry) {
         if (!this.persist || !this.sessionFile || !this.persistenceBackend)
             return;

package/dist/app/session/session-metadata.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimeSessionMetadata } from '../../contracts/agent-session-store.js';
+import type { FileEntry } from '../../core/session-schema.js';
+export type SessionMetadata = RuntimeSessionMetadata;
+export interface SessionMetadataOptions {
+    /** Used when the session header carries no usable timestamp. */
+    fallbackTimestamp?: Date;
+    /**
+     * Also concatenate every message into `allMessagesText` for full-text search.
+     * Off by default: it copies the entire transcript, and snapshots are published
+     * often enough that doing it unconditionally is pure waste.
+     */
+    searchText?: boolean;
+}
+/** Derives stable display and ordering metadata from the canonical session entries. */
+export declare function analyzeSessionEntries(entries: readonly FileEntry[], { fallbackTimestamp, searchText }?: SessionMetadataOptions): SessionMetadata;
+//# sourceMappingURL=session-metadata.d.ts.map

package/dist/app/session/session-metadata.js

@@ -0,0 +1,75 @@
+function isMessageWithContent(message) {
+    return (typeof message === 'object' &&
+        message !== null &&
+        typeof message.role === 'string' &&
+        'content' in message);
+}
+function extractTextContent(message) {
+    const content = message.content;
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join(' ');
+}
+function validIsoTimestamp(value) {
+    if (typeof value !== 'string' || Number.isNaN(Date.parse(value)))
+        return undefined;
+    return new Date(value).toISOString();
+}
+/** Derives stable display and ordering metadata from the canonical session entries. */
+export function analyzeSessionEntries(entries, { fallbackTimestamp = new Date(0), searchText = false } = {}) {
+    const header = entries.find((entry) => entry.type === 'session');
+    const fallbackIso = fallbackTimestamp.toISOString();
+    const createdAt = validIsoTimestamp(header?.timestamp) ?? fallbackIso;
+    let modifiedAtMs = Date.parse(createdAt);
+    let messageCount = 0;
+    let firstMessage;
+    let lastMessage;
+    let name;
+    const allMessages = [];
+    for (const entry of entries) {
+        if (entry.type === 'session_info') {
+            const nextName = entry.name?.trim();
+            if (nextName)
+                name = nextName;
+        }
+        if (entry.type !== 'message')
+            continue;
+        messageCount += 1;
+        const message = entry.message;
+        if (!isMessageWithContent(message))
+            continue;
+        if (message.role !== 'user' && message.role !== 'assistant')
+            continue;
+        const messageTimestamp = message.timestamp;
+        const entryTimestamp = validIsoTimestamp(entry.timestamp);
+        const activityTime = typeof messageTimestamp === 'number' && Number.isFinite(messageTimestamp)
+            ? messageTimestamp
+            : entryTimestamp
+                ? Date.parse(entryTimestamp)
+                : undefined;
+        if (activityTime !== undefined)
+            modifiedAtMs = Math.max(modifiedAtMs, activityTime);
+        const text = extractTextContent(message).trim();
+        if (!text)
+            continue;
+        if (searchText)
+            allMessages.push(text);
+        if (!firstMessage && message.role === 'user')
+            firstMessage = text;
+        if (message.role === 'user')
+            lastMessage = text;
+    }
+    return {
+        createdAt,
+        modifiedAt: new Date(modifiedAtMs).toISOString(),
+        name,
+        firstMessage,
+        lastMessage: lastMessage ?? firstMessage,
+        ...(searchText ? { allMessagesText: allMessages.join(' ') } : {}),
+        messageCount
+    };
+}
+//# sourceMappingURL=session-metadata.js.map

package/dist/app/session/session-reader.d.ts

@@ -0,0 +1,9 @@
+/** Read-only helpers for host UIs that need saved chats without starting an agent runtime. */
+import type { AgentMessage } from '../../core/core-types.js';
+import { type SessionInfo } from './session-catalog.js';
+export interface PersistedSessionPreview {
+    session: SessionInfo;
+    messages: AgentMessage[];
+}
+export declare function readPersistedSession(sessionPath: string): Promise<PersistedSessionPreview | null>;
+//# sourceMappingURL=session-reader.d.ts.map

package/dist/app/session/session-reader.js

@@ -0,0 +1,16 @@
+import { buildSessionContext } from '../../core/session-schema.js';
+import { buildSessionInfo } from './session-catalog.js';
+import { loadEntriesFromFile, migrateSessionEntries } from './session-schema-node-io.js';
+export async function readPersistedSession(sessionPath) {
+    const session = await buildSessionInfo(sessionPath);
+    if (!session)
+        return null;
+    const entries = loadEntriesFromFile(session.path);
+    if (entries.length === 0 && session.messageCount > 0) {
+        throw new Error('Session could not be read');
+    }
+    migrateSessionEntries(entries);
+    const messages = buildSessionContext(entries.filter((entry) => entry.type !== 'session')).messages;
+    return { session, messages };
+}
+//# sourceMappingURL=session-reader.js.map

package/dist/app/session/session-store-types.d.ts

@@ -1,6 +1,7 @@
 import type { ImageContent, TextContent } from '../../ai/types.js';
 import type { AgentMessage } from '../../core/index.js';
 import type { NewSessionOptions, SessionContext, SessionEntry, SessionHeader, SessionTreeNode } from '../../core/session-schema.js';
+import type { SessionMetadata } from './session-metadata.js';
 export interface SessionInfoStore {
     getSessionName(): string | undefined;
     appendSessionInfo(name: string): string;
@@ -18,6 +19,7 @@ export interface ProductSessionStore extends SessionInfoStore {
     getSessionDir(): string;
     getSessionFile(): string | undefined;
     getSessionId(): string;
+    getSessionMetadata(): SessionMetadata;
     getTree(): SessionTreeNode[];
     newSession(options?: NewSessionOptions): string | undefined;
     setSessionFile(sessionPath: string): void;

package/dist/app/subagents/defaults.d.ts

@@ -1,6 +1,6 @@
-import { type SubagentSelectableModel } from '../../subagent-model-policy.js';
+import { type SubagentSelectableModelRef } from '../../subagent-model-policy.js';
 export declare const DEFAULT_SUBAGENT_TIMEOUT_SECONDS: number;
-export type TaskModelChoice = SubagentSelectableModel['ref'];
+export type TaskModelChoice = SubagentSelectableModelRef;
 export type TaskModelSelection = {
     readonly provider: string;
     readonly modelId: string;

package/dist/app/sync/remote-skill-files.d.ts

@@ -1,5 +1,6 @@
 import { type StorageContext, type StorageEntry, type StorageOwnerOptions } from './storage-client.js';
 export declare const SKILLS_STORAGE_PREFIX = ".shortcut/skills/";
+export declare const PERSONAL_SKILL_ARCHIVE_DIR = "_archive";
 export interface RemoteSkillFile {
     entry: StorageEntry;
     storagePath: string;
@@ -14,6 +15,11 @@ export interface DuplicateTeamSkill {
     skillName: string;
     ownerTeamIds: string[];
 }
+/** Active cloud copies win when the same skill name also has archived history. */
+export declare function partitionPersonalSkillFiles(files: readonly RemoteSkillFile[]): {
+    activeFiles: RemoteSkillFile[];
+    archiveOnlySkillNames: Set<string>;
+};
 /** List all skill files for a given storage context. */
 export declare function listSkillFiles(accessToken: string, storageContext: StorageContext, ownerTeamId?: string): Promise<RemoteSkillFile[]>;
 export declare function listAuthorizedTeamSkillFiles(accessToken: string, authorizedSkillTeamIds: readonly string[]): Promise<TeamSkillFilesResult>;

package/dist/app/sync/remote-skill-files.js

@@ -1,5 +1,29 @@
 import { storageList } from './storage-client.js';
 export const SKILLS_STORAGE_PREFIX = '.shortcut/skills/';
+export const PERSONAL_SKILL_ARCHIVE_DIR = '_archive';
+const ARCHIVED_SKILL_PREFIX = `${PERSONAL_SKILL_ARCHIVE_DIR}/`;
+/** Active cloud copies win when the same skill name also has archived history. */
+export function partitionPersonalSkillFiles(files) {
+    const activeFiles = [];
+    const activeSkillNames = new Set();
+    const archivedSkillNames = new Set();
+    for (const file of files) {
+        if (!file.entry.path.startsWith(ARCHIVED_SKILL_PREFIX)) {
+            activeFiles.push(file);
+            const skillName = file.entry.path.split('/')[0];
+            if (skillName)
+                activeSkillNames.add(skillName);
+            continue;
+        }
+        const skillName = file.entry.path.slice(ARCHIVED_SKILL_PREFIX.length).split('/')[0];
+        if (skillName)
+            archivedSkillNames.add(skillName);
+    }
+    return {
+        activeFiles,
+        archiveOnlySkillNames: new Set([...archivedSkillNames].filter((skillName) => !activeSkillNames.has(skillName)))
+    };
+}
 /** List all skill files for a given storage context. */
 export async function listSkillFiles(accessToken, storageContext, ownerTeamId) {
     const options = ownerTeamId ? { teamId: ownerTeamId } : {};

package/dist/app/sync/skills-download.d.ts

@@ -8,7 +8,7 @@ import { type StorageContext } from './storage-client.js';
 export interface SkillDownloadApprovalRequest {
     skillName: string;
     source: StorageContext;
-    kind: 'create' | 'update';
+    kind: 'archive' | 'create' | 'update';
     modifiedFiles: number;
     localOnlyFiles: number;
     remoteOnlyFiles: number;
@@ -23,7 +23,7 @@ export interface SkillFileDiff {
 export interface SkillDownloadChange {
     skillName: string;
     source: StorageContext;
-    kind: 'create' | 'update';
+    kind: 'archive' | 'create' | 'update';
     localModifiedAt?: string;
     cloudModifiedAt?: string;
     fileDiffs: SkillFileDiff[];
@@ -31,6 +31,8 @@ export interface SkillDownloadChange {
 export interface SkillsDownloadResult {
     /** Skill names that had at least one file written */
     downloaded: string[];
+    /** Local active copies removed after the cloud skill was archived. */
+    removed: string[];
     /** Skill names where local and cloud copies were already identical */
     skipped: string[];
     /** Skill names skipped after the user rejected overwrite */