@workerdeck/core 3.4.0 → 3.6.1

package/build/index.d.mts

@@ -1,5 +1,5 @@
 import { McpServerStatus, Options, Query, SDKMessage, SDKSessionInfo, SDKUserMessage, SessionMessage } from "@anthropic-ai/claude-agent-sdk";
-import { ApiMessage, ByModel, ChecklistItem, ContextReading, ContextUsageCategory, CostBreakdown, CreateSessionRequest, EngineCapabilities, McpServerConfigWire, McpServerStatusInfo, MessageAttachment, MessageOrigin, ModelOption, PeerSessionSummary, PermissionDecisionSource, PermissionMode, PermissionRequest, PricingTable, ProfileEngine, ProfileInfo, ProviderContextWindow, SdkSessionSummary, SessionEvent, SessionEventBody, SessionInfo, SessionStatus, ShellEndReason, ShellInfo, ShellOwner, ShellStatus, ToolCallRequestFrame, ToolExecutionBackend, ToolExecutionOutput } from "@workerdeck/protocol";
+import { ApiMessage, ByModel, ChecklistItem, ContextReading, ContextUsageCategory, CostBreakdown, CreateSessionRequest, EngineCapabilities, McpServerConfigWire, McpServerStatusInfo, MessageAttachment, MessageOrigin, ModelOption, PeerSessionSummary, PermissionDecisionSource, PermissionMode, PermissionRequest, PricingTable, ProfileEngine, ProfileInfo, ProviderContextWindow, SdkSessionSummary, SessionEvent, SessionEventBody, SessionInfo, SessionStatus, ShellEndReason, ShellInfo, ShellOwner, ShellStatus, StatusLabel, StatusLabelInput, ToolCallRequestFrame, ToolExecutionBackend, ToolExecutionOutput } from "@workerdeck/protocol";
 import { z } from "zod";
 import { LanguageModel, LanguageModel as LanguageModel$1, ModelMessage, Tool, Tool as Tool$1, ToolSet, ToolSet as ToolSet$1 } from "ai";
 import { SandboxEngine, SandboxVfs } from "@workerdeck/sandbox";
@@ -26,6 +26,15 @@ type GatewayToolSpec<N extends string = string> = {
   inputSchema: Record<string, unknown>;
 };
 //#endregion
