@theokit/di-agent 0.1.0 → 0.2.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.
package/CHANGELOG.md CHANGED
@@ -1,10 +1,29 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 461c020: Decorator-driven agent-team + workflow authoring (own identity — composition over a new engine).
8
+
9
+ - **`@Squad(metadata)`** property decorator + `readSquadMetadata` — declarative sequential agent team backed by `@theokit/di` `METADATA_KEYS.SQUAD`. Cross-validation Gap 1.
10
+ - **`@Step(metadata?)`** method decorator + `readStepMetadata` (`{ after?, name? }`) backed by `METADATA_KEYS.STEP`.
11
+ - **`buildWorkflow(instance)`** — compiles a class decorated with `@Step` into a `@theokit/sdk` `Workflow` (topological order by `after`; validates no-steps / unknown-after / cycle). No new runtime engine — composes `@theokit/sdk/workflow`. Cross-validation Gap 2.
12
+
13
+ First npm publish of these decorators (`0.1.0` on npm is the scaffold).
14
+
3
15
  All notable changes to `@theokit/di-agent` are documented in this file.
4
16
 
5
17
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
18
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
19
 
20
+ ## [Unreleased]
21
+
22
+ ### Added
23
+
24
+ - `@Squad({ agents, process? })` property decorator + `readSquadMetadata()` — the decorator surface for `@theokit/sdk` `createSquad` (decorator mandate). Stores team metadata via reflect-metadata, mirroring `@SubAgent`.
25
+ - `@Step({ after?, name? })` method decorator + `readStepMetadata()` + `buildWorkflow(instance)` — decorator-driven workflow authoring. `@Step` declares steps + a single upstream dependency; `buildWorkflow` compiles the decorated class into a `@theokit/sdk` `Workflow` (composition — no new engine), topologically ordering steps and threading each return value to the next. Fail-fast on no steps / unknown `after` / cycle.
26
+
8
27
  ## [0.1.0] - 2026-05-31
9
28
 
10
29
  > First GA release. Promotes `0.1.0-next.0` to stable. API contract preserved — no breaking changes from `0.1.0-next.0`.
package/dist/index.cjs CHANGED
@@ -1,6 +1,8 @@
1
1
  'use strict';
2
2
 
3
3
  var di = require('@theokit/di');
4
+ require('reflect-metadata');
5
+ var workflow = require('@theokit/sdk/workflow');
4
6
 
5
7
  var __defProp = Object.defineProperty;
6
8
  var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -17,13 +19,309 @@ function createAgentProvider(options) {
17
19
  };
18
20
  }
19
21
  __name(createAgentProvider, "createAgentProvider");
22
+ function Auth(options = {}) {
23
+ return (target) => {
24
+ Reflect.defineMetadata(di.METADATA_KEYS.AUTH, options, target);
25
+ };
26
+ }
27
+ __name(Auth, "Auth");
28
+ function readAuthMetadata(target) {
29
+ return Reflect.getMetadata(di.METADATA_KEYS.AUTH, target);
30
+ }
31
+ __name(readAuthMetadata, "readAuthMetadata");
32
+ var DEFAULTS = {
33
+ triggerFraction: 0.85,
34
+ keepNewest: 4
35
+ };
36
+ function AutoSummarize(options = {}) {
37
+ return (target) => {
38
+ const resolved = {
39
+ ...DEFAULTS,
40
+ ...options
41
+ };
42
+ Reflect.defineMetadata(di.METADATA_KEYS.AUTO_SUMMARIZE, resolved, target);
43
+ };
44
+ }
45
+ __name(AutoSummarize, "AutoSummarize");
46
+ function readAutoSummarizeMetadata(target) {
47
+ return Reflect.getMetadata(di.METADATA_KEYS.AUTO_SUMMARIZE, target);
48
+ }
49
+ __name(readAutoSummarizeMetadata, "readAutoSummarizeMetadata");
50
+ function Cron(options) {
51
+ return (target, propertyKey, _descriptor) => {
52
+ const metadata = {
53
+ ...options,
54
+ methodKey: propertyKey
55
+ };
56
+ Reflect.defineMetadata(di.METADATA_KEYS.CRON, metadata, target.constructor);
57
+ };
58
+ }
59
+ __name(Cron, "Cron");
60
+ function readCronMetadata(target) {
61
+ return Reflect.getMetadata(di.METADATA_KEYS.CRON, target);
62
+ }
63
+ __name(readCronMetadata, "readCronMetadata");
64
+ function EvalDecorator(options = {}) {
65
+ return (target) => {
66
+ Reflect.defineMetadata(di.METADATA_KEYS.EVAL, options, target);
67
+ };
68
+ }
69
+ __name(EvalDecorator, "EvalDecorator");
70
+ function readEvalDecoratorMetadata(target) {
71
+ return Reflect.getMetadata(di.METADATA_KEYS.EVAL, target);
72
+ }
73
+ __name(readEvalDecoratorMetadata, "readEvalDecoratorMetadata");
74
+ function Hitl(options) {
75
+ return (target, propertyKey, _descriptor) => {
76
+ const metadata = {
77
+ ...options,
78
+ methodKey: propertyKey
79
+ };
80
+ Reflect.defineMetadata(di.METADATA_KEYS.HITL, metadata, target.constructor);
81
+ };
82
+ }
83
+ __name(Hitl, "Hitl");
84
+ function readHitlMetadata(target) {
85
+ return Reflect.getMetadata(di.METADATA_KEYS.HITL, target);
86
+ }
87
+ __name(readHitlMetadata, "readHitlMetadata");
88
+ function MemoryScopeDecorator(options) {
89
+ return (target, propertyKey) => {
90
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.MEMORY_SCOPE, target.constructor) ?? /* @__PURE__ */ new Map();
91
+ existing.set(propertyKey, options);
92
+ Reflect.defineMetadata(di.METADATA_KEYS.MEMORY_SCOPE, existing, target.constructor);
93
+ };
94
+ }
95
+ __name(MemoryScopeDecorator, "MemoryScopeDecorator");
96
+ function readMemoryScopeMetadata(target) {
97
+ return Reflect.getMetadata(di.METADATA_KEYS.MEMORY_SCOPE, target) ?? /* @__PURE__ */ new Map();
98
+ }
99
+ __name(readMemoryScopeMetadata, "readMemoryScopeMetadata");
100
+ function Reranker(options) {
101
+ return (target, propertyKey) => {
102
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.RERANKER, target.constructor) ?? /* @__PURE__ */ new Map();
103
+ existing.set(propertyKey, options);
104
+ Reflect.defineMetadata(di.METADATA_KEYS.RERANKER, existing, target.constructor);
105
+ };
106
+ }
107
+ __name(Reranker, "Reranker");
108
+ function readRerankerMetadata(target) {
109
+ return Reflect.getMetadata(di.METADATA_KEYS.RERANKER, target) ?? /* @__PURE__ */ new Map();
110
+ }
111
+ __name(readRerankerMetadata, "readRerankerMetadata");
112
+ function Retriever(options) {
113
+ return (target, propertyKey) => {
114
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.RETRIEVER, target.constructor) ?? /* @__PURE__ */ new Map();
115
+ existing.set(propertyKey, options);
116
+ Reflect.defineMetadata(di.METADATA_KEYS.RETRIEVER, existing, target.constructor);
117
+ };
118
+ }
119
+ __name(Retriever, "Retriever");
120
+ function readRetrieverMetadata(target) {
121
+ return Reflect.getMetadata(di.METADATA_KEYS.RETRIEVER, target) ?? /* @__PURE__ */ new Map();
122
+ }
123
+ __name(readRetrieverMetadata, "readRetrieverMetadata");
124
+ function Squad(metadata) {
125
+ return (target, propertyKey) => {
126
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.SQUAD, target.constructor) ?? /* @__PURE__ */ new Map();
127
+ existing.set(propertyKey, metadata);
128
+ Reflect.defineMetadata(di.METADATA_KEYS.SQUAD, existing, target.constructor);
129
+ };
130
+ }
131
+ __name(Squad, "Squad");
132
+ function readSquadMetadata(target) {
133
+ return Reflect.getMetadata(di.METADATA_KEYS.SQUAD, target) ?? /* @__PURE__ */ new Map();
134
+ }
135
+ __name(readSquadMetadata, "readSquadMetadata");
136
+ function Step(metadata = {}) {
137
+ return (target, propertyKey) => {
138
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.STEP, target.constructor) ?? /* @__PURE__ */ new Map();
139
+ existing.set(propertyKey, metadata);
140
+ Reflect.defineMetadata(di.METADATA_KEYS.STEP, existing, target.constructor);
141
+ };
142
+ }
143
+ __name(Step, "Step");
144
+ function readStepMetadata(target) {
145
+ return Reflect.getMetadata(di.METADATA_KEYS.STEP, target) ?? /* @__PURE__ */ new Map();
146
+ }
147
+ __name(readStepMetadata, "readStepMetadata");
148
+ function SubAgent(options) {
149
+ return (target, propertyKey) => {
150
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.SUBAGENT, target.constructor) ?? /* @__PURE__ */ new Map();
151
+ existing.set(propertyKey, options);
152
+ Reflect.defineMetadata(di.METADATA_KEYS.SUBAGENT, existing, target.constructor);
153
+ };
154
+ }
155
+ __name(SubAgent, "SubAgent");
156
+ function readSubAgentMetadata(target) {
157
+ return Reflect.getMetadata(di.METADATA_KEYS.SUBAGENT, target) ?? /* @__PURE__ */ new Map();
158
+ }
159
+ __name(readSubAgentMetadata, "readSubAgentMetadata");
160
+ function Subscription(options) {
161
+ return (target, propertyKey) => {
162
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.SUBSCRIPTION, target.constructor) ?? /* @__PURE__ */ new Map();
163
+ existing.set(propertyKey, options);
164
+ Reflect.defineMetadata(di.METADATA_KEYS.SUBSCRIPTION, existing, target.constructor);
165
+ };
166
+ }
167
+ __name(Subscription, "Subscription");
168
+ function readSubscriptionMetadata(target) {
169
+ return Reflect.getMetadata(di.METADATA_KEYS.SUBSCRIPTION, target) ?? /* @__PURE__ */ new Map();
170
+ }
171
+ __name(readSubscriptionMetadata, "readSubscriptionMetadata");
172
+ function TextSplitter(options) {
173
+ return (target, propertyKey) => {
174
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.TEXT_SPLITTER, target.constructor) ?? /* @__PURE__ */ new Map();
175
+ existing.set(propertyKey, options);
176
+ Reflect.defineMetadata(di.METADATA_KEYS.TEXT_SPLITTER, existing, target.constructor);
177
+ };
178
+ }
179
+ __name(TextSplitter, "TextSplitter");
180
+ function readTextSplitterMetadata(target) {
181
+ return Reflect.getMetadata(di.METADATA_KEYS.TEXT_SPLITTER, target) ?? /* @__PURE__ */ new Map();
182
+ }
183
+ __name(readTextSplitterMetadata, "readTextSplitterMetadata");
184
+ function Tool(options) {
185
+ return (target, propertyKey) => {
186
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.TOOL, target.constructor) ?? /* @__PURE__ */ new Map();
187
+ existing.set(propertyKey, options);
188
+ Reflect.defineMetadata(di.METADATA_KEYS.TOOL, existing, target.constructor);
189
+ };
190
+ }
191
+ __name(Tool, "Tool");
192
+ function readToolMetadata(target) {
193
+ return Reflect.getMetadata(di.METADATA_KEYS.TOOL, target) ?? /* @__PURE__ */ new Map();
194
+ }
195
+ __name(readToolMetadata, "readToolMetadata");
196
+ function UseSandbox(options = {}) {
197
+ return (target, propertyKey) => {
198
+ const existing = Reflect.getMetadata(di.METADATA_KEYS.SANDBOX, target.constructor) ?? /* @__PURE__ */ new Map();
199
+ existing.set(propertyKey, options);
200
+ Reflect.defineMetadata(di.METADATA_KEYS.SANDBOX, existing, target.constructor);
201
+ };
202
+ }
203
+ __name(UseSandbox, "UseSandbox");
204
+ function readSandboxMetadata(target) {
205
+ return Reflect.getMetadata(di.METADATA_KEYS.SANDBOX, target) ?? /* @__PURE__ */ new Map();
206
+ }
207
+ __name(readSandboxMetadata, "readSandboxMetadata");
208
+ function Workflow(options = {}) {
209
+ return (target) => {
210
+ Reflect.defineMetadata(di.METADATA_KEYS.WORKFLOW, options, target);
211
+ };
212
+ }
213
+ __name(Workflow, "Workflow");
214
+ function readWorkflowMetadata(target) {
215
+ return Reflect.getMetadata(di.METADATA_KEYS.WORKFLOW, target);
216
+ }
217
+ __name(readWorkflowMetadata, "readWorkflowMetadata");
20
218
  function InjectAgent() {
21
219
  return di.Inject(AGENT_TOKEN);
22
220
  }
