@lepsto/sdk-app 94.2.0 → 95.0.0

package/CHANGELOG.md

@@ -125,9 +125,14 @@ before this point lives in that package.
 The publish pipeline appends its machine-rendered block for the release being
 built below this line. It is not committed back to the repo, so in a git
 checkout this section is empty — see the note at the top.
-## 94.2.0 (minor)
-
-### *
-- runtime update
-- documentation update
+## 95.0.0 (major)
+
+### brain
+- `brain_daemon_batch_status`: type change on `run (output)`
+- `brain_daemon_runs`: new optional field `runs.planLimit (output)`
+- `brain_memory_add`: new optional field `error_code (output)`
+- `brain_memory_add`: new optional field `extraction (output)`
+- `brain_memory_add`: description updated
+- `brain_memory_stats`: new optional field `extraction_gaps (output)`
+- `brain_memory_stats`: description updated
 

package/dist/_types/gen/types.gen.d.ts

@@ -71239,8 +71239,18 @@ export interface BrainDaemonBatchStatusOutput {
             submitted?: number;
         };
         status: string;
-        outcome: (("finalized" | "finalized-with-fallback" | "below-min-files" | "nothing-submitted" | "timeout" | "failed" | "finalize-failed" | "crash") | null);
+        outcome: (("finalized" | "finalized-with-fallback" | "below-min-files" | "nothing-submitted" | "timeout" | "failed" | "finalize-failed" | "crash" | "billing-blocked") | null);
         elapsedMs: (number | null);
+        planLimit: ({
+            /**
+             * Billing's reason for the stop (e.g. trial_cap_reached); null when billing gave none
+             */
+            reason: (string | null);
+            /**
+             * Billing's upgrade link; null when billing gave none
+             */
+            upgradeUrl: (string | null);
+        } | null);
         startedAt: string;
         batchJobId: (string | null);
         finishedAt: (string | null);
@@ -71705,6 +71715,19 @@ export interface BrainDaemonRunsOutput {
          * How a batch run finished, in the batch pipeline's own words (e.g. finalized, timeout, crash); null for a realtime run
          */
         outcome: (string | null);
+        /**
+         * Set when the run stopped on the product's plan limit before ingesting anything; null for every other run
+         */
+        planLimit: ({
+            /**
+             * Billing's reason for the stop (e.g. trial_cap_reached); null when billing gave none
+             */
+            reason: (string | null);
+            /**
+             * Billing's upgrade link; null when billing gave none
+             */
+            upgradeUrl: (string | null);
+        } | null);
         /**
          * When the run started, ISO 8601 timestamp
          */
@@ -72500,13 +72523,38 @@ export interface BrainMemoryAddInput {
 }
 export interface BrainMemoryAddOutput {
     /**
-     * True when the memory was stored
+     * True when the memory was stored and its facts extracted (or there was nothing to extract). False when extraction failed — the raw memory is still stored under memory_id — or when the memory was not stored at all
      */
     success: boolean;
     /**
      * Engine id of the memory just stored; keep it to read, replace or delete the memory later
      */
     memory_id: string;
+    /**
+     * Present only when success is false. Tell stored from not stored by `extraction`, not by this code: with extraction.status 'failed' the raw memory IS stored and searchable under memory_id, only its facts are missing — do not re-add the same content, that stores a duplicate. With no `extraction` nothing was stored, and the add can be retried
+     */
+    error_code?: string;
+    /**
+     * What fact extraction made of this memory
+     */
+    extraction?: {
+        /**
+         * How many memories extraction stored from this write, across every derived layer (facts, identity, profile, summaries) — not a count of facts alone
+         */
+        items: number;
+        /**
+         * ok = at least one memory was derived from it (a summary counts, so ok alone does not promise a fact); empty = nothing new came out of it — the content held nothing durable, or everything in it is already in memory; failed = extraction broke, the raw memory is stored without facts; skipped = the engine does not extract in this mode
+         */
+        status: ("ok" | "empty" | "failed" | "skipped");
+        /**
+         * The engine's code when extraction failed — or, with status ok, when it ran degraded but still stored its facts
+         */
+        error_code?: string;
+        /**
+         * The engine's own words for that failure or degradation — quote it when reporting a problem
+         */
+        error_message?: string;
+    };
     /**
      * Engine request id for this call — quote it when reporting a problem
      */
@@ -72850,6 +72898,23 @@ export interface BrainMemoryStatsOutput {
          */
         entityCount: number;
     };
+    /**
+     * Raw memories left without facts, for the caller's product and scope. Counts only, and a lower bound. Null when the engine could not compute it
+     */
+    extraction_gaps: ({
+        /**
+         * Raw memories (l1_raw) the scope holds
+         */
+        raw_total: number;
+        /**
+         * Raw memories no derived memory (fact, identity) points back to — their extraction produced nothing
+         */
+        raw_without_derived: number;
+        /**
+         * Of those, raw memories still in shadow status
+         */
+        shadow_without_derived: number;
+    } | null);
 }
 export interface BrainMemoryUpdateInput {
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lepsto/sdk-app",
   "description": "The Lepsto SDK for App is a TypeScript SDK that provides runtime bindings and type-safe generated code for interacting with Lepsto Platform APIs and services. This package generates type definitions and client bindings from API catalogs, enabling developers to build applications that consume Lepsto platform services with full type safety and autocompletion.",
-  "version": "94.2.0",
+  "version": "95.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lepsto/lepsto-sdk-app.git"
@@ -220,5 +220,5 @@
       }
     }
   },
