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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Brady
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,109 @@
-# Temporary Holding Version
+# @oddkin/ai
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional AI interaction package: typed records, DOM-free controllers, stream adapters, and accessible `odd-*` elements for conversation interfaces, inline assistance, research tools, and agent workflows. No model calls, no storage, no third-party runtime dependencies.
+
+**Status:** implemented and verified (IMPLEMENTATION_PLAN.md §5j). Contract: [ai-interaction.md](../../docs/architecture/ai-interaction.md). Decision: [ADR 0040](../../docs/architecture/decisions/0040-ai-interaction-package.md). Demos: [research assistant](../../examples/ai-research/), [inline writing assistant](../../examples/ai-writing/), [agent task panel](../../examples/ai-agent/).
+
+## Install and register
+
+Depends on `@oddkin/core`, `@oddkin/tokens`, and `@oddkin/components`. Load a theme stylesheet (e.g. `@oddkin/tokens/css/default.css`). Register only what you use:
+
+```js
+import '@oddkin/ai/define/conversation'; // also registers odd-message, odd-response, odd-tool-call, …
+import '@oddkin/ai/define/prompt-input';
+```
+
+Importing `@oddkin/ai/<element>` gives the class, template, styles, definition, and default strings without registering anything. The root entry and `./contracts`, `./controllers`, `./events`, and `./stream` import without a DOM.
+
+## Controller-backed conversation (plain JavaScript)
+
+```html
+<odd-conversation label="Assistant">
+  <odd-prompt-input slot="composer" label="Ask a question"></odd-prompt-input>
+</odd-conversation>
+```
+
+```js
+import { ComposerController, ConversationController, bindIntents, controllerIntents, isActive } from '@oddkin/ai/controllers';
+import { createUiMessageStreamTransport } from '@oddkin/ai/stream';
+
+const transport = createUiMessageStreamTransport({
+  api: '/api/chat',                                   // your endpoint (AI SDK UI message stream v1)
+  stopApi: (t) => `/api/chat/${t.attemptId}/stop`,   // optional: enables Stop
+  resumeApi: (t) => `/api/chat/${t.attemptId}/stream`, // optional: enables Resume
+});
+const controller = new ConversationController({ transport, conversationId: 'c1' });
+const draft = new ComposerController({ accept: ['image/*', '.pdf'], maxFileSize: 5_000_000 });
+
+const conversation = document.querySelector('odd-conversation');
+const composer = document.querySelector('odd-prompt-input');
+conversation.store = controller;
+composer.controller = draft;
+bindIntents(conversation, controllerIntents(controller, draft));
+controller.subscribe(() => {
+  const state = controller.getSnapshot();
+  const attempt = state.activeAttemptId ? state.attempts[state.activeAttemptId] : undefined;
+  composer.loading = !!attempt && isActive(attempt.status);
+  composer.attemptId = attempt?.attemptId ?? '';
+  composer.capabilities = state.capabilities;
+});
+```
+
+`createSimulatedTransport` (`@oddkin/ai/stream`) replaces the network for tests and demos.
+
+## Application-owned state (controlled)
+
+```js
+import { createConversationView, selectSource, bindIntents } from '@oddkin/ai/controllers';
+
+conversation.store = selectSource(store, (s) =>
+  createConversationView({ conversationId: s.id, messages: s.messages, tools: s.tools, approvals: s.approvals, capabilities: s.capabilities }),
+);
+bindIntents(conversation, {
+  'odd-approval-decide': (d) => api.decide(d.approvalId, d.revision, d.decision), // your store updates the record
+  'odd-prompt-stop': (d) => api.stop(d.attemptId),
+});
+```
+
+Or assign a validated snapshot directly: `conversation.state = createConversationView(…)`.
+
+## Frameworks
+
+Elements use properties for records and typed, bubbling, composed events for intents.
+
+- React 19: `<odd-action-approval approval={record} capabilities={caps} onodd-approval-decide={(e) => decide(e.detail)} />`
+- Vue 3: `<odd-action-approval :approval="record" :capabilities="caps" @odd-approval-decide="decide($event.detail)" />` (configure `compilerOptions.isCustomElement` for `odd-` tags)
+
+## Elements
+
+| Element | Purpose |
+| --- | --- |
+| `odd-conversation`, `odd-message` | Feed of messages, history, follow-latest scrolling, announcements, run status, composer slot |
+| `odd-prompt-input` | Composer: multiline input, IME-safe Enter, attachments (paste, drop, picker), Send/Stop |
+| `odd-response` | Streaming Markdown with citations, code, tables; canonical copy |
+| `odd-citation`, `odd-sources` | Inline references with previews; source list |
+| `odd-tool-call` | Tool identity, purpose, streamed arguments, execution state, result, retry |
+| `odd-action-approval` | Approve/reject one revision of a proposed action |
+| `odd-context-picker` | Files, documents, URLs, selections with statuses |
+| `odd-activity`, `odd-task-plan` | Run status and recovery actions; plans with parallel tasks, blockers, input requests |
+| `odd-artifact` | Revisions, preview/source, copy, export, host renderers |
+| `odd-inline-assist`, `odd-change-review` | Selection actions; before/after review with accept, reject, undo |
+| `odd-message-branch` | Alternative responses and edited prompts |
+| `odd-question` | Clarifying questions: choices, forms, custom answers |
+| `odd-ai-label` | Provenance supplied by the application |
+| `odd-suggestions` | Insert or send suggested prompts |
+| `odd-response-feedback` | Ratings with reasons and comments |
+| `odd-model-select` | Application-provided models with availability |
+| `odd-usage-meter` | Measured, estimated, and unknown usage |
+| `odd-voice-input`, `odd-transcript` | Dictation with replaceable adapters; editable transcripts |
+| `odd-checkpoint` | Restore points with confirmed outcomes |
+
+Full API (properties, attributes, events, slots, parts, CSS properties) is in `custom-elements.json` and `oddkin.metadata.json`; record schemas in `schemas/`.
+
+## States you must report
+
+Elements show what records say. Report loading, empty, interrupted, denied, stale, failed, and recovered states through records (`AttemptRecord.status`, tool/approval/question/checkpoint `status`, `PublicError`) and capabilities (`{ available: false, reason }`). An event is a request: the element stays pending until the record changes.
+
+## Host responsibilities
+
+Transport, persistence, authorization and execution of approved actions, uploads, transcription, telemetry, sanitizer choice for raw HTML, `data`/artifact renderers, localization (`strings` on every element), and truthful usage precision and provenance. See [ai-interaction.md §12](../../docs/architecture/ai-interaction.md#12-host-application-responsibilities).

package/agent/GUIDE.md

@@ -0,0 +1,39 @@
+# @oddkin/ai 1.0.0-beta.0: agent guide
+
+Generated from this package's published metadata when it was built (fingerprint in kit.json), so it matches the installed version. Read the reference for a component before using it.
+
+## Install and register
+
+- Package `@oddkin/ai`, which depends on `@oddkin/components`, `@oddkin/core`, `@oddkin/tokens`.
+- Register an element once before using its tag: `import '@oddkin/ai/define/<name>';`, where `<name>` is the tag after its prefix (`<odd-action-approval>`: `import '@oddkin/ai/define/action-approval';`). Class exports are in each component reference.
+
+## Components
+
+Each has a reference at `references/components/<tag>.md` with its exact API, guidance, and examples.
+
+- **AI:** `<odd-action-approval>`, `<odd-activity>`, `<odd-ai-label>`, `<odd-artifact>`, `<odd-change-review>`, `<odd-checkpoint>`, `<odd-citation>`, `<odd-context-picker>`, `<odd-conversation>`, `<odd-inline-assist>`, `<odd-message>`, `<odd-message-branch>`, `<odd-model-select>`, `<odd-prompt-input>`, `<odd-question>`, `<odd-response>`, `<odd-response-feedback>`, `<odd-sources>`, `<odd-suggestions>`, `<odd-task-plan>`, `<odd-tool-call>`, `<odd-transcript>`, `<odd-usage-meter>`, `<odd-voice-input>`
+
+Choosing between them: references/choosing-components.md.
+
+## Rules from the metadata
+
+- Property-only values (assign as JavaScript properties, never attributes): `odd-action-approval.approval`, `odd-action-approval.capabilities`, `odd-action-approval.strings`, `odd-activity.attempt`, `odd-activity.capabilities`, `odd-activity.strings`, `odd-activity.tools`, `odd-ai-label.provenance`, `odd-ai-label.strings`, `odd-artifact.artifact`, `odd-artifact.exports`, `odd-artifact.markdown`, `odd-artifact.renderers`, `odd-artifact.strings`, `odd-change-review.proposals`, `odd-change-review.strings`, `odd-checkpoint.capabilities`, `odd-checkpoint.checkpoint`, `odd-checkpoint.strings`, `odd-citation.source`, `odd-citation.strings`, `odd-context-picker.items`, `odd-context-picker.strings`, `odd-conversation.artifactRenderers`, `odd-conversation.feedbackReasons`, `odd-conversation.markdown`, `odd-conversation.renderTool`, `odd-conversation.renderers`, `odd-conversation.state`, `odd-conversation.store`, `odd-conversation.strings`, `odd-inline-assist.actions`, `odd-inline-assist.error`, `odd-inline-assist.languages`, `odd-inline-assist.markdown`, `odd-inline-assist.result`, `odd-inline-assist.selection`, `odd-inline-assist.strings`, `odd-message.approvals`, `odd-message.artifactRenderers`, `odd-message.artifacts`, `odd-message.attempt`, `odd-message.branch`, `odd-message.capabilities`, `odd-message.feedback`, `odd-message.feedbackReasons`, `odd-message.markdown`, `odd-message.message`, `odd-message.renderTool`, `odd-message.renderers`, `odd-message.strings`, `odd-message.tools`, `odd-message-branch.branch`, `odd-message-branch.capabilities`, `odd-message-branch.strings`, `odd-model-select.models`, `odd-model-select.strings`, `odd-prompt-input.capabilities`, `odd-prompt-input.controller`, `odd-prompt-input.strings`, `odd-prompt-input.value`, `odd-question.question`, `odd-question.strings`, `odd-response.error`, `odd-response.markdown`, `odd-response.sources`, `odd-response.strings`, `odd-response.text`, `odd-response-feedback.feedback`, `odd-response-feedback.reasons`, `odd-response-feedback.strings`, `odd-sources.sources`, `odd-sources.strings`, `odd-suggestions.strings`, `odd-suggestions.suggestions`, `odd-task-plan.plan`, `odd-task-plan.strings`, `odd-tool-call.approval`, `odd-tool-call.capabilities`, `odd-tool-call.renderOutput`, `odd-tool-call.strings`, `odd-tool-call.tool`, `odd-transcript.interim`, `odd-transcript.segments`, `odd-transcript.strings`, `odd-usage-meter.strings`, `odd-usage-meter.usage`, `odd-voice-input.adapter`, `odd-voice-input.controller`, `odd-voice-input.strings`.
+- Events declared with user intent (authored; see each reference): `odd-approval-decide`, `odd-approval-edit`, `odd-attempt-resume`, `odd-attempt-retry`, `odd-prompt-stop`, `odd-artifact-export`, `odd-artifact-revision-change`, `odd-change-accept`, `odd-change-reject`, `odd-change-undo`, `odd-checkpoint-restore`, `odd-citation-open`, `odd-source-reveal`, `odd-context-add`, `odd-context-remove`, `odd-history-request`, `odd-assist-request`, `odd-message-edit`, `odd-message-regenerate`, `odd-branch-switch`, `odd-model-change`, `odd-attachment-add`, `odd-attachment-remove`, `odd-prompt-submit`, `odd-question-answer`, `odd-question-skip`, `odd-feedback-submit`, `odd-suggestion-select`, `odd-suggestion-submit`, `odd-plan-input-request`, `odd-tool-retry`, `odd-transcript-change`, `odd-voice-transcript`. Other events state their intent, or that it is unknown, in each reference.
+- Contracts the components reference (`@oddkin/core/CONTRACTS.md`): `contract:core/binding-rule` Binding rule; `contract:core/properties` Public properties; `contract:core/events` Events; `contract:core/lifecycle` Lifecycle; `contract:core/update-complete` updateComplete and commit timing; `contract:core/scope` Scope: ownership and cleanup; `contract:core/composition` Composed definitions.
+
+## More references
+
+- Tokens (theme `default`): references/tokens/component.md, references/tokens/foundation.md, references/tokens/layout.md, references/tokens/reference.md, references/tokens/semantic.md.
+- Recipes: references/recipes/action-approval.md, references/recipes/activity.md, references/recipes/ai-element.md, references/recipes/artifact.md, references/recipes/change-review.md, references/recipes/checkpoint.md, references/recipes/citation.md, references/recipes/context-picker.md, references/recipes/conversation.md, references/recipes/inline-assist.md, references/recipes/message.md, references/recipes/prompt-input.md, references/recipes/question.md, references/recipes/response-feedback.md, references/recipes/sources.md, references/recipes/suggestions.md, references/recipes/task-plan.md, references/recipes/tool-call.md, references/recipes/transcript.md, references/recipes/usage-meter.md, references/recipes/voice-input.md.
+- Models: references/models/oddkin.ai.approval.md, references/models/oddkin.ai.artifact.md, references/models/oddkin.ai.checkpoint.md, references/models/oddkin.ai.context-item.md, references/models/oddkin.ai.conversation.md, references/models/oddkin.ai.feedback.md, references/models/oddkin.ai.message.md, references/models/oddkin.ai.model-option.md, references/models/oddkin.ai.plan.md, references/models/oddkin.ai.question.md, references/models/oddkin.ai.suggestion.md, references/models/oddkin.ai.tool-call.md, references/models/oddkin.ai.transcript-segment.md, references/models/oddkin.ai.usage.md.
+- JSON keyed by stable id, shipped beside this kit: `@oddkin/ai/oddkin.metadata.json` (components, recipes, stylesheets, models), `@oddkin/ai/custom-elements.json`, and the theme's tokens in `@oddkin/tokens/inspect/default.json`.
+
+## Workspace commands
+
+- build: `npm run build`
+- typecheck: `npm run typecheck`
+- test: `npm test`
+- e2e: `npm run test:e2e`
+- lint: `npm run lint`
+- verify: `npm run verify`
+- metadata: `npm run verify:metadata`

package/agent/kit.json

@@ -0,0 +1,425 @@
+{
+  "schema": "https://oddkin.dev/schemas/agent-kit/v1.json",
+  "library": {
+    "name": "@oddkin/ai",
+    "version": "1.0.0-beta.0"
+  },
+  "fingerprint": {
+    "generator": {
+      "name": "oddkin-agent-kit-pilot",
+      "version": "0.0.0-pilot.af99be4d5faf"
+    },
+    "schemaVersion": 1,
+    "packages": {
+      "@oddkin/ai": "1.0.0-beta.0",
+      "@oddkin/components": "1.0.0-beta.0",
+      "@oddkin/core": "1.0.0-beta.0",
+      "@oddkin/tokens": "1.0.0-beta.0"
+    },
+    "inputs": "sha256-729a37e207a109509e85c7160a9d9866cb11f1ec593575ed36218c0c1e84579c"
+  },
+  "metadata": {
+    "file": "oddkin.metadata.json",
+    "sha256": "4c0eb0c400f7c2800797f72bfa4ff87bcc2cfc735a6db8ae977867979e888367"
+  },
+  "guide": {
+    "path": "GUIDE.md",
+    "budgetBytes": 8192,
+    "bytes": 7108
+  },
+  "entries": [
+    {
+      "id": "component:odd-action-approval",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-action-approval.md"
+    },
+    {
+      "id": "component:odd-activity",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-activity.md"
+    },
+    {
+      "id": "component:odd-ai-label",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-ai-label.md"
+    },
+    {
+      "id": "component:odd-artifact",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-artifact.md"
+    },
+    {
+      "id": "component:odd-change-review",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-change-review.md"
+    },
+    {
+      "id": "component:odd-checkpoint",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-checkpoint.md"
+    },
+    {
+      "id": "component:odd-citation",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-citation.md"
+    },
+    {
+      "id": "component:odd-context-picker",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-context-picker.md"
+    },
+    {
+      "id": "component:odd-conversation",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-conversation.md"
+    },
+    {
+      "id": "component:odd-inline-assist",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-inline-assist.md"
+    },
+    {
+      "id": "component:odd-message",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-message.md"
+    },
+    {
+      "id": "component:odd-message-branch",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-message-branch.md"
+    },
+    {
+      "id": "component:odd-model-select",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-model-select.md"
+    },
+    {
+      "id": "component:odd-prompt-input",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-prompt-input.md"
+    },
+    {
+      "id": "component:odd-question",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-question.md"
+    },
+    {
+      "id": "component:odd-response",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-response.md"
+    },
+    {
+      "id": "component:odd-response-feedback",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-response-feedback.md"
+    },
+    {
+      "id": "component:odd-sources",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-sources.md"
+    },
+    {
+      "id": "component:odd-suggestions",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-suggestions.md"
+    },
+    {
+      "id": "component:odd-task-plan",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-task-plan.md"
+    },
+    {
+      "id": "component:odd-tool-call",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-tool-call.md"
+    },
+    {
+      "id": "component:odd-transcript",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-transcript.md"
+    },
+    {
+      "id": "component:odd-usage-meter",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-usage-meter.md"
+    },
+    {
+      "id": "component:odd-voice-input",
+      "kind": "component",
+      "provenance": "extracted",
+      "path": "references/components/odd-voice-input.md"
+    },
+    {
+      "id": "choosing",
+      "kind": "choosing",
+      "provenance": "authored",
+      "path": "references/choosing-components.md"
+    },
+    {
+      "id": "tokens:component",
+      "kind": "tokens",
+      "provenance": "extracted",
+      "path": "references/tokens/component.md"
+    },
+    {
+      "id": "tokens:foundation",
+      "kind": "tokens",
+      "provenance": "extracted",
+      "path": "references/tokens/foundation.md"
+    },
+    {
+      "id": "tokens:layout",
+      "kind": "tokens",
+      "provenance": "extracted",
+      "path": "references/tokens/layout.md"
+    },
+    {
+      "id": "tokens:reference",
+      "kind": "tokens",
+      "provenance": "extracted",
+      "path": "references/tokens/reference.md"
+    },
+    {
+      "id": "tokens:semantic",
+      "kind": "tokens",
+      "provenance": "extracted",
+      "path": "references/tokens/semantic.md"
+    },
+    {
+      "id": "recipe:action-approval",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/action-approval.md"
+    },
+    {
+      "id": "recipe:activity",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/activity.md"
+    },
+    {
+      "id": "recipe:ai-element",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/ai-element.md"
+    },
+    {
+      "id": "recipe:artifact",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/artifact.md"
+    },
+    {
+      "id": "recipe:change-review",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/change-review.md"
+    },
+    {
+      "id": "recipe:checkpoint",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/checkpoint.md"
+    },
+    {
+      "id": "recipe:citation",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/citation.md"
+    },
+    {
+      "id": "recipe:context-picker",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/context-picker.md"
+    },
+    {
+      "id": "recipe:conversation",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/conversation.md"
+    },
+    {
+      "id": "recipe:inline-assist",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/inline-assist.md"
+    },
+    {
+      "id": "recipe:message",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/message.md"
+    },
+    {
+      "id": "recipe:prompt-input",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/prompt-input.md"
+    },
+    {
+      "id": "recipe:question",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/question.md"
+    },
+    {
+      "id": "recipe:response-feedback",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/response-feedback.md"
+    },
+    {
+      "id": "recipe:sources",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/sources.md"
+    },
+    {
+      "id": "recipe:suggestions",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/suggestions.md"
+    },
+    {
+      "id": "recipe:task-plan",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/task-plan.md"
+    },
+    {
+      "id": "recipe:tool-call",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/tool-call.md"
+    },
+    {
+      "id": "recipe:transcript",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/transcript.md"
+    },
+    {
+      "id": "recipe:usage-meter",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/usage-meter.md"
+    },
+    {
+      "id": "recipe:voice-input",
+      "kind": "recipe",
+      "provenance": "extracted",
+      "path": "references/recipes/voice-input.md"
+    },
+    {
+      "id": "model:oddkin.ai.approval",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.approval.md"
+    },
+    {
+      "id": "model:oddkin.ai.artifact",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.artifact.md"
+    },
+    {
+      "id": "model:oddkin.ai.checkpoint",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.checkpoint.md"
+    },
+    {
+      "id": "model:oddkin.ai.context-item",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.context-item.md"
+    },
+    {
+      "id": "model:oddkin.ai.conversation",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.conversation.md"
+    },
+    {
+      "id": "model:oddkin.ai.feedback",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.feedback.md"
+    },
+    {
+      "id": "model:oddkin.ai.message",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.message.md"
+    },
+    {
+      "id": "model:oddkin.ai.model-option",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.model-option.md"
+    },
+    {
+      "id": "model:oddkin.ai.plan",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.plan.md"
+    },
+    {
+      "id": "model:oddkin.ai.question",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.question.md"
+    },
+    {
+      "id": "model:oddkin.ai.suggestion",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.suggestion.md"
+    },
+    {
+      "id": "model:oddkin.ai.tool-call",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.tool-call.md"
+    },
+    {
+      "id": "model:oddkin.ai.transcript-segment",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.transcript-segment.md"
+    },
+    {
+      "id": "model:oddkin.ai.usage",
+      "kind": "model",
+      "provenance": "extracted",
+      "path": "references/models/oddkin.ai.usage.md"
+    }
+  ],
+  "packaging": [
+    "llms-txt"
+  ]
+}