@botpress/adk 1.10.4 → 1.10.5

package/dist/bot-generator/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bot-generator/generator.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,CAAA;CACpD;AAkBD,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;gBAEd,OAAO,EAAE,mBAAmB;YAK1B,kBAAkB;YAuBlB,sBAAsB;IAsB9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YA+BjB,yBAAyB;YAkEzB,kBAAkB;YAKlB,oBAAoB;YAKpB,gBAAgB;YAKhB,kBAAkB;YAKlB,0BAA0B;YAK1B,kBAAkB;YAKlB,qBAAqB;YAKrB,yBAAyB;YAKzB,mBAAmB;YAMnB,8BAA8B;YAM9B,oBAAoB;YAyEpB,uBAAuB;YA8FvB,8BAA8B;YAiC9B,4BAA4B;YA2B5B,qBAAqB;YAwWrB,gBAAgB;YAoChB,mBAAmB;YAqBnB,gBAAgB;YAiChB,mBAAmB;YAyBnB,UAAU;YAWV,aAAa;IAgBrB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6ZnC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOzC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CpF"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bot-generator/generator.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,CAAA;CACpD;AAkBD,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;gBAEd,OAAO,EAAE,mBAAmB;YAK1B,kBAAkB;YAuBlB,sBAAsB;IAsB9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YA+BjB,yBAAyB;YAkEzB,kBAAkB;YAKlB,oBAAoB;YAKpB,gBAAgB;YAKhB,kBAAkB;YAKlB,0BAA0B;YAK1B,kBAAkB;YAKlB,qBAAqB;YAKrB,yBAAyB;YAKzB,mBAAmB;YAMnB,8BAA8B;YAM9B,oBAAoB;YAyEpB,uBAAuB;YA8FvB,8BAA8B;YAiC9B,4BAA4B;YA2B5B,qBAAqB;YAgXrB,gBAAgB;YAoChB,mBAAmB;YAqBnB,gBAAgB;YAiChB,mBAAmB;YAyBnB,UAAU;YAWV,aAAa;IAgBrB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6ZnC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOzC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CpF"}

package/dist/index.js

