@xano/sdk 1.0.5 → 1.0.7

package/dist/{chunk-BBPAXOU6.js → chunk-BSVQEKHO.js}

@@ -4,25 +4,25 @@ import {
   sectionKind,
   tableAdditions,
   vectorSize
-} from "./chunk-SF2B7MZK.js";
+} from "./chunk-IYXL5NYU.js";
 import {
   ReleaseHttpError
-} from "./chunk-3BJYQGAZ.js";
+} from "./chunk-26LHXLD3.js";
 import {
   TenantHttpError
-} from "./chunk-4GDEEY2U.js";
+} from "./chunk-QGIZLFAS.js";
 import {
   CliError,
   detail,
   warn,
   withoutUrls
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
 import {
   authoredFieldType
-} from "./chunk-4DJTQ6W4.js";
+} from "./chunk-JIKGT7DO.js";
 
 // src/emit/plan-disclosure.ts
 var NO_TABLE_EFFECTS = {
@@ -677,4 +677,4 @@ export {
   CONSTRAINT_PHRASE,
   CONSTRAINT_FIX
 };
-//# sourceMappingURL=chunk-BBPAXOU6.js.map
+//# sourceMappingURL=chunk-BSVQEKHO.js.map

package/dist/{chunk-3WHWOKU4.js → chunk-BZ6WTG3E.js}

@@ -1,13 +1,13 @@
 import {
   workspaceEnvPathIn
-} from "./chunk-LLS2WO2K.js";
+} from "./chunk-PV25BDCH.js";
 import {
   addGitignoreRule,
   ensureGitignored,
   gitSaysIgnored,
   gitignoreRootFor,
   insideGitRepo
-} from "./chunk-OJPZEUPH.js";
+} from "./chunk-NDJAKSE7.js";
 import {
   UsageError,
   detail,
@@ -15,7 +15,7 @@ import {
   noteRunWarning,
   relForwardSlash,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 import {
   shellQuote
 } from "./chunk-5ZSO4T2G.js";
@@ -183,4 +183,4 @@ export {
   secretPathLabel,
   refuseIfTracked
 };
-//# sourceMappingURL=chunk-3WHWOKU4.js.map
+//# sourceMappingURL=chunk-BZ6WTG3E.js.map

package/dist/{chunk-XNZURZ7T.js → chunk-CH23ONYG.js}

@@ -1,6 +1,6 @@
 import {
   setDiagnosticSink
-} from "./chunk-GPI3OWRE.js";
+} from "./chunk-YHB34BN6.js";
 import {
   suggest
 } from "./chunk-UTI5G6OJ.js";
@@ -196,6 +196,27 @@ function projectFileCli(dir, manager) {
   if (manager === "npm" || manager === "yarn") return "npx xanosdk";
   return listingWorkspaceRoot(resolve3(dir)) === void 0 ? "npx xanosdk" : "npx --workspaces=false xanosdk";
 }
+var MCP_SERVER_NAME = "xano-local";
+var MCP_CONFIGS = [
+  { path: ".mcp.json", agent: "Claude Code" },
+  { path: ".cursor/mcp.json", agent: "Cursor", workspaceFolder: "${workspaceFolder}" }
+];
+function mcpServerCommand(dir, manager, opts = {}) {
+  const folder = opts.workspaceFolder;
+  const npx = [
+    "npx",
+    "--yes",
+    "--package",
+    "@xano/sdk",
+    ...projectFileCli(dir, manager) === "npx xanosdk" ? [] : ["--workspaces=false"],
+    "xanosdk",
+    "local",
+    "mcp",
+    "--stdio",
+    ...folder === void 0 ? [] : ["--project", folder]
+  ];
+  return (opts.platform ?? process.platform) === "win32" ? { command: "cmd", args: ["/c", ...npx] } : { command: npx[0], args: npx.slice(1) };
+}
 function spellProjectCli(text2, cli) {
   return cli === void 0 || cli === "npx xanosdk" ? text2 : text2.replace(/\bnpx xanosdk(?=[\s`'")\]]|$)/g, cli);
 }
@@ -1521,6 +1542,14 @@ var FLAGS = {
   all: { spec: "--all", summary: "Every stored profile, not just the active one" },
   "all-workspaces": { spec: "--all-workspaces", summary: "Enumerate across every workspace, not just the token's" },
   guest: { spec: "--guest, -g", summary: "Mint a read-only guest session (browse only)" },
+  stdio: {
+    spec: "--stdio",
+    summary: "Run as an MCP stdio server that forwards to the live engine with its current bearer \u2014 the command a coding agent's MCP config launches"
+  },
+  project: {
+    spec: "--project <dir>",
+    summary: "The project whose engine to reach, when the agent launches the bridge outside it (default: the current directory)"
+  },
   "url-only": { spec: "--url-only, -u", summary: "Print the dashboard URL instead of opening a browser" },
   prompt: { spec: "--prompt", summary: "Print only the add-on wiring prompt, for piping to a coding agent" },
   port: { spec: "--port <n>", summary: "Loopback callback port (default: 47100)" },
@@ -1544,8 +1573,8 @@ var FLAGS = {
   name: { spec: "--name <n>", summary: "Name for what this command produces" },
   framework: {
     spec: "--framework <id>",
-    summary: "Frontend framework to scaffold: react (default), svelte",
-    values: ["react", "svelte"]
+    summary: "Frontend to scaffold in a new project: react (default), svelte, or none for the backend only. A non-empty directory always gets the backend only",
+    values: ["react", "svelte", "none"]
   },
   theme: {
     spec: "--theme <id>",
@@ -1633,6 +1662,10 @@ var FLAGS = {
    * takes both.
    */
   force: { spec: "--force", summary: "Overwrite something that already exists" },
+  agent: {
+    spec: "--agent <id>",
+    summary: "Which agent to act for, instead of the ones detected (repeatable): claude-code, agents (the shared ~/.agents directory), codex, cursor, copilot, gemini, amp, opencode"
+  },
   "backend-dir": {
     spec: "--backend-dir <path>",
     summary: "The backend directory to act on, when this project does not keep it in xano/ and nothing on disk says so"
@@ -1780,7 +1813,7 @@ var SCAFFOLD = [
   "ai",
   {
     key: "force",
-    summary: "Write into a non-empty target directory. Over an existing project it lists every file it would overwrite and confirms first (--yes without a terminal); files the scaffold does not write are kept"
+    summary: "Write over what clashes when adding the backend to a non-empty target directory: an existing xano/, a file init would write, a xano:* script with another command. It lists every file and script it would overwrite and confirms first (--yes without a terminal); files the scaffold does not write are kept"
   },
   "no-install"
 ];
@@ -1865,7 +1898,7 @@ var COMMANDS = {
     // Toolchain modules contribute their own question flags; see the field's
     // doc for the obligation this takes on.
     deferUnknownFlags: true,
-    summary: "Scaffold a Xano SDK project \u2014 empty, or filled from an existing backend",
+    summary: "Scaffold a Xano SDK project \u2014 empty, or filled from an existing backend. In a non-empty directory, add the backend to the project there",
     args: [{ name: "dir", required: false, path: true }],
     // Two axes on top of the shared scaffold flags: WHERE `xano/` comes from
     // (`--from`) and HOW the options were collected (`--web`). They compose —
@@ -2492,6 +2525,15 @@ var COMMANDS = {
         args: [{ name: "name", required: false }],
         example: "XANO_META_TOKEN=$(xanosdk local token)"
       },
+      mcp: {
+        // Details by default, a bridge only on `--stdio`: an agent that runs
+        // this through its own shell tool must get an answer, not a server
+        // waiting on stdin.
+        summary: "Print how a coding agent connects to a Xano Engine's MCP server (look at the backend, seed rows, run functions, tasks, triggers, endpoints and tests); `--stdio` runs the bridge the agent's MCP config launches (default: the engine this project deployed to)",
+        args: [{ name: "name", required: false }],
+        flags: ["stdio", "project"],
+        example: "xanosdk local mcp"
+      },
       stop: {
         // The name is optional because `--all` stands in for it — and `--all`
         // is the form most runs want, since it covers every project.
@@ -2781,6 +2823,32 @@ var COMMANDS = {
     flags: ["check"],
     example: "xanosdk upgrade --check"
   },
+  "agent-skill": {
+    group: "Maintenance",
+    display: "agent-skill <install|uninstall|status>",
+    summary: "Install the xano-backend skill into the coding agents on this machine",
+    subcommands: {
+      install: {
+        summary: "Write the skill into the user-level skill directory of each detected agent; an edited copy is left alone unless --force",
+        flags: [
+          "agent",
+          { key: "dry-run", summary: "Report what would change and write nothing" },
+          { key: "force", summary: "Replace a copy that was edited since it was installed" }
+        ],
+        example: "xanosdk agent-skill install --agent claude-code"
+      },
+      uninstall: {
+        summary: "Remove the copies install wrote; an edited copy is reported and kept",
+        flags: ["agent", { key: "dry-run", summary: "Report what would be removed and remove nothing" }],
+        example: "xanosdk agent-skill uninstall"
+      },
+      status: {
+        summary: "Report each copy as current, stale, edited or absent",
+        flags: ["agent"],
+        example: "xanosdk agent-skill status --json"
+      }
+    }
+  },
   help: {
     group: "Maintenance",
     display: "help",
@@ -2959,6 +3027,9 @@ export {
   setTypedCwd,
   pastePath,
   projectFileCli,
+  MCP_SERVER_NAME,
+  MCP_CONFIGS,
+  mcpServerCommand,
   spellProjectCli,
   projectSdkDir,
   spellProjectSdkDir,
@@ -3040,4 +3111,4 @@ export {
   movedVerb,
   installCliDiagnosticSink
 };
-//# sourceMappingURL=chunk-XNZURZ7T.js.map
+//# sourceMappingURL=chunk-CH23ONYG.js.map

package/dist/{chunk-SQPIECXD.js → chunk-CJDPSCMX.js}

@@ -1,14 +1,15 @@
 import {
   applyLanding,
   withoutPrunedObjects
-} from "./chunk-5YBNXNKU.js";
+} from "./chunk-MFWF2NZJ.js";
 import {
   atomicWrite
 } from "./chunk-LLNZGEFK.js";
 import {
   parseLockReport,
-  serializeLock
-} from "./chunk-OKNE3TWU.js";
+  serializeLock,
+  withSyncedOf
+} from "./chunk-5KJBWIDZ.js";
 import {
   tagLockSource
 } from "./chunk-4BW2SG2N.js";
@@ -16,6 +17,37 @@ import {
 // src/lock/io.ts
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
+
+// src/lock/synced.ts
+function syncedOn(lock, destKey, branch) {
+  const record = lock?.synced?.[destKey];
+  return record !== void 0 && Object.hasOwn(record, branch) ? record[branch] : void 0;
+}
+function withSyncBaseline(lock, destKey, branch, baseline) {
+  const synced = { ...lock.synced ?? {} };
+  synced[destKey] = { ...synced[destKey] ?? {}, [branch]: baseline };
+  const { synced: _old, ...rest } = lock;
+  return withSyncedOf(rest, { synced });
+}
+function nextBaseline(previous, digests, by, complete, now = () => /* @__PURE__ */ new Date()) {
+  if (previous !== void 0 && previous.complete === complete && previous.scheme === digests.scheme && sameDigests(previous.objects, digests.objects) && sameDigests(previous.others ?? {}, digests.others)) {
+    return previous;
+  }
+  return {
+    at: now().toISOString(),
+    by,
+    scheme: digests.scheme,
+    complete,
+    objects: { ...digests.objects },
+    ...Object.keys(digests.others).length > 0 ? { others: { ...digests.others } } : {}
+  };
+}
+function sameDigests(a, b) {
+  const keys = Object.keys(a);
+  return keys.length === Object.keys(b).length && keys.every((k) => Object.hasOwn(b, k) && a[k] === b[k]);
+}
+
+// src/lock/io.ts
 function readLockFile(path, opts = {}) {
   return readLockFileReport(path, opts).lock;
 }
@@ -62,12 +94,20 @@ function forgetPrunedInLockFile(path, update) {
   writeLockFile(path, { ...lock, objects });
   return Object.keys(lock.objects).filter((key) => !(key in objects));
 }
+function recordSyncInLockFile(path, destKey, branch, sync) {
+  if (!existsSync(path)) return void 0;
+  const lock = readLockFile(path);
+  const baseline = nextBaseline(syncedOn(lock, destKey, branch), sync.digests, sync.by, sync.complete);
+  return { changed: writeLockFile(path, withSyncBaseline(lock, destKey, branch, baseline)) };
+}
 
 export {
+  syncedOn,
   readLockFile,
   readLockFileReport,
   writeLockFile,
   recordLandingInLockFile,
-  forgetPrunedInLockFile
+  forgetPrunedInLockFile,
+  recordSyncInLockFile
 };
-//# sourceMappingURL=chunk-SQPIECXD.js.map
+//# sourceMappingURL=chunk-CJDPSCMX.js.map

package/dist/{chunk-M7GJ6YUF.js → chunk-CNZASQPL.js}

@@ -1,6 +1,9 @@
+import {
+  byCodeUnit
+} from "./chunk-WAVNUTMT.js";
 import {
   UsageError
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 
 // src/emit/module-manifest.ts
 import { existsSync, readFileSync, statSync } from "fs";
@@ -97,6 +100,16 @@ function readInstalledManifest(dir, pkg) {
   const state = readInstalledManifestState(dir, pkg);
   return state.kind === "ok" ? state.manifest : null;
 }
+function requiredPeersOf(manifest) {
+  const peers = manifest["peerDependencies"];
+  if (typeof peers !== "object" || peers === null) return [];
+  const meta = manifest["peerDependenciesMeta"];
+  const optional = (name) => {
+    const entry = typeof meta === "object" && meta !== null ? meta[name] : void 0;
+    return typeof entry === "object" && entry !== null && entry.optional === true;
+  };
+  return Object.entries(peers).filter((e) => e[0] !== "@xano/sdk" && typeof e[1] === "string" && !optional(e[0])).sort(([a], [b]) => byCodeUnit(a, b));
+}
 function moduleKind(pkg, manifest) {
   const field = manifest["xanosdk"];
   if (typeof field !== "object" || field === null) return "workspace";
@@ -158,6 +171,7 @@ export {
   installedPackageDir,
   readInstalledManifestState,
   readInstalledManifest,
+  requiredPeersOf,
   moduleKind,
   entryFileOf,
   fileInPackage,
@@ -165,4 +179,4 @@ export {
   loadFile,
   homepageOf
 };
-//# sourceMappingURL=chunk-M7GJ6YUF.js.map
+//# sourceMappingURL=chunk-CNZASQPL.js.map

package/dist/{chunk-44CWK6YC.js → chunk-CPN6WSBH.js}

@@ -5,14 +5,14 @@ import {
   hostLabel,
   questionSets,
   resolvePluginAnswers
-} from "./chunk-I5VEROXW.js";
+} from "./chunk-JX6N73H3.js";
 import {
   gitattributesSpec
-} from "./chunk-DGWHAVRG.js";
+} from "./chunk-LJM5CIY4.js";
 import {
   UsageError,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 import {
   withArticle
 } from "./chunk-36JUQZVQ.js";
@@ -221,4 +221,4 @@ export {
   contributionOutcomes,
   resolveContributions
 };
-//# sourceMappingURL=chunk-44CWK6YC.js.map
+//# sourceMappingURL=chunk-CPN6WSBH.js.map

package/dist/{chunk-L3BDO2BI.js → chunk-CT3J5JRZ.js}

@@ -1,14 +1,14 @@
 import {
   confirm
-} from "./chunk-AESE434J.js";
+} from "./chunk-7M6JP3FS.js";
 import {
   ProfileNotFoundError,
   describeRefreshAnswer,
   environmentCredentialVars
-} from "./chunk-CJ76PSJT.js";
+} from "./chunk-YH2JVJAO.js";
 import {
   yesRerun
-} from "./chunk-Z4VN347O.js";
+} from "./chunk-UYFUIHH3.js";
 import {
   OpenIdProvider,
   assertCredentialFileRemovable,
@@ -31,11 +31,11 @@ import {
   resolveScope,
   withCredentialLock,
   writeOrRemoveCredentialFile
-} from "./chunk-OJPZEUPH.js";
+} from "./chunk-NDJAKSE7.js";
 import {
   findProjectPointer,
   resolveProjectProfile
-} from "./chunk-JZWUAEMO.js";
+} from "./chunk-ARWMVNDJ.js";
 import {
   resolveActiveProfile
 } from "./chunk-MF4W6FHU.js";
@@ -50,7 +50,7 @@ import {
   success,
   warn,
   writeJson
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 import {
   suggestAll
 } from "./chunk-UTI5G6OJ.js";
@@ -429,4 +429,4 @@ export {
   salvageRevocable,
   signInAgain
 };
-//# sourceMappingURL=chunk-L3BDO2BI.js.map
+//# sourceMappingURL=chunk-CT3J5JRZ.js.map

package/dist/{chunk-3HOGFGKG.js → chunk-D3KEPRRN.js}

@@ -1,6 +1,6 @@
 import {
   impliedInputs
-} from "./chunk-7GX445AE.js";
+} from "./chunk-4XHAT7C5.js";
 
 // src/validate/normalize.ts
 var STRIP_KEYS = /* @__PURE__ */ new Set([
@@ -1062,4 +1062,4 @@ export {
   filledContext,
   normalize
 };
-//# sourceMappingURL=chunk-3HOGFGKG.js.map
+//# sourceMappingURL=chunk-D3KEPRRN.js.map

package/dist/{chunk-OGUMHW2X.js → chunk-D5OZRJ3T.js}

@@ -1,7 +1,7 @@
 import {
   addDependency,
   removeDependency
-} from "./chunk-3VX7VAQT.js";
+} from "./chunk-EF4MHLEW.js";
 import {
   condenseNpmError,
   npmViewVersion
@@ -11,12 +11,12 @@ import {
 } from "./chunk-FWD7AL6N.js";
 import {
   isLocalSpecifier
-} from "./chunk-MYLPOVX6.js";
+} from "./chunk-47XT6WQL.js";
 import {
   addArgs,
   installSite,
   removeCommandFor
-} from "./chunk-WRBKLYSJ.js";
+} from "./chunk-DNBP4GJN.js";
 import {
   homepageOf,
   installedPackageDir,
@@ -25,14 +25,14 @@ import {
   moduleKind,
   packageNameOf,
   readInstalledManifest
-} from "./chunk-M7GJ6YUF.js";
+} from "./chunk-CNZASQPL.js";
 import {
   UsageError,
   spinner,
   step,
   success,
   warn
-} from "./chunk-XNZURZ7T.js";
+} from "./chunk-CH23ONYG.js";
 
 // src/emit/init-modules.ts
 import { existsSync, readFileSync, realpathSync } from "fs";
@@ -448,7 +448,7 @@ async function sdkPeerSkewOf(dir, pkg) {
   const manifest = readInstalledManifest(dir, pkg);
   if (manifest === null) return null;
   const [{ sdkPeerSkew }, { readVersion }] = await Promise.all([
-    import("./toolchain-modules-FD5ANV2U.js"),
+    import("./toolchain-modules-OTNSKK52.js"),
     import("./cli.js")
   ]);
   const sdkVersion = readVersion();
@@ -480,4 +480,4 @@ export {
   inProject,
   installModules
 };
-//# sourceMappingURL=chunk-OGUMHW2X.js.map
+//# sourceMappingURL=chunk-D5OZRJ3T.js.map