@compose-market/sdk 0.8.2 → 0.8.3

package/dist/resources/local.js.map

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

package/dist/resources/memory.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Compose memory — first-party 6-layer memory framework.
+ *
+ *   working  → Mongo `sessions`        rolling per-thread context
+ *   scene    → Mongo `session_transcripts`  full transcripts
+ *   graph    → Mongo `memory` (source:"fact")  durable user facts
+ *   patterns → Mongo `patterns`        mined tool sequences
+ *   archives → Mongo `archives` + Pinata  cold storage
+ *   vectors  → Mongo `memory` (source:"session"|"knowledge")  hybrid recall
+ *
+ * One unified ranker (Cloudflare BAAI bge-reranker-base + temporal decay +
+ * MMR) shortlists items across all layers into a budget-bounded prompt block.
+ *
+ * The 80%-case surface for agent loops is three calls:
+ *   - `sdk.memory.context({ query, agentWallet, userAddress })` → pre-turn block
+ *   - `sdk.memory.recordTurn({ messages, agentWallet, userAddress, threadId })` → post-turn persist
+ *   - `sdk.memory.remember({ content, agentWallet, userAddress })` → durable fact
+ *
+ * Or even simpler ergonomic shortcuts:
+ *   - `sdk.memory.recall("what's my favourite color?", { agentWallet, userAddress })`
+ *   - `sdk.memory.save("my favourite color is azure", { agentWallet, userAddress })`
+ *
+ * The runtime owns ranking, budget enforcement, layer selection, and fact
+ * extraction. The SDK is a thin transport.
+ */
+import type { APIPromise, HttpClient } from "@compose-market/core/http";
+import type { AgentMemoryContextParams, AgentMemoryContextResponse, AgentMemoryLoopParams, AgentMemoryLoopResponse, AgentMemoryRecordTurnParams, AgentMemoryRecordTurnResponse, AgentMemoryRememberParams, AgentMemoryRememberResponse, LearnedSkill, LayeredSearchParams, LayeredSearchResult, MemoryEvalRunParams, MemoryEvalRunResponse, MemoryItemDeleteParams, MemoryItemQuery, MemoryItemUpdateParams, MemoryJobCreateParams, MemoryJobRecord, MemoryPatternValidation, MemoryScheduleStatus, MemoryVector, MemoryLoopManifest, ProceduralPattern, SessionMemory } from "../types/index.js";
+export interface MemoryResourceContext {
+    getWalletMaybe: () => {
+        address: string | null;
+        chainId: number | null;
+    };
+    getTokenMaybe: () => string | null;
+}
+export interface MemoryRequestOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    idempotencyKey?: string;
+}
+/**
+ * Shorthand options for the ergonomic helpers `recall` and `save`.
+ * Scope (`agentWallet` + `userAddress`) is required; everything else is
+ * either auto-defaulted by the runtime or an opt-in tuning knob.
+ */
+export interface MemoryShorthandOptions {
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    /** Recall: max items in the returned prompt block. Default 6. */
+    limit?: number;
+    /** Recall: max characters in the returned prompt block. Default 900. */
+    budgetCharacters?: number;
+    /** Remember: confidence override (default 1 for explicit saves). */
+    confidence?: number;
+    /** Remember: durable-fact category. Default "context". */
+    type?: "preference" | "identity" | "context" | "skill" | "relationship" | "event";
+    request?: MemoryRequestOptions;
+}
+export declare class MemoryResource {
+    private readonly client;
+    private readonly ctx;
+    constructor(client: HttpClient, ctx: MemoryResourceContext);
+    /**
+     * Pre-turn context retrieval. Returns a budget-bounded prompt block
+     * shortlisting top items across all 6 layers.
+     */
+    context(params: AgentMemoryContextParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryContextResponse>;
+    /**
+     * Post-turn persistence. Persists transcript + working memory + per-turn
+     * vector + extracts durable facts (graph layer). Idempotent on `turnId`.
+     */
+    recordTurn(params: AgentMemoryRecordTurnParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryRecordTurnResponse>;
+    /**
+     * Save an explicit durable fact. Indexed as a `source:"fact"` vector with
+     * `metadata.layer:"graph"` so the cross-layer ranker surfaces it.
+     */
+    remember(params: AgentMemoryRememberParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryRememberResponse>;
+    /**
+     * Unified loop dispatcher — same as calling `context`/`recordTurn`/`remember`
+     * directly but lets you pass a discriminated union, useful when the
+     * caller's step is dynamic.
+     */
+    loop(params: AgentMemoryLoopParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryLoopResponse>;
+    /**
+     * Pre-turn recall in one call. Returns the rendered prompt block
+     * directly (or `null` if no relevant memories).
+     *
+     *   const block = await sdk.memory.recall(
+     *     "what's my favourite color?",
+     *     { agentWallet, userAddress },
+     *   );
+     */
+    recall(query: string, options: MemoryShorthandOptions): Promise<{
+        prompt: string | null;
+        items: AgentMemoryContextResponse["items"];
+        totals: Record<string, number>;
+        contextUsage: AgentMemoryContextResponse["contextUsage"];
+    }>;
+    /**
+     * Save a durable fact in one call. Returns whether it landed.
+     *
+     *   await sdk.memory.save(
+     *     "my favourite color is azure",
+     *     { agentWallet, userAddress, type: "preference" },
+     *   );
+     */
+    save(content: string, options: MemoryShorthandOptions): Promise<{
+        saved: boolean;
+        id?: string;
+    }>;
+    search(params: LayeredSearchParams, options?: MemoryRequestOptions): APIPromise<LayeredSearchResult>;
+    getItem(id: string, params?: MemoryItemQuery, options?: MemoryRequestOptions): APIPromise<{
+        item: MemoryVector;
+    }>;
+    updateItem(id: string, params: MemoryItemUpdateParams, options?: MemoryRequestOptions): APIPromise<{
+        updated: boolean;
+        item: MemoryVector;
+    }>;
+    deleteItem(id: string, params?: MemoryItemDeleteParams, options?: MemoryRequestOptions): APIPromise<{
+        deleted: boolean;
+        hardDeleted: boolean;
+    }>;
+    resolveConflict(id: string, params: {
+        agentWallet?: string;
+        resolution: "supersede" | "keep" | "merge" | "ignore";
+        winningMemoryId?: string;
+        reason?: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        resolved: boolean;
+        memoryId: string;
+    }>;
+    createJob(params: MemoryJobCreateParams, options?: MemoryRequestOptions): APIPromise<MemoryJobRecord>;
+    getJob(jobId: string, options?: MemoryRequestOptions): APIPromise<MemoryJobRecord>;
+    runEval(params: MemoryEvalRunParams, options?: MemoryRequestOptions): APIPromise<MemoryEvalRunResponse>;
+    listLoops(options?: MemoryRequestOptions): APIPromise<{
+        loops: MemoryLoopManifest[];
+    }>;
+    getLoop(loopId: string, options?: MemoryRequestOptions): APIPromise<{
+        loop: MemoryLoopManifest;
+    }>;
+    listPatterns(params?: {
+        agentWallet?: string;
+        patternType?: ProceduralPattern["patternType"];
+        minSuccessRate?: number;
+        limit?: number;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        patterns: ProceduralPattern[];
+    }>;
+    getPattern(patternId: string, params?: {
+        agentWallet?: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        pattern: ProceduralPattern;
+    }>;
+    validatePattern(patternId: string, options?: MemoryRequestOptions): APIPromise<MemoryPatternValidation>;
+    promotePattern(patternId: string, params: {
+        skillName: string;
+        validationData: MemoryPatternValidation;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        skillId: string;
+        promoted: boolean;
+    }>;
+    listSkills(params?: {
+        agentWallet?: string;
+        category?: string;
+        limit?: number;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        skills: LearnedSkill[];
+    }>;
+    getSkill(skillId: string, params?: {
+        agentWallet?: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        skill: LearnedSkill;
+    }>;
+    indexTranscript(params: {
+        sessionId: string;
+        threadId: string;
+        agentWallet: string;
+        userAddress?: string;
+        mode?: "global" | "local";
+        haiId?: string;
+        messages: AgentMemoryRecordTurnParams["messages"];
+        modelUsed?: string;
+        model?: string;
+        totalTokens?: number;
+        tokenCount?: number;
+        rememberWorkingMemory?: boolean;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        indexed: boolean;
+        messageCount: number;
+        vectorCount: number;
+    }>;
+    getWorkingSession(sessionId: string, params: {
+        agentWallet: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        session: SessionMemory;
+    }>;
+    updateWorkingSession(sessionId: string, params: {
+        agentWallet: string;
+        userAddress?: string;
+        threadId?: string;
+        mode?: "global" | "local";
+        haiId?: string;
+        context?: string[];
+        entities?: Record<string, unknown>;
+        state?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+        replace?: boolean;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        success: boolean;
+        session: SessionMemory;
+    }>;
+    compressSession(sessionId: string, params: {
+        agentWallet: string;
+        coordinatorModel: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        summary: string;
+        entitiesExtracted: number;
+    }>;
+    syncArchive(archiveId: string, params: {
+        agentWallet: string;
+    }, options?: MemoryRequestOptions): APIPromise<{
+        ipfsHash: string;
+        pinned: boolean;
+    }>;
+    listSchedules(options?: MemoryRequestOptions): APIPromise<{
+        schedules: MemoryScheduleStatus[];
+    }>;
+    createSchedules(params: {
+        agentWallets: string[];
+    }, options?: MemoryRequestOptions): APIPromise<{
+        created: boolean;
+    }>;
+    deleteSchedules(options?: MemoryRequestOptions): APIPromise<{
+        deleted: boolean;
+    }>;
+    pauseSchedule(scheduleId: string, options?: MemoryRequestOptions): APIPromise<{
+        paused: boolean;
+    }>;
+    resumeSchedule(scheduleId: string, options?: MemoryRequestOptions): APIPromise<{
+        resumed: boolean;
+    }>;
+    triggerSchedule(scheduleId: string, options?: MemoryRequestOptions): APIPromise<{
+        triggered: boolean;
+    }>;
+    private request;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/resources/memory.d.ts.map

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

package/dist/resources/memory.js

@@ -0,0 +1,217 @@
+export class MemoryResource {
+    client;
+    ctx;
+    constructor(client, ctx) {
+        this.client = client;
+        this.ctx = ctx;
+    }
+    /**
+     * Pre-turn context retrieval. Returns a budget-bounded prompt block
+     * shortlisting top items across all 6 layers.
+     */
+    context(params, options = {}) {
+        return this.request("POST", "/api/memory/context/assemble", params, options);
+    }
+    /**
+     * Post-turn persistence. Persists transcript + working memory + per-turn
+     * vector + extracts durable facts (graph layer). Idempotent on `turnId`.
+     */
+    recordTurn(params, options = {}) {
+        return this.request("POST", "/api/memory/turns/record", params, options, undefined, true);
+    }
+    /**
+     * Save an explicit durable fact. Indexed as a `source:"fact"` vector with
+     * `metadata.layer:"graph"` so the cross-layer ranker surfaces it.
+     */
+    remember(params, options = {}) {
+        return this.request("POST", "/api/memory/remember", params, options, undefined, true);
+    }
+    /**
+     * Unified loop dispatcher — same as calling `context`/`recordTurn`/`remember`
+     * directly but lets you pass a discriminated union, useful when the
+     * caller's step is dynamic.
+     */
+    loop(params, options = {}) {
+        return this.request("POST", "/api/memory/loop", params, options, undefined, params.step !== "pre_turn");
+    }
+    // ------------------------------------------------------------------
+    // Ergonomic shortcuts — string-first, no envelopes, the 80% case
+    // ------------------------------------------------------------------
+    /**
+     * Pre-turn recall in one call. Returns the rendered prompt block
+     * directly (or `null` if no relevant memories).
+     *
+     *   const block = await sdk.memory.recall(
+     *     "what's my favourite color?",
+     *     { agentWallet, userAddress },
+     *   );
+     */
+    async recall(query, options) {
+        const response = await this.context({
+            query,
+            agentWallet: options.agentWallet,
+            userAddress: options.userAddress,
+            threadId: options.threadId,
+            mode: options.mode,
+            haiId: options.haiId,
+            limit: options.limit,
+            ...(options.budgetCharacters ? { budget: { maxCharacters: options.budgetCharacters } } : {}),
+        }, options.request ?? {});
+        return {
+            prompt: response.prompt,
+            items: response.items,
+            totals: response.totals,
+            contextUsage: response.contextUsage,
+        };
+    }
+    /**
+     * Save a durable fact in one call. Returns whether it landed.
+     *
+     *   await sdk.memory.save(
+     *     "my favourite color is azure",
+     *     { agentWallet, userAddress, type: "preference" },
+     *   );
+     */
+    async save(content, options) {
+        const response = await this.remember({
+            content,
+            agentWallet: options.agentWallet,
+            userAddress: options.userAddress,
+            threadId: options.threadId,
+            mode: options.mode,
+            haiId: options.haiId,
+            ...(options.type ? { type: options.type } : {}),
+            ...(typeof options.confidence === "number" ? { confidence: options.confidence } : {}),
+        }, options.request ?? {});
+        return {
+            saved: Boolean(response.success),
+            id: response.vectorId ?? response.memory?.id,
+        };
+    }
+    // ------------------------------------------------------------------
+    // Power-user surface (full layered search, item CRUD, jobs, schedules)
+    // ------------------------------------------------------------------
+    search(params, options = {}) {
+        return this.request("POST", "/api/memory/items/search", params, options);
+    }
+    getItem(id, params = {}, options = {}) {
+        return this.request("GET", `/api/memory/items/${encodeURIComponent(id)}`, undefined, options, {
+            agentWallet: params.agentWallet,
+            userAddress: params.userAddress,
+        });
+    }
+    updateItem(id, params, options = {}) {
+        return this.request("PATCH", `/api/memory/items/${encodeURIComponent(id)}`, params, options, undefined, true);
+    }
+    deleteItem(id, params = {}, options = {}) {
+        return this.request("DELETE", `/api/memory/items/${encodeURIComponent(id)}`, undefined, options, {
+            agentWallet: params.agentWallet,
+            userAddress: params.userAddress,
+            hardDelete: params.hardDelete,
+        }, true);
+    }
+    resolveConflict(id, params, options = {}) {
+        return this.request("POST", `/api/memory/conflicts/${encodeURIComponent(id)}/resolve`, params, options, undefined, true);
+    }
+    createJob(params, options = {}) {
+        return this.request("POST", "/api/memory/jobs", params, options, undefined, true);
+    }
+    getJob(jobId, options = {}) {
+        return this.request("GET", `/api/memory/jobs/${encodeURIComponent(jobId)}`, undefined, options);
+    }
+    runEval(params, options = {}) {
+        return this.request("POST", "/api/memory/evals/runs", params, options);
+    }
+    listLoops(options = {}) {
+        return this.request("GET", "/api/memory/loops", undefined, options);
+    }
+    getLoop(loopId, options = {}) {
+        return this.request("GET", `/api/memory/loops/${encodeURIComponent(loopId)}`, undefined, options);
+    }
+    listPatterns(params = {}, options = {}) {
+        return this.request("GET", "/api/memory/patterns", undefined, options, {
+            agentWallet: params.agentWallet,
+            patternType: params.patternType,
+            minSuccessRate: params.minSuccessRate,
+            limit: params.limit,
+        });
+    }
+    getPattern(patternId, params = {}, options = {}) {
+        return this.request("GET", `/api/memory/patterns/${encodeURIComponent(patternId)}`, undefined, options, {
+            agentWallet: params.agentWallet,
+        });
+    }
+    validatePattern(patternId, options = {}) {
+        return this.request("POST", `/api/memory/patterns/${encodeURIComponent(patternId)}/validate`, {}, options);
+    }
+    promotePattern(patternId, params, options = {}) {
+        return this.request("POST", `/api/memory/patterns/${encodeURIComponent(patternId)}/promote`, params, options, undefined, true);
+    }
+    listSkills(params = {}, options = {}) {
+        return this.request("GET", "/api/memory/skills", undefined, options, {
+            agentWallet: params.agentWallet,
+            category: params.category,
+            limit: params.limit,
+        });
+    }
+    getSkill(skillId, params = {}, options = {}) {
+        return this.request("GET", `/api/memory/skills/${encodeURIComponent(skillId)}`, undefined, options, {
+            agentWallet: params.agentWallet,
+        });
+    }
+    indexTranscript(params, options = {}) {
+        return this.request("POST", "/api/memory/transcripts/index", params, options, undefined, true);
+    }
+    getWorkingSession(sessionId, params, options = {}) {
+        return this.request("GET", `/api/memory/sessions/${encodeURIComponent(sessionId)}/working`, undefined, options, {
+            agentWallet: params.agentWallet,
+        });
+    }
+    updateWorkingSession(sessionId, params, options = {}) {
+        return this.request("PATCH", `/api/memory/sessions/${encodeURIComponent(sessionId)}/working`, params, options, undefined, true);
+    }
+    compressSession(sessionId, params, options = {}) {
+        return this.request("POST", `/api/memory/sessions/${encodeURIComponent(sessionId)}/compress`, params, options, undefined, true);
+    }
+    syncArchive(archiveId, params, options = {}) {
+        return this.request("POST", `/api/memory/archives/${encodeURIComponent(archiveId)}/sync`, params, options, undefined, true);
+    }
+    listSchedules(options = {}) {
+        return this.request("GET", "/api/memory/schedules", undefined, options);
+    }
+    createSchedules(params, options = {}) {
+        return this.request("POST", "/api/memory/schedules", params, options, undefined, true);
+    }
+    deleteSchedules(options = {}) {
+        return this.request("DELETE", "/api/memory/schedules", undefined, options, undefined, true);
+    }
+    pauseSchedule(scheduleId, options = {}) {
+        return this.request("POST", `/api/memory/schedules/${encodeURIComponent(scheduleId)}/pause`, {}, options, undefined, true);
+    }
+    resumeSchedule(scheduleId, options = {}) {
+        return this.request("POST", `/api/memory/schedules/${encodeURIComponent(scheduleId)}/resume`, {}, options, undefined, true);
+    }
+    triggerSchedule(scheduleId, options = {}) {
+        return this.request("POST", `/api/memory/schedules/${encodeURIComponent(scheduleId)}/trigger`, {}, options, undefined, true);
+    }
+    request(method, path, body, options, query, doNotRetry = false) {
+        const wallet = this.ctx.getWalletMaybe();
+        const token = this.ctx.getTokenMaybe();
+        return this.client.request({
+            method,
+            path,
+            query,
+            body,
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+            headers: {
+                key: token ?? undefined,
+                userAddress: wallet.address ?? undefined,
+                chainId: wallet.chainId ?? undefined,
+                idempotencyKey: options.idempotencyKey,
+            },
+            doNotRetry,
+        });
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/resources/memory.js.map

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

package/dist/resources/models.d.ts

@@ -0,0 +1,45 @@
+import type { APIPromise, HttpClient } from "@compose-market/core/http";
+import type { CanonicalModality, ModalityCatalogEntry, ModalityListResponse, Model, ModelListResponse, OperationListResponse, OperationModelsInput, OperationModelsResponse, ModelParamsResponse, ModelSearchInput, ModelSearchResponse, PricingResponse } from "../types/index.js";
+export declare class ModelModalitiesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /**
+     * Canonical modality catalog derived from the model registry source of
+     * truth: model type, input/output shapes, and pricing unit metadata.
+     */
+    list(): APIPromise<ModalityListResponse>;
+    get(modality: CanonicalModality): APIPromise<ModalityCatalogEntry>;
+    operations(modality: CanonicalModality): APIPromise<OperationListResponse>;
+    models(modality: CanonicalModality, operation: string, input?: OperationModelsInput): APIPromise<OperationModelsResponse>;
+}
+export declare class ModelsResource {
+    private readonly client;
+    readonly modalities: ModelModalitiesResource;
+    constructor(client: HttpClient);
+    /**
+     * List the curated, fast-loading model set. Use `listAll()` for the full catalog.
+     * Returns the canonical Compose model card shape.
+     */
+    list(): APIPromise<ModelListResponse>;
+    /**
+     * Full catalog across every compiled provider source. Recommended to pair
+     * with `search()` for discoverability; raw `listAll()` is intended for
+     * exports and power users.
+     */
+    listAll(): APIPromise<ModelListResponse>;
+    /**
+     * Cursor-paginated search across the full catalog with filters for
+     * modality, operation, provider, price ceiling, context window minimum, and
+     * streaming support.
+     */
+    search(input?: ModelSearchInput): APIPromise<ModelSearchResponse>;
+    get(modelId: string): APIPromise<Model>;
+    getParams(modelId: string): APIPromise<ModelParamsResponse>;
+    /**
+     * Pricing table exposed by the API gateway. This is intentionally separate
+     * from model discovery because it returns only priced models plus pricing
+     * metadata for cost calculators and quote previews.
+     */
+    pricing(): APIPromise<PricingResponse>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/resources/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/resources/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EACR,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAClB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,uBAAuB;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;OAGG;IACH,IAAI,IAAI,UAAU,CAAC,oBAAoB,CAAC;IAOxC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAOlE,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAO1E,MAAM,CACF,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,oBAAyB,GACjC,UAAU,CAAC,uBAAuB,CAAC;CAQzC;AAED,qBAAa,cAAc;IAGX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;gBAEhB,MAAM,EAAE,UAAU;IAI/C;;;OAGG;IACH,IAAI,IAAI,UAAU,CAAC,iBAAiB,CAAC;IAOrC;;;;OAIG;IACH,OAAO,IAAI,UAAU,CAAC,iBAAiB,CAAC;IAOxC;;;;OAIG;IACH,MAAM,CAAC,KAAK,GAAE,gBAAqB,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAQrE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;IAOvC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAO3D;;;;OAIG;IACH,OAAO,IAAI,UAAU,CAAC,eAAe,CAAC;CAMzC"}

package/dist/resources/models.js

@@ -0,0 +1,101 @@
+export class ModelModalitiesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Canonical modality catalog derived from the model registry source of
+     * truth: model type, input/output shapes, and pricing unit metadata.
+     */
+    list() {
+        return this.client.request({
+            method: "GET",
+            path: "/v1/modalities",
+        });
+    }
+    get(modality) {
+        return this.client.request({
+            method: "GET",
+            path: `/v1/modalities/${encodeURIComponent(modality)}`,
+        });
+    }
+    operations(modality) {
+        return this.client.request({
+            method: "GET",
+            path: `/v1/modalities/${encodeURIComponent(modality)}/operations`,
+        });
+    }
+    models(modality, operation, input = {}) {
+        const query = { ...input };
+        return this.client.request({
+            method: "GET",
+            path: `/v1/modalities/${encodeURIComponent(modality)}/operations/${encodeURIComponent(operation)}/models`,
+            query,
+        });
+    }
+}
+export class ModelsResource {
+    client;
+    modalities;
+    constructor(client) {
+        this.client = client;
+        this.modalities = new ModelModalitiesResource(client);
+    }
+    /**
+     * List the curated, fast-loading model set. Use `listAll()` for the full catalog.
+     * Returns the canonical Compose model card shape.
+     */
+    list() {
+        return this.client.request({
+            method: "GET",
+            path: "/v1/models",
+        });
+    }
+    /**
+     * Full catalog across every compiled provider source. Recommended to pair
+     * with `search()` for discoverability; raw `listAll()` is intended for
+     * exports and power users.
+     */
+    listAll() {
+        return this.client.request({
+            method: "GET",
+            path: "/v1/models/all",
+        });
+    }
+    /**
+     * Cursor-paginated search across the full catalog with filters for
+     * modality, operation, provider, price ceiling, context window minimum, and
+     * streaming support.
+     */
+    search(input = {}) {
+        return this.client.request({
+            method: "POST",
+            path: "/v1/models/search",
+            body: input,
+        });
+    }
+    get(modelId) {
+        return this.client.request({
+            method: "GET",
+            path: `/v1/models/${encodeURIComponent(modelId)}`,
+        });
+    }
+    getParams(modelId) {
+        return this.client.request({
+            method: "GET",
+            path: `/v1/models/${encodeURIComponent(modelId)}/params`,
+        });
+    }
+    /**
+     * Pricing table exposed by the API gateway. This is intentionally separate
+     * from model discovery because it returns only priced models plus pricing
+     * metadata for cost calculators and quote previews.
+     */
+    pricing() {
+        return this.client.request({
+            method: "GET",
+            path: "/api/pricing",
+        });
+    }
+}
+//# sourceMappingURL=models.js.map