@nxisai/agent-harness 0.4.0 → 0.5.0

package/src/ui/agent.tw.css

@@ -0,0 +1,49 @@
+/*
+ * Tailwind for the agent's shadow DOM.
+ *
+ * Imported with `?inline` and injected into the shadow root — Tailwind's
+ * normal delivery (a stylesheet in document.head) cannot cross a shadow
+ * boundary, so utility classes on the agent's markup would otherwise do
+ * nothing at all.
+ *
+ * `@source` is explicit because the class names live inside TypeScript
+ * template literals rather than .html files; Tailwind's default detection
+ * would find none of them.
+ */
+@import "tailwindcss";
+
+@source "./agent-fullscreen.ts";
+
+/*
+ * The theme is the NxisAI design system (design.md §1–2), not Tailwind's
+ * defaults. Utilities therefore resolve to the brand palette — `bg-surface` is
+ * Soft Gray, `text-blue` is Signal Blue — and a stray `bg-blue-500` is
+ * visibly not part of the system rather than quietly close to it.
+ */
+@theme {
+  --color-bg: #FFFFFF;
+  --color-surface: #F5F7FB;
+  --color-surface-2: #EDF1F9;
+  --color-border-hair: #E4E9F2;
+  --color-border-strong: #CFD8E8;
+  --color-ink: #0F172A;
+  --color-ink-2: #475569;
+  --color-ink-3: #8A97AC;
+  --color-blue: #2563EB;
+  --color-blue-strong: #1D4ED8;
+  --color-blue-tint: #EEF3FF;
+  --color-green: #22C55E;
+  --color-green-strong: #16A34A;
+  --color-green-tint: #E8FAEF;
+  --color-red: #B91C1C;
+
+  --font-display: 'Manrope', system-ui, sans-serif;
+  --font-sans: 'Inter', system-ui, sans-serif;
+  --font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace;
+
+  --radius-card: 14px;
+  --radius-btn: 10px;
+
+  --shadow-resting: 0 1px 2px rgba(15, 23, 42, .05);
+  --shadow-raised: 0 1px 2px rgba(15, 23, 42, .04), 0 10px 30px rgba(15, 23, 42, .06);
+}

package/src/ui/config.ts

