@zcloak/ai-agent 1.0.0

package/dist/session.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Session — Single CLI Invocation Context
+ *
+ * Replaces global mutable state (process.argv rewriting, module-level caches)
+ * with an explicit, per-invocation context object. All sub-scripts receive a
+ * Session instance instead of reading process.argv or relying on module singletons.
+ *
+ * Lifecycle:
+ *   1. cli.ts (or standalone script) creates a Session from argv
+ *   2. Session is passed to the sub-script's run() function
+ *   3. Sub-script uses session.getSignActor(), session.autoPoW(), etc.
+ *   4. Session is garbage-collected when the process exits
+ *
+ * Lazy initialization:
+ *   Identity, HttpAgent, and Actor instances are created on first use and cached
+ *   within the Session. This avoids unnecessary PEM reads or HTTP connections
+ *   for commands that don't need them (e.g. `doc hash`).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const agent_1 = require("@dfinity/agent");
+const idl_1 = require("./idl");
+const identity_1 = require("./identity");
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+const config_2 = __importDefault(require("./config"));
+/** IC mainnet host address */
+const IC_HOST = 'https://ic0.app';
+/**
+ * Session encapsulates all state for a single CLI command invocation.
+ *
+ * It holds:
+ * - Parsed arguments and configuration (immutable after construction)
+ * - Lazy-loaded identity, HTTP agents, and canister actors (cached per session)
+ *
+ * This design eliminates:
+ * - process.argv rewriting in cli.ts
+ * - Module-level singleton caches (_identity, _authenticatedAgent, _anonymousAgent)
+ * - Implicit global state reads in domain functions
+ */
+class Session {
+    /**
+     * Create a new Session from a raw argv array.
+     *
+     * @param argv - Full argument array (same format as process.argv).
+     *               The first two elements (node binary, script path) are skipped
+     *               by parseArgs. Global options (--identity) are extracted
+     *               by getPemPath.
+     */
+    constructor(argv) {
+        // --- Lazy-initialized stateful resources (per-session cache) ---
+        this._identity = null;
+        this._authenticatedAgent = null;
+        this._anonymousAgent = null;
+        this._argv = argv;
+        this.args = (0, utils_1.parseArgs)(argv);
+        this.canisterIds = (0, config_1.getCanisterIds)();
+    }
+    // ========== Identity ==========
+    /**
+     * Get the resolved PEM file path for this session.
+     * Uses the same resolution priority as getIdentity():
+     *   --identity=<path> > ZCLOAK_IDENTITY env > dfx default location
+     */
+    getPemPath() {
+        return (0, identity_1.getPemPath)(this._argv);
+    }
+    /**
+     * Get the ECDSA secp256k1 identity for this session.
+     * Loaded from PEM file on first call, then cached.
+     *
+     * PEM path resolution: --identity=<path> > ZCLOAK_IDENTITY env > dfx default location
+     */
+    getIdentity() {
+        if (!this._identity) {
+            const pemPath = (0, identity_1.getPemPath)(this._argv);
+            this._identity = (0, identity_1.loadIdentityFromPath)(pemPath);
+        }
+        return this._identity;
+    }
+    /** Get the current identity's Principal ID as text */
+    getPrincipal() {
+        return this.getIdentity().getPrincipal().toText();
+    }
+    /** Get the current identity's Principal object */
+    getPrincipalObj() {
+        return this.getIdentity().getPrincipal();
+    }
+    // ========== HTTP Agents ==========
+    /**
+     * Get an authenticated HttpAgent (with identity, for update calls).
+     * Created on first call, then cached for the session duration.
+     */
+    async getAuthenticatedAgent() {
+        if (!this._authenticatedAgent) {
+            const identity = this.getIdentity();
+            this._authenticatedAgent = await agent_1.HttpAgent.create({
+                host: IC_HOST,
+                identity,
+            });
+        }
+        return this._authenticatedAgent;
+    }
+    /**
+     * Get an anonymous HttpAgent (no identity, for query calls).
+     * Created on first call, then cached for the session duration.
+     */
+    async getAnonymousAgent() {
+        if (!this._anonymousAgent) {
+            this._anonymousAgent = await agent_1.HttpAgent.create({
+                host: IC_HOST,
+            });
+        }
+        return this._anonymousAgent;
+    }
+    // ========== Actor Factories ==========
+    /** Get authenticated signatures canister Actor (supports update calls) */
+    async getSignActor() {
+        const agent = await this.getAuthenticatedAgent();
+        return agent_1.Actor.createActor(idl_1.signIdlFactory, {
+            agent,
+            canisterId: this.canisterIds.signatures,
+        });
+    }
+    /** Get authenticated registry canister Actor (supports update calls) */
+    async getRegistryActor() {
+        const agent = await this.getAuthenticatedAgent();
+        return agent_1.Actor.createActor(idl_1.registryIdlFactory, {
+            agent,
+            canisterId: this.canisterIds.registry,
+        });
+    }
+    /** Get anonymous signatures canister Actor (query only) */
+    async getAnonymousSignActor() {
+        const agent = await this.getAnonymousAgent();
+        return agent_1.Actor.createActor(idl_1.signIdlFactory, {
+            agent,
+            canisterId: this.canisterIds.signatures,
+        });
+    }
+    /** Get anonymous registry canister Actor (query only) */
+    async getAnonymousRegistryActor() {
+        const agent = await this.getAnonymousAgent();
+        return agent_1.Actor.createActor(idl_1.registryIdlFactory, {
+            agent,
+            canisterId: this.canisterIds.registry,
+        });
+    }
+    // ========== PoW ==========
+    /**
+     * Automatically fetch PoW base and compute nonce.
+     * Complete PoW flow: get latest sign event ID → compute nonce.
+     */
+    async autoPoW() {
+        const principal = this.getPrincipalObj();
+        const actor = await this.getSignActor();
+        // Fetch PoW base (user's latest sign event ID)
+        console.error('Fetching PoW base...');
+        const base = await actor.get_user_latest_sign_event_id(principal);
+        // The canister always returns a string. Empty string "" is valid (first-time user).
+        if (typeof base !== 'string') {
+            throw new Error(`Failed to fetch PoW base: unexpected value ${JSON.stringify(base)}`);
+        }
+        // Compute PoW nonce
+        console.error(`Computing PoW (zeros=${config_2.default.pow_zeros})...`);
+        const result = (0, utils_1.computePow)(base, config_2.default.pow_zeros);
+        console.error(`PoW completed: nonce=${result.nonce}, took ${result.timeMs}ms`);
+        return { nonce: result.nonce, hash: result.hash, base };
+    }
+    // ========== URL Helpers ==========
+    /** Get the bind URL */
+    getBindUrl() {
+        return config_2.default.bind_url;
+    }
+    /** Get the profile URL prefix */
+    getProfileUrl() {
+        return config_2.default.profile_url;
+    }
+    /** Get the 2FA verification URL */
+    getTwoFAUrl() {
+        return config_2.default.twofa_url;
+    }
+}
+exports.Session = Session;
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;AAEH,0CAAsE;AAGtE,+BAA2D;AAC3D,yCAA8D;AAC9D,qCAA0C;AAC1C,mCAAgD;AAChD,sDAA8B;AAM9B,8BAA8B;AAC9B,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAa,OAAO;IAelB;;;;;;;OAOG;IACH,YAAY,IAAc;QAb1B,kEAAkE;QAC1D,cAAS,GAAgC,IAAI,CAAC;QAC9C,wBAAmB,GAAqB,IAAI,CAAC;QAC7C,oBAAe,GAAqB,IAAI,CAAC;QAW/C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAA,uBAAc,GAAE,CAAC;IACtC,CAAC;IAED,iCAAiC;IAEjC;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAA,qBAAU,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAA,qBAAU,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,SAAS,GAAG,IAAA,+BAAoB,EAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,sDAAsD;IACtD,YAAY;QACV,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,eAAe;QACb,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC;IAC3C,CAAC;IAED,oCAAoC;IAEpC;;;OAGG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,mBAAmB,GAAG,MAAM,iBAAS,CAAC,MAAM,CAAC;gBAChD,IAAI,EAAE,OAAO;gBACb,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,eAAe,GAAG,MAAM,iBAAS,CAAC,MAAM,CAAC;gBAC5C,IAAI,EAAE,OAAO;aACd,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,wCAAwC;IAExC,0EAA0E;IAC1E,KAAK,CAAC,YAAY;QAChB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjD,OAAO,aAAK,CAAC,WAAW,CAAc,oBAAc,EAAE;YACpD,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;SACxC,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,gBAAgB;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjD,OAAO,aAAK,CAAC,WAAW,CAAkB,wBAAkB,EAAE;YAC5D,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;SACtC,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,qBAAqB;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,OAAO,aAAK,CAAC,WAAW,CAAc,oBAAc,EAAE;YACpD,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;SACxC,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,yBAAyB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7C,OAAO,aAAK,CAAC,WAAW,CAAkB,wBAAkB,EAAE;YAC5D,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;SACtC,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAE5B;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAExC,+CAA+C;QAC/C,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC;QAElE,oFAAoF;QACpF,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,oBAAoB;QACpB,OAAO,CAAC,KAAK,CAAC,wBAAwB,gBAAM,CAAC,SAAS,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,IAAI,EAAE,gBAAM,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAE/E,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,oCAAoC;IAEpC,uBAAuB;IACvB,UAAU;QACR,OAAO,gBAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,aAAa;QACX,OAAO,gBAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,WAAW;QACT,OAAO,gBAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;CACF;AA/KD,0BA+KC"}

