oracular 0.14.0 → 0.15.0

package/dist/presets.d.cts

@@ -69,6 +69,18 @@ interface IntentConfig {
      * weight.
      */
     saturate?: boolean;
+    /**
+     * Each outcome is an episode of its own for this intent, rather than the session. After the
+     * outcome arrives, the intent's bookkeeping starts over: a later outcome in the same session
+     * counts as another episode even with nothing seen since, and signals seen after an outcome
+     * take a miss at the session's close (or wait under `attribution`), as a first attempt would.
+     * Default false: the episode is the session, a repeated outcome with nothing seen since counts
+     * nothing, and signals seen after an outcome are neutral at the close. For intents shaped as
+     * attempts (an upload that fails, then completes, then completes again), where the second
+     * attempt is the contrast learning needs. With it set, a duplicated outcome event counts twice:
+     * dedupe such events in the app.
+     */
+    episodePerOutcome?: boolean;
     /**
      * How long a closed episode's signals wait for the outcome before they take a miss, in the same
      * unit as `at`. With it set, an episode that ends without the outcome is held instead of

package/dist/presets.d.ts

@@ -69,6 +69,18 @@ interface IntentConfig {
      * weight.
      */
     saturate?: boolean;
+    /**
+     * Each outcome is an episode of its own for this intent, rather than the session. After the
+     * outcome arrives, the intent's bookkeeping starts over: a later outcome in the same session
+     * counts as another episode even with nothing seen since, and signals seen after an outcome
+     * take a miss at the session's close (or wait under `attribution`), as a first attempt would.
+     * Default false: the episode is the session, a repeated outcome with nothing seen since counts
+     * nothing, and signals seen after an outcome are neutral at the close. For intents shaped as
+     * attempts (an upload that fails, then completes, then completes again), where the second
+     * attempt is the contrast learning needs. With it set, a duplicated outcome event counts twice:
+     * dedupe such events in the app.
+     */
+    episodePerOutcome?: boolean;
     /**
      * How long a closed episode's signals wait for the outcome before they take a miss, in the same
      * unit as `at`. With it set, an episode that ends without the outcome is held instead of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oracular",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "On-device intent engine. Your app learns when the user is ready. Nothing leaves the device.",
   "keywords": [
     "oracular",

package/schema/config.schema.json

@@ -91,6 +91,10 @@
           "type": "boolean",
           "description": "Repeats of a signal within one episode add less. Default: true when episodeTimeout is set, false otherwise."
         },
+        "episodePerOutcome": {
+          "type": "boolean",
+          "description": "Each outcome is an episode of its own for this intent: a later outcome in the same session counts as another episode even with nothing seen since, and signals seen after an outcome take a miss at the session's close. Default false: the episode is the session."
+        },
         "attribution": {
           "$ref": "#/$defs/duration",
           "description": "How long a closed episode's signals wait for the outcome before they take a miss. An outcome inside the window credits each waiting episode by 2^(−age / halfLife). Unset: a miss at once when the episode ends."