@cline/core 0.0.75 → 0.0.76

package/dist/tasks/agenda-task-tool.d.ts

@@ -0,0 +1,94 @@
+import type { AgentTool, GatewayModelSelection, ITelemetryService } from "@cline/shared";
+import { z } from "zod";
+import type { AgendaTaskManagerApi } from "./agenda-task-api";
+export declare const TodoTaskInputSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        update: "update";
+        create: "create";
+        list: "list";
+        get: "get";
+    }>;
+    task_id: z.ZodOptional<z.ZodString>;
+    expected_revision: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodEnum<{
+        handoff: "handoff";
+        suggestion: "suggestion";
+        "follow-up": "follow-up";
+        todo: "todo";
+        idea: "idea";
+        reminder: "reminder";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        workspace: "workspace";
+        global: "global";
+    }>>;
+    workspace_root: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resource_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>>;
+    assignee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model_selection: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider_id: z.ZodString;
+        model_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        plan: "plan";
+        act: "act";
+        yolo: "yolo";
+    }>>>;
+    system_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    max_iterations: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    timeout_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    available_at: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    automation_eligible: z.ZodOptional<z.ZodBoolean>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+        cancelled: "cancelled";
+        approved: "approved";
+        pending_approval: "pending_approval";
+        expired: "expired";
+    }>>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        handoff: "handoff";
+        suggestion: "suggestion";
+        "follow-up": "follow-up";
+        todo: "todo";
+        idea: "idea";
+        reminder: "reminder";
+    }>>>;
+    priorities: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TodoTaskInput = z.infer<typeof TodoTaskInputSchema>;
+export interface AgendaTaskSessionDefaults {
+    workspaceRoot?: string;
+    cwd?: string;
+    modelSelection?: GatewayModelSelection;
+    originTaskId?: string;
+}
+export interface TodoTaskOperationOptions {
+    manager: AgendaTaskManagerApi;
+    telemetry?: ITelemetryService;
+    resolveSessionDefaults: (sessionId: string) => Promise<AgendaTaskSessionDefaults | undefined>;
+}
+export type TodoTaskResult = {
+    ok: true;
+    operation: TodoTaskInput["operation"];
+    task?: Awaited<ReturnType<AgendaTaskManagerApi["getTask"]>>;
+    tasks?: Awaited<ReturnType<AgendaTaskManagerApi["listTasks"]>>;
+} | {
+    ok: false;
+    operation?: TodoTaskInput["operation"];
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/** Execute a Todo operation while preserving Agenda scope and authority rules. */
+export declare function executeTodoTaskOperation(options: TodoTaskOperationOptions, rawInput: unknown, context: Parameters<AgentTool<TodoTaskInput, TodoTaskResult>["execute"]>[1]): Promise<TodoTaskResult>;

package/dist/tasks/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./agenda-task-api";
+export * from "./agenda-task-manager";
+export * from "./agenda-task-tool";
+export * from "./specs/task-spec-file-store";
+export * from "./specs/task-spec-parser";
+export * from "./store/sqlite-task-store";
+export * from "./store/task-schema";
+export * from "./task-location";
+export * from "./task-tool";

package/dist/tasks/specs/task-spec-file-store.d.ts

@@ -0,0 +1,38 @@
+import type { AgendaTaskScope } from "@cline/shared";
+import { type AgendaTaskSpec, type AgendaTaskSpecParseResult, type AgendaTaskSpecWriteInput } from "./task-spec-parser";
+export interface AgendaTaskSpecFileStoreOptions {
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+    taskSpecsDir?: string;
+}
+export interface WriteAgendaTaskSpecOptions {
+    /** Existing path or a filename under this store's directory. */
+    specPath?: string;
+    /** Refuse to replace a file whose parsed content changed since it was read. */
+    expectedContentHash?: string;
+    /** Atomically fail instead of replacing an existing target. */
+    createOnly?: boolean;
+}
+export type WrittenAgendaTaskSpec = AgendaTaskSpec & {
+    taskId: string;
+};
+export declare class AgendaTaskSpecFileStore {
+    readonly specsDir: string;
+    readonly scope: AgendaTaskScope;
+    readonly workspaceRoot?: string;
+    constructor(options: AgendaTaskSpecFileStoreOptions);
+    listSpecPaths(): string[];
+    listSpecs(): AgendaTaskSpecParseResult[];
+    readSpec(specPath: string): AgendaTaskSpecParseResult;
+    writeSpec(input: AgendaTaskSpecWriteInput, options?: WriteAgendaTaskSpecOptions): WrittenAgendaTaskSpec;
+    /** Resolve the canonical target before a manager reserves it in SQLite. */
+    resolveWritePath(taskId: string, specPath?: string): string;
+    /** Validate the root both before and after creating missing directories. */
+    ensureSpecsDir(): void;
+    deleteSpec(specPath: string, options?: {
+        expectedContentHash?: string;
+    }): boolean;
+    private assertExpectedContent;
+    private assertSpecsDirSafe;
+    private resolveSpecPath;
+}

package/dist/tasks/specs/task-spec-parser.d.ts

@@ -0,0 +1,65 @@
+import type { AgendaTaskActor, AgendaTaskCreateInput, AgendaTaskPriority, AgendaTaskScope, AgendaTaskType, GatewayModelSelection } from "@cline/shared";
+export interface AgendaTaskSpec {
+    taskId?: string;
+    type: AgendaTaskType;
+    title: string;
+    description?: string;
+    instructions: string;
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+    cwd?: string;
+    resourcePaths: string[];
+    priority: AgendaTaskPriority;
+    assignee?: string;
+    modelSelection?: GatewayModelSelection;
+    mode?: "act" | "plan" | "yolo";
+    systemPrompt?: string;
+    maxIterations?: number;
+    timeoutSeconds?: number;
+    availableAt?: string;
+    expiresAt: string;
+    automationEligible: boolean;
+    specPath: string;
+    contentHash: string;
+}
+export interface ParseAgendaTaskSpecInput {
+    specPath: string;
+    raw: string;
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+}
+export type AgendaTaskSpecParseResult = {
+    ok: true;
+    specPath: string;
+    contentHash: string;
+    spec: AgendaTaskSpec;
+} | {
+    ok: false;
+    specPath: string;
+    contentHash: string;
+    error: string;
+};
+export interface AgendaTaskSpecWriteInput {
+    taskId: string;
+    type: AgendaTaskType;
+    title: string;
+    description?: string;
+    instructions: string;
+    cwd?: string;
+    resourcePaths?: string[];
+    priority?: AgendaTaskPriority;
+    assignee?: string;
+    modelSelection?: GatewayModelSelection;
+    mode?: "act" | "plan" | "yolo";
+    systemPrompt?: string;
+    maxIterations?: number;
+    timeoutSeconds?: number;
+    availableAt?: string;
+    expiresAt: string;
+    automationEligible?: boolean;
+}
+/** Parse one task Markdown file without throwing for invalid user content. */
+export declare function parseAgendaTaskSpec(input: ParseAgendaTaskSpecInput): AgendaTaskSpecParseResult;
+/** Render the canonical, user-editable task spec representation. */
+export declare function serializeAgendaTaskSpec(input: AgendaTaskSpecWriteInput): string;
+export declare function agendaTaskSpecToCreateInput(spec: AgendaTaskSpec, createdBy: AgendaTaskActor): AgendaTaskCreateInput;

package/dist/tasks/store/sqlite-task-store.d.ts

@@ -0,0 +1,73 @@
+import type { AgendaAutomationPolicy, AgendaTaskActor, AgendaTaskCreateInput, AgendaTaskListInput, AgendaTaskRecord, AgendaTaskRunRecord, AgendaTaskRunStatus, AgendaTaskStatus, AgendaTaskUpdateInput } from "@cline/shared";
+export interface SqliteAgendaTaskStoreOptions {
+    dbPath?: string;
+}
+export declare class AgendaTaskRevisionConflictError extends Error {
+    readonly current: AgendaTaskRecord;
+    constructor(current: AgendaTaskRecord);
+}
+export interface AgendaTaskStatePatch {
+    status?: AgendaTaskStatus;
+    approvedRevision?: number | null;
+    currentRunId?: string | null;
+    lastRunId?: string | null;
+    lastSessionId?: string | null;
+    specPath?: string | null;
+    error?: string | null;
+    completedAt?: string | null;
+    archivedAt?: string | null;
+    updatedBy?: AgendaTaskActor;
+}
+export interface CreateAgendaTaskRunInput {
+    taskId: string;
+    taskRevision: number;
+    status?: AgendaTaskRunStatus;
+    claimToken?: string;
+    claimUntilAt?: string;
+    requestedByClientId?: string;
+    sessionId?: string;
+    claimedAt?: string;
+}
+export interface UpdateAgendaTaskRunInput {
+    status?: AgendaTaskRunStatus;
+    claimToken?: string | null;
+    claimUntilAt?: string | null;
+    requestedByClientId?: string | null;
+    sessionId?: string | null;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    resultSummary?: string | null;
+    error?: string | null;
+}
+export interface ListAgendaTaskRunsInput {
+    taskId?: string;
+    status?: AgendaTaskRunStatus | AgendaTaskRunStatus[];
+    sessionId?: string;
+    limit?: number;
+}
+export declare class SqliteAgendaTaskStore {
+    private readonly db;
+    constructor(options?: SqliteAgendaTaskStoreOptions);
+    close(): void;
+    createTask(input: AgendaTaskCreateInput): AgendaTaskRecord;
+    getTask(taskId: string): AgendaTaskRecord | undefined;
+    getTaskBySpecPath(specPath: string): AgendaTaskRecord | undefined;
+    /**
+     * Return every workspace that has ever owned a task. Archived rows are
+     * intentionally included so the Hub can restore file watchers after a restart.
+     */
+    listWorkspaceRoots(): string[];
+    listTasks(input?: AgendaTaskListInput): AgendaTaskRecord[];
+    /** Apply user-editable fields, increment revision, and revoke old approval. */
+    updateTask(input: AgendaTaskUpdateInput): AgendaTaskRecord | undefined;
+    /** Mutate manager-owned lifecycle fields without changing the task revision. */
+    updateTaskState(taskId: string, patch: AgendaTaskStatePatch, expectedRevision?: number): AgendaTaskRecord | undefined;
+    deleteTask(taskId: string): boolean;
+    createRun(input: CreateAgendaTaskRunInput): AgendaTaskRunRecord;
+    getRun(runId: string): AgendaTaskRunRecord | undefined;
+    updateRun(runId: string, input: UpdateAgendaTaskRunInput): AgendaTaskRunRecord | undefined;
+    listRuns(input?: ListAgendaTaskRunsInput): AgendaTaskRunRecord[];
+    getAutomationPolicy(scopeKey?: string): AgendaAutomationPolicy;
+    listAutomationPolicies(): AgendaAutomationPolicy[];
+    setAutomationPolicy(input: Omit<AgendaAutomationPolicy, "updatedAt">): AgendaAutomationPolicy;
+}

package/dist/tasks/store/task-schema.d.ts

@@ -0,0 +1,2 @@
+import type { SqliteDb } from "@cline/shared/db";
+export declare function ensureAgendaTaskSchema(db: SqliteDb): void;

package/dist/tasks/task-location.d.ts

@@ -0,0 +1,14 @@
+import type { AgendaTaskScope } from "@cline/shared";
+export interface AgendaTaskLocationInput {
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+    cwd?: string;
+    resourcePaths?: readonly string[];
+}
+export interface NormalizedAgendaTaskLocation {
+    workspaceRoot?: string;
+    cwd?: string;
+    resourcePaths: string[];
+}
+/** Enforce the queue's global/chat and workspace filesystem boundaries. */
+export declare function normalizeAgendaTaskLocation(input: AgendaTaskLocationInput): NormalizedAgendaTaskLocation;

package/dist/tasks/task-tool.d.ts

@@ -0,0 +1,134 @@
+import type { AgentExtension, AgentTool } from "@cline/shared";
+import { z } from "zod";
+import { type ScheduledTaskResult, type ScheduleTaskOperationOptions } from "../cron/service/schedule-tool";
+import { type TodoTaskOperationOptions, type TodoTaskResult } from "./agenda-task-tool";
+export declare const TASKS_TOOL_NAME = "tasks";
+export declare const TASKS_SYSTEM_PROMPT_RULE = "# Tasks\n\nUse the `tasks` tool to manage durable Todo items and explicitly requested scheduled agent work.\n\n- Use `kind: \"todo\"` for meaningful follow-ups, handoffs, ideas, reminders, and other work that should remain visible after this session. This includes useful work you identify and suggest proactively. Agent-created Todos require user approval; Todos created directly by the user are approved immediately. Todo `available_at` controls availability in the list; it never schedules execution.\n- Use `kind: \"scheduled\"` only when the user explicitly asks Cline to execute work once at a future time or on a recurrence. One-time schedules require an exact future ISO 8601 `run_at` with an offset or Z. Recurring schedules require a five-field `cron_pattern` and may include an IANA `timezone`.\n- \"Remind me\" is ambiguous: ask whether the user wants a reviewed Todo note or an agent to execute work at that time when intent is unclear.\n- Never create both kinds for the same request unless the user explicitly requests both. Check existing items before creating a likely duplicate.\n- Todo instructions and scheduled prompts must be self-contained. Include the goal, constraints, relevant project context, and expected output.\n- Never approve or start a Todo yourself. Only mutate schedules from an interactive user session, and only update, pause, resume, delete, or run one immediately when the user asks.";
+export declare const TasksToolInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operation: z.ZodEnum<{
+        update: "update";
+        create: "create";
+        list: "list";
+        get: "get";
+    }>;
+    task_id: z.ZodOptional<z.ZodString>;
+    expected_revision: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodEnum<{
+        handoff: "handoff";
+        suggestion: "suggestion";
+        "follow-up": "follow-up";
+        todo: "todo";
+        idea: "idea";
+        reminder: "reminder";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        workspace: "workspace";
+        global: "global";
+    }>>;
+    workspace_root: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resource_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>>;
+    assignee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model_selection: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider_id: z.ZodString;
+        model_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        plan: "plan";
+        act: "act";
+        yolo: "yolo";
+    }>>>;
+    system_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    max_iterations: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    timeout_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    available_at: z.ZodOptional<z.ZodString>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    automation_eligible: z.ZodOptional<z.ZodBoolean>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        in_progress: "in_progress";
+        cancelled: "cancelled";
+        approved: "approved";
+        pending_approval: "pending_approval";
+        expired: "expired";
+    }>>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        handoff: "handoff";
+        suggestion: "suggestion";
+        "follow-up": "follow-up";
+        todo: "todo";
+        idea: "idea";
+        reminder: "reminder";
+    }>>>;
+    priorities: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"todo">;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodEnum<{
+        update: "update";
+        create: "create";
+        list: "list";
+        pause: "pause";
+        resume: "resume";
+        get: "get";
+        delete: "delete";
+        run_now: "run_now";
+    }>;
+    schedule_id: z.ZodOptional<z.ZodString>;
+    schedule_type: z.ZodOptional<z.ZodEnum<{
+        once: "once";
+        recurring: "recurring";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    run_at: z.ZodOptional<z.ZodString>;
+    cron_pattern: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        plan: "plan";
+        act: "act";
+        yolo: "yolo";
+    }>>;
+    system_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    max_iterations: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    timeout_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    max_parallel: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model_selection: z.ZodOptional<z.ZodObject<{
+        provider_id: z.ZodString;
+        model_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"scheduled">;
+}, z.core.$strict>], "kind">;
+export type TasksToolInput = z.infer<typeof TasksToolInputSchema>;
+export type TasksToolResult = ({
+    kind: "todo";
+} & TodoTaskResult) | ({
+    kind: "scheduled";
+} & ScheduledTaskResult) | {
+    ok: false;
+    kind?: TasksToolInput["kind"];
+    error: {
+        code: "invalid_tasks_input";
+        message: string;
+    };
+};
+export interface CreateTasksToolOptions {
+    todo: TodoTaskOperationOptions;
+    scheduled: ScheduleTaskOperationOptions;
+}
+/**
+ * One agent-facing task tool backed by distinct Todo and schedule domains.
+ * The discriminator selects the domain; each handler retains its own storage,
+ * authorization, scope, and execution lifecycle.
+ */
+export declare function createTasksTool(options: CreateTasksToolOptions): AgentTool<TasksToolInput, TasksToolResult>;
+/** Adds selection and safety guidance only when the unified tool is enabled. */
+export declare function createTasksPromptExtension(): AgentExtension;

