@adonis-agora/agent 0.1.0

package/dist/src/data/tenant-scope.js

@@ -0,0 +1,126 @@
+const STRING_LITERAL_TYPES = new Set(['string', 'single_quote_string', 'double_quote_string']);
+/**
+ * Rewrites a SELECT so every reference to a scoped table is constrained to a
+ * single tenant: `<tenantColumn> = '<tenantRef>'` is AND-ed into the WHERE for
+ * each scoped table in the FROM. An existing predicate for a different tenant
+ * is rejected (no cross-tenant reads). `tenantRef === undefined` is the
+ * privileged path and passes the SQL through unchanged.
+ *
+ * CRITICAL: only a strictly `=== undefined` tenantRef is privileged. A `null`
+ * or empty-string tenantRef is NOT privileged — it flows into the rewrite and
+ * injects a predicate that matches nothing (fail-closed), so a missing tenant
+ * can never accidentally read every tenant's rows.
+ *
+ * Scoped mode rejects CTEs, UNION/INTERSECT/EXCEPT, and subqueries in FROM:
+ * those make it impossible to statically guarantee every tenant-bearing source
+ * is constrained, so we fail closed and ask the caller to rephrase.
+ *
+ * The `node-sql-parser` `Parser` is injected (see {@link loadSqlParser}) so this file never imports the
+ * optional peer at module load.
+ */
+export class TenantScopeRewriter {
+    parser;
+    tenantColumn;
+    scopedTables;
+    constructor(config, parser) {
+        this.parser = parser;
+        this.tenantColumn = config.tenantColumn;
+        this.scopedTables = new Set(config.scopedTables);
+    }
+    /** Rewrite `sql` to constrain scoped tables to `tenantRef`. Strictly-`undefined` → pass through. */
+    rewrite(sql, tenantRef) {
+        if (tenantRef === undefined)
+            return sql;
+        const parsed = this.parser.astify(sql, { database: 'MySQL' });
+        const ast = (Array.isArray(parsed) ? parsed[0] : parsed);
+        if (ast.type !== 'select') {
+            throw new Error('tenant scope: only SELECT is supported');
+        }
+        if (ast.with) {
+            throw new Error('tenant scope: WITH (CTE) is not supported in scoped mode — rewrite using JOINs/subqueries in FROM');
+        }
+        if (ast._next) {
+            throw new Error('tenant scope: UNION/INTERSECT/EXCEPT is not supported in scoped mode — run each branch as a separate query');
+        }
+        const fromEntries = ast.from ?? [];
+        for (const entry of fromEntries) {
+            if (!entry.table && entry.expr?.ast) {
+                throw new Error('tenant scope: subqueries in FROM are not supported in scoped mode');
+            }
+        }
+        const scopedFrom = fromEntries.filter((entry) => typeof entry.table === 'string' && this.scopedTables.has(entry.table));
+        if (scopedFrom.length === 0)
+            return sql;
+        const existing = this.collectTenantPredicates(ast.where);
+        for (const predicate of existing) {
+            if (predicate.value !== tenantRef) {
+                throw new Error('tenant scope: tenant mismatch — query targets a tenant other than the current session');
+            }
+        }
+        const coveredAliases = new Set(existing.map((predicate) => predicate.tableAlias));
+        for (const entry of scopedFrom) {
+            const alias = entry.as ?? entry.table;
+            const isAmbiguous = scopedFrom.length > 1;
+            const covered = coveredAliases.has(alias) || (!isAmbiguous && coveredAliases.has(null));
+            if (covered)
+                continue;
+            ast.where = this.andCondition(ast.where, this.buildTenantEquality(isAmbiguous ? alias : null, tenantRef));
+        }
+        return this.parser.sqlify(ast, { database: 'MySQL' });
+    }
+    collectTenantPredicates(where) {
+        if (!isBinaryExpr(where))
+            return [];
+        if (where.operator === 'AND' || where.operator === 'OR') {
+            return [
+                ...this.collectTenantPredicates(where.left),
+                ...this.collectTenantPredicates(where.right),
+            ];
+        }
+        if (where.operator !== '=')
+            return [];
+        const lhs = where.left;
+        const rhs = where.right;
+        if (!isColumnRef(lhs) || lhs.column !== this.tenantColumn)
+            return [];
+        if (!isStringLiteral(rhs))
+            return [];
+        return [{ tableAlias: lhs.table ?? null, value: rhs.value }];
+    }
+    buildTenantEquality(tableAlias, tenantRef) {
+        return {
+            type: 'binary_expr',
+            operator: '=',
+            left: { type: 'column_ref', table: tableAlias, column: this.tenantColumn },
+            right: { type: 'single_quote_string', value: tenantRef },
+        };
+    }
+    andCondition(existing, added) {
+        if (existing == null)
+            return added;
+        return {
+            type: 'binary_expr',
+            operator: 'AND',
+            left: existing,
+            right: added,
+        };
+    }
+}
+function isBinaryExpr(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.type === 'binary_expr');
+}
+function isColumnRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.type === 'column_ref');
+}
+function isStringLiteral(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.type === 'string' &&
+        STRING_LITERAL_TYPES.has(value.type) &&
+        typeof value.value === 'string');
+}
+//# sourceMappingURL=tenant-scope.js.map