23
221
  __name(InjectAgent, "InjectAgent");
222
+ function buildWorkflow(instance) {
223
+ const ctor = instance.constructor;
224
+ const meta = readStepMetadata(ctor);
225
+ if (meta.size === 0) {
226
+ throw new Error(`buildWorkflow: class "${instance.constructor.name}" has no @Step methods`);
227
+ }
228
+ const steps = resolveSteps(instance, meta);
229
+ validateAfterTargets(steps);
230
+ const ordered = topoSort(steps);
231
+ const name = readWorkflowMetadata(instance.constructor)?.name ?? "workflow";
232
+ let builder = workflow.Workflow.create({
233
+ name
234
+ });
235
+ for (const s of ordered) {
236
+ builder = builder.then(workflow.fn(s.id, (input) => s.run(input)));
237
+ }
238
+ return builder.commit();
239
+ }
240
+ __name(buildWorkflow, "buildWorkflow");
241
+ function resolveSteps(instance, meta) {
242
+ const steps = /* @__PURE__ */ new Map();
243
+ for (const [key, m] of meta) {
244
+ const k = String(key);
245
+ const method = instance[k];
246
+ if (typeof method !== "function") {
247
+ throw new Error(`buildWorkflow: @Step "${k}" is not a method`);
248
+ }
249
+ steps.set(k, {
250
+ key: k,
251
+ id: m.name ?? k,
252
+ after: m.after,
253
+ run: /* @__PURE__ */ __name((input) => method.call(instance, input), "run")
254
+ });
255
+ }
256
+ return steps;
257
+ }
258
+ __name(resolveSteps, "resolveSteps");
259
+ function validateAfterTargets(steps) {
260
+ for (const s of steps.values()) {
261
+ if (s.after !== void 0 && !steps.has(s.after)) {
262
+ throw new Error(`buildWorkflow: @Step "${s.key}" declares after: "${s.after}" which is not a known @Step (unknown upstream)`);
263
+ }
264
+ }
265
+ }
266
+ __name(validateAfterTargets, "validateAfterTargets");
267
+ function topoSort(steps) {
268
+ const ordered = [];
269
+ const placed = /* @__PURE__ */ new Set();
270
+ const visiting = /* @__PURE__ */ new Set();
271
+ const visit = /* @__PURE__ */ __name((s) => {
272
+ if (placed.has(s.key)) return;
273
+ if (visiting.has(s.key)) {
274
+ throw new Error(`buildWorkflow: cycle detected in @Step "after" graph at "${s.key}"`);
275
+ }
276
+ visiting.add(s.key);
277
+ if (s.after !== void 0) {
278
+ const up = steps.get(s.after);
279
+ if (up !== void 0) visit(up);
280
+ }
281
+ visiting.delete(s.key);
282
+ placed.add(s.key);
283
+ ordered.push(s);
284
+ }, "visit");
285
+ for (const s of steps.values()) visit(s);
286
+ return ordered;
287
+ }
288
+ __name(topoSort, "topoSort");
24
289
 
25
290
  exports.AGENT_TOKEN = AGENT_TOKEN;
291
+ exports.Auth = Auth;
292
+ exports.AutoSummarize = AutoSummarize;
293
+ exports.Cron = Cron;
294
+ exports.EvalDecorator = EvalDecorator;
295
+ exports.Hitl = Hitl;
26
296
  exports.InjectAgent = InjectAgent;
297
+ exports.MemoryScopeDecorator = MemoryScopeDecorator;
298
+ exports.Reranker = Reranker;
299
+ exports.Retriever = Retriever;
300
+ exports.Squad = Squad;
301
+ exports.Step = Step;
302
+ exports.SubAgent = SubAgent;
303
+ exports.Subscription = Subscription;
304
+ exports.TextSplitter = TextSplitter;
305
+ exports.Tool = Tool;
306
+ exports.UseSandbox = UseSandbox;
307
+ exports.Workflow = Workflow;
308
+ exports.buildWorkflow = buildWorkflow;
27
309
  exports.createAgentProvider = createAgentProvider;
310
+ exports.readAuthMetadata = readAuthMetadata;
311
+ exports.readAutoSummarizeMetadata = readAutoSummarizeMetadata;
312
+ exports.readCronMetadata = readCronMetadata;
313
+ exports.readEvalDecoratorMetadata = readEvalDecoratorMetadata;
314
+ exports.readHitlMetadata = readHitlMetadata;
315
+ exports.readMemoryScopeMetadata = readMemoryScopeMetadata;
316
+ exports.readRerankerMetadata = readRerankerMetadata;
317
+ exports.readRetrieverMetadata = readRetrieverMetadata;
318
+ exports.readSandboxMetadata = readSandboxMetadata;
319
+ exports.readSquadMetadata = readSquadMetadata;
320
+ exports.readStepMetadata = readStepMetadata;
321
+ exports.readSubAgentMetadata = readSubAgentMetadata;
322
+ exports.readSubscriptionMetadata = readSubscriptionMetadata;
323
+ exports.readTextSplitterMetadata = readTextSplitterMetadata;
324
+ exports.readToolMetadata = readToolMetadata;
325
+ exports.readWorkflowMetadata = readWorkflowMetadata;
28
326
  //# sourceMappingURL=index.cjs.map
