@try-works/dsh-righthand 0.1.3 → 0.1.5

package/README.md

@@ -25,6 +25,8 @@ dsh --profile <profile> --patch ./cordis.patch.yml
 | Tool | Family | Backing service |
 |---|---|---|
 | `rh_store_put` / `rh_store_get` / `rh_store_delete` / `rh_store_list` | store | `ctx.storageDomain` (domain KV) |
+| `rh_task_create` / `rh_task_list` / `rh_task_next` / `rh_task_update` / `rh_task_delete` | tasks | `ctx.storageDomain` (typed `righthand_tasks` domain; state machine open → done/failed) |
+| `rh_text_summarise` / `rh_text_extract` / `rh_text_classify` / `rh_text_translate` | text | `ctx.llm` (one model call per verb) |
 | `rh_credential_describe` / `rh_credential_set` / `rh_credential_unset` | secrets | `ctx.credentials` (values never echoed) |
 | `rh_settings_get` / `rh_settings_set` | secrets | `ctx.settings` (namespace `righthand`) |
 | `rh_run` | exec | `ctx.subprocess` (collect mode, bounded output) |
@@ -137,10 +139,10 @@ so the agent cannot deploy or destroy without the gate.
 
 ## Service availability
 
-The store family needs `ctx.storageDomain`, which the web profile provides
-(`storage` + `storage-json` + `storage-domain` rows). In a profile without
-it — e.g. the headless bundle — the store tools stay dormant and the other
-seven tools still register; the plugin never fails the boot.
+The store and task families need `ctx.storageDomain`, which the web profile
+provides (`storage` + `storage-json` + `storage-domain` rows). In a profile
+without it — e.g. the headless bundle — those nine tools stay dormant and the
+other seven tools still register; the plugin never fails the boot.
 
 ## Development
 

package/lib/index.d.ts

@@ -14,6 +14,8 @@
  * Modules (each individually mountable via `export * as ...`):
  * - store-tools:     rh_store_put/get/delete/list over ctx.storageDomain
  * - secrets-tools:   rh_credential_describe/set/unset + rh_settings_get/set
+ * - task-tools:      rh_task_create/list/next/update/delete over ctx.storageDomain
+ * - text-tools:      rh_text_summarise/extract/classify/translate over ctx.llm
  * - exec-tools:      rh_run / rh_run_bg over ctx.subprocess + ctx.jobs
  * - guard-tools:     tools/pre-execute policy (config.rules)
  * - skills:          the packaged dsh-righthand skill (ctx.skills)
@@ -25,6 +27,8 @@ import * as storeTools from './store-tools.ts';
 import * as secretsTools from './secrets-tools.ts';
 import * as execTools from './exec-tools.ts';
 import * as guardTools from './guard-tools.ts';
+import * as taskTools from './task-tools.ts';
+import * as textTools from './text-tools.ts';
 import * as righthandSkills from './skills.ts';
 import type { GuardRule } from './guard-tools.ts';
 export declare const name = "dsh-righthand";
