@dexto/agent-config 1.6.0

package/LICENSE

@@ -0,0 +1,44 @@
+Elastic License 2.0 (ELv2)
+
+**Acceptance**
+By using the software, you agree to all of the terms and conditions below.
+
+**Copyright License**
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations and conditions below
+
+**Limitations**
+You may not provide the software to third parties as a hosted or managed service, where the service provides users with access to any substantial set of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality in the software, and you may not remove or obscure any functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor’s trademarks is subject to applicable law.
+
+**Patents**
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+**Notices**
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.
+
+**No Other Rights**
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+**Termination**
+If you use the software in violation of these terms, such use is not licensed, and your licenses will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your licenses will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your licenses to terminate automatically and permanently.
+
+**No Liability**
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.
+
+**Definitions**
+The _licensor_ is the entity offering these terms, and the _software_ is the software the licensor makes available under these terms, including any portion of it.
+
+_you_ refers to the individual or entity agreeing to these terms.
+
+_your company_ is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. _control_ means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+_your licenses_ are all the licenses granted to you for the software under these terms.
+
+_use_ means anything you do with the software requiring one of your licenses.
+
+_trademark_ means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,46 @@
+# `@dexto/agent-config`
+
+Schema + resolver utilities for turning an agent YAML config into concrete DI surfaces using images.
+
+This package is **product-layer glue**: core (`@dexto/core`) stays DI-friendly, and hosts (CLI/server/apps)
+use `@dexto/agent-config` to:
+
+- validate agent config (`AgentConfigSchema`)
+- load an image module (`loadImage()`)
+- merge image defaults into raw config (`applyImageDefaults()`)
+- resolve factories from the image into concrete instances (`resolveServicesFromConfig()`)
+- convert the result into `DextoAgentOptions` (`toDextoAgentOptions()`)
+
+## Quick example (apps)
+
+```ts
+import { DextoAgent } from '@dexto/core';
+import { loadAgentConfig } from '@dexto/agent-management';
+import {
+  AgentConfigSchema,
+  applyImageDefaults,
+  loadImage,
+  resolveServicesFromConfig,
+  setImageImporter,
+  toDextoAgentOptions,
+} from '@dexto/agent-config';
+
+// Under pnpm (strict dependency boundaries), configure image importing at the host entrypoint.
+setImageImporter((specifier) => import(specifier));
+
+const raw = await loadAgentConfig('./agents/my-agent.yml');
+const image = await loadImage(raw.image ?? '@dexto/image-local');
+const merged = applyImageDefaults(raw, image.defaults);
+
+const config = AgentConfigSchema.parse(merged);
+const services = await resolveServicesFromConfig(config, image);
+
+const agent = new DextoAgent(toDextoAgentOptions({ config, services }));
+await agent.start();
+```
+
+## Images (no registries)
+
+Images are typed modules (`DextoImage`) that export plain `Record<string, Factory>` maps.
+Resolver logic does property access by config `type` (e.g., `image.tools[entry.type]`) — there are no
+global registries or side effects.

package/dist/image/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/image/types.d.ts

