@agent-native/agentkit 0.1.0

package/dist/adapters/http.d.ts

@@ -0,0 +1,56 @@
+import type { AgentRequestContext, AgentTransport } from "../protocol/index.js";
+export interface AgentKitHttpTransportOptions {
+    baseUrl: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    /** Stable request correlation for distributed traces and deterministic tests. */
+    createCorrelationId?: () => string;
+    /** Aborts every request owned by this transport lifecycle. */
+    signal?: AbortSignal;
+}
+export declare class AgentKitHttpError extends Error {
+    readonly status: number;
+    readonly details?: unknown;
+    readonly code?: string | undefined;
+    readonly correlationId?: string | undefined;
+    readonly retryable: boolean;
+    constructor(status: number, message: string, details?: unknown, code?: string | undefined, correlationId?: string | undefined, retryable?: boolean);
+}
+export declare function createAgentKitHttpTransport(options: AgentKitHttpTransportOptions): AgentTransport;
+export interface AgentKitHttpServerRequestContext<TTrustedContext> extends AgentRequestContext {
+    /**
+     * Host-resolved authority for this request. This value is never read from a
+     * protocol envelope and is never serialized into an AgentKit response.
+     */
+    readonly trusted: TTrustedContext;
+}
+interface AgentKitHttpHandlerBaseOptions {
+    basePath?: string;
+    /** Receives validation, transport, and backend failures for host logging. */
+    onError?: (error: unknown, request: Request) => void | Promise<void>;
+}
+export type AgentKitHttpHandlerOptions<TTrustedContext = never> = AgentKitHttpHandlerBaseOptions & ({
+    /** A host-owned transport for handlers whose trust scope is static. */
+    transport: AgentTransport;
+    transportOwnership?: never;
+    resolveRequestContext?: never;
+    createTransport?: never;
+} | {
+    transport?: never;
+    /**
+     * Request-created transports are owned by the handler by default.
+     * Use `borrowed` only when the factory returns a host-managed transport.
+     */
+    transportOwnership?: "borrowed" | "owned";
+    /** Resolves authenticated, authorized host state from this request. */
+    resolveRequestContext: (request: Request) => TTrustedContext | Promise<TTrustedContext>;
+    /**
+     * Creates a transport closed over the resolved authority. Transport
+     * operations still receive only cancellation and correlation state.
+     */
+    createTransport: (context: AgentKitHttpServerRequestContext<TTrustedContext>) => AgentTransport | Promise<AgentTransport>;
+});
+/** Framework-neutral Fetch handler for serverless, Node, and edge runtimes. */
+export declare function createAgentKitHttpHandler<TTrustedContext = never>(options: AgentKitHttpHandlerOptions<TTrustedContext>): (request: Request) => Promise<Response>;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/adapters/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/adapters/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,mBAAmB,EACnB,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAqD9B,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,MAAM;aAEd,OAAO,CAAC,EAAE,OAAO;aACjB,IAAI,CAAC,EAAE,MAAM;aACb,aAAa,CAAC,EAAE,MAAM;aACtB,SAAS;IAN3B,YACkB,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,SAAS,UAAgC,EAI1D;CACF;AA2QD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,cAAc,CAuUhB;AAED,MAAM,WAAW,gCAAgC,CAC/C,eAAe,CACf,SAAQ,mBAAmB;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED,UAAU,8BAA8B;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,MAAM,0BAA0B,CAAC,eAAe,GAAG,KAAK,IAC5D,8BAA8B,GAC5B,CACI;IACE,uEAAuE;IACvE,SAAS,EAAE,cAAc,CAAC;IAC1B,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB,GACD;IACE,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC1C,uEAAuE;IACvE,qBAAqB,EAAE,CACrB,OAAO,EAAE,OAAO,KACb,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD;;;OAGG;IACH,eAAe,EAAE,CACf,OAAO,EAAE,gCAAgC,CAAC,eAAe,CAAC,KACvD,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/C,CACJ,CAAC;AA+MN,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,eAAe,GAAG,KAAK,EAC/D,OAAO,EAAE,0BAA0B,CAAC,eAAe,CAAC,GACnD,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAwkBzC"}