theorum 0.1.3 → 0.1.4

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 (187) hide show
  1. package/README.md +30 -9
  2. package/deno.json +57 -0
  3. package/deno.lock +469 -0
  4. package/{esm/mod.d.ts → mod.ts} +57 -15
  5. package/package.json +35 -44
  6. package/src/cli/commands/profile.ts +57 -0
  7. package/src/cli/commands/run.ts +66 -0
  8. package/src/cli/commands/test.ts +195 -0
  9. package/src/cli/index.ts +161 -0
  10. package/src/cli/matrix/fixtures.ts +96 -0
  11. package/src/cli/matrix/synthesizer.ts +240 -0
  12. package/src/guardrails/error.ts +142 -0
  13. package/src/guardrails/injection.ts +254 -0
  14. package/src/guardrails/mod.ts +40 -0
  15. package/src/guardrails/quota.ts +87 -0
  16. package/src/guardrails/sanitize.ts +165 -0
  17. package/src/guardrails/sensitive.ts +96 -0
  18. package/src/host/mint-trace.ts +54 -0
  19. package/{esm/src/host/mod.js → src/host/mod.ts} +11 -3
  20. package/src/host/reply.ts +32 -0
  21. package/src/kernel/engine/assert.ts +29 -0
  22. package/src/kernel/engine/boundary.ts +75 -0
  23. package/src/kernel/engine/delta.ts +440 -0
  24. package/src/kernel/engine/hash.ts +11 -0
  25. package/src/kernel/engine/record.ts +8 -0
  26. package/src/kernel/engine/repair.ts +56 -0
  27. package/src/kernel/engine/runner/gates.ts +338 -0
  28. package/src/kernel/engine/runner/mod.ts +135 -0
  29. package/src/kernel/engine/runner/state.ts +31 -0
  30. package/src/kernel/engine/runner/steps.ts +183 -0
  31. package/src/kernel/engine/runner/stream.ts +83 -0
  32. package/src/kernel/engine/runner/tokens.ts +47 -0
  33. package/src/kernel/engine/runner/tools.ts +266 -0
  34. package/{esm/src/kernel/engine/runner.d.ts → src/kernel/engine/runner.ts} +2 -1
  35. package/src/kernel/engine/tree.ts +18 -0
  36. package/src/kernel/mod.ts +39 -0
  37. package/src/kernel/registry/attachments.ts +195 -0
  38. package/src/kernel/registry/catalog.ts +181 -0
  39. package/src/kernel/registry/ingress.ts +223 -0
  40. package/src/kernel/registry/profiles.ts +165 -0
  41. package/src/kernel/registry/provider-request.ts +31 -0
  42. package/src/kernel/registry/resolve.ts +290 -0
  43. package/src/kernel/registry/schemas.ts +29 -0
  44. package/src/kernel/registry/tools.ts +45 -0
  45. package/{esm/src/kernel/registry/vault.d.ts → src/kernel/registry/vault.ts} +17 -2
  46. package/src/kernel/types.ts +576 -0
  47. package/{esm/src/observability/mod.js → src/observability/mod.ts} +11 -2
  48. package/src/observability/spans.ts +70 -0
  49. package/src/observability/trace-attach.ts +96 -0
  50. package/src/observability/trace-record.ts +254 -0
  51. package/src/observability/trace-usage.ts +36 -0
  52. package/src/observability/trace.ts +143 -0
  53. package/src/presets/google.ts +147 -0
  54. package/src/presets/mod.ts +24 -0
  55. package/src/providers/create-provider.ts +64 -0
  56. package/src/providers/gemini-tape.ts +59 -0
  57. package/src/providers/google-tap.ts +57 -0
  58. package/src/providers/interactions.ts +182 -0
  59. package/src/providers/keys.ts +182 -0
  60. package/{esm/src/providers/mod.js → src/providers/mod.ts} +4 -2
  61. package/{esm/src/providers/openrouter-mod.js → src/providers/openrouter-mod.ts} +7 -3
  62. package/src/providers/openrouter-payload.ts +232 -0
  63. package/src/providers/openrouter.ts +758 -0
  64. package/src/providers/pcm.ts +37 -0
  65. package/src/providers/provider.ts +206 -0
  66. package/src/providers/speech.ts +180 -0
  67. package/src/providers/sse.ts +59 -0
  68. package/esm/_dnt.polyfills.d.ts +0 -110
  69. package/esm/_dnt.polyfills.js +0 -144
  70. package/esm/_dnt.shims.d.ts +0 -5
  71. package/esm/_dnt.shims.js +0 -61
  72. package/esm/mod.js +0 -49
  73. package/esm/package.json +0 -3
  74. package/esm/src/cli/commands/profile.d.ts +0 -2
  75. package/esm/src/cli/commands/profile.js +0 -53
  76. package/esm/src/cli/commands/run.d.ts +0 -10
  77. package/esm/src/cli/commands/run.js +0 -55
  78. package/esm/src/cli/commands/test.d.ts +0 -15
  79. package/esm/src/cli/commands/test.js +0 -140
  80. package/esm/src/cli/index.d.ts +0 -4
  81. package/esm/src/cli/index.js +0 -148
  82. package/esm/src/cli/matrix/fixtures.d.ts +0 -13
  83. package/esm/src/cli/matrix/fixtures.js +0 -77
  84. package/esm/src/cli/matrix/synthesizer.d.ts +0 -29
  85. package/esm/src/cli/matrix/synthesizer.js +0 -187
  86. package/esm/src/guardrails/error.d.ts +0 -33
  87. package/esm/src/guardrails/error.js +0 -114
  88. package/esm/src/guardrails/injection.d.ts +0 -12
  89. package/esm/src/guardrails/injection.js +0 -220
  90. package/esm/src/guardrails/mod.d.ts +0 -14
  91. package/esm/src/guardrails/mod.js +0 -14
  92. package/esm/src/guardrails/sanitize.d.ts +0 -22
  93. package/esm/src/guardrails/sanitize.js +0 -133
  94. package/esm/src/guardrails/sensitive.d.ts +0 -12
  95. package/esm/src/guardrails/sensitive.js +0 -88
  96. package/esm/src/host/mint-trace.d.ts +0 -27
  97. package/esm/src/host/mint-trace.js +0 -33
  98. package/esm/src/host/mod.d.ts +0 -13
  99. package/esm/src/host/reply.d.ts +0 -14
  100. package/esm/src/host/reply.js +0 -27
  101. package/esm/src/kernel/engine/boundary.d.ts +0 -10
  102. package/esm/src/kernel/engine/boundary.js +0 -55
  103. package/esm/src/kernel/engine/delta.d.ts +0 -8
  104. package/esm/src/kernel/engine/delta.js +0 -389
  105. package/esm/src/kernel/engine/hash.d.ts +0 -1
  106. package/esm/src/kernel/engine/hash.js +0 -9
  107. package/esm/src/kernel/engine/record.d.ts +0 -2
  108. package/esm/src/kernel/engine/record.js +0 -7
  109. package/esm/src/kernel/engine/repair.d.ts +0 -7
  110. package/esm/src/kernel/engine/repair.js +0 -38
  111. package/esm/src/kernel/engine/runner/gates.d.ts +0 -4
  112. package/esm/src/kernel/engine/runner/gates.js +0 -206
  113. package/esm/src/kernel/engine/runner/mod.d.ts +0 -14
  114. package/esm/src/kernel/engine/runner/mod.js +0 -103
  115. package/esm/src/kernel/engine/runner/state.d.ts +0 -16
  116. package/esm/src/kernel/engine/runner/state.js +0 -8
  117. package/esm/src/kernel/engine/runner/steps.d.ts +0 -15
  118. package/esm/src/kernel/engine/runner/steps.js +0 -119
  119. package/esm/src/kernel/engine/runner/stream.d.ts +0 -11
  120. package/esm/src/kernel/engine/runner/stream.js +0 -65
  121. package/esm/src/kernel/engine/runner/tokens.d.ts +0 -3
  122. package/esm/src/kernel/engine/runner/tokens.js +0 -38
  123. package/esm/src/kernel/engine/runner/tools.d.ts +0 -13
  124. package/esm/src/kernel/engine/runner/tools.js +0 -197
  125. package/esm/src/kernel/engine/runner.js +0 -6
  126. package/esm/src/kernel/engine/tree.d.ts +0 -2
  127. package/esm/src/kernel/engine/tree.js +0 -17
  128. package/esm/src/kernel/mod.d.ts +0 -18
  129. package/esm/src/kernel/mod.js +0 -16
  130. package/esm/src/kernel/registry/attachments.d.ts +0 -16
  131. package/esm/src/kernel/registry/attachments.js +0 -156
  132. package/esm/src/kernel/registry/catalog.d.ts +0 -31
  133. package/esm/src/kernel/registry/catalog.js +0 -135
  134. package/esm/src/kernel/registry/ingress.d.ts +0 -13
  135. package/esm/src/kernel/registry/ingress.js +0 -163
  136. package/esm/src/kernel/registry/profiles.d.ts +0 -34
  137. package/esm/src/kernel/registry/profiles.js +0 -120
  138. package/esm/src/kernel/registry/provider-request.d.ts +0 -4
  139. package/esm/src/kernel/registry/provider-request.js +0 -25
  140. package/esm/src/kernel/registry/resolve.d.ts +0 -19
  141. package/esm/src/kernel/registry/resolve.js +0 -217
  142. package/esm/src/kernel/registry/schemas.d.ts +0 -14
  143. package/esm/src/kernel/registry/schemas.js +0 -23
  144. package/esm/src/kernel/registry/tools.d.ts +0 -12
  145. package/esm/src/kernel/registry/tools.js +0 -36
  146. package/esm/src/kernel/registry/vault.js +0 -18
  147. package/esm/src/kernel/types.d.ts +0 -521
  148. package/esm/src/kernel/types.js +0 -10
  149. package/esm/src/observability/mod.d.ts +0 -12
  150. package/esm/src/observability/spans.d.ts +0 -16
  151. package/esm/src/observability/spans.js +0 -56
  152. package/esm/src/observability/trace-attach.d.ts +0 -16
  153. package/esm/src/observability/trace-attach.js +0 -67
  154. package/esm/src/observability/trace-record.d.ts +0 -112
  155. package/esm/src/observability/trace-record.js +0 -140
  156. package/esm/src/observability/trace-usage.d.ts +0 -3
  157. package/esm/src/observability/trace-usage.js +0 -32
  158. package/esm/src/observability/trace.d.ts +0 -23
  159. package/esm/src/observability/trace.js +0 -121
  160. package/esm/src/presets/google.d.ts +0 -50
  161. package/esm/src/presets/google.js +0 -96
  162. package/esm/src/presets/mod.d.ts +0 -11
  163. package/esm/src/presets/mod.js +0 -10
  164. package/esm/src/providers/create-provider.d.ts +0 -29
  165. package/esm/src/providers/create-provider.js +0 -38
  166. package/esm/src/providers/gemini-tape.d.ts +0 -2
  167. package/esm/src/providers/gemini-tape.js +0 -46
  168. package/esm/src/providers/google-tap.d.ts +0 -3
  169. package/esm/src/providers/google-tap.js +0 -48
  170. package/esm/src/providers/interactions.d.ts +0 -5
  171. package/esm/src/providers/interactions.js +0 -152
  172. package/esm/src/providers/keys.d.ts +0 -19
  173. package/esm/src/providers/keys.js +0 -129
  174. package/esm/src/providers/mod.d.ts +0 -12
  175. package/esm/src/providers/openrouter-mod.d.ts +0 -13
  176. package/esm/src/providers/openrouter-payload.d.ts +0 -32
  177. package/esm/src/providers/openrouter-payload.js +0 -179
  178. package/esm/src/providers/openrouter.d.ts +0 -15
  179. package/esm/src/providers/openrouter.js +0 -589
  180. package/esm/src/providers/pcm.d.ts +0 -7
  181. package/esm/src/providers/pcm.js +0 -35
  182. package/esm/src/providers/provider.d.ts +0 -15
  183. package/esm/src/providers/provider.js +0 -166
  184. package/esm/src/providers/speech.d.ts +0 -23
  185. package/esm/src/providers/speech.js +0 -125
  186. package/esm/src/providers/sse.d.ts +0 -7
  187. package/esm/src/providers/sse.js +0 -53
