@agent-team-foundation/first-tree-hub 0.14.9-alpha.294.1 → 0.14.9-alpha.296.1

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as cleanWorkspaces, A as printResults, B as ClientRuntime, C as migrateLocalAgentDirs, D as checkNodeVersion, E as checkClientConfig, G as removeLocalAgent, I as restartClientService, J as ClientOrgMismatchError, K as fail, L as startClientService, M as getClientServiceStatus, N as installClientService, O as checkServerReachable, P as isServiceSupported, Q as SessionRegistry, R as stopClientService, S as createApiNameResolver, T as checkBackgroundService, U as findStaleAliases, V as handleClientOrgMismatch, W as formatStaleReason, X as FirstTreeHubSDK, Y as ClientUserMismatchError, Z as SdkError, _ as loadOnboardState, a as declineUpdate, b as saveOnboardState, c as detectInstallMode, d as reconcileLocalRuntimeProviders, et as probeCapabilities, f as uploadClientCapabilities, g as formatCheckReport, h as promptMissingFields, i as createExecuteUpdate, j as reconcileAgentConfigs, k as checkWebSocket, l as fetchLatestVersion, m as promptAddAgent, nt as configureClientLoggerForService, o as promptUpdate, p as isInteractive, q as success, r as registerSaaSConnectCommand, s as PACKAGE_NAME, tt as applyClientLoggerConfig, u as installGlobalLatest, v as onboardCheck, w as checkAgentConfigs, x as runHomeMigration, y as onboardCreate } from "../saas-connect-DzbieDfo.mjs";
+import { $ as cleanWorkspaces, A as printResults, B as ClientRuntime, C as migrateLocalAgentDirs, D as checkNodeVersion, E as checkClientConfig, G as removeLocalAgent, I as restartClientService, J as ClientOrgMismatchError, K as fail, L as startClientService, M as getClientServiceStatus, N as installClientService, O as checkServerReachable, P as isServiceSupported, Q as SessionRegistry, R as stopClientService, S as createApiNameResolver, T as checkBackgroundService, U as findStaleAliases, V as handleClientOrgMismatch, W as formatStaleReason, X as FirstTreeHubSDK, Y as ClientUserMismatchError, Z as SdkError, _ as loadOnboardState, a as declineUpdate, b as saveOnboardState, c as detectInstallMode, d as reconcileLocalRuntimeProviders, et as probeCapabilities, f as uploadClientCapabilities, g as formatCheckReport, h as promptMissingFields, i as createExecuteUpdate, j as reconcileAgentConfigs, k as checkWebSocket, l as fetchLatestVersion, m as promptAddAgent, nt as configureClientLoggerForService, o as promptUpdate, p as isInteractive, q as success, r as registerSaaSConnectCommand, s as PACKAGE_NAME, tt as applyClientLoggerConfig, u as installGlobalLatest, v as onboardCheck, w as checkAgentConfigs, x as runHomeMigration, y as onboardCreate } from "../saas-connect-DgR60HGv.mjs";
 import { C as resolveConfigReadonly, S as resetConfigMeta, _ as initConfig, a as loadCredentials, b as readConfigFile, c as saveAgentConfig, d as DEFAULT_DATA_DIR, f as DEFAULT_HOME_DIR, g as getConfigValue, i as ensureFreshAdminToken, m as clientConfigSchema, p as agentConfigSchema, r as ensureFreshAccessToken, s as resolveServerUrl, u as DEFAULT_CONFIG_DIR, v as loadAgents, w as setConfigValue, x as resetConfig } from "../bootstrap-D6RsdtJg.mjs";
 import { a as print, n as CLI_USER_AGENT, o as setJsonMode, r as COMMAND_VERSION, t as cliFetch } from "../cli-fetch-BGVItZxo.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "../feishu-CwD_5b9W.mjs";

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as printResults, B as ClientRuntime, D as checkNodeVersion, E as checkClientConfig, F as resolveCliInvocation, H as rotateClientIdWithBackup, I as restartClientService, L as startClientService, M as getClientServiceStatus, N as installClientService, O as checkServerReachable, P as isServiceSupported, R as stopClientService, V as handleClientOrgMismatch, X as FirstTreeHubSDK, Z as SdkError, g as formatCheckReport, h as promptMissingFields, k as checkWebSocket, m as promptAddAgent, n as deriveHubUrlFromToken, p as isInteractive, t as HubUrlDerivationError, v as onboardCheck, w as checkAgentConfigs, x as runHomeMigration, y as onboardCreate, z as uninstallClientService } from "./saas-connect-DzbieDfo.mjs";
+import { A as printResults, B as ClientRuntime, D as checkNodeVersion, E as checkClientConfig, F as resolveCliInvocation, H as rotateClientIdWithBackup, I as restartClientService, L as startClientService, M as getClientServiceStatus, N as installClientService, O as checkServerReachable, P as isServiceSupported, R as stopClientService, V as handleClientOrgMismatch, X as FirstTreeHubSDK, Z as SdkError, g as formatCheckReport, h as promptMissingFields, k as checkWebSocket, m as promptAddAgent, n as deriveHubUrlFromToken, p as isInteractive, t as HubUrlDerivationError, v as onboardCheck, w as checkAgentConfigs, x as runHomeMigration, y as onboardCreate, z as uninstallClientService } from "./saas-connect-DgR60HGv.mjs";
 import { i as ensureFreshAdminToken, n as AuthRefreshRateLimitedError, o as resolveAccessToken, r as ensureFreshAccessToken, s as resolveServerUrl, t as AuthRefreshFailedError } from "./bootstrap-D6RsdtJg.mjs";
 import { i as blank, s as status } from "./cli-fetch-BGVItZxo.mjs";
 import { n as bindFeishuUser, t as bindFeishuBot } from "./feishu-CwD_5b9W.mjs";

