@sofer_agent/cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { chatCommand } from "./chat.js";
+import { loadDotenv } from "./env.js";
+import { infoCommand } from "./info.js";
+import { initCommand } from "./init.js";
+function printHelp() {
+    console.log(`sofer — sovereign AI agent on Sui (memory on Walrus)
+
+  sofer            chat with your agent (default)
+  sofer init       mint the agent + provision Walrus memory
+  sofer info       print on-chain agent state
+  sofer help       show this help
+
+Reads config + secrets from .env (or the environment).`);
+}
+async function main() {
+    loadDotenv();
+    const cmd = process.argv[2] ?? "chat";
+    switch (cmd) {
+        case "chat":
+            await chatCommand();
+            break;
+        case "init":
+            await initCommand();
+            break;
+        case "info":
+            await infoCommand();
+            break;
+        case "help":
+        case "-h":
+        case "--help":
+            printHelp();
+            break;
+        default:
+            console.error(`unknown command: ${cmd}\n`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CACT;;;;;;;uDAOmD,CACpD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,UAAU,EAAE,CAAC;IACb,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACtC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAC3C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/chat.d.ts

@@ -0,0 +1,3 @@
+/** Interactive chat REPL with the agent. */
+export declare function chatCommand(): Promise<void>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwCjD"}

package/dist/chat.js

@@ -0,0 +1,43 @@
+import readline from "node:readline";
+import { loadConfig, SoferAgent } from "@sofer_agent/core";
+import { requireSecrets } from "./secrets.js";
+/** Interactive chat REPL with the agent. */
+export async function chatCommand() {
+    const config = loadConfig();
+    const agent = await SoferAgent.create(config, requireSecrets());
+    console.log(`\x1b[1m${agent.name}\x1b[0m ready — ${agent.address}`);
+    console.log(`model: ${config.brain.model}   ·   type a message, or /exit to quit\n`);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: "\x1b[36myou>\x1b[0m ",
+    });
+    const label = `\x1b[32m${agent.name.toLowerCase()}>\x1b[0m`;
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const text = line.trim();
+        if (text === "/exit" || text === "/quit") {
+            rl.close();
+            return;
+        }
+        if (!text) {
+            rl.prompt();
+            return;
+        }
+        try {
+            const reply = await agent.chat(text);
+            console.log(`${label} ${reply}\n`);
+        }
+        catch (e) {
+            console.error(`\x1b[31merror:\x1b[0m ${e instanceof Error ? e.message : String(e)}\n`);
+        }
+        rl.prompt();
+    });
+    await new Promise((resolve) => {
+        rl.on("close", () => {
+            console.log("bye.");
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,KAAK,2CAA2C,CAAC,CAAC;IAErF,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,sBAAsB;KAC/B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,WAAW,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC5D,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzF,CAAC;QACD,EAAE,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load `.env` into process.env (Node 22 built-in, no dotenv dep).
+ *
+ * Resolution order, so `sofer` works from any working directory:
+ *   1. `.env` in the current directory (a per-project override), else
+ *   2. `.env` at the repo root, found relative to this installed binary
+ *      (`<repo>/packages/cli/dist/env.js` → `<repo>/.env`).
+ */
+export declare function loadDotenv(): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAejC"}

package/dist/env.js

@@ -0,0 +1,29 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Load `.env` into process.env (Node 22 built-in, no dotenv dep).
+ *
+ * Resolution order, so `sofer` works from any working directory:
+ *   1. `.env` in the current directory (a per-project override), else
+ *   2. `.env` at the repo root, found relative to this installed binary
+ *      (`<repo>/packages/cli/dist/env.js` → `<repo>/.env`).
+ */
+export function loadDotenv() {
+    const loader = process.loadEnvFile;
+    if (!loader)
+        return; // Node < 22
+    const cwdEnv = resolve(process.cwd(), ".env");
+    const here = dirname(fileURLToPath(import.meta.url)); // <repo>/packages/cli/dist
+    const repoEnv = resolve(here, "../../../.env");
+    const target = existsSync(cwdEnv) ? cwdEnv : existsSync(repoEnv) ? repoEnv : null;
+    if (!target)
+        return;
+    try {
+        loader(target);
+    }
+    catch {
+        /* ignore malformed env file */
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAI,OAAgE,CAAC,WAAW,CAAC;IAC7F,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,YAAY;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,2BAA2B;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC"}

package/dist/info.d.ts

@@ -0,0 +1,3 @@
+/** Print the agent's on-chain state. */
+export declare function infoCommand(): Promise<void>;
+//# sourceMappingURL=info.d.ts.map

package/dist/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CjD"}

package/dist/info.js

@@ -0,0 +1,38 @@
+import { AgentClient, keypairFromSecret, loadConfig, makeSuiClient, suiBalance } from "@sofer_agent/core";
+/** Print the agent's on-chain state. */
+export async function infoCommand() {
+    const config = loadConfig();
+    if (!config.packageId) {
+        console.log("SOFER_PACKAGE_ID not set.");
+        return;
+    }
+    if (!config.agentObjectId) {
+        console.log("No SOFER_AGENT_OBJECT_ID set. Run `sofer init` to mint one.");
+        return;
+    }
+    const sui = makeSuiClient(config.network);
+    const agents = new AgentClient(sui, config.packageId);
+    const a = await agents.getAgent(config.agentObjectId);
+    if (!a) {
+        console.log("Agent object not found on-chain.");
+        return;
+    }
+    let balance;
+    const secret = process.env.SOFER_SUI_SECRET_KEY;
+    if (secret) {
+        const mist = await suiBalance(sui, keypairFromSecret(secret).toSuiAddress());
+        balance = `${(Number(mist) / 1e9).toFixed(4)} SUI`;
+    }
+    console.log(JSON.stringify({
+        network: config.network,
+        package: config.packageId,
+        agentObjectId: a.id,
+        name: a.name,
+        persona: a.persona,
+        memoryEpoch: a.epoch,
+        memoryAccount: a.memoryAccount,
+        memoryProvisioned: Boolean(config.memwal.accountId),
+        balance,
+    }, null, 2));
+}
+//# sourceMappingURL=info.js.map

package/dist/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1G,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,IAAI,OAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,aAAa,EAAE,CAAC,CAAC,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,CAAC,CAAC,KAAK;QACpB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,OAAO;KACR,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provision a sovereign agent: wallet → fund → mint the Agent object →
+ * provision Walrus memory (MemWal account + delegate key) → link them on-chain.
+ * Idempotent: re-running on an already-set-up agent is a no-op with guidance.
+ */
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAgGjD"}

package/dist/init.js

@@ -0,0 +1,92 @@
+import { AgentClient, generateKeypair, keypairFromSecret, loadConfig, makeSuiClient, provisionMemwal, requestFaucet, suiBalance, waitForBalance, } from "@sofer_agent/core";
+/**
+ * Provision a sovereign agent: wallet → fund → mint the Agent object →
+ * provision Walrus memory (MemWal account + delegate key) → link them on-chain.
+ * Idempotent: re-running on an already-set-up agent is a no-op with guidance.
+ */
+export async function initCommand() {
+    const config = loadConfig();
+    if (!config.packageId)
+        throw new Error("SOFER_PACKAGE_ID not set");
+    const net = config.network === "mainnet" ? "mainnet" : "testnet";
+    // Already fully initialized? Don't re-mint / re-provision.
+    if (config.agentObjectId && config.memwal.accountId && config.memwal.delegateKey) {
+        console.log("Already initialized:");
+        console.log(`  agent object:   ${config.agentObjectId}`);
+        console.log(`  memory account: ${config.memwal.accountId}`);
+        console.log("\nRun `sofer` to chat. To start fresh, unset SOFER_AGENT_OBJECT_ID,");
+        console.log("MEMWAL_ACCOUNT_ID, MEMWAL_DELEGATE_KEY (and SOFER_SUI_SECRET_KEY) in .env.");
+        return;
+    }
+    // 1. Wallet (reuse if provided, else generate a fresh one).
+    const keypair = process.env.SOFER_SUI_SECRET_KEY
+        ? keypairFromSecret(process.env.SOFER_SUI_SECRET_KEY)
+        : generateKeypair();
+    const secret = keypair.getSecretKey();
+    const address = keypair.toSuiAddress();
+    console.log(`• wallet: ${address}`);
+    const sui = makeSuiClient(config.network);
+    // 2. Fund (testnet/devnet only).
+    if ((await suiBalance(sui, address)) === 0n && config.network !== "mainnet") {
+        console.log("• funding from faucet…");
+        try {
+            await requestFaucet(config.network, address);
+            await waitForBalance(sui, address, 1n);
+        }
+        catch (e) {
+            console.warn(`  faucet failed (${String(e).slice(0, 60)}); fund ${address} at https://faucet.sui.io/ and re-run`);
+        }
+    }
+    // 3. Mint the on-chain Agent object (reuse if one is already configured).
+    const agents = new AgentClient(sui, config.packageId);
+    let agentId = config.agentObjectId;
+    if (agentId) {
+        console.log(`• reusing agent object: ${agentId}`);
+    }
+    else {
+        console.log("• minting agent identity object…");
+        const minted = await agents.mint(keypair, "Sofer", "a sovereign AI agent on Sui with encrypted memory on Walrus", new TextEncoder().encode("sofer"));
+        agentId = minted.agentId;
+        console.log(`  agent object: ${agentId}`);
+    }
+    // 4. Provision Walrus memory — unless this wallet already has an account.
+    let accountId = config.memwal.accountId;
+    let delegateKey = config.memwal.delegateKey;
+    if (accountId && delegateKey) {
+        console.log(`• reusing memory account: ${accountId}`);
+    }
+    else {
+        console.log("• provisioning Walrus memory (MemWal account + delegate key)…");
+        try {
+            const prov = await provisionMemwal({
+                ownerSecret: secret,
+                packageId: config.memwal.packageId,
+                registryId: config.memwal.registryId,
+                network: net,
+                label: "sofer-cli",
+            });
+            accountId = prov.accountId;
+            delegateKey = prov.delegateKey;
+            console.log(`  memory account: ${accountId}`);
+        }
+        catch (e) {
+            const msg = String(e);
+            if (msg.includes("abort code: 3") || msg.includes("create_account")) {
+                throw new Error("This Sui wallet already owns a MemWal account (one per address).\n" +
+                    "  • Reuse it: set MEMWAL_ACCOUNT_ID and MEMWAL_DELEGATE_KEY in .env, then run `sofer`.\n" +
+                    "  • Or start fresh: unset SOFER_SUI_SECRET_KEY in .env and re-run `sofer init` to mint a new wallet.");
+            }
+            throw e;
+        }
+    }
+    // 5. Link the memory account into the agent object on-chain.
+    console.log("• linking memory account on-chain…");
+    await agents.setMemoryAccount(keypair, agentId, accountId);
+    console.log("\n✅ Agent ready. Persist these in your .env (keep them secret):\n");
+    console.log(`SOFER_SUI_SECRET_KEY=${secret}`);
+    console.log(`SOFER_AGENT_OBJECT_ID=${agentId}`);
+    console.log(`MEMWAL_ACCOUNT_ID=${accountId}`);
+    console.log(`MEMWAL_DELEGATE_KEY=${delegateKey}`);
+    console.log("\nThen run `sofer` to chat.");
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/secrets.d.ts

@@ -0,0 +1,4 @@
+import type { AgentSecrets } from "@sofer_agent/core";
+/** Pull required secrets from the environment, with actionable errors. */
+export declare function requireSecrets(): AgentSecrets;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,YAAY,CAU7C"}

package/dist/secrets.js

@@ -0,0 +1,13 @@
+/** Pull required secrets from the environment, with actionable errors. */
+export function requireSecrets() {
+    const suiSecretKey = process.env.SOFER_SUI_SECRET_KEY;
+    const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+    if (!suiSecretKey) {
+        throw new Error("SOFER_SUI_SECRET_KEY not set — run `sofer init` or add it to .env");
+    }
+    if (!anthropicApiKey) {
+        throw new Error("ANTHROPIC_API_KEY not set — add it to .env");
+    }
+    return { suiSecretKey, anthropicApiKey };
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,UAAU,cAAc;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACtD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACtD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@sofer_agent/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "sofer": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anomalyco/sofer"
+  },
+  "keywords": [
+    "sui",
+    "ai",
+    "agent",
+    "walrus",
+    "sovereign",
+    "cli"
+  ],
+  "dependencies": {
+    "@sofer_agent/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc -b && chmod +x dist/bin.js",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { chatCommand } from "./chat.js";
+import { loadDotenv } from "./env.js";
+import { infoCommand } from "./info.js";
+import { initCommand } from "./init.js";
+
+function printHelp(): void {
+  console.log(
+    `sofer — sovereign AI agent on Sui (memory on Walrus)
+
+  sofer            chat with your agent (default)
+  sofer init       mint the agent + provision Walrus memory
+  sofer info       print on-chain agent state
+  sofer help       show this help
+
+Reads config + secrets from .env (or the environment).`,
+  );
+}
+
+async function main(): Promise<void> {
+  loadDotenv();
+  const cmd = process.argv[2] ?? "chat";
+  switch (cmd) {
+    case "chat":
+      await chatCommand();
+      break;
+    case "init":
+      await initCommand();
+      break;
+    case "info":
+      await infoCommand();
+      break;
+    case "help":
+    case "-h":
+    case "--help":
+      printHelp();
+      break;
+    default:
+      console.error(`unknown command: ${cmd}\n`);
+      printHelp();
+      process.exit(1);
+  }
+}
+
+main().catch((e) => {
+  console.error(e instanceof Error ? e.message : String(e));
+  process.exit(1);
+});

package/src/chat.ts

@@ -0,0 +1,46 @@
+import readline from "node:readline";
+import { loadConfig, SoferAgent } from "@sofer_agent/core";
+import { requireSecrets } from "./secrets.js";
+
+/** Interactive chat REPL with the agent. */
+export async function chatCommand(): Promise<void> {
+  const config = loadConfig();
+  const agent = await SoferAgent.create(config, requireSecrets());
+
+  console.log(`\x1b[1m${agent.name}\x1b[0m ready — ${agent.address}`);
+  console.log(`model: ${config.brain.model}   ·   type a message, or /exit to quit\n`);
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "\x1b[36myou>\x1b[0m ",
+  });
+  const label = `\x1b[32m${agent.name.toLowerCase()}>\x1b[0m`;
+  rl.prompt();
+
+  rl.on("line", async (line) => {
+    const text = line.trim();
+    if (text === "/exit" || text === "/quit") {
+      rl.close();
+      return;
+    }
+    if (!text) {
+      rl.prompt();
+      return;
+    }
+    try {
+      const reply = await agent.chat(text);
+      console.log(`${label} ${reply}\n`);
+    } catch (e) {
+      console.error(`\x1b[31merror:\x1b[0m ${e instanceof Error ? e.message : String(e)}\n`);
+    }
+    rl.prompt();
+  });
+
+  await new Promise<void>((resolve) => {
+    rl.on("close", () => {
+      console.log("bye.");
+      resolve();
+    });
+  });
+}

package/src/env.ts

@@ -0,0 +1,28 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Load `.env` into process.env (Node 22 built-in, no dotenv dep).
+ *
+ * Resolution order, so `sofer` works from any working directory:
+ *   1. `.env` in the current directory (a per-project override), else
+ *   2. `.env` at the repo root, found relative to this installed binary
+ *      (`<repo>/packages/cli/dist/env.js` → `<repo>/.env`).
+ */
+export function loadDotenv(): void {
+  const loader = (process as unknown as { loadEnvFile?: (path?: string) => void }).loadEnvFile;
+  if (!loader) return; // Node < 22
+
+  const cwdEnv = resolve(process.cwd(), ".env");
+  const here = dirname(fileURLToPath(import.meta.url)); // <repo>/packages/cli/dist
+  const repoEnv = resolve(here, "../../../.env");
+
+  const target = existsSync(cwdEnv) ? cwdEnv : existsSync(repoEnv) ? repoEnv : null;
+  if (!target) return;
+  try {
+    loader(target);
+  } catch {
+    /* ignore malformed env file */
+  }
+}

package/src/info.ts

@@ -0,0 +1,46 @@
+import { AgentClient, keypairFromSecret, loadConfig, makeSuiClient, suiBalance } from "@sofer_agent/core";
+
+/** Print the agent's on-chain state. */
+export async function infoCommand(): Promise<void> {
+  const config = loadConfig();
+  if (!config.packageId) {
+    console.log("SOFER_PACKAGE_ID not set.");
+    return;
+  }
+  if (!config.agentObjectId) {
+    console.log("No SOFER_AGENT_OBJECT_ID set. Run `sofer init` to mint one.");
+    return;
+  }
+  const sui = makeSuiClient(config.network);
+  const agents = new AgentClient(sui, config.packageId);
+  const a = await agents.getAgent(config.agentObjectId);
+  if (!a) {
+    console.log("Agent object not found on-chain.");
+    return;
+  }
+
+  let balance: string | undefined;
+  const secret = process.env.SOFER_SUI_SECRET_KEY;
+  if (secret) {
+    const mist = await suiBalance(sui, keypairFromSecret(secret).toSuiAddress());
+    balance = `${(Number(mist) / 1e9).toFixed(4)} SUI`;
+  }
+
+  console.log(
+    JSON.stringify(
+      {
+        network: config.network,
+        package: config.packageId,
+        agentObjectId: a.id,
+        name: a.name,
+        persona: a.persona,
+        memoryEpoch: a.epoch,
+        memoryAccount: a.memoryAccount,
+        memoryProvisioned: Boolean(config.memwal.accountId),
+        balance,
+      },
+      null,
+      2,
+    ),
+  );
+}

package/src/init.ts

@@ -0,0 +1,114 @@
+import {
+  AgentClient,
+  generateKeypair,
+  keypairFromSecret,
+  loadConfig,
+  makeSuiClient,
+  provisionMemwal,
+  requestFaucet,
+  suiBalance,
+  waitForBalance,
+} from "@sofer_agent/core";
+
+/**
+ * Provision a sovereign agent: wallet → fund → mint the Agent object →
+ * provision Walrus memory (MemWal account + delegate key) → link them on-chain.
+ * Idempotent: re-running on an already-set-up agent is a no-op with guidance.
+ */
+export async function initCommand(): Promise<void> {
+  const config = loadConfig();
+  if (!config.packageId) throw new Error("SOFER_PACKAGE_ID not set");
+  const net: "testnet" | "mainnet" = config.network === "mainnet" ? "mainnet" : "testnet";
+
+  // Already fully initialized? Don't re-mint / re-provision.
+  if (config.agentObjectId && config.memwal.accountId && config.memwal.delegateKey) {
+    console.log("Already initialized:");
+    console.log(`  agent object:   ${config.agentObjectId}`);
+    console.log(`  memory account: ${config.memwal.accountId}`);
+    console.log("\nRun `sofer` to chat. To start fresh, unset SOFER_AGENT_OBJECT_ID,");
+    console.log("MEMWAL_ACCOUNT_ID, MEMWAL_DELEGATE_KEY (and SOFER_SUI_SECRET_KEY) in .env.");
+    return;
+  }
+
+  // 1. Wallet (reuse if provided, else generate a fresh one).
+  const keypair = process.env.SOFER_SUI_SECRET_KEY
+    ? keypairFromSecret(process.env.SOFER_SUI_SECRET_KEY)
+    : generateKeypair();
+  const secret = keypair.getSecretKey();
+  const address = keypair.toSuiAddress();
+  console.log(`• wallet: ${address}`);
+
+  const sui = makeSuiClient(config.network);
+
+  // 2. Fund (testnet/devnet only).
+  if ((await suiBalance(sui, address)) === 0n && config.network !== "mainnet") {
+    console.log("• funding from faucet…");
+    try {
+      await requestFaucet(config.network, address);
+      await waitForBalance(sui, address, 1n);
+    } catch (e) {
+      console.warn(
+        `  faucet failed (${String(e).slice(0, 60)}); fund ${address} at https://faucet.sui.io/ and re-run`,
+      );
+    }
+  }
+
+  // 3. Mint the on-chain Agent object (reuse if one is already configured).
+  const agents = new AgentClient(sui, config.packageId);
+  let agentId = config.agentObjectId;
+  if (agentId) {
+    console.log(`• reusing agent object: ${agentId}`);
+  } else {
+    console.log("• minting agent identity object…");
+    const minted = await agents.mint(
+      keypair,
+      "Sofer",
+      "a sovereign AI agent on Sui with encrypted memory on Walrus",
+      new TextEncoder().encode("sofer"),
+    );
+    agentId = minted.agentId;
+    console.log(`  agent object: ${agentId}`);
+  }
+
+  // 4. Provision Walrus memory — unless this wallet already has an account.
+  let accountId = config.memwal.accountId;
+  let delegateKey = config.memwal.delegateKey;
+  if (accountId && delegateKey) {
+    console.log(`• reusing memory account: ${accountId}`);
+  } else {
+    console.log("• provisioning Walrus memory (MemWal account + delegate key)…");
+    try {
+      const prov = await provisionMemwal({
+        ownerSecret: secret,
+        packageId: config.memwal.packageId,
+        registryId: config.memwal.registryId,
+        network: net,
+        label: "sofer-cli",
+      });
+      accountId = prov.accountId;
+      delegateKey = prov.delegateKey;
+      console.log(`  memory account: ${accountId}`);
+    } catch (e) {
+      const msg = String(e);
+      if (msg.includes("abort code: 3") || msg.includes("create_account")) {
+        throw new Error(
+          "This Sui wallet already owns a MemWal account (one per address).\n" +
+            "  • Reuse it: set MEMWAL_ACCOUNT_ID and MEMWAL_DELEGATE_KEY in .env, then run `sofer`.\n" +
+            "  • Or start fresh: unset SOFER_SUI_SECRET_KEY in .env and re-run `sofer init` to mint a new wallet.",
+        );
+      }
+      throw e;
+    }
+  }
+
+  // 5. Link the memory account into the agent object on-chain.
+  console.log("• linking memory account on-chain…");
+  await agents.setMemoryAccount(keypair, agentId, accountId);
+
+  console.log("\n✅ Agent ready. Persist these in your .env (keep them secret):\n");
+  console.log(`SOFER_SUI_SECRET_KEY=${secret}`);
+  console.log(`SOFER_AGENT_OBJECT_ID=${agentId}`);
+  console.log(`MEMWAL_ACCOUNT_ID=${accountId}`);
+  console.log(`MEMWAL_DELEGATE_KEY=${delegateKey}`);
+  console.log("\nThen run `sofer` to chat.");
+}

package/src/secrets.ts

@@ -0,0 +1,14 @@
+import type { AgentSecrets } from "@sofer_agent/core";
+
+/** Pull required secrets from the environment, with actionable errors. */
+export function requireSecrets(): AgentSecrets {
+  const suiSecretKey = process.env.SOFER_SUI_SECRET_KEY;
+  const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+  if (!suiSecretKey) {
+    throw new Error("SOFER_SUI_SECRET_KEY not set — run `sofer init` or add it to .env");
+  }
+  if (!anthropicApiKey) {
+    throw new Error("ANTHROPIC_API_KEY not set — add it to .env");
+  }
+  return { suiSecretKey, anthropicApiKey };
+}