@particle-academy/prism 0.0.0

package/dist/files/pending-request.js

@@ -0,0 +1,96 @@
+import { PrismError } from '../errors.js';
+import { resolveProvider } from '../providers/registry.js';
+import { DeleteFileRequest, DownloadFileRequest, GetFileMetadataRequest, ListFilesRequest, UploadFileRequest, } from './request.js';
+/**
+ * The builder for provider-side file storage.
+ *
+ * FIVE terminals rather than one, because these are five different operations
+ * on a store, not five renderings of one request. `using()` is the only thing
+ * they share — there is no model, no prompt, and nothing to accumulate between
+ * calls, so the builder is thin by nature rather than by omission.
+ */
+export class FilesPendingRequest {
+    #provider = null;
+    #providerKey = '';
+    #providerOptions = {};
+    #clientOptions = {};
+    using(provider, providerConfig = {}) {
+        this.#providerKey = provider;
+        this.#provider = resolveProvider(provider, providerConfig);
+        return this;
+    }
+    withProviderOptions(options = {}) {
+        this.#providerOptions = { ...options };
+        return this;
+    }
+    withClientOptions(options) {
+        this.#clientOptions = { ...options };
+        return this;
+    }
+    provider() {
+        if (this.#provider === null) {
+            throw PrismError.unsupportedProviderAction('Sending a request', 'a pending request with no provider — call using() first');
+        }
+        return this.#provider;
+    }
+    async upload(content, filename, mimeType = null) {
+        return this.provider().uploadFile(this.toUploadRequest(content, filename, mimeType));
+    }
+    async list(limit = null, afterId = null, beforeId = null) {
+        return this.provider().listFiles(this.toListRequest(limit, afterId, beforeId));
+    }
+    async getMetadata(fileId) {
+        return this.provider().getFileMetadata(this.toGetMetadataRequest(fileId));
+    }
+    async delete(fileId) {
+        return this.provider().deleteFile(this.toDeleteRequest(fileId));
+    }
+    /**
+     * The file's bytes.
+     *
+     * The reference returns a PHP string, which is a byte array. `Uint8Array`
+     * here for the same reason `UploadFileRequest.content` takes one: decoding a
+     * PDF as UTF-16 to hand back a JavaScript string corrupts it, and the caller
+     * has no way to tell.
+     */
+    async download(fileId) {
+        return this.provider().downloadFile(this.toDownloadRequest(fileId));
+    }
+    toUploadRequest(content, filename, mimeType = null) {
+        return new UploadFileRequest({
+            providerKey: this.#providerKey,
+            filename,
+            content,
+            mimeType,
+            clientOptions: this.#clientOptions,
+            providerOptions: this.#providerOptions,
+        });
+    }
+    toListRequest(limit = null, afterId = null, beforeId = null) {
+        return new ListFilesRequest({
+            providerKey: this.#providerKey,
+            limit,
+            afterId,
+            beforeId,
+            clientOptions: this.#clientOptions,
+            providerOptions: this.#providerOptions,
+        });
+    }
+    toGetMetadataRequest(fileId) {
+        return new GetFileMetadataRequest({ ...this.#base(), fileId });
+    }
+    toDeleteRequest(fileId) {
+        return new DeleteFileRequest({ ...this.#base(), fileId });
+    }
+    toDownloadRequest(fileId) {
+        return new DownloadFileRequest({ ...this.#base(), fileId });
+    }
+    #base() {
+        return {
+            providerKey: this.#providerKey,
+            clientOptions: this.#clientOptions,
+            providerOptions: this.#providerOptions,
+        };
+    }
+}
+//# sourceMappingURL=pending-request.js.map

package/dist/files/pending-request.js.map

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

package/dist/files/request.d.ts

@@ -0,0 +1,77 @@
+import type { JsonObject, JsonValue } from '../json.js';
+interface BaseOptions {
+    providerKey: string;
+    clientOptions?: Readonly<Record<string, unknown>>;
+    providerOptions?: Readonly<JsonObject>;
+}
+/**
+ * What every file request carries.
+ *
+ * No `model`, unlike every other capability: a file is not generated by one and
+ * the endpoints take none. Carrying the field anyway would invite a caller to
+ * set it and expect it to matter.
+ */
+declare abstract class FileRequestBase {
+    #private;
+    constructor(options: BaseOptions);
+    providerKey(): string;
+    clientOptions(): Readonly<Record<string, unknown>>;
+    providerOptions(): JsonObject;
+    providerOptions(path: string): JsonValue | undefined;
+}
+export interface UploadFileRequestOptions extends BaseOptions {
+    filename: string;
+    content: Uint8Array;
+    mimeType?: string | null;
+}
+export declare class UploadFileRequest extends FileRequestBase {
+    readonly filename: string;
+    /**
+     * BYTES, where the reference takes a PHP string.
+     *
+     * A PHP string is a byte array; a JavaScript one is UTF-16 text, and passing
+     * a PDF through it corrupts the file silently. The types diverge because the
+     * languages do.
+     */
+    readonly content: Uint8Array;
+    readonly mimeType: string | null;
+    constructor(options: UploadFileRequestOptions);
+}
+export interface ListFilesRequestOptions extends BaseOptions {
+    limit?: number | null;
+    afterId?: string | null;
+    beforeId?: string | null;
+}
+export declare class ListFilesRequest extends FileRequestBase {
+    readonly limit: number | null;
+    readonly afterId: string | null;
+    /**
+     * Carried, and NOT sent to OpenAI, because OpenAI's files endpoint has no
+     * `before` parameter — only `after`. Kept on the request because the
+     * reference has it and a provider that paginates both ways can read it;
+     * dropping it silently in the mapper is where it belongs, not here.
+     */
+    readonly beforeId: string | null;
+    constructor(options: ListFilesRequestOptions);
+}
+export interface FileIdRequestOptions extends BaseOptions {
+    fileId: string;
+}
+/**
+ * The three requests that are nothing but an id.
+ *
+ * One class behind three names rather than three identical ones — they differ
+ * in which method takes them, not in what they hold.
+ */
+declare class FileIdRequest extends FileRequestBase {
+    readonly fileId: string;
+    constructor(options: FileIdRequestOptions);
+}
+export declare class GetFileMetadataRequest extends FileIdRequest {
+}
+export declare class DeleteFileRequest extends FileIdRequest {
+}
+export declare class DownloadFileRequest extends FileIdRequest {
+}
+export {};
+//# sourceMappingURL=request.d.ts.map

package/dist/files/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/files/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,UAAU,WAAW;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,uBAAe,eAAe;;gBAOhB,OAAO,EAAE,WAAW;IAMhC,WAAW,IAAI,MAAM;IAIrB,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,eAAe,IAAI,UAAU;IAC7B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAIrD;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErB,OAAO,EAAE,wBAAwB;CAM9C;AAED,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErB,OAAO,EAAE,uBAAuB;CAM7C;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,cAAM,aAAc,SAAQ,eAAe;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,oBAAoB;CAI1C;AAED,qBAAa,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,qBAAa,iBAAkB,SAAQ,aAAa;CAAG;AAEvD,qBAAa,mBAAoB,SAAQ,aAAa;CAAG"}

package/dist/files/request.js

@@ -0,0 +1,81 @@
+/**
+ * What every file request carries.
+ *
+ * No `model`, unlike every other capability: a file is not generated by one and
+ * the endpoints take none. Carrying the field anyway would invite a caller to
+ * set it and expect it to matter.
+ */
+class FileRequestBase {
+    #providerKey;
+    #clientOptions;
+    #providerOptions;
+    constructor(options) {
+        this.#providerKey = options.providerKey;
+        this.#clientOptions = options.clientOptions ?? {};
+        this.#providerOptions = { ...(options.providerOptions ?? {}) };
+    }
+    providerKey() {
+        return this.#providerKey;
+    }
+    clientOptions() {
+        return this.#clientOptions;
+    }
+    providerOptions(path) {
+        return path === undefined ? this.#providerOptions : this.#providerOptions[path];
+    }
+}
+export class UploadFileRequest extends FileRequestBase {
+    filename;
+    /**
+     * BYTES, where the reference takes a PHP string.
+     *
+     * A PHP string is a byte array; a JavaScript one is UTF-16 text, and passing
+     * a PDF through it corrupts the file silently. The types diverge because the
+     * languages do.
+     */
+    content;
+    mimeType;
+    constructor(options) {
+        super(options);
+        this.filename = options.filename;
+        this.content = options.content;
+        this.mimeType = options.mimeType ?? null;
+    }
+}
+export class ListFilesRequest extends FileRequestBase {
+    limit;
+    afterId;
+    /**
+     * Carried, and NOT sent to OpenAI, because OpenAI's files endpoint has no
+     * `before` parameter — only `after`. Kept on the request because the
+     * reference has it and a provider that paginates both ways can read it;
+     * dropping it silently in the mapper is where it belongs, not here.
+     */
+    beforeId;
+    constructor(options) {
+        super(options);
+        this.limit = options.limit ?? null;
+        this.afterId = options.afterId ?? null;
+        this.beforeId = options.beforeId ?? null;
+    }
+}
+/**
+ * The three requests that are nothing but an id.
+ *
+ * One class behind three names rather than three identical ones — they differ
+ * in which method takes them, not in what they hold.
+ */
+class FileIdRequest extends FileRequestBase {
+    fileId;
+    constructor(options) {
+        super(options);
+        this.fileId = options.fileId;
+    }
+}
+export class GetFileMetadataRequest extends FileIdRequest {
+}
+export class DeleteFileRequest extends FileIdRequest {
+}
+export class DownloadFileRequest extends FileIdRequest {
+}
+//# sourceMappingURL=request.js.map

package/dist/files/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/files/request.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAe,eAAe;IACnB,YAAY,CAAS;IAErB,cAAc,CAAoC;IAElD,gBAAgB,CAAa;IAEtC,YAAY,OAAoB;QAC9B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,gBAAgB,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAID,eAAe,CAAC,IAAa;QAC3B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC;CACF;AAQD,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IAC3C,QAAQ,CAAS;IAE1B;;;;;;OAMG;IACM,OAAO,CAAa;IAEpB,QAAQ,CAAgB;IAEjC,YAAY,OAAiC;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC3C,CAAC;CACF;AAQD,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAC1C,KAAK,CAAgB;IAErB,OAAO,CAAgB;IAEhC;;;;;OAKG;IACM,QAAQ,CAAgB;IAEjC,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC3C,CAAC;CACF;AAMD;;;;;GAKG;AACH,MAAM,aAAc,SAAQ,eAAe;IAChC,MAAM,CAAS;IAExB,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,MAAM,OAAO,iBAAkB,SAAQ,aAAa;CAAG;AAEvD,MAAM,OAAO,mBAAoB,SAAQ,aAAa;CAAG"}

package/dist/fim/pending-request.d.ts

@@ -0,0 +1,31 @@
+import type { JsonObject } from '../json.js';
+import type { Provider } from '../providers/provider.js';
+import { FimRequest } from './request.js';
+import type { FimResponse } from './response.js';
+/**
+ * The builder for fill-in-the-middle.
+ *
+ * Deliberately NOT a subclass of the text builder, for the same reason
+ * `embeddings` is not: a FIM request has no messages, no tools and no step
+ * budget, and inheriting those would advertise controls that do nothing. What
+ * it does have that no other builder does is a SUFFIX.
+ */
+export declare class FimPendingRequest {
+    #private;
+    using(provider: string, model?: string, providerConfig?: Record<string, unknown>): this;
+    /** The text BEFORE the gap. REPLACES; a FIM call has one prompt. */
+    withPrompt(prompt: string): this;
+    /** The text AFTER the gap. Omit it and the model completes to the end. */
+    withSuffix(suffix: string | null): this;
+    withMaxTokens(maxTokens: number): this;
+    withTemperature(temperature: number): this;
+    withTopP(topP: number): this;
+    /** A single stop string or several. A string is wrapped, matching the reference. */
+    withStop(stop: string | readonly string[]): this;
+    withProviderOptions(options?: Readonly<JsonObject>): this;
+    withClientOptions(options: Record<string, unknown>): this;
+    provider(): Provider;
+    asText(): Promise<FimResponse>;
+    toRequest(): FimRequest;
+}
+//# sourceMappingURL=pending-request.d.ts.map

package/dist/fim/pending-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-request.d.ts","sourceRoot":"","sources":["../../src/fim/pending-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;GAOG;AACH,qBAAa,iBAAiB;;IAuB5B,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAQvF,oEAAoE;IACpE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMhC,0EAA0E;IAC1E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMvC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMtC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAMhD,mBAAmB,CAAC,OAAO,GAAE,QAAQ,CAAC,UAAU,CAAM,GAAG,IAAI;IAM7D,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMzD,QAAQ,IAAI,QAAQ;IAWd,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAIpC,SAAS,IAAI,UAAU;CAcxB"}

package/dist/fim/pending-request.js

@@ -0,0 +1,89 @@
+import { PrismError } from '../errors.js';
+import { resolveProvider } from '../providers/registry.js';
+import { FimRequest } from './request.js';
+/**
+ * The builder for fill-in-the-middle.
+ *
+ * Deliberately NOT a subclass of the text builder, for the same reason
+ * `embeddings` is not: a FIM request has no messages, no tools and no step
+ * budget, and inheriting those would advertise controls that do nothing. What
+ * it does have that no other builder does is a SUFFIX.
+ */
+export class FimPendingRequest {
+    #provider = null;
+    #providerKey = '';
+    #model = '';
+    #prompt = '';
+    #suffix = null;
+    #maxTokens = null;
+    #temperature = null;
+    #topP = null;
+    #stop = [];
+    #providerOptions = {};
+    #clientOptions = {};
+    using(provider, model = '', providerConfig = {}) {
+        this.#providerKey = provider;
+        this.#model = model;
+        this.#provider = resolveProvider(provider, providerConfig);
+        return this;
+    }
+    /** The text BEFORE the gap. REPLACES; a FIM call has one prompt. */
+    withPrompt(prompt) {
+        this.#prompt = prompt;
+        return this;
+    }
+    /** The text AFTER the gap. Omit it and the model completes to the end. */
+    withSuffix(suffix) {
+        this.#suffix = suffix;
+        return this;
+    }
+    withMaxTokens(maxTokens) {
+        this.#maxTokens = maxTokens;
+        return this;
+    }
+    withTemperature(temperature) {
+        this.#temperature = temperature;
+        return this;
+    }
+    withTopP(topP) {
+        this.#topP = topP;
+        return this;
+    }
+    /** A single stop string or several. A string is wrapped, matching the reference. */
+    withStop(stop) {
+        this.#stop = typeof stop === 'string' ? [stop] : [...stop];
+        return this;
+    }
+    withProviderOptions(options = {}) {
+        this.#providerOptions = { ...options };
+        return this;
+    }
+    withClientOptions(options) {
+        this.#clientOptions = { ...options };
+        return this;
+    }
+    provider() {
+        if (this.#provider === null) {
+            throw PrismError.unsupportedProviderAction('Sending a request', 'a pending request with no provider — call using() first');
+        }
+        return this.#provider;
+    }
+    async asText() {
+        return this.provider().fim(this.toRequest());
+    }
+    toRequest() {
+        return new FimRequest({
+            model: this.#model,
+            providerKey: this.#providerKey,
+            prompt: this.#prompt,
+            suffix: this.#suffix,
+            maxTokens: this.#maxTokens,
+            temperature: this.#temperature,
+            topP: this.#topP,
+            stop: this.#stop,
+            clientOptions: this.#clientOptions,
+            providerOptions: this.#providerOptions,
+        });
+    }
+}
+//# sourceMappingURL=pending-request.js.map

package/dist/fim/pending-request.js.map

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

package/dist/fim/request.d.ts

@@ -0,0 +1,39 @@
+import type { JsonObject, JsonValue } from '../json.js';
+export interface FimRequestOptions {
+    model: string;
+    providerKey: string;
+    prompt: string;
+    suffix?: string | null;
+    maxTokens?: number | null;
+    temperature?: number | null;
+    topP?: number | null;
+    stop?: readonly string[];
+    clientOptions?: Readonly<Record<string, unknown>>;
+    providerOptions?: Readonly<JsonObject>;
+}
+/**
+ * A fill-in-the-middle request: a prefix, an optional suffix, and a gap.
+ *
+ * No messages and no tools, unlike every other generation request. FIM is a
+ * COMPLETION, not a conversation — the model is given code either side of a
+ * hole and writes what goes in it, which is why an editor is the natural caller
+ * and a chat transcript is not.
+ */
+export declare class FimRequest {
+    #private;
+    constructor(options: FimRequestOptions);
+    model(): string;
+    providerKey(): string;
+    /** The text BEFORE the gap. */
+    prompt(): string;
+    /** The text AFTER the gap, or null when the model should complete to the end. */
+    suffix(): string | null;
+    maxTokens(): number | null;
+    temperature(): number | null;
+    topP(): number | null;
+    stop(): readonly string[];
+    clientOptions(): Readonly<Record<string, unknown>>;
+    providerOptions(): JsonObject;
+    providerOptions(path: string): JsonValue | undefined;
+}
+//# sourceMappingURL=request.d.ts.map

package/dist/fim/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/fim/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;;gBAqBT,OAAO,EAAE,iBAAiB;IAatC,KAAK,IAAI,MAAM;IAIf,WAAW,IAAI,MAAM;IAIrB,+BAA+B;IAC/B,MAAM,IAAI,MAAM;IAIhB,iFAAiF;IACjF,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,IAAI,IAAI,MAAM,GAAG,IAAI;IAIrB,IAAI,IAAI,SAAS,MAAM,EAAE;IAIzB,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,eAAe,IAAI,UAAU;IAC7B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAIrD"}

package/dist/fim/request.js

@@ -0,0 +1,65 @@
+/**
+ * A fill-in-the-middle request: a prefix, an optional suffix, and a gap.
+ *
+ * No messages and no tools, unlike every other generation request. FIM is a
+ * COMPLETION, not a conversation — the model is given code either side of a
+ * hole and writes what goes in it, which is why an editor is the natural caller
+ * and a chat transcript is not.
+ */
+export class FimRequest {
+    #model;
+    #providerKey;
+    #prompt;
+    #suffix;
+    #maxTokens;
+    #temperature;
+    #topP;
+    #stop;
+    #clientOptions;
+    #providerOptions;
+    constructor(options) {
+        this.#model = options.model;
+        this.#providerKey = options.providerKey;
+        this.#prompt = options.prompt;
+        this.#suffix = options.suffix ?? null;
+        this.#maxTokens = options.maxTokens ?? null;
+        this.#temperature = options.temperature ?? null;
+        this.#topP = options.topP ?? null;
+        this.#stop = options.stop ?? [];
+        this.#clientOptions = options.clientOptions ?? {};
+        this.#providerOptions = { ...(options.providerOptions ?? {}) };
+    }
+    model() {
+        return this.#model;
+    }
+    providerKey() {
+        return this.#providerKey;
+    }
+    /** The text BEFORE the gap. */
+    prompt() {
+        return this.#prompt;
+    }
+    /** The text AFTER the gap, or null when the model should complete to the end. */
+    suffix() {
+        return this.#suffix;
+    }
+    maxTokens() {
+        return this.#maxTokens;
+    }
+    temperature() {
+        return this.#temperature;
+    }
+    topP() {
+        return this.#topP;
+    }
+    stop() {
+        return this.#stop;
+    }
+    clientOptions() {
+        return this.#clientOptions;
+    }
+    providerOptions(path) {
+        return path === undefined ? this.#providerOptions : this.#providerOptions[path];
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/fim/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/fim/request.ts"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACZ,MAAM,CAAS;IAEf,YAAY,CAAS;IAErB,OAAO,CAAS;IAEhB,OAAO,CAAgB;IAEvB,UAAU,CAAgB;IAE1B,YAAY,CAAgB;IAE5B,KAAK,CAAgB;IAErB,KAAK,CAAoB;IAEzB,cAAc,CAAoC;IAElD,gBAAgB,CAAa;IAEtC,YAAY,OAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,gBAAgB,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,+BAA+B;IAC/B,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,iFAAiF;IACjF,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAID,eAAe,CAAC,IAAa;QAC3B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/fim/response.d.ts

@@ -0,0 +1,21 @@
+import type { JsonObject } from '../json.js';
+import type { FinishReason } from '../enums.js';
+import type { Meta } from '../value-objects/meta.js';
+import type { Usage } from '../value-objects/usage.js';
+/**
+ * What the model wrote into the gap.
+ *
+ * Flat, with no `steps` and no `messages`, unlike `TextResponse`. A FIM call is
+ * one round trip that cannot call a tool, so there is nothing to accumulate and
+ * modelling it with a step list would advertise a loop that does not exist.
+ */
+export declare class FimResponse {
+    readonly text: string;
+    readonly finishReason: FinishReason;
+    readonly usage: Usage;
+    readonly meta: Meta;
+    readonly raw: JsonObject | null;
+    constructor(text: string, finishReason: FinishReason, usage: Usage, meta: Meta, raw?: JsonObject | null);
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/fim/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/fim/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,WAAW;IAEpB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI;IACnB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;gBAJtB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,GAAG,GAAE,UAAU,GAAG,IAAW;IAGxC,QAAQ,IAAI,UAAU;CAQvB"}

package/dist/fim/response.js

@@ -0,0 +1,30 @@
+/**
+ * What the model wrote into the gap.
+ *
+ * Flat, with no `steps` and no `messages`, unlike `TextResponse`. A FIM call is
+ * one round trip that cannot call a tool, so there is nothing to accumulate and
+ * modelling it with a step list would advertise a loop that does not exist.
+ */
+export class FimResponse {
+    text;
+    finishReason;
+    usage;
+    meta;
+    raw;
+    constructor(text, finishReason, usage, meta, raw = null) {
+        this.text = text;
+        this.finishReason = finishReason;
+        this.usage = usage;
+        this.meta = meta;
+        this.raw = raw;
+    }
+    toObject() {
+        return {
+            text: this.text,
+            finish_reason: this.finishReason,
+            usage: this.usage.toObject(),
+            meta: this.meta.toObject(),
+        };
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/fim/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/fim/response.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IAEX;IACA;IACA;IACA;IACA;IALX,YACW,IAAY,EACZ,YAA0B,EAC1B,KAAY,EACZ,IAAU,EACV,MAAyB,IAAI;QAJ7B,SAAI,GAAJ,IAAI,CAAQ;QACZ,iBAAY,GAAZ,YAAY,CAAc;QAC1B,UAAK,GAAL,KAAK,CAAO;QACZ,SAAI,GAAJ,IAAI,CAAM;QACV,QAAG,GAAH,GAAG,CAA0B;IACrC,CAAC;IAEJ,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/http/header-names.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Comparing an HTTP field name the way HTTP defines it: without regard to case.
+ *
+ * Field names are case-insensitive (RFC 9110 §5.1), and a gateway that
+ * title-cases them is ordinary rather than hostile. Every rate-limit reader
+ * here looks its headers up as exact object keys, so a single such proxy in
+ * front of the provider made `parseRateLimits` return an EMPTY ARRAY — which is
+ * also exactly what a response that legitimately carried no quota headers looks
+ * like. The failure was therefore invisible when it happened and permanent
+ * afterwards.
+ *
+ * **The fold is deliberately ASCII-only, and that is the whole subtlety here.**
+ * `String.prototype.toLowerCase()` is Unicode-aware: `K` (U+212A KELVIN SIGN)
+ * folds to a plain `k`, so `anthropic-ratelimit-to<U+212A>ens-limit` would come
+ * back as a bucket named `tokens` — the name a caller matches on to decide
+ * whether it has token quota left, manufactured from a header the provider
+ * never sent. `İ` (U+0130) folds to TWO codepoints, changing the string's
+ * length under the offset arithmetic that splits a bucket from a field.
+ *
+ * An HTTP field name is a `token` — ASCII by grammar — so a codepoint range
+ * over the 26 ASCII letters is both the correct fold and the only one the
+ * sibling ports (`prism`, `prism-py`) can reproduce byte for byte.
+ */
+/** One field name, folded to lower case as ASCII and nothing else. */
+export declare function foldHeaderName(name: string): string;
+/**
+ * A header map re-keyed by folded name, values untouched.
+ *
+ * Insertion order survives, because a reader that names its buckets in header
+ * order would otherwise hand a caller reading `rateLimits[0]` a different
+ * bucket — a divergence nothing errors on. Later duplicates win, which is the
+ * answer a case-insensitive lookup would give for a name a server spelled two
+ * ways in one response.
+ */
+export declare function foldHeaderNames(headers: Readonly<Record<string, string>>): Record<string, string>;
+//# sourceMappingURL=header-names.d.ts.map

package/dist/http/header-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-names.d.ts","sourceRoot":"","sources":["../../src/http/header-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}