@agent-native/core 0.4.5 → 0.6.1

package/dist/server/poll.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Polling-based change notification.
+ *
+ * Replaces SSE with a simple version counter. Each DB mutation (app-state,
+ * settings, resources) increments the version. Clients poll `/_agent-native/poll?since=N`
+ * and receive any events that occurred after version N.
+ *
+ * Works in all deployment environments (serverless, edge, long-lived).
+ *
+ * Also detects cross-process DB writes by periodically checking the
+ * application_state and settings tables' updated_at timestamps. This ensures
+ * that changes made by external processes (e.g., CLI actions, cron jobs)
+ * are picked up even though they don't call recordChange() in this process.
+ */
+export interface ChangeEvent {
+    version: number;
+    source: string;
+    type: string;
+    key?: string;
+    [k: string]: unknown;
+}
+/** Get the current global version counter. */
+export declare function getVersion(): number;
+/** Record a change event. Called by emitter listeners. */
+export declare function recordChange(event: {
+    source: string;
+    type: string;
+    key?: string;
+    [k: string]: unknown;
+}): void;
+/** Get all changes after a given version. */
+export declare function getChangesSince(since: number): {
+    version: number;
+    events: ChangeEvent[];
+};
+/**
+ * Create an H3 handler for the poll endpoint.
+ *
+ * GET /_agent-native/poll?since=N → { version, events[] }
+ */
+export declare function createPollHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    version: number;
+    events: ChangeEvent[];
+}>>;
+//# sourceMappingURL=poll.d.ts.map

package/dist/server/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../../src/server/poll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAaD,8CAA8C;AAC9C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,GAAG,IAAI,CAOP;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAMA;AA2CD;;;;GAIG;AACH,wBAAgB,iBAAiB;aAxDtB,MAAM;YACP,WAAW,EAAE;IAgEtB"}

package/dist/server/poll.js

@@ -0,0 +1,96 @@
+/**
+ * Polling-based change notification.
+ *
+ * Replaces SSE with a simple version counter. Each DB mutation (app-state,
+ * settings, resources) increments the version. Clients poll `/_agent-native/poll?since=N`
+ * and receive any events that occurred after version N.
+ *
+ * Works in all deployment environments (serverless, edge, long-lived).
+ *
+ * Also detects cross-process DB writes by periodically checking the
+ * application_state and settings tables' updated_at timestamps. This ensures
+ * that changes made by external processes (e.g., CLI actions, cron jobs)
+ * are picked up even though they don't call recordChange() in this process.
+ */
+import { defineEventHandler, getQuery } from "h3";
+import { getDbExec } from "../db/client.js";
+// In-memory ring buffer of recent changes. Kept small since clients
+// poll frequently (every 2-3s) and only need events since their last poll.
+const MAX_BUFFER = 200;
+let _version = 0;
+const _buffer = [];
+/** Tracks the latest updated_at we've seen from the DB, per table. */
+let _lastDbCheck = 0;
+let _lastAppStateTs = 0;
+let _lastSettingsTs = 0;
+/** Get the current global version counter. */
+export function getVersion() {
+    return _version;
+}
+/** Record a change event. Called by emitter listeners. */
+export function recordChange(event) {
+    _version++;
+    const entry = { ...event, version: _version };
+    _buffer.push(entry);
+    if (_buffer.length > MAX_BUFFER) {
+        _buffer.splice(0, _buffer.length - MAX_BUFFER);
+    }
+}
+/** Get all changes after a given version. */
+export function getChangesSince(since) {
+    if (since >= _version) {
+        return { version: _version, events: [] };
+    }
+    const events = _buffer.filter((e) => e.version > since);
+    return { version: _version, events };
+}
+/**
+ * Check for cross-process DB writes by comparing updated_at timestamps.
+ * Runs at most once per second to avoid excessive queries.
+ */
+async function checkExternalDbChanges() {
+    const now = Date.now();
+    if (now - _lastDbCheck < 1000)
+        return;
+    _lastDbCheck = now;
+    try {
+        const db = getDbExec();
+        // Check application_state for external writes
+        const appResult = await db.execute("SELECT MAX(updated_at) as max_ts FROM application_state");
+        const appTs = Number(appResult.rows[0]?.max_ts) || 0;
+        if (appTs > _lastAppStateTs) {
+            if (_lastAppStateTs > 0) {
+                // There was an external write — emit a generic app-state change event
+                recordChange({ source: "app-state", type: "change", key: "*" });
+            }
+            _lastAppStateTs = appTs;
+        }
+        // Check settings for external writes
+        const settingsResult = await db.execute("SELECT MAX(updated_at) as max_ts FROM settings");
+        const settingsTs = Number(settingsResult.rows[0]?.max_ts) || 0;
+        if (settingsTs > _lastSettingsTs) {
+            if (_lastSettingsTs > 0) {
+                recordChange({ source: "settings", type: "change", key: "*" });
+            }
+            _lastSettingsTs = settingsTs;
+        }
+    }
+    catch {
+        // Tables may not exist yet — ignore
+    }
+}
+/**
+ * Create an H3 handler for the poll endpoint.
+ *
+ * GET /_agent-native/poll?since=N → { version, events[] }
+ */
+export function createPollHandler() {
+    return defineEventHandler(async (event) => {
+        // Check for cross-process writes before responding
+        await checkExternalDbChanges();
+        const query = getQuery(event);
+        const since = parseInt(String(query.since ?? "0"), 10) || 0;
+        return getChangesSince(since);
+    });
+}
+//# sourceMappingURL=poll.js.map

