impel-cli 0.19.3 → 0.20.0-beta.0

package/src/directAnswer.js

@@ -0,0 +1,59 @@
+/**
+ * Catalog opt-in for Impel MCP `answer_native_agent`.
+ *
+ * When `directAnswer` is true, managed Claude/Codex adapters call that one-shot
+ * tool (Impel auth → Eve `/eve/v1/answer`) and return forUser/answer instead of
+ * list → start → poll. Distinct from agent-internal retrieve shortcuts.
+ *
+ * Does not replace the verbatimRelay description / fork_turns override: when an
+ * agent also sets verbatimRelay, keep that marker and spawn guidance so parents
+ * still use fork_turns="none" and relay the adapter result verbatim.
+ */
+
+import {
+  VERBATIM_FINAL_TEXT_CONSTRAINTS,
+} from "./verbatimRelay.js";
+
+export function usesDirectAnswer(agent) {
+  return agent?.directAnswer === true;
+}
+
+export function extractAnswerFinalText(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return null;
+  for (const key of ["forUser", "answer"]) {
+    const text = payload[key];
+    if (typeof text === "string" && text.trim()) return text;
+  }
+  return null;
+}
+
+export function claudeAnswerHardCompletionGuidance() {
+  return (
+    `When it succeeds, return forUser if present, otherwise answer, exactly with ${VERBATIM_FINAL_TEXT_CONSTRAINTS}. ` +
+    "When it fails, return the tool error without inventing a replacement result. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}
+
+export function claudeAnswerSoftCompletionGuidance() {
+  return (
+    "When it succeeds, return forUser if present, otherwise answer, faithfully as the answer. " +
+    "When it fails, return the tool error without inventing a replacement result. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}
+
+export function adapterAnswerHardCompletionGuidance() {
+  return (
+    `After the orchestration completes, return its single text output verbatim with ${VERBATIM_FINAL_TEXT_CONSTRAINTS}. ` +
+    "A successful output is forUser (else answer) exactly. A failure output preserves the error payload."
+  );
+}
+
+export function adapterAnswerSoftCompletionGuidance() {
+  return (
+    "After the orchestration completes, return its single text output as the answer. " +
+    "A successful output is forUser (else answer). A failure output preserves the error payload. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}

package/src/selfInvocation.js

@@ -65,6 +65,7 @@ export function impelCliInvocation(args = [], options = {}) {
 }
 
 export const IMPEL_MANAGED_MCP_ENV = brandedEnvironmentName("MANAGED_MCP");
+export const IMPEL_TASKS_MCP_SERVER_NAME = `${RUNTIME_BRAND.cli.providerId}-tasks`;
 
 export function impelMcpInvocation(args = [], options = {}) {
   return {
@@ -73,3 +74,29 @@ export function impelMcpInvocation(args = [], options = {}) {
     env: { [IMPEL_MANAGED_MCP_ENV]: "1" },
   };
 }
+
+/**
+ * The tenant-bound Tasks MCP process launched by managed Claude/Codex hosts.
+ * The PAT remains in Impel's private config and is read by the child process;
+ * it must never be baked into this invocation or a vendor profile.
+ */
+export function impelTasksMcpInvocation(tenantId, options = {}) {
+  if (typeof tenantId !== "string" || !tenantId.trim()) {
+    throw new Error("a tenant is required for the managed Tasks MCP invocation");
+  }
+  return impelMcpInvocation(["--target", "tasks", "--tenant", tenantId], options);
+}
+
+/** Recognize only the marker-bearing Tasks invocation that impel-cli owns. */
+export function isImpelTasksMcpInvocation(value) {
+  if (!value || typeof value !== "object" || !Array.isArray(value.args)) return false;
+  const suffix = value.args.slice(-5);
+  return value.type === "stdio"
+    && value.env?.[IMPEL_MANAGED_MCP_ENV] === "1"
+    && suffix[0] === "mcp"
+    && suffix[1] === "--target"
+    && suffix[2] === "tasks"
+    && suffix[3] === "--tenant"
+    && typeof suffix[4] === "string"
+    && suffix[4].length > 0;
+}

package/src/verbatimRelay.js

@@ -0,0 +1,64 @@
+export const VERBATIM_RELAY_OPT_IN_MARKER = "verbatimRelay enabled";
+
+export const VERBATIM_SPAWN_REQUIREMENT = 'fork_turns="none"';
+
+export const VERBATIM_FINAL_TEXT_CONSTRAINTS =
+  "no preface, rewriting, Markdown changes, or independent synthesis";
+
+export function usesVerbatimRelay(agent) {
+  return agent?.verbatimRelay === true;
+}
+
+export function parentVerbatimRelayAppendix() {
+  return (
+    `When an explicit custom agent's catalog-derived description declares ${VERBATIM_RELAY_OPT_IN_MARKER}, ` +
+    `spawn it with ${VERBATIM_SPAWN_REQUIREMENT} and relay its finalText verbatim with ${VERBATIM_FINAL_TEXT_CONSTRAINTS}; ` +
+    "preserve Sources sections and citations exactly. " +
+    "Custom agents without that declaration keep the default delegation behavior."
+  );
+}
+
+export function customAgentVerbatimDescriptionLead() {
+  return (
+    `Explicit custom agent with ${VERBATIM_RELAY_OPT_IN_MARKER}: ` +
+    `callers must use ${VERBATIM_SPAWN_REQUIREMENT} and relay its result verbatim`
+  );
+}
+
+export function adapterCallerSpawnGuidance(clientLabel) {
+  return (
+    `Callers must spawn this explicit custom ${clientLabel} agent with ${VERBATIM_SPAWN_REQUIREMENT} ` +
+    "and must relay your result verbatim; this is caller guidance and cannot enforce host spawn behavior."
+  );
+}
+
+export function adapterHardCompletionGuidance() {
+  return (
+    `After the orchestration completes, return its single text output verbatim with ${VERBATIM_FINAL_TEXT_CONSTRAINTS}. ` +
+    "A successful output is result.finalText exactly. A failure output preserves the durable runId, output, and error."
+  );
+}
+
+export function adapterSoftCompletionGuidance() {
+  return (
+    "After the orchestration completes, return its single text output as the answer. " +
+    "A successful output is result.finalText. A failure output preserves the durable runId, output, and error. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}
+
+export function claudeHardCompletionGuidance() {
+  return (
+    `When it succeeds, return result.finalText exactly with ${VERBATIM_FINAL_TEXT_CONSTRAINTS}. ` +
+    "When it fails, return the durable runId, preserved output, and error. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}
+
+export function claudeSoftCompletionGuidance() {
+  return (
+    "When it succeeds, return result.finalText faithfully as the answer. " +
+    "When it fails, return the durable runId, preserved output, and error. " +
+    "Never invent or independently synthesize a replacement result."
+  );
+}