@aiwg/cli 2026.10.5 → 2026.10.7

package/dist/src/artifacts/cli.js

@@ -329,6 +329,7 @@ export function printIndexUsage() {
     console.log('  build [--force] [--verbose] [--all] [--scope <dir>] [--graph <name>]');
     console.log('  refresh [--full] [--workspace <path>]... [--root <dir>]...');
     console.log('          [--only graphs|sessions|caches|runtime|models|issues] [--dry-run] [--json] [--lock-wait-ms <n>]');
+    console.log('  --only also accepts a registered index name (for example project) or all.');
     console.log('          [--max-record-bytes <n>] [--max-source-bytes <n>]');
     console.log('  Session import defaults: 67108864 bytes per record, 1073741824 bytes (1 GiB) per source; source 0 is unlimited.');
     console.log('  --exclude <id-or-glob> (repeatable): skip session IDs or absolute path globs; adds to sessions.import.exclude and AIWG_SESSIONS_IMPORT_EXCLUDE (comma-separated).');
@@ -1085,6 +1086,21 @@ async function handleExport(args) {
         process.exit(1);
     }
 }
+function warnSyncTextQuality(manifest) {
+    const quality = manifest.text_quality;
+    if (!quality?.degenerate)
+        return;
+    const config = GRAPH_CONFIGS[manifest.graph];
+    const source = config
+        ? ` Source: ${config.scanDirs.join(', ')} (nodeStrategy: ${config.nodeStrategy ?? 'default'}).`
+        : '';
+    if (manifest.item_count === 0) {
+        console.warn(`Warning: graph '${manifest.graph}' contains no indexed items; this graph cannot return results.${source}`);
+        return;
+    }
+    const percent = Math.round(quality.short_text_count / manifest.item_count * 100);
+    console.warn(`Warning: graph '${manifest.graph}': ${quality.short_text_count}/${manifest.item_count} items (${percent}%) have <${quality.short_text_threshold_chars} chars of indexed text; ${quality.filename_title_count} have a filename as title. This graph may return poor results. Check source content and extracted text sidecars.${source}`);
+}
 /**
  * Handle 'index sync' command
  */
