@mulmoclaude/todo-plugin 0.1.0

package/dist/Preview.vue.d.ts

@@ -0,0 +1,8 @@
+import { ToolResultComplete } from 'gui-chat-protocol/vue';
+import { TodoData } from './types';
+type __VLS_Props = {
+    result: ToolResultComplete<TodoData>;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/View.vue.d.ts

@@ -0,0 +1,12 @@
+import { ToolResultComplete } from 'gui-chat-protocol/vue';
+import { TodoData } from './types';
+type __VLS_Props = {
+    selectedResult: ToolResultComplete<TodoData>;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    updateResult: (result: ToolResultComplete<unknown, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdateResult?: ((result: ToolResultComplete<unknown, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/composables/index.d.ts

@@ -0,0 +1,2 @@
+export { useTodos } from './useTodos';
+export type { UseTodosHandle } from './useTodos';

package/dist/composables/useTodos.d.ts

@@ -0,0 +1,26 @@
+import { Ref } from 'vue';
+import { StatusColumn, TodoItem } from '../types';
+import { CreateInput, MoveInput, PatchInput } from '../handlers/items';
+export interface AddColumnInput {
+    label?: string;
+    isDone?: boolean;
+}
+export interface PatchColumnInput {
+    label?: string;
+    isDone?: boolean;
+}
+export interface UseTodosHandle {
+    items: Ref<TodoItem[]>;
+    columns: Ref<StatusColumn[]>;
+    error: Ref<string | null>;
+    refresh: () => Promise<boolean>;
+    createItem: (input: CreateInput) => Promise<boolean>;
+    patchItem: (id: string, input: PatchInput) => Promise<boolean>;
+    moveItem: (id: string, input: MoveInput) => Promise<boolean>;
+    deleteItem: (id: string) => Promise<boolean>;
+    addColumn: (input: AddColumnInput) => Promise<boolean>;
+    patchColumn: (id: string, input: PatchColumnInput) => Promise<boolean>;
+    deleteColumn: (id: string) => Promise<boolean>;
+    reorderColumns: (ids: string[]) => Promise<boolean>;
+}
+export declare function useTodos(initialItems?: TodoItem[], initialColumns?: StatusColumn[]): UseTodosHandle;

package/dist/composables.js

@@ -0,0 +1,101 @@
+import { n as useT } from "./lang-D72AIF9U.js";
+import { onMounted, onUnmounted, ref } from "vue";
+import { useRuntime } from "gui-chat-protocol/vue";
+//#region src/composables/useTodos.ts
+function isErr(value) {
+	return "error" in value;
+}
+function useTodos(initialItems = [], initialColumns = []) {
+	const t = useT();
+	const { dispatch, pubsub } = useRuntime();
+	const items = ref(initialItems);
+	const columns = ref(initialColumns);
+	const error = ref(null);
+	function applyResult(payload) {
+		if (Array.isArray(payload.data.items)) items.value = payload.data.items;
+		if (Array.isArray(payload.data.columns) && payload.data.columns.length > 0) columns.value = payload.data.columns;
+	}
+	async function call(args) {
+		error.value = null;
+		try {
+			const result = await dispatch(args);
+			if (isErr(result)) {
+				error.value = result.error;
+				return false;
+			}
+			applyResult(result);
+			return true;
+		} catch (err) {
+			error.value = err instanceof Error ? err.message : String(err);
+			return false;
+		}
+	}
+	async function refresh() {
+		error.value = null;
+		try {
+			const result = await dispatch({ kind: "listAll" });
+			if (isErr(result)) {
+				error.value = t.value.loadFailed;
+				return false;
+			}
+			applyResult(result);
+			return true;
+		} catch {
+			error.value = t.value.loadFailed;
+			return false;
+		}
+	}
+	let unsub;
+	onMounted(() => {
+		unsub = pubsub.subscribe("changed", () => {
+			refresh();
+		});
+		refresh();
+	});
+	onUnmounted(() => unsub?.());
+	return {
+		items,
+		columns,
+		error,
+		refresh,
+		createItem: (input) => call({
+			kind: "itemCreate",
+			...input
+		}),
+		patchItem: (id, input) => call({
+			kind: "itemPatch",
+			id,
+			...input
+		}),
+		moveItem: (id, input) => call({
+			kind: "itemMove",
+			id,
+			...input
+		}),
+		deleteItem: (id) => call({
+			kind: "itemDelete",
+			id
+		}),
+		addColumn: (input) => call({
+			kind: "columnsAdd",
+			...input
+		}),
+		patchColumn: (id, input) => call({
+			kind: "columnPatch",
+			id,
+			...input
+		}),
+		deleteColumn: (id) => call({
+			kind: "columnDelete",
+			id
+		}),
+		reorderColumns: (ids) => call({
+			kind: "columnsOrder",
+			ids
+		})
+	};
+}
+//#endregion
+export { useTodos };
+
+//# sourceMappingURL=composables.js.map

package/dist/composables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composables.js","names":[],"sources":["../src/composables/useTodos.ts"],"sourcesContent":["// Composable backing the kanban / file-explorer todo View. Wraps\n// `runtime.dispatch` calls in a small ref-managed surface so the\n// component code reads as `await todos.createItem({...})` rather than\n// `await runtime.dispatch({kind: \"itemCreate\", ...})` everywhere.\n//\n// Live sync: subscribes to the plugin's \"changed\" pubsub channel and\n// re-fetches on every server-side mutation, so a second tab editing\n// the same workspace's todos updates this component's view too.\n\nimport { onMounted, onUnmounted, ref, type Ref } from \"vue\";\nimport { useRuntime } from \"gui-chat-protocol/vue\";\nimport type { StatusColumn, TodoItem } from \"../types\";\nimport type { CreateInput, MoveInput, PatchInput } from \"../handlers/items\";\nimport { useT } from \"../lang\";\n\ninterface DispatchOk {\n  data: { items?: TodoItem[]; columns?: StatusColumn[] };\n  item?: TodoItem;\n}\n\ninterface DispatchErr {\n  error: string;\n  status?: number;\n}\n\ntype DispatchResponse = DispatchOk | DispatchErr;\n\nfunction isErr(value: DispatchResponse): value is DispatchErr {\n  return \"error\" in value;\n}\n\nexport interface AddColumnInput {\n  label?: string;\n  isDone?: boolean;\n}\n\nexport interface PatchColumnInput {\n  label?: string;\n  isDone?: boolean;\n}\n\nexport interface UseTodosHandle {\n  items: Ref<TodoItem[]>;\n  columns: Ref<StatusColumn[]>;\n  error: Ref<string | null>;\n  refresh: () => Promise<boolean>;\n  createItem: (input: CreateInput) => Promise<boolean>;\n  patchItem: (id: string, input: PatchInput) => Promise<boolean>;\n  moveItem: (id: string, input: MoveInput) => Promise<boolean>;\n  deleteItem: (id: string) => Promise<boolean>;\n  addColumn: (input: AddColumnInput) => Promise<boolean>;\n  patchColumn: (id: string, input: PatchColumnInput) => Promise<boolean>;\n  deleteColumn: (id: string) => Promise<boolean>;\n  reorderColumns: (ids: string[]) => Promise<boolean>;\n}\n\nexport function useTodos(initialItems: TodoItem[] = [], initialColumns: StatusColumn[] = []): UseTodosHandle {\n  const t = useT();\n  const { dispatch, pubsub } = useRuntime();\n  const items = ref<TodoItem[]>(initialItems);\n  const columns = ref<StatusColumn[]>(initialColumns);\n  const error = ref<string | null>(null);\n\n  function applyResult(payload: DispatchOk): void {\n    if (Array.isArray(payload.data.items)) items.value = payload.data.items;\n    if (Array.isArray(payload.data.columns) && payload.data.columns.length > 0) {\n      columns.value = payload.data.columns;\n    }\n  }\n\n  async function call<T extends object>(args: T): Promise<boolean> {\n    error.value = null;\n    try {\n      const result = (await dispatch<DispatchResponse>(args)) as DispatchResponse;\n      if (isErr(result)) {\n        error.value = result.error;\n        return false;\n      }\n      applyResult(result);\n      return true;\n    } catch (err) {\n      error.value = err instanceof Error ? err.message : String(err);\n      return false;\n    }\n  }\n\n  async function refresh(): Promise<boolean> {\n    error.value = null;\n    try {\n      const result = (await dispatch<DispatchResponse>({ kind: \"listAll\" })) as DispatchResponse;\n      if (isErr(result)) {\n        error.value = t.value.loadFailed;\n        return false;\n      }\n      applyResult(result);\n      return true;\n    } catch {\n      error.value = t.value.loadFailed;\n      return false;\n    }\n  }\n\n  let unsub: (() => void) | undefined;\n  onMounted(() => {\n    unsub = pubsub.subscribe(\"changed\", () => {\n      void refresh();\n    });\n    void refresh();\n  });\n  onUnmounted(() => unsub?.());\n\n  return {\n    items,\n    columns,\n    error,\n    refresh,\n    createItem: (input) => call({ kind: \"itemCreate\", ...input }),\n    patchItem: (id, input) => call({ kind: \"itemPatch\", id, ...input }),\n    moveItem: (id, input) => call({ kind: \"itemMove\", id, ...input }),\n    deleteItem: (id) => call({ kind: \"itemDelete\", id }),\n    addColumn: (input) => call({ kind: \"columnsAdd\", ...input }),\n    patchColumn: (id, input) => call({ kind: \"columnPatch\", id, ...input }),\n    deleteColumn: (id) => call({ kind: \"columnDelete\", id }),\n    reorderColumns: (ids) => call({ kind: \"columnsOrder\", ids }),\n  };\n}\n"],"mappings":";;;;AA2BA,SAAS,MAAM,OAA+C;CAC5D,OAAO,WAAW;AACpB;AA2BA,SAAgB,SAAS,eAA2B,CAAC,GAAG,iBAAiC,CAAC,GAAmB;CAC3G,MAAM,IAAI,KAAK;CACf,MAAM,EAAE,UAAU,WAAW,WAAW;CACxC,MAAM,QAAQ,IAAgB,YAAY;CAC1C,MAAM,UAAU,IAAoB,cAAc;CAClD,MAAM,QAAQ,IAAmB,IAAI;CAErC,SAAS,YAAY,SAA2B;EAC9C,IAAI,MAAM,QAAQ,QAAQ,KAAK,KAAK,GAAG,MAAM,QAAQ,QAAQ,KAAK;EAClE,IAAI,MAAM,QAAQ,QAAQ,KAAK,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS,GACvE,QAAQ,QAAQ,QAAQ,KAAK;CAEjC;CAEA,eAAe,KAAuB,MAA2B;EAC/D,MAAM,QAAQ;EACd,IAAI;GACF,MAAM,SAAU,MAAM,SAA2B,IAAI;GACrD,IAAI,MAAM,MAAM,GAAG;IACjB,MAAM,QAAQ,OAAO;IACrB,OAAO;GACT;GACA,YAAY,MAAM;GAClB,OAAO;EACT,SAAS,KAAK;GACZ,MAAM,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC7D,OAAO;EACT;CACF;CAEA,eAAe,UAA4B;EACzC,MAAM,QAAQ;EACd,IAAI;GACF,MAAM,SAAU,MAAM,SAA2B,EAAE,MAAM,UAAU,CAAC;GACpE,IAAI,MAAM,MAAM,GAAG;IACjB,MAAM,QAAQ,EAAE,MAAM;IACtB,OAAO;GACT;GACA,YAAY,MAAM;GAClB,OAAO;EACT,QAAQ;GACN,MAAM,QAAQ,EAAE,MAAM;GACtB,OAAO;EACT;CACF;CAEA,IAAI;CACJ,gBAAgB;EACd,QAAQ,OAAO,UAAU,iBAAiB;GACxC,QAAa;EACf,CAAC;EACD,QAAa;CACf,CAAC;CACD,kBAAkB,QAAQ,CAAC;CAE3B,OAAO;EACL;EACA;EACA;EACA;EACA,aAAa,UAAU,KAAK;GAAE,MAAM;GAAc,GAAG;EAAM,CAAC;EAC5D,YAAY,IAAI,UAAU,KAAK;GAAE,MAAM;GAAa;GAAI,GAAG;EAAM,CAAC;EAClE,WAAW,IAAI,UAAU,KAAK;GAAE,MAAM;GAAY;GAAI,GAAG;EAAM,CAAC;EAChE,aAAa,OAAO,KAAK;GAAE,MAAM;GAAc;EAAG,CAAC;EACnD,YAAY,UAAU,KAAK;GAAE,MAAM;GAAc,GAAG;EAAM,CAAC;EAC3D,cAAc,IAAI,UAAU,KAAK;GAAE,MAAM;GAAe;GAAI,GAAG;EAAM,CAAC;EACtE,eAAe,OAAO,KAAK;GAAE,MAAM;GAAgB;EAAG,CAAC;EACvD,iBAAiB,QAAQ,KAAK;GAAE,MAAM;GAAgB;EAAI,CAAC;CAC7D;AACF"}

package/dist/definition-mymex4HE.js

@@ -0,0 +1,55 @@
+//#region src/definition.ts
+var TOOL_DEFINITION = {
+	type: "function",
+	name: "manageTodoList",
+	prompt: "When users mention tasks, things to do, or ask about their todo list, use manageTodoList to help them track items.",
+	description: "Manage a todo list — show items, add, update, check/uncheck, or delete them. Items can optionally carry labels (tags) for categorisation; use labels to group related todos (e.g. 'Work', 'Groceries', 'Urgent') and filter the list at read time.",
+	parameters: {
+		type: "object",
+		properties: {
+			action: {
+				type: "string",
+				enum: [
+					"show",
+					"add",
+					"delete",
+					"update",
+					"check",
+					"uncheck",
+					"clear_completed",
+					"add_label",
+					"remove_label",
+					"list_labels"
+				],
+				description: "Action to perform on the todo list."
+			},
+			text: {
+				type: "string",
+				description: "For 'add': the todo item text. For 'delete', 'update', 'check', 'uncheck', 'add_label', 'remove_label': partial text to find the item."
+			},
+			newText: {
+				type: "string",
+				description: "For 'update' only: the replacement text."
+			},
+			note: {
+				type: "string",
+				description: "For 'add' or 'update': an optional note or extra detail for the item."
+			},
+			labels: {
+				type: "array",
+				items: { type: "string" },
+				description: "For 'add': labels to tag the new item with. For 'add_label' / 'remove_label': labels to add to / remove from the item matched by 'text'. Labels are case-insensitive for matching but stored with their original case."
+			},
+			filterLabels: {
+				type: "array",
+				items: { type: "string" },
+				description: "For 'show' only: return only items that have at least one of these labels (OR semantics, case-insensitive). Omit to show all items."
+			}
+		},
+		required: ["action"]
+	}
+};
+//#endregion
+export { TOOL_DEFINITION as t };
+
+//# sourceMappingURL=definition-mymex4HE.js.map

package/dist/definition-mymex4HE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-mymex4HE.js","names":[],"sources":["../src/definition.ts"],"sourcesContent":["// Tool schema for the todo plugin. Lives in its own module so both\n// the server entry (`index.ts`) and any future browser entry can\n// import it without dragging in handler code or its dependencies.\n//\n// `name: \"manageTodoList\" as const` is critical — it narrows the\n// literal type so `definePlugin`'s `StrictPluginResult<N>` can\n// require a matching named handler. It also matches the existing\n// built-in plugin's TOOL_DEFINITION.name exactly so during the PR1\n// → PR5 migration chain the runtime plugin and the static plugin\n// collide on the same name. The runtime registry's collision policy\n// (static wins) means this PR is no-op behaviour; PR5 deletes the\n// static side, after which the runtime plugin takes over as the real\n// `manageTodoList` handler.\n\nexport const TOOL_DEFINITION = {\n  type: \"function\" as const,\n  name: \"manageTodoList\" as const,\n  prompt: \"When users mention tasks, things to do, or ask about their todo list, use manageTodoList to help them track items.\",\n  description:\n    \"Manage a todo list — show items, add, update, check/uncheck, or delete them. Items can optionally carry labels (tags) for categorisation; use labels to group related todos (e.g. 'Work', 'Groceries', 'Urgent') and filter the list at read time.\",\n  parameters: {\n    type: \"object\" as const,\n    properties: {\n      action: {\n        type: \"string\",\n        enum: [\"show\", \"add\", \"delete\", \"update\", \"check\", \"uncheck\", \"clear_completed\", \"add_label\", \"remove_label\", \"list_labels\"],\n        description: \"Action to perform on the todo list.\",\n      },\n      text: {\n        type: \"string\",\n        description: \"For 'add': the todo item text. For 'delete', 'update', 'check', 'uncheck', 'add_label', 'remove_label': partial text to find the item.\",\n      },\n      newText: {\n        type: \"string\",\n        description: \"For 'update' only: the replacement text.\",\n      },\n      note: {\n        type: \"string\",\n        description: \"For 'add' or 'update': an optional note or extra detail for the item.\",\n      },\n      labels: {\n        type: \"array\",\n        items: { type: \"string\" },\n        description:\n          \"For 'add': labels to tag the new item with. For 'add_label' / 'remove_label': labels to add to / remove from the item matched by 'text'. Labels are case-insensitive for matching but stored with their original case.\",\n      },\n      filterLabels: {\n        type: \"array\",\n        items: { type: \"string\" },\n        description: \"For 'show' only: return only items that have at least one of these labels (OR semantics, case-insensitive). Omit to show all items.\",\n      },\n    },\n    required: [\"action\"],\n  },\n};\n"],"mappings":";AAcA,IAAa,kBAAkB;CAC7B,MAAM;CACN,MAAM;CACN,QAAQ;CACR,aACE;CACF,YAAY;EACV,MAAM;EACN,YAAY;GACV,QAAQ;IACN,MAAM;IACN,MAAM;KAAC;KAAQ;KAAO;KAAU;KAAU;KAAS;KAAW;KAAmB;KAAa;KAAgB;IAAa;IAC3H,aAAa;GACf;GACA,MAAM;IACJ,MAAM;IACN,aAAa;GACf;GACA,SAAS;IACP,MAAM;IACN,aAAa;GACf;GACA,MAAM;IACJ,MAAM;IACN,aAAa;GACf;GACA,QAAQ;IACN,MAAM;IACN,OAAO,EAAE,MAAM,SAAS;IACxB,aACE;GACJ;GACA,cAAc;IACZ,MAAM;IACN,OAAO,EAAE,MAAM,SAAS;IACxB,aAAa;GACf;EACF;EACA,UAAU,CAAC,QAAQ;CACrB;AACF"}

package/dist/definition.d.ts

@@ -0,0 +1,43 @@
+export declare const TOOL_DEFINITION: {
+    type: "function";
+    name: "manageTodoList";
+    prompt: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+            newText: {
+                type: string;
+                description: string;
+            };
+            note: {
+                type: string;
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            filterLabels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

package/dist/handlers/columns.d.ts

@@ -0,0 +1,31 @@
+import { TodoItem, StatusColumn } from '../types';
+export type { StatusColumn } from '../types';
+export declare const DEFAULT_COLUMNS: StatusColumn[];
+export type ColumnsActionResult = {
+    kind: "error";
+    status: number;
+    error: string;
+} | {
+    kind: "success";
+    columns: StatusColumn[];
+    items?: TodoItem[];
+};
+export declare function normalizeColumns(raw: unknown): StatusColumn[];
+export declare function doneColumnId(columns: StatusColumn[]): string;
+export declare function defaultStatusId(columns: StatusColumn[]): string;
+export declare function resyncDoneMembership(items: TodoItem[], newDoneId: string): {
+    items: TodoItem[];
+    changed: boolean;
+};
+export interface AddColumnInput {
+    label?: string;
+    isDone?: boolean;
+}
+export declare function handleAddColumn(columns: StatusColumn[], items: TodoItem[], input: AddColumnInput): ColumnsActionResult;
+export interface PatchColumnInput {
+    label?: string;
+    isDone?: boolean;
+}
+export declare function handlePatchColumn(columns: StatusColumn[], columnId: string, input: PatchColumnInput, items: TodoItem[]): ColumnsActionResult;
+export declare function handleDeleteColumn(columns: StatusColumn[], columnId: string, items: TodoItem[]): ColumnsActionResult;
+export declare function handleReorderColumns(columns: StatusColumn[], ids: string[]): ColumnsActionResult;

package/dist/handlers/items.d.ts

@@ -0,0 +1,36 @@
+import { TodoItem, StatusColumn } from '../types';
+export type ItemsActionResult = {
+    kind: "error";
+    status: number;
+    error: string;
+} | {
+    kind: "success";
+    items: TodoItem[];
+    item?: TodoItem;
+};
+export declare function migrateItems(rawItems: TodoItem[], columns: StatusColumn[]): TodoItem[];
+export interface CreateInput {
+    text?: string;
+    note?: string;
+    status?: string;
+    priority?: string;
+    dueDate?: string;
+    labels?: string[];
+}
+export declare function handleCreate(items: TodoItem[], columns: StatusColumn[], input: CreateInput): ItemsActionResult;
+export interface PatchInput {
+    text?: string;
+    note?: string | null;
+    status?: string;
+    priority?: string | null;
+    dueDate?: string | null;
+    labels?: string[];
+    completed?: boolean;
+}
+export declare function handlePatch(items: TodoItem[], columns: StatusColumn[], itemId: string, input: PatchInput): ItemsActionResult;
+export interface MoveInput {
+    status?: string;
+    position?: number;
+}
+export declare function handleMove(items: TodoItem[], columns: StatusColumn[], itemId: string, input: MoveInput): ItemsActionResult;
+export declare function handleDeleteItem(items: TodoItem[], itemId: string): ItemsActionResult;

package/dist/handlers/llm.d.ts

@@ -0,0 +1,30 @@
+import { TodoItem } from '../types';
+export interface TodosActionInput {
+    text?: string;
+    newText?: string;
+    note?: string;
+    labels?: string[];
+    filterLabels?: string[];
+}
+export type TodosActionResult = {
+    kind: "error";
+    status: number;
+    error: string;
+} | {
+    kind: "success";
+    items: TodoItem[];
+    message: string;
+    jsonData: Record<string, unknown>;
+};
+export declare function findTodoByText(items: TodoItem[], text: string): TodoItem | undefined;
+export declare function handleShow(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleAdd(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleDelete(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleUpdate(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleCheck(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleUncheck(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleClearCompleted(items: TodoItem[]): TodosActionResult;
+export declare function handleAddLabel(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleRemoveLabel(items: TodoItem[], input: TodosActionInput): TodosActionResult;
+export declare function handleListLabels(items: TodoItem[]): TodosActionResult;
+export declare function dispatchTodos(action: string, items: TodoItem[], input: TodosActionInput): TodosActionResult;

package/dist/handlers/priority-notifier.d.ts

@@ -0,0 +1,55 @@
+import { FileOps } from 'gui-chat-protocol';
+import { TodoItem } from '../types';
+export type NotifiablePriority = "urgent" | "high";
+export interface PriorityAlertPluginData {
+    kind: "todo-priority";
+    todoId: string;
+    /** Snapshot of the item's priority at the last publish / update.
+     *  Duplicated on the notifier entry so a future debugger reading
+     *  active.json can see which severity bucket the entry came from
+     *  without cross-referencing the plugin's ticket store. */
+    priority: NotifiablePriority;
+}
+export interface PriorityNotifierApi {
+    publish(input: {
+        severity: "urgent" | "nudge";
+        lifecycle: "action";
+        title: string;
+        body?: string;
+        navigateTarget: string;
+        pluginData: PriorityAlertPluginData;
+    }): Promise<{
+        id: string;
+    }>;
+    update(id: string, patch: {
+        severity?: "urgent" | "nudge";
+        title?: string;
+        body?: string;
+        pluginData?: PriorityAlertPluginData;
+    }): Promise<void>;
+    clear(id: string): Promise<void>;
+    /** Returns a truthy entry when the bell still exists and belongs
+     *  to this plugin, otherwise undefined. Used for ghost-bell
+     *  detection: a ticket whose `notificationId` no longer resolves
+     *  here means the bell was wiped (user dismissed via UI, crash
+     *  truncated active.json) and reconcile should re-publish rather
+     *  than `update` (which would silently no-op). */
+    get(id: string): Promise<unknown | undefined>;
+}
+interface ReconcileLog {
+    warn: (msg: string, data?: object) => void;
+}
+/** Reconcile the plugin's tickets and the host's bell entries with
+ *  the current item list. After this resolves:
+ *
+ *    - every notifiable item has a ticket and a live bell, with the
+ *      bell's severity / title / body matching the item's current
+ *      state;
+ *    - no ticket references a non-notifiable item.
+ *
+ *  Idempotent and tolerant of partial state. Drift is detected per-
+ *  ticket against the title / body / priority stored at last publish
+ *  or update; an item rename flows through `notifier.update` rather
+ *  than clear-then-publish, preserving the notificationId. */
+export declare function reconcilePriorityNotifications(items: TodoItem[], notifier: PriorityNotifierApi, files: FileOps, log?: ReconcileLog): Promise<void>;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { PluginRuntime } from 'gui-chat-protocol';
+import { TOOL_DEFINITION } from './definition';
+export { TOOL_DEFINITION };
+export type { TodoItem, TodoPriority, StatusColumn, TodoData } from './types';
+declare const _default: (runtime: PluginRuntime) => {
+    TOOL_DEFINITION: {
+        type: "function";
+        name: "manageTodoList";
+        prompt: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                action: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                newText: {
+                    type: string;
+                    description: string;
+                };
+                note: {
+                    type: string;
+                    description: string;
+                };
+                labels: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                filterLabels: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    manageTodoList(rawArgs: unknown): Promise<{
+        data: {
+            items: import('./types').TodoItem[];
+        };
+        message: string;
+        jsonData: Record<string, unknown>;
+        instructions: string;
+        error?: undefined;
+        status?: undefined;
+    } | {
+        error: string;
+        status: number;
+    } | {
+        item?: import('./types').TodoItem | undefined;
+        data: {
+            items: import('./types').TodoItem[];
+            columns: import('./types').StatusColumn[];
+        };
+        error?: undefined;
+        status?: undefined;
+    }>;
+};
+export default _default;