@deepmaid/maid-veil 0.0.0-stage → 0.1.0-alpha.0

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,43 @@
+//#region src/config.d.ts
+/**
+ * maid-veil 配置与 boundary pack 解析(M3d,规格 §3.1-3.3):输入是 preset veil 行
+ * config 与 maid-identity resolvePack 产物。校验风格照 maid-voice pack.ts——局部
+ * 助手、坏值 warn 跳过、未知键 warn 不静默。
+ *
+ * 插值面保护:text 含 `{{` 一律整包弃——PromptLayer interpolate 把 {{…}} 当变量
+ * 引用,坏引用在装配期直接 throw(铁律 3 反例的编译期拦截)。
+ */
+declare const DEFAULT_VEIL_ORDER = 4100;
+interface VeilSelection {
+  pack?: string;
+  byModel: Record<string, string>;
+  order: number;
+}
+interface BoundaryPack {
+  id: string;
+  name?: string;
+  text: string;
+}
+type Warn = (message: string) => void;
+declare function parseVeilConfig(raw: unknown, warn: Warn): VeilSelection;
+declare function parseBoundaryPack(raw: Record<string, unknown> | undefined, where: string, warn: Warn): BoundaryPack | undefined;
+//#endregion
+//#region src/index.d.ts
+declare const name = "maid-veil";
+/**
+ * maid-veil(M3d 面纱与边界):boundary pack 装载 + 静态 systemPrompt 段注册。
+ * preset 行挂载(agent scope,anchor/gestures 同层)——config 即选择器:
+ *   pack: 默认集 id;byModel: provider/model 复合键 → 集 id;order: 段位(缺省 4100)。
+ *
+ * 生命周期(规格 §1):构造期一次读入、会话内零求值(铁律 3);cron 会话与 IM 会话
+ * 同享(挂女仆本体非会话类型);maid:veil 不产生 durable 事件——system prompt 本身
+ * durable,即铁律 4 的满足形态。
+ *
+ * 全 fail-open:config 无 pack → 合法零段;maidIdentity 缺席/pack 缺失或坏 →
+ * one-shot warn + 零段(绝不炸装配);agentDefaultModel 缺席 → byModel 不可用,
+ * 用默认集 + one-shot warn(规格 §7 风险 6 降级路径)。
+ */
+declare const inject: string[];
+declare const apply: (ctx: any, config: unknown) => (() => void);
+//#endregion
+export { type BoundaryPack, DEFAULT_VEIL_ORDER, type VeilSelection, apply, inject, name, parseBoundaryPack, parseVeilConfig };

package/lib/index.js

