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

package/dist/conversation/conversation.styles.js

@@ -0,0 +1,66 @@
+import { css } from '@oddkin/core/styles';
+import { token } from '@oddkin/tokens/refs';
+import { conversationRecipeStyles } from './conversation.recipe.styles.js';
+/** The arrangement is the layout recipe in `conversation.recipe.ts`. */
+export const conversationStyles = css `
+  ${conversationRecipeStyles}
+  :host {
+    display: block;
+    block-size: 100%;
+    min-block-size: 12rem;
+  }
+  .base {
+    position: relative;
+    block-size: 100%;
+    min-block-size: 0;
+  }
+  .scroller {
+    flex: 1 1 auto;
+    min-block-size: 8rem;
+    overflow-y: auto;
+    padding-block: ${token('space.sm')};
+    padding-inline: ${token('space.xs')};
+  }
+  .scroller:focus-visible {
+    outline-offset: -2px;
+  }
+  .feed {
+    max-inline-size: var(--odd-conversation-max-width, 48rem);
+    margin-inline: auto;
+  }
+  .feed > odd-message {
+    border-radius: ${token('radius.md')};
+  }
+  .feed > odd-message:focus-visible {
+    outline: ${token('focus.width')} solid ${token('color.focus.ring')};
+    outline-offset: ${token('space.2xs')};
+  }
+  .history,
+  .empty {
+    margin-block-end: ${token('space.sm')};
+  }
+  .jump {
+    position: absolute;
+    inset-inline-end: ${token('space.sm')};
+    inset-block-end: 6rem;
+    min-block-size: ${token('target.min')};
+    padding-inline: ${token('space.sm')};
+    border: ${token('border.width.default')} solid ${token('color.border.strong')};
+    border-radius: ${token('radius.full')};
+    background: ${token('color.surface.raised')};
+    color: inherit;
+    font: inherit;
+    font-size: ${token('font.size.sm')};
+    box-shadow: ${token('elevation.md')};
+    cursor: pointer;
+  }
+  odd-activity {
+    padding-inline: ${token('space.xs')};
+  }
+  @media (forced-colors: active) {
+    .jump {
+      border-color: ButtonText;
+    }
+  }
+`;
+//# sourceMappingURL=conversation.styles.js.map

package/dist/conversation/conversation.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.styles.js","sourceRoot":"","sources":["../../src/conversation/conversation.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;IACjC,wBAAwB;;;;;;;;;;;;;;;qBAeP,KAAK,CAAC,UAAU,CAAC;sBAChB,KAAK,CAAC,UAAU,CAAC;;;;;;;;;;qBAUlB,KAAK,CAAC,WAAW,CAAC;;;eAGxB,KAAK,CAAC,aAAa,CAAC,UAAU,KAAK,CAAC,kBAAkB,CAAC;sBAChD,KAAK,CAAC,WAAW,CAAC;;;;wBAIhB,KAAK,CAAC,UAAU,CAAC;;;;wBAIjB,KAAK,CAAC,UAAU,CAAC;;sBAEnB,KAAK,CAAC,YAAY,CAAC;sBACnB,KAAK,CAAC,UAAU,CAAC;cACzB,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,qBAAqB,CAAC;qBAC5D,KAAK,CAAC,aAAa,CAAC;kBACvB,KAAK,CAAC,sBAAsB,CAAC;;;iBAG9B,KAAK,CAAC,cAAc,CAAC;kBACpB,KAAK,CAAC,cAAc,CAAC;;;;sBAIjB,KAAK,CAAC,UAAU,CAAC;;;;;;;CAOtC,CAAC"}

package/dist/conversation/conversation.template.d.ts

@@ -0,0 +1,8 @@
+import type { OddkinConversation } from './conversation.js';
+/**
+ * Anatomy: the `scroller` holds history controls and the `feed` of `odd-message` articles; then
+ * the `jump` button, the `activity` bar, the `status` and `composer` slots, and two live regions
+ * (written only by the announcer).
+ */
+export declare const conversationTemplate: (host: OddkinConversation) => import("@oddkin/core/template").TemplateResult;
+//# sourceMappingURL=conversation.template.d.ts.map

package/dist/conversation/conversation.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.template.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.template.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SAAU,kBAAkB,mDAuG5D,CAAC"}

package/dist/conversation/conversation.template.js

