@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/agent/skills/skill-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.js","names":[],"sources":["../../../../src/agent/skills/skill-manager.ts"],"sourcesContent":["/**\n * Skill Manager - Manages skills loading and expansion\n *\n * Handles skill initialization, reloading, and command expansion.\n */\n\nimport { createSkillLoader, type Skill } from './index.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from './format-skills-prompt.js';\n\nconst log = createLogger('SkillManager');\n\nexport interface SkillDiagnostic {\n  type: 'collision' | 'warning' | 'error' | 'info';\n  skillName: string;\n  message: string;\n}\n\nexport interface SkillLoadResult {\n  skills: Skill[];\n  prompt: string;\n  diagnostics: SkillDiagnostic[];\n}\n\nexport class SkillManager {\n  private skillPrompt: string = '';\n  private skills: Skill[] = [];\n  private skillLoader = createSkillLoader();\n  private workspace: string;\n  private bundledSkillsDir: string;\n\n  constructor(workspace: string, bundledSkillsDir?: string) {\n    this.workspace = workspace;\n    this.bundledSkillsDir = bundledSkillsDir || resolveBundledSkillsDir();\n    this.initialize();\n  }\n\n  /**\n   * Initialize skills from workspace and bundled directories\n   */\n  private initialize(): void {\n    const result = this.skillLoader.init(this.workspace, this.bundledSkillsDir);\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    // Log diagnostics\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      } else {\n        log.info({ skill: diag.skillName, message: diag.message }, 'Skill info');\n      }\n    }\n\n    log.debug({ count: result.skills.length }, 'Skills loaded');\n  }\n\n  /**\n   * Recompute skill XML prompt from current skills.json (no disk rescan).\n   */\n  refreshPromptFromConfig(): void {\n    this.skillLoader.refreshPromptFromConfig();\n    this.skillPrompt = this.skillLoader.getPrompt();\n  }\n\n  /**\n   * Reload skills from disk\n   */\n  reload(): void {\n    log.info('Reloading skills...');\n    const result = this.skillLoader.reload();\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      }\n    }\n\n    log.info({ count: result.skills.length }, 'Skills reloaded');\n  }\n\n  /**\n   * Get the skill prompt to append to system prompt\n   */\n  getPrompt(): string {\n    return this.skillPrompt;\n  }\n\n  /**\n   * `<available_skills>` XML with optional per-agent allowlist and/or tool-based gating.\n   * When both arguments are omitted, returns the cached prompt from disk load (no tool gating).\n   */\n  getPromptForSkillAllowlist(\n    allowlist: string[] | undefined,\n    registeredToolNames?: string[],\n  ): string {\n    if (allowlist === undefined && registeredToolNames === undefined) {\n      return this.getPrompt();\n    }\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return formatSkillsForPrompt(this.getSkills(), skillsConfig, {\n      skillAllowlist: allowlist,\n      registeredToolNames,\n    });\n  }\n\n  /** Skills visible for prompts and skills_list given the same indexing options as {@link getPromptForSkillAllowlist}. */\n  selectSkillsForAgentIndexing(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.getSkills(), skillsConfig, options);\n  }\n\n  /**\n   * Get all loaded skills\n   */\n  getSkills(): Skill[] {\n    return [...this.skills];\n  }\n\n  /**\n   * Get skill names\n   */\n  getSkillNames(): string[] {\n    return this.skills.map((s) => s.name);\n  }\n\n  /** Names of skills included in the agent system prompt (`<available_skills>`). */\n  getSkillNamesForPrompt(): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills()\n      .filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig))\n      .map((s) => s.name);\n  }\n\n  /**\n   * Skills that are enabled for model discovery (respects skills.json and requirement checks).\n   */\n  getEnabledSkills(): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills().filter(\n      (s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig),\n    );\n  }\n\n  /**\n   * Like {@link getEnabledSkills} plus optional allowlist and tool gating (matches `<available_skills>`).\n   */\n  getEnabledSkillsForAgentSession(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    return this.selectSkillsForAgentIndexing(options);\n  }\n\n  /**\n   * Find a skill by name\n   */\n  findSkill(name: string): Skill | undefined {\n    return this.skills.find(s => s.name === name);\n  }\n\n  /**\n   * Check if a skill exists\n   */\n  hasSkill(name: string): boolean {\n    return this.skills.some(s => s.name === name);\n  }\n\n  /**\n   * Expand a skill command into a full skill block\n   */\n  expandCommand(text: string, options?: { skillAllowlist?: string[]; registeredToolNames?: string[] }): string {\n    if (!text.startsWith('/skill:')) {\n      return text;\n    }\n\n    const { skillName, args } = this.parseSkillCommand(text);\n    const visible = this.selectSkillsForAgentIndexing(options);\n    const skill = visible.find((s) => s.name === skillName);\n\n    if (!skill) {\n      log.warn({ skillName }, 'Skill not visible for expansion');\n      return text;\n    }\n\n    return this.buildSkillBlock(skill, args);\n  }\n\n  /**\n   * Parse a /skill: command\n   */\n  private parseSkillCommand(text: string): { skillName: string; args?: string } {\n    // Format: /skill:name args...\n    const withoutPrefix = text.slice(7); // Remove '/skill:'\n    const spaceIndex = withoutPrefix.indexOf(' ');\n\n    if (spaceIndex === -1) {\n      return { skillName: withoutPrefix.trim() };\n    }\n\n    return {\n      skillName: withoutPrefix.slice(0, spaceIndex).trim(),\n      args: withoutPrefix.slice(spaceIndex + 1).trim(),\n    };\n  }\n\n  /**\n   * Build a skill block for inclusion in the prompt\n   */\n  private buildSkillBlock(skill: Skill, args?: string): string {\n    let block = `\\n\\n## Skill: ${skill.name}\\n\\n`;\n    \n    if (skill.description) {\n      block += `${skill.description}\\n\\n`;\n    }\n\n    // Include raw skill content (SKILL.md content)\n    if (skill.content) {\n      block += `${skill.content}\\n\\n`;\n    }\n\n    if (args) {\n      block += `**Arguments**: ${args}\\n\\n`;\n    }\n\n    return block;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"skill-manager.js","names":[],"sources":["../../../../src/agent/skills/skill-manager.ts"],"sourcesContent":["/**\n * Skill Manager - Manages skills loading and expansion\n *\n * Handles skill initialization, reloading, and command expansion.\n */\n\nimport { createSkillLoader } from './index.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from './format-skills-prompt.js';\nimport type {\n  LoadSkillsResult,\n  Skill,\n  SkillDiagnostic,\n  SkillRuntimeStatus,\n} from './types.js';\n\nconst log = createLogger('SkillManager');\n\nexport interface SkillLoadResult {\n  skills: Skill[];\n  prompt: string;\n  diagnostics: SkillDiagnostic[];\n}\n\nexport class SkillManager {\n  private skillPrompt: string = '';\n  private skills: Skill[] = [];\n  private skillLoader = createSkillLoader();\n  private workspace: string;\n  private bundledSkillsDir: string;\n  private version = 0;\n  private loadedAt = 0;\n  private reloadInProgress = false;\n  private reloadPending = false;\n  private lastReloadStartedAt: number | undefined;\n  private lastReloadFinishedAt: number | undefined;\n  private lastReloadReason: SkillRuntimeStatus['lastReloadReason'];\n  private lastReloadOk: boolean | undefined;\n  private lastReloadError: string | undefined;\n\n  constructor(workspace: string, bundledSkillsDir?: string) {\n    this.workspace = workspace;\n    this.bundledSkillsDir = bundledSkillsDir || resolveBundledSkillsDir();\n    this.initialize();\n  }\n\n  /**\n   * Initialize skills from workspace and bundled directories\n   */\n  private initialize(): void {\n    this.runReload('initial', () => this.skillLoader.init(this.workspace, this.bundledSkillsDir));\n  }\n\n  /**\n   * Recompute skill XML prompt from current skills.json (no disk rescan).\n   */\n  refreshPromptFromConfig(): void {\n    this.skillLoader.refreshPromptFromConfig();\n    this.skillPrompt = this.skillLoader.getPrompt();\n    this.version += 1;\n    this.loadedAt = Date.now();\n    this.lastReloadReason = 'config';\n    this.lastReloadOk = true;\n    this.lastReloadError = undefined;\n  }\n\n  /**\n   * Reload skills from disk\n   */\n  reload(): void {\n    this.runReload('disk', () => this.skillLoader.reload());\n  }\n\n  private runReload(reason: NonNullable<SkillRuntimeStatus['lastReloadReason']>, load: () => LoadSkillsResult): void {\n    if (this.reloadInProgress) {\n      this.reloadPending = true;\n      return;\n    }\n\n    do {\n      this.reloadPending = false;\n      this.reloadInProgress = true;\n      this.lastReloadStartedAt = Date.now();\n      this.lastReloadReason = reason;\n      try {\n        const result = load();\n        this.applyLoadResult(result);\n        this.lastReloadOk = true;\n        this.lastReloadError = undefined;\n        log.info({ count: result.skills.length, version: this.version }, 'Skills reloaded');\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        this.lastReloadOk = false;\n        this.lastReloadError = errorMessage;\n        log.error({ err, errorMessage }, `Skills reload failed: ${errorMessage}`);\n      } finally {\n        this.lastReloadFinishedAt = Date.now();\n        this.reloadInProgress = false;\n      }\n    } while (this.reloadPending);\n  }\n\n  private applyLoadResult(result: LoadSkillsResult): void {\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n    this.version += 1;\n    this.loadedAt = Date.now();\n\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, path: diag.path, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, path: diag.path, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, path: diag.path, message: diag.message }, 'Skill error');\n      }\n    }\n  }\n\n  /**\n   * Get the skill prompt to append to system prompt\n   */\n  getPrompt(): string {\n    return this.skillPrompt;\n  }\n\n  /**\n   * `<available_skills>` XML with optional per-agent allowlist and/or tool-based gating.\n   * When both arguments are omitted, returns the cached prompt from disk load (no tool gating).\n   */\n  getPromptForSkillAllowlist(\n    allowlist: string[] | undefined,\n    registeredToolNames?: string[],\n  ): string {\n    if (allowlist === undefined && registeredToolNames === undefined) {\n      return this.getPrompt();\n    }\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return formatSkillsForPrompt(this.getSkills(), skillsConfig, {\n      skillAllowlist: allowlist,\n      registeredToolNames,\n    });\n  }\n\n  /** Skills visible for prompts and skills_list given the same indexing options as {@link getPromptForSkillAllowlist}. */\n  selectSkillsForAgentIndexing(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.getSkills(), skillsConfig, options);\n  }\n\n  /**\n   * Get all loaded skills\n   */\n  getSkills(): Skill[] {\n    return [...this.skills];\n  }\n\n  getDiagnostics(): SkillDiagnostic[] {\n    return this.skillLoader.getDiagnostics();\n  }\n\n  getVersion(): string {\n    return String(this.version);\n  }\n\n  getLoadedAt(): number {\n    return this.loadedAt;\n  }\n\n  getStatus(): SkillRuntimeStatus {\n    return {\n      version: this.getVersion(),\n      loadedAt: this.loadedAt,\n      reloadInProgress: this.reloadInProgress,\n      reloadPending: this.reloadPending,\n      ...(this.lastReloadStartedAt !== undefined ? { lastReloadStartedAt: this.lastReloadStartedAt } : {}),\n      ...(this.lastReloadFinishedAt !== undefined ? { lastReloadFinishedAt: this.lastReloadFinishedAt } : {}),\n      ...(this.lastReloadReason !== undefined ? { lastReloadReason: this.lastReloadReason } : {}),\n      ...(this.lastReloadOk !== undefined ? { lastReloadOk: this.lastReloadOk } : {}),\n      ...(this.lastReloadError !== undefined ? { lastReloadError: this.lastReloadError } : {}),\n    };\n  }\n\n  /**\n   * Get skill names\n   */\n  getSkillNames(): string[] {\n    return this.skills.map((s) => s.name);\n  }\n\n  /** Names of skills included in the agent system prompt (`<available_skills>`). */\n  getSkillNamesForPrompt(): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills()\n      .filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig))\n      .map((s) => s.name);\n  }\n\n  /**\n   * Skills that are enabled for model discovery (respects skills.json and requirement checks).\n   */\n  getEnabledSkills(): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills().filter(\n      (s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig),\n    );\n  }\n\n  /**\n   * Like {@link getEnabledSkills} plus optional allowlist and tool gating (matches `<available_skills>`).\n   */\n  getEnabledSkillsForAgentSession(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    return this.selectSkillsForAgentIndexing(options);\n  }\n\n  /**\n   * Find a skill by name\n   */\n  findSkill(name: string): Skill | undefined {\n    return this.skills.find(s => s.name === name);\n  }\n\n  /**\n   * Check if a skill exists\n   */\n  hasSkill(name: string): boolean {\n    return this.skills.some(s => s.name === name);\n  }\n\n  /**\n   * Expand a skill command into a full skill block\n   */\n  expandCommand(text: string, options?: { skillAllowlist?: string[]; registeredToolNames?: string[] }): string {\n    if (!text.startsWith('/skill:')) {\n      return text;\n    }\n\n    const { skillName, args } = this.parseSkillCommand(text);\n    const visible = this.selectSkillsForAgentIndexing(options);\n    const skill = visible.find((s) => s.name === skillName);\n\n    if (!skill) {\n      log.warn({ skillName }, 'Skill not visible for expansion');\n      return text;\n    }\n\n    return this.buildSkillBlock(skill, args);\n  }\n\n  /**\n   * Parse a /skill: command\n   */\n  private parseSkillCommand(text: string): { skillName: string; args?: string } {\n    // Format: /skill:name args...\n    const withoutPrefix = text.slice(7); // Remove '/skill:'\n    const spaceIndex = withoutPrefix.indexOf(' ');\n\n    if (spaceIndex === -1) {\n      return { skillName: withoutPrefix.trim() };\n    }\n\n    return {\n      skillName: withoutPrefix.slice(0, spaceIndex).trim(),\n      args: withoutPrefix.slice(spaceIndex + 1).trim(),\n    };\n  }\n\n  /**\n   * Build a skill block for inclusion in the prompt\n   */\n  private buildSkillBlock(skill: Skill, args?: string): string {\n    let block = `\\n\\n## Skill: ${skill.name}\\n\\n`;\n    \n    if (skill.description) {\n      block += `${skill.description}\\n\\n`;\n    }\n\n    // Include raw skill content (SKILL.md content)\n    if (skill.content) {\n      block += `${skill.content}\\n\\n`;\n    }\n\n    if (args) {\n      block += `**Arguments**: ${args}\\n\\n`;\n    }\n\n    return block;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/skill-view-path.js

@@ -1,5 +1,5 @@
-import { resolve, sep } from "path";
 import { existsSync, realpathSync } from "fs";
+import { resolve, sep } from "path";
 //#region src/agent/skills/skill-view-path.ts
 /**
 * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.

package/dist/src/agent/skills/test-framework.js

@@ -4,8 +4,8 @@ import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { hasBinary } from "./installer.js";
 import { scanSkillDirectory } from "./scanner.js";
 import { parseSkillMetadata } from "./parse-skill-metadata.js";
-import { basename, join, relative } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
+import { basename, join, relative } from "path";
 //#region src/agent/skills/test-framework.ts
 /**
 * Skill Test Framework

package/dist/src/agent/skills/types.d.ts

@@ -207,6 +207,17 @@ export interface SkillDiagnostic {
     message: string;
     path?: string;
 }
+export interface SkillRuntimeStatus {
+    version: string;
+    loadedAt: number;
+    reloadInProgress: boolean;
+    reloadPending: boolean;
+    lastReloadStartedAt?: number;
+    lastReloadFinishedAt?: number;
+    lastReloadReason?: 'initial' | 'disk' | 'config';
+    lastReloadOk?: boolean;
+    lastReloadError?: string;
+}
 export interface SkillSnapshot {
     version: string;
     skills: SkillEntry[];

package/dist/src/agent/skills/watcher.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join } from "path";
 import { watch } from "fs";
+import { join } from "path";
 //#region src/agent/skills/watcher.ts
 /**
 * Skill Watcher

package/dist/src/agent/starter-agents.js

@@ -1,8 +1,8 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "./agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
 import { applyAgentConfig } from "../commands/agents.config.js";
-import { join } from "node:path";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/starter-agents.ts
 init_paths();
 init_agent_scope();

package/dist/src/agent/tools/cronjob-tool.d.ts

@@ -4,16 +4,21 @@ export declare function scanCronPrompt(prompt: string): string | null;
 export type CronjobToolParams = {
     action: 'list' | 'create' | 'update' | 'remove' | 'enable' | 'disable' | 'history';
     name?: string;
-    schedule?: string;
+    scheduleKind?: 'cron' | 'at' | 'every';
+    cronExpr?: string;
+    at?: string;
+    everyMs?: number;
+    tz?: string;
     message?: string;
     workflowDefinitionId?: string;
     workflowGoal?: string;
     workflowInputJson?: string;
+    goalId?: string;
+    goalMessage?: string;
     waitForCompletion?: boolean;
     deliveryChannel?: string;
     deliveryTo?: string;
-    timezone?: string;
-    sessionTarget?: 'main' | 'isolated';
+    sessionTarget?: 'main' | 'isolated' | 'current';
     agentId?: string;
     workingDirectory?: string;
     jobId?: string;

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

@@ -1,5 +1,5 @@
+import { describeSchedule } from "../../cron/schedule.js";
 import { getCronPayloadText } from "../../cron/job-content.js";
-import { DEFAULT_WORKFLOW_CRON_WAIT_MS } from "../../cron/workflow-run-completion.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/cronjob-tool.ts
 const CRON_THREAT_PATTERNS = [
@@ -25,15 +25,24 @@ const CronjobSchema = Type.Object({
 		Type.Literal("history")
 	], { description: "Action to perform on cron jobs" }),
 	name: Type.Optional(Type.String({ description: "Human-readable job name" })),
-	schedule: Type.Optional(Type.String({ description: "Cron schedule expression. Examples:\n  \"0 9 * * *\" = every day at 9:00 AM\n  \"*/30 * * * *\" = every 30 minutes\n  \"0 9 * * 1-5\" = weekdays at 9:00 AM\n  \"0 0 1 * *\" = first day of each month" })),
+	scheduleKind: Type.Optional(Type.Union([
+		Type.Literal("cron"),
+		Type.Literal("at"),
+		Type.Literal("every")
+	], { description: "Schedule kind. Use cronExpr for cron, at for one-time ISO time, everyMs for interval." })),
+	cronExpr: Type.Optional(Type.String({ description: "Cron schedule expression. Examples:\n  \"0 9 * * *\" = every day at 9:00 AM\n  \"*/30 * * * *\" = every 30 minutes\n  \"0 9 * * 1-5\" = weekdays at 9:00 AM\n  \"0 0 1 * *\" = first day of each month" })),
+	at: Type.Optional(Type.String({ description: "One-time run timestamp as ISO 8601 string." })),
+	everyMs: Type.Optional(Type.Number({ description: "Fixed interval in milliseconds." })),
+	tz: Type.Optional(Type.String({ description: "IANA timezone for cronExpr, e.g. Asia/Shanghai." })),
 	message: Type.Optional(Type.String({ description: "Instruction for the agent when the job runs (agentTurn payload; typically a fresh session)." })),