@@ -0,0 +1,123 @@
+import type { BlobStore, Cache, Database, Hook, Logger, CompactionStrategy as CompactionStrategy, Tool } from '@dexto/core';
+import type { z } from 'zod';
+import type { AgentConfig } from '../schemas/agent-config.js';
+/**
+ * Image defaults are a partial, *unvalidated* agent config that is merged into the raw YAML config
+ * before schema validation.
+ *
+ * Merge semantics are implemented by `applyImageDefaults()`:
+ * - shallow merge at the top-level (config wins)
+ * - object fields merge 1-level deep
+ * - arrays are atomic (fully replaced; no concatenation) except `prompts`, which are merged to
+ *   avoid accidentally dropping image-provided prompts when an agent config defines its own prompts
+ */
+export type ImageDefaults = Partial<AgentConfig>;
+/**
+ * Optional tool metadata for UIs and discovery.
+ */
+export interface ToolFactoryMetadata {
+    displayName: string;
+    description: string;
+    category: string;
+}
+/**
+ * Tool factories are keyed by `type` in the agent config (`tools: [{ type: "..." }]`).
+ *
+ * A single factory entry can produce multiple tools, which is useful for "tool packs" where a single
+ * config block enables a related set of tools (e.g., filesystem tools: read/write/edit/glob/grep).
+ */
+export interface ToolFactory<TConfig = unknown> {
+    /** Zod schema for validating factory-specific configuration. */
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    /** Create one or more tool instances from validated config. */
+    create(config: TConfig): Tool[];
+    metadata?: ToolFactoryMetadata;
+}
+/**
+ * Storage factories are keyed by `type` in the agent config (`storage.blob.type`, etc.).
+ *
+ * Factories may return a Promise to support lazy optional dependencies (e.g., sqlite/pg/redis).
+ */
+export interface BlobStoreFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig, logger: Logger): BlobStore | Promise<BlobStore>;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface DatabaseFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig, logger: Logger): Database | Promise<Database>;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface CacheFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig, logger: Logger): Cache | Promise<Cache>;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Hook factories are keyed by `type` in the agent config (`hooks: [{ type: "..." }]`).
+ */
+export interface HookFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig): Hook;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Compaction factories are keyed by `type` in the agent config (`compaction.type`).
+ */
+export interface CompactionFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig): CompactionStrategy | Promise<CompactionStrategy>;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Logger factory used by the agent to create its logger instance.
+ *
+ * This remains a factory (vs a map) because an agent should have a single logger implementation.
+ */
+export interface LoggerFactory<TConfig = unknown> {
+    configSchema: z.ZodType<TConfig, z.ZodTypeDef, unknown>;
+    create(config: TConfig): Logger;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * An image is a typed module that bundles defaults and a set of factories that a host (CLI/server/app)
+ * may use to resolve config → concrete instances.
+ *
+ * Key design constraints:
+ * - No global registries; the image object itself is the lookup table (Record access by `type`)
+ * - Factories are plain exports; resolution is explicit and testable
+ * - Hosts decide how to load images (static import, dynamic import via `loadImage()`, allowlists, etc.)
+ */
+export interface DextoImage {
+    /**
+     * Metadata about the image package.
+     *
+     * `target`/`constraints` are free-form strings. Hosts may interpret these for UX/allowlisting
+     * but they have no built-in semantics in core.
+     */
+    metadata: {
+        name: string;
+        version: string;
+        description: string;
+        target?: string;
+        constraints?: string[];
+    };
+    defaults?: ImageDefaults;
+    /**
+     * Tool factories keyed by config `type`.
+     * Example: `{ "filesystem-tools": fileSystemToolsFactory }`.
+     */
+    tools: Record<string, ToolFactory>;
+    /**
+     * Storage factories keyed by config `type`.
+     */
+    storage: {
+        blob: Record<string, BlobStoreFactory>;
+        database: Record<string, DatabaseFactory>;
+        cache: Record<string, CacheFactory>;
+    };
+    hooks: Record<string, HookFactory>;
+    compaction: Record<string, CompactionFactory>;
+    logger: LoggerFactory;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  AgentConfigSchema: () => import_agent_config.AgentConfigSchema,
+  CompactionConfigSchema: () => import_compaction.CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG: () => import_compaction.DEFAULT_COMPACTION_CONFIG,
+  HookFactoryEntrySchema: () => import_hooks.HookFactoryEntrySchema,
+  HooksConfigSchema: () => import_hooks.HooksConfigSchema,
+  NoOpCompactionConfigSchema: () => import_compaction.NoOpCompactionConfigSchema,
+  ReactiveOverflowCompactionConfigSchema: () => import_compaction.ReactiveOverflowCompactionConfigSchema,
+  ToolFactoryEntrySchema: () => import_agent_config.ToolFactoryEntrySchema,
+  applyImageDefaults: () => import_apply_image_defaults.applyImageDefaults,
+  cleanNullValues: () => import_clean_null_values.cleanNullValues,
+  createAgentConfigSchema: () => import_agent_config.createAgentConfigSchema,
+  loadImage: () => import_load_image.loadImage,
+  resolveServicesFromConfig: () => import_resolve_services_from_config.resolveServicesFromConfig,
+  setImageImporter: () => import_load_image.setImageImporter,
+  toDextoAgentOptions: () => import_to_dexto_agent_options.toDextoAgentOptions
+});
+module.exports = __toCommonJS(index_exports);
+var import_agent_config = require("./schemas/agent-config.js");
+var import_hooks = require("./schemas/hooks.js");
+var import_compaction = require("./schemas/compaction.js");
+var import_apply_image_defaults = require("./resolver/apply-image-defaults.js");
+var import_load_image = require("./resolver/load-image.js");
+var import_resolve_services_from_config = require("./resolver/resolve-services-from-config.js");
+var import_to_dexto_agent_options = require("./resolver/to-dexto-agent-options.js");
+var import_clean_null_values = require("./utils/clean-null-values.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentConfigSchema,
+  CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG,
+  HookFactoryEntrySchema,
+  HooksConfigSchema,
+  NoOpCompactionConfigSchema,
+  ReactiveOverflowCompactionConfigSchema,
+  ToolFactoryEntrySchema,
+  applyImageDefaults,
+  cleanNullValues,
+  createAgentConfigSchema,
+  loadImage,
+  resolveServicesFromConfig,
+  setImageImporter,
+  toDextoAgentOptions
+});

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { BlobStoreFactory, CacheFactory, CompactionFactory, DatabaseFactory, DextoImage, ImageDefaults, LoggerFactory, HookFactory, ToolFactory, } from './image/types.js';
+export { AgentConfigSchema, createAgentConfigSchema, ToolFactoryEntrySchema, } from './schemas/agent-config.js';
+export type { AgentConfig, ValidatedAgentConfig, ToolFactoryEntry, } from './schemas/agent-config.js';
+export type { HooksConfig, ValidatedHooksConfig, HookFactoryEntry } from './schemas/hooks.js';
+export { HookFactoryEntrySchema, HooksConfigSchema } from './schemas/hooks.js';
+export { CompactionConfigSchema, DEFAULT_COMPACTION_CONFIG, ReactiveOverflowCompactionConfigSchema, NoOpCompactionConfigSchema, } from './schemas/compaction.js';
+export type { CompactionConfig, ValidatedCompactionConfig, ReactiveOverflowCompactionConfig, NoOpCompactionConfig, } from './schemas/compaction.js';
+export { applyImageDefaults } from './resolver/apply-image-defaults.js';
+export { loadImage, setImageImporter } from './resolver/load-image.js';
+export type { ImageImporter } from './resolver/load-image.js';
+export { resolveServicesFromConfig } from './resolver/resolve-services-from-config.js';
+export { toDextoAgentOptions } from './resolver/to-dexto-agent-options.js';
+export type { ResolvedServices } from './resolver/types.js';
+export { cleanNullValues } from './utils/clean-null-values.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACR,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EACH,sBAAsB,EACtB,yBAAyB,EACzB,sCAAsC,EACtC,0BAA0B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACR,gBAAgB,EAChB,yBAAyB,EACzB,gCAAgC,EAChC,oBAAoB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import {
+  AgentConfigSchema,
+  createAgentConfigSchema,
+  ToolFactoryEntrySchema
+} from "./schemas/agent-config.js";
+import { HookFactoryEntrySchema, HooksConfigSchema } from "./schemas/hooks.js";
+import {
+  CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG,
+  ReactiveOverflowCompactionConfigSchema,
+  NoOpCompactionConfigSchema
+} from "./schemas/compaction.js";
+import { applyImageDefaults } from "./resolver/apply-image-defaults.js";
+import { loadImage, setImageImporter } from "./resolver/load-image.js";
+import { resolveServicesFromConfig } from "./resolver/resolve-services-from-config.js";
+import { toDextoAgentOptions } from "./resolver/to-dexto-agent-options.js";
+import { cleanNullValues } from "./utils/clean-null-values.js";
+export {
+  AgentConfigSchema,
+  CompactionConfigSchema,
+  DEFAULT_COMPACTION_CONFIG,
+  HookFactoryEntrySchema,
+  HooksConfigSchema,
+  NoOpCompactionConfigSchema,
+  ReactiveOverflowCompactionConfigSchema,
+  ToolFactoryEntrySchema,
+  applyImageDefaults,
+  cleanNullValues,
+  createAgentConfigSchema,
+  loadImage,
+  resolveServicesFromConfig,
+  setImageImporter,
+  toDextoAgentOptions
+};

