@caplets/core 0.29.0 → 0.29.1

package/dist/{completion-YRQc_o-I.js → completion-CcNgCYzl.js}

@@ -1,5 +1,5 @@
 import { r as __exportAll } from "./rolldown-runtime-CE-6LUnI.js";
-import { Dt as loadConfigWithSources, en as DEFAULT_AUTH_DIR, fn as resolveCapletsRoot, hn as resolveProjectConfigPath, pn as resolveConfigPath, tn as DEFAULT_COMPLETION_CACHE_DIR } from "./service-CnVGCjpT.js";
+import { Dt as loadConfigWithSources, en as DEFAULT_AUTH_DIR, fn as resolveCapletsRoot, hn as resolveProjectConfigPath, pn as resolveConfigPath, tn as DEFAULT_COMPLETION_CACHE_DIR } from "./service-DxPo2KUs.js";
 import { d as CapletsError } from "./validation-CWzd2gtn.js";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";

package/dist/index.js

@@ -1,10 +1,10 @@
 import { t as __commonJSMin } from "./rolldown-runtime-CE-6LUnI.js";
-import { $ as redactCodeModeLogText, $n as isJSONRPCRequest, $t as readTokenBundle, A as resolveRemoteMode, At as loadProjectConfig, Bn as ListResourceTemplatesRequestSchema, Bt as discoverCapletFiles, C as CapletsCloudClient, Cn as toJsonSchemaCompat, Ct as ServerRegistry, D as normalizeRemoteProfileHostUrl, Dn as CreateMessageResultSchema, Dt as loadConfigWithSources, E as isCapletsCloudUrl, En as CompleteRequestSchema, Et as loadConfig, F as resolveCapletsServer, Fn as InitializeRequestSchema, Ft as FileVaultStore, G as runCodeMode, Gn as McpError, Gt as markdownStructuredContent, H as codeModeRunInputSchema, Hn as ListRootsResultSchema, Ht as loadCapletFilesFromMap, I as nativeCapletPromptGuidance, In as InitializedNotificationSchema, It as VAULT_MAX_VALUE_BYTES, J as diagnoseCodeModeTypeScript, Jn as SetLevelRequestSchema, Jt as runOAuthFlow, K as CodeModeSessionManager, Kn as ReadResourceRequestSchema, Kt as refreshOAuthTokenBundle, L as nativeCapletToolDescription, Ln as JSONRPCMessageSchema, Lt as validateVaultKeyName, M as controlUrlForBase, Mn as EmptyResultSchema, Mt as vaultBootstrapResolver, N as isLoopbackHost, Nn as ErrorCode, Nt as vaultResolverForAuthDir, O as resolveCapletsRemote, On as CreateMessageResultWithToolsSchema, Ot as loadGlobalConfig, P as parseServerBaseUrl, Pn as GetPromptRequestSchema, Pt as vaultStoreForAuthDir, Q as CodeModeLogStore, Qn as isJSONRPCErrorResponse, Qt as isTokenBundleExpired, R as nativeCapletToolName, Rn as LATEST_PROTOCOL_VERSION, Rt as decryptVaultValue, S as buildProjectSyncManifest, Sn as mergeCapabilities, St as handleServerTool, T as hostedCloudWorkspaceFromRemoteUrl, Tn as CallToolResultSchema, Tt as GoogleDiscoveryManager, U as codeModeRunParamsSchema, Un as ListToolsRequestSchema, Ut as hasRenderableStructuredContent, Vn as ListResourcesRequestSchema, Vt as validateCapletFile, W as emptyCodeModeRunMeta, Wn as LoggingLevelSchema, Wt as markdownCallToolResultContent, X as listCodeModeCallableCaplets, Xn as assertCompleteRequestResourceTemplate, Xt as startOAuthFlow, Y as createCodeModeCapletsApi, Yn as assertCompleteRequestPrompt, Yt as startGenericOAuthFlow, Z as CodeModeJournalStore, Zn as isInitializeRequest, Zt as deleteTokenBundle, _ as attachErrorResponse, _n as serializeMessage, _t as rotateTelemetryIdentity, a as CloudAuthStore, an as defaultCacheBaseDir, ar as isSchemaOptional, at as version, b as invokeAttachExport, bn as AjvJsonSchemaValidator, bt as findProjectRoot, c as redactedCloudAuthStatus, cn as defaultStateBaseDir, cr as objectFromShape, ct as buildProductTelemetryEvent, d as projectBindingError, dn as defaultUpdateCheckStateDir, dt as maybePrintTelemetryNotice, en as DEFAULT_AUTH_DIR, er as isJSONRPCResultResponse, et as codeModeDeclarationHash, f as projectBindingRecovery, fn as resolveCapletsRoot, ft as resolveTelemetryState, g as CAPLETS_ATTACH_SESSION_HEADER, gn as ReadBuffer, gt as readTelemetryNotice, hn as resolveProjectConfigPath, ht as readTelemetryIdentity, i as createRemoteProfileStore, in as DEFAULT_UPDATE_CHECK_STATE_DIR, ir as getSchemaDescription, it as CapletsEngine, j as appendBasePath, jn as ElicitResultSchema, jt as parseConfig, k as resolveHostedCloudRemote, kn as CreateTaskResultSchema, kt as loadLocalOverlayConfigWithSources, l as PROJECT_BINDING_ERROR_CODES, ln as defaultTelemetryStateDir, lr as safeParse, lt as buildReliabilityTelemetryEvent, mn as resolveProjectCapletsRoot, mt as readTelemetryDeliveryHealth, n as resolveRemoteSelection, nn as DEFAULT_OBSERVED_OUTPUT_SHAPE_CACHE_DIR, nr as getObjectShape, nt as generateCodeModeRunToolDescription, o as cloudAuthPath, on as defaultConfigBaseDir, or as isZ4Schema, ot as createTelemetryDispatcher, p as CloudAuthClient, pn as resolveConfigPath, pt as deleteTelemetryIdentity, q as QuickJsCodeModeSandbox, qn as SUPPORTED_PROTOCOL_VERSIONS, qt as runGenericOAuthFlow, r as cloudCredentialsFromRemoteProfile, rn as DEFAULT_UPDATE_CHECK_CACHE_DIR, rr as getParseErrorMessage, rt as minifyCodeModeDeclarationText, s as migrateCredentials, sn as defaultConfigPath, sr as normalizeObjectSchema, st as TelemetryDebugSink, t as createNativeCapletsService, tr as getLiteralValue, tt as generateCodeModeDeclarations, u as ProjectBindingError, un as defaultUpdateCheckCacheDir, ur as safeParseAsync, ut as durationBucket, v as buildAttachProjection, vn as assertClientRequestTaskCapability, vt as resolveExposure, wn as CallToolRequestSchema, wt as capabilityDescription, x as invokeNativeAttachExport, xn as Protocol, xt as fingerprintProjectRoot, y as buildNativeAttachProjection, yn as assertToolsCallTaskCapability, yt as decodeDirectResourceUri, zn as ListPromptsRequestSchema, zt as encryptVaultValue } from "./service-CnVGCjpT.js";
+import { $ as redactCodeModeLogText, $n as isJSONRPCRequest, $t as readTokenBundle, A as resolveRemoteMode, At as loadProjectConfig, Bn as ListResourceTemplatesRequestSchema, Bt as discoverCapletFiles, C as CapletsCloudClient, Cn as toJsonSchemaCompat, Ct as ServerRegistry, D as normalizeRemoteProfileHostUrl, Dn as CreateMessageResultSchema, Dt as loadConfigWithSources, E as isCapletsCloudUrl, En as CompleteRequestSchema, Et as loadConfig, F as resolveCapletsServer, Fn as InitializeRequestSchema, Ft as FileVaultStore, G as runCodeMode, Gn as McpError, Gt as markdownStructuredContent, H as codeModeRunInputSchema, Hn as ListRootsResultSchema, Ht as loadCapletFilesFromMap, I as nativeCapletPromptGuidance, In as InitializedNotificationSchema, It as VAULT_MAX_VALUE_BYTES, J as diagnoseCodeModeTypeScript, Jn as SetLevelRequestSchema, Jt as runOAuthFlow, K as CodeModeSessionManager, Kn as ReadResourceRequestSchema, Kt as refreshOAuthTokenBundle, L as nativeCapletToolDescription, Ln as JSONRPCMessageSchema, Lt as validateVaultKeyName, M as controlUrlForBase, Mn as EmptyResultSchema, Mt as vaultBootstrapResolver, N as isLoopbackHost, Nn as ErrorCode, Nt as vaultResolverForAuthDir, O as resolveCapletsRemote, On as CreateMessageResultWithToolsSchema, Ot as loadGlobalConfig, P as parseServerBaseUrl, Pn as GetPromptRequestSchema, Pt as vaultStoreForAuthDir, Q as CodeModeLogStore, Qn as isJSONRPCErrorResponse, Qt as isTokenBundleExpired, R as nativeCapletToolName, Rn as LATEST_PROTOCOL_VERSION, Rt as decryptVaultValue, S as buildProjectSyncManifest, Sn as mergeCapabilities, St as handleServerTool, T as hostedCloudWorkspaceFromRemoteUrl, Tn as CallToolResultSchema, Tt as GoogleDiscoveryManager, U as codeModeRunParamsSchema, Un as ListToolsRequestSchema, Ut as hasRenderableStructuredContent, Vn as ListResourcesRequestSchema, Vt as validateCapletFile, W as emptyCodeModeRunMeta, Wn as LoggingLevelSchema, Wt as markdownCallToolResultContent, X as listCodeModeCallableCaplets, Xn as assertCompleteRequestResourceTemplate, Xt as startOAuthFlow, Y as createCodeModeCapletsApi, Yn as assertCompleteRequestPrompt, Yt as startGenericOAuthFlow, Z as CodeModeJournalStore, Zn as isInitializeRequest, Zt as deleteTokenBundle, _ as attachErrorResponse, _n as serializeMessage, _t as rotateTelemetryIdentity, a as CloudAuthStore, an as defaultCacheBaseDir, ar as isSchemaOptional, at as version, b as invokeAttachExport, bn as AjvJsonSchemaValidator, bt as findProjectRoot, c as redactedCloudAuthStatus, cn as defaultStateBaseDir, cr as objectFromShape, ct as buildProductTelemetryEvent, d as projectBindingError, dn as defaultUpdateCheckStateDir, dt as maybePrintTelemetryNotice, en as DEFAULT_AUTH_DIR, er as isJSONRPCResultResponse, et as codeModeDeclarationHash, f as projectBindingRecovery, fn as resolveCapletsRoot, ft as resolveTelemetryState, g as CAPLETS_ATTACH_SESSION_HEADER, gn as ReadBuffer, gt as readTelemetryNotice, hn as resolveProjectConfigPath, ht as readTelemetryIdentity, i as createRemoteProfileStore, in as DEFAULT_UPDATE_CHECK_STATE_DIR, ir as getSchemaDescription, it as CapletsEngine, j as appendBasePath, jn as ElicitResultSchema, jt as parseConfig, k as resolveHostedCloudRemote, kn as CreateTaskResultSchema, kt as loadLocalOverlayConfigWithSources, l as PROJECT_BINDING_ERROR_CODES, ln as defaultTelemetryStateDir, lr as safeParse, lt as buildReliabilityTelemetryEvent, mn as resolveProjectCapletsRoot, mt as readTelemetryDeliveryHealth, n as resolveRemoteSelection, nn as DEFAULT_OBSERVED_OUTPUT_SHAPE_CACHE_DIR, nr as getObjectShape, nt as generateCodeModeRunToolDescription, o as cloudAuthPath, on as defaultConfigBaseDir, or as isZ4Schema, ot as createTelemetryDispatcher, p as CloudAuthClient, pn as resolveConfigPath, pt as deleteTelemetryIdentity, q as QuickJsCodeModeSandbox, qn as SUPPORTED_PROTOCOL_VERSIONS, qt as runGenericOAuthFlow, r as cloudCredentialsFromRemoteProfile, rn as DEFAULT_UPDATE_CHECK_CACHE_DIR, rr as getParseErrorMessage, rt as minifyCodeModeDeclarationText, s as migrateCredentials, sn as defaultConfigPath, sr as normalizeObjectSchema, st as TelemetryDebugSink, t as createNativeCapletsService, tr as getLiteralValue, tt as generateCodeModeDeclarations, u as ProjectBindingError, un as defaultUpdateCheckCacheDir, ur as safeParseAsync, ut as durationBucket, v as buildAttachProjection, vn as assertClientRequestTaskCapability, vt as resolveExposure, wn as CallToolRequestSchema, wt as capabilityDescription, x as invokeNativeAttachExport, xn as Protocol, xt as fingerprintProjectRoot, y as buildNativeAttachProjection, yn as assertToolsCallTaskCapability, yt as decodeDirectResourceUri, zn as ListPromptsRequestSchema, zt as encryptVaultValue } from "./service-DxPo2KUs.js";
 import { _ as record, b as unknown, d as literal, m as object, n as ZodOptional, o as array, p as number, r as _enum, s as boolean, v as string, x as url } from "./schemas-BoqMu4MG.js";
 import { a as SERVER_ID_PATTERN, d as CapletsError, m as toSafeError, p as redactSecrets$1, u as CAPLETS_ERROR_CODES } from "./validation-CWzd2gtn.js";
 import { generatedToolInputSchema, generatedToolInputSchemaForCaplet } from "./generated-tool-input-schema.js";
 import { f as observedOutputShapeKey, i as observeOutputShape, u as FileObservedOutputShapeStore } from "./observed-output-shapes-DuP7mJQf.js";
