@byline/ai 1.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Infonomic Company Limited.
+
+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

@@ -0,0 +1,4 @@
+# Infonomic AI
+
+Library components for AI
+

package/dist/@types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { z } from 'zod';
+export declare const PROVIDERS: readonly ["openai", "google", "anthropic"];
+export declare const INSTRUCTION_MODES: readonly ["new", "new_with_context", "patch"];
+export type InstructionMode = (typeof INSTRUCTION_MODES)[number];
+export type OutputPreference = {
+    type: 'structured';
+} | {
+    type: 'html';
+} | {
+    type: 'text';
+    length: 'short' | 'long';
+    maxLength?: number;
+};
+export type ExecuteInstructionInput = {
+    type: 'structured';
+    editorJson: string;
+} | {
+    type: 'text';
+    text: string;
+};
+export type ExecuteInstructionParams = {
+    prompt: string;
+    mode: InstructionMode;
+    input: ExecuteInstructionInput;
+    sdk: InstructionSdk;
+    provider: Provider;
+    model: string;
+    output?: OutputPreference;
+};
+export type ExecuteInstructionOptions = {
+    streaming?: boolean;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    telemetryContext?: Record<string, unknown>;
+};
+export type ExecuteInstruction = {
+    params: ExecuteInstructionParams;
+    options?: ExecuteInstructionOptions;
+};
+export declare const SDKS: readonly ["native", "vercel"];
+export type Sdk = (typeof SDKS)[number];
+export declare const normalizeSdk: (value: unknown) => Sdk;
+export interface InstructionState {
+    errors: {
+        prompt?: string[] | undefined;
+        editor?: string[] | undefined;
+    };
+    message?: string;
+    editor?: any;
+    html?: string;
+    text?: string;
+    format?: 'lexical' | 'html' | 'text';
+    prompt?: string;
+    lastRun?: number | null;
+    status: 'success' | 'failed' | 'idle';
+}
+export declare const instructionSchema: z.ZodObject<{
+    prompt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    mode: z.ZodEnum<{
+        new: "new";
+        new_with_context: "new_with_context";
+        patch: "patch";
+    }>;
+    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"structured">;
+        editorJson: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>], "type">;
+    provider: z.ZodEnum<{
+        openai: "openai";
+        google: "google";
+        anthropic: "anthropic";
+    }>;
+    model: z.ZodString;
+    sdk: z.ZodEnum<{
+        native: "native";
+        vercel: "vercel";
+    }>;
+    output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"structured">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"html">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        length: z.ZodEnum<{
+            short: "short";
+            long: "long";
+        }>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type Provider = z.infer<typeof instructionSchema>['provider'];
+export type InstructionSdk = z.infer<typeof instructionSchema>['sdk'];
+//# sourceMappingURL=@types.d.ts.map

package/dist/@types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"@types.d.ts","sourceRoot":"","sources":["../src/@types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,SAAS,4CAA6C,CAAA;AAEnE,eAAO,MAAM,iBAAiB,+CAAgD,CAAA;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElC,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,eAAe,CAAA;IACrB,KAAK,EAAE,uBAAuB,CAAA;IAC9B,GAAG,EAAE,cAAc,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,wBAAwB,CAAA;IAChC,OAAO,CAAC,EAAE,yBAAyB,CAAA;CACpC,CAAA;AAED,eAAO,MAAM,IAAI,+BAAgC,CAAA;AACjD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvC,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,GAI7C,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;QAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;KAC9B,CAAA;IACD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;CACtC;AA+BD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0B5B,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,UAAU,CAAC,CAAA;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAA"}

package/dist/@types.js

