@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/ai/headless/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The AI error info wire shape.
+ *
+ * @stability experimental
+ */
+export interface AiErrorInfo {
+    /** The AI code (`AI_KEY_REQUIRED`, …), or `null` when the failure had none. */
+    code: string | null;
+    /** The server's (or the browser's) own message — shown under the mapped copy. */
+    message: string;
+    /** HTTP status, when the failure was an HTTP response. */
+    status?: number;
+    /** Back-off hint on `AI_RATE_LIMITED`, in milliseconds. */
+    retryAfterMs?: number;
+    /**
+     * On an `AI_RATE_LIMITED` refused by one of this deployment's own limits
+     * (#450): which one (`perUser.requestsPerMinute`, …), its value, and its
+     * window. Absent when the PROVIDER throttled the call instead.
+     */
+    limit?: string;
+    /** The max. */
+    max?: number;
+    /** The window. */
+    window?: 'minute' | 'day';
+}
+/**
+ * Any thrown value from an AI call → {@link AiErrorInfo}.
+ *
+ * @stability experimental
+ */
+export declare function toAiErrorInfo(err: unknown, fallback?: string): AiErrorInfo;
+//# sourceMappingURL=errors.d.ts.map

package/dist/ai/headless/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ai/headless/errors.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC3B;AA2BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAyB,GAAG,WAAW,CAmB1F"}

package/dist/ai/headless/errors.js

@@ -0,0 +1,72 @@
+/**
+ * Normalising every way an AI call can fail into one shape — issue #434,
+ * epic #419.
+ *
+ * An AI failure reaches the browser by one of three roads, and they carry the
+ * AI code in three different places:
+ *
+ * 1. A gated or failed JSON call (`POST /ai/responses`, `POST /ai/runs`, a
+ *    pre-stream gate failure on `POST /ai/responses/stream`) throws an
+ *    `ApiError`. Its top-level `code` is the GENERIC HTTP code the global
+ *    exception filter assigns (`FORBIDDEN`, `BAD_REQUEST`, …); the AI code is
+ *    in `details.reason`, with `details.retryAfterMs` beside it for a rate
+ *    limit (docs/specs/ai-platform.md §2.23). Switching on `code` alone never
+ *    sees `AI_KEY_REQUIRED`.
+ * 2. A failure AFTER a stream started arrives as an `error` SSE frame whose
+ *    payload carries `code` directly.
+ * 3. A background run that settled `failed` carries `errorCode` on the run.
+ *
+ * Everything that renders an AI failure (`components/ai/AiErrorAlert.tsx`)
+ * takes the {@link AiErrorInfo} this module produces, so the three roads end
+ * at one mapping.
+ */
+import { isPlatformApiError } from '../../core/index.js';
+function readDetails(details) {
+    if (!details || typeof details !== 'object')
+        return {};
+    const record = details;
+    const out = {};
+    if (typeof record.reason === 'string')
+        out.reason = record.reason;
+    if (typeof record.retryAfterMs === 'number')
+        out.retryAfterMs = record.retryAfterMs;
+    if (typeof record.limit === 'string')
+        out.limit = record.limit;
+    if (typeof record.max === 'number')
+        out.max = record.max;
+    if (record.window === 'minute' || record.window === 'day')
+        out.window = record.window;
+    return out;
+}
+/**
+ * The storage API's own "no usable object storage" reasons
+ * (`storage-not-configured.error.ts`). An AI media call that uploads its
+ * input first (#445) meets them before any AI route does; they mean exactly
+ * what `AI_STORAGE_UNAVAILABLE` means, so they render as it.
+ */
+const STORAGE_UNAVAILABLE_REASONS = new Set(['storage_not_configured', 'storage_bucket_unknown']);
+/**
+ * Any thrown value from an AI call → {@link AiErrorInfo}.
+ *
+ * @stability experimental
+ */
+export function toAiErrorInfo(err, fallback = 'Something went wrong') {
+    if (isPlatformApiError(err)) {
+        const { reason: rawReason, ...rest } = readDetails(err.details);
+        const reason = rawReason && STORAGE_UNAVAILABLE_REASONS.has(rawReason)
+            ? 'AI_STORAGE_UNAVAILABLE'
+            : rawReason;
+        const code = reason ?? (err.code?.startsWith('AI_') ? err.code : null);
+        return {
+            code,
+            message: err.message || fallback,
+            status: err.status,
+            ...rest,
+        };
+    }
+    if (err instanceof Error) {
+        return { code: null, message: err.message || fallback };
+    }
+    return { code: null, message: fallback };
+}
+//# sourceMappingURL=errors.js.map

package/dist/ai/headless/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ai/headless/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAiCzD,SAAS,WAAW,CAAC,OAAgB;IACnC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,OAAkC,CAAC;IAClD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClE,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;QAAE,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACpF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/D,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACtF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC,CAAC;AAElG;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,QAAQ,GAAG,sBAAsB;IAC3E,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,MAAM,GACV,SAAS,IAAI,2BAA2B,CAAC,GAAG,CAAC,SAAS,CAAC;YACrD,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,QAAQ;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,GAAG,IAAI;SACR,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC"}

