qlogicagent 0.1.0

package/dist/skills/tools/checkpoint-tool.js

@@ -0,0 +1,103 @@
+// ============================================================
+// Checkpoint Manager — transparent file history snapshots.
+// Reference: hermes-agent-main/tools/checkpoint_manager.py
+// Category: infrastructure (LLM does NOT directly invoke)
+// ============================================================
+export const CHECKPOINT_TOOL_NAME = "checkpoint";
+export const CHECKPOINT_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: ["create", "list", "restore", "diff"],
+            description: "Action: create (snapshot current state), list (show checkpoints), " +
+                "restore (revert to checkpoint), diff (show changes since checkpoint).",
+        },
+        checkpointId: {
+            type: "string",
+            description: "Checkpoint ID. Required for restore and diff.",
+        },
+        message: {
+            type: "string",
+            description: "Optional descriptive message for the checkpoint.",
+        },
+        paths: {
+            type: "array",
+            items: { type: "string" },
+            description: "File paths to restore (partial restore). Omit to restore everything.",
+        },
+    },
+    required: ["action"],
+};
+const COMMIT_HASH_PATTERN = /^[0-9a-fA-F]{4,64}$/;
+export function createCheckpointTool(deps) {
+    return {
+        name: CHECKPOINT_TOOL_NAME,
+        label: "Checkpoint",
+        description: "Manage workspace checkpoints (shadow snapshots independent of user's git). " +
+            "Create snapshots before risky operations, list history, restore on errors, " +
+            "or diff to see what changed. Checkpoints do NOT affect user's .git.",
+        parameters: CHECKPOINT_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            switch (params.action) {
+                case "create": {
+                    const r = await deps.createCheckpoint(params.message);
+                    if (!r.success) {
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "checkpoint", error: r.error } };
+                    }
+                    return {
+                        content: [{ type: "text", text: `Checkpoint created: ${r.checkpoint.id}\nMessage: ${r.checkpoint.message}\nFiles: ${r.checkpoint.fileCount}` }],
+                        details: { type: "checkpoint", action: "create", checkpointId: r.checkpoint.id },
+                    };
+                }
+                case "list": {
+                    const r = await deps.listCheckpoints();
+                    if (!r.checkpoints || r.checkpoints.length === 0) {
+                        return { content: [{ type: "text", text: "No checkpoints available." }], details: { type: "checkpoint", action: "list", count: 0 } };
+                    }
+                    const lines = [`Checkpoints (${r.checkpoints.length}):`, ""];
+                    for (const cp of r.checkpoints) {
+                        lines.push(`- ${cp.id.slice(0, 8)} [${cp.timestamp}] ${cp.message} (${cp.fileCount} files)`);
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "checkpoint", action: "list", count: r.checkpoints.length } };
+                }
+                case "restore": {
+                    if (!params.checkpointId) {
+                        return { content: [{ type: "text", text: "Error: checkpointId required for restore." }], details: { type: "checkpoint", error: "missing_id" } };
+                    }
+                    if (!COMMIT_HASH_PATTERN.test(params.checkpointId)) {
+                        return { content: [{ type: "text", text: "Error: invalid checkpoint ID format." }], details: { type: "checkpoint", error: "invalid_id" } };
+                    }
+                    const r = await deps.restoreCheckpoint(params.checkpointId, params.paths);
+                    if (!r.success) {
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "checkpoint", error: r.error } };
+                    }
+                    const scope = params.paths ? `(${params.paths.length} files)` : "(full workspace)";
+                    return {
+                        content: [{ type: "text", text: `Restored to checkpoint ${params.checkpointId.slice(0, 8)} ${scope}` }],
+                        details: { type: "checkpoint", action: "restore", checkpointId: params.checkpointId },
+                    };
+                }
+                case "diff": {
+                    if (!params.checkpointId) {
+                        return { content: [{ type: "text", text: "Error: checkpointId required for diff." }], details: { type: "checkpoint", error: "missing_id" } };
+                    }
+                    if (!COMMIT_HASH_PATTERN.test(params.checkpointId)) {
+                        return { content: [{ type: "text", text: "Error: invalid checkpoint ID format." }], details: { type: "checkpoint", error: "invalid_id" } };
+                    }
+                    const r = await deps.diffCheckpoint(params.checkpointId);
+                    if (!r.success) {
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "checkpoint", error: r.error } };
+                    }
+                    return {
+                        content: [{ type: "text", text: r.diff || "(no changes since checkpoint)" }],
+                        details: { type: "checkpoint", action: "diff", checkpointId: params.checkpointId },
+                    };
+                }
+                default:
+                    return { content: [{ type: "text", text: `Error: unknown action "${params.action}".` }], details: { type: "checkpoint", error: "unknown_action" } };
+            }
+        },
+    };
+}
+//# sourceMappingURL=checkpoint-tool.js.map

