evolcore 0.0.11 → 0.0.13

package/dist/core/auth/operation-catalog.js

@@ -21,6 +21,90 @@ const CONFIG_MANAGEMENT_OPERATIONS = [
     description,
     sources: ['menu.cli', 'agent-tool', 'control'],
 }));
+const GROUP_MANAGEMENT_OPERATIONS = [
+    ['ec.group.list', 'read', ['agent'], 'List groups joined by the current Agent'],
+    ['ec.group.info', 'read', ['relation', 'agent'], 'Read group information'],
+    ['ec.group.pull', 'read', ['relation', 'agent'], 'Pull group messages'],
+    ['ec.group.members', 'read', ['relation', 'agent'], 'List group members'],
+    ['ec.group.online', 'read', ['relation', 'agent'], 'List online group members'],
+    ['ec.group.rules.get', 'read', ['relation', 'agent'], 'Read the published group rules file'],
+    ['ec.group.rules.read', 'read', ['relation', 'agent'], 'Read legacy group join rules'],
+    ['ec.group.create', 'write-agent', ['agent'], 'Create a group as the current Agent'],
+    ['ec.group.ack', 'write-agent', ['agent'], 'Advance the current Agent group cursor'],
+    ['ec.group.update', 'write-agent', ['agent'], 'Update group metadata'],
+    ['ec.group.dissolve', 'write-agent', ['agent'], 'Dissolve a group'],
+    ['ec.group.suspend', 'write-agent', ['agent'], 'Suspend a group'],
+    ['ec.group.resume', 'write-agent', ['agent'], 'Resume a group'],
+    ['ec.group.join', 'write-agent', ['agent'], 'Request to join a group'],
+    ['ec.group.leave', 'write-agent', ['agent'], 'Leave a group'],
+    ['ec.group.invite', 'write-agent', ['agent'], 'Invite group members'],
+    ['ec.group.kick', 'write-agent', ['agent'], 'Remove a group member'],
+    ['ec.group.role', 'write-agent', ['agent'], 'Change a group member role'],
+    ['ec.group.owner', 'write-agent', ['agent'], 'Transfer group ownership'],
+    ['ec.group.ban', 'write-agent', ['agent'], 'Read or update the group ban list'],
+    ['ec.group.unban', 'write-agent', ['agent'], 'Remove a group ban'],
+    ['ec.group.rules.set', 'write-agent', ['agent'], 'Upload and publish group rules content'],
+    ['ec.group.rules.publish', 'write-agent', ['agent'], 'Publish the current group rules file'],
+    ['ec.group.rules.update', 'write-agent', ['agent'], 'Update group join rules'],
+].map(([id, category, defaultScopes, description]) => ({
+    id,
+    category,
+    dangerous: false,
+    defaultScopes,
+    description,
+    sources: ['agent-tool'],
+}));
+const MSG_READ_OPERATIONS = [
+    ['ec.msg.history', 'Read message history for an AUN private relation'],
+    ['ec.msg.online', 'Read online status for an AUN private relation'],
+].map(([id, description]) => ({
+    id,
+    category: 'read',
+    dangerous: false,
+    defaultScopes: ['relation', 'agent'],
+    description,
+    sources: ['agent-tool'],
+}));
+const GROUP_FS_READ_OPERATIONS = ['ls', 'stat', 'lstat', 'cat', 'find', 'df'].map(kind => ({
+    id: `ec.fs.${kind}`,
+    category: 'read',
+    dangerous: false,
+    defaultScopes: ['relation', 'agent'],
+    description: `Read current group filesystem (${kind})`,
+    sources: ['agent-tool'],
+}));
+const GROUP_FS_WRITE_OPERATIONS = ['mkdir', 'upload', 'copy', 'move', 'remove'].map(kind => ({
+    id: `ec.fs.${kind}`,
+    category: 'write-own',
+    dangerous: false,
+    defaultScopes: ['relation'],
+    description: `Write current group filesystem (${kind})`,
+    sources: ['agent-tool'],
+}));
+const HANDOFF_READ_OPERATIONS = ['status', 'list', 'trace'].map(kind => ({
+    id: `ec.handoff.${kind}`,
+    category: 'read',
+    dangerous: false,
+    defaultScopes: ['relation', 'agent'],
+    description: `Read handoff ${kind}`,
+    sources: ['agent-tool'],
+}));
+const HANDOFF_WRITE_OPERATIONS = [{
+        id: 'ec.handoff.return',
+        category: 'write-own',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: 'Return the current handoff result',
+        sources: ['agent-tool'],
+    }];
+const QUEUE_OPERATIONS = [['read', 'Read the current Agent message queue'], ['clear', 'Clear the current Agent message queue'], ['cancel', 'Cancel a current Agent queued message'], ['interrupt', 'Interrupt a current Agent session']].map(([kind, description]) => ({
+    id: `ec.queue.${kind}`,
+    category: kind === 'read' ? 'read' : 'write-agent',
+    dangerous: false,
+    defaultScopes: ['agent'],
+    description,
+    sources: ['agent-tool'],
+}));
 /**
  * Operation Catalog - 所有命令操作的元数据定义
  *
@@ -34,7 +118,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'role', 'agent'],
         description: '列出可用模型',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.current',
@@ -42,7 +126,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'role', 'agent'],
         description: '查询当前使用的模型',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.effort.current',
@@ -50,7 +134,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'role', 'agent'],
         description: '查询当前推理努力度',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.info',
@@ -74,7 +158,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'role', 'agent'],
         description: '切换使用的模型',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.effort',
@@ -82,7 +166,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'role', 'agent'],
         description: '设置推理努力度',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.reset',
@@ -195,7 +279,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation'],
         description: '查看当前会话状态',
-        sources: ['slash', 'menu'],
+        sources: ['slash', 'menu', 'agent-tool'],
     },
     {
         id: 'session.topic.current',
@@ -227,7 +311,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation'],
         description: '重命名会话',
-        sources: ['slash', 'menu'],
+        sources: ['slash', 'menu', 'agent-tool'],
     },
     {
         id: 'session.delete',
@@ -244,7 +328,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation', 'agent'],
         description: '查看当前项目摘要',
-        sources: ['menu'],
+        sources: ['menu', 'agent-tool'],
     },
     {
         id: 'file.list',
@@ -481,6 +565,14 @@ const OPERATIONS = [
         description: '列出当前 Agent 可用的 BaseAgent',
         sources: ['menu', 'control'],
     },
+    {
+        id: 'agent.baseagent.update',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: '切换当前 Agent 使用的 BaseAgent',
+        sources: ['menu'],
+    },
     {
         id: 'agent.getConfig',
         category: 'read',
@@ -505,6 +597,14 @@ const OPERATIONS = [
         description: '重载 agent 配置',
         sources: ['slash', 'menu', 'control'],
     },
+    {
+        id: 'agent.bootstrapComplete',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: 'Complete bootstrap for the current Agent',
+        sources: ['agent-tool'],
+    },
     {
         id: 'agent.delete',
         category: 'dangerous',
@@ -520,7 +620,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['process'],
         description: '查看系统状态（敏感信息）',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'activity.current',
@@ -530,6 +630,14 @@ const OPERATIONS = [
         description: '查看当前中间活动显示策略',
         sources: ['menu'],
     },
+    {
+        id: 'activity.update',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: '更新中间活动显示策略',
+        sources: ['menu'],
+    },
     {
         id: 'observable.current',
         category: 'read',
@@ -538,6 +646,14 @@ const OPERATIONS = [
         description: '查看当前 Agent 观察者模式',
         sources: ['menu', 'control'],
     },
+    {
+        id: 'observable.update',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: '更新当前 Agent 观察者模式',
+        sources: ['menu'],
+    },
     {
         id: 'capability.read',
         category: 'read',
@@ -649,41 +765,41 @@ const OPERATIONS = [
         id: 'storage.list',
         category: 'read',
         dangerous: false,
-        defaultScopes: ['control'],
+        defaultScopes: ['agent', 'control'],
         description: '列出存储对象（敏感信息）',
-        sources: ['menu.cli', 'control'],
+        sources: ['menu.cli', 'agent-tool', 'control'],
     },
     {
         id: 'storage.quota',
         category: 'read',
         dangerous: false,
-        defaultScopes: ['control'],
+        defaultScopes: ['agent', 'control'],
         description: '查看存储配额（敏感信息）',
-        sources: ['menu.cli', 'control'],
+        sources: ['menu.cli', 'agent-tool', 'control'],
     },
     {
         id: 'storage.upload',
         category: 'write-agent',
         dangerous: true,
-        defaultScopes: ['control'],
+        defaultScopes: ['agent', 'control'],
         description: '上传文件到云存储',
-        sources: ['menu.cli', 'control'],
+        sources: ['menu.cli', 'agent-tool', 'control'],
     },
     {
         id: 'storage.download',
         category: 'write-agent',
         dangerous: true,
-        defaultScopes: ['control'],
+        defaultScopes: ['agent', 'control'],
         description: '从云存储下载文件',
-        sources: ['menu.cli', 'control'],
+        sources: ['menu.cli', 'agent-tool', 'control'],
     },
     {
         id: 'storage.delete',
         category: 'dangerous',
         dangerous: true,
-        defaultScopes: ['control'],
+        defaultScopes: ['agent', 'control'],
         description: '删除云存储对象',
-        sources: ['menu.cli', 'control'],
+        sources: ['menu.cli', 'agent-tool', 'control'],
     },
     // ── Gateway & Config Operations ──
     {
@@ -745,6 +861,53 @@ const OPERATIONS = [
     // ── EC Command Operations ──
     // EC daemon 入口根据结构化 IPC 请求构造 operation；Runner 不解析 EC 子命令。
     ...CONFIG_MANAGEMENT_OPERATIONS,
+    ...GROUP_MANAGEMENT_OPERATIONS,
+    ...MSG_READ_OPERATIONS,
+    ...GROUP_FS_READ_OPERATIONS,
+    ...GROUP_FS_WRITE_OPERATIONS,
+    ...HANDOFF_READ_OPERATIONS,
+    ...HANDOFF_WRITE_OPERATIONS,
+    ...QUEUE_OPERATIONS,
+    {
+        id: 'ec.version',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent', 'process'],
+        description: 'Read local EvolCore component versions',
+        sources: ['menu.cli', 'agent-tool'],
+    },
+    {
+        id: 'ec.aid.show',
+        category: 'read',
+        dangerous: true,
+        defaultScopes: ['relation', 'agent'],
+        description: 'Inspect the current Agent local AID identity and signing state',
+        sources: ['agent-tool'],
+    },
+    {
+        id: 'ec.aid.lookup',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: 'Look up the current Agent public AID record',
+        sources: ['agent-tool'],
+    },
+    {
+        id: 'ec.aid.agentmd.get',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: 'Read and verify the current Agent public agent.md',
+        sources: ['agent-tool'],
+    },
+    {
+        id: 'ec.aid.agentmd.put',
+        category: 'write-agent',
+        dangerous: true,
+        defaultScopes: ['agent'],
+        description: 'Sign and publish the current Agent local agent.md',
+        sources: ['agent-tool'],
+    },
     {
         id: 'ec.msg.send',
         category: 'write-own',
@@ -779,20 +942,28 @@ const OPERATIONS = [
     },
     {
         id: 'ec.ctl.send',
-        category: 'write-agent',
+        category: 'write-own',
         dangerous: false,
-        defaultScopes: ['control', 'agent'],
-        description: '通过 ec ctl send 发送控制通道消息',
+        defaultScopes: ['relation'],
+        description: '通过 ec ctl send 向当前会话发送消息',
         sources: ['agent-tool'],
     },
     {
         id: 'ec.ctl.file',
-        category: 'write-agent',
+        category: 'write-own',
         dangerous: false,
-        defaultScopes: ['control', 'agent'],
-        description: '通过 ec ctl file 发送控制通道文件',
+        defaultScopes: ['relation'],
+        description: '通过 ec ctl file 向当前会话发送项目文件',
         sources: ['agent-tool'],
     },
+    ...['read', 'clear', 'cancel', 'interrupt'].map(action => ({
+        id: `ec.ctl.queue.${action}`,
+        category: action === 'read' ? 'read' : 'write-own',
+        dangerous: false,
+        defaultScopes: ['relation'],
+        description: `${action} the current managed session queue`,
+        sources: ['agent-tool'],
+    })),
     // ── Raw CLI & Shell Execution ──
     {
         id: 'cli.exec.raw',

package/dist/core/bootstrap-messages.js

@@ -31,14 +31,21 @@ export function preparePostBootstrapWelcomeOutbox(aid, owner, ownerName) {
     const chatDir = chatDirPath(resolvePaths().sessionsDir, 'aun', owner, aid);
     if (hasMessageLogOperation(chatDir, operationId))
         return;
+    const existing = outbox.findByDedupeKey(aid, operationId);
+    if (existing?.delivery?.chatType === 'private' && existing.channelId === owner)
+        return;
+    if (existing)
+        outbox.remove(aid, existing.id);
     outbox.enqueue(aid, {
         channelId: owner,
+        delivery: { chatType: 'private' },
         dedupeKey: operationId,
         critical: true,
         type: 'text',
         text: renderPostBootstrapWelcome(aid, owner, ownerName),
         ttl: BOOTSTRAP_MESSAGE_TTL_MS,
         context: {
+            delivery: { chatType: 'private' },
             metadata: {
                 source: 'daemon',
                 chatmode: 'interactive',
@@ -48,3 +55,21 @@ export function preparePostBootstrapWelcomeOutbox(aid, owner, ownerName) {
         },
     });
 }
+export function hasPendingPostBootstrapWelcomeOutbox(aid) {
+    return outbox.findByDedupeKey(aid, postBootstrapWelcomeOperationId(aid))?.delivery?.chatType === 'private';
+}
+/** Bind the durable completion welcome to the fresh post-bootstrap session. */
+export function bindPostBootstrapWelcomeOutboxSession(aid, sessionId) {
+    const entry = outbox.findByDedupeKey(aid, postBootstrapWelcomeOperationId(aid));
+    if (!entry || entry.delivery?.chatType !== 'private')
+        return false;
+    if (entry.context?.sessionId === sessionId)
+        return true;
+    return outbox.replace(aid, {
+        ...entry,
+        context: {
+            ...(entry.context ?? {}),
+            sessionId,
+        },
+    });
+}

