@xanots/sdk 0.0.3 → 0.0.4

package/dist/{chunk-W2G2WPTB.js → chunk-SWIXWJIY.js}

@@ -1,9 +1,9 @@
 import {
   compileBundle
-} from "./chunk-3NFUWXOC.js";
+} from "./chunk-DUC3PXDG.js";
 import {
   missingArgument
-} from "./chunk-6USV65XA.js";
+} from "./chunk-KGNJM4LN.js";
 
 // src/emit/bundle-input.ts
 import { existsSync, readFileSync } from "fs";
@@ -34,4 +34,4 @@ export {
   assertBundleInput,
   loadBundleText
 };
-//# sourceMappingURL=chunk-W2G2WPTB.js.map
+//# sourceMappingURL=chunk-SWIXWJIY.js.map

package/dist/{chunk-76QBEIGO.js → chunk-T4XPCJRF.js}

@@ -9,7 +9,8 @@ var ROUND_TRIP_KINDS = [
   { key: "tool", fixtureDir: "toolset" },
   { key: "middleware", fixtureDir: "middleware" },
   { key: "addon", fixtureDir: "addon" },
-  { key: "workflow_test", fixtureDir: "workflow-test" }
+  { key: "workflow_test", fixtureDir: "workflow-test" },
+  { key: "knowledge", fixtureDir: "knowledge" }
 ];
 var FIXTURE_DIR_BY_KIND = new Map(ROUND_TRIP_KINDS.map((k) => [k.key, k.fixtureDir]));
 var RUNNABLE_KINDS = new Set(ROUND_TRIP_KINDS.filter((k) => k.runnable).map((k) => k.key));
@@ -63,4 +64,4 @@ export {
   indexByIdentity,
   resolveMatch
 };
-//# sourceMappingURL=chunk-76QBEIGO.js.map
+//# sourceMappingURL=chunk-T4XPCJRF.js.map

package/dist/chunk-T6N3VMMO.js

