@abot-ai/runtime 1.9.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (506) hide show
  1. package/README.md +5 -1
  2. package/dist/scripts/add-runtime-model.js +11 -5
  3. package/dist/scripts/init-runtime.js +15 -10
  4. package/dist/scripts/runtime-model-addition.js +6 -1
  5. package/dist/scripts/runtime-setup-command-options.d.ts +11 -0
  6. package/dist/scripts/runtime-setup-command-options.js +41 -0
  7. package/dist/scripts/runtime-setup-files.d.ts +3 -2
  8. package/dist/scripts/runtime-setup-files.js +19 -4
  9. package/dist/scripts/runtime-setup-model-options.d.ts +8 -0
  10. package/dist/scripts/runtime-setup-model-options.js +40 -0
  11. package/dist/scripts/runtime-setup-presentation.js +2 -2
  12. package/dist/scripts/runtime-setup-provider-options.d.ts +4 -0
  13. package/dist/scripts/runtime-setup-provider-options.js +20 -0
  14. package/dist/src/model-gateway/client/contracts.d.ts +3 -0
  15. package/dist/src/model-gateway/client/input-token-count.js +36 -16
  16. package/dist/src/model-gateway/client/message-projection.d.ts +2 -0
  17. package/dist/src/model-gateway/client/message-projection.js +1 -0
  18. package/dist/src/model-gateway/client/options.js +1 -1
  19. package/dist/src/model-gateway/client/raw.js +1 -0
  20. package/dist/src/model-gateway/index.d.ts +1 -1
  21. package/dist/src/model-gateway/observability/input-token-count-diagnostics.d.ts +26 -0
  22. package/dist/src/model-gateway/observability/input-token-count-diagnostics.js +178 -0
  23. package/dist/src/model-gateway/policy/invocation-policy.d.ts +1 -3
  24. package/dist/src/model-gateway/policy/invocation-policy.js +3 -30
  25. package/dist/src/model-gateway/policy/reasoning-mode-budget.d.ts +5 -0
  26. package/dist/src/model-gateway/policy/reasoning-mode-budget.js +13 -0
  27. package/dist/src/model-gateway/policy/reasoning-policy.d.ts +10 -0
  28. package/dist/src/model-gateway/policy/reasoning-policy.js +124 -0
  29. package/dist/src/model-gateway/protocol/openai-embedding-response.d.ts +1 -0
  30. package/dist/src/model-gateway/protocol/openai-embedding-response.js +28 -0
  31. package/dist/src/model-gateway/protocol/sse-data.d.ts +9 -0
  32. package/dist/src/model-gateway/protocol/sse-data.js +67 -0
  33. package/dist/src/model-gateway/providers/envelope-budget.js +10 -1
  34. package/dist/src/model-gateway/providers/llamacpp/adapter.d.ts +2 -0
  35. package/dist/src/model-gateway/providers/llamacpp/adapter.js +79 -0
  36. package/dist/src/model-gateway/providers/llamacpp/connection.d.ts +9 -0
  37. package/dist/src/model-gateway/providers/llamacpp/connection.js +73 -0
  38. package/dist/src/model-gateway/providers/llamacpp/diagnostics.d.ts +2 -0
  39. package/dist/src/model-gateway/providers/llamacpp/diagnostics.js +17 -0
  40. package/dist/src/model-gateway/providers/llamacpp/embeddings.d.ts +2 -0
  41. package/dist/src/model-gateway/providers/llamacpp/embeddings.js +56 -0
  42. package/dist/src/model-gateway/providers/llamacpp/input-token-count.d.ts +3 -0
  43. package/dist/src/model-gateway/providers/llamacpp/input-token-count.js +59 -0
  44. package/dist/src/model-gateway/providers/llamacpp/message-projection.d.ts +2 -0
  45. package/dist/src/model-gateway/providers/llamacpp/message-projection.js +33 -0
  46. package/dist/src/model-gateway/providers/llamacpp/payload.d.ts +2 -0
  47. package/dist/src/model-gateway/providers/llamacpp/payload.js +44 -0
  48. package/dist/src/model-gateway/providers/llamacpp/response-lifetime.d.ts +1 -0
  49. package/dist/src/model-gateway/providers/llamacpp/response-lifetime.js +56 -0
  50. package/dist/src/model-gateway/providers/llamacpp/schema-format.d.ts +2 -0
  51. package/dist/src/model-gateway/providers/llamacpp/schema-format.js +29 -0
  52. package/dist/src/model-gateway/providers/llamacpp/settings.d.ts +9 -0
  53. package/dist/src/model-gateway/providers/llamacpp/settings.js +25 -0
  54. package/dist/src/model-gateway/providers/llamacpp/stream-normalizer.d.ts +10 -0
  55. package/dist/src/model-gateway/providers/llamacpp/stream-normalizer.js +85 -0
  56. package/dist/src/model-gateway/providers/llamacpp/stream.d.ts +9 -0
  57. package/dist/src/model-gateway/providers/llamacpp/stream.js +33 -0
  58. package/dist/src/model-gateway/providers/openai/embeddings.js +2 -29
  59. package/dist/src/model-gateway/providers/openai/sse-data.d.ts +1 -9
  60. package/dist/src/model-gateway/providers/openai/sse-data.js +1 -67
  61. package/dist/src/model-gateway/providers/registry.js +2 -0
  62. package/dist/src/model-gateway/server/input-token-count-handler.js +10 -1
  63. package/dist/src/model-gateway/types.d.ts +11 -1
  64. package/dist/src/runtime/adapters/long-term-memory/onboarding-provider-availability.d.ts +4 -0
  65. package/dist/src/runtime/adapters/long-term-memory/onboarding-provider-availability.js +11 -0
  66. package/dist/src/runtime/adapters/long-term-memory/onboarding-service.js +28 -1
  67. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.d.ts +1 -0
  68. package/dist/src/runtime/adapters/registered-tool-payload-related-artifacts.js +6 -1
  69. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +1 -0
  70. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.d.ts +1 -0
  71. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +2 -0
  72. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.d.ts +1 -0
  73. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-lifecycle.js +2 -0
  74. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.d.ts +1 -0
  75. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-stages.js +1 -0
  76. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +1 -0
  77. package/dist/src/runtime/adapters/scheduler-runtime.js +2 -0
  78. package/dist/src/runtime/automations/agent-step-executor.js +1 -0
  79. package/dist/src/runtime/automations/catalog.d.ts +3 -0
  80. package/dist/src/runtime/automations/catalog.js +2 -0
  81. package/dist/src/runtime/automations/definition-contracts.d.ts +2 -0
  82. package/dist/src/runtime/automations/definition-input.js +3 -1
  83. package/dist/src/runtime/automations/draft-mutations.js +5 -1
  84. package/dist/src/runtime/automations/model-dependency-projection.d.ts +3 -1
  85. package/dist/src/runtime/automations/model-dependency-projection.js +4 -2
  86. package/dist/src/runtime/automations/publication-validation.js +7 -0
  87. package/dist/src/runtime/automations/saved-agent-management.js +1 -0
  88. package/dist/src/runtime/automations/service.d.ts +3 -0
  89. package/dist/src/runtime/capabilities/automation-builder/payload-schema.js +7 -5
  90. package/dist/src/runtime/capabilities/automations/authoring-catalog.d.ts +9 -0
  91. package/dist/src/runtime/capabilities/automations/authoring-catalog.js +1 -0
  92. package/dist/src/runtime/capabilities/automations/authoring-preparation.d.ts +3 -0
  93. package/dist/src/runtime/capabilities/automations/tool-contract.js +3 -2
  94. package/dist/src/runtime/capabilities/automations/tool-module.js +16 -7
  95. package/dist/src/runtime/capabilities/model-reasoning-controls.d.ts +23 -0
  96. package/dist/src/runtime/capabilities/model-reasoning-controls.js +56 -0
  97. package/dist/src/runtime/capabilities/scheduling/create-operations.js +2 -0
  98. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +1 -0
  99. package/dist/src/runtime/capabilities/scheduling/tool-module.js +5 -2
  100. package/dist/src/runtime/capabilities/scheduling/update-operations.js +2 -0
  101. package/dist/src/runtime/config/builders.js +6 -0
  102. package/dist/src/runtime/config/effective-model-config-validation.js +4 -0
  103. package/dist/src/runtime/config/llamacpp-profile-validation.d.ts +3 -0
  104. package/dist/src/runtime/config/llamacpp-profile-validation.js +15 -0
  105. package/dist/src/runtime/config/model-reasoning-schema.d.ts +40 -0
  106. package/dist/src/runtime/config/model-reasoning-schema.js +38 -0
  107. package/dist/src/runtime/config/model-reasoning-validation.d.ts +3 -0
  108. package/dist/src/runtime/config/model-reasoning-validation.js +37 -0
  109. package/dist/src/runtime/config/runner/step-instructions.d.ts +4 -0
  110. package/dist/src/runtime/config/runner/step-instructions.js +10 -6
  111. package/dist/src/runtime/config/schema.js +3 -0
  112. package/dist/src/runtime/config/validation/model-invocation-config-validation.js +14 -0
  113. package/dist/src/runtime/context/compacted-capability-result-receipt.d.ts +2 -0
  114. package/dist/src/runtime/context/compacted-capability-result-receipt.js +8 -7
  115. package/dist/src/runtime/context/execution-compacted-evidence.d.ts +4 -0
  116. package/dist/src/runtime/context/execution-compacted-evidence.js +2 -23
  117. package/dist/src/runtime/context/execution-compaction-checkpoint-selection.d.ts +19 -0
  118. package/dist/src/runtime/context/execution-compaction-checkpoint-selection.js +104 -0
  119. package/dist/src/runtime/context/model-step-compaction-inheritance.d.ts +12 -0
  120. package/dist/src/runtime/context/model-step-compaction-inheritance.js +28 -0
  121. package/dist/src/runtime/context/model-step-compaction-projection.d.ts +12 -0
  122. package/dist/src/runtime/context/model-step-compaction-projection.js +322 -0
  123. package/dist/src/runtime/context/model-step-compaction.d.ts +2 -1
  124. package/dist/src/runtime/context/model-step-compaction.js +25 -316
  125. package/dist/src/runtime/context/operation-supervision-compacted-evidence.js +7 -1
  126. package/dist/src/runtime/context/request-context.d.ts +2 -0
  127. package/dist/src/runtime/context/request-context.js +16 -0
  128. package/dist/src/runtime/context/request-tool-results-checkpoint.d.ts +2 -1
  129. package/dist/src/runtime/context/request-tool-results-checkpoint.js +35 -6
  130. package/dist/src/runtime/context/request-tool-results.js +3 -1
  131. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.d.ts +5 -1
  132. package/dist/src/runtime/context/semantic-compaction/checkpoint-message.js +10 -4
  133. package/dist/src/runtime/context/semantic-compaction/execution-evidence-instructions.d.ts +4 -0
  134. package/dist/src/runtime/context/semantic-compaction/execution-evidence-instructions.js +38 -0
  135. package/dist/src/runtime/context/semantic-compaction/generation-contracts.d.ts +3 -1
  136. package/dist/src/runtime/context/semantic-compaction/generation-input.js +15 -10
  137. package/dist/src/runtime/context/semantic-compaction/inherited-source-digests.d.ts +8 -0
  138. package/dist/src/runtime/context/semantic-compaction/inherited-source-digests.js +76 -0
  139. package/dist/src/runtime/context/semantic-compaction/replacement-budget.js +3 -1
  140. package/dist/src/runtime/context/semantic-compaction/run.js +6 -12
  141. package/dist/src/runtime/knowledge-skills/builtins/computer-use.js +1 -1
  142. package/dist/src/runtime/knowledge-skills/builtins/technical-work.js +20 -2
  143. package/dist/src/runtime/knowledge-skills/builtins/what-can-i-do.d.ts +2 -0
  144. package/dist/src/runtime/knowledge-skills/builtins/what-can-i-do.js +27 -0
  145. package/dist/src/runtime/knowledge-skills/catalog.js +2 -0
  146. package/dist/src/runtime/local-application.d.ts +5 -0
  147. package/dist/src/runtime/local-host/app-service-dispatch.d.ts +1 -1
  148. package/dist/src/runtime/local-host/app-service-dispatch.js +2 -0
  149. package/dist/src/runtime/local-host/client-services.d.ts +5 -0
  150. package/dist/src/runtime/local-host/saved-approvals.js +1 -0
  151. package/dist/src/runtime/long-term-memory/onboarding/configuration.js +5 -7
  152. package/dist/src/runtime/long-term-memory/onboarding/contracts.d.ts +26 -0
  153. package/dist/src/runtime/long-term-memory/onboarding/embedding-profile-id.d.ts +1 -0
  154. package/dist/src/runtime/long-term-memory/onboarding/embedding-profile-id.js +8 -0
  155. package/dist/src/runtime/long-term-memory/onboarding/saved-profiles.d.ts +17 -0
  156. package/dist/src/runtime/long-term-memory/onboarding/saved-profiles.js +77 -0
  157. package/dist/src/runtime/long-term-memory/onboarding/service.js +40 -10
  158. package/dist/src/runtime/model/input-token-count.js +1 -0
  159. package/dist/src/runtime/model/invoke-step.js +12 -0
  160. package/dist/src/runtime/model/invoke-structured-step.d.ts +4 -1
  161. package/dist/src/runtime/model/invoke-structured-step.js +4 -0
  162. package/dist/src/runtime/model/model-catalog.d.ts +3 -0
  163. package/dist/src/runtime/model/model-catalog.js +2 -0
  164. package/dist/src/runtime/model/model-context-budget.d.ts +5 -0
  165. package/dist/src/runtime/model/model-context-budget.js +2 -0
  166. package/dist/src/runtime/model/model-step-port.d.ts +7 -0
  167. package/dist/src/runtime/model/optional-context-admission.d.ts +18 -0
  168. package/dist/src/runtime/model/optional-context-admission.js +23 -0
  169. package/dist/src/runtime/ports.d.ts +3 -1
  170. package/dist/src/runtime/projects/contracts.d.ts +6 -0
  171. package/dist/src/runtime/projects/registry-format.d.ts +3 -0
  172. package/dist/src/runtime/projects/registry-format.js +50 -0
  173. package/dist/src/runtime/projects/repository.d.ts +6 -3
  174. package/dist/src/runtime/projects/repository.js +26 -19
  175. package/dist/src/runtime/projects/service.js +11 -0
  176. package/dist/src/runtime/request/approval-wait/preflight.js +1 -0
  177. package/dist/src/runtime/request/approval-wait/snapshot.d.ts +1 -1
  178. package/dist/src/runtime/request/approval-wait/snapshot.js +1 -0
  179. package/dist/src/runtime/request/contracts.d.ts +5 -1
  180. package/dist/src/runtime/request/execution-facets.js +2 -0
  181. package/dist/src/runtime/request/execution-payload-artifact-policy.d.ts +3 -0
  182. package/dist/src/runtime/request/execution-payload-artifact-policy.js +6 -0
  183. package/dist/src/runtime/request/execution-payload-compacted-evidence.js +1 -0
  184. package/dist/src/runtime/request/execution-scope-surfaces.d.ts +2 -0
  185. package/dist/src/runtime/request/execution-scope-surfaces.js +3 -0
  186. package/dist/src/runtime/request/execution-scope.d.ts +2 -0
  187. package/dist/src/runtime/request/execution-scope.js +2 -0
  188. package/dist/src/runtime/request/input.d.ts +1 -0
  189. package/dist/src/runtime/request/input.js +1 -0
  190. package/dist/src/runtime/request/prepared-execution.d.ts +1 -0
  191. package/dist/src/runtime/request/prepared-execution.js +3 -0
  192. package/dist/src/runtime/request/reasoning-preference.d.ts +10 -0
  193. package/dist/src/runtime/request/reasoning-preference.js +29 -0
  194. package/dist/src/runtime/request/root-reference-action.js +3 -3
  195. package/dist/src/runtime/request/root-skill-read-admission.d.ts +4 -0
  196. package/dist/src/runtime/request/root-skill-read-admission.js +14 -0
  197. package/dist/src/runtime/request/root-skill-read.js +13 -5
  198. package/dist/src/runtime/request/supervisor-skill-selection-window.d.ts +16 -0
  199. package/dist/src/runtime/request/supervisor-skill-selection-window.js +17 -0
  200. package/dist/src/runtime/request/worker-capability-composition.js +2 -0
  201. package/dist/src/runtime/scheduler/contracts.d.ts +7 -1
  202. package/dist/src/runtime/scheduler/job-management.js +7 -1
  203. package/dist/src/runtime/scheduler/run-records.js +2 -0
  204. package/dist/src/runtime/scheduler/schedule-validation.js +2 -0
  205. package/dist/src/runtime/scheduler/scheduler-engine.js +1 -0
  206. package/dist/src/runtime/scheduler/snapshot-validation.js +2 -0
  207. package/dist/src/runtime/steps/auditor-decision/projection.js +2 -0
  208. package/dist/src/runtime/steps/execution-agent/capability-controls-partition.d.ts +9 -0
  209. package/dist/src/runtime/steps/execution-agent/capability-controls-partition.js +29 -0
  210. package/dist/src/runtime/steps/execution-agent/capability-scope.d.ts +17 -0
  211. package/dist/src/runtime/steps/execution-agent/capability-scope.js +54 -0
  212. package/dist/src/runtime/steps/execution-agent/compaction.js +22 -6
  213. package/dist/src/runtime/steps/execution-agent/controls-compacted-evidence.js +2 -0
  214. package/dist/src/runtime/steps/execution-agent/evidence-reuse-instructions.d.ts +6 -0
  215. package/dist/src/runtime/steps/execution-agent/evidence-reuse-instructions.js +13 -0
  216. package/dist/src/runtime/steps/execution-agent/format.js +3 -6
  217. package/dist/src/runtime/steps/execution-agent/input.d.ts +5 -1
  218. package/dist/src/runtime/steps/execution-agent/input.js +10 -36
  219. package/dist/src/runtime/steps/execution-agent/observation-guidance.d.ts +11 -0
  220. package/dist/src/runtime/steps/execution-agent/observation-guidance.js +33 -0
  221. package/dist/src/runtime/steps/execution-agent/prompt.js +2 -0
  222. package/dist/src/runtime/steps/execution-agent/refinement.d.ts +3 -2
  223. package/dist/src/runtime/steps/execution-agent/refinement.js +17 -6
  224. package/dist/src/runtime/steps/execution-agent/run.js +7 -1
  225. package/dist/src/runtime/steps/skill-read-decision.d.ts +1 -0
  226. package/dist/src/runtime/steps/skill-read-decision.js +9 -4
  227. package/dist/src/runtime/steps/supervisor-decision/artifact-paths.d.ts +6 -1
  228. package/dist/src/runtime/steps/supervisor-decision/artifact-paths.js +15 -0
  229. package/dist/src/runtime/steps/supervisor-decision/contracts.d.ts +1 -1
  230. package/dist/src/runtime/steps/supervisor-decision/contracts.js +2 -0
  231. package/dist/src/runtime/steps/supervisor-decision/decision-phases.d.ts +3 -0
  232. package/dist/src/runtime/steps/supervisor-decision/decision-phases.js +22 -3
  233. package/dist/src/runtime/steps/supervisor-decision/delegation-contract.d.ts +9 -0
  234. package/dist/src/runtime/steps/supervisor-decision/delegation-contract.js +82 -0
  235. package/dist/src/runtime/steps/supervisor-decision/delegation-input.d.ts +7 -0
  236. package/dist/src/runtime/steps/supervisor-decision/delegation-input.js +105 -0
  237. package/dist/src/runtime/steps/supervisor-decision/delegation-prompt.d.ts +7 -0
  238. package/dist/src/runtime/steps/supervisor-decision/delegation-prompt.js +13 -0
  239. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -0
  240. package/dist/src/runtime/steps/supervisor-decision/preparation-input.d.ts +3 -5
  241. package/dist/src/runtime/steps/supervisor-decision/preparation-input.js +5 -21
  242. package/dist/src/runtime/steps/supervisor-decision/preparation.d.ts +4 -1
  243. package/dist/src/runtime/steps/supervisor-decision/preparation.js +58 -6
  244. package/dist/src/runtime/steps/supervisor-decision/procedure-entry.d.ts +22 -0
  245. package/dist/src/runtime/steps/supervisor-decision/procedure-entry.js +61 -0
  246. package/dist/src/runtime/steps/supervisor-decision/procedure-gate.d.ts +39 -0
  247. package/dist/src/runtime/steps/supervisor-decision/procedure-gate.js +146 -0
  248. package/dist/src/runtime/steps/supervisor-decision/procedure-memory.d.ts +9 -0
  249. package/dist/src/runtime/steps/supervisor-decision/procedure-memory.js +100 -0
  250. package/dist/src/runtime/steps/supervisor-decision/procedure-recall.d.ts +10 -0
  251. package/dist/src/runtime/steps/supervisor-decision/procedure-recall.js +52 -0
  252. package/dist/src/runtime/steps/supervisor-decision/prompt.js +3 -16
  253. package/dist/src/runtime/steps/supervisor-decision/response-recommendation.js +2 -2
  254. package/dist/src/runtime/steps/supervisor-decision/role-guidance.d.ts +3 -0
  255. package/dist/src/runtime/steps/supervisor-decision/role-guidance.js +20 -0
  256. package/dist/src/runtime/steps/supervisor-decision/run.js +50 -7
  257. package/dist/src/runtime/steps/supervisor-decision/skill-read-state.d.ts +10 -0
  258. package/dist/src/runtime/steps/supervisor-decision/skill-read-state.js +45 -0
  259. package/dist/src/runtime/steps/supervisor-decision/skill-selection-candidates.d.ts +15 -0
  260. package/dist/src/runtime/steps/supervisor-decision/skill-selection-candidates.js +25 -0
  261. package/dist/src/runtime/steps/supervisor-decision/skill-selection-catalog.d.ts +3 -0
  262. package/dist/src/runtime/steps/supervisor-decision/skill-selection-catalog.js +15 -0
  263. package/dist/src/runtime/steps/supervisor-decision/skill-selection-continuation.d.ts +10 -0
  264. package/dist/src/runtime/steps/supervisor-decision/skill-selection-continuation.js +65 -0
  265. package/dist/src/runtime/steps/supervisor-decision/skill-selection-input.d.ts +3 -1
  266. package/dist/src/runtime/steps/supervisor-decision/skill-selection-input.js +20 -22
  267. package/dist/src/runtime/steps/supervisor-decision/skill-selection.d.ts +3 -2
  268. package/dist/src/runtime/steps/supervisor-decision/skill-selection.js +62 -15
  269. package/dist/src/runtime/steps/supervisor-response/prompt.js +18 -4
  270. package/dist/src/shared/model-reasoning-modes.d.ts +5 -0
  271. package/dist/src/shared/model-reasoning-modes.js +20 -0
  272. package/dist/src/shared/model-reasoning-schema.d.ts +38 -0
  273. package/dist/src/shared/model-reasoning-schema.js +29 -0
  274. package/dist/src/shared/model-reasoning.d.ts +35 -0
  275. package/dist/src/shared/model-reasoning.js +100 -0
  276. package/dist/src/web-ui/app/ARCHITECTURE.md +13 -0
  277. package/dist/src/web-ui/app/app-bootstrap.js +9 -12
  278. package/dist/src/web-ui/app/app-dom.js +6 -1
  279. package/dist/src/web-ui/app/app-state.js +1 -0
  280. package/dist/src/web-ui/app/app.js +8 -3
  281. package/dist/src/web-ui/app/appearance-feature.js +28 -0
  282. package/dist/src/web-ui/app/automations-feature.js +20 -11
  283. package/dist/src/web-ui/app/components/appearance-dialog.js +79 -0
  284. package/dist/src/web-ui/app/components/automations/archive-actions.js +5 -3
  285. package/dist/src/web-ui/app/components/automations/authoring-entry.js +26 -7
  286. package/dist/src/web-ui/app/components/automations/confirmation-actions.js +78 -0
  287. package/dist/src/web-ui/app/components/automations/draft-recovery-actions.js +1 -0
  288. package/dist/src/web-ui/app/components/automations/node-inspector.js +5 -1
  289. package/dist/src/web-ui/app/components/automations/step-editor-dialog.js +4 -2
  290. package/dist/src/web-ui/app/components/automations/timeline.js +2 -2
  291. package/dist/src/web-ui/app/components/automations/workspace-navigation.js +37 -0
  292. package/dist/src/web-ui/app/components/automations/workspace.js +31 -46
  293. package/dist/src/web-ui/app/components/config-workspace/config-model.js +6 -0
  294. package/dist/src/web-ui/app/components/config-workspace/model-removal.js +4 -2
  295. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +8 -16
  296. package/dist/src/web-ui/app/components/config-workspace/reasoning-budget-edit.js +113 -0
  297. package/dist/src/web-ui/app/components/config-workspace/reasoning-budget.d.ts +16 -0
  298. package/dist/src/web-ui/app/components/config-workspace/reasoning-budget.js +67 -0
  299. package/dist/src/web-ui/app/components/config-workspace/reasoning-mode-budgets.d.ts +7 -0
  300. package/dist/src/web-ui/app/components/config-workspace/reasoning-mode-budgets.js +25 -0
  301. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +15 -7
  302. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +32 -12
  303. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +1 -1
  304. package/dist/src/web-ui/app/components/config-workspace.js +2 -1
  305. package/dist/src/web-ui/app/components/confirmation-dialog.js +88 -0
  306. package/dist/src/web-ui/app/components/conversation-activity.d.ts +2 -0
  307. package/dist/src/web-ui/app/components/conversation-activity.js +32 -3
  308. package/dist/src/web-ui/app/components/conversation-memory-activity.js +31 -0
  309. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +2 -0
  310. package/dist/src/web-ui/app/components/conversation-role-cards.js +14 -11
  311. package/dist/src/web-ui/app/components/conversation-skill-activity.js +67 -0
  312. package/dist/src/web-ui/app/components/conversation-tools.js +5 -5
  313. package/dist/src/web-ui/app/components/conversation-view.js +6 -0
  314. package/dist/src/web-ui/app/components/dashboard/approvals.js +13 -1
  315. package/dist/src/web-ui/app/components/long-term-memory/embedding-connection-dialog.d.ts +38 -0
  316. package/dist/src/web-ui/app/components/long-term-memory/embedding-connection-dialog.js +289 -0
  317. package/dist/src/web-ui/app/components/long-term-memory/embedding-connection-feature.js +75 -0
  318. package/dist/src/web-ui/app/components/long-term-memory/embedding-connection-rendering.js +31 -0
  319. package/dist/src/web-ui/app/components/long-term-memory/manager.js +15 -5
  320. package/dist/src/web-ui/app/components/long-term-memory/saved-embedding-profiles.js +114 -0
  321. package/dist/src/web-ui/app/components/long-term-memory/setup-rendering.js +55 -0
  322. package/dist/src/web-ui/app/components/long-term-memory-setup.js +141 -76
  323. package/dist/src/web-ui/app/components/model-setup/rendering.js +3 -2
  324. package/dist/src/web-ui/app/components/model-setup/validation.js +6 -2
  325. package/dist/src/web-ui/app/components/model-setup/wizard.d.ts +1 -0
  326. package/dist/src/web-ui/app/components/model-setup/wizard.js +28 -5
  327. package/dist/src/web-ui/app/components/passive-learning/memory.js +12 -5
  328. package/dist/src/web-ui/app/components/plugins/manager.js +14 -0
  329. package/dist/src/web-ui/app/components/plugins/removal.js +10 -2
  330. package/dist/src/web-ui/app/components/project-group-actions.js +35 -0
  331. package/dist/src/web-ui/app/components/project-session-groups.js +17 -31
  332. package/dist/src/web-ui/app/components/runtime-setup/commands.js +1 -1
  333. package/dist/src/web-ui/app/components/runtime-setup/connection-form.d.ts +15 -0
  334. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +32 -9
  335. package/dist/src/web-ui/app/components/runtime-setup/connection-input.js +23 -0
  336. package/dist/src/web-ui/app/components/runtime-setup/connection-inspection.js +57 -0
  337. package/dist/src/web-ui/app/components/runtime-setup/connection-state.js +18 -4
  338. package/dist/src/web-ui/app/components/runtime-setup/embedding-credential-status.js +3 -0
  339. package/dist/src/web-ui/app/components/runtime-setup/embedding-provider-options.js +54 -0
  340. package/dist/src/web-ui/app/components/runtime-setup/embedding-provider-receipt.js +3 -0
  341. package/dist/src/web-ui/app/components/runtime-setup/embedding-rendering.js +22 -22
  342. package/dist/src/web-ui/app/components/runtime-setup/embedding.js +60 -16
  343. package/dist/src/web-ui/app/components/runtime-setup/reasoning-fields.d.ts +17 -0
  344. package/dist/src/web-ui/app/components/runtime-setup/reasoning-fields.js +54 -0
  345. package/dist/src/web-ui/app/components/runtime-setup/validation.js +5 -1
  346. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +9 -3
  347. package/dist/src/web-ui/app/components/runtime-setup-guide.js +20 -29
  348. package/dist/src/web-ui/app/components/schedules/details.js +2 -2
  349. package/dist/src/web-ui/app/components/schedules/form.js +12 -5
  350. package/dist/src/web-ui/app/components/schedules/workspace.js +30 -18
  351. package/dist/src/web-ui/app/components/session-list-viewport.js +49 -0
  352. package/dist/src/web-ui/app/components/session-search-disclosure.js +27 -0
  353. package/dist/src/web-ui/app/components/skills/workspace.js +7 -3
  354. package/dist/src/web-ui/app/components/spark-chat/panel.js +7 -3
  355. package/dist/src/web-ui/app/components/spark-chat/settings.js +57 -15
  356. package/dist/src/web-ui/app/components/tool-approval-card.d.ts +2 -1
  357. package/dist/src/web-ui/app/components/tool-approval-card.js +10 -2
  358. package/dist/src/web-ui/app/components/tool-approval-rejection-input.js +116 -0
  359. package/dist/src/web-ui/app/components/workspace-shell.js +30 -38
  360. package/dist/src/web-ui/app/components/workspace-transitions.js +42 -0
  361. package/dist/src/web-ui/app/configuration-feature.js +34 -4
  362. package/dist/src/web-ui/app/controllers/app-event-bindings.js +45 -29
  363. package/dist/src/web-ui/app/controllers/appearance-controller.js +105 -0
  364. package/dist/src/web-ui/app/controllers/automations-controller.js +9 -1
  365. package/dist/src/web-ui/app/controllers/composer-feature.d.ts +1 -1
  366. package/dist/src/web-ui/app/controllers/composer-feature.js +10 -3
  367. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +1 -1
  368. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +9 -3
  369. package/dist/src/web-ui/app/controllers/composer-submission-lifecycle.d.ts +1 -1
  370. package/dist/src/web-ui/app/controllers/conversation-workspace-activation.js +8 -2
  371. package/dist/src/web-ui/app/controllers/dashboard-approvals-controller.js +10 -9
  372. package/dist/src/web-ui/app/controllers/environment-transition.js +2 -2
  373. package/dist/src/web-ui/app/controllers/environment-workspace-preparation.js +9 -7
  374. package/dist/src/web-ui/app/controllers/preference-view-sync.js +35 -0
  375. package/dist/src/web-ui/app/controllers/projects-controller.d.ts +4 -0
  376. package/dist/src/web-ui/app/controllers/projects-controller.js +64 -3
  377. package/dist/src/web-ui/app/controllers/reasoning-budget-controller.d.ts +17 -0
  378. package/dist/src/web-ui/app/controllers/reasoning-budget-controller.js +80 -0
  379. package/dist/src/web-ui/app/controllers/reasoning-budget-menu-events.js +45 -0
  380. package/dist/src/web-ui/app/controllers/reasoning-mode-controller.js +35 -40
  381. package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts +6 -1
  382. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +16 -3
  383. package/dist/src/web-ui/app/controllers/session-controller.js +34 -9
  384. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +4 -3
  385. package/dist/src/web-ui/app/controllers/skills-controller.js +33 -16
  386. package/dist/src/web-ui/app/controllers/spark-chat-sync.js +1 -1
  387. package/dist/src/web-ui/app/controllers/spark-handoff-navigation.js +7 -1
  388. package/dist/src/web-ui/app/controllers/tool-approval-controller.d.ts +2 -1
  389. package/dist/src/web-ui/app/controllers/tool-approval-controller.js +36 -3
  390. package/dist/src/web-ui/app/controllers/workspace-conversation-opener.js +8 -2
  391. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +41 -10
  392. package/dist/src/web-ui/app/index.html +38 -32
  393. package/dist/src/web-ui/app/lib/color-palettes.d.ts +17 -0
  394. package/dist/src/web-ui/app/lib/color-palettes.js +20 -0
  395. package/dist/src/web-ui/app/lib/memory-activity-model.d.ts +12 -0
  396. package/dist/src/web-ui/app/lib/memory-activity-model.js +61 -0
  397. package/dist/src/web-ui/app/lib/navigation-display.d.ts +8 -0
  398. package/dist/src/web-ui/app/lib/navigation-display.js +12 -0
  399. package/dist/src/web-ui/app/lib/reasoning-controls.js +47 -6
  400. package/dist/src/web-ui/app/lib/reasoning-preference.d.ts +9 -0
  401. package/dist/src/web-ui/app/lib/reasoning-preference.js +75 -0
  402. package/dist/src/web-ui/app/lib/session-composer-queue.d.ts +4 -0
  403. package/dist/src/web-ui/app/lib/session-composer-queue.js +4 -0
  404. package/dist/src/web-ui/app/lib/session-project-groups.js +28 -0
  405. package/dist/src/web-ui/app/lib/session-sidebar-order.js +7 -5
  406. package/dist/src/web-ui/app/lib/tool-activity-event.d.ts +1 -0
  407. package/dist/src/web-ui/app/lib/tool-activity-event.js +1 -0
  408. package/dist/src/web-ui/app/lib/tool-activity-model.d.ts +1 -0
  409. package/dist/src/web-ui/app/lib/tool-activity-model.js +1 -0
  410. package/dist/src/web-ui/app/lib/tool-approval-rejection-drafts.js +45 -0
  411. package/dist/src/web-ui/app/lib/tool-skill-activity-fields.js +1 -1
  412. package/dist/src/web-ui/app/notifications-feature.js +10 -2
  413. package/dist/src/web-ui/app/passive-learning-feature.js +2 -2
  414. package/dist/src/web-ui/app/projects-feature.js +40 -10
  415. package/dist/src/web-ui/app/runtime-onboarding-feature.js +1 -0
  416. package/dist/src/web-ui/app/schedules-feature.js +28 -5
  417. package/dist/src/web-ui/app/services/client-preferences.d.ts +4 -1
  418. package/dist/src/web-ui/app/services/client-preferences.js +2 -0
  419. package/dist/src/web-ui/app/services/conversation-reasoning-preferences.d.ts +11 -0
  420. package/dist/src/web-ui/app/services/conversation-reasoning-preferences.js +30 -0
  421. package/dist/src/web-ui/app/services/runtime-web-client/automations.js +6 -4
  422. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +5 -0
  423. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +21 -0
  424. package/dist/src/web-ui/app/services/runtime-web-client/projects.d.ts +2 -1
  425. package/dist/src/web-ui/app/services/runtime-web-client/projects.js +4 -0
  426. package/dist/src/web-ui/app/services/runtime-web-client/tool-approvals.js +2 -0
  427. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +16 -0
  428. package/dist/src/web-ui/app/services/runtime-web-client.js +2 -0
  429. package/dist/src/web-ui/app/services/session-sidebar-preferences.js +33 -13
  430. package/dist/src/web-ui/app/skills-feature.js +2 -3
  431. package/dist/src/web-ui/app/spark-chat-conversation.js +29 -3
  432. package/dist/src/web-ui/app/spark-chat-feature.js +13 -7
  433. package/dist/src/web-ui/app/styles/01-color-palettes.css +90 -0
  434. package/dist/src/web-ui/app/styles/11-product-links.css +6 -2
  435. package/dist/src/web-ui/app/styles/11-workspace-header-width.css +37 -25
  436. package/dist/src/web-ui/app/styles/12-conversation-sidebar.css +56 -22
  437. package/dist/src/web-ui/app/styles/13-projects.css +56 -19
  438. package/dist/src/web-ui/app/styles/19-runtime-setup.css +16 -0
  439. package/dist/src/web-ui/app/styles/22-reasoning-budget.css +39 -0
  440. package/dist/src/web-ui/app/styles/27-conversation-memory.css +45 -0
  441. package/dist/src/web-ui/app/styles/27-conversation-skills.css +96 -0
  442. package/dist/src/web-ui/app/styles/28-tool-approval-card.css +38 -1
  443. package/dist/src/web-ui/app/styles/35-embedding-profiles.css +159 -0
  444. package/dist/src/web-ui/app/styles/54-spark-chat.css +62 -46
  445. package/dist/src/web-ui/app/styles/65-appearance.css +60 -0
  446. package/dist/src/web-ui/app/styles/66-navigation-display.css +30 -0
  447. package/dist/src/web-ui/app/styles/67-confirmation-dialog.css +32 -0
  448. package/dist/src/web-ui/app/styles.css +8 -0
  449. package/dist/src/web-ui/client-state/preference-shapes.js +6 -1
  450. package/dist/src/web-ui/client-state/preferences.js +8 -2
  451. package/dist/src/web-ui/client-state/reasoning-preference-shape.d.ts +1 -0
  452. package/dist/src/web-ui/client-state/reasoning-preference-shape.js +18 -0
  453. package/dist/src/web-ui/local-runtime/api-router.d.ts +1 -0
  454. package/dist/src/web-ui/local-runtime/api-router.js +11 -0
  455. package/dist/src/web-ui/local-runtime/memory-embedding-connection-input.d.ts +7 -0
  456. package/dist/src/web-ui/local-runtime/memory-embedding-connection-input.js +22 -0
  457. package/dist/src/web-ui/local-runtime/memory-embedding-connection-service.d.ts +20 -0
  458. package/dist/src/web-ui/local-runtime/memory-embedding-connection-service.js +47 -0
  459. package/dist/src/web-ui/local-runtime/memory-onboarding-routes.js +32 -0
  460. package/dist/src/web-ui/local-runtime/model-connection-inspection.d.ts +7 -0
  461. package/dist/src/web-ui/local-runtime/model-connection-inspection.js +48 -0
  462. package/dist/src/web-ui/local-runtime/model-setup-catalog.d.ts +2 -1
  463. package/dist/src/web-ui/local-runtime/model-setup-catalog.js +3 -1
  464. package/dist/src/web-ui/local-runtime/model-setup-identity.js +1 -1
  465. package/dist/src/web-ui/local-runtime/model-setup-input.d.ts +5 -2
  466. package/dist/src/web-ui/local-runtime/model-setup-input.js +29 -6
  467. package/dist/src/web-ui/local-runtime/model-setup-provider.d.ts +1 -1
  468. package/dist/src/web-ui/local-runtime/model-setup-provider.js +9 -6
  469. package/dist/src/web-ui/local-runtime/model-setup-retry.js +4 -1
  470. package/dist/src/web-ui/local-runtime/model-setup-service.d.ts +2 -1
  471. package/dist/src/web-ui/local-runtime/pending-tool-approvals.js +4 -1
  472. package/dist/src/web-ui/local-runtime/project-routes.js +10 -2
  473. package/dist/src/web-ui/local-runtime/request-execution.js +1 -0
  474. package/dist/src/web-ui/local-runtime/runtime-setup-auth.d.ts +2 -0
  475. package/dist/src/web-ui/local-runtime/runtime-setup-auth.js +20 -0
  476. package/dist/src/web-ui/local-runtime/runtime-setup-connection-edit.js +3 -2
  477. package/dist/src/web-ui/local-runtime/runtime-setup-credential-completion.js +6 -1
  478. package/dist/src/web-ui/local-runtime/runtime-setup-input.d.ts +3 -2
  479. package/dist/src/web-ui/local-runtime/runtime-setup-input.js +17 -5
  480. package/dist/src/web-ui/local-runtime/runtime-setup-provider.d.ts +4 -1
  481. package/dist/src/web-ui/local-runtime/runtime-setup-provider.js +6 -2
  482. package/dist/src/web-ui/local-runtime/runtime-setup-routes.d.ts +11 -2
  483. package/dist/src/web-ui/local-runtime/runtime-setup-routes.js +11 -2
  484. package/dist/src/web-ui/local-runtime/runtime-setup-scaffold.js +3 -2
  485. package/dist/src/web-ui/local-runtime/runtime-setup-service.d.ts +25 -4
  486. package/dist/src/web-ui/local-runtime/runtime-setup-service.js +19 -9
  487. package/dist/src/web-ui/local-runtime/setup-embedding-input.d.ts +3 -1
  488. package/dist/src/web-ui/local-runtime/setup-embedding-input.js +38 -6
  489. package/dist/src/web-ui/local-runtime/setup-embedding-llamacpp.d.ts +11 -0
  490. package/dist/src/web-ui/local-runtime/setup-embedding-llamacpp.js +53 -0
  491. package/dist/src/web-ui/local-runtime/setup-embedding-provider.js +23 -9
  492. package/dist/src/web-ui/local-runtime/setup-embedding-routes.d.ts +7 -2
  493. package/dist/src/web-ui/local-runtime/setup-embedding-routes.js +5 -3
  494. package/dist/src/web-ui/local-runtime/setup-embedding-service.d.ts +1 -0
  495. package/docs/configuration.md +10 -8
  496. package/docs/installation.md +11 -5
  497. package/docs/llamacpp.md +248 -0
  498. package/docs/long-term-memory.md +12 -0
  499. package/docs/running-locally.md +7 -1
  500. package/package.json +2 -1
  501. package/plugins/project-orientation/source/index.ts +2 -3
  502. package/plugins/project-orientation/source/inspection-failure.ts +1 -1
  503. package/plugins/project-orientation/source/project-target.ts +29 -0
  504. package/plugins/project-orientation/src/index.cjs +21 -2
  505. package/runtime.config.schema.json +140 -0
  506. package/src/runtime/README.md +50 -4
