@desplega.ai/agent-swarm 1.90.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/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");
+  });
 });

package/src/tests/hook-registration-nudge.test.ts

@@ -0,0 +1,69 @@
+/**
+ * Registration-nudge gate tests.
+ *
+ * The "use join-swarm" nudge previously fired on EVERY hook event when
+ * getAgentInfo() returned null — including transient lookup failures for
+ * already-registered agents. This caused 123 redundant join-swarm calls
+ * in a 3-day window, all bouncing off "already exists".
+ *
+ * The fix: only nudge on SessionStart AND only when no X-Agent-ID header
+ * is present (genuinely unregistered).
+ */
+import { describe, expect, test } from "bun:test";
+import { shouldShowRegistrationNudge } from "../hooks/hook";
+
+describe("shouldShowRegistrationNudge", () => {
+  test("(a) pre-assigned agent (X-Agent-ID present) + null lookup on SessionStart → NO nudge", () => {
+    expect(
+      shouldShowRegistrationNudge({
+        agentInfoPresent: false,
+        eventType: "SessionStart",
+        hasAgentIdHeader: true,
+      }),
+    ).toBe(false);
+  });
+
+  test("(b) non-SessionStart event → NO nudge regardless of other conditions", () => {
+    const nonStartEvents = ["UserPromptSubmit", "PreToolUse", "PostToolUse", "PreCompact", "Stop"];
+
+    for (const eventType of nonStartEvents) {
+      expect(
+        shouldShowRegistrationNudge({
+          agentInfoPresent: false,
+          eventType,
+          hasAgentIdHeader: false,
+        }),
+      ).toBe(false);
+    }
+  });
+
+  test("(c) genuinely unregistered (no X-Agent-ID) on SessionStart → nudge present", () => {
+    expect(
+      shouldShowRegistrationNudge({
+        agentInfoPresent: false,
+        eventType: "SessionStart",
+        hasAgentIdHeader: false,
+      }),
+    ).toBe(true);
+  });
+
+  test("registered agent (agentInfo present) never gets nudged", () => {
+    expect(
+      shouldShowRegistrationNudge({
+        agentInfoPresent: true,
+        eventType: "SessionStart",
+        hasAgentIdHeader: false,
+      }),
+    ).toBe(false);
+  });
+
+  test("pre-assigned agent on non-SessionStart event → NO nudge", () => {
+    expect(
+      shouldShowRegistrationNudge({
+        agentInfoPresent: false,
+        eventType: "UserPromptSubmit",
+        hasAgentIdHeader: true,
+      }),
+    ).toBe(false);
+  });
+});