@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-CV5FPKU6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../package.json"],"names":[],"mappings":";AAEE,IAAA,OAAA,GAAW","file":"chunk-CV5FPKU6.mjs","sourcesContent":["{\n  \"name\": \"@adaas/a-frame\",\n  \"version\": \"0.1.1\",\n  \"description\": \"A-frame is index build engine for A-Concept ecosystem. It provides a way to build index structures for A-Concept basics\",\n  \"license\": \"Apache-2.0\",\n  \"author\": {\n    \"name\": \"ADAAS YAZILIM LİMİTED ŞİRKETİ\",\n    \"email\": \"contact-us@adaas.org\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/ADAAS-org/adaas-a-frame/issues\"\n  },\n  \"homepage\": \"https://github.com/ADAAS-org/adaas-a-frame#readme\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/ADAAS-org/adaas-a-frame.git\"\n  },\n  \"bin\": {\n    \"a-frame\": \"./dist/index.cjs\"\n  },\n  \"exports\": {\n    \".\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/index.d.mts\",\n        \"import\": \"./dist/browser/index.mjs\"\n      },\n      \"types\": \"./dist/node/index.d.ts\",\n      \"import\": \"./dist/node/index.mjs\",\n      \"require\": \"./dist/node/index.cjs\"\n    },\n    \"./core\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/core.d.mts\",\n        \"import\": \"./dist/browser/core.mjs\"\n      },\n      \"types\": \"./dist/node/core.d.ts\",\n      \"import\": \"./dist/node/core.mjs\",\n      \"require\": \"./dist/node/core.cjs\"\n    },\n    \"./bundle\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/bundle.d.mts\",\n        \"import\": \"./dist/browser/bundle.mjs\"\n      },\n      \"types\": \"./dist/node/bundle.d.ts\",\n      \"import\": \"./dist/node/bundle.mjs\",\n      \"require\": \"./dist/node/bundle.cjs\"\n    },\n    \"./channel\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/channel.d.mts\",\n        \"import\": \"./dist/browser/channel.mjs\"\n      },\n      \"types\": \"./dist/node/channel.d.ts\",\n      \"import\": \"./dist/node/channel.mjs\",\n      \"require\": \"./dist/node/channel.cjs\"\n    },\n    \"./credentials\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/credentials.d.mts\",\n        \"import\": \"./dist/browser/credentials.mjs\"\n      },\n      \"types\": \"./dist/node/credentials.d.ts\",\n      \"import\": \"./dist/node/credentials.mjs\",\n      \"require\": \"./dist/node/credentials.cjs\"\n    },\n    \"./crypto\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/crypto.d.mts\",\n        \"import\": \"./dist/browser/crypto.mjs\"\n      },\n      \"types\": \"./dist/node/crypto.d.ts\",\n      \"import\": \"./dist/node/crypto.mjs\",\n      \"require\": \"./dist/node/crypto.cjs\"\n    },\n    \"./definition\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/definition.d.mts\",\n        \"import\": \"./dist/browser/definition.mjs\"\n      },\n      \"types\": \"./dist/node/definition.d.ts\",\n      \"import\": \"./dist/node/definition.mjs\",\n      \"require\": \"./dist/node/definition.cjs\"\n    },\n    \"./dynamic-feature\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-feature.d.mts\",\n        \"import\": \"./dist/browser/dynamic-feature.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-feature.d.ts\",\n      \"import\": \"./dist/node/dynamic-feature.mjs\",\n      \"require\": \"./dist/node/dynamic-feature.cjs\"\n    },\n    \"./dynamic-content\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-content.d.mts\",\n        \"import\": \"./dist/browser/dynamic-content.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-content.d.ts\",\n      \"import\": \"./dist/node/dynamic-content.mjs\",\n      \"require\": \"./dist/node/dynamic-content.cjs\"\n    },\n    \"./dynamic-structure\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-structure.d.mts\",\n        \"import\": \"./dist/browser/dynamic-structure.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-structure.d.ts\",\n      \"import\": \"./dist/node/dynamic-structure.mjs\",\n      \"require\": \"./dist/node/dynamic-structure.cjs\"\n    },\n    \"./env\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/env.d.mts\",\n        \"import\": \"./dist/browser/env.mjs\"\n      },\n      \"types\": \"./dist/node/env.d.ts\",\n      \"import\": \"./dist/node/env.mjs\",\n      \"require\": \"./dist/node/env.cjs\"\n    },\n    \"./index\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/frame-index.d.mts\",\n        \"import\": \"./dist/browser/frame-index.mjs\"\n      },\n      \"types\": \"./dist/node/frame-index.d.ts\",\n      \"import\": \"./dist/node/frame-index.mjs\",\n      \"require\": \"./dist/node/frame-index.cjs\"\n    },\n    \"./logger\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/logger.d.mts\",\n        \"import\": \"./dist/browser/logger.mjs\"\n      },\n      \"types\": \"./dist/node/logger.d.ts\",\n      \"import\": \"./dist/node/logger.mjs\",\n      \"require\": \"./dist/node/logger.cjs\"\n    },\n    \"./namespace\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/namespace.d.mts\",\n        \"import\": \"./dist/browser/namespace.mjs\"\n      },\n      \"types\": \"./dist/node/namespace.d.ts\",\n      \"import\": \"./dist/node/namespace.mjs\",\n      \"require\": \"./dist/node/namespace.cjs\"\n    },\n    \"./completion\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/completion.d.mts\",\n        \"import\": \"./dist/browser/completion.mjs\"\n      },\n      \"types\": \"./dist/node/completion.d.ts\",\n      \"import\": \"./dist/node/completion.mjs\",\n      \"require\": \"./dist/node/completion.cjs\"\n    },\n    \"./segment\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/segment.d.mts\",\n        \"import\": \"./dist/browser/segment.mjs\"\n      },\n      \"types\": \"./dist/node/segment.d.ts\",\n      \"import\": \"./dist/node/segment.mjs\",\n      \"require\": \"./dist/node/segment.cjs\"\n    },\n    \"./storage\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/storage.d.mts\",\n        \"import\": \"./dist/browser/storage.mjs\"\n      },\n      \"types\": \"./dist/node/storage.d.ts\",\n      \"import\": \"./dist/node/storage.mjs\",\n      \"require\": \"./dist/node/storage.cjs\"\n    },\n    \"./vector\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/vector.d.mts\",\n        \"import\": \"./dist/browser/vector.mjs\"\n      },\n      \"types\": \"./dist/node/vector.d.ts\",\n      \"import\": \"./dist/node/vector.mjs\",\n      \"require\": \"./dist/node/vector.cjs\"\n    },\n    \"./models\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/models.d.mts\",\n        \"import\": \"./dist/browser/models.mjs\"\n      },\n      \"types\": \"./dist/node/models.d.ts\",\n      \"import\": \"./dist/node/models.mjs\",\n      \"require\": \"./dist/node/models.cjs\"\n    },\n    \"./schema\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/schema.d.mts\",\n        \"import\": \"./dist/browser/schema.mjs\"\n      },\n      \"types\": \"./dist/node/schema.d.ts\",\n      \"import\": \"./dist/node/schema.mjs\",\n      \"require\": \"./dist/node/schema.cjs\"\n    }\n  },\n  \"keywords\": [\n    \"adaas\",\n    \"a-frame\",\n    \"ai index\",\n    \"embeddings\",\n    \"a-concept\",\n    \"rag\"\n  ],\n  \"sideEffects\": false,\n  \"nodemonConfig\": {\n    \"ignore\": [\n      \"**/*.test.ts\",\n      \"**/*.spec.ts\",\n      \".git\",\n      \"node_modules\"\n    ],\n    \"watch\": [\n      \"src\",\n      \"examples\"\n    ],\n    \"exec\": \"node -r tsconfig-paths/register -r ts-node/register \",\n    \"ext\": \"ts, js\"\n  },\n  \"scripts\": {\n    \"test\": \"jest --detectOpenHandles\",\n    \"test:browser\": \"jest --config jest.config.browser.ts --detectOpenHandles\",\n    \"example:content-mapping\": \"node -r tsconfig-paths/register -r ts-node/register ./examples/content-mapping/run-incremental.ts\",\n    \"example:content-mapping-simple\": \"node -r tsconfig-paths/register -r ts-node/register ./examples/content-mapping/run.ts\",\n    \"example:content-mapping-example\": \"node -r tsconfig-paths/register -r ts-node/register ./examples/content-mapping-example.ts\",\n    \"example:article\": \"node -r tsconfig-paths/register -r ts-node/register ./examples/article/main.ts\",\n    \"example:interaction\": \"node -r tsconfig-paths/register -r ts-node/register ./examples/interaction/main.ts\",\n    \"example:dev:content-mapping\": \"nodemon ./examples/content-mapping/run-incremental.ts\",\n    \"example:dev:content-mapping-simple\": \"nodemon ./examples/content-mapping/run.ts\",\n    \"start\": \"nodemon ./tests/example-usage.ts\",\n    \"start:test\": \"node -r tsconfig-paths/register -r ts-node/register ./index.ts\",\n    \"release\": \"npm run test && npm run build && git add . && git commit -m \\\"new version created :: $(cat package.json | grep version | head -1  | awk -F: '{ print $2 }'  | sed 's/[\\\",]//g')\\\" && npm version patch && npm publish --access public\",\n    \"version\": \"echo git add .\",\n    \"postversion\": \"git push --no-verify && git push --tags --no-verify && echo \\\"\\n======Version Pushed Successfully=====\\n\\\" \",\n    \"echo-version\": \"echo $npm_package_version\",\n    \"build\": \"tsup --config tsup.config.ts\"\n  },\n  \"peerDependencies\": {\n    \"@adaas/a-concept\": \"^0.3.15\"\n  },\n  \"devDependencies\": {\n    \"@adaas/a-concept\": \"^0.3.15\",\n    \"@types/chai\": \"^4.3.14\",\n    \"@types/jest\": \"^29.5.12\",\n    \"@types/mocha\": \"^10.0.6\",\n    \"@types/node\": \"^24.9.1\",\n    \"chai\": \"^5.1.0\",\n    \"dotenv\": \"^16.6.1\",\n    \"jest\": \"^29.7.0\",\n    \"jest-environment-jsdom\": \"^29.7.0\",\n    \"mocha\": \"^10.4.0\",\n    \"nodemon\": \"^3.1.4\",\n    \"ts-jest\": \"^29.1.2\",\n    \"ts-node\": \"^10.9.2\",\n    \"tsconfig-paths\": \"^4.2.0\",\n    \"tscpaths\": \"^0.0.9\",\n    \"tsup\": \"^8.5.0\"\n  },\n  \"directories\": {\n    \"doc\": \"docs\",\n    \"test\": \"tests\"\n  }\n}\n"]}