-import { a as formatCapletList, c as resolveCliConfigPaths, l as cliCommands$1, n as completionScript, o as formatConfigPaths, s as listCaplets, t as completeCliWords, u as completionShells } from "./completion-YRQc_o-I.js";
+import { a as formatCapletList, c as resolveCliConfigPaths, l as cliCommands$1, n as completionScript, o as formatConfigPaths, s as listCaplets, t as completeCliWords, u as completionShells } from "./completion-CcNgCYzl.js";
 import { n as normalizeCapletSourcePath, t as FilesystemCapletSource } from "./filesystem-Kkg32TOJ.js";
 import { parseConfig as parseConfig$1 } from "./config-runtime.js";
 import fs, { accessSync, chmodSync, closeSync, constants, copyFileSync, cpSync, existsSync, fstatSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, watch, writeFileSync, writeSync } from "node:fs";
@@ -13451,9 +13451,10 @@ async function doctorJsonReport(options = {}) {
 			authMode: remoteLogin.authenticated ? remoteLogin.kind === "cloud" ? "hosted_cloud" : "self_hosted_remote" : remote.configured || remoteLogin.configured ? "remote_login_required" : "unconfigured",
 			selectedWorkspace: remoteLogin.selectedWorkspace ?? remote.workspace ?? null,
 			webSocketUrl: remote.webSocketUrl,
+			sessionSupport: remoteLogin.kind === "self-hosted" ? "unsupported" : "unknown",
 			lease: null,
 			lastUpgradeError: null,
-			recoveryCommand: remoteLogin.authenticated ? "caplets attach --once" : remote.configured || remoteLogin.configured ? `caplets remote login ${remoteLogin.hostUrl ?? "<url>"}` : "caplets remote login <url>"
+			recoveryCommand: projectBindingRecovery$1(remoteLogin, remote)
 		},
 		sync: {
 			state: options.syncStatus?.state ?? "idle",
@@ -13494,6 +13495,7 @@ async function formatDoctorReport(options = {}) {
 		`  Auth mode: ${report.projectBinding.authMode}`,
 		`  Selected Workspace: ${report.projectBinding.selectedWorkspace ?? "none"}`,
 		`  Binding Session: ${report.projectBinding.state}`,
+		...report.projectBinding.sessionSupport !== "unknown" ? [`  Session support: ${report.projectBinding.sessionSupport}`] : [],
 		`  Recovery: ${report.projectBinding.recoveryCommand}`,
 		"",
 		"Project sync",
@@ -13568,6 +13570,11 @@ function vaultIssueFromWarning(message, path) {
 		recoveryCommand
 	};
 }
+function projectBindingRecovery$1(remoteLogin, remote) {
+	if (remoteLogin.authenticated) return remoteLogin.kind === "self-hosted" ? "Self-hosted Project Binding sessions are not implemented by this runtime." : "caplets attach --once";
+	if (remote.configured || remoteLogin.configured) return `caplets remote login ${remoteLogin.hostUrl ?? "<url>"}`;
+	return "caplets remote login <url>";
+}
 async function resolveDaemonSection(env, options) {
 	try {
 		const status = await daemonStatus({
@@ -18792,17 +18799,16 @@ function createProgram(io = {}) {
 		writeOut(await runSetup(integration, setupOptions));
 	});
 	program.command(cliCommands$1.doctor).description("Diagnose Caplets local, remote, and project-sync configuration.").option("--json", "print JSON output").action(async (options) => {
+		const doctorOptions = {
+			env,
+			...io.authDir ? { authDir: io.authDir } : {},
+			...io.daemon ? { daemon: io.daemon } : {}
+		};
 		if (options.json) {
-			writeOut(`${JSON.stringify(await doctorJsonReport({
-				env,
-				...io.daemon ? { daemon: io.daemon } : {}
-			}), null, 2)}\n`);
+			writeOut(`${JSON.stringify(await doctorJsonReport(doctorOptions), null, 2)}\n`);
 			return;
 		}
-		writeOut(await formatDoctorReport({
-			env,
-			...io.daemon ? { daemon: io.daemon } : {}
-		}));
+		writeOut(await formatDoctorReport(doctorOptions));
 	});
 	const vault = program.command(cliCommands$1.vault).description("Manage Caplets Vault values.");
 	vault.command("set").description("Set a local/global Vault value.").argument("<name>", "Vault key name").option("-g, --global", "target the local/global Vault").option("--remote", "target the selected remote Vault").option("--force", "overwrite an existing Vault value").option("--grant <capletId>", "grant this key to a configured Caplet after setting it").option("--as <referenceName>", "reference name the Caplet uses in config").option("--json", "print JSON output").action(async (name, options) => {

package/dist/native.js

@@ -1,4 +1,4 @@
-import { B as nativeCodeModeToolId, I as nativeCapletPromptGuidance, L as nativeCapletToolDescription, R as nativeCapletToolName, V as nativeCodeModeToolName, h as createSdkRemoteCapletsClient, m as RemoteNativeCapletsService, t as createNativeCapletsService, w as resolveNativeCapletsServiceOptions, z as nativeCapletsSystemGuidance } from "./service-CnVGCjpT.js";
+import { B as nativeCodeModeToolId, I as nativeCapletPromptGuidance, L as nativeCapletToolDescription, R as nativeCapletToolName, V as nativeCodeModeToolName, h as createSdkRemoteCapletsClient, m as RemoteNativeCapletsService, t as createNativeCapletsService, w as resolveNativeCapletsServiceOptions, z as nativeCapletsSystemGuidance } from "./service-DxPo2KUs.js";
 import { generatedToolInputJsonSchema, generatedToolInputSchema } from "./generated-tool-input-schema.js";
 //#region src/native/process-cleanup.ts
 function registerNativeCapletsProcessCleanup(service, options = {}) {

package/dist/{service-CnVGCjpT.js → service-DxPo2KUs.js}

@@ -64515,7 +64515,7 @@ async function defaultSentryFactory(dsn) {
 }
 //#endregion
 //#region package.json
-var version = "0.29.0";
+var version = "0.29.1";
 //#endregion
 //#region src/telemetry/runtime.ts
 function createRuntimeTelemetryContext(options) {
@@ -64892,7 +64892,7 @@ var CapletsEngine = class {
 		}
 	}
 	async completeCliWords(words) {
-		const { completeCliWords } = await import("./completion-YRQc_o-I.js").then((n) => n.r);
+		const { completeCliWords } = await import("./completion-CcNgCYzl.js").then((n) => n.r);
 		return await completeCliWords(words, {
 			config: this.registry.config,
 			managers: {
@@ -82265,6 +82265,8 @@ function downstreamResourceUri$1(capletId, uri) {
 //#endregion
 //#region src/native/remote.ts
 const ATTACH_SESSION_UNSUPPORTED_RETRY_MS = 6e4;
+const ATTACH_SESSION_CREATE_TIMEOUT_MS = 5e3;
+const ATTACH_SESSION_CREATE_TIMED_OUT = Symbol("attach session create timed out");
 function createSdkRemoteCapletsClient(options) {
 	const listeners = /* @__PURE__ */ new Set();
 	let manifest;
@@ -82295,10 +82297,15 @@ function createSdkRemoteCapletsClient(options) {
 		if (attachSessionsUnsupportedUntil > Date.now()) return void 0;
 		attachSessionsUnsupportedUntil = 0;
 		if (attachSessionId) return attachSessionId;
-		if (attachSessionInFlight) return await attachSessionInFlight;
+		if (attachSessionInFlight) {
+			const inFlightSessionId = await attachSessionInFlight;
+			return inFlightSessionId === ATTACH_SESSION_CREATE_TIMED_OUT ? void 0 : inFlightSessionId;
+		}
 		attachSessionInFlight = createAttachSession(runtimeOptions.url, runtimeOptions.requestInit, fetchFor(runtimeOptions), options.attachSessionMetadata);
 		try {
-			attachSessionId = await attachSessionInFlight;
+			const createdSessionId = await attachSessionInFlight;
+			if (createdSessionId === ATTACH_SESSION_CREATE_TIMED_OUT) return;
+			attachSessionId = createdSessionId;
 			if (!attachSessionId) attachSessionsUnsupportedUntil = Date.now() + ATTACH_SESSION_UNSUPPORTED_RETRY_MS;
 			return attachSessionId;
 		} finally {
@@ -82419,8 +82426,8 @@ function createSdkRemoteCapletsClient(options) {
 			eventsAbort?.abort();
 			eventsAbort = void 0;
 			listeners.clear();
-			const pendingSessionId = await attachSessionInFlight?.catch(() => void 0);
-			const sessionId = attachSessionId ?? pendingSessionId;
+			const pendingSessionResult = await attachSessionInFlight?.catch(() => void 0);
+			const sessionId = attachSessionId ?? (typeof pendingSessionResult === "string" ? pendingSessionResult : void 0);
 			attachSessionId = void 0;
 			if (sessionId) await (async () => {
 				const runtimeOptions = await resolveRuntimeOptions();
@@ -82643,12 +82650,39 @@ async function fetchAttachManifest(attachUrl, requestInit, attachSessionId, fetc
 async function createAttachSession(attachUrl, requestInit, fetchImpl, metadata) {
 	const headers = new Headers(requestInit?.headers);
 	headers.set("content-type", "application/json");
-	const response = await fetchImpl(new URL("sessions", slashUrl(attachUrl)), {
+	let timeout;
+	let timedOut = false;
+	const sessionUrl = new URL("sessions", slashUrl(attachUrl));
+	const timeoutReached = new Promise((resolve) => {
+		timeout = setTimeout(() => {
+			timedOut = true;
+			resolve(ATTACH_SESSION_CREATE_TIMED_OUT);
+		}, ATTACH_SESSION_CREATE_TIMEOUT_MS);
+		timeout.unref?.();
+	});
+	const fetchSession = fetchImpl(sessionUrl, {
 		...requestInit,
 		method: "POST",
 		headers,
 		body: JSON.stringify(metadata)
+	}).catch((error) => {
+		if (timedOut) return void 0;
+		throw error;
 	});
+	fetchSession.then(async (response) => {
+		if (!timedOut || !response?.ok) return;
+		const lateSessionId = await attachSessionIdFromResponse(response).catch(() => void 0);
+		if (!lateSessionId) return;
+		await closeAttachSession(attachUrl, requestInit, fetchImpl, lateSessionId).catch(() => void 0);
+	}).catch(() => void 0);
+	let response;
+	try {
+		response = await Promise.race([fetchSession, timeoutReached]);
+	} finally {
+		if (timeout) clearTimeout(timeout);
+	}
+	if (response === ATTACH_SESSION_CREATE_TIMED_OUT) return ATTACH_SESSION_CREATE_TIMED_OUT;
+	if (!response) return void 0;
 	if (!response.ok) {
 		if (response.status === 404) return void 0;
 		let payload;
@@ -82660,9 +82694,16 @@ async function createAttachSession(attachUrl, requestInit, fetchImpl, metadata)
 		if (response.status === 400 && isAttachSessionProjectContextRejected(payload)) return;
 		throw new CapletsError("SERVER_UNAVAILABLE", `Caplets attach session returned HTTP ${response.status}.`);
 	}
+	return await parseAttachSessionIdResponse(response);
+}
+async function parseAttachSessionIdResponse(response) {
+	const sessionId = await attachSessionIdFromResponse(response);
+	if (!sessionId) throw new CapletsError("SERVER_UNAVAILABLE", "Caplets attach session response was invalid.");
+	return sessionId;
+}
+async function attachSessionIdFromResponse(response) {
 	const payload = await response.json();
-	if (!isPlainObject(payload) || typeof payload.sessionId !== "string") throw new CapletsError("SERVER_UNAVAILABLE", "Caplets attach session response was invalid.");
-	return payload.sessionId;
+	return isPlainObject(payload) && typeof payload.sessionId === "string" ? payload.sessionId : void 0;
 }
 async function closeAttachSession(attachUrl, requestInit, fetchImpl, attachSessionId) {
 	await fetchImpl(new URL(`sessions/${encodeURIComponent(attachSessionId)}`, slashUrl(attachUrl)), {
@@ -83668,10 +83709,12 @@ var FileRemoteProfileStore = class {
 			kind: "self-hosted",
 			hostUrl: normalizeRemoteProfileHostUrl(input.hostUrl)
 		});
+		const snapshot = await this.withMutationLock(async () => this.selfHostedRefreshSnapshot(key, input));
+		if (!snapshot || !snapshot.needsRefresh) return snapshot?.result;
 		return await this.withRefreshLock(key, async () => {
-			const snapshot = await this.withMutationLock(async () => this.selfHostedRefreshSnapshot(key, input));
-			if (!snapshot || !snapshot.needsRefresh) return snapshot?.result;
-			const refreshed = await input.refresh(snapshot.result.status, snapshot.result.credential);
+			const lockedSnapshot = await this.withMutationLock(async () => this.selfHostedRefreshSnapshot(key, input));
+			if (!lockedSnapshot || !lockedSnapshot.needsRefresh) return lockedSnapshot?.result;
+			const refreshed = await input.refresh(lockedSnapshot.result.status, lockedSnapshot.result.credential);
 			return await this.withMutationLock(async () => {
 				const current = await this.selfHostedRefreshSnapshot(key, input);
 				if (!current || !current.needsRefresh) return current?.result;
@@ -84319,6 +84362,7 @@ function requiredHostedCloudAttachScopes() {
 //#endregion
 //#region src/native/service.ts
 const REMOTE_PROJECT_BINDING_FALLBACK_WARNING = "Remote project binding unavailable; using local Caplets only. Run caplets doctor for details.\n";
+const SELF_HOSTED_PROJECT_BINDING_UNSUPPORTED_MESSAGE = "Self-hosted Project Binding sessions are not implemented by this runtime.";
 let hasWarnedRemoteProjectBindingFallback = false;
 function createNativeCapletsService(options = {}) {
 	const resolved = resolveNativeCapletsServiceOptions(options);
@@ -85230,6 +85274,7 @@ var CompositeNativeCapletsService = class {
 	}
 	startPresence() {
 		this.presence?.start().catch((error) => {
+			if (isUnsupportedProjectBinding(error)) return;
 			writeErr(this.options, `Could not start upstream Project Binding: ${errorMessage(error)}\n`);
 		});
 	}
@@ -85468,7 +85513,7 @@ var RemoteProjectBindingSessionManager = class {
 	}
 };
 function isUnsupportedProjectBinding(error) {
-	return isRecord(error) && error.code === "UNSUPPORTED_CAPABILITY";
+	return isRecord(error) && error.code === "UNSUPPORTED_CAPABILITY" && error.message === SELF_HOSTED_PROJECT_BINDING_UNSUPPORTED_MESSAGE;
 }
 function projectBindingUrl(attachUrl, ...segments) {
 	const url = new URL(attachUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caplets/core",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "Core runtime library for Caplets Code Mode and progressive disclosure gateways.",
   "keywords": [
     "caplets",