omnius 1.0.922 → 1.0.924

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 (241) hide show
  1. package/dist/{providerRegistry.d.ts → _types/backend-vllm/providerRegistry.d.ts} +0 -1
  2. package/dist/_types/backend-vllm/types.d.ts +209 -0
  3. package/dist/_types/execution/av/media-capability.d.ts +94 -0
  4. package/dist/_types/execution/delegation-contract.d.ts +102 -0
  5. package/dist/_types/execution/evidence.d.ts +68 -0
  6. package/dist/_types/execution/html-source-evidence.d.ts +65 -0
  7. package/dist/_types/execution/mcp/types.d.ts +169 -0
  8. package/dist/_types/execution/mutation-contract.d.ts +102 -0
  9. package/dist/_types/execution/nol/artifacts.d.ts +39 -0
  10. package/dist/_types/execution/nol/checkpoint-edits.d.ts +98 -0
  11. package/dist/_types/execution/nol/distributions.d.ts +128 -0
  12. package/dist/_types/execution/nol/gguf-checkpoint-edits.d.ts +194 -0
  13. package/dist/_types/execution/nol/gguf-control-reader.d.ts +224 -0
  14. package/dist/_types/execution/nol/lora-exports.d.ts +129 -0
  15. package/dist/_types/execution/nol/neuronary.d.ts +212 -0
  16. package/dist/_types/execution/nol/pytorch-control-reader.d.ts +143 -0
  17. package/dist/_types/execution/nol/qwen35-head-sites.d.ts +61 -0
  18. package/dist/_types/execution/nol/worker-assets.d.ts +82 -0
  19. package/dist/_types/execution/nol/worker-protocol.d.ts +94 -0
  20. package/dist/_types/execution/page-content-source.d.ts +40 -0
  21. package/dist/_types/execution/rapid-computer-use/artifact-store.d.ts +21 -0
  22. package/dist/_types/execution/rapid-computer-use/contracts.d.ts +320 -0
  23. package/dist/_types/execution/rapid-computer-use/decision.d.ts +70 -0
  24. package/dist/_types/execution/rapid-computer-use/desktop-verification.d.ts +23 -0
  25. package/dist/_types/execution/rapid-computer-use/geometry.d.ts +57 -0
  26. package/dist/_types/execution/rapid-computer-use/planner.d.ts +78 -0
  27. package/dist/_types/execution/rapid-computer-use/trace.d.ts +80 -0
  28. package/dist/_types/execution/rapid-computer-use/visual.d.ts +48 -0
  29. package/dist/_types/execution/shell-runs.d.ts +78 -0
  30. package/dist/_types/execution/streamed-web-source.d.ts +64 -0
  31. package/dist/_types/execution/tools/browser-page-fallback.d.ts +25 -0
  32. package/dist/_types/execution/tools/network-egress-policy.d.ts +30 -0
  33. package/dist/_types/execution/tools/pdf-native-tables.d.ts +46 -0
  34. package/dist/_types/execution/tools/todo-store.d.ts +133 -0
  35. package/dist/_types/execution/tools/web-fetch.d.ts +57 -0
  36. package/dist/_types/execution/tools/workboard.d.ts +1223 -0
  37. package/dist/_types/execution/types.d.ts +549 -0
  38. package/dist/_types/execution/web-source.d.ts +14 -0
  39. package/dist/_types/memory/artifactReviewSourceIndex.d.ts +133 -0
  40. package/dist/_types/memory/contextMemoryLedger.d.ts +213 -0
  41. package/dist/_types/memory/db.d.ts +12 -0
  42. package/dist/_types/memory/embeddings.d.ts +36 -0
  43. package/dist/_types/memory/immutableEvidenceStore.d.ts +165 -0
  44. package/dist/_types/memory/memoryIngestion.d.ts +65 -0
  45. package/dist/_types/memory/memoryTypes.d.ts +312 -0
  46. package/dist/_types/memory/sourceCorpusStore.d.ts +331 -0
  47. package/dist/_types/memory/structuredMemoryStore.d.ts +105 -0
  48. package/dist/_types/memory/unifiedMemoryStore.d.ts +127 -0
  49. package/dist/_types/memory/virtualMemory.d.ts +187 -0
  50. package/dist/_types/orchestrator/agentic-page-content-receipt.d.ts +20 -0
  51. package/dist/_types/orchestrator/agentic-web-fetch-receipt.d.ts +20 -0
  52. package/dist/_types/orchestrator/agenticRunner.d.ts +5216 -0
  53. package/dist/_types/orchestrator/app-state.d.ts +171 -0
  54. package/dist/_types/orchestrator/artifactClaimCritic.d.ts +63 -0
  55. package/dist/_types/orchestrator/artifactQuality.d.ts +15 -0
  56. package/dist/_types/orchestrator/artifactSemanticIntegrity.d.ts +203 -0
  57. package/dist/_types/orchestrator/canonical-context-projection.d.ts +254 -0
  58. package/dist/_types/orchestrator/canonical-source-body-projection.d.ts +51 -0
  59. package/dist/_types/orchestrator/completion-review-pending.d.ts +24 -0
  60. package/dist/_types/orchestrator/completionContract.d.ts +103 -0
  61. package/dist/_types/orchestrator/completionFinalization.d.ts +224 -0
  62. package/dist/_types/orchestrator/completionLedger.d.ts +429 -0
  63. package/dist/_types/orchestrator/completionReadiness.d.ts +234 -0
  64. package/dist/_types/orchestrator/context-admission.d.ts +93 -0
  65. package/dist/_types/orchestrator/context-dump-retention.d.ts +25 -0
  66. package/dist/_types/orchestrator/context-fabric.d.ts +133 -0
  67. package/dist/_types/orchestrator/contextEngine.d.ts +68 -0
  68. package/dist/_types/orchestrator/contextWindowDump.d.ts +327 -0
  69. package/dist/_types/orchestrator/convergence-breaker.d.ts +225 -0
  70. package/dist/_types/orchestrator/convergence-progress.d.ts +66 -0
  71. package/dist/_types/orchestrator/deliveryCoverage.d.ts +181 -0
  72. package/dist/_types/orchestrator/document-persistence-goal-binding.d.ts +106 -0
  73. package/dist/_types/orchestrator/durable-document-worker.d.ts +85 -0
  74. package/dist/_types/orchestrator/evidenceBranch.d.ts +291 -0
  75. package/dist/_types/orchestrator/expected-inference-response.d.ts +55 -0
  76. package/dist/_types/orchestrator/expectedOutcomeContract.d.ts +58 -0
  77. package/dist/_types/orchestrator/failure-taxonomy.d.ts +36 -0
  78. package/dist/_types/orchestrator/focusSupervisor.d.ts +436 -0
  79. package/dist/_types/orchestrator/forced-update-requirement-recovery.d.ts +105 -0
  80. package/dist/_types/orchestrator/hooks.d.ts +100 -0
  81. package/dist/_types/orchestrator/inference-pressure.d.ts +61 -0
  82. package/dist/_types/orchestrator/integrationClosure.d.ts +89 -0
  83. package/dist/_types/orchestrator/interruption-lifecycle.d.ts +154 -0
  84. package/dist/_types/orchestrator/live-memory-passages.d.ts +51 -0
  85. package/dist/_types/orchestrator/liveVirtualContext.d.ts +84 -0
  86. package/dist/_types/orchestrator/memory-compiler.d.ts +254 -0
  87. package/dist/_types/orchestrator/memory-consolidation.d.ts +134 -0
  88. package/dist/_types/orchestrator/model-router.d.ts +17 -0
  89. package/dist/_types/orchestrator/modelResponseDiagnostics.d.ts +71 -0
  90. package/dist/_types/orchestrator/nativeRequirementAmendment.d.ts +63 -0
  91. package/dist/_types/orchestrator/nol/coordinator.d.ts +204 -0
  92. package/dist/_types/orchestrator/nol/datasets.d.ts +58 -0
  93. package/dist/_types/orchestrator/nol/discovery.d.ts +286 -0
  94. package/dist/_types/orchestrator/nol/evaluation.d.ts +59 -0
  95. package/dist/_types/orchestrator/nol/model-validation.d.ts +198 -0
  96. package/dist/_types/orchestrator/nol/statistics.d.ts +142 -0
  97. package/dist/_types/orchestrator/nol/store.d.ts +133 -0
  98. package/dist/_types/orchestrator/nol/variant-registry.d.ts +292 -0
  99. package/dist/_types/orchestrator/ollama-context-policy.d.ts +26 -0
  100. package/dist/_types/orchestrator/personality.d.ts +66 -0
  101. package/dist/_types/orchestrator/prompt-cache.d.ts +24 -0
  102. package/dist/_types/orchestrator/remote-inference-fallback.d.ts +224 -0
  103. package/dist/_types/orchestrator/remote-inference-policy.d.ts +58 -0
  104. package/dist/_types/orchestrator/request-budget.d.ts +75 -0
  105. package/dist/_types/orchestrator/requirementCoverage.d.ts +69 -0
  106. package/dist/_types/orchestrator/reviewedInterpretation.d.ts +111 -0
  107. package/dist/_types/orchestrator/runEvents.d.ts +115 -0
  108. package/dist/_types/orchestrator/runtime-rollout.d.ts +63 -0
  109. package/dist/_types/orchestrator/semanticVerification.d.ts +135 -0
  110. package/dist/_types/orchestrator/source-wide-extraction.d.ts +202 -0
  111. package/dist/_types/orchestrator/steeringIntake.d.ts +123 -0
  112. package/dist/_types/orchestrator/structured-memory-extraction-worker.d.ts +89 -0
  113. package/dist/_types/orchestrator/structuredMemoryInference.d.ts +62 -0
  114. package/dist/_types/orchestrator/successful-procedure-memory.d.ts +127 -0
  115. package/dist/_types/orchestrator/supportedAnswer.d.ts +68 -0
  116. package/dist/_types/orchestrator/taskEffectEvidence.d.ts +38 -0
  117. package/dist/_types/orchestrator/taskExecutionSnapshot.d.ts +67 -0
  118. package/dist/_types/orchestrator/taskObjective.d.ts +310 -0
  119. package/dist/_types/orchestrator/taskObjectiveContinuation.d.ts +134 -0
  120. package/dist/_types/orchestrator/taskRequirementReview.d.ts +246 -0
  121. package/dist/_types/orchestrator/taskRequirements.d.ts +80 -0
  122. package/dist/_types/orchestrator/taskSemanticAdmission.d.ts +159 -0
  123. package/dist/_types/orchestrator/taskWorkDelegation.d.ts +147 -0
  124. package/dist/_types/orchestrator/taskWorkPlan.d.ts +177 -0
  125. package/dist/_types/orchestrator/telegram-passive-history.d.ts +42 -0
  126. package/dist/_types/orchestrator/terminalTaskReport.d.ts +91 -0
  127. package/dist/_types/orchestrator/todoObservability.d.ts +147 -0
  128. package/dist/_types/orchestrator/tool-exposure-policy.d.ts +100 -0
  129. package/dist/_types/orchestrator/trajectory-checkpoint.d.ts +159 -0
  130. package/dist/_types/orchestrator/types.d.ts +185 -0
  131. package/dist/_types/schemas/dispatch.d.ts +53 -0
  132. package/dist/_types/schemas/feature-workflow.d.ts +362 -0
  133. package/dist/_types/schemas/messages.d.ts +15 -0
  134. package/dist/_types/schemas/nol-assets.d.ts +955 -0
  135. package/dist/_types/schemas/nol-json.d.ts +2 -0
  136. package/dist/_types/schemas/nol.d.ts +3995 -0
  137. package/dist/_types/schemas/patch.d.ts +47 -0
  138. package/dist/_types/schemas/plan.d.ts +47 -0
  139. package/dist/_types/schemas/repoProfile.d.ts +116 -0
  140. package/dist/_types/schemas/retrieval.d.ts +44 -0
  141. package/dist/_types/schemas/task.d.ts +57 -0
  142. package/dist/_types/schemas/tools.d.ts +16 -0
  143. package/dist/_types/schemas/verification.d.ts +31 -0
  144. package/dist/api/py-embed.js +3353 -1829
  145. package/dist/assets/nol-checkpoint-editor.py +701 -0
  146. package/dist/assets/nol-gguf-checkpoint-editor.py +785 -0
  147. package/dist/assets/nol-gguf-control-reader.py +428 -0
  148. package/dist/assets/nol-gne-tools-worker.py +425 -0
  149. package/dist/assets/nol-gne-worker.py +1081 -0
  150. package/dist/assets/nol-lora-exporter.py +349 -0
  151. package/dist/assets/nol-pytorch-control-reader.py +470 -0
  152. package/dist/assets/nol-transformers-nnsight-worker.py +512 -0
  153. package/dist/assets/nol-transformers-peft-validation-worker.py +385 -0
  154. package/dist/assets/nol-transformers-peft-worker.py +488 -0
  155. package/dist/assets/nol-transformers-research-worker.py +472 -0
  156. package/dist/assets/nol-transformers-worker.py +920 -0
  157. package/dist/assets/nol-vllm-owned-worker.py +803 -0
  158. package/dist/assets/nol-vllm-runtime.py +695 -0
  159. package/dist/assets/nol-vllm-tokenizer.py +93 -0
  160. package/dist/assets/nol-vllm-worker.py +201 -0
  161. package/dist/computer-use/configured-planner.d.ts +37 -0
  162. package/dist/computer-use/configured-point.d.ts +35 -0
  163. package/dist/computer-use/host-session.d.ts +60 -0
  164. package/dist/computer-use/runner-ui-port.d.ts +37 -0
  165. package/dist/computer-use/session-review.d.ts +14 -0
  166. package/dist/computer-use/task-spec.d.ts +84 -0
  167. package/dist/discovery.d.ts +16 -2
  168. package/dist/index.js +2 -2
  169. package/dist/library.d.ts +94 -10
  170. package/dist/library.js +137700 -81150
  171. package/dist/memory-maintenance-worker.js +1676 -511
  172. package/dist/nol/cpu-control-reader-profile.d.ts +93 -0
  173. package/dist/nol/cpu-control-reader-service.d.ts +87 -0
  174. package/dist/nol/cuda-lease.d.ts +111 -0
  175. package/dist/nol/cuda-mutations.d.ts +34 -0
  176. package/dist/nol/export-runtime-config.d.ts +114 -0
  177. package/dist/nol/export-service.d.ts +143 -0
  178. package/dist/nol/facade.d.ts +147 -0
  179. package/dist/nol/gguf-cpu-control-reader-profile.d.ts +106 -0
  180. package/dist/nol/gguf-cpu-control-reader-service.d.ts +91 -0
  181. package/dist/nol/gguf-model-control-verifier.d.ts +120 -0
  182. package/dist/nol/gguf-parameter-inventory.d.ts +28 -0
  183. package/dist/nol/gne-adapter.d.ts +134 -0
  184. package/dist/nol/gne-agent-evaluation.d.ts +84 -0
  185. package/dist/nol/gne-profile.d.ts +124 -0
  186. package/dist/nol/gne-tools-profile.d.ts +148 -0
  187. package/dist/nol/gne-tools-transport.d.ts +194 -0
  188. package/dist/nol/model-actions.d.ts +662 -0
  189. package/dist/nol/model-control-verifier.d.ts +135 -0
  190. package/dist/nol/model-json-scorer.d.ts +13 -0
  191. package/dist/nol/model-runtime-config.d.ts +830 -0
  192. package/dist/nol/model-serving.d.ts +130 -0
  193. package/dist/nol/model-subject-adapter.d.ts +72 -0
  194. package/dist/nol/model-validation-factory.d.ts +113 -0
  195. package/dist/nol/neuronary-catalog.d.ts +130 -0
  196. package/dist/nol/orphan-custody.d.ts +72 -0
  197. package/dist/nol/peft-conformance.d.ts +48 -0
  198. package/dist/nol/peft-control-types.d.ts +137 -0
  199. package/dist/nol/peft-control-verifier.d.ts +8 -0
  200. package/dist/nol/peft-model-actions.d.ts +41 -0
  201. package/dist/nol/peft-model-authority.d.ts +146 -0
  202. package/dist/nol/peft-model-controls.d.ts +20 -0
  203. package/dist/nol/peft-model-host.d.ts +47 -0
  204. package/dist/nol/peft-model-profile.d.ts +161 -0
  205. package/dist/nol/peft-model-runtime-config.d.ts +174 -0
  206. package/dist/nol/peft-model-subject-adapter.d.ts +36 -0
  207. package/dist/nol/peft-validation.d.ts +105 -0
  208. package/dist/nol/persistent-parameter-inventory.d.ts +32 -0
  209. package/dist/nol/runtime.d.ts +100 -0
  210. package/dist/nol/sqlite-store.d.ts +80 -0
  211. package/dist/nol/transformers-adapter.d.ts +119 -0
  212. package/dist/nol/transformers-nnsight.d.ts +87 -0
  213. package/dist/nol/transformers-peft.d.ts +107 -0
  214. package/dist/nol/transformers-research.d.ts +114 -0
  215. package/dist/nol/variant-service.d.ts +143 -0
  216. package/dist/nol/variant-store.d.ts +51 -0
  217. package/dist/nol/vllm-actions.d.ts +774 -0
  218. package/dist/nol/vllm-adapter.d.ts +1473 -0
  219. package/dist/nol/vllm-authority.d.ts +55 -0
  220. package/dist/nol/vllm-conformance.d.ts +662 -0
  221. package/dist/nol/vllm-profile.d.ts +850 -0
  222. package/dist/nol/vllm-protocol.d.ts +1505 -0
  223. package/dist/nol/vllm-runtime-config.d.ts +120 -0
  224. package/dist/nol/vllm-runtime.d.ts +34 -0
  225. package/dist/nol/vllm-startup.d.ts +235 -0
  226. package/dist/omni-setup-worker.js +3433 -1909
  227. package/dist/service-version.d.ts +0 -1
  228. package/dist/tui/async-process.d.ts +27 -0
  229. package/dist/tui/native/worker.js +3 -1
  230. package/dist/tui/telegram-action-session-registry.d.ts +136 -0
  231. package/dist/tui/telegram-cognition-queue.d.ts +154 -0
  232. package/dist/tui/telegram-context-packet-v2.d.ts +99 -0
  233. package/dist/tui/telegram-input-ownership.d.ts +78 -0
  234. package/dist/tui/telegram-turn-contract-v2.d.ts +62 -0
  235. package/dist/update-worker-runtime.js +4216 -2603
  236. package/docs/DISCOVERY.json +462 -0
  237. package/docs/DISCOVERY.md +6 -0
  238. package/docs/work-orders/evidence/telegram-catch-up-attention-live-20261104.json +743 -0
  239. package/docs/work-orders/telegram-catch-up-attention-repair-20261104.md +133 -0
  240. package/npm-shrinkwrap.json +28 -12
  241. package/package.json +3 -2