@@ -1154,6 +1170,7 @@ async function handleSync(args) {
             console.log(`Fortemi Core sync: ${manifests.length} graph(s) succeeded, ${failures.length} failed`);
             for (const manifest of manifests) {
                 console.log(`  ${manifest.graph}: ${manifest.status}, ${manifest.item_count} item(s) → ${manifest.export_path}`);
+                warnSyncTextQuality(manifest);
             }
             for (const failure of failures) {
                 console.error(`  ${failure.graph}: failed — ${failure.error}`);
@@ -1169,6 +1186,7 @@ async function handleSync(args) {
             return;
         }
         console.log(`Fortemi Core ${manifest.status}: ${manifest.item_count} item(s) → ${manifest.export_path}`);
+        warnSyncTextQuality(manifest);
     }
     catch (err) {
         console.error('Error: ' + (err instanceof Error ? err.message : String(err)));
@@ -1300,7 +1318,7 @@ async function handleStats(args) {
  */
 async function handleStatus(args) {
     if (args.includes('--help') || args.includes('-h')) {
-        console.log('Usage: aiwg index status [--json]');
+        console.log('Usage: aiwg index status [--only <name|all>] [--json]');
         console.log('       aiwg index list   [--json]   (alias)');
         console.log('');
         console.log('Enumerate every registered index graph (built-in + module + operator)');
@@ -1314,7 +1332,10 @@ async function handleStatus(args) {
         return;
     }
     const { showIndexStatus } = await import('./index-status.js');
-    await showIndexStatus(process.cwd(), { json: args.includes('--json') });
+    const onlyAt = args.indexOf('--only');
+    if (onlyAt >= 0 && (!args[onlyAt + 1] || args[onlyAt + 1].startsWith('--')))
+        throw new Error('--only requires an index name');
+    await showIndexStatus(process.cwd(), { json: args.includes('--json'), only: onlyAt >= 0 ? args[onlyAt + 1] : undefined });
 }
 /**
  * Handle 'index neighbors' command
@@ -1522,7 +1543,7 @@ async function handleDiscover(args) {
     });
 }
 /**
- * Handle 'index show' command — print the full text of a specific
+ * Handle 'index show' command — show the metadata card of a specific
  * artifact by type and name.
  *
  * Shape (#1218):
@@ -1531,9 +1552,31 @@ async function handleDiscover(args) {
  * Type is positional (not a flag) so the verb reads as
  * "show <kind> <name>". `<type>` is one of the operational show types.
  *
- * Companion to `discover`: where discover ranks candidates, show fetches
- * the artifact body so consumers don't need to navigate the filesystem.
+ * Companion to `discover`: where discover ranks candidates, show returns
+ * a metadata card with section/body drill-ins so consumers don't need to navigate the filesystem.
  */
+const SHOW_FLAGS = new Set(['--json', '--first', '--bound-rule-bodies', '--graph', '--backend', '--resource-source',
+    '--aiwg-version', '--offline', '--body', '--section', '--rules', '--with-rule-bodies', '--resources', '--resource',
+    '--help']);
+// Section headings can themselves start with `--` (e.g. "--max-iterations (default: 10)"), and the card
+// tells agents to pass them verbatim. Only a missing value or another show flag counts as "no value".
+function showFlagValue(flags, index) {
+    const value = flags[index + 1];
+    if (!value || SHOW_FLAGS.has(value.split('=')[0]))
+        throw new Error(`${flags[index]} requires a value`);
+    return value;
+}
+/** Values for a repeatable value flag, accepting both `--flag value` and `--flag=value`. */
+function showFlagValues(flags, name) {
+    const values = [];
+    for (let i = 0; i < flags.length; i++) {
+        if (flags[i] === name)
+            values.push(showFlagValue(flags, i));
+        else if (flags[i].startsWith(`${name}=`))
+            values.push(flags[i].slice(name.length + 1));
+    }
+    return values;
+}
 async function handleShow(args) {
     const { showArtifact, showMetadata } = await import('./query-engine.js');
     const cwd = process.cwd();
@@ -1567,9 +1610,11 @@ async function handleShow(args) {
         '  aiwg show command discover',
         '  aiwg show skill intake-wizard --resource-source web --aiwg-version stable',
         '',
+        'Default: metadata card. --body restores full output; --section <heading> is repeatable.',
+        '--rules [--with-rule-bodies] | --resources | --resource <path>',
         'Bound rules: summaries and show pointers are appended for bound skills, agents, and flows.',
         'Fetch and follow every required_rule_checks entry before starting governed work; summaries do not replace full rules.',
-        'Use --bound-rule-bodies to include their full text (JSON: bound_rules[].content).',
+        'Use --rules --with-rule-bodies to include their full text (legacy alias: --bound-rule-bodies).',
         '',
         'Tip: use `aiwg discover "<phrase>" --json` first to find the stable id.',
     ].join('\n');
@@ -1635,6 +1680,12 @@ async function handleShow(args) {
     const params = {
         name,
         boundRuleBodies: flags.includes('--bound-rule-bodies'),
+        body: flags.includes('--body'),
+        sections: showFlagValues(flags, '--section'),
+        rules: flags.includes('--rules'),
+        withRuleBodies: flags.includes('--with-rule-bodies'),
+        resources: flags.includes('--resources'),
+        resource: showFlagValues(flags, '--resource')[0],
         typeFilter: type ? [type] : undefined,
         json,
         first,

package/dist/src/artifacts/fortemi-core-query-adapter.js

@@ -244,6 +244,8 @@ function entryFromRecord(record) {
     const indexedScript = indexedFrontmatter.aiwg_script;
     return {
         path: record.source.path,
+        ...(indexedFrontmatter.aiwg_memory_record && typeof indexedFrontmatter.aiwg_memory_record === 'object'
+            ? { memoryRecord: indexedFrontmatter.aiwg_memory_record } : {}),
         type: artifactTypeFromRecord(record),
         kind: typeof indexedFrontmatter.aiwg_kind === "string"
             ? indexedFrontmatter.aiwg_kind

package/dist/src/artifacts/fortemi-core-sync.js

@@ -5,9 +5,9 @@ import { fileURLToPath } from "node:url";
 import { parse as parseYaml } from "yaml";
 import { GRAPH_CONFIGS, getProjectIndexRoot, loadGlobalGraphConfigs } from "./types.js";
 import { buildAiwgFortemiIndexExport, } from "./browser-export.js";
-import { loadGraphIndexFile } from "./index-reader.js";
+import { loadGraphIndexFile, publishIndexFiles } from "./index-reader.js";
 import { getFrameworkIndexBaseDir } from './framework-index-paths.js';
-function syncDir(cwd, graph) {
+export function getFortemiCoreIndexDir(cwd, graph) {
     loadGlobalGraphConfigs();
     if (graph === 'framework')
         return path.join(getFrameworkIndexBaseDir(cwd), 'fortemi-core', graph);
@@ -180,14 +180,15 @@ function writeExport(file, exported, maxChars) {
 }
 export function syncFortemiCoreIndex(cwd, options = {}) {
     const graph = options.graph ?? "project";
-    const dir = syncDir(cwd, graph);
+    const dir = getFortemiCoreIndexDir(cwd, graph);
     const exportPath = path.join(dir, "aiwg-fortemi-index-v2.json");
     const manifestPath = path.join(dir, "manifest.json");
     const maxChars = options.maxChunkChars ?? 64 * 1024;
     if (!Number.isSafeInteger(maxChars) || maxChars < 64)
         throw new Error("maxChunkChars must be an integer of at least 64");
     fs.mkdirSync(dir, { recursive: true });
-    const temporaryPath = path.join(dir, `.export-${randomUUID()}.tmp`);
+    const staging = fs.mkdtempSync(path.join(dir, ".sync-"));
+    const temporaryPath = path.join(staging, `.export-${randomUUID()}.tmp`);
     const previous = readManifest(manifestPath);
     const sourceBuiltAt = sourceIndexBuiltAt(cwd, graph);
     const buildExport = (generatedAt) => {
@@ -200,10 +201,25 @@ export function syncFortemiCoreIndex(cwd, options = {}) {
         });
         const checksum = writeExport(temporaryPath, exported, maxChars);
         const recordsWithConcepts = exported.items.filter((item) => (item.skos_concepts?.length ?? 0) > 0).length;
+        const shortTextThreshold = 200;
+        let shortTextCount = 0;
+        let filenameTitleCount = 0;
+        for (const item of exported.items) {
+            if (item.text.trim().length < shortTextThreshold)
+                shortTextCount++;
+            if (item.title.trim() === path.posix.basename(item.source.path))
+                filenameTitleCount++;
+        }
         return {
             generatedAt,
             checksum,
             itemCount: exported.items.length,
+            textQuality: {
+                short_text_threshold_chars: shortTextThreshold,
+                short_text_count: shortTextCount,
+                filename_title_count: filenameTitleCount,
+                degenerate: exported.items.length === 0 || shortTextCount / exported.items.length >= 0.8,
+            },
             skosCoverage: {
                 records_with_concepts: recordsWithConcepts,
                 total_records: exported.items.length,
@@ -228,7 +244,7 @@ export function syncFortemiCoreIndex(cwd, options = {}) {
                 }
             }
         }
-        fs.renameSync(temporaryPath, exportPath);
+        fs.renameSync(temporaryPath, path.join(staging, path.basename(exportPath)));
         const manifest = {
             schema_version: "aiwg.fortemi.core-sync.v1",
             backend: "fortemi-core",
@@ -238,19 +254,21 @@ export function syncFortemiCoreIndex(cwd, options = {}) {
             export_schema_version: "aiwg.fortemi.index.export.v2",
             export_checksum: built.checksum,
             item_count: built.itemCount,
+            text_quality: built.textQuality,
             skos_coverage: built.skosCoverage,
             status,
             source_index_built_at: sourceBuiltAt,
         };
-        fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+        fs.writeFileSync(path.join(staging, path.basename(manifestPath)), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+        publishIndexFiles(staging, dir);
         return manifest;
     }
     finally {
-        fs.rmSync(temporaryPath, { force: true });
+        fs.rmSync(staging, { recursive: true, force: true });
     }
 }
 export function getFortemiCoreSyncStatus(cwd, graph = "project") {
-    const dir = syncDir(cwd, graph);
+    const dir = getFortemiCoreIndexDir(cwd, graph);
     const manifestPath = path.join(dir, "manifest.json");
     const exportPath = path.join(dir, "aiwg-fortemi-index-v2.json");
     const { manifest, reason: manifestReadReason } = readManifestResult(manifestPath);

package/dist/src/artifacts/fortemi-shard-contract/2.2.0/contract.json

@@ -0,0 +1,103 @@
+{
+  "schemaVersion": 1,
+  "contractRevision": "23",
+  "status": "unreleased-candidate",
+  "authority": {
+    "repository": "Fortemi/fortemi",
+    "issue": "https://git.integrolabs.net/Fortemi/fortemi/issues/1217",
+    "adr": "docs/architecture/adr/ADR-102-canonical-knowledge-shard-contract.md"
+  },
+  "knowledgeShard": {
+    "format": "matric-shard",
+    "schemaVersion": "2.2.0",
+    "minimumReaderVersion": "2.2.0",
+    "profile": "full-v1"
+  },
+  "schemaBundle": {
+    "baseAuthority": "contracts/knowledge-shard/2.1.0/contract.json",
+    "files": {
+      "contracts/knowledge-shard/2.1.0/core-v1/collection.schema.json": "7507e3d8889c298f058246adecfa3fe8cf529f9c54f51a6beeec5a2229e8afff",
+      "contracts/knowledge-shard/2.1.0/core-v1/link.schema.json": "e654ca15596d4c3bddd99061f1011ae84085725db7b5b877023491d4c70a55fd",
+      "contracts/knowledge-shard/2.1.0/core-v1/note.schema.json": "f43082707710b1222afba6bd4f39ca694868257cdc0f6c3741fea48a48f322b8",
+      "contracts/knowledge-shard/2.1.0/core-v1/tag.schema.json": "dba94d9b65ef485667a618594d4e543da3db743b1608073daf340af39c83586f",
+      "contracts/knowledge-shard/2.1.0/core-v1/template.schema.json": "45d452c0d0ec82d8d8640d01b4db6ceeb92e8409597986f2d1c2361eccd8a3b6",
+      "contracts/knowledge-shard/2.1.0/full-v1/community-assignment.schema.json": "43caae37ff83af794e3b33c5c5a890c29891391c9013894b6a27a368d1d1a1e1",
+      "contracts/knowledge-shard/2.1.0/full-v1/community-set.schema.json": "44b5ba4dfafffafca4cd2dcbeb613e84b5eac40b8141ee42b64acdd442fc505c",
+      "contracts/knowledge-shard/2.1.0/full-v1/embedding-set-member.schema.json": "c3ec095a34bc679caf5953e103f8ff340def3e7f7d24354f84c0b23a50e685b9",
+      "contracts/knowledge-shard/2.1.0/full-v1/embedding.schema.json": "d0062129a58cc963688d8a477d93bb18c2515ebbb7459751540fae3be938866c",
+      "contracts/knowledge-shard/2.1.0/full-v1/graph-edge.schema.json": "ec03fd6f149f93ad59f1da43fda9584307c7e3a1d1fa9a66bb532b9d5cb09619",
+      "contracts/knowledge-shard/2.1.0/full-v1/graph-source.schema.json": "4df54f110cefad9204af4d5a334b42a865488a256acb3100e71319582c9692dc",
+      "contracts/knowledge-shard/2.1.0/full-v1/named-location.schema.json": "4fdacb534ae5d061e930fd3a6e5a248eff9724e106c86013400600ef42dbc860",
+      "contracts/knowledge-shard/2.1.0/full-v1/note-original-history.schema.json": "41246036eff831ec9dd3b84868ad089983bb375289eff0886f69ae80fe27760d",
+      "contracts/knowledge-shard/2.1.0/full-v1/note-original.schema.json": "85ed82382d951107d508e0628822b5342aa9ec19c1e9231c1f22dcecdd7316fe",
+      "contracts/knowledge-shard/2.1.0/full-v1/note-revised-current.schema.json": "506cff36ced7b63b06f4c37341aac2784b8dd20df6c1a0f969584288a11c4e2a",
+      "contracts/knowledge-shard/2.1.0/full-v1/note-revision.schema.json": "29366d0d5c5dc738fbb8ae3ad129086b51da1471b00c6fa27827b1d3d70b769f",
+      "contracts/knowledge-shard/2.1.0/full-v1/note-skos-tag.schema.json": "9be98ac497399dcc8696db6ba5582e58b3a5c4f57191e5dcf45d666c2954cf42",
+      "contracts/knowledge-shard/2.1.0/full-v1/provenance-activity.schema.json": "a91766df21408b770913ffc2f01b0d94c22d22e6282169392758d9a0cc491999",
+      "contracts/knowledge-shard/2.1.0/full-v1/provenance-device.schema.json": "b3fbb075bf1b3102d684254ebc9bd7cdb65358bf3fa91c831f8bd307701bb1ee",
+      "contracts/knowledge-shard/2.1.0/full-v1/provenance-edge.schema.json": "bb60c4762c410c82879a47f79f75b34f885e8599d3e2f842ea72381c4bf7aba3",
+      "contracts/knowledge-shard/2.1.0/full-v1/provenance-location.schema.json": "d497ea4cf761e04966dbd086c6559b975f6f04a36b537e2c994da0b5db7e1bcc",
+      "contracts/knowledge-shard/2.1.0/full-v1/provenance-record.schema.json": "4b780451a3beae7557a0af7ae29e07ea7652dc7825acd072adf3c8bd58420c17",
+      "contracts/knowledge-shard/2.1.0/full-v1/signature.schema.json": "f3ff9a478f425855716f18f0921aeebcd9992884d6040df72dc397c0e3531f99",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-collection-member.schema.json": "cfcbed164958e27834075be91e7907e386e29089b65f1a79383cc4472890d2e7",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-collection.schema.json": "0820fd02247fb82ee31aee2a77481906b9e82af90f04bb12038ab519c2b39fa5",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-concept.schema.json": "7a352094ece588501dc06960abf781a642e5df82c6a47ff6002b0b2023621b1c",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-label.schema.json": "256d1f370268cdc53cbc3d0fc2dc7fa4872cfbe28c22d8162f0b07bec67565d6",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-mapping-relation.schema.json": "149c978086247bfc6da3b5a655fc6e20958fcd4f11f533eb634f1fb58eb7feac",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-note.schema.json": "87d13a0391ec78b7354af34448083096e8c767fe481d34f05ecab831aa957469",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-relation.schema.json": "5b9fc1004137e5d3d7f1a8b2d74470863b0d708dd28b148456ebf52a16ff2432",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-scheme-membership.schema.json": "7547f5fd19c1012a4045d3415af03d9ddeb9a0997ea229af490169c97730f60e",
+      "contracts/knowledge-shard/2.1.0/full-v1/skos-scheme.schema.json": "a0ce0892d56f9a6871282210192f05c97db3a92675c4b9f7c6f8d784f3100d25",
+      "contracts/knowledge-shard/2.2.0/full-v1/embedding-config.schema.json": "03476bf53465d3bfba270b3c3f1ede8254b15f4e1b60ec6b361e1edc86c44192",
+      "contracts/knowledge-shard/2.2.0/full-v1/embedding-set.schema.json": "303a938ba044960cd9b09cc5438737576afc85ed0e51994b5cabf0fa21d66655",
+      "contracts/knowledge-shard/2.2.0/full-v1/manifest.schema.json": "20b4a98c18c53ec3a6c385d886750e77e4d32100f6bb25578f8db296b5edb109"
+    }
+  },
+  "fieldSemantics": {
+    "embedding_sets.query_template": {
+      "optional": true,
+      "nullable": true,
+      "absentDefault": null,
+      "nullMeaning": "No set query wrapper; use existing provider query behavior.",
+      "valueMeaning": "Exactly one {text}, at most 2048 UTF-8 bytes; restore without modification.",
+      "exportNull": "Omit; absence and null both denote the legacy no-template default."
+    },
+    "embedding_sets.vector_source": {
+      "optional": true,
+      "nullable": true,
+      "absentDefault": "internal",
+      "nullMeaning": "Internal automatic embedding ownership",
+      "valueMeaning": "Preserve internal/external write ownership independently of searchable vector kinds."
+    },
+    "embedding_configs.provider_dimension": {
+      "optional": true,
+      "nullable": true,
+      "absentDefault": null,
+      "nullMeaning": "Legacy provider-native postprocessing.",
+      "valueMeaning": "Raw provider output before truncation and L2 normalization; storage dimension <= raw <= 16384."
+    }
+  },
+  "compatibility": {
+    "previousReaders": "Continue accepting 1.x, 2.0.0 and 2.1.0; absent query_template/provider_dimension default to NULL and vector_source to internal.",
+    "upgrade": "2.1.0 records remain valid 2.2.0 records; no rewriting or migration is required.",
+    "downgrade": "Reject older full-v1 exports if query_template, external ownership, or provider_dimension would be discarded.",
+    "selection": "Full-v1 exports select 2.2.0 when any of these extended contracts is present."
+  },
+  "canonicalCorpus": {
+    "path": "tests/fixtures/shards/full-v1-query-template-v2.2/embedding_sets.json",
+    "sha256": "f279cad22517395194c6a5dc327b4531bd089e151b9141324c94f01e81bacf32",
+    "test": "shard_query_template_tests::query_template_schema_2_2_golden_corpus_and_pins"
+  },
+  "consumerImpact": {
+    "fortemi": "Producer/consumer route round trip, legacy NULL default, validation-before-writes tests in shard_query_template_tests.rs.",
+    "fortemi-react": "Consumers pinned to earlier schema versions must reject 2.2.0 until their optional query_template mapping is implemented and fixtures pass. Preserve vector_source and provider_dimension under the same qualification gate.",
+    "aiwg": "Full-v1 consumers must preserve optional query_template and pass the new fixture before advertising 2.2.0. Preserve vector_source and provider_dimension under the same qualification gate.",
+    "HotM": "Consumers supporting full-v1 must negotiate 2.2.0 and preserve query_template before advertising support. Preserve vector_source and provider_dimension under the same qualification gate.",
+    "tracking": "Consumer issue/PR reciprocal links and cross-repository pins/results are required before release under Fortemi/fortemi#1217."
+  },
+  "claimPolicy": "Local implementation and corpus only. No new cross-repository conformance or release claim; existing receipts remain immutable and do not cover 2.2.0.",
+  "providerDimensionCorpus": {
+    "path": "tests/fixtures/shards/full-v1-query-template-v2.2/embedding_configs.json",
+    "sha256": "bc76206df48215d0da7a3c944874d7af5b6e01bb07df8b5849869025b7d25f89"
+  }
+}

package/dist/src/artifacts/fortemi-shard-contract/2.2.0/full-v1-embedding-config.schema.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fortemi.dev/knowledge-shard/2.2.0/full-v1/embedding-config.schema.json",
+  "title": "Fortemi Knowledge Shard full-v1 candidate embedding config record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "name",
+    "description",
+    "model",
+    "dimension",
+    "vector_type",
+    "chunk_size",
+    "chunk_overlap",
+    "hnsw_m",
+    "hnsw_ef_construction",
+    "ivfflat_lists",
+    "is_default",
+    "supports_mrl",
+    "matryoshka_dims",
+    "default_truncate_dim",
+    "provider",
+    "provider_config",
+    "content_types",
+    "strengths",
+    "limitations",
+    "recommended_for",
+    "benchmark_scores",
+    "is_available",
+    "document_composition",
+    "created_at",
+    "updated_at"
+  ],
+  "properties": {
+    "id": {
+      "$ref": "#/$defs/uuid"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "model": {
+      "type": "string",
+      "minLength": 1
+    },
+    "dimension": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 4000
+    },
+    "vector_type": {
+      "enum": [
+        "vector",
+        "halfvec"
+      ]
+    },
+    "chunk_size": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "chunk_overlap": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "hnsw_m": {
+      "$ref": "#/$defs/nullableNonNegativeInteger"
+    },
+    "hnsw_ef_construction": {
+      "$ref": "#/$defs/nullableNonNegativeInteger"
+    },
+    "ivfflat_lists": {
+      "$ref": "#/$defs/nullableNonNegativeInteger"
+    },
+    "is_default": {
+      "$ref": "#/$defs/nullableBoolean"
+    },
+    "supports_mrl": {
+      "$ref": "#/$defs/nullableBoolean"
+    },
+    "matryoshka_dims": {
+      "oneOf": [
+        {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "integer",
+            "minimum": 1
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "default_truncate_dim": {
+      "$ref": "#/$defs/nullablePositiveInteger"
+    },
+    "provider": {
+      "enum": [
+        null,
+        "ollama",
+        "openai",
+        "voyage",
+        "cohere",
+        "custom"
+      ]
+    },
+    "provider_config": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "content_types": {
+      "$ref": "#/$defs/nullableStringArray"
+    },
+    "strengths": {
+      "$ref": "#/$defs/nullableStringArray"
+    },
+    "limitations": {
+      "$ref": "#/$defs/nullableStringArray"
+    },
+    "recommended_for": {
+      "$ref": "#/$defs/nullableStringArray"
+    },
+    "benchmark_scores": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "is_available": {
+      "$ref": "#/$defs/nullableBoolean"
+    },
+    "document_composition": {
+      "type": "object"
+    },
+    "space_contract": true,
+    "space_id": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "created_at": {
+      "$ref": "#/$defs/dateTime"
+    },
+    "updated_at": {
+      "$ref": "#/$defs/dateTime"
+    },
+    "provider_dimension": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1,
+      "maximum": 16384
+    }
+  },
+  "$defs": {
+    "uuid": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "dateTime": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "nullableBoolean": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "nullableNonNegativeInteger": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 0
+    },
+    "nullablePositiveInteger": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1
+    },
+    "nullableStringArray": {
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  }
+}