@xopcai/xopc 0.0.98 → 0.0.100

package/dist/src/gateway/ports.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import fs from "node:fs";
 import net from "node:net";
+import fs from "node:fs";
 import { execFileSync } from "node:child_process";
 //#region src/gateway/ports.ts
 /**

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

@@ -1,7 +1,7 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
 import { buildSessionKey, init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { AgentRunRelay } from "../agent-run-relay.js";
 import { ClarifyBridge } from "../clarify-bridge.js";
 import { runGatewayAgent } from "./run-gateway-agent.js";

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

@@ -1,6 +1,6 @@
+import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
 import { createSkillConfigManager } from "../../agent/skills/config.js";
 import { removeSkillsLockEntry } from "../../agent/skills/hub-lock.js";
@@ -11,8 +11,8 @@ import { installExtensionFromStoreZip, peekExtensionIdFromStoreZip } from "../..
 import { downloadExtensionStoreZipBuffer, fetchMarketplacePackageDetail, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { getMarketplaceProviderDisplayName, resolveSkillsMarketplaceProvider } from "../../agent/skills/marketplace/resolve-adapter.js";
 import { downloadFromMarketplace, getMarketplacePackageDetail, listMarketplaceCategories, listMarketplacePackages } from "../../agent/skills/skills-marketplace.js";
-import { existsSync, mkdirSync, rmSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, mkdirSync, rmSync } from "node:fs";
 //#region src/gateway/service/marketplace-service.ts
 /**
 * GatewayMarketplaceService — install / browse / remove for the two marketplaces

package/dist/src/gateway/service/sessions-api.js

@@ -1,5 +1,6 @@
 import { retireSessionMcpRuntimeForSessionKey } from "../../agent/mcp/bundle-mcp-runtime.js";
 import "../../agent/mcp/bundle-mcp-tools.js";
+import { collectMediaUrisFromMessages, deleteMediaUris } from "../../media/session-references.js";
 import { getDistinctSessionChatIds } from "./session-chat-ids.js";
 import { performSessionReset } from "../session-reset-service.js";
 //#region src/gateway/service/sessions-api.ts
@@ -69,8 +70,10 @@ var GatewaySessionsApi = class {
 		return result;
 	}
 	async delete(key) {
+		const messages = await this.opts.sessionIndex.loadMessages(key).catch(() => []);
 		const result = await this.opts.sessionIndex.deleteSession(key);
 		if (result) {
+			await deleteMediaUris(collectMediaUrisFromMessages(messages));
 			this.opts.getAgentService().evictSessionAgent(key);
 			await retireSessionMcpRuntimeForSessionKey({
 				sessionKey: key,

package/dist/src/gateway/service/sessions-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessions-api.js","names":[],"sources":["../../../../src/gateway/service/sessions-api.ts"],"sourcesContent":["/**\n * GatewaySessionsApi — session CRUD, search, compaction, tag/pin/archive,\n * stats, and chat-id grouping for the gateway REST surface.\n *\n * Twenty-four methods, previously sitting on `GatewayService` as a mix of\n * one-line `sessionIndex.*` delegations and small composite operations (e.g.\n * `restoreCheckpoint` also evicts the in-memory agent, `runCompaction` also\n * appends a transcript context entry). Centralising them here lets routes\n * depend on the narrow `GatewaySessionsApi` surface instead of the full\n * `GatewayService`, and keeps the gateway composition root focused on\n * lifecycle + wiring.\n */\n\nimport type { AgentService } from '../../agent/service.js';\nimport type { CompactionResult } from '../../agent/memory/compaction.js';\nimport { retireSessionMcpRuntimeForSessionKey } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { SessionIndex } from '../../session/index.js';\nimport type { ExportFormat, SessionListQuery } from '../../session/types.js';\nimport type { SessionPatchBody } from '../../session/patch-metadata.js';\nimport { getDistinctSessionChatIds } from './session-chat-ids.js';\nimport { performSessionReset, type SessionResetResult } from '../session-reset-service.js';\n\nexport interface GatewaySessionsApiOptions {\n  sessionIndex: SessionIndex;\n  /** Resolves the live agent service (created lazily; throws if gateway is starting). */\n  getAgentService: () => AgentService;\n  /** Read-only view of in-flight webchat runs (per session key → run id). */\n  getActiveWebchatRunId: (sessionKey: string) => string | undefined;\n}\n\nexport class GatewaySessionsApi {\n  private readonly opts: GatewaySessionsApiOptions;\n\n  constructor(opts: GatewaySessionsApiOptions) {\n    this.opts = opts;\n  }\n\n  // ── List / get ─────────────────────────────────────────────────────────\n\n  listSessions(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSessions(query);\n  }\n\n  /** Subagent sessions have keys starting with `subagent:`. */\n  listSubagents(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSubagents(query);\n  }\n\n  getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ) {\n    return this.opts.sessionIndex.getSession(key, options);\n  }\n\n  /** Read-only: in-flight webchat agent run for this session key, if any. */\n  getActiveRun(sessionKey: string): { active: boolean; runId?: string } {\n    const key = sessionKey.trim();\n    if (!key) return { active: false };\n    const runId = this.opts.getActiveWebchatRunId(key)?.trim();\n    if (!runId) return { active: false };\n    return { active: true, runId };\n  }\n\n  getMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ) {\n    return this.opts.sessionIndex.getSessionMessagePage(key, options);\n  }\n\n  // ── Metadata patches ──────────────────────────────────────────────────\n\n  patch(key: string, body: SessionPatchBody): Promise<{ ok: true } | { ok: false; error: string }> {\n    return this.opts.sessionIndex.patchSession(key, body);\n  }\n\n  async getAgentConfig(sessionKey: string) {\n    return this.opts.getAgentService().sessionInspector.agentConfig(sessionKey);\n  }\n\n  /** Resolved markdown workspace for a session (after hydration / mkdir). */\n  getEffectiveWorkspacePath(sessionKey: string): Promise<string> {\n    return this.opts.getAgentService().getEffectiveWorkspacePathForSession(sessionKey);\n  }\n\n  patchAgentConfig(\n    sessionKey: string,\n    body: {\n      thinkingLevel?: string;\n      model?: string | null;\n      reasoningLevel?: string;\n      workingDirectory?: string;\n    },\n  ) {\n    return this.opts.getAgentService().sessionConfig.patch(sessionKey, body);\n  }\n\n  // ── Compaction checkpoints ────────────────────────────────────────────\n\n  listCompactionCheckpoints(key: string) {\n    return this.opts.sessionIndex.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.opts.sessionIndex.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    await this.opts.sessionIndex.restoreCompactionCheckpoint(key, checkpointId);\n    this.opts.getAgentService().evictSessionAgent(key);\n  }\n\n  async runCompaction(\n    key: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const result = await this.opts.getAgentService().sessionInspector.compact(key, options);\n    if (result.compacted) {\n      void this.opts.sessionIndex\n        .appendTranscriptContextEntry(key, {\n          text: 'Session transcript compacted',\n          data: {\n            firstKeptIndex: result.firstKeptIndex,\n            tokensBefore: result.tokensBefore,\n            tokensAfter: result.tokensAfter,\n            summaryPreview: result.summary.slice(0, 500),\n          },\n        })\n        .catch(() => {});\n    }\n    return result;\n  }\n\n  // ── Lifecycle (delete / rename / tag / pin / archive) ─────────────────\n\n  async delete(key: string): Promise<{ deleted: boolean }> {\n    const result = await this.opts.sessionIndex.deleteSession(key);\n    if (result) {\n      this.opts.getAgentService().evictSessionAgent(key);\n      await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-delete' });\n    }\n    return { deleted: result };\n  }\n\n  /** Reset transcript in place (archive + new session id); preserves session key and overrides. */\n  reset(key: string): Promise<SessionResetResult> {\n    return performSessionReset(key, {\n      sessionIndex: this.opts.sessionIndex,\n      getAgentService: this.opts.getAgentService,\n    });\n  }\n\n  deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    return this.opts.sessionIndex.deleteSessions(keys);\n  }\n\n  async rename(key: string, name: string): Promise<{ renamed: boolean }> {\n    await this.opts.sessionIndex.renameSession(key, name);\n    return { renamed: true };\n  }\n\n  async tag(key: string, tags: string[]): Promise<{ tagged: boolean }> {\n    await this.opts.sessionIndex.tagSession(key, tags);\n    return { tagged: true };\n  }\n\n  async untag(key: string, tags: string[]): Promise<{ untagged: boolean }> {\n    await this.opts.sessionIndex.untagSession(key, tags);\n    return { untagged: true };\n  }\n\n  async archive(key: string): Promise<{ archived: boolean }> {\n    await this.opts.sessionIndex.archiveSession(key);\n    return { archived: true };\n  }\n\n  async unarchive(key: string): Promise<{ unarchived: boolean }> {\n    await this.opts.sessionIndex.unarchiveSession(key);\n    return { unarchived: true };\n  }\n\n  async pin(key: string): Promise<{ pinned: boolean }> {\n    await this.opts.sessionIndex.pinSession(key);\n    return { pinned: true };\n  }\n\n  async unpin(key: string): Promise<{ unpinned: boolean }> {\n    await this.opts.sessionIndex.unpinSession(key);\n    return { unpinned: true };\n  }\n\n  // ── Search + export + stats ───────────────────────────────────────────\n\n  search(query: string) {\n    return this.opts.sessionIndex.searchSessions(query);\n  }\n\n  searchIn(key: string, keyword: string) {\n    return this.opts.sessionIndex.searchInSession(key, keyword);\n  }\n\n  async export(key: string, format: ExportFormat): Promise<{ content: string }> {\n    const content = await this.opts.sessionIndex.exportSession(key, format);\n    return { content };\n  }\n\n  stats() {\n    return this.opts.sessionIndex.getStats();\n  }\n\n  /**\n   * Distinct chat-id pairs from sessions, grouped by channel. Used by cron job\n   * configuration UI to seed the \"send to existing chat\" picker.\n   */\n  chatIds(channel?: string): Promise<\n    Array<{\n      channel: string;\n      chatId: string;\n      lastActive: string;\n      accountId?: string;\n      peerKind?: string;\n      peerId?: string;\n    }>\n  > {\n    return getDistinctSessionChatIds(this.opts.sessionIndex, channel);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sessions-api.js","names":[],"sources":["../../../../src/gateway/service/sessions-api.ts"],"sourcesContent":["/**\n * GatewaySessionsApi — session CRUD, search, compaction, tag/pin/archive,\n * stats, and chat-id grouping for the gateway REST surface.\n *\n * Twenty-four methods, previously sitting on `GatewayService` as a mix of\n * one-line `sessionIndex.*` delegations and small composite operations (e.g.\n * `restoreCheckpoint` also evicts the in-memory agent, `runCompaction` also\n * appends a transcript context entry). Centralising them here lets routes\n * depend on the narrow `GatewaySessionsApi` surface instead of the full\n * `GatewayService`, and keeps the gateway composition root focused on\n * lifecycle + wiring.\n */\n\nimport type { AgentService } from '../../agent/service.js';\nimport type { CompactionResult } from '../../agent/memory/compaction.js';\nimport { retireSessionMcpRuntimeForSessionKey } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { SessionIndex } from '../../session/index.js';\nimport type { ExportFormat, SessionListQuery } from '../../session/types.js';\nimport type { SessionPatchBody } from '../../session/patch-metadata.js';\nimport { collectMediaUrisFromMessages, deleteMediaUris } from '../../media/session-references.js';\nimport { getDistinctSessionChatIds } from './session-chat-ids.js';\nimport { performSessionReset, type SessionResetResult } from '../session-reset-service.js';\n\nexport interface GatewaySessionsApiOptions {\n  sessionIndex: SessionIndex;\n  /** Resolves the live agent service (created lazily; throws if gateway is starting). */\n  getAgentService: () => AgentService;\n  /** Read-only view of in-flight webchat runs (per session key → run id). */\n  getActiveWebchatRunId: (sessionKey: string) => string | undefined;\n}\n\nexport class GatewaySessionsApi {\n  private readonly opts: GatewaySessionsApiOptions;\n\n  constructor(opts: GatewaySessionsApiOptions) {\n    this.opts = opts;\n  }\n\n  // ── List / get ─────────────────────────────────────────────────────────\n\n  listSessions(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSessions(query);\n  }\n\n  /** Subagent sessions have keys starting with `subagent:`. */\n  listSubagents(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSubagents(query);\n  }\n\n  getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ) {\n    return this.opts.sessionIndex.getSession(key, options);\n  }\n\n  /** Read-only: in-flight webchat agent run for this session key, if any. */\n  getActiveRun(sessionKey: string): { active: boolean; runId?: string } {\n    const key = sessionKey.trim();\n    if (!key) return { active: false };\n    const runId = this.opts.getActiveWebchatRunId(key)?.trim();\n    if (!runId) return { active: false };\n    return { active: true, runId };\n  }\n\n  getMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ) {\n    return this.opts.sessionIndex.getSessionMessagePage(key, options);\n  }\n\n  // ── Metadata patches ──────────────────────────────────────────────────\n\n  patch(key: string, body: SessionPatchBody): Promise<{ ok: true } | { ok: false; error: string }> {\n    return this.opts.sessionIndex.patchSession(key, body);\n  }\n\n  async getAgentConfig(sessionKey: string) {\n    return this.opts.getAgentService().sessionInspector.agentConfig(sessionKey);\n  }\n\n  /** Resolved markdown workspace for a session (after hydration / mkdir). */\n  getEffectiveWorkspacePath(sessionKey: string): Promise<string> {\n    return this.opts.getAgentService().getEffectiveWorkspacePathForSession(sessionKey);\n  }\n\n  patchAgentConfig(\n    sessionKey: string,\n    body: {\n      thinkingLevel?: string;\n      model?: string | null;\n      reasoningLevel?: string;\n      workingDirectory?: string;\n    },\n  ) {\n    return this.opts.getAgentService().sessionConfig.patch(sessionKey, body);\n  }\n\n  // ── Compaction checkpoints ────────────────────────────────────────────\n\n  listCompactionCheckpoints(key: string) {\n    return this.opts.sessionIndex.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.opts.sessionIndex.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    await this.opts.sessionIndex.restoreCompactionCheckpoint(key, checkpointId);\n    this.opts.getAgentService().evictSessionAgent(key);\n  }\n\n  async runCompaction(\n    key: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const result = await this.opts.getAgentService().sessionInspector.compact(key, options);\n    if (result.compacted) {\n      void this.opts.sessionIndex\n        .appendTranscriptContextEntry(key, {\n          text: 'Session transcript compacted',\n          data: {\n            firstKeptIndex: result.firstKeptIndex,\n            tokensBefore: result.tokensBefore,\n            tokensAfter: result.tokensAfter,\n            summaryPreview: result.summary.slice(0, 500),\n          },\n        })\n        .catch(() => {});\n    }\n    return result;\n  }\n\n  // ── Lifecycle (delete / rename / tag / pin / archive) ─────────────────\n\n  async delete(key: string): Promise<{ deleted: boolean }> {\n    const messages = await this.opts.sessionIndex.loadMessages(key).catch(() => []);\n    const result = await this.opts.sessionIndex.deleteSession(key);\n    if (result) {\n      await deleteMediaUris(collectMediaUrisFromMessages(messages));\n      this.opts.getAgentService().evictSessionAgent(key);\n      await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-delete' });\n    }\n    return { deleted: result };\n  }\n\n  /** Reset transcript in place (archive + new session id); preserves session key and overrides. */\n  reset(key: string): Promise<SessionResetResult> {\n    return performSessionReset(key, {\n      sessionIndex: this.opts.sessionIndex,\n      getAgentService: this.opts.getAgentService,\n    });\n  }\n\n  deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    return this.opts.sessionIndex.deleteSessions(keys);\n  }\n\n  async rename(key: string, name: string): Promise<{ renamed: boolean }> {\n    await this.opts.sessionIndex.renameSession(key, name);\n    return { renamed: true };\n  }\n\n  async tag(key: string, tags: string[]): Promise<{ tagged: boolean }> {\n    await this.opts.sessionIndex.tagSession(key, tags);\n    return { tagged: true };\n  }\n\n  async untag(key: string, tags: string[]): Promise<{ untagged: boolean }> {\n    await this.opts.sessionIndex.untagSession(key, tags);\n    return { untagged: true };\n  }\n\n  async archive(key: string): Promise<{ archived: boolean }> {\n    await this.opts.sessionIndex.archiveSession(key);\n    return { archived: true };\n  }\n\n  async unarchive(key: string): Promise<{ unarchived: boolean }> {\n    await this.opts.sessionIndex.unarchiveSession(key);\n    return { unarchived: true };\n  }\n\n  async pin(key: string): Promise<{ pinned: boolean }> {\n    await this.opts.sessionIndex.pinSession(key);\n    return { pinned: true };\n  }\n\n  async unpin(key: string): Promise<{ unpinned: boolean }> {\n    await this.opts.sessionIndex.unpinSession(key);\n    return { unpinned: true };\n  }\n\n  // ── Search + export + stats ───────────────────────────────────────────\n\n  search(query: string) {\n    return this.opts.sessionIndex.searchSessions(query);\n  }\n\n  searchIn(key: string, keyword: string) {\n    return this.opts.sessionIndex.searchInSession(key, keyword);\n  }\n\n  async export(key: string, format: ExportFormat): Promise<{ content: string }> {\n    const content = await this.opts.sessionIndex.exportSession(key, format);\n    return { content };\n  }\n\n  stats() {\n    return this.opts.sessionIndex.getStats();\n  }\n\n  /**\n   * Distinct chat-id pairs from sessions, grouped by channel. Used by cron job\n   * configuration UI to seed the \"send to existing chat\" picker.\n   */\n  chatIds(channel?: string): Promise<\n    Array<{\n      channel: string;\n      chatId: string;\n      lastActive: string;\n      accountId?: string;\n      peerKind?: string;\n      peerId?: string;\n    }>\n  > {\n    return getDistinctSessionChatIds(this.opts.sessionIndex, channel);\n  }\n}\n"],"mappings":"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"}

package/dist/src/gateway/service.js

@@ -1,12 +1,12 @@
 import { __toCommonJS } from "../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { getLogDir } from "../utils/logger/config.js";
 import { getRuntimeLogStats } from "../utils/logger/stats.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveAgentDir, resolveConfigPath, resolveCronJobsPath, resolveExtensionsDir } from "../config/paths.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connection.js";

package/dist/src/gateway/workspace-fs-file-list.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { readdir } from "node:fs/promises";
 import { join, relative } from "node:path";
+import { readdir } from "node:fs/promises";
 //#region src/gateway/workspace-fs-file-list.ts
 init_logger();
 const log = createLogger("WorkspaceFsFileList");

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/brew.js

@@ -1,5 +1,5 @@
-import path from "node:path";
 import os from "node:os";
+import path from "node:path";
 //#region src/infra/brew.ts
 function normalizePathValue(value) {
 	if (typeof value !== "string") return void 0;

package/dist/src/infra/package-json.js

@@ -1,5 +1,5 @@
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/package-json.ts
 async function readPackageVersion(root) {
 	try {

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

@@ -1,7 +1,7 @@
 import { readPackageVersion } from "./package-json.js";
 import { XOPC_PACKAGE_NAME, collectInstalledGlobalPackageErrors, globalInstallArgs, globalInstallFallbackArgs, resolveExpectedInstalledVersionFromSpec, resolveGlobalInstallTarget, resolveNpmGlobalPrefixLayoutFromGlobalRoot, resolveNpmGlobalPrefixLayoutFromPrefix } from "./update-global.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/package-update-steps.ts
 function formatError(err) {
 	return err instanceof Error ? err.message : String(err);

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

@@ -1,7 +1,7 @@
 import { resolveBrewPathDirs } from "./brew.js";
-import fs from "node:fs";
-import path from "node:path";
 import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
 //#region src/infra/path-env.ts
 function isTruthyEnvValue(value) {
 	if (!value) return false;

package/dist/src/infra/restart.js

@@ -1,8 +1,8 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 //#region src/infra/restart.ts
 /**
 * Gateway restart coordination — OpenClaw-aligned SIGUSR1 authorization and restart intent.

package/dist/src/infra/stable-node-path.js

@@ -1,5 +1,5 @@
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/stable-node-path.ts
 /** Resolve Homebrew Cellar node paths to stable opt/bin symlinks. */
 async function resolveStableNodePath(nodePath) {

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

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { channelToNpmTag } from "./update-channels.js";
-import { access, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { access, readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 //#region src/infra/update-check.ts
 init_package_version();

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

@@ -2,9 +2,9 @@ import { resolveExecPathBinPrepend } from "./path-env.js";
 import { readPackageVersion } from "./package-json.js";
 import { applyPathPrepend } from "./path-prepend.js";
 import { createDefaultCommandRunner } from "./run-command.js";
+import path from "node:path";
 import fs from "node:fs";
 import fs$1 from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
 const GLOBAL_RENAME_PREFIX = ".";

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

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
-import { mkdir, readFile, unlink } from "node:fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { dirname } from "node:path";
+import { mkdir, readFile, unlink } from "node:fs/promises";
 //#region src/infra/update-lock.ts
 init_write_file_atomic();
 init_paths_state();

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

@@ -8,8 +8,8 @@ import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
 import { trimLogTail } from "./update-log.js";
 import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/update-runner.ts
 const DEFAULT_TIMEOUT_MS = 2700 * 1e3;
 const MAX_LOG_CHARS = 8e3;

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

@@ -1,8 +1,8 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { acquireUpdateLock } from "./update-lock.js";
 import { normalizeUpdateChannel } from "./update-channels.js";
 import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "./update-check.js";

package/dist/src/infra/write-file-atomic.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { randomUUID } from "node:crypto";
+import path from "node:path";
 import { chmodSync, closeSync, copyFileSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { chmod, copyFile, mkdir, open, rename, rm } from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/write-file-atomic.ts
 /**
 * Durable single-file writes: temp file → fsync → rename to target.

package/dist/src/media/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './paths.js';
+export * from './uri.js';
+export * from './store.js';
+export * from './media-reference.js';

package/dist/src/media/index.js

@@ -0,0 +1,5 @@
+import { getMediaBucketDir, getMediaDir, isPathInside } from "./paths.js";
+import { MediaUriError, buildMediaUri, parseMediaUri, tryParseMediaUri } from "./uri.js";
+import { MEDIA_MAX_BYTES, deleteMediaBuffer, ensureMediaDir, mimeTypeFromMediaPath, readMediaBuffer, resolveMediaBufferPath, saveMediaBuffer } from "./store.js";
+import { readMediaReference, readMediaReferenceBase64, resolveMediaReference } from "./media-reference.js";
+export { MEDIA_MAX_BYTES, MediaUriError, buildMediaUri, deleteMediaBuffer, ensureMediaDir, getMediaBucketDir, getMediaDir, isPathInside, mimeTypeFromMediaPath, parseMediaUri, readMediaBuffer, readMediaReference, readMediaReferenceBase64, resolveMediaBufferPath, resolveMediaReference, saveMediaBuffer, tryParseMediaUri };

package/dist/src/media/media-reference.d.ts

@@ -0,0 +1,23 @@
+import { parseMediaUri, tryParseMediaUri } from './uri.js';
+import type { MediaBucket } from './types.js';
+export type ResolvedMediaReference = {
+    bucket: MediaBucket;
+    id: string;
+    uri: string;
+    path: string;
+};
+/** Resolve a `media://` URI to an absolute filesystem path. */
+export declare function resolveMediaReference(uri: string): Promise<ResolvedMediaReference>;
+/** Read bytes for a media URI. */
+export declare function readMediaReference(uri: string, maxBytes?: number): Promise<{
+    buffer: Buffer;
+    path: string;
+    contentType?: string;
+}>;
+/** Load file as base64 for LLM boundaries. */
+export declare function readMediaReferenceBase64(uri: string, maxBytes?: number): Promise<{
+    data: string;
+    mimeType: string;
+    path: string;
+}>;
+export { tryParseMediaUri, parseMediaUri };

package/dist/src/media/media-reference.js

@@ -0,0 +1,34 @@
+import { parseMediaUri, tryParseMediaUri } from "./uri.js";
+import { mimeTypeFromMediaPath, readMediaBuffer, resolveMediaBufferPath } from "./store.js";
+//#region src/media/media-reference.ts
+/** Resolve a `media://` URI to an absolute filesystem path. */
+async function resolveMediaReference(uri) {
+	const parsed = parseMediaUri(uri);
+	const path = resolveMediaBufferPath(parsed.id, parsed.bucket);
+	return {
+		...parsed,
+		path
+	};
+}
+/** Read bytes for a media URI. */
+async function readMediaReference(uri, maxBytes) {
+	const parsed = parseMediaUri(uri);
+	const result = await readMediaBuffer(parsed.id, parsed.bucket, maxBytes);
+	return {
+		buffer: result.buffer,
+		path: result.path
+	};
+}
+/** Load file as base64 for LLM boundaries. */
+async function readMediaReferenceBase64(uri, maxBytes) {
+	const { buffer, path } = await readMediaReference(uri, maxBytes);
+	return {
+		data: buffer.toString("base64"),
+		mimeType: mimeTypeFromMediaPath(path),
+		path
+	};
+}
+//#endregion
+export { parseMediaUri, readMediaReference, readMediaReferenceBase64, resolveMediaReference, tryParseMediaUri };
+
+//# sourceMappingURL=media-reference.js.map

package/dist/src/media/media-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-reference.js","names":[],"sources":["../../../src/media/media-reference.ts"],"sourcesContent":["import { readMediaBuffer, resolveMediaBufferPath, mimeTypeFromMediaPath } from './store.js';\nimport { parseMediaUri, tryParseMediaUri } from './uri.js';\nimport type { MediaBucket } from './types.js';\n\nexport type ResolvedMediaReference = {\n  bucket: MediaBucket;\n  id: string;\n  uri: string;\n  path: string;\n};\n\n/** Resolve a `media://` URI to an absolute filesystem path. */\nexport async function resolveMediaReference(uri: string): Promise<ResolvedMediaReference> {\n  const parsed = parseMediaUri(uri);\n  const path = resolveMediaBufferPath(parsed.id, parsed.bucket);\n  return { ...parsed, path };\n}\n\n/** Read bytes for a media URI. */\nexport async function readMediaReference(\n  uri: string,\n  maxBytes?: number,\n): Promise<{ buffer: Buffer; path: string; contentType?: string }> {\n  const parsed = parseMediaUri(uri);\n  const result = await readMediaBuffer(parsed.id, parsed.bucket, maxBytes);\n  return { buffer: result.buffer, path: result.path };\n}\n\n/** Load file as base64 for LLM boundaries. */\nexport async function readMediaReferenceBase64(\n  uri: string,\n  maxBytes?: number,\n): Promise<{ data: string; mimeType: string; path: string }> {\n  const { buffer, path } = await readMediaReference(uri, maxBytes);\n  return {\n    data: buffer.toString('base64'),\n    mimeType: mimeTypeFromMediaPath(path),\n    path,\n  };\n}\n\nexport { tryParseMediaUri, parseMediaUri };\n"],"mappings":";;;;AAYA,eAAsB,sBAAsB,KAA8C;CACxF,MAAM,SAAS,cAAc,IAAI;CACjC,MAAM,OAAO,uBAAuB,OAAO,IAAI,OAAO,OAAO;AAC7D,QAAO;EAAE,GAAG;EAAQ;EAAM;;;AAI5B,eAAsB,mBACpB,KACA,UACiE;CACjE,MAAM,SAAS,cAAc,IAAI;CACjC,MAAM,SAAS,MAAM,gBAAgB,OAAO,IAAI,OAAO,QAAQ,SAAS;AACxE,QAAO;EAAE,QAAQ,OAAO;EAAQ,MAAM,OAAO;EAAM;;;AAIrD,eAAsB,yBACpB,KACA,UAC2D;CAC3D,MAAM,EAAE,QAAQ,SAAS,MAAM,mBAAmB,KAAK,SAAS;AAChE,QAAO;EACL,MAAM,OAAO,SAAS,SAAS;EAC/B,UAAU,sBAAsB,KAAK;EACrC;EACD"}

package/dist/src/media/paths.d.ts

@@ -0,0 +1,5 @@
+import type { MediaBucket } from './types.js';
+/** Global media store root: `{stateDir}/media/`. */
+export declare function getMediaDir(): string;
+export declare function getMediaBucketDir(bucket: MediaBucket): string;
+export declare function isPathInside(root: string, candidate: string): boolean;

package/dist/src/media/paths.js

@@ -0,0 +1,20 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { join, resolve } from "node:path";
+//#region src/media/paths.ts
+init_paths_state();
+/** Global media store root: `{stateDir}/media/`. */
+function getMediaDir() {
+	return join(resolveStateDir(), "media");
+}
+function getMediaBucketDir(bucket) {
+	return join(getMediaDir(), bucket);
+}
+function isPathInside(root, candidate) {
+	const rootResolved = resolve(root);
+	const candidateResolved = resolve(candidate);
+	return candidateResolved === rootResolved || candidateResolved.startsWith(rootResolved + "/");
+}
+//#endregion
+export { getMediaBucketDir, getMediaDir, isPathInside };
+
+//# sourceMappingURL=paths.js.map

package/dist/src/media/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../../../src/media/paths.ts"],"sourcesContent":["import { join, resolve } from 'node:path';\n\nimport { resolveStateDir } from '../config/paths-state.js';\n\nimport type { MediaBucket } from './types.js';\n\n/** Global media store root: `{stateDir}/media/`. */\nexport function getMediaDir(): string {\n  return join(resolveStateDir(), 'media');\n}\n\nexport function getMediaBucketDir(bucket: MediaBucket): string {\n  return join(getMediaDir(), bucket);\n}\n\nexport function isPathInside(root: string, candidate: string): boolean {\n  const rootResolved = resolve(root);\n  const candidateResolved = resolve(candidate);\n  return (\n    candidateResolved === rootResolved ||\n    candidateResolved.startsWith(rootResolved + '/')\n  );\n}\n"],"mappings":";;;kBAE2D;;AAK3D,SAAgB,cAAsB;AACpC,QAAO,KAAK,iBAAiB,EAAE,QAAQ;;AAGzC,SAAgB,kBAAkB,QAA6B;AAC7D,QAAO,KAAK,aAAa,EAAE,OAAO;;AAGpC,SAAgB,aAAa,MAAc,WAA4B;CACrE,MAAM,eAAe,QAAQ,KAAK;CAClC,MAAM,oBAAoB,QAAQ,UAAU;AAC5C,QACE,sBAAsB,gBACtB,kBAAkB,WAAW,eAAe,IAAI"}

package/dist/src/media/session-references.d.ts

@@ -0,0 +1,8 @@
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+export declare function collectMediaUrisFromMessages(messages: readonly AgentMessage[]): Set<string>;
+export declare function messagesReferenceMediaUri(messages: readonly AgentMessage[], uri: string): boolean;
+export declare function deleteMediaUris(uris: Iterable<string>): Promise<void>;
+export declare function deleteMediaUrisNoLongerReferenced(params: {
+    removed: readonly AgentMessage[];
+    remaining: readonly AgentMessage[];
+}): Promise<void>;

package/dist/src/media/session-references.js

@@ -0,0 +1,45 @@
+import { tryParseMediaUri } from "./uri.js";
+import { deleteMediaBuffer } from "./store.js";
+//#region src/media/session-references.ts
+function collectFromValue(value, out) {
+	if (!value) return;
+	if (typeof value === "string") {
+		if (value.startsWith("media://")) out.add(value.trim());
+		return;
+	}
+	if (Array.isArray(value)) {
+		for (const item of value) collectFromValue(item, out);
+		return;
+	}
+	if (typeof value !== "object") return;
+	const record = value;
+	if (typeof record.uri === "string" && record.uri.startsWith("media://")) out.add(record.uri.trim());
+	if (Array.isArray(record.media)) collectFromValue(record.media, out);
+	if (Array.isArray(record.attachments)) collectFromValue(record.attachments, out);
+}
+function collectMediaUrisFromMessages(messages) {
+	const out = /* @__PURE__ */ new Set();
+	for (const message of messages) collectFromValue(message, out);
+	return out;
+}
+function messagesReferenceMediaUri(messages, uri) {
+	return collectMediaUrisFromMessages(messages).has(uri.trim());
+}
+async function deleteMediaUris(uris) {
+	for (const uri of new Set(uris)) {
+		const parsed = tryParseMediaUri(uri);
+		if (!parsed) continue;
+		await deleteMediaBuffer(parsed.id, parsed.bucket).catch(() => {});
+	}
+}
+async function deleteMediaUrisNoLongerReferenced(params) {
+	const removedUris = collectMediaUrisFromMessages(params.removed);
+	if (removedUris.size === 0) return;
+	const remainingUris = collectMediaUrisFromMessages(params.remaining);
+	for (const uri of remainingUris) removedUris.delete(uri);
+	await deleteMediaUris(removedUris);
+}
+//#endregion
+export { collectMediaUrisFromMessages, deleteMediaUris, deleteMediaUrisNoLongerReferenced, messagesReferenceMediaUri };
+
+//# sourceMappingURL=session-references.js.map

package/dist/src/media/session-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-references.js","names":[],"sources":["../../../src/media/session-references.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { deleteMediaBuffer } from './store.js';\nimport { tryParseMediaUri } from './uri.js';\n\nfunction collectFromValue(value: unknown, out: Set<string>): void {\n  if (!value) return;\n  if (typeof value === 'string') {\n    if (value.startsWith('media://')) out.add(value.trim());\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const item of value) collectFromValue(item, out);\n    return;\n  }\n  if (typeof value !== 'object') return;\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.uri === 'string' && record.uri.startsWith('media://')) {\n    out.add(record.uri.trim());\n  }\n  if (Array.isArray(record.media)) collectFromValue(record.media, out);\n  if (Array.isArray(record.attachments)) collectFromValue(record.attachments, out);\n}\n\nexport function collectMediaUrisFromMessages(messages: readonly AgentMessage[]): Set<string> {\n  const out = new Set<string>();\n  for (const message of messages) collectFromValue(message, out);\n  return out;\n}\n\nexport function messagesReferenceMediaUri(messages: readonly AgentMessage[], uri: string): boolean {\n  return collectMediaUrisFromMessages(messages).has(uri.trim());\n}\n\nexport async function deleteMediaUris(uris: Iterable<string>): Promise<void> {\n  for (const uri of new Set(uris)) {\n    const parsed = tryParseMediaUri(uri);\n    if (!parsed) continue;\n    await deleteMediaBuffer(parsed.id, parsed.bucket).catch(() => {});\n  }\n}\n\nexport async function deleteMediaUrisNoLongerReferenced(params: {\n  removed: readonly AgentMessage[];\n  remaining: readonly AgentMessage[];\n}): Promise<void> {\n  const removedUris = collectMediaUrisFromMessages(params.removed);\n  if (removedUris.size === 0) return;\n\n  const remainingUris = collectMediaUrisFromMessages(params.remaining);\n  for (const uri of remainingUris) removedUris.delete(uri);\n  await deleteMediaUris(removedUris);\n}\n"],"mappings":";;;AAKA,SAAS,iBAAiB,OAAgB,KAAwB;AAChE,KAAI,CAAC,MAAO;AACZ,KAAI,OAAO,UAAU,UAAU;AAC7B,MAAI,MAAM,WAAW,WAAW,CAAE,KAAI,IAAI,MAAM,MAAM,CAAC;AACvD;;AAEF,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,OAAK,MAAM,QAAQ,MAAO,kBAAiB,MAAM,IAAI;AACrD;;AAEF,KAAI,OAAO,UAAU,SAAU;CAE/B,MAAM,SAAS;AACf,KAAI,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,WAAW,WAAW,CACrE,KAAI,IAAI,OAAO,IAAI,MAAM,CAAC;AAE5B,KAAI,MAAM,QAAQ,OAAO,MAAM,CAAE,kBAAiB,OAAO,OAAO,IAAI;AACpE,KAAI,MAAM,QAAQ,OAAO,YAAY,CAAE,kBAAiB,OAAO,aAAa,IAAI;;AAGlF,SAAgB,6BAA6B,UAAgD;CAC3F,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,WAAW,SAAU,kBAAiB,SAAS,IAAI;AAC9D,QAAO;;AAGT,SAAgB,0BAA0B,UAAmC,KAAsB;AACjG,QAAO,6BAA6B,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC;;AAG/D,eAAsB,gBAAgB,MAAuC;AAC3E,MAAK,MAAM,OAAO,IAAI,IAAI,KAAK,EAAE;EAC/B,MAAM,SAAS,iBAAiB,IAAI;AACpC,MAAI,CAAC,OAAQ;AACb,QAAM,kBAAkB,OAAO,IAAI,OAAO,OAAO,CAAC,YAAY,GAAG;;;AAIrE,eAAsB,kCAAkC,QAGtC;CAChB,MAAM,cAAc,6BAA6B,OAAO,QAAQ;AAChE,KAAI,YAAY,SAAS,EAAG;CAE5B,MAAM,gBAAgB,6BAA6B,OAAO,UAAU;AACpE,MAAK,MAAM,OAAO,cAAe,aAAY,OAAO,IAAI;AACxD,OAAM,gBAAgB,YAAY"}

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

@@ -0,0 +1,19 @@
+import type { MediaBucket, SavedMedia } from './types.js';
+/** Default per-file cap for inbound staging (5 MiB). */
+export declare const MEDIA_MAX_BYTES: number;
+export declare function ensureMediaDir(): Promise<string>;
+export declare function saveMediaBuffer(buffer: Buffer, opts?: {
+    contentType?: string;
+    bucket?: MediaBucket;
+    maxBytes?: number;
+    originalFilename?: string;
+}): Promise<SavedMedia>;
+export declare function resolveMediaBufferPath(id: string, bucket?: MediaBucket): string;
+export declare function readMediaBuffer(id: string, bucket?: MediaBucket, maxBytes?: number): Promise<{
+    id: string;
+    path: string;
+    buffer: Buffer;
+    size: number;
+}>;
+export declare function deleteMediaBuffer(id: string, bucket?: MediaBucket): Promise<void>;
+export declare function mimeTypeFromMediaPath(filePath: string): string;

package/dist/src/media/store.js

@@ -0,0 +1,131 @@
+import { getMediaBucketDir, getMediaDir, isPathInside } from "./paths.js";
+import { buildMediaUri } from "./uri.js";
+import { extname, join, parse } from "node:path";
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+//#region src/media/store.ts
+/** Default per-file cap for inbound staging (5 MiB). */
+const MEDIA_MAX_BYTES = 5 * 1024 * 1024;
+const MEDIA_DIR_MODE = 448;
+const MEDIA_FILE_MODE = 420;
+const MIME_BY_EXT = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".pdf": "application/pdf",
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".json": "application/json",
+	".webm": "audio/webm",
+	".ogg": "audio/ogg",
+	".opus": "audio/ogg",
+	".mp3": "audio/mpeg",
+	".wav": "audio/wav",
+	".m4a": "audio/mp4"
+};
+function sanitizeFilename(name) {
+	return (name.replace(/[/\\?%*:|"<>]/g, "_").trim() || "file").slice(0, 60);
+}
+function extFromMime(mimeType, fallbackName) {
+	if (mimeType) {
+		const m = mimeType.split(";")[0]?.trim().toLowerCase() ?? "";
+		if (m === "image/jpeg") return ".jpg";
+		if (m === "image/png") return ".png";
+		if (m === "image/webp") return ".webp";
+		if (m === "image/gif") return ".gif";
+		if (m === "application/pdf") return ".pdf";
+		if (m === "audio/ogg") return ".ogg";
+		if (m === "audio/mpeg") return ".mp3";
+		if (m === "audio/wav") return ".wav";
+		if (m === "audio/webm") return ".webm";
+		if (m === "audio/mp4") return ".m4a";
+		if (m === "text/plain") return ".txt";
+	}
+	const fromName = fallbackName ? extname(fallbackName).toLowerCase() : "";
+	if (fromName && fromName.length <= 10) return fromName;
+	return ".bin";
+}
+function buildSavedMediaId(opts) {
+	const ext = opts.ext.startsWith(".") ? opts.ext : `.${opts.ext}`;
+	if (opts.originalFilename) {
+		const stem = sanitizeFilename(parse(opts.originalFilename).name);
+		if (stem) return `${stem}---${opts.baseId}${ext}`;
+	}
+	return `${opts.baseId}${ext}`;
+}
+function assertSafeMediaId(id, caller) {
+	if (!id || id.includes("/") || id.includes("\\") || id.includes("\0") || id === "..") throw new Error(`${caller}: unsafe media id: ${JSON.stringify(id)}`);
+}
+function assertSafeBucket(bucket) {
+	if (bucket !== "inbound" && bucket !== "tts" && bucket !== "outbound") throw new Error(`Unsupported media bucket: ${JSON.stringify(bucket)}`);
+}
+async function ensureMediaDir() {
+	const root = getMediaDir();
+	await mkdir(root, {
+		recursive: true,
+		mode: MEDIA_DIR_MODE
+	});
+	return root;
+}
+async function saveMediaBuffer(buffer, opts) {
+	const bucket = opts?.bucket ?? "inbound";
+	const maxBytes = opts?.maxBytes ?? 5242880;
+	if (buffer.byteLength > maxBytes) throw new Error(`Media exceeds ${Math.floor(maxBytes / (1024 * 1024))}MB limit`);
+	await ensureMediaDir();
+	const dir = getMediaBucketDir(bucket);
+	await mkdir(dir, {
+		recursive: true,
+		mode: MEDIA_DIR_MODE
+	});
+	const baseId = randomUUID();
+	const ext = extFromMime(opts?.contentType, opts?.originalFilename);
+	const id = buildSavedMediaId({
+		baseId,
+		ext,
+		originalFilename: opts?.originalFilename
+	});
+	assertSafeMediaId(id, "saveMediaBuffer");
+	const absPath = join(dir, id);
+	if (!isPathInside(dir, absPath)) throw new Error("Media path escapes bucket directory");
+	await writeFile(absPath, buffer, { mode: MEDIA_FILE_MODE });
+	const uri = buildMediaUri(bucket, id);
+	return {
+		id,
+		path: absPath,
+		size: buffer.byteLength,
+		contentType: opts?.contentType?.split(";")[0]?.trim() || MIME_BY_EXT[ext] || "application/octet-stream",
+		bucket,
+		uri
+	};
+}
+function resolveMediaBufferPath(id, bucket = "inbound") {
+	assertSafeBucket(bucket);
+	assertSafeMediaId(id, "resolveMediaBufferPath");
+	const dir = getMediaBucketDir(bucket);
+	const abs = join(dir, id);
+	if (!isPathInside(dir, abs)) throw new Error("Media path escapes bucket directory");
+	return abs;
+}
+async function readMediaBuffer(id, bucket = "inbound", maxBytes = MEDIA_MAX_BYTES) {
+	const path = resolveMediaBufferPath(id, bucket);
+	const buffer = await readFile(path);
+	if (buffer.byteLength > maxBytes) throw new Error(`Media ${JSON.stringify(id)} exceeds read limit`);
+	return {
+		id,
+		path,
+		buffer,
+		size: buffer.byteLength
+	};
+}
+async function deleteMediaBuffer(id, bucket = "inbound") {
+	await rm(resolveMediaBufferPath(id, bucket), { force: true });
+}
+function mimeTypeFromMediaPath(filePath) {
+	return MIME_BY_EXT[extname(filePath).toLowerCase()] ?? "application/octet-stream";
+}
+//#endregion
+export { MEDIA_MAX_BYTES, deleteMediaBuffer, ensureMediaDir, mimeTypeFromMediaPath, readMediaBuffer, resolveMediaBufferPath, saveMediaBuffer };
+
+//# sourceMappingURL=store.js.map