@xopcai/xopc 0.0.104 → 0.0.105

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

@@ -1,11 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
-import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
-import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
-import { BrowserManager } from "../../browser/manager.js";
-import { checkBrowserReadiness } from "../../browser/readiness.js";
-import "../../browser/index.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createEditFileTool } from "./edit.js";
@@ -26,6 +21,11 @@ import { createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserManager } from "../../browser/manager.js";
+import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
+import "../../browser/index.js";
 import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowTool } from "./workflow-tool.js";

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

@@ -1,6 +1,3 @@
-import { BrowserManager } from "../../browser/manager.js";
-import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
-import "../../browser/index.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 { createWriteFileTool, writeFileTool } from "./write.js";
@@ -23,6 +20,9 @@ import { TodoStore, createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserManager } from "../../browser/manager.js";
+import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
+import "../../browser/index.js";
 import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { SANDBOX_ALLOWED_TOOLS, buildSandboxToolMap, createExecuteCodeTool } from "./execute-code-tool.js";

package/dist/src/agent/tools/session-search-tool.js

@@ -2,8 +2,8 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
-import { Type } from "@sinclair/typebox";
 import { complete } from "@earendil-works/pi-ai";
+import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/session-search-tool.ts
 init_providers();
 init_logger();

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

@@ -1,6 +1,6 @@
 import { evaluateExecPolicy } from "../sandbox/exec-policy.js";
-import { Type } from "@sinclair/typebox";
 import { spawn } from "child_process";
+import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/shell.ts
 const MAX_SHELL_TIMEOUT = 300;
 const DEFAULT_MAX_BYTES = 50 * 1024;

