@perrylink/dsh-ticktick 0.1.2

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,iDAAiD;AACjD,eAAO,MAAM,eAAe,4BAA4B,CAAA;AAExD,uDAAuD;AACvD,eAAO,MAAM,4BAA4B,QAAS,CAAA;AAElD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,SAAU,CAAA;AAE/C,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,MAAM;IACrB,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAA;IACzB,iDAAiD;IACjD,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,4CAA4C;IAC5C,KAAK,EAAE,QAAQ,CAAA;CAChB;AAED,6DAA6D;AAC7D,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CA8B3B,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAkCxE"}

package/lib/types/domain.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool discovery and task normalization over the TickTick MCP tool list:
+ * names are resolved by pattern (pinnable per deployment) and results are
+ * normalized into a stable `{ id, title, done, projectId, dueDate,
+ * sortOrder }` view. Ported from the measured 0.1.0-era bridge; the wire
+ * facts (list order = descending sortOrder, inbox ids carry 'inbox') were
+ * verified against the live endpoint.
+ *
+ * @module dsh-ticktick/domain
+ */
+import type { McpCallResult, McpTool } from './mcp.js';
+import type { ToolPins } from './config.js';
+/** The resolved raw MCP tool names for the bridge operations. */
+export interface ToolResolver {
+    readonly projects: string;
+    readonly tasks: string;
+    readonly create: string;
+    readonly complete: string;
+    readonly remove: string;
+    readonly update: string;
+    readonly move: string;
+    /** `list_completed_tasks_by_date` (P2 completed view). */
+    readonly completed: string;
+    /** `search` or `search_task` (P2 full-text search). */
+    readonly search: string;
+    /** `get_task_by_id` (P2 read-after-write verification). */
+    readonly getTask: string;
+    /** `batch_add_tasks` (P2 batch create). */
+    readonly batchAdd: string;
+}
+/** Stable task view the widget and tools render. */
+export interface TicktickTask {
+    readonly id: string;
+    readonly title: string;
+    readonly done: boolean;
+    /** Owning project, required by TickTick's complete_task call. */
+    readonly projectId?: string;
+    /** ISO due date (TickTick date-time), absent when the task has none. */
+    readonly dueDate?: string;
+    /** TickTick sort order (list order is descending). */
+    readonly sortOrder?: number;
+}
+/** One project entry from `list_projects` (the virtual inbox included). */
+export interface TicktickProject {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Pick the raw tool names for the eleven operations, honoring pins.
+ * A pin that is not advertised falls back to pattern discovery, then to
+ * the first advertised tool, then to the pin itself (an empty resolver
+ * surfaces as a failed call, never a silent no-op).
+ * @param tools - the advertised tool list.
+ * @param pins - config-level name pins.
+ * @returns the resolved names.
+ */
+export declare function resolveTools(tools: readonly McpTool[], pins: ToolPins): ToolResolver;
+/** Parse the project entries out of a `list_projects` result (object or array payloads). */
+export declare function normalizeProjects(result: McpCallResult): readonly TicktickProject[];
+/** Normalize a tools/call result into the stable task view. */
+export declare function normalizeTasks(result: McpCallResult): readonly TicktickTask[];
+/**
+ * Whether a project id names the virtual inbox. Measured wire fact: inbox
+ * ids carry the literal 'inbox' (either exactly or inside an internal id),
+ * while regular projects are hex ids.
+ * @param projectId - the project id.
+ * @returns true for inbox ids.
+ */
+export declare function isInboxProject(projectId: string): boolean;
+//# sourceMappingURL=domain.d.ts.map

package/lib/types/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAcD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,YAAY,CAyBpF;AAMD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,eAAe,EAAE,CA2BnF;AA2CD,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,YAAY,EAAE,CAoC7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/lib/types/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `dsh-ticktick` — the TickTick (Dida365) task bridge for DeepSeek Harness.
+ *
+ * Host half: mounts the `ticktick` Remote service (status plus the seven
+ * task operations over the official TickTick MCP endpoint), registers the
+ * eight curated `ticktick_*` tools on the shared service, installs the
+ * `ticktick` settings namespace (token / token file / endpoint / protected
+ * ids) that the browser settings card edits, and announces the tool set in
+ * one system-prompt section.
+ *
+ * The token is re-read per request: the settings card's secret field wins,
+ * then the token file (`$DSH_HOME/.ticktick-token` by default). Writing the
+ * file activates the bridge without a config change.
+ *
+ * Function plugin — no default export (the Loader unwraps
+ * `exports.default ?? exports`).
+ *
+ * @module dsh-ticktick
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type Config, type ResolvedConfig } from './config.js';
+import { type TicktickSettings } from './wire.js';
+export declare const name = "ticktick";
+/** Hard services: the tool registry and the prompt assembly. `settings` is an optional child. */
+export declare const inject: string[];
+export { Config, resolveConfig, DEFAULT_MCP_URL, DEFAULT_TOOL_CALL_TIMEOUT_MS } from './config.js';
+export { TicktickService } from './service.js';
+export type { TicktickServiceConfig } from './service.js';
+export { buildTicktickTools } from './tools.js';
+export { McpStreamableClient, parseMcpMessage } from './mcp.js';
+export type { McpCallResult, McpClientFace, McpTool } from './mcp.js';
+export { isInboxProject, normalizeProjects, normalizeTasks, resolveTools } from './domain.js';
+export type { TicktickProject, TicktickTask, ToolResolver } from './domain.js';
+export type * from './wire.js';
+/** Settings namespace the browser card edits (paired by this exact key). */
+export declare const SETTINGS_NS = "ticktick";
+/** Schemastery schema for the settings namespace (the card renders this). */
+export declare const TicktickSettingsSchema: z<TicktickSettings>;
+/**
+ * Resolve the current Bearer token: the settings card's secret wins, then
+ * the DIDA365_TOKEN environment variable, then the configured token file.
+ * @param settings - current settings layer.
+ * @param resolved - loader config.
+ * @returns the token, or `null` when unconfigured.
+ */
+export declare function resolveToken(settings: TicktickSettings, resolved: ResolvedConfig): string | null;
+/**
+ * Mount the bridge: the settings namespace, the Remote service, the eight
+ * tools, and the usage announcement.
+ *
+ * @param ctx - context carrying tools + systemPrompt.
+ * @param config - raw loader config; defaults applied through {@link resolveConfig}.
+ */
+export declare function apply(ctx: Context, config: Config | undefined): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAkC,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAG9F,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEvE,eAAO,MAAM,IAAI,aAAa,CAAA;AAE9B,iGAAiG;AACjG,eAAO,MAAM,MAAM,UAA4B,CAAA;AAE/C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC7F,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC9E,mBAAmB,WAAW,CAAA;AAE9B,4EAA4E;AAC5E,eAAO,MAAM,WAAW,aAAuB,CAAA;AAE/C,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,gBAAgB,CAKrD,CAAA;AAOF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAUhG;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CnF"}

