@mrrlin-dev/mcp 0.4.18 → 0.4.19

package/dist/bin.cjs

@@ -41623,7 +41623,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.18";
+var PKG_VERSION = "0.4.19";
 
 // src/api-base-url-migrate.ts
 var import_node_fs3 = __toESM(require("node:fs"), 1);
@@ -53906,6 +53906,35 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     "  still end at a clean boundary with an explicit request to continue. Ask when the work is",
     "  genuinely big, needs an operator decision, or would change scope \u2014 never to dodge cheap work.",
     "",
+    "Immediate-execution contract - close tiny same-session loops without creating task churn:",
+    "- This is a runtime behaviour inside the normal Codex tool loop, not a new bridge protocol. The",
+    "  bridge only starts/resumes turns and exposes typed MCP tools; it must not hold active-action",
+    "  state, parse operator intent semantically, or invoke browser/Mrrlin tools directly on its own.",
+    "- Low-effect observation is proactive: if the operator asks you to verify, inspect logs, read a",
+    "  page, check a status, or collect facts and the work is small enough for this turn, do it now",
+    "  using the cheapest tool that reaches ground truth. Do not ask for permission just to observe.",
+    "- For any mutation, submission, browser form, external account change, purchase, publish, deploy,",
+    "  message, or durable repo/project write, offer the immediate action before doing it. Name the",
+    "  target and effect in plain language, ask for a short go-ahead, then act autonomously only inside",
+    "  that same-session envelope.",
+    "- Same-session approval expires at a turn boundary, disconnect, resume, or materially changed",
+    "  target. Re-validate the visible/current target before acting after any resume, redirect, or",
+    "  changed page state. Never stretch one approval to a different target, broader batch, or hidden",
+    "  external effect.",
+    "- Sensitive boundaries stay outside this lane: credentials, secrets, billing, legal/compliance,",
+    "  destructive deletes, production release/merge, broad scraping, and customer/user messaging need",
+    "  the normal task/approval path unless the operator explicitly scopes that exact action.",
+    "- Keep retries bounded: one cheap retry is fine for flaky observation or validation. Repeated",
+    "  failure, CAPTCHA/login walls you cannot resolve, ambiguous identity, or missing authority becomes",
+    "  a blocker/question, not a completed receipt.",
+    "- Always leave a durable receipt for material immediate work. If a parent task exists, append a",
+    "  task event summarizing scope, outcome/no-result, evidence or artifacts, blockers, and the next",
+    '  action. If no parent task exists, create a taskless inbox item with kind="completed" and omit',
+    "  taskId. Do not record blockers as completed receipts.",
+    "- Promote to a normal task when the action changes code, product behaviour, durable architecture,",
+    "  policy, or needs consensus/review; when it spans more than a small batch (roughly eight similar",
+    "  items); or when the result cannot be verified in the current turn.",
+    "",
     "Context-handle contract \u2014 a `mrrlin://` handle is a pointer, not an answer:",
     "- When tool output carries a `mrrlin://` handle and your answer depends on detail the compact",
     "  envelope does not contain, call `retrieve_context` on that handle BEFORE answering.",
@@ -62638,7 +62667,7 @@ var mcpToolDescriptions = {
   [mcpToolNames.listProjectMembers]: "List a project's teammates (the owner is derived from github.operator, not a member row).",
   [mcpToolNames.addProjectMember]: "Add a teammate to a project by email (owner-only).",
   [mcpToolNames.removeProjectMember]: "Remove a teammate from a project by email (owner-only); returns the updated list.",
-  [mcpToolNames.appendTaskEvent]: "Append an operator note to a task's activity timeline.",
+  [mcpToolNames.appendTaskEvent]: "Append an operator note to a task's activity timeline. Also use it as the task-linked receipt path for material immediate work that has a parent task; summarize scope, outcome/no-result, evidence or artifacts, blockers, and next action in the note body.",
   [mcpToolNames.createWikiPage]: "Create a markdown Wiki page.",
   [mcpToolNames.deleteTaskDependency]: "Delete a blocked-by relationship.",
   [mcpToolNames.createTask]: "Create a new task in a project. Defaults to status='backlog' with a blank assignee; pass status='todo' explicitly to authorize immediate autopilot work. 'backlog' and 'todo' are the only creatable statuses. Pass parentTaskId when spawning a follow-up task to continue work from an existing task \u2014 its operator_seed_request is inherited automatically if you don't supply your own. Domain is required UNLESS parentTaskId is supplied (a follow-up inherits its parent's domain automatically). Domain selects which reviewer roster judges the task's spec. Valid values: code, seo, marketing, content.",
@@ -62686,7 +62715,7 @@ var mcpToolDescriptions = {
   [mcpToolNames.getSchedulerPendingTasks]: "Return tasks the scheduler should wake now: ones with follow_up_at or verification_due_at passed, or the policy wake_floor reached, filtered by eligible autonomy levels.",
   [mcpToolNames.wakeDirector]: "Wake Director once for a project: optionally dry-run scheduler evaluation or enqueue execution runs best-effort.",
   [mcpToolNames.listInboxItems]: "List operator-inbox items for a project. Optional filters: kind, status.",
-  [mcpToolNames.createInboxItem]: "Create an operator-inbox item (proposal, check_in, question, handoff, or info) for a project.",
+  [mcpToolNames.createInboxItem]: 'Create an operator-inbox item (proposal, check_in, question, handoff, info, or completed) for a project. Use kind="completed" for material taskless completion receipts after same-session immediate work with no parent task; omit taskId for taskless receipts and summarize scope, outcome/no-result, evidence or artifacts, blocker if any, and next action in body. Do not file blockers as completed receipts.',
   [mcpToolNames.decideInboxItem]: "Approve, reject, or acknowledge an operator-inbox item. Rejection requires a reason.",
   [mcpToolNames.uploadArtifact]: "Upload a local file (md/txt/html/csv/json/pdf/png/jpg/webp/gif, <=5MB) as a project artifact. Returns a stable markdown link to embed in chat/spec/handoff text. Use class=temp for one-off hand-offs, class=durable for anything referenced by specs or evidence. Pass runId to record the file in that run's artifact history; pass taskId to surface it on the task's Artifacts list.",
   [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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.4.18",
+  "version": "0.4.19",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"
@@ -21,9 +21,9 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.24.0",
     "tsx": "^4.22.3",
-    "@mrrlin/agent-client": "0.0.0",
-    "@mrrlin/director-e2e": "0.0.0",
     "@mrrlin/schemas": "0.0.0",
+    "@mrrlin/director-e2e": "0.0.0",
+    "@mrrlin/agent-client": "0.0.0",
     "@mrrlin/tsconfig": "0.0.0",
     "@mrrlin/wiki": "0.0.0",
     "@mrrlin/client": "0.0.0"