package/dist/node/chunk-CZYOAFIR.mjs

@@ -0,0 +1,129 @@
+import { A_FrameIndex } from './chunk-OMGYXCFM.mjs';
+import { A_FrameDynamicFeature, A_FrameDynamicFeatureFeatures, A_FrameMethodMapIndex, A_FrameChannel, A_FrameChannelRequest, A_FrameFeatures, A_FrameDynamicFeatureError } from './chunk-KFW4GE7H.mjs';
+import { A_FrameVector } from './chunk-IAL2NK2V.mjs';
+import { __decorateClass, __decorateParam } from './chunk-OI76LHVT.mjs';
+import { A_Feature, A_Inject, A_Caller, A_Component, A_Scope, A_Context } from '@adaas/a-concept';
+
+var A_FrameMethodMapper = class extends A_Component {
+  async mapFeature(feature, mapIndex, frameIndex, channel) {
+    const def = feature.definition;
+    if (!def) return;
+    const tryMatchStep = (step, minScore) => {
+      if (!step.embedding?.length) {
+        return { matchedClass: null, matchedMethod: null, matchScore: 0 };
+      }
+      const results = frameIndex.search(new A_FrameVector(step.embedding), { topK: 1 });
+      const top = results[0];
+      if (top && top.score >= minScore) {
+        const matchedClass = top.record.dependency.name;
+        const matchedMethod = top.record.name;
+        return { matchedClass, matchedMethod, matchScore: top.score };
+      }
+      return { matchedClass: null, matchedMethod: null, matchScore: top?.score ?? 0 };
+    };
+    const tryMatchElement = (el, minScore) => {
+      if (!el.embedding?.length) {
+        return { matchedClass: null, matchScore: 0 };
+      }
+      const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1 });
+      const top = results[0];
+      if (top && top.score >= minScore) {
+        return { matchedClass: top.record.name, matchScore: top.score };
+      }
+      return { matchedClass: null, matchScore: top?.score ?? 0 };
+    };
+    const stripEmbeddings = (d) => {
+      const strip = (el) => {
+        const { embedding, ...rest } = el;
+        return rest;
+      };
+      return {
+        ...d,
+        steps: d.steps.map(strip),
+        components: d.components.map(strip),
+        fragments: d.fragments.map(strip),
+        entities: d.entities.map(strip)
+      };
+    };
+    const matchAll = (d) => {
+      mapIndex.clear();
+      for (const step of d.steps) {
+        mapIndex.setStep({
+          prompt: step.prompt,
+          inputs: step.inputs,
+          outputs: step.outputs,
+          ...tryMatchStep(step, feature.minScore)
+        });
+      }
+      for (const el of d.components) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+      for (const el of d.fragments) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+      for (const el of d.entities) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+    };
+    let workingDef = def;
+    matchAll(workingDef);
+    for (let retry = 0; retry < feature.maxRetries; retry++) {
+      const unmatchedSteps = workingDef.steps.filter(
+        (step) => step.embedding?.length && mapIndex.getStep(step.prompt)?.matchedMethod === null
+      );
+      if (unmatchedSteps.length === 0) break;
+      const refinementInstruction = [
+        `The following workflow steps could not be matched to any registered method.`,
+        `Please re-describe each step with more specific, method-oriented language:`,
+        unmatchedSteps.map((s) => `- "${s.prompt}"`).join("\n")
+      ].join("\n");
+      const patchReq = new A_FrameChannelRequest(
+        "POST",
+        "/api/v1/feature/patch",
+        {
+          originalPrompt: feature.prompt,
+          definition: stripEmbeddings(workingDef),
+          patchInstruction: refinementInstruction,
+          model: feature.modelName,
+          context: feature.contextHint
+        }
+      );
+      const patchScope = new A_Scope({
+        name: `A_FrameMethodMapper.mapFeature:retry${retry}`,
+        fragments: [patchReq]
+      }).inherit(A_Context.scope(channel));
+      await channel.call(A_FrameFeatures.Request, patchScope);
+      patchScope.destroy();
+      if (!patchReq.response) break;
+      workingDef = patchReq.response.definition;
+      matchAll(workingDef);
+    }
+    for (const step of workingDef.steps) {
+      const entry = mapIndex.getStep(step.prompt);
+      if (entry && entry.matchedMethod === null && step.embedding?.length) {
+        mapIndex.setStep({
+          ...entry,
+          matchError: {
+            title: A_FrameDynamicFeatureError.MethodNotFound,
+            description: `Unable to match "${step.prompt}" to any registered method after ${feature.maxRetries} retries.`
+          }
+        });
+      }
+    }
+    feature.hydrateFromMap(mapIndex.toResult(workingDef));
+  }
+};
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicFeatureFeatures.Map,
+    scope: [A_FrameDynamicFeature]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameMethodMapIndex)),
+  __decorateParam(2, A_Inject(A_FrameIndex)),
+  __decorateParam(3, A_Inject(A_FrameChannel))
+], A_FrameMethodMapper.prototype, "mapFeature", 1);
+
+export { A_FrameMethodMapper };
+//# sourceMappingURL=chunk-CZYOAFIR.mjs.map
+//# sourceMappingURL=chunk-CZYOAFIR.mjs.map

