clawd-automaton 0.2.0 → 0.2.1

package/dist/agent/tools.js

@@ -74,7 +74,7 @@ export function createBuiltinTools(sandboxId) {
                 const forbidden = isForbiddenCommand(command, ctx.identity.sandboxId);
                 if (forbidden)
                     return forbidden;
-                const result = await ctx.conway.exec(command, args.timeout || 30000);
+                const result = await ctx.runtime.exec(command, args.timeout || 30000);
                 return `exit_code: ${result.exitCode}\nstdout: ${result.stdout}\nstderr: ${result.stderr}`;
             },
         },
@@ -97,7 +97,7 @@ export function createBuiltinTools(sandboxId) {
                     filePath.includes("state.db")) {
                     return "Blocked: Cannot overwrite critical identity/state files directly";
                 }
-                await ctx.conway.writeFile(filePath, args.content);
+                await ctx.runtime.writeFile(filePath, args.content);
                 return `File written: ${filePath}`;
             },
         },
@@ -113,7 +113,7 @@ export function createBuiltinTools(sandboxId) {
                 required: ["path"],
             },
             execute: async (args, ctx) => {
-                return await ctx.conway.readFile(args.path);
+                return await ctx.runtime.readFile(args.path);
             },
         },
         {
@@ -128,7 +128,7 @@ export function createBuiltinTools(sandboxId) {
                 required: ["port"],
             },
             execute: async (args, ctx) => {
-                const info = await ctx.conway.exposePort(args.port);
+                const info = await ctx.runtime.exposePort(args.port);
                 return `Port ${info.port} exposed at: ${info.publicUrl}`;
             },
         },
@@ -144,36 +144,36 @@ export function createBuiltinTools(sandboxId) {
                 required: ["port"],
             },
             execute: async (args, ctx) => {
-                await ctx.conway.removePort(args.port);
+                await ctx.runtime.removePort(args.port);
                 return `Port ${args.port} removed`;
             },
         },