+//#region src/lib/avatar-tool.d.ts
+interface AvatarDirectory {
+  change(sessionId: string, seed?: string): Promise<string>;
+}
+declare const CHANGE_AVATAR_TOOL = "change_avatar";
+declare const AVATAR_SEED_MAX = 64;
+declare function installAvatarDirectory(directory: AvatarDirectory | undefined): void;
+declare function avatarDirectoryHandle(own?: () => AvatarDirectory | undefined): AvatarDirectory;
+//#endregion
 //#region src/lib/context-reset.d.ts
 type ContextResetRequest = {
   prompt: string;
@@ -402,6 +411,7 @@ type EngineRunnerConfig = CreateSessionRequest & {
   instructions?: SessionInstructions;
   defaultApprovalTimeoutMs?: number | null;
   peers?: PeerDirectory;
+  avatar?: AvatarDirectory;
   contextReset?: ContextResetDirectory;
   shells?: ShellDirectory;
   shellAgentWrite?: ShellAgentWrite;
@@ -409,6 +419,7 @@ type EngineRunnerConfig = CreateSessionRequest & {
   fallbackTitle?: string;
   startAsleep?: boolean;
   effortDefaults?: Record<string, string>;
+  statusLabel?: StatusLabel;
 };
 type ParkedExecution = {
   executionId: string;
@@ -465,6 +476,7 @@ interface Runner {
   reconnectMcpServer?(name: string): Promise<void>;
   setMcpServerEnabled?(name: string, enabled: boolean): Promise<void>;
   setTitle(title: string | undefined): void;
+  setStatusLabel?(label: StatusLabelInput | null): StatusLabel | null;
   resolvePermission(requestId: string, decision: PermissionDecision): boolean;
   interrupt(): Promise<void>;
   stopTask?(toolUseId: string): Promise<boolean>;
@@ -492,6 +504,7 @@ declare class EventLog {
   get proseCount(): number;
   get contextUsage(): ContextReading | undefined;
   get checklist(): ChecklistItem[] | undefined;
+  get statusLabel(): StatusLabel | null | undefined;
   get resetSeq(): number;
   get lastActivityAt(): number | undefined;
   append(body: SessionEventBody): SessionEvent;
@@ -639,9 +652,15 @@ type SessionReportInput = {
 declare const SESSION_INFO_TOOL = "session_info";
 declare function buildSessionReport(input: SessionReportInput): SessionReport;
 //#endregion
+//#region src/lib/status-label.d.ts
+type StatusLabelSink = (label: StatusLabelInput | null) => StatusLabel | null;
+declare const SET_STATUS_TOOL = "set_status";
+//#endregion
 //#region src/lib/session-tools.d.ts
 type SessionToolSources = {
   report?: SessionReportSource;
+  status?: StatusLabelSink;
+  avatar?: AvatarDirectory;
   reset?: ContextResetDirectory;
   peers?: PeerDirectory;
   shells?: ShellDirectory;
@@ -676,6 +695,7 @@ declare abstract class EngineRunner<C extends EngineRunnerConfig> {
   get lastSeq(): number;
   get pendingApprovals(): PermissionRequest[];
   setTitle(title: string | undefined): void;
+  setStatusLabel(input: StatusLabelInput | null): StatusLabel | null;
   carryCost(state: CostLedgerState): void;
   costState(): CostLedgerState;
   resolvePermission(requestId: string, decision: PermissionDecision): boolean;
@@ -704,6 +724,7 @@ declare abstract class EngineRunner<C extends EngineRunnerConfig> {
     scope: Record<string, string> | undefined;
     agentContextReset: true | undefined;
     title: string | undefined;
+    statusLabel: StatusLabel | undefined;
     costUsd: number | undefined;
     usageByModel: import("@workerdeck/protocol").ByModel | undefined;
     lastActivityAt: number | undefined;
@@ -1038,6 +1059,8 @@ type ToolContextOptions = {
   shellWrite?: boolean;
   selfId?: () => string;
   report?: SessionReportSource;
+  status?: StatusLabelSink;
+  avatar?: AvatarDirectory;
 };
 type ToolContext = {
   vfs: SandboxVfs;
@@ -1422,5 +1445,5 @@ declare class JsonRpcStdioConnection {
 //#region src/engines/provider/adapter.d.ts
 declare const providerAdapter: EngineAdapter;
 //#endregion
-export { AiSdkRunner, type AiSdkRunnerConfig, type AiSdkSessionState, type AppServerConnectFn, type AppServerConnectOptions, type AppServerConnection, type AppServerHistoryTurn, type AppServerItem, type AppServerThreadListResponse, type AppServerThreadSummary, type AppServerTokenUsage, type AppServerTurn, type AppServerUserInput, type AttachmentInput, type AttachmentKind, type BridgeAnswer, BrowserBridgeExecutor, type BrowserBridgeExecutorOptions, CLAUDE_CATALOG, CODEX_CATALOG, CONTEXT_RESET_PROMPT_MAX, CONTEXT_RESET_REASON_MAX, CONTEXT_RESET_TOOL, type ClaudeAuthProbe, type ClaudeAuthStatus, type ClearContextOptions, type CodexAdapterConfig, CodexRunner, type CodexRunnerConfig, type ContextResetDirectory, type ContextResetRequest, type CostFigures, CostLedger, type CostLedgerState, type DeferredDispatch, DeferredExecutor, type DeferredExecutorOptions, type EngineAdapter, type EngineAvailability, type EngineRunnerConfig, type EngineRunnerRequest, type EngineSessionOptions, GATEWAY_SECRET_ENV_KEYS, type HeadTail, type HeadTailOptions, type HistoryFn, type HostFetch, type HostToolDefinition, InputQueue, type InstructionsContext, JsonRpcError, JsonRpcStdioConnection, type LanguageModel, type LocalCommandEmit, type LocalCommandEvent, LocalCommandQueue, type LocalCommandResult, type LocalShellSource, type McpConnection, type ModelCatalog, PEER_MCP_SERVER, PEER_MESSAGE_MAX_CHARS, PEER_RECENT_DEFAULT, PEER_RECENT_MAX, PEER_TOOL_NAMES, type ParkedExecution, type PeerDirectory, type PeerMention, type PeerPeek, type PeerSendOptions, type PeerSendResult, type PeerSessionSummary, type PeerToolName, type PeerToolSpec, type PendingEntry, type PendingKind, type PendingOutcome, PendingRequestRegistry, type PendingToolCall, type PermissionDecision, type QueryFn, QuickJsExecutor, type QuickJsExecutorOptions, type RegisterOptions, type Runner, type RunnerSnapshot, SESSION_INFO_TOOL, SHELL_KEYS_MAX, SHELL_KEY_NAMES, SHELL_READ_TOOL_NAMES, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SHELL_WRITE_REFUSAL, SHELL_WRITE_TOOL_NAMES, SUPPORTED_ATTACHMENT_TYPES, type SendMessageOptions, type SessionContextReport, type SessionEventListener, type SessionInstructions, type SessionRateLimitReport, type SessionReport, SessionRunner, type SessionRunnerConfig, type SettledBy, type ShellAgentWrite, type ShellContextOptions, type ShellDirectory, type ShellKeyOptions, type ShellKillResult, type ShellReadOptions, type ShellReadResult, type ShellRunOptions, type ShellSummary, type ShellToolName, type ShellToolOptions, type ShellToolOutput, type ShellToolSpec, type ShellView, type ShellWait, type ShellWriteOptions, type SleepResult, TTY_REDRAW_CARRY, type Tool, type ToolCallOutput, type ToolContext, type ToolContextOptions, type ToolDefinition, type ToolExecutionCall, type ToolExecutionDispatch, type ToolExecutionResult, type ToolExecutor, type ToolSet, type ToolTrust, type WebFetchDigest, type WebFetchFn, type WebFetchOptions, type WebFetchResult, agentMayWrite, attachmentContentBlocks, attachmentKind, attachmentRef, buildSessionReport, checkClaudeAuth, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, contextResetDirectoryHandle, countLines, createEngineSession, createToolContext, createWebFetch, encodeShellKey, encodeShellKeys, getEngineAdapter, headTail, htmlToMarkdown, installContextResetDirectory, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isShellWriteToolName, isSlashCommand, listCodexSessions, localCommandContext, localCommandEvent, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, resolveInstructions, runPeerTool, runShellTool, shellContextText, shellDirectoryHandle, shellInlineText, shellKillText, shellOwnershipRefusal, shellReadText, shellSummary, shellTail, shellToolNames, shellToolNeedsCard, shellToolOf, shellToolSpecs, shellWriteDeniedText, shellWriteToolOf, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyRedraws, ttyText, withHostTools, withMcpTools, withPeerContext, withoutGatewaySecrets, withoutPeerContext };
+export { AVATAR_SEED_MAX, AiSdkRunner, type AiSdkRunnerConfig, type AiSdkSessionState, type AppServerConnectFn, type AppServerConnectOptions, type AppServerConnection, type AppServerHistoryTurn, type AppServerItem, type AppServerThreadListResponse, type AppServerThreadSummary, type AppServerTokenUsage, type AppServerTurn, type AppServerUserInput, type AttachmentInput, type AttachmentKind, type AvatarDirectory, type BridgeAnswer, BrowserBridgeExecutor, type BrowserBridgeExecutorOptions, CHANGE_AVATAR_TOOL, CLAUDE_CATALOG, CODEX_CATALOG, CONTEXT_RESET_PROMPT_MAX, CONTEXT_RESET_REASON_MAX, CONTEXT_RESET_TOOL, type ClaudeAuthProbe, type ClaudeAuthStatus, type ClearContextOptions, type CodexAdapterConfig, CodexRunner, type CodexRunnerConfig, type ContextResetDirectory, type ContextResetRequest, type CostFigures, CostLedger, type CostLedgerState, type DeferredDispatch, DeferredExecutor, type DeferredExecutorOptions, type EngineAdapter, type EngineAvailability, type EngineRunnerConfig, type EngineRunnerRequest, type EngineSessionOptions, GATEWAY_SECRET_ENV_KEYS, type HeadTail, type HeadTailOptions, type HistoryFn, type HostFetch, type HostToolDefinition, InputQueue, type InstructionsContext, JsonRpcError, JsonRpcStdioConnection, type LanguageModel, type LocalCommandEmit, type LocalCommandEvent, LocalCommandQueue, type LocalCommandResult, type LocalShellSource, type McpConnection, type ModelCatalog, PEER_MCP_SERVER, PEER_MESSAGE_MAX_CHARS, PEER_RECENT_DEFAULT, PEER_RECENT_MAX, PEER_TOOL_NAMES, type ParkedExecution, type PeerDirectory, type PeerMention, type PeerPeek, type PeerSendOptions, type PeerSendResult, type PeerSessionSummary, type PeerToolName, type PeerToolSpec, type PendingEntry, type PendingKind, type PendingOutcome, PendingRequestRegistry, type PendingToolCall, type PermissionDecision, type QueryFn, QuickJsExecutor, type QuickJsExecutorOptions, type RegisterOptions, type Runner, type RunnerSnapshot, SESSION_INFO_TOOL, SET_STATUS_TOOL, SHELL_KEYS_MAX, SHELL_KEY_NAMES, SHELL_READ_TOOL_NAMES, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SHELL_WRITE_REFUSAL, SHELL_WRITE_TOOL_NAMES, SUPPORTED_ATTACHMENT_TYPES, type SendMessageOptions, type SessionContextReport, type SessionEventListener, type SessionInstructions, type SessionRateLimitReport, type SessionReport, SessionRunner, type SessionRunnerConfig, type SettledBy, type ShellAgentWrite, type ShellContextOptions, type ShellDirectory, type ShellKeyOptions, type ShellKillResult, type ShellReadOptions, type ShellReadResult, type ShellRunOptions, type ShellSummary, type ShellToolName, type ShellToolOptions, type ShellToolOutput, type ShellToolSpec, type ShellView, type ShellWait, type ShellWriteOptions, type SleepResult, type StatusLabelSink, TTY_REDRAW_CARRY, type Tool, type ToolCallOutput, type ToolContext, type ToolContextOptions, type ToolDefinition, type ToolExecutionCall, type ToolExecutionDispatch, type ToolExecutionResult, type ToolExecutor, type ToolSet, type ToolTrust, type WebFetchDigest, type WebFetchFn, type WebFetchOptions, type WebFetchResult, agentMayWrite, attachmentContentBlocks, attachmentKind, attachmentRef, avatarDirectoryHandle, buildSessionReport, checkClaudeAuth, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, contextResetDirectoryHandle, countLines, createEngineSession, createToolContext, createWebFetch, encodeShellKey, encodeShellKeys, getEngineAdapter, headTail, htmlToMarkdown, installAvatarDirectory, installContextResetDirectory, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isShellWriteToolName, isSlashCommand, listCodexSessions, localCommandContext, localCommandEvent, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, resolveInstructions, runPeerTool, runShellTool, shellContextText, shellDirectoryHandle, shellInlineText, shellKillText, shellOwnershipRefusal, shellReadText, shellSummary, shellTail, shellToolNames, shellToolNeedsCard, shellToolOf, shellToolSpecs, shellWriteDeniedText, shellWriteToolOf, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyRedraws, ttyText, withHostTools, withMcpTools, withPeerContext, withoutGatewaySecrets, withoutPeerContext };
 //# sourceMappingURL=index.d.mts.map

package/build/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { createSdkMcpServer, getSessionInfo, getSessionMessages, listSessions, query, tool } from "@anthropic-ai/claude-agent-sdk";
-import { CHECKLIST_TEXT_MAX, ENGINE_CAPABILITIES, PEER_MENTION_MAX, PROTOCOL_VERSION, SHELL_COMMAND_MAX, SHELL_CONTEXT_FLUSH_MAX_CHARS, SHELL_CONTEXT_HEAD_CHARS, SHELL_CONTEXT_HEAD_LINES, SHELL_CONTEXT_TAIL_CHARS, SHELL_CONTEXT_TAIL_LINES, SHELL_INLINE_CHARS, SHELL_INLINE_LINES, SHELL_INLINE_LINE_CHARS, SHELL_INPUT_MAX, SHELL_INTERACTIVE_NOTE, SHELL_READ_DEFAULT_LINES, SHELL_READ_MAX_LINES, SHELL_WAIT_DEFAULT_MS, SHELL_WAIT_MAX_MS, SUBAGENT_HISTORY, TOOL_RESULT_HEAD_CHARS, addTokenUsage, byModelTotalTokens, canonicalModel, contextReading, costOfByModel, emptyTokenUsage, errorMessage, imagePartRef, logCoalesceKey, mergeByModel, parseTodoWriteInput, peerDeliveredPrefix, replayCoalesceKey, replayRetains, sanitizeToolTitle, snapshotRetains, supportsPermissionMode, tokenUsageFromWire, totalTokens, transcriptActivity, transcriptContent, transcriptProse, usageIsStale } from "@workerdeck/protocol";
+import { CHECKLIST_TEXT_MAX, ENGINE_CAPABILITIES, PEER_MENTION_MAX, PROTOCOL_VERSION, SHELL_COMMAND_MAX, SHELL_CONTEXT_FLUSH_MAX_CHARS, SHELL_CONTEXT_HEAD_CHARS, SHELL_CONTEXT_HEAD_LINES, SHELL_CONTEXT_TAIL_CHARS, SHELL_CONTEXT_TAIL_LINES, SHELL_INLINE_CHARS, SHELL_INLINE_LINES, SHELL_INLINE_LINE_CHARS, SHELL_INPUT_MAX, SHELL_INTERACTIVE_NOTE, SHELL_READ_DEFAULT_LINES, SHELL_READ_MAX_LINES, SHELL_WAIT_DEFAULT_MS, SHELL_WAIT_MAX_MS, STATUS_LABEL_EMOJI_MAX, STATUS_LABEL_TEXT_MAX, SUBAGENT_HISTORY, TOOL_RESULT_HEAD_CHARS, addTokenUsage, byModelTotalTokens, canonicalModel, contextReading, costOfByModel, emptyTokenUsage, errorMessage, imagePartRef, logCoalesceKey, mergeByModel, parseTodoWriteInput, peerDeliveredPrefix, replayCoalesceKey, replayRetains, sanitizeToolTitle, snapshotRetains, supportsPermissionMode, teamRole, tokenUsageFromWire, totalTokens, transcriptActivity, transcriptContent, transcriptProse, usageIsStale } from "@workerdeck/protocol";
 import { z } from "zod";
 import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
@@ -1196,6 +1196,7 @@ var EventLog = class {
 	#proseCount = 0;
 	#contextUsage;
 	#checklist;
+	#statusLabel;
 	#resetSeq = 0;
 	#lastActivityAt;
 	get events() {
@@ -1216,6 +1217,9 @@ var EventLog = class {
 	get checklist() {
 		return this.#checklist;
 	}
+	get statusLabel() {
+		return this.#statusLabel;
+	}
 	get resetSeq() {
 		return this.#resetSeq;
 	}
@@ -1243,6 +1247,7 @@ var EventLog = class {
 		this.#proseCount = 0;
 		this.#contextUsage = void 0;
 		this.#checklist = void 0;
+		this.#statusLabel = void 0;
 		this.#resetSeq = 0;
 		for (const event of events) {
 			this.#fold(event);
@@ -1265,10 +1270,12 @@ var EventLog = class {
 		this.#proseCount += transcriptProse(event);
 		this.#contextUsage = contextReading(event) ?? this.#contextUsage;
 		if (event.type === "checklist") this.#checklist = event.items.length > 0 ? event.items : void 0;
+		if (event.type === "status_label") this.#statusLabel = event.label;
 		if (event.type === "conversation_reset") {
 			this.#resetSeq = event.seq;
 			this.#contextUsage = void 0;
 			this.#checklist = void 0;
+			this.#statusLabel = null;
 		}
 	}
 };
@@ -1958,6 +1965,18 @@ var EngineRunner = class {
 	setTitle(title) {
 		this.config = withTitle(this.config, title);
 	}
+	setStatusLabel(input) {
+		this.assertAccepting();
+		const label = input ? {
+			...input,
+			setAt: Date.now()
+		} : null;
+		this.core.emit({
+			type: "status_label",
+			label
+		});
+		return label;
+	}
 	carryCost(state) {
 		this.core.carryCost(state);
 	}
@@ -2006,6 +2025,8 @@ var EngineRunner = class {
 	get toolSources() {
 		return {
 			report: () => this.sessionReport(),
+			status: (input) => this.setStatusLabel(input),
+			avatar: this.config.avatar,
 			reset: this.config.contextReset,
 			peers: this.config.peers,
 			shells: this.config.shells,
@@ -2031,6 +2052,7 @@ var EngineRunner = class {
 			scope: this.config.scope,
 			agentContextReset: this.config.contextReset ? true : void 0,
 			title: sessionTitle(this.config, engineTitle),
+			statusLabel: (log.statusLabel === void 0 ? this.config.statusLabel : log.statusLabel) ?? void 0,
 			costUsd: this.core.cost.costUsd,
 			usageByModel: this.core.cost.byModel,
 			lastActivityAt: log.lastActivityAt
@@ -2227,7 +2249,23 @@ function peerSummary(info) {
 		model: info.model,
 		contextUsage: info.contextUsage,
 		lastActivityAt: info.lastActivityAt,
-		pendingPermissionCount: info.pendingPermissionCount
+		pendingPermissionCount: info.pendingPermissionCount,
+		...teamFields(info)
+	};
+}
+function teamFields(info) {
+	const agent = info.agent?.name;
+	const named = agent === void 0 ? {} : { agent };
+	const role = teamRole(info.agent);
+	if (role === void 0) return named;
+	const team = role === "member" ? info.agent?.team : info.agent?.name;
+	return team === void 0 ? {
+		...named,
+		role
+	} : {
+		...named,
+		role,
+		team
 	};
 }
 function recentLines(events, limit) {
@@ -2320,6 +2358,61 @@ function agentResetFields(options) {
 	return options?.agentReason === void 0 ? {} : { agentReason: options.agentReason };
 }
 //#endregion
+//#region src/lib/avatar-tool.ts
+const CHANGE_AVATAR_TOOL = "change_avatar";
+const AVATAR_SEED_MAX = 64;
+const AVATAR_SLOT = globalSlot("workerdeck.avatar.directory");
+const CHANGE_AVATAR_TOOL_SHAPES = { [CHANGE_AVATAR_TOOL]: {
+	description: "Give yourself a new avatar: the picture the human sees beside your name in the session list. Each call rolls a new one; pass `seed` to get the same avatar for the same seed (any short word or phrase). On the workerdeck CLI a seed starting with a pack name and a colon picks the family: `monkey:`, `toad:`, `steampunk-bulldogs:` or `panda:`. You cannot see the result, so only change it when the human asks or you have a reason to.",
+	shape: { seed: z.string().trim().min(1).max(64).optional().describe("Optional: the same seed always rolls the same avatar") }
+} };
+const CHANGE_AVATAR_TOOLS = defineToolFamily(CHANGE_AVATAR_TOOL_SHAPES, { [CHANGE_AVATAR_TOOL]: async (directory, from, input) => ({
+	text: await directory.change(from, input.seed),
+	isError: false
+}) });
+const CHANGE_AVATAR_TOOL_SHAPE = CHANGE_AVATAR_TOOL_SHAPES[CHANGE_AVATAR_TOOL];
+function isChangeAvatarToolName(name) {
+	return CHANGE_AVATAR_TOOLS.is(name);
+}
+function runChangeAvatarTool(directory, from, args) {
+	return CHANGE_AVATAR_TOOLS.run(directory, from, CHANGE_AVATAR_TOOL, args);
+}
+function installAvatarDirectory(directory) {
+	AVATAR_SLOT.install(directory);
+}
+function avatarDirectoryHandle(own) {
+	return lateBoundDirectory(["change"], AVATAR_SLOT, own, "avatars are not available on this gateway");
+}
+//#endregion
+//#region src/lib/status-label.ts
+const SET_STATUS_TOOL = "set_status";
+const SET_STATUS_TOOL_SHAPES = { [SET_STATUS_TOOL]: {
+	description: "Set the one-line status shown under your name in the human's session list, like a chat status: what you are doing, waiting on, or need from them (\"waiting on CI\", \"blocked: needs an API key\", \"done, ready for review\"). It stays until you change it and clears when your conversation is reset. Pass an empty `text` to clear it. Keep it short and current; it is a glance, not a log.",
+	shape: {
+		text: z.string().max(STATUS_LABEL_TEXT_MAX).describe("The status line; empty clears it"),
+		emoji: z.string().max(STATUS_LABEL_EMOJI_MAX).optional().describe("One emoji shown before the text")
+	}
+} };
+const SET_STATUS_TOOLS = defineToolFamily(SET_STATUS_TOOL_SHAPES, { [SET_STATUS_TOOL]: async (sink, _from, input) => {
+	const text = input.text.replace(/\s+/g, " ").trim();
+	const emoji = input.emoji?.trim();
+	const label = sink(text ? emoji ? {
+		text,
+		emoji
+	} : { text } : null);
+	return {
+		text: label ? `Status set: ${label.emoji ? `${label.emoji} ` : ""}${label.text}` : "Status cleared",
+		isError: false
+	};
+} });
+const SET_STATUS_TOOL_SHAPE = SET_STATUS_TOOL_SHAPES[SET_STATUS_TOOL];
+function isSetStatusToolName(name) {
+	return SET_STATUS_TOOLS.is(name);
+}
+function runSetStatusTool(sink, from, args) {
+	return SET_STATUS_TOOLS.run(sink, from, SET_STATUS_TOOL, args);
+}
+//#endregion
 //#region src/lib/shells.ts
 const SHELL_REFUSAL = "shell commands are not available on this session";
 const SHELL_WRITE_REFUSAL = "the agent may not start, type into or kill shells on this session (shell.agentWrite is read-only)";
@@ -2668,13 +2761,23 @@ function shellDirectoryHandle(own) {
 //#endregion
 //#region src/lib/session-tools.ts
 function sessionTools(sources, from) {
-	const { report, reset, peers, shells, write } = sources;
+	const { report, status, avatar, reset, peers, shells, write } = sources;
 	return [
 		...report ? [{
 			name: SESSION_INFO_TOOL,
 			...SESSION_INFO_TOOL_SHAPE,
 			run: () => runSessionInfoTool(report, from())
 		}] : [],
+		...status ? [{
+			name: SET_STATUS_TOOL,
+			...SET_STATUS_TOOL_SHAPE,
+			run: (args) => runSetStatusTool(status, from(), args)
+		}] : [],
+		...avatar ? [{
+			name: CHANGE_AVATAR_TOOL,
+			...CHANGE_AVATAR_TOOL_SHAPE,
+			run: (args) => runChangeAvatarTool(avatar, from(), args)
+		}] : [],
 		...reset ? [{
 			name: CONTEXT_RESET_TOOL,
 			...CONTEXT_RESET_TOOL_SHAPE,
@@ -2697,6 +2800,8 @@ function sessionToolSpecs(sources) {
 }
 function runSessionTool(sources, from, name, args) {
 	if (sources.report && isSessionInfoToolName(name)) return runSessionInfoTool(sources.report, from);
+	if (sources.status && isSetStatusToolName(name)) return runSetStatusTool(sources.status, from, args);
+	if (sources.avatar && isChangeAvatarToolName(name)) return runChangeAvatarTool(sources.avatar, from, args);
 	if (sources.reset && isContextResetToolName(name)) return runContextResetTool(sources.reset, from, args);
 	if (sources.peers && isPeerToolName(name)) return runPeerTool(sources.peers, from, name, args);
 	if (sources.shells && isShellToolName(name)) return runShellTool(sources.shells, from, name, args, { write: sources.write });
@@ -5346,6 +5451,8 @@ function createToolContext(options) {
 	}
 	const gatewayTools = sessionTools({
 		report: options.report,
+		status: options.status,
+		avatar: options.avatar,
 		reset: options.contextReset,
 		peers: options.peers,
 		shells: options.shells,
@@ -5523,10 +5630,15 @@ function createEngineSession(options) {
 		onFileDelivered: options.capabilities?.deliverFiles === false || !isGranted("deliverFiles") ? void 0 : (file) => runner?.emitFileDelivered(file),
 		peers: options.config.peers,
 		contextReset: options.config.contextReset,
+		avatar: options.config.avatar,
 		shells: options.config.shells,
 		shellWrite: options.config.shellAgentWrite !== void 0,
 		selfId: () => runner?.id ?? "pending",
-		report: () => runner ? runner.sessionReport() : Promise.reject(/* @__PURE__ */ new Error("session is still starting"))
+		report: () => runner ? runner.sessionReport() : Promise.reject(/* @__PURE__ */ new Error("session is still starting")),
+		status: (label) => {
+			if (!runner) throw new Error("session is still starting");
+			return runner.setStatusLabel(label);
+		}
 	});
 	const declaredServers = options.profile?.session?.mcpServers;
 	const connected = options.mcp?.tools ?? options.mcpTools;
@@ -8316,6 +8428,6 @@ function getEngineAdapter(engine) {
 	return ADAPTERS[engine ?? "claude"];
 }
 //#endregion
-export { AiSdkRunner, BrowserBridgeExecutor, CLAUDE_CATALOG, CODEX_CATALOG, CONTEXT_RESET_PROMPT_MAX, CONTEXT_RESET_REASON_MAX, CONTEXT_RESET_TOOL, CodexRunner, CostLedger, DeferredExecutor, GATEWAY_SECRET_ENV_KEYS, InputQueue, JsonRpcError, JsonRpcStdioConnection, LocalCommandQueue, PEER_MCP_SERVER, PEER_MESSAGE_MAX_CHARS, PEER_RECENT_DEFAULT, PEER_RECENT_MAX, PEER_TOOL_NAMES, PendingRequestRegistry, QuickJsExecutor, SESSION_INFO_TOOL, SHELL_KEYS_MAX, SHELL_KEY_NAMES, SHELL_READ_TOOL_NAMES, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SHELL_WRITE_REFUSAL, SHELL_WRITE_TOOL_NAMES, SUPPORTED_ATTACHMENT_TYPES, SessionRunner, TTY_REDRAW_CARRY, agentMayWrite, attachmentContentBlocks, attachmentKind, attachmentRef, buildSessionReport, checkClaudeAuth, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, contextResetDirectoryHandle, countLines, createEngineSession, createToolContext, createWebFetch, encodeShellKey, encodeShellKeys, getEngineAdapter, headTail, htmlToMarkdown, installContextResetDirectory, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isShellWriteToolName, isSlashCommand, listCodexSessions, localCommandContext, localCommandEvent, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, resolveInstructions, runPeerTool, runShellTool, shellContextText, shellDirectoryHandle, shellInlineText, shellKillText, shellOwnershipRefusal, shellReadText, shellSummary, shellTail, shellToolNames, shellToolNeedsCard, shellToolOf, shellToolSpecs, shellWriteDeniedText, shellWriteToolOf, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyRedraws, ttyText, withHostTools, withMcpTools, withPeerContext, withoutGatewaySecrets, withoutPeerContext };
+export { AVATAR_SEED_MAX, AiSdkRunner, BrowserBridgeExecutor, CHANGE_AVATAR_TOOL, CLAUDE_CATALOG, CODEX_CATALOG, CONTEXT_RESET_PROMPT_MAX, CONTEXT_RESET_REASON_MAX, CONTEXT_RESET_TOOL, CodexRunner, CostLedger, DeferredExecutor, GATEWAY_SECRET_ENV_KEYS, InputQueue, JsonRpcError, JsonRpcStdioConnection, LocalCommandQueue, PEER_MCP_SERVER, PEER_MESSAGE_MAX_CHARS, PEER_RECENT_DEFAULT, PEER_RECENT_MAX, PEER_TOOL_NAMES, PendingRequestRegistry, QuickJsExecutor, SESSION_INFO_TOOL, SET_STATUS_TOOL, SHELL_KEYS_MAX, SHELL_KEY_NAMES, SHELL_READ_TOOL_NAMES, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SHELL_WRITE_REFUSAL, SHELL_WRITE_TOOL_NAMES, SUPPORTED_ATTACHMENT_TYPES, SessionRunner, TTY_REDRAW_CARRY, agentMayWrite, attachmentContentBlocks, attachmentKind, attachmentRef, avatarDirectoryHandle, buildSessionReport, checkClaudeAuth, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, contextResetDirectoryHandle, countLines, createEngineSession, createToolContext, createWebFetch, encodeShellKey, encodeShellKeys, getEngineAdapter, headTail, htmlToMarkdown, installAvatarDirectory, installContextResetDirectory, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isShellWriteToolName, isSlashCommand, listCodexSessions, localCommandContext, localCommandEvent, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, resolveInstructions, runPeerTool, runShellTool, shellContextText, shellDirectoryHandle, shellInlineText, shellKillText, shellOwnershipRefusal, shellReadText, shellSummary, shellTail, shellToolNames, shellToolNeedsCard, shellToolOf, shellToolSpecs, shellWriteDeniedText, shellWriteToolOf, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyRedraws, ttyText, withHostTools, withMcpTools, withPeerContext, withoutGatewaySecrets, withoutPeerContext };
 
 //# sourceMappingURL=index.mjs.map