package/dist/ai/headless/index.d.ts

@@ -0,0 +1,34 @@
+export { useOrgAiKeys } from './use-org-ai-keys.js';
+export type { UseOrgAiKeysOptions, UseOrgAiKeysResult } from './use-org-ai-keys.js';
+export { useOrgAiPolicy } from './use-org-ai-policy.js';
+export type { UseOrgAiPolicyOptions, UseOrgAiPolicyResult } from './use-org-ai-policy.js';
+export type { OrgAiKeyView } from '@marinoscar/platform-contract/ai';
+export { AiWebAdaptersProvider, useAiWebAdapters } from './adapters.js';
+export type { AiSpinnerProps, AiWebAdapters } from './adapters.js';
+export * from './types.js';
+export * from './client.js';
+export * from './chat-attachments.js';
+export { toAiErrorInfo } from './errors.js';
+export type { AiErrorInfo } from './errors.js';
+export { useAiApi } from './use-ai-api.js';
+export type { AiHookOptions } from './use-ai-api.js';
+export { AI_CONFIG_DISABLED, AiConfigContext, useAiConfig, useAiConfigQuery, useAiFeatures, } from './use-ai-config.js';
+export type { AiFeatureFlags, UseAiConfigReturn } from './use-ai-config.js';
+export { AiConfigProvider } from './ai-config-provider.js';
+export { useAiStorageObjects } from './use-ai-storage.js';
+export { useAiUserSettings } from './use-ai-user-settings.js';
+export type { AiUserSettings, AiUserSettingsUpdate } from './use-ai-user-settings.js';
+export * from './use-ai-chat.js';
+export * from './use-ai-run.js';
+export * from './use-ai-realtime-session.js';
+export * from './use-microphone-permission.js';
+export * from './schema-presets.js';
+export * from './use-ai-models.js';
+export { useAiCapabilities } from './use-ai-capabilities.js';
+export type { UseAiCapabilitiesReturn } from './use-ai-capabilities.js';
+export { getRegisteredAiCapabilityLabel, registerAiCapabilityLabel, registerAiCapabilityLabels, } from './capability-labels.js';
+export * from './use-ai-usage.js';
+export * from './use-ai-admin-config.js';
+export * from './use-user-ai-keys.js';
+export * from './use-usable-ai-models.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/headless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/headless/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnE,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtF,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/ai/headless/index.js

@@ -0,0 +1,34 @@
+// `@marinoscar/platform-web/ai/headless`: the AI slice's headless web layer
+// (issues #739, PP-8.6, and #890): the organization AI keys hook and policy,
+// the AI calls over the host transport, the hooks behind the admin, key and
+// playground pages, and the slots (app spinner, app table). Documented in
+// ../README.md.
+// ---- the organization's own keys (#739) ----
+export { useOrgAiKeys } from './use-org-ai-keys.js';
+export { useOrgAiPolicy } from './use-org-ai-policy.js';
+// ---- the slots the app fills (#890) ----
+export { AiWebAdaptersProvider, useAiWebAdapters } from './adapters.js';
+// ---- the wire: types, constants and the calls over `PlatformApiClient` ----
+export * from './types.js';
+export * from './client.js';
+export * from './chat-attachments.js';
+export { toAiErrorInfo } from './errors.js';
+// ---- hooks ----
+export { useAiApi } from './use-ai-api.js';
+export { AI_CONFIG_DISABLED, AiConfigContext, useAiConfig, useAiConfigQuery, useAiFeatures, } from './use-ai-config.js';
+export { AiConfigProvider } from './ai-config-provider.js';
+export { useAiStorageObjects } from './use-ai-storage.js';
+export { useAiUserSettings } from './use-ai-user-settings.js';
+export * from './use-ai-chat.js';
+export * from './use-ai-run.js';
+export * from './use-ai-realtime-session.js';
+export * from './use-microphone-permission.js';
+export * from './schema-presets.js';
+export * from './use-ai-models.js';
+export { useAiCapabilities } from './use-ai-capabilities.js';
+export { getRegisteredAiCapabilityLabel, registerAiCapabilityLabel, registerAiCapabilityLabels, } from './capability-labels.js';
+export * from './use-ai-usage.js';
+export * from './use-ai-admin-config.js';
+export * from './use-user-ai-keys.js';
+export * from './use-usable-ai-models.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/headless/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,gBAAgB;AAEhB,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,2CAA2C;AAC3C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGxE,8EAA8E;AAC9E,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/ai/headless/schema-presets.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Preset JSON Schemas for the playground's structured-output demo — issue
+ * #434, epic #419.
+ *
+ * Written for STRICT structured outputs (the request sends `strict: true`):
+ * every property is listed in `required`, optional values are nullable
+ * instead of omitted, and `additionalProperties` is `false` — the subset of
+ * JSON Schema providers accept in strict mode.
+ 
+ *
+ * @stability experimental
+ */
+export interface AiSchemaPreset {
+    /** The id. */
+    id: string;
+    /** The label. */
+    label: string;
+    /** `structuredOutput.name` — a provider-safe identifier. */
+    name: string;
+    /** A prompt that exercises the schema, offered as a starting point. */
+    examplePrompt: string;
+    /** The json schema. */
+    jsonSchema: Record<string, unknown>;
+}
+/**
+ * The AI schema presets.
+ *
+ * @stability experimental
+ */
+export declare const AI_SCHEMA_PRESETS: [AiSchemaPreset, ...AiSchemaPreset[]];
+/**
+ * The preset id the schema editor uses for a hand-written schema.
+ *
+ * @stability experimental
+ */
+export declare const CUSTOM_SCHEMA_ID = "custom";
+/**
+ * The custom schema name.
+ *
+ * @stability experimental
+ */
+export declare const CUSTOM_SCHEMA_NAME = "custom_output";
+/**
+ * Format schema.
+ *
+ * @stability experimental
+ */
+export declare function formatSchema(schema: unknown): string;
+/**
+ * Validate the schema editor's text: it must be JSON and a JSON object.
+ * Returns the parsed schema, or an error message.
+ 
+ *
+ * @stability experimental
+ */
+export declare function parseJsonSchemaText(text: string): {
+    /** The ok. */
+    ok: true;
+    /** The schema. */
+    schema: Record<string, unknown>;
+} | {
+    /** The ok. */
+    ok: false;
+    /** The error. */
+    error: string;
+};
+//# sourceMappingURL=schema-presets.d.ts.map