package/dist/skills/tools/checkpoint-tool.js.map

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

package/dist/skills/tools/config-tool.d.ts

@@ -0,0 +1,64 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const CONFIG_TOOL_NAME: "config";
+export type ConfigAction = "get" | "set" | "list" | "reset";
+export interface ConfigToolParams {
+    /** Config action */
+    action: ConfigAction;
+    /** Setting key path (e.g. "model", "language", "theme") */
+    key?: string;
+    /** Value to set (for 'set' action) */
+    value?: string | boolean | number;
+}
+export declare const CONFIG_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly action: {
+            readonly type: "string";
+            readonly enum: readonly ["get", "set", "list", "reset"];
+            readonly description: string;
+        };
+        readonly key: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly value: {
+            readonly description: "Value to set. Type depends on the setting. Required for 'set' action.";
+        };
+    };
+    readonly required: readonly ["action"];
+};
+export interface ConfigSetting {
+    key: string;
+    value: unknown;
+    type: "string" | "boolean" | "number" | "enum";
+    description: string;
+    options?: string[];
+    readOnly?: boolean;
+}
+export interface ConfigResult {
+    success: boolean;
+    setting?: ConfigSetting;
+    settings?: ConfigSetting[];
+    previousValue?: unknown;
+    error?: string;
+}
+/** Keys that cannot be modified by LLM (security-critical) */
+export declare const CONFIG_READONLY_KEYS: readonly string[];
+/**
+ * Host-provided config backend.
+ * Manages persistent agent settings with safety guardrails.
+ */
+export interface ConfigToolDeps {
+    /** Get a single config value */
+    getConfig(key: string): Promise<ConfigResult>;
+    /** Set a config value (respects readonly/whitelist) */
+    setConfig(key: string, value: unknown): Promise<ConfigResult>;
+    /** List all available config settings */
+    listConfig(): Promise<ConfigResult>;
+    /** Reset a setting to default */
+    resetConfig(key: string): Promise<ConfigResult>;
+    /** Check if a key is supported/valid */
+    isValidKey?(key: string): boolean;
+}
+export declare function createConfigTool(deps: ConfigToolDeps): PortableTool<ConfigToolParams>;
+//# sourceMappingURL=config-tool.d.ts.map

package/dist/skills/tools/config-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/config-tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAwBrB,CAAC;AAIX,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAMxC,CAAC;AAEX;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9C,uDAAuD;IACvD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9D,yCAAyC;IACzC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,iCAAiC;IACjC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChD,wCAAwC;IACxC,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAAC,gBAAgB,CAAC,CA8GrF"}

package/dist/skills/tools/config-tool.js

