@agent-team-foundation/first-tree-hub 0.8.0 → 0.8.1

package/dist/{bootstrap-CRDR6NwE.mjs → bootstrap-8nCntTrK.mjs}

@@ -520,6 +520,14 @@ function resolveAccessToken() {
 	return creds.accessToken;
 }
 /**
+* In-flight refresh promise. Multiple callers (WS handshake, proactive
+* refresh timer, every SDK request) can see an expired token within the same
+* millisecond — without dedupe each would fire an independent `/auth/refresh`
+* round-trip and race to write `credentials.json`. Share one in-flight
+* promise so N concurrent callers resolve from a single HTTP call.
+*/
+let inflightRefresh = null;
+/**
 * Ensure the persisted access token is fresh. Call before any API request
 * when using persisted credentials. Returns the (possibly refreshed) access
 * token. Service-user API keys are out of scope for this milestone.
@@ -528,19 +536,27 @@ async function ensureFreshAccessToken() {
 	const creds = loadCredentials();
 	if (!creds) throw new Error("No credentials found. Run `first-tree-hub client connect <server-url>` to sign in.");
 	if (!isTokenExpired(creds.accessToken)) return creds.accessToken;
-	const res = await fetch(`${creds.serverUrl}/api/v1/auth/refresh`, {
-		method: "POST",
-		headers: { "Content-Type": "application/json" },
-		body: JSON.stringify({ refreshToken: creds.refreshToken }),
-		signal: AbortSignal.timeout(1e4)
-	});
-	if (!res.ok) throw new Error("Access token expired and refresh failed. Run `first-tree-hub client connect <server-url>`.");
-	const data = await res.json();
-	saveCredentials({
-		...creds,
-		accessToken: data.accessToken
-	});
-	return data.accessToken;
+	if (inflightRefresh) return inflightRefresh;
+	inflightRefresh = (async () => {
+		const res = await fetch(`${creds.serverUrl}/api/v1/auth/refresh`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ refreshToken: creds.refreshToken }),
+			signal: AbortSignal.timeout(1e4)
+		});
+		if (!res.ok) throw new Error("Access token expired and refresh failed. Run `first-tree-hub client connect <server-url>`.");
+		const data = await res.json();
+		saveCredentials({
+			...creds,
+			accessToken: data.accessToken
+		});
+		return data.accessToken;
+	})();
+	try {
+		return await inflightRefresh;
+	} finally {
+		inflightRefresh = null;
+	}
 }
 /** Back-compat alias retained so existing call sites keep compiling. */
 const ensureFreshAdminToken = ensureFreshAccessToken;