package/dist/server/poll.js.map

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

package/dist/server/resources-plugin.d.ts

@@ -0,0 +1,27 @@
+type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
+/**
+ * Creates a Nitro plugin that mounts all resource CRUD routes.
+ *
+ * Routes:
+ *   GET    /_agent-native/resources          — list resources
+ *   POST   /_agent-native/resources          — create resource
+ *   GET    /_agent-native/resources/tree     — get resource tree
+ *   POST   /_agent-native/resources/upload   — upload file
+ *   GET    /_agent-native/resources/:id      — get resource by ID
+ *   PUT    /_agent-native/resources/:id      — update resource
+ *   DELETE /_agent-native/resources/:id      — delete resource
+ */
+export declare function createResourcesPlugin(): NitroPluginDef;
+/**
+ * Default resources plugin — mount with no configuration needed.
+ *
+ * Usage in templates:
+ * ```ts
+ * // server/plugins/resources.ts
+ * import { defaultResourcesPlugin } from "@agent-native/core/server";
+ * export default defaultResourcesPlugin;
+ * ```
+ */
+export declare const defaultResourcesPlugin: NitroPluginDef;
+export {};
+//# sourceMappingURL=resources-plugin.d.ts.map

package/dist/server/resources-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-plugin.d.ts","sourceRoot":"","sources":["../../src/server/resources-plugin.ts"],"names":[],"mappings":"AAYA,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CA0DtD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAwC,CAAC"}

package/dist/server/resources-plugin.js