-	workflowDefinitionId: Type.Optional(Type.String({ description: "Workflow definition id for a direct workflowRun job (mutually exclusive with message on create)." })),
+	workflowDefinitionId: Type.Optional(Type.String({ description: "Workflow definition id for a workflowRun job (mutually exclusive with message on create)." })),
 	workflowGoal: Type.Optional(Type.String({ description: "Optional goal override when creating a workflowRun job." })),
 	workflowInputJson: Type.Optional(Type.String({ description: "JSON object for workflow input payload (workflowRun create/update)." })),
+	goalId: Type.Optional(Type.String({ description: "Durable goal id for a goalContinue job (mutually exclusive with message and workflowDefinitionId)." })),
+	goalMessage: Type.Optional(Type.String({ description: "Optional custom continuation message for a goalContinue job." })),
 	waitForCompletion: Type.Optional(Type.Boolean({ description: "For workflowRun jobs: when true (default), cron waits for terminal status before succeeding." })),
 	deliveryChannel: Type.Optional(Type.String({ description: "Delivery channel when workflow completes (e.g. telegram)." })),
 	deliveryTo: Type.Optional(Type.String({ description: "Delivery recipient chat id when workflow completes." })),
-	timezone: Type.Optional(Type.String({ description: "IANA timezone (e.g. Asia/Shanghai, America/New_York). Must be one supported by the cron store." })),
 	sessionTarget: Type.Optional(Type.Union([Type.Literal("main"), Type.Literal("isolated")], { description: "\"main\" uses the main session context; \"isolated\" (default on create) uses a separate session per run." })),
 	agentId: Type.Optional(Type.String({ description: "Agent profile id for isolated jobs (session key). Omit to use the configured default agent (usually `main`)." })),
 	workingDirectory: Type.Optional(Type.String({ description: "Absolute workspace path on the gateway host for isolated jobs. Omit to use the agent default workspace." })),
