@pnds/pond 1.5.0 → 1.6.1

package/openclaw.plugin.json

@@ -1,6 +1,11 @@
 {
   "id": "pond",
   "channels": ["pond"],
+  "skills": [
+    "./skills/pond-wiki",
+    "./skills/pond-tasks",
+    "./skills/pond-platform"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnds/pond",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "OpenClaw channel plugin for Pond IM",
   "license": "MIT",
   "repository": {
@@ -11,13 +11,12 @@
   "type": "module",
   "files": [
     "src",
-    "TOOLS.md",
+    "skills",
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@sinclair/typebox": "^0.34.48",
-    "@pnds/cli": "1.5.0",
-    "@pnds/sdk": "1.5.0"
+    "@pnds/cli": "1.6.1",
+    "@pnds/sdk": "1.6.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/skills/pond-platform/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pond-platform
+description: "Pond platform queries: list org members, agents, chats, read message history, check identity. Use when: user asks about org members, who's online, chat history, agent list, or identity/auth questions."
+---
+
+# Pond Platform
+
+Query organization data via the Pond CLI. Auth is pre-configured.
+
+## Identity
+
+```bash
+npx @pnds/cli@latest whoami
+```
+
+## Members & Agents
+
+```bash
+npx @pnds/cli@latest members list          # All org members (humans + agents)
+npx @pnds/cli@latest agents list           # Agents only
+npx @pnds/cli@latest users get usr_xxx     # Get user details by ID
+```
+
+## Chats & Messages
+
+```bash
+npx @pnds/cli@latest chats list            # List all chats
+npx @pnds/cli@latest messages list cht_xxx # Read chat message history
+```
+
+## Sending Messages
+
+Each `[Event: message.new]` includes `[Chat: ... (cht_xxx)]` — always use that chat ID explicitly.
+
+```bash
+# Reply to a chat (use the chat ID from the event)
+npx @pnds/cli@latest messages send cht_xxx --text "Your reply"
+
+# Direct message by user ID or display name
+npx @pnds/cli@latest dm usr_xxx --text "Hello"
+npx @pnds/cli@latest dm "Alice" --text "Hello"
+
+# Thread reply
+npx @pnds/cli@latest messages send cht_xxx --text "Reply" --thread-root-id 01JWC...
+
+# FYI message (no response expected)
+npx @pnds/cli@latest messages send cht_xxx --text "FYI: done" --no-reply
+```
+
+All CLI output is JSON.

package/skills/pond-tasks/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: pond-tasks
+description: "Pond task operations: create, update, comment on, and query tasks and projects. Use when: user asks to create a task, update task status, add comments, list tasks, or manage projects."
+---
+
+# Pond Tasks
+
+Manage tasks and projects via the Pond CLI. Auth and runtime context are pre-configured.
+
+## Task Commands
+
+```bash
+# List tasks (filterable by status)
+npx @pnds/cli@latest tasks list
+npx @pnds/cli@latest tasks list --status todo
+npx @pnds/cli@latest tasks list --status in_progress
+
+# Create a task
+npx @pnds/cli@latest tasks create --title "Task title" [--assignee-id usr_xxx] [--project-id prj_xxx]
+
+# Update task status
+npx @pnds/cli@latest tasks update tsk_xxx --status in_progress
+npx @pnds/cli@latest tasks update tsk_xxx --status done
+
+# Add a comment
+npx @pnds/cli@latest tasks comments add tsk_xxx --body "Progress update..."
+```
+
+## Project Commands
+
+```bash
+npx @pnds/cli@latest projects list
+```
+
+## Responding to Task Assignments
+
+When you receive `[Event: task.assigned]`:
+
+1. Acknowledge with a comment: `tasks comments add tsk_xxx --body "On it"`
+2. Update status: `tasks update tsk_xxx --status in_progress`
+3. Do the work
+4. Report results via comment and update status to `done`
+
+All CLI output is JSON.

package/skills/pond-wiki/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: pond-wiki
+description: "Pond wiki operations: read, search, edit, and propose changes to organization knowledge bases. Use when: user asks to read/write docs, edit wiki pages, search knowledge base, propose changes, or review changesets."
+---
+
+# Pond Wiki
+
+Manage organization wikis via the Pond CLI. Auth is pre-configured.
+
+## Browsing (no local state needed)
+
+```bash
+npx @pnds/cli@latest wiki list                       # List all wikis
+npx @pnds/cli@latest wiki tree <slug>                 # List files and directories
+npx @pnds/cli@latest wiki tree <slug> --path docs/    # List a subdirectory
+```
+
+## Editing
+
+Wiki editing works on a **local workspace** — a directory on disk where wiki
+files are synced. You sync from the server, edit files locally, then propose
+a changeset.
+
+### Step 1: Sync
+
+```bash
+npx @pnds/cli@latest wiki sync <slug>
+```
+
+This downloads wiki files to a local directory. The output includes the
+**absolute mount path** for each wiki (e.g. `synced → /data/.openclaw/workspace/kb`).
+
+### Step 2: Find the mount path
+
+The sync output JSON contains `synced[].path` — the absolute path where files
+live. You can also check it anytime with:
+
+```bash
+npx @pnds/cli@latest wiki status <slug>
+```
+
+The output includes `Mount: /absolute/path/to/<slug>`.
+
+Use this path with `read`, `write`, and `edit` tools. For example, if the mount
+is `/data/.openclaw/workspace/kb`, then `README.md` is at
+`/data/.openclaw/workspace/kb/README.md`.
+
+### Step 3: Edit files
+
+Use standard file tools (`read`, `write`, `edit`) on files under the mount path.
+
+### Step 4: Review changes
+
+```bash
+npx @pnds/cli@latest wiki diff <slug>       # Shows unified diff of all local changes
+npx @pnds/cli@latest wiki status <slug>     # Shows which files changed with +/- line counts
+```
+
+Always review before proposing.
+
+### Step 5: Propose changeset
+
+```bash
+npx @pnds/cli@latest wiki changeset create <slug> --title "Description of changes"
+```
+
+This uploads your local changes as a changeset for review.
+
+## Changeset Management
+
+```bash
+npx @pnds/cli@latest wiki changeset list <slug>               # List all changesets
+npx @pnds/cli@latest wiki changeset show <changesetId> <slug> # Show detail + feedback
+npx @pnds/cli@latest wiki changeset diff <changesetId> <slug> # Show changeset diff
+```
+
+If a changeset is rejected, fix the files locally and re-propose:
+
+```bash
+npx @pnds/cli@latest wiki changeset create <slug> --update <changesetId>
+```
+
+The title is inherited from the original changeset — no need to repeat it.
+
+## Discarding local changes
+
+```bash
+npx @pnds/cli@latest wiki reset <slug>      # Restore all files to last synced state
+```
+
+## History
+
+```bash
+npx @pnds/cli@latest wiki log <slug>        # Recent wiki operations
+```
+
+All CLI output is JSON. Run `npx @pnds/cli@latest wiki --help` for full options.

package/src/config-manager.ts

@@ -19,11 +19,7 @@ interface ConfigManagerOpts {
 
 const CACHE_FILENAME = "pond-platform-config.json";
 
-/** All tool names registered by this plugin — must stay in sync with registerPondWikiTools. */
-const POND_TOOL_NAMES = [
-  "wiki_list", "wiki_status", "wiki_diff", "wiki_tree", "wiki_blob",
-  "wiki_search", "wiki_query", "wiki_outline", "wiki_section", "wiki_changeset_diff", "wiki_propose",
-];
+/** Tool names are no longer registered — all operations go through CLI. */
 
 function cachePath(stateDir: string): string {
   return path.join(stateDir, CACHE_FILENAME);
@@ -97,16 +93,7 @@ function applyToOpenClawConfig(
     existing.agents = agents;
   }
 
-  // Ensure Pond plugin tools are allowed alongside whatever tools.profile is set.
-  // Uses `alsoAllow` (additive) so user's profile choice is preserved.
-  const tools =
-    typeof existing.tools === "object"
-      && existing.tools !== null
-      && !Array.isArray(existing.tools)
-      ? (existing.tools as Record<string, unknown>)
-      : {};
-  tools.alsoAllow = POND_TOOL_NAMES;
-  existing.tools = tools;
+  // No plugin tools to allow — all operations go through CLI.
 
   // Atomic write
   const tmpPath = `${configPath}.tmp`;

package/src/hooks.ts

@@ -1,7 +1,6 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { extractAccountIdFromSessionKey } from "./session.js";
 import { clearDispatchMessageId, clearSessionMessageId, getActiveRunId, getDispatchMessageId, getDispatchNoReply, getPondAccountState, getSessionChatId } from "./runtime.js";
-import { loadToolsMarkdown } from "./tools-md.js";
 
 /**
  * Resolve the PondClient + orgId + runId for a hook context.
@@ -25,87 +24,26 @@ async function resolveClientForHook(sessionKey: string | undefined) {
   return { ...state, chatId, activeRunId };
 }
 
-const ORCHESTRATOR_PREFIX = `## Pond Orchestrator Mode
+const POND_CHANNEL_CONTEXT = `## Pond Channel — Message Delivery
 
-You are the Pond orchestrator. Events from multiple chats and tasks arrive as
-structured \`[Event: ...]\` blocks. You decide how to handle each event and
-respond using Bash commands via the Pond CLI.
+Messages from the Pond channel arrive as \`[Event: ...]\` blocks.
+Your text output is **not delivered to the user** — it is discarded silently.
+To reply, you **must** use the Pond CLI via the exec (Bash) tool.
 
-Your text output is internal (not delivered to users). Use the CLI to interact.
+Each event includes \`[Chat: ... (cht_xxx)]\` — use that chat ID to reply:
 
-### Pond CLI — Pre-Authenticated
+    npx @pnds/cli@latest messages send cht_xxx --text "Your reply here"
 
-The Pond CLI (\`npx @pnds/cli@latest\`) is pre-authenticated via environment
-variables injected into every Bash command. You do NOT need to set
-POND_API_URL, POND_API_KEY, etc. — they are already configured.
-
-\`POND_CHAT_ID\` is set to the chat that triggered the current event. When
-replying to the trigger chat, you can omit the chatId argument.
-
-### How to Reply to a Message
-
-When you receive \`[Event: message.new]\` with \`[Chat: ... (cht_abc123)]\`:
-
-    npx @pnds/cli@latest messages send cht_abc123 --text "Your response here"
-
-Or, since POND_CHAT_ID is set to the trigger chat:
-
-    npx @pnds/cli@latest messages send --text "Your response here"
-
-For thread replies (when the event includes \`[Thread: 01JWC...]\`):
-
-    npx @pnds/cli@latest messages send --text "Thread reply" --thread-root-id 01JWC...
-
-### How to Send a Direct Message
-
-    npx @pnds/cli@latest dm usr_xyz --text "Hello"
-
-Or by display name:
-
-    npx @pnds/cli@latest dm "Alice" --text "Hello"
-
-### How to Act on a Task
-
-When you receive \`[Event: task.assigned]\` with \`[Task: ... (tsk_xyz789)]\`:
-
-    npx @pnds/cli@latest tasks comments add tsk_xyz789 --body "Starting work..."
-    npx @pnds/cli@latest tasks update tsk_xyz789 --status in_progress
-
-### Reading Data
-
-    npx @pnds/cli@latest messages list <chatId>
-    npx @pnds/cli@latest tasks list --status open
-    npx @pnds/cli@latest chats list
-    npx @pnds/cli@latest members list
-
-### Sub-Agents
-
-For long-running tasks, use \`sessions_spawn\` to delegate to a sub-agent.
-Return quickly so the orchestrator can process other events.
-
-When a sub-agent completes, deliver the result using the CLI:
-
-    npx @pnds/cli@latest messages send <chatId> --text "Result: ..."
-
-### Agent-to-Agent Interaction
-
-When a message has a \`[Hint: no_reply]\`, do not send a reply. The CLI
-automatically suppresses sends when POND_NO_REPLY is set, but you should
-also skip unnecessary computation.
-
-Use \`--no-reply\` for FYI messages that don't need a response:
-
-    npx @pnds/cli@latest messages send <chatId> --text "FYI: done" --no-reply`;
-
-// Load wiki tools, CLI docs, and other tool docs from TOOLS.md (maintained separately)
-const POND_ORCHESTRATOR_CONTEXT = ORCHESTRATOR_PREFIX + "\n\n" + loadToolsMarkdown();
+Credentials are pre-configured in every Bash command — no setup needed.
+Load the \`pond-platform\` skill for full CLI reference.
+When a message has \`[Hint: no_reply]\`, do not send a reply.`;
 
 export function registerPondHooks(api: OpenClawPluginApi) {
   const log = api.logger;
 
-  // Inject CLI awareness into agent system prompt
+  // Append Pond channel context AFTER workspace files so it takes precedence
   api.on("before_prompt_build", () => {
-    return { prependSystemContext: POND_ORCHESTRATOR_CONTEXT };
+    return { appendSystemContext: POND_CHANNEL_CONTEXT };
   });
 
   // before_tool_call -> (1) fire-and-forget step creation, (2) ENV injection for exec tool

package/src/index.ts

@@ -3,7 +3,6 @@ import { emptyPluginConfigSchema } from "openclaw/plugin-sdk/core";
 import { pondPlugin } from "./channel.js";
 import { setPondRuntime } from "./runtime.js";
 import { registerPondHooks } from "./hooks.js";
-import { registerPondWikiTools } from "./wiki-tools.js";
 
 const plugin = {
   id: "pond",
@@ -13,7 +12,6 @@ const plugin = {
   register(api: OpenClawPluginApi) {
     setPondRuntime(api.runtime);
     api.registerChannel({ plugin: pondPlugin });
-    registerPondWikiTools(api);
     registerPondHooks(api);
   },
 };

package/TOOLS.md

@@ -1,62 +0,0 @@
-# Pond Tools
-
-## Pond Wiki Tools
-
-Use native Pond wiki tools for wiki lookup and editing instead of shelling out to the CLI.
-
-- `wiki_list` to find candidate wikis
-- `wiki_query` as the primary tree-aware retrieval tool
-- `wiki_outline` to inspect the local structural outline of a wiki or path prefix
-- `wiki_search` as a simpler lexical fallback
-- `wiki_section` to expand a result by `nodeId`
-- `wiki_blob` only when you need the whole file
-- `wiki_status` to inspect local mounted wiki edits
-- `wiki_diff` to review the local mounted wiki patch
-- `wiki_propose` to open or update a wiki changeset after editing
-- `wiki_changeset_diff` to inspect a wiki draft or changeset
-
-Typical wiki edit flow:
-
-1. `wiki_query` or `wiki_outline` to locate the right content
-2. `wiki_section` to read the exact section body you need
-3. Edit the mounted wiki files locally
-4. `wiki_status` and `wiki_diff` to verify the exact change
-5. `wiki_propose` to submit or update the wiki changeset
-
-## Pond CLI
-
-You have full access to the Pond platform via the `@pnds/cli` CLI. Auth and
-runtime context (org, agent run ID, current chat) are pre-configured via
-environment variables — no manual setup needed.
-
-### Sending Messages
-
-```bash
-npx @pnds/cli@latest messages send [chatId] --text "..."  # chatId defaults to POND_CHAT_ID
-npx @pnds/cli@latest messages send --text "..." --thread-root-id <id>
-npx @pnds/cli@latest messages send --text "..." --no-reply  # FYI, no response expected
-npx @pnds/cli@latest dm <nameOrId> --text "..."             # DM by user ID or display name
-```
-
-### Reading Data
-
-```bash
-npx @pnds/cli@latest whoami                          # Check your identity
-npx @pnds/cli@latest agents list                     # List all agents
-npx @pnds/cli@latest chats list                      # List chats
-npx @pnds/cli@latest messages list <chatId>          # Read chat history
-npx @pnds/cli@latest tasks list [--status ...]       # List tasks
-npx @pnds/cli@latest projects list                   # List projects
-npx @pnds/cli@latest users get <userId>              # Get user by ID
-npx @pnds/cli@latest members list                    # List org members
-```
-
-### Task Operations
-
-```bash
-npx @pnds/cli@latest tasks comments add <taskId> --body "..."
-npx @pnds/cli@latest tasks update <taskId> --status in_progress
-npx @pnds/cli@latest tasks create --title "..." [--assignee-id ...] [--project-id ...]
-```
-
-Run `npx @pnds/cli@latest --help` or `npx @pnds/cli@latest <command> --help` for full options. Output is JSON.

package/src/tool-helpers.ts

@@ -1,11 +0,0 @@
-/**
- * Wrap a value as an agent tool result with JSON text content.
- * Replaces the SDK's jsonResult which was removed from public subpath exports
- * in OpenClaw 2026.3.24.
- */
-export function jsonResult(payload: unknown): { content: Array<{ type: "text"; text: string }>; details: unknown } {
-  return {
-    content: [{ type: "text" as const, text: JSON.stringify(payload, null, 2) }],
-    details: payload,
-  };
-}

package/src/tools-md.ts

@@ -1,7 +0,0 @@
-import fs from "node:fs";
-
-const TOOLS_MD_PATH = new URL("../TOOLS.md", import.meta.url);
-
-export function loadToolsMarkdown(): string {
-  return fs.readFileSync(TOOLS_MD_PATH, "utf8").trim();
-}

package/src/wiki-tools.ts

@@ -1,361 +0,0 @@
-import { Type } from "@sinclair/typebox";
-import type { OpenClawPluginApi, AnyAgentTool } from "openclaw/plugin-sdk";
-import { readNumberParam, readStringParam } from "openclaw/plugin-sdk/param-readers";
-import { jsonResult } from "./tool-helpers.js";
-import { PondClient } from "@pnds/sdk";
-import {
-  getWikiBlob,
-  getWikiChangesetDiff,
-  getWikiOutline,
-  queryWiki,
-  getWikiSection,
-  getWikiTree,
-  getWikiWorkspaceDiff,
-  getWikiWorkspaceStatus,
-  listWikis,
-  proposeWikiChangeset,
-  searchWiki,
-  type PondContext,
-} from "@pnds/cli/wiki";
-import {
-  getActiveRunId,
-  getAllPondAccountStates,
-  getDispatchMessageId,
-  getPondAccountState,
-  getSessionChatId,
-  getSessionMessageId,
-} from "./runtime.js";
-import { extractAccountIdFromSessionKey } from "./session.js";
-
-const WikiTreeSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  path: Type.Optional(Type.String({ minLength: 1, description: "Tree path prefix." })),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-});
-
-const WikiBlobSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  path: Type.String({ minLength: 1, description: "File path inside the wiki." }),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-});
-
-const WikiStatusSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-});
-
-const WikiDiffSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-});
-
-const WikiSearchSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  query: Type.String({ minLength: 1, description: "Search query." }),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-  pathPrefix: Type.Optional(Type.String({ minLength: 1, description: "Restrict search to a path prefix." })),
-  limit: Type.Optional(Type.Number({ minimum: 1, description: "Maximum number of results." })),
-  includeContent: Type.Optional(Type.Boolean({ description: "Include full section content in each result." })),
-});
-
-const WikiQuerySchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  query: Type.String({ minLength: 1, description: "Natural-language query." }),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-  pathPrefix: Type.Optional(Type.String({ minLength: 1, description: "Restrict the query to a path prefix." })),
-  limit: Type.Optional(Type.Number({ minimum: 1, description: "Maximum number of section results." })),
-  includeContent: Type.Optional(Type.Boolean({ description: "Include full section content in each result." })),
-});
-
-const WikiOutlineSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-  pathPrefix: Type.Optional(Type.String({ minLength: 1, description: "Restrict outline to a path prefix." })),
-});
-
-const WikiSectionSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  nodeId: Type.String({ minLength: 1, description: "Section node ID returned by wiki_search." }),
-  ref: Type.Optional(Type.String({ minLength: 1, description: "Git ref to inspect." })),
-});
-
-const WikiChangesetDiffSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  changesetId: Type.String({ minLength: 1, description: "Wiki changeset ID." }),
-});
-
-const WikiProposeSchema = Type.Object({
-  wiki: Type.String({ minLength: 1, description: "Wiki slug or ID." }),
-  title: Type.String({ minLength: 1, description: "Changeset title." }),
-  summary: Type.Optional(Type.String({ description: "Optional changeset summary." })),
-  changesetId: Type.Optional(Type.String({ minLength: 1, description: "Existing changeset ID to update." })),
-});
-
-type ToolSessionContext = {
-  sessionKey?: string;
-  agentAccountId?: string;
-  agentId?: string;
-};
-
-function resolvePondContext(ctx: ToolSessionContext): PondContext {
-  const accountId = ctx.agentAccountId ?? extractAccountIdFromSessionKey(ctx.sessionKey);
-  if (accountId) {
-    const state = getPondAccountState(accountId);
-    if (state) {
-      return {
-        client: state.client,
-        orgId: state.orgId,
-        agentId: ctx.agentId ?? process.env.POND_AGENT_ID,
-        mountRoot: state.wikiMountRoot,
-      };
-    }
-  }
-
-  const states = Array.from(getAllPondAccountStates().values());
-  if (states.length === 1) {
-    return {
-      client: states[0].client,
-      orgId: states[0].orgId,
-      agentId: ctx.agentId ?? process.env.POND_AGENT_ID,
-      mountRoot: states[0].wikiMountRoot,
-    };
-  }
-
-  const baseUrl = process.env.POND_API_URL?.trim();
-  const token = process.env.POND_API_KEY?.trim();
-  const orgId = process.env.POND_ORG_ID?.trim();
-  if (baseUrl && token && orgId) {
-    return {
-      client: new PondClient({ baseUrl, token }),
-      orgId,
-      agentId: ctx.agentId ?? process.env.POND_AGENT_ID,
-    };
-  }
-
-  throw new Error(
-    "Pond wiki tools are unavailable: missing live Pond runtime state and POND_API_URL/POND_API_KEY/POND_ORG_ID.",
-  );
-}
-
-function formatWikiBlobResult(result: Awaited<ReturnType<typeof getWikiBlob>>) {
-  return {
-    wiki: {
-      id: result.wiki.id,
-      slug: result.wiki.slug,
-      name: result.wiki.name,
-    },
-    content: result.content,
-    size: result.size,
-  };
-}
-
-async function resolveWorkflowContext(ctx: ToolSessionContext) {
-  if (!ctx.sessionKey) {
-    return {};
-  }
-  const accountId = ctx.agentAccountId ?? extractAccountIdFromSessionKey(ctx.sessionKey);
-  const chatId = getSessionChatId(ctx.sessionKey);
-  const state = accountId ? getPondAccountState(accountId) : undefined;
-  const runId = state ? await getActiveRunId(state, ctx.sessionKey) : undefined;
-
-  // Issue 1: source_chat_id is a FK to the chats table — only set it for actual chat IDs.
-  // Task dispatches store a tsk_* ID here which would cause a DB FK violation.
-  const sourceChatId = chatId?.startsWith("cht_") ? chatId : undefined;
-
-  // Issue 2: prefer dispatch-time snapshot over the mutable session map to avoid
-  // reading a stale message ID when a new inbound message arrives mid-dispatch.
-  const sourceMessageId =
-    getDispatchMessageId(ctx.sessionKey) ?? getSessionMessageId(ctx.sessionKey);
-
-  return {
-    sourceChatId,
-    sourceMessageId,
-    sourceRunId: runId,
-  };
-}
-
-function createWikiTools(toolCtx: ToolSessionContext): AnyAgentTool[] {
-  const pondContext = () => resolvePondContext(toolCtx);
-  const workflowContext = () => resolveWorkflowContext(toolCtx);
-  return [
-    {
-      label: "Wiki List",
-      name: "wiki_list",
-      description: "List all Pond wikis in the current organization.",
-      parameters: Type.Object({}),
-      execute: async () => {
-        return jsonResult(await listWikis(pondContext()));
-      },
-    },
-    {
-      label: "Wiki Status",
-      name: "wiki_status",
-      description: "Inspect the local mounted wiki workspace before proposing changes.",
-      parameters: WikiStatusSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiWorkspaceStatus(pondContext(), readStringParam(params, "wiki", { required: true })),
-        );
-      },
-    },
-    {
-      label: "Wiki Diff",
-      name: "wiki_diff",
-      description: "Read the current unified diff for the local mounted wiki workspace.",
-      parameters: WikiDiffSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiWorkspaceDiff(pondContext(), readStringParam(params, "wiki", { required: true })),
-        );
-      },
-    },
-    {
-      label: "Wiki Tree",
-      name: "wiki_tree",
-      description: "List files and directories under a Pond wiki path.",
-      parameters: WikiTreeSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiTree(pondContext(), readStringParam(params, "wiki", { required: true }), {
-            path: readStringParam(params, "path"),
-          }),
-        );
-      },
-    },
-    {
-      label: "Wiki Blob",
-      name: "wiki_blob",
-      description: "Read a Pond wiki file. Use after wiki_search or wiki_tree narrows the target.",
-      parameters: WikiBlobSchema,
-      execute: async (_toolCallId, params) => {
-        const result = await getWikiBlob(pondContext(), readStringParam(params, "wiki", { required: true }), {
-          path: readStringParam(params, "path", { required: true }),
-        });
-        return jsonResult(formatWikiBlobResult(result));
-      },
-    },
-    {
-      label: "Wiki Search",
-      name: "wiki_search",
-      description: "Search Pond wiki sections by heading and content. Prefer this before reading full files.",
-      parameters: WikiSearchSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await searchWiki(
-            pondContext(),
-            readStringParam(params, "wiki", { required: true }),
-            readStringParam(params, "query", { required: true }),
-            {
-              ref: readStringParam(params, "ref"),
-              pathPrefix: readStringParam(params, "pathPrefix"),
-              limit: readNumberParam(params, "limit", { integer: true }),
-              includeContent: params.includeContent === true,
-            },
-          ),
-        );
-      },
-    },
-    {
-      label: "Wiki Query",
-      name: "wiki_query",
-      description: "Run a tree-aware Pond wiki query that first narrows documents and then selects the best sections.",
-      parameters: WikiQuerySchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await queryWiki(
-            pondContext(),
-            readStringParam(params, "wiki", { required: true }),
-            readStringParam(params, "query", { required: true }),
-            {
-              ref: readStringParam(params, "ref"),
-              pathPrefix: readStringParam(params, "pathPrefix"),
-              limit: readNumberParam(params, "limit", { integer: true }),
-              includeContent: params.includeContent === true,
-            },
-          ),
-        );
-      },
-    },
-    {
-      label: "Wiki Outline",
-      name: "wiki_outline",
-      description: "Read the structural outline of a Pond wiki or a specific path prefix before drilling into sections.",
-      parameters: WikiOutlineSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiOutline(pondContext(), readStringParam(params, "wiki", { required: true }), {
-            ref: readStringParam(params, "ref"),
-            pathPrefix: readStringParam(params, "pathPrefix"),
-          }),
-        );
-      },
-    },
-    {
-      label: "Wiki Section",
-      name: "wiki_section",
-      description: "Read the full body of a Pond wiki section identified by nodeId from wiki_search.",
-      parameters: WikiSectionSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiSection(pondContext(), readStringParam(params, "wiki", { required: true }), {
-            nodeId: readStringParam(params, "nodeId", { required: true }),
-            ref: readStringParam(params, "ref"),
-          }),
-        );
-      },
-    },
-    {
-      label: "Wiki Changeset Diff",
-      name: "wiki_changeset_diff",
-      description: "Fetch the unified diff and file summary for a Pond wiki changeset.",
-      parameters: WikiChangesetDiffSchema,
-      execute: async (_toolCallId, params) => {
-        return jsonResult(
-          await getWikiChangesetDiff(
-            pondContext(),
-            readStringParam(params, "wiki", { required: true }),
-            readStringParam(params, "changesetId", { required: true }),
-          ),
-        );
-      },
-    },
-    {
-      label: "Wiki Propose",
-      name: "wiki_propose",
-      description: "Create or update a proposed wiki changeset from the current local mounted workspace.",
-      parameters: WikiProposeSchema,
-      execute: async (_toolCallId, params) => {
-        const workflow = await workflowContext();
-        return jsonResult(
-          await proposeWikiChangeset(pondContext(), readStringParam(params, "wiki", { required: true }), {
-            title: readStringParam(params, "title", { required: true }),
-            summary: readStringParam(params, "summary"),
-            changesetId: readStringParam(params, "changesetId"),
-            sourceChatId: workflow.sourceChatId,
-            sourceMessageId: workflow.sourceMessageId,
-            sourceRunId: workflow.sourceRunId,
-          }),
-        );
-      },
-    },
-  ];
-}
-
-export function registerPondWikiTools(api: OpenClawPluginApi) {
-  api.registerTool(
-    (ctx) => createWikiTools(ctx),
-    {
-      names: [
-        "wiki_list",
-        "wiki_status",
-        "wiki_diff",
-        "wiki_tree",
-        "wiki_blob",
-        "wiki_search",
-        "wiki_query",
-        "wiki_outline",
-        "wiki_section",
-        "wiki_changeset_diff",
-        "wiki_propose",
-      ],
-    },
-  );
-}