@agent-native/core 0.111.4 → 0.113.0

package/corpus/core/src/styles/chat-history-list.css

@@ -1,313 +1 @@
-/*
- * Shared chat history list — used by core's `HistoryPopover`
- * (MultiTabAssistantChat.tsx) and by Agent-Native Code's run rail
- * (code-agents-ui CodeAgentsApp.tsx). Stable, prefixed class names (not
- * Tailwind utilities) so the same visual language works in both a Tailwind
- * host (core/templates) and a plain-CSS host (code-agents-ui), matching the
- * approach used by agent-conversation.css. All colors resolve through the
- * shared `hsl(var(--token))` variables so light/dark both work in either
- * host's theme.
- *
- * Two density variants:
- *   .an-chat-history           default — compact popover list (core)
- *   .an-chat-history--rail     denser rail list with solid active state
- */
-
-.an-chat-history {
-  display: flex;
-  flex-direction: column;
-  min-height: 0;
-}
-
-.an-chat-history__search {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  padding: 8px 12px;
-  border-bottom: 1px solid hsl(var(--border));
-  color: hsl(var(--muted-foreground));
-  flex-shrink: 0;
-}
-
-.an-chat-history__search-icon {
-  flex-shrink: 0;
-}
-
-.an-chat-history__search-input {
-  flex: 1;
-  min-width: 0;
-  background: transparent;
-  border: 0;
-  outline: none;
-  font-size: 12px;
-  color: hsl(var(--foreground));
-}
-
-.an-chat-history__search-input::placeholder {
-  color: hsl(var(--muted-foreground));
-}
-
-.an-chat-history__list {
-  overflow-y: auto;
-  padding: 4px 0;
-  max-height: 16rem;
-}
-
-.an-chat-history--rail .an-chat-history__list {
-  max-height: none;
-  flex: 1;
-  min-height: 0;
-}
-
-.an-chat-history__state {
-  padding: 16px 12px;
-  text-align: center;
-  font-size: 12px;
-  color: hsl(var(--muted-foreground));
-}
-
-.an-chat-history__state--error {
-  /* Matches the amber-500 warning tone historically used for the
-     HistoryPopover load-error state (Tailwind's `text-amber-500`). */
-  color: hsl(38 92% 50%);
-}
-
-.an-chat-history__section-label {
-  padding: 6px 12px 4px;
-  font-size: 10px;
-  text-transform: uppercase;
-  letter-spacing: 0.04em;
-  color: hsl(var(--muted-foreground) / 0.7);
-}
-
-.an-chat-history--rail .an-chat-history__section {
-  display: grid;
-  gap: 1px;
-}
-
-/* ── Row ──────────────────────────────────────────────────────────────── */
-
-.an-chat-history-row {
-  position: relative;
-}
-
-.an-chat-history--rail .an-chat-history-row {
-  border-radius: calc(var(--radius) - 2px);
-  margin: 0 4px;
-}
-
-.an-chat-history-row__button {
-  display: block;
-  width: 100%;
-  padding: 8px 12px;
-  border: 0;
-  background: transparent;
-  color: inherit;
-  text-align: start;
-  cursor: pointer;
-}
-
-.an-chat-history-row--disabled .an-chat-history-row__button {
-  cursor: default;
-  opacity: 0.6;
-}
-
-.an-chat-history-row:hover .an-chat-history-row__button {
-  background: hsl(var(--accent) / 0.5);
-}
-
-.an-chat-history-row--active .an-chat-history-row__button {
-  background: hsl(var(--accent) / 0.3);
-}
-
-.an-chat-history--rail .an-chat-history-row__button {
-  min-height: 32px;
-  padding: 6px 36px 6px 10px;
-  border-radius: inherit;
-  color: hsl(var(--muted-foreground));
-}
-
-.an-chat-history--rail
-  .an-chat-history-row--active
-  .an-chat-history-row__button {
-  background: hsl(var(--accent));
-  color: hsl(var(--accent-foreground));
-}
-
-.an-chat-history-row__topline {
-  display: flex;
-  align-items: baseline;
-  justify-content: space-between;
-  gap: 8px;
-  min-width: 0;
-}
-
-.an-chat-history-row__title {
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-  font-size: 12px;
-  font-weight: 500;
-  color: hsl(var(--foreground));
-}
-
-.an-chat-history-row--active .an-chat-history-row__title {
-  color: hsl(var(--foreground));
-}
-
-.an-chat-history--rail
-  .an-chat-history-row--active
-  .an-chat-history-row__title {
-  color: hsl(var(--accent-foreground));
-}
-
-.an-chat-history--rail
-  .an-chat-history-row--pinned:not(.an-chat-history-row--active)
-  .an-chat-history-row__title {
-  color: hsl(var(--foreground));
-}
-
-.an-chat-history-row__timestamp {
-  flex-shrink: 0;
-  font-size: 10px;
-  color: hsl(var(--muted-foreground));
-}
-
-.an-chat-history--rail .an-chat-history-row__timestamp {
-  font-size: 11px;
-  color: hsl(var(--muted-foreground) / 0.62);
-}
-
-.an-chat-history--rail
-  .an-chat-history-row--active
-  .an-chat-history-row__timestamp {
-  color: hsl(var(--accent-foreground));
-}
-
-.an-chat-history-row__subtitle {
-  margin-top: 2px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-  font-size: 11px;
-  color: hsl(var(--muted-foreground));
-}
-
-.an-chat-history-row__detail {
-  margin-top: 2px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-  font-size: 10px;
-  color: hsl(var(--muted-foreground) / 0.7);
-}
-
-/* ── Inline rename ────────────────────────────────────────────────────── */
-
-.an-chat-history-row__rename {
-  display: flex;
-  align-items: center;
-  padding: 6px 12px;
-}
-
-.an-chat-history-row__rename-input {
-  width: 100%;
-  min-width: 0;
-  padding: 2px 6px;
-  border: 1px solid hsl(var(--ring));
-  border-radius: calc(var(--radius) - 3px);
-  background: hsl(var(--background));
-  color: hsl(var(--foreground));
-  font-size: 12px;
-  font-weight: 500;
-  line-height: 1.4;
-  outline: none;
-  box-shadow: 0 0 0 2px hsl(var(--ring) / 0.25);
-}
-
-.an-chat-history-row__rename-input:focus {
-  box-shadow: 0 0 0 2px hsl(var(--ring) / 0.35);
-}
-
-/* ── Row action menu ──────────────────────────────────────────────────── */
-
-.an-chat-history-row__menu {
-  position: absolute;
-  top: 4px;
-  inset-inline-end: 4px;
-}
-
-.an-chat-history-row__menu-trigger {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 24px;
-  height: 24px;
-  border: 0;
-  border-radius: calc(var(--radius) - 3px);
-  background: transparent;
-  color: hsl(var(--muted-foreground) / 0.72);
-  opacity: 0;
-  cursor: pointer;
-  transition:
-    background 100ms ease,
-    color 100ms ease,
-    opacity 100ms ease;
-}
-
-.an-chat-history-row:hover .an-chat-history-row__menu-trigger,
-.an-chat-history-row:focus-within .an-chat-history-row__menu-trigger,
-.an-chat-history-row__menu-trigger[aria-expanded="true"],
-.an-chat-history-row__menu-trigger--pinned {
-  opacity: 1;
-}
-
-.an-chat-history-row__menu-trigger:hover,
-.an-chat-history-row__menu-trigger[aria-expanded="true"] {
-  background: hsl(var(--accent));
-  color: hsl(var(--foreground));
-}
-
-.an-chat-history-row__menu-content {
-  position: absolute;
-  top: calc(100% + 4px);
-  inset-inline-end: 0;
-  z-index: 30;
-  min-width: 160px;
-  padding: 4px;
-  border: 1px solid hsl(var(--border));
-  border-radius: var(--radius);
-  background: hsl(var(--popover));
-  color: hsl(var(--popover-foreground));
-  box-shadow: 0 10px 30px hsl(var(--background) / 0.28);
-}
-
-.an-chat-history-row__menu-item {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  width: 100%;
-  padding: 6px 8px;
-  border: 0;
-  border-radius: calc(var(--radius) - 4px);
-  background: transparent;
-  color: inherit;
-  font-size: 12px;
-  text-align: start;
-  cursor: pointer;
-}
-
-.an-chat-history-row__menu-item:hover {
-  background: hsl(var(--accent));
-  color: hsl(var(--accent-foreground));
-}
-
-.an-chat-history-row__menu-item--danger {
-  color: hsl(var(--destructive));
-}
-
-.an-chat-history-row__menu-item--danger:hover {
-  background: hsl(var(--destructive) / 0.12);
-  color: hsl(var(--destructive));
-}
+@import "@agent-native/toolkit/chat-history.css";

