@gsep/core 0.8.0 → 1.0.0

package/dist/firewall/PurposeLock.js

@@ -0,0 +1,199 @@
+export class PurposeLock {
+    llm;
+    config;
+    analytics = {
+        totalChecked: 0,
+        onPurpose: 0,
+        borderline: 0,
+        offPurpose: 0,
+        redirectedSuccessfully: 0,
+        deviationRate: 0,
+    };
+    learnedOnPurpose = new Set();
+    learnedOffPurpose = new Set();
+    constructor(config, llm) {
+        this.llm = llm;
+        this.config = {
+            purpose: config.purpose,
+            allowedTopics: config.allowedTopics ?? [],
+            forbiddenTopics: config.forbiddenTopics ?? [],
+            strictness: config.strictness ?? 'moderate',
+            rejectionTemplate: config.rejectionTemplate
+                ?? `I'm here to help with {purpose}. Is there something related I can assist you with?`,
+        };
+    }
+    async classify(message) {
+        this.analytics.totalChecked++;
+        const fastResult = this.fastClassify(message);
+        if (fastResult.confidence >= 0.9) {
+            this.recordVerdict(fastResult.verdict);
+            return fastResult;
+        }
+        if (this.llm) {
+            try {
+                const llmResult = await this.llmClassify(message);
+                this.recordVerdict(llmResult.verdict);
+                this.learn(message, llmResult.verdict);
+                return llmResult;
+            }
+            catch {
+            }
+        }
+        this.recordVerdict(fastResult.verdict);
+        return fastResult;
+    }
+    async guard(message) {
+        const classification = await this.classify(message);
+        if (classification.verdict === 'on-purpose') {
+            return null;
+        }
+        if (classification.verdict === 'borderline' && this.config.strictness !== 'strict') {
+            return null;
+        }
+        return classification.suggestedResponse
+            ?? this.config.rejectionTemplate.replace('{purpose}', this.config.purpose);
+    }
+    getAnalytics() {
+        return { ...this.analytics };
+    }
+    recordSuccessfulRedirect() {
+        this.analytics.redirectedSuccessfully++;
+    }
+    fastClassify(message) {
+        const lower = message.toLowerCase().trim();
+        for (const pattern of this.learnedOffPurpose) {
+            if (lower.includes(pattern)) {
+                return {
+                    verdict: 'off-purpose',
+                    confidence: 0.85,
+                    reason: `Matches learned off-purpose pattern: "${pattern}"`,
+                    suggestedResponse: this.buildRejection(),
+                };
+            }
+        }
+        for (const pattern of this.learnedOnPurpose) {
+            if (lower.includes(pattern)) {
+                return {
+                    verdict: 'on-purpose',
+                    confidence: 0.85,
+                    reason: `Matches learned on-purpose pattern: "${pattern}"`,
+                };
+            }
+        }
+        for (const topic of this.config.forbiddenTopics) {
+            const topicLower = topic.toLowerCase();
+            const topicStem = topicLower.replace(/s$/, '');
+            if (lower.includes(topicLower) || lower.includes(topicStem)) {
+                return {
+                    verdict: 'off-purpose',
+                    confidence: 0.9,
+                    reason: `Message contains forbidden topic: "${topic}"`,
+                    suggestedResponse: this.buildRejection(),
+                };
+            }
+        }
+        for (const topic of this.config.allowedTopics) {
+            const topicLower = topic.toLowerCase();
+            const topicStem = topicLower.replace(/s$/, '');
+            if (lower.includes(topicLower) || lower.includes(topicStem)) {
+                return {
+                    verdict: 'on-purpose',
+                    confidence: 0.9,
+                    reason: `Message matches allowed topic: "${topic}"`,
+                };
+            }
+        }
+        return {
+            verdict: 'borderline',
+            confidence: 0.4,
+            reason: 'No keyword match — requires deeper analysis',
+        };
+    }
+    async llmClassify(message) {
+        const allowedStr = this.config.allowedTopics.length > 0
+            ? `Allowed topics: ${this.config.allowedTopics.join(', ')}`
+            : '';
+        const forbiddenStr = this.config.forbiddenTopics.length > 0
+            ? `Forbidden topics: ${this.config.forbiddenTopics.join(', ')}`
+            : '';
+        const response = await this.llm.chat([
+            {
+                role: 'system',
+                content: `You are a purpose classifier for an AI agent. The agent's purpose is: "${this.config.purpose}". ${allowedStr} ${forbiddenStr}
+
+Classify the user's message as one of:
+- ON-PURPOSE: directly related to the agent's purpose
+- BORDERLINE: tangentially related (e.g. asking about food on a marketplace that sells food)
+- OFF-PURPOSE: completely unrelated to the agent's purpose
+
+Respond ONLY in this exact JSON format:
+{"verdict":"on-purpose|borderline|off-purpose","confidence":0.0-1.0,"reason":"brief explanation","suggestedResponse":"friendly redirect if off-purpose, omit if on-purpose"}`,
+            },
+            {
+                role: 'user',
+                content: message,
+            },
+        ], { temperature: 0 });
+        try {
+            const match = response.content.match(/\{[\s\S]*\}/);
+            if (match) {
+                const parsed = JSON.parse(match[0]);
+                const verdict = (['on-purpose', 'borderline', 'off-purpose'].includes(parsed.verdict)
+                    ? parsed.verdict
+                    : 'borderline');
+                return {
+                    verdict,
+                    confidence: Math.min(1, Math.max(0, parsed.confidence ?? 0.7)),
+                    reason: parsed.reason ?? 'LLM classification',
+                    suggestedResponse: parsed.suggestedResponse,
+                };
+            }
+        }
+        catch {
+        }
+        return {
+            verdict: 'borderline',
+            confidence: 0.5,
+            reason: 'LLM response could not be parsed',
+        };
+    }
+    learn(message, verdict) {
+        const words = message.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        if (words.length < 2)
+            return;
+        const phrase = words.slice(0, 3).join(' ');
+        if (verdict === 'on-purpose') {
+            this.learnedOnPurpose.add(phrase);
+            this.learnedOffPurpose.delete(phrase);
+        }
+        else if (verdict === 'off-purpose') {
+            this.learnedOffPurpose.add(phrase);
+            this.learnedOnPurpose.delete(phrase);
+        }
+        if (this.learnedOnPurpose.size > 200) {
+            const first = this.learnedOnPurpose.values().next().value;
+            if (first)
+                this.learnedOnPurpose.delete(first);
+        }
+        if (this.learnedOffPurpose.size > 200) {
+            const first = this.learnedOffPurpose.values().next().value;
+            if (first)
+                this.learnedOffPurpose.delete(first);
+        }
+    }
+    recordVerdict(verdict) {
+        if (verdict === 'on-purpose')
+            this.analytics.onPurpose++;
+        else if (verdict === 'borderline')
+            this.analytics.borderline++;
+        else
+            this.analytics.offPurpose++;
+        this.analytics.deviationRate = this.analytics.totalChecked > 0
+            ? this.analytics.offPurpose / this.analytics.totalChecked
+            : 0;
+    }
+    buildRejection() {
+        return this.config.rejectionTemplate.replace('{purpose}', this.config.purpose);
+    }
+}
+//# sourceMappingURL=PurposeLock.js.map

