@agent-team-foundation/first-tree-hub 0.13.0 → 0.14.1

package/dist/{bootstrap-Cya2OoHz.mjs → bootstrap-C15ZBOCC.mjs}

@@ -552,6 +552,7 @@ const serverConfigSchema = defineConfig({
 		host: field(z.string().default("127.0.0.1"), { env: "FIRST_TREE_HUB_HOST" }),
 		publicUrl: field(z.string().optional(), { env: "FIRST_TREE_HUB_PUBLIC_URL" })
 	},
+	workspace: { root: field(z.string().default(join(DEFAULT_DATA_DIR, "workspaces")), { env: "FIRST_TREE_HUB_WORKSPACES_ROOT" }) },
 	secrets: {
 		jwtSecret: field(z.string(), {
 			env: "FIRST_TREE_HUB_JWT_SECRET",

package/dist/cli/index.mjs

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import "../observability-BAScT_5S-BcW9HgkG.mjs";
-import { $ as formatStaleReason, A as checkDocker, B as isServiceSupported, C as createApiNameResolver, D as checkBackgroundService, E as checkAgentConfigs, F as checkWebSocket, H as restartClientService, I as printResults, J as stopPostgres, L as reconcileAgentConfigs, M as checkServerConfig, N as checkServerHealth, O as checkClientConfig, P as checkServerReachable, Q as findStaleAliases, R as getClientServiceStatus, S as runHomeMigration, T as runMigrations, U as startClientService, W as stopClientService, X as handleClientOrgMismatch, Y as ClientRuntime, _ as formatCheckReport, a as declineUpdate, at as fail, b as onboardCreate, c as detectInstallMode, ct as ClientUserMismatchError, d as startServer, dt as SessionRegistry, et as removeLocalAgent, f as reconcileLocalRuntimeProviders, ft as cleanWorkspaces, g as promptMissingFields, h as promptAddAgent, ht as configureClientLoggerForService, i as createExecuteUpdate, it as resolveSenderName, j as checkNodeVersion, k as checkDatabase, l as fetchLatestVersion, lt as FirstTreeHubSDK, m as isInteractive, mt as applyClientLoggerConfig, o as promptUpdate, ot as success, p as uploadClientCapabilities, pt as probeCapabilities, r as registerSaaSConnectCommand, rt as resolveReplyToFromEnv, s as PACKAGE_NAME, st as ClientOrgMismatchError, tt as createOwner, u as installGlobalLatest, ut as SdkError, v as loadOnboardState, w as migrateLocalAgentDirs, x as saveOnboardState, y as onboardCheck, z as installClientService } from "../saas-connect-Bb5LR4y6.mjs";
+import { $ as formatStaleReason, A as checkDocker, B as isServiceSupported, C as createApiNameResolver, D as checkBackgroundService, E as checkAgentConfigs, F as checkWebSocket, H as restartClientService, I as printResults, J as stopPostgres, L as reconcileAgentConfigs, M as checkServerConfig, N as checkServerHealth, O as checkClientConfig, P as checkServerReachable, Q as findStaleAliases, R as getClientServiceStatus, S as runHomeMigration, T as runMigrations, U as startClientService, W as stopClientService, X as handleClientOrgMismatch, Y as ClientRuntime, _ as formatCheckReport, a as declineUpdate, at as fail, b as onboardCreate, c as detectInstallMode, ct as ClientUserMismatchError, d as startServer, dt as SessionRegistry, et as removeLocalAgent, f as reconcileLocalRuntimeProviders, ft as cleanWorkspaces, g as promptMissingFields, h as promptAddAgent, ht as configureClientLoggerForService, i as createExecuteUpdate, it as resolveSenderName, j as checkNodeVersion, k as checkDatabase, l as fetchLatestVersion, lt as FirstTreeHubSDK, m as isInteractive, mt as applyClientLoggerConfig, o as promptUpdate, ot as success, p as uploadClientCapabilities, pt as probeCapabilities, r as registerSaaSConnectCommand, rt as resolveReplyToFromEnv, s as PACKAGE_NAME, st as ClientOrgMismatchError, tt as createOwner, u as installGlobalLatest, ut as SdkError, v as loadOnboardState, w as migrateLocalAgentDirs, x as saveOnboardState, y as onboardCheck, z as installClientService } from "../saas-connect-BBRxjmBS.mjs";
 import "../logger-core-BTmvdflj-DjW8FM4T.mjs";
-import { C as resetConfigMeta, E as setConfigValue, S as resetConfig, T as serverConfigSchema, _ as getConfigValue, a as ensureFreshAdminToken, c as resolveServerUrl, d as DEFAULT_CONFIG_DIR, f as DEFAULT_DATA_DIR, h as clientConfigSchema, i as ensureFreshAccessToken, l as saveAgentConfig, m as agentConfigSchema, o as loadCredentials, p as DEFAULT_HOME_DIR, v as initConfig, w as resolveConfigReadonly, x as readConfigFile, y as loadAgents } from "../bootstrap-Cya2OoHz.mjs";
+import { C as resetConfigMeta, E as setConfigValue, S as resetConfig, T as serverConfigSchema, _ as getConfigValue, a as ensureFreshAdminToken, c as resolveServerUrl, d as DEFAULT_CONFIG_DIR, f as DEFAULT_DATA_DIR, h as clientConfigSchema, i as ensureFreshAccessToken, l as saveAgentConfig, m as agentConfigSchema, o as loadCredentials, p as DEFAULT_HOME_DIR, v as initConfig, w as resolveConfigReadonly, x as readConfigFile, y as loadAgents } from "../bootstrap-C15ZBOCC.mjs";
 import { a as print, n as CLI_USER_AGENT, o as setJsonMode, r as COMMAND_VERSION, t as cliFetch } from "../cli-fetch--tiwKm5S.mjs";
-import "../dist-C8yStx2L.mjs";
-import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-D_vnqC6a.mjs";
+import "../dist-1XGLJMOq.mjs";
+import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-BGx71p5s.mjs";
 import "../errors-LPcARA4K-Dbrptiyz.mjs";
 import "../src-DNBS5Yjj.mjs";
-import "../client-BH4CmUL0-CybE3kuP.mjs";
+import "../client-CzXmweS9-DhUiuQvL.mjs";
 import "../invitation-DZO4NX3P-BPxTeHf-.mjs";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
@@ -1495,13 +1495,13 @@ function decodeJwtExpSeconds(token) {
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-Cya2OoHz.mjs").then((n) => n.r);
+		const { resolveServerUrl } = await import("../bootstrap-C15ZBOCC.mjs").then((n) => n.r);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	const { loadCredentials } = await import("../bootstrap-Cya2OoHz.mjs").then((n) => n.r);
+	const { loadCredentials } = await import("../bootstrap-C15ZBOCC.mjs").then((n) => n.r);
 	if (!loadCredentials()) throw new Error("No saved credentials. Run `first-tree-hub connect <token>` before onboarding.");
 	if (!args.id) {
 		args.id = await input({ message: "Agent ID:" });

package/dist/{client-h4KZ3b9o-CQyibXig.mjs → client-CREn8bJ0-C5fHJir6.mjs}

@@ -1,7 +1,7 @@
 import "./observability-BAScT_5S-BcW9HgkG.mjs";
 import "./logger-core-BTmvdflj-DjW8FM4T.mjs";
-import "./dist-C8yStx2L.mjs";
+import "./dist-1XGLJMOq.mjs";
 import "./errors-LPcARA4K-Dbrptiyz.mjs";
 import "./src-DNBS5Yjj.mjs";
-import { J as listMyPinnedAgents } from "./client-BH4CmUL0-CybE3kuP.mjs";
+import { J as listMyPinnedAgents } from "./client-CzXmweS9-DhUiuQvL.mjs";
 export { listMyPinnedAgents };

package/dist/{client-BH4CmUL0-CybE3kuP.mjs → client-CzXmweS9-DhUiuQvL.mjs}

@@ -1,10 +1,10 @@
 import { O as withSpan, f as messageAttrs, s as createLogger } from "./observability-BAScT_5S-BcW9HgkG.mjs";
-import { I as extractMentions, M as defaultParticipantMode, at as questionMessageContentSchema, i as AGENT_STATUSES, it as questionAnswerMessageContentSchema, o as AGENT_VISIBILITY, s as CHAT_ENGAGEMENT_STATUSES, ut as scanMentionTokens, x as clientCapabilitiesSchema, y as agentTypeSchema } from "./dist-C8yStx2L.mjs";
+import { L as extractMentions, N as defaultParticipantMode, S as clientCapabilitiesSchema, b as agentTypeSchema, ct as questionAnswerMessageContentSchema, i as AGENT_STATUSES, lt as questionMessageContentSchema, mt as scanMentionTokens, o as AGENT_VISIBILITY, s as CHAT_ENGAGEMENT_STATUSES } from "./dist-1XGLJMOq.mjs";
 import { a as ConflictError, i as ClientUserMismatchError, l as organizations, n as BadRequestError, o as ForbiddenError, s as NotFoundError, u as users } from "./errors-LPcARA4K-Dbrptiyz.mjs";
 import { randomUUID } from "node:crypto";
 import { and, desc, eq, inArray, isNotNull, lt, ne, or, sql } from "drizzle-orm";
-import { bigserial, boolean, index, integer, jsonb, pgTable, primaryKey, text, timestamp, unique } from "drizzle-orm/pg-core";
-//#region ../server/dist/client-BH4CmUL0.mjs
+import { bigserial, boolean, customType, index, integer, jsonb, pgTable, primaryKey, text, timestamp, unique } from "drizzle-orm/pg-core";
+//#region ../server/dist/client-CzXmweS9.mjs
 /**
 * Client connections. A client is a single SDK process (AgentRuntime) that may
 * host multiple agents. From the unified-user-token milestone on, a client is
@@ -33,6 +33,13 @@ const clients = pgTable("clients", {
 	lastSeenAt: timestamp("last_seen_at", { withTimezone: true }).notNull().defaultNow(),
 	metadata: jsonb("metadata").$type()
 }, (table) => [index("idx_clients_user").on(table.userId), index("idx_clients_org").on(table.organizationId)]);
+/**
+* `bytea` column type — Drizzle ships pg primitives but not bytea out of the
+* box. Reads come back as Node `Buffer` (postgres-js); writes accept any
+* `Uint8Array`. Used for the small inline avatar image blob; no streaming
+* needed at this size (≤ ~50 KB after client-side resize).
+*/
+const bytea = customType({ dataType: () => "bytea" });
 /** Agent registration. Each agent owns a unique inboxId for message delivery. */
 const agents = pgTable("agents", {
 	uuid: text("uuid").primaryKey(),
@@ -49,6 +56,10 @@ const agents = pgTable("agents", {
 	managerId: text("manager_id").notNull(),
 	clientId: text("client_id").references(() => clients.id, { onDelete: "restrict" }),
 	runtimeProvider: text("runtime_provider").notNull().default("claude-code"),
+	avatarColorToken: text("avatar_color_token"),
+	avatarImageData: bytea("avatar_image_data"),
+	avatarImageMime: text("avatar_image_mime"),
+	avatarImageUpdatedAt: timestamp("avatar_image_updated_at", { withTimezone: true }),
 	createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
 	updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (table) => [
@@ -1764,18 +1775,31 @@ async function sendMessageInner(db, chatId, senderId, data, options) {
 			tx.select({ type: chats.type }).from(chats).where(eq(chats.id, chatId)).limit(1),
 			tx.select({
 				inboxId: agents.inboxId,
-				organizationId: agents.organizationId
+				organizationId: agents.organizationId,
+				type: agents.type
 			}).from(agents).where(eq(agents.uuid, senderId)).limit(1)
 		]);
 		const chatType = chatRow?.type ?? null;
 		if (!senderRow) throw new NotFoundError(`Sender agent "${senderId}" not found`);
+		let effectiveContent = data.content;
+		if (senderRow.type !== "human" && typeof effectiveContent === "string") {
+			const unwrapped = maybeUnwrapDoubleEncoded(effectiveContent);
+			if (unwrapped !== null) {
+				log.warn({
+					metric: "double_encoded_content_unwrapped_total",
+					chatId,
+					senderId
+				}, "agent sent JSON-encoded string content — unwrapping to restore markdown rendering");
+				effectiveContent = unwrapped;
+			}
+		}
 		if (data.replyToInbox !== void 0 && data.replyToInbox !== null) {
 			if (senderRow.inboxId !== data.replyToInbox) throw new BadRequestError("replyToInbox must reference the sender's own inbox");
 		}
 		const incomingMeta = data.metadata ?? {};
 		const explicitMentionsRaw = incomingMeta.mentions;
 		const explicitMentions = Array.isArray(explicitMentionsRaw) ? explicitMentionsRaw.filter((m) => typeof m === "string") : [];
-		const contentText = typeof data.content === "string" ? data.content : "";
+		const contentText = typeof effectiveContent === "string" ? effectiveContent : "";
 		const resolved = contentText ? extractMentions(contentText, participants) : [];
 		const mergedMentions = [...new Set([...explicitMentions, ...resolved])];
 		const metadataToStore = mergedMentions.length > 0 ? {
@@ -1786,7 +1810,7 @@ async function sendMessageInner(db, chatId, senderId, data, options) {
 		if (options.enforceGroupMention && chatType === "group") {
 			if (mergedMentions.filter((id) => id !== senderId).length === 0) throw new BadRequestError("Sending to a group chat requires an explicit @mention. Use `first-tree-hub chat send <name>` to message a single agent, or @<name> in the content to address one or more group members.");
 		}
-		let outboundContent = data.content;
+		let outboundContent = effectiveContent;
 		if (options.normalizeMentionsInContent && typeof outboundContent === "string") {
 			const present = new Set(scanMentionTokens(outboundContent));
 			const missingNames = [];
@@ -1898,6 +1922,35 @@ async function sendMessageInner(db, chatId, senderId, data, options) {
 		recipients: txResult.recipients
 	};
 }
+/**
+* Detect agent-sent content that was JSON.stringify-ed once before reaching
+* the CLI / API. The bad shape is an outer `"..."` wrapper + interior `\n` /
+* `\"` escape sequences, which the UI renders as a quoted literal instead of
+* markdown (issue #389). Returns the unwrapped inner string on a confident
+* match, or `null` to leave the content alone.
+*
+* Match conditions (all required) — kept strict so legitimate human content
+* that happens to look like a quoted phrase is never touched. The caller is
+* additionally responsible for restricting this to non-human senders.
+*
+*   - first and last char are `"`
+*   - body contains at least one typical JSON escape sequence
+*     (`\n`, `\r`, `\t`, `\"`, or `\\`)
+*   - `JSON.parse` succeeds
+*   - the parse result is a `string` (excludes `{...}`, `[...]`, numbers)
+*/
+function maybeUnwrapDoubleEncoded(content) {
+	if (content.length < 4) return null;
+	if (content.charCodeAt(0) !== 34) return null;
+	if (content.charCodeAt(content.length - 1) !== 34) return null;
+	if (!/\\[nrt"\\]/.test(content)) return null;
+	try {
+		const parsed = JSON.parse(content);
+		return typeof parsed === "string" ? parsed : null;
+	} catch {
+		return null;
+	}
+}
 function stripMentionPrefix(content) {
 	return content.replace(/^(@\S+\s*)+/, "").trim();
 }

package/dist/{dist-C8yStx2L.mjs → dist-1XGLJMOq.mjs}

@@ -520,6 +520,16 @@ const AGENT_VISIBILITY = {
 	ORGANIZATION: "organization"
 };
 const agentVisibilitySchema = z.enum(["private", "organization"]);
+const avatarColorTokenSchema = z.enum([
+	"hue-0",
+	"hue-1",
+	"hue-2",
+	"hue-3",
+	"hue-4",
+	"hue-5",
+	"hue-6",
+	"hue-7"
+]);
 const AGENT_STATUSES = {
 	ACTIVE: "active",
 	SUSPENDED: "suspended",
@@ -571,7 +581,8 @@ const updateAgentSchema = z.object({
 	visibility: agentVisibilitySchema.optional(),
 	metadata: z.record(z.string(), z.unknown()).optional(),
 	managerId: z.string().nullable().optional(),
-	clientId: z.string().min(1).max(100).nullable().optional()
+	clientId: z.string().min(1).max(100).nullable().optional(),
+	avatarColorToken: avatarColorTokenSchema.nullable().optional()
 });
 /**
 * Service-level rebind input. Admin / owner re-binds an agent to a new
@@ -600,6 +611,8 @@ z.object({
 	managerId: z.string().nullable(),
 	clientId: z.string().nullable(),
 	runtimeProvider: runtimeProviderSchema,
+	avatarColorToken: z.string().nullable(),
+	avatarImageUrl: z.string().nullable(),
 	presenceStatus: presenceStatusSchema.optional(),
 	createdAt: z.string(),
 	updatedAt: z.string()
@@ -637,12 +650,30 @@ z.object({
 	expiresIn: z.number(),
 	command: z.string()
 });
-const githubEntityTypeSchema = z.enum([
+/**
+* `chats.metadata` is `jsonb` at the DB layer. Without a typed contract every
+* writer was free to invent their own keys, so a GitHub webhook writing
+* `{ source: "github", entityKey: "..." }` and a Feishu adapter writing
+* `{ source: "feishu", externalChannelId: "..." }` could collide on shared
+* keys (`source`, `title`). The discriminated union below pins both writers
+* to a single shape and lets TypeScript narrow on `metadata.source`.
+*
+* Add new variants here; do not extend with free-form `Record<string, unknown>`.
+*/
+/**
+* Source of truth for which github entities get their own tag in the
+* conversation list. Adding a new entry here extends `ChatSource`
+* (`github_${entityType}`) and the SQL CASE/IN-list in
+* `server/services/me-chat.ts` without touching them — both derive from
+* this constant.
+*/
+const GITHUB_ENTITY_TYPES = [
 	"issue",
 	"pull_request",
 	"discussion",
 	"commit"
-]);
+];
+const githubEntityTypeSchema = z.enum(GITHUB_ENTITY_TYPES);
 const githubChatMetadataSchema = z.object({
 	source: z.literal("github"),
 	entityType: githubEntityTypeSchema,
@@ -661,6 +692,14 @@ const chatMetadataSchema = z.discriminatedUnion("source", [githubChatMetadataSch
 * sneak through `{ source: "github" }` without the required fields.
 */
 const optionalChatMetadataSchema = z.union([z.object({}).strict(), chatMetadataSchema]);
+const chatSourceSchema = z.enum([
+	"manual",
+	"github_issue",
+	"github_pull_request",
+	"github_discussion",
+	"github_commit",
+	"feishu"
+]);
 const chatTypeSchema = z.enum(["direct", "group"]);
 /**
 * Per-(chat, user) engagement state. Stored on `chat_user_state` so each
@@ -897,6 +936,11 @@ const contextTreeSummarySchema = z.object({
 	removedCount: z.number().int().nonnegative(),
 	changedNodeCount: z.number().int().nonnegative()
 });
+const contextTreeUsageSummarySchema = z.object({
+	windowDays: z.number().int().positive(),
+	agentCount: z.number().int().nonnegative(),
+	usageCount: z.number().int().nonnegative()
+});
 const contextTreeSnapshotSchema = z.object({
 	repo: z.string().nullable(),
 	branch: z.string().nullable(),
@@ -905,6 +949,7 @@ const contextTreeSnapshotSchema = z.object({
 	snapshotStatus: contextTreeSnapshotStatusSchema,
 	contextStatus: contextTreeStatusSchema,
 	summary: contextTreeSummarySchema,
+	usage: contextTreeUsageSummarySchema,
 	updates: z.array(contextTreeUpdateSchema),
 	nodes: z.array(contextTreeNodeSchema),
 	edges: z.array(contextTreeEdgeSchema),
@@ -1190,12 +1235,15 @@ const listMeChatsQuerySchema = z.object({
 	cursor: z.string().optional(),
 	limit: z.coerce.number().int().min(1).max(200).default(50),
 	filter: meChatFilterSchema.default("all"),
-	engagement: chatEngagementViewSchema.default("active")
+	engagement: chatEngagementViewSchema.default("active"),
+	source: chatSourceSchema.optional()
 });
 const meChatParticipantSchema = z.object({
 	agentId: z.string(),
 	displayName: z.string(),
-	type: z.string()
+	type: z.string(),
+	avatarColorToken: z.string().nullable(),
+	avatarImageUrl: z.string().nullable()
 });
 /**
 * Live activity hint surfaced in the conversation row's time slot. Derived
@@ -1257,6 +1305,47 @@ z.object({
 	type: z.literal("chat:message"),
 	chatId: z.string()
 });
+/**
+* Per-source aggregate for the conversation-list tag bar.
+*
+*   - `chatCount` — number of chats the caller is in for this source. Used
+*     to hide tags whose count is 0 ("don't render a PR tag if there are no
+*     PRs").
+*   - `unreadChatCount` — number of chats whose `unread_mention_count > 0`.
+*     This is "chats with unread mentions", NOT "total mention count", so
+*     the badge on each tag matches the semantics of the existing `unread`
+*     filter pill (`totalUnread` in `pages/workspace/conversations`) — a
+*     `2` on the PR tag means "2 PR chats have unread mentions", which is
+*     what a user expects to click into.
+*
+* The map ALWAYS contains the `manual` key (the default tab is always
+* available, even at zero counts); other keys are present only when the
+* caller has at least one chat for that source.
+*/
+const chatSourceCountSchema = z.object({
+	chatCount: z.number().int().nonnegative(),
+	unreadChatCount: z.number().int().nonnegative()
+});
+const listMeChatSourceCountsQuerySchema = z.object({ engagement: chatEngagementViewSchema.default("active") });
+z.object({ counts: z.partialRecord(chatSourceSchema, chatSourceCountSchema) });
+const workspaceDocRefSchema = z.object({
+	type: z.literal("workspace"),
+	chatId: z.string().trim().min(1),
+	agentId: z.string().trim().min(1),
+	basePath: z.string().trim().optional(),
+	path: z.string().trim().min(1)
+});
+z.object({ basePath: z.string().trim().min(1) });
+const getMeDocSchema = z.object({
+	agentId: z.string().trim().min(1),
+	basePath: z.string().trim().optional(),
+	path: z.string().trim().min(1)
+});
+const getMeDocResponseSchema = z.object({
+	ref: workspaceDocRefSchema,
+	path: z.string(),
+	content: z.string()
+});
 z.enum([
 	"connect",
 	"create_agent",
@@ -1315,7 +1404,8 @@ z.object({
 	organizationId: z.string(),
 	organizationName: z.string(),
 	role: z.enum(["admin", "member"]),
-	agentId: z.string()
+	agentId: z.string(),
+	orgHasOtherMembers: z.boolean()
 });
 const memberRoleSchema = z.enum(["admin", "member"]);
 const memberSchema = z.object({
@@ -1726,7 +1816,8 @@ const sessionEventKind = z.enum([
 	"error",
 	"assistant_text",
 	"thinking",
-	"turn_end"
+	"turn_end",
+	"context_tree_usage"
 ]);
 const toolCallEventPayload = z.object({
 	toolUseId: z.string(),
@@ -1768,6 +1859,10 @@ const thinkingEventPayload = z.object({});
 * completed turns to show only the final result message.
 */
 const turnEndEventPayload = z.object({ status: z.enum(["success", "error"]) });
+const contextTreeUsageEventPayload = z.object({
+	purpose: z.literal("design_decision"),
+	treeRepoUrl: z.string().nullable()
+});
 const sessionEventSchema = z.discriminatedUnion("kind", [
 	z.object({
 		kind: z.literal("tool_call"),
@@ -1788,6 +1883,10 @@ const sessionEventSchema = z.discriminatedUnion("kind", [
 	z.object({
 		kind: z.literal("turn_end"),
 		payload: turnEndEventPayload
+	}),
+	z.object({
+		kind: z.literal("context_tree_usage"),
+		payload: contextTreeUsageEventPayload
 	})
 ]);
 z.object({
@@ -1801,7 +1900,8 @@ z.object({
 		errorEventPayload,
 		assistantTextEventPayload,
 		thinkingEventPayload,
-		turnEndEventPayload
+		turnEndEventPayload,
+		contextTreeUsageEventPayload
 	]),
 	createdAt: z.string()
 });
@@ -1878,4 +1978,4 @@ z.object({
 	capabilities: serverCapabilitiesSchema.optional()
 }).passthrough();
 //#endregion
-export { notificationQuerySchema as $, createMemberSchema as A, githubDevCallbackQuerySchema as B, connectTokenExchangeSchema as C, updateChatSchema as Ct, createAgentSchema as D, wsAuthFrameSchema as Dt, createAdapterMappingSchema as E, updateOrganizationSchema as Et, dryRunAgentRuntimeConfigSchema as F, inboxPollQuerySchema as G, imageInlineContentSchema as H, extractMentions as I, isReservedAgentName as J, isOrgSettingNamespace as K, githubAppInstallationClaimBodySchema as L, defaultParticipantMode as M, defaultRuntimeConfigPayload as N, createChatSchema as O, delegateFeishuUserSchema as P, messageSourceSchema as Q, githubAppInstallationPermissionsSchema as R, clientRegisterSchema as S, updateAgentSchema as St, createAdapterConfigSchema as T, updateMemberSchema as Tt, inboxAckFrameSchema as U, githubStartQuerySchema as V, inboxDeliverFrameSchema as W, listMeChatsQuerySchema as X, joinByInvitationSchema as Y, loginSchema as Z, agentPinnedMessageSchema as _, sessionStateMessageSchema as _t, AGENT_TYPES as a, questionMessageContentSchema as at, chatMetadataSchema as b, updateAdapterConfigSchema as bt, DEFAULT_RUNTIME_PROVIDER as c, runtimeStateMessageSchema as ct, NOTIFICATION_TYPES as d, selfServiceFeishuBotSchema as dt, onboardingEventSchema as et, ORG_SETTINGS_NAMESPACES as f, sendMessageSchema as ft, agentBindRequestSchema as g, sessionReconcileRequestSchema as gt, addParticipantSchema as h, sessionEventSchema as ht, AGENT_STATUSES as i, questionAnswerMessageContentSchema as it, createOrgFromMeSchema as j, createMeChatSchema as k, LIVE_ACTIVITY_STALE_MS as l, safeRedirectPath as lt, addMeChatParticipantsSchema as m, sessionEventMessageSchema as mt, AGENT_NAME_REGEX as n, patchChatEngagementSchema as nt, AGENT_VISIBILITY as o, rebindAgentSchema as ot, WS_AUTH_FRAME_TIMEOUT_MS as p, sendToAgentSchema as pt, isRedactedEnvValue as q, AGENT_SELECTOR_HEADER as r, patchOnboardingSchema as rt, CHAT_ENGAGEMENT_STATUSES as s, refreshTokenSchema as st, AGENT_BIND_REJECT_REASONS as t, paginationQuerySchema as tt, MENTION_REGEX as u, scanMentionTokens as ut, agentRuntimeConfigPayloadSchema as v, stripCode as vt, contextTreeSnapshotSchema as w, updateClientCapabilitiesSchema as wt, clientCapabilitiesSchema as x, updateAgentRuntimeConfigSchema as xt, agentTypeSchema as y, submitQuestionAnswerSchema as yt, githubCallbackQuerySchema as z };
+export { listMeChatSourceCountsQuerySchema as $, createMeChatSchema as A, updateOrganizationSchema as At, githubAppInstallationClaimBodySchema as B, clientRegisterSchema as C, submitQuestionAnswerSchema as Ct, createAdapterMappingSchema as D, updateChatSchema as Dt, createAdapterConfigSchema as E, updateAgentSchema as Et, delegateFeishuUserSchema as F, imageInlineContentSchema as G, githubCallbackQuerySchema as H, dryRunAgentRuntimeConfigSchema as I, inboxPollQuerySchema as J, inboxAckFrameSchema as K, extractMentions as L, createOrgFromMeSchema as M, defaultParticipantMode as N, createAgentSchema as O, updateClientCapabilitiesSchema as Ot, defaultRuntimeConfigPayload as P, joinByInvitationSchema as Q, getMeDocResponseSchema as R, clientCapabilitiesSchema as S, stripCode as St, contextTreeSnapshotSchema as T, updateAgentRuntimeConfigSchema as Tt, githubDevCallbackQuerySchema as U, githubAppInstallationPermissionsSchema as V, githubStartQuerySchema as W, isRedactedEnvValue as X, isOrgSettingNamespace as Y, isReservedAgentName as Z, agentBindRequestSchema as _, sendToAgentSchema as _t, AGENT_TYPES as a, paginationQuerySchema as at, agentTypeSchema as b, sessionReconcileRequestSchema as bt, DEFAULT_RUNTIME_PROVIDER as c, questionAnswerMessageContentSchema as ct, MENTION_REGEX as d, refreshTokenSchema as dt, listMeChatsQuerySchema as et, NOTIFICATION_TYPES as f, runtimeStateMessageSchema as ft, addParticipantSchema as g, sendMessageSchema as gt, addMeChatParticipantsSchema as h, selfServiceFeishuBotSchema as ht, AGENT_STATUSES as i, onboardingEventSchema as it, createMemberSchema as j, wsAuthFrameSchema as jt, createChatSchema as k, updateMemberSchema as kt, GITHUB_ENTITY_TYPES as l, questionMessageContentSchema as lt, WS_AUTH_FRAME_TIMEOUT_MS as m, scanMentionTokens as mt, AGENT_NAME_REGEX as n, messageSourceSchema as nt, AGENT_VISIBILITY as o, patchChatEngagementSchema as ot, ORG_SETTINGS_NAMESPACES as p, safeRedirectPath as pt, inboxDeliverFrameSchema as q, AGENT_SELECTOR_HEADER as r, notificationQuerySchema as rt, CHAT_ENGAGEMENT_STATUSES as s, patchOnboardingSchema as st, AGENT_BIND_REJECT_REASONS as t, loginSchema as tt, LIVE_ACTIVITY_STALE_MS as u, rebindAgentSchema as ut, agentPinnedMessageSchema as v, sessionEventMessageSchema as vt, connectTokenExchangeSchema as w, updateAdapterConfigSchema as wt, chatMetadataSchema as x, sessionStateMessageSchema as xt, agentRuntimeConfigPayloadSchema as y, sessionEventSchema as yt, getMeDocSchema as z };

package/dist/drizzle/0044_agent_avatar_color.sql

@@ -0,0 +1,11 @@
+-- Add avatar_color_token to agents.
+--
+-- Manager-selected avatar fill color override for the web client. One of
+-- "hue-0".."hue-7", matching the `--avatar-hue-*` CSS tokens in
+-- `packages/web/src/index.css`. NULL means "auto" — the renderer falls
+-- back to the deterministic djb2 hash of `uuid` (the previous default).
+--
+-- Nullable, no default, no backfill: existing rows continue to render the
+-- hashed color until their manager picks something explicit. This is a
+-- pure additive change; no NOT NULL constraint, no enum, no FK.
+ALTER TABLE "agents" ADD COLUMN "avatar_color_token" text;

package/dist/drizzle/0045_agent_avatar_image.sql

@@ -0,0 +1,17 @@
+-- Add inline avatar image storage to agents.
+--
+-- The PRD chose PG bytea over object storage for the first cut: clients
+-- always pre-resize to 256×256 WEBP (typically < 50 KB), and a few KB ×
+-- N agents per org sits well within row-size budgets. Switching to S3/R2
+-- later is a follow-up migration; the column shape stays the same except
+-- avatar_image_data flips to NULL and avatar_image_url moves to a real
+-- external URL.
+--
+-- All three columns are nullable and move together — either all three
+-- carry an image (data + mime + updated_at) or all are NULL. The service
+-- layer enforces that invariant on writes; SQL keeps it loose so a partial
+-- backfill / restore doesn't break inserts.
+ALTER TABLE "agents"
+  ADD COLUMN "avatar_image_data" bytea,
+  ADD COLUMN "avatar_image_mime" text,
+  ADD COLUMN "avatar_image_updated_at" timestamp with time zone;

package/dist/drizzle/meta/_journal.json

@@ -309,6 +309,20 @@
       "when": 1779494400000,
       "tag": "0043_onboarding_completed_at",
       "breakpoints": true
+    },
+    {
+      "idx": 44,
+      "version": "7",
+      "when": 1779580800000,
+      "tag": "0044_agent_avatar_color",
+      "breakpoints": true
+    },
+    {
+      "idx": 45,
+      "version": "7",
+      "when": 1779667200000,
+      "tag": "0045_agent_avatar_image",
+      "breakpoints": true
     }
   ]
 }

package/dist/{feishu-D_vnqC6a.mjs → feishu-BGx71p5s.mjs}

@@ -1,6 +1,6 @@
 import { r as __exportAll } from "./chunk-BSw8zbkd.mjs";
 import { t as cliFetch } from "./cli-fetch--tiwKm5S.mjs";
-import { r as AGENT_SELECTOR_HEADER } from "./dist-C8yStx2L.mjs";
+import { r as AGENT_SELECTOR_HEADER } from "./dist-1XGLJMOq.mjs";
 //#region src/core/feishu.ts
 var feishu_exports = /* @__PURE__ */ __exportAll({
 	bindFeishuBot: () => bindFeishuBot,

package/dist/index.mjs

@@ -1,12 +1,12 @@
 import "./observability-BAScT_5S-BcW9HgkG.mjs";
-import { A as checkDocker, B as isServiceSupported, E as checkAgentConfigs, F as checkWebSocket, G as uninstallClientService, H as restartClientService, I as printResults, J as stopPostgres, K as ensurePostgres, M as checkServerConfig, N as checkServerHealth, O as checkClientConfig, P as checkServerReachable, R as getClientServiceStatus, S as runHomeMigration, T as runMigrations, U as startClientService, V as resolveCliInvocation, W as stopClientService, X as handleClientOrgMismatch, Y as ClientRuntime, Z as rotateClientIdWithBackup, _ as formatCheckReport, b as onboardCreate, d as startServer, g as promptMissingFields, h as promptAddAgent, j as checkNodeVersion, k as checkDatabase, lt as FirstTreeHubSDK, m as isInteractive, n as deriveHubUrlFromToken, nt as hasUser, q as isDockerAvailable, t as HubUrlDerivationError, tt as createOwner, ut as SdkError, y as onboardCheck, z as installClientService } from "./saas-connect-Bb5LR4y6.mjs";
+import { A as checkDocker, B as isServiceSupported, E as checkAgentConfigs, F as checkWebSocket, G as uninstallClientService, H as restartClientService, I as printResults, J as stopPostgres, K as ensurePostgres, M as checkServerConfig, N as checkServerHealth, O as checkClientConfig, P as checkServerReachable, R as getClientServiceStatus, S as runHomeMigration, T as runMigrations, U as startClientService, V as resolveCliInvocation, W as stopClientService, X as handleClientOrgMismatch, Y as ClientRuntime, Z as rotateClientIdWithBackup, _ as formatCheckReport, b as onboardCreate, d as startServer, g as promptMissingFields, h as promptAddAgent, j as checkNodeVersion, k as checkDatabase, lt as FirstTreeHubSDK, m as isInteractive, n as deriveHubUrlFromToken, nt as hasUser, q as isDockerAvailable, t as HubUrlDerivationError, tt as createOwner, ut as SdkError, y as onboardCheck, z as installClientService } from "./saas-connect-BBRxjmBS.mjs";
 import "./logger-core-BTmvdflj-DjW8FM4T.mjs";
-import { a as ensureFreshAdminToken, c as resolveServerUrl, i as ensureFreshAccessToken, n as AuthRefreshRateLimitedError, s as resolveAccessToken, t as AuthRefreshFailedError } from "./bootstrap-Cya2OoHz.mjs";
+import { a as ensureFreshAdminToken, c as resolveServerUrl, i as ensureFreshAccessToken, n as AuthRefreshRateLimitedError, s as resolveAccessToken, t as AuthRefreshFailedError } from "./bootstrap-C15ZBOCC.mjs";
 import { i as blank, s as status } from "./cli-fetch--tiwKm5S.mjs";
-import "./dist-C8yStx2L.mjs";
-import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-D_vnqC6a.mjs";
+import "./dist-1XGLJMOq.mjs";
+import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-BGx71p5s.mjs";
 import "./errors-LPcARA4K-Dbrptiyz.mjs";
 import "./src-DNBS5Yjj.mjs";
-import "./client-BH4CmUL0-CybE3kuP.mjs";
+import "./client-CzXmweS9-DhUiuQvL.mjs";
 import "./invitation-DZO4NX3P-BPxTeHf-.mjs";
 export { AuthRefreshFailedError, AuthRefreshRateLimitedError, ClientRuntime, FirstTreeHubSDK, HubUrlDerivationError, SdkError, bindFeishuBot, bindFeishuUser, blank, checkAgentConfigs, checkClientConfig, checkDatabase, checkDocker, checkNodeVersion, checkServerConfig, checkServerHealth, checkServerReachable, checkWebSocket, createOwner, deriveHubUrlFromToken, ensureFreshAccessToken, ensureFreshAdminToken, ensurePostgres, formatCheckReport, getClientServiceStatus, handleClientOrgMismatch, hasUser, installClientService, isDockerAvailable, isInteractive, isServiceSupported, onboardCheck, onboardCreate, printResults, promptAddAgent, promptMissingFields, resolveAccessToken, resolveCliInvocation, resolveServerUrl, restartClientService, rotateClientIdWithBackup, runHomeMigration, runMigrations, startClientService, startServer, status, stopClientService, stopPostgres, uninstallClientService };

package/dist/{invitation-CNv7gfFF-D93KQte0.mjs → invitation-CNv7gfFF-DOFZ75wb.mjs}

@@ -1,4 +1,4 @@
-import "./dist-C8yStx2L.mjs";
+import "./dist-1XGLJMOq.mjs";
 import "./errors-LPcARA4K-Dbrptiyz.mjs";
 import { s as previewInvitation } from "./invitation-DZO4NX3P-BPxTeHf-.mjs";
 export { previewInvitation };