@@ -0,0 +1,107 @@
+import { html, repeat } from '@oddkin/core/template';
+import { can } from '../contracts/normalize.js';
+import { format } from '../internal/strings.js';
+/**
+ * Anatomy: the `scroller` holds history controls and the `feed` of `odd-message` articles; then
+ * the `jump` button, the `activity` bar, the `status` and `composer` slots, and two live regions
+ * (written only by the announcer).
+ */
+export const conversationTemplate = (host) => {
+    const t = host._strings;
+    const state = host.snapshot;
+    const messages = state?.messages ?? [];
+    const count = messages.length;
+    const current = host._current.value ?? messages[count - 1]?.id;
+    const attempt = state?.activeAttemptId ? state.attempts[state.activeAttemptId] : undefined;
+    const history = state?.history ?? 'complete';
+    const showHistory = !!state && state.hasMoreHistory && can(state.capabilities, 'history');
+    const unseen = host._unseen.value;
+    const showActivity = !!attempt &&
+        (attempt.status !== 'completed' || attempt.stop === 'too-late' || attempt.stop === 'unknown') &&
+        !(attempt.status === 'cancelled' && attempt.stop !== 'unknown');
+    // Repeat items render untracked during commit: read everything they use here.
+    const { markdown, renderers, artifactRenderers, renderTool, feedbackReasons } = host;
+    return html `<div class="base" part="base">
+    <div part="scroller" class="scroller" tabindex="-1">
+      <div class="history" ?hidden=${!showHistory && history !== 'error'}>
+        <button
+          class="text-button"
+          type="button"
+          ?hidden=${history !== 'idle'}
+          @click=${host._requestHistory}
+        >
+          ${t.loadEarlier}
+        </button>
+        <span class="muted" ?hidden=${history !== 'loading'}>${t.loading}</span>
+        <span class="error" ?hidden=${history !== 'error'}>${t.historyError}</span>
+        <button
+          class="text-button"
+          type="button"
+          ?hidden=${history !== 'error'}
+          @click=${host._requestHistory}
+        >
+          ${t.retry}
+        </button>
+      </div>
+      <div class="empty" ?hidden=${count > 0}>
+        <slot name="empty"><p class="muted">${t.empty}</p></slot>
+      </div>
+      <div
+        part="feed"
+        class="feed"
+        role="feed"
+        aria-label=${host.label || t.label}
+        aria-busy=${host._busy(state) ? 'true' : 'false'}
+      >
+        ${repeat(messages, (m) => m.id, (m, i) => html `<odd-message
+              role="article"
+              data-id=${m.id}
+              tabindex=${m.id === current ? '0' : '-1'}
+              aria-posinset=${String(i + 1)}
+              aria-setsize=${String(count)}
+              aria-label=${host._messageLabel(m.role, i + 1, count)}
+              .message=${m}
+              .attempt=${m.attemptId ? state?.attempts[m.attemptId] : undefined}
+              .tools=${state?.tools}
+              .approvals=${state?.approvals}
+              .artifacts=${state?.artifacts}
+              .branch=${state?.branches[m.id]}
+              .feedback=${state?.feedback[m.id]}
+              .capabilities=${state?.capabilities}
+              .markdown=${markdown}
+              .renderers=${renderers}
+              .artifactRenderers=${artifactRenderers}
+              .renderTool=${renderTool}
+              .feedbackReasons=${feedbackReasons}
+            ></odd-message>`)}
+      </div>
+    </div>
+    <button
+      part="jump"
+      class="jump"
+      type="button"
+      ?hidden=${host._following.value || !count}
+      @click=${host._jump}
+    >
+      ${unseen ? format(t.jumpNew, { count: unseen }) : t.jump}
+    </button>
+    <odd-activity
+      part="activity"
+      ?hidden=${!showActivity}
+      .attempt=${attempt}
+      .tools=${state ? host._activeTools(state) : []}
+      .capabilities=${state?.capabilities}
+    ></odd-activity>
+    <slot name="status"></slot>
+    <slot name="composer"></slot>
+    <div
+      id="polite"
+      class="visually-hidden"
+      role="status"
+      aria-live="polite"
+      aria-atomic="true"
+    ></div>
+    <div id="assertive" class="visually-hidden" aria-live="assertive" aria-atomic="true"></div>
+  </div>`;
+};
+//# sourceMappingURL=conversation.template.js.map

package/dist/conversation/conversation.template.js.map

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

package/dist/conversation/index.d.ts

@@ -0,0 +1,6 @@
+export { OddkinConversation, CONVERSATION_STRINGS } from './conversation.js';
+export type { ScrollPosition } from './conversation.js';
+export { conversationTemplate } from './conversation.template.js';
+export { conversationStyles } from './conversation.styles.js';
+export { conversationDefinition } from './conversation.definition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/conversation/index.js

