@xopcai/xopc 0.0.352 → 0.0.353

package/dist/src/agent/tool-manuals/xopc-use.js

@@ -51,9 +51,9 @@ to a TaskRun. Never treat these three objects as interchangeable.
 Commands: \`list\`, \`get\`, \`create\`, \`update\`, \`set_default\`, \`disable\`,
 \`delete\`, and \`purge\`.
 
-An Agent profile accepts only \`name\` and optional \`instructions\`. Put personality,
-language, role, and behavioral guidance in \`profile.instructions\`; do not invent profile
-fields such as \`description\`, \`language\`, \`emoji\`, or \`creature\`.
+An Agent profile stores \`name\` and optional \`description\`, \`creature\`, \`style\`, \`language\`,
+\`emoji\`, and \`avatar\` identity fields. Use \`instructions\` for short execution rules.
+Put personality in SOUL.md and ongoing work guidance in AGENTS.md.
 
 \`\`\`json
 {
@@ -63,7 +63,10 @@ fields such as \`description\`, \`language\`, \`emoji\`, or \`creature\`.
     "id": "xiaomei",
     "profile": {
       "name": "小美",
-      "instructions": "使用中文交流，语气温柔、亲切、可爱，同时保持回答清晰可靠。"
+      "description": "帮助整理日常事项",
+      "language": "zh-CN",
+      "style": "温柔、亲切",
+      "instructions": "给出操作建议前先核对关键事实。"
     },
     "idempotencyKey": "create-agent-xiaomei"
   }

package/dist/src/agent/tools/create-share-tool.js

@@ -1,15 +1,15 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
-import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { resolveShareConfig } from "../../share/share-config.js";
 import { mergeWithDefaults } from "../../share/site-share-config.js";
 import { getShareStore } from "../../share/share-store.js";
 import { getSiteShareStore } from "../../share/site-share-store.js";
 import { resolveShareUrl, resolveSiteShareUrl } from "../../share/share-url.js";
 import { publishHostedStaticSite } from "../../share/hosted-static-site-publish.js";
+import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
 import { scheduleThumbnail } from "../../share/share-thumbnail.js";
 import { resolveToolLocale, shareToolErrorLine, shareToolSuccessLines } from "../../i18n/share-tool-bundle.js";

package/dist/src/agent/tools/dataBatch.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { renderDataBatch } from "../data-acquisition/render.js";
 import { DataBatchSchema } from "../data-acquisition/schema.js";
 import { acquireData } from "../data-acquisition/service.js";
+import { renderDataBatch } from "../data-acquisition/render.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/agent/tools/dataBatch.ts
 init_logger();

package/dist/src/agent/tools/delegate-tool.js

@@ -1,11 +1,11 @@
-import { runGit } from "../../execution-environments/git.js";
-import { LocalWorktreeManager } from "../../execution-environments/local-worktree-manager.js";
-import { SessionEnvironmentService } from "../../execution-environments/session-environment-service.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import "../external-tools/index.js";
 import { getDelegationScope } from "../orchestration/delegation-scope.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
+import { runGit } from "../../execution-environments/git.js";
+import { LocalWorktreeManager } from "../../execution-environments/local-worktree-manager.js";
+import { SessionEnvironmentService } from "../../execution-environments/session-environment-service.js";
 import { DELEGATION_CAPABILITIES, DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "./delegation-policy.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/delegate-tool.ts

package/dist/src/agent/tools/delegation-parent-policy.js

@@ -1,6 +1,6 @@
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { mcpToolPolicyId } from "../mcp/bundle-mcp-policy.js";
 import { parseExternalToolRef } from "../external-tools/refs.js";
+import { mcpToolPolicyId } from "../mcp/bundle-mcp-policy.js";
 import { createAgentTurnPolicy } from "../orchestration/agent-turn-policy.js";
 //#region src/agent/tools/delegation-parent-policy.ts
 /** Noninteractive callers cannot silently turn an ask policy into an allow. */

package/dist/src/agent/tools/executor.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { withRetry } from "../../infra/retry.js";
 import { commandTimeout } from "../commands/command-registry.js";
 import { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, TimeoutError, executeWithTimeout } from "../lifecycle/timeout-wrapper.js";
+import { withRetry } from "../../infra/retry.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 //#region src/agent/tools/executor.ts
 init_logger();

package/dist/src/agent/tools/factory.d.ts

@@ -93,7 +93,7 @@ export interface CreateCoreToolsOptions {
     createDelegationPolicy?: () => import('../orchestration/agent-turn-policy.js').AgentTurnPolicy;
     /** Workspace root for file/command tools (defaults to factory workspace). */
     workspace?: string;
-    /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */
+    /** Canonical `agents/<id>/profile/`: bare SOUL.md resolve here after the workspace. */
     profileMarkdownRoot?: string;
     /** Tool `name` values to omit (e.g. `exec_command`, `extensions` for extension tools). */
     disabledTools?: Set<string>;

package/dist/src/agent/tools/factory.js

@@ -7,27 +7,16 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../../packages/browser-control-contract/src/index.js";
-import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
-import { checkBrowserReadiness } from "../../browser/readiness.js";
-import "../../browser/index.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { ComputerRuntime } from "../../computer/runtime.js";
-import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
-import { skillEnvironmentId } from "../skills/installer.js";
+import "../../../packages/browser-control-contract/src/index.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
-import { createDelegateTool } from "./delegate-tool.js";
-import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { skillEnvironmentId } from "../skills/installer.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -50,7 +39,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import "../../browser/index.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
+import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
+import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
@@ -65,10 +61,14 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
+import { ComputerRuntime } from "../../computer/runtime.js";
 import { createComputerUseTool } from "./computer-use-tool.js";
 import { createReviewWorkspaceTool } from "./review-workspace.js";
 import { createLanguageDiagnosticsTool } from "./language-diagnostics.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
 import "../capabilities/index.js";

package/dist/src/agent/tools/fetch-text.js

@@ -1,6 +1,6 @@
 import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
-import { lookup } from "node:dns";
 import { Agent, fetch } from "undici";
+import { lookup } from "node:dns";
 //#region src/agent/tools/fetch-text.ts
 /** Validate each redirect and the address actually used for the connection. */
 async function fetchPublicText(input, blocklist, signal) {

package/dist/src/agent/tools/image-generate-tool.js

@@ -1,12 +1,12 @@
 import { getAgentDefaultImageGenerationModelConfig, init_schema } from "../../config/schema.js";
+import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
-import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
+import { persistToolMedia } from "./tool-media.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";
 import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.js";
-import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
-import { persistToolMedia } from "./tool-media.js";
 import { isFailoverError } from "../failover-error.js";
+import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
 import path from "node:path";
 import { randomBytes } from "node:crypto";

package/dist/src/agent/tools/index.js

@@ -1,13 +1,8 @@
-import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../browser/index.js";
 import { DEFAULT_TOOL_METADATA, getToolMetadata } from "./metadata.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
-import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize, truncateHead, truncateLine, truncateTail } from "./truncate.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -31,6 +26,11 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import "../../browser/index.js";
+import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
+import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";

package/dist/src/agent/tools/list-dir.js

@@ -1,5 +1,5 @@
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { checkedFilePath } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { readdir } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/list-dir.ts

package/dist/src/agent/tools/publish-artifacts.js

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename, isAbsolute, relative, sep } from "node:path";
 import { realpath } from "node:fs/promises";

package/dist/src/agent/tools/read.js

@@ -1,8 +1,8 @@
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { checkedFilePath, readWorkspaceFileAsync } from "../sandbox/fileAccess.js";
-import { checkFileSafety } from "../prompt/safety.js";
 import { dataScheduler } from "../data-acquisition/scheduler.js";
+import { checkFileSafety } from "../prompt/safety.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { stat } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/read.ts

package/dist/src/agent/tools/review-workspace.js

@@ -1,5 +1,5 @@
-import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
+import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { checkedFilePath, readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolve } from "node:path";

package/dist/src/agent/tools/send-media.js

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { MEDIA_MAX_BYTES } from "../../media/store.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { MEDIA_MAX_BYTES } from "../../media/store.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/skills-tools.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/tts-tool.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { speak } from "../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat } from "../../voice/tts/service.js";
-import { speak } from "../../voice/tts/speak-core.js";
 import { compressAudio } from "../../voice/tts/audio.js";
 import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/user-context-tool.js

@@ -1,7 +1,7 @@
+import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { deleteUserAssertion, getAssertionSlot, getUserAssertion, listUserAssertionSources, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../user-model/repository.js";
 import { canUseAssertion } from "../../user-model/usage-policy.js";
 import "../../user-model/index.js";
-import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/user-context-tool.ts
 const SearchSchema = Type.Object({

package/dist/src/agent/tools/write.js

@@ -1,9 +1,9 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { basename, relative, sep } from "path";
 import { realpath } from "fs/promises";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/xopc-use-tool.js

@@ -13,19 +13,19 @@ import "../../activity/index.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import "../../capabilities/runtime/dispatcher.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";
 import { TaskDeleteOutputSchema } from "../../tasks/capabilities/management.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema } from "../../automations/capabilities/write.js";
 import { TaskMutationOutputSchema } from "../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { localAppCapabilities } from "../../local-apps/capabilities/runtime.js";
 import { defineTaskContract } from "../../tasks/task-contract-definition.js";
+import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/workflow/subagent-runner.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { createSqliteTranscriptRuntime } from "../embedded/transcript-runtime.js";
-import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
 import { DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "../tools/delegation-policy.js";
 import { DELEGATE_BLOCKED_TOOLS } from "../tools/delegate-tool.js";
 import { createDelegationParentPolicy } from "../tools/delegation-parent-policy.js";
+import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 //#region src/agent/workflow/subagent-runner.ts
 init_logger();
 const log = createLogger("Agent:WorkflowSubagent");

package/dist/src/agent-catalog/migrations/identity-markdown-cutover.d.ts

@@ -0,0 +1,5 @@
+import type { AgentProfile } from '../../agent-config/index.js';
+/** Parse only known identity fields. The original document is archived after migration. */
+export declare function parseIdentityFieldsForCutover(content: string): Partial<AgentProfile>;
+/** One-time upgrade. Runtime never reads the retired identity document. */
+export declare function migrateIdentityMarkdownToCatalog(): void;

package/dist/src/agent-catalog/migrations/identity-markdown-cutover.js

@@ -0,0 +1,94 @@
+import { getXopcDatabase } from "../../storage/sqlite/connection.js";
+import { init_sqlite } from "../../storage/sqlite/index.js";
+import { AgentCatalogRepository, init_repository } from "../repository.js";
+import { init_agent_scope, resolveAgentProfileDir } from "../../agent/agent-scope.js";
+import { join } from "node:path";
+import { existsSync, readFileSync, renameSync } from "node:fs";
+//#region src/agent-catalog/migrations/identity-markdown-cutover.ts
+init_agent_scope();
+init_sqlite();
+init_repository();
+const MIGRATION_ID = "agent-identity-structured-v1";
+const FIELDS = {
+	name: "name",
+	名称: "name",
+	description: "description",
+	简介: "description",
+	一句话介绍: "description",
+	职责: "description",
+	creature: "creature",
+	type: "creature",
+	role: "creature",
+	类型: "creature",
+	角色: "creature",
+	vibe: "style",
+	style: "style",
+	风格: "style",
+	表达风格: "style",
+	language: "language",
+	语言: "language",
+	主要语言: "language",
+	emoji: "emoji",
+	签名表情: "emoji",
+	表情: "emoji",
+	avatar: "avatar",
+	头像: "avatar",
+	头像地址: "avatar"
+};
+/** Parse only known identity fields. The original document is archived after migration. */
+function parseIdentityFieldsForCutover(content) {
+	const fields = {};
+	for (const line of content.split(/\r?\n/)) {
+		const match = /^\s*[-*]\s+\*\*([^*:：]+?)(?:[:：]\*\*|\*\*[:：])\s*(.*)$/.exec(line);
+		if (!match) continue;
+		const key = FIELDS[match[1].trim().toLowerCase()];
+		const value = match[2].trim();
+		if (key && value && !/^_\(.*\)_$/.test(value)) fields[key] = value;
+	}
+	return fields;
+}
+/** One-time upgrade. Runtime never reads the retired identity document. */
+function migrateIdentityMarkdownToCatalog() {
+	const database = getXopcDatabase().db;
+	if (database.prepare("SELECT state FROM application_migrations WHERE id = ?").get(MIGRATION_ID)?.state === "completed") return;
+	const repository = new AgentCatalogRepository();
+	const migratedPaths = [];
+	for (const agent of repository.list()) {
+		const source = join(resolveAgentProfileDir(agent.id), "IDENTITY.md");
+		if (!existsSync(source)) continue;
+		const fields = parseIdentityFieldsForCutover(readFileSync(source, "utf8"));
+		const current = agent.profile;
+		const profile = {
+			name: current?.name || fields.name || agent.id,
+			...Object.fromEntries([
+				"description",
+				"creature",
+				"style",
+				"language",
+				"emoji",
+				"avatar"
+			].filter((key) => current?.[key] || fields[key]).map((key) => [key, current?.[key] || fields[key]])),
+			...current?.instructions ? { instructions: current.instructions } : {}
+		};
+		const { revision, provisioningState: _provisioningState, provisioningError: _provisioningError, createdAt: _createdAt, updatedAt: _updatedAt, deletedAt: _deletedAt, ...entry } = agent;
+		repository.update(agent.id, revision, {
+			...entry,
+			profile
+		});
+		migratedPaths.push({
+			source,
+			backup: join(resolveAgentProfileDir(agent.id), ".identity-migration-backup")
+		});
+	}
+	for (const { source, backup } of migratedPaths) {
+		if (existsSync(backup)) throw new Error(`Identity migration backup already exists: ${backup}`);
+		renameSync(source, backup);
+	}
+	const now = Date.now();
+	database.prepare(`INSERT INTO application_migrations
+    (id, state, source_digest, source_backup_path, database_backup_path, error_json,
+     started_at, completed_at, updated_at)
+    VALUES (?, 'completed', NULL, NULL, NULL, NULL, ?, ?, ?)`).run(MIGRATION_ID, now, now, now);
+}
+//#endregion
+export { migrateIdentityMarkdownToCatalog, parseIdentityFieldsForCutover };

package/dist/src/agent-catalog/repository.js

@@ -81,7 +81,13 @@ var init_repository = __esmMin((() => {
 				db.prepare(`INSERT OR IGNORE INTO agents
         (id, enabled, workspace_override, profile_json, overrides_json, provisioning_state,
          provisioning_error, revision, created_at, updated_at, deleted_at)