@@ -42,7 +46,7 @@ export interface RighthandConfig {
  * instead of failing the whole plugin.
  */
 export declare function apply(ctx: Context, config?: RighthandConfig): void;
-export { storeTools, secretsTools, execTools, guardTools, righthandSkills };
+export { storeTools, secretsTools, execTools, taskTools, textTools, guardTools, righthandSkills };
 export { SKILL_NAME, SKILL_DESCRIPTION, skillDirectory, skillBody } from './skills.ts';
 export type { GuardRule } from './guard-tools.ts';
 export { guardFactsFor } from './guard-tools.ts';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,eAAe,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC,iFAAiF;AACjF,eAAO,MAAM,MAAM,EAAE,MAAM,EAAO,CAAA;AAElC,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,eAAoB,GAAG,IAAI,CAMtE;AAGD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACtF,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC,iFAAiF;AACjF,eAAO,MAAM,MAAM,EAAE,MAAM,EAAO,CAAA;AAElC,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,eAAoB,GAAG,IAAI,CAQtE;AAGD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACtF,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/index.js

@@ -14,6 +14,8 @@
  * Modules (each individually mountable via `export * as ...`):
  * - store-tools:     rh_store_put/get/delete/list over ctx.storageDomain
  * - secrets-tools:   rh_credential_describe/set/unset + rh_settings_get/set
+ * - task-tools:      rh_task_create/list/next/update/delete over ctx.storageDomain
+ * - text-tools:      rh_text_summarise/extract/classify/translate over ctx.llm
  * - exec-tools:      rh_run / rh_run_bg over ctx.subprocess + ctx.jobs
  * - guard-tools:     tools/pre-execute policy (config.rules)
  * - skills:          the packaged dsh-righthand skill (ctx.skills)
@@ -24,6 +26,8 @@ import * as storeTools from "./store-tools.js";
 import * as secretsTools from "./secrets-tools.js";
 import * as execTools from "./exec-tools.js";
 import * as guardTools from "./guard-tools.js";
+import * as taskTools from "./task-tools.js";
+import * as textTools from "./text-tools.js";
 import * as righthandSkills from "./skills.js";
 export const name = 'dsh-righthand';
 /** The combined plugin needs no services itself; each child waits on its own. */
@@ -38,11 +42,13 @@ export function apply(ctx, config = {}) {
     ctx.plugin(storeTools);
     ctx.plugin(secretsTools);
     ctx.plugin(execTools);
+    ctx.plugin(taskTools);
+    ctx.plugin(textTools);
     ctx.plugin(guardTools, { rules: config.rules ?? [] });
     ctx.plugin(righthandSkills);
 }
 // Individual modules stay importable for selective mounting.
-export { storeTools, secretsTools, execTools, guardTools, righthandSkills };
+export { storeTools, secretsTools, execTools, taskTools, textTools, guardTools, righthandSkills };
 export { SKILL_NAME, SKILL_DESCRIPTION, skillDirectory, skillBody } from "./skills.js";
 export { guardFactsFor } from "./guard-tools.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,eAAe,MAAM,aAAa,CAAA;AAG9C,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AAEnC,iFAAiF;AACjF,MAAM,CAAC,MAAM,MAAM,GAAa,EAAE,CAAA;AAQlC;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAA0B,EAAE;IAC9D,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACtB,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACxB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACrB,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAA;IACrD,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7B,CAAC;AAED,6DAA6D;AAC7D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,eAAe,MAAM,aAAa,CAAA;AAG9C,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AAEnC,iFAAiF;AACjF,MAAM,CAAC,MAAM,MAAM,GAAa,EAAE,CAAA;AAQlC;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAA0B,EAAE;IAC9D,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACtB,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACxB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACrB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACrB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACrB,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAA;IACrD,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7B,CAAC;AAED,6DAA6D;AAC7D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA;AACjG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/task-tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * task-tools — rh_task_* over ctx.storageDomain.
+ * A typed task board with a state machine: open → done | failed.
+ * `rh_task_next` is the queue discipline — the oldest open task is what to
+ * work on now. Descriptions carry the rule that a task's failure is recorded
+ * like an answer: a run that could not happen is news the owner needs.
+ * @module dsh-righthand/task-tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Domain } from '@deepseek-ai/dsh-storage-domain';
+export declare const name = "righthand-task";
+export declare const inject: string[];
+export type TaskState = 'open' | 'done' | 'failed';
+export interface Task {
+    id: string;
+    title: string;
+    detail: string;
+    due: string;
+    state: TaskState;
+    result: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Domain spec: the typed task table. */
+export declare const taskDomain: {
+    name: string;
+    version: number;
+    tables: {
+        tasks: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, {
+            id: string;
+            title: string;
+            detail: string;
+            due: string;
+            state: "failed" | "open" | "done";
+            result: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+    };
+};
+export type TaskDomain = Domain<typeof taskDomain>;
+/** Open the task domain and register the model-facing tools. */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=task-tools.d.ts.map

package/lib/task-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../src/task-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAG7D,eAAO,MAAM,IAAI,mBAAmB,CAAA;AACpC,eAAO,MAAM,MAAM,UAA6B,CAAA;AAEhD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAElD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,yCAAyC;AACzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;CAerB,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAA;AAMlD,gEAAgE;AAChE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAgLxC"}

package/lib/task-tools.js

@@ -0,0 +1,212 @@
+/**
+ * task-tools — rh_task_* over ctx.storageDomain.
+ * A typed task board with a state machine: open → done | failed.
+ * `rh_task_next` is the queue discipline — the oldest open task is what to
+ * work on now. Descriptions carry the rule that a task's failure is recorded
+ * like an answer: a run that could not happen is news the owner needs.
+ * @module dsh-righthand/task-tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain';
+import { z } from 'zod';
+export const name = 'righthand-task';
+export const inject = ['tools', 'storageDomain'];
+/** Domain spec: the typed task table. */
+export const taskDomain = defineDomain({
+    name: 'righthand_tasks',
+    version: 1,
+    tables: {
+        tasks: domainTable(z.object({
+            id: z.string(),
+            title: z.string(),
+            detail: z.string(),
+            due: z.string(),
+            state: z.enum(['open', 'done', 'failed']),
+            result: z.string(),
+            createdAt: z.string(),
+            updatedAt: z.string(),
+        })),
+    },
+});
+function newId() {
+    return 't-' + Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 6);
+}
+/** Open the task domain and register the model-facing tools. */
+export function apply(ctx) {
+    let domain;
+    let ready;
+    ctx.effect(() => {
+        ready = (async () => {
+            domain = await ctx.storageDomain.open(taskDomain);
+        })();
+        return () => { };
+    });
+    const ensure = async () => {
+        if (domain === undefined) {
+            await ready;
+        }
+        if (domain === undefined)
+            throw new Error('righthand tasks are not open (storageDomain not mounted)');
+        return domain;
+    };
+    const all = async () => {
+        const d = await ensure();
+        return [...d.table('tasks').entries()].map(([, t]) => t);
+    };
+    ctx.tools.register(defineTool({
+        name: 'rh_task_create',
+        description: 'Add a task with a title, optional detail and due date. Returns the created task with a generated id and state open. A task the agent cannot run is still recorded — its failure is delivered like an answer.',
+        parameters: {
+            title: { type: 'string', required: true, description: 'What the task is, e.g. "deploy vision-worker".' },
+            detail: { type: 'string', description: 'Optional longer description of what done means.' },
+            due: { type: 'string', description: 'Optional due date, YYYY-MM-DD.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    id: { type: 'string', required: true },
+                    title: { type: 'string', required: true },
+                    state: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: 'task ' + value.id + ' created: ' + value.title + ' (open)' }],
+        },
+        async execute(args) {
+            const d = await ensure();
+            const now = new Date().toISOString();
+            const task = {
+                id: newId(),
+                title: args.title.trim(),
+                detail: args.detail ?? '',
+                due: args.due ?? '',
+                state: 'open',
+                result: '',
+                createdAt: now,
+                updatedAt: now,
+            };
+            if (task.title === '')
+                throw new Error('a task needs a title');
+            await d.table('tasks').put(task.id, task);
+            return { id: task.id, title: task.title, state: task.state };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_task_list',
+        description: 'List tasks, open ones first (oldest open first). Optionally filter by state.',
+        parameters: {
+            state: { type: 'string', description: 'Filter: open | done | failed. Omit for all tasks.' },
+        },
+        output: {
+            schema: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        id: { type: 'string', required: true },
+                        title: { type: 'string', required: true },
+                        state: { type: 'string', required: true },
+                        due: { type: 'string' },
+                    },
+                },
+            },
+            render: (_args, tasks) => [{ type: 'text', text: tasks.length === 0 ? '(no tasks)' : tasks.map((t) => '[' + t.state + '] ' + t.title).join(' / ') }],
+        },
+        async execute(args) {
+            const tasks = await all();
+            const wanted = args.state ?? null;
+            const filtered = wanted ? tasks.filter(t => t.state === wanted) : tasks;
+            const rank = { open: 0, done: 1, failed: 2 };
+            filtered.sort((a, b) => (rank[a.state] - rank[b.state]) || a.createdAt.localeCompare(b.createdAt));
+            return filtered.map(t => ({ id: t.id, title: t.title, state: t.state, ...t.due ? { due: t.due } : {} }));
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_task_next',
+        description: 'The next open task — what to work on now. Oldest open task first. Returns found: false when nothing is open.',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    found: { type: 'boolean', required: true },
+                    id: { type: 'string' },
+                    title: { type: 'string' },
+                    detail: { type: 'string' },
+                    due: { type: 'string' },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.found ? 'next: ' + value.title : '(nothing open)' }],
+        },
+        async execute() {
+            const tasks = await all();
+            const open = tasks.filter(t => t.state === 'open').sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+            const t = open[0];
+            if (t === undefined)
+                return { found: false };
+            return { found: true, id: t.id, title: t.title, ...t.detail ? { detail: t.detail } : {}, ...t.due ? { due: t.due } : {} };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_task_update',
+        description: 'Change a task: its state (open | done | failed) and/or its result. A failed task should carry its result — what was tried and what went wrong — so the record says what happened, not just that something did.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'The task id from rh_task_create or rh_task_list.' },
+            state: { type: 'string', description: 'New state: open | done | failed.' },
+            result: { type: 'string', description: 'What happened — the outcome, or the failure reason.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    found: { type: 'boolean', required: true },
+                    id: { type: 'string', required: true },
+                    state: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.found ? 'task ' + value.id + ' -> ' + value.state : 'task ' + value.id + ' not found' }],
+        },
+        async execute(args) {
+            const d = await ensure();
+            const task = d.table('tasks').get(args.id);
+            if (task === undefined)
+                return { found: false, id: args.id, state: 'open' };
+            const next = {
+                ...task,
+                ...args.state !== undefined ? { state: args.state } : {},
+                ...args.result !== undefined ? { result: args.result } : {},
+                updatedAt: new Date().toISOString(),
+            };
+            await d.table('tasks').put(args.id, next);
+            return { found: true, id: args.id, state: next.state };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_task_delete',
+        description: 'Remove a task by id. Returns whether it existed.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'The task id to remove.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    id: { type: 'string', required: true },
+                    existed: { type: 'boolean', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: 'deleted ' + value.id + ': ' + value.existed }],
+        },
+        async execute(args) {
+            const d = await ensure();
+            const existed = await d.table('tasks').delete(args.id);
+            return { id: args.id, existed };
+        },
+    }));
+}
+//# sourceMappingURL=task-tools.js.map

