@xopcai/xopc 0.0.278 → 0.0.282

package/dist/src/gateway/server.js

@@ -1,5 +1,5 @@
-import { ensureXopcCliOnPath } from "../infra/path-env.js";
 import { resolveGatewayBindHost, resolveGatewayListenHosts } from "../config/gateway-bind.js";
+import { ensureXopcCliOnPath } from "../infra/path-env.js";
 import { resolveGatewayListenPlan } from "./listen.js";
 import { GatewayService } from "./service.js";
 import { handleSiteShareUpgrade } from "../share/site-share-router.js";

package/dist/src/gateway/service/agent-runner.js

@@ -85,9 +85,9 @@ var GatewayAgentRunner = class {
 						sourceId
 					});
 				}
-				if (unique.size > MAX_TURN_CONTEXTS) throw new Error(`A message can reference at most ${MAX_TURN_CONTEXTS} notes`);
+				if (unique.size > MAX_TURN_CONTEXTS) throw new Error(`A message can reference at most ${MAX_TURN_CONTEXTS} sources`);
 				const contexts = await Promise.all([...unique.values()].map((ref) => opts.resolveTurnContext(ref)));
-				if (contexts.some((context) => context === null)) throw new Error("A referenced note is no longer available");
+				if (contexts.some((context) => context === null)) throw new Error("A referenced source is unavailable or has changed; select it again");
 				return fitSourceContextsToBudget(contexts.filter((context) => context !== null));
 			},
 			steer: (sessionKey, content) => opts.getAgentService().turnDispatcher.steerWebchatSession(sessionKey, content),

package/dist/src/gateway/service/config-coordinator.js

@@ -3,12 +3,12 @@ import { init_logger } from "../../utils/logger.js";
 import { getModelRegistry } from "../../providers/model-registry.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { init_providers } from "../../providers/index.js";
-import { ConfigHotReloader } from "../../config/reload.js";
-import "../../config/index.js";
 import { disposeAllSessionMcpRuntimes } from "../../agent/mcp/bundle-mcp-runtime.js";
-import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
 import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";
 import "../../agent/mcp/bundle-mcp-tools.js";
+import { ConfigHotReloader } from "../../config/reload.js";
+import "../../config/index.js";
+import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
 import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
 //#region src/gateway/service/config-coordinator.ts
 init_providers();

package/dist/src/gateway/service/marketplace-service.js

@@ -2,12 +2,12 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
-import { removeSkillsLockEntry } from "../../agent/skills/hub-lock.js";
-import { deleteManagedSkill, installSkillFromZip, listManagedSkillDirs } from "../../agent/skills/managed-store.js";
-import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
 import { createSkillConfigManager } from "../../agent/skills/config.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../../agent/skills/workspace-skills-dir.js";
+import { removeSkillsLockEntry } from "../../agent/skills/hub-lock.js";
+import { deleteManagedSkill, installSkillFromZip, listManagedSkillDirs } from "../../agent/skills/managed-store.js";
 import { normalizeSkillInstallTarget } from "../../agent/skills/install-target.js";
+import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
 import { existsSync, rmSync } from "node:fs";
 //#region src/gateway/service/marketplace-service.ts
 /**

package/dist/src/gateway/service/run-gateway-agent.js

@@ -6,11 +6,11 @@ import { updateInteractionStateFromMessage } from "../../storage/sqlite/interact
 import { getConnectionResumeInput, isConnectionSuspended } from "../../storage/sqlite/connection-wait-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
-import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
-import "../chat-limits.js";
-import { formatAgentRunErrorForClient } from "../../agent/client-error-format.js";
 import { resolveExecutionContext } from "../../tasks/execution-context.js";
 import { TaskRunCoordinator } from "../../tasks/task-run-coordinator.js";
+import { formatAgentRunErrorForClient } from "../../agent/client-error-format.js";
+import "../chat-limits.js";
+import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
 import { ChatStreamMapper } from "../chat-stream/mapper.js";
 import { resolveWebchatSessionKey } from "../resolve-webchat-session-key.js";
 import { recordExplicitRelationshipFollowUp } from "../../user-context/relationship-continuity.js";

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

@@ -1,3 +1,4 @@
+import { WorkDiscoveryService } from '../work-discovery/service.js';
 import { ConnectionRecoveryService } from '../connectors/connection-recovery-service.js';
 import { AgentService } from '../agent/service.js';
 import { MessageBus } from '../infra/bus/index.js';
@@ -98,6 +99,8 @@ export declare class GatewayService {
     readonly marketplace: GatewayMarketplaceService;
     /** First-class project grouping surface. */
     readonly projects: ProjectService;
