@swapai/core 0.1.0 → 0.2.1

package/README.md

@@ -56,6 +56,27 @@ return score;
 result immediately and queues storage work. Use `await relevance.flush()` when
 you need to know all accepted examples are durable, such as during shutdown.
 
+## Delete one classifier's training data
+
+```ts
+relevance.clearTrainingData();
+await relevance.flush();
+```
+
+`clearTrainingData()` is synchronous and makes `isTrained()` return `false`
+immediately. It queues deletion of every retained example and saved model for
+this classifier name. `flush()` resolves after deletion is durable. Other
+classifiers and SwapAI's shared Needle runtime are left intact.
+
+A local classification already in progress cannot return an old-epoch result
+after the clear. It falls back to the supplied reference classifier, or rejects
+with `not_trained` when no reference was supplied. Its old-epoch result is not
+retained. Calls made after deletion finishes can build a new training set.
+
+If deletion cannot finish, `flush()` rejects and keeps the clear pending. A
+later `flush()` retries it. If the process exits, the next `init()` for that
+classifier finishes the pending deletion before any saved model can be used.
+
 ## Result types
 
 SwapAI supports bounded numbers, booleans, and a closed list of strings:
@@ -74,6 +95,14 @@ init({
 
 The string result is inferred as `"rabbit" | "fish" | "pig"`.
 
+Needle is a classifier, not a regression engine. For bounded numbers, SwapAI
+converts reference scores into a small, closed set of internal labels, then
+converts the selected label back to a number. When the training set contains
+only a few scores, those scores stay exact. Larger score sets are quantized to
+a bounded set based on `acceptableError`. The held-out test still compares the
+decoded number with the original reference score, so quantization consumes the
+same error budget and cannot bypass the accuracy gate.
+
 ## Effect
 
 Effect is optional and lives in a separate import:

package/dist/effect.d.ts

@@ -1,5 +1,5 @@
 import { Effect } from 'effect';
-import { R as ResultValue, C as Classifier, S as SwapAIError } from './types-DTbU1MEi.js';
+import { R as ResultValue, C as Classifier, S as SwapAIError } from './types-DkvGbscw.js';
 
 declare function classify<Result extends ResultValue>(classifier: Classifier<Result>, input: string): Effect.Effect<Result, SwapAIError>;
 declare function classifyWithReference<Result extends ResultValue, ReferenceError, Requirements>(classifier: Classifier<Result>, input: string, reference: (input: string) => Effect.Effect<Result, ReferenceError, Requirements>): Effect.Effect<Result, SwapAIError | ReferenceError, Requirements>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as ResultConfig, I as InitConfig, C as Classifier, b as ResultFor } from './types-DTbU1MEi.js';
-export { B as BooleanResultConfig, N as NormalizedInitConfig, c as NumberResultConfig, d as ReferenceClassifier, e as ResultComparison, R as ResultValue, f as StringResultConfig, S as SwapAIError } from './types-DTbU1MEi.js';
+import { a as ResultConfig, I as InitConfig, C as Classifier, b as ResultFor } from './types-DkvGbscw.js';
+export { B as BooleanResultConfig, N as NormalizedInitConfig, c as NumberResultConfig, d as ReferenceClassifier, e as ResultComparison, R as ResultValue, f as StringResultConfig, S as SwapAIError } from './types-DkvGbscw.js';
 
 declare function init<const Config extends ResultConfig>(inputConfig: InitConfig<Config>): Classifier<ResultFor<Config>>;