@@ -0,0 +1,144 @@
+// ============================================================
+// Config Tool — agent configuration management (read/write preferences).
+// Reference: claude-code-haha/src/tools/ConfigTool/ConfigTool.ts
+// Category: system
+// ============================================================
+export const CONFIG_TOOL_NAME = "config";
+export const CONFIG_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: ["get", "set", "list", "reset"],
+            description: "Action:\n" +
+                "- get: Read a config setting\n" +
+                "- set: Write a config setting\n" +
+                "- list: List all available settings\n" +
+                "- reset: Reset a setting to default",
+        },
+        key: {
+            type: "string",
+            description: "Config key path (e.g. 'model', 'language', 'theme', 'permissions.defaultMode'). " +
+                "Required for get/set/reset.",
+        },
+        value: {
+            description: "Value to set. Type depends on the setting. Required for 'set' action.",
+        },
+    },
+    required: ["action"],
+};
+/** Keys that cannot be modified by LLM (security-critical) */
+export const CONFIG_READONLY_KEYS = [
+    "permissions.securityPolicy",
+    "api.key",
+    "api.secret",
+    "auth.token",
+    "system.adminMode",
+];
+export function createConfigTool(deps) {
+    return {
+        name: CONFIG_TOOL_NAME,
+        label: "Config",
+        description: "Read and write agent configuration settings. " +
+            "Supports preferences like model selection, language, theme, tool enablement, etc. " +
+            "Security-critical settings (API keys, permissions) are read-only. " +
+            "Changes persist across sessions.",
+        parameters: CONFIG_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            switch (params.action) {
+                case "get": {
+                    if (!params.key) {
+                        return { content: [{ type: "text", text: "Error: key is required for get." }], details: { type: "config", error: "missing_key" } };
+                    }
+                    if (deps.isValidKey && !deps.isValidKey(params.key)) {
+                        return { content: [{ type: "text", text: `Error: unknown config key "${params.key}". Use action='list' to see available settings.` }], details: { type: "config", error: "unknown_key" } };
+                    }
+                    const result = await deps.getConfig(params.key);
+                    if (!result.success) {
+                        return { content: [{ type: "text", text: `Error: ${result.error}` }], details: { type: "config", error: result.error } };
+                    }
+                    const s = result.setting;
+                    const lines = [
+                        `${s.key} = ${JSON.stringify(s.value)}`,
+                        `  Type: ${s.type}${s.options ? ` (${s.options.join(" | ")})` : ""}`,
+                        `  ${s.description}`,
+                    ];
+                    if (s.readOnly)
+                        lines.push("  ⚠️ Read-only (cannot be changed)");
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                        details: { type: "config", action: "get", key: params.key, value: s.value },
+                    };
+                }
+                case "set": {
+                    if (!params.key) {
+                        return { content: [{ type: "text", text: "Error: key is required for set." }], details: { type: "config", error: "missing_key" } };
+                    }
+                    if (params.value === undefined) {
+                        return { content: [{ type: "text", text: "Error: value is required for set." }], details: { type: "config", error: "missing_value" } };
+                    }
+                    // Block security-critical keys
+                    if (CONFIG_READONLY_KEYS.includes(params.key)) {
+                        return {
+                            content: [{ type: "text", text: `Error: "${params.key}" is a security-critical setting and cannot be modified.` }],
+                            details: { type: "config", error: "readonly_key" },
+                        };
+                    }
+                    if (deps.isValidKey && !deps.isValidKey(params.key)) {
+                        return { content: [{ type: "text", text: `Error: unknown config key "${params.key}".` }], details: { type: "config", error: "unknown_key" } };
+                    }
+                    const result = await deps.setConfig(params.key, params.value);
+                    if (!result.success) {
+                        return { content: [{ type: "text", text: `Error: ${result.error}` }], details: { type: "config", error: result.error } };
+                    }
+                    return {
+                        content: [{ type: "text", text: `Updated "${params.key}": ${JSON.stringify(result.previousValue)} → ${JSON.stringify(params.value)}` }],
+                        details: { type: "config", action: "set", key: params.key, previousValue: result.previousValue, newValue: params.value },
+                    };
+                }
+                case "list": {
+                    const result = await deps.listConfig();
+                    if (!result.settings || result.settings.length === 0) {
+                        return { content: [{ type: "text", text: "No config settings available." }], details: { type: "config", action: "list", count: 0 } };
+                    }
+                    const lines = [`Available settings (${result.settings.length}):`, ""];
+                    for (const s of result.settings) {
+                        const ro = s.readOnly ? " [read-only]" : "";
+                        const val = JSON.stringify(s.value);
+                        lines.push(`  ${s.key} = ${val}${ro}`);
+                        lines.push(`    ${s.description}`);
+                    }
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                        details: { type: "config", action: "list", count: result.settings.length },
+                    };
+                }
+                case "reset": {
+                    if (!params.key) {
+                        return { content: [{ type: "text", text: "Error: key is required for reset." }], details: { type: "config", error: "missing_key" } };
+                    }
+                    if (CONFIG_READONLY_KEYS.includes(params.key)) {
+                        return {
+                            content: [{ type: "text", text: `Error: "${params.key}" cannot be reset (security-critical).` }],
+                            details: { type: "config", error: "readonly_key" },
+                        };
+                    }
+                    const result = await deps.resetConfig(params.key);
+                    if (!result.success) {
+                        return { content: [{ type: "text", text: `Error: ${result.error}` }], details: { type: "config", error: result.error } };
+                    }
+                    return {
+                        content: [{ type: "text", text: `Reset "${params.key}" to default: ${JSON.stringify(result.setting?.value)}` }],
+                        details: { type: "config", action: "reset", key: params.key, value: result.setting?.value },
+                    };
+                }
+                default:
+                    return {
+                        content: [{ type: "text", text: `Error: unknown action "${params.action}".` }],
+                        details: { type: "config", error: "unknown_action" },
+                    };
+            }
+        },
+    };
+}
+//# sourceMappingURL=config-tool.js.map

