@xanots/sdk 0.0.3 → 0.0.5

package/dist/{chunk-3NFUWXOC.js → chunk-MS3BRZAZ.js}

@@ -9,11 +9,11 @@ import {
   unknownFlag,
   unknownHelpTopic,
   unknownSubcommand
-} from "./chunk-6USV65XA.js";
+} from "./chunk-IVP6TS26.js";
 import {
   readLockFile,
   writeLockFile
-} from "./chunk-HJPTWBLH.js";
+} from "./chunk-MFIHIS6B.js";
 import {
   detail,
   info,
@@ -24,15 +24,17 @@ import {
   Xano,
   assertSeedIds,
   coerceSeedRowValues
-} from "./chunk-55VHDNW5.js";
+} from "./chunk-BPEEGJJA.js";
 import {
   getCommand,
   getSubcommand,
   isCommand,
   suggest
-} from "./chunk-DYCLVQXW.js";
+} from "./chunk-F5T45NAM.js";
 import {
   FILTER_NAMES,
+  KNOWLEDGE_DIR,
+  KNOWLEDGE_FILE,
   SEED_FILE,
   buildContentEnvelope,
   emit,
@@ -42,7 +44,7 @@ import {
   pathSegment,
   serializeBundle,
   tableColumns
-} from "./chunk-5L4X5LS6.js";
+} from "./chunk-YUPQOLFX.js";
 import {
   WORKSPACE_KEY,
   createLockContext,
@@ -54,12 +56,12 @@ import {
   seedLockOverrides,
   serializeLock,
   validateLockModel
-} from "./chunk-4HT3BNZ7.js";
+} from "./chunk-YUBJLB6G.js";
 
 // src/emit/cli.ts
