@oddkin/ai 0.0.0-stage → 1.0.0-beta.1

package/dist/prod/citation/citation.definition.js

@@ -0,0 +1,14 @@
+import { compose } from "@oddkin/core/element";
+import { aiBaseStyles } from "../internal/base.styles.js";
+import { OddkinCitation } from "./citation.js";
+import { citationStyles } from "./citation.styles.js";
+import { citationTemplate } from "./citation.template.js";
+const citationDefinition = compose({
+  name: "odd-citation",
+  element: OddkinCitation,
+  template: citationTemplate,
+  styles: [aiBaseStyles, citationStyles]
+});
+export {
+  citationDefinition
+};

package/dist/prod/citation/citation.js

@@ -0,0 +1,66 @@
+import { OddkinElement, event, prop } from "@oddkin/core/element";
+import { signal } from "@oddkin/core/reactive";
+import { citationOpenEvent } from "../events.js";
+import { strings } from "../internal/strings.js";
+const CITATION_STRINGS = {
+  source: "Source {index}: {title}",
+  unresolved: "Unresolved source reference {id}",
+  unavailable: "This source is not available. The response referenced it, but no source record was supplied.",
+  open: "Open source",
+  show: "Show in sources",
+  untitled: "Untitled source"
+}, revealSourceEvent = event("odd-source-reveal", {
+  bubbles: !0,
+  composed: !0,
+  cancelable: !0,
+  intent: "user",
+  description: "Default action of odd-citation-open: the nearest message reveals the source."
+});
+class OddkinCitation extends OddkinElement.with({
+  sourceId: prop.string({
+    default: "",
+    attribute: "source-id",
+    description: "Citation key (`[^key]`)."
+  }),
+  index: prop.number({ default: 0, description: "Display number; 0 shows the key." }),
+  source: prop.object({
+    description: "The source record; undefined renders an unresolved reference."
+  }),
+  strings: prop.object({
+    description: "Localized string overrides."
+  })
+}) {
+  static shadowRootOptions = { mode: "open" };
+  static events = {
+    "odd-citation-open": citationOpenEvent,
+    "odd-source-reveal": revealSourceEvent
+  };
+  /** @internal Local presentation state. */
+  _open = signal(!1);
+  /** @internal */
+  get _strings() {
+    return strings(CITATION_STRINGS, this.strings);
+  }
+  /** @internal */
+  _toggle = () => {
+    this._open.value = !this._open.value;
+  };
+  /** @internal */
+  _show = () => {
+    const resolved = !!this.source;
+    this.emit(citationOpenEvent, { sourceId: this.sourceId, resolved }) && resolved && this.emit(revealSourceEvent, { sourceId: this.sourceId });
+  };
+  connected(scope) {
+    scope.listen(this, "keydown", (event2) => {
+      event2.key === "Escape" && this._open.value && (this._open.value = !1, this.shadowRoot?.querySelector('[part="trigger"]')?.focus(), event2.stopPropagation());
+    }), scope.listen(this, "focusout", (event2) => {
+      const next = event2.relatedTarget;
+      next && (this.contains(next) || this.shadowRoot?.contains(next)) || next && (this._open.value = !1);
+    });
+  }
+}
+export {
+  CITATION_STRINGS,
+  OddkinCitation,
+  revealSourceEvent
+};

package/dist/prod/citation/citation.recipe.js

@@ -0,0 +1,9 @@
+import { defineLayoutRecipe, stack } from "@oddkin/components/layout";
+import { token } from "@oddkin/tokens/refs";
+const citationRecipe = defineLayoutRecipe({
+  name: "citation",
+  regions: { preview: stack({ gap: token("space.2xs") }) }
+});
+export {
+  citationRecipe
+};

package/dist/prod/citation/citation.recipe.styles.js

@@ -0,0 +1,13 @@
+import { unsafeCSS } from "@oddkin/core/styles";
+const citationRecipeStyles = unsafeCSS(`@layer odd.layout.base {
+  .preview {
+    display: flex;
+    flex-direction: column;
+    gap: var(--odd-space-2xs);
+    min-inline-size: 0;
+  }
+}
+`);
+export {
+  citationRecipeStyles
+};

package/dist/prod/citation/citation.styles.js

