@bendyline/docblocks 2.6.1 → 2.7.0

package/dist/chunk-YNUQG4GF.js

@@ -0,0 +1,1173 @@
+import {
+  HOST_WIRE_LIMITS,
+  isBoundedString
+} from "./chunk-46AGYHDY.js";
+
+// src/host/capabilities.ts
+var HOST_SURFACE_KINDS = Object.freeze([
+  "electron",
+  "capacitor"
+]);
+var HOST_PLATFORMS = Object.freeze([
+  "darwin",
+  "win32",
+  "linux",
+  "ios",
+  "android"
+]);
+var NO_CAPABILITIES = Object.freeze({
+  nativeWorkspaces: false,
+  workspaceAuthority: false,
+  workspaceFolderPicker: false,
+  defaultWorkspace: false,
+  filesystemV2: false,
+  revealInFileManager: false,
+  openWorkspaceFolder: false,
+  externalNavigation: false,
+  clipboard: false,
+  exportDestinations: false,
+  exportRememberedTargets: false,
+  externalResources: false,
+  openRequests: false,
+  menuCommands: false,
+  pinnedDocumentMirror: false,
+  guardedClose: false,
+  git: false,
+  updater: false,
+  systemFfmpeg: false,
+  aiAssist: false,
+  aiModelManagement: false,
+  aiKnowledgeManagement: false,
+  aiWorkspaceIndex: false,
+  aiSearch: false,
+  aiImages: false,
+  aiTranscription: false,
+  aiSpeechSynthesis: false,
+  speechInput: false,
+  speechOutput: false,
+  speechModelManagement: false,
+  // A browser with no host keeps its documents in the origin.
+  browserOriginStorage: true,
+  ownsWindowChrome: false
+});
+var NO_HOST_CAPABILITIES = NO_CAPABILITIES;
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasMethod(container, name) {
+  return isRecord(container) && typeof container[name] === "function";
+}
+function hasObject(container, name) {
+  return isRecord(container) && isRecord(container[name]);
+}
+function parseHostEnvironment(value) {
+  if (!isRecord(value)) return null;
+  const allowed = /* @__PURE__ */ new Set(["surface", "surfaceLabel", "platform", "appVersion", "isDev"]);
+  for (const key of Object.keys(value)) {
+    if (!allowed.has(key)) return null;
+  }
+  const { surface, surfaceLabel, platform, appVersion, isDev } = value;
+  if (typeof surface !== "string" || !HOST_SURFACE_KINDS.includes(surface)) {
+    return null;
+  }
+  if (typeof platform !== "string" || !HOST_PLATFORMS.includes(platform)) {
+    return null;
+  }
+  if (!isBoundedString(surfaceLabel, HOST_WIRE_LIMITS.labelCharacters)) return null;
+  if (!isBoundedString(appVersion, HOST_WIRE_LIMITS.labelCharacters)) return null;
+  if (typeof isDev !== "boolean") return null;
+  return Object.freeze({
+    surface,
+    surfaceLabel,
+    platform,
+    appVersion,
+    isDev
+  });
+}
+function deriveHostCapabilities(host) {
+  if (!isRecord(host)) return NO_CAPABILITIES;
+  const environment = parseHostEnvironment(host.env);
+  if (!environment) return NO_CAPABILITIES;
+  const workspaces = host.workspaces;
+  const shell = host.shell;
+  const exports = host.exports;
+  return Object.freeze({
+    nativeWorkspaces: hasMethod(workspaces, "register"),
+    workspaceAuthority: hasMethod(workspaces, "list"),
+    workspaceFolderPicker: hasMethod(workspaces, "pickFolder"),
+    defaultWorkspace: hasMethod(workspaces, "getDefault"),
+    filesystemV2: hasObject(host, "fsV2"),
+    revealInFileManager: hasMethod(shell, "revealInFolder"),
+    openWorkspaceFolder: hasMethod(shell, "openWorkspaceFolder"),
+    externalNavigation: hasMethod(shell, "openExternal"),
+    clipboard: hasMethod(host.clipboard, "writeText"),
+    exportDestinations: hasMethod(exports, "save"),
+    exportRememberedTargets: hasMethod(exports, "resolveTarget") && hasMethod(exports, "pickTarget"),
+    externalResources: hasMethod(host.external, "readText"),
+    openRequests: hasMethod(host, "onOpenRequest"),
+    menuCommands: hasMethod(host, "onMenuCommand"),
+    pinnedDocumentMirror: hasMethod(host.menu, "setPinnedDocuments"),
+    guardedClose: hasMethod(host.lifecycle, "onPrepareClose"),
+    git: hasMethod(host.git, "status"),
+    updater: hasMethod(host.updater, "checkForUpdates"),
+    systemFfmpeg: hasMethod(host.ffmpeg, "available"),
+    // All three members are required: the UI needs provider presence to decide
+    // whether connection controls are relevant, and a stream without status
+    // leaves it unable to say why nothing is happening.
+    aiAssist: hasMethod(host.ai, "providerInstalled") && hasMethod(host.ai, "chat") && hasMethod(host.ai, "onStatus"),
+    aiModelManagement: hasMethod(host.ai, "availableModels") && hasMethod(host.ai, "installModel"),
+    aiKnowledgeManagement: isRecord(host.ai) && hasMethod(host.ai.knowledge, "state") && hasMethod(host.ai.knowledge, "update"),
+    aiWorkspaceIndex: hasMethod(host.ai, "ensureWorkspace"),
+    aiSearch: hasMethod(host.ai, "search"),
+    aiImages: hasMethod(host.ai, "generateImage"),
+    aiTranscription: hasMethod(host.ai, "transcribe"),
+    aiSpeechSynthesis: hasMethod(host.ai, "synthesize"),
+    speechInput: hasMethod(host.speech, "transcribe"),
+    speechOutput: hasMethod(host.speech, "synthesize"),
+    speechModelManagement: hasMethod(host.speech, "catalog") && hasMethod(host.speech, "installModel"),
+    // A host that owns workspace roots keeps documents outside the web origin.
+    browserOriginStorage: !hasMethod(workspaces, "register"),
+    ownsWindowChrome: environment.surface === "electron"
+  });
+}
+
+// src/host/ai-wire-policy.ts
+var AI_WIRE_LIMITS = Object.freeze({
+  messageEntries: 64,
+  /** Sum of every message's content in one request. */
+  promptCharacters: 256 * 1024,
+  deltaCharacters: 16 * 1024,
+  /** Generated documents have the same transport capacity as other documents. */
+  completionCharacters: HOST_WIRE_LIMITS.documentCharacters,
+  maxTokensCeiling: 32768,
+  temperatureCeiling: 2,
+  verificationCodeCharacters: 16,
+  progressPhaseCharacters: 64,
+  modelEntries: 200,
+  contextWindowCeiling: 8e6,
+  downloadBytesCeiling: Number.MAX_SAFE_INTEGER
+});
+var CHAT_ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant"]);
+var CHAT_PURPOSES = /* @__PURE__ */ new Set(["write", "review", "illustrate", "chat"]);
+var REVIEW_MODES = /* @__PURE__ */ new Set(["off", "explicit", "implicit"]);
+var FINISH_REASONS = /* @__PURE__ */ new Set(["stop", "length", "cancelled"]);
+var UNAVAILABLE_REASONS = /* @__PURE__ */ new Set([
+  "opt-out",
+  "platform-unsupported",
+  "not-installed",
+  "not-running",
+  "disconnected"
+]);
+var CONNECTION_STEPS = /* @__PURE__ */ new Set([
+  "detecting",
+  "awaiting-approval",
+  "preparing-model",
+  "preparing-workspace"
+]);
+var PROVIDER_MODES = /* @__PURE__ */ new Set(["installed", "hosted", "remote"]);
+var ERROR_CODES = /* @__PURE__ */ new Set([
+  "provider-unavailable",
+  "approval-denied",
+  "approval-timeout",
+  "approval-expired",
+  "approval-required",
+  "inference-disabled",
+  "already-connected",
+  "model-unavailable",
+  "model-download-failed",
+  "runtime-missing",
+  "workspace-not-registered",
+  "unsupported",
+  "budget-exceeded",
+  "rate-limited",
+  "timeout",
+  "cancelled",
+  "unknown"
+]);
+var MODEL_DOWNLOAD_STATES = /* @__PURE__ */ new Set(["download-required", "downloading"]);
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExactKeys(value, keys) {
+  const actual = Object.keys(value);
+  return actual.length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function hasKeysWithin(value, required, optional = []) {
+  const allowed = /* @__PURE__ */ new Set([...required, ...optional]);
+  for (const key of Object.keys(value)) {
+    if (!allowed.has(key)) return false;
+  }
+  return required.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function isFiniteInRange(value, minimum, maximum) {
+  return typeof value === "number" && Number.isFinite(value) && value >= minimum && value <= maximum;
+}
+function isNonNegativeInteger(value, maximum) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= maximum;
+}
+function parseAiError(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasKeysWithin(value, ["code", "message"], ["detail"])) return null;
+  if (typeof value.code !== "string" || !ERROR_CODES.has(value.code)) return null;
+  if (!isBoundedString(value.message, HOST_WIRE_LIMITS.messageCharacters)) return null;
+  if (value.detail !== void 0 && !isBoundedString(value.detail, HOST_WIRE_LIMITS.messageCharacters)) {
+    return null;
+  }
+  const error = {
+    code: value.code,
+    message: value.message,
+    ...value.detail === void 0 ? {} : { detail: value.detail }
+  };
+  return error;
+}
+function parseAiProgress(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["phase", "message", "percent"])) return null;
+  if (!isBoundedString(value.phase, AI_WIRE_LIMITS.progressPhaseCharacters, 1)) return null;
+  if (!isBoundedString(value.message, HOST_WIRE_LIMITS.messageCharacters)) return null;
+  if (value.percent !== null && !isFiniteInRange(value.percent, 0, 100)) return null;
+  return { phase: value.phase, message: value.message, percent: value.percent };
+}
+function parseAiModelInfo(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasKeysWithin(
+    value,
+    ["id", "label", "local", "contextWindow", "isDefault"],
+    ["availability", "unavailableReason"]
+  ))
+    return null;
+  if (!isBoundedString(value.id, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+  if (!isBoundedString(value.label, HOST_WIRE_LIMITS.labelCharacters, 1)) return null;
+  if (typeof value.local !== "boolean") return null;
+  if (typeof value.isDefault !== "boolean") return null;
+  if (value.availability !== void 0 && !["available", "unavailable", "download-required", "downloading"].includes(
+    value.availability
+  ))
+    return null;
+  if (value.unavailableReason !== void 0 && (!isBoundedString(value.unavailableReason, HOST_WIRE_LIMITS.messageCharacters, 1) || value.availability === void 0 || value.availability === "available"))
+    return null;
+  if (value.isDefault && value.availability !== void 0 && value.availability !== "available")
+    return null;
+  if (value.contextWindow !== null && !isNonNegativeInteger(value.contextWindow, AI_WIRE_LIMITS.contextWindowCeiling)) {
+    return null;
+  }
+  return {
+    id: value.id,
+    label: value.label,
+    local: value.local,
+    contextWindow: value.contextWindow,
+    isDefault: value.isDefault,
+    ...value.availability === void 0 ? {} : {
+      availability: value.availability
+    },
+    ...value.unavailableReason === void 0 ? {} : {
+      unavailableReason: value.unavailableReason
+    }
+  };
+}
+function parseAiModelInfoList(value) {
+  if (!Array.isArray(value) || value.length > AI_WIRE_LIMITS.modelEntries) return null;
+  const models = [];
+  for (const entry of value) {
+    const model = parseAiModelInfo(entry);
+    if (!model) return null;
+    models.push(model);
+  }
+  return models;
+}
+function parseAiModelDownloadInfo(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["id", "label", "contextWindow", "downloadBytes", "state"])) {
+    return null;
+  }
+  if (!isBoundedString(value.id, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+  if (!isBoundedString(value.label, HOST_WIRE_LIMITS.labelCharacters, 1)) return null;
+  if (value.contextWindow !== null && !isNonNegativeInteger(value.contextWindow, AI_WIRE_LIMITS.contextWindowCeiling)) {
+    return null;
+  }
+  if (value.downloadBytes !== null && (!isNonNegativeInteger(value.downloadBytes, AI_WIRE_LIMITS.downloadBytesCeiling) || value.downloadBytes === 0)) {
+    return null;
+  }
+  if (typeof value.state !== "string" || !MODEL_DOWNLOAD_STATES.has(value.state)) return null;
+  return {
+    id: value.id,
+    label: value.label,
+    contextWindow: value.contextWindow,
+    downloadBytes: value.downloadBytes,
+    state: value.state
+  };
+}
+function parseAiModelDownloadInfoList(value) {
+  if (!Array.isArray(value) || value.length > AI_WIRE_LIMITS.modelEntries) return null;
+  const models = [];
+  for (const entry of value) {
+    const model = parseAiModelDownloadInfo(entry);
+    if (!model) return null;
+    models.push(model);
+  }
+  return models;
+}
+function parseAiModelInstallEvent(value) {
+  if (!isRecord2(value)) return null;
+  if (value.kind === "progress") {
+    if (!hasExactKeys(value, ["kind", "progress"])) return null;
+    const progress = parseAiProgress(value.progress);
+    return progress ? { kind: "progress", progress } : null;
+  }
+  if (value.kind === "done") {
+    if (!hasExactKeys(value, ["kind", "model"])) return null;
+    const model = parseAiModelInfo(value.model);
+    return model ? { kind: "done", model } : null;
+  }
+  if (value.kind === "error") {
+    if (!hasExactKeys(value, ["kind", "error"])) return null;
+    const error = parseAiError(value.error);
+    return error ? { kind: "error", error } : null;
+  }
+  return null;
+}
+function parseAiChatMessage(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["role", "content"])) return null;
+  if (typeof value.role !== "string" || !CHAT_ROLES.has(value.role)) return null;
+  if (!isBoundedString(value.content, AI_WIRE_LIMITS.promptCharacters)) return null;
+  return { role: value.role, content: value.content };
+}
+function parseAiChatRequest(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasKeysWithin(value, ["messages", "purpose"], ["model", "temperature", "maxTokens"])) {
+    return null;
+  }
+  if (typeof value.purpose !== "string" || !CHAT_PURPOSES.has(value.purpose)) return null;
+  if (!Array.isArray(value.messages)) return null;
+  if (value.messages.length < 1 || value.messages.length > AI_WIRE_LIMITS.messageEntries)
+    return null;
+  const messages = [];
+  let totalCharacters = 0;
+  for (const entry of value.messages) {
+    const message2 = parseAiChatMessage(entry);
+    if (!message2) return null;
+    totalCharacters += message2.content.length;
+    if (totalCharacters > AI_WIRE_LIMITS.promptCharacters) return null;
+    messages.push(message2);
+  }
+  if (value.model !== void 0 && !isBoundedString(value.model, HOST_WIRE_LIMITS.identifierCharacters, 1)) {
+    return null;
+  }
+  if (value.temperature !== void 0 && !isFiniteInRange(value.temperature, 0, AI_WIRE_LIMITS.temperatureCeiling)) {
+    return null;
+  }
+  if (value.maxTokens !== void 0 && !isNonNegativeInteger(value.maxTokens, AI_WIRE_LIMITS.maxTokensCeiling)) {
+    return null;
+  }
+  return {
+    messages,
+    purpose: value.purpose,
+    ...value.model === void 0 ? {} : { model: value.model },
+    ...value.temperature === void 0 ? {} : { temperature: value.temperature },
+    ...value.maxTokens === void 0 ? {} : { maxTokens: value.maxTokens }
+  };
+}
+function parseAiChatProgress(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["phase", "percent", "outputTokens", "tokensPerSecond"])) return null;
+  if (value.phase !== "starting" && value.phase !== "queued" && value.phase !== "loading_model" && value.phase !== "prefill" && value.phase !== "reasoning" && value.phase !== "generating")
+    return null;
+  if (value.percent !== null && (value.phase !== "loading_model" && value.phase !== "prefill" || !isFiniteInRange(value.percent, 0, 100)))
+    return null;
+  if (value.outputTokens !== null && !isNonNegativeInteger(value.outputTokens, Number.MAX_SAFE_INTEGER))
+    return null;
+  if (value.tokensPerSecond !== null && !isFiniteInRange(value.tokensPerSecond, 0, 1e7))
+    return null;
+  return {
+    phase: value.phase,
+    percent: value.percent,
+    outputTokens: value.outputTokens,
+    tokensPerSecond: value.tokensPerSecond
+  };
+}
+function parseAiChatEvent(value) {
+  if (!isRecord2(value)) return null;
+  if (value.kind === "progress") {
+    if (!hasExactKeys(value, ["kind", "progress"])) return null;
+    const progress = parseAiChatProgress(value.progress);
+    return progress ? { kind: "progress", progress } : null;
+  }
+  if (value.kind === "delta") {
+    if (!hasExactKeys(value, ["kind", "text"])) return null;
+    if (!isBoundedString(value.text, AI_WIRE_LIMITS.deltaCharacters)) return null;
+    return { kind: "delta", text: value.text };
+  }
+  if (value.kind === "done") {
+    if (!hasExactKeys(value, ["kind", "completion"])) return null;
+    const completion = value.completion;
+    if (!isRecord2(completion)) return null;
+    if (!hasExactKeys(completion, ["text", "model", "finishReason", "usage"])) return null;
+    if (!isBoundedString(completion.text, AI_WIRE_LIMITS.completionCharacters)) return null;
+    if (!isBoundedString(completion.model, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+    if (typeof completion.finishReason !== "string" || !FINISH_REASONS.has(completion.finishReason)) {
+      return null;
+    }
+    let usage = null;
+    if (completion.usage !== null) {
+      if (!isRecord2(completion.usage)) return null;
+      if (!hasExactKeys(completion.usage, ["promptTokens", "completionTokens"])) return null;
+      if (!isNonNegativeInteger(completion.usage.promptTokens, Number.MAX_SAFE_INTEGER))
+        return null;
+      if (!isNonNegativeInteger(completion.usage.completionTokens, Number.MAX_SAFE_INTEGER)) {
+        return null;
+      }
+      usage = {
+        promptTokens: completion.usage.promptTokens,
+        completionTokens: completion.usage.completionTokens
+      };
+    }
+    return {
+      kind: "done",
+      completion: {
+        text: completion.text,
+        model: completion.model,
+        finishReason: completion.finishReason,
+        usage
+      }
+    };
+  }
+  if (value.kind === "error") {
+    if (!hasExactKeys(value, ["kind", "error"])) return null;
+    const error = parseAiError(value.error);
+    return error ? { kind: "error", error } : null;
+  }
+  return null;
+}
+function parseAiStatus(value) {
+  if (!isRecord2(value)) return null;
+  if (value.kind === "unavailable") {
+    if (!hasExactKeys(value, ["kind", "reason"])) return null;
+    if (typeof value.reason !== "string" || !UNAVAILABLE_REASONS.has(value.reason)) return null;
+    return { kind: "unavailable", reason: value.reason };
+  }
+  if (value.kind === "connecting") {
+    if (!hasExactKeys(value, ["kind", "step", "verificationCode", "progress"])) return null;
+    if (typeof value.step !== "string" || !CONNECTION_STEPS.has(value.step)) return null;
+    if (value.verificationCode !== null && !isBoundedString(value.verificationCode, AI_WIRE_LIMITS.verificationCodeCharacters, 1)) {
+      return null;
+    }
+    let progress = null;
+    if (value.progress !== null) {
+      progress = parseAiProgress(value.progress);
+      if (!progress) return null;
+    }
+    return {
+      kind: "connecting",
+      step: value.step,
+      verificationCode: value.verificationCode,
+      progress
+    };
+  }
+  if (value.kind === "ready") {
+    if (!hasExactKeys(value, ["kind", "provider", "model", "activeRequests"])) return null;
+    const provider = value.provider;
+    if (!isRecord2(provider)) return null;
+    if (!hasExactKeys(provider, ["name", "version", "mode"])) return null;
+    if (!isBoundedString(provider.name, HOST_WIRE_LIMITS.labelCharacters, 1)) return null;
+    if (provider.version !== null && !isBoundedString(provider.version, HOST_WIRE_LIMITS.labelCharacters)) {
+      return null;
+    }
+    if (typeof provider.mode !== "string" || !PROVIDER_MODES.has(provider.mode)) return null;
+    if (!isNonNegativeInteger(value.activeRequests, AI_WIRE_LIMITS.messageEntries)) return null;
+    let model = null;
+    if (value.model !== null) {
+      model = parseAiModelInfo(value.model);
+      if (!model) return null;
+    }
+    return {
+      kind: "ready",
+      provider: {
+        name: provider.name,
+        version: provider.version,
+        mode: provider.mode
+      },
+      model,
+      activeRequests: value.activeRequests
+    };
+  }
+  if (value.kind === "error") {
+    if (!hasExactKeys(value, ["kind", "error", "retryable"])) return null;
+    if (typeof value.retryable !== "boolean") return null;
+    const error = parseAiError(value.error);
+    return error ? { kind: "error", error, retryable: value.retryable } : null;
+  }
+  return null;
+}
+function parseAiPreferences(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["enabled", "model", "reviewMode"])) return null;
+  if (typeof value.enabled !== "boolean") return null;
+  if (value.model !== null && !isBoundedString(value.model, HOST_WIRE_LIMITS.identifierCharacters, 1)) {
+    return null;
+  }
+  if (typeof value.reviewMode !== "string" || !REVIEW_MODES.has(value.reviewMode)) return null;
+  return {
+    enabled: value.enabled,
+    model: value.model,
+    reviewMode: value.reviewMode
+  };
+}
+function parseAiPreferencesPatch(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasKeysWithin(value, [], ["enabled", "model", "reviewMode"])) return null;
+  const patch = {};
+  if (Object.prototype.hasOwnProperty.call(value, "enabled")) {
+    if (typeof value.enabled !== "boolean") return null;
+    patch.enabled = value.enabled;
+  }
+  if (Object.prototype.hasOwnProperty.call(value, "model")) {
+    if (value.model !== null && !isBoundedString(value.model, HOST_WIRE_LIMITS.identifierCharacters, 1)) {
+      return null;
+    }
+    patch.model = value.model;
+  }
+  if (Object.prototype.hasOwnProperty.call(value, "reviewMode")) {
+    if (typeof value.reviewMode !== "string" || !REVIEW_MODES.has(value.reviewMode)) return null;
+    patch.reviewMode = value.reviewMode;
+  }
+  return patch;
+}
+
+// src/host/speech-wire-policy.ts
+var SPEECH_WIRE_LIMITS = Object.freeze({
+  transcribeAudioBytes: 16 * 1024 * 1024,
+  promptCharacters: 2e3,
+  languageCharacters: 16,
+  transcriptCharacters: 64 * 1024,
+  segmentEntries: 4096,
+  synthesizeTextCharacters: 2e4,
+  chunkPcmBytes: 16 * 1024 * 1024,
+  chunkWordEntries: 1024,
+  minSampleRate: 8e3,
+  maxSampleRate: 96e3,
+  minSpeed: 0.5,
+  maxSpeed: 2,
+  modelEntries: 64,
+  voiceEntries: 256,
+  /** Seconds; a take or a chunk is never an hour long. */
+  durationCeiling: 3600,
+  downloadBytesCeiling: 8 * 1024 ** 3
+});
+var MODEL_ID = /^[a-z0-9][a-z0-9._-]{0,127}$/u;
+var LANGUAGE_TAG = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/u;
+var ERROR_CODES2 = /* @__PURE__ */ new Set([
+  "model-missing",
+  "model-download-failed",
+  "engine-unavailable",
+  "engine-failed",
+  "invalid-request",
+  "busy",
+  "timeout",
+  "cancelled",
+  "unknown"
+]);
+var READINESS_STATES = /* @__PURE__ */ new Set([
+  "ready",
+  "download-required",
+  "unavailable",
+  "permission-required"
+]);
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExactKeys2(value, keys) {
+  const actual = Object.keys(value);
+  return actual.length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function hasKeysWithin2(value, required, optional = []) {
+  const allowed = /* @__PURE__ */ new Set([...required, ...optional]);
+  for (const key of Object.keys(value)) {
+    if (!allowed.has(key)) return false;
+  }
+  return required.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function isFiniteInRange2(value, minimum, maximum) {
+  return typeof value === "number" && Number.isFinite(value) && value >= minimum && value <= maximum;
+}
+function isNonNegativeInteger2(value, maximum) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= maximum;
+}
+function isLabel(value) {
+  return isBoundedString(value, HOST_WIRE_LIMITS.labelCharacters);
+}
+function ownedBuffer(value, maximumBytes) {
+  if (value instanceof ArrayBuffer) {
+    return value.byteLength <= maximumBytes ? value.slice(0) : null;
+  }
+  if (ArrayBuffer.isView(value) && !(value instanceof DataView)) {
+    if (value.byteLength > maximumBytes) return null;
+    const copy = new Uint8Array(value.byteLength);
+    copy.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));
+    return copy.buffer;
+  }
+  return null;
+}
+function hasRiffWaveHeader(buffer) {
+  if (buffer.byteLength < 44) return false;
+  const bytes = new Uint8Array(buffer, 0, 12);
+  const tag = (offset) => String.fromCharCode(...bytes.subarray(offset, offset + 4));
+  return tag(0) === "RIFF" && tag(8) === "WAVE";
+}
+function isSpeechModelId(value) {
+  return typeof value === "string" && MODEL_ID.test(value);
+}
+function parseSpeechModelKind(value) {
+  return value === "stt" || value === "tts" ? value : null;
+}
+function parseSpeechTranscribeRequest(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(value, ["audio", "mimeType"], ["prompt", "language"])) return null;
+  if (value.mimeType !== "audio/wav") return null;
+  const audio = ownedBuffer(value.audio, SPEECH_WIRE_LIMITS.transcribeAudioBytes);
+  if (!audio || !hasRiffWaveHeader(audio)) return null;
+  if (value.prompt !== void 0 && !isBoundedString(value.prompt, SPEECH_WIRE_LIMITS.promptCharacters)) {
+    return null;
+  }
+  if (value.language !== void 0 && (!isBoundedString(value.language, SPEECH_WIRE_LIMITS.languageCharacters, 2) || !LANGUAGE_TAG.test(value.language))) {
+    return null;
+  }
+  return {
+    audio,
+    mimeType: "audio/wav",
+    ...value.prompt === void 0 ? {} : { prompt: value.prompt },
+    ...value.language === void 0 ? {} : { language: value.language }
+  };
+}
+function parseSpeechSynthesizeRequest(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(value, ["text"], ["voice", "speed"])) return null;
+  if (!isBoundedString(value.text, SPEECH_WIRE_LIMITS.synthesizeTextCharacters, 1)) return null;
+  if (value.voice !== void 0 && !isSpeechModelId(value.voice)) return null;
+  if (value.speed !== void 0 && !isFiniteInRange2(value.speed, SPEECH_WIRE_LIMITS.minSpeed, SPEECH_WIRE_LIMITS.maxSpeed)) {
+    return null;
+  }
+  return {
+    text: value.text,
+    ...value.voice === void 0 ? {} : { voice: value.voice },
+    ...value.speed === void 0 ? {} : { speed: value.speed }
+  };
+}
+function parseSpeechPreferencesPatch(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(value, [], ["sttModel", "voice", "speed"])) return null;
+  if (value.sttModel !== void 0 && value.sttModel !== null && !isSpeechModelId(value.sttModel))
+    return null;
+  if (value.voice !== void 0 && value.voice !== null && !isSpeechModelId(value.voice))
+    return null;
+  if (value.speed !== void 0 && !isFiniteInRange2(value.speed, SPEECH_WIRE_LIMITS.minSpeed, SPEECH_WIRE_LIMITS.maxSpeed)) {
+    return null;
+  }
+  return {
+    ...value.sttModel === void 0 ? {} : { sttModel: value.sttModel },
+    ...value.voice === void 0 ? {} : { voice: value.voice },
+    ...value.speed === void 0 ? {} : { speed: value.speed }
+  };
+}
+function parseSpeechError(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(value, ["code", "message"], ["detail"])) return null;
+  if (typeof value.code !== "string" || !ERROR_CODES2.has(value.code)) return null;
+  if (!isBoundedString(value.message, HOST_WIRE_LIMITS.messageCharacters)) return null;
+  if (value.detail !== void 0 && !isBoundedString(value.detail, HOST_WIRE_LIMITS.messageCharacters)) {
+    return null;
+  }
+  return {
+    code: value.code,
+    message: value.message,
+    ...value.detail === void 0 ? {} : { detail: value.detail }
+  };
+}
+function parseSpeechResult(value, parseValue) {
+  if (!isRecord3(value)) return null;
+  if (value.ok === true && hasExactKeys2(value, ["ok", "value"])) {
+    const parsed = parseValue(value.value);
+    return parsed === null ? null : { ok: true, value: parsed };
+  }
+  if (value.ok === false && hasExactKeys2(value, ["ok", "error"])) {
+    const error = parseSpeechError(value.error);
+    return error ? { ok: false, error } : null;
+  }
+  return null;
+}
+function parseSpeechNullResult(value) {
+  if (isRecord3(value) && value.ok === true && hasExactKeys2(value, ["ok", "value"])) {
+    return value.value === null ? { ok: true, value: null } : null;
+  }
+  return parseSpeechResult(value, () => null);
+}
+function parseSpeechReadiness(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(value, ["state"], ["reason", "model"])) return null;
+  if (typeof value.state !== "string" || !READINESS_STATES.has(value.state)) return null;
+  if (value.reason !== void 0 && !isBoundedString(value.reason, HOST_WIRE_LIMITS.messageCharacters)) {
+    return null;
+  }
+  if (value.model !== void 0 && !isSpeechModelId(value.model)) return null;
+  return {
+    state: value.state,
+    ...value.reason === void 0 ? {} : { reason: value.reason },
+    ...value.model === void 0 ? {} : { model: value.model }
+  };
+}
+function parseSpeechStatus(value) {
+  if (!isRecord3(value) || !hasExactKeys2(value, ["stt", "tts"])) return null;
+  const stt = parseSpeechReadiness(value.stt);
+  const tts = parseSpeechReadiness(value.tts);
+  return stt && tts ? { stt, tts } : null;
+}
+function parseHttpsUrl(value) {
+  if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return false;
+  try {
+    return new URL(value).protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function parseSpeechModelInfo(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(
+    value,
+    [
+      "id",
+      "kind",
+      "label",
+      "description",
+      "downloadBytes",
+      "installed",
+      "source",
+      "recommended",
+      "license",
+      "licenseUrl"
+    ],
+    ["updateRequired", "sharedStorage"]
+  )) {
+    return null;
+  }
+  const kind = parseSpeechModelKind(value.kind);
+  if (!isSpeechModelId(value.id) || !kind) return null;
+  if (!isLabel(value.label) || !isLabel(value.description) || !isLabel(value.license)) return null;
+  if (!isNonNegativeInteger2(value.downloadBytes, SPEECH_WIRE_LIMITS.downloadBytesCeiling))
+    return null;
+  if (typeof value.installed !== "boolean" || typeof value.recommended !== "boolean") return null;
+  if (value.sharedStorage !== void 0 && typeof value.sharedStorage !== "boolean") return null;
+  if (value.source !== "app" && value.source !== "shared" && value.source !== null) return null;
+  if (value.installed !== (value.source !== null)) return null;
+  if (value.sharedStorage === true && value.source !== "app") return null;
+  if ("updateRequired" in value && typeof value.updateRequired !== "boolean") return null;
+  if (value.updateRequired === true && value.installed) return null;
+  if (!parseHttpsUrl(value.licenseUrl)) return null;
+  return {
+    id: value.id,
+    kind,
+    label: value.label,
+    description: value.description,
+    downloadBytes: value.downloadBytes,
+    installed: value.installed,
+    ...typeof value.updateRequired === "boolean" ? { updateRequired: value.updateRequired } : {},
+    source: value.source,
+    ...value.sharedStorage !== void 0 ? { sharedStorage: value.sharedStorage } : {},
+    recommended: value.recommended,
+    license: value.license,
+    licenseUrl: value.licenseUrl
+  };
+}
+function parseSpeechVoiceInfo(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasExactKeys2(value, ["id", "label", "language", "gender", "modelId"])) return null;
+  if (!isSpeechModelId(value.id) || !isSpeechModelId(value.modelId)) return null;
+  if (!isLabel(value.label)) return null;
+  if (typeof value.language !== "string" || !LANGUAGE_TAG.test(value.language)) return null;
+  if (value.gender !== "female" && value.gender !== "male" && value.gender !== null) return null;
+  return {
+    id: value.id,
+    label: value.label,
+    language: value.language,
+    gender: value.gender,
+    modelId: value.modelId
+  };
+}
+function parseSpeechCatalog(value) {
+  if (!isRecord3(value) || !hasExactKeys2(value, ["models", "voices"])) return null;
+  if (!Array.isArray(value.models) || value.models.length > SPEECH_WIRE_LIMITS.modelEntries)
+    return null;
+  if (!Array.isArray(value.voices) || value.voices.length > SPEECH_WIRE_LIMITS.voiceEntries)
+    return null;
+  const models = [];
+  for (const entry of value.models) {
+    const model = parseSpeechModelInfo(entry);
+    if (!model) return null;
+    models.push(model);
+  }
+  const voices = [];
+  for (const entry of value.voices) {
+    const voice = parseSpeechVoiceInfo(entry);
+    if (!voice) return null;
+    voices.push(voice);
+  }
+  return { models, voices };
+}
+function parseSpeechProgress(value) {
+  if (!isRecord3(value) || !hasExactKeys2(value, ["phase", "receivedBytes", "totalBytes"]))
+    return null;
+  if (value.phase !== "downloading" && value.phase !== "verifying") return null;
+  if (!isNonNegativeInteger2(value.receivedBytes, SPEECH_WIRE_LIMITS.downloadBytesCeiling))
+    return null;
+  if (value.totalBytes !== null && !isNonNegativeInteger2(value.totalBytes, SPEECH_WIRE_LIMITS.downloadBytesCeiling)) {
+    return null;
+  }
+  return {
+    phase: value.phase,
+    receivedBytes: value.receivedBytes,
+    totalBytes: value.totalBytes
+  };
+}
+function parseSpeechInstallEvent(value) {
+  if (!isRecord3(value)) return null;
+  if (value.kind === "progress" && hasExactKeys2(value, ["kind", "progress"])) {
+    const progress = parseSpeechProgress(value.progress);
+    return progress ? { kind: "progress", progress } : null;
+  }
+  if (value.kind === "done" && hasExactKeys2(value, ["kind", "model"])) {
+    const model = parseSpeechModelInfo(value.model);
+    return model ? { kind: "done", model } : null;
+  }
+  if (value.kind === "error" && hasExactKeys2(value, ["kind", "error"])) {
+    const error = parseSpeechError(value.error);
+    return error ? { kind: "error", error } : null;
+  }
+  return null;
+}
+function parseSpeechPreferences(value) {
+  if (!isRecord3(value) || !hasExactKeys2(value, ["sttModel", "voice", "speed"])) return null;
+  const patch = parseSpeechPreferencesPatch(value);
+  if (!patch || patch.speed === void 0) return null;
+  return {
+    sttModel: patch.sttModel ?? null,
+    voice: patch.voice ?? null,
+    speed: patch.speed
+  };
+}
+function parseSpeechSegment(value) {
+  if (!isRecord3(value) || !hasExactKeys2(value, ["start", "end", "text"])) return null;
+  if (!isFiniteInRange2(value.start, 0, SPEECH_WIRE_LIMITS.durationCeiling)) return null;
+  if (!isFiniteInRange2(value.end, value.start, SPEECH_WIRE_LIMITS.durationCeiling)) return null;
+  if (!isBoundedString(value.text, SPEECH_WIRE_LIMITS.transcriptCharacters)) return null;
+  return { start: value.start, end: value.end, text: value.text };
+}
+function parseSpeechTranscript(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasExactKeys2(value, ["text", "language", "segments", "durationMs"])) return null;
+  if (!isBoundedString(value.text, SPEECH_WIRE_LIMITS.transcriptCharacters)) return null;
+  if (value.language !== null && (typeof value.language !== "string" || !LANGUAGE_TAG.test(value.language))) {
+    return null;
+  }
+  if (!Array.isArray(value.segments) || value.segments.length > SPEECH_WIRE_LIMITS.segmentEntries)
+    return null;
+  if (!isFiniteInRange2(value.durationMs, 0, SPEECH_WIRE_LIMITS.durationCeiling * 1e3)) return null;
+  const segments = [];
+  for (const entry of value.segments) {
+    const segment = parseSpeechSegment(entry);
+    if (!segment) return null;
+    segments.push(segment);
+  }
+  return {
+    text: value.text,
+    language: value.language,
+    segments,
+    durationMs: value.durationMs
+  };
+}
+function parseSpeechAudioChunk(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasKeysWithin2(
+    value,
+    ["index", "pcm", "sampleRate", "durationSec", "textStart", "textEnd"],
+    ["wordTimings"]
+  )) {
+    return null;
+  }
+  if (!isNonNegativeInteger2(value.index, Number.MAX_SAFE_INTEGER)) return null;
+  const pcm = ownedBuffer(value.pcm, SPEECH_WIRE_LIMITS.chunkPcmBytes);
+  if (!pcm || pcm.byteLength % Float32Array.BYTES_PER_ELEMENT !== 0) return null;
+  if (!isNonNegativeInteger2(value.sampleRate, SPEECH_WIRE_LIMITS.maxSampleRate) || value.sampleRate < SPEECH_WIRE_LIMITS.minSampleRate) {
+    return null;
+  }
+  if (!isFiniteInRange2(value.durationSec, 0, SPEECH_WIRE_LIMITS.durationCeiling)) return null;
+  const textCeiling = SPEECH_WIRE_LIMITS.synthesizeTextCharacters;
+  if (!isNonNegativeInteger2(value.textStart, textCeiling)) return null;
+  if (!isNonNegativeInteger2(value.textEnd, textCeiling) || value.textEnd < value.textStart)
+    return null;
+  const wordTimings = [];
+  if ("wordTimings" in value) {
+    if (!Array.isArray(value.wordTimings) || value.wordTimings.length > SPEECH_WIRE_LIMITS.chunkWordEntries)
+      return null;
+    let previousEnd = 0;
+    let previousTextStart = value.textStart;
+    let previousTextEnd = value.textStart;
+    for (const word of value.wordTimings) {
+      if (!isRecord3(word) || !hasExactKeys2(word, ["textStart", "textEnd", "startSec", "endSec"]))
+        return null;
+      if (!isNonNegativeInteger2(word.textStart, value.textEnd) || word.textStart < previousTextStart)
+        return null;
+      if (!isNonNegativeInteger2(word.textEnd, value.textEnd) || word.textEnd <= word.textStart || word.textEnd < previousTextEnd)
+        return null;
+      if (!isFiniteInRange2(word.startSec, previousEnd, value.durationSec) || !isFiniteInRange2(word.endSec, word.startSec, value.durationSec) || word.endSec === word.startSec)
+        return null;
+      wordTimings.push({
+        textStart: word.textStart,
+        textEnd: word.textEnd,
+        startSec: word.startSec,
+        endSec: word.endSec
+      });
+      previousEnd = word.endSec;
+      previousTextStart = word.textStart;
+      previousTextEnd = word.textEnd;
+    }
+  }
+  return {
+    index: value.index,
+    pcm,
+    sampleRate: value.sampleRate,
+    durationSec: value.durationSec,
+    textStart: value.textStart,
+    textEnd: value.textEnd,
+    ..."wordTimings" in value ? { wordTimings } : {}
+  };
+}
+function parseSpeechSynthesisSummary(value) {
+  if (!isRecord3(value)) return null;
+  if (!hasExactKeys2(value, ["voice", "model", "sampleRate", "durationSec", "chunks"])) return null;
+  if (!isSpeechModelId(value.voice) || !isSpeechModelId(value.model)) return null;
+  if (!isNonNegativeInteger2(value.sampleRate, SPEECH_WIRE_LIMITS.maxSampleRate) || value.sampleRate < SPEECH_WIRE_LIMITS.minSampleRate) {
+    return null;
+  }
+  if (!isFiniteInRange2(value.durationSec, 0, SPEECH_WIRE_LIMITS.durationCeiling * 24)) return null;
+  if (!isNonNegativeInteger2(value.chunks, Number.MAX_SAFE_INTEGER)) return null;
+  return {
+    voice: value.voice,
+    model: value.model,
+    sampleRate: value.sampleRate,
+    durationSec: value.durationSec,
+    chunks: value.chunks
+  };
+}
+function parseSpeechSynthesizeEvent(value) {
+  if (!isRecord3(value)) return null;
+  if (value.kind === "progress" && hasExactKeys2(value, ["kind", "phase", "completedCharacters", "totalCharacters"])) {
+    if (value.phase !== "loading" && value.phase !== "synthesizing") return null;
+    const ceiling = SPEECH_WIRE_LIMITS.synthesizeTextCharacters;
+    if (!isNonNegativeInteger2(value.totalCharacters, ceiling)) return null;
+    if (!isNonNegativeInteger2(value.completedCharacters, value.totalCharacters)) return null;
+    return {
+      kind: "progress",
+      phase: value.phase,
+      completedCharacters: value.completedCharacters,
+      totalCharacters: value.totalCharacters
+    };
+  }
+  if (value.kind === "chunk" && hasExactKeys2(value, ["kind", "chunk"])) {
+    const chunk = parseSpeechAudioChunk(value.chunk);
+    return chunk ? { kind: "chunk", chunk } : null;
+  }
+  if (value.kind === "done" && hasExactKeys2(value, ["kind", "summary"])) {
+    const summary = parseSpeechSynthesisSummary(value.summary);
+    return summary ? { kind: "done", summary } : null;
+  }
+  if (value.kind === "error" && hasExactKeys2(value, ["kind", "error"])) {
+    const error = parseSpeechError(value.error);
+    return error ? { kind: "error", error } : null;
+  }
+  return null;
+}
+
+// src/host/filesystem-v2.ts
+var FILE_SYSTEM_TRANSFER_LIMITS = Object.freeze({
+  fileBytes: 1024 * 1024 * 1024,
+  chunkBytes: 4 * 1024 * 1024,
+  totalBytes: 2 * 1024 * 1024 * 1024,
+  transfers: 4,
+  idleMs: 12e4,
+  lifetimeMs: 15 * 6e4
+});
+var ELECTRON_FILE_SYSTEM_V2_CAPABILITIES = Object.freeze({
+  writeAtomicity: "process",
+  moveAtomicity: "process",
+  snapshotAtomicity: "process",
+  conditionalWrite: "process",
+  recursiveRemove: true,
+  watch: true,
+  caseSensitivity: "platform",
+  symlinkPolicy: "follow-contained",
+  durability: "best-effort"
+});
+
+// src/host/ai-knowledge.ts
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function exact(value, keys) {
+  return Object.keys(value).length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+var label = (value) => isBoundedString(value, HOST_WIRE_LIMITS.labelCharacters, 1);
+var message = (value) => value === null || isBoundedString(value, HOST_WIRE_LIMITS.messageCharacters);
+var count = (value) => value === null || typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+function parseAiKnowledgeAction(value) {
+  if (!record(value)) return null;
+  if (value.action === "improve" && exact(value, ["action"])) return { action: value.action };
+  if (!exact(value, ["action", "catalogId"]) || !label(value.catalogId)) return null;
+  switch (value.action) {
+    case "install":
+    case "remove":
+    case "enable":
+    case "disable":
+    case "cancel":
+      return { action: value.action, catalogId: value.catalogId };
+    default:
+      return null;
+  }
+}
+function parseAiKnowledgeState(value) {
+  if (!record(value) || !exact(value, ["catalogs", "improvement"]) || !Array.isArray(value.catalogs) || value.catalogs.length > 512)
+    return null;
+  let improvement = null;
+  if (value.improvement !== null) {
+    const raw = value.improvement;
+    if (!record(raw) || !exact(raw, ["downloadBytes", "downloading"]) || typeof raw.downloadBytes !== "number" || !count(raw.downloadBytes) || typeof raw.downloading !== "boolean")
+      return null;
+    improvement = { downloadBytes: raw.downloadBytes, downloading: raw.downloading };
+  }
+  const catalogs = [];
+  const ids = /* @__PURE__ */ new Set();
+  for (const raw of value.catalogs) {
+    if (!record(raw) || !exact(raw, [
+      "id",
+      "name",
+      "description",
+      "version",
+      "installedVersion",
+      "enabled",
+      "updateAvailable",
+      "downloadBytes",
+      "documents",
+      "state",
+      "percent",
+      "message"
+    ]))
+      return null;
+    if (!label(raw.id) || ids.has(raw.id) || !label(raw.name) || !isBoundedString(raw.description, HOST_WIRE_LIMITS.messageCharacters) || !label(raw.version) || !(raw.installedVersion === null || label(raw.installedVersion)) || typeof raw.enabled !== "boolean" || typeof raw.updateAvailable !== "boolean" || !count(raw.downloadBytes) || !count(raw.documents) || !message(raw.message))
+      return null;
+    if (raw.state !== "available" && raw.state !== "installed" && raw.state !== "downloading" && raw.state !== "error")
+      return null;
+    if (raw.percent !== null && !(typeof raw.percent === "number" && Number.isFinite(raw.percent) && raw.percent >= 0 && raw.percent <= 100))
+      return null;
+    ids.add(raw.id);
+    catalogs.push({
+      id: raw.id,
+      name: raw.name,
+      description: raw.description,
+      version: raw.version,
+      installedVersion: raw.installedVersion,
+      enabled: raw.enabled,
+      updateAvailable: raw.updateAvailable,
+      downloadBytes: raw.downloadBytes,
+      documents: raw.documents,
+      state: raw.state,
+      percent: raw.percent,
+      message: raw.message
+    });
+  }
+  return { catalogs, improvement };
+}
+
+// src/host/index.ts
+function rawHost() {
+  if (typeof globalThis === "undefined") return null;
+  return globalThis.docBlocksHost ?? null;
+}
+function hasDocBlocksHost() {
+  return deriveHostCapabilities(rawHost()) !== NO_HOST_CAPABILITIES;
+}
+function getHostCapabilities() {
+  return deriveHostCapabilities(rawHost());
+}
+function hostSupports(capability) {
+  return getHostCapabilities()[capability];
+}
+function getHostEnvironment() {
+  const host = rawHost();
+  if (typeof host !== "object" || host === null) return null;
+  return parseHostEnvironment(host.env);
+}
+function isElectronHost() {
+  return getHostEnvironment()?.surface === "electron";
+}
+function getDocBlocksHost() {
+  const host = globalThis.docBlocksHost;
+  if (!host) {
+    throw new Error("docBlocksHost is not available \u2014 not running under Electron?");
+  }
+  return host;
+}
+function maybeGetDocBlocksHost() {
+  return globalThis.docBlocksHost ?? null;
+}
+
+export {
+  HOST_SURFACE_KINDS,
+  HOST_PLATFORMS,
+  NO_HOST_CAPABILITIES,
+  parseHostEnvironment,
+  deriveHostCapabilities,
+  AI_WIRE_LIMITS,
+  parseAiError,
+  parseAiProgress,
+  parseAiModelInfo,
+  parseAiModelInfoList,
+  parseAiModelDownloadInfo,
+  parseAiModelDownloadInfoList,
+  parseAiModelInstallEvent,
+  parseAiChatRequest,
+  parseAiChatProgress,
+  parseAiChatEvent,
+  parseAiStatus,
+  parseAiPreferences,
+  parseAiPreferencesPatch,
+  SPEECH_WIRE_LIMITS,
+  isSpeechModelId,
+  parseSpeechModelKind,
+  parseSpeechTranscribeRequest,
+  parseSpeechSynthesizeRequest,
+  parseSpeechPreferencesPatch,
+  parseSpeechError,
+  parseSpeechResult,
+  parseSpeechNullResult,
+  parseSpeechReadiness,
+  parseSpeechStatus,
+  parseSpeechModelInfo,
+  parseSpeechVoiceInfo,
+  parseSpeechCatalog,
+  parseSpeechProgress,
+  parseSpeechInstallEvent,
+  parseSpeechPreferences,
+  parseSpeechTranscript,
+  parseSpeechAudioChunk,
+  parseSpeechSynthesisSummary,
+  parseSpeechSynthesizeEvent,
+  FILE_SYSTEM_TRANSFER_LIMITS,
+  ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  parseAiKnowledgeAction,
+  parseAiKnowledgeState,
+  hasDocBlocksHost,
+  getHostCapabilities,
+  hostSupports,
+  getHostEnvironment,
+  isElectronHost,
+  getDocBlocksHost,
+  maybeGetDocBlocksHost
+};