@sentry/junior 0.136.1 → 0.138.0

package/dist/chat/configuration/defaults.d.ts

@@ -1,4 +1,4 @@
-/** Store install-wide config defaults; keys must be registered plugin config keys. */
+/** Store install-wide configuration defaults. */
 export declare function setConfigDefaults(defaults: Record<string, unknown> | undefined): void;
 /** Return the install-wide configuration defaults (empty object when none set). */
 export declare function getConfigDefaults(): Record<string, unknown>;

package/dist/chat/conversations/sql/store.d.ts

@@ -5,11 +5,19 @@ import type { JuniorSqlDatabase } from "@/db/db";
 import type { Conversation, ConversationExecution, ConversationSource, ConversationStore } from "../store";
 import type { AgentTurnUsage } from "@/chat/usage";
 import { type ProviderConversationBinding, type ProviderConversationReference } from "./bindings";
+/** Serialize one conversation's durable mutations inside a SQL transaction. */
+export declare function withConversationMutationLock<T>(executor: JuniorSqlDatabase, conversationId: string, callback: () => Promise<T>): Promise<T>;
 export declare class SqlStore implements ConversationStore {
     private readonly executor;
     constructor(executor: JuniorSqlDatabase);
     getConversationIdByProviderConversation(args: ProviderConversationReference): Promise<string | undefined>;
     bindProviderConversation(args: ProviderConversationBinding): Promise<void>;
+    createChild(args: {
+        childConversationId: string;
+        parentConversationId: string;
+        nowMs?: number;
+        source?: ConversationSource;
+    }): Promise<void>;
     get(args: {
         conversationId: string;
     }): Promise<Conversation | undefined>;

package/dist/chat/conversations/store.d.ts

@@ -32,7 +32,8 @@ export interface Conversation {
     source?: ConversationSource;
     /**
      * Structured inbound Source locator for this conversation session.
-     * Session-stable (Slack thread anchor, not per-message ts). Set-once.
+     * Session-stable (threaded Slack keeps threadTs; channel-level turns omit
+     * it; never stores per-message ts). Set-once.
      */
     sessionSource?: SessionSource;
     title?: string;
@@ -48,6 +49,13 @@ export interface Conversation {
 }
 /** Persist and read durable conversation metadata for reporting surfaces. */
 export interface ConversationStore {
+    /** Create one destinationless child with immutable parent lineage. */
+    createChild(args: {
+        childConversationId: string;
+        parentConversationId: string;
+        nowMs?: number;
+        source?: ConversationSource;
+    }): Promise<void>;
     get(args: {
         conversationId: string;
     }): Promise<Conversation | undefined>;

package/dist/chat/experimental.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Known unstable product features that must be opted into explicitly.
+ * Add new keys here as features graduate from private experiments; remove them
+ * once they become stable defaults.
+ */
+export declare const EXPERIMENTAL_FEATURES: readonly ["subagents"];
+/** One known experimental feature name. */
+export type ExperimentalFeature = (typeof EXPERIMENTAL_FEATURES)[number];
+/** App-level opt-ins for unstable product features. */
+export type ExperimentalFeaturesConfig = Readonly<Partial<Record<ExperimentalFeature, boolean>>>;
+/** Replace app-level experimental opt-ins and return the previous setting. */
+export declare function setExperimentalFeatures(config?: ExperimentalFeaturesConfig): ExperimentalFeaturesConfig;
+/** Return a copy of the app-level experimental opt-ins configured by createApp(). */
+export declare function getExperimentalFeatures(): ExperimentalFeaturesConfig;
+/** Return whether one experimental feature is enabled via createApp({ experimental }). */
+export declare function isExperimentalFeatureEnabled(feature: ExperimentalFeature): boolean;

package/dist/chat/pi/client.d.ts

@@ -1,16 +1,9 @@
 import { type Message, type Model, type ThinkingLevel } from "@/chat/pi/sdk";
+export { getGatewayApiKey, MISSING_GATEWAY_CREDENTIALS_ERROR, resolveGatewayCredential, type GatewayCredential, } from "@/chat/pi/gateway-auth";
 import type { ZodTypeAny, z } from "zod";
 export declare const GEN_AI_PROVIDER_NAME: "vercel-ai-gateway";
 export declare const GEN_AI_SERVER_ADDRESS = "ai-gateway.vercel.sh";
 export declare const GEN_AI_SERVER_PORT = 443;
-export declare const MISSING_GATEWAY_CREDENTIALS_ERROR = "Missing AI gateway credentials (AI_GATEWAY_API_KEY or VERCEL_OIDC_TOKEN)";
-/**
- * Resolve the documented AI Gateway env credentials for the paths that need
- * the bearer token string directly.
- */
-export declare function getGatewayApiKey(): string | undefined;
-/** Return the Gateway credential shape expected by Pi Agent getApiKey hooks. */
-export declare function getPiGatewayApiKey(): string | undefined;
 /**
  * Look up a gateway model by id. Throws `Unknown AI Gateway model id: …` if
  * the id is not in pi-ai's registry — callers at the config boundary can use

package/dist/chat/pi/gateway-auth.d.ts

@@ -0,0 +1,16 @@
+export type GatewayCredential = {
+    mode: "oidc" | "api_key";
+    token: string;
+};
+export declare const MISSING_GATEWAY_CREDENTIALS_ERROR = "Missing AI gateway credentials (enable Vercel OIDC or set AI_GATEWAY_API_KEY)";
+/**
+ * Resolve the preferred AI Gateway bearer credential.
+ *
+ * Order:
+ * 1. Vercel OIDC via `@vercel/oidc` (request header `x-vercel-oidc-token`,
+ *    then `VERCEL_OIDC_TOKEN`, with local refresh when needed)
+ * 2. Explicit `AI_GATEWAY_API_KEY` / pi-ai env mapping for vercel-ai-gateway
+ */
+export declare function resolveGatewayCredential(): Promise<GatewayCredential | undefined>;
+/** Resolve the bearer token string for Authorization headers and Pi getApiKey. */
+export declare function getGatewayApiKey(): Promise<string | undefined>;

package/dist/chat/runtime/agent-runner.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRunRequest } from "@/chat/agent/request";
+import { type AgentRunRequest, type SpawnAgent } from "@/chat/agent/request";
 import type { AgentRunOutcome } from "@/chat/runtime/agent-run-outcome";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
 /** Run one agent-run slice behind runtime-owned orchestration boundaries. */
@@ -7,5 +7,6 @@ export interface AgentRunner {
 }
 /** Adapt the Pi-facing agent-run executor behind the runtime-owned runner seam. */
 export declare function createAgentRunner(run: AgentRunner["run"], options?: {
+    bindSpawnAgent?: (request: AgentRunRequest) => SpawnAgent | undefined;
     tracePropagation?: SandboxEgressTracePropagationConfig;
 }): AgentRunner;

package/dist/chat/sandbox/docker.d.ts

@@ -0,0 +1,17 @@
+import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
+/** Docker daemon config for Vercel sandbox guests (nested containers). */
+export declare const DOCKER_DAEMON_JSON = "{\n  \"storage-driver\": \"overlay2\",\n  \"live-restore\": false\n}\n";
+/**
+ * Start dockerd when the socket is missing and wait until `docker info` works.
+ * Re-execs through sudo so the sandbox user can call it without root.
+ */
+export declare const DOCKER_ENSURE_SCRIPT = "#!/bin/sh\nset -eu\n\nif [ \"$(id -u)\" -ne 0 ]; then\n  exec sudo -n \"$0\" \"$@\"\nfi\n\nSOCK=/var/run/docker.sock\nPIDFILE=/var/run/docker.pid\nLOG=/var/log/junior-dockerd.log\n\nis_ready() {\n  [ -S \"$SOCK\" ] && /usr/bin/docker info >/dev/null 2>&1\n}\n\nif is_ready; then\n  chmod 666 \"$SOCK\" 2>/dev/null || true\n  exit 0\nfi\n\nmkdir -p /etc/docker /var/lib/docker /var/run /var/log\nif [ ! -f /etc/docker/daemon.json ]; then\n  cat > /etc/docker/daemon.json <<'EOF'\n{\n  \"storage-driver\": \"overlay2\",\n  \"live-restore\": false\n}\nEOF\nfi\n\nif [ -f \"$PIDFILE\" ]; then\n  oldpid=\"$(cat \"$PIDFILE\" 2>/dev/null || true)\"\n  if [ -n \"${oldpid:-}\" ] && ! kill -0 \"$oldpid\" 2>/dev/null; then\n    rm -f \"$PIDFILE\"\n  fi\nfi\n\nif [ ! -f \"$PIDFILE\" ] || ! kill -0 \"$(cat \"$PIDFILE\" 2>/dev/null)\" 2>/dev/null; then\n  # dockerd must outlive this helper; nohup + background is intentional.\n  nohup dockerd --host=\"unix://$SOCK\" --pidfile=\"$PIDFILE\" >\"$LOG\" 2>&1 &\nfi\n\ni=0\nwhile [ \"$i\" -lt 50 ]; do\n  if is_ready; then\n    chmod 666 \"$SOCK\" 2>/dev/null || true\n    exit 0\n  fi\n  i=$((i + 1))\n  sleep 0.1\ndone\n\necho \"junior-ensure-docker: dockerd failed to become ready\" >&2\nif [ -f \"$LOG\" ]; then\n  tail -n 50 \"$LOG\" >&2 || true\nfi\nexit 1\n";
+/** PATH wrapper so plain `docker` starts the daemon on first use. */
+export declare const DOCKER_CLI_WRAPPER_SCRIPT = "#!/bin/sh\nset -eu\nif command -v junior-ensure-docker >/dev/null 2>&1; then\n  junior-ensure-docker\nfi\nexec /usr/bin/docker \"$@\"\n";
+/** PATH wrapper so plain `docker-compose` starts the daemon on first use. */
+export declare const DOCKER_COMPOSE_CLI_WRAPPER_SCRIPT = "#!/bin/sh\nset -eu\nif command -v junior-ensure-docker >/dev/null 2>&1; then\n  junior-ensure-docker\nfi\nexec /usr/local/libexec/junior-docker-compose \"$@\"\n";
+/**
+ * Best-effort dockerd start during sandbox prepare.
+ * Missing helper is a no-op so tests and base sandboxes stay green.
+ */
+export declare function ensureDockerDaemon(sandbox: Pick<SandboxWorkspace, "runCommand">, signal?: AbortSignal): Promise<void>;

package/dist/chat/services/agent-continue.d.ts

@@ -6,6 +6,7 @@
  */
 import type { StateAdapter } from "chat";
 import type { Destination } from "@sentry/junior-plugin-api";
+import type { ConversationStore } from "@/chat/conversations/store";
 import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
 export interface AgentContinueRequest {
     conversationId: string;
@@ -21,6 +22,7 @@ export interface ScheduleAgentContinueOptions {
 /** Build the queue request for an awaiting automatic agent continuation. */
 export declare function getAwaitingAgentContinueRequest(args: {
     conversationId: string;
+    conversationStore?: ConversationStore;
     sessionId: string;
 }): Promise<AgentContinueRequest | undefined>;
 /** Schedule durable conversation work to continue a paused agent run. */

package/dist/chat/services/auth-pause.d.ts

@@ -1,6 +1,5 @@
 export type AuthorizationPauseKind = "mcp" | "plugin";
 export type AuthorizationPauseDisposition = "link_already_sent" | "link_sent";
-export type AuthorizationFlowMode = "interactive" | "disabled";
 /**
  * Runtime-owned signal that the current turn must park until the user
  * completes an external authorization step.

package/dist/chat/services/mcp-auth-orchestration.d.ts

@@ -9,7 +9,7 @@
 import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import { type OAuthAuthorization } from "@/chat/oauth-authorization";
-import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
+import { AuthorizationPauseError } from "@/chat/services/auth-pause";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
 import type { PluginDefinition } from "@/chat/plugins/types";
@@ -32,7 +32,8 @@ export interface McpAuthOrchestrationInput {
     getArtifactState: () => ThreadArtifactsState | undefined;
     getMergedArtifactState: () => ThreadArtifactsState;
     recordPendingAuth?: (pendingAuth: ConversationPendingAuthState | undefined) => void | Promise<void>;
-    authorizationFlowMode?: AuthorizationFlowMode;
+    /** When false, required auth hard-fails instead of pausing for an OAuth link. */
+    interactiveAuthEnabled?: boolean;
     authorization?: OAuthAuthorization;
 }
 export interface McpAuthOrchestration {

package/dist/chat/services/plugin-auth-orchestration.d.ts

@@ -12,7 +12,7 @@
  */
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import type { UserTokenStore } from "@/chat/credentials/user-token-store";
-import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
+import { AuthorizationPauseError } from "@/chat/services/auth-pause";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
 import { type OAuthAuthorization } from "@/chat/oauth-authorization";
 export declare class PluginAuthorizationPauseError extends AuthorizationPauseError {
@@ -34,7 +34,8 @@ export interface PluginAuthOrchestrationInput {
     userMessage?: string;
     pendingAuth?: ConversationPendingAuthState;
     recordPendingAuth?: (pendingAuth: ConversationPendingAuthState) => void | Promise<void>;
-    authorizationFlowMode?: AuthorizationFlowMode;
+    /** When false, required auth hard-fails instead of pausing for an OAuth link. */
+    interactiveAuthEnabled?: boolean;
     userTokenStore?: UserTokenStore;
     authorization?: OAuthAuthorization;
 }

package/dist/chat/services/subscribed-reply-router-policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Passive subscribed-thread reply router policy.
+ *
+ * Modeled after Junior's Guardian action-review policy shape and the open-source
+ * Codex Guardian evidence/prompt pattern:
+ * https://github.com/openai/codex/tree/main/codex-rs/core/src/guardian
+ *
+ * Guardian judges one planned tool action from bounded transcript evidence.
+ * This router judges one inbound Slack message from bounded visible
+ * user/assistant thread evidence and decides whether Junior should reply.
+ */
+export declare function buildSubscribedReplyRouterPolicy(assistantName: string): string;

package/dist/chat/services/turn-session-routing.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Load turn-session routing from durable conversation metadata.
+ *
+ * SQL owns destination and session source. Resume paths query those columns
+ * directly — no redis fallback and no derived rebuild of missing fields.
+ */
+import type { Destination, Source } from "@sentry/junior-plugin-api";
+import type { ConversationStore } from "@/chat/conversations/store";
+export interface TurnSessionRouting {
+    destination: Destination;
+    source: Source;
+}
+/** Require conversation destination and session source from SQL. */
+export declare function resolveTurnSessionRouting(args: {
+    conversationId: string;
+    conversationStore?: ConversationStore;
+}): Promise<TurnSessionRouting>;

package/dist/chat/slack/message.d.ts

@@ -1,7 +1,12 @@
-import type { Message } from "chat";
+import { type Message } from "chat";
 import { type SlackMessageTs } from "@/chat/slack/timestamp";
 /**
  * Preserve the native Slack message timestamp when a synthetic message ID is
  * used for routing or deduplication.
  */
 export declare function getSlackMessageTs(message: Pick<Message, "id" | "raw">): SlackMessageTs | undefined;
+/**
+ * Return the Chat SDK's canonical formatted representation by default.
+ * Fall back to plain text only when the message has no formatted content.
+ */
+export declare function getSlackMessageText(message: Pick<Message, "formatted" | "text">): string;

package/dist/chat/slack/source-link.d.ts

@@ -1,5 +1,11 @@
-/** Build Slack's browser-safe redirect to a conversation when its IDs are valid. */
+/** Parse a Slack workspace subdomain used in `https://{domain}.slack.com` URLs. */
+export declare function parseSlackTeamDomain(value: unknown): string | undefined;
+/**
+ * Build a direct Slack archive URL for a thread when the workspace domain is
+ * known. Omits a link rather than falling back to `app_redirect`.
+ */
 export declare function buildSlackSourceUrl(args: {
     channelId: string;
-    teamId: string;
+    teamDomain: string;
+    threadTs: string;
 }): string | undefined;

package/dist/chat/slack/team-domain.d.ts

@@ -0,0 +1,4 @@
+/** Resolve a workspace subdomain via `team.info`, cached by team id. */
+export declare function resolveSlackTeamDomain(teamId: string): Promise<string | undefined>;
+/** Resolve workspace subdomains for the distinct team ids in one API response. */
+export declare function resolveSlackTeamDomains(teamIds: Iterable<string>): Promise<ReadonlyMap<string, string>>;

package/dist/chat/source.d.ts

@@ -2,14 +2,14 @@ import { type Source } from "@sentry/junior-plugin-api";
 /** Source coordinates reduced to the stable locator for one conversation. */
 export type SessionSource = Extract<Source, {
     platform: "local";
-}> | (Omit<Extract<Source, {
+}> | Omit<Extract<Source, {
     platform: "slack";
-}>, "messageTs" | "threadTs"> & {
-    threadTs: string;
-});
+}>, "messageTs">;
 /**
  * Normalize a turn Source into the session-stable locator persisted on a
- * conversation. Drops per-message timestamps; requires a Slack thread anchor.
+ * conversation. Drops per-message timestamps. Threaded Slack turns keep their
+ * thread anchor; channel-level turns (scheduled/event dispatch) keep the
+ * channel locator without inventing a threadTs.
  */
 export declare function normalizeSessionSource(value: Source | undefined): SessionSource | undefined;
 /** Parse a serialized Source into the stable locator stored on a conversation. */

package/dist/chat/state/turn-session.d.ts

@@ -26,12 +26,10 @@ export interface AgentTurnSessionRecord {
     conversationId: string;
     cumulativeDurationMs: number;
     cumulativeUsage?: AgentTurnUsage;
-    destination?: Destination;
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     /** Provider-owned identifier returned after visible delivery is accepted. */
     resultMessageId?: string;
-    source?: Source;
     errorMessage?: string;
     lastProgressAtMs: number;
     loadedSkillNames?: string[];

package/dist/chat/task-execution/state.d.ts

@@ -13,6 +13,7 @@ export declare const CONVERSATION_WORK_LEASE_TTL_MS = 90000;
 export declare const CONVERSATION_WORK_CHECK_IN_INTERVAL_MS = 15000;
 export declare const CONVERSATION_WORK_STALE_ENQUEUE_MS = 60000;
 export declare const CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS = 5;
+export declare const CONVERSATION_WORK_MAX_RETRIES = 5;
 declare const inboundMessageSourceSchema: z.ZodEnum<{
     slack: "slack";
     plugin: "plugin";
@@ -46,14 +47,14 @@ export declare const inboundMessageSchema: z.ZodObject<{
         defer: "defer";
         interrupt: "interrupt";
     }>;
-    destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    destination: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         platform: z.ZodLiteral<"slack">;
         teamId: z.ZodString;
         channelId: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"local">;
         conversationId: z.ZodString;
-    }, z.core.$strict>], "platform">;
+    }, z.core.$strict>], "platform">>;
     inboundMessageId: z.ZodString;
     injectedAtMs: z.ZodOptional<z.ZodNumber>;
     input: z.ZodObject<{
@@ -84,6 +85,8 @@ export interface ConversationExecution {
     inboundMessageIds: string[];
     lastCheckpointAtMs?: number;
     lastEnqueuedAtMs?: number;
+    lastProgressAtMs?: number;
+    retryCount?: number;
     lease?: Lease;
     pendingCount: number;
     pendingMessages: InboundMessage[];
@@ -163,7 +166,7 @@ export declare function appendInboundMessage(args: {
 /** Mark a conversation runnable when there is no new mailbox message. */
 export declare function requestConversationWork(args: {
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<RequestConversationWorkResult>;
@@ -251,7 +254,7 @@ export declare function ackMessages(args: {
 /** Mark the leased conversation as needing another queue-delivered slice. */
 export declare function requestConversationContinuation(args: {
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     leaseToken: string;
     nowMs?: number;
     state?: StateAdapter;
@@ -270,25 +273,34 @@ export declare function releaseConversationWork(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<boolean>;
+/** Count one failed execution attempt and stop the conversation when retries are exhausted. */
+export declare function recordConversationRetry(args: {
+    conversationId: string;
+    leaseToken: string;
+    nowMs?: number;
+    state?: StateAdapter;
+}): Promise<"lost_lease" | "recorded" | "stopped">;
 /** Finish a leased conversation and report whether runnable work remains. */
 export declare function completeConversationWork(args: {
     conversationId: string;
     leaseToken: string;
+    madeProgress?: boolean;
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<"completed" | "lost_lease" | "pending">;
-/** Failure outcome: `lost_lease` (another owner took over), `recorded` (attempt counted), or `skipped` (durable progress was made). */
+/** Failure outcome: `lost_lease` (another owner took over), `recorded` (retry counted), or `skipped` (durable progress was made). */
 export interface AttemptFailure {
     pendingCount: number;
     deadLetteredMessages: InboundMessage[];
+    retryCount: number;
     status: "lost_lease" | "recorded" | "skipped";
 }
 /**
- * Record one failed delivery attempt for the pending messages a run attempted,
- * dead-lettering messages that reach the retry limit so a deterministic
- * failure cannot requeue forever.
+ * Record one failed execution attempt for pending messages, dead-lettering
+ * the conversation when its retry budget or the legacy message delivery limit
+ * is exhausted.
  *
- * Attempts are counted only when the run made no durable progress: if any
+ * Retries are counted only when the run made no durable progress: if any
  * attempted message left the mailbox, the remaining pending entries may be
  * deliberate deferrals and are left untouched. Consumed message ids stay in
  * `inboundMessageIds` so source retries remain duplicates.
@@ -307,12 +319,12 @@ export declare function deadLetterAttempt(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<"failed" | "lost_lease" | "pending">;
-/** Clear an expired durable lease so a later worker can resume safely. */
+/** Recover an expired lease, consuming the retry budget under the mutation lock. */
 export declare function clearExpiredConversationLease(args: {
     conversationId: string;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<boolean>;
+}): Promise<"not_expired" | "requeued" | "stopped">;
 /** Delete one conversation mailbox and all of its index entries. */
 export declare function deleteConversationState(args: {
     conversationId: string;

package/dist/chat/task-execution/store.d.ts

@@ -2,7 +2,7 @@ import type { StateAdapter } from "chat";
 import type { ConversationStore } from "@/chat/conversations/store";
 import type { ConversationWorkQueue } from "./queue";
 import * as workState from "./state";
-export { CONVERSATION_ACTIVE_INDEX_KEY, CONVERSATION_BY_ACTIVITY_INDEX_KEY, CONVERSATION_WORK_CHECK_IN_INTERVAL_MS, CONVERSATION_WORK_LEASE_TTL_MS, CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS, CONVERSATION_WORK_STALE_ENQUEUE_MS, isFinalAttempt, isInvalidConversationRecordError, type AgentInput, type AttemptFailure, type AppendAndEnqueueInboundMessageResult, type AppendInboundMessageResult, type Conversation, type ConversationExecution, type ConversationWorkLease, type ConversationWorkState, type ExecutionStatus, type InboundMessage, type InboundMessageDelivery, type Lease, type RequestConversationWorkResult, type Source, type StartConversationWorkAcquired, type StartConversationWorkActive, type StartConversationWorkNoWork, type StartConversationWorkResult, } from "@/chat/task-execution/state";
+export { CONVERSATION_ACTIVE_INDEX_KEY, CONVERSATION_BY_ACTIVITY_INDEX_KEY, CONVERSATION_WORK_CHECK_IN_INTERVAL_MS, CONVERSATION_WORK_LEASE_TTL_MS, CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS, CONVERSATION_WORK_MAX_RETRIES, CONVERSATION_WORK_STALE_ENQUEUE_MS, isFinalAttempt, isInvalidConversationRecordError, type AgentInput, type AttemptFailure, type AppendAndEnqueueInboundMessageResult, type AppendInboundMessageResult, type Conversation, type ConversationExecution, type ConversationWorkLease, type ConversationWorkState, type ExecutionStatus, type InboundMessage, type InboundMessageDelivery, type Lease, type RequestConversationWorkResult, type Source, type StartConversationWorkAcquired, type StartConversationWorkActive, type StartConversationWorkNoWork, type StartConversationWorkResult, } from "@/chat/task-execution/state";
 import type { AppendAndEnqueueInboundMessageResult, Conversation, InboundMessage } from "@/chat/task-execution/state";
 export type EnsureConversationWakeResult = {
     queueMessageId?: string;
@@ -20,6 +20,14 @@ export declare function getConversationWorkState(args: {
     conversationId: string;
     state?: StateAdapter;
 }): Promise<workState.ConversationWorkState | undefined>;
+/** Count one failed conversation execution and persist its terminal retry state. */
+export declare function recordConversationRetry(args: {
+    conversationId: string;
+    conversationStore?: ConversationStore;
+    leaseToken: string;
+    nowMs?: number;
+    state?: StateAdapter;
+}): Promise<"stopped" | "lost_lease" | "recorded">;
 /** Count mailbox messages that have not yet reached the conversation event log. */
 export declare function countPendingConversationMessages(conversation: Conversation): number;
 /** Return whether a conversation has pending or resumable execution work. */
@@ -98,14 +106,6 @@ export declare function drainConversationMailbox(args: Parameters<typeof workSta
     conversationId: string;
     createdAtMs: number;
     delivery: "defer" | "interrupt";
-    destination: {
-        platform: "slack";
-        teamId: string;
-        channelId: string;
-    } | {
-        platform: "local";
-        conversationId: string;
-    };
     inboundMessageId: string;
     input: {
         text: string;
@@ -116,6 +116,14 @@ export declare function drainConversationMailbox(args: Parameters<typeof workSta
     receivedAtMs: number;
     source: "slack" | "plugin" | "local" | "api" | "internal" | "resource_event" | "scheduler";
     attemptCount?: number | undefined;
+    destination?: {
+        platform: "slack";
+        teamId: string;
+        channelId: string;
+    } | {
+        platform: "local";
+        conversationId: string;
+    } | undefined;
     injectedAtMs?: number | undefined;
 }[]>;
 /** Acknowledge leased mailbox entries after the handler accepts responsibility. */
@@ -156,6 +164,7 @@ export declare function releaseConversationWork(args: {
 export declare function completeConversationWork(args: {
     conversationId: string;
     leaseToken: string;
+    madeProgress?: boolean;
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
@@ -177,13 +186,13 @@ export declare function deadLetterAttempt(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<"pending" | "failed" | "lost_lease">;
-/** Clear an expired durable lease so a later worker can resume safely. */
+/** Recover an expired lease and persist the resulting retry state. */
 export declare function clearExpiredConversationLease(args: {
     conversationId: string;
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<boolean>;
+}): Promise<"stopped" | "not_expired" | "requeued">;
 /** Remove one conversation from the active index after it is missing or idle. */
 export declare function removeActiveConversation(args: {
     conversationId: string;

package/dist/chat/task-execution/worker.d.ts

@@ -8,13 +8,13 @@ export interface ConversationWorkerContext {
     attempt: InboxAttempt;
     checkIn(): Promise<boolean>;
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     shouldYield(): boolean;
 }
 export interface InboxAttempt {
     ack(): Promise<void>;
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     drain(handle: (messages: InboundMessage[]) => Promise<readonly string[] | void>): Promise<InboundMessage[]>;
     isFinalAttempt: boolean;
     messages: InboundMessage[];

package/dist/chat/tools/runtime/spawn-agent.d.ts

@@ -0,0 +1,31 @@
+import type { ToolRuntimeContext } from "@/chat/tools/types";
+export declare const SPAWN_AGENT_TOOL_NAME = "spawnAgent";
+/** Create the asynchronous child-agent tool for one parent run. */
+export declare function createSpawnAgentTool(spawnAgent: NonNullable<ToolRuntimeContext["spawnAgent"]>): Omit<import("../definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {
+    inputSchema: import("../definition").JsonSchemaObject;
+    outputSchema: import("../definition").JsonSchemaObject;
+    prepareArguments(args: unknown): {
+        task: string;
+        name?: string | null | undefined;
+        reasoning_level?: "low" | "medium" | "high" | "xhigh" | "none" | null | undefined;
+    };
+    execute?: ((input: unknown, options: import("../definition").ToolExecuteOptions) => {
+        [x: string]: unknown;
+        invocation_id: string;
+        target?: string | undefined;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+    } | Promise<{
+        [x: string]: unknown;
+        invocation_id: string;
+        target?: string | undefined;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+    }>) | undefined;
+};

package/dist/chat/tools/types.d.ts

@@ -11,6 +11,7 @@ import type { LocalActor, Actor, SlackActor } from "@/chat/actor";
 import type { SlackActionToken } from "@/chat/slack/action-token";
 import type { ModelProfile } from "@/chat/model-profile";
 import type { GeneratedArtifactFileRef } from "@/chat/tools/sandbox/file-uploads";
+import type { SpawnAgent } from "@/chat/agent/request";
 interface HandoffControl {
     /** Non-empty catalog of configured targets. */
     profiles: readonly [ModelProfile, ...ModelProfile[]];
@@ -55,6 +56,7 @@ export interface ToolHooks {
 }
 interface BaseToolRuntimeContext {
     handoff?: HandoffControl;
+    spawnAgent?: SpawnAgent;
     /**
      * Opaque Junior conversation/session identity for this turn.
      * Interactive Slack turns use `slack:{channelId}:{threadTs}`.

package/dist/chunk-3Y47VMHV.js

@@ -0,0 +1,6 @@
+// src/chat/state/ttl.ts
+var JUNIOR_THREAD_STATE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+
+export {
+  JUNIOR_THREAD_STATE_TTL_MS
+};

package/dist/chunk-5IDFPCON.js

@@ -0,0 +1,46 @@
+// src/chat/experimental.ts
+var EXPERIMENTAL_FEATURES = ["subagents"];
+var EXPERIMENTAL_FEATURE_SET = new Set(EXPERIMENTAL_FEATURES);
+var configuredExperimental = {};
+function isExperimentalFeature(value) {
+  return EXPERIMENTAL_FEATURE_SET.has(value);
+}
+function setExperimentalFeatures(config) {
+  const previous = { ...configuredExperimental };
+  if (config === void 0) {
+    configuredExperimental = {};
+    return previous;
+  }
+  const next = {};
+  for (const [rawName, enabled] of Object.entries(config)) {
+    if (enabled === void 0) {
+      continue;
+    }
+    if (typeof enabled !== "boolean") {
+      throw new Error(
+        `experimental.${rawName} must be a boolean when provided`
+      );
+    }
+    if (!isExperimentalFeature(rawName)) {
+      throw new Error(
+        `experimental.${rawName} is not a known experimental feature. Known features: ${EXPERIMENTAL_FEATURES.join(", ")}`
+      );
+    }
+    next[rawName] = enabled;
+  }
+  configuredExperimental = next;
+  return previous;
+}
+function getExperimentalFeatures() {
+  return { ...configuredExperimental };
+}
+function isExperimentalFeatureEnabled(feature) {
+  return configuredExperimental[feature] === true;
+}
+
+export {
+  EXPERIMENTAL_FEATURES,
+  setExperimentalFeatures,
+  getExperimentalFeatures,
+  isExperimentalFeatureEnabled
+};