package/dist/types/provider-settings.d.ts

@@ -4,6 +4,14 @@ export type { ProviderClient, ProviderConfig, ProviderProtocol, ProviderSettings
 export declare const ProviderSettingsSchemaTyped: z.ZodType<ProviderSettings>;
 export { toProviderConfig };
 export type ProviderTokenSource = "manual" | "oauth" | "migration";
+export declare const VoiceInputSettingsSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    modelId: z.ZodString;
+}, z.core.$strip>;
+export type VoiceInputSettings = z.infer<typeof VoiceInputSettingsSchema>;
+export interface StoredProviderModes {
+    voiceInput?: VoiceInputSettings;
+}
 export interface StoredProviderSettingsEntry {
     settings: ProviderSettings;
     updatedAt: string;
@@ -12,8 +20,10 @@ export interface StoredProviderSettingsEntry {
 export interface StoredProviderSettings {
     version: 1;
     lastUsedProvider?: string;
+    modes: StoredProviderModes;
     providers: Record<string, StoredProviderSettingsEntry>;
 }
+export declare const StoredProviderModesSchema: z.ZodType<StoredProviderModes>;
 export declare const StoredProviderSettingsEntrySchema: z.ZodType<StoredProviderSettingsEntry>;
 export declare const StoredProviderSettingsSchema: z.ZodType<StoredProviderSettings>;
 export declare function emptyStoredProviderSettings(): StoredProviderSettings;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@cline/core",
 	"description": "Cline Core SDK for Node Runtime",
-	"version": "0.0.75",
+	"version": "0.0.76",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/cline/cline",
@@ -49,9 +49,9 @@
 		"test:watch": "vitest --config vitest.config.ts"
 	},
 	"dependencies": {
-		"@cline/agents": "0.0.75",
-		"@cline/shared": "0.0.75",
-		"@cline/llms": "0.0.75",
+		"@cline/agents": "0.0.76",
+		"@cline/shared": "0.0.76",
+		"@cline/llms": "0.0.76",
 		"@modelcontextprotocol/sdk": "^1.29.0",
 		"@opentelemetry/api": "^1.9.0",
 		"@opentelemetry/api-logs": "^0.214.0",