@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/agents/AgentExecutorFactory.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Agent Executor Factory
+ *
+ * 从 Pod 读取凭证和供应商配置，创建对应的 Agent 执行器。
+ *
+ * 支持的执行器类型：
+ * - codebuddy: CodeBuddy Agent SDK
+ * - claude: Claude Agent SDK
+ *
+ * 使用流程：
+ * 1. 从 Pod 读取 AgentProvider 配置
+ * 2. 从 Pod 读取对应的 Credential
+ * 3. 根据 executorType 创建对应的执行器实例
+ */
+import type { IAgentExecutor, ExecutorType, AiCredential, ProviderConfig, BaseExecutorOptions } from './types';
+/**
+ * 支持的执行器类型
+ */
+export declare const SUPPORTED_EXECUTOR_TYPES: ExecutorType[];
+/**
+ * Agent Executor Factory
+ *
+ * 负责从 Pod 读取配置并创建执行器实例。
+ */
+export declare class AgentExecutorFactory {
+    private readonly logger;
+    /**
+     * 检查执行器类型是否支持
+     */
+    isSupported(executorType: string): executorType is ExecutorType;
+    /**
+     * 从 Pod 创建执行器
+     *
+     * @param podBaseUrl Pod 根 URL
+     * @param providerId 供应商 ID
+     * @param authenticatedFetch 带认证的 fetch 函数
+     * @param webId 用户 WebID（可选）
+     * @returns 执行器实例，如果未找到配置则返回 null
+     */
+    create(podBaseUrl: string, providerId: string, authenticatedFetch: typeof fetch, webId?: string): Promise<IAgentExecutor | null>;
+    /**
+     * 列出所有可用的供应商
+     */
+    listProviders(podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string): Promise<ProviderConfig[]>;
+    /**
+     * 列出所有启用的供应商
+     */
+    listEnabledProviders(podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string): Promise<ProviderConfig[]>;
+    /**
+     * 列出所有支持的供应商（executorType 受支持且已启用）
+     */
+    listSupportedProviders(podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string): Promise<ProviderConfig[]>;
+    /**
+     * 根据 executorType 创建执行器
+     */
+    createExecutor(executorType: ExecutorType, options: BaseExecutorOptions): IAgentExecutor;
+    /**
+     * 创建指定类型的执行器（直接使用凭证，不从 Pod 读取）
+     *
+     * 用于测试或已知凭证的场景。
+     */
+    createDirect(executorType: ExecutorType, providerId: string, credential: AiCredential): IAgentExecutor;
+}
+/**
+ * 默认工厂实例
+ */
+export declare const agentExecutorFactory: AgentExecutorFactory;

