omp-onlyne 0.0.0-stage → 0.1.0

package/AGENTS.sample.md

@@ -0,0 +1,27 @@
+# Onlyne in this project
+
+A starting point for a project that hosts an Onlyne node. Copy what you need into the project's own `AGENTS.md`; the wording assumes the `omp-onlyne` plugin is loaded.
+
+## Reaching another node
+
+`msg` is the only entry:
+
+    msg({ delivery_kind: "ask reviewer to check the data", msg: "…", meta: { to: "reviewer" } })
+
+`delivery_kind` states the intent in plain language; the judge role turns it into an action. Put the references you already have in `meta` — `to`, `thread`, `in_reply_to {thread,seq}` or `{sender,id}`, `relation`, `message`, `scope`, `seq`.
+
+The tool is the whole surface. Do not look for a CLI, do not read the plugin source to learn the protocol, and do not open the node database to find out how it works.
+
+## Reading a result
+
+The first line of a result is the outcome. `admission: "accepted"` with `guarantee: "durable"` means the receiver recorded the message. `wait: "timed_out"` means no reply arrived within the wait, not that the send failed. Report the outcome and stop.
+
+A reply arrives by itself: the plugin injects it as an `onlyne.inbound` message and starts a turn. Do not poll after a send — no inbox scans, thread reads, evidence queries, log reads or database queries. Read state when the user asks about history, or when a fact the result did not carry is genuinely needed.
+
+## Subagent sessions
+
+A subagent can read its slice but cannot send. Return the reply text and the target so the main session can send it.
+
+## Local files
+
+`.onlyne/config.toml` holds the node id, region and bind address. The `omp.db` beside it is the node's own record, owned by the plugin; treat it as runtime state, not documentation.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dbydd
+
+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/README.md

@@ -1,3 +1,133 @@
-# Temporary Holding Version
+# omp-onlyne
 
