@dsh-plus/notify-email 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,149 @@
+import z from "@deepseek-ai/schemastery";
+import "@deepseek-ai/dsh-settings";
+import { Context, Service } from "@deepseek-ai/cordis";
+
+//#region src/config.d.ts
+
+declare const Config: z<Schemastery.ObjectS<{
+  enabled: z<boolean, boolean>;
+  smtp: z<Schemastery.ObjectS<{
+    host: z<string, string>;
+    port: z<number, number>;
+    secure: z<boolean, boolean>;
+    user: z<string, string>;
+    pass: z<string, string>;
+    from: z<string, string>;
+  }>, Schemastery.ObjectT<{
+    host: z<string, string>;
+    port: z<number, number>;
+    secure: z<boolean, boolean>;
+    user: z<string, string>;
+    pass: z<string, string>;
+    from: z<string, string>;
+  }>>;
+  to: z<string[], string[]>;
+  triggers: z<Schemastery.ObjectS<{
+    onComplete: z<boolean, boolean>;
+    onError: z<boolean, boolean>;
+    onAborted: z<boolean, boolean>;
+    onQuestion: z<boolean, boolean>;
+    onPlanReview: z<boolean, boolean>;
+  }>, Schemastery.ObjectT<{
+    onComplete: z<boolean, boolean>;
+    onError: z<boolean, boolean>;
+    onAborted: z<boolean, boolean>;
+    onQuestion: z<boolean, boolean>;
+    onPlanReview: z<boolean, boolean>;
+  }>>;
+  idleDebounceMs: z<number, number>;
+  maxBodyChars: z<number, number>;
+  dryRun: z<boolean, boolean>;
+}>, Schemastery.ObjectT<{
+  enabled: z<boolean, boolean>;
+  smtp: z<Schemastery.ObjectS<{
+    host: z<string, string>;
+    port: z<number, number>;
+    secure: z<boolean, boolean>;
+    user: z<string, string>;
+    pass: z<string, string>;
+    from: z<string, string>;
+  }>, Schemastery.ObjectT<{
+    host: z<string, string>;
+    port: z<number, number>;
+    secure: z<boolean, boolean>;
+    user: z<string, string>;
+    pass: z<string, string>;
+    from: z<string, string>;
+  }>>;
+  to: z<string[], string[]>;
+  triggers: z<Schemastery.ObjectS<{
+    onComplete: z<boolean, boolean>;
+    onError: z<boolean, boolean>;
+    onAborted: z<boolean, boolean>;
+    onQuestion: z<boolean, boolean>;
+    onPlanReview: z<boolean, boolean>;
+  }>, Schemastery.ObjectT<{
+    onComplete: z<boolean, boolean>;
+    onError: z<boolean, boolean>;
+    onAborted: z<boolean, boolean>;
+    onQuestion: z<boolean, boolean>;
+    onPlanReview: z<boolean, boolean>;
+  }>>;
+  idleDebounceMs: z<number, number>;
+  maxBodyChars: z<number, number>;
+  dryRun: z<boolean, boolean>;
+}>>;
+type NotifyEmailConfig = Schemastery.TypeT<typeof Config>;
+//#endregion
+//#region src/triggers/types.d.ts
+/**
+ * 触发器契约：第三方插件经 ctx.notifyEmail.registerTrigger() 注册，
+ * 返回 undefined 表示「不关心该观察」；首个非空产物被投递。
+ * 内置官方适配器（decision/turn-end）也经同一接口注册，无特权路径。
+ * @module notify-email/triggers/types
+ */
+/** 一封待投递通知：触发器的产出。 */
+interface EmailNotice {
+  subject: string;
+  text: string;
+  html?: string;
+}
+/** 决策类观察：工具调用即将阻塞等待用户（tools/pre-execute 观察点，参数已校验）。 */
+interface DecisionCall {
+  callId: string;
+  sessionId: string;
+  name: string;
+  args: Record<string, unknown>;
+}
+/** 任务停止类观察：runtime root agent 的 turn 结束且空闲防抖后。 */
+interface TurnEndInfo {
+  sessionId: string;
+  turn: number;
+  /** turn/end reason.kind：completed | error | aborted（其余 kind 不下发）。 */
+  kind: string;
+  errorMessage?: string;
+  /** 该会话最后一条 assistant 消息的文本内容。 */
+  lastDelivery?: string;
+}
+interface NotifyTrigger {
+  readonly id: string;
+  /** 决策类通知：返回 undefined 跳过。 */
+  onDecision?(call: DecisionCall): EmailNotice | undefined;
+  /** 任务停止类通知：返回 undefined 跳过。 */
+  onTurnEnd?(info: TurnEndInfo): EmailNotice | undefined;
+}
+//#endregion
+//#region src/service.d.ts
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    notifyEmail: NotifyEmailService;
+  }
+}
+declare class NotifyEmailService extends Service {
+  static [Context.inject]: string[];
+  private readonly triggers;
+  private readonly mailer;
+  private current;
+  constructor(ctx: Context, config: NotifyEmailConfig);
+  /** 注册触发器（第三方扩展接口）；返回注销函数，随调用方 fiber 释放。 */
+  registerTrigger(trigger: NotifyTrigger): () => void;
+  /** 当前生效配置（settings 用户层解析结果或 cordis 行级 config）。 */
+  currentConfig(): NotifyEmailConfig;
+  /** 决策类观察入口（decision watcher 调用）。 */
+  dispatchDecision(call: DecisionCall): Promise<void>;
+  /** 任务停止类观察入口（turn-end watcher 调用）。 */
+  dispatchTurnEnd(info: TurnEndInfo): Promise<void>;
+  /** 配置卡片「发送测试邮件」：绕过 enabled 门禁，仍需 SMTP 完整。 */
+  sendTest(): Promise<{
+    ok: boolean;
+    detail: string;
+  }>;
+  private dispatch;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "dsh-plus-notify-email";
+declare const inject: readonly ["agents", "tools"];
+declare function apply(ctx: Context, config: NotifyEmailConfig): void;
+//#endregion
+export { Config, type DecisionCall, type EmailNotice, NotifyEmailService, type NotifyTrigger, type TurnEndInfo, apply, inject, name };