@@ -0,0 +1,61 @@
+import { css } from "@oddkin/core/styles";
+import { token } from "@oddkin/tokens/refs";
+import { citationRecipeStyles } from "./citation.recipe.styles.js";
+const citationStyles = css`
+  ${citationRecipeStyles}
+  :host {
+    display: inline;
+    position: relative;
+  }
+  .trigger {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-inline-size: 1.5em;
+    min-block-size: 1.5em;
+    margin-inline: 0.125em;
+    padding-inline: 0.25em;
+    border: ${token("border.width.default")} solid ${token("color.border.default")};
+    border-radius: ${token("radius.sm")};
+    background: ${token("color.surface.sunken")};
+    color: ${token("color.link")};
+    font: inherit;
+    font-size: 0.75em;
+    line-height: 1;
+    vertical-align: super;
+    cursor: pointer;
+  }
+  /* Touch: keep a 24px minimum target without changing the inline marker size. */
+  .trigger::after {
+    content: '';
+    position: absolute;
+    inset: -0.5rem;
+  }
+  .trigger[data-resolved='false'] {
+    border-style: dashed;
+    color: ${token("color.text.secondary")};
+  }
+  .preview {
+    margin-block: ${token("space.xs")};
+    padding: ${token("space.sm")};
+    border: ${token("border.width.default")} solid ${token("color.border.default")};
+    border-radius: ${token("radius.md")};
+    background: ${token("color.surface.raised")};
+    font-size: ${token("font.size.sm")};
+  }
+  .preview[hidden] {
+    display: none !important;
+  }
+  .link {
+    color: ${token("color.link")};
+  }
+  @media (forced-colors: active) {
+    .trigger,
+    .preview {
+      border-color: CanvasText;
+    }
+  }
+`;
+export {
+  citationStyles
+};

package/dist/prod/citation/citation.template.js

@@ -0,0 +1,44 @@
+import { html } from "@oddkin/core/template";
+import { format } from "../internal/strings.js";
+import { displayHost, safeUrl } from "../markdown/url.js";
+const citationTemplate = (host) => {
+  const t = host._strings, source = host.source, open = host._open.value, marker = host.index > 0 ? String(host.index) : host.sourceId, title = source?.title || displayHost(source?.url) || t.untitled, url = source?.url ? safeUrl(source.url) : void 0, name = source ? format(t.source, { index: marker, title }) : format(t.unresolved, { id: marker });
+  return html`<button
+      part="trigger"
+      class="trigger"
+      type="button"
+      aria-label=${name}
+      aria-expanded=${open ? "true" : "false"}
+      aria-controls="preview"
+      data-resolved=${source ? "true" : "false"}
+      @click=${host._toggle}
+    >
+      ${marker}</button
+    ><span
+      part="preview"
+      id="preview"
+      class="preview"
+      role="group"
+      aria-label=${name}
+      ?hidden=${!open}
+    >
+      ${source ? html`<strong class="title">${title}</strong>
+              <span class="muted host" ?hidden=${!source.publisher && !url}
+                >${source.publisher ?? displayHost(url) ?? ""}</span
+              >
+              <span class="excerpt" ?hidden=${!source.excerpt}>${source.excerpt ?? ""}</span>
+              <span class="actions">
+                ${url ? html`<a
+                        class="link"
+                        href=${url}
+                        rel="noopener noreferrer nofollow"
+                        target="_blank"
+                        >${t.open}</a
+                      >` : null}
+                <button class="text-button" type="button" @click=${host._show}>${t.show}</button>
+              </span>` : html`<span class="muted">${t.unavailable}</span>`}
+    </span>`;
+};
+export {
+  citationTemplate
+};

package/dist/prod/citation/index.js

@@ -0,0 +1,12 @@
+import { OddkinCitation, CITATION_STRINGS, revealSourceEvent } from "./citation.js";
+import { citationTemplate } from "./citation.template.js";
+import { citationStyles } from "./citation.styles.js";
+import { citationDefinition } from "./citation.definition.js";
+export {
+  CITATION_STRINGS,
+  OddkinCitation,
+  citationDefinition,
+  citationStyles,
+  citationTemplate,
+  revealSourceEvent
+};

package/dist/prod/context-picker/context-picker.define.js

@@ -0,0 +1,3 @@
+import { define } from "@oddkin/core/element";
+import { contextPickerDefinition } from "./context-picker.definition.js";
+define(contextPickerDefinition);

package/dist/prod/context-picker/context-picker.definition.js

@@ -0,0 +1,14 @@
+import { compose } from "@oddkin/core/element";
+import { aiBaseStyles } from "../internal/base.styles.js";
+import { OddkinContextPicker } from "./context-picker.js";
+import { contextPickerStyles } from "./context-picker.styles.js";
+import { contextPickerTemplate } from "./context-picker.template.js";
+const contextPickerDefinition = compose({
+  name: "odd-context-picker",
+  element: OddkinContextPicker,
+  template: contextPickerTemplate,
+  styles: [aiBaseStyles, contextPickerStyles]
+});
+export {
+  contextPickerDefinition
+};

