@cosmicdrift/kumiko-framework 0.388.0 → 0.390.0

package/dist/engine/feature-ast/extractors/ai-steps.js

@@ -1,254 +0,0 @@
-import { sourceLocationFromNode } from "../source-location.js";
-import { fail, findFunctionLiteral, isPlainObject, isRawRefSentinel, ok, readDataLiteralNode, readNameLiteral, readObjectPropertyInitializer, readStringOrRaw, resolveSameFileObjectLiteral, } from "./shared.js";
-function readEditableStringProp(obj, propertyName) {
-    const init = readObjectPropertyInitializer(obj, propertyName);
-    if (!init)
-        return undefined;
-    const value = readStringOrRaw(init);
-    if (value === undefined)
-        return undefined;
-    return value;
-}
-function readEditableDefaults(node) {
-    const value = readDataLiteralNode(node);
-    if (isRawRefSentinel(value))
-        return value;
-    if (!isPlainObject(value))
-        return undefined;
-    if (typeof value["enabled"] !== "boolean")
-        return undefined;
-    if (!isPlainObject(value["params"]))
-        return undefined;
-    return {
-        enabled: value["enabled"],
-        params: value["params"],
-        ...(typeof value["providerId"] === "string" && { providerId: value["providerId"] }),
-        ...(typeof value["model"] === "string" && { model: value["model"] }),
-    };
-}
-function readClassifyActions(node) {
-    const value = readDataLiteralNode(node);
-    if (!Array.isArray(value))
-        return undefined;
-    const out = [];
-    for (const entry of value) {
-        if (!isPlainObject(entry))
-            return undefined;
-        if (typeof entry["type"] !== "string" || typeof entry["description"] !== "string") {
-            return undefined;
-        }
-        out.push({ type: entry["type"], description: entry["description"] });
-    }
-    return out;
-}
-function extractAiStepCommon(call, sourceFile, kind) {
-    const source = sourceLocationFromNode(call, sourceFile);
-    const arg = call.getArguments()[0];
-    if (!arg) {
-        return fail(kind, source, "expected one argument object");
-    }
-    const obj = resolveSameFileObjectLiteral(arg);
-    if (!obj) {
-        if (isRawRefSentinel(readDataLiteralNode(arg))) {
-            return ok({
-                source,
-                argsSource: { __raw: arg.getText() },
-            });
-        }
-        return fail(kind, source, "argument must be an inline object literal or a same-file const resolving to one");
-    }
-    const stepKeyInit = readObjectPropertyInitializer(obj, "stepKey");
-    if (!stepKeyInit) {
-        return fail(kind, source, "missing `stepKey` property");
-    }
-    // PatternId needs a concrete string — resolve identifiers like patch.readAiStepKey.
-    const stepKeyLiteral = readNameLiteral(stepKeyInit);
-    const stepKey = stepKeyLiteral ?? readStringOrRaw(stepKeyInit);
-    if (stepKey === undefined) {
-        return fail(kind, source, "`stepKey` must be a string literal or resolvable identifier");
-    }
-    const promptKey = readEditableStringProp(obj, "promptKey");
-    if (promptKey === undefined) {
-        return fail(kind, source, "missing `promptKey` property");
-    }
-    const promptFallbackInit = readObjectPropertyInitializer(obj, "promptFallback");
-    if (!promptFallbackInit) {
-        return fail(kind, source, "missing `promptFallback` property");
-    }
-    const promptFallback = readStringOrRaw(promptFallbackInit);
-    if (promptFallback === undefined) {
-        return fail(kind, source, "`promptFallback` must be a string literal or identifier reference");
-    }
-    const defaultsInit = readObjectPropertyInitializer(obj, "defaults");
-    if (!defaultsInit) {
-        return fail(kind, source, "missing `defaults` property");
-    }
-    const defaults = readEditableDefaults(defaultsInit);
-    if (defaults === undefined) {
-        return fail(kind, source, "`defaults` could not be read as a StepPolicy literal");
-    }
-    const paramsSchemaInit = readObjectPropertyInitializer(obj, "paramsSchema");
-    if (!paramsSchemaInit) {
-        return fail(kind, source, "missing `paramsSchema` property");
-    }
-    return ok({
-        source,
-        stepKey,
-        promptKey,
-        promptFallback,
-        defaults,
-        paramsSchemaSource: sourceLocationFromNode(paramsSchemaInit, sourceFile),
-    });
-}
-function requireResolvedCommon(kind, pattern) {
-    if (pattern.argsSource) {
-        return fail(kind, pattern.source, "expected resolved inline object, got opaque args reference");
-    }
-    const { stepKey, promptKey, promptFallback, defaults, paramsSchemaSource, source } = pattern;
-    if (stepKey === undefined ||
-        promptKey === undefined ||
-        promptFallback === undefined ||
-        defaults === undefined ||
-        paramsSchemaSource === undefined) {
-        return fail(kind, source, "resolved AI step is missing required header fields");
-    }
-    return ok({ source, stepKey, promptKey, promptFallback, defaults, paramsSchemaSource });
-}
-export function extractAiGenerate(call, sourceFile) {
-    const common = extractAiStepCommon(call, sourceFile, "ai.generate");
-    if (common.kind === "error")
-        return common;
-    if (common.pattern.argsSource) {
-        return ok({
-            kind: "ai.generate",
-            source: common.pattern.source,
-            argsSource: common.pattern.argsSource,
-        });
-    }
-    const arg = call.getArguments()[0];
-    const obj = arg ? resolveSameFileObjectLiteral(arg) : undefined;
-    if (!obj) {
-        return fail("ai.generate", common.pattern.source, "expected resolvable argument object");
-    }
-    const inputInit = readObjectPropertyInitializer(obj, "input");
-    if (!inputInit) {
-        return fail("ai.generate", common.pattern.source, "missing `input` property");
-    }
-    const fn = findFunctionLiteral(inputInit);
-    if (!fn) {
-        return fail("ai.generate", common.pattern.source, "`input` must be an inline arrow function or function expression");
-    }
-    const resolved = requireResolvedCommon("ai.generate", common.pattern);
-    if (resolved.kind === "error")
-        return resolved;
-    return ok({
-        kind: "ai.generate",
-        source: resolved.pattern.source,
-        stepKey: resolved.pattern.stepKey,
-        promptKey: resolved.pattern.promptKey,
-        promptFallback: resolved.pattern.promptFallback,
-        defaults: resolved.pattern.defaults,
-        paramsSchemaSource: resolved.pattern.paramsSchemaSource,
-        inputBody: sourceLocationFromNode(fn, sourceFile),
-    });
-}
-export function extractAiExtract(call, sourceFile) {
-    const common = extractAiStepCommon(call, sourceFile, "ai.extract");
-    if (common.kind === "error")
-        return common;
-    if (common.pattern.argsSource) {
-        return ok({
-            kind: "ai.extract",
-            source: common.pattern.source,
-            argsSource: common.pattern.argsSource,
-        });
-    }
-    const arg = call.getArguments()[0];
-    const obj = arg ? resolveSameFileObjectLiteral(arg) : undefined;
-    if (!obj) {
-        return fail("ai.extract", common.pattern.source, "expected resolvable argument object");
-    }
-    const outputSchemaInit = readObjectPropertyInitializer(obj, "outputSchema");
-    if (!outputSchemaInit) {
-        return fail("ai.extract", common.pattern.source, "missing `outputSchema` property");
-    }
-    const instructionsInit = readObjectPropertyInitializer(obj, "instructions");
-    if (!instructionsInit) {
-        return fail("ai.extract", common.pattern.source, "missing `instructions` property");
-    }
-    const instructionsFn = findFunctionLiteral(instructionsInit);
-    if (!instructionsFn) {
-        return fail("ai.extract", common.pattern.source, "`instructions` must be an inline arrow function or function expression");
-    }
-    const documentInit = readObjectPropertyInitializer(obj, "document");
-    let documentBody;
-    if (documentInit) {
-        const documentFn = findFunctionLiteral(documentInit);
-        if (!documentFn) {
-            return fail("ai.extract", common.pattern.source, "`document` must be an inline arrow function or function expression");
-        }
-        documentBody = sourceLocationFromNode(documentFn, sourceFile);
-    }
-    const resolved = requireResolvedCommon("ai.extract", common.pattern);
-    if (resolved.kind === "error")
-        return resolved;
-    return ok({
-        kind: "ai.extract",
-        source: resolved.pattern.source,
-        stepKey: resolved.pattern.stepKey,
-        promptKey: resolved.pattern.promptKey,
-        promptFallback: resolved.pattern.promptFallback,
-        defaults: resolved.pattern.defaults,
-        paramsSchemaSource: resolved.pattern.paramsSchemaSource,
-        outputSchemaSource: sourceLocationFromNode(outputSchemaInit, sourceFile),
-        instructionsBody: sourceLocationFromNode(instructionsFn, sourceFile),
-        ...(documentBody !== undefined && { documentBody }),
-    });
-}
-export function extractAiClassify(call, sourceFile) {
-    const common = extractAiStepCommon(call, sourceFile, "ai.classify");
-    if (common.kind === "error")
-        return common;
-    if (common.pattern.argsSource) {
-        return ok({
-            kind: "ai.classify",
-            source: common.pattern.source,
-            argsSource: common.pattern.argsSource,
-        });
-    }
-    const arg = call.getArguments()[0];
-    const obj = arg ? resolveSameFileObjectLiteral(arg) : undefined;
-    if (!obj) {
-        return fail("ai.classify", common.pattern.source, "expected resolvable argument object");
-    }
-    const actionsInit = readObjectPropertyInitializer(obj, "actions");
-    if (!actionsInit) {
-        return fail("ai.classify", common.pattern.source, "missing `actions` property");
-    }
-    const actions = readClassifyActions(actionsInit);
-    if (actions === undefined) {
-        return fail("ai.classify", common.pattern.source, "`actions` must be an inline array of { type, description } objects");
-    }
-    const inputInit = readObjectPropertyInitializer(obj, "input");
-    if (!inputInit) {
-        return fail("ai.classify", common.pattern.source, "missing `input` property");
-    }
-    const inputFn = findFunctionLiteral(inputInit);
-    if (!inputFn) {
-        return fail("ai.classify", common.pattern.source, "`input` must be an inline arrow function or function expression");
-    }
-    const resolved = requireResolvedCommon("ai.classify", common.pattern);
-    if (resolved.kind === "error")
-        return resolved;
-    return ok({
-        kind: "ai.classify",
-        source: resolved.pattern.source,
-        stepKey: resolved.pattern.stepKey,
-        promptKey: resolved.pattern.promptKey,
-        promptFallback: resolved.pattern.promptFallback,
-        defaults: resolved.pattern.defaults,
-        paramsSchemaSource: resolved.pattern.paramsSchemaSource,
-        actions,
-        inputBody: sourceLocationFromNode(inputFn, sourceFile),
-    });
-}