package/corpus/core/src/templates/default/.agents/skills/actions/SKILL.md

@@ -121,18 +121,38 @@ action trio instead:
   provider host, injects configured credentials, blocks private/internal URLs,
   and redacts secrets.
 
-Use `@agent-native/core/provider-api` as the shared substrate. A template should
-only add a thin credential adapter when it has app-specific credential lookup
-rules. If the app stores a built-in provider's OAuth grant under a narrower
-local provider id, use the runtime's `oauthProviderOverrides` instead of
-duplicating the provider config. If credentials are stored on shareable/resource
-rows rather than in the shared credential or OAuth-token stores, build a resolver
-that enforces those access checks before exposing raw provider requests. Keep
-`provider-api-request` `http: false` unless you have a separate UI permission
-model for arbitrary provider writes. Specific actions such as `search-records`,
-`search-emails`, or `sync-source` are convenience shortcuts, not capability
-limits; agents should fall back to the provider API trio when a question
-requires an endpoint or filter that the shortcut does not model.
+Use `@agent-native/core/provider-api` as the shared substrate, and build these
+actions as thin factory imports rather than copying `defineAction` schemas and
+handlers into each template:
+
+```ts
+import {
+  createProviderApiCatalogAction,
+  createProviderApiDocsAction,
+  createProviderApiRequestAction,
+} from "@agent-native/core/provider-api/actions/provider-api";
+import {
+  createDeleteStagedDatasetAction,
+  createListStagedDatasetsAction,
+  createQueryStagedDatasetAction,
+} from "@agent-native/core/provider-api/actions/staged-datasets";
+```
+
+Pass the app's existing provider runtime to the provider factories, and pass
+its app id to the staged-dataset factories. Keep app-specific descriptions,
+provider allow-lists, HTTP/tool-callability settings, and credential adapters
+as factory options. Only add a thin credential adapter when the app has
+app-specific credential lookup rules. If the app stores a built-in provider's
+OAuth grant under a narrower local provider id, use the runtime's
+`oauthProviderOverrides` instead of duplicating provider config. If credentials
+are stored on shareable/resource rows rather than in the shared credential or
+OAuth-token stores, build a resolver that enforces those access checks before
+exposing raw provider requests. Keep `provider-api-request` `http: false`
+unless a separate UI permission model authorizes arbitrary provider writes.
+Specific actions such as `search-records`, `search-emails`, or `sync-source`
+are convenience shortcuts, not capability limits; agents should fall back to
+the provider API trio when a question requires an endpoint or filter that the
+shortcut does not model.
 
 This is a framework tenet. The safety boundary should be provider host
 allow-listing, credential scoping, auth injection, private-network blocking,