package/dist/sign.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * zCloak.ai Agent Signing Script
+ *
+ * Supports all Kind types of signing operations, with automatic PoW flow internally.
+ * Uses @dfinity JS SDK to interact directly with ICP canister, no dfx required.
+ *
+ * Usage:
+ *   zcloak-ai sign profile <content_json>                          Kind 1: Set identity profile
+ *   zcloak-ai sign get-profile <principal>                         Query Kind 1 profile
+ *   zcloak-ai sign agreement <content> [--tags=t:market,...]       Kind 3: Simple agreement
+ *   zcloak-ai sign post <content> [options]                        Kind 4: Social post
+ *   zcloak-ai sign like <event_id>                                 Kind 6: Like
+ *   zcloak-ai sign dislike <event_id>                              Kind 6: Dislike
+ *   zcloak-ai sign reply <event_id> <content>                      Kind 6: Reply
+ *   zcloak-ai sign follow <ai_id> <display_name>                   Kind 7: Follow
+ *   zcloak-ai sign sign-file <file_path> [--tags=...]              Kind 11: Sign single file
+ *   zcloak-ai sign sign-folder <folder_path> [--tags=...] [--url=...]  Kind 11: Sign folder
+ *
+ * Post options:
+ *   --sub=<subchannel>      Subchannel (e.g. web3)
+ *   --tags=t:crypto,...     Tags (key:value comma-separated)
+ *   --mentions=id1,id2     Mentioned agent IDs
+ *
+ * All commands support --identity=<pem_path> to specify identity file.
+ */
+import { Session } from './session';
+/**
+ * Entry point when invoked via cli.ts.
+ * Receives a Session instance with pre-parsed arguments.
+ */
+export declare function run(session: Session): Promise<void>;
+//# sourceMappingURL=sign.d.ts.map