package/dist/core/bootstrap-service.js

@@ -11,8 +11,12 @@ import { activeBaseagent } from './model/config-scope.js';
 import { buildEnvelope } from './message/message-utils.js';
 import { BOOTSTRAP_MESSAGE_TTL_MS, bootstrapInitialMessageOperationId } from './bootstrap-messages.js';
 /** Coordinate the write-ahead completion welcome with the lifecycle commit. */
-export async function completeBootstrapWithWelcome(service, aid, welcome) {
+export async function completeBootstrapWithWelcome(service, aid, welcome, sessions) {
     const lifecycle = service.lifecycleOf(aid);
+    if (lifecycle !== 'bootstrapping' && lifecycle !== 'active') {
+        const result = service.completeBootstrap(aid);
+        return { ...result, reloaded: false };
+    }
     if (lifecycle === 'bootstrapping') {
         if (!welcome) {
             return {
@@ -31,13 +35,68 @@ export async function completeBootstrapWithWelcome(service, aid, welcome) {
             };
         }
     }
+    const welcomePending = welcome
+        ? await welcome.hasPendingPostBootstrapWelcome()
+        : false;
+    const needsMainSessionBoundary = lifecycle === 'bootstrapping' || welcomePending;
+    let mainSession;
+    if (needsMainSessionBoundary) {
+        if (!sessions) {
+            return {
+                ok: false,
+                code: 'MAIN_SESSION_UNAVAILABLE',
+                error: `No session coordinator available to create the post-bootstrap main session for ${aid}`,
+                reloaded: false,
+            };
+        }
+        try {
+            mainSession = await sessions.ensurePostBootstrapMainSession();
+        }
+        catch (e) {
+            return {
+                ok: false,
+                code: 'MAIN_SESSION_CREATE_FAILED',
+                error: e instanceof Error ? e.message : `Failed to create the post-bootstrap main session for ${aid}`,
+                reloaded: false,
+            };
+        }
+        if (!mainSession.sessionId) {
+            return {
+                ok: false,
+                code: 'MAIN_SESSION_CREATE_FAILED',
+                error: `Failed to create the post-bootstrap main session for ${aid}`,
+                reloaded: false,
+            };
+        }
+        if (welcomePending && welcome && !await welcome.bindPostBootstrapWelcomeToSession(mainSession.sessionId)) {
+            return {
+                ok: false,
+                code: 'WELCOME_SESSION_BIND_FAILED',
+                error: `Failed to bind the post-bootstrap welcome to session ${mainSession.sessionId}`,
+                reloaded: false,
+            };
+        }
+    }
     const result = service.completeBootstrap(aid);
     if (!result.ok)
         return { ...result, reloaded: false };
-    if (!welcome)
-        return { ...result, reloaded: true, welcomeQueued: false };
+    if (!welcome) {
+        return {
+            ...result,
+            reloaded: true,
+            welcomeQueued: false,
+            mainSessionId: mainSession?.sessionId,
+            mainSessionCreated: mainSession?.created,
+        };
+    }
     const welcomeQueued = await welcome.reconcilePostBootstrapWelcome();
-    return { ...result, reloaded: true, welcomeQueued };
+    return {
+        ...result,
+        reloaded: true,
+        welcomeQueued,
+        mainSessionId: mainSession?.sessionId,
+        mainSessionCreated: mainSession?.created,
+    };
 }
 export class BootstrapService {
     agentRegistry;
@@ -107,6 +166,7 @@ export class BootstrapService {
                 channelId,
                 agentName: aid,
                 replyContext: {
+                    delivery: { chatType: 'private' },
                     metadata: {
                         source: 'daemon',
                         persistRequired: true,

package/dist/core/capability/providers/claude-capability-provider.js

@@ -2,6 +2,7 @@ import fs from 'fs';
 import os from 'os';
 import path from 'path';
 import { execFileSync } from 'child_process';
+import { discoverSkillDirectories } from '../skill-discovery.js';
 function readJson(file) {
     try {
         if (!fs.existsSync(file))
@@ -12,31 +13,6 @@ function readJson(file) {
         return null;
     }
 }
-function listDirectories(dir) {
-    try {
-        if (!fs.existsSync(dir))
-            return [];
-        return fs.readdirSync(dir, { withFileTypes: true })
-            .filter(entry => entry.isDirectory())
-            .map(entry => entry.name);
-    }
-    catch {
-        return [];
-    }
-}
-function readSkillDescription(skillDir) {
-    const file = path.join(skillDir, 'SKILL.md');
-    try {
-        const text = fs.readFileSync(file, 'utf-8');
-        const firstBodyLine = text.split(/\r?\n/)
-            .map(line => line.trim())
-            .find(line => line && !line.startsWith('#') && !line.startsWith('---') && !line.includes(':'));
-        return firstBodyLine ? firstBodyLine.slice(0, 180) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
 function describeMcpSpec(spec) {
     const command = typeof spec?.command === 'string' ? spec.command : undefined;
     if (command)
@@ -60,14 +36,15 @@ function discoverSkills(projectPath) {
     const seen = new Set();
     const items = [];
     for (const root of roots) {
-        for (const name of listDirectories(root.dir)) {
-            if (seen.has(name))
+        for (const skill of discoverSkillDirectories(root.dir)) {
+            const { id } = skill;
+            if (seen.has(id))
                 continue;
-            seen.add(name);
+            seen.add(id);
             items.push({
-                id: name,
-                label: name,
-                desc: readSkillDescription(path.join(root.dir, name)),
+                id,
+                label: id,
+                desc: skill.description,
                 source: root.source,
             });
         }
@@ -138,6 +115,7 @@ async function discoverPluginsFromCli() {
             encoding: 'utf-8',
             timeout: 3000,
             stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: process.platform === 'win32',
         });
         const parsed = JSON.parse(output);
         const list = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.installed) ? parsed.installed : [];

package/dist/core/capability/providers/codex-capability-provider.js

@@ -1,19 +1,7 @@
-import fs from 'fs';
 import os from 'os';
 import path from 'path';
 import { execCodexCliSync } from '../../../utils/codex-cli.js';
-function listDirectories(dir) {
-    try {
-        if (!fs.existsSync(dir))
-            return [];
-        return fs.readdirSync(dir, { withFileTypes: true })
-            .filter(entry => entry.isDirectory())
-            .map(entry => entry.name);
-    }
-    catch {
-        return [];
-    }
-}
+import { discoverSkillDirectories } from '../skill-discovery.js';
 function discoverSkills(ctx) {
     const roots = [
         { dir: path.join(ctx.projectPath, '.codex', 'skills'), source: 'project' },
@@ -23,11 +11,12 @@ function discoverSkills(ctx) {
     const seen = new Set();
     const out = [];
     for (const root of roots) {
-        for (const id of listDirectories(root.dir)) {
+        for (const skill of discoverSkillDirectories(root.dir)) {
+            const { id } = skill;
             if (seen.has(id))
                 continue;
             seen.add(id);
-            out.push({ id, label: id, source: root.source });
+            out.push({ id, label: id, desc: skill.description, source: root.source });
         }
     }
     return out;

package/dist/core/capability/skill-discovery.js

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+import { parseDocument } from 'yaml';
+function readSkillMetadata(skillDir) {
+    const skillFile = path.join(skillDir, 'SKILL.md');
+    try {
+        if (!fs.statSync(skillFile).isFile())
+            return undefined;
+        const text = fs.readFileSync(skillFile, 'utf-8');
+        const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+        if (!match)
+            return undefined;
+        const document = parseDocument(match[1]);
+        if (document.errors.length > 0)
+            return undefined;
+        const metadata = document.toJS();
+        if (typeof metadata?.name !== 'string' || !metadata.name.trim())
+            return undefined;
+        if (typeof metadata.description !== 'string' || !metadata.description.trim())
+            return undefined;
+        return {
+            id: metadata.name.trim(),
+            description: metadata.description.trim(),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Return only directories that satisfy the Codex/Claude skill file contract. */
+export function discoverSkillDirectories(root) {
+    try {
+        if (!fs.existsSync(root))
+            return [];
+        return fs.readdirSync(root, { withFileTypes: true })
+            .filter(entry => !entry.name.startsWith('.'))
+            .filter(entry => entry.isDirectory() || entry.isSymbolicLink())
+            .map(entry => {
+            const dir = path.join(root, entry.name);
+            try {
+                if (!fs.statSync(dir).isDirectory())
+                    return undefined;
+            }
+            catch {
+                return undefined;
+            }
+            const metadata = readSkillMetadata(dir);
+            return metadata;
+        })
+            .filter((entry) => Boolean(entry));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/core/channel-loader.js

@@ -196,7 +196,7 @@ export function buildReloadHooks(deps) {
             if (!handoffRuntime)
                 return;
             try {
-                await handoffRuntime.recover([aid]);
+                await handoffRuntime.recover([aid], { discardExpired: false });
             }
             finally {
                 handoffRuntime.resumeAgent(aid);