+    private _workDiscovery;
+    get workDiscovery(): WorkDiscoveryService;
     readonly discussions: DiscussionService;
     readonly discussionWorker: DiscussionOrganizerWorker;
     readonly discussionLiveWorker: DiscussionLiveWorker;

package/dist/src/gateway/service.js

@@ -24,18 +24,38 @@ import { init_providers, providers_exports } from "../providers/index.js";
 import { AutomationService } from "../automations/service/automation-service.js";
 import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
 import "../automations/index.js";
-import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
-import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
-import { ChannelManager } from "../channels/manager.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { TaskRepository } from "../tasks/task-repository.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
+import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
+import { ProjectService } from "../projects/project-service.js";
+import { resolveProjectAgentId } from "../projects/project-agent.js";
+import "../projects/index.js";
+import { resolveEffectiveGatewayPort } from "./host.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { ProactiveScenarioService } from "../proactive/scenarios/service.js";
+import { ProactiveEventService } from "../proactive/service.js";
+import { TaskApplicationService } from "../tasks/task-application-service.js";
+import { ProactiveInboxService } from "../proactive/inbox/service.js";
+import { TaskOutboxDispatcher } from "../tasks/task-outbox-dispatcher.js";
+import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
+import { TaskSignalService } from "../tasks/task-signal-service.js";
+import "../tasks/index.js";
+import "../agent/mcp/bundle-mcp-tools.js";
+import { SessionIndex } from "../session/manager.js";
+import "../session/index.js";
+import { ExtensionLoader } from "../extensions/loader.js";
+import "../extensions/index.js";
 import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
+import { AgentService } from "../agent/service.js";
+import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";
+import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
+import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
+import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { ExtensionLoader } from "../extensions/loader.js";
-import "../extensions/index.js";
-import { resolveEffectiveGatewayPort } from "./host.js";
-import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -51,33 +71,15 @@ import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { ProjectService } from "../projects/project-service.js";
-import { resolveProjectAgentId } from "../projects/project-agent.js";
-import "../projects/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
-import { TaskRepository } from "../tasks/task-repository.js";
-import { TaskApplicationService } from "../tasks/task-application-service.js";
-import { ProactiveScenarioService } from "../proactive/scenarios/service.js";
-import { ProactiveInboxService } from "../proactive/inbox/service.js";
+import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
 import { deliverProactiveCard } from "../proactive/inbox/delivery.js";
+import { WorkDiscoveryService } from "../work-discovery/service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
 import { voiceMemoryBudget, voicePersonaBudget } from "../voice/realtime/conversation-context.js";
-import { SessionIndex } from "../session/manager.js";
-import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
-import "../session/index.js";
-import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
-import { ProactiveEventService } from "../proactive/service.js";
-import { TaskOutboxDispatcher } from "../tasks/task-outbox-dispatcher.js";
-import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
-import { TaskSignalService } from "../tasks/task-signal-service.js";
-import "../tasks/index.js";
-import "../agent/mcp/bundle-mcp-tools.js";
-import { AgentService } from "../agent/service.js";
-import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";
 import { NotesStore } from "../notes/store.js";
 import { buildNoteAgentContext } from "../notes/agent-context.js";
 import { NotesService } from "../notes/service.js";