package/dist/skills/tools/config-tool.js.map

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

package/dist/skills/tools/cron-tool.d.ts

@@ -0,0 +1,117 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const CRON_TOOL_NAME: "cron";
+export type CronAction = "create" | "list" | "get" | "update" | "delete" | "pause" | "resume" | "trigger";
+export interface CronToolParams {
+    action: CronAction;
+    /** Job ID (required for get/update/delete/pause/resume/trigger) */
+    jobId?: string;
+    /** Task prompt to execute on schedule */
+    prompt?: string;
+    /** Cron expression or shorthand ('5m', '1h', '0 9 * * *') */
+    schedule?: string;
+    /** Human-readable job name */
+    name?: string;
+    /** Repeat count (null = infinite) */
+    repeat?: number | null;
+    /** Allowed tools for the scheduled task */
+    allowedTools?: string[];
+    /** Whether the job is enabled */
+    enabled?: boolean;
+}
+export declare const CRON_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly action: {
+            readonly type: "string";
+            readonly enum: readonly ["create", "list", "get", "update", "delete", "pause", "resume", "trigger"];
+            readonly description: "CRUD action: create/list/get/update/delete/pause/resume/trigger.";
+        };
+        readonly jobId: {
+            readonly type: "string";
+            readonly description: "Job ID. Required for get/update/delete/pause/resume/trigger.";
+        };
+        readonly prompt: {
+            readonly type: "string";
+            readonly description: "Task prompt to execute on schedule. Required for create.";
+        };
+        readonly schedule: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly description: "Human-readable job name.";
+        };
+        readonly repeat: {
+            readonly type: "number";
+            readonly description: "Number of times to repeat (null = infinite). Default: null.";
+        };
+        readonly allowedTools: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Tools the scheduled task is allowed to use.";
+        };
+        readonly enabled: {
+            readonly type: "boolean";
+            readonly description: "Whether the job is enabled (for update).";
+        };
+    };
+    readonly required: readonly ["action"];
+};
+export interface CronJob {
+    id: string;
+    name: string;
+    prompt: string;
+    schedule: string;
+    scheduleDisplay: string;
+    state: "scheduled" | "paused";
+    enabled: boolean;
+    repeat: {
+        times: number | null;
+        completed: number;
+    };
+    nextRunAt?: string;
+    lastRunAt?: string;
+    lastStatus?: "success" | "error" | null;
+    allowedTools?: string[];
+}
+export interface CronResult {
+    success: boolean;
+    job?: CronJob;
+    jobs?: CronJob[];
+    error?: string;
+}
+/**
+ * Host-provided cron scheduler backend.
+ * Jobs are persisted locally and survive restarts.
+ */
+export interface CronToolDeps {
+    createJob(params: {
+        prompt: string;
+        schedule: string;
+        name?: string;
+        repeat?: number | null;
+        allowedTools?: string[];
+    }): Promise<CronResult>;
+    listJobs(): Promise<CronResult>;
+    getJob(jobId: string): Promise<CronResult>;
+    updateJob(jobId: string, updates: Partial<{
+        prompt: string;
+        schedule: string;
+        name: string;
+        enabled: boolean;
+        repeat: number | null;
+        allowedTools: string[];
+    }>): Promise<CronResult>;
+    deleteJob(jobId: string): Promise<CronResult>;
+    pauseJob(jobId: string): Promise<CronResult>;
+    resumeJob(jobId: string): Promise<CronResult>;
+    triggerJob(jobId: string): Promise<CronResult>;
+    /** Validate cron schedule expression. Returns error or null. */
+    validateSchedule?(schedule: string): string | null;
+}
+export declare const MAX_CRON_JOBS = 50;
+export declare function createCronTool(deps: CronToolDeps): PortableTool<CronToolParams>;
+//# sourceMappingURL=cron-tool.d.ts.map

