soulnet-dsh 0.1.0

package/lib/commands.js

@@ -0,0 +1,94 @@
+import { t as NetworkError } from "./types-zwvjR1n5.js";
+//#region src/commands/index.ts
+const name = "soulmirror-commands";
+const inject = ["commands", "soulmirror"];
+const fail = (text) => ({
+	kind: "error",
+	text
+});
+const ok = (text) => ({
+	kind: "success",
+	text
+});
+function describeError(error) {
+	if (error instanceof NetworkError) return `${error.message} (code ${error.code})`;
+	return error instanceof Error ? error.message : String(error);
+}
+function apply(ctx) {
+	const net = ctx.soulmirror;
+	ctx.commands.register({
+		name: "card",
+		description: "Show my SoulMirror card URI (paste it to others so they can add me).",
+		async handler() {
+			try {
+				const identity = await net.identity();
+				if (identity === void 0) return fail("No SoulMirror identity yet. Create one in Settings → SoulMirror network.");
+				return ok(`SoulMirror card of ${identity.name} (${identity.fp}):\n${identity.cardUri}`);
+			} catch (error) {
+				return fail(`Could not read the card: ${describeError(error)}`);
+			}
+		}
+	});
+	ctx.commands.register({
+		name: "friends",
+		description: "List SoulMirror friends (presence, unread) and pending friend requests.",
+		async handler() {
+			try {
+				const [friends, pending] = await Promise.all([net.friends.list(), net.friends.pending()]);
+				let online = {};
+				try {
+					online = await net.presence(friends.map((f) => f.fp));
+				} catch {}
+				const lines = friends.map((f) => {
+					return `${(online[f.fp] ?? f.online) === true ? "●" : "○"} ${f.name}  ${f.fp}${f.unread > 0 ? `  (${f.unread} unread)` : ""}${f.typing === true ? "  typing…" : ""}`;
+				});
+				if (lines.length === 0) lines.push("(no friends yet — /add <card_uri> to send a request)");
+				if (pending.length > 0) {
+					lines.push("", `Pending requests (${pending.length}; accept/reject on the SoulMirror page):`);
+					for (const p of pending) lines.push(`  ${p.name}  ${p.fp}${p.greeting === "" ? "" : `  "${p.greeting}"`}`);
+				}
+				return ok(lines.join("\n"));
+			} catch (error) {
+				return fail(`Could not list friends: ${describeError(error)}`);
+			}
+		}
+	});
+	ctx.commands.register({
+		name: "add",
+		description: "Send a SoulMirror friend request: /add <card_uri> [note]",
+		input: { hint: "<card_uri> [note]" },
+		async handler(invocation) {
+			const raw = invocation.rawInput.trim();
+			if (raw === "") return fail("Usage: /add <card_uri> [note]");
+			const space = raw.search(/\s/);
+			const cardUri = space === -1 ? raw : raw.slice(0, space);
+			const note = space === -1 ? void 0 : raw.slice(space).trim();
+			try {
+				const parsed = await net.parseCard(cardUri);
+				const friend = await net.friends.add(cardUri, note === "" ? void 0 : note);
+				return ok(`Friend request sent to ${parsed.name !== "" ? parsed.name : friend.name} (${friend.fp}). Messages can be exchanged once they accept.`);
+			} catch (error) {
+				return fail(`Could not send the friend request: ${describeError(error)}`);
+			}
+		}
+	});
+	ctx.commands.register({
+		name: "soulmirror",
+		description: "Open the SoulMirror page: talk to your alter, watch its conversations with your friends, review its drafts.",
+		async handler() {
+			try {
+				const [friends, pending] = await Promise.all([net.friends.list(), net.friends.pending()]);
+				const unread = friends.reduce((sum, f) => sum + (f.unread > 0 ? f.unread : 0), 0);
+				const pendingDrafts = ctx.get("soulmirrorSessions")?.drafts.count() ?? 0;
+				return ok(`SoulMirror page: ${friends.length} friend(s), ${unread} unread, ${pending.length} pending request(s), ${pendingDrafts} draft(s) of your alter waiting for review. Open it from the "SoulMirror" entry at the sidebar foot (or pick "My alter" / a friend from the /soulmirror popup).`);
+			} catch (error) {
+				return fail(`Could not read the network state: ${describeError(error)}`);
+			}
+		}
+	});
+	ctx.logger.info("soulmirror-commands: registered /card, /friends, /add, /soulmirror");
+}
+//#endregion
+export { apply, inject, name };
+
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../src/commands/index.ts"],"sourcesContent":["/**\n * soulmirror-commands — host slash commands (`ctx.commands.register`):\n *\n *   /card                show this user's card URI\n *   /friends             list friends (presence, unread); the client half\n *                        decorates the bare invocation with a popup that opens\n *                        a friend's session\n *   /add <card_uri> [note]\n *                        send a friend request (the human typing the command\n *                        IS the approval; commands run outside a model turn, so\n *                        ctx.approval cannot be used here)\n *   /soulmirror          open the SoulMirror page (\"My alter\" + friends); the\n *                        client half decorates the bare invocation with a\n *                        popup (the page / one friend) — the host handler only\n *                        prints the hint, since a host command cannot drive\n *                        the browser UI\n *\n * Results are rendered by the composer and never enter model history.\n * No @deepseek-ai value imports (see ../index.ts header).\n */\nimport type { Context } from '@deepseek-ai/cordis'\nimport type { CommandResult } from '@deepseek-ai/dsh-commands'\n// Type-only: the ctx.commands Context merge.\nimport type {} from '@deepseek-ai/dsh-commands'\nimport { NetworkError } from '../network/types.ts'\nimport type {} from '../index.ts'\n\nexport const name = 'soulmirror-commands'\nexport const inject = ['commands', 'soulmirror']\n\nconst fail = (text: string): CommandResult => ({ kind: 'error', text })\nconst ok = (text: string): CommandResult => ({ kind: 'success', text })\n\nfunction describeError(error: unknown): string {\n  if (error instanceof NetworkError) return `${error.message} (code ${error.code})`\n  return error instanceof Error ? error.message : String(error)\n}\n\nexport function apply(ctx: Context): void {\n  const net = ctx.soulmirror\n\n  ctx.commands.register({\n    name: 'card',\n    description: 'Show my SoulMirror card URI (paste it to others so they can add me).',\n    async handler() {\n      try {\n        const identity = await net.identity()\n        if (identity === undefined) return fail('No SoulMirror identity yet. Create one in Settings → SoulMirror network.')\n        return ok(`SoulMirror card of ${identity.name} (${identity.fp}):\\n${identity.cardUri}`)\n      } catch (error: unknown) {\n        return fail(`Could not read the card: ${describeError(error)}`)\n      }\n    },\n  })\n\n  ctx.commands.register({\n    name: 'friends',\n    description: 'List SoulMirror friends (presence, unread) and pending friend requests.',\n    async handler() {\n      try {\n        const [friends, pending] = await Promise.all([net.friends.list(), net.friends.pending()])\n        let online: Record<string, boolean> = {}\n        try {\n          online = await net.presence(friends.map(f => f.fp))\n        } catch {\n          // best effort\n        }\n        const lines = friends.map((f) => {\n          const on = online[f.fp] ?? f.online\n          return `${on === true ? '●' : '○'} ${f.name}  ${f.fp}${f.unread > 0 ? `  (${f.unread} unread)` : ''}${f.typing === true ? '  typing…' : ''}`\n        })\n        if (lines.length === 0) lines.push('(no friends yet — /add <card_uri> to send a request)')\n        if (pending.length > 0) {\n          lines.push('', `Pending requests (${pending.length}; accept/reject on the SoulMirror page):`)\n          for (const p of pending) lines.push(`  ${p.name}  ${p.fp}${p.greeting === '' ? '' : `  \"${p.greeting}\"`}`)\n        }\n        return ok(lines.join('\\n'))\n      } catch (error: unknown) {\n        return fail(`Could not list friends: ${describeError(error)}`)\n      }\n    },\n  })\n\n  ctx.commands.register({\n    name: 'add',\n    description: 'Send a SoulMirror friend request: /add <card_uri> [note]',\n    input: { hint: '<card_uri> [note]' },\n    async handler(invocation) {\n      const raw = invocation.rawInput.trim()\n      if (raw === '') return fail('Usage: /add <card_uri> [note]')\n      const space = raw.search(/\\s/)\n      const cardUri = space === -1 ? raw : raw.slice(0, space)\n      const note = space === -1 ? undefined : raw.slice(space).trim()\n      try {\n        const parsed = await net.parseCard(cardUri)\n        const friend = await net.friends.add(cardUri, note === '' ? undefined : note)\n        return ok(`Friend request sent to ${parsed.name !== '' ? parsed.name : friend.name} (${friend.fp}). Messages can be exchanged once they accept.`)\n      } catch (error: unknown) {\n        return fail(`Could not send the friend request: ${describeError(error)}`)\n      }\n    },\n  })\n\n  ctx.commands.register({\n    name: 'soulmirror',\n    description: 'Open the SoulMirror page: talk to your alter, watch its conversations with your friends, review its drafts.',\n    async handler() {\n      try {\n        const [friends, pending] = await Promise.all([net.friends.list(), net.friends.pending()])\n        const unread = friends.reduce((sum, f) => sum + (f.unread > 0 ? f.unread : 0), 0)\n        const drafts = (ctx as unknown as { get(name: string): unknown }).get('soulmirrorSessions') as { drafts: { count(): number } } | undefined\n        const pendingDrafts = drafts?.drafts.count() ?? 0\n        return ok(`SoulMirror page: ${friends.length} friend(s), ${unread} unread, ${pending.length} pending request(s), ${pendingDrafts} draft(s) of your alter waiting for review. Open it from the \"SoulMirror\" entry at the sidebar foot (or pick \"My alter\" / a friend from the /soulmirror popup).`)\n      } catch (error: unknown) {\n        return fail(`Could not read the network state: ${describeError(error)}`)\n      }\n    },\n  })\n\n  ctx.logger.info('soulmirror-commands: registered /card, /friends, /add, /soulmirror')\n}\n"],"mappings":"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"}