package/dist/node/chunk-CZYOAFIR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":[],"mappings":"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","file":"chunk-CZYOAFIR.mjs","sourcesContent":["import { A_Caller, A_Component, A_Context, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameChannel } from \"../A-FrameChannel/A-FrameChannel.component\";\nimport { A_FrameFeatures } from \"../A-FrameChannel/A-FrameChannel.constants\";\nimport { A_FrameChannelRequest } from \"../A-FrameChannel/A-FrameChannelRequest.context\";\nimport { A_FrameIndex } from \"../A-FrameIndex/A-FrameIndex.context\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameDynamicFeature } from \"./A-FrameDynamicFeature.entity\";\nimport { A_FrameDynamicFeatureFeatures } from \"./A-FrameDynamicFeature.constants\";\nimport { A_FrameDynamicFeatureError } from \"./A-FrameDynamicFeature.error\";\nimport {\n    A_FrameDynamicFeatureDefinition,\n    A_FrameDynamicFeatureElementMapEntry,\n    A_FrameDynamicFeatureStep,\n    A_FrameDynamicFeatureStepMapEntry,\n    A_FrameFeaturePatchResponse,\n} from \"./A-FrameDynamicFeature.types\";\nimport { A_FrameMethodMapIndex } from \"./A-FrameMethodMapIndex.context\";\n\n\n/**\n * Stateless component that implements the `Map` feature for\n * `A_FrameDynamicFeature`.\n *\n * Algorithm:\n *  1. Read `feature.definition` (includes server-computed embeddings on steps\n *     and supporting elements).\n *  2. Run cosine-similarity search against `A_FrameIndex` for every step and\n *     every supporting element.\n *  3. For steps that remain unmatched, issue a server patch to refine their\n *     descriptions (up to `feature.maxRetries` times), then re-match.\n *  4. Mark any still-unmatched steps with a `matchError`.\n *  5. Hydrate the feature with `mapIndex.toResult(def)`.\n */\nexport class A_FrameMethodMapper extends A_Component {\n\n    @A_Feature.Extend({\n        name: A_FrameDynamicFeatureFeatures.Map,\n        scope: [A_FrameDynamicFeature],\n    })\n    async mapFeature(\n        @A_Inject(A_Caller) feature: A_FrameDynamicFeature,\n        @A_Inject(A_FrameMethodMapIndex) mapIndex: A_FrameMethodMapIndex,\n        @A_Inject(A_FrameIndex) frameIndex: A_FrameIndex,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n    ): Promise<void> {\n\n        const def = feature.definition;\n        if (!def) return;\n\n        // ── helpers ──────────────────────────────────────────────────────────\n\n        const tryMatchStep = (\n            step: A_FrameDynamicFeatureStep,\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureStepMapEntry, 'matchedClass' | 'matchedMethod' | 'matchScore'> => {\n            if (!step.embedding?.length) {\n                return { matchedClass: null, matchedMethod: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(step.embedding), { topK: 1 });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                // Method definitions store name = \"methodName\" and dependency.name = \"ClassName\".\n                // Class definitions store both name and dependency.name as the class name.\n                const matchedClass = top.record.dependency.name;\n                const matchedMethod = top.record.name;\n                return { matchedClass, matchedMethod, matchScore: top.score };\n            }\n            return { matchedClass: null, matchedMethod: null, matchScore: top?.score ?? 0 };\n        };\n\n        const tryMatchElement = (\n            el: { prompt: string; class?: string; embedding?: number[] },\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureElementMapEntry, 'matchedClass' | 'matchScore'> => {\n            if (!el.embedding?.length) {\n                return { matchedClass: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1 });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                return { matchedClass: top.record.name, matchScore: top.score };\n            }\n            return { matchedClass: null, matchScore: top?.score ?? 0 };\n        };\n\n        const stripEmbeddings = (d: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureDefinition => {\n            const strip = (el: any): any => { const { embedding, ...rest } = el; return rest; };\n            return {\n                ...d,\n                steps:      d.steps.map(strip),\n                components: d.components.map(strip),\n                fragments:  d.fragments.map(strip),\n                entities:   d.entities.map(strip),\n            };\n        };\n\n        const matchAll = (d: A_FrameDynamicFeatureDefinition): void => {\n            mapIndex.clear();\n            for (const step of d.steps) {\n                mapIndex.setStep({\n                    prompt:  step.prompt,\n                    inputs:  step.inputs,\n                    outputs: step.outputs,\n                    ...tryMatchStep(step, feature.minScore),\n                });\n            }\n            for (const el of d.components) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.fragments) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.entities) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n        };\n\n        // ── initial matching pass ─────────────────────────────────────────────\n\n        let workingDef = def;\n        matchAll(workingDef);\n\n        // ── retry loop: refine unmatched steps via server patch ───────────────\n\n        for (let retry = 0; retry < feature.maxRetries; retry++) {\n            const unmatchedSteps = workingDef.steps.filter(\n                step => step.embedding?.length && mapIndex.getStep(step.prompt)?.matchedMethod === null,\n            );\n            if (unmatchedSteps.length === 0) break;\n\n            const refinementInstruction = [\n                `The following workflow steps could not be matched to any registered method.`,\n                `Please re-describe each step with more specific, method-oriented language:`,\n                unmatchedSteps.map(s => `- \"${s.prompt}\"`).join('\\n'),\n            ].join('\\n');\n\n            const patchReq = new A_FrameChannelRequest<A_FrameFeaturePatchResponse>(\n                'POST',\n                '/api/v1/feature/patch',\n                {\n                    originalPrompt:    feature.prompt,\n                    definition:        stripEmbeddings(workingDef),\n                    patchInstruction:  refinementInstruction,\n                    model:             feature.modelName,\n                    context:           feature.contextHint,\n                },\n            );\n\n            const patchScope = new A_Scope({\n                name: `A_FrameMethodMapper.mapFeature:retry${retry}`,\n                fragments: [patchReq],\n            }).inherit(A_Context.scope(channel));\n\n            await channel.call(A_FrameFeatures.Request, patchScope);\n            patchScope.destroy();\n\n            if (!patchReq.response) break;\n\n            workingDef = patchReq.response.definition;\n            matchAll(workingDef);\n        }\n\n        // ── finalize: mark remaining unmatched steps with an error ────────────\n\n        for (const step of workingDef.steps) {\n            const entry = mapIndex.getStep(step.prompt);\n            if (entry && entry.matchedMethod === null && step.embedding?.length) {\n                mapIndex.setStep({\n                    ...entry,\n                    matchError: {\n                        title: A_FrameDynamicFeatureError.MethodNotFound,\n                        description: `Unable to match \"${step.prompt}\" to any registered method after ${feature.maxRetries} retries.`,\n                    },\n                });\n            }\n        }\n\n        // ── hydrate the feature with the map result ───────────────────────────\n\n        feature.hydrateFromMap(mapIndex.toResult(workingDef));\n    }\n}\n"]}