package/dist/agents/AgentExecutorFactory.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Agent Executor Factory
+ *
+ * 从 Pod 读取凭证和供应商配置，创建对应的 Agent 执行器。
+ *
+ * 支持的执行器类型：
+ * - codebuddy: CodeBuddy Agent SDK
+ * - claude: Claude Agent SDK
+ *
+ * 使用流程：
+ * 1. 从 Pod 读取 AgentProvider 配置
+ * 2. 从 Pod 读取对应的 Credential
+ * 3. 根据 executorType 创建对应的执行器实例
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentExecutorFactory = exports.AgentExecutorFactory = exports.SUPPORTED_EXECUTOR_TYPES = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const tables_1 = require("./schema/tables");
+const tables_2 = require("../credential/schema/tables");
+const types_1 = require("../credential/schema/types");
+// 执行器实现（仅支持有完整 Agent SDK 的供应商）
+const ClaudeExecutor_1 = require("./ClaudeExecutor");
+const CodeBuddyExecutor_1 = require("./CodeBuddyExecutor");
+const schema = {
+    agentProvider: tables_1.AgentProvider,
+    credential: tables_2.Credential,
+};
+/**
+ * 支持的执行器类型
+ */
+exports.SUPPORTED_EXECUTOR_TYPES = ['codebuddy', 'claude'];
+/**
+ * Agent Executor Factory
+ *
+ * 负责从 Pod 读取配置并创建执行器实例。
+ */
+class AgentExecutorFactory {
+    constructor() {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+    }
+    /**
+     * 检查执行器类型是否支持
+     */
+    isSupported(executorType) {
+        return exports.SUPPORTED_EXECUTOR_TYPES.includes(executorType);
+    }
+    /**
+     * 从 Pod 创建执行器
+     *
+     * @param podBaseUrl Pod 根 URL
+     * @param providerId 供应商 ID
+     * @param authenticatedFetch 带认证的 fetch 函数
+     * @param webId 用户 WebID（可选）
+     * @returns 执行器实例，如果未找到配置则返回 null
+     */
+    async create(podBaseUrl, providerId, authenticatedFetch, webId) {
+        try {
+            const session = {
+                info: { isLoggedIn: true, webId },
+                fetch: authenticatedFetch,
+            };
+            const db = (0, drizzle_solid_1.drizzle)(session, { schema });
+            // 1. 读取供应商配置
+            const provider = await db.query.agentProvider.findFirst({
+                where: (0, drizzle_solid_1.eq)(tables_1.AgentProvider.id, providerId),
+            });
+            if (!provider) {
+                this.logger.debug(`Agent provider not found: ${providerId}`);
+                return null;
+            }
+            if (provider.enabled !== 'true') {
+                this.logger.debug(`Agent provider is disabled: ${providerId}`);
+                return null;
+            }
+            // 检查执行器类型是否支持
+            if (!this.isSupported(provider.executorType)) {
+                this.logger.warn(`Unsupported executor type: ${provider.executorType}. Only 'codebuddy' and 'claude' are supported.`);
+                return null;
+            }
+            // 2. 读取凭证
+            const providerUri = `${podBaseUrl}settings/ai/agent-providers.ttl#${providerId}`;
+            const credentials = await db.query.credential.findMany({
+                where: (0, drizzle_solid_1.and)((0, drizzle_solid_1.eq)(tables_2.Credential.service, types_1.ServiceType.AI), (0, drizzle_solid_1.eq)(tables_2.Credential.status, types_1.CredentialStatus.ACTIVE), (0, drizzle_solid_1.eq)(tables_2.Credential.provider, providerUri)),
+            });
+            if (credentials.length === 0) {
+                this.logger.debug(`No active credential found for agent provider: ${providerId}`);
+                return null;
+            }
+            // 随机选择一个凭证（负载均衡）
+            const credential = credentials[Math.floor(Math.random() * credentials.length)];
+            // 3. 构建凭证对象
+            const aiCredential = {
+                providerId,
+                apiKey: credential.apiKey ?? '',
+                baseUrl: credential.baseUrl ?? provider.baseUrl ?? undefined,
+                proxyUrl: credential.proxyUrl ?? undefined,
+                projectId: credential.projectId ?? undefined,
+                organizationId: credential.organizationId ?? undefined,
+            };
+            // 4. 构建供应商配置
+            const providerConfig = {
+                id: provider.id,
+                displayName: provider.displayName ?? provider.id,
+                executorType: provider.executorType,
+                baseUrl: provider.baseUrl ?? undefined,
+                defaultModel: provider.defaultModel ?? undefined,
+                enabled: provider.enabled === 'true',
+            };
+            // 5. 创建执行器
+            return this.createExecutor(provider.executorType, {
+                providerId,
+                credential: aiCredential,
+                providerConfig,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Failed to create executor for provider ${providerId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * 列出所有可用的供应商
+     */
+    async listProviders(podBaseUrl, authenticatedFetch, webId) {
+        try {
+            const session = {
+                info: { isLoggedIn: true, webId },
+                fetch: authenticatedFetch,
+            };
+            const db = (0, drizzle_solid_1.drizzle)(session, { schema });
+            const providers = await db.query.agentProvider.findMany();
+            return providers.map((p) => ({
+                id: p.id,
+                displayName: p.displayName ?? p.id,
+                executorType: p.executorType,
+                baseUrl: p.baseUrl ?? undefined,
+                defaultModel: p.defaultModel ?? undefined,
+                enabled: p.enabled === 'true',
+            }));
+        }
+        catch (error) {
+            this.logger.error('Failed to list agent providers:', error);
+            return [];
+        }
+    }
+    /**
+     * 列出所有启用的供应商
+     */
+    async listEnabledProviders(podBaseUrl, authenticatedFetch, webId) {
+        const providers = await this.listProviders(podBaseUrl, authenticatedFetch, webId);
+        return providers.filter((p) => p.enabled);
+    }
+    /**
+     * 列出所有支持的供应商（executorType 受支持且已启用）
+     */
+    async listSupportedProviders(podBaseUrl, authenticatedFetch, webId) {
+        const providers = await this.listEnabledProviders(podBaseUrl, authenticatedFetch, webId);
+        return providers.filter((p) => this.isSupported(p.executorType));
+    }
+    /**
+     * 根据 executorType 创建执行器
+     */
+    createExecutor(executorType, options) {
+        switch (executorType) {
+            case 'claude':
+                return new ClaudeExecutor_1.ClaudeExecutor(options);
+            case 'codebuddy':
+                return new CodeBuddyExecutor_1.CodeBuddyExecutor(options);
+            default:
+                throw new Error(`Unsupported executor type: ${executorType}. ` +
+                    `Only 'codebuddy' and 'claude' are supported because they have complete Agent SDKs.`);
+        }
+    }
+    /**
+     * 创建指定类型的执行器（直接使用凭证，不从 Pod 读取）
+     *
+     * 用于测试或已知凭证的场景。
+     */
+    createDirect(executorType, providerId, credential) {
+        return this.createExecutor(executorType, {
+            providerId,
+            credential,
+        });
+    }
+}
+exports.AgentExecutorFactory = AgentExecutorFactory;
+/**
+ * 默认工厂实例
+ */
+exports.agentExecutorFactory = new AgentExecutorFactory();
+//# sourceMappingURL=AgentExecutorFactory.js.map

package/dist/agents/AgentExecutorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentExecutorFactory.js","sourceRoot":"","sources":["../../src/agents/AgentExecutorFactory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agent Executor Factory\n *\n * 从 Pod 读取凭证和供应商配置，创建对应的 Agent 执行器。\n *\n * 支持的执行器类型：\n * - codebuddy: CodeBuddy Agent SDK\n * - claude: Claude Agent SDK\n *\n * 使用流程：\n * 1. 从 Pod 读取 AgentProvider 配置\n * 2. 从 Pod 读取对应的 Credential\n * 3. 根据 executorType 创建对应的执行器实例\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport { drizzle, eq, and } from '@undefineds.co/drizzle-solid';\nimport type { IAgentExecutor, ExecutorType, AiCredential, ProviderConfig, BaseExecutorOptions } from './types';\nimport { AgentProvider } from './schema/tables';\nimport { Credential } from '../credential/schema/tables';\nimport { ServiceType, CredentialStatus } from '../credential/schema/types';\n\n// 执行器实现（仅支持有完整 Agent SDK 的供应商）\nimport { ClaudeExecutor } from './ClaudeExecutor';\nimport { CodeBuddyExecutor } from './CodeBuddyExecutor';\n\nconst schema = {\n  agentProvider: AgentProvider,\n  credential: Credential,\n};\n\n/**\n * 支持的执行器类型\n */\nexport const SUPPORTED_EXECUTOR_TYPES: ExecutorType[] = ['codebuddy', 'claude'];\n\n/**\n * Agent Executor Factory\n *\n * 负责从 Pod 读取配置并创建执行器实例。\n */\nexport class AgentExecutorFactory {\n  private readonly logger = getLoggerFor(this);\n\n  /**\n   * 检查执行器类型是否支持\n   */\n  public isSupported(executorType: string): executorType is ExecutorType {\n    return SUPPORTED_EXECUTOR_TYPES.includes(executorType as ExecutorType);\n  }\n\n  /**\n   * 从 Pod 创建执行器\n   *\n   * @param podBaseUrl Pod 根 URL\n   * @param providerId 供应商 ID\n   * @param authenticatedFetch 带认证的 fetch 函数\n   * @param webId 用户 WebID（可选）\n   * @returns 执行器实例，如果未找到配置则返回 null\n   */\n  public async create(\n    podBaseUrl: string,\n    providerId: string,\n    authenticatedFetch: typeof fetch,\n    webId?: string,\n  ): Promise<IAgentExecutor | null> {\n    try {\n      const session = {\n        info: { isLoggedIn: true, webId },\n        fetch: authenticatedFetch,\n      };\n      const db = drizzle(session, { schema });\n\n      // 1. 读取供应商配置\n      const provider = await db.query.agentProvider.findFirst({\n        where: eq(AgentProvider.id, providerId),\n      });\n\n      if (!provider) {\n        this.logger.debug(`Agent provider not found: ${providerId}`);\n        return null;\n      }\n\n      if (provider.enabled !== 'true') {\n        this.logger.debug(`Agent provider is disabled: ${providerId}`);\n        return null;\n      }\n\n      // 检查执行器类型是否支持\n      if (!this.isSupported(provider.executorType)) {\n        this.logger.warn(`Unsupported executor type: ${provider.executorType}. Only 'codebuddy' and 'claude' are supported.`);\n        return null;\n      }\n\n      // 2. 读取凭证\n      const providerUri = `${podBaseUrl}settings/ai/agent-providers.ttl#${providerId}`;\n      const credentials = await db.query.credential.findMany({\n        where: and(\n          eq(Credential.service, ServiceType.AI),\n          eq(Credential.status, CredentialStatus.ACTIVE),\n          eq(Credential.provider, providerUri),\n        ),\n      });\n\n      if (credentials.length === 0) {\n        this.logger.debug(`No active credential found for agent provider: ${providerId}`);\n        return null;\n      }\n\n      // 随机选择一个凭证（负载均衡）\n      const credential = credentials[Math.floor(Math.random() * credentials.length)] as any;\n\n      // 3. 构建凭证对象\n      const aiCredential: AiCredential = {\n        providerId,\n        apiKey: credential.apiKey ?? '',\n        baseUrl: credential.baseUrl ?? provider.baseUrl ?? undefined,\n        proxyUrl: credential.proxyUrl ?? undefined,\n        projectId: credential.projectId ?? undefined,\n        organizationId: credential.organizationId ?? undefined,\n      };\n\n      // 4. 构建供应商配置\n      const providerConfig: ProviderConfig = {\n        id: provider.id,\n        displayName: provider.displayName ?? provider.id,\n        executorType: provider.executorType as ExecutorType,\n        baseUrl: provider.baseUrl ?? undefined,\n        defaultModel: provider.defaultModel ?? undefined,\n        enabled: provider.enabled === 'true',\n      };\n\n      // 5. 创建执行器\n      return this.createExecutor(provider.executorType as ExecutorType, {\n        providerId,\n        credential: aiCredential,\n        providerConfig,\n      });\n    } catch (error) {\n      this.logger.error(`Failed to create executor for provider ${providerId}:`, error);\n      return null;\n    }\n  }\n\n  /**\n   * 列出所有可用的供应商\n   */\n  public async listProviders(\n    podBaseUrl: string,\n    authenticatedFetch: typeof fetch,\n    webId?: string,\n  ): Promise<ProviderConfig[]> {\n    try {\n      const session = {\n        info: { isLoggedIn: true, webId },\n        fetch: authenticatedFetch,\n      };\n      const db = drizzle(session, { schema });\n\n      const providers = await db.query.agentProvider.findMany();\n\n      return providers.map((p: typeof providers[number]) => ({\n        id: p.id,\n        displayName: p.displayName ?? p.id,\n        executorType: p.executorType as ExecutorType,\n        baseUrl: p.baseUrl ?? undefined,\n        defaultModel: p.defaultModel ?? undefined,\n        enabled: p.enabled === 'true',\n      }));\n    } catch (error) {\n      this.logger.error('Failed to list agent providers:', error);\n      return [];\n    }\n  }\n\n  /**\n   * 列出所有启用的供应商\n   */\n  public async listEnabledProviders(\n    podBaseUrl: string,\n    authenticatedFetch: typeof fetch,\n    webId?: string,\n  ): Promise<ProviderConfig[]> {\n    const providers = await this.listProviders(podBaseUrl, authenticatedFetch, webId);\n    return providers.filter((p) => p.enabled);\n  }\n\n  /**\n   * 列出所有支持的供应商（executorType 受支持且已启用）\n   */\n  public async listSupportedProviders(\n    podBaseUrl: string,\n    authenticatedFetch: typeof fetch,\n    webId?: string,\n  ): Promise<ProviderConfig[]> {\n    const providers = await this.listEnabledProviders(podBaseUrl, authenticatedFetch, webId);\n    return providers.filter((p) => this.isSupported(p.executorType));\n  }\n\n  /**\n   * 根据 executorType 创建执行器\n   */\n  public createExecutor(executorType: ExecutorType, options: BaseExecutorOptions): IAgentExecutor {\n    switch (executorType) {\n      case 'claude':\n        return new ClaudeExecutor(options);\n\n      case 'codebuddy':\n        return new CodeBuddyExecutor(options);\n\n      default:\n        throw new Error(\n          `Unsupported executor type: ${executorType}. ` +\n          `Only 'codebuddy' and 'claude' are supported because they have complete Agent SDKs.`\n        );\n    }\n  }\n\n  /**\n   * 创建指定类型的执行器（直接使用凭证，不从 Pod 读取）\n   *\n   * 用于测试或已知凭证的场景。\n   */\n  public createDirect(\n    executorType: ExecutorType,\n    providerId: string,\n    credential: AiCredential,\n  ): IAgentExecutor {\n    return this.createExecutor(executorType, {\n      providerId,\n      credential,\n    });\n  }\n}\n\n/**\n * 默认工厂实例\n */\nexport const agentExecutorFactory = new AgentExecutorFactory();\n"]}

package/dist/agents/AgentManager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Agent Manager - Agent 生命周期管理
+ *
+ * 职责：
+ * 1. 从 Pod 读取 Agent 配置
+ * 2. 根据配置创建 Executor
+ * 3. 管理 Agent 实例的生命周期
+ * 4. 路由消息到对应的 Agent
+ */
+import type { IAgentExecutor, ExecutorConfig } from './types';
+/**
+ * Agent 实例 - 包含配置和执行器
+ */
+export interface AgentInstance {
+    /** Agent ID */
+    id: string;
+    /** 显示名称 */
+    displayName: string;
+    /** 描述 */
+    description: string;
+    /** 执行器实例 */
+    executor: IAgentExecutor;
+    /** 执行器配置 */
+    config: ExecutorConfig;
+    /** 状态 */
+    status: 'idle' | 'running' | 'error';
+    /** 启动时间 */
+    startedAt?: Date;
+    /** 最后活动时间 */
+    lastActivityAt?: Date;
+}
+/**
+ * Agent 配置（从 Pod 读取）
+ */
+export interface AgentConfig {
+    id: string;
+    displayName?: string;
+    description?: string;
+    providerId: string;
+    modelUri?: string;
+    systemPrompt: string;
+    maxTurns?: number;
+    timeout?: number;
+    enabled: boolean;
+}
+/**
+ * Agent Manager
+ *
+ * 管理 Agent 实例的完整生命周期
+ */
+export declare class AgentManager {
+    private readonly logger;
+    private readonly factory;
+    private readonly instances;
+    /**
+     * 获取或创建 Agent 实例
+     *
+     * 如果 Agent 已存在且健在，直接返回
+     * 否则根据配置创建新实例
+     *
+     * @param agentId Agent ID
+     * @param podBaseUrl Pod 根 URL
+     * @param authenticatedFetch 带认证的 fetch
+     * @param webId 用户 WebID
+     */
+    getOrCreate(agentId: string, podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string): Promise<AgentInstance | null>;
+    /**
+     * 检查 Agent 是否健在
+     */
+    private isAlive;
+    /**
+     * 从 Pod 配置创建 Agent 实例
+     */
+    private createFromConfig;
+    /**
+     * 发送消息给 Agent
+     *
+     * @param agentId Agent ID
+     * @param message 消息内容
+     * @param podBaseUrl Pod 根 URL
+     * @param authenticatedFetch 带认证的 fetch
+     * @param webId 用户 WebID
+     * @param accessToken OAuth token（用于 MCP）
+     */
+    sendMessage(agentId: string, message: string, podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string, accessToken?: string): Promise<{
+        success: boolean;
+        result?: string;
+        error?: string;
+    }>;
+    /**
+     * 更新 Agent 状态到 Pod
+     */
+    private updateStatus;
+    /**
+     * 获取 Agent 状态
+     */
+    getStatus(agentId: string): AgentInstance | undefined;
+    /**
+     * 列出所有活跃的 Agent
+     */
+    listActiveAgents(): AgentInstance[];
+    /**
+     * 停止 Agent
+     */
+    stop(agentId: string, podBaseUrl: string, authenticatedFetch: typeof fetch, webId?: string): Promise<void>;
+    /**
+     * 停止所有 Agent
+     */
+    stopAll(): Promise<void>;
+}
+/**
+ * 默认 AgentManager 实例
+ */
+export declare const agentManager: AgentManager;

package/dist/agents/AgentManager.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * Agent Manager - Agent 生命周期管理
+ *
+ * 职责：
+ * 1. 从 Pod 读取 Agent 配置
+ * 2. 根据配置创建 Executor
+ * 3. 管理 Agent 实例的生命周期
+ * 4. 路由消息到对应的 Agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentManager = exports.AgentManager = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const agent_config_1 = require("./schema/agent-config");
+const tables_1 = require("./schema/tables");
+const tables_2 = require("../credential/schema/tables");
+const types_1 = require("../credential/schema/types");
+const AgentExecutorFactory_1 = require("./AgentExecutorFactory");
+const schema = {
+    agentConfig: agent_config_1.AgentConfig,
+    agentStatus: agent_config_1.AgentStatus,
+    agentProvider: tables_1.AgentProvider,
+    credential: tables_2.Credential,
+};
+/**
+ * Agent Manager
+ *
+ * 管理 Agent 实例的完整生命周期
+ */
+class AgentManager {
+    constructor() {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.factory = new AgentExecutorFactory_1.AgentExecutorFactory();
+        this.instances = new Map();
+    }
+    /**
+     * 获取或创建 Agent 实例
+     *
+     * 如果 Agent 已存在且健在，直接返回
+     * 否则根据配置创建新实例
+     *
+     * @param agentId Agent ID
+     * @param podBaseUrl Pod 根 URL
+     * @param authenticatedFetch 带认证的 fetch
+     * @param webId 用户 WebID
+     */
+    async getOrCreate(agentId, podBaseUrl, authenticatedFetch, webId) {
+        // 1. 检查是否有健在的实例
+        const existing = this.instances.get(agentId);
+        if (existing && this.isAlive(existing)) {
+            this.logger.debug(`Agent ${agentId} is alive, reusing instance`);
+            return existing;
+        }
+        // 2. 从 Pod 读取配置并创建
+        this.logger.info(`Creating agent instance: ${agentId}`);
+        const instance = await this.createFromConfig(agentId, podBaseUrl, authenticatedFetch, webId);
+        if (instance) {
+            this.instances.set(agentId, instance);
+            await this.updateStatus(agentId, 'idle', podBaseUrl, authenticatedFetch, webId);
+        }
+        return instance;
+    }
+    /**
+     * 检查 Agent 是否健在
+     */
+    isAlive(instance) {
+        // 简单判断：非 error 状态就是健在
+        // 未来可以加入心跳检测
+        return instance.status !== 'error';
+    }
+    /**
+     * 从 Pod 配置创建 Agent 实例
+     */
+    async createFromConfig(agentId, podBaseUrl, authenticatedFetch, webId) {
+        try {
+            const session = {
+                info: { isLoggedIn: true, webId },
+                fetch: authenticatedFetch,
+            };
+            const db = (0, drizzle_solid_1.drizzle)(session, { schema });
+            // 1. 读取 Agent 配置
+            const agentConfig = await db.query.agentConfig.findFirst({
+                where: (0, drizzle_solid_1.eq)(agent_config_1.AgentConfig.id, agentId),
+            });
+            if (!agentConfig) {
+                this.logger.warn(`Agent config not found: ${agentId}`);
+                return null;
+            }
+            if (agentConfig.enabled !== 'true') {
+                this.logger.debug(`Agent is disabled: ${agentId}`);
+                return null;
+            }
+            // 2. 解析 provider URI，获取 provider ID
+            const providerUri = agentConfig.provider;
+            if (!providerUri) {
+                this.logger.error(`Agent ${agentId} has no provider configured`);
+                return null;
+            }
+            // provider URI 格式: /settings/ai/agent-providers.ttl#codebuddy
+            const providerId = providerUri.split('#').pop();
+            if (!providerId) {
+                this.logger.error(`Invalid provider URI: ${providerUri}`);
+                return null;
+            }
+            // 3. 读取 Provider 配置
+            const provider = await db.query.agentProvider.findFirst({
+                where: (0, drizzle_solid_1.eq)(tables_1.AgentProvider.id, providerId),
+            });
+            if (!provider) {
+                this.logger.error(`Provider not found: ${providerId}`);
+                return null;
+            }
+            // 4. 读取 Credential
+            const credentials = await db.query.credential.findMany({
+                where: (0, drizzle_solid_1.eq)(tables_2.Credential.provider, providerUri),
+            });
+            const activeCredential = credentials.find((c) => c.status === types_1.CredentialStatus.ACTIVE && c.service === types_1.ServiceType.AI);
+            // 构建凭证（可能为空，Executor 会处理）
+            const credential = {
+                providerId,
+                apiKey: activeCredential?.apiKey ?? '',
+                baseUrl: activeCredential?.baseUrl ?? provider.baseUrl ?? undefined,
+                projectId: activeCredential?.projectId ?? undefined,
+                organizationId: activeCredential?.organizationId ?? undefined,
+            };
+            // 5. 创建 Executor
+            const executorType = provider.executorType;
+            const executor = this.factory.createExecutor(executorType, {
+                providerId,
+                credential,
+                providerConfig: {
+                    id: providerId,
+                    displayName: provider.displayName ?? providerId,
+                    executorType,
+                    baseUrl: provider.baseUrl ?? undefined,
+                    defaultModel: provider.defaultModel ?? undefined,
+                    enabled: provider.enabled === 'true',
+                },
+            });
+            // 6. 构建执行器配置
+            const config = {
+                name: agentId,
+                description: agentConfig.description ?? undefined,
+                systemPrompt: agentConfig.systemPrompt ?? '',
+                model: agentConfig.model ?? provider.defaultModel ?? undefined,
+                maxTokens: 8192,
+            };
+            // 7. 返回实例
+            return {
+                id: agentId,
+                displayName: agentConfig.displayName ?? agentId,
+                description: agentConfig.description ?? '',
+                executor,
+                config,
+                status: 'idle',
+                startedAt: new Date(),
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to create agent ${agentId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * 发送消息给 Agent
+     *
+     * @param agentId Agent ID
+     * @param message 消息内容
+     * @param podBaseUrl Pod 根 URL
+     * @param authenticatedFetch 带认证的 fetch
+     * @param webId 用户 WebID
+     * @param accessToken OAuth token（用于 MCP）
+     */
+    async sendMessage(agentId, message, podBaseUrl, authenticatedFetch, webId, accessToken) {
+        // 1. 获取或创建实例
+        const instance = await this.getOrCreate(agentId, podBaseUrl, authenticatedFetch, webId);
+        if (!instance) {
+            return { success: false, error: `Agent not found or disabled: ${agentId}` };
+        }
+        // 2. 更新状态为 running
+        instance.status = 'running';
+        instance.lastActivityAt = new Date();
+        await this.updateStatus(agentId, 'running', podBaseUrl, authenticatedFetch, webId);
+        try {
+            // 3. 执行
+            const result = await instance.executor.executeAndWait(instance.config, message);
+            // 4. 更新状态
+            instance.status = 'idle';
+            instance.lastActivityAt = new Date();
+            await this.updateStatus(agentId, 'idle', podBaseUrl, authenticatedFetch, webId);
+            if (result.success) {
+                return { success: true, result: result.result };
+            }
+            else {
+                return { success: false, error: result.error };
+            }
+        }
+        catch (error) {
+            // 5. 错误处理
+            instance.status = 'error';
+            await this.updateStatus(agentId, 'error', podBaseUrl, authenticatedFetch, webId, error instanceof Error ? error.message : String(error));
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * 更新 Agent 状态到 Pod
+     */
+    async updateStatus(agentId, status, podBaseUrl, authenticatedFetch, webId, errorMessage) {
+        try {
+            const session = {
+                info: { isLoggedIn: true, webId },
+                fetch: authenticatedFetch,
+            };
+            const db = (0, drizzle_solid_1.drizzle)(session, { schema });
+            const now = new Date().toISOString();
+            // 先查询是否存在，再决定插入或更新
+            const existing = await db.query.agentStatus.findFirst({
+                where: (0, drizzle_solid_1.eq)(agent_config_1.AgentStatus.id, agentId),
+            });
+            if (existing) {
+                await db
+                    .update(agent_config_1.AgentStatus)
+                    .set({
+                    status,
+                    lastActivityAt: now,
+                    errorMessage: errorMessage ?? undefined,
+                })
+                    .where((0, drizzle_solid_1.eq)(agent_config_1.AgentStatus.id, agentId));
+            }
+            else {
+                await db.insert(agent_config_1.AgentStatus).values({
+                    id: agentId,
+                    agentId,
+                    status,
+                    startedAt: status === 'running' ? now : undefined,
+                    lastActivityAt: now,
+                    errorMessage: errorMessage ?? undefined,
+                });
+            }
+        }
+        catch (error) {
+            // 状态更新失败不影响主流程
+            this.logger.warn(`Failed to update agent status: ${error}`);
+        }
+    }
+    /**
+     * 获取 Agent 状态
+     */
+    getStatus(agentId) {
+        return this.instances.get(agentId);
+    }
+    /**
+     * 列出所有活跃的 Agent
+     */
+    listActiveAgents() {
+        return Array.from(this.instances.values()).filter((i) => this.isAlive(i));
+    }
+    /**
+     * 停止 Agent
+     */
+    async stop(agentId, podBaseUrl, authenticatedFetch, webId) {
+        const instance = this.instances.get(agentId);
+        if (instance) {
+            instance.status = 'idle';
+            await this.updateStatus(agentId, 'idle', podBaseUrl, authenticatedFetch, webId);
+            this.instances.delete(agentId);
+            this.logger.info(`Agent stopped: ${agentId}`);
+        }
+    }
+    /**
+     * 停止所有 Agent
+     */
+    async stopAll() {
+        for (const [agentId] of this.instances) {
+            this.instances.delete(agentId);
+            this.logger.info(`Agent stopped: ${agentId}`);
+        }
+    }
+}
+exports.AgentManager = AgentManager;
+/**
+ * 默认 AgentManager 实例
+ */
+exports.agentManager = new AgentManager();
+//# sourceMappingURL=AgentManager.js.map