29
327
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/tokens.ts","../src/agent-provider.ts","../src/inject-agent.ts"],"names":["AGENT_TOKEN","createAgentProvider","options","provide","useFactory","factory","scope","Scope","REQUEST","InjectAgent","Inject"],"mappings":";;;;;;;;AAKO,IAAMA,WAAAA,GAAc;;;ACuCpB,SAASC,oBACdC,OAAAA,EAA2C;AAE3C,EAAA,OAAO;IACLC,OAAAA,EAASH,WAAAA;IACTI,UAAAA,kBAAY,MAAA,CAAA,MAAMF,OAAAA,CAAQG,OAAAA,EAAO,EAArB,YAAA,CAAA;IACZC,KAAAA,EAAOJ,OAAAA,CAAQI,SAASC,QAAAA,CAAMC;AAChC,GAAA;AACF;AARgBP,MAAAA,CAAAA,mBAAAA,EAAAA,qBAAAA,CAAAA;AC1BT,SAASQ,WAAAA,GAAAA;AACd,EAAA,OAAOC,UAAOV,WAAAA,CAAAA;AAChB;AAFgBS,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"index.cjs","sourcesContent":["/**\n * Token used by `@InjectAgent()` to look up the Agent provider. Importing\n * this directly (instead of using the decorator) lets you register a\n * custom factory under the same token.\n */\nexport const AGENT_TOKEN = \"@theokit/di-agent:Agent\";\n","import { type FactoryProvider, Scope } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Options accepted by `createAgentProvider()`. Mirrors the public\n * `AgentOptions` from `@theokit/sdk` but kept structural so this package\n * does not have a hard import dependency on the SDK's type tree.\n *\n * The factory `async () => Agent.create(options)` is provided by the\n * consumer (see `createAgentProvider` below). This package supplies the\n * scope + token wiring.\n */\nexport interface CreateAgentProviderOptions<TAgent> {\n /**\n * Factory function that produces a fresh Agent per REQUEST.\n * Typically `() => Agent.create({...})` from `@theokit/sdk`.\n */\n factory: () => TAgent | Promise<TAgent>;\n /**\n * Override the scope. Default is `REQUEST` (the wedge — one isolated\n * Agent per HTTP request). Override to `SINGLETON` for CLI / cron /\n * single-tenant scenarios where a shared Agent is desirable.\n */\n scope?: Scope;\n}\n\n/**\n * Build a `FactoryProvider` that materializes an Agent on demand.\n *\n * @example\n * import { Agent } from \"@theokit/sdk\";\n * import { Module } from \"@theokit/di\";\n * import { createAgentProvider } from \"@theokit/di-agent\";\n *\n * @Module({\n * providers: [\n * createAgentProvider({\n * factory: () => Agent.create({ apiKey: process.env.OPENROUTER_API_KEY!, model: { id: \"openai/gpt-4o-mini\" } }),\n * }),\n * ],\n * })\n * class AppModule {}\n */\nexport function createAgentProvider<TAgent>(\n options: CreateAgentProviderOptions<TAgent>,\n): FactoryProvider<TAgent> {\n return {\n provide: AGENT_TOKEN,\n useFactory: () => options.factory(),\n scope: options.scope ?? Scope.REQUEST,\n };\n}\n","import { Inject } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.\n * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.\n *\n * @example\n * @Injectable()\n * class ChatController {\n * constructor(@InjectAgent() private readonly agent: Agent) {}\n *\n * async chat(message: string) {\n * return this.agent.send(message);\n * }\n * }\n */\nexport function InjectAgent(): ParameterDecorator {\n return Inject(AGENT_TOKEN);\n}\n"]}
1
+ {"version":3,"sources":["../src/tokens.ts","../src/agent-provider.ts","../src/decorators/auth.ts","../src/decorators/auto-summarize.ts","../src/decorators/cron.ts","../src/decorators/eval-decorator.ts","../src/decorators/hitl.ts","../src/decorators/memory-scope.ts","../src/decorators/reranker.ts","../src/decorators/retriever.ts","../src/decorators/squad.ts","../src/decorators/step.ts","../src/decorators/sub-agent.ts","../src/decorators/subscription.ts","../src/decorators/text-splitter.ts","../src/decorators/tool.ts","../src/decorators/use-sandbox.ts","../src/decorators/workflow.ts","../src/inject-agent.ts","../src/workflow-builder.ts"],"names":["AGENT_TOKEN","createAgentProvider","options","provide","useFactory","factory","scope","Scope","REQUEST","Auth","target","Reflect","defineMetadata","METADATA_KEYS","AUTH","readAuthMetadata","getMetadata","DEFAULTS","triggerFraction","keepNewest","AutoSummarize","resolved","AUTO_SUMMARIZE","readAutoSummarizeMetadata","Cron","propertyKey","_descriptor","metadata","methodKey","CRON","readCronMetadata","EvalDecorator","EVAL","readEvalDecoratorMetadata","Hitl","HITL","readHitlMetadata","MemoryScopeDecorator","existing","MEMORY_SCOPE","Map","set","readMemoryScopeMetadata","Reranker","RERANKER","readRerankerMetadata","Retriever","RETRIEVER","readRetrieverMetadata","Squad","SQUAD","readSquadMetadata","Step","STEP","readStepMetadata","SubAgent","SUBAGENT","readSubAgentMetadata","Subscription","SUBSCRIPTION","readSubscriptionMetadata","TextSplitter","TEXT_SPLITTER","readTextSplitterMetadata","Tool","TOOL","readToolMetadata","UseSandbox","SANDBOX","readSandboxMetadata","Workflow","WORKFLOW","readWorkflowMetadata","InjectAgent","Inject","buildWorkflow","instance","ctor","meta","size","Error","name","steps","resolveSteps","validateAfterTargets","ordered","topoSort","builder","create","s","then","fn","id","input","run","commit","key","m","k","String","method","after","call","values","undefined","has","placed","Set","visiting","visit","add","up","get","delete","push"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Token used by `@InjectAgent()` to look up the Agent provider. Importing\n * this directly (instead of using the decorator) lets you register a\n * custom factory under the same token.\n */\nexport const AGENT_TOKEN = \"@theokit/di-agent:Agent\";\n","import { type FactoryProvider, Scope } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Options accepted by `createAgentProvider()`. Mirrors the public\n * `AgentOptions` from `@theokit/sdk` but kept structural so this package\n * does not have a hard import dependency on the SDK's type tree.\n *\n * The factory `async () => Agent.create(options)` is provided by the\n * consumer (see `createAgentProvider` below). This package supplies the\n * scope + token wiring.\n */\nexport interface CreateAgentProviderOptions<TAgent> {\n /**\n * Factory function that produces a fresh Agent per REQUEST.\n * Typically `() => Agent.create({...})` from `@theokit/sdk`.\n */\n factory: () => TAgent | Promise<TAgent>;\n /**\n * Override the scope. Default is `REQUEST` (the wedge — one isolated\n * Agent per HTTP request). Override to `SINGLETON` for CLI / cron /\n * single-tenant scenarios where a shared Agent is desirable.\n */\n scope?: Scope;\n}\n\n/**\n * Build a `FactoryProvider` that materializes an Agent on demand.\n *\n * @example\n * import { Agent } from \"@theokit/sdk\";\n * import { Module } from \"@theokit/di\";\n * import { createAgentProvider } from \"@theokit/di-agent\";\n *\n * @Module({\n * providers: [\n * createAgentProvider({\n * factory: () => Agent.create({ apiKey: process.env.OPENROUTER_API_KEY!, model: { id: \"openai/gpt-4o-mini\" } }),\n * }),\n * ],\n * })\n * class AppModule {}\n */\nexport function createAgentProvider<TAgent>(\n options: CreateAgentProviderOptions<TAgent>,\n): FactoryProvider<TAgent> {\n return {\n provide: AGENT_TOKEN,\n useFactory: () => options.factory(),\n scope: options.scope ?? Scope.REQUEST,\n };\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface AuthOptions {\n providers?: string[];\n sessionConfig?: unknown;\n}\n\nexport function Auth(options: AuthOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.AUTH, options, target);\n };\n}\n\nexport function readAuthMetadata(target: Function): AuthOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.AUTH, target) as AuthOptions | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface AutoSummarizeOptions {\n triggerFraction?: number;\n keepNewest?: number;\n model?: string;\n}\n\nconst DEFAULTS: Required<Omit<AutoSummarizeOptions, \"model\">> = {\n triggerFraction: 0.85,\n keepNewest: 4,\n};\n\nexport function AutoSummarize(options: AutoSummarizeOptions = {}): ClassDecorator {\n return (target: Function) => {\n const resolved = { ...DEFAULTS, ...options };\n Reflect.defineMetadata(METADATA_KEYS.AUTO_SUMMARIZE, resolved, target);\n };\n}\n\nexport function readAutoSummarizeMetadata(\n target: abstract new (...args: never) => unknown,\n): (Required<Omit<AutoSummarizeOptions, \"model\">> & { model?: string }) | undefined {\n return Reflect.getMetadata(METADATA_KEYS.AUTO_SUMMARIZE, target) as\n | (Required<Omit<AutoSummarizeOptions, \"model\">> & { model?: string })\n | undefined;\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface CronOptions {\n schedule: string;\n timezone?: string;\n}\n\nexport interface CronMetadata extends CronOptions {\n methodKey: string | symbol;\n}\n\nexport function Cron(options: CronOptions): MethodDecorator {\n return (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => {\n const metadata: CronMetadata = { ...options, methodKey: propertyKey };\n Reflect.defineMetadata(METADATA_KEYS.CRON, metadata, target.constructor);\n };\n}\n\nexport function readCronMetadata(\n target: abstract new (...args: never) => unknown,\n): CronMetadata | undefined {\n return Reflect.getMetadata(METADATA_KEYS.CRON, target) as CronMetadata | undefined;\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface EvalOptions {\n name?: string;\n scorers?: unknown[];\n dataset?: unknown;\n}\n\nexport function EvalDecorator(options: EvalOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.EVAL, options, target);\n };\n}\n\nexport function readEvalDecoratorMetadata(target: Function): EvalOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.EVAL, target) as EvalOptions | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface HitlOptions {\n tools: string[];\n timeoutMs?: number;\n}\n\nexport interface HitlMetadata extends HitlOptions {\n methodKey: string | symbol;\n}\n\nexport function Hitl(options: HitlOptions): MethodDecorator {\n return (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => {\n const metadata: HitlMetadata = { ...options, methodKey: propertyKey };\n Reflect.defineMetadata(METADATA_KEYS.HITL, metadata, target.constructor);\n };\n}\n\nexport function readHitlMetadata(\n target: abstract new (...args: never) => unknown,\n): HitlMetadata | undefined {\n return Reflect.getMetadata(METADATA_KEYS.HITL, target) as HitlMetadata | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface MemoryScopeOptions {\n path: string;\n}\n\nexport function MemoryScopeDecorator(options: MemoryScopeOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, MemoryScopeOptions> =\n Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.MEMORY_SCOPE, existing, target.constructor);\n };\n}\n\nexport function readMemoryScopeMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, MemoryScopeOptions> {\n return Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface RerankerOptions {\n provider?: string;\n model?: string;\n topN?: number;\n}\n\nexport function Reranker(options: RerankerOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, RerankerOptions> =\n Reflect.getMetadata(METADATA_KEYS.RERANKER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.RERANKER, existing, target.constructor);\n };\n}\n\nexport function readRerankerMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, RerankerOptions> {\n return Reflect.getMetadata(METADATA_KEYS.RERANKER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface RetrieverOptions {\n topK?: number;\n threshold?: number;\n}\n\nexport function Retriever(options: RetrieverOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, RetrieverOptions> =\n Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.RETRIEVER, existing, target.constructor);\n };\n}\n\nexport function readRetrieverMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, RetrieverOptions> {\n return Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\n/**\n * Metadata captured by the `@Squad()` property decorator. Declares a sequential\n * agent team by referencing the agent property names that compose it. Mirrors\n * the `@theokit/sdk` `createSquad` factory (decorator mandate — every agentic\n * capability ships a decorator alongside the factory).\n */\nexport interface SquadMetadata {\n /** Agent property names (or ids) that run in order. */\n agents: string[];\n /** Orchestration process. Default (omitted) = `\"sequential\"`. */\n process?: \"sequential\" | \"hierarchical\";\n /** Optional squad name. */\n name?: string;\n}\n\n/**\n * `@Squad(metadata)` — declare a sequential agent team on a property. The DI\n * container / agent provider materializes it into a `createSquad(...)` at wiring\n * time.\n */\nexport function Squad(metadata: SquadMetadata): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SquadMetadata> =\n Reflect.getMetadata(METADATA_KEYS.SQUAD, target.constructor) ?? new Map();\n existing.set(propertyKey, metadata);\n Reflect.defineMetadata(METADATA_KEYS.SQUAD, existing, target.constructor);\n };\n}\n\n/** Read `@Squad()` metadata off a class constructor. */\nexport function readSquadMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SquadMetadata> {\n return Reflect.getMetadata(METADATA_KEYS.SQUAD, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\n/**\n * Metadata captured by the `@Step()` method decorator. Declares one step of a\n * decorator-driven workflow and its single upstream dependency. Compiled into\n * a `@theokit/sdk` `Workflow` by `buildWorkflow` (decorator mandate — every\n * agentic capability ships a decorator alongside the factory/builder).\n */\nexport interface StepMetadata {\n /**\n * Method name of the upstream step this step runs after. Omitted = entry\n * step (receives the workflow input). MVP supports a single dependency\n * (linear chain); branching/fan-out stays the imperative `Workflow` surface.\n */\n after?: string;\n /** Optional step id (defaults to the method name). */\n name?: string;\n}\n\n/**\n * `@Step(metadata?)` — mark a class method as a workflow step. The method\n * receives the upstream step's return value (or the workflow input for an\n * entry step) and returns this step's output.\n */\nexport function Step(metadata: StepMetadata = {}): MethodDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, StepMetadata> =\n Reflect.getMetadata(METADATA_KEYS.STEP, target.constructor) ?? new Map();\n existing.set(propertyKey, metadata);\n Reflect.defineMetadata(METADATA_KEYS.STEP, existing, target.constructor);\n };\n}\n\n/** Read `@Step()` metadata off a class constructor (insertion-ordered). */\nexport function readStepMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, StepMetadata> {\n return Reflect.getMetadata(METADATA_KEYS.STEP, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface SubAgentOptions {\n name: string;\n description: string;\n instructions: string;\n model?: string;\n maxDelegationDepth?: number;\n}\n\nexport function SubAgent(options: SubAgentOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SubAgentOptions> =\n Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SUBAGENT, existing, target.constructor);\n };\n}\n\nexport function readSubAgentMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SubAgentOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface SubscriptionOptions {\n name: string;\n transport?: string;\n}\n\nexport function Subscription(options: SubscriptionOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SubscriptionOptions> =\n Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SUBSCRIPTION, existing, target.constructor);\n };\n}\n\nexport function readSubscriptionMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SubscriptionOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface TextSplitterOptions {\n strategy?: string;\n chunkSize?: number;\n overlap?: number;\n}\n\nexport function TextSplitter(options: TextSplitterOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, TextSplitterOptions> =\n Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.TEXT_SPLITTER, existing, target.constructor);\n };\n}\n\nexport function readTextSplitterMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, TextSplitterOptions> {\n return Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface ToolOptions {\n name: string;\n description: string;\n inputSchema?: unknown;\n}\n\nexport function Tool(options: ToolOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, ToolOptions> =\n Reflect.getMetadata(METADATA_KEYS.TOOL, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.TOOL, existing, target.constructor);\n };\n}\n\nexport function readToolMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, ToolOptions> {\n return Reflect.getMetadata(METADATA_KEYS.TOOL, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface UseSandboxOptions {\n backend?: \"local\" | \"docker\" | string;\n workDir?: string;\n timeoutMs?: number;\n}\n\nexport function UseSandbox(options: UseSandboxOptions = {}): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, UseSandboxOptions> =\n Reflect.getMetadata(METADATA_KEYS.SANDBOX, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SANDBOX, existing, target.constructor);\n };\n}\n\nexport function readSandboxMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, UseSandboxOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SANDBOX, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface WorkflowOptions {\n name?: string;\n retryPolicy?: unknown;\n inputSchema?: unknown;\n outputSchema?: unknown;\n}\n\nexport function Workflow(options: WorkflowOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.WORKFLOW, options, target);\n };\n}\n\nexport function readWorkflowMetadata(target: Function): WorkflowOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.WORKFLOW, target) as WorkflowOptions | undefined;\n}\n","import { Inject } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.\n * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.\n *\n * @example\n * @Injectable()\n * class ChatController {\n * constructor(@InjectAgent() private readonly agent: Agent) {}\n *\n * async chat(message: string) {\n * return this.agent.send(message);\n * }\n * }\n */\nexport function InjectAgent(): ParameterDecorator {\n return Inject(AGENT_TOKEN);\n}\n","/**\n * `buildWorkflow` — compile a `@Step`-decorated class instance into a\n * `@theokit/sdk` `Workflow`.\n *\n * This is the materializer/bridge for the decorator-driven workflow authoring\n * surface (cross-val Gap 2). It COMPOSES the existing `Workflow` engine — it\n * adds no orchestration logic of its own (same principle as `createSquad`).\n * Steps are topologically ordered by their single `after` dependency into a\n * linear `Workflow.then(...)` chain; each step's return value is threaded into\n * the next step. Branching/fan-out remains the imperative `Workflow` surface.\n *\n * NOTE: this module (unlike the metadata-only decorators) imports the\n * `@theokit/sdk` peer dependency — it is the bridge layer.\n */\n\nimport { fn, Workflow } from \"@theokit/sdk/workflow\";\nimport { readStepMetadata, type StepMetadata } from \"./decorators/step.js\";\nimport { readWorkflowMetadata } from \"./decorators/workflow.js\";\n\ninterface ResolvedStep {\n key: string;\n id: string;\n after?: string;\n run: (input: unknown) => unknown;\n}\n\n/**\n * Build a `Workflow` from a `@Step`-decorated instance. Validates the step\n * graph (fail-fast) before constructing the workflow.\n *\n * @throws Error when there are no `@Step` methods, an `after` references an\n * unknown step, or the `after` graph contains a cycle.\n */\nexport function buildWorkflow(instance: object): Workflow {\n const ctor = instance.constructor as abstract new (...args: never) => unknown;\n const meta = readStepMetadata(ctor);\n if (meta.size === 0) {\n throw new Error(`buildWorkflow: class \"${instance.constructor.name}\" has no @Step methods`);\n }\n\n const steps = resolveSteps(instance, meta);\n validateAfterTargets(steps);\n const ordered = topoSort(steps);\n\n const name = readWorkflowMetadata(instance.constructor as Function)?.name ?? \"workflow\";\n let builder = Workflow.create({ name });\n for (const s of ordered) {\n builder = builder.then(fn(s.id, (input: unknown) => s.run(input)));\n }\n return builder.commit();\n}\n\n/** Resolve each `@Step` method into a runnable {@link ResolvedStep}. */\nfunction resolveSteps(\n instance: object,\n meta: ReadonlyMap<string | symbol, StepMetadata>,\n): Map<string, ResolvedStep> {\n const steps = new Map<string, ResolvedStep>();\n for (const [key, m] of meta) {\n const k = String(key);\n const method = (instance as Record<string, unknown>)[k];\n if (typeof method !== \"function\") {\n throw new Error(`buildWorkflow: @Step \"${k}\" is not a method`);\n }\n steps.set(k, {\n key: k,\n id: m.name ?? k,\n after: m.after,\n run: (input: unknown) => (method as (i: unknown) => unknown).call(instance, input),\n });\n }\n return steps;\n}\n\n/** Fail-fast if any `after` references a step that does not exist. */\nfunction validateAfterTargets(steps: Map<string, ResolvedStep>): void {\n for (const s of steps.values()) {\n if (s.after !== undefined && !steps.has(s.after)) {\n throw new Error(\n `buildWorkflow: @Step \"${s.key}\" declares after: \"${s.after}\" which is not a known @Step (unknown upstream)`,\n );\n }\n }\n}\n\n/**\n * Topologically order steps by their single `after` dependency. Entry steps\n * (no `after`) come first in declaration order; each dependent follows its\n * upstream. Throws on a cycle.\n */\nfunction topoSort(steps: Map<string, ResolvedStep>): ResolvedStep[] {\n const ordered: ResolvedStep[] = [];\n const placed = new Set<string>();\n const visiting = new Set<string>();\n\n const visit = (s: ResolvedStep): void => {\n if (placed.has(s.key)) return;\n if (visiting.has(s.key)) {\n throw new Error(`buildWorkflow: cycle detected in @Step \"after\" graph at \"${s.key}\"`);\n }\n visiting.add(s.key);\n if (s.after !== undefined) {\n const up = steps.get(s.after);\n if (up !== undefined) visit(up);\n }\n visiting.delete(s.key);\n placed.add(s.key);\n ordered.push(s);\n };\n\n for (const s of steps.values()) visit(s);\n return ordered;\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { Scope, FactoryProvider } from '@theokit/di';
2
+ import { Workflow as Workflow$1 } from '@theokit/sdk/workflow';
2
3
 
3
4
  /**
4
5
  * Options accepted by `createAgentProvider()`. Mirrors the public
@@ -41,6 +42,170 @@ interface CreateAgentProviderOptions<TAgent> {
41
42
  */
42
43
  declare function createAgentProvider<TAgent>(options: CreateAgentProviderOptions<TAgent>): FactoryProvider<TAgent>;
43
44
 
45
+ interface AuthOptions {
46
+ providers?: string[];
47
+ sessionConfig?: unknown;
48
+ }
49
+ declare function Auth(options?: AuthOptions): ClassDecorator;
50
+ declare function readAuthMetadata(target: Function): AuthOptions | undefined;
51
+
52
+ interface AutoSummarizeOptions {
53
+ triggerFraction?: number;
54
+ keepNewest?: number;
55
+ model?: string;
56
+ }
57
+ declare function AutoSummarize(options?: AutoSummarizeOptions): ClassDecorator;
58
+ declare function readAutoSummarizeMetadata(target: abstract new (...args: never) => unknown): (Required<Omit<AutoSummarizeOptions, "model">> & {
59
+ model?: string;
60
+ }) | undefined;
61
+
62
+ interface CronOptions {
63
+ schedule: string;
64
+ timezone?: string;
65
+ }
66
+ interface CronMetadata extends CronOptions {
67
+ methodKey: string | symbol;
68
+ }
69
+ declare function Cron(options: CronOptions): MethodDecorator;
70
+ declare function readCronMetadata(target: abstract new (...args: never) => unknown): CronMetadata | undefined;
71
+
72
+ interface EvalOptions {
73
+ name?: string;
74
+ scorers?: unknown[];
75
+ dataset?: unknown;
76
+ }
77
+ declare function EvalDecorator(options?: EvalOptions): ClassDecorator;
78
+ declare function readEvalDecoratorMetadata(target: Function): EvalOptions | undefined;
79
+
80
+ interface HitlOptions {
81
+ tools: string[];
82
+ timeoutMs?: number;
83
+ }
84
+ interface HitlMetadata extends HitlOptions {
85
+ methodKey: string | symbol;
86
+ }
87
+ declare function Hitl(options: HitlOptions): MethodDecorator;
88
+ declare function readHitlMetadata(target: abstract new (...args: never) => unknown): HitlMetadata | undefined;
89
+
90
+ interface MemoryScopeOptions {
91
+ path: string;
92
+ }
93
+ declare function MemoryScopeDecorator(options: MemoryScopeOptions): PropertyDecorator;
94
+ declare function readMemoryScopeMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, MemoryScopeOptions>;
95
+
96
+ interface RerankerOptions {
97
+ provider?: string;
98
+ model?: string;
99
+ topN?: number;
100
+ }
101
+ declare function Reranker(options: RerankerOptions): PropertyDecorator;
102
+ declare function readRerankerMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, RerankerOptions>;
103
+
104
+ interface RetrieverOptions {
105
+ topK?: number;
106
+ threshold?: number;
107
+ }
108
+ declare function Retriever(options: RetrieverOptions): PropertyDecorator;
109
+ declare function readRetrieverMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, RetrieverOptions>;
110
+
111
+ /**
112
+ * Metadata captured by the `@Squad()` property decorator. Declares a sequential
113
+ * agent team by referencing the agent property names that compose it. Mirrors
114
+ * the `@theokit/sdk` `createSquad` factory (decorator mandate — every agentic
115
+ * capability ships a decorator alongside the factory).
116
+ */
117
+ interface SquadMetadata {
118
+ /** Agent property names (or ids) that run in order. */
119
+ agents: string[];
120
+ /** Orchestration process. Default (omitted) = `"sequential"`. */
121
+ process?: "sequential" | "hierarchical";
122
+ /** Optional squad name. */
123
+ name?: string;
124
+ }
125
+ /**
126
+ * `@Squad(metadata)` — declare a sequential agent team on a property. The DI
127
+ * container / agent provider materializes it into a `createSquad(...)` at wiring
128
+ * time.
129
+ */
130
+ declare function Squad(metadata: SquadMetadata): PropertyDecorator;
131
+ /** Read `@Squad()` metadata off a class constructor. */
132
+ declare function readSquadMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SquadMetadata>;
133
+
134
+ /**
135
+ * Metadata captured by the `@Step()` method decorator. Declares one step of a
136
+ * decorator-driven workflow and its single upstream dependency. Compiled into
137
+ * a `@theokit/sdk` `Workflow` by `buildWorkflow` (decorator mandate — every
138
+ * agentic capability ships a decorator alongside the factory/builder).
139
+ */
140
+ interface StepMetadata {
141
+ /**
142
+ * Method name of the upstream step this step runs after. Omitted = entry
143
+ * step (receives the workflow input). MVP supports a single dependency
144
+ * (linear chain); branching/fan-out stays the imperative `Workflow` surface.
145
+ */
146
+ after?: string;
147
+ /** Optional step id (defaults to the method name). */
148
+ name?: string;
149
+ }
150
+ /**
151
+ * `@Step(metadata?)` — mark a class method as a workflow step. The method
152
+ * receives the upstream step's return value (or the workflow input for an
153
+ * entry step) and returns this step's output.
154
+ */
155
+ declare function Step(metadata?: StepMetadata): MethodDecorator;
156
+ /** Read `@Step()` metadata off a class constructor (insertion-ordered). */
157
+ declare function readStepMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, StepMetadata>;
158
+
159
+ interface SubAgentOptions {
160
+ name: string;
161
+ description: string;
162
+ instructions: string;
163
+ model?: string;
164
+ maxDelegationDepth?: number;
165
+ }
166
+ declare function SubAgent(options: SubAgentOptions): PropertyDecorator;
167
+ declare function readSubAgentMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SubAgentOptions>;
168
+
169
+ interface SubscriptionOptions {
170
+ name: string;
171
+ transport?: string;
172
+ }
173
+ declare function Subscription(options: SubscriptionOptions): PropertyDecorator;
174
+ declare function readSubscriptionMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SubscriptionOptions>;
175
+
176
+ interface TextSplitterOptions {
177
+ strategy?: string;
178
+ chunkSize?: number;
179
+ overlap?: number;
180
+ }
181
+ declare function TextSplitter(options: TextSplitterOptions): PropertyDecorator;
182
+ declare function readTextSplitterMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, TextSplitterOptions>;
183
+
184
+ interface ToolOptions {
185
+ name: string;
186
+ description: string;
187
+ inputSchema?: unknown;
188
+ }
189
+ declare function Tool(options: ToolOptions): PropertyDecorator;
190
+ declare function readToolMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, ToolOptions>;
191
+
192
+ interface UseSandboxOptions {
193
+ backend?: "local" | "docker" | string;
194
+ workDir?: string;
195
+ timeoutMs?: number;
196
+ }
197
+ declare function UseSandbox(options?: UseSandboxOptions): PropertyDecorator;
198
+ declare function readSandboxMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, UseSandboxOptions>;
199
+
200
+ interface WorkflowOptions {
201
+ name?: string;
202
+ retryPolicy?: unknown;
203
+ inputSchema?: unknown;
204
+ outputSchema?: unknown;
205
+ }
206
+ declare function Workflow(options?: WorkflowOptions): ClassDecorator;
207
+ declare function readWorkflowMetadata(target: Function): WorkflowOptions | undefined;
208
+
44
209
  /**
45
210
  * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.
46
211
  * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.
@@ -64,4 +229,28 @@ declare function InjectAgent(): ParameterDecorator;
64
229
  */
65
230
  declare const AGENT_TOKEN = "@theokit/di-agent:Agent";
66
231
 
67
- export { AGENT_TOKEN, type CreateAgentProviderOptions, InjectAgent, createAgentProvider };
232
+ /**
233
+ * `buildWorkflow` — compile a `@Step`-decorated class instance into a
234
+ * `@theokit/sdk` `Workflow`.
235
+ *
236
+ * This is the materializer/bridge for the decorator-driven workflow authoring
237
+ * surface (cross-val Gap 2). It COMPOSES the existing `Workflow` engine — it
238
+ * adds no orchestration logic of its own (same principle as `createSquad`).
239
+ * Steps are topologically ordered by their single `after` dependency into a
240
+ * linear `Workflow.then(...)` chain; each step's return value is threaded into
241
+ * the next step. Branching/fan-out remains the imperative `Workflow` surface.
242
+ *
243
+ * NOTE: this module (unlike the metadata-only decorators) imports the
244
+ * `@theokit/sdk` peer dependency — it is the bridge layer.
245
+ */
246
+
247
+ /**
248
+ * Build a `Workflow` from a `@Step`-decorated instance. Validates the step
249
+ * graph (fail-fast) before constructing the workflow.
250
+ *
251
+ * @throws Error when there are no `@Step` methods, an `after` references an
252
+ * unknown step, or the `after` graph contains a cycle.
253
+ */
254
+ declare function buildWorkflow(instance: object): Workflow$1;
255
+
256
+ export { AGENT_TOKEN, Auth, type AuthOptions, AutoSummarize, type AutoSummarizeOptions, type CreateAgentProviderOptions, Cron, type CronMetadata, type CronOptions, EvalDecorator, type EvalOptions, Hitl, type HitlMetadata, type HitlOptions, InjectAgent, MemoryScopeDecorator, type MemoryScopeOptions, Reranker, type RerankerOptions, Retriever, type RetrieverOptions, Squad, type SquadMetadata, Step, type StepMetadata, SubAgent, type SubAgentOptions, Subscription, type SubscriptionOptions, TextSplitter, type TextSplitterOptions, Tool, type ToolOptions, UseSandbox, type UseSandboxOptions, Workflow, type WorkflowOptions, buildWorkflow, createAgentProvider, readAuthMetadata, readAutoSummarizeMetadata, readCronMetadata, readEvalDecoratorMetadata, readHitlMetadata, readMemoryScopeMetadata, readRerankerMetadata, readRetrieverMetadata, readSandboxMetadata, readSquadMetadata, readStepMetadata, readSubAgentMetadata, readSubscriptionMetadata, readTextSplitterMetadata, readToolMetadata, readWorkflowMetadata };
package/dist/index.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { Scope, FactoryProvider } from '@theokit/di';
2
+ import { Workflow as Workflow$1 } from '@theokit/sdk/workflow';
2
3
 
3
4
  /**
4
5
  * Options accepted by `createAgentProvider()`. Mirrors the public
@@ -41,6 +42,170 @@ interface CreateAgentProviderOptions<TAgent> {
41
42
  */
42
43
  declare function createAgentProvider<TAgent>(options: CreateAgentProviderOptions<TAgent>): FactoryProvider<TAgent>;
43
44
 
45
+ interface AuthOptions {
46
+ providers?: string[];
47
+ sessionConfig?: unknown;
48
+ }
49
+ declare function Auth(options?: AuthOptions): ClassDecorator;
50
+ declare function readAuthMetadata(target: Function): AuthOptions | undefined;
51
+
52
+ interface AutoSummarizeOptions {
53
+ triggerFraction?: number;
54
+ keepNewest?: number;
55
+ model?: string;
56
+ }
57
+ declare function AutoSummarize(options?: AutoSummarizeOptions): ClassDecorator;
58
+ declare function readAutoSummarizeMetadata(target: abstract new (...args: never) => unknown): (Required<Omit<AutoSummarizeOptions, "model">> & {
59
+ model?: string;
60
+ }) | undefined;
61
+
62
+ interface CronOptions {
63
+ schedule: string;
64
+ timezone?: string;
65
+ }
66
+ interface CronMetadata extends CronOptions {
67
+ methodKey: string | symbol;
68
+ }
69
+ declare function Cron(options: CronOptions): MethodDecorator;
70
+ declare function readCronMetadata(target: abstract new (...args: never) => unknown): CronMetadata | undefined;
71
+
72
+ interface EvalOptions {
73
+ name?: string;
74
+ scorers?: unknown[];
75
+ dataset?: unknown;
76
+ }
77
+ declare function EvalDecorator(options?: EvalOptions): ClassDecorator;
78
+ declare function readEvalDecoratorMetadata(target: Function): EvalOptions | undefined;
79
+
80
+ interface HitlOptions {
81
+ tools: string[];
82
+ timeoutMs?: number;
83
+ }
84
+ interface HitlMetadata extends HitlOptions {
85
+ methodKey: string | symbol;
86
+ }
87
+ declare function Hitl(options: HitlOptions): MethodDecorator;
88
+ declare function readHitlMetadata(target: abstract new (...args: never) => unknown): HitlMetadata | undefined;
89
+
90
+ interface MemoryScopeOptions {
91
+ path: string;
92
+ }
93
+ declare function MemoryScopeDecorator(options: MemoryScopeOptions): PropertyDecorator;
94
+ declare function readMemoryScopeMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, MemoryScopeOptions>;
95
+
96
+ interface RerankerOptions {
97
+ provider?: string;
98
+ model?: string;
99
+ topN?: number;
100
+ }
101
+ declare function Reranker(options: RerankerOptions): PropertyDecorator;
102
+ declare function readRerankerMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, RerankerOptions>;
103
+
104
+ interface RetrieverOptions {
105
+ topK?: number;
106
+ threshold?: number;
107
+ }
108
+ declare function Retriever(options: RetrieverOptions): PropertyDecorator;
109
+ declare function readRetrieverMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, RetrieverOptions>;
110
+
111
+ /**
112
+ * Metadata captured by the `@Squad()` property decorator. Declares a sequential
113
+ * agent team by referencing the agent property names that compose it. Mirrors
114
+ * the `@theokit/sdk` `createSquad` factory (decorator mandate — every agentic
115
+ * capability ships a decorator alongside the factory).
116
+ */
117
+ interface SquadMetadata {
118
+ /** Agent property names (or ids) that run in order. */
119
+ agents: string[];
120
+ /** Orchestration process. Default (omitted) = `"sequential"`. */
121
+ process?: "sequential" | "hierarchical";
122
+ /** Optional squad name. */
123
+ name?: string;
124
+ }
125
+ /**
126
+ * `@Squad(metadata)` — declare a sequential agent team on a property. The DI
127
+ * container / agent provider materializes it into a `createSquad(...)` at wiring
128
+ * time.
129
+ */
130
+ declare function Squad(metadata: SquadMetadata): PropertyDecorator;
131
+ /** Read `@Squad()` metadata off a class constructor. */
132
+ declare function readSquadMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SquadMetadata>;
133
+
134
+ /**
135
+ * Metadata captured by the `@Step()` method decorator. Declares one step of a
136
+ * decorator-driven workflow and its single upstream dependency. Compiled into
137
+ * a `@theokit/sdk` `Workflow` by `buildWorkflow` (decorator mandate — every
138
+ * agentic capability ships a decorator alongside the factory/builder).
139
+ */
140
+ interface StepMetadata {
141
+ /**
142
+ * Method name of the upstream step this step runs after. Omitted = entry
143
+ * step (receives the workflow input). MVP supports a single dependency
144
+ * (linear chain); branching/fan-out stays the imperative `Workflow` surface.
145
+ */
146
+ after?: string;
147
+ /** Optional step id (defaults to the method name). */
148
+ name?: string;
149
+ }
150
+ /**
151
+ * `@Step(metadata?)` — mark a class method as a workflow step. The method
152
+ * receives the upstream step's return value (or the workflow input for an
153
+ * entry step) and returns this step's output.
154
+ */
155
+ declare function Step(metadata?: StepMetadata): MethodDecorator;
156
+ /** Read `@Step()` metadata off a class constructor (insertion-ordered). */
157
+ declare function readStepMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, StepMetadata>;
158
+
159
+ interface SubAgentOptions {
160
+ name: string;
161
+ description: string;
162
+ instructions: string;
163
+ model?: string;
164
+ maxDelegationDepth?: number;
165
+ }
166
+ declare function SubAgent(options: SubAgentOptions): PropertyDecorator;
167
+ declare function readSubAgentMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SubAgentOptions>;
168
+
169
+ interface SubscriptionOptions {
170
+ name: string;
171
+ transport?: string;
172
+ }
173
+ declare function Subscription(options: SubscriptionOptions): PropertyDecorator;
174
+ declare function readSubscriptionMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, SubscriptionOptions>;
175
+
176
+ interface TextSplitterOptions {
177
+ strategy?: string;
178
+ chunkSize?: number;
179
+ overlap?: number;
180
+ }
181
+ declare function TextSplitter(options: TextSplitterOptions): PropertyDecorator;
182
+ declare function readTextSplitterMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, TextSplitterOptions>;
183
+
184
+ interface ToolOptions {
185
+ name: string;
186
+ description: string;
187
+ inputSchema?: unknown;
188
+ }
189
+ declare function Tool(options: ToolOptions): PropertyDecorator;
190
+ declare function readToolMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, ToolOptions>;
191
+
192
+ interface UseSandboxOptions {
193
+ backend?: "local" | "docker" | string;
194
+ workDir?: string;
195
+ timeoutMs?: number;
196
+ }
197
+ declare function UseSandbox(options?: UseSandboxOptions): PropertyDecorator;
198
+ declare function readSandboxMetadata(target: abstract new (...args: never) => unknown): ReadonlyMap<string | symbol, UseSandboxOptions>;
199
+
200
+ interface WorkflowOptions {
201
+ name?: string;
202
+ retryPolicy?: unknown;
203
+ inputSchema?: unknown;
204
+ outputSchema?: unknown;
205
+ }
206
+ declare function Workflow(options?: WorkflowOptions): ClassDecorator;
207
+ declare function readWorkflowMetadata(target: Function): WorkflowOptions | undefined;
208
+
44
209
  /**
45
210
  * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.
46
211
  * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.
@@ -64,4 +229,28 @@ declare function InjectAgent(): ParameterDecorator;
64
229
  */
65
230
  declare const AGENT_TOKEN = "@theokit/di-agent:Agent";
66
231
 
67
- export { AGENT_TOKEN, type CreateAgentProviderOptions, InjectAgent, createAgentProvider };
232
+ /**
233
+ * `buildWorkflow` — compile a `@Step`-decorated class instance into a
234
+ * `@theokit/sdk` `Workflow`.
235
+ *
236
+ * This is the materializer/bridge for the decorator-driven workflow authoring
237
+ * surface (cross-val Gap 2). It COMPOSES the existing `Workflow` engine — it
238
+ * adds no orchestration logic of its own (same principle as `createSquad`).
239
+ * Steps are topologically ordered by their single `after` dependency into a
240
+ * linear `Workflow.then(...)` chain; each step's return value is threaded into
241
+ * the next step. Branching/fan-out remains the imperative `Workflow` surface.
242
+ *
243
+ * NOTE: this module (unlike the metadata-only decorators) imports the
244
+ * `@theokit/sdk` peer dependency — it is the bridge layer.
245
+ */
246
+
247
+ /**
248
+ * Build a `Workflow` from a `@Step`-decorated instance. Validates the step
249
+ * graph (fail-fast) before constructing the workflow.
250
+ *
251
+ * @throws Error when there are no `@Step` methods, an `after` references an
252
+ * unknown step, or the `after` graph contains a cycle.
253
+ */
254
+ declare function buildWorkflow(instance: object): Workflow$1;
255
+
256
+ export { AGENT_TOKEN, Auth, type AuthOptions, AutoSummarize, type AutoSummarizeOptions, type CreateAgentProviderOptions, Cron, type CronMetadata, type CronOptions, EvalDecorator, type EvalOptions, Hitl, type HitlMetadata, type HitlOptions, InjectAgent, MemoryScopeDecorator, type MemoryScopeOptions, Reranker, type RerankerOptions, Retriever, type RetrieverOptions, Squad, type SquadMetadata, Step, type StepMetadata, SubAgent, type SubAgentOptions, Subscription, type SubscriptionOptions, TextSplitter, type TextSplitterOptions, Tool, type ToolOptions, UseSandbox, type UseSandboxOptions, Workflow, type WorkflowOptions, buildWorkflow, createAgentProvider, readAuthMetadata, readAutoSummarizeMetadata, readCronMetadata, readEvalDecoratorMetadata, readHitlMetadata, readMemoryScopeMetadata, readRerankerMetadata, readRetrieverMetadata, readSandboxMetadata, readSquadMetadata, readStepMetadata, readSubAgentMetadata, readSubscriptionMetadata, readTextSplitterMetadata, readToolMetadata, readWorkflowMetadata };
package/dist/index.js CHANGED
@@ -1,4 +1,6 @@
1
- import { Scope, Inject } from '@theokit/di';
1
+ import { Scope, METADATA_KEYS, Inject } from '@theokit/di';
2
+ import 'reflect-metadata';
3
+ import { Workflow as Workflow$1, fn } from '@theokit/sdk/workflow';
2
4
 
3
5
  var __defProp = Object.defineProperty;
4
6
  var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -15,11 +17,274 @@ function createAgentProvider(options) {
15
17
  };
16
18
  }
17
19
  __name(createAgentProvider, "createAgentProvider");
20
+ function Auth(options = {}) {
21
+ return (target) => {
22
+ Reflect.defineMetadata(METADATA_KEYS.AUTH, options, target);
23
+ };
24
+ }
25
+ __name(Auth, "Auth");
26
+ function readAuthMetadata(target) {
27
+ return Reflect.getMetadata(METADATA_KEYS.AUTH, target);
28
+ }
29
+ __name(readAuthMetadata, "readAuthMetadata");
30
+ var DEFAULTS = {
31
+ triggerFraction: 0.85,
32
+ keepNewest: 4
33
+ };
34
+ function AutoSummarize(options = {}) {
35
+ return (target) => {
36
+ const resolved = {
37
+ ...DEFAULTS,
38
+ ...options
39
+ };
40
+ Reflect.defineMetadata(METADATA_KEYS.AUTO_SUMMARIZE, resolved, target);
41
+ };
42
+ }
43
+ __name(AutoSummarize, "AutoSummarize");
44
+ function readAutoSummarizeMetadata(target) {
45
+ return Reflect.getMetadata(METADATA_KEYS.AUTO_SUMMARIZE, target);
46
+ }
47
+ __name(readAutoSummarizeMetadata, "readAutoSummarizeMetadata");
48
+ function Cron(options) {
49
+ return (target, propertyKey, _descriptor) => {
50
+ const metadata = {
51
+ ...options,
52
+ methodKey: propertyKey
53
+ };
54
+ Reflect.defineMetadata(METADATA_KEYS.CRON, metadata, target.constructor);
55
+ };
56
+ }
57
+ __name(Cron, "Cron");
58
+ function readCronMetadata(target) {
59
+ return Reflect.getMetadata(METADATA_KEYS.CRON, target);
60
+ }
61
+ __name(readCronMetadata, "readCronMetadata");
62
+ function EvalDecorator(options = {}) {
63
+ return (target) => {
64
+ Reflect.defineMetadata(METADATA_KEYS.EVAL, options, target);
65
+ };
66
+ }
67
+ __name(EvalDecorator, "EvalDecorator");
68
+ function readEvalDecoratorMetadata(target) {
69
+ return Reflect.getMetadata(METADATA_KEYS.EVAL, target);
70
+ }
71
+ __name(readEvalDecoratorMetadata, "readEvalDecoratorMetadata");
72
+ function Hitl(options) {
73
+ return (target, propertyKey, _descriptor) => {
74
+ const metadata = {
75
+ ...options,
76
+ methodKey: propertyKey
77
+ };
78
+ Reflect.defineMetadata(METADATA_KEYS.HITL, metadata, target.constructor);
79
+ };
80
+ }
81
+ __name(Hitl, "Hitl");
82
+ function readHitlMetadata(target) {
83
+ return Reflect.getMetadata(METADATA_KEYS.HITL, target);
84
+ }
85
+ __name(readHitlMetadata, "readHitlMetadata");
86
+ function MemoryScopeDecorator(options) {
87
+ return (target, propertyKey) => {
88
+ const existing = Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target.constructor) ?? /* @__PURE__ */ new Map();
89
+ existing.set(propertyKey, options);
90
+ Reflect.defineMetadata(METADATA_KEYS.MEMORY_SCOPE, existing, target.constructor);
91
+ };
92
+ }
93
+ __name(MemoryScopeDecorator, "MemoryScopeDecorator");
94
+ function readMemoryScopeMetadata(target) {
95
+ return Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target) ?? /* @__PURE__ */ new Map();
96
+ }
97
+ __name(readMemoryScopeMetadata, "readMemoryScopeMetadata");
98
+ function Reranker(options) {
99
+ return (target, propertyKey) => {
100
+ const existing = Reflect.getMetadata(METADATA_KEYS.RERANKER, target.constructor) ?? /* @__PURE__ */ new Map();
101
+ existing.set(propertyKey, options);
102
+ Reflect.defineMetadata(METADATA_KEYS.RERANKER, existing, target.constructor);
103
+ };
104
+ }
105
+ __name(Reranker, "Reranker");
106
+ function readRerankerMetadata(target) {
107
+ return Reflect.getMetadata(METADATA_KEYS.RERANKER, target) ?? /* @__PURE__ */ new Map();
108
+ }
109
+ __name(readRerankerMetadata, "readRerankerMetadata");
110
+ function Retriever(options) {
111
+ return (target, propertyKey) => {
112
+ const existing = Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target.constructor) ?? /* @__PURE__ */ new Map();
113
+ existing.set(propertyKey, options);
114
+ Reflect.defineMetadata(METADATA_KEYS.RETRIEVER, existing, target.constructor);
115
+ };
116
+ }
117
+ __name(Retriever, "Retriever");
118
+ function readRetrieverMetadata(target) {
119
+ return Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target) ?? /* @__PURE__ */ new Map();
120
+ }
121
+ __name(readRetrieverMetadata, "readRetrieverMetadata");
122
+ function Squad(metadata) {
123
+ return (target, propertyKey) => {
124
+ const existing = Reflect.getMetadata(METADATA_KEYS.SQUAD, target.constructor) ?? /* @__PURE__ */ new Map();
125
+ existing.set(propertyKey, metadata);
126
+ Reflect.defineMetadata(METADATA_KEYS.SQUAD, existing, target.constructor);
127
+ };
128
+ }
129
+ __name(Squad, "Squad");
130
+ function readSquadMetadata(target) {
131
+ return Reflect.getMetadata(METADATA_KEYS.SQUAD, target) ?? /* @__PURE__ */ new Map();
132
+ }
133
+ __name(readSquadMetadata, "readSquadMetadata");
134
+ function Step(metadata = {}) {
135
+ return (target, propertyKey) => {
136
+ const existing = Reflect.getMetadata(METADATA_KEYS.STEP, target.constructor) ?? /* @__PURE__ */ new Map();
137
+ existing.set(propertyKey, metadata);
138
+ Reflect.defineMetadata(METADATA_KEYS.STEP, existing, target.constructor);
139
+ };
140
+ }
141
+ __name(Step, "Step");
142
+ function readStepMetadata(target) {
143
+ return Reflect.getMetadata(METADATA_KEYS.STEP, target) ?? /* @__PURE__ */ new Map();
144
+ }
145
+ __name(readStepMetadata, "readStepMetadata");
146
+ function SubAgent(options) {
147
+ return (target, propertyKey) => {
148
+ const existing = Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target.constructor) ?? /* @__PURE__ */ new Map();
149
+ existing.set(propertyKey, options);
150
+ Reflect.defineMetadata(METADATA_KEYS.SUBAGENT, existing, target.constructor);
151
+ };
152
+ }
153
+ __name(SubAgent, "SubAgent");
154
+ function readSubAgentMetadata(target) {
155
+ return Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target) ?? /* @__PURE__ */ new Map();
156
+ }
157
+ __name(readSubAgentMetadata, "readSubAgentMetadata");
158
+ function Subscription(options) {
159
+ return (target, propertyKey) => {
160
+ const existing = Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target.constructor) ?? /* @__PURE__ */ new Map();
161
+ existing.set(propertyKey, options);
162
+ Reflect.defineMetadata(METADATA_KEYS.SUBSCRIPTION, existing, target.constructor);
163
+ };
164
+ }
165
+ __name(Subscription, "Subscription");
166
+ function readSubscriptionMetadata(target) {
167
+ return Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target) ?? /* @__PURE__ */ new Map();
168
+ }
169
+ __name(readSubscriptionMetadata, "readSubscriptionMetadata");
170
+ function TextSplitter(options) {
171
+ return (target, propertyKey) => {
172
+ const existing = Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target.constructor) ?? /* @__PURE__ */ new Map();
173
+ existing.set(propertyKey, options);
174
+ Reflect.defineMetadata(METADATA_KEYS.TEXT_SPLITTER, existing, target.constructor);
175
+ };
176
+ }
177
+ __name(TextSplitter, "TextSplitter");
178
+ function readTextSplitterMetadata(target) {
179
+ return Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target) ?? /* @__PURE__ */ new Map();
180
+ }
181
+ __name(readTextSplitterMetadata, "readTextSplitterMetadata");
182
+ function Tool(options) {
183
+ return (target, propertyKey) => {
184
+ const existing = Reflect.getMetadata(METADATA_KEYS.TOOL, target.constructor) ?? /* @__PURE__ */ new Map();
185
+ existing.set(propertyKey, options);
186
+ Reflect.defineMetadata(METADATA_KEYS.TOOL, existing, target.constructor);
187
+ };
188
+ }
189
+ __name(Tool, "Tool");
190
+ function readToolMetadata(target) {
191
+ return Reflect.getMetadata(METADATA_KEYS.TOOL, target) ?? /* @__PURE__ */ new Map();
192
+ }
193
+ __name(readToolMetadata, "readToolMetadata");
194
+ function UseSandbox(options = {}) {
195
+ return (target, propertyKey) => {
196
+ const existing = Reflect.getMetadata(METADATA_KEYS.SANDBOX, target.constructor) ?? /* @__PURE__ */ new Map();
197
+ existing.set(propertyKey, options);
198
+ Reflect.defineMetadata(METADATA_KEYS.SANDBOX, existing, target.constructor);
199
+ };
200
+ }
201
+ __name(UseSandbox, "UseSandbox");
202
+ function readSandboxMetadata(target) {
203
+ return Reflect.getMetadata(METADATA_KEYS.SANDBOX, target) ?? /* @__PURE__ */ new Map();
204
+ }
205
+ __name(readSandboxMetadata, "readSandboxMetadata");
206
+ function Workflow(options = {}) {
207
+ return (target) => {
208
+ Reflect.defineMetadata(METADATA_KEYS.WORKFLOW, options, target);
209
+ };
210
+ }
211
+ __name(Workflow, "Workflow");
212
+ function readWorkflowMetadata(target) {
213
+ return Reflect.getMetadata(METADATA_KEYS.WORKFLOW, target);
214
+ }
215
+ __name(readWorkflowMetadata, "readWorkflowMetadata");
18
216
  function InjectAgent() {
19
217
  return Inject(AGENT_TOKEN);
20
218
  }