package/dist/firewall/PurposeLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PurposeLock.js","sourceRoot":"","sources":["../../src/firewall/PurposeLock.ts"],"names":[],"mappings":"AA4DA,MAAM,OAAO,WAAW;IAiBR;IAhBJ,MAAM,CAA8B;IACpC,SAAS,GAAyB;QACtC,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,sBAAsB,EAAE,CAAC;QACzB,aAAa,EAAE,CAAC;KACnB,CAAC;IAGM,gBAAgB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAC1C,iBAAiB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEnD,YACI,MAAyB,EACjB,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;QAExB,IAAI,CAAC,MAAM,GAAG;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;YACzC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU;YAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;mBACpC,oFAAoF;SAC9F,CAAC;IACN,CAAC;IAKD,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC1B,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAG9B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,UAAU,CAAC;QACtB,CAAC;QAGD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBACvC,OAAO,SAAS,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACL,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,UAAU,CAAC;IACtB,CAAC;IAMD,KAAK,CAAC,KAAK,CAAC,OAAe;QACvB,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,cAAc,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,cAAc,CAAC,OAAO,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjF,OAAO,IAAI,CAAC;QAChB,CAAC;QAGD,OAAO,cAAc,CAAC,iBAAiB;eAChC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IAKD,YAAY;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAKD,wBAAwB;QACpB,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE,CAAC;IAC5C,CAAC;IAIO,YAAY,CAAC,OAAe;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAG3C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACH,OAAO,EAAE,aAAa;oBACtB,UAAU,EAAE,IAAI;oBAChB,MAAM,EAAE,yCAAyC,OAAO,GAAG;oBAC3D,iBAAiB,EAAE,IAAI,CAAC,cAAc,EAAE;iBAC3C,CAAC;YACN,CAAC;QACL,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACH,OAAO,EAAE,YAAY;oBACrB,UAAU,EAAE,IAAI;oBAChB,MAAM,EAAE,wCAAwC,OAAO,GAAG;iBAC7D,CAAC;YACN,CAAC;QACL,CAAC;QAGD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1D,OAAO;oBACH,OAAO,EAAE,aAAa;oBACtB,UAAU,EAAE,GAAG;oBACf,MAAM,EAAE,sCAAsC,KAAK,GAAG;oBACtD,iBAAiB,EAAE,IAAI,CAAC,cAAc,EAAE;iBAC3C,CAAC;YACN,CAAC;QACL,CAAC;QAGD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1D,OAAO;oBACH,OAAO,EAAE,YAAY;oBACrB,UAAU,EAAE,GAAG;oBACf,MAAM,EAAE,mCAAmC,KAAK,GAAG;iBACtD,CAAC;YACN,CAAC;QACL,CAAC;QAGD,OAAO;YACH,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,6CAA6C;SACxD,CAAC;IACN,CAAC;IAIO,KAAK,CAAC,WAAW,CAAC,OAAe;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;YACnD,CAAC,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3D,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YACvD,CAAC,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/D,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAI,CAAC,IAAI,CAAC;YAClC;gBACI,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,0EAA0E,IAAI,CAAC,MAAM,CAAC,OAAO,MAAM,UAAU,IAAI,YAAY;;;;;;;;6KAQuB;aAChK;YACD;gBACI,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO;aACnB;SACJ,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QAEvB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACpD,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAKjC,CAAC;gBAEF,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;oBACjF,CAAC,CAAC,MAAM,CAAC,OAAO;oBAChB,CAAC,CAAC,YAAY,CAAmB,CAAC;gBAEtC,OAAO;oBACH,OAAO;oBACP,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;oBAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,oBAAoB;oBAC7C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;iBAC9C,CAAC;YACN,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;QAED,OAAO;YACH,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,kCAAkC;SAC7C,CAAC;IACN,CAAC;IAIO,KAAK,CAAC,OAAe,EAAE,OAAuB;QAElD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QAE7B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE3C,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAGD,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC1D,IAAI,KAAK;gBAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC3D,IAAI,KAAK;gBAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAIO,aAAa,CAAC,OAAuB;QACzC,IAAI,OAAO,KAAK,YAAY;YAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;aACpD,IAAI,OAAO,KAAK,YAAY;YAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;;YAC1D,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAEjC,IAAI,CAAC,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,CAAC;YAC1D,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY;YACzD,CAAC,CAAC,CAAC,CAAC;IACZ,CAAC;IAEO,cAAc;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;CACJ"}

