@xanots/sdk 0.0.13 → 0.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/.build-fingerprint +1 -1
  3. package/dist/{agent-file-refresh-GQWAAOBV.js → agent-file-refresh-2LZ2YRFZ.js} +3 -3
  4. package/dist/bin.js +2 -2
  5. package/dist/{chunk-2AY3PKF4.js → chunk-CII2TOE4.js} +2 -2
  6. package/dist/{chunk-2VTJSI6X.js → chunk-F3MRG7NI.js} +2 -2
  7. package/dist/{chunk-RLI6XD4O.js → chunk-LISUHLWI.js} +9 -9
  8. package/dist/{chunk-S3DOJOW4.js → chunk-ORZINVGQ.js} +4 -4
  9. package/dist/{chunk-SS2V2QOG.js → chunk-UQMMFW32.js} +4 -4
  10. package/dist/{chunk-OONT4ZL4.js → chunk-UXPDQFG2.js} +2 -2
  11. package/dist/{chunk-VK26K7AY.js → chunk-XBIFQWZM.js} +2 -2
  12. package/dist/cli.js +1 -1
  13. package/dist/{codegen-command-ZDHMGFWZ.js → codegen-command-5A6FVKUA.js} +5 -5
  14. package/dist/{deploy-command-CGVKRWUE.js → deploy-command-VBB7JYXH.js} +3 -3
  15. package/dist/{init-command-DNDONP3O.js → init-command-SIJUH2DD.js} +4 -4
  16. package/dist/internal.js +357 -259
  17. package/dist/{lock-commands-6U7UIJGR.js → lock-commands-4TX3BONI.js} +2 -2
  18. package/dist/node.js +1 -1
  19. package/dist/{preflight-command-UYE7SUQV.js → preflight-command-MTYGPNVT.js} +3 -3
  20. package/dist/{release-command-CMMYT6XK.js → release-command-NXCPQDFF.js} +5 -5
  21. package/dist/{upgrade-command-A75DOIUH.js → upgrade-command-GSH3M3N6.js} +5 -5
  22. package/dist/{workspace-command-YELP47SJ.js → workspace-command-XUOPLVQ4.js} +5 -5
  23. package/guides/README.md +1 -1
  24. package/guides/coverage.md +3 -2
  25. package/llms/client.md +44 -0
  26. package/llms/errors.md +33 -0
  27. package/llms/fields.md +26 -1
  28. package/llms/filters.md +4 -8
  29. package/llms/kinds-agent-mcp.md +1 -0
  30. package/llms/kinds-core.md +16 -2
  31. package/llms/kinds-knowledge.md +1 -1
  32. package/llms/kinds-realtime.md +1 -1
  33. package/llms/lambda.md +1 -1
  34. package/llms/legacy.md +1 -1
  35. package/llms/object-kinds.md +2 -2
  36. package/llms/statements-calls.md +25 -4
  37. package/llms/statements-catalog.md +1 -1
  38. package/llms/statements-runtime.md +20 -5
  39. package/llms/tests.md +2 -2
  40. package/llms/triggers.md +14 -2
  41. package/llms/values.md +2 -2
  42. package/llms-full.txt +359 -267
  43. package/llms.txt +163 -234
  44. package/manifest.json +4 -4
  45. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -11,6 +11,24 @@ listed here.
11
11
 
12
12
  ---
13
13
 