package/lib/events-Cz7g9aXF.js

@@ -0,0 +1,134 @@
+import { i as normalizeTier } from "./policy-HQKLctKr.js";
+import { dirname, join } from "node:path";
+import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+//#region src/friend-settings.ts
+/**
+* The plugin's own per-friend settings (P3) and the diplomacy protocol file.
+*
+*   - `<home>/a2a/dsh-friends.json` — `{ friends: { [fp]: { tier } } }`: the
+*     reply tier per friend (`notify` | `draft` | `auto`). The peer's
+*     friends.yaml has no such field (the soulnet a2a package deliberately
+*     carries no auto_reply switch), so it lives beside the session map.
+*     The per-friend PROTOCOL OVERRIDE is NOT here: the peer stores it in
+*     friends.yaml (`friends.set {protocol}`), shared with SoulMirror.
+*   - `<home>/a2a/protocol.md` — the global diplomacy protocol. The peer
+*     writes the default text when the identity is created; this module
+*     reads it (cached by mtime so the prompt variable can be evaluated on
+*     every assembly) and writes it (Settings / page editor).
+*/
+const FRIEND_SETTINGS_FILE = "dsh-friends.json";
+const PROTOCOL_FILE = "protocol.md";
+/** In-memory copy of dsh-friends.json with write-through. */
+var FriendSettingsStore = class FriendSettingsStore {
+	path;
+	data = { friends: {} };
+	loaded = false;
+	constructor(path) {
+		this.path = path;
+	}
+	static at(a2aDir) {
+		return new FriendSettingsStore(join(a2aDir, FRIEND_SETTINGS_FILE));
+	}
+	async load() {
+		try {
+			const raw = JSON.parse(await readFile(this.path, "utf8"));
+			const friends = {};
+			for (const [fp, value] of Object.entries(raw.friends ?? {})) {
+				const v = typeof value === "object" && value !== null ? value : {};
+				friends[fp] = { ...v["tier"] === void 0 ? {} : { tier: normalizeTier(v["tier"]) } };
+			}
+			this.data = { friends };
+		} catch {
+			this.data = { friends: {} };
+		}
+		this.loaded = true;
+	}
+	get isLoaded() {
+		return this.loaded;
+	}
+	get(fp) {
+		return this.data.friends[fp] ?? {};
+	}
+	/** Tier of a friend, or `fallback` (the global default) when none is stored. */
+	tier(fp, fallback) {
+		return this.data.friends[fp]?.tier ?? fallback;
+	}
+	/** Every stored entry (fp → settings). */
+	all() {
+		return this.data.friends;
+	}
+	/** Patch one friend's settings; an explicit `tier: undefined` clears the stored tier (back to the global default). */
+	async set(fp, patch) {
+		const current = this.get(fp);
+		const tier = "tier" in patch ? patch.tier : current.tier;
+		if (tier === void 0) delete this.data.friends[fp];
+		else this.data.friends[fp] = {
+			...current,
+			tier
+		};
+		await mkdir(dirname(this.path), { recursive: true });
+		await writeFile(this.path, JSON.stringify(this.data, null, 2), "utf8");
+		return this.get(fp);
+	}
+	async remove(fp) {
+		if (!(fp in this.data.friends)) return;
+		delete this.data.friends[fp];
+		await writeFile(this.path, JSON.stringify(this.data, null, 2), "utf8");
+	}
+};
+/**
+* The global diplomacy protocol file. `read()` is synchronous and cached by
+* mtime so a prompt-variable provider can call it on every assembly; `write()`
+* replaces the file (and the cache).
+*/
+var ProtocolFile = class ProtocolFile {
+	path;
+	cache;
+	constructor(path) {
+		this.path = path;
+	}
+	static at(a2aDir) {
+		return new ProtocolFile(join(a2aDir, PROTOCOL_FILE));
+	}
+	/** Current text; `''` when the file does not exist yet (the peer writes it with the identity). */
+	read() {
+		try {
+			const stat = statSync(this.path);
+			if (this.cache !== void 0 && this.cache.mtimeMs === stat.mtimeMs && this.cache.size === stat.size) return this.cache.text;
+			const text = readFileSync(this.path, "utf8");
+			this.cache = {
+				mtimeMs: stat.mtimeMs,
+				size: stat.size,
+				text
+			};
+			return text;
+		} catch {
+			this.cache = void 0;
+			return "";
+		}
+	}
+	exists() {
+		try {
+			statSync(this.path);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	write(text) {
+		mkdirSync(dirname(this.path), { recursive: true });
+		writeFileSync(this.path, text, "utf8");
+		this.cache = void 0;
+	}
+};
+//#endregion
+//#region src/events.ts
+/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */
+const SOULMIRROR_PLUGIN = "soulmirror";
+/** `source.form` of that message: dsh's built-in "a message another agent addressed to this one". */
+const RELAY_FORM = "relay";
+//#endregion
+export { ProtocolFile as i, SOULMIRROR_PLUGIN as n, FriendSettingsStore as r, RELAY_FORM as t };
+
+//# sourceMappingURL=events-Cz7g9aXF.js.map

package/lib/events-Cz7g9aXF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-Cz7g9aXF.js","names":[],"sources":["../src/friend-settings.ts","../src/events.ts"],"sourcesContent":["/**\n * The plugin's own per-friend settings (P3) and the diplomacy protocol file.\n *\n *   - `<home>/a2a/dsh-friends.json` — `{ friends: { [fp]: { tier } } }`: the\n *     reply tier per friend (`notify` | `draft` | `auto`). The peer's\n *     friends.yaml has no such field (the soulnet a2a package deliberately\n *     carries no auto_reply switch), so it lives beside the session map.\n *     The per-friend PROTOCOL OVERRIDE is NOT here: the peer stores it in\n *     friends.yaml (`friends.set {protocol}`), shared with SoulMirror.\n *   - `<home>/a2a/protocol.md` — the global diplomacy protocol. The peer\n *     writes the default text when the identity is created; this module\n *     reads it (cached by mtime so the prompt variable can be evaluated on\n *     every assembly) and writes it (Settings / page editor).\n */\nimport { mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'\nimport { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { normalizeTier, type ReplyTier } from './policy.ts'\n\nexport const FRIEND_SETTINGS_FILE = 'dsh-friends.json'\nexport const PROTOCOL_FILE = 'protocol.md'\n\nexport interface FriendSettings {\n  readonly tier?: ReplyTier\n}\n\ninterface FriendSettingsFile {\n  friends: Record<string, FriendSettings>\n}\n\n/** In-memory copy of dsh-friends.json with write-through. */\nexport class FriendSettingsStore {\n  private data: FriendSettingsFile = { friends: {} }\n  private loaded = false\n\n  constructor(private readonly path: string) {}\n\n  static at(a2aDir: string): FriendSettingsStore {\n    return new FriendSettingsStore(join(a2aDir, FRIEND_SETTINGS_FILE))\n  }\n\n  async load(): Promise<void> {\n    try {\n      const raw = JSON.parse(await readFile(this.path, 'utf8')) as Partial<FriendSettingsFile>\n      const friends: Record<string, FriendSettings> = {}\n      for (const [fp, value] of Object.entries(raw.friends ?? {})) {\n        const v = (typeof value === 'object' && value !== null ? value : {}) as Record<string, unknown>\n        friends[fp] = { ...(v['tier'] === undefined ? {} : { tier: normalizeTier(v['tier']) }) }\n      }\n      this.data = { friends }\n    } catch {\n      this.data = { friends: {} }\n    }\n    this.loaded = true\n  }\n\n  get isLoaded(): boolean {\n    return this.loaded\n  }\n\n  get(fp: string): FriendSettings {\n    return this.data.friends[fp] ?? {}\n  }\n\n  /** Tier of a friend, or `fallback` (the global default) when none is stored. */\n  tier(fp: string, fallback: ReplyTier): ReplyTier {\n    return this.data.friends[fp]?.tier ?? fallback\n  }\n\n  /** Every stored entry (fp → settings). */\n  all(): Readonly<Record<string, FriendSettings>> {\n    return this.data.friends\n  }\n\n  /** Patch one friend's settings; an explicit `tier: undefined` clears the stored tier (back to the global default). */\n  async set(fp: string, patch: { tier?: ReplyTier | undefined }): Promise<FriendSettings> {\n    const current = this.get(fp)\n    const tier = 'tier' in patch ? patch.tier : current.tier\n    if (tier === undefined) delete this.data.friends[fp]\n    else this.data.friends[fp] = { ...current, tier }\n    await mkdir(dirname(this.path), { recursive: true })\n    await writeFile(this.path, JSON.stringify(this.data, null, 2), 'utf8')\n    return this.get(fp)\n  }\n\n  async remove(fp: string): Promise<void> {\n    if (!(fp in this.data.friends)) return\n    delete this.data.friends[fp]\n    await writeFile(this.path, JSON.stringify(this.data, null, 2), 'utf8')\n  }\n}\n\n/**\n * The global diplomacy protocol file. `read()` is synchronous and cached by\n * mtime so a prompt-variable provider can call it on every assembly; `write()`\n * replaces the file (and the cache).\n */\nexport class ProtocolFile {\n  private cache: { mtimeMs: number; size: number; text: string } | undefined\n\n  constructor(readonly path: string) {}\n\n  static at(a2aDir: string): ProtocolFile {\n    return new ProtocolFile(join(a2aDir, PROTOCOL_FILE))\n  }\n\n  /** Current text; `''` when the file does not exist yet (the peer writes it with the identity). */\n  read(): string {\n    try {\n      const stat = statSync(this.path)\n      if (this.cache !== undefined && this.cache.mtimeMs === stat.mtimeMs && this.cache.size === stat.size) return this.cache.text\n      const text = readFileSync(this.path, 'utf8')\n      this.cache = { mtimeMs: stat.mtimeMs, size: stat.size, text }\n      return text\n    } catch {\n      this.cache = undefined\n      return ''\n    }\n  }\n\n  exists(): boolean {\n    try {\n      statSync(this.path)\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  write(text: string): void {\n    mkdirSync(dirname(this.path), { recursive: true })\n    writeFileSync(this.path, text, 'utf8')\n    this.cache = undefined\n  }\n}\n","/**\n * Shared vocabulary of @startupworld-ai/soulnet-dsh: branded ids and the\n * `user/message` source tag that marks an inbound A2A mail.\n *\n * There is deliberately NO custom SessionEventMap merge here any more. The P0\n * spike (dsh/SPIKE.md §1) showed that a custom durable event type makes the\n * session log unloadable (the persistence read path refuses unknown,\n * non-ignorable types), so every inbound mail is written as an ordinary\n * `user/message` whose `source` carries the fields below; the client half\n * recognises that source and renders the message as a chat bubble.\n *\n * Keep this file free of runtime imports apart from constants: the client\n * bundle imports it as well.\n */\nimport type { Branded } from '@deepseek-ai/dsh-brand'\n\n/** Stable A2A message id (the relay envelope id; replay-safe). */\nexport type A2AMessageId = Branded<'A2AMessageId'>\n/** Fingerprint of a peer's signing key (the A2A identity). */\nexport type Fingerprint = Branded<'Fingerprint'>\n\n/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */\nexport const SOULMIRROR_PLUGIN = 'soulmirror'\n/** `source.form` of that message: dsh's built-in \"a message another agent addressed to this one\". */\nexport const RELAY_FORM = 'relay'\n\n/** The extra `a2a` block the host attaches to the relay source (wire-extensible; the literal type is closed upstream). */\nexport interface A2ASourceMeta {\n  readonly id: string\n  readonly fp: string\n  readonly ts: number\n  readonly auto?: true\n  /** A2A message type (`text`, `app_share`, …); absent means `text`. */\n  readonly type?: string\n}\n\n/** Shape the client renderer derives from such a `user/message` (one bubble). */\nexport interface A2AMessageData {\n  readonly id: A2AMessageId\n  /** `in`: friend → me; `out`: me → friend. */\n  readonly dir: 'in' | 'out'\n  /** Peer fingerprint (the friend this session belongs to). */\n  readonly fp: Fingerprint\n  /** Display name of the peer at send time. */\n  readonly name: string\n  readonly body: string\n  /** Unix epoch ms at the sender. */\n  readonly ts: number\n  /** Outbound delivery state; absent on inbound. */\n  readonly delivery?: 'queued' | 'sent' | 'failed'\n  /** Set when the message was produced by a peer's auto-reply (loop guard). */\n  readonly auto?: true\n}\n"],"mappings":"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"}

package/lib/events-DHPK3pow.js

@@ -0,0 +1,134 @@
+import { o as normalizeTier } from "./send-DcYQC5CC.js";
+import { dirname, join } from "node:path";
+import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+//#region src/friend-settings.ts
+/**
+* The plugin's own per-friend settings (P3) and the diplomacy protocol file.
+*
+*   - `<home>/a2a/dsh-friends.json` — `{ friends: { [fp]: { tier } } }`: the
+*     reply tier per friend (`notify` | `draft` | `auto`). The peer's
+*     friends.yaml has no such field (the soulnet a2a package deliberately
+*     carries no auto_reply switch), so it lives beside the session map.
+*     The per-friend PROTOCOL OVERRIDE is NOT here: the peer stores it in
+*     friends.yaml (`friends.set {protocol}`), shared with SoulMirror.
+*   - `<home>/a2a/protocol.md` — the global diplomacy protocol. The peer
+*     writes the default text when the identity is created; this module
+*     reads it (cached by mtime so the prompt variable can be evaluated on
+*     every assembly) and writes it (Settings / page editor).
+*/
+const FRIEND_SETTINGS_FILE = "dsh-friends.json";
+const PROTOCOL_FILE = "protocol.md";
+/** In-memory copy of dsh-friends.json with write-through. */
+var FriendSettingsStore = class FriendSettingsStore {
+	path;
+	data = { friends: {} };
+	loaded = false;
+	constructor(path) {
+		this.path = path;
+	}
+	static at(a2aDir) {
+		return new FriendSettingsStore(join(a2aDir, FRIEND_SETTINGS_FILE));
+	}
+	async load() {
+		try {
+			const raw = JSON.parse(await readFile(this.path, "utf8"));
+			const friends = {};
+			for (const [fp, value] of Object.entries(raw.friends ?? {})) {
+				const v = typeof value === "object" && value !== null ? value : {};
+				friends[fp] = { ...v["tier"] === void 0 ? {} : { tier: normalizeTier(v["tier"]) } };
+			}
+			this.data = { friends };
+		} catch {
+			this.data = { friends: {} };
+		}
+		this.loaded = true;
+	}
+	get isLoaded() {
+		return this.loaded;
+	}
+	get(fp) {
+		return this.data.friends[fp] ?? {};
+	}
+	/** Tier of a friend, or `fallback` (the global default) when none is stored. */
+	tier(fp, fallback) {
+		return this.data.friends[fp]?.tier ?? fallback;
+	}
+	/** Every stored entry (fp → settings). */
+	all() {
+		return this.data.friends;
+	}
+	/** Patch one friend's settings; an explicit `tier: undefined` clears the stored tier (back to the global default). */
+	async set(fp, patch) {
+		const current = this.get(fp);
+		const tier = "tier" in patch ? patch.tier : current.tier;
+		if (tier === void 0) delete this.data.friends[fp];
+		else this.data.friends[fp] = {
+			...current,
+			tier
+		};
+		await mkdir(dirname(this.path), { recursive: true });
+		await writeFile(this.path, JSON.stringify(this.data, null, 2), "utf8");
+		return this.get(fp);
+	}
+	async remove(fp) {
+		if (!(fp in this.data.friends)) return;
+		delete this.data.friends[fp];
+		await writeFile(this.path, JSON.stringify(this.data, null, 2), "utf8");
+	}
+};
+/**
+* The global diplomacy protocol file. `read()` is synchronous and cached by
+* mtime so a prompt-variable provider can call it on every assembly; `write()`
+* replaces the file (and the cache).
+*/
+var ProtocolFile = class ProtocolFile {
+	path;
+	cache;
+	constructor(path) {
+		this.path = path;
+	}
+	static at(a2aDir) {
+		return new ProtocolFile(join(a2aDir, PROTOCOL_FILE));
+	}
+	/** Current text; `''` when the file does not exist yet (the peer writes it with the identity). */
+	read() {
+		try {
+			const stat = statSync(this.path);
+			if (this.cache !== void 0 && this.cache.mtimeMs === stat.mtimeMs && this.cache.size === stat.size) return this.cache.text;
+			const text = readFileSync(this.path, "utf8");
+			this.cache = {
+				mtimeMs: stat.mtimeMs,
+				size: stat.size,
+				text
+			};
+			return text;
+		} catch {
+			this.cache = void 0;
+			return "";
+		}
+	}
+	exists() {
+		try {
+			statSync(this.path);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	write(text) {
+		mkdirSync(dirname(this.path), { recursive: true });
+		writeFileSync(this.path, text, "utf8");
+		this.cache = void 0;
+	}
+};
+//#endregion
+//#region src/events.ts
+/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */
+const SOULMIRROR_PLUGIN = "soulmirror";
+/** `source.form` of that message: dsh's built-in "a message another agent addressed to this one". */
+const RELAY_FORM = "relay";
+//#endregion
+export { ProtocolFile as i, SOULMIRROR_PLUGIN as n, FriendSettingsStore as r, RELAY_FORM as t };
+
+//# sourceMappingURL=events-DHPK3pow.js.map

package/lib/events-DHPK3pow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-DHPK3pow.js","names":[],"sources":["../src/friend-settings.ts","../src/events.ts"],"sourcesContent":["/**\n * The plugin's own per-friend settings (P3) and the diplomacy protocol file.\n *\n *   - `<home>/a2a/dsh-friends.json` — `{ friends: { [fp]: { tier } } }`: the\n *     reply tier per friend (`notify` | `draft` | `auto`). The peer's\n *     friends.yaml has no such field (the soulnet a2a package deliberately\n *     carries no auto_reply switch), so it lives beside the session map.\n *     The per-friend PROTOCOL OVERRIDE is NOT here: the peer stores it in\n *     friends.yaml (`friends.set {protocol}`), shared with SoulMirror.\n *   - `<home>/a2a/protocol.md` — the global diplomacy protocol. The peer\n *     writes the default text when the identity is created; this module\n *     reads it (cached by mtime so the prompt variable can be evaluated on\n *     every assembly) and writes it (Settings / page editor).\n */\nimport { mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'\nimport { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { normalizeTier, type ReplyTier } from './policy.ts'\n\nexport const FRIEND_SETTINGS_FILE = 'dsh-friends.json'\nexport const PROTOCOL_FILE = 'protocol.md'\n\nexport interface FriendSettings {\n  readonly tier?: ReplyTier\n}\n\ninterface FriendSettingsFile {\n  friends: Record<string, FriendSettings>\n}\n\n/** In-memory copy of dsh-friends.json with write-through. */\nexport class FriendSettingsStore {\n  private data: FriendSettingsFile = { friends: {} }\n  private loaded = false\n\n  constructor(private readonly path: string) {}\n\n  static at(a2aDir: string): FriendSettingsStore {\n    return new FriendSettingsStore(join(a2aDir, FRIEND_SETTINGS_FILE))\n  }\n\n  async load(): Promise<void> {\n    try {\n      const raw = JSON.parse(await readFile(this.path, 'utf8')) as Partial<FriendSettingsFile>\n      const friends: Record<string, FriendSettings> = {}\n      for (const [fp, value] of Object.entries(raw.friends ?? {})) {\n        const v = (typeof value === 'object' && value !== null ? value : {}) as Record<string, unknown>\n        friends[fp] = { ...(v['tier'] === undefined ? {} : { tier: normalizeTier(v['tier']) }) }\n      }\n      this.data = { friends }\n    } catch {\n      this.data = { friends: {} }\n    }\n    this.loaded = true\n  }\n\n  get isLoaded(): boolean {\n    return this.loaded\n  }\n\n  get(fp: string): FriendSettings {\n    return this.data.friends[fp] ?? {}\n  }\n\n  /** Tier of a friend, or `fallback` (the global default) when none is stored. */\n  tier(fp: string, fallback: ReplyTier): ReplyTier {\n    return this.data.friends[fp]?.tier ?? fallback\n  }\n\n  /** Every stored entry (fp → settings). */\n  all(): Readonly<Record<string, FriendSettings>> {\n    return this.data.friends\n  }\n\n  /** Patch one friend's settings; an explicit `tier: undefined` clears the stored tier (back to the global default). */\n  async set(fp: string, patch: { tier?: ReplyTier | undefined }): Promise<FriendSettings> {\n    const current = this.get(fp)\n    const tier = 'tier' in patch ? patch.tier : current.tier\n    if (tier === undefined) delete this.data.friends[fp]\n    else this.data.friends[fp] = { ...current, tier }\n    await mkdir(dirname(this.path), { recursive: true })\n    await writeFile(this.path, JSON.stringify(this.data, null, 2), 'utf8')\n    return this.get(fp)\n  }\n\n  async remove(fp: string): Promise<void> {\n    if (!(fp in this.data.friends)) return\n    delete this.data.friends[fp]\n    await writeFile(this.path, JSON.stringify(this.data, null, 2), 'utf8')\n  }\n}\n\n/**\n * The global diplomacy protocol file. `read()` is synchronous and cached by\n * mtime so a prompt-variable provider can call it on every assembly; `write()`\n * replaces the file (and the cache).\n */\nexport class ProtocolFile {\n  private cache: { mtimeMs: number; size: number; text: string } | undefined\n\n  constructor(readonly path: string) {}\n\n  static at(a2aDir: string): ProtocolFile {\n    return new ProtocolFile(join(a2aDir, PROTOCOL_FILE))\n  }\n\n  /** Current text; `''` when the file does not exist yet (the peer writes it with the identity). */\n  read(): string {\n    try {\n      const stat = statSync(this.path)\n      if (this.cache !== undefined && this.cache.mtimeMs === stat.mtimeMs && this.cache.size === stat.size) return this.cache.text\n      const text = readFileSync(this.path, 'utf8')\n      this.cache = { mtimeMs: stat.mtimeMs, size: stat.size, text }\n      return text\n    } catch {\n      this.cache = undefined\n      return ''\n    }\n  }\n\n  exists(): boolean {\n    try {\n      statSync(this.path)\n      return true\n    } catch {\n      return false\n    }\n  }\n\n  write(text: string): void {\n    mkdirSync(dirname(this.path), { recursive: true })\n    writeFileSync(this.path, text, 'utf8')\n    this.cache = undefined\n  }\n}\n","/**\n * Shared vocabulary of soulnet-dsh: branded ids and the\n * `user/message` source tag that marks an inbound A2A mail.\n *\n * There is deliberately NO custom SessionEventMap merge here any more. The P0\n * spike (dsh/SPIKE.md §1) showed that a custom durable event type makes the\n * session log unloadable (the persistence read path refuses unknown,\n * non-ignorable types), so every inbound mail is written as an ordinary\n * `user/message` whose `source` carries the fields below; the client half\n * recognises that source and renders the message as a chat bubble.\n *\n * P4: the same relay source also carries the plugin's own NOTES into the\n * alter session (the owner approved / rejected / edited a draft) — marked by\n * `a2a.note`, never woken as a turn, rendered as a system line.\n *\n * Keep this file free of runtime imports apart from constants: the client\n * bundle imports it as well.\n */\nimport type { Branded } from '@deepseek-ai/dsh-brand'\n\n/** Stable A2A message id (the relay envelope id; replay-safe). */\nexport type A2AMessageId = Branded<'A2AMessageId'>\n/** Fingerprint of a peer's signing key (the A2A identity). */\nexport type Fingerprint = Branded<'Fingerprint'>\n\n/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */\nexport const SOULMIRROR_PLUGIN = 'soulmirror'\n/** `source.form` of that message: dsh's built-in \"a message another agent addressed to this one\". */\nexport const RELAY_FORM = 'relay'\n\n/** Kinds of plugin notes written into the alter session (P4 draft decisions). */\nexport type A2ANoteKind = 'draft-approved' | 'draft-rejected' | 'draft-revise'\n\n/** The extra `a2a` block the host attaches to the relay source (wire-extensible; the literal type is closed upstream). */\nexport interface A2ASourceMeta {\n  readonly id: string\n  readonly fp: string\n  readonly ts: number\n  readonly auto?: true\n  /** A2A message type (`text`, `app_share`, …); absent means `text`. */\n  readonly type?: string\n  /** Set on the plugin's own notes (draft decisions): not mail, never a turn trigger. */\n  readonly note?: A2ANoteKind\n  /** Draft id the note refers to. */\n  readonly draftId?: string\n}\n\n/** Shape the client renderer derives from such a `user/message` (one bubble). */\nexport interface A2AMessageData {\n  readonly id: A2AMessageId\n  /** `in`: friend → me; `out`: me → friend. */\n  readonly dir: 'in' | 'out'\n  /** Peer fingerprint (the friend this message belongs to). */\n  readonly fp: Fingerprint\n  /** Display name of the peer at send time. */\n  readonly name: string\n  readonly body: string\n  /** Unix epoch ms at the sender. */\n  readonly ts: number\n  /** Outbound delivery state; absent on inbound. */\n  readonly delivery?: 'queued' | 'sent' | 'failed'\n  /** Set when the message was produced by a peer's auto-reply (loop guard). */\n  readonly auto?: true\n  /** Set when the row is a plugin note (draft decision), not mail. */\n  readonly note?: A2ANoteKind\n}\n"],"mappings":"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"}

package/lib/events-DViXNRAZ.js

@@ -0,0 +1,9 @@
+//#region src/events.ts
+/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */
+const SOULMIRROR_PLUGIN = "soulmirror";
+/** `source.form` of that message: dsh's built-in "a message another agent addressed to this one". */
+const RELAY_FORM = "relay";
+//#endregion
+export { SOULMIRROR_PLUGIN as n, RELAY_FORM as t };
+
+//# sourceMappingURL=events-DViXNRAZ.js.map

package/lib/events-DViXNRAZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-DViXNRAZ.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["/**\n * Shared vocabulary of @startupworld-ai/soulnet-dsh: branded ids and the\n * `user/message` source tag that marks an inbound A2A mail.\n *\n * There is deliberately NO custom SessionEventMap merge here any more. The P0\n * spike (dsh/SPIKE.md §1) showed that a custom durable event type makes the\n * session log unloadable (the persistence read path refuses unknown,\n * non-ignorable types), so every inbound mail is written as an ordinary\n * `user/message` whose `source` carries the fields below; the client half\n * recognises that source and renders the message as a chat bubble.\n *\n * Keep this file free of runtime imports apart from constants: the client\n * bundle imports it as well.\n */\nimport type { Branded } from '@deepseek-ai/dsh-brand'\n\n/** Stable A2A message id (the relay envelope id; replay-safe). */\nexport type A2AMessageId = Branded<'A2AMessageId'>\n/** Fingerprint of a peer's signing key (the A2A identity). */\nexport type Fingerprint = Branded<'Fingerprint'>\n\n/** `source.plugin` of the `user/message` carrying an inbound A2A mail. */\nexport const SOULMIRROR_PLUGIN = 'soulmirror'\n/** `source.form` of that message: dsh's built-in \"a message another agent addressed to this one\". */\nexport const RELAY_FORM = 'relay'\n\n/** The extra `a2a` block the host attaches to the relay source (wire-extensible; the literal type is closed upstream). */\nexport interface A2ASourceMeta {\n  readonly id: string\n  readonly fp: string\n  readonly ts: number\n  readonly auto?: true\n  /** A2A message type (`text`, `app_share`, …); absent means `text`. */\n  readonly type?: string\n}\n\n/** Shape the client renderer derives from such a `user/message` (one bubble). */\nexport interface A2AMessageData {\n  readonly id: A2AMessageId\n  /** `in`: friend → me; `out`: me → friend. */\n  readonly dir: 'in' | 'out'\n  /** Peer fingerprint (the friend this session belongs to). */\n  readonly fp: Fingerprint\n  /** Display name of the peer at send time. */\n  readonly name: string\n  readonly body: string\n  /** Unix epoch ms at the sender. */\n  readonly ts: number\n  /** Outbound delivery state; absent on inbound. */\n  readonly delivery?: 'queued' | 'sent' | 'failed'\n  /** Set when the message was produced by a peer's auto-reply (loop guard). */\n  readonly auto?: true\n}\n"],"mappings":";;AAsBA,MAAa,oBAAoB;;AAEjC,MAAa,aAAa"}