@@ -0,0 +1,163 @@
+//#region src/config.ts
+/**
+* maid-veil 配置与 boundary pack 解析(M3d,规格 §3.1-3.3):输入是 preset veil 行
+* config 与 maid-identity resolvePack 产物。校验风格照 maid-voice pack.ts——局部
+* 助手、坏值 warn 跳过、未知键 warn 不静默。
+*
+* 插值面保护:text 含 `{{` 一律整包弃——PromptLayer interpolate 把 {{…}} 当变量
+* 引用,坏引用在装配期直接 throw(铁律 3 反例的编译期拦截)。
+*/
+const DEFAULT_VEIL_ORDER = 4100;
+const KNOWN_CONFIG_KEYS = /* @__PURE__ */ new Set([
+	"pack",
+	"byModel",
+	"order"
+]);
+const KNOWN_PACK_KEYS = /* @__PURE__ */ new Set([
+	"id",
+	"kind",
+	"name",
+	"text"
+]);
+function isMapping(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseVeilConfig(raw, warn) {
+	const out = {
+		byModel: {},
+		order: DEFAULT_VEIL_ORDER
+	};
+	if (raw === void 0) return out;
+	if (!isMapping(raw)) {
+		warn("maid-veil: config must be a mapping, treated as empty");
+		return out;
+	}
+	for (const key of Object.keys(raw)) if (!KNOWN_CONFIG_KEYS.has(key)) warn(`maid-veil: unknown config field '${key}'`);
+	const { pack, byModel, order } = raw;
+	if (pack !== void 0) {
+		if (typeof pack !== "string" || pack === "") warn("maid-veil: pack must be a non-empty string, ignored");
+		else out.pack = pack;
+	}
+	if (byModel !== void 0) {
+		if (!isMapping(byModel)) warn("maid-veil: byModel must be a mapping of model-key → pack-id, ignored");
+		else {
+			const clean = {};
+			for (const [k, v] of Object.entries(byModel)) if (typeof v !== "string" || v === "") warn(`maid-veil: byModel['${k}'] must be a non-empty string, entry ignored`);
+			else clean[k] = v;
+			out.byModel = clean;
+		}
+	}
+	if (order !== void 0) {
+		if (typeof order !== "number" || !Number.isFinite(order)) warn(`maid-veil: order must be a finite number (got ${String(order)}), using default ${DEFAULT_VEIL_ORDER}`);
+		else out.order = order;
+	}
+	return out;
+}
+function parseBoundaryPack(raw, where, warn) {
+	if (raw === void 0) return void 0;
+	if (!isMapping(raw)) {
+		warn(`${where}: pack must be a mapping, skipped`);
+		return;
+	}
+	for (const key of Object.keys(raw)) if (!KNOWN_PACK_KEYS.has(key)) warn(`${where}: unknown field '${key}'`);
+	const { id, kind, name, text } = raw;
+	if (kind !== "boundary") {
+		warn(`${where}: kind must be boundary (got ${String(kind)}), skipped`);
+		return;
+	}
+	if (typeof id !== "string" || id === "") {
+		warn(`${where}: requires non-empty id, skipped`);
+		return;
+	}
+	if (typeof text !== "string" || text.trim() === "") {
+		warn(`${where}: requires non-empty text, skipped`);
+		return;
+	}
+	if (text.includes("{{")) {
+		warn(`${where}: text must not contain '{{' (prompt-variable interpolation face), skipped`);
+		return;
+	}
+	const out = {
+		id,
+		text
+	};
+	if (name !== void 0) {
+		if (typeof name !== "string" || name === "") warn(`${where}: name must be a non-empty string, ignored`);
+		else out.name = name;
+	}
+	return out;
+}
+//#endregion
+//#region src/index.ts
+const name = "maid-veil";
+/**
+* maid-veil(M3d 面纱与边界):boundary pack 装载 + 静态 systemPrompt 段注册。
+* preset 行挂载(agent scope,anchor/gestures 同层)——config 即选择器:
+*   pack: 默认集 id;byModel: provider/model 复合键 → 集 id;order: 段位(缺省 4100)。
+*
+* 生命周期(规格 §1):构造期一次读入、会话内零求值(铁律 3);cron 会话与 IM 会话
+* 同享(挂女仆本体非会话类型);maid:veil 不产生 durable 事件——system prompt 本身
+* durable,即铁律 4 的满足形态。
+*
+* 全 fail-open:config 无 pack → 合法零段;maidIdentity 缺席/pack 缺失或坏 →
+* one-shot warn + 零段(绝不炸装配);agentDefaultModel 缺席 → byModel 不可用,
+* 用默认集 + one-shot warn(规格 §7 风险 6 降级路径)。
+*/
+const inject = ["systemPrompt"];
+const apply = (ctx, config) => {
+	const logger = ctx.logger?.("maid-veil") ?? console;
+	const warn = (message) => {
+		logger.warn(message);
+	};
+	const warned = /* @__PURE__ */ new Set();
+	const warnOnce = (key, message) => {
+		if (warned.has(key)) return;
+		warned.add(key);
+		warn(message);
+	};
+	const selection = parseVeilConfig(config, warn);
+	if (selection.pack === void 0) return () => {};
+	const identityOf = () => {
+		const service = ctx.reflect?.get?.("maidIdentity", false);
+		return typeof service?.resolvePack === "function" ? service : void 0;
+	};
+	const identity = identityOf();
+	if (identity === void 0) {
+		warnOnce("no-identity", "maid-veil: maidIdentity 服务不在,零段挂载(fail-open)");
+		return () => {};
+	}
+	let packId = selection.pack;
+	const model = ctx.reflect?.get?.("agentDefaultModel", false);
+	if (model !== void 0 && typeof model.currentSelection === "function") try {
+		const current = model.currentSelection();
+		const key = `${current.provider}/${current.model}`;
+		if (typeof selection.byModel[key] === "string") packId = selection.byModel[key];
+	} catch (error) {
+		warnOnce("model-throw", `maid-veil: agentDefaultModel.currentSelection 抛错(${error.message}),用默认集`);
+	}
+	else warnOnce("no-model", "maid-veil: agentDefaultModel 服务不在,byModel 不可用,用默认集");
+	let raw;
+	try {
+		raw = identity.resolvePack(packId);
+	} catch (error) {
+		warnOnce(`resolve-throw:${packId}`, `maid-veil: resolvePack('${packId}') 抛错(${error.message}),零段挂载`);
+		return () => {};
+	}
+	const pack = parseBoundaryPack(raw, `maid-veil: pack '${packId}'`, warn);
+	if (pack === void 0) {
+		warnOnce(`bad-pack:${packId}`, `maid-veil: boundary pack '${packId}' 缺失或未过校验,零段挂载`);
+		return () => {};
+	}
+	const dispose = ctx.systemPrompt.section({
+		name: "maid:veil",
+		order: selection.order,
+		text: pack.text
+	});
+	return () => {
+		try {
+			dispose();
+		} catch {}
+	};
+};
+//#endregion
+export { DEFAULT_VEIL_ORDER, apply, inject, name, parseBoundaryPack, parseVeilConfig };

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@deepmaid/maid-veil",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.1-rc.2 <0.3"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "meta": {
+      "title": "Maid Veil",
+      "description": "面纱与边界 seam:boundary pack 装载 + 静态 maid:veil 段(按模型映射;产品默认 disabled,启用=删 disabled+真实集)。关闭=maid:veil 边界段不注入(即默认关闭形态,L1/L2 立场失为无声明)。"
+    }
+  },
+  "devDependencies": {
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.