@aparte/core 0.25.0 → 0.26.0

package/dist/context/checkpoint.d.ts

@@ -0,0 +1,28 @@
+import type { AparteMessage } from '../types/models.js';
+/**
+ * The part of a path the model reads, and the summary that stands for the rest.
+ *
+ * A checkpoint is `contextSummary` on a message: from it on the model reads the summary
+ * in place of everything before. The LAST message carrying one wins — a later
+ * checkpoint was written over the earlier summary (it asked for an update of it), so
+ * the earlier one is already inside it. Everything before the winner is dropped from
+ * the result, a legacy `compaction: true` message included: that notice is itself part
+ * of what the checkpoint summarised, and sending it beside the summary would say the
+ * same thing twice.
+ *
+ * With no checkpoint the path comes back unchanged and no summary is returned, so a
+ * caller can use it unconditionally. Nothing is deleted from the transcript — this
+ * reads a path and returns a view of it.
+ *
+ * Call it on the FULL path, the unanswered user message at its end included: the
+ * checkpoint can sit on that very message (a turn retried after an overflow), and the
+ * summary still has to go out before it.
+ *
+ * `AparteClient` applies it to every history it builds. A `history` function handed to
+ * the client receives the whole transcript and can call this itself.
+ */
+export declare function historyFromCheckpoint(path: AparteMessage[]): {
+    summary?: string;
+    messages: AparteMessage[];
+};
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/context/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/context/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAM5G"}

package/dist/context/measure.d.ts

