@lingxiao-office/sdk 1.0.0

package/dist/agents/AgentCompletionNoteWriter.d.ts

@@ -0,0 +1,20 @@
+import type { ChatMessage } from '../llm/types.js';
+import type { AgentTask } from '../types/canonical.js';
+type LoggerLike = {
+    debug?: (msg: string, ...args: unknown[]) => void;
+    warn?: (msg: string, ...args: unknown[]) => void;
+};
+export interface AgentCompletionNoteInput {
+    workspace?: string;
+    sessionId: string;
+    agentId: string;
+    agentName: string;
+    role: string;
+    task: AgentTask;
+    result: string;
+    messages: ChatMessage[];
+    logger?: LoggerLike;
+}
+export declare function autoWriteAgentCompletionNote(input: AgentCompletionNoteInput): Promise<void>;
+export {};
+//# sourceMappingURL=AgentCompletionNoteWriter.d.ts.map

package/dist/agents/AgentCompletionNoteWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCompletionNoteWriter.d.ts","sourceRoot":"","sources":["../../src/agents/AgentCompletionNoteWriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjG"}

package/dist/agents/AgentCompletionNoteWriter.js

@@ -0,0 +1,26 @@
+import { WorkNoteManager } from '../core/WorkNoteManager.js';
+import { detectAgentPhase, extractAgentArtifactsFromMessages, } from './AgentRuntimeUtilities.js';
+export async function autoWriteAgentCompletionNote(input) {
+    try {
+        const manager = new WorkNoteManager(input.workspace ? `${input.workspace}/.lingxiao` : undefined);
+        const existingNotes = await manager.getAgentNotes(input.sessionId, input.agentId);
+        const hasRecentNote = existingNotes.some((note) => note.taskId === input.task.id && (Date.now() / 1000 - note.timestamp) < 300);
+        if (hasRecentNote) {
+            return;
+        }
+        const resultPreview = input.result.length > 1000 ? `${input.result.slice(0, 1000)}...` : input.result;
+        await manager.writeNoteWithSession(input.sessionId, {
+            agentId: input.agentId,
+            taskId: input.task.id,
+            phase: detectAgentPhase(input.task, input.role),
+            summary: `任务 ${input.task.id} 完成: ${input.task.subject}`,
+            details: resultPreview,
+            artifacts: extractAgentArtifactsFromMessages(input.messages),
+        });
+        input.logger?.debug?.(`[${input.agentName}] 自动写入完成笔记 (task=${input.task.id})`);
+    }
+    catch (error) {
+        input.logger?.warn?.(`[${input.agentName}] 自动写笔记失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=AgentCompletionNoteWriter.js.map

package/dist/agents/AgentCompletionNoteWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCompletionNoteWriter.js","sourceRoot":"","sources":["../../src/agents/AgentCompletionNoteWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EACL,gBAAgB,EAChB,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AAmBpC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAA+B;IAChF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAClG,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAChD,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,CAC5E,CAAC;QAEF,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QACtG,MAAM,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE;YAClD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACrB,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;YAC/C,OAAO,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;YACxD,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,iCAAiC,CAAC,KAAK,CAAC,QAAQ,CAAC;SAC7D,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC,SAAS,oBAAoB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,SAAS,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;AACH,CAAC"}

package/dist/agents/AgentContextController.d.ts

@@ -0,0 +1,14 @@
+import { type ChatMessage } from '../llm/types.js';
+export interface AgentContextControllerDeps {
+    maxMessages?: number;
+}
+export declare class AgentContextController {
+    private readonly maxMessages;
+    constructor(deps?: AgentContextControllerDeps);
+    addMessage(msg: ChatMessage, messages: ChatMessage[]): ChatMessage[];
+    collapseContractPacks(messages: ChatMessage[]): ChatMessage[];
+    isRuntimeContractPackMessage(msg: ChatMessage): boolean;
+    trimMessageBuffer(messages: ChatMessage[], protectedCount: number, _maxMessages?: number): ChatMessage[];
+}
+export default AgentContextController;
+//# sourceMappingURL=AgentContextController.d.ts.map

package/dist/agents/AgentContextController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContextController.d.ts","sourceRoot":"","sources":["../../src/agents/AgentContextController.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAOvE,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,GAAE,0BAA+B;IAIjD,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAOpE,qBAAqB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAa7D,4BAA4B,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAIvD,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,SAAmB,GAAG,WAAW,EAAE;CAenH;AAED,eAAe,sBAAsB,CAAC"}

package/dist/agents/AgentContextController.js

@@ -0,0 +1,50 @@
+import { config as runtimeConfig } from '../config.js';
+import { contentToPlainText } from '../llm/types.js';
+import { CONTRACT_PACK_MARKER } from '../core/ContractPack.js';
+import { stripOldImageParts, compactOldToolResults, } from './messageMemoryBudget.js';
+/** 受保护前缀长度（永不因 ring-buffer 截断而丢失的开头消息条数）。
+ *  此前错误地派生自 max_agent_messages（缓冲上限，默认 300）——与"前缀保护"无关的两个旋钮，
+ *  维护者无法定位 3 从何而来。改为独立命名常量。 */
+const PROTECTED_PREFIX_MESSAGES = 3;
+export class AgentContextController {
+    maxMessages;
+    constructor(deps = {}) {
+        this.maxMessages = Math.max(1, deps.maxMessages ?? runtimeConfig.agents.max_agent_messages);
+    }
+    addMessage(msg, messages) {
+        const nextMessage = msg.timestamp ? msg : { ...msg, timestamp: Date.now() / 1000 };
+        const next = [...messages, nextMessage];
+        const protectedCount = Math.max(1, Math.min(PROTECTED_PREFIX_MESSAGES, this.maxMessages));
+        return this.trimMessageBuffer(next, protectedCount, this.maxMessages);
+    }
+    collapseContractPacks(messages) {
+        let lastContractPackIndex = -1;
+        for (let i = 0; i < messages.length; i += 1) {
+            if (this.isRuntimeContractPackMessage(messages[i])) {
+                lastContractPackIndex = i;
+            }
+        }
+        if (lastContractPackIndex < 0) {
+            return messages;
+        }
+        return messages.filter((msg, index) => !this.isRuntimeContractPackMessage(msg) || index === lastContractPackIndex);
+    }
+    isRuntimeContractPackMessage(msg) {
+        return msg.role === 'system' && contentToPlainText(msg.content).trim().startsWith(CONTRACT_PACK_MARKER);
+    }
+    trimMessageBuffer(messages, protectedCount, _maxMessages = this.maxMessages) {
+        // 1. 剥离旧图片 base64
+        let trimmed = stripOldImageParts(messages, {
+            retainImageMessages: runtimeConfig.advanced.image_history_retain_rounds,
+            protectedCount,
+        });
+        // 2. 压缩旧 tool results
+        trimmed = compactOldToolResults(trimmed, {
+            retainRecentTurns: runtimeConfig.advanced.tool_result_retain_rounds,
+            protectedCount,
+        });
+        return trimmed;
+    }
+}
+export default AgentContextController;
+//# sourceMappingURL=AgentContextController.js.map

package/dist/agents/AgentContextController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContextController.js","sourceRoot":"","sources":["../../src/agents/AgentContextController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAoB,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAMlC;;+BAE+B;AAC/B,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEpC,MAAM,OAAO,sBAAsB;IAChB,WAAW,CAAS;IAErC,YAAY,OAAmC,EAAE;QAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9F,CAAC;IAED,UAAU,CAAC,GAAgB,EAAE,QAAuB;QAClD,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACnF,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,EAAE,WAAW,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,qBAAqB,CAAC,QAAuB;QAC3C,IAAI,qBAAqB,GAAG,CAAC,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,qBAAqB,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,qBAAqB,CAAC,CAAC;IACrH,CAAC;IAED,4BAA4B,CAAC,GAAgB;QAC3C,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC1G,CAAC;IAED,iBAAiB,CAAC,QAAuB,EAAE,cAAsB,EAAE,YAAY,GAAG,IAAI,CAAC,WAAW;QAChG,kBAAkB;QAClB,IAAI,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE;YACzC,mBAAmB,EAAE,aAAa,CAAC,QAAQ,CAAC,2BAA2B;YACvE,cAAc;SACf,CAAC,CAAC;QAEH,sBAAsB;QACtB,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE;YACvC,iBAAiB,EAAE,aAAa,CAAC,QAAQ,CAAC,yBAAyB;YACnE,cAAc;SACf,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,eAAe,sBAAsB,CAAC"}

package/dist/agents/AgentDefinitionService.d.ts

@@ -0,0 +1,79 @@
+/**
+ * AgentDefinitionService
+ *
+ * Canonical persistence for user-defined agents. The runtime still dispatches
+ * AgentRole, but custom definitions live as readable markdown files:
+ *
+ *   .lingxiao/agents/<name>.md
+ *
+ * YAML frontmatter stores structured fields; the markdown body is the system
+ * prompt. Project definitions override global definitions with the same name.
+ */
+import type { AgentRole } from './RoleRegistry.js';
+import { type PresetRoleName } from './RoleCapabilityModel.js';
+import type { SkillDescriptor } from '../core/SkillCatalog.js';
+export type AgentDefinitionScope = 'project' | 'global';
+export type AgentDefinitionSource = AgentDefinitionScope;
+export type AgentWorkerBackend = 'worker_process' | 'claude' | 'codex';
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    tools: string[];
+    skillNames: string[];
+    baseRoleName?: PresetRoleName;
+    model?: string;
+    worker_backend?: AgentWorkerBackend;
+    worker_config?: AgentRole['worker_config'];
+    gitIdentity?: {
+        name: string;
+        email: string;
+    };
+}
+export interface AgentDefinitionRecord extends AgentDefinition {
+    source: AgentDefinitionSource;
+    path: string;
+    editable: boolean;
+    shadowedBy?: AgentDefinitionSource;
+    updatedAt?: number;
+}
+export interface SaveAgentDefinitionInput {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    tools?: string[];
+    skillNames?: string[];
+    baseRoleName?: string;
+    model?: string;
+    worker_backend?: AgentWorkerBackend;
+    worker_config?: AgentRole['worker_config'];
+    gitIdentity?: {
+        name: string;
+        email: string;
+    };
+    scope?: AgentDefinitionScope;
+}
+export interface AgentDefinitionServiceOptions {
+    workspace?: string;
+    globalAgentsDir?: string;
+}
+export declare function validateAgentDefinitionName(name: string): string;
+export declare class AgentDefinitionService {
+    private readonly workspace;
+    private readonly globalAgentsDir?;
+    constructor(options?: AgentDefinitionServiceOptions);
+    getAgentsDir(scope: AgentDefinitionScope): string;
+    listDefinitions(options?: {
+        includeShadowed?: boolean;
+    }): AgentDefinitionRecord[];
+    getDefinition(name: string, options?: {
+        includeShadowed?: boolean;
+    }): AgentDefinitionRecord | null;
+    getDefinitionInScope(name: string, scope: AgentDefinitionScope): AgentDefinitionRecord | null;
+    saveDefinition(input: SaveAgentDefinitionInput): AgentDefinitionRecord;
+    deleteDefinition(name: string, scope?: AgentDefinitionScope): boolean;
+    toAgentRole(record: AgentDefinitionRecord, availableSkills?: SkillDescriptor[]): AgentRole;
+    listAgentRoles(availableSkills?: SkillDescriptor[]): AgentRole[];
+}
+export default AgentDefinitionService;
+//# sourceMappingURL=AgentDefinitionService.d.ts.map

package/dist/agents/AgentDefinitionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDefinitionService.d.ts","sourceRoot":"","sources":["../../src/agents/AgentDefinitionService.ts"],"names":[],"mappings":"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"}

package/dist/agents/AgentDefinitionService.js

@@ -0,0 +1,295 @@
+/**
+ * AgentDefinitionService
+ *
+ * Canonical persistence for user-defined agents. The runtime still dispatches
+ * AgentRole, but custom definitions live as readable markdown files:
+ *
+ *   .lingxiao/agents/<name>.md
+ *
+ * YAML frontmatter stores structured fields; the markdown body is the system
+ * prompt. Project definitions override global definitions with the same name.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { z } from 'zod';
+import { WORKER_TOOLS, PRESET_ROLE_PROFILES, resolveDynamicRoleCapability } from './RoleCapabilityModel.js';
+import { coreLogger } from '../core/Log.js';
+const VALID_AGENT_NAME_RE = /^[A-Za-z][A-Za-z0-9_-]{1,63}$/;
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+const WorkerConfigSchema = z.object({
+    env: z.record(z.string(), z.string()).optional(),
+    extra_args: z.array(z.string()).optional(),
+    timeout_ms: z.number().int().positive().optional(),
+    idle_timeout_ms: z.number().int().positive().optional(),
+    wire_api: z.enum(['chat', 'responses']).optional(),
+    no_bare: z.boolean().optional(),
+}).strict();
+const GitIdentitySchema = z.object({
+    name: z.string(),
+    email: z.string(),
+}).optional();
+const AgentDefinitionFrontmatterSchema = z.object({
+    name: z.string().optional(),
+    description: z.string().default(''),
+    baseRole: z.string().optional(),
+    baseRoleName: z.string().optional(),
+    model: z.string().optional(),
+    workerBackend: z.enum(['worker_process', 'claude', 'codex']).optional(),
+    worker_backend: z.enum(['worker_process', 'claude', 'codex']).optional(),
+    tools: z.array(z.string()).optional(),
+    skillNames: z.array(z.string()).optional(),
+    skills: z.array(z.string()).optional(),
+    worker_config: WorkerConfigSchema.optional(),
+    workerConfig: WorkerConfigSchema.optional(),
+    gitIdentity: GitIdentitySchema,
+    git_identity: GitIdentitySchema,
+}).passthrough();
+function unique(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function cleanOneLine(value) {
+    return value.replace(/\r?\n/g, ' ').replace(/\s+/g, ' ').trim();
+}
+export function validateAgentDefinitionName(name) {
+    const trimmed = name.trim().replace(/\.md$/i, '');
+    if (trimmed.includes('/') || trimmed.includes('\\') || basename(trimmed) !== trimmed) {
+        throw new Error('Invalid agent name. Do not include paths.');
+    }
+    if (!VALID_AGENT_NAME_RE.test(trimmed)) {
+        throw new Error('Invalid agent name. Use 2-64 chars: letters, numbers, hyphen, underscore; start with a letter.');
+    }
+    return trimmed;
+}
+function parsePresetRoleName(value) {
+    if (!value)
+        return undefined;
+    return value in PRESET_ROLE_PROFILES ? value : undefined;
+}
+function defaultAgentsDir(workspace, scope, globalAgentsDir) {
+    return scope === 'project'
+        ? join(resolve(workspace), '.lingxiao', 'agents')
+        : resolve(globalAgentsDir ?? join(homedir(), '.lingxiao', 'agents'));
+}
+function stripFrontmatter(raw) {
+    const match = raw.match(FRONTMATTER_RE);
+    if (!match) {
+        return { meta: {}, body: raw.trim() };
+    }
+    const parsed = parseYaml(match[1] || '');
+    const meta = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return { meta, body: raw.slice(match[0].length).trim() };
+}
+function renderDefinitionMarkdown(definition) {
+    const frontmatter = {
+        name: definition.name,
+        description: cleanOneLine(definition.description),
+    };
+    if (definition.baseRoleName)
+        frontmatter.baseRole = definition.baseRoleName;
+    if (definition.model)
+        frontmatter.model = definition.model;
+    if (definition.worker_backend && definition.worker_backend !== 'worker_process') {
+        frontmatter.workerBackend = definition.worker_backend;
+    }
+    if (definition.worker_config && Object.keys(definition.worker_config).length > 0) {
+        frontmatter.worker_config = definition.worker_config;
+    }
+    if (definition.tools.length > 0)
+        frontmatter.tools = definition.tools;
+    if (definition.skillNames.length > 0)
+        frontmatter.skillNames = definition.skillNames;
+    if (definition.gitIdentity)
+        frontmatter.gitIdentity = definition.gitIdentity;
+    return [
+        '---',
+        stringifyYaml(frontmatter).trimEnd(),
+        '---',
+        '',
+        definition.systemPrompt.trim(),
+        '',
+    ].join('\n');
+}
+function normalizeDefinition(input) {
+    const name = validateAgentDefinitionName(input.name);
+    const description = cleanOneLine(input.description || '');
+    if (!description) {
+        throw new Error('Agent description is required.');
+    }
+    const systemPrompt = input.systemPrompt.trim();
+    if (!systemPrompt) {
+        throw new Error('Agent systemPrompt is required.');
+    }
+    const baseRoleName = parsePresetRoleName(input.baseRoleName);
+    if (input.baseRoleName && !baseRoleName) {
+        throw new Error(`Unknown baseRoleName: ${input.baseRoleName}`);
+    }
+    return {
+        name,
+        description,
+        systemPrompt,
+        tools: unique(input.tools ?? []),
+        skillNames: unique(input.skillNames ?? []),
+        baseRoleName,
+        model: input.model?.trim() || undefined,
+        worker_backend: input.worker_backend ?? 'worker_process',
+        worker_config: input.worker_config,
+        gitIdentity: input.gitIdentity,
+    };
+}
+function parseDefinitionFile(path, fallbackName, source) {
+    const raw = readFileSync(path, 'utf-8');
+    const { meta, body } = stripFrontmatter(raw);
+    const parsed = AgentDefinitionFrontmatterSchema.safeParse(meta);
+    if (!parsed.success) {
+        throw new Error(`Invalid agent definition frontmatter in ${path}: ${parsed.error.issues.map((issue) => issue.message).join('; ')}`);
+    }
+    const fm = parsed.data;
+    const name = validateAgentDefinitionName(fm.name || fallbackName);
+    const description = cleanOneLine(fm.description || '');
+    if (!description || !body.trim()) {
+        return null;
+    }
+    const baseRoleName = parsePresetRoleName(fm.baseRoleName || fm.baseRole);
+    const stat = statSync(path);
+    return {
+        name,
+        description,
+        systemPrompt: body.trim(),
+        tools: unique(fm.tools ?? []),
+        skillNames: unique(fm.skillNames ?? fm.skills ?? []),
+        baseRoleName,
+        model: fm.model?.trim() || undefined,
+        worker_backend: fm.worker_backend ?? fm.workerBackend ?? 'worker_process',
+        worker_config: fm.worker_config ?? fm.workerConfig,
+        gitIdentity: fm.gitIdentity ?? fm.git_identity,
+        source,
+        path,
+        editable: true,
+        updatedAt: stat.mtimeMs,
+    };
+}
+export class AgentDefinitionService {
+    workspace;
+    globalAgentsDir;
+    constructor(options = {}) {
+        this.workspace = resolve(options.workspace ?? process.cwd());
+        this.globalAgentsDir = options.globalAgentsDir;
+    }
+    getAgentsDir(scope) {
+        return defaultAgentsDir(this.workspace, scope, this.globalAgentsDir);
+    }
+    listDefinitions(options = {}) {
+        const records = [];
+        for (const source of ['global', 'project']) {
+            const dir = this.getAgentsDir(source);
+            if (!existsSync(dir))
+                continue;
+            for (const entry of readdirSync(dir)) {
+                if (!entry.endsWith('.md'))
+                    continue;
+                const path = join(dir, entry);
+                if (!statSync(path).isFile())
+                    continue;
+                // Per-file guard: one malformed/hand-edited agent file (bad frontmatter or a
+                // name the loader rejects) must not crash the whole registry build — that would
+                // take down session startup. Skip + warn, keep loading the rest.
+                let record;
+                try {
+                    record = parseDefinitionFile(path, entry.replace(/\.md$/i, ''), source);
+                }
+                catch (err) {
+                    coreLogger.warn(`[AgentDefinitionService] Skipping malformed agent definition ${path}: ${err instanceof Error ? err.message : err}`);
+                    continue;
+                }
+                if (record)
+                    records.push(record);
+            }
+        }
+        const byName = new Map();
+        const shadowed = [];
+        for (const record of records.sort((a, b) => {
+            if (a.source !== b.source)
+                return a.source === 'project' ? -1 : 1;
+            return a.name.localeCompare(b.name);
+        })) {
+            if (!byName.has(record.name)) {
+                byName.set(record.name, record);
+            }
+            else {
+                shadowed.push({ ...record, shadowedBy: byName.get(record.name)?.source });
+            }
+        }
+        const visible = Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
+        return options.includeShadowed
+            ? [...visible, ...shadowed.sort((a, b) => a.name.localeCompare(b.name))]
+            : visible;
+    }
+    getDefinition(name, options = {}) {
+        const normalized = validateAgentDefinitionName(name);
+        return this.listDefinitions(options).find((record) => record.name === normalized) ?? null;
+    }
+    getDefinitionInScope(name, scope) {
+        const normalized = validateAgentDefinitionName(name);
+        const path = join(this.getAgentsDir(scope), `${normalized}.md`);
+        if (!existsSync(path) || !statSync(path).isFile())
+            return null;
+        return parseDefinitionFile(path, normalized, scope);
+    }
+    saveDefinition(input) {
+        const scope = input.scope ?? 'project';
+        const definition = normalizeDefinition(input);
+        const dir = this.getAgentsDir(scope);
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, `${definition.name}.md`);
+        writeFileSync(path, renderDefinitionMarkdown(definition), 'utf-8');
+        return {
+            ...definition,
+            source: scope,
+            path,
+            editable: true,
+            updatedAt: statSync(path).mtimeMs,
+        };
+    }
+    deleteDefinition(name, scope = 'project') {
+        const normalized = validateAgentDefinitionName(name);
+        const path = join(this.getAgentsDir(scope), `${normalized}.md`);
+        if (!existsSync(path))
+            return false;
+        rmSync(path, { force: true });
+        return true;
+    }
+    toAgentRole(record, availableSkills = []) {
+        const resolved = resolveDynamicRoleCapability({
+            roleName: record.name,
+            roleDescription: record.description,
+            systemPrompt: record.systemPrompt,
+            requestedTools: record.tools.length > 0 ? record.tools : WORKER_TOOLS,
+            availableSkills,
+            requestedSkillNames: record.skillNames,
+            baseRoleName: record.baseRoleName,
+        });
+        return {
+            name: record.name,
+            description: record.description,
+            systemPrompt: record.systemPrompt,
+            tools: resolved.tools,
+            droppedTools: resolved.droppedTools,
+            skillNames: resolved.skillNames,
+            capabilityProfile: resolved.capabilityProfile,
+            model: record.model,
+            worker_backend: record.worker_backend,
+            worker_config: record.worker_config,
+            gitIdentity: record.gitIdentity,
+            createdBy: 'user',
+        };
+    }
+    listAgentRoles(availableSkills = []) {
+        return this.listDefinitions().map((record) => this.toAgentRole(record, availableSkills));
+    }
+}
+export default AgentDefinitionService;
+//# sourceMappingURL=AgentDefinitionService.js.map

package/dist/agents/AgentDefinitionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDefinitionService.js","sourceRoot":"","sources":["../../src/agents/AgentDefinitionService.ts"],"names":[],"mappings":"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"}

package/dist/agents/AgentExecutionResult.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AgentExecutionResult - Worker 结构化返回类型
+ *
+ * 借鉴 CCSM 的状态驱动执行，Worker 完成时返回结构化结果而非纯文本：
+ * - status: 执行状态 (completed/failed/blocked)
+ * - summary: 简短摘要
+ * - outputs: 结构化输出数组 (实现证据、测试结果、诊断信息、文件变更)
+ * - metadata: 元数据 (文件列表、测试统计、执行时长)
+ */
+import type { RecoveryFaultClass } from '../core/RecoveryRecords.js';
+import type { LLMErrorKind } from '../llm/errors.js';
+export type ExecutionStatus = 'completed' | 'failed' | 'blocked';
+export type ExecutionOutputType = 'implementation_evidence' | 'test_result' | 'diagnostic' | 'file_change' | 'error_trace' | 'performance_metric';
+export interface ExecutionOutput {
+    type: ExecutionOutputType;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentExecutionResult {
+    status: ExecutionStatus;
+    summary: string;
+    outputs: ExecutionOutput[];
+    metadata: {
+        filesChanged: string[];
+        testsRun?: number;
+        testsPassed?: number;
+        testsFailed?: number;
+        duration: number;
+        iterations?: number;
+        toolCalls?: number;
+        recoverable?: boolean;
+        faultClass?: RecoveryFaultClass;
+        llmErrorKind?: LLMErrorKind;
+        terminalKind?: 'failed' | 'recovering' | 'terminated';
+        statusReason?: string;
+        runtimePhase?: 'execute' | 'conclude';
+    };
+}
+/**
+ * 创建成功的执行结果
+ */
+export declare function createSuccessResult(input: {
+    summary: string;
+    filesChanged: string[];
+    duration: number;
+    additionalOutputs?: ExecutionOutput[];
+    metadata?: Partial<AgentExecutionResult['metadata']>;
+}): AgentExecutionResult;
+/**
+ * 创建失败的执行结果
+ */
+export declare function createFailureResult(input: {
+    summary: string;
+    error: string;
+    duration: number;
+    diagnostics?: string[];
+    metadata?: Partial<AgentExecutionResult['metadata']>;
+}): AgentExecutionResult;
+/**
+ * 创建阻塞的执行结果
+ */
+export declare function createBlockedResult(input: {
+    summary: string;
+    reason: string;
+    duration: number;
+    metadata?: Partial<AgentExecutionResult['metadata']>;
+}): AgentExecutionResult;
+//# sourceMappingURL=AgentExecutionResult.d.ts.map

package/dist/agents/AgentExecutionResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentExecutionResult.d.ts","sourceRoot":"","sources":["../../src/agents/AgentExecutionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,aAAa,GACb,oBAAoB,CAAC;AAEzB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAKhC,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,YAAY,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;QACtD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;CACtD,GAAG,oBAAoB,CAmBvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;CACtD,GAAG,oBAAoB,CA2BvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;CACtD,GAAG,oBAAoB,CAgBvB"}