@agent-native/core 0.4.5 → 0.6.1

package/dist/server/action-routes.js

@@ -0,0 +1,105 @@
+/**
+ * Auto-mount actions as HTTP endpoints under /_agent-native/actions/:name.
+ *
+ * Actions are exposed as POST by default. Use `http: { method: "GET" }` in
+ * defineAction to expose as GET. Use `http: false` to mark as agent-only.
+ */
+import { getH3App } from "./framework-request-handler.js";
+import { defineEventHandler, setResponseStatus, getMethod, getQuery } from "h3";
+import { readBody } from "../server/h3-helpers.js";
+const ROUTE_PREFIX = "/_agent-native/actions";
+/**
+ * Mount discovered actions as HTTP endpoints.
+ *
+ * Only actions from `autoDiscoverActions` (template actions) are mounted.
+ * Built-in actions (resource-*, chat-*, shell, etc.) are NOT passed here.
+ */
+export function mountActionRoutes(nitroApp, actions, options) {
+    const mounted = [];
+    for (const [name, entry] of Object.entries(actions)) {
+        // Skip agent-only actions
+        if (entry.http === false)
+            continue;
+        const method = entry.http?.method ?? "POST";
+        const path = entry.http?.path ?? name;
+        const routePath = `${ROUTE_PREFIX}/${path}`;
+        getH3App(nitroApp).use(routePath, defineEventHandler(async (event) => {
+            const reqMethod = getMethod(event);
+            // Allow the declared method
+            if (reqMethod !== method) {
+                setResponseStatus(event, 405);
+                return { error: `Method not allowed. Use ${method}.` };
+            }
+            // Set auth context (same pattern as agent-chat-plugin)
+            if (options?.getOwnerFromEvent) {
+                const owner = await options.getOwnerFromEvent(event);
+                process.env.AGENT_USER_EMAIL = owner;
+            }
+            if (options?.resolveOrgId) {
+                const orgId = await options.resolveOrgId(event);
+                if (orgId) {
+                    process.env.AGENT_ORG_ID = orgId;
+                }
+                else {
+                    delete process.env.AGENT_ORG_ID;
+                }
+            }
+            // Parse params based on method. On web-standard runtimes (Netlify
+            // Functions, CF Workers), event.req IS the web Request — use .json()
+            // directly. H3's readBody fails on those runtimes because it expects
+            // a Node.js stream on event.node.req.
+            let params;
+            try {
+                if (method === "GET") {
+                    // H3 v2: prefer web Request URL, fallback to getQuery
+                    const webReq = event.req;
+                    if (webReq?.url) {
+                        const url = new URL(webReq.url);
+                        params = Object.fromEntries(url.searchParams);
+                    }
+                    else {
+                        params = getQuery(event);
+                    }
+                }
+                else {
+                    const webReq = event.req;
+                    if (webReq && typeof webReq.json === "function") {
+                        // H3 v2: event.req is the web Request — use .json() directly
+                        params = (await webReq.json().catch(() => null)) ?? {};
+                    }
+                    else {
+                        // Fallback: H3's readBody (Node.js dev)
+                        params = (await readBody(event)) ?? {};
+                    }
+                }
+            }
+            catch {
+                params = {};
+            }
+            // Run the action
+            try {
+                const result = await entry.run(params);
+                // If the action returned a string, try to parse as JSON for a clean response
+                if (typeof result === "string") {
+                    try {
+                        return JSON.parse(result);
+                    }
+                    catch {
+                        return result;
+                    }
+                }
+                return result;
+            }
+            catch (err) {
+                const msg = err?.message ?? String(err);
+                // Return 400 for validation errors, 500 for everything else
+                setResponseStatus(event, msg.startsWith("Invalid action parameters:") ? 400 : 500);
+                return { error: msg };
+            }
+        }));
+        mounted.push(`${method} ${routePath}`);
+    }
+    if (mounted.length > 0 && process.env.DEBUG)
+        console.log(`[action-routes] Mounted ${mounted.length} action route(s): ${mounted.join(", ")}`);
+}
+//# sourceMappingURL=action-routes.js.map

package/dist/server/action-routes.js.map

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

package/dist/server/agent-chat-plugin.d.ts