package/dist/src/agent/tools/web-extract.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from "./url-safety.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
-import { Type } from "@sinclair/typebox";
+import { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from "./url-safety.js";
 import { complete } from "@earendil-works/pi-ai";
+import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/web-extract.ts
 init_providers();
 init_logger();

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

@@ -1,6 +1,6 @@
-import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
 import { SearchProviderRegistry } from "./search/registry.js";
 import { resolveWebSearchConfig } from "./search/resolve-config.js";
+import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/web.ts
 const WebSearchSchema = Type.Object({

package/dist/src/browser/actions/extension-registry-bridge.js

@@ -1,7 +1,7 @@
+import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
 import { resolveBrowserCommandTimeoutMs } from "../browser-command-timeout.js";
 import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern } from "../url-policy.js";
 import { truncateSnapshotAtBoundary } from "../snapshot-helpers.js";
-import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
 //#region src/browser/actions/extension-registry-bridge.ts
 /**
 * Runs browser registry actions against the Chrome Extension bridge (no Playwright page).

package/dist/src/browser/actions/registry.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
 import { resolveBrowserCommandTimeoutMs } from "../browser-command-timeout.js";
-import { humanizedClick, humanizedFill, humanizedScroll } from "../humanize.js";
 import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern } from "../url-policy.js";
 import { truncateSnapshotAtBoundary } from "../snapshot-helpers.js";
-import { checkWebsiteBlocklist } from "../../agent/tools/url-safety.js";
+import { humanizedClick, humanizedFill, humanizedScroll } from "../humanize.js";
 //#region src/browser/actions/registry.ts
 init_logger();
 const log = createLogger("BrowserActionRegistry");

package/dist/src/browser/cdp-local-launcher.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { pickFreePort } from "./free-port.js";
 import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
+import { pickFreePort } from "./free-port.js";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
 import { join } from "node:path";

package/dist/src/browser/index.js

@@ -1,13 +1,13 @@
+import { BrowserManager } from "./manager.js";
 import { resolveBrowserBackendFromConfig } from "./backend-from-config.js";
 import { resolveBrowserCommandTimeoutMs } from "./browser-command-timeout.js";
-import { CdpSupervisor } from "./cdp-supervisor.js";
-import { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig } from "./humanize.js";
-import { BrowserManager } from "./manager.js";
 import { BrowserNotReadyError, buildBrowserSetupDeepLink, checkBrowserReadiness } from "./readiness.js";
 import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern, isAlwaysBlockedUrl } from "./url-policy.js";
+import { CdpSupervisor } from "./cdp-supervisor.js";
 import { snapshotSummaryHeader, truncateSnapshotAtBoundary } from "./snapshot-helpers.js";
 import { checkBotDetection, cleanupOrphanProcesses, startTracing, stopTracing } from "./session-lifecycle.js";
 import { BrowserBackSchema, BrowserCdpSchema, BrowserClickSchema, BrowserCloseSchema, BrowserConsoleSchema, BrowserDialogSchema, BrowserGetImagesSchema, BrowserNavigateSchema, BrowserPressSchema, BrowserScreenshotSchema, BrowserScrollSchema, BrowserSnapshotSchema, BrowserTypeSchema, BrowserVisionSchema } from "./schemas.js";
+import { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig } from "./humanize.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildLocalStealthArgs, buildStealthArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "./stealth.js";
 import { createBrowserActionRegistry } from "./actions/registry.js";
 import { parseBrowserPipeline } from "./pipeline/schema.js";

package/dist/src/browser/providers/browser-ext-install.js

@@ -8,8 +8,8 @@ import { resolvePackageRoot } from "../../infra/update-check.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { readFile, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.

package/dist/src/browser/providers/cloakbrowser.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
-import { pickFreePort } from "../free-port.js";
 import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildStealthArgs, filterCloakBrowserExtraArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "../stealth.js";
+import { pickFreePort } from "../free-port.js";
 import { createHash } from "node:crypto";
 import { createReadStream, createWriteStream } from "node:fs";
 import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";

package/dist/src/cli/commands/browser-cli-helpers.js

@@ -1,7 +1,7 @@
 import { init_loader, loadConfig } from "../../config/loader.js";
-import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
 import { loadPlaywrightCoreModule } from "../../browser/providers/playwright-doctor.js";
 import { BrowserManager } from "../../browser/manager.js";
+import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
 import { createBrowserActionRegistry } from "../../browser/actions/registry.js";
 import { runBrowserPipeline, validateBrowserPipeline } from "../../browser/pipeline/runner.js";
 import { loadBrowserPipelineSource } from "../../browser/pipeline/source.js";

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v4).`,
+		message: `SQLite schema v${status.dbVersion} (current release v5).`,
 		hints: []
 	};
 }

package/dist/src/config/paths.d.ts

@@ -183,6 +183,7 @@ export declare function resolveSkillsCachePath(config: Config, agentId: string):
  * Resolve the bundled extensions directory (shipped with xopc).
  *
  * Layout-dependent candidates (first existing wins):
+ * - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)
  * - `dist/src/config` → `dist/extensions` (npm / gateway)
  * - `src/config` → `extensions/` (dev, tsx)
  * - `out/server` → `dist/extensions` (Electron esbuild bundle)

package/dist/src/config/paths.js

@@ -237,11 +237,14 @@ function resolveSkillsCachePath(config, agentId) {
 * Resolve the bundled extensions directory (shipped with xopc).
 *
 * Layout-dependent candidates (first existing wins):
+* - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)
 * - `dist/src/config` → `dist/extensions` (npm / gateway)
 * - `src/config` → `extensions/` (dev, tsx)
 * - `out/server` → `dist/extensions` (Electron esbuild bundle)
 */
 function resolveBundledExtensionsDir() {
+	const envDir = process.env[ENV_BUNDLED_EXTENSIONS_ROOT];
+	if (envDir && existsSync(envDir)) return envDir;
 	try {
 		const srcDir = dirname(fileURLToPath(import.meta.url));
 		const candidates = [
@@ -287,11 +290,12 @@ function resolveExtensionSdkPath() {
 		return join(process.cwd(), "src", "extensions", "sdk", "index.ts");
 	}
 }
-var FILENAMES, WORKSPACE_FILES;
+var ENV_BUNDLED_EXTENSIONS_ROOT, FILENAMES, WORKSPACE_FILES;
 var init_paths = __esmMin((() => {
 	init_agent_scope();
 	init_paths_state();
 	init_workspace_defaults();
+	ENV_BUNDLED_EXTENSIONS_ROOT = "XOPC_BUNDLED_EXTENSIONS_ROOT";
 	FILENAMES = {
 		CONFIG: "xopc.json",
 		MODELS_JSON: "models.json",

package/dist/src/config/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `extensions/` (dev, tsx)\n * - `out/server` → `dist/extensions` (Electron esbuild bundle)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const candidates = [\n      join(srcDir, '..', '..', 'extensions'),\n      join(srcDir, '..', '..', 'dist', 'extensions'),\n      join(srcDir, '..', '..', '..', 'extensions'),\n    ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}
+{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nconst ENV_BUNDLED_EXTENSIONS_ROOT = 'XOPC_BUNDLED_EXTENSIONS_ROOT';\n\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `extensions/` (dev, tsx)\n * - `out/server` → `dist/extensions` (Electron esbuild bundle)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  const envDir = process.env[ENV_BUNDLED_EXTENSIONS_ROOT];\n  if (envDir && existsSync(envDir)) {\n    return envDir;\n  }\n\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const candidates = [\n      join(srcDir, '..', '..', 'extensions'),\n      join(srcDir, '..', '..', 'dist', 'extensions'),\n      join(srcDir, '..', '..', '..', 'extensions'),\n    ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":";;;;;;;;;;;AAiEA,SAAgB,oBAA4B;AAC1C,QAAO,QAAQ,IAAI,SAAS,gBAAgB,KAAK,iBAAiB,EAAE,UAAU,OAAO;;;;;AAMvF,SAAgB,wBAAgC;AAC9C,QAAO,QAAQ,IAAI,SAAS,oBAAoB,KAAK,iBAAiB,EAAE,cAAc;;;;;AAMxF,SAAgB,0BAAkC;AAChD,QAAO,KAAK,uBAAuB,EAAE,UAAU,qBAAqB;;;;;AAMtE,SAAgB,iBAAiB,UAA0B;AACzD,QAAO,KAAK,uBAAuB,EAAE,SAAS,GAAG,SAAS,OAAO;;;;;;AAOnE,SAAgB,gBAAgB,QAAgB,SAAyB;AACvE,QAAOA,kBAAsB,QAAQ,QAAQ;;;;;AAM/C,SAAgB,oBAAoB,QAAgB,SAAyB;AAC3E,QAAOC,sBAAuB,QAAQ,QAAQ;;;AAIhD,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAOC,yBAA6B,QAAQ,QAAQ;;;AAItD,SAAgB,gCAAgC,QAAgB,SAAiB,UAA0B;AACzG,QAAOC,kCAAsC,QAAQ,SAAS,SAAS;;;;;AAMzE,SAAgB,qBAAqB,QAAgB,UAAkB,SAAyB;AAC9F,QAAO,KAAKD,yBAA6B,QAAQ,QAAQ,EAAE,SAAS;;;;;AAMtE,SAAgB,6BAA6B,QAAgB,SAAyB;AACpF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,qBAAqB;;;;;AAM/E,SAAgB,gBAAgB,QAAgB,SAAyB;AACvE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,QAAQ;;;;;AAMxD,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU;;;;;AAM1D,SAAgB,yBAAyB,QAAgB,SAAyB;AAChF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,YAAY;;;;;AAM5D,SAAgB,wBACd,QACA,WACA,SACA,SACQ;AAER,QAAO,KADK,UAAU,uBAAuB,QAAQ,QAAQ,GAAG,yBAAyB,QAAQ,QAAQ,EACxF,GAAG,UAAU,OAAO;;;;;AAMvC,SAAgB,eAAe,QAAgB,SAAyB;AACtE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,IAAI;;;;;AAM9D,SAAgB,kBAAkB,QAAgB,SAAyB;AACzE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,OAAO;;;;;AAMjE,SAAgB,kBAAkB,QAAgB,SAAyB;AACzE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,OAAO;;;;;AAMjE,SAAgB,uBAA+B;AAC7C,QAAO,KAAK,iBAAiB,EAAE,aAAa;;;;;AAM9C,SAAgB,4BAAoC;AAClD,QAAO,KAAK,sBAAsB,EAAE,UAAU,gBAAgB;;;;;;;AAQhE,SAAgB,8BAA8B,QAAgB,SAAyB;AACrF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,aAAa;;;;;AAM7D,SAAgB,mBAA2B;AACzC,QAAO,KAAK,iBAAiB,EAAE,SAAS;;;;;AAM1C,SAAgB,iBAAiB,SAAyB;AACxD,QAAO,KAAK,kBAAkB,EAAE,SAAS,WAAW;;;;;AAMtD,SAAgB,wBAAgC;AAC9C,QAAO,KAAK,iBAAiB,EAAE,UAAU,YAAY;;;;;AAMvD,SAAgB,iBAAyB;AACvC,QAAO,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMxC,SAAgB,sBAA8B;AAC5C,QAAO,KAAK,gBAAgB,EAAE,UAAU,UAAU;;;;;AAMpD,SAAgB,iBAAyB;AACvC,QAAO,QAAQ,IAAI,SAAS,YAAY,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMzE,SAAgB,eAAe,MAAsB;AACnD,QAAO,KAAK,gBAAgB,EAAE,QAAQ,KAAK,MAAM;;;;;AAMnD,SAAgB,gBAAwB;AACtC,QAAO,KAAK,iBAAiB,EAAE,MAAM;;;;;AAMvC,SAAgB,qBAA6B;AAC3C,QAAO,KAAK,eAAe,EAAE,OAAO;;;;;AAMtC,SAAgB,kBAA0B;AACxC,QAAO,KAAK,iBAAiB,EAAE,QAAQ;;;;;AAMzC,SAAgB,sBAA8B;AAC5C,QAAO,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMxC,SAAgB,oBAA4B;AAC1C,QAAO,KAAK,qBAAqB,EAAE,WAAW,MAAM;;;;;AAMtD,SAAgB,qBAA6B;AAC3C,QAAO,KAAK,mBAAmB,EAAE,OAAO;;;;;AAM1C,SAAgB,oBAA4B;AAC1C,QAAO,KAAK,mBAAmB,EAAE,MAAM;;;;;AAMzC,SAAgB,wBAAgC;AAC9C,QAAO,KAAK,iBAAiB,EAAE,UAAU,YAAY;;;;;AAMvD,SAAgB,yBAAyB,QAAgB,SAAyB;AAChF,QAAO,KAAK,yBAAyB,QAAQ,QAAQ,EAAE,QAAQ;;;;;AAMjE,SAAgB,0BAA0B,QAAgB,SAAyB;AACjF,QAAO,KAAK,yBAAyB,QAAQ,QAAQ,EAAE,UAAU,gBAAgB;;;;;AAMnF,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,SAAS,UAAU,aAAa;;;;;;;;;;;AAYhF,SAAgB,8BAA6C;CAC3D,MAAM,SAAS,QAAQ,IAAI;AAC3B,KAAI,UAAU,WAAW,OAAO,CAC9B,QAAO;AAGT,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EACnC,MAAM,aAAa;GACjB,KAAK,QAAQ,MAAM,MAAM,aAAa;GACtC,KAAK,QAAQ,MAAM,MAAM,QAAQ,aAAa;GAC9C,KAAK,QAAQ,MAAM,MAAM,MAAM,aAAa;GAC7C;AACD,OAAK,MAAM,OAAO,WAChB,KAAI,WAAW,IAAI,CACjB,QAAO;AAGX,SAAO;SACD;AACN,SAAO;;;;;;AAOX,SAAgB,0BAAyC;AACvD,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EAInC,MAAM,YAAY,KADE,KAAK,QAAQ,MAAM,KACL,EAAE,SAAS;AAC7C,MAAI,WAAW,UAAU,CACvB,QAAO;EAKT,MAAM,eAAe,KADE,KAAK,QAAQ,MAAM,MAAM,KACR,EAAE,SAAS;AACnD,MAAI,WAAW,aAAa,CAC1B,QAAO;AAGT,SAAO;SACD;AACN,SAAO;;;;;;AAOX,SAAgB,0BAAkC;AAChD,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EACnC,MAAM,WAAW,KAAK,QAAQ,MAAM,cAAc,OAAO,WAAW;AACpE,MAAI,WAAW,SAAS,CACtB,QAAO;EAET,MAAM,kBAAkB,KAAK,QAAQ,MAAM,MAAM,OAAO,cAAc,OAAO,WAAW;AACxF,MAAI,WAAW,gBAAgB,CAC7B,QAAO;EAET,MAAM,MAAM,KAAK,QAAQ,KAAK,EAAE,OAAO,cAAc,OAAO,WAAW;AACvE,MAAI,WAAW,IAAI,CACjB,QAAO;AAET,SAAO;SACD;AACN,SAAO,KAAK,QAAQ,KAAK,EAAE,OAAO,cAAc,OAAO,WAAW;;;;;mBApZrC;mBAC4B;0BAGa;AAUpE,+BAA8B;AAEvB,aAAY;EACvB,QAAQ;EACR,aAAa;;EAEb,SAAS;EACT,iBAAiB;EACjB,sBAAsB;EACtB,WAAW;EACX,iBAAiB;EACjB,cAAc;;EAEd,aAAa;EACb,KAAK;EACL,QAAQ;EACR,QAAQ;EACT;AAKY,mBAAkB;EAC7B,MAAM;EACN,UAAU;EACV,MAAM;EACN,QAAQ;EACR,OAAO;EACP,WAAW;EACX,QAAQ;EACT"}

package/dist/src/document-understanding/extract.d.ts

@@ -0,0 +1,13 @@
+export type DocumentExtractionResult = {
+    ok: true;
+    text: string;
+    kind: 'plain' | 'pdf';
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function extractDocumentText(params: {
+    buffer: Buffer;
+    fileName: string;
+    mimeType?: string;
+}): DocumentExtractionResult;

package/dist/src/document-understanding/extract.js

@@ -0,0 +1,63 @@
+import { extname } from "node:path";
+//#region src/document-understanding/extract.ts
+const MAX_EXTRACTED_CHARS = 6e4;
+function truncate(text) {
+	return text.length > MAX_EXTRACTED_CHARS ? `${text.slice(0, MAX_EXTRACTED_CHARS)}\n\n[document extraction truncated ${text.length - MAX_EXTRACTED_CHARS} chars]` : text;
+}
+function decodePdfEscapedString(input) {
+	return input.replace(/\\n/g, "\n").replace(/\\r/g, "\n").replace(/\\t/g, "	").replace(/\\\(/g, "(").replace(/\\\)/g, ")").replace(/\\\\/g, "\\");
+}
+function extractPdfLiteralStrings(raw) {
+	const out = [];
+	for (const match of raw.matchAll(/\((?:\\.|[^\\()])*\)\s*T[Jj]/g)) {
+		const token = match[0];
+		const text = decodePdfEscapedString(token.slice(1, token.lastIndexOf(")"))).trim();
+		if (text.length >= 2) out.push(text);
+	}
+	return out;
+}
+function extractPdfHexStrings(raw) {
+	const out = [];
+	for (const match of raw.matchAll(/<([0-9a-fA-F\s]{6,})>\s*T[Jj]/g)) {
+		const hex = (match[1] ?? "").replace(/\s+/g, "");
+		if (hex.length < 6 || hex.length % 2 !== 0) continue;
+		const bytes = [];
+		for (let i = 0; i < hex.length; i += 2) bytes.push(Number.parseInt(hex.slice(i, i + 2), 16));
+		const buf = Buffer.from(bytes);
+		const text = (buf.length >= 2 && (buf[0] === 254 && buf[1] === 255 || buf[0] === 255 && buf[1] === 254) ? buf.toString("utf16le") : buf.toString("utf8")).replace(/[\u0000-\u001f]+/g, " ").trim();
+		if (text.length >= 2) out.push(text);
+	}
+	return out;
+}
+function extractPdfText(buffer) {
+	const raw = buffer.toString("latin1");
+	const parts = [...extractPdfLiteralStrings(raw), ...extractPdfHexStrings(raw)].map((line) => line.replace(/\s+/g, " ").trim()).filter(Boolean);
+	const text = Array.from(new Set(parts)).join("\n");
+	if (!text.trim()) return {
+		ok: false,
+		reason: "PDF text extraction found no text; scanned or compressed PDFs require a dedicated extractor."
+	};
+	return {
+		ok: true,
+		kind: "pdf",
+		text: truncate(text)
+	};
+}
+function extractDocumentText(params) {
+	const ext = extname(params.fileName).toLowerCase();
+	const mime = params.mimeType?.toLowerCase() ?? "";
+	if (mime === "application/pdf" || ext === ".pdf") return extractPdfText(params.buffer);
+	if (mime.startsWith("text/")) return {
+		ok: true,
+		kind: "plain",
+		text: truncate(params.buffer.toString("utf8"))
+	};
+	return {
+		ok: false,
+		reason: `No document extractor registered for ${params.mimeType || ext || "unknown type"}.`
+	};
+}
+//#endregion
+export { extractDocumentText };
+
+//# sourceMappingURL=extract.js.map

package/dist/src/document-understanding/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","names":[],"sources":["../../../src/document-understanding/extract.ts"],"sourcesContent":["import { extname } from 'node:path';\n\nexport type DocumentExtractionResult =\n  | { ok: true; text: string; kind: 'plain' | 'pdf' }\n  | { ok: false; reason: string };\n\nconst MAX_EXTRACTED_CHARS = 60_000;\n\nfunction truncate(text: string): string {\n  return text.length > MAX_EXTRACTED_CHARS\n    ? `${text.slice(0, MAX_EXTRACTED_CHARS)}\\n\\n[document extraction truncated ${text.length - MAX_EXTRACTED_CHARS} chars]`\n    : text;\n}\n\nfunction decodePdfEscapedString(input: string): string {\n  return input\n    .replace(/\\\\n/g, '\\n')\n    .replace(/\\\\r/g, '\\n')\n    .replace(/\\\\t/g, '\\t')\n    .replace(/\\\\\\(/g, '(')\n    .replace(/\\\\\\)/g, ')')\n    .replace(/\\\\\\\\/g, '\\\\');\n}\n\nfunction extractPdfLiteralStrings(raw: string): string[] {\n  const out: string[] = [];\n  const re = /\\((?:\\\\.|[^\\\\()])*\\)\\s*T[Jj]/g;\n  for (const match of raw.matchAll(re)) {\n    const token = match[0];\n    const body = token.slice(1, token.lastIndexOf(')'));\n    const text = decodePdfEscapedString(body).trim();\n    if (text.length >= 2) out.push(text);\n  }\n  return out;\n}\n\nfunction extractPdfHexStrings(raw: string): string[] {\n  const out: string[] = [];\n  const re = /<([0-9a-fA-F\\s]{6,})>\\s*T[Jj]/g;\n  for (const match of raw.matchAll(re)) {\n    const hex = (match[1] ?? '').replace(/\\s+/g, '');\n    if (hex.length < 6 || hex.length % 2 !== 0) continue;\n    const bytes: number[] = [];\n    for (let i = 0; i < hex.length; i += 2) bytes.push(Number.parseInt(hex.slice(i, i + 2), 16));\n    const buf = Buffer.from(bytes);\n    const utf16 = buf.length >= 2 && ((buf[0] === 0xfe && buf[1] === 0xff) || (buf[0] === 0xff && buf[1] === 0xfe));\n    const text = (utf16 ? buf.toString('utf16le') : buf.toString('utf8')).replace(/[\\u0000-\\u001f]+/g, ' ').trim();\n    if (text.length >= 2) out.push(text);\n  }\n  return out;\n}\n\nfunction extractPdfText(buffer: Buffer): DocumentExtractionResult {\n  const raw = buffer.toString('latin1');\n  const parts = [...extractPdfLiteralStrings(raw), ...extractPdfHexStrings(raw)]\n    .map((line) => line.replace(/\\s+/g, ' ').trim())\n    .filter(Boolean);\n  const text = Array.from(new Set(parts)).join('\\n');\n  if (!text.trim()) {\n    return { ok: false, reason: 'PDF text extraction found no text; scanned or compressed PDFs require a dedicated extractor.' };\n  }\n  return { ok: true, kind: 'pdf', text: truncate(text) };\n}\n\nexport function extractDocumentText(params: {\n  buffer: Buffer;\n  fileName: string;\n  mimeType?: string;\n}): DocumentExtractionResult {\n  const ext = extname(params.fileName).toLowerCase();\n  const mime = params.mimeType?.toLowerCase() ?? '';\n  if (mime === 'application/pdf' || ext === '.pdf') return extractPdfText(params.buffer);\n  if (mime.startsWith('text/')) return { ok: true, kind: 'plain', text: truncate(params.buffer.toString('utf8')) };\n  return { ok: false, reason: `No document extractor registered for ${params.mimeType || ext || 'unknown type'}.` };\n}\n"],"mappings":";;AAMA,MAAM,sBAAsB;AAE5B,SAAS,SAAS,MAAsB;AACtC,QAAO,KAAK,SAAS,sBACjB,GAAG,KAAK,MAAM,GAAG,oBAAoB,CAAC,qCAAqC,KAAK,SAAS,oBAAoB,WAC7G;;AAGN,SAAS,uBAAuB,OAAuB;AACrD,QAAO,MACJ,QAAQ,QAAQ,KAAK,CACrB,QAAQ,QAAQ,KAAK,CACrB,QAAQ,QAAQ,IAAK,CACrB,QAAQ,SAAS,IAAI,CACrB,QAAQ,SAAS,IAAI,CACrB,QAAQ,SAAS,KAAK;;AAG3B,SAAS,yBAAyB,KAAuB;CACvD,MAAM,MAAgB,EAAE;AAExB,MAAK,MAAM,SAAS,IAAI,SAAS,gCAAG,EAAE;EACpC,MAAM,QAAQ,MAAM;EAEpB,MAAM,OAAO,uBADA,MAAM,MAAM,GAAG,MAAM,YAAY,IAAI,CACV,CAAC,CAAC,MAAM;AAChD,MAAI,KAAK,UAAU,EAAG,KAAI,KAAK,KAAK;;AAEtC,QAAO;;AAGT,SAAS,qBAAqB,KAAuB;CACnD,MAAM,MAAgB,EAAE;AAExB,MAAK,MAAM,SAAS,IAAI,SAAS,iCAAG,EAAE;EACpC,MAAM,OAAO,MAAM,MAAM,IAAI,QAAQ,QAAQ,GAAG;AAChD,MAAI,IAAI,SAAS,KAAK,IAAI,SAAS,MAAM,EAAG;EAC5C,MAAM,QAAkB,EAAE;AAC1B,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK,EAAG,OAAM,KAAK,OAAO,SAAS,IAAI,MAAM,GAAG,IAAI,EAAE,EAAE,GAAG,CAAC;EAC5F,MAAM,MAAM,OAAO,KAAK,MAAM;EAE9B,MAAM,QADQ,IAAI,UAAU,MAAO,IAAI,OAAO,OAAQ,IAAI,OAAO,OAAU,IAAI,OAAO,OAAQ,IAAI,OAAO,OACnF,IAAI,SAAS,UAAU,GAAG,IAAI,SAAS,OAAO,EAAE,QAAQ,qBAAqB,IAAI,CAAC,MAAM;AAC9G,MAAI,KAAK,UAAU,EAAG,KAAI,KAAK,KAAK;;AAEtC,QAAO;;AAGT,SAAS,eAAe,QAA0C;CAChE,MAAM,MAAM,OAAO,SAAS,SAAS;CACrC,MAAM,QAAQ,CAAC,GAAG,yBAAyB,IAAI,EAAE,GAAG,qBAAqB,IAAI,CAAC,CAC3E,KAAK,SAAS,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM,CAAC,CAC/C,OAAO,QAAQ;CAClB,MAAM,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,KAAK;AAClD,KAAI,CAAC,KAAK,MAAM,CACd,QAAO;EAAE,IAAI;EAAO,QAAQ;EAAgG;AAE9H,QAAO;EAAE,IAAI;EAAM,MAAM;EAAO,MAAM,SAAS,KAAK;EAAE;;AAGxD,SAAgB,oBAAoB,QAIP;CAC3B,MAAM,MAAM,QAAQ,OAAO,SAAS,CAAC,aAAa;CAClD,MAAM,OAAO,OAAO,UAAU,aAAa,IAAI;AAC/C,KAAI,SAAS,qBAAqB,QAAQ,OAAQ,QAAO,eAAe,OAAO,OAAO;AACtF,KAAI,KAAK,WAAW,QAAQ,CAAE,QAAO;EAAE,IAAI;EAAM,MAAM;EAAS,MAAM,SAAS,OAAO,OAAO,SAAS,OAAO,CAAC;EAAE;AAChH,QAAO;EAAE,IAAI;EAAO,QAAQ,wCAAwC,OAAO,YAAY,OAAO,eAAe;EAAI"}

package/dist/src/gateway/hono/routes/notes.js

@@ -50,15 +50,6 @@ function buildNotePatch(body) {
 	if (body.aiDeep && typeof body.aiDeep === "object") patch.aiDeep = body.aiDeep;
 	return patch;
 }
-function buildNoteThreadContext(note) {
-	const title = note.title?.trim() || "未命名笔记";
-	const body = note.markdown.trim() || "这条笔记暂无正文。";
-	return [
-		`来源 Note：${title}`,
-		"",
-		body
-	].join("\n");
-}
 function noteThreadName(note) {
 	return `讨论：${note.title?.trim() || note.markdown.trim().slice(0, 28) || "未命名笔记"}`;
 }
@@ -188,14 +179,29 @@ function registerNotesRoutes(authenticated, deps) {
 		const routingCfg = service.currentConfig;
 		let agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim().toLowerCase() : getDefaultAgentId(routingCfg);
 		if (!agentExists(agentId, routingCfg)) agentId = getDefaultAgentId(routingCfg);
+		const sourceBinding = {
+			kind: "note",
+			sourceId: noteId,
+			version: String(note.updatedAt),
+			attachedAt: Date.now()
+		};
+		const forceNew = body.forceNew === true;
 		const existingKey = note.aiDeep?.catalysis?.sourceSessionKey;
-		if (existingKey) {
+		if (!forceNew && existingKey) {
 			const existingSession = await service.sessions.getSession(existingKey);
-			if (existingSession) return c.json({
-				session: existingSession,
-				sessionKey: existingKey,
-				reused: true
-			});
+			if (existingSession) {
+				const meta = await service.sessionIndexInstance.getSessionMetadata(existingKey);
+				await service.sessionIndexInstance.updateSessionMetadata(existingKey, { customData: {
+					...meta?.customData ?? {},
+					sourceBinding
+				} });
+				return c.json({
+					session: existingSession,
+					sessionKey: existingKey,
+					reused: true,
+					sourceBinding
+				});
+			}
 		}
 		const sessionKey = buildSessionKey({
 			agentId,
@@ -205,23 +211,13 @@ function registerNotesRoutes(authenticated, deps) {
 			peerId: `note_${noteId}_${Date.now()}`
 		});
 		await service.sessionIndexInstance.saveMessages(sessionKey, []);
-		await service.sessionIndexInstance.appendTranscriptContextEntry(sessionKey, {
-			id: `source-note:${noteId}`,
-			text: buildNoteThreadContext(note),
-			data: {
-				kind: "source_note",
-				noteId,
-				title: note.title ?? ""
-			}
-		});
 		const meta = await service.sessionIndexInstance.getSessionMetadata(sessionKey);
 		await service.sessionIndexInstance.updateSessionMetadata(sessionKey, {
 			name: noteThreadName(note),
 			tags: Array.from(new Set([...meta?.tags ?? [], "note"])),
 			customData: {
 				...meta?.customData ?? {},
-				sourceNoteId: noteId,
-				sourceNoteTitle: note.title ?? ""
+				sourceBinding
 			}
 		});
 		await service.notesServiceInstance.linkNoteThread(noteId, sessionKey);
@@ -229,9 +225,32 @@ function registerNotesRoutes(authenticated, deps) {
 		return c.json({
 			session,
 			sessionKey,
-			reused: false
+			reused: false,
+			sourceBinding
 		}, 201);
 	});
+	function noteContextStatusPayload(result) {
+		const artifact = result.artifact;
+		return {
+			noteUpdatedAt: result.noteUpdatedAt,
+			stale: result.stale,
+			status: artifact?.status ?? "failed",
+			generatedAt: artifact?.generatedAt,
+			tokenEstimate: artifact?.tokenEstimate,
+			truncated: artifact?.truncated ?? false,
+			attachments: artifact?.attachments ?? []
+		};
+	}
+	authenticated.get("/api/notes/:id/context-status", async (c) => {
+		const result = await service.notesServiceInstance.getAgentContextStatus(c.req.param("id"), service.currentConfig);
+		if (!result) return c.json({ error: "Note not found" }, 404);
+		return c.json(noteContextStatusPayload(result));
+	});
+	authenticated.post("/api/notes/:id/context-rebuild", async (c) => {
+		const result = await service.notesServiceInstance.getAgentContextStatus(c.req.param("id"), service.currentConfig, true);
+		if (!result) return c.json({ error: "Note not found" }, 404);
+		return c.json(noteContextStatusPayload(result));
+	});
 	authenticated.get("/api/notes/:id/threads", async (c) => {
 		const noteId = c.req.param("id");
 		const keys = await service.notesServiceInstance.listNoteThreads(noteId);