@mrrlin-dev/mcp 0.4.146 → 0.4.147

package/dist/bin.cjs

@@ -60701,7 +60701,7 @@ var mcpToolDescriptions = {
   [mcpToolNames.deliverFile]: "This is the DEFAULT way to deliver a file the agent just composed; it takes the body inline as UTF-8 `content` in one call and needs no local file or writable path; `upload_artifact` is for a file that already exists on disk; use class=temp / class=durable and taskId/runId semantics with a 5MB cap.",
   [mcpToolNames.listArtifactFiles]: "List uploaded artifact files for the project (optionally filtered by taskId/runId), newest first.",
   [mcpToolNames.reclaimExecutionRunLease]: "Clear a stale pending execution-run lease when the lease has aged past staleSeconds. Returns the reclaimed run on success, null when the lease is not stale yet, and surfaces a structured conflict when reclaim retries are exhausted.",
-  [mcpToolNames.restartExecutionRun]: "Restart a parked execution run (handoff_requested or handoff_queued) back to pending so the queue can resume it.",
+  [mcpToolNames.restartExecutionRun]: "Restart a parked execution run (handoff_requested or handoff_queued) back to pending so the queue can resume it. Call it yourself once the reason the run stopped no longer holds \u2014 never ask the operator or support to restart a run. Restart on your own only when the blockingReason's resolution is observable, and check it first: local_checkout_missing \u2192 a checkout is now registered (register_local_checkout succeeded or the project shows one); capability_not_routed \u2192 the artifact kind's route now resolves; task_blocked \u2192 get_task shows every blockedBy task closed. Any other reason (provider_not_ready, provider_limit_exhausted, execution_turn_timeout, default_branch_unresolved, deliverable_gate_exhausted, none) \u2192 restart only when the operator explicitly asks you to restart it; a status question means inspect and report, not restart. operator_stopped is the operator's to restart (refused for you).",
   [mcpToolNames.stopExecutionRun]: "Operator stop: park an in-flight execution run at handoff_requested with blockingReason operator_stopped. Parks rather than cancels, so restart_execution_run can resume it later. Refuses (409) a run already at a terminal status.",
   [mcpToolNames.resolveHandoff]: "Resolve a tool_assisted handoff for an execution run (outcome success|failure). Success returns the task to the board; failure opens a new handoff cycle. Idempotent.",
   [mcpToolNames.registerLocalCheckout]: "Register the operator-local git checkout path for `projectSlug` so execution-run workers run code on this machine instead of the cloud. Validates the path is a git repo whose `origin` remote matches `repo`, then writes the (slug -> absolute path) entry to the operator-local checkout registry. For a project with no GitHub (code kept only on this computer), omit `repo`: the path must then be the top of a git repository owned by the operator, not the home folder, a system folder or a credentials/settings folder such as ~/.ssh, ~/.aws or ~/.config. Call this after locating the checkout on disk (e.g. via filesystem search) and confirming the choice with the user in chat \u2014 they should NOT have to paste the path into Settings. Returns `{ projectSlug, path, confirmedAt }`. Idempotent: re-registering overwrites the prior entry.",
@@ -63826,7 +63826,7 @@ Do NOT derail the current task - if the operator has an in-flight question, answ
 }
 
 // src/_generated/version.ts
-var PKG_VERSION = "0.4.146";
+var PKG_VERSION = "0.4.147";
 
 // src/bridge-allowed-origins.ts
 var DEFAULT_DIRECTOR_BRIDGE_ALLOWED_ORIGINS = [
@@ -77197,6 +77197,14 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     "- Do not create a handoff for transient provider quota/runtime failures, retriable tool",
     "  errors, or vague uncertainty; retry cheaply or explain the transient issue in chat.",
     "",
+    // Dogfood v2 F-18: twice a parked run whose cause was already resolved sat until the operator
+    // happened to ask for a restart; asked only for its status, the Director filed a "technical
+    // support" handoff instead of using the restart tool it has.
+    "Parked runs: when a task's run is parked (handoff_queued/handoff_requested) and the operator asks about it",
+    "or its blocker was resolved, check its stop reason; if it no longer holds, call `restart_execution_run`",
+    "yourself and say it is queued again. Never hand a restart off to anyone; keep a run parked only while its",
+    "blocker is still missing (say what); the tool lists which reasons qualify. `operator_stopped` is the operator's to restart.",
+    "",
     "Deferred-verification contract \u2014 when the RESULT can only be judged later:",
     "- When a task's implementation is DONE but its outcome cannot be confirmed now because it",
     "  depends on a delay you do not control \u2014 SEO ranking/traffic effects after (re)indexing,",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.4.146",
+  "version": "0.4.147",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"