@adaas/a-frame 0.1.1 → 0.1.2

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":["A_Component","A_FrameVector","A_FrameChannelRequest","A_Scope","A_Context","A_FrameFeatures","A_FrameDynamicFeatureError","__decorateClass","A_Feature","A_FrameDynamicFeatureFeatures","A_FrameDynamicFeature","__decorateParam","A_Caller","A_FrameMethodMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":";;;;;;;;AAiCO,IAAM,mBAAA,GAAN,cAAkCA,oBAAA,CAAY;AAAA,EAMjD,MAAM,UAAA,CACkB,OAAA,EACa,QAAA,EACT,YACE,OAAA,EACb;AAEb,IAAA,MAAM,MAAM,OAAA,CAAQ,UAAA;AACpB,IAAA,IAAI,CAAC,GAAA,EAAK;AAIV,IAAA,MAAM,YAAA,GAAe,CACjB,IAAA,EACA,QAAA,KAC2F;AAC3F,MAAA,IAAI,CAAC,IAAA,CAAK,SAAA,EAAW,MAAA,EAAQ;AACzB,QAAA,OAAO,EAAE,YAAA,EAAc,IAAA,EAAM,aAAA,EAAe,IAAA,EAAM,YAAY,CAAA,EAAE;AAAA,MACpE;AACA,MAAA,MAAM,OAAA,GAAU,UAAA,CAAW,MAAA,CAAO,IAAIC,+BAAA,CAAc,IAAA,CAAK,SAAS,CAAA,EAAG,EAAE,IAAA,EAAM,CAAA,EAAG,CAAA;AAChF,MAAA,MAAM,GAAA,GAAM,QAAQ,CAAC,CAAA;AACrB,MAAA,IAAI,GAAA,IAAO,GAAA,CAAI,KAAA,IAAS,QAAA,EAAU;AAG9B,QAAA,MAAM,YAAA,GAAe,GAAA,CAAI,MAAA,CAAO,UAAA,CAAW,IAAA;AAC3C,QAAA,MAAM,aAAA,GAAgB,IAAI,MAAA,CAAO,IAAA;AACjC,QAAA,OAAO,EAAE,YAAA,EAAc,aAAA,EAAe,UAAA,EAAY,IAAI,KAAA,EAAM;AAAA,MAChE;AACA,MAAA,OAAO,EAAE,cAAc,IAAA,EAAM,aAAA,EAAe,MAAM,UAAA,EAAY,GAAA,EAAK,SAAS,CAAA,EAAE;AAAA,IAClF,CAAA;AAEA,IAAA,MAAM,eAAA,GAAkB,CACpB,EAAA,EACA,QAAA,KAC4E;AAC5E,MAAA,IAAI,CAAC,EAAA,CAAG,SAAA,EAAW,MAAA,EAAQ;AACvB,QAAA,OAAO,EAAE,YAAA,EAAc,IAAA,EAAM,UAAA,EAAY,CAAA,EAAE;AAAA,MAC/C;AACA,MAAA,MAAM,OAAA,GAAU,UAAA,CAAW,MAAA,CAAO,IAAIA,+BAAA,CAAc,EAAA,CAAG,SAAS,CAAA,EAAG,EAAE,IAAA,EAAM,CAAA,EAAG,CAAA;AAC9E,MAAA,MAAM,GAAA,GAAM,QAAQ,CAAC,CAAA;AACrB,MAAA,IAAI,GAAA,IAAO,GAAA,CAAI,KAAA,IAAS,QAAA,EAAU;AAC9B,QAAA,OAAO,EAAE,YAAA,EAAc,GAAA,CAAI,OAAO,IAAA,EAAM,UAAA,EAAY,IAAI,KAAA,EAAM;AAAA,MAClE;AACA,MAAA,OAAO,EAAE,YAAA,EAAc,IAAA,EAAM,UAAA,EAAY,GAAA,EAAK,SAAS,CAAA,EAAE;AAAA,IAC7D,CAAA;AAEA,IAAA,MAAM,eAAA,GAAkB,CAAC,CAAA,KAAwE;AAC7F,MAAA,MAAM,KAAA,GAAQ,CAAC,EAAA,KAAiB;AAAE,QAAA,MAAM,EAAE,SAAA,EAAW,GAAG,IAAA,EAAK,GAAI,EAAA;AAAI,QAAA,OAAO,IAAA;AAAA,MAAM,CAAA;AAClF,MAAA,OAAO;AAAA,QACH,GAAG,CAAA;AAAA,QACH,KAAA,EAAY,CAAA,CAAE,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA;AAAA,QAC7B,UAAA,EAAY,CAAA,CAAE,UAAA,CAAW,GAAA,CAAI,KAAK,CAAA;AAAA,QAClC,SAAA,EAAY,CAAA,CAAE,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AAAA,QACjC,QAAA,EAAY,CAAA,CAAE,QAAA,CAAS,GAAA,CAAI,KAAK;AAAA,OACpC;AAAA,IACJ,CAAA;AAEA,IAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAA6C;AAC3D,MAAA,QAAA,CAAS,KAAA,EAAM;AACf,MAAA,KAAA,MAAW,IAAA,IAAQ,EAAE,KAAA,EAAO;AACxB,QAAA,QAAA,CAAS,OAAA,CAAQ;AAAA,UACb,QAAS,IAAA,CAAK,MAAA;AAAA,UACd,QAAS,IAAA,CAAK,MAAA;AAAA,UACd,SAAS,IAAA,CAAK,OAAA;AAAA,UACd,GAAG,YAAA,CAAa,IAAA,EAAM,OAAA,CAAQ,QAAQ;AAAA,SACzC,CAAA;AAAA,MACL;AACA,MAAA,KAAA,MAAW,EAAA,IAAM,EAAE,UAAA,EAAY;AAC3B,QAAA,QAAA,CAAS,UAAA,CAAW,EAAE,MAAA,EAAQ,EAAA,CAAG,MAAA,EAAQ,GAAG,eAAA,CAAgB,EAAA,EAAI,OAAA,CAAQ,QAAQ,CAAA,EAAG,CAAA;AAAA,MACvF;AACA,MAAA,KAAA,MAAW,EAAA,IAAM,EAAE,SAAA,EAAW;AAC1B,QAAA,QAAA,CAAS,UAAA,CAAW,EAAE,MAAA,EAAQ,EAAA,CAAG,MAAA,EAAQ,GAAG,eAAA,CAAgB,EAAA,EAAI,OAAA,CAAQ,QAAQ,CAAA,EAAG,CAAA;AAAA,MACvF;AACA,MAAA,KAAA,MAAW,EAAA,IAAM,EAAE,QAAA,EAAU;AACzB,QAAA,QAAA,CAAS,UAAA,CAAW,EAAE,MAAA,EAAQ,EAAA,CAAG,MAAA,EAAQ,GAAG,eAAA,CAAgB,EAAA,EAAI,OAAA,CAAQ,QAAQ,CAAA,EAAG,CAAA;AAAA,MACvF;AAAA,IACJ,CAAA;AAIA,IAAA,IAAI,UAAA,GAAa,GAAA;AACjB,IAAA,QAAA,CAAS,UAAU,CAAA;AAInB,IAAA,KAAA,IAAS,KAAA,GAAQ,CAAA,EAAG,KAAA,GAAQ,OAAA,CAAQ,YAAY,KAAA,EAAA,EAAS;AACrD,MAAA,MAAM,cAAA,GAAiB,WAAW,KAAA,CAAM,MAAA;AAAA,QACpC,CAAA,IAAA,KAAQ,KAAK,SAAA,EAAW,MAAA,IAAU,SAAS,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAA,EAAG,aAAA,KAAkB;AAAA,OACvF;AACA,MAAA,IAAI,cAAA,CAAe,WAAW,CAAA,EAAG;AAEjC,MAAA,MAAM,qBAAA,GAAwB;AAAA,QAC1B,CAAA,2EAAA,CAAA;AAAA,QACA,CAAA,0EAAA,CAAA;AAAA,QACA,cAAA,CAAe,IAAI,CAAA,CAAA,KAAK,CAAA,GAAA,EAAM,EAAE,MAAM,CAAA,CAAA,CAAG,CAAA,CAAE,IAAA,CAAK,IAAI;AAAA,OACxD,CAAE,KAAK,IAAI,CAAA;AAEX,MAAA,MAAM,WAAW,IAAIC,uCAAA;AAAA,QACjB,MAAA;AAAA,QACA,uBAAA;AAAA,QACA;AAAA,UACI,gBAAmB,OAAA,CAAQ,MAAA;AAAA,UAC3B,UAAA,EAAmB,gBAAgB,UAAU,CAAA;AAAA,UAC7C,gBAAA,EAAmB,qBAAA;AAAA,UACnB,OAAmB,OAAA,CAAQ,SAAA;AAAA,UAC3B,SAAmB,OAAA,CAAQ;AAAA;AAC/B,OACJ;AAEA,MAAA,MAAM,UAAA,GAAa,IAAIC,gBAAA,CAAQ;AAAA,QAC3B,IAAA,EAAM,uCAAuC,KAAK,CAAA,CAAA;AAAA,QAClD,SAAA,EAAW,CAAC,QAAQ;AAAA,OACvB,CAAA,CAAE,OAAA,CAAQC,kBAAA,CAAU,KAAA,CAAM,OAAO,CAAC,CAAA;AAEnC,MAAA,MAAM,OAAA,CAAQ,IAAA,CAAKC,iCAAA,CAAgB,OAAA,EAAS,UAAU,CAAA;AACtD,MAAA,UAAA,CAAW,OAAA,EAAQ;AAEnB,MAAA,IAAI,CAAC,SAAS,QAAA,EAAU;AAExB,MAAA,UAAA,GAAa,SAAS,QAAA,CAAS,UAAA;AAC/B,MAAA,QAAA,CAAS,UAAU,CAAA;AAAA,IACvB;AAIA,IAAA,KAAA,MAAW,IAAA,IAAQ,WAAW,KAAA,EAAO;AACjC,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAA;AAC1C,MAAA,IAAI,SAAS,KAAA,CAAM,aAAA,KAAkB,IAAA,IAAQ,IAAA,CAAK,WAAW,MAAA,EAAQ;AACjE,QAAA,QAAA,CAAS,OAAA,CAAQ;AAAA,UACb,GAAG,KAAA;AAAA,UACH,UAAA,EAAY;AAAA,YACR,OAAOC,4CAAA,CAA2B,cAAA;AAAA,YAClC,aAAa,CAAA,iBAAA,EAAoB,IAAA,CAAK,MAAM,CAAA,iCAAA,EAAoC,QAAQ,UAAU,CAAA,SAAA;AAAA;AACtG,SACH,CAAA;AAAA,MACL;AAAA,IACJ;AAIA,IAAA,OAAA,CAAQ,cAAA,CAAe,QAAA,CAAS,QAAA,CAAS,UAAU,CAAC,CAAA;AAAA,EACxD;AACJ;AA9IUC,iCAAA,CAAA;AAAA,EAJLC,mBAAU,MAAA,CAAO;AAAA,IACd,MAAMC,+CAAA,CAA8B,GAAA;AAAA,IACpC,KAAA,EAAO,CAACC,uCAAqB;AAAA,GAChC,CAAA;AAAA,EAEIC,uDAASC,iBAAQ,CAAA,CAAA;AAAA,EACjBD,uDAASE,uCAAqB,CAAA,CAAA;AAAA,EAC9BF,uDAASG,8BAAY,CAAA,CAAA;AAAA,EACrBH,uDAASI,gCAAc,CAAA;AAAA,CAAA,EAVnB,mBAAA,CAMH,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA","file":"chunk-K7SXPJPK.cjs","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"]}