package/dist/engine/feature-ast/extractors/events.d.ts

@@ -1,5 +0,0 @@
-import type { CallExpression, SourceFile } from "ts-morph";
-import type { DefineEventPattern, NotificationPattern } from "../patterns.ts";
-import { type ExtractOutput } from "./shared.ts";
-export declare function extractDefineEvent(call: CallExpression, sourceFile: SourceFile): ExtractOutput<DefineEventPattern>;
-export declare function extractNotification(call: CallExpression, sourceFile: SourceFile): ExtractOutput<NotificationPattern>;

package/dist/engine/feature-ast/extractors/events.js

@@ -1,275 +0,0 @@
-import { SyntaxKind } from "ts-morph";
-import { sourceLocationFromNode } from "../source-location.js";
-import { fail, findFunctionLiteral, ok, readDataLiteralNode, readNameLiteral, readNameLiteralRef, readNameOrRef, readPropertyKey, } from "./shared.js";
-// Reads defineEvent's `migrations` option — either the array-of-steps shape
-// used by hand-authored calls (`[{ fromVersion, toVersion, transform }]`,
-// toVersion is redundant on-disk since it is always fromVersion + 1) or the
-// keyed-object canonical shape the Designer renders (`{ "1": transform }`).
-// Keyed by fromVersion (as a string) → the transform closure's location.
-// Skips malformed entries rather than failing the whole defineEvent extract
-// — same "best-effort, degrade gracefully" posture as readDataLiteralNode.
-function extractEventMigrationsFromArray(arr, sourceFile) {
-    const result = {};
-    const arrLit = arr.asKindOrThrow(SyntaxKind.ArrayLiteralExpression);
-    for (const el of arrLit.getElements()) {
-        const obj = el.asKind(SyntaxKind.ObjectLiteralExpression);
-        if (!obj)
-            continue;
-        const fromInit = obj
-            .getProperty("fromVersion")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        const fromVersion = fromInit ? readDataLiteralNode(fromInit) : undefined;
-        if (typeof fromVersion !== "number")
-            continue;
-        const transformInit = obj
-            .getProperty("transform")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        const fn = transformInit ? findFunctionLiteral(transformInit) : undefined;
-        if (!fn)
-            continue;
-        result[String(fromVersion)] = sourceLocationFromNode(fn, sourceFile);
-    }
-    return result;
-}
-function extractEventMigrationsFromKeyedObject(objLit, sourceFile) {
-    const result = {};
-    const obj = objLit.asKindOrThrow(SyntaxKind.ObjectLiteralExpression);
-    for (const prop of obj.getProperties()) {
-        const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-        const initializer = propAssign?.getInitializer();
-        const fn = initializer ? findFunctionLiteral(initializer) : undefined;
-        if (!propAssign || !fn)
-            continue;
-        result[readPropertyKey(propAssign)] = sourceLocationFromNode(fn, sourceFile);
-    }
-    return result;
-}
-// Reads defineEvent's `migrations` option — either the array-of-steps shape
-// used by hand-authored calls (`[{ fromVersion, toVersion, transform }]`,
-// toVersion is redundant on-disk since it is always fromVersion + 1) or the
-// keyed-object canonical shape the Designer renders (`{ "1": transform }`).
-// Keyed by fromVersion (as a string) → the transform closure's location.
-// Skips malformed entries rather than failing the whole defineEvent extract
-// — same "best-effort, degrade gracefully" posture as readDataLiteralNode.
-function extractEventMigrationsField(node, sourceFile) {
-    const result = node.asKind(SyntaxKind.ArrayLiteralExpression)
-        ? extractEventMigrationsFromArray(node, sourceFile)
-        : node.asKind(SyntaxKind.ObjectLiteralExpression)
-            ? extractEventMigrationsFromKeyedObject(node, sourceFile)
-            : undefined;
-    return result && Object.keys(result).length > 0 ? result : undefined;
-}
-// `{ piiFields }` shorthand is a valid stance; its name node doubles as the location.
-function readPiiFieldsNode(obj) {
-    const prop = obj?.getProperty("piiFields");
-    return (prop?.asKind(SyntaxKind.PropertyAssignment)?.getInitializer() ??
-        prop?.asKind(SyntaxKind.ShorthandPropertyAssignment)?.getNameNode());
-}
-export function extractDefineEvent(call, sourceFile) {
-    const args = call.getArguments();
-    const first = args[0];
-    if (!first) {
-        return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "expected at least one argument");
-    }
-    const obj = first.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (obj && args.length === 1) {
-        const nameInit = obj
-            .getProperty("name")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer()
-            ?.asKind(SyntaxKind.StringLiteral);
-        if (!nameInit) {
-            return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "object form requires a string-literal `name` property");
-        }
-        const schemaInit = obj
-            .getProperty("schema")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        if (!schemaInit) {
-            return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "object form requires a `schema` property");
-        }
-        let version;
-        const versionInit = obj
-            .getProperty("version")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        if (versionInit) {
-            const v = readDataLiteralNode(versionInit);
-            if (typeof v === "number")
-                version = v;
-        }
-        const piiFieldsInit = readPiiFieldsNode(obj);
-        if (!piiFieldsInit) {
-            return fail("defineEvent", sourceLocationFromNode(call, sourceFile), 'requires an explicit `piiFields` stance (an object literal or "none")');
-        }
-        const migrationsInit = obj
-            .getProperty("migrations")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        const migrations = migrationsInit
-            ? extractEventMigrationsField(migrationsInit, sourceFile)
-            : undefined;
-        return ok({
-            kind: "defineEvent",
-            source: sourceLocationFromNode(call, sourceFile),
-            eventName: nameInit.getLiteralValue(),
-            schemaSource: sourceLocationFromNode(schemaInit, sourceFile),
-            piiFields: sourceLocationFromNode(piiFieldsInit, sourceFile),
-            ...(version !== undefined && { version }),
-            ...(migrations !== undefined && { migrations }),
-        });
-    }
-    const eventNameRef = readNameLiteralRef(first);
-    if (eventNameRef === undefined) {
-        return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "first argument must be a string literal event name, or an identifier resolving to one (or use the object form)");
-    }
-    const schemaArg = args[1];
-    if (!schemaArg) {
-        return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "expected a Zod schema as second argument");
-    }
-    let version;
-    let migrations;
-    const optionsArg = args[2];
-    const optionsObj = optionsArg?.asKind(SyntaxKind.ObjectLiteralExpression);
-    const piiFieldsInit = readPiiFieldsNode(optionsObj);
-    if (!piiFieldsInit) {
-        if (optionsArg && !optionsObj) {
-            return fail("defineEvent", sourceLocationFromNode(call, sourceFile), "options must be an object literal");
-        }
-        return fail("defineEvent", sourceLocationFromNode(call, sourceFile), 'requires an explicit `piiFields` stance (an object literal or "none")');
-    }
-    if (optionsObj) {
-        const versionInit = optionsObj
-            .getProperty("version")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        if (versionInit) {
-            const v = readDataLiteralNode(versionInit);
-            if (typeof v === "number")
-                version = v;
-        }
-        const migrationsInit = optionsObj
-            .getProperty("migrations")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        if (migrationsInit) {
-            migrations = extractEventMigrationsField(migrationsInit, sourceFile);
-        }
-    }
-    return ok({
-        kind: "defineEvent",
-        source: sourceLocationFromNode(call, sourceFile),
-        eventName: eventNameRef.value,
-        ...(eventNameRef.raw !== undefined && { eventNameRaw: eventNameRef.raw }),
-        schemaSource: sourceLocationFromNode(schemaArg, sourceFile),
-        piiFields: sourceLocationFromNode(piiFieldsInit, sourceFile),
-        ...(version !== undefined && { version }),
-        ...(migrations !== undefined && { migrations }),
-    });
-}
-export function extractNotification(call, sourceFile) {
-    const args = call.getArguments();
-    const first = args[0];
-    if (!first) {
-        return fail("notification", sourceLocationFromNode(call, sourceFile), "expected at least one argument");
-    }
-    let notificationName;
-    let defObj;
-    const firstObj = first.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (firstObj && args.length === 1) {
-        const nameInit = firstObj
-            .getProperty("name")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer()
-            ?.asKind(SyntaxKind.StringLiteral);
-        if (!nameInit) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "object form requires a string-literal `name` property");
-        }
-        notificationName = nameInit.getLiteralValue();
-        defObj = firstObj;
-    }
-    else {
-        notificationName = readNameLiteral(first);
-        if (notificationName === undefined) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "first argument must be a string literal notification name, or an identifier resolving to one (or use the object form)");
-        }
-        defObj = args[1]?.asKind(SyntaxKind.ObjectLiteralExpression);
-        if (!defObj) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "second argument must be an inline definition object");
-        }
-    }
-    const triggerProp = defObj.getProperty("trigger");
-    if (!triggerProp && (defObj.getProperty("recipient") || defObj.getProperty("data"))) {
-        return fail("notification", sourceLocationFromNode(call, sourceFile), "recipient and data require a `trigger`");
-    }
-    let onName;
-    let recipientFn;
-    let dataFn;
-    if (triggerProp) {
-        const triggerObj = triggerProp
-            .asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer()
-            ?.asKind(SyntaxKind.ObjectLiteralExpression);
-        if (!triggerObj) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "non-object `trigger` property");
-        }
-        const onInit = triggerObj
-            .getProperty("on")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        onName = onInit ? readNameOrRef(onInit) : undefined;
-        if (!onName) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "trigger.on must be a string literal or inline { name } object");
-        }
-        const recipientInit = defObj
-            .getProperty("recipient")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        recipientFn = recipientInit ? findFunctionLiteral(recipientInit) : undefined;
-        if (!recipientFn) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "recipient must be an inline arrow function or function expression");
-        }
-        const dataInit = defObj
-            .getProperty("data")
-            ?.asKind(SyntaxKind.PropertyAssignment)
-            ?.getInitializer();
-        dataFn = dataInit ? findFunctionLiteral(dataInit) : undefined;
-        if (!dataFn) {
-            return fail("notification", sourceLocationFromNode(call, sourceFile), "data must be an inline arrow function or function expression");
-        }
-    }
-    let templates;
-    const templatesObj = defObj
-        .getProperty("templates")
-        ?.asKind(SyntaxKind.PropertyAssignment)
-        ?.getInitializer()
-        ?.asKind(SyntaxKind.ObjectLiteralExpression);
-    if (templatesObj) {
-        templates = {};
-        for (const prop of templatesObj.getProperties()) {
-            const propAssign = prop.asKind(SyntaxKind.PropertyAssignment);
-            if (!propAssign)
-                continue;
-            const init = propAssign.getInitializer();
-            if (!init)
-                continue;
-            const tfn = findFunctionLiteral(init);
-            if (!tfn)
-                continue;
-            templates[readPropertyKey(propAssign)] = sourceLocationFromNode(tfn, sourceFile);
-        }
-    }
-    return ok({
-        kind: "notification",
-        source: sourceLocationFromNode(call, sourceFile),
-        notificationName,
-        ...(onName !== undefined && { trigger: { on: onName } }),
-        ...(recipientFn !== undefined && {
-            recipientBody: sourceLocationFromNode(recipientFn, sourceFile),
-        }),
-        ...(dataFn !== undefined && { dataBody: sourceLocationFromNode(dataFn, sourceFile) }),
-        ...(templates !== undefined && { templates }),
-    });
-}

