@klarkxy/dsh-mood 0.1.0

package/lib/contracts.d.ts

@@ -0,0 +1,91 @@
+import { AiFeatureScope, EvidenceRef, ProducerMessageSource, RpcResult, TaskContract, projectIdFromCwd } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.d.ts
+/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */
+declare const CHAT_EVENTS_SLOT = "dsh-editor.chat.events";
+declare const MOOD_PLUGIN = "@klarkxy/dsh-mood";
+declare const MOOD_SOURCE_KIND: "plugin:@klarkxy/dsh-mood";
+/** Production activate identity after scoped pluginName support. */
+declare const MOOD_AI_PLUGIN = "@klarkxy/dsh-mood";
+declare const MOOD_RPC_CHANNEL = "/dsh-mood";
+declare const MOOD_ANALYZE_PURPOSE = "mood.analyze";
+declare const CONTRACT_SECTION = "dsh-mood:contract";
+declare const PROMPT_VERSION = "mood.analyze.v1";
+declare const SCHEMA_VERSION = "mood-contract.v1";
+declare const MAX_QUESTIONS = 3;
+declare const MAX_EXCERPT_CHARS = 200;
+declare const MAX_PROJECT_ID_CHARS = 32768;
+declare const DEFAULT_QUESTION = "这次要改哪些内容，做到什么程度算完成？";
+type MoodMode = 'auto' | 'manual' | 'strict';
+type ClarificationStatus = 'pending' | 'answered' | 'skipped' | 'cancelled' | 'stale';
+type MoodLocale = 'zh' | 'en';
+interface MoodSettings {
+  revision: number;
+  mode: MoodMode;
+}
+declare const defaultSettings: () => MoodSettings;
+interface ClarificationItem {
+  id: string;
+  question: string;
+  status: ClarificationStatus;
+  answer?: string;
+}
+interface HeldRequest {
+  sourceVersion: string;
+  trigger: 'material' | 'risk' | 'mild' | 'clear';
+  messages: unknown[];
+}
+interface MoodSessionView {
+  sessionId: string;
+  projectId?: string;
+  contract?: TaskContract;
+  clarification: ClarificationItem[];
+  pendingManual: boolean;
+  held: boolean;
+}
+interface MoodStatus {
+  settings: MoodSettings;
+  storageFailed: boolean;
+  session?: MoodSessionView;
+}
+/** Native `@deepseek-ai/dsh-user-questions` AskUserQuestionItem. */
+interface AskUserQuestionOption {
+  label: string;
+  description?: string;
+}
+interface AskUserQuestionItem {
+  id: string;
+  question: string;
+  detail?: string;
+  header?: string;
+  options?: AskUserQuestionOption[];
+  multiSelect?: boolean;
+}
+interface AskUserQuestionAnswerItem {
+  id: string;
+  selected: string[];
+  custom?: string;
+}
+interface AskUserQuestionAnswer {
+  answers: AskUserQuestionAnswerItem[];
+}
+interface AskUserRequest {
+  questions: AskUserQuestionItem[];
+  agent?: unknown;
+  signal?: AbortSignal;
+}
+declare function ok<T>(value: T): RpcResult<T>;
+declare function fail(code: string, message: string): RpcResult<never>;
+declare function isMoodMode(value: unknown): value is MoodMode;
+declare function parseSessionId(payload: unknown): string | undefined;
+declare function excerptOf(text: string, limit?: number): string;
+declare function sessionIdOf(agent: {
+  id?: unknown;
+  session?: {
+    id?: unknown;
+  };
+} | undefined): string;
+declare function cloneContract(contract: TaskContract): TaskContract;
+declare function readinessLabel(readiness: TaskContract['readiness']): string;
+//#endregion
+export { type AiFeatureScope, AskUserQuestionAnswer, AskUserQuestionAnswerItem, AskUserQuestionItem, AskUserQuestionOption, AskUserRequest, CHAT_EVENTS_SLOT, CONTRACT_SECTION, ClarificationItem, ClarificationStatus, DEFAULT_QUESTION, type EvidenceRef, HeldRequest, MAX_EXCERPT_CHARS, MAX_PROJECT_ID_CHARS, MAX_QUESTIONS, MOOD_AI_PLUGIN, MOOD_ANALYZE_PURPOSE, MOOD_PLUGIN, MOOD_RPC_CHANNEL, MOOD_SOURCE_KIND, MoodLocale, MoodMode, MoodSessionView, MoodSettings, MoodStatus, PROMPT_VERSION, type ProducerMessageSource, type RpcResult, SCHEMA_VERSION, type TaskContract, cloneContract, defaultSettings, excerptOf, fail, isMoodMode, ok, parseSessionId, projectIdFromCwd, readinessLabel, sessionIdOf };
+//# sourceMappingURL=contracts.d.ts.map

