@webskill/chatbot 0.0.2 → 0.2.0

package/README.md

@@ -76,27 +76,18 @@ probe (`pnpm test:install-smoke`), against the **published** `.d.ts`.
 <!-- typecheck: chatbot-minimal.tsx -->
 
 ```tsx
-import { Chatbot, type ChatbotHostAdapter, type LlmConfig } from '@webskill/chatbot';
+import { Chatbot, type ChatbotHostAdapter } from '@webskill/chatbot';
 import { OpfsProvider } from '@webskill/sdk/browser';
 import '@webskill/chatbot/chatbot.css';
 
-// ChatbotHostAdapter: wire storage, skill roots, an LLM config store, and a
-// navigation port (openConsole / openConsoleTrace). <Chatbot> constructs its own
-// ChatEngine from the adapter; pass config for options like generativeUi.
-let saved: LlmConfig | undefined;
-
+// ChatbotHostAdapter: wire storage, skill roots and a navigation port
+// (openConsole / openConsoleTrace). <Chatbot> constructs its own ChatEngine
+// from the adapter; pass config for options like generativeUi.
+// Model configuration lives in the runtime config store (config.runtimeConfig):
+// RuntimeConfig.llm.entries holds the model list, llm.defaultId the default one.
 const adapter: ChatbotHostAdapter = {
   storage: new OpfsProvider({ rootName: 'my-app' }),
   skillRoots: ['/skills'],
-  llmConfig: {
-    load: async () => saved,
-    save: async (config) => {
-      saved = config;
-    },
-    clear: async () => {
-      saved = undefined;
-    }
-  },
   navigation: {
     openConsole() {
       /* route to your console surface */
@@ -129,12 +120,32 @@ implementation (OPFS storage, skills, demo/model providers, console embedding).
 
 ## Stability
 
-- **`@stable`** — `Chatbot`, `ChatbotProps`, `ChatEngine` (public methods),
-  `CompositeUiBridge`, the i18n dictionary. Covered by semver from 0.1.0.
-- **`@experimental`** — A2UI/OpenUI/Vercel surface hosts and snapshot hosts,
-  `VercelPayloadPreview`, `configureA2uiMarkdown`, the `probe*` availability
-  helpers, `RendererKind` (renamed in 0.4.0), and the `RunSnapshot` format.
-  These may change between 0.0.x releases.
+Every public export carries a `@stable` or `@experimental` JSDoc tag. The tag is
+part of the checked-in API snapshot (`api-snapshots/chatbot/index.d.ts.snap`),
+so a symbol cannot be quietly downgraded — the change shows up in the diff.
+
+- **`@stable`** — covered by the semver contract from 0.1.0: bug fixes ship in a
+  patch, backwards-compatible capabilities in a minor, breaking changes only in
+  a major with release notes. This covers the surface you wire a host against:
+  `Chatbot`, `ChatEngine`, `ChatbotHostAdapter`, the message/event/session data
+  types, `CompositeUiBridge`, the layout, theme and i18n exports, and the shell
+  components (`InteractionCard`, `ResultBlocksPro`, `SettingsDrawer`, …).
+- **`@experimental`** — may change in a minor or patch release. Only three kinds
+  of symbol qualify, and each one is here for a stated reason:
+  - **Non-native renderer tiers** — the A2UI, OpenUI and Vercel surface hosts,
+    their snapshot variants, `VercelPayloadPreview`, `SpecInteraction`,
+    `configureA2uiMarkdown`, the `probe*` helpers, `RendererKind`,
+    `RendererCapability` and `DEFAULT_RENDERER_CAPABILITIES`. Their shape
+    tracks upstream ecosystems this package does not own.
+  - **Surfaces introduced in this release** — `ChatAttachmentInput` and
+    `ChatAttachmentMeta` (multimodal attachments), which no consumer has
+    exercised yet.
+  - **`RunSnapshot`** — the resume snapshot format, `@experimental` in
+    `@webskill/sdk` for the same reason.
+
+Anything a README example or the published-`.d.ts` consumer probe imports is
+`@stable` by rule: once we teach a call site, we stop calling it experimental.
+`pnpm lint` enforces that rule against this file.
 
 ## License
 

package/dist/chatbot.css

@@ -229,6 +229,9 @@
   .relative {
     position: relative;
   }
+  .static {
+    position: static;
+  }
   .inset-0 {
     inset: 0px;
   }
@@ -322,6 +325,9 @@
   .my-0 {
     margin-block: 0px;
   }
+  .my-1 {
+    margin-block: var(--spacing);
+  }
   .my-2 {
     margin-block: calc(var(--spacing) * 2);
   }
@@ -489,12 +495,18 @@
   .w-2\.5 {
     width: calc(var(--spacing) * 2.5);
   }
+  .w-3\.5 {
+    width: calc(var(--spacing) * 3.5);
+  }
   .w-5 {
     width: calc(var(--spacing) * 5);
   }
   .w-9 {
     width: calc(var(--spacing) * 9);
   }
+  .w-40 {
+    width: calc(var(--spacing) * 40);
+  }
   .w-72 {
     width: calc(var(--spacing) * 72);
   }
@@ -722,6 +734,9 @@
       border-color: color-mix(in oklab, var(--destructive) 25%, transparent);
     }
   }
+  .self-center {
+    align-self: center;
+  }
   .truncate {
     overflow: hidden;
     text-overflow: ellipsis;
@@ -871,6 +886,12 @@
   .bg-danger-soft {
     background-color: var(--destructive-soft);
   }
+  .bg-danger\/10 {
+    background-color: var(--destructive);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--destructive) 10%, transparent);
+    }
+  }
   .bg-destructive {
     background-color: var(--destructive);
   }
@@ -1033,6 +1054,9 @@
   .ps-9 {
     padding-inline-start: calc(var(--spacing) * 9);
   }
+  .pt-0\.5 {
+    padding-top: calc(var(--spacing) * 0.5);
+  }
   .pt-2 {
     padding-top: calc(var(--spacing) * 2);
   }
@@ -1051,6 +1075,9 @@
   .pr-8 {
     padding-right: calc(var(--spacing) * 8);
   }
+  .pb-1 {
+    padding-bottom: var(--spacing);
+  }
   .pb-3 {
     padding-bottom: calc(var(--spacing) * 3);
   }
@@ -1204,15 +1231,15 @@
     --tw-numeric-spacing: tabular-nums;
     font-variant-numeric: var(--tw-ordinal,) var(--tw-slashed-zero,) var(--tw-numeric-figure,) var(--tw-numeric-spacing,) var(--tw-numeric-fraction,);
   }
+  .line-through {
+    text-decoration-line: line-through;
+  }
   .underline {
     text-decoration-line: underline;
   }
   .underline-offset-4 {
     text-underline-offset: 4px;
   }
-  .accent-primary {
-    accent-color: var(--primary);
-  }
   .opacity-0 {
     opacity: 0%;
   }
@@ -1497,6 +1524,9 @@
       opacity: 85%;
     }
   }
+  .focus\:border-ring:focus {
+    border-color: var(--ring);
+  }
   .focus-visible\:border-ring:focus-visible {
     border-color: var(--ring);
   }