-        VALUES (?, 1, NULL, ?, '{}', 'pending', NULL, 1, ?, ?, NULL)`).run(DEFAULT_AGENT_ID, JSON.stringify({ name: "Main" }), now, now);
+        VALUES (?, 1, NULL, ?, '{}', 'pending', NULL, 1, ?, ?, NULL)`).run(DEFAULT_AGENT_ID, JSON.stringify({
+					name: "Smart Assistant",
+					description: "General-purpose personal assistant.",
+					creature: "assistant",
+					language: "en",
+					emoji: "✨"
+				}), now, now);
 				db.prepare(`INSERT OR IGNORE INTO agent_catalog_settings
         (singleton_id, default_agent_id, defaults_json, revision, created_at, updated_at)
         VALUES (1, ?, ?, 1, ?, ?)`).run(DEFAULT_AGENT_ID, JSON.stringify(AgentDefaultsSchema.parse(defaults)), now, now);

package/dist/src/agent-catalog/service.js

@@ -155,7 +155,7 @@ var AgentCatalogService = class {
 		await mkdir(workspace, { recursive: true });
 		await mkdir(resolveAgentDir(entry.id), { recursive: true });
 		await mkdir(profileDir, { recursive: true });
-		seedAgentProfileMarkdownFiles(profileDir, workspace, { displayName: entry.profile?.name ?? entry.id });
+		seedAgentProfileMarkdownFiles(profileDir, workspace);
 	}
 	provisionSync(entry) {
 		const workspace = workspaceForEntry(entry, this.repository.getSettings().defaultAgentId);
@@ -163,7 +163,7 @@ var AgentCatalogService = class {
 		mkdirSync(workspace, { recursive: true });
 		mkdirSync(resolveAgentDir(entry.id), { recursive: true });
 		mkdirSync(profileDir, { recursive: true });
-		seedAgentProfileMarkdownFiles(profileDir, workspace, { displayName: entry.profile?.name ?? entry.id });
+		seedAgentProfileMarkdownFiles(profileDir, workspace);
 	}
 	purgeEntryDataSync(entry, defaultAgentId) {
 		if (entry.id === "main") throw new Error("Refusing to purge the primary Agent");

package/dist/src/agent-config/schema.d.ts

@@ -243,6 +243,12 @@ export declare const AgentDefaultsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const AgentProfileSchema: z.ZodObject<{
     name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    creature: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    emoji: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
     instructions: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const AgentEntrySchema: z.ZodObject<{
@@ -251,6 +257,12 @@ export declare const AgentEntrySchema: z.ZodObject<{
     workspace: z.ZodOptional<z.ZodString>;
     profile: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        creature: z.ZodOptional<z.ZodString>;
+        style: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        emoji: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
         instructions: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     models: z.ZodOptional<z.ZodObject<{
@@ -340,6 +352,12 @@ export declare const EffectiveAgentConfigSchema: z.ZodObject<{
     workspace: z.ZodString;
     profile: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        creature: z.ZodOptional<z.ZodString>;
+        style: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        emoji: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
         instructions: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     models: z.ZodObject<{
@@ -426,6 +444,7 @@ export type AgentModelsDefaults = z.infer<typeof AgentModelsDefaultsSchema>;
 export type AgentModelsOverride = z.infer<typeof AgentModelsOverrideSchema>;
 export type ModelIntent = z.infer<typeof ModelIntentSchema>;
 export type AgentDefaults = z.infer<typeof AgentDefaultsSchema>;
+export type AgentProfile = z.infer<typeof AgentProfileSchema>;
 export type AgentEntry = z.infer<typeof AgentEntrySchema>;
 export type EffectiveAgentConfig = z.infer<typeof EffectiveAgentConfigSchema>;
 export type SkillDefaults = z.infer<typeof SkillDefaultsSchema>;

package/dist/src/agent-config/schema.js

@@ -115,6 +115,12 @@ var init_schema = __esmMin((() => {
 	}).strict();
 	AgentProfileSchema = z.object({
 		name: z.string().trim().min(1),
+		description: z.string().trim().optional(),
+		creature: z.string().trim().optional(),
+		style: z.string().trim().optional(),
+		language: z.string().trim().optional(),
+		emoji: z.string().trim().optional(),
+		avatar: z.string().trim().optional(),
 		instructions: z.string().trim().min(1).optional()
 	}).strict();
 	AgentEntrySchema = z.object({
@@ -133,10 +139,7 @@ var init_schema = __esmMin((() => {
 		id: AgentIdSchema,
 		enabled: z.boolean(),
 		workspace: z.string().min(1),
-		profile: z.object({
-			name: z.string().min(1),
-			instructions: z.string().optional()
-		}).strict().optional(),
+		profile: AgentProfileSchema.optional(),
 		models: AgentModelsDefaultsSchema,
 		skills: SkillDefaultsSchema,
 		tools: ToolPoliciesSchema,

package/dist/src/ai-assist/text-assist.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../usage/recorder.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { normalizeContext } from "@earendil-works/pi-ai";
 //#region src/ai-assist/text-assist.ts
 init_providers();

package/dist/src/auth/credentials.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
-import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
+import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
+import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { init_oauth_provider_lock, withOAuthProviderLock } from "./oauth-provider-lock.js";
 import { dirname, join } from "path";
 import { mkdir, readFile, readdir, rm } from "fs/promises";

package/dist/src/auth/profiles/store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import path from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 //#region src/auth/profiles/store.ts

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**