@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/llm/webllm_chat_completions/validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.cjs","names":[],"sources":["../../../../src/batteries/llm/webllm_chat_completions/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for WebLLM Chat Completions adapter options.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/validation\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS } from './exceptions'\nimport type { WebLLMChatCompletionsAdapterOptions } from './types'\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    validator\n      .string()\n      .valid(\n        'gpt2',\n        'r50k_base',\n        'p50k_base',\n        'p50k_edit',\n        'cl100k_base',\n        'o200k_base',\n        'gemini',\n        'llama2',\n        'claude'\n      ),\n    validator.any().valid(null)\n  )\n  .default(null)\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderTimelineMessage: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderChatCompletionsToolCallResult: helperSchema.optional(),\n    buildChatCompletionsHistory: helperSchema.optional(),\n    createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional(),\n  })\n  .unknown(false)\n\nconst jsonSchemaSchema = validator.object().unknown(true)\n\nconst responseFormatSchema = validator.alternatives(\n  validator.object({ type: validator.string().valid('text').required() }).unknown(false),\n  validator.object({ type: validator.string().valid('json_object').required() }).unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('json_schema').required(),\n      json_schema: validator\n        .object({\n          name: validator.string().required(),\n          schema: jsonSchemaSchema.required(),\n          strict: validator.boolean().optional(),\n          description: validator.string().optional(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceItemSchema = validator.alternatives(\n  validator\n    .object({\n      type: validator.string().valid('function').required(),\n      function: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('custom').required(),\n      custom: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceSchema = validator.alternatives(\n  validator.string().valid('none', 'auto', 'required'),\n  toolChoiceItemSchema,\n  validator\n    .object({\n      type: validator.string().valid('allowed_tools').required(),\n      allowed_tools: validator\n        .object({\n          mode: validator.string().valid('auto', 'required').required(),\n          tools: validator.array().items(toolChoiceItemSchema).required(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nexport const webLLMChatCompletionsOptionsSchema = validator\n  .object<WebLLMChatCompletionsAdapterOptions>({\n    engine: validator.object().unknown(true).optional(),\n    createEngine: validator.function().optional(),\n    onInitProgress: validator.function().optional(),\n    isWebGPUAvailable: validator.function().optional(),\n    engineConfig: validator.object().unknown(true).optional(),\n    chatOptions: validator\n      .alternatives(\n        validator.object().unknown(true),\n        validator.array().items(validator.object().unknown(true))\n      )\n      .optional(),\n    stream: validator.boolean().default(true),\n    bucketOrder: bucketOrderSchema,\n    contextWindow: validator.number().integer().min(1).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    tokenEncoding: tokenEncodingSchema,\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    strictToolChoice: validator.boolean().default(false),\n    // Opt-in: executor self-acks tool-call-free responses only when true.\n    // Default false hands turn completion to the implementor (see\n    // OpenAIChatCompletionsAdapterOptions.autoAck — inherited here).\n    autoAck: validator.boolean().default(false),\n    unsupportedMediaPolicy: validator\n      .alternatives(\n        validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n        validator\n          .object({\n            mode: validator.string().valid('fallback-stash').required(),\n            stashKeys: validator.array().items(validator.string().min(1)).required(),\n          })\n          .unknown(false)\n      )\n      .default('throw'),\n\n    model: validator.string().required(),\n    frequency_penalty: validator.number().min(-2).max(2).optional(),\n    logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),\n    logprobs: validator.boolean().optional(),\n    max_tokens: validator.number().integer().min(1).optional(),\n    n: validator.number().integer().min(1).optional(),\n    presence_penalty: validator.number().min(-2).max(2).optional(),\n    response_format: responseFormatSchema.optional(),\n    seed: validator.number().integer().optional(),\n    stop: validator\n      .alternatives(validator.string(), validator.array().items(validator.string()))\n      .optional(),\n    stream_options: validator.object().unknown(true).optional(),\n    temperature: validator.number().min(0).max(2).optional(),\n    tool_choice: toolChoiceSchema.optional(),\n    top_logprobs: validator.number().integer().min(0).optional(),\n    top_p: validator.number().min(0).max(1).optional(),\n    user: validator.string().optional(),\n    repetition_penalty: validator.number().optional(),\n    ignore_eos: validator.boolean().optional(),\n    extra_body: validator.object().unknown(true).optional(),\n    max_completion_tokens: validator.number().integer().min(1).optional(),\n  })\n  .unknown(false)\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\nexport const validateOptions = (input: unknown): WebLLMChatCompletionsAdapterOptions => {\n  const { value, error } = webLLMChatCompletionsOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], {\n      cause: error,\n    })\n  }\n  return value as WebLLMChatCompletionsAdapterOptions\n}\n\nvoid isValidationError\n"],"mappings":"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"}

package/batteries/llm/webllm_chat_completions/validation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime validation schema and wrapper for WebLLM Chat Completions adapter options.
+ *
+ * @module @nhtio/adk/batteries/llm/webllm_chat_completions/validation
+ */
+import type { WebLLMChatCompletionsAdapterOptions } from "./types";
+export declare const webLLMChatCompletionsOptionsSchema: import("@nhtio/validation").ObjectSchema<WebLLMChatCompletionsAdapterOptions>;
+export declare const validateOptions: (input: unknown) => WebLLMChatCompletionsAdapterOptions;

package/batteries/llm/webllm_chat_completions/validation.mjs

@@ -0,0 +1,112 @@
+import "../../../guards.mjs";
+import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
+import { validator } from "@nhtio/validation";
+//#region src/batteries/llm/webllm_chat_completions/validation.ts
+var bucketLabelSchema = validator.string().valid("standingInstructions", "memories", "retrievables", "timeline");
+var bucketOrderSchema = validator.array().items(bucketLabelSchema).unique().default([
+	"standingInstructions",
+	"memories",
+	"retrievables",
+	"timeline"
+]);
+var tokenEncodingSchema = validator.alternatives(validator.string().valid("gpt2", "r50k_base", "p50k_base", "p50k_edit", "cl100k_base", "o200k_base", "gemini", "llama2", "claude"), validator.any().valid(null)).default(null);
+var helperSchema = validator.function();
+var helpersSchema = validator.object({
+	descriptionToChatCompletionsJsonSchema: helperSchema.optional(),
+	renderUntrustedContent: helperSchema.optional(),
+	renderTrustedContent: helperSchema.optional(),
+	renderStandingInstructions: helperSchema.optional(),
+	renderMemories: helperSchema.optional(),
+	renderRetrievables: helperSchema.optional(),
+	renderRetrievableSafetyDirective: helperSchema.optional(),
+	renderFirstPartyRetrievables: helperSchema.optional(),
+	renderThirdPartyPublicRetrievables: helperSchema.optional(),
+	renderThirdPartyPrivateRetrievables: helperSchema.optional(),
+	renderTimelineMessage: helperSchema.optional(),
+	renderThought: helperSchema.optional(),
+	filterThoughts: helperSchema.optional(),
+	toolsToChatCompletionsTools: helperSchema.optional(),
+	renderChatCompletionsSystemPrompt: helperSchema.optional(),
+	renderChatCompletionsToolCallResult: helperSchema.optional(),
+	buildChatCompletionsHistory: helperSchema.optional(),
+	createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional()
+}).unknown(false);
+var jsonSchemaSchema = validator.object().unknown(true);
+var responseFormatSchema = validator.alternatives(validator.object({ type: validator.string().valid("text").required() }).unknown(false), validator.object({ type: validator.string().valid("json_object").required() }).unknown(false), validator.object({
+	type: validator.string().valid("json_schema").required(),
+	json_schema: validator.object({
+		name: validator.string().required(),
+		schema: jsonSchemaSchema.required(),
+		strict: validator.boolean().optional(),
+		description: validator.string().optional()
+	}).unknown(false).required()
+}).unknown(false));
+var toolChoiceItemSchema = validator.alternatives(validator.object({
+	type: validator.string().valid("function").required(),
+	function: validator.object({ name: validator.string().required() }).unknown(false).required()
+}).unknown(false), validator.object({
+	type: validator.string().valid("custom").required(),
+	custom: validator.object({ name: validator.string().required() }).unknown(false).required()
+}).unknown(false));
+var toolChoiceSchema = validator.alternatives(validator.string().valid("none", "auto", "required"), toolChoiceItemSchema, validator.object({
+	type: validator.string().valid("allowed_tools").required(),
+	allowed_tools: validator.object({
+		mode: validator.string().valid("auto", "required").required(),
+		tools: validator.array().items(toolChoiceItemSchema).required()
+	}).unknown(false).required()
+}).unknown(false));
+var webLLMChatCompletionsOptionsSchema = validator.object({
+	engine: validator.object().unknown(true).optional(),
+	createEngine: validator.function().optional(),
+	onInitProgress: validator.function().optional(),
+	isWebGPUAvailable: validator.function().optional(),
+	engineConfig: validator.object().unknown(true).optional(),
+	chatOptions: validator.alternatives(validator.object().unknown(true), validator.array().items(validator.object().unknown(true))).optional(),
+	stream: validator.boolean().default(true),
+	bucketOrder: bucketOrderSchema,
+	contextWindow: validator.number().integer().min(1).optional(),
+	selfIdentity: validator.string().min(1).default("assistant"),
+	thoughtSurfacing: validator.string().valid("all-self", "latest-self", "all").default("all-self"),
+	tokenEncoding: tokenEncodingSchema,
+	replayCompatibility: validator.array().items(validator.string().min(1)).default([]),
+	helpers: helpersSchema.optional(),
+	strictToolChoice: validator.boolean().default(false),
+	autoAck: validator.boolean().default(false),
+	unsupportedMediaPolicy: validator.alternatives(validator.string().valid("throw", "fallback-stash", "synthetic-description"), validator.object({
+		mode: validator.string().valid("fallback-stash").required(),
+		stashKeys: validator.array().items(validator.string().min(1)).required()
+	}).unknown(false)).default("throw"),
+	model: validator.string().required(),
+	frequency_penalty: validator.number().min(-2).max(2).optional(),
+	logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),
+	logprobs: validator.boolean().optional(),
+	max_tokens: validator.number().integer().min(1).optional(),
+	n: validator.number().integer().min(1).optional(),
+	presence_penalty: validator.number().min(-2).max(2).optional(),
+	response_format: responseFormatSchema.optional(),
+	seed: validator.number().integer().optional(),
+	stop: validator.alternatives(validator.string(), validator.array().items(validator.string())).optional(),
+	stream_options: validator.object().unknown(true).optional(),
+	temperature: validator.number().min(0).max(2).optional(),
+	tool_choice: toolChoiceSchema.optional(),
+	top_logprobs: validator.number().integer().min(0).optional(),
+	top_p: validator.number().min(0).max(1).optional(),
+	user: validator.string().optional(),
+	repetition_penalty: validator.number().optional(),
+	ignore_eos: validator.boolean().optional(),
+	extra_body: validator.object().unknown(true).optional(),
+	max_completion_tokens: validator.number().integer().min(1).optional()
+}).unknown(false);
+var formatValidationDetails = (err) => err.details.map((d) => d.message).join(" and ");
+var validateOptions = (input) => {
+	const { value, error } = webLLMChatCompletionsOptionsSchema.validate(input, {
+		abortEarly: false,
+		convert: false
+	});
+	if (error) throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], { cause: error });
+	return value;
+};
+//#endregion
+export { validateOptions, webLLMChatCompletionsOptionsSchema };
+
+//# sourceMappingURL=validation.mjs.map

package/batteries/llm/webllm_chat_completions/validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../../../src/batteries/llm/webllm_chat_completions/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for WebLLM Chat Completions adapter options.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/validation\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS } from './exceptions'\nimport type { WebLLMChatCompletionsAdapterOptions } from './types'\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    validator\n      .string()\n      .valid(\n        'gpt2',\n        'r50k_base',\n        'p50k_base',\n        'p50k_edit',\n        'cl100k_base',\n        'o200k_base',\n        'gemini',\n        'llama2',\n        'claude'\n      ),\n    validator.any().valid(null)\n  )\n  .default(null)\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderTimelineMessage: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderChatCompletionsToolCallResult: helperSchema.optional(),\n    buildChatCompletionsHistory: helperSchema.optional(),\n    createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional(),\n  })\n  .unknown(false)\n\nconst jsonSchemaSchema = validator.object().unknown(true)\n\nconst responseFormatSchema = validator.alternatives(\n  validator.object({ type: validator.string().valid('text').required() }).unknown(false),\n  validator.object({ type: validator.string().valid('json_object').required() }).unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('json_schema').required(),\n      json_schema: validator\n        .object({\n          name: validator.string().required(),\n          schema: jsonSchemaSchema.required(),\n          strict: validator.boolean().optional(),\n          description: validator.string().optional(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceItemSchema = validator.alternatives(\n  validator\n    .object({\n      type: validator.string().valid('function').required(),\n      function: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('custom').required(),\n      custom: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceSchema = validator.alternatives(\n  validator.string().valid('none', 'auto', 'required'),\n  toolChoiceItemSchema,\n  validator\n    .object({\n      type: validator.string().valid('allowed_tools').required(),\n      allowed_tools: validator\n        .object({\n          mode: validator.string().valid('auto', 'required').required(),\n          tools: validator.array().items(toolChoiceItemSchema).required(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nexport const webLLMChatCompletionsOptionsSchema = validator\n  .object<WebLLMChatCompletionsAdapterOptions>({\n    engine: validator.object().unknown(true).optional(),\n    createEngine: validator.function().optional(),\n    onInitProgress: validator.function().optional(),\n    isWebGPUAvailable: validator.function().optional(),\n    engineConfig: validator.object().unknown(true).optional(),\n    chatOptions: validator\n      .alternatives(\n        validator.object().unknown(true),\n        validator.array().items(validator.object().unknown(true))\n      )\n      .optional(),\n    stream: validator.boolean().default(true),\n    bucketOrder: bucketOrderSchema,\n    contextWindow: validator.number().integer().min(1).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    tokenEncoding: tokenEncodingSchema,\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    strictToolChoice: validator.boolean().default(false),\n    // Opt-in: executor self-acks tool-call-free responses only when true.\n    // Default false hands turn completion to the implementor (see\n    // OpenAIChatCompletionsAdapterOptions.autoAck — inherited here).\n    autoAck: validator.boolean().default(false),\n    unsupportedMediaPolicy: validator\n      .alternatives(\n        validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n        validator\n          .object({\n            mode: validator.string().valid('fallback-stash').required(),\n            stashKeys: validator.array().items(validator.string().min(1)).required(),\n          })\n          .unknown(false)\n      )\n      .default('throw'),\n\n    model: validator.string().required(),\n    frequency_penalty: validator.number().min(-2).max(2).optional(),\n    logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),\n    logprobs: validator.boolean().optional(),\n    max_tokens: validator.number().integer().min(1).optional(),\n    n: validator.number().integer().min(1).optional(),\n    presence_penalty: validator.number().min(-2).max(2).optional(),\n    response_format: responseFormatSchema.optional(),\n    seed: validator.number().integer().optional(),\n    stop: validator\n      .alternatives(validator.string(), validator.array().items(validator.string()))\n      .optional(),\n    stream_options: validator.object().unknown(true).optional(),\n    temperature: validator.number().min(0).max(2).optional(),\n    tool_choice: toolChoiceSchema.optional(),\n    top_logprobs: validator.number().integer().min(0).optional(),\n    top_p: validator.number().min(0).max(1).optional(),\n    user: validator.string().optional(),\n    repetition_penalty: validator.number().optional(),\n    ignore_eos: validator.boolean().optional(),\n    extra_body: validator.object().unknown(true).optional(),\n    max_completion_tokens: validator.number().integer().min(1).optional(),\n  })\n  .unknown(false)\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\nexport const validateOptions = (input: unknown): WebLLMChatCompletionsAdapterOptions => {\n  const { value, error } = webLLMChatCompletionsOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], {\n      cause: error,\n    })\n  }\n  return value as WebLLMChatCompletionsAdapterOptions\n}\n\nvoid isValidationError\n"],"mappings":"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"}

package/batteries/llm/webllm_chat_completions.cjs

@@ -0,0 +1,50 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_batteries_llm_openai_chat_completions_helpers = require("./openai_chat_completions/helpers.cjs");
+const require_batteries_llm_webllm_chat_completions_exceptions = require("./webllm_chat_completions/exceptions.cjs");
+const require_batteries_llm_webllm_chat_completions_validation = require("./webllm_chat_completions/validation.cjs");
+require("./webllm_chat_completions/helpers.cjs");
+const require_batteries_llm_webllm_chat_completions_adapter = require("./webllm_chat_completions/adapter.cjs");
+exports.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_webllm_chat_completions_exceptions.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS;
+exports.E_UNSUPPORTED_MEDIA_MODALITY = require_batteries_llm_webllm_chat_completions_exceptions.E_UNSUPPORTED_MEDIA_MODALITY;
+exports.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
+exports.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS;
+exports.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR;
+exports.WebLLMChatCompletionsAdapter = require_batteries_llm_webllm_chat_completions_adapter.WebLLMChatCompletionsAdapter;
+exports.buildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.buildChatCompletionsHistory;
+exports.createChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.createChatCompletionsToolCallDeltaAccumulator;
+exports.defaultBuildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.defaultBuildChatCompletionsHistory;
+exports.defaultCreateChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.defaultCreateChatCompletionsToolCallDeltaAccumulator;
+exports.defaultDescriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.defaultDescriptionToChatCompletionsJsonSchema;
+exports.defaultFilterThoughts = require_batteries_llm_openai_chat_completions_helpers.defaultFilterThoughts;
+exports.defaultRenderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsSystemPrompt;
+exports.defaultRenderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsToolCallResult;
+exports.defaultRenderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderFirstPartyRetrievables;
+exports.defaultRenderMemories = require_batteries_llm_openai_chat_completions_helpers.defaultRenderMemories;
+exports.defaultRenderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievableSafetyDirective;
+exports.defaultRenderRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievables;
+exports.defaultRenderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.defaultRenderStandingInstructions;
+exports.defaultRenderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPrivateRetrievables;
+exports.defaultRenderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPublicRetrievables;
+exports.defaultRenderThought = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThought;
+exports.defaultRenderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTimelineMessage;
+exports.defaultRenderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTrustedContent;
+exports.defaultRenderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderUntrustedContent;
+exports.defaultToolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.defaultToolsToChatCompletionsTools;
+exports.descriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.descriptionToChatCompletionsJsonSchema;
+exports.filterThoughts = require_batteries_llm_openai_chat_completions_helpers.filterThoughts;
+exports.renderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsSystemPrompt;
+exports.renderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsToolCallResult;
+exports.renderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderFirstPartyRetrievables;
+exports.renderMemories = require_batteries_llm_openai_chat_completions_helpers.renderMemories;
+exports.renderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.renderRetrievableSafetyDirective;
+exports.renderRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderRetrievables;
+exports.renderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.renderStandingInstructions;
+exports.renderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPrivateRetrievables;
+exports.renderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPublicRetrievables;
+exports.renderThought = require_batteries_llm_openai_chat_completions_helpers.renderThought;
+exports.renderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.renderTimelineMessage;
+exports.renderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderTrustedContent;
+exports.renderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderUntrustedContent;
+exports.toolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.toolsToChatCompletionsTools;
+exports.validateOptions = require_batteries_llm_webllm_chat_completions_validation.validateOptions;
+exports.webLLMChatCompletionsOptionsSchema = require_batteries_llm_webllm_chat_completions_validation.webLLMChatCompletionsOptionsSchema;

package/batteries/llm/webllm_chat_completions.mjs

@@ -0,0 +1,6 @@
+import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools } from "./openai_chat_completions/helpers.mjs";
+import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_UNSUPPORTED_MEDIA_MODALITY, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR } from "./webllm_chat_completions/exceptions.mjs";
+import { validateOptions, webLLMChatCompletionsOptionsSchema } from "./webllm_chat_completions/validation.mjs";
+import "./webllm_chat_completions/helpers.mjs";
+import { WebLLMChatCompletionsAdapter } from "./webllm_chat_completions/adapter.mjs";
+export { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_UNSUPPORTED_MEDIA_MODALITY, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR, WebLLMChatCompletionsAdapter, buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools, validateOptions, webLLMChatCompletionsOptionsSchema };

package/batteries/llm.cjs

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_batteries_llm_openai_chat_completions_exceptions = require("./llm/openai_chat_completions/exceptions.cjs");
+const require_batteries_llm_openai_chat_completions_validation = require("./llm/openai_chat_completions/validation.cjs");
+const require_batteries_llm_openai_chat_completions_helpers = require("./llm/openai_chat_completions/helpers.cjs");
+const require_batteries_llm_openai_chat_completions_adapter = require("./llm/openai_chat_completions/adapter.cjs");
+require("./llm/openai_chat_completions.cjs");
+const require_batteries_llm_webllm_chat_completions_exceptions = require("./llm/webllm_chat_completions/exceptions.cjs");
+const require_batteries_llm_webllm_chat_completions_validation = require("./llm/webllm_chat_completions/validation.cjs");
+const require_batteries_llm_webllm_chat_completions_adapter = require("./llm/webllm_chat_completions/adapter.cjs");
+require("./llm/webllm_chat_completions.cjs");
+exports.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_openai_chat_completions_exceptions.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS;
+exports.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_webllm_chat_completions_exceptions.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS;
+exports.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
+exports.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR;
+exports.E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS;
+exports.E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT;
+exports.E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR;
+exports.E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED;
+exports.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
+exports.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS;
+exports.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR;
+exports.OpenAIChatCompletionsAdapter = require_batteries_llm_openai_chat_completions_adapter.OpenAIChatCompletionsAdapter;
+exports.WebLLMChatCompletionsAdapter = require_batteries_llm_webllm_chat_completions_adapter.WebLLMChatCompletionsAdapter;
+exports.buildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.buildChatCompletionsHistory;
+exports.createChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.createChatCompletionsToolCallDeltaAccumulator;
+exports.defaultBuildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.defaultBuildChatCompletionsHistory;
+exports.defaultCreateChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.defaultCreateChatCompletionsToolCallDeltaAccumulator;
+exports.defaultDescriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.defaultDescriptionToChatCompletionsJsonSchema;
+exports.defaultFilterThoughts = require_batteries_llm_openai_chat_completions_helpers.defaultFilterThoughts;
+exports.defaultRenderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsSystemPrompt;
+exports.defaultRenderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsToolCallResult;
+exports.defaultRenderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderFirstPartyRetrievables;
+exports.defaultRenderMemories = require_batteries_llm_openai_chat_completions_helpers.defaultRenderMemories;
+exports.defaultRenderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievableSafetyDirective;
+exports.defaultRenderRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievables;
+exports.defaultRenderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.defaultRenderStandingInstructions;
+exports.defaultRenderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPrivateRetrievables;
+exports.defaultRenderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPublicRetrievables;
+exports.defaultRenderThought = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThought;
+exports.defaultRenderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTimelineMessage;
+exports.defaultRenderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTrustedContent;
+exports.defaultRenderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderUntrustedContent;
+exports.defaultToolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.defaultToolsToChatCompletionsTools;
+exports.descriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.descriptionToChatCompletionsJsonSchema;
+exports.filterThoughts = require_batteries_llm_openai_chat_completions_helpers.filterThoughts;
+exports.openAIChatCompletionsOptionsSchema = require_batteries_llm_openai_chat_completions_validation.openAIChatCompletionsOptionsSchema;
+exports.renderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsSystemPrompt;
+exports.renderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsToolCallResult;
+exports.renderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderFirstPartyRetrievables;
+exports.renderMemories = require_batteries_llm_openai_chat_completions_helpers.renderMemories;
+exports.renderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.renderRetrievableSafetyDirective;
+exports.renderRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderRetrievables;
+exports.renderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.renderStandingInstructions;
+exports.renderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPrivateRetrievables;
+exports.renderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPublicRetrievables;
+exports.renderThought = require_batteries_llm_openai_chat_completions_helpers.renderThought;
+exports.renderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.renderTimelineMessage;
+exports.renderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderTrustedContent;
+exports.renderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderUntrustedContent;
+exports.toolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.toolsToChatCompletionsTools;
+exports.validateOptions = require_batteries_llm_openai_chat_completions_validation.validateOptions;
+exports.validateWebLLMChatCompletionsOptions = require_batteries_llm_webllm_chat_completions_validation.validateOptions;
+exports.webLLMChatCompletionsOptionsSchema = require_batteries_llm_webllm_chat_completions_validation.webLLMChatCompletionsOptionsSchema;

package/batteries/llm.mjs

@@ -0,0 +1,10 @@
+import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED } from "./llm/openai_chat_completions/exceptions.mjs";
+import { openAIChatCompletionsOptionsSchema, validateOptions } from "./llm/openai_chat_completions/validation.mjs";
+import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools } from "./llm/openai_chat_completions/helpers.mjs";
+import { OpenAIChatCompletionsAdapter } from "./llm/openai_chat_completions/adapter.mjs";
+import "./llm/openai_chat_completions.mjs";
+import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR } from "./llm/webllm_chat_completions/exceptions.mjs";
+import { validateOptions as validateOptions$1, webLLMChatCompletionsOptionsSchema } from "./llm/webllm_chat_completions/validation.mjs";
+import { WebLLMChatCompletionsAdapter } from "./llm/webllm_chat_completions/adapter.mjs";
+import "./llm/webllm_chat_completions.mjs";
+export { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR, OpenAIChatCompletionsAdapter, WebLLMChatCompletionsAdapter, buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, openAIChatCompletionsOptionsSchema, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools, validateOptions, validateOptions$1 as validateWebLLMChatCompletionsOptions, webLLMChatCompletionsOptionsSchema };

package/batteries/storage/flydrive/index.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Flydrive-backed spooled artifact storage for Node and server runtimes.
+ *
+ * @module @nhtio/adk/batteries/storage/flydrive
+ *
+ * @remarks
+ * **Requires Node 24+.** `flydrive` uses the `node:stream` `ReadableStream` web API which is
+ * only available from Node 24. This battery does not work in the browser or earlier Node versions.
+ *
+ * Opt-in storage battery backed by [flydrive](https://flydrive.dev). Provides
+ * {@link FlydriveSpoolReader} (a {@link @nhtio/adk!SpoolReader} over a flydrive key) and
+ * {@link FlydriveSpoolStore} (a `write(callId, bytes) → reader` persistence layer that wraps an
+ * existing `Disk`).
+ *
+ * The reader has two modes selected at construction time based on the size of the underlying
+ * object:
+ *
+ * - **Eager mode** — when the object's `contentLength` is below `streamThresholdBytes` (default
+ *   10 MiB), the reader calls `disk.get(key)` once, splits the content on `\n`, and caches
+ *   lines + byte count. All subsequent `line() / byteLength() / lineCount()` calls resolve from
+ *   memory.
+ * - **Streaming mode** — when `contentLength` meets or exceeds the threshold, the reader
+ *   streams the file once via `disk.getStream(key)` to build a line-offset index (`number[]`
+ *   of byte offsets per line), then serves each `line(i)` request by streaming the byte range
+ *   `[offsets[i], offsets[i+1])`. Caps RAM at one index + one line buffer regardless of file
+ *   size.
+ *
+ * Set `streamThresholdBytes: 0` to force streaming mode; set it to `Infinity` to force eager
+ * mode. The default of 10 MiB matches typical tool output sizes — tune it for your workload.
+ *
+ * The store and reader are pure-flydrive: they don't know about S3, GCS, or filesystem
+ * specifically — they delegate to whatever `Disk` you construct.
+ */
+import { Disk } from 'flydrive';
+import type { SpoolReader } from "../../../common";
+/**
+ * Constructor options for {@link FlydriveSpoolReader}.
+ */
+export interface FlydriveSpoolReaderOptions {
+    /**
+     * Byte-length threshold that switches between eager and streaming modes.
+     *
+     * @remarks
+     * - Below the threshold → eager (whole-file in memory).
+     * - At or above the threshold → streaming (line-offset index + per-line streaming reads).
+     *
+     * Set to `0` to force streaming mode; set to `Number.POSITIVE_INFINITY` to force eager mode.
+     *
+     * @defaultValue `10 * 1024 * 1024` (10 MiB)
+     */
+    streamThresholdBytes?: number;
+}
+/**
+ * Reads a flydrive-backed file as a {@link @nhtio/adk!SpoolReader}.
+ *
+ * @remarks
+ * Constructor is **not** async — but the first method call awaits a private readiness promise
+ * that fetches the object's metadata (and in eager mode, its contents). Subsequent calls reuse
+ * the cached state. This keeps construction call sites synchronous while still doing real I/O
+ * lazily.
+ *
+ * Implementations of {@link @nhtio/adk!SpoolReader.line}, {@link @nhtio/adk!SpoolReader.byteLength}, and
+ * {@link @nhtio/adk!SpoolReader.lineCount} all return promises. The `SpoolReader` contract supports both
+ * sync and async return; consumers of `SpooledArtifact` handle either.
+ */
+export declare class FlydriveSpoolReader implements SpoolReader {
+    #private;
+    constructor(disk: Disk, key: string, opts?: FlydriveSpoolReaderOptions);
+    line(index: number): Promise<string | undefined>;
+    byteLength(): Promise<number>;
+    lineCount(): Promise<number>;
+    /**
+     * Returns the full underlying content as a single decoded string, byte-faithful to the source.
+     *
+     * @remarks
+     * In **eager mode** the content is already cached at construction-time load and this method is
+     * effectively a property access. In **streaming mode** there is no cache: the file is
+     * re-streamed and concatenated on every call. Use {@link @nhtio/adk!SpooledArtifact.asString} judiciously
+     * on large streaming-mode artifacts.
+     */
+    readAll(): Promise<string>;
+}
+/**
+ * Constructor options for {@link FlydriveSpoolStore}.
+ */
+export interface FlydriveSpoolStoreOptions {
+    /**
+     * Optional key prefix prepended to every `callId`. Useful for namespacing tool-call artifacts
+     * inside a shared bucket (e.g. `"tool-calls/"`).
+     *
+     * @defaultValue `""`
+     */
+    keyPrefix?: string;
+    /**
+     * Default `streamThresholdBytes` for readers produced by `write()` and `read()`. Individual
+     * calls may override via their own `opts` argument.
+     *
+     * @defaultValue `10 * 1024 * 1024` (10 MiB)
+     */
+    streamThresholdBytes?: number;
+}
+/**
+ * "Give bytes, get a reader" persistence layer over a flydrive {@link Disk}.
+ *
+ * @remarks
+ * `write(callId, bytes)` calls `disk.put(key, bytes)` where `key = keyPrefix + callId`, then
+ * returns a fresh {@link FlydriveSpoolReader} pointed at the same key. `read(callId)` returns
+ * a reader without re-writing; `delete(callId)` calls `disk.delete(key)`.
+ *
+ * The store is stateless — it owns no in-memory cache of writes. Multiple `FlydriveSpoolStore`
+ * instances sharing the same disk + key prefix see the same data.
+ *
+ * @example
+ * ```ts
+ * import { Disk } from 'flydrive'
+ * import { FSDriver } from 'flydrive/drivers/fs'
+ * import { FlydriveSpoolStore } from '@nhtio/adk/batteries/storage/flydrive'
+ *
+ * const disk = new Disk(new FSDriver({ location: './tmp', visibility: 'public' }))
+ * const store = new FlydriveSpoolStore(disk)
+ *
+ * const bytes = await tool.executor(ctx)(args)
+ * const reader = await store.write(callId, bytes)
+ * const Ctor = tool.artifactConstructor?.() ?? SpooledArtifact
+ * const artifact = new Ctor(reader)
+ * ```
+ */
+export declare class FlydriveSpoolStore {
+    #private;
+    constructor(disk: Disk, opts?: FlydriveSpoolStoreOptions);
+    /**
+     * Persists `bytes` under `callId` and returns a reader bound to the stored key.
+     *
+     * @param callId - Identifier used to retrieve the bytes via {@link FlydriveSpoolStore.read}.
+     * @param bytes - The bytes to store, as a `string` or `Uint8Array`.
+     * @param opts - Per-call override for `streamThresholdBytes`.
+     * @returns A {@link FlydriveSpoolReader} over the stored bytes.
+     */
+    write(callId: string, bytes: string | Uint8Array, opts?: FlydriveSpoolReaderOptions): Promise<FlydriveSpoolReader>;
+    /**
+     * Returns a reader over the bytes previously written under `callId`.
+     *
+     * @remarks
+     * Returns `undefined` if the underlying key does not exist. Existence is checked via
+     * `disk.exists(key)` before the reader is returned, so callers can rely on a defined return
+     * value pointing at a real object.
+     *
+     * @param callId - Identifier supplied to a prior {@link FlydriveSpoolStore.write} call.
+     * @param opts - Per-call override for `streamThresholdBytes`.
+     * @returns A {@link FlydriveSpoolReader}, or `undefined` if the key is missing.
+     */
+    read(callId: string, opts?: FlydriveSpoolReaderOptions): Promise<FlydriveSpoolReader | undefined>;
+    /**
+     * Removes the entry under `callId`.
+     *
+     * @param callId - Identifier whose entry should be removed.
+     * @returns `true` if the key existed and was removed; `false` if it didn't exist.
+     */
+    delete(callId: string): Promise<boolean>;
+    /**
+     * Returns the full disk key for a given `callId` (i.e. `keyPrefix + callId`).
+     *
+     * @remarks
+     * Useful for tests or for callers that want to interact with the underlying disk directly.
+     */
+    keyFor(callId: string): string;
+}