svamp-cli 0.2.342 → 0.2.346

package/bin/skills/artifact/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: artifact
-version: 1.3.0
+version: 1.3.1
 description: Embed a rendered HTML file or live URL inline in chat via a single self-closing `<artifact src="..." />` tag — the Svamp client renders it as a sandboxed iframe with modes for inline, card, bare, and immersive.
 tags:
   - svamp

package/bin/skills/crew/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: crew
-version: 0.3.0
+version: 0.3.2
 description: Coordinate work as a lead delegating features to managed worktree children — spawn a child per feature on its own branch, run it as a loop until done, and pull finished work back to the base branch with merge-and-close. Use when one session should run a project and farm out features instead of piling many sessions on one working tree.
 ---
 
@@ -25,6 +25,10 @@ svamp feature start "<brief>" [--oracle "<test cmd>"] [--base <branch>] [--actio
                              [--issue <id>] [--max N] [--model <id>]
         # (lead) create a worktree child on a new branch, run it as a loop until done
         # (oracle → parent verdict), and brief it. Prints the child id.
+        # --action nudge|block: how the lead learns the child reported or finished.
+        #   nudge (default) = normal urgency, the lead sees it on its next idle turn;
+        #   block = urgent, which WAKES the lead. Use block for a child whose result
+        #   gates your next step; nudge for one you will collect when convenient.
         # --issue <id> links the child to an existing backlog issue: its verdict routes
         #   ONTO that issue. This is the seam that joins crew to the backlog the loop
         #   oracle (`svamp issue pending`) reads — without it the child's result is
@@ -65,6 +69,12 @@ You coordinate the project. Keep your own working tree (the base branch, e.g. `m
   branch into the base, removes the worktree, and archives the child. On a conflict or a dirty
   worktree the merge is **deferred to rework** (the child is re-woken with guidance and left
   alive — un-merged work is never destroyed); help it resolve, then merge again.
+- **A merge can also HARD-fail.** When the failure is not something the child can fix by editing
+  (e.g. the base tree is on the wrong branch or is dirty), `feature merge` exits 1 and sends the
+  child `<crew-blocked>` instead of `<crew-rework>`. The child is told to STOP and hold; it will
+  not retry. Resolving it is **yours or the operator's** — fix the blocker in the base tree, then
+  re-run `svamp feature merge <child-id>`. A blocked child left unattended is idle, not working,
+  so do not wait for it to report again.
 - **Nudge stalled children.** If `feature list` shows a child idle with committed, ahead-of-base
   work that hasn't been reported done, send `svamp session inbox send <child> "status?"` (or
   `feature report`-style ping) to move it along.
@@ -81,8 +91,16 @@ brief (and your loop's "until" criteria) is injected each turn.
   run `svamp feature done --summary "<what changed>"`. This sends a merge-request to your lead.
 - **Do not merge your own branch or remove your own worktree** — the lead does the merge-back so
   the base tree isn't corrupted. After the lead merges, your worktree is removed and you are
-  archived. If you get a `<crew-freeze>` message, stop editing immediately. If you get a
-  `<crew-rework>` message, address the guidance and run `svamp feature done` again.
+  archived. Three control messages can arrive from your lead — they look similar and mean
+  different things, so read the tag:
+  - `<crew-freeze>` — stop editing immediately.
+  - `<crew-rework>` — the merge was **deferred**; address the guidance and run
+    `svamp feature done` again.
+  - `<crew-blocked>` — the merge **hard-failed**. "Stop editing and hold — do not keep working.
+    Once the blocker is resolved, the lead can retry `svamp feature merge`." Do **not** run
+    `svamp feature done` again: nothing you can do from here changes the outcome, and re-sending
+    a merge-request into a hard-failed state just burns loop turns toward the cost ceiling. Hold
+    until the lead retries the merge. Your un-merged work is preserved.
 
 ## Standalone (no-worktree) children — managing a fleet of folders
 

package/dist/DefaultTransport-vfp78fug.mjs

@@ -0,0 +1,47 @@
+const DEFAULT_TIMEOUTS = {
+  init: 6e4,
+  toolCall: 12e4,
+  think: 3e4
+};
+class DefaultTransport {
+  agentName;
+  constructor(agentName = "generic-acp") {
+    this.agentName = agentName;
+  }
+  getInitTimeout() {
+    return DEFAULT_TIMEOUTS.init;
+  }
+  filterStdoutLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) return null;
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (typeof parsed !== "object" || parsed === null) return null;
+      return line;
+    } catch {
+      return null;
+    }
+  }
+  handleStderr(_text, _context) {
+    return { message: null };
+  }
+  getToolPatterns() {
+    return [];
+  }
+  isInvestigationTool(_toolCallId, _toolKind) {
+    return false;
+  }
+  getToolCallTimeout(_toolCallId, toolKind) {
+    if (toolKind === "think") return DEFAULT_TIMEOUTS.think;
+    return DEFAULT_TIMEOUTS.toolCall;
+  }
+  extractToolNameFromId(_toolCallId) {
+    return null;
+  }
+  determineToolName(toolName, _toolCallId, _input, _context) {
+    return toolName;
+  }
+}
+
+export { DefaultTransport };

package/dist/GeminiTransport-3OkhtFRO.mjs

@@ -0,0 +1,130 @@
+const GEMINI_TIMEOUTS = {
+  init: 12e4,
+  toolCall: 12e4,
+  investigation: 6e5,
+  think: 3e4,
+  idle: 500
+};
+const GEMINI_TOOL_PATTERNS = [
+  {
+    name: "change_title",
+    patterns: ["change_title", "change-title", "svamp__change_title", "mcp__svamp__change_title"],
+    inputFields: ["title"],
+    emptyInputDefault: true
+  },
+  {
+    name: "set_session_link",
+    patterns: ["set_session_link", "set-session-link", "svamp__set_session_link", "mcp__svamp__set_session_link"],
+    inputFields: ["url"]
+  },
+  {
+    name: "save_memory",
+    patterns: ["save_memory", "save-memory"],
+    inputFields: ["memory", "content"]
+  },
+  {
+    name: "think",
+    patterns: ["think"],
+    inputFields: ["thought", "thinking"]
+  }
+];
+const AVAILABLE_MODELS = [
+  "gemini-2.5-pro",
+  "gemini-2.5-flash",
+  "gemini-2.5-flash-lite"
+];
+class GeminiTransport {
+  agentName = "gemini";
+  getInitTimeout() {
+    return GEMINI_TIMEOUTS.init;
+  }
+  filterStdoutLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) return null;
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (typeof parsed !== "object" || parsed === null) return null;
+      return line;
+    } catch {
+      return null;
+    }
+  }
+  handleStderr(text, context) {
+    const trimmed = text.trim();
+    if (!trimmed) return { message: null, suppress: true };
+    if (trimmed.includes("status 429") || trimmed.includes('code":429') || trimmed.includes("rateLimitExceeded") || trimmed.includes("RESOURCE_EXHAUSTED")) {
+      return { message: null, suppress: false };
+    }
+    if (trimmed.includes("status 404") || trimmed.includes('code":404')) {
+      const msg = {
+        type: "status",
+        status: "error",
+        detail: `Model not found. Available models: ${AVAILABLE_MODELS.join(", ")}`
+      };
+      return { message: msg };
+    }
+    if (context.hasActiveInvestigation) {
+      const hasError = trimmed.includes("timeout") || trimmed.includes("Timeout") || trimmed.includes("failed") || trimmed.includes("Failed") || trimmed.includes("error") || trimmed.includes("Error");
+      if (hasError) {
+        return { message: null, suppress: false };
+      }
+    }
+    return { message: null };
+  }
+  getToolPatterns() {
+    return GEMINI_TOOL_PATTERNS;
+  }
+  isInvestigationTool(toolCallId, toolKind) {
+    const lowerId = toolCallId.toLowerCase();
+    return lowerId.includes("codebase_investigator") || lowerId.includes("investigator") || typeof toolKind === "string" && toolKind.includes("investigator");
+  }
+  getToolCallTimeout(toolCallId, toolKind) {
+    if (this.isInvestigationTool(toolCallId, toolKind)) return GEMINI_TIMEOUTS.investigation;
+    if (toolKind === "think") return GEMINI_TIMEOUTS.think;
+    return GEMINI_TIMEOUTS.toolCall;
+  }
+  getIdleTimeout() {
+    return GEMINI_TIMEOUTS.idle;
+  }
+  extractToolNameFromId(toolCallId) {
+    const lowerId = toolCallId.toLowerCase();
+    for (const toolPattern of GEMINI_TOOL_PATTERNS) {
+      for (const pattern of toolPattern.patterns) {
+        if (lowerId.includes(pattern.toLowerCase())) {
+          return toolPattern.name;
+        }
+      }
+    }
+    return null;
+  }
+  isEmptyInput(input) {
+    if (!input) return true;
+    if (Array.isArray(input)) return input.length === 0;
+    if (typeof input === "object") return Object.keys(input).length === 0;
+    return false;
+  }
+  determineToolName(toolName, toolCallId, input, _context) {
+    if (toolName !== "other" && toolName !== "Unknown tool") return toolName;
+    const idToolName = this.extractToolNameFromId(toolCallId);
+    if (idToolName) return idToolName;
+    if (input && typeof input === "object" && !Array.isArray(input)) {
+      const inputKeys = Object.keys(input);
+      for (const toolPattern of GEMINI_TOOL_PATTERNS) {
+        if (toolPattern.inputFields) {
+          const hasMatchingField = toolPattern.inputFields.some(
+            (field) => inputKeys.some((key) => key.toLowerCase() === field.toLowerCase())
+          );
+          if (hasMatchingField) return toolPattern.name;
+        }
+      }
+    }
+    if (this.isEmptyInput(input) && toolName === "other") {
+      const defaultTool = GEMINI_TOOL_PATTERNS.find((p) => p.emptyInputDefault);
+      if (defaultTool) return defaultTool.name;
+    }
+    return toolName;
+  }
+}
+
+export { GEMINI_TIMEOUTS, GeminiTransport };

package/dist/KimiTransport-D8n009Tr.mjs

@@ -0,0 +1,141 @@
+const KIMI_TIMEOUTS = {
+  init: 12e4,
+  toolCall: 12e4,
+  investigation: 6e5,
+  think: 3e4,
+  idle: 500
+};
+const KIMI_TOOL_PATTERNS = [
+  {
+    name: "change_title",
+    patterns: ["change_title", "change-title", "svamp__change_title", "mcp__svamp__change_title"],
+    inputFields: ["title"],
+    emptyInputDefault: true
+  },
+  {
+    name: "set_session_link",
+    patterns: ["set_session_link", "set-session-link", "svamp__set_session_link", "mcp__svamp__set_session_link"],
+    inputFields: ["url"]
+  },
+  {
+    name: "save_memory",
+    patterns: ["save_memory", "save-memory"],
+    inputFields: ["memory", "content"]
+  },
+  {
+    name: "think",
+    patterns: ["think"],
+    inputFields: ["thought", "thinking"]
+  }
+];
+const AVAILABLE_MODELS = [
+  "moonshotai/kimi-k2.5",
+  "moonshotai/kimi-k3",
+  "moonshotai/kimi-k2.7-code",
+  "moonshotai/kimi-k2-thinking",
+  "moonshotai/kimi-k2-turbo-preview",
+  "kimi-for-coding/kimi-for-coding"
+];
+class KimiTransport {
+  agentName = "kimi";
+  getInitTimeout() {
+    return KIMI_TIMEOUTS.init;
+  }
+  filterStdoutLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) return null;
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (typeof parsed !== "object" || parsed === null) return null;
+      return line;
+    } catch {
+      return null;
+    }
+  }
+  handleStderr(text, context) {
+    const trimmed = text.trim();
+    if (!trimmed) return { message: null, suppress: true };
+    if (trimmed.includes("no provider configured") || trimmed.includes("Authentication required") || trimmed.includes("Invalid Authentication") || trimmed.includes("authentication_error") || trimmed.includes("401")) {
+      const msg = {
+        type: "status",
+        status: "error",
+        detail: "Kimi has no valid provider configured. Run `svamp daemon kimi-auth use-moonshot <api-key>` (or `use-coding` / `set`) on this machine, then restart the daemon."
+      };
+      return { message: msg };
+    }
+    if (trimmed.includes("status 429") || trimmed.includes('code":429') || trimmed.includes("429") || trimmed.includes("rate limit") || trimmed.includes("RESOURCE_EXHAUSTED")) {
+      return { message: null, suppress: false };
+    }
+    if (trimmed.includes("status 404") || trimmed.includes('code":404') || trimmed.includes("model_not_found")) {
+      const msg = {
+        type: "status",
+        status: "error",
+        detail: `Model not found. Example Kimi models: ${AVAILABLE_MODELS.join(", ")}`
+      };
+      return { message: msg };
+    }
+    if (context.hasActiveInvestigation) {
+      const hasError = trimmed.includes("timeout") || trimmed.includes("Timeout") || trimmed.includes("failed") || trimmed.includes("Failed") || trimmed.includes("error") || trimmed.includes("Error");
+      if (hasError) {
+        return { message: null, suppress: false };
+      }
+    }
+    return { message: null };
+  }
+  getToolPatterns() {
+    return KIMI_TOOL_PATTERNS;
+  }
+  isInvestigationTool(toolCallId, toolKind) {
+    const lowerId = toolCallId.toLowerCase();
+    return lowerId.includes("codebase_investigator") || lowerId.includes("investigator") || typeof toolKind === "string" && toolKind.includes("investigator");
+  }
+  getToolCallTimeout(toolCallId, toolKind) {
+    if (this.isInvestigationTool(toolCallId, toolKind)) return KIMI_TIMEOUTS.investigation;
+    if (toolKind === "think") return KIMI_TIMEOUTS.think;
+    return KIMI_TIMEOUTS.toolCall;
+  }
+  getIdleTimeout() {
+    return KIMI_TIMEOUTS.idle;
+  }
+  extractToolNameFromId(toolCallId) {
+    const lowerId = toolCallId.toLowerCase();
+    for (const toolPattern of KIMI_TOOL_PATTERNS) {
+      for (const pattern of toolPattern.patterns) {
+        if (lowerId.includes(pattern.toLowerCase())) {
+          return toolPattern.name;
+        }
+      }
+    }
+    return null;
+  }
+  isEmptyInput(input) {
+    if (!input) return true;
+    if (Array.isArray(input)) return input.length === 0;
+    if (typeof input === "object") return Object.keys(input).length === 0;
+    return false;
+  }
+  determineToolName(toolName, toolCallId, input, _context) {
+    if (toolName !== "other" && toolName !== "Unknown tool") return toolName;
+    const idToolName = this.extractToolNameFromId(toolCallId);
+    if (idToolName) return idToolName;
+    if (input && typeof input === "object" && !Array.isArray(input)) {
+      const inputKeys = Object.keys(input);
+      for (const toolPattern of KIMI_TOOL_PATTERNS) {
+        if (toolPattern.inputFields) {
+          const hasMatchingField = toolPattern.inputFields.some(
+            (field) => inputKeys.some((key) => key.toLowerCase() === field.toLowerCase())
+          );
+          if (hasMatchingField) return toolPattern.name;
+        }
+      }
+    }
+    if (this.isEmptyInput(input) && toolName === "other") {
+      const defaultTool = KIMI_TOOL_PATTERNS.find((p) => p.emptyInputDefault);
+      if (defaultTool) return defaultTool.name;
+    }
+    return toolName;
+  }
+}
+
+export { KIMI_TIMEOUTS, KimiTransport };

package/dist/acpAgentConfig-CObOPlA8.mjs

@@ -0,0 +1,48 @@
+const KNOWN_ACP_AGENTS = {
+  gemini: { command: "gemini", args: ["--experimental-acp"] },
+  kimi: { command: "kimi", args: ["acp"] }
+};
+const KNOWN_CODEX_AGENTS = {
+  codex: { command: "codex", args: ["app-server", "--listen", "stdio://"] }
+};
+function resolveAcpAgentConfig(cliArgs) {
+  if (cliArgs.length === 0) {
+    throw new Error("Usage: svamp agent <agent-name> or svamp agent -- <command> [args]");
+  }
+  if (cliArgs[0] === "--") {
+    const command = cliArgs[1];
+    if (!command) {
+      throw new Error('Missing command after "--". Usage: svamp agent -- <command> [args]');
+    }
+    return {
+      agentName: command,
+      command,
+      args: cliArgs.slice(2)
+    };
+  }
+  const agentName = cliArgs[0];
+  const knownAcp = KNOWN_ACP_AGENTS[agentName];
+  if (knownAcp) {
+    const passthroughArgs = cliArgs.slice(1).filter(Boolean);
+    return {
+      agentName,
+      command: knownAcp.command,
+      args: [...knownAcp.args, ...passthroughArgs]
+    };
+  }
+  const knownCodex = KNOWN_CODEX_AGENTS[agentName];
+  if (knownCodex) {
+    return {
+      agentName,
+      command: knownCodex.command,
+      args: [...knownCodex.args, ...cliArgs.slice(1)]
+    };
+  }
+  return {
+    agentName,
+    command: agentName,
+    args: cliArgs.slice(1)
+  };
+}
+
+export { KNOWN_ACP_AGENTS, KNOWN_CODEX_AGENTS, resolveAcpAgentConfig };