@meridian-flow/mars-schema 0.34.6-rc.1 → 0.35.1

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 (142) hide show
  1. package/README.md +48 -1
  2. package/fixtures/alias/exclude-glob/expected.json +1 -0
  3. package/fixtures/alias/exclude-glob/request.json +22 -0
  4. package/fixtures/alias/latest-ids-are-skipped/expected.json +1 -0
  5. package/fixtures/alias/latest-ids-are-skipped/request.json +19 -0
  6. package/fixtures/alias/meta-llama-matches-meta/expected.json +1 -0
  7. package/fixtures/alias/meta-llama-matches-meta/request.json +20 -0
  8. package/fixtures/alias/meta-matches-meta-llama/expected.json +1 -0
  9. package/fixtures/alias/meta-matches-meta-llama/request.json +15 -0
  10. package/fixtures/alias/mistral-matches-mistralai/expected.json +1 -0
  11. package/fixtures/alias/mistral-matches-mistralai/request.json +15 -0
  12. package/fixtures/alias/mistralai-matches-mistral/expected.json +1 -0
  13. package/fixtures/alias/mistralai-matches-mistral/request.json +20 -0
  14. package/fixtures/alias/newest-release-wins/expected.json +1 -0
  15. package/fixtures/alias/newest-release-wins/request.json +24 -0
  16. package/fixtures/alias/no-match-is-null/expected.json +1 -0
  17. package/fixtures/alias/no-match-is-null/request.json +14 -0
  18. package/fixtures/alias/provider-key-case-insensitive/expected.json +1 -0
  19. package/fixtures/alias/provider-key-case-insensitive/request.json +20 -0
  20. package/fixtures/alias/row-without-a-date-sorts-last/expected.json +1 -0
  21. package/fixtures/alias/row-without-a-date-sorts-last/request.json +18 -0
  22. package/fixtures/alias/shorter-id-then-alphabetical/expected.json +1 -0
  23. package/fixtures/alias/shorter-id-then-alphabetical/request.json +24 -0
  24. package/fixtures/check/claude-execution-fields-ignored/expected.json +1 -1
  25. package/fixtures/check/claude-policy-override-dropped/expected.json +1 -1
  26. package/fixtures/effort/auto-sends-nothing/expected.json +4 -0
  27. package/fixtures/effort/auto-sends-nothing/request.json +16 -0
  28. package/fixtures/effort/flow-has-no-minimal/expected.json +8 -0
  29. package/fixtures/effort/flow-has-no-minimal/request.json +17 -0
  30. package/fixtures/effort/flow-has-no-xhigh-tie-goes-up/expected.json +8 -0
  31. package/fixtures/effort/flow-has-no-xhigh-tie-goes-up/request.json +19 -0
  32. package/fixtures/effort/flow-keeps-none-and-max/expected.json +4 -0
  33. package/fixtures/effort/flow-keeps-none-and-max/request.json +19 -0
  34. package/fixtures/effort/flow-none-on-model-with-no-control/expected.json +8 -0
  35. package/fixtures/effort/flow-none-on-model-with-no-control/request.json +7 -0
  36. package/fixtures/effort/level-below-the-model-range-moves-up/expected.json +8 -0
  37. package/fixtures/effort/level-below-the-model-range-moves-up/request.json +17 -0
  38. package/fixtures/effort/minimal-never-lands-on-none/expected.json +8 -0
  39. package/fixtures/effort/minimal-never-lands-on-none/request.json +19 -0
  40. package/fixtures/effort/mixed-case-request/expected.json +4 -0
  41. package/fixtures/effort/mixed-case-request/request.json +17 -0
  42. package/fixtures/effort/model-that-does-not-reason/expected.json +8 -0
  43. package/fixtures/effort/model-that-does-not-reason/request.json +7 -0
  44. package/fixtures/effort/model-that-does-not-reason-none/expected.json +4 -0
  45. package/fixtures/effort/model-that-does-not-reason-none/request.json +7 -0
  46. package/fixtures/effort/nearest-is-above-when-closer/expected.json +8 -0
  47. package/fixtures/effort/nearest-is-above-when-closer/request.json +16 -0
  48. package/fixtures/effort/no-common-level/expected.json +8 -0
  49. package/fixtures/effort/no-common-level/request.json +15 -0
  50. package/fixtures/effort/none-on-budget-only-model-claude/expected.json +8 -0
  51. package/fixtures/effort/none-on-budget-only-model-claude/request.json +13 -0
  52. package/fixtures/effort/none-on-budget-only-model-pi/expected.json +8 -0
  53. package/fixtures/effort/none-on-budget-only-model-pi/request.json +13 -0
  54. package/fixtures/effort/none-on-claude-has-no-off/expected.json +8 -0
  55. package/fixtures/effort/none-on-claude-has-no-off/request.json +17 -0
  56. package/fixtures/effort/none-on-model-listing-none/expected.json +4 -0
  57. package/fixtures/effort/none-on-model-listing-none/request.json +17 -0
  58. package/fixtures/effort/none-on-model-with-no-control-codex/expected.json +8 -0
  59. package/fixtures/effort/none-on-model-with-no-control-codex/request.json +7 -0
  60. package/fixtures/effort/none-on-model-with-no-control-pi/expected.json +8 -0
  61. package/fixtures/effort/none-on-model-with-no-control-pi/request.json +7 -0
  62. package/fixtures/effort/none-on-toggle-only-model-pi/expected.json +4 -0
  63. package/fixtures/effort/none-on-toggle-only-model-pi/request.json +12 -0
  64. package/fixtures/effort/null-sends-nothing/expected.json +4 -0
  65. package/fixtures/effort/null-sends-nothing/request.json +16 -0
  66. package/fixtures/effort/o3-max-on-codex/expected.json +8 -0
  67. package/fixtures/effort/o3-max-on-codex/request.json +17 -0
  68. package/fixtures/effort/opencode-takes-the-models-levels/expected.json +8 -0
  69. package/fixtures/effort/opencode-takes-the-models-levels/request.json +19 -0
  70. package/fixtures/effort/unknown-model-none-claude/expected.json +8 -0
  71. package/fixtures/effort/unknown-model-none-claude/request.json +5 -0
  72. package/fixtures/effort/unknown-model-none-flow/expected.json +4 -0
  73. package/fixtures/effort/unknown-model-none-flow/request.json +5 -0
  74. package/fixtures/effort/unknown-model-pi/expected.json +4 -0
  75. package/fixtures/effort/unknown-model-pi/request.json +5 -0
  76. package/fixtures/effort/xhigh-on-toggle-only-model/expected.json +4 -0
  77. package/fixtures/effort/xhigh-on-toggle-only-model/request.json +12 -0
  78. package/fixtures/effort-levels/expected.json +9 -0
  79. package/fixtures/prepare/claude-reserved-keys/expected.json +1 -1
  80. package/fixtures/read/agent-model-policy-index/expected.json +1 -1
  81. package/fixtures/resolve/bounds-bytes/expected.json +29 -0
  82. package/fixtures/resolve/bounds-bytes/steps.json +47 -0
  83. package/fixtures/resolve/bounds-packages/expected.json +47 -0
  84. package/fixtures/resolve/bounds-packages/steps.json +76 -0
  85. package/fixtures/resolve/chain/expected.json +108 -0
  86. package/fixtures/resolve/chain/steps.json +98 -0
  87. package/fixtures/resolve/conflict/expected.json +58 -0
  88. package/fixtures/resolve/conflict/steps.json +82 -0
  89. package/fixtures/resolve/cycle/expected.json +85 -0
  90. package/fixtures/resolve/cycle/steps.json +73 -0
  91. package/fixtures/resolve/engine-skip/expected.json +62 -0
  92. package/fixtures/resolve/engine-skip/steps.json +61 -0
  93. package/fixtures/resolve/lock-kept/expected.json +61 -0
  94. package/fixtures/resolve/lock-kept/steps.json +49 -0
  95. package/fixtures/resolve/lock-subpath/expected.json +39 -0
  96. package/fixtures/resolve/lock-subpath/steps.json +52 -0
  97. package/fixtures/resolve/lock-tag-object/expected.json +38 -0
  98. package/fixtures/resolve/lock-tag-object/steps.json +35 -0
  99. package/fixtures/resolve/locked-commit-failed/expected.json +26 -0
  100. package/fixtures/resolve/locked-commit-failed/steps.json +35 -0
  101. package/fixtures/resolve/locked-commit-missing/expected.json +62 -0
  102. package/fixtures/resolve/locked-commit-missing/steps.json +64 -0
  103. package/fixtures/resolve/locked-commit-missing-latest/expected.json +60 -0
  104. package/fixtures/resolve/locked-commit-missing-latest/steps.json +64 -0
  105. package/fixtures/resolve/marketplace-local/expected.json +57 -0
  106. package/fixtures/resolve/marketplace-local/steps.json +45 -0
  107. package/fixtures/resolve/marketplace-remote/expected.json +75 -0
  108. package/fixtures/resolve/marketplace-remote/steps.json +68 -0
  109. package/fixtures/resolve/path-refused-fetched/expected.json +29 -0
  110. package/fixtures/resolve/path-refused-fetched/steps.json +44 -0
  111. package/fixtures/resolve/path-refused-root/expected.json +11 -0
  112. package/fixtures/resolve/path-refused-root/steps.json +15 -0
  113. package/fixtures/resolve/refresh-all/expected.json +73 -0
  114. package/fixtures/resolve/refresh-all/steps.json +86 -0
  115. package/fixtures/resolve/refresh-one/expected.json +69 -0
  116. package/fixtures/resolve/refresh-one/steps.json +72 -0
  117. package/fixtures/resolve/sibling-subpaths/expected.json +71 -0
  118. package/fixtures/resolve/sibling-subpaths/steps.json +53 -0
  119. package/fixtures/resolve/sibling-subpaths-whole/expected.json +71 -0
  120. package/fixtures/resolve/sibling-subpaths-whole/steps.json +57 -0
  121. package/fixtures/resolve/subpath-missing/expected.json +30 -0
  122. package/fixtures/resolve/subpath-missing/steps.json +44 -0
  123. package/fixtures/resolve/tree-broad-failed-then-subtree-found/expected.json +47 -0
  124. package/fixtures/resolve/tree-broad-failed-then-subtree-found/steps.json +53 -0
  125. package/fixtures/resolve/tree-later-answer-wins-failed/expected.json +34 -0
  126. package/fixtures/resolve/tree-later-answer-wins-failed/steps.json +53 -0
  127. package/fixtures/resolve/tree-later-answer-wins-found/expected.json +46 -0
  128. package/fixtures/resolve/tree-later-answer-wins-found/steps.json +53 -0
  129. package/fixtures/resolve/tree-subtree-found-then-broad-failed/expected.json +47 -0
  130. package/fixtures/resolve/tree-subtree-found-then-broad-failed/steps.json +53 -0
  131. package/fixtures/resolve/unavailable-missing/expected.json +34 -0
  132. package/fixtures/resolve/unavailable-missing/steps.json +44 -0
  133. package/index.d.ts +193 -3
  134. package/node/mars_schema_wasm.d.ts +30 -0
  135. package/node/mars_schema_wasm.js +104 -0
  136. package/node/mars_schema_wasm_bg.wasm +0 -0
  137. package/node/mars_schema_wasm_bg.wasm.d.ts +4 -0
  138. package/package.json +1 -1
  139. package/web/mars_schema_wasm.d.ts +34 -0
  140. package/web/mars_schema_wasm.js +100 -0
  141. package/web/mars_schema_wasm_bg.wasm +0 -0
  142. package/web/mars_schema_wasm_bg.wasm.d.ts +4 -0