@@ -1,8 +1,11 @@
-import { type ScriptEntry } from "../agent/production-agent.js";
+import { type ActionEntry } from "../agent/production-agent.js";
+import type { MentionProvider } from "../agent/types.js";
 type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
 export interface AgentChatPluginOptions {
-    /** Template-specific scripts (email ops, booking ops, etc.) */
-    scripts?: Record<string, ScriptEntry> | (() => Record<string, ScriptEntry> | Promise<Record<string, ScriptEntry>>);
+    /** Template-specific actions (email ops, booking ops, etc.) */
+    actions?: Record<string, ActionEntry> | (() => Record<string, ActionEntry> | Promise<Record<string, ActionEntry>>);
+    /** @deprecated Use `actions` instead */
+    scripts?: Record<string, ActionEntry> | (() => Record<string, ActionEntry> | Promise<Record<string, ActionEntry>>);
     /** System prompt for the agent. A sensible default is provided. */
     systemPrompt?: string;
     /** Additional system prompt prepended in dev mode */
@@ -11,30 +14,36 @@ export interface AgentChatPluginOptions {
     model?: string;
     /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env var */
     apiKey?: string;
-    /** Route path. Default: /api/agent-chat */
+    /**
+     * Agent engine to use. Can be a pre-constructed AgentEngine, a registered
+     * engine name (e.g. "anthropic", "ai-sdk:openai"), or an object with name
+     * and config. Defaults to the "anthropic" engine using ANTHROPIC_API_KEY.
+     */
+    engine?: import("../agent/engine/types.js").AgentEngine | string | {
+        name: string;
+        config: Record<string, unknown>;
+    };
+    /** Route path. Default: /_agent-native/agent-chat */
     path?: string;
+    /** Custom mention providers for @-tagging template entities */
+    mentionProviders?: Record<string, MentionProvider> | (() => Record<string, MentionProvider> | Promise<Record<string, MentionProvider>>);
+    /** App ID used to exclude self from agent discovery (e.g., "mail", "calendar") */
+    appId?: string;
+    /**
+     * Optional callback to resolve the org ID for the current request.
+     * When provided, the resolved value is set as AGENT_ORG_ID env var so
+     * that db-query/db-exec automatically scope by org_id in addition to
+     * owner_email.
+     *
+     * If not provided, the framework automatically uses `session.orgId` from
+     * Better Auth's active organization. Only provide this callback when you
+     * need custom org resolution logic (e.g., Atlassian org mapping).
+     */
+    resolveOrgId?: (event: any) => string | null | Promise<string | null>;
 }
-/**
- * Creates a Nitro plugin that mounts the agent chat endpoint.
- *
- * In dev mode (NODE_ENV !== "production"), automatically includes
- * file system, shell, and database tools alongside any template-specific scripts.
- *
- * Usage in templates:
- * ```ts
- * // server/plugins/agent-chat.ts
- * import { createAgentChatPlugin } from "@agent-native/core/server";
- * import { scriptRegistry } from "../../scripts/registry.js";
- *
- * export default createAgentChatPlugin({
- *   scripts: scriptRegistry,
- *   systemPrompt: "You are an email assistant...",
- * });
- * ```
- */
 export declare function createAgentChatPlugin(options?: AgentChatPluginOptions): NitroPluginDef;
 /**
- * Default agent chat plugin with no template-specific scripts.
+ * Default agent chat plugin with no template-specific actions.
  * In dev mode, provides file system, shell, and database tools.
  * In production, provides only the default system prompt.
  */

package/dist/server/agent-chat-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-plugin.d.ts","sourceRoot":"","sources":["../../src/server/agent-chat-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAItC,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,CAAC,MACG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9C,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAiFhB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAwC,CAAC"}
+{"version":3,"file":"agent-chat-plugin.d.ts","sourceRoot":"","sources":["../../src/server/agent-chat-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAEV,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AA+gB3B,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,CAAC,MACG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9C,wCAAwC;IACxC,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,CAAC,MACG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9C,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EACH,OAAO,0BAA0B,EAAE,WAAW,GAC9C,MAAM,GACN;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtD,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,gBAAgB,CAAC,EACb,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAC/B,CAAC,MACG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAClD,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvE;AAubD,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CA25ChB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAwC,CAAC"}