-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.
+Onlyne v3 for OMP. One model entry, `msg({ delivery_kind, msg, meta })`, backed by
+thread-aware message admission, reply correlation and OMP's `judge` model role.
+
+The plugin owns the OMP integration: a local Onlyne HTTP node, project-scoped
+configuration, `onlyne://` reads, custom inbound messages and the `msg` tool.
+The protocol library is [`@onlyne/lib`](../lib).
+
+## Configuration
+
+Configuration belongs to the project at `<project>/.onlyne/config.toml`. It is
+not read from user-level plugin settings, so two projects on one machine keep
+separate identities. `/onlyne init` creates it; no file is required before the
+first run.
+
+```toml
+language = "en"
+
+[node]
+region = "urn:onlyne:region:research-chamber"
+id = "urn:onlyne:agent:lazuli"
+key_scope = "project"
+
+[server]
+bind = "127.0.0.1"
+
+[threads]
+page_size = 50
+```
+
+`region` is the required protocol membership and `id` is the stable node
+identity. They are independent; moving region does not change existing message
+references. `/onlyne init` suggests region from the current Tern session name
+and leaves the node id empty for the user. A short region is saved as
+`urn:onlyne:region:<encoded name>`.
+
+The listening port is allocated by the operating system at startup; the runtime
+derives the endpoint and publishes it through discovery. Discovery uses a seed
+address supplied during bootstrap and an HTTP candidate exchange stored in
+`.onlyne/omp.db`. DNS-SD is an optional same-link accelerator: install
+`bonjour-service` to enable it. The configuration does not contain endpoint,
+port, peers, task-spawn policy or supplement windows.
+
+`node.key_scope` names where the identity key lives. `project` keeps it in
+`<project>/.onlyne/keys`, which a git work tree must ignore; the node refuses to
+create it otherwise and names both escapes. `global` keeps it in
+`~/.config/onlyne/keys`, shared by every project on the machine. `none` runs the
+keyless loopback development binding, which refuses a non-loopback `bind`. A
+configuration without the key keeps reading the global store.
+
+`key_ref` is parsed but not enforced. The current development binding refuses a
+non-empty value and a non-loopback `bind`, because it authenticates with
+`Onlyne-Actor` only. Credential exchange and proof of possession remain a
+separate security proposal; leave both at their defaults for the first E2E.
+
+## Surface
+
+- `msg` — send, reply, read, manage threads and operate resources. The judge
+  role chooses the action and delivery plan; the result reports the plan that
+  ran. A new execution context belongs to the receiver; the sender never mints
+  one.
+- `onlyne://threads`, `onlyne://threads/<alias>`, `onlyne://threads/<alias>/messages/<seq>`,
+  `onlyne://conversations`, `onlyne://conversations/<sender>/<id>`,
+  `onlyne://messages/<sender>/<id>`, `onlyne://contexts`, `onlyne://inbox`,
+  `onlyne://outbound`, `onlyne://neighbors` — read-only views. List views accept
+  `page_size` (or `limit`) and `cursor`; a conversation holds both directions of one
+  exchange.
+- `onlyne://resources` reads the local node and peers whose key exchange is complete.
+  Each owner returns its authorized resources or an explicit failure. Select
+  `onlyne://resources/<encoded-owner>` for one owner's inventory and pagination.
+  A resource lives at `onlyne://resources/<encoded-owner>/<encoded-id>`, with
+  `/log`, `/log/<event-id>`, `/operations`, and `/operations/<operation-id>` reads.
+  Log pages accept an exclusive `since` event id. Resource reads belong to the
+  main OMP session because context records contain no resource grants.
+- Inbound messages arrive as `onlyne.inbound` custom messages. A supplement for
+  an existing context uses `onlyne.supplement` and `sendCustomMessage`.
+- Tern renders these messages as mailing-list letters: an `[onlyne]` subject,
+  sender, date, thread and reply headers, Markdown body, and a link to the
+  original entry. Other terminals show the same fields as text. Consumption
+  markers stay in the model payload and are hidden from the letter.
+- Consumption is confirmed only after the host observes the entry in an actual
+  provider request; submitting a custom message or tool result does not advance
+  the record.
+- `/onlyne` opens a domain rail, thread sidebar, message flow and domain node list.
+  Threads, messages and nodes scroll independently. The inbox opens from the sidebar.
+  Posting names the thread's owner and id; clicking an incoming message selects its
+  message reference for a reply. Reply routing currently follows the original
+  author and can land in another thread. `/onlyne settings` edits the project
+  configuration. `/onlyne init` writes a first config and starts the node; with
+  no config, `/onlyne` and `/onlyne settings` open the same bootstrap.
+
+Subagent sessions may read only the context slice attached to their own agent
+identity and may not send; the main agent owns the node identity and the reply
+path.
+
+The equivalent `msg` query uses `meta: { scope: "resources", op: "list" }`.
+An optional `owner` selects one inventory. The `describe`, `log`, `event`,
+`operations`, and `status` queries name `resource: { owner, id }`.
+`event` requires `event_id`; `status` requires `operation_id`.
+Paged queries accept `page_size` and `cursor`. A resource cursor requires one owner.
+
+## Language
+
+`/onlyne language en` and `/onlyne language zh-CN` save the project language.
+The command changes rendered text, judge prompts, and the registered `msg`
+description in the current session. Configuration forms preserve this setting.
+The optional top-level `language` setting takes precedence over `ONLYNE_LANG`,
+then `LC_ALL` or `LANG`. The default is English. Route names, protocol fields,
+error codes, diagnostic event names, and user messages keep their original values.
+
+`AGENTS.sample.md` is the agent-facing half of that surface. Copy it into the
+host project's `AGENTS.md`: it states that `msg` is the only entry, that a send's
+`admission` is the delivery fact rather than the wait, and that replies arrive as
+inbound messages so a send needs no polling.
+
+Select a domain node to request a key exchange. The viewer reads the
+peer's public key and shows both fingerprints before sending. Confirmation sends
+the signed introduction and records local approval. The peer's sidebar and message
+flow show the pending request. Both nodes become trusted after the peer approves. Committed
+trust changes notify the viewer immediately, including introductions received over
+HTTP, so an open viewer does not wait for maintenance to show a request or approval.
+
+## Run
+
+```sh
+bun install
+bun run --filter omp-onlyne check
+bun run --filter omp-onlyne test
+```
+
+The package is loaded by OMP through its `omp.extensions` field. It requires
+OMP 18.12.6 or newer.

package/index.ts

