@xopcai/xopc 0.0.284 → 0.0.285

package/dist/src/browser/providers/browser-ext-install.js

@@ -485,10 +485,18 @@ async function readInstalledExtensionDir(cacheDir) {
 	return resolveInstalledExtensionPath(resolved, await readMeta(resolveMetaPath(resolved)));
 }
 function spawnDetached(command, args) {
-	spawn(command, [...args], {
+	const child = spawn(command, [...args], {
 		stdio: "ignore",
 		detached: true
-	}).unref();
+	});
+	child.on("error", (err) => {
+		log.error({
+			err,
+			command,
+			phase: "open_browser_install_ui"
+		}, `Unable to open browser setup: ${err.message}`);
+	});
+	child.unref();
 }
 function windowsExtensionManagerCandidates(env) {
 	const programFiles = [

package/dist/src/cli/command-manifest.js

@@ -128,8 +128,8 @@ const ROOT_HELP_COMMANDS = [
 		description: "Manage web-search providers (brave / tavily / bing / searxng)"
 	},
 	{
-		name: "import [source]",
-		description: "Import skills, context and projects from another AI app"
+		name: "import [options] [source]",
+		description: "Select skills, context and projects to import from another AI app"
 	},
 	{
 		name: "skills",

package/dist/src/cli/commands/agent.js

@@ -8,10 +8,10 @@ import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
 import { AgentService } from "../../agent/service.js";
 import "../../agent/index.js";
-import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
+import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
+import "../../config/index.js";
 import { getXopcCloudCatalogCoordinator } from "../../providers/xopc-cloud-catalog-coordinator.js";
 import { listSessions } from "./agent/sessions.js";
 import { renderStreamToTerminal } from "./agent/stream-renderer.js";

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v174).`,
+		message: `SQLite schema v${status.dbVersion} (current release v177).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -1,10 +1,10 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
 import { loadConfig } from "../../../config/loader.js";
-import { isRestartEnabled } from "../../../config/commands.flags.js";
 import "../../../config/index.js";
-import { resolveGatewayService } from "../../../daemon/service.js";
+import { isRestartEnabled } from "../../../config/commands.flags.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";
+import { resolveGatewayService } from "../../../daemon/service.js";
 import { runServiceRestart, runServiceStop } from "./lifecycle-core.js";
 import { DEFAULT_RESTART_HEALTH_ATTEMPTS, renderGatewayPortHealthDiagnostics, waitForGatewayHealthyListener } from "./restart-health.js";
 import { parsePortFromArgs, renderGatewayServiceStartHints, resolveGatewayPortFromConfig } from "./shared.js";

package/dist/src/cli/commands/gateway/run-foreground.js

@@ -1,3 +1,5 @@
+import { installProcessDiagnostics } from "../../../infra/process-diagnostics.js";
+import { dirname, join } from "node:path";
 //#region src/cli/commands/gateway/run-foreground.ts
 async function ensureGatewayReady(configPath, workspacePath, port) {
 	const { initWorkspace } = await import("../../utils/init-workspace.js");
@@ -20,6 +22,7 @@ async function ensureGatewayReady(configPath, workspacePath, port) {
 	}
 }
 async function runGatewayFromCliOptions(options, ctx) {
+	installProcessDiagnostics(process.env.XOPC_GATEWAY_DIAGNOSTIC_PATH ?? join(process.env.XOPC_LOG_DIR ?? join(dirname(ctx.configPath), "logs"), "gateway-process.log"));
 	const tailscaleModes = new Set([
 		"off",
 		"serve",

package/dist/src/cli/commands/import.js

@@ -1,19 +1,67 @@
 import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../../storage/sqlite/connection.js";
 import { register } from "../registry.js";
 import { isImportSource } from "../../imports/sources.js";
+import { scanProduct } from "../../imports/inventory.js";
+import { importSelection, listImportSources } from "../../imports/productImport.js";
 import { createRuntimeImportService, recoverCapabilityImports } from "../../imports/runtime.js";
-import { importProduct, listImportSources } from "../../imports/productImport.js";
+import { randomUUID } from "node:crypto";
 import { Command } from "commander";
 //#region src/cli/commands/import.ts
 function createImportCommand() {
-	return new Command("import").description("Import skills, context and projects from another AI app").argument("[source]", "codex or claude-code; omit to list detected apps").action(async (source) => {
-		const selected = source && isImportSource(source) ? source : void 0;
-		if (source && !selected) throw new Error("Unsupported import source");
+	return new Command("import").description("Select skills, context and projects to import from another AI app").argument("[source]", "codex or claude-code; omit to list detected apps").option("--inventory <id>", "Previously scanned inventory").option("--items <ids>", "Explicit comma-separated candidate IDs").option("--request-id <id>", "Unique request ID; reuse when retrying a network request").option("--retry-of <id>", "Retry failed items from this run").action(async (source, options) => {
+		const selectedSource = source && isImportSource(source) ? source : void 0;
+		if (source && !selectedSource) throw new Error("Unsupported import source");
+		if ((options.inventory || options.items || options.requestId || options.retryOf) && (!options.inventory || !options.items || !options.requestId)) throw new Error("--inventory, --items and --request-id must be provided together");
 		const opened = !isXopcDatabaseOpen();
 		if (opened) openXopcDatabase();
 		try {
 			await recoverCapabilityImports();
-			console.log(JSON.stringify(selected ? await importProduct(createRuntimeImportService("gateway-owner"), selected) : listImportSources("gateway-owner"), null, 2));
+			const service = createRuntimeImportService("gateway-owner");
+			if (options.inventory) {
+				console.log(JSON.stringify(await importSelection(service, {
+					inventoryId: options.inventory,
+					candidateIds: options.items.split(",").map((s) => s.trim()),
+					requestId: options.requestId,
+					retryOf: options.retryOf
+				}), null, 2));
+				return;
+			}
+			if (!selectedSource) {
+				console.log(JSON.stringify(listImportSources("gateway-owner"), null, 2));
+				return;
+			}
+			const inventory = await scanProduct(service, selectedSource);
+			if (!process.stdin.isTTY || !process.stdout.isTTY) {
+				console.log(JSON.stringify(inventory, null, 2));
+				console.error("No content imported. Submit --inventory, --items and --request-id to import an explicit selection.");
+				return;
+			}
+			const { checkbox, confirm } = await import("@inquirer/prompts");
+			const ids = await checkbox({
+				message: "Select content to import (projects and rules are not selected by default)",
+				choices: inventory.candidates.map((item) => ({
+					name: `${item.kind}: ${item.name} — ${item.displayPath}${item.targetName && item.targetName !== item.name ? ` → ${item.targetName}` : ""}`,
+					value: item.id,
+					checked: item.scope === "user" && item.suggested,
+					disabled: item.status === "blocked" || item.status === "existing" && item.kind !== "project" ? item.reason ?? "Already available" : false
+				}))
+			});
+			const selected = new Set(ids);
+			for (const item of inventory.candidates) {
+				if (selected.has(item.id) && item.parentId) selected.add(item.parentId);
+				if (item.kind === "skill" && item.suggested && item.parentId && ids.includes(item.parentId)) selected.add(item.id);
+			}
+			if (!selected.size) return;
+			const summary = inventory.candidates.filter((i) => selected.has(i.id)).map((i) => `${i.kind}: ${i.name} — ${i.displayPath}`).join("\n");
+			if (!await confirm({
+				message: `Import these ${selected.size} items?\n${summary}`,
+				default: false
+			})) return;
+			console.log(JSON.stringify(await importSelection(service, {
+				inventoryId: inventory.id,
+				candidateIds: [...selected],
+				requestId: randomUUID()
+			}), null, 2));
 		} finally {
 			if (opened) closeXopcDatabase();
 		}
@@ -22,7 +70,7 @@ function createImportCommand() {
 register({
 	id: "import",
 	name: "import",
-	description: "Import from other AI apps",
+	description: "Select content from other AI apps",
 	factory: createImportCommand,
 	metadata: { category: "utility" }
 });

package/dist/src/cli/commands/models.js

@@ -2,9 +2,9 @@ import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
+import "../../config/index.js";
 import { prepareUpdateGlobalDefaults } from "../../gateway/global-defaults-admin.js";
 import { disconnectProvider } from "../../providers/provider-disconnect.js";
 import { colors } from "../utils/colors.js";

package/dist/src/cli/commands/onboard.js

@@ -2,8 +2,8 @@ import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { saveConfig } from "../../config/loader.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { provisionEagerRuntimes } from "../../runtime-tools/bootstrap.js";
 import { colors } from "../utils/colors.js";
 import { initWorkspace } from "../utils/init-workspace.js";

package/dist/src/cli/commands/platform.js

@@ -1,6 +1,6 @@
 import { loadConfig, saveConfig } from "../../config/loader.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { PLATFORM_RUNTIME_PROFILE, PLATFORM_RUNTIME_PROVIDER, PlatformRuntimeClient, discoverPlatform } from "../../platform/client.js";
 import "../../platform/index.js";
 import { getProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";

package/dist/src/cli/commands/profile.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { createProfile, deleteProfile, getCurrentProfile, getSwitchCommand, listProfiles, resolveProfileStateDir } from "../../config/profile.js";
 import { formatExamples, register } from "../registry.js";
+import { createProfile, deleteProfile, getCurrentProfile, getSwitchCommand, listProfiles, resolveProfileStateDir } from "../../config/profile.js";
 import { colors } from "../utils/colors.js";
 import { Command } from "commander";
 import Table from "cli-table3";

package/dist/src/cli/commands/tunnel.js

@@ -7,8 +7,8 @@ import { ensureFrpcBinary } from "../../tunnel/frpc-binary.js";
 import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
 import { loadTunnelState } from "../../tunnel/tunnel-state.js";
 import { getTunnelService } from "../../tunnel/tunnel-service.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { resolveGatewayAuth } from "../../gateway/auth.js";
 import { requireTunnelGatewayToken } from "../../tunnel/auth-policy.js";
 import { TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, hasValidTunnelConsent } from "../../tunnel/consent.js";

package/dist/src/cli/commands/update.js

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
 import { loadConfig } from "../../config/loader.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { acquireUpdateLock } from "../../infra/update-lock.js";
 import { normalizeUpdateChannel } from "../../infra/update-channels.js";
 import { compareSemver, resolveNpmChannelTag } from "../../infra/update-check.js";

package/dist/src/cli/extension-cli-register.js

@@ -4,9 +4,9 @@ import { ExtensionLoader } from "../extensions/loader.js";
 import "../extensions/index.js";
 import { MessageBus } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
+import { createDefaultContext } from "./registry.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { createDefaultContext } from "./registry.js";
 import { registerExtensionCliProgram } from "../extensions/sdk/channel-helpers.js";
 import { join } from "path";
 //#region src/cli/extension-cli-register.ts

package/dist/src/config/index.js

@@ -13,10 +13,10 @@ import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_
 import { CustomModelSchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
 import { canonicalizeConfiguredMcpServer, isKnownCliMcpTypeAlias, normalizeConfiguredMcpServers, resolveXopcMcpTransportAlias } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
-import { diffConfigPaths } from "./diff.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";
 import { listAgentProfileMarkdownDirs, listAgentWorkspaceDirs } from "./workspace-dirs.js";
 import { ProfileManager, createProfile, deleteProfile, getCurrentProfile, getProfileManager, getProfileNameFromDir, getSwitchCommand, listProfiles, resolveProfileStateDir } from "./profile.js";
+import { diffConfigPaths } from "./diff.js";
 import { BASE_RELOAD_RULES, buildReloadPlan, matchReloadRule } from "./rules.js";
 import { ConfigHotReloader } from "./reload.js";
 //#region src/config/index.ts

package/dist/src/discussions/action-tasks.js

@@ -2,8 +2,8 @@ import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/
 import { TaskCreateRequestSchema } from "../../packages/gateway-contract/src/tasks.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskApplicationService } from "../tasks/task-application-service.js";
-import { DiscussionServiceError } from "./errors.js";
 import { getDiscussionCapture, getLatestDiscussionOrganization } from "./repository.js";
+import { DiscussionServiceError } from "./errors.js";
 import { readTranscriptRevision } from "./revisions.js";
 //#region src/discussions/action-tasks.ts
 function meetingActionTasks(id) {

package/dist/src/discussions/edits.js

@@ -1,6 +1,6 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { DiscussionServiceError } from "./errors.js";
 import { completeDiscussionOrganization, createDiscussionOrganization, getDiscussionCapture, getLatestDiscussionOrganization } from "./repository.js";
+import { DiscussionServiceError } from "./errors.js";
 import { z } from "zod";
 const MeetingEditSchema = z.object({
 	kind: z.enum([

package/dist/src/discussions/index.js

@@ -1,7 +1,7 @@
 import { DISCUSSION_AUDIO_MAX_BYTES, DISCUSSION_MAX_DURATION_MS, DISCUSSION_STATUSES } from "../../packages/gateway-contract/src/discussions.js";
 import { DiscussionServiceError } from "./errors.js";
-import { analyzeDiscussion } from "./analyzer.js";
 import { DiscussionService } from "./service.js";
+import { analyzeDiscussion } from "./analyzer.js";
 import { DiscussionOrganizer } from "./organizer.js";
 import { DiscussionLiveWorker } from "./live-worker.js";
 import { DiscussionOrganizerWorker } from "./organizer-worker.js";

package/dist/src/discussions/organizer.js

@@ -1,9 +1,9 @@
 import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ObjectLinkService } from "../activity/service.js";
 import { completeDiscussionOrganization, createDiscussionOrganization, getDiscussionCapture, getLatestDiscussionOrganization, listDiscussionTranscriptSegments, renewDiscussionWorkLease, updateDiscussionCapture } from "./repository.js";
+import { applyMeetingEdits } from "./edits.js";
 import { saveTranscriptRevision } from "./revisions.js";
 import { analyzeDiscussion } from "./analyzer.js";
-import { applyMeetingEdits } from "./edits.js";
 import { acceptRankedProject, findExactProjectMention } from "./project-inference.js";
 //#region src/discussions/organizer.ts
 const PROMPT_VERSION = "discussion-evidence-v2";

package/dist/src/discussions/recording.js

@@ -2,8 +2,8 @@ import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/
 import { DISCUSSION_MAX_DURATION_MS } from "../../packages/gateway-contract/src/discussions.js";
 import { decodeWavToMonoFloat32 } from "../voice/local/wav.js";
 import { forEachNormalizedAudioSegment } from "../voice/audio/normalize.js";
-import { DiscussionServiceError } from "./errors.js";
 import { getDiscussionCapture, updateDiscussionCapture } from "./repository.js";
+import { DiscussionServiceError } from "./errors.js";
 import { resolveNoteMediaDir } from "../notes/paths.js";
 import { join } from "node:path";
 import { createReadStream } from "node:fs";

package/dist/src/discussions/sealer.js

@@ -9,8 +9,8 @@ import "../voice/stt/index.js";
 import { getDiscussionCapture, listDiscussionCaptures, listDiscussionTranscriptSegments, updateDiscussionCapture } from "./repository.js";
 import { assembleDiscussionTranscript } from "./transcript.js";
 import { replaceTranscriptSegments, saveTranscriptRevision } from "./revisions.js";
-import { missingAudioRanges, slicePcmWav } from "./audio-repair.js";
 import { getRecordingJob } from "./recordingJobs.js";
+import { missingAudioRanges, slicePcmWav } from "./audio-repair.js";
 import { createHash } from "node:crypto";
 //#region src/discussions/sealer.ts
 init_logger();

package/dist/src/discussions/service.js

@@ -3,11 +3,11 @@ import { init_logger } from "../utils/logger.js";
 import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { DISCUSSION_AUDIO_MAX_BYTES, DISCUSSION_MAX_DURATION_MS, DISCUSSION_SEGMENT_MAX_BYTES } from "../../packages/gateway-contract/src/discussions.js";
 import { ObjectLinkService } from "../activity/service.js";
-import { DiscussionServiceError } from "./errors.js";
 import { acknowledgeDiscussionCaptureConsent, correctDiscussionTranscriptSegment, createDiscussionCapture, createDiscussionTranscriptSegment, deleteDiscussionSegmentAudio, getDiscussionCapture, getDiscussionCaptureByClientRequestId, getDiscussionCaptureByNoteId, getDiscussionCaptureSettings, getDiscussionMetrics, getDiscussionTranscriptSegment, getLatestDiscussionOrganization, listDiscussionCaptures, listDiscussionTranscriptSegments, updateDiscussionCapture } from "./repository.js";
+import { DiscussionServiceError } from "./errors.js";
+import { editMeeting } from "./edits.js";
 import { assembleDiscussionTranscript } from "./transcript.js";
 import { readTranscriptRevision, refreshCanonicalTranscript, saveTranscriptRevision } from "./revisions.js";
-import { editMeeting } from "./edits.js";
 import { completeRecording, listRecordingChunks, removeRecordingChunks, saveRecordingChunk, validateRecordingManifest } from "./recording.js";
 import { cancelRecordingJob, claimRecordingJob, finishRecordingJob, getRecordingJob, getRecordingJobInput, renewRecordingJob, submitRecordingJob } from "./recordingJobs.js";
 import { createHash, randomUUID } from "node:crypto";

package/dist/src/endpoint-tools/invocation-service.d.ts

@@ -63,6 +63,8 @@ export declare class EndpointInvocationService {
     private cancel;
     private succeed;
     private fail;
+    private finishAudit;
+    private abortUploads;
     private take;
     private error;
 }

package/dist/src/endpoint-tools/invocation-service.js

@@ -1,8 +1,12 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { ENDPOINT_INVOCATION_RECEIPT_TIMEOUT_MS, canonicalJson } from "../../packages/endpoint-tools-protocol/src/index.js";
 import { EndpointToolPolicy, EndpointToolPolicyError } from "./policy.js";
 import crypto from "node:crypto";
 import Ajv2020 from "ajv/dist/2020.js";
 //#region src/endpoint-tools/invocation-service.ts
+init_logger();
+const log = createLogger("EndpointInvocations");
 var EndpointToolExecutionError = class extends Error {
 	constructor(code, message) {
 		super(message);
@@ -55,7 +59,7 @@ var EndpointInvocationService = class {
 				startedAt
 			});
 		} catch (error) {
-			this.options.uploads?.abort(invocationId);
+			this.abortUploads(invocationId, params.endpointId, params.toolName);
 			return Promise.reject(error);
 		}
 		return new Promise((resolve, reject) => {
@@ -155,30 +159,55 @@ var EndpointInvocationService = class {
 	succeed(invocationId, result) {
 		const pending = this.take(invocationId);
 		if (!pending) return;
-		try {
-			this.options.audit?.finished({
-				id: invocationId,
-				status: "succeeded",
-				completedAt: Date.now()
-			});
-		} finally {
-			pending.resolve(result);
-		}
+		this.finishAudit(pending, {
+			id: invocationId,
+			status: "succeeded",
+			completedAt: Date.now()
+		});
+		pending.resolve(result);
 	}
 	fail(invocationId, error) {
 		const pending = this.take(invocationId);
 		if (!pending) return;
+		this.abortUploads(invocationId, pending.endpointId, pending.toolName);
+		this.finishAudit(pending, {
+			id: invocationId,
+			status: "failed",
+			...error instanceof EndpointToolExecutionError ? { errorCode: error.code } : {},
+			errorMessage: error.message,
+			completedAt: Date.now()
+		});
+		pending.reject(error);
+	}
+	finishAudit(pending, result) {
+		try {
+			this.options.audit?.finished(result);
+		} catch (err) {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			log.error({
+				err,
+				errorMessage,
+				invocationId: pending.id,
+				endpointId: pending.endpointId,
+				toolName: pending.toolName,
+				phase: "audit_finish",
+				status: result.status
+			}, `Endpoint invocation audit failed: ${errorMessage}`);
+		}
+	}
+	abortUploads(invocationId, endpointId, toolName) {
 		try {
 			this.options.uploads?.abort(invocationId);
-			this.options.audit?.finished({
-				id: invocationId,
-				status: "failed",
-				...error instanceof EndpointToolExecutionError ? { errorCode: error.code } : {},
-				errorMessage: error.message,
-				completedAt: Date.now()
-			});
-		} finally {
-			pending.reject(error);
+		} catch (err) {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			log.error({
+				err,
+				errorMessage,
+				invocationId,
+				endpointId,
+				toolName,
+				phase: "upload_abort"
+			}, `Endpoint upload cleanup failed: ${errorMessage}`);
 		}
 	}
 	take(invocationId) {

package/dist/src/gateway/heartbeat/check-store.d.ts

@@ -0,0 +1,18 @@
+import type { MessageBus } from '../../infra/bus/index.js';
+export interface HeartbeatCheck {
+    id: string;
+    startedAt: string;
+    completedAt: string | null;
+    status: string;
+    detail: string | null;
+    content: string | null;
+    deliveryStatus: string;
+    target: string | null;
+    chatId: string | null;
+}
+export declare function beginHeartbeatCheck(workspace: string): string;
+export declare function completeHeartbeatCheck(id: string, status: string, detail?: string, content?: string, target?: string, chatId?: string): void;
+export declare function recentHeartbeatChecks(workspace: string): HeartbeatCheck[];
+export declare function recoverHeartbeatChecks(workspace: string): void;
+/** Claim before publishing: an ambiguous bus handoff is never blindly replayed. */
+export declare function deliverHeartbeatChecks(workspace: string, bus: Pick<MessageBus, 'publishOutbound'>, target?: string, chatId?: string): Promise<void>;

package/dist/src/gateway/heartbeat/check-store.js

@@ -0,0 +1,73 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { proactiveChecksAllowed, proactivePreferences, quietHoursEnd } from "../../proactive/policy/service.js";
+import { reserveWorkspaceAttention } from "../../proactive/inbox/digest.js";
+import { createHash, randomUUID } from "node:crypto";
+//#region src/gateway/heartbeat/check-store.ts
+function beginHeartbeatCheck(workspace) {
+	const id = randomUUID();
+	const now = /* @__PURE__ */ new Date();
+	const db = getSqliteDatabase();
+	db.prepare("DELETE FROM heartbeat_checks WHERE workspace_id = ? AND started_at < ?").run(workspace, (/* @__PURE__ */ new Date(now.getTime() - 30 * 864e5)).toISOString());
+	db.prepare("INSERT INTO heartbeat_checks(id, workspace_id, started_at, status, expires_at) VALUES (?, ?, ?, ?, ?)").run(id, workspace, now.toISOString(), "running", new Date(now.getTime() + 864e5).toISOString());
+	return id;
+}
+function completeHeartbeatCheck(id, status, detail, content, target, chatId) {
+	runSqliteWriteTransaction((db) => {
+		const row = db.prepare("SELECT workspace_id FROM heartbeat_checks WHERE id = ?").get(id);
+		const fingerprint = content ? createHash("sha256").update(JSON.stringify([
+			target,
+			chatId,
+			content.trim()
+		])).digest("hex") : null;
+		const delivery = fingerprint && db.prepare(`SELECT 1 FROM heartbeat_checks WHERE workspace_id = ? AND fingerprint = ?
+      AND delivery_status IN ('pending', 'sending', 'queued', 'unknown') AND expires_at > ? AND id <> ?`).get(row.workspace_id, fingerprint, (/* @__PURE__ */ new Date()).toISOString(), id) ? "duplicate" : status === "prepared" ? target && chatId ? "pending" : "no_target" : "none";
+		db.prepare(`UPDATE heartbeat_checks SET status = ?, detail = ?, content = ?, target = ?, chat_id = ?, fingerprint = ?,
+      delivery_status = ?, completed_at = ?, next_attempt_at = ? WHERE id = ? AND status = 'running'`).run(status, detail?.slice(0, 500) ?? null, content?.slice(0, 2e4) ?? null, target ?? null, chatId ?? null, fingerprint, delivery, (/* @__PURE__ */ new Date()).toISOString(), (/* @__PURE__ */ new Date()).toISOString(), id);
+	});
+}
+function recentHeartbeatChecks(workspace) {
+	return getSqliteDatabase().prepare(`SELECT id, started_at AS startedAt, completed_at AS completedAt, status, detail, content,
+    delivery_status AS deliveryStatus, target, chat_id AS chatId FROM heartbeat_checks WHERE workspace_id = ? ORDER BY started_at DESC, rowid DESC LIMIT 10`).all(workspace);
+}
+function recoverHeartbeatChecks(workspace) {
+	const db = getSqliteDatabase();
+	db.prepare("UPDATE heartbeat_checks SET delivery_status = 'unknown', detail = 'Delivery interrupted; verify before sending again' WHERE workspace_id = ? AND delivery_status = 'sending'").run(workspace);
+	db.prepare("UPDATE heartbeat_checks SET status = 'interrupted', completed_at = ? WHERE workspace_id = ? AND status = 'running'").run((/* @__PURE__ */ new Date()).toISOString(), workspace);
+}
+/** Claim before publishing: an ambiguous bus handoff is never blindly replayed. */
+async function deliverHeartbeatChecks(workspace, bus, target, chatId) {
+	const claim = runSqliteWriteTransaction((db) => {
+		const now = /* @__PURE__ */ new Date();
+		db.prepare("UPDATE heartbeat_checks SET delivery_status = 'expired' WHERE workspace_id = ? AND delivery_status = 'pending' AND expires_at <= ?").run(workspace, now.toISOString());
+		const row = db.prepare("SELECT * FROM heartbeat_checks WHERE workspace_id = ? AND delivery_status = 'pending' AND next_attempt_at <= ? ORDER BY started_at LIMIT 1").get(workspace, now.toISOString());
+		if (!row) return null;
+		if (row.target !== target || row.chat_id !== chatId) {
+			db.prepare("UPDATE heartbeat_checks SET delivery_status = 'cancelled', detail = 'Delivery target changed' WHERE id = ?").run(row.id);
+			return null;
+		}
+		const preferences = proactivePreferences(workspace);
+		if (!proactiveChecksAllowed(preferences, now) || preferences.notificationsMuted || preferences.level === "quiet") return null;
+		const quietEnd = quietHoursEnd(preferences, now);
+		if (quietEnd) {
+			db.prepare("UPDATE heartbeat_checks SET next_attempt_at = ? WHERE id = ?").run(quietEnd.toISOString(), row.id);
+			return null;
+		}
+		if (!reserveWorkspaceAttention(workspace, `heartbeat:${row.id}`, now)) return null;
+		db.prepare("UPDATE heartbeat_checks SET delivery_status = 'sending' WHERE id = ? AND delivery_status = 'pending'").run(row.id);
+		return row;
+	});
+	if (!claim) return;
+	try {
+		await bus.publishOutbound({
+			channel: claim.target,
+			chat_id: claim.chat_id,
+			content: claim.content,
+			type: "message"
+		});
+		getSqliteDatabase().prepare("UPDATE heartbeat_checks SET delivery_status = 'queued' WHERE id = ? AND delivery_status = 'sending'").run(claim.id);
+	} catch {
+		getSqliteDatabase().prepare("UPDATE heartbeat_checks SET delivery_status = 'unknown', detail = 'Outbound handoff failed; verify before sending again' WHERE id = ?").run(claim.id);
+	}
+}
+//#endregion
+export { beginHeartbeatCheck, completeHeartbeatCheck, deliverHeartbeatChecks, recentHeartbeatChecks, recoverHeartbeatChecks };

package/dist/src/gateway/heartbeat/service.d.ts

@@ -24,13 +24,16 @@ export interface HeartbeatServiceDeps {
     sessionStore: SessionStore;
     /** Current app config (for HEARTBEAT.md path under the default agent `profile/` directory). */
     getConfig: () => Config;
+    getWorkspace: () => string;
 }
 export declare class HeartbeatService {
     private deps;
     private intervalId;
     private wake;
-    private lastHeartbeatText;
-    private lastHeartbeatAt;
+    private nextCheckAt;
+    private deliveryTimer;
+    private delivering;
+    private recovered;
     private runnerConfig;
     constructor(deps: HeartbeatServiceDeps);
     start(config: HeartbeatRunnerConfig): void;
@@ -41,6 +44,12 @@ export declare class HeartbeatService {
     stop(): void;
     updateConfig(config: Config): void;
     isRunning(): boolean;
+    status(): {
+        enabled: boolean;
+        checksAllowed: boolean;
+        nextCheckAt: string;
+        recent: import("./check-store.js").HeartbeatCheck[];
+    };
+    private drainDeliveries;
     private runHeartbeatOnce;
-    private isDuplicate;
 }