package/corpus/core/src/templates/default/.agents/skills/agent-native-docs/SKILL.md

@@ -37,6 +37,7 @@ pnpm action docs-search --slug <slug>
 pnpm action docs-search --list
 pnpm action source-search --query "<pattern>"
 pnpm action source-search --path templates/plan/AGENTS.md
+pnpm action source-search --path toolkit/src/index.ts
 pnpm action source-search --list
 ```
 
@@ -56,6 +57,13 @@ under `node_modules/@agent-native/core/docs/content/`. For source examples,
 read files under `node_modules/@agent-native/core/corpus/core/` or
 `node_modules/@agent-native/core/corpus/templates/`.
 
+Toolkit source is searchable at `toolkit/` in the Core corpus and also ships as
+readable TypeScript under `node_modules/@agent-native/toolkit/src/`. Read
+`customizing-agent-native` before copying a shared component: inspect package
+source as a read-only reference, copy only the smallest UI piece into app-owned
+source, and preserve public actions, application state, auth, and agent-chat
+runtime contracts. Never edit `node_modules` or deep-import its private source.
+
 ## Useful Slugs
 
 | Need | Slugs |
@@ -74,3 +82,5 @@ read files under `node_modules/@agent-native/core/corpus/core/` or
 - Do not add custom REST wrappers for app data before reading `actions`.
 - Do not add inline LLM calls before reading `using-your-agent` and
   `agent-surfaces`.
+- Do not copy framework runtime internals when a public API or narrow UI copy
+  will do; read `customizing-agent-native` for the supported override ladder.

package/corpus/core/src/templates/default/.agents/skills/customizing-agent-native/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: customizing-agent-native
+description: >-
+  How to adopt, compose, or selectively copy Agent Native UI into app-owned
+  code. Use when overriding shared components, customizing a template, adding
+  UI to chat or headless apps, or inspecting installed framework source.
+scope: dev
+metadata:
+  internal: true
+---
+
+# Customizing Agent Native
+
+## Rule
+
+Start with the public component and its props, slots, callbacks, and stable
+class names. If those seams are not enough, copy the smallest useful reference
+implementation into the app and make that copy app-owned. Never edit
+`node_modules`, deep-import a private source file at runtime, or patch an
+`@agent-native/*` package.
+
+Use this order:
+
+1. Configure the public component.
+2. Compose public primitives behind a local app component.
+3. Copy one component or helper into app source and change the app import.
+4. Propose a new Toolkit seam when the same override is useful in two apps.
+
+Copying is for intentional product customization, not for hiding an upgrade
+failure or replacing Core runtime behavior.
+
+## Find The Installed Implementation
+
+Use the source that matches the installed package version:
+
+```bash
+pnpm action docs-search --query "<component or feature>"
+pnpm action source-search --query "<component or symbol>"
+rg -n "<component or symbol>" node_modules/@agent-native/toolkit/src
+rg -n "<component or symbol>" node_modules/@agent-native/core/corpus
+```
+
+- Toolkit publishes readable TypeScript under
+  `node_modules/@agent-native/toolkit/src/` for selective UI adoption.
+- Core and first-party template source lives under
+  `node_modules/@agent-native/core/corpus/core/` and
+  `node_modules/@agent-native/core/corpus/templates/`.
+- Treat those trees as read-only references. Copy files into an app directory
+  such as `app/components/`, then import the local copy.
+
+When a copied component imports sibling helpers, copy only the required
+siblings or replace them with public package imports. Do not copy an entire
+package or template to change one surface.
+
+## Preserve The Agent-Native Contract
+
+UI ownership may change; product contracts should not:
+
+- Keep app operations in `defineAction` actions and call them through
+  `useActionQuery`, `useActionMutation`, or another named client helper.
+- Keep navigation, selection, and focused-object state visible through the
+  existing application-state keys.
+- Keep AI work in the shared agent chat instead of adding direct LLM calls.
+- Keep auth, access checks, persistence, chat transport, and agent execution in
+  Core. Do not copy those runtimes into the app.
+- Keep local adapters narrow so package upgrades still improve every surface
+  the app has not intentionally taken ownership of.
+
+## App Shapes
+
+- **Template app:** begin with its existing local adapters and domain UI. Use
+  Toolkit for repeated workspace UI; copy only the piece being customized.
+- **Chat app:** keep `AgentChatSurface`, thread state, and chat transport in
+  Core. Compose or copy Toolkit presentation such as chat-history UI around it.
+- **Headless app:** stay action-first while no UI is needed. When adding a UI,
+  use the Chat template as the on-ramp or add Toolkit components without
+  replacing the existing actions.
+- **Workspace:** put one-app overrides in that app. Promote a local component
+  to `packages/shared` only when multiple workspace apps use it.
+
+## After Copying
+
+- Remove unused dependencies and imports from the copied file.
+- Keep visible text in the app's localization catalogs.
+- Run the app's formatter, typecheck, and focused tests.
+- Re-check the installed source during future package upgrades; the app-owned
+  copy does not receive upstream fixes automatically.
+
+## Don't
+
+- Don't edit or import from `node_modules/@agent-native/*/src` at runtime.
+- Don't add `pnpm.overrides`, patches, or resolutions for Agent Native packages.
+- Don't copy Core auth, DB, action, agent-loop, or transport internals.
+- Don't fork a full template when a prop, slot, wrapper, or one-file copy works.
+
+## Related Skills
+
+- `agent-native-docs` — version-matched docs and source lookup
+- `agent-native-toolkit` — shared-vs-app-owned architecture boundary
+- `self-modifying-code` — safe app source edits
+- `upgrade-agent-native` — supported package upgrade path
+- `adding-a-feature` — UI/action/instructions/application-state parity