@@ -305,6 +307,15 @@ var GatewayService = class {
 	marketplace;
 	/** First-class project grouping surface. */
 	projects;
+	_workDiscovery;
+	get workDiscovery() {
+		return this._workDiscovery ??= new WorkDiscoveryService({
+			projects: this.projects,
+			sessions: this.sessionIndex,
+			getConfig: () => this.config,
+			emit: (type, payload) => this.emit(type, payload)
+		});
+	}
 	discussions;
 	discussionWorker;
 	discussionLiveWorker;
@@ -440,6 +451,7 @@ var GatewayService = class {
 			}
 		});
 		this.discussionSealer = new DiscussionSealer({
+			processRecordingJob: () => this.discussions.processRecordingJob(),
 			notes: this.notesService,
 			getConfig: () => this.config,
 			onUpdated: emitDiscussion
@@ -460,6 +472,7 @@ var GatewayService = class {
 			getChannelManager: () => this.channelManager,
 			getConfig: () => this.config,
 			resolveTurnContext: async (ref) => {
+				if (ref.kind === "task") return buildTaskAgentContext(new TaskRepository().get(ref.sourceId), ref.expectedVersion);
 				if (ref.kind !== "note") return null;
 				const note = await this.notesService.getNote(ref.sourceId);
 				if (!note || note.status === "trashed") return null;
@@ -918,6 +931,7 @@ var GatewayService = class {
 			}, `Model registry prewarm failed: ${em}`);
 		}
 		this.modelCatalogSync.start();
+		if (this.running) this.workDiscovery.resumeProjectUnderstanding();
 		if (!this.extensionLoader || areExtensionsGloballyDisabled(this.config)) return;
 		try {
 			if (trace) await trace.measure("extensions.deferred-load", () => this.loadDeferredExtensions());
@@ -1226,6 +1240,7 @@ var GatewayService = class {
 		this.stopRealtimeLogBridge?.();
 		this.stopRealtimeLogBridge = null;
 		log.debug("Stopping gateway service...");
+		await this._workDiscovery?.stop();
 		this.readiness.markStarting();
 		this.endpointTools.close();
 		await this.sideChats.disposeAll();

package/dist/src/gateway/session-context-summary.js

@@ -4,13 +4,13 @@ import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
 import { hasGatewayScope } from "./security/gateway-scopes.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
+import { TaskRepository } from "../tasks/task-repository.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { ProjectStore } from "../projects/project-store.js";
 import { runExec } from "../infra/exec.js";
-import { TaskRepository } from "../tasks/task-repository.js";
 import { isSessionSourceBinding } from "../agent/source-context/types.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { realpath, stat } from "node:fs/promises";
 //#region src/gateway/session-context-summary.ts
 init_logger();

package/dist/src/gateway/workspace-editor-path.js

@@ -1,5 +1,5 @@
 import path, { relative, resolve } from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region src/gateway/workspace-editor-path.ts
 /** Resolve a workspace-relative POSIX path safely (no `..`, stays under root). */
 function resolveWorkspaceSafePath(workspaceRoot, rel) {
@@ -20,7 +20,7 @@ function isPathUnderWorkspace(workspaceRoot, absPath) {
 function normalizeComparablePath(input) {
 	let resolved = resolve(input);
 	try {
-		resolved = fsSync.realpathSync.native(resolved);
+		resolved = fs.realpathSync.native(resolved);
 	} catch {}
 	return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/infra/gateway-processes.js

@@ -1,11 +1,11 @@
 import { listPortListeners } from "../gateway/ports.js";
 import { isGatewayArgv, parseProcCmdline } from "./gateway-process-argv.js";
-import fsSync from "node:fs";
+import fs from "node:fs";
 import { spawnSync } from "node:child_process";
 //#region src/infra/gateway-processes.ts
 function readGatewayProcessArgsSync(pid) {
 	if (process.platform === "linux") try {
-		return parseProcCmdline(fsSync.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
+		return parseProcCmdline(fs.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
 	} catch {
 		return null;
 	}

package/dist/src/infra/path-env.js

@@ -1,7 +1,7 @@
 import { resolveBrewPathDirs } from "./brew.js";
 import os from "node:os";
 import path from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region src/infra/path-env.ts
 function isTruthyEnvValue(value) {
 	if (!value) return false;
@@ -10,7 +10,7 @@ function isTruthyEnvValue(value) {
 }
 function isExecutable(filePath) {
 	try {
-		fsSync.accessSync(filePath, fsSync.constants.X_OK);
+		fs.accessSync(filePath, fs.constants.X_OK);
 		return true;
 	} catch {
 		return false;
@@ -18,7 +18,7 @@ function isExecutable(filePath) {
 }
 function isDirectory(dirPath) {
 	try {
-		return fsSync.statSync(dirPath).isDirectory();
+		return fs.statSync(dirPath).isDirectory();
 	} catch {
 		return false;
 	}

package/dist/src/infra/update-global.js

@@ -1,10 +1,10 @@
-import { resolveExecPathBinPrepend } from "./path-env.js";
 import { applyPathPrepend } from "./path-prepend.js";
+import { resolveExecPathBinPrepend } from "./path-env.js";
 import { readPackageVersion } from "./package-json.js";
 import { createDefaultCommandRunner } from "./run-command.js";
 import path from "node:path";
-import fsSync from "node:fs";
-import fs from "node:fs/promises";
+import fs from "node:fs";
+import fs$1 from "node:fs/promises";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
 const GLOBAL_RENAME_PREFIX = ".";
@@ -18,7 +18,7 @@ const NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = ["--omit=optional", ...NPM_GLOBAL
 const GLOBAL_DETECT_TIMEOUT_MS = 15e3;
 async function pathExists(targetPath) {
 	try {
-		await fs.access(targetPath);
+		await fs$1.access(targetPath);
 		return true;
 	} catch {
 		return false;
@@ -26,7 +26,7 @@ async function pathExists(targetPath) {
 }
 async function tryRealpath(targetPath) {
 	try {
-		return await fs.realpath(targetPath);
+		return await fs$1.realpath(targetPath);
 	} catch {
 		return path.resolve(targetPath);
 	}
@@ -49,14 +49,14 @@ function resolvePreferredNpmCommand(pkgRoot) {
 	const prefix = inferNpmPrefixFromPackageRoot(pkgRoot);
 	if (!prefix) return null;
 	const candidate = process.platform === "win32" ? path.join(prefix, "npm.cmd") : path.join(prefix, "bin", "npm");
-	return fsSync.existsSync(candidate) ? candidate : null;
+	return fs.existsSync(candidate) ? candidate : null;
 }
 function resolveNpmFromExecPath() {
 	const execPath = process.execPath?.trim();
 	if (!execPath) return null;
 	const binDir = path.dirname(execPath);
 	const candidate = process.platform === "win32" ? path.join(binDir, "npm.cmd") : path.join(binDir, "npm");
-	return fsSync.existsSync(candidate) ? candidate : null;
+	return fs.existsSync(candidate) ? candidate : null;
 }
 function resolvePreferredGlobalManagerCommand(manager, pkgRoot) {
 	if (manager !== "npm") return manager;
@@ -204,7 +204,7 @@ async function cleanupGlobalRenameDirs(params) {
 	const prefix = `${GLOBAL_RENAME_PREFIX}${name}-`;
 	let entries = [];
 	try {
-		entries = await fs.readdir(root);
+		entries = await fs$1.readdir(root);
 	} catch {
 		return { removed };
 	}
@@ -212,8 +212,8 @@ async function cleanupGlobalRenameDirs(params) {
 		if (!entry.startsWith(prefix)) continue;
 		const target = path.join(root, entry);
 		try {
-			if (!(await fs.lstat(target)).isDirectory()) continue;
-			await fs.rm(target, {
+			if (!(await fs$1.lstat(target)).isDirectory()) continue;
+			await fs$1.rm(target, {
 				recursive: true,
 				force: true
 			});

package/dist/src/knowledge-memory/repository.d.ts

@@ -30,6 +30,8 @@ export declare function writeKnowledgeItem(input: WriteKnowledgeInput): {
 export declare function getKnowledgeItem(id: string): KnowledgeItem | undefined;
 export declare function listKnowledgeItems(input?: {
     principalId?: string;
+    scope?: UserModelScope;
+    canonicalKey?: string;
     statuses?: KnowledgeStatus[];
     recordClass?: KnowledgeRecordClass;
     limit?: number;

package/dist/src/knowledge-memory/repository.js

@@ -106,7 +106,9 @@ function listKnowledgeItems(input = {}) {
 	return getSqliteDatabase().prepare(`SELECT * FROM knowledge_items
     WHERE principal_id = ? AND status IN (${placeholders})
       ${input.recordClass ? "AND record_class = ?" : ""}
-    ORDER BY importance DESC, updated_at DESC LIMIT ?`).all(input.principalId ?? "local-owner", ...statuses, ...input.recordClass ? [input.recordClass] : [], Math.max(1, Math.min(2e3, input.limit ?? 200))).map(fromRow);
+      ${input.scope ? "AND scope_type = ? AND COALESCE(scope_id, '') = COALESCE(?, '')" : ""}
+      ${input.canonicalKey ? "AND canonical_key = ?" : ""}
+    ORDER BY importance DESC, updated_at DESC LIMIT ?`).all(input.principalId ?? "local-owner", ...statuses, ...input.recordClass ? [input.recordClass] : [], ...input.scope ? [input.scope.type, input.scope.id ?? null] : [], ...input.canonicalKey ? [input.canonicalKey] : [], Math.max(1, Math.min(2e3, input.limit ?? 200))).map(fromRow);
 }
 function setKnowledgeStatus(id, status, now = Date.now()) {
 	return getSqliteDatabase().prepare(`UPDATE knowledge_items SET status = ?, updated_at = ?

package/dist/src/local-apps/service.js

@@ -2,8 +2,8 @@ import { resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
-import { slugifyProjectName } from "../projects/project-store.js";
 import { LocalAppStore } from "./store.js";
+import { slugifyProjectName } from "../projects/project-store.js";
 import { readLocalAppAcceptanceConfig } from "./acceptance.js";
 import { LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE, legacyLocalAppRuntimeSource } from "./runtime-entry.js";
 import { readLocalAppPermissions, scaffoldLocalApp } from "./scaffold.js";

package/dist/src/media-shared/http/ssrf-guard.js

@@ -1,6 +1,6 @@
 import { isIP } from "node:net";
-import { lookup } from "node:dns";
 import { promisify } from "node:util";
+import { lookup } from "node:dns";
 //#region src/media-shared/http/ssrf-guard.ts
 /**
 * SSRF guard for voice / media-understanding HTTP calls.

package/dist/src/media-understanding/audio-transcription-runner.d.ts

@@ -43,6 +43,7 @@ export interface RunAudioTranscriptionResult {
         model?: string;
         language?: string;
         durationSeconds?: number;
+        segments?: import('./types.js').AudioTranscriptionSegment[];
     }>;
     decision: MediaUnderstandingDecision;
 }

package/dist/src/media-understanding/audio-transcription-runner.js

@@ -24,6 +24,7 @@ async function runAudioTranscription(options) {
 	const outputs = result.outputs.map((entry) => ({
 		attachmentIndex: entry.attachmentIndex,
 		text: entry.text,
+		...entry.segments ? { segments: entry.segments } : {},
 		provider: entry.provider,
 		...entry.model ? { model: entry.model } : {},
 		...entry.language ? { language: entry.language } : {},

package/dist/src/media-understanding/runner.js

@@ -118,6 +118,7 @@ async function runCapability(options) {
 					provider: provider.id,
 					model: callResult.model,
 					...callResult.language ? { language: callResult.language } : {},
+					...callResult.segments ? { segments: callResult.segments } : {},
 					...callResult.durationSeconds !== void 0 ? { durationSeconds: callResult.durationSeconds } : {}
 				});
 				break;

package/dist/src/media-understanding/types.d.ts

@@ -58,6 +58,7 @@ export interface CapabilityAttachmentInput {
     mime?: string;
 }
 export interface MediaUnderstandingOutput {
+    segments?: AudioTranscriptionSegment[];
     kind: MediaUnderstandingKind;
     attachmentIndex: number;
     text: string;
@@ -104,7 +105,14 @@ export interface AudioTranscriptionRequest {
     timeoutMs: number;
     signal?: AbortSignal;
 }
+export interface AudioTranscriptionSegment {
+    text: string;
+    startMs: number;
+    endMs: number;
+    speaker?: string;
+}
 export interface AudioTranscriptionResult {
+    segments?: AudioTranscriptionSegment[];
     text: string;
     model?: string;
     /** Provider-reported language (e.g. 'zh', 'en'). */

package/dist/src/notes/agent-context.js

@@ -1,12 +1,12 @@
 import { getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
-import { isSTTAvailable } from "../voice/stt/availability.js";
+import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
+import { describeImagesWithFallback } from "../agent/image/understanding/runtime.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 { extractDocumentText } from "../document-understanding/extract.js";
-import { resolveImageModelConfigForTool } from "../agent/image/tool-model-config.js";
-import { describeImagesWithFallback } from "../agent/image/understanding/runtime.js";
 import { extname } from "node:path";
 import { readFile } from "node:fs/promises";
 //#region src/notes/agent-context.ts

package/dist/src/notes/service.d.ts

@@ -49,7 +49,9 @@ export declare class NotesService {
     listProjectSummaries(): import("./types.js").NoteProjectSummary[];
     addAttachment(noteId: string, file: {
         name: string;
-        buffer: Buffer;
+        buffer: Buffer | {
+            filePath: string;
+        };
         mimeType: string;
         duration?: number;
         retainWithoutReference?: boolean;

package/dist/src/notes/store.d.ts

@@ -14,7 +14,9 @@ export declare class NotesStore {
         offset: number;
         hasMore: boolean;
     }>;
-    saveAttachment(noteId: string, fileName: string, buffer: Buffer): Promise<{
+    saveAttachment(noteId: string, fileName: string, buffer: Buffer | {
+        filePath: string;
+    }): Promise<{
         relativePath: string;
         size: number;
     }>;

package/dist/src/notes/store.js

@@ -9,7 +9,7 @@ import "../storage/sqlite/index.js";
 import { resolveNoteMediaDir } from "./paths.js";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import { mkdir, rm, writeFile } from "node:fs/promises";
+import { copyFile, mkdir, rm, stat, writeFile } from "node:fs/promises";
 //#region src/notes/store.ts
 init_logger();
 const log = createLogger("NotesStore");
@@ -61,10 +61,12 @@ var NotesStore = class {
 		const mediaDir = resolveNoteMediaDir(noteId);
 		await mkdir(mediaDir, { recursive: true });
 		const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
-		await writeFile(join(mediaDir, safeName), buffer);
+		const filePath = join(mediaDir, safeName);
+		if (Buffer.isBuffer(buffer)) await writeFile(filePath, buffer);
+		else await copyFile(buffer.filePath, filePath);
 		return {
 			relativePath: safeName,
-			size: buffer.length
+			size: (await stat(filePath)).size
 		};
 	}
 	resolveAttachmentPath(noteId, relativePath) {

package/dist/src/proactive/actions/service.js

@@ -1,6 +1,6 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
-import { effectiveProactivePolicy } from "../policy/service.js";
 import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
+import { effectiveProactivePolicy } from "../policy/service.js";
 import { insightCorrelation } from "../inbox/lifecycle.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 //#region src/proactive/actions/service.ts

package/dist/src/proactive/execution/agent-executor.js

@@ -3,8 +3,8 @@ import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../../agent/orchestration/llm-turn-retry.js";
 import { runAgentTurnWithTimeout } from "../../agent/orchestration/run-agent-turn-with-timeout.js";
-import { Type } from "@sinclair/typebox";
 import { Agent } from "@earendil-works/pi-agent-core";
+import { Type } from "@sinclair/typebox";
 //#region src/proactive/execution/agent-executor.ts
 init_sync_provider_auth();
 init_providers();

package/dist/src/proactive/execution/context.js

@@ -1,9 +1,9 @@
 import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
 import { getAssertionSlot, listUserAssertions } from "../../user-model/repository.js";
 import "../../user-model/index.js";
-import { getDiscussionCapture, getLatestDiscussionOrganization } from "../../discussions/repository.js";
 import { authorizedConnectedSource } from "./authorization.js";
 import { authorizedMailThread, requireMailFollowUp } from "../follow-ups.js";
+import { getDiscussionCapture, getLatestDiscussionOrganization } from "../../discussions/repository.js";
 import { wrapExternalContent } from "../../gateway/security/external-content.js";
 //#region src/proactive/execution/context.ts
 const MAX_EVENT_COUNT = 50;

package/dist/src/proactive/execution/worker.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
-import { effectiveProactivePolicy } from "../policy/service.js";
 import { authorizedConnectedSource } from "./authorization.js";
+import { effectiveProactivePolicy } from "../policy/service.js";
 import { getPromptRevision, getScenario } from "../scenarios/repository.js";
 import { composeScenarioPrompt } from "../scenarios/prompt-composer.js";
 import { markReadyBatches } from "../routing/batch-repository.js";