package/dist/prod/context-picker/context-picker.js

@@ -0,0 +1,106 @@
+import { OddkinElement, prop } from "@oddkin/core/element";
+import { signal } from "@oddkin/core/reactive";
+import { contextAddEvent, contextRemoveEvent } from "../events.js";
+import { format, formatNumber, langOf, strings } from "../internal/strings.js";
+import { safeUrl } from "../markdown/url.js";
+const CONTEXT_PICKER_STRINGS = {
+  label: "Context",
+  empty: "No context added.",
+  addFiles: "Add files",
+  addUrl: "Add link",
+  url: "Link address",
+  add: "Add",
+  invalidUrl: "Enter a full http or https address.",
+  inspect: "Inspect {label}",
+  hide: "Hide {label}",
+  remove: "Remove {label}",
+  noPreview: "No preview available.",
+  file: "File",
+  document: "Document",
+  selection: "Selected text",
+  urlKind: "Link",
+  selected: "Selected",
+  uploading: "Uploading\u2026",
+  uploaded: "Uploaded",
+  processing: "Processing\u2026",
+  ready: "Ready",
+  failed: "Failed",
+  removed: "Removed"
+};
+class OddkinContextPicker extends OddkinElement.with({
+  items: prop.array({ description: "Context item records (host-owned)." }),
+  accept: prop.string({
+    default: "",
+    description: 'File types for "Add files" (as `<input accept>`).'
+  }),
+  allowUrls: prop.boolean({ attribute: "allow-urls", description: "Offer adding links." }),
+  disabled: prop.boolean({ reflect: !0, description: "Prevents adding and removing." }),
+  strings: prop.object({
+    description: "Localized string overrides."
+  })
+}) {
+  static events = {
+    "odd-context-add": contextAddEvent,
+    "odd-context-remove": contextRemoveEvent
+  };
+  /** @internal Expanded item ids (presentation state). */
+  _expanded = signal(/* @__PURE__ */ new Set());
+  /** @internal */
+  _urlError = signal("");
+  /** @internal */
+  get _strings() {
+    return strings(CONTEXT_PICKER_STRINGS, this.strings);
+  }
+  /** @internal */
+  _kind(item) {
+    const t = this._strings;
+    return item.kind === "url" ? t.urlKind : t[item.kind];
+  }
+  /** @internal */
+  _size(item) {
+    if (item.size === void 0)
+      return "";
+    const kb = item.size / 1024, locale = langOf(this);
+    return kb < 1024 ? `${formatNumber(Math.max(1, Math.round(kb)), locale)} KB` : `${formatNumber(Math.round(kb / 102.4) / 10, locale)} MB`;
+  }
+  /** @internal */
+  _toggle = (event) => {
+    const id = event.currentTarget.dataset.id, next = new Set(this._expanded.peek());
+    next.has(id) ? next.delete(id) : next.add(id), this._expanded.value = next;
+  };
+  /** @internal */
+  _remove = (event) => {
+    const id = event.currentTarget.dataset.id;
+    id && !this.disabled && this.emit(contextRemoveEvent, { itemId: id });
+  };
+  /** @internal */
+  _pickFiles = () => {
+    this.shadowRoot?.querySelector('input[type="file"]')?.click();
+  };
+  /** @internal */
+  _onFiles = (event) => {
+    const input = event.target, files = [...input.files ?? []];
+    input.value = "", files.length && !this.disabled && this.emit(contextAddEvent, { kind: "file", files });
+  };
+  /** @internal */
+  _addUrl = (event) => {
+    event.preventDefault();
+    const input = this.shadowRoot?.querySelector('input[type="url"]');
+    if (!input || this.disabled)
+      return;
+    const url = safeUrl(input.value, { protocols: ["https:", "http:"], allowRelative: !1 });
+    if (!url) {
+      this._urlError.value = this._strings.invalidUrl, input.focus();
+      return;
+    }
+    this._urlError.value = "", input.value = "", this.emit(contextAddEvent, { kind: "url", url });
+  };
+  /** @internal */
+  _label(template, item) {
+    return format(this._strings[template], { label: item.label });
+  }
+}
+export {
+  CONTEXT_PICKER_STRINGS,
+  OddkinContextPicker
+};

