evolcore 0.0.10 → 0.0.12

package/dist/channels/daemon.js

@@ -415,7 +415,11 @@ function normalizeExecutionAnomaly(value) {
         : Date.now();
     const toolName = nonEmptyString(value.toolName);
     const requestId = nonEmptyString(value.requestId);
+    const policyCode = nonEmptyString(value.policyCode);
     const policy = normalizeApproverPolicy(value.policy);
+    const agentAid = nonEmptyString(value.agentAid);
+    const sessionId = nonEmptyString(value.sessionId);
+    const permissionMode = normalizePermissionMode(value.permissionMode);
     const summary = nonEmptyString(value.summary);
     return {
         code: code,
@@ -425,7 +429,11 @@ function normalizeExecutionAnomaly(value) {
         effect,
         ...(toolName ? { toolName } : {}),
         ...(requestId ? { requestId } : {}),
+        ...(policyCode ? { policyCode } : {}),
         ...(policy ? { policy } : {}),
+        ...(agentAid ? { agentAid } : {}),
+        ...(sessionId ? { sessionId } : {}),
+        ...(permissionMode ? { permissionMode } : {}),
         ...(summary ? { summary: summary.slice(0, 512) } : {}),
     };
 }
@@ -437,3 +445,8 @@ function normalizeApproverPolicy(value) {
         ? value
         : undefined;
 }
+function normalizePermissionMode(value) {
+    return value === 'readonly' || value === 'auto' || value === 'request' || value === 'bypass'
+        ? value
+        : undefined;
+}

package/dist/cli/agent-command.js

@@ -59,6 +59,13 @@ Options:
   ec agent delete mybot.agentid.pub --purge`);
         return;
     }
+    if (process.env.EVOLCORE_SESSION_ID && !wantsHelp(args) && !new Set(['get', 'set', 'ready']).has(sub)) {
+        if (formatJson)
+            console.log(JSON.stringify({ ok: false, code: 'NOT_ALLOWED', error: `agent ${sub} is not available in a managed task` }));
+        else
+            console.error(`❌ [NOT_ALLOWED] agent ${sub} is not available in a managed task`);
+        process.exit(1);
+    }
     const { agentList, agentShow, agentCreateInteractive, agentCreateNonInteractive, agentReload, agentEnable, agentDisable, agentGet, agentSet, agentRename, agentDelete, agentReady, } = await import('./agent.js');
     // --- list ---
     if (sub === 'list') {
@@ -137,17 +144,21 @@ Options:
      ec agent new <aid> --non-interactive [选项]
 
 非交互模式选项:
-  --baseagent <claude|codex|gemini|ecagent>   默认: PATH 中第一个可用；ecagent 需显式选择
-  --project <absolute path>           必填
-  --owner <aid>
-  --name <display-name>
-  --description <text>
+  --project <path>                    默认: 当前目录
+  --baseagent <claude|codex|gemini|ecagent>
+                                      默认: defaults 配置，否则检测本机可用基座
+  --owner <aid>                       默认: daemon.json 第一个 owner
+  --name <display-name>               默认: package.json name，否则目录名
+  --description <text>                默认: package.json description，否则留空
+  --dry-run                           只预览最终参数，不注册 AID、不写文件
   --force                             覆盖已有 config.json
   --format json                       输出 JSON
 
 示例:
   ec agent new mybot.agentid.pub
-  ec agent new mybot.agentid.pub --non-interactive --project /abs/path --baseagent claude`);
+  ec agent new mybot.agentid.pub --non-interactive
+  ec agent new mybot.agentid.pub --non-interactive --dry-run --format json
+  ec agent new mybot.agentid.pub --non-interactive --project ../project --baseagent claude`);
             return;
         }
         const name = args[1];
@@ -161,15 +172,52 @@ Options:
                 const idx = args.indexOf(flag);
                 return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
             };
-            const result = await agentCreateNonInteractive({
+            const { resolveAgentCreatePlan, validateAgentCreatePlan } = await import('./agent.js');
+            const plan = resolveAgentCreatePlan({
                 aid: name,
+                project: getArg('--project'),
                 baseagent: getArg('--baseagent'),
-                project: getArg('--project') || '',
                 owner: getArg('--owner'),
                 name: getArg('--name'),
                 description: getArg('--description'),
                 force: args.includes('--force'),
             });
+            const validationError = validateAgentCreatePlan(plan);
+            if (validationError) {
+                const error = { ok: false, error: validationError };
+                if (formatJson)
+                    console.log(JSON.stringify(error));
+                else
+                    console.error(`❌ ${error.error}`);
+                process.exitCode = 1;
+                return;
+            }
+            if (args.includes('--dry-run')) {
+                const preview = { ok: true, dryRun: true, plan };
+                if (formatJson)
+                    console.log(JSON.stringify(preview, null, 2));
+                else {
+                    console.log('EvolAgent 创建计划（dry-run）');
+                    console.log(`  AID: ${plan.aid}`);
+                    console.log(`  Project: ${plan.project}`);
+                    console.log(`  Baseagent: ${plan.baseagent} (${plan.baseagentSource})`);
+                    console.log(`  Owner: ${plan.owner || '未设置'} (${plan.ownerSource})`);
+                    console.log(`  Name: ${plan.name} (${plan.nameSource})`);
+                    if (plan.description)
+                        console.log(`  Description: ${plan.description} (${plan.descriptionSource})`);
+                    console.log(`  Existing config: ${plan.configExists ? (plan.force ? '将覆盖' : '是') : '否'}`);
+                }
+                return;
+            }
+            const result = await agentCreateNonInteractive({
+                aid: plan.aid,
+                baseagent: plan.baseagent,
+                project: plan.project,
+                owner: plan.owner,
+                name: plan.name,
+                description: plan.description,
+                force: args.includes('--force'),
+            });
             if (!result.ok) {
                 if (formatJson) {
                     console.log(JSON.stringify(result));
@@ -179,6 +227,8 @@ Options:
                 }
                 process.exit(1);
             }
+            if (result.ownerBindInterrupted)
+                return;
             if (formatJson) {
                 console.log(JSON.stringify(result, null, 2));
             }
@@ -211,6 +261,8 @@ Options:
                 }
                 process.exit(1);
             }
+            if (result.ownerBindInterrupted)
+                return;
             if (formatJson) {
                 console.log(JSON.stringify(result, null, 2));
             }
@@ -259,15 +311,16 @@ Options:
     // --- reload ---
     if (sub === 'reload') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent reload [aid] [--format json]
+            console.log(`用法: ec agent reload [aid] [--force] [--format json]
 
 热重载 agent 配置。
   无参数      全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