-import { pathToFileURL as pathToFileURL2, fileURLToPath as fileURLToPath2 } from "url";
-import { existsSync, readdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { basename, dirname, join, relative, resolve } from "path";
+import { pathToFileURL as pathToFileURL3, fileURLToPath as fileURLToPath3 } from "url";
+import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { basename, dirname, join as join2, relative as relative2, resolve } from "path";
 import { createRequire } from "module";
 
 // src/workspace/seed.ts
@@ -250,6 +252,84 @@ function findUnresolvableFilters(bundle) {
   return findings;
 }
 
+// src/workspace/knowledge.ts
+import { readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { fileURLToPath as fileURLToPath2, pathToFileURL as pathToFileURL2 } from "url";
+import { join, relative, sep } from "path";
+var MAX_KNOWLEDGE_FILE_BYTES = 1024 * 1024;
+function resolveMarker(ref) {
+  const base = /^[a-z][a-z0-9+.-]*:/i.test(ref.base) ? ref.base : pathToFileURL2(ref.base).href;
+  return fileURLToPath2(new URL(ref.path, base));
+}
+function collectRefFiles(dir, itemName) {
+  const out = [];
+  const walk = (cur) => {
+    for (const entry of readdirSync(cur, { withFileTypes: true })) {
+      const full = join(cur, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      const content = readFileSync2(full, "utf8");
+      const size = Buffer.byteLength(content, "utf8");
+      const rel = relative(dir, full).split(sep).join("/");
+      if (size > MAX_KNOWLEDGE_FILE_BYTES) {
+        throw new Error(
+          `knowledge "${itemName}": reference file "${rel}" is ${size} bytes, over the ${MAX_KNOWLEDGE_FILE_BYTES}-byte limit the engine accepts. Split it, or move the bulk of it somewhere the agent fetches at run time.`
+        );
+      }
+      out.push({ path: rel, content, size });
+    }
+  };
+  walk(dir);
+  out.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+  return out;
+}
+function resolveKnowledge(defs) {
+  const resolved = [];
+  for (const def of defs) {
+    const bodyRef = def.body[KNOWLEDGE_FILE];
+    const where = `knowledgeFile("${bodyRef.path}")`;
+    let content;
+    try {
+      const abs = resolveMarker(bodyRef);
+      if (statSync(abs).isDirectory()) {
+        throw new Error(
+          `knowledge "${def.name}": ${where} points at a DIRECTORY. A body is one markdown file; use \`refs: knowledgeDir(...)\` for a folder of reference files.`
+        );
+      }
+      content = readFileSync2(abs, "utf8");
+    } catch (err) {
+      if (err instanceof Error && /points at a DIRECTORY/.test(err.message)) throw err;
+      throw new Error(
+        `knowledge "${def.name}": cannot read ${where} \u2014 ${err.message}. The path resolves relative to the module that declares the item (its \`import.meta.url\`).`
+      );
+    }
+    let files = [];
+    if (def.refs !== void 0) {
+      const refsRef = def.refs[KNOWLEDGE_DIR];
+      const refsWhere = `knowledgeDir("${refsRef.path}")`;
+      const abs = resolveMarker(refsRef);
+      try {
+        if (!statSync(abs).isDirectory()) {
+          throw new Error(
+            `knowledge "${def.name}": ${refsWhere} is not a directory. Reference files are a FOLDER the agent searches; a single file belongs in the body.`
+          );
+        }
+      } catch (err) {
+        if (err instanceof Error && /is not a directory/.test(err.message)) throw err;
+        throw new Error(
+          `knowledge "${def.name}": cannot read ${refsWhere} \u2014 ${err.message}.`
+        );
+      }
+      files = collectRefFiles(abs, def.name);
+    }
+    resolved.push({ name: def.name, content, files });
+  }
+  return resolved;
+}
+
 // src/emit/cli.ts
 function parsePort(raw) {
   const n = Number(raw);
@@ -300,6 +380,7 @@ function parseArgs(argv) {
   let frozenLock = false;
   let strict = false;
   let yes = false;
+  let check = false;
   let bundle;
   let reset = false;
   let dest;
@@ -314,6 +395,7 @@ function parseArgs(argv) {
   let authHost;
   let authFile;
   let useLocal = false;
+  let paste = false;
   let allWorkspaces = false;
   let guest = false;
   let urlOnly = false;
@@ -377,6 +459,8 @@ function parseArgs(argv) {
       strict = true;
     } else if (arg === "--yes" || arg === "-y") {
       yes = true;
+    } else if (arg === "--check") {
+      check = true;
     } else if (arg === "--bundle") {
       bundle = rest[++i];
     } else if (arg.startsWith("--bundle=")) {
@@ -432,6 +516,8 @@ function parseArgs(argv) {
       authFile = arg.slice("--config=".length);
     } else if (arg === "--local") {
       useLocal = true;
+    } else if (arg === "--paste") {
+      paste = true;
     } else if (arg === "--all-workspaces") {
       allWorkspaces = true;
     } else if (arg === "--guest" || arg === "-g") {
@@ -588,6 +674,7 @@ function parseArgs(argv) {
     frozenLock,
     strict,
     yes,
+    check,
     bundle,
     reset,
     dest,
@@ -602,6 +689,7 @@ function parseArgs(argv) {
     authHost,
     authFile,
     local: useLocal,
+    paste,
     allWorkspaces,
     guest,
     urlOnly,
@@ -681,9 +769,9 @@ function parseExpiresHours(raw) {
 }
 async function importTsxApi(file) {
   try {
-    const requireFromEntry = createRequire(pathToFileURL2(resolve(file)));
+    const requireFromEntry = createRequire(pathToFileURL3(resolve(file)));
     const apiPath = requireFromEntry.resolve("tsx/esm/api");
-    return await import(pathToFileURL2(apiPath).href);
+    return await import(pathToFileURL3(apiPath).href);
   } catch {
     return await import("tsx/esm/api");
   }
@@ -701,10 +789,10 @@ function entryIsCommonJs(file) {
   if (/\.cts$/.test(path)) return true;
   let dir = dirname(path);
   for (; ; ) {
-    const manifest = join(dir, "package.json");
+    const manifest = join2(dir, "package.json");
     if (existsSync(manifest)) {
       try {
-        const pkg = JSON.parse(readFileSync2(manifest, "utf8"));
+        const pkg = JSON.parse(readFileSync3(manifest, "utf8"));
         return pkg.type !== "module";
       } catch {
         return false;
@@ -723,7 +811,7 @@ function commonJsEntryError(file, cause) {
 }
 function suggestSiblingFile(path) {
   try {
-    return suggest(basename(path), readdirSync(dirname(path)));
+    return suggest(basename(path), readdirSync2(dirname(path)));
   } catch {
     return void 0;
   }
@@ -735,7 +823,7 @@ async function loadDefault(file) {
       suggestion: suggestSiblingFile(path)
     });
   }
-  const url = pathToFileURL2(path).href;
+  const url = pathToFileURL3(path).href;
   const isTypeScript = /\.[mc]?ts$/.test(file);
   if (isTypeScript) {
     if (entryIsCommonJs(file)) throw commonJsEntryError(file);
@@ -769,12 +857,12 @@ async function loadDefault(file) {
   }
 }
 function readVersion() {
-  let dir = dirname(fileURLToPath2(import.meta.url));
+  let dir = dirname(fileURLToPath3(import.meta.url));
   for (let i = 0; i < 6; i++) {
-    const p = join(dir, "package.json");
+    const p = join2(dir, "package.json");
     if (existsSync(p)) {
       try {
-        const pkg = JSON.parse(readFileSync2(p, "utf8"));
+        const pkg = JSON.parse(readFileSync3(p, "utf8"));
         if (pkg.name === "@xanots/sdk" && typeof pkg.version === "string") return pkg.version;
       } catch {
       }
@@ -799,9 +887,9 @@ function warnOrphans(orphans, dropped, cededCanonicals, previous, observed) {
       );
       continue;
     }
-    const sep = key.indexOf(":");
-    const payloadKey = key.slice(0, sep);
-    const name = key.slice(sep + 1);
+    const sep2 = key.indexOf(":");
+    const payloadKey = key.slice(0, sep2);
+    const name = key.slice(sep2 + 1);
     const newcomers = Object.keys(observed).filter((k) => k.startsWith(`${payloadKey}:`) && !(k in previous.objects)).map((k) => k.slice(payloadKey.length + 1));
     const hint = newcomers.length > 0 ? ` (new ${payloadKey} names this export: ${newcomers.join(", ")})` : "";
     warn(
@@ -822,6 +910,10 @@ function warnOrphans(orphans, dropped, cededCanonicals, previous, observed) {
   }
 }
 async function run(argv) {
+  if (argv[0] === "onboard") {
+    const { runOnboardCommand } = await import("./onboard-command-EHOHKQQU.js");
+    return runOnboardCommand(argv.slice(1));
+  }
   const helpRequest = resolveHelpRequest(argv);
   if (helpRequest) {
     if (helpRequest.unknownTopic !== void 0) throw unknownHelpTopic(helpRequest.unknownTopic);
@@ -840,11 +932,11 @@ async function run(argv) {
     return;
   }
   if (command === "init") {
-    const { runInitCommand } = await import("./init-command-LOK75W64.js");
+    const { runInitCommand } = await import("./init-command-NCRPVFGE.js");
     return runInitCommand(args);
   }
   if (command === "completion") {
-    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS } = await import("./completion-BKAFCZBE.js");
+    const { isCompletionShell, runCompletionCommand, COMPLETION_SHELLS } = await import("./completion-GHP5RRLQ.js");
     const shell = args.positionals[0];
     if (shell === void 0 || !isCompletionShell(shell)) {
       throw new UsageError(
@@ -854,28 +946,32 @@ async function run(argv) {
     }
     return runCompletionCommand(shell);
   }
+  if (command === "upgrade") {
+    const { runUpgradeCommand } = await import("./upgrade-command-M2DZ3ZPD.js");
+    return runUpgradeCommand(args);
+  }
   if (command === "lock") {
-    const { runLockCommand } = await import("./lock-commands-XOYS75YQ.js");
+    const { runLockCommand } = await import("./lock-commands-6UONZW26.js");
     return runLockCommand(args);
   }
   if (command === "login") {
-    const { runLoginCommand } = await import("./login-command-ACJF6KWQ.js");
+    const { runLoginCommand } = await import("./login-command-SG7IWTHW.js");
     return runLoginCommand(args);
   }
   if (command === "logout") {
-    const { runLogoutCommand } = await import("./logout-command-MX3MJS5U.js");
+    const { runLogoutCommand } = await import("./logout-command-J2AG5NKC.js");
     return runLogoutCommand(args);
   }
   if (command === "deploy") {
-    const { runDeployCommand } = await import("./deploy-command-4R6BYC6G.js");
+    const { runDeployCommand } = await import("./deploy-command-XOH76USO.js");
     return runDeployCommand(args);
   }
   if (command === "ephemeral") {
-    const { runEphemeralCommand } = await import("./ephemeral-command-JL4TPIRQ.js");
+    const { runEphemeralCommand } = await import("./ephemeral-command-46SL27GJ.js");
     return runEphemeralCommand(args);
   }
   if (command === "release") {
-    const { runReleaseCommand } = await import("./release-command-HZUY2XZX.js");
+    const { runReleaseCommand } = await import("./release-command-FKQ6E3TD.js");
     return runReleaseCommand(args);
   }
   if (command === "sandbox") {
@@ -883,47 +979,47 @@ async function run(argv) {
       throw removedSubcommand("sandbox", "deploy");
     }
     if (args.subcommand === "details") {
-      const { runSandboxDetailsCommand } = await import("./sandbox-details-command-HJE5SPVG.js");
+      const { runSandboxDetailsCommand } = await import("./sandbox-details-command-DMY2KGA2.js");
       return runSandboxDetailsCommand(args);
     }
     if (args.subcommand === "export") {
-      const { runSandboxExportCommand } = await import("./sandbox-export-command-QCJY4GMV.js");
+      const { runSandboxExportCommand } = await import("./sandbox-export-command-R6QMEK3D.js");
       return runSandboxExportCommand(args);
     }
     if (args.subcommand === "codegen") {
-      const { runCodegenCommand } = await import("./codegen-command-FIADGXRN.js");
+      const { runCodegenCommand } = await import("./codegen-command-BLOS3GR3.js");
       return runCodegenCommand(args, { kind: "sandbox" });
     }
     throw unknownSubcommand("sandbox", args.subcommand);
   }
   if (command === "test") {
-    const { runTestCommand } = await import("./test-command-72Y5S22H.js");
+    const { runTestCommand } = await import("./test-command-56IAEYHX.js");
     return runTestCommand(args);
   }
   if (command === "workspace") {
-    const { runWorkspaceCommand } = await import("./workspace-command-ICSI6PKO.js");
+    const { runWorkspaceCommand } = await import("./workspace-command-HZS43PHJ.js");
     return runWorkspaceCommand(args);
   }
   if (command === "codegen") {
-    const { runCodegenCommand } = await import("./codegen-command-FIADGXRN.js");
+    const { runCodegenCommand } = await import("./codegen-command-BLOS3GR3.js");
     return runCodegenCommand(args, { kind: "file" });
   }
   if (command === "profile") {
     if (args.subcommand !== "me") {
       throw unknownSubcommand("profile", args.subcommand);
     }
-    const { runProfileCommand } = await import("./profile-command-SWJ3SPKR.js");
+    const { runProfileCommand } = await import("./profile-command-ZPC2DPFV.js");
     return runProfileCommand(args);
   }
   if (command === "whoami") {
-    const { runProfileCommand } = await import("./profile-command-SWJ3SPKR.js");
+    const { runProfileCommand } = await import("./profile-command-ZPC2DPFV.js");
     return runProfileCommand(args);
   }
   if (command === "marketplace") {
     if (!["list", "search", "details", "install"].includes(args.subcommand ?? "")) {
       throw unknownSubcommand("marketplace", args.subcommand);
     }
-    const marketplace = await import("./marketplace-command-UVV3XAOL.js");
+    const marketplace = await import("./marketplace-command-NKTQ3VPS.js");
     if (args.subcommand === "list") return marketplace.runMarketplaceListCommand(args);
     if (args.subcommand === "search") return marketplace.runMarketplaceSearchCommand(args);
     if (args.subcommand === "details") return marketplace.runMarketplaceDetailsCommand(args);
@@ -933,7 +1029,7 @@ async function run(argv) {
     throw unknownCommand("push");
   }
   if (command === "validate") {
-    const { runValidateCommand } = await import("./validate-command-KDGH537H.js");
+    const { runValidateCommand } = await import("./validate-command-CIBQJND7.js");
     return runValidateCommand(args);
   }
   if (command !== "compile" && command !== "export" && command !== "paths" && command !== "routes") {
@@ -965,7 +1061,7 @@ async function run(argv) {
 }
 async function refreshAgentGuidance() {
   try {
-    const { refreshAgentFiles } = await import("./agent-file-refresh-6M5M7T24.js");
+    const { refreshAgentFiles } = await import("./agent-file-refresh-IJ7GN2FJ.js");
     const refreshed = refreshAgentFiles({
       projectDir: process.cwd(),
       sdkVersion: readVersion()
@@ -978,7 +1074,7 @@ async function refreshAgentGuidance() {
   }
 }
 function resolveLockPath(args, file) {
-  return args.lockPath !== void 0 ? resolve(args.lockPath) : join(dirname(resolve(file)), "xano.lock");
+  return args.lockPath !== void 0 ? resolve(args.lockPath) : join2(dirname(resolve(file)), "xano.lock");
 }
 function describeDefaultExport(def) {
   if (def === void 0) return "no default export";
@@ -1090,7 +1186,7 @@ async function runPaths(args) {
       const channelCount = channelRows.length === 1 ? "1 channel" : `${channelRows.length} channels`;
       const count = describableServers.length > 0 ? `${routeCount}, ${channelCount}` : routeCount;
       if (args.strict) {
-        const current = existsSync(args.emit) ? readFileSync2(args.emit, "utf8") : void 0;
+        const current = existsSync(args.emit) ? readFileSync3(args.emit, "utf8") : void 0;
         if (current !== source) {
           throw new Error(
             `--strict: ${args.emit} is ${current === void 0 ? "missing" : "out of date"}. Run \`xanots paths <entry> --emit ${args.emit}\` and commit the result \u2014 a stale route manifest keeps compiling while the endpoints have moved.`
@@ -1142,7 +1238,12 @@ async function compileBundle(args, opts = {}) {
   if (!Xano.isXano(def)) {
     throw new Error(`Module "${file}" must default-export a Xano registry for \`export\`.`);
   }
-  const bundle = def.export({ ...lockCtx ? { lock: lockCtx } : {}, strict: args.strict });
+  const resolvedKnowledge = resolveKnowledge(def.knowledge());
+  const bundle = def.export({
+    ...lockCtx ? { lock: lockCtx } : {},
+    strict: args.strict,
+    knowledge: resolvedKnowledge
+  });
   if (lockCtx) {
     const { lock: merged, orphans, dropped, cededCanonicals } = mergeObserved(
       lockCtx.lock,
@@ -1156,7 +1257,7 @@ async function compileBundle(args, opts = {}) {
       );
     }
     writeLockFile(lockPath, merged);
-    if (!lockExists) info(`Wrote ${relative(process.cwd(), lockPath) || lockPath} (commit this).`);
+    if (!lockExists) info(`Wrote ${relative2(process.cwd(), lockPath) || lockPath} (commit this).`);
     warnOrphans(orphans, dropped, cededCanonicals, lockCtx.lock, lockCtx.observed);
   }
   checkFilterNames(bundle, args.strict);
@@ -1193,4 +1294,4 @@ export {
   exportBundleJson,
   compileBundle
 };
-//# sourceMappingURL=chunk-3NFUWXOC.js.map
+//# sourceMappingURL=chunk-MS3BRZAZ.js.map

package/dist/{chunk-2V4YE6QC.js → chunk-OARSPAIE.js}

@@ -15,7 +15,10 @@ import {
   normalize,
   retiredInputSuccessor,
   retiredInputs
-} from "./chunk-P3TTMWUP.js";
+} from "./chunk-ZOYMZZ3S.js";
+import {
+  getAccessToken
+} from "./chunk-SG4UBJ47.js";
 import {
   exportWorkspaceBundle
 } from "./chunk-QTNO2WD6.js";
@@ -24,18 +27,15 @@ import {
   resolveFrontendPreset,
   resolveThemeChoice,
   sanitizeAppName
-} from "./chunk-HQ2CBRVI.js";
+} from "./chunk-KXCPZUUM.js";
 import {
   XANO_DIR,
   resolveAiPresets,
   scaffoldProject
-} from "./chunk-CMZLPTGW.js";
-import {
-  getAccessToken
-} from "./chunk-C56BC2FY.js";
+} from "./chunk-7SISR3CS.js";
 import {
   TEST_EXPECT_TYPES
-} from "./chunk-F6JCFRKO.js";
+} from "./chunk-PXXLBXOP.js";
 import {
   raw
 } from "./chunk-LU7TRWMC.js";
@@ -44,7 +44,7 @@ import {
   describeOrigin,
   renderCodegenMarker,
   renderCodegenReadme
-} from "./chunk-YZ4GU6F5.js";
+} from "./chunk-QUUB7HYK.js";
 import {
   FIELD_METHODS,
   STATEMENT_SURFACES,
@@ -67,14 +67,14 @@ import {
   searchConstrainsRows,
   tableTrigger,
   workspaceTrigger
-} from "./chunk-U3G2UW65.js";
+} from "./chunk-CYJ7R3AD.js";
 import {
   loadDefault,
   readVersion
-} from "./chunk-3NFUWXOC.js";
+} from "./chunk-MS3BRZAZ.js";
 import {
   UsageError
-} from "./chunk-6USV65XA.js";
+} from "./chunk-IVP6TS26.js";
 import {
   blank,
   detail,
@@ -115,7 +115,7 @@ import {
   sys,
   toolset,
   withFilters
-} from "./chunk-5L4X5LS6.js";
+} from "./chunk-YUPQOLFX.js";
 import {
   parsePathParams,
   unboundPathParams
@@ -130,7 +130,7 @@ import {
 } from "./chunk-5XZ744TS.js";
 import {
   REFERENCEABLE_KIND_PAYLOAD_KEYS
-} from "./chunk-4HT3BNZ7.js";
+} from "./chunk-YUBJLB6G.js";
 
 // src/emit/codegen-command.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -886,6 +886,37 @@ function resolveReference(ctx, index, guid, options = {}) {
   ]);
 }
 
+// src/kinds/knowledge-paths.ts
+function knowledgePathSegment(name) {
+  const slug = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return slug === "" ? "item" : slug;
+}
+function knowledgeItemDir(type, name) {
+  const seg = knowledgePathSegment(name);
+  switch (type) {
+    case "agents.md":
+      return null;
+    case "skill":
+      return `skills/${seg}`;
+    case "doc":
+      return `docs/${seg}`;
+  }
+}
+function knowledgeBodyPath(type, name) {
+  switch (type) {
+    case "agents.md":
+      return "agents.md";
+    case "skill":
+      return `${knowledgeItemDir(type, name)}/SKILL.md`;
+    case "doc":
+      return `${knowledgeItemDir(type, name)}.md`;
+  }
+}
+function knowledgeRefsDir(type, name) {
+  const dir = knowledgeItemDir(type, name);
+  return dir === null ? null : `${dir}/refs`;
+}
+
 // src/codegen/obj-expr.ts
 var IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
 var REFERENCE = /^\$(input|var|auth|db)((?:\.[A-Za-z0-9_$]+)*)$/;
@@ -4320,10 +4351,6 @@ function omissionSeverity(reason) {
 }
 var UNSUPPORTED_SECTIONS = {
   vault: { reason: "secret", detail: "vault entries are instance secrets and are never emitted as source" },
-  knowledge: {
-    reason: "unmodeled",
-    detail: "knowledge objects are not authored in TypeScript by this SDK"
-  },
   // These three were tagged `unmodeled`, which their own detail lines contradict:
   // none of them is an object type the SDK failed to model. They are records of
   // what was done to the workspace, owned by the instance that did it.
@@ -4509,6 +4536,19 @@ function decodeExample(a) {
 }
 
 // src/codegen/kinds/index.ts
+function knowledgeFileRows(payload, parentGuid) {
+  const rows = Array.isArray(payload.knowledge_file) ? payload.knowledge_file : [];
+  const out2 = [];
+  for (const raw2 of rows) {
+    const row = raw2;
+    if (row.knowledge?.id !== parentGuid) continue;
+    const stored = typeof row.path === "string" ? row.path : "";
+    if (stored === "") continue;
+    const rel = stored.replace(/^knowledge-refs\/[^/]+\//, "");
+    out2.push({ path: rel, content: String(row.content ?? "") });
+  }
+  return out2;
+}
 function plain(stored, storedKey, fallback, defKey = storedKey) {
   const value = stored[storedKey];
   if (value === void 0 || deepEqual2(value, fallback)) return null;
@@ -4834,6 +4874,50 @@ var DEFAULT_CACHE = {
   env: []
 };
 var KIND_DECODERS = [
+  {
+    name: "knowledge",
+    payloadKey: "knowledge",
+    dir: "knowledge",
+    register: "registerKnowledge",
+    defType: "KnowledgeDef",
+    factory: "knowledge",
+    decode: (a) => {
+      const type = a.stored.knowledge_type ?? "skill";
+      const name = String(a.stored.name ?? "");
+      a.ctx.imports.use(SDK_MODULE, "knowledgeFile");
+      const refsDir = knowledgeRefsDir(type, name);
+      const hasRefs = refsDir !== null && knowledgeFileRows(a.payload, a.stored.guid).length > 0;
+      if (hasRefs) a.ctx.imports.use(SDK_MODULE, "knowledgeDir");
+      return compact([
+        ...identity(a),
+        plain(a.stored, "description", ""),
+        plain(a.stored, "knowledge_type", "skill", "type"),
+        plain(a.stored, "mode", "auto"),
+        plain(a.stored, "enabled", true),
+        [
+          "body",
+          call("knowledgeFile", lit(`./${knowledgeBodyPath(type, name)}`), id("import.meta.url"))
+        ],
+        hasRefs ? [
+          "refs",
+          call("knowledgeDir", lit(`./${refsDir}`), id("import.meta.url"))
+        ] : null,
+        tags(a.stored)
+      ]);
+    },
+    companions: ({ stored, payload }) => {
+      const type = stored.knowledge_type ?? "skill";
+      const name = String(stored.name ?? "");
+      const refsDir = knowledgeRefsDir(type, name);
+      return [
+        { path: knowledgeBodyPath(type, name), contents: String(stored.content ?? "") },
+        ...refsDir === null ? [] : knowledgeFileRows(payload, stored.guid).map((f2) => ({
+          path: `${refsDir}/${f2.path}`,
+          contents: f2.content
+        }))
+      ];
+    }
+  },
   {
     name: "table",
     payloadKey: "dbo",
@@ -6248,6 +6332,7 @@ function assembleProject(ctx, refs, payload) {
         ctx,
         refs,
         stored: placement.stored,
+        payload,
         resolve: {
           symbolFor: (target) => {
             const found = byGuid.get(target.guid);
@@ -6291,6 +6376,12 @@ function assembleProject(ctx, refs, payload) {
     );
   }
   const out2 = [];
+  for (const placement of placements) {
+    const decoder = KIND_DECODERS_BY_NAME.get(placement.object.kind);
+    for (const companion of decoder.companions?.({ stored: placement.stored, payload }) ?? []) {
+      out2.push({ path: `${decoder.dir}/${companion.path}`, contents: companion.contents });
+    }
+  }
   for (const [path, file] of files) {
     out2.push({
       path,
@@ -6320,7 +6411,7 @@ function workspaceFile(ctx, refs, payload) {
   const decoder = KIND_DECODERS_BY_NAME.get("workspace");
   const { expr, factory } = ctx.inObject(
     "workspace",
-    () => decodeObject(decoder, { ctx, refs, stored, resolve: {} })
+    () => decodeObject(decoder, { ctx, refs, stored, payload, resolve: {} })
   );
   if (factory) imports.use(SDK_MODULE, factory);
   else imports.useType(SDK_MODULE, decoder.defType);
@@ -6640,7 +6731,7 @@ async function fetchBundle(args, source) {
   if (source.kind === "sandbox") {
     const auth3 = await getAccessToken(args);
     step("Reading the sandbox workspace");
-    const { fetchSandboxBundle } = await import("./sandbox-export-command-QCJY4GMV.js");
+    const { fetchSandboxBundle } = await import("./sandbox-export-command-R6QMEK3D.js");
     return {
       bundle: await fetchSandboxBundle(auth3),
       origin: { source: "sandbox", origin: auth3.instance }
@@ -6654,7 +6745,7 @@ async function fetchBundle(args, source) {
       );
     }
     const auth3 = await getAccessToken(args);
-    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-JL4TPIRQ.js");
+    const { resolveLive, fetchEphemeralBundle } = await import("./ephemeral-command-46SL27GJ.js");
     const summary = await resolveLive(auth3, auth3.workspaceId, name);
     step(`Reading ephemeral "${name}"`);
     return {
@@ -6923,4 +7014,4 @@ export {
   verifyCrashEntry,
   blameGeneratedFile
 };
-//# sourceMappingURL=chunk-2V4YE6QC.js.map
+//# sourceMappingURL=chunk-OARSPAIE.js.map