@@ -0,0 +1,148 @@
+import type { AparteConfig } from '../config/aparte-config.js';
+import { type AparteChatMessage, type AparteUsage } from '../types/chat.js';
+import type { AparteMessage } from '../types/models.js';
+import type { AparteTool } from '../types/tools.js';
+/**
+ * Token heuristic (FR ~3.5 chars/tok, EN ~4 chars/tok).
+ *
+ * Accurate to ±10% — enough for budgeting, and it avoids a tokenizer, which costs ~5ms
+ * per message × N (too slow to run on every turn) and is one more dependency per model
+ * family. It is the ONE estimate: the compaction plugin's budget and selector, the
+ * gauge, and the number the client records on a reply all read it, so the figures they
+ * show and the decisions they take cannot disagree about what a message costs.
+ */
+export declare function estimateTokens(text: string | null | undefined): number;
+/**
+ * The estimate of a request's messages as the WIRE carries them: each message's text, and
+ * for an assistant envelope the calls it declares. Parts other than text (an image's
+ * bytes) are not counted — a character heuristic has nothing honest to say about them.
+ *
+ * Exported for the code that holds the request already built, where `estimateWireTokens`
+ * would serialise the transcript a second time.
+ */
+export declare function estimateChatTokens(messages: AparteChatMessage[]): number;
+/**
+ * Whether the heuristic could see the whole request: false when a message carries a part
+ * other than text (an image), which {@link estimateChatTokens} counts as nothing. An
+ * estimate of such a request is a floor, not a reading, and must not be set beside the
+ * provider's real count as if it were one.
+ */
+export declare function carriesNonTextParts(messages: AparteChatMessage[]): boolean;
+/**
+ * The estimate of a whole request as it is about to be sent: its messages (the system
+ * prompts and a checkpoint's summary among them) and the tool definitions beside them —
+ * the same four things {@link measureContext} adds up, so a figure recorded here at send
+ * time and the measure's own reading of the same view are one currency, which is what lets
+ * the one calibrate the other.
+ */
+export declare function estimateRequestTokens(request: {
+    messages: AparteChatMessage[];
+    tools?: AparteTool[] | undefined;
+}): number;
+/**
+ * The estimate of what the wire sends for these messages: the same serialisation the
+ * client builds its history with (`wireMessages`) — a reply's thinking is not sent, its
+ * text is, and a tool call and its result count as the envelope and the `tool` message
+ * the wire carries. A failed turn and one still in flight send nothing.
+ *
+ * Not `estimateTokens(message.content)`: assistant replies keep their text in
+ * `segments` with `content` empty, so that sum would read a whole conversation as free.
+ */
+export declare function estimateWireTokens(messages: AparteMessage[]): number;
+/** Tokens one turn reports as used: the provider's total, else the prompt plus the reply. */
+export declare const usageTokens: (usage: AparteUsage) => number;
+/**
+ * The registered tools, unless the current model says it cannot call one.
+ *
+ * Single source for the gate, so send / retry / edit — and the measure of what they send —
+ * cannot drift.
+ *
+ * The question is "did this model say it cannot", not "did it say it can": the app sets a
+ * model id by hand (`setModelConfig`) or a selector sets it from a fetched list, and in both
+ * cases the model's declared capabilities are commonly unknown. `undefined` capabilities
+ * read as "can", or `tools: []` would go on the wire while `getTools()` held the tool the
+ * app had explicitly registered, and the model would answer that it had no such tool.
+ * Registering a tool is an explicit act by the app; silently dropping it because a
+ * `/models` listing is terse is the library second-guessing the developer. A model that
+ * declares its capabilities and omits function calling is still honoured — that is a
+ * statement, and it is respected.
+ *
+ * Failure modes, both ways round: over-sending means a model that cannot use tools does
+ * not call one, or its own endpoint rejects the array with an error the developer can
+ * read. Under-sending would be silent, total, and look like a lying model.
+ */
+export declare function toolsForCurrentModel(config: AparteConfig): AparteTool[];
+/**
+ * What fills the model's window, as one reading. `used` is the total the gauge draws;
+ * `parts` say where it goes.
+ *
+ * The parts are RAW estimates (the character heuristic, uncalibrated), so they are
+ * labelled as estimates wherever they are shown and need not add up to `used`: the
+ * difference, `other`, is what the heuristic cannot see — a server loop's own system
+ * prompt and tools, the chat template's tokens, the heuristic's own error.
+ */
+export interface AparteContextMeasure {
+    /** The window `used` is measured against, when one is known. */
+    window?: number;
+    /** Tokens in use: the last reply's reported usage, or an estimate of the request the next turn would send. */
+    used: number;
+    /** `true` when `used` is an estimate — something changed in what the model reads since the last reply reported. */
+    estimated: boolean;
+    /** Raw estimates, in tokens, of what the model reads: the system prompts, the tool definitions, the checkpoint's summary, the messages after it. */
+    parts: {
+        system: number;
+        tools: number;
+        summary: number;
+        messages: number;
+    };
+    /** `used` less the parts, never below zero. */
+    other: number;
+}
+/** What {@link measureContext} reads. */
+export interface AparteContextMeasureInput {
+    /** The ACTIVE path of the conversation, checkpoint and all — not the view after it. */
+    messages: AparteMessage[];
+    /** The config that resolves the system prompt, the tools and the current model. */
+    config: AparteConfig;
+    /** A window that wins over the current model's, for a page that knows better (the gauge's `window` attribute). */
+    windowOverride?: number | null | undefined;
+    /**
+     * The caller knows what the model reads has changed since the last reply although the
+     * messages cannot say so — a Restore takes checkpoints off, and nothing is left on the
+     * path to date it. Forces an estimate.
+     */
+    viewChanged?: boolean;
+}
+/** The model's window as the measure reads it: the override, else the current model's. */
+export declare function windowOf(config: AparteConfig, windowOverride?: number | null): number | undefined;
+/**
+ * The one measure of the context window, for the gauge and for the compaction plugin.
+ *
+ * `used` is the last reply's REAL usage while nothing the model reads has changed since
+ * it: the reply is the last message of the path, and no checkpoint was written after it.
+ * Once something has (a message was added, a compaction ran), the real number describes a
+ * request that will not be sent again, so `used` becomes an estimate of the request that
+ * WOULD be sent — the system prompts, the tool definitions, the checkpoint's summary and
+ * the messages after it — scaled by `k`, how far the heuristic was off on the last reply:
+ * its real input tokens over the estimate recorded when it was sent
+ * (`AparteMessage.contextEstimate`), clamped to [0.5, 3] so one odd reply cannot throw the
+ * reading, and 1 when the reply has no estimate. After a compaction the reading is
+ * therefore the size of the new, smaller view, never the stale one from before it, and
+ * never a `k` computed against a history the reply did not see.
+ *
+ * `k` compares like with like or it is 1. The estimate is of the FIRST request a turn sent
+ * and the usage is of its LAST call, which also read the calls and their results, so a
+ * reply that called tools says nothing about the heuristic's error and counts as 1. A
+ * request the heuristic could not read whole (an image) records no estimate at all.
+ *
+ * While nothing has changed, `used` is what the NEXT request will carry: the input the
+ * provider reported, plus the reply as it goes back on the wire. A provider's output count
+ * includes the reasoning it generated, and a reply's thinking is not sent again, so for a
+ * reply that thought the answer is read from the transcript (the part after its last call,
+ * which is all the final call added to what it read) and not from the output count.
+ *
+ * The parts are not scaled: they stay the raw estimates, so a reader can see what the
+ * measure is made of.
+ */
+export declare function measureContext(input: AparteContextMeasureInput): AparteContextMeasure;
+//# sourceMappingURL=measure.d.ts.map

