@agent-native/core 0.4.1 → 0.4.3

package/dist/scripts/db/exec.js

@@ -0,0 +1,101 @@
+/**
+ * Core script: db-exec
+ *
+ * Execute a write SQL statement (INSERT, UPDATE, DELETE, etc.)
+ * against a SQLite database.
+ *
+ * Usage:
+ *   pnpm script db-exec --sql "UPDATE forms SET status='published' WHERE id='abc'" [--db path]
+ */
+import path from "path";
+import { createClient } from "@libsql/client";
+import { parseArgs, fail } from "../utils.js";
+export default async function dbExec(args) {
+    const parsed = parseArgs(args);
+    if (parsed.help === "true") {
+        console.log(`Usage: pnpm script db-exec --sql "<statement>" [options]
+
+Options:
+  --sql <stmt>    SQL statement to execute (required)
+  --db <path>     Path to SQLite database (default: data/app.db)
+  --format json   Output as JSON
+  --help          Show this help message`);
+        return;
+    }
+    const sql = parsed.sql;
+    if (!sql) {
+        fail("--sql is required. Example: --sql \"UPDATE forms SET status='published' WHERE id='abc'\"");
+    }
+    // Allowlist: only permit DML statements the agent should run
+    const stripped = sql
+        .replace(/^\s*--[^\n]*\n/gm, "")
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .trim();
+    const upper = stripped.toUpperCase();
+    const allowed = ["INSERT", "UPDATE", "DELETE", "REPLACE", "CREATE", "ALTER"];
+    const blocked = ["SELECT", "WITH", "EXPLAIN", "PRAGMA"];
+    if (blocked.some((kw) => upper.startsWith(kw))) {
+        fail("Use db-query for SELECT/read statements. db-exec is for writes only.");
+    }
+    if (!allowed.some((kw) => upper.startsWith(kw))) {
+        fail(`Only ${allowed.join(", ")} statements are allowed. ` +
+            `Dangerous operations like DROP, ATTACH, VACUUM, and DETACH are blocked.`);
+    }
+    // Resolve database URL: --db flag → DATABASE_URL env → default file path
+    let url;
+    if (parsed.db) {
+        url = "file:" + path.resolve(parsed.db);
+    }
+    else if (process.env.DATABASE_URL) {
+        url = process.env.DATABASE_URL;
+    }
+    else {
+        url = "file:" + path.resolve(process.cwd(), "data", "app.db");
+    }
+    const client = createClient({
+        url,
+        authToken: process.env.DATABASE_AUTH_TOKEN,
+    });
+    try {
+        // Detect if the SQL has a RETURNING clause — those produce rows
+        const hasReturning = /\bRETURNING\b/i.test(stripped);
+        const result = await client.execute(sql);
+        if (hasReturning && result.rows.length > 0) {
+            const rows = result.rows.map((row) => {
+                const obj = {};
+                for (let i = 0; i < result.columns.length; i++) {
+                    obj[result.columns[i]] = row[i];
+                }
+                return obj;
+            });
+            if (parsed.format === "json") {
+                console.log(JSON.stringify({ sql, rows, count: rows.length }, null, 2));
+                return;
+            }
+            console.log(`Executed: ${sql}`);
+            console.log(`Returned ${rows.length} row(s):`);
+            if (rows.length > 0) {
+                console.log(JSON.stringify(rows, null, 2));
+            }
+        }
+        else {
+            if (parsed.format === "json") {
+                console.log(JSON.stringify({
+                    sql,
+                    changes: result.rowsAffected,
+                    lastInsertRowid: Number(result.lastInsertRowid ?? 0),
+                }, null, 2));
+                return;
+            }
+            console.log(`Executed: ${sql}`);
+            console.log(`Changes: ${result.rowsAffected}`);
+            if (result.lastInsertRowid && result.rowsAffected > 0) {
+                console.log(`Last Insert Row ID: ${result.lastInsertRowid}`);
+            }
+        }
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/scripts/db/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/scripts/db/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC;;;;;;yCAMyB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CACF,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,GAAG;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,IAAI,EAAE,CAAC;IACV,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAExD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/C,IAAI,CACF,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAChD,IAAI,CACF,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B;YACnD,yEAAyE,CAC5E,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,IAAI,GAAW,CAAC;IAChB,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACpC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG;QACH,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;KAC3C,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,gEAAgE;QAChE,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,GAA8B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC9D,MAAM,GAAG,GAA4B,EAAE,CAAC;gBACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC/C,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClC,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACxE,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;oBACE,GAAG;oBACH,OAAO,EAAE,MAAM,CAAC,YAAY;oBAC5B,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;iBACrD,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/scripts/db/index.d.ts

@@ -0,0 +1,2 @@
+export declare const coreDbScripts: Record<string, (args: string[]) => Promise<void>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scripts/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scripts/db/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAKzE,CAAC"}

package/dist/scripts/db/index.js

@@ -0,0 +1,6 @@
+export const coreDbScripts = {
+    "db-schema": (args) => import("./schema.js").then((m) => m.default(args)),
+    "db-query": (args) => import("./query.js").then((m) => m.default(args)),
+    "db-exec": (args) => import("./exec.js").then((m) => m.default(args)),
+};
+//# sourceMappingURL=index.js.map

package/dist/scripts/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scripts/db/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GACxB;IACE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE,CAAC"}

package/dist/scripts/db/query.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core script: db-query
+ *
+ * Run a read-only SQL query against a SQLite database.
+ *
+ * Usage:
+ *   pnpm script db-query --sql "SELECT * FROM forms" [--db path] [--format json] [--limit N]
+ */
+export default function dbQuery(args: string[]): Promise<void>;
+//# sourceMappingURL=query.d.ts.map

package/dist/scripts/db/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/scripts/db/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAA8B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuHnE"}

package/dist/scripts/db/query.js

@@ -0,0 +1,112 @@
+/**
+ * Core script: db-query
+ *
+ * Run a read-only SQL query against a SQLite database.
+ *
+ * Usage:
+ *   pnpm script db-query --sql "SELECT * FROM forms" [--db path] [--format json] [--limit N]
+ */
+import path from "path";
+import { createClient } from "@libsql/client";
+import { parseArgs, fail } from "../utils.js";
+export default async function dbQuery(args) {
+    const parsed = parseArgs(args);
+    if (parsed.help === "true") {
+        console.log(`Usage: pnpm script db-query --sql "<query>" [options]
+
+Options:
+  --sql <query>   SQL SELECT query to run (required)
+  --db <path>     Path to SQLite database (default: data/app.db)
+  --format json   Output as JSON instead of a table
+  --limit N       Append LIMIT N if not already present
+  --help          Show this help message`);
+        return;
+    }
+    const sql = parsed.sql;
+    if (!sql) {
+        fail('--sql is required. Example: --sql "SELECT * FROM forms"');
+    }
+    // Safety: only allow read-only statements.
+    // Strip leading SQL comments before checking the prefix.
+    const stripped = sql
+        .replace(/^\s*--[^\n]*\n/gm, "")
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .trim();
+    const upper = stripped.toUpperCase();
+    if (!upper.startsWith("SELECT") &&
+        !upper.startsWith("WITH") &&
+        !upper.startsWith("EXPLAIN") &&
+        !upper.startsWith("PRAGMA")) {
+        fail("Only SELECT, WITH, EXPLAIN, and PRAGMA queries are allowed. Use db-exec for writes.");
+    }
+    // Resolve database URL: --db flag → DATABASE_URL env → default file path
+    let url;
+    if (parsed.db) {
+        url = "file:" + path.resolve(parsed.db);
+    }
+    else if (process.env.DATABASE_URL) {
+        url = process.env.DATABASE_URL;
+    }
+    else {
+        url = "file:" + path.resolve(process.cwd(), "data", "app.db");
+    }
+    const client = createClient({
+        url,
+        authToken: process.env.DATABASE_AUTH_TOKEN,
+    });
+    try {
+        let finalSql = sql;
+        if (parsed.limit &&
+            (upper.startsWith("SELECT") || upper.startsWith("WITH")) &&
+            !/\bLIMIT\b/i.test(stripped)) {
+            const limitVal = parseInt(parsed.limit, 10);
+            if (isNaN(limitVal) || limitVal < 1)
+                fail("--limit must be a positive integer");
+            finalSql = `${sql} LIMIT ${limitVal}`;
+        }
+        const result = await client.execute(finalSql);
+        const rows = result.rows.map((row) => {
+            const obj = {};
+            for (let i = 0; i < result.columns.length; i++) {
+                obj[result.columns[i]] = row[i];
+            }
+            return obj;
+        });
+        if (parsed.format === "json") {
+            console.log(JSON.stringify({ query: finalSql, rows, count: rows.length }, null, 2));
+            return;
+        }
+        // Human-readable table output
+        console.log(`Query: ${finalSql}`);
+        console.log(`Rows: ${rows.length}\n`);
+        if (rows.length === 0) {
+            console.log("(no results)");
+            return;
+        }
+        const keys = Object.keys(rows[0]);
+        const widths = keys.map((k) => {
+            const maxVal = Math.max(...rows.map((r) => String(r[k] ?? "NULL").length));
+            return Math.max(k.length, Math.min(maxVal, 60));
+        });
+        // Header
+        const header = keys.map((k, i) => k.padEnd(widths[i])).join(" | ");
+        console.log(header);
+        console.log(widths.map((w) => "-".repeat(w)).join("-+-"));
+        // Rows
+        for (const row of rows) {
+            const line = keys
+                .map((k, i) => {
+                const val = String(row[k] ?? "NULL");
+                return val.length > 60
+                    ? val.slice(0, 57) + "..."
+                    : val.padEnd(widths[i]);
+            })
+                .join(" | ");
+            console.log(line);
+        }
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/scripts/db/query.js.map

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

package/dist/scripts/db/schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core script: db-schema
+ *
+ * Inspects a SQLite database and prints all tables, columns, types,
+ * constraints, and foreign keys. Gives the agent full visibility
+ * into the app's data model.
+ *
+ * Usage:
+ *   pnpm script db-schema [--db path] [--format json]
+ */
+export default function dbSchema(args: string[]): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/scripts/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/scripts/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4CH,wBAA8B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoIpE"}

package/dist/scripts/db/schema.js

@@ -0,0 +1,140 @@
+/**
+ * Core script: db-schema
+ *
+ * Inspects a SQLite database and prints all tables, columns, types,
+ * constraints, and foreign keys. Gives the agent full visibility
+ * into the app's data model.
+ *
+ * Usage:
+ *   pnpm script db-schema [--db path] [--format json]
+ */
+import path from "path";
+import { createClient } from "@libsql/client";
+import { parseArgs } from "../utils.js";
+/**
+ * Execute a PRAGMA query and return the rows as plain objects.
+ */
+async function pragma(client, pragmaQuery) {
+    const result = await client.execute(pragmaQuery);
+    return result.rows.map((row) => {
+        const obj = {};
+        for (let i = 0; i < result.columns.length; i++) {
+            obj[result.columns[i]] = row[i];
+        }
+        return obj;
+    });
+}
+export default async function dbSchema(args) {
+    const parsed = parseArgs(args);
+    if (parsed.help === "true") {
+        console.log(`Usage: pnpm script db-schema [--db <path>] [--format json]
+
+Options:
+  --db <path>     Path to SQLite database (default: data/app.db)
+  --format json   Output as JSON instead of human-readable text
+  --help          Show this help message`);
+        return;
+    }
+    // Resolve database URL: --db flag → DATABASE_URL env → default file path
+    let url;
+    if (parsed.db) {
+        url = "file:" + path.resolve(parsed.db);
+    }
+    else if (process.env.DATABASE_URL) {
+        url = process.env.DATABASE_URL;
+    }
+    else {
+        url = "file:" + path.resolve(process.cwd(), "data", "app.db");
+    }
+    const client = createClient({
+        url,
+        authToken: process.env.DATABASE_AUTH_TOKEN,
+    });
+    try {
+        const tablesResult = await client.execute(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name`);
+        const tables = tablesResult.rows.map((row) => ({
+            name: row[0],
+        }));
+        const tableInfos = [];
+        for (const t of tables) {
+            const escaped = t.name.replace(/"/g, '""');
+            const columns = await pragma(client, `PRAGMA table_info("${escaped}")`);
+            const fks = await pragma(client, `PRAGMA foreign_key_list("${escaped}")`);
+            const idxList = await pragma(client, `PRAGMA index_list("${escaped}")`);
+            const indexes = [];
+            for (const idx of idxList) {
+                const idxName = idx.name;
+                if (idxName.startsWith("sqlite_"))
+                    continue;
+                const idxInfo = await pragma(client, `PRAGMA index_info("${idxName.replace(/"/g, '""')}")`);
+                indexes.push({
+                    name: idxName,
+                    unique: idx.unique === 1,
+                    columns: idxInfo.map((c) => c.name),
+                });
+            }
+            tableInfos.push({
+                name: t.name,
+                columns: columns.map((c) => ({
+                    name: c.name,
+                    type: c.type || "ANY",
+                    notnull: c.notnull === 1,
+                    pk: c.pk === 1,
+                    dflt_value: c.dflt_value,
+                })),
+                foreignKeys: fks.map((fk) => ({
+                    from: fk.from,
+                    table: fk.table,
+                    to: fk.to,
+                })),
+                indexes,
+            });
+        }
+        if (parsed.format === "json") {
+            const dbLabel = url.startsWith("file:") ? url.slice(5) : url;
+            console.log(JSON.stringify({ database: dbLabel, tables: tableInfos }, null, 2));
+            return;
+        }
+        // Human-readable output
+        const dbLabel = url.startsWith("file:") ? url.slice(5) : url;
+        console.log(`Database: ${dbLabel}`);
+        console.log(`Tables: ${tableInfos.length}\n`);
+        for (const table of tableInfos) {
+            console.log(`Table: ${table.name} (${table.columns.length} columns)`);
+            // Build FK lookup for annotation
+            const fkMap = new Map();
+            for (const fk of table.foreignKeys) {
+                fkMap.set(fk.from, `${fk.table}(${fk.to})`);
+            }
+            // Find max widths for alignment
+            const nameWidth = Math.max(...table.columns.map((c) => c.name.length));
+            const typeWidth = Math.max(...table.columns.map((c) => c.type.length));
+            for (const col of table.columns) {
+                const parts = [];
+                if (col.pk)
+                    parts.push("PRIMARY KEY");
+                if (col.notnull && !col.pk)
+                    parts.push("NOT NULL");
+                if (col.dflt_value !== null)
+                    parts.push(`DEFAULT ${col.dflt_value}`);
+                const fkRef = fkMap.get(col.name);
+                if (fkRef)
+                    parts.push(`→ ${fkRef}`);
+                const constraint = parts.length > 0 ? `  ${parts.join(", ")}` : "";
+                console.log(`  ${col.name.padEnd(nameWidth)}  ${col.type.padEnd(typeWidth)}${constraint}`);
+            }
+            if (table.indexes.length > 0) {
+                console.log(`  Indexes:`);
+                for (const idx of table.indexes) {
+                    const unique = idx.unique ? "UNIQUE " : "";
+                    console.log(`    ${unique}${idx.name} (${idx.columns.join(", ")})`);
+                }
+            }
+            console.log();
+        }
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/scripts/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/scripts/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAQ,MAAM,aAAa,CAAC;AAuB9C;;GAEG;AACH,KAAK,UAAU,MAAM,CACnB,MAAc,EACd,WAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC;;;;;yCAKyB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,yEAAyE;IACzE,IAAI,GAAW,CAAC;IAChB,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACpC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG;QACH,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;KAC3C,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,OAAO,CACvC,8FAA8F,CAC/F,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,GAAG,CAAC,CAAC,CAAW;SACvB,CAAC,CAAC,CAAC;QAEJ,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,sBAAsB,OAAO,IAAI,CAAC,CAAC;YACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,4BAA4B,OAAO,IAAI,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,sBAAsB,OAAO,IAAI,CAAC,CAAC;YAExE,MAAM,OAAO,GACX,EAAE,CAAC;YACL,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAc,CAAC;gBACnC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;oBAAE,SAAS;gBAC5C,MAAM,OAAO,GAAG,MAAM,MAAM,CAC1B,MAAM,EACN,sBAAsB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CACtD,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC;oBACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC;iBAC9C,CAAC,CAAC;YACL,CAAC;YAED,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3B,IAAI,EAAE,CAAC,CAAC,IAAc;oBACtB,IAAI,EAAG,CAAC,CAAC,IAAe,IAAI,KAAK;oBACjC,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,CAAC;oBACxB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;oBACd,UAAU,EAAE,CAAC,CAAC,UAA2B;iBAC1C,CAAC,CAAC;gBACH,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC5B,IAAI,EAAE,EAAE,CAAC,IAAc;oBACvB,KAAK,EAAE,EAAE,CAAC,KAAe;oBACzB,EAAE,EAAE,EAAE,CAAC,EAAY;iBACpB,CAAC,CAAC;gBACH,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC7D,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACnE,CAAC;YACF,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;QAE9C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;YAEtE,iCAAiC;YACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;YACxC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACnC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9C,CAAC;YAED,gCAAgC;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAEvE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,EAAE;oBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACtC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACnD,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;gBACrE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;gBAEpC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,OAAO,CAAC,GAAG,CACT,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,EAAE,CAC9E,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC1B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAChC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/scripts/dev/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dev-mode script registry.
+ *
+ * Provides file system, shell, and database tools for the agent
+ * when running in development mode. These tools should NEVER be
+ * registered in production.
+ */
+import type { ScriptEntry } from "../../agent/production-agent.js";
+/**
+ * Creates the dev-mode script registry with file system, shell,
+ * and database tools. Call this and merge with your app's registry
+ * when NODE_ENV !== "production".
+ */
+export declare function createDevScriptRegistry(): Promise<Record<string, ScriptEntry>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scripts/dev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scripts/dev/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AA8CnE;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CACtD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAC5B,CAkFA"}

package/dist/scripts/dev/index.js

@@ -0,0 +1,118 @@
+/**
+ * Dev-mode script registry.
+ *
+ * Provides file system, shell, and database tools for the agent
+ * when running in development mode. These tools should NEVER be
+ * registered in production.
+ */
+import { tool as readFileTool, run as readFileRun } from "./read-file.js";
+import { tool as writeFileTool, run as writeFileRun } from "./write-file.js";
+import { tool as listFilesTool, run as listFilesRun } from "./list-files.js";
+import { tool as searchFilesTool, run as searchFilesRun, } from "./search-files.js";
+import { tool as shellTool, run as shellRun } from "./shell.js";
+/**
+ * Wraps a core CLI script (that writes to console.log) as a ScriptEntry
+ * by capturing stdout.
+ */
+function wrapCliScript(tool, cliDefault) {
+    return {
+        tool,
+        run: async (args) => {
+            const cliArgs = [];
+            for (const [k, v] of Object.entries(args)) {
+                cliArgs.push(`--${k}`, v);
+            }
+            // Capture console.log output
+            const logs = [];
+            const origLog = console.log;
+            console.log = (...a) => {
+                logs.push(a.map(String).join(" "));
+            };
+            try {
+                await cliDefault(cliArgs);
+            }
+            catch (err) {
+                logs.push(`Error: ${err?.message ?? String(err)}`);
+            }
+            finally {
+                console.log = origLog;
+            }
+            return logs.join("\n") || "(no output)";
+        },
+    };
+}
+/**
+ * Creates the dev-mode script registry with file system, shell,
+ * and database tools. Call this and merge with your app's registry
+ * when NODE_ENV !== "production".
+ */
+export async function createDevScriptRegistry() {
+    // Lazy-import DB scripts to avoid requiring libsql in non-DB apps
+    let dbEntries = {};
+    try {
+        // Dynamic imports — these are part of @agent-native/core
+        const [dbSchema, dbQuery, dbExec] = await Promise.all([
+            import("../db/schema.js"),
+            import("../db/query.js"),
+            import("../db/exec.js"),
+        ]);
+        dbEntries = {
+            "db-schema": wrapCliScript({
+                description: "Show all database tables, columns, types, and foreign keys",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        format: {
+                            type: "string",
+                            description: 'Output format: "json" or "text" (default: text)',
+                            enum: ["json", "text"],
+                        },
+                    },
+                },
+            }, dbSchema.default),
+            "db-query": wrapCliScript({
+                description: "Run a read-only SQL query (SELECT, WITH, EXPLAIN, PRAGMA) against the app database",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sql: {
+                            type: "string",
+                            description: "The SQL SELECT query to execute",
+                        },
+                        format: {
+                            type: "string",
+                            description: 'Output format: "json" or "table" (default: table)',
+                            enum: ["json", "table"],
+                        },
+                    },
+                    required: ["sql"],
+                },
+            }, dbQuery.default),
+            "db-exec": wrapCliScript({
+                description: "Execute a write SQL statement (INSERT, UPDATE, DELETE) against the app database",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sql: {
+                            type: "string",
+                            description: "The SQL statement to execute",
+                        },
+                    },
+                    required: ["sql"],
+                },
+            }, dbExec.default),
+        };
+    }
+    catch {
+        // DB scripts not available (no libsql) — skip silently
+    }
+    return {
+        "read-file": { tool: readFileTool, run: readFileRun },
+        "write-file": { tool: writeFileTool, run: writeFileRun },
+        "list-files": { tool: listFilesTool, run: listFilesRun },
+        "search-files": { tool: searchFilesTool, run: searchFilesRun },
+        shell: { tool: shellTool, run: shellRun },
+        ...dbEntries,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/scripts/dev/index.js.map

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

package/dist/scripts/dev/list-files.d.ts

@@ -0,0 +1,5 @@
+import type { ScriptTool } from "../../agent/types.js";
+export declare const tool: ScriptTool;
+export declare function run(args: Record<string, string>): Promise<string>;
+export default function main(args: string[]): Promise<void>;
+//# sourceMappingURL=list-files.d.ts.map

package/dist/scripts/dev/list-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.d.ts","sourceRoot":"","sources":["../../../src/scripts/dev/list-files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD,eAAO,MAAM,IAAI,EAAE,UAiBlB,CAAC;AAwDF,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BvE;AAED,wBAA8B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE"}