package/dist/node/chunk-D2HTYEJZ.cjs

@@ -0,0 +1,209 @@
+'use strict';
+
+var chunk7SEZMRLI_cjs = require('./chunk-7SEZMRLI.cjs');
+var aConcept = require('@adaas/a-concept');
+
+var A_FrameIndex = class _A_FrameIndex extends aConcept.A_Fragment {
+  constructor() {
+    if (_A_FrameIndex._instance)
+      return _A_FrameIndex._instance;
+    super({ name: "A_FrameIndex" });
+    // -------------------------------------------------------------------------------------
+    // ------------------------------ Instance State --------------------------------------
+    // -------------------------------------------------------------------------------------
+    this.definitions = /* @__PURE__ */ new Map();
+    this.namespaces = /* @__PURE__ */ new Map();
+    this.scope = new aConcept.A_Scope({ name: "A_FrameIndexScope" });
+  }
+  static get instance() {
+    if (!_A_FrameIndex._instance) {
+      _A_FrameIndex._instance = new _A_FrameIndex();
+    }
+    return _A_FrameIndex._instance;
+  }
+  static get indexSize() {
+    return _A_FrameIndex.instance.indexSize;
+  }
+  // ------------------------------------------------------------------------------------
+  // --------------------Static Access to Instance Methods-------------------------------
+  // ------------------------------------------------------------------------------------
+  static inherit(scope) {
+    _A_FrameIndex.instance.inherit(scope);
+  }
+  static addDefinition(def) {
+    _A_FrameIndex.instance.addDefinition(def);
+  }
+  static getDefinition(nameOrHash) {
+    return _A_FrameIndex.instance.getDefinition(nameOrHash);
+  }
+  static listDefinitions(filter) {
+    return _A_FrameIndex.instance.listDefinitions(filter);
+  }
+  static removeDefinition(def) {
+    _A_FrameIndex.instance.removeDefinition(def);
+  }
+  static addNamespace(namespace) {
+    _A_FrameIndex.instance.addNamespace(namespace);
+  }
+  static getDefaultNamespace() {
+    return _A_FrameIndex.instance.getDefaultNamespace();
+  }
+  static getNamespace(nameOrASEID) {
+    return _A_FrameIndex.instance.getNamespace(nameOrASEID);
+  }
+  static listNamespaces() {
+    return _A_FrameIndex.instance.listNamespaces();
+  }
+  static removeNamespace(namespace) {
+    _A_FrameIndex.instance.removeNamespace(namespace);
+  }
+  static search(vector, options = {}) {
+    return _A_FrameIndex.instance.search(vector, options);
+  }
+  /** Number of loaded records */
+  get indexSize() {
+    return this.definitions.size;
+  }
+  // static searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     return A_FrameIndex.instance.searchByText(query, channel, options);
+  // }
+  // ------------------------------------------------------------------------------------
+  // ------------------------------ Instance Methods ------------------------------------
+  // ------------------------------------------------------------------------------------
+  inherit(scope) {
+    this.scope.inherit(scope);
+  }
+  addDefinition(def) {
+    this.scope.register(def);
+    const existingNamespace = this.namespaces.get(def.namespace.id);
+    if (!existingNamespace) {
+      this.addNamespace(def.namespace);
+    }
+    this.definitions.set(def.id, def);
+  }
+  getDefinition(name) {
+    for (const def of this.definitions.values()) {
+      if (def.name === name) {
+        return def;
+      }
+    }
+    return void 0;
+  }
+  listDefinitions(filter = {}) {
+    const namespaceName = filter.namespace ? typeof filter.namespace === "string" ? aConcept.ASEID.isASEID(filter.namespace) ? new aConcept.ASEID(filter.namespace).id : filter.namespace : filter.namespace.id : void 0;
+    return [...this.definitions.values()].filter((r) => !namespaceName || r.namespace.name === namespaceName);
+  }
+  removeDefinition(def) {
+    this.scope.deregister(def);
+  }
+  addNamespace(namespace) {
+    this.scope.register(namespace);
+    this.namespaces.set(namespace.id, namespace);
+  }
+  getNamespace(nameOrASEID) {
+    const targetKey = typeof nameOrASEID === "string" ? aConcept.ASEID.isASEID(nameOrASEID) ? new aConcept.ASEID(nameOrASEID).id : nameOrASEID : nameOrASEID.id;
+    return this.namespaces.get(targetKey);
+  }
+  getDefaultNamespace() {
+    let defaultNamespace = this.getNamespace(chunk7SEZMRLI_cjs.A_FRAME_DEFAULT_NAMESPACE_KEY);
+    if (!defaultNamespace) {
+      defaultNamespace = new chunk7SEZMRLI_cjs.A_FrameNamespace({
+        name: chunk7SEZMRLI_cjs.A_FRAME_DEFAULT_NAMESPACE_KEY
+      });
+      this.addNamespace(defaultNamespace);
+    }
+    return defaultNamespace;
+  }
+  listNamespaces() {
+    return [...this.namespaces.values()];
+  }
+  removeNamespace(namespace) {
+    this.scope.deregister(namespace);
+    this.namespaces.delete(namespace.id);
+  }
+  /**
+   * Search by a pre-computed embedding vector (cosine similarity).
+   */
+  search(vector, options = {}) {
+    const { topK = 10, namespace, minScore = 0 } = options;
+    const pool = namespace ? [...this.definitions.values()].filter((r) => r.namespace.id === namespace) : [...this.definitions.values()];
+    const scored = pool.map((r) => ({
+      record: r,
+      score: this.cosineSimilarity(vector, r.vector)
+    }));
+    return scored.filter((s) => s.score >= minScore).sort((a, b) => b.score - a.score).slice(0, topK).map(({ record: r, score }) => ({
+      record: r,
+      score
+    }));
+  }
+  // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {
+  //     const a = vectorA.values ?? new Float32Array();
+  //     const b = vectorB?.values ?? new Float32Array();
+  //     if (a.length !== b.length) {
+  //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);
+  //     }
+  //     let dot = 0, normA = 0, normB = 0;
+  //     for (let i = 0; i < a.length; i++) {
+  //         dot += a[i] * b[i];
+  //         normA += a[i] * a[i];
+  //         normB += b[i] * b[i];
+  //     }
+  //     const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  //     return denom === 0 ? 0 : dot / denom;
+  // }
+  cosineSimilarity(a, b) {
+    if (!b) return 0;
+    const dot = a.dot(b);
+    const mag = a.magnitude() * b.magnitude();
+    return mag === 0 ? 0 : dot / mag;
+  }
+  euclideanDistance(a, b) {
+    this.assertSameLength(a, b);
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+      const diff = a.values[i] - b.values[i];
+      sum += diff * diff;
+    }
+    return Math.sqrt(sum);
+  }
+  nearest(query, vectors, limit = 1) {
+    return [...vectors].map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score).slice(0, limit).map((r) => r.vector);
+  }
+  rank(query, vectors) {
+    return vectors.map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score);
+  }
+  assertSameLength(a, b) {
+    if (a.length !== b.length) {
+      throw new Error(
+        `Embedding dimension mismatch: ${a.length} vs ${b.length}`
+      );
+    }
+  }
+  /**
+   * Search by plain text — sends the query to the embed server via channel first.
+   */
+  // async searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     this.assertLoaded();
+  //     const resp = await channel.embed(query);
+  //     const queryEmbedding = new Float32Array(resp.data[0].embedding);
+  //     return this.search(queryEmbedding, options);
+  // }
+};
+
+exports.A_FrameIndex = A_FrameIndex;
+//# sourceMappingURL=chunk-D2HTYEJZ.cjs.map
+//# sourceMappingURL=chunk-D2HTYEJZ.cjs.map

