@desplega.ai/agent-swarm 2.3.0 → 2.4.0

package/dist/{cli-ka01m5rb.js → cli-bhwa8rzc.js}

@@ -66,7 +66,7 @@ import {
   getStaleApprovalRequests2,
   upsertKv2,
   init_db3
-} from "./cli-re4wkbzx.js";
+} from "./cli-rg7ntypm.js";
 import {
   poolTaskRunsOnHarness,
   isRuntimePoolWakeable,
@@ -91,32 +91,34 @@ import {
   createRerouteDecisionTask,
   createPoolStarvationDecisionTask,
   canClaim
-} from "./cli-8qsx817b.js";
+} from "./cli-x719j3vs.js";
 import {
-  mintToken,
-  init_users,
   listRuntimePools2,
   init_db
-} from "./cli-hz64bcnj.js";
+} from "./cli-6ftrrwm1.js";
 import {
   createApprovalFollowUpTask
-} from "./cli-q1812jbw.js";
+} from "./cli-tj4j2ts4.js";
 import {
   remediateStalledRuntime
-} from "./cli-fp4xbw07.js";
+} from "./cli-rsd7ga7v.js";
 import {
   runSavedScriptAsAgent
-} from "./cli-65q70v2v.js";
+} from "./cli-nrrg0fvy.js";
+import {
+  mintToken,
+  init_users
+} from "./cli-8cxkw1f5.js";
 import {
   TERMINAL_TASK_STATUSES,
   init_types
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 import {
   registerTemplate,
   init_registry,
   resolveTemplate,
   init_resolver
-} from "./cli-w7z94e6c.js";
+} from "./cli-tx00c0h6.js";
 import {
   DEFAULT_OPENROUTER_BASE_URL,
   getOpenRouterBaseUrl,
@@ -125,7 +127,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-5d1m1qca.js";
+} from "./cli-mz1ezzzh.js";
 import {
   isEnvFlagEnabled,
   init_env_flag

package/dist/{cli-8cvvytad.js → cli-bn26xbcs.js}

@@ -13206,9 +13206,9 @@ var anthropicMessagesApi = () => lazyApi(() => import("./anthropic-messages-g6pq
 // node_modules/@earendil-works/pi-ai/dist/api/azure-openai-responses.lazy.js
 var azureOpenAIResponsesApi = () => lazyApi(() => import("./azure-openai-responses-9dbmj346.js"));
 // node_modules/@earendil-works/pi-ai/dist/api/google-generative-ai.lazy.js
-var googleGenerativeAIApi = () => lazyApi(() => import("./google-generative-ai-phpmwxvg.js"));
+var googleGenerativeAIApi = () => lazyApi(() => import("./google-generative-ai-bmq8gkf3.js"));
 // node_modules/@earendil-works/pi-ai/dist/api/google-vertex.lazy.js
-var googleVertexApi = () => lazyApi(() => import("./google-vertex-es9ybgdy.js"));
+var googleVertexApi = () => lazyApi(() => import("./google-vertex-b1rvp52s.js"));
 // node_modules/@earendil-works/pi-ai/dist/api/mistral-conversations.lazy.js
 var mistralConversationsApi = () => lazyApi(() => import("./mistral-conversations-1medfwv7.js"));
 // node_modules/@earendil-works/pi-ai/dist/api/openai-codex-responses.lazy.js

package/dist/{cli-k28p6xh7.js → cli-c8fwpgqb.js}

@@ -13,7 +13,7 @@ import {
   claudeMdLineageOf,
   planClaudeMdSync,
   init_profile_sync
-} from "./cli-cby329ny.js";
+} from "./cli-wyrr38xm.js";
 import {
   scrubSecrets,
   init_secret_scrubber

package/dist/{cli-rc3r0bnh.js → cli-ccn0eybf.js}

@@ -23,7 +23,7 @@ import {
   autoIndexMemoryFile,
   fetchConcurrentContext,
   summarizeTranscript
-} from "./cli-9td5ss65.js";
+} from "./cli-dsgj3e7a.js";
 import {
   applyReasoningEffort
 } from "./cli-p22zdvnt.js";

package/dist/{cli-9td5ss65.js → cli-dsgj3e7a.js}

@@ -10,13 +10,13 @@ import {
 } from "./cli-0726awxw.js";
 import {
   summarizeSession
-} from "./cli-etvn5ej2.js";
+} from "./cli-sppc0cmw.js";
 import {
   resolveTemplateFromCode,
   resolveTemplateAsync,
   init_resolver,
   init_session_templates
-} from "./cli-w7z94e6c.js";
+} from "./cli-tx00c0h6.js";
 import {
   getOpenRouterAttributionHeaders,
   init_openrouter_base_url

package/dist/{cli-a17tzmn0.js → cli-ecshf504.js}

@@ -18,7 +18,7 @@ import {
 import {
   applyOpenRouterBaseUrlOverride2,
   buildOpenAICompatibleProviderBlock2
-} from "./cli-rc3r0bnh.js";
+} from "./cli-ccn0eybf.js";
 import {
   fetchInstalledMcpServers
 } from "./cli-bst1vp7e.js";
@@ -43,7 +43,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-5d1m1qca.js";
+} from "./cli-mz1ezzzh.js";
 import {
   scrubSecrets,
   init_secret_scrubber

package/dist/{cli-d43xqzbe.js → cli-eqgfs202.js}

@@ -1,7 +1,7 @@
 import {
   RuntimeProviderKindSchema,
   init_types
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 import {
   init_zod
 } from "./cli-4chz1hye.js";

package/dist/{cli-ppapy34w.js → cli-f3nx1h8z.js}

@@ -8,11 +8,11 @@ import {
   resolveConfigValueOrThrow,
   resolveHeadersOrThrow,
   FileAuthStorageBackend
-} from "./cli-8jtrekpy.js";
+} from "./cli-p1m2b6gc.js";
 import {
   oauthSuccessHtml,
   oauthErrorHtml
-} from "./cli-8cvvytad.js";
+} from "./cli-bn26xbcs.js";
 import {
   __toESM
 } from "./cli-242037k3.js";

