oracular 0.13.0 → 0.15.0

package/dist/inspect.d.cts

@@ -26,8 +26,8 @@ interface Prediction {
     revealedAt: number | null;
     /**
      * When the current suppression ends: the later of the reveal cooldown (after `markRevealed`)
-     * and the outcome cooldown (after the outcome event) still running at `at`, or null when
-     * neither is. `shouldReveal` is false while this is non-null.
+     * and the outcome cooldown (`outcomeCooldown` after the outcome event) still running at `at`,
+     * or null when neither is. `shouldReveal` is false while this is non-null.
      */
     suppressedUntil: number | null;
 }

package/dist/inspect.d.ts

@@ -26,8 +26,8 @@ interface Prediction {
     revealedAt: number | null;
     /**
      * When the current suppression ends: the later of the reveal cooldown (after `markRevealed`)
-     * and the outcome cooldown (after the outcome event) still running at `at`, or null when
-     * neither is. `shouldReveal` is false while this is non-null.
+     * and the outcome cooldown (`outcomeCooldown` after the outcome event) still running at `at`,
+     * or null when neither is. `shouldReveal` is false while this is non-null.
      */
     suppressedUntil: number | null;
 }

package/dist/presets.d.cts

@@ -14,6 +14,13 @@ interface RevealOptions {
     z?: number;
     /** How long after `markRevealed` the intent stays revealed and `shouldReveal` is false. Default: the intent's `halfLife`. */
     cooldown?: number;
+    /**
+     * How long after the intent's outcome event `shouldReveal` stays false. Default: `cooldown`.
+     * 0 is allowed: the outcome then pauses nothing, while a reveal still starts its cooldown, for
+     * an intent whose outcome recurs within minutes, or a "stuck" intent whose help should be back
+     * at the next attempt.
+     */
+    outcomeCooldown?: number;
     /**
      * How `lower` is computed. `'normal'` (default): p − z·sd, clamped to [0, 1]. `'exact'`: the
      * Beta distribution's own quantile at the same one-sided level, Φ(−z), so `z` keeps its
@@ -62,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

@@ -14,6 +14,13 @@ interface RevealOptions {
     z?: number;
     /** How long after `markRevealed` the intent stays revealed and `shouldReveal` is false. Default: the intent's `halfLife`. */
     cooldown?: number;
+    /**
+     * How long after the intent's outcome event `shouldReveal` stays false. Default: `cooldown`.
+     * 0 is allowed: the outcome then pauses nothing, while a reveal still starts its cooldown, for
+     * an intent whose outcome recurs within minutes, or a "stuck" intent whose help should be back
+     * at the next attempt.
+     */
+    outcomeCooldown?: number;
     /**
      * How `lower` is computed. `'normal'` (default): p − z·sd, clamped to [0, 1]. `'exact'`: the
      * Beta distribution's own quantile at the same one-sided level, Φ(−z), so `z` keeps its
@@ -62,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.13.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."
@@ -120,7 +124,12 @@
         "cooldown": {
           "type": "number",
           "minimum": 0,
-          "description": "How long after a reveal or the outcome the intent stays quiet. Default: the intent's halfLife."
+          "description": "How long after a reveal the intent stays quiet. Default: the intent's halfLife. Also the pause after the outcome unless outcomeCooldown is set."
+        },
+        "outcomeCooldown": {
+          "type": "number",
+          "minimum": 0,
+          "description": "How long after the outcome event the intent stays quiet. Default: cooldown. 0 lets the outcome pause nothing while a reveal still starts its cooldown."
         },
         "bound": {
           "type": "string",