@@ -0,0 +1,55 @@
+import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+import { registerContextBinding } from "./src/binding.ts";
+import { ConfigError } from "./src/config.ts";
+import { registerMessageRenderers, registerProviderBoundary } from "./src/messages.ts";
+import { registerTodoRecovery } from "./src/todo.ts";
+import { startRuntime, stopRuntime, type RuntimeHost } from "./src/runtime.ts";
+import { registerMsgTool } from "./src/tool.ts";
+import { registerOnlyneUrls } from "./src/urls.ts";
+import { attachStatus, registerUi } from "./src/ui/index.ts";
+
+/**
+ * OMP extension entry. The factory runs for every session, including subagents;
+ * the network node belongs to the main session only. State recovery and the
+ * listener start on `session_start`, never during factory execution.
+ */
+export default function ompOnlyne(pi: ExtensionAPI, host: RuntimeHost = {}): void {
+	registerOnlyneUrls();
+	registerMessageRenderers(pi);
+	registerProviderBoundary(pi);
+	registerMsgTool(pi);
+	registerContextBinding(pi);
+	registerTodoRecovery(pi);
+	registerUi(pi);
+	let detachStatus: (() => void) | undefined;
+
+	pi.on("session_start", async (_event, ctx) => {
+		if (ctx.agent.kind !== "main") return;
+		if (ctx.hasUI) {
+			try {
+				detachStatus?.();
+				detachStatus = attachStatus(ctx);
+			} catch (error) {
+				pi.logger.warn("onlyne status widget could not be attached", {
+					error: error instanceof Error ? error.message : String(error),
+				});
+			}
+		}
+		try {
+			await startRuntime(pi, ctx, host);
+		} catch (error) {
+			// A project without a saved config is the normal first-run state; /onlyne init creates it.
+			if (error instanceof ConfigError && error.code === "missing") return;
+			pi.logger.warn("onlyne could not start for this project", {
+				error: error instanceof Error ? error.message : String(error),
+			});
+		}
+	});
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		if (ctx.agent.kind !== "main") return;
+		detachStatus?.();
+		detachStatus = undefined;
+		await stopRuntime();
+	});
+}

package/package.json

@@ -1,6 +1,63 @@
 {
-  "name": "omp-onlyne",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "omp-onlyne",
+	"version": "0.1.0",
+	"description": "Onlyne v3 for OMP: one msg tool, thread-aware attention and SystemOne delivery decisions",
+	"type": "module",
+	"main": "./index.ts",
+	"types": "./index.ts",
+	"license": "MIT",
+	"homepage": "https://github.com/dbydd/onlyne#readme",
+	"bugs": "https://github.com/dbydd/onlyne/issues",
+	"keywords": ["onlyne", "omp", "agent", "messaging", "tools"],
+	"publishConfig": { "access": "public" },
+	"engines": { "bun": ">=1.4.3" },
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/dbydd/onlyne.git",
+		"directory": "packages/omp-onlyne"
+	},
+	"files": [
+		"index.ts",
+		"src",
+		"AGENTS.sample.md",
+		"README.md",
+		"LICENSE"
+	],
+	"omp": {
+		"extensions": [
+			"./index.ts"
+		]
+	},
+	"exports": {
+		".": "./index.ts",
+		"./runtime": "./src/runtime.ts",
+		"./config": "./src/config.ts",
+		"./types": "./src/types.ts"
+	},
+	"scripts": {
+		"check": "tsc --noEmit",
+		"test": "bun test"
+	},
+	"dependencies": {
+		"@onlyne/lib": "^3.0.0",
+		"@onlyne/node-host": "^3.0.0"
+	},
+	"peerDependencies": {
+		"@oh-my-pi/pi-agent-core": "*",
+		"@oh-my-pi/pi-coding-agent": "*",
+		"@oh-my-pi/pi-tui": "*",
+		"omp-todo-more": ">=0.1.4"
+	},
+	"peerDependenciesMeta": {
+		"omp-todo-more": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@oh-my-pi/pi-agent-core": "18.12.6",
+		"@oh-my-pi/pi-coding-agent": "18.12.6",
+		"@oh-my-pi/pi-tui": "18.12.6",
+		"@types/bun": "latest",
+		"typescript": "latest"
+	}
+}

package/src/binding.ts

