agentcassette 0.1.0

package/dist/client-CgkW5WWa.d.cts

@@ -0,0 +1,179 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type MessageRole = "system" | "user" | "assistant" | "tool";
+type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "json";
+    value: JsonValue;
+} | {
+    type: "image";
+    source: string;
+};
+interface SemanticMessage {
+    role: MessageRole;
+    content: ContentPart[];
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+interface ToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: JsonValue;
+}
+interface ToolCall {
+    id?: string;
+    name: string;
+    arguments: JsonValue;
+}
+interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd?: number;
+}
+interface SemanticRequest {
+    messages: SemanticMessage[];
+    tools: ToolDefinition[];
+    model?: string;
+}
+type SemanticResponseItem = {
+    type: "content";
+    part: ContentPart;
+} | {
+    type: "toolCall";
+    call: ToolCall;
+};
+interface SemanticResponse {
+    content: ContentPart[];
+    toolCalls: ToolCall[];
+    sequence?: SemanticResponseItem[];
+    id?: string;
+    model?: string;
+    finishReason?: string;
+    usage?: TokenUsage;
+}
+type SemanticEvent = {
+    type: "messages.sent";
+    messages: SemanticMessage[];
+} | {
+    type: "tool.result.returned";
+    message: SemanticMessage;
+} | {
+    type: "tool.call.proposed";
+    call: ToolCall;
+} | {
+    type: "output.final";
+    content: ContentPart[];
+};
+interface RecordedTurn {
+    index: number;
+    fingerprint: string;
+    request: SemanticRequest;
+    events: SemanticEvent[];
+    response: SemanticResponse;
+}
+interface CassetteMetadata {
+    provider?: string;
+    testFile?: string;
+    tags?: string[];
+    fingerprint?: "default" | "custom";
+}
+interface Cassette {
+    schemaVersion: 1;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    turns: RecordedTurn[];
+    metadata?: CassetteMetadata;
+}
+type CassetteMode = "record" | "replay" | "auto";
+interface ProviderAdapter<Request, Response> {
+    readonly provider: string;
+    normalizeRequest(request: Request): SemanticRequest;
+    normalizeResponse(response: Response): SemanticResponse;
+    replayResponse(response: SemanticResponse): Response;
+}
+type ClientBoundary<Request, Response> = (request: Request) => Promise<Response>;
+type FingerprintFunction = (request: SemanticRequest) => string;
+interface CostContext {
+    request: SemanticRequest;
+    response: SemanticResponse;
+}
+type CostCalculator = (context: CostContext) => number | undefined;
+
+interface RedactionContext {
+    path: string;
+    key?: string;
+    value: JsonValue;
+}
+interface RedactionRule {
+    name: string;
+    match(context: RedactionContext): boolean;
+    replacement?: JsonValue;
+}
+interface RedactionOptions {
+    rules?: RedactionRule[];
+    includeDefaults?: boolean;
+}
+declare const defaultRedactionRules: RedactionRule[];
+declare function redact<T>(value: T, options?: RedactionOptions): T;
+
+interface CassetteStore {
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+}
+declare class FileCassetteStore implements CassetteStore {
+    readonly directory: string;
+    constructor(directory?: string);
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+    pathFor(name: string): string;
+}
+declare class MemoryCassetteStore implements CassetteStore {
+    readonly cassettes: Map<string, Cassette>;
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+}
+declare function parseCassette(source: string, expectedName?: string): Cassette;
+
+interface ReplayContext {
+    cassette: string;
+    turn: number;
+    response: SemanticResponse;
+}
+interface CassetteClientOptions<Request, Response> {
+    name: string;
+    adapter: ProviderAdapter<Request, Response>;
+    client?: ClientBoundary<Request, Response>;
+    mode?: CassetteMode;
+    store?: CassetteStore;
+    fingerprint?: FingerprintFunction;
+    redaction?: RedactionOptions;
+    replayTurns?: number;
+    metadata?: CassetteMetadata;
+    calculateCost?: CostCalculator;
+    onReplay?: (context: ReplayContext) => void | Promise<void>;
+}
+interface CassetteClient<Request, Response> {
+    (request: Request): Promise<Response>;
+    readonly cassetteName: string;
+    readonly mode: "record" | "replay";
+    readonly turn: number;
+}
+declare function createCassetteClient<Request, Response>(options: CassetteClientOptions<Request, Response>): Promise<CassetteClient<Request, Response>>;
+
+export { type CassetteClient as C, type FingerprintFunction as F, type JsonValue as J, MemoryCassetteStore as M, type ProviderAdapter as P, type ReplayContext as R, type SemanticRequest as S, type TokenUsage as T, type CassetteClientOptions as a, type SemanticResponse as b, type Cassette as c, type CassetteMetadata as d, type CassetteMode as e, type CassetteStore as f, type ClientBoundary as g, type ContentPart as h, type CostCalculator as i, type CostContext as j, FileCassetteStore as k, type JsonPrimitive as l, type MessageRole as m, type RecordedTurn as n, type RedactionContext as o, type RedactionOptions as p, type RedactionRule as q, type SemanticEvent as r, type SemanticMessage as s, type SemanticResponseItem as t, type ToolCall as u, type ToolDefinition as v, createCassetteClient as w, defaultRedactionRules as x, parseCassette as y, redact as z };

package/dist/client-CgkW5WWa.d.ts