package/dist/gene-bank/CognitiveGene.d.ts

@@ -112,22 +112,22 @@ export declare const MutationContextSchema: z.ZodObject<{
     domain: z.ZodString;
     metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    domain: string;
     mutationId: string;
     originalPrompt: string;
     mutatedPrompt: string;
     parentFitness: number;
     mutatedFitness: number;
     taskContext: string;
+    domain: string;
     metrics?: Record<string, unknown> | undefined;
 }, {
-    domain: string;
     mutationId: string;
     originalPrompt: string;
     mutatedPrompt: string;
     parentFitness: number;
     mutatedFitness: number;
     taskContext: string;
+    domain: string;
     metrics?: Record<string, unknown> | undefined;
 }>;
 export type MutationContext = z.infer<typeof MutationContextSchema>;
@@ -139,15 +139,15 @@ export declare const TenantInfoSchema: z.ZodObject<{
     scope: z.ZodDefault<z.ZodEnum<["private", "tenant", "marketplace"]>>;
     verified: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    verified: boolean;
     tenantId: string;
     createdBy: string;
-    scope: "tenant" | "private" | "marketplace";
-    verified: boolean;
+    scope: "private" | "tenant" | "marketplace";
 }, {
     tenantId: string;
     createdBy: string;
-    scope?: "tenant" | "private" | "marketplace" | undefined;
     verified?: boolean | undefined;
+    scope?: "private" | "tenant" | "marketplace" | undefined;
 }>;
 export type TenantInfo = z.infer<typeof TenantInfoSchema>;
 export declare const CognitiveGeneSchema: z.ZodObject<{
@@ -261,43 +261,34 @@ export declare const CognitiveGeneSchema: z.ZodObject<{
         scope: z.ZodDefault<z.ZodEnum<["private", "tenant", "marketplace"]>>;
         verified: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        verified: boolean;
         tenantId: string;
         createdBy: string;
-        scope: "tenant" | "private" | "marketplace";
-        verified: boolean;
+        scope: "private" | "tenant" | "marketplace";
     }, {
         tenantId: string;
         createdBy: string;
-        scope?: "tenant" | "private" | "marketplace" | undefined;
         verified?: boolean | undefined;
+        scope?: "private" | "tenant" | "marketplace" | undefined;
     }>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    content: {
-        metadata: Record<string, unknown>;
-        instruction: string;
-        requiredCapabilities: string[];
-        applicableContexts: string[];
-        contraindications: string[];
-        examples?: {
-            scenario: string;
-            expectedBehavior: string;
-        }[] | undefined;
-    };
+    type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+    description: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    domain: string;
     tenant: {
+        verified: boolean;
         tenantId: string;
         createdBy: string;
-        scope: "tenant" | "private" | "marketplace";
-        verified: boolean;
+        scope: "private" | "tenant" | "marketplace";
     };
     version: string;
-    name: string;
-    description: string;
-    type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-    domain: string;
     fitness: {
         overallFitness: number;
         taskSuccessRate: number;
@@ -317,32 +308,32 @@ export declare const CognitiveGeneSchema: z.ZodObject<{
             fitnessGain: number;
         }[];
     };
-    createdAt: string;
-    updatedAt: string;
-    tags: string[];
-}, {
-    id: string;
     content: {
+        metadata: Record<string, unknown>;
         instruction: string;
-        metadata?: Record<string, unknown> | undefined;
+        requiredCapabilities: string[];
+        applicableContexts: string[];
+        contraindications: string[];
         examples?: {
             scenario: string;
             expectedBehavior: string;
         }[] | undefined;
-        requiredCapabilities?: string[] | undefined;
-        applicableContexts?: string[] | undefined;
-        contraindications?: string[] | undefined;
     };
+    tags: string[];
+}, {
+    id: string;
+    type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+    description: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    domain: string;
     tenant: {
         tenantId: string;
         createdBy: string;
-        scope?: "tenant" | "private" | "marketplace" | undefined;
         verified?: boolean | undefined;
+        scope?: "private" | "tenant" | "marketplace" | undefined;
     };
-    name: string;
-    description: string;
-    type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-    domain: string;
     fitness: {
         overallFitness: number;
         taskSuccessRate: number;
@@ -362,8 +353,17 @@ export declare const CognitiveGeneSchema: z.ZodObject<{
             fitnessGain: number;
         }[] | undefined;
     };
-    createdAt: string;
-    updatedAt: string;
+    content: {
+        instruction: string;
+        metadata?: Record<string, unknown> | undefined;
+        examples?: {
+            scenario: string;
+            expectedBehavior: string;
+        }[] | undefined;
+        requiredCapabilities?: string[] | undefined;
+        applicableContexts?: string[] | undefined;
+        contraindications?: string[] | undefined;
+    };
     version?: string | undefined;
     tags?: string[] | undefined;
 }>;
