Skip to main content
Glama
mahadansar

sol-luna-orchestrator

by mahadansar
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Continue an eligible Luna task

continue_task

Resume one pending delegated task in the same thread using a single-use continuation reference and bounded instruction, re-running verification and scope checks without altering the original objective or constraints.

Instructions

Continue ONE eligible task once in the same Luna Codex thread with an opaque single-use continuationReference and one bounded instruction. The original objective, allowedFiles, forbiddenFiles, changeIntent, acceptance, and verification contract remain immutable; no widening fields exist. Luna cannot delegate, and continuation never starts automatic repair. Verification, scope checks, and evidence reconciliation run again. handoff is default; compact/full are compatibility modes. While pending with no meaningful new state, remain silent; do not narrate waiting or polling. Report only a result, error, cancellation, timeout, or actionable state change.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
instructionYes
resultDetailNohandoff
continuationReferenceYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.11.0
    • addedInput schema / properties / continuationReference / maxLength
      Added value: +128
  2. Changed4 schema fields changedv0.10.0
    • removedInput schema / properties / continuationReference / description
      Removed value: -"Opaque server-lifetime reference returned on an eligible delegated result. Do not send a raw Codex thread id."
    • removedInput schema / properties / instruction / description
      Removed value: -"One concise follow-up instruction for the same bounded task. The original objective, allowedFiles, forbiddenFiles, changeIntent, acceptance criteria, and verification commands remain fixed and are not accepted here."
    • addedInput schema / properties / resultDetail
      Added value: +{
+  "default": "handoff",
+  "enum": [
+    "handoff",
+    "compact",
+    "full"
+  ],
+  "type": "string"
+}
    • changedOutput schema / (root)
      Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "attempt": {
-      "description": "Attempt number for this objective, from `previousAttempts`.",
-      "type": "number"
-    },
-    "changeIntent": {
-      "description": "Selected change intent carried into the review evidence.",
-      "enum": [
-        "forbidden",
-        "optional",
-        "required"
-      ],
-      "type": "string"
-    },
-    "continuationReference": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Opaque, single-use, server-lifetime reference for one explicit continuation; null when this result cannot be continued or the bound was consumed."
-    },
-    "discrepancies": {
-      "description": "Concrete mismatches between claims and observed evidence. Non-empty means do not accept the result as-is.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "durationSeconds": {
-      "type": "number"
-    },
-    "effort": {
-      "type": "string"
-    },
-    "effortReason": {
-      "type": "string"
-    },
-    "errors": {
-      "description": "Runtime errors surfaced during the turn.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "escalationAdvice": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "When the task did not pass, what to change before retrying — including whether raising effort is actually justified."
-    },
-    "filesChanged": {
-      "description": "Union of runtime-observed and worker-claimed edits. observed: false means the runtime recorded no matching patch.",
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "kind": {
-            "type": "string"
-          },
-          "observed": {
-            "description": "True if the Codex runtime itself recorded this edit.",
-            "type": "boolean"
-          },
-          "path": {
-            "type": "string"
-          },
-          "why": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "path",
-          "kind",
-          "why",
-          "observed"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "followUps": {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "model": {
-      "type": "string"
-    },
-    "notes": {
-      "type": "string"
-    },
-    "repair": {
-      "anyOf": [
-        {
-          "additionalProperties": false,
-          "properties": {
-            "attempted": {
-              "type": "boolean"
-            },
-            "classification": {
-              "enum": [
-                "not-requested",
-                "not-needed",
-                "local-verification",
-                "read-only",
-                "contract-or-requirement",
-                "scope-or-conflict",
-                "environment-or-tooling",
-                "security-or-trust-boundary",
-                "wider-scope"
-              ],
-              "type": "string"
-            },
-            "failureEvidence": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "command": {
-                    "type": "string"
-                  },
-                  "execution": {
-                    "enum": [
-                      "argv",
-                      "shell"
-                    ],
-                    "type": "string"
-                  },
-                  "exitCode": {
-                    "anyOf": [
-                      {
-                        "type": "number"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "output": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "command",
-                  "execution",
-                  "exitCode",
-                  "output"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "reason": {
-              "type": "string"
-            },
-            "requested": {
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "requested",
-            "attempted",
-            "classification",
-            "reason",
-            "failureEvidence"
-          ],
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Bounded automatic-repair decision and the concise authoritative failure evidence supplied to the resumed worker. Null or omitted when not requested."
-    },
-    "reviewChecklist": {
-      "description": "Risk-based checks the parent orchestrator must still make before accepting.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "scopeViolations": {
-      "description": "Observed edits outside allowedFiles, matching forbiddenFiles, or escaping the workspace. Non-empty requires deeper review.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "summary": {
-      "description": "Worker's summary of what it did.",
-      "type": "string"
-    },
-    "trustworthy": {
-      "description": "False when claims conflict with observed evidence or runtime errors occurred; scrutinize the result before accepting.",
-      "type": "boolean"
-    },
-    "usage": {
-      "anyOf": [
-        {
-          "additionalProperties": false,
-          "properties": {
-            "cacheWriteInputTokens": {
-              "type": "number"
-            },
-            "cachedInputTokens": {
-              "type": "number"
-            },
-            "inputTokens": {
-              "type": "number"
-            },
-            "outputTokens": {
-              "type": "number"
-            },
-            "reasoningOutputTokens": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "inputTokens",
-            "cachedInputTokens",
-            "outputTokens",
-            "reasoningOutputTokens"
-          ],
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "verdict": {
-      "description": "Orchestrator verdict from observed scope and configured verification; not copied from the worker's claim.",
-      "enum": [
-        "PASS",
-        "BLOCKED",
-        "FAILED"
-      ],
-      "type": "string"
-    },
-    "verification": {
-      "description": "Verification outcomes with provenance and execution status; use orchestrator rows to determine what actually ran.",
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "command": {
-            "type": "string"
-          },
-          "execution": {
-            "description": "argv or shell = executed here; rejected = refused; skipped = disabled; reported = worker-only. Only successful executed rows prove a command.",
-            "enum": [
-              "argv",
-              "shell",
-              "rejected",
-              "skipped",
-              "reported"
-            ],
-            "type": "string"
-          },
-          "exitCode": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "output": {
-            "type": "string"
-          },
-          "passed": {
-            "type": "boolean"
-          },
-          "source": {
-            "description": "Result provenance. Orchestrator rows authoritatively record execution, refusal, or skipping; worker rows are self-reported.",
-            "enum": [
-              "orchestrator",
-              "worker"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "command",
-          "source",
-          "execution",
-          "exitCode",
-          "passed",
-          "output"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "verificationMode": {
-      "description": "Execution policy in force: allowlist, off, or shell.",
-      "type": "string"
-    },
-    "workerClaimedFailureCauses": {
-      "description": "Normalized worker-declared failure causes. This is claim evidence, not an orchestrator repair or retry classification. Current results always include it; the field is optional only for backwards-compatible consumers.",
-      "items": {
-        "enum": [
-          "verification",
-          "requirements",
-          "implementation",
-          "environment-tooling",
-          "timeout",
-          "blocked",
-          "unclassified"
-        ],
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "workerClaimedStatus": {
-      "description": "What the worker reported. Compare against `verdict`.",
-      "enum": [
-        "PASS",
-        "BLOCKED",
-        "FAILED"
-      ],
-      "type": "string"
-    },
-    "workerThreadId": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Codex thread id of the worker, for inspection; continuation uses an opaque reference."
-    }
-  },
-  "required": [
-    "changeIntent",
-    "verdict",
-    "workerClaimedStatus",
-    "trustworthy",
-    "workerThreadId",
-    "continuationReference",
-    "model",
-    "effort",
-    "effortReason",
-    "attempt",
-    "summary",
-    "notes",
-    "followUps",
-    "filesChanged",
-    "verification",
-    "verificationMode",
-    "scopeViolations",
-    "discrepancies",
-    "reviewChecklist",
-    "escalationAdvice",
-    "durationSeconds",
-    "usage",
-    "errors"
-  ],
-  "type": "object"
-}New value: +null
  3. Addedv0.9.0

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden and does so thoroughly. It discloses immutability of the original contract, no widening fields, no delegation, no automatic repair, re-running of verification/scope/evidence checks, resultDetail mode semantics, silence while pending, and the allowed report outcomes. This is exceptional transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but every clause earns its place, covering action, constraints, mutation semantics, verification behavior, output modes, and communication protocol. The primary action is front-loaded in the first sentence, and the rest provides necessary behavioral guardrails without fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations, no output schema, and the subtle semantics of continuation, the description is remarkably complete. It explains eligibility constraints, single-use token behavior, immutability, what will not happen, what checks rerun, mode defaults, and when to stay silent versus report. There is little an agent would need to infer on its own.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It adds real semantics for the key parameters: 'opaque single-use continuationReference', 'one bounded instruction', and 'handoff is default; compact/full are compatibility modes' for resultDetail. It does not provide exhaustive per-parameter descriptions, but what it adds is meaningful and sufficient for invocation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb ('Continue'), a specific resource ('ONE eligible task'), and critical constraints ('once in the same Luna Codex thread', 'opaque single-use continuationReference'). It is clearly distinguished from siblings by explicitly noting 'Luna cannot delegate', so an agent can tell it apart from delegate_task/delegate_tasks.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly states the context for use: continuing an existing task in the same thread with a continuation reference. It provides exclusions such as 'Luna cannot delegate' and 'continuation never starts automatic repair', which helps differentiate from delegation and repair workflows. It does not name the exact alternative tool names, but the usage context is strong.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools