@cleocode/core 2026.6.13 → 2026.6.15

package/dist/tools/schedule-agent-tools.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Cron / todo agent-tool family — `todo_add` / `todo_list` / `cron_schedule`
+ * (T11950 · M7 · epic T11456 · SG-TOOLS).
+ *
+ * Surfaces the EXISTING task store to the agent loop as `agent`-toolset tools that
+ * work daemon-OFF:
+ *
+ *   - **`todo_add`** — create a task, DELEGATING to the existing
+ *     {@link import('../tasks/ops.js')}'s `tasksAddOp` (the same path `cleo add`
+ *     uses). No new table, no new schema.
+ *   - **`todo_list`** — list tasks, DELEGATING to `tasksListOp` (the same path
+ *     `cleo list` uses).
+ *   - **`cron_schedule`** — register a recurring schedule. The schedule store now
+ *     exists (the `schedules` table + leased Gate-3 accessor `store/schedule-store.ts`,
+ *     T11962 under T11679), so this tool DELEGATES to {@link ScheduleStore.add} and
+ *     persists a row daemon-OFF (a future daemon scheduler consumes the SAME table
+ *     as a separate reader). It stays REGISTERED-but-capability-gated: its
+ *     {@link AvailabilityCheck} hides it until a host advertises a schedule store
+ *     (`capabilities.scheduleStore === true`) so a host that has opted out of the
+ *     schedule domain does not surface it; invoking it without the store still
+ *     returns a typed `E_SCHEDULE_STORE_UNAVAILABLE` failure. `todo_*` are always
+ *     available daemon-OFF.
+ *
+ * ## Why a seam, not a hardcoded import (testing + Gate-11)
+ *
+ * The task ops are injected through the {@link TaskOps} seam, defaulting to the
+ * real `ops` functions. The unit test injects a FAKE store and asserts delegation
+ * + schema validation WITHOUT opening a real `tasks.db`. The tools are DEFINED
+ * here under `packages/core/src/tools` and CONSUME the task subsystem — they
+ * construct no new atomic primitive (Gate-11).
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — task CRUD is a local
+ * SQLite operation. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11950
+ * @see ../tasks/ops.js — `tasksAddOp` / `tasksListOp` (the ops this family delegates to)
+ * @see ./exec-code-agent-tool.js — the injectable-seam + capability-gated availability pattern mirrored here
+ */
+import type { TaskPriority, TaskStatus, TaskType } from '@cleocode/contracts';
+import type { AddTaskResult } from '../tasks/add.js';
+import type { ListTasksResult } from '../tasks/list.js';
+import { type AgentToolRegistry, type AvailabilityCheck } from './agent-registry.js';
+/**
+ * The task store operations the `todo_*` tools delegate to. Each member has the
+ * SAME signature as the corresponding `ops` function. Injectable so the unit test
+ * can supply a fake store; defaults to the real ops in production.
+ */
+export interface TaskOps {
+    /** Create a task (→ `tasksAddOp`). */
+    readonly add: (projectRoot: string, params: {
+        title: string;
+        description?: string;
+        parent?: string;
+        priority?: TaskPriority;
+        type?: TaskType;
+        acceptance?: string[];
+    }) => Promise<AddTaskResult>;
+    /** List tasks (→ `tasksListOp`). */
+    readonly list: (projectRoot: string, params: {
+        parent?: string;
+        status?: TaskStatus;
+        priority?: TaskPriority;
+        type?: TaskType;
+        limit?: number;
+    }) => Promise<ListTasksResult>;
+}
+/**
+ * The result `cron_schedule` returns: on success the minted `scheduleId` of the
+ * persisted row; on failure a typed, non-throwing error (e.g. when no schedule
+ * store backs the host). The tool is registered (catalog-stable) and gated on the
+ * `scheduleStore` host capability.
+ */
+export interface CronScheduleResult {
+    /** Whether a schedule row was registered. */
+    readonly ok: boolean;
+    /** The registered schedule's ID (present on success). */
+    readonly scheduleId?: string;
+    /** A stable code + message for why scheduling failed (present on failure). */
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+/**
+ * The schedule-store operation the `cron_schedule` tool delegates to. Injectable
+ * so the unit test can supply a fake store; defaults to the real Gate-3 accessor
+ * (`store/schedule-store.ts`) opened through the {@link openDualScopeDb} chokepoint.
+ */
+export interface ScheduleStore {
+    /**
+     * Register a recurring schedule and return its minted opaque handle.
+     *
+     * @param projectRoot - The project root whose `cleo.db` the schedule persists in.
+     * @param params - The cron expression + task template (title / description).
+     * @returns The minted `sched-<token>` handle.
+     */
+    readonly add: (projectRoot: string, params: {
+        cron: string;
+        title: string;
+        description?: string;
+    }) => Promise<string>;
+}
+/**
+ * Available only when the host advertises a schedule store
+ * (`capabilities.scheduleStore === true`). The schedule store now EXISTS (the
+ * `schedules` table + leased Gate-3 accessor, T11962 under T11679), so the gate is
+ * a host POLICY/capability switch — a host that has opted out of the schedule
+ * domain does not surface `cron_schedule`. Registration of a schedule row persists
+ * WITHOUT a live daemon (the chokepoint serializes the single in-process writer);
+ * a future daemon scheduler consumes the same table as a separate reader.
+ */
+export declare const scheduleStoreAvailable: AvailabilityCheck;
+/** Options for {@link registerScheduleAgentTools} — all injectable for testing. */
+export interface ScheduleAgentToolOptions {
+    /** The task ops seam. Defaults to the real `tasksAddOp` / `tasksListOp`. */
+    readonly tasks?: TaskOps;
+    /**
+     * The schedule-store seam `cron_schedule` delegates to. Defaults to the real
+     * Gate-3 accessor (`store/schedule-store.ts`). Injected in tests with a fake
+     * store so registration is asserted WITHOUT opening a real `cleo.db`.
+     */
+    readonly schedule?: ScheduleStore;
+    /**
+     * The project root threaded into every op (defaults to the resolved project
+     * root via {@link resolveOrCwd} — never a bare `process.cwd()` in core, T9584).
+     */
+    readonly projectRoot?: string;
+}
+/**
+ * Register the cron / todo agent-tool family into `registry`. Pure registration —
+ * no `tasks.db` is opened, no row is written here; all of that happens later
+ * inside each tool's `execute` through the injected (or lazily-resolved real)
+ * ops. Import-time side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable task ops / project root (for testing).
+ */
+export declare function registerScheduleAgentTools(registry: AgentToolRegistry, options?: ScheduleAgentToolOptions): void;
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerScheduleAgentTools} so a future scan-dir discovery (or the
+ * built-in aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export declare function registerAgentTools(registry: AgentToolRegistry): void;
+//# sourceMappingURL=schedule-agent-tools.d.ts.map

package/dist/tools/schedule-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-agent-tools.d.ts","sourceRoot":"","sources":["../../src/tools/schedule-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,KACE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,CACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KACE,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1D,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,iBACK,CAAC;AAE3C,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAwIN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEpE"}

package/dist/tools/schedule-agent-tools.js

@@ -0,0 +1,238 @@
+/**
+ * Cron / todo agent-tool family — `todo_add` / `todo_list` / `cron_schedule`
+ * (T11950 · M7 · epic T11456 · SG-TOOLS).
+ *
+ * Surfaces the EXISTING task store to the agent loop as `agent`-toolset tools that
+ * work daemon-OFF:
+ *
+ *   - **`todo_add`** — create a task, DELEGATING to the existing
+ *     {@link import('../tasks/ops.js')}'s `tasksAddOp` (the same path `cleo add`
+ *     uses). No new table, no new schema.
+ *   - **`todo_list`** — list tasks, DELEGATING to `tasksListOp` (the same path
+ *     `cleo list` uses).
+ *   - **`cron_schedule`** — register a recurring schedule. The schedule store now
+ *     exists (the `schedules` table + leased Gate-3 accessor `store/schedule-store.ts`,
+ *     T11962 under T11679), so this tool DELEGATES to {@link ScheduleStore.add} and
+ *     persists a row daemon-OFF (a future daemon scheduler consumes the SAME table
+ *     as a separate reader). It stays REGISTERED-but-capability-gated: its
+ *     {@link AvailabilityCheck} hides it until a host advertises a schedule store
+ *     (`capabilities.scheduleStore === true`) so a host that has opted out of the
+ *     schedule domain does not surface it; invoking it without the store still
+ *     returns a typed `E_SCHEDULE_STORE_UNAVAILABLE` failure. `todo_*` are always
+ *     available daemon-OFF.
+ *
+ * ## Why a seam, not a hardcoded import (testing + Gate-11)
+ *
+ * The task ops are injected through the {@link TaskOps} seam, defaulting to the
+ * real `ops` functions. The unit test injects a FAKE store and asserts delegation
+ * + schema validation WITHOUT opening a real `tasks.db`. The tools are DEFINED
+ * here under `packages/core/src/tools` and CONSUME the task subsystem — they
+ * construct no new atomic primitive (Gate-11).
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — task CRUD is a local
+ * SQLite operation. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11950
+ * @see ../tasks/ops.js — `tasksAddOp` / `tasksListOp` (the ops this family delegates to)
+ * @see ./exec-code-agent-tool.js — the injectable-seam + capability-gated availability pattern mirrored here
+ */
+import { z } from 'zod';
+import { resolveOrCwd } from '../paths.js';
+import { ALWAYS_AVAILABLE, } from './agent-registry.js';
+/**
+ * Available only when the host advertises a schedule store
+ * (`capabilities.scheduleStore === true`). The schedule store now EXISTS (the
+ * `schedules` table + leased Gate-3 accessor, T11962 under T11679), so the gate is
+ * a host POLICY/capability switch — a host that has opted out of the schedule
+ * domain does not surface `cron_schedule`. Registration of a schedule row persists
+ * WITHOUT a live daemon (the chokepoint serializes the single in-process writer);
+ * a future daemon scheduler consumes the same table as a separate reader.
+ */
+export const scheduleStoreAvailable = (ctx) => ctx.capabilities?.scheduleStore === true;
+/**
+ * Build the real task-ops seam by lazily importing the existing `ops` module.
+ * Lazy so this tool module stays import-time side-effect-free; the import happens
+ * only when the real ops are first needed.
+ *
+ * @returns The production {@link TaskOps}.
+ */
+async function realTaskOps() {
+    const { tasksAddOp, tasksListOp } = await import('../tasks/ops.js');
+    return {
+        add: (root, params) => tasksAddOp(root, params),
+        list: (root, params) => tasksListOp(root, params),
+    };
+}
+/**
+ * Build the real schedule-store seam by lazily importing the Gate-3 accessor.
+ * Lazy so this tool module stays import-time side-effect-free; the import (and the
+ * `cleo.db` open) happens only when `cron_schedule` first fires. The accessor
+ * routes through {@link openDualScopeDb} (the dual-scope chokepoint) — it NEVER
+ * opens a raw handle.
+ *
+ * @returns The production {@link ScheduleStore}.
+ */
+async function realScheduleStore() {
+    const { getScheduleNativeDb, addSchedule } = await import('../store/schedule-store.js');
+    return {
+        add: async (root, params) => {
+            const native = await getScheduleNativeDb(root);
+            return addSchedule(native, {
+                cronExpr: params.cron,
+                title: params.title,
+                description: params.description,
+            });
+        },
+    };
+}
+/**
+ * Register the cron / todo agent-tool family into `registry`. Pure registration —
+ * no `tasks.db` is opened, no row is written here; all of that happens later
+ * inside each tool's `execute` through the injected (or lazily-resolved real)
+ * ops. Import-time side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable task ops / project root (for testing).
+ */
+export function registerScheduleAgentTools(registry, options = {}) {
+    const projectRoot = resolveOrCwd(options.projectRoot);
+    // --- todo_add (→ tasksAddOp) ---------------------------------------------
+    registry.register({
+        name: 'todo_add',
+        // 'fs' — persists a row to the local tasks store (its strongest side-effect surface).
+        class: 'fs',
+        description: 'Add a task (todo) to the project task store. Delegates to the same path as `cleo add`. ' +
+            'Returns the created task. Always available daemon-OFF.',
+        toolset: 'agent',
+        stateless: false,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            title: z.string().describe('The task title.'),
+            description: z.string().optional().describe('A longer task description.'),
+            parent: z.string().optional().describe('Parent task/epic ID to nest this task under.'),
+            priority: z
+                .enum(['critical', 'high', 'medium', 'low'])
+                .optional()
+                .describe('Task priority (default medium).'),
+            acceptance: z
+                .array(z.string())
+                .optional()
+                .describe('Acceptance criteria — one entry per criterion.'),
+        }),
+        execute: async (rawArgs) => {
+            const tasks = options.tasks ?? (await realTaskOps());
+            const title = String(rawArgs.title);
+            const description = rawArgs.description === undefined ? undefined : String(rawArgs.description);
+            const parent = rawArgs.parent === undefined ? undefined : String(rawArgs.parent);
+            const priority = rawArgs.priority === 'critical' ||
+                rawArgs.priority === 'high' ||
+                rawArgs.priority === 'medium' ||
+                rawArgs.priority === 'low'
+                ? rawArgs.priority
+                : undefined;
+            const acceptance = Array.isArray(rawArgs.acceptance)
+                ? rawArgs.acceptance.map(String)
+                : undefined;
+            return tasks.add(projectRoot, {
+                title,
+                description,
+                parent,
+                priority,
+                type: 'task',
+                acceptance,
+            });
+        },
+    });
+    // --- todo_list (→ tasksListOp) -------------------------------------------
+    registry.register({
+        name: 'todo_list',
+        // 'search' — a local read-query of the tasks store.
+        class: 'search',
+        description: 'List tasks (todos) from the project task store, optionally filtered by parent / status / ' +
+            'priority. Delegates to the same path as `cleo list`. Always available daemon-OFF.',
+        toolset: 'agent',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            parent: z.string().optional().describe('Only list direct children of this task/epic ID.'),
+            status: z.string().optional().describe('Filter by status (e.g. pending, in_progress, done).'),
+            priority: z
+                .enum(['critical', 'high', 'medium', 'low'])
+                .optional()
+                .describe('Filter by priority.'),
+            limit: z.number().int().positive().optional().describe('Maximum number of tasks to return.'),
+        }),
+        execute: async (rawArgs) => {
+            const tasks = options.tasks ?? (await realTaskOps());
+            const parent = rawArgs.parent === undefined ? undefined : String(rawArgs.parent);
+            const status = rawArgs.status === undefined ? undefined : String(rawArgs.status);
+            const priority = rawArgs.priority === 'critical' ||
+                rawArgs.priority === 'high' ||
+                rawArgs.priority === 'medium' ||
+                rawArgs.priority === 'low'
+                ? rawArgs.priority
+                : undefined;
+            const limit = typeof rawArgs.limit === 'number' ? rawArgs.limit : undefined;
+            return tasks.list(projectRoot, { parent, status, priority, limit });
+        },
+    });
+    // --- cron_schedule (persists a row through the leased Gate-3 store) -------
+    registry.register({
+        name: 'cron_schedule',
+        // 'fs' — registering a schedule persists a store row.
+        class: 'fs',
+        description: 'Register a recurring schedule (cron expression → task template). Persists a row to the ' +
+            'project schedule store and returns its schedule ID. Gated on the host advertising a ' +
+            'schedule store; persists daemon-OFF (a daemon scheduler consumes the table separately).',
+        toolset: 'agent',
+        stateless: false,
+        available: scheduleStoreAvailable,
+        parameters: z.object({
+            cron: z.string().describe('A cron expression for the recurrence (e.g. "0 9 * * 1").'),
+            title: z.string().describe('The title of the task to create on each fire.'),
+            description: z
+                .string()
+                .optional()
+                .describe('A description for the task created on each fire.'),
+        }),
+        execute: async (rawArgs) => {
+            // Delegate to the schedule-store seam (the real Gate-3 accessor, or an
+            // injected fake in tests). The accessor routes through openDualScopeDb — no
+            // raw db open here. A store/IO failure is returned as a typed, non-throwing
+            // result so the agent loop sees a structured failure rather than an
+            // exception.
+            const cron = String(rawArgs.cron);
+            const title = String(rawArgs.title);
+            const description = rawArgs.description === undefined ? undefined : String(rawArgs.description);
+            try {
+                const schedule = options.schedule ?? (await realScheduleStore());
+                const scheduleId = await schedule.add(projectRoot, { cron, title, description });
+                return { ok: true, scheduleId };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'E_SCHEDULE_STORE_UNAVAILABLE',
+                        message: `failed to register schedule: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                };
+            }
+        },
+    });
+}
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerScheduleAgentTools} so a future scan-dir discovery (or the
+ * built-in aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export function registerAgentTools(registry) {
+    registerScheduleAgentTools(registry);
+}
+//# sourceMappingURL=schedule-agent-tools.js.map

package/dist/tools/schedule-agent-tools.js.map

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

package/dist/tools/skill-agent-tool.d.ts

@@ -0,0 +1,108 @@
+/**
+ * `run_skill` agent tool — bridge the EXISTING SKILL.md loader to the agent loop
+ * (T11949 · M7 · epic T11456 · SG-TOOLS; replaces the cancelled T11869).
+ *
+ * T11869 ("adopt Pi's SKILL.md loader") is CANCELLED: CLEO ALREADY owns a native
+ * skill loader + dispatch path ({@link import('../skills/discovery.js')}'s
+ * `parseFrontmatter` / `discoverSkill` / `findSkill`, plus
+ * {@link import('../skills/dispatch.js')}'s `dispatchExplicit`). This tool does
+ * NOT rebuild any of that. It surfaces the SUBSET of skills the model may invoke —
+ * those whose frontmatter marks `invocable: true` — to the loop as a single
+ * `run_skill` tool. `run_skill`:
+ *
+ *   - resolves a skill BY NAME via the EXISTING {@link findSkill} (the same
+ *     filesystem scan + name-mapping the CLI uses);
+ *   - REJECTS a skill whose frontmatter is not `invocable: true` (a typed, non-
+ *     throwing failure result) — only explicitly-invocable skills are runnable;
+ *   - dispatches the resolved skill through the EXISTING
+ *     {@link dispatchExplicit} path and returns the skill's instructions
+ *     (`SKILL.md` body) + dispatch metadata for the loop to act on.
+ *
+ * No new loader, no new parser, no new dispatch mechanism — pure consumption of
+ * the skills subsystem (Gate-11: DEFINED here under `packages/core/src/tools`,
+ * CONSUMES the skills path). The tier-0 skill-drift gate + skill-coverage map are
+ * untouched — this is a consumer of the loader, not a change to it.
+ *
+ * ## Availability (always-true, daemon-OFF)
+ *
+ * Skill discovery is a LOCAL filesystem scan — no credential, no network, no
+ * daemon. `run_skill` is therefore {@link ALWAYS_AVAILABLE}.
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — resolving + reading a
+ * SKILL.md is local I/O. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11949
+ * @see ../skills/discovery.js — `findSkill` (the existing loader this tool reuses)
+ * @see ../skills/dispatch.js — `dispatchExplicit` (the existing dispatch path)
+ */
+import type { Skill } from '../skills/types.js';
+import { type AgentToolRegistry } from './agent-registry.js';
+/**
+ * The skills-subsystem seam {@link registerSkillAgentTool} resolves + dispatches a
+ * skill through. Each member has the SAME signature as the corresponding existing
+ * function. Injectable so the unit test can supply a fake skill surface (no real
+ * SKILL.md on disk); defaults to the real `discovery` / `dispatch` functions.
+ */
+export interface SkillResolver {
+    /** Resolve a skill by name (→ `findSkill`). Returns `null` when unknown. */
+    readonly findSkill: (name: string, cwd?: string) => Skill | null;
+    /**
+     * Dispatch an explicit skill (→ `dispatchExplicit`). Returns the dispatch
+     * metadata, or `null` when the skill does not resolve.
+     */
+    readonly dispatchExplicit: (skillName: string, cwd?: string) => {
+        skill: string;
+        strategy: string;
+        confidence: number;
+        protocol?: string;
+    } | null;
+}
+/** The shape `run_skill` returns to the loop — resolution outcome + payload. */
+export interface RunSkillResult {
+    /** Whether an invocable skill resolved and dispatched. */
+    readonly ok: boolean;
+    /** The resolved skill's canonical directory name (present on success). */
+    readonly skill?: string;
+    /** The dispatched protocol, when the skill declares one. */
+    readonly protocol?: string;
+    /** The `SKILL.md` body the loop acts on (present on success). */
+    readonly instructions?: string;
+    /** A stable code + message for why resolution failed (present on failure). */
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+/** Options for {@link registerSkillAgentTool} — all injectable for testing. */
+export interface SkillAgentToolOptions {
+    /** The skills-subsystem seam. Defaults to the real discovery + dispatch functions. */
+    readonly resolver?: SkillResolver;
+    /**
+     * The cwd skill discovery scans from (defaults to the resolved project root via
+     * {@link resolveOrCwd} — never a bare `process.cwd()` in core, T9584).
+     */
+    readonly cwd?: string;
+}
+/**
+ * Register the `run_skill` tool into `registry`. Pure registration — no skill is
+ * resolved, no SKILL.md is read here; all of that happens later inside the tool's
+ * `execute` through the injected (or lazily-resolved real) seam. Import-time
+ * side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable resolver / cwd (for testing).
+ */
+export declare function registerSkillAgentTool(registry: AgentToolRegistry, options?: SkillAgentToolOptions): void;
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerSkillAgentTool} so a future scan-dir discovery (or the built-in
+ * aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export declare function registerAgentTools(registry: AgentToolRegistry): void;
+//# sourceMappingURL=skill-agent-tool.d.ts.map

package/dist/tools/skill-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-agent-tool.d.ts","sourceRoot":"","sources":["../../src/tools/skill-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,KACT;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACxF;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAgDN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEpE"}

package/dist/tools/skill-agent-tool.js

@@ -0,0 +1,135 @@
+/**
+ * `run_skill` agent tool — bridge the EXISTING SKILL.md loader to the agent loop
+ * (T11949 · M7 · epic T11456 · SG-TOOLS; replaces the cancelled T11869).
+ *
+ * T11869 ("adopt Pi's SKILL.md loader") is CANCELLED: CLEO ALREADY owns a native
+ * skill loader + dispatch path ({@link import('../skills/discovery.js')}'s
+ * `parseFrontmatter` / `discoverSkill` / `findSkill`, plus
+ * {@link import('../skills/dispatch.js')}'s `dispatchExplicit`). This tool does
+ * NOT rebuild any of that. It surfaces the SUBSET of skills the model may invoke —
+ * those whose frontmatter marks `invocable: true` — to the loop as a single
+ * `run_skill` tool. `run_skill`:
+ *
+ *   - resolves a skill BY NAME via the EXISTING {@link findSkill} (the same
+ *     filesystem scan + name-mapping the CLI uses);
+ *   - REJECTS a skill whose frontmatter is not `invocable: true` (a typed, non-
+ *     throwing failure result) — only explicitly-invocable skills are runnable;
+ *   - dispatches the resolved skill through the EXISTING
+ *     {@link dispatchExplicit} path and returns the skill's instructions
+ *     (`SKILL.md` body) + dispatch metadata for the loop to act on.
+ *
+ * No new loader, no new parser, no new dispatch mechanism — pure consumption of
+ * the skills subsystem (Gate-11: DEFINED here under `packages/core/src/tools`,
+ * CONSUMES the skills path). The tier-0 skill-drift gate + skill-coverage map are
+ * untouched — this is a consumer of the loader, not a change to it.
+ *
+ * ## Availability (always-true, daemon-OFF)
+ *
+ * Skill discovery is a LOCAL filesystem scan — no credential, no network, no
+ * daemon. `run_skill` is therefore {@link ALWAYS_AVAILABLE}.
+ *
+ * ## Gate-13
+ *
+ * No model/transport/provider client is constructed here — resolving + reading a
+ * SKILL.md is local I/O. There is no chokepoint concern.
+ *
+ * @epic T11456
+ * @task T11949
+ * @see ../skills/discovery.js — `findSkill` (the existing loader this tool reuses)
+ * @see ../skills/dispatch.js — `dispatchExplicit` (the existing dispatch path)
+ */
+import { z } from 'zod';
+import { resolveOrCwd } from '../paths.js';
+import { ALWAYS_AVAILABLE } from './agent-registry.js';
+/**
+ * Build the real skills-subsystem seam by lazily importing the existing
+ * `discovery` + `dispatch` modules. Lazy so this tool module is import-time
+ * side-effect-free (the skills modules run filesystem-touching telemetry on
+ * load); the import happens only when the real resolver is first needed.
+ *
+ * @returns The production {@link SkillResolver}.
+ */
+async function realResolver() {
+    const { findSkill } = await import('../skills/discovery.js');
+    const { dispatchExplicit } = await import('../skills/dispatch.js');
+    return {
+        findSkill,
+        dispatchExplicit: (skillName, cwd) => {
+            const result = dispatchExplicit(skillName, cwd);
+            if (result === null)
+                return null;
+            return {
+                skill: result.skill,
+                strategy: result.strategy,
+                confidence: result.confidence,
+                ...(result.protocol !== undefined ? { protocol: result.protocol } : {}),
+            };
+        },
+    };
+}
+/**
+ * Register the `run_skill` tool into `registry`. Pure registration — no skill is
+ * resolved, no SKILL.md is read here; all of that happens later inside the tool's
+ * `execute` through the injected (or lazily-resolved real) seam. Import-time
+ * side-effect-free.
+ *
+ * @param registry - The registry to populate.
+ * @param options - Injectable resolver / cwd (for testing).
+ */
+export function registerSkillAgentTool(registry, options = {}) {
+    const cwd = resolveOrCwd(options.cwd);
+    registry.register({
+        name: 'run_skill',
+        // 'shell' — invoking a skill is a procedure run (its strongest side-effect surface).
+        class: 'shell',
+        description: 'Resolve and run an invocable CLEO skill by name. Returns the skill instructions ' +
+            '(SKILL.md body) and dispatch metadata for the loop to act on. Only skills whose ' +
+            'frontmatter marks them invocable can be run.',
+        toolset: 'agent',
+        stateless: false,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            name: z.string().describe('The skill name to resolve and run (e.g. "ct-research-agent").'),
+        }),
+        execute: async (rawArgs) => {
+            const name = String(rawArgs.name);
+            const resolver = options.resolver ?? (await realResolver());
+            const skill = resolver.findSkill(name, cwd);
+            if (skill === null) {
+                return {
+                    ok: false,
+                    error: { code: 'E_SKILL_NOT_FOUND', message: `no skill named "${name}"` },
+                };
+            }
+            if (skill.frontmatter.invocable !== true) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'E_SKILL_NOT_INVOCABLE',
+                        message: `skill "${skill.dirName}" is not invocable (frontmatter.invocable !== true)`,
+                    },
+                };
+            }
+            // Dispatch through the EXISTING explicit-dispatch path (no new mechanism).
+            const dispatch = resolver.dispatchExplicit(name, cwd);
+            return {
+                ok: true,
+                skill: skill.dirName,
+                ...(dispatch?.protocol !== undefined ? { protocol: dispatch.protocol } : {}),
+                ...(skill.content !== undefined ? { instructions: skill.content } : {}),
+            };
+        },
+    });
+}
+/**
+ * Self-registration marker (AC1) — the identifier the
+ * {@link AgentToolRegistry.discover} bounded source scan greps for. Aliases
+ * {@link registerSkillAgentTool} so a future scan-dir discovery (or the built-in
+ * aggregator) can call it uniformly with the other agent-tool modules.
+ *
+ * @param registry - The registry to populate.
+ */
+export function registerAgentTools(registry) {
+    registerSkillAgentTool(registry);
+}
+//# sourceMappingURL=skill-agent-tool.js.map

package/dist/tools/skill-agent-tool.js.map

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