package/dist/prod/context-picker/context-picker.recipe.js

@@ -0,0 +1,14 @@
+import { defineLayoutRecipe, row, stack } from "@oddkin/components/layout";
+import { token } from "@oddkin/tokens/refs";
+const contextPickerRecipe = defineLayoutRecipe({
+  name: "context-picker",
+  regions: {
+    base: stack({ gap: token("space.xs") }),
+    list: stack({ gap: token("space.2xs") }),
+    row: row({ gap: token("space.xs"), wrap: !0 }),
+    url: row({ gap: token("space.2xs"), align: "stretch", wrap: !0 })
+  }
+});
+export {
+  contextPickerRecipe
+};

package/dist/prod/context-picker/context-picker.recipe.styles.js

@@ -0,0 +1,35 @@
+import { unsafeCSS } from "@oddkin/core/styles";
+const contextPickerRecipeStyles = unsafeCSS(`@layer odd.layout.base {
+  .base {
+    display: flex;
+    flex-direction: column;
+    gap: var(--odd-space-xs);
+    min-inline-size: 0;
+  }
+  .list {
+    display: flex;
+    flex-direction: column;
+    gap: var(--odd-space-2xs);
+    min-inline-size: 0;
+  }
+  .row {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    gap: var(--odd-space-xs);
+    flex-wrap: wrap;
+    min-inline-size: 0;
+  }
+  .url {
+    display: flex;
+    flex-direction: row;
+    align-items: stretch;
+    gap: var(--odd-space-2xs);
+    flex-wrap: wrap;
+    min-inline-size: 0;
+  }
+}
+`);
+export {
+  contextPickerRecipeStyles
+};

package/dist/prod/context-picker/context-picker.styles.js

@@ -0,0 +1,53 @@
+import { css } from "@oddkin/core/styles";
+import { token } from "@oddkin/tokens/refs";
+import { contextPickerRecipeStyles } from "./context-picker.recipe.styles.js";
+const contextPickerStyles = css`
+  ${contextPickerRecipeStyles}
+  p {
+    margin: 0;
+  }
+  .list {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+  .item {
+    padding: ${token("space.2xs")} ${token("space.xs")};
+    border: ${token("border.width.default")} solid ${token("color.border.default")};
+    border-radius: ${token("radius.sm")};
+    background: ${token("color.surface.default")};
+  }
+  .label {
+    flex: 1 1 8rem;
+    min-inline-size: 0;
+  }
+  .kind {
+    font-size: ${token("font.size.xs")};
+    text-transform: uppercase;
+  }
+  .excerpt {
+    max-block-size: 10rem;
+    margin: ${token("space.2xs")} 0 0;
+    overflow: auto;
+    font-family: ${token("font.family.mono")};
+    font-size: ${token("font.size.xs")};
+    white-space: pre-wrap;
+  }
+  .url > label {
+    min-inline-size: 0;
+  }
+  input[type='url'] {
+    /* Its own width, but never wider than the form (narrow containers, wide fonts). */
+    max-inline-size: 100%;
+    min-block-size: ${token("target.min")};
+    padding-inline: ${token("space.xs")};
+    border: ${token("border.width.default")} solid ${token("color.border.default")};
+    border-radius: ${token("control.radius")};
+    background: ${token("color.surface.default")};
+    color: inherit;
+    font: inherit;
+  }
+`;
+export {
+  contextPickerStyles
+};

package/dist/prod/context-picker/context-picker.template.js