-  "sdkContentHash": "sha256:68191900f3a6d44d457c5096ff7201d610a5e9db4244663de1dccb68088abd09"
+  "sdkContentHash": "sha256:0f92375cfab82c13bb7e194d08056717ba794240b9785855a6be4cb37e954d82"
 }

package/src/gen/types.gen.ts

@@ -65760,8 +65760,18 @@ finalized?: number
 submitted?: number
 }
 status: string
-outcome: (("finalized" | "finalized-with-fallback" | "below-min-files" | "nothing-submitted" | "timeout" | "failed" | "finalize-failed" | "crash") | null)
+outcome: (("finalized" | "finalized-with-fallback" | "below-min-files" | "nothing-submitted" | "timeout" | "failed" | "finalize-failed" | "crash" | "billing-blocked") | null)
 elapsedMs: (number | null)
+planLimit: ({
+/**
+ * Billing's reason for the stop (e.g. trial_cap_reached); null when billing gave none
+ */
+reason: (string | null)
+/**
+ * Billing's upgrade link; null when billing gave none
+ */
+upgradeUrl: (string | null)
+} | null)
 startedAt: string
 batchJobId: (string | null)
 finishedAt: (string | null)
@@ -66240,6 +66250,19 @@ status: string
  * How a batch run finished, in the batch pipeline's own words (e.g. finalized, timeout, crash); null for a realtime run
  */
 outcome: (string | null)
+/**
+ * Set when the run stopped on the product's plan limit before ingesting anything; null for every other run
+ */
+planLimit: ({
+/**
+ * Billing's reason for the stop (e.g. trial_cap_reached); null when billing gave none
+ */
+reason: (string | null)
+/**
+ * Billing's upgrade link; null when billing gave none
+ */
+upgradeUrl: (string | null)
+} | null)
 /**
  * When the run started, ISO 8601 timestamp
  */
@@ -67057,13 +67080,38 @@ source_authority?: ("policy" | "official" | "team" | "informal")
 
 export interface BrainMemoryAddOutput {
 /**
- * True when the memory was stored
+ * True when the memory was stored and its facts extracted (or there was nothing to extract). False when extraction failed — the raw memory is still stored under memory_id — or when the memory was not stored at all
  */
 success: boolean
 /**
  * Engine id of the memory just stored; keep it to read, replace or delete the memory later
  */
 memory_id: string
+/**
+ * Present only when success is false. Tell stored from not stored by `extraction`, not by this code: with extraction.status 'failed' the raw memory IS stored and searchable under memory_id, only its facts are missing — do not re-add the same content, that stores a duplicate. With no `extraction` nothing was stored, and the add can be retried
+ */
+error_code?: string
+/**
+ * What fact extraction made of this memory
+ */
+extraction?: {
+/**
+ * How many memories extraction stored from this write, across every derived layer (facts, identity, profile, summaries) — not a count of facts alone
+ */
+items: number
+/**
+ * ok = at least one memory was derived from it (a summary counts, so ok alone does not promise a fact); empty = nothing new came out of it — the content held nothing durable, or everything in it is already in memory; failed = extraction broke, the raw memory is stored without facts; skipped = the engine does not extract in this mode
+ */
+status: ("ok" | "empty" | "failed" | "skipped")
+/**
+ * The engine's code when extraction failed — or, with status ok, when it ran degraded but still stored its facts
+ */
+error_code?: string
+/**
+ * The engine's own words for that failure or degradation — quote it when reporting a problem
+ */
+error_message?: string
+}
 /**
  * Engine request id for this call — quote it when reporting a problem
  */
@@ -67417,6 +67465,23 @@ knowledge: {
  */
 entityCount: number
 }
+/**
+ * Raw memories left without facts, for the caller's product and scope. Counts only, and a lower bound. Null when the engine could not compute it
+ */
+extraction_gaps: ({
+/**
+ * Raw memories (l1_raw) the scope holds
+ */
+raw_total: number
+/**
+ * Raw memories no derived memory (fact, identity) points back to — their extraction produced nothing
+ */
+raw_without_derived: number
+/**
+ * Of those, raw memories still in shadow status
+ */
+shadow_without_derived: number
+} | null)
 }
 
 export interface BrainMemoryUpdateInput {