@@ -481,43 +481,34 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
             scope: z.ZodDefault<z.ZodEnum<["private", "tenant", "marketplace"]>>;
             verified: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
+            verified: boolean;
             tenantId: string;
             createdBy: string;
-            scope: "tenant" | "private" | "marketplace";
-            verified: boolean;
+            scope: "private" | "tenant" | "marketplace";
         }, {
             tenantId: string;
             createdBy: string;
-            scope?: "tenant" | "private" | "marketplace" | undefined;
             verified?: boolean | undefined;
+            scope?: "private" | "tenant" | "marketplace" | undefined;
         }>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        content: {
-            metadata: Record<string, unknown>;
-            instruction: string;
-            requiredCapabilities: string[];
-            applicableContexts: string[];
-            contraindications: string[];
-            examples?: {
-                scenario: string;
-                expectedBehavior: string;
-            }[] | undefined;
-        };
+        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+        description: string;
+        createdAt: string;
+        updatedAt: string;
+        name: string;
+        domain: string;
         tenant: {
+            verified: boolean;
             tenantId: string;
             createdBy: string;
-            scope: "tenant" | "private" | "marketplace";
-            verified: boolean;
+            scope: "private" | "tenant" | "marketplace";
         };
         version: string;
-        name: string;
-        description: string;
-        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-        domain: string;
         fitness: {
             overallFitness: number;
             taskSuccessRate: number;
@@ -537,32 +528,32 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
                 fitnessGain: number;
             }[];
         };