@@ -0,0 +1,173 @@
+import {
+  readVersion
+} from "./chunk-DUC3PXDG.js";
+import {
+  atomicWrite
+} from "./chunk-GNPVYOPB.js";
+import {
+  blank,
+  detail,
+  style,
+  warn
+} from "./chunk-EZG76F7R.js";
+
+// src/emit/update-check.ts
+import { existsSync, readFileSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { createRequire } from "module";
+function registryUrl() {
+  return process.env.XANOTS_UPDATE_REGISTRY ?? "https://registry.npmjs.org/@xanots/sdk/latest";
+}
+function cachePath() {
+  return process.env.XANOTS_UPDATE_CACHE ?? join(homedir(), ".xanots", "update-check.json");
+}
+var CHECK_INTERVAL_MS = 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 2e3;
+var CHECK_TIMEOUT_MS = 1e4;
+function isNewer(candidate, current) {
+  const a = parseSemver(candidate);
+  const b = parseSemver(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    if (a.nums[i] !== b.nums[i]) return a.nums[i] > b.nums[i];
+  }
+  if (a.pre.length === 0) return b.pre.length > 0;
+  if (b.pre.length === 0) return false;
+  return comparePre(a.pre, b.pre) > 0;
+}
+function parseSemver(v) {
+  const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(v.trim());
+  if (!m) return null;
+  return {
+    nums: [Number(m[1]), Number(m[2]), Number(m[3])],
+    pre: m[4] ? m[4].split(".") : []
+  };
+}
+function comparePre(a, b) {
+  const len = Math.max(a.length, b.length);
+  for (let i = 0; i < len; i++) {
+    if (i >= a.length) return -1;
+    if (i >= b.length) return 1;
+    const x = a[i];
+    const y = b[i];
+    const xn = /^\d+$/.test(x);
+    const yn = /^\d+$/.test(y);
+    if (xn && yn) {
+      if (Number(x) !== Number(y)) return Number(x) < Number(y) ? -1 : 1;
+    } else if (xn !== yn) {
+      return xn ? -1 : 1;
+    } else if (x !== y) {
+      return x < y ? -1 : 1;
+    }
+  }
+  return 0;
+}
+function readCache() {
+  const path = cachePath();
+  if (!existsSync(path)) return void 0;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (typeof parsed.latest === "string" && typeof parsed.checkedAt === "number") {
+      return { latest: parsed.latest, checkedAt: parsed.checkedAt };
+    }
+  } catch {
+  }
+  return void 0;
+}
+function writeCache(cache) {
+  try {
+    const path = cachePath();
+    mkdirSync(dirname(path), { recursive: true });
+    atomicWrite(path, JSON.stringify(cache, null, 2) + "\n");
+  } catch {
+  }
+}
+async function fetchLatest(timeoutMs = FETCH_TIMEOUT_MS) {
+  try {
+    const res = await fetch(registryUrl(), {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  }
+}
+var noticeSuppressed = false;
+function suppressUpdateNotice() {
+  noticeSuppressed = true;
+}
+function disabled() {
+  return Boolean(
+    noticeSuppressed || process.env.XANOTS_NO_UPDATE_CHECK || process.env.NO_UPDATE_NOTIFIER || process.env.CI
+  );
+}
+async function resolveUpdateNotice(opts) {
+  if (!opts?.force && disabled()) return null;
+  const current = opts?.current ?? readVersion();
+  if (current === "unknown") return null;
+  const cache = readCache();
+  let latest = cache?.latest;
+  const now = Date.now();
+  if (!cache || now - cache.checkedAt > CHECK_INTERVAL_MS) {
+    const fetched = await fetchLatest();
+    if (fetched) {
+      latest = fetched;
+      writeCache({ latest: fetched, checkedAt: now });
+    }
+  }
+  return latest && isNewer(latest, current) ? { current, latest } : null;
+}
+async function checkForUpgrade(opts) {
+  const current = opts?.current ?? readVersion();
+  if (current === "unknown") return { status: "unknown", reason: "local-version" };
+  const latest = await fetchLatest(CHECK_TIMEOUT_MS);
+  if (latest === null) return { status: "unknown", reason: "registry" };
+  writeCache({ latest, checkedAt: Date.now() });
+  return { status: isNewer(latest, current) ? "available" : "current", current, latest };
+}
+function detectInstallMode() {
+  const override = process.env.XANOTS_INSTALL_MODE;
+  if (override === "global" || override === "local") return override;
+  try {
+    const requireFromCwd = createRequire(join(process.cwd(), "package.json"));
+    requireFromCwd.resolve("@xanots/sdk/package.json");
+    return "local";
+  } catch {
+    return "global";
+  }
+}
+function upgradeCommand(mode) {
+  return mode === "global" ? "npm i -g @xanots/sdk@latest" : "npm i -D @xanots/sdk@latest";
+}
+function printUpdateNotice(notice) {
+  blank();
+  warn(
+    `A new @xanots/sdk is available: ${style.dim(notice.current)} \u2192 ${style.green(notice.latest)}`
+  );
+  detail(`update: ${upgradeCommand(detectInstallMode())}`);
+}
+function runExitedClean(code = process.exitCode) {
+  return code === void 0 || code === 0;
+}
+async function maybeNotifyUpdate() {
+  try {
+    if (disabled() || process.stderr.isTTY !== true || !runExitedClean()) return;
+    const notice = await resolveUpdateNotice();
+    if (notice) printUpdateNotice(notice);
+  } catch {
+  }
+}
+
+export {
+  registryUrl,
+  suppressUpdateNotice,
+  checkForUpgrade,
+  detectInstallMode,
+  upgradeCommand,
+  maybeNotifyUpdate
+};
+//# sourceMappingURL=chunk-T6N3VMMO.js.map

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

@@ -15,7 +15,10 @@ import {
   normalize,
   retiredInputSuccessor,
   retiredInputs
-} from "./chunk-P3TTMWUP.js";
+} from "./chunk-ZOYMZZ3S.js";
+import {
+  getAccessToken
+} from "./chunk-C56BC2FY.js";
 import {
   exportWorkspaceBundle
 } from "./chunk-QTNO2WD6.js";
@@ -24,18 +27,15 @@ import {
   resolveFrontendPreset,
   resolveThemeChoice,
   sanitizeAppName
-} from "./chunk-HQ2CBRVI.js";
+} from "./chunk-EAIR6VUL.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-DUC3PXDG.js";
 import {
   UsageError
-} from "./chunk-6USV65XA.js";
+} from "./chunk-KGNJM4LN.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-PCZ5FL4U.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-6WJW7LP6.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-VKD3EBKG.js.map

package/dist/{chunk-BT2CSEC5.js → chunk-VWGJQTNA.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DGSF2Q5H.js";
 import {
   sandboxBaseUrl
-} from "./chunk-7DKX2SPN.js";
+} from "./chunk-ACQCK4DT.js";
 import {
   fetchReadOrExplain,
   httpFailure
@@ -66,7 +66,7 @@ async function resolveMetaTarget(auth, opts, deps = {}) {
     case "sandbox":
       return resolveSandbox(auth);
     case "ephemeral": {
-      const resolveLive = deps.resolveLive ?? (await import("./ephemeral-command-JL4TPIRQ.js")).resolveLive;
+      const resolveLive = deps.resolveLive ?? (await import("./ephemeral-command-6WJW7LP6.js")).resolveLive;
       return resolveEphemeral(auth, opts.name, { ...deps, resolveLive });
     }
   }
@@ -75,4 +75,4 @@ async function resolveMetaTarget(auth, opts, deps = {}) {
 export {
   resolveMetaTarget
 };
-//# sourceMappingURL=chunk-BT2CSEC5.js.map
+//# sourceMappingURL=chunk-VWGJQTNA.js.map