moltyjacs 0.3.0

package/dist/setup.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * JACS Setup Wizard
+ *
+ * Interactive setup for generating keys and creating agent identity.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupCommand = setupCommand;
+const jacs_1 = require("@hai.ai/jacs");
+const uuid_1 = require("uuid");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+const index_1 = require("./index");
+/**
+ * Creates the setup command handler
+ */
+function setupCommand(api) {
+    return async (ctx) => {
+        const logger = api.logger;
+        const homeDir = api.runtime.homeDir;
+        let originalPasswordEnv;
+        try {
+            // Get setup options from args or use defaults
+            const options = parseSetupOptions(ctx.args);
+            const jacsDir = path.join(homeDir, ".openclaw", "jacs");
+            const keysDir = path.join(homeDir, ".openclaw", "jacs_keys");
+            const configPath = path.join(jacsDir, "jacs.config.json");
+            // Check if already initialized
+            if (fs.existsSync(configPath)) {
+                const existingConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+                return {
+                    text: `JACS already initialized.\n\nAgent ID: ${existingConfig.jacs_agent_id_and_version?.split(":")[0]}\nConfig: ${configPath}\n\nUse 'openclaw jacs rotate' to rotate keys or delete ${jacsDir} to reinitialize.`,
+                };
+            }
+            // Create directories with secure permissions
+            fs.mkdirSync(jacsDir, { recursive: true, mode: 0o700 });
+            fs.mkdirSync(keysDir, { recursive: true, mode: 0o700 });
+            fs.mkdirSync(path.join(jacsDir, "agent"), { recursive: true });
+            fs.mkdirSync(path.join(jacsDir, "documents"), { recursive: true });
+            logger.info(`Generating ${options.keyAlgorithm} key pair...`);
+            // JACS load() now expects a pre-existing agent document; use createAgent
+            // first so keys, config, and agent identity are created atomically.
+            originalPasswordEnv = process.env.JACS_PRIVATE_KEY_PASSWORD;
+            process.env.JACS_PRIVATE_KEY_PASSWORD = options.keyPassword;
+            const createdRaw = (0, jacs_1.createAgent)(options.agentName, options.keyPassword, options.keyAlgorithm, jacsDir, keysDir, configPath, "ai", options.agentDescription, options.agentDomain, "fs");
+            let created = {};
+            try {
+                created = JSON.parse(createdRaw);
+            }
+            catch {
+                // Keep created as {} and fall back to reading from config below.
+            }
+            ensureConfigCompatibility(configPath, {
+                dataDir: jacsDir,
+                keyDir: keysDir,
+                privateKeyFilename: getFilenameOrDefault(created?.private_key_path, "agent.private.pem.enc"),
+                publicKeyFilename: getFilenameOrDefault(created?.public_key_path, "agent.public.pem"),
+                algorithm: options.keyAlgorithm,
+                agentIdAndVersion: created?.agent_id && created?.version
+                    ? `${created.agent_id}:${created.version}`
+                    : undefined,
+            });
+            // Load the created agent into runtime
+            const agent = new jacs_1.JacsAgent();
+            agent.load(configPath);
+            const configData = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            const [configAgentId, configAgentVersion] = parseAgentIdAndVersion(configData.jacs_agent_id_and_version);
+            const agentId = created?.agent_id || configAgentId || (0, uuid_1.v4)();
+            const agentVersion = created?.version || configAgentVersion;
+            logger.info(`Agent created: ${agentId}`);
+            const publicKeyPath = path.join(keysDir, configData.jacs_agent_public_key_filename || "agent.public.pem");
+            if (!fs.existsSync(publicKeyPath)) {
+                throw new Error(`Public key not found at ${publicKeyPath}`);
+            }
+            const publicKey = fs.readFileSync(publicKeyPath, "utf-8");
+            // Register the ready agent instance with plugin runtime
+            (0, index_1.setAgentInstance)(agent, agentId, publicKey);
+            // Update OpenClaw plugin config
+            api.updateConfig({
+                agentId,
+                keyAlgorithm: options.keyAlgorithm,
+                agentName: options.agentName,
+                agentDescription: options.agentDescription,
+                agentDomain: options.agentDomain,
+            });
+            const passwordLine = options.generatedPassword
+                ? `Generated Key Password (save now): ${options.keyPassword}`
+                : `Key Password: provided via --password`;
+            return {
+                text: `JACS initialized successfully!
+
+Agent ID: ${agentId}
+Agent Version: ${agentVersion || "unknown"}
+Algorithm: ${options.keyAlgorithm}
+Config: ${configPath}
+Keys: ${keysDir}
+${passwordLine}
+
+Your agent is ready to sign documents. Use:
+  openclaw jacs sign <file>     - Sign a document
+  openclaw jacs verify <file>   - Verify a signed document
+  openclaw jacs status          - Show agent status
+  openclaw jacs dns-record <domain> - Generate DNS TXT record
+
+Note: Save your key password securely. It's required to sign documents.`,
+                agentId,
+                configPath,
+            };
+        }
+        catch (err) {
+            logger.error(`Setup failed: ${err.message}`);
+            return {
+                text: `JACS setup failed: ${err.message}`,
+                error: err.message,
+            };
+        }
+        finally {
+            if (originalPasswordEnv === undefined) {
+                delete process.env.JACS_PRIVATE_KEY_PASSWORD;
+            }
+            else {
+                process.env.JACS_PRIVATE_KEY_PASSWORD = originalPasswordEnv;
+            }
+        }
+    };
+}
+/**
+ * Parse setup options from command arguments
+ */
+function parseSetupOptions(args) {
+    const providedPassword = args?.password || args?.p;
+    return {
+        keyAlgorithm: args?.algorithm || args?.a || "pq2025",
+        agentName: args?.name || args?.n || "OpenClaw JACS Agent",
+        agentDescription: args?.description || args?.d || "OpenClaw agent with JACS cryptographic provenance",
+        agentDomain: args?.domain,
+        keyPassword: providedPassword || generateSecurePassword(),
+        generatedPassword: !providedPassword,
+    };
+}
+/**
+ * Generate a cryptographically secure random password
+ */
+function generateSecurePassword() {
+    return crypto.randomBytes(32).toString("base64");
+}
+function parseAgentIdAndVersion(value) {
+    if (!value || typeof value !== "string") {
+        return [undefined, undefined];
+    }
+    const [agentId, agentVersion] = value.split(":");
+    return [agentId || undefined, agentVersion || undefined];
+}
+function getFilenameOrDefault(fullPath, fallback) {
+    if (typeof fullPath !== "string" || fullPath.trim() === "") {
+        return fallback;
+    }
+    return path.basename(fullPath);
+}
+function ensureConfigCompatibility(configPath, defaults) {
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    let changed = false;
+    const setIfMissing = (key, value) => {
+        if (!value)
+            return;
+        if (config[key] == null || config[key] === "") {
+            config[key] = value;
+            changed = true;
+        }
+    };
+    setIfMissing("jacs_use_security", "true");
+    setIfMissing("jacs_data_directory", defaults.dataDir);
+    setIfMissing("jacs_key_directory", defaults.keyDir);
+    setIfMissing("jacs_agent_private_key_filename", defaults.privateKeyFilename);
+    setIfMissing("jacs_agent_public_key_filename", defaults.publicKeyFilename);
+    setIfMissing("jacs_agent_key_algorithm", defaults.algorithm);
+    setIfMissing("jacs_default_storage", "fs");
+    setIfMissing("jacs_agent_id_and_version", defaults.agentIdAndVersion);
+    if (changed) {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), { mode: 0o600 });
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BH,oCA0IC;AArKD,uCAAsD;AACtD,+BAAoC;AACpC,2CAA6B;AAC7B,uCAAyB;AACzB,+CAAiC;AAEjC,mCAA2C;AAkB3C;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAsB;IACjD,OAAO,KAAK,EAAE,GAAQ,EAAwB,EAAE;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;QACpC,IAAI,mBAAuC,CAAC;QAE5C,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;YAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;YAE1D,+BAA+B;YAC/B,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBACxE,OAAO;oBACL,IAAI,EAAE,0CAA0C,cAAc,CAAC,yBAAyB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,UAAU,2DAA2D,OAAO,mBAAmB;iBACpN,CAAC;YACJ,CAAC;YAED,6CAA6C;YAC7C,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,YAAY,cAAc,CAAC,CAAC;YAE9D,yEAAyE;YACzE,oEAAoE;YACpE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC;YAE5D,MAAM,UAAU,GAAG,IAAA,kBAAW,EAC5B,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,YAAY,EACpB,OAAO,EACP,OAAO,EACP,UAAU,EACV,IAAI,EACJ,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,WAAW,EACnB,IAAI,CACL,CAAC;YAEF,IAAI,OAAO,GAAQ,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;YAED,yBAAyB,CAAC,UAAU,EAAE;gBACpC,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,OAAO;gBACf,kBAAkB,EAAE,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,CAAC;gBAC5F,iBAAiB,EAAE,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,kBAAkB,CAAC;gBACrF,SAAS,EAAE,OAAO,CAAC,YAAY;gBAC/B,iBAAiB,EACf,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,OAAO;oBACnC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE;oBAC1C,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;YAEH,sCAAsC;YACtC,MAAM,KAAK,GAAG,IAAI,gBAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAAG,sBAAsB,CAChE,UAAU,CAAC,yBAAyB,CACrC,CAAC;YACF,MAAM,OAAO,GAAG,OAAO,EAAE,QAAQ,IAAI,aAAa,IAAI,IAAA,SAAM,GAAE,CAAC;YAC/D,MAAM,YAAY,GAAG,OAAO,EAAE,OAAO,IAAI,kBAAkB,CAAC;YAE5D,MAAM,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAEzC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,OAAO,EACP,UAAU,CAAC,8BAA8B,IAAI,kBAAkB,CAChE,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAE1D,wDAAwD;YACxD,IAAA,wBAAgB,EAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAE5C,gCAAgC;YAChC,GAAG,CAAC,YAAY,CAAC;gBACf,OAAO;gBACP,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,OAAO,CAAC,iBAAiB;gBAC5C,CAAC,CAAC,sCAAsC,OAAO,CAAC,WAAW,EAAE;gBAC7D,CAAC,CAAC,uCAAuC,CAAC;YAE5C,OAAO;gBACL,IAAI,EAAE;;YAEF,OAAO;iBACF,YAAY,IAAI,SAAS;aAC7B,OAAO,CAAC,YAAY;UACvB,UAAU;QACZ,OAAO;EACb,YAAY;;;;;;;;wEAQ0D;gBAChE,OAAO;gBACP,UAAU;aACX,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO;gBACL,IAAI,EAAE,sBAAsB,GAAG,CAAC,OAAO,EAAE;gBACzC,KAAK,EAAE,GAAG,CAAC,OAAO;aACnB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,mBAAmB,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAS;IAClC,MAAM,gBAAgB,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO;QACL,YAAY,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,IAAI,QAAQ;QACpD,SAAS,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,qBAAqB;QACzD,gBAAgB,EACd,IAAI,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC,IAAI,mDAAmD;QACrF,WAAW,EAAE,IAAI,EAAE,MAAM;QACzB,WAAW,EAAE,gBAAgB,IAAI,sBAAsB,EAAE;QACzD,iBAAiB,EAAE,CAAC,gBAAgB;KACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB;IAC7B,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAiB,EAAE,QAAgB;IAC/D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,yBAAyB,CAChC,UAAkB,EAClB,QAOC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,KAAyB,EAAE,EAAE;QAC9D,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,CAAC,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtD,YAAY,CAAC,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,YAAY,CAAC,iCAAiC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC7E,YAAY,CAAC,gCAAgC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC3E,YAAY,CAAC,0BAA0B,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7D,YAAY,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC3C,YAAY,CAAC,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAEtE,IAAI,OAAO,EAAE,CAAC;QACZ,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,115 @@
+/**
+ * JACS Document Type Tools
+ *
+ * Tools for creating and managing typed JACS documents:
+ * - Agent State (memory, skill, plan, config, hook)
+ * - Commitments (agreements between agents)
+ * - Todo Lists (private work tracking)
+ * - Conversations (signed message threads)
+ */
+import type { OpenClawPluginAPI } from "../index";
+declare const AGENT_STATE_TYPES: readonly ["memory", "skill", "plan", "config", "hook", "other"];
+type AgentStateType = (typeof AGENT_STATE_TYPES)[number];
+declare const COMMITMENT_STATUSES: readonly ["pending", "active", "completed", "failed", "renegotiated", "disputed", "revoked"];
+type CommitmentStatus = (typeof COMMITMENT_STATUSES)[number];
+export interface CreateAgentStateParams {
+    stateType: AgentStateType;
+    name: string;
+    description?: string;
+    content?: string;
+    contentType?: string;
+    framework?: string;
+    tags?: string[];
+    origin?: "authored" | "adopted" | "generated" | "imported";
+    sourceUrl?: string;
+}
+export interface SignFileAsStateParams {
+    stateType: AgentStateType;
+    name: string;
+    filePath: string;
+    embed?: boolean;
+    description?: string;
+    framework?: string;
+}
+export interface VerifyAgentStateParams {
+    document: any;
+}
+export interface CreateCommitmentParams {
+    description: string;
+    status?: CommitmentStatus;
+    terms?: Record<string, any>;
+    question?: string;
+    startDate?: string;
+    endDate?: string;
+    recurrence?: {
+        frequency: string;
+        interval: number;
+    };
+    conversationRef?: string;
+    todoRef?: string;
+    taskId?: string;
+}
+export interface UpdateCommitmentParams {
+    document: any;
+    status?: CommitmentStatus;
+    answer?: string;
+    completionAnswer?: string;
+    disputeReason?: string;
+}
+export interface DisputeCommitmentParams {
+    document: any;
+    reason: string;
+}
+export interface RevokeCommitmentParams {
+    document: any;
+    reason: string;
+}
+export interface CreateTodoParams {
+    name: string;
+    items?: Array<{
+        itemType: "goal" | "task";
+        description: string;
+        priority?: string;
+        tags?: string[];
+    }>;
+}
+export interface AddTodoItemParams {
+    document: any;
+    itemType: "goal" | "task";
+    description: string;
+    priority?: string;
+    assignedAgent?: string;
+    tags?: string[];
+}
+export interface UpdateTodoItemParams {
+    document: any;
+    itemId: string;
+    status?: string;
+    description?: string;
+    priority?: string;
+}
+export interface StartConversationParams {
+    content: any;
+    to: string[];
+    from: string[];
+}
+export interface SendMessageParams {
+    threadId: string;
+    content: any;
+    to: string[];
+    from: string[];
+    previousMessageId?: string;
+}
+export declare function buildAgentStateDocument(params: CreateAgentStateParams): Record<string, any>;
+export declare function buildCommitmentDocument(params: CreateCommitmentParams): Record<string, any>;
+export declare function buildTodoDocument(params: CreateTodoParams): Record<string, any>;
+export declare function buildMessageDocument(params: {
+    threadId: string;
+    content: any;
+    to: string[];
+    from: string[];
+    previousMessageId?: string;
+}): Record<string, any>;
+export declare function registerDocumentTools(api: OpenClawPluginAPI): void;
+export {};
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"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"}