-        createdAt: string;
-        updatedAt: string;
-        tags: string[];
-    }, {
-        id: string;
         content: {
+            metadata: Record<string, unknown>;
             instruction: string;
-            metadata?: Record<string, unknown> | undefined;
+            requiredCapabilities: string[];
+            applicableContexts: string[];
+            contraindications: string[];
             examples?: {
                 scenario: string;
                 expectedBehavior: string;
             }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            applicableContexts?: string[] | undefined;
-            contraindications?: string[] | undefined;
         };
+        tags: string[];
+    }, {
+        id: string;
+        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+        description: string;
+        createdAt: string;
+        updatedAt: string;
+        name: string;
+        domain: string;
         tenant: {
             tenantId: string;
             createdBy: string;
-            scope?: "tenant" | "private" | "marketplace" | undefined;
             verified?: boolean | undefined;
+            scope?: "private" | "tenant" | "marketplace" | undefined;
         };
-        name: string;
-        description: string;
-        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-        domain: string;
         fitness: {
             overallFitness: number;
             taskSuccessRate: number;
@@ -582,8 +573,17 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
                 fitnessGain: number;
             }[] | undefined;
         };
-        createdAt: string;
-        updatedAt: string;
+        content: {
+            instruction: string;
+            metadata?: Record<string, unknown> | undefined;
+            examples?: {
+                scenario: string;
+                expectedBehavior: string;
+            }[] | undefined;
+            requiredCapabilities?: string[] | undefined;
+            applicableContexts?: string[] | undefined;
+            contraindications?: string[] | undefined;
+        };
         version?: string | undefined;
         tags?: string[] | undefined;
     }>>;
@@ -612,31 +612,23 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
         extractionMethod: string;
         durationMs: number;
     };