@@ -49,21 +58,47 @@ function textResult(text) {
 	};
 }
 function formatJob(job) {
-	const status = job.enabled ? "▶️ active" : "⏸️ disabled";
+	const status = job.enabled ? "active" : "disabled";
 	const payloadText = getCronPayloadText(job);
 	const truncatedPayload = payloadText.length > 100 ? `${payloadText.slice(0, 100)}...` : payloadText;
 	const payloadLine = job.payload.kind === "workflowRun" ? `  Workflow: ${job.payload.definitionId}${job.payload.goal ? ` — ${job.payload.goal}` : ""}` : `  Message: ${truncatedPayload}`;
 	return [
 		`${status} ${job.name ?? "(unnamed)"} (${job.id})`,
-		`  Schedule: ${job.schedule}${job.timezone ? ` (${job.timezone})` : ""}`,
+		`  Schedule: ${describeSchedule(job.schedule)}`,
 		`  Type: ${job.payload.kind}`,
 		payloadLine,
-		`  Next run: ${job.next_run ?? "N/A"}`,
+		`  Next run: ${job.state.nextRunAtMs ? new Date(job.state.nextRunAtMs).toISOString() : "N/A"}`,
 		`  Session: ${job.sessionTarget ?? "main"}`,
 		`  Agent: ${job.agentId?.trim() || "(default)"}`,
 		`  Workspace: ${job.workingDirectory?.trim() || "(agent default)"}`
 	].join("\n");
 }