@@ -0,0 +1,73 @@
1
+ import { resolveLlamaCppUrls } from "./settings.js";
2
+ const MAX_RESPONSE_BYTES = 256 * 1024;
3
+ const CONNECTION_TIMEOUT_MS = 5000;
4
+ async function readBoundedJson(response) {
5
+ if (!response.ok)
6
+ throw new Error(`llamacpp_connection_http_${response.status}`);
7
+ if (!response.body)
8
+ throw new Error("llamacpp_connection_empty_response");
9
+ const reader = response.body.getReader();
10
+ const chunks = [];
11
+ let bytes = 0;
12
+ try {
13
+ while (true) {
14
+ const next = await reader.read();
15
+ if (next.done)
16
+ break;
17
+ bytes += next.value.byteLength;
18
+ if (bytes > MAX_RESPONSE_BYTES)
19
+ throw new Error("llamacpp_connection_response_too_large");
20
+ chunks.push(next.value);
21
+ }
22
+ return JSON.parse(Buffer.concat(chunks).toString("utf8"));
23
+ }
24
+ finally {
25
+ void reader.cancel().catch(() => { });
26
+ reader.releaseLock();
27
+ }
28
+ }
29
+ function record(value) {
30
+ return !!value && typeof value === "object" && !Array.isArray(value);
31
+ }
32
+ /** Explicit read-only connection check; model capabilities remain user declarations. */
33
+ export async function inspectLlamaCppConnection(params) {
34
+ const { serverUrl, apiUrl } = resolveLlamaCppUrls(params.baseUrl.trim());
35
+ const controller = new AbortController();
36
+ const timeout = setTimeout(() => controller.abort(new Error("llamacpp_connection_timeout")), CONNECTION_TIMEOUT_MS);
37
+ const signal = params.signal ? AbortSignal.any([params.signal, controller.signal]) : controller.signal;
38
+ const headers = { Accept: "application/json" };
39
+ if (params.apiKey)
40
+ headers.Authorization = `Bearer ${params.apiKey}`;
41
+ const fetchImpl = params.fetchImpl ?? fetch;
42
+ try {
43
+ const health = await readBoundedJson(await fetchImpl(`${serverUrl}/health`, { headers, signal }));
44
+ if (!record(health) || health.status !== "ok")
45
+ throw new Error("llamacpp_connection_not_ready");
46
+ const catalog = await readBoundedJson(await fetchImpl(`${apiUrl}/models`, { headers, signal }));
47
+ if (!record(catalog) || !Array.isArray(catalog.data) || catalog.data.length > 128) {
48
+ throw new Error("llamacpp_connection_models_invalid");
49
+ }
50
+ const models = catalog.data.map((entry) => {
51
+ if (!record(entry) || typeof entry.id !== "string" || !entry.id.trim() || entry.id.length > 512) {
52
+ throw new Error("llamacpp_connection_models_invalid");
53
+ }
54
+ return entry.id;
55
+ });
56
+ if (!models.length)
57
+ throw new Error("llamacpp_connection_no_models");
58
+ return { models: Object.freeze([...new Set(models)]) };
59
+ }
60
+ catch (error) {
61
+ if (controller.signal.aborted)
62
+ throw new Error("llamacpp_connection_timeout");
63
+ if (params.signal?.aborted)
64
+ throw params.signal.reason;
65
+ if (error instanceof Error && /^llamacpp_connection_/.test(error.message))
66
+ throw error;
67
+ // Never expose fetched content, credentials or a URL from a network error.
68
+ throw new Error("llamacpp_connection_failed");
69
+ }
70
+ finally {
71
+ clearTimeout(timeout);
72
+ }
73
+ }
@@ -0,0 +1,2 @@
1
+ import type { ModelProviderInvocationParams } from "../contracts.js";
2
+ export declare function emitLlamaCppStreamTermination(params: ModelProviderInvocationParams, startedAt: number, error?: unknown): void;
@@ -0,0 +1,17 @@
1
+ import { traceDebug } from "../../../runtime/observability/debug-logger.js";
2
+ export function emitLlamaCppStreamTermination(params, startedAt, error) {
3
+ const aborted = !!error && typeof error === "object" && "name" in error && error.name === "AbortError";
4
+ traceDebug("model-gateway.server", "llamacpp.stream.terminated", {
5
+ requestId: params.requestBody.debugRequestId ?? "",
6
+ endpoint: params.endpoint, modelStep: params.requestBody.modelStep ?? "",
7
+ profileId: params.invocation.profile.id, providerId: params.invocation.profile.providerId,
8
+ provider: "llamacpp", model: params.invocation.model, elapsedMs: Date.now() - startedAt,
9
+ outcome: error === undefined ? "completed" : aborted ? "aborted" : "failed",
10
+ abortRequested: aborted,
11
+ ...(params.invocation.think !== undefined ? { reasoningEffort: params.invocation.think } : {}),
12
+ ...(params.invocation.reasoningBudget ? { reasoningBudget: params.invocation.reasoningBudget } : {}),
13
+ ...(params.invocation.reasoningControlSource ? { reasoningControlSource: params.invocation.reasoningControlSource } : {}),
14
+ ...(error !== undefined ? { error: error instanceof Error
15
+ ? { name: error.name, message: error.message } : { name: "Error", message: String(error) } } : {}),
16
+ });
17
+ }
@@ -0,0 +1,2 @@
1
+ import type { ModelProviderEmbeddingParams, ModelProviderEmbeddingResult } from "../contracts.js";
2
+ export declare function embedWithLlamaCpp(params: ModelProviderEmbeddingParams): Promise<ModelProviderEmbeddingResult>;
@@ -0,0 +1,56 @@
1
+ import { createEmbeddingModelFingerprint } from "../../embeddings/fingerprint.js";
2
+ import { validateEmbeddingVectors } from "../../embeddings/validation.js";
3
+ import { readOpenAiCompatibleEmbeddingVectors } from "../../protocol/openai-embedding-response.js";
4
+ import { resolveLlamaCppProviderSettings } from "./settings.js";
5
+ export async function embedWithLlamaCpp(params) {
6
+ let settings;
7
+ try {
8
+ settings = resolveLlamaCppProviderSettings(params.profile.providerConfig);
9
+ }
10
+ catch (error) {
11
+ return {
12
+ kind: "error",
13
+ statusCode: 500,
14
+ message: error instanceof Error ? error.message : "llamacpp_configuration_invalid",
15
+ };
16
+ }
17
+ const response = await params.fetchImpl(`${settings.apiUrl}/embeddings`, {
18
+ method: "POST",
19
+ headers: settings.headers,
20
+ body: JSON.stringify({
21
+ ...params.profile.options,
22
+ model: params.profile.model,
23
+ input: params.texts,
24
+ encoding_format: "float",
25
+ }),
26
+ });
27
+ if (!response.ok) {
28
+ return {
29
+ kind: "error",
30
+ statusCode: response.status || 502,
31
+ message: (await response.text()) || "llamacpp embedding error",
32
+ };
33
+ }
34
+ const body = await response.json().catch((error) => {
35
+ if (error instanceof SyntaxError)
36
+ return undefined;
37
+ throw error;
38
+ });
39
+ const vectors = readLlamaCppEmbeddingVectors(body, params.texts.length);
40
+ return Object.freeze({
41
+ kind: "embedded",
42
+ vectors: validateEmbeddingVectors({
43
+ vectors,
44
+ expectedCount: params.texts.length,
45
+ }),
46
+ modelFingerprint: createEmbeddingModelFingerprint(params.profile, settings.apiUrl),
47
+ });
48
+ }
49
+ function readLlamaCppEmbeddingVectors(value, expectedCount) {
50
+ if (value === null || typeof value !== "object" || Array.isArray(value))
51
+ return [];
52
+ const data = value.data;
53
+ if (!Array.isArray(data) || data.length !== expectedCount)
54
+ return [];
55
+ return readOpenAiCompatibleEmbeddingVectors(value, expectedCount);
56
+ }
@@ -0,0 +1,3 @@
1
+ import type { ModelProviderInputTokenCountParams, ModelProviderInputTokenCountResult } from "../contracts.js";
2
+ /** Counts the identical chat envelope through llama.cpp's non-generating native endpoint. */
3
+ export declare function countLlamaCppInputTokens(params: ModelProviderInputTokenCountParams): Promise<ModelProviderInputTokenCountResult>;
@@ -0,0 +1,59 @@
1
+ import { toolMediaSafeError, toolMediaSafeMessage } from "../../observability/tool-media-privacy.js";
2
+ import { createProviderEnvelopeFingerprint } from "../envelope-budget.js";
3
+ import { buildLlamaCppChatPayload } from "./payload.js";
4
+ import { resolveLlamaCppProviderSettings } from "./settings.js";
5
+ function readLlamaCppInputTokenCount(value) {
6
+ if (value === null || typeof value !== "object" || Array.isArray(value))
7
+ return undefined;
8
+ const count = value.input_tokens;
9
+ return isLlamaCppInputTokenCount(count) ? count : undefined;
10
+ }
11
+ function isLlamaCppInputTokenCount(value) {
12
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
13
+ }
14
+ /** Counts the identical chat envelope through llama.cpp's non-generating native endpoint. */
15
+ export async function countLlamaCppInputTokens(params) {
16
+ let settings;
17
+ try {
18
+ settings = resolveLlamaCppProviderSettings(params.invocation.profile.providerConfig);
19
+ }
20
+ catch (error) {
21
+ return {
22
+ kind: "error",
23
+ statusCode: 500,
24
+ message: toolMediaSafeMessage(error instanceof Error ? error.message : "llamacpp_configuration_invalid", params.requestBody),
25
+ };
26
+ }
27
+ const payload = buildLlamaCppChatPayload(params);
28
+ const response = await params.fetchImpl(`${settings.apiUrl}/chat/completions/input_tokens`, {
29
+ method: "POST",
30
+ headers: settings.headers,
31
+ body: JSON.stringify(payload),
32
+ }).catch((error) => { throw toolMediaSafeError(error, params.requestBody); });
33
+ if (!response.ok) {
34
+ const message = await response.text();
35
+ return {
36
+ kind: "error",
37
+ statusCode: response.status || 502,
38
+ message: toolMediaSafeMessage(message || "llamacpp input token count error", params.requestBody),
39
+ };
40
+ }
41
+ const body = await response.json().catch((error) => {
42
+ if (error instanceof SyntaxError)
43
+ return undefined;
44
+ throw error;
45
+ });
46
+ const inputTokens = readLlamaCppInputTokenCount(body);
47
+ if (inputTokens === undefined) {
48
+ return {
49
+ kind: "error",
50
+ statusCode: 502,
51
+ message: "llamacpp input token count response invalid",
52
+ };
53
+ }
54
+ return {
55
+ kind: "counted",
56
+ inputTokens,
57
+ providerEnvelopeFingerprint: createProviderEnvelopeFingerprint(payload),
58
+ };
59
+ }
@@ -0,0 +1,2 @@
1
+ import type { ModelGatewayRequest, ResolvedModelInvocation } from "../../types.js";
2
+ export declare function projectLlamaCppMessages(request: ModelGatewayRequest, invocation: ResolvedModelInvocation, endpoint: "chat" | "raw"): Record<string, unknown>[];
@@ -0,0 +1,33 @@
1
+ import { hasModelGatewayToolInteractionLane, isAssistantToolCallMessage, isTextChatMessage, isToolResultMessage, validateModelGatewayMessages, } from "../../protocol/message-contract.js";
2
+ export function projectLlamaCppMessages(request, invocation, endpoint) {
3
+ validateModelGatewayMessages(request.messages);
4
+ if (endpoint === "raw" && hasModelGatewayToolInteractionLane(request.messages)) {
5
+ throw new TypeError("model_gateway_raw_tool_interaction_unsupported");
6
+ }
7
+ const input = Array.isArray(request.messages) && request.messages.length > 0
8
+ ? request.messages
9
+ : [{ role: "user", content: request.prompt ?? request.text ?? "" }];
10
+ const messages = input.map((message) => {
11
+ if (message?.attachments?.length)
12
+ throw new TypeError("llamacpp_image_input_unsupported");
13
+ if (isAssistantToolCallMessage(message)) {
14
+ return {
15
+ role: "assistant", content: "",
16
+ tool_calls: message.toolCalls.map((call) => ({
17
+ id: call.callId, type: "function",
18
+ function: { name: call.name, arguments: call.arguments },
19
+ })),
20
+ };
21
+ }
22
+ if (isToolResultMessage(message)) {
23
+ return { role: "tool", tool_call_id: message.toolCallId, name: message.toolName, content: message.content };
24
+ }
25
+ if (!isTextChatMessage(message))
26
+ throw new TypeError("llamacpp_message_invalid");
27
+ return { role: message.role, content: message.content };
28
+ });
29
+ const instructions = (invocation.instructions ?? []).map((line) => line.trim()).filter(Boolean);
30
+ return instructions.length
31
+ ? [{ role: "system", content: instructions.join("\n") }, ...messages]
32
+ : messages;
33
+ }
@@ -0,0 +1,2 @@
1
+ import type { ModelProviderInvocationParams } from "../contracts.js";
2
+ export declare function buildLlamaCppChatPayload({ requestBody, invocation, endpoint }: Pick<ModelProviderInvocationParams, "requestBody" | "invocation" | "endpoint">): Record<string, unknown>;
@@ -0,0 +1,44 @@
1
+ import { isFiniteReasoningBudgetTokens } from "../../../shared/model-reasoning.js";
2
+ import { resolveModelGatewayFormat } from "../../structured-output/format-contract.js";
3
+ import { projectLlamaCppMessages } from "./message-projection.js";
4
+ import { projectLlamaCppFormat } from "./schema-format.js";
5
+ function nativeReasoningBudgetTokens(budget) {
6
+ if (budget.mode === "server-default")
7
+ return -1;
8
+ if (!isFiniteReasoningBudgetTokens(budget.tokens))
9
+ throw new TypeError("llamacpp_reasoning_budget_invalid");
10
+ return budget.tokens;
11
+ }
12
+ export function buildLlamaCppChatPayload({ requestBody, invocation, endpoint }) {
13
+ const payload = {
14
+ model: invocation.model,
15
+ messages: projectLlamaCppMessages(requestBody, invocation, endpoint),
16
+ stream: true,
17
+ stream_options: { include_usage: true },
18
+ reasoning_format: "deepseek",
19
+ };
20
+ const generation = invocation.profile.generation;
21
+ if (typeof generation.temperature === "number" && Number.isFinite(generation.temperature)) {
22
+ payload.temperature = generation.temperature;
23
+ }
24
+ if (typeof generation.topP === "number" && Number.isFinite(generation.topP)) {
25
+ payload.top_p = generation.topP;
26
+ }
27
+ const format = projectLlamaCppFormat(resolveModelGatewayFormat(requestBody.format, invocation.format));
28
+ if (format)
29
+ payload.response_format = format;
30
+ if (invocation.think !== undefined) {
31
+ payload.reasoning_effort = invocation.think;
32
+ payload.chat_template_kwargs = { enable_thinking: invocation.think !== "none" };
33
+ }
34
+ const thinkingIsDisabled = invocation.think === "none";
35
+ if (thinkingIsDisabled) {
36
+ payload.reasoning_budget_tokens = 0;
37
+ return payload;
38
+ }
39
+ if (invocation.reasoningBudget) {
40
+ payload.reasoning_budget_tokens = nativeReasoningBudgetTokens(invocation.reasoningBudget);
41
+ payload.chat_template_kwargs = { enable_thinking: true };
42
+ }
43
+ return payload;
44
+ }
@@ -0,0 +1 @@
1
+ export declare function bindLlamaCppResponseLifetime(response: Response): Response;
@@ -0,0 +1,56 @@
1
+ import { SseDataDecoder } from "../../protocol/sse-data.js";
2
+ import { LlamaCppChatStreamNormalizer } from "./stream-normalizer.js";
3
+ // End the upstream body before tracing tees it. A native finish chunk precedes
4
+ // usage, so only the final marker/error ends transport; the normalizer validates.
5
+ export function bindLlamaCppResponseLifetime(response) {
6
+ if (!response.ok || !response.body)
7
+ return response;
8
+ const reader = response.body.getReader();
9
+ const decoder = new SseDataDecoder();
10
+ const normalizer = new LlamaCppChatStreamNormalizer();
11
+ let stopped = false;
12
+ const cancel = (reason) => {
13
+ stopped = true;
14
+ void reader.cancel(reason).catch(() => { });
15
+ reader.releaseLock();
16
+ };
17
+ const body = new ReadableStream({
18
+ async pull(controller) {
19
+ try {
20
+ const { done, value } = await reader.read();
21
+ if (stopped)
22
+ return;
23
+ if (done) {
24
+ stopped = true;
25
+ controller.close();
26
+ reader.releaseLock();
27
+ return;
28
+ }
29
+ let terminal = false;
30
+ for (const frame of decoder.accept(value)) {
31
+ try {
32
+ normalizer.consume(frame);
33
+ }
34
+ catch {
35
+ terminal = true;
36
+ break;
37
+ }
38
+ }
39
+ terminal ||= normalizer.hasTerminated;
40
+ controller.enqueue(value);
41
+ if (terminal) {
42
+ controller.close();
43
+ cancel();
44
+ }
45
+ }
46
+ catch (error) {
47
+ if (stopped)
48
+ return;
49
+ controller.error(error);
50
+ cancel(error);
51
+ }
52
+ },
53
+ cancel,
54
+ });
55
+ return new Response(body, { status: response.status, statusText: response.statusText, headers: response.headers });
56
+ }
@@ -0,0 +1,2 @@
1
+ import type { ModelGatewayFormat } from "../../types.js";
2
+ export declare function projectLlamaCppFormat(format?: ModelGatewayFormat): Record<string, unknown> | undefined;
@@ -0,0 +1,29 @@
1
+ import { isModelGatewayJsonSchemaFormat, isPlainObject, rejectMisplacedProjectionMetadata, } from "../../structured-output/format-contract.js";
2
+ // llama.cpp consumes the schema as grammar; do not inject it into model messages
3
+ // or drop constraints just because another provider cannot represent them.
4
+ export function projectLlamaCppFormat(format) {
5
+ if (format === undefined)
6
+ return undefined;
7
+ if (format === "json")
8
+ return { type: "json_object" };
9
+ if (isModelGatewayJsonSchemaFormat(format)) {
10
+ return {
11
+ type: "json_schema",
12
+ json_schema: {
13
+ name: format.name, schema: format.schema,
14
+ ...(format.description !== undefined ? { description: format.description } : {}),
15
+ ...(format.strict !== undefined ? { strict: format.strict } : {}),
16
+ },
17
+ };
18
+ }
19
+ if (!isPlainObject(format))
20
+ throw new TypeError("llamacpp_format_invalid");
21
+ rejectMisplacedProjectionMetadata(format);
22
+ if (format.type === "text")
23
+ return undefined;
24
+ if (format.type === "json_object")
25
+ return { type: "json_object" };
26
+ if (format.type === "json_schema")
27
+ throw new TypeError("llamacpp_json_schema_wrapper_invalid");
28
+ return { type: "json_schema", json_schema: { name: "runtime_output", schema: format } };
29
+ }
@@ -0,0 +1,9 @@
1
+ import type { ModelGatewayProviderConfig } from "../../types.js";
2
+ export declare function resolveLlamaCppUrls(baseUrl: string): {
3
+ apiUrl: string;
4
+ serverUrl: string;
5
+ };
6
+ export declare function resolveLlamaCppProviderSettings(config?: ModelGatewayProviderConfig): {
7
+ apiUrl: string;
8
+ headers: Record<string, string>;
9
+ };
@@ -0,0 +1,25 @@
1
+ export function resolveLlamaCppUrls(baseUrl) {
2
+ const url = new URL(baseUrl);
3
+ if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) {
4
+ throw new TypeError("llamacpp_base_url_invalid");
5
+ }
6
+ const root = url.toString().replace(/\/+$/, "");
7
+ const serverUrl = root.endsWith("/v1") ? root.slice(0, -3) : root;
8
+ return { serverUrl, apiUrl: `${serverUrl}/v1` };
9
+ }
10
+ export function resolveLlamaCppProviderSettings(config) {
11
+ if (!config?.baseUrl?.trim())
12
+ throw new TypeError("llamacpp_base_url_required");
13
+ const { apiUrl } = resolveLlamaCppUrls(config.baseUrl.trim());
14
+ const headers = { "Content-Type": "application/json" };
15
+ if (config.apiKeyEnv !== undefined) {
16
+ if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(config.apiKeyEnv)) {
17
+ throw new TypeError("llamacpp_api_key_env_invalid");
18
+ }
19
+ const apiKey = process.env[config.apiKeyEnv]?.trim();
20
+ if (!apiKey)
21
+ throw new TypeError(`missing llama.cpp API key env: ${config.apiKeyEnv}`);
22
+ headers.Authorization = `Bearer ${apiKey}`;
23
+ }
24
+ return { apiUrl, headers };
25
+ }
@@ -0,0 +1,10 @@
1
+ import type { ModelGatewayEvent } from "../../types.js";
2
+ export declare class LlamaCppChatStreamNormalizer {
3
+ private finishReason;
4
+ private responseId;
5
+ private usage;
6
+ private terminated;
7
+ get hasTerminated(): boolean;
8
+ consume(data: string): ModelGatewayEvent[];
9
+ finish(): void;
10
+ }
@@ -0,0 +1,85 @@
1
+ import { buildModelTokenUsage } from "../../protocol/usage.js";
2
+ function record(value) {
3
+ return !!value && typeof value === "object" && !Array.isArray(value);
4
+ }
5
+ function fail(code) { throw new Error(`llamacpp_stream_${code}`); }
6
+ export class LlamaCppChatStreamNormalizer {
7
+ finishReason;
8
+ responseId;
9
+ usage;
10
+ terminated = false;
11
+ get hasTerminated() { return this.terminated; }
12
+ consume(data) {
13
+ if (this.terminated)
14
+ return [];
15
+ if (data === "[DONE]") {
16
+ if (!this.finishReason)
17
+ fail("completion_missing");
18
+ this.terminated = true;
19
+ return [{ type: "done", done: true, doneReason: this.finishReason, ...(this.usage ? { usage: this.usage } : {}) }];
20
+ }
21
+ let chunk;
22
+ try {
23
+ chunk = JSON.parse(data);
24
+ }
25
+ catch {
26
+ return fail("json_invalid");
27
+ }
28
+ if (!record(chunk))
29
+ fail("chunk_invalid");
30
+ if (chunk.error !== undefined)
31
+ fail("provider_error");
32
+ if (typeof chunk.id === "string") {
33
+ if (this.responseId !== undefined && this.responseId !== chunk.id)
34
+ fail("response_identity_changed");
35
+ this.responseId = chunk.id;
36
+ }
37
+ if (record(chunk.usage)) {
38
+ const promptDetails = record(chunk.usage.prompt_tokens_details) ? chunk.usage.prompt_tokens_details : {};
39
+ const completionDetails = record(chunk.usage.completion_tokens_details) ? chunk.usage.completion_tokens_details : {};
40
+ this.usage = buildModelTokenUsage({
41
+ inputTokens: chunk.usage.prompt_tokens, outputTokens: chunk.usage.completion_tokens,
42
+ totalTokens: chunk.usage.total_tokens, cachedInputTokens: promptDetails.cached_tokens,
43
+ reasoningTokens: completionDetails.reasoning_tokens,
44
+ });
45
+ }
46
+ if (!Array.isArray(chunk.choices))
47
+ fail("choices_invalid");
48
+ if (chunk.choices.length === 0)
49
+ return [];
50
+ if (chunk.choices.length !== 1)
51
+ fail("multiple_choices");
52
+ const choice = chunk.choices[0];
53
+ if (!record(choice) || choice.index !== 0 || !record(choice.delta))
54
+ fail("choice_invalid");
55
+ const delta = choice.delta;
56
+ if (delta.tool_calls !== undefined || delta.function_call !== undefined)
57
+ fail("unexpected_tool_call");
58
+ if (delta.refusal)
59
+ fail("refusal");
60
+ const events = [];
61
+ for (const [key, type] of [["reasoning_content", "thinking"], ["content", "content"]]) {
62
+ const value = delta[key];
63
+ if (value === undefined || value === null || value === "")
64
+ continue;
65
+ if (typeof value !== "string")
66
+ fail("delta_invalid");
67
+ if (this.finishReason)
68
+ fail("content_after_completion");
69
+ events.push({ type, text: value });
70
+ }
71
+ if (choice.finish_reason !== undefined && choice.finish_reason !== null) {
72
+ if (this.finishReason)
73
+ fail("duplicate_completion");
74
+ if (choice.finish_reason !== "stop" && choice.finish_reason !== "length")
75
+ fail("completion_reason_unsupported");
76
+ this.finishReason = choice.finish_reason;
77
+ }
78
+ return events;
79
+ }
80
+ finish() {
81
+ // A transport EOF or [DONE] alone must never authorize partial output.
82
+ if (!this.terminated)
83
+ fail("incomplete");
84
+ }
85
+ }
@@ -0,0 +1,9 @@
1
+ import type { ModelTokenUsage } from "../../types.js";
2
+ import type { ModelProviderEventSink } from "../contracts.js";
3
+ export declare function forwardLlamaCppChatStream(body: ReadableStream<Uint8Array>, writer: ModelProviderEventSink): Promise<void>;
4
+ export declare function collectLlamaCppChatStream(body: ReadableStream<Uint8Array>): Promise<{
5
+ text: string;
6
+ thinking: string;
7
+ usage?: ModelTokenUsage;
8
+ doneReason?: string;
9
+ }>;
@@ -0,0 +1,33 @@
1
+ import { readSseDataFrames } from "../../protocol/sse-data.js";
2
+ import { LlamaCppChatStreamNormalizer } from "./stream-normalizer.js";
3
+ export async function forwardLlamaCppChatStream(body, writer) {
4
+ const normalizer = new LlamaCppChatStreamNormalizer();
5
+ for await (const frame of readSseDataFrames(body)) {
6
+ for (const event of normalizer.consume(frame))
7
+ writer.emit(event);
8
+ if (normalizer.hasTerminated)
9
+ return;
10
+ }
11
+ normalizer.finish();
12
+ }
13
+ export async function collectLlamaCppChatStream(body) {
14
+ let text = "";
15
+ let thinking = "";
16
+ let usage;
17
+ let doneReason;
18
+ await forwardLlamaCppChatStream(body, {
19
+ emit(event) {
20
+ if (event.type === "content")
21
+ text += event.text;
22
+ else if (event.type === "thinking")
23
+ thinking += event.text;
24
+ else if (event.type === "error")
25
+ throw new Error(event.error);
26
+ else {
27
+ usage = event.usage;
28
+ doneReason = event.doneReason ?? undefined;
29
+ }
30
+ },
31
+ });
32
+ return { text, thinking, ...(usage ? { usage } : {}), ...(doneReason ? { doneReason } : {}) };
33
+ }
@@ -1,5 +1,6 @@
1
1
  import { createEmbeddingModelFingerprint } from "../../embeddings/fingerprint.js";