@@ -1,179 +0,0 @@
1
- /**
2
- * OpenRouter payload builder.
3
- *
4
- * Converts THEORUM provider requests into OpenAI-compatible chat completion
5
- * payloads for OpenRouter and compatible gateways.
6
- *
7
- * @module
8
- */
9
- import { getTool } from '../kernel/registry/catalog.js';
10
- import { getStructured } from '../kernel/registry/schemas.js';
11
- /**
12
- * Resolve a THEORUM model id to an OpenRouter model string.
13
- * Prefer `openRouterId` / `apiId` from the profile model spec on the request.
14
- */
15
- function resolveOpenRouterModel(modelId, customMap, wire) {
16
- if (customMap?.[modelId]) {
17
- return customMap[modelId];
18
- }
19
- if (wire?.openRouterId) {
20
- return wire.openRouterId;
21
- }
22
- if (wire?.apiId?.includes('/')) {
23
- return wire.apiId;
24
- }
25
- if (wire?.apiId) {
26
- return `google/${wire.apiId}`;
27
- }
28
- if (String(modelId).includes('/')) {
29
- return String(modelId);
30
- }
31
- return String(modelId);
32
- }
33
- /** Map THEORUM thinking level to OpenRouter/OpenAI `reasoning.effort`. */
34
- function mapThinkingEffort(thinking) {
35
- return thinking;
36
- }
37
- function wireAudioPart(part) {
38
- let format = 'mp3';
39
- if (part.mimeType.includes('wav')) {
40
- format = 'wav';
41
- }
42
- return {
43
- type: 'input_audio',
44
- input_audio: {
45
- data: part.data,
46
- format,
47
- },
48
- };
49
- }
50
- function wireMessageContent(parts) {
51
- const isAllText = parts.every((p) => p.type === 'text');
52
- if (isAllText) {
53
- return parts
54
- .map((p) => {
55
- if (p.type === 'text') {
56
- return p.text;
57
- }
58
- return '';
59
- })
60
- .join('\n');
61
- }
62
- return parts.map((part) => {
63
- if (part.type === 'text') {
64
- return { type: 'text', text: part.text };
65
- }
66
- if (part.type === 'image') {
67
- return {
68
- type: 'image_url',
69
- image_url: { url: `data:${part.mimeType};base64,${part.data}` },
70
- };
71
- }
72
- if (part.type === 'audio') {
73
- return wireAudioPart(part);
74
- }
75
- return { type: 'text', text: '' };
76
- });
77
- }
78
- function wireHistoryMessage(msg) {
79
- let content = msg.content ?? '';
80
- if (msg.parts && msg.parts.length > 0) {
81
- content = wireMessageContent(msg.parts);
82
- }
83
- const wired = {
84
- role: msg.role,
85
- content,
86
- };
87
- if (msg.tool_calls && msg.tool_calls.length > 0) {
88
- wired.tool_calls = msg.tool_calls;
89
- }
90
- if (msg.tool_call_id) {
91
- wired.tool_call_id = msg.tool_call_id;
92
- }
93
- if (msg.name) {
94
- wired.name = msg.name;
95
- }
96
- return wired;
97
- }
98
- function wireTools(dynamicTools) {
99
- if (!dynamicTools || dynamicTools.length === 0) {
100
- return [];
101
- }
102
- return dynamicTools.map((t) => ({
103
- type: 'function',
104
- function: {
105
- name: t.name,
106
- description: t.description ?? '',
107
- parameters: t.parameters ?? { type: 'object', properties: {} },
108
- },
109
- }));
110
- }
111
- function buildMessages(req) {
112
- const messages = [];
113
- if (req.system) {
114
- messages.push({ role: 'system', content: req.system });
115
- }
116
- if (req.history && req.history.length > 0) {
117
- for (const h of req.history) {
118
- messages.push(wireHistoryMessage(h));
119
- }
120
- }
121
- if (req.input.length > 0) {
122
- messages.push({
123
- role: 'user',
124
- content: wireMessageContent(req.input),
125
- });
126
- }
127
- return messages;
128
- }
129
- function resolveResponseFormat(structured) {
130
- if (!structured) {
131
- return undefined;
132
- }
133
- const spec = getStructured(structured);
134
- if (!spec.jsonSchema) {
135
- return undefined;
136
- }
137
- return {
138
- type: 'json_schema',
139
- json_schema: {
140
- name: String(structured),
141
- strict: true,
142
- schema: spec.jsonSchema,
143
- },
144
- };
145
- }
146
- /** Convert a provider-neutral request into an OpenRouter chat completion payload. */
147
- function toOpenRouterPayload(req, config) {
148
- const model = resolveOpenRouterModel(req.model, config.modelMap, {
149
- apiId: req.apiId,
150
- openRouterId: req.openRouterId,
151
- });
152
- const messages = buildMessages(req);
153
- const payload = {
154
- model,
155
- stream: true,
156
- messages,
157
- temperature: req.temperature,
158
- max_tokens: req.maxOutputTokens,
159
- };
160
- const effort = mapThinkingEffort(req.thinking);
161
- payload.reasoning = { effort };
162
- const responseFormat = resolveResponseFormat(req.structured);
163
- if (responseFormat) {
164
- payload.response_format = responseFormat;
165
- }
166
- const tools = wireTools(req.dynamicTools);
167
- if (tools.length > 0) {
168
- payload.tools = tools;
169
- }
170
- const plugins = req.builtins
171
- .map((id) => getTool(id)?.openRouterPlugin)
172
- .filter((id) => Boolean(id))
173
- .map((id) => ({ id }));
174
- if (plugins.length > 0) {
175
- payload.plugins = plugins;
176
- }
177
- return payload;
178
- }
179
- export { resolveOpenRouterModel, toOpenRouterPayload };
@@ -1,15 +0,0 @@
1
- /**
2
- * OpenRouter provider adapter powered by Vercel AI SDK Core.
3
- *
4
- * THEORUM keeps the public `ModelProvider` and `TurnEvent` contract; AI SDK
5
- * owns the OpenRouter call, stream parsing, provider compatibility, and tool
6
- * call normalization.
7
- *
8
- * @module
9
- */
10
- import type { ModelProvider } from '../kernel/types.js';
11
- import { type OpenRouterConfig, resolveOpenRouterModel, toOpenRouterPayload } from './openrouter-payload.js';
12
- /** Create a `ModelProvider` backed by OpenRouter through AI SDK Core. */
13
- declare function createOpenRouterProvider(config?: OpenRouterConfig): ModelProvider;
14
- export type { OpenRouterConfig };
15
- export { createOpenRouterProvider, resolveOpenRouterModel, toOpenRouterPayload };