@mastra/code-sdk 1.12.0-alpha.3 → 1.12.0-alpha.5

package/dist/knowledge-inspector.d.ts

@@ -1,4 +1,6 @@
 import type { Session } from '@mastra/core/agent-controller';
+import type { Knowledge } from '@mastra/core/knowledge';
+import type { Mastra } from '@mastra/core/mastra';
 import type { KnowledgeActivityEvent, MastraCompositeStore } from '@mastra/core/storage';
 import type { MastraCodeState } from './schema.js';
 export type KnowledgeInspectorScopeLevel = 'org' | 'resource' | 'thread';
@@ -114,6 +116,8 @@ export declare class KnowledgeInspectorError extends Error {
 }
 export declare function createKnowledgeInspector(input: {
     storage: MastraCompositeStore;
+    knowledge?: Knowledge | string;
+    mastra?: Pick<Mastra, 'getKnowledge'>;
     session: Session<MastraCodeState>;
 }): Promise<KnowledgeInspector | undefined>;
 //# sourceMappingURL=knowledge-inspector.d.ts.map

package/dist/knowledge-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-inspector.d.ts","sourceRoot":"","sources":["../src/knowledge-inspector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledge-inspector.d.ts","sourceRoot":"","sources":["../src/knowledge-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EACV,sBAAsB,EAKtB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;AACzE,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,0BAA0B,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7E,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,4BAA4B,CAAC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;IACzB,KAAK,EAAE,2BAA2B,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,4BAA4B,CAAC;IACpC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,4BAA4B,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,4BAA4B,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,oCAAoC,CAAC;CAC3D;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,4BAA4B,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,4BAA4B,CAAC;IACzC,KAAK,EAAE,6BAA6B,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,0BAA0B,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,qCAAqC;IACpD,KAAK,EAAE,6BAA6B,EAAE,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,4BAA4B,CAAC;IACzC,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;IACrD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,eAAe,EAAE,qCAAqC,CAAC;IACvD,eAAe,EAAE,qCAAqC,CAAC;IACvD,kBAAkB,EAAE,oCAAoC,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,6BAA6B,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACzC,UAAU,EAAE,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACjD,KAAK,EAAE,4BAA4B,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,6BAA6B,CAAC;CACxC;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,4BAA4B,CAAC;IACzC,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACrD,SAAS,CAAC,KAAK,EAAE;QACf,KAAK,EAAE,4BAA4B,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,0BAA0B,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1C,YAAY,CAAC,KAAK,EAAE;QAClB,KAAK,EAAE,4BAA4B,CAAC;QACpC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC7C;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAE9C,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,cAAc,GAAG,gBAAgB,GAAG,aAAa;gBAA1F,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,cAAc,GAAG,gBAAgB,GAAG,aAAa,EACnG,OAAO,EAAE,MAAM;CAKlB;AAuoBD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAgB1C"}

package/dist/knowledge-inspector.js