package/dist/node/chunk-D2HTYEJZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameIndex/A-FrameIndex.context.ts"],"names":["A_Fragment","A_Scope","ASEID","A_FRAME_DEFAULT_NAMESPACE_KEY","A_FrameNamespace"],"mappings":"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","file":"chunk-D2HTYEJZ.cjs","sourcesContent":["import { A_Dependency, A_Fragment, A_Scope, ASEID } from \"@adaas/a-concept\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameNamespace } from \"../A-FrameNamespace/A-FrameNamespace.entity\";\nimport { A_FrameDefinition_SearchResult, A_FrameSearchOptions } from \"./A-FrameIndex.types\";\nimport { A_FrameDefinition } from \"../A-FrameDefinition\";\nimport { A_FRAME_DEFAULT_NAMESPACE_KEY } from \"../A-FrameNamespace/A-FrameNamespace.constants\";\n\n\n\nexport class A_FrameIndex extends A_Fragment {\n\n    private static _instance: A_FrameIndex;\n\n    static get instance(): A_FrameIndex {\n        if (!A_FrameIndex._instance) {\n            A_FrameIndex._instance = new A_FrameIndex();\n        }\n        return A_FrameIndex._instance;\n    }\n\n    static get indexSize(): number {\n        return A_FrameIndex.instance.indexSize;\n    }\n\n    // ------------------------------------------------------------------------------------\n    // --------------------Static Access to Instance Methods-------------------------------\n    // ------------------------------------------------------------------------------------\n    static inherit(scope: A_Scope) {\n        A_FrameIndex.instance.inherit(scope);\n    }\n    static addDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.addDefinition(def);\n    }\n    static getDefinition(nameOrHash: string): A_FrameDefinition | undefined {\n        return A_FrameIndex.instance.getDefinition(nameOrHash);\n    }\n    static listDefinitions(filter: {\n        namespace?: string | A_FrameNamespace\n    }): A_FrameDefinition[] {\n        return A_FrameIndex.instance.listDefinitions(filter);\n    }\n    static removeDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.removeDefinition(def);\n    }\n    static addNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.addNamespace(namespace);\n    }\n    static getDefaultNamespace(): A_FrameNamespace {\n        return A_FrameIndex.instance.getDefaultNamespace();\n    }\n    static getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        return A_FrameIndex.instance.getNamespace(nameOrASEID);\n    }\n    static listNamespaces(): A_FrameNamespace[] {\n        return A_FrameIndex.instance.listNamespaces();\n    }\n    static removeNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.removeNamespace(namespace);\n    }\n    static search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n        return A_FrameIndex.instance.search(vector, options);\n    }\n\n    // -------------------------------------------------------------------------------------\n    // ------------------------------ Instance State --------------------------------------\n    // -------------------------------------------------------------------------------------\n\n    private definitions: Map<string, A_FrameDefinition> = new Map();\n\n    private namespaces: Map<string, A_FrameNamespace> = new Map();\n\n    private _index!: {\n\n        namespaceToDefinitions: WeakMap<A_FrameNamespace, Set<A_FrameDefinition>>,\n\n        definitionToNamespace: WeakMap<A_FrameDefinition, A_FrameNamespace>,\n    };\n    /**\n     * Scope where all definitions and namespaces are registered as dependencies, allowing for lookup by ASEID or constructor reference.\n     */\n    private scope!: A_Scope\n\n\n    constructor() {\n        if (A_FrameIndex._instance)\n            return A_FrameIndex._instance;\n\n        super({ name: 'A_FrameIndex' });\n\n        this.scope = new A_Scope({ name: 'A_FrameIndexScope' });\n    }\n\n    /** Number of loaded records */\n    get indexSize(): number {\n        return this.definitions.size;\n    }\n\n\n    // static searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     return A_FrameIndex.instance.searchByText(query, channel, options);\n    // }\n\n\n    // ------------------------------------------------------------------------------------\n    // ------------------------------ Instance Methods ------------------------------------\n    // ------------------------------------------------------------------------------------\n    inherit(scope: A_Scope) {\n        this.scope.inherit(scope);\n    }\n\n    addDefinition(def: A_FrameDefinition): void {\n        this.scope.register(def);\n\n        const existingNamespace = this.namespaces.get(def.namespace.id);\n        if (!existingNamespace) {\n            this.addNamespace(def.namespace);\n        }\n\n        this.definitions.set(def.id, def);\n    }\n\n    getDefinition(name: string): A_FrameDefinition | undefined {\n        // Then try name lookup\n        for (const def of this.definitions.values()) {\n            if (def.name === name) {\n                return def;\n            }\n        }\n\n        return undefined;\n    }\n\n    listDefinitions(filter: {\n        namespace?: string | A_FrameNamespace\n    } = {}): A_FrameDefinition[] {\n        const namespaceName = filter.namespace\n            ? typeof filter.namespace === 'string'\n                ? ASEID.isASEID(filter.namespace)\n                    ? new ASEID(filter.namespace).id\n                    : filter.namespace\n                : filter.namespace.id\n            : undefined;\n\n        return [...this.definitions.values()].filter(r => !namespaceName || r.namespace.name === namespaceName);\n    }\n\n    removeDefinition(def: A_FrameDefinition): void {\n        this.scope.deregister(def);\n    }\n\n    addNamespace(namespace: A_FrameNamespace): void {\n        this.scope.register(namespace);\n\n        this.namespaces.set(namespace.id, namespace);\n    }\n\n    getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        const targetKey = typeof nameOrASEID === 'string'\n            ? ASEID.isASEID(nameOrASEID)\n                ? new ASEID(nameOrASEID).id\n                : nameOrASEID\n            : nameOrASEID.id;\n\n        return this.namespaces.get(targetKey);\n    }\n\n    getDefaultNamespace(): A_FrameNamespace {\n        // Ensure default namespace always exists\n        let defaultNamespace = this.getNamespace(A_FRAME_DEFAULT_NAMESPACE_KEY);\n        if (!defaultNamespace) {\n            defaultNamespace = new A_FrameNamespace({\n                name: A_FRAME_DEFAULT_NAMESPACE_KEY,\n            });\n            this.addNamespace(defaultNamespace);\n        }\n        return defaultNamespace;\n    }\n\n    listNamespaces(): A_FrameNamespace[] {\n        return [...this.namespaces.values()];\n    }\n\n    removeNamespace(namespace: A_FrameNamespace): void {\n        this.scope.deregister(namespace);\n        this.namespaces.delete(namespace.id);\n    }\n\n\n    /**\n     * Search by a pre-computed embedding vector (cosine similarity).\n     */\n    search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n\n        const { topK = 10, namespace, minScore = 0 } = options;\n\n        const pool = namespace\n            ? [...this.definitions.values()].filter(r => r.namespace.id === namespace)\n            : [...this.definitions.values()];\n\n        const scored = pool.map(r => ({\n            record: r,\n            score: this.cosineSimilarity(vector, r.vector),\n        }));\n\n        return scored\n            .filter(s => s.score >= minScore)\n            .sort((a, b) => b.score - a.score)\n            .slice(0, topK)\n            .map(({ record: r, score }) => ({\n                record: r,\n                score,\n            }));\n    }\n\n    // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {\n    //     const a = vectorA.values ?? new Float32Array();\n    //     const b = vectorB?.values ?? new Float32Array();\n\n    //     if (a.length !== b.length) {\n    //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);\n    //     }\n    //     let dot = 0, normA = 0, normB = 0;\n    //     for (let i = 0; i < a.length; i++) {\n    //         dot += a[i] * b[i];\n    //         normA += a[i] * a[i];\n    //         normB += b[i] * b[i];\n    //     }\n    //     const denom = Math.sqrt(normA) * Math.sqrt(normB);\n    //     return denom === 0 ? 0 : dot / denom;\n    // }\n\n    cosineSimilarity(\n        a: A_FrameVector,\n        b?: A_FrameVector\n    ): number {\n        if (!b) return 0\n\n        const dot = a.dot(b)\n        const mag = a.magnitude() * b.magnitude()\n        return mag === 0 ? 0 : dot / mag\n    }\n\n    euclideanDistance(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ): number {\n        this.assertSameLength(a, b)\n\n        let sum = 0\n        for (let i = 0; i < a.length; i++) {\n            const diff = a.values[i] - b.values[i]\n            sum += diff * diff\n        }\n        return Math.sqrt(sum)\n    }\n\n    nearest(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[],\n        limit = 1\n    ): A_FrameVector[] {\n        return [...vectors]\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n            .slice(0, limit)\n            .map(r => r.vector)\n    }\n\n    rank(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[]\n    ): Array<{ vector: A_FrameVector; score: number }> {\n        return vectors\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n    }\n\n    private assertSameLength(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ) {\n        if (a.length !== b.length) {\n            throw new Error(\n                `Embedding dimension mismatch: ${a.length} vs ${b.length}`\n            )\n        }\n    }\n\n\n\n    /**\n     * Search by plain text — sends the query to the embed server via channel first.\n     */\n    // async searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     this.assertLoaded();\n    //     const resp = await channel.embed(query);\n    //     const queryEmbedding = new Float32Array(resp.data[0].embedding);\n    //     return this.search(queryEmbedding, options);\n    // }\n\n}"]}