@klarkxy/dsh-current-title 0.1.0

package/lib/client.js

@@ -0,0 +1,625 @@
+function __createDshNodeShims() {
+  class EventEmitter {
+    constructor() {
+      this._e = Object.create(null)
+    }
+    on(type, fn) {
+      (this._e[type] ||= []).push(fn)
+      return this
+    }
+    addListener(type, fn) {
+      return this.on(type, fn)
+    }
+    once(type, fn) {
+      const wrap = (...args) => {
+        this.off(type, wrap)
+        fn(...args)
+      }
+      return this.on(type, wrap)
+    }
+    off(type, fn) {
+      const list = this._e[type]
+      if (list) this._e[type] = list.filter((item) => item !== fn)
+      return this
+    }
+    removeListener(type, fn) {
+      return this.off(type, fn)
+    }
+    emit(type, ...args) {
+      const list = this._e[type]
+      if (!list) return false
+      for (const fn of list.slice()) fn(...args)
+      return true
+    }
+    removeAllListeners(type) {
+      if (type) delete this._e[type]
+      else this._e = Object.create(null)
+      return this
+    }
+    listeners(type) {
+      return (this._e[type] || []).slice()
+    }
+    setMaxListeners() {
+      return this
+    }
+  }
+
+  class Buffer extends Uint8Array {
+    static from(value, encodingOrOffset, length) {
+      if (typeof value === 'string') return new Buffer(new TextEncoder().encode(value))
+      if (value instanceof ArrayBuffer) return new Buffer(new Uint8Array(value, encodingOrOffset, length))
+      if (ArrayBuffer.isView(value)) return new Buffer(new Uint8Array(value.buffer, value.byteOffset, value.byteLength))
+      if (Array.isArray(value) || value && typeof value.length === 'number') return new Buffer(Uint8Array.from(value))
+      return new Buffer(0)
+    }
+    static alloc(size, fill) {
+      const buf = new Buffer(size)
+      if (fill !== undefined && fill !== 0) {
+        if (typeof fill === 'string') {
+          const bytes = new TextEncoder().encode(fill)
+          for (let i = 0; i < size; i += 1) buf[i] = bytes[i % bytes.length]
+        } else buf.fill(fill)
+      }
+      return buf
+    }
+    static allocUnsafe(size) {
+      return new Buffer(size)
+    }
+    static allocUnsafeSlow(size) {
+      return new Buffer(size)
+    }
+    static concat(list, totalLength) {
+      const length = totalLength ?? list.reduce((sum, item) => sum + item.length, 0)
+      const out = new Buffer(length)
+      let offset = 0
+      for (const item of list) {
+        out.set(item, offset)
+        offset += item.length
+      }
+      return out
+    }
+    static isBuffer(value) {
+      return value instanceof Buffer
+    }
+    static byteLength(value) {
+      if (typeof value === 'string') return new TextEncoder().encode(value).length
+      return value?.byteLength ?? value?.length ?? 0
+    }
+    static isEncoding(encoding) {
+      return /^(utf8|utf-8|ascii|latin1|binary|hex|base64|base64url)$/i.test(String(encoding || ''))
+    }
+    toString(encoding) {
+      if (encoding === 'hex') return [...this].map((byte) => byte.toString(16).padStart(2, '0')).join('')
+      if (encoding === 'base64') {
+        let binary = ''
+        this.forEach((byte) => {
+          binary += String.fromCharCode(byte)
+        })
+        return btoa(binary)
+      }
+      return new TextDecoder().decode(this)
+    }
+    slice(start, end) {
+      return Buffer.from(super.subarray(start, end))
+    }
+    copy(target, targetStart = 0, start = 0, end = this.length) {
+      const sliced = this.subarray(start, end)
+      target.set(sliced, targetStart)
+      return sliced.length
+    }
+    write(string, offset = 0) {
+      const bytes = new TextEncoder().encode(string)
+      const written = Math.min(bytes.length, this.length - offset)
+      this.set(bytes.subarray(0, written), offset)
+      return written
+    }
+  }
+
+  function inherits(ctor, superCtor) {
+    ctor.super_ = superCtor
+    ctor.prototype = Object.create(superCtor.prototype, {
+      constructor: { value: ctor, writable: true, configurable: true },
+    })
+  }
+
+  if (!globalThis.Buffer) globalThis.Buffer = Buffer
+
+  return {
+    buffer: { Buffer, SlowBuffer: Buffer, INSPECT_MAX_BYTES: 50, kMaxLength: 0x7fffffff },
+    stream: {
+      Stream: EventEmitter,
+      Readable: EventEmitter,
+      Writable: EventEmitter,
+      Duplex: EventEmitter,
+      Transform: EventEmitter,
+      PassThrough: EventEmitter,
+    },
+    events: { EventEmitter },
+    util: {
+      deprecate(fn) {
+        return fn
+      },
+      inherits,
+      inspect() {
+        return ''
+      },
+      format(value) {
+        return String(value)
+      },
+      types: { isBuffer: Buffer.isBuffer },
+    },
+  }
+}
+
+window.__ModuleLoader__.load({
+  id: "@klarkxy/dsh-current-title",
+  factory: (dshRequire) => {
+    var __nodeShims;
+    var process = globalThis.process || { env: {}, nextTick: function (fn) { var args = [].slice.call(arguments, 1); queueMicrotask(function () { fn.apply(null, args); }); } };
+    var require = function (id) {
+      if (id === 'buffer' || id === 'stream' || id === 'util' || id === 'events') {
+        if (!__nodeShims) __nodeShims = __createDshNodeShims();
+        return __nodeShims[id];
+      }
+      return dshRequire(id);
+    };
+    var module = { exports: {} };
+    var exports = module.exports;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region ../dsh-ai-services/src/client-utils.ts
+/** The Editor retains its manuscript session separately; native DSH exposes the main-view binding. */
+function selectedSessionId(client) {
+	return client.uiWorkspace.current ? client.uiWorkspace.current.getSnapshot()?.sessionId ?? "" : client.uiSession.adapter.current.getSnapshot().key ?? "";
+}
+/** Owner props win; native settings only supplies close, so resolve its selected session. */
+function useNativeSeat(client, props) {
+	const current = (0, react.useSyncExternalStore)((0, react.useCallback)((fn) => (client.uiWorkspace.current ?? client.uiSession.adapter.current).subscribe(fn), [client]), (0, react.useCallback)(() => selectedSessionId(client), [client]), () => "");
+	const language = (0, react.useSyncExternalStore)((0, react.useCallback)((fn) => client.locale.subscribe(fn), [client]), (0, react.useCallback)(() => client.locale.getSnapshot().active, [client]), () => "en");
+	const row = props && typeof props === "object" ? props : {};
+	const owner = row.owner && typeof row.owner === "object" ? row.owner : {};
+	const sessionId = typeof row.sessionId === "string" ? row.sessionId : typeof owner.sessionId === "string" ? owner.sessionId : current;
+	const requestedLocale = row.locale ?? owner.locale ?? language;
+	return {
+		sessionId,
+		locale: String(requestedLocale).startsWith("zh") ? "zh" : "en",
+		hidden: row.hidden === true || owner.hidden === true
+	};
+}
+/** Refresh on native log boundaries/reconnect/focus. Read-only settling is bounded to an observed job. */
+function useFeatureRefresh(client, sessionId, refresh, working = false, enabled = true) {
+	const refreshRef = (0, react.useRef)(refresh);
+	refreshRef.current = refresh;
+	(0, react.useEffect)(() => {
+		if (!enabled) return;
+		let timer;
+		const queue = () => {
+			if (typeof document !== "undefined" && document.visibilityState === "hidden") return;
+			clearTimeout(timer);
+			timer = setTimeout(() => refreshRef.current(), 150);
+		};
+		const stopEvents = (sessionId ? client.sessions.binding?.(sessionId)?.eventSource : void 0)?.subscribe(queue);
+		const stopConnection = client.connection?.generation?.subscribe(queue);
+		const visibility = () => {
+			if (document.visibilityState === "visible") queue();
+		};
+		window.addEventListener("focus", queue);
+		document.addEventListener("visibilitychange", visibility);
+		document.addEventListener("toggle", queue, true);
+		return () => {
+			clearTimeout(timer);
+			stopEvents?.();
+			stopConnection?.();
+			window.removeEventListener("focus", queue);
+			document.removeEventListener("visibilitychange", visibility);
+			document.removeEventListener("toggle", queue, true);
+		};
+	}, [
+		client,
+		sessionId,
+		enabled
+	]);
+	(0, react.useEffect)(() => {
+		if (!enabled || !working) return;
+		let delay = 250;
+		const until = Date.now() + 3e5;
+		let timer;
+		const tick = () => {
+			if (Date.now() >= until) return;
+			if (document.visibilityState !== "hidden") refreshRef.current();
+			delay = Math.min(delay * 2, 2e3);
+			timer = setTimeout(tick, delay);
+		};
+		timer = setTimeout(tick, delay);
+		return () => clearTimeout(timer);
+	}, [
+		client,
+		sessionId,
+		working,
+		enabled
+	]);
+}
+//#endregion
+//#region src/contracts.ts
+const RPC_CHANNEL = "/dsh-current-title";
+const TITLE_CLIENT_SERVICE = "dshCurrentTitleClient";
+//#endregion
+//#region src/client-work.ts
+const titleCopy = {
+	zh: {
+		label: "当前标题",
+		pinned: "已手动命名",
+		generating: "正在生成标题…",
+		regenerate: "重新生成",
+		locale: "类型标签语言",
+		auto: "自动",
+		saved: "已保存。",
+		failed: "无法读取标题设置。"
+	},
+	en: {
+		label: "Current title",
+		pinned: "Renamed manually",
+		generating: "Generating title…",
+		regenerate: "Regenerate",
+		locale: "Type-label language",
+		auto: "Auto",
+		saved: "Saved.",
+		failed: "Could not read title settings."
+	}
+};
+function shouldSkipTitleRefresh(input) {
+	return input.busy;
+}
+function createTitleClientWork() {
+	let generation = 0;
+	let request = 0;
+	let disposed = false;
+	return {
+		get disposed() {
+			return disposed;
+		},
+		beginLoad() {
+			generation += 1;
+			request += 1;
+			return generation;
+		},
+		captureLoad() {
+			return generation;
+		},
+		beginRequest() {
+			request += 1;
+			return {
+				generation,
+				request
+			};
+		},
+		isLoad(generationToken) {
+			return !disposed && generation === generationToken;
+		},
+		isRequest(token) {
+			return !disposed && generation === token.generation && request === token.request;
+		},
+		dispose() {
+			disposed = true;
+			generation += 1;
+			request += 1;
+		}
+	};
+}
+function unwrap(result) {
+	if (!result.ok) throw new Error(result.error.message);
+	return result.value;
+}
+async function invoke(call, endpoint, payload) {
+	return unwrap(await call(endpoint, payload));
+}
+async function runTitleStatusLoad(input) {
+	try {
+		const status = await invoke(input.call, "status", input.sessionId ? { sessionId: input.sessionId } : {});
+		if (!input.isCurrent()) return;
+		input.onStatus(status);
+		input.onMarker(status);
+	} catch {
+		if (!input.isCurrent()) return;
+		input.onMarker(void 0);
+		input.onError(input.failedMessage);
+	}
+}
+async function runTitleRegenerateFlow(input) {
+	if (!input.sessionId || !input.isCurrent()) return;
+	input.onBusy(true);
+	try {
+		await invoke(input.call, "regenerate", { sessionId: input.sessionId });
+		if (!input.isCurrent()) return;
+		const status = await invoke(input.call, "status", { sessionId: input.sessionId });
+		if (!input.isCurrent()) return;
+		input.onStatus(status);
+		input.onMarker(status);
+	} catch (cause) {
+		if (!input.isCurrent()) return;
+		input.onError(cause instanceof Error ? cause.message : input.failedMessage);
+	} finally {
+		if (!input.isCurrent()) return;
+		input.onBusy(false);
+	}
+}
+async function runTitleSettingsSave(input) {
+	input.onBusy(true);
+	try {
+		const settings = await invoke(input.call, "settings", {
+			locale: input.locale,
+			expectedRevision: input.expectedRevision
+		});
+		if (!input.isCurrent()) return;
+		input.onSettings(settings);
+		input.onNote(input.savedMessage);
+	} catch (cause) {
+		if (!input.isCurrent()) return;
+		input.onError(cause instanceof Error ? cause.message : input.failedMessage);
+	} finally {
+		if (!input.isCurrent()) return;
+		input.onBusy(false);
+	}
+}
+//#endregion
+//#region src/marker.ts
+function createTitleClientMarker() {
+	return { active: false };
+}
+function applyMarkerFromStatus(marker, status, live) {
+	if (!live) return;
+	marker.active = status?.support.weOwn === true;
+}
+function disposeTitleClientMarker(marker) {
+	marker.active = false;
+}
+//#endregion
+//#region src/client.tsx
+const name = "dsh-current-title-client";
+const inject = [
+	"slots",
+	"connection",
+	"sessions",
+	"locale",
+	"uiWorkspace",
+	"uiSession"
+];
+function TitleSettings(props) {
+	const seat = useNativeSeat(props.client, props.owner);
+	const sessionId = seat.sessionId;
+	const text = titleCopy[seat.locale];
+	const [status, setStatus] = (0, react.useState)();
+	const [busy, setBusy] = (0, react.useState)(false);
+	const [note, setNote] = (0, react.useState)("");
+	const [error, setError] = (0, react.useState)("");
+	const workRef = (0, react.useRef)(void 0);
+	if (!workRef.current) workRef.current = createTitleClientWork();
+	const work = workRef.current;
+	const busyRef = (0, react.useRef)(busy);
+	busyRef.current = busy;
+	const call = (endpoint, payload = {}) => props.client.connection.rpc.call(RPC_CHANNEL, endpoint, payload);
+	function commitMarker(next) {
+		applyMarkerFromStatus(props.marker, next, true);
+	}
+	(0, react.useEffect)(() => () => {
+		work.dispose();
+	}, [work]);
+	(0, react.useEffect)(() => {
+		const generation = work.beginLoad();
+		const isCurrent = () => work.isLoad(generation);
+		setBusy(false);
+		setError("");
+		setNote("");
+		runTitleStatusLoad({
+			call,
+			sessionId: sessionId || void 0,
+			isCurrent,
+			failedMessage: text.failed,
+			onStatus: setStatus,
+			onError: setError,
+			onMarker: commitMarker
+		});
+		return () => {
+			if (work.isLoad(generation)) work.beginLoad();
+		};
+	}, [
+		props.client,
+		props.marker,
+		sessionId,
+		text.failed,
+		work
+	]);
+	const refreshStatus = (0, react.useCallback)(() => {
+		if (shouldSkipTitleRefresh({ busy: busyRef.current }) || work.disposed) return;
+		const generation = work.captureLoad();
+		runTitleStatusLoad({
+			call,
+			sessionId: sessionId || void 0,
+			isCurrent: () => work.isLoad(generation) && !shouldSkipTitleRefresh({ busy: busyRef.current }),
+			failedMessage: text.failed,
+			onStatus: (next) => {
+				if (shouldSkipTitleRefresh({ busy: busyRef.current })) return;
+				setStatus(next);
+			},
+			onError: () => {},
+			onMarker: (next) => {
+				if (shouldSkipTitleRefresh({ busy: busyRef.current })) return;
+				commitMarker(next);
+			}
+		});
+	}, [
+		props.client,
+		props.marker,
+		sessionId,
+		text.failed,
+		work
+	]);
+	useFeatureRefresh(props.client, sessionId, refreshStatus, status?.session?.generating === true && !busy, Boolean(sessionId));
+	const locale = status?.settings.locale ?? "auto";
+	const modes = [
+		{
+			id: "auto",
+			label: text.auto
+		},
+		{
+			id: "zh",
+			label: "中文"
+		},
+		{
+			id: "en",
+			label: "English"
+		}
+	];
+	const title = status?.session?.title;
+	const pinned = status?.session?.pinned === true;
+	const weOwn = status?.support.weOwn === true;
+	const canRegenerate = Boolean(sessionId) && weOwn && !busy;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "current-title-settings",
+		"data-testid": "current-title-settings",
+		children: [
+			!status && !error ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "status",
+				children: seat.locale === "en" ? "Loading title settings…" : "正在读取标题设置…"
+			}) : null,
+			title ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				translate: "no",
+				children: title
+			}) : null,
+			pinned ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "current-title-meta",
+				children: text.pinned
+			}) : null,
+			status?.session?.generating ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "status",
+				children: text.generating
+			}) : null,
+			error ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "alert",
+				children: error
+			}) : null,
+			note ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				role: "status",
+				children: note
+			}) : null,
+			sessionId ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				disabled: !canRegenerate,
+				"aria-label": text.regenerate,
+				onClick: () => {
+					if (!sessionId) return;
+					const token = work.beginRequest();
+					setError("");
+					setNote("");
+					runTitleRegenerateFlow({
+						call,
+						sessionId,
+						isCurrent: () => work.isRequest(token),
+						failedMessage: text.failed,
+						onBusy: setBusy,
+						onStatus: setStatus,
+						onError: setError,
+						onMarker: commitMarker
+					});
+				},
+				children: text.regenerate
+			}) : null,
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("fieldset", {
+				disabled: busy || !status,
+				"aria-label": text.locale,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("legend", { children: text.locale }), modes.map((mode) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					type: "radio",
+					name: "current-title-locale",
+					value: mode.id,
+					checked: locale === mode.id,
+					onChange: () => {
+						if (!status) return;
+						const token = work.beginRequest();
+						setError("");
+						setNote("");
+						runTitleSettingsSave({
+							call,
+							locale: mode.id,
+							expectedRevision: status.settings.revision,
+							isCurrent: () => work.isRequest(token),
+							savedMessage: text.saved,
+							failedMessage: text.failed,
+							onBusy: setBusy,
+							onSettings: (settings) => setStatus({
+								...status,
+								settings
+							}),
+							onNote: setNote,
+							onError: setError
+						});
+					}
+				}), mode.label] }, mode.id))]
+			})
+		]
+	});
+}
+const styles = `
+.current-title-settings{display:grid;gap:8px;color:inherit;font:400 var(--font-size-2,14px)/1.5 var(--default-font-family,system-ui,sans-serif)}
+.current-title-settings p{margin:0}
+.current-title-settings p[translate="no"]{overflow-wrap:anywhere}
+.current-title-meta{font-size:var(--font-size-1,13px);color:var(--gray-11,inherit)}
+.current-title-settings button{min-height:34px;padding:6px 12px;border:1px solid color-mix(in srgb,currentColor 25%,transparent);border-radius:8px;background:transparent;color:inherit;cursor:pointer;font:inherit;justify-self:start;transition:background-color 150ms ease,color 150ms ease,border-color 150ms ease,box-shadow 150ms ease,transform 150ms ease}
+.current-title-settings button:hover:not(:disabled){background:var(--gray-3,color-mix(in srgb,currentColor 6%,transparent));border-color:color-mix(in srgb,currentColor 35%,transparent)}
+.current-title-settings button:active:not(:disabled){transform:scale(.97)}
+.current-title-settings button:disabled{opacity:.45;cursor:not-allowed}
+.current-title-settings fieldset{margin:0;border:1px solid var(--gray-6,color-mix(in srgb,currentColor 15%,transparent));border-radius:10px;padding:8px 12px;display:grid;gap:8px}
+.current-title-settings label{display:flex;gap:8px;align-items:center}
+.current-title-settings :focus-visible{outline:2px solid currentColor;outline-offset:3px}
+@media(prefers-reduced-motion:reduce){.current-title-settings button{transition:none}}
+`;
+function apply(ctx) {
+	const client = ctx;
+	const marker = createTitleClientMarker();
+	ctx.provide(TITLE_CLIENT_SERVICE, marker);
+	ctx.effect(() => {
+		let live = true;
+		client.connection.rpc.call(RPC_CHANNEL, "status", {}).then((result) => {
+			const row = result;
+			if (!live) return;
+			applyMarkerFromStatus(marker, row?.ok ? row.value : void 0, live);
+		}).catch(() => {
+			if (live) applyMarkerFromStatus(marker, void 0, live);
+		});
+		return () => {
+			live = false;
+			disposeTitleClientMarker(marker);
+		};
+	}, "current-title.marker");
+	ctx.effect(() => {
+		if (typeof document === "undefined") return () => {};
+		const style = document.createElement("style");
+		style.setAttribute("data-plugin", "@klarkxy/dsh-current-title");
+		style.textContent = styles;
+		document.head.appendChild(style);
+		return () => style.remove();
+	}, "current-title.styles");
+	ctx.effect(() => client.slots.inject("settings.section", () => client.slots.register({
+		name: "settings.section",
+		id: "current-title",
+		order: 80,
+		label: "当前标题"
+	}, (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TitleSettings, {
+		client,
+		marker,
+		owner: props
+	}))), "current-title.settings");
+}
+//#endregion
+exports.TitleSettings = TitleSettings;
+exports.apply = apply;
+exports.applyMarkerFromStatus = applyMarkerFromStatus;
+exports.createTitleClientMarker = createTitleClientMarker;
+exports.disposeTitleClientMarker = disposeTitleClientMarker;
+exports.inject = inject;
+exports.name = name;
+
+//# sourceMappingURL=client.inner.cjs.map
+    return module.exports;
+  }
+});

