@agent-native/core 0.7.7 → 0.7.11

package/dist/templates/default/.agents/skills/notifications/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: notifications
+description: >-
+  In-app notifications primitive with pluggable server-side channels. Use when
+  the agent needs to surface progress, alerts, or completions to the user —
+  both in-app (bell + toast) and out-of-band (webhook, Slack, custom).
+---
+
+# Notifications
+
+`notify()` is the framework's "tell the user something" primitive. Every call persists a row to the inbox (drives the bell UI) and fans out to any registered server-side channels. Channels follow the same pluggable-provider pattern as `tracking` — register at startup, `notify()` fans out, errors are isolated.
+
+Use for: *agent progress milestones, automation triggers firing, background job completions, critical errors*. Don't use for chat replies — those go through the conversation.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `notify` | Send a notification (severity + title + optional body/metadata/channels) |
+| `list-notifications` | Show recent notifications for the current user |
+
+## Sending
+
+```
+notify --severity info --title "Booking confirmed" --body "Jane at 3pm"
+```
+
+| Severity | When |
+|---|---|
+| `info` | FYI / progress / confirmation |
+| `warning` | Something to look at soon |
+| `critical` | Needs immediate attention |
+
+Optional: `--metadataJson '{"threadId":"abc"}'`, `--channels inbox,webhook` (omit to run all registered).
+
+## Delivery
+
+`notify()` always inserts into the `notifications` table (unless `channels` explicitly excludes `inbox`), then fans out to every registered channel in parallel (best-effort; a failing channel doesn't block others). Finally it emits `notification.sent` on the event bus so automations can chain — e.g. *"when a critical notification fires, also page on-call."*
+
+## Built-in Channels
+
+| Channel | How | Requires |
+|---|---|---|
+| `inbox` | INSERT → drives bell UI | (always on) |
+| `webhook` | POST JSON to `NOTIFICATIONS_WEBHOOK_URL` (+ optional `NOTIFICATIONS_WEBHOOK_AUTH`); both support `${keys.NAME}` + URL allowlists from the ad-hoc-keys system | env var set |
+
+The webhook channel resolves `${keys.NAME}` server-side — the raw value never enters the agent context.
+
+## Registering a Custom Channel
+
+```ts
+// server/plugins/notifications-slack.ts
+import { registerNotificationChannel } from "@agent-native/core/notifications";
+
+export default () => {
+  registerNotificationChannel({
+    name: "slack-ops",
+    async deliver(input, meta) {
+      await fetch(process.env.OPS_SLACK_WEBHOOK!, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ text: `*${input.severity}* — ${input.title}`, owner: meta.owner }),
+      });
+    },
+  });
+};
+```
+
+Names are unique — re-registering replaces. `deliver()` must be best-effort; a thrown error is logged and ignored. Do NOT call `notify()` from inside a channel (recursion).
+
+## HTTP API
+
+Mounted at `/_agent-native/notifications/*` by `core-routes-plugin`, all session-scoped:
+
+- `GET    /notifications?unread=true&limit=50&before=<iso>`
+- `GET    /notifications/count`
+- `POST   /notifications/:id/read`
+- `POST   /notifications/read-all`
+- `DELETE /notifications/:id`
+
+## UI
+
+```tsx
+import { NotificationsBell } from "@agent-native/core/client/notifications";
+
+<NotificationsBell browserNotifications />
+```
+
+Bell icon + unread badge + lazy-loaded dropdown. Pass `browserNotifications` to also fire system `new Notification(...)` popups for items that arrive after mount (dedups by id, renders an "Enable" prompt until permission is granted, silently no-ops on denied / unsupported). Styled with shadcn tokens — adapts to the host theme.
+
+## Related
+
+- `automations` — event-triggered bodies can call `notify`.
+- `secrets` — `${keys.NAME}` substitution + URL allowlists powering the webhook channel.
+- `tracking` — analytics; separate concern, don't route through notifications.

package/dist/templates/default/.agents/skills/progress/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: progress
+description: >-
+  Report live progress from long-running agent tasks. Use when a task takes
+  more than a few seconds, so the user can watch status in the runs tray
+  instead of staring at a spinner.
+---
+
+# Progress
+
+## Overview
+
+`progress_runs` is the framework's "what is the agent doing right now" primitive. The agent starts a run at the top of a long task, updates it as work proceeds, and completes it with a terminal status. The UI renders active runs in a header-bar widget with a percent bar, current step, and spinner/check/X — live visibility into work that would otherwise be opaque.
+
+Separate concern from `notifications`:
+
+| | Notifications | Progress |
+|---|---|---|
+| Shape | One-shot event — "X happened" | Continuous state — "X is 45% done" |
+| UI surface | Bell + toast | Runs tray with percent bar |
+| Lifecycle | Dismissable (read/unread) | Running → terminal (succeeded/failed/cancelled) |
+
+Common pattern: on completion, emit a `notify()` so the user sees the outcome when they're not actively watching the tray.
+
+## Available Tools
+
+| Tool | Purpose |
+|---|---|
+| `start-run` | Mark the start of a long task. Returns a runId. |
+| `update-run-progress` | Update percent and/or current step. Call frequently. |
+| `complete-run` | Mark terminal status: `succeeded`, `failed`, `cancelled`. |
+| `list-runs` | List recent runs (all or `--active=true`). |
+
+## Canonical Flow
+
+```
+start-run --title "Triage 128 unread emails" --step "Fetching inbox"
+  → runId=abc
+
+update-run-progress --runId=abc --percent=25 --step="Classifying 32/128"
+update-run-progress --runId=abc --percent=75 --step="Drafting replies 97/128"
+
+complete-run --runId=abc --status=succeeded
+notify --severity=info --title="Triage done" --body="12 archived, 6 drafts ready to review"
+```
+
+## Best Practices
+
+- **Start a run for anything > ~5 seconds.** Users want feedback; a spinner with no context feels frozen.
+- **Update at natural checkpoints**, not every iteration. Every 5–10% is enough for most UIs.
+- **Always call `complete-run`** at the end — including the error path. An orphaned `running` row is worse than no row.
+- **Pair with `notify`** on completion. The tray tells users what's *running*; notifications tell them what *finished*.
+- **Use `metadataJson`** on `start-run` to pass a link back to the produced artifact (thread id, document path), so the UI can deep-link from the runs tray.
+
+## Runs API
+
+Mounted at `/_agent-native/runs/*` by `core-routes-plugin`. **Read-only** over HTTP — writes flow through the agent tools:
+
+| Method | Route |
+|---|---|
+| `GET`    | `/_agent-native/runs?active=true&limit=50` |
+| `GET`    | `/_agent-native/runs/:id` |
+| `DELETE` | `/_agent-native/runs/:id` |
+
+## UI Surface
+
+Ships as `<RunsTray />` at `@agent-native/core/client/progress`:
+
+```tsx
+import { RunsTray } from "@agent-native/core/client/progress";
+
+export function HeaderBar() {
+  return (
+    <header className="flex items-center gap-2">
+      {/* … */}
+      <RunsTray />
+    </header>
+  );
+}
+```
+
+Inline header widget — mount next to the notifications bell. Shows a spinner icon + count badge when runs are active; click opens a dropdown with a live percent bar per run. Hides the trigger entirely when no active runs. Polls `active=true` every `pollMs` (default 3s).
+
+## Event Bus Integration
+
+Two events emit on the bus so automations can react:
+
+- `run.progress.started` — `{ runId, title, step? }`
+- `run.progress.updated` — `{ runId, percent, step, status }`
+
+Example automation: *"when a run takes longer than 5 minutes, notify me."*
+
+## Related Skills
+
+- `notifications` — fire one when a run finishes so the user sees the outcome.
+- `automations` — subscribe to `run.progress.updated` to build watchdogs on slow runs.
+- `delegate-to-agent` — if you're delegating a long task, start a run on the delegator side so the caller has visibility.

package/dist/templates/default/AGENTS.md

@@ -84,16 +84,18 @@ You do NOT get auto-injected screen state. **Call `pnpm action view-screen` at t
 
 Skills in `.agents/skills/` provide detailed guidance for each architectural rule. Read them before making changes.
 
-| Skill                 | When to read                                                   |
-| --------------------- | -------------------------------------------------------------- |
-| `storing-data`        | Before storing or reading any app state                        |
-| `delegate-to-agent`   | Before adding LLM calls or AI delegation                       |
-| `actions`             | Before creating or modifying actions                           |
-| `real-time-sync`      | Before wiring up real-time UI sync                             |
-| `self-modifying-code` | Before editing source, components, or styles                   |
-| `capture-learnings`   | Before recording user preferences or corrections               |
-| `frontend-design`     | Before building or restyling any UI component, page, or layout |
-| `agent-engines`       | Before switching LLM providers or registering a custom engine  |
+| Skill                 | When to read                                                    |
+| --------------------- | --------------------------------------------------------------- |
+| `storing-data`        | Before storing or reading any app state                         |
+| `delegate-to-agent`   | Before adding LLM calls or AI delegation                        |
+| `actions`             | Before creating or modifying actions                            |
+| `real-time-sync`      | Before wiring up real-time UI sync                              |
+| `self-modifying-code` | Before editing source, components, or styles                    |
+| `capture-learnings`   | Before recording user preferences or corrections                |
+| `frontend-design`     | Before building or restyling any UI component, page, or layout  |
+| `agent-engines`       | Before switching LLM providers or registering a custom engine   |
+| `notifications`       | Before surfacing alerts/progress to the user or adding channels |
+| `progress`            | Before running any task that takes more than a few seconds      |
 
 ## When Adding Features
 

package/dist/templates/default/package.json

@@ -22,23 +22,23 @@
     "@react-router/dev": "^7.13.1",
     "@react-router/fs-routes": "^7.13.1",
     "@tailwindcss/vite": "^4.1.18",
-    "@tanstack/react-query": "^5.84.2",
+    "@tanstack/react-query": "^5.99.2",
     "@types/node": "^24.2.1",
-    "@types/react": "^18.3.23",
-    "@types/react-dom": "^18.3.7",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.539.0",
+    "lucide-react": "^1.8.0",
     "next-themes": "^0.4.6",
     "prettier": "^3.6.2",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "react-router": "^7.13.1",
-    "sonner": "^1.7.4",
-    "tailwind-merge": "^2.6.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.20.3",
-    "typescript": "^5.9.2",
-    "vite": "^7.1.2"
+    "typescript": "^6.0.3",
+    "vite": "^8.0.0"
   }
 }