-  <aid>       仅热重载指定 agent`);
+  <aid>       仅热重载指定 agent
+  --force     中断目标 Agent 的运行中任务并清空排队任务后重载（仅与 <aid> 同用）`);
             return;
         }
         const target = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
-        const result = await agentReload(target);
+        const result = await agentReload(target, { force: args.includes('--force') });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));
@@ -294,9 +347,10 @@ Options:
     // --- enable ---
     if (sub === 'enable') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent enable <aid> [--format json]
+            console.log(`用法: ec agent enable <aid> [--force] [--format json]
 
-启用 agent。若服务运行中会热重载，否则下次 ec start 时生效。`);
+启用 agent。若服务运行中会热重载，否则下次 ec start 时生效。
+  --force     中断目标 Agent 的运行中任务并清空排队任务后重载`);
             return;
         }
         const aid = args[1];
@@ -304,7 +358,7 @@ Options:
             console.error('用法: ec agent enable <aid>');
             process.exit(1);
         }
-        const result = await agentEnable(aid);
+        const result = await agentEnable(aid, { force: args.includes('--force') });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));
@@ -325,9 +379,10 @@ Options:
     // --- disable ---
     if (sub === 'disable') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent disable <aid> [--format json]
+            console.log(`用法: ec agent disable <aid> [--force] [--format json]
 
-停用 agent。若服务运行中会热重载离线，否则在配置中标记为禁用。`);
+停用 agent。若服务运行中会热重载离线，否则在配置中标记为禁用。
+  --force     中断目标 Agent 的运行中任务并清空排队任务后重载`);
             return;
         }
         const aid = args[1];
@@ -335,7 +390,7 @@ Options:
             console.error('用法: ec agent disable <aid>');
             process.exit(1);
         }
-        const result = await agentDisable(aid);
+        const result = await agentDisable(aid, { force: args.includes('--force') });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));

package/dist/cli/agent.js

