kernl 0.7.4 → 0.8.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/.turbo/turbo-build.log +1 -1
- package/CHANGELOG.md +19 -1
- package/dist/agent/types.d.ts +20 -12
- package/dist/agent/types.d.ts.map +1 -1
- package/dist/agent.d.ts +7 -7
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +3 -14
- package/dist/api/resources/agents/agents.d.ts +5 -5
- package/dist/api/resources/agents/agents.d.ts.map +1 -1
- package/dist/api/resources/agents/agents.js +1 -1
- package/dist/guardrail.d.ts +19 -19
- package/dist/guardrail.d.ts.map +1 -1
- package/dist/kernl/kernl.d.ts +6 -6
- package/dist/kernl/kernl.d.ts.map +1 -1
- package/dist/lib/error.d.ts +3 -3
- package/dist/lib/error.d.ts.map +1 -1
- package/dist/lifecycle.d.ts +6 -6
- package/dist/lifecycle.d.ts.map +1 -1
- package/dist/memory/__tests__/encoder.test.d.ts +2 -0
- package/dist/memory/__tests__/encoder.test.d.ts.map +1 -0
- package/dist/memory/__tests__/encoder.test.js +120 -0
- package/dist/memory/codecs/domain.d.ts +5 -0
- package/dist/memory/codecs/domain.d.ts.map +1 -1
- package/dist/memory/codecs/domain.js +6 -0
- package/dist/memory/encoder.d.ts +25 -2
- package/dist/memory/encoder.d.ts.map +1 -1
- package/dist/memory/encoder.js +46 -5
- package/dist/memory/index.d.ts +1 -1
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/memory/index.js +1 -1
- package/dist/memory/schema.d.ts.map +1 -1
- package/dist/memory/schema.js +5 -0
- package/dist/memory/types.d.ts +1 -0
- package/dist/memory/types.d.ts.map +1 -1
- package/dist/thread/__tests__/integration.test.js +1 -1
- package/dist/thread/__tests__/thread.test.js +8 -8
- package/dist/thread/thread.d.ts +5 -5
- package/dist/thread/thread.d.ts.map +1 -1
- package/dist/thread/thread.js +13 -2
- package/dist/thread/types.d.ts +9 -6
- package/dist/thread/types.d.ts.map +1 -1
- package/dist/thread/utils.d.ts +7 -6
- package/dist/thread/utils.d.ts.map +1 -1
- package/dist/thread/utils.js +9 -8
- package/package.json +5 -4
- package/src/agent/types.ts +25 -29
- package/src/agent.ts +15 -28
- package/src/api/resources/agents/agents.ts +8 -8
- package/src/guardrail.ts +28 -28
- package/src/kernl/kernl.ts +12 -12
- package/src/lib/error.ts +3 -3
- package/src/lifecycle.ts +6 -6
- package/src/memory/__tests__/encoder.test.ts +153 -0
- package/src/memory/codecs/domain.ts +6 -0
- package/src/memory/encoder.ts +51 -6
- package/src/memory/index.ts +1 -1
- package/src/memory/schema.ts +5 -0
- package/src/memory/types.ts +1 -0
- package/src/thread/__tests__/integration.test.ts +130 -146
- package/src/thread/__tests__/thread.test.ts +8 -8
- package/src/thread/thread.ts +21 -7
- package/src/thread/types.ts +9 -6
- package/src/thread/utils.ts +15 -14
package/.turbo/turbo-build.log
CHANGED
package/CHANGELOG.md
CHANGED
|
@@ -1,10 +1,28 @@
|
|
|
1
1
|
# @kernl/core
|
|
2
2
|
|
|
3
|
+
## 0.8.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 3fe8682: Add native structured output support for agents
|
|
8
|
+
|
|
9
|
+
**kernl**
|
|
10
|
+
- Add `output` field to Agent config (Zod schema for structured responses)
|
|
11
|
+
- Rename type params: `TResponse` → `TOutput`, `AgentResponseType` → `AgentOutputType`
|
|
12
|
+
- Wire `agent.output` through Thread to protocol's `responseType`
|
|
13
|
+
|
|
14
|
+
**@kernl-sdk/ai**
|
|
15
|
+
- Add `RESPONSE_FORMAT` codec for AI SDK's `responseFormat` parameter
|
|
16
|
+
- Add structured output integration tests for OpenAI, Anthropic, and Google
|
|
17
|
+
|
|
3
18
|
## 0.7.4
|
|
4
19
|
|
|
5
20
|
### Patch Changes
|
|
6
21
|
|
|
7
|
-
-
|
|
22
|
+
- 6a6aa03: Add ObjectTextCodec for YAML-based object projection in memory indexing
|
|
23
|
+
- Memory encoder now produces `objtext` field for FTS on structured objects
|
|
24
|
+
- Embedding input combines text + objtext for richer semantic search
|
|
25
|
+
- Fix domain codec to properly preserve user metadata (record.metadata)
|
|
8
26
|
|
|
9
27
|
## 0.7.3
|
|
10
28
|
|
package/dist/agent/types.d.ts
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { type ZodType } from "zod";
|
|
2
|
-
import { Context, UnknownContext } from "../context.js";
|
|
3
2
|
import { LanguageModel, LanguageModelRequestSettings } from "@kernl-sdk/protocol";
|
|
3
|
+
import { Context, UnknownContext } from "../context.js";
|
|
4
4
|
import { InputGuardrail, OutputGuardrail } from "../guardrail.js";
|
|
5
5
|
import { BaseToolkit } from "../tool/index.js";
|
|
6
|
-
import {
|
|
6
|
+
import { TextOutput } from "../thread/types.js";
|
|
7
7
|
/**
|
|
8
8
|
* Configuration for an agent.
|
|
9
9
|
*/
|
|
10
|
-
export interface AgentConfig<TContext = UnknownContext,
|
|
10
|
+
export interface AgentConfig<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> {
|
|
11
11
|
id: string;
|
|
12
12
|
name: string;
|
|
13
13
|
description?: string;
|
|
@@ -30,6 +30,18 @@ export interface AgentConfig<TContext = UnknownContext, TResponse extends AgentR
|
|
|
30
30
|
* Configures model-specific tuning parameters (e.g. temperature, top_p, etc.)
|
|
31
31
|
*/
|
|
32
32
|
modelSettings?: LanguageModelRequestSettings;
|
|
33
|
+
/**
|
|
34
|
+
* The type of the output that the agent will return.
|
|
35
|
+
*
|
|
36
|
+
* Can be either:
|
|
37
|
+
* - `"text"` (default): The agent returns a plain string response
|
|
38
|
+
* - A Zod schema: The agent returns structured output validated against the schema
|
|
39
|
+
*
|
|
40
|
+
* When a Zod schema is provided, the output is converted to JSON Schema and sent to the
|
|
41
|
+
* model for native structured output support. The response is then validated against
|
|
42
|
+
* the Zod schema as a safety net.
|
|
43
|
+
*/
|
|
44
|
+
output?: TOutput;
|
|
33
45
|
/**
|
|
34
46
|
* A list of toolkits the agent can use. Toolkits are collections of related tools
|
|
35
47
|
* that can be static (Toolkit) or dynamic (MCPToolkit).
|
|
@@ -65,11 +77,7 @@ export interface AgentConfig<TContext = UnknownContext, TResponse extends AgentR
|
|
|
65
77
|
* A list of checks that run in parallel to the agent's execution on the input + output for the agent,
|
|
66
78
|
* depending on the configuration.
|
|
67
79
|
*/
|
|
68
|
-
guardrails?: AgentGuardrails<
|
|
69
|
-
/**
|
|
70
|
-
* The type of the response that the agent will return. If not provided, response will be a string.
|
|
71
|
-
*/
|
|
72
|
-
responseType?: TResponse;
|
|
80
|
+
guardrails?: AgentGuardrails<TOutput>;
|
|
73
81
|
/**
|
|
74
82
|
* Whether to reset the tool choice to the default value after a tool has been called. Defaults
|
|
75
83
|
* to `true`. This ensures that the agent doesn't enter an infinite loop of tool usage.
|
|
@@ -79,7 +87,7 @@ export interface AgentConfig<TContext = UnknownContext, TResponse extends AgentR
|
|
|
79
87
|
/**
|
|
80
88
|
* Guardrails for an agent.
|
|
81
89
|
*/
|
|
82
|
-
export interface AgentGuardrails<
|
|
90
|
+
export interface AgentGuardrails<TOutput extends AgentOutputType = TextOutput> {
|
|
83
91
|
/**
|
|
84
92
|
* A list of checks that run in parallel to the agent's execution, before generating a response.
|
|
85
93
|
* Runs only if the agent is the first agent in the chain.
|
|
@@ -89,13 +97,13 @@ export interface AgentGuardrails<TResponse extends AgentResponseType = TextRespo
|
|
|
89
97
|
* A list of checks that run on the final output of the agent, after generating a response. Runs
|
|
90
98
|
* only if the agent produces a final output.
|
|
91
99
|
*/
|
|
92
|
-
output: OutputGuardrail<
|
|
100
|
+
output: OutputGuardrail<TOutput>[];
|
|
93
101
|
}
|
|
94
102
|
/**
|
|
95
|
-
* The type of the output
|
|
103
|
+
* The type of the output. If not provided, the output will be a string.
|
|
96
104
|
* 'text' is a special type that indicates the output will be a string.
|
|
97
105
|
*/
|
|
98
|
-
export type
|
|
106
|
+
export type AgentOutputType = TextOutput | ZodType;
|
|
99
107
|
/**
|
|
100
108
|
* Memory configuration for an agent.
|
|
101
109
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EACL,aAAa,EACb,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU;IAE5C,EAAE,EAAE,MAAM,CAA2C;IACrD,IAAI,EAAE,MAAM,CAA8D;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAkD;IAEtE;;;;;;;OAOG;IACH,YAAY,EACR,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IAS/D;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,4BAA4B,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAsBtC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,eAAe,GAAG,UAAU;IAC3E;;;OAGG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB"}
|
package/dist/agent.d.ts
CHANGED
|
@@ -7,9 +7,9 @@ import { BaseToolkit } from "./tool/toolkit.js";
|
|
|
7
7
|
import { InputGuardrail, OutputGuardrail, type ResolvedAgentResponse } from "./guardrail.js";
|
|
8
8
|
import { AgentHooks } from "./lifecycle.js";
|
|
9
9
|
import type { AgentMemoryCreate, AgentMemoryUpdate, MemoryListOptions, MemorySearchQuery } from "./memory/index.js";
|
|
10
|
-
import type { AgentConfig, AgentMemoryConfig,
|
|
11
|
-
import type {
|
|
12
|
-
export declare class Agent<TContext = UnknownContext,
|
|
10
|
+
import type { AgentConfig, AgentMemoryConfig, AgentOutputType } from "./agent/types.js";
|
|
11
|
+
import type { TextOutput, ThreadExecuteOptions, ThreadExecuteResult, ThreadStreamEvent } from "./thread/types.js";
|
|
12
|
+
export declare class Agent<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends AgentHooks<TContext, TOutput> implements AgentConfig<TContext, TOutput> {
|
|
13
13
|
private kernl?;
|
|
14
14
|
id: string;
|
|
15
15
|
name: string;
|
|
@@ -22,11 +22,11 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
|
|
|
22
22
|
memory: AgentMemoryConfig;
|
|
23
23
|
guardrails: {
|
|
24
24
|
input: InputGuardrail[];
|
|
25
|
-
output: OutputGuardrail<
|
|
25
|
+
output: OutputGuardrail<AgentOutputType>[];
|
|
26
26
|
};
|
|
27
|
-
|
|
27
|
+
output: TOutput;
|
|
28
28
|
resetToolChoice: boolean;
|
|
29
|
-
constructor(config: AgentConfig<TContext,
|
|
29
|
+
constructor(config: AgentConfig<TContext, TOutput>);
|
|
30
30
|
/**
|
|
31
31
|
* Bind this agent to a kernl instance. Called by kernl.register().
|
|
32
32
|
*/
|
|
@@ -37,7 +37,7 @@ export declare class Agent<TContext = UnknownContext, TResponse extends AgentRes
|
|
|
37
37
|
* @throws {RuntimeError} If the specified thread is already running (concurrent execution not allowed)
|
|
38
38
|
* @throws {MisconfiguredError} If the agent is not bound to a kernl instance
|
|
39
39
|
*/
|
|
40
|
-
run(input: string | LanguageModelItem[], options?: ThreadExecuteOptions<TContext>): Promise<ThreadExecuteResult<ResolvedAgentResponse<
|
|
40
|
+
run(input: string | LanguageModelItem[], options?: ThreadExecuteOptions<TContext>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>>;
|
|
41
41
|
/**
|
|
42
42
|
* Streaming execution - spawns or resumes thread and returns async iterator
|
|
43
43
|
*
|
package/dist/agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,IAAI,EAAU,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
|
package/dist/agent.js
CHANGED
|
@@ -17,19 +17,8 @@ export class Agent extends AgentHooks {
|
|
|
17
17
|
systools;
|
|
18
18
|
memory;
|
|
19
19
|
guardrails;
|
|
20
|
-
|
|
20
|
+
output = "text";
|
|
21
21
|
resetToolChoice;
|
|
22
|
-
// --- (TODO) ---
|
|
23
|
-
// toolUseBehavior: ToolUseBehavior;
|
|
24
|
-
// handoffs: (Agent<any, TResponse> | Handoff<any, TResponse>)[];
|
|
25
|
-
// ----------
|
|
26
|
-
// /* Process/thread-group–wide signal state shared by all threads in the group: shared pending signals, job control
|
|
27
|
-
// (stops/cont, group exit), rlimits, etc. */
|
|
28
|
-
// signal: *struct signal_struct;
|
|
29
|
-
//
|
|
30
|
-
// /* Table of signal handlers (sa_handler, sa_mask, flags) shared by threads
|
|
31
|
-
// (CLONE_SIGHAND). RCU-protected so readers can access it locklessly. */
|
|
32
|
-
// sighand: *struct sighand_struct __rcu;
|
|
33
22
|
constructor(config) {
|
|
34
23
|
super();
|
|
35
24
|
if (config.id.trim() === "") {
|
|
@@ -51,8 +40,8 @@ export class Agent extends AgentHooks {
|
|
|
51
40
|
toolkit.bind(this);
|
|
52
41
|
}
|
|
53
42
|
this.guardrails = config.guardrails ?? { input: [], output: [] };
|
|
54
|
-
if (config.
|
|
55
|
-
this.
|
|
43
|
+
if (config.output) {
|
|
44
|
+
this.output = config.output;
|
|
56
45
|
}
|
|
57
46
|
this.resetToolChoice = config.resetToolChoice ?? true;
|
|
58
47
|
// this.toolUseBehavior = config.toolUseBehavior ?? "run_llm_again";
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { Agent } from "../../../agent.js";
|
|
2
|
-
import type {
|
|
2
|
+
import type { AgentOutputType } from "../../../agent/types.js";
|
|
3
3
|
import type { UnknownContext } from "../../../context.js";
|
|
4
|
-
import type {
|
|
4
|
+
import type { TextOutput } from "../../../thread/types.js";
|
|
5
5
|
/**
|
|
6
6
|
* Agents resource.
|
|
7
7
|
*
|
|
@@ -15,10 +15,10 @@ export declare class RAgents {
|
|
|
15
15
|
/**
|
|
16
16
|
* Get a live Agent instance by id.
|
|
17
17
|
*
|
|
18
|
-
* Callers are expected to know the concrete TContext/
|
|
18
|
+
* Callers are expected to know the concrete TContext/TOutput types
|
|
19
19
|
* for their own agents and can specify them via generics.
|
|
20
20
|
*/
|
|
21
|
-
get<TContext = UnknownContext,
|
|
21
|
+
get<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput>(id: string): Agent<TContext, TOutput> | undefined;
|
|
22
22
|
/**
|
|
23
23
|
* Check if an agent with the given id is registered.
|
|
24
24
|
*/
|
|
@@ -29,7 +29,7 @@ export declare class RAgents {
|
|
|
29
29
|
* Since this is a heterogeneous collection, we expose the widest safe
|
|
30
30
|
* type parameters here.
|
|
31
31
|
*/
|
|
32
|
-
list(): Agent<UnknownContext,
|
|
32
|
+
list(): Agent<UnknownContext, AgentOutputType>[];
|
|
33
33
|
/**
|
|
34
34
|
* Unregister an agent at runtime.
|
|
35
35
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzD;;;;;OAKG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,EAC5C,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS;IAKnD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;OAKG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE;IAOhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}
|
|
@@ -13,7 +13,7 @@ export class RAgents {
|
|
|
13
13
|
/**
|
|
14
14
|
* Get a live Agent instance by id.
|
|
15
15
|
*
|
|
16
|
-
* Callers are expected to know the concrete TContext/
|
|
16
|
+
* Callers are expected to know the concrete TContext/TOutput types
|
|
17
17
|
* for their own agents and can specify them via generics.
|
|
18
18
|
*/
|
|
19
19
|
get(id) {
|
package/dist/guardrail.d.ts
CHANGED
|
@@ -2,14 +2,14 @@ import { z, type ZodType } from "zod";
|
|
|
2
2
|
import { LanguageModelResponse } from "@kernl-sdk/protocol";
|
|
3
3
|
import { Agent } from "./agent.js";
|
|
4
4
|
import { Context, UnknownContext } from "./context.js";
|
|
5
|
-
import type {
|
|
6
|
-
import type {
|
|
5
|
+
import type { AgentOutputType } from "./agent/types.js";
|
|
6
|
+
import type { TextOutput, ThreadEvent } from "./thread/types.js";
|
|
7
7
|
/**
|
|
8
8
|
* Resolves the agent output type based on the response type.
|
|
9
|
-
* - If
|
|
10
|
-
* - If
|
|
9
|
+
* - If TOutput is "text" → output is string
|
|
10
|
+
* - If TOutput is a ZodType → output is the inferred type from that schema
|
|
11
11
|
*/
|
|
12
|
-
export type ResolvedAgentResponse<
|
|
12
|
+
export type ResolvedAgentResponse<TOutput extends AgentOutputType> = TOutput extends TextOutput ? string : TOutput extends ZodType ? z.infer<TOutput> : never;
|
|
13
13
|
/**
|
|
14
14
|
* The output of a guardrail function.
|
|
15
15
|
*/
|
|
@@ -100,9 +100,9 @@ export declare function defineInputGuardrail({ name, execute, }: DefineInputGuar
|
|
|
100
100
|
/**
|
|
101
101
|
* Arguments for an output guardrail function.
|
|
102
102
|
*/
|
|
103
|
-
export interface OutputGuardrailFunctionArgs<TContext = UnknownContext,
|
|
103
|
+
export interface OutputGuardrailFunctionArgs<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> {
|
|
104
104
|
agent: Agent<any, any>;
|
|
105
|
-
agentOutput: ResolvedAgentResponse<
|
|
105
|
+
agentOutput: ResolvedAgentResponse<TOutput>;
|
|
106
106
|
context: Context<TContext>;
|
|
107
107
|
/**
|
|
108
108
|
* Additional details about the agent output.
|
|
@@ -115,11 +115,11 @@ export interface OutputGuardrailFunctionArgs<TContext = UnknownContext, TRespons
|
|
|
115
115
|
/**
|
|
116
116
|
* A function that takes an output guardrail function arguments and returns a `GuardrailFunctionOutput`.
|
|
117
117
|
*/
|
|
118
|
-
export type OutputGuardrailFunction<
|
|
118
|
+
export type OutputGuardrailFunction<TOutput extends AgentOutputType = TextOutput> = (args: OutputGuardrailFunctionArgs<UnknownContext, TOutput>) => Promise<GuardrailFunctionOutput>;
|
|
119
119
|
/**
|
|
120
120
|
* A guardrail that checks the output of the agent.
|
|
121
121
|
*/
|
|
122
|
-
export interface OutputGuardrail<
|
|
122
|
+
export interface OutputGuardrail<TOutput extends AgentOutputType = TextOutput> {
|
|
123
123
|
/**
|
|
124
124
|
* The name of the guardrail.
|
|
125
125
|
*/
|
|
@@ -127,7 +127,7 @@ export interface OutputGuardrail<TResponse extends AgentResponseType = TextRespo
|
|
|
127
127
|
/**
|
|
128
128
|
* The function that performs the guardrail check.
|
|
129
129
|
*/
|
|
130
|
-
execute: OutputGuardrailFunction<
|
|
130
|
+
execute: OutputGuardrailFunction<TOutput>;
|
|
131
131
|
}
|
|
132
132
|
/**
|
|
133
133
|
* Metadata for an output guardrail.
|
|
@@ -139,7 +139,7 @@ export interface OutputGuardrailMetadata {
|
|
|
139
139
|
/**
|
|
140
140
|
* The result of an output guardrail execution.
|
|
141
141
|
*/
|
|
142
|
-
export interface OutputGuardrailResult<TMeta = OutputGuardrailMetadata,
|
|
142
|
+
export interface OutputGuardrailResult<TMeta = OutputGuardrailMetadata, TOutput extends AgentOutputType = TextOutput> {
|
|
143
143
|
/**
|
|
144
144
|
* The metadata of the guardrail.
|
|
145
145
|
*/
|
|
@@ -147,11 +147,11 @@ export interface OutputGuardrailResult<TMeta = OutputGuardrailMetadata, TRespons
|
|
|
147
147
|
/**
|
|
148
148
|
* The output of the agent that ran.
|
|
149
149
|
*/
|
|
150
|
-
agentOutput: ResolvedAgentResponse<
|
|
150
|
+
agentOutput: ResolvedAgentResponse<TOutput>;
|
|
151
151
|
/**
|
|
152
152
|
* The agent that ran.
|
|
153
153
|
*/
|
|
154
|
-
agent: Agent<UnknownContext,
|
|
154
|
+
agent: Agent<UnknownContext, TOutput>;
|
|
155
155
|
/**
|
|
156
156
|
* The output of the guardrail.
|
|
157
157
|
*/
|
|
@@ -160,19 +160,19 @@ export interface OutputGuardrailResult<TMeta = OutputGuardrailMetadata, TRespons
|
|
|
160
160
|
/**
|
|
161
161
|
* Definition of an output guardrail.
|
|
162
162
|
*/
|
|
163
|
-
export interface OutputGuardrailDefinition<TMeta = OutputGuardrailMetadata,
|
|
164
|
-
guardrailFunction: OutputGuardrailFunction<
|
|
165
|
-
run(args: OutputGuardrailFunctionArgs<UnknownContext,
|
|
163
|
+
export interface OutputGuardrailDefinition<TMeta = OutputGuardrailMetadata, TOutput extends AgentOutputType = TextOutput> extends OutputGuardrailMetadata {
|
|
164
|
+
guardrailFunction: OutputGuardrailFunction<TOutput>;
|
|
165
|
+
run(args: OutputGuardrailFunctionArgs<UnknownContext, TOutput>): Promise<OutputGuardrailResult<TMeta, TOutput>>;
|
|
166
166
|
}
|
|
167
167
|
/**
|
|
168
168
|
* Arguments for defining an output guardrail definition.
|
|
169
169
|
*/
|
|
170
|
-
export interface DefineOutputGuardrailArgs<
|
|
170
|
+
export interface DefineOutputGuardrailArgs<TOutput extends AgentOutputType = TextOutput> {
|
|
171
171
|
name: string;
|
|
172
|
-
execute: OutputGuardrailFunction<
|
|
172
|
+
execute: OutputGuardrailFunction<TOutput>;
|
|
173
173
|
}
|
|
174
174
|
/**
|
|
175
175
|
* Creates an output guardrail definition.
|
|
176
176
|
*/
|
|
177
|
-
export declare function defineOutputGuardrail<
|
|
177
|
+
export declare function defineOutputGuardrail<TOutput extends AgentOutputType = TextOutput>({ name, execute, }: DefineOutputGuardrailArgs<TOutput>): OutputGuardrailDefinition<OutputGuardrailMetadata, TOutput>;
|
|
178
178
|
//# sourceMappingURL=guardrail.d.ts.map
|
package/dist/guardrail.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guardrail.d.ts","sourceRoot":"","sources":["../src/guardrail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"guardrail.d.ts","sourceRoot":"","sources":["../src/guardrail.ts"],"names":[],"mappings":"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"}
|
package/dist/kernl/kernl.d.ts
CHANGED
|
@@ -8,7 +8,7 @@ import { RThreads } from "../api/resources/threads/index.js";
|
|
|
8
8
|
import { RAgents } from "../api/resources/agents/index.js";
|
|
9
9
|
import { Memory } from "../memory/index.js";
|
|
10
10
|
import type { ThreadExecuteResult, ThreadStreamEvent } from "../thread/types.js";
|
|
11
|
-
import type {
|
|
11
|
+
import type { AgentOutputType } from "../agent/types.js";
|
|
12
12
|
import type { KernlOptions } from "./types.js";
|
|
13
13
|
/**
|
|
14
14
|
* The kernl - manages agent processes, scheduling, and task lifecycle.
|
|
@@ -16,7 +16,7 @@ import type { KernlOptions } from "./types.js";
|
|
|
16
16
|
* Orchestrates agent execution, including guardrails, tool calls, session persistence, and
|
|
17
17
|
* tracing.
|
|
18
18
|
*/
|
|
19
|
-
export declare class Kernl extends KernlHooks<UnknownContext,
|
|
19
|
+
export declare class Kernl extends KernlHooks<UnknownContext, AgentOutputType> {
|
|
20
20
|
private readonly _agents;
|
|
21
21
|
private readonly _models;
|
|
22
22
|
readonly storage: KernlStorage;
|
|
@@ -32,24 +32,24 @@ export declare class Kernl extends KernlHooks<UnknownContext, AgentResponseType>
|
|
|
32
32
|
/**
|
|
33
33
|
* Spawn a new thread - blocking execution
|
|
34
34
|
*/
|
|
35
|
-
spawn<TContext,
|
|
35
|
+
spawn<TContext, TOutput extends AgentOutputType>(thread: Thread<TContext, TOutput>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>>;
|
|
36
36
|
/**
|
|
37
37
|
* Schedule an existing thread - blocking execution
|
|
38
38
|
*
|
|
39
39
|
* NOTE: just blocks for now
|
|
40
40
|
*/
|
|
41
|
-
schedule<TContext,
|
|
41
|
+
schedule<TContext, TOutput extends AgentOutputType>(thread: Thread<TContext, TOutput>): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>>;
|
|
42
42
|
/**
|
|
43
43
|
* (TMP) - won't make sense in async scheduling contexts
|
|
44
44
|
*
|
|
45
45
|
* Spawn a new thread - streaming execution
|
|
46
46
|
*/
|
|
47
|
-
spawnStream<TContext,
|
|
47
|
+
spawnStream<TContext, TOutput extends AgentOutputType>(thread: Thread<TContext, TOutput>): AsyncIterable<ThreadStreamEvent>;
|
|
48
48
|
/**
|
|
49
49
|
* (TMP) - won't make sense with async scheduling contexts
|
|
50
50
|
*
|
|
51
51
|
* Schedule an existing thread - streaming execution
|
|
52
52
|
*/
|
|
53
|
-
scheduleStream<TContext,
|
|
53
|
+
scheduleStream<TContext, TOutput extends AgentOutputType>(thread: Thread<TContext, TOutput>): AsyncIterable<ThreadStreamEvent>;
|
|
54
54
|
}
|
|
55
55
|
//# sourceMappingURL=kernl.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,eAAe,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAGpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAoCtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAa5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;CAQpC"}
|
package/dist/lib/error.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { InputGuardrailResult, OutputGuardrailMetadata, OutputGuardrailResult } from "../guardrail.js";
|
|
2
2
|
type SerializedThread = any;
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
3
|
+
import { AgentOutputType } from "../agent/types.js";
|
|
4
|
+
import { TextOutput } from "../thread/types.js";
|
|
5
5
|
/**
|
|
6
6
|
* Abstract base class for all `kernl` errors
|
|
7
7
|
* Requires subclasses to implement JSON serialization
|
|
@@ -80,7 +80,7 @@ export declare class InputGuardrailTripwireTriggered extends AgentError {
|
|
|
80
80
|
/**
|
|
81
81
|
* Error thrown when an output guardrail tripwire is triggered.
|
|
82
82
|
*/
|
|
83
|
-
export declare class OutputGuardrailTripwireTriggered<TMeta extends OutputGuardrailMetadata, TOutputType extends
|
|
83
|
+
export declare class OutputGuardrailTripwireTriggered<TMeta extends OutputGuardrailMetadata, TOutputType extends AgentOutputType = TextOutput> extends AgentError {
|
|
84
84
|
result: OutputGuardrailResult<TMeta, TOutputType>;
|
|
85
85
|
constructor(message: string, result: OutputGuardrailResult<TMeta, TOutputType>, thread?: SerializedThread);
|
|
86
86
|
}
|
package/dist/lib/error.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/lib/error.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,KAAK,gBAAgB,GAAG,GAAG,CAAC;AAE5B,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/lib/error.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,KAAK,gBAAgB,GAAG,GAAG,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,8BAAsB,SAAU,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;IAK3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK7C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAQ9B;AAED;;GAEG;AACH,8BAAsB,UAAW,SAAQ,YAAY;IACnD,MAAM,CAAC,EAAE,gBAAgB,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM;IAK9D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMvC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;CAAG;AAEhD;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO9B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;CAAG;AAExD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;CAAG;AAErD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,KAAK,EAAE,KAAK,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,gBAAgB;CAIrE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,KAAK,EAAE,KAAK,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,gBAAgB;CAIrE;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,UAAU;IAC7D,MAAM,EAAE,oBAAoB,CAAC;gBAE3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,gBAAgB;CAK5B;AAED;;GAEG;AACH,qBAAa,gCAAgC,CAC3C,KAAK,SAAS,uBAAuB,EACrC,WAAW,SAAS,eAAe,GAAG,UAAU,CAChD,SAAQ,UAAU;IAClB,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAEhD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,EACjD,MAAM,CAAC,EAAE,gBAAgB;CAK5B"}
|
package/dist/lifecycle.d.ts
CHANGED
|
@@ -3,8 +3,8 @@ import { Agent } from "./agent.js";
|
|
|
3
3
|
import { Context, UnknownContext } from "./context.js";
|
|
4
4
|
import { Tool } from "./tool/index.js";
|
|
5
5
|
import type { ToolCall } from "@kernl-sdk/protocol";
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
6
|
+
import { AgentOutputType } from "./agent/types.js";
|
|
7
|
+
import { TextOutput } from "./thread/types.js";
|
|
8
8
|
export type EventEmitterEvents = Record<string, any[]>;
|
|
9
9
|
/**
|
|
10
10
|
* Generic typed event emitter that wraps Node's EventEmitter with type safety
|
|
@@ -19,7 +19,7 @@ declare class TypedEventEmitter<EventTypes extends EventEmitterEvents = Record<s
|
|
|
19
19
|
once<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
|
|
20
20
|
once(event: string | symbol, listener: (...args: any[]) => void): this;
|
|
21
21
|
}
|
|
22
|
-
export type AgentHookEvents<TContext = UnknownContext, TOutput extends
|
|
22
|
+
export type AgentHookEvents<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = {
|
|
23
23
|
/**
|
|
24
24
|
* @param context - The context of the run
|
|
25
25
|
*/
|
|
@@ -60,7 +60,7 @@ export type AgentHookEvents<TContext = UnknownContext, TOutput extends AgentResp
|
|
|
60
60
|
* Event emitter that every Agent instance inherits from and that emits events for the lifecycle
|
|
61
61
|
* of the agent.
|
|
62
62
|
*/
|
|
63
|
-
export declare class AgentHooks<TContext = UnknownContext, TOutput extends
|
|
63
|
+
export declare class AgentHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends TypedEventEmitter<AgentHookEvents<TContext, TOutput>> {
|
|
64
64
|
}
|
|
65
65
|
/**
|
|
66
66
|
* Events emitted by the kernl during execution.
|
|
@@ -69,7 +69,7 @@ export declare class AgentHooks<TContext = UnknownContext, TOutput extends Agent
|
|
|
69
69
|
* KernlHookEvents explicitly include the agent reference in all events since it needs to
|
|
70
70
|
* coordinate multiple agents and listeners need to know which agent triggered each event.
|
|
71
71
|
*/
|
|
72
|
-
export type KernlHookEvents<TContext = UnknownContext, TOutput extends
|
|
72
|
+
export type KernlHookEvents<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = {
|
|
73
73
|
/**
|
|
74
74
|
* @param context - The context of the run
|
|
75
75
|
* @param agent - The agent that is starting
|
|
@@ -127,7 +127,7 @@ export type KernlHookEvents<TContext = UnknownContext, TOutput extends AgentResp
|
|
|
127
127
|
/**
|
|
128
128
|
* Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
|
|
129
129
|
*/
|
|
130
|
-
export declare class KernlHooks<TContext = UnknownContext, TOutput extends
|
|
130
|
+
export declare class KernlHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends TypedEventEmitter<KernlHookEvents<TContext, TOutput>> {
|
|
131
131
|
}
|
|
132
132
|
export {};
|
|
133
133
|
//# sourceMappingURL=lifecycle.d.ts.map
|
package/dist/lifecycle.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"encoder.test.d.ts","sourceRoot":"","sources":["../../../src/memory/__tests__/encoder.test.ts"],"names":[],"mappings":""}
|