@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/node_modules/zod-to-json-schema/dist/esm/parsers/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sources":["../../../../../../../../../node_modules/zod-to-json-schema/dist/esm/parsers/string.js"],"sourcesContent":["import { setResponseValueAndErrors } from \"../errorMessages.js\";\nlet emojiRegex = undefined;\n/**\n * Generated from the regular expressions found here as of 2024-05-22:\n * https://github.com/colinhacks/zod/blob/master/src/types.ts.\n *\n * Expressions with /i flag have been changed accordingly.\n */\nexport const zodPatterns = {\n    /**\n     * `c` was changed to `[cC]` to replicate /i flag\n     */\n    cuid: /^[cC][^\\s-]{8,}$/,\n    cuid2: /^[0-9a-z]+$/,\n    ulid: /^[0-9A-HJKMNP-TV-Z]{26}$/,\n    /**\n     * `a-z` was added to replicate /i flag\n     */\n    email: /^(?!\\.)(?!.*\\.\\.)([a-zA-Z0-9_'+\\-\\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\\-]*\\.)+[a-zA-Z]{2,}$/,\n    /**\n     * Constructed a valid Unicode RegExp\n     *\n     * Lazily instantiate since this type of regex isn't supported\n     * in all envs (e.g. React Native).\n     *\n     * See:\n     * https://github.com/colinhacks/zod/issues/2433\n     * Fix in Zod:\n     * https://github.com/colinhacks/zod/commit/9340fd51e48576a75adc919bff65dbc4a5d4c99b\n     */\n    emoji: () => {\n        if (emojiRegex === undefined) {\n            emojiRegex = RegExp(\"^(\\\\p{Extended_Pictographic}|\\\\p{Emoji_Component})+$\", \"u\");\n        }\n        return emojiRegex;\n    },\n    /**\n     * Unused\n     */\n    uuid: /^[0-9a-fA-F]{8}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{4}\\b-[0-9a-fA-F]{12}$/,\n    /**\n     * Unused\n     */\n    ipv4: /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/,\n    ipv4Cidr: /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\/(3[0-2]|[12]?[0-9])$/,\n    /**\n     * Unused\n     */\n    ipv6: /^(([a-f0-9]{1,4}:){7}|::([a-f0-9]{1,4}:){0,6}|([a-f0-9]{1,4}:){1}:([a-f0-9]{1,4}:){0,5}|([a-f0-9]{1,4}:){2}:([a-f0-9]{1,4}:){0,4}|([a-f0-9]{1,4}:){3}:([a-f0-9]{1,4}:){0,3}|([a-f0-9]{1,4}:){4}:([a-f0-9]{1,4}:){0,2}|([a-f0-9]{1,4}:){5}:([a-f0-9]{1,4}:){0,1})([a-f0-9]{1,4}|(((25[0-5])|(2[0-4][0-9])|(1[0-9]{2})|([0-9]{1,2}))\\.){3}((25[0-5])|(2[0-4][0-9])|(1[0-9]{2})|([0-9]{1,2})))$/,\n    ipv6Cidr: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))\\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,\n    base64: /^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/,\n    base64url: /^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/,\n    nanoid: /^[a-zA-Z0-9_-]{21}$/,\n    jwt: /^[A-Za-z0-9-_]+\\.[A-Za-z0-9-_]+\\.[A-Za-z0-9-_]*$/,\n};\nexport function parseStringDef(def, refs) {\n    const res = {\n        type: \"string\",\n    };\n    if (def.checks) {\n        for (const check of def.checks) {\n            switch (check.kind) {\n                case \"min\":\n                    setResponseValueAndErrors(res, \"minLength\", typeof res.minLength === \"number\"\n                        ? Math.max(res.minLength, check.value)\n                        : check.value, check.message, refs);\n                    break;\n                case \"max\":\n                    setResponseValueAndErrors(res, \"maxLength\", typeof res.maxLength === \"number\"\n                        ? Math.min(res.maxLength, check.value)\n                        : check.value, check.message, refs);\n                    break;\n                case \"email\":\n                    switch (refs.emailStrategy) {\n                        case \"format:email\":\n                            addFormat(res, \"email\", check.message, refs);\n                            break;\n                        case \"format:idn-email\":\n                            addFormat(res, \"idn-email\", check.message, refs);\n                            break;\n                        case \"pattern:zod\":\n                            addPattern(res, zodPatterns.email, check.message, refs);\n                            break;\n                    }\n                    break;\n                case \"url\":\n                    addFormat(res, \"uri\", check.message, refs);\n                    break;\n                case \"uuid\":\n                    addFormat(res, \"uuid\", check.message, refs);\n                    break;\n                case \"regex\":\n                    addPattern(res, check.regex, check.message, refs);\n                    break;\n                case \"cuid\":\n                    addPattern(res, zodPatterns.cuid, check.message, refs);\n                    break;\n                case \"cuid2\":\n                    addPattern(res, zodPatterns.cuid2, check.message, refs);\n                    break;\n                case \"startsWith\":\n                    addPattern(res, RegExp(`^${escapeLiteralCheckValue(check.value, refs)}`), check.message, refs);\n                    break;\n                case \"endsWith\":\n                    addPattern(res, RegExp(`${escapeLiteralCheckValue(check.value, refs)}$`), check.message, refs);\n                    break;\n                case \"datetime\":\n                    addFormat(res, \"date-time\", check.message, refs);\n                    break;\n                case \"date\":\n                    addFormat(res, \"date\", check.message, refs);\n                    break;\n                case \"time\":\n                    addFormat(res, \"time\", check.message, refs);\n                    break;\n                case \"duration\":\n                    addFormat(res, \"duration\", check.message, refs);\n                    break;\n                case \"length\":\n                    setResponseValueAndErrors(res, \"minLength\", typeof res.minLength === \"number\"\n                        ? Math.max(res.minLength, check.value)\n                        : check.value, check.message, refs);\n                    setResponseValueAndErrors(res, \"maxLength\", typeof res.maxLength === \"number\"\n                        ? Math.min(res.maxLength, check.value)\n                        : check.value, check.message, refs);\n                    break;\n                case \"includes\": {\n                    addPattern(res, RegExp(escapeLiteralCheckValue(check.value, refs)), check.message, refs);\n                    break;\n                }\n                case \"ip\": {\n                    if (check.version !== \"v6\") {\n                        addFormat(res, \"ipv4\", check.message, refs);\n                    }\n                    if (check.version !== \"v4\") {\n                        addFormat(res, \"ipv6\", check.message, refs);\n                    }\n                    break;\n                }\n                case \"base64url\":\n                    addPattern(res, zodPatterns.base64url, check.message, refs);\n                    break;\n                case \"jwt\":\n                    addPattern(res, zodPatterns.jwt, check.message, refs);\n                    break;\n                case \"cidr\": {\n                    if (check.version !== \"v6\") {\n                        addPattern(res, zodPatterns.ipv4Cidr, check.message, refs);\n                    }\n                    if (check.version !== \"v4\") {\n                        addPattern(res, zodPatterns.ipv6Cidr, check.message, refs);\n                    }\n                    break;\n                }\n                case \"emoji\":\n                    addPattern(res, zodPatterns.emoji(), check.message, refs);\n                    break;\n                case \"ulid\": {\n                    addPattern(res, zodPatterns.ulid, check.message, refs);\n                    break;\n                }\n                case \"base64\": {\n                    switch (refs.base64Strategy) {\n                        case \"format:binary\": {\n                            addFormat(res, \"binary\", check.message, refs);\n                            break;\n                        }\n                        case \"contentEncoding:base64\": {\n                            setResponseValueAndErrors(res, \"contentEncoding\", \"base64\", check.message, refs);\n                            break;\n                        }\n                        case \"pattern:zod\": {\n                            addPattern(res, zodPatterns.base64, check.message, refs);\n                            break;\n                        }\n                    }\n                    break;\n                }\n                case \"nanoid\": {\n                    addPattern(res, zodPatterns.nanoid, check.message, refs);\n                }\n                case \"toLowerCase\":\n                case \"toUpperCase\":\n                case \"trim\":\n                    break;\n                default:\n                    ((_) => { })(check);\n            }\n        }\n    }\n    return res;\n}\nfunction escapeLiteralCheckValue(literal, refs) {\n    return refs.patternStrategy === \"escape\"\n        ? escapeNonAlphaNumeric(literal)\n        : literal;\n}\nconst ALPHA_NUMERIC = new Set(\"ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvxyz0123456789\");\nfunction escapeNonAlphaNumeric(source) {\n    let result = \"\";\n    for (let i = 0; i < source.length; i++) {\n        if (!ALPHA_NUMERIC.has(source[i])) {\n            result += \"\\\\\";\n        }\n        result += source[i];\n    }\n    return result;\n}\n// Adds a \"format\" keyword to the schema. If a format exists, both formats will be joined in an allOf-node, along with subsequent ones.\nfunction addFormat(schema, value, message, refs) {\n    if (schema.format || schema.anyOf?.some((x) => x.format)) {\n        if (!schema.anyOf) {\n            schema.anyOf = [];\n        }\n        if (schema.format) {\n            schema.anyOf.push({\n                format: schema.format,\n                ...(schema.errorMessage &&\n                    refs.errorMessages && {\n                    errorMessage: { format: schema.errorMessage.format },\n                }),\n            });\n            delete schema.format;\n            if (schema.errorMessage) {\n                delete schema.errorMessage.format;\n                if (Object.keys(schema.errorMessage).length === 0) {\n                    delete schema.errorMessage;\n                }\n            }\n        }\n        schema.anyOf.push({\n            format: value,\n            ...(message &&\n                refs.errorMessages && { errorMessage: { format: message } }),\n        });\n    }\n    else {\n        setResponseValueAndErrors(schema, \"format\", value, message, refs);\n    }\n}\n// Adds a \"pattern\" keyword to the schema. If a pattern exists, both patterns will be joined in an allOf-node, along with subsequent ones.\nfunction addPattern(schema, regex, message, refs) {\n    if (schema.pattern || schema.allOf?.some((x) => x.pattern)) {\n        if (!schema.allOf) {\n            schema.allOf = [];\n        }\n        if (schema.pattern) {\n            schema.allOf.push({\n                pattern: schema.pattern,\n                ...(schema.errorMessage &&\n                    refs.errorMessages && {\n                    errorMessage: { pattern: schema.errorMessage.pattern },\n                }),\n            });\n            delete schema.pattern;\n            if (schema.errorMessage) {\n                delete schema.errorMessage.pattern;\n                if (Object.keys(schema.errorMessage).length === 0) {\n                    delete schema.errorMessage;\n                }\n            }\n        }\n        schema.allOf.push({\n            pattern: stringifyRegExpWithFlags(regex, refs),\n            ...(message &&\n                refs.errorMessages && { errorMessage: { pattern: message } }),\n        });\n    }\n    else {\n        setResponseValueAndErrors(schema, \"pattern\", stringifyRegExpWithFlags(regex, refs), message, refs);\n    }\n}\n// Mutate z.string.regex() in a best attempt to accommodate for regex flags when applyRegexFlags is true\nfunction stringifyRegExpWithFlags(regex, refs) {\n    if (!refs.applyRegexFlags || !regex.flags) {\n        return regex.source;\n    }\n    // Currently handled flags\n    const flags = {\n        i: regex.flags.includes(\"i\"),\n        m: regex.flags.includes(\"m\"),\n        s: regex.flags.includes(\"s\"), // `.` matches newlines\n    };\n    // The general principle here is to step through each character, one at a time, applying mutations as flags require. We keep track when the current character is escaped, and when it's inside a group /like [this]/ or (also) a range like /[a-z]/. The following is fairly brittle imperative code; edit at your peril!\n    const source = flags.i ? regex.source.toLowerCase() : regex.source;\n    let pattern = \"\";\n    let isEscaped = false;\n    let inCharGroup = false;\n    let inCharRange = false;\n    for (let i = 0; i < source.length; i++) {\n        if (isEscaped) {\n            pattern += source[i];\n            isEscaped = false;\n            continue;\n        }\n        if (flags.i) {\n            if (inCharGroup) {\n                if (source[i].match(/[a-z]/)) {\n                    if (inCharRange) {\n                        pattern += source[i];\n                        pattern += `${source[i - 2]}-${source[i]}`.toUpperCase();\n                        inCharRange = false;\n                    }\n                    else if (source[i + 1] === \"-\" && source[i + 2]?.match(/[a-z]/)) {\n                        pattern += source[i];\n                        inCharRange = true;\n                    }\n                    else {\n                        pattern += `${source[i]}${source[i].toUpperCase()}`;\n                    }\n                    continue;\n                }\n            }\n            else if (source[i].match(/[a-z]/)) {\n                pattern += `[${source[i]}${source[i].toUpperCase()}]`;\n                continue;\n            }\n        }\n        if (flags.m) {\n            if (source[i] === \"^\") {\n                pattern += `(^|(?<=[\\r\\n]))`;\n                continue;\n            }\n            else if (source[i] === \"$\") {\n                pattern += `($|(?=[\\r\\n]))`;\n                continue;\n            }\n        }\n        if (flags.s && source[i] === \".\") {\n            pattern += inCharGroup ? `${source[i]}\\r\\n` : `[${source[i]}\\r\\n]`;\n            continue;\n        }\n        pattern += source[i];\n        if (source[i] === \"\\\\\") {\n            isEscaped = true;\n        }\n        else if (inCharGroup && source[i] === \"]\") {\n            inCharGroup = false;\n        }\n        else if (!inCharGroup && source[i] === \"[\") {\n            inCharGroup = true;\n        }\n    }\n    try {\n        new RegExp(pattern);\n    }\n    catch {\n        console.warn(`Could not convert regex pattern at ${refs.currentPath.join(\"/\")} to a flag-independent form! Falling back to the flag-ignorant source`);\n        return regex.source;\n    }\n    return pattern;\n}\n"],"names":[],"mappings":"AAqMsB,IAAI,IAAI,8DAA8D;","x_google_ignoreList":[0]}