21
219
  __name(InjectAgent, "InjectAgent");
220
+ function buildWorkflow(instance) {
221
+ const ctor = instance.constructor;
222
+ const meta = readStepMetadata(ctor);
223
+ if (meta.size === 0) {
224
+ throw new Error(`buildWorkflow: class "${instance.constructor.name}" has no @Step methods`);
225
+ }
226
+ const steps = resolveSteps(instance, meta);
227
+ validateAfterTargets(steps);
228
+ const ordered = topoSort(steps);
229
+ const name = readWorkflowMetadata(instance.constructor)?.name ?? "workflow";
230
+ let builder = Workflow$1.create({
231
+ name
232
+ });
233
+ for (const s of ordered) {
234
+ builder = builder.then(fn(s.id, (input) => s.run(input)));
235
+ }
236
+ return builder.commit();
237
+ }
238
+ __name(buildWorkflow, "buildWorkflow");
239
+ function resolveSteps(instance, meta) {
240
+ const steps = /* @__PURE__ */ new Map();
241
+ for (const [key, m] of meta) {
242
+ const k = String(key);
243
+ const method = instance[k];
244
+ if (typeof method !== "function") {
245
+ throw new Error(`buildWorkflow: @Step "${k}" is not a method`);
246
+ }
247
+ steps.set(k, {
248
+ key: k,
249
+ id: m.name ?? k,
250
+ after: m.after,
251
+ run: /* @__PURE__ */ __name((input) => method.call(instance, input), "run")
252
+ });
253
+ }
254
+ return steps;
255
+ }
256
+ __name(resolveSteps, "resolveSteps");
257
+ function validateAfterTargets(steps) {
258
+ for (const s of steps.values()) {
259
+ if (s.after !== void 0 && !steps.has(s.after)) {
260
+ throw new Error(`buildWorkflow: @Step "${s.key}" declares after: "${s.after}" which is not a known @Step (unknown upstream)`);
261
+ }
262
+ }
263
+ }
264
+ __name(validateAfterTargets, "validateAfterTargets");
265
+ function topoSort(steps) {
266
+ const ordered = [];
267
+ const placed = /* @__PURE__ */ new Set();
268
+ const visiting = /* @__PURE__ */ new Set();
269
+ const visit = /* @__PURE__ */ __name((s) => {
270
+ if (placed.has(s.key)) return;
271
+ if (visiting.has(s.key)) {
272
+ throw new Error(`buildWorkflow: cycle detected in @Step "after" graph at "${s.key}"`);
273
+ }
274
+ visiting.add(s.key);
275
+ if (s.after !== void 0) {
276
+ const up = steps.get(s.after);
277
+ if (up !== void 0) visit(up);
278
+ }
279
+ visiting.delete(s.key);
280
+ placed.add(s.key);
281
+ ordered.push(s);
282
+ }, "visit");
283
+ for (const s of steps.values()) visit(s);
284
+ return ordered;
285
+ }
286
+ __name(topoSort, "topoSort");
22
287
 