@@ -0,0 +1,81 @@
+import { html, repeat } from "@oddkin/core/template";
+const contextPickerTemplate = (host) => {
+  const t = host._strings, items = host.items.filter((item) => item.status !== "removed"), expanded = host._expanded.value;
+  return html`<div class="base" part="base" role="group" aria-label=${t.label}>
+    <p class="muted" ?hidden=${!!items.length}>${t.empty}</p>
+    <ul part="list" class="list" ?hidden=${!items.length}>
+      ${repeat(items, (item) => item.id, (item) => {
+    const open = expanded.has(item.id);
+    return html`<li part="item" class="item" data-status=${item.status}>
+            <div class="row">
+              <span class="kind muted">${host._kind(item)}</span>
+              <span class="label">${item.label}</span>
+              <span
+                class="status"
+                data-tone=${item.status === "failed" ? "danger" : item.status === "ready" ? "success" : ""}
+                >${t[item.status]}</span
+              >
+              <span class="muted">${host._size(item)}</span>
+              <button
+                class="text-button"
+                type="button"
+                data-id=${item.id}
+                aria-expanded=${open ? "true" : "false"}
+                aria-controls=${`preview-${item.id}`}
+                aria-label=${host._label(open ? "hide" : "inspect", item)}
+                @click=${host._toggle}
+              >
+                <span aria-hidden="true">${open ? "\u25B4" : "\u25BE"}</span>
+              </button>
+              <button
+                class="text-button"
+                type="button"
+                data-id=${item.id}
+                aria-label=${host._label("remove", item)}
+                ?disabled=${host.disabled}
+                @click=${host._remove}
+              >
+                <span aria-hidden="true">✕</span>
+              </button>
+            </div>
+            <p class="error" ?hidden=${!item.error}>${item.error?.message ?? ""}</p>
+            <div class="preview" id=${`preview-${item.id}`} ?hidden=${!open}>
+              <p class="muted" ?hidden=${!item.detail}>${item.detail ?? ""}</p>
+              <pre class="excerpt" ?hidden=${!item.preview}>${item.preview ?? ""}</pre>
+              <p class="muted" ?hidden=${!!item.preview || !!item.detail}>${t.noPreview}</p>
+            </div>
+          </li>`;
+  })}
+    </ul>
+    <div part="add" class="actions add">
+      <input type="file" multiple accept=${host.accept || null} hidden @change=${host._onFiles} />
+      <button
+        class="text-button"
+        type="button"
+        ?disabled=${host.disabled}
+        @click=${host._pickFiles}
+      >
+        ${t.addFiles}
+      </button>
+      ${host.allowUrls ? html`<form class="url" @submit=${host._addUrl}>
+              <label
+                ><span class="visually-hidden">${t.url}</span>
+                <input
+                  type="url"
+                  placeholder="https://"
+                  aria-describedby="url-error"
+                  ?disabled=${host.disabled}
+                  aria-invalid=${host._urlError.value ? "true" : null}
+                />
+              </label>
+              <button class="text-button" type="submit" ?disabled=${host.disabled}>
+                ${t.addUrl}
+              </button>
+            </form>` : null}
+    </div>
+    <p id="url-error" class="error" ?hidden=${!host._urlError.value}>${host._urlError.value}</p>
+  </div>`;
+};
+export {
+  contextPickerTemplate
+};

package/dist/prod/context-picker/index.js

@@ -0,0 +1,11 @@
+import { OddkinContextPicker, CONTEXT_PICKER_STRINGS } from "./context-picker.js";
+import { contextPickerTemplate } from "./context-picker.template.js";
+import { contextPickerStyles } from "./context-picker.styles.js";
+import { contextPickerDefinition } from "./context-picker.definition.js";
+export {
+  CONTEXT_PICKER_STRINGS,
+  OddkinContextPicker,
+  contextPickerDefinition,
+  contextPickerStyles,
+  contextPickerTemplate
+};

package/dist/prod/contracts/index.js

@@ -0,0 +1,35 @@
+import { ApprovalModel, ArtifactModel, CheckpointModel, ContextItemModel, ConversationSnapshotModel, FeedbackModel, MessageModel, ModelOptionModel, PlanModel, QuestionModel, SuggestionModel, ToolCallModel, TranscriptSegmentModel, UsageModel, approvalStatusValues, capabilitiesSchema, partSchema, provenanceSchema, publicErrorSchema } from "./models.js";
+import { CAPABILITY_NAMES, can, intersectCapabilities, normalizeApproval, normalizeArtifact, normalizeMessage, normalizePart, normalizeSnapshot, normalizeToolCall, pickDeclared, toPublicError, unavailableReason } from "./normalize.js";
+export {
+  ApprovalModel,
+  ArtifactModel,
+  CAPABILITY_NAMES,
+  CheckpointModel,
+  ContextItemModel,
+  ConversationSnapshotModel,
+  FeedbackModel,
+  MessageModel,
+  ModelOptionModel,
+  PlanModel,
+  QuestionModel,
+  SuggestionModel,
+  ToolCallModel,
+  TranscriptSegmentModel,
+  UsageModel,
+  approvalStatusValues,
+  can,
+  capabilitiesSchema,
+  intersectCapabilities,
+  normalizeApproval,
+  normalizeArtifact,
+  normalizeMessage,
+  normalizePart,
+  normalizeSnapshot,
+  normalizeToolCall,
+  partSchema,
+  pickDeclared,
+  provenanceSchema,
+  publicErrorSchema,
+  toPublicError,
+  unavailableReason
+};