@@ -654,7 +654,7 @@ var PRETTIER_CONFIG, formatCode = async (code, filepath) => {
 `));
     return code;
   }
-}, ADK_VERSION = "1.10.4", relative2 = (from, to) => {
+}, ADK_VERSION = "1.10.5", relative2 = (from, to) => {
   const fromDir = path10.dirname(from);
   const relative3 = path10.relative(fromDir, to);
   return relative3.startsWith(".") ? relative3 : `./${relative3}`;
@@ -797,7 +797,7 @@ var init_integration_action_types = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@botpress/adk",
-    version: "1.10.4",
+    version: "1.10.5",
     description: "Core ADK library for building AI agents on Botpress",
     type: "module",
     main: "dist/index.js",
@@ -844,7 +844,7 @@ var require_package = __commonJS((exports, module) => {
       "@botpress/cli": "^4.27.3",
       "@botpress/client": "^1.27.2",
       "@botpress/cognitive": "^0.2.0",
-      "@botpress/runtime": "^1.10.4",
+      "@botpress/runtime": "^1.10.5",
       "@botpress/sdk": "^4.18.1",
       "@bpinternal/jex": "^1.2.4",
       "@bpinternal/yargs-extra": "^0.0.21",
@@ -4866,7 +4866,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": `^${"1.10.4"}`
+        "@botpress/runtime": `^${"1.10.5"}`
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -7108,6 +7108,14 @@ configuration: {
             type: "workflow",
             schema: TrackedStateSchema,
           },
+
+          /**
+           * Data source metadata for dashboard visibility (knowledge base sources)
+           */
+          [BUILT_IN_STATES.dsData]: {
+            type: "bot",
+            schema: z.record(z.any()),
+          },
         },
       });
 
@@ -8089,13 +8097,14 @@ var KBSyncOperation;
 
 // src/knowledge/manager.ts
 var WellKnownTags = {
-  KNOWLEDGE: "knowledge",
+  KNOWLEDGE: "source",
+  KNOWLEDGE_BASE_ID: "kbId",
   KNOWLEDGE_BASE_NAME: "kbName",
-  KNOWLEDGE_SOURCE_ID: "sourceId",
-  KNOWLEDGE_SOURCE_TYPE: "sourceType"
+  KNOWLEDGE_SOURCE_ID: "dsId",
+  KNOWLEDGE_SOURCE_TYPE: "dsType"
 };
-function sourceTag(sourceId, field) {
-  const sanitizedId = sourceId.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+function sourceTag(dsId, field) {
+  const sanitizedId = dsId.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   return `source${sanitizedId}${field}`;
 }
 var WellKnownMetadata = {
@@ -8194,10 +8203,10 @@ class KnowledgeManager {
     const remoteKbs = await this.listRemoteKnowledgeBases();
     return remoteKbs.filter((kb) => !localKbNames.includes(kb.name));
   }
-  async getOrphanedSources(kbName, localSourceIds) {
+  async getOrphanedSources(kbName, localDsIds) {
     const client = await this.getClient();
     const tags = {
-      [WellKnownTags.KNOWLEDGE]: "true",
+      [WellKnownTags.KNOWLEDGE]: "knowledge-base",
       [WellKnownTags.KNOWLEDGE_BASE_NAME]: kbName
     };
     const files = [];
@@ -8207,40 +8216,40 @@ class KnowledgeManager {
       files.push(...response.files);
       nextToken = response.meta.nextToken;
     } while (nextToken);
-    const filesBySourceId = new Map;
+    const filesByDsId = new Map;
     for (const file of files) {
-      const sourceId = file.tags?.[WellKnownTags.KNOWLEDGE_SOURCE_ID] || file.metadata?.sourceId;
-      if (sourceId) {
-        filesBySourceId.set(sourceId, (filesBySourceId.get(sourceId) || 0) + 1);
+      const dsId = file.tags?.[WellKnownTags.KNOWLEDGE_SOURCE_ID] || file.metadata?.dsId;
+      if (dsId) {
+        filesByDsId.set(dsId, (filesByDsId.get(dsId) || 0) + 1);
       }
     }
     const orphaned = [];
-    for (const [sourceId, fileCount] of filesBySourceId) {
-      if (!localSourceIds.includes(sourceId)) {
-        orphaned.push({ sourceId, fileCount });
+    for (const [dsId, fileCount] of filesByDsId) {
+      if (!localDsIds.includes(dsId)) {
+        orphaned.push({ dsId, fileCount });
       }
     }
     return orphaned;
   }
-  async deleteOrphanedSource(kbName, sourceId) {
+  async deleteOrphanedSource(kbName, dsId) {
     const client = await this.getClient();
     const tags = {
-      [WellKnownTags.KNOWLEDGE]: "true",
+      [WellKnownTags.KNOWLEDGE]: "knowledge-base",
       [WellKnownTags.KNOWLEDGE_BASE_NAME]: kbName,
-      [WellKnownTags.KNOWLEDGE_SOURCE_ID]: sourceId
+      [WellKnownTags.KNOWLEDGE_SOURCE_ID]: dsId
     };
     const files = await this.listExistingFiles(client, tags);
-    console.log(`     Deleting ${files.length} files from orphaned source "${sourceId}"...`);
+    console.log(`     Deleting ${files.length} files from orphaned source "${dsId}"...`);
     const results = await Promise.allSettled(files.map((f) => client.deleteFile({ id: f.id })));
     const deletedFiles = results.filter((r) => r.status === "fulfilled").length;
     const errors = results.filter((r) => r.status === "rejected").map((r) => String(r.reason));
     return { deletedFiles, errors };
   }
-  async cleanupSourceTags(kbId, kbName, sourceIds, existingTags) {
+  async cleanupSourceTags(kbId, kbName, dsIds, existingTags) {
     const client = await this.getClient();
     const newTags = { ...existingTags };
-    for (const sourceId of sourceIds) {
-      const sanitizedId = sourceId.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+    for (const dsId of dsIds) {
+      const sanitizedId = dsId.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
       newTags[`source${sanitizedId}hash`] = "";
       newTags[`source${sanitizedId}lastupdatedat`] = "";
     }
@@ -8249,7 +8258,7 @@ class KnowledgeManager {
   async deleteKnowledgeBase(kbId, kbName) {
     const client = await this.getClient();
     const tags = {
-      [WellKnownTags.KNOWLEDGE]: "true",
+      [WellKnownTags.KNOWLEDGE]: "knowledge-base",
       [WellKnownTags.KNOWLEDGE_BASE_NAME]: kbName
     };
     console.log(`     Listing files for KB "${kbName}"...`);
@@ -8261,18 +8270,18 @@ class KnowledgeManager {
     await client.deleteKnowledgeBase({ id: kbId });
     return { deletedFiles };
   }
-  getRemoteSourceHash(kb, sourceId) {
-    return kb.tags?.[sourceTag(sourceId, "hash")];
+  getRemoteSourceHash(kb, dsId) {
+    return kb.tags?.[sourceTag(dsId, "hash")];
   }
-  async updateSourceHash(kbId, kbName, sourceId, hash, existingTags) {
+  async updateSourceHash(kbId, kbName, dsId, hash, existingTags) {
     const client = await this.getClient();
     await client.updateKnowledgeBase({
       id: kbId,
       name: kbName,
       tags: {
         ...existingTags,
-        [sourceTag(sourceId, "hash")]: hash,
-        [sourceTag(sourceId, "lastupdatedat")]: new Date().toISOString()
+        [sourceTag(dsId, "hash")]: hash,
+        [sourceTag(dsId, "lastupdatedat")]: new Date().toISOString()
       }
     });
   }
@@ -8280,16 +8289,43 @@ class KnowledgeManager {
     const sortedConfig = JSON.stringify(config, Object.keys(config).sort());
     return crypto4.createHash("sha256").update(sortedConfig).digest("hex");
   }
-  async syncWebsiteSource(kbName, force) {
+  async syncWebsiteSource(kbName, kbId, force) {
     const client = await this.getClient();
     const response = await client.createWorkflow({
       name: "builtin_knowledge_indexing",
-      input: { kbName, force },
+      input: { kbName, kbId, force },
       status: "pending",
       timeoutAt: new Date(Date.now() + 180 * 60 * 1000).toISOString()
     });
     return { workflowId: response.workflow.id };
   }
+  async detectLegacyWebsiteFiles(kbName, sourceId) {
+    const client = await this.getClient();
+    const legacyTags = {
+      knowledge: "true",
+      sourceId,
+      kbName
+    };
+    const legacyFiles = await this.listExistingFiles(client, legacyTags);
+    return legacyFiles.length;
+  }
+  async deleteLegacyWebsiteFiles(kbName, sourceId) {
+    const client = await this.getClient();
+    const legacyTags = {
+      knowledge: "true",
+      sourceId,
+      kbName
+    };
+    const legacyFiles = await this.listExistingFiles(client, legacyTags);
+    if (legacyFiles.length === 0) {
+      return { deletedFiles: 0 };
+    }
+    console.log(`  Found ${legacyFiles.length} legacy website files to migrate`);
+    const results = await Promise.allSettled(legacyFiles.map((f) => client.deleteFile({ id: f.id })));
+    const deletedFiles = results.filter((r) => r.status === "fulfilled").length;
+    console.log(`  ✅ Deleted ${deletedFiles} legacy website files`);
+    return { deletedFiles };
+  }
   hasWebsiteSources(kbName) {
     const kbRef = this.project.knowledge.find((k) => k.definition.name === kbName);
     if (!kbRef)
@@ -8314,8 +8350,8 @@ class KnowledgeManager {
       const remoteKb = remoteKbs.find((r) => r.name === kb.name);
       if (!remoteKb) {
         const sources2 = (kbRef.definition.sources || []).map((source) => ({
-          sourceId: source.id,
-          sourceType: DataSource.isDirectory(source) ? "directory" : "website",
+          dsId: source.id,
+          dsType: DataSource.isDirectory(source) ? "document" : "web-page",
           needsSync: true,
           reason: "New KB"
         }));
@@ -8336,8 +8372,8 @@ class KnowledgeManager {
           const localHash = await this.computeDirectorySourceHash(source.directoryPath, source.filterFn);
           if (!remoteHash) {
             sources.push({
-              sourceId: source.id,
-              sourceType: "directory",
+              dsId: source.id,
+              dsType: "document",
               needsSync: true,
               reason: "First-time sync"
             });
@@ -8345,8 +8381,8 @@ class KnowledgeManager {
           } else if (localHash !== remoteHash) {
             const fileChanges = await this.detectDirectorySourceChanges(kb.name, source);
             sources.push({
-              sourceId: source.id,
-              sourceType: "directory",
+              dsId: source.id,
+              dsType: "document",
               needsSync: true,
               reason: "Content changed",
               fileChanges
@@ -8354,8 +8390,8 @@ class KnowledgeManager {
             hasChanges = true;
           } else {
             sources.push({
-              sourceId: source.id,
-              sourceType: "directory",
+              dsId: source.id,
+              dsType: "document",
               needsSync: false,
               reason: "No changes"
             });
@@ -8365,34 +8401,46 @@ class KnowledgeManager {
           const localHash = this.computeConfigHash(config);
           if (!remoteHash) {
             sources.push({
-              sourceId: source.id,
-              sourceType: "website",
+              dsId: source.id,
+              dsType: "web-page",
               needsSync: true,
               reason: "First-time crawl"
             });
             hasChanges = true;
           } else if (localHash !== remoteHash) {
             sources.push({
-              sourceId: source.id,
-              sourceType: "website",
+              dsId: source.id,
+              dsType: "web-page",
               needsSync: true,
               reason: "Config changed - needs recrawl"
             });
             hasChanges = true;
           } else {
-            sources.push({
-              sourceId: source.id,
-              sourceType: "website",
-              needsSync: false,
-              reason: "No config changes"
-            });
+            const legacyFileCount = await this.detectLegacyWebsiteFiles(kb.name, source.id);
+            if (legacyFileCount > 0) {
+              sources.push({
+                dsId: source.id,
+                dsType: "web-page",
+                needsSync: true,
+                reason: `${legacyFileCount} legacy files to migrate`,
+                legacyFileCount
+              });
+              hasChanges = true;
+            } else {
+              sources.push({
+                dsId: source.id,
+                dsType: "web-page",
+                needsSync: false,
+                reason: "No config changes"
+              });
+            }
           }
         }
       }
-      const localSourceIds = (kbRef.definition.sources || []).map((s) => s.id);
-      const orphaned = await this.getOrphanedSources(kb.name, localSourceIds);
+      const localDsIds = (kbRef.definition.sources || []).map((s) => s.id);
+      const orphaned = await this.getOrphanedSources(kb.name, localDsIds);
       const orphanedSourceStatuses = orphaned.map((o) => ({
-        sourceId: o.sourceId,
+        dsId: o.dsId,
         fileCount: o.fileCount,
         willDelete: true
       }));
@@ -8436,11 +8484,17 @@ class KnowledgeManager {
     const deleted = [];
     const modified = [];
     const tags = {
-      [WellKnownTags.KNOWLEDGE]: "true",
+      [WellKnownTags.KNOWLEDGE]: "knowledge-base",
       [WellKnownTags.KNOWLEDGE_SOURCE_ID]: source.id,
       [WellKnownTags.KNOWLEDGE_BASE_NAME]: kbName
     };
     const remoteFiles = await this.listExistingFiles(client, tags);
+    const legacyTags = {
+      knowledge: "true",
+      sourceId: source.id,
+      kbName
+    };
+    const legacyFiles = await this.listExistingFiles(client, legacyTags);
     const remoteHashes = {};
     for (const file of remoteFiles) {
       if (isFileMetadata(file.metadata)) {
@@ -8460,6 +8514,20 @@ class KnowledgeManager {
         deleted.push(relPath);
       }
     }
+    if (legacyFiles.length > 0) {
+      for (const file of legacyFiles) {
+        const meta = file.metadata;
+        const relPath = meta?.relPath;
+        if (relPath) {
+          if (!deleted.includes(`${relPath} (legacy)`)) {
+            deleted.push(`${relPath} (legacy)`);
+          }
+          if (localHashes[relPath] && !added.includes(relPath) && !remoteHashes[relPath]) {
+            added.push(relPath);
+          }
+        }
+      }
+    }
     return { added, deleted, modified };
   }
   async scanLocalFileHashes(directoryPath, filterFn) {
@@ -8507,10 +8575,10 @@ class KnowledgeManager {
           console.log(`  Removing ${item.orphanedSources.length} orphaned source(s)...`);
           const deletedSourceIds = [];
           for (const orphaned of item.orphanedSources) {
-            const { deletedFiles, errors } = await this.deleteOrphanedSource(item.kb.name, orphaned.sourceId);
-            console.log(`     ✕ ${orphaned.sourceId}: ${deletedFiles} files deleted`);
+            const { deletedFiles, errors } = await this.deleteOrphanedSource(item.kb.name, orphaned.dsId);
+            console.log(`     ✕ ${orphaned.dsId}: ${deletedFiles} files deleted`);
             if (errors.length === 0) {
-              deletedSourceIds.push(orphaned.sourceId);
+              deletedSourceIds.push(orphaned.dsId);
             } else {
               console.warn(`     Warning: ${errors.length} errors during deletion`);
             }
@@ -8531,14 +8599,14 @@ class KnowledgeManager {
           errors: []
         };
         const sourcesToSync = options.force ? item.sources || [] : (item.sources || []).filter((s) => s.needsSync);
-        const directorySourcesToSync = sourcesToSync.filter((s) => s.sourceType === "directory");
-        const websiteSourcesToSync = sourcesToSync.filter((s) => s.sourceType === "website");
+        const directorySourcesToSync = sourcesToSync.filter((s) => s.dsType === "document");
+        const websiteSourcesToSync = sourcesToSync.filter((s) => s.dsType === "web-page");
         for (const sourceStatus of directorySourcesToSync) {
-          const source = kbRef.definition.sources?.find((s) => s.id === sourceStatus.sourceId);
+          const source = kbRef.definition.sources?.find((s) => s.id === sourceStatus.dsId);
           if (!source || !DataSource.isDirectory(source))
             continue;
           console.log(`  Syncing directory source "${source.id}"...`);
-          const sourceOutput = await this.syncDirectorySource(client, item.kb.name, source.id, source.directoryPath, source.filterFn, options.force || false);
+          const sourceOutput = await this.syncDirectorySource(client, item.kb.name, remoteKb.id, source.id, source.directoryPath, source.filterFn, options.force || false);
           syncOutput.processed += sourceOutput.processed;
           syncOutput.added.push(...sourceOutput.added);
           syncOutput.updated.push(...sourceOutput.updated);
@@ -8549,11 +8617,14 @@ class KnowledgeManager {
         }
         if (websiteSourcesToSync.length > 0) {
           try {
+            for (const sourceStatus of websiteSourcesToSync) {
+              await this.deleteLegacyWebsiteFiles(item.kb.name, sourceStatus.dsId);
+            }
             console.log(`  Triggering website sync workflow for ${websiteSourcesToSync.length} source(s)...`);
-            const { workflowId } = await this.syncWebsiteSource(item.kb.name, options.force || false);
+            const { workflowId } = await this.syncWebsiteSource(item.kb.name, remoteKb.id, options.force || false);
             result.websiteSyncs.push({ kbName: item.kb.name, workflowId });
             for (const sourceStatus of websiteSourcesToSync) {
-              const source = kbRef.definition.sources?.find((s) => s.id === sourceStatus.sourceId);
+              const source = kbRef.definition.sources?.find((s) => s.id === sourceStatus.dsId);
               if (!source || !DataSource.isWebsite(source))
                 continue;
               const config = source.getConfig();
@@ -8574,16 +8645,17 @@ class KnowledgeManager {
     }
     return result;
   }
-  async syncDirectorySource(client, kbName, sourceId, directoryPath, filterFn, force) {
+  async syncDirectorySource(client, kbName, kbId, dsId, directoryPath, filterFn, force) {
     const projectDir = this.project.path;
     const directory = path33.resolve(projectDir, directoryPath);
     if (!directory.startsWith(projectDir)) {
       throw new Error("Directory path must be within the agent's directory");
     }
     const tags = {
-      [WellKnownTags.KNOWLEDGE]: "true",
-      [WellKnownTags.KNOWLEDGE_SOURCE_ID]: sourceId,
-      [WellKnownTags.KNOWLEDGE_SOURCE_TYPE]: "directory",
+      [WellKnownTags.KNOWLEDGE]: "knowledge-base",
+      [WellKnownTags.KNOWLEDGE_BASE_ID]: kbId,
+      [WellKnownTags.KNOWLEDGE_SOURCE_ID]: dsId,
+      [WellKnownTags.KNOWLEDGE_SOURCE_TYPE]: "document",
       [WellKnownTags.KNOWLEDGE_BASE_NAME]: kbName
     };
     let allFiles = glob.sync(directory + "/**/*.*", { absolute: true, nodir: true }).filter((file) => {
@@ -8604,7 +8676,17 @@ class KnowledgeManager {
     const cachedHashes = await this.scanLocalFileHashes(directoryPath, filterFn);
     const existingFiles = await this.listExistingFiles(client, tags);
     console.log(`  Found ${existingFiles.length} existing files in Botpress`);
+    const legacyTags = {
+      knowledge: "true",
+      sourceId: dsId,
+      kbName
+    };
+    const legacyFiles = await this.listExistingFiles(client, legacyTags);
+    if (legacyFiles.length > 0) {
+      console.log(`  Found ${legacyFiles.length} legacy files to migrate`);
+    }
     const toRemove = existingFiles.filter((f) => !allFiles.find((af) => af.rel === f.metadata?.relPath));
+    toRemove.push(...legacyFiles);
     const toAdd = allFiles.filter((af) => !existingFiles.find((f) => f.metadata?.relPath === af.rel));
     const toUpdate = allFiles.filter((af) => existingFiles.find((f) => f.metadata?.relPath === af.rel));
     const output = {
@@ -8631,13 +8713,13 @@ class KnowledgeManager {
       }
     }
     for (const local of toAdd) {
-      const result = await this.upsertFile(client, local, sourceId, tags, force, cachedHashes[local.rel]);
+      const result = await this.upsertFile(client, local, dsId, tags, force, cachedHashes[local.rel]);
       if (result) {
         output.added.push(result);
       }
     }
     for (const local of toUpdate) {
-      const result = await this.upsertFile(client, local, sourceId, tags, force, cachedHashes[local.rel]);
+      const result = await this.upsertFile(client, local, dsId, tags, force, cachedHashes[local.rel]);
       if (result) {
         output.updated.push(result);
       }
@@ -8660,8 +8742,8 @@ class KnowledgeManager {
     } while (nextToken);
     return files;
   }
-  async upsertFile(client, local, sourceId, tags, force, cachedHash) {
-    const key = `data_source://directory/${sourceId}/${local.rel}`;
+  async upsertFile(client, local, dsId, tags, force, cachedHash) {
+    const key = `data_source://document/${dsId}/${local.rel}`;
     const content = await fs16.readFile(local.abs);
     const hash = cachedHash ?? crypto4.createHash("sha256").update(content).digest("hex");
     try {
@@ -8673,8 +8755,8 @@ class KnowledgeManager {
     const title = path33.basename(local.name, path33.extname(local.name));
     const metadata = {
       hash,
-      sourceId,
-      sourceType: "directory",
+      dsId,
+      dsType: "document",
       relPath: local.rel,
       [WellKnownMetadata.TITLE]: title
     };
@@ -8745,8 +8827,8 @@ class KBSyncFormatter {
           sections.push("    Sources:");
           for (const source of item.sources) {
             if (source.needsSync) {
-              const typeLabel = source.sourceType === "directory" ? "\uD83D\uDCC1" : "\uD83C\uDF10";
-              sections.push(`      ${typeLabel} ${source.sourceId} (${source.sourceType})`);
+              const typeLabel = source.dsType === "document" ? "\uD83D\uDCC1" : "\uD83C\uDF10";
+              sections.push(`      ${typeLabel} ${source.dsId} (${source.dsType})`);
               sections.push(`         ${source.reason}`);
               if (source.fileChanges) {
                 const { added, modified, deleted } = source.fileChanges;
@@ -9358,5 +9440,5 @@ export {
   AgentProject
 };
 
-//# debugId=121D5550C34310B264756E2164756E21
+//# debugId=9750E26C20B1650B64756E2164756E21
 //# sourceMappingURL=index.js.map