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,212 @@
1
+ import { type NolArtifactRef, type NolCalibration, type NolModelManifest, type NolRecipeRevision } from "../../schemas/nol.js";
2
+ export declare const NOL_NEURONARY_API = "https://mcczbdcymyhzfputyqcr.supabase.co/functions/v1/api";
3
+ export declare const NOL_NEURONARY_PROFILE: Readonly<{
4
+ schema: "omnius.nol.neuronary-api-profile.v1";
5
+ upstreamRevision: "4c9fc98c0bf2d56798a77ad88ffcdf607aba4d7b";
6
+ sourceFileSchemaDigest: "86dcb54853ee184306062b7427cbc5c91b0da32420158ddda0011df318c21e51";
7
+ site: "mlp.down_proj.input";
8
+ normalization: "layer_residual_median_over_down_column_l2";
9
+ methodDefaults: Readonly<{
10
+ op: "add";
11
+ site: "mlp.down_proj.input";
12
+ apply_to: "all_tokens";
13
+ normalization: "layer_residual_median_over_down_column_l2";
14
+ }>;
15
+ formula: "dose * median(layer_residual_l2) / down_column_l2";
16
+ residualStatistic: "Median L2 norm of the residual leaving source layer L";
17
+ downColumn: "L2 norm of actual checkpoint down_proj[:, neuron]";
18
+ executionProjection: Readonly<{
19
+ idMaxLength: 64;
20
+ idPattern: "^[a-z0-9]+(-[a-z0-9]+)*$";
21
+ nameMaxLength: 80;
22
+ maxNeurons: 64;
23
+ minimumDose: -100;
24
+ maximumDose: 100;
25
+ }>;
26
+ calibration: "Requires separately attested corpus, token positions, residual statistic and per-neuron column norm; publication name is insufficient.";
27
+ }>;
28
+ export declare const NOL_NEURONARY_PROFILE_DIGEST: string;
29
+ export interface NolNeuronarySnapshot {
30
+ schema: "omnius.nol.neuronary-snapshot.v1";
31
+ apiProfileDigest: string;
32
+ sourceUrl: string;
33
+ retrievedAt: string;
34
+ rawDigest: string;
35
+ sizeBytes: number;
36
+ rawJson: string;
37
+ data: unknown;
38
+ }
39
+ export interface NolNeuronaryNeuron {
40
+ layer: number;
41
+ neuron: number;
42
+ dose: number;
43
+ expert?: number;
44
+ }
45
+ export interface NolNeuronaryRecipe {
46
+ id: string;
47
+ name: string;
48
+ model: string;
49
+ neurons: readonly NolNeuronaryNeuron[];
50
+ method?: Readonly<Record<string, unknown>>;
51
+ conditional?: unknown;
52
+ }
53
+ export interface NolNeuronaryQuery {
54
+ q?: string;
55
+ tag?: string;
56
+ model?: string;
57
+ neuron?: string;
58
+ author?: string;
59
+ sort?: "top" | "new" | "hot";
60
+ limit?: number;
61
+ offset?: number;
62
+ }
63
+ export interface NolNeuronaryRequestOptions {
64
+ signal?: AbortSignal;
65
+ deadlineAtMs?: number;
66
+ }
67
+ export declare function neuronaryRecipeId(reference: string): string;
68
+ /** Offline construction also preserves the exact original UTF-8 body, not a reserialized approximation. */
69
+ export declare function snapshotNeuronaryJson(rawJson: string, sourceUrl: string, retrievedAt: string): NolNeuronarySnapshot;
70
+ export declare function readNeuronaryRecipe(snapshot: NolNeuronarySnapshot): NolNeuronaryRecipe;
71
+ /** GET-only public client. No token, authenticated endpoint, publishing or model execution interface. */
72
+ export declare class NolNeuronaryClient {
73
+ private readonly transport;
74
+ private readonly maxBytes;
75
+ private readonly timeoutMs;
76
+ constructor(options?: {
77
+ fetch?: typeof fetch;
78
+ maxBytes?: number;
79
+ timeoutMs?: number;
80
+ });
81
+ private get;
82
+ getRecipe(reference: string, options?: NolNeuronaryRequestOptions): Promise<NolNeuronarySnapshot>;
83
+ getNeuron(unit: string, model?: string, options?: NolNeuronaryRequestOptions): Promise<NolNeuronarySnapshot>;
84
+ searchRecipes(query?: NolNeuronaryQuery, options?: NolNeuronaryRequestOptions): Promise<{
85
+ snapshot: NolNeuronarySnapshot;
86
+ recipes: readonly NolNeuronaryRecipe[];
87
+ count: number;
88
+ offset: number;
89
+ limit: number;
90
+ nextOffset: number | null;
91
+ }>;
92
+ searchAllRecipes(query: Omit<NolNeuronaryQuery, "offset">, bounds: NolNeuronaryRequestOptions & {
93
+ maxPages: number;
94
+ maxRecipes: number;
95
+ }): Promise<{
96
+ snapshots: NolNeuronarySnapshot[];
97
+ recipes: NolNeuronaryRecipe[];
98
+ truncated: boolean;
99
+ nextOffset: number | null;
100
+ }>;
101
+ }
102
+ export interface NolNeuronaryHostMapping {
103
+ schema: "omnius.nol.neuronary-mapping.v1";
104
+ sourceSnapshotDigest: string;
105
+ sourceModelId: string;
106
+ sourceModelDigest: string;
107
+ targetModelDigest: string;
108
+ architectureMapDigest: string;
109
+ relationship: "exact" | "derived";
110
+ sites: readonly {
111
+ layer: number;
112
+ neuron: number;
113
+ siteId: string;
114
+ calibrationId?: string;
115
+ rawUnitsPerDose?: number;
116
+ }[];
117
+ calibrations: readonly NolCalibration[];
118
+ evidence: NolArtifactRef;
119
+ }
120
+ /** Target-only proof for an explicitly requested experiment. Unknown source
121
+ * checkpoint lineage is represented directly, never filled with a target hash. */
122
+ export interface NolNeuronaryTargetMapping {
123
+ schema: "omnius.nol.neuronary-target-mapping.v1";
124
+ sourceSnapshotDigest: string;
125
+ sourceModelId: string;
126
+ sourceLineage: "unknown";
127
+ targetModelDigest: string;
128
+ architectureMapDigest: string;
129
+ sites: NolNeuronaryHostMapping["sites"];
130
+ calibrations: readonly NolCalibration[];
131
+ evidence: NolArtifactRef;
132
+ }
133
+ /** This callback is a host authority channel, never a field supplied by the remote JSON. */
134
+ export type NolNeuronaryMappingVerifier = (input: {
135
+ mapping: NolNeuronaryHostMapping;
136
+ mappingDigest: string;
137
+ snapshot: NolNeuronarySnapshot;
138
+ model: NolModelManifest;
139
+ }) => {
140
+ verifiedMappingDigest: string;
141
+ evidenceDigest: string;
142
+ } | null;
143
+ export type NolNeuronaryTargetMappingVerifier = (input: {
144
+ mapping: NolNeuronaryTargetMapping;
145
+ mappingDigest: string;
146
+ snapshot: NolNeuronarySnapshot;
147
+ model: NolModelManifest;
148
+ }) => {
149
+ verifiedMappingDigest: string;
150
+ evidenceDigest: string;
151
+ } | null;
152
+ export interface NolNeuronaryCompatibility {
153
+ status: "exact" | "derived-needs-validation" | "unresolved" | "incompatible";
154
+ reasons: string[];
155
+ sourceSnapshotDigest: string;
156
+ targetModelDigest: string;
157
+ mappingDigest?: string;
158
+ activationAuthorized: false;
159
+ }
160
+ export declare function assessNeuronaryCompatibility(input: {
161
+ snapshot: NolNeuronarySnapshot;
162
+ model: NolModelManifest;
163
+ mapping?: NolNeuronaryHostMapping;
164
+ verifyMapping?: NolNeuronaryMappingVerifier;
165
+ }): NolNeuronaryCompatibility;
166
+ /** Produces only a frozen candidate. The host must archive snapshot.rawJson as
167
+ * exact UTF-8 application/json bytes and retain mapping.evidence in its CAS
168
+ * before coordinator submission. Backend review and compute custody remain
169
+ * mandatory; this pure builder does not materialize either provenance proof. */
170
+ export declare function normalizeNeuronaryRecipe(input: Parameters<typeof assessNeuronaryCompatibility>[0] & {
171
+ id: string;
172
+ revision: number;
173
+ createdAt: string;
174
+ purpose?: "reproduction" | "validation_candidate";
175
+ }): {
176
+ recipe: NolRecipeRevision;
177
+ compatibility: NolNeuronaryCompatibility;
178
+ requiresValidation: boolean;
179
+ normalizationLowerings: readonly {
180
+ layer: number;
181
+ neuron: number;
182
+ dose: number;
183
+ rawUnitsPerDose: number;
184
+ rawAmount: number;
185
+ calibrationDigest: string;
186
+ }[];
187
+ };
188
+ export interface NolNeuronaryExperimentalCandidate {
189
+ recipe: NolRecipeRevision;
190
+ compatibility: NolNeuronaryCompatibility & {
191
+ status: "unresolved";
192
+ sourceModelId: string;
193
+ sourceLineage: "unknown";
194
+ targetMappingVerified: true;
195
+ };
196
+ requiresValidation: true;
197
+ normalizationLowerings: ReturnType<typeof normalizeNeuronaryRecipe>["normalizationLowerings"];
198
+ }
199
+ /** Explicit discovery transfer with complete target custody and deliberately
200
+ * unknown published source identity. This is never an exact/derived claim or
201
+ * activation grant. Returned provenance retains full references to the exact
202
+ * raw snapshot and mapping evidence; the host must archive them before submit. */
203
+ export declare function proposeNeuronaryExperiment(input: {
204
+ purpose: "exploratory_transfer";
205
+ snapshot: NolNeuronarySnapshot;
206
+ model: NolModelManifest;
207
+ targetMapping: NolNeuronaryTargetMapping;
208
+ verifyTargetMapping: NolNeuronaryTargetMappingVerifier;
209
+ id: string;
210
+ revision: number;
211
+ createdAt: string;
212
+ }): NolNeuronaryExperimentalCandidate;
@@ -0,0 +1,143 @@
1
+ import { z } from "zod";
2
+ import { type NolModelManifest } from "../../schemas/nol.js";
3
+ export declare const NOL_PYTORCH_CONTROL_EDITOR_SHA256 = "aaee38b90eab4f0526610ad3ceea5e5be54890d1bdc49c57a2cf5d4fe3766570";
4
+ export declare const NolPytorchControlReaderLimitsSchema: z.ZodObject<{
5
+ maxInputBytes: z.ZodNumber;
6
+ maxWorkingBytes: z.ZodNumber;
7
+ maxReadBytes: z.ZodNumber;
8
+ maxTensors: z.ZodNumber;
9
+ maxCoordinates: z.ZodNumber;
10
+ maxRuntimeBytes: z.ZodNumber;
11
+ maxRuntimeFiles: z.ZodNumber;
12
+ maxDurationMs: z.ZodNumber;
13
+ maxProtocolBytes: z.ZodNumber;
14
+ maxStderrBytes: z.ZodNumber;
15
+ chunkBytes: z.ZodNumber;
16
+ maxReportBytes: z.ZodNumber;
17
+ maxAddressSpaceBytes: z.ZodNumber;
18
+ }, z.core.$strict>;
19
+ export type NolPytorchControlReaderLimits = z.infer<typeof NolPytorchControlReaderLimitsSchema>;
20
+ declare const runtimeSchema: z.ZodObject<{
21
+ schema: z.ZodLiteral<"omnius.nol.pytorch-control-reader-runtime.v1">;
22
+ pythonVersion: z.ZodString;
23
+ pythonExecutable: z.ZodObject<{
24
+ sha256: z.ZodString;
25
+ sizeBytes: z.ZodNumber;
26
+ }, z.core.$strict>;
27
+ packages: z.ZodArray<z.ZodObject<{
28
+ name: z.ZodString;
29
+ version: z.ZodString;
30
+ files: z.ZodNumber;
31
+ bytes: z.ZodNumber;
32
+ digest: z.ZodString;
33
+ }, z.core.$strict>>;
34
+ reader: z.ZodObject<{
35
+ sha256: z.ZodString;
36
+ sizeBytes: z.ZodNumber;
37
+ }, z.core.$strict>;
38
+ checkpointEditor: z.ZodObject<{
39
+ sha256: z.ZodString;
40
+ sizeBytes: z.ZodNumber;
41
+ }, z.core.$strict>;
42
+ dependencyLock: z.ZodObject<{
43
+ sha256: z.ZodString;
44
+ sizeBytes: z.ZodNumber;
45
+ }, z.core.$strict>;
46
+ runtimeDigest: z.ZodString;
47
+ }, z.core.$strict>;
48
+ export type NolPytorchControlReaderRuntime = z.infer<typeof runtimeSchema>;
49
+ export declare const NolPytorchControlInventorySchema: z.ZodObject<{
50
+ schema: z.ZodLiteral<"omnius.nol.pytorch-control-inventory.v1">;
51
+ modelDigest: z.ZodString;
52
+ runtimeDigest: z.ZodString;
53
+ readerSha256: z.ZodString;
54
+ checkpointEditorSha256: z.ZodLiteral<"aaee38b90eab4f0526610ad3ceea5e5be54890d1bdc49c57a2cf5d4fe3766570">;
55
+ files: z.ZodArray<z.ZodObject<{
56
+ path: z.ZodString;
57
+ role: z.ZodEnum<{
58
+ other: "other";
59
+ tokenizer: "tokenizer";
60
+ weights: "weights";
61
+ config: "config";
62
+ chat_template: "chat_template";
63
+ adapter: "adapter";
64
+ }>;
65
+ sha256: z.ZodString;
66
+ sizeBytes: z.ZodNumber;
67
+ }, z.core.$strict>>;
68
+ tensors: z.ZodArray<z.ZodObject<{
69
+ name: z.ZodString;
70
+ dtype: z.ZodEnum<{
71
+ F16: "F16";
72
+ F32: "F32";
73
+ BF16: "BF16";
74
+ }>;
75
+ shape: z.ZodArray<z.ZodNumber>;
76
+ sourceFile: z.ZodString;
77
+ storageKey: z.ZodString;
78
+ dataOffsetBytes: z.ZodNumber;
79
+ sizeBytes: z.ZodNumber;
80
+ sha256: z.ZodString;
81
+ elements: z.ZodNumber;
82
+ aliasGroup: z.ZodString;
83
+ }, z.core.$strict>>;
84
+ aliases: z.ZodArray<z.ZodObject<{
85
+ id: z.ZodString;
86
+ tensors: z.ZodArray<z.ZodString>;
87
+ }, z.core.$strict>>;
88
+ usage: z.ZodObject<{
89
+ inputBytes: z.ZodNumber;
90
+ logicalReadBytes: z.ZodNumber;
91
+ reservedWorkingBytes: z.ZodNumber;
92
+ }, z.core.$strict>;
93
+ symbolicAdmissionBeforeTorch: z.ZodLiteral<true>;
94
+ weightsOnly: z.ZodLiteral<true>;
95
+ mmap: z.ZodLiteral<true>;
96
+ device: z.ZodLiteral<"cpu">;
97
+ cudaInitialized: z.ZodLiteral<false>;
98
+ modelConstructed: z.ZodLiteral<false>;
99
+ numericalControlVerified: z.ZodLiteral<false>;
100
+ authority: z.ZodLiteral<"none">;
101
+ }, z.core.$strict>;
102
+ export type NolPytorchControlInventory = z.infer<typeof NolPytorchControlInventorySchema>;
103
+ export interface NolPytorchControlReaderHost {
104
+ pythonPath: string;
105
+ readerPath: string;
106
+ expectedReaderSha256: string;
107
+ checkpointEditorPath: string;
108
+ expectedCheckpointEditorSha256: typeof NOL_PYTORCH_CONTROL_EDITOR_SHA256;
109
+ dependencyLockPath: string;
110
+ /** A private host-owned directory; each call retains a fresh private child. */
111
+ reportRoot: string;
112
+ limits: NolPytorchControlReaderLimits;
113
+ }
114
+ export interface NolPytorchControlInventoryHandle {
115
+ readonly inventory: Readonly<NolPytorchControlInventory>;
116
+ readonly reportPath: string;
117
+ /** Detect source mutation before accepting results from these byte ranges. */
118
+ assertCurrent(): void;
119
+ /** Must be applied to actual candidate-derived changed names. This method
120
+ * does not accept a serialized claim that aliased edits are safe. */
121
+ assertNoChangedAliases(names: Iterable<string>): void;
122
+ streamTensor(name: string, signal?: AbortSignal): AsyncGenerator<Uint8Array>;
123
+ close(): Promise<void>;
124
+ }
125
+ export declare class NolPytorchControlReaderError extends Error {
126
+ readonly reportDirectory: string;
127
+ readonly processSettled: boolean;
128
+ constructor(message: string, reportDirectory: string, processSettled: boolean, options?: ErrorOptions);
129
+ }
130
+ /** Full-source/runtime inspection only. This explicit CPU action never imports
131
+ * Torch, tokenizes, constructs a model, installs a package, or touches CUDA. */
132
+ export declare function inspectNolPytorchControlReaderRuntime(input: NolPytorchControlReaderHost, signal?: AbortSignal): Promise<{
133
+ runtime: NolPytorchControlReaderRuntime;
134
+ reportPath: string;
135
+ }>;
136
+ export declare function openNolPytorchControlInventory(input: {
137
+ host: NolPytorchControlReaderHost;
138
+ runtime: NolPytorchControlReaderRuntime;
139
+ model: NolModelManifest;
140
+ checkpointRoot: string;
141
+ signal?: AbortSignal;
142
+ }): Promise<NolPytorchControlInventoryHandle>;
143
+ export {};
@@ -0,0 +1,61 @@
1
+ /** Source-derived metadata only. This does not issue a runtime capability or
2
+ * prove that hooks executed. Admission still requires the full frozen model,
3
+ * runtime, placement and native implementation receipt. */
4
+ export declare const NOL_QWEN35_HEAD_SOURCE: Readonly<{
5
+ transformersVersion: "5.22.1";
6
+ commit: "446a570e62b04a89ea001604ada7366baac2ea67";
7
+ modelingSha256: "af05d0acfe79fff8aea1c75f93516a6a72bc80f6f901329a73e66a3866fe1e7c";
8
+ configurationSha256: "332ea31ed31cc81ddb72da28737e9868a55d295f9f1daa3e0ad0d57d56d4e657";
9
+ }>;
10
+ export interface NolQwen35FullAttentionHeadSite {
11
+ site: {
12
+ id: string;
13
+ kind: "attention_head";
14
+ layer: number;
15
+ headCount: number;
16
+ width: number;
17
+ };
18
+ modulePath: string;
19
+ hook: "forward_pre_hook_input_0";
20
+ stage: "post_sigmoid_gate_pre_output_projection";
21
+ flatWidth: number;
22
+ keyValueHeadCount: number;
23
+ queryHeadsPerKeyValueHead: number;
24
+ }
25
+ export interface NolQwen35HeadMapping {
26
+ status: "source_mapping_only";
27
+ executionVerified: false;
28
+ sites: NolQwen35FullAttentionHeadSite[];
29
+ excludedRecurrentLayers: Array<{
30
+ layer: number;
31
+ kind: "gated_delta_value_head";
32
+ valueHeadCount: number;
33
+ valueHeadWidth: number;
34
+ reason: "distinct_recurrent_semantics_not_full_attention";
35
+ }>;
36
+ }
37
+ /** Maps the explicitly approved dense 4B text layout. The supplied source
38
+ * fingerprints must come from host-hashed installed source, never a provider
39
+ * feature flag. Changed layouts/versions need a separate source review.
40
+ *
41
+ * A gain scales one contiguous query-output head AFTER its sigmoid gate and
42
+ * BEFORE W_O. It does not edit q/k/v, gate logits, KV groups or residual output.
43
+ * GatedDeltaNet value/state heads are deliberately excluded from this operation.
44
+ */
45
+ export declare function mapNolQwen35FullAttentionHeads(input: {
46
+ config: unknown;
47
+ source: {
48
+ transformersVersion: string;
49
+ modelingSha256: string;
50
+ configurationSha256: string;
51
+ };
52
+ tensorParallelSize: number;
53
+ modality: "text_only";
54
+ attentionImplementation: "eager";
55
+ }): NolQwen35HeadMapping;
56
+ /** End is exclusive. The 256-wide output head is not hidden_size / heads (160)
57
+ * and not one of the four KV heads or the interleaved q+gate projection halves. */
58
+ export declare function nolQwen35FullAttentionHeadSlice(site: NolQwen35FullAttentionHeadSite, head: number): {
59
+ start: number;
60
+ end: number;
61
+ };
@@ -0,0 +1,82 @@
1
+ export type NolWorkerRuntime = "transformers" | "gne";
2
+ export interface NolRuntimeCodeAsset {
3
+ path: string;
4
+ sha256: string;
5
+ sizeBytes: number;
6
+ }
7
+ export interface NolAssetResolveOptions {
8
+ path?: string;
9
+ expectedSha256?: string;
10
+ }
11
+ export interface NolTransformersExtensionResolveOptions extends NolAssetResolveOptions {
12
+ expectedBaseSha256?: string;
13
+ }
14
+ export interface NolTransformersExtensionAsset extends NolRuntimeCodeAsset {
15
+ baseWorker: NolRuntimeCodeAsset;
16
+ }
17
+ export interface NolGneExtensionResolveOptions extends NolAssetResolveOptions {
18
+ expectedBaseSha256?: string;
19
+ }
20
+ export interface NolGneExtensionAsset extends NolRuntimeCodeAsset {
21
+ baseWorker: NolRuntimeCodeAsset;
22
+ }
23
+ export interface NolPytorchControlReaderAsset extends NolRuntimeCodeAsset {
24
+ checkpointEditor: NolRuntimeCodeAsset;
25
+ }
26
+ export interface NolPytorchControlReaderResolveOptions extends NolAssetResolveOptions {
27
+ expectedCheckpointEditorSha256?: string;
28
+ }
29
+ export interface NolGgufControlReaderAsset extends NolRuntimeCodeAsset {
30
+ checkpointEditor: NolRuntimeCodeAsset;
31
+ }
32
+ export interface NolGgufControlReaderResolveOptions extends NolAssetResolveOptions {
33
+ expectedCheckpointEditorSha256?: string;
34
+ }
35
+ export interface NolTransformersPeftValidationResolveOptions extends NolAssetResolveOptions {
36
+ expectedPeftSha256?: string;
37
+ expectedBaseSha256?: string;
38
+ }
39
+ export interface NolTransformersPeftValidationAsset extends NolRuntimeCodeAsset {
40
+ peftWorker: NolRuntimeCodeAsset;
41
+ baseWorker: NolRuntimeCodeAsset;
42
+ }
43
+ export interface NolVllmWorkerResolveOptions extends NolAssetResolveOptions {
44
+ expectedCompanionSha256?: string;
45
+ expectedRuntimeSha256?: string;
46
+ expectedTokenizerSha256?: string;
47
+ }
48
+ export interface NolVllmWorkerAsset extends NolRuntimeCodeAsset {
49
+ companion: NolRuntimeCodeAsset;
50
+ runtime: NolRuntimeCodeAsset;
51
+ tokenizer: NolRuntimeCodeAsset;
52
+ }
53
+ /** Explicit asset inspection only. Importing this module never starts Python,
54
+ * installs packages, discovers hardware or loads a model. */
55
+ export declare function resolveNolWorkerAsset(runtime: NolWorkerRuntime, options?: NolAssetResolveOptions): Promise<NolRuntimeCodeAsset>;
56
+ /** Resolves the offline editor; this never starts Python or loads parameters. */
57
+ export declare function resolveNolCheckpointEditorAsset(options?: NolAssetResolveOptions): Promise<NolRuntimeCodeAsset>;
58
+ /** Resolves CPU-only LoRA serialization code; never starts Python or loads a model. */
59
+ export declare function resolveNolLoraExporterAsset(options?: NolAssetResolveOptions): Promise<NolRuntimeCodeAsset>;
60
+ /** Explicit profile/observation extension. Resolving code grants no model,
61
+ * compute, operation or scientific capability and never selects this backend. */
62
+ export declare function resolveNolTransformersResearchWorkerAsset(options?: NolTransformersExtensionResolveOptions): Promise<NolTransformersExtensionAsset>;
63
+ /** Explicit serialized, unmerged PEFT worker. Both source files are inspected;
64
+ * the generic Transformers adapter and resolver remain unchanged. */
65
+ export declare function resolveNolTransformersPeftWorkerAsset(options?: NolTransformersExtensionResolveOptions): Promise<NolTransformersExtensionAsset>;
66
+ /** Explicit PEFT validation wrapper with its complete reviewed two-file base
67
+ * chain. Inspection starts no Python process and grants no conformance authority. */
68
+ export declare function resolveNolTransformersPeftValidationWorkerAsset(options?: NolTransformersPeftValidationResolveOptions): Promise<NolTransformersPeftValidationAsset>;
69
+ /** Explicit owned vLLM code inventory, including both loader companions and the
70
+ * independent CPU tokenizer. Resolution selects no model or execution backend. */
71
+ export declare function resolveNolVllmWorkerAsset(options?: NolVllmWorkerResolveOptions): Promise<NolVllmWorkerAsset>;
72
+ /** Explicit v2 conditional-gradient code with its frozen EA companion.
73
+ * Inspection grants no operation, numerical or compute authority. */
74
+ export declare function resolveNolTransformersNnsightWorkerAsset(options?: NolTransformersExtensionResolveOptions): Promise<NolTransformersExtensionAsset>;
75
+ /** Explicit custom Qwen XML decoder, never a generic GNE replacement. */
76
+ export declare function resolveNolGneToolsWorkerAsset(options?: NolGneExtensionResolveOptions): Promise<NolGneExtensionAsset>;
77
+ /** Independent CPU-only GGUF export code; no framework/model process starts. */
78
+ export declare function resolveNolGgufCheckpointEditorAsset(options?: NolAssetResolveOptions): Promise<NolRuntimeCodeAsset>;
79
+ /** CPU ZIP/tensor inventory only; inspection starts no helper or framework. */
80
+ export declare function resolveNolPytorchControlReaderAsset(options?: NolPytorchControlReaderResolveOptions): Promise<NolPytorchControlReaderAsset>;
81
+ /** CPU GGUF inventory/decoding only; inspection grants no edit or inference capability. */
82
+ export declare function resolveNolGgufControlReaderAsset(options?: NolGgufControlReaderResolveOptions): Promise<NolGgufControlReaderAsset>;
@@ -0,0 +1,94 @@
1
+ import { type ChildProcessWithoutNullStreams } from "node:child_process";
2
+ export declare const NOL_WORKER_PROTOCOL: "omnius.nol.worker.v1";
3
+ export declare const NOL_WORKER_ACTIONS: readonly [
4
+ "hello",
5
+ "inspect",
6
+ "load",
7
+ "confirm_placement",
8
+ "tokenize",
9
+ "reset",
10
+ "generate",
11
+ "profile",
12
+ "close"
13
+ ];
14
+ export type NolWorkerAction = typeof NOL_WORKER_ACTIONS[number];
15
+ export interface NolWorkerOwnership {
16
+ jobId: string;
17
+ ownerId: string;
18
+ generation: number;
19
+ }
20
+ export interface NolWorkerLimits {
21
+ maxFrameBytes: number;
22
+ maxStdoutBytes: number;
23
+ maxStderrBytes: number;
24
+ requestTimeoutMs: number;
25
+ killGraceMs: number;
26
+ }
27
+ export declare function encodeNolWorkerFrame(value: unknown, maxFrameBytes: number): Buffer;
28
+ /** Incremental decoder allocates each bounded payload once, even for bytewise input. */
29
+ export declare class NolWorkerFrameDecoder {
30
+ readonly maxFrameBytes: number;
31
+ private header;
32
+ private headerOffset;
33
+ private body;
34
+ private bodyOffset;
35
+ private failed;
36
+ constructor(maxFrameBytes: number);
37
+ feed(chunk: Uint8Array): unknown[];
38
+ finish(): void;
39
+ }
40
+ export declare class NolWorkerRemoteError extends Error {
41
+ readonly code: string;
42
+ readonly fatal: boolean;
43
+ constructor(code: string, message: string, fatal: boolean);
44
+ }
45
+ export interface NolWorkerExit {
46
+ pid: number | null;
47
+ code: number | null;
48
+ signal: NodeJS.Signals | null;
49
+ stderr: string;
50
+ }
51
+ export interface NolOwnedWorkerOptions {
52
+ command: string;
53
+ args: string[];
54
+ cwd?: string;
55
+ env?: NodeJS.ProcessEnv;
56
+ ownership: NolWorkerOwnership;
57
+ limits: NolWorkerLimits;
58
+ /** Host custody must complete before spawn. Generic CPU tests inject an explicit test callback. */
59
+ beforeStart(): Promise<void>;
60
+ /** Attach the actual child synchronously; model loading is a separate command. */
61
+ onSpawn?(child: ChildProcessWithoutNullStreams): void;
62
+ assertCurrent(): void;
63
+ }
64
+ /** One fixed job/generation, one subprocess, one outstanding request. Construction is inert.
65
+ * Process exit is not a claim of verified CUDA release; the host lease owns that proof. */
66
+ export declare class NolOwnedWorkerProcess {
67
+ private readonly options;
68
+ readonly sessionId: `${string}-${string}-${string}-${string}-${string}`;
69
+ private child;
70
+ private state;
71
+ private sequence;
72
+ private pending;
73
+ private stdoutBytes;
74
+ private stderrBytes;
75
+ private stderrChunks;
76
+ private killTimer;
77
+ private resolveClosed;
78
+ private readonly lifetime;
79
+ private startSignal?;
80
+ private startAbort?;
81
+ readonly closed: Promise<NolWorkerExit>;
82
+ constructor(options: NolOwnedWorkerOptions);
83
+ get pid(): number | null;
84
+ get retired(): boolean;
85
+ start(signal?: AbortSignal): Promise<unknown>;
86
+ private failPending;
87
+ private response;
88
+ request(action: NolWorkerAction, payload: unknown, options?: {
89
+ signal?: AbortSignal;
90
+ timeoutMs?: number;
91
+ }): Promise<unknown>;
92
+ private kill;
93
+ retire(reason?: unknown): void;
94
+ }
@@ -0,0 +1,40 @@
1
+ export type PageContentProducer = "playwright_browser" | "browser_action" | "web_crawl" | "carbonyl_browser";
2
+ export type PageContentAction = "content" | "dom" | "innerText" | "textContent" | "innerHTML" | "evaluate" | "crawl" | "open" | "text" | "daemon_start" | "daemon_navigate";
3
+ /** A complete returned observation, never an HTTP receipt or a full-page/effect claim. */
4
+ export interface NativePageContentSource {
5
+ readonly schema: "omnius.native-page-content-source.v1";
6
+ readonly producerTool: PageContentProducer;
7
+ readonly action: PageContentAction;
8
+ readonly body: string;
9
+ readonly contentSha256: string;
10
+ readonly contentBytes: number;
11
+ readonly viewKind: "rendered_text" | "raw_html" | "evaluation_json" | "crawl_result";
12
+ readonly scope: "document" | "selected_element" | "evaluation_result" | "crawl_pages";
13
+ readonly coverage: "complete_returned_view";
14
+ readonly url: string | null;
15
+ readonly urlKind: "observed" | "requested" | "last_navigated" | "unknown";
16
+ readonly sessionId?: string;
17
+ readonly selector?: string;
18
+ readonly captureId: string;
19
+ readonly observedAt: string;
20
+ readonly invocationSha256: string;
21
+ /** Actual crawler result-page URLs, never links merely found in page content. */
22
+ readonly observedUrls?: readonly string[];
23
+ readonly delegatedFrom?: Readonly<{
24
+ producerTool: "playwright_browser";
25
+ captureId: string;
26
+ invocationSha256: string;
27
+ sessionId?: string;
28
+ }>;
29
+ }
30
+ /** Binds every original JSON argument; object property ordering is immaterial. */
31
+ export declare function pageContentSourceInvocationSha256(producerTool: PageContentProducer, args: Record<string, unknown>): string;
32
+ type PageContentSourceInput = Pick<NativePageContentSource, "producerTool" | "action" | "body" | "viewKind" | "scope" | "url" | "urlKind" | "sessionId" | "selector" | "observedUrls"> & {
33
+ args: Record<string, unknown>;
34
+ delegatedSource?: NativePageContentSource;
35
+ };
36
+ /** Internal producer seam; deliberately absent from the public package exports. */
37
+ export declare function issueNativePageContentSource(input: PageContentSourceInput): NativePageContentSource;
38
+ /** Copies, model output and arbitrary metadata cannot issue this capability. */
39
+ export declare function verifiedNativePageContentSource(value: unknown): NativePageContentSource | null;
40
+ export {};
@@ -0,0 +1,21 @@
1
+ /** Host-owned local storage. Labels and nonsensitive field values can still be personal. */
2
+ export interface UiPersistenceOptions {
3
+ directory: string;
4
+ allowPlaintextPersistence: true;
5
+ }
6
+ export declare const MAX_UI_ARTIFACT_BYTES: number;
7
+ export declare function artifactKey(value: unknown): asserts value is string;
8
+ export declare function exactObject(value: unknown, keys: readonly string[], label: string): Record<string, any>;
9
+ export declare function boundedString(value: unknown, max: number, label: string, allowEmpty?: boolean): asserts value is string;
10
+ export declare function digestString(value: unknown): asserts value is string;
11
+ /** Internal storage primitive; the parent directory must already exist and be host-selected. */
12
+ export declare class LocalUiArtifactStore {
13
+ private readonly directory;
14
+ constructor(options: UiPersistenceOptions);
15
+ private checkLimit;
16
+ private privateOwner;
17
+ private root;
18
+ private existing;
19
+ write(key: string, value: unknown, maxBytes: number, signal?: AbortSignal): Promise<void>;
20
+ read(key: string, maxBytes: number, signal?: AbortSignal): Promise<unknown>;
21
+ }