@@ -0,0 +1,132 @@
+import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
+import { AgentRegistry } from "@oh-my-pi/pi-coding-agent/registry/agent-registry";
+import { getRuntime, type PluginRuntime } from "./runtime.ts";
+
+let registryRegistered = false;
+
+/**
+ * Task-spawned sessions are bound to the context alias their dispatch named.
+ * The name is only the marker: the registry reference must still prove the
+ * session is a child of this node's main agent before any record is bound.
+ */
+export function registerContextBinding(pi: ExtensionAPI): void {
+	pi.on("tool_result", async (event, _ctx) => {
+		if (event.toolName !== "task") return;
+		const runtime = getRuntime();
+		if (runtime === undefined) return;
+		try {
+			const input = event.input;
+			const items = Array.isArray(input.tasks) ? input.tasks : [input];
+			const details = event.details as
+				| { progress?: unknown; results?: unknown }
+				| undefined;
+			for (const candidate of [...array(details?.progress), ...array(details?.results)]) {
+				const id = stringField(candidate, "id");
+				if (id === undefined) continue;
+				const index = numberField(candidate, "index");
+				const name = index === undefined ? undefined : stringField(items[index], "name");
+				const alias = aliasOf(name);
+				if (alias === undefined) continue;
+				await bind(runtime, alias, id);
+			}
+		} catch (error) {
+			pi.logger.warn("onlyne.context.binding.failed", {
+				error: error instanceof Error ? error.message : String(error),
+			});
+		}
+	});
+
+	if (registryRegistered) return;
+	registryRegistered = true;
+	AgentRegistry.global().onChange(event => {
+		const runtime = getRuntime();
+		if (runtime === undefined) return;
+		if (event.type === "removed") {
+			void updateState(runtime, event.ref.id, "lost").catch(report(pi));
+			return;
+		}
+		if (event.type === "status_changed") {
+			void updateState(runtime, event.ref.id, stateOf(event.ref.status)).catch(report(pi));
+			return;
+		}
+		const alias = aliasOf(event.ref.displayName);
+		if (alias === undefined) return;
+		void bind(runtime, alias, event.ref.id).catch(report(pi));
+	});
+}
+
+async function bind(
+	runtime: PluginRuntime,
+	alias: string,
+	agentId: string,
+): Promise<void> {
+	const existing = await runtime.contexts.find(alias);
+	if (existing === undefined) return;
+	if (existing.node_id !== runtime.config.node.id) return;
+	if (existing.main_agent_id !== runtime.mainAgentId) return;
+	if (existing.agent_id !== undefined && existing.agent_id !== agentId) return;
+	if (existing.agent_id === agentId && existing.session_file !== undefined) return;
+	const ref = AgentRegistry.global().get(agentId);
+	if (ref === undefined || ref.kind !== "sub" || ref.parentId !== runtime.mainAgentId) return;
+	await runtime.contexts.bind(alias, {
+		agent_id: agentId,
+		...(ref.sessionFile === null || ref.sessionFile === undefined ? {} : { session_file: ref.sessionFile }),
+		...(ref.parentId === undefined ? {} : { parent_id: ref.parentId }),
+	});
+}
+
+/** An alias-recorded update follows the bound agent id, never a display name. */
+async function updateState(
+	runtime: PluginRuntime,
+	agentId: string,
+	state: "idle" | "running" | "parked" | "lost",
+): Promise<void> {
+	const records = await runtime.contexts.list();
+	const record = records.find(candidate =>
+		candidate.node_id === runtime.config.node.id &&
+		candidate.main_agent_id === runtime.mainAgentId &&
+		candidate.agent_id === agentId,
+	);
+	if (record === undefined) return;
+	await runtime.contexts.updateState(record.alias, state);
+}
+
+/**
+ * The task name carries the alias; the host may append a numeric suffix to a
+ * repeated name. Nothing else about the name is trusted.
+ */
+function aliasOf(name: string | undefined): string | undefined {
+	if (name === undefined) return undefined;
+	return /^onlyne-(c-[0-9]+)(?:-[0-9]+)?$/.exec(name)?.[1];
+}
+
+function array(value: unknown): unknown[] {
+	return Array.isArray(value) ? value : [];
+}
+
+function stringField(value: unknown, key: string): string | undefined {
+	if (value === null || typeof value !== "object") return undefined;
+	const found = (value as Record<string, unknown>)[key];
+	return typeof found === "string" && found.length > 0 ? found : undefined;
+}
+
+function numberField(value: unknown, key: string): number | undefined {
+	if (value === null || typeof value !== "object") return undefined;
+	const found = (value as Record<string, unknown>)[key];
+	return typeof found === "number" && Number.isInteger(found) ? found : undefined;
+}
+
+function stateOf(status: string): "idle" | "running" | "parked" | "lost" {
+	if (status === "running") return "running";
+	if (status === "parked") return "parked";
+	if (status === "aborted") return "lost";
+	return "idle";
+}
+
+function report(pi: ExtensionAPI): (error: unknown) => void {
+	return error => {
+		pi.logger.warn("onlyne.context.state.failed", {
+			error: error instanceof Error ? error.message : String(error),
+		});
+	};
+}

package/src/bridge-text.ts