@@ -495,7 +495,16 @@ var ScopedKnowledgeInspector = class {
 	}
 };
 async function createKnowledgeInspector(input) {
-	const knowledge = await input.storage.getStore("knowledge");
+	let selected;
+	if (typeof input.knowledge === "string") {
+		try {
+			selected = input.mastra?.getKnowledge(input.knowledge);
+		} catch {
+			throw new KnowledgeInspectorError("unavailable", "The configured Knowledge runtime is unavailable.");
+		}
+		if (!selected) throw new KnowledgeInspectorError("unavailable", "The configured Knowledge runtime is unavailable.");
+	} else selected = input.knowledge;
+	const knowledge = selected ? await selected.getStorage() : await input.storage.getStore("knowledge");
 	return knowledge ? new ScopedKnowledgeInspector({
 		knowledge,
 		session: input.session

package/dist/knowledge-inspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-inspector.js","names":["#knowledge","#session","#handles","#cursors","#invalidateIdnode","#binding","#scope","#consumeCursor","#recordSummary","#sampledRelationshipCounts","#assertStable","#mintCursor","#rankedNodeSnapshot","#readHandle","#assertVisible","#outgoingTargets","#incomingParents","#activityRecord","#fingerprint","#identityKey","#mintHandle","#outgoingNodeRecords","#incomingParentRecords","#pruneOpaqueEntries"],"sources":["../src/knowledge-inspector.ts"],"sourcesContent":["import type { Session } from '@mastra/core/agent-controller';\nimport { createKnowledgeNodeCursor, isKnowledgeScopeVisible, parseKnowledgeWikilinks } from '@mastra/core/storage';\nimport type {\n  KnowledgeActivityEvent,\n  KnowledgeRecord,\n  KnowledgeNode,\n  KnowledgeScope,\n  KnowledgeStorage,\n  MastraCompositeStore,\n} from '@mastra/core/storage';\n\nimport { resolveKnowledgeScopeIdentity } from './knowledge-scope.js';\nimport type { MastraCodeState } from './schema.js';\n\nexport type KnowledgeInspectorScopeLevel = 'org' | 'resource' | 'thread';\nexport type KnowledgeInspectorRecordType = 'node';\nexport type KnowledgeInspectorNodeSort = 'relevant' | 'recent' | 'connected';\n\nexport interface KnowledgeInspectorScopeRoot {\n  level: KnowledgeInspectorScopeLevel;\n  id?: string;\n  available: boolean;\n  reason?: string;\n}\n\nexport interface KnowledgeInspectorScopeTree {\n  identityKey: string;\n  defaultLevel: 'resource';\n  roots: KnowledgeInspectorScopeRoot[];\n}\n\nexport interface KnowledgeInspectorScopeBadge {\n  level: KnowledgeInspectorScopeLevel;\n  id: string;\n}\n\nexport interface KnowledgeInspectorRelationshipCounts {\n  records: number;\n  outgoing: number;\n  incoming: number;\n  sampled: boolean;\n}\n\nexport interface KnowledgeInspectorNodeSummary {\n  handle: string;\n  type: KnowledgeInspectorRecordType;\n  name: string;\n  kind?: string;\n  scope: KnowledgeInspectorScopeBadge;\n  version: number;\n  updatedAt: string;\n  relationshipCounts?: KnowledgeInspectorRelationshipCounts;\n}\n\nexport interface KnowledgeInspectorRecordSummary {\n  text: string;\n  scope: KnowledgeInspectorScopeBadge;\n  sourceThreadId: string;\n  capturedAt: string;\n  when?: string;\n}\n\nexport interface KnowledgeInspectorNodeList {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  nodes: KnowledgeInspectorNodeSummary[];\n  nextCursor?: string;\n  sort?: KnowledgeInspectorNodeSort;\n  coverage?: 'exact' | 'recent-window';\n}\n\nexport interface KnowledgeInspectorRelationshipPreview {\n  nodes: KnowledgeInspectorNodeSummary[];\n  partial: boolean;\n}\n\nexport interface KnowledgeInspectorNodeDetail {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  node: KnowledgeInspectorNodeSummary;\n  records: KnowledgeInspectorRecordSummary[];\n  recordsNextCursor?: string;\n  mentioningRecords: KnowledgeInspectorRecordSummary[];\n  mentioningRecordsNextCursor?: string;\n  outgoingTargets: KnowledgeInspectorRelationshipPreview;\n  incomingParents: KnowledgeInspectorRelationshipPreview;\n  relationshipCounts: KnowledgeInspectorRelationshipCounts;\n  content?: string;\n  contentTruncated: boolean;\n  links: Array<{ label: string; node?: KnowledgeInspectorNodeSummary }>;\n}\n\nexport interface KnowledgeInspectorActivityEvent {\n  action: KnowledgeActivityEvent['action'];\n  recordType: KnowledgeActivityEvent['recordType'];\n  scope: KnowledgeInspectorScopeBadge;\n  sourceThreadId?: string;\n  createdAt: string;\n  record?: KnowledgeInspectorNodeSummary;\n}\n\nexport interface KnowledgeInspectorActivityList {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  events: KnowledgeInspectorActivityEvent[];\n  nextCursor?: string;\n}\n\nexport interface KnowledgeInspector {\n  getScopeTree(): Promise<KnowledgeInspectorScopeTree>;\n  listNodes(input: {\n    level: KnowledgeInspectorScopeLevel;\n    namePrefix?: string;\n    kind?: string;\n    sort?: KnowledgeInspectorNodeSort;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorNodeList>;\n  getNode(input: {\n    handle: string;\n    recordsCursor?: string;\n    mentioningRecordsCursor?: string;\n    recordLimit?: number;\n  }): Promise<KnowledgeInspectorNodeDetail>;\n  listActivity(input: {\n    level: KnowledgeInspectorScopeLevel;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorActivityList>;\n}\n\nexport class KnowledgeInspectorError extends Error {\n  constructor(\n    readonly code: 'unavailable' | 'invalid-handle' | 'stale-handle' | 'invalid-cursor' | 'not-visible',\n    message: string,\n  ) {\n    super(message);\n    this.name = 'KnowledgeInspectorError';\n  }\n}\n\ninterface Binding {\n  /** Org rung shared with the subconscious writers (see knowledge-scope.ts). */\n  organizationId: string;\n  /** Resource rung of the knowledge scope: the Factory project id, else the session resource. */\n  resourceId: string;\n  threadId?: string;\n  fingerprint: string;\n  identityKey: string;\n}\n\ninterface HandleEntry {\n  identityKey: string;\n  level: KnowledgeInspectorScopeLevel;\n  type: KnowledgeInspectorRecordType;\n  recordId: string;\n  expiresAt: number;\n}\n\ninterface CursorEntry {\n  identityKey: string;\n  level: KnowledgeInspectorScopeLevel;\n  kind: 'node' | 'ranked-node' | 'records' | 'mentioning-records' | 'activity';\n  value: string;\n  filters?: { namePrefix?: string; kind?: string; sort?: KnowledgeInspectorNodeSort };\n  expiresAt: number;\n}\n\ninterface RankedNodeSnapshot {\n  offset: number;\n  entries: { id: string; degree: number; counts: KnowledgeInspectorRelationshipCounts }[];\n}\n\ninterface RelationshipRecords {\n  nodes: KnowledgeNode[];\n  truncated: boolean;\n}\n\nconst HANDLE_TTL_MS = 5 * 60_000;\nconst MAX_OPAQUE_ENTRIES = 1_000;\nconst DEFAULT_RECORD_LIMIT = 50;\nconst MAX_RECORD_LIMIT = 50;\nconst DEFAULT_FACT_LIMIT = 25;\nconst MAX_FACT_LIMIT = 100;\nconst DEFAULT_ACTIVITY_LIMIT = 20;\nconst MAX_ACTIVITY_LIMIT = 100;\nconst MAX_RELATED_RECORDS = 25;\nconst MAX_RANK_CANDIDATES = 50;\nconst MAX_RANK_FACTS = 100;\nconst RRF_K = 60;\nconst MAX_NODE_CONTENT_BYTES = 32 * 1024;\n\nfunction opaqueToken(): string {\n  return Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(24))).toString('base64url');\n}\n\nfunction boundedLimit(value: number | undefined, fallback: number, maximum: number): number {\n  if (value === undefined) return fallback;\n  if (!Number.isInteger(value) || value < 1) return fallback;\n  return Math.min(value, maximum);\n}\n\nfunction scopeBadge(scope: KnowledgeScope): KnowledgeInspectorScopeBadge {\n  const entry = scope.at(-1);\n  if (!entry) throw new KnowledgeInspectorError('unavailable', 'Knowledge record has no scope.');\n  const separator = entry.indexOf(':');\n  return {\n    level: entry.slice(0, separator) as KnowledgeInspectorScopeLevel,\n    id: entry.slice(separator + 1),\n  };\n}\n\nfunction knowledgeSummary(record: KnowledgeRecord): KnowledgeInspectorRecordSummary {\n  return {\n    text: record.text,\n    scope: scopeBadge(record.scope),\n    sourceThreadId: record.sourceThreadId,\n    capturedAt: record.capturedAt.toISOString(),\n    when: record.when?.toISOString(),\n  };\n}\n\nfunction truncateUtf8(value: string, maxBytes: number): { value: string; truncated: boolean } {\n  const encoded = Buffer.from(value);\n  if (encoded.byteLength <= maxBytes) return { value, truncated: false };\n  let end = maxBytes;\n  let truncated = encoded.subarray(0, end).toString('utf8');\n  while (Buffer.byteLength(truncated) > maxBytes) {\n    truncated = encoded.subarray(0, --end).toString('utf8');\n  }\n  return { value: truncated, truncated: true };\n}\n\nclass ScopedKnowledgeInspector implements KnowledgeInspector {\n  readonly #knowledge: KnowledgeStorage;\n  readonly #session: Session<MastraCodeState>;\n  readonly #handles = new Map<string, HandleEntry>();\n  readonly #cursors = new Map<string, CursorEntry>();\n  #fingerprint?: string;\n  #identityKey = opaqueToken();\n\n  constructor(input: { knowledge: KnowledgeStorage; session: Session<MastraCodeState> }) {\n    this.#knowledge = input.knowledge;\n    this.#session = input.session;\n    this.#session.subscribe(event => {\n      if (event.type === 'thread_changed' || event.type === 'thread_created' || event.type === 'thread_deleted') {\n        this.#invalidateIdnode();\n      }\n    });\n  }\n\n  async getScopeTree(): Promise<KnowledgeInspectorScopeTree> {\n    const binding = await this.#binding();\n    return {\n      identityKey: binding.identityKey,\n      defaultLevel: 'resource',\n      roots: [\n        { level: 'org', id: binding.organizationId, available: true },\n        { level: 'resource', id: binding.resourceId, available: true },\n        binding.threadId\n          ? { level: 'thread', id: binding.threadId, available: true }\n          : { level: 'thread', available: false, reason: 'No active thread belongs to this project.' },\n      ],\n    };\n  }\n\n  async listNodes(input: {\n    level: KnowledgeInspectorScopeLevel;\n    namePrefix?: string;\n    kind?: string;\n    sort?: KnowledgeInspectorNodeSort;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorNodeList> {\n    const binding = await this.#binding();\n    const scope = this.#scope(binding, input.level);\n    const limit = boundedLimit(input.limit, DEFAULT_RECORD_LIMIT, MAX_RECORD_LIMIT);\n    const sort = input.sort ?? 'relevant';\n    if (sort === 'recent') {\n      const cursor = this.#consumeCursor(input.cursor, binding, input.level, 'node', {\n        namePrefix: input.namePrefix,\n        kind: input.kind,\n        sort,\n      });\n      const records = await this.#knowledge.listNodes({\n        scope,\n        namePrefix: input.namePrefix,\n        kind: input.kind,\n        cursor,\n        limit,\n      });\n      const nodes: KnowledgeInspectorNodeSummary[] = await Promise.all(\n        records.map(async record => ({\n          ...this.#recordSummary(record, binding, input.level),\n          relationshipCounts: (await this.#sampledRelationshipCounts(record, scope)).counts,\n        })),\n      );\n      await this.#assertStable(binding);\n      return {\n        identityKey: binding.identityKey,\n        scopeLevel: input.level,\n        nodes,\n        nextCursor:\n          records.length === limit\n            ? this.#mintCursor(\n                binding,\n                input.level,\n                'node',\n                createKnowledgeNodeCursor(records.at(-1)!, {\n                  namePrefix: input.namePrefix,\n                  kind: input.kind,\n                }),\n                {\n                  namePrefix: input.namePrefix,\n                  kind: input.kind,\n                  sort,\n                },\n              )\n            : undefined,\n        sort,\n        coverage: 'exact',\n      };\n    }\n\n    const filters = { namePrefix: input.namePrefix, kind: input.kind, sort };\n    const encodedSnapshot = this.#consumeCursor(input.cursor, binding, input.level, 'ranked-node', filters);\n    const snapshot = encodedSnapshot\n      ? (JSON.parse(encodedSnapshot) as RankedNodeSnapshot)\n      : await this.#rankedNodeSnapshot(scope, input.namePrefix, input.kind, sort);\n    const page = snapshot.entries.slice(snapshot.offset, snapshot.offset + limit);\n    const nodes: KnowledgeInspectorNodeSummary[] = [];\n    for (const entry of page) {\n      const node = await this.#knowledge.getNode(entry.id);\n      if (!node || !isKnowledgeScopeVisible(node.scope, scope)) continue;\n      nodes.push({ ...this.#recordSummary(node, binding, input.level), relationshipCounts: entry.counts });\n    }\n    const nextOffset = snapshot.offset + limit;\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: input.level,\n      nodes,\n      nextCursor:\n        nextOffset < snapshot.entries.length\n          ? this.#mintCursor(\n              binding,\n              input.level,\n              'ranked-node',\n              JSON.stringify({ ...snapshot, offset: nextOffset } satisfies RankedNodeSnapshot),\n              filters,\n            )\n          : undefined,\n      sort,\n      coverage: 'recent-window',\n    };\n  }\n\n  async getNode(input: {\n    handle: string;\n    recordsCursor?: string;\n    mentioningRecordsCursor?: string;\n    recordLimit?: number;\n  }): Promise<KnowledgeInspectorNodeDetail> {\n    const binding = await this.#binding();\n    const handle = this.#readHandle(input.handle, binding, 'node');\n    const scope = this.#scope(binding, handle.level);\n    const node = await this.#knowledge.getNode(handle.recordId);\n    this.#assertVisible(node, scope);\n    const limit = boundedLimit(input.recordLimit, DEFAULT_FACT_LIMIT, MAX_FACT_LIMIT);\n    const recordsAfter = this.#consumeCursor(input.recordsCursor, binding, handle.level, 'records');\n    const mentioningAfter = this.#consumeCursor(\n      input.mentioningRecordsCursor,\n      binding,\n      handle.level,\n      'mentioning-records',\n    );\n    const [recordsResult, mentioningResult] = await Promise.all([\n      this.#knowledge.listKnowledgeAbout({ node: node.id, scope, after: recordsAfter, limit }),\n      this.#knowledge.listKnowledgeMentioning({ node: node.id, scope, after: mentioningAfter, limit }),\n    ]);\n    const mentioningRecords = mentioningResult.records.filter(record => record.node !== node.id);\n    const content = truncateUtf8(node.content ?? '', MAX_NODE_CONTENT_BYTES);\n    const [outgoingTargets, incomingParents, relationship] = await Promise.all([\n      this.#outgoingTargets(node, recordsResult.records, scope, binding, handle.level),\n      this.#incomingParents(node, mentioningRecords, scope, binding, handle.level),\n      this.#sampledRelationshipCounts(node, scope),\n    ]);\n    const links = await Promise.all(\n      parseKnowledgeWikilinks(content.value)\n        .slice(0, MAX_RELATED_RECORDS)\n        .map(async label => {\n          const target = await this.#knowledge.resolveNode({ name: label, scope });\n          return {\n            label,\n            node: target ? this.#recordSummary(target, binding, handle.level) : undefined,\n          };\n        }),\n    );\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: handle.level,\n      node: { ...this.#recordSummary(node, binding, handle.level), relationshipCounts: relationship.counts },\n      records: recordsResult.records.map(knowledgeSummary),\n      recordsNextCursor: recordsResult.nextCursor\n        ? this.#mintCursor(binding, handle.level, 'records', recordsResult.nextCursor)\n        : undefined,\n      mentioningRecords: mentioningRecords.map(knowledgeSummary),\n      mentioningRecordsNextCursor: mentioningResult.nextCursor\n        ? this.#mintCursor(binding, handle.level, 'mentioning-records', mentioningResult.nextCursor)\n        : undefined,\n      outgoingTargets: {\n        nodes: outgoingTargets.nodes,\n        partial: outgoingTargets.partial || Boolean(recordsResult.nextCursor),\n      },\n      incomingParents: {\n        nodes: incomingParents.nodes,\n        partial: incomingParents.partial || Boolean(mentioningResult.nextCursor),\n      },\n      relationshipCounts: relationship.counts,\n      content: node.content === undefined ? undefined : content.value,\n      contentTruncated: content.truncated,\n      links,\n    };\n  }\n\n  async listActivity(input: {\n    level: KnowledgeInspectorScopeLevel;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorActivityList> {\n    const binding = await this.#binding();\n    const scope = this.#scope(binding, input.level);\n    const limit = boundedLimit(input.limit, DEFAULT_ACTIVITY_LIMIT, MAX_ACTIVITY_LIMIT);\n    const after = this.#consumeCursor(input.cursor, binding, input.level, 'activity');\n    const events = await this.#knowledge.listActivity({ scope, after, limit });\n    const activityEvents: KnowledgeInspectorActivityEvent[] = [];\n    for (const event of events) {\n      const record = await this.#activityRecord(event, scope, binding, input.level);\n      activityEvents.push({\n        action: event.action,\n        recordType: event.recordType,\n        scope: scopeBadge(event.scope),\n        sourceThreadId: record ? event.sourceThreadId : undefined,\n        createdAt: event.createdAt.toISOString(),\n        record,\n      });\n    }\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: input.level,\n      events: activityEvents,\n      nextCursor:\n        events.length === limit ? this.#mintCursor(binding, input.level, 'activity', events.at(-1)!.id) : undefined,\n    };\n  }\n\n  async #binding(): Promise<Binding> {\n    // Scope rungs come from the same resolver the subconscious writes under; an\n    // owner id is a USER id and never names a knowledge org.\n    const identity = resolveKnowledgeScopeIdentity(this.#session.state.get());\n    const sessionResourceId = this.#session.identity.getResourceId();\n    if (!identity.resolved) {\n      // An unresolved org is its own identity: handles minted under the\n      // previous scope must not survive into whatever resolves next.\n      this.#invalidateIdnode();\n      throw new KnowledgeInspectorError(\n        'unavailable',\n        identity.reason\n          ? `Knowledge inspection unavailable: ${identity.reason}`\n          : 'Knowledge inspection requires a resolved organization for this session.',\n      );\n    }\n    if (!sessionResourceId) {\n      throw new KnowledgeInspectorError('unavailable', 'Knowledge inspection requires an active project.');\n    }\n    const organizationId = identity.organizationId;\n    const resourceId = identity.knowledgeResourceId ?? sessionResourceId;\n    const activeThreadId = this.#session.thread.getId() ?? undefined;\n    const thread = activeThreadId ? await this.#session.thread.getById({ threadId: activeThreadId }) : null;\n    const threadId = thread?.resourceId === sessionResourceId ? thread.id : undefined;\n    const fingerprint = `${organizationId}\\0${resourceId}\\0${threadId ?? ''}`;\n    if (this.#fingerprint !== fingerprint) {\n      this.#fingerprint = fingerprint;\n      this.#identityKey = opaqueToken();\n      this.#handles.clear();\n      this.#cursors.clear();\n    }\n    return { organizationId, resourceId, threadId, fingerprint, identityKey: this.#identityKey };\n  }\n\n  #scope(binding: Binding, level: KnowledgeInspectorScopeLevel): KnowledgeScope {\n    if (level === 'org') return [`org:${binding.organizationId}`];\n    const scope = [`org:${binding.organizationId}`, `resource:${binding.resourceId}`];\n    if (level === 'resource') return scope;\n    if (!binding.threadId) {\n      throw new KnowledgeInspectorError('unavailable', 'The active thread does not belong to this project.');\n    }\n    return [...scope, `thread:${binding.threadId}`];\n  }\n\n  async #assertStable(binding: Binding): Promise<void> {\n    const current = await this.#binding();\n    if (current.identityKey !== binding.identityKey || current.fingerprint !== binding.fingerprint) {\n      throw new KnowledgeInspectorError('stale-handle', 'Knowledge scope changed while the request was running.');\n    }\n  }\n\n  #assertVisible<T extends KnowledgeNode>(record: T | null, scope: KnowledgeScope): asserts record is T {\n    if (!record || !isKnowledgeScopeVisible(record.scope, scope)) {\n      throw new KnowledgeInspectorError('not-visible', 'Knowledge record is not visible in the selected scope.');\n    }\n  }\n\n  #recordSummary(\n    record: KnowledgeNode,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): KnowledgeInspectorNodeSummary {\n    const type: KnowledgeInspectorRecordType = 'node';\n    return {\n      handle: this.#mintHandle(binding, level, type, record.id),\n      type,\n      name: record.name,\n      kind: record.kind,\n      scope: scopeBadge(record.scope),\n      version: record.version,\n      updatedAt: record.updatedAt.toISOString(),\n    };\n  }\n\n  async #rankedNodeSnapshot(\n    scope: KnowledgeScope,\n    namePrefix: string | undefined,\n    kind: string | undefined,\n    sort: Exclude<KnowledgeInspectorNodeSort, 'recent'>,\n  ): Promise<RankedNodeSnapshot> {\n    const records = await this.#knowledge.listNodes({\n      scope,\n      namePrefix,\n      kind,\n      limit: MAX_RANK_CANDIDATES,\n    });\n    const ranked = await Promise.all(\n      records.map(async (node, recencyRank) => ({\n        node,\n        recencyRank,\n        ...(await this.#sampledRelationshipCounts(node, scope)),\n      })),\n    );\n    const connected = [...ranked].sort(\n      (a, b) => b.degree - a.degree || a.recencyRank - b.recencyRank || a.node.id.localeCompare(b.node.id),\n    );\n    const connectedRank = new Map(connected.map((entry, index) => [entry.node.id, index]));\n    const ordered =\n      sort === 'connected'\n        ? connected\n        : [...ranked].sort((a, b) => {\n            const aScore = 1 / (RRF_K + a.recencyRank + 1) + 1 / (RRF_K + connectedRank.get(a.node.id)! + 1);\n            const bScore = 1 / (RRF_K + b.recencyRank + 1) + 1 / (RRF_K + connectedRank.get(b.node.id)! + 1);\n            return bScore - aScore || a.recencyRank - b.recencyRank || a.node.id.localeCompare(b.node.id);\n          });\n    return {\n      offset: 0,\n      entries: ordered.map(entry => ({ id: entry.node.id, degree: entry.degree, counts: entry.counts })),\n    };\n  }\n\n  async #sampledRelationshipCounts(\n    node: KnowledgeNode,\n    scope: KnowledgeScope,\n  ): Promise<{ degree: number; counts: KnowledgeInspectorRelationshipCounts }> {\n    const [aboutResult, mentioningResult] = await Promise.all([\n      this.#knowledge.listKnowledgeAbout({ node: node.id, scope, limit: MAX_RANK_FACTS }),\n      this.#knowledge.listKnowledgeMentioning({ node: node.id, scope, limit: MAX_RANK_FACTS }),\n    ]);\n    const [outgoing, incoming] = await Promise.all([\n      this.#outgoingNodeRecords(node, aboutResult.records, scope),\n      this.#incomingParentRecords(node, mentioningResult.records, scope),\n    ]);\n    const mentioningRecords = mentioningResult.records.filter(record => record.node !== node.id);\n    const degree = new Set([...outgoing.nodes, ...incoming.nodes].map(record => record.id)).size;\n    return {\n      degree,\n      counts: {\n        records: aboutResult.records.length + mentioningRecords.length,\n        outgoing: outgoing.nodes.length,\n        incoming: incoming.nodes.length,\n        sampled: Boolean(\n          aboutResult.nextCursor || mentioningResult.nextCursor || outgoing.truncated || incoming.truncated,\n        ),\n      },\n    };\n  }\n\n  async #outgoingNodeRecords(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n  ): Promise<RelationshipRecords> {\n    const related = new Map<string, KnowledgeNode>();\n    let truncated = false;\n    const sources = [current.content ?? '', ...records.map(record => record.text)];\n    for (const source of sources) {\n      for (const name of parseKnowledgeWikilinks(source)) {\n        if (related.size >= MAX_RELATED_RECORDS) {\n          truncated = true;\n          break;\n        }\n        const node = await this.#knowledge.resolveNode({ name, scope });\n        if (node && node.id !== current.id && isKnowledgeScopeVisible(node.scope, scope)) {\n          related.set(node.id, node);\n        }\n      }\n      if (truncated) break;\n    }\n    return { nodes: [...related.values()], truncated };\n  }\n\n  async #incomingParentRecords(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n  ): Promise<RelationshipRecords> {\n    const related = new Map<string, KnowledgeNode>();\n    let truncated = false;\n    for (const record of records) {\n      if (record.node === current.id || related.has(record.node)) continue;\n      if (related.size >= MAX_RELATED_RECORDS) {\n        truncated = true;\n        break;\n      }\n      const node = await this.#knowledge.getNode(record.node);\n      if (node && isKnowledgeScopeVisible(node.scope, scope)) related.set(node.id, node);\n    }\n    return { nodes: [...related.values()], truncated };\n  }\n\n  async #outgoingTargets(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorRelationshipPreview> {\n    const related = await this.#outgoingNodeRecords(current, records, scope);\n    return {\n      nodes: related.nodes.map(node => this.#recordSummary(node, binding, level)),\n      partial: related.truncated,\n    };\n  }\n\n  async #incomingParents(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorRelationshipPreview> {\n    const related = await this.#incomingParentRecords(current, records, scope);\n    return {\n      nodes: related.nodes.map(node => this.#recordSummary(node, binding, level)),\n      partial: related.truncated,\n    };\n  }\n\n  async #activityRecord(\n    event: KnowledgeActivityEvent,\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorNodeSummary | undefined> {\n    if (event.recordType === 'node') {\n      const node = await this.#knowledge.getNode(event.recordId);\n      return node && isKnowledgeScopeVisible(node.scope, scope) ? this.#recordSummary(node, binding, level) : undefined;\n    }\n    const record = await this.#knowledge.getKnowledge({ id: event.recordId, includeDeleted: true });\n    if (!record || !isKnowledgeScopeVisible(record.scope, scope)) return undefined;\n    const node = await this.#knowledge.getNode(record.node);\n    return node && isKnowledgeScopeVisible(node.scope, scope) ? this.#recordSummary(node, binding, level) : undefined;\n  }\n\n  #mintHandle(\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    type: KnowledgeInspectorRecordType,\n    recordId: string,\n  ): string {\n    this.#pruneOpaqueEntries();\n    const token = opaqueToken();\n    this.#handles.set(token, {\n      identityKey: binding.identityKey,\n      level,\n      type,\n      recordId,\n      expiresAt: Date.now() + HANDLE_TTL_MS,\n    });\n    return token;\n  }\n\n  #readHandle(handle: string, binding: Binding, expectedType: KnowledgeInspectorRecordType): HandleEntry {\n    const entry = this.#handles.get(handle);\n    if (!entry || entry.expiresAt < Date.now() || entry.type !== expectedType) {\n      throw new KnowledgeInspectorError('invalid-handle', 'Knowledge record handle is invalid or expired.');\n    }\n    if (entry.identityKey !== binding.identityKey) {\n      throw new KnowledgeInspectorError('stale-handle', 'Knowledge record handle belongs to a previous scope.');\n    }\n    return entry;\n  }\n\n  #mintCursor(\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    kind: CursorEntry['kind'],\n    value: string,\n    filters?: CursorEntry['filters'],\n  ): string {\n    this.#pruneOpaqueEntries();\n    const token = opaqueToken();\n    this.#cursors.set(token, {\n      identityKey: binding.identityKey,\n      level,\n      kind,\n      value,\n      filters,\n      expiresAt: Date.now() + HANDLE_TTL_MS,\n    });\n    return token;\n  }\n\n  #consumeCursor(\n    cursor: string | undefined,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    kind: CursorEntry['kind'],\n    filters?: CursorEntry['filters'],\n  ): string | undefined {\n    if (!cursor) return undefined;\n    const entry = this.#cursors.get(cursor);\n    if (\n      !entry ||\n      entry.expiresAt < Date.now() ||\n      entry.identityKey !== binding.identityKey ||\n      entry.level !== level ||\n      entry.kind !== kind ||\n      entry.filters?.namePrefix !== filters?.namePrefix ||\n      entry.filters?.kind !== filters?.kind ||\n      entry.filters?.sort !== filters?.sort\n    ) {\n      throw new KnowledgeInspectorError(\n        'invalid-cursor',\n        'Knowledge cursor does not match the active scope and filters.',\n      );\n    }\n    return entry.value;\n  }\n\n  #pruneOpaqueEntries(): void {\n    const now = Date.now();\n    for (const [token, entry] of this.#handles) {\n      if (entry.expiresAt < now) this.#handles.delete(token);\n    }\n    for (const [token, entry] of this.#cursors) {\n      if (entry.expiresAt < now) this.#cursors.delete(token);\n    }\n    while (this.#handles.size + this.#cursors.size >= MAX_OPAQUE_ENTRIES) {\n      const handle = this.#handles.keys().next().value;\n      if (handle) this.#handles.delete(handle);\n      else {\n        const cursor = this.#cursors.keys().next().value;\n        if (cursor) this.#cursors.delete(cursor);\n        else break;\n      }\n    }\n  }\n\n  #invalidateIdnode(): void {\n    this.#fingerprint = undefined;\n    this.#identityKey = opaqueToken();\n    this.#handles.clear();\n    this.#cursors.clear();\n  }\n}\n\nexport async function createKnowledgeInspector(input: {\n  storage: MastraCompositeStore;\n  session: Session<MastraCodeState>;\n}): Promise<KnowledgeInspector | undefined> {\n  const knowledge = await input.storage.getStore('knowledge');\n  return knowledge ? new ScopedKnowledgeInspector({ knowledge, session: input.session }) : undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"knowledge-inspector.js","names":["#knowledge","#session","#handles","#cursors","#invalidateIdnode","#binding","#scope","#consumeCursor","#recordSummary","#sampledRelationshipCounts","#assertStable","#mintCursor","#rankedNodeSnapshot","#readHandle","#assertVisible","#outgoingTargets","#incomingParents","#activityRecord","#fingerprint","#identityKey","#mintHandle","#outgoingNodeRecords","#incomingParentRecords","#pruneOpaqueEntries"],"sources":["../src/knowledge-inspector.ts"],"sourcesContent":["import type { Session } from '@mastra/core/agent-controller';\nimport type { Knowledge } from '@mastra/core/knowledge';\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createKnowledgeNodeCursor, isKnowledgeScopeVisible, parseKnowledgeWikilinks } from '@mastra/core/storage';\nimport type {\n  KnowledgeActivityEvent,\n  KnowledgeRecord,\n  KnowledgeNode,\n  KnowledgeScope,\n  KnowledgeStorage,\n  MastraCompositeStore,\n} from '@mastra/core/storage';\n\nimport { resolveKnowledgeScopeIdentity } from './knowledge-scope.js';\nimport type { MastraCodeState } from './schema.js';\n\nexport type KnowledgeInspectorScopeLevel = 'org' | 'resource' | 'thread';\nexport type KnowledgeInspectorRecordType = 'node';\nexport type KnowledgeInspectorNodeSort = 'relevant' | 'recent' | 'connected';\n\nexport interface KnowledgeInspectorScopeRoot {\n  level: KnowledgeInspectorScopeLevel;\n  id?: string;\n  available: boolean;\n  reason?: string;\n}\n\nexport interface KnowledgeInspectorScopeTree {\n  identityKey: string;\n  defaultLevel: 'resource';\n  roots: KnowledgeInspectorScopeRoot[];\n}\n\nexport interface KnowledgeInspectorScopeBadge {\n  level: KnowledgeInspectorScopeLevel;\n  id: string;\n}\n\nexport interface KnowledgeInspectorRelationshipCounts {\n  records: number;\n  outgoing: number;\n  incoming: number;\n  sampled: boolean;\n}\n\nexport interface KnowledgeInspectorNodeSummary {\n  handle: string;\n  type: KnowledgeInspectorRecordType;\n  name: string;\n  kind?: string;\n  scope: KnowledgeInspectorScopeBadge;\n  version: number;\n  updatedAt: string;\n  relationshipCounts?: KnowledgeInspectorRelationshipCounts;\n}\n\nexport interface KnowledgeInspectorRecordSummary {\n  text: string;\n  scope: KnowledgeInspectorScopeBadge;\n  sourceThreadId: string;\n  capturedAt: string;\n  when?: string;\n}\n\nexport interface KnowledgeInspectorNodeList {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  nodes: KnowledgeInspectorNodeSummary[];\n  nextCursor?: string;\n  sort?: KnowledgeInspectorNodeSort;\n  coverage?: 'exact' | 'recent-window';\n}\n\nexport interface KnowledgeInspectorRelationshipPreview {\n  nodes: KnowledgeInspectorNodeSummary[];\n  partial: boolean;\n}\n\nexport interface KnowledgeInspectorNodeDetail {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  node: KnowledgeInspectorNodeSummary;\n  records: KnowledgeInspectorRecordSummary[];\n  recordsNextCursor?: string;\n  mentioningRecords: KnowledgeInspectorRecordSummary[];\n  mentioningRecordsNextCursor?: string;\n  outgoingTargets: KnowledgeInspectorRelationshipPreview;\n  incomingParents: KnowledgeInspectorRelationshipPreview;\n  relationshipCounts: KnowledgeInspectorRelationshipCounts;\n  content?: string;\n  contentTruncated: boolean;\n  links: Array<{ label: string; node?: KnowledgeInspectorNodeSummary }>;\n}\n\nexport interface KnowledgeInspectorActivityEvent {\n  action: KnowledgeActivityEvent['action'];\n  recordType: KnowledgeActivityEvent['recordType'];\n  scope: KnowledgeInspectorScopeBadge;\n  sourceThreadId?: string;\n  createdAt: string;\n  record?: KnowledgeInspectorNodeSummary;\n}\n\nexport interface KnowledgeInspectorActivityList {\n  identityKey: string;\n  scopeLevel: KnowledgeInspectorScopeLevel;\n  events: KnowledgeInspectorActivityEvent[];\n  nextCursor?: string;\n}\n\nexport interface KnowledgeInspector {\n  getScopeTree(): Promise<KnowledgeInspectorScopeTree>;\n  listNodes(input: {\n    level: KnowledgeInspectorScopeLevel;\n    namePrefix?: string;\n    kind?: string;\n    sort?: KnowledgeInspectorNodeSort;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorNodeList>;\n  getNode(input: {\n    handle: string;\n    recordsCursor?: string;\n    mentioningRecordsCursor?: string;\n    recordLimit?: number;\n  }): Promise<KnowledgeInspectorNodeDetail>;\n  listActivity(input: {\n    level: KnowledgeInspectorScopeLevel;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorActivityList>;\n}\n\nexport class KnowledgeInspectorError extends Error {\n  constructor(\n    readonly code: 'unavailable' | 'invalid-handle' | 'stale-handle' | 'invalid-cursor' | 'not-visible',\n    message: string,\n  ) {\n    super(message);\n    this.name = 'KnowledgeInspectorError';\n  }\n}\n\ninterface Binding {\n  /** Org rung shared with the subconscious writers (see knowledge-scope.ts). */\n  organizationId: string;\n  /** Resource rung of the knowledge scope: the Factory project id, else the session resource. */\n  resourceId: string;\n  threadId?: string;\n  fingerprint: string;\n  identityKey: string;\n}\n\ninterface HandleEntry {\n  identityKey: string;\n  level: KnowledgeInspectorScopeLevel;\n  type: KnowledgeInspectorRecordType;\n  recordId: string;\n  expiresAt: number;\n}\n\ninterface CursorEntry {\n  identityKey: string;\n  level: KnowledgeInspectorScopeLevel;\n  kind: 'node' | 'ranked-node' | 'records' | 'mentioning-records' | 'activity';\n  value: string;\n  filters?: { namePrefix?: string; kind?: string; sort?: KnowledgeInspectorNodeSort };\n  expiresAt: number;\n}\n\ninterface RankedNodeSnapshot {\n  offset: number;\n  entries: { id: string; degree: number; counts: KnowledgeInspectorRelationshipCounts }[];\n}\n\ninterface RelationshipRecords {\n  nodes: KnowledgeNode[];\n  truncated: boolean;\n}\n\nconst HANDLE_TTL_MS = 5 * 60_000;\nconst MAX_OPAQUE_ENTRIES = 1_000;\nconst DEFAULT_RECORD_LIMIT = 50;\nconst MAX_RECORD_LIMIT = 50;\nconst DEFAULT_FACT_LIMIT = 25;\nconst MAX_FACT_LIMIT = 100;\nconst DEFAULT_ACTIVITY_LIMIT = 20;\nconst MAX_ACTIVITY_LIMIT = 100;\nconst MAX_RELATED_RECORDS = 25;\nconst MAX_RANK_CANDIDATES = 50;\nconst MAX_RANK_FACTS = 100;\nconst RRF_K = 60;\nconst MAX_NODE_CONTENT_BYTES = 32 * 1024;\n\nfunction opaqueToken(): string {\n  return Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(24))).toString('base64url');\n}\n\nfunction boundedLimit(value: number | undefined, fallback: number, maximum: number): number {\n  if (value === undefined) return fallback;\n  if (!Number.isInteger(value) || value < 1) return fallback;\n  return Math.min(value, maximum);\n}\n\nfunction scopeBadge(scope: KnowledgeScope): KnowledgeInspectorScopeBadge {\n  const entry = scope.at(-1);\n  if (!entry) throw new KnowledgeInspectorError('unavailable', 'Knowledge record has no scope.');\n  const separator = entry.indexOf(':');\n  return {\n    level: entry.slice(0, separator) as KnowledgeInspectorScopeLevel,\n    id: entry.slice(separator + 1),\n  };\n}\n\nfunction knowledgeSummary(record: KnowledgeRecord): KnowledgeInspectorRecordSummary {\n  return {\n    text: record.text,\n    scope: scopeBadge(record.scope),\n    sourceThreadId: record.sourceThreadId,\n    capturedAt: record.capturedAt.toISOString(),\n    when: record.when?.toISOString(),\n  };\n}\n\nfunction truncateUtf8(value: string, maxBytes: number): { value: string; truncated: boolean } {\n  const encoded = Buffer.from(value);\n  if (encoded.byteLength <= maxBytes) return { value, truncated: false };\n  let end = maxBytes;\n  let truncated = encoded.subarray(0, end).toString('utf8');\n  while (Buffer.byteLength(truncated) > maxBytes) {\n    truncated = encoded.subarray(0, --end).toString('utf8');\n  }\n  return { value: truncated, truncated: true };\n}\n\nclass ScopedKnowledgeInspector implements KnowledgeInspector {\n  readonly #knowledge: KnowledgeStorage;\n  readonly #session: Session<MastraCodeState>;\n  readonly #handles = new Map<string, HandleEntry>();\n  readonly #cursors = new Map<string, CursorEntry>();\n  #fingerprint?: string;\n  #identityKey = opaqueToken();\n\n  constructor(input: { knowledge: KnowledgeStorage; session: Session<MastraCodeState> }) {\n    this.#knowledge = input.knowledge;\n    this.#session = input.session;\n    this.#session.subscribe(event => {\n      if (event.type === 'thread_changed' || event.type === 'thread_created' || event.type === 'thread_deleted') {\n        this.#invalidateIdnode();\n      }\n    });\n  }\n\n  async getScopeTree(): Promise<KnowledgeInspectorScopeTree> {\n    const binding = await this.#binding();\n    return {\n      identityKey: binding.identityKey,\n      defaultLevel: 'resource',\n      roots: [\n        { level: 'org', id: binding.organizationId, available: true },\n        { level: 'resource', id: binding.resourceId, available: true },\n        binding.threadId\n          ? { level: 'thread', id: binding.threadId, available: true }\n          : { level: 'thread', available: false, reason: 'No active thread belongs to this project.' },\n      ],\n    };\n  }\n\n  async listNodes(input: {\n    level: KnowledgeInspectorScopeLevel;\n    namePrefix?: string;\n    kind?: string;\n    sort?: KnowledgeInspectorNodeSort;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorNodeList> {\n    const binding = await this.#binding();\n    const scope = this.#scope(binding, input.level);\n    const limit = boundedLimit(input.limit, DEFAULT_RECORD_LIMIT, MAX_RECORD_LIMIT);\n    const sort = input.sort ?? 'relevant';\n    if (sort === 'recent') {\n      const cursor = this.#consumeCursor(input.cursor, binding, input.level, 'node', {\n        namePrefix: input.namePrefix,\n        kind: input.kind,\n        sort,\n      });\n      const records = await this.#knowledge.listNodes({\n        scope,\n        namePrefix: input.namePrefix,\n        kind: input.kind,\n        cursor,\n        limit,\n      });\n      const nodes: KnowledgeInspectorNodeSummary[] = await Promise.all(\n        records.map(async record => ({\n          ...this.#recordSummary(record, binding, input.level),\n          relationshipCounts: (await this.#sampledRelationshipCounts(record, scope)).counts,\n        })),\n      );\n      await this.#assertStable(binding);\n      return {\n        identityKey: binding.identityKey,\n        scopeLevel: input.level,\n        nodes,\n        nextCursor:\n          records.length === limit\n            ? this.#mintCursor(\n                binding,\n                input.level,\n                'node',\n                createKnowledgeNodeCursor(records.at(-1)!, {\n                  namePrefix: input.namePrefix,\n                  kind: input.kind,\n                }),\n                {\n                  namePrefix: input.namePrefix,\n                  kind: input.kind,\n                  sort,\n                },\n              )\n            : undefined,\n        sort,\n        coverage: 'exact',\n      };\n    }\n\n    const filters = { namePrefix: input.namePrefix, kind: input.kind, sort };\n    const encodedSnapshot = this.#consumeCursor(input.cursor, binding, input.level, 'ranked-node', filters);\n    const snapshot = encodedSnapshot\n      ? (JSON.parse(encodedSnapshot) as RankedNodeSnapshot)\n      : await this.#rankedNodeSnapshot(scope, input.namePrefix, input.kind, sort);\n    const page = snapshot.entries.slice(snapshot.offset, snapshot.offset + limit);\n    const nodes: KnowledgeInspectorNodeSummary[] = [];\n    for (const entry of page) {\n      const node = await this.#knowledge.getNode(entry.id);\n      if (!node || !isKnowledgeScopeVisible(node.scope, scope)) continue;\n      nodes.push({ ...this.#recordSummary(node, binding, input.level), relationshipCounts: entry.counts });\n    }\n    const nextOffset = snapshot.offset + limit;\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: input.level,\n      nodes,\n      nextCursor:\n        nextOffset < snapshot.entries.length\n          ? this.#mintCursor(\n              binding,\n              input.level,\n              'ranked-node',\n              JSON.stringify({ ...snapshot, offset: nextOffset } satisfies RankedNodeSnapshot),\n              filters,\n            )\n          : undefined,\n      sort,\n      coverage: 'recent-window',\n    };\n  }\n\n  async getNode(input: {\n    handle: string;\n    recordsCursor?: string;\n    mentioningRecordsCursor?: string;\n    recordLimit?: number;\n  }): Promise<KnowledgeInspectorNodeDetail> {\n    const binding = await this.#binding();\n    const handle = this.#readHandle(input.handle, binding, 'node');\n    const scope = this.#scope(binding, handle.level);\n    const node = await this.#knowledge.getNode(handle.recordId);\n    this.#assertVisible(node, scope);\n    const limit = boundedLimit(input.recordLimit, DEFAULT_FACT_LIMIT, MAX_FACT_LIMIT);\n    const recordsAfter = this.#consumeCursor(input.recordsCursor, binding, handle.level, 'records');\n    const mentioningAfter = this.#consumeCursor(\n      input.mentioningRecordsCursor,\n      binding,\n      handle.level,\n      'mentioning-records',\n    );\n    const [recordsResult, mentioningResult] = await Promise.all([\n      this.#knowledge.listKnowledgeAbout({ node: node.id, scope, after: recordsAfter, limit }),\n      this.#knowledge.listKnowledgeMentioning({ node: node.id, scope, after: mentioningAfter, limit }),\n    ]);\n    const mentioningRecords = mentioningResult.records.filter(record => record.node !== node.id);\n    const content = truncateUtf8(node.content ?? '', MAX_NODE_CONTENT_BYTES);\n    const [outgoingTargets, incomingParents, relationship] = await Promise.all([\n      this.#outgoingTargets(node, recordsResult.records, scope, binding, handle.level),\n      this.#incomingParents(node, mentioningRecords, scope, binding, handle.level),\n      this.#sampledRelationshipCounts(node, scope),\n    ]);\n    const links = await Promise.all(\n      parseKnowledgeWikilinks(content.value)\n        .slice(0, MAX_RELATED_RECORDS)\n        .map(async label => {\n          const target = await this.#knowledge.resolveNode({ name: label, scope });\n          return {\n            label,\n            node: target ? this.#recordSummary(target, binding, handle.level) : undefined,\n          };\n        }),\n    );\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: handle.level,\n      node: { ...this.#recordSummary(node, binding, handle.level), relationshipCounts: relationship.counts },\n      records: recordsResult.records.map(knowledgeSummary),\n      recordsNextCursor: recordsResult.nextCursor\n        ? this.#mintCursor(binding, handle.level, 'records', recordsResult.nextCursor)\n        : undefined,\n      mentioningRecords: mentioningRecords.map(knowledgeSummary),\n      mentioningRecordsNextCursor: mentioningResult.nextCursor\n        ? this.#mintCursor(binding, handle.level, 'mentioning-records', mentioningResult.nextCursor)\n        : undefined,\n      outgoingTargets: {\n        nodes: outgoingTargets.nodes,\n        partial: outgoingTargets.partial || Boolean(recordsResult.nextCursor),\n      },\n      incomingParents: {\n        nodes: incomingParents.nodes,\n        partial: incomingParents.partial || Boolean(mentioningResult.nextCursor),\n      },\n      relationshipCounts: relationship.counts,\n      content: node.content === undefined ? undefined : content.value,\n      contentTruncated: content.truncated,\n      links,\n    };\n  }\n\n  async listActivity(input: {\n    level: KnowledgeInspectorScopeLevel;\n    cursor?: string;\n    limit?: number;\n  }): Promise<KnowledgeInspectorActivityList> {\n    const binding = await this.#binding();\n    const scope = this.#scope(binding, input.level);\n    const limit = boundedLimit(input.limit, DEFAULT_ACTIVITY_LIMIT, MAX_ACTIVITY_LIMIT);\n    const after = this.#consumeCursor(input.cursor, binding, input.level, 'activity');\n    const events = await this.#knowledge.listActivity({ scope, after, limit });\n    const activityEvents: KnowledgeInspectorActivityEvent[] = [];\n    for (const event of events) {\n      const record = await this.#activityRecord(event, scope, binding, input.level);\n      activityEvents.push({\n        action: event.action,\n        recordType: event.recordType,\n        scope: scopeBadge(event.scope),\n        sourceThreadId: record ? event.sourceThreadId : undefined,\n        createdAt: event.createdAt.toISOString(),\n        record,\n      });\n    }\n    await this.#assertStable(binding);\n    return {\n      identityKey: binding.identityKey,\n      scopeLevel: input.level,\n      events: activityEvents,\n      nextCursor:\n        events.length === limit ? this.#mintCursor(binding, input.level, 'activity', events.at(-1)!.id) : undefined,\n    };\n  }\n\n  async #binding(): Promise<Binding> {\n    // Scope rungs come from the same resolver the subconscious writes under; an\n    // owner id is a USER id and never names a knowledge org.\n    const identity = resolveKnowledgeScopeIdentity(this.#session.state.get());\n    const sessionResourceId = this.#session.identity.getResourceId();\n    if (!identity.resolved) {\n      // An unresolved org is its own identity: handles minted under the\n      // previous scope must not survive into whatever resolves next.\n      this.#invalidateIdnode();\n      throw new KnowledgeInspectorError(\n        'unavailable',\n        identity.reason\n          ? `Knowledge inspection unavailable: ${identity.reason}`\n          : 'Knowledge inspection requires a resolved organization for this session.',\n      );\n    }\n    if (!sessionResourceId) {\n      throw new KnowledgeInspectorError('unavailable', 'Knowledge inspection requires an active project.');\n    }\n    const organizationId = identity.organizationId;\n    const resourceId = identity.knowledgeResourceId ?? sessionResourceId;\n    const activeThreadId = this.#session.thread.getId() ?? undefined;\n    const thread = activeThreadId ? await this.#session.thread.getById({ threadId: activeThreadId }) : null;\n    const threadId = thread?.resourceId === sessionResourceId ? thread.id : undefined;\n    const fingerprint = `${organizationId}\\0${resourceId}\\0${threadId ?? ''}`;\n    if (this.#fingerprint !== fingerprint) {\n      this.#fingerprint = fingerprint;\n      this.#identityKey = opaqueToken();\n      this.#handles.clear();\n      this.#cursors.clear();\n    }\n    return { organizationId, resourceId, threadId, fingerprint, identityKey: this.#identityKey };\n  }\n\n  #scope(binding: Binding, level: KnowledgeInspectorScopeLevel): KnowledgeScope {\n    if (level === 'org') return [`org:${binding.organizationId}`];\n    const scope = [`org:${binding.organizationId}`, `resource:${binding.resourceId}`];\n    if (level === 'resource') return scope;\n    if (!binding.threadId) {\n      throw new KnowledgeInspectorError('unavailable', 'The active thread does not belong to this project.');\n    }\n    return [...scope, `thread:${binding.threadId}`];\n  }\n\n  async #assertStable(binding: Binding): Promise<void> {\n    const current = await this.#binding();\n    if (current.identityKey !== binding.identityKey || current.fingerprint !== binding.fingerprint) {\n      throw new KnowledgeInspectorError('stale-handle', 'Knowledge scope changed while the request was running.');\n    }\n  }\n\n  #assertVisible<T extends KnowledgeNode>(record: T | null, scope: KnowledgeScope): asserts record is T {\n    if (!record || !isKnowledgeScopeVisible(record.scope, scope)) {\n      throw new KnowledgeInspectorError('not-visible', 'Knowledge record is not visible in the selected scope.');\n    }\n  }\n\n  #recordSummary(\n    record: KnowledgeNode,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): KnowledgeInspectorNodeSummary {\n    const type: KnowledgeInspectorRecordType = 'node';\n    return {\n      handle: this.#mintHandle(binding, level, type, record.id),\n      type,\n      name: record.name,\n      kind: record.kind,\n      scope: scopeBadge(record.scope),\n      version: record.version,\n      updatedAt: record.updatedAt.toISOString(),\n    };\n  }\n\n  async #rankedNodeSnapshot(\n    scope: KnowledgeScope,\n    namePrefix: string | undefined,\n    kind: string | undefined,\n    sort: Exclude<KnowledgeInspectorNodeSort, 'recent'>,\n  ): Promise<RankedNodeSnapshot> {\n    const records = await this.#knowledge.listNodes({\n      scope,\n      namePrefix,\n      kind,\n      limit: MAX_RANK_CANDIDATES,\n    });\n    const ranked = await Promise.all(\n      records.map(async (node, recencyRank) => ({\n        node,\n        recencyRank,\n        ...(await this.#sampledRelationshipCounts(node, scope)),\n      })),\n    );\n    const connected = [...ranked].sort(\n      (a, b) => b.degree - a.degree || a.recencyRank - b.recencyRank || a.node.id.localeCompare(b.node.id),\n    );\n    const connectedRank = new Map(connected.map((entry, index) => [entry.node.id, index]));\n    const ordered =\n      sort === 'connected'\n        ? connected\n        : [...ranked].sort((a, b) => {\n            const aScore = 1 / (RRF_K + a.recencyRank + 1) + 1 / (RRF_K + connectedRank.get(a.node.id)! + 1);\n            const bScore = 1 / (RRF_K + b.recencyRank + 1) + 1 / (RRF_K + connectedRank.get(b.node.id)! + 1);\n            return bScore - aScore || a.recencyRank - b.recencyRank || a.node.id.localeCompare(b.node.id);\n          });\n    return {\n      offset: 0,\n      entries: ordered.map(entry => ({ id: entry.node.id, degree: entry.degree, counts: entry.counts })),\n    };\n  }\n\n  async #sampledRelationshipCounts(\n    node: KnowledgeNode,\n    scope: KnowledgeScope,\n  ): Promise<{ degree: number; counts: KnowledgeInspectorRelationshipCounts }> {\n    const [aboutResult, mentioningResult] = await Promise.all([\n      this.#knowledge.listKnowledgeAbout({ node: node.id, scope, limit: MAX_RANK_FACTS }),\n      this.#knowledge.listKnowledgeMentioning({ node: node.id, scope, limit: MAX_RANK_FACTS }),\n    ]);\n    const [outgoing, incoming] = await Promise.all([\n      this.#outgoingNodeRecords(node, aboutResult.records, scope),\n      this.#incomingParentRecords(node, mentioningResult.records, scope),\n    ]);\n    const mentioningRecords = mentioningResult.records.filter(record => record.node !== node.id);\n    const degree = new Set([...outgoing.nodes, ...incoming.nodes].map(record => record.id)).size;\n    return {\n      degree,\n      counts: {\n        records: aboutResult.records.length + mentioningRecords.length,\n        outgoing: outgoing.nodes.length,\n        incoming: incoming.nodes.length,\n        sampled: Boolean(\n          aboutResult.nextCursor || mentioningResult.nextCursor || outgoing.truncated || incoming.truncated,\n        ),\n      },\n    };\n  }\n\n  async #outgoingNodeRecords(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n  ): Promise<RelationshipRecords> {\n    const related = new Map<string, KnowledgeNode>();\n    let truncated = false;\n    const sources = [current.content ?? '', ...records.map(record => record.text)];\n    for (const source of sources) {\n      for (const name of parseKnowledgeWikilinks(source)) {\n        if (related.size >= MAX_RELATED_RECORDS) {\n          truncated = true;\n          break;\n        }\n        const node = await this.#knowledge.resolveNode({ name, scope });\n        if (node && node.id !== current.id && isKnowledgeScopeVisible(node.scope, scope)) {\n          related.set(node.id, node);\n        }\n      }\n      if (truncated) break;\n    }\n    return { nodes: [...related.values()], truncated };\n  }\n\n  async #incomingParentRecords(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n  ): Promise<RelationshipRecords> {\n    const related = new Map<string, KnowledgeNode>();\n    let truncated = false;\n    for (const record of records) {\n      if (record.node === current.id || related.has(record.node)) continue;\n      if (related.size >= MAX_RELATED_RECORDS) {\n        truncated = true;\n        break;\n      }\n      const node = await this.#knowledge.getNode(record.node);\n      if (node && isKnowledgeScopeVisible(node.scope, scope)) related.set(node.id, node);\n    }\n    return { nodes: [...related.values()], truncated };\n  }\n\n  async #outgoingTargets(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorRelationshipPreview> {\n    const related = await this.#outgoingNodeRecords(current, records, scope);\n    return {\n      nodes: related.nodes.map(node => this.#recordSummary(node, binding, level)),\n      partial: related.truncated,\n    };\n  }\n\n  async #incomingParents(\n    current: KnowledgeNode,\n    records: KnowledgeRecord[],\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorRelationshipPreview> {\n    const related = await this.#incomingParentRecords(current, records, scope);\n    return {\n      nodes: related.nodes.map(node => this.#recordSummary(node, binding, level)),\n      partial: related.truncated,\n    };\n  }\n\n  async #activityRecord(\n    event: KnowledgeActivityEvent,\n    scope: KnowledgeScope,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n  ): Promise<KnowledgeInspectorNodeSummary | undefined> {\n    if (event.recordType === 'node') {\n      const node = await this.#knowledge.getNode(event.recordId);\n      return node && isKnowledgeScopeVisible(node.scope, scope) ? this.#recordSummary(node, binding, level) : undefined;\n    }\n    const record = await this.#knowledge.getKnowledge({ id: event.recordId, includeDeleted: true });\n    if (!record || !isKnowledgeScopeVisible(record.scope, scope)) return undefined;\n    const node = await this.#knowledge.getNode(record.node);\n    return node && isKnowledgeScopeVisible(node.scope, scope) ? this.#recordSummary(node, binding, level) : undefined;\n  }\n\n  #mintHandle(\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    type: KnowledgeInspectorRecordType,\n    recordId: string,\n  ): string {\n    this.#pruneOpaqueEntries();\n    const token = opaqueToken();\n    this.#handles.set(token, {\n      identityKey: binding.identityKey,\n      level,\n      type,\n      recordId,\n      expiresAt: Date.now() + HANDLE_TTL_MS,\n    });\n    return token;\n  }\n\n  #readHandle(handle: string, binding: Binding, expectedType: KnowledgeInspectorRecordType): HandleEntry {\n    const entry = this.#handles.get(handle);\n    if (!entry || entry.expiresAt < Date.now() || entry.type !== expectedType) {\n      throw new KnowledgeInspectorError('invalid-handle', 'Knowledge record handle is invalid or expired.');\n    }\n    if (entry.identityKey !== binding.identityKey) {\n      throw new KnowledgeInspectorError('stale-handle', 'Knowledge record handle belongs to a previous scope.');\n    }\n    return entry;\n  }\n\n  #mintCursor(\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    kind: CursorEntry['kind'],\n    value: string,\n    filters?: CursorEntry['filters'],\n  ): string {\n    this.#pruneOpaqueEntries();\n    const token = opaqueToken();\n    this.#cursors.set(token, {\n      identityKey: binding.identityKey,\n      level,\n      kind,\n      value,\n      filters,\n      expiresAt: Date.now() + HANDLE_TTL_MS,\n    });\n    return token;\n  }\n\n  #consumeCursor(\n    cursor: string | undefined,\n    binding: Binding,\n    level: KnowledgeInspectorScopeLevel,\n    kind: CursorEntry['kind'],\n    filters?: CursorEntry['filters'],\n  ): string | undefined {\n    if (!cursor) return undefined;\n    const entry = this.#cursors.get(cursor);\n    if (\n      !entry ||\n      entry.expiresAt < Date.now() ||\n      entry.identityKey !== binding.identityKey ||\n      entry.level !== level ||\n      entry.kind !== kind ||\n      entry.filters?.namePrefix !== filters?.namePrefix ||\n      entry.filters?.kind !== filters?.kind ||\n      entry.filters?.sort !== filters?.sort\n    ) {\n      throw new KnowledgeInspectorError(\n        'invalid-cursor',\n        'Knowledge cursor does not match the active scope and filters.',\n      );\n    }\n    return entry.value;\n  }\n\n  #pruneOpaqueEntries(): void {\n    const now = Date.now();\n    for (const [token, entry] of this.#handles) {\n      if (entry.expiresAt < now) this.#handles.delete(token);\n    }\n    for (const [token, entry] of this.#cursors) {\n      if (entry.expiresAt < now) this.#cursors.delete(token);\n    }\n    while (this.#handles.size + this.#cursors.size >= MAX_OPAQUE_ENTRIES) {\n      const handle = this.#handles.keys().next().value;\n      if (handle) this.#handles.delete(handle);\n      else {\n        const cursor = this.#cursors.keys().next().value;\n        if (cursor) this.#cursors.delete(cursor);\n        else break;\n      }\n    }\n  }\n\n  #invalidateIdnode(): void {\n    this.#fingerprint = undefined;\n    this.#identityKey = opaqueToken();\n    this.#handles.clear();\n    this.#cursors.clear();\n  }\n}\n\nexport async function createKnowledgeInspector(input: {\n  storage: MastraCompositeStore;\n  knowledge?: Knowledge | string;\n  mastra?: Pick<Mastra, 'getKnowledge'>;\n  session: Session<MastraCodeState>;\n}): Promise<KnowledgeInspector | undefined> {\n  let selected: Knowledge | undefined;\n  if (typeof input.knowledge === 'string') {\n    try {\n      selected = input.mastra?.getKnowledge(input.knowledge);\n    } catch {\n      throw new KnowledgeInspectorError('unavailable', 'The configured Knowledge runtime is unavailable.');\n    }\n    if (!selected) {\n      throw new KnowledgeInspectorError('unavailable', 'The configured Knowledge runtime is unavailable.');\n    }\n  } else {\n    selected = input.knowledge;\n  }\n  const knowledge = selected ? await selected.getStorage() : await input.storage.getStore('knowledge');\n  return knowledge ? new ScopedKnowledgeInspector({ knowledge, session: input.session }) : undefined;\n}\n"],"mappings":";;;AAqIA,IAAa,0BAAb,cAA6C,MAAM;CAEtC;CADX,YACE,MACA,SACA;EACA,MAAM,OAAO;EAHJ,KAAA,OAAA;EAIT,KAAK,OAAO;CACd;AACF;AAuCA,MAAM,gBAAgB,IAAI;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,uBAAuB;AAC7B,MAAM,mBAAmB;AACzB,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,yBAAyB;AAC/B,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;AACvB,MAAM,QAAQ;AACd,MAAM,yBAAyB,KAAK;AAEpC,SAAS,cAAsB;CAC7B,OAAO,OAAO,KAAK,WAAW,OAAO,gCAAgB,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW;AAChG;AAEA,SAAS,aAAa,OAA2B,UAAkB,SAAyB;CAC1F,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG,OAAO;CAClD,OAAO,KAAK,IAAI,OAAO,OAAO;AAChC;AAEA,SAAS,WAAW,OAAqD;CACvE,MAAM,QAAQ,MAAM,GAAG,EAAE;CACzB,IAAI,CAAC,OAAO,MAAM,IAAI,wBAAwB,eAAe,gCAAgC;CAC7F,MAAM,YAAY,MAAM,QAAQ,GAAG;CACnC,OAAO;EACL,OAAO,MAAM,MAAM,GAAG,SAAS;EAC/B,IAAI,MAAM,MAAM,YAAY,CAAC;CAC/B;AACF;AAEA,SAAS,iBAAiB,QAA0D;CAClF,OAAO;EACL,MAAM,OAAO;EACb,OAAO,WAAW,OAAO,KAAK;EAC9B,gBAAgB,OAAO;EACvB,YAAY,OAAO,WAAW,YAAY;EAC1C,MAAM,OAAO,MAAM,YAAY;CACjC;AACF;AAEA,SAAS,aAAa,OAAe,UAAyD;CAC5F,MAAM,UAAU,OAAO,KAAK,KAAK;CACjC,IAAI,QAAQ,cAAc,UAAU,OAAO;EAAE;EAAO,WAAW;CAAM;CACrE,IAAI,MAAM;CACV,IAAI,YAAY,QAAQ,SAAS,GAAG,GAAG,CAAC,CAAC,SAAS,MAAM;CACxD,OAAO,OAAO,WAAW,SAAS,IAAI,UACpC,YAAY,QAAQ,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,MAAM;CAExD,OAAO;EAAE,OAAO;EAAW,WAAW;CAAK;AAC7C;AAEA,IAAM,2BAAN,MAA6D;CAC3D;CACA;CACA,2BAAoB,IAAI,IAAyB;CACjD,2BAAoB,IAAI,IAAyB;CACjD;CACA,eAAe,YAAY;CAE3B,YAAY,OAA2E;EACrF,KAAKA,aAAa,MAAM;EACxB,KAAKC,WAAW,MAAM;EACtB,KAAKA,SAAS,WAAU,UAAS;GAC/B,IAAI,MAAM,SAAS,oBAAoB,MAAM,SAAS,oBAAoB,MAAM,SAAS,kBACvF,KAAKG,kBAAkB;EAE3B,CAAC;CACH;CAEA,MAAM,eAAqD;EACzD,MAAM,UAAU,MAAM,KAAKC,SAAS;EACpC,OAAO;GACL,aAAa,QAAQ;GACrB,cAAc;GACd,OAAO;IACL;KAAE,OAAO;KAAO,IAAI,QAAQ;KAAgB,WAAW;IAAK;IAC5D;KAAE,OAAO;KAAY,IAAI,QAAQ;KAAY,WAAW;IAAK;IAC7D,QAAQ,WACJ;KAAE,OAAO;KAAU,IAAI,QAAQ;KAAU,WAAW;IAAK,IACzD;KAAE,OAAO;KAAU,WAAW;KAAO,QAAQ;IAA4C;GAC/F;EACF;CACF;CAEA,MAAM,UAAU,OAOwB;EACtC,MAAM,UAAU,MAAM,KAAKA,SAAS;EACpC,MAAM,QAAQ,KAAKC,OAAO,SAAS,MAAM,KAAK;EAC9C,MAAM,QAAQ,aAAa,MAAM,OAAO,sBAAsB,gBAAgB;EAC9E,MAAM,OAAO,MAAM,QAAQ;EAC3B,IAAI,SAAS,UAAU;GACrB,MAAM,SAAS,KAAKC,eAAe,MAAM,QAAQ,SAAS,MAAM,OAAO,QAAQ;IAC7E,YAAY,MAAM;IAClB,MAAM,MAAM;IACZ;GACF,CAAC;GACD,MAAM,UAAU,MAAM,KAAKP,WAAW,UAAU;IAC9C;IACA,YAAY,MAAM;IAClB,MAAM,MAAM;IACZ;IACA;GACF,CAAC;GACD,MAAM,QAAyC,MAAM,QAAQ,IAC3D,QAAQ,IAAI,OAAM,YAAW;IAC3B,GAAG,KAAKQ,eAAe,QAAQ,SAAS,MAAM,KAAK;IACnD,qBAAqB,MAAM,KAAKC,2BAA2B,QAAQ,KAAK,EAAA,CAAG;GAC7E,EAAE,CACJ;GACA,MAAM,KAAKC,cAAc,OAAO;GAChC,OAAO;IACL,aAAa,QAAQ;IACrB,YAAY,MAAM;IAClB;IACA,YACE,QAAQ,WAAW,QACf,KAAKC,YACH,SACA,MAAM,OACN,QACA,0BAA0B,QAAQ,GAAG,EAAE,GAAI;KACzC,YAAY,MAAM;KAClB,MAAM,MAAM;IACd,CAAC,GACD;KACE,YAAY,MAAM;KAClB,MAAM,MAAM;KACZ;IACF,CACF,IACA,KAAA;IACN;IACA,UAAU;GACZ;EACF;EAEA,MAAM,UAAU;GAAE,YAAY,MAAM;GAAY,MAAM,MAAM;GAAM;EAAK;EACvE,MAAM,kBAAkB,KAAKJ,eAAe,MAAM,QAAQ,SAAS,MAAM,OAAO,eAAe,OAAO;EACtG,MAAM,WAAW,kBACZ,KAAK,MAAM,eAAe,IAC3B,MAAM,KAAKK,oBAAoB,OAAO,MAAM,YAAY,MAAM,MAAM,IAAI;EAC5E,MAAM,OAAO,SAAS,QAAQ,MAAM,SAAS,QAAQ,SAAS,SAAS,KAAK;EAC5E,MAAM,QAAyC,CAAC;EAChD,KAAK,MAAM,SAAS,MAAM;GACxB,MAAM,OAAO,MAAM,KAAKZ,WAAW,QAAQ,MAAM,EAAE;GACnD,IAAI,CAAC,QAAQ,CAAC,wBAAwB,KAAK,OAAO,KAAK,GAAG;GAC1D,MAAM,KAAK;IAAE,GAAG,KAAKQ,eAAe,MAAM,SAAS,MAAM,KAAK;IAAG,oBAAoB,MAAM;GAAO,CAAC;EACrG;EACA,MAAM,aAAa,SAAS,SAAS;EACrC,MAAM,KAAKE,cAAc,OAAO;EAChC,OAAO;GACL,aAAa,QAAQ;GACrB,YAAY,MAAM;GAClB;GACA,YACE,aAAa,SAAS,QAAQ,SAC1B,KAAKC,YACH,SACA,MAAM,OACN,eACA,KAAK,UAAU;IAAE,GAAG;IAAU,QAAQ;GAAW,CAA8B,GAC/E,OACF,IACA,KAAA;GACN;GACA,UAAU;EACZ;CACF;CAEA,MAAM,QAAQ,OAK4B;EACxC,MAAM,UAAU,MAAM,KAAKN,SAAS;EACpC,MAAM,SAAS,KAAKQ,YAAY,MAAM,QAAQ,SAAS,MAAM;EAC7D,MAAM,QAAQ,KAAKP,OAAO,SAAS,OAAO,KAAK;EAC/C,MAAM,OAAO,MAAM,KAAKN,WAAW,QAAQ,OAAO,QAAQ;EAC1D,KAAKc,eAAe,MAAM,KAAK;EAC/B,MAAM,QAAQ,aAAa,MAAM,aAAa,oBAAoB,cAAc;EAChF,MAAM,eAAe,KAAKP,eAAe,MAAM,eAAe,SAAS,OAAO,OAAO,SAAS;EAC9F,MAAM,kBAAkB,KAAKA,eAC3B,MAAM,yBACN,SACA,OAAO,OACP,oBACF;EACA,MAAM,CAAC,eAAe,oBAAoB,MAAM,QAAQ,IAAI,CAC1D,KAAKP,WAAW,mBAAmB;GAAE,MAAM,KAAK;GAAI;GAAO,OAAO;GAAc;EAAM,CAAC,GACvF,KAAKA,WAAW,wBAAwB;GAAE,MAAM,KAAK;GAAI;GAAO,OAAO;GAAiB;EAAM,CAAC,CACjG,CAAC;EACD,MAAM,oBAAoB,iBAAiB,QAAQ,QAAO,WAAU,OAAO,SAAS,KAAK,EAAE;EAC3F,MAAM,UAAU,aAAa,KAAK,WAAW,IAAI,sBAAsB;EACvE,MAAM,CAAC,iBAAiB,iBAAiB,gBAAgB,MAAM,QAAQ,IAAI;GACzE,KAAKe,iBAAiB,MAAM,cAAc,SAAS,OAAO,SAAS,OAAO,KAAK;GAC/E,KAAKC,iBAAiB,MAAM,mBAAmB,OAAO,SAAS,OAAO,KAAK;GAC3E,KAAKP,2BAA2B,MAAM,KAAK;EAC7C,CAAC;EACD,MAAM,QAAQ,MAAM,QAAQ,IAC1B,wBAAwB,QAAQ,KAAK,CAAC,CACnC,MAAM,GAAG,mBAAmB,CAAC,CAC7B,IAAI,OAAM,UAAS;GAClB,MAAM,SAAS,MAAM,KAAKT,WAAW,YAAY;IAAE,MAAM;IAAO;GAAM,CAAC;GACvE,OAAO;IACL;IACA,MAAM,SAAS,KAAKQ,eAAe,QAAQ,SAAS,OAAO,KAAK,IAAI,KAAA;GACtE;EACF,CAAC,CACL;EACA,MAAM,KAAKE,cAAc,OAAO;EAChC,OAAO;GACL,aAAa,QAAQ;GACrB,YAAY,OAAO;GACnB,MAAM;IAAE,GAAG,KAAKF,eAAe,MAAM,SAAS,OAAO,KAAK;IAAG,oBAAoB,aAAa;GAAO;GACrG,SAAS,cAAc,QAAQ,IAAI,gBAAgB;GACnD,mBAAmB,cAAc,aAC7B,KAAKG,YAAY,SAAS,OAAO,OAAO,WAAW,cAAc,UAAU,IAC3E,KAAA;GACJ,mBAAmB,kBAAkB,IAAI,gBAAgB;GACzD,6BAA6B,iBAAiB,aAC1C,KAAKA,YAAY,SAAS,OAAO,OAAO,sBAAsB,iBAAiB,UAAU,IACzF,KAAA;GACJ,iBAAiB;IACf,OAAO,gBAAgB;IACvB,SAAS,gBAAgB,WAAW,QAAQ,cAAc,UAAU;GACtE;GACA,iBAAiB;IACf,OAAO,gBAAgB;IACvB,SAAS,gBAAgB,WAAW,QAAQ,iBAAiB,UAAU;GACzE;GACA,oBAAoB,aAAa;GACjC,SAAS,KAAK,YAAY,KAAA,IAAY,KAAA,IAAY,QAAQ;GAC1D,kBAAkB,QAAQ;GAC1B;EACF;CACF;CAEA,MAAM,aAAa,OAIyB;EAC1C,MAAM,UAAU,MAAM,KAAKN,SAAS;EACpC,MAAM,QAAQ,KAAKC,OAAO,SAAS,MAAM,KAAK;EAC9C,MAAM,QAAQ,aAAa,MAAM,OAAO,wBAAwB,kBAAkB;EAClF,MAAM,QAAQ,KAAKC,eAAe,MAAM,QAAQ,SAAS,MAAM,OAAO,UAAU;EAChF,MAAM,SAAS,MAAM,KAAKP,WAAW,aAAa;GAAE;GAAO;GAAO;EAAM,CAAC;EACzE,MAAM,iBAAoD,CAAC;EAC3D,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,SAAS,MAAM,KAAKiB,gBAAgB,OAAO,OAAO,SAAS,MAAM,KAAK;GAC5E,eAAe,KAAK;IAClB,QAAQ,MAAM;IACd,YAAY,MAAM;IAClB,OAAO,WAAW,MAAM,KAAK;IAC7B,gBAAgB,SAAS,MAAM,iBAAiB,KAAA;IAChD,WAAW,MAAM,UAAU,YAAY;IACvC;GACF,CAAC;EACH;EACA,MAAM,KAAKP,cAAc,OAAO;EAChC,OAAO;GACL,aAAa,QAAQ;GACrB,YAAY,MAAM;GAClB,QAAQ;GACR,YACE,OAAO,WAAW,QAAQ,KAAKC,YAAY,SAAS,MAAM,OAAO,YAAY,OAAO,GAAG,EAAE,CAAC,CAAE,EAAE,IAAI,KAAA;EACtG;CACF;CAEA,MAAMN,WAA6B;EAGjC,MAAM,WAAW,8BAA8B,KAAKJ,SAAS,MAAM,IAAI,CAAC;EACxE,MAAM,oBAAoB,KAAKA,SAAS,SAAS,cAAc;EAC/D,IAAI,CAAC,SAAS,UAAU;GAGtB,KAAKG,kBAAkB;GACvB,MAAM,IAAI,wBACR,eACA,SAAS,SACL,qCAAqC,SAAS,WAC9C,yEACN;EACF;EACA,IAAI,CAAC,mBACH,MAAM,IAAI,wBAAwB,eAAe,kDAAkD;EAErG,MAAM,iBAAiB,SAAS;EAChC,MAAM,aAAa,SAAS,uBAAuB;EACnD,MAAM,iBAAiB,KAAKH,SAAS,OAAO,MAAM,KAAK,KAAA;EACvD,MAAM,SAAS,iBAAiB,MAAM,KAAKA,SAAS,OAAO,QAAQ,EAAE,UAAU,eAAe,CAAC,IAAI;EACnG,MAAM,WAAW,QAAQ,eAAe,oBAAoB,OAAO,KAAK,KAAA;EACxE,MAAM,cAAc,GAAG,eAAe,IAAI,WAAW,IAAI,YAAY;EACrE,IAAI,KAAKiB,iBAAiB,aAAa;GACrC,KAAKA,eAAe;GACpB,KAAKC,eAAe,YAAY;GAChC,KAAKjB,SAAS,MAAM;GACpB,KAAKC,SAAS,MAAM;EACtB;EACA,OAAO;GAAE;GAAgB;GAAY;GAAU;GAAa,aAAa,KAAKgB;EAAa;CAC7F;CAEA,OAAO,SAAkB,OAAqD;EAC5E,IAAI,UAAU,OAAO,OAAO,CAAC,OAAO,QAAQ,gBAAgB;EAC5D,MAAM,QAAQ,CAAC,OAAO,QAAQ,kBAAkB,YAAY,QAAQ,YAAY;EAChF,IAAI,UAAU,YAAY,OAAO;EACjC,IAAI,CAAC,QAAQ,UACX,MAAM,IAAI,wBAAwB,eAAe,oDAAoD;EAEvG,OAAO,CAAC,GAAG,OAAO,UAAU,QAAQ,UAAU;CAChD;CAEA,MAAMT,cAAc,SAAiC;EACnD,MAAM,UAAU,MAAM,KAAKL,SAAS;EACpC,IAAI,QAAQ,gBAAgB,QAAQ,eAAe,QAAQ,gBAAgB,QAAQ,aACjF,MAAM,IAAI,wBAAwB,gBAAgB,wDAAwD;CAE9G;CAEA,eAAwC,QAAkB,OAA4C;EACpG,IAAI,CAAC,UAAU,CAAC,wBAAwB,OAAO,OAAO,KAAK,GACzD,MAAM,IAAI,wBAAwB,eAAe,wDAAwD;CAE7G;CAEA,eACE,QACA,SACA,OAC+B;EAC/B,MAAM,OAAqC;EAC3C,OAAO;GACL,QAAQ,KAAKe,YAAY,SAAS,OAAO,MAAM,OAAO,EAAE;GACxD;GACA,MAAM,OAAO;GACb,MAAM,OAAO;GACb,OAAO,WAAW,OAAO,KAAK;GAC9B,SAAS,OAAO;GAChB,WAAW,OAAO,UAAU,YAAY;EAC1C;CACF;CAEA,MAAMR,oBACJ,OACA,YACA,MACA,MAC6B;EAC7B,MAAM,UAAU,MAAM,KAAKZ,WAAW,UAAU;GAC9C;GACA;GACA;GACA,OAAO;EACT,CAAC;EACD,MAAM,SAAS,MAAM,QAAQ,IAC3B,QAAQ,IAAI,OAAO,MAAM,iBAAiB;GACxC;GACA;GACA,GAAI,MAAM,KAAKS,2BAA2B,MAAM,KAAK;EACvD,EAAE,CACJ;EACA,MAAM,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC,MAC3B,GAAG,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,GAAG,cAAc,EAAE,KAAK,EAAE,CACrG;EACA,MAAM,gBAAgB,IAAI,IAAI,UAAU,KAAK,OAAO,UAAU,CAAC,MAAM,KAAK,IAAI,KAAK,CAAC,CAAC;EASrF,OAAO;GACL,QAAQ;GACR,UATA,SAAS,cACL,YACA,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM;IACzB,MAAM,SAAS,KAAK,QAAQ,EAAE,cAAc,KAAK,KAAK,QAAQ,cAAc,IAAI,EAAE,KAAK,EAAE,IAAK;IAE9F,OADe,KAAK,QAAQ,EAAE,cAAc,KAAK,KAAK,QAAQ,cAAc,IAAI,EAAE,KAAK,EAAE,IAAK,KAC9E,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,GAAG,cAAc,EAAE,KAAK,EAAE;GAC9F,CAAC,EAAA,CAGY,KAAI,WAAU;IAAE,IAAI,MAAM,KAAK;IAAI,QAAQ,MAAM;IAAQ,QAAQ,MAAM;GAAO,EAAE;EACnG;CACF;CAEA,MAAMA,2BACJ,MACA,OAC2E;EAC3E,MAAM,CAAC,aAAa,oBAAoB,MAAM,QAAQ,IAAI,CACxD,KAAKT,WAAW,mBAAmB;GAAE,MAAM,KAAK;GAAI;GAAO,OAAO;EAAe,CAAC,GAClF,KAAKA,WAAW,wBAAwB;GAAE,MAAM,KAAK;GAAI;GAAO,OAAO;EAAe,CAAC,CACzF,CAAC;EACD,MAAM,CAAC,UAAU,YAAY,MAAM,QAAQ,IAAI,CAC7C,KAAKqB,qBAAqB,MAAM,YAAY,SAAS,KAAK,GAC1D,KAAKC,uBAAuB,MAAM,iBAAiB,SAAS,KAAK,CACnE,CAAC;EACD,MAAM,oBAAoB,iBAAiB,QAAQ,QAAO,WAAU,OAAO,SAAS,KAAK,EAAE;EAE3F,OAAO;GACL,QAFa,IAAI,IAAI,CAAC,GAAG,SAAS,OAAO,GAAG,SAAS,KAAK,CAAC,CAAC,KAAI,WAAU,OAAO,EAAE,CAAC,CAAC,CAAC;GAGtF,QAAQ;IACN,SAAS,YAAY,QAAQ,SAAS,kBAAkB;IACxD,UAAU,SAAS,MAAM;IACzB,UAAU,SAAS,MAAM;IACzB,SAAS,QACP,YAAY,cAAc,iBAAiB,cAAc,SAAS,aAAa,SAAS,SAC1F;GACF;EACF;CACF;CAEA,MAAMD,qBACJ,SACA,SACA,OAC8B;EAC9B,MAAM,0BAAU,IAAI,IAA2B;EAC/C,IAAI,YAAY;EAChB,MAAM,UAAU,CAAC,QAAQ,WAAW,IAAI,GAAG,QAAQ,KAAI,WAAU,OAAO,IAAI,CAAC;EAC7E,KAAK,MAAM,UAAU,SAAS;GAC5B,KAAK,MAAM,QAAQ,wBAAwB,MAAM,GAAG;IAClD,IAAI,QAAQ,QAAQ,qBAAqB;KACvC,YAAY;KACZ;IACF;IACA,MAAM,OAAO,MAAM,KAAKrB,WAAW,YAAY;KAAE;KAAM;IAAM,CAAC;IAC9D,IAAI,QAAQ,KAAK,OAAO,QAAQ,MAAM,wBAAwB,KAAK,OAAO,KAAK,GAC7E,QAAQ,IAAI,KAAK,IAAI,IAAI;GAE7B;GACA,IAAI,WAAW;EACjB;EACA,OAAO;GAAE,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC;GAAG;EAAU;CACnD;CAEA,MAAMsB,uBACJ,SACA,SACA,OAC8B;EAC9B,MAAM,0BAAU,IAAI,IAA2B;EAC/C,IAAI,YAAY;EAChB,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,OAAO,SAAS,QAAQ,MAAM,QAAQ,IAAI,OAAO,IAAI,GAAG;GAC5D,IAAI,QAAQ,QAAQ,qBAAqB;IACvC,YAAY;IACZ;GACF;GACA,MAAM,OAAO,MAAM,KAAKtB,WAAW,QAAQ,OAAO,IAAI;GACtD,IAAI,QAAQ,wBAAwB,KAAK,OAAO,KAAK,GAAG,QAAQ,IAAI,KAAK,IAAI,IAAI;EACnF;EACA,OAAO;GAAE,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC;GAAG;EAAU;CACnD;CAEA,MAAMe,iBACJ,SACA,SACA,OACA,SACA,OACgD;EAChD,MAAM,UAAU,MAAM,KAAKM,qBAAqB,SAAS,SAAS,KAAK;EACvE,OAAO;GACL,OAAO,QAAQ,MAAM,KAAI,SAAQ,KAAKb,eAAe,MAAM,SAAS,KAAK,CAAC;GAC1E,SAAS,QAAQ;EACnB;CACF;CAEA,MAAMQ,iBACJ,SACA,SACA,OACA,SACA,OACgD;EAChD,MAAM,UAAU,MAAM,KAAKM,uBAAuB,SAAS,SAAS,KAAK;EACzE,OAAO;GACL,OAAO,QAAQ,MAAM,KAAI,SAAQ,KAAKd,eAAe,MAAM,SAAS,KAAK,CAAC;GAC1E,SAAS,QAAQ;EACnB;CACF;CAEA,MAAMS,gBACJ,OACA,OACA,SACA,OACoD;EACpD,IAAI,MAAM,eAAe,QAAQ;GAC/B,MAAM,OAAO,MAAM,KAAKjB,WAAW,QAAQ,MAAM,QAAQ;GACzD,OAAO,QAAQ,wBAAwB,KAAK,OAAO,KAAK,IAAI,KAAKQ,eAAe,MAAM,SAAS,KAAK,IAAI,KAAA;EAC1G;EACA,MAAM,SAAS,MAAM,KAAKR,WAAW,aAAa;GAAE,IAAI,MAAM;GAAU,gBAAgB;EAAK,CAAC;EAC9F,IAAI,CAAC,UAAU,CAAC,wBAAwB,OAAO,OAAO,KAAK,GAAG,OAAO,KAAA;EACrE,MAAM,OAAO,MAAM,KAAKA,WAAW,QAAQ,OAAO,IAAI;EACtD,OAAO,QAAQ,wBAAwB,KAAK,OAAO,KAAK,IAAI,KAAKQ,eAAe,MAAM,SAAS,KAAK,IAAI,KAAA;CAC1G;CAEA,YACE,SACA,OACA,MACA,UACQ;EACR,KAAKe,oBAAoB;EACzB,MAAM,QAAQ,YAAY;EAC1B,KAAKrB,SAAS,IAAI,OAAO;GACvB,aAAa,QAAQ;GACrB;GACA;GACA;GACA,WAAW,KAAK,IAAI,IAAI;EAC1B,CAAC;EACD,OAAO;CACT;CAEA,YAAY,QAAgB,SAAkB,cAAyD;EACrG,MAAM,QAAQ,KAAKA,SAAS,IAAI,MAAM;EACtC,IAAI,CAAC,SAAS,MAAM,YAAY,KAAK,IAAI,KAAK,MAAM,SAAS,cAC3D,MAAM,IAAI,wBAAwB,kBAAkB,gDAAgD;EAEtG,IAAI,MAAM,gBAAgB,QAAQ,aAChC,MAAM,IAAI,wBAAwB,gBAAgB,sDAAsD;EAE1G,OAAO;CACT;CAEA,YACE,SACA,OACA,MACA,OACA,SACQ;EACR,KAAKqB,oBAAoB;EACzB,MAAM,QAAQ,YAAY;EAC1B,KAAKpB,SAAS,IAAI,OAAO;GACvB,aAAa,QAAQ;GACrB;GACA;GACA;GACA;GACA,WAAW,KAAK,IAAI,IAAI;EAC1B,CAAC;EACD,OAAO;CACT;CAEA,eACE,QACA,SACA,OACA,MACA,SACoB;EACpB,IAAI,CAAC,QAAQ,OAAO,KAAA;EACpB,MAAM,QAAQ,KAAKA,SAAS,IAAI,MAAM;EACtC,IACE,CAAC,SACD,MAAM,YAAY,KAAK,IAAI,KAC3B,MAAM,gBAAgB,QAAQ,eAC9B,MAAM,UAAU,SAChB,MAAM,SAAS,QACf,MAAM,SAAS,eAAe,SAAS,cACvC,MAAM,SAAS,SAAS,SAAS,QACjC,MAAM,SAAS,SAAS,SAAS,MAEjC,MAAM,IAAI,wBACR,kBACA,+DACF;EAEF,OAAO,MAAM;CACf;CAEA,sBAA4B;EAC1B,MAAM,MAAM,KAAK,IAAI;EACrB,KAAK,MAAM,CAAC,OAAO,UAAU,KAAKD,UAChC,IAAI,MAAM,YAAY,KAAK,KAAKA,SAAS,OAAO,KAAK;EAEvD,KAAK,MAAM,CAAC,OAAO,UAAU,KAAKC,UAChC,IAAI,MAAM,YAAY,KAAK,KAAKA,SAAS,OAAO,KAAK;EAEvD,OAAO,KAAKD,SAAS,OAAO,KAAKC,SAAS,QAAQ,oBAAoB;GACpE,MAAM,SAAS,KAAKD,SAAS,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;GAC3C,IAAI,QAAQ,KAAKA,SAAS,OAAO,MAAM;QAClC;IACH,MAAM,SAAS,KAAKC,SAAS,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAKA,SAAS,OAAO,MAAM;SAClC;GACP;EACF;CACF;CAEA,oBAA0B;EACxB,KAAKe,eAAe,KAAA;EACpB,KAAKC,eAAe,YAAY;EAChC,KAAKjB,SAAS,MAAM;EACpB,KAAKC,SAAS,MAAM;CACtB;AACF;AAEA,eAAsB,yBAAyB,OAKH;CAC1C,IAAI;CACJ,IAAI,OAAO,MAAM,cAAc,UAAU;EACvC,IAAI;GACF,WAAW,MAAM,QAAQ,aAAa,MAAM,SAAS;EACvD,QAAQ;GACN,MAAM,IAAI,wBAAwB,eAAe,kDAAkD;EACrG;EACA,IAAI,CAAC,UACH,MAAM,IAAI,wBAAwB,eAAe,kDAAkD;CAEvG,OACE,WAAW,MAAM;CAEnB,MAAM,YAAY,WAAW,MAAM,SAAS,WAAW,IAAI,MAAM,MAAM,QAAQ,SAAS,WAAW;CACnG,OAAO,YAAY,IAAI,yBAAyB;EAAE;EAAW,SAAS,MAAM;CAAQ,CAAC,IAAI,KAAA;AAC3F"}

package/dist/onboarding/om-settings.d.ts

@@ -5,22 +5,43 @@
  */
 import type { OMPack } from './packs.js';
 import type { GlobalSettings } from './settings.js';
-/** Whether the user has already chosen any persisted OM model or pack. */
+/**
+ * Whether the user has already chosen any persisted OM model or pack.
+ *
+ * No longer called inside this repo — auto selection replaced the "seed a pack
+ * at login" flow — but part of the documented `@mastra/code-sdk/onboarding/om-settings`
+ * surface since 1.1.0, so it stays for external callers.
+ *
+ * @deprecated Observer and Reflector default to Auto; there is no default left to seed.
+ */
 export declare function hasExplicitOMConfiguration(settings: GlobalSettings): boolean;
-/** Seed a built-in OM pack unless the user already chose one; true when settings changed. */
+/**
+ * Seed a built-in OM pack unless the user already chose one; true when settings changed.
+ *
+ * The TUI stopped calling this when auto became the default; kept exported for
+ * external callers alongside {@link hasExplicitOMConfiguration}.
+ *
+ * @deprecated Seeding pins both roles to a fixed model. Leave them on Auto instead.
+ */
 export declare function applyOMDefaultIfUnconfigured(settings: GlobalSettings, pack: OMPack): boolean;
+/**
+ * Seed the provider's built-in OM pack into saved settings unless the user already chose one.
+ *
+ * @deprecated Signing in no longer seeds memory models; seeding pins both roles instead of
+ * leaving them on Auto.
+ */
 export declare function seedProviderOMDefault(providerId: string): OMPack | undefined;
 /**
  * Apply a role-specific OM model override to an in-memory `GlobalSettings`.
  *
- * When switching `activeOmPackId` from a built-in pack to `'custom'` we also
- * snapshot the *other* role's currently-resolved model into its override
- * field. Without this, the other role would silently lose its model on next
- * startup because `resolveOmRoleModel` would no longer resolve it from the
- * (now-overridden) pack.
+ * Role intent outranks the pack in `resolveOmRoleModel`, so `activeOmPackId` is
+ * deliberately left alone: the other role keeps resolving from its built-in
+ * pack instead of being dragged along by this role's choice.
  *
  * Exported for unit testing; `persistOmRoleOverride` is the disk-backed wrapper.
  */
-export declare function applyOmRoleOverride(settings: GlobalSettings, role: 'observer' | 'reflector', modelId: string, otherRoleCurrentModelId: string | null): void;
+export declare function applyOmRoleOverride(settings: GlobalSettings, role: 'observer' | 'reflector', modelId: string): void;
+/** Reset one persisted OM role to dynamic auto selection without touching the other role. */
+export declare function applyOmRoleAuto(settings: GlobalSettings, role: 'observer' | 'reflector'): void;
 export declare function persistOmObserveAttachments(value: 'auto' | boolean): void;
 //# sourceMappingURL=om-settings.d.ts.map

package/dist/onboarding/om-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"om-settings.d.ts","sourceRoot":"","sources":["../../src/onboarding/om-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAO5E;AAED,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,GAAG,WAAW,EAC9B,OAAO,EAAE,MAAM,EACf,uBAAuB,EAAE,MAAM,GAAG,IAAI,GACrC,IAAI,CAgBN;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAIzE"}
+{"version":3,"file":"om-settings.d.ts","sourceRoot":"","sources":["../../src/onboarding/om-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAsB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQnH;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAQ9F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAIzE"}

package/dist/onboarding/om-settings.js

@@ -1,13 +1,28 @@
 import { resolveProviderOMDefault } from "./packs.js";
 import { loadSettings, saveSettings } from "./settings.js";
 //#region src/onboarding/om-settings.ts
-/** Whether the user has already chosen any persisted OM model or pack. */
+/**
+* Whether the user has already chosen any persisted OM model or pack.
+*
+* No longer called inside this repo — auto selection replaced the "seed a pack
+* at login" flow — but part of the documented `@mastra/code-sdk/onboarding/om-settings`
+* surface since 1.1.0, so it stays for external callers.
+*
+* @deprecated Observer and Reflector default to Auto; there is no default left to seed.
+*/
 function hasExplicitOMConfiguration(settings) {
-	const { activeOmPackId, omModelOverride, observerModelOverride, reflectorModelOverride } = settings.models;
-	if (omModelOverride || observerModelOverride || reflectorModelOverride) return true;
+	const { activeOmPackId, omModelOverride, observerModelOverride, observerModelSelection, reflectorModelOverride, reflectorModelSelection } = settings.models;
+	if (omModelOverride || observerModelOverride || observerModelSelection && observerModelSelection !== "auto" || reflectorModelOverride || reflectorModelSelection && reflectorModelSelection !== "auto") return true;
 	return [settings.onboarding.omPackId, activeOmPackId].some((packId) => packId && packId !== "custom");
 }
-/** Seed a built-in OM pack unless the user already chose one; true when settings changed. */
+/**
+* Seed a built-in OM pack unless the user already chose one; true when settings changed.
+*
+* The TUI stopped calling this when auto became the default; kept exported for
+* external callers alongside {@link hasExplicitOMConfiguration}.
+*
+* @deprecated Seeding pins both roles to a fixed model. Leave them on Auto instead.
+*/
 function applyOMDefaultIfUnconfigured(settings, pack) {
 	if (hasExplicitOMConfiguration(settings)) return false;
 	settings.onboarding.omPackId = pack.id;
@@ -15,6 +30,12 @@ function applyOMDefaultIfUnconfigured(settings, pack) {
 	settings.models.omModelOverride = null;
 	return true;
 }
+/**
+* Seed the provider's built-in OM pack into saved settings unless the user already chose one.
+*
+* @deprecated Signing in no longer seeds memory models; seeding pins both roles instead of
+* leaving them on Auto.
+*/
 function seedProviderOMDefault(providerId) {
 	const pack = resolveProviderOMDefault(providerId);
 	if (pack.id === "custom") return void 0;
@@ -26,24 +47,30 @@ function seedProviderOMDefault(providerId) {
 /**
 * Apply a role-specific OM model override to an in-memory `GlobalSettings`.
 *
-* When switching `activeOmPackId` from a built-in pack to `'custom'` we also
-* snapshot the *other* role's currently-resolved model into its override
-* field. Without this, the other role would silently lose its model on next
-* startup because `resolveOmRoleModel` would no longer resolve it from the
-* (now-overridden) pack.
+* Role intent outranks the pack in `resolveOmRoleModel`, so `activeOmPackId` is
+* deliberately left alone: the other role keeps resolving from its built-in
+* pack instead of being dragged along by this role's choice.
 *
 * Exported for unit testing; `persistOmRoleOverride` is the disk-backed wrapper.
 */
-function applyOmRoleOverride(settings, role, modelId, otherRoleCurrentModelId) {
-	const wasBuiltinPack = settings.models.activeOmPackId !== null && settings.models.activeOmPackId !== "custom";
+function applyOmRoleOverride(settings, role, modelId) {
 	if (role === "observer") {
-		if (wasBuiltinPack && otherRoleCurrentModelId && !settings.models.reflectorModelOverride) settings.models.reflectorModelOverride = otherRoleCurrentModelId;
 		settings.models.observerModelOverride = modelId;
+		settings.models.observerModelSelection = modelId;
 	} else {
-		if (wasBuiltinPack && otherRoleCurrentModelId && !settings.models.observerModelOverride) settings.models.observerModelOverride = otherRoleCurrentModelId;
 		settings.models.reflectorModelOverride = modelId;
+		settings.models.reflectorModelSelection = modelId;
+	}
+}
+/** Reset one persisted OM role to dynamic auto selection without touching the other role. */
+function applyOmRoleAuto(settings, role) {
+	if (role === "observer") {
+		settings.models.observerModelOverride = null;
+		settings.models.observerModelSelection = "auto";
+	} else {
+		settings.models.reflectorModelOverride = null;
+		settings.models.reflectorModelSelection = "auto";
 	}
-	settings.models.activeOmPackId = "custom";
 }
 function persistOmObserveAttachments(value) {
 	const settings = loadSettings();
@@ -51,6 +78,6 @@ function persistOmObserveAttachments(value) {
 	saveSettings(settings);
 }
 //#endregion
-export { applyOMDefaultIfUnconfigured, applyOmRoleOverride, hasExplicitOMConfiguration, persistOmObserveAttachments, seedProviderOMDefault };
+export { applyOMDefaultIfUnconfigured, applyOmRoleAuto, applyOmRoleOverride, hasExplicitOMConfiguration, persistOmObserveAttachments, seedProviderOMDefault };
 
 //# sourceMappingURL=om-settings.js.map

package/dist/onboarding/om-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"om-settings.js","names":[],"sources":["../../src/onboarding/om-settings.ts"],"sourcesContent":["/**\n * Pure `GlobalSettings` mutation helpers for observational-memory (OM)\n * configuration. Shared by the TUI `/om` command and the web settings\n * routes — no UI dependencies.\n */\nimport type { OMPack } from './packs.js';\nimport { resolveProviderOMDefault } from './packs.js';\nimport type { GlobalSettings } from './settings.js';\nimport { loadSettings, saveSettings } from './settings.js';\n\n/** Whether the user has already chosen any persisted OM model or pack. */\nexport function hasExplicitOMConfiguration(settings: GlobalSettings): boolean {\n  const { activeOmPackId, omModelOverride, observerModelOverride, reflectorModelOverride } = settings.models;\n  if (omModelOverride || observerModelOverride || reflectorModelOverride) return true;\n\n  // 'custom' without a model is what onboarding persists when no provider was\n  // reachable — a forced non-choice, not a preference worth preserving.\n  return [settings.onboarding.omPackId, activeOmPackId].some(packId => packId && packId !== 'custom');\n}\n\n/** Seed a built-in OM pack unless the user already chose one; true when settings changed. */\nexport function applyOMDefaultIfUnconfigured(settings: GlobalSettings, pack: OMPack): boolean {\n  if (hasExplicitOMConfiguration(settings)) return false;\n\n  settings.onboarding.omPackId = pack.id;\n  settings.models.activeOmPackId = pack.id;\n  settings.models.omModelOverride = null;\n  return true;\n}\n\nexport function seedProviderOMDefault(providerId: string): OMPack | undefined {\n  const pack = resolveProviderOMDefault(providerId);\n  // No cheap OM pack for this provider — leave OM open for a later login rather\n  // than pinning observation and reflection to a full-size coding model.\n  if (pack.id === 'custom') return undefined;\n\n  const settings = loadSettings();\n  if (!applyOMDefaultIfUnconfigured(settings, pack)) return undefined;\n\n  saveSettings(settings);\n  return pack;\n}\n\n/**\n * Apply a role-specific OM model override to an in-memory `GlobalSettings`.\n *\n * When switching `activeOmPackId` from a built-in pack to `'custom'` we also\n * snapshot the *other* role's currently-resolved model into its override\n * field. Without this, the other role would silently lose its model on next\n * startup because `resolveOmRoleModel` would no longer resolve it from the\n * (now-overridden) pack.\n *\n * Exported for unit testing; `persistOmRoleOverride` is the disk-backed wrapper.\n */\nexport function applyOmRoleOverride(\n  settings: GlobalSettings,\n  role: 'observer' | 'reflector',\n  modelId: string,\n  otherRoleCurrentModelId: string | null,\n): void {\n  const wasBuiltinPack = settings.models.activeOmPackId !== null && settings.models.activeOmPackId !== 'custom';\n\n  if (role === 'observer') {\n    if (wasBuiltinPack && otherRoleCurrentModelId && !settings.models.reflectorModelOverride) {\n      settings.models.reflectorModelOverride = otherRoleCurrentModelId;\n    }\n    settings.models.observerModelOverride = modelId;\n  } else {\n    if (wasBuiltinPack && otherRoleCurrentModelId && !settings.models.observerModelOverride) {\n      settings.models.observerModelOverride = otherRoleCurrentModelId;\n    }\n    settings.models.reflectorModelOverride = modelId;\n  }\n\n  settings.models.activeOmPackId = 'custom';\n}\n\nexport function persistOmObserveAttachments(value: 'auto' | boolean): void {\n  const settings = loadSettings();\n  settings.models.omObserveAttachments = value;\n  saveSettings(settings);\n}\n"],"mappings":";;;;AAWA,SAAgB,2BAA2B,UAAmC;CAC5E,MAAM,EAAE,gBAAgB,iBAAiB,uBAAuB,2BAA2B,SAAS;CACpG,IAAI,mBAAmB,yBAAyB,wBAAwB,OAAO;CAI/E,OAAO,CAAC,SAAS,WAAW,UAAU,cAAc,CAAC,CAAC,MAAK,WAAU,UAAU,WAAW,QAAQ;AACpG;;AAGA,SAAgB,6BAA6B,UAA0B,MAAuB;CAC5F,IAAI,2BAA2B,QAAQ,GAAG,OAAO;CAEjD,SAAS,WAAW,WAAW,KAAK;CACpC,SAAS,OAAO,iBAAiB,KAAK;CACtC,SAAS,OAAO,kBAAkB;CAClC,OAAO;AACT;AAEA,SAAgB,sBAAsB,YAAwC;CAC5E,MAAM,OAAO,yBAAyB,UAAU;CAGhD,IAAI,KAAK,OAAO,UAAU,OAAO,KAAA;CAEjC,MAAM,WAAW,aAAa;CAC9B,IAAI,CAAC,6BAA6B,UAAU,IAAI,GAAG,OAAO,KAAA;CAE1D,aAAa,QAAQ;CACrB,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,oBACd,UACA,MACA,SACA,yBACM;CACN,MAAM,iBAAiB,SAAS,OAAO,mBAAmB,QAAQ,SAAS,OAAO,mBAAmB;CAErG,IAAI,SAAS,YAAY;EACvB,IAAI,kBAAkB,2BAA2B,CAAC,SAAS,OAAO,wBAChE,SAAS,OAAO,yBAAyB;EAE3C,SAAS,OAAO,wBAAwB;CAC1C,OAAO;EACL,IAAI,kBAAkB,2BAA2B,CAAC,SAAS,OAAO,uBAChE,SAAS,OAAO,wBAAwB;EAE1C,SAAS,OAAO,yBAAyB;CAC3C;CAEA,SAAS,OAAO,iBAAiB;AACnC;AAEA,SAAgB,4BAA4B,OAA+B;CACzE,MAAM,WAAW,aAAa;CAC9B,SAAS,OAAO,uBAAuB;CACvC,aAAa,QAAQ;AACvB"}
+{"version":3,"file":"om-settings.js","names":[],"sources":["../../src/onboarding/om-settings.ts"],"sourcesContent":["/**\n * Pure `GlobalSettings` mutation helpers for observational-memory (OM)\n * configuration. Shared by the TUI `/om` command and the web settings\n * routes — no UI dependencies.\n */\nimport type { OMPack } from './packs.js';\nimport { resolveProviderOMDefault } from './packs.js';\nimport type { GlobalSettings } from './settings.js';\nimport { loadSettings, saveSettings } from './settings.js';\n\n/**\n * Whether the user has already chosen any persisted OM model or pack.\n *\n * No longer called inside this repo — auto selection replaced the \"seed a pack\n * at login\" flow — but part of the documented `@mastra/code-sdk/onboarding/om-settings`\n * surface since 1.1.0, so it stays for external callers.\n *\n * @deprecated Observer and Reflector default to Auto; there is no default left to seed.\n */\nexport function hasExplicitOMConfiguration(settings: GlobalSettings): boolean {\n  const {\n    activeOmPackId,\n    omModelOverride,\n    observerModelOverride,\n    observerModelSelection,\n    reflectorModelOverride,\n    reflectorModelSelection,\n  } = settings.models;\n  if (\n    omModelOverride ||\n    observerModelOverride ||\n    (observerModelSelection && observerModelSelection !== 'auto') ||\n    reflectorModelOverride ||\n    (reflectorModelSelection && reflectorModelSelection !== 'auto')\n  ) {\n    return true;\n  }\n\n  // 'custom' without a model is what onboarding persists when no provider was\n  // reachable — a forced non-choice, not a preference worth preserving.\n  return [settings.onboarding.omPackId, activeOmPackId].some(packId => packId && packId !== 'custom');\n}\n\n/**\n * Seed a built-in OM pack unless the user already chose one; true when settings changed.\n *\n * The TUI stopped calling this when auto became the default; kept exported for\n * external callers alongside {@link hasExplicitOMConfiguration}.\n *\n * @deprecated Seeding pins both roles to a fixed model. Leave them on Auto instead.\n */\nexport function applyOMDefaultIfUnconfigured(settings: GlobalSettings, pack: OMPack): boolean {\n  if (hasExplicitOMConfiguration(settings)) return false;\n\n  settings.onboarding.omPackId = pack.id;\n  settings.models.activeOmPackId = pack.id;\n  settings.models.omModelOverride = null;\n  return true;\n}\n\n/**\n * Seed the provider's built-in OM pack into saved settings unless the user already chose one.\n *\n * @deprecated Signing in no longer seeds memory models; seeding pins both roles instead of\n * leaving them on Auto.\n */\nexport function seedProviderOMDefault(providerId: string): OMPack | undefined {\n  const pack = resolveProviderOMDefault(providerId);\n  // No cheap OM pack for this provider — leave OM open for a later login rather\n  // than pinning observation and reflection to a full-size coding model.\n  if (pack.id === 'custom') return undefined;\n\n  const settings = loadSettings();\n  if (!applyOMDefaultIfUnconfigured(settings, pack)) return undefined;\n\n  saveSettings(settings);\n  return pack;\n}\n\n/**\n * Apply a role-specific OM model override to an in-memory `GlobalSettings`.\n *\n * Role intent outranks the pack in `resolveOmRoleModel`, so `activeOmPackId` is\n * deliberately left alone: the other role keeps resolving from its built-in\n * pack instead of being dragged along by this role's choice.\n *\n * Exported for unit testing; `persistOmRoleOverride` is the disk-backed wrapper.\n */\nexport function applyOmRoleOverride(settings: GlobalSettings, role: 'observer' | 'reflector', modelId: string): void {\n  if (role === 'observer') {\n    settings.models.observerModelOverride = modelId;\n    settings.models.observerModelSelection = modelId;\n  } else {\n    settings.models.reflectorModelOverride = modelId;\n    settings.models.reflectorModelSelection = modelId;\n  }\n}\n\n/** Reset one persisted OM role to dynamic auto selection without touching the other role. */\nexport function applyOmRoleAuto(settings: GlobalSettings, role: 'observer' | 'reflector'): void {\n  if (role === 'observer') {\n    settings.models.observerModelOverride = null;\n    settings.models.observerModelSelection = 'auto';\n  } else {\n    settings.models.reflectorModelOverride = null;\n    settings.models.reflectorModelSelection = 'auto';\n  }\n}\n\nexport function persistOmObserveAttachments(value: 'auto' | boolean): void {\n  const settings = loadSettings();\n  settings.models.omObserveAttachments = value;\n  saveSettings(settings);\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,2BAA2B,UAAmC;CAC5E,MAAM,EACJ,gBACA,iBACA,uBACA,wBACA,wBACA,4BACE,SAAS;CACb,IACE,mBACA,yBACC,0BAA0B,2BAA2B,UACtD,0BACC,2BAA2B,4BAA4B,QAExD,OAAO;CAKT,OAAO,CAAC,SAAS,WAAW,UAAU,cAAc,CAAC,CAAC,MAAK,WAAU,UAAU,WAAW,QAAQ;AACpG;;;;;;;;;AAUA,SAAgB,6BAA6B,UAA0B,MAAuB;CAC5F,IAAI,2BAA2B,QAAQ,GAAG,OAAO;CAEjD,SAAS,WAAW,WAAW,KAAK;CACpC,SAAS,OAAO,iBAAiB,KAAK;CACtC,SAAS,OAAO,kBAAkB;CAClC,OAAO;AACT;;;;;;;AAQA,SAAgB,sBAAsB,YAAwC;CAC5E,MAAM,OAAO,yBAAyB,UAAU;CAGhD,IAAI,KAAK,OAAO,UAAU,OAAO,KAAA;CAEjC,MAAM,WAAW,aAAa;CAC9B,IAAI,CAAC,6BAA6B,UAAU,IAAI,GAAG,OAAO,KAAA;CAE1D,aAAa,QAAQ;CACrB,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,oBAAoB,UAA0B,MAAgC,SAAuB;CACnH,IAAI,SAAS,YAAY;EACvB,SAAS,OAAO,wBAAwB;EACxC,SAAS,OAAO,yBAAyB;CAC3C,OAAO;EACL,SAAS,OAAO,yBAAyB;EACzC,SAAS,OAAO,0BAA0B;CAC5C;AACF;;AAGA,SAAgB,gBAAgB,UAA0B,MAAsC;CAC9F,IAAI,SAAS,YAAY;EACvB,SAAS,OAAO,wBAAwB;EACxC,SAAS,OAAO,yBAAyB;CAC3C,OAAO;EACL,SAAS,OAAO,yBAAyB;EACzC,SAAS,OAAO,0BAA0B;CAC5C;AACF;AAEA,SAAgB,4BAA4B,OAA+B;CACzE,MAAM,WAAW,aAAa;CAC9B,SAAS,OAAO,uBAAuB;CACvC,aAAa,QAAQ;AACvB"}

package/dist/onboarding/packs.d.ts

@@ -7,9 +7,9 @@ export interface ModePack {
         plan: string;
         fast: string;
         /**
-         * Optional observational-memory model. When set, OM observer/reflector
-         * resolve from the pack (and its fallback chain) instead of the standalone
-         * OM settings, unless an explicit OM role override exists.
+         * Optional observational-memory model for both roles while the pack is
+         * active: a concrete model ID (with the pack fallback chain), `'auto'`, or
+         * unset to follow the per-role `/om` settings.
          */
         memory?: string;
     };
@@ -86,6 +86,15 @@ export declare function getAvailableModePacks(access: ProviderAccess, savedCusto
 }>): ModePack[];
 /** A provider's low-cost OM pack, or a custom pack on `fallbackModelId` when it has none. */
 export declare function resolveProviderOMDefault(providerId: string, fallbackModelId?: string): OMPack;
+/**
+ * Mastra Code's overrides for `@mastra/memory`'s auto model table. Memory owns
+ * the auto policy; Mastra Code only keeps its newer Gemini Flash default.
+ */
+export declare const MASTRACODE_AUTO_OM_MODELS: Readonly<Record<string, string>>;
+/** The model ID Memory reports for a main-session model ID (without Mastra Code's custom-provider prefix). */
+export declare function toMemoryModelId(modelId: string): string;
+/** Preview the concrete model Memory's `'auto'` resolves to for a main-session model ID. */
+export declare function resolveAutoOMModelId(currentModelId?: string): string;
 export declare function getAvailableOmPacks(access: ProviderAccess): OMPack[];
 /** Best reachable built-in OM pack: preferred provider, then OAuth, then built-in order. */
 export declare function selectPreferredOMPack(access: ProviderAccess, preferredProviderId?: string): OMPack | undefined;

package/dist/onboarding/packs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../../src/onboarding/packs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../../src/onboarding/packs.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE7D,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACzC;AAiDD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,QAAQ,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAUlG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,QAAQ,EAAE,CAOjD;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAM,GAAG,OAAO,CAQzG;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAM,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED,+FAA+F;AAC/F,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACnD,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAM,EAC9E,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAM,GAC7C,MAAM,EAAE,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAM,GAC7E,QAAQ,EAAE,CAuCZ;AAyCD,6FAA6F;AAC7F,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,SAAsB,GAAG,MAAM,CAkB1G;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAmC,CAAC;AAI3G,8GAA8G;AAC9G,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAuBpE;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc9G;AAMD,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

package/dist/onboarding/packs.js

@@ -1,4 +1,5 @@
 import { DEFAULT_OM_MODEL_ID } from "../constants.js";
+import { resolveAutoModelId } from "@mastra/memory";
 //#region src/onboarding/packs.ts
 /**
 * Onboarding "packs" — predefined model configurations for each mode.
@@ -190,7 +191,7 @@ const BUILTIN_OM_PACKS = [
 		id: "openai",
 		providerId: "openai",
 		name: "OpenAI Mini",
-		modelId: "openai/gpt-5.4-mini",
+		modelId: "openai/gpt-6-luna",
 		description: (access) => access === "oauth" ? "Via Codex subscription" : "Via OpenAI API key"
 	},
 	{
@@ -221,6 +222,23 @@ function resolveProviderOMDefault(providerId, fallbackModelId = DEFAULT_OM_MODEL
 		modelId: fallbackModelId || DEFAULT_OM_MODEL_ID
 	};
 }
+/**
+* Mastra Code's overrides for `@mastra/memory`'s auto model table. Memory owns
+* the auto policy; Mastra Code only keeps its newer Gemini Flash default.
+*/
+const MASTRACODE_AUTO_OM_MODELS = { google: DEFAULT_OM_MODEL_ID };
+const CUSTOM_PROVIDER_PREFIX = "mastracode/";
+/** The model ID Memory reports for a main-session model ID (without Mastra Code's custom-provider prefix). */
+function toMemoryModelId(modelId) {
+	return modelId.startsWith(CUSTOM_PROVIDER_PREFIX) ? modelId.slice(11) : modelId;
+}
+/** Preview the concrete model Memory's `'auto'` resolves to for a main-session model ID. */
+function resolveAutoOMModelId(currentModelId) {
+	if (!currentModelId) return resolveAutoModelId(void 0, { autoModels: MASTRACODE_AUTO_OM_MODELS }) ?? DEFAULT_OM_MODEL_ID;
+	const memoryModelId = toMemoryModelId(currentModelId);
+	const picked = resolveAutoModelId(memoryModelId, { autoModels: MASTRACODE_AUTO_OM_MODELS });
+	return !picked || picked === memoryModelId ? currentModelId : picked;
+}
 function getAvailableOmPacks(access) {
 	const packs = BUILTIN_OM_PACKS.flatMap((pack) => {
 		const providerAccess = access[pack.providerId];
@@ -255,6 +273,6 @@ function selectPreferredOMPack(access, preferredProviderId) {
 }
 const ONBOARDING_VERSION = 1;
 //#endregion
-export { ONBOARDING_VERSION, getAvailableModePacks, getAvailableOmPacks, getBuiltinModePack, isKnownModePackId, listBuiltinModePacks, pruneUnknownModePackFallbacks, pruneUnknownPackAccountPreferences, resolveModePackFallbackChain, resolveProviderOMDefault, selectPreferredOMPack };
+export { MASTRACODE_AUTO_OM_MODELS, ONBOARDING_VERSION, getAvailableModePacks, getAvailableOmPacks, getBuiltinModePack, isKnownModePackId, listBuiltinModePacks, pruneUnknownModePackFallbacks, pruneUnknownPackAccountPreferences, resolveAutoOMModelId, resolveModePackFallbackChain, resolveProviderOMDefault, selectPreferredOMPack, toMemoryModelId };
 
 //# sourceMappingURL=packs.js.map