@@ -0,0 +1,6 @@
+// Side-effect free. Register with `@oddkin/ai/define/conversation`.
+export { OddkinConversation, CONVERSATION_STRINGS } from './conversation.js';
+export { conversationTemplate } from './conversation.template.js';
+export { conversationStyles } from './conversation.styles.js';
+export { conversationDefinition } from './conversation.definition.js';
+//# sourceMappingURL=index.js.map

package/dist/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,198 @@
+/**
+ * User-intent events of `@oddkin/ai` elements. Every event bubbles and is composed so it crosses
+ * the shadow roots of nested elements (a tool call inside a message inside a conversation).
+ * Dispatching an event *requests* an operation; the outcome arrives later as changed records
+ * (or a controller method's result), never as the event's return value. A cancelable event's
+ * `preventDefault()` is a synchronous veto of the element's local default action only.
+ * Programmatic property changes never dispatch these events (`intent: 'user'`); `odd-announce` is
+ * the exception, a notification from any source (`intent: 'notification'`). Options are literal
+ * so the analyzer can publish them. Contract: docs/architecture/ai-interaction.md §7.
+ */
+import { type EventDetail } from '@oddkin/core/element';
+import type { JsonValue } from './contracts/types.js';
+import type { AttachmentState } from './controllers/composer.js';
+import type { TextSelection } from './controllers/document.js';
+export interface PromptSubmitDetail {
+    readonly submissionId: string;
+    /** Draft revision captured; acknowledging clears the draft only if unchanged since. */
+    readonly revision: number;
+    readonly text: string;
+    readonly attachments: readonly AttachmentState[];
+}
+/** Request to send the draft. Cancel to veto: the composer stays editable and idle. */
+export declare const promptSubmitEvent: import("@oddkin/core/element").EventDefinition<PromptSubmitDetail>;
+export declare const promptStopEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly attemptId: string | undefined;
+}>;
+export declare const attachmentAddEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly attachments: readonly AttachmentState[];
+}>;
+export declare const attachmentRemoveEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly attachmentId: string;
+}>;
+export declare const historyRequestEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly conversationId: string;
+    readonly beforeMessageId: string | undefined;
+}>;
+export declare const messageEditEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly messageId: string;
+    readonly text: string;
+}>;
+export declare const messageRegenerateEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly messageId: string;
+    readonly attemptId: string;
+}>;
+export declare const attemptRetryEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly attemptId: string;
+}>;
+export declare const attemptResumeEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly attemptId: string;
+}>;
+export declare const branchSwitchEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly messageId: string;
+    readonly targetMessageId: string;
+}>;
+export interface ApprovalDecideDetail {
+    readonly approvalId: string;
+    readonly revision: number;
+    readonly toolCallId: string | undefined;
+    readonly decision: 'approve' | 'reject';
+    readonly reason: string | undefined;
+}
+export declare const approvalDecideEvent: import("@oddkin/core/element").EventDefinition<ApprovalDecideDetail>;
+export declare const approvalEditEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly approvalId: string;
+    readonly revision: number;
+}>;
+export declare const toolRetryEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly toolCallId: string;
+}>;
+export declare const citationOpenEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly sourceId: string;
+    readonly resolved: boolean;
+}>;
+export declare const artifactExportEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly artifactId: string;
+    readonly revisionId: string;
+    readonly format: string;
+}>;
+export declare const artifactRevisionEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly artifactId: string;
+    readonly revisionId: string;
+}>;
+export declare const suggestionSelectEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly suggestionId: string;
+    readonly prompt: string;
+}>;
+export declare const suggestionSubmitEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly suggestionId: string;
+    readonly prompt: string;
+}>;
+export interface FeedbackSubmitDetail {
+    readonly messageId: string;
+    readonly rating: 'positive' | 'negative';
+    readonly reasons: readonly string[];
+    readonly comment: string;
+}
+export declare const feedbackSubmitEvent: import("@oddkin/core/element").EventDefinition<FeedbackSubmitDetail>;
+export declare const modelChangeEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly modelId: string;
+    readonly previousModelId: string;
+}>;
+export declare const checkpointRestoreEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly checkpointId: string;
+}>;
+export declare const questionAnswerEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly questionId: string;
+    readonly revision: number;
+    readonly answer: JsonValue;
+}>;
+export declare const questionSkipEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly questionId: string;
+    readonly revision: number;
+}>;
+export declare const changeAcceptEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly proposalId: string;
+}>;
+export declare const changeRejectEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly proposalId: string;
+}>;
+export declare const changeUndoEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly proposalId: string;
+}>;
+export type AssistAction = 'rewrite' | 'explain' | 'summarize' | 'translate' | 'expand';
+export interface AssistRequestDetail {
+    readonly action: string;
+    readonly selection: TextSelection;
+    readonly options: {
+        readonly language?: string;
+    };
+}
+export declare const assistRequestEvent: import("@oddkin/core/element").EventDefinition<AssistRequestDetail>;
+export type ContextAddDetail = {
+    readonly kind: 'file';
+    readonly files: readonly File[];
+} | {
+    readonly kind: 'url';
+    readonly url: string;
+};
+export declare const contextAddEvent: import("@oddkin/core/element").EventDefinition<ContextAddDetail>;
+export declare const contextRemoveEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly itemId: string;
+}>;
+export declare const planInputEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly planId: string;
+    readonly stepId: string;
+}>;
+export declare const voiceTranscriptEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly text: string;
+}>;
+export declare const transcriptChangeEvent: import("@oddkin/core/element").EventDefinition<{
+    readonly segmentId: string;
+    readonly text: string;
+}>;
+export interface AnnounceDetail {
+    readonly text: string;
+    readonly priority: 'polite' | 'assertive';
+    /** Identical keys are announced once per surface. */
+    readonly key: string;
+}
+export declare const announceEvent: import("@oddkin/core/element").EventDefinition<AnnounceDetail>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'odd-announce': CustomEvent<EventDetail<typeof announceEvent>>;
+        'odd-approval-decide': CustomEvent<EventDetail<typeof approvalDecideEvent>>;
+        'odd-approval-edit': CustomEvent<EventDetail<typeof approvalEditEvent>>;
+        'odd-artifact-export': CustomEvent<EventDetail<typeof artifactExportEvent>>;
+        'odd-artifact-revision-change': CustomEvent<EventDetail<typeof artifactRevisionEvent>>;
+        'odd-assist-request': CustomEvent<EventDetail<typeof assistRequestEvent>>;
+        'odd-attachment-add': CustomEvent<EventDetail<typeof attachmentAddEvent>>;
+        'odd-attachment-remove': CustomEvent<EventDetail<typeof attachmentRemoveEvent>>;
+        'odd-attempt-resume': CustomEvent<EventDetail<typeof attemptResumeEvent>>;
+        'odd-attempt-retry': CustomEvent<EventDetail<typeof attemptRetryEvent>>;
+        'odd-branch-switch': CustomEvent<EventDetail<typeof branchSwitchEvent>>;
+        'odd-change-accept': CustomEvent<EventDetail<typeof changeAcceptEvent>>;
+        'odd-change-reject': CustomEvent<EventDetail<typeof changeRejectEvent>>;
+        'odd-change-undo': CustomEvent<EventDetail<typeof changeUndoEvent>>;
+        'odd-checkpoint-restore': CustomEvent<EventDetail<typeof checkpointRestoreEvent>>;
+        'odd-citation-open': CustomEvent<EventDetail<typeof citationOpenEvent>>;
+        'odd-context-add': CustomEvent<EventDetail<typeof contextAddEvent>>;
+        'odd-context-remove': CustomEvent<EventDetail<typeof contextRemoveEvent>>;
+        'odd-feedback-submit': CustomEvent<EventDetail<typeof feedbackSubmitEvent>>;
+        'odd-history-request': CustomEvent<EventDetail<typeof historyRequestEvent>>;
+        'odd-message-edit': CustomEvent<EventDetail<typeof messageEditEvent>>;
+        'odd-message-regenerate': CustomEvent<EventDetail<typeof messageRegenerateEvent>>;
+        'odd-model-change': CustomEvent<EventDetail<typeof modelChangeEvent>>;
+        'odd-plan-input-request': CustomEvent<EventDetail<typeof planInputEvent>>;
+        'odd-prompt-stop': CustomEvent<EventDetail<typeof promptStopEvent>>;
+        'odd-prompt-submit': CustomEvent<EventDetail<typeof promptSubmitEvent>>;
+        'odd-question-answer': CustomEvent<EventDetail<typeof questionAnswerEvent>>;
+        'odd-question-skip': CustomEvent<EventDetail<typeof questionSkipEvent>>;
+        'odd-suggestion-select': CustomEvent<EventDetail<typeof suggestionSelectEvent>>;
+        'odd-suggestion-submit': CustomEvent<EventDetail<typeof suggestionSubmitEvent>>;
+        'odd-tool-retry': CustomEvent<EventDetail<typeof toolRetryEvent>>;
+        'odd-transcript-change': CustomEvent<EventDetail<typeof transcriptChangeEvent>>;
+        'odd-voice-transcript': CustomEvent<EventDetail<typeof voiceTranscriptEvent>>;
+    }
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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