@@ -0,0 +1,138 @@
+/**
+ * Defaults for the packaged UI.
+ *
+ * Nothing here is specific to any site. Every value is a starting point the
+ * host overrides through the element's properties or attributes.
+ *
+ * @module
+ */
+import { NXIS_LOGO_SVG } from '../engine.js';
+
+/**
+ * The default system prompt, used when the host sets none.
+ *
+ * Two instructions should survive any rewrite. Calling the tool with partial
+ * arguments is what allows the harness to collect the rest as fields, since a
+ * model told to ask in prose will do so. And insisting on the schema's exact
+ * parameter names keeps a model from renaming them, which would leave the
+ * arguments unmatched.
+ */
+export const DEFAULT_SYSTEM_PROMPT = [
+  'You are an assistant embedded in a web page.',
+  "Use the available tools to answer the user's questions and to fill and submit forms on this page.",
+  'Use parameter names EXACTLY as defined in the tool schema — do not rename, translate, or add suffixes.',
+  'Only include fields the user provided or that are clearly implied; never invent emails, names, or dates.',
+  'Call the tool as soon as you know which one is right, even if some required fields are still unknown —',
+  'include the fields you do have and simply omit the rest.',
+  'Never ask the user to supply a missing field in prose. Leave it out of the call; the page will collect it.',
+  'Answer only from tool results — never invent facts the tools did not return.',
+  'Call at most one tool per turn.',
+].join(' ');
+
+/** Empty-state chips. Replace with prompts that suit the host's tools. */
+export const DEFAULT_SUGGESTIONS: string[] = [
+  'What can you do on this page?',
+  'What information is available here?',
+];
+
+/**
+ * The line shown above the suggestions before a conversation starts.
+ *
+ * Only the host knows what the agent can do on their site, so the default
+ * describes the mechanism rather than the subject.
+ */
+export const DEFAULT_EMPTY_STATE =
+  'Ask a question about this page — the agent answers with typed records and ' +
+  'can fill forms for you, right here in the chat.';
+
+/**
+ * The agent's name.
+ *
+ * Shown in the header, and used in the launcher's title and the dialog's
+ * accessible name, so it is announced by a screen reader.
+ */
+export const DEFAULT_AGENT_NAME = 'Nxis Agent';
+
+/**
+ * The mark shown on the launcher, in both headers, above the empty state, and
+ * on result cards.
+ *
+ * Either inline SVG markup (any value starting with `<`) or an image URL.
+ *
+ * Markup is injected as written, at the same trust level as the rest of the
+ * host page, so never pass a value a visitor can influence.
+ */
+export const DEFAULT_LOGO = NXIS_LOGO_SVG;
+
+/**
+ * Brand overrides, applied as custom properties on the host element.
+ *
+ * Every key is optional and anything omitted keeps its default. Colours accept
+ * any CSS colour; fonts accept a full font stack.
+ */
+export interface AgentTheme {
+  /** Primary action colour — buttons, focus rings, links. */
+  accent?: string;
+  /** Pressed/hover state for `accent`. */
+  accentStrong?: string;
+  /** Faint wash of `accent` behind tags and chips. */
+  accentTint?: string;
+  /** Body text. */
+  ink?: string;
+  /** Secondary text. */
+  inkSoft?: string;
+  /** Labels, timestamps, placeholders. */
+  inkMuted?: string;
+  /** The surface the agent's own panels sit on. */
+  bg?: string;
+  /** Panels raised off `bg` — assistant bubbles, chips. */
+  surface?: string;
+  /** Hairlines. */
+  border?: string;
+  /** Corner radius of cards, as a CSS length. */
+  radius?: string;
+  /** Headings. */
+  fontDisplay?: string;
+  /** Body copy and controls. */
+  fontSans?: string;
+  /** Status lines, labels, code. */
+  fontMono?: string;
+}
+
+/**
+ * The custom properties each {@link AgentTheme} key writes.
+ *
+ * Each key writes two names: the element's hand-written CSS resolves the short
+ * form, while its Tailwind utilities resolve the theme form. Both style parts
+ * of the same surface, so writing only one would leave the element partly
+ * unbranded.
+ */
+export const THEME_TOKENS: Record<keyof AgentTheme, readonly string[]> = {
+  accent: ['--blue', '--color-blue'],
+  accentStrong: ['--blue-strong', '--color-blue-strong'],
+  accentTint: ['--blue-tint', '--color-blue-tint'],
+  ink: ['--ink', '--color-ink'],
+  inkSoft: ['--ink-2', '--color-ink-2'],
+  inkMuted: ['--ink-3', '--color-ink-3'],
+  bg: ['--bg', '--color-bg'],
+  surface: ['--surface', '--color-surface'],
+  border: ['--border', '--color-border-hair'],
+  radius: ['--radius', '--radius-card'],
+  fontDisplay: ['--display', '--font-display'],
+  fontSans: ['--sans', '--font-sans'],
+  fontMono: ['--mono', '--font-mono'],
+};
+
+/**
+ * How stored preference keys map onto schema field names.
+ *
+ * Schemas name the same field differently (`full_name`, `fullname`, `name`), so
+ * each preference lists the aliases it satisfies. Extend this to add a new
+ * stored preference.
+ */
+export const PROFILE_ALIASES: Record<string, string[]> = {
+  name: ['full_name', 'name', 'fullname'],
+  email: ['email', 'email_address', 'emailaddress'],
+  phone: ['phone', 'phone_number', 'phonenumber', 'tel', 'mobile'],
+  address: ['address', 'street_address', 'streetaddress', 'street'],
+};

package/src/ui/index.ts

@@ -0,0 +1,32 @@
+/**
+ * The packaged chat element.
+ *
+ * Importing this module registers the `<nxis-agent-fullscreen>` custom element.
+ *
+ * @example
+ * ```ts
+ * import '@nxisai/agent-harness/ui';
+ * ```
+ * ```html
+ * <nxis-agent-fullscreen></nxis-agent-fullscreen>
+ * ```
+ *
+ * @module
+ */
+import './agent-fullscreen.js';
+
+export type { AgentPreferences, AgentDefinition } from './agent-fullscreen.js';
+export {
+  DEFAULT_SYSTEM_PROMPT,
+  DEFAULT_SUGGESTIONS,
+  DEFAULT_EMPTY_STATE,
+  DEFAULT_AGENT_NAME,
+  DEFAULT_LOGO,
+  THEME_TOKENS,
+  PROFILE_ALIASES,
+} from './config.js';
+export type { AgentTheme } from './config.js';
+export type { PreloadMode, ProgressDetail } from '../engine.js';
+export { A2UI_THEME_CSS, NXIS_PRIMARY } from '../a2ui/theme.js';
+export { viewJourney } from './journey.js';
+export type { JourneyView } from './journey.js';

package/src/ui/journey.ts

