pi-task-dispatcher 3.0.1 → 3.0.2

package/README.md

@@ -6,7 +6,7 @@ Each delegation runs in an isolated, in-memory Pi RPC session. After every cohes
 
 ## Features
 
-- **Four worker roles:** prescribed mechanical execution, bounded assistant work, broader engineering, and media design.
+- **Four worker roles:** prescribed mechanical execution, fallback assistant work, broader engineering, and media design.
 - **Enforced supervision:** a private parent-child IPC gate calls `ctx.abort()` after persisted tool results; pausing does not depend on the worker following a prompt.
 - **Explicit control:** continue, revise, recalculate, compact, checkpoint, cancel, or take over.
 - **Resumable context:** continuation uses the same in-memory worker session and completed tool results.
@@ -38,7 +38,7 @@ pi install npm:pi-task-dispatcher
 | Tool | Responsibility |
 | --- | --- |
 | `delegate_mechanical` | Execute prescribed work whose method and expected result are already known. |
-| `delegate_assistant` | Perform bounded, low-complexity interpretation, synthesis, or routine updates. |
+| `delegate_assistant` | Perform the user-requested work when no other worker role applies; the orchestrator does not perform that work directly. |
 | `delegate_engineering` | Investigate or implement uncertain, cross-component, or technically intensive work. |
 | `delegate_designer` | Create or edit image assets and process image, video, or audio files with available tools. |
 | `delegate_control` | Apply one explicit manager decision to a paused delegation. |
@@ -51,10 +51,12 @@ Only one live delegation is currently permitted. A terminal delegation may be in
 | Role | Selection rule |
 | --- | --- |
 | Mechanic | The method and expected result are known; execute exact steps. |
-| Assistant | The task needs limited judgment but remains bounded, low-risk, and locally verifiable. It does not assume manager authority or make architectural decisions. |
+| Assistant | When no other worker role applies, use `delegate_assistant` for the user-requested work instead of having the orchestrator perform it directly. |
 | Engineer | The cause, design, or implementation path is uncertain or spans components. |
 | Designer | The requested result is an image, video, audio, or related media asset or transformation. |
 
+The orchestrator retains responsibility for delegation decisions, worker supervision, integration of delegated results, and the final response.
+
 The designer can inspect images with `read`, use image models through `codemode`, and run explicitly selected command-line media programs through `bash` or `powershell`. Generated codemode images are runtime-temporary until the worker deliberately copies a selected output to the requested workspace destination and verifies it. Video and audio generation depends on explicitly available command-line programs or services; editing workflows can use programs such as `ffmpeg` when installed.
 
 ## Starting a delegation

package/extensions/task-dispatcher.ts

@@ -227,7 +227,7 @@ Own only the supplied image, video, audio, or media-asset objective while the ca
 
 const ROLE_DESCRIPTIONS: Record<Role, string> = {
 	mechanic: "Start a supervised mechanical delegation for prescribed execution with a known method and result.",
-	assistant: "Start a supervised assistant delegation for bounded, low-complexity interpretation, synthesis, or routine updates.",
+	assistant: "Start a supervised assistant delegation for a subtask you would otherwise perform directly, when no other worker role applies.",
 	engineer: "Start a supervised engineering delegation for uncertain, cross-component, or implementation-intensive work.",
 	designer: "Start a supervised media-design delegation for image generation or editing and command-line image, video, or audio processing.",
 };
@@ -1313,6 +1313,9 @@ function registerDelegate(pi: ExtensionAPI, role: Role): void {
 		description: ROLE_DESCRIPTIONS[role],
 		promptSnippet: `${name}: start a supervised ${role} delegation that pauses after each completed action batch`,
 		promptGuidelines: [
+			...(role === "assistant"
+				? ["When no other worker role applies, use delegate_assistant for the user-requested work instead of performing it directly. Retain delegation decisions, worker supervision, result integration, and the final response."]
+				: []),
 			"Supply semantic workload units rather than raw turn or timeout values.",
 			"Inspect every paused state and choose continue, revise, recalculate, compact, checkpoint, cancel, or take over.",
 			"Worker reports remain evidence to review, not proof of correctness.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-task-dispatcher",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Run configurable Pi worker models as supervised, observable, resumable jobs.",
   "type": "module",
   "keywords": [