package/dist/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, b as resetConfigMeta, c as saveCredentials, f as agentConfigSchema, g as initConfig, h as getConfigValue, l as DEFAULT_CONFIG_DIR, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, r as ensureFreshAdminToken, s as saveAgentConfig, u as DEFAULT_DATA_DIR, v as readConfigFile, y as resetConfig } from "../bootstrap-CRDR6NwE.mjs";
-import { A as stopPostgres, C as checkServerReachable, F as SdkError, I as SessionRegistry, L as cleanWorkspaces, M as createOwner, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, d as loadOnboardState, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, j as ClientRuntime, l as promptMissingFields, m as saveOnboardState, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "../core-BXS5ppsG.mjs";
+import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, b as resetConfigMeta, c as saveCredentials, f as agentConfigSchema, g as initConfig, h as getConfigValue, l as DEFAULT_CONFIG_DIR, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, r as ensureFreshAdminToken, s as saveAgentConfig, u as DEFAULT_DATA_DIR, v as readConfigFile, y as resetConfig } from "../bootstrap-8nCntTrK.mjs";
+import { A as stopPostgres, C as checkServerReachable, F as SdkError, I as SessionRegistry, L as cleanWorkspaces, M as createOwner, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, d as loadOnboardState, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, j as ClientRuntime, l as promptMissingFields, m as saveOnboardState, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "../core-BA5U1v9L.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-D9JkMZnU.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
@@ -1126,13 +1126,13 @@ function isSecretField(schema, dotPath) {
 //#region src/commands/onboard.ts
 async function promptMissing(args) {
 	if (!args.server) try {
-		const { resolveServerUrl } = await import("../bootstrap-CRDR6NwE.mjs").then((n) => n.t);
+		const { resolveServerUrl } = await import("../bootstrap-8nCntTrK.mjs").then((n) => n.t);
 		resolveServerUrl();
 	} catch {
 		args.server = await input({ message: "Hub server URL:" });
 		saveOnboardState(args);
 	}
-	const { loadCredentials } = await import("../bootstrap-CRDR6NwE.mjs").then((n) => n.t);
+	const { loadCredentials } = await import("../bootstrap-8nCntTrK.mjs").then((n) => n.t);
 	if (!loadCredentials()) throw new Error("No saved credentials. Run `first-tree-hub client connect <server-url>` before onboarding.");
 	if (!args.id) {
 		args.id = await input({ message: "Agent ID:" });

package/dist/{core-BXS5ppsG.mjs → core-BA5U1v9L.mjs}

@@ -1,4 +1,4 @@
-import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, d as DEFAULT_HOME_DIR$1, f as agentConfigSchema, g as initConfig, i as loadCredentials, l as DEFAULT_CONFIG_DIR, m as collectMissingPrompts, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, s as saveAgentConfig, u as DEFAULT_DATA_DIR$1, x as resolveConfigReadonly } from "./bootstrap-CRDR6NwE.mjs";
+import { C as setConfigValue, S as serverConfigSchema, _ as loadAgents, d as DEFAULT_HOME_DIR$1, f as agentConfigSchema, g as initConfig, i as loadCredentials, l as DEFAULT_CONFIG_DIR, m as collectMissingPrompts, n as ensureFreshAccessToken, o as resolveServerUrl, p as clientConfigSchema, s as saveAgentConfig, u as DEFAULT_DATA_DIR$1, x as resolveConfigReadonly } from "./bootstrap-8nCntTrK.mjs";
 import { $ as updateAgentRuntimeConfigSchema, A as createMemberSchema, B as notificationQuerySchema, C as agentTypeSchema$1, D as createAdapterMappingSchema, E as createAdapterConfigSchema, F as inboxPollQuerySchema, G as sendMessageSchema, H as refreshTokenSchema, I as isRedactedEnvValue, J as sessionEventMessageSchema, K as sendToAgentSchema, L as linkTaskChatSchema, M as createTaskSchema, N as delegateFeishuUserSchema, O as createAgentSchema, P as dryRunAgentRuntimeConfigSchema, Q as updateAdapterConfigSchema, R as loginSchema, S as agentRuntimeConfigPayloadSchema$1, T as connectTokenExchangeSchema, U as runtimeStateMessageSchema, V as paginationQuerySchema, W as selfServiceFeishuBotSchema, X as sessionStateMessageSchema, Y as sessionEventSchema$1, Z as taskListQuerySchema, _ as addParticipantSchema, a as AGENT_SELECTOR_HEADER$1, at as wsAuthFrameSchema, b as agentBindRequestSchema, c as AGENT_TYPES, d as SYSTEM_CONFIG_DEFAULTS, et as updateAgentSchema, f as TASK_CREATOR_TYPES, g as WS_AUTH_FRAME_TIMEOUT_MS, h as TASK_TERMINAL_STATUSES, i as AGENT_BIND_REJECT_REASONS, it as updateTaskStatusSchema, j as createOrganizationSchema, k as createChatSchema, l as AGENT_VISIBILITY, m as TASK_STATUSES, nt as updateOrganizationSchema, o as AGENT_SOURCES, p as TASK_HEALTH_SIGNALS, q as sessionCompletionMessageSchema, rt as updateSystemConfigSchema, s as AGENT_STATUSES, tt as updateMemberSchema, u as DEFAULT_AGENT_RUNTIME_CONFIG_PAYLOAD, v as adminCreateTaskSchema, w as clientRegisterSchema, x as agentPinnedMessageSchema$1, y as adminUpdateTaskSchema, z as messageSourceSchema$1 } from "./feishu-D9JkMZnU.mjs";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
@@ -946,6 +946,7 @@ var ClientConnection = class extends EventEmitter {
 		this.serverUrl = config.serverUrl.replace(/\/+$/, "");
 		this.sdkVersion = config.sdkVersion;
 		this.getAccessToken = config.getAccessToken;
+		this.on("error", () => {});
 	}
 	get isConnected() {
 		return this.ws !== null && this.ws.readyState === WebSocket.OPEN && this.registered;
@@ -1458,6 +1459,75 @@ function bootstrapWorkspace(options) {
 	}
 	writeFileSync(join(agentDir, "tools.md"), generateToolsDoc(), "utf-8");
 }
+function defaultInstallExec(command, args, options) {
+	execFileSync(command, args, {
+		cwd: options.cwd,
+		stdio: "pipe",
+		timeout: options.timeout,
+		encoding: "utf-8"
+	});
+}
+/**
+* Install the first-tree skill and FIRST-TREE-SOURCE-INTEGRATION block into
+* the workspace by shelling out to `first-tree tree integrate`.
+*
+* Resolution order for the CLI binary:
+*   1. `first-tree` on PATH — preferred for runtime images that pre-install it.
+*   2. `npx -y first-tree@latest` — fallback that downloads on first run.
+*
+* Graceful degradation: returns false on failure and logs. The session still
+* starts; the agent just doesn't have the first-tree skill wired up.
+*/
+function installFirstTreeIntegration(options) {
+	const { workspacePath, contextTreePath, workspaceId, treeRepoUrl, log } = options;
+	const exec = options.exec ?? defaultInstallExec;
+	const integrateArgs = [
+		"tree",
+		"integrate",
+		"--source-path",
+		workspacePath,
+		"--tree-path",
+		contextTreePath,
+		"--mode",
+		"workspace-root",
+		"--workspace-id",
+		workspaceId,
+		...treeRepoUrl ? ["--tree-url", treeRepoUrl] : []
+	];
+	const attempts = [{
+		command: "first-tree",
+		args: integrateArgs,
+		label: "first-tree (PATH)"
+	}, {
+		command: "npx",
+		args: [
+			"-y",
+			"first-tree@latest",
+			...integrateArgs
+		],
+		label: "npx first-tree@latest"
+	}];
+	for (let index = 0; index < attempts.length; index += 1) {
+		const attempt = attempts[index];
+		if (!attempt) continue;
+		try {
+			exec(attempt.command, attempt.args, {
+				cwd: workspacePath,
+				timeout: 12e4
+			});
+			log(`First-tree integration installed via ${attempt.label}`);
+			return true;
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			const binaryMissing = /ENOENT|not found|command not found/i.test(msg);
+			const isLastAttempt = index === attempts.length - 1;
+			if (binaryMissing && !isLastAttempt) continue;
+			log(`First-tree integration skipped (${attempt.label}): ${msg.slice(0, 200)}`);
+			return false;
+		}
+	}
+	return false;
+}
 function generateToolsDoc() {
 	return `# Agent Hub SDK
 
@@ -2472,6 +2542,12 @@ const createClaudeCodeHandler = (config) => {
 			chatId: sessionCtx.chatId
 		});
 		generateClaudeMd(workspace, sessionCtx.agent, contextTreePath);
+		if (contextTreePath) installFirstTreeIntegration({
+			workspacePath: workspace,
+			contextTreePath,
+			workspaceId: sessionCtx.chatId,
+			log: (msg) => sessionCtx.log(msg)
+		});
 	}
 	const handler = {
 		async start(message, sessionCtx) {
@@ -3483,6 +3559,9 @@ var ClientRuntime = class {
 		this.connection.on("auth:expired", () => {
 			process.stderr.write("  ⚠️  Access token expired — reconnecting after refresh...\n");
 		});
+		this.connection.on("error", (err) => {
+			process.stderr.write(`  \u26A0\uFE0F  Client connection error: ${err.message}\n`);
+		});
 		this.connection.on("agent:pinned", (message) => {
 			this.handleAgentPinned(message);
 		});

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as resolveAccessToken, n as ensureFreshAccessToken, o as resolveServerUrl, r as ensureFreshAdminToken } from "./bootstrap-CRDR6NwE.mjs";
-import { A as stopPostgres, C as checkServerReachable, D as status, E as blank, F as SdkError, M as createOwner, N as hasUser, O as ensurePostgres, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, i as resolveCliInvocation, j as ClientRuntime, k as isDockerAvailable, l as promptMissingFields, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "./core-BXS5ppsG.mjs";
+import { a as resolveAccessToken, n as ensureFreshAccessToken, o as resolveServerUrl, r as ensureFreshAdminToken } from "./bootstrap-8nCntTrK.mjs";
+import { A as stopPostgres, C as checkServerReachable, D as status, E as blank, F as SdkError, M as createOwner, N as hasUser, O as ensurePostgres, P as FirstTreeHubSDK, S as checkServerHealth, T as printResults, _ as checkClientConfig, a as uninstallClientService, b as checkNodeVersion, c as promptAddAgent, f as onboardCheck, g as checkAgentConfigs, h as runMigrations, i as resolveCliInvocation, j as ClientRuntime, k as isDockerAvailable, l as promptMissingFields, n as installClientService, o as startServer, p as onboardCreate, r as isServiceSupported, s as isInteractive, t as getClientServiceStatus, u as formatCheckReport, v as checkDatabase, w as checkWebSocket, x as checkServerConfig, y as checkDocker } from "./core-BA5U1v9L.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-D9JkMZnU.mjs";
 export { ClientRuntime, FirstTreeHubSDK, SdkError, bindFeishuBot, bindFeishuUser, blank, checkAgentConfigs, checkClientConfig, checkDatabase, checkDocker, checkNodeVersion, checkServerConfig, checkServerHealth, checkServerReachable, checkWebSocket, createOwner, ensureFreshAccessToken, ensureFreshAdminToken, ensurePostgres, formatCheckReport, getClientServiceStatus, hasUser, installClientService, isDockerAvailable, isInteractive, isServiceSupported, onboardCheck, onboardCreate, printResults, promptAddAgent, promptMissingFields, resolveAccessToken, resolveCliInvocation, resolveServerUrl, runMigrations, startServer, status, stopPostgres, uninstallClientService };