@falai/agent 3.4.5 → 4.0.0-alpha.2

package/dist/cjs/types/ai.d.ts

@@ -20,8 +20,13 @@ export interface ReasoningConfig {
  * Input for AI message generation
  */
 export interface GenerateMessageInput<TContext = unknown> {
-    /** The constructed prompt */
+    /** The constructed prompt, sent as the final user turn. */
     prompt: string;
+    /**
+     * The part of the prompt that is the same every turn, sent as a leading
+     * system message. Split out so providers can cache it — see `stablePrefix`.
+     */
+    system?: string;
     /** Interaction history */
     history: HistoryItem[];
     /** Context data */
@@ -70,6 +75,20 @@ export interface AgentStructuredResponse extends Record<string, unknown> {
     }>;
     /** Additional reasoning or internal thoughts (optional) */
     reasoning?: string;
+    /** OpenRouter's normalized reasoning payload, when the provider sent one. */
+    reasoningDetails?: unknown[];
+}
+/**
+ * What a call cost, as the provider counted it. A turn spends several calls,
+ * so `TurnResult.usage` is their sum. Absent when no provider reported any.
+ */
+export interface TokenUsage {
+    /** Tokens read, the cached ones included. */
+    promptTokens: number;
+    /** Tokens written. Thinking tokens count here. */
+    completionTokens: number;
+    /** The part of `promptTokens` served from a cache, billed far cheaper. */
+    cachedInputTokens: number;
 }
 /**
  * Output from AI message generation
@@ -85,6 +104,12 @@ export interface GenerateMessageOutput<TStructured = AgentStructuredResponse> {
         tokensUsed?: number;
         /** Finish reason */
         finishReason?: string;
+        /** Tokens in the prompt, as the provider counted them. */
+        promptTokens?: number;
+        /** Tokens generated. */
+        completionTokens?: number;
+        /** The part of `promptTokens` the provider served from its cache, billed far cheaper. */
+        cachedInputTokens?: number;
         /** Additional provider-specific data */
         [key: string]: unknown;
     };
@@ -109,6 +134,12 @@ export interface GenerateMessageStreamChunk<TStructured = AgentStructuredRespons
         tokensUsed?: number;
         /** Finish reason */
         finishReason?: string;
+        /** Tokens in the prompt, as the provider counted them. */
+        promptTokens?: number;
+        /** Tokens generated. */
+        completionTokens?: number;
+        /** The part of `promptTokens` the provider served from its cache, billed far cheaper. */
+        cachedInputTokens?: number;
         /** Additional provider-specific data */
         [key: string]: unknown;
     };

package/dist/cjs/types/ai.d.ts.map

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

package/dist/cjs/types/compaction.d.ts

@@ -1,7 +1,7 @@
 /**
  * Context compaction types for managing conversation history size
  */
-import type { AiProvider } from "./ai.js";
+import type { AiProvider, TokenUsage } from "./ai.js";
 import type { HistoryItem } from "./history.js";
 /**
  * Configuration for the compaction engine.
@@ -46,5 +46,7 @@ export interface CompactionResult {
     messagesCompacted: number;
     /** Summary text (if auto-compact was used) */
     summary?: string;
+    /** What the summarising call cost, when one was made and counted. */
+    usage?: TokenUsage;
 }
 //# sourceMappingURL=compaction.d.ts.map

package/dist/cjs/types/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/types/compaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,4BAA4B;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,eAAe,GAAG,cAAc,CAAC;IAC3E,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/types/compaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,4BAA4B;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,eAAe,GAAG,cAAc,CAAC;IAC3E,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,UAAU,CAAC;CACtB"}

package/dist/cjs/types/errors.d.ts

@@ -17,21 +17,10 @@
  */
 export { ProviderError } from "@providerkit/core";
 export type { ErrorKind } from "@providerkit/core";
-/**
- * Typed error for not-yet-implemented surface. Subclass of Error (not of
- * FlowConfigurationError) so handlers can distinguish "not yet built" from
- * "misconfigured".
- *
- * Thrown when a reserved option is set to a value that the current version
- * does not support (e.g. `routerMode: 'embedding'` in v2.0).
- */
-export declare class NotImplementedError extends Error {
-    constructor(message: string);
-}
 /**
  * Thrown by the persistence layer when a session save carries a stale
  * `version` — i.e. another writer persisted the session after this one
- * loaded it (concurrent respond() calls, parallel webhooks, two tabs).
+ * loaded it (concurrent turn() calls, parallel webhooks, two tabs).
  *
  * Handlers should reload the session and retry or surface the conflict.
  */
