@klarkxy/dsh-current-title 0.1.0

package/lib/contracts.js

@@ -0,0 +1,43 @@
+//#region src/contracts.ts
+const PLUGIN_NAME = "@klarkxy/dsh-current-title";
+const FEATURE_ID = "current-title";
+const PROVIDER_ID = "@klarkxy/dsh-current-title";
+const PURPOSE_ID = "current-title.generate";
+const RPC_CHANNEL = "/dsh-current-title";
+const TITLE_CLIENT_SERVICE = "dshCurrentTitleClient";
+const PROMPT_VERSION = "current-title.v1";
+const SCHEMA_VERSION = "title-json.v1";
+const CONTRACT_VERSION = 1;
+const SETTINGS_KEY = "current";
+const DEFAULT_MAX_RECENT_MESSAGES = 8;
+const DEFAULT_TARGET_WORDS = 5;
+const DEFAULT_TARGET_CJK = 10;
+const DEFAULT_MAX_INPUT_BYTES = 4096;
+const DEFAULT_MAX_OUTPUT_TOKENS = 64;
+const DEFAULT_TIMEOUT_MS = 6e4;
+const DEFAULT_MAX_TITLE_BYTES = 80;
+function defaultSettings(locale = "auto") {
+	return {
+		revision: 0,
+		locale
+	};
+}
+function defaultGenerateConfig(locale = "auto") {
+	return {
+		maxRecentMessages: 8,
+		locale,
+		targetWords: 5,
+		targetCjkCharacters: 10,
+		maxInputBytes: DEFAULT_MAX_INPUT_BYTES,
+		maxOutputTokens: 64,
+		timeoutMs: DEFAULT_TIMEOUT_MS,
+		maxTitleBytes: 80
+	};
+}
+function isTitleLocaleMode(value) {
+	return value === "auto" || value === "zh" || value === "en";
+}
+//#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, PLUGIN_NAME, PROMPT_VERSION, PROVIDER_ID, PURPOSE_ID, RPC_CHANNEL, SCHEMA_VERSION, SETTINGS_KEY, TITLE_CLIENT_SERVICE, defaultGenerateConfig, defaultSettings, isTitleLocaleMode };
+
+//# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["/** Browser-safe contracts. Shared RPC/result types stay on @klarkxy/dsh-ai-services. */\nexport type { RpcResult } from '@klarkxy/dsh-ai-services/contracts'\n\nexport const PLUGIN_NAME = '@klarkxy/dsh-current-title'\nexport const FEATURE_ID = 'current-title'\nexport const PROVIDER_ID = '@klarkxy/dsh-current-title'\nexport const PURPOSE_ID = 'current-title.generate'\nexport const RPC_CHANNEL = '/dsh-current-title'\nexport const TITLE_CLIENT_SERVICE = 'dshCurrentTitleClient'\nexport const PROMPT_VERSION = 'current-title.v1'\nexport const SCHEMA_VERSION = 'title-json.v1'\nexport const CONTRACT_VERSION = 1\nexport const SETTINGS_KEY = 'current'\n\nexport const DEFAULT_MAX_RECENT_MESSAGES = 8\nexport const DEFAULT_TARGET_WORDS = 5\nexport const DEFAULT_TARGET_CJK = 10\nexport const DEFAULT_MAX_INPUT_BYTES = 4096\nexport const DEFAULT_MAX_OUTPUT_TOKENS = 64\nexport const DEFAULT_TIMEOUT_MS = 60_000\nexport const DEFAULT_MAX_TITLE_BYTES = 80\n\nexport type TitleLocaleMode = 'auto' | 'zh' | 'en'\nexport type TitleSourceKind = 'fallback' | 'provider' | 'user'\n\nexport interface TitleMessage {\n  readonly seq: number\n  readonly text: string\n}\n\nexport interface TitleSnapshot {\n  readonly title: string\n  readonly messageSeqs: readonly number[]\n  readonly source: { readonly kind: TitleSourceKind; readonly provider?: string }\n  readonly eventSeq: number\n  readonly updatedAt: number\n}\n\nexport interface TitleSettings {\n  revision: number\n  locale: TitleLocaleMode\n}\n\nexport interface TitleSupport {\n  nativeOwner: string | null\n  weOwn: boolean\n  limitation?: string\n}\n\nexport interface TitleStatus {\n  settings: TitleSettings\n  support: TitleSupport\n  session?: {\n    sessionId: string\n    title?: string\n    sourceKind?: TitleSourceKind\n    generating: boolean\n    pinned: boolean\n  }\n}\n\nexport interface TitleClientMarker {\n  active: boolean\n}\n\nexport interface GenerateConfig {\n  readonly maxRecentMessages: number\n  readonly locale: TitleLocaleMode\n  readonly targetWords: number\n  readonly targetCjkCharacters: number\n  readonly maxInputBytes: number\n  readonly maxOutputTokens: number\n  readonly timeoutMs: number\n  readonly maxTitleBytes: number\n}\n\nexport function defaultSettings(locale: TitleLocaleMode = 'auto'): TitleSettings {\n  return { revision: 0, locale }\n}\n\nexport function defaultGenerateConfig(locale: TitleLocaleMode = 'auto'): GenerateConfig {\n  return {\n    maxRecentMessages: DEFAULT_MAX_RECENT_MESSAGES,\n    locale,\n    targetWords: DEFAULT_TARGET_WORDS,\n    targetCjkCharacters: DEFAULT_TARGET_CJK,\n    maxInputBytes: DEFAULT_MAX_INPUT_BYTES,\n    maxOutputTokens: DEFAULT_MAX_OUTPUT_TOKENS,\n    timeoutMs: DEFAULT_TIMEOUT_MS,\n    maxTitleBytes: DEFAULT_MAX_TITLE_BYTES,\n  }\n}\n\nexport function isTitleLocaleMode(value: unknown): value is TitleLocaleMode {\n  return value === 'auto' || value === 'zh' || value === 'en'\n}\n"],"mappings":";AAGA,MAAa,cAAc;AAC3B,MAAa,aAAa;AAC1B,MAAa,cAAc;AAC3B,MAAa,aAAa;AAC1B,MAAa,cAAc;AAC3B,MAAa,uBAAuB;AACpC,MAAa,iBAAiB;AAC9B,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAChC,MAAa,eAAe;AAE5B,MAAa,8BAA8B;AAC3C,MAAa,uBAAuB;AACpC,MAAa,qBAAqB;AAClC,MAAa,0BAA0B;AACvC,MAAa,4BAA4B;AACzC,MAAa,qBAAqB;AAClC,MAAa,0BAA0B;AAwDvC,SAAgB,gBAAgB,SAA0B,QAAuB;CAC/E,OAAO;EAAE,UAAU;EAAG;CAAO;AAC/B;AAEA,SAAgB,sBAAsB,SAA0B,QAAwB;CACtF,OAAO;EACL,mBAAA;EACA;EACA,aAAA;EACA,qBAAA;EACA,eAAe;EACf,iBAAA;EACA,WAAW;EACX,eAAA;CACF;AACF;AAEA,SAAgB,kBAAkB,OAA0C;CAC1E,OAAO,UAAU,UAAU,UAAU,QAAQ,UAAU;AACzD"}