package/dist/templates/workspace-core/package.json

@@ -23,14 +23,14 @@
     "./styles/tokens.css": "./styles/tokens.css"
   },
   "dependencies": {
-    "@agent-native/core": "^0.6.0"
+    "@agent-native/core": "^0.7.10"
   },
   "devDependencies": {
-    "@types/react": "^18.3.23",
-    "react": "^18.3.1",
-    "typescript": "^5.9.2"
+    "@types/react": "^19.2.14",
+    "react": "^19.2.5",
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "react": "^18.3.1"
+    "react": "^19.2.5"
   }
 }

package/dist/templates/workspace-root/package.json

@@ -12,7 +12,7 @@
   },
   "devDependencies": {
     "prettier": "^3.6.2",
-    "typescript": "^5.9.2"
+    "typescript": "^6.0.3"
   },
   "packageManager": "pnpm@10.14.0"
 }

package/dist/templates/workspace-root/tsconfig.base.json

@@ -15,7 +15,6 @@
     "skipLibCheck": true,
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true
+    "allowSyntheticDefaultImports": true
   }
 }

package/dist/tools/fetch-tool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fetch tool — outbound HTTP for automations and agent use.
+ *
+ * Supports ${keys.NAME} reference substitution in URL, headers, and body.
+ * Values are resolved server-side AFTER the model emits the tool call —
+ * the raw secret never enters the model's context.
+ */
+import type { ActionEntry } from "../agent/production-agent.js";
+export interface FetchToolOptions {
+    /** Resolve ${keys.NAME} references. Injected by the plugin at setup time. */
+    resolveKeys?: (text: string) => Promise<{
+        resolved: string;
+        usedKeys: string[];
+    }>;
+    /** Validate URL against per-key allowlists. */
+    validateUrl?: (url: string, usedKeys: string[]) => Promise<boolean>;
+}
+/**
+ * Create the fetch tool entry for the agent tool registry.
+ */
+export declare function createFetchToolEntry(opts?: FetchToolOptions): Record<string, ActionEntry>;
+//# sourceMappingURL=fetch-tool.d.ts.map

