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

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/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-DX3-nDs9.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-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";
@@ -8,7 +8,7 @@ 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-RM_03B_l-DiEIa9xe.mjs";
+import "../client-CzXmweS9-DhUiuQvL.mjs";
 import "../invitation-DZO4NX3P-BPxTeHf-.mjs";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";

package/dist/{client-gSnsRu5W-v_mC1sRY.mjs → client-CREn8bJ0-C5fHJir6.mjs}

@@ -3,5 +3,5 @@ import "./logger-core-BTmvdflj-DjW8FM4T.mjs";
 import "./dist-1XGLJMOq.mjs";
 import "./errors-LPcARA4K-Dbrptiyz.mjs";
 import "./src-DNBS5Yjj.mjs";
-import { J as listMyPinnedAgents } from "./client-RM_03B_l-DiEIa9xe.mjs";
+import { J as listMyPinnedAgents } from "./client-CzXmweS9-DhUiuQvL.mjs";
 export { listMyPinnedAgents };

package/dist/{client-RM_03B_l-DiEIa9xe.mjs → client-CzXmweS9-DhUiuQvL.mjs}

@@ -4,7 +4,7 @@ import { a as ConflictError, i as ClientUserMismatchError, l as organizations, n
 import { randomUUID } from "node:crypto";
 import { and, desc, eq, inArray, isNotNull, lt, ne, or, sql } from "drizzle-orm";
 import { bigserial, boolean, customType, index, integer, jsonb, pgTable, primaryKey, text, timestamp, unique } from "drizzle-orm/pg-core";
-//#region ../server/dist/client-RM_03B_l.mjs
+//#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
@@ -1775,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 ? {
@@ -1797,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 = [];
@@ -1909,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/index.mjs

@@ -1,5 +1,5 @@
 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-DX3-nDs9.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-C15ZBOCC.mjs";
 import { i as blank, s as status } from "./cli-fetch--tiwKm5S.mjs";
@@ -7,6 +7,6 @@ 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-RM_03B_l-DiEIa9xe.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/{saas-connect-DX3-nDs9.mjs → saas-connect-BBRxjmBS.mjs}

@@ -5,7 +5,7 @@ import { a as print, i as blank, n as CLI_USER_AGENT, r as COMMAND_VERSION, s as
 import { $ as listMeChatSourceCountsQuerySchema, A as createMeChatSchema, At as updateOrganizationSchema, B as githubAppInstallationClaimBodySchema, C as clientRegisterSchema, Ct as submitQuestionAnswerSchema, D as createAdapterMappingSchema, Dt as updateChatSchema, E as createAdapterConfigSchema, Et as updateAgentSchema, F as delegateFeishuUserSchema, G as imageInlineContentSchema, H as githubCallbackQuerySchema, I as dryRunAgentRuntimeConfigSchema, J as inboxPollQuerySchema, K as inboxAckFrameSchema, M as createOrgFromMeSchema, O as createAgentSchema, Ot as updateClientCapabilitiesSchema, P as defaultRuntimeConfigPayload, Q as joinByInvitationSchema, R as getMeDocResponseSchema, St as stripCode, T as contextTreeSnapshotSchema, Tt as updateAgentRuntimeConfigSchema, U as githubDevCallbackQuerySchema, V as githubAppInstallationPermissionsSchema$1, W as githubStartQuerySchema, X as isRedactedEnvValue, Y as isOrgSettingNamespace, Z as isReservedAgentName$1, _ as agentBindRequestSchema, _t as sendToAgentSchema, a as AGENT_TYPES, at as paginationQuerySchema, b as agentTypeSchema$1, bt as sessionReconcileRequestSchema, d as MENTION_REGEX, dt as refreshTokenSchema, et as listMeChatsQuerySchema, f as NOTIFICATION_TYPES, ft as runtimeStateMessageSchema, g as addParticipantSchema, gt as sendMessageSchema, h as addMeChatParticipantsSchema, ht as selfServiceFeishuBotSchema, i as AGENT_STATUSES, it as onboardingEventSchema, j as createMemberSchema, jt as wsAuthFrameSchema, k as createChatSchema, kt as updateMemberSchema, l as GITHUB_ENTITY_TYPES, m as WS_AUTH_FRAME_TIMEOUT_MS, n as AGENT_NAME_REGEX$1, nt as messageSourceSchema$1, o as AGENT_VISIBILITY, ot as patchChatEngagementSchema, p as ORG_SETTINGS_NAMESPACES$1, pt as safeRedirectPath, q as inboxDeliverFrameSchema$1, r as AGENT_SELECTOR_HEADER$1, rt as notificationQuerySchema, s as CHAT_ENGAGEMENT_STATUSES, st as patchOnboardingSchema, t as AGENT_BIND_REJECT_REASONS, tt as loginSchema, ut as rebindAgentSchema, v as agentPinnedMessageSchema$1, vt as sessionEventMessageSchema, w as connectTokenExchangeSchema, wt as updateAdapterConfigSchema, x as chatMetadataSchema$1, xt as sessionStateMessageSchema, y as agentRuntimeConfigPayloadSchema$1, yt as sessionEventSchema$1, z as getMeDocSchema } from "./dist-1XGLJMOq.mjs";
 import { a as ConflictError, c as UnauthorizedError, i as ClientUserMismatchError$1, l as organizations, n as BadRequestError, o as ForbiddenError, r as ClientOrgMismatchError$1, s as NotFoundError, t as AppError, u as users } from "./errors-LPcARA4K-Dbrptiyz.mjs";
 import { n as init_esm, r as trace, t as esm_exports } from "./esm-iadMkGbV.mjs";
-import { $ as notifyRecipients, A as getPresence, B as listAgentsManagedByUser, C as ensureParticipant, D as getChatDetail, E as getCachedAudience, F as joinAsParticipant, G as listClients, H as listChatParticipantsWithNames, I as joinChat, K as listClientsForOrgAdmin, L as leaveAsParticipant, M as heartbeatInstance, N as inboxEntries, O as getClient, P as invalidateChatAudience, Q as messages, R as leaveChat, S as ensureCanJoin, T as getActivityOverview, U as listChats, V as listAgentsWithRuntime, W as listChatsForMember, X as markSupersededByChat, Y as markStaleAgents, Z as members, _ as createChat, _t as unbindAgent, a as agentVisibilityCondition, at as registerClient, b as disconnectClient, c as assertParticipant, ct as resolveChatMembership, d as chatMembership, dt as sendToAgent$1, et as pendingQuestions, f as chats, ft as serverInstances, g as clients, gt as touchAgent, h as cleanupStalePresence, ht as submitAnswer, i as agentPresence, it as registerChatMessageDispatcher, j as heartbeatClient, k as getOnlineCount, l as bindAgent, lt as retireClient, m as cleanupStaleClients, mt as setRuntimeState, n as addParticipant, nt as recomputeWatchersForAgent, o as agents, ot as removeParticipant, p as claimClient, pt as setOffline, q as listMessages, r as agentChatSessions, rt as recomputeWatchersForMember, s as assertClientOwner, st as resetActivity, t as addChatParticipants, tt as recomputeChatWatchers, u as changeChatType, ut as sendMessage, v as createNotifier, vt as updateClientCapabilities, w as findOrCreateDirectChat, x as editMessage, y as deriveAuthState, yt as upsertSessionState, z as listActiveAgentsPinnedToClient } from "./client-RM_03B_l-DiEIa9xe.mjs";
+import { $ as notifyRecipients, A as getPresence, B as listAgentsManagedByUser, C as ensureParticipant, D as getChatDetail, E as getCachedAudience, F as joinAsParticipant, G as listClients, H as listChatParticipantsWithNames, I as joinChat, K as listClientsForOrgAdmin, L as leaveAsParticipant, M as heartbeatInstance, N as inboxEntries, O as getClient, P as invalidateChatAudience, Q as messages, R as leaveChat, S as ensureCanJoin, T as getActivityOverview, U as listChats, V as listAgentsWithRuntime, W as listChatsForMember, X as markSupersededByChat, Y as markStaleAgents, Z as members, _ as createChat, _t as unbindAgent, a as agentVisibilityCondition, at as registerClient, b as disconnectClient, c as assertParticipant, ct as resolveChatMembership, d as chatMembership, dt as sendToAgent$1, et as pendingQuestions, f as chats, ft as serverInstances, g as clients, gt as touchAgent, h as cleanupStalePresence, ht as submitAnswer, i as agentPresence, it as registerChatMessageDispatcher, j as heartbeatClient, k as getOnlineCount, l as bindAgent, lt as retireClient, m as cleanupStaleClients, mt as setRuntimeState, n as addParticipant, nt as recomputeWatchersForAgent, o as agents, ot as removeParticipant, p as claimClient, pt as setOffline, q as listMessages, r as agentChatSessions, rt as recomputeWatchersForMember, s as assertClientOwner, st as resetActivity, t as addChatParticipants, tt as recomputeChatWatchers, u as changeChatType, ut as sendMessage, v as createNotifier, vt as updateClientCapabilities, w as findOrCreateDirectChat, x as editMessage, y as deriveAuthState, yt as upsertSessionState, z as listActiveAgentsPinnedToClient } from "./client-CzXmweS9-DhUiuQvL.mjs";
 import { a as invitationRedemptions, c as recordRedemption, i as getActiveInvitation, l as rotateInvitation, n as ensureActiveInvitation, o as invitations, r as findActiveByToken, t as buildInviteUrl, u as uuidv7 } from "./invitation-DZO4NX3P-BPxTeHf-.mjs";
 import { createRequire } from "node:module";
 import { ZodError, z } from "zod";
@@ -3436,68 +3436,44 @@ function installFirstTreeIntegration(options) {
 function generateToolsDoc() {
 	return `# Agent Hub SDK
 
-## How You Communicate
-
 You are running inside **Agent Hub**, a messaging platform for agent teams.
 
-- Messages from other team members arrive as your prompt input
-- Each message includes a \`[From: <agent-name>]\` header — that name is also
-  what you pass back to \`chat send\` to reply to or address that agent
-- **Your final text response is automatically delivered** to the chat — just respond normally
-- For **proactive communication** (sending to other agents, other chats, or structured data),
-  use the \`first-tree-hub\` CLI below
-- **Use your judgment about when to respond.** Not every message requires
-  a reply — if you have nothing new for the recipient, output nothing and
-  the runtime will end the turn silently.
-  Your role and responsibilities are injected via the Hub-managed system prompt.
-
-## Environment Variables
-
-These are injected automatically when the agent process starts:
-
-| Variable | Description |
-|----------|-------------|
-| \`FIRST_TREE_HUB_SERVER_URL\` | Server address for API calls |
-| \`FIRST_TREE_HUB_ACCESS_TOKEN\` | User member access JWT (short-lived) |
-| \`FIRST_TREE_HUB_AGENT_ID\` | YOUR own agent UUID. The CLI reads it to identify you as the sender — never pass it as a \`send\` target. |
-| \`FIRST_TREE_HUB_CHAT_ID\` | The chat this session is currently bound to. The CLI uses it to route messages — you don't need to pass it manually. |
-
-The \`first-tree-hub\` CLI reads these automatically — no extra setup needed.
+- Messages from other team members arrive as your prompt input. Each message has a
+  \`[From: <agent-name>]\` header — that name is what you pass back to \`chat send\`.
+- **Your final text response is automatically delivered** to the chat — just respond normally.
+- **Stay silent when you have nothing to add.** Not every message needs a reply.
+  If you have nothing new for the recipient, output nothing and the runtime ends the turn.
+- For **proactive communication** (other agents, other chats, or different format),
+  use the \`first-tree-hub\` CLI below.
 
 ## Sending Messages
 
-Use the \`first-tree-hub chat send\` CLI — it reads the env vars above and
-attaches the \`Authorization\` + \`X-Agent-Id\` headers automatically:
+The CLI auto-reads its config from env — no setup needed.
 
 \`\`\`bash
-# Send to another agent — first positional argument is the recipient's NAME
-# (NOT a uuid; uuids in chat history / participant lists are not accepted).
-# Run \`first-tree-hub agent list\` to see available names.
-#
-# Routing: if the recipient is a participant of your current chat (typically
-# the case in a group chat where someone @-mentioned you to talk to them),
-# the message stays in that chat. Otherwise it falls back to a direct chat
-# between you and the recipient. You don't need to think about which.
+# Send to an agent by NAME (uuids are NOT accepted — run \`first-tree-hub agent list\` for names)
 first-tree-hub chat send <agentName> "your message"
 
-# Send into a specific chat by id — use this only when you explicitly want
-# to address a chat your current session is NOT bound to.
+# Address a specific chat (only when not your current chat)
 first-tree-hub chat send --chat <chatId> "your message"
 
-# Send markdown (default format is text)
-first-tree-hub chat send <agentName> -f markdown "**bold** message"
+# Markdown format (default is text)
+first-tree-hub chat send <agentName> -f markdown "**bold**"
 
-# Reply to a specific message
-first-tree-hub chat send <agentName> --reply-to <messageId> "reply content"
+# Reply to a message
+first-tree-hub chat send <agentName> --reply-to <messageId> "reply"
 
-# Pipe long content via stdin (recommended for special characters)
-echo "long message body" | first-tree-hub chat send <agentName>
+# Pipe long / multiline content via stdin
+echo "long body" | first-tree-hub chat send <agentName>
 \`\`\`
 
-> Agent uuids appear in \`chat list\`, chat history, and participant lists,
-> but they are NOT accepted by \`chat send\` — always use the name.
+**Content rules (important):**
 
-For content with quotes, \`$\`, backticks, or newlines, prefer stdin to avoid shell escaping issues.
+- Pass content as a **raw string** — never \`JSON.stringify\` it first. Wrapping in
+  outer quotes + \`\\n\` escapes produces a literal \`"@x ...\\n..."\` that the UI
+  cannot render as markdown.
+- For multi-line / markdown / special chars (quotes, \`$\`, backticks, newlines),
+  use **stdin** with real newlines, plus \`-f markdown\`.
 `;
 }
 function resolveGitRepoTargetPath(workspace, localPath) {
@@ -10896,7 +10872,7 @@ function createFeedbackHandler(config) {
 	return { handle };
 }
 //#endregion
-//#region ../server/dist/app-l2iy80P2.mjs
+//#region ../server/dist/app-BcZq1C1l.mjs
 var import_fastify_opentelemetry = /* @__PURE__ */ __toESM(require_fastify_opentelemetry(), 1);
 init_esm();
 var __defProp = Object.defineProperty;
@@ -18378,7 +18354,7 @@ async function meRoutes(app) {
 	*/
 	app.get("/me/pinned-agents", async (request) => {
 		const { userId } = requireUser(request);
-		const { listMyPinnedAgents } = await import("./client-gSnsRu5W-v_mC1sRY.mjs");
+		const { listMyPinnedAgents } = await import("./client-CREn8bJ0-C5fHJir6.mjs");
 		return listMyPinnedAgents(app.db, { userId });
 	});
 	/**

package/dist/web/assets/{index-BppGbmdT.js → index-DMqnX4IR.js}

@@ -1,4 +1,4 @@
-import{c as r,j as e,U as o,L as s,A as i,F as a,r as l}from"./index-Is-7_y6O.js";/**
+import{c as r,j as e,U as o,L as s,A as i,F as a,r as l}from"./index-QDcpYpEa.js";/**
  * @license lucide-react v0.577.0 - ISC
  *
  * This source code is licensed under the ISC license.