23
- export { AGENT_TOKEN, InjectAgent, createAgentProvider };
288
+ export { AGENT_TOKEN, Auth, AutoSummarize, Cron, EvalDecorator, Hitl, InjectAgent, MemoryScopeDecorator, Reranker, Retriever, Squad, Step, SubAgent, Subscription, TextSplitter, Tool, UseSandbox, Workflow, buildWorkflow, createAgentProvider, readAuthMetadata, readAutoSummarizeMetadata, readCronMetadata, readEvalDecoratorMetadata, readHitlMetadata, readMemoryScopeMetadata, readRerankerMetadata, readRetrieverMetadata, readSandboxMetadata, readSquadMetadata, readStepMetadata, readSubAgentMetadata, readSubscriptionMetadata, readTextSplitterMetadata, readToolMetadata, readWorkflowMetadata };
24
289
  //# sourceMappingURL=index.js.map
25
290
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/tokens.ts","../src/agent-provider.ts","../src/inject-agent.ts"],"names":["AGENT_TOKEN","createAgentProvider","options","provide","useFactory","factory","scope","Scope","REQUEST","InjectAgent","Inject"],"mappings":";;;;;;AAKO,IAAMA,WAAAA,GAAc;;;ACuCpB,SAASC,oBACdC,OAAAA,EAA2C;AAE3C,EAAA,OAAO;IACLC,OAAAA,EAASH,WAAAA;IACTI,UAAAA,kBAAY,MAAA,CAAA,MAAMF,OAAAA,CAAQG,OAAAA,EAAO,EAArB,YAAA,CAAA;IACZC,KAAAA,EAAOJ,OAAAA,CAAQI,SAASC,KAAAA,CAAMC;AAChC,GAAA;AACF;AARgBP,MAAAA,CAAAA,mBAAAA,EAAAA,qBAAAA,CAAAA;AC1BT,SAASQ,WAAAA,GAAAA;AACd,EAAA,OAAOC,OAAOV,WAAAA,CAAAA;AAChB;AAFgBS,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"index.js","sourcesContent":["/**\n * Token used by `@InjectAgent()` to look up the Agent provider. Importing\n * this directly (instead of using the decorator) lets you register a\n * custom factory under the same token.\n */\nexport const AGENT_TOKEN = \"@theokit/di-agent:Agent\";\n","import { type FactoryProvider, Scope } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Options accepted by `createAgentProvider()`. Mirrors the public\n * `AgentOptions` from `@theokit/sdk` but kept structural so this package\n * does not have a hard import dependency on the SDK's type tree.\n *\n * The factory `async () => Agent.create(options)` is provided by the\n * consumer (see `createAgentProvider` below). This package supplies the\n * scope + token wiring.\n */\nexport interface CreateAgentProviderOptions<TAgent> {\n /**\n * Factory function that produces a fresh Agent per REQUEST.\n * Typically `() => Agent.create({...})` from `@theokit/sdk`.\n */\n factory: () => TAgent | Promise<TAgent>;\n /**\n * Override the scope. Default is `REQUEST` (the wedge — one isolated\n * Agent per HTTP request). Override to `SINGLETON` for CLI / cron /\n * single-tenant scenarios where a shared Agent is desirable.\n */\n scope?: Scope;\n}\n\n/**\n * Build a `FactoryProvider` that materializes an Agent on demand.\n *\n * @example\n * import { Agent } from \"@theokit/sdk\";\n * import { Module } from \"@theokit/di\";\n * import { createAgentProvider } from \"@theokit/di-agent\";\n *\n * @Module({\n * providers: [\n * createAgentProvider({\n * factory: () => Agent.create({ apiKey: process.env.OPENROUTER_API_KEY!, model: { id: \"openai/gpt-4o-mini\" } }),\n * }),\n * ],\n * })\n * class AppModule {}\n */\nexport function createAgentProvider<TAgent>(\n options: CreateAgentProviderOptions<TAgent>,\n): FactoryProvider<TAgent> {\n return {\n provide: AGENT_TOKEN,\n useFactory: () => options.factory(),\n scope: options.scope ?? Scope.REQUEST,\n };\n}\n","import { Inject } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.\n * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.\n *\n * @example\n * @Injectable()\n * class ChatController {\n * constructor(@InjectAgent() private readonly agent: Agent) {}\n *\n * async chat(message: string) {\n * return this.agent.send(message);\n * }\n * }\n */\nexport function InjectAgent(): ParameterDecorator {\n return Inject(AGENT_TOKEN);\n}\n"]}
1
+ {"version":3,"sources":["../src/tokens.ts","../src/agent-provider.ts","../src/decorators/auth.ts","../src/decorators/auto-summarize.ts","../src/decorators/cron.ts","../src/decorators/eval-decorator.ts","../src/decorators/hitl.ts","../src/decorators/memory-scope.ts","../src/decorators/reranker.ts","../src/decorators/retriever.ts","../src/decorators/squad.ts","../src/decorators/step.ts","../src/decorators/sub-agent.ts","../src/decorators/subscription.ts","../src/decorators/text-splitter.ts","../src/decorators/tool.ts","../src/decorators/use-sandbox.ts","../src/decorators/workflow.ts","../src/inject-agent.ts","../src/workflow-builder.ts"],"names":["AGENT_TOKEN","createAgentProvider","options","provide","useFactory","factory","scope","Scope","REQUEST","Auth","target","Reflect","defineMetadata","METADATA_KEYS","AUTH","readAuthMetadata","getMetadata","DEFAULTS","triggerFraction","keepNewest","AutoSummarize","resolved","AUTO_SUMMARIZE","readAutoSummarizeMetadata","Cron","propertyKey","_descriptor","metadata","methodKey","CRON","readCronMetadata","EvalDecorator","EVAL","readEvalDecoratorMetadata","Hitl","HITL","readHitlMetadata","MemoryScopeDecorator","existing","MEMORY_SCOPE","Map","set","readMemoryScopeMetadata","Reranker","RERANKER","readRerankerMetadata","Retriever","RETRIEVER","readRetrieverMetadata","Squad","SQUAD","readSquadMetadata","Step","STEP","readStepMetadata","SubAgent","SUBAGENT","readSubAgentMetadata","Subscription","SUBSCRIPTION","readSubscriptionMetadata","TextSplitter","TEXT_SPLITTER","readTextSplitterMetadata","Tool","TOOL","readToolMetadata","UseSandbox","SANDBOX","readSandboxMetadata","Workflow","WORKFLOW","readWorkflowMetadata","InjectAgent","Inject","buildWorkflow","instance","ctor","meta","size","Error","name","steps","resolveSteps","validateAfterTargets","ordered","topoSort","builder","create","s","then","fn","id","input","run","commit","key","m","k","String","method","after","call","values","undefined","has","placed","Set","visiting","visit","add","up","get","delete","push"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Token used by `@InjectAgent()` to look up the Agent provider. Importing\n * this directly (instead of using the decorator) lets you register a\n * custom factory under the same token.\n */\nexport const AGENT_TOKEN = \"@theokit/di-agent:Agent\";\n","import { type FactoryProvider, Scope } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Options accepted by `createAgentProvider()`. Mirrors the public\n * `AgentOptions` from `@theokit/sdk` but kept structural so this package\n * does not have a hard import dependency on the SDK's type tree.\n *\n * The factory `async () => Agent.create(options)` is provided by the\n * consumer (see `createAgentProvider` below). This package supplies the\n * scope + token wiring.\n */\nexport interface CreateAgentProviderOptions<TAgent> {\n /**\n * Factory function that produces a fresh Agent per REQUEST.\n * Typically `() => Agent.create({...})` from `@theokit/sdk`.\n */\n factory: () => TAgent | Promise<TAgent>;\n /**\n * Override the scope. Default is `REQUEST` (the wedge — one isolated\n * Agent per HTTP request). Override to `SINGLETON` for CLI / cron /\n * single-tenant scenarios where a shared Agent is desirable.\n */\n scope?: Scope;\n}\n\n/**\n * Build a `FactoryProvider` that materializes an Agent on demand.\n *\n * @example\n * import { Agent } from \"@theokit/sdk\";\n * import { Module } from \"@theokit/di\";\n * import { createAgentProvider } from \"@theokit/di-agent\";\n *\n * @Module({\n * providers: [\n * createAgentProvider({\n * factory: () => Agent.create({ apiKey: process.env.OPENROUTER_API_KEY!, model: { id: \"openai/gpt-4o-mini\" } }),\n * }),\n * ],\n * })\n * class AppModule {}\n */\nexport function createAgentProvider<TAgent>(\n options: CreateAgentProviderOptions<TAgent>,\n): FactoryProvider<TAgent> {\n return {\n provide: AGENT_TOKEN,\n useFactory: () => options.factory(),\n scope: options.scope ?? Scope.REQUEST,\n };\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface AuthOptions {\n providers?: string[];\n sessionConfig?: unknown;\n}\n\nexport function Auth(options: AuthOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.AUTH, options, target);\n };\n}\n\nexport function readAuthMetadata(target: Function): AuthOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.AUTH, target) as AuthOptions | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface AutoSummarizeOptions {\n triggerFraction?: number;\n keepNewest?: number;\n model?: string;\n}\n\nconst DEFAULTS: Required<Omit<AutoSummarizeOptions, \"model\">> = {\n triggerFraction: 0.85,\n keepNewest: 4,\n};\n\nexport function AutoSummarize(options: AutoSummarizeOptions = {}): ClassDecorator {\n return (target: Function) => {\n const resolved = { ...DEFAULTS, ...options };\n Reflect.defineMetadata(METADATA_KEYS.AUTO_SUMMARIZE, resolved, target);\n };\n}\n\nexport function readAutoSummarizeMetadata(\n target: abstract new (...args: never) => unknown,\n): (Required<Omit<AutoSummarizeOptions, \"model\">> & { model?: string }) | undefined {\n return Reflect.getMetadata(METADATA_KEYS.AUTO_SUMMARIZE, target) as\n | (Required<Omit<AutoSummarizeOptions, \"model\">> & { model?: string })\n | undefined;\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface CronOptions {\n schedule: string;\n timezone?: string;\n}\n\nexport interface CronMetadata extends CronOptions {\n methodKey: string | symbol;\n}\n\nexport function Cron(options: CronOptions): MethodDecorator {\n return (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => {\n const metadata: CronMetadata = { ...options, methodKey: propertyKey };\n Reflect.defineMetadata(METADATA_KEYS.CRON, metadata, target.constructor);\n };\n}\n\nexport function readCronMetadata(\n target: abstract new (...args: never) => unknown,\n): CronMetadata | undefined {\n return Reflect.getMetadata(METADATA_KEYS.CRON, target) as CronMetadata | undefined;\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface EvalOptions {\n name?: string;\n scorers?: unknown[];\n dataset?: unknown;\n}\n\nexport function EvalDecorator(options: EvalOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.EVAL, options, target);\n };\n}\n\nexport function readEvalDecoratorMetadata(target: Function): EvalOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.EVAL, target) as EvalOptions | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface HitlOptions {\n tools: string[];\n timeoutMs?: number;\n}\n\nexport interface HitlMetadata extends HitlOptions {\n methodKey: string | symbol;\n}\n\nexport function Hitl(options: HitlOptions): MethodDecorator {\n return (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => {\n const metadata: HitlMetadata = { ...options, methodKey: propertyKey };\n Reflect.defineMetadata(METADATA_KEYS.HITL, metadata, target.constructor);\n };\n}\n\nexport function readHitlMetadata(\n target: abstract new (...args: never) => unknown,\n): HitlMetadata | undefined {\n return Reflect.getMetadata(METADATA_KEYS.HITL, target) as HitlMetadata | undefined;\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface MemoryScopeOptions {\n path: string;\n}\n\nexport function MemoryScopeDecorator(options: MemoryScopeOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, MemoryScopeOptions> =\n Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.MEMORY_SCOPE, existing, target.constructor);\n };\n}\n\nexport function readMemoryScopeMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, MemoryScopeOptions> {\n return Reflect.getMetadata(METADATA_KEYS.MEMORY_SCOPE, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface RerankerOptions {\n provider?: string;\n model?: string;\n topN?: number;\n}\n\nexport function Reranker(options: RerankerOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, RerankerOptions> =\n Reflect.getMetadata(METADATA_KEYS.RERANKER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.RERANKER, existing, target.constructor);\n };\n}\n\nexport function readRerankerMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, RerankerOptions> {\n return Reflect.getMetadata(METADATA_KEYS.RERANKER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface RetrieverOptions {\n topK?: number;\n threshold?: number;\n}\n\nexport function Retriever(options: RetrieverOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, RetrieverOptions> =\n Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.RETRIEVER, existing, target.constructor);\n };\n}\n\nexport function readRetrieverMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, RetrieverOptions> {\n return Reflect.getMetadata(METADATA_KEYS.RETRIEVER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\n/**\n * Metadata captured by the `@Squad()` property decorator. Declares a sequential\n * agent team by referencing the agent property names that compose it. Mirrors\n * the `@theokit/sdk` `createSquad` factory (decorator mandate — every agentic\n * capability ships a decorator alongside the factory).\n */\nexport interface SquadMetadata {\n /** Agent property names (or ids) that run in order. */\n agents: string[];\n /** Orchestration process. Default (omitted) = `\"sequential\"`. */\n process?: \"sequential\" | \"hierarchical\";\n /** Optional squad name. */\n name?: string;\n}\n\n/**\n * `@Squad(metadata)` — declare a sequential agent team on a property. The DI\n * container / agent provider materializes it into a `createSquad(...)` at wiring\n * time.\n */\nexport function Squad(metadata: SquadMetadata): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SquadMetadata> =\n Reflect.getMetadata(METADATA_KEYS.SQUAD, target.constructor) ?? new Map();\n existing.set(propertyKey, metadata);\n Reflect.defineMetadata(METADATA_KEYS.SQUAD, existing, target.constructor);\n };\n}\n\n/** Read `@Squad()` metadata off a class constructor. */\nexport function readSquadMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SquadMetadata> {\n return Reflect.getMetadata(METADATA_KEYS.SQUAD, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\n/**\n * Metadata captured by the `@Step()` method decorator. Declares one step of a\n * decorator-driven workflow and its single upstream dependency. Compiled into\n * a `@theokit/sdk` `Workflow` by `buildWorkflow` (decorator mandate — every\n * agentic capability ships a decorator alongside the factory/builder).\n */\nexport interface StepMetadata {\n /**\n * Method name of the upstream step this step runs after. Omitted = entry\n * step (receives the workflow input). MVP supports a single dependency\n * (linear chain); branching/fan-out stays the imperative `Workflow` surface.\n */\n after?: string;\n /** Optional step id (defaults to the method name). */\n name?: string;\n}\n\n/**\n * `@Step(metadata?)` — mark a class method as a workflow step. The method\n * receives the upstream step's return value (or the workflow input for an\n * entry step) and returns this step's output.\n */\nexport function Step(metadata: StepMetadata = {}): MethodDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, StepMetadata> =\n Reflect.getMetadata(METADATA_KEYS.STEP, target.constructor) ?? new Map();\n existing.set(propertyKey, metadata);\n Reflect.defineMetadata(METADATA_KEYS.STEP, existing, target.constructor);\n };\n}\n\n/** Read `@Step()` metadata off a class constructor (insertion-ordered). */\nexport function readStepMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, StepMetadata> {\n return Reflect.getMetadata(METADATA_KEYS.STEP, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface SubAgentOptions {\n name: string;\n description: string;\n instructions: string;\n model?: string;\n maxDelegationDepth?: number;\n}\n\nexport function SubAgent(options: SubAgentOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SubAgentOptions> =\n Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SUBAGENT, existing, target.constructor);\n };\n}\n\nexport function readSubAgentMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SubAgentOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SUBAGENT, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface SubscriptionOptions {\n name: string;\n transport?: string;\n}\n\nexport function Subscription(options: SubscriptionOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, SubscriptionOptions> =\n Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SUBSCRIPTION, existing, target.constructor);\n };\n}\n\nexport function readSubscriptionMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, SubscriptionOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SUBSCRIPTION, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface TextSplitterOptions {\n strategy?: string;\n chunkSize?: number;\n overlap?: number;\n}\n\nexport function TextSplitter(options: TextSplitterOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, TextSplitterOptions> =\n Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.TEXT_SPLITTER, existing, target.constructor);\n };\n}\n\nexport function readTextSplitterMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, TextSplitterOptions> {\n return Reflect.getMetadata(METADATA_KEYS.TEXT_SPLITTER, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface ToolOptions {\n name: string;\n description: string;\n inputSchema?: unknown;\n}\n\nexport function Tool(options: ToolOptions): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, ToolOptions> =\n Reflect.getMetadata(METADATA_KEYS.TOOL, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.TOOL, existing, target.constructor);\n };\n}\n\nexport function readToolMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, ToolOptions> {\n return Reflect.getMetadata(METADATA_KEYS.TOOL, target) ?? new Map();\n}\n","import \"reflect-metadata\";\n\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface UseSandboxOptions {\n backend?: \"local\" | \"docker\" | string;\n workDir?: string;\n timeoutMs?: number;\n}\n\nexport function UseSandbox(options: UseSandboxOptions = {}): PropertyDecorator {\n return (target: object, propertyKey: string | symbol) => {\n const existing: Map<string | symbol, UseSandboxOptions> =\n Reflect.getMetadata(METADATA_KEYS.SANDBOX, target.constructor) ?? new Map();\n existing.set(propertyKey, options);\n Reflect.defineMetadata(METADATA_KEYS.SANDBOX, existing, target.constructor);\n };\n}\n\nexport function readSandboxMetadata(\n target: abstract new (...args: never) => unknown,\n): ReadonlyMap<string | symbol, UseSandboxOptions> {\n return Reflect.getMetadata(METADATA_KEYS.SANDBOX, target) ?? new Map();\n}\n","import \"reflect-metadata\";\nimport { METADATA_KEYS } from \"@theokit/di\";\n\nexport interface WorkflowOptions {\n name?: string;\n retryPolicy?: unknown;\n inputSchema?: unknown;\n outputSchema?: unknown;\n}\n\nexport function Workflow(options: WorkflowOptions = {}): ClassDecorator {\n return (target: Function) => {\n Reflect.defineMetadata(METADATA_KEYS.WORKFLOW, options, target);\n };\n}\n\nexport function readWorkflowMetadata(target: Function): WorkflowOptions | undefined {\n return Reflect.getMetadata(METADATA_KEYS.WORKFLOW, target) as WorkflowOptions | undefined;\n}\n","import { Inject } from \"@theokit/di\";\n\nimport { AGENT_TOKEN } from \"./tokens.js\";\n\n/**\n * Parameter decorator — injects the REQUEST-scoped Agent into a constructor.\n * Equivalent to `@Inject(AGENT_TOKEN)` but documents intent.\n *\n * @example\n * @Injectable()\n * class ChatController {\n * constructor(@InjectAgent() private readonly agent: Agent) {}\n *\n * async chat(message: string) {\n * return this.agent.send(message);\n * }\n * }\n */\nexport function InjectAgent(): ParameterDecorator {\n return Inject(AGENT_TOKEN);\n}\n","/**\n * `buildWorkflow` — compile a `@Step`-decorated class instance into a\n * `@theokit/sdk` `Workflow`.\n *\n * This is the materializer/bridge for the decorator-driven workflow authoring\n * surface (cross-val Gap 2). It COMPOSES the existing `Workflow` engine — it\n * adds no orchestration logic of its own (same principle as `createSquad`).\n * Steps are topologically ordered by their single `after` dependency into a\n * linear `Workflow.then(...)` chain; each step's return value is threaded into\n * the next step. Branching/fan-out remains the imperative `Workflow` surface.\n *\n * NOTE: this module (unlike the metadata-only decorators) imports the\n * `@theokit/sdk` peer dependency — it is the bridge layer.\n */\n\nimport { fn, Workflow } from \"@theokit/sdk/workflow\";\nimport { readStepMetadata, type StepMetadata } from \"./decorators/step.js\";\nimport { readWorkflowMetadata } from \"./decorators/workflow.js\";\n\ninterface ResolvedStep {\n key: string;\n id: string;\n after?: string;\n run: (input: unknown) => unknown;\n}\n\n/**\n * Build a `Workflow` from a `@Step`-decorated instance. Validates the step\n * graph (fail-fast) before constructing the workflow.\n *\n * @throws Error when there are no `@Step` methods, an `after` references an\n * unknown step, or the `after` graph contains a cycle.\n */\nexport function buildWorkflow(instance: object): Workflow {\n const ctor = instance.constructor as abstract new (...args: never) => unknown;\n const meta = readStepMetadata(ctor);\n if (meta.size === 0) {\n throw new Error(`buildWorkflow: class \"${instance.constructor.name}\" has no @Step methods`);\n }\n\n const steps = resolveSteps(instance, meta);\n validateAfterTargets(steps);\n const ordered = topoSort(steps);\n\n const name = readWorkflowMetadata(instance.constructor as Function)?.name ?? \"workflow\";\n let builder = Workflow.create({ name });\n for (const s of ordered) {\n builder = builder.then(fn(s.id, (input: unknown) => s.run(input)));\n }\n return builder.commit();\n}\n\n/** Resolve each `@Step` method into a runnable {@link ResolvedStep}. */\nfunction resolveSteps(\n instance: object,\n meta: ReadonlyMap<string | symbol, StepMetadata>,\n): Map<string, ResolvedStep> {\n const steps = new Map<string, ResolvedStep>();\n for (const [key, m] of meta) {\n const k = String(key);\n const method = (instance as Record<string, unknown>)[k];\n if (typeof method !== \"function\") {\n throw new Error(`buildWorkflow: @Step \"${k}\" is not a method`);\n }\n steps.set(k, {\n key: k,\n id: m.name ?? k,\n after: m.after,\n run: (input: unknown) => (method as (i: unknown) => unknown).call(instance, input),\n });\n }\n return steps;\n}\n\n/** Fail-fast if any `after` references a step that does not exist. */\nfunction validateAfterTargets(steps: Map<string, ResolvedStep>): void {\n for (const s of steps.values()) {\n if (s.after !== undefined && !steps.has(s.after)) {\n throw new Error(\n `buildWorkflow: @Step \"${s.key}\" declares after: \"${s.after}\" which is not a known @Step (unknown upstream)`,\n );\n }\n }\n}\n\n/**\n * Topologically order steps by their single `after` dependency. Entry steps\n * (no `after`) come first in declaration order; each dependent follows its\n * upstream. Throws on a cycle.\n */\nfunction topoSort(steps: Map<string, ResolvedStep>): ResolvedStep[] {\n const ordered: ResolvedStep[] = [];\n const placed = new Set<string>();\n const visiting = new Set<string>();\n\n const visit = (s: ResolvedStep): void => {\n if (placed.has(s.key)) return;\n if (visiting.has(s.key)) {\n throw new Error(`buildWorkflow: cycle detected in @Step \"after\" graph at \"${s.key}\"`);\n }\n visiting.add(s.key);\n if (s.after !== undefined) {\n const up = steps.get(s.after);\n if (up !== undefined) visit(up);\n }\n visiting.delete(s.key);\n placed.add(s.key);\n ordered.push(s);\n };\n\n for (const s of steps.values()) visit(s);\n return ordered;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theokit/di-agent",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Agent-first DI integration for @theokit/di. Ships @InjectAgent() decorator + createAgentProvider() helper that produces a REQUEST-scoped Agent factory — so every HTTP request gets an isolated @theokit/sdk Agent automatically.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/usetheo/theokit-sdk#readme",
@@ -35,18 +35,12 @@
35
35
  "LICENSE",
36
36
  "CHANGELOG.md"
37
37
  ],
38
- "scripts": {
39
- "build": "tsup",
40
- "typecheck": "tsc --noEmit",
41
- "test": "vitest run --passWithNoTests",
42
- "test:coverage": "vitest run --coverage --passWithNoTests"
43
- },
44
38
  "keywords": [
45
39
  "dependency-injection",
46
40
  "di",
47
41
  "agent",
48
42
  "theokit",
49
- "usetheo"
43
+ "Theo"
50
44
  ],
51
45
  "peerDependencies": {
52
46
  "@theokit/di": "^0.1.0-next.0",
@@ -55,15 +49,21 @@
55
49
  },
56
50
  "devDependencies": {
57
51
  "@swc/core": "^1.15.40",
58
- "@theokit/di": "workspace:*",
59
- "@theokit/sdk": "workspace:*",
60
52
  "reflect-metadata": "^0.2.0",
61
53
  "tsup": "^8.5.0",
62
54
  "typescript": "^5.8.0",
63
55
  "unplugin-swc": "^1.5.9",
64
- "vitest": "^3.0.0"
56
+ "vitest": "^4.1.8",
57
+ "@theokit/di": "0.1.1",
58
+ "@theokit/sdk": "1.9.0"
65
59
  },
66
60
  "publishConfig": {
67
61
  "access": "public"
62
+ },
63
+ "scripts": {
64
+ "build": "tsup",
65
+ "typecheck": "tsc --noEmit",
66
+ "test": "vitest run --passWithNoTests",
67
+ "test:coverage": "vitest run --coverage --passWithNoTests"
68
68
  }
69
- }
69
+ }