@hosty-sdk/app 0.30.0 → 0.31.0

package/dist/providers-server.d.ts

@@ -1,5 +1,5 @@
 import { AssistantClient } from "@hosty-sdk/app/assistant";
-import { type AppPermissionState, type ProviderDescriptor, type ProviderInvocation, type ProviderKind, type SpeechCapabilities, type SpeechResult } from "@hosty-sdk/app/providers";
+import { type AppPermissionState, type ProviderDescriptor, type ProviderInvocation, type ProviderKind, type SpeechCapabilities, type SpeechResult, type TranslationRequest, type TranslationResult, type TranslationCapabilities } from "@hosty-sdk/app/providers";
 export type ProviderServerOptions = {
     appId?: string;
     coreOrigin?: string;
@@ -23,6 +23,9 @@ export declare class ProviderClient {
         language?: string;
         signal?: AbortSignal;
     }): Promise<SpeechResult>;
+    translationCapabilities(provider: Pick<ProviderDescriptor, "appId" | "key">, signal?: AbortSignal): Promise<TranslationCapabilities>;
+    /** Translate text or Markdown through the explicitly selected provider; never retries or falls back. */
+    translate(provider: Pick<ProviderDescriptor, "appId" | "key">, input: TranslationRequest, signal?: AbortSignal): Promise<TranslationResult>;
     /** User-attributed requests preserve the assistant's existing handoff and dispatch policy. */
     assistant(provider: Pick<ProviderDescriptor, "appId" | "key"> & {
         installationId?: string | null;

package/dist/providers-server.js

@@ -54,6 +54,20 @@ export class ProviderClient {
         return read(await fetch(url, { method: "POST", redirect: "error", signal,
             headers: { authorization: `Bearer ${binding.token}`, "content-type": audio.type || "audio/wav" }, body: audio }));
     }
+    async translationCapabilities(provider, signal) {
+        const binding = await this.connect({ ...provider, kind: "translation" }, signal);
+        return read(await fetch(`${binding.url}/capabilities`, { redirect: "error", signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(10_000)]) : AbortSignal.timeout(10_000), headers: { authorization: `Bearer ${binding.token}` } }));
+    }
+    /** Translate text or Markdown through the explicitly selected provider; never retries or falls back. */
+    async translate(provider, input, signal) {
+        const deadline = signal ? AbortSignal.any([signal, AbortSignal.timeout(610_000)]) : AbortSignal.timeout(610_000);
+        const binding = await this.connect({ ...provider, kind: "translation" }, deadline);
+        const result = await read(await fetch(`${binding.url}/translations`, { method: "POST", redirect: "error", signal: deadline,
+            headers: { authorization: `Bearer ${binding.token}`, "content-type": "application/json" }, body: JSON.stringify(input) }));
+        if (typeof result.text !== "string" || result.targetLanguage !== input.targetLanguage || result.sourceLanguage !== (input.sourceLanguage ?? "auto"))
+            throw new ProviderError("provider_response_invalid", "Invalid translation response.", 502);
+        return result;
+    }
     /** User-attributed requests preserve the assistant's existing handoff and dispatch policy. */
     async assistant(provider, userToken) {
         const target = { ...provider, kind: "assistant" };

package/dist/providers.d.ts

@@ -1,5 +1,5 @@
 /** Provider categories supported by Core. Agent execution is intentionally not part of this contract. */
-export type ProviderKind = "speech-to-text" | "assistant";
+export type ProviderKind = "speech-to-text" | "assistant" | "translation";
 export type ProviderDescriptor = {
     appId: string;
     displayName: string;
@@ -48,6 +48,29 @@ export type SpeechCapabilities = {
     backend: string;
     ready: boolean;
 };
+export type TranslationRequest = {
+    text: string;
+    targetLanguage: string;
+    sourceLanguage?: string;
+    format?: "text" | "markdown";
+};
+export type TranslationResult = {
+    text: string;
+    targetLanguage: string;
+    sourceLanguage: string;
+};
+export type TranslationCapabilities = {
+    version: 1;
+    formats: string[];
+    maxCharacters: number;
+    maxSegmentCharacters: number;
+    maxBytes: number;
+    maxOutputBytes: number;
+    timeoutSeconds: number;
+    backend: string;
+    ready: boolean;
+    reason?: string;
+};
 /** Errors retain Core/provider codes so consumers can distinguish denial from unavailable service. */
 export declare class ProviderError extends Error {
     readonly code: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hosty-sdk/app",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Hosty app auth: session state machine, recovery bridge, Core revalidation, and the embedder responder.",
   "license": "AGPL-3.0-only",
   "type": "module",