@@ -0,0 +1,75 @@
+import { getH3App } from "./framework-request-handler.js";
+import { defineEventHandler, setResponseStatus, getMethod } from "h3";
+import { handleListResources, handleGetResourceTree, handleGetResource, handleCreateResource, handleUpdateResource, handleDeleteResource, handleUploadResource, } from "../resources/handlers.js";
+/**
+ * Creates a Nitro plugin that mounts all resource CRUD routes.
+ *
+ * Routes:
+ *   GET    /_agent-native/resources          — list resources
+ *   POST   /_agent-native/resources          — create resource
+ *   GET    /_agent-native/resources/tree     — get resource tree
+ *   POST   /_agent-native/resources/upload   — upload file
+ *   GET    /_agent-native/resources/:id      — get resource by ID
+ *   PUT    /_agent-native/resources/:id      — update resource
+ *   DELETE /_agent-native/resources/:id      — delete resource
+ */
+export function createResourcesPlugin() {
+    return async (nitroApp) => {
+        // Mount specific sub-routes BEFORE the catch-all
+        getH3App(nitroApp).use("/_agent-native/resources/tree", defineEventHandler(async (event) => {
+            if (getMethod(event) !== "GET") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            return handleGetResourceTree(event);
+        }));
+        getH3App(nitroApp).use("/_agent-native/resources/upload", defineEventHandler(async (event) => {
+            if (getMethod(event) !== "POST") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            return handleUploadResource(event);
+        }));
+        // Catch-all for /_agent-native/resources and /_agent-native/resources/:id
+        getH3App(nitroApp).use("/_agent-native/resources", defineEventHandler(async (event) => {
+            const method = getMethod(event);
+            // h3 strips the mount prefix, so event.path is "/" or "/:id"
+            const raw = (event.path || "/").split("?")[0];
+            const subPath = raw.replace(/^\//, "");
+            // No sub-path: /_agent-native/resources — list or create
+            if (!subPath || subPath === "") {
+                if (method === "GET")
+                    return handleListResources(event);
+                if (method === "POST")
+                    return handleCreateResource(event);
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            // Already handled by dedicated routes above
+            if (subPath === "tree" || subPath === "upload")
+                return;
+            // /_agent-native/resources/:id — get, update, delete
+            event.context.params = { ...event.context.params, id: subPath };
+            if (method === "GET")
+                return handleGetResource(event);
+            if (method === "PUT")
+                return handleUpdateResource(event);
+            if (method === "DELETE")
+                return handleDeleteResource(event);
+            setResponseStatus(event, 405);
+            return { error: "Method not allowed" };
+        }));
+    };
+}
+/**
+ * Default resources plugin — mount with no configuration needed.
+ *
+ * Usage in templates:
+ * ```ts
+ * // server/plugins/resources.ts
+ * import { defaultResourcesPlugin } from "@agent-native/core/server";
+ * export default defaultResourcesPlugin;
+ * ```
+ */
+export const defaultResourcesPlugin = createResourcesPlugin();
+//# sourceMappingURL=resources-plugin.js.map

package/dist/server/resources-plugin.js.map

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

package/dist/server/schema-prompt.d.ts

@@ -0,0 +1,16 @@
+/** Manually drop the cache — useful from tests or after running a migration. */
+export declare function invalidateSchemaPromptCache(): void;
+/**
+ * Build the `<sql-database>` block appended to the system prompt on every turn.
+ *
+ * `owner` and `orgId` come from the per-request context (AGENT_USER_EMAIL /
+ * AGENT_ORG_ID) and are surfaced so the agent knows who it is acting on behalf
+ * of — and understands that rows are already filtered for that identity.
+ */
+export declare function loadSchemaPromptBlock(opts: {
+    owner?: string | null;
+    orgId?: string | null;
+    /** If true, mention db-query/db-exec/db-patch/db-schema as available tools. */
+    hasRawDbTools?: boolean;
+}): Promise<string>;
+//# sourceMappingURL=schema-prompt.d.ts.map

package/dist/server/schema-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-prompt.d.ts","sourceRoot":"","sources":["../../src/server/schema-prompt.ts"],"names":[],"mappings":"AAgMA,gFAAgF;AAChF,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA6CD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0HlB"}

package/dist/server/schema-prompt.js

@@ -0,0 +1,275 @@
+/**
+ * Auto-introspected SQL schema context block for the agent's system prompt.
+ *
+ * On every chat turn, the framework appends a compact, always-fresh summary
+ * of the app's SQL database — every table, every column, every foreign key —
+ * so the agent knows exactly what data model it's working with. The schema
+ * is pulled live from `information_schema` (Postgres) or `PRAGMA table_info`
+ * (SQLite), cached briefly to keep latency down but never hard-coded.
+ *
+ * The block also:
+ *   - points at the db-query / db-exec / db-patch / db-schema tools for runtime access
+ *   - lists Postgres column descriptions (`COMMENT ON COLUMN ...`) if present
+ *   - explains the current user/org data scoping so the agent doesn't re-filter
+ *     by hand (which would be redundant and easy to get wrong)
+ */
+import { getDbExec, getDatabaseUrl, isPostgres, } from "../db/client.js";
+// Short-lived in-memory cache — schema rarely changes between messages, but
+// we want new tables to show up within a few seconds during active dev.
+const CACHE_TTL_MS = 15_000;
+let _cache = null;
+function cacheKey() {
+    return (isPostgres() ? "pg:" : "lite:") + (getDatabaseUrl() || "");
+}
+// ─── Postgres introspection ─────────────────────────────────────────────────
+async function introspectPostgres(db) {
+    const tablesRes = await db.execute({
+        sql: `SELECT table_name AS name,
+                 obj_description((quote_ident(table_schema) || '.' || quote_ident(table_name))::regclass, 'pg_class') AS comment
+          FROM information_schema.tables
+          WHERE table_schema = 'public' AND table_type = 'BASE TABLE'
+          ORDER BY table_name`,
+        args: [],
+    });
+    const tables = [];
+    for (const t of tablesRes.rows) {
+        const name = t.name;
+        const colsRes = await db.execute({
+            sql: `SELECT c.column_name AS name,
+                   c.data_type AS type,
+                   CASE WHEN c.is_nullable = 'NO' THEN 1 ELSE 0 END AS notnull,
+                   col_description((quote_ident(c.table_schema) || '.' || quote_ident(c.table_name))::regclass, c.ordinal_position) AS comment
+            FROM information_schema.columns c
+            WHERE c.table_name = ? AND c.table_schema = 'public'
+            ORDER BY c.ordinal_position`,
+            args: [name],
+        });
+        const pksRes = await db.execute({
+            sql: `SELECT kcu.column_name AS name
+            FROM information_schema.table_constraints tc
+            JOIN information_schema.key_column_usage kcu
+              ON tc.constraint_name = kcu.constraint_name
+             AND tc.table_schema = kcu.table_schema
+            WHERE tc.table_name = ? AND tc.constraint_type = 'PRIMARY KEY'`,
+            args: [name],
+        });
+        const pkSet = new Set(pksRes.rows.map((r) => r.name));
+        const fksRes = await db.execute({
+            sql: `SELECT kcu.column_name AS col_from,
+                   ccu.table_name  AS ref_table,
+                   ccu.column_name AS ref_col
+            FROM information_schema.table_constraints tc
+            JOIN information_schema.key_column_usage kcu
+              ON tc.constraint_name = kcu.constraint_name
+            JOIN information_schema.constraint_column_usage ccu
+              ON tc.constraint_name = ccu.constraint_name
+            WHERE tc.table_name = ? AND tc.constraint_type = 'FOREIGN KEY'`,
+            args: [name],
+        });
+        tables.push({
+            name,
+            comment: t.comment ?? null,
+            columns: colsRes.rows.map((c) => ({
+                name: c.name,
+                type: c.type || "any",
+                notnull: Number(c.notnull) === 1,
+                pk: pkSet.has(c.name),
+                comment: c.comment ?? null,
+            })),
+            foreignKeys: fksRes.rows.map((f) => ({
+                from: f.col_from,
+                table: f.ref_table,
+                to: f.ref_col,
+            })),
+        });
+    }
+    return tables;
+}
+// ─── SQLite / libSQL / D1 introspection ────────────────────────────────────
+async function introspectSqlite(db) {
+    const tablesRes = await db.execute(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name`);
+    const tables = [];
+    for (const row of tablesRes.rows) {
+        const name = row.name;
+        if (!name)
+            continue;
+        // Quote the identifier for PRAGMA calls; SQLite requires doubling embedded quotes.
+        const escaped = name.replace(/"/g, '""');
+        const colsRes = await db.execute(`PRAGMA table_info("${escaped}")`);
+        const fksRes = await db.execute(`PRAGMA foreign_key_list("${escaped}")`);
+        tables.push({
+            name,
+            comment: null, // SQLite has no column/table comments
+            columns: colsRes.rows.map((c) => ({
+                name: c.name,
+                type: (c.type || "").toLowerCase() || "any",
+                notnull: Number(c.notnull) === 1,
+                pk: Number(c.pk) === 1,
+                comment: null,
+            })),
+            foreignKeys: fksRes.rows.map((f) => ({
+                from: f.from,
+                table: f.table,
+                to: f.to,
+            })),
+        });
+    }
+    return tables;
+}
+// ─── Cached entry point ─────────────────────────────────────────────────────
+async function getSchema() {
+    const key = cacheKey();
+    const now = Date.now();
+    if (_cache && _cache.key === key && _cache.expires > now) {
+        return { tables: _cache.tables, dialect: _cache.dialect };
+    }
+    const db = getDbExec();
+    const dialect = isPostgres() ? "postgres" : "sqlite";
+    const tables = dialect === "postgres"
+        ? await introspectPostgres(db)
+        : await introspectSqlite(db);
+    _cache = { key, expires: now + CACHE_TTL_MS, tables, dialect };
+    return { tables, dialect };
+}
+/** Manually drop the cache — useful from tests or after running a migration. */
+export function invalidateSchemaPromptCache() {
+    _cache = null;
+}
+// ─── Formatting ─────────────────────────────────────────────────────────────
+function shortType(type) {
+    // Trim verbose Postgres type names for compactness in the prompt.
+    const t = type.toLowerCase();
+    if (t === "character varying")
+        return "varchar";
+    if (t === "timestamp without time zone")
+        return "timestamp";
+    if (t === "timestamp with time zone")
+        return "timestamptz";
+    if (t === "double precision")
+        return "double";
+    return t;
+}
+function formatTable(table) {
+    const fkByCol = new Map();
+    for (const fk of table.foreignKeys) {
+        fkByCol.set(fk.from, `${fk.table}.${fk.to}`);
+    }
+    const cols = table.columns.map((c) => {
+        const flags = [];
+        if (c.pk)
+            flags.push("pk");
+        if (!c.notnull && !c.pk)
+            flags.push("null");
+        const fk = fkByCol.get(c.name);
+        if (fk)
+            flags.push(`→${fk}`);
+        // Flag scoping columns so the agent understands per-user/per-org filtering.
+        if (c.name === "owner_email")
+            flags.push("user-scope");
+        if (c.name === "org_id")
+            flags.push("org-scope");
+        const flagStr = flags.length ? ` [${flags.join(", ")}]` : "";
+        const commentStr = c.comment ? ` -- ${c.comment.replace(/\s+/g, " ")}` : "";
+        return `    ${c.name} ${shortType(c.type)}${flagStr}${commentStr}`;
+    });
+    const header = table.comment
+        ? `  ${table.name}  -- ${table.comment.replace(/\s+/g, " ")}`
+        : `  ${table.name}`;
+    return [header, ...cols].join("\n");
+}
+// ─── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Build the `<sql-database>` block appended to the system prompt on every turn.
+ *
+ * `owner` and `orgId` come from the per-request context (AGENT_USER_EMAIL /
+ * AGENT_ORG_ID) and are surfaced so the agent knows who it is acting on behalf
+ * of — and understands that rows are already filtered for that identity.
+ */
+export async function loadSchemaPromptBlock(opts) {
+    let tables;
+    let dialect;
+    try {
+        const res = await getSchema();
+        tables = res.tables;
+        dialect = res.dialect;
+    }
+    catch (err) {
+        // DB not ready, or introspection blew up — don't take the chat down.
+        return "";
+    }
+    if (tables.length === 0)
+        return "";
+    // Partition framework-internal tables from template tables so the agent
+    // focuses on the data model it's most likely to touch.
+    const CORE_TABLES = new Set([
+        "application_state",
+        "settings",
+        "oauth_tokens",
+        "sessions",
+        "resources",
+        "chat_threads",
+        "_collab_docs",
+        "usage_events",
+        "usage_totals",
+        "user",
+        "account",
+        "verification",
+        "organization",
+        "member",
+        "invitation",
+    ]);
+    const templateTables = tables.filter((t) => !CORE_TABLES.has(t.name));
+    const coreTables = tables.filter((t) => CORE_TABLES.has(t.name));
+    const lines = [];
+    lines.push("<sql-database>");
+    lines.push(`The app's state lives in a SQL database (${dialect}). The schema below is auto-introspected fresh each turn — treat it as authoritative.`);
+    lines.push("");
+    if (templateTables.length > 0) {
+        lines.push("## Template tables");
+        lines.push("");
+        for (const t of templateTables) {
+            lines.push(formatTable(t));
+            lines.push("");
+        }
+    }
+    if (coreTables.length > 0) {
+        lines.push("## Framework tables (auth, resources, chat threads, app-state, etc.) — usually read/written via dedicated tools, not raw SQL");
+        lines.push("");
+        for (const t of coreTables) {
+            lines.push(formatTable(t));
+            lines.push("");
+        }
+    }
+    // Tooling references.
+    if (opts.hasRawDbTools) {
+        lines.push("## SQL tools");
+        lines.push("- `db-schema` — refresh the full schema with indexes and foreign keys");
+        lines.push("- `db-query` — run a SELECT (read-only; results already filtered to the current user/org)");
+        lines.push("- `db-exec` — run INSERT / UPDATE / DELETE (writes already scoped; owner_email and org_id are auto-injected on INSERT)");
+        lines.push("- `db-patch` — surgical search-and-replace on a large text column. Send `{find, replace}` pairs instead of the full new value. Use this for edits to large fields (documents, slide HTML, dashboard/form JSON) — it avoids re-sending multi-kilobyte strings and saves tokens. Targets exactly one row (narrow `--where` by primary key). Uses the same per-user/per-org scoping as db-exec.");
+        lines.push("");
+        lines.push("### When to pick which SQL tool");
+        lines.push("- Set a short column outright, update multiple columns, or do computed updates (`calories = calories + 50`) → `db-exec UPDATE`.");
+        lines.push("- Change a small slice of a large text/JSON column → `db-patch`. Much cheaper token-wise than re-sending the whole column.");
+        lines.push("- A template-specific action exists for the table (`edit-document`, `update-slide`, etc.) → use that action. It encodes business rules and pushes live Yjs updates to any open collaborative editor; raw SQL does neither.");
+        lines.push("- Read data → `db-query`. Never re-add `WHERE owner_email = ...` — scoping already applies it.");
+        lines.push("");
+    }
+    else {
+        lines.push("SQL is accessed through the template actions listed above. The schema is shown for context — so you understand the data model those actions operate on.");
+        lines.push("");
+    }
+    // Data scoping context.
+    const ownerLine = opts.owner ? opts.owner : "(unresolved)";
+    const orgLine = opts.orgId ? opts.orgId : "(none)";
+    lines.push("## Data scoping (enforced at the SQL layer)");
+    lines.push(`- Current user: \`${ownerLine}\``);
+    lines.push(`- Current org:  \`${orgLine}\``);
+    lines.push("- Tables with an `owner_email` column are automatically filtered to the current user via temporary views before every query.");
+    lines.push("- Tables with an `org_id` column are automatically filtered to the current org as well.");
+    lines.push("- On INSERT, `owner_email` and `org_id` are auto-injected — do NOT set them manually.");
+    lines.push("- Do NOT add `WHERE owner_email = ...` or `WHERE org_id = ...` to your queries — the filter is already applied, and re-adding it will confuse the scoped view.");
+    lines.push("</sql-database>");
+    return "\n\n" + lines.join("\n");
+}
+//# sourceMappingURL=schema-prompt.js.map

package/dist/server/schema-prompt.js.map

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

package/dist/server/script-discovery.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Use `action-discovery.ts` / `autoDiscoverActions` instead.
+ * This file is kept for backwards compatibility.
+ */
+export { autoDiscoverActions as autoDiscoverScripts, autoDiscoverActions, } from "./action-discovery.js";
+//# sourceMappingURL=script-discovery.d.ts.map

package/dist/server/script-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-discovery.d.ts","sourceRoot":"","sources":["../../src/server/script-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,IAAI,mBAAmB,EAC1C,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/server/script-discovery.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Use `action-discovery.ts` / `autoDiscoverActions` instead.
+ * This file is kept for backwards compatibility.
+ */
+export { autoDiscoverActions as autoDiscoverScripts, autoDiscoverActions, } from "./action-discovery.js";
+//# sourceMappingURL=script-discovery.js.map

package/dist/server/script-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-discovery.js","sourceRoot":"","sources":["../../src/server/script-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,IAAI,mBAAmB,EAC1C,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/server/sse.d.ts

@@ -1,16 +1,3 @@
-import { type FSWatcher } from "chokidar";
-export type { FSWatcher } from "chokidar";
-export interface FileWatcherOptions {
-    /** Glob patterns or regex to ignore. */
-    ignored?: string | RegExp | string[];
-    /** Whether to emit events for the initial file scan. Default: false (ignoreInitial: true) */
-    emitInitial?: boolean;
-}
-/**
- * Create a chokidar file watcher for the given directory.
- * Returns a chokidar.FSWatcher that emits "all" events on file changes.
- */
-export declare function createFileWatcher(dir: string | string[], options?: FileWatcherOptions): FSWatcher;
 /** Any object with on/off methods (compatible with EventEmitter, TypedEventEmitter, etc.). */
 interface EventLike {
     on(event: string, listener: (...args: any[]) => void): any;
@@ -22,19 +9,15 @@ export interface SSEHandlerOptions {
         emitter: EventLike;
         event: string;
     }>;
-    /** Optional file watcher for streaming file change events (e.g. code modifications). */
-    watcher?: FSWatcher;
-    /** Content root for computing relative paths. If provided, absolute paths are stripped. */
-    contentRoot?: string;
 }
 /**
  * Create an H3 event handler that streams Server-Sent Events.
  *
- * Streams events from DB change emitters (application state, settings)
- * and optionally from a file watcher.
+ * Streams events from DB change emitters (application state, settings).
  *
  * Usage:
- *   router.get("/api/events", createSSEHandler({ extraEmitters }));
+ *   router.get("/_agent-native/events", createSSEHandler({ extraEmitters }));
  */
-export declare function createSSEHandler(options?: SSEHandlerOptions): import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+export declare function createSSEHandler(options?: SSEHandlerOptions): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<BodyInit>>;
+export {};
 //# sourceMappingURL=sse.d.ts.map