oracular 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -138,6 +138,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
@@ -657,7 +669,8 @@ declare function explain(state: EngineState, intent: string, at: number, opts?:
  * it either way; otherwise every occurrence adds all of `w`. For every intent the event is the
  * outcome of: give the signals remembered since the episode started or the outcome last arrived a
  * hit and count the episode toward the base rate (a repeated outcome with nothing seen since
- * counts nothing), credit
+ * counts nothing, unless `IntentConfig.episodePerOutcome` makes every outcome an episode of its
+ * own for the intent), credit
  * the closed episodes still waiting under `IntentConfig.attribution` by `2^(−age / halfLife)`
  * each, record `lastOutcomeAt`, and (by default) reset the evidence to the prior. Any event opens
  * or extends the current episode; an idle gap longer than `config.episodeTimeout` closes the

package/dist/index.d.ts

@@ -138,6 +138,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
@@ -657,7 +669,8 @@ declare function explain(state: EngineState, intent: string, at: number, opts?:
  * it either way; otherwise every occurrence adds all of `w`. For every intent the event is the
  * outcome of: give the signals remembered since the episode started or the outcome last arrived a
  * hit and count the episode toward the base rate (a repeated outcome with nothing seen since
- * counts nothing), credit
+ * counts nothing, unless `IntentConfig.episodePerOutcome` makes every outcome an episode of its
+ * own for the intent), credit
  * the closed episodes still waiting under `IntentConfig.attribution` by `2^(−age / halfLife)`
  * each, record `lastOutcomeAt`, and (by default) reset the evidence to the prior. Any event opens
  * or extends the current episode; an idle gap longer than `config.episodeTimeout` closes the

package/dist/index.js

@@ -284,6 +284,7 @@ var INTENT_KEYS = [
   "outcome",
   "resetOnOutcome",
   "saturate",
+  "episodePerOutcome",
   "attribution",
   "reveal"
 ];
@@ -441,6 +442,12 @@ function normalizeIntentConfig(value, path, strict = true) {
     if (typeof record2.saturate !== "boolean") typeError(`${path}.saturate`, "must be a boolean");
     out.saturate = record2.saturate;
   }
+  if (record2.episodePerOutcome !== void 0) {
+    if (typeof record2.episodePerOutcome !== "boolean") {
+      typeError(`${path}.episodePerOutcome`, "must be a boolean");
+    }
+    out.episodePerOutcome = record2.episodePerOutcome;
+  }
   if (record2.attribution !== void 0) {
     out.attribution = expectPositive(record2.attribution, `${path}.attribution`);
   }
@@ -757,7 +764,9 @@ function observe(state, event) {
     }
     if (isOutcome) {
       const record2 = episodeRecord(episode, intentName);
-      if (!record2.resolved || record2.seen.length > 0) is = recordEpisode(is, record2.seen, 1);
+      if (!record2.resolved || record2.seen.length > 0 || intent.episodePerOutcome === true) {
+        is = recordEpisode(is, record2.seen, 1);
+      }
       is = creditPending(is, intent, at);
       episode = markResolved(episode, intentName);
       is = { ...is, lastOutcomeAt: at };
@@ -810,7 +819,8 @@ function closeEpisode(state, at) {
   const intents = { ...state.intents };
   for (const [intentName, intent] of Object.entries(state.config.intents)) {
     const record2 = episodeRecord(state.episode, intentName);
-    if (record2.resolved) continue;
+    if (record2.resolved && (intent.episodePerOutcome !== true || record2.seen.length === 0))
+      continue;
     let is = getIntentState(state, intentName, intent);
     is = settlePending(is, intent, learning, at);
     is = intent.attribution === void 0 ? recordEpisode(is, record2.seen, 0) : deferEpisode(is, record2.seen, at);