package/dist/resolver/apply-image-defaults.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var apply_image_defaults_exports = {};
+__export(apply_image_defaults_exports, {
+  applyImageDefaults: () => applyImageDefaults
+});
+module.exports = __toCommonJS(apply_image_defaults_exports);
+var import_utils = require("./utils.js");
+function promptIdentityKey(prompt) {
+  if (!(0, import_utils.isPlainObject)(prompt)) {
+    return null;
+  }
+  const type = prompt.type;
+  if (type === "inline") {
+    const id = prompt.id;
+    return typeof id === "string" && id.length > 0 ? `inline:${id}` : null;
+  }
+  if (type === "file") {
+    const file = prompt.file;
+    if (typeof file !== "string" || file.length === 0) {
+      return null;
+    }
+    const namespace = prompt.namespace;
+    const namespacePart = typeof namespace === "string" ? namespace : "";
+    return `file:${namespacePart}:${file}`;
+  }
+  return null;
+}
+function mergePrompts(configPrompts, defaultPrompts) {
+  if (configPrompts === void 0) {
+    return defaultPrompts;
+  }
+  if (!Array.isArray(configPrompts)) {
+    return configPrompts;
+  }
+  if (configPrompts.length === 0) {
+    return [];
+  }
+  if (!Array.isArray(defaultPrompts) || defaultPrompts.length === 0) {
+    return configPrompts;
+  }
+  const order = [];
+  const entries = /* @__PURE__ */ new Map();
+  for (const [idx, prompt] of defaultPrompts.entries()) {
+    const key = promptIdentityKey(prompt) ?? `default:${idx}`;
+    if (!entries.has(key)) {
+      order.push(key);
+    }
+    entries.set(key, prompt);
+  }
+  for (const [idx, prompt] of configPrompts.entries()) {
+    const key = promptIdentityKey(prompt) ?? `config:${idx}`;
+    if (!entries.has(key)) {
+      order.push(key);
+    }
+    entries.set(key, prompt);
+  }
+  return order.map((key) => entries.get(key));
+}
+function applyImageDefaults(config, defaults) {
+  if (!defaults) {
+    return config;
+  }
+  const merged = { ...defaults, ...config };
+  for (const [key, defaultValue] of Object.entries(defaults)) {
+    const configValue = config[key];
+    if (!(0, import_utils.isPlainObject)(defaultValue) || !(0, import_utils.isPlainObject)(configValue)) {
+      continue;
+    }
+    merged[key] = {
+      ...defaultValue,
+      ...configValue
+    };
+  }
+  if ("prompts" in defaults || "prompts" in config) {
+    merged.prompts = mergePrompts(
+      config.prompts,
+      defaults.prompts
+    );
+  }
+  return merged;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyImageDefaults
+});

