@w6w/sdk 0.9.16 → 0.9.23

package/dist/src/models.d.ts

@@ -0,0 +1,141 @@
+/**
+ * `client.models.*`, `client.modelRoutes.*` and `client.modelUsage.*` — the model
+ * registry: the catalog, named routes, and the completion gateway.
+ *
+ * Six operations, one HTTP call each (`endpoints.json`). The rest of the model surface (catalog edits, rates,
+ * budgets, route writes) lives in the unstable `client.console.models` group.
+ *
+ * **`modelRoutes.complete` returns the flat gateway envelope as-is** —
+ * `invocationId`, `status` and `key` included — and never unwraps it to
+ * `output` (DC-5/G-W4). Routes and usage are project-scoped: `?project=` is
+ * resolved per call, then from the client default.
+ *
+ * @module
+ */
+import type { ResolvedConfig } from "./config.ts";
+import { type CallOptions, type HttpResponse, type RequestOptions } from "./http.ts";
+/** The slice of `W6WClient` these namespaces need. */
+export interface ModelsHost {
+    /** The resolved configuration; only `project` is read. */
+    readonly config: ResolvedConfig;
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/** The wire dialect a completion is spoken in. */
+export type ModelDialect = "bridge" | "openai" | "anthropic" | "ollama";
+/** How much of the gateway response a completion returns. */
+export type ModelResponseMode = "both" | "output" | "raw";
+/** One catalog entry. Fields beyond `id` are server-defined and may grow. */
+export interface Model {
+    id: string;
+    provider?: string;
+    status?: string;
+    [field: string]: unknown;
+}
+/** One named model route. */
+export interface ModelRoute {
+    name: string;
+    [field: string]: unknown;
+}
+/** A keyset-paged catalog page. */
+export interface ModelPage {
+    models: Model[];
+    nextCursor: string | null;
+}
+/** Where a `usageSummary`'s counts came from. */
+export type ModelUsageSource = "reported" | "partial" | "estimated" | "unknown" | "legacy";
+/** Provider-neutral token counts; each is `null` when the provider did not report it. */
+export interface ModelUsageSummary {
+    inclusiveInputTokens: number | null;
+    freshInputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+    outputTokens: number | null;
+    reasoningTokens: number | null;
+    totalTokens: number | null;
+    source: ModelUsageSource;
+}
+/** The flat completion envelope, returned without unwrapping. */
+export interface ModelCompletion {
+    invocationId: string;
+    status: string;
+    contractVersion?: 1;
+    /** The requested route name; `null` on the direct-model path. */
+    route?: string | null;
+    key?: string;
+    usageSummary?: ModelUsageSummary;
+    meta?: {
+        usageRecorded?: boolean;
+        [field: string]: unknown;
+    };
+    output?: unknown;
+    raw?: unknown;
+    [field: string]: unknown;
+}
+/** The result of `modelUsage.query`. */
+export interface ModelUsageReport {
+    totals: Record<string, unknown>;
+    /**
+     * `true` when the server stopped folding the ledger at its aggregate row cap,
+     * so `totals` and `groups` cover only part of the filtered window.
+     */
+    totalsTruncated: boolean;
+    groups?: Record<string, unknown>[];
+    items: Record<string, unknown>[];
+    nextCursor: string | null;
+}
+/** `models.list` options. */
+export interface ModelListOptions extends CallOptions {
+    provider?: string;
+    status?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** Project-scoped call options. */
+export interface ModelRouteOptions extends CallOptions {
+    /** Project id to scope this call to. */
+    project?: string;
+}
+/** `modelRoutes.complete` options. */
+export interface ModelCompleteOptions extends ModelRouteOptions {
+    dialect?: ModelDialect;
+    response?: ModelResponseMode;
+}
+/** `modelUsage.query` options. */
+export interface ModelUsageOptions extends ModelRouteOptions {
+    groupBy?: "route" | "model" | "day";
+    from?: string;
+    to?: string;
+    route?: string;
+    model?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** `client.models` — the catalog. */
+export declare class ModelsApi {
+    #private;
+    constructor(host: ModelsHost);
+    /** List the catalog; returns the whole page `{models, nextCursor}`. */
+    list(options?: ModelListOptions): Promise<ModelPage>;
+    /** Read one catalog entry by its catalog id (`mdl_…`), not a provider-native model id. */
+    get(id: string, options?: CallOptions): Promise<Model>;
+}
+/** `client.modelRoutes` — named routes and the completion gateway. */
+export declare class ModelRoutesApi {
+    #private;
+    constructor(host: ModelsHost);
+    /** List the project's routes. */
+    list(options?: ModelRouteOptions): Promise<ModelRoute[]>;
+    /** Read one route by name. */
+    get(name: string, options?: ModelRouteOptions): Promise<ModelRoute>;
+    /** POST `input` to `/model-routes/{name}/complete`; the flat envelope, not unwrapped. */
+    complete(name: string, input: Record<string, unknown>, options?: ModelCompleteOptions): Promise<ModelCompletion>;
+}
+/** `client.modelUsage` — recorded usage. */
+export declare class ModelUsageApi {
+    #private;
+    constructor(host: ModelsHost);
+    /** Query usage; returns `{totals, groups?, items, nextCursor}` as sent. */
+    query(options?: ModelUsageOptions): Promise<ModelUsageReport>;
+}
+//# sourceMappingURL=models.d.ts.map

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

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

package/dist/src/models.js

@@ -0,0 +1,128 @@
+/**
+ * `client.models.*`, `client.modelRoutes.*` and `client.modelUsage.*` — the model
+ * registry: the catalog, named routes, and the completion gateway.
+ *
+ * Six operations, one HTTP call each (`endpoints.json`). The rest of the model surface (catalog edits, rates,
+ * budgets, route writes) lives in the unstable `client.console.models` group.
+ *
+ * **`modelRoutes.complete` returns the flat gateway envelope as-is** —
+ * `invocationId`, `status` and `key` included — and never unwraps it to
+ * `output` (DC-5/G-W4). Routes and usage are project-scoped: `?project=` is
+ * resolved per call, then from the client default.
+ *
+ * @module
+ */
+import { path } from "./http.js";
+/** Strip a single-key envelope if present, else take the body as sent. */
+function pick(res, key) {
+    const b = res.body;
+    if (typeof b === "object" && b !== null && !Array.isArray(b)) {
+        const v = b[key];
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    return b;
+}
+/** `client.models` — the catalog. */
+export class ModelsApi {
+    #host;
+    constructor(host) {
+        this.#host = host;
+    }
+    /** List the catalog; returns the whole page `{models, nextCursor}`. */
+    async list(options) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: "/models",
+            query: {
+                provider: options?.provider,
+                status: options?.status,
+                limit: options?.limit,
+                cursor: options?.cursor,
+            },
+            signal: options?.signal,
+        });
+        return res.body;
+    }
+    /** Read one catalog entry by its catalog id (`mdl_…`), not a provider-native model id. */
+    async get(id, options) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/models/${id}`,
+            signal: options?.signal,
+        });
+        return pick(res, "model");
+    }
+}
+/** `client.modelRoutes` — named routes and the completion gateway. */
+export class ModelRoutesApi {
+    #host;
+    constructor(host) {
+        this.#host = host;
+    }
+    #project(options) {
+        return options?.project ?? this.#host.config.project ?? undefined;
+    }
+    /** List the project's routes. */
+    async list(options) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: "/model-routes",
+            query: { project: this.#project(options) },
+            signal: options?.signal,
+        });
+        return pick(res, "routes");
+    }
+    /** Read one route by name. */
+    async get(name, options) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/model-routes/${name}`,
+            query: { project: this.#project(options) },
+            signal: options?.signal,
+        });
+        return pick(res, "route");
+    }
+    /** POST `input` to `/model-routes/{name}/complete`; the flat envelope, not unwrapped. */
+    async complete(name, input, options) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/model-routes/${name}/complete`,
+            query: {
+                project: this.#project(options),
+                dialect: options?.dialect,
+                response: options?.response,
+            },
+            body: input,
+            signal: options?.signal,
+        });
+        return res.body;
+    }
+}
+/** `client.modelUsage` — recorded usage. */
+export class ModelUsageApi {
+    #host;
+    constructor(host) {
+        this.#host = host;
+    }
+    /** Query usage; returns `{totals, groups?, items, nextCursor}` as sent. */
+    async query(options) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: "/model-usage",
+            query: {
+                project: options?.project ?? this.#host.config.project ?? undefined,
+                groupBy: options?.groupBy,
+                from: options?.from,
+                to: options?.to,
+                route: options?.route,
+                model: options?.model,
+                limit: options?.limit,
+                cursor: options?.cursor,
+            },
+            signal: options?.signal,
+        });
+        return res.body;
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/src/models.js.map

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

package/dist/src/skills.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `client.skills.*` — read and archive skills (contract 0.11.0).
+ *
+ * There is no `create`: a skill is uploaded with `assets.uploads` and
+ * `purpose: "skill"`.
+ *
+ * @module
+ */
+import { type CallOptions, type HttpResponse, type RequestOptions } from "./http.ts";
+import { type ListPagedOptions, type Skill, type SkillsApi as SkillsApiShape, type SkillVersion } from "./types.ts";
+/** The slice of `W6WClient` this namespace needs: the transport and nothing else. */
+export interface SkillsHost {
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/** `client.skills` — see the module doc. */
+export declare class SkillsApi implements SkillsApiShape {
+    #private;
+    constructor(host: SkillsHost);
+    /** List skills visible to the caller. */
+    list(opts?: ListPagedOptions): Promise<Skill[]>;
+    /** Fetch one skill. */
+    get(id: string, opts?: CallOptions): Promise<Skill>;
+    /** List a skill's immutable versions. */
+    versions(id: string, opts?: CallOptions): Promise<SkillVersion[]>;
+    /** Archive a skill; returns the archived row. */
+    archive(id: string, opts?: CallOptions): Promise<Skill>;
+}
+//# sourceMappingURL=skills.d.ts.map

package/dist/src/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAQ,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,SAAS,IAAI,cAAc,EAChC,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED,4CAA4C;AAC5C,qBAAa,SAAU,YAAW,cAAc;;gBAGlC,IAAI,EAAE,UAAU;IAI5B,yCAAyC;IACnC,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAUrD,uBAAuB;IACjB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IASzD,yCAAyC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IASvE,iDAAiD;IAC3C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;CAQ9D"}

package/dist/src/skills.js

@@ -0,0 +1,55 @@
+/**
+ * `client.skills.*` — read and archive skills (contract 0.11.0).
+ *
+ * There is no `create`: a skill is uploaded with `assets.uploads` and
+ * `purpose: "skill"`.
+ *
+ * @module
+ */
+import { path } from "./http.js";
+import { unwrap, } from "./types.js";
+/** `client.skills` — see the module doc. */
+export class SkillsApi {
+    #host;
+    constructor(host) {
+        this.#host = host;
+    }
+    /** List skills visible to the caller. */
+    async list(opts) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: "/skills",
+            query: { includeArchived: opts?.includeArchived, limit: opts?.limit },
+            signal: opts?.signal,
+        });
+        return unwrap(res, "skills");
+    }
+    /** Fetch one skill. */
+    async get(id, opts) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/skills/${id}`,
+            signal: opts?.signal,
+        });
+        return unwrap(res, "skill");
+    }
+    /** List a skill's immutable versions. */
+    async versions(id, opts) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/skills/${id}/versions`,
+            signal: opts?.signal,
+        });
+        return unwrap(res, "versions");
+    }
+    /** Archive a skill; returns the archived row. */
+    async archive(id, opts) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/skills/${id}/archive`,
+            signal: opts?.signal,
+        });
+        return unwrap(res, "skill");
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/src/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAuC,IAAI,EAAuB,MAAM,WAAW,CAAC;AAC3F,OAAO,EAKL,MAAM,GACP,MAAM,YAAY,CAAC;AAQpB,4CAA4C;AAC5C,MAAM,OAAO,SAAS;IACX,KAAK,CAAa;IAE3B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,IAAuB;QAChC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,MAAM,CAAU,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,IAAkB;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAA,WAAW,EAAE,EAAE;YACzB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,MAAM,CAAQ,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,IAAkB;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAA,WAAW,EAAE,WAAW;YAClC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,MAAM,CAAiB,GAAG,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,IAAkB;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,WAAW,EAAE,UAAU;YACjC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,MAAM,CAAQ,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF"}