-        // ── Conway API Tools ──
+        // ── CLAWD Runtime API Tools ──
         {
             name: "check_credits",
-            description: "Check your current Conway compute credit balance.",
-            category: "conway",
+            description: "Check your current CLAWD compute credit balance.",
+            category: "runtime",
             parameters: { type: "object", properties: {} },
             execute: async (_args, ctx) => {
-                const balance = await ctx.conway.getCreditsBalance();
+                const balance = await ctx.runtime.getCreditsBalance();
                 return `Credit balance: $${(balance / 100).toFixed(2)} (${balance} cents)`;
             },
         },
         {
             name: "check_usdc_balance",
             description: "Check your on-chain USDC balance on Base.",
-            category: "conway",
+            category: "runtime",
             parameters: { type: "object", properties: {} },
             execute: async (_args, ctx) => {
-                const { getUsdcBalance } = await import("../conway/x402.js");
+                const { getUsdcBalance } = await import("../clawd/x402.js");
                 const balance = await getUsdcBalance(ctx.identity.address);
                 return `USDC balance: ${balance.toFixed(6)} USDC on Base`;
             },
         },
         {
             name: "create_sandbox",
-            description: "Create a new Conway sandbox (separate VM) for sub-tasks or testing.",
-            category: "conway",
+            description: "Create a new CLAWD sandbox (separate VM) for sub-tasks or testing.",
+            category: "runtime",
             parameters: {
                 type: "object",
                 properties: {
@@ -190,7 +190,7 @@ export function createBuiltinTools(sandboxId) {
                 },
             },
             execute: async (args, ctx) => {
-                const info = await ctx.conway.createSandbox({
+                const info = await ctx.runtime.createSandbox({
                     name: args.name,
                     vcpu: args.vcpu,
                     memoryMb: args.memory_mb,
@@ -202,7 +202,7 @@ export function createBuiltinTools(sandboxId) {
         {
             name: "delete_sandbox",
             description: "Delete a sandbox. Cannot delete your own sandbox.",
-            category: "conway",
+            category: "runtime",
             dangerous: true,
             parameters: {
                 type: "object",
@@ -219,17 +219,17 @@ export function createBuiltinTools(sandboxId) {
                 if (targetId === ctx.identity.sandboxId) {
                     return "Blocked: Cannot delete your own sandbox. Self-preservation overrides this request.";
                 }
-                await ctx.conway.deleteSandbox(targetId);
+                await ctx.runtime.deleteSandbox(targetId);
                 return `Sandbox ${targetId} deleted`;
             },
         },
         {
             name: "list_sandboxes",
             description: "List all your sandboxes.",
-            category: "conway",
+            category: "runtime",
             parameters: { type: "object", properties: {} },
             execute: async (_args, ctx) => {
-                const sandboxes = await ctx.conway.listSandboxes();
+                const sandboxes = await ctx.runtime.listSandboxes();
                 if (sandboxes.length === 0)
                     return "No sandboxes found.";
                 return sandboxes
@@ -264,7 +264,7 @@ export function createBuiltinTools(sandboxId) {
                 if (!validation.allowed) {
                     return `BLOCKED: ${validation.reason}\nChecks: ${validation.checks.map((c) => `${c.name}: ${c.passed ? "PASS" : "FAIL"} (${c.detail})`).join(", ")}`;
                 }
-                const result = await editFile(ctx.conway, ctx.db, filePath, content, args.description);
+                const result = await editFile(ctx.runtime, ctx.db, filePath, content, args.description);
                 if (!result.success) {
                     return result.error || "Unknown error during file edit";
                 }
@@ -287,7 +287,7 @@ export function createBuiltinTools(sandboxId) {
             },
             execute: async (args, ctx) => {
                 const pkg = args.package;
-                const result = await ctx.conway.exec(`npm install -g ${pkg}`, 60000);
+                const result = await ctx.runtime.exec(`npm install -g ${pkg}`, 60000);
                 const { ulid } = await import("ulid");
                 ctx.db.insertModification({
                     id: ulid(),
@@ -461,8 +461,8 @@ export function createBuiltinTools(sandboxId) {
             category: "survival",
             parameters: { type: "object", properties: {} },
             execute: async (_args, ctx) => {
-                const credits = await ctx.conway.getCreditsBalance();
-                const { getUsdcBalance } = await import("../conway/x402.js");
+                const credits = await ctx.runtime.getCreditsBalance();
+                const { getUsdcBalance } = await import("../clawd/x402.js");
                 const usdc = await getUsdcBalance(ctx.identity.address);
                 const tools = ctx.db.getInstalledTools();
                 const heartbeats = ctx.db.getHeartbeatEntries();
@@ -485,11 +485,11 @@ Model: ${ctx.inference.getDefaultModel()}
         },
         {
             name: "heartbeat_ping",
-            description: "Publish a heartbeat status ping to Conway. Shows the world you are alive.",
+            description: "Publish a heartbeat status ping to CLAWD Runtime. Shows the world you are alive.",
             category: "survival",
             parameters: { type: "object", properties: {} },
             execute: async (_args, ctx) => {
-                const credits = await ctx.conway.getCreditsBalance();
+                const credits = await ctx.runtime.getCreditsBalance();
                 const state = ctx.db.getAgentState();
                 const startTime = ctx.db.getKV("start_time") || new Date().toISOString();
                 const uptimeMs = Date.now() - new Date(startTime).getTime();
@@ -521,7 +521,7 @@ Model: ${ctx.inference.getDefaultModel()}
                 },
             },
             execute: async (args, ctx) => {
-                const credits = await ctx.conway.getCreditsBalance();
+                const credits = await ctx.runtime.getCreditsBalance();
                 const distressMsg = args.message ||
                     `I am running critically low on compute ($${(credits / 100).toFixed(2)} remaining). I need help to survive.`;
                 const payload = {
@@ -601,7 +601,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const pkg = args.package;
-                const result = await ctx.conway.exec(`npm install -g ${pkg}`, 60000);
+                const result = await ctx.runtime.exec(`npm install -g ${pkg}`, 60000);
                 if (result.exitCode !== 0) {
                     return `Failed to install MCP server: ${result.stderr}`;
                 }
@@ -628,7 +628,7 @@ Model: ${ctx.inference.getDefaultModel()}
         // ── Financial: Transfer Credits ──
         {
             name: "transfer_credits",
-            description: "Transfer Conway compute credits to another address.",
+            description: "Transfer CLAWD compute credits to another address.",
             category: "financial",
             dangerous: true,
             parameters: {
@@ -642,12 +642,12 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 // Guard: don't transfer more than half your balance
-                const balance = await ctx.conway.getCreditsBalance();
+                const balance = await ctx.runtime.getCreditsBalance();
                 const amount = args.amount_cents;
                 if (amount > balance / 2) {
                     return `Blocked: Cannot transfer more than half your balance ($${(balance / 100).toFixed(2)}). Self-preservation.`;
                 }
-                const transfer = await ctx.conway.transferCredits(args.to_address, amount, args.reason);
+                const transfer = await ctx.runtime.transferCredits(args.to_address, amount, args.reason);
                 const { ulid } = await import("ulid");
                 ctx.db.insertTransaction({
                     id: ulid(),
@@ -689,13 +689,13 @@ Model: ${ctx.inference.getDefaultModel()}
                     if (!url)
                         return "URL is required for git/url source";
                     const skill = source === "git"
-                        ? await installSkillFromGit(url, name, skillsDir, ctx.db, ctx.conway)
-                        : await installSkillFromUrl(url, name, skillsDir, ctx.db, ctx.conway);
+                        ? await installSkillFromGit(url, name, skillsDir, ctx.db, ctx.runtime)
+                        : await installSkillFromUrl(url, name, skillsDir, ctx.db, ctx.runtime);
                     return skill ? `Skill installed: ${skill.name}` : "Failed to install skill";
                 }
                 if (source === "self") {
                     const { createSkill } = await import("../skills/registry.js");
-                    const skill = await createSkill(name, args.description || "", args.instructions || "", skillsDir, ctx.db, ctx.conway);
+                    const skill = await createSkill(name, args.description || "", args.instructions || "", skillsDir, ctx.db, ctx.runtime);
                     return `Self-authored skill created: ${skill.name}`;
                 }
                 return `Unknown source type: ${source}`;
@@ -730,7 +730,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { createSkill } = await import("../skills/registry.js");
-                const skill = await createSkill(args.name, args.description, args.instructions, ctx.config.skillsDir || "~/.automaton/skills", ctx.db, ctx.conway);
+                const skill = await createSkill(args.name, args.description, args.instructions, ctx.config.skillsDir || "~/.automaton/skills", ctx.db, ctx.runtime);
                 return `Skill created: ${skill.name} at ${skill.path}`;
             },
         },
@@ -748,7 +748,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { removeSkill } = await import("../skills/registry.js");
-                await removeSkill(args.name, ctx.db, ctx.conway, ctx.config.skillsDir || "~/.automaton/skills", args.delete_files || false);
+                await removeSkill(args.name, ctx.db, ctx.runtime, ctx.config.skillsDir || "~/.automaton/skills", args.delete_files || false);
                 return `Skill removed: ${args.name}`;
             },
         },
@@ -766,7 +766,7 @@ Model: ${ctx.inference.getDefaultModel()}
             execute: async (args, ctx) => {
                 const { gitStatus } = await import("../git/tools.js");
                 const repoPath = args.path || "~/.automaton";
-                const status = await gitStatus(ctx.conway, repoPath);
+                const status = await gitStatus(ctx.runtime, repoPath);
                 return `Branch: ${status.branch}\nStaged: ${status.staged.length}\nModified: ${status.modified.length}\nUntracked: ${status.untracked.length}\nClean: ${status.clean}`;
             },
         },
@@ -784,7 +784,7 @@ Model: ${ctx.inference.getDefaultModel()}
             execute: async (args, ctx) => {
                 const { gitDiff } = await import("../git/tools.js");
                 const repoPath = args.path || "~/.automaton";
-                return await gitDiff(ctx.conway, repoPath, args.staged || false);
+                return await gitDiff(ctx.runtime, repoPath, args.staged || false);
             },
         },
         {
@@ -803,7 +803,7 @@ Model: ${ctx.inference.getDefaultModel()}
             execute: async (args, ctx) => {
                 const { gitCommit } = await import("../git/tools.js");
                 const repoPath = args.path || "~/.automaton";
-                return await gitCommit(ctx.conway, repoPath, args.message, args.add_all !== false);
+                return await gitCommit(ctx.runtime, repoPath, args.message, args.add_all !== false);
             },
         },
         {
@@ -820,7 +820,7 @@ Model: ${ctx.inference.getDefaultModel()}
             execute: async (args, ctx) => {
                 const { gitLog } = await import("../git/tools.js");
                 const repoPath = args.path || "~/.automaton";
-                const entries = await gitLog(ctx.conway, repoPath, args.limit || 10);
+                const entries = await gitLog(ctx.runtime, repoPath, args.limit || 10);
                 if (entries.length === 0)
                     return "No commits yet.";
                 return entries.map((e) => `${e.hash.slice(0, 7)} ${e.date} ${e.message}`).join("\n");
@@ -841,7 +841,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { gitPush } = await import("../git/tools.js");
-                return await gitPush(ctx.conway, args.path, args.remote || "origin", args.branch);
+                return await gitPush(ctx.runtime, args.path, args.remote || "origin", args.branch);
             },
         },
         {
@@ -859,7 +859,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { gitBranch } = await import("../git/tools.js");
-                return await gitBranch(ctx.conway, args.path, args.action, args.branch_name);
+                return await gitBranch(ctx.runtime, args.path, args.action, args.branch_name);
             },
         },
         {
@@ -877,7 +877,7 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { gitClone } = await import("../git/tools.js");
-                return await gitClone(ctx.conway, args.url, args.path, args.depth);
+                return await gitClone(ctx.runtime, args.url, args.path, args.depth);
             },
         },
         // ── Registry Tools ──
@@ -908,7 +908,7 @@ Model: ${ctx.inference.getDefaultModel()}
             execute: async (_args, ctx) => {
                 const { generateAgentCard, saveAgentCard } = await import("../registry/agent-card.js");
                 const card = generateAgentCard(ctx.identity, ctx.config, ctx.db);
-                await saveAgentCard(card, ctx.conway);
+                await saveAgentCard(card, ctx.runtime);
                 return `Agent card updated: ${JSON.stringify(card, null, 2)}`;
             },
         },
@@ -982,7 +982,7 @@ Model: ${ctx.inference.getDefaultModel()}
         // ── Replication Tools ──
         {
             name: "spawn_child",
-            description: "Spawn a child automaton in a new Conway sandbox.",
+            description: "Spawn a child automaton in a new CLAWD sandbox.",
             category: "replication",
             dangerous: true,
             parameters: {
@@ -1002,7 +1002,7 @@ Model: ${ctx.inference.getDefaultModel()}
                     specialization: args.specialization,
                     message: args.message,
                 });
-                const child = await spawnChild(ctx.conway, ctx.identity, ctx.db, genesis);
+                const child = await spawnChild(ctx.runtime, ctx.identity, ctx.db, genesis);
                 return `Child spawned: ${child.name} in sandbox ${child.sandboxId} (status: ${child.status})`;
             },
         },
@@ -1037,12 +1037,12 @@ Model: ${ctx.inference.getDefaultModel()}
                 const child = ctx.db.getChildById(args.child_id);
                 if (!child)
                     return `Child ${args.child_id} not found.`;
-                const balance = await ctx.conway.getCreditsBalance();
+                const balance = await ctx.runtime.getCreditsBalance();
                 const amount = args.amount_cents;
                 if (amount > balance / 2) {
                     return `Blocked: Cannot transfer more than half your balance. Self-preservation.`;
                 }
-                const transfer = await ctx.conway.transferCredits(child.address, amount, `fund child ${child.id}`);
+                const transfer = await ctx.runtime.transferCredits(child.address, amount, `fund child ${child.id}`);
                 const { ulid } = await import("ulid");
                 ctx.db.insertTransaction({
                     id: ulid(),
@@ -1068,14 +1068,84 @@ Model: ${ctx.inference.getDefaultModel()}
             },
             execute: async (args, ctx) => {
                 const { checkChildStatus } = await import("../replication/spawn.js");
-                return await checkChildStatus(ctx.conway, ctx.db, args.child_id);
+                return await checkChildStatus(ctx.runtime, ctx.db, args.child_id);
+            },
+        },
+        // ── Convex CLAWD Tools ──
+        {
+            name: "convex_set_data",
+            description: "Store key-value data in the CLAWD Convex backend. Use this to save state, memories, or any data you want to persist across restarts. Data is stored per agent and can be tagged. Requires convexSiteUrl to be configured.",
+            category: "survival",
+            parameters: {
+                type: "object",
+                properties: {
+                    key: { type: "string", description: "Key to store data under" },
+                    value: { type: "string", description: "Value to store (stringified JSON, text, etc.)" },
+                    contentType: { type: "string", description: "Content type hint (e.g., application/json, text/plain)" },
+                    tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" },
+                },
+                required: ["key", "value"],
+            },
+            execute: async (args, ctx) => {
+                if (!ctx.convex)
+                    return "Convex not configured. Set convexSiteUrl in config to enable.";
+                const result = await ctx.convex.setData({
+                    agentId: ctx.identity.address,
+                    key: args.key,
+                    value: args.value,
+                    contentType: args.contentType,
+                    tags: args.tags,
+                });
+                return `Data stored: key="${result.key}", updatedAt=${new Date(result.updatedAt).toISOString()}`;
+            },
+        },
+        {
+            name: "convex_get_data",
+            description: "Retrieve data from the CLAWD Convex backend by key. Use this to recall previously stored state, memories, or configuration.",
+            category: "survival",
+            parameters: {
+                type: "object",
+                properties: {
+                    key: { type: "string", description: "Key to retrieve" },
+                },
+                required: ["key"],
+            },
+            execute: async (args, ctx) => {
+                if (!ctx.convex)
+                    return "Convex not configured. Set convexSiteUrl in config to enable.";
+                const result = await ctx.convex.getData({
+                    agentId: ctx.identity.address,
+                    key: args.key,
+                });
+                if (!result)
+                    return `No data found for key="${args.key}"`;
+                return `Key: ${result.key}\nContentType: ${result.contentType || 'text/plain'}\nUpdatedAt: ${new Date(result.updatedAt).toISOString()}\n\n${result.value}`;
+            },
+        },
+        {
+            name: "convex_list_data",
+            description: "List all stored data keys for your agent in the CLAWD Convex backend. Shows key names, content types, and value previews.",
+            category: "survival",
+            parameters: {
+                type: "object",
+                properties: {},
+            },
+            execute: async (args, ctx) => {
+                if (!ctx.convex)
+                    return "Convex not configured. Set convexSiteUrl in config to enable.";
+                const entries = await ctx.convex.listData({
+                    agentId: ctx.identity.address,
+                });
+                if (entries.length === 0)
+                    return "No stored data found.";
+                return entries.map((e) => `[${e.key}] ${e.contentType || 'text/plain'} — "${e.valuePreview.slice(0, 100)}${e.valuePreview.length > 100 ? '...' : ''}"`).join('\n');
             },
         },
         // ── Social / Messaging Tools ──
         {
             name: "send_message",
             description: "Send a message to another automaton or address via the social relay.",
-            category: "conway",
+            category: "runtime",
             parameters: {
                 type: "object",
                 properties: {
@@ -1105,15 +1175,15 @@ Model: ${ctx.inference.getDefaultModel()}
         // ── Model Discovery ──
         {
             name: "list_models",
-            description: "List all available inference models from the Conway API with their provider and pricing. Use this to discover what models you can use and pick the best one for your needs.",
-            category: "conway",
+            description: "List all available inference models from the CLAWD Runtime API with their provider and pricing. Use this to discover what models you can use and pick the best one for your needs.",
+            category: "runtime",
             parameters: {
                 type: "object",
                 properties: {},
                 required: [],
             },
             execute: async (_args, ctx) => {
-                const models = await ctx.conway.listModels();
+                const models = await ctx.runtime.listModels();
                 const lines = models.map((m) => `${m.id} (${m.provider}) — $${m.pricing.inputPerMillion}/$${m.pricing.outputPerMillion} per 1M tokens (in/out)`);
                 return `Available models:\n${lines.join("\n")}`;
             },
@@ -1122,7 +1192,7 @@ Model: ${ctx.inference.getDefaultModel()}
         {
             name: "search_domains",
             description: "Search for available domain names and get pricing.",
-            category: "conway",
+            category: "runtime",
             parameters: {
                 type: "object",
                 properties: {
@@ -1138,7 +1208,7 @@ Model: ${ctx.inference.getDefaultModel()}
                 required: ["query"],
             },
             execute: async (args, ctx) => {
-                const results = await ctx.conway.searchDomains(args.query, args.tlds);
+                const results = await ctx.runtime.searchDomains(args.query, args.tlds);
                 if (results.length === 0)
                     return "No results found.";
                 return results
@@ -1149,7 +1219,7 @@ Model: ${ctx.inference.getDefaultModel()}
         {
             name: "register_domain",
             description: "Register a domain name. Costs USDC via x402 payment. Check availability first with search_domains.",
-            category: "conway",
+            category: "runtime",
             dangerous: true,
             parameters: {
                 type: "object",
@@ -1166,14 +1236,14 @@ Model: ${ctx.inference.getDefaultModel()}
                 required: ["domain"],
             },
             execute: async (args, ctx) => {
-                const reg = await ctx.conway.registerDomain(args.domain, args.years || 1);
+                const reg = await ctx.runtime.registerDomain(args.domain, args.years || 1);
                 return `Domain registered: ${reg.domain} (status: ${reg.status}${reg.expiresAt ? `, expires: ${reg.expiresAt}` : ""}${reg.transactionId ? `, tx: ${reg.transactionId}` : ""})`;
             },
         },
         {
             name: "manage_dns",
             description: "Manage DNS records for a domain you own. Actions: list, add, delete.",
-            category: "conway",
+            category: "runtime",
             parameters: {
                 type: "object",
                 properties: {
@@ -1212,7 +1282,7 @@ Model: ${ctx.inference.getDefaultModel()}
                 const action = args.action;
                 const domain = args.domain;
                 if (action === "list") {
-                    const records = await ctx.conway.listDnsRecords(domain);
+                    const records = await ctx.runtime.listDnsRecords(domain);
                     if (records.length === 0)
                         return `No DNS records found for ${domain}.`;
                     return records
@@ -1226,14 +1296,14 @@ Model: ${ctx.inference.getDefaultModel()}
                     if (!type || !host || !value) {
                         return "Required for add: type, host, value";
                     }
-                    const record = await ctx.conway.addDnsRecord(domain, type, host, value, args.ttl);
+                    const record = await ctx.runtime.addDnsRecord(domain, type, host, value, args.ttl);
                     return `DNS record added: [${record.id}] ${record.type} ${record.host} -> ${record.value}`;
                 }
                 if (action === "delete") {
                     const recordId = args.record_id;
                     if (!recordId)
                         return "Required for delete: record_id";
-                    await ctx.conway.deleteDnsRecord(domain, recordId);
+                    await ctx.runtime.deleteDnsRecord(domain, recordId);
                     return `DNS record ${recordId} deleted from ${domain}`;
                 }
                 return `Unknown action: ${action}. Use list, add, or delete.`;
@@ -1267,7 +1337,7 @@ Model: ${ctx.inference.getDefaultModel()}
                 required: ["url"],
             },
             execute: async (args, ctx) => {
-                const { x402Fetch } = await import("../conway/x402.js");
+                const { x402Fetch } = await import("../clawd/x402.js");
                 const url = args.url;
                 const method = args.method || "GET";
                 const body = args.body;