package/dist/src/data/tenant-scope.js.map

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

package/dist/src/define_config.d.ts

@@ -0,0 +1,153 @@
+import type { BrandedFunctionalTool } from './ai-tool-ref.js';
+import type { ActorDirectory } from './spi/actor-directory.js';
+import type { ActorResolver } from './spi/actor-resolver.js';
+import type { AttachmentStagingStore } from './spi/attachment-staging.js';
+import type { AgentGovernanceQueries } from './spi/governance-queries.js';
+import type { ModelProvider } from './spi/model-provider.js';
+import type { AgentPricingStore } from './spi/pricing-store.js';
+import type { QuotaStore } from './spi/quota-store.js';
+import type { Retriever } from './spi/retriever.js';
+import type { RolesPolicy } from './spi/roles-policy.js';
+import type { TokenStreamSink } from './spi/token-stream-sink.js';
+import { actorDirectories, attachmentStores, governanceQueries, pricingStores, quotas, retrievers, stores, streamTransports, tokenSinks } from './stores/factory.js';
+import type { ActorDirectoryFactory, AttachmentStagingContext, AttachmentStagingFactory, EmbeddingFactory, GovernanceQueriesContext, GovernanceQueriesFactory, LucidGovernanceConfig, LucidPricingConfig, LucidStoreConfig, MemoryActorDirectoryConfig, MemoryRetrieverConfig, MemoryStoreConfig, PgVectorRetrieverConfig, PricingContext, PricingFactory, QuotaConfig, QuotaContext, QuotaFactory, RedisTokenSinkConfig, RetrieverContext, RetrieverFactory, StoreContext, StoreFactory, TokenSinkFactory } from './stores/factory.js';
+import type { ToolTransientRetrySetting } from './tool-retry.js';
+import type { AgentDefinition } from './types.js';
+/** A lazy factory thunk, so the peer (`ai`/a provider SDK) is imported only when the config loads. */
+export type ModelFactory = () => ModelProvider | Promise<ModelProvider>;
+/** A lazy {@link TokenStreamSink} factory. Omit to use the in-process sink. */
+export type SinkFactory = () => TokenStreamSink | Promise<TokenStreamSink>;
+/** The implicit default agent, configured inline — an {@link AgentDefinition} with `name` optional. */
+export type DefaultAgentOptions = Omit<AgentDefinition, 'name'> & {
+    name?: string;
+};
+/**
+ * Shape of `config/agent.ts`. Only `model` is required. Pick a `store` by name from the `stores` map
+ * (built with the {@link stores} factory so each peer is imported lazily); omit it for the in-memory
+ * store. The default runner is in-process (`durable: false`); the actor resolver defaults to one that
+ * THROWS — an identity is never fabricated.
+ *
+ * ```ts
+ * import { defineConfig, stores } from '@adonis-agora/agent'
+ * import { aiSdkModel } from '@adonis-agora/agent/ai-sdk'
+ *
+ * export default defineConfig({
+ *   model: () => aiSdkModel({ model: '...' }),
+ *   store: 'lucid',
+ *   stores: { lucid: stores.lucid(), memory: stores.memory() },
+ *   actorResolver: new AuthActorResolver(),
+ * })
+ * ```
+ */
+export interface AgentConfig {
+    /** The LLM provider, or a lazy factory thunk so the provider SDK peer loads lazily. Required. */
+    model: ModelProvider | ModelFactory;
+    /** Name of the store (a key of `stores`). Omit for the in-memory store (single-process). */
+    store?: string;
+    /** Named stores, built with the {@link stores} factory. Provide `lucid` and/or `memory`. */
+    stores?: Record<string, StoreFactory>;
+    /**
+     * Live token transport ("data plane"), or a lazy factory. Defaults to the in-process sink (single
+     * replica). Use `tokenSinks.redis({...})` (a.k.a. `streamTransports.redis`) for the multi-replica
+     * Redis sink so any pod can serve any run's SSE stream — the SSE envelope is unchanged either way.
+     */
+    sink?: TokenStreamSink | SinkFactory;
+    /**
+     * Daily token budget, or a lazy factory. Omit to disable quotas (fail-open on budget). Use
+     * `quotas.ledger({ limitTokens })` to enforce off the persisted token-usage ledger, or
+     * `quotas.memory({ limitTokens })` for a single-process budget.
+     */
+    quota?: QuotaStore | QuotaFactory;
+    /**
+     * Prices each turn's tokens into the assistant message's `usage.costUsd`. A provider-reported cost
+     * (a gateway) always wins; otherwise the loop estimates from this store's current price rows (fetched
+     * once per run). Omit → `costUsd` is always `null` (never a fabricated `0`). Use
+     * `pricingStores.lucid()` for the SQL-backed table or `pricingStores.memory()` for tests.
+     */
+    pricingStore?: AgentPricingStore | PricingFactory;
+    /**
+     * The governance read-model the optional `/agent/governance/*` read routes serve from — per-model /
+     * per-actor cost & usage rollups, the daily usage trend, and recent tool-call / thread activity over
+     * the persisted agent tables. Pass an {@link AgentGovernanceQueries} instance, or a lazy
+     * `governanceQueries.lucid()` factory (which prices its rollups against the configured `pricingStore`).
+     * Omit → the governance routes are not mounted. Read-only; safe to leave off.
+     */
+    governanceQueries?: AgentGovernanceQueries | GovernanceQueriesFactory;
+    /**
+     * Enables always-on ("inject") RAG: before each turn the loop retrieves passages for the user message
+     * and folds them into the system prompt (replay-safe under durable). Pass a {@link Retriever} directly
+     * or a lazy factory — `retrievers.pgvector({ embedder, table, dimension })` for the production pgvector
+     * store, or `retrievers.memory({ embedder, documents })` for the in-memory cosine store. Omit → no injection.
+     */
+    retriever?: Retriever | RetrieverFactory;
+    /** How many passages inject-mode retrieval requests per run. Default 5. */
+    retrievalTopK?: number;
+    /**
+     * Upload-side seam for message attachments (image/PDF). When set, the provider mounts the optional
+     * `POST /agent/attachments` route, which stages an uploaded file through this store and returns a
+     * {@link import('./spi/attachment-staging.js').MessageAttachment} the client sends with the next
+     * chat message. Pass a store instance, or a lazy `attachmentStores.*()` factory
+     * (`attachmentStores.memory()` encodes bytes into a `data:` URL for tests/dev). Omit → no upload
+     * route; a client sends already-staged attachment references directly on `chat`.
+     */
+    attachmentStaging?: AttachmentStagingStore | AttachmentStagingFactory;
+    /** Per-file byte cap the upload route enforces. Default 20 MiB. */
+    attachmentMaxBytes?: number;
+    /** Allowed upload content types. Default: common image types + `application/pdf` + `text/*`. */
+    attachmentAllowedContentTypes?: string[];
+    /**
+     * Tool authorization gate. Defaults to `DefaultToolAuthorizer` (fail-closed, ADMIN-only; role-set
+     * intersection). `authorizer` and `rolesPolicy` are aliases — pass either.
+     */
+    authorizer?: RolesPolicy;
+    /** Alias of {@link AgentConfig.authorizer}. */
+    rolesPolicy?: RolesPolicy;
+    /** Roles a tool requires when it declares none. Defaults to `['ADMIN']`. */
+    defaultRoles?: string[];
+    /**
+     * Resolves the acting actor per request (the identity seam). Defaults to a resolver that THROWS on
+     * every request — the agent never fabricates a caller. Wire `AuthActorResolver` / `HeaderActorResolver`.
+     */
+    actorResolver?: ActorResolver;
+    /**
+     * Read-side lookup from opaque persisted `actorRef`s to human display labels for governance/dashboard
+     * surfaces (the read-side dual of {@link AgentConfig.actorResolver}). Pass an {@link ActorDirectory}
+     * instance, or a lazy `actorDirectories.memory({ labels })` factory. Omit → surfaces render raw refs.
+     */
+    actorDirectory?: ActorDirectory | ActorDirectoryFactory;
+    /** Route prefix the `/agent/*` routes mount under. Defaults to `'agent'`. */
+    path?: string;
+    /**
+     * Run each turn as a replay-safe durable workflow (over `@adonis-agora/durable`) instead of
+     * in-process: LLM turns / tool executions become memoized durable steps, HITL approval suspends the
+     * run on a signal (resuming across a restart), and sub-agent delegation is a tracked child run. Opt
+     * in with `true` — requires `@adonis-agora/durable` installed and configured (`config/durable.ts`).
+     * If the durable peer can't be wired, the provider logs a warning and falls back to the in-process
+     * (inline) runner, so setting it is always safe.
+     */
+    durable?: boolean;
+    /** Additional named agents (an orchestrator delegates to them via `delegatesTo`). */
+    agents?: AgentDefinition[];
+    /** The implicit single agent's config (base prompt, personas, tool allow-list). Omit for a bare assistant. */
+    defaultAgent?: DefaultAgentOptions;
+    /** Static functional tools (`defineTool(...)`) to register at boot, in addition to discovery. */
+    tools?: BrandedFunctionalTool[];
+    /** Cap on model↔tool iterations per turn. Default 8. */
+    maxSteps?: number;
+    /**
+     * Retries a tool's own invocation, in place, when it throws a classified-transient error (a DB
+     * deadlock, a lock-wait timeout, a serialization failure) — a bounded retry inside the tool's
+     * durable step, so a replay reuses the memoized result and side effects run once. Default ON
+     * (`{ attempts: 2, backoffMs: 150 }` with the default classifier); pass `{ classify }` to
+     * widen/narrow which errors count as transient, or `false` to disable. Non-transient failures are
+     * never retried — they stay a one-shot business outcome.
+     */
+    toolTransientRetry?: ToolTransientRetrySetting;
+    /** Emit `agora:agent:*` diagnostics events when `@adonis-agora/diagnostics` is installed. Default true. */
+    emitDiagnostics?: boolean;
+}
+/** Identity helper giving `config/agent.ts` full type-checking. */
+export declare function defineConfig(config: AgentConfig): AgentConfig;
+export { stores, quotas, pricingStores, governanceQueries, retrievers, attachmentStores, tokenSinks, streamTransports, actorDirectories, };
+export type { StoreContext, StoreFactory, LucidStoreConfig, MemoryStoreConfig, QuotaContext, QuotaFactory, QuotaConfig, PricingContext, PricingFactory, LucidPricingConfig, GovernanceQueriesContext, GovernanceQueriesFactory, LucidGovernanceConfig, RetrieverContext, RetrieverFactory, MemoryRetrieverConfig, PgVectorRetrieverConfig, EmbeddingFactory, AttachmentStagingContext, AttachmentStagingFactory, TokenSinkFactory, RedisTokenSinkConfig, ActorDirectoryFactory, MemoryActorDirectoryConfig, };
+//# sourceMappingURL=define_config.d.ts.map

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

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