@@ -0,0 +1,68 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { z } from 'zod';
+export const PROVIDERS = ['openai', 'google', 'anthropic'];
+export const INSTRUCTION_MODES = ['new', 'new_with_context', 'patch'];
+export const SDKS = ['native', 'vercel'];
+export const normalizeSdk = (value) => {
+    if (typeof value !== 'string')
+        return 'native';
+    const normalized = value.trim().toLowerCase();
+    return normalized === 'vercel' ? 'vercel' : 'native';
+};
+const outputPreferenceSchema = z
+    .discriminatedUnion('type', [
+    z.object({ type: z.literal('structured') }),
+    z.object({ type: z.literal('html') }),
+    z.object({
+        type: z.literal('text'),
+        length: z.enum(['short', 'long']),
+        maxLength: z.number().optional(),
+    }),
+])
+    .optional();
+const inputSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('structured'),
+        editorJson: z.string({
+            error: (issue) => issue.input === undefined ? 'Editor state is required.' : 'Editor state must be a string.',
+        }),
+    }),
+    z.object({
+        type: z.literal('text'),
+        text: z.string({
+            error: (issue) => issue.input === undefined ? 'Input text is required.' : 'Input text must be a string.',
+        }),
+    }),
+]);
+export const instructionSchema = z.object({
+    prompt: z
+        .string({
+        error: (issue) => issue.input === undefined ? 'Prompt input is required.' : 'Prompt input must be a string.',
+    })
+        .min(3, {
+        error: 'Prompt input must be 3 or more characters long.',
+    })
+        .transform((s) => s.trim())
+        .refine((s) => s.length > 0, 'Prompt input cannot be empty.'),
+    mode: z.enum(INSTRUCTION_MODES, {
+        error: 'Mode must be one of new, new_with_context, or patch.',
+    }),
+    input: inputSchema,
+    provider: z.enum(PROVIDERS, {
+        error: 'Provider must be one of openai, google, or anthropic.',
+    }),
+    model: z.string({
+        error: (issue) => issue.input === undefined ? 'Model is required.' : 'Model must be a string.',
+    }),
+    sdk: z.enum(SDKS, {
+        error: 'SDK must be one of native or vercel.',
+    }),
+    output: outputPreferenceSchema,
+});
+//# sourceMappingURL=@types.js.map

package/dist/@types.js.map

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

package/dist/config/ai-config.d.ts