package/dist/{saas-connect-DzbieDfo.mjs → saas-connect-DgR60HGv.mjs}

@@ -10286,25 +10286,15 @@ function createResultSink(deps) {
 	async function buildMetadata(text) {
 		const metadata = {};
 		const documentBasePath = await deps.getDocumentBasePath?.();
-		if (documentBasePath) {
-			let snapshotsWritten = false;
-			try {
-				const { docs, skipped } = await buildMessageDocumentSnapshots(text, documentBasePath);
-				if (docs.length > 0) {
-					metadata.documentContext = documentContextSchema.parse({
-						kind: "snapshot",
-						docs
-					});
-					snapshotsWritten = true;
-				}
-				if (skipped > 0) deps.log(`doc snapshot: skipped ${skipped} unresolvable link(s)`);
-			} catch (err) {
-				deps.log(`doc snapshot: build failed, falling back to path variant: ${err.message}`);
-			}
-			if (!snapshotsWritten) metadata.documentContext = documentContextSchema.parse({
-				kind: "path",
-				basePath: documentBasePath
+		if (documentBasePath) try {
+			const { docs, skipped } = await buildMessageDocumentSnapshots(text, documentBasePath);
+			if (docs.length > 0) metadata.documentContext = documentContextSchema.parse({
+				kind: "snapshot",
+				docs
 			});
+			if (skipped > 0) deps.log(`doc snapshot: skipped ${skipped} unresolvable link(s)`);
+		} catch (err) {
+			deps.log(`doc snapshot: build failed, no documentContext attached: ${err.message}`);
 		}
 		return Object.keys(metadata).length > 0 ? metadata : void 0;
 	}
@@ -10398,12 +10388,32 @@ var SessionRegistry = class {
 		}
 	}
 };
-function documentBasePathFromRuntimeConfig(payload) {
-	if (payload.gitRepos.length !== 1) return null;
-	const repo = payload.gitRepos[0];
-	if (!repo) return null;
-	const localPath = repoLocalPath(repo).trim();
-	return localPath.length > 0 ? localPath : null;
+/**
+* Resolve the base path the runtime reads markdown doc snapshots against.
+*
+* NEVER returns null — every chat has a workspace, and the snapshot scanner
+* existence-checks each candidate inside the returned root, so a bare mention
+* that doesn't physically exist simply stays plain text rather than
+* mis-resolving. Previously this returned null for zero/multi-repo
+* workspaces, which left those messages with no `documentContext` at all, so
+* a doc the agent wrote in the workspace could never be previewed.
+*
+* Resolution:
+*  - exactly one repo → that repo's worktree, the unambiguous markdown-link
+*    root. The worktree is materialised at `<perChatRoot>/<localPath>`, so the
+*    base MUST be that ABSOLUTE path. Returning a bare relative `localPath`
+*    (the old behaviour) made the runtime resolve it against its own
+*    `process.cwd()` — the launch dir, not the per-chat workspace — so it
+*    silently failed to find any doc and cloud preview was dead.
+*  - zero or multiple repos → the per-chat workspace root.
+*/
+function documentBasePathFromRuntimeConfig(payload, perChatRoot) {
+	if (payload.gitRepos.length === 1) {
+		const repo = payload.gitRepos[0];
+		const localPath = repo ? repoLocalPath(repo).trim() : "";
+		if (localPath.length > 0) return join(perChatRoot, localPath);
+	}
+	return perChatRoot;
 }
 function repoLocalPath(repo) {
 	return repo.localPath ?? deriveRepoLocalPath(repo.url);
@@ -10886,7 +10896,7 @@ var SessionManager = class {
 				this.currentTrigger.delete(chatId);
 			},
 			log,
-			getDocumentBasePath: () => this.resolveDocumentBasePath(log)
+			getDocumentBasePath: () => this.resolveDocumentBasePath(log, chatId)
 		});
 		const envCtx = {
 			sdk: this.config.sdk,
@@ -10914,14 +10924,15 @@ var SessionManager = class {
 			resolveSenderLabel: async (senderId) => resolveSenderLabel(senderId, await participants.get())
 		};
 	}
-	async resolveDocumentBasePath(log) {
-		if (!this.config.agentConfigCache) return null;
+	async resolveDocumentBasePath(log, chatId) {
+		const perChatRoot = join(this.config.handlerConfig.workspaceRoot, chatId);
+		if (!this.config.agentConfigCache) return perChatRoot;
 		try {
 			const { payload } = await this.config.agentConfigCache.refreshIfNewer(this.config.agentIdentity.agentId, 0);
-			return documentBasePathFromRuntimeConfig(payload);
+			return documentBasePathFromRuntimeConfig(payload, perChatRoot);
 		} catch (err) {
-			log(`document preview base path unavailable: ${err instanceof Error ? err.message : String(err)}`);
-			return null;
+			log(`document preview base path: config unavailable, using workspace root: ${err instanceof Error ? err.message : String(err)}`);
+			return perChatRoot;
 		}
 	}
 	/** Update per-session runtime state and recompute aggregate. Only active sessions may update. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-team-foundation/first-tree-hub",
-  "version": "0.14.9-alpha.294.1",
+  "version": "0.14.9-alpha.296.1",
   "type": "module",
   "description": "First Tree Hub — unified CLI for client and agent management",
   "exports": {