@ap3x/agent-core 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/dist/agent-loop.d.ts +2 -6
- package/dist/agent-loop.d.ts.map +1 -1
- package/dist/agent.d.ts +5 -1
- package/dist/agent.d.ts.map +1 -1
- package/dist/backend.d.ts +22 -2
- package/dist/backend.d.ts.map +1 -1
- package/dist/execution-controller.d.ts +83 -0
- package/dist/execution-controller.d.ts.map +1 -0
- package/dist/harness.d.ts +5 -0
- package/dist/harness.d.ts.map +1 -1
- package/dist/index.d.ts +6 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1306 -568
- package/dist/policy.d.ts +60 -0
- package/dist/policy.d.ts.map +1 -0
- package/dist/run-context.d.ts +26 -0
- package/dist/run-context.d.ts.map +1 -0
- package/dist/run-result.d.ts +35 -0
- package/dist/run-result.d.ts.map +1 -0
- package/dist/session-attempt.d.ts +25 -0
- package/dist/session-attempt.d.ts.map +1 -0
- package/dist/session-repo.d.ts.map +1 -1
- package/dist/session.d.ts +2 -0
- package/dist/session.d.ts.map +1 -1
- package/dist/tools.d.ts +2 -6
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +16 -3
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
package/dist/agent-loop.d.ts
CHANGED
|
@@ -6,12 +6,7 @@ import type { AgentContext, AgentEvent, AgentEventSink, AgentLoopConfig, AgentMe
|
|
|
6
6
|
* explicitly, or `Infinity` to disable the guard entirely.
|
|
7
7
|
*/
|
|
8
8
|
export declare const DEFAULT_MAX_LOOPS = 1000;
|
|
9
|
-
/**
|
|
10
|
-
* Run the turn cycle starting from a set of new prompt messages. Emits the full
|
|
11
|
-
* lifecycle and returns every NEW message produced (prompts + assistant turns +
|
|
12
|
-
* tool results). The loop stops when an assistant turn requests no tools, when
|
|
13
|
-
* a tool batch terminates, on an error/aborted stop reason, or at `maxLoops`.
|
|
14
|
-
*/
|
|
9
|
+
/** Scope every native provider and tool call under the host-owned root authority. */
|
|
15
10
|
export declare function runAgentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, emit: AgentEventSink, signal?: AbortSignal): Promise<AgentMessage[]>;
|
|
16
11
|
/**
|
|
17
12
|
* Continue the loop from an existing context without injecting a new prompt.
|
|
@@ -23,6 +18,7 @@ export declare function runAgentLoopContinue(context: AgentContext, config: Agen
|
|
|
23
18
|
export interface AgentEventStream extends AsyncIterable<AgentEvent> {
|
|
24
19
|
result(): Promise<AgentMessage[]>;
|
|
25
20
|
}
|
|
21
|
+
export declare function makeEventStream(run: (emit: AgentEventSink) => Promise<AgentMessage[]>): AgentEventStream;
|
|
26
22
|
/** Streaming wrapper over {@link runAgentLoop}. */
|
|
27
23
|
export declare function agentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal): AgentEventStream;
|
|
28
24
|
/** Streaming wrapper over {@link runAgentLoopContinue}, validated eagerly. */
|
package/dist/agent-loop.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AA+gBtC,qFAAqF;AACrF,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBzB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAOzB;AAED,oFAAoF;AACpF,MAAM,WAAW,gBAAiB,SAAQ,aAAa,CAAC,UAAU,CAAC;IACjE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACnC;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,GACrD,gBAAgB,CAwClB;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,gBAAgB,CAElB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,gBAAgB,CAOlB"}
|
package/dist/agent.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { AssistantMessage, Model, SimpleStreamOptions, Usage } from "@ap3x/ai";
|
|
2
|
-
import type {
|
|
2
|
+
import type { RunContext } from "./run-context";
|
|
3
|
+
import type { AgentEvent, AgentHooks, AgentLoopConfig, AgentMessage, AnyAgentTool, StreamFn, ThinkingLevel } from "./types";
|
|
3
4
|
/** A live subscriber to {@link Agent} events; receives the run's abort signal. */
|
|
4
5
|
export type AgentListener = (event: AgentEvent, signal: AbortSignal) => void | Promise<void>;
|
|
5
6
|
/** Construction options for a stateful {@link Agent}. */
|
|
@@ -33,6 +34,7 @@ export interface AgentOptions {
|
|
|
33
34
|
* of summarizing blind. Kept current across runs from `compaction` events.
|
|
34
35
|
*/
|
|
35
36
|
previousSummary?: string;
|
|
37
|
+
compactionComplete?: AgentLoopConfig["compactionComplete"];
|
|
36
38
|
}
|
|
37
39
|
/** Public, read-only snapshot of an agent's current state. */
|
|
38
40
|
export interface AgentState {
|
|
@@ -66,6 +68,8 @@ export declare class Agent {
|
|
|
66
68
|
sessionId?: string;
|
|
67
69
|
autoCompact?: boolean;
|
|
68
70
|
previousSummary?: string;
|
|
71
|
+
runContext?: RunContext;
|
|
72
|
+
private readonly compactionComplete?;
|
|
69
73
|
private toolList;
|
|
70
74
|
private transcript;
|
|
71
75
|
private running;
|
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,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIpF,OAAO,KAAK,EAEV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AAQjB,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7F,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAC1C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
|
package/dist/backend.d.ts
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
import type { Model } from "@ap3x/ai";
|
|
2
2
|
import { type AgentOptions } from "./agent";
|
|
3
3
|
import { type AgentEventStream } from "./agent-loop";
|
|
4
|
+
import type { RunContext } from "./run-context";
|
|
5
|
+
import { type RunOutcome, type RunReasonCode } from "./run-result";
|
|
4
6
|
import type { AgentEvent, AgentMessage, StopReason, Usage } from "./types";
|
|
5
7
|
/** Per-run options accepted by an {@link AgentBackend}. */
|
|
6
8
|
export interface AgentRunOptions {
|
|
7
9
|
signal?: AbortSignal;
|
|
10
|
+
context?: RunContext;
|
|
8
11
|
}
|
|
9
12
|
/** The uniform result every backend returns from a `run()`. */
|
|
10
13
|
export interface AgentRunResult {
|
|
@@ -18,9 +21,21 @@ export interface AgentRunResult {
|
|
|
18
21
|
stopReason: StopReason;
|
|
19
22
|
/** Present when the run failed. */
|
|
20
23
|
errorMessage?: string;
|
|
24
|
+
/** Additive normalized status; optional for existing backend implementations. */
|
|
25
|
+
outcome?: RunOutcome;
|
|
26
|
+
reasonCode?: RunReasonCode;
|
|
27
|
+
/** All provider calls in this run, including compaction. Legacy usage remains final-turn usage. */
|
|
28
|
+
aggregateUsage?: Usage;
|
|
29
|
+
runId?: string;
|
|
30
|
+
parentRunId?: string;
|
|
31
|
+
execution?: import("./execution-controller").ExecutionSnapshot;
|
|
32
|
+
/** Optional backend-native metadata, retained without inventing a lossy mapping. */
|
|
33
|
+
backendData?: unknown;
|
|
34
|
+
/** Usage was not reported for one or more opaque provider calls. */
|
|
35
|
+
usageIncomplete?: boolean;
|
|
21
36
|
}
|
|
22
37
|
/** Optional capabilities a backend can advertise via {@link AgentBackend.supports}. */
|
|
23
|
-
export type BackendCapability = "stream" | "subscribe" | "abort" | "clone" | "tools";
|
|
38
|
+
export type BackendCapability = "stream" | "subscribe" | "abort" | "clone" | "tools" | "execution-controls";
|
|
24
39
|
/**
|
|
25
40
|
* The load-bearing seam between AP3X orchestration and any agent runtime. The
|
|
26
41
|
* only required method is `run`; the rest are optional so simple backends can
|
|
@@ -34,6 +49,8 @@ export interface AgentBackend {
|
|
|
34
49
|
clone?(): AgentBackend;
|
|
35
50
|
supports?(capability: BackendCapability): boolean;
|
|
36
51
|
getCurrentModel?(): Model<string>;
|
|
52
|
+
/** In-memory semantic configuration for safe checkpoint fingerprinting. */
|
|
53
|
+
checkpointIdentity?(): unknown;
|
|
37
54
|
}
|
|
38
55
|
/**
|
|
39
56
|
* The AP3X-native default backend. By default each `run()` is *ephemeral*: it
|
|
@@ -45,7 +62,7 @@ export declare class Ap3xRuntimeBackend implements AgentBackend {
|
|
|
45
62
|
private readonly options;
|
|
46
63
|
private readonly ephemeral;
|
|
47
64
|
private stateful?;
|
|
48
|
-
private active
|
|
65
|
+
private readonly active;
|
|
49
66
|
private readonly listeners;
|
|
50
67
|
constructor(options: AgentOptions & {
|
|
51
68
|
ephemeral?: boolean;
|
|
@@ -54,10 +71,13 @@ export declare class Ap3xRuntimeBackend implements AgentBackend {
|
|
|
54
71
|
private agentFor;
|
|
55
72
|
run(task: string | AgentMessage[], opts?: AgentRunOptions): Promise<AgentRunResult>;
|
|
56
73
|
runStream(task: string | AgentMessage[], opts?: AgentRunOptions): AgentEventStream;
|
|
74
|
+
/** Both entry points drive the same Agent lifecycle, including state, hooks and subscribers. */
|
|
75
|
+
private execute;
|
|
57
76
|
subscribe(listener: (event: AgentEvent) => void | Promise<void>): () => void;
|
|
58
77
|
abort(): void;
|
|
59
78
|
clone(): AgentBackend;
|
|
60
79
|
supports(capability: BackendCapability): boolean;
|
|
80
|
+
checkpointIdentity(): unknown;
|
|
61
81
|
getCurrentModel(): Model<string>;
|
|
62
82
|
}
|
|
63
83
|
/** Convenience factory mirroring the {@link Ap3xRuntimeBackend} constructor. */
|
package/dist/backend.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAS,KAAK,YAAY,
|
|
1
|
+
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { type Context, type Model, type SimpleStreamOptions, type Usage } from "@ap3x/ai";
|
|
2
|
+
import type { AgentBackend, AgentRunOptions, AgentRunResult } from "./backend";
|
|
3
|
+
import { type RunContext } from "./run-context";
|
|
4
|
+
export interface ExecutionLimits {
|
|
5
|
+
maxTurns?: number;
|
|
6
|
+
maxToolCalls?: number;
|
|
7
|
+
maxChildAgents?: number;
|
|
8
|
+
maxActiveChildren?: number;
|
|
9
|
+
maxDepth?: number;
|
|
10
|
+
maxElapsedMs?: number;
|
|
11
|
+
maxTokens?: number;
|
|
12
|
+
maxEstimatedUsd?: number;
|
|
13
|
+
/** Reservation required for backends that cannot expose individual provider calls. */
|
|
14
|
+
opaqueChildTokens?: number;
|
|
15
|
+
opaqueChildEstimatedUsd?: number;
|
|
16
|
+
}
|
|
17
|
+
export type ExecutionLimit = keyof ExecutionLimits | "cancelled" | "unknown_pricing";
|
|
18
|
+
export interface ExecutionSnapshot {
|
|
19
|
+
turns: number;
|
|
20
|
+
toolCalls: number;
|
|
21
|
+
childAgents: number;
|
|
22
|
+
activeChildren: number;
|
|
23
|
+
tokens: number;
|
|
24
|
+
estimatedUsd: number;
|
|
25
|
+
reservedTokens: number;
|
|
26
|
+
reservedEstimatedUsd: number;
|
|
27
|
+
unknownPricing: boolean;
|
|
28
|
+
usageIncomplete: boolean;
|
|
29
|
+
elapsedMs: number;
|
|
30
|
+
limit?: ExecutionLimit;
|
|
31
|
+
}
|
|
32
|
+
export declare class ExecutionLimitError extends Error {
|
|
33
|
+
readonly limit: ExecutionLimit;
|
|
34
|
+
readonly resources: ExecutionSnapshot;
|
|
35
|
+
readonly reasonCode = "execution_limit";
|
|
36
|
+
constructor(limit: ExecutionLimit, resources: ExecutionSnapshot);
|
|
37
|
+
}
|
|
38
|
+
export interface ExecutionReservation {
|
|
39
|
+
/** Idempotent settlement. Unknown charges remain explicitly unknown. */
|
|
40
|
+
settle(usage?: Usage): void;
|
|
41
|
+
}
|
|
42
|
+
/** One host-owned controller per root. Admission and reservation mutate synchronously. */
|
|
43
|
+
export declare class ExecutionController {
|
|
44
|
+
readonly limits: Readonly<ExecutionLimits>;
|
|
45
|
+
readonly signal: AbortSignal;
|
|
46
|
+
private readonly abortController;
|
|
47
|
+
private readonly startedAt;
|
|
48
|
+
private readonly values;
|
|
49
|
+
private terminalLimit?;
|
|
50
|
+
private readonly waiters;
|
|
51
|
+
private timer?;
|
|
52
|
+
private detach?;
|
|
53
|
+
constructor(limits?: ExecutionLimits, signal?: AbortSignal);
|
|
54
|
+
snapshot(): ExecutionSnapshot;
|
|
55
|
+
cancel(): void;
|
|
56
|
+
dispose(): void;
|
|
57
|
+
private stop;
|
|
58
|
+
private refuse;
|
|
59
|
+
assertActive(signal?: AbortSignal): void;
|
|
60
|
+
private consume;
|
|
61
|
+
turn(): void;
|
|
62
|
+
tool(): void;
|
|
63
|
+
assertDepth(depth: number): void;
|
|
64
|
+
child(depth: number, signal?: AbortSignal): Promise<() => void>;
|
|
65
|
+
reserve(tokens: number, estimatedUsd: number | undefined): ExecutionReservation;
|
|
66
|
+
}
|
|
67
|
+
export declare function currentRunContext(): RunContext | undefined;
|
|
68
|
+
/** Explicit host boundary for orchestrators whose legacy API has no run-options argument. */
|
|
69
|
+
export declare function withRunContext<T>(context: RunContext, fn: () => T): T;
|
|
70
|
+
export declare function resolveRunContext(context?: RunContext, signal?: AbortSignal): RunContext;
|
|
71
|
+
/** One scope per workflow entry, including legacy orchestrators with no options parameter. */
|
|
72
|
+
export declare function withWorkflowContext<T>(fn: () => Promise<T>): Promise<T>;
|
|
73
|
+
/** True only while the shared member boundary owns the opaque reservation. */
|
|
74
|
+
export declare function hasOpaqueReservation(context: RunContext): boolean;
|
|
75
|
+
export declare function executeMember(agent: AgentBackend, task: string, options?: AgentRunOptions): Promise<AgentRunResult>;
|
|
76
|
+
/** Estimate a conservative text reservation plus the configured output ceiling. Pricing is explicit. */
|
|
77
|
+
export declare function reserveProviderCall(model: Model<string>, context: Context, options?: SimpleStreamOptions): ExecutionReservation | undefined;
|
|
78
|
+
/** An injected call owns its first reservation; facade retries acquire additional tickets. */
|
|
79
|
+
export declare function withProviderReservation<T>(reservation: ExecutionReservation | undefined, call: () => T): T;
|
|
80
|
+
export declare function controlledProviderCall<T extends {
|
|
81
|
+
usage: Usage;
|
|
82
|
+
}>(model: Model<string>, context: Context, options: SimpleStreamOptions | undefined, call: () => Promise<T>): Promise<T>;
|
|
83
|
+
//# sourceMappingURL=execution-controller.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"execution-controller.d.ts","sourceRoot":"","sources":["../src/execution-controller.ts"],"names":[],"mappings":"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"}
|
package/dist/harness.d.ts
CHANGED
|
@@ -8,6 +8,8 @@ import type { AgentEvent, AgentMessage } from "./types";
|
|
|
8
8
|
*/
|
|
9
9
|
export interface AgentHarnessOptions extends AgentOptions {
|
|
10
10
|
session: Session;
|
|
11
|
+
/** Persist each completed message boundary and mark interrupted attempts. Default: false. */
|
|
12
|
+
incrementalPersistence?: boolean;
|
|
11
13
|
}
|
|
12
14
|
/** A harness event subscriber. Mirrors the untyped {@link AgentEvent} stream. */
|
|
13
15
|
type HarnessListener = (event: AgentEvent) => void | Promise<void>;
|
|
@@ -45,6 +47,9 @@ export declare class AgentHarness {
|
|
|
45
47
|
*/
|
|
46
48
|
private unpersistedSummary?;
|
|
47
49
|
private busy;
|
|
50
|
+
private readonly incrementalPersistence;
|
|
51
|
+
private recorder?;
|
|
52
|
+
private terminal?;
|
|
48
53
|
constructor(options: AgentHarnessOptions);
|
|
49
54
|
/**
|
|
50
55
|
* Run a single turn and persist all new messages to the session. Only
|
package/dist/harness.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EACL,KAAK,gBAAgB,EAErB,OAAO,EAER,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EACL,KAAK,gBAAgB,EAErB,OAAO,EAER,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,KAAK,OAAO,EAA0B,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,iFAAiF;AACjF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE,6FAA6F;AAC7F,KAAK,YAAY,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEnF;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,+EAA+E;IAC/E,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,0FAA0F;IAC1F,OAAO,CAAC,eAAe,CAAsB;IAC7C;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAA6C;gBAElD,OAAO,EAAE,mBAAmB;IAUxC;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0BrD;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI3C,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI9C;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyEjF;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASnC,4DAA4D;IAC5D,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAOhD;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxD,MAAM,IAAI;IAMb,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAWlB,kEAAkE;IAClE,OAAO,CAAC,iBAAiB;IAMzB,kEAAkE;IAClE,OAAO,CAAC,SAAS;CAKlB"}
|
package/dist/index.d.ts
CHANGED
|
@@ -6,7 +6,7 @@ export { uuidv7, shortId } from "./uuid";
|
|
|
6
6
|
export { createLimiter, mapLimit, availableParallelism } from "./concurrency";
|
|
7
7
|
export type { AgentMessage, CustomAgentMessages, AgentContext, AgentTool, AnyAgentTool, AgentToolResult, AgentToolUpdate, AgentEvent, AgentEventSink, AgentHooks, AgentLoopConfig, QueueMode, BeforeToolCallContext, AfterToolCallContext, ToolCallGate, ThinkingLevel, StreamFn, } from "./types";
|
|
8
8
|
export { defineTool, executeToolCalls, type ToolBatchResult, type ExecuteToolCallsOptions, type ToolExecutionEvent, } from "./tools";
|
|
9
|
-
export { runAgentLoop, runAgentLoopContinue, agentLoop, agentLoopContinue, DEFAULT_MAX_LOOPS, type AgentEventStream, } from "./agent-loop";
|
|
9
|
+
export { runAgentLoop, runAgentLoopContinue, agentLoop, agentLoopContinue, makeEventStream, DEFAULT_MAX_LOOPS, type AgentEventStream, } from "./agent-loop";
|
|
10
10
|
export { Agent, type AgentOptions, type AgentState, type AgentListener, finalTextOf, lastAssistant, } from "./agent";
|
|
11
11
|
export { type AgentBackend, type AgentRunResult, type AgentRunOptions, type BackendCapability, Ap3xRuntimeBackend, createRuntimeBackend, } from "./backend";
|
|
12
12
|
export { AgentHarness, type AgentHarnessOptions } from "./harness";
|
|
@@ -25,4 +25,9 @@ export { estimateTokens, type TokenCounter } from "./conversation";
|
|
|
25
25
|
export { AgentLoader, AgentRegistry, AgentConfigSchema, AgentRegistrySchema, AgentSpecSchema, parseYamlFrontmatter, type AgentConfig, type AgentRegistrySnapshot, type AgentSpec, type RegistrableAgent, } from "./loader";
|
|
26
26
|
export { SafeStateManager, SerializableMixin, createStateDict, isClassInstance, isSafeType, preserveInstances, serializeAttr, serializeState, type CallableDescriptor, type HasToDict, } from "./serialization";
|
|
27
27
|
export { AgentError, AgentInitializationError, AgentRunError, AgentLLMError, AgentToolError, AgentMemoryError, AgentMCPConnectionError, AgentMCPToolError, type AgentErrorCode, } from "./agent-errors";
|
|
28
|
+
export { createRunContext, type RunContext } from "./run-context";
|
|
29
|
+
export { toRunResult, runCompletion, assertRunSucceeded, AgentRunFailure, emptyUsage, addUsage, type RunOutcome, type RunReasonCode, type RunCompletion, } from "./run-result";
|
|
30
|
+
export { SessionAttemptRecorder, inspectSessionAttempts, type SessionAttempt, } from "./session-attempt";
|
|
31
|
+
export { ExecutionController, ExecutionLimitError, currentRunContext, resolveRunContext, withRunContext, withWorkflowContext, executeMember, hasOpaqueReservation, reserveProviderCall, controlledProviderCall, type ExecutionLimits, type ExecutionSnapshot, type ExecutionReservation, type ExecutionLimit, } from "./execution-controller";
|
|
32
|
+
export { authorizeTool, argumentsHash, immutableArguments, PolicyDeniedError, developmentPolicy, readOnlyPolicy, productionPolicy, type ExecutionPolicy, type PolicyDecision, type PolicyRequest, type ApprovalRequest, type ApprovalResolution, } from "./policy";
|
|
28
33
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|