@@ -41,4 +30,12 @@ export declare class SessionConflictError extends Error {
     readonly actualVersion: number | undefined;
     constructor(sessionId: string, expectedVersion: number, actualVersion: number | undefined);
 }
+/**
+ * Thrown when a flow cannot run as written: an unknown field, action, event,
+ * condition or step id, a duplicate or reserved step id, or a jump with no
+ * way out. Raised at agent construction and by `validateFlow`.
+ */
+export declare class FlowConfigurationError extends Error {
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/cjs/types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI9B;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAEvB,SAAS,EAAE,MAAM;aACjB,eAAe,EAAE,MAAM;aACvB,aAAa,EAAE,MAAM,GAAG,SAAS;gBAFjC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GAAG,SAAS;CASxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAEvB,SAAS,EAAE,MAAM;aACjB,eAAe,EAAE,MAAM;aACvB,aAAa,EAAE,MAAM,GAAG,SAAS;gBAFjC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GAAG,SAAS;CASxD;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI9B"}

package/dist/cjs/types/errors.js

@@ -3,7 +3,7 @@
  * Typed error classes for @falai/agent.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionConflictError = exports.NotImplementedError = exports.ProviderError = void 0;
+exports.FlowConfigurationError = exports.SessionConflictError = exports.ProviderError = void 0;
 /**
  * The normalized provider failure, and the kinds it comes in.
  *
@@ -20,25 +20,10 @@ exports.SessionConflictError = exports.NotImplementedError = exports.ProviderErr
  */
 var core_1 = require("@providerkit/core");
 Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return core_1.ProviderError; } });
-/**
- * Typed error for not-yet-implemented surface. Subclass of Error (not of
- * FlowConfigurationError) so handlers can distinguish "not yet built" from
- * "misconfigured".
- *
- * Thrown when a reserved option is set to a value that the current version
- * does not support (e.g. `routerMode: 'embedding'` in v2.0).
- */
-class NotImplementedError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'NotImplementedError';
-    }
-}
-exports.NotImplementedError = NotImplementedError;
 /**
  * Thrown by the persistence layer when a session save carries a stale
  * `version` — i.e. another writer persisted the session after this one
- * loaded it (concurrent respond() calls, parallel webhooks, two tabs).
+ * loaded it (concurrent turn() calls, parallel webhooks, two tabs).
  *
  * Handlers should reload the session and retry or surface the conflict.
  */
@@ -54,4 +39,16 @@ class SessionConflictError extends Error {
     }
 }
 exports.SessionConflictError = SessionConflictError;
+/**
+ * Thrown when a flow cannot run as written: an unknown field, action, event,
+ * condition or step id, a duplicate or reserved step id, or a jump with no
+ * way out. Raised at agent construction and by `validateFlow`.
+ */
+class FlowConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FlowConfigurationError';
+    }
+}
+exports.FlowConfigurationError = FlowConfigurationError;
 //# sourceMappingURL=errors.js.map

package/dist/cjs/types/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;;;;;;;;;;;GAaG;AACH,0CAAkD;AAAzC,qGAAA,aAAa,OAAA;AAGtB;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AALD,kDAKC;AAED;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC3C,YACoB,SAAiB,EACjB,eAAuB,EACvB,aAAiC;QAEjD,KAAK,CACD,mCAAmC,SAAS,+BAA+B;YAC3E,oBAAoB,eAAe,WAAW,aAAa,IAAI,MAAM,IAAI;YACzE,6CAA6C,CAChD,CAAC;QARc,cAAS,GAAT,SAAS,CAAQ;QACjB,oBAAe,GAAf,eAAe,CAAQ;QACvB,kBAAa,GAAb,aAAa,CAAoB;QAOjD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAbD,oDAaC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;;;;;;;;;;;GAaG;AACH,0CAAkD;AAAzC,qGAAA,aAAa,OAAA;AAGtB;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC3C,YACoB,SAAiB,EACjB,eAAuB,EACvB,aAAiC;QAEjD,KAAK,CACD,mCAAmC,SAAS,+BAA+B;YAC3E,oBAAoB,eAAe,WAAW,aAAa,IAAI,MAAM,IAAI;YACzE,6CAA6C,CAChD,CAAC;QARc,cAAS,GAAT,SAAS,CAAQ;QACjB,oBAAe,GAAf,eAAe,CAAQ;QACvB,kBAAa,GAAb,aAAa,CAAoB;QAOjD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAbD,oDAaC;AAED;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACzC,CAAC;CACJ;AALD,wDAKC"}