@@ -0,0 +1,179 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type MessageRole = "system" | "user" | "assistant" | "tool";
+type ContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "json";
+    value: JsonValue;
+} | {
+    type: "image";
+    source: string;
+};
+interface SemanticMessage {
+    role: MessageRole;
+    content: ContentPart[];
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+interface ToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: JsonValue;
+}
+interface ToolCall {
+    id?: string;
+    name: string;
+    arguments: JsonValue;
+}
+interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd?: number;
+}
+interface SemanticRequest {
+    messages: SemanticMessage[];
+    tools: ToolDefinition[];
+    model?: string;
+}
+type SemanticResponseItem = {
+    type: "content";
+    part: ContentPart;
+} | {
+    type: "toolCall";
+    call: ToolCall;
+};
+interface SemanticResponse {
+    content: ContentPart[];
+    toolCalls: ToolCall[];
+    sequence?: SemanticResponseItem[];
+    id?: string;
+    model?: string;
+    finishReason?: string;
+    usage?: TokenUsage;
+}
+type SemanticEvent = {
+    type: "messages.sent";
+    messages: SemanticMessage[];
+} | {
+    type: "tool.result.returned";
+    message: SemanticMessage;
+} | {
+    type: "tool.call.proposed";
+    call: ToolCall;
+} | {
+    type: "output.final";
+    content: ContentPart[];
+};
+interface RecordedTurn {
+    index: number;
+    fingerprint: string;
+    request: SemanticRequest;
+    events: SemanticEvent[];
+    response: SemanticResponse;
+}
+interface CassetteMetadata {
+    provider?: string;
+    testFile?: string;
+    tags?: string[];
+    fingerprint?: "default" | "custom";
+}
+interface Cassette {
+    schemaVersion: 1;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    turns: RecordedTurn[];
+    metadata?: CassetteMetadata;
+}
+type CassetteMode = "record" | "replay" | "auto";
+interface ProviderAdapter<Request, Response> {
+    readonly provider: string;
+    normalizeRequest(request: Request): SemanticRequest;
+    normalizeResponse(response: Response): SemanticResponse;
+    replayResponse(response: SemanticResponse): Response;
+}
+type ClientBoundary<Request, Response> = (request: Request) => Promise<Response>;
+type FingerprintFunction = (request: SemanticRequest) => string;
+interface CostContext {
+    request: SemanticRequest;
+    response: SemanticResponse;
+}
+type CostCalculator = (context: CostContext) => number | undefined;
+
+interface RedactionContext {
+    path: string;
+    key?: string;
+    value: JsonValue;
+}
+interface RedactionRule {
+    name: string;
+    match(context: RedactionContext): boolean;
+    replacement?: JsonValue;
+}
+interface RedactionOptions {
+    rules?: RedactionRule[];
+    includeDefaults?: boolean;
+}
+declare const defaultRedactionRules: RedactionRule[];
+declare function redact<T>(value: T, options?: RedactionOptions): T;
+
+interface CassetteStore {
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+}
+declare class FileCassetteStore implements CassetteStore {
+    readonly directory: string;
+    constructor(directory?: string);
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+    pathFor(name: string): string;
+}
+declare class MemoryCassetteStore implements CassetteStore {
+    readonly cassettes: Map<string, Cassette>;
+    exists(name: string): Promise<boolean>;
+    read(name: string): Promise<Cassette>;
+    write(cassette: Cassette): Promise<void>;
+    list(): Promise<string[]>;
+    remove(name: string): Promise<void>;
+}
+declare function parseCassette(source: string, expectedName?: string): Cassette;
+
+interface ReplayContext {
+    cassette: string;
+    turn: number;
+    response: SemanticResponse;
+}
+interface CassetteClientOptions<Request, Response> {
+    name: string;
+    adapter: ProviderAdapter<Request, Response>;
+    client?: ClientBoundary<Request, Response>;
+    mode?: CassetteMode;
+    store?: CassetteStore;
+    fingerprint?: FingerprintFunction;
+    redaction?: RedactionOptions;
+    replayTurns?: number;
+    metadata?: CassetteMetadata;
+    calculateCost?: CostCalculator;
+    onReplay?: (context: ReplayContext) => void | Promise<void>;
+}
+interface CassetteClient<Request, Response> {
+    (request: Request): Promise<Response>;
+    readonly cassetteName: string;
+    readonly mode: "record" | "replay";
+    readonly turn: number;
+}
+declare function createCassetteClient<Request, Response>(options: CassetteClientOptions<Request, Response>): Promise<CassetteClient<Request, Response>>;
+
+export { type CassetteClient as C, type FingerprintFunction as F, type JsonValue as J, MemoryCassetteStore as M, type ProviderAdapter as P, type ReplayContext as R, type SemanticRequest as S, type TokenUsage as T, type CassetteClientOptions as a, type SemanticResponse as b, type Cassette as c, type CassetteMetadata as d, type CassetteMode as e, type CassetteStore as f, type ClientBoundary as g, type ContentPart as h, type CostCalculator as i, type CostContext as j, FileCassetteStore as k, type JsonPrimitive as l, type MessageRole as m, type RecordedTurn as n, type RedactionContext as o, type RedactionOptions as p, type RedactionRule as q, type SemanticEvent as r, type SemanticMessage as s, type SemanticResponseItem as t, type ToolCall as u, type ToolDefinition as v, createCassetteClient as w, defaultRedactionRules as x, parseCassette as y, redact as z };