package/lib/types/mcp.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Minimal Model Context Protocol streamable-HTTP client for the TickTick
+ * endpoint: initialize, tools/list, and tools/call, accepting SSE or JSON
+ * responses, propagating the session id and the negotiated protocol version,
+ * honoring Retry-After on 429, and surfacing tool-level `isError` failures
+ * as thrown errors.
+ *
+ * @module dsh-ticktick/mcp
+ */
+/** One tool as advertised by `tools/list`. */
+export interface McpTool {
+    readonly name: string;
+    readonly description?: string;
+    readonly inputSchema?: {
+        readonly properties?: Readonly<Record<string, {
+            readonly type?: string;
+        }>>;
+        readonly required?: readonly string[];
+    };
+}
+/** Settled `tools/call` result (text blocks or structured content). */
+export interface McpCallResult {
+    readonly content?: readonly {
+        readonly type: string;
+        readonly text?: string;
+    }[];
+    readonly structuredContent?: unknown;
+}
+/** Structural face of the MCP client the service drives (test seam). */
+export interface McpClientFace {
+    initialize(): Promise<void>;
+    listTools(): Promise<readonly McpTool[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+}
+/**
+ * Parse one MCP response body: the last SSE `data:` payload, or plain JSON.
+ * @param body - raw response text.
+ * @returns the parsed message, or `undefined` for an empty body.
+ */
+export declare function parseMcpMessage(body: string): unknown | undefined;
+/** Fetch face, injectable for tests. */
+export type FetchFace = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Streamable-HTTP MCP client with Bearer auth. Requests are simple POSTs;
+ * notifications tolerate empty responses. A 429 response is retried once
+ * after the server's Retry-After delay (bounded to one minute).
+ */
+export declare class McpStreamableClient implements McpClientFace {
+    private readonly url;
+    private readonly token;
+    private readonly timeoutMs;
+    private readonly fetchFn;
+    private sessionId;
+    private protocolVersion;
+    private nextId;
+    /**
+     * @param url - MCP server URL (e.g. https://mcp.dida365.com).
+     * @param token - Bearer token (the TickTick API 口令).
+     * @param timeoutMs - per-request deadline in milliseconds.
+     * @param fetchFn - fetch implementation (defaults to global fetch).
+     */
+    constructor(url: string, token: string, timeoutMs: number, fetchFn?: FetchFace);
+    /** Perform the initialize handshake and send the initialized notification. */
+    initialize(): Promise<void>;
+    /** Fetch the server's tool list. */
+    listTools(): Promise<readonly McpTool[]>;
+    /**
+     * Invoke one tool. A tool-level failure (the MCP result flag `isError`)
+     * throws with the server's message — TickTick reports validation failures
+     * that way, not as JSON-RPC errors.
+     * @param name - the raw MCP tool name.
+     * @param args - the tool arguments object.
+     * @returns the settled result (text blocks or structured content).
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    /**
+     * Send one request and parse the response message: a 429 is retried once
+     * after Retry-After, any other non-2xx status throws, and an empty body
+     * (notification success) parses to `undefined`.
+     * @param request - JSON-RPC payload.
+     * @param carryHeaders - include session/protocol headers (false for initialize).
+     * @returns the parsed message, or `undefined` for an empty body.
+     */
+    private post;
+    /**
+     * Send one request, retrying once after Retry-After when the server
+     * answers 429.
+     * @param request - JSON-RPC payload.
+     * @param carryHeaders - include session/protocol headers (false for initialize).
+     * @returns the raw response (body not yet read).
+     */
+    private send;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/lib/types/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAA;QAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KACtC,CAAA;CACF;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,SAAS,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC9E;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAQjE;AAED,wCAAwC;AACxC,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE9E;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAYrD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,MAAM,CAAI;IAElB;;;;;OAKG;gBAEgB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,SAAiB;IAG7C,8EAA8E;IACxE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC,oCAAoC;IAC9B,SAAS,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAO9C;;;;;;;OAOG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBnF;;;;;;;OAOG;YACW,IAAI;IASlB;;;;;;OAMG;YACW,IAAI;CAqBnB"}

package/lib/types/service.d.ts

@@ -0,0 +1,160 @@
+/**
+ * The TickTick bridge's host service: drives one lazily bootstrapped MCP
+ * streamable-HTTP client against the TickTick endpoint and serves the eight
+ * panel/model operations under the `ticktick` Typert Remote namespace.
+ *
+ * Measured wire facts (live endpoint, 0.1.0 era) encoded here:
+ * - list order is descending `sortOrder`; reorder = move_task with the new
+ *   sortOrder (project tasks) or update_task (inbox tasks);
+ * - `update_task` crashes server-side for tasks inside regular projects
+ *   ("Expecting value: line 1 column 1") — project due dates take the
+ *   direct-update attempt first and fall back to the move-to-inbox →
+ *   update → move-back detour on that signature;
+ * - clearing a due date writes the epoch sentinel;
+ * - a project whose response fails server-side validation (historical
+ *   `repeatFrom: ''` data) is skipped and reported as a warning, never
+ *   silently dropped.
+ *
+ * @module dsh-ticktick/service
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { ToolPins } from './config.js';
+import { type TicktickProject } from './domain.js';
+import { type McpClientFace } from './mcp.js';
+import type { TicktickAddResult, TicktickOkResult, TicktickProbeResult, TicktickStatus, TicktickTasksResult } from './wire.js';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /** No Bearer token is resolvable from the token file or settings. */
+        'ticktick/no-token': Record<string, never>;
+        /** The operation named a task on the protected-id list. */
+        'ticktick/protected': {
+            readonly taskId: string;
+        };
+        /** A required argument is missing or malformed. */
+        'ticktick/bad-request': {
+            readonly field: string;
+        };
+        /** The MCP endpoint rejected or failed the tool call. */
+        'ticktick/tool-error': {
+            readonly tool: string;
+        };
+    }
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** TickTick task bridge service (this package). */
+        ticktick: TicktickService;
+    }
+}
+/** Runtime policy the service reads; the token getter re-reads at call time. */
+export interface TicktickServiceConfig {
+    /** Resolve the current Bearer token (file or settings); `null` = unconfigured. */
+    getToken(): string | null;
+    /** TickTick MCP endpoint. */
+    readonly mcpUrl: string;
+    /** Per-tools/call deadline in milliseconds. */
+    readonly toolCallTimeoutMs: number;
+    /** Task ids every mutating operation refuses. */
+    readonly protectedTaskIds: readonly string[];
+    /** Raw tool-name pins. */
+    readonly pins: ToolPins;
+}
+/** Default client factory: the real streamable-HTTP client. */
+export type ClientFactory = (url: string, token: string, timeoutMs: number) => McpClientFace;
+/**
+ * Host service for the TickTick bridge: status plus the seven task
+ * operations, exported over the `ticktick` Remote namespace (hand-written
+ * `./typert` manifest, no decorators).
+ */
+export declare class TicktickService extends TypertRemoteService {
+    private readonly config;
+    private readonly createClient;
+    /** The MCP client, lazily bootstrapped per token. */
+    private client;
+    /** Resolved tool names for the bootstrapped client. */
+    private resolver;
+    /** Token the current client was built for. */
+    private tokenAtBoot;
+    /** Most recent bridge error message; `null` when the last call settled. */
+    private lastError;
+    /** Whether the current token has produced a boot error (avoid hot loops). */
+    private bootFailed;
+    /**
+     * @param ctx - owning Cordis context.
+     * @param config - runtime policy (token getter, endpoint, timeout, guards, pins).
+     * @param createClient - test seam: client factory (defaults to the real MCP client).
+     */
+    constructor(ctx: Context, config: TicktickServiceConfig, createClient?: ClientFactory);
+    /** Connection and configuration facts (no handshake forced). */
+    status(): TicktickStatus;
+    /** Drop the bootstrapped client so the next call re-reads the token. */
+    reset(): void;
+    /**
+     * One-shot connectivity check over a throwaway client (the cached bridge
+     * client is untouched): initialize + tool listing against the current
+     * token. Feeds the settings card's "test connection" button.
+     */
+    probe(): Promise<TicktickProbeResult>;
+    /** List the user's projects (the virtual inbox included). */
+    projects(): Promise<{
+        projects: readonly TicktickProject[];
+    }>;
+    /**
+     * Aggregate undone tasks: one project when named, else every project.
+     * Projects whose response fails server-side validation are skipped and
+     * reported as warnings; each project's chunk stays sorted by descending
+     * sortOrder (the measured list order).
+     */
+    tasks(projectId?: string): Promise<TicktickTasksResult>;
+    /**
+     * Completed tasks within a window (P2): `list_completed_tasks_by_date`
+     * with a startDate `days` back (default 30) and an optional project.
+     */
+    completed(projectId?: string, days?: number): Promise<TicktickTasksResult>;
+    /** Full-text search over TickTick tasks (P2): `search` / `search_task`. */
+    search(query: string): Promise<TicktickTasksResult>;
+    /** Batch-create tasks (P2): `batch_add_tasks` over the OpenTask rows. */
+    batchAdd(tasks: readonly {
+        title: string;
+        projectId?: string;
+        dueDate?: string;
+    }[]): Promise<{
+        created: number;
+    }>;
+    /** Create one task; a named project places it there, otherwise the Inbox. */
+    add(title: string, projectId?: string, dueDate?: string): Promise<TicktickAddResult>;
+    /** Mark one task complete (TickTick needs both the project and the task id). */
+    complete(id: string, projectId: string): Promise<TicktickOkResult>;
+    /** Delete one task (TickTick needs both the project and the task id). */
+    remove(id: string, projectId: string): Promise<TicktickOkResult>;
+    /**
+     * Set (or clear) one task's due date. Inbox tasks update directly.
+     * Project tasks try the direct update first and fall back to the measured
+     * move-to-inbox → update → move-back detour when the server answers with
+     * its update_task crash signature.
+     */
+    setDue(id: string, projectId: string | undefined, dueDate?: string): Promise<TicktickOkResult>;
+    /**
+     * Move one task to a new position: inbox tasks take update_task with the
+     * new sortOrder; project tasks take a same-project move carrying the new
+     * sortOrder (the list order is descending sortOrder).
+     */
+    reorder(id: string, projectId: string | undefined, sortOrder: number): Promise<TicktickOkResult>;
+    /** Reject a mutating operation naming an id on the protected list. */
+    private assertNotProtected;
+    /** Validate the id pair required by complete/delete. */
+    private requireIds;
+    /**
+     * Lazily bootstrap the MCP client and tool resolver for the active token.
+     * A token change or a 401-triggered reset rebuilds the client.
+     */
+    private ensure;
+    /**
+     * One tools/call with error mapping: tool-level failures carry their raw
+     * tool name; a 401 signature resets the client once so the next call
+     * re-reads the token file.
+     */
+    private call;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/types/service.d.ts.map

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

package/lib/types/tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The curated model-facing tools of the TickTick bridge. All eight reuse the
+ * host service's business methods, so the model and the widget share one
+ * policy (protected ids, workarounds, error codes). Each `output.schema`
+ * returns a structured JSON value — the Code Mode `await tools.ticktick_*`
+ * surface derives from it — while `output.render` carries the human text.
+ *
+ * @module dsh-ticktick/tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import type { TicktickService } from './service.js';
+/**
+ * Build the eight tools bound to one service instance.
+ * @param service - the mounted TickTick service.
+ * @returns the registered tool definitions.
+ */
+export declare function buildTicktickTools(service: TicktickService): ReturnType<typeof defineTool>[];
+//# sourceMappingURL=tools.d.ts.map

package/lib/types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAgCnD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,EAAE,CA+R5F"}

package/lib/types/typert.host.d.ts

@@ -0,0 +1,216 @@
+/**
+ * The hand-written Typert HOST manifest for `dsh-ticktick`, exported as
+ * `./typert` so the harness's typert-loader registers the `ticktick`
+ * invocations automatically when this plugin mounts. Same shape as a
+ * generator output (validated by the loader): package face, empty model and
+ * schemas, and the canonical invocation list shared with the client Remote
+ * contribution (`src/wire.ts`).
+ *
+ * @module dsh-ticktick/typert
+ */
+/** Host Typert manifest (validated by `@deepseek-ai/dsh-typert-loader`). */
+export declare const TYPERT: Readonly<{
+    package: "dsh-ticktick";
+    face: "host";
+    schemas: readonly never[];
+    invocations: readonly (Readonly<{
+        readonly id: "dsh-ticktick#ticktick/status";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "status";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/projects";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "projects";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/tasks";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "tasks";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/add";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "add";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/complete";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "complete";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/remove";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "remove";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/setDue";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "setDue";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/reorder";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "reorder";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/completed";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "completed";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/search";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "search";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly import("@deepseek-ai/dsh-typert-protocol").InvocationParameterDescriptor[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/batchAdd";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "batchAdd";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-ticktick/types#BatchAddTasks";
+                schema: import("zod").ZodArray<import("zod").ZodObject<{
+                    title: import("zod").ZodString;
+                    projectId: import("zod").ZodOptional<import("zod").ZodString>;
+                    dueDate: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+            }>;
+        }>[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: "dsh-ticktick#ticktick/probe";
+        readonly service: "ticktick";
+        readonly namespace: "ticktick";
+        readonly method: "probe";
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: import("@deepseek-ai/dsh-typert-protocol").TypertCodec;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }>)[];
+    model: Readonly<{
+        services: readonly never[];
+        events: readonly never[];
+        objects: readonly never[];
+    }>;
+}>;
+//# sourceMappingURL=typert.host.d.ts.map

package/lib/types/typert.host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typert.host.d.ts","sourceRoot":"","sources":["../../src/typert.host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,4EAA4E;AAC5E,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUjB,CAAA"}