@@ -0,0 +1,194 @@
1
+ import { type NolArtifactRef, type NolModelManifest, type NolRecipeRevision } from "../../schemas/nol.js";
2
+ import type { NolCheckpointEditLimits } from "./checkpoint-edits.js";
3
+ /** These cumulative reservations bound explicit arrays/work, not total process
4
+ * RSS, Python/NumPy/BLAS overhead or the OS's file cache. */
5
+ export interface NolGgufEditLimits extends NolCheckpointEditLimits {
6
+ maxMetadataBytes: number;
7
+ maxTensors: number;
8
+ maxKeyValues: number;
9
+ maxArrayElements: number;
10
+ }
11
+ export interface NolGgufEditorRuntime {
12
+ schema: "omnius.nol.gguf-editor-runtime.v1";
13
+ runtimeDigest: string;
14
+ pythonVersion: string;
15
+ pythonExecutable: {
16
+ sha256: string;
17
+ sizeBytes: number;
18
+ };
19
+ packages: Array<{
20
+ name: string;
21
+ version: string;
22
+ files: Array<{
23
+ path: string;
24
+ sha256: string;
25
+ sizeBytes: number;
26
+ }>;
27
+ }>;
28
+ dependencyLock: {
29
+ sha256: string;
30
+ sizeBytes: number;
31
+ };
32
+ }
33
+ export interface NolGgufInventory {
34
+ schema: "omnius.nol.gguf-inventory.v1";
35
+ checkpoint: {
36
+ sha256: string;
37
+ sizeBytes: number;
38
+ };
39
+ version: 3;
40
+ alignment: number;
41
+ metadataSha256: string;
42
+ tensors: Array<{
43
+ name: string;
44
+ shape: number[];
45
+ qtype: string;
46
+ sizeBytes: number;
47
+ dataOffset: number;
48
+ }>;
49
+ officialReaderVerified: true;
50
+ modelLoaded: false;
51
+ cudaUsed: false;
52
+ runtimeDigest: string;
53
+ }
54
+ export interface NolGgufEditorHost {
55
+ pythonPath: string;
56
+ editorPath: string;
57
+ expectedEditorSha256: string;
58
+ dependencyLockPath: string;
59
+ limits: NolGgufEditLimits;
60
+ signal?: AbortSignal;
61
+ }
62
+ export interface NolGgufEncodingPolicy {
63
+ target: "f16" | "q8_0";
64
+ maxAbsError: number;
65
+ maxRelativeL2Error: number;
66
+ }
67
+ export interface NolGgufEditInput extends NolGgufEditorHost {
68
+ /** Trusted host hook only, never parsed from a request/recipe. Invoked after
69
+ * the child close promise settles and before its unpublished stage is removed.
70
+ * The owner must pre-reserve any durable diagnostic publication allowance. */
71
+ onFailureDiagnostic?: (diagnostic: NolGgufProcessFailureDiagnostic) => Promise<void>;
72
+ runtime: NolGgufEditorRuntime;
73
+ model: NolModelManifest;
74
+ recipe: NolRecipeRevision;
75
+ checkpointRoot: string;
76
+ sourceCheckpoints?: ReadonlyArray<{
77
+ model: NolModelManifest;
78
+ root: string;
79
+ }>;
80
+ artifactRoot: string;
81
+ outputDirectory: string;
82
+ orthogonalityTolerance: number;
83
+ encoding: NolGgufEncodingPolicy;
84
+ }
85
+ export interface NolGgufProcessFailureDiagnostic {
86
+ schema: "omnius.nol.gguf-process-failure.v1";
87
+ message: string;
88
+ exitCode: number | null;
89
+ signal: NodeJS.Signals | null;
90
+ captureLimitBytes: number;
91
+ stageCleanupPending: true;
92
+ childCloseAwaited: true;
93
+ streamCompleteness: "process_capture" | "unknown_beyond_process_capture_limit";
94
+ stdout: {
95
+ base64: string;
96
+ availableBytes: number;
97
+ retainedBytes: number;
98
+ availableSha256: string;
99
+ truncatedFromAvailable: boolean;
100
+ };
101
+ stderr: {
102
+ base64: string;
103
+ availableBytes: number;
104
+ retainedBytes: number;
105
+ availableSha256: string;
106
+ truncatedFromAvailable: boolean;
107
+ };
108
+ }
109
+ export interface NolGgufEditReceipt {
110
+ schema: "omnius.nol.gguf-checkpoint-edit.v1";
111
+ exportId: string;
112
+ editorSha256: string;
113
+ runtimePath: string;
114
+ runtimeArtifact: NolArtifactRef;
115
+ parentModelDigest: string;
116
+ recipeDigest: string;
117
+ sourceModelDigests: string[];
118
+ runtimeDigest: string;
119
+ numericalPolicy: string;
120
+ equivalence: "approximate_transfer_needs_native_validation";
121
+ neutralPolicy: string;
122
+ allNeutral: boolean;
123
+ encoding: NolGgufEncodingPolicy;
124
+ operations: Array<{
125
+ operationId: string;
126
+ operation: string;
127
+ siteId: string;
128
+ name: string;
129
+ operatorOrder: number;
130
+ evaluationOrder: number;
131
+ changedReferenceElements: number;
132
+ beforeReferenceSha256: string;
133
+ afterReferenceSha256: string;
134
+ referencePrecision: "float64";
135
+ storageEncodePerformed: false;
136
+ }>;
137
+ tensors: Array<{
138
+ name: string;
139
+ from: string;
140
+ to: string;
141
+ neutral: boolean;
142
+ beforeTensorSha256: string;
143
+ afterTensorSha256: string;
144
+ maxAbsError: number;
145
+ relativeL2Error: number;
146
+ }>;
147
+ unchangedTensors: Array<{
148
+ name: string;
149
+ sha256: string;
150
+ }>;
151
+ metadataSha256: string;
152
+ officialReaderVerified: true;
153
+ files: Array<{
154
+ path: string;
155
+ role: string;
156
+ before: {
157
+ sha256: string;
158
+ sizeBytes: number;
159
+ };
160
+ after: {
161
+ sha256: string;
162
+ sizeBytes: number;
163
+ };
164
+ }>;
165
+ inferencePerformed: false;
166
+ cudaUsed: false;
167
+ nativeRuntimeImported: false;
168
+ usage: {
169
+ inputBytes: number;
170
+ artifactBytes: number;
171
+ outputBytes: number;
172
+ reservedWorkingBytes: number;
173
+ arithmeticUnits: number;
174
+ durationMs: number;
175
+ };
176
+ }
177
+ /** CPU package inspection only; no GNE/Torch/native model runtime imports. */
178
+ export declare function inspectNolGgufRuntime(input: NolGgufEditorHost): Promise<NolGgufEditorRuntime>;
179
+ /** Full-file identity and bounded format geometry using both independent
180
+ * admission scanner and official gguf0.19 reader. No tensor dequantization. */
181
+ export declare function inspectNolGgufCheckpoint(input: NolGgufEditorHost & {
182
+ checkpointPath: string;
183
+ runtime: NolGgufEditorRuntime;
184
+ }): Promise<NolGgufInventory>;
185
+ /** Inert offline export, never runtime registration/promotion. All actual
186
+ * changes are approximate transfers until separately validated by native gates.
187
+ * Local output refs must be imported into the host quota-managed CAS by caller. */
188
+ export declare function editNolGgufCheckpoint(input: NolGgufEditInput): Promise<{
189
+ outputDirectory: string;
190
+ model: NolModelManifest;
191
+ receipt: NolGgufEditReceipt;
192
+ receiptArtifact: NolArtifactRef;
193
+ receiptPath: string;
194
+ }>;
@@ -0,0 +1,224 @@
1
+ import { z } from "zod";
2
+ import { type NolModelManifest } from "../../schemas/nol.js";
3
+ export declare const NOL_GGUF_CONTROL_EDITOR_SHA256 = "fecf1d3ccb4b4d3964d15ae98b1da231e3eabb0aa5d3395f334cc6df24f9ea78";
4
+ /** Working bytes reserve explicit metadata/payload buffers. Python's separate
5
+ * address-space cap includes interpreter/codec overhead; this is not a cap on
6
+ * the embedding Node process or chunks retained by an external consumer. */
7
+ export declare const NolGgufControlReaderLimitsSchema: z.ZodObject<{
8
+ maxInputBytes: z.ZodNumber;
9
+ maxWorkingBytes: z.ZodNumber;
10
+ maxReadBytes: z.ZodNumber;
11
+ maxTensors: z.ZodNumber;
12
+ maxCoordinates: z.ZodNumber;
13
+ maxMetadataBytes: z.ZodNumber;
14
+ maxKeyValues: z.ZodNumber;
15
+ maxArrayElements: z.ZodNumber;
16
+ maxDecodedCoordinates: z.ZodNumber;
17
+ maxDecodeArithmeticUnits: z.ZodNumber;
18
+ maxRuntimeBytes: z.ZodNumber;
19
+ maxRuntimeFiles: z.ZodNumber;
20
+ maxDurationMs: z.ZodNumber;
21
+ maxProtocolBytes: z.ZodNumber;
22
+ maxStderrBytes: z.ZodNumber;
23
+ chunkBytes: z.ZodNumber;
24
+ maxReportBytes: z.ZodNumber;
25
+ maxAddressSpaceBytes: z.ZodNumber;
26
+ }, z.core.$strict>;
27
+ export type NolGgufControlReaderLimits = z.infer<typeof NolGgufControlReaderLimitsSchema>;
28
+ declare const runtimeSchema: z.ZodObject<{
29
+ schema: z.ZodLiteral<"omnius.nol.gguf-control-reader-runtime.v1">;
30
+ pythonVersion: z.ZodString;
31
+ pythonExecutable: z.ZodObject<{
32
+ sha256: z.ZodString;
33
+ sizeBytes: z.ZodNumber;
34
+ }, z.core.$strict>;
35
+ packages: z.ZodArray<z.ZodObject<{
36
+ name: z.ZodString;
37
+ version: z.ZodString;
38
+ files: z.ZodNumber;
39
+ bytes: z.ZodNumber;
40
+ digest: z.ZodString;
41
+ }, z.core.$strict>>;
42
+ reader: z.ZodObject<{
43
+ sha256: z.ZodString;
44
+ sizeBytes: z.ZodNumber;
45
+ }, z.core.$strict>;
46
+ checkpointEditor: z.ZodObject<{
47
+ sha256: z.ZodString;
48
+ sizeBytes: z.ZodNumber;
49
+ }, z.core.$strict>;
50
+ dependencyLock: z.ZodObject<{
51
+ sha256: z.ZodString;
52
+ sizeBytes: z.ZodNumber;
53
+ }, z.core.$strict>;
54
+ pythonEnvironment: z.ZodObject<{
55
+ policy: z.ZodLiteral<"isolated_no_site_processing">;
56
+ venvConfig: z.ZodObject<{
57
+ sha256: z.ZodString;
58
+ sizeBytes: z.ZodNumber;
59
+ }, z.core.$strict>;
60
+ sitePackagesPathDigest: z.ZodString;
61
+ }, z.core.$strict>;
62
+ runtimeDigest: z.ZodString;
63
+ }, z.core.$strict>;
64
+ export type NolGgufControlReaderRuntime = z.infer<typeof runtimeSchema>;
65
+ export declare const NOL_GGUF_CONTROL_BLOCKS: {
66
+ readonly F32: {
67
+ readonly typeId: 0;
68
+ readonly elements: 1;
69
+ readonly bytes: 4;
70
+ };
71
+ readonly F16: {
72
+ readonly typeId: 1;
73
+ readonly elements: 1;
74
+ readonly bytes: 2;
75
+ };
76
+ readonly BF16: {
77
+ readonly typeId: 30;
78
+ readonly elements: 1;
79
+ readonly bytes: 2;
80
+ };
81
+ readonly Q8_0: {
82
+ readonly typeId: 8;
83
+ readonly elements: 32;
84
+ readonly bytes: 34;
85
+ };
86
+ readonly Q4_0: {
87
+ readonly typeId: 2;
88
+ readonly elements: 32;
89
+ readonly bytes: 18;
90
+ };
91
+ readonly Q4_K: {
92
+ readonly typeId: 12;
93
+ readonly elements: 256;
94
+ readonly bytes: 144;
95
+ };
96
+ readonly Q6_K: {
97
+ readonly typeId: 14;
98
+ readonly elements: 256;
99
+ readonly bytes: 210;
100
+ };
101
+ };
102
+ export type NolGgufControlQtype = keyof typeof NOL_GGUF_CONTROL_BLOCKS;
103
+ export declare const NolGgufControlInventorySchema: z.ZodObject<{
104
+ schema: z.ZodLiteral<"omnius.nol.gguf-control-inventory.v1">;
105
+ modelDigest: z.ZodString;
106
+ runtimeDigest: z.ZodString;
107
+ readerSha256: z.ZodString;
108
+ checkpointEditorSha256: z.ZodLiteral<"fecf1d3ccb4b4d3964d15ae98b1da231e3eabb0aa5d3395f334cc6df24f9ea78">;
109
+ files: z.ZodArray<z.ZodObject<{
110
+ path: z.ZodString;
111
+ role: z.ZodEnum<{
112
+ other: "other";
113
+ tokenizer: "tokenizer";
114
+ weights: "weights";
115
+ config: "config";
116
+ chat_template: "chat_template";
117
+ adapter: "adapter";
118
+ }>;
119
+ sha256: z.ZodString;
120
+ sizeBytes: z.ZodNumber;
121
+ }, z.core.$strict>>;
122
+ tensors: z.ZodArray<z.ZodObject<{
123
+ name: z.ZodString;
124
+ shape: z.ZodArray<z.ZodNumber>;
125
+ ggmlDimensions: z.ZodArray<z.ZodNumber>;
126
+ qtype: z.ZodEnum<{
127
+ F16: "F16";
128
+ F32: "F32";
129
+ BF16: "BF16";
130
+ Q8_0: "Q8_0";
131
+ Q4_0: "Q4_0";
132
+ Q4_K: "Q4_K";
133
+ Q6_K: "Q6_K";
134
+ }>;
135
+ typeId: z.ZodNumber;
136
+ sourceFile: z.ZodString;
137
+ dataOffsetBytes: z.ZodNumber;
138
+ sizeBytes: z.ZodNumber;
139
+ sha256: z.ZodString;
140
+ elements: z.ZodNumber;
141
+ storageClass: z.ZodEnum<{
142
+ ordinary_matrix_storage_only: "ordinary_matrix_storage_only";
143
+ ordinary_vector_storage_only: "ordinary_vector_storage_only";
144
+ ordinary_scalar_storage_only: "ordinary_scalar_storage_only";
145
+ }>;
146
+ block: z.ZodObject<{
147
+ elements: z.ZodNumber;
148
+ bytes: z.ZodNumber;
149
+ rowElements: z.ZodNumber;
150
+ rowBytes: z.ZodNumber;
151
+ blocks: z.ZodNumber;
152
+ }, z.core.$strict>;
153
+ decoding: z.ZodEnum<{
154
+ independent_host_supported: "independent_host_supported";
155
+ opaque_only: "opaque_only";
156
+ }>;
157
+ }, z.core.$strict>>;
158
+ version: z.ZodLiteral<3>;
159
+ alignment: z.ZodNumber;
160
+ dataStartBytes: z.ZodNumber;
161
+ metadataSha256: z.ZodString;
162
+ usage: z.ZodObject<{
163
+ inputBytes: z.ZodNumber;
164
+ logicalReadBytes: z.ZodNumber;
165
+ reservedWorkingBytes: z.ZodNumber;
166
+ }, z.core.$strict>;
167
+ officialReaderVerified: z.ZodLiteral<true>;
168
+ codecsImportedAfterFullRuntimeAdmission: z.ZodLiteral<true>;
169
+ device: z.ZodLiteral<"cpu">;
170
+ cudaInitialized: z.ZodLiteral<false>;
171
+ modelConstructed: z.ZodLiteral<false>;
172
+ numericalControlVerified: z.ZodLiteral<false>;
173
+ authority: z.ZodLiteral<"none">;
174
+ }, z.core.$strict>;
175
+ export type NolGgufControlInventory = z.infer<typeof NolGgufControlInventorySchema>;
176
+ export interface NolGgufControlReaderHost {
177
+ pythonPath: string;
178
+ readerPath: string;
179
+ expectedReaderSha256: string;
180
+ checkpointEditorPath: string;
181
+ expectedCheckpointEditorSha256: typeof NOL_GGUF_CONTROL_EDITOR_SHA256;
182
+ dependencyLockPath: string;
183
+ /** A private host-owned directory; each call retains a fresh private child. */
184
+ reportRoot: string;
185
+ limits: NolGgufControlReaderLimits;
186
+ }
187
+ export interface NolGgufControlInventoryHandle {
188
+ readonly inventory: Readonly<NolGgufControlInventory>;
189
+ readonly reportPath: string;
190
+ /** Detect source mutation before accepting results from these byte ranges. */
191
+ assertCurrent(): void;
192
+ /** Must be applied to actual candidate-derived changed names. This method
193
+ * does not accept a serialized claim that aliased edits are safe. */
194
+ assertNoChangedAliases(names: Iterable<string>): void;
195
+ /** Raw chunks contain complete storage blocks. Caller-retained chunks are
196
+ * outside the reader-owned workspace budget. Consume to completion and call
197
+ * assertCurrent before accepting any derived comparison. */
198
+ streamTensor(name: string, signal?: AbortSignal): AsyncGenerator<Uint8Array>;
199
+ streamDecodedTensor(name: string, signal?: AbortSignal): AsyncGenerator<Float64Array>;
200
+ close(): Promise<void>;
201
+ }
202
+ export declare class NolGgufControlReaderError extends Error {
203
+ readonly reportDirectory: string;
204
+ readonly processSettled: boolean;
205
+ constructor(message: string, reportDirectory: string, processSettled: boolean, options?: ErrorOptions);
206
+ }
207
+ /** Full-source/runtime inspection only. This explicit CPU action never imports
208
+ * NumPy/GGUF/Torch, tokenizes, constructs a model, installs a package, or touches CUDA. */
209
+ export declare function inspectNolGgufControlReaderRuntime(input: NolGgufControlReaderHost, signal?: AbortSignal): Promise<{
210
+ runtime: NolGgufControlReaderRuntime;
211
+ reportPath: string;
212
+ }>;
213
+ /** Independent wire decoder. At most 4MiB raw input/32MiB F64 output per call.
214
+ * Q8_0 is exactly FP16 scale followed by32 signed int8 values per block. This
215
+ * function establishes no changed-block/control-norm or native conformance. */
216
+ export declare function decodeNolGgufControlBlocks(qtype: NolGgufControlQtype, raw: Uint8Array): Float64Array;
217
+ export declare function openNolGgufControlInventory(input: {
218
+ host: NolGgufControlReaderHost;
219
+ runtime: NolGgufControlReaderRuntime;
220
+ model: NolModelManifest;
221
+ checkpointRoot: string;
222
+ signal?: AbortSignal;
223
+ }): Promise<NolGgufControlInventoryHandle>;
224
+ export {};
@@ -0,0 +1,129 @@
1
+ import { type NolArtifactRef, type NolModelManifest, type NolOperation, type NolRecipeRevision, type NolRuntimeBinding } from "../../schemas/nol.js";
2
+ import type { NolCheckpointEditLimits } from "./checkpoint-edits.js";
3
+ /** These are exact caller declarations, not an offline proof of native module
4
+ * type. Checkpoint geometry is independently verified; the declared serving
5
+ * runtime/module mapping still requires native adapter validation. */
6
+ export interface NolLoraLinearBinding {
7
+ siteId: string;
8
+ modulePath: string;
9
+ moduleType: "torch.nn.Linear";
10
+ layout: "out_in";
11
+ }
12
+ export interface NolLoraExportLimits extends NolCheckpointEditLimits {
13
+ /** Exact uncompressed algebraic rank ceiling; no SVD or truncation. */
14
+ maxRank: number;
15
+ maxModules: number;
16
+ }
17
+ export interface NolLoraBaseModel {
18
+ nameOrPath: string;
19
+ /** Immutable upstream commit, in addition to full NOL checkpoint digests. */
20
+ revision: string;
21
+ taskType: "CAUSAL_LM" | "SEQ_2_SEQ_LM" | "FEATURE_EXTRACTION" | "SEQ_CLS" | "TOKEN_CLS" | "QUESTION_ANS";
22
+ }
23
+ export interface NolLoraExportInput {
24
+ pythonPath: string;
25
+ exporterPath: string;
26
+ expectedExporterSha256: string;
27
+ /** Reuses the separately pinned bounded full-file/ZIP/safetensors reader. */
28
+ checkpointEditorPath: string;
29
+ expectedCheckpointEditorSha256: string;
30
+ model: NolModelManifest;
31
+ recipe: NolRecipeRevision;
32
+ /** Intended native serving identity; no runtime validation is performed. */
33
+ binding: NolRuntimeBinding;
34
+ moduleBindings: ReadonlyArray<NolLoraLinearBinding>;
35
+ baseModel: NolLoraBaseModel;
36
+ checkpointRoot: string;
37
+ artifactRoot: string;
38
+ outputDirectory: string;
39
+ limits: NolLoraExportLimits;
40
+ signal?: AbortSignal;
41
+ }
42
+ export interface NolLoraExportReceipt {
43
+ schema: "omnius.nol.lora-export.v1";
44
+ exportId: string;
45
+ parentModelDigest: string;
46
+ architectureMapDigest: string;
47
+ recipeDigest: string;
48
+ parentModelDigests: string[];
49
+ binding: NolRuntimeBinding;
50
+ bindingDigest: string;
51
+ baseModel: NolLoraBaseModel;
52
+ modelFiles: NolModelManifest["files"];
53
+ operations: NolOperation[];
54
+ operands: NolArtifactRef[];
55
+ exporterSha256: string;
56
+ checkpointEditorSha256: string;
57
+ runtime: {
58
+ python: string;
59
+ torch: string;
60
+ safetensors: string;
61
+ };
62
+ moduleBindingProof: "caller_declared_linear_modules_actual_checkpoint_parameter_geometry_verified";
63
+ numericalPolicy: string;
64
+ nativeEquivalence: "required_unvalidated";
65
+ inferencePerformed: false;
66
+ cudaUsed: false;
67
+ modules: Array<NolLoraLinearBinding & {
68
+ parameterName: string;
69
+ shape: number[];
70
+ sourceDtype: string;
71
+ sourceTensorSha256: string;
72
+ operationIds: string[];
73
+ effectiveRank: number;
74
+ serializedRank: number;
75
+ alpha: number;
76
+ scaling: 1;
77
+ storageDtype: "f32";
78
+ maxFactorAbsCastError: {
79
+ a: number;
80
+ b: number;
81
+ };
82
+ /** Dense CPU F64 reconstruction from ideal versus serialized factors;
83
+ * excludes native serving kernel and per-operation rounding differences. */
84
+ maxAbsDeltaFactorCastError: number;
85
+ maxAbsTargetDtypeCastError: number;
86
+ factorSha256: {
87
+ a: string;
88
+ b: string;
89
+ };
90
+ }>;
91
+ files: Array<{
92
+ path: string;
93
+ sha256: string;
94
+ sizeBytes: number;
95
+ }>;
96
+ usage: {
97
+ inputBytes: number;
98
+ artifactBytes: number;
99
+ outputBytes: number;
100
+ reservedWorkingBytes: number;
101
+ arithmeticUnits: number;
102
+ durationMs: number;
103
+ };
104
+ }
105
+ /** Serialize exact-rank ideal parameter deltas to standard PEFT F32 factors.
106
+ * Supported: sparse WEIGHT_GAIN axis1 and LOW_RANK_UPDATE on explicitly bound
107
+ * linear [out,in] parameters, all computation positions. Scalar identity gain
108
+ * is allowed. All other operation/scope/layout classes fail closed.
109
+ *
110
+ * The recipe MUST acknowledge approximate lowering: F64 ordered factor algebra
111
+ * followed by F32 storage does not reproduce checkpoint per-operation dtype
112
+ * rounding or prove a native model's adapter execution equivalence. This API
113
+ * emits no validation/promotion/serving authority, constructs no model and uses
114
+ * no CUDA. Its returned artifact references identify local files, not CAS writes.
115
+ * Import and constructor-free API definition perform no I/O. Publication is an
116
+ * immutable Linux no-replace directory commit, with no unsafe rename fallback. */
117
+ export declare function exportNolLora(input: NolLoraExportInput): Promise<{
118
+ outputDirectory: string;
119
+ /** Serialized adapter only, with actual A/B parameter inventory. It is not
120
+ * the combined base+adapter model or a native serving validation record. */
121
+ adapterModel: NolModelManifest;
122
+ receipt: NolLoraExportReceipt;
123
+ receiptPath: string;
124
+ receiptArtifact: NolArtifactRef;
125
+ files: Array<{
126
+ path: string;
127
+ artifact: NolArtifactRef;
128
+ }>;
129
+ }>;