general-agent-runtime 0.0.1

package/dist/hooks/index.js

@@ -0,0 +1,5 @@
+export { DefaultHookRegistry, } from "./registry.js";
+export { DefaultHookBus, } from "./bus.js";
+export { runHookWithTimeout } from "./timeout.js";
+export { assertHookActionAllowed, } from "./policy.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,GAGf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,uBAAuB,GAExB,MAAM,aAAa,CAAC"}

package/dist/hooks/policy.d.ts

@@ -0,0 +1,3 @@
+import type { HookAction, HookName } from "./types.js";
+export type HookActionType = HookAction["type"];
+export declare function assertHookActionAllowed(event: HookName, action: HookAction): void;

package/dist/hooks/policy.js

@@ -0,0 +1,33 @@
+import { RuntimeError } from "../errors/runtime-error.js";
+const ALLOWED_ACTIONS = {
+    session_start: ["continue", "block", "stop"],
+    session_end: ["continue"],
+    run_start: ["continue", "block", "stop"],
+    run_end: ["continue"],
+    turn_start: ["continue", "block", "stop"],
+    turn_end: ["continue", "stop"],
+    before_context: ["continue", "modify", "block", "stop"],
+    after_context: ["continue", "modify", "block", "stop"],
+    before_model: ["continue", "modify", "block", "stop"],
+    after_model: ["continue", "block", "stop"],
+    before_tool: ["continue", "modify", "block", "retry"],
+    after_tool: ["continue", "modify", "block", "retry"],
+    before_compact: ["continue", "modify", "block", "stop"],
+    after_compact: ["continue", "block", "stop"],
+    error: ["continue"],
+    stop: ["continue", "modify"],
+};
+export function assertHookActionAllowed(event, action) {
+    if (!ALLOWED_ACTIONS[event].includes(action.type)) {
+        throw new RuntimeError({
+            code: "HOOK_FAILED",
+            category: "hook",
+            message: `Hook action ${action.type} is not allowed for ${event}`,
+            metadata: {
+                event,
+                action: action.type,
+            },
+        });
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/hooks/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/hooks/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D,MAAM,eAAe,GAA0D;IAC7E,aAAa,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,UAAU,CAAC;IACzB,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,UAAU,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IACvD,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IACtD,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IACrD,WAAW,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC;IACrD,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC;IACpD,cAAc,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IACvD,aAAa,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,KAAe,EACf,MAAkB;IAElB,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,eAAe,MAAM,CAAC,IAAI,uBAAuB,KAAK,EAAE;YACjE,QAAQ,EAAE;gBACR,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI;aACpB;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/hooks/registry.d.ts

@@ -0,0 +1,13 @@
+import type { Hook, HookName } from "./types.js";
+export interface HookRegistry {
+    register(hook: Hook): void;
+    unregister(id: string): boolean;
+    list(event?: HookName): readonly Hook[];
+}
+export declare class DefaultHookRegistry implements HookRegistry {
+    private readonly hooks;
+    private order;
+    register(hook: Hook): void;
+    unregister(id: string): boolean;
+    list(event?: HookName): readonly Hook[];
+}

package/dist/hooks/registry.js

@@ -0,0 +1,31 @@
+import { RuntimeError } from "../errors/index.js";
+export class DefaultHookRegistry {
+    hooks = new Map();
+    order = 0;
+    register(hook) {
+        if (this.hooks.has(hook.id)) {
+            throw new RuntimeError({
+                code: "HOOK_FAILED",
+                category: "hook",
+                message: `Hook already registered: ${hook.id}`,
+            });
+        }
+        this.hooks.set(hook.id, {
+            hook,
+            order: this.order++,
+        });
+    }
+    unregister(id) {
+        return this.hooks.delete(id);
+    }
+    list(event) {
+        return [...this.hooks.values()]
+            .filter((entry) => event === undefined || entry.hook.event === event)
+            .sort((left, right) => {
+            const priority = right.hook.priority - left.hook.priority;
+            return priority !== 0 ? priority : left.order - right.order;
+        })
+            .map((entry) => entry.hook);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAclD,MAAM,OAAO,mBAAmB;IACb,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,GAAG,CAAC,CAAC;IAElB,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,4BAA4B,IAAI,CAAC,EAAE,EAAE;aAC/C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;YACtB,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,KAAgB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC;aACpE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC1D,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC9D,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/hooks/timeout.d.ts

@@ -0,0 +1,2 @@
+import type { Hook, HookAction, HookContext } from "./types.js";
+export declare function runHookWithTimeout<TPayload, TResult>(hook: Hook<TPayload, TResult>, payload: Readonly<TPayload>, context: HookContext, defaultTimeoutMs?: number): Promise<HookAction<TResult>>;

package/dist/hooks/timeout.js

@@ -0,0 +1,63 @@
+import { RuntimeError } from "../errors/index.js";
+function abortedError(reason) {
+    return new RuntimeError({
+        code: "ABORTED",
+        category: "abort",
+        message: "Operation aborted",
+        ...(reason === undefined ? {} : { cause: reason }),
+    });
+}
+export async function runHookWithTimeout(hook, payload, context, defaultTimeoutMs) {
+    if (context.signal?.aborted) {
+        throw abortedError(context.signal.reason);
+    }
+    const timeoutMs = hook.timeoutMs ?? defaultTimeoutMs;
+    if (timeoutMs === undefined && context.signal === undefined) {
+        return hook.handle(payload, context);
+    }
+    const controller = new AbortController();
+    const parent = context.signal;
+    const onParentAbort = () => {
+        controller.abort(parent?.reason);
+    };
+    parent?.addEventListener("abort", onParentAbort, { once: true });
+    let timer;
+    let rejectControl;
+    const control = new Promise((_resolve, reject) => {
+        rejectControl = reject;
+        if (timeoutMs !== undefined) {
+            timer = setTimeout(() => {
+                controller.abort();
+                reject(new RuntimeError({
+                    code: "HOOK_FAILED",
+                    category: "hook",
+                    message: `Hook timed out after ${timeoutMs}ms: ${hook.id}`,
+                }));
+            }, timeoutMs);
+        }
+        if (parent !== undefined) {
+            parent.addEventListener("abort", () => reject(abortedError(parent.reason)), { once: true });
+        }
+    });
+    const hookContext = {
+        sessionId: context.sessionId,
+        ...(context.runId === undefined ? {} : { runId: context.runId }),
+        ...(context.turnId === undefined ? {} : { turnId: context.turnId }),
+        signal: controller.signal,
+        ...(context.metadata === undefined ? {} : { metadata: context.metadata }),
+    };
+    try {
+        return await Promise.race([
+            hook.handle(payload, hookContext),
+            control,
+        ]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        parent?.removeEventListener("abort", onParentAbort);
+        rejectControl = undefined;
+    }
+}
+//# sourceMappingURL=timeout.js.map

package/dist/hooks/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/hooks/timeout.ts"],"names":[],"mappings":"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"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,40 @@
+import type { Metadata, RunId, SessionId, TurnId } from "../types/index.js";
+export type HookName = "session_start" | "session_end" | "run_start" | "run_end" | "turn_start" | "turn_end" | "before_context" | "after_context" | "before_model" | "after_model" | "before_tool" | "after_tool" | "before_compact" | "after_compact" | "error" | "stop";
+export interface HookContext {
+    sessionId: SessionId;
+    runId?: RunId;
+    turnId?: TurnId;
+    signal?: AbortSignal;
+    metadata?: Metadata;
+}
+export type HookAction<T = unknown> = {
+    type: "continue";
+} | {
+    type: "modify";
+    value: T;
+} | {
+    type: "block";
+    reason: string;
+} | {
+    type: "retry";
+    reason?: string;
+} | {
+    type: "stop";
+    reason?: string;
+};
+export type HookFailureMode = "fail_open" | "fail_closed";
+export interface Hook<TPayload = unknown, TResult = unknown> {
+    readonly id: string;
+    readonly event: HookName;
+    readonly priority: number;
+    readonly timeoutMs?: number;
+    readonly failureMode: HookFailureMode;
+    handle(payload: Readonly<TPayload>, context: HookContext): Promise<HookAction<TResult>>;
+}
+export interface HookRunResult<T> {
+    value: T;
+    blocked: boolean;
+    stopRequested: boolean;
+    retryRequested: boolean;
+    reason?: string;
+}

package/dist/hooks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./types/index.js";
+export * from "./errors/index.js";
+export * from "./settings/index.js";
+export * from "./model/index.js";
+export * from "./utils/index.js";
+export * from "./session/index.js";
+export * from "./context/index.js";
+export * from "./events/index.js";
+export * from "./hooks/index.js";
+export * from "./tools/index.js";
+export * from "./loop/index.js";
+export * from "./compaction/index.js";
+export * from "./agent/index.js";

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./types/index.js";
+export * from "./errors/index.js";
+export * from "./settings/index.js";
+export * from "./model/index.js";
+export * from "./utils/index.js";
+export * from "./session/index.js";
+export * from "./context/index.js";
+export * from "./events/index.js";
+export * from "./hooks/index.js";
+export * from "./tools/index.js";
+export * from "./loop/index.js";
+export * from "./compaction/index.js";
+export * from "./agent/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/loop/index.d.ts

@@ -0,0 +1,7 @@
+export type * from "./types.js";
+export { assertTransition } from "./transition.js";
+export { RunStateController } from "./state.js";
+export { MaxTurnsPolicy, MaxToolRoundsPolicy, CompositeLoopPolicy, createDefaultLoopPolicy, } from "./policy.js";
+export { ModelStreamAssembler } from "./stream-assembler.js";
+export type { RunRecorder } from "./recorder.js";
+export { DefaultAgentLoop } from "./loop.js";

package/dist/loop/index.js

@@ -0,0 +1,6 @@
+export { assertTransition } from "./transition.js";
+export { RunStateController } from "./state.js";
+export { MaxTurnsPolicy, MaxToolRoundsPolicy, CompositeLoopPolicy, createDefaultLoopPolicy, } from "./policy.js";
+export { ModelStreamAssembler } from "./stream-assembler.js";
+export { DefaultAgentLoop } from "./loop.js";
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/loop/loop.d.ts

@@ -0,0 +1,22 @@
+import type { AgentEvent } from "../events/types.js";
+import type { AgentRunState } from "../types/index.js";
+import type { AgentLoop, AgentLoopDependencies, AgentLoopOptions, LoopInput } from "./types.js";
+export declare class DefaultAgentLoop implements AgentLoop {
+    private readonly dependencies;
+    private readonly state;
+    private readonly options;
+    private running;
+    private runEndAttempted;
+    constructor(dependencies: AgentLoopDependencies, options: AgentLoopOptions);
+    getState(): Readonly<AgentRunState>;
+    run(input: LoopInput, signal?: AbortSignal): AsyncIterable<AgentEvent>;
+    private prepareMessages;
+    private prepareModelRequest;
+    private loadSnapshot;
+    private performCompaction;
+    private runHook;
+    private shouldStop;
+    private runEndHookOnce;
+    private finishCompleted;
+    private finishAbort;
+}