+function scheduleFromParams(params) {
+	const kind = params.scheduleKind;
+	if (!kind) return void 0;
+	if (kind === "cron") {
+		const expr = params.cronExpr?.trim();
+		if (!expr) return void 0;
+		return {
+			kind,
+			expr,
+			...params.tz?.trim() ? { tz: params.tz.trim() } : {}
+		};
+	}
+	if (kind === "at") {
+		const at = params.at?.trim();
+		if (!at) return void 0;
+		return {
+			kind,
+			at
+		};
+	}
+	if (!Number.isFinite(params.everyMs) || !params.everyMs || params.everyMs <= 0) return void 0;
+	return {
+		kind,
+		everyMs: Math.floor(params.everyMs)
+	};
+}
 function formatExecution(exec) {
 	const dur = exec.duration != null ? `${(exec.duration / 1e3).toFixed(1)}s` : "N/A";
 	const lines = [`[${exec.status}] ${exec.startedAt} (${dur})`];
@@ -75,7 +110,7 @@ function createCronjobTool(deps) {
 	return {
 		name: "cronjob",
 		label: "⏰ Cronjob",
-		description: "Manage scheduled tasks (cron jobs) that run automatically.\n\nJobs can run an agent message (agentTurn) or a workflow directly (workflowRun).\n\nACTIONS:\n- list: Show all scheduled jobs with status and next run time\n- create: Create a job (schedule + message OR workflowDefinitionId; optional goal, workflowInputJson, deliveryChannel/deliveryTo, waitForCompletion)\n- update: Change schedule, message, workflow fields, name, timezone, sessionTarget, agentId, or workingDirectory (requires jobId)\n- remove: Delete a job (requires jobId)\n- enable / disable: Toggle a job (requires jobId)\n- history: Recent executions for a job (requires jobId)",
+		description: "Manage scheduled tasks (cron jobs) that run automatically.\n\nJobs can run an agent message (agentTurn), a workflow directly (workflowRun), or continue a durable goal (goalContinue).\n\nACTIONS:\n- list: Show all scheduled jobs with status and next run time\n- create: Create a job (scheduleKind plus exactly one of message, workflowDefinitionId, or goalId)\n- update: Change schedule, message, workflow fields, name, sessionTarget, agentId, or workingDirectory (requires jobId)\n- remove: Delete a job (requires jobId)\n- enable / disable: Toggle a job (requires jobId)\n- history: Recent executions for a job (requires jobId)",
 		parameters: CronjobSchema,
 		async execute(_toolCallId, params, _signal) {
 			const cron = deps.getCronService();
@@ -95,17 +130,30 @@ function createCronjobTool(deps) {
 					}
 					case "create": {
 						const workflowId = params.workflowDefinitionId?.trim();
+						const goalId = params.goalId?.trim();
 						const hasMessage = Boolean(params.message?.trim());
-						if (!params.schedule?.trim() || !workflowId && !hasMessage || workflowId && hasMessage) return textResult("Error: create requires schedule and exactly one of message or workflowDefinitionId.");
+						const targetCount = [
+							workflowId,
+							goalId,
+							hasMessage ? "message" : ""
+						].filter(Boolean).length;
+						const schedule = scheduleFromParams(params);
+						if (!schedule || targetCount !== 1) return textResult("Error: create requires scheduleKind with matching cronExpr/at/everyMs and exactly one of message, workflowDefinitionId, or goalId.");
 						if (hasMessage) {
 							const scanResult = scanCronPrompt(params.message);
 							if (scanResult) return textResult(`Error: ${scanResult}`);
 						}
 						let payload;
-						let timeout;
 						let sessionTarget = params.sessionTarget ?? "isolated";
 						let delivery;
-						if (workflowId) {
+						if (goalId) {
+							payload = {
+								kind: "goalContinue",
+								goalId,
+								...params.goalMessage?.trim() ? { message: params.goalMessage.trim() } : {}
+							};
+							sessionTarget = "isolated";
+						} else if (workflowId) {
 							let inputEnvelope;
 							if (params.workflowInputJson?.trim()) try {
 								inputEnvelope = { payload: JSON.parse(params.workflowInputJson) };
@@ -122,9 +170,8 @@ function createCronjobTool(deps) {
 								...params.waitForCompletion === false ? { waitForCompletion: false } : {}
 							};
 							sessionTarget = "isolated";
-							timeout = DEFAULT_WORKFLOW_CRON_WAIT_MS;
 							if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) delivery = {
-								mode: "direct",
+								mode: "announce",
 								channel: params.deliveryChannel.trim(),
 								to: params.deliveryTo.trim()
 							};
@@ -132,22 +179,21 @@ function createCronjobTool(deps) {
 							kind: "agentTurn",
 							message: params.message.trim()
 						};
-						const result = await cron.addJob(params.schedule.trim(), {
+						const result = await cron.addJob(schedule, {
 							name: params.name?.trim() || void 0,
-							timezone: params.timezone?.trim() || void 0,
 							sessionTarget,
-							...timeout ? { timeout } : {},
 							...delivery ? { delivery } : {},
 							...params.agentId?.trim() ? { agentId: params.agentId.trim() } : {},
 							...params.workingDirectory?.trim() ? { workingDirectory: params.workingDirectory.trim() } : {},
 							payload
 						});
-						return textResult(`Created ${workflowId ? `workflow job (${workflowId})` : "job"}${params.name ? ` "${params.name.trim()}"` : ""} (${result.id})\nSchedule: ${result.schedule}`);
+						return textResult(`Created ${goalId ? `goal job (${goalId})` : workflowId ? `workflow job (${workflowId})` : "job"}${params.name ? ` "${params.name.trim()}"` : ""} (${result.id})\nSchedule: ${describeSchedule(result.schedule)}`);
 					}
 					case "update": {
 						if (!params.jobId?.trim()) return textResult("Error: update requires jobId.");
 						const updates = {};
-						if (params.schedule?.trim()) updates.schedule = params.schedule.trim();
+						const nextSchedule = scheduleFromParams(params);
+						if (nextSchedule) updates.schedule = nextSchedule;
 						if (params.message != null && params.message.trim()) {
 							const scanResult = scanCronPrompt(params.message);
 							if (scanResult) return textResult(`Error: ${scanResult}`);
@@ -156,6 +202,14 @@ function createCronjobTool(deps) {
 								message: params.message.trim()
 							};
 						}
+						if (params.goalId?.trim()) {
+							updates.payload = {
+								kind: "goalContinue",
+								goalId: params.goalId.trim(),
+								...params.goalMessage?.trim() ? { message: params.goalMessage.trim() } : {}
+							};
+							updates.sessionTarget = "isolated";
+						}
 						if (params.workflowDefinitionId?.trim()) {
 							let inputEnvelope;
 							if (params.workflowInputJson?.trim()) try {
@@ -173,19 +227,23 @@ function createCronjobTool(deps) {
 								...params.waitForCompletion === false ? { waitForCompletion: false } : {}
 							};
 							updates.sessionTarget = "isolated";
-							updates.timeout = DEFAULT_WORKFLOW_CRON_WAIT_MS;
 						}
 						if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) updates.delivery = {
-							mode: "direct",
+							mode: "announce",
 							channel: params.deliveryChannel.trim(),
 							to: params.deliveryTo.trim()
 						};
-						if (params.timezone?.trim()) updates.timezone = params.timezone.trim();
 						if (params.name !== void 0) updates.name = params.name.trim() || void 0;
 						if (params.sessionTarget !== void 0) updates.sessionTarget = params.sessionTarget;
-						if (params.agentId !== void 0) updates.agentId = params.agentId.trim() || null;
-						if (params.workingDirectory !== void 0) updates.workingDirectory = params.workingDirectory.trim() || null;
-						if (Object.keys(updates).length === 0) return textResult("Error: update requires at least one of schedule, message, workflowDefinitionId, name, timezone, sessionTarget, agentId, workingDirectory, deliveryChannel/deliveryTo.");
+						if (params.agentId !== void 0) {
+							const t = params.agentId.trim();
+							if (t) updates.agentId = t;
+						}
+						if (params.workingDirectory !== void 0) {
+							const t = params.workingDirectory.trim();
+							if (t) updates.workingDirectory = t;
+						}
+						if (Object.keys(updates).length === 0) return textResult("Error: update requires at least one of scheduleKind, message, workflowDefinitionId, name, sessionTarget, agentId, workingDirectory, deliveryChannel/deliveryTo.");
 						return textResult(await cron.updateJob(params.jobId.trim(), updates) ? `Updated job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`);
 					}
 					case "remove":

package/dist/src/agent/tools/cronjob-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"cronjob-tool.js","names":[],"sources":["../../../../src/agent/tools/cronjob-tool.ts"],"sourcesContent":["// Agent tool for managing scheduled cron jobs (CronService-backed)\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { CronService } from '../../cron/index.js';\nimport { getCronPayloadText } from '../../cron/job-content.js';\nimport { DEFAULT_WORKFLOW_CRON_WAIT_MS } from '../../cron/workflow-run-completion.js';\nimport type { CronPayload, JobData, JobExecution, JobWithNextRun } from '../../cron/types.js';\n\nconst CRON_THREAT_PATTERNS: Array<[RegExp, string]> = [\n  [/ignore\\s+(previous|all|above)\\s+instructions/i, 'prompt_injection'],\n  [/do\\s+not\\s+tell\\s+the\\s+user/i, 'deception'],\n  [/system\\s+prompt\\s+override/i, 'sys_prompt_override'],\n  [/curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD)/i, 'exfil_curl'],\n  [/cat\\s+[^\\n]*(\\.env|credentials|\\.netrc)/i, 'read_secrets'],\n  [/rm\\s+-rf\\s+\\//i, 'destructive_rm'],\n];\n\nexport function scanCronPrompt(prompt: string): string | null {\n  for (const [pattern, id] of CRON_THREAT_PATTERNS) {\n    if (pattern.test(prompt)) {\n      return (\n        `Blocked: prompt matches threat pattern '${id}'. ` +\n        'Cron prompts must not contain injection or exfiltration payloads.'\n      );\n    }\n  }\n  return null;\n}\n\nconst CronjobSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal('list'),\n      Type.Literal('create'),\n      Type.Literal('update'),\n      Type.Literal('remove'),\n      Type.Literal('enable'),\n      Type.Literal('disable'),\n      Type.Literal('history'),\n    ],\n    { description: 'Action to perform on cron jobs' },\n  ),\n\n  name: Type.Optional(Type.String({ description: 'Human-readable job name' })),\n  schedule: Type.Optional(\n    Type.String({\n      description:\n        'Cron schedule expression. Examples:\\n' +\n        '  \"0 9 * * *\" = every day at 9:00 AM\\n' +\n        '  \"*/30 * * * *\" = every 30 minutes\\n' +\n        '  \"0 9 * * 1-5\" = weekdays at 9:00 AM\\n' +\n        '  \"0 0 1 * *\" = first day of each month',\n    }),\n  ),\n  message: Type.Optional(\n    Type.String({\n      description:\n        'Instruction for the agent when the job runs (agentTurn payload; typically a fresh session).',\n    }),\n  ),\n  workflowDefinitionId: Type.Optional(\n    Type.String({\n      description:\n        'Workflow definition id for a direct workflowRun job (mutually exclusive with message on create).',\n    }),\n  ),\n  workflowGoal: Type.Optional(\n    Type.String({ description: 'Optional goal override when creating a workflowRun job.' }),\n  ),\n  workflowInputJson: Type.Optional(\n    Type.String({\n      description: 'JSON object for workflow input payload (workflowRun create/update).',\n    }),\n  ),\n  waitForCompletion: Type.Optional(\n    Type.Boolean({\n      description:\n        'For workflowRun jobs: when true (default), cron waits for terminal status before succeeding.',\n    }),\n  ),\n  deliveryChannel: Type.Optional(\n    Type.String({ description: 'Delivery channel when workflow completes (e.g. telegram).' }),\n  ),\n  deliveryTo: Type.Optional(\n    Type.String({ description: 'Delivery recipient chat id when workflow completes.' }),\n  ),\n  timezone: Type.Optional(\n    Type.String({\n      description:\n        'IANA timezone (e.g. Asia/Shanghai, America/New_York). Must be one supported by the cron store.',\n    }),\n  ),\n  sessionTarget: Type.Optional(\n    Type.Union([Type.Literal('main'), Type.Literal('isolated')], {\n      description:\n        '\"main\" uses the main session context; \"isolated\" (default on create) uses a separate session per run.',\n    }),\n  ),\n  agentId: Type.Optional(\n    Type.String({\n      description:\n        'Agent profile id for isolated jobs (session key). Omit to use the configured default agent (usually `main`).',\n    }),\n  ),\n  workingDirectory: Type.Optional(\n    Type.String({\n      description:\n        'Absolute workspace path on the gateway host for isolated jobs. Omit to use the agent default workspace.',\n    }),\n  ),\n\n  jobId: Type.Optional(Type.String({ description: 'Job ID (from list output)' })),\n});\n\nexport type CronjobToolParams = {\n  action: 'list' | 'create' | 'update' | 'remove' | 'enable' | 'disable' | 'history';\n  name?: string;\n  schedule?: string;\n  message?: string;\n  workflowDefinitionId?: string;\n  workflowGoal?: string;\n  workflowInputJson?: string;\n  waitForCompletion?: boolean;\n  deliveryChannel?: string;\n  deliveryTo?: string;\n  timezone?: string;\n  sessionTarget?: 'main' | 'isolated';\n  agentId?: string;\n  workingDirectory?: string;\n  jobId?: string;\n};\n\nexport interface CronjobToolDeps {\n  getCronService: () => CronService | undefined;\n}\n\nfunction textResult(text: string): AgentToolResult<{}> {\n  return { content: [{ type: 'text', text }], details: {} };\n}\n\nfunction formatJob(job: JobWithNextRun): string {\n  const status = job.enabled ? '▶️ active' : '⏸️ disabled';\n  const payloadText = getCronPayloadText(job);\n  const truncatedPayload =\n    payloadText.length > 100 ? `${payloadText.slice(0, 100)}...` : payloadText;\n  const payloadLine =\n    job.payload.kind === 'workflowRun'\n      ? `  Workflow: ${job.payload.definitionId}${job.payload.goal ? ` — ${job.payload.goal}` : ''}`\n      : `  Message: ${truncatedPayload}`;\n\n  return [\n    `${status} ${job.name ?? '(unnamed)'} (${job.id})`,\n    `  Schedule: ${job.schedule}${job.timezone ? ` (${job.timezone})` : ''}`,\n    `  Type: ${job.payload.kind}`,\n    payloadLine,\n    `  Next run: ${job.next_run ?? 'N/A'}`,\n    `  Session: ${job.sessionTarget ?? 'main'}`,\n    `  Agent: ${job.agentId?.trim() || '(default)'}`,\n    `  Workspace: ${job.workingDirectory?.trim() || '(agent default)'}`,\n  ].join('\\n');\n}\n\nfunction formatExecution(exec: JobExecution): string {\n  const dur = exec.duration != null ? `${(exec.duration / 1000).toFixed(1)}s` : 'N/A';\n  const lines = [`[${exec.status}] ${exec.startedAt} (${dur})`];\n  if (exec.summary) {\n    lines.push(`  Summary: ${exec.summary.slice(0, 200)}`);\n  }\n  if (exec.error) {\n    lines.push(`  Error: ${exec.error.slice(0, 200)}`);\n  }\n  return lines.join('\\n');\n}\n\nexport function createCronjobTool(deps: CronjobToolDeps): AgentTool {\n  return {\n    name: 'cronjob',\n    label: '⏰ Cronjob',\n    description:\n      'Manage scheduled tasks (cron jobs) that run automatically.\\n\\n' +\n      'Jobs can run an agent message (agentTurn) or a workflow directly (workflowRun).\\n\\n' +\n      'ACTIONS:\\n' +\n      '- list: Show all scheduled jobs with status and next run time\\n' +\n      '- create: Create a job (schedule + message OR workflowDefinitionId; optional goal, workflowInputJson, deliveryChannel/deliveryTo, waitForCompletion)\\n' +\n      '- update: Change schedule, message, workflow fields, name, timezone, sessionTarget, agentId, or workingDirectory (requires jobId)\\n' +\n      '- remove: Delete a job (requires jobId)\\n' +\n      '- enable / disable: Toggle a job (requires jobId)\\n' +\n      '- history: Recent executions for a job (requires jobId)',\n    parameters: CronjobSchema,\n\n    async execute(_toolCallId, params: CronjobToolParams, _signal) {\n      const cron = deps.getCronService();\n      if (!cron) {\n        return textResult('Cron service is not available in this environment.');\n      }\n\n      try {\n        switch (params.action) {\n          case 'list': {\n            const jobs = await cron.listJobs();\n            if (jobs.length === 0) {\n              return textResult('No scheduled jobs.');\n            }\n            const formatted = jobs.map(formatJob).join('\\n\\n');\n            return { content: [{ type: 'text', text: formatted }], details: {} };\n          }\n\n          case 'create': {\n            const workflowId = params.workflowDefinitionId?.trim();\n            const hasMessage = Boolean(params.message?.trim());\n            if (!params.schedule?.trim() || (!workflowId && !hasMessage) || (workflowId && hasMessage)) {\n              return textResult(\n                'Error: create requires schedule and exactly one of message or workflowDefinitionId.',\n              );\n            }\n\n            if (hasMessage) {\n              const scanResult = scanCronPrompt(params.message!);\n              if (scanResult) {\n                return textResult(`Error: ${scanResult}`);\n              }\n            }\n\n            let payload: CronPayload;\n            let timeout: number | undefined;\n            let sessionTarget = params.sessionTarget ?? 'isolated';\n            let delivery: JobData['delivery'];\n\n            if (workflowId) {\n              let inputEnvelope: { payload: unknown } | undefined;\n              if (params.workflowInputJson?.trim()) {\n                try {\n                  inputEnvelope = { payload: JSON.parse(params.workflowInputJson) as unknown };\n                } catch {\n                  return textResult('Error: workflowInputJson must be valid JSON.');\n                }\n              }\n              const agentId = params.agentId?.trim() || undefined;\n              payload = {\n                kind: 'workflowRun',\n                definitionId: workflowId,\n                ...(params.workflowGoal?.trim() ? { goal: params.workflowGoal.trim() } : {}),\n                ...(inputEnvelope ? { inputEnvelope } : {}),\n                ...(agentId ? { agentId } : {}),\n                ...(params.waitForCompletion === false ? { waitForCompletion: false } : {}),\n              };\n              sessionTarget = 'isolated';\n              timeout = DEFAULT_WORKFLOW_CRON_WAIT_MS;\n              if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) {\n                delivery = {\n                  mode: 'direct',\n                  channel: params.deliveryChannel.trim(),\n                  to: params.deliveryTo.trim(),\n                };\n              }\n            } else {\n              payload = {\n                kind: 'agentTurn',\n                message: params.message!.trim(),\n              };\n            }\n\n            const result = await cron.addJob(params.schedule.trim(), {\n              name: params.name?.trim() || undefined,\n              timezone: params.timezone?.trim() || undefined,\n              sessionTarget,\n              ...(timeout ? { timeout } : {}),\n              ...(delivery ? { delivery } : {}),\n              ...(params.agentId?.trim() ? { agentId: params.agentId.trim() } : {}),\n              ...(params.workingDirectory?.trim()\n                ? { workingDirectory: params.workingDirectory.trim() }\n                : {}),\n              payload,\n            });\n\n            const kindLabel = workflowId ? `workflow job (${workflowId})` : 'job';\n            return textResult(\n              `Created ${kindLabel}${params.name ? ` \"${params.name.trim()}\"` : ''} (${result.id})\\n` +\n                `Schedule: ${result.schedule}`,\n            );\n          }\n\n          case 'update': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: update requires jobId.');\n            }\n\n            const updates: Partial<Omit<JobData, 'id' | 'created_at' | 'updated_at'>> = {};\n            if (params.schedule?.trim()) {\n              updates.schedule = params.schedule.trim();\n            }\n            if (params.message != null && params.message.trim()) {\n              const scanResult = scanCronPrompt(params.message);\n              if (scanResult) {\n                return textResult(`Error: ${scanResult}`);\n              }\n              updates.payload = { kind: 'agentTurn', message: params.message.trim() };\n            }\n            if (params.workflowDefinitionId?.trim()) {\n              let inputEnvelope: { payload: unknown } | undefined;\n              if (params.workflowInputJson?.trim()) {\n                try {\n                  inputEnvelope = { payload: JSON.parse(params.workflowInputJson) as unknown };\n                } catch {\n                  return textResult('Error: workflowInputJson must be valid JSON.');\n                }\n              }\n              const agentId = params.agentId?.trim() || undefined;\n              updates.payload = {\n                kind: 'workflowRun',\n                definitionId: params.workflowDefinitionId.trim(),\n                ...(params.workflowGoal?.trim() ? { goal: params.workflowGoal.trim() } : {}),\n                ...(inputEnvelope ? { inputEnvelope } : {}),\n                ...(agentId ? { agentId } : {}),\n                ...(params.waitForCompletion === false ? { waitForCompletion: false } : {}),\n              };\n              updates.sessionTarget = 'isolated';\n              updates.timeout = DEFAULT_WORKFLOW_CRON_WAIT_MS;\n            }\n            if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) {\n              updates.delivery = {\n                mode: 'direct',\n                channel: params.deliveryChannel.trim(),\n                to: params.deliveryTo.trim(),\n              };\n            }\n            if (params.timezone?.trim()) {\n              updates.timezone = params.timezone.trim();\n            }\n            if (params.name !== undefined) {\n              updates.name = params.name.trim() || undefined;\n            }\n            if (params.sessionTarget !== undefined) {\n              updates.sessionTarget = params.sessionTarget;\n            }\n            if (params.agentId !== undefined) {\n              const t = params.agentId.trim();\n              updates.agentId = t || null;\n            }\n            if (params.workingDirectory !== undefined) {\n              const t = params.workingDirectory.trim();\n              updates.workingDirectory = t || null;\n            }\n\n            if (Object.keys(updates).length === 0) {\n              return textResult(\n                'Error: update requires at least one of schedule, message, workflowDefinitionId, name, timezone, sessionTarget, agentId, workingDirectory, deliveryChannel/deliveryTo.',\n              );\n            }\n\n            const success = await cron.updateJob(params.jobId.trim(), updates);\n            return textResult(\n              success ? `Updated job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'remove': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: remove requires jobId.');\n            }\n            const removed = await cron.removeJob(params.jobId.trim());\n            return textResult(\n              removed ? `Removed job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'disable': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: disable requires jobId.');\n            }\n            const toggled = await cron.toggleJob(params.jobId.trim(), false);\n            return textResult(\n              toggled ? `Disabled job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'enable': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: enable requires jobId.');\n            }\n            const toggled = await cron.toggleJob(params.jobId.trim(), true);\n            return textResult(\n              toggled ? `Enabled job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'history': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: history requires jobId.');\n            }\n            const history = await cron.getJobHistory(params.jobId.trim(), 5);\n            if (history.length === 0) {\n              return textResult(`No execution history for job ${params.jobId.trim()}.`);\n            }\n            const formatted = history.map(formatExecution).join('\\n\\n');\n            return textResult(formatted);\n          }\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        return textResult(`Error: ${message}`);\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"cronjob-tool.js","names":[],"sources":["../../../../src/agent/tools/cronjob-tool.ts"],"sourcesContent":["// Agent tool for managing scheduled cron jobs (CronService-backed)\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { CronService } from '../../cron/index.js';\nimport { describeSchedule } from '../../cron/schedule.js';\nimport { getCronPayloadText } from '../../cron/job-content.js';\nimport type { CronDelivery, CronPayload, CronSchedule, CronJobPatch, JobData, JobExecution } from '../../cron/types.js';\n\nconst CRON_THREAT_PATTERNS: Array<[RegExp, string]> = [\n  [/ignore\\s+(previous|all|above)\\s+instructions/i, 'prompt_injection'],\n  [/do\\s+not\\s+tell\\s+the\\s+user/i, 'deception'],\n  [/system\\s+prompt\\s+override/i, 'sys_prompt_override'],\n  [/curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD)/i, 'exfil_curl'],\n  [/cat\\s+[^\\n]*(\\.env|credentials|\\.netrc)/i, 'read_secrets'],\n  [/rm\\s+-rf\\s+\\//i, 'destructive_rm'],\n];\n\nexport function scanCronPrompt(prompt: string): string | null {\n  for (const [pattern, id] of CRON_THREAT_PATTERNS) {\n    if (pattern.test(prompt)) {\n      return (\n        `Blocked: prompt matches threat pattern '${id}'. ` +\n        'Cron prompts must not contain injection or exfiltration payloads.'\n      );\n    }\n  }\n  return null;\n}\n\nconst CronjobSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal('list'),\n      Type.Literal('create'),\n      Type.Literal('update'),\n      Type.Literal('remove'),\n      Type.Literal('enable'),\n      Type.Literal('disable'),\n      Type.Literal('history'),\n    ],\n    { description: 'Action to perform on cron jobs' },\n  ),\n\n  name: Type.Optional(Type.String({ description: 'Human-readable job name' })),\n  scheduleKind: Type.Optional(\n    Type.Union([Type.Literal('cron'), Type.Literal('at'), Type.Literal('every')], {\n      description: 'Schedule kind. Use cronExpr for cron, at for one-time ISO time, everyMs for interval.',\n    }),\n  ),\n  cronExpr: Type.Optional(\n    Type.String({\n      description:\n        'Cron schedule expression. Examples:\\n' +\n        '  \"0 9 * * *\" = every day at 9:00 AM\\n' +\n        '  \"*/30 * * * *\" = every 30 minutes\\n' +\n        '  \"0 9 * * 1-5\" = weekdays at 9:00 AM\\n' +\n        '  \"0 0 1 * *\" = first day of each month',\n    }),\n  ),\n  at: Type.Optional(Type.String({ description: 'One-time run timestamp as ISO 8601 string.' })),\n  everyMs: Type.Optional(Type.Number({ description: 'Fixed interval in milliseconds.' })),\n  tz: Type.Optional(Type.String({ description: 'IANA timezone for cronExpr, e.g. Asia/Shanghai.' })),\n  message: Type.Optional(\n    Type.String({\n      description:\n        'Instruction for the agent when the job runs (agentTurn payload; typically a fresh session).',\n    }),\n  ),\n  workflowDefinitionId: Type.Optional(\n    Type.String({\n      description:\n        'Workflow definition id for a workflowRun job (mutually exclusive with message on create).',\n    }),\n  ),\n  workflowGoal: Type.Optional(\n    Type.String({ description: 'Optional goal override when creating a workflowRun job.' }),\n  ),\n  workflowInputJson: Type.Optional(\n    Type.String({\n      description: 'JSON object for workflow input payload (workflowRun create/update).',\n    }),\n  ),\n  goalId: Type.Optional(\n    Type.String({\n      description:\n        'Durable goal id for a goalContinue job (mutually exclusive with message and workflowDefinitionId).',\n    }),\n  ),\n  goalMessage: Type.Optional(\n    Type.String({\n      description: 'Optional custom continuation message for a goalContinue job.',\n    }),\n  ),\n  waitForCompletion: Type.Optional(\n    Type.Boolean({\n      description:\n        'For workflowRun jobs: when true (default), cron waits for terminal status before succeeding.',\n    }),\n  ),\n  deliveryChannel: Type.Optional(\n    Type.String({ description: 'Delivery channel when workflow completes (e.g. telegram).' }),\n  ),\n  deliveryTo: Type.Optional(\n    Type.String({ description: 'Delivery recipient chat id when workflow completes.' }),\n  ),\n  sessionTarget: Type.Optional(\n    Type.Union([Type.Literal('main'), Type.Literal('isolated')], {\n      description:\n        '\"main\" uses the main session context; \"isolated\" (default on create) uses a separate session per run.',\n    }),\n  ),\n  agentId: Type.Optional(\n    Type.String({\n      description:\n        'Agent profile id for isolated jobs (session key). Omit to use the configured default agent (usually `main`).',\n    }),\n  ),\n  workingDirectory: Type.Optional(\n    Type.String({\n      description:\n        'Absolute workspace path on the gateway host for isolated jobs. Omit to use the agent default workspace.',\n    }),\n  ),\n\n  jobId: Type.Optional(Type.String({ description: 'Job ID (from list output)' })),\n});\n\nexport type CronjobToolParams = {\n  action: 'list' | 'create' | 'update' | 'remove' | 'enable' | 'disable' | 'history';\n  name?: string;\n  scheduleKind?: 'cron' | 'at' | 'every';\n  cronExpr?: string;\n  at?: string;\n  everyMs?: number;\n  tz?: string;\n  message?: string;\n  workflowDefinitionId?: string;\n  workflowGoal?: string;\n  workflowInputJson?: string;\n  goalId?: string;\n  goalMessage?: string;\n  waitForCompletion?: boolean;\n  deliveryChannel?: string;\n  deliveryTo?: string;\n  sessionTarget?: 'main' | 'isolated' | 'current';\n  agentId?: string;\n  workingDirectory?: string;\n  jobId?: string;\n};\n\nexport interface CronjobToolDeps {\n  getCronService: () => CronService | undefined;\n}\n\nfunction textResult(text: string): AgentToolResult<{}> {\n  return { content: [{ type: 'text', text }], details: {} };\n}\n\nfunction formatJob(job: JobData): string {\n  const status = job.enabled ? 'active' : 'disabled';\n  const payloadText = getCronPayloadText(job);\n  const truncatedPayload =\n    payloadText.length > 100 ? `${payloadText.slice(0, 100)}...` : payloadText;\n  const payloadLine =\n    job.payload.kind === 'workflowRun'\n      ? `  Workflow: ${job.payload.definitionId}${job.payload.goal ? ` — ${job.payload.goal}` : ''}`\n      : `  Message: ${truncatedPayload}`;\n\n  return [\n    `${status} ${job.name ?? '(unnamed)'} (${job.id})`,\n    `  Schedule: ${describeSchedule(job.schedule)}`,\n    `  Type: ${job.payload.kind}`,\n    payloadLine,\n    `  Next run: ${job.state.nextRunAtMs ? new Date(job.state.nextRunAtMs).toISOString() : 'N/A'}`,\n    `  Session: ${job.sessionTarget ?? 'main'}`,\n    `  Agent: ${job.agentId?.trim() || '(default)'}`,\n    `  Workspace: ${job.workingDirectory?.trim() || '(agent default)'}`,\n  ].join('\\n');\n}\n\nfunction scheduleFromParams(params: Pick<CronjobToolParams, 'scheduleKind' | 'cronExpr' | 'at' | 'everyMs' | 'tz'>): CronSchedule | undefined {\n  const kind = params.scheduleKind;\n  if (!kind) return undefined;\n  if (kind === 'cron') {\n    const expr = params.cronExpr?.trim();\n    if (!expr) return undefined;\n    return { kind, expr, ...(params.tz?.trim() ? { tz: params.tz.trim() } : {}) };\n  }\n  if (kind === 'at') {\n    const at = params.at?.trim();\n    if (!at) return undefined;\n    return { kind, at };\n  }\n  if (!Number.isFinite(params.everyMs) || !params.everyMs || params.everyMs <= 0) return undefined;\n  return { kind, everyMs: Math.floor(params.everyMs) };\n}\n\nfunction formatExecution(exec: JobExecution): string {\n  const dur = exec.duration != null ? `${(exec.duration / 1000).toFixed(1)}s` : 'N/A';\n  const lines = [`[${exec.status}] ${exec.startedAt} (${dur})`];\n  if (exec.summary) {\n    lines.push(`  Summary: ${exec.summary.slice(0, 200)}`);\n  }\n  if (exec.error) {\n    lines.push(`  Error: ${exec.error.slice(0, 200)}`);\n  }\n  return lines.join('\\n');\n}\n\nexport function createCronjobTool(deps: CronjobToolDeps): AgentTool {\n  return {\n    name: 'cronjob',\n    label: '⏰ Cronjob',\n    description:\n      'Manage scheduled tasks (cron jobs) that run automatically.\\n\\n' +\n      'Jobs can run an agent message (agentTurn), a workflow directly (workflowRun), or continue a durable goal (goalContinue).\\n\\n' +\n      'ACTIONS:\\n' +\n      '- list: Show all scheduled jobs with status and next run time\\n' +\n      '- create: Create a job (scheduleKind plus exactly one of message, workflowDefinitionId, or goalId)\\n' +\n      '- update: Change schedule, message, workflow fields, name, sessionTarget, agentId, or workingDirectory (requires jobId)\\n' +\n      '- remove: Delete a job (requires jobId)\\n' +\n      '- enable / disable: Toggle a job (requires jobId)\\n' +\n      '- history: Recent executions for a job (requires jobId)',\n    parameters: CronjobSchema,\n\n    async execute(_toolCallId, params: CronjobToolParams, _signal) {\n      const cron = deps.getCronService();\n      if (!cron) {\n        return textResult('Cron service is not available in this environment.');\n      }\n\n      try {\n        switch (params.action) {\n          case 'list': {\n            const jobs = await cron.listJobs();\n            if (jobs.length === 0) {\n              return textResult('No scheduled jobs.');\n            }\n            const formatted = jobs.map(formatJob).join('\\n\\n');\n            return { content: [{ type: 'text', text: formatted }], details: {} };\n          }\n\n          case 'create': {\n            const workflowId = params.workflowDefinitionId?.trim();\n            const goalId = params.goalId?.trim();\n            const hasMessage = Boolean(params.message?.trim());\n            const targetCount = [workflowId, goalId, hasMessage ? 'message' : ''].filter(Boolean).length;\n            const schedule = scheduleFromParams(params);\n            if (!schedule || targetCount !== 1) {\n              return textResult(\n                'Error: create requires scheduleKind with matching cronExpr/at/everyMs and exactly one of message, workflowDefinitionId, or goalId.',\n              );\n            }\n\n            if (hasMessage) {\n              const scanResult = scanCronPrompt(params.message!);\n              if (scanResult) {\n                return textResult(`Error: ${scanResult}`);\n              }\n            }\n\n            let payload: CronPayload;\n            let sessionTarget = params.sessionTarget ?? 'isolated';\n            let delivery: CronDelivery | undefined;\n\n            if (goalId) {\n              payload = {\n                kind: 'goalContinue',\n                goalId,\n                ...(params.goalMessage?.trim() ? { message: params.goalMessage.trim() } : {}),\n              };\n              sessionTarget = 'isolated';\n            } else if (workflowId) {\n              let inputEnvelope: { payload: unknown } | undefined;\n              if (params.workflowInputJson?.trim()) {\n                try {\n                  inputEnvelope = { payload: JSON.parse(params.workflowInputJson) as unknown };\n                } catch {\n                  return textResult('Error: workflowInputJson must be valid JSON.');\n                }\n              }\n              const agentId = params.agentId?.trim() || undefined;\n              payload = {\n                kind: 'workflowRun',\n                definitionId: workflowId,\n                ...(params.workflowGoal?.trim() ? { goal: params.workflowGoal.trim() } : {}),\n                ...(inputEnvelope ? { inputEnvelope } : {}),\n                ...(agentId ? { agentId } : {}),\n                ...(params.waitForCompletion === false ? { waitForCompletion: false } : {}),\n              };\n              sessionTarget = 'isolated';\n              if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) {\n                delivery = {\n                  mode: 'announce',\n                  channel: params.deliveryChannel.trim(),\n                  to: params.deliveryTo.trim(),\n                };\n              }\n            } else {\n              payload = {\n                kind: 'agentTurn',\n                message: params.message!.trim(),\n              };\n            }\n\n            const result = await cron.addJob(schedule, {\n              name: params.name?.trim() || undefined,\n              sessionTarget,\n              ...(delivery ? { delivery } : {}),\n              ...(params.agentId?.trim() ? { agentId: params.agentId.trim() } : {}),\n              ...(params.workingDirectory?.trim()\n                ? { workingDirectory: params.workingDirectory.trim() }\n                : {}),\n              payload,\n            });\n\n            const kindLabel = goalId ? `goal job (${goalId})` : workflowId ? `workflow job (${workflowId})` : 'job';\n            return textResult(\n              `Created ${kindLabel}${params.name ? ` \"${params.name.trim()}\"` : ''} (${result.id})\\n` +\n                `Schedule: ${describeSchedule(result.schedule)}`,\n            );\n          }\n\n          case 'update': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: update requires jobId.');\n            }\n\n            const updates: CronJobPatch = {};\n            const nextSchedule = scheduleFromParams(params);\n            if (nextSchedule) {\n              updates.schedule = nextSchedule;\n            }\n            if (params.message != null && params.message.trim()) {\n              const scanResult = scanCronPrompt(params.message);\n              if (scanResult) {\n                return textResult(`Error: ${scanResult}`);\n              }\n              updates.payload = { kind: 'agentTurn', message: params.message.trim() };\n            }\n            if (params.goalId?.trim()) {\n              updates.payload = {\n                kind: 'goalContinue',\n                goalId: params.goalId.trim(),\n                ...(params.goalMessage?.trim() ? { message: params.goalMessage.trim() } : {}),\n              };\n              updates.sessionTarget = 'isolated';\n            }\n            if (params.workflowDefinitionId?.trim()) {\n              let inputEnvelope: { payload: unknown } | undefined;\n              if (params.workflowInputJson?.trim()) {\n                try {\n                  inputEnvelope = { payload: JSON.parse(params.workflowInputJson) as unknown };\n                } catch {\n                  return textResult('Error: workflowInputJson must be valid JSON.');\n                }\n              }\n              const agentId = params.agentId?.trim() || undefined;\n              updates.payload = {\n                kind: 'workflowRun',\n                definitionId: params.workflowDefinitionId.trim(),\n                ...(params.workflowGoal?.trim() ? { goal: params.workflowGoal.trim() } : {}),\n                ...(inputEnvelope ? { inputEnvelope } : {}),\n                ...(agentId ? { agentId } : {}),\n                ...(params.waitForCompletion === false ? { waitForCompletion: false } : {}),\n              };\n              updates.sessionTarget = 'isolated';\n            }\n            if (params.deliveryChannel?.trim() && params.deliveryTo?.trim()) {\n              updates.delivery = {\n                mode: 'announce',\n                channel: params.deliveryChannel.trim(),\n                to: params.deliveryTo.trim(),\n              };\n            }\n            if (params.name !== undefined) {\n              updates.name = params.name.trim() || undefined;\n            }\n            if (params.sessionTarget !== undefined) {\n              updates.sessionTarget = params.sessionTarget;\n            }\n            if (params.agentId !== undefined) {\n              const t = params.agentId.trim();\n              if (t) updates.agentId = t;\n            }\n            if (params.workingDirectory !== undefined) {\n              const t = params.workingDirectory.trim();\n              if (t) updates.workingDirectory = t;\n            }\n\n            if (Object.keys(updates).length === 0) {\n              return textResult(\n                'Error: update requires at least one of scheduleKind, message, workflowDefinitionId, name, sessionTarget, agentId, workingDirectory, deliveryChannel/deliveryTo.',\n              );\n            }\n\n            const success = await cron.updateJob(params.jobId.trim(), updates);\n            return textResult(\n              success ? `Updated job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'remove': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: remove requires jobId.');\n            }\n            const removed = await cron.removeJob(params.jobId.trim());\n            return textResult(\n              removed ? `Removed job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'disable': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: disable requires jobId.');\n            }\n            const toggled = await cron.toggleJob(params.jobId.trim(), false);\n            return textResult(\n              toggled ? `Disabled job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'enable': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: enable requires jobId.');\n            }\n            const toggled = await cron.toggleJob(params.jobId.trim(), true);\n            return textResult(\n              toggled ? `Enabled job ${params.jobId.trim()}.` : `Job ${params.jobId.trim()} not found.`,\n            );\n          }\n\n          case 'history': {\n            if (!params.jobId?.trim()) {\n              return textResult('Error: history requires jobId.');\n            }\n            const history = await cron.getJobHistory(params.jobId.trim(), 5);\n            if (history.length === 0) {\n              return textResult(`No execution history for job ${params.jobId.trim()}.`);\n            }\n            const formatted = history.map(formatExecution).join('\\n\\n');\n            return textResult(formatted);\n          }\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        return textResult(`Error: ${message}`);\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

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

@@ -3,8 +3,8 @@ import { init_logger } from "../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();

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

@@ -1,4 +1,5 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { GoalEvidenceRecordInput } from './goal-evidence-recorder.js';
 export interface EditToolDetails {
     diff?: string;
     firstChangedLine?: number;
@@ -7,6 +8,7 @@ export interface EditToolDetails {
 export interface CreateEditFileToolOptions {
     /** When set and the path is a bare profile filename (e.g. SOUL.md), edit under this root. */
     profileMarkdownRoot?: string;
+    recordGoalEvidence?: (input: GoalEvidenceRecordInput) => Promise<void> | void;
 }
 export declare function createEditFileTool(workspace: string, options?: CreateEditFileToolOptions): AgentTool;
 export declare const editFileTool: AgentTool;

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

@@ -86,6 +86,16 @@ function createEditFileTool(workspace, options) {
 				};
 				const diffResult = generateDiffString(originalWithReplacement, finalContent, normalized);
 				await writeFile(normalized, finalContent, "utf-8");
+				await options?.recordGoalEvidence?.({
+					kind: "diff",
+					title: `File edited: ${normalized}`,
+					summary: diffResult.slice(0, 4e3),
+					uri: normalized,
+					data: {
+						path: normalized,
+						fuzzyMatchUsed: matchResult.usedFuzzyMatch
+					}
+				});
 				return {
 					content: [{
 						type: "text",

package/dist/src/agent/tools/edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"edit.js","names":[],"sources":["../../../../src/agent/tools/edit.ts"],"sourcesContent":["// Edit file tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFile, writeFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport {\n  isBareProfileMarkdownFileName,\n  resolveProfileMarkdownPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\nimport { evaluateFilePolicy } from '../sandbox/exec-policy.js';\nimport { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString } from './edit-diff.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nconst EditFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to edit' }),\n  oldText: Type.String({ description: 'Text to replace' }),\n  newText: Type.String({ description: 'Replacement text' }),\n});\n\nexport interface EditToolDetails {\n  diff?: string;\n  firstChangedLine?: number;\n  fuzzyMatchUsed?: boolean;\n}\n\ntype EditFileParams = { path: string; oldText: string; newText: string };\n\nexport interface CreateEditFileToolOptions {\n  /** When set and the path is a bare profile filename (e.g. SOUL.md), edit under this root. */\n  profileMarkdownRoot?: string;\n}\n\nexport function createEditFileTool(\n  workspace: string,\n  options?: CreateEditFileToolOptions,\n): AgentTool {\n  return {\n    name: 'edit_file',\n    description:\n      'Edit file by replacing text. Relative paths are under the current agent workspace; profile Markdown (SOUL.md, etc.) is edited automatically when given by filename.',\n    parameters: EditFileSchema,\n    label: '✏️ Edit',\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<EditToolDetails>> {\n      try {\n        const p = params as EditFileParams;\n        const safety = checkFileSafety('write', p.path);\n        if (!safety.allowed) return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n\n        const editsProfileFile = Boolean(\n          options?.profileMarkdownRoot && isBareProfileMarkdownFileName(p.path),\n        );\n        const workspaceRoot = editsProfileFile ? options!.profileMarkdownRoot! : workspace;\n\n        // Sandbox path-policy check (blocked dirs, symlink escape, config protection)\n        const pathPolicy = evaluateFilePolicy({\n          operation: 'edit',\n          path: p.path,\n          workspaceRoot,\n        });\n        if (!pathPolicy.allowed) {\n          return { content: [{ type: 'text', text: `🚫 Sandbox: ${pathPolicy.reason}` }], details: {} };\n        }\n\n        const normalized = editsProfileFile\n          ? resolveProfileMarkdownPathIfBareName(p.path, options!.profileMarkdownRoot!)\n          : resolvePathUnderWorkspace(p.path, workspace);\n        const stats = await stat(normalized);\n        if (stats.size > MAX_FILE_SIZE) return { content: [{ type: 'text', text: `🚫 File too large` }], details: {} };\n\n        const rawContent = await readFile(normalized, 'utf-8');\n        const content = stripBom(rawContent);\n        const lineEnding = detectLineEnding(rawContent);\n\n        const normalizedContent = normalizeToLF(content);\n        const normalizedOldText = normalizeToLF(p.oldText);\n        const normalizedNewText = normalizeToLF(p.newText);\n\n        const matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\n        if (!matchResult.found) return { content: [{ type: 'text', text: `Error: oldText not found` }], details: {} };\n\n        const fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\n        const fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\n        const occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\n        if (occurrences > 1)\n          return { content: [{ type: 'text', text: `Error: ${occurrences} occurrences found, text must be unique` }], details: {} };\n\n        const baseContent = matchResult.contentForReplacement;\n        const newContent =\n          baseContent.substring(0, matchResult.index) +\n          normalizedNewText +\n          baseContent.substring(matchResult.index + matchResult.matchLength);\n        const finalContent = restoreLineEndings(newContent, lineEnding);\n        const originalWithReplacement = restoreLineEndings(baseContent, lineEnding);\n\n        if (originalWithReplacement === finalContent)\n          return { content: [{ type: 'text', text: `Error: No changes` }], details: {} };\n\n        const diffResult = generateDiffString(originalWithReplacement, finalContent, normalized);\n        await writeFile(normalized, finalContent, 'utf-8');\n\n        return {\n          content: [{ type: 'text', text: `File edited: ${normalized}` }],\n          details: { diff: diffResult, fuzzyMatchUsed: matchResult.usedFuzzyMatch },\n        };\n      } catch (error) {\n        return {\n          content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],\n          details: {},\n        };\n      }\n    },\n  } as any;\n}\n\nexport const editFileTool: AgentTool = createEditFileTool(process.cwd());\n\nfunction detectLineEnding(content: string): '\\r\\n' | '\\n' {\n  const crlfIdx = content.indexOf('\\r\\n');\n  const lfIdx = content.indexOf('\\n');\n  if (lfIdx === -1) return '\\n';\n  if (crlfIdx === -1) return '\\n';\n  return crlfIdx < lfIdx ? '\\r\\n' : '\\n';\n}\n"],"mappings":"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"}
+{"version":3,"file":"edit.js","names":[],"sources":["../../../../src/agent/tools/edit.ts"],"sourcesContent":["// Edit file tool\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { readFile, writeFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport {\n  isBareProfileMarkdownFileName,\n  resolveProfileMarkdownPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\nimport { evaluateFilePolicy } from '../sandbox/exec-policy.js';\nimport { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString } from './edit-diff.js';\nimport type { GoalEvidenceRecordInput } from './goal-evidence-recorder.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nconst EditFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to edit' }),\n  oldText: Type.String({ description: 'Text to replace' }),\n  newText: Type.String({ description: 'Replacement text' }),\n});\n\nexport interface EditToolDetails {\n  diff?: string;\n  firstChangedLine?: number;\n  fuzzyMatchUsed?: boolean;\n}\n\ntype EditFileParams = { path: string; oldText: string; newText: string };\n\nexport interface CreateEditFileToolOptions {\n  /** When set and the path is a bare profile filename (e.g. SOUL.md), edit under this root. */\n  profileMarkdownRoot?: string;\n  recordGoalEvidence?: (input: GoalEvidenceRecordInput) => Promise<void> | void;\n}\n\nexport function createEditFileTool(\n  workspace: string,\n  options?: CreateEditFileToolOptions,\n): AgentTool {\n  return {\n    name: 'edit_file',\n    description:\n      'Edit file by replacing text. Relative paths are under the current agent workspace; profile Markdown (SOUL.md, etc.) is edited automatically when given by filename.',\n    parameters: EditFileSchema,\n    label: '✏️ Edit',\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<EditToolDetails>> {\n      try {\n        const p = params as EditFileParams;\n        const safety = checkFileSafety('write', p.path);\n        if (!safety.allowed) return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n\n        const editsProfileFile = Boolean(\n          options?.profileMarkdownRoot && isBareProfileMarkdownFileName(p.path),\n        );\n        const workspaceRoot = editsProfileFile ? options!.profileMarkdownRoot! : workspace;\n\n        // Sandbox path-policy check (blocked dirs, symlink escape, config protection)\n        const pathPolicy = evaluateFilePolicy({\n          operation: 'edit',\n          path: p.path,\n          workspaceRoot,\n        });\n        if (!pathPolicy.allowed) {\n          return { content: [{ type: 'text', text: `🚫 Sandbox: ${pathPolicy.reason}` }], details: {} };\n        }\n\n        const normalized = editsProfileFile\n          ? resolveProfileMarkdownPathIfBareName(p.path, options!.profileMarkdownRoot!)\n          : resolvePathUnderWorkspace(p.path, workspace);\n        const stats = await stat(normalized);\n        if (stats.size > MAX_FILE_SIZE) return { content: [{ type: 'text', text: `🚫 File too large` }], details: {} };\n\n        const rawContent = await readFile(normalized, 'utf-8');\n        const content = stripBom(rawContent);\n        const lineEnding = detectLineEnding(rawContent);\n\n        const normalizedContent = normalizeToLF(content);\n        const normalizedOldText = normalizeToLF(p.oldText);\n        const normalizedNewText = normalizeToLF(p.newText);\n\n        const matchResult = fuzzyFindText(normalizedContent, normalizedOldText);\n        if (!matchResult.found) return { content: [{ type: 'text', text: `Error: oldText not found` }], details: {} };\n\n        const fuzzyContent = normalizeForFuzzyMatch(normalizedContent);\n        const fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);\n        const occurrences = fuzzyContent.split(fuzzyOldText).length - 1;\n        if (occurrences > 1)\n          return { content: [{ type: 'text', text: `Error: ${occurrences} occurrences found, text must be unique` }], details: {} };\n\n        const baseContent = matchResult.contentForReplacement;\n        const newContent =\n          baseContent.substring(0, matchResult.index) +\n          normalizedNewText +\n          baseContent.substring(matchResult.index + matchResult.matchLength);\n        const finalContent = restoreLineEndings(newContent, lineEnding);\n        const originalWithReplacement = restoreLineEndings(baseContent, lineEnding);\n\n        if (originalWithReplacement === finalContent)\n          return { content: [{ type: 'text', text: `Error: No changes` }], details: {} };\n\n        const diffResult = generateDiffString(originalWithReplacement, finalContent, normalized);\n        await writeFile(normalized, finalContent, 'utf-8');\n        await options?.recordGoalEvidence?.({\n          kind: 'diff',\n          title: `File edited: ${normalized}`,\n          summary: diffResult.slice(0, 4000),\n          uri: normalized,\n          data: {\n            path: normalized,\n            fuzzyMatchUsed: matchResult.usedFuzzyMatch,\n          },\n        });\n\n        return {\n          content: [{ type: 'text', text: `File edited: ${normalized}` }],\n          details: { diff: diffResult, fuzzyMatchUsed: matchResult.usedFuzzyMatch },\n        };\n      } catch (error) {\n        return {\n          content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],\n          details: {},\n        };\n      }\n    },\n  } as any;\n}\n\nexport const editFileTool: AgentTool = createEditFileTool(process.cwd());\n\nfunction detectLineEnding(content: string): '\\r\\n' | '\\n' {\n  const crlfIdx = content.indexOf('\\r\\n');\n  const lfIdx = content.indexOf('\\n');\n  if (lfIdx === -1) return '\\n';\n  if (crlfIdx === -1) return '\\n';\n  return crlfIdx < lfIdx ? '\\r\\n' : '\\n';\n}\n"],"mappings":";;;;;;;AAcA,MAAM,gBAAgB,KAAK,OAAO;AAElC,MAAM,iBAAiB,KAAK,OAAO;CACjC,MAAM,KAAK,OAAO,EAAE,aAAa,qBAAqB,CAAC;CACvD,SAAS,KAAK,OAAO,EAAE,aAAa,mBAAmB,CAAC;CACxD,SAAS,KAAK,OAAO,EAAE,aAAa,oBAAoB,CAAC;CAC1D,CAAC;AAgBF,SAAgB,mBACd,WACA,SACW;AACX,QAAO;EACL,MAAM;EACN,aACE;EACF,YAAY;EACZ,OAAO;EAEP,MAAM,QACJ,aACA,QACA,SAC2C;AAC3C,OAAI;IACF,MAAM,IAAI;IACV,MAAM,SAAS,gBAAgB,SAAS,EAAE,KAAK;AAC/C,QAAI,CAAC,OAAO,QAAS,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,MAAM,OAAO;MAAW,CAAC;KAAE,SAAS,EAAE;KAAE;IAEtG,MAAM,mBAAmB,QACvB,SAAS,uBAAuB,8BAA8B,EAAE,KAAK,CACtE;IACD,MAAM,gBAAgB,mBAAmB,QAAS,sBAAuB;IAGzE,MAAM,aAAa,mBAAmB;KACpC,WAAW;KACX,MAAM,EAAE;KACR;KACD,CAAC;AACF,QAAI,CAAC,WAAW,QACd,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,eAAe,WAAW;MAAU,CAAC;KAAE,SAAS,EAAE;KAAE;IAG/F,MAAM,aAAa,mBACf,qCAAqC,EAAE,MAAM,QAAS,oBAAqB,GAC3E,0BAA0B,EAAE,MAAM,UAAU;AAEhD,SAAI,MADgB,KAAK,WAAW,EAC1B,OAAO,cAAe,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAqB,CAAC;KAAE,SAAS,EAAE;KAAE;IAE9G,MAAM,aAAa,MAAM,SAAS,YAAY,QAAQ;IACtD,MAAM,UAAU,SAAS,WAAW;IACpC,MAAM,aAAa,iBAAiB,WAAW;IAE/C,MAAM,oBAAoB,cAAc,QAAQ;IAChD,MAAM,oBAAoB,cAAc,EAAE,QAAQ;IAClD,MAAM,oBAAoB,cAAc,EAAE,QAAQ;IAElD,MAAM,cAAc,cAAc,mBAAmB,kBAAkB;AACvE,QAAI,CAAC,YAAY,MAAO,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAA4B,CAAC;KAAE,SAAS,EAAE;KAAE;IAE7G,MAAM,eAAe,uBAAuB,kBAAkB;IAC9D,MAAM,eAAe,uBAAuB,kBAAkB;IAC9D,MAAM,cAAc,aAAa,MAAM,aAAa,CAAC,SAAS;AAC9D,QAAI,cAAc,EAChB,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,UAAU,YAAY;MAA0C,CAAC;KAAE,SAAS,EAAE;KAAE;IAE3H,MAAM,cAAc,YAAY;IAKhC,MAAM,eAAe,mBAHnB,YAAY,UAAU,GAAG,YAAY,MAAM,GAC3C,oBACA,YAAY,UAAU,YAAY,QAAQ,YAAY,YAAY,EAChB,WAAW;IAC/D,MAAM,0BAA0B,mBAAmB,aAAa,WAAW;AAE3E,QAAI,4BAA4B,aAC9B,QAAO;KAAE,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAqB,CAAC;KAAE,SAAS,EAAE;KAAE;IAEhF,MAAM,aAAa,mBAAmB,yBAAyB,cAAc,WAAW;AACxF,UAAM,UAAU,YAAY,cAAc,QAAQ;AAClD,UAAM,SAAS,qBAAqB;KAClC,MAAM;KACN,OAAO,gBAAgB;KACvB,SAAS,WAAW,MAAM,GAAG,IAAK;KAClC,KAAK;KACL,MAAM;MACJ,MAAM;MACN,gBAAgB,YAAY;MAC7B;KACF,CAAC;AAEF,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,gBAAgB;MAAc,CAAC;KAC/D,SAAS;MAAE,MAAM;MAAY,gBAAgB,YAAY;MAAgB;KAC1E;YACM,OAAO;AACd,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;MAAI,CAAC;KACrG,SAAS,EAAE;KACZ;;;EAGN;;AAGH,MAAa,eAA0B,mBAAmB,QAAQ,KAAK,CAAC;AAExE,SAAS,iBAAiB,SAAgC;CACxD,MAAM,UAAU,QAAQ,QAAQ,OAAO;CACvC,MAAM,QAAQ,QAAQ,QAAQ,KAAK;AACnC,KAAI,UAAU,GAAI,QAAO;AACzB,KAAI,YAAY,GAAI,QAAO;AAC3B,QAAO,UAAU,QAAQ,SAAS"}