@deepmaid/maid-gestures 0.0.0-stage → 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kenyonxu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+# 空 patch 层:本包挂载在 preset 声明树(Q3 拍板,2026-10-28 规格 §2);bundle 层仅承载包身份与面板元数据,toggle 对本包为无操作。
+# 空层以顶层 `[]` 承载(修复轮 2 勘正):comment-only 会 parse 为 null,dsh-app-boot parsePatchList 即 throw,整包进 skippedBundles。
+[]

package/lib/index.d.ts

@@ -0,0 +1,66 @@
+//#region src/config.d.ts
+/**
+ * maid-gestures 配置解析(纯函数,任务 2):per-maid gestures.yml 的规范化产物。
+ * 风格照 maid-emotion config.ts——yml 键 snake_case 映射到消费面 camelCase;坏条目 warn
+ * 跳过整条;id 语法违规跳过;fullness 阈值 0<uneasy<full 违规只跳 fullness 节(手势保留)。
+ *
+ * 数值护栏(规格 §3,2026-10-09 计划裁定落地差异):本层**只解析数值,不判维度合法性**——
+ * deep 维/未声明维由 maid-emotion applyDeltas 的声明维过滤剔除(未声明自然不落账,全被
+ * 剔除 → false 零落账 =「数值降级为零」);「不把 deep 维写进 gestures.yml」是配置文档
+ * 约定(doris gestures.yml 与女仆诞生清单写明),不建单独 tier 查询面。
+ */
+/** 过饱档(可选节):uneasy/full 是 per-session 计数阈值,阈值文案池各一 */
+interface GestureFullnessConfig {
+  uneasy: number;
+  uneasyFeedback: readonly string[];
+  full: number;
+  fullFeedback: readonly string[];
+}
+/** 单个签名手势:一个手势 = 一条斜杠命令(name = id)+ 数值增量 + 反馈文案池 */
+interface GestureConfig {
+  id: string;
+  label: string;
+  deltas: Record<string, number>;
+  feedback: readonly string[];
+  say?: string;
+  fullness?: GestureFullnessConfig;
+}
+/** say 注入失败文案缺省(规格 §4 错误处理表;gestures.yml 顶层 say_busy 可覆写) */
+declare const DEFAULT_SAY_BUSY = "她现在正忙着,这句没递进去";
+type Warn = (message: string) => void;
+/**
+ * gestures.yml 根文档解析:根非 mapping / gestures 非列表 → warn 后空;未知顶层键 warn
+ * (fail-open 但不静默);重复 id 后者 warn 跳过(commands.register 同名二义不进)。
+ */
+declare function parseGesturesConfig(raw: unknown, warn: Warn): GestureConfig[];
+/** 顶层 say_busy(say 注入失败文案):缺省 undefined(消费面回退 DEFAULT_SAY_BUSY);坏类型 warn 后 undefined */
+declare function sayBusyOf(raw: unknown, warn: Warn): string | undefined;
+//#endregion
+//#region src/index.d.ts
+declare const name = "maid-gestures";
+/**
+ * maid-gestures(签名手势,/feedrice 首实例):per-maid gestures.yml 装配期一次解析,每个手势
+ * 注册为一条斜杠命令(name = gesture.id)。preset 行挂载——per-agent 限定由 agent-preset
+ * registry 挂 agent scope 承担(任务 3 装配),插件本体只经 ctx.commands.register 注册。
+ *
+ * 全 fail-open(规格 §4):手势绝不炸会话——maidEmotion 不在/maid 未解析/applyDeltas false
+ * → 命令与文案照常,数值跳过 + one-shot warn;say 注入抛错 → error 文案 say_busy(可配,
+ * 缺省「她现在正忙着,这句没递进去」)+ 数值不回滚(落账先行,followup 失败不补偿)。
+ *
+ * 数值护栏(规格 §3,计划裁定落地差异):deltas 原样透传 maidEmotion.applyDeltas——未声明维
+ * 由其声明维过滤自然剔除(全剔 → false = 数值降级零);「不写 deep 维」是 gestures.yml 侧
+ * 文档约定,不建 tier 查询面(服务面 stateOf 不暴露 tier,任务 1 第四例已锁 deep 维放行)。
+ *
+ * 缓存纪律(铁律 3):命令 schema 装配期静态;反馈是 CommandResult 本地渲染,零 system prompt
+ * 接触;say 注入是普通 user 消息(goal 命令 followup 同款),与主人手打同构。
+ */
+interface MaidGesturesConfig {
+  /**
+   * gestures.yml 路径:绝对直达;相对 → ctx.baseUrl(preset 组合目录,cordis-plugin-include
+   * 设定)优先,无 baseUrl 回退 cwd;缺省 'gestures.yml' 同规则(≈ <presetDir>/gestures.yml)。
+   */
+  gesturesPath?: string;
+}
+declare const apply: (ctx: any, config: MaidGesturesConfig) => (() => void);
+//#endregion
+export { DEFAULT_SAY_BUSY, type GestureConfig, type GestureFullnessConfig, MaidGesturesConfig, apply, name, parseGesturesConfig, sayBusyOf };