@aparte/engine 0.13.1 → 0.15.0

package/README.md

@@ -7,29 +7,28 @@ dependencies, runs in the browser or Node.
 npm install @aparte/engine @aparte/core
 ```
 
-`@aparte/core` is an **optional peer**: install it only for the recommended path below.
+`@aparte/core` is **not a dependency** of this package — it is the other way round: core depends on the engine. Install core for the recommended path below.
 
 ```ts
-import { runStreamAgent } from '@aparte/engine';
 import { AparteClient } from '@aparte/core';
 
-// Inject the loop and core renders its events for you — a drop-in, not an approximation.
-new AparteClient({ streamRunner: runStreamAgent }).start();
+// Nothing to inject: the client runs this package's loop and renders its events.
+new AparteClient().start();
 ```
 
 Its core export is **`runStreamAgent`**: a DOM-free structured-stream loop that turns a
 transport's token stream into high-level run events (text, thinking, tool calls, artifacts),
 drives the tool-calling loop (with optional human-in-the-loop approval), and reports usage.
 
-`@aparte/core` embeds the same loop inline (`AparteClient._streamLoop`) so **core works
-without this package**. `@aparte/engine` is the *recommended path*: inject `runStreamAgent`
-via `AparteClientOptions.streamRunner` and core renders its events through
-`createStreamAdapter`. Parity between the two is proven by this package's `stream-parity`
-suite (it drives core's real `_streamLoop` and `runStreamAgent` against the same scripted
-transport and asserts identical output).
+`@aparte/core` runs this loop by default — it used to embed a copy of it inline, and the
+two were held equal by a parity suite; the copy is gone, and that suite now lives in core
+with the loop's call sequences pinned as snapshots. `AparteClientOptions.streamRunner` is
+the seam to wrap it (`(opts) => runStreamAgent({ ...opts, onHistoryAppend })` for a host
+that owns its transcript) or to replace it with a loop of your own emitting the same events.
 
-`@aparte/core` is an **optional peer** — `runStreamAgent` and its parsers import nothing from
-it; the orchestrator/memory helpers use core's config/types when present.
+`@aparte/core` is not needed here — `runStreamAgent`, the parsers and the compactor import
+nothing from it; `createCompactionSelector` is typed structurally, so core's messages fit it
+without core being named.
 
 ## Owning the history (prefix-cache hosts)
 

package/dist/agent/parsers/artifact-kind.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Map an artifact MIME type to a renderer kind — `'react'`, `'html'`, `'js'`, `'css'`,
+ * `'svg'`, `'json'`, `'markdown'`, `'csv'`, `'text'` — or `fallback` (default
+ * `'unknown'`) for anything else. Anthropic's `application/vnd.ant.*` namespace maps to
+ * its suffix; exact standard MIMEs are matched first, then a substring rescue for
+ * parameterised or vendor variants (`text/html; charset=utf-8`, `application/ld+json`).
+ *
+ * THE implementation: `@aparte/core` re-exports it under the same name. It used to
+ * live in the XML artifact state machine, which the 2026-08-28 audit's D2 removed —
+ * the core parser reads `<artifact>` tags natively — and this is the one piece of
+ * that file the built-in `create_artifact` and the artifact card still need.
+ *
+ * @example
+ * deriveArtifactKind('application/vnd.ant.react')  // 'react'
+ * deriveArtifactKind('text/html; charset=utf-8')   // 'html'
+ * deriveArtifactKind('font/woff2', 'text')         // 'text' (fallback)
+ */
+export declare function deriveArtifactKind(mimeType: string, fallback?: string): string;
+//# sourceMappingURL=artifact-kind.d.ts.map

package/dist/agent/parsers/artifact-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-kind.d.ts","sourceRoot":"","sources":["../../../src/agent/parsers/artifact-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAqBjF"}

package/dist/agent/stream-events.d.ts

@@ -5,21 +5,21 @@
  * `runAgent` ({@link ./agent-loop}): where `runAgent` drives a text-only
  * provider (`chat → string`, tool calls re-parsed from text), `runStreamAgent`
  * consumes a **structured** `AsyncIterable<StreamChatEvent>` (text / thinking /
- * tool_use / done / error) — the exact stream `AparteClient._streamLoop` reads
- * today. It is the extraction target for that 700-line DOM-coupled loop.
+ * tool_use / done / error) — the stream core's inline loop used to read. That loop
+ * is gone (audit 2026-08-28, D1): this is THE loop, and `AparteClient` runs it.
  *
  * DOM stays out of here. The loop emits high-level {@link StreamRunEvent}s in the
- * exact order `_streamLoop` performs its `targetElement.*` calls; a thin adapter
+ * exact order the inline loop performed its `targetElement.*` calls; a thin adapter
  * (in `@aparte/core`, where the parser and renderers live) translates each event
  * into the imperative viewport surface. So this module — and {@link ./stream-run}
  * — import **nothing** from `@aparte/core`: the types below structurally mirror the
  * core types (`AparteStreamEvent`, `AparteUsage`, `AparteChatMessage`, `AparteToolCall`)
  * so the adapter passes the real objects through with zero runtime conversion.
  *
- * SCOPE: text · thinking · tool_use (+ HITL approval) · done · error · artifacts
- * (raw / XML state machine / create_artifact) · multi-phase pipeline · synthetic
- * toolChoice bypass. Code-fence promotion is the only `_streamLoop` mechanism
- * left out here — it is adapter-side (it needs the core parser).
+ * SCOPE: text · thinking · tool_use (+ HITL approval) · done · error · the built-in
+ * create_artifact · synthetic toolChoice bypass. Code-fence promotion and `<artifact>`
+ * tags in the text are adapter-side (they need the core parser); the raw / XML
+ * artifact modes and the multi-phase pipeline were removed (audit 2026-08-28, D2).
  */
 /**
  * Token usage. Structurally a superset-compatible mirror of `AparteUsage`: the
@@ -44,7 +44,7 @@ export interface StreamToolCall {
      * `unknown` looked safer — the loop does not read tool input, it forwards it —
      * but the seam needs assignability in BOTH directions (`transportCall` is
      * contravariant), and `unknown` is not assignable to `Record<string, unknown>`.
-     * Locked to core's shape by `stream-events.contract.ts`.
+     * Core's composition compiles against it.
      */
     input: Record<string, unknown>;
 }
@@ -73,7 +73,7 @@ export type StreamChatEvent = {
  * The loop forwards the inventory to the transport and reads `maxTurns` and
  * `needsApproval` from its own lookup — it never interprets the schema. Mirrored
  * exactly all the same, because the seam needs assignability in both directions;
- * `stream-events.contract.ts` locks it.
+ * core's composition compiles against it.
  */
 export interface StreamTool {
     name: string;
@@ -90,9 +90,9 @@ export interface StreamTool {
  * file: engine stays zero-import at runtime. Mirrored EXACTLY rather than
  * loosened to `unknown[]`, which was the first attempt: `transportCall` is
  * contravariant, so the message type has to be assignable to core's AND core's to
- * it, and `unknown[]` fails the second direction. `stream-events.contract.ts`
- * asserts the equality, so a part added on either side is a typecheck error
- * rather than a silent divergence.
+ * it, and `unknown[]` fails the second direction. Core compiles
+ * `streamRunner: runStreamAgent`, so a part added on one side and not the other is
+ * a typecheck error there rather than a silent divergence.
  *
  * The loop never looks inside content — it carries messages to the transport and
  * appends results. This exists to make the seam type-check, not to be read.
@@ -125,7 +125,7 @@ export type StreamContentPart = StreamTextPart | StreamImagePart | StreamFilePar
  * chain that stopped `streamRunner: runStreamAgent` from compiling.
  *
  * Mirrored structurally rather than imported, to keep this package zero-import at
- * runtime; `stream-events.contract.ts` asserts the two line up.
+ * runtime; core, which depends on this package, compiles the two against each other.
  */
 export interface StreamAgentMessage {
     role: 'user' | 'assistant' | 'system' | 'tool_call' | 'tool_result';
@@ -159,7 +159,7 @@ export interface StreamAgentMessage {
  * because TypeScript only excess-property-checks object literals.
  *
  * Types kept structural (not imported from core) so this package stays
- * zero-import at runtime; `stream-events.contract.ts` asserts they line up.
+ * zero-import at runtime; core's composition compiles the two against each other.
  */
 export interface StreamChatRequest {
     messages: StreamAgentMessage[];
@@ -170,7 +170,7 @@ export interface StreamChatRequest {
      * un-assignable — from the opposite direction to the `messages` mismatch.
      */
     modelId: string;
-    /** Per-turn hints the loop branches on (pipeline phases, artifact modes, …). */
+    /** Per-turn hints carried through for the adapter (`artifactHint`, `prefixSegments`); the loop reads none. */
     _meta?: Record<string, unknown>;
     /** `'none'` makes the loop drop the tool inventory for that turn. */
     toolChoice?: 'auto' | 'none' | {
@@ -203,11 +203,11 @@ export type StreamApprovalResolver = (call: {
     instruction?: string;
 }>;
 /**
- * High-level, DOM-free events isomorphic to `_streamLoop`'s `targetElement.*`
+ * High-level, DOM-free events isomorphic to the inline loop's `targetElement.*`
  * call sequence. Emitted **synchronously and in order** (see {@link StreamRunEmitter})
  * so the adapter reproduces the exact streaming update order.
  *
- * Mapping to `_streamLoop` (aparte-client.ts) for the adapter:
+ * Mapping to the inline loop it replaced, for the adapter:
  * - `run-start`       → updateMessage(status:'streaming') once at loop entry (the leading write before turn 1)
  * - `turn-start`      → reset the per-turn parser / thinking / streaming-segment state (no DOM); one per turn
  * - `text-delta`      → parser-driven addSegment/updateSegment, else typeName/updateLastMessage
@@ -223,8 +223,6 @@ export type StreamApprovalResolver = (call: {
  * - `tool-aborted`    → updateSegment('aborted') (no-handler path, timeout/abort path, or per-tool maxTurns path)
  * - `turn-limit-exceeded` scope:'global' → addSegment(error 'MAX_TURNS_EXCEEDED');
  *                         scope:'tool'   → updateSegment('aborted')
- * - `phase-advance`   → addSegment({type:'pipeline-waiting'}); the loop has already
- *                       pushed the phase's reply into history and bumped the phase index
  * - `run-aborted`     → dispatch `aparte-message-aborted` (from the inner-loop abort check or the outer turn-boundary abort check)
  * - `run-done`        → updateMessage(status:'completed') always + setUsage if usage
  */
@@ -235,27 +233,11 @@ export type StreamRunEvent = {
 } | {
     type: 'text-delta';
     delta: string;
-    reduced?: boolean;
 } | {
     type: 'text-flush';
 } | {
     type: 'thinking-delta';
     delta: string;
-} | {
-    type: 'artifact-open';
-    id: string;
-    mimeType: string;
-    kind: string;
-    title: string;
-} | {
-    type: 'artifact-chunk';
-    id: string;
-    content: string;
-} | {
-    type: 'artifact-close';
-    id: string;
-    content: string;
-    inline: boolean;
 } | {
     type: 'artifact-ready';
     id: string;
@@ -292,9 +274,6 @@ export type StreamRunEvent = {
     scope: 'global' | 'tool';
     limit: number;
     toolCallId?: string;
-} | {
-    type: 'phase-advance';
-    index: number;
 } | {
     type: 'run-aborted';
 } | {

package/dist/agent/stream-events.d.ts.map

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

package/dist/agent/stream-run.d.ts

@@ -1,17 +1,23 @@
 /**
  * stream-run.ts — framework-free structured-stream agent loop.
  *
- * The headless extraction of `AparteClient._streamLoop`: a `while(tool_use)` loop
+ * The agent loop — extracted from core's inline `_streamLoop`, which it has since
+ * replaced (audit 2026-08-28, D1): a `while(tool_use)` loop
  * that consumes a structured `AsyncIterable<StreamChatEvent>` from a transport,
  * runs approved tools, feeds their results back into the history, and re-calls
  * the transport until the model stops asking for tools. It performs **no DOM
- * work** — it emits {@link StreamRunEvent}s (in `_streamLoop`'s exact order) that
+ * work** — it emits {@link StreamRunEvent}s (in the inline loop's exact order) that
  * an adapter in `@aparte/core` turns into `targetElement.*` calls.
  *
- * Parity target: `@aparte/core`'s `AparteClient._streamLoop`.
- * Scope: text · thinking · tool_use (+ HITL) · done · error · artifacts (raw /
- * XML / create_artifact) · multi-phase pipeline · synthetic toolChoice bypass.
- * Code-fence promotion stays adapter-side (it needs the core parser).
+ * Formerly the parity target of core's inline loop; now the one loop, its call
+ * sequences pinned by core's `stream-parity` snapshots.
+ * Scope: text · thinking · tool_use (+ HITL) · done · error · the built-in
+ * create_artifact · synthetic toolChoice bypass. Code-fence promotion stays
+ * adapter-side (it needs the core parser), and so do `<artifact>` tags in the
+ * text: the core parser reads them natively. The raw / XML artifact modes and the
+ * multi-phase pipeline were removed (audit 2026-08-28, D2) — orchestration is the
+ * product's, and a mode nothing in this repository emitted was a contract
+ * maintained for nobody.
  */
 import type { StreamRunEmitter, StreamChatEvent, StreamChatRequest, StreamAgentMessage, StreamToolHandler, StreamToolConfig, StreamApprovalResolver, StreamUsage } from './stream-events.js';
 export interface StreamRunOptions {
@@ -53,6 +59,12 @@ export interface StreamRunOptions {
      * `request.messages` — and mirrors these notifications into its append-only
      * log, instead of reimplementing the loop's tool bookkeeping. Synchronous and
      * ordered, like {@link emitter}.
+     *
+     * One rule about the envelope: a turn's `tool_call` message is reported ONCE, when
+     * its first call completes, and the calls that complete later in the same turn are
+     * already in that same object's `toolCalls` — the array is shared by reference, not
+     * copied. Hold the reference, not a snapshot, and every result you receive after it
+     * is declared by it.
      */
     onHistoryAppend?: (message: StreamAgentMessage) => void;
     /**

package/dist/agent/stream-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-run.d.ts","sourceRoot":"","sources":["../../src/agent/stream-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAElB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACd,MAAM,oBAAoB,CAAC;AAmB5B,MAAM,WAAW,gBAAgB;IAC7B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,WAAW,EAAE,iBAAiB,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,CAAC;IAChG,uFAAuF;IACvF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAC5D,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAClE,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAid7F"}
+{"version":3,"file":"stream-run.d.ts","sourceRoot":"","sources":["../../src/agent/stream-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAElB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACd,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,gBAAgB;IAC7B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,WAAW,EAAE,iBAAiB,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,CAAC;IAChG,uFAAuF;IACvF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAC5D,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAClE,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA0Y7F"}

package/dist/conversation/selector.d.ts

@@ -0,0 +1,78 @@
+/**
+ * conversation/selector.ts — the budget-aware `compactionSelector` for `AparteClient`.
+ *
+ * `AparteClient.compact()` decides what to summarise through one function:
+ * `(messages) => { keep, drop }`. Its default drops everything — summarise all,
+ * replace all. This is the other half the seam was written for: the newest turns
+ * that still fit the history budget stay verbatim, the older ones are summarised.
+ *
+ * The budget is the compactor's (`computeHistoryBudget` + `splitHistoryBudget`), so
+ * the gauge a page shows, the selector `compact()` uses and the window the model
+ * declares all speak the same numbers. The budget is closed over here by the
+ * consumer — the window is theirs to know, the client's to never guess.
+ */
+import { type CompactionConfig } from './compactor.js';
+/**
+ * The least a message must carry to be costed: its text, or segments with text.
+ * Structural on purpose — this package imports nothing from core — and core's
+ * `AparteMessage` satisfies it, which is what makes the selector below exactly the
+ * `compactionSelector` `AparteClient` takes.
+ */
+export interface CompactableMessage {
+    content?: string;
+    /**
+     * `unknown` elements, read defensively below: core's segment union includes a
+     * segment with no `content` at all, and TypeScript refuses a type with no property
+     * in common with the all-optional `{ content?: unknown }` (a "weak type"), so that
+     * tighter shape made `AparteMessage` unassignable here.
+     */
+    segments?: ReadonlyArray<unknown>;
+}
+/** What `compact()` asks for: the messages kept verbatim and the ones to summarise. */
+export interface CompactionSelection<M> {
+    keep: M[];
+    drop: M[];
+}
+/**
+ * The selector itself — generic in the MESSAGE type, so it is assignable to core's
+ * `AparteCompactionSelector` (messages of `AparteMessage`) without importing it. The
+ * generic sits on the returned function, not on the factory: a factory-level `<M>`
+ * has no inference site at `createCompactionSelector({...})` and falls back to the
+ * bare `CompactableMessage`, which is not what the client's option type wants back.
+ */
+export type CompactionSelector = <M extends CompactableMessage>(messages: M[]) => CompactionSelection<M>;
+export interface CompactionSelectorOptions {
+    /**
+     * The active model's context window, in tokens — a number, or a getter read at
+     * each call so a model change is picked up (`() => aparteGlobalConfig.getCurrentModel()?.contextWindow`).
+     * Unknown (`undefined`) means nothing is dropped: without a window there is no
+     * budget to be over.
+     */
+    contextWindow: number | (() => number | undefined);
+    /** The system prompt the request carries, for the budget. A string or a getter. Default none. */
+    systemPrompt?: string | (() => string | null | undefined);
+    /** The tools declared to the model, for the budget. A value or a getter. Default none. */
+    tools?: unknown | (() => unknown);
+    /** Partial override of the compactor's config — reserves, ratios, floors. */
+    config?: Partial<Omit<CompactionConfig, 'contextWindow'>>;
+    /** Never summarise fewer than this many of the newest messages. Default 2 — the last exchange. */
+    minKeep?: number;
+}
+/**
+ * Build the selector. Give it to the client:
+ *
+ * ```ts
+ * new AparteClient({
+ *   compactionSelector: createCompactionSelector({
+ *     contextWindow: () => aparteGlobalConfig.getCurrentModel()?.contextWindow,
+ *     systemPrompt: () => aparteGlobalConfig.resolveSystemPrompt(),
+ *   }),
+ * });
+ * ```
+ *
+ * Walks the history from the newest message: what fits the sliding window's budget
+ * is kept verbatim, the rest is dropped for summarising. When everything fits,
+ * `drop` is empty and `compact()` reports `{ skipped: true }` — nothing to do.
+ */
+export declare function createCompactionSelector(options: CompactionSelectorOptions): CompactionSelector;
+//# sourceMappingURL=selector.d.ts.map

package/dist/conversation/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/conversation/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAA4D,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjH;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,uFAAuF;AACvF,MAAM,WAAW,mBAAmB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,CAAC,EAAE,CAAC;CACb;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,SAAS,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAEzG,MAAM,WAAW,yBAAyB;IACtC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC1D,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1D,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAyB/F"}

package/dist/index.d.ts

@@ -3,9 +3,9 @@
  *
  * Zero runtime dependencies, no DOM: usable from any in-browser or Node AI-chat app.
  * The headline export is `runStreamAgent`, the headless extraction of
- * `AparteClient._streamLoop` — inject it via core's `streamRunner` seam and core
- * renders its events through `createStreamAdapter`. Parity between the two is proven
- * by the stream-parity suite.
+ * core's inline loop, which it has since replaced — `AparteClient` runs it by default, and core
+ * renders its events through `createStreamAdapter`. Its call sequences are pinned by
+ * core's `stream-parity` snapshots, recorded while the inline loop still ran beside it.
  *
  * Deliberately just the loop core drives, plus the agnostic context compactor. Opt-in
  * *tools* (ask-user / RAG / skills / code) belong in `plugins/*`; product behaviour
@@ -13,7 +13,8 @@
  */
 export * from './agent/stream-events.js';
 export * from './agent/stream-run.js';
-export { ArtifactXmlStateMachine } from './agent/parsers/artifact-xml-state-machine.js';
-export type { XmlArtifactEvent, XmlArtifactHint, XmlArtifactState } from './agent/parsers/artifact-xml-state-machine.js';
+export { deriveArtifactKind } from './agent/parsers/artifact-kind.js';
 export * from './conversation/compactor.js';
+export { createCompactionSelector } from './conversation/selector.js';
+export type { CompactionSelectorOptions, CompactableMessage, CompactionSelection, CompactionSelector } from './conversation/selector.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AAYtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAGzH,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AAMtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}