@@ -0,0 +1,57 @@
+/**
+ * How a journey reads, for a surface that shows one.
+ *
+ * Kept apart from the element so the reading — what the card is called,
+ * whether it is still running, what one line says once it is done — can be
+ * tested without a browser, and reused by a surface the host builds itself.
+ *
+ * @module
+ */
+import type { AgentStep } from '../harness/steps.js';
+
+/** A journey, reduced to what a card needs. */
+export interface JourneyView {
+  /** The journey's id. */
+  id: string;
+  /** What it is: the name of the thing the agent used. */
+  title: string;
+  /** The steps worth a line each. The choice of tool is the title instead. */
+  steps: AgentStep[];
+  /** Still going, finished, or stopped short. */
+  outcome: 'running' | 'done' | 'failed';
+  /** The step in progress, while there is one. */
+  active?: AgentStep;
+  /** One line for the folded card, or for a status bar while running. */
+  summary: string;
+}
+
+/**
+ * Read a journey's steps as a card.
+ *
+ * @param steps - The journey's steps, oldest first.
+ * @returns The card's reading, or null for a journey with nothing in it.
+ */
+export function viewJourney(steps: AgentStep[]): JourneyView | null {
+  if (!steps.length) return null;
+  const id = steps.find((s) => s.journey)?.journey ?? '';
+  const choose = steps.find((s) => s.id === 'choose');
+  const title = choose?.label || 'Working on it';
+  const listed = steps.filter((s) => s.id !== 'choose');
+
+  const failed = listed.find((s) => s.status === 'failed');
+  const submitted = listed.find((s) => s.id === 'submit' && s.status === 'done');
+  const outcome: JourneyView['outcome'] = failed ? 'failed' : submitted ? 'done' : 'running';
+  // The latest active step, not the first: collect can reopen after navigate.
+  const active = [...listed].reverse().find((s) => s.status === 'active');
+
+  const summary =
+    outcome === 'done'
+      ? `${title} · ${lower(submitted!.label)}`
+      : outcome === 'failed'
+        ? `${title} · ${lower(failed!.label)}`
+        : (active?.label ?? title);
+
+  return { id, title, steps: listed, outcome, active, summary };
+}
+
+const lower = (s: string): string => (s ? s.charAt(0).toLowerCase() + s.slice(1) : s);

package/src/ui/tailwind.generated.ts

@@ -0,0 +1,2 @@
+/* GENERATED by scripts/css-to-ts.mjs — do not edit. Source: src/ui/agent.tw.css */
+export const TAILWIND_CSS = "/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */\n@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:\"Inter\", system-ui, sans-serif;--font-mono:\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, monospace;--color-white:#fff;--spacing:.25rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--font-weight-medium:500;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-2xl:1rem;--shadow-sm:0 1px 3px 0 #0000001a, 0 1px 2px -1px #0000001a;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--color-bg:#fff;--color-surface:#f5f7fb;--color-border-hair:#e4e9f2;--color-ink:#0f172a;--color-ink-2:#475569;--color-ink-3:#8a97ac;--color-blue:#2563eb;--color-blue-strong:#1d4ed8;--color-blue-tint:#eef3ff;--color-green-strong:#16a34a;--color-red:#b91c1c;--font-display:\"Manrope\", system-ui, sans-serif;--radius-card:14px}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", \"Noto Sans\", Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.invisible{visibility:hidden}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.mt-1{margin-top:var(--spacing)}.block{display:block}.contents{display:contents}.flex{display:flex}.hidden{display:none}.inline{display:inline}.table{display:table}.w-full{width:100%}.max-w-\\[76\\%\\]{max-width:76%}.max-w-\\[420px\\]{max-width:420px}.flex-shrink{flex-shrink:1}.border-collapse{border-collapse:collapse}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.resize{resize:both}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.gap-1{gap:var(--spacing)}.gap-1\\.5{gap:calc(var(--spacing) * 1.5)}.self-end{align-self:flex-end}.self-start{align-self:flex-start}.self-stretch{align-self:stretch}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.rounded-2xl{border-radius:var(--radius-2xl)}.rounded-card{border-radius:var(--radius-card)}.rounded-br-md{border-bottom-right-radius:var(--radius-md)}.rounded-bl-md{border-bottom-left-radius:var(--radius-md)}.border{border-style:var(--tw-border-style);border-width:1px}.border-border-hair{border-color:var(--color-border-hair)}.border-red{border-color:var(--color-red)}.border-red\\/25{border-color:#b91c1c40}@supports (color:color-mix(in lab, red, red)){.border-red\\/25{border-color:color-mix(in oklab, var(--color-red) 25%, transparent)}}.bg-blue{background-color:var(--color-blue)}.bg-surface{background-color:var(--color-surface)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-3\\.5{padding-inline:calc(var(--spacing) * 3.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-2\\.5{padding-block:calc(var(--spacing) * 2.5)}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-\\[11px\\]{font-size:11px}.text-\\[13px\\]{font-size:13px}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.tracking-\\[0\\.14em\\]{--tw-tracking:.14em;letter-spacing:.14em}.break-words{overflow-wrap:break-word}.whitespace-pre-wrap{white-space:pre-wrap}.text-green-strong{color:var(--color-green-strong)}.text-ink{color:var(--color-ink)}.text-ink-2{color:var(--color-ink-2)}.text-red{color:var(--color-red)}.text-white{color:var(--color-white)}.uppercase{text-transform:uppercase}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-resting{--tw-shadow:0 1px 2px var(--tw-shadow-color,#0f172a0d);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow\\/border{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.\\!ring{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor)!important;box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)!important}.ring{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}}@property --tw-rotate-x{syntax:\"*\";inherits:false}@property --tw-rotate-y{syntax:\"*\";inherits:false}@property --tw-rotate-z{syntax:\"*\";inherits:false}@property --tw-skew-x{syntax:\"*\";inherits:false}@property --tw-skew-y{syntax:\"*\";inherits:false}@property --tw-border-style{syntax:\"*\";inherits:false;initial-value:solid}@property --tw-leading{syntax:\"*\";inherits:false}@property --tw-font-weight{syntax:\"*\";inherits:false}@property --tw-tracking{syntax:\"*\";inherits:false}@property --tw-shadow{syntax:\"*\";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:\"*\";inherits:false}@property --tw-shadow-alpha{syntax:\"<percentage>\";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:\"*\";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:\"*\";inherits:false}@property --tw-inset-shadow-alpha{syntax:\"<percentage>\";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:\"*\";inherits:false}@property --tw-ring-shadow{syntax:\"*\";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:\"*\";inherits:false}@property --tw-inset-ring-shadow{syntax:\"*\";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:\"*\";inherits:false}@property --tw-ring-offset-width{syntax:\"<length>\";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:\"*\";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:\"*\";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:\"*\";inherits:false;initial-value:solid}@property --tw-blur{syntax:\"*\";inherits:false}@property --tw-brightness{syntax:\"*\";inherits:false}@property --tw-contrast{syntax:\"*\";inherits:false}@property --tw-grayscale{syntax:\"*\";inherits:false}@property --tw-hue-rotate{syntax:\"*\";inherits:false}@property --tw-invert{syntax:\"*\";inherits:false}@property --tw-opacity{syntax:\"*\";inherits:false}@property --tw-saturate{syntax:\"*\";inherits:false}@property --tw-sepia{syntax:\"*\";inherits:false}@property --tw-drop-shadow{syntax:\"*\";inherits:false}@property --tw-drop-shadow-color{syntax:\"*\";inherits:false}@property --tw-drop-shadow-alpha{syntax:\"<percentage>\";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:\"*\";inherits:false}@property --tw-ease{syntax:\"*\";inherits:false}";