package/dist/tools/fetch-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-tool.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAKhE,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,+CAA+C;IAC/C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,GAAE,gBAAqB,GAC1B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAiK7B"}

package/dist/tools/fetch-tool.js

@@ -0,0 +1,156 @@
+/**
+ * Fetch tool — outbound HTTP for automations and agent use.
+ *
+ * Supports ${keys.NAME} reference substitution in URL, headers, and body.
+ * Values are resolved server-side AFTER the model emits the tool call —
+ * the raw secret never enters the model's context.
+ */
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_RESPONSE_SIZE = 1024 * 1024; // 1 MB
+/**
+ * Create the fetch tool entry for the agent tool registry.
+ */
+export function createFetchToolEntry(opts = {}) {
+    return {
+        "web-request": {
+            tool: {
+                description: `Make an outbound HTTP request. Use this to call external APIs, webhooks, and services. Supports \${keys.NAME} placeholders in url, headers, and body — these are resolved server-side from the user's saved keys (the raw value never enters your context). Example: \${keys.SLACK_WEBHOOK} in the url field.`,
+                parameters: {
+                    type: "object",
+                    properties: {
+                        url: {
+                            type: "string",
+                            description: 'Full URL. May contain ${keys.NAME} references, e.g. "${keys.SLACK_WEBHOOK}".',
+                        },
+                        method: {
+                            type: "string",
+                            description: "HTTP method. Default: GET.",
+                            enum: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"],
+                        },
+                        headers: {
+                            type: "string",
+                            description: 'JSON object of headers. May contain ${keys.NAME} references. Example: \'{"Authorization": "Bearer ${keys.API_TOKEN}"}\'.',
+                        },
+                        body: {
+                            type: "string",
+                            description: "Request body (for POST/PUT/PATCH). May contain ${keys.NAME} references.",
+                        },
+                        timeout_ms: {
+                            type: "number",
+                            description: `Timeout in milliseconds. Default: ${DEFAULT_TIMEOUT_MS}. Max: 30000.`,
+                        },
+                    },
+                    required: ["url"],
+                },
+            },
+            run: async (args) => {
+                const startTime = Date.now();
+                const rawUrl = args.url;
+                const method = (args.method || "GET").toUpperCase();
+                const rawHeaders = args.headers || "{}";
+                const rawBody = args.body;
+                const timeoutMs = Math.min(Number(args.timeout_ms) || DEFAULT_TIMEOUT_MS, 30_000);
+                // Resolve key references
+                let resolvedUrl = rawUrl;
+                let resolvedHeaders = rawHeaders;
+                let resolvedBody = rawBody;
+                const allUsedKeys = [];
+                if (opts.resolveKeys) {
+                    try {
+                        const urlResult = await opts.resolveKeys(rawUrl);
+                        resolvedUrl = urlResult.resolved;
+                        allUsedKeys.push(...urlResult.usedKeys);
+                        const headerResult = await opts.resolveKeys(rawHeaders);
+                        resolvedHeaders = headerResult.resolved;
+                        allUsedKeys.push(...headerResult.usedKeys);
+                        if (rawBody) {
+                            const bodyResult = await opts.resolveKeys(rawBody);
+                            resolvedBody = bodyResult.resolved;
+                            allUsedKeys.push(...bodyResult.usedKeys);
+                        }
+                    }
+                    catch (err) {
+                        return `Error resolving key references: ${err?.message ?? err}`;
+                    }
+                }
+                // Validate URL against per-key allowlists
+                if (opts.validateUrl && allUsedKeys.length > 0) {
+                    try {
+                        const allowed = await opts.validateUrl(resolvedUrl, allUsedKeys);
+                        if (!allowed) {
+                            return `URL "${rawUrl}" is not in the allowlist for the referenced keys. Check your key settings.`;
+                        }
+                    }
+                    catch (err) {
+                        return `URL validation error: ${err?.message ?? err}`;
+                    }
+                }
+                // Parse headers
+                let headers;
+                try {
+                    headers = JSON.parse(resolvedHeaders);
+                }
+                catch {
+                    return `Invalid headers JSON: ${rawHeaders}`;
+                }
+                // Make the request
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), timeoutMs);
+                try {
+                    const fetchOpts = {
+                        method,
+                        headers,
+                        signal: controller.signal,
+                    };
+                    if (resolvedBody && ["POST", "PUT", "PATCH"].includes(method)) {
+                        fetchOpts.body = resolvedBody;
+                        if (!headers["content-type"] && !headers["Content-Type"]) {
+                            headers["Content-Type"] = "application/json";
+                        }
+                    }
+                    const response = await fetch(resolvedUrl, fetchOpts);
+                    const elapsed = Date.now() - startTime;
+                    // Read response with size limit
+                    const contentLength = response.headers.get("content-length");
+                    if (contentLength && Number(contentLength) > MAX_RESPONSE_SIZE) {
+                        return `Response too large (${contentLength} bytes, max ${MAX_RESPONSE_SIZE}). Status: ${response.status}.`;
+                    }
+                    let body;
+                    try {
+                        const buffer = await response.arrayBuffer();
+                        if (buffer.byteLength > MAX_RESPONSE_SIZE) {
+                            body = `(response truncated — ${buffer.byteLength} bytes, max ${MAX_RESPONSE_SIZE})`;
+                        }
+                        else {
+                            body = new TextDecoder().decode(buffer);
+                        }
+                    }
+                    catch {
+                        body = "(could not read response body)";
+                    }
+                    // Truncate very long responses for the agent
+                    if (body.length > 8000) {
+                        body = body.slice(0, 8000) + "\n... (truncated)";
+                    }
+                    // Audit log
+                    console.log(`[fetch-tool] ${method} ${rawUrl} → ${response.status} (${elapsed}ms, keys: ${allUsedKeys.join(",") || "none"})`);
+                    return `HTTP ${response.status} ${response.statusText}\n\n${body}`;
+                }
+                catch (err) {
+                    const elapsed = Date.now() - startTime;
+                    if (err?.name === "AbortError") {
+                        console.log(`[fetch-tool] ${method} ${rawUrl} → TIMEOUT (${elapsed}ms)`);
+                        return `Request timed out after ${timeoutMs}ms.`;
+                    }
+                    console.log(`[fetch-tool] ${method} ${rawUrl} → ERROR: ${err?.message} (${elapsed}ms)`);
+                    return `Request failed: ${err?.message ?? err}`;
+                }
+                finally {
+                    clearTimeout(timeout);
+                }
+            },
+            readOnly: true,
+        },
+    };
+}
+//# sourceMappingURL=fetch-tool.js.map

