@adonis-agora/agent 0.46.0 → 0.48.0

package/dist/src/types.d.ts

@@ -363,6 +363,12 @@ export interface ThreadSummary {
      * `model` runs on it. `null` → the provider's default. Undefined for a store that does not persist it.
      */
     model?: string | null;
+    /**
+     * The run streaming on this thread right now — the one a reloading client re-attaches to
+     * (`GET <path>/chat/:runId/stream`) — or `null` when none is. Set when a turn starts, cleared when
+     * it ends.
+     */
+    activeRunId?: string | null;
 }
 export interface StoredMessage {
     id: string;
@@ -443,9 +449,38 @@ export interface ToolCallApproval {
 }
 export interface ThreadDetail extends ThreadSummary {
     messages: StoredMessage[];
-    activeStreamId?: string;
 }
 export type ToolCallStatus = 'auto_executed' | 'pending_approval' | 'executed' | 'rejected' | 'failed'
 /** An approval request lapsed before anyone decided; the tool never ran. */
  | 'expired';
+/** The attachment rules in force — what the upload route enforces (`GET <path>/config`). */
+export interface AgentAttachmentConfig {
+    /** An upload store is configured, so uploads work at all. */
+    enabled: boolean;
+    /** How a client uploads (`null` when `enabled` is false). */
+    upload: 'multipart' | 'resumable' | null;
+    maxBytes: number;
+    allowedContentTypes: readonly string[];
+    /** How many attachments one message may name. */
+    maxPerMessage: number;
+}
+/**
+ * `GET <path>/config` — server facts a client would otherwise repeat (the shape of
+ * `@dudousxd/nestjs-agent`'s `AgentClientConfig`, which its React `useAgentConfig` reads).
+ */
+export interface AgentClientConfig {
+    attachments: AgentAttachmentConfig;
+    /** A model catalog is available, so `GET <path>/models` lists something to pick. */
+    models: {
+        enabled: boolean;
+    };
+    /** Sends are refused with `429` once `GET <path>/quota` reports `blocked`. */
+    quota: {
+        enforced: boolean;
+    };
+    /** No `actorResolver`: every browser is its own anonymous actor. */
+    identity: {
+        anonymous: boolean;
+    };
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/stubs/config/agent.stub

@@ -48,12 +48,9 @@ export default defineConfig({
   // dashboard: { enabled: true, path: '/agent/dashboard', authorize: (actor) => actor.roles?.includes('ADMIN') ?? false },
   // governanceAuthorize: (actor) => actor.roles?.includes('ADMIN') ?? false,
 
-  // Multimodal uploads — mounts POST /agent/attachments, which stages a file into a model-fetchable
-  // MessageAttachment the client sends back with its next chat message. Bind your own store (presign
-  // S3/GCS or wrap your media pipeline); \`attachmentStores.memory()\` inlines bytes as a data: URL.
-  // attachmentStaging: attachmentStores.memory(),
-  // attachmentMaxBytes: 20 * 1024 * 1024,
-  // attachmentAllowedContentTypes: ['image/png', 'image/jpeg', 'application/pdf'],
+  // Chat attachments — where uploads live (bring your own store, or @adonis-agora/media on any Drive
+  // disk). Mounts POST /agent/attachments; a send names uploads as { mediaId }, resolved server-side.
+  // attachments: attachmentStores.media(),
 
   // The implicit default agent (base prompt, personas, tool allow-list). Omit for a bare assistant.
   // defaultAgent: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -150,6 +150,11 @@
       "types": "./dist/src/genui/builtins.d.ts",
       "import": "./dist/src/genui/builtins.js",
       "default": "./dist/src/genui/builtins.js"
+    },
+    "./media": {
+      "types": "./dist/src/media/index.d.ts",
+      "import": "./dist/src/media/index.js",
+      "default": "./dist/src/media/index.js"
     }
   },
   "files": [
@@ -168,6 +173,7 @@
     "@adonis-agora/authz": ">=0.4.2 <1.0.0",
     "@adonis-agora/diagnostics": ">=0.1.0 <1.0.0",
     "@adonis-agora/durable": ">=0.8.0 <1.0.0",
+    "@adonis-agora/media": ">=0.18.0 <1.0.0",
     "@adonis-agora/telescope": ">=0.4.0 <1.0.0",
     "@adonisjs/assembler": "^8.4.0",
     "@adonisjs/core": "^7.3.0",
@@ -222,6 +228,9 @@
     },
     "@dudousxd/nestjs-agent-core": {
       "optional": true
+    },
+    "@adonis-agora/media": {
+      "optional": true
     }
   },
   "devDependencies": {

package/skills/agent-setup/SKILL.md

@@ -3,7 +3,7 @@ name: agent-setup
 description: >-
   Set up @adonis-agora/agent in an AdonisJS app: node ace configure @adonis-agora/agent,
   defineConfig in config/agent.ts (model via aiSdkModel from @adonis-agora/agent/ai-sdk,
-  stores.lucid()/stores.memory(), quotas.ledger/quotas.memory, pricingStores +
+  stores.lucid()/stores.memory(), quota: { limits }, pricingStores +
   seedModelPrices + estimateCost, tokenSinks.redis multi-replica SSE sink,
   AuthActorResolver identity seam), auto-created agent tables vs the published migration,
   the cost fold (null vs $0.00), and route mounting under config path. Use for "set up
@@ -90,24 +90,22 @@ Source: `packages/adonis/docs/getting-started.mdx`,
 
 ## Core patterns
 
-### Pattern 1 — enforce a daily spend budget with `quotas.ledger`
+### Pattern 1 — set a budget with `quota: { limits }`
 
-Quotas are **opt-in**: omitting `quota` disables budgeting entirely (fail-open).
-Configuring one makes the gate fail-closed — `check()` runs before the first model call
-and over-budget turns throw `QuotaExceededError` before any tokens are spent.
+Budgets are **opt-in**: omitting `quota` means usage is reported (`GET /agent/quota`) but
+never enforced. With limits, a send while a window is exhausted is refused with `429`
+`{ code: 'quota_exceeded', period }` before the turn starts — no tokens spent.
 
 ```ts
-import { defineConfig, quotas } from '@adonis-agora/agent'
-
 export default defineConfig({
   // ...
-  quota: quotas.ledger({ limitTokens: 1_000_000 }), // enforced off the persisted usage ledger
+  quota: { limits: { day: { tokens: 200_000 }, month: { usd: 20 } } },
 })
 ```
 
-`quotas.memory({ limitTokens })` is the single-process variant for tests. The `day`
-(`YYYY-MM-DD`, UTC) is stamped once by the runner, so day-bucketing stays deterministic
-under durable replay.
+Spend (`usd`) is the provider-reported cost the ledger recorded. A budget of your own is a
+`QuotaProvider` (`report({ actor })`) passed as `quota`. `quotas.ledger` / `quotas.memory`,
+`LedgerQuotaStore` and `GET /agent/quota/today` were removed in 0.46.
 
 Source: `packages/adonis/docs/governance/quota-and-cost.mdx`.
 
@@ -206,49 +204,21 @@ wrong for an app whose users log in.
 Source: `packages/adonis/src/anonymous-actor-resolver.ts`,
 `packages/adonis/docs/governance/authorization.mdx` ("No resolver: the endpoints are public").
 
-### MEDIUM — expecting quota enforcement after configuring only a store
-
-```ts
-// Wrong — no `quota` key means budgets are DISABLED (fail-open), even with a ledger full of usage.
-export default defineConfig({ model, store: 'lucid', stores: { lucid: stores.lucid() } })
-```
-
-```ts
-// Correct — opt in; the check then runs fail-closed before the first model call.
-export default defineConfig({
-  ...,
-  quota: quotas.ledger({ limitTokens: 500_000 }),
-})
-```
-
-Mechanism: the loop skips both `check` and `bump` entirely when `deps.quota` is
-undefined — there is no implicit limit.
-Source: `packages/adonis/docs/governance/quota-and-cost.mdx` ("Quota is opt-in, and off
-means open"), `packages/adonis/src/agent-loop.ts` (`if (deps.quota !== undefined)`).
-
-### HIGH — incrementing counters in a custom QuotaStore's `bump`
+### MEDIUM — shipping a public (anonymous) chat without a budget
 
 ```ts
-// Wrong — double-counts every turn when paired with the persisted usage ledger.
-const store: QuotaStore = {
-  async check(actorRef, day) { /* read my counter */ },
-  async bump(actorRef, day, tokens) { await redis.incrBy(key, tokens) },
-}
+// Wrong — no actorResolver (public) and no quota: model spend is unbounded.
+export default defineConfig({ model })
 ```
 
 ```ts
-// Correct — a ledger-backed store leaves bump empty: recordUsage already wrote the tokens.
-class LedgerQuota implements QuotaStore {
-  async check(actorRef: string, day: string) { /* sum agent_token_usage */ }
-  async bump(): Promise<void> {} // deliberate no-op — the ledger is the source of truth
-}
+// Correct — limits apply per actor, i.e. per browser in anonymous mode.
+export default defineConfig({ model, quota: { limits: { day: { tokens: 50_000 } } } })
 ```
 
-Mechanism: `store.recordUsage(...)` has already persisted each turn's tokens;
-`quotas.ledger.check` reads that ledger, so adding again in `bump` counts each turn twice.
-Only a store keeping its OWN tally (`quotas.memory`, a bespoke Redis counter) should add.
-Source: `packages/adonis/docs/governance/quota-and-cost.mdx` ("`bump` is a notification,
-not necessarily an increment"), `packages/adonis/src/stores/ledger-quota.ts`.
+Mechanism: without `quota`, `GET /agent/quota` reports usage off the ledger but nothing
+gates a send. With it, the chat route checks the report before starting the turn.
+Source: `packages/adonis/docs/governance/quota-and-cost.mdx` ("Budgets").
 
 ### MEDIUM — reading `$0.00` rollups as "this model is free"
 
@@ -268,26 +238,23 @@ a free model. Per-run/per-usage rows keep their nulls.
 Source: `packages/adonis/docs/governance/quota-and-cost.mdx` ("`null` in the ledger,
 `0` in the rollups").
 
-### MEDIUM — replacing the allowed attachment content types instead of extending
+### HIGH — sending attachment objects instead of `{ mediaId }` refs
 
 ```ts
-// Wrong — REPLACES the default list: png/jpeg/pdf/csv now get 415.
-attachmentAllowedContentTypes: ['application/json']
+// Wrong — 400: a send names uploads by id only; a url from the client is never trusted.
+{ message, attachments: [{ mediaId, url, contentType, name }] }
 ```
 
 ```ts
-// Types match EXACTLY (no wildcards); spread the defaults you still want.
-attachmentAllowedContentTypes: [
-  'image/png', 'image/jpeg', 'image/gif', 'image/webp',
-  'application/pdf', 'text/plain', 'text/csv',
-  'text/markdown', // your addition
-],
+// Correct — the configured store (attachments: attachmentStores.media()) resolves the url.
+{ message, attachments: [{ mediaId }] }
 ```
 
-Mechanism: passing `attachmentAllowedContentTypes` replaces the default list rather than
-merging, and matching is exact — no `text/*` prefix rule — so anything absent is rejected
-with 415.
-Source: `packages/adonis/src/define_config.ts` (`AgentConfig.attachmentAllowedContentTypes`).
+Mechanism: the chat route refuses any key besides `mediaId`, then resolves each id through
+`AttachmentStagingStore.resolve({ mediaId, actor })` (`403` for another actor's upload).
+Limits come from the store (`attachmentStores.media({ maxBytes, allowedContentTypes })`);
+`allowedContentTypes` replaces the default list and matches exactly.
+Source: `packages/adonis/docs/authoring/attachments.mdx`.
 
 See also: `agent-tools/SKILL.md` — registering tools the model can actually call;
 `agent-governance/SKILL.md` — what `AuthActorResolver` feeds into.

package/skills/agent-testing/SKILL.md

@@ -215,8 +215,8 @@ Source: `packages/adonis/src/tool-registry.ts` (`definitionsFor`, `invoke`),
 
 ```ts
 // Wrong — frames are typed objects, not an SSE byte stream.
-const raw = await res.text() // 'data: {"delta":"..."}\n\n'
-expect(raw).toContain('delta')
+const raw = await res.text() // 'id: 1\ndata: {"kind":"text","text":"..."}\n\n'
+expect(raw).toContain('"kind":"text"')
 ```
 
 ```ts
@@ -227,10 +227,10 @@ for await (const frame of sink.subscribe(runId)) {
 ```
 
 Mechanism: `InMemoryTokenStreamSink.subscribe` yields `StreamFrame` objects; the SSE
-envelope (`event: meta` / `data: {"delta":...}` / `event: done`) is produced by the
-provider's route handler via `frameToSse`, a layer tests never cross.
+envelope (`event: meta` / `data: <AgentStreamEvent>` / `event: done`) is produced by the
+provider's route handler via `AgentSseEncoder`, a layer tests never cross.
 Source: `packages/adonis/docs/testing.mdx` (StreamFrame note),
-`packages/adonis/src/sse.ts` (`frameToSse`).
+`packages/adonis/src/sse.ts` (`AgentSseEncoder`).
 
 See also: `agent-tools/SKILL.md` — registering real tools into the test registry;
 `agent-setup/SKILL.md` — why `day` is a required, runner-stamped loop dep.

package/dist/src/stores/ledger-quota.d.ts

@@ -1,23 +0,0 @@
-import type { AgentStore } from '../spi/agent-store.js';
-import type { QuotaStore } from '../spi/quota-store.js';
-import type { QuotaState } from '../types.js';
-/**
- * A production {@link QuotaStore} backed by the persisted usage ledger (the append-only
- * `agent_token_usage` table the Lucid store writes each turn to). `check` reads the actor's
- * tokens-so-far for the day straight from {@link AgentStore.quotaToday} and compares it to a fixed
- * daily limit; `bump` is a deliberate no-op because the loop's `recordUsage` already writes every
- * turn's tokens to that same ledger. One source of truth — so enforcement and what a usage dashboard
- * reports can never drift, and it works across replicas with no extra shared state.
- *
- * Ledger-agnostic by design: it wraps any {@link AgentStore} (the `lucid` store for production, the
- * in-memory store for tests), so no dedicated quota table is needed — the token-usage ledger IS the
- * ledger. Wire it in `config/agent.ts` via `quota: quotas.ledger({ limitTokens })`.
- */
-export declare class LedgerQuotaStore implements QuotaStore {
-    private readonly store;
-    private readonly limitTokens;
-    constructor(store: AgentStore, limitTokens: number);
-    check(actorRef: string, day: string): Promise<QuotaState>;
-    bump(): Promise<void>;
-}
-//# sourceMappingURL=ledger-quota.d.ts.map

package/dist/src/stores/ledger-quota.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ledger-quota.d.ts","sourceRoot":"","sources":["../../../src/stores/ledger-quota.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAF9B,YACmB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EAClC;IAEE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO9D;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/dist/src/stores/ledger-quota.js

@@ -1,32 +0,0 @@
-/**
- * A production {@link QuotaStore} backed by the persisted usage ledger (the append-only
- * `agent_token_usage` table the Lucid store writes each turn to). `check` reads the actor's
- * tokens-so-far for the day straight from {@link AgentStore.quotaToday} and compares it to a fixed
- * daily limit; `bump` is a deliberate no-op because the loop's `recordUsage` already writes every
- * turn's tokens to that same ledger. One source of truth — so enforcement and what a usage dashboard
- * reports can never drift, and it works across replicas with no extra shared state.
- *
- * Ledger-agnostic by design: it wraps any {@link AgentStore} (the `lucid` store for production, the
- * in-memory store for tests), so no dedicated quota table is needed — the token-usage ledger IS the
- * ledger. Wire it in `config/agent.ts` via `quota: quotas.ledger({ limitTokens })`.
- */
-export class LedgerQuotaStore {
-    store;
-    limitTokens;
-    constructor(store, limitTokens) {
-        this.store = store;
-        this.limitTokens = limitTokens;
-    }
-    async check(actorRef, day) {
-        const { usedTokens } = await this.store.quotaToday(actorRef, day);
-        return {
-            usedTokens,
-            limitTokens: this.limitTokens,
-            withinLimit: usedTokens < this.limitTokens,
-        };
-    }
-    async bump() {
-        // No-op: the ledger is the source of truth — recordUsage already persisted this turn's tokens.
-    }
-}
-//# sourceMappingURL=ledger-quota.js.map

package/dist/src/stores/ledger-quota.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ledger-quota.js","sourceRoot":"","sources":["../../../src/stores/ledger-quota.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAER,KAAK;IACL,WAAW;IAF9B,YACmB,KAAiB,EACjB,WAAmB;qBADnB,KAAK;2BACL,WAAW;IAC3B,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,GAAW;QACvC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO;YACL,UAAU;YACV,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC,WAAW;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,+FAA+F;IACjG,CAAC;CACF"}