@xopcai/xopc 0.0.432 → 0.0.434

package/dist/src/computer/runtime.js

@@ -1,19 +1,20 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
-import { COMPUTER_CONTROL_TOOL, ComputerActionSchema, ComputerAppSchema, ComputerObservationSchema, ComputerTransportTimingSchema, ComputerWindowSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
+import { COMPUTER_CONTROL_TOOL, ComputerActionSchema, ComputerAppSchema, ComputerObservationSchema, ComputerTransportTimingSchema, ComputerWindowSchema, computerActionInputCount, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { ComputerServiceLimitsSchema, computerModelProfile, init_model_policy } from "./model-policy.js";
 import { getApiKey, init_providers, resolveModel } from "../providers/index.js";
 import { rejectUnbudgetedCloudTransport } from "../providers/xopc-cloud-credit-budget.js";
+import { enterComputerControl, leaveComputerControl } from "./control-guard.js";
 import { clearComputerFrames, computerAgentTurn, retainComputerFrame } from "./agent-context.js";
 import { ComputerDiagnosticSchema, ComputerOperationError, computerDiagnostic, computerRecovery } from "./errors.js";
-import { enterComputerControl, leaveComputerControl } from "./control-guard.js";
-import { ComputerNativeTimingSchema, ComputerSessionDiagnostics } from "./diagnostics.js";
-import { ComputerFlowCapture, ComputerFlowStore, computerFlowHint, computerFlowMetadata } from "./flows.js";
 import { createComputerModelAdapter, predictComputerStep, readComputerJson } from "./model-adapter.js";
-import { executeComputerProgram } from "./program-runtime.js";
 import { groundComputerAction } from "./semantic-actions.js";
+import { ComputerFlowCapture, ComputerFlowStore, computerFlowHint, computerFlowMetadata } from "./flows.js";
+import { ComputerNativeTimingSchema, ComputerSessionDiagnostics } from "./diagnostics.js";
+import { executeComputerProgram } from "./program-runtime.js";
 import { ComputerExpectationSchema, ComputerTaskState, verifyComputerExpectation } from "./task-state.js";
+import { executeComputerBatch } from "./batch.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { setTimeout } from "node:timers/promises";
@@ -45,6 +46,16 @@ const Reply = z.object({
 	windows: z.array(ComputerWindowSchema).max(100).optional(),
 	receipt: z.object({
 		actionId: z.string(),
+		inputCount: z.number().int().min(1).max(12).optional(),
+		steps: z.array(z.object({
+			index: z.number().int().min(0).max(11),
+			dispatch: z.enum([
+				"notStarted",
+				"started",
+				"completed",
+				"unknown"
+			])
+		}).strict()).max(12).optional(),
 		dispatch: z.enum([
 			"notStarted",
 			"started",
@@ -264,6 +275,7 @@ var ComputerRuntime = class {
 		const combined = AbortSignal.any([signal, s.controller.signal]);
 		let current;
 		let actions = 0;
+		const receipts = [];
 		let imageRef;
 		const observe = async (observationSignal = combined) => {
 			current?.frame?.fill(0);
@@ -295,12 +307,41 @@ var ComputerRuntime = class {
 			return observation;
 		};
 		try {
-			const result = await executeComputerProgram(input.code, async (method, args, callSignal) => {
+			const host = async (method, args, callSignal) => {
 				callSignal.throwIfAborted();
 				if (!this.getConfig().computer.enabled || Date.now() - s.createdAt >= this.getConfig().computer.maxSessionDurationMs) throw new Error("COMPUTER_SESSION_BUDGET");
 				if (JSON.stringify(computerAgentTurn(owner).binding) !== JSON.stringify(s.binding)) throw new Error("COMPUTER_AGENT_MODEL_CHANGED");
 				await turn.authorize?.(method, args);
 				const hostResult = await (async () => {
+					if (method === "batch") {
+						if (s.mode === "observe") throw new Error("COMPUTER_READ_ONLY");
+						return executeComputerBatch(args, host, {
+							remainingInputs: (input.maxActions ?? 6) - actions,
+							signal: callSignal,
+							state: (id) => {
+								const observation = snapshot(id);
+								let data;
+								try {
+									data = JSON.parse(observation.summary);
+								} catch {
+									data = {
+										text: observation.summary,
+										elements: [],
+										truncated: true
+									};
+								}
+								return {
+									...data,
+									snapshotId: id
+								};
+							},
+							verify: (expect) => {
+								const verification = verifyComputerExpectation(expect, current?.value.observation);
+								s.diagnostics.verify(verification);
+								return verification;
+							}
+						});
+					}
 					if (method === "observe") {
 						const options = z.object({ visual: z.boolean().optional() }).strict().parse(args ?? {});
 						const state = await observe(callSignal);
@@ -328,18 +369,36 @@ var ComputerRuntime = class {
 					if (method === "verify" || method === "waitFor") {
 						const value = z.object({
 							expect: ComputerExpectationSchema,
-							timeoutMs: z.number().int().min(0).max(5e3).optional()
+							timeoutMs: z.number().int().min(0).max(5e3).optional(),
+							fresh: z.boolean().optional()
 						}).strict().parse(args);
 						const deadline = Date.now() + (method === "waitFor" ? value.timeoutMs ?? 2e3 : 0);
 						for (let sample = 0; sample < 20; sample++) {
-							const state = await observe(callSignal);
+							const cached = current?.value.observation;
+							const reuse = sample === 0 && !value.fresh && cached && Date.now() - cached.capturedAt >= 0 && Date.now() - cached.capturedAt <= 5e3;
+							let state;
+							if (reuse) try {
+								state = {
+									...JSON.parse(cached.summary),
+									snapshotId: cached.id
+								};
+							} catch {
+								state = {
+									text: cached.summary,
+									elements: [],
+									truncated: true,
+									snapshotId: cached.id
+								};
+							}
+							else state = await observe(callSignal);
 							const verification = verifyComputerExpectation(value.expect, current.value.observation);
 							s.diagnostics.verify(verification);
 							if (verification?.status === "satisfied" || Date.now() >= deadline || sample === 19) return {
 								...state,
-								verification
+								verification,
+								observationReused: Boolean(reuse)
 							};
-							await setTimeout(100, void 0, { signal: callSignal });
+							await setTimeout(Math.min(25 * 2 ** Math.min(sample, 3), 200, Math.max(0, deadline - Date.now())), void 0, { signal: callSignal });
 						}
 					}
 					if (method === "act") {
@@ -350,7 +409,7 @@ var ComputerRuntime = class {
 							expect: ComputerExpectationSchema.optional()
 						}).strict().parse(args);
 						const before = snapshot(value.snapshotId);
-						if (++actions > (input.maxActions ?? 6)) throw new Error("COMPUTER_ACTION_BUDGET");
+						if ((actions += computerActionInputCount(value.action)) > (input.maxActions ?? 6)) throw new Error("COMPUTER_ACTION_BUDGET");
 						const action = groundComputerAction(value.action, before);
 						s.task.assertProgress(action, before);
 						s.pendingContext = {
@@ -371,7 +430,7 @@ var ComputerRuntime = class {
 						const context = {
 							observationsReused: 0,
 							stabilityObservations: 0,
-							actionsRemaining: 1,
+							actionsRemaining: computerActionInputCount(action),
 							nativeMs: {
 								precheckMs: 0,
 								inputMs: 0,
@@ -382,14 +441,9 @@ var ComputerRuntime = class {
 						imageRef = void 0;
 						current?.frame?.fill(0);
 						current = void 0;
-						const authorizationDeadline = Date.now() + 6e4;
-						let reply = await this.dispatchAction(s, envelope, callSignal, context);
-						while (reply.status === "pending_action") {
-							if (Date.now() >= authorizationDeadline) throw new Error("COMPUTER_AUTHORIZATION_TIMEOUT");
-							await setTimeout(250, void 0, { signal: callSignal });
-							reply = await this.dispatchAction(s, envelope, callSignal, context);
-						}
+						const reply = await this.dispatchAction(s, envelope, callSignal, context);
 						current = context.observation;
+						if (reply.receipt) receipts.push(reply.receipt);
 						if (reply.errorCode || reply.receipt?.dispatch !== "completed") throw new Error(reply.errorCode ?? "COMPUTER_NATIVE_ACTION_FAILED");
 						let state = {};
 						try {
@@ -407,17 +461,20 @@ var ComputerRuntime = class {
 					throw new Error("COMPUTER_INVALID_INPUT");
 				})();
 				return await turn.complete?.(method, hostResult) ?? hostResult;
-			}, s.programStore ??= Object.create(null), combined, input.timeoutMs);
+			};
+			const result = await executeComputerProgram(input.code, host, s.programStore ??= Object.create(null), combined, input.timeoutMs);
 			if (result.status === "program_error") {
 				await this.close(owner);
 				return {
 					...result,
-					sessionId: s.id
+					sessionId: s.id,
+					receipts
 				};
 			}
 			return {
 				...result,
 				sessionId: s.id,
+				receipts,
 				...imageRef ? { imageRef } : {},
 				budget: this.budget(s)
 			};
@@ -466,18 +523,8 @@ var ComputerRuntime = class {
 				signal.throwIfAborted();
 				context.actionsRemaining = (input.maxActions ?? 6) - actionsExecuted;
 				let result = await this.executeInput(owner, step, signal, diagnostics, context);
-				const authorizationDeadline = Date.now() + 6e4;
-				while (result.status === "pending_authorization" || result.status === "pending_action") {
-					const authorizingSession = result.status === "pending_authorization";
-					if (Date.now() >= authorizationDeadline) {
-						await this.close(owner);
-						throw new Error("COMPUTER_AUTHORIZATION_TIMEOUT");
-					}
-					await setTimeout(250, void 0, { signal });
-					result = await this.executeInput(owner, authorizingSession ? { op: "observe" } : step, signal, diagnostics, context);
-					if (authorizingSession && result.status === "ready" && !result.errorCode) result = await this.executeInput(owner, step, signal, diagnostics, context);
-				}
-				if (result.receipt?.dispatch === "completed") actionsExecuted++;
+				if (result.receipt?.dispatch === "completed") actionsExecuted += result.receipt.inputCount ?? 1;
+				else actionsExecuted += result.receipt?.steps?.filter((step) => step.dispatch === "completed").length ?? 0;
 				if (result.errorCode || result.pending || result.receipt && result.receipt.dispatch !== "completed") return finish(result, "handoff");
 				if (result.verified) return finish({
 					...result,
@@ -645,11 +692,16 @@ var ComputerRuntime = class {
 					...reply.value.status !== "stopped" ? { budget: this.budget(s) } : {}
 				};
 			}
-			const status = await this.send(s, {
+			let status = goalContext?.observation ?? await this.send(s, {
 				op: "status",
 				sessionId: s.id,
 				owner
 			}, signal);
+			if (status.value.status === "pending_authorization") status = await this.send(s, {
+				op: "settle",
+				sessionId: s.id,
+				owner
+			}, signal);
 			if (status.value.status === "stopped") {
 				if (status.value.errorCode) s.diagnostics.fail(new Error(status.value.errorCode), "observe", "notStarted");
 				this.forget(s);
@@ -785,6 +837,7 @@ var ComputerRuntime = class {
 						};
 					}
 					const action = groundComputerAction(proposal.action, o);
+					if ((action.kind === "activateSequence" || action.kind === "batch") && !goalContext) throw new Error("COMPUTER_ACTION_BUDGET");
 					const e = {
 						actionId: randomUUID(),
 						sessionId: s.id,
@@ -838,10 +891,10 @@ var ComputerRuntime = class {
 	}
 	async dispatchAction(s, envelope, signal, goalContext) {
 		if (!s.pending) {
-			if (s.actions >= this.getConfig().computer.maxActionsPerSession) throw new Error("COMPUTER_ACTION_BUDGET");
-			s.actions++;
+			if (s.actions + computerActionInputCount(envelope.action) > this.getConfig().computer.maxActionsPerSession || goalContext && computerActionInputCount(envelope.action) > goalContext.actionsRemaining) throw new Error("COMPUTER_ACTION_BUDGET");
+			s.actions += computerActionInputCount(envelope.action);
 			s.pending = envelope;
-			s.diagnostics.propose(envelope.actionId, envelope.action.kind);
+			s.diagnostics.propose(envelope.actionId, envelope.action.kind, computerActionInputCount(envelope.action));
 		}
 		let reply = await this.send(s, {
 			op: "act",
@@ -849,6 +902,21 @@ var ComputerRuntime = class {
 			owner: s.owner,
 			envelope
 		}, signal);
+		if (reply.value.status === "pending_action") {
+			reply.frame?.fill(0);
+			const settled = await this.send(s, {
+				op: "settle",
+				sessionId: s.id,
+				owner: s.owner
+			}, signal);
+			if (settled.value.status !== "pending_action" || settled.value.errorCode) reply = settled;
+			else reply = await this.send(s, {
+				op: "act",
+				sessionId: s.id,
+				owner: s.owner,
+				envelope
+			}, signal);
+		}
 		if (reply.value.receipt && reply.value.receipt.actionId !== envelope.actionId) {
 			reply.frame?.fill(0);
 			throw new Error("COMPUTER_RECEIPT_MISMATCH");
@@ -905,7 +973,7 @@ var ComputerRuntime = class {
 		} else reply.frame?.fill(0);
 		if (reply.value.status === "ready" && reply.value.errorCode === "COMPUTER_OBSERVATION_CHANGED" && !reply.value.receipt) {
 			s.diagnostics.discard();
-			s.actions--;
+			s.actions -= computerActionInputCount(envelope.action);
 			s.pendingContext = void 0;
 			return {
 				...this.present(reply.value),

package/dist/src/computer/semantic-actions.js

@@ -1,6 +1,10 @@
 //#region src/computer/semantic-actions.ts
 /** Ground only an unambiguous single click; never reinterpret double clicks or text entry. */
 function groundComputerAction(action, observation) {
+	if (action.kind === "batch") return {
+		...action,
+		actions: action.actions.map((input) => groundComputerAction(input, observation))
+	};
 	if (action.kind !== "click" || action.count !== 1 || action.point.x < 0 || action.point.y < 0 || action.point.x >= observation.imageWidth || action.point.y >= observation.imageHeight) return action;
 	const kind = action.button === "left" ? "activate" : "showMenu";
 	try {

package/dist/src/config/index.js

@@ -9,16 +9,16 @@ import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema
 import { extractProfileAgentId, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 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, normalizeConfiguredMcpServers } from "./mcp-config-normalize.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";
-import { loadConfig, saveConfig } from "./loader.js";
+import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { canonicalizeConfiguredMcpServer, normalizeConfiguredMcpServers } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
+import { loadConfig, saveConfig } from "./loader.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";
-import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 //#region src/config/index.ts
 init_schema();
 init_paths();

package/dist/src/config/loader.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveConfigPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { init_paths, resolveConfigPath } from "./paths.js";
 import { ConfigSchema, init_schema } from "./schema.js";
 import { init_resolution, setActivePlatformDiscovery } from "../platform/resolution.js";
 import { assertChannelPluginConfigs } from "./validate-channel-configs.js";

package/dist/src/config/models-json.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
+import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { PhoneModelMetadataSchema, init_contracts } from "../phone/contracts.js";
 import { init_model_policy, phoneModelProfile } from "../phone/model-policy.js";
 import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";

package/dist/src/config/schema.d.ts

@@ -1787,6 +1787,12 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
             direct: "direct";
         }>>;
         adbPath: z.ZodOptional<z.ZodString>;
+        hdcPath: z.ZodOptional<z.ZodString>;
+        hdcVideo: z.ZodOptional<z.ZodObject<{
+            sdkJar: z.ZodOptional<z.ZodString>;
+            devecoPath: z.ZodOptional<z.ZodString>;
+            javaHome: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
         autoGlmPrompt: z.ZodDefault<z.ZodEnum<{
             current: "current";
             upstream: "upstream";

package/dist/src/connectors/cli/authorization.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getConnectorAccount, init_connector_account_repository } from "../../storage/sqlite/connector-account-repository.js";
 import { getConnectorConnection, getConnectorInstallation, init_connector_repository, upsertConnectorInstallation } from "../../storage/sqlite/connector-repository.js";
+import { cliContextPath, startCliProcess } from "./process.js";
 import { getCliAdapter } from "./adapterRegistry.js";
 import { getConnectorInstance, getInstalledConnectorDefinition } from "../instances.js";
-import { cliContextPath, startCliProcess } from "./process.js";
 import { installCli } from "./installer.js";
 import { cliAuthorizationView, commitCliIdentity, createCliAuthorization, readCliAuthorization, updateCliAuthorization } from "./store.js";
 import { join, relative } from "node:path";

package/dist/src/connectors/composio-sessions.js

@@ -3,8 +3,8 @@ import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { getConnectorAccount, init_connector_account_repository, reconcileConnectorAccount } from "../storage/sqlite/connector-account-repository.js";
 import { appendConnectorExecutionAudit, getConnectorConnection, getConnectorInstallation, init_connector_repository, listConnectorConnections, upsertConnectorConnection } from "../storage/sqlite/connector-repository.js";
-import { canAccessConnectorAccount } from "./account-access.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { canAccessConnectorAccount } from "./account-access.js";
 import { ensureComposioBackend, getComposioBackend, listComposioBackends, resolveBackendKey } from "./composio-backends.js";
 import { saveAuthorizationAttempt } from "./authorization-attempts.js";
 import { connectorIdentityKey, mergeConnectorIdentity } from "./connector-identity.js";

package/dist/src/connectors/composio.js

@@ -1,7 +1,7 @@
 import { getConnectorAccount, init_connector_account_repository, refreshConnectorAccountCurrent, updateConnectorAccount } from "../storage/sqlite/connector-account-repository.js";
 import { getConnectorConnection, getConnectorInstallation, init_connector_repository, listConnectorConnections, upsertConnectorActionMetadata, upsertConnectorConnection, upsertConnectorInstallation } from "../storage/sqlite/connector-repository.js";
-import { canAccessConnectorAccount, currentAccountConnections } from "./account-access.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { canAccessConnectorAccount, currentAccountConnections } from "./account-access.js";
 import { activateComposioBackend, addComposioBackend, ensureComposioBackend, getComposioBackend, listComposioBackends, markComposioBackendVerified, resolveBackendKey } from "./composio-backends.js";
 import { connectorIdentityKey } from "./connector-identity.js";
 import { ComposioSessionsAdapter, assertComposioAccessConfigured } from "./composio-sessions.js";

package/dist/src/connectors/connected-source-ingestion.js

@@ -2,9 +2,10 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { getConnectorInstallation, listConnectorConnections } from "../storage/sqlite/connector-repository.js";
 import "../storage/sqlite/index.js";
-import { canAccessConnectorAccount, currentAccountConnections } from "./account-access.js";
 import { getActiveUnderstandingConsent, grantUnderstandingConsent } from "../user-context/sources/consent-repository.js";
+import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { canAccessConnectorAccount, currentAccountConnections } from "./account-access.js";
 import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { decodeConnectedSourceCursor, encodeConnectedSourceCursor } from "./connected-source-cursor.js";
 import { scopeForComposioAction } from "./composio.js";
@@ -12,7 +13,6 @@ import { getConnectorDefinition } from "./catalog.js";
 import { getConnectorInstance } from "./instances.js";
 import { listUnderstandingSourceGrants, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
 import { KnowledgeIngestionService } from "../knowledge/ingestion-service.js";
-import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
 import { LocalFolderKnowledgeSourceAdapter } from "../knowledge/local-folder-adapter.js";
 import "../knowledge/index.js";
 import { normalizeConnectedSourceResult } from "./connected-source-normalizers.js";

package/dist/src/connectors/connected-source-understanding.js

@@ -4,15 +4,15 @@ import { finishContextExtractionRun } from "../storage/sqlite/context-extraction
 import { createContextEvidence } from "../storage/sqlite/context-evidence-repository.js";
 import { getKnowledgeSourceItem } from "../storage/sqlite/knowledge-repository.js";
 import "../storage/sqlite/index.js";
-import { reconcileAssertion } from "../user-model/repository.js";
 import { getActiveUnderstandingConsent } from "../user-context/sources/consent-repository.js";
-import "../user-model/index.js";
-import { getUnderstandingSourceRun } from "../user-context/sources/repository.js";
-import { consentFilteredText } from "../user-context/sources/consent-fields.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
-import { recordConnectedSourceObservations } from "./connected-source-observations.js";
+import { consentFilteredText } from "../user-context/sources/consent-fields.js";
 import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
+import { reconcileAssertion } from "../user-model/repository.js";
+import "../user-model/index.js";
+import { getUnderstandingSourceRun } from "../user-context/sources/repository.js";
+import { recordConnectedSourceObservations } from "./connected-source-observations.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources } from "../work-discovery/analyzer.js";
 import { createHash } from "node:crypto";

package/dist/src/connectors/connection-recovery-service.js

@@ -15,13 +15,13 @@ import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { getConfiguredComposioAuthConfigs, isComposioActionAllowedByCatalog, scopeForComposioAction } from "./composio.js";
 import { getConnectorDefinition } from "./catalog.js";
 import { getInstalledConnectorDefinition, listConnectorInstances } from "./instances.js";
+import { describeCliAction, verifyCliConnection } from "./cli/runtime.js";
+import { capabilityActions, isToolInputSchema, missingConnectionCapabilities } from "./connection-capabilities.js";
 import { installConnector } from "./install.js";
-import { persistConfigMutation } from "../config/config-mutation.js";
 import { resolveConnectionCandidate } from "./connection-candidates.js";
-import { capabilityActions, isToolInputSchema, missingConnectionCapabilities } from "./connection-capabilities.js";
-import { describeCliAction, verifyCliConnection } from "./cli/runtime.js";
-import { drainPersonalRequestContinuations, drainPersonalRequestResults } from "../personal-agent/request-delivery.js";
 import { cancelPersonalRequest, resolvePersonalRequestConnection } from "../personal-agent/request-service.js";
+import { persistConfigMutation } from "../config/config-mutation.js";
+import { drainPersonalRequestContinuations, drainPersonalRequestResults } from "../personal-agent/request-delivery.js";
 import { randomUUID } from "node:crypto";
 //#region src/connectors/connection-recovery-service.ts
 init_transaction();

package/dist/src/connectors/content-enrichment.js

@@ -1,8 +1,8 @@
 import { getConnectorConnection, getConnectorInstallation } from "../storage/sqlite/connector-repository.js";
 import { getKnowledgeSourceItem, listKnowledgeSourceItems, upsertKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
 import "../storage/sqlite/index.js";
-import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
+import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { sanitizeConnectedSourceValue } from "./connected-source-sanitization.js";
 import { tmpdir } from "node:os";
 import { isAbsolute, join, relative, sep } from "node:path";

package/dist/src/connectors/health.js

@@ -1,6 +1,6 @@
 import { init_connector_repository, listConnectorConnections } from "../storage/sqlite/connector-repository.js";
-import { currentAccountConnections } from "./account-access.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { currentAccountConnections } from "./account-access.js";
 import { getConnectorInstance } from "./instances.js";
 import { describeCliAction, verifyCliConnection } from "./cli/runtime.js";
 //#region src/connectors/health.ts

package/dist/src/connectors/instances.js

@@ -1,5 +1,5 @@
-import { connectorDefinitionFromManagedMarker, isManagedConnectorServer } from "./materialize.js";
 import { getConnectorDefinition } from "./catalog.js";
+import { connectorDefinitionFromManagedMarker, isManagedConnectorServer } from "./materialize.js";
 import { getConnectorAuditFromMarker, getConnectorUsageFromMarker } from "./usage.js";
 //#region src/connectors/instances.ts
 function readMarkerConfig(marker) {

package/dist/src/connectors/runtime-adapter-registry.js

@@ -1,10 +1,10 @@
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { deleteConnectorInstallation, getConnectorInstallation, upsertConnectorInstallation } from "../storage/sqlite/connector-repository.js";
 import "../storage/sqlite/index.js";
-import { saveConnectorSecrets } from "./secret-store.js";
-import { isManagedConnectorServer, materializeConnectorMcpServer } from "./materialize.js";
 import { getCliAdapter } from "./cli/adapterRegistry.js";
 import { assertComposioAccessConfigured } from "./composio-sessions.js";
+import { saveConnectorSecrets } from "./secret-store.js";
+import { isManagedConnectorServer, materializeConnectorMcpServer } from "./materialize.js";
 import { appendConnectorAuditRecord } from "./usage.js";
 import { listConnectorInstances } from "./instances.js";
 import { installCli } from "./cli/installer.js";

package/dist/src/discussions/live-worker.js

@@ -2,8 +2,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { ObjectLinkService } from "../activity/service.js";
 import { init_model_usage, withModelUsageOrigin } from "../providers/model-usage.js";
-import { isSTTAvailable } from "../voice/stt/availability.js";
 import { transcribe } from "../voice/stt/transcribe-core.js";
+import { isSTTAvailable } from "../voice/stt/availability.js";
 import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
 import "../voice/stt/index.js";
 import { claimNextDiscussionTranscriptSegment, completeDiscussionTranscriptSegment, getDiscussionCapture, listDiscussionTranscriptSegments, retryOrFailDiscussionTranscriptSegment, updateDiscussionCapture } from "./repository.js";

package/dist/src/discussions/sealer.js

@@ -4,8 +4,8 @@ import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/t
 import { DISCUSSION_MAX_SAVED_DURATION_MS } from "../../packages/gateway-contract/src/discussions.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { init_model_usage, withModelUsageOrigin } from "../providers/model-usage.js";
-import { isSTTAvailable } from "../voice/stt/availability.js";
 import { transcribe } from "../voice/stt/transcribe-core.js";
+import { isSTTAvailable } from "../voice/stt/availability.js";
 import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
 import "../voice/stt/index.js";
 import { listDiscussionTranscriptSegments, updateDiscussionCapture } from "./repository.js";

package/dist/src/endpoint-tools/index.js

@@ -1,6 +1,6 @@
-import { EndpointBindingService } from "./binding-service.js";
 import { EndpointToolPolicy, EndpointToolPolicyError } from "./policy.js";
 import { EndpointInvocationService, EndpointToolExecutionError } from "./invocation-service.js";
+import { EndpointBindingService } from "./binding-service.js";
 import { EndpointRegistry, endpointToolRevision } from "./registry.js";
 import { ENDPOINT_UPLOAD_MAX_BYTES, EndpointUploadError, EndpointUploadService } from "./upload-service.js";
 import { EndpointToolRuntime } from "./runtime.js";

package/dist/src/endpoint-tools/runtime.js

@@ -7,13 +7,13 @@ import { bindEndpointPrincipal, getEndpointPrincipal, touchEndpointPrincipal } f
 import { finishEndpointToolInvocationAudit, startEndpointToolInvocationAudit } from "../storage/sqlite/endpoint-tool-invocation-repository.js";
 import "../storage/sqlite/index.js";
 import { init_paths } from "../config/paths.js";
+import { EndpointToolPolicy } from "./policy.js";
+import { EndpointInvocationService } from "./invocation-service.js";
 import { EndpointAuthenticator } from "./auth.js";
 import { EndpointBindingService } from "./binding-service.js";
 import { EndpointContextStore } from "./context-store.js";
 import { DeviceGrantService } from "./grant-service.js";
 import { recordDeviceGrantEvent } from "../storage/sqlite/device-grant-audit-repository.js";
-import { EndpointToolPolicy } from "./policy.js";
-import { EndpointInvocationService } from "./invocation-service.js";
 import { EndpointRegistry } from "./registry.js";
 import { EndpointUploadService } from "./upload-service.js";
 import { LocationSharingService } from "./location-sharing.js";

package/dist/src/extensions/activation-context.js

@@ -1,12 +1,12 @@
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { PROVIDER_ENV_MAP, init_env_keys } from "../providers/env-keys.js";
 import { init_providers, isProviderConfiguredSync } from "../providers/index.js";
-import { collectTtsProviderConfigEntries } from "../voice/tts/config-slice.js";
-import { isProviderConfigured } from "../voice/tts/factory.js";
-import { mergeTtsConfigFromAppConfig } from "../voice/tts/merge-config.js";
 import { collectSttProviderConfigEntries } from "../voice/stt/config-slice.js";
 import { mergeSttConfigFromAppConfig } from "../voice/stt/config.js";
 import "../voice/stt/index.js";
+import { collectTtsProviderConfigEntries } from "../voice/tts/config-slice.js";
+import { isProviderConfigured } from "../voice/tts/factory.js";
+import { mergeTtsConfigFromAppConfig } from "../voice/tts/merge-config.js";
 import { isSttProviderConfigured } from "../voice/stt/list-providers.js";
 //#region src/extensions/activation-context.ts
 init_providers();

package/dist/src/extensions/agent-plugins/auth.js

@@ -1,8 +1,8 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { init_write_file_atomic, writeTextAtomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import { isDangerousHostEnvVarName } from "../../infra/host-env-security.js";
 import { pluginName } from "./validation.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { isDangerousHostEnvVarName } from "../../infra/host-env-security.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/src/extensions/agent-plugins/formats.js

@@ -67,7 +67,8 @@ function readPluginLayout(root, read, safe, importManifest) {
 	};
 	const defaults = has("skills") ? guarded("skills", () => [safe(join(root, "skills"))], []) : [];
 	const declared = paths(overlay.skills, "skills");
-	const skillRoots = [...new Set(dialect === "portable" ? defaults : dialect === "claude" ? [...defaults, ...declared] : overlay.skills === void 0 ? defaults : declared)];
+	const catalogSelection = !path && importManifest?.skills !== void 0;
+	const skillRoots = [...new Set(catalogSelection ? declared : dialect === "portable" ? defaults : dialect === "claude" ? [...defaults, ...declared] : overlay.skills === void 0 ? defaults : declared)];
 	const mcpConfigs = [];
 	if (dialect === "portable" && has("mcp.json")) {
 		const config = guarded("mcp", () => json("mcp.json"), void 0);

package/dist/src/extensions/agent-plugins/inventory.d.ts

@@ -3,6 +3,7 @@ export declare function agentPluginInventoryRow(plugin: InstalledAgentPlugin, st
     components: {
         skills: {
             name: string;
+            description: string;
         }[];
         mcp: {
             connectionAuth?: {
@@ -117,6 +118,7 @@ export declare function listAgentPluginInventory(): {
     components: {
         skills: {
             name: string;
+            description: string;
         }[];
         mcp: {
             connectionAuth?: {

package/dist/src/extensions/agent-plugins/inventory.js

@@ -37,7 +37,10 @@ function agentPluginInventoryRow(plugin, store = new AgentPluginStore()) {
 		canRollback: !!plugin.receipt.previous,
 		...plugin.receipt.provenance ? { provenance: plugin.receipt.provenance } : {},
 		components: {
-			skills: plugin.skills.map((skill) => ({ name: skill.name })),
+			skills: plugin.skills.map((skill) => ({
+				name: skill.name,
+				description: skill.description
+			})),
 			mcp: Object.entries(plugin.servers).map(([name, server]) => ({
 				name,
 				id: pluginServerId(plugin.id, name),

package/dist/src/extensions/agent-plugins/skill-catalog.js

@@ -1,9 +1,9 @@
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { createSkillConfigManager } from "../../agent/skills/config.js";
-import { parseSkillLocalizations } from "../../agent/skills/parse-skill-metadata.js";
 import { containedPath } from "./contained-path.js";
 import "./validation.js";
 import { AgentPluginStore } from "./store.js";
+import { createSkillConfigManager } from "../../agent/skills/config.js";
+import { parseSkillLocalizations } from "../../agent/skills/parse-skill-metadata.js";
 import { buildSkillMarkdownPreviewFromRaw } from "../../agent/skills/skill-markdown-preview-from-raw.js";
 import { agentPluginInventoryRow } from "./inventory.js";
 import { basename, dirname } from "node:path";

package/dist/src/extensions/agent-plugins/source-http-fetch.js

@@ -1,6 +1,6 @@
-import { Agent, fetch } from "undici";
 import { BlockList, isIP } from "node:net";
 import { lookup } from "node:dns";
+import { Agent, fetch } from "undici";
 //#region src/extensions/agent-plugins/source-http-fetch.ts
 const blocked = new BlockList();
 for (const [network, prefix] of [