@xano/sdk 1.0.7 → 1.0.8

package/llms-full.txt

@@ -1,4 +1,4 @@
-# xanosdk v1.0.7
+# xanosdk v1.0.8
 
 > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
 
@@ -766,7 +766,7 @@ core sections still refresh; under `routes --emit --strict` it is fatal. `@xano-
 - A response types as `StackTupleWidened` — a `Statement[]` helper was spread into the stack; return `statements(...)`. `llms.txt`; `llms/statements-runtime.md`.
 - `ERR_PACKAGE_PATH_NOT_EXPORTED` — `tsx -e "import …"`, or running from outside the project root; run a real file with `tsx <file.ts>` from the root. `llms/client.md`.
 - `Missing statement: mvp:placeholder` on import — an unconfigured slot in a pulled tree; replace it with the statement it stands in for. `llms/legacy.md`.
-- A CLI command fails under `--json` or piped (unless stdout carries data): stdout is `{ ok: false, error: { code, message, exitCode, details?, suggestion? } }`, as does a failed release write. Codes: `SDK_SEED_IN_STATIC` (`details.leaks[]` → `publicSeed`), `SDK_EXPORT_INVALID` (`details.diagnostics[]`, `--strict` too), `SDK_DRIFT`, `SDK_BRANCH_TAKEN`, `SDK_BRANCH_LIVE`, `SDK_RELEASE_NAME_TAKEN`, `SDK_RELEASE_FILES_NOT_CARRIED`, `SDK_LIVE_BRANCH_MISMATCH` (`details.conflictsWith`), `SDK_IDENTITY_CONFLICT`, `SDK_KIND_CONFLICT`, `SDK_PRUNE_OUT_OF_SCOPE`, `SDK_IMPORT_REFUSED`, `SDK_SHARED_SCHEMA_CHANGE`, `SDK_CONSTRAINT_VIOLATION`, `SDK_CREDENTIAL_REJECTED` (`details`: `{ profile, credentialType, instance, workspaceId, signIn }`; ids null on a refused env refresh), `SDK_USAGE` (`details.reason: "needs-confirmation"`: run its `Re-run as`), `SDK_ERROR`. Landing refusal `details.refused`: identityConflict, renamePending, kindConflict, uniqueViolation, tableTrigger, importInProgress, importRefused, pruneOutOfScope. `warnings[]` / `details.warnings` / `accepted[]` entries: `{ code, message, subject? }` (`subject`: the def's `{ kind, name }`). Backend documents add `selector` and `workspaceId`.
+- A CLI command fails under `--json` or piped (unless stdout carries data): stdout is `{ ok: false, error: { code, message, exitCode, details?, suggestion? } }`, as does a failed release write. Codes: `SDK_SEED_IN_STATIC` (`details.leaks[]` → `publicSeed`), `SDK_EXPORT_INVALID` (`details.diagnostics[]`, `--strict` too), `SDK_DRIFT`, `SDK_BRANCH_TAKEN`, `SDK_BRANCH_LIVE`, `SDK_RELEASE_NAME_TAKEN`, `SDK_RELEASE_FILES_NOT_CARRIED`, `SDK_LIVE_BRANCH_MISMATCH` (`details.conflictsWith`), `SDK_IDENTITY_CONFLICT`, `SDK_KIND_CONFLICT`, `SDK_PRUNE_OUT_OF_SCOPE`, `SDK_IMPORT_REFUSED`, `SDK_SHARED_SCHEMA_CHANGE`, `SDK_CONSTRAINT_VIOLATION`, `SDK_CREDENTIAL_REJECTED` (`details`: `{ profile, credentialType, instance, workspaceId, signIn }`; ids null on a refused env refresh), `SDK_WORKSPACE_CHANGED` (deploy over objects edited in Xano since the last sync; `details.objects`; pull first or `--overwrite`), `SDK_USAGE` (`details.reason: "needs-confirmation"`: run its `Re-run as`), `SDK_ERROR`. Landing refusal `details.refused`: identityConflict, renamePending, kindConflict, uniqueViolation, tableTrigger, importInProgress, importRefused, pruneOutOfScope. `warnings[]` / `details.warnings` / `accepted[]` entries: `{ code, message, subject? }` (`subject`: the def's `{ kind, name }`). Backend documents add `selector` and `workspaceId`.
 - A CLI command reports `could not reach <url>: fetch failed (<code>)` — blocked egress, not a bad credential; fix it before `xanosdk login`, which rotates a single-use refresh token.
 
 ### CLI exit codes
@@ -874,7 +874,7 @@ The run is isolated in ways that make a correct test fail for reasons the failur
   - `llm` (REQUIRED): typed provider settings, a discriminated union on `type` (`"xano-free" | "anthropic" | "openai" | "google-genai"`). Shared fields: `systemPrompt?`, `maxSteps?` (default `5`), and `prompt?` XOR `messages?` (genuinely exclusive: both is a type error and throws — the engine stores ONE `prompt_type`, so one would be dropped); plus provider fields (`apiKey?`, `model?`, `temperature?`, `reasoningEffort?`, …). String fields accept Twig placeholders — `{{ $args.x }}` for run inputs (the `args` of `s.ai.agent.run`), `{{ $env.NAME }}` for env vars.
   - `tools?`: same `ToolsetToolEntry[]` as `mcpServer` — bare `tool()` handles, or a `{ tool, enabled?, auth? }` wrapper when one needs `enabled`/`auth`. A tool reading `auth()` MUST use the wrapper naming the auth table — a bare handle runs it with no caller (see `mcpServer`'s `tools?`).
   - `output?`: `{ schema: Record<string, input.*>, enabled? }` — structured-output schema. `schema` is a named-field record authored with the `input.*` catalog, exactly like a `defineFunction`/`query` `input:` map (the stored `structuredOutputsSchema` is the same wire shape as function inputs). e.g. `output: { schema: { priority: input.enum(["low","high"]), summary: input.text() } }`. When you pass the agent *handle* to `s.ai.agent.run({ agent })`, `.result` is typed straight from this schema — no `resultShape` witness needed (the shape is declared once). `resultShape` remains only to override that, or to type an agent referenced by bare name.
-  - **Run + read recipe (`s.ai.agent.run`):** bind the run to a var (`s.ai.agent.run({ agent, args, as: "run" })`) — it produces a rich envelope, and the completion is at **`.result`**. Read one structured field with a dotted ref (`response: ref("run.result.priority")`) or the whole completion (`ref("run.result")`, typed from `output.schema`); persist it in a later step the same way (`s.set_var("summary", ref("run.result.summary"))`). `args` is a plain object of run inputs (`{ topic: inp("topic") }` — raw literals are fine, e.g. `{ max_steps: 3 }`) surfaced to the agent as `{{ $args.topic }}`. `.toolCalls` is the FINAL step's calls only (often `[]`); every call is a `.steps[].content[]` entry of `type: "tool-call"`.
+  - **Run + read recipe (`s.ai.agent.run`):** bind the run to a var (`s.ai.agent.run({ agent, args, allowToolExecution: c.bool(true), as: "run" })`) — it produces a rich envelope, and the completion is at **`.result`**. Read one structured field with a dotted ref (`response: ref("run.result.priority")`) or the whole completion (`ref("run.result")`, typed from `output.schema`); persist it in a later step the same way (`s.set_var("summary", ref("run.result.summary"))`). `args` is a plain object of run inputs (`{ topic: inp("topic") }` — raw literals are fine, e.g. `{ max_steps: 3 }`) surfaced to the agent as `{{ $args.topic }}`. `.toolCalls` is the FINAL step's calls only (often `[]`); every call is a `.steps[].content[]` entry of `type: "tool-call"`. ⚠ An agent with tools needs `allowToolExecution: c.bool(true)` on the run: unset, its tools are OFF and it answers without them (warns `stack.agent-tools-off`).
   - **Marketplace:** for chat history, use `@xano-sdk/chatbot`; for vector RAG, use `@xano-sdk/vector` (`tools: [vector.searchTool]`). Find add-ons with `xanosdk marketplace search <q>`.
 - Both kinds persist under the `toolset` payload key, so a same-name `agent` + `mcpServer` pair derives ONE guid and `export()` throws — give them distinct names.
 

package/llms.txt

@@ -1,4 +1,4 @@
-# xanosdk v1.0.7
+# xanosdk v1.0.8
 
 > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
 

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "xanosdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.",
   "coverage": {
     "objectKinds": {
@@ -9118,6 +9118,10 @@
           "flag": "--allow-shared-schema-changes",
           "description": "Proceed even though table/microservice changes reach every branch — only with --to"
         },
+        {
+          "flag": "--overwrite",
+          "description": "Deploy over objects changed in Xano since the last deploy or pull (see `workspace diff`) — only with --to"
+        },
         {
           "flag": "--allow-branch-deletion",
           "description": "Acknowledge that --replace permanently deletes the workspace's other branches — only with --to"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/sdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Xano SDK — your Xano backend as TypeScript. `xanosdk deploy` ships your typed workspace (and an optional static frontend) to a live, auto-expiring ephemeral environment and prints its URL. init → deploy → URL.",
   "keywords": [
     "xanosdk",

package/skills/xano-backend/SKILL.md

@@ -14,8 +14,8 @@ description: >-
   FastAPI) unless the user asks for Xano.
 license: MIT
 metadata:
-  xanosdk-version: "1.0.7"
-  xanosdk-digest: "sha256:335ffa095690ba305b28ede608a35590cb247a0b0954b41d2eda3046ed051fae"
+  xanosdk-version: "1.0.8"
+  xanosdk-digest: "sha256:1473ad316197d3149c9222c5e54e206572a25319536a7fb2f3f22443db2c1088"
 ---
 
 # Xano backend

package/dist/promote-command-BDRPG6UU.js

@@ -1,147 +0,0 @@
-import {
-  assertNoMergeFlags,
-  derivedPromoteLabel,
-  isDerivedPromoteLabel,
-  reportNotRun,
-  runPromoteCommand
-} from "./chunk-7XXWKTCE.js";
-import "./chunk-5ZG7V2VW.js";
-import "./chunk-DXZTL7NA.js";
-import "./chunk-SGK3PTTM.js";
-import "./chunk-B3P25SDP.js";
-import "./chunk-IPNN2KRW.js";
-import "./chunk-LBJA7IEM.js";
-import "./chunk-I6XRUU6U.js";
-import "./chunk-RRMH7WMY.js";
-import "./chunk-JI3BLXWQ.js";
-import "./chunk-NV37YGOV.js";
-import "./chunk-N3YFCFCO.js";
-import "./chunk-7M6JP3FS.js";
-import "./chunk-BSVQEKHO.js";
-import "./chunk-FNLTFOUD.js";
-import "./chunk-H2K4GFUS.js";
-import "./chunk-2YER2J47.js";
-import "./chunk-VAGSKUWC.js";
-import "./chunk-L472YIGG.js";
-import "./chunk-567KK6XF.js";
-import "./chunk-2SD4LA22.js";
-import "./chunk-3DRXWLJ5.js";
-import "./chunk-X4DVXBFY.js";
-import "./chunk-M2C54ZBC.js";
-import "./chunk-GHMLRFRX.js";
-import "./chunk-JOOKM7AH.js";
-import "./chunk-2TFRR6JV.js";
-import "./chunk-IYXL5NYU.js";
-import "./chunk-BZ6WTG3E.js";
-import "./chunk-DG3APBUJ.js";
-import "./chunk-VIJ5D3RC.js";
-import "./chunk-PV25BDCH.js";
-import "./chunk-B2URJBC4.js";
-import "./chunk-S46ODQRA.js";
-import "./chunk-TWVUYS63.js";
-import "./chunk-26LHXLD3.js";
-import "./chunk-ZJOAWRED.js";
-import "./chunk-MBL7CXJ7.js";
-import "./chunk-YH2JVJAO.js";
-import "./chunk-VNDR2T35.js";
-import "./chunk-EPFDY5JU.js";
-import "./chunk-A4R5CAY4.js";
-import "./chunk-LCOCRJ4K.js";
-import "./chunk-WNCW2RNB.js";
-import "./chunk-QGIZLFAS.js";
-import "./chunk-2MNLRIOX.js";
-import "./chunk-AKERAUNH.js";
-import "./chunk-CJDPSCMX.js";
-import "./chunk-ZXRDD3Q2.js";
-import "./chunk-PY722CHR.js";
-import "./chunk-ZGLNHA7T.js";
-import "./chunk-ORGNLQN6.js";
-import "./chunk-ZYJP6BOO.js";
-import "./chunk-QO6BVGS5.js";
-import "./chunk-PEX4QZVI.js";
-import "./chunk-MYZRMSPM.js";
-import "./chunk-UYFUIHH3.js";
-import "./chunk-622HUCZT.js";
-import "./chunk-3FRGNBOC.js";
-import "./chunk-NDJAKSE7.js";
-import "./chunk-EUUUMY7J.js";
-import "./chunk-5SCPRXFB.js";
-import "./chunk-DIWF7L33.js";
-import "./chunk-D5OZRJ3T.js";
-import "./chunk-EF4MHLEW.js";
-import "./chunk-ZFDZKNGG.js";
-import "./chunk-FWD7AL6N.js";
-import "./chunk-47XT6WQL.js";
-import "./chunk-DXUICABI.js";
-import "./chunk-L6HZ67P6.js";
-import "./chunk-4KHEMC32.js";
-import "./chunk-FDTET7FZ.js";
-import "./chunk-MFWF2NZJ.js";
-import "./chunk-DNBP4GJN.js";
-import "./chunk-CNZASQPL.js";
-import "./chunk-WAVNUTMT.js";
-import "./chunk-ARWMVNDJ.js";
-import "./chunk-LLNZGEFK.js";
-import "./chunk-HU7F56VF.js";
-import "./chunk-MF4W6FHU.js";
-import "./chunk-X2NL4KUO.js";
-import "./chunk-4GPIOIAC.js";
-import "./chunk-SKEG3V2V.js";
-import "./chunk-E763QI3G.js";
-import "./chunk-BRANWM4U.js";
-import "./chunk-5GIOCDUM.js";
-import "./chunk-LJM5CIY4.js";
-import "./chunk-7THDHQ4R.js";
-import "./chunk-3YW23UFH.js";
-import "./chunk-7REDHC4N.js";
-import "./chunk-CH23ONYG.js";
-import "./chunk-FQ53GTII.js";
-import "./chunk-VJFMUJWZ.js";
-import "./chunk-6JAEMMZ7.js";
-import "./chunk-5QMJOE2K.js";
-import "./chunk-45ZUMF4E.js";
-import "./chunk-7KPKDHHI.js";
-import "./chunk-7FIMUFBP.js";
-import "./chunk-T4LJ5UR2.js";
-import "./chunk-ICK36EGF.js";
-import "./chunk-BEXZ4XRV.js";
-import "./chunk-ETAZIGNT.js";
-import "./chunk-GSGDWJB5.js";
-import "./chunk-SLGJIWCY.js";
-import "./chunk-ERVIASGL.js";
-import "./chunk-VTMTIBKP.js";
-import "./chunk-H2V3N23D.js";
-import "./chunk-3JDU4VRL.js";
-import "./chunk-WTPZRR4I.js";
-import "./chunk-YHB34BN6.js";
-import "./chunk-UTI5G6OJ.js";
-import "./chunk-5KJBWIDZ.js";
-import "./chunk-5ZSO4T2G.js";
-import "./chunk-VQPDATQT.js";
-import "./chunk-UDZX2ZL4.js";
-import "./chunk-ZY55DO5P.js";
-import "./chunk-A2AOUBJS.js";
-import "./chunk-TFFGOFVZ.js";
-import "./chunk-7VR4IO5B.js";
-import "./chunk-EHP3WPEG.js";
-import "./chunk-D3KEPRRN.js";
-import "./chunk-Q7DGTQ5G.js";
-import "./chunk-4XHAT7C5.js";
-import "./chunk-S56YBYMN.js";
-import "./chunk-UVF45BVU.js";
-import "./chunk-VAX3UZOY.js";
-import "./chunk-LL6ED5IB.js";
-import "./chunk-4BW2SG2N.js";
-import "./chunk-JIKGT7DO.js";
-import "./chunk-4MIV244X.js";
-import "./chunk-OHX6MIUZ.js";
-import "./chunk-36JUQZVQ.js";
-import "./chunk-PZ5AY32C.js";
-export {
-  assertNoMergeFlags,
-  derivedPromoteLabel,
-  isDerivedPromoteLabel,
-  reportNotRun,
-  runPromoteCommand
-};
-//# sourceMappingURL=promote-command-BDRPG6UU.js.map