@@ -0,0 +1,76 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { z } from 'zod';
+import type { Provider } from '../@types';
+/**
+ * Curated model configuration per application version.
+ * These are the models suited to text generation for our
+ * text and lexical editors. Update this list when adding
+ * or retiring models between releases. Use `pnpm list:models`
+ * to discover available models from each provider.
+ */
+export declare const PROVIDER_MODELS: Record<Provider, string[]>;
+export declare const DEFAULT_MODELS: Record<Provider, string>;
+/**
+ * Server configuration schema and functions. Note that these
+ * values are ONLY available on the server and NOT available
+ * at build time and therefore not available to the browser.
+ * Values here are populated via the projects's .env file
+ * which is NOT committed to the project's Git repo and
+ * CAN include secrets.
+ */
+declare const aiServerSchema: z.ZodObject<{
+    ai: z.ZodObject<{
+        defaultProvider: z.ZodEnum<{
+            openai: "openai";
+            google: "google";
+            anthropic: "anthropic";
+        }>;
+        openai: z.ZodObject<{
+            apiKey: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        google: z.ZodObject<{
+            apiKey: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        anthropic: z.ZodObject<{
+            apiKey: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type AiServerConfig = z.infer<typeof aiServerSchema>;
+export declare const getAiServerConfig: () => AiServerConfig;
+/**
+ * Default path for the AI execute endpoint. Host adapters mount the
+ * actual handler at this path (or override via AiPublicConfigProvider).
+ */
+export declare const DEFAULT_AI_ENDPOINT = "/api/admin/ai";
+/**
+ * Public configuration. These values are passed to the browser via
+ * <AiPublicConfigProvider> and read by the AI plugins. Must NOT contain
+ * secrets — only transport configuration.
+ *
+ * - `endpoint`: URL the plugins POST `ExecuteInstruction` to
+ * - `enabled`: when explicitly `false`, wrappers may hide AI affordances
+ * - `fetch`: optional fetch override (auth interceptors, tests, etc.)
+ * - `headers`: optional headers merged into every request
+ */
+declare const aiPublicSchema: z.ZodObject<{
+    endpoint: z.ZodDefault<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AiPublicEnvConfig = z.infer<typeof aiPublicSchema>;
+export type AiPublicConfig = AiPublicEnvConfig & {
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+};
+export declare const getAiPublicConfig: () => AiPublicEnvConfig;
+export {};
+//# sourceMappingURL=ai-config.d.ts.map

package/dist/config/ai-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.d.ts","sourceRoot":"","sources":["../../src/config/ai-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAItD,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAInD,CAAA;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;iBAgBlB,CAAA;AAEF,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AA2BpD,eAAO,MAAM,iBAAiB,QAAO,cAKpC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAElD;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc;;;iBAGlB,CAAA;AAEF,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAEvD,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG;IAC/C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,CAAA;AASD,eAAO,MAAM,iBAAiB,QAAO,iBAKpC,CAAA"}

package/dist/config/ai-config.js

@@ -0,0 +1,108 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { z } from 'zod';
+/**
+ * Curated model configuration per application version.
+ * These are the models suited to text generation for our
+ * text and lexical editors. Update this list when adding
+ * or retiring models between releases. Use `pnpm list:models`
+ * to discover available models from each provider.
+ */
+export const PROVIDER_MODELS = {
+    openai: ['gpt-5.4', 'gpt-5.4-pro', 'gpt-5.4-mini', 'gpt-5.4-nano'],
+    google: ['gemini-2.5-pro', 'gemini-2.5-flash'],
+    anthropic: ['claude-opus-4-6', 'claude-sonnet-4-6', 'claude-haiku-4-5-20251001'],
+};
+export const DEFAULT_MODELS = {
+    openai: 'gpt-5.4',
+    google: 'gemini-2.5-flash',
+    anthropic: 'claude-haiku-4-5-20251001',
+};
+/**
+ * Server configuration schema and functions. Note that these
+ * values are ONLY available on the server and NOT available
+ * at build time and therefore not available to the browser.
+ * Values here are populated via the projects's .env file
+ * which is NOT committed to the project's Git repo and
+ * CAN include secrets.
+ */
+const aiServerSchema = z.object({
+    ai: z.object({
+        defaultProvider: z.enum(['openai', 'google', 'anthropic']),
+        openai: z.object({
+            apiKey: z.string(),
+            baseUrl: z.string().optional(),
+        }),
+        google: z.object({
+            apiKey: z.string(),
+            baseUrl: z.string().optional(),
+        }),
+        anthropic: z.object({
+            apiKey: z.string(),
+            baseUrl: z.string().optional(),
+        }),
+    }),
+});
+const initServerConfig = () => aiServerSchema.parse({
+    ai: {
+        defaultProvider: process.env.AI_DEFAULT_PROVIDER || 'openai',
+        openai: {
+            apiKey: process.env.OPENAI_API_KEY || '',
+            baseUrl: process.env.OPENAI_BASE_URL || undefined,
+        },
+        google: {
+            apiKey: process.env.GOOGLE_API_KEY || '',
+            baseUrl: process.env.GOOGLE_BASE_URL || undefined,
+        },
+        anthropic: {
+            apiKey: process.env.ANTHROPIC_API_KEY || '',
+            baseUrl: process.env.ANTHROPIC_BASE_URL || undefined,
+        },
+    },
+    log: {
+        level: process.env.LOG_LEVEL ?? 'info',
+        pretty: process.env.LOG_PRETTY,
+    },
+});
+let cachedAiServerConfig;
+export const getAiServerConfig = () => {
+    if (cachedAiServerConfig == null) {
+        cachedAiServerConfig = initServerConfig();
+    }
+    return cachedAiServerConfig;
+};
+/**
+ * Default path for the AI execute endpoint. Host adapters mount the
+ * actual handler at this path (or override via AiPublicConfigProvider).
+ */
+export const DEFAULT_AI_ENDPOINT = '/api/admin/ai';
+/**
+ * Public configuration. These values are passed to the browser via
+ * <AiPublicConfigProvider> and read by the AI plugins. Must NOT contain
+ * secrets — only transport configuration.
+ *
+ * - `endpoint`: URL the plugins POST `ExecuteInstruction` to
+ * - `enabled`: when explicitly `false`, wrappers may hide AI affordances
+ * - `fetch`: optional fetch override (auth interceptors, tests, etc.)
+ * - `headers`: optional headers merged into every request
+ */
+const aiPublicSchema = z.object({
+    endpoint: z.string().default(DEFAULT_AI_ENDPOINT),
+    enabled: z.boolean().optional(),
+});
+const initAiPublicConfig = () => aiPublicSchema.parse({
+    endpoint: process.env.BYLINE_AI_ENDPOINT ?? DEFAULT_AI_ENDPOINT,
+});
+let cachedAiPublicConfig;
+export const getAiPublicConfig = () => {
+    if (cachedAiPublicConfig == null) {
+        cachedAiPublicConfig = initAiPublicConfig();
+    }
+    return cachedAiPublicConfig;
+};
+//# sourceMappingURL=ai-config.js.map

package/dist/config/ai-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.js","sourceRoot":"","sources":["../../src/config/ai-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,MAAM,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC;IAClE,MAAM,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,SAAS,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,2BAA2B,CAAC;CACjF,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,2BAA2B;CACvC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;QACX,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;KACH,CAAC;CACH,CAAC,CAAA;AAIF,MAAM,gBAAgB,GAAG,GAAmB,EAAE,CAC5C,cAAc,CAAC,KAAK,CAAC;IACnB,EAAE,EAAE;QACF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,QAAQ;QAC5D,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;YACxC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS;SAClD;QACD,MAAM,EAAE;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;YACxC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS;SAClD;QACD,SAAS,EAAE;YACT,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;YAC3C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS;SACrD;KACF;IACD,GAAG,EAAE;QACH,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;KAC/B;CACF,CAAC,CAAA;AAEJ,IAAI,oBAAoC,CAAA;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAmB,EAAE;IACpD,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,oBAAoB,GAAG,gBAAgB,EAAE,CAAA;IAC3C,CAAC;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAA;AAElD;;;;;;;;;GASG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAA;AASF,MAAM,kBAAkB,GAAG,GAAsB,EAAE,CACjD,cAAc,CAAC,KAAK,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,mBAAmB;CAChE,CAAC,CAAA;AAEJ,IAAI,oBAAuC,CAAA;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAsB,EAAE;IACvD,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,oBAAoB,GAAG,kBAAkB,EAAE,CAAA;IAC7C,CAAC;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC,CAAA"}

package/dist/config/ai-config.test.node.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};
+//# sourceMappingURL=ai-config.test.node.d.ts.map

package/dist/config/ai-config.test.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.test.node.d.ts","sourceRoot":"","sources":["../../src/config/ai-config.test.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/config/ai-config.test.node.js

@@ -0,0 +1,31 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { describe, test } from 'vitest';
+import { getAiServerConfig } from './ai-config';
+describe('Config tests', () => {
+    // NOTE: Disable caching in getAiServerConfig for 'real'
+    // benchmarks
+    test.skip('should get config quickly', () => {
+        // Record the start time
+        const startTime = performance.now();
+        const iterations = 10000;
+        let _config;
+        for (let i = 0; i < iterations; i++) {
+            // const start = performance.now();
+            _config = getAiServerConfig();
+            // totalTime += performance.now() - start;
+        }
+        // Record the end time
+        const endTime = performance.now();
+        // Calculate the time taken
+        const timeTaken = endTime - startTime;
+        console.log(`Execution time: ${timeTaken}ms`);
+        // console.log(config)
+    });
+});
+//# sourceMappingURL=ai-config.test.node.js.map

package/dist/config/ai-config.test.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.test.node.js","sourceRoot":"","sources":["../../src/config/ai-config.test.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,wDAAwD;IACxD,aAAa;IACb,IAAI,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;QAC1C,wBAAwB;QACxB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QACnC,MAAM,UAAU,GAAG,KAAK,CAAA;QACxB,IAAI,OAAY,CAAA;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,mCAAmC;YACnC,OAAO,GAAG,iBAAiB,EAAE,CAAA;YAC7B,0CAA0C;QAC5C,CAAC;QAED,sBAAsB;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAEjC,2BAA2B;QAC3B,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,IAAI,CAAC,CAAA;QAC7C,sBAAsB;IACxB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/config/ai-provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { type ReactNode } from 'react';
+import { type AiPublicConfig } from './ai-config';
+export declare const AiPublicConfigContext: import("react").Context<AiPublicConfig | undefined>;
+export declare const AiPublicConfigProvider: ({ config, children, }: {
+    config?: Partial<AiPublicConfig>;
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const useAiPublicConfig: () => AiPublicConfig;
+export declare const useOptionalAiPublicConfig: () => AiPublicConfig | undefined;
+//# sourceMappingURL=ai-provider.d.ts.map

package/dist/config/ai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/config/ai-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAE1E,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,aAAa,CAAA;AAEtE,eAAO,MAAM,qBAAqB,qDAAuD,CAAA;AAEzF,eAAO,MAAM,sBAAsB,GAAI,uBAGpC;IACD,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAChC,QAAQ,EAAE,SAAS,CAAA;CACpB,4CAaA,CAAA;AAED,eAAO,MAAM,iBAAiB,QAAO,cAMpC,CAAA;AAED,eAAO,MAAM,yBAAyB,QAAO,cAAc,GAAG,SAE7D,CAAA"}

package/dist/config/ai-provider.js

@@ -0,0 +1,32 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { createContext, useContext, useMemo } from 'react';
+import { DEFAULT_AI_ENDPOINT } from './ai-config';
+export const AiPublicConfigContext = createContext(undefined);
+export const AiPublicConfigProvider = ({ config, children, }) => {
+    const resolved = useMemo(() => ({
+        endpoint: config?.endpoint ?? DEFAULT_AI_ENDPOINT,
+        enabled: config?.enabled,
+        fetch: config?.fetch,
+        headers: config?.headers,
+    }), [config?.endpoint, config?.enabled, config?.fetch, config?.headers]);
+    return (_jsx(AiPublicConfigContext.Provider, { value: resolved, children: children }));
+};
+export const useAiPublicConfig = () => {
+    const context = useContext(AiPublicConfigContext);
+    if (context != null) {
+        return context;
+    }
+    throw new Error('useAiPublicConfig must be used within an AiPublicConfigProvider');
+};
+export const useOptionalAiPublicConfig = () => {
+    return useContext(AiPublicConfigContext);
+};
+//# sourceMappingURL=ai-provider.js.map

package/dist/config/ai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../src/config/ai-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1E,OAAO,EAAuB,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAA6B,SAAS,CAAC,CAAA;AAEzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACrC,MAAM,EACN,QAAQ,GAIT,EAAE,EAAE;IACH,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,mBAAmB;QACjD,OAAO,EAAE,MAAM,EAAE,OAAO;QACxB,KAAK,EAAE,MAAM,EAAE,KAAK;QACpB,OAAO,EAAE,MAAM,EAAE,OAAO;KACzB,CAAC,EACF,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CACpE,CAAA;IACD,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAAkC,CAC7F,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAmB,EAAE;IACpD,MAAM,OAAO,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAA;IACjD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;AACpF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAA+B,EAAE;IACxE,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAA;AAC1C,CAAC,CAAA"}

package/dist/execute.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { ExecuteInstructionOptions, ExecuteInstructionParams, InstructionState } from './@types';
+export declare function executeInstruction(params: ExecuteInstructionParams, options?: ExecuteInstructionOptions): Promise<InstructionState>;
+export type ExecuteInstructionStreamingResult = {
+    text: AsyncIterable<string>;
+    final: Promise<InstructionState>;
+};
+export declare function executeInstructionStreaming(params: ExecuteInstructionParams, options?: ExecuteInstructionOptions): ExecuteInstructionStreamingResult;
+//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAGxB,gBAAgB,EAGjB,MAAM,UAAU,CAAA;AAsIjB,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CA8L3B;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3B,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACjC,CAAA;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,iCAAiC,CAsMnC"}