package/dist/context/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/context/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAiB,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGtE;AAWD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAG1H;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAEpE;AAED,6FAA6F;AAC7F,eAAO,MAAM,WAAW,UAAW,WAAW,KAAG,MAAuE,CAAC;AAEzH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,EAAE,CAIvE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8GAA8G;IAC9G,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,SAAS,EAAE,OAAO,CAAC;IACnB,oJAAoJ;IACpJ,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,yBAAyB;IACtC,uFAAuF;IACvF,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,mFAAmF;IACnF,MAAM,EAAE,YAAY,CAAC;IACrB,kHAAkH;IAClH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAIjG;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,oBAAoB,CAiCrF"}

package/dist/context/restore.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Restore: take every checkpoint off the transcript `from` belongs to, so the model reads
+ * the original messages again, and say so on `window`.
+ *
+ * EVERY checkpoint of the active path, not the one Restore was pressed on. A path that was
+ * summarised twice carries two (the second summary was written over the first), and
+ * removing only the newer would put the older summary back in front of messages the reader
+ * asked to have restored — a partial restore that looks like a complete one.
+ *
+ * Each removal goes through the chat's own `updateMessage`, which is what makes it reach
+ * the framework's list and the saved conversation as well as the bubble on screen; the
+ * `aparte-compact-done` that follows is what the conversation controller saves on and the
+ * gauge measures again on. A `restored: true` detail carries no summary: nothing was
+ * summarised, something was undone.
+ *
+ * Returns how many checkpoints were removed. Nothing is dispatched when the bubble belongs
+ * to no transcript that can be written — a restore that claimed to have happened would be
+ * the worse answer.
+ */
+export declare function restoreContext(from: Element, detail: {
+    messageId?: string;
+    targetId?: string;
+}): number;
+//# sourceMappingURL=restore.d.ts.map

package/dist/context/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/context/restore.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUvG"}

package/dist/conversations/conversation-controller.d.ts

@@ -189,10 +189,19 @@ export declare class AparteConversationController {
      * that was partially written before a switch or component destruction.
      */
     /**
-     * Save once the binding holds the summary a compaction announced. A transcript kept in
-     * a framework store reaches the binding only when that framework renders, so a save on
-     * the microtask wrote the conversation as it stood before the compaction. Bounded: a
-     * run with no summary (skipped), or a binding that never shows it, is saved as it is.
+     * Save once the binding holds what a compaction (or a Restore) announced. A transcript
+     * kept in a framework store reaches the binding only when that framework renders, so a
+     * save on the microtask wrote the conversation as it stood before the change. Bounded:
+     * a run that changed nothing (skipped), or a binding that never shows the change, is
+     * saved as it is.
+     *
+     * What "holds" means follows what the run said it did:
+     * - a checkpoint — `messageId` names the message carrying it, and it holds once that
+     *   message carries a `contextSummary` with its `createdAt` (a summary without the
+     *   stamp is a half-written one);
+     * - a Restore — it holds once no message of the path carries a checkpoint any more;
+     * - an older host's summary MESSAGE (`compaction: true`, ending with the summary).
+     * A run that names none of these has nothing to wait for.
      */
     private _persistOnceSummarised;
     private _persistActive;

package/dist/conversations/conversation-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-controller.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-controller.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-controller.ts"],"names":[],"mappings":"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"}

package/dist/conversations/conversation-manager.d.ts

@@ -35,6 +35,12 @@ export interface ConversationManagerOptions {
  *
  * Keeps the subtree rooted at the new-oldest kept message (so recent history AND
  * recent branches survive) and drops everything before it. Exported for testing.
+ *
+ * A checkpoint (`contextSummary`) the cut falls after is not lost with the messages it
+ * sat among: the new first message inherits it — the same summary and date, its count
+ * raised by the messages the cut takes after the checkpoint's own position. Without it
+ * a trimmed conversation would send the model no summary of what came before and no
+ * originals either, which is how retention would quietly undo a compaction.
  */
 export declare function applyRetention(messages: AparteMessage[], tree: ExportedMessageRepository | undefined, maxMessages: number): {
     messages: AparteMessage[];

package/dist/conversations/conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-manager.ts"],"names":[],"mappings":"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"}