@aparte/core 0.15.0 → 0.16.0

package/dist/types/models.d.ts

@@ -114,9 +114,8 @@ export interface AparteBubbleActionsConfig {
  * aparteGlobalConfig.setHostHandlers({ attachmentPreview: true });   // you open a lightbox
  * ```
  *
- * These are declarations, not callbacks: the events (`aparte-attachment-preview`,
- * `aparte-artifact-redownload`) are unchanged, and you keep
- * listening for them wherever you already do.
+ * These are declarations, not callbacks: the event (`aparte-attachment-preview`)
+ * is unchanged, and you keep listening for it wherever you already do.
  */
 export interface AparteHostHandlersConfig {
     /**
@@ -125,34 +124,6 @@ export interface AparteHostHandlersConfig {
      * tile is inert and is not signalled as a button. Default: false
      */
     attachmentPreview?: boolean;
-    /**
-     * The download button on a **binary** artifact, which asks the app to
-     * re-generate the file (`aparte-artifact-redownload`). Text artifacts keep
-     * their button: core writes those out itself. Default: false
-     */
-    artifactRedownload?: boolean;
-    /**
-     * Re-running the generation of a **persisted binary artifact** when a saved
-     * conversation is re-opened (`aparte-artifact-ready`, dispatched from
-     * `setup()` rather than from a stream). Default: false
-     *
-     * Why this is off unless declared, and why it is separate from
-     * `artifactRedownload`: that flag guards a BUTTON, and a button is a request.
-     * This guards an automatic dispatch on mount — nobody asked for it, and the
-     * payload is model-authored content the receiving app is expected to run in a
-     * sandbox. Reloading a conversation would therefore re-execute whatever a
-     * prompt injection had persuaded the model to emit, on every reload, forever.
-     *
-     * Core cannot honour it end to end either: it owns no sandbox and no file
-     * generator, so a dispatch with nothing listening leaves the card stuck at
-     * "generating" — the same reasoning that made the artifact preview require a
-     * click. Declare it when your app really does listen for
-     * `aparte-artifact-ready` and can regenerate the file safely.
-     *
-     * Not affected: the dispatch at the END of a live stream, which follows a turn
-     * the user asked for. This flag is only about mount-time rehydration.
-     */
-    artifactRehydrate?: boolean;
 }
 /**
  * Core message structure for the chat
@@ -183,6 +154,15 @@ export interface AparteMessage {
     attachments?: AparteAttachment[];
     /** Token usage + timing reported by the provider for assistant messages. */
     usage?: import('./chat.js').AparteUsage;
+    /**
+     * This message is the summary `@aparte/plugin-compaction` injected in place of the
+     * turns it summarised (a host that summarises by other means sets the flag too). Its role is `user` — the summary is context handed to the
+     * model, and a `system` message mid-conversation is refused by some providers —
+     * but it is not something the user said: the viewport renders it as a notice
+     * (`data-kind="compaction"` on the bubble: centred, no avatar, no actions) and
+     * the history sends it under a fixed preamble saying what it is.
+     */
+    compaction?: true;
     /**
      * Alternative responses generated by retrying.
      *

package/dist/types/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAMhG,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,CAAC;AAMpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IAEX,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACf;AAUD;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAChC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,oBAAoB;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAElG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,yBAAyB;IACtC,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qGAAqG;IACrG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,IAAI,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAChC,gHAAgH;IAChH,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IAEX,iCAAiC;IACjC,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAE3B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,WAAW,EAAE,WAAW,CAAC;IAExC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAC9B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/segments.d.ts

@@ -176,11 +176,14 @@ export interface AparteToolCallSegment extends AparteSegmentBase {
     type: 'tool_call';
     toolCall: import('./tools.js').AparteToolCall;
     /**
-     * `awaiting-approval` — paused for a human decision (needsApproval tools);
-     * `rejected` — the human declined to run it.
+     * `awaiting-approval` — paused for a human decision; `rejected` — the human (or a
+     * policy) declined to run it; `aborted` — stopped, timed out, or nothing could run
+     * it; `failed` — the handler threw, and `result` carries the crash's one line.
      */
-    status: 'pending' | 'resolved' | 'aborted' | 'awaiting-approval' | 'rejected';
+    status: 'pending' | 'resolved' | 'aborted' | 'awaiting-approval' | 'rejected' | 'failed';
     result?: string;
+    /** The handler's `structuredContent`, when it returned one — the value behind `result`'s prose. */
+    structuredResult?: unknown;
 }
 /**
  * Custom segment - for framework-specific views (Onboarding, Tools, etc.)
@@ -206,51 +209,12 @@ export interface AparteCustomSegment extends AparteSegmentBase {
     fallback?: string;
 }
 /**
- * Artifact segment — a structured payload (React/HTML/SVG/JS/CSS, etc.) embedded in the
- * assistant's reply. The payload is delimited in the stream by `<artifact type="...">…</artifact>`.
- *
- * The core only models the data and emits lifecycle events (`aparte-artifact-start|delta|ready`).
- * Apps decide how to render the rich preview (typically a side panel with an iframe/code view).
- *
- * `mimeType` follows standard MIME conventions, with the Anthropic vendor namespace for
- * framework-specific kinds:
- *   - `application/vnd.ant.react` (or `application/vnd.ant.html`, etc.)
- *   - `text/html`, `text/css`, `application/javascript`
- *   - `image/svg+xml`
- *
- * @example
- * {
- *   id: 's1',
- *   type: 'artifact',
- *   mimeType: 'image/svg+xml',
- *   artifactType: 'svg',
- *   title: 'Brass mark',
- *   content: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><circle cx="24" cy="24" r="18" fill="#d9a24b"/></svg>',
- * }
+ * All built-in segment types. An `artifact` is not one of them any more: it is a
+ * convention an app teaches its model, and `@aparte/plugin-artifacts` registers its
+ * segment — a `type` of its own, through `registerSegmentRenderer` and
+ * `registerStreamBlock` — the way any consumer registers a `chart` or a `citation`.
  */
-export interface AparteArtifactSegment extends AparteSegmentBase {
-    type: 'artifact';
-    /** Standard MIME type (verbatim from the `type="…"` attribute on the opening tag) */
-    mimeType: string;
-    /**
-     * Short kind identifier derived from `mimeType` (e.g. 'react', 'html', 'svg').
-     * Convenience for UIs that want to switch on a stable enum-like string.
-     */
-    artifactType: string;
-    /** Optional human title (from the `title="…"` attribute on the opening tag) */
-    title?: string;
-    /** Body content between the opening and closing tag — accumulates while streaming. */
-    content: string;
-    /**
-     * When true, the renderer displays the artifact inline as a code block
-     * instead of a clickable pill that opens the side panel.
-     * Set by the client after the stream ends, based on content line count.
-     * Defaults to false (pill) while streaming.
-     */
-    inline?: boolean;
-}
-/** All built-in segment types */
-export type AparteSegment = AparteTextSegment | AparteThinkingSegment | AparteCodeSegment | AparteErrorSegment | AparteCustomSegment | AparteToolCallSegment | AparteArtifactSegment;
+export type AparteSegment = AparteTextSegment | AparteThinkingSegment | AparteCodeSegment | AparteErrorSegment | AparteCustomSegment | AparteToolCallSegment;
 /** Segment type discriminator values */
 export type AparteSegmentType = AparteSegment['type'];
 /**

package/dist/types/segments.d.ts.map

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

package/dist/types/stream-blocks.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Stream blocks — a tagged block the stream parser learns from a consumer.
+ *
+ * Models write conventions into their prose: `<think>…</think>` for reasoning,
+ * `<artifact type="…">…</artifact>` for a document, `<file path="…">` for a patch,
+ * `<tool_call>` for a model without function calling, `<cite>` for a source. Every one
+ * is the same shape — an opening tag with attributes, a body that streams, a closing
+ * tag — and until this seam existed each one was a branch hard-wired into the parser,
+ * which is how the artifact ended up in core while being an app convention.
+ *
+ * A block is registered on the config (`registerStreamBlock`) and read by the
+ * parser the stream adapter builds; the parser does the streaming work once for all
+ * of them — the earliest opening tag wins the race against a code fence and a
+ * reasoning delimiter, a tag cut at a chunk boundary is held back, attributes are
+ * parsed whether quoted or bare, deltas accumulate into the segment's `content`,
+ * and the segment is closed at the closing tag or at `finalize()`.
+ *
+ * @packageDocumentation
+ */
+import type { AparteSegmentBase } from './segments.js';
+/** What the parser hands to {@link AparteStreamBlock.toSegment} when a block opens. */
+export interface AparteStreamBlockMatch {
+    /**
+     * The opening tag's attributes, as written: `type="text/html"`, `title='Notes'`
+     * and `lang=fr` all parse; the values are verbatim, never trimmed or decoded.
+     * The model wrote them — treat them as untrusted, like every segment field.
+     */
+    attrs: Record<string, string>;
+    /** The id the parser generated for the segment (its usual prefix + uuid). */
+    id: string;
+}
+/**
+ * A block grammar: the tag, and the segment its body becomes.
+ *
+ * The parser owns everything after {@link toSegment} returns: it appends each delta
+ * to `segment.content`, sets `isStreaming` while the block is open and clears it at
+ * `</tag>` (or at the end of the stream). So the segment MUST carry a `content`
+ * string — the one field core touches — and the rest of its shape is yours:
+ * a `type` of your own, registered with `registerSegmentRenderer`, or a built-in
+ * one if the block is merely another way of spelling it.
+ */
+export interface AparteStreamBlock {
+    /**
+     * The tag name without brackets: `artifact` recognises `<artifact …>` … `</artifact>`.
+     * Matched exactly and case-sensitively, and only as a whole name — `<artifacts>`
+     * does not open an `artifact` block. Letters, digits, `-` and `_`.
+     */
+    tag: string;
+    /**
+     * Build the segment at the opening tag, with an empty `content`. Called once per
+     * block; the parser fills the body in afterwards.
+     */
+    toSegment: (match: AparteStreamBlockMatch) => AparteSegmentBase & {
+        content: string;
+    };
+}
+//# sourceMappingURL=stream-blocks.d.ts.map

package/dist/types/stream-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-blocks.d.ts","sourceRoot":"","sources":["../../src/types/stream-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,iBAAiB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACzF"}

package/dist/types/tools.d.ts

@@ -63,10 +63,44 @@ export interface AparteToolCall {
     name: string;
     input: Record<string, unknown>;
 }
+/**
+ * What an approval policy says about one call.
+ *
+ * `allow` runs it without asking; `ask` puts it to the person the way a
+ * `needsApproval` tool is put to them; `deny` refuses it on the spot, and `reason` is
+ * the sentence the model reads about that refusal — verbatim, because nobody said
+ * anything ("Plan mode: `write_file` changes files; only read-only tools run.").
+ */
+export interface AparteApprovalRuling {
+    verdict: 'allow' | 'ask' | 'deny';
+    reason?: string;
+}
+/**
+ * Decides, per CALL, whether a tool runs, asks, or is refused.
+ *
+ * A tool's own `needsApproval` is a declaration about the tool; a policy is a decision
+ * about the call — the same `run_command` can be a read (`ls`) or an execution, and a
+ * mode ("plan": read-only, "auto": never ask) is a policy the host switches, not a
+ * flag on twenty definitions. Registered with `setApprovalPolicy()`; the client's
+ * default approval channel consults it before asking. Return `undefined` to have no
+ * opinion, in which case the tool's `needsApproval` decides as before.
+ *
+ * Pure and synchronous: it is evaluated once to decide whether the call pauses at all
+ * (so an allowed call never flashes "awaiting approval") and once to answer.
+ */
+export type AparteApprovalPolicy = (call: AparteToolCall, tool: AparteTool | undefined) => AparteApprovalRuling | undefined;
 /** Result returned after a tool handler resolves */
 export interface AparteToolResult {
     toolCallId: string;
+    /** What the model reads. */
     content: string;
+    /**
+     * The same result as a value, for a renderer or the host — MCP's name for exactly
+     * this field, beside `content`. Optional and additive: a handler that returns prose
+     * alone behaves as before, and the model never sees this. It lands on the
+     * transcript's segment as `AparteToolCallSegment.structuredResult`.
+     */
+    structuredContent?: unknown;
 }
 /**
  * Handler function for a registered tool.
@@ -138,10 +172,33 @@ export interface AparteToolRenderer {
      *
      * Return an empty string to render nothing (e.g. a UI-only tool like
      * `ask_user`).
+     *
+     * The root you return is the segment's element in the bubble: core stamps
+     * `data-segment-id="<segment.id>"` on it if you did not, so an update to the
+     * call (its result landing, an approval decision) is patched into that element
+     * rather than rebuilding every segment of the bubble — a rebuild destroys a
+     * mounted artifact preview, collapses an opened reasoning block and drops the
+     * focus. Keep your markup's root a single element for that reason.
      */
     render: (segment: AparteToolCallSegment) => string | HTMLElement;
     /** Optional DOM setup (event listeners etc.) called after HTML is injected */
     setup?: (element: HTMLElement, segment: AparteToolCallSegment) => void;
+    /**
+     * Patch the element in place when the call changes — its result landing, an
+     * approval decided, a `failed` status. Without it core rebuilds your markup from
+     * `render()` on every change, which is right for a receipt and wrong for anything
+     * with state: a mounted preview, an opened disclosure, a focused control are all
+     * lost in a rebuild. Same contract as `AparteSegmentRenderer.update`: never
+     * re-render, never touch what the reader opened.
+     */
+    update?: (element: HTMLElement, segment: AparteToolCallSegment) => void;
+    /**
+     * Re-read the locale and the icon provider without touching the DOM shape —
+     * called on every config change (`setLocale`, `setIconProvider`, `reset()`), for
+     * as long as the element is on the page. Add or remove no child node; replace
+     * text and glyphs only.
+     */
+    relabel?: (element: HTMLElement, segment: AparteToolCallSegment) => void;
     /** Optional CSS to inject once into document.head */
     getStyles?: () => string;
 }

package/dist/types/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,8GAA8G;IAC9G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,+BAA+B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC5B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,KAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,GAAG,WAAW,CAAC;IACjE,8EAA8E;IAC9E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvE,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,8GAA8G;IAC9G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,+BAA+B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAC/B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,GAAG,SAAS,KAC3B,oBAAoB,GAAG,SAAS,CAAC;AAEtC,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC5B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,KAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,GAAG,WAAW,CAAC;IACjE,8EAA8E;IAC9E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACvE;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACxE;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACzE,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B"}

package/dist/utils/copy-text.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copy text to the clipboard, in every context the library actually runs in.
+ *
+ * `navigator.clipboard` is **secure-context only** — the same wall `uuid.ts` documents
+ * for `crypto.randomUUID`. On `http://192.168.1.x`, the archetypal deployment for this
+ * library's own audience, the property is `undefined`, so
+ * `navigator.clipboard.writeText(text)` throws a TypeError synchronously — before any
+ * `.catch()` can see it. The three copy buttons core renders (the bubble's action bar, a
+ * code block, the artifact card) each had a `.catch()` for a REJECTED write and nothing
+ * for a missing API: on plain http they threw in the click handler and gave no feedback
+ * at all, not even a failed one.
+ *
+ * The fallback is `document.execCommand('copy')` — deprecated, but every engine still
+ * honours it from a user gesture and it needs no secure context. The text goes into an
+ * off-screen textarea, is selected, copied, and the textarea is removed; focus is handed
+ * back to where it was, so a keyboard user does not lose their place on the button. It is
+ * the path clipboard.js and copy-to-clipboard take, for the same reason.
+ *
+ * Rejects when neither path could copy, so a caller's "copied" confirmation can stay
+ * honest. `pnpm check:secure-context` refuses a bare `navigator.clipboard` anywhere but
+ * here, so the sweep cannot come undone one call site at a time.
+ */
+export declare function copyText(text: string): Promise<void>;
+//# sourceMappingURL=copy-text.d.ts.map

package/dist/utils/copy-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-text.d.ts","sourceRoot":"","sources":["../../src/utils/copy-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpD"}

package/dist/utils/css-escape.d.ts

@@ -10,6 +10,11 @@
  * defense-in-depth: a hostile, stream-supplied id containing `"` (e.g. a tool-call
  * id) can no longer break out of the selector into a `SyntaxError` or a
  * selector-list that mis-targets another element.
+ *
+ * A raw newline (or CR / form feed) is not allowed inside a CSS string either — it
+ * ends the string and the selector throws the same `SyntaxError`. Escaped as its
+ * code point followed by a space, the form the CSS Syntax spec gives for exactly
+ * this (`\a `), so an id a provider minted with a line break still matches.
  */
 export declare function cssEscape(value: string): string;
 //# sourceMappingURL=css-escape.d.ts.map

package/dist/utils/css-escape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-escape.d.ts","sourceRoot":"","sources":["../../src/utils/css-escape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}
+{"version":3,"file":"css-escape.d.ts","sourceRoot":"","sources":["../../src/utils/css-escape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/C"}

package/dist/utils/tool-input.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A tool call's arguments, as text — one implementation, two surfaces.
+ *
+ * The transcript row and the approval panel both show the arguments the model chose,
+ * and they must show the SAME text: the row is the anchor that says a call is waiting,
+ * the panel is where the person decides. Two renderings of one value drift, and here
+ * the drift would be a person approving a call they read differently from the one that
+ * runs. So it is a function in `utils/`, not a copy in each renderer.
+ *
+ * Pretty-printed JSON, because that is what the model actually sent and what every
+ * reference implementation shows — a prose summary would be core inventing a reading
+ * of arguments it knows nothing about. `JSON.stringify` can throw on a cyclic value,
+ * which a tool input should never be but a hand-built segment can be, so a failure
+ * degrades to no input rather than to a broken bubble.
+ *
+ * The return is TEXT and never markup: both call sites put it on screen through
+ * `textContent` or an escaped interpolation, because the arguments are model-authored.
+ */
+export declare function describeToolInput(input: unknown): string;
+//# sourceMappingURL=tool-input.d.ts.map

package/dist/utils/tool-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-input.d.ts","sourceRoot":"","sources":["../../src/utils/tool-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aparte/core",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "AI chat in Web Components, with the agent loop inside — zero third-party dependencies",
   "type": "module",
   "//sideEffects": "The BROWSER entry defines the custom elements and imports CSS at module scope, so it must never be tree-shaken; the Node entry (`index.node`) and every other module are pure. Listing them explicitly is what lets a bundler drop the rest — the whole package was implicitly side-effectful before, the only one of the 14 without this field.",
@@ -13,7 +13,7 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "customElements": "dist/custom-elements.json",
-  "//exports": "READ THE ORDER: `@aparte-workspace/source` comes FIRST, but it only resolves for tooling configured with that custom condition (this repo's docs dev server + tsconfig.base). It is NOT what a consumer gets. Node resolves the `node` condition -> `dist/index.node.js`, the DOM-free entry; a bundler/browser gets `dist/index.js`. Reading `src/index.ts` because it sits at the top of this map means reading the BROWSER entry and concluding, wrongly, that the package needs a DOM in Node.",
+  "//exports": "READ THE ORDER: `@aparte-workspace/source` comes FIRST, but it only resolves for tooling configured with that custom condition (this repo's docs dev server + tsconfig.base). It is NOT what a consumer gets. Node resolves the `node` condition -> `dist/index.node.js`, the DOM-free entry; a bundler/browser gets `dist/index.js`. Reading `src/index.ts` because it sits at the top of this map means reading the BROWSER entry and concluding, wrongly, that the package needs a DOM in Node. `./browser` is the browser entry BY NAME, and the `.` map must keep resolving `node` first -- that is what makes `import @aparte/core` safe in Next.js, Nuxt, SvelteKit and Angular Universal. A test runner, though, is Node WITH a DOM (vitest + jsdom resolves the `node` condition), so it got the DOM-free entry, no <aparte-*> element upgraded, and there was no supported specifier to escape to: every wrapper in this repo had to alias @aparte/core at ../../core/src/index.ts, reaching into another package source. `./browser` is that specifier; do NOT reorder `.` instead. `./package.json` is exported because require.resolve(@aparte/core/package.json) throws without it, which is how a test config computes the path of a package it wants to alias.",
   "exports": {
     ".": {
       "@aparte-workspace/source": "./src/index.ts",
@@ -25,6 +25,13 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./browser": {
+      "@aparte-workspace/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
     "./icons": {
       "@aparte-workspace/source": "./src/icons.ts",
       "types": "./dist/icons.d.ts",
@@ -45,7 +52,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@aparte/engine": "0.15.0"
+    "@aparte/engine": "0.16.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",