package/dist/engine/feature-ast/extractors/handlers.d.ts

@@ -1,24 +0,0 @@
-import type { CallExpression, SourceFile } from "ts-morph";
-import type { AccessRule, AgentHandlerHints, AgentRisk, EscapeHatchDeclaration, PayloadRateLimitOption, RateLimitDeclaration } from "../../types/handlers.ts";
-import type { QueryHandlerPattern, StreamHandlerPattern, WriteHandlerPattern } from "../patterns.ts";
-import type { SourceLocation } from "../source-location.ts";
-import { type ExtractOutput, type RawRefSentinel } from "./shared.ts";
-export type ParsedHandlerCall = {
-    readonly source: SourceLocation;
-    readonly handlerName?: string;
-    readonly schemaSource?: SourceLocation;
-    readonly handlerBody?: SourceLocation;
-    readonly access?: AccessRule | RawRefSentinel;
-    readonly description?: string;
-    readonly agent?: AgentHandlerHints | RawRefSentinel;
-    readonly rateLimit?: RateLimitDeclaration | RawRefSentinel;
-    readonly additionalRateLimits?: readonly PayloadRateLimitOption[] | RawRefSentinel;
-    readonly unsafeSkipTransitionGuard?: boolean;
-    readonly escapeHatch?: EscapeHatchDeclaration | RawRefSentinel;
-};
-export declare const AGENT_RISK_VALUES: readonly AgentRisk[];
-export declare function readOptionalAgentHints(value: unknown): AgentHandlerHints | undefined;
-export declare function parseHandlerCall(call: CallExpression, sourceFile: SourceFile, methodName: "writeHandler" | "queryHandler" | "streamHandler"): ExtractOutput<ParsedHandlerCall>;
-export declare function extractWriteHandler(call: CallExpression, sourceFile: SourceFile): ExtractOutput<WriteHandlerPattern>;
-export declare function extractQueryHandler(call: CallExpression, sourceFile: SourceFile): ExtractOutput<QueryHandlerPattern>;
-export declare function extractStreamHandler(call: CallExpression, sourceFile: SourceFile): ExtractOutput<StreamHandlerPattern>;