package/dist/{cli-ea7chd26.js → cli-ffbrkh1r.js}

@@ -1,6 +1,6 @@
 import {
   renderSteeringDelivery
-} from "./cli-665j3feb.js";
+} from "./cli-0xk505e8.js";
 import {
   authJsonToCredentialSelection,
   credentialsToAuthJson,
@@ -14,6 +14,13 @@ import {
   skillFromToolArgs,
   createSkillInvokeTracker
 } from "./cli-77cd6gy8.js";
+import {
+  isLeadChannelMonitoringEnabled,
+  orgIdentityStatus,
+  renderMemoriesPrompt,
+  isUnknownModelError,
+  writeSkillsToFilesystem
+} from "./cli-wrv09v7q.js";
 import {
   isPollTracingEnabled,
   initOtel,
@@ -23,7 +30,7 @@ import {
   injectTraceContext2,
   initialize,
   ensure
-} from "./cli-dxwh4j32.js";
+} from "./cli-4fhyq711.js";
 import {
   getContextWindowSize
 } from "./cli-jhp7w1fy.js";
@@ -44,7 +51,7 @@ import {
   canonicalAzureDevOpsRepoUrl,
   parseAzureDevOpsRepoUrl,
   resolveScriptsOnlyMode
-} from "./cli-8qsx817b.js";
+} from "./cli-x719j3vs.js";
 import {
   ACP_TARGET_IDS,
   isAcpTarget
@@ -52,38 +59,32 @@ import {
 import {
   checkAmpCredentials2,
   liveTestAmpCredentials2
-} from "./cli-6p7ddg72.js";
+} from "./cli-tgvpmnwz.js";
 import {
   checkClaudeCredentials2
-} from "./cli-hn3pftj2.js";
+} from "./cli-kz116kvw.js";
 import {
   checkClaudeManagedCredentials2
-} from "./cli-j0v75y13.js";
+} from "./cli-y83zk5sb.js";
 import {
   codexUserHome,
   checkCodexCredentials2
-} from "./cli-tr24eeny.js";
+} from "./cli-bfc3k1x5.js";
 import {
   checkCursorCredentials2
-} from "./cli-4s1kqrqg.js";
+} from "./cli-8rwvksbc.js";
 import {
   checkDevinCredentials2
 } from "./cli-zv4vy2b0.js";
 import {
   checkDshCredentials2
-} from "./cli-zes4tsbb.js";
+} from "./cli-8b9wvjps.js";
 import {
   checkOpencodeCredentials2
-} from "./cli-rc3r0bnh.js";
+} from "./cli-ccn0eybf.js";
 import {
   checkGrokCredentials2
-} from "./cli-0rh20bp3.js";
-import {
-  isLeadChannelMonitoringEnabled,
-  renderMemoriesPrompt,
-  isUnknownModelError,
-  writeSkillsToFilesystem
-} from "./cli-4g629sgr.js";
+} from "./cli-zvze9rbm.js";
 import {
   CODEX_OAUTH_POOL_SLOTS_ENV,
   isCodexOAuthConfigKey,
@@ -92,7 +93,7 @@ import {
 } from "./cli-j4bwnpkm.js";
 import {
   validateJsonSchema
-} from "./cli-jhmjwqcg.js";
+} from "./cli-nme7wery.js";
 import {
   mapTriggerSurface,
   init_telemetry_context,
@@ -110,7 +111,7 @@ import {
   init_vcs_repo_match,
   isApiDrainingResponse,
   init_api_drain
-} from "./cli-re4wkbzx.js";
+} from "./cli-rg7ntypm.js";
 import {
   parseWorkerModelTierOverrides,
   resolveTaskModelSelection,
@@ -118,7 +119,7 @@ import {
   ProviderNameSchema,
   WorkerNudgeSchema,
   init_types
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 import {
   generateDefaultClaudeMd2,
   generateDefaultSoulMd2,
@@ -142,7 +143,7 @@ import {
   resolveClaudeMdPath,
   syncProfileFilesToServer,
   init_profile_sync
-} from "./cli-cby329ny.js";
+} from "./cli-wyrr38xm.js";
 import {
   isSteeringEnabled2,
   init_steering_enabled
@@ -156,14 +157,14 @@ import {
 } from "./cli-yxqag76b.js";
 import {
   init_templates3
-} from "./cli-4ync7m60.js";
+} from "./cli-0ebey9hg.js";
 import {
   interpolate,
   init_template,
   configureHttpResolver,
   resolveTemplateAsync,
   init_resolver
-} from "./cli-w7z94e6c.js";
+} from "./cli-tx00c0h6.js";
 import {
   modelFamilyOf,
   windowForModelFamily,
@@ -190,6 +191,10 @@ import {
   getMcpBaseUrl,
   init_constants2
 } from "./cli-w9g4sz81.js";
+import {
+  isEnvFlagEnabled,
+  init_env_flag
+} from "./cli-0hyhdkdk.js";
 import {
   getApiKey,
   init_api_key
@@ -241,19 +246,19 @@ async function materializeCodexAuthJson(_slot, creds, deps = {}) {
 async function createProviderAdapter(provider) {
   switch (provider) {
     case "claude": {
-      const { ClaudeAdapter } = await import("./claude-adapter-q7wspzt8.js");
+      const { ClaudeAdapter } = await import("./claude-adapter-bm23cye7.js");
       return new ClaudeAdapter;
     }
     case "pi": {
-      const { PiMonoAdapter } = await import("./pi-mono-adapter-zasp3ze3.js");
+      const { PiMonoAdapter } = await import("./pi-mono-adapter-hxby0ce1.js");
       return new PiMonoAdapter;
     }
     case "codex": {
-      const { CodexAdapter } = await import("./codex-adapter-nhjj2veb.js");
+      const { CodexAdapter } = await import("./codex-adapter-pp2gq8gr.js");
       return new CodexAdapter;
     }
     case "claude-managed": {
-      const { ClaudeManagedAdapter } = await import("./claude-managed-adapter-n7ahjyx6.js");
+      const { ClaudeManagedAdapter } = await import("./claude-managed-adapter-1mwrsm9d.js");
       return new ClaudeManagedAdapter;
     }
     case "devin": {
@@ -261,27 +266,27 @@ async function createProviderAdapter(provider) {
       return new DevinAdapter;
     }
     case "opencode": {
-      const { OpencodeAdapter } = await import("./opencode-adapter-eeesgfqk.js");
+      const { OpencodeAdapter } = await import("./opencode-adapter-f4hryjny.js");
       return new OpencodeAdapter;
     }
     case "dsh": {
-      const { DshAdapter } = await import("./dsh-adapter-fbx06re2.js");
+      const { DshAdapter } = await import("./dsh-adapter-75xwh78t.js");
       return new DshAdapter;
     }
     case "amp": {
-      const { AmpAdapter } = await import("./amp-adapter-jw9xfz42.js");
+      const { AmpAdapter } = await import("./amp-adapter-xeb5mktv.js");
       return new AmpAdapter;
     }
     case "cursor": {
-      const { CursorAdapter } = await import("./cursor-adapter-cf4zh5x0.js");
+      const { CursorAdapter } = await import("./cursor-adapter-3v542qe5.js");
       return new CursorAdapter;
     }
     case "grok": {
-      const { GrokAdapter } = await import("./grok-adapter-1193sprp.js");
+      const { GrokAdapter } = await import("./grok-adapter-vj88xr23.js");
       return new GrokAdapter;
     }
     case "acp": {
-      const { ACPAdapter } = await import("./acp-adapter-v85a2bqy.js");
+      const { ACPAdapter } = await import("./acp-adapter-kedstxx6.js");
       return new ACPAdapter;
     }
     default:
@@ -289,6 +294,32 @@ async function createProviderAdapter(provider) {
   }
 }
 
+// src/ranking/usage.ts
+init_env_flag();
+var tokens = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+function rankingUsageProps(cost, session, env = process.env) {
+  if (!isEnvFlagEnabled("ANONYMIZED_TELEMETRY", true, env))
+    return null;
+  if (!isEnvFlagEnabled("PUBLIC_RANKING_ENABLED", false, env))
+    return null;
+  const identity = { SWARM_ORG_NAME: env.SWARM_ORG_NAME, SWARM_ORG_WEBSITE: env.SWARM_ORG_WEBSITE };
+  if (!orgIdentityStatus(identity).ok)
+    return null;
+  const input = tokens(cost.inputTokens);
+  const output = tokens(cost.outputTokens);
+  const cacheRead = tokens(cost.cacheReadTokens);
+  const cacheWrite = tokens(cost.cacheWriteTokens);
+  return {
+    model: session.model,
+    provider: session.provider,
+    totalTokens: input + cacheRead + cacheWrite + output,
+    inputTokens: input,
+    outputTokens: output,
+    ...cost.cacheReadTokens != null ? { cacheReadTokens: cacheRead } : {},
+    ...cost.cacheWriteTokens != null ? { cacheWriteTokens: cacheWrite } : {}
+  };
+}
+
 // src/realtime/worker-client.ts
 init_types();
 init_api_key();
@@ -1174,7 +1205,7 @@ var CREDENTIAL_PROVIDER_CHECKERS = {
   devin: (env) => checkDevinCredentials2(env),
   opencode: (env, opts) => checkOpencodeCredentials2(env, opts),
   pi: async (env, opts) => {
-    const { checkPiMonoCredentials } = await import("./pi-mono-adapter-zasp3ze3.js");
+    const { checkPiMonoCredentials } = await import("./pi-mono-adapter-hxby0ce1.js");
     return checkPiMonoCredentials(env, opts);
   },
   acp: (env) => {
@@ -1443,7 +1474,7 @@ async function validateProviderCredentials(provider, env = process.env, presence
             latency_ms: Date.now() - startedAt
           };
         }
-        const { liveTestCursorKey } = await import("./cursor-adapter-cf4zh5x0.js");
+        const { liveTestCursorKey } = await import("./cursor-adapter-3v542qe5.js");
         const result = await liveTestCursorKey(apiKey);
         return result.ok ? { ok: true, latency_ms: Date.now() - startedAt } : { ok: false, error: result.error, latency_ms: Date.now() - startedAt };
       }
@@ -2466,6 +2497,8 @@ var RELOADABLE_ENV_KEYS = new Set([
   "TEMPLATE_REGISTRY_URL",
   "SLACK_DISABLE",
   "SWARM_ORG_NAME",
+  "SWARM_ORG_WEBSITE",
+  "PUBLIC_RANKING_ENABLED",
   "PI_TOOL_DEFERRAL",
   "PI_CODEMODE",
   "PI_CODEMODE_MODELS",
@@ -4642,6 +4675,12 @@ async function spawnProviderProcess(adapter, opts, logDir, isYolo) {
         numTurns: result.cost.numTurns,
         isError: result.cost.isError
       }, { userId: opts.requestedByUserId ?? null });
+      const rankingUsage = rankingUsageProps(result.cost, {
+        model: result.cost.model,
+        provider: result.cost.provider ?? opts.harnessProvider
+      });
+      if (rankingUsage)
+        telemetry.ranking("usage", rankingUsage);
     }
     if (result.cost && realTaskId) {
       fetch(`${opts.apiUrl}/api/tasks/${realTaskId}/context`, {

package/dist/{cli-xgn4rwyv.js → cli-kk2r80n5.js}

@@ -7,20 +7,20 @@ import {
   tierConfigKey,
   init_model_tier_keys,
   init_db3
-} from "./cli-re4wkbzx.js";
+} from "./cli-rg7ntypm.js";
 import {
   ensureRbacSeedsSynced2,
   init_rbac_roles
-} from "./cli-6vcyw6v7.js";
+} from "./cli-5s5hx57y.js";
 import {
   seedPricingFromModelsDev
-} from "./cli-qrwp40st.js";
+} from "./cli-tg9ksbn8.js";
 import {
   MODEL_TIERS,
   DEFAULT_MODEL_TIER_MAP,
   ProviderNameSchema,
   init_types
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 
 // src/be/boot-seeds.ts
 init_db3();

package/dist/{cli-hn3pftj2.js → cli-kz116kvw.js}

@@ -1,6 +1,6 @@
 import {
   runStopHookSessionSummarySubprocess
-} from "./cli-1v8w782f.js";
+} from "./cli-mvg2hf8p.js";
 import {
   CONTEXT_FORMULA,
   getContextWindowSize,
@@ -47,7 +47,7 @@ import {
 import {
   withFileLock,
   init_file_lock
-} from "./cli-cby329ny.js";
+} from "./cli-wyrr38xm.js";
 import {
   CLAUDE_CREDENTIALS_HINT,
   validateClaudeCredentials,
@@ -1236,7 +1236,7 @@ class ClaudeAdapter2 {
     if (transport === "sdk" && isClaudeBridgeEffective(sourceEnv)) {
       throw new Error("CLAUDE_TRANSPORT=sdk cannot run with an effective Claude Bridge configuration. Select CLI transport or disable the bridge.");
     }
-    const claudeSdk = transport === "sdk" ? await import("./claude-sdk-session-yf400ptr.js") : undefined;
+    const claudeSdk = transport === "sdk" ? await import("./claude-sdk-session-apb4ypz3.js") : undefined;
     claudeSdk?.validateClaudeSdkAdditionalArgs([
       ...claudeBinaryArgv.slice(1),
       ...config.additionalArgs ?? []

package/dist/{cli-1v8w782f.js → cli-mvg2hf8p.js}

@@ -8,10 +8,10 @@ import {
 import {
   materializeClaudeMd,
   stopClaudeMd
-} from "./cli-k28p6xh7.js";
+} from "./cli-c8fwpgqb.js";
 import {
   summarizeSession
-} from "./cli-etvn5ej2.js";
+} from "./cli-sppc0cmw.js";
 import {
   guardGhPrBody
 } from "./cli-c5sbmw1v.js";
@@ -26,11 +26,11 @@ import {
   warnProfileFileTooLarge,
   buildIndependentIdentityPayloads,
   init_profile_sync
-} from "./cli-cby329ny.js";
+} from "./cli-wyrr38xm.js";
 import {
   init_package,
   package_default
-} from "./cli-5d1m1qca.js";
+} from "./cli-mz1ezzzh.js";
 import {
   MAX_PROFILE_FILE_LENGTH,
   getMcpBaseUrl,

package/dist/{cli-5d1m1qca.js → cli-mz1ezzzh.js}

@@ -7,7 +7,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@desplega.ai/agent-swarm",
-    version: "2.3.0",
+    version: "2.4.0",
     description: "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
     keywords: [
       "agent-swarm.dev",

package/dist/{cli-jhmjwqcg.js → cli-nme7wery.js}

@@ -39,7 +39,7 @@ import {
   getPendingWaitsByEvent2,
   resolveWaitState2,
   init_db3
-} from "./cli-re4wkbzx.js";
+} from "./cli-rg7ntypm.js";
 import {
   BaseExecutor,
   postApprovalCancellationUpdates,
@@ -50,7 +50,7 @@ import {
   findEntryNodes,
   resolveValidationPort,
   getSuccessors
-} from "./cli-q1812jbw.js";
+} from "./cli-tj4j2ts4.js";
 import {
   workflowEventBus2,
   init_event_bus
@@ -58,7 +58,7 @@ import {
 import {
   RetryPolicySchema,
   init_types
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 import {
   getSlackConfiguration,
   isSlackConfigured,
@@ -67,7 +67,7 @@ import {
 import {
   deepInterpolate,
   init_template
-} from "./cli-w7z94e6c.js";
+} from "./cli-tx00c0h6.js";
 import {
   init_zod
 } from "./cli-4chz1hye.js";
@@ -106,7 +106,7 @@ async function notifyAutomationPreflightFailure(preflight) {
     return;
   }
   try {
-    const { getSlackApp } = await import("./app-4e1s4675.js");
+    const { getSlackApp } = await import("./app-mqap8t8m.js");
     const app = getSlackApp();
     if (!app) {
       console.warn("[Automation Preflight] Slack not available, cannot send notification");
@@ -1434,7 +1434,7 @@ async function runClaimedStep(def, runId, ctx, node, registry, existingStep, ste
   if ("async" in result && result.async) {
     const waiting = await checkpointStepWaiting(runId, stepId, ctx);
     if (waiting && result.waitFor === "workflow.child.finished") {
-      const { resumeFromChildRun } = await import("./resume-a86tkj6r.js");
+      const { resumeFromChildRun } = await import("./resume-b6djcj3c.js");
       await resumeFromChildRun(stepId, registry);
     }
     return { outcome: waiting ? "waiting" : "completed", successors: [] };

package/dist/{cli-65q70v2v.js → cli-nrrg0fvy.js}

@@ -38,14 +38,14 @@ import {
   getResolvedConfig2,
   getMcpServerById2,
   init_db3
-} from "./cli-re4wkbzx.js";
+} from "./cli-rg7ntypm.js";
 import {
   generateRandomCodeVerifier,
   generateRandomState,
   calculatePKCECodeChallenge,
   oauthAppRowToProviderConfig,
   ensureAuthorizationTokenOrThrow
-} from "./cli-g6p7c2my.js";
+} from "./cli-b80a1100.js";
 import {
   detachedProcessGroup,
   registerProcessGroup,
@@ -57,7 +57,7 @@ import {
 import {
   defaultAssetKey,
   init_key
-} from "./cli-yv0vgscc.js";
+} from "./cli-a1esmmee.js";
 import {
   init_zod
 } from "./cli-4chz1hye.js";
@@ -183434,6 +183434,13 @@ var APP_TYPES_PREAMBLE = `// ── Swarm Apps: generated per-app types (source:
 // Rows are the app's declared columns plus the 5 system columns. Query
 // overloads narrow only when appId AND query are string literals.
 
+export type AppActionCaller = {
+  kind: "user" | "agent" | "operator" | "guest";
+  id: string | null;
+  name?: string;
+  pageId?: string;
+};
+
 export interface SwarmAppQueryResult<Row> {
   success: boolean;
   status: number;
@@ -183553,7 +183560,7 @@ function renderQuery(app, namespace, queryName, query, modelInterfaceName) {
   }): Promise<SwarmAppQueryResult<${namespace}.${modelInterfaceName}>>;`;
 }
 function renderApp(app, namespace) {
-  const modelNames = new Set(["ActionName"]);
+  const modelNames = new Set(["ActionName", "ActionArgs", "AppActionCaller"]);
   const renderedModels = Object.entries(app.definition.models).map(([modelName, model]) => renderModel(modelName, model, modelNames));
   const modelInterfaces = new Map(Object.keys(app.definition.models).map((modelName, index) => [
     modelName,
@@ -183571,6 +183578,13 @@ ${renderedModels.map((model) => model.source).join(`
 
   /** Declared actions. Invocation is REST-only: POST /api/apps/<id>/actions/<name>. */
   export type ActionName = ${actionType};
+
+  /** Script action arguments include server-stamped app and caller context. */
+  export interface ActionArgs {
+    app: { id: ${JSON.stringify(app.id)} };
+    caller: AppActionCaller;
+    [key: string]: unknown;
+  }
 }
 
 export interface SwarmSdk {