@@ -2,20 +2,25 @@ import fs from 'fs';
 import path from 'path';
 import readline from 'readline';
 import { resolvePaths, agentMdPath as getAgentMdPathFromPaths, aunPath as defaultAunPath } from '../paths.js';
-import { loadDefaults, loadAllAgents, loadAgent, saveAgent, ensureAgentDirSkeleton } from '../config-store.js';
+import { loadDefaults, loadAllAgents, loadAgent, saveAgent, ensureAgentDirSkeleton, loadDaemonConfig } from '../config-store.js';
 import { ConfigTarget, write as cfgWrite, ensureFile as cfgEnsure, read as cfgRead, initConfigManager } from '../config/config-manager.js';
 import { resolveConfigCommand } from '../config/resolved-config-op.js';
 import { executeResolvedConfigCommand } from '../config/config-operation-service.js';
 import { ipcQuery } from '../ipc.js';
 import { CONFIG_SCHEMA_VERSION } from '../types.js';
-import { withLifecycleForWrite } from '../config/lifecycle.js';
+import { normalizeAgentLifecycle, withLifecycleForWrite } from '../config/lifecycle.js';
+import { bindPostBootstrapWelcomeOutboxSession, hasPendingPostBootstrapWelcomeOutbox, postBootstrapWelcomeOperationId, preparePostBootstrapWelcomeOutbox, } from '../core/bootstrap-messages.js';
 import { ensureInitialRoleRegistry } from '../config/role-service.js';
-import { isValidChannelName } from '../core/channel-loader.js';
+import { formatChannelKey, isValidChannelName } from '../core/channel-loader.js';
 import { commandExists } from '../utils/cross-platform.js';
 import { getCodexAppServerAvailability, isCodexAppServerAvailable } from '../agents/codex-runner.js';
 import { resolveEcagentConfig } from '../agents/baseagent.js';
 import { agentProjectRootFromDefaults, deriveAgentProjectPath } from '../utils/project-path.js';
 import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