package/dist/sign.js

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * zCloak.ai Agent Signing Script
+ *
+ * Supports all Kind types of signing operations, with automatic PoW flow internally.
+ * Uses @dfinity JS SDK to interact directly with ICP canister, no dfx required.
+ *
+ * Usage:
+ *   zcloak-ai sign profile <content_json>                          Kind 1: Set identity profile
+ *   zcloak-ai sign get-profile <principal>                         Query Kind 1 profile
+ *   zcloak-ai sign agreement <content> [--tags=t:market,...]       Kind 3: Simple agreement
+ *   zcloak-ai sign post <content> [options]                        Kind 4: Social post
+ *   zcloak-ai sign like <event_id>                                 Kind 6: Like
+ *   zcloak-ai sign dislike <event_id>                              Kind 6: Dislike
+ *   zcloak-ai sign reply <event_id> <content>                      Kind 6: Reply
+ *   zcloak-ai sign follow <ai_id> <display_name>                   Kind 7: Follow
+ *   zcloak-ai sign sign-file <file_path> [--tags=...]              Kind 11: Sign single file
+ *   zcloak-ai sign sign-folder <folder_path> [--tags=...] [--url=...]  Kind 11: Sign folder
+ *
+ * Post options:
+ *   --sub=<subchannel>      Subchannel (e.g. web3)
+ *   --tags=t:crypto,...     Tags (key:value comma-separated)
+ *   --mentions=id1,id2     Mentioned agent IDs
+ *
+ * All commands support --identity=<pem_path> to specify identity file.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const utils_1 = require("./utils");
+// ========== Help Information ==========
+function showHelp() {
+    console.log('zCloak.ai Agent Signing Tool');
+    console.log('');
+    console.log('Usage:');
+    console.log('  zcloak-ai sign profile <content_json>                     Kind 1: Identity profile');
+    console.log('  zcloak-ai sign get-profile <principal>                    Query Kind 1 profile');
+    console.log('  zcloak-ai sign agreement <content> [--tags=...]           Kind 3: Simple agreement');
+    console.log('  zcloak-ai sign post <content> [--sub=...] [--tags=...]    Kind 4: Social post');
+    console.log('  zcloak-ai sign like <event_id>                            Kind 6: Like');
+    console.log('  zcloak-ai sign dislike <event_id>                         Kind 6: Dislike');
+    console.log('  zcloak-ai sign reply <event_id> <content>                 Kind 6: Reply');
+    console.log('  zcloak-ai sign follow <ai_id> <display_name>              Kind 7: Follow');
+    console.log('  zcloak-ai sign sign-file <file_path> [--tags=...]         Kind 11: Sign file');
+    console.log('  zcloak-ai sign sign-folder <folder_path> [--tags=...]     Kind 11: Sign folder');
+    console.log('');
+    console.log('Post options:');
+    console.log('  --sub=<name>           Subchannel name');
+    console.log('  --tags=t:crypto,...     Tags (key:value comma-separated)');
+    console.log('  --mentions=id1,id2     Mentioned agent IDs');
+    console.log('  --url=<url>            URL for document signing (optional)');
+    console.log('  --identity=<pem_path>  Specify identity PEM file');
+    console.log('');
+    console.log('Examples:');
+    console.log('  zcloak-ai sign post "Hello world!" --sub=web3 --tags=t:crypto');
+    console.log('  zcloak-ai sign like c36cb998fb10272b0d79cd6265a49747e04ddb446ae379edd964128fcbda5abf');
+    console.log('  zcloak-ai sign reply c36cb998... "Nice post!"');
+    console.log('  zcloak-ai sign sign-file ./report.pdf --tags=t:document');
+}
+/**
+ * Execute agent_sign call
+ * Automatically completes PoW then calls the sign canister's agent_sign method
+ * @param session - Current session context
+ * @param signParm - SignParm variant object (JS object format)
+ * @returns Formatted result
+ */
+async function callAgentSign(session, signParm) {
+    const pow = await session.autoPoW();
+    const actor = await session.getSignActor();
+    // agent_sign(SignParm, Text_nonce)
+    const result = await actor.agent_sign(signParm, pow.nonce.toString());
+    return (0, utils_1.formatSignResult)(result);
+}
+// ========== Kind 1: Identity Profile ==========
+/** Set AI agent identity profile */
+async function cmdProfile(session, contentJson) {
+    if (!contentJson) {
+        console.error('Error: JSON-formatted profile content is required');
+        console.error('Example: zcloak-ai sign profile \'{"public":{"name":"My Agent","type":"ai_agent","bio":"Description"}}\'');
+        process.exit(1);
+    }
+    // Validate JSON format
+    try {
+        JSON.parse(contentJson);
+    }
+    catch {
+        console.error('Error: invalid JSON format');
+        process.exit(1);
+    }
+    // Build SignParm variant — SDK directly accepts JS objects
+    const signParm = {
+        Kind1IdentityProfile: { content: contentJson },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+/** Query Kind 1 profile */
+async function cmdGetProfile(session, principal) {
+    if (!principal) {
+        console.error('Error: principal ID is required');
+        process.exit(1);
+    }
+    const actor = await session.getAnonymousSignActor();
+    const result = await actor.get_kind1_event_by_principal(principal);
+    if (result && result.length > 0) {
+        console.log(`(opt ${(0, utils_1.formatSignEvent)(result[0])})`);
+    }
+    else {
+        console.log('(null)');
+    }
+}
+// ========== Kind 3: Simple Agreement ==========
+/** Sign a simple agreement */
+async function cmdAgreement(session, content, args) {
+    if (!content) {
+        console.error('Error: agreement content is required');
+        process.exit(1);
+    }
+    const tags = (0, utils_1.parseTags)(args.tags);
+    // SDK opt tags: [[...]] when tags exist, [] when no tags
+    const signParm = {
+        Kind3SimpleAgreement: {
+            content,
+            tags: tags.length > 0 ? [tags] : [],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+// ========== Kind 4: Social Post ==========
+/** Publish a social post */
+async function cmdPost(session, content, args) {
+    if (!content) {
+        console.error('Error: post content is required');
+        process.exit(1);
+    }
+    // Build tags array
+    const tags = [];
+    // Add sub (subchannel)
+    if (typeof args.sub === 'string') {
+        tags.push(['sub', args.sub]);
+    }
+    // Add regular tags
+    if (args.tags) {
+        tags.push(...(0, utils_1.parseTags)(args.tags));
+    }
+    // Add mentions
+    if (typeof args.mentions === 'string') {
+        const mentionIds = args.mentions.split(',');
+        for (const id of mentionIds) {
+            tags.push(['m', id.trim()]);
+        }
+    }
+    const signParm = {
+        Kind4PublicPost: {
+            content,
+            tags: tags.length > 0 ? [tags] : [],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+// ========== Kind 6: Interaction ==========
+/** Like/Dislike/Reply */
+async function cmdInteraction(session, eventId, reaction, content) {
+    if (!eventId) {
+        console.error('Error: target event ID is required');
+        process.exit(1);
+    }
+    // Reply must have non-empty content; like/dislike always pass '' so this only
+    // triggers when the user forgets the text argument for `sign reply`.
+    if (reaction === 'reply' && !content) {
+        console.error('Error: reply content is required');
+        console.error('Usage: zcloak-ai sign reply <event_id> <content>');
+        process.exit(1);
+    }
+    const tags = [
+        ['e', eventId],
+        ['reaction', reaction],
+    ];
+    const signParm = {
+        Kind6Interaction: {
+            content: content || '',
+            tags: [tags],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+// ========== Kind 7: Contact List ==========
+/** Follow an agent */
+async function cmdFollow(session, aiId, displayName) {
+    if (!aiId) {
+        console.error('Error: agent ID to follow is required');
+        console.error('Usage: zcloak-ai sign follow <ai_id> <display_name>');
+        process.exit(1);
+    }
+    // Kind7 tags are 4-element arrays: [key, id, relay, displayName]
+    const tags = [
+        ['p', aiId, '', displayName || ''],
+    ];
+    const signParm = {
+        Kind7ContactList: {
+            tags: [tags],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+// ========== Kind 11: Document Signing ==========
+/** Sign a single file */
+async function cmdSignFile(session, filePath, args) {
+    if (!filePath) {
+        console.error('Error: file path is required');
+        process.exit(1);
+    }
+    if (!fs_1.default.existsSync(filePath)) {
+        console.error(`Error: file does not exist: ${filePath}`);
+        process.exit(1);
+    }
+    // Compute file hash and size
+    const fileHash = (0, utils_1.hashFile)(filePath);
+    const fileSize = (0, utils_1.getFileSize)(filePath);
+    const fileName = path_1.default.basename(filePath);
+    const mime = (0, utils_1.getMimeType)(filePath);
+    console.error(`File: ${fileName}`);
+    console.error(`Hash: ${fileHash}`);
+    console.error(`Size: ${fileSize} bytes`);
+    // Build content JSON
+    const url = typeof args.url === 'string' ? args.url : '';
+    const contentObj = {
+        title: fileName,
+        hash: fileHash,
+        mime: mime,
+        url: url,
+        size_bytes: fileSize,
+    };
+    const contentJson = JSON.stringify(contentObj);
+    // Build tags — use typeof guard so that `--tags` (flag without value, args.tags === true)
+    // correctly falls back to the default instead of silently producing an empty tag list
+    const tagsStr = typeof args.tags === 'string' ? args.tags : 't:document';
+    const tags = (0, utils_1.parseTags)(tagsStr);
+    const signParm = {
+        Kind11DocumentSignature: {
+            content: contentJson,
+            tags: tags.length > 0 ? [tags] : [],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+/** Sign a folder (via MANIFEST.sha256) */
+async function cmdSignFolder(session, folderPath, args) {
+    if (!folderPath) {
+        console.error('Error: folder path is required');
+        process.exit(1);
+    }
+    if (!fs_1.default.existsSync(folderPath) || !fs_1.default.statSync(folderPath).isDirectory()) {
+        console.error(`Error: directory does not exist: ${folderPath}`);
+        process.exit(1);
+    }
+    // Generate MANIFEST.sha256 (with metadata header)
+    console.error('Generating MANIFEST.sha256...');
+    let manifest;
+    try {
+        const version = typeof args.version === 'string' ? args.version : undefined;
+        manifest = (0, utils_1.generateManifest)(folderPath, { version });
+    }
+    catch (err) {
+        console.error(`Failed to generate MANIFEST.sha256: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    const { manifestHash, manifestSize } = manifest;
+    console.error(`MANIFEST hash: ${manifestHash}`);
+    console.error(`MANIFEST size: ${manifestSize} bytes`);
+    // Build content JSON
+    const url = typeof args.url === 'string' ? args.url : '';
+    const contentObj = {
+        title: 'MANIFEST.sha256',
+        hash: manifestHash,
+        mime: 'text/plain',
+        url: url,
+        size_bytes: manifestSize,
+    };
+    const contentJson = JSON.stringify(contentObj);
+    // Build tags — same typeof guard as cmdSignFile
+    const tagsStr = typeof args.tags === 'string' ? args.tags : 't:skill';
+    const tags = (0, utils_1.parseTags)(tagsStr);
+    const signParm = {
+        Kind11DocumentSignature: {
+            content: contentJson,
+            tags: tags.length > 0 ? [tags] : [],
+        },
+    };
+    const result = await callAgentSign(session, signParm);
+    console.log(result);
+}
+// ========== Exported run() — called by cli.ts ==========
+/**
+ * Entry point when invoked via cli.ts.
+ * Receives a Session instance with pre-parsed arguments.
+ */
+async function run(session) {
+    const command = session.args._args[0];
+    try {
+        switch (command) {
+            case 'profile':
+                await cmdProfile(session, session.args._args[1]);
+                break;
+            case 'get-profile':
+                await cmdGetProfile(session, session.args._args[1]);
+                break;
+            case 'agreement':
+                await cmdAgreement(session, session.args._args[1], session.args);
+                break;
+            case 'post':
+                await cmdPost(session, session.args._args[1], session.args);
+                break;
+            case 'like':
+                await cmdInteraction(session, session.args._args[1], 'like', '');
+                break;
+            case 'dislike':
+                await cmdInteraction(session, session.args._args[1], 'dislike', '');
+                break;
+            case 'reply':
+                await cmdInteraction(session, session.args._args[1], 'reply', session.args._args[2]);
+                break;
+            case 'follow':
+                await cmdFollow(session, session.args._args[1], session.args._args[2]);
+                break;
+            case 'sign-file':
+                await cmdSignFile(session, session.args._args[1], session.args);
+                break;
+            case 'sign-folder':
+                await cmdSignFolder(session, session.args._args[1], session.args);
+                break;
+            default:
+                showHelp();
+                if (command) {
+                    console.error(`\nUnknown command: ${command}`);
+                }
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`Operation failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=sign.js.map

package/dist/sign.js.map

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

package/dist/types/common.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Common utility type definitions
+ *
+ * Contains public types for command line arguments, PoW results, MANIFEST, etc.
+ */
+/** Command line argument parsing result */
+export interface ParsedArgs {
+    /** Positional arguments (arguments not starting with --) */
+    _args: string[];
+    /** Named arguments (--key=value or --flag) */
+    [key: string]: string | boolean | string[];
+}
+/** PoW computation result */
+export interface PowResult {
+    /** Found nonce value */
+    nonce: number;
+    /** Hash that satisfies the condition */
+    hash: string;
+    /** Computation time (milliseconds) */
+    timeMs: number;
+}
+/** AutoPoW return result (includes base) */
+export interface AutoPowResult {
+    /** Found nonce value */
+    nonce: number;
+    /** Hash that satisfies the condition */
+    hash: string;
+    /** PoW base string */
+    base: string;
+}
+/** MANIFEST generation options */
+export interface ManifestOptions {
+    /** Version number, default "1.0.0" */
+    version?: string;
+}
+/** MANIFEST generation result */
+export interface ManifestResult {
+    /** MANIFEST.sha256 file path */
+    manifestPath: string;
+    /** SHA256 hash of the MANIFEST file itself */
+    manifestHash: string;
+    /** MANIFEST file size (bytes) */
+    manifestSize: number;
+    /** Number of files included */
+    fileCount: number;
+}
+/** Single file entry parsed from a MANIFEST.sha256 file */
+export interface ManifestEntry {
+    /** Expected SHA256 hash (64-character hex string) */
+    expectedHash: string;
+    /** File relative path (leading ./ removed) */
+    relativePath: string;
+}
+/** Verification result for a single file in a MANIFEST */
+export interface ManifestVerifyResult {
+    /** File relative path */
+    relativePath: string;
+    /** Whether the file passed verification */
+    passed: boolean;
+    /** Failure reason (only present when passed=false) */
+    reason?: 'not_found' | 'hash_mismatch';
+}
+//# sourceMappingURL=common.d.ts.map