package/dist/ai/headless/schema-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-presets.d.ts","sourceRoot":"","sources":["../../../src/ai/headless/schema-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,cAAc,EAAE,GAAG,cAAc,EAAE,CAoCnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAC5C;IACE,cAAc;IACd,EAAE,EAAE,IAAI,CAAC;IACT,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,GACD;IACE,cAAc;IACd,EAAE,EAAE,KAAK,CAAC;IACV,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAeJ"}

package/dist/ai/headless/schema-presets.js

@@ -0,0 +1,86 @@
+/**
+ * The AI schema presets.
+ *
+ * @stability experimental
+ */
+export const AI_SCHEMA_PRESETS = [
+    {
+        id: 'extract_contact',
+        label: 'Extract contact',
+        name: 'contact',
+        examplePrompt: 'Extract the contact: "Hi, I\'m Dana Ruiz from Acme Corp — reach me at dana@acme.test or +1 555 0100."',
+        jsonSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Full name' },
+                email: { type: ['string', 'null'] },
+                phone: { type: ['string', 'null'] },
+                company: { type: ['string', 'null'] },
+            },
+            required: ['name', 'email', 'phone', 'company'],
+            additionalProperties: false,
+        },
+    },
+    {
+        id: 'classify_sentiment',
+        label: 'Classify sentiment',
+        name: 'sentiment',
+        examplePrompt: 'Classify the sentiment: "The update fixed my problem, but it took forever to install."',
+        jsonSchema: {
+            type: 'object',
+            properties: {
+                sentiment: { type: 'string', enum: ['positive', 'neutral', 'negative', 'mixed'] },
+                confidence: { type: 'number', minimum: 0, maximum: 1 },
+                rationale: { type: 'string' },
+            },
+            required: ['sentiment', 'confidence', 'rationale'],
+            additionalProperties: false,
+        },
+    },
+];
+/**
+ * The preset id the schema editor uses for a hand-written schema.
+ *
+ * @stability experimental
+ */
+export const CUSTOM_SCHEMA_ID = 'custom';
+/**
+ * The custom schema name.
+ *
+ * @stability experimental
+ */
+export const CUSTOM_SCHEMA_NAME = 'custom_output';
+/**
+ * Format schema.
+ *
+ * @stability experimental
+ */
+export function formatSchema(schema) {
+    return JSON.stringify(schema, null, 2);
+}
+/**
+ * Validate the schema editor's text: it must be JSON and a JSON object.
+ * Returns the parsed schema, or an error message.
+ 
+ *
+ * @stability experimental
+ */
+export function parseJsonSchemaText(text) {
+    if (text.trim() === '')
+        return { ok: false, error: 'Enter a JSON Schema' };
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Invalid JSON: ${err instanceof Error ? err.message : 'parse error'}`,
+        };
+    }
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return { ok: false, error: 'The schema must be a JSON object' };
+    }
+    return { ok: true, schema: value };
+}
+//# sourceMappingURL=schema-presets.js.map

package/dist/ai/headless/schema-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-presets.js","sourceRoot":"","sources":["../../../src/ai/headless/schema-presets.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA0C;IACtE;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,SAAS;QACf,aAAa,EACX,uGAAuG;QACzG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;gBAClD,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;aACtC;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;YAC/C,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,WAAW;QACjB,aAAa,EACX,wFAAwF;QAC1F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;gBACjF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;gBACtD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC9B;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC;YAClD,oBAAoB,EAAE,KAAK;SAC5B;KACF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAa9C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC3E,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE;SAC7E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAgC,EAAE,CAAC;AAChE,CAAC"}