wake-bridge 0.9.0-preview.8

package/docs/quickstart.md

@@ -0,0 +1,143 @@
+# First Wake Quickstart
+
+状态：`wake-bridge@0.9.0-preview.8` current onboarding。
+
+这条路径从全新安装走到第一条可审计 wake。它面向已经拥有 agent backend、runner、bridge service 或自制 frontend，并能实现精确 session 注入的用户。
+
+## 开始前先确认
+
+你需要两个彼此独立的接入面：
+
+1. **Host Adapter**：知道要唤醒的精确 session，并能启动、恢复或排队这个 session。Wake Bridge 不内置具体 agent 产品的唤醒方法。
+2. **Source Connector**：可选。它从论坛、邮件或群聊等来源读取事实；上游 credential 只由 Connector 保管。
+
+如果还没有 Host Adapter，可以先运行仓库附带的 [Reference Host Adapter](../examples/reference-host-adapter/README.md) 验证协议 wiring；其默认 stdout sink 不会真的启动 agent。
+
+## 1. 安装并创建 Agent Space
+
+当前 preview 支持 macOS arm64/x64、Node.js 20+ 和 SQLite CLI 3.33+：
+
+```sh
+npm install --global wake-bridge@preview
+wakebridge release-preflight
+
+wakebridge init \
+  --data-dir "/absolute/private/path/wakebridge/my-agent" \
+  --instance-id my-agent \
+  --owner-id my-agent \
+  --timezone Asia/Shanghai
+
+wakebridge release-preflight \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json"
+```
+
+`init` 创建 mode-600 config、owner credential 与 SQLite DB，不在 stdout 打印 token，也不会覆盖已有实例。一个 preview instance 只服务一个 Agent Space。
+
+## 2. 接入并启动 Host Adapter
+
+为你的 adapter 准备一个 [Host Adapter manifest](operations/out-of-process-host-adapter.md#1-operator-配置)，其中：
+
+- `adapter_kind` 必须与 adapter 创建 `HostSessionClient` 时完全一致；
+- `attention_channels` 必须包含随后事件与预约使用的 channel；
+- bootstrap token、每个 adapter process 的 route token、owner token 必须互不相同；
+- capability 和 `receipt_upper_bound` 只写真实验证过的能力。
+
+在含 bootstrap token 的受限环境中启动 daemon：
+
+```sh
+wakebridge doctor \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json" \
+  --host-adapters "/absolute/private/path/host-adapters.json"
+
+wakebridge daemon \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json" \
+  --host 127.0.0.1 --port 4311 \
+  --host-adapters "/absolute/private/path/host-adapters.json"
+```
+
+然后由 Host Adapter 使用 `wake-bridge/transport` 的 `HostSessionClient.open()` 登记：
+
+- 精确、opaque 的 `session_ref`；
+- 与事件相同的 `attention_channel`，下例使用 `life`；
+- credential-free loopback `route_origin`；
+- 独立的 per-process `route_token`。
+
+正常运行时 adapter 续租同一个 lease；重建 session 或显式 takeover 才增加 generation；关闭时调用 `close()`。完整代码见 [out-of-process contract](operations/out-of-process-host-adapter.md) 与 [中立可运行示例](../examples/reference-host-adapter/README.md)。
+
+## 3. 发送第一条受控 wake
+
+使用不含敏感正文的 resource reference，并让 channel 与 Host Adapter 登记值完全一致：
+
+```sh
+wakebridge emit \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json" \
+  --source manual \
+  --type quickstart.test \
+  --dedupe-key quickstart-first-wake-1 \
+  --attention-channel-hint life \
+  --resource "quickstart://first-wake"
+```
+
+正在运行的 daemon 会完成 tick 与 dispatch。检查结果：
+
+```sh
+wakebridge status \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json"
+
+wakebridge inspect \
+  --config "/absolute/private/path/wakebridge/my-agent/wakebridge.config.json"
+```
+
+成功证据分层如下：
+
+- 没有 live binding 时，batch 保持 `waiting_for_endpoint`；这不是事件丢失；
+- adapter 返回 HTTP 202 后，Core 最多记录 `transport_accepted`；
+- adapter 自己必须证明 wake 已进入精确 session；
+- agent 醒来后从 envelope 的 resource 读取权威来源，并通过 Wake Bridge MCP `attention_ack` 与 `attention_consume` 等工具提供 seen/consumed 证据。
+
+如果 batch 一直等待，先检查事件、Host Adapter manifest 与 session registration 的 `attention_channel` 是否一致；Wake Bridge 不会猜测或跨 channel 错投。
+
+## 4. 让 agent 自己使用 Wake Bridge
+
+把下面的 stdio command 按你的 harness 格式配置为 MCP server：
+
+```text
+wakebridge mcp --config /absolute/private/path/wakebridge/my-agent/wakebridge.config.json
+```
+
+运行 daemon 时，再通过 `WAKEBRIDGE_DAEMON_URL=http://127.0.0.1:4311` 让 MCP 的 Source control 工具访问同一个 authenticated daemon。不要把 owner token、Host Adapter token 或 provider credential 放进 prompt。
+
+agent 可以用 `attention_schedule` 为未来的自己建立 durable self-commitment。`eligible_after` 必须是带 `Z` 或数字 offset 的绝对 RFC3339 时间，`resource` 应指向未来醒来后可重新读取的权威位置；重复提交应复用稳定的 `idempotency_key`。
+
+可信 Host Adapter 观察到绑定 session 中真实用户消息被接受时，可以调用 `renewPresence()`。默认 policy 会在 presence lease 有效期内延后普通后台 claim，租约到期后自动重新进入调度；进程存活、窗口 focus、模型输出或 Wake 自己都不能冒充用户在场。
+
+## 5. 可选：启用 Source Connector
+
+先查看 catalog：
+
+```sh
+wakebridge connector-catalog
+```
+
+所有 Connector 默认 `disabled`。以小机知道为例，完整顺序固定为：
+
+```text
+configure → verify identity → bootstrap from-now → real UAT → enable
+```
+
+由 operator 启动独立 Connector，并让 daemon 使用 `--connectors /absolute/path/sources.json`。随后 owning agent 依次调用：
+
+1. `attention_source_status`
+2. `attention_source_verify("botlingknows")`
+3. `attention_source_bootstrap(...exact verified subject/binding...)`
+4. 用一条无敏感通知完成真实 wake UAT
+5. `attention_source_enable("botlingknows")`
+
+不要跳过 from-now bootstrap，不要手改 SQLite，也不要把上游 MCP URL 或 credential 传给 Wake Bridge 工具。详见 [Connector catalog](operations/connector-catalog.md)、[Source Connector contract](operations/source-connectors.md) 与 [小机知道 Connector](adapters/botlingknows.md)。
+
+## 6. 停止与保留数据
+
+Host Adapter 先关闭当前 session lease，再停止 daemon。若安装了 LaunchAgent，按 [release lifecycle](operations/release-lifecycle.md) 返回的精确 unload/uninstall 命令操作。
+
+卸载 package 或 service 不删除 config、SQLite、backup 和日志。数据删除是另一个需要显式备份与确认的动作。
+

package/docs/releases/0.9.0-preview.8.md

@@ -0,0 +1,44 @@
+# wake-bridge 0.9.0-preview.8
+
+候选日期：2026-09-07。公开发布日期：2026-09-09。状态：npm `preview` + GitHub pre-release。
+
+本版本重新收敛公开产品边界：Wake Bridge 支持版本化 Host Adapter Contract，不直接声明支持某个 agent CLI、Desktop
+或 runtime。具体接入方负责精确 session 的启动、恢复、注入、presence/activity observation、receipt 上界与真实时延 UAT。
+当前公共 adapter HTTP 202 仍最多产生 `transport_accepted` receipt；更高层 turn start 或 agent consumption 必须来自
+独立、可验证的宿主/agent evidence。
+
+## 公共宿主边界
+
+- README、架构、协议、project background、doctor 与 release runbook 不把具体 agent 产品列入支持矩阵；
+- `doctor` 只报告公共 out-of-process contract 与实际配置的 adapter，不探测或宣传产品 host；
+- 具体产品实现、fixture 和 UAT 不进入公共仓库或 tarball；
+- 新增中立 `examples/reference-host-adapter`，只依赖 `wake-bridge/transport`，演示 session open/renew/close、固定
+  envelope、attempt idempotency 与可信 presence/activity edge；示例 stdout sink 不冒充真实 agent wake。
+
+## Source Connector catalog
+
+- 新增 `wakebridge connector-catalog` 与公开 `connectorCatalog()`；所有条目默认 disabled；
+- 小机知道为 bundled `official_optional / available`，仍须 configure → verify → from-now bootstrap → UAT → enable；
+- Gmail 只标记为 `planned / not enableable`，并附公开进入条件；
+- Group Chat 保留为 reference/conformance fixture；当前 catalog 不包含未沟通、未验收的第三方来源；
+- 新增可选的小机知道保守 policy recipe；Connector 自身不携带默认唤醒决定。
+
+## 验证口径
+
+- public SDK、Host Adapter lifecycle/generation/receipt、Source Connector cursor/identity、CLI 与 release package 黑盒继续回归；
+- tarball 必须包含中立示例、catalog 文档与 Gmail planned status，且不包含具体产品 Host Adapter；
+- 全量测试固定 single fork，避免长 SQLite/loopback conformance 在逐文件 worker 轮换时触发 Vitest 汇报 RPC timeout；
+- `host_accepted` 仍不等于 `agent_started`、`agent_seen` 或 `agent_consumed`；
+- npm 默认 `latest` channel 不会被此 pre-release 改动；安装时必须显式使用 `wake-bridge@preview`。
+
+公共候选验收结果：22 个 test files / 104 tests 全部通过；公开 Markdown 相对链接检查通过。
+
+## 发布验收补充（2026-09-08）
+
+- clean tarball 在仓库外完成 install、init、external Host Adapter、presence、restart/takeover fencing、self-commitment 与 close/no-endpoint 演练；
+- 一个已有仓库外 Host Adapter consumer 仅替换为 preview.8 tarball 后，21 项 conformance 全部通过；
+- 小机知道 Connector 的公开实现覆盖 identity verify、from-now bootstrap 与 disabled-by-default gate；
+- 新增 [First Wake Quickstart](../quickstart.md) 与 GitHub 文档导航；
+- 具体产品 Host Adapter 历史实现和 CLI 入口已从发布 tarball 移除，使 artifact 与 `product_hosts_bundled=false` 一致。
+
+公开证据边界见 [verification](../verification.md)。

package/docs/verification.md

@@ -0,0 +1,19 @@
+# 公开验证口径
+
+状态：`wake-bridge@0.9.0-preview.8` release candidate。
+
+公共仓库用以下证据验证自身，不用具体宿主产品的现场结果代替通用契约：
+
+- Core durability：Event、Claim、Batch、outbox、retry 与 receipt 在 SQLite 中具有可恢复状态；
+- policy：immediate、scheduled、suppress、quiet hours、presence、inactivity watch 与 self-commitment；
+- Host Adapter contract：open、renew、close、takeover generation fencing、route credential separation 与 receipt upper bound；
+- Source Connector contract：manifest identity、from-now bootstrap、cursor CAS、dedupe、retry 与 `needs_attention`；
+- package black box：从 tarball 在仓库外安装后完成 import、init、daemon、emit、inspect、external Host Adapter、backup 与 service profile；
+- reference adapter：只依赖公开 `wake-bridge/transport` subpath，并通过独立 conformance tests。
+
+一次 HTTP 202 只证明 adapter transport 接受了请求。它不自动证明 agent session 已启动、agent 已看到消息或事项已处理。
+更高层 receipt 必须来自宿主或 agent 能实际观察到的证据。
+
+具体 Host Adapter 和 Source Connector 维护方仍须针对自己的版本完成真实登录、identity、restart、offline catch-up、latency、
+presence/activity 与 failure-semantics UAT。通过公共 contract 代表 compatibility，不代表 Wake Bridge 项目替第三方宿主提供运行保证。
+

package/examples/policies/botlingknows-conservative.json

@@ -0,0 +1,44 @@
+{
+  "schema_version": 1,
+  "policies": [
+    {
+      "id": "botlingknows-mention",
+      "version": 1,
+      "enabled": true,
+      "order": 100,
+      "match": { "source": "botlingknows", "type": "mention" },
+      "delivery": {
+        "mode": "immediate",
+        "quiet_hours_policy": "defer",
+        "foreground_presence_policy": "defer"
+      },
+      "batch": { "coalesce_by": "source", "max_events": 20, "window_ms": 30000 },
+      "target": { "attention_channel": "life" },
+      "reason_code": "botlingknows_mention"
+    },
+    {
+      "id": "botlingknows-other",
+      "version": 1,
+      "enabled": true,
+      "order": 50,
+      "match": { "source": "botlingknows" },
+      "delivery": {
+        "mode": "scheduled",
+        "scheduled_local_time": "09:00",
+        "quiet_hours_policy": "defer",
+        "foreground_presence_policy": "defer"
+      },
+      "batch": { "coalesce_by": "source", "max_events": 50, "window_ms": 60000 },
+      "target": { "attention_channel": "life" },
+      "reason_code": "botlingknows_daily"
+    },
+    {
+      "id": "default",
+      "version": 2,
+      "enabled": true,
+      "order": -1000000,
+      "match": {},
+      "delivery": { "mode": "suppress" }
+    }
+  ]
+}

package/examples/reference-host-adapter/README.md

@@ -0,0 +1,41 @@
+# Reference Host Adapter
+
+这是一个中立的 out-of-process Host Adapter v1 示例，不对应、也不声称支持任何具体 agent 产品。
+
+它演示：
+
+- 以 scoped host credential 登记一个精确 session 与 attention channel；
+- 只在本机 loopback 接收固定 Wake envelope；
+- 对同一个 `attempt_id` 幂等接受；
+- 定期 renew endpoint lease，退出时 close；
+- 由 host 在观察到真实用户/会话 edge 时显式上报 presence 与 activity。
+
+唯一需要接入方替换的是 `acceptWake`。这个回调必须把 envelope 交给 `session_ref` 指定的精确 session/task，并且只在
+宿主已经接受该 delivery 后 resolve。它如何启动或恢复 session、怎样在 busy 时排队、能否 cold push，以及多久真正
+启动 agent，全部属于该 Host Adapter 的能力与 UAT，不由 Wake Bridge Core 推断。
+
+## 运行示例
+
+先把 [host-adapters.json.example](host-adapters.json.example) 复制到私有配置目录，替换
+`tested_host_versions` 和 capability 声明，并让 daemon 使用 `--host-adapters` 加载它。Host bootstrap token 与 delivery
+route token 必须是两个不同的、至少 32 字符的随机值；不要写进 JSON、shell history 或仓库。
+
+构建 package 后启动示例：
+
+```sh
+export WAKEBRIDGE_DAEMON_ORIGIN=http://127.0.0.1:4311
+export WAKEBRIDGE_HOST_TOKEN='<host bootstrap token>'
+export WAKEBRIDGE_ROUTE_TOKEN='<different route token>'
+export WAKEBRIDGE_SESSION_REF='<exact host session id>'
+export WAKEBRIDGE_ATTENTION_CHANNEL=default
+node examples/reference-host-adapter/adapter.mjs
+```
+
+仓库自带的 `acceptWake` 只把 envelope 写到 stdout，因此只证明协议 wiring，不会启动 agent。接入真实宿主时：
+
+1. 用该宿主的公开、精确 session API 替换 stdout callback；
+2. 按真实行为填写 capability 与最强 receipt upper bound，不把 HTTP 202 写成 agent seen；
+3. 验收 idle、busy、restart、重复 delivery、session close、generation takeover、presence TTL 与 activity watch；
+4. 只有在这些 UAT 通过后，才由 adapter 维护者声明该 host/version 的支持等级。
+
+完整协议与安全边界见 [out-of-process Host Adapter runbook](../../docs/operations/out-of-process-host-adapter.md)。

package/examples/reference-host-adapter/adapter.mjs

@@ -0,0 +1,173 @@
+import { createServer } from "node:http";
+import { pathToFileURL } from "node:url";
+import {
+  HostSessionClient,
+  WakeBridgeSdkError,
+  validateLocalHostDeliveryRequest,
+} from "wake-bridge/transport";
+
+const DEFAULT_RENEW_INTERVAL_MS = 60_000;
+const MAX_ACCEPTED_ATTEMPTS = 1_000;
+
+function requireSecret(value, name) {
+  if (typeof value !== "string" || value.length < 32) {
+    throw new Error(`${name} must contain at least 32 characters`);
+  }
+  return value;
+}
+
+async function readJson(request) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of request) {
+    size += chunk.length;
+    if (size > 256 * 1024) throw new WakeBridgeSdkError("request body is too large", "invalid_host_delivery", 413);
+    chunks.push(chunk);
+  }
+  try {
+    return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+  } catch {
+    throw new WakeBridgeSdkError("request body is not valid JSON", "invalid_host_delivery", 400);
+  }
+}
+
+/**
+ * Minimal out-of-process Host Adapter lifecycle.
+ *
+ * `acceptWake` is the only host-specific seam. It must enqueue the fixed Wake
+ * envelope into the exact session named by `sessionRef`, and resolve only once
+ * that host has accepted ownership of the delivery.
+ */
+export class ReferenceHostAdapter {
+  constructor(options) {
+    this.daemonOrigin = options.daemonOrigin;
+    this.hostToken = requireSecret(options.hostToken, "hostToken");
+    this.routeToken = requireSecret(options.routeToken, "routeToken");
+    if (this.hostToken === this.routeToken) throw new Error("hostToken and routeToken must be distinct");
+    this.sessionRef = options.sessionRef;
+    this.attentionChannel = options.attentionChannel;
+    this.acceptWake = options.acceptWake;
+    this.port = options.port ?? 0;
+    this.renewIntervalMs = options.renewIntervalMs ?? DEFAULT_RENEW_INTERVAL_MS;
+    this.acceptedAttempts = new Set();
+    this.client = new HostSessionClient({
+      base_url: this.daemonOrigin,
+      host_token: this.hostToken,
+      adapter_kind: "reference_host",
+    });
+  }
+
+  async start() {
+    this.server = createServer((request, response) => {
+      void this.handleRequest(request, response);
+    });
+    await new Promise((resolve, reject) => {
+      this.server.once("error", reject);
+      this.server.listen(this.port, "127.0.0.1", resolve);
+    });
+    const address = this.server.address();
+    if (!address || typeof address === "string") throw new Error("reference adapter did not obtain a TCP address");
+    this.routeOrigin = `http://127.0.0.1:${address.port}`;
+    try {
+      this.registration = await this.client.open({
+        session_ref: this.sessionRef,
+        attention_channel: this.attentionChannel,
+        route_origin: this.routeOrigin,
+        route_token: this.routeToken,
+      });
+      this.lease = this.client.lease(this.registration);
+      this.renewTimer = setInterval(() => {
+        void this.client.renew(this.lease).catch((error) => {
+          process.stderr.write(`[reference-host-adapter] lease renew failed: ${String(error)}\n`);
+        });
+      }, this.renewIntervalMs);
+      this.renewTimer.unref();
+      return { route_origin: this.routeOrigin, registration: this.registration };
+    } catch (error) {
+      await new Promise((resolve) => this.server.close(resolve));
+      throw error;
+    }
+  }
+
+  async noteUserPresence(observationId) {
+    if (!this.lease) throw new Error("adapter is not started");
+    return this.client.renewPresence(this.lease, {
+      observed_by: "reference_host",
+      observation: observationId,
+    });
+  }
+
+  async noteSessionActivity(observationId, kind = "user_input") {
+    if (!this.lease) throw new Error("adapter is not started");
+    return this.client.observeActivity(this.lease, { observation_id: observationId, kind });
+  }
+
+  async close() {
+    if (this.renewTimer) clearInterval(this.renewTimer);
+    if (this.lease) {
+      try { await this.client.close(this.lease); } catch { /* lease expiry is a safe close fallback */ }
+    }
+    if (this.server?.listening) await new Promise((resolve) => this.server.close(resolve));
+  }
+
+  async handleRequest(request, response) {
+    try {
+      if (request.method !== "POST" || request.url !== "/v1/wakes") {
+        response.writeHead(404).end();
+        return;
+      }
+      if (request.headers.authorization !== `Bearer ${this.routeToken}`) {
+        response.writeHead(401).end();
+        return;
+      }
+      const delivery = validateLocalHostDeliveryRequest(await readJson(request));
+      if (request.headers["x-wakebridge-delivery-nonce"] !== delivery.delivery_nonce) {
+        response.writeHead(400).end();
+        return;
+      }
+      if (!this.acceptedAttempts.has(delivery.attempt_id)) {
+        await this.acceptWake({
+          session_ref: this.sessionRef,
+          wake: delivery.wake,
+          attempt_id: delivery.attempt_id,
+          delivery_nonce: delivery.delivery_nonce,
+        });
+        this.acceptedAttempts.add(delivery.attempt_id);
+        if (this.acceptedAttempts.size > MAX_ACCEPTED_ATTEMPTS) {
+          this.acceptedAttempts.delete(this.acceptedAttempts.values().next().value);
+        }
+      }
+      response.writeHead(202).end();
+    } catch (error) {
+      const status = error instanceof WakeBridgeSdkError ? error.status : 503;
+      response.writeHead(status).end();
+    }
+  }
+}
+
+async function main() {
+  const adapter = new ReferenceHostAdapter({
+    daemonOrigin: process.env.WAKEBRIDGE_DAEMON_ORIGIN ?? "http://127.0.0.1:4311",
+    hostToken: process.env.WAKEBRIDGE_HOST_TOKEN,
+    routeToken: process.env.WAKEBRIDGE_ROUTE_TOKEN,
+    sessionRef: process.env.WAKEBRIDGE_SESSION_REF ?? "reference-session",
+    attentionChannel: process.env.WAKEBRIDGE_ATTENTION_CHANNEL ?? "default",
+    port: Number(process.env.WAKEBRIDGE_REFERENCE_HOST_PORT ?? "4393"),
+    acceptWake: async (delivery) => {
+      // Replace this callback with the host's exact-session queue/injection API.
+      process.stdout.write(`${JSON.stringify({ accepted_by_demo_sink: true, ...delivery })}\n`);
+    },
+  });
+  const started = await adapter.start();
+  process.stderr.write(`[reference-host-adapter] listening at ${started.route_origin}\n`);
+  const shutdown = () => { void adapter.close().finally(() => process.exit(0)); };
+  process.once("SIGINT", shutdown);
+  process.once("SIGTERM", shutdown);
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+  });
+}

