@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/chunk-KFW4GE7H.mjs

@@ -0,0 +1,1289 @@
+import { A_FrameSchema, A_FrameSchemaFeatures } from './chunk-GRNVK7DW.mjs';
+import { A_FrameDynamicContent, A_FrameDynamicContentFeatures, A_FrameDynamicContentOperation, A_FrameDynamicPatch } from './chunk-M2ZSE6YJ.mjs';
+import { A_FrameEnv } from './chunk-F64CK4NI.mjs';
+import { A_FrameNamespace, A_FrameNamespaceFeatures } from './chunk-AMMQ76RJ.mjs';
+import { A_FrameCompletion, A_FrameCompletionFeatures } from './chunk-OK7I5OQ3.mjs';
+import { A_FrameSegment, A_FrameSegmentFeatures } from './chunk-UCAWV2IG.mjs';
+import { A_FrameDefinition, A_FrameDefinitionFeatures } from './chunk-RVXASBMQ.mjs';
+import { A_FRAME_MODELS } from './chunk-2HUSP34L.mjs';
+import { __decorateClass, __decorateParam } from './chunk-OI76LHVT.mjs';
+import { A_Feature, A_Inject, A_Caller, A_Error, A_Component, A_Scope, A_Context, A_Entity, A_CommonHelper, A_Fragment } from '@adaas/a-concept';
+
+// src/lib/A-FrameChannel/A-FrameChannel.constants.ts
+var A_FrameFeatures = {
+  Request: "_A_FRAME_REQUEST",
+  Socket: "_A_FRAME_SOCKET",
+  Stream: "_A_FRAME_STREAM",
+  Send: "_A_FRAME_SEND"
+};
+var A_FrameChannelStreamStatuses = {
+  Open: "open",
+  Closed: "closed"
+};
+var A_FrameChannelStreamFeatures = {
+  open: "_A_FRAME_CHANNEL_STREAM_OPEN",
+  send: "_A_FRAME_CHANNEL_STREAM_SEND",
+  onEvent: "_A_FRAME_CHANNEL_STREAM_ON_EVENT",
+  onError: "_A_FRAME_CHANNEL_STREAM_ON_ERROR",
+  onComplete: "_A_FRAME_CHANNEL_STREAM_ON_COMPLETE",
+  onClose: "_A_FRAME_CHANNEL_STREAM_ON_CLOSE"
+};
+var A_FrameChannelSocketStatuses = {
+  Connecting: "connecting",
+  Open: "open",
+  Closed: "closed"
+};
+var A_FrameChannelSocketFeatures = {
+  onEvent: "_A_FRAME_CHANNEL_SOCKET_ON_EVENT",
+  onError: "_A_FRAME_CHANNEL_SOCKET_ON_ERROR",
+  onOpen: "_A_FRAME_CHANNEL_SOCKET_ON_OPEN",
+  onClose: "_A_FRAME_CHANNEL_SOCKET_ON_CLOSE"
+};
+var A_FrameChannelRequest = class extends A_Fragment {
+  constructor(method, path, body) {
+    super({ name: "a-frame-channel-request" });
+    this.method = method;
+    this.path = path;
+    this.body = body;
+  }
+  complete(response) {
+    this._response = response;
+  }
+  fail(error) {
+    this._error = error;
+  }
+  get response() {
+    return this._response;
+  }
+  get error() {
+    return this._error;
+  }
+};
+var A_FrameChannelError = class extends A_Error {
+};
+A_FrameChannelError.InvalidRequest = "InvalidRequest";
+A_FrameChannelError.Timeout = "Timeout";
+A_FrameChannelError.RequestFailed = "RequestFailed";
+
+// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts
+var A_FrameDynamicStructureFeatures = {
+  Load: "_A_FRAME_DYNAMIC_STRUCTURE_LOAD",
+  Patch: "_A_FRAME_DYNAMIC_STRUCTURE_PATCH",
+  Generate: "_A_FRAME_DYNAMIC_STRUCTURE_GENERATE",
+  Map: "_A_FRAME_DYNAMIC_STRUCTURE_MAP"
+};
+var A_FrameDynamicStructureEvents = {
+  Updated: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"
+};
+var A_FrameDynamicStructureError = class extends A_Error {
+};
+A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
+A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
+A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
+A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
+A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
+var A_FrameComponentMapIndex = class extends A_Fragment {
+  constructor() {
+    super({ name: "a-frame-component-map-index" });
+    this._entries = /* @__PURE__ */ new Map();
+  }
+  // ── Basic mutation ───────────────────────────────────────────────────────
+  /**
+   * Store (or overwrite) a map entry for the element identified by `entry.prompt`.
+   */
+  set(entry) {
+    this._entries.set(entry.prompt, entry);
+  }
+  /**
+   * Retrieve the map entry for the given prompt, or `undefined` if not yet stored.
+   */
+  get(prompt) {
+    return this._entries.get(prompt);
+  }
+  /** Remove all stored entries. */
+  clear() {
+    this._entries.clear();
+  }
+  // ── Accessors ────────────────────────────────────────────────────────────
+  /** Total number of stored entries. */
+  get size() {
+    return this._entries.size;
+  }
+  /** All stored entries in insertion order. */
+  list() {
+    return Array.from(this._entries.values());
+  }
+  /** Entries that have been successfully matched to a registered class. */
+  get matched() {
+    return this.list().filter((e) => e.matchedClass !== null);
+  }
+  /** Entries where no matching registered class was found. */
+  get unmatched() {
+    return this.list().filter((e) => e.matchedClass === null);
+  }
+  // ── Result building ──────────────────────────────────────────────────────
+  /**
+   * Construct a fully structured `A_FrameComponentMapResult` from the
+   * accumulated entries and the provided definition.
+   *
+   * For each element in the definition the method looks up its entry by
+   * prompt.  If no entry exists (element had no server embedding), a default
+   * unmatched entry is generated so the result shape always matches the
+   * definition shape.
+   */
+  toResult(definition) {
+    const getEntry = (el) => {
+      const existing = this._entries.get(el.prompt);
+      if (existing) return existing;
+      return { prompt: el.prompt, role: el.role, class: el.class, matchedClass: null, matchScore: 0 };
+    };
+    return {
+      containers: definition.containers.map((c) => ({
+        ...getEntry(c),
+        components: (c.components ?? []).map(getEntry),
+        fragments: (c.fragments ?? []).map(getEntry),
+        entities: (c.entities ?? []).map(getEntry)
+      })),
+      components: definition.components.map(getEntry),
+      fragments: definition.fragments.map(getEntry),
+      entities: definition.entities.map(getEntry)
+    };
+  }
+};
+var A_FrameDynamicStructureOperation = class extends A_Fragment {
+  constructor(params = {}) {
+    super({ name: "a-frame-dynamic-structure-operation-context" });
+    this._meta = /* @__PURE__ */ new Map();
+    this._meta.set("params", params);
+  }
+  get params() {
+    return this._meta.get("params");
+  }
+  get(key) {
+    return this._meta.get(key);
+  }
+  set(key, value) {
+    this._meta.set(key, value);
+  }
+};
+
+// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts
+var A_FrameDynamicStructure = class extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  fromNew(options) {
+    super.fromNew(options);
+    this.createdAt = Date.now();
+    this.prompt = options.prompt;
+    this.model = options.options?.model || A_FRAME_MODELS.PULSAR;
+    this._context = options.options?.context ?? "";
+    this._metaHint = options.options?.metaHint ?? "";
+    this._includeBases = (options.options?.includeBases || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._excludeBases = (options.options?.excludeBases || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._enabledComponents = (options.options?.enabledComponents || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._minScore = options.options?.minScore ?? 0.7;
+    this._maxRetries = options.options?.maxRetries ?? 3;
+    this._candidateCount = options.options?.candidateCount ?? 5;
+    this._definition = null;
+    this._mapResult = null;
+    this._history = [];
+    this._version = 0;
+  }
+  // ── Accessors ─────────────────────────────────────────────────────────────
+  /** The AI model name used for generation / patching. */
+  get modelName() {
+    return this.model;
+  }
+  /** Context hint forwarded to the AI for scoping architecture style. */
+  get contextHint() {
+    return this._context;
+  }
+  /** Meta/prop hint forwarded to the AI for component selection. */
+  get metaHintValue() {
+    return this._metaHint;
+  }
+  /** Base-class allowlist (string names). */
+  get includedBases() {
+    return this._includeBases;
+  }
+  /** Base-class denylist (string names). */
+  get excludedBases() {
+    return this._excludeBases;
+  }
+  /** Explicit component allowlist (string names). */
+  get enabledComponentsList() {
+    return this._enabledComponents;
+  }
+  /** Minimum cosine-similarity score (0–1) required for a component match. */
+  get minScore() {
+    return this._minScore;
+  }
+  /** Max server refinement retries per unmatched element. */
+  get maxRetries() {
+    return this._maxRetries;
+  }
+  /** Number of top candidates to send to the AI on each retry. */
+  get candidateCount() {
+    return this._candidateCount;
+  }
+  /** Current architecture definition as a raw object, or null before first generate(). */
+  get definition() {
+    return this._definition;
+  }
+  /**
+   * Current architecture definition serialised to a formatted JSON string,
+   * with server embeddings stripped for readability.
+   * Returns an empty-definition JSON before generate() is called.
+   */
+  get structure() {
+    if (!this._definition) {
+      return JSON.stringify({ containers: [], components: [], fragments: [], entities: [] }, null, 2);
+    }
+    return JSON.stringify(this._stripEmbeddings(this._definition), null, 2);
+  }
+  /** Component-mapping result produced by map(), or null before map() is called. */
+  get mapResult() {
+    return this._mapResult;
+  }
+  /** Immutable patch history. */
+  get history() {
+    return this._history;
+  }
+  /** Current definition version (increments with each patch). */
+  get version() {
+    return this._version;
+  }
+  // ── Main pipeline ─────────────────────────────────────────────────────────
+  /**
+   * Generate the architecture definition from the entity's prompt.
+   * Calls the server's /api/v1/structure/generate endpoint via the A_FrameChannel feature.
+   */
+  async generate() {
+    const operation = new A_FrameDynamicStructureOperation();
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-structure-generate",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicStructureError({
+        title: A_FrameDynamicStructureError.GenerationFailed,
+        description: `Failed to generate structure: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  /**
+   * Apply a natural-language patch instruction to the current definition.
+   * Calls the server's /api/v1/structure/patch endpoint via the A_FrameChannel feature.
+   */
+  async patch(instruction) {
+    const operation = new A_FrameDynamicStructureOperation({ instruction });
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-structure-patch",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicStructureFeatures.Patch, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicStructureError({
+        title: A_FrameDynamicStructureError.GenerationFailed,
+        description: `Failed to patch structure: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  /**
+   * Match every element in the current definition against the local A_FrameIndex.
+   * Retries unmatched elements via server-side refinement patches.
+   *
+   * Results are stored separately from the raw definition and are available
+   * via `mapResult` after this call completes.
+   */
+  async map() {
+    const mapIndex = new A_FrameComponentMapIndex();
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-structure-map",
+      fragments: [mapIndex]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicStructureFeatures.Map, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicStructureError({
+        title: A_FrameDynamicStructureError.GenerationFailed,
+        description: `Failed to map structure: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  // ── Hydration ─────────────────────────────────────────────────────────────
+  /**
+   * Populate the definition from a server generate response.
+   * Creates the first history entry.
+   */
+  hydrateFromGeneration(definition, meta) {
+    this._definition = definition;
+    this._mapResult = null;
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: `Generated for: "${this.prompt}"`,
+      encoded: Buffer.from(JSON.stringify(this._stripEmbeddings(definition))).toString("base64"),
+      delta: this._countElements(definition)
+    }));
+  }
+  /**
+   * Replace the current definition with a patched version from the server.
+   * Increments the version and records a history entry.
+   */
+  hydrateFromPatch(definition, patchSummary, meta) {
+    const prevCount = this._definition ? this._countElements(this._definition) : 0;
+    this._definition = definition;
+    this._mapResult = null;
+    this._version++;
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: patchSummary,
+      encoded: Buffer.from(JSON.stringify(this._stripEmbeddings(definition))).toString("base64"),
+      delta: this._countElements(definition) - prevCount
+    }));
+  }
+  /**
+   * Store the component-mapping result produced by `A_FrameComponentMapper`.
+   * Called by the mapper after it finishes matching all elements.
+   */
+  hydrateFromMap(result) {
+    this._mapResult = result;
+  }
+  // ── Serialisation ─────────────────────────────────────────────────────────
+  toJSON() {
+    const elementCount = this._definition ? this._countElements(this._definition) : 0;
+    return {
+      ...super.toJSON(),
+      name: this.prompt,
+      description: `DynamicStructure with ${elementCount} elements and ${this._history.length} patches`,
+      metadata: {
+        model: this.model,
+        context: this._context,
+        metaHint: this._metaHint,
+        includeBases: this._includeBases,
+        excludeBases: this._excludeBases,
+        enabledComponents: this._enabledComponents,
+        candidateCount: this._candidateCount,
+        createdAt: this.createdAt
+      },
+      history: this._history.map((p) => p.toJSON())
+    };
+  }
+  // ── Private helpers ───────────────────────────────────────────────────────
+  _countElements(def) {
+    return (def.containers?.length ?? 0) + (def.components?.length ?? 0) + (def.fragments?.length ?? 0) + (def.entities?.length ?? 0);
+  }
+  /** Return a copy of the definition with all `embedding` arrays removed. */
+  _stripEmbeddings(def) {
+    const strip = (el) => {
+      const { embedding, ...rest } = el;
+      return rest;
+    };
+    return {
+      containers: def.containers.map((c) => ({
+        ...strip(c),
+        components: (c.components ?? []).map(strip),
+        fragments: (c.fragments ?? []).map(strip),
+        entities: (c.entities ?? []).map(strip)
+      })),
+      components: def.components.map(strip),
+      fragments: def.fragments.map(strip),
+      entities: def.entities.map(strip)
+    };
+  }
+};
+
+// src/lib/A-FrameDynamicFeature/A-FrameDynamicFeature.constants.ts
+var A_FrameDynamicFeatureFeatures = {
+  Generate: "_A_FRAME_DYNAMIC_FEATURE_GENERATE",
+  Patch: "_A_FRAME_DYNAMIC_FEATURE_PATCH",
+  Map: "_A_FRAME_DYNAMIC_FEATURE_MAP"
+};
+var A_FrameDynamicFeatureOperation = class extends A_Fragment {
+  constructor(params = {}) {
+    super({ name: "a-frame-dynamic-feature-operation-context" });
+    this._meta = /* @__PURE__ */ new Map();
+    this._meta.set("params", params);
+  }
+  get params() {
+    return this._meta.get("params");
+  }
+  get(key) {
+    return this._meta.get(key);
+  }
+  set(key, value) {
+    this._meta.set(key, value);
+  }
+};
+var A_FrameDynamicFeatureError = class extends A_Error {
+};
+A_FrameDynamicFeatureError.GenerationFailed = "GenerationFailed";
+A_FrameDynamicFeatureError.PatchFailed = "PatchFailed";
+A_FrameDynamicFeatureError.MappingFailed = "MappingFailed";
+A_FrameDynamicFeatureError.MethodNotFound = "MethodNotFound";
+A_FrameDynamicFeatureError.InvalidOperation = "InvalidOperation";
+var A_FrameMethodMapIndex = class extends A_Fragment {
+  constructor() {
+    super({ name: "a-frame-method-map-index" });
+    this._stepEntries = /* @__PURE__ */ new Map();
+    this._elementEntries = /* @__PURE__ */ new Map();
+  }
+  // ── Step entries ─────────────────────────────────────────────────────────
+  setStep(entry) {
+    this._stepEntries.set(entry.prompt, entry);
+  }
+  getStep(prompt) {
+    return this._stepEntries.get(prompt);
+  }
+  // ── Element entries (components / fragments / entities) ───────────────────
+  setElement(entry) {
+    this._elementEntries.set(entry.prompt, entry);
+  }
+  getElement(prompt) {
+    return this._elementEntries.get(prompt);
+  }
+  // ── Accessors ─────────────────────────────────────────────────────────────
+  clear() {
+    this._stepEntries.clear();
+    this._elementEntries.clear();
+  }
+  get stepCount() {
+    return this._stepEntries.size;
+  }
+  get elementCount() {
+    return this._elementEntries.size;
+  }
+  get matchedSteps() {
+    return Array.from(this._stepEntries.values()).filter((e) => e.matchedMethod !== null);
+  }
+  get unmatchedSteps() {
+    return Array.from(this._stepEntries.values()).filter((e) => e.matchedMethod === null);
+  }
+  // ── Result building ───────────────────────────────────────────────────────
+  /**
+   * Construct a fully structured `A_FrameDynamicFeatureMapResult` from the
+   * accumulated entries and the provided definition.
+   */
+  toResult(definition) {
+    const getStep = (step) => {
+      const existing = this._stepEntries.get(step.prompt);
+      if (existing) return existing;
+      return {
+        prompt: step.prompt,
+        inputs: step.inputs,
+        outputs: step.outputs,
+        matchedClass: null,
+        matchedMethod: null,
+        matchScore: 0
+      };
+    };
+    const getElement = (el) => {
+      const existing = this._elementEntries.get(el.prompt);
+      if (existing) return existing;
+      return { prompt: el.prompt, matchedClass: null, matchScore: 0 };
+    };
+    return {
+      steps: definition.steps.map(getStep),
+      components: definition.components.map(getElement),
+      fragments: definition.fragments.map(getElement),
+      entities: definition.entities.map(getElement)
+    };
+  }
+};
+var A_FrameDynamicFeature = class extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  fromNew(options) {
+    super.fromNew(options);
+    this.createdAt = Date.now();
+    this.prompt = options.prompt;
+    this._model = options.options?.model ?? A_FRAME_MODELS.PULSAR;
+    this._context = options.options?.context ?? "";
+    this._includeBases = (options.options?.includeBases ?? []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._excludeBases = (options.options?.excludeBases ?? []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._enabledComponents = (options.options?.enabledComponents ?? []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this._minScore = options.options?.minScore ?? 0.7;
+    this._maxRetries = options.options?.maxRetries ?? 3;
+    this._definition = null;
+    this._mapResult = null;
+    this._history = [];
+    this._version = 0;
+  }
+  // ── Accessors ───────────────────────────────────────────────────────────────
+  get modelName() {
+    return this._model;
+  }
+  get contextHint() {
+    return this._context;
+  }
+  get includedBases() {
+    return this._includeBases;
+  }
+  get excludedBases() {
+    return this._excludeBases;
+  }
+  get enabledComponentsList() {
+    return this._enabledComponents;
+  }
+  get minScore() {
+    return this._minScore;
+  }
+  get maxRetries() {
+    return this._maxRetries;
+  }
+  /** Current workflow definition, or `null` before first `generate()`. */
+  get definition() {
+    return this._definition;
+  }
+  /**
+   * Serialised workflow definition (no embedding arrays) — safe to
+   * log or persist.  Returns an empty shell before `generate()` is called.
+   */
+  get workflow() {
+    if (!this._definition) {
+      return JSON.stringify({ title: "", description: "", steps: [], components: [], fragments: [], entities: [] }, null, 2);
+    }
+    return JSON.stringify(this._stripEmbeddings(this._definition), null, 2);
+  }
+  /** Component-mapping result produced by `map()`, or `null` before that call. */
+  get mapResult() {
+    return this._mapResult;
+  }
+  /** Immutable patch history. */
+  get history() {
+    return this._history;
+  }
+  /** Version counter — increments with each `patch()` call. */
+  get version() {
+    return this._version;
+  }
+  // ── Main pipeline ───────────────────────────────────────────────────────────────
+  /**
+   * Generate the workflow definition from the entity's prompt.
+   *
+   * Calls the server's `/api/v1/feature/generate` endpoint.  The server
+   * returns an ordered list of steps (with embeddings), a list of supporting
+   * components/fragments/entities, and a human-readable title + description
+   * of the workflow.
+   *
+   * After this call succeeds, invoke `map()` to match each element to a
+   * registered class/method in the local A_FrameIndex.
+   */
+  async generate() {
+    const operation = new A_FrameDynamicFeatureOperation();
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-feature-generate",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicFeatureFeatures.Generate, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicFeatureError({
+        title: A_FrameDynamicFeatureError.GenerationFailed,
+        description: `Failed to generate feature workflow: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  /**
+   * Apply a natural-language patch instruction to refine the current workflow.
+   *
+   * Calls the server's `/api/v1/feature/patch` endpoint.  Increments the
+   * version and records a history entry.  A previous `map()` result is
+   * invalidated — call `map()` again after patching.
+   */
+  async patch(instruction) {
+    const operation = new A_FrameDynamicFeatureOperation({ instruction });
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-feature-patch",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicFeatureFeatures.Patch, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicFeatureError({
+        title: A_FrameDynamicFeatureError.PatchFailed,
+        description: `Failed to patch feature workflow: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  /**
+   * Match every step and supporting element in the current workflow definition
+   * against the local A_FrameIndex.
+   *
+   * Steps are matched to registered *methods* (via embedded method-level
+   * definitions indexed with `@A_Frame.Define`).  Supporting components,
+   * fragments, and entities are matched to registered classes.
+   *
+   * Unmatched steps are retried via server-side refinement patches (up to
+   * `maxRetries` times) before being marked with a `matchError`.
+   *
+   * Results are stored in `mapResult` after this call completes.
+   */
+  async map() {
+    const mapIndex = new A_FrameMethodMapIndex();
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-feature-map",
+      fragments: [mapIndex]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicFeatureFeatures.Map, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicFeatureError({
+        title: A_FrameDynamicFeatureError.MappingFailed,
+        description: `Failed to map feature workflow: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  // ── Hydration ───────────────────────────────────────────────────────────────
+  hydrateFromGeneration(definition, meta) {
+    this._definition = definition;
+    this._mapResult = null;
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: `Generated for: "${this.prompt}"`,
+      encoded: Buffer.from(JSON.stringify(this._stripEmbeddings(definition))).toString("base64"),
+      delta: definition.steps.length
+    }));
+  }
+  hydrateFromPatch(definition, patchSummary, meta) {
+    const prevSteps = this._definition?.steps.length ?? 0;
+    this._definition = definition;
+    this._mapResult = null;
+    this._version++;
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: patchSummary,
+      encoded: Buffer.from(JSON.stringify(this._stripEmbeddings(definition))).toString("base64"),
+      delta: definition.steps.length - prevSteps
+    }));
+  }
+  hydrateFromMap(result) {
+    this._mapResult = result;
+  }
+  // ── Serialisation ──────────────────────────────────────────────────────────────
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      name: this.prompt,
+      description: `DynamicFeature with ${this._definition?.steps.length ?? 0} steps and ${this._history.length} patches`,
+      metadata: {
+        model: this._model,
+        context: this._context,
+        includeBases: this._includeBases,
+        excludeBases: this._excludeBases,
+        enabledComponents: this._enabledComponents,
+        createdAt: this.createdAt
+      },
+      history: this._history.map((p) => p.toJSON())
+    };
+  }
+  // ── Private helpers ──────────────────────────────────────────────────────────────
+  _stripEmbeddings(def) {
+    const strip = (el) => {
+      const { embedding, ...rest } = el;
+      return rest;
+    };
+    return {
+      ...def,
+      steps: def.steps.map(strip),
+      components: def.components.map(strip),
+      fragments: def.fragments.map(strip),
+      entities: def.entities.map(strip)
+    };
+  }
+};
+var A_FrameChannel = class extends A_Component {
+  async generate(prompt) {
+    const request = new A_FrameChannelRequest("POST", "/api/v1/completions", { prompt, max_tokens: 512 });
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.generate",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      return request;
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to generate completion: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async embed(input, options) {
+    const request = new A_FrameChannelRequest("POST", "/api/v1/embeddings", {
+      input,
+      ...options?.model && { model: options.model },
+      ...options?.task && { task: options.task }
+    });
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.embed",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      return request;
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to embed input: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async getCredentials() {
+    const request = new A_FrameChannelRequest("GET", "/api/v1/credentials/me");
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.getCredentials",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      return request;
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to get credentials: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async ping() {
+    const request = new A_FrameChannelRequest("GET", "/health");
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.ping",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      return request;
+    } catch {
+      executionScope.destroy();
+      return request;
+    }
+  }
+  async embedDefinition(definition, env) {
+    const request = new A_FrameChannelRequest("POST", "/api/v1/definition/embed", {
+      definition: definition.toJSON(),
+      model: definition.requestedModel
+    });
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.embedDefinition",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      const response = request.response;
+      if (!response.data || !response.data[0] || !response.data[0].embedding) {
+        throw new A_FrameChannelError({
+          title: A_FrameChannelError.InvalidRequest,
+          description: `Invalid embedding response for definition "${definition.name}"`
+        });
+      }
+      const vector = new Float32Array(response.data[0].embedding);
+      definition.hydrateFromEmbedding(vector, {
+        model: response.model,
+        dimensions: response.meta.dimensions,
+        inputCount: response.meta.input_count,
+        aFrameServerVersion: response.meta.server_version,
+        aFrameVersion: env.A_FRAME_VERSION,
+        credentialId: response.meta.credential_id,
+        date: response.date,
+        aFrameMeta: response.aFrameMeta
+      });
+    } catch (err) {
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to embed definition "${definition.name}": ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async embedNamespace(namespace, env) {
+    const request = new A_FrameChannelRequest("POST", "/api/v1/namespace/embed", {
+      namespace: namespace.toJSON(),
+      model: namespace.requestedModel
+    });
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.embedNamespace",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      const response = request.response;
+      if (!response.data || !response.data[0] || !response.data[0].embedding) {
+        throw new A_FrameChannelError({
+          title: A_FrameChannelError.InvalidRequest,
+          description: `Invalid embedding response for namespace "${namespace.name}"`
+        });
+      }
+      const vector = new Float32Array(response.data[0].embedding);
+      namespace.hydrateFromEmbedding(vector, {
+        model: response.model,
+        dimensions: response.meta.dimensions,
+        inputCount: response.meta.input_count,
+        aFrameServerVersion: response.meta.server_version,
+        aFrameVersion: env.A_FRAME_VERSION,
+        credentialId: response.meta.credential_id,
+        date: response.date
+      });
+    } catch (err) {
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to embed namespace "${namespace.name}": ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async embedSegment(segment, env) {
+    const request = new A_FrameChannelRequest("POST", "/api/v1/segment/embed", {
+      segment: segment.toJSON(),
+      task: segment.options?.task,
+      model: segment.options?.model
+    });
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.embedNamespace",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      const response = request.response;
+      if (!response.data || !response.data[0] || !response.data[0].embedding) {
+        throw new A_FrameChannelError({
+          title: A_FrameChannelError.InvalidRequest,
+          description: `Error during embed a segment: ${segment.content}`
+        });
+      }
+      const vector = new Float32Array(response.data[0].embedding);
+      segment.fromJSON({
+        aseid: segment.aseid.toString(),
+        content: segment.content,
+        hash: segment.hash,
+        embedding: vector,
+        model: response.model,
+        // dimensions: response.meta.dimensions,
+        // inputCount: response.meta.input_count,
+        aFrameServerVersion: response.meta.server_version,
+        aFrameVersion: env.A_FRAME_VERSION,
+        credentialId: response.meta.credential_id,
+        embeddedAt: response.date
+      });
+    } catch (err) {
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to embed segment with content "${segment.content}": ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async generateDynamicStructure(structure, operation) {
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/structure/generate",
+      {
+        prompt: structure.prompt,
+        model: structure.modelName,
+        context: structure.contextHint,
+        metaHint: structure.metaHintValue,
+        includeBases: structure.includedBases,
+        excludeBases: structure.excludedBases,
+        enabledComponents: structure.enabledComponentsList
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.generateDynamicStructure",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    structure.hydrateFromGeneration(resp.definition, {
+      model: resp.model,
+      serverVersion: resp.meta?.server_version ?? "0.0.0"
+    });
+  }
+  async patchDynamicStructure(structure, operation) {
+    const { instruction } = operation.params;
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/structure/patch",
+      {
+        originalPrompt: structure.prompt,
+        definition: this._stripStructureEmbeddings(structure.definition ?? { containers: [], components: [], fragments: [], entities: [] }),
+        patchInstruction: instruction,
+        model: structure.modelName,
+        context: structure.contextHint,
+        metaHint: structure.metaHintValue,
+        includeBases: structure.includedBases,
+        excludeBases: structure.excludedBases,
+        enabledComponents: structure.enabledComponentsList
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.patchDynamicStructure",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    structure.hydrateFromPatch(resp.definition, resp.patchSummary, {
+      model: resp.model,
+      serverVersion: resp.meta?.server_version ?? "0.0.0"
+    });
+  }
+  // ─── Structure helpers ─────────────────────────────────────────────────────
+  /**
+   * Strip embedding arrays and any client-side match fields from a definition
+   * before sending it to the server (the server does not need embeddings back).
+   */
+  _stripStructureEmbeddings(def) {
+    const strip = (el) => {
+      const { embedding, ...rest } = el;
+      return rest;
+    };
+    return {
+      containers: def.containers.map((c) => ({
+        ...strip(c),
+        components: (c.components ?? []).map(strip),
+        fragments: (c.fragments ?? []).map(strip),
+        entities: (c.entities ?? []).map(strip)
+      })),
+      components: def.components.map(strip),
+      fragments: def.fragments.map(strip),
+      entities: def.entities.map(strip)
+    };
+  }
+  async generateDynamicFeature(feature, operation) {
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/feature/generate",
+      {
+        prompt: feature.prompt,
+        model: feature.modelName,
+        context: feature.contextHint
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.generateDynamicFeature",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    feature.hydrateFromGeneration(resp.definition, {
+      model: resp.model,
+      serverVersion: resp.meta?.server_version ?? "0.0.0"
+    });
+  }
+  async patchDynamicFeature(feature, operation) {
+    const { instruction } = operation.params;
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/feature/patch",
+      {
+        originalPrompt: feature.prompt,
+        definition: this._stripFeatureEmbeddings(
+          feature.definition ?? {
+            title: "",
+            description: "",
+            steps: [],
+            components: [],
+            fragments: [],
+            entities: []
+          }
+        ),
+        patchInstruction: instruction,
+        model: feature.modelName,
+        context: feature.contextHint
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.patchDynamicFeature",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    feature.hydrateFromPatch(resp.definition, resp.patchSummary, {
+      model: resp.model,
+      serverVersion: resp.meta?.server_version ?? "0.0.0"
+    });
+  }
+  _stripFeatureEmbeddings(def) {
+    const strip = (el) => {
+      const { embedding, ...rest } = el;
+      return rest;
+    };
+    return {
+      ...def,
+      steps: def.steps.map(strip),
+      components: def.components.map(strip),
+      fragments: def.fragments.map(strip),
+      entities: def.entities.map(strip)
+    };
+  }
+  async generateDynamicContent(content, operation) {
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/content/generate",
+      {
+        prompt: content.prompt,
+        model: content.modelName,
+        ...content.systemPrompt !== void 0 ? { system: content.systemPrompt } : {}
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.generateDynamicContent",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    const segments = (resp.segments ?? []).map((w) => {
+      const seg = new A_FrameSegment({ content: w.content, options: { task: "document" } });
+      if (w.embedding?.length) {
+        seg.hydrateFromEmbedding(new Float32Array(w.embedding));
+      }
+      return seg;
+    });
+    content.hydrateFromGeneration(segments, {
+      model: resp.model,
+      serverVersion: resp.meta?.server_version ?? "0.0.0"
+    });
+  }
+  async patchDynamicContent(content, operation) {
+    const { instruction, segments } = operation.params;
+    const wireIdToAseid = /* @__PURE__ */ new Map();
+    const wireSegments = segments.map((s, idx) => {
+      const wireId = `s${idx}`;
+      wireIdToAseid.set(wireId, String(s.id));
+      return {
+        id: wireId,
+        index: idx,
+        text: s.content,
+        vector: s.vector ? Array.from(s.vector.values) : void 0
+      };
+    });
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/content/patch",
+      {
+        prompt: content.prompt,
+        segments: wireSegments,
+        instruction,
+        model: content.modelName,
+        ...content.systemPrompt !== void 0 ? { system: content.systemPrompt } : {}
+      }
+    );
+    const requestScope = new A_Scope({
+      name: "A_FrameChannel.patchDynamicContent",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    await this.call(A_FrameFeatures.Request, requestScope);
+    requestScope.destroy();
+    const resp = request.response;
+    const translatedOperations = resp.operations.map((op) => ({
+      ...op,
+      targetId: op.targetId ? wireIdToAseid.get(op.targetId) ?? op.targetId : op.targetId
+    }));
+    content.hydrateFromPatch(
+      { ...resp, operations: translatedOperations },
+      {
+        model: resp.model,
+        serverVersion: resp.meta?.server_version ?? "0.0.0"
+      }
+    );
+  }
+  async generateCompletion(completion, env) {
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/completions/generate",
+      {
+        prompt: completion.prompt,
+        options: completion.options
+      }
+    );
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.generateCompletion",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      const response = request.response;
+      if (!response.text) {
+        throw new A_FrameChannelError({
+          title: A_FrameChannelError.InvalidRequest,
+          description: `Invalid completion response for prompt "${completion.prompt}"`
+        });
+      }
+      completion.hydrateFromGeneration({
+        text: response.text,
+        embedding: new Float32Array(response.embedding),
+        model: response.model,
+        date: response.date,
+        aFrameVersion: env.A_FRAME_VERSION,
+        aFrameServerVersion: response.meta.server_version
+      });
+    } catch (err) {
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to generate completion for prompt "${completion.prompt}": ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async extractSchema(scheme, env) {
+    const request = new A_FrameChannelRequest(
+      "POST",
+      "/api/v1/schema/extract",
+      {
+        prompt: scheme.prompt,
+        schema: scheme.schema,
+        options: scheme.options
+      }
+    );
+    const executionScope = new A_Scope({
+      name: "A_FrameChannel.extractSchema",
+      fragments: [request]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameFeatures.Request, executionScope);
+      executionScope.destroy();
+      const response = request.response;
+      if (!response.data) {
+        throw new A_FrameChannelError({
+          title: A_FrameChannelError.InvalidRequest,
+          description: `Invalid scheme extraction response for prompt "${scheme.prompt}"`
+        });
+      }
+      scheme.hydrateFromExtraction(response.data, {
+        model: response.model,
+        date: response.date,
+        aFrameVersion: env.A_FRAME_VERSION,
+        aFrameServerVersion: response.meta.server_version
+      });
+    } catch (err) {
+      throw new A_FrameChannelError({
+        title: A_FrameChannelError.RequestFailed,
+        description: `Failed to extract scheme for prompt "${scheme.prompt}": ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+};
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDefinitionFeatures.Embed,
+    scope: [A_FrameDefinition]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameEnv))
+], A_FrameChannel.prototype, "embedDefinition", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameNamespaceFeatures.Embed,
+    scope: [A_FrameNamespace]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameEnv))
+], A_FrameChannel.prototype, "embedNamespace", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameSegmentFeatures.Embed,
+    scope: [A_FrameSegment]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameEnv))
+], A_FrameChannel.prototype, "embedSegment", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicStructureFeatures.Generate,
+    scope: [A_FrameDynamicStructure]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicStructureOperation))
+], A_FrameChannel.prototype, "generateDynamicStructure", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicStructureFeatures.Patch,
+    scope: [A_FrameDynamicStructure]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicStructureOperation))
+], A_FrameChannel.prototype, "patchDynamicStructure", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicFeatureFeatures.Generate,
+    scope: [A_FrameDynamicFeature]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicFeatureOperation))
+], A_FrameChannel.prototype, "generateDynamicFeature", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicFeatureFeatures.Patch,
+    scope: [A_FrameDynamicFeature]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicFeatureOperation))
+], A_FrameChannel.prototype, "patchDynamicFeature", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicContentFeatures.Generate,
+    scope: [A_FrameDynamicContent]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicContentOperation))
+], A_FrameChannel.prototype, "generateDynamicContent", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicContentFeatures.Patch,
+    scope: [A_FrameDynamicContent]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameDynamicContentOperation))
+], A_FrameChannel.prototype, "patchDynamicContent", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameCompletionFeatures.Generate,
+    scope: [A_FrameCompletion]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameEnv))
+], A_FrameChannel.prototype, "generateCompletion", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameSchemaFeatures.Extract,
+    scope: [A_FrameSchema]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameEnv))
+], A_FrameChannel.prototype, "extractSchema", 1);
+
+export { A_FrameChannel, A_FrameChannelError, A_FrameChannelRequest, A_FrameChannelSocketFeatures, A_FrameChannelSocketStatuses, A_FrameChannelStreamFeatures, A_FrameChannelStreamStatuses, A_FrameComponentMapIndex, A_FrameDynamicFeature, A_FrameDynamicFeatureError, A_FrameDynamicFeatureFeatures, A_FrameDynamicFeatureOperation, A_FrameDynamicStructure, A_FrameDynamicStructureError, A_FrameDynamicStructureEvents, A_FrameDynamicStructureFeatures, A_FrameFeatures, A_FrameMethodMapIndex };
+//# sourceMappingURL=chunk-KFW4GE7H.mjs.map
+//# sourceMappingURL=chunk-KFW4GE7H.mjs.map