14
+ ## 0.0.13 — The realtime gate contract
15
+
16
+ _2026-09-01_ · [release notes](https://github.com/xanots/sdk/releases/tag/v0.0.13)
17
+
18
+ Realtime v2 lifecycle triggers get their contract straightened out. A `join`
19
+ gate written the way the docs described — reading a channel path param as
20
+ `inp("room_id")` — raises at runtime and refuses every client, and a `deliver`
21
+ trigger had no typed way to read the payload it exists to transform. Both are
22
+ fixed, along with two gate rules the docs never carried. Every claim here was
23
+ verified by driving a real websocket client against a live engine.
24
+
25
+ - ⚠️ A channel path param is not a lifecycle-trigger input — read it from the session
26
+ - A `deliver` trigger now reads its payload through the typed handle
27
+ - Inside `{ allowed }`, admission needs strictly `true`
28
+ - A gate establishes no auth, so `auth.id` reads 0
29
+
30
+ ---
31
+
14
32
  ## 0.0.12 — Values that answer themselves
15
33
 
16
34
  _2026-09-01_ · [release notes](https://github.com/xanots/sdk/releases/tag/v0.0.12)
@@ -1 +1 @@
1
- 294848d031f8fcc6b5fef740b901bc334009baf326298dfa54c191bede5c3847
1
+ 7b8e52c911b48104cfe7d9149c775718a1c8a362e2dbdfbde6eafb66b2353c3d
@@ -3,8 +3,8 @@ import {
3
3
  codingAgentDetected,
4
4
  isCI,
5
5
  refreshAgentFiles
6
- } from "./chunk-2VTJSI6X.js";
7
- import "./chunk-VK26K7AY.js";
6
+ } from "./chunk-F3MRG7NI.js";
7
+ import "./chunk-XBIFQWZM.js";
8
8
  import "./chunk-ZSYZTGJH.js";
9
9
  import "./chunk-RQNMTDXD.js";
10
10
  import "./chunk-EZG76F7R.js";
@@ -14,4 +14,4 @@ export {
14
14
  isCI,
15
15
  refreshAgentFiles
16
16
  };
17
- //# sourceMappingURL=agent-file-refresh-GQWAAOBV.js.map
17
+ //# sourceMappingURL=agent-file-refresh-2LZ2YRFZ.js.map
package/dist/bin.js CHANGED
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  maybeNotifyUpdate
4
- } from "./chunk-2AY3PKF4.js";
4
+ } from "./chunk-CII2TOE4.js";
5
5
  import {
6
6
  readVersion,
7
7
  run
8
- } from "./chunk-RLI6XD4O.js";
8
+ } from "./chunk-LISUHLWI.js";
9
9
  import "./chunk-7WRJPKGK.js";
10
10
  import "./chunk-3LQGF2WS.js";
11
11
  import {
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  readVersion
3
- } from "./chunk-RLI6XD4O.js";
3
+ } from "./chunk-LISUHLWI.js";
4
4
  import {
5
5
  atomicWrite
6
6
  } from "./chunk-GNPVYOPB.js";
@@ -170,4 +170,4 @@ export {
170
170
  upgradeCommand,
171
171
  maybeNotifyUpdate
172
172
  };
