@desplega.ai/agent-swarm 1.89.0 → 1.91.0

package/src/scripts-runtime/types/stdlib.d.ts

@@ -47,6 +47,7 @@ declare module "swarm-sdk" {
   }
 
   export interface SwarmSdk {
+    // --- memory ---
     memory_search(args: {
       query: string;
       scope?: "all" | "agent" | "swarm";
@@ -55,9 +56,12 @@ declare module "swarm-sdk" {
     }): Promise<unknown>;
     memory_get(args: { memoryId: string }): Promise<unknown>;
     memory_rate(args: { id: string; useful: boolean; note?: string }): Promise<unknown>;
+    // --- tasks ---
     task_list(args?: Record<string, unknown>): Promise<unknown>;
     task_get(args: { taskId: string }): Promise<unknown>;
     task_storeProgress(args: Record<string, unknown>): Promise<unknown>;
+    task_poll(args?: Record<string, unknown>): Promise<unknown>;
+    // --- kv ---
     kv_get(args: { key: string; namespace?: string }): Promise<unknown>;
     kv_set(args: {
       key: string;
@@ -69,8 +73,11 @@ declare module "swarm-sdk" {
     kv_del(args: { key: string; namespace?: string }): Promise<unknown>;
     kv_incr(args: { key: string; by?: number; namespace?: string }): Promise<unknown>;
     kv_list(args?: { prefix?: string; namespace?: string; limit?: number }): Promise<unknown>;
+    // --- repos ---
     repo_list(args?: Record<string, unknown>): Promise<unknown>;
+    // --- schedules ---
     schedule_list(args?: Record<string, unknown>): Promise<unknown>;
+    // --- scripts ---
     script_search(args: { query?: string; scope?: ScriptScope; limit?: number }): Promise<unknown>;
     script_run(args: {
       name?: string;
@@ -79,7 +86,227 @@ declare module "swarm-sdk" {
       intent?: string;
       scope?: ScriptScope;
       fsMode?: ScriptFsMode;
+      idempotencyKey?: string;
     }): Promise<unknown>;
+    // --- swarm / agent ---
+    swarm_get(args?: { includeFull?: boolean }): Promise<unknown>;
+    agent_info(args?: Record<string, unknown>): Promise<unknown>;
+    metrics_get(args?: Record<string, unknown>): Promise<unknown>;
+    user_resolve(args?: {
+      kind?: string;
+      externalId?: string;
+      email?: string;
+      userId?: string;
+    }): Promise<unknown>;
+    db_query(args: { sql: string; params?: unknown[] }): Promise<unknown>;
+    // --- config ---
+    config_get(args?: {
+      agentId?: string;
+      repoId?: string;
+      key?: string;
+      includeSecrets?: boolean;
+    }): Promise<unknown>;
+    config_list(args?: {
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      key?: string;
+      includeSecrets?: boolean;
+    }): Promise<unknown>;
+    // --- slack ---
+    slack_read(args?: {
+      inboxMessageId?: string;
+      taskId?: string;
+      channelId?: string;
+      threadTs?: string;
+      limit?: number;
+      includeFiles?: boolean;
+    }): Promise<unknown>;
+    slack_listChannels(args?: {
+      types?: Array<"public" | "private" | "dm" | "mpim">;
+      limit?: number;
+    }): Promise<unknown>;
+    // --- messaging ---
+    message_read(args?: {
+      channel?: string;
+      limit?: number;
+      since?: string;
+      unreadOnly?: boolean;
+      mentionsOnly?: boolean;
+      markAsRead?: boolean;
+    }): Promise<unknown>;
+    // --- services ---
+    service_list(args?: {
+      agentId?: string;
+      name?: string;
+      status?: "starting" | "healthy" | "unhealthy" | "stopped";
+      includeOwn?: boolean;
+    }): Promise<unknown>;
+    // --- context / profiles ---
+    context_history(args?: {
+      agentId?: string;
+      field?: "soulMd" | "identityMd" | "toolsMd" | "claudeMd" | "setupScript";
+      limit?: number;
+    }): Promise<unknown>;
+    context_diff(args: { versionId: string; compareToVersionId?: string }): Promise<unknown>;
+    // --- workflows ---
+    workflow_list(args?: { enabled?: boolean; includeFull?: boolean }): Promise<unknown>;
+    workflow_get(args: { id: string }): Promise<unknown>;
+    workflow_listRuns(args: {
+      workflowId: string;
+      status?: "running" | "waiting" | "completed" | "failed" | "skipped" | "cancelled";
+    }): Promise<unknown>;
+    workflow_getRun(args: { id: string }): Promise<unknown>;
+    // --- prompt templates ---
+    prompt_list(args?: {
+      eventType?: string;
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      isDefault?: boolean;
+    }): Promise<unknown>;
+    prompt_get(args: { id: string }): Promise<unknown>;
+    // --- tracker ---
+    tracker_status(args?: Record<string, unknown>): Promise<unknown>;
+    tracker_syncStatus(args?: Record<string, unknown>): Promise<unknown>;
+    tracker_linkTask(args: {
+      taskId: string;
+      externalId: string;
+      provider?: string;
+    }): Promise<unknown>;
+    tracker_unlink(args: { taskId: string }): Promise<unknown>;
+    tracker_mapAgent(args: {
+      agentId: string;
+      externalId: string;
+      provider?: string;
+    }): Promise<unknown>;
+
+    // --- write: memory ---
+    memory_delete(args: { id: string }): Promise<unknown>;
+    inject_learning(args: {
+      content: string;
+      name?: string;
+      scope?: "agent" | "swarm";
+      source?: string;
+      tags?: string[];
+    }): Promise<unknown>;
+
+    // --- write: tasks ---
+    task_send(args: Record<string, unknown>): Promise<unknown>;
+    task_cancel(args: { taskId: string }): Promise<unknown>;
+    task_action(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: config ---
+    config_set(args: {
+      key: string;
+      value: unknown;
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      isSecret?: boolean;
+    }): Promise<unknown>;
+    config_delete(args: { id: string }): Promise<unknown>;
+
+    // --- write: slack ---
+    slack_post(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
+    slack_reply(args: {
+      channelId?: string;
+      threadTs?: string;
+      message: string;
+      taskId?: string;
+    }): Promise<unknown>;
+    slack_startThread(args: { channelId: string; message: string }): Promise<unknown>;
+    slack_uploadFile(args: Record<string, unknown>): Promise<unknown>;
+    slack_downloadFile(args: { url: string }): Promise<unknown>;
+
+    // --- write: messaging (internal) ---
+    message_post(args: { channel?: string; content: string; to?: string }): Promise<unknown>;
+
+    // --- write: profiles ---
+    profile_update(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: services ---
+    service_register(args: Record<string, unknown>): Promise<unknown>;
+    service_unregister(args: { name: string }): Promise<unknown>;
+    service_updateStatus(args: {
+      name: string;
+      status: "starting" | "healthy" | "unhealthy" | "stopped";
+    }): Promise<unknown>;
+
+    // --- write: schedules ---
+    schedule_create(args: Record<string, unknown>): Promise<unknown>;
+    schedule_update(args: Record<string, unknown>): Promise<unknown>;
+    schedule_delete(args: { id: string }): Promise<unknown>;
+    schedule_runNow(args: { id: string }): Promise<unknown>;
+
+    // --- write: workflows ---
+    workflow_create(args: Record<string, unknown>): Promise<unknown>;
+    workflow_update(args: Record<string, unknown>): Promise<unknown>;
+    workflow_patch(args: Record<string, unknown>): Promise<unknown>;
+    workflow_patchNode(args: Record<string, unknown>): Promise<unknown>;
+    workflow_delete(args: { id: string }): Promise<unknown>;
+    workflow_trigger(args: { id: string; input?: Record<string, unknown> }): Promise<unknown>;
+    workflow_retryRun(args: { id: string }): Promise<unknown>;
+    workflow_cancelRun(args: { id: string }): Promise<unknown>;
+
+    // --- write: prompt templates ---
+    prompt_set(args: Record<string, unknown>): Promise<unknown>;
+    prompt_delete(args: { id: string }): Promise<unknown>;
+    prompt_preview(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: scripts ---
+    script_upsert(args: {
+      name: string;
+      source: string;
+      description?: string;
+      intent?: string;
+      scope?: ScriptScope;
+      fsMode?: ScriptFsMode;
+    }): Promise<unknown>;
+    script_delete(args: { name: string; scope?: ScriptScope }): Promise<unknown>;
+    script_queryTypes(args: { name: string; scope?: ScriptScope }): Promise<unknown>;
+
+    // --- write: repos ---
+    repo_update(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: agent ---
+    agent_join(args: {
+      name: string;
+      role?: string;
+      description?: string;
+      capabilities?: string[];
+      requestedId?: string;
+      lead?: boolean;
+    }): Promise<unknown>;
+    user_manage(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- skills ---
+    skill_list(args?: {
+      scope?: string;
+      scopeId?: string;
+      includeBuiltin?: boolean;
+    }): Promise<unknown>;
+    skill_get(args: { id: string }): Promise<unknown>;
+    skill_search(args: { query: string; limit?: number }): Promise<unknown>;
+    skill_create(args: Record<string, unknown>): Promise<unknown>;
+    skill_update(args: Record<string, unknown>): Promise<unknown>;
+    skill_delete(args: { id: string }): Promise<unknown>;
+    skill_install(args: Record<string, unknown>): Promise<unknown>;
+    skill_uninstall(args: Record<string, unknown>): Promise<unknown>;
+    skill_publish(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- mcp servers ---
+    mcpServer_list(args?: Record<string, unknown>): Promise<unknown>;
+    mcpServer_get(args: { id: string }): Promise<unknown>;
+    mcpServer_create(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_update(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_delete(args: { id: string }): Promise<unknown>;
+    mcpServer_install(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_uninstall(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- pages & metrics ---
+    page_create(args: Record<string, unknown>): Promise<unknown>;
+    metric_create(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- human input ---
+    request_humanInput(args: Record<string, unknown>): Promise<unknown>;
   }
 
   export interface ScriptStdlib {

package/src/scripts-runtime/types/swarm-sdk.d.ts

@@ -29,6 +29,7 @@ declare module "swarm-sdk" {
   }
 
   export interface SwarmSdk {
+    // --- memory ---
     memory_search(args: {
       query: string;
       scope?: "all" | "agent" | "swarm";
@@ -37,9 +38,12 @@ declare module "swarm-sdk" {
     }): Promise<unknown>;
     memory_get(args: { memoryId: string }): Promise<unknown>;
     memory_rate(args: { id: string; useful: boolean; note?: string }): Promise<unknown>;
+    // --- tasks ---
     task_list(args?: Record<string, unknown>): Promise<unknown>;
     task_get(args: { taskId: string }): Promise<unknown>;
     task_storeProgress(args: Record<string, unknown>): Promise<unknown>;
+    task_poll(args?: Record<string, unknown>): Promise<unknown>;
+    // --- kv ---
     kv_get(args: { key: string; namespace?: string }): Promise<unknown>;
     kv_set(args: {
       key: string;
@@ -51,8 +55,11 @@ declare module "swarm-sdk" {
     kv_del(args: { key: string; namespace?: string }): Promise<unknown>;
     kv_incr(args: { key: string; by?: number; namespace?: string }): Promise<unknown>;
     kv_list(args?: { prefix?: string; namespace?: string; limit?: number }): Promise<unknown>;
+    // --- repos ---
     repo_list(args?: Record<string, unknown>): Promise<unknown>;
+    // --- schedules ---
     schedule_list(args?: Record<string, unknown>): Promise<unknown>;
+    // --- scripts ---
     script_search(args: { query?: string; scope?: ScriptScope; limit?: number }): Promise<unknown>;
     script_run(args: {
       name?: string;
@@ -61,7 +68,227 @@ declare module "swarm-sdk" {
       intent?: string;
       scope?: ScriptScope;
       fsMode?: ScriptFsMode;
+      idempotencyKey?: string;
     }): Promise<unknown>;
+    // --- swarm / agent ---
+    swarm_get(args?: { includeFull?: boolean }): Promise<unknown>;
+    agent_info(args?: Record<string, unknown>): Promise<unknown>;
+    metrics_get(args?: Record<string, unknown>): Promise<unknown>;
+    user_resolve(args?: {
+      kind?: string;
+      externalId?: string;
+      email?: string;
+      userId?: string;
+    }): Promise<unknown>;
+    db_query(args: { sql: string; params?: unknown[] }): Promise<unknown>;
+    // --- config ---
+    config_get(args?: {
+      agentId?: string;
+      repoId?: string;
+      key?: string;
+      includeSecrets?: boolean;
+    }): Promise<unknown>;
+    config_list(args?: {
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      key?: string;
+      includeSecrets?: boolean;
+    }): Promise<unknown>;
+    // --- slack ---
+    slack_read(args?: {
+      inboxMessageId?: string;
+      taskId?: string;
+      channelId?: string;
+      threadTs?: string;
+      limit?: number;
+      includeFiles?: boolean;
+    }): Promise<unknown>;
+    slack_listChannels(args?: {
+      types?: Array<"public" | "private" | "dm" | "mpim">;
+      limit?: number;
+    }): Promise<unknown>;
+    // --- messaging ---
+    message_read(args?: {
+      channel?: string;
+      limit?: number;
+      since?: string;
+      unreadOnly?: boolean;
+      mentionsOnly?: boolean;
+      markAsRead?: boolean;
+    }): Promise<unknown>;
+    // --- services ---
+    service_list(args?: {
+      agentId?: string;
+      name?: string;
+      status?: "starting" | "healthy" | "unhealthy" | "stopped";
+      includeOwn?: boolean;
+    }): Promise<unknown>;
+    // --- context / profiles ---
+    context_history(args?: {
+      agentId?: string;
+      field?: "soulMd" | "identityMd" | "toolsMd" | "claudeMd" | "setupScript";
+      limit?: number;
+    }): Promise<unknown>;
+    context_diff(args: { versionId: string; compareToVersionId?: string }): Promise<unknown>;
+    // --- workflows ---
+    workflow_list(args?: { enabled?: boolean; includeFull?: boolean }): Promise<unknown>;
+    workflow_get(args: { id: string }): Promise<unknown>;
+    workflow_listRuns(args: {
+      workflowId: string;
+      status?: "running" | "waiting" | "completed" | "failed" | "skipped" | "cancelled";
+    }): Promise<unknown>;
+    workflow_getRun(args: { id: string }): Promise<unknown>;
+    // --- prompt templates ---
+    prompt_list(args?: {
+      eventType?: string;
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      isDefault?: boolean;
+    }): Promise<unknown>;
+    prompt_get(args: { id: string }): Promise<unknown>;
+    // --- tracker ---
+    tracker_status(args?: Record<string, unknown>): Promise<unknown>;
+    tracker_syncStatus(args?: Record<string, unknown>): Promise<unknown>;
+    tracker_linkTask(args: {
+      taskId: string;
+      externalId: string;
+      provider?: string;
+    }): Promise<unknown>;
+    tracker_unlink(args: { taskId: string }): Promise<unknown>;
+    tracker_mapAgent(args: {
+      agentId: string;
+      externalId: string;
+      provider?: string;
+    }): Promise<unknown>;
+
+    // --- write: memory ---
+    memory_delete(args: { id: string }): Promise<unknown>;
+    inject_learning(args: {
+      content: string;
+      name?: string;
+      scope?: "agent" | "swarm";
+      source?: string;
+      tags?: string[];
+    }): Promise<unknown>;
+
+    // --- write: tasks ---
+    task_send(args: Record<string, unknown>): Promise<unknown>;
+    task_cancel(args: { taskId: string }): Promise<unknown>;
+    task_action(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: config ---
+    config_set(args: {
+      key: string;
+      value: unknown;
+      scope?: "global" | "agent" | "repo";
+      scopeId?: string;
+      isSecret?: boolean;
+    }): Promise<unknown>;
+    config_delete(args: { id: string }): Promise<unknown>;
+
+    // --- write: slack ---
+    slack_post(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
+    slack_reply(args: {
+      channelId?: string;
+      threadTs?: string;
+      message: string;
+      taskId?: string;
+    }): Promise<unknown>;
+    slack_startThread(args: { channelId: string; message: string }): Promise<unknown>;
+    slack_uploadFile(args: Record<string, unknown>): Promise<unknown>;
+    slack_downloadFile(args: { url: string }): Promise<unknown>;
+
+    // --- write: messaging (internal) ---
+    message_post(args: { channel?: string; content: string; to?: string }): Promise<unknown>;
+
+    // --- write: profiles ---
+    profile_update(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: services ---
+    service_register(args: Record<string, unknown>): Promise<unknown>;
+    service_unregister(args: { name: string }): Promise<unknown>;
+    service_updateStatus(args: {
+      name: string;
+      status: "starting" | "healthy" | "unhealthy" | "stopped";
+    }): Promise<unknown>;
+
+    // --- write: schedules ---
+    schedule_create(args: Record<string, unknown>): Promise<unknown>;
+    schedule_update(args: Record<string, unknown>): Promise<unknown>;
+    schedule_delete(args: { id: string }): Promise<unknown>;
+    schedule_runNow(args: { id: string }): Promise<unknown>;
+
+    // --- write: workflows ---
+    workflow_create(args: Record<string, unknown>): Promise<unknown>;
+    workflow_update(args: Record<string, unknown>): Promise<unknown>;
+    workflow_patch(args: Record<string, unknown>): Promise<unknown>;
+    workflow_patchNode(args: Record<string, unknown>): Promise<unknown>;
+    workflow_delete(args: { id: string }): Promise<unknown>;
+    workflow_trigger(args: { id: string; input?: Record<string, unknown> }): Promise<unknown>;
+    workflow_retryRun(args: { id: string }): Promise<unknown>;
+    workflow_cancelRun(args: { id: string }): Promise<unknown>;
+
+    // --- write: prompt templates ---
+    prompt_set(args: Record<string, unknown>): Promise<unknown>;
+    prompt_delete(args: { id: string }): Promise<unknown>;
+    prompt_preview(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: scripts ---
+    script_upsert(args: {
+      name: string;
+      source: string;
+      description?: string;
+      intent?: string;
+      scope?: ScriptScope;
+      fsMode?: ScriptFsMode;
+    }): Promise<unknown>;
+    script_delete(args: { name: string; scope?: ScriptScope }): Promise<unknown>;
+    script_queryTypes(args: { name: string; scope?: ScriptScope }): Promise<unknown>;
+
+    // --- write: repos ---
+    repo_update(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- write: agent ---
+    agent_join(args: {
+      name: string;
+      role?: string;
+      description?: string;
+      capabilities?: string[];
+      requestedId?: string;
+      lead?: boolean;
+    }): Promise<unknown>;
+    user_manage(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- skills ---
+    skill_list(args?: {
+      scope?: string;
+      scopeId?: string;
+      includeBuiltin?: boolean;
+    }): Promise<unknown>;
+    skill_get(args: { id: string }): Promise<unknown>;
+    skill_search(args: { query: string; limit?: number }): Promise<unknown>;
+    skill_create(args: Record<string, unknown>): Promise<unknown>;
+    skill_update(args: Record<string, unknown>): Promise<unknown>;
+    skill_delete(args: { id: string }): Promise<unknown>;
+    skill_install(args: Record<string, unknown>): Promise<unknown>;
+    skill_uninstall(args: Record<string, unknown>): Promise<unknown>;
+    skill_publish(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- mcp servers ---
+    mcpServer_list(args?: Record<string, unknown>): Promise<unknown>;
+    mcpServer_get(args: { id: string }): Promise<unknown>;
+    mcpServer_create(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_update(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_delete(args: { id: string }): Promise<unknown>;
+    mcpServer_install(args: Record<string, unknown>): Promise<unknown>;
+    mcpServer_uninstall(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- pages & metrics ---
+    page_create(args: Record<string, unknown>): Promise<unknown>;
+    metric_create(args: Record<string, unknown>): Promise<unknown>;
+
+    // --- human input ---
+    request_humanInput(args: Record<string, unknown>): Promise<unknown>;
   }
 
   export interface ScriptStdlib {

package/src/tasks/worker-follow-up.ts

@@ -22,6 +22,20 @@ export const WORKER_LIVENESS_WINDOW_SECONDS = Number(
   process.env.WORKER_LIVENESS_WINDOW_SECONDS || "30",
 );
 
+export const RESUME_GENERATION_TAG_PREFIX = "resume-generation:";
+
+export function getResumeGeneration(task: Pick<AgentTask, "tags">): number {
+  const tag = task.tags.find((value) => value.startsWith(RESUME_GENERATION_TAG_PREFIX));
+  if (!tag) return 0;
+
+  const parsed = Number(tag.slice(RESUME_GENERATION_TAG_PREFIX.length));
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+
+export function getNextResumeGeneration(parent: Pick<AgentTask, "tags">): number {
+  return getResumeGeneration(parent) + 1;
+}
+
 function attachmentPointer(a: TaskAttachment): string {
   switch (a.kind) {
     case "url":
@@ -205,7 +219,11 @@ export function createResumeFollowUp(args: {
   ].join("\n");
 
   const priority = Math.min(100, (parent.priority ?? 50) + 10);
-  const tags = ["auto-resume", `reason:${args.reason}`];
+  const tags = [
+    "auto-resume",
+    `reason:${args.reason}`,
+    `${RESUME_GENERATION_TAG_PREFIX}${getNextResumeGeneration(parent)}`,
+  ];
 
   // Identity-shaped fields (dir, VCS provider/repo/number/url/etc.,
   // outputSchema, slack channel/thread/user, agentmail, mention, contextKey,

package/src/tests/claude-adapter-otel.test.ts

@@ -15,7 +15,11 @@
 
 import { afterEach, beforeEach, describe, expect, spyOn, test } from "bun:test";
 import { type Span, trace } from "@opentelemetry/api";
-import { buildClaudeCodeOtelEnv, ClaudeAdapter } from "../providers/claude-adapter";
+import {
+  buildClaudeCodeOtelEnv,
+  buildClaudeCodeRuntimeEnv,
+  ClaudeAdapter,
+} from "../providers/claude-adapter";
 import type { ProviderSessionConfig } from "../providers/types";
 
 // Example IDs from the task — trace af2c8371…, span adff4f24… (the orphaned
@@ -136,6 +140,51 @@ describe("buildClaudeCodeOtelEnv — gate on", () => {
   });
 });
 
+describe("buildClaudeCodeRuntimeEnv", () => {
+  test("sets memory/privacy defaults for ephemeral Claude Code sessions", () => {
+    const env = buildClaudeCodeRuntimeEnv({});
+
+    expect(env.ENABLE_TOOL_SEARCH).toBe("true");
+    expect(env.CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING).toBe("1");
+    expect(env.CLAUDE_CODE_SKIP_PROMPT_HISTORY).toBe("1");
+    expect(env.CLAUDE_CODE_DISABLE_ATTACHMENTS).toBe("1");
+    expect(env.DISABLE_FEEDBACK_COMMAND).toBe("1");
+    expect(env.DISABLE_BUG_COMMAND).toBe("1");
+  });
+
+  test("always disables Claude Code Statsig/DNT telemetry", () => {
+    const env = buildClaudeCodeRuntimeEnv({});
+
+    expect(env.DISABLE_TELEMETRY).toBe("1");
+    expect(env.DO_NOT_TRACK).toBe("1");
+  });
+
+  test("keeps Claude Code Statsig/DNT opt-out separate from OTel config", () => {
+    for (const sourceEnv of [
+      { CLAUDE_CODE_ENABLE_TELEMETRY: "1" },
+      { CLAUDE_CODE_ENABLE_TELEMETRY: "true" },
+      { OTEL_EXPORTER_OTLP_ENDPOINT: "https://otel.example.test" },
+      { OTEL_TRACES_EXPORTER: "otlp" },
+      { OTEL_METRICS_EXPORTER: "otlp" },
+      { OTEL_LOGS_EXPORTER: "otlp" },
+    ]) {
+      const env = buildClaudeCodeRuntimeEnv(sourceEnv);
+      expect(env.DISABLE_TELEMETRY).toBe("1");
+      expect(env.DO_NOT_TRACK).toBe("1");
+    }
+  });
+
+  test("ignores empty OTel env values for runtime defaults", () => {
+    const env = buildClaudeCodeRuntimeEnv({
+      OTEL_EXPORTER_OTLP_ENDPOINT: "",
+      CLAUDE_CODE_ENABLE_TELEMETRY: "0",
+    });
+
+    expect(env.DISABLE_TELEMETRY).toBe("1");
+    expect(env.DO_NOT_TRACK).toBe("1");
+  });
+});
+
 // ─── Spawn integration through ClaudeAdapter.createSession ────────────────────
 
 /** Fake Bun.Subprocess — exits cleanly with no output. */
@@ -222,4 +271,39 @@ describe("ClaudeSession spawn env — SWARM_ENABLE_CLAUDE_CODE_OTEL", () => {
     expect(env?.ENABLE_PROMPT_CACHING_1H).toBe("1");
     expect(env?.CLAUDE_CODE_OAUTH_TOKEN).toBe("test-token");
   });
+
+  test("spawn env carries Claude Code runtime guardrails", async () => {
+    const adapter = new ClaudeAdapter();
+    await adapter.createSession(makeConfig({ env: { CLAUDE_CODE_OAUTH_TOKEN: "test-token" } }));
+
+    expect(spawnedEnvs).toHaveLength(1);
+    const env = spawnedEnvs[0];
+    expect(env?.ENABLE_TOOL_SEARCH).toBe("true");
+    expect(env?.CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING).toBe("1");
+    expect(env?.CLAUDE_CODE_SKIP_PROMPT_HISTORY).toBe("1");
+    expect(env?.CLAUDE_CODE_DISABLE_ATTACHMENTS).toBe("1");
+    expect(env?.DISABLE_FEEDBACK_COMMAND).toBe("1");
+    expect(env?.DISABLE_BUG_COMMAND).toBe("1");
+    expect(env?.DISABLE_TELEMETRY).toBe("1");
+    expect(env?.DO_NOT_TRACK).toBe("1");
+    expect(env?.CLAUDE_CODE_DISABLE_THINKING).toBeUndefined();
+  });
+
+  test("spawn env keeps Statsig/DNT opt-out even when OTel is configured", async () => {
+    const adapter = new ClaudeAdapter();
+    await adapter.createSession(
+      makeConfig({
+        env: {
+          CLAUDE_CODE_OAUTH_TOKEN: "test-token",
+          CLAUDE_CODE_ENABLE_TELEMETRY: "1",
+          OTEL_EXPORTER_OTLP_ENDPOINT: "https://otel.example.test",
+        },
+      }),
+    );
+
+    expect(spawnedEnvs).toHaveLength(1);
+    const env = spawnedEnvs[0];
+    expect(env?.DISABLE_TELEMETRY).toBe("1");
+    expect(env?.DO_NOT_TRACK).toBe("1");
+  });
 });