@harny/sdk 0.0.1-alpha.1 → 0.1.1

package/dist/esm/agent/adapters.js

@@ -0,0 +1,543 @@
+/**
+ * Model adapters: three wire styles, configured entirely from a roster entry.
+ *
+ * The loop speaks one neutral shape (messages, tool specs, tool calls). An
+ * adapter translates it to one wire style and back:
+ *
+ * - `chat_completions`: the widely shared chat-completions request shape.
+ * - `messages`: the messages request shape with content blocks.
+ * - `generate_content`: the generate-content shape with function declarations.
+ *
+ * Which provider speaks which style, the base URL, the auth header, any fixed
+ * headers and any extra request-body fields (a pin to one host on a provider
+ * that routes to many) all come from the roster entry, so no provider or model
+ * name is written here and a new provider on an existing style is a roster edit.
+ *
+ * Within one run, the model's own assistant turns are replayed in the native
+ * form the provider returned (some providers require their reasoning or
+ * signature fields back on the next call), with one repair: a tool call whose
+ * arguments are not a JSON object is replayed with `{}` (the loop has already
+ * answered it as invalid), because some hosts refuse the whole request
+ * otherwise. Across runs the session store keeps plain text and action notes
+ * only, so a conversation survives a change of preset or provider.
+ *
+ * A model that thinks before it answers (`thinking_always_on` in its roster
+ * entry; the agent never switches thinking off) spends part of the answer
+ * limit thinking. Its adapter gives every call at least the entry's
+ * `answer_room_tokens`; only the tokens the model uses are billed, and the
+ * thinking itself is never capped. A turn the provider stopped at the limit,
+ * or before it finished for another documented reason, is marked `cutOff`.
+ */
+import { MAX_TIMER_MS, RunAborted, isPlainObject, or, pyDumps, sleep, toInt, truthy } from "./util.js";
+export class Usage {
+    constructor(inputTokens = 0, outputTokens = 0) {
+        this.inputTokens = inputTokens;
+        this.outputTokens = outputTokens;
+    }
+    get totalTokens() {
+        return this.inputTokens + this.outputTokens;
+    }
+    add(other) {
+        this.inputTokens += other.inputTokens;
+        this.outputTokens += other.outputTokens;
+    }
+}
+/**
+ * One neutral message. `native` holds a provider's own assistant turn.
+ *
+ * A `tool_results` message may carry `text`: the loop's own words to the model
+ * after the results (the closing turn at the step limit), sent in the same
+ * turn as the results so user and model turns keep alternating.
+ */
+export class Message {
+    constructor(init) {
+        this.role = init.role;
+        this.text = init.text ?? "";
+        this.toolCalls = init.toolCalls ?? [];
+        this.results = init.results ?? [];
+        this.native = init.native ?? null;
+        this.nativeStyle = init.nativeStyle ?? null;
+    }
+}
+/** How each wire style says "stopped at the answer limit". */
+const LENGTH_STOPS = new Set(["length", "max_tokens", "MAX_TOKENS"]);
+/**
+ * Other stop reasons the providers document for a turn that did not finish: a
+ * content or safety filter, a lack of resources or a network or server fault
+ * mid-answer, an aborted or paused turn, a full context window, a refusal, or
+ * a malformed or unexpected tool call. Such a turn is never an answer and its
+ * tool calls are never run.
+ */
+const UNFINISHED_STOPS = new Set([
+    // chat-completions hosts
+    "content_filter", "insufficient_system_resource", "aborted", "sensitive", "network_error",
+    "server_error", "model_context_window_exceeded", "error",
+    // messages
+    "refusal", "pause_turn",
+    // generate-content
+    "SAFETY", "RECITATION", "BLOCKLIST", "PROHIBITED_CONTENT", "SPII", "IMAGE_SAFETY", "LANGUAGE", "OTHER",
+    "MALFORMED_FUNCTION_CALL", "UNEXPECTED_TOOL_CALL", "TOO_MANY_TOOL_CALLS",
+]);
+export class ModelTurn {
+    constructor(text, toolCalls, usage, stop, native = null) {
+        this.text = text;
+        this.toolCalls = toolCalls;
+        this.usage = usage;
+        this.stop = stop;
+        this.native = native;
+    }
+    /** The provider stopped this turn before it finished: text and tool calls may be incomplete. */
+    get cutOff() {
+        return LENGTH_STOPS.has(this.stop) || UNFINISHED_STOPS.has(this.stop);
+    }
+    /** Stopped at the answer limit (the common case of `cutOff`). */
+    get atAnswerLimit() {
+        return LENGTH_STOPS.has(this.stop);
+    }
+}
+/** The model provider refused or failed the call (after retries). */
+export class ModelProviderError extends Error {
+    constructor(message, statusCode = null) {
+        super(message);
+        this.name = "ModelProviderError";
+        this.statusCode = statusCode;
+    }
+}
+const RETRY_STATUS = new Set([408, 409, 425, 429, 500, 502, 503, 504, 529]);
+const MAX_RETRIES = 2;
+const MAX_RETRY_AFTER_S = 10;
+function retryAfterSeconds(response, attempt) {
+    const raw = response.headers.get("retry-after");
+    let value = raw === null ? 2 ** attempt : Number(raw.trim());
+    if (raw !== null && (raw.trim() === "" || Number.isNaN(value)))
+        value = 2 ** attempt;
+    return Math.max(0, Math.min(value, MAX_RETRY_AFTER_S));
+}
+function errorText(text) {
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        return text.slice(0, 300);
+    }
+    if (isPlainObject(body)) {
+        const err = body.error;
+        if (isPlainObject(err)) {
+            return String(truthy(err.message) ? err.message : pyDumps(err)).slice(0, 300);
+        }
+        if (typeof err === "string")
+            return err.slice(0, 300);
+    }
+    return pyDumps(body).slice(0, 300);
+}
+/** One call's signal: aborts on the run's signal or after `timeoutMs`. Call `done()` when the call ends. */
+function callSignal(outer, timeoutMs) {
+    const controller = new AbortController();
+    const onOuter = () => controller.abort(outer?.reason);
+    const timer = setTimeout(() => controller.abort(new DOMException("timed out", "TimeoutError")), Math.min(timeoutMs, MAX_TIMER_MS));
+    if (outer) {
+        if (outer.aborted)
+            controller.abort(outer.reason);
+        else
+            outer.addEventListener("abort", onOuter, { once: true });
+    }
+    return {
+        signal: controller.signal,
+        done: () => {
+            clearTimeout(timer);
+            outer?.removeEventListener("abort", onOuter);
+        },
+    };
+}
+async function drain(response) {
+    try {
+        await response.arrayBuffer();
+    }
+    catch {
+        // the body is not needed
+    }
+}
+const ADAPTER_KEYS = new WeakMap();
+class HttpAdapter {
+    constructor(resolved, options = {}) {
+        const entry = resolved.entry;
+        this.provider = entry.provider;
+        this.model = entry.model;
+        this.base = entry.api.base_url.replace(/\/+$/, "");
+        this.auth = entry.api.auth;
+        this.fixedHeaders = { ...(entry.api.headers ?? {}) };
+        this.maxTokensParam = entry.api.max_tokens_param;
+        this.extraBody = JSON.parse(JSON.stringify(entry.api.extra_body ?? {}));
+        const caps = entry.capabilities ?? {};
+        const room = caps.answer_room_tokens;
+        this.answerRoomTokens = caps.thinking_always_on && truthy(room) ? toInt(room) : null;
+        this.fetchImpl = options.fetch ?? ((...args) => globalThis.fetch(...args));
+        this.timeoutMs = options.timeoutMs ?? 60000;
+        ADAPTER_KEYS.set(this, resolved.apiKey);
+    }
+    /** The caller's limit, raised to the roster's answer room for a model that always thinks. */
+    answerLimit(requested) {
+        return Math.max(Math.trunc(requested), this.answerRoomTokens ?? 0);
+    }
+    /** The roster entry's extra fields, added where the adapter set nothing. */
+    withExtra(body) {
+        for (const [key, value] of Object.entries(this.extraBody)) {
+            if (!(key in body))
+                body[key] = JSON.parse(JSON.stringify(value));
+        }
+        return body;
+    }
+    headers() {
+        const headers = { "Content-Type": "application/json", ...this.fixedHeaders };
+        const key = ADAPTER_KEYS.get(this) ?? "";
+        if (this.auth === "bearer")
+            headers["Authorization"] = `Bearer ${key}`;
+        else
+            headers[this.auth] = key;
+        return headers;
+    }
+    async post(url, body, signal) {
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt += 1) {
+            if (signal?.aborted)
+                throw new RunAborted();
+            const call = callSignal(signal, this.timeoutMs);
+            let response;
+            let text;
+            try {
+                response = await this.fetchImpl(url, {
+                    method: "POST",
+                    headers: this.headers(),
+                    body: JSON.stringify(body),
+                    signal: call.signal,
+                });
+                text = RETRY_STATUS.has(response.status) && attempt < MAX_RETRIES ? "" : await response.text();
+            }
+            catch (err) {
+                call.done();
+                if (signal?.aborted)
+                    throw new RunAborted();
+                if (attempt < MAX_RETRIES) {
+                    await sleep(1000 * 2 ** attempt, signal);
+                    continue;
+                }
+                throw new ModelProviderError(`${this.provider}: ${err?.message ?? String(err)}`);
+            }
+            call.done();
+            if (RETRY_STATUS.has(response.status) && attempt < MAX_RETRIES) {
+                await drain(response);
+                await sleep(1000 * retryAfterSeconds(response, attempt), signal);
+                continue;
+            }
+            if (!response.ok) {
+                throw new ModelProviderError(`${this.provider} returned ${response.status}: ${errorText(text)}`, response.status);
+            }
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                throw new ModelProviderError(`${this.provider} returned a body that is not JSON`);
+            }
+            if (!isPlainObject(data)) {
+                throw new ModelProviderError(`${this.provider} returned a non-object body`);
+            }
+            return data;
+        }
+        throw new ModelProviderError(`${this.provider}: retries exhausted`);
+    }
+}
+/** `[arguments, error]`: an object, or `null` with the reason it is not one. */
+export function parseArguments(raw) {
+    if (isPlainObject(raw))
+        return [raw, null];
+    if (raw === null || raw === undefined || raw === "")
+        return [{}, null];
+    if (typeof raw !== "string")
+        return [null, "arguments are not valid JSON: not a string"];
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch (err) {
+        return [null, `arguments are not valid JSON: ${err.message}`];
+    }
+    if (!isPlainObject(value))
+        return [null, "arguments must be a JSON object"];
+    return [value, null];
+}
+/**
+ * The model's own turn, safe to send back: a tool call whose arguments are not
+ * a JSON object is replayed with `{}`. Valid arguments go back byte for byte;
+ * the stored turn is never changed.
+ */
+export function replayable(native) {
+    if (!isPlainObject(native) || !Array.isArray(native.tool_calls))
+        return native;
+    let changed = false;
+    const repaired = native.tool_calls.map((call) => {
+        const fn = isPlainObject(call) ? call.function : undefined;
+        if (!isPlainObject(call) || !isPlainObject(fn))
+            return call;
+        const [args, err] = parseArguments(fn.arguments);
+        if (err !== null || typeof fn.arguments !== "string" || !fn.arguments.trim()) {
+            changed = true;
+            return { ...call, function: { ...fn, arguments: err === null ? pyDumps(args) : "{}" } };
+        }
+        return call;
+    });
+    return changed ? { ...native, tool_calls: repaired } : native;
+}
+export class ChatCompletionsAdapter extends HttpAdapter {
+    constructor() {
+        super(...arguments);
+        this.style = "chat_completions";
+    }
+    wireMessages(system, messages) {
+        const out = [{ role: "system", content: system }];
+        for (const message of messages) {
+            if (message.role === "user") {
+                out.push({ role: "user", content: message.text });
+            }
+            else if (message.role === "assistant") {
+                if (message.native !== null && message.nativeStyle === this.style)
+                    out.push(replayable(message.native));
+                else
+                    out.push({ role: "assistant", content: message.text });
+            }
+            else {
+                for (const result of message.results) {
+                    out.push({ role: "tool", tool_call_id: result.callId, content: result.content });
+                }
+                if (message.text)
+                    out.push({ role: "user", content: message.text });
+            }
+        }
+        return out;
+    }
+    async complete(request) {
+        const body = {
+            model: this.model,
+            messages: this.wireMessages(request.system, request.messages),
+            [this.maxTokensParam]: this.answerLimit(request.maxOutputTokens),
+        };
+        if (request.tools.length) {
+            body.tools = request.tools.map((t) => ({
+                type: "function",
+                function: { name: t.name, description: t.description, parameters: t.parameters },
+            }));
+            body.tool_choice = "auto";
+        }
+        const data = await this.post(`${this.base}/chat/completions`, this.withExtra(body), request.signal);
+        const choices = Array.isArray(data.choices) ? data.choices : [];
+        if (!choices.length)
+            throw new ModelProviderError(`${this.provider} returned no choices`);
+        const choice = isPlainObject(choices[0]) ? choices[0] : {};
+        const msg = isPlainObject(choice.message) ? choice.message : {};
+        const rawCalls = Array.isArray(msg.tool_calls) ? msg.tool_calls : [];
+        const calls = [];
+        for (const raw of rawCalls) {
+            const call = isPlainObject(raw) ? raw : {};
+            const fn = isPlainObject(call.function) ? call.function : {};
+            const [args, err] = parseArguments(fn.arguments);
+            calls.push({
+                id: String(or(call.id, `call_${calls.length}`)),
+                name: String(or(fn.name, "")),
+                arguments: args,
+                parseError: err,
+            });
+        }
+        const native = { role: "assistant", content: msg.content ?? null };
+        if (truthy(msg.tool_calls))
+            native.tool_calls = msg.tool_calls;
+        if (msg.reasoning_content !== undefined && msg.reasoning_content !== null) {
+            native.reasoning_content = msg.reasoning_content;
+        }
+        const usage = isPlainObject(data.usage) ? data.usage : {};
+        return new ModelTurn(typeof msg.content === "string" ? msg.content : "", calls, new Usage(toInt(usage.prompt_tokens), toInt(usage.completion_tokens)), String(or(choice.finish_reason, "")), native);
+    }
+}
+export class MessagesAdapter extends HttpAdapter {
+    constructor() {
+        super(...arguments);
+        this.style = "messages";
+    }
+    wireMessages(messages) {
+        const out = [];
+        for (const message of messages) {
+            if (message.role === "user") {
+                out.push({ role: "user", content: message.text });
+            }
+            else if (message.role === "assistant") {
+                if (message.native !== null && message.nativeStyle === this.style) {
+                    out.push({ role: "assistant", content: message.native });
+                }
+                else {
+                    out.push({ role: "assistant", content: [{ type: "text", text: message.text || "(no text)" }] });
+                }
+            }
+            else {
+                const content = message.results.map((r) => ({
+                    type: "tool_result",
+                    tool_use_id: r.callId,
+                    content: r.content,
+                    is_error: Boolean(r.isError),
+                }));
+                if (message.text)
+                    content.push({ type: "text", text: message.text });
+                out.push({ role: "user", content });
+            }
+        }
+        return out;
+    }
+    async complete(request) {
+        const body = {
+            model: this.model,
+            system: request.system,
+            messages: this.wireMessages(request.messages),
+            max_tokens: this.answerLimit(request.maxOutputTokens),
+        };
+        if (request.tools.length) {
+            body.tools = request.tools.map((t) => ({ name: t.name, description: t.description, input_schema: t.parameters }));
+        }
+        const data = await this.post(`${this.base}/messages`, this.withExtra(body), request.signal);
+        const blocks = Array.isArray(data.content) ? data.content : [];
+        const texts = [];
+        const calls = [];
+        for (const raw of blocks) {
+            const block = isPlainObject(raw) ? raw : {};
+            if (block.type === "text") {
+                texts.push(String(or(block.text, "")));
+            }
+            else if (block.type === "tool_use") {
+                const [args, err] = parseArguments(block.input);
+                calls.push({ id: String(block.id), name: String(or(block.name, "")), arguments: args, parseError: err });
+            }
+        }
+        const usage = isPlainObject(data.usage) ? data.usage : {};
+        const inputTokens = toInt(usage.input_tokens) + toInt(usage.cache_creation_input_tokens) + toInt(usage.cache_read_input_tokens);
+        return new ModelTurn(texts.join(""), calls, new Usage(inputTokens, toInt(usage.output_tokens)), String(or(data.stop_reason, "")), blocks);
+    }
+}
+const SCHEMA_KEYS = new Set([
+    "type", "format", "description", "nullable", "enum", "items", "properties", "required",
+    "minimum", "maximum", "minItems", "maxItems", "minLength", "maxLength", "pattern",
+]);
+/** Reduce a JSON schema to the subset function declarations accept. */
+export function declarationSchema(schema) {
+    if (!isPlainObject(schema))
+        return schema;
+    const out = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (!SCHEMA_KEYS.has(key))
+            continue;
+        if (key === "type" && typeof value === "string")
+            out[key] = value.toUpperCase();
+        else if (key === "properties" && isPlainObject(value)) {
+            out[key] = Object.fromEntries(Object.entries(value).map(([name, sub]) => [name, declarationSchema(sub)]));
+        }
+        else if (key === "items")
+            out[key] = declarationSchema(value);
+        else
+            out[key] = value;
+    }
+    return out;
+}
+export class GenerateContentAdapter extends HttpAdapter {
+    constructor() {
+        super(...arguments);
+        this.style = "generate_content";
+    }
+    wireContents(messages) {
+        const out = [];
+        for (const message of messages) {
+            if (message.role === "user") {
+                out.push({ role: "user", parts: [{ text: message.text }] });
+            }
+            else if (message.role === "assistant") {
+                if (message.native !== null && message.nativeStyle === this.style)
+                    out.push(message.native);
+                else
+                    out.push({ role: "model", parts: [{ text: message.text || "(no text)" }] });
+            }
+            else {
+                const parts = message.results.map((r) => {
+                    let payload;
+                    try {
+                        payload = JSON.parse(r.content);
+                    }
+                    catch {
+                        payload = r.content;
+                    }
+                    if (!isPlainObject(payload))
+                        payload = { result: payload };
+                    return { functionResponse: { name: r.name, response: payload } };
+                });
+                if (message.text)
+                    parts.push({ text: message.text });
+                out.push({ role: "user", parts });
+            }
+        }
+        return out;
+    }
+    async complete(request) {
+        const body = {
+            systemInstruction: { parts: [{ text: request.system }] },
+            contents: this.wireContents(request.messages),
+            generationConfig: { maxOutputTokens: this.answerLimit(request.maxOutputTokens) },
+        };
+        if (request.tools.length) {
+            body.tools = [
+                {
+                    functionDeclarations: request.tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        parameters: declarationSchema(t.parameters),
+                    })),
+                },
+            ];
+        }
+        const data = await this.post(`${this.base}/models/${this.model}:generateContent`, this.withExtra(body), request.signal);
+        const candidates = Array.isArray(data.candidates) ? data.candidates : [];
+        if (!candidates.length)
+            throw new ModelProviderError(`${this.provider} returned no candidates`);
+        const first = isPlainObject(candidates[0]) ? candidates[0] : {};
+        const content = truthy(first.content) && isPlainObject(first.content) ? first.content : { role: "model", parts: [] };
+        const texts = [];
+        const calls = [];
+        const parts = Array.isArray(content.parts) ? content.parts : [];
+        for (const raw of parts) {
+            const part = isPlainObject(raw) ? raw : {};
+            if ("functionCall" in part) {
+                const fc = isPlainObject(part.functionCall) ? part.functionCall : {};
+                const [args, err] = parseArguments(fc.args);
+                calls.push({
+                    id: String(or(fc.id, `call_${calls.length}`)),
+                    name: String(or(fc.name, "")),
+                    arguments: args,
+                    parseError: err,
+                });
+            }
+            else if ("text" in part && !truthy(part.thought)) {
+                texts.push(String(part.text));
+            }
+        }
+        const usage = isPlainObject(data.usageMetadata) ? data.usageMetadata : {};
+        const output = toInt(usage.candidatesTokenCount) + toInt(usage.thoughtsTokenCount);
+        return new ModelTurn(texts.join(""), calls, new Usage(toInt(usage.promptTokenCount), output), String(or(first.finishReason, "")), content);
+    }
+}
+const ADAPTERS = {
+    chat_completions: ChatCompletionsAdapter,
+    messages: MessagesAdapter,
+    generate_content: GenerateContentAdapter,
+};
+/** The adapter for a resolved roster entry's wire style. */
+export function buildAdapter(resolved, options = {}) {
+    const style = resolved.entry.api.style;
+    const cls = Object.prototype.hasOwnProperty.call(ADAPTERS, style) ? ADAPTERS[style] : undefined;
+    if (!cls)
+        throw new Error(`unsupported wire style '${style}'`);
+    return new cls(resolved, options);
+}
+//# sourceMappingURL=adapters.js.map