package/dist/resolver/apply-image-defaults.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig } from '../schemas/agent-config.js';
+import type { ImageDefaults } from '../image/types.js';
+/**
+ * Apply image defaults to an *unvalidated* agent config.
+ *
+ * Merge strategy:
+ * - shallow top-level merge, config wins
+ * - object fields merge 1-level deep
+ * - arrays are atomic and fully replaced (no concatenation) EXCEPT:
+ *   - prompts: when config provides prompts, image prompts are retained unless config sets prompts: []
+ */
+export declare function applyImageDefaults(config: AgentConfig, defaults?: ImageDefaults): AgentConfig;
+//# sourceMappingURL=apply-image-defaults.d.ts.map

package/dist/resolver/apply-image-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-image-defaults.d.ts","sourceRoot":"","sources":["../../src/resolver/apply-image-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoEvD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,WAAW,CA2B7F"}

package/dist/resolver/apply-image-defaults.js

@@ -0,0 +1,78 @@
+import { isPlainObject } from "./utils.js";
+function promptIdentityKey(prompt) {
+  if (!isPlainObject(prompt)) {
+    return null;
+  }
+  const type = prompt.type;
+  if (type === "inline") {
+    const id = prompt.id;
+    return typeof id === "string" && id.length > 0 ? `inline:${id}` : null;
+  }
+  if (type === "file") {
+    const file = prompt.file;
+    if (typeof file !== "string" || file.length === 0) {
+      return null;
+    }
+    const namespace = prompt.namespace;
+    const namespacePart = typeof namespace === "string" ? namespace : "";
+    return `file:${namespacePart}:${file}`;
+  }
+  return null;
+}
+function mergePrompts(configPrompts, defaultPrompts) {
+  if (configPrompts === void 0) {
+    return defaultPrompts;
+  }
+  if (!Array.isArray(configPrompts)) {
+    return configPrompts;
+  }
+  if (configPrompts.length === 0) {
+    return [];
+  }
+  if (!Array.isArray(defaultPrompts) || defaultPrompts.length === 0) {
+    return configPrompts;
+  }
+  const order = [];
+  const entries = /* @__PURE__ */ new Map();
+  for (const [idx, prompt] of defaultPrompts.entries()) {
+    const key = promptIdentityKey(prompt) ?? `default:${idx}`;
+    if (!entries.has(key)) {
+      order.push(key);
+    }
+    entries.set(key, prompt);
+  }
+  for (const [idx, prompt] of configPrompts.entries()) {
+    const key = promptIdentityKey(prompt) ?? `config:${idx}`;
+    if (!entries.has(key)) {
+      order.push(key);
+    }
+    entries.set(key, prompt);
+  }
+  return order.map((key) => entries.get(key));
+}
+function applyImageDefaults(config, defaults) {
+  if (!defaults) {
+    return config;
+  }
+  const merged = { ...defaults, ...config };
+  for (const [key, defaultValue] of Object.entries(defaults)) {
+    const configValue = config[key];
+    if (!isPlainObject(defaultValue) || !isPlainObject(configValue)) {
+      continue;
+    }
+    merged[key] = {
+      ...defaultValue,
+      ...configValue
+    };
+  }
+  if ("prompts" in defaults || "prompts" in config) {
+    merged.prompts = mergePrompts(
+      config.prompts,
+      defaults.prompts
+    );
+  }
+  return merged;
+}
+export {
+  applyImageDefaults
+};