@alia.onl/sdk 22.4.0 → 22.6.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @alia.onl/sdk
 
+## 22.6.0
+
+- **`@alia.onl/sdk/dictation`: dictation's request on its own.** `requestTranscription`,
+  `DictationError`, `dictationFailureCode`, `normalizeAudioMediaType` and `MAX_DICTATION_MS`, the
+  same functions `useDictation` and `AliaComposer` use, from an entry that reaches no React, no
+  native module, no recorder and no Oxy client (`check:entries` holds it). An app that records
+  its own audio (Astro's browser shell) sends its clips from here instead of keeping a copy of
+  the request. Nothing changes for the root entry, which still exports `requestTranscription`
+  and `DictationError`.
+
+## 22.5.0
+
+- **`AliaApi.put`.** The REST API (`useAliaApi`, `createAliaApi`) sends PUT like PATCH: the
+  linked Oxy client's authentication and 401 replay, the app assertion and a JSON body. Alia's
+  memory profile takes its sections by PUT (`/memory/context`, `/memory/preferences`,
+  `/memory/settings`), so a host's personalization settings can save them without its own client.
+
 ## 22.4.0
 
 - **A shared conversation shows its artifacts.** `readSharedConversation` keeps an assistant

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "22.4.0",
+  "version": "22.6.0",
   "description": "Alia AI chat SDK — the conversation runtime, chat UI, voice calls and dictation for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -13,6 +13,7 @@
     "./avatar": "./src/avatar.ts",
     "./content": "./src/lib/content-utils.ts",
     "./csp": "./src/csp.ts",
+    "./dictation": "./src/dictation.ts",
     "./model": "./src/runtime/model.ts",
     "./runtime": "./src/runtime/index.ts",
     "./text": "./src/text.ts",

package/src/dictation.ts

@@ -0,0 +1,20 @@
+// @alia.onl/sdk/dictation — dictation's request, without a component, a hook or a recorder
+// `POST /v1/audio/transcriptions` (ADR 0017 §7) as plain functions: an app that records audio its
+// own way (Astro's browser shell) sends its clips from here and reaches no React, no native module
+// and no Oxy client. `useDictation` and `AliaComposer` use the same request.
+
+export {
+  DictationError,
+  dictationFailureCode,
+  MAX_DICTATION_MS,
+  normalizeAudioMediaType,
+  requestTranscription,
+} from './lib/dictation';
+export type {
+  DictationClip,
+  DictationErrorCode,
+  TranscriptionRequest,
+  TranscriptionResult,
+} from './lib/dictation';
+export type { AudioRequestAuthentication } from './lib/audio-request-auth';
+export type { VoiceErrorCode } from './lib/speech-messages';

package/src/runtime/api.ts

@@ -44,6 +44,8 @@ export interface AliaApi {
   get<T>(path: string, request?: AliaApiRequest): Promise<AliaApiResult<T>>;
   post<T>(path: string, body?: unknown, request?: AliaApiRequest): Promise<AliaApiResult<T>>;
   patch<T>(path: string, body?: unknown, request?: AliaApiRequest): Promise<AliaApiResult<T>>;
+  /** Replaces a resource whole, for the routes that take PUT (the memory profile's sections). */
+  put<T>(path: string, body?: unknown, request?: AliaApiRequest): Promise<AliaApiResult<T>>;
   delete<T>(path: string, request?: AliaApiRequest): Promise<AliaApiResult<T>>;
 }
 
@@ -95,7 +97,7 @@ export function createAliaApi(
   appAssertionHeaders: AppAssertionHeaders = NO_APP_ASSERTION,
 ): AliaApi {
   async function send<T>(
-    method: 'GET' | 'POST' | 'PATCH' | 'DELETE',
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',
     path: string,
     request: AliaApiRequest = {},
   ): Promise<AliaApiResult<T>> {
@@ -125,6 +127,7 @@ export function createAliaApi(
     get: (path, request) => send('GET', path, request),
     post: (path, body, request) => send('POST', path, { ...request, body: body ?? {} }),
     patch: (path, body, request) => send('PATCH', path, { ...request, body: body ?? {} }),
+    put: (path, body, request) => send('PUT', path, { ...request, body: body ?? {} }),
     delete: (path, request) => send('DELETE', path, request),
   };
 }