package/lib/contracts.d.ts

@@ -0,0 +1,74 @@
+import { RpcResult } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.d.ts
+declare const PLUGIN_NAME = "@klarkxy/dsh-current-title";
+declare const FEATURE_ID = "current-title";
+declare const PROVIDER_ID = "@klarkxy/dsh-current-title";
+declare const PURPOSE_ID = "current-title.generate";
+declare const RPC_CHANNEL = "/dsh-current-title";
+declare const TITLE_CLIENT_SERVICE = "dshCurrentTitleClient";
+declare const PROMPT_VERSION = "current-title.v1";
+declare const SCHEMA_VERSION = "title-json.v1";
+declare const CONTRACT_VERSION = 1;
+declare const SETTINGS_KEY = "current";
+declare const DEFAULT_MAX_RECENT_MESSAGES = 8;
+declare const DEFAULT_TARGET_WORDS = 5;
+declare const DEFAULT_TARGET_CJK = 10;
+declare const DEFAULT_MAX_INPUT_BYTES = 4096;
+declare const DEFAULT_MAX_OUTPUT_TOKENS = 64;
+declare const DEFAULT_TIMEOUT_MS = 60000;
+declare const DEFAULT_MAX_TITLE_BYTES = 80;
+type TitleLocaleMode = 'auto' | 'zh' | 'en';
+type TitleSourceKind = 'fallback' | 'provider' | 'user';
+interface TitleMessage {
+  readonly seq: number;
+  readonly text: string;
+}
+interface TitleSnapshot {
+  readonly title: string;
+  readonly messageSeqs: readonly number[];
+  readonly source: {
+    readonly kind: TitleSourceKind;
+    readonly provider?: string;
+  };
+  readonly eventSeq: number;
+  readonly updatedAt: number;
+}
+interface TitleSettings {
+  revision: number;
+  locale: TitleLocaleMode;
+}
+interface TitleSupport {
+  nativeOwner: string | null;
+  weOwn: boolean;
+  limitation?: string;
+}
+interface TitleStatus {
+  settings: TitleSettings;
+  support: TitleSupport;
+  session?: {
+    sessionId: string;
+    title?: string;
+    sourceKind?: TitleSourceKind;
+    generating: boolean;
+    pinned: boolean;
+  };
+}
+interface TitleClientMarker {
+  active: boolean;
+}
+interface GenerateConfig {
+  readonly maxRecentMessages: number;
+  readonly locale: TitleLocaleMode;
+  readonly targetWords: number;
+  readonly targetCjkCharacters: number;
+  readonly maxInputBytes: number;
+  readonly maxOutputTokens: number;
+  readonly timeoutMs: number;
+  readonly maxTitleBytes: number;
+}
+declare function defaultSettings(locale?: TitleLocaleMode): TitleSettings;
+declare function defaultGenerateConfig(locale?: TitleLocaleMode): GenerateConfig;
+declare function isTitleLocaleMode(value: unknown): value is TitleLocaleMode;
+//#endregion
+export { CONTRACT_VERSION, DEFAULT_MAX_INPUT_BYTES, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_MAX_RECENT_MESSAGES, DEFAULT_MAX_TITLE_BYTES, DEFAULT_TARGET_CJK, DEFAULT_TARGET_WORDS, DEFAULT_TIMEOUT_MS, FEATURE_ID, GenerateConfig, PLUGIN_NAME, PROMPT_VERSION, PROVIDER_ID, PURPOSE_ID, RPC_CHANNEL, type RpcResult, SCHEMA_VERSION, SETTINGS_KEY, TITLE_CLIENT_SERVICE, TitleClientMarker, TitleLocaleMode, TitleMessage, TitleSettings, TitleSnapshot, TitleSourceKind, TitleStatus, TitleSupport, defaultGenerateConfig, defaultSettings, isTitleLocaleMode };
+//# sourceMappingURL=contracts.d.ts.map