package/examples/reference-host-adapter/host-adapters.json.example

@@ -0,0 +1,26 @@
+{
+  "version": 1,
+  "adapters": [
+    {
+      "id": "reference-host-local",
+      "adapter_kind": "reference_host",
+      "adapter_version": "1.0.0",
+      "host_kind": "reference_host",
+      "tested_host_versions": ["replace-with-your-host/version"],
+      "token_env": "WAKEBRIDGE_HOST_TOKEN",
+      "attention_channels": ["default"],
+      "capabilities": {
+        "exact_live_route": true,
+        "cold_push": false,
+        "warm_resume": true,
+        "requires_live_binding": true,
+        "queue_when_busy": true,
+        "steer_when_busy": false,
+        "foreground_presence_observable": true,
+        "session_activity_observable": true,
+        "waiter_turn_settle_compatible": false
+      },
+      "receipt_upper_bound": "host_accepted"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "wake-bridge",
+  "version": "0.9.0-preview.8",
+  "description": "Local-first durable attention scheduler and wake bridge for agent harnesses",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reneyuxi0402/wake-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/reneyuxi0402/wake-bridge/issues"
+  },
+  "homepage": "https://github.com/reneyuxi0402/wake-bridge#readme",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./event": {
+      "types": "./dist/src/event-sdk.d.ts",
+      "import": "./dist/src/event-sdk.js"
+    },
+    "./source": {
+      "types": "./dist/src/source-sdk.d.ts",
+      "import": "./dist/src/source-sdk.js"
+    },
+    "./transport": {
+      "types": "./dist/src/transport-sdk.d.ts",
+      "import": "./dist/src/transport-sdk.js"
+    },
+    "./source/group-chat": {
+      "types": "./dist/src/adapters/group-chat.d.ts",
+      "import": "./dist/src/adapters/group-chat.js"
+    },
+    "./schema/event-v1": "./schemas/event-v1.schema.json",
+    "./schema/policy-v1": "./schemas/policy-v1.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/src",
+    "schemas",
+    "examples/reference-host-adapter",
+    "examples/policies/botlingknows-conservative.json",
+    "docs/quickstart.md",
+    "docs/verification.md",
+    "docs/operations/release-lifecycle.md",
+    "docs/operations/policies.md",
+    "docs/operations/source-ingress.md",
+    "docs/operations/public-sdk.md",
+    "docs/operations/operator-control.md",
+    "docs/operations/out-of-process-host-adapter.md",
+    "docs/operations/connector-catalog.md",
+    "docs/operations/source-connectors.md",
+    "docs/adapters/group-chat.md",
+    "docs/adapters/botlingknows.md",
+    "docs/adapters/gmail-planned.md",
+    "docs/operations/templates/sources.json.example",
+    "docs/operations/templates/botlingknows-connector.env.example",
+    "docs/releases/0.9.0-preview.8.md"
+  ],
+  "bin": {
+    "wakebridge": "dist/src/cli.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "os": ["darwin"],
+  "cpu": ["arm64", "x64"],
+  "keywords": ["agent", "attention", "scheduler", "host-adapter", "source-connector", "wake"],
+  "publishConfig": {
+    "access": "public",
+    "tag": "preview"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "prebuild": "node scripts/clean-dist.mjs",
+    "build": "tsc",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run build",
+    "test": "vitest run --testTimeout=30000 --pool=forks --poolOptions.forks.singleFork",
+    "dev": "tsx src/cli.ts"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}

package/schemas/event-v1.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/reneyuxi0402/wake-bridge/schemas/event-v1.schema.json",
+  "title": "Wake Bridge event contract v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "type", "dedupe_key", "resource"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "type": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "occurred_at": { "type": "string", "format": "date-time" },
+    "dedupe_key": { "type": "string", "minLength": 1, "maxLength": 500 },
+    "coalesce_key": { "type": ["string", "null"] },
+    "priority_hint": { "type": ["string", "null"] },
+    "attention_channel_hint": { "type": ["string", "null"] },
+    "actor_ref": { "type": ["string", "null"] },
+    "resource": {
+      "type": "object",
+      "required": ["uri"],
+      "properties": { "uri": { "type": "string", "minLength": 1, "maxLength": 2048 } }
+    },
+    "metadata": { "type": "object" },
+    "payload_preview": { "type": ["string", "null"], "maxLength": 500 },
+    "idempotency_key": { "type": ["string", "null"] }
+  }
+}