2
2
  import { validateEmbeddingVectors } from "../../embeddings/validation.js";
3
+ import { readOpenAiCompatibleEmbeddingVectors } from "../../protocol/openai-embedding-response.js";
3
4
  const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
4
5
  const DEFAULT_OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
5
6
  const ENV_VAR_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -33,7 +34,7 @@ export async function embedWithOpenAI(params) {
33
34
  };
34
35
  }
35
36
  const body = await response.json().catch(() => undefined);
36
- const vectors = readOrderedVectors(body, params.texts.length);
37
+ const vectors = readOpenAiCompatibleEmbeddingVectors(body, params.texts.length);
37
38
  return Object.freeze({
38
39
  kind: "embedded",
39
40
  vectors: validateEmbeddingVectors({
@@ -57,31 +58,3 @@ function resolveEmbeddingSettings(params) {
57
58
  ...(apiKey ? { apiKey } : {}),
58
59
  };
59
60
  }
60
- function readOrderedVectors(value, expectedCount) {
61
- const body = value && typeof value === "object" && !Array.isArray(value)
62
- ? value
63
- : undefined;
64
- if (!body || !Array.isArray(body.data)) {
65
- return [];
66
- }
67
- const entries = body.data.filter(isRecord);
68
- if (!hasContiguousIndices(entries, expectedCount)) {
69
- return [];
70
- }
71
- return [...entries]
72
- .sort((left, right) => Number(left.index) - Number(right.index))
73
- .map((entry) => entry.embedding);
74
- }
75
- function hasContiguousIndices(entries, expectedCount) {
76
- if (entries.length !== expectedCount) {
77
- return false;
78
- }
79
- const indices = new Set(entries.map(({ index }) => index));
80
- return (indices.size === expectedCount &&
81
- [...indices].every((index) => Number.isSafeInteger(index) &&
82
- Number(index) >= 0 &&
83
- Number(index) < expectedCount));
84
- }
85
- function isRecord(value) {
86
- return value !== null && typeof value === "object" && !Array.isArray(value);
87
- }
@@ -1,9 +1 @@
1
- export declare class OpenAISseDataDecoder {
2
- private readonly decoder;
3
- private line;
4
- private data;
5
- private afterCr;
6
- accept(bytes: Uint8Array): string[];
7
- private acceptLine;
8
- }
9
- export declare function readOpenAIDataFrames(body: ReadableStream<Uint8Array>): AsyncGenerator<string>;
1
+ export { SseDataDecoder as OpenAISseDataDecoder, readSseDataFrames as readOpenAIDataFrames } from "../../protocol/sse-data.js";