evolcore 0.0.10 → 0.0.12

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

@@ -21,6 +21,82 @@ 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 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 +110,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 +118,15 @@ 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',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'role', 'agent'],
+        description: '查询当前推理努力度',
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
     },
     {
         id: 'model.info',
@@ -66,7 +150,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',
@@ -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.reset',
@@ -181,6 +265,30 @@ const OPERATIONS = [
         description: '列出会话',
         sources: ['slash', 'menu'],
     },
+    {
+        id: 'session.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation'],
+        description: '查看当前会话状态',
+        sources: ['slash', 'menu', 'agent-tool'],
+    },
+    {
+        id: 'session.topic.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation'],
+        description: '查看当前关系下的话题会话状态',
+        sources: ['menu'],
+    },
+    {
+        id: 'session.topic.list',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation'],
+        description: '列出当前关系下的话题会话',
+        sources: ['menu'],
+    },
     {
         id: 'session.create',
         category: 'write-own',
@@ -195,7 +303,7 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['relation'],
         description: '重命名会话',
-        sources: ['slash', 'menu'],
+        sources: ['slash', 'menu', 'agent-tool'],
     },
     {
         id: 'session.delete',
@@ -206,6 +314,14 @@ const OPERATIONS = [
         sources: ['slash', 'menu'],
     },
     // ── File Operations ──
+    {
+        id: 'project.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: '查看当前项目摘要',
+        sources: ['menu', 'agent-tool'],
+    },
     {
         id: 'file.list',
         category: 'read',
@@ -425,6 +541,30 @@ const OPERATIONS = [
         description: '查看 agent 详情（敏感信息）',
         sources: ['menu', 'menu.cli', 'control'],
     },
+    {
+        id: 'agent.baseagent.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent', 'control'],
+        description: '查看当前 Agent 使用的 BaseAgent',
+        sources: ['menu', 'control'],
+    },
+    {
+        id: 'agent.baseagent.list',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['agent', 'control'],
+        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',
@@ -449,6 +589,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',
@@ -464,7 +612,47 @@ const OPERATIONS = [
         dangerous: false,
         defaultScopes: ['process'],
         description: '查看系统状态（敏感信息）',
-        sources: ['slash', 'menu', 'menu.cli'],
+        sources: ['slash', 'menu', 'menu.cli', 'agent-tool'],
+    },
+    {
+        id: 'activity.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: '查看当前中间活动显示策略',
+        sources: ['menu'],
+    },
+    {
+        id: 'activity.update',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['relation', 'agent'],
+        description: '更新中间活动显示策略',
+        sources: ['menu'],
+    },
+    {
+        id: 'observable.current',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: '查看当前 Agent 观察者模式',
+        sources: ['menu', 'control'],
+    },
+    {
+        id: 'observable.update',
+        category: 'write-agent',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: '更新当前 Agent 观察者模式',
+        sources: ['menu'],
+    },
+    {
+        id: 'capability.read',
+        category: 'read',
+        dangerous: false,
+        defaultScopes: ['agent'],
+        description: '查看当前 Agent 的能力策略摘要',
+        sources: ['menu', 'control'],
     },
     {
         id: 'system.restart',
@@ -569,41 +757,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 ──
     {
@@ -665,6 +853,52 @@ const OPERATIONS = [
     // ── EC Command Operations ──
     // EC daemon 入口根据结构化 IPC 请求构造 operation；Runner 不解析 EC 子命令。
     ...CONFIG_MANAGEMENT_OPERATIONS,
+    ...GROUP_MANAGEMENT_OPERATIONS,
+    ...MSG_READ_OPERATIONS,
+    ...GROUP_FS_READ_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',
@@ -699,20 +933,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

@@ -0,0 +1,68 @@
+import fs from 'fs';
+import { agentMdPath, resolvePaths } from '../paths.js';
+import { parseAgentDisplayName, resolveAgentDisplayName } from '../aun/aid/agentmd.js';
+import { generateWelcomeMessage } from '../utils/welcome.js';
+import * as outbox from '../aun/outbox.js';
+import { chatDirPath } from './session/session-fs-store.js';
+import { hasMessageLogOperation } from './message/message-log.js';
+export const BOOTSTRAP_MESSAGE_TTL_MS = 30 * 24 * 60 * 60 * 1000;
+export function bootstrapInitialMessageOperationId(aid) {
+    return `bootstrap-initial:v1:${aid}`;
+}
+export function postBootstrapWelcomeOperationId(aid) {
+    return `bootstrap-complete:v1:${aid}`;
+}
+export function renderPostBootstrapWelcome(aid, owner, ownerName) {
+    const mdPath = agentMdPath(aid);
+    const agentMd = fs.existsSync(mdPath) ? fs.readFileSync(mdPath, 'utf-8') : '';
+    const agentName = parseAgentDisplayName(agentMd)
+        || resolveAgentDisplayName(aid)
+        || aid.split('.')[0];
+    const fallbackOwnerName = owner.replace(/^@/, '').split('.')[0];
+    return generateWelcomeMessage({
+        channelType: 'aun',
+        agentName,
+        ownerName: ownerName || fallbackOwnerName,
+        includeBindingNote: true,
+    });
+}
+export function preparePostBootstrapWelcomeOutbox(aid, owner, ownerName) {
+    const operationId = postBootstrapWelcomeOperationId(aid);
+    const chatDir = chatDirPath(resolvePaths().sessionsDir, 'aun', owner, aid);
+    if (hasMessageLogOperation(chatDir, operationId))
+        return;
+    outbox.enqueue(aid, {
+        channelId: owner,
+        dedupeKey: operationId,
+        critical: true,
+        type: 'text',
+        text: renderPostBootstrapWelcome(aid, owner, ownerName),
+        ttl: BOOTSTRAP_MESSAGE_TTL_MS,
+        context: {
+            metadata: {
+                source: 'daemon',
+                chatmode: 'interactive',
+                persistRequired: true,
+                operationId,
+            },
+        },
+    });
+}
+export function hasPendingPostBootstrapWelcomeOutbox(aid) {
+    return !!outbox.findByDedupeKey(aid, postBootstrapWelcomeOperationId(aid));
+}
+/** 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)
+        return false;
+    if (entry.context?.sessionId === sessionId)
+        return true;
+    return outbox.replace(aid, {
+        ...entry,
+        context: {
+            ...(entry.context ?? {}),
+            sessionId,
+        },
+    });
+}

package/dist/core/bootstrap-service.js

@@ -9,6 +9,95 @@ import { normalizeAgentLifecycle, withLifecycleForWrite } from '../config/lifecy
 import { renderTemplate } from '../eck/manifest-engine.js';
 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, 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 {
+                ok: false,
+                code: 'WELCOME_CHANNEL_UNAVAILABLE',
+                error: `No AUN channel available to persist the post-bootstrap welcome for ${aid}`,
+                reloaded: false,
+            };
+        }
+        if (!await welcome.preparePostBootstrapWelcome()) {
+            return {
+                ok: false,
+                code: 'WELCOME_PREPARE_FAILED',
+                error: `Failed to persist the post-bootstrap welcome for ${aid}`,
+                reloaded: false,
+            };
+        }
+    }
+    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,
+            mainSessionId: mainSession?.sessionId,
+            mainSessionCreated: mainSession?.created,
+        };
+    }
+    const welcomeQueued = await welcome.reconcilePostBootstrapWelcome();
+    return {
+        ...result,
+        reloaded: true,
+        welcomeQueued,
+        mainSessionId: mainSession?.sessionId,
+        mainSessionCreated: mainSession?.created,
+    };
+}
 export class BootstrapService {
     agentRegistry;
     eventBus;
@@ -29,23 +118,25 @@ export class BootstrapService {
             return false;
         this.inFlight.add(key);
         let lifecycleStarted = false;
-        const loadedConfig = agent?.config || loadAgent(aid);
+        const loadedConfig = loadAgent(aid) || agent?.config;
         if (!loadedConfig) {
             this.inFlight.delete(key);
             return false;
         }
         const config = normalizeAgentLifecycle(loadedConfig);
-        if (config.lifecycle !== 'created') {
+        if (config.lifecycle === 'active') {
             this.inFlight.delete(key);
             return false;
         }
+        const starting = config.lifecycle === 'created';
         const channelType = ctx.channelType || this.channelTypeFromKey(ctx.channelKey);
-        const recipientId = ctx.recipientId || this.resolveConfiguredRecipient(config, ctx.channelKey, channelType);
+        const configuredRecipient = this.resolveConfiguredRecipient(config, ctx.channelKey, channelType);
+        const recipientId = ctx.recipientId || configuredRecipient;
         if (!recipientId) {
             this.inFlight.delete(key);
             return false;
         }
-        if (ctx.recipientId && recipientId !== ctx.recipientId) {
+        if (ctx.recipientId && configuredRecipient !== ctx.recipientId) {
             this.inFlight.delete(key);
             return false;
         }
@@ -57,9 +148,11 @@ export class BootstrapService {
         try {
             const agentName = this.resolveAgentDisplayName(aid);
             const baseagent = this.resolveBaseagent(agent, aid);
-            await this.publishAgentMdIfSupported(ctx.adapter, aid, agentName);
-            this.setLifecycle(agent, aid, 'bootstrapping');
-            lifecycleStarted = true;
+            if (starting) {
+                await this.publishAgentMdIfSupported(ctx.adapter, aid, agentName);
+                this.setLifecycle(agent, aid, 'bootstrapping');
+                lifecycleStarted = true;
+            }
             const text = this.renderWelcome({
                 agentAid: aid,
                 agentName,
@@ -72,9 +165,23 @@ export class BootstrapService {
                 channel: ctx.adapter.channelKey || ctx.adapter.channelName,
                 channelId,
                 agentName: aid,
+                replyContext: {
+                    metadata: {
+                        source: 'daemon',
+                        persistRequired: true,
+                        operationId: bootstrapInitialMessageOperationId(aid),
+                        outboxTtl: BOOTSTRAP_MESSAGE_TTL_MS,
+                        criticalDelivery: true,
+                    },
+                },
             }), { kind: 'result.text', text, isFinal: true });
-            this.eventBus.publish({ type: 'agent:bootstrap-started', aid, channel: channelType || ctx.channelKey, timestamp: Date.now() });
-            logger.info(`[Bootstrap] Started for ${aid} via ${ctx.channelKey} (${ctx.source})`);
+            if (starting) {
+                this.eventBus.publish({ type: 'agent:bootstrap-started', aid, channel: channelType || ctx.channelKey, timestamp: Date.now() });
+                logger.info(`[Bootstrap] Started for ${aid} via ${ctx.channelKey} (${ctx.source})`);
+            }
+            else {
+                logger.info(`[Bootstrap] Reconciled initial message for ${aid} via ${ctx.channelKey} (${ctx.source})`);
+            }
             return true;
         }
         catch (e) {
@@ -93,6 +200,33 @@ export class BootstrapService {
             this.inFlight.delete(key);
         }
     }
+    completeBootstrap(aid) {
+        const agent = this.agentRegistry.get(aid);
+        const loadedConfig = loadAgent(aid) || agent?.config;
+        if (!loadedConfig)
+            return { ok: false, error: `Agent "${aid}" not found` };
+        const lifecycle = normalizeAgentLifecycle(loadedConfig).lifecycle;
+        if (lifecycle === 'active')
+            return { ok: true, aid, transitioned: false };
+        if (lifecycle !== 'bootstrapping') {
+            return {
+                ok: false,
+                code: 'INVALID_LIFECYCLE',
+                error: `Agent "${aid}" is ${lifecycle}; only a bootstrapping agent can become ready`,
+            };
+        }
+        this.setLifecycle(agent, aid, 'active');
+        this.eventBus.publish({ type: 'agent:bootstrap-complete', aid, timestamp: Date.now() });
+        logger.info(`[Bootstrap] Completed for ${aid} (previous lifecycle=${lifecycle})`);
+        return { ok: true, aid, transitioned: true };
+    }
+    lifecycleOf(aid) {
+        const agent = this.agentRegistry.get(aid);
+        const loadedConfig = loadAgent(aid) || agent?.config;
+        return loadedConfig
+            ? normalizeAgentLifecycle(loadedConfig).lifecycle
+            : null;
+    }
     setLifecycle(agent, aid, lifecycle) {
         if (agent?.setLifecycle) {
             agent.setLifecycle(lifecycle);
@@ -100,7 +234,7 @@ export class BootstrapService {
         }
         const cfg = loadAgent(aid);
         if (!cfg)
-            return;
+            throw new Error(`Agent "${aid}" disappeared while updating lifecycle`);
         saveAgent(withLifecycleForWrite(cfg, lifecycle));
     }
     resolveConfiguredRecipient(config, _channelKey, _channelType) {