@@ -0,0 +1,109 @@
+import { createTranslator } from "@onlyne/node-host/i18n";
+
+const en = {
+	noDecision: "The inbound entry has no decision.",
+	noContextNamed: "The inbound decision named no context.",
+	contextLost: "{alias} is no longer bound; it needs an explicit new decision",
+	noLiveSession: "The execution context {context} has no live session; it must be bound again before it can receive messages.",
+	noTaskTool: "This OMP session has no native task tool.",
+	noChildIdentity: "The native task tool returned no child identity.",
+	deliveryReferences: "message {message}, thread {thread} seq {seq}",
+	subagentPreamble: "Read this onlyne delivery from {author} ({references}).",
+	subagentCannotSend: "This session cannot send a message. When you have an answer, call the msg tool once to draft it and report the draft id back:",
+	subagentDraftCall: 'msg({ delivery_kind: "draft the reply", msg: <your reply body>, meta: { op: "draft", to: {to}, relation: "reply", in_reply_to: { sender: {sender}, id: {id} } } })',
+	subagentNoRetry: "That call stores a draft and sends nothing; the main session sends it. Do not retry a refused send and do not poll for the outcome.",
+	subagentSolutionSpace: "The delivery decides the work; use the message as the task.",
+	labelInbound: "inbound",
+	labelSupplement: "supplement",
+
+	draftNeedsRelation: "A reply draft needs relation reply or followup and in_reply_to.",
+	draftChildScope: "A child may draft a reply only to the source message assigned to its context.",
+	draftChildCannotSend: "Return draft_id to the main session; a child cannot send a draft.",
+	draftNotFound: "No reply draft is named {id}.",
+	draftNeedsReference: "A reply draft needs in_reply_to {sender,id} or {thread,seq}.",
+	draftSourceUnavailable: "The draft source message is unavailable.",
+
+	contextNotRegistered: "No execution context is registered as {alias}.",
+	mainSummary: "Main OMP session",
+	storeClosed: "The Onlyne store is closed.",
+
+	todoContextRequired: "A todo decision needs a non-empty context alias.",
+	todoUnknownAction: "The judge returned an unknown todo action: {action}.",
+	todoAdapterApi: "omp-todo-more is installed but does not expose the todo state adapter API this plugin drives.",
+	todoRecordTypes: "omp-todo-more uses branch record types this omp-onlyne build does not understand.",
+	todoEmptyAssociate: "The judge chose associate, but the todo list is empty.",
+	todoNoSuchItem: 'The judge chose associate, but no todo item is titled "{title}".',
+	todoAmbiguousTitle: 'More than one todo item is titled "{title}"; the decision needs a phase.',
+	todoDuplicateTitle: 'The judge chose append, but the todo list already has an item titled "{title}"; associate instead.',
+	todoPhaseRequired: "An append decision needs a non-empty phase name.",
+	todoUnexpectedAction: "Unexpected todo action: {action}",
+	todoExplanationRequired: "An append decision needs an explanation or a non-empty message body.",
+	todoEstimateInvalid: "A todo estimate must be a positive whole number of minutes.",
+	todoMissingField: "The judge chose {action} without a {field}.",
+	todoGoalRequired: "The judge chose append into an empty list without the goal's objective, measure and doneWhen.",
+	todoNoSession: "No live OMP session owns this inbound todo decision; the todo remains owed by the inbound queue.",
+	todoMultipleSessions: "More than one live main OMP session is registered; the todo target is ambiguous.",
+	todoSourceLine: "Source: {source}/{seq} from {author}",
+	todoDefaultPhase: "Tasks",
+	todoBadMetadataVersion: "Onlyne todo decision entry {entry} uses an unsupported metadata version.",
+	todoNoDecisionRecord: "Onlyne todo decision entry {entry} records no decision.",
+	todoNoOrigins: "Onlyne todo metadata on entry {entry} has no origins array; the association cannot be replayed.",
+	todoNoLinks: "Onlyne todo metadata on entry {entry} has no links array; the association cannot be replayed.",
+	todoUnknownRecordedAction: "Onlyne todo decision on entry {entry} has an unknown action.",
+	todoMissingString: "Onlyne todo metadata on entry {entry} has no string {field}.",
+};
+
+const zh: Record<keyof typeof en, string> = {
+	noDecision: "这条入站记录没有对应的决策。",
+	noContextNamed: "入站决策没有指定上下文。",
+	contextLost: "{alias} 已不再绑定；需要一次显式的新决策",
+	noLiveSession: "执行上下文 {context} 没有活动会话；必须先重新绑定才能接收消息。",
+	noTaskTool: "这个 OMP 会话没有原生 task 工具。",
+	noChildIdentity: "原生 task 工具没有返回子代理标识。",
+	deliveryReferences: "消息 {message}，线程 {thread} 序号 {seq}",
+	subagentPreamble: "阅读这条来自 {author} 的 onlyne 投递（{references}）。",
+	subagentCannotSend: "本会话不能发送消息。得出答案后，调用一次 msg 工具起草回复，并把 draft id 报告回来：",
+	subagentDraftCall: 'msg({ delivery_kind: "起草回复", msg: <你的回复正文>, meta: { op: "draft", to: {to}, relation: "reply", in_reply_to: { sender: {sender}, id: {id} } } })',
+	subagentNoRetry: "这次调用只保存草稿，不发送任何消息；由主会话负责发送。不要重试被拒绝的发送，也不要轮询结果。",
+	subagentSolutionSpace: "投递内容决定要做什么；把消息本身当作任务。",
+	labelInbound: "入站",
+	labelSupplement: "补充",
+
+	draftNeedsRelation: "回复草稿需要 relation 为 reply 或 followup，并提供 in_reply_to。",
+	draftChildScope: "子代理只能对分配给它的上下文所对应的源消息起草回复。",
+	draftChildCannotSend: "把 draft_id 交回主会话；子代理不能发送草稿。",
+	draftNotFound: "没有名为 {id} 的回复草稿。",
+	draftNeedsReference: "回复草稿需要 in_reply_to {sender,id} 或 {thread,seq}。",
+	draftSourceUnavailable: "草稿的源消息不可用。",
+
+	contextNotRegistered: "没有注册名为 {alias} 的执行上下文。",
+	mainSummary: "OMP 主会话",
+	storeClosed: "Onlyne 存储已关闭。",
+
+	todoContextRequired: "todo 决策需要非空的上下文别名。",
+	todoUnknownAction: "judge 返回了未知的 todo 动作：{action}。",
+	todoAdapterApi: "已安装 omp-todo-more，但它没有暴露本插件所使用的 todo 状态适配接口。",
+	todoRecordTypes: "omp-todo-more 使用的分支记录类型是这个 omp-onlyne 构建无法理解的。",
+	todoEmptyAssociate: "judge 选择了 associate，但 todo 列表是空的。",
+	todoNoSuchItem: "judge 选择了 associate，但没有标题为“{title}”的 todo 项。",
+	todoAmbiguousTitle: "有多个 todo 项标题为“{title}”；决策需要指定阶段。",
+	todoDuplicateTitle: "judge 选择了 append，但 todo 列表已有标题为“{title}”的项；应改用 associate。",
+	todoPhaseRequired: "append 决策需要非空的阶段名。",
+	todoUnexpectedAction: "意外的 todo 动作：{action}",
+	todoExplanationRequired: "append 决策需要说明内容或非空的消息正文。",
+	todoEstimateInvalid: "todo 预估必须是正整数分钟。",
+	todoMissingField: "judge 选择了 {action}，但没有提供 {field}。",
+	todoGoalRequired: "judge 选择了向空列表 append，但没有提供目标的 objective、measure 和 doneWhen。",
+	todoNoSession: "没有活动的 OMP 会话持有这条入站 todo 决策；该 todo 仍由入站队列保留。",
+	todoMultipleSessions: "注册了多个活动的主 OMP 会话；todo 目标不明确。",
+	todoSourceLine: "来源：{source}/{seq}，来自 {author}",
+	todoDefaultPhase: "任务",
+	todoBadMetadataVersion: "条目 {entry} 上的 onlyne todo 决策使用了不支持的元数据版本。",
+	todoNoDecisionRecord: "条目 {entry} 上的 onlyne todo 决策没有记录任何决策内容。",
+	todoNoOrigins: "条目 {entry} 上的 onlyne todo 元数据没有 origins 数组；无法重放该关联。",
+	todoNoLinks: "条目 {entry} 上的 onlyne todo 元数据没有 links 数组；无法重放该关联。",
+	todoUnknownRecordedAction: "条目 {entry} 上的 onlyne todo 决策含有未知动作。",
+	todoMissingString: "条目 {entry} 上的 onlyne todo 元数据缺少字符串字段 {field}。",
+};
+
+export const bridgeText = createTranslator({ en, "zh-CN": zh });