package/lib/task-tools.js.map

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

package/lib/text-tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * text-tools — rh_text_* over ctx.llm.
+ * Language work at one call per verb: summarise, extract-to-JSON,
+ * classify, translate. Same prompt discipline as the digest summarizer:
+ * roles stay roles, caps are deliberate, each call's failure is contained
+ * in that call (the other tools are unaffected).
+ * @module dsh-righthand/text-tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "righthand-text";
+export declare const inject: string[];
+export interface TextConfig {
+    /** LLM route; defaults match the harness default model. */
+    provider?: string;
+    model?: string;
+}
+export declare function apply(ctx: Context, config?: TextConfig): void;
+//# sourceMappingURL=text-tools.d.ts.map

package/lib/text-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tools.d.ts","sourceRoot":"","sources":["../src/text-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,eAAO,MAAM,IAAI,mBAAmB,CAAA;AACpC,eAAO,MAAM,MAAM,UAAmB,CAAA;AAEtC,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA8CD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,UAAe,GAAG,IAAI,CAoGjE"}

package/lib/text-tools.js

@@ -0,0 +1,158 @@
+/**
+ * text-tools — rh_text_* over ctx.llm.
+ * Language work at one call per verb: summarise, extract-to-JSON,
+ * classify, translate. Same prompt discipline as the digest summarizer:
+ * roles stay roles, caps are deliberate, each call's failure is contained
+ * in that call (the other tools are unaffected).
+ * @module dsh-righthand/text-tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { BlockAssembler, createUserMessage, deepFreeze } from '@deepseek-ai/dsh-llm';
+export const name = 'righthand-text';
+export const inject = ['tools', 'llm'];
+const DEFAULTS = { provider: 'deepseek-official', model: 'deepseek-v4-flash' };
+/** One LLM call, text in, text out. Returns the assembled text or throws. */
+async function ask(ctx, cfg, system, user, maxTokens, signal) {
+    const options = deepFreeze({
+        provider: cfg.provider,
+        model: cfg.model,
+        messages: [createUserMessage({
+                content: [{ type: 'text', text: user }],
+                source: { kind: 'plugin', plugin: 'righthand-text' },
+            })],
+        system,
+        maxTokens,
+        purpose: 'compaction',
+        signal,
+    });
+    const assembler = new BlockAssembler();
+    for await (const chunk of ctx.llm.stream(options))
+        assembler.push(chunk);
+    if (assembler.finish.kind !== 'stop')
+        throw new Error('text model call did not stop cleanly: ' + JSON.stringify(assembler.finish.kind));
+    const text = assembler.blocks().filter((b) => b.type === 'text').map((b) => b.text).join(' ').trim();
+    if (text === '')
+        throw new Error('text model call produced no text');
+    return text;
+}
+/** Extract the outermost {...} JSON object from a model reply. */
+function parseJsonWindow(text) {
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start < 0 || end <= start)
+        throw new Error('model output was not JSON');
+    return JSON.parse(text.slice(start, end + 1));
+}
+/** Summarise: plain prose, no JSON. */
+const SUMMARISE_SYSTEM = 'You summarise text. Return ONLY the summary itself - a few sentences, plain prose, no JSON, no Markdown headers, no quotes around it. Preserve the language of the input.';
+/** Extract: JSON matching a caller schema. */
+const EXTRACT_SYSTEM = 'You extract structured data from text. Return ONLY one JSON object matching the caller schema exactly - no prose, no Markdown, no code fences.';
+/** Classify: one label plus confidence, as JSON. */
+const CLASSIFY_SYSTEM = 'You classify text. Return ONLY one JSON object with exactly two keys: label (one of the given labels, verbatim) and confidence (a number from 0 to 1). No prose, no Markdown.';
+/** Translate: preserve formatting, plain prose. */
+const TRANSLATE_SYSTEM = 'You translate text. Return ONLY the translation - plain prose, no JSON, no quotes around it, preserving paragraph breaks and any Markdown or code the input contains.';
+export function apply(ctx, config = {}) {
+    const cfg = { ...DEFAULTS, ...config };
+    ctx.tools.register(defineTool({
+        name: 'rh_text_summarise',
+        description: 'Summarise text into a few sentences. One model call per invocation; the result is new prose, not extracted sentences.',
+        parameters: {
+            text: { type: 'string', required: true, description: 'The text to summarise (max ~30000 characters).' },
+            sentences: { type: 'integer', description: 'Target length in sentences (default 3).' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    summary: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.summary }],
+        },
+        async execute(args, exec) {
+            const n = args.sentences ?? 3;
+            const summary = await ask(ctx, cfg, SUMMARISE_SYSTEM, 'Summarise this in about ' + n + ' sentences:\n\n' + args.text, 600, exec.signal);
+            return { summary };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_text_extract',
+        description: 'Turn text into JSON matching a schema you give. The schema is a JSON Schema object; the model returns one object conforming to it, or the call fails cleanly.',
+        parameters: {
+            text: { type: 'string', required: true, description: 'The text to extract from.' },
+            schema: { type: 'json', required: true, description: 'JSON Schema the result must match, e.g. { "type": "object", "properties": { "name": { "type": "string" } }, "required": ["name"] }.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    extracted: { type: 'json', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: JSON.stringify(value.extracted) }],
+        },
+        async execute(args, exec) {
+            const framed = 'Schema:\n' + JSON.stringify(args.schema) + '\n\nText:\n' + args.text;
+            const raw = await ask(ctx, cfg, EXTRACT_SYSTEM, framed, 800, exec.signal);
+            return { extracted: parseJsonWindow(raw) };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_text_classify',
+        description: 'Sort text into one of the labels you give, with a confidence score from 0 to 1. The label returned is one of yours, verbatim.',
+        parameters: {
+            text: { type: 'string', required: true, description: 'The text to classify.' },
+            labels: { type: 'array', required: true, items: { type: 'string' }, description: 'The candidate labels, e.g. ["bug", "feature request", "question"].' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    label: { type: 'string', required: true },
+                    confidence: { type: 'number', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.label + ' (' + value.confidence + ')' }],
+        },
+        async execute(args, exec) {
+            if (args.labels.length === 0)
+                throw new Error('classify needs at least one label');
+            const framed = 'Labels: ' + JSON.stringify(args.labels) + '\n\nText:\n' + args.text;
+            const raw = await ask(ctx, cfg, CLASSIFY_SYSTEM, framed, 100, exec.signal);
+            const parsed = parseJsonWindow(raw);
+            if (typeof parsed.label !== 'string' || !args.labels.includes(parsed.label))
+                throw new Error('model returned a label outside the given set');
+            const confidence = Number(parsed.confidence);
+            if (!Number.isFinite(confidence) || confidence < 0 || confidence > 1)
+                throw new Error('model returned an invalid confidence');
+            return { label: parsed.label, confidence };
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'rh_text_translate',
+        description: 'Translate text into another language, preserving formatting (paragraph breaks, Markdown, code).',
+        parameters: {
+            text: { type: 'string', required: true, description: 'The text to translate.' },
+            language: { type: 'string', required: true, description: 'The target language, e.g. "Spanish", "zh-CN", "Japanese".' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    translation: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.translation }],
+        },
+        async execute(args, exec) {
+            const framed = 'Translate the following into ' + args.language + ':\n\n' + args.text;
+            const translation = await ask(ctx, cfg, TRANSLATE_SYSTEM, framed, 800, exec.signal);
+            return { translation };
+        },
+    }));
+}
+//# sourceMappingURL=text-tools.js.map

package/lib/text-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tools.js","sourceRoot":"","sources":["../src/text-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGpF,MAAM,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAA;AACpC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAQtC,MAAM,QAAQ,GAAyB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA;AAEpG,6EAA6E;AAC7E,KAAK,UAAU,GAAG,CAAC,GAAY,EAAE,GAAyB,EAAE,MAAc,EAAE,IAAY,EAAE,SAAiB,EAAE,MAAmB;IAC9H,MAAM,OAAO,GAAoB,UAAU,CAAC;QAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;gBAC3B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBACvC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE;aACrD,CAAC,CAAC;QACH,MAAM;QACN,SAAS;QACT,OAAO,EAAE,YAAY;QACrB,MAAM;KACP,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,IAAI,cAAc,EAAE,CAAA;IACtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxE,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACvI,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9G,IAAI,IAAI,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,kEAAkE;AAClE,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,uCAAuC;AACvC,MAAM,gBAAgB,GAAG,2KAA2K,CAAA;AAEpM,8CAA8C;AAC9C,MAAM,cAAc,GAAG,gJAAgJ,CAAA;AAEvK,oDAAoD;AACpD,MAAM,eAAe,GAAG,+KAA+K,CAAA;AAEvM,mDAAmD;AACnD,MAAM,gBAAgB,GAAG,uKAAuK,CAAA;AAEhM,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAqB,EAAE;IACzD,MAAM,GAAG,GAAyB,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAA;IAC5D,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,uHAAuH;QACpI,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gDAAgD,EAAE;YACvG,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yCAAyC,EAAE;SACvF;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC5C;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SAClE;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA;YAC7B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,0BAA0B,GAAG,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACvI,OAAO,EAAE,OAAO,EAAE,CAAA;QACpB,CAAC;KACF,CAAC,CAAC,CAAA;IACH,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,+JAA+J;QAC5K,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClF,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qIAAqI,EAAE;SAC7L;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC5C;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;SACpF;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,MAAM,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,IAAI,CAAA;YACpF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACzE,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAA;QAC5C,CAAC;KACF,CAAC,CAAC,CAAA;IACH,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,+HAA+H;QAC5I,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC9E,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,oEAAoE,EAAE;SACxJ;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACzC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC/C;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;SAChG;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;YAClF,MAAM,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,IAAI,CAAA;YACnF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1E,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YAC5I,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;YAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;YAC7H,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,CAAA;QAC5C,CAAC;KACF,CAAC,CAAC,CAAA;IACH,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,iGAAiG;QAC9G,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2DAA2D,EAAE;SACvH;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAChD;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;SACtE;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,MAAM,MAAM,GAAG,+BAA+B,GAAG,IAAI,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,IAAI,CAAA;YACpF,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YACnF,OAAO,EAAE,WAAW,EAAE,CAAA;QACxB,CAAC;KACF,CAAC,CAAC,CAAA;AACL,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@try-works/dsh-righthand",
   "description": "DeepSeek Harness plugin: DSH-native righthand tools — durable KV store, credential/settings management, governed exec, and a tool guard",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/skills/dsh-righthand/SKILL.md

@@ -12,9 +12,11 @@ The righthand toolkit: DSH-native tools over the harness's own services. Use thi
 | Family | Tools | Backing service | Use when |
 |--------|-------|-----------------|----------|
 | store | `rh_store_put` / `rh_store_get` / `rh_store_delete` / `rh_store_list` | `ctx.storageDomain` (domain KV) | The task needs durable state across turns: a catalog, counter, cache, or note. Prefer this over files for structured JSON records. |
+| tasks | `rh_task_create` / `rh_task_list` / `rh_task_next` / `rh_task_update` / `rh_task_delete` | `ctx.storageDomain` (typed `righthand_tasks` domain) | A task board with a state machine (open → done/failed). `rh_task_next` is the oldest open task — what to work on now. A failed task's `result` records what went wrong: a task that cannot run is still recorded, never silently dropped. |
 | secrets | `rh_credential_describe` / `rh_credential_set` / `rh_credential_unset` | `ctx.credentials` | The task must check, store, or remove a credential reference (e.g. `CLOUDFLARE_API_TOKEN`). Values are written durably and **never echoed back**. |
 | settings | `rh_settings_get` / `rh_settings_set` | `ctx.settings` (namespace `righthand`) | Reading or patching righthand settings (`accountId`, `defaultZone`, `defaultScriptPrefix`). |
 | exec | `rh_run` / `rh_run_bg` | `ctx.subprocess` + `ctx.jobs` | Running one command (argv array, no shell interpretation). `rh_run` collects bounded output; `rh_run_bg` starts an owner-scoped background job and returns its id. |
+| text | `rh_text_summarise` / `rh_text_extract` / `rh_text_classify` / `rh_text_translate` | `ctx.llm` (one model call per verb) | Language work: shorten, turn into JSON matching a schema, sort into your labels with confidence, or translate preserving formatting. |
 | guard | (policy, not a tool) | `ctx.tools` `tools/pre-execute` | Configured via plugin config `rules`; gates tools by name prefix with `allow` / `deny` / `ask` modes. |
 
 ## Store semantics
@@ -23,6 +25,20 @@ The righthand toolkit: DSH-native tools over the harness's own services. Use thi
 - `rh_store_get` returns `{ found, key, value?, updatedAt? }` — `found: false` means the key is absent, not an error.
 - Writes are durable (backend flush before commit) and serialized on one write chain; values must be JSON-serializable.
 
+## Text semantics
+
+- One model call per verb; each call's failure is contained (the other tools are unaffected).
+- `rh_text_extract` takes a JSON Schema and the model returns one object conforming to it — parse failures surface as a clean error, not raw prose.
+- `rh_text_classify` returns a label verbatim from the given set plus a 0–1 confidence; a label outside the set is an error.
+- Provider/model come from plugin config (`provider`/`model`, default the harness default model).
+
+## Task semantics
+
+- One domain `righthand_tasks`: a `tasks` table keyed by generated task id (`t-...`).
+- States: `open` → `done` | `failed`. `rh_task_next` returns the oldest open task; nothing open returns `{ found: false }`.
+- `rh_task_update` takes a state and/or a `result` — a failed task should carry what was tried and what went wrong, so the record says what happened.
+- `rh_task_list` sorts open first (oldest first), then done, then failed; `state` filters.
+
 ## Credential semantics
 
 - `rh_credential_describe` reports `configured`, `source`, `writable` — never the value.
@@ -45,5 +61,5 @@ Rules come from the plugin config (`rules: [{ toolPrefix, mode, ask?, destructiv
 
 ## Service availability
 
-- **web profile**: all twelve tools register (`storageDomain` is provided by the web app rows).
-- **other profiles** (e.g. headless): the store family stays dormant; the other seven tools still register. The plugin never fails the boot.
+- **web profile**: all twenty tools register (`storageDomain` is provided by the web app rows).
+- **other profiles** (e.g. headless): the store and task families stay dormant; the other seven tools still register. The plugin never fails the boot.

package/src/index.ts

@@ -14,6 +14,8 @@
  * Modules (each individually mountable via `export * as ...`):
  * - store-tools:     rh_store_put/get/delete/list over ctx.storageDomain
  * - secrets-tools:   rh_credential_describe/set/unset + rh_settings_get/set
+ * - task-tools:      rh_task_create/list/next/update/delete over ctx.storageDomain
+ * - text-tools:      rh_text_summarise/extract/classify/translate over ctx.llm
  * - exec-tools:      rh_run / rh_run_bg over ctx.subprocess + ctx.jobs
  * - guard-tools:     tools/pre-execute policy (config.rules)
  * - skills:          the packaged dsh-righthand skill (ctx.skills)
@@ -26,6 +28,8 @@ import * as storeTools from './store-tools.ts'
 import * as secretsTools from './secrets-tools.ts'
 import * as execTools from './exec-tools.ts'
 import * as guardTools from './guard-tools.ts'
+import * as taskTools from './task-tools.ts'
+import * as textTools from './text-tools.ts'
 import * as righthandSkills from './skills.ts'
 import type { GuardRule } from './guard-tools.ts'
 
@@ -50,12 +54,14 @@ export function apply(ctx: Context, config: RighthandConfig = {}): void {
   ctx.plugin(storeTools)
   ctx.plugin(secretsTools)
   ctx.plugin(execTools)
+  ctx.plugin(taskTools)
+  ctx.plugin(textTools)
   ctx.plugin(guardTools, { rules: config.rules ?? [] })
   ctx.plugin(righthandSkills)
 }
 
 // Individual modules stay importable for selective mounting.
-export { storeTools, secretsTools, execTools, guardTools, righthandSkills }
+export { storeTools, secretsTools, execTools, taskTools, textTools, guardTools, righthandSkills }
 export { SKILL_NAME, SKILL_DESCRIPTION, skillDirectory, skillBody } from './skills.ts'
 export type { GuardRule } from './guard-tools.ts'
 export { guardFactsFor } from './guard-tools.ts'

package/src/task-tools.ts

@@ -0,0 +1,236 @@
+/**
+ * task-tools — rh_task_* over ctx.storageDomain.
+ * A typed task board with a state machine: open → done | failed.
+ * `rh_task_next` is the queue discipline — the oldest open task is what to
+ * work on now. Descriptions carry the rule that a task's failure is recorded
+ * like an answer: a run that could not happen is news the owner needs.
+ * @module dsh-righthand/task-tools
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain'
+import type { Domain } from '@deepseek-ai/dsh-storage-domain'
+import { z } from 'zod'
+
+export const name = 'righthand-task'
+export const inject = ['tools', 'storageDomain']
+
+export type TaskState = 'open' | 'done' | 'failed'
+
+export interface Task {
+  id: string
+  title: string
+  detail: string
+  due: string
+  state: TaskState
+  result: string
+  createdAt: string
+  updatedAt: string
+}
+
+/** Domain spec: the typed task table. */
+export const taskDomain = defineDomain({
+  name: 'righthand_tasks',
+  version: 1,
+  tables: {
+    tasks: domainTable(z.object({
+      id: z.string(),
+      title: z.string(),
+      detail: z.string(),
+      due: z.string(),
+      state: z.enum(['open', 'done', 'failed']),
+      result: z.string(),
+      createdAt: z.string(),
+      updatedAt: z.string(),
+    })),
+  },
+})
+
+export type TaskDomain = Domain<typeof taskDomain>
+
+function newId(): string {
+  return 't-' + Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 6)
+}
+
+/** Open the task domain and register the model-facing tools. */
+export function apply(ctx: Context): void {
+  let domain: TaskDomain | undefined
+  let ready: Promise<void> | undefined
+
+  ctx.effect(() => {
+    ready = (async () => {
+      domain = await ctx.storageDomain.open(taskDomain)
+    })()
+    return () => { /* domain facility owns the domain */ }
+  })
+
+  const ensure = async (): Promise<TaskDomain> => {
+    if (domain === undefined) { await ready; }
+    if (domain === undefined) throw new Error('righthand tasks are not open (storageDomain not mounted)')
+    return domain
+  }
+
+  const all = async (): Promise<Task[]> => {
+    const d = await ensure()
+    return [...d.table('tasks').entries()].map(([, t]) => t)
+  }
+
+  ctx.tools.register(defineTool({
+    name: 'rh_task_create',
+    description: 'Add a task with a title, optional detail and due date. Returns the created task with a generated id and state open. A task the agent cannot run is still recorded — its failure is delivered like an answer.',
+    parameters: {
+      title: { type: 'string', required: true, description: 'What the task is, e.g. "deploy vision-worker".' },
+      detail: { type: 'string', description: 'Optional longer description of what done means.' },
+      due: { type: 'string', description: 'Optional due date, YYYY-MM-DD.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          id: { type: 'string', required: true },
+          title: { type: 'string', required: true },
+          state: { type: 'string', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: 'task ' + value.id + ' created: ' + value.title + ' (open)' }],
+    },
+    async execute(args) {
+      const d = await ensure()
+      const now = new Date().toISOString()
+      const task: Task = {
+        id: newId(),
+        title: args.title.trim(),
+        detail: args.detail ?? '',
+        due: args.due ?? '',
+        state: 'open',
+        result: '',
+        createdAt: now,
+        updatedAt: now,
+      }
+      if (task.title === '') throw new Error('a task needs a title')
+      await d.table('tasks').put(task.id, task)
+      return { id: task.id, title: task.title, state: task.state }
+    },
+  }))
+ctx.tools.register(defineTool({
+    name: 'rh_task_list',
+    description: 'List tasks, open ones first (oldest open first). Optionally filter by state.',
+    parameters: {
+      state: { type: 'string', description: 'Filter: open | done | failed. Omit for all tasks.' },
+    },
+    output: {
+      schema: {
+        type: 'array',
+        items: {
+          type: 'object',
+          additionalProperties: false,
+          properties: {
+            id: { type: 'string', required: true },
+            title: { type: 'string', required: true },
+            state: { type: 'string', required: true },
+            due: { type: 'string' },
+          },
+        },
+      },
+      render: (_args, tasks) => [{ type: 'text', text: tasks.length === 0 ? '(no tasks)' : tasks.map((t: any) => '[' + t.state + '] ' + t.title).join(' / ') }],
+    },
+    async execute(args) {
+      const tasks = await all()
+      const wanted = args.state ?? null
+      const filtered = wanted ? tasks.filter(t => t.state === wanted) : tasks
+      const rank = { open: 0, done: 1, failed: 2 } as Record<string, number>
+      filtered.sort((a, b) => (rank[a.state] - rank[b.state]) || a.createdAt.localeCompare(b.createdAt))
+      return filtered.map(t => ({ id: t.id, title: t.title, state: t.state, ...t.due ? { due: t.due } : {} }))
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'rh_task_next',
+    description: 'The next open task — what to work on now. Oldest open task first. Returns found: false when nothing is open.',
+    parameters: {},
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          found: { type: 'boolean', required: true },
+          id: { type: 'string' },
+          title: { type: 'string' },
+          detail: { type: 'string' },
+          due: { type: 'string' },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.found ? 'next: ' + value.title : '(nothing open)' }],
+    },
+    async execute() {
+      const tasks = await all()
+      const open = tasks.filter(t => t.state === 'open').sort((a, b) => a.createdAt.localeCompare(b.createdAt))
+      const t = open[0]
+      if (t === undefined) return { found: false }
+      return { found: true, id: t.id, title: t.title, ...t.detail ? { detail: t.detail } : {}, ...t.due ? { due: t.due } : {} }
+    },
+  }))
+ctx.tools.register(defineTool({
+    name: 'rh_task_update',
+    description: 'Change a task: its state (open | done | failed) and/or its result. A failed task should carry its result — what was tried and what went wrong — so the record says what happened, not just that something did.',
+    parameters: {
+      id: { type: 'string', required: true, description: 'The task id from rh_task_create or rh_task_list.' },
+      state: { type: 'string', description: 'New state: open | done | failed.' },
+      result: { type: 'string', description: 'What happened — the outcome, or the failure reason.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          found: { type: 'boolean', required: true },
+          id: { type: 'string', required: true },
+          state: { type: 'string', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.found ? 'task ' + value.id + ' -> ' + value.state : 'task ' + value.id + ' not found' }],
+    },
+    async execute(args) {
+      const d = await ensure()
+      const task = d.table('tasks').get(args.id)
+      if (task === undefined) return { found: false, id: args.id, state: 'open' }
+      const next: Task = {
+        ...task,
+        ...args.state !== undefined ? { state: args.state as TaskState } : {},
+        ...args.result !== undefined ? { result: args.result } : {},
+        updatedAt: new Date().toISOString(),
+      }
+      await d.table('tasks').put(args.id, next)
+      return { found: true, id: args.id, state: next.state }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'rh_task_delete',
+    description: 'Remove a task by id. Returns whether it existed.',
+    parameters: {
+      id: { type: 'string', required: true, description: 'The task id to remove.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          id: { type: 'string', required: true },
+          existed: { type: 'boolean', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: 'deleted ' + value.id + ': ' + value.existed }],
+    },
+    async execute(args) {
+      const d = await ensure()
+      const existed = await d.table('tasks').delete(args.id)
+      return { id: args.id, existed }
+    },
+  }))
+}
+
+
+

package/src/text-tools.ts

@@ -0,0 +1,173 @@
+/**
+ * text-tools — rh_text_* over ctx.llm.
+ * Language work at one call per verb: summarise, extract-to-JSON,
+ * classify, translate. Same prompt discipline as the digest summarizer:
+ * roles stay roles, caps are deliberate, each call's failure is contained
+ * in that call (the other tools are unaffected).
+ * @module dsh-righthand/text-tools
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import { BlockAssembler, createUserMessage, deepFreeze } from '@deepseek-ai/dsh-llm'
+import type { GenerateOptions } from '@deepseek-ai/dsh-llm'
+
+export const name = 'righthand-text'
+export const inject = ['tools', 'llm']
+
+export interface TextConfig {
+  /** LLM route; defaults match the harness default model. */
+  provider?: string
+  model?: string
+}
+
+const DEFAULTS: Required<TextConfig> = { provider: 'deepseek-official', model: 'deepseek-v4-flash' }
+
+/** One LLM call, text in, text out. Returns the assembled text or throws. */
+async function ask(ctx: Context, cfg: Required<TextConfig>, system: string, user: string, maxTokens: number, signal: AbortSignal): Promise<string> {
+  const options: GenerateOptions = deepFreeze({
+    provider: cfg.provider,
+    model: cfg.model,
+    messages: [createUserMessage({
+      content: [{ type: 'text', text: user }],
+      source: { kind: 'plugin', plugin: 'righthand-text' },
+    })],
+    system,
+    maxTokens,
+    purpose: 'compaction',
+    signal,
+  })
+  const assembler = new BlockAssembler()
+  for await (const chunk of ctx.llm.stream(options)) assembler.push(chunk)
+  if (assembler.finish.kind !== 'stop') throw new Error('text model call did not stop cleanly: ' + JSON.stringify(assembler.finish.kind))
+  const text = assembler.blocks().filter((b: any) => b.type === 'text').map((b: any) => b.text).join(' ').trim()
+  if (text === '') throw new Error('text model call produced no text')
+  return text
+}
+
+/** Extract the outermost {...} JSON object from a model reply. */
+function parseJsonWindow(text: string): any {
+  const start = text.indexOf('{')
+  const end = text.lastIndexOf('}')
+  if (start < 0 || end <= start) throw new Error('model output was not JSON')
+  return JSON.parse(text.slice(start, end + 1))
+}
+
+/** Summarise: plain prose, no JSON. */
+const SUMMARISE_SYSTEM = 'You summarise text. Return ONLY the summary itself - a few sentences, plain prose, no JSON, no Markdown headers, no quotes around it. Preserve the language of the input.'
+
+/** Extract: JSON matching a caller schema. */
+const EXTRACT_SYSTEM = 'You extract structured data from text. Return ONLY one JSON object matching the caller schema exactly - no prose, no Markdown, no code fences.'
+
+/** Classify: one label plus confidence, as JSON. */
+const CLASSIFY_SYSTEM = 'You classify text. Return ONLY one JSON object with exactly two keys: label (one of the given labels, verbatim) and confidence (a number from 0 to 1). No prose, no Markdown.'
+
+/** Translate: preserve formatting, plain prose. */
+const TRANSLATE_SYSTEM = 'You translate text. Return ONLY the translation - plain prose, no JSON, no quotes around it, preserving paragraph breaks and any Markdown or code the input contains.'
+
+export function apply(ctx: Context, config: TextConfig = {}): void {
+  const cfg: Required<TextConfig> = { ...DEFAULTS, ...config }
+  ctx.tools.register(defineTool({
+    name: 'rh_text_summarise',
+    description: 'Summarise text into a few sentences. One model call per invocation; the result is new prose, not extracted sentences.',
+    parameters: {
+      text: { type: 'string', required: true, description: 'The text to summarise (max ~30000 characters).' },
+      sentences: { type: 'integer', description: 'Target length in sentences (default 3).' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          summary: { type: 'string', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.summary }],
+    },
+    async execute(args, exec) {
+      const n = args.sentences ?? 3
+      const summary = await ask(ctx, cfg, SUMMARISE_SYSTEM, 'Summarise this in about ' + n + ' sentences:\n\n' + args.text, 600, exec.signal)
+      return { summary }
+    },
+  }))
+  ctx.tools.register(defineTool({
+    name: 'rh_text_extract',
+    description: 'Turn text into JSON matching a schema you give. The schema is a JSON Schema object; the model returns one object conforming to it, or the call fails cleanly.',
+    parameters: {
+      text: { type: 'string', required: true, description: 'The text to extract from.' },
+      schema: { type: 'json', required: true, description: 'JSON Schema the result must match, e.g. { "type": "object", "properties": { "name": { "type": "string" } }, "required": ["name"] }.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          extracted: { type: 'json', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: JSON.stringify(value.extracted) }],
+    },
+    async execute(args, exec) {
+      const framed = 'Schema:\n' + JSON.stringify(args.schema) + '\n\nText:\n' + args.text
+      const raw = await ask(ctx, cfg, EXTRACT_SYSTEM, framed, 800, exec.signal)
+      return { extracted: parseJsonWindow(raw) }
+    },
+  }))
+  ctx.tools.register(defineTool({
+    name: 'rh_text_classify',
+    description: 'Sort text into one of the labels you give, with a confidence score from 0 to 1. The label returned is one of yours, verbatim.',
+    parameters: {
+      text: { type: 'string', required: true, description: 'The text to classify.' },
+      labels: { type: 'array', required: true, items: { type: 'string' }, description: 'The candidate labels, e.g. ["bug", "feature request", "question"].' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          label: { type: 'string', required: true },
+          confidence: { type: 'number', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.label + ' (' + value.confidence + ')' }],
+    },
+    async execute(args, exec) {
+      if (args.labels.length === 0) throw new Error('classify needs at least one label')
+      const framed = 'Labels: ' + JSON.stringify(args.labels) + '\n\nText:\n' + args.text
+      const raw = await ask(ctx, cfg, CLASSIFY_SYSTEM, framed, 100, exec.signal)
+      const parsed = parseJsonWindow(raw)
+      if (typeof parsed.label !== 'string' || !args.labels.includes(parsed.label)) throw new Error('model returned a label outside the given set')
+      const confidence = Number(parsed.confidence)
+      if (!Number.isFinite(confidence) || confidence < 0 || confidence > 1) throw new Error('model returned an invalid confidence')
+      return { label: parsed.label, confidence }
+    },
+  }))
+  ctx.tools.register(defineTool({
+    name: 'rh_text_translate',
+    description: 'Translate text into another language, preserving formatting (paragraph breaks, Markdown, code).',
+    parameters: {
+      text: { type: 'string', required: true, description: 'The text to translate.' },
+      language: { type: 'string', required: true, description: 'The target language, e.g. "Spanish", "zh-CN", "Japanese".' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          translation: { type: 'string', required: true },
+        },
+      },
+      render: (_args, value) => [{ type: 'text', text: value.translation }],
+    },
+    async execute(args, exec) {
+      const framed = 'Translate the following into ' + args.language + ':\n\n' + args.text
+      const translation = await ask(ctx, cfg, TRANSLATE_SYSTEM, framed, 800, exec.signal)
+      return { translation }
+    },
+  }))
+}
+
+
+
+
+