package/dist/reasoning/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Reasoning Module
+ *
+ * Provides decision tracking, reasoning chains, and explainability.
+ */
+export type DecisionType = 'classification' | 'selection' | 'routing' | 'prioritization' | 'validation' | 'transformation';
+export type ConfidenceLevel = 'very_low' | 'low' | 'medium' | 'high' | 'very_high';
+export interface DecisionContext {
+    id: string;
+    input: Record<string, unknown>;
+    options?: string[];
+    constraints?: string[];
+    timestamp: Date;
+}
+export interface Alternative {
+    id: string;
+    description: string;
+    score: number;
+    reasonNotSelected?: string;
+}
+export interface DecisionOutcome {
+    selected: string;
+    confidence: ConfidenceLevel;
+    confidenceScore: number;
+    alternatives: Alternative[];
+    reasoning: string[];
+}
+export interface Decision {
+    id: string;
+    type: DecisionType;
+    context: DecisionContext;
+    outcome: DecisionOutcome;
+    duration: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ReasoningChain {
+    id: string;
+    decisions: Decision[];
+    conclusion?: string;
+    confidence: ConfidenceLevel;
+    totalDuration: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class DecisionTracker {
+    private decisions;
+    private chains;
+    private currentChainId?;
+    startChain(metadata?: Record<string, unknown>): string;
+    endChain(conclusion?: string): ReasoningChain | undefined;
+    recordDecision(type: DecisionType, context: Omit<DecisionContext, 'id' | 'timestamp'>, outcome: DecisionOutcome, duration: number, metadata?: Record<string, unknown>): Decision;
+    getDecision(id: string): Decision | undefined;
+    getChain(id: string): ReasoningChain | undefined;
+    getAllDecisions(): Decision[];
+    getAllChains(): ReasoningChain[];
+    getDecisionsByType(type: DecisionType): Decision[];
+    getRecentDecisions(limit?: number): Decision[];
+    getStatistics(): {
+        totalDecisions: number;
+        totalChains: number;
+        averageDuration: number;
+        byType: Record<DecisionType, number>;
+        byConfidence: Record<ConfidenceLevel, number>;
+    };
+    export(): {
+        decisions: Decision[];
+        chains: ReasoningChain[];
+        exportedAt: Date;
+    };
+    clear(): void;
+    private calculateChainConfidence;
+}
+export declare function createDecisionTracker(): DecisionTracker;
+export declare function getDecisionTracker(): DecisionTracker;
+//# sourceMappingURL=index.d.ts.map

package/dist/reasoning/index.d.ts.map

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

package/dist/reasoning/index.js

@@ -0,0 +1,124 @@
+class DecisionTracker {
+  decisions = /* @__PURE__ */ new Map();
+  chains = /* @__PURE__ */ new Map();
+  currentChainId;
+  startChain(metadata) {
+    const id = `chain-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    this.chains.set(id, {
+      id,
+      decisions: [],
+      confidence: "medium",
+      totalDuration: 0,
+      metadata
+    });
+    this.currentChainId = id;
+    return id;
+  }
+  endChain(conclusion) {
+    if (!this.currentChainId) return void 0;
+    const chain = this.chains.get(this.currentChainId);
+    if (chain) {
+      chain.conclusion = conclusion;
+      chain.totalDuration = chain.decisions.reduce((sum, d) => sum + d.duration, 0);
+      chain.confidence = this.calculateChainConfidence(chain);
+    }
+    this.currentChainId = void 0;
+    return chain;
+  }
+  recordDecision(type, context, outcome, duration, metadata) {
+    const id = `decision-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    const decision = {
+      id,
+      type,
+      context: {
+        ...context,
+        id: `ctx-${id}`,
+        timestamp: /* @__PURE__ */ new Date()
+      },
+      outcome,
+      duration,
+      metadata
+    };
+    this.decisions.set(id, decision);
+    if (this.currentChainId) {
+      const chain = this.chains.get(this.currentChainId);
+      if (chain) {
+        chain.decisions.push(decision);
+      }
+    }
+    return decision;
+  }
+  getDecision(id) {
+    return this.decisions.get(id);
+  }
+  getChain(id) {
+    return this.chains.get(id);
+  }
+  getAllDecisions() {
+    return Array.from(this.decisions.values());
+  }
+  getAllChains() {
+    return Array.from(this.chains.values());
+  }
+  getDecisionsByType(type) {
+    return Array.from(this.decisions.values()).filter((d) => d.type === type);
+  }
+  getRecentDecisions(limit = 10) {
+    return Array.from(this.decisions.values()).sort((a, b) => b.context.timestamp.getTime() - a.context.timestamp.getTime()).slice(0, limit);
+  }
+  getStatistics() {
+    const decisions = Array.from(this.decisions.values());
+    const byType = {};
+    const byConfidence = {};
+    let totalDuration = 0;
+    for (const decision of decisions) {
+      byType[decision.type] = (byType[decision.type] || 0) + 1;
+      byConfidence[decision.outcome.confidence] = (byConfidence[decision.outcome.confidence] || 0) + 1;
+      totalDuration += decision.duration;
+    }
+    return {
+      totalDecisions: decisions.length,
+      totalChains: this.chains.size,
+      averageDuration: decisions.length > 0 ? totalDuration / decisions.length : 0,
+      byType,
+      byConfidence
+    };
+  }
+  export() {
+    return {
+      decisions: Array.from(this.decisions.values()),
+      chains: Array.from(this.chains.values()),
+      exportedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  clear() {
+    this.decisions.clear();
+    this.chains.clear();
+    this.currentChainId = void 0;
+  }
+  calculateChainConfidence(chain) {
+    if (chain.decisions.length === 0) return "medium";
+    const avgScore = chain.decisions.reduce((sum, d) => sum + d.outcome.confidenceScore, 0) / chain.decisions.length;
+    if (avgScore >= 0.9) return "very_high";
+    if (avgScore >= 0.7) return "high";
+    if (avgScore >= 0.5) return "medium";
+    if (avgScore >= 0.3) return "low";
+    return "very_low";
+  }
+}
+let defaultTracker;
+function createDecisionTracker() {
+  return new DecisionTracker();
+}
+function getDecisionTracker() {
+  if (!defaultTracker) {
+    defaultTracker = new DecisionTracker();
+  }
+  return defaultTracker;
+}
+export {
+  DecisionTracker,
+  createDecisionTracker,
+  getDecisionTracker
+};
+//# sourceMappingURL=index.js.map

package/dist/reasoning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/reasoning/index.ts"],"sourcesContent":["/**\n * Reasoning Module\n *\n * Provides decision tracking, reasoning chains, and explainability.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type DecisionType =\n  | 'classification'\n  | 'selection'\n  | 'routing'\n  | 'prioritization'\n  | 'validation'\n  | 'transformation';\n\nexport type ConfidenceLevel = 'very_low' | 'low' | 'medium' | 'high' | 'very_high';\n\nexport interface DecisionContext {\n  id: string;\n  input: Record<string, unknown>;\n  options?: string[];\n  constraints?: string[];\n  timestamp: Date;\n}\n\nexport interface Alternative {\n  id: string;\n  description: string;\n  score: number;\n  reasonNotSelected?: string;\n}\n\nexport interface DecisionOutcome {\n  selected: string;\n  confidence: ConfidenceLevel;\n  confidenceScore: number;\n  alternatives: Alternative[];\n  reasoning: string[];\n}\n\nexport interface Decision {\n  id: string;\n  type: DecisionType;\n  context: DecisionContext;\n  outcome: DecisionOutcome;\n  duration: number;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ReasoningChain {\n  id: string;\n  decisions: Decision[];\n  conclusion?: string;\n  confidence: ConfidenceLevel;\n  totalDuration: number;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Decision Tracker\n// ============================================================================\n\nexport class DecisionTracker {\n  private decisions: Map<string, Decision> = new Map();\n  private chains: Map<string, ReasoningChain> = new Map();\n  private currentChainId?: string;\n\n  startChain(metadata?: Record<string, unknown>): string {\n    const id = `chain-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;\n\n    this.chains.set(id, {\n      id,\n      decisions: [],\n      confidence: 'medium',\n      totalDuration: 0,\n      metadata,\n    });\n\n    this.currentChainId = id;\n    return id;\n  }\n\n  endChain(conclusion?: string): ReasoningChain | undefined {\n    if (!this.currentChainId) return undefined;\n\n    const chain = this.chains.get(this.currentChainId);\n    if (chain) {\n      chain.conclusion = conclusion;\n      chain.totalDuration = chain.decisions.reduce((sum, d) => sum + d.duration, 0);\n      chain.confidence = this.calculateChainConfidence(chain);\n    }\n\n    this.currentChainId = undefined;\n    return chain;\n  }\n\n  recordDecision(\n    type: DecisionType,\n    context: Omit<DecisionContext, 'id' | 'timestamp'>,\n    outcome: DecisionOutcome,\n    duration: number,\n    metadata?: Record<string, unknown>\n  ): Decision {\n    const id = `decision-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;\n\n    const decision: Decision = {\n      id,\n      type,\n      context: {\n        ...context,\n        id: `ctx-${id}`,\n        timestamp: new Date(),\n      },\n      outcome,\n      duration,\n      metadata,\n    };\n\n    this.decisions.set(id, decision);\n\n    if (this.currentChainId) {\n      const chain = this.chains.get(this.currentChainId);\n      if (chain) {\n        chain.decisions.push(decision);\n      }\n    }\n\n    return decision;\n  }\n\n  getDecision(id: string): Decision | undefined {\n    return this.decisions.get(id);\n  }\n\n  getChain(id: string): ReasoningChain | undefined {\n    return this.chains.get(id);\n  }\n\n  getAllDecisions(): Decision[] {\n    return Array.from(this.decisions.values());\n  }\n\n  getAllChains(): ReasoningChain[] {\n    return Array.from(this.chains.values());\n  }\n\n  getDecisionsByType(type: DecisionType): Decision[] {\n    return Array.from(this.decisions.values()).filter((d) => d.type === type);\n  }\n\n  getRecentDecisions(limit: number = 10): Decision[] {\n    return Array.from(this.decisions.values())\n      .sort((a, b) => b.context.timestamp.getTime() - a.context.timestamp.getTime())\n      .slice(0, limit);\n  }\n\n  getStatistics(): {\n    totalDecisions: number;\n    totalChains: number;\n    averageDuration: number;\n    byType: Record<DecisionType, number>;\n    byConfidence: Record<ConfidenceLevel, number>;\n  } {\n    const decisions = Array.from(this.decisions.values());\n    const byType: Record<string, number> = {};\n    const byConfidence: Record<string, number> = {};\n\n    let totalDuration = 0;\n\n    for (const decision of decisions) {\n      byType[decision.type] = (byType[decision.type] || 0) + 1;\n      byConfidence[decision.outcome.confidence] =\n        (byConfidence[decision.outcome.confidence] || 0) + 1;\n      totalDuration += decision.duration;\n    }\n\n    return {\n      totalDecisions: decisions.length,\n      totalChains: this.chains.size,\n      averageDuration: decisions.length > 0 ? totalDuration / decisions.length : 0,\n      byType: byType as Record<DecisionType, number>,\n      byConfidence: byConfidence as Record<ConfidenceLevel, number>,\n    };\n  }\n\n  export(): {\n    decisions: Decision[];\n    chains: ReasoningChain[];\n    exportedAt: Date;\n  } {\n    return {\n      decisions: Array.from(this.decisions.values()),\n      chains: Array.from(this.chains.values()),\n      exportedAt: new Date(),\n    };\n  }\n\n  clear(): void {\n    this.decisions.clear();\n    this.chains.clear();\n    this.currentChainId = undefined;\n  }\n\n  private calculateChainConfidence(chain: ReasoningChain): ConfidenceLevel {\n    if (chain.decisions.length === 0) return 'medium';\n\n    const avgScore =\n      chain.decisions.reduce((sum, d) => sum + d.outcome.confidenceScore, 0) /\n      chain.decisions.length;\n\n    if (avgScore >= 0.9) return 'very_high';\n    if (avgScore >= 0.7) return 'high';\n    if (avgScore >= 0.5) return 'medium';\n    if (avgScore >= 0.3) return 'low';\n    return 'very_low';\n  }\n}\n\n// ============================================================================\n// Singleton Instance\n// ============================================================================\n\nlet defaultTracker: DecisionTracker | undefined;\n\nexport function createDecisionTracker(): DecisionTracker {\n  return new DecisionTracker();\n}\n\nexport function getDecisionTracker(): DecisionTracker {\n  if (!defaultTracker) {\n    defaultTracker = new DecisionTracker();\n  }\n  return defaultTracker;\n}\n"],"names":[],"mappings":"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"}

package/dist/reasoning/tracker.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Decision Tracker - Track and explain AI decisions
+ *
+ * Provides comprehensive tracking of AI reasoning and decision-making,
+ * enabling transparency, debugging, and audit trails for all automated actions.
+ *
+ * @module reasoning/tracker
+ */
+import { EventEmitter } from 'events';
+import type { Decision, DecisionOutcome, ReasoningChain, ReasoningChainStatus, ConfidenceLevel, DecisionType, CreateDecisionParams, ReasoningStats } from './types.js';
+/**
+ * Events emitted by the DecisionTracker
+ */
+export interface DecisionTrackerEvents {
+    chainStarted: (chain: ReasoningChain) => void;
+    chainEnded: (chain: ReasoningChain) => void;
+    decisionRecorded: (decision: Decision) => void;
+    outcomeRecorded: (decision: Decision) => void;
+}
+/**
+ * Decision Tracker for recording, explaining, and auditing AI decisions
+ *
+ * @example
+ * ```typescript
+ * const tracker = createDecisionTracker();
+ *
+ * // Start a reasoning chain for a goal
+ * const chainId = tracker.startChain('Process user query about entities');
+ *
+ * // Record decisions as they're made
+ * const decision = tracker.recordDecision({
+ *   action: 'Extract entities from query',
+ *   reasoning: [
+ *     'Query contains multiple noun phrases',
+ *     'NLP analysis identified 3 potential entities',
+ *     'Confidence scores above threshold for all 3',
+ *   ],
+ *   confidence: 'high',
+ *   context: {
+ *     trigger: 'user_query',
+ *     inputs: { query: 'Tell me about Apple and Microsoft' },
+ *     constraints: ['max 10 entities', 'confidence > 0.7'],
+ *     alternatives: [],
+ *   },
+ * });
+ *
+ * // Record outcome after execution
+ * tracker.recordOutcome(decision.id, {
+ *   success: true,
+ *   result: { entities: ['Apple', 'Microsoft'] },
+ *   duration: 150,
+ *   sideEffects: [],
+ * });
+ *
+ * // Get explanation
+ * console.log(tracker.explainDecision(decision.id));
+ *
+ * // End the chain
+ * tracker.endChain(chainId);
+ * ```
+ */
+export declare class DecisionTracker extends EventEmitter {
+    private decisions;
+    private chains;
+    private currentChain?;
+    private maxDecisions;
+    private maxChains;
+    constructor(options?: {
+        maxDecisions?: number;
+        maxChains?: number;
+    });
+    /**
+     * Start a new reasoning chain for a specific goal
+     *
+     * @param goal - The goal this reasoning chain is working toward
+     * @returns The chain ID
+     */
+    startChain(goal: string): string;
+    /**
+     * Record a decision made by the system
+     *
+     * @param params - Decision parameters
+     * @returns The recorded decision
+     */
+    recordDecision(params: CreateDecisionParams): Decision;
+    /**
+     * Record the outcome of a decision after execution
+     *
+     * @param decisionId - ID of the decision
+     * @param outcome - The outcome to record
+     */
+    recordOutcome(decisionId: string, outcome: DecisionOutcome): void;
+    /**
+     * End a reasoning chain
+     *
+     * @param chainId - ID of the chain to end
+     * @param status - Final status of the chain
+     */
+    endChain(chainId: string, status?: ReasoningChainStatus): void;
+    /**
+     * Get a decision by ID
+     *
+     * @param id - Decision ID
+     * @returns The decision or undefined
+     */
+    getDecision(id: string): Decision | undefined;
+    /**
+     * Get a reasoning chain by ID
+     *
+     * @param id - Chain ID
+     * @returns The chain or undefined
+     */
+    getChain(id: string): ReasoningChain | undefined;
+    /**
+     * Get the currently active reasoning chain
+     *
+     * @returns The current chain or undefined
+     */
+    getCurrentChain(): ReasoningChain | undefined;
+    /**
+     * Get recent decisions
+     *
+     * @param limit - Maximum number of decisions to return
+     * @returns Array of recent decisions, newest first
+     */
+    getRecentDecisions(limit?: number): Decision[];
+    /**
+     * Get all decisions in a chain
+     *
+     * @param chainId - Chain ID
+     * @returns Array of decisions in the chain
+     */
+    getChainDecisions(chainId: string): Decision[];
+    /**
+     * Generate a human-readable explanation of a decision
+     *
+     * @param decisionId - ID of the decision to explain
+     * @returns Formatted explanation string
+     */
+    explainDecision(decisionId: string): string;
+    /**
+     * Generate a summary of a reasoning chain
+     *
+     * @param chainId - ID of the chain to summarize
+     * @returns Formatted summary string
+     */
+    summarizeChain(chainId: string): string;
+    /**
+     * Export a chain as a structured object for persistence or analysis
+     *
+     * @param chainId - ID of the chain to export
+     * @returns Structured chain data with explanations
+     */
+    exportChain(chainId: string): object;
+    /**
+     * Get statistics about reasoning performance
+     *
+     * @returns Reasoning statistics
+     */
+    getStats(): ReasoningStats;
+    /**
+     * Find decisions by criteria
+     *
+     * @param criteria - Search criteria
+     * @returns Matching decisions
+     */
+    findDecisions(criteria: {
+        type?: DecisionType;
+        confidence?: ConfidenceLevel;
+        success?: boolean;
+        afterDate?: Date;
+        beforeDate?: Date;
+        actionContains?: string;
+    }): Decision[];
+    /**
+     * Clear all tracked decisions and chains
+     */
+    clear(): void;
+    /**
+     * Remove old decisions to stay within limits
+     */
+    private pruneOldDecisions;
+    /**
+     * Remove old chains to stay within limits
+     */
+    private pruneOldChains;
+}
+/**
+ * Create a new DecisionTracker instance
+ *
+ * @param options - Tracker options
+ * @returns New DecisionTracker instance
+ */
+export declare function createDecisionTracker(options?: {
+    maxDecisions?: number;
+    maxChains?: number;
+}): DecisionTracker;
+/**
+ * Get the default singleton DecisionTracker instance
+ *
+ * @returns The default DecisionTracker
+ */
+export declare function getDecisionTracker(): DecisionTracker;
+/**
+ * Set the default singleton DecisionTracker instance
+ *
+ * @param tracker - The tracker to use as default
+ */
+export declare function setDefaultDecisionTracker(tracker: DecisionTracker): void;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/reasoning/tracker.d.ts.map

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

package/dist/reasoning/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Reasoning System Types
+ *
+ * Type definitions for the decision tracking and reasoning chain system.
+ * Enables transparent AI decision-making with full audit trails.
+ *
+ * @module reasoning/types
+ */
+/**
+ * Type of decision made by the system
+ * - automatic: System made decision without human input
+ * - suggested: System suggests but awaits confirmation
+ * - manual: Human-made decision
+ * - override: Human override of system decision
+ */
+export type DecisionType = 'automatic' | 'suggested' | 'manual' | 'override';
+/**
+ * Confidence level in a decision
+ * - low: <50% confidence, should probably get human input
+ * - medium: 50-75% confidence, reasonable to proceed
+ * - high: 75-95% confidence, strong basis for decision
+ * - certain: >95% confidence, essentially deterministic
+ */
+export type ConfidenceLevel = 'low' | 'medium' | 'high' | 'certain';
+/**
+ * Represents a single decision made by the reasoning system
+ */
+export interface Decision {
+    /** Unique identifier for this decision */
+    id: string;
+    /** How the decision was made */
+    type: DecisionType;
+    /** The action taken or to be taken */
+    action: string;
+    /** Step-by-step reasoning that led to this decision */
+    reasoning: string[];
+    /** Confidence level in this decision */
+    confidence: ConfidenceLevel;
+    /** Context in which the decision was made */
+    context: DecisionContext;
+    /** Outcome after execution (populated later) */
+    outcome?: DecisionOutcome;
+    /** When the decision was made */
+    timestamp: Date;
+}
+/**
+ * Context surrounding a decision
+ */
+export interface DecisionContext {
+    /** What triggered the need for a decision */
+    trigger: string;
+    /** Input data used to make the decision */
+    inputs: Record<string, unknown>;
+    /** Constraints that bounded the decision space */
+    constraints: string[];
+    /** Other options that were considered */
+    alternatives: Alternative[];
+}
+/**
+ * An alternative option that was considered
+ */
+export interface Alternative {
+    /** The alternative action */
+    action: string;
+    /** Advantages of this alternative */
+    pros: string[];
+    /** Disadvantages of this alternative */
+    cons: string[];
+    /** Confidence level if this alternative were chosen */
+    confidence: ConfidenceLevel;
+    /** Whether this alternative was rejected */
+    rejected: boolean;
+    /** Why this alternative was not chosen */
+    rejectionReason?: string;
+}
+/**
+ * Outcome of executing a decision
+ */
+export interface DecisionOutcome {
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Result data if successful */
+    result?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** How long execution took in milliseconds */
+    duration: number;
+    /** Unintended effects that occurred */
+    sideEffects: string[];
+}
+/**
+ * Status of a reasoning chain
+ */
+export type ReasoningChainStatus = 'in_progress' | 'completed' | 'failed' | 'aborted';
+/**
+ * A chain of related decisions working toward a goal
+ */
+export interface ReasoningChain {
+    /** Unique identifier for this chain */
+    id: string;
+    /** Decisions made as part of this chain */
+    decisions: Decision[];
+    /** When the chain started */
+    startTime: Date;
+    /** When the chain ended (if finished) */
+    endTime?: Date;
+    /** The goal this chain is working toward */
+    goal: string;
+    /** Current status of the chain */
+    status: ReasoningChainStatus;
+}
+/**
+ * Parameters for creating a new decision
+ */
+export interface CreateDecisionParams {
+    /** The action to take */
+    action: string;
+    /** Reasoning steps */
+    reasoning: string[];
+    /** Confidence in the decision */
+    confidence: ConfidenceLevel;
+    /** Decision context */
+    context: DecisionContext;
+    /** Optional decision type (defaults to 'automatic') */
+    type?: DecisionType;
+}
+/**
+ * Statistics about reasoning performance
+ */
+export interface ReasoningStats {
+    /** Total decisions made */
+    totalDecisions: number;
+    /** Decisions by type */
+    byType: Record<DecisionType, number>;
+    /** Decisions by confidence level */
+    byConfidence: Record<ConfidenceLevel, number>;
+    /** Success rate of completed decisions */
+    successRate: number;
+    /** Average decision duration in ms */
+    averageDuration: number;
+    /** Total chains started */
+    totalChains: number;
+    /** Chains by status */
+    chainsByStatus: Record<ReasoningChainStatus, number>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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