+import { readTaskRuntimeContextFromEnv } from './task-context.js';
+import { EventBus } from '../core/event-bus.js';
+import { SessionManager } from '../core/session/session-manager.js';
+import { isValidAid } from '../aun/aid/validation.js';
 function withStaticOwner(config, owner) {
     const value = owner?.trim();
     if (!value)
@@ -41,6 +46,100 @@ function detectAvailableBaseagents() {
 function pickDefaultBaseagent(available) {
     return AUTO_BASEAGENT_CANDIDATES.find(candidate => available.includes(candidate)) ?? null;
 }
+function readProjectMetadata(project) {
+    try {
+        const packageJsonPath = path.join(project, 'package.json');
+        if (!fs.existsSync(packageJsonPath))
+            return {};
+        const parsed = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return {
+            name: typeof parsed.name === 'string' ? parsed.name.trim() : undefined,
+            description: typeof parsed.description === 'string' ? parsed.description.trim() : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function projectSlug(project) {
+    const basename = path.basename(project) || 'agent';
+    const slug = basename
+        .normalize('NFKD')
+        .replace(/[^a-zA-Z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase()
+        .slice(0, 63)
+        .replace(/-+$/g, '');
+    return slug || 'agent';
+}
+/**
+ * Resolve non-interactive creation defaults without performing any network or
+ * filesystem mutation. The CLI uses this for both execution and --dry-run.
+ */
+export function resolveAgentCreatePlan(options) {
+    const aid = options.aid.trim();
+    const project = path.resolve(options.project || process.cwd());
+    const metadata = readProjectMetadata(project);
+    const defaults = loadDefaults();
+    const daemon = loadDaemonConfig();
+    const configuredBaseagent = defaults?.active_baseagent;
+    const available = detectAvailableBaseagents();
+    const defaultBaseagent = configuredBaseagent && available.includes(configuredBaseagent)
+        ? configuredBaseagent
+        : pickDefaultBaseagent(available) ?? undefined;
+    const baseagent = options.baseagent || defaultBaseagent;
+    const baseagentSource = options.baseagent
+        ? 'argument'
+        : configuredBaseagent && baseagent === configuredBaseagent
+            ? 'defaults'
+            : 'detected';
+    const owner = options.owner?.trim() || daemon.owners?.[0];
+    const ownerSource = options.owner?.trim() ? 'argument' : owner ? 'daemon' : 'none';
+    const name = options.name?.trim() || metadata.name || projectSlug(project);
+    const description = options.description?.trim() || metadata.description || '';
+    const configExists = isValidAid(aid)
+        && fs.existsSync(path.join(resolvePaths().agentsDir, aid, 'config.json'));
+    return {
+        aid,
+        project,
+        baseagent,
+        owner,
+        name,
+        description,
+        force: options.force === true,
+        configExists,
+        baseagentSource,
+        ownerSource,
+        nameSource: options.name?.trim() ? 'argument' : metadata.name ? 'package' : 'directory',
+        descriptionSource: options.description?.trim() ? 'argument' : metadata.description ? 'package' : 'none',
+    };
+}
+export function validateAgentCreatePlan(plan) {
+    if (!isValidAid(plan.aid)) {
+        return `Invalid AID "${plan.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)`;
+    }
+    if (plan.configExists && !plan.force) {
+        return `Agent "${plan.aid}" already exists (use --force to overwrite)`;
+    }
+    if (!plan.baseagent) {
+        return 'No usable baseagent detected. Pass --baseagent or configure a baseagent in agents/defaults.json.';
+    }
+    if (!BASEAGENT_CANDIDATES.includes(plan.baseagent)) {
+        return `Invalid baseagent: ${plan.baseagent} (options: ${BASEAGENT_CANDIDATES.join('/')})`;
+    }
+    if (!isBaseagentAvailable(plan.baseagent)) {
+        return `${plan.baseagent} is not available in the current environment`;
+    }
+    if (plan.baseagent === 'ecagent') {
+        const reason = ecagentUnavailableReason();
+        if (reason)
+            return reason;
+    }
+    if (plan.owner && !isValidAid(plan.owner)) {
+        return `Invalid owner: ${plan.owner}`;
+    }
+    return null;
+}
 function ecagentUnavailableReason() {
     try {
         resolveEcagentConfig({ agents: { ecagent: {} } });
@@ -458,6 +557,7 @@ export async function agentCreateInteractive(opts = {}) {
         catch { /* daemon not running */ }
         let ownerBoundAid;
         let ownerBindSkipped = false;
+        let ownerBindInterrupted = false;
         // Only prompt for agent owner binding if:
         // 1. User didn't manually input owner during setup (owner is undefined)
         // 2. User didn't skip QR binding explicitly (skipQrBinding is false)
@@ -467,15 +567,18 @@ export async function agentCreateInteractive(opts = {}) {
             console.log('\n📡 Agent owner 绑定 — 请用 evol app 扫描二维码，10 分钟内有效\n');
             try {
                 const { runAgentOwnerQrBindFlow } = await import('./init-channel.js');
-                const bound = await runAgentOwnerQrBindFlow(aid, agentName, 'append');
-                if (bound?.boundAid) {
+                const bound = await runAgentOwnerQrBindFlow(aid, agentName);
+                if (bound.action === 'bound') {
                     ownerBoundAid = bound.boundAid;
                     console.log(`  ✓ 已配置 agent owner: ${bound.boundAid}`);
                 }
-                else {
+                else if (bound.action === 'manual') {
                     ownerBindSkipped = true;
                     ownerBoundAid = await promptAgentOwnerManually(aid);
                 }
+                else {
+                    ownerBindInterrupted = true;
+                }
             }
             catch (e) {
                 ownerBindSkipped = true;
@@ -493,6 +596,7 @@ export async function agentCreateInteractive(opts = {}) {
             hotLoadError,
             ownerBoundAid,
             ownerBindSkipped,
+            ownerBindInterrupted,
         };
     }
     finally {
@@ -784,12 +888,17 @@ export async function agentSyncAids() {
     return { ok: true, created, template: templateAgent.aid, hotReloaded };
 }
 // ==================== agentReload ====================
-export async function agentReload(aid) {
+const AGENT_RELOAD_TIMEOUT_MS = 45_000;
+const AGENT_RESYNC_TIMEOUT_MS = 5 * 60_000;
+export async function agentReload(aid, options = {}) {
     const p = resolvePaths();
     if (!aid) {
+        if (options.force) {
+            return { ok: false, code: 'INVALID_ARGS', error: '--force requires a target Agent AID' };
+        }
         // Full resync
         try {
-            const result = await ipcQuery(p.socket, { type: 'evolagent.resync' });
+            const result = await ipcQuery(p.socket, { type: 'evolagent.resync' }, AGENT_RESYNC_TIMEOUT_MS);
             if (result === null) {
                 return { ok: false, error: 'evolcore 未运行，请先 ec start' };
             }
@@ -804,27 +913,27 @@ export async function agentReload(aid) {
     }
     // Single agent reload
     try {
-        const result = await ipcQuery(p.socket, { type: 'evolagent.reload', name: aid });
+        const result = await ipcQuery(p.socket, { type: 'evolagent.reload', name: aid, force: options.force === true }, AGENT_RELOAD_TIMEOUT_MS);
         if (result === null) {
             return { ok: false, error: 'evolcore 未运行，请先 ec start 后再 reload' };
         }
         if (result?.ok) {
             return { ok: true };
         }
-        return { ok: false, error: result?.error || 'unknown error' };
+        return { ok: false, code: result?.code, error: result?.error || 'unknown error' };
     }
     catch {
         return { ok: false, error: 'evolcore 未运行，请先 ec start 后再 reload' };
     }
 }
 // ==================== agentEnable / agentDisable ====================
-export async function agentEnable(aid) {
-    return agentSetEnabled(aid, true);
+export async function agentEnable(aid, options = {}) {
+    return agentSetEnabled(aid, true, options);
 }
-export async function agentDisable(aid) {
-    return agentSetEnabled(aid, false);
+export async function agentDisable(aid, options = {}) {
+    return agentSetEnabled(aid, false, options);
 }
-async function agentSetEnabled(aid, enabled) {
+async function agentSetEnabled(aid, enabled, options = {}) {
     const p = resolvePaths();
     let config;
     try {
@@ -836,15 +945,28 @@ async function agentSetEnabled(aid, enabled) {
     if (!config) {
         return { ok: false, error: `Agent "${aid}" not found` };
     }
+    const previousEnabled = config.enabled;
     config.enabled = enabled;
     saveAgent(config);
     // Try to hot-reload if daemon is running, but don't fail if it's not
     let reloaded = false;
     try {
-        const result = await ipcQuery(p.socket, { type: 'evolagent.reload', name: aid }, 1000);
+        const result = await ipcQuery(p.socket, {
+            type: 'evolagent.reload',
+            name: aid,
+            force: options.force === true,
+        }, AGENT_RELOAD_TIMEOUT_MS);
         if (result?.ok) {
             reloaded = true;
         }
+        else if (result?.code === 'AGENT_BUSY') {
+            if (previousEnabled === undefined)
+                delete config.enabled;
+            else
+                config.enabled = previousEnabled;
+            saveAgent(config);
+            return { ok: false, code: result.code, error: result.error || 'Agent is busy' };
+        }
     }
     catch {
         // Daemon not running or unreachable — that's ok, config is already saved
@@ -1074,17 +1196,122 @@ export async function agentRename(aid, name) {
     return { ok: true, aid, name };
 }
 // ==================== agentReady ====================
+async function ensureOfflinePostBootstrapMainSession(aid, config) {
+    const owner = config.owners?.[0];
+    if (!owner)
+        throw new Error(`Agent "${aid}" has no owner for the post-bootstrap main session`);
+    const p = resolvePaths();
+    const aunName = config.channels?.find(channel => channel.type === 'aun')?.name || 'main';
+    const channel = formatChannelKey({ type: 'aun', selfAID: aid, name: aunName });
+    const manager = new SessionManager(p.sessionsDir, new EventBus());
+    const active = await manager.getActiveSession(channel, owner);
+    const ensured = await manager.ensureNewMainSessionForOperation({
+        channel,
+        channelId: owner,
+        projectPath: active?.projectPath
+            || config.projects?.defaultPath
+            || path.join(p.root, 'projects', aid.split('.')[0]),
+        baseagent: config.active_baseagent || active?.baseagent || 'claude',
+        operationId: postBootstrapWelcomeOperationId(aid),
+        identityMetadata: {
+            ...(active?.metadata ?? {}),
+            channelKey: channel,
+            peerId: owner,
+        },
+    });
+    return ensured.session.id;
+}
 export async function agentReady(aid) {
+    const taskSelfAid = readTaskRuntimeContextFromEnv()?.selfAid;
+    if (taskSelfAid && taskSelfAid.replace(/^@/, '') !== aid.replace(/^@/, '')) {
+        return {
+            ok: false,
+            code: 'SELF_AGENT_REQUIRED',
+            error: `A managed task can only complete bootstrap for itself (${taskSelfAid})`,
+        };
+    }
     const p = resolvePaths();
+    const managedSessionId = process.env.EVOLCORE_SESSION_ID;
+    if (managedSessionId) {
+        const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+        if (!delegationToken)
+            return { ok: false, code: 'DELEGATION_REQUIRED', error: `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task` };
+        const result = await ipcQuery(p.socket, {
+            type: 'evolagent.bootstrapComplete',
+            aid,
+            sessionId: managedSessionId,
+            delegationToken,
+        }, 30_000);
+        if (!result)
+            return { ok: false, code: 'DAEMON_UNAVAILABLE', error: 'Unable to connect to the evolcore daemon' };
+        return result.ok
+            ? { ok: true, aid, reloaded: result.reloaded === true }
+            : { ok: false, code: result.code, error: result.error || 'Failed to complete bootstrap' };
+    }
     const config = loadAgent(aid);
     if (!config)
         return { ok: false, error: `Agent "${aid}" not found` };
-    saveAgent(withLifecycleForWrite(config, 'active'));
-    let reloaded = false;
     try {
-        const result = await ipcQuery(p.socket, { type: 'evolagent.bootstrapComplete', aid }, 30_000);
-        reloaded = !!result?.ok;
+        let controlToken;
+        try {
+            controlToken = fs.readFileSync(p.controlToken, 'utf8').trim() || undefined;
+        }
+        catch { }
+        const result = await ipcQuery(p.socket, { type: 'evolagent.bootstrapComplete', aid, controlToken }, 30_000);
+        if (!result) {
+            const offlineConfig = loadAgent(aid) || config;
+            const lifecycle = normalizeAgentLifecycle(offlineConfig).lifecycle;
+            if (lifecycle !== 'bootstrapping') {
+                if (lifecycle === 'active') {
+                    if (hasPendingPostBootstrapWelcomeOutbox(aid)) {
+                        try {
+                            const sessionId = await ensureOfflinePostBootstrapMainSession(aid, offlineConfig);
+                            if (!bindPostBootstrapWelcomeOutboxSession(aid, sessionId)) {
+                                throw new Error(`Failed to bind the completion welcome to session ${sessionId}`);
+                            }
+                        }
+                        catch (e) {
+                            return {
+                                ok: false,
+                                code: 'MAIN_SESSION_CREATE_FAILED',
+                                error: e instanceof Error ? e.message : 'Failed to recover the post-bootstrap main session',
+                            };
+                        }
+                    }
+                    return { ok: true, aid, reloaded: false };
+                }
+                return { ok: false, code: 'INVALID_LIFECYCLE', error: `Agent "${aid}" is ${lifecycle}; only a bootstrapping agent can become ready` };
+            }
+            const owner = offlineConfig.owners?.[0];
+            if (!owner)
+                return { ok: false, code: 'OWNER_REQUIRED', error: `Agent "${aid}" has no owner for the completion welcome` };
+            try {
+                preparePostBootstrapWelcomeOutbox(aid, owner);
+                const sessionId = await ensureOfflinePostBootstrapMainSession(aid, offlineConfig);
+                if (!bindPostBootstrapWelcomeOutboxSession(aid, sessionId)) {
+                    throw new Error(`Failed to bind the completion welcome to session ${sessionId}`);
+                }
+                saveAgent(withLifecycleForWrite(offlineConfig, 'active'));
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    code: 'READY_PERSIST_FAILED',
+                    error: e instanceof Error ? e.message : 'Failed to persist bootstrap completion',
+                };
+            }
+            return { ok: true, aid, reloaded: false };
+        }
+        if (!result.ok) {
+            return { ok: false, code: result.code, error: result.error || 'Failed to complete bootstrap' };
+        }
+        return { ok: true, aid, reloaded: true };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            code: 'DAEMON_UNAVAILABLE',
+            error: e instanceof Error ? e.message : 'Unable to connect to the EvolCore daemon',
+        };
     }
-    catch { /* daemon not running */ }
-    return { ok: true, aid, reloaded };
 }