package/lib/index.d.ts

@@ -0,0 +1,160 @@
+import { TitleLocaleMode as TitleLocaleMode$1, TitleMessage, TitleSettings, TitleSnapshot, TitleStatus, TitleSupport } from "./contracts.js";
+import { AiServices } from "@klarkxy/dsh-ai-services/contracts";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/messages.d.ts
+interface SessionEventLike {
+  readonly type: string;
+  readonly seq: number;
+  readonly time?: number;
+  readonly data?: {
+    readonly source?: {
+      readonly kind?: string;
+      readonly plugin?: string;
+      readonly provider?: string;
+    };
+    readonly content?: ReadonlyArray<{
+      readonly type?: string;
+      readonly text?: string;
+    }>;
+    readonly title?: string;
+    readonly messageSeqs?: readonly number[];
+  };
+}
+interface SessionLike {
+  readonly id: string;
+  readonly seq?: number;
+  snapshotEvents(): readonly SessionEventLike[];
+  append?(type: string, data: unknown): unknown;
+}
+//#endregion
+//#region src/native-slot.d.ts
+interface SessionTitleProvider {
+  readonly id: string;
+  readonly automatic: 'first-prompt' | 'all-prompts';
+  generate(request: {
+    session: {
+      id: string;
+      snapshotEvents(): readonly unknown[];
+    };
+    messages: ReadonlyArray<{
+      seq: number;
+      text: string;
+    }>;
+    route?: {
+      provider: string;
+      model: string;
+    };
+    signal: AbortSignal;
+  }): Promise<{
+    title: string;
+    messageSeqs: readonly number[];
+    model?: {
+      provider: string;
+      model: string;
+    };
+  }>;
+}
+interface SessionTitleServiceLike {
+  register(provider: SessionTitleProvider): () => void | Promise<void>;
+  get(session: unknown): {
+    title: string;
+    source?: {
+      kind?: string;
+      provider?: string;
+    };
+    eventSeq?: number;
+    updatedAt?: number;
+    messageSeqs?: readonly number[];
+  } | undefined;
+  refresh(session: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+interface LoaderEntryOptions {
+  id?: string;
+  name?: string;
+  disabled?: boolean | null;
+  config?: unknown;
+  inject?: unknown;
+  group?: boolean | null;
+}
+interface LoaderEntry {
+  id: string;
+  options?: LoaderEntryOptions;
+}
+interface LoaderFace {
+  entries(): Iterable<LoaderEntry>;
+  update(id: string, options: {
+    disabled?: boolean | null;
+  }): Promise<unknown> | unknown;
+}
+//#endregion
+//#region src/output.d.ts
+declare const TITLE_TYPE_KEYS: readonly ["feature", "fix", "optimize", "refactor", "test", "docs", "release", "config", "explore", "discuss"];
+declare const TITLE_LOCALES: readonly ["zh", "en"];
+declare const TITLE_LOCALE_MODES: readonly ["auto", "zh", "en"];
+type TitleType = (typeof TITLE_TYPE_KEYS)[number];
+type TitleLocale = (typeof TITLE_LOCALES)[number];
+type TitleLocaleMode = (typeof TITLE_LOCALE_MODES)[number];
+interface ParsedTitle {
+  type: TitleType;
+  summary: string;
+}
+declare function resolveTitleLocale(mode: TitleLocaleMode, messages: readonly string[], preference?: string): TitleLocale;
+declare function parseModelTitle(raw: string, targetWords: number, targetCjkCharacters: number): ParsedTitle;
+declare function formatTitle(parsed: ParsedTitle, locale: TitleLocale, now?: Date): string;
+//#endregion
+//#region src/service.d.ts
+interface TitleSettingsStore {
+  load(): TitleSettings | undefined;
+  save(settings: TitleSettings): Promise<void>;
+}
+declare class CurrentTitleService {
+  private readonly options;
+  private settings;
+  private config;
+  private scope?;
+  private unregisterPurpose?;
+  private claim?;
+  private nativeSlot?;
+  private generation;
+  private readonly inFlight;
+  readonly support: TitleSupport;
+  constructor(options: {
+    plugin: string;
+    ai?: AiServices;
+    sessionTitle?: SessionTitleServiceLike;
+    loader?: LoaderFace;
+    sessions?: {
+      get(id: string): SessionLike | undefined;
+    };
+    store?: TitleSettingsStore;
+    localePreference?: () => string | undefined;
+    initialLocale?: TitleLocaleMode;
+    now?: () => Date;
+  });
+  start(): Promise<void>;
+  dispose(): Promise<void>;
+  status(sessionId?: string): TitleStatus;
+  updateLocale(locale: TitleLocaleMode, expectedRevision: number): Promise<TitleSettings>;
+  regenerate(sessionId: string, signal: AbortSignal): Promise<TitleSnapshot | undefined>;
+  read(session: SessionLike): TitleSnapshot | undefined;
+  private nativeGenerate;
+}
+//#endregion
+//#region src/input.d.ts
+declare function frameMessages(messages: readonly TitleMessage[]): string;
+declare function selectRecentMessages(messages: readonly TitleMessage[], maxRecentMessages: number, maxInputBytes: number): TitleMessage[];
+//#endregion
+//#region src/index.d.ts
+declare const name = "@klarkxy/dsh-current-title";
+declare const inject: readonly ["sessionTitle", "aiServices", "sessions", "loader", "storageDomain", "connection", "webServer"];
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    currentTitle: CurrentTitleService;
+  }
+}
+declare function apply(ctx: Context, config?: {
+  locale?: TitleLocaleMode$1;
+}): Promise<void>;
+//#endregion
+export { CurrentTitleService, apply, formatTitle, frameMessages, inject, name, parseModelTitle, resolveTitleLocale, selectRecentMessages };
+//# sourceMappingURL=index.d.ts.map