package/dist/esm/agent/adapters.js.map

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

package/dist/esm/agent/hooks.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Seams where the business plugs in the checks it already trusts.
+ *
+ * The agent calls these at three moments:
+ *
+ * - `beforeModel`: just before each model call. Throw `HookBlocked` to stop
+ *   the run (for example a moderation check on the user's message).
+ * - `beforeAct`: just before each action is sent to Harny. Return
+ *   `ActDecision.deny(reason)` to skip it; the model is told it was not allowed.
+ * - `afterAct`: after Harny answers, with the outcome (for logging or alerts).
+ *
+ * A hook can narrow what the agent does; it cannot widen it. Harny still
+ * applies the business's acting policy, works out which kinds of action each
+ * one is and records every action on its own server, whatever a hook returns.
+ */
+import type { ActionInitiator, ActionOutcome } from "../index.js";
+import type { Message } from "./adapters.js";
+/** Thrown by a hook to stop the run. The message is kept on the result, not shown. */
+export declare class HookBlocked extends Error {
+    constructor(message: string);
+}
+export interface HookContext {
+    readonly runId: string;
+    readonly user: string;
+    readonly sessionId: string;
+    readonly initiatedBy: ActionInitiator;
+    readonly step: number;
+}
+export declare class ActDecision {
+    readonly allow: boolean;
+    readonly reason: string;
+    private constructor();
+    static allowed(): ActDecision;
+    static deny(reason: string): ActDecision;
+}
+/** Implement the ones you need; a missing hook does nothing. */
+export interface AgentHooks {
+    beforeModel?(ctx: HookContext, input: {
+        system: string;
+        messages: Message[];
+    }): void | Promise<void>;
+    /** Return `ActDecision.allowed()` or `ActDecision.deny(reason)`. */
+    beforeAct?(ctx: HookContext, input: {
+        action: string;
+        arguments: Record<string, unknown>;
+    }): ActDecision | Promise<ActDecision>;
+    afterAct?(ctx: HookContext, input: {
+        action: string;
+        arguments: Record<string, unknown>;
+        outcome: ActionOutcome;
+    }): void | Promise<void>;
+}

package/dist/esm/agent/hooks.js

@@ -0,0 +1,36 @@
+/**
+ * Seams where the business plugs in the checks it already trusts.
+ *
+ * The agent calls these at three moments:
+ *
+ * - `beforeModel`: just before each model call. Throw `HookBlocked` to stop
+ *   the run (for example a moderation check on the user's message).
+ * - `beforeAct`: just before each action is sent to Harny. Return
+ *   `ActDecision.deny(reason)` to skip it; the model is told it was not allowed.
+ * - `afterAct`: after Harny answers, with the outcome (for logging or alerts).
+ *
+ * A hook can narrow what the agent does; it cannot widen it. Harny still
+ * applies the business's acting policy, works out which kinds of action each
+ * one is and records every action on its own server, whatever a hook returns.
+ */
+/** Thrown by a hook to stop the run. The message is kept on the result, not shown. */
+export class HookBlocked extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HookBlocked";
+    }
+}
+export class ActDecision {
+    constructor(allow, reason = "") {
+        this.allow = allow;
+        this.reason = reason;
+        Object.freeze(this);
+    }
+    static allowed() {
+        return new ActDecision(true);
+    }
+    static deny(reason) {
+        return new ActDecision(false, reason);
+    }
+}
+//# sourceMappingURL=hooks.js.map