package/lib/contracts.js

@@ -0,0 +1,70 @@
+import { projectIdFromCwd } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.ts
+/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */
+const CHAT_EVENTS_SLOT = "dsh-editor.chat.events";
+const MOOD_PLUGIN = "@klarkxy/dsh-mood";
+const MOOD_SOURCE_KIND = "plugin:@klarkxy/dsh-mood";
+/** Production activate identity after scoped pluginName support. */
+const MOOD_AI_PLUGIN = MOOD_PLUGIN;
+const MOOD_RPC_CHANNEL = "/dsh-mood";
+const MOOD_ANALYZE_PURPOSE = "mood.analyze";
+const CONTRACT_SECTION = "dsh-mood:contract";
+const PROMPT_VERSION = "mood.analyze.v1";
+const SCHEMA_VERSION = "mood-contract.v1";
+const MAX_QUESTIONS = 3;
+const MAX_EXCERPT_CHARS = 200;
+const MAX_PROJECT_ID_CHARS = 32768;
+const DEFAULT_QUESTION = "这次要改哪些内容，做到什么程度算完成？";
+const defaultSettings = () => ({
+	revision: 0,
+	mode: "auto"
+});
+function ok(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+function fail(code, message) {
+	return {
+		ok: false,
+		error: {
+			code,
+			message
+		}
+	};
+}
+function isMoodMode(value) {
+	return value === "auto" || value === "manual" || value === "strict";
+}
+function parseSessionId(payload) {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return void 0;
+	const sessionId = payload.sessionId;
+	return typeof sessionId === "string" && sessionId.length > 0 && sessionId.length <= 200 ? sessionId : void 0;
+}
+function excerptOf(text, limit = 200) {
+	const trimmed = text.replace(/\s+/g, " ").trim();
+	if (!trimmed) return "";
+	return trimmed.length <= limit ? trimmed : `${trimmed.slice(0, limit - 1)}…`;
+}
+function sessionIdOf(agent) {
+	const fromSession = agent?.session?.id;
+	if (fromSession != null && String(fromSession).length > 0) return String(fromSession);
+	if (agent?.id != null && String(agent.id).length > 0) return String(agent.id);
+	return "";
+}
+function cloneContract(contract) {
+	return structuredClone(contract);
+}
+function readinessLabel(readiness) {
+	if (readiness === "clear-request") return "表述清楚";
+	if (readiness === "user-confirmed") return "作者已确认";
+	if (readiness === "disclosed-assumptions") return "按已披露假定继续";
+	if (readiness === "cancelled") return "已取消，未确认";
+	if (readiness === "stale") return "已过期";
+	return "待确认";
+}
+//#endregion
+export { CHAT_EVENTS_SLOT, CONTRACT_SECTION, DEFAULT_QUESTION, MAX_EXCERPT_CHARS, MAX_PROJECT_ID_CHARS, MAX_QUESTIONS, MOOD_AI_PLUGIN, MOOD_ANALYZE_PURPOSE, MOOD_PLUGIN, MOOD_RPC_CHANNEL, MOOD_SOURCE_KIND, PROMPT_VERSION, SCHEMA_VERSION, cloneContract, defaultSettings, excerptOf, fail, isMoodMode, ok, parseSessionId, projectIdFromCwd, readinessLabel, sessionIdOf };
+
+//# 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 Mood contracts. Shared TaskContract fields match frozen @klarkxy/dsh-ai-services. */\nimport type { AiFeatureScope, EvidenceRef, ProducerMessageSource, RpcResult, TaskContract } from '@klarkxy/dsh-ai-services/contracts'\n\nexport type { AiFeatureScope, EvidenceRef, ProducerMessageSource, RpcResult, TaskContract }\nexport { projectIdFromCwd } from '@klarkxy/dsh-ai-services/contracts'\n\n/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */\nexport const CHAT_EVENTS_SLOT = 'dsh-editor.chat.events'\nexport const MOOD_PLUGIN = '@klarkxy/dsh-mood'\nexport const MOOD_SOURCE_KIND = 'plugin:@klarkxy/dsh-mood' as const\n/** Production activate identity after scoped pluginName support. */\nexport const MOOD_AI_PLUGIN = MOOD_PLUGIN\nexport const MOOD_RPC_CHANNEL = '/dsh-mood'\nexport const MOOD_ANALYZE_PURPOSE = 'mood.analyze'\nexport const CONTRACT_SECTION = 'dsh-mood:contract'\nexport const PROMPT_VERSION = 'mood.analyze.v1'\nexport const SCHEMA_VERSION = 'mood-contract.v1'\nexport const MAX_QUESTIONS = 3\nexport const MAX_EXCERPT_CHARS = 200\nexport const MAX_PROJECT_ID_CHARS = 32_768\nexport const DEFAULT_QUESTION = '这次要改哪些内容，做到什么程度算完成？'\n\nexport type MoodMode = 'auto' | 'manual' | 'strict'\nexport type ClarificationStatus = 'pending' | 'answered' | 'skipped' | 'cancelled' | 'stale'\nexport type MoodLocale = 'zh' | 'en'\n\nexport interface MoodSettings {\n  revision: number\n  mode: MoodMode\n}\n\nexport const defaultSettings = (): MoodSettings => ({ revision: 0, mode: 'auto' })\n\nexport interface ClarificationItem {\n  id: string\n  question: string\n  status: ClarificationStatus\n  answer?: string\n}\n\nexport interface HeldRequest {\n  sourceVersion: string\n  trigger: 'material' | 'risk' | 'mild' | 'clear'\n  messages: unknown[]\n}\n\nexport interface MoodSessionView {\n  sessionId: string\n  projectId?: string\n  contract?: TaskContract\n  clarification: ClarificationItem[]\n  pendingManual: boolean\n  held: boolean\n}\n\nexport interface MoodStatus {\n  settings: MoodSettings\n  storageFailed: boolean\n  session?: MoodSessionView\n}\n\n/** Native `@deepseek-ai/dsh-user-questions` AskUserQuestionItem. */\nexport interface AskUserQuestionOption {\n  label: string\n  description?: string\n}\n\nexport interface AskUserQuestionItem {\n  id: string\n  question: string\n  detail?: string\n  header?: string\n  options?: AskUserQuestionOption[]\n  multiSelect?: boolean\n}\n\nexport interface AskUserQuestionAnswerItem {\n  id: string\n  selected: string[]\n  custom?: string\n}\n\nexport interface AskUserQuestionAnswer {\n  answers: AskUserQuestionAnswerItem[]\n}\n\nexport interface AskUserRequest {\n  questions: AskUserQuestionItem[]\n  agent?: unknown\n  signal?: AbortSignal\n}\n\nexport function ok<T>(value: T): RpcResult<T> {\n  return { ok: true, value }\n}\n\nexport function fail(code: string, message: string): RpcResult<never> {\n  return { ok: false, error: { code, message } }\n}\n\nexport function isMoodMode(value: unknown): value is MoodMode {\n  return value === 'auto' || value === 'manual' || value === 'strict'\n}\n\nexport function parseSessionId(payload: unknown): string | undefined {\n  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return undefined\n  const sessionId = (payload as { sessionId?: unknown }).sessionId\n  return typeof sessionId === 'string' && sessionId.length > 0 && sessionId.length <= 200 ? sessionId : undefined\n}\n\nexport function excerptOf(text: string, limit = MAX_EXCERPT_CHARS): string {\n  const trimmed = text.replace(/\\s+/g, ' ').trim()\n  if (!trimmed) return ''\n  return trimmed.length <= limit ? trimmed : `${trimmed.slice(0, limit - 1)}…`\n}\n\nexport function sessionIdOf(agent: { id?: unknown; session?: { id?: unknown } } | undefined): string {\n  const fromSession = agent?.session?.id\n  if (fromSession != null && String(fromSession).length > 0) return String(fromSession)\n  if (agent?.id != null && String(agent.id).length > 0) return String(agent.id)\n  return ''\n}\n\nexport function cloneContract(contract: TaskContract): TaskContract {\n  return structuredClone(contract)\n}\n\nexport function readinessLabel(readiness: TaskContract['readiness']): string {\n  if (readiness === 'clear-request') return '表述清楚'\n  if (readiness === 'user-confirmed') return '作者已确认'\n  if (readiness === 'disclosed-assumptions') return '按已披露假定继续'\n  if (readiness === 'cancelled') return '已取消，未确认'\n  if (readiness === 'stale') return '已过期'\n  return '待确认'\n}\n"],"mappings":";;;AAOA,MAAa,mBAAmB;AAChC,MAAa,cAAc;AAC3B,MAAa,mBAAmB;;AAEhC,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAChC,MAAa,uBAAuB;AACpC,MAAa,mBAAmB;AAChC,MAAa,iBAAiB;AAC9B,MAAa,iBAAiB;AAC9B,MAAa,gBAAgB;AAC7B,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AACpC,MAAa,mBAAmB;AAWhC,MAAa,yBAAuC;CAAE,UAAU;CAAG,MAAM;AAAO;AA6DhF,SAAgB,GAAM,OAAwB;CAC5C,OAAO;EAAE,IAAI;EAAM;CAAM;AAC3B;AAEA,SAAgB,KAAK,MAAc,SAAmC;CACpE,OAAO;EAAE,IAAI;EAAO,OAAO;GAAE;GAAM;EAAQ;CAAE;AAC/C;AAEA,SAAgB,WAAW,OAAmC;CAC5D,OAAO,UAAU,UAAU,UAAU,YAAY,UAAU;AAC7D;AAEA,SAAgB,eAAe,SAAsC;CACnE,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG,OAAO,KAAA;CAC9E,MAAM,YAAa,QAAoC;CACvD,OAAO,OAAO,cAAc,YAAY,UAAU,SAAS,KAAK,UAAU,UAAU,MAAM,YAAY,KAAA;AACxG;AAEA,SAAgB,UAAU,MAAc,QAAA,KAAmC;CACzE,MAAM,UAAU,KAAK,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK;CAC/C,IAAI,CAAC,SAAS,OAAO;CACrB,OAAO,QAAQ,UAAU,QAAQ,UAAU,GAAG,QAAQ,MAAM,GAAG,QAAQ,CAAC,EAAE;AAC5E;AAEA,SAAgB,YAAY,OAAyE;CACnG,MAAM,cAAc,OAAO,SAAS;CACpC,IAAI,eAAe,QAAQ,OAAO,WAAW,CAAC,CAAC,SAAS,GAAG,OAAO,OAAO,WAAW;CACpF,IAAI,OAAO,MAAM,QAAQ,OAAO,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,OAAO,OAAO,MAAM,EAAE;CAC5E,OAAO;AACT;AAEA,SAAgB,cAAc,UAAsC;CAClE,OAAO,gBAAgB,QAAQ;AACjC;AAEA,SAAgB,eAAe,WAA8C;CAC3E,IAAI,cAAc,iBAAiB,OAAO;CAC1C,IAAI,cAAc,kBAAkB,OAAO;CAC3C,IAAI,cAAc,yBAAyB,OAAO;CAClD,IAAI,cAAc,aAAa,OAAO;CACtC,IAAI,cAAc,SAAS,OAAO;CAClC,OAAO;AACT"}

package/lib/index.d.ts

@@ -0,0 +1,173 @@
+import { AskUserQuestionAnswer, AskUserRequest, CHAT_EVENTS_SLOT, ClarificationItem, HeldRequest, MOOD_AI_PLUGIN, MOOD_PLUGIN, MOOD_RPC_CHANNEL, MoodSettings, MoodStatus, defaultSettings, projectIdFromCwd } from "./contracts.js";
+import { AiFeatureScope, RpcResult, TaskContract } from "@klarkxy/dsh-ai-services/contracts";
+import { z } from "zod";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/evidence.d.ts
+interface ContentBlockLike {
+  type?: string;
+  text?: string;
+}
+interface MessageSourceLike {
+  kind?: string;
+  plugin?: string;
+  form?: string;
+  sections?: Array<{
+    name?: string;
+  }>;
+}
+interface UserMessageLike {
+  id?: unknown;
+  role?: string;
+  content?: ContentBlockLike[];
+  source?: MessageSourceLike;
+}
+interface SessionEventLike {
+  seq: number;
+  type: string;
+  data?: unknown;
+}
+//#endregion
+//#region src/service.d.ts
+interface MoodPersistedState {
+  settings: MoodSettings;
+  sessions: Record<string, MoodStoredSession>;
+}
+interface MoodStoredSession {
+  contract?: TaskContract;
+  clarification: ClarificationItem[];
+  lastHandledVersion?: string;
+  pendingManual: boolean;
+  projectId?: string;
+  heldRequest?: HeldRequest;
+}
+interface MoodStore {
+  load(): MoodPersistedState;
+  save(state: MoodPersistedState): Promise<void>;
+}
+interface SessionLike {
+  id?: unknown;
+  header?: {
+    cwd?: string;
+  };
+  meta?: {
+    cwd?: string;
+  };
+}
+interface PreStepPayload {
+  agent: {
+    id?: unknown;
+    session?: SessionLike;
+  };
+  messages: UserMessageLike[];
+  turn: number;
+  step: number;
+  signal: AbortSignal;
+}
+type PreStepDecision = {
+  kind: 'reject';
+} | {
+  kind: 'enter';
+  messages: unknown[];
+  startsRequestSeries?: true;
+};
+interface MoodServiceOptions {
+  store?: MoodStore;
+  now?: () => number;
+  id?: () => string;
+  readEvents: (sessionId: string) => readonly SessionEventLike[] | undefined;
+  liveSession?: (sessionId: string) => SessionLike | undefined;
+  activateAi?: () => AiFeatureScope | undefined;
+  askUser?: (request: AskUserRequest) => Promise<AskUserQuestionAnswer>;
+  createInjectMessage?: (text: string) => unknown;
+  resumeHeld?: (sessionId: string, messages: unknown[]) => Promise<void>;
+}
+declare class MoodService {
+  private readonly options;
+  private settings;
+  private sessions;
+  private storageFailed;
+  private active;
+  private ai?;
+  private unregisterPurpose?;
+  private pending;
+  private readonly now;
+  private readonly nextId;
+  constructor(options: MoodServiceOptions);
+  getContract(sessionId: string): TaskContract | undefined;
+  status(sessionId?: string): MoodStatus;
+  isActive(): boolean;
+  dispose(): Promise<void>;
+  call(endpoint: string, payload: unknown, signal: AbortSignal): Promise<RpcResult>;
+  handlePreStep(payload: PreStepPayload, next: () => Promise<PreStepDecision>): Promise<PreStepDecision>;
+  private runAnalysis;
+  private askOnce;
+  private afterStale;
+  private enter;
+  private blockUnresolved;
+  private updateMode;
+  private requestManual;
+  private requestRetry;
+  private resumeExact;
+  private editContract;
+  private hostSessionId;
+  private ensure;
+  private view;
+  private isBlocked;
+  private commitIfCurrent;
+  private supersedeIfNew;
+  private supersede;
+  private replaceWork;
+  private generationCurrent;
+  private snapshot;
+  private commitState;
+  private persistProposed;
+  private assertLive;
+  private serialize;
+  private syncAi;
+  private detachAi;
+}
+//#endregion
+//#region src/inject.d.ts
+declare function createMoodContextMessage(text: string): unknown;
+//#endregion
+//#region src/storage.d.ts
+declare const moodDomain: {
+  name: string;
+  version: number;
+  tables: {
+    state: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, MoodPersistedState>;
+  };
+};
+type MoodDomainHandle = {
+  table(name: 'state'): {
+    get(key: string): unknown;
+    put(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    entries(): IterableIterator<[string, unknown]>;
+  };
+  close(): Promise<void>;
+};
+declare function domainStore(domain: MoodDomainHandle): MoodStore;
+//#endregion
+//#region src/index.d.ts
+declare const name = "@klarkxy/dsh-mood";
+declare const inject: readonly ["aiServices", "storageDomain", "sessions", "userQuestions", "agents", "connection", "webServer"];
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    aiMood: MoodService;
+  }
+}
+type LiveAgent = {
+  id?: unknown;
+  steer?: (message: unknown) => void;
+  followup?: (message: unknown) => void;
+};
+type AgentsRegistry = {
+  get(id: unknown): LiveAgent | undefined;
+};
+declare function apply(ctx: Context): Promise<void>;
+/** Bound invoke: native steer/followup call this.send on the live Agents.get instance. */
+declare function resumeHeldOnHost(agents: AgentsRegistry, sessionId: string, messages: unknown[]): void;
+//#endregion
+export { AgentsRegistry, CHAT_EVENTS_SLOT, LiveAgent, MOOD_AI_PLUGIN, MOOD_PLUGIN, MOOD_RPC_CHANNEL, MoodService, apply, createMoodContextMessage, defaultSettings, domainStore, inject, moodDomain, name, projectIdFromCwd, resumeHeldOnHost };
+//# sourceMappingURL=index.d.ts.map