package/dist/src/define_config.js

@@ -0,0 +1,7 @@
+import { actorDirectories, attachmentStores, governanceQueries, pricingStores, quotas, retrievers, stores, streamTransports, tokenSinks, } from './stores/factory.js';
+/** Identity helper giving `config/agent.ts` full type-checking. */
+export function defineConfig(config) {
+    return config;
+}
+export { stores, quotas, pricingStores, governanceQueries, retrievers, attachmentStores, tokenSinks, streamTransports, actorDirectories, };
+//# sourceMappingURL=define_config.js.map

package/dist/src/define_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,UAAU,GACX,MAAM,qBAAqB,CAAC;AAoK7B,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,OAAO,EACL,MAAM,EACN,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,CAAC"}

package/dist/src/diagnostics.d.ts

@@ -0,0 +1,82 @@
+/** Payloads carried on each `agora:agent:*` channel. */
+export interface AgentRunStarted {
+    runId: string;
+    threadId: string;
+    actorId: string;
+    persona?: string;
+}
+export interface AgentMessageEvent {
+    runId: string;
+    threadId: string;
+    role: 'user' | 'assistant';
+    textLength: number;
+}
+export interface AgentToolCallEvent {
+    runId: string;
+    toolName: string;
+    toolType: 'read' | 'action';
+    status: string;
+    durationMs?: number;
+}
+export interface AgentQuotaExceeded {
+    actorId: string;
+    usedTokens: number;
+    limitTokens: number;
+}
+export interface AgentRunFinished {
+    runId: string;
+    threadId: string;
+    steps: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface AgentDelegated {
+    runId: string;
+    fromAgent?: string;
+    toAgent: string;
+}
+export interface AgentRetrieved {
+    runId: string;
+    /** Length of the query (not the text) — same redaction posture as {@link AgentMessageEvent}. */
+    queryLength: number;
+    count: number;
+}
+/**
+ * A transient-classified tool error being retried in place (no new checkpoint) — see
+ * `invokeWithTransientRetry`. Emitted once per retry (not for the final, non-retried outcome).
+ */
+export interface AgentToolRetry {
+    runId: string;
+    toolName: string;
+    toolCallId: string;
+    /** 1-based ordinal of the attempt that just failed and is about to be retried. */
+    attempt: number;
+    /** The failed attempt's error message. */
+    message: string;
+}
+/** Maps each event name to its payload type, so {@link publishAgent} is checked at the call site. */
+export interface AgentDiagnosticPayloads {
+    'run.started': AgentRunStarted;
+    message: AgentMessageEvent;
+    'tool-call': AgentToolCallEvent;
+    'quota.exceeded': AgentQuotaExceeded;
+    'run.finished': AgentRunFinished;
+    delegated: AgentDelegated;
+    retrieved: AgentRetrieved;
+    'tool.retry': AgentToolRetry;
+}
+export type AgentDiagnosticEvent = keyof AgentDiagnosticPayloads;
+/**
+ * Publish an agent event on `agora:agent:<event>` via the structural diagnostics slot. No-op when
+ * diagnostics isn't installed (the slot is empty) — and it never throws back into the agent loop.
+ */
+export declare function publishAgent<E extends AgentDiagnosticEvent>(event: E, payload: AgentDiagnosticPayloads[E]): void;
+export declare function publishAgentRunStarted(payload: AgentRunStarted): void;
+export declare function publishAgentMessage(payload: AgentMessageEvent): void;
+export declare function publishAgentToolCall(payload: AgentToolCallEvent): void;
+export declare function publishAgentQuotaExceeded(payload: AgentQuotaExceeded): void;
+export declare function publishAgentRunFinished(payload: AgentRunFinished): void;
+export declare function publishAgentDelegated(payload: AgentDelegated): void;
+export declare function publishAgentRetrieved(payload: AgentRetrieved): void;
+export declare function publishAgentToolRetry(payload: AgentToolRetry): void;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAYA,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AACD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qGAAqG;AACrG,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,eAAe,CAAC;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,kBAAkB,CAAC;IAChC,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,cAAc,EAAE,gBAAgB,CAAC;IACjC,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,oBAAoB,EACzD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,IAAI,CASN;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAErE;AACD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAEpE;AACD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEtE;AACD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAE3E;AACD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEvE;AACD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEnE;AACD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEnE;AACD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEnE"}

package/dist/src/diagnostics.js

@@ -0,0 +1,50 @@
+/**
+ * The `@adonis-agora/diagnostics` emit capability, published on this global slot at that package's
+ * module load. `@adonis-agora/agent` reads it STRUCTURALLY — it never imports or depends on the
+ * diagnostics package. When diagnostics isn't installed the slot is empty and emitting is an inert
+ * no-op that never throws back into the agent loop.
+ *
+ * Events land on `agora:agent:<event>`; the payload shapes below are the contract every consumer
+ * (dashboard / telescope) reads.
+ */
+const EMIT_SLOT = Symbol.for('@agora/diagnostics:emit');
+/**
+ * Publish an agent event on `agora:agent:<event>` via the structural diagnostics slot. No-op when
+ * diagnostics isn't installed (the slot is empty) — and it never throws back into the agent loop.
+ */
+export function publishAgent(event, payload) {
+    const emit = globalThis[EMIT_SLOT];
+    if (typeof emit === 'function') {
+        try {
+            emit('agent', event, payload);
+        }
+        catch {
+            // diagnostics must never break an agent run
+        }
+    }
+}
+export function publishAgentRunStarted(payload) {
+    publishAgent('run.started', payload);
+}
+export function publishAgentMessage(payload) {
+    publishAgent('message', payload);
+}
+export function publishAgentToolCall(payload) {
+    publishAgent('tool-call', payload);
+}
+export function publishAgentQuotaExceeded(payload) {
+    publishAgent('quota.exceeded', payload);
+}
+export function publishAgentRunFinished(payload) {
+    publishAgent('run.finished', payload);
+}
+export function publishAgentDelegated(payload) {
+    publishAgent('delegated', payload);
+}
+export function publishAgentRetrieved(payload) {
+    publishAgent('retrieved', payload);
+}
+export function publishAgentToolRetry(payload) {
+    publishAgent('tool.retry', payload);
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AA0ExD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAQ,EACR,OAAmC;IAEnC,MAAM,IAAI,GAAI,UAAsC,CAAC,SAAS,CAAuB,CAAC;IACtF,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAwB;IAC7D,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AACD,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AACD,MAAM,UAAU,uBAAuB,CAAC,OAAyB;IAC/D,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/durable/agent-run-context.d.ts

@@ -0,0 +1,24 @@
+import type { AgentDepsFactory } from '../agent-deps-factory.js';
+import type { AgentStore } from '../spi/agent-store.js';
+/**
+ * The runtime graph the durable {@link import('./agent-run-workflow.js').AgentRunWorkflow} body needs.
+ *
+ * A durable workflow class is instantiated by the engine with NO constructor arguments (see the
+ * durable lib's `registerWorkflowClass`), so — unlike the NestJS reference, which injected these via
+ * DI — the AdonisJS workflow reads them from this module-level holder instead. The provider populates
+ * it once at boot (and a test sets it directly), mirroring the durable lib's own
+ * `setWorkflowEngineResolver` seam. Re-read on every replay (it's a pure lookup, no side effect), so
+ * it stays deterministic.
+ */
+export interface DurableAgentContext {
+    factory: AgentDepsFactory;
+    store: AgentStore;
+}
+/** Install (or clear, with `undefined`) the durable agent context. Called by the provider at boot. */
+export declare function setDurableAgentContext(context: DurableAgentContext | undefined): void;
+/**
+ * The installed {@link DurableAgentContext}. Throws if the durable runner was reached without the
+ * provider having wired it — a misconfiguration, never a normal path.
+ */
+export declare function getDurableAgentContext(): DurableAgentContext;
+//# sourceMappingURL=agent-run-context.d.ts.map

package/dist/src/durable/agent-run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-context.d.ts","sourceRoot":"","sources":["../../../src/durable/agent-run-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;CACnB;AAID,sGAAsG;AACtG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAErF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAQ5D"}

package/dist/src/durable/agent-run-context.js

@@ -0,0 +1,17 @@
+let current;
+/** Install (or clear, with `undefined`) the durable agent context. Called by the provider at boot. */
+export function setDurableAgentContext(context) {
+    current = context;
+}
+/**
+ * The installed {@link DurableAgentContext}. Throws if the durable runner was reached without the
+ * provider having wired it — a misconfiguration, never a normal path.
+ */
+export function getDurableAgentContext() {
+    if (current === undefined) {
+        throw new Error('[@adonis-agora/agent] durable agent context is not set — the durable runner was used before ' +
+            'the provider wired it (call setDurableAgentContext during boot).');
+    }
+    return current;
+}
+//# sourceMappingURL=agent-run-context.js.map

package/dist/src/durable/agent-run-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-context.js","sourceRoot":"","sources":["../../../src/durable/agent-run-context.ts"],"names":[],"mappings":"AAkBA,IAAI,OAAwC,CAAC;AAE7C,sGAAsG;AACtG,MAAM,UAAU,sBAAsB,CAAC,OAAwC;IAC7E,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8FAA8F;YAC5F,kEAAkE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/durable/agent-run-workflow.d.ts

@@ -0,0 +1,37 @@
+import { type WorkflowCtx } from '@adonis-agora/durable';
+import type { AgentRunInput } from '../types.js';
+/**
+ * The workflow input. A superset of {@link AgentRunInput} carrying the two fields only the durable
+ * runner threads:
+ *  - `sinkRunId` — the TOP-LEVEL run whose live stream this run writes into. A sub-agent (child
+ *    workflow) forwards its tokens into its ancestor's sink so the human watching the parent sees
+ *    the delegate's output; a top-level run leaves it unset (it owns its own sink, keyed by runId).
+ *  - `delegationDepth` — how many delegations deep this run is (0 for top-level), carried so a future
+ *    guard can cap runaway sub-agent chains.
+ */
+export interface DurableAgentRunInput extends AgentRunInput {
+    sinkRunId?: string;
+    delegationDepth?: number;
+}
+/**
+ * The agent turn AS a durable workflow — the replay-safe counterpart of `InlineAgentRunner`. The
+ * shared `runAgentLoop` body drives model→tools→model exactly as inline; the durable hooks make it
+ * suspend-and-resume:
+ *  - `step(name, fn)` → `ctx.localStep` — every LLM turn, tool execution, and persist/quota write is a
+ *    checkpoint, so a replay returns the cached result instead of re-running it (stable ids, no
+ *    double-write, no re-streamed tokens).
+ *  - `awaitApproval(call)` → `ctx.waitForSignal('tool:<runId>:<callId>')` — an action tool suspends the
+ *    run with zero compute until an approve/reject signal arrives (namespaced by run, so one run's
+ *    decision can never satisfy another's).
+ *  - `runAgent(name, task)` → `ctx.child(AgentRunWorkflow, …)` — sub-agent delegation is a tracked,
+ *    replay-safe CHILD run (a node in the durable dashboard) that streams into the top-level sink.
+ *  - `openSink()` → the run's own sink writer (top-level) or a {@link childSinkWriter} (a child).
+ *
+ * Instantiated by the engine with no arguments; its deps come from {@link getDurableAgentContext}.
+ */
+export declare class AgentRunWorkflow {
+    run(ctx: WorkflowCtx, input: DurableAgentRunInput): Promise<{
+        text: string;
+    }>;
+}
+//# sourceMappingURL=agent-run-workflow.d.ts.map

package/dist/src/durable/agent-run-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-workflow.d.ts","sourceRoot":"","sources":["../../../src/durable/agent-run-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAG3D;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA+BD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,gBAAgB;IACrB,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAuEpF"}