openclaw-plugin-edicts 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# openclaw-plugin-edicts
+
+OpenClaw plugin for [Edicts](https://github.com/mssteuer/edicts) — ground truth for AI agents.
+
+Automatically injects edicts into every agent session and exposes CRUD tools so agents can read, create, and manage edicts at runtime.
+
+## Install
+
+```bash
+openclaw plugins install github:mssteuer/openclaw-plugin-edicts
+openclaw gateway restart
+```
+
+That's it. The plugin auto-creates `edicts.yaml` in your workspace on first run.
+
+## What it does
+
+- **Context injection** — Before every prompt, relevant edicts are serialized and injected into the system context. Your agent always knows the ground truth.
+- **Agent tools** — Seven tools registered automatically:
+
+| Tool | Description |
+|------|-------------|
+| `edicts_list` | List edicts with optional filtering by category, tags, or TTL |
+| `edicts_add` | Create a new edict |
+| `edicts_update` | Update an existing edict by id |
+| `edicts_remove` | Remove an edict |
+| `edicts_search` | Free-text search across edicts |
+| `edicts_stats` | Show store statistics (counts, token usage, budget) |
+| `edicts_review` | Review and clean up stale/expired edicts |
+
+## Configuration
+
+The plugin works with zero configuration. To customize, add options to your `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "edicts": {
+        "enabled": true,
+        "config": {
+          "path": "edicts.yaml",
+          "format": "yaml",
+          "autoInject": true,
+          "tokenBudget": 2000
+        }
+      }
+    }
+  }
+}
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `path` | `edicts.yaml` | Path to storage file (relative to workspace) |
+| `format` | `yaml` | Storage format (`yaml` or `json`) |
+| `autoInject` | `true` | Inject edicts into system context on every session |
+| `autoInjectFilter` | `all` | Which edicts to inject (v1: only `all`) |
+| `tokenBudget` | `2000` | Max tokens for context injection |
+
+## How edicts work
+
+Edicts are small, verified facts your agent treats as non-negotiable:
+
+```yaml
+version: 1
+edicts:
+  - text: "v2.0 launches April 15, 2026"
+    category: product
+    confidence: verified
+    ttl: event
+  - text: "Never mention Project X publicly"
+    category: compliance
+    confidence: verified
+    ttl: permanent
+```
+
+Add them via the CLI, agent tools, or edit the YAML directly.
+
+## Links
+
+- [Edicts library](https://github.com/mssteuer/edicts) — standalone core (no OpenClaw dependency)
+- [edicts.ai](https://mssteuer.github.io/edicts.ai/) — docs and landing page
+- [OpenClaw](https://openclaw.ai) — the agent platform
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,349 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_fs = require("fs");
+var import_node_path = __toESM(require("path"), 1);
+var import_edicts3 = require("edicts");
+
+// src/config.ts
+function resolveConfig(raw) {
+  const userPath = typeof raw.path === "string" ? raw.path : "edicts.yaml";
+  let format;
+  if (raw.format === "json" || raw.format === "yaml") {
+    format = raw.format;
+  } else {
+    format = userPath.endsWith(".json") ? "json" : "yaml";
+  }
+  return {
+    path: userPath,
+    format,
+    autoInject: typeof raw.autoInject === "boolean" ? raw.autoInject : true,
+    autoInjectFilter: "all",
+    tokenBudget: typeof raw.tokenBudget === "number" ? raw.tokenBudget : 2e3
+  };
+}
+
+// src/context.ts
+var import_edicts = require("edicts");
+function createContextHook(store, config) {
+  return async () => {
+    try {
+      await store.load();
+    } catch {
+      return {};
+    }
+    const edicts = await store.all();
+    if (edicts.length === 0) {
+      return {};
+    }
+    const rendered = (0, import_edicts.renderPlain)(edicts);
+    const appendSystemContext = wrapEdicts(rendered);
+    return { appendSystemContext };
+  };
+}
+function wrapEdicts(rendered) {
+  return [
+    "## Edicts (Standing Instructions)",
+    "The following are your standing instructions. Follow them unless explicitly overridden.",
+    "",
+    rendered
+  ].join("\n");
+}
+
+// src/tools.ts
+var import_edicts2 = require("edicts");
+function text(msg) {
+  return { content: [{ type: "text", text: msg }] };
+}
+function serialize(value) {
+  return JSON.stringify(value, null, 2);
+}
+function friendlyError(err) {
+  if (err instanceof import_edicts2.EdictNotFoundError) return `No edict found with id '${err.id ?? "unknown"}'`;
+  if (err instanceof import_edicts2.EdictValidationError) return `Validation error: ${err.message}`;
+  if (err instanceof import_edicts2.EdictBudgetExceededError) return `Token budget exceeded: ${err.message}`;
+  if (err instanceof import_edicts2.EdictCountLimitError) return `Edict count limit reached: ${err.message}`;
+  if (err instanceof import_edicts2.EdictCategoryError) return `Category error: ${err.message}`;
+  if (err instanceof Error) return err.message;
+  return String(err);
+}
+var TOOL_NAMES = [
+  "edicts_list",
+  "edicts_add",
+  "edicts_update",
+  "edicts_remove",
+  "edicts_search",
+  "edicts_stats",
+  "edicts_review"
+];
+async function ensureLoaded(store) {
+  await store.load();
+  return store;
+}
+function buildTools(store) {
+  return [
+    {
+      name: "edicts_list",
+      description: "List edicts with optional filtering by category, tags, or ttl.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          limit: { type: "number" }
+        }
+      },
+      async execute(_id, params = {}) {
+        try {
+          const s = await ensureLoaded(store);
+          let results = await s.find(params);
+          if (typeof params.limit === "number" && params.limit > 0) {
+            results = results.slice(0, params.limit);
+          }
+          if (results.length === 0) return text("No edicts found matching the criteria.");
+          return text(`${results.length} edict(s) found:
+
+${serialize(results)}`);
+        } catch (err) {
+          return text(`Error listing edicts: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_add",
+      description: "Create a new edict (standing instruction).",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          text: { type: "string" },
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          confidence: { type: "string", enum: ["verified", "inferred", "user"] },
+          source: { type: "string" },
+          key: { type: "string" },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          expiresAt: { type: "string" }
+        },
+        required: ["text", "category"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          const result = await s.add(params);
+          return text(`Edict created:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error adding edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_update",
+      description: "Update an existing edict by id.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          id: { type: "string" },
+          text: { type: "string" },
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          confidence: { type: "string", enum: ["verified", "inferred", "user"] },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          expiresAt: { type: "string" }
+        },
+        required: ["id"]
+      },
+      async execute(_id, params) {
+        try {
+          const { id, ...patch } = params;
+          const s = await ensureLoaded(store);
+          const result = await s.update(id, patch);
+          return text(`Edict updated:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error updating edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_remove",
+      description: "Remove an edict.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          id: { type: "string" }
+        },
+        required: ["id"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          const result = await s.remove(params.id);
+          return text(`Edict removed:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error removing edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_search",
+      description: "Free-text search across edicts.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          query: { type: "string" },
+          limit: { type: "number" }
+        },
+        required: ["query"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          let results = await s.search(params.query);
+          if (typeof params.limit === "number" && params.limit > 0) {
+            results = results.slice(0, params.limit);
+          }
+          if (results.length === 0) return text("No edicts matched the search query.");
+          return text(`${results.length} match(es):
+
+${serialize(results)}`);
+        } catch (err) {
+          return text(`Error searching edicts: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_stats",
+      description: "Show edict store statistics.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {}
+      },
+      async execute() {
+        try {
+          const s = await ensureLoaded(store);
+          const stats = await s.stats();
+          return text(`Edict store statistics:
+
+${serialize(stats)}`);
+        } catch (err) {
+          return text(`Error fetching stats: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_review",
+      description: "Review and optionally clean up stale/expired edicts.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          action: { type: "string", enum: ["preview", "compact"] }
+        }
+      },
+      async execute(_id, params = {}) {
+        try {
+          const s = await ensureLoaded(store);
+          const action = params.action ?? "preview";
+          if (action === "compact") {
+            const result2 = await s.review();
+            return text(`Compaction candidates (auto-compact requires LLM callback \u2014 v2):
+
+${serialize(result2)}`);
+          }
+          const result = await s.review();
+          return text(`Review (preview):
+
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error reviewing edicts: ${friendlyError(err)}`);
+        }
+      }
+    }
+  ];
+}
+function registerEdictTools(api, store) {
+  api.registerTool(() => buildTools(store), {
+    names: [...TOOL_NAMES],
+    optional: false
+  });
+}
+
+// index.ts
+function ensureEdictsFile(filePath) {
+  if ((0, import_node_fs.existsSync)(filePath)) return;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const template = [
+    "version: 1",
+    "config:",
+    "  maxEdicts: 200",
+    "  tokenBudget: 4000",
+    "  categories: []",
+    "edicts: []",
+    "history: []",
+    ""
+  ].join("\n");
+  (0, import_node_fs.writeFileSync)(filePath, template, "utf-8");
+}
+var plugin = {
+  id: "edicts",
+  name: "Edicts",
+  description: "Inject agent edicts into context and expose CRUD tools.",
+  register(api) {
+    const config = resolveConfig(api.pluginConfig ?? {});
+    const storePath = import_node_path.default.resolve(api.workspaceDir, config.path);
+    ensureEdictsFile(storePath);
+    const store = new import_edicts3.EdictStore({
+      path: storePath,
+      format: config.format,
+      tokenBudget: config.tokenBudget,
+      autoSave: true
+    });
+    registerEdictTools(api, store);
+    if (config.autoInject) {
+      api.on("before_prompt_build", createContextHook(store, config));
+    }
+  }
+};
+var index_default = plugin;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/config.ts","../src/context.ts","../src/tools.ts"],"sourcesContent":["import { existsSync, writeFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { EdictStore } from 'edicts';\nimport { resolveConfig } from './src/config.js';\nimport { createContextHook } from './src/context.js';\nimport { registerEdictTools } from './src/tools.js';\n\n/**\n * OpenClaw plugin API surface — types inferred from OpenClaw runtime.\n * No compile-time dependency on OpenClaw; the runtime provides the API object.\n */\nexport interface OpenClawPluginApi {\n  pluginConfig?: Record<string, unknown>;\n  workspaceDir: string;\n  registerTool(\n    factory: () => Array<{\n      name: string;\n      description: string;\n      parameters: unknown;\n      execute: (id: string, params: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;\n    }>,\n    opts?: { names?: string[]; optional?: boolean },\n  ): void;\n  on(\n    hookName: 'before_prompt_build',\n    handler: () => Promise<{ appendSystemContext?: string } | Record<string, never>>,\n  ): void;\n}\n\n/**\n * Create a starter edicts.yaml if the file doesn't exist yet.\n * For OpenClaw users this means zero bootstrapping — install the plugin and go.\n */\nfunction ensureEdictsFile(filePath: string): void {\n  if (existsSync(filePath)) return;\n  const now = new Date().toISOString();\n  const template = [\n    'version: 1',\n    'config:',\n    '  maxEdicts: 200',\n    '  tokenBudget: 4000',\n    '  categories: []',\n    'edicts: []',\n    'history: []',\n    '',\n  ].join('\\n');\n  writeFileSync(filePath, template, 'utf-8');\n}\n\nconst plugin = {\n  id: 'edicts',\n  name: 'Edicts',\n  description: 'Inject agent edicts into context and expose CRUD tools.',\n\n  register(api: OpenClawPluginApi) {\n    const config = resolveConfig(api.pluginConfig ?? {});\n\n    const storePath = path.resolve(api.workspaceDir, config.path);\n\n    // Auto-create edicts file on first run — no manual init needed\n    ensureEdictsFile(storePath);\n\n    const store = new EdictStore({\n      path: storePath,\n      format: config.format,\n      tokenBudget: config.tokenBudget,\n      autoSave: true,\n    });\n\n    registerEdictTools(api, store);\n\n    if (config.autoInject) {\n      api.on('before_prompt_build', createContextHook(store, config));\n    }\n  },\n};\n\nexport default plugin;\n","export interface ResolvedConfig {\n  path: string;\n  format: 'yaml' | 'json';\n  autoInject: boolean;\n  autoInjectFilter: 'all';\n  tokenBudget: number;\n}\n\n/**\n * Merge user-provided plugin config over defaults.\n * Infers format from path extension when not explicitly set.\n */\nexport function resolveConfig(raw: Record<string, unknown>): ResolvedConfig {\n  const userPath = typeof raw.path === 'string' ? raw.path : 'edicts.yaml';\n\n  let format: 'yaml' | 'json';\n  if (raw.format === 'json' || raw.format === 'yaml') {\n    format = raw.format;\n  } else {\n    format = userPath.endsWith('.json') ? 'json' : 'yaml';\n  }\n\n  return {\n    path: userPath,\n    format,\n    autoInject: typeof raw.autoInject === 'boolean' ? raw.autoInject : true,\n    autoInjectFilter: 'all',\n    tokenBudget: typeof raw.tokenBudget === 'number' ? raw.tokenBudget : 2000,\n  };\n}\n","import { renderPlain } from 'edicts';\nimport type { EdictStore } from 'edicts';\nimport type { ResolvedConfig } from './config.js';\n\n/**\n * Creates the before_prompt_build hook that injects edicts into system context.\n * v1: injects all edicts (autoInjectFilter = \"all\").\n */\nexport function createContextHook(\n  store: EdictStore,\n  config: ResolvedConfig,\n): () => Promise<{ appendSystemContext?: string } | Record<string, never>> {\n  return async () => {\n    try {\n      await store.load();\n    } catch {\n      // File doesn't exist yet — empty store, nothing to inject\n      return {};\n    }\n\n    const edicts = await store.all();\n\n    if (edicts.length === 0) {\n      return {};\n    }\n\n    const rendered = renderPlain(edicts);\n    const appendSystemContext = wrapEdicts(rendered);\n\n    return { appendSystemContext };\n  };\n}\n\nfunction wrapEdicts(rendered: string): string {\n  return [\n    '## Edicts (Standing Instructions)',\n    'The following are your standing instructions. Follow them unless explicitly overridden.',\n    '',\n    rendered,\n  ].join('\\n');\n}\n","import type { EdictStore } from 'edicts';\nimport type { EdictInput, FindQuery } from 'edicts';\nimport {\n  EdictNotFoundError,\n  EdictValidationError,\n  EdictBudgetExceededError,\n  EdictCountLimitError,\n  EdictCategoryError,\n} from 'edicts';\n\ntype ToolResult = { content: Array<{ type: 'text'; text: string }> };\ntype Tool = {\n  name: string;\n  description: string;\n  parameters: unknown;\n  execute: (id: string, params?: any) => Promise<ToolResult>;\n};\n\nfunction text(msg: string): ToolResult {\n  return { content: [{ type: 'text', text: msg }] };\n}\n\nfunction serialize(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\nfunction friendlyError(err: unknown): string {\n  if (err instanceof EdictNotFoundError) return `No edict found with id '${(err as any).id ?? 'unknown'}'`;\n  if (err instanceof EdictValidationError) return `Validation error: ${err.message}`;\n  if (err instanceof EdictBudgetExceededError) return `Token budget exceeded: ${err.message}`;\n  if (err instanceof EdictCountLimitError) return `Edict count limit reached: ${err.message}`;\n  if (err instanceof EdictCategoryError) return `Category error: ${err.message}`;\n  if (err instanceof Error) return err.message;\n  return String(err);\n}\n\nconst TOOL_NAMES = [\n  'edicts_list',\n  'edicts_add',\n  'edicts_update',\n  'edicts_remove',\n  'edicts_search',\n  'edicts_stats',\n  'edicts_review',\n] as const;\n\nasync function ensureLoaded(store: EdictStore): Promise<EdictStore> {\n  await store.load();\n  return store;\n}\n\nfunction buildTools(store: EdictStore): Tool[] {\n  return [\n    {\n      name: 'edicts_list',\n      description: 'List edicts with optional filtering by category, tags, or ttl.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          limit: { type: 'number' },\n        },\n      },\n      async execute(_id: string, params: FindQuery & { limit?: number } = {}) {\n        try {\n          const s = await ensureLoaded(store);\n          let results = await s.find(params);\n          if (typeof params.limit === 'number' && params.limit > 0) {\n            results = results.slice(0, params.limit);\n          }\n          if (results.length === 0) return text('No edicts found matching the criteria.');\n          return text(`${results.length} edict(s) found:\\n\\n${serialize(results)}`);\n        } catch (err: unknown) {\n          return text(`Error listing edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_add',\n      description: 'Create a new edict (standing instruction).',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          text: { type: 'string' },\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          confidence: { type: 'string', enum: ['verified', 'inferred', 'user'] },\n          source: { type: 'string' },\n          key: { type: 'string' },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          expiresAt: { type: 'string' },\n        },\n        required: ['text', 'category'],\n      },\n      async execute(_id: string, params: EdictInput) {\n        try {\n          const s = await ensureLoaded(store);\n          const result = await s.add(params);\n          return text(`Edict created:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error adding edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_update',\n      description: 'Update an existing edict by id.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          id: { type: 'string' },\n          text: { type: 'string' },\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          confidence: { type: 'string', enum: ['verified', 'inferred', 'user'] },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          expiresAt: { type: 'string' },\n        },\n        required: ['id'],\n      },\n      async execute(_id: string, params: { id: string } & Partial<EdictInput>) {\n        try {\n          const { id, ...patch } = params;\n          const s = await ensureLoaded(store);\n          const result = await s.update(id, patch);\n          return text(`Edict updated:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error updating edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_remove',\n      description: 'Remove an edict.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          id: { type: 'string' },\n        },\n        required: ['id'],\n      },\n      async execute(_id: string, params: { id: string }) {\n        try {\n          const s = await ensureLoaded(store);\n          const result = await s.remove(params.id);\n          return text(`Edict removed:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error removing edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_search',\n      description: 'Free-text search across edicts.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          query: { type: 'string' },\n          limit: { type: 'number' },\n        },\n        required: ['query'],\n      },\n      async execute(_id: string, params: { query: string; limit?: number }) {\n        try {\n          const s = await ensureLoaded(store);\n          let results = await s.search(params.query);\n          if (typeof params.limit === 'number' && params.limit > 0) {\n            results = results.slice(0, params.limit);\n          }\n          if (results.length === 0) return text('No edicts matched the search query.');\n          return text(`${results.length} match(es):\\n\\n${serialize(results)}`);\n        } catch (err: unknown) {\n          return text(`Error searching edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_stats',\n      description: 'Show edict store statistics.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {},\n      },\n      async execute() {\n        try {\n          const s = await ensureLoaded(store);\n          const stats = await s.stats();\n          return text(`Edict store statistics:\\n\\n${serialize(stats)}`);\n        } catch (err: unknown) {\n          return text(`Error fetching stats: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_review',\n      description: 'Review and optionally clean up stale/expired edicts.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          action: { type: 'string', enum: ['preview', 'compact'] },\n        },\n      },\n      async execute(_id: string, params: { action?: 'preview' | 'compact' } = {}) {\n        try {\n          const s = await ensureLoaded(store);\n          const action = params.action ?? 'preview';\n          if (action === 'compact') {\n            // compact() requires a callback-driven merge (group + merged edict).\n            // For now, run review() and flag compaction candidates.\n            const result = await s.review();\n            return text(`Compaction candidates (auto-compact requires LLM callback — v2):\\n\\n${serialize(result)}`);\n          }\n          const result = await s.review();\n          return text(`Review (preview):\\n\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error reviewing edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n  ];\n}\n\n/**\n * Register all edicts tools with the OpenClaw plugin API.\n * Tools are required (always available when plugin is enabled).\n */\nexport function registerEdictTools(\n  api: { registerTool: (factory: () => Tool[], opts?: { names?: string[]; optional?: boolean }) => void },\n  store: EdictStore,\n): void {\n  api.registerTool(() => buildTools(store), {\n    names: [...TOOL_NAMES],\n    optional: false,\n  });\n}\n"],"mappings":"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","names":["import_edicts","import_edicts","result","path"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+/**
+ * OpenClaw plugin API surface — types inferred from OpenClaw runtime.
+ * No compile-time dependency on OpenClaw; the runtime provides the API object.
+ */
+interface OpenClawPluginApi {
+    pluginConfig?: Record<string, unknown>;
+    workspaceDir: string;
+    registerTool(factory: () => Array<{
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: (id: string, params: any) => Promise<{
+            content: Array<{
+                type: 'text';
+                text: string;
+            }>;
+        }>;
+    }>, opts?: {
+        names?: string[];
+        optional?: boolean;
+    }): void;
+    on(hookName: 'before_prompt_build', handler: () => Promise<{
+        appendSystemContext?: string;
+    } | Record<string, never>>): void;
+}
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi): void;
+};
+
+export { type OpenClawPluginApi, plugin as default };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OpenClaw plugin API surface — types inferred from OpenClaw runtime.
+ * No compile-time dependency on OpenClaw; the runtime provides the API object.
+ */
+interface OpenClawPluginApi {
+    pluginConfig?: Record<string, unknown>;
+    workspaceDir: string;
+    registerTool(factory: () => Array<{
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: (id: string, params: any) => Promise<{
+            content: Array<{
+                type: 'text';
+                text: string;
+            }>;
+        }>;
+    }>, opts?: {
+        names?: string[];
+        optional?: boolean;
+    }): void;
+    on(hookName: 'before_prompt_build', handler: () => Promise<{
+        appendSystemContext?: string;
+    } | Record<string, never>>): void;
+}
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi): void;
+};
+
+export { type OpenClawPluginApi, plugin as default };

package/dist/index.js

@@ -0,0 +1,324 @@
+// index.ts
+import { existsSync, writeFileSync } from "fs";
+import path from "path";
+import { EdictStore } from "edicts";
+
+// src/config.ts
+function resolveConfig(raw) {
+  const userPath = typeof raw.path === "string" ? raw.path : "edicts.yaml";
+  let format;
+  if (raw.format === "json" || raw.format === "yaml") {
+    format = raw.format;
+  } else {
+    format = userPath.endsWith(".json") ? "json" : "yaml";
+  }
+  return {
+    path: userPath,
+    format,
+    autoInject: typeof raw.autoInject === "boolean" ? raw.autoInject : true,
+    autoInjectFilter: "all",
+    tokenBudget: typeof raw.tokenBudget === "number" ? raw.tokenBudget : 2e3
+  };
+}
+
+// src/context.ts
+import { renderPlain } from "edicts";
+function createContextHook(store, config) {
+  return async () => {
+    try {
+      await store.load();
+    } catch {
+      return {};
+    }
+    const edicts = await store.all();
+    if (edicts.length === 0) {
+      return {};
+    }
+    const rendered = renderPlain(edicts);
+    const appendSystemContext = wrapEdicts(rendered);
+    return { appendSystemContext };
+  };
+}
+function wrapEdicts(rendered) {
+  return [
+    "## Edicts (Standing Instructions)",
+    "The following are your standing instructions. Follow them unless explicitly overridden.",
+    "",
+    rendered
+  ].join("\n");
+}
+
+// src/tools.ts
+import {
+  EdictNotFoundError,
+  EdictValidationError,
+  EdictBudgetExceededError,
+  EdictCountLimitError,
+  EdictCategoryError
+} from "edicts";
+function text(msg) {
+  return { content: [{ type: "text", text: msg }] };
+}
+function serialize(value) {
+  return JSON.stringify(value, null, 2);
+}
+function friendlyError(err) {
+  if (err instanceof EdictNotFoundError) return `No edict found with id '${err.id ?? "unknown"}'`;
+  if (err instanceof EdictValidationError) return `Validation error: ${err.message}`;
+  if (err instanceof EdictBudgetExceededError) return `Token budget exceeded: ${err.message}`;
+  if (err instanceof EdictCountLimitError) return `Edict count limit reached: ${err.message}`;
+  if (err instanceof EdictCategoryError) return `Category error: ${err.message}`;
+  if (err instanceof Error) return err.message;
+  return String(err);
+}
+var TOOL_NAMES = [
+  "edicts_list",
+  "edicts_add",
+  "edicts_update",
+  "edicts_remove",
+  "edicts_search",
+  "edicts_stats",
+  "edicts_review"
+];
+async function ensureLoaded(store) {
+  await store.load();
+  return store;
+}
+function buildTools(store) {
+  return [
+    {
+      name: "edicts_list",
+      description: "List edicts with optional filtering by category, tags, or ttl.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          limit: { type: "number" }
+        }
+      },
+      async execute(_id, params = {}) {
+        try {
+          const s = await ensureLoaded(store);
+          let results = await s.find(params);
+          if (typeof params.limit === "number" && params.limit > 0) {
+            results = results.slice(0, params.limit);
+          }
+          if (results.length === 0) return text("No edicts found matching the criteria.");
+          return text(`${results.length} edict(s) found:
+
+${serialize(results)}`);
+        } catch (err) {
+          return text(`Error listing edicts: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_add",
+      description: "Create a new edict (standing instruction).",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          text: { type: "string" },
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          confidence: { type: "string", enum: ["verified", "inferred", "user"] },
+          source: { type: "string" },
+          key: { type: "string" },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          expiresAt: { type: "string" }
+        },
+        required: ["text", "category"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          const result = await s.add(params);
+          return text(`Edict created:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error adding edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_update",
+      description: "Update an existing edict by id.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          id: { type: "string" },
+          text: { type: "string" },
+          category: { type: "string" },
+          tags: { type: "array", items: { type: "string" } },
+          confidence: { type: "string", enum: ["verified", "inferred", "user"] },
+          ttl: { type: "string", enum: ["ephemeral", "event", "durable", "permanent"] },
+          expiresAt: { type: "string" }
+        },
+        required: ["id"]
+      },
+      async execute(_id, params) {
+        try {
+          const { id, ...patch } = params;
+          const s = await ensureLoaded(store);
+          const result = await s.update(id, patch);
+          return text(`Edict updated:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error updating edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_remove",
+      description: "Remove an edict.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          id: { type: "string" }
+        },
+        required: ["id"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          const result = await s.remove(params.id);
+          return text(`Edict removed:
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error removing edict: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_search",
+      description: "Free-text search across edicts.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          query: { type: "string" },
+          limit: { type: "number" }
+        },
+        required: ["query"]
+      },
+      async execute(_id, params) {
+        try {
+          const s = await ensureLoaded(store);
+          let results = await s.search(params.query);
+          if (typeof params.limit === "number" && params.limit > 0) {
+            results = results.slice(0, params.limit);
+          }
+          if (results.length === 0) return text("No edicts matched the search query.");
+          return text(`${results.length} match(es):
+
+${serialize(results)}`);
+        } catch (err) {
+          return text(`Error searching edicts: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_stats",
+      description: "Show edict store statistics.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {}
+      },
+      async execute() {
+        try {
+          const s = await ensureLoaded(store);
+          const stats = await s.stats();
+          return text(`Edict store statistics:
+
+${serialize(stats)}`);
+        } catch (err) {
+          return text(`Error fetching stats: ${friendlyError(err)}`);
+        }
+      }
+    },
+    {
+      name: "edicts_review",
+      description: "Review and optionally clean up stale/expired edicts.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          action: { type: "string", enum: ["preview", "compact"] }
+        }
+      },
+      async execute(_id, params = {}) {
+        try {
+          const s = await ensureLoaded(store);
+          const action = params.action ?? "preview";
+          if (action === "compact") {
+            const result2 = await s.review();
+            return text(`Compaction candidates (auto-compact requires LLM callback \u2014 v2):
+
+${serialize(result2)}`);
+          }
+          const result = await s.review();
+          return text(`Review (preview):
+
+${serialize(result)}`);
+        } catch (err) {
+          return text(`Error reviewing edicts: ${friendlyError(err)}`);
+        }
+      }
+    }
+  ];
+}
+function registerEdictTools(api, store) {
+  api.registerTool(() => buildTools(store), {
+    names: [...TOOL_NAMES],
+    optional: false
+  });
+}
+
+// index.ts
+function ensureEdictsFile(filePath) {
+  if (existsSync(filePath)) return;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const template = [
+    "version: 1",
+    "config:",
+    "  maxEdicts: 200",
+    "  tokenBudget: 4000",
+    "  categories: []",
+    "edicts: []",
+    "history: []",
+    ""
+  ].join("\n");
+  writeFileSync(filePath, template, "utf-8");
+}
+var plugin = {
+  id: "edicts",
+  name: "Edicts",
+  description: "Inject agent edicts into context and expose CRUD tools.",
+  register(api) {
+    const config = resolveConfig(api.pluginConfig ?? {});
+    const storePath = path.resolve(api.workspaceDir, config.path);
+    ensureEdictsFile(storePath);
+    const store = new EdictStore({
+      path: storePath,
+      format: config.format,
+      tokenBudget: config.tokenBudget,
+      autoSave: true
+    });
+    registerEdictTools(api, store);
+    if (config.autoInject) {
+      api.on("before_prompt_build", createContextHook(store, config));
+    }
+  }
+};
+var index_default = plugin;
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/config.ts","../src/context.ts","../src/tools.ts"],"sourcesContent":["import { existsSync, writeFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { EdictStore } from 'edicts';\nimport { resolveConfig } from './src/config.js';\nimport { createContextHook } from './src/context.js';\nimport { registerEdictTools } from './src/tools.js';\n\n/**\n * OpenClaw plugin API surface — types inferred from OpenClaw runtime.\n * No compile-time dependency on OpenClaw; the runtime provides the API object.\n */\nexport interface OpenClawPluginApi {\n  pluginConfig?: Record<string, unknown>;\n  workspaceDir: string;\n  registerTool(\n    factory: () => Array<{\n      name: string;\n      description: string;\n      parameters: unknown;\n      execute: (id: string, params: any) => Promise<{ content: Array<{ type: 'text'; text: string }> }>;\n    }>,\n    opts?: { names?: string[]; optional?: boolean },\n  ): void;\n  on(\n    hookName: 'before_prompt_build',\n    handler: () => Promise<{ appendSystemContext?: string } | Record<string, never>>,\n  ): void;\n}\n\n/**\n * Create a starter edicts.yaml if the file doesn't exist yet.\n * For OpenClaw users this means zero bootstrapping — install the plugin and go.\n */\nfunction ensureEdictsFile(filePath: string): void {\n  if (existsSync(filePath)) return;\n  const now = new Date().toISOString();\n  const template = [\n    'version: 1',\n    'config:',\n    '  maxEdicts: 200',\n    '  tokenBudget: 4000',\n    '  categories: []',\n    'edicts: []',\n    'history: []',\n    '',\n  ].join('\\n');\n  writeFileSync(filePath, template, 'utf-8');\n}\n\nconst plugin = {\n  id: 'edicts',\n  name: 'Edicts',\n  description: 'Inject agent edicts into context and expose CRUD tools.',\n\n  register(api: OpenClawPluginApi) {\n    const config = resolveConfig(api.pluginConfig ?? {});\n\n    const storePath = path.resolve(api.workspaceDir, config.path);\n\n    // Auto-create edicts file on first run — no manual init needed\n    ensureEdictsFile(storePath);\n\n    const store = new EdictStore({\n      path: storePath,\n      format: config.format,\n      tokenBudget: config.tokenBudget,\n      autoSave: true,\n    });\n\n    registerEdictTools(api, store);\n\n    if (config.autoInject) {\n      api.on('before_prompt_build', createContextHook(store, config));\n    }\n  },\n};\n\nexport default plugin;\n","export interface ResolvedConfig {\n  path: string;\n  format: 'yaml' | 'json';\n  autoInject: boolean;\n  autoInjectFilter: 'all';\n  tokenBudget: number;\n}\n\n/**\n * Merge user-provided plugin config over defaults.\n * Infers format from path extension when not explicitly set.\n */\nexport function resolveConfig(raw: Record<string, unknown>): ResolvedConfig {\n  const userPath = typeof raw.path === 'string' ? raw.path : 'edicts.yaml';\n\n  let format: 'yaml' | 'json';\n  if (raw.format === 'json' || raw.format === 'yaml') {\n    format = raw.format;\n  } else {\n    format = userPath.endsWith('.json') ? 'json' : 'yaml';\n  }\n\n  return {\n    path: userPath,\n    format,\n    autoInject: typeof raw.autoInject === 'boolean' ? raw.autoInject : true,\n    autoInjectFilter: 'all',\n    tokenBudget: typeof raw.tokenBudget === 'number' ? raw.tokenBudget : 2000,\n  };\n}\n","import { renderPlain } from 'edicts';\nimport type { EdictStore } from 'edicts';\nimport type { ResolvedConfig } from './config.js';\n\n/**\n * Creates the before_prompt_build hook that injects edicts into system context.\n * v1: injects all edicts (autoInjectFilter = \"all\").\n */\nexport function createContextHook(\n  store: EdictStore,\n  config: ResolvedConfig,\n): () => Promise<{ appendSystemContext?: string } | Record<string, never>> {\n  return async () => {\n    try {\n      await store.load();\n    } catch {\n      // File doesn't exist yet — empty store, nothing to inject\n      return {};\n    }\n\n    const edicts = await store.all();\n\n    if (edicts.length === 0) {\n      return {};\n    }\n\n    const rendered = renderPlain(edicts);\n    const appendSystemContext = wrapEdicts(rendered);\n\n    return { appendSystemContext };\n  };\n}\n\nfunction wrapEdicts(rendered: string): string {\n  return [\n    '## Edicts (Standing Instructions)',\n    'The following are your standing instructions. Follow them unless explicitly overridden.',\n    '',\n    rendered,\n  ].join('\\n');\n}\n","import type { EdictStore } from 'edicts';\nimport type { EdictInput, FindQuery } from 'edicts';\nimport {\n  EdictNotFoundError,\n  EdictValidationError,\n  EdictBudgetExceededError,\n  EdictCountLimitError,\n  EdictCategoryError,\n} from 'edicts';\n\ntype ToolResult = { content: Array<{ type: 'text'; text: string }> };\ntype Tool = {\n  name: string;\n  description: string;\n  parameters: unknown;\n  execute: (id: string, params?: any) => Promise<ToolResult>;\n};\n\nfunction text(msg: string): ToolResult {\n  return { content: [{ type: 'text', text: msg }] };\n}\n\nfunction serialize(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\nfunction friendlyError(err: unknown): string {\n  if (err instanceof EdictNotFoundError) return `No edict found with id '${(err as any).id ?? 'unknown'}'`;\n  if (err instanceof EdictValidationError) return `Validation error: ${err.message}`;\n  if (err instanceof EdictBudgetExceededError) return `Token budget exceeded: ${err.message}`;\n  if (err instanceof EdictCountLimitError) return `Edict count limit reached: ${err.message}`;\n  if (err instanceof EdictCategoryError) return `Category error: ${err.message}`;\n  if (err instanceof Error) return err.message;\n  return String(err);\n}\n\nconst TOOL_NAMES = [\n  'edicts_list',\n  'edicts_add',\n  'edicts_update',\n  'edicts_remove',\n  'edicts_search',\n  'edicts_stats',\n  'edicts_review',\n] as const;\n\nasync function ensureLoaded(store: EdictStore): Promise<EdictStore> {\n  await store.load();\n  return store;\n}\n\nfunction buildTools(store: EdictStore): Tool[] {\n  return [\n    {\n      name: 'edicts_list',\n      description: 'List edicts with optional filtering by category, tags, or ttl.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          limit: { type: 'number' },\n        },\n      },\n      async execute(_id: string, params: FindQuery & { limit?: number } = {}) {\n        try {\n          const s = await ensureLoaded(store);\n          let results = await s.find(params);\n          if (typeof params.limit === 'number' && params.limit > 0) {\n            results = results.slice(0, params.limit);\n          }\n          if (results.length === 0) return text('No edicts found matching the criteria.');\n          return text(`${results.length} edict(s) found:\\n\\n${serialize(results)}`);\n        } catch (err: unknown) {\n          return text(`Error listing edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_add',\n      description: 'Create a new edict (standing instruction).',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          text: { type: 'string' },\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          confidence: { type: 'string', enum: ['verified', 'inferred', 'user'] },\n          source: { type: 'string' },\n          key: { type: 'string' },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          expiresAt: { type: 'string' },\n        },\n        required: ['text', 'category'],\n      },\n      async execute(_id: string, params: EdictInput) {\n        try {\n          const s = await ensureLoaded(store);\n          const result = await s.add(params);\n          return text(`Edict created:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error adding edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_update',\n      description: 'Update an existing edict by id.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          id: { type: 'string' },\n          text: { type: 'string' },\n          category: { type: 'string' },\n          tags: { type: 'array', items: { type: 'string' } },\n          confidence: { type: 'string', enum: ['verified', 'inferred', 'user'] },\n          ttl: { type: 'string', enum: ['ephemeral', 'event', 'durable', 'permanent'] },\n          expiresAt: { type: 'string' },\n        },\n        required: ['id'],\n      },\n      async execute(_id: string, params: { id: string } & Partial<EdictInput>) {\n        try {\n          const { id, ...patch } = params;\n          const s = await ensureLoaded(store);\n          const result = await s.update(id, patch);\n          return text(`Edict updated:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error updating edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_remove',\n      description: 'Remove an edict.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          id: { type: 'string' },\n        },\n        required: ['id'],\n      },\n      async execute(_id: string, params: { id: string }) {\n        try {\n          const s = await ensureLoaded(store);\n          const result = await s.remove(params.id);\n          return text(`Edict removed:\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error removing edict: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_search',\n      description: 'Free-text search across edicts.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          query: { type: 'string' },\n          limit: { type: 'number' },\n        },\n        required: ['query'],\n      },\n      async execute(_id: string, params: { query: string; limit?: number }) {\n        try {\n          const s = await ensureLoaded(store);\n          let results = await s.search(params.query);\n          if (typeof params.limit === 'number' && params.limit > 0) {\n            results = results.slice(0, params.limit);\n          }\n          if (results.length === 0) return text('No edicts matched the search query.');\n          return text(`${results.length} match(es):\\n\\n${serialize(results)}`);\n        } catch (err: unknown) {\n          return text(`Error searching edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_stats',\n      description: 'Show edict store statistics.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {},\n      },\n      async execute() {\n        try {\n          const s = await ensureLoaded(store);\n          const stats = await s.stats();\n          return text(`Edict store statistics:\\n\\n${serialize(stats)}`);\n        } catch (err: unknown) {\n          return text(`Error fetching stats: ${friendlyError(err)}`);\n        }\n      },\n    },\n    {\n      name: 'edicts_review',\n      description: 'Review and optionally clean up stale/expired edicts.',\n      parameters: {\n        type: 'object',\n        additionalProperties: false,\n        properties: {\n          action: { type: 'string', enum: ['preview', 'compact'] },\n        },\n      },\n      async execute(_id: string, params: { action?: 'preview' | 'compact' } = {}) {\n        try {\n          const s = await ensureLoaded(store);\n          const action = params.action ?? 'preview';\n          if (action === 'compact') {\n            // compact() requires a callback-driven merge (group + merged edict).\n            // For now, run review() and flag compaction candidates.\n            const result = await s.review();\n            return text(`Compaction candidates (auto-compact requires LLM callback — v2):\\n\\n${serialize(result)}`);\n          }\n          const result = await s.review();\n          return text(`Review (preview):\\n\\n${serialize(result)}`);\n        } catch (err: unknown) {\n          return text(`Error reviewing edicts: ${friendlyError(err)}`);\n        }\n      },\n    },\n  ];\n}\n\n/**\n * Register all edicts tools with the OpenClaw plugin API.\n * Tools are required (always available when plugin is enabled).\n */\nexport function registerEdictTools(\n  api: { registerTool: (factory: () => Tool[], opts?: { names?: string[]; optional?: boolean }) => void },\n  store: EdictStore,\n): void {\n  api.registerTool(() => buildTools(store), {\n    names: [...TOOL_NAMES],\n    optional: false,\n  });\n}\n"],"mappings":"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","names":["result"]}

package/openclaw.plugin.json

@@ -0,0 +1,39 @@
+{
+  "id": "edicts",
+  "name": "Edicts",
+  "description": "Inject agent edicts into context and expose CRUD tools.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "path": {
+        "type": "string",
+        "description": "Path to edicts storage file (YAML or JSON)"
+      },
+      "format": {
+        "type": "string",
+        "enum": ["yaml", "json"],
+        "description": "Storage format"
+      },
+      "autoInject": {
+        "type": "boolean",
+        "description": "Auto-inject edicts into system context on every session"
+      },
+      "autoInjectFilter": {
+        "type": "string",
+        "enum": ["all"],
+        "description": "Which edicts to inject (v1: only 'all')"
+      },
+      "tokenBudget": {
+        "type": "number",
+        "description": "Max tokens for context injection"
+      }
+    }
+  },
+  "uiHints": {
+    "path": { "label": "Storage Path", "placeholder": "edicts.yaml" },
+    "format": { "label": "Storage Format" },
+    "autoInject": { "label": "Auto-inject into Context" },
+    "tokenBudget": { "label": "Token Budget", "placeholder": "2000" }
+  }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "openclaw-plugin-edicts",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin adapter for Edicts — ground truth layer for AI agents",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "edicts",
+    "ai",
+    "agents",
+    "context"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "edicts": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}