package/index.d.ts CHANGED
@@ -77,7 +77,7 @@ export interface DefinitionRead<Fields> {
77
77
  diagnostics: Diagnostic[];
78
78
  }
79
79
 
80
- export type Effort = "none" | "low" | "medium" | "high" | "xhigh" | "max";
80
+ export type Effort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
81
81
  export type Sandbox = "default" | "read-only" | "workspace-write" | "danger-full-access";
82
82
  export type Approval = "default" | "auto" | "confirm" | "never";
83
83
  export type Network = "allow" | "deny" | "allowlist";
@@ -98,7 +98,7 @@ export interface ToolRule {
98
98
 
99
99
  export interface ModelPolicyRule {
100
100
  match: { model: string } | { alias: string } | { "model-glob": string };
101
- override?: { effort?: Effort; sandbox?: Sandbox; approval?: Approval; network?: Network };
101
+ override?: { effort?: Effort | "auto"; sandbox?: Sandbox; approval?: Approval; network?: Network };
102
102
  "no-fallback"?: boolean;
103
103
  /** One non-empty line. */
104
104
  when?: string;
@@ -119,7 +119,8 @@ export interface AgentFields {
119
119
  /** Canonical hosts (lowercase, no trailing dot); `{ replace }` clears the lower layers' hosts. */
120
120
  "network-allow": string[] | { replace: string[] };
121
121
  "network-deny": string[];
122
- effort: Effort | null;
122
+ /** `"auto"` is the harness's own default (`effort: auto` or YAML `null`); `null` is a key left out. */
123
+ effort: Effort | "auto" | null;
123
124
  skills: { load: string[]; available: string[] };
124
125
  subagents: string[];
125
126
  tools: ToolRule[];
@@ -797,3 +798,192 @@ export function renderHooks(
797
798
  targets: string[],
798
799
  tokens?: { hookDir?: string; hookTarget?: string } | null,
799
800
  ): { diagnostics: Diagnostic[]; targets: { [root: string]: HookTargetOutput } };
801
+
802
+ // ---------------------------------------------------------------------------------------
803
+ // resolve
804
+ // ---------------------------------------------------------------------------------------
805
+
806
+ /** One `[dependencies.<name>]` row of `mars.lock`, as `mars sync` writes it. Urls are the lock's canonical spelling (`github.com/owner/repo`). */
807
+ export interface LockedDependency {
808
+ url?: string;
809
+ /** A path dependency's canonical directory. `resolve` refuses paths and never returns it; `mars sync` writes it, so keep it if you store a CLI lock. */
810
+ path?: string;
811
+ /** The folder of the repository the package is in, for a dependency with a `subpath`. Part of the row's source identity: a row without it does not match the dependency. */
812
+ subpath?: string;
813
+ version?: string;
814
+ commit?: string;
815
+ /** The marketplace plugin installed from this source; `url`, `version` and `commit` are then the marketplace's. */
816
+ plugin?: string;
817
+ /** Where the plugin's files came from. */
818
+ content?: { url?: string; subpath?: string; commit?: string };
819
+ }
820
+
821
+ /** A fetch `resolve` still needs. Each need is its own key: answer it once. */
822
+ export type Need =
823
+ | { kind: "tags"; url: string }
824
+ | { kind: "ref"; url: string; ref: string }
825
+ /** `path: null` is the whole repository. `commit` can be an annotated tag's object id, from a lock Mars 0.34 or earlier wrote. */
826
+ | { kind: "tree"; url: string; commit: string; path: string | null };
827
+
828
+ export type Answer =
829
+ /** Every tag; the `commit` of an annotated tag is the commit it points at, never the tag object. Order and non-version tags don't matter. */
830
+ | { need: { kind: "tags"; url: string }; tags: { tag: string; commit: string }[] }
831
+ /** A branch, `HEAD` or a commit-as-ref, as a commit. */
832
+ | { need: { kind: "ref"; url: string; ref: string }; commit: string }
833
+ /**
834
+ * The files at `commit` under `path`, repository-relative (`path: null` is the whole repository).
835
+ * It answers every tree need at the same `url` and `commit` whose `path` is inside its own, so one
836
+ * whole-repository answer serves every later need there. A need takes the answer for its own key
837
+ * `(url, commit, path)`, else the one for the nearest folder above it, else the whole repository's;
838
+ * of two answers with one key, the later in the list wins. Files only, a symlink as its target's
839
+ * content; binary files may be left out.
840
+ */
841
+ | { url: string; commit: string; path: string | null; files: { [path: string]: Uint8Array } | Map<string, Uint8Array> }
842
+ /** The commit or ref doesn't exist. A locked commit that is missing is dropped with a warning; any other is `unavailable`. */
843
+ | { need: Need; missing: true }
844
+ /** Any other error (network, auth, a 5xx, a limit of your own). Always `unavailable`; it never drops a lock. */
845
+ | { need: Need; failed: string };
846
+
847
+ export interface ResolveDiagnostic {
848
+ /** `warning`: the sync fell short of what was asked; `advisory`: a note that doesn't imply it; `info`. */
849
+ level: "warning" | "advisory" | "info";
850
+ /** Stable code, e.g. `locked-commit-unreachable`, `requires-mars-fallback`. */
851
+ code: string;
852
+ message: string;
853
+ }
854
+
855
+ /** A requester (`"root"` for the root's own `mars.toml`) and the constraint it asked for (`null`: any version). */
856
+ export interface ResolveRequester {
857
+ by: string;
858
+ constraint: string | null;
859
+ }
860
+
861
+ export type ResolveFailure = { message: string } & (
862
+ /** No version meets every constraint. */
863
+ | { kind: "conflict"; name: string; requesters: ResolveRequester[] }
864
+ /** Two names for one source, or one name for two sources (`existing` is the one it had first). */
865
+ | { kind: "identity"; detail: "one-source-two-names" | "one-name-two-sources"; names: string[]; source: string; existing?: string }
866
+ /** A pinned or locked version needs a newer Mars or Meridian. `engine` is `"mars"` or `"meridian"`; the first unmet requirement. */
867
+ | { kind: "engine-incompatible"; name: string; requirement: string | null; engine: "mars" | "meridian" | null }
868
+ /** Every candidate version was excluded by its engine requirement. */
869
+ | { kind: "engine-unsatisfiable"; name: string; excluded: { version: string; requirement: string; engine: "mars" | "meridian" }[] }
870
+ | { kind: "engine-requirement-invalid"; name: string; requirement: string; engine: string }
871
+ /** The `engine` version given does not parse. */
872
+ | { kind: "engine-version-invalid"; engine: string; version: string }
873
+ | {
874
+ kind: "plugin";
875
+ name: string;
876
+ detail: "not-a-marketplace" | "not-listed" | "refused" | "choice-needed" | "not-one-package" | "unusable-path";
877
+ plugin?: string;
878
+ }
879
+ | { kind: "subpath"; name: string; subpath: string; detail: "missing" | "not-a-directory" | "traversal" }
880
+ /** A package's manifest is not TOML. */
881
+ | { kind: "unreadable"; name: string; diagnostics: Diagnostic[] }
882
+ /** A fetched package (`declared_in`, or `"root"`) declares a path dependency. */
883
+ | { kind: "path"; name: string; declared_in: string }
884
+ /** A `failed` answer, or a `missing` one that did not come from a lock. */
885
+ | { kind: "unavailable"; need: Need; reason: string }
886
+ | { kind: "bounds"; limit: "packages" | "bytes"; at: string }
887
+ | { kind: "oscillation"; name: string; steps: { version: string | null; commit: string | null }[] }
888
+ );
889
+
890
+ export interface ResolvedDependency {
891
+ /** Where to vendor from: the repository (the marketplace's, for a plugin), at `commit`. */
892
+ url: string;
893
+ commit: string;
894
+ subpath: string | null;
895
+ /** The tag chosen; `null` when untagged or pinned to a ref. */
896
+ version: string | null;
897
+ /** Set for a marketplace plugin: where its files are (another repository, or a folder of the marketplace's own tree). */
898
+ content?: { url: string; subpath: string | null; commit: string };
899
+ required_by: ResolveRequester[];
900
+ }
901
+
902
+ /**
903
+ * Which version of which source, for a whole dependency graph: the rules of `mars sync` without
904
+ * the fetching. Stateless: each call replays the resolution from every answer so far, so keep the
905
+ * list of answers and call again with it grown until the result is not `needs`.
906
+ *
907
+ * - `{ needs }`: every open need on the current frontier (one with no answer), sorted (tags, then refs, then
908
+ * trees, each by its fields); fetch them in parallel. A later need can depend on an earlier answer, so a call can return needs more than
909
+ * once. While any need is open the result is `needs`: a failure found after one waits.
910
+ * - `{ resolved }`: `lock` is exactly mars.lock's `[dependencies.<name>]` rows, to store verbatim;
911
+ * `dependencies` is what to vendor and to hand to `check` and `selectItems`.
912
+ * - `{ failed }`: the first failure; resolution stops there. `message` is the text `mars sync`
913
+ * prints for it.
914
+ *
915
+ * `refresh` ignores `locked` for the names it lists (`mars upgrade <name>`), or for every name
916
+ * (`"all"`, `mars upgrade`). `engine.mars` judges `requires-mars`; `engine.meridian`, when given,
917
+ * `requires-meridian`. `bounds.packages` caps the dependencies in the closure; `bounds.bytes` the
918
+ * bytes of the files Mars reads, counted afresh at each restart and checked at the end of each
919
+ * pass. A path dependency is never a need: it is the `path` failure. `supplied` (an edited
920
+ * manifest over a fetched tree) is not supported yet and throws.
921
+ *
922
+ * A malformed argument throws `input.invalid`.
923
+ */
924
+ export function resolve(input: {
925
+ /** The root's `mars.toml` text; only its `[dependencies]` matter. */
926
+ root: { manifest: string };
927
+ supplied?: { [name: string]: { manifest: string } };
928
+ locked?: { [name: string]: LockedDependency };
929
+ refresh?: "all" | string[];
930
+ engine: { mars: string; meridian?: string };
931
+ bounds?: { packages?: number; bytes?: number };
932
+ answers: Answer[];
933
+ }):
934
+ | { needs: Need[] }
935
+ | { resolved: { lock: { [name: string]: LockedDependency }; dependencies: { [name: string]: ResolvedDependency } }; diagnostics: ResolveDiagnostic[] }
936
+ | { failed: ResolveFailure; diagnostics: ResolveDiagnostic[] };
937
+
938
+ // ---- Effort and aliases -------------------------------------------------------------------
939
+
940
+ /** The reasoning levels, lowest first. */
941
+ export function effortLevels(): Effort[];
942
+
943
+ /** The models.dev fields `resolveEffort` reads from a model row. */
944
+ export interface ModelsDevReasoning {
945
+ reasoning: boolean;
946
+ reasoning_options?: (
947
+ | { type: "effort"; values: string[] }
948
+ | { type: "toggle" }
949
+ | { type: "budget_tokens"; min?: number; max?: number }
950
+ )[];
951
+ }
952
+
953
+ /** Why a requested level moved; `code` strings are stable. */
954
+ export type EffortMoveReason =
955
+ | "model_does_not_reason"
956
+ | "model_levels"
957
+ | "harness_levels"
958
+ | "no_common_level";
959
+
960
+ export interface EffortResolution {
961
+ /** The level to send; `null` sends no effort. */
962
+ level: Effort | null;
963
+ /** Set when `level` differs from what was requested. */
964
+ moved: { from: Effort; to: Effort | null; why: EffortMoveReason } | null;
965
+ }
966
+
967
+ /**
968
+ * The level to send for `requested` on a model and a host. `requested` is a level, `"auto"` or
969
+ * `null` (both send no effort). `model` is the models.dev row's `reasoning` and
970
+ * `reasoning_options`, or `null` when the model is unknown. A level the model or host does not
971
+ * take moves to the nearest one they share (the nearest on the ladder, a tie going up; never to
972
+ * `none` unless `none` was asked), and `moved` says from what, to what and why. A model that
973
+ * reasons but lists no effort values takes every level, less `none` unless it has a toggle.
974
+ */
975
+ export function resolveEffort(
976
+ requested: Effort | "auto" | null,
977
+ model: ModelsDevReasoning | null,
978
+ host: Host,
979
+ ): EffortResolution;
980
+
981
+ /**
982
+ * The id an `auto` alias selects among models.dev rows, or `null`: every `match` glob hits, no
983
+ * `exclude` glob hits, `provider` (a models.dev key) matches when given, `-latest` ids are
984
+ * skipped, then the newest `release_date`, the shorter id and alphabetical order break ties.
985
+ */
986
+ export function resolveAlias(
987
+ rows: { id: string; provider: string; release_date?: string | null }[],
988
+ options: { match: string[]; exclude?: string[]; provider?: string | null },
989
+ ): string | null;
@@ -9,6 +9,11 @@
9
9
  */
10
10
  export function check(argument: any): any;
11
11
 
12
+ /**
13
+ * The reasoning levels, lowest first: `none < minimal < low < medium < high < xhigh < max`.
14
+ */
15
+ export function effortLevels(): any;
16
+
12
17
  /**
13
18
  * YAML for the value of the key at column `indent`; see `index.d.ts`.
14
19
  */
@@ -57,6 +62,31 @@ export function read(path: string, text: string): any;
57
62
  */
58
63
  export function renderHooks(hook_toml: string, targets: string[], tokens: any): any;
59
64
 
65
+ /**
66
+ * Which version of which source, for a whole dependency graph: `{root, locked?, refresh?, engine,
67
+ * bounds?, answers}` to `{needs}`, `{resolved, diagnostics}` or `{failed, diagnostics}`. Each call
68
+ * replays the resolution from every answer so far; see `index.d.ts`. A failure of the resolution
69
+ * is returned as data, an argument that is not that shape throws `input.invalid`.
70
+ */
71
+ export function resolve(input: any): any;
72
+
73
+ /**
74
+ * The model id an `auto` alias selects among models.dev rows, or `null`: every `match` glob
75
+ * hits, no `exclude` glob hits, the provider matches when given, `-latest` ids are skipped, and
76
+ * the newest `release_date` wins, then the shorter id, then alphabetical order. The code
77
+ * `mars models resolve` runs.
78
+ */
79
+ export function resolveAlias(rows: any, options: any): any;
80
+
81
+ /**
82
+ * The level to send for `requested` on a model and a host: `{ level, moved }`. `requested` is
83
+ * a level, `"auto"` or `null` (both send no effort). `model` is the models.dev row's
84
+ * `{ reasoning, reasoning_options }`, or `null` when the model is unknown. `host` is a harness
85
+ * or `meridian-flow`. A level the model or host does not take moves to the nearest one they
86
+ * share, and `moved` says from what, to what and why.
87
+ */
88
+ export function resolveEffort(requested: string | null | undefined, model: any, host: string): any;
89
+
60
90
  /**
61
91
  * The full frontmatter block for `[key, value][]`, ending in exactly one newline.
62
92
  */
@@ -25,6 +25,27 @@ function check(argument) {
25
25
  }
26
26
  exports.check = check;
27
27
 
28
+ /**
29
+ * The reasoning levels, lowest first: `none < minimal < low < medium < high < xhigh < max`.
30
+ * @returns {any}
31
+ */
32
+ function effortLevels() {
33
+ try {
34
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
35
+ wasm.effortLevels(retptr);
36
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
37
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
38
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
39
+ if (r2) {
40
+ throw takeObject(r1);
41
+ }
42
+ return takeObject(r0);
43
+ } finally {
44
+ wasm.__wbindgen_add_to_stack_pointer(16);
45
+ }
46
+ }
47
+ exports.effortLevels = effortLevels;
48
+
28
49
  /**
29
50
  * YAML for the value of the key at column `indent`; see `index.d.ts`.
30
51
  * @param {any} value
@@ -216,6 +237,89 @@ function renderHooks(hook_toml, targets, tokens) {
216
237
  }
217
238
  exports.renderHooks = renderHooks;
218
239
 
240
+ /**
241
+ * Which version of which source, for a whole dependency graph: `{root, locked?, refresh?, engine,
242
+ * bounds?, answers}` to `{needs}`, `{resolved, diagnostics}` or `{failed, diagnostics}`. Each call
243
+ * replays the resolution from every answer so far; see `index.d.ts`. A failure of the resolution
244
+ * is returned as data, an argument that is not that shape throws `input.invalid`.
245
+ * @param {any} input
246
+ * @returns {any}
247
+ */
248
+ function resolve(input) {
249
+ try {
250
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
251
+ wasm.resolve(retptr, addHeapObject(input));
252
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
253
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
254
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
255
+ if (r2) {
256
+ throw takeObject(r1);
257
+ }
258
+ return takeObject(r0);
259
+ } finally {
260
+ wasm.__wbindgen_add_to_stack_pointer(16);
261
+ }
262
+ }
263
+ exports.resolve = resolve;
264
+
265
+ /**
266
+ * The model id an `auto` alias selects among models.dev rows, or `null`: every `match` glob
267
+ * hits, no `exclude` glob hits, the provider matches when given, `-latest` ids are skipped, and
268
+ * the newest `release_date` wins, then the shorter id, then alphabetical order. The code
269
+ * `mars models resolve` runs.
270
+ * @param {any} rows
271
+ * @param {any} options
272
+ * @returns {any}
273
+ */
274
+ function resolveAlias(rows, options) {
275
+ try {
276
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
277
+ wasm.resolveAlias(retptr, addHeapObject(rows), addHeapObject(options));
278
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
279
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
280
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
281
+ if (r2) {
282
+ throw takeObject(r1);
283
+ }
284
+ return takeObject(r0);
285
+ } finally {
286
+ wasm.__wbindgen_add_to_stack_pointer(16);
287
+ }
288
+ }
289
+ exports.resolveAlias = resolveAlias;
290
+
291
+ /**
292
+ * The level to send for `requested` on a model and a host: `{ level, moved }`. `requested` is
293
+ * a level, `"auto"` or `null` (both send no effort). `model` is the models.dev row's
294
+ * `{ reasoning, reasoning_options }`, or `null` when the model is unknown. `host` is a harness
295
+ * or `meridian-flow`. A level the model or host does not take moves to the nearest one they
296
+ * share, and `moved` says from what, to what and why.
297
+ * @param {string | null | undefined} requested
298
+ * @param {any} model
299
+ * @param {string} host
300
+ * @returns {any}
301
+ */
302
+ function resolveEffort(requested, model, host) {
303
+ try {
304
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
305
+ var ptr0 = isLikeNone(requested) ? 0 : passStringToWasm0(requested, wasm.__wbindgen_export, wasm.__wbindgen_export2);
306
+ var len0 = WASM_VECTOR_LEN;
307
+ const ptr1 = passStringToWasm0(host, wasm.__wbindgen_export, wasm.__wbindgen_export2);
308
+ const len1 = WASM_VECTOR_LEN;
309
+ wasm.resolveEffort(retptr, ptr0, len0, addHeapObject(model), ptr1, len1);
310
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
311
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
312
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
313
+ if (r2) {
314
+ throw takeObject(r1);
315
+ }
316
+ return takeObject(r0);
317
+ } finally {
318
+ wasm.__wbindgen_add_to_stack_pointer(16);
319
+ }
320
+ }
321
+ exports.resolveEffort = resolveEffort;
322
+
219
323
  /**
220
324
  * The full frontmatter block for `[key, value][]`, ending in exactly one newline.
221
325
  * @param {any} frontmatter
Binary file
@@ -2,6 +2,7 @@
2
2
  /* eslint-disable */
3
3
  export const memory: WebAssembly.Memory;
4
4
  export const check: (a: number, b: number) => void;
5
+ export const effortLevels: (a: number) => void;
5
6
  export const emitValue: (a: number, b: number, c: number) => void;
6
7
  export const inspect: (a: number, b: number) => void;
7
8
  export const normalize: (a: number, b: number) => void;
@@ -9,6 +10,9 @@ export const prepare: (a: number, b: number) => void;
9
10
  export const project: (a: number, b: number, c: number, d: number) => void;
10
11
  export const read: (a: number, b: number, c: number, d: number, e: number) => void;
11
12
  export const renderHooks: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
13
+ export const resolve: (a: number, b: number) => void;
14
+ export const resolveAlias: (a: number, b: number, c: number) => void;
15
+ export const resolveEffort: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
12
16
  export const rewriteBlock: (a: number, b: number) => void;
13
17
  export const satisfies: (a: number, b: number, c: number, d: number, e: number) => void;
14
18
  export const satisfiesRequirement: (a: number, b: number, c: number, d: number, e: number) => void;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@meridian-flow/mars-schema",
3
- "version": "0.34.6-rc.1",
3
+ "version": "0.35.1",
4
4
  "description": "Mars agent schema reader and lossless editor",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -9,6 +9,11 @@
9
9
  */
10
10
  export function check(argument: any): any;
11
11
 
12
+ /**
13
+ * The reasoning levels, lowest first: `none < minimal < low < medium < high < xhigh < max`.
14
+ */
15
+ export function effortLevels(): any;
16
+
12
17
  /**
13
18
  * YAML for the value of the key at column `indent`; see `index.d.ts`.
14
19
  */
@@ -57,6 +62,31 @@ export function read(path: string, text: string): any;
57
62
  */
58
63
  export function renderHooks(hook_toml: string, targets: string[], tokens: any): any;
59
64
 
65
+ /**
66
+ * Which version of which source, for a whole dependency graph: `{root, locked?, refresh?, engine,
67
+ * bounds?, answers}` to `{needs}`, `{resolved, diagnostics}` or `{failed, diagnostics}`. Each call
68
+ * replays the resolution from every answer so far; see `index.d.ts`. A failure of the resolution
69
+ * is returned as data, an argument that is not that shape throws `input.invalid`.
70
+ */
71
+ export function resolve(input: any): any;
72
+
73
+ /**
74
+ * The model id an `auto` alias selects among models.dev rows, or `null`: every `match` glob
75
+ * hits, no `exclude` glob hits, the provider matches when given, `-latest` ids are skipped, and
76
+ * the newest `release_date` wins, then the shorter id, then alphabetical order. The code
77
+ * `mars models resolve` runs.
78
+ */
79
+ export function resolveAlias(rows: any, options: any): any;
80
+
81
+ /**
82
+ * The level to send for `requested` on a model and a host: `{ level, moved }`. `requested` is
83
+ * a level, `"auto"` or `null` (both send no effort). `model` is the models.dev row's
84
+ * `{ reasoning, reasoning_options }`, or `null` when the model is unknown. `host` is a harness
85
+ * or `meridian-flow`. A level the model or host does not take moves to the nearest one they
86
+ * share, and `moved` says from what, to what and why.
87
+ */
88
+ export function resolveEffort(requested: string | null | undefined, model: any, host: string): any;
89
+
60
90
  /**
61
91
  * The full frontmatter block for `[key, value][]`, ending in exactly one newline.
62
92
  */
@@ -107,6 +137,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
107
137
  export interface InitOutput {
108
138
  readonly memory: WebAssembly.Memory;
109
139
  readonly check: (a: number, b: number) => void;
140
+ readonly effortLevels: (a: number) => void;
110
141
  readonly emitValue: (a: number, b: number, c: number) => void;
111
142
  readonly inspect: (a: number, b: number) => void;
112
143
  readonly normalize: (a: number, b: number) => void;
@@ -114,6 +145,9 @@ export interface InitOutput {
114
145
  readonly project: (a: number, b: number, c: number, d: number) => void;
115
146
  readonly read: (a: number, b: number, c: number, d: number, e: number) => void;
116
147
  readonly renderHooks: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
148
+ readonly resolve: (a: number, b: number) => void;
149
+ readonly resolveAlias: (a: number, b: number, c: number) => void;
150
+ readonly resolveEffort: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
117
151
  readonly rewriteBlock: (a: number, b: number) => void;
118
152
  readonly satisfies: (a: number, b: number, c: number, d: number, e: number) => void;
119
153
  readonly satisfiesRequirement: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -24,6 +24,26 @@ export function check(argument) {
24
24
  }
25
25
  }
26
26
 
27
+ /**
28
+ * The reasoning levels, lowest first: `none < minimal < low < medium < high < xhigh < max`.
29
+ * @returns {any}
30
+ */
31
+ export function effortLevels() {
32
+ try {
33
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
34
+ wasm.effortLevels(retptr);
35
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
36
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
37
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
38
+ if (r2) {
39
+ throw takeObject(r1);
40
+ }
41
+ return takeObject(r0);
42
+ } finally {
43
+ wasm.__wbindgen_add_to_stack_pointer(16);
44
+ }
45
+ }
46
+
27
47
  /**
28
48
  * YAML for the value of the key at column `indent`; see `index.d.ts`.
29
49
  * @param {any} value
@@ -208,6 +228,86 @@ export function renderHooks(hook_toml, targets, tokens) {
208
228
  }
209
229
  }
210
230
 
231
+ /**
232
+ * Which version of which source, for a whole dependency graph: `{root, locked?, refresh?, engine,
233
+ * bounds?, answers}` to `{needs}`, `{resolved, diagnostics}` or `{failed, diagnostics}`. Each call
234
+ * replays the resolution from every answer so far; see `index.d.ts`. A failure of the resolution
235
+ * is returned as data, an argument that is not that shape throws `input.invalid`.
236
+ * @param {any} input
237
+ * @returns {any}
238
+ */
239
+ export function resolve(input) {
240
+ try {
241
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
242
+ wasm.resolve(retptr, addHeapObject(input));
243
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
244
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
245
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
246
+ if (r2) {
247
+ throw takeObject(r1);
248
+ }
249
+ return takeObject(r0);
250
+ } finally {
251
+ wasm.__wbindgen_add_to_stack_pointer(16);
252
+ }
253
+ }
254
+
255
+ /**
256
+ * The model id an `auto` alias selects among models.dev rows, or `null`: every `match` glob
257
+ * hits, no `exclude` glob hits, the provider matches when given, `-latest` ids are skipped, and
258
+ * the newest `release_date` wins, then the shorter id, then alphabetical order. The code
259
+ * `mars models resolve` runs.
260
+ * @param {any} rows
261
+ * @param {any} options
262
+ * @returns {any}
263
+ */
264
+ export function resolveAlias(rows, options) {
265
+ try {
266
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
267
+ wasm.resolveAlias(retptr, addHeapObject(rows), addHeapObject(options));
268
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
269
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
270
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
271
+ if (r2) {
272
+ throw takeObject(r1);
273
+ }
274
+ return takeObject(r0);
275
+ } finally {
276
+ wasm.__wbindgen_add_to_stack_pointer(16);
277
+ }
278
+ }
279
+
280
+ /**
281
+ * The level to send for `requested` on a model and a host: `{ level, moved }`. `requested` is
282
+ * a level, `"auto"` or `null` (both send no effort). `model` is the models.dev row's
283
+ * `{ reasoning, reasoning_options }`, or `null` when the model is unknown. `host` is a harness
284
+ * or `meridian-flow`. A level the model or host does not take moves to the nearest one they
285
+ * share, and `moved` says from what, to what and why.
286
+ * @param {string | null | undefined} requested
287
+ * @param {any} model
288
+ * @param {string} host
289
+ * @returns {any}
290
+ */
291
+ export function resolveEffort(requested, model, host) {
292
+ try {
293
+ const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
294
+ var ptr0 = isLikeNone(requested) ? 0 : passStringToWasm0(requested, wasm.__wbindgen_export, wasm.__wbindgen_export2);
295
+ var len0 = WASM_VECTOR_LEN;
296
+ const ptr1 = passStringToWasm0(host, wasm.__wbindgen_export, wasm.__wbindgen_export2);
297
+ const len1 = WASM_VECTOR_LEN;
298
+ wasm.resolveEffort(retptr, ptr0, len0, addHeapObject(model), ptr1, len1);
299
+ var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
300
+ var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
301
+ var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
302
+ if (r2) {
303
+ throw takeObject(r1);
304
+ }
305
+ return takeObject(r0);
306
+ } finally {
307
+ wasm.__wbindgen_add_to_stack_pointer(16);
308
+ }
309
+ }
310
+
211
311
  /**
212
312
  * The full frontmatter block for `[key, value][]`, ending in exactly one newline.
213
313
  * @param {any} frontmatter
Binary file
@@ -2,6 +2,7 @@
2
2
  /* eslint-disable */
3
3
  export const memory: WebAssembly.Memory;
4
4
  export const check: (a: number, b: number) => void;
5
+ export const effortLevels: (a: number) => void;
5
6
  export const emitValue: (a: number, b: number, c: number) => void;
6
7
  export const inspect: (a: number, b: number) => void;
7
8
  export const normalize: (a: number, b: number) => void;
@@ -9,6 +10,9 @@ export const prepare: (a: number, b: number) => void;
9
10
  export const project: (a: number, b: number, c: number, d: number) => void;
10
11
  export const read: (a: number, b: number, c: number, d: number, e: number) => void;
11
12
  export const renderHooks: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
13
+ export const resolve: (a: number, b: number) => void;
14
+ export const resolveAlias: (a: number, b: number, c: number) => void;
15
+ export const resolveEffort: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
12
16
  export const rewriteBlock: (a: number, b: number) => void;
13
17
  export const satisfies: (a: number, b: number, c: number, d: number, e: number) => void;
14
18
  export const satisfiesRequirement: (a: number, b: number, c: number, d: number, e: number) => void;