@mastra/code-sdk 1.17.0 → 1.18.0-alpha.1

package/dist/knowledge-inspector.d.ts

@@ -1,11 +1,12 @@
 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 { KnowledgePageActivityAction } from '@mastra/core/storage';
 import type { MastraCodeState } from './schema.js';
 export type KnowledgeInspectorScopeLevel = 'org' | 'resource' | 'thread';
 export type KnowledgeInspectorRecordType = 'node';
-export type KnowledgeInspectorNodeSort = 'relevant' | 'recent' | 'connected';
+/** `name`: every readable page, by name. `connected`: the first pages by name, most linked first. */
+export type KnowledgeInspectorNodeSort = 'name' | 'connected';
 export interface KnowledgeInspectorScopeRoot {
     level: KnowledgeInspectorScopeLevel;
     id?: string;
@@ -18,7 +19,8 @@ export interface KnowledgeInspectorScopeTree {
     roots: KnowledgeInspectorScopeRoot[];
 }
 export interface KnowledgeInspectorScopeBadge {
-    level: KnowledgeInspectorScopeLevel;
+    /** The scope's type, e.g. `org`, `project`, `resource`, `thread`. */
+    level: string;
     id: string;
 }
 export interface KnowledgeInspectorRelationshipCounts {
@@ -27,20 +29,24 @@ export interface KnowledgeInspectorRelationshipCounts {
     incoming: number;
     sampled: boolean;
 }
+/** A page. */
 export interface KnowledgeInspectorNodeSummary {
+    /** Opaque, freshly minted per result and bound to the session; use it to open the page. */
     handle: string;
+    /** The page's stable id: the same page always has the same id, and two pages never share one. */
+    id: string;
     type: KnowledgeInspectorRecordType;
     name: string;
-    kind?: string;
     scope: KnowledgeInspectorScopeBadge;
     version: number;
     updatedAt: string;
     relationshipCounts?: KnowledgeInspectorRelationshipCounts;
 }
+/** A note. */
 export interface KnowledgeInspectorRecordSummary {
     text: string;
     scope: KnowledgeInspectorScopeBadge;
-    sourceThreadId: string;
+    sourceThreadId?: string;
     capturedAt: string;
     when?: string;
 }
@@ -50,7 +56,7 @@ export interface KnowledgeInspectorNodeList {
     nodes: KnowledgeInspectorNodeSummary[];
     nextCursor?: string;
     sort?: KnowledgeInspectorNodeSort;
-    coverage?: 'exact' | 'recent-window';
+    coverage?: 'exact' | 'window';
 }
 export interface KnowledgeInspectorRelationshipPreview {
     nodes: KnowledgeInspectorNodeSummary[];
@@ -60,13 +66,18 @@ export interface KnowledgeInspectorNodeDetail {
     identityKey: string;
     scopeLevel: KnowledgeInspectorScopeLevel;
     node: KnowledgeInspectorNodeSummary;
+    /** Notes on the page. */
     records: KnowledgeInspectorRecordSummary[];
     recordsNextCursor?: string;
+    /** Notes on other pages that mention this page. */
     mentioningRecords: KnowledgeInspectorRecordSummary[];
     mentioningRecordsNextCursor?: string;
+    /** Pages this page's notes and body mention. */
     outgoingTargets: KnowledgeInspectorRelationshipPreview;
+    /** Pages whose notes mention this page. */
     incomingParents: KnowledgeInspectorRelationshipPreview;
     relationshipCounts: KnowledgeInspectorRelationshipCounts;
+    /** The page body. */
     content?: string;
     contentTruncated: boolean;
     links: Array<{
@@ -75,8 +86,8 @@ export interface KnowledgeInspectorNodeDetail {
     }>;
 }
 export interface KnowledgeInspectorActivityEvent {
-    action: KnowledgeActivityEvent['action'];
-    recordType: KnowledgeActivityEvent['recordType'];
+    action: KnowledgePageActivityAction;
+    recordType: 'page' | 'note';
     scope: KnowledgeInspectorScopeBadge;
     sourceThreadId?: string;
     createdAt: string;
@@ -93,7 +104,6 @@ export interface KnowledgeInspector {
     listNodes(input: {
         level: KnowledgeInspectorScopeLevel;
         namePrefix?: string;
-        kind?: string;
         sort?: KnowledgeInspectorNodeSort;
         cursor?: string;
         limit?: number;
@@ -114,10 +124,16 @@ export declare class KnowledgeInspectorError extends Error {
     readonly code: 'unavailable' | 'invalid-handle' | 'stale-handle' | 'invalid-cursor' | 'not-visible';
     constructor(code: 'unavailable' | 'invalid-handle' | 'stale-handle' | 'invalid-cursor' | 'not-visible', message: string);
 }
+/**
+ * The /knowledge inspector for a session, reading through the session's Knowledge runtime (a key
+ * resolves through `mastra`). Undefined when there is no Knowledge runtime: access rules live on the
+ * runtime, so a bare storage domain can't be inspected.
+ */
 export declare function createKnowledgeInspector(input: {
-    storage: MastraCompositeStore;
     knowledge?: Knowledge | string;
     mastra?: Pick<Mastra, 'getKnowledge'>;
     session: Session<MastraCodeState>;
+    /** The host's `knowledge.scopes`, so the inspector reads what the code agent writes. */
+    hostScopes?: readonly string[];
 }): 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":"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"}