package/dist/tools/fetch-tool.js.map

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

package/dist/tracking/index.d.ts

@@ -0,0 +1,4 @@
+export { track, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, } from "./registry.js";
+export { registerBuiltinProviders } from "./providers.js";
+export type { TrackingProvider, TrackingEvent } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tracking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/tracking/index.js

@@ -0,0 +1,3 @@
+export { track, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, } from "./registry.js";
+export { registerBuiltinProviders } from "./providers.js";
+//# sourceMappingURL=index.js.map

package/dist/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tracking/providers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in tracking providers that auto-register from env vars.
+ *
+ * No SDK dependencies — uses raw HTTP to keep core lightweight.
+ * Set the env var and tracking starts automatically.
+ *
+ * POSTHOG_API_KEY + POSTHOG_HOST  → PostHog
+ * MIXPANEL_TOKEN                  → Mixpanel
+ * AMPLITUDE_API_KEY               → Amplitude
+ *
+ * Call `registerBuiltinProviders()` at server startup (done
+ * automatically by the core-routes plugin).
+ */
+export declare function registerBuiltinProviders(): void;
+//# sourceMappingURL=providers.d.ts.map

package/dist/tracking/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/tracking/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6MH,wBAAgB,wBAAwB,IAAI,IAAI,CA6B/C"}