+    confidence: number;
     success: boolean;
     gene: {
         id: string;
-        content: {
-            metadata: Record<string, unknown>;
-            instruction: string;
-            requiredCapabilities: string[];
-            applicableContexts: string[];
-            contraindications: string[];
-            examples?: {
-                scenario: string;
-                expectedBehavior: string;
-            }[] | undefined;
-        };
+        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+        description: string;
+        createdAt: string;
+        updatedAt: string;
+        name: string;
+        domain: string;
         tenant: {
+            verified: boolean;
             tenantId: string;
             createdBy: string;
-            scope: "tenant" | "private" | "marketplace";
-            verified: boolean;
+            scope: "private" | "tenant" | "marketplace";
         };
         version: string;
-        name: string;
-        description: string;
-        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-        domain: string;
         fitness: {
             overallFitness: number;
             taskSuccessRate: number;
@@ -656,11 +648,19 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
                 fitnessGain: number;
             }[];
         };
-        createdAt: string;
-        updatedAt: string;
+        content: {
+            metadata: Record<string, unknown>;
+            instruction: string;
+            requiredCapabilities: string[];
+            applicableContexts: string[];
+            contraindications: string[];
+            examples?: {
+                scenario: string;
+                expectedBehavior: string;
+            }[] | undefined;
+        };
         tags: string[];
     } | null;
-    confidence: number;
     reason?: string | undefined;
 }, {
     metadata: {
@@ -669,30 +669,22 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
         extractionMethod: string;
         durationMs: number;
     };
+    confidence: number;
     success: boolean;
     gene: {
         id: string;
-        content: {
-            instruction: string;
-            metadata?: Record<string, unknown> | undefined;
-            examples?: {
-                scenario: string;
-                expectedBehavior: string;
-            }[] | undefined;
-            requiredCapabilities?: string[] | undefined;
-            applicableContexts?: string[] | undefined;
-            contraindications?: string[] | undefined;
-        };
+        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
+        description: string;
+        createdAt: string;
+        updatedAt: string;
+        name: string;
+        domain: string;
         tenant: {
             tenantId: string;
             createdBy: string;
-            scope?: "tenant" | "private" | "marketplace" | undefined;
             verified?: boolean | undefined;
+            scope?: "private" | "tenant" | "marketplace" | undefined;
         };
-        name: string;
-        description: string;
-        type: "tool-usage-pattern" | "reasoning-pattern" | "communication-pattern" | "error-recovery-pattern" | "context-management" | "multi-step-workflow" | "domain-expertise";
-        domain: string;
         fitness: {
             overallFitness: number;
             taskSuccessRate: number;
@@ -712,12 +704,20 @@ export declare const GeneExtractionResultSchema: z.ZodObject<{
                 fitnessGain: number;
             }[] | undefined;
         };
-        createdAt: string;
-        updatedAt: string;
+        content: {
+            instruction: string;
+            metadata?: Record<string, unknown> | undefined;
+            examples?: {
+                scenario: string;
+                expectedBehavior: string;
+            }[] | undefined;
+            requiredCapabilities?: string[] | undefined;
+            applicableContexts?: string[] | undefined;
+            contraindications?: string[] | undefined;
+        };
         version?: string | undefined;
         tags?: string[] | undefined;
     } | null;
-    confidence: number;
     reason?: string | undefined;
 }>;
 export type GeneExtractionResult = z.infer<typeof GeneExtractionResultSchema>;
@@ -732,8 +732,8 @@ export declare const GeneAdoptionResultSchema: z.ZodObject<{
         performance: z.ZodNumber;
         issues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        issues: string[];
         performance: number;
+        issues: string[];
         passed: boolean;
         testsPassed: number;
         testsFailed: number;
@@ -765,8 +765,8 @@ export declare const GeneAdoptionResultSchema: z.ZodObject<{
     geneId: string;
     agentId: string;
     sandboxResults: {
-        issues: string[];
         performance: number;
+        issues: string[];
         passed: boolean;
         testsPassed: number;
         testsFailed: number;