package/dist/skills/tools/cron-tool.d.ts.map

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

package/dist/skills/tools/cron-tool.js

@@ -0,0 +1,176 @@
+// ============================================================
+// Cron Tool — scheduled task management (CRUD).
+// Reference: hermes-agent-main/tools/cronjob_tools.py
+// Category: system
+// ============================================================
+export const CRON_TOOL_NAME = "cron";
+export const CRON_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: ["create", "list", "get", "update", "delete", "pause", "resume", "trigger"],
+            description: "CRUD action: create/list/get/update/delete/pause/resume/trigger.",
+        },
+        jobId: {
+            type: "string",
+            description: "Job ID. Required for get/update/delete/pause/resume/trigger.",
+        },
+        prompt: {
+            type: "string",
+            description: "Task prompt to execute on schedule. Required for create.",
+        },
+        schedule: {
+            type: "string",
+            description: "Schedule expression. Supports:\n" +
+                "- Cron: '0 9 * * *' (every day at 9am)\n" +
+                "- Shorthand: '5m' (every 5 min), '1h' (hourly), '1d' (daily)\n" +
+                "Required for create.",
+        },
+        name: {
+            type: "string",
+            description: "Human-readable job name.",
+        },
+        repeat: {
+            type: "number",
+            description: "Number of times to repeat (null = infinite). Default: null.",
+        },
+        allowedTools: {
+            type: "array",
+            items: { type: "string" },
+            description: "Tools the scheduled task is allowed to use.",
+        },
+        enabled: {
+            type: "boolean",
+            description: "Whether the job is enabled (for update).",
+        },
+    },
+    required: ["action"],
+};
+export const MAX_CRON_JOBS = 50;
+export function createCronTool(deps) {
+    return {
+        name: CRON_TOOL_NAME,
+        label: "Cron",
+        description: "Manage scheduled tasks. Create recurring jobs with cron expressions or shorthand " +
+            "('5m', '1h', '0 9 * * *'). Jobs persist locally and survive restarts. " +
+            "Actions: create, list, get, update, delete, pause, resume, trigger (run now).",
+        parameters: CRON_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            switch (params.action) {
+                case "create": {
+                    if (!params.prompt) {
+                        return { content: [{ type: "text", text: "Error: prompt is required for create." }], details: { type: "cron", error: "missing_prompt" } };
+                    }
+                    if (!params.schedule) {
+                        return { content: [{ type: "text", text: "Error: schedule is required for create." }], details: { type: "cron", error: "missing_schedule" } };
+                    }
+                    if (deps.validateSchedule) {
+                        const err = deps.validateSchedule(params.schedule);
+                        if (err)
+                            return { content: [{ type: "text", text: `Error: invalid schedule — ${err}` }], details: { type: "cron", error: "invalid_schedule" } };
+                    }
+                    // Check max jobs limit
+                    const existing = await deps.listJobs();
+                    if (existing.jobs && existing.jobs.length >= MAX_CRON_JOBS) {
+                        return { content: [{ type: "text", text: `Error: maximum ${MAX_CRON_JOBS} jobs reached. Delete unused jobs first.` }], details: { type: "cron", error: "max_jobs_reached" } };
+                    }
+                    const r = await deps.createJob({ prompt: params.prompt, schedule: params.schedule, name: params.name, repeat: params.repeat, allowedTools: params.allowedTools });
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: formatJob(r.job) }], details: { type: "cron", action: "create", jobId: r.job.id } };
+                }
+                case "list": {
+                    const r = await deps.listJobs();
+                    if (!r.jobs || r.jobs.length === 0) {
+                        return { content: [{ type: "text", text: "No scheduled jobs." }], details: { type: "cron", action: "list", count: 0 } };
+                    }
+                    const lines = [`Scheduled jobs (${r.jobs.length}):`, ""];
+                    for (const j of r.jobs) {
+                        lines.push(`- **${j.name || j.id}** [${j.state}] ${j.scheduleDisplay} — next: ${j.nextRunAt || "N/A"}`);
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "cron", action: "list", count: r.jobs.length } };
+                }
+                case "get": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const r = await deps.getJob(params.jobId);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: formatJob(r.job) }], details: { type: "cron", action: "get", jobId: params.jobId } };
+                }
+                case "update": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const updates = {};
+                    if (params.prompt !== undefined)
+                        updates.prompt = params.prompt;
+                    if (params.schedule !== undefined)
+                        updates.schedule = params.schedule;
+                    if (params.name !== undefined)
+                        updates.name = params.name;
+                    if (params.enabled !== undefined)
+                        updates.enabled = params.enabled;
+                    if (params.repeat !== undefined)
+                        updates.repeat = params.repeat;
+                    if (params.allowedTools !== undefined)
+                        updates.allowedTools = params.allowedTools;
+                    const r = await deps.updateJob(params.jobId, updates);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: `Job updated.\n${formatJob(r.job)}` }], details: { type: "cron", action: "update", jobId: params.jobId } };
+                }
+                case "delete": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const r = await deps.deleteJob(params.jobId);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: `Job ${params.jobId} deleted.` }], details: { type: "cron", action: "delete", jobId: params.jobId } };
+                }
+                case "pause": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const r = await deps.pauseJob(params.jobId);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: `Job ${params.jobId} paused.` }], details: { type: "cron", action: "pause", jobId: params.jobId } };
+                }
+                case "resume": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const r = await deps.resumeJob(params.jobId);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: `Job ${params.jobId} resumed.` }], details: { type: "cron", action: "resume", jobId: params.jobId } };
+                }
+                case "trigger": {
+                    if (!params.jobId)
+                        return { content: [{ type: "text", text: "Error: jobId required." }], details: { type: "cron", error: "missing_jobId" } };
+                    const r = await deps.triggerJob(params.jobId);
+                    if (!r.success)
+                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "cron", error: r.error } };
+                    return { content: [{ type: "text", text: `Job ${params.jobId} triggered (running now).` }], details: { type: "cron", action: "trigger", jobId: params.jobId } };
+                }
+                default:
+                    return { content: [{ type: "text", text: `Error: unknown action "${params.action}".` }], details: { type: "cron", error: "unknown_action" } };
+            }
+        },
+    };
+}
+function formatJob(job) {
+    const lines = [
+        `Job: ${job.name || job.id}`,
+        `ID: ${job.id}`,
+        `Schedule: ${job.scheduleDisplay} (${job.schedule})`,
+        `State: ${job.state}`,
+        `Repeat: ${job.repeat.times === null ? "infinite" : `${job.repeat.completed}/${job.repeat.times}`}`,
+    ];
+    if (job.nextRunAt)
+        lines.push(`Next run: ${job.nextRunAt}`);
+    if (job.lastRunAt)
+        lines.push(`Last run: ${job.lastRunAt} (${job.lastStatus || "unknown"})`);
+    lines.push(`Prompt: ${job.prompt.slice(0, 100)}${job.prompt.length > 100 ? "..." : ""}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=cron-tool.js.map