173
- //# sourceMappingURL=chunk-2AY3PKF4.js.map
173
+ //# sourceMappingURL=chunk-CII2TOE4.js.map
@@ -5,7 +5,7 @@ import {
5
5
  presetFilePath,
6
6
  renderPreset,
7
7
  upsertManagedBlock
8
- } from "./chunk-VK26K7AY.js";
8
+ } from "./chunk-XBIFQWZM.js";
9
9
  import {
10
10
  DEFAULT_DARK_MODE,
11
11
  allFrontendPresets,
@@ -189,4 +189,4 @@ export {
189
189
  isCI,
190
190
  refreshAgentFiles
191
191
  };
192
- //# sourceMappingURL=chunk-2VTJSI6X.js.map
192
+ //# sourceMappingURL=chunk-F3MRG7NI.js.map
@@ -1008,7 +1008,7 @@ async function run(argv) {
1008
1008
  return;
1009
1009
  }
1010
1010
  if (command === "init") {
1011
- const { runInitCommand } = await import("./init-command-DNDONP3O.js");
1011
+ const { runInitCommand } = await import("./init-command-SIJUH2DD.js");
1012
1012
  return runInitCommand(args);
1013
1013
  }
1014
1014
  if (command === "completion") {
@@ -1023,11 +1023,11 @@ async function run(argv) {
1023
1023
  return runCompletionCommand(shell);
1024
1024
  }
1025
1025
  if (command === "upgrade") {
1026
- const { runUpgradeCommand } = await import("./upgrade-command-A75DOIUH.js");
1026
+ const { runUpgradeCommand } = await import("./upgrade-command-GSH3M3N6.js");
1027
1027
  return runUpgradeCommand(args);
1028
1028
  }
1029
1029
  if (command === "lock") {
1030
- const { runLockCommand } = await import("./lock-commands-6U7UIJGR.js");
1030
+ const { runLockCommand } = await import("./lock-commands-4TX3BONI.js");
1031
1031
  return runLockCommand(args);
1032
1032
  }
1033
1033
  if (command === "login") {
@@ -1039,7 +1039,7 @@ async function run(argv) {
1039
1039
  return runLogoutCommand(args);
1040
1040
  }
1041
1041
  if (command === "deploy") {
1042
- const { runDeployCommand } = await import("./deploy-command-CGVKRWUE.js");
1042
+ const { runDeployCommand } = await import("./deploy-command-VBB7JYXH.js");
1043
1043
  return runDeployCommand(args);
1044
1044
  }
1045
1045
  if (command === "ephemeral") {
@@ -1047,7 +1047,7 @@ async function run(argv) {
1047
1047
  return runEphemeralCommand(args);
1048
1048
  }
1049
1049
  if (command === "release") {
1050
- const { runReleaseCommand } = await import("./release-command-CMMYT6XK.js");
1050
+ const { runReleaseCommand } = await import("./release-command-NXCPQDFF.js");
1051
1051
  return runReleaseCommand(args);
1052
1052
  }
1053
1053
  if (command === "test") {
@@ -1055,7 +1055,7 @@ async function run(argv) {
1055
1055
  return runTestCommand(args);
1056
1056
  }
1057
1057
  if (command === "workspace") {
1058
- const { runWorkspaceCommand } = await import("./workspace-command-YELP47SJ.js");
1058
+ const { runWorkspaceCommand } = await import("./workspace-command-XUOPLVQ4.js");
1059
1059
  return runWorkspaceCommand(args);
1060
1060
  }
1061
1061
  if (command === "status") {
@@ -1087,7 +1087,7 @@ async function run(argv) {
1087
1087
  throw unknownCommand("push");
1088
1088
  }
1089
1089
  if (command === "preflight") {
1090
- const { runPreflightCommand } = await import("./preflight-command-UYE7SUQV.js");
1090
+ const { runPreflightCommand } = await import("./preflight-command-MTYGPNVT.js");
1091
1091
  return runPreflightCommand(args);
1092
1092
  }
1093
1093
  if (command !== "compile" && command !== "export" && command !== "paths" && command !== "routes") {
@@ -1120,7 +1120,7 @@ async function run(argv) {
1120
1120
  async function refreshAgentGuidance(args) {
1121
1121
  if (args.noRefresh) return;
1122
1122
  try {
1123
- const { refreshAgentFiles } = await import("./agent-file-refresh-GQWAAOBV.js");
1123
+ const { refreshAgentFiles } = await import("./agent-file-refresh-2LZ2YRFZ.js");
1124
1124
  const refreshed = refreshAgentFiles({
1125
1125
  projectDir: process.cwd(),
1126
1126
  sdkVersion: readVersion()
@@ -1353,4 +1353,4 @@ export {
1353
1353
  exportBundleJson,
1354
1354
  compileBundle
1355
1355
  };
1356
- //# sourceMappingURL=chunk-RLI6XD4O.js.map
1356
+ //# sourceMappingURL=chunk-LISUHLWI.js.map
@@ -2,7 +2,7 @@ import {
2
2
  presetFilePath,
3
3
  resolveAiPresets,
4
4
  scaffoldProject
5
- } from "./chunk-VK26K7AY.js";
5
+ } from "./chunk-XBIFQWZM.js";
6
6
  import {
7
7
  runNpmCapturingStderr
8
8
  } from "./chunk-ZSYZTGJH.js";
@@ -37,7 +37,7 @@ import {
37
37
  } from "./chunk-RQNMTDXD.js";
38
38
  import {
39
39
  readVersion
40
- } from "./chunk-RLI6XD4O.js";
40
+ } from "./chunk-LISUHLWI.js";
41
41
  import {
42
42
  ENV_SPELLINGS,
43
43
  parseEnvSelector
@@ -440,7 +440,7 @@ function rejectPullOnlyFlags(args) {
440
440
  async function runInitCommand(args) {
441
441
  if (args.from !== void 0) {
442
442
  const source = resolveFromSource(args.from);
443
- const { runInitFromCommand } = await import("./codegen-command-ZDHMGFWZ.js");
443
+ const { runInitFromCommand } = await import("./codegen-command-5A6FVKUA.js");
444
444
  return runInitFromCommand(args, source);
445
445
  }
446
446
  rejectPullOnlyFlags(args);
@@ -521,4 +521,4 @@ export {
521
521
  resolveFromSource,
522
522
  runInitCommand
523
523
  };
524
- //# sourceMappingURL=chunk-S3DOJOW4.js.map
524
+ //# sourceMappingURL=chunk-ORZINVGQ.js.map
@@ -12,12 +12,12 @@ import {
12
12
  resolveFrontendPreset,
13
13
  resolveThemeChoice,
14
14
  sanitizeAppName
15
- } from "./chunk-S3DOJOW4.js";
15
+ } from "./chunk-ORZINVGQ.js";
16
16
  import {
17
17
  XANO_DIR,
18
18
  resolveAiPresets,
19
19
  scaffoldProject
20
- } from "./chunk-VK26K7AY.js";
20
+ } from "./chunk-XBIFQWZM.js";
21
21
  import {
22
22
  TEST_EXPECT_TYPES
23
23
  } from "./chunk-YX22LKQE.js";
@@ -80,7 +80,7 @@ import {
80
80
  import {
81
81
  loadDefault,
82
82
  readVersion
83
- } from "./chunk-RLI6XD4O.js";
83
+ } from "./chunk-LISUHLWI.js";
84
84
  import {
85
85
  UsageError
86
86
  } from "./chunk-Z2ZIE5CO.js";
@@ -7015,4 +7015,4 @@ export {
7015
7015
  verifyCrashEntry,
7016
7016
  blameGeneratedFile
7017
7017
  };
7018
- //# sourceMappingURL=chunk-SS2V2QOG.js.map
7018
+ //# sourceMappingURL=chunk-UQMMFW32.js.map
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  compileBundle
3
- } from "./chunk-RLI6XD4O.js";
3
+ } from "./chunk-LISUHLWI.js";
4
4
  import {
5
5
  missingArgument
6
6
  } from "./chunk-Z2ZIE5CO.js";
@@ -34,4 +34,4 @@ export {
34
34
  assertBundleInput,
35
35
  loadBundleText
36
36
  };
37
- //# sourceMappingURL=chunk-OONT4ZL4.js.map
37
+ //# sourceMappingURL=chunk-UXPDQFG2.js.map
@@ -23,7 +23,7 @@ comes from interfaces with different shapes, and carrying it over produces code
23
23
  that reads well, type-checks, and is wrong. Read before writing:
24
24
 
25
25
  1. \`node_modules/@xanots/sdk/llms.txt\` \u2014 the router, and the whole always-read
26
- surface: the mental model, the deploy contract, every gotcha, and control
26
+ surface: the mental model, the deploy contract, every cross-cutting gotcha, and control
27
27
  flow. It ends with a list of topic files and the condition for opening each.
28
28
  Read it in full; it is small on purpose.
29
29
  2. The one or two topic files whose condition matches this task
@@ -442,4 +442,4 @@ export {
442
442
  resolveAiPresets,
443
443
  scaffoldProject
444
444
  };
445
- //# sourceMappingURL=chunk-VK26K7AY.js.map
445
+ //# sourceMappingURL=chunk-XBIFQWZM.js.map
package/dist/cli.js CHANGED
@@ -8,7 +8,7 @@ import {
8
8
  resolveHelpRequest,
9
9
  resolveLockPath,
10
10
  run
11
- } from "./chunk-RLI6XD4O.js";
11
+ } from "./chunk-LISUHLWI.js";
12
12
  import "./chunk-7WRJPKGK.js";
13
13
  import "./chunk-3LQGF2WS.js";
14
14
  import "./chunk-Z2ZIE5CO.js";
@@ -4,7 +4,7 @@ import {
4
4
  isMissingDependencyError,
5
5
  runInitFromCommand,
6
6
  verifyCrashEntry
7
- } from "./chunk-SS2V2QOG.js";
7
+ } from "./chunk-UQMMFW32.js";
8
8
  import "./chunk-RQ3FXV4K.js";
9
9
  import "./chunk-K5IOND4K.js";
10
10
  import "./chunk-TJS2AF5Y.js";
@@ -13,8 +13,8 @@ import "./chunk-YHS6VVLJ.js";
13
13
  import "./chunk-ZUTSMMAG.js";
14
14
  import "./chunk-X4DVXBFY.js";
15
15
  import "./chunk-NDP7OUPS.js";
16
- import "./chunk-S3DOJOW4.js";
17
- import "./chunk-VK26K7AY.js";
16
+ import "./chunk-ORZINVGQ.js";
17
+ import "./chunk-XBIFQWZM.js";
18
18
  import "./chunk-ZSYZTGJH.js";
19
19
  import "./chunk-YX22LKQE.js";
20
20
  import "./chunk-6VNRMKFJ.js";
@@ -24,7 +24,7 @@ import "./chunk-BYQHCCYU.js";
24
24
  import "./chunk-EHP3WPEG.js";
25
25
  import "./chunk-AE3PDSDS.js";
26
26
  import "./chunk-DCMANKMX.js";
27
- import "./chunk-RLI6XD4O.js";
27
+ import "./chunk-LISUHLWI.js";
28
28
  import "./chunk-7WRJPKGK.js";
29
29
  import "./chunk-3LQGF2WS.js";
30
30
  import "./chunk-Z2ZIE5CO.js";
@@ -44,4 +44,4 @@ export {
44
44
  runInitFromCommand,
45
45
  verifyCrashEntry
46
46
  };
47
- //# sourceMappingURL=codegen-command-ZDHMGFWZ.js.map
47
+ //# sourceMappingURL=codegen-command-5A6FVKUA.js.map
@@ -4,7 +4,7 @@ import {
4
4
  import {
5
5
  assertBundleInput,
6
6
  loadBundleText
7
- } from "./chunk-OONT4ZL4.js";
7
+ } from "./chunk-UXPDQFG2.js";
8
8
  import {
9
9
  microserviceLine,
10
10
  readyRatio,
@@ -38,7 +38,7 @@ import {
38
38
  } from "./chunk-ZUTSMMAG.js";
39
39
  import "./chunk-X4DVXBFY.js";
40
40
  import "./chunk-NDP7OUPS.js";
41
- import "./chunk-RLI6XD4O.js";
41
+ import "./chunk-LISUHLWI.js";
42
42
  import "./chunk-7WRJPKGK.js";
43
43
  import "./chunk-3LQGF2WS.js";
44
44
  import {
@@ -417,4 +417,4 @@ export {
417
417
  runDeployedTests,
418
418
  verifyMicroservices
419
419
  };
420
- //# sourceMappingURL=deploy-command-CGVKRWUE.js.map
420
+ //# sourceMappingURL=deploy-command-VBB7JYXH.js.map
@@ -3,13 +3,13 @@ import {
3
3
  resolveFromSource,
4
4
  runInitCommand,
5
5
  sanitizeAppName
6
- } from "./chunk-S3DOJOW4.js";
6
+ } from "./chunk-ORZINVGQ.js";
7
7
  import {
8
8
  resolveAiFlags
9
- } from "./chunk-VK26K7AY.js";
9
+ } from "./chunk-XBIFQWZM.js";
10
10
  import "./chunk-ZSYZTGJH.js";
11
11
  import "./chunk-RQNMTDXD.js";
12
- import "./chunk-RLI6XD4O.js";
12
+ import "./chunk-LISUHLWI.js";
13
13
  import "./chunk-7WRJPKGK.js";
14
14
  import "./chunk-3LQGF2WS.js";
15
15
  import "./chunk-Z2ZIE5CO.js";
@@ -29,4 +29,4 @@ export {
29
29
  runInitCommand,
30
30
  sanitizeAppName
31
31
  };
32
- //# sourceMappingURL=init-command-DNDONP3O.js.map
32
+ //# sourceMappingURL=init-command-SIJUH2DD.js.map