@grida/ai-models 1.20261113.1 → 2.20261115.0
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.
- package/README.md +5 -4
- package/SCHEMA_CHANGELOG.md +78 -0
- package/manifest.json +16 -12
- package/models.json +1 -1
- package/package.json +2 -1
- package/schemas/labs.schema.json +2 -2
- package/schemas/models.schema.json +6 -5
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ provider bindings, and published prices, with the labs that make them and their
|
|
|
5
5
|
logos. Every fact cites a first-party source.
|
|
6
6
|
|
|
7
7
|
This package is the data, published unchanged from release
|
|
8
|
-
[`
|
|
8
|
+
[`v2.20261115.0`](https://github.com/gridaco/models/releases/tag/v2.20261115.0) of [gridaco/models](https://github.com/gridaco/models). It contains no code.
|
|
9
9
|
|
|
10
10
|
| file | contents |
|
|
11
11
|
| --- | --- |
|
|
@@ -15,6 +15,7 @@ This package is the data, published unchanged from release
|
|
|
15
15
|
| `schemas/` | JSON Schemas for `models.json` and `labs.json` |
|
|
16
16
|
| `manifest.json` | Version, source commit, content digest, and the SHA-256 of every file |
|
|
17
17
|
| `PROVENANCE.md` | Source notes that do not fit in JSON |
|
|
18
|
+
| `SCHEMA_CHANGELOG.md` | Authored schema changes, compatibility and migration notes |
|
|
18
19
|
|
|
19
20
|
```js
|
|
20
21
|
import models from "@grida/ai-models/models.json" with { type: "json" };
|
|
@@ -24,13 +25,13 @@ import labs from "@grida/ai-models/labs.json" with { type: "json" };
|
|
|
24
25
|
From a CDN, without installing:
|
|
25
26
|
|
|
26
27
|
```
|
|
27
|
-
https://cdn.jsdelivr.net/npm/@grida/ai-models@
|
|
28
|
-
https://cdn.jsdelivr.net/npm/@grida/ai-models@
|
|
28
|
+
https://cdn.jsdelivr.net/npm/@grida/ai-models@2/models.json
|
|
29
|
+
https://cdn.jsdelivr.net/npm/@grida/ai-models@2.20261115.0/models.json
|
|
29
30
|
```
|
|
30
31
|
|
|
31
32
|
## Versions
|
|
32
33
|
|
|
33
|
-
Versions read `<schema>.<YYYYMMDD>.<n>`. The major is the schema version, so `^
|
|
34
|
+
Versions read `<schema>.<YYYYMMDD>.<n>`. The major is the schema version, so `^2` follows
|
|
34
35
|
every snapshot without crossing a breaking change. A new version is published whenever the
|
|
35
36
|
catalogue's content changes.
|
|
36
37
|
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Schema changelog
|
|
2
|
+
|
|
3
|
+
Authored history of the catalogue's public contract: fields, validation rules and
|
|
4
|
+
their meanings. Model additions, provider coverage and price changes belong in
|
|
5
|
+
the generated [snapshot release notes](https://github.com/gridaco/models/releases).
|
|
6
|
+
|
|
7
|
+
Entries are grouped by schema major, newest first. Entry dates identify when a
|
|
8
|
+
change was documented; tagged releases establish when a snapshot was published.
|
|
9
|
+
An entry linked to an open PR does not mean the change has been released. See
|
|
10
|
+
[Maintaining this log](#maintaining-this-log) for contributor requirements.
|
|
11
|
+
|
|
12
|
+
## Schema v2
|
|
13
|
+
|
|
14
|
+
### 2026-11-15 — Decision offerings may omit an underlying model
|
|
15
|
+
|
|
16
|
+
Reference: [#44](https://github.com/gridaco/models/pull/44).
|
|
17
|
+
|
|
18
|
+
**Change:** `decision_card.underlying_model` is optional. It continues to record
|
|
19
|
+
the canonical identity of a documented underlying model when present, with the
|
|
20
|
+
existing nonempty-string constraint. Omission means no relationship is recorded;
|
|
21
|
+
it does not infer a parent, a self-reference or inherited chat capabilities.
|
|
22
|
+
|
|
23
|
+
The validation change is:
|
|
24
|
+
|
|
25
|
+
```diff
|
|
26
|
+
- "required": ["vendor", "underlying_model", "providers"]
|
|
27
|
+
+ "required": ["vendor", "providers"]
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**Compatibility:** breaking for v1 readers that require this relationship. The
|
|
31
|
+
new validator accepts cards with the relationship retained, but a newly emitted
|
|
32
|
+
card without it fails the old v1 validator. The Models `$schema`, both schema
|
|
33
|
+
`$id`s and release/package major move to v2. Labs retain their record shape and
|
|
34
|
+
follow the same release major.
|
|
35
|
+
|
|
36
|
+
`decision.models` remains semantic grouping, not a shared execution protocol.
|
|
37
|
+
Provider request/result contracts, uncertainty meanings, usage and prices remain
|
|
38
|
+
independent. No new primitive set, model card or published rate is introduced.
|
|
39
|
+
|
|
40
|
+
**Migration:** update the reader/validator before selecting a v2 snapshot and
|
|
41
|
+
handle an absent relationship. Existing v1 pins remain on v1; GitHub `latest`
|
|
42
|
+
moves across majors, so moving v1 asset URLs stop resolving after the first v2
|
|
43
|
+
release. See the [v1-to-v2 migration instructions](https://github.com/gridaco/models/blob/5fd023df088af38a135246c8e476f60d7c30cbc6/README.md#migrating-from-schema-version-1)
|
|
44
|
+
for schema identifiers, asset names and pin choices.
|
|
45
|
+
|
|
46
|
+
## Schema v1
|
|
47
|
+
|
|
48
|
+
Version 1 predates this authored log. Its contract history remains in the
|
|
49
|
+
[tagged snapshots and release notes](https://github.com/gridaco/models/releases)
|
|
50
|
+
and [schema Git history](https://github.com/gridaco/models/commits/main/catalogue/schemas).
|
|
51
|
+
This log starts with the v2 transition rather than reconstructing an incomplete
|
|
52
|
+
history of v1 changes.
|
|
53
|
+
|
|
54
|
+
## Maintaining this log
|
|
55
|
+
|
|
56
|
+
Update this file in the same PR as a public contract change, including compatible
|
|
57
|
+
extensions. This covers added/removed fields, requiredness, types, enum values,
|
|
58
|
+
constraints and field meanings, plus consumer-visible validation or generation
|
|
59
|
+
behavior implemented outside the JSON Schemas. A new model fitting the existing
|
|
60
|
+
contract needs no entry.
|
|
61
|
+
|
|
62
|
+
Keep each entry short: state the field/rule and before/after behavior, whether
|
|
63
|
+
the change is breaking, the consumer action needed (or why none is needed), and
|
|
64
|
+
the PR link. Add dated entries under the relevant schema major; changing snapshot
|
|
65
|
+
dates or counters does not create another entry. Follow the catalogue's existing
|
|
66
|
+
[versioning rules](https://github.com/gridaco/models/blob/main/catalogue/README.md#rules)
|
|
67
|
+
for a breaking change.
|
|
68
|
+
|
|
69
|
+
Exclude model facts, model/provider additions, rates, provenance-only corrections,
|
|
70
|
+
tooling-only refactors and formatting-only changes. Preserve published history;
|
|
71
|
+
make corrections explicit instead of silently rewriting an earlier contract's
|
|
72
|
+
meaning.
|
|
73
|
+
|
|
74
|
+
The PR check compares JSON content under `catalogue/schemas/` and requires a
|
|
75
|
+
non-whitespace changelog update when that content changes, including schema
|
|
76
|
+
additions or removals. It ignores JSON formatting and object-key order. This
|
|
77
|
+
check cannot judge prose accuracy or detect every behavioral change outside the
|
|
78
|
+
schemas: contributors and reviewers must check those changes against this log.
|
package/manifest.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "grida-models",
|
|
3
|
-
"version": "
|
|
4
|
-
"schema_version":
|
|
5
|
-
"commit": "
|
|
6
|
-
"created": "2026-11-
|
|
7
|
-
"source": "https://github.com/gridaco/models/tree/
|
|
8
|
-
"digest": "sha256:
|
|
3
|
+
"version": "v2.20261115.0",
|
|
4
|
+
"schema_version": 2,
|
|
5
|
+
"commit": "26cd2de507d29961546dabe66d83fbb2063d0bc0",
|
|
6
|
+
"created": "2026-11-15T10:57:18Z",
|
|
7
|
+
"source": "https://github.com/gridaco/models/tree/26cd2de507d29961546dabe66d83fbb2063d0bc0/catalogue",
|
|
8
|
+
"digest": "sha256:cf33026409454b86b5da940a849f41f6a1509dd76ba1918ee5b29210eaf181d0",
|
|
9
9
|
"counts": {
|
|
10
10
|
"cards": 106,
|
|
11
11
|
"labs": 18
|
|
@@ -16,8 +16,12 @@
|
|
|
16
16
|
"bytes": 102548
|
|
17
17
|
},
|
|
18
18
|
"README.md": {
|
|
19
|
-
"sha256": "
|
|
20
|
-
"bytes":
|
|
19
|
+
"sha256": "02a012d4a62236c014e5f655e31d4e934981520788bde96788d1db3ba3eb9322",
|
|
20
|
+
"bytes": 31381
|
|
21
|
+
},
|
|
22
|
+
"SCHEMA_CHANGELOG.md": {
|
|
23
|
+
"sha256": "4ce477fc504b676055aa4d713a75879327c1a001efa55c4cfacd886682aec17c",
|
|
24
|
+
"bytes": 4043
|
|
21
25
|
},
|
|
22
26
|
"labs.json": {
|
|
23
27
|
"sha256": "b3267fae072fb4b6083f464117a9d5109b5b1237211b8541ecb083b86fd26c53",
|
|
@@ -92,16 +96,16 @@
|
|
|
92
96
|
"bytes": 330
|
|
93
97
|
},
|
|
94
98
|
"models.json": {
|
|
95
|
-
"sha256": "
|
|
99
|
+
"sha256": "c01b4ed634e45e5e45b94ec05fa957f73e99e2f866b7028ff79217c29dd692ec",
|
|
96
100
|
"bytes": 1123858
|
|
97
101
|
},
|
|
98
102
|
"schemas/labs.schema.json": {
|
|
99
|
-
"sha256": "
|
|
103
|
+
"sha256": "a720f50f9ee5c3ddd2fccf50e38ddecec686896b768a52cc987df52668171f07",
|
|
100
104
|
"bytes": 2469
|
|
101
105
|
},
|
|
102
106
|
"schemas/models.schema.json": {
|
|
103
|
-
"sha256": "
|
|
104
|
-
"bytes":
|
|
107
|
+
"sha256": "d095009e7d362f70d37116a90a48f9b44fd252d4c578983c79076fc6eba212c9",
|
|
108
|
+
"bytes": 40443
|
|
105
109
|
}
|
|
106
110
|
}
|
|
107
111
|
}
|
package/models.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@grida/ai-models",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.20261115.0",
|
|
4
4
|
"description": "A hand-curated, source-backed catalogue of AI models, their labs, and published prices.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -20,6 +20,7 @@
|
|
|
20
20
|
"license": "MIT",
|
|
21
21
|
"files": [
|
|
22
22
|
"PROVENANCE.md",
|
|
23
|
+
"SCHEMA_CHANGELOG.md",
|
|
23
24
|
"labs.json",
|
|
24
25
|
"logos",
|
|
25
26
|
"manifest.json",
|
package/schemas/labs.schema.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://grida.co/schemas/ai-model-labs-
|
|
4
|
-
"title": "Model labs, version
|
|
3
|
+
"$id": "https://grida.co/schemas/ai-model-labs-v2.json",
|
|
4
|
+
"title": "Model labs, version 2",
|
|
5
5
|
"description": "The labs that make catalogued models, keyed by lab ID. A lab ID is the `vendor` value on models.json cards.",
|
|
6
6
|
"type": "object",
|
|
7
7
|
"minProperties": 1,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://grida.co/schemas/ai-model-facts-
|
|
4
|
-
"title": "Canonical model facts, authoring envelope version
|
|
3
|
+
"$id": "https://grida.co/schemas/ai-model-facts-v2.json",
|
|
4
|
+
"title": "Canonical model facts, authoring envelope version 2",
|
|
5
5
|
"description": "Structural interchange schema with sourced, additive model and serving-provider facts.",
|
|
6
6
|
"type": "object",
|
|
7
7
|
"additionalProperties": false,
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"properties": {
|
|
23
23
|
"$schema": {
|
|
24
24
|
"description": "This file's schema: the `$id` of models.schema.json. Generated files always carry it.",
|
|
25
|
-
"const": "https://grida.co/schemas/ai-model-facts-
|
|
25
|
+
"const": "https://grida.co/schemas/ai-model-facts-v2.json"
|
|
26
26
|
},
|
|
27
27
|
"text.catalog": {
|
|
28
28
|
"type": "object",
|
|
@@ -209,6 +209,7 @@
|
|
|
209
209
|
}
|
|
210
210
|
},
|
|
211
211
|
"decision.models": {
|
|
212
|
+
"description": "Semantic grouping of decision offerings, not a shared execution protocol. Each provider endpoint retains its own request, result and accounting contract.",
|
|
212
213
|
"type": "object",
|
|
213
214
|
"minProperties": 1,
|
|
214
215
|
"additionalProperties": {
|
|
@@ -1339,13 +1340,13 @@
|
|
|
1339
1340
|
"$ref": "#/$defs/card"
|
|
1340
1341
|
}
|
|
1341
1342
|
],
|
|
1342
|
-
"required": ["vendor", "
|
|
1343
|
+
"required": ["vendor", "providers"],
|
|
1343
1344
|
"unevaluatedProperties": false,
|
|
1344
1345
|
"properties": {
|
|
1345
1346
|
"underlying_model": {
|
|
1346
1347
|
"type": "string",
|
|
1347
1348
|
"minLength": 1,
|
|
1348
|
-
"description": "Canonical catalogue identity of
|
|
1349
|
+
"description": "Canonical catalogue identity of a documented underlying model, when known. Omission means no relationship is recorded; this offering has its own interface and rates."
|
|
1349
1350
|
},
|
|
1350
1351
|
"decision_contract": {
|
|
1351
1352
|
"$ref": "#/$defs/decision_contract"
|