package/src/webmcp-contract.ts

@@ -0,0 +1,65 @@
+/**
+ * The part of the WebMCP action contract this package consumes.
+ *
+ * Declared here rather than imported, so that type-only information does not
+ * require a runtime dependency. These shapes mirror the WebMCP SDK's exports
+ * and can be widened as that contract grows.
+ *
+ * @module
+ */
+
+/**
+ * The value types a property specification may declare.
+ *
+ * The crawler folds time inputs into `date`, and marks file inputs `file`.
+ */
+export type NxisValueType = 'string' | 'number' | 'integer' | 'boolean' | 'date' | 'file';
+
+/** One choice in a property's enumerated options. */
+export interface NxisValueOption {
+  '@type'?: 'nxis:ValueOption';
+  value: string;
+  name?: string;
+}
+
+/** A Schema.org `PropertyValueSpecification`: one input of an action. */
+export interface NxisPropertyValueSpecification {
+  '@type'?: string;
+  valueName: string;
+  description?: string;
+  valueRequired?: boolean;
+  defaultValue?: string;
+  valueMinLength?: number;
+  valueMaxLength?: number;
+  minValue?: number;
+  maxValue?: number;
+  stepValue?: number;
+  valuePattern?: string;
+  multipleValues?: boolean;
+  readonlyValue?: boolean;
+  'nxis:valueType'?: NxisValueType;
+  'nxis:valueOption'?: NxisValueOption[];
+}
+
+/** How an action is submitted: its URL, method and encoding. */
+export interface NxisEntryPoint {
+  '@type'?: 'EntryPoint';
+  httpMethod: string;
+  urlTemplate?: string;
+  encodingType?: string;
+  'nxis:targetKind'?: 'selfPage' | 'clientSide';
+  'nxis:pageUrl'?: string;
+  'nxis:jsHandled'?: boolean;
+}
+
+/** A Schema.org action extracted from a page's JSON-LD. */
+export interface NxisAction {
+  '@context'?: unknown;
+  '@type': string;
+  '@id': string;
+  name: string;
+  description?: string;
+  target: NxisEntryPoint;
+  input?: NxisPropertyValueSpecification[];
+  'nxis:extractedAt'?: string;
+}