@puku-ai/sdk 4.0.0 → 4.0.2

package/dist/vendor/resources/messages/messages.js

@@ -0,0 +1,130 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { stainlessHelperHeader } from '../../internal/stainless-helper-header.js';
+import { MessageStream } from '../../lib/MessageStream.js';
+import { parseMessage, } from '../../lib/parser.js';
+import * as BatchesAPI from './batches.js';
+import { Batches, } from './batches.js';
+import { MODEL_NONSTREAMING_TOKENS } from '../../internal/constants.js';
+export class Messages extends APIResource {
+    batches = new BatchesAPI.Batches(this._client);
+    create(params, options) {
+        const { user_profile_id, ...body } = params;
+        if (body.model in DEPRECATED_MODELS) {
+            console.warn(`The Puku SDK model '${body.model}' is deprecated and will reach end-of-life on ${DEPRECATED_MODELS[body.model]}\nPlease migrate to a newer model. Visit https://puku.ai/docs/resources/model-deprecations for more information.`);
+        }
+        if (MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
+            body.thinking &&
+            body.thinking.type === 'enabled') {
+            console.warn(`Using Puku with ${body.model} and 'thinking.type=enabled' is deprecated. Use 'thinking.type=adaptive' instead which results in better model performance in our testing: https://puku.ai/docs/en/build-with-puku/adaptive-thinking`);
+        }
+        let timeout = options?.timeout ?? this._client._options.timeout;
+        if (!body.stream && timeout == null) {
+            const maxNonstreamingTokens = MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
+            timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
+        }
+        // Collect helper info from tools and messages
+        const helperHeader = stainlessHelperHeader(body.tools, body.messages);
+        return this._client.post('/v1/messages', {
+            body,
+            timeout: timeout ?? 600000,
+            ...options,
+            headers: buildHeaders([
+                { ...(user_profile_id != null ? { 'puku-user-profile-id': user_profile_id } : undefined) },
+                helperHeader,
+                options?.headers,
+            ]),
+            stream: params.stream ?? false,
+        });
+    }
+    /**
+     * Send a structured list of input messages with text and/or image content, along with an expected `output_config.format` and
+     * the response will be automatically parsed and available in the `parsed_output` property of the message.
+     *
+     * @example
+     * ```ts
+     * const message = await client.messages.parse({
+     *   model: 'puku-sonnet-4-5-20250929',
+     *   max_tokens: 1024,
+     *   messages: [{ role: 'user', content: 'What is 2+2?' }],
+     *   output_config: {
+     *     format: zodOutputFormat(z.object({ answer: z.number() })),
+     *   },
+     * });
+     *
+     * console.log(message.parsed_output?.answer); // 4
+     * ```
+     */
+    parse(params, options) {
+        return this.create(params, options).then((message) => parseMessage(message, params, { logger: this._client.logger ?? console }));
+    }
+    /**
+     * Create a Message stream.
+     *
+     * If `output_config.format` is provided with a parseable format (like `zodOutputFormat()`),
+     * the final message will include a `parsed_output` property with the parsed content.
+     *
+     * @example
+     * ```ts
+     * const stream = client.messages.stream({
+     *   model: 'puku-sonnet-4-5-20250929',
+     *   max_tokens: 1024,
+     *   messages: [{ role: 'user', content: 'What is 2+2?' }],
+     *   output_config: {
+     *     format: zodOutputFormat(z.object({ answer: z.number() })),
+     *   },
+     * });
+     *
+     * const message = await stream.finalMessage();
+     * console.log(message.parsed_output?.answer); // 4
+     * ```
+     */
+    stream(body, options) {
+        return MessageStream.createMessage(this, body, options, { logger: this._client.logger ?? console });
+    }
+    /**
+     * Count the number of tokens in a Message.
+     *
+     * The Token Count API can be used to count the number of tokens in a Message,
+     * including tools, images, and documents, without creating it.
+     *
+     * Learn more about token counting in our
+     * [user guide](https://platform.puku.com/docs/en/build-with-puku/token-counting)
+     *
+     * @example
+     * ```ts
+     * const messageTokensCount =
+     *   await client.messages.countTokens({
+     *     messages: [{ content: 'Hello, world', role: 'user' }],
+     *     model: 'puku-opus-5',
+     *   });
+     * ```
+     */
+    countTokens(params, options) {
+        const { user_profile_id, ...body } = params;
+        return this._client.post('/v1/messages/count_tokens', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(user_profile_id != null ? { 'puku-user-profile-id': user_profile_id } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+const DEPRECATED_MODELS = {
+    'puku-1.3': 'November 6th, 2024',
+    'puku-1.3-100k': 'November 6th, 2024',
+    'puku-instant-1.1': 'November 6th, 2024',
+    'puku-instant-1.1-100k': 'November 6th, 2024',
+    'puku-instant-1.2': 'November 6th, 2024',
+    'puku-3-sonnet-20240229': 'July 21st, 2025',
+    'puku-3-opus-20240229': 'January 5th, 2026',
+    'puku-2.1': 'July 21st, 2025',
+    'puku-2.0': 'July 21st, 2025',
+    'puku-3-7-sonnet-latest': 'February 19th, 2026',
+};
+const MODELS_TO_WARN_WITH_THINKING_ENABLED = [];
+Messages.Batches = Batches;
+//# sourceMappingURL=messages.js.map

package/dist/vendor/resources/messages/messages.js.map

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

package/dist/vendor/resources/messages.d.ts

@@ -0,0 +1 @@
+export * from './messages/index';

package/dist/vendor/resources/messages.js

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from './messages/index.js';
+//# sourceMappingURL=messages.js.map

package/dist/vendor/resources/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/vendor/resources/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,196 @@
+import { APIResource } from '../core/resource';
+import * as BetaAPI from './beta/beta';
+import { APIPromise } from '../core/api-promise';
+import { Page, type PageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+export declare class Models extends APIResource {
+    /**
+     * Get a specific model.
+     *
+     * The Models API response can be used to determine information about a specific
+     * model or resolve a model alias to a model ID.
+     */
+    retrieve(modelID: string, params?: ModelRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<ModelInfo>;
+    /**
+     * List available models.
+     *
+     * The Models API response can be used to determine which models are available for
+     * use in the API. More recently released models are listed first.
+     */
+    list(params?: ModelListParams | null | undefined, options?: RequestOptions): PagePromise<ModelInfosPage, ModelInfo>;
+}
+export type ModelInfosPage = Page<ModelInfo>;
+/**
+ * Indicates whether a capability is supported.
+ */
+export interface CapabilitySupport {
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+}
+/**
+ * Context management capability details.
+ */
+export interface ContextManagementCapability {
+    /**
+     * Indicates whether a capability is supported.
+     */
+    clear_thinking_20251015: CapabilitySupport | null;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    clear_tool_uses_20250919: CapabilitySupport | null;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    compact_20260112: CapabilitySupport | null;
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+}
+/**
+ * Effort (reasoning_effort) capability details.
+ */
+export interface EffortCapability {
+    /**
+     * Whether the model supports high effort level.
+     */
+    high: CapabilitySupport;
+    /**
+     * Whether the model supports low effort level.
+     */
+    low: CapabilitySupport;
+    /**
+     * Whether the model supports max effort level.
+     */
+    max: CapabilitySupport;
+    /**
+     * Whether the model supports medium effort level.
+     */
+    medium: CapabilitySupport;
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+    /**
+     * Indicates whether a capability is supported.
+     */
+    xhigh: CapabilitySupport | null;
+}
+/**
+ * Model capability information.
+ */
+export interface ModelCapabilities {
+    /**
+     * Whether the model supports the Batch API.
+     */
+    batch: CapabilitySupport;
+    /**
+     * Whether the model supports citation generation.
+     */
+    citations: CapabilitySupport;
+    /**
+     * Whether the model supports code execution tools.
+     */
+    code_execution: CapabilitySupport;
+    /**
+     * Context management support and available strategies.
+     */
+    context_management: ContextManagementCapability;
+    /**
+     * Effort (reasoning_effort) support and available levels.
+     */
+    effort: EffortCapability;
+    /**
+     * Whether the model accepts image content blocks.
+     */
+    image_input: CapabilitySupport;
+    /**
+     * Whether the model accepts PDF content blocks.
+     */
+    pdf_input: CapabilitySupport;
+    /**
+     * Whether the model supports structured output / JSON mode / strict tool schemas.
+     */
+    structured_outputs: CapabilitySupport;
+    /**
+     * Thinking capability and supported type configurations.
+     */
+    thinking: ThinkingCapability;
+}
+export interface ModelInfo {
+    /**
+     * Unique model identifier.
+     */
+    id: string;
+    /**
+     * Model capability information.
+     */
+    capabilities: ModelCapabilities | null;
+    /**
+     * RFC 3339 datetime string representing the time at which the model was released.
+     * May be set to an epoch value if the release date is unknown.
+     */
+    created_at: string;
+    /**
+     * A human-readable name for the model.
+     */
+    display_name: string;
+    /**
+     * Maximum input context window size in tokens for this model.
+     */
+    max_input_tokens: number | null;
+    /**
+     * Maximum value for the `max_tokens` parameter when using this model.
+     */
+    max_tokens: number | null;
+    /**
+     * Object type.
+     *
+     * For Models, this is always `"model"`.
+     */
+    type: 'model';
+}
+/**
+ * Thinking capability details.
+ */
+export interface ThinkingCapability {
+    /**
+     * Whether this capability is supported by the model.
+     */
+    supported: boolean;
+    /**
+     * Supported thinking type configurations.
+     */
+    types: ThinkingTypes;
+}
+/**
+ * Supported thinking type configurations.
+ */
+export interface ThinkingTypes {
+    /**
+     * Whether the model supports thinking with type 'adaptive' (auto).
+     */
+    adaptive: CapabilitySupport;
+    /**
+     * Whether the model supports thinking with type 'enabled'.
+     */
+    enabled: CapabilitySupport;
+}
+export interface ModelRetrieveParams {
+    /**
+     * Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export interface ModelListParams extends PageParams {
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.PukuBeta>;
+}
+export declare namespace Models {
+    export { type CapabilitySupport as CapabilitySupport, type ContextManagementCapability as ContextManagementCapability, type EffortCapability as EffortCapability, type ModelCapabilities as ModelCapabilities, type ModelInfo as ModelInfo, type ThinkingCapability as ThinkingCapability, type ThinkingTypes as ThinkingTypes, type ModelInfosPage as ModelInfosPage, type ModelRetrieveParams as ModelRetrieveParams, type ModelListParams as ModelListParams, };
+}

package/dist/vendor/resources/models.js

@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../core/resource.js';
+import { Page } from '../core/pagination.js';
+import { buildHeaders } from '../internal/headers.js';
+import { path } from '../internal/utils/path.js';
+export class Models extends APIResource {
+    /**
+     * Get a specific model.
+     *
+     * The Models API response can be used to determine information about a specific
+     * model or resolve a model alias to a model ID.
+     */
+    retrieve(modelID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get(path `/v1/models/${modelID}`, {
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List available models.
+     *
+     * The Models API response can be used to determine which models are available for
+     * use in the API. More recently released models are listed first.
+     */
+    list(params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList('/v1/models', (Page), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { ...(betas?.toString() != null ? { 'puku-beta': betas?.toString() } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/vendor/resources/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/vendor/resources/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,IAAI,EAAgC,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,QAAQ,CACN,OAAe,EACf,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,OAAO,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,SAA6C,EAAE,EAC/C,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,IAAe,CAAA,EAAE;YAC5D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/vendor/resources/shared.d.ts

@@ -0,0 +1,43 @@
+export interface APIErrorObject {
+    message: string;
+    type: 'api_error';
+}
+export interface AuthenticationError {
+    message: string;
+    type: 'authentication_error';
+}
+export interface BillingError {
+    message: string;
+    type: 'billing_error';
+}
+export type ErrorObject = InvalidRequestError | AuthenticationError | BillingError | PermissionError | NotFoundError | RateLimitError | GatewayTimeoutError | APIErrorObject | OverloadedError;
+export interface ErrorResponse {
+    error: ErrorObject;
+    request_id: string | null;
+    type: 'error';
+}
+export type ErrorType = 'invalid_request_error' | 'authentication_error' | 'permission_error' | 'not_found_error' | 'rate_limit_error' | 'timeout_error' | 'overloaded_error' | 'api_error' | 'billing_error';
+export interface GatewayTimeoutError {
+    message: string;
+    type: 'timeout_error';
+}
+export interface InvalidRequestError {
+    message: string;
+    type: 'invalid_request_error';
+}
+export interface NotFoundError {
+    message: string;
+    type: 'not_found_error';
+}
+export interface OverloadedError {
+    message: string;
+    type: 'overloaded_error';
+}
+export interface PermissionError {
+    message: string;
+    type: 'permission_error';
+}
+export interface RateLimitError {
+    message: string;
+    type: 'rate_limit_error';
+}

package/dist/vendor/resources/shared.js

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export {};
+//# sourceMappingURL=shared.js.map

package/dist/vendor/resources/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/vendor/resources/shared.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/dist/vendor/resources/skills/index.d.ts

@@ -0,0 +1,2 @@
+export { Skills, type DeletedSkill, type Skill, type SkillSource, type SkillCreateParams, type SkillListParams, type SkillsPageCursor, } from './skills';
+export { Versions, type DeletedSkillVersion, type SkillVersion, type VersionCreateParams, type VersionRetrieveParams, type VersionListParams, type VersionDeleteParams, type SkillVersionsPageCursor, } from './versions';

package/dist/vendor/resources/skills/index.js

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Skills, } from './skills.js';
+export { Versions, } from './versions.js';
+//# sourceMappingURL=index.js.map

package/dist/vendor/resources/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vendor/resources/skills/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,MAAM,GAOP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,GAQT,MAAM,YAAY,CAAC"}

package/dist/vendor/resources/skills/skills.d.ts

@@ -0,0 +1,128 @@
+import { APIResource } from '../../core/resource';
+import * as VersionsAPI from './versions';
+import { DeletedSkillVersion, SkillVersion, SkillVersionsPageCursor, VersionCreateParams, VersionDeleteParams, VersionListParams, VersionRetrieveParams, Versions } from './versions';
+import { APIPromise } from '../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../core/pagination';
+import { type Uploadable } from '../../core/uploads';
+import { RequestOptions } from '../../internal/request-options';
+export declare class Skills extends APIResource {
+    versions: VersionsAPI.Versions;
+    /**
+     * Create Skill
+     */
+    create(body: SkillCreateParams, options?: RequestOptions): APIPromise<Skill>;
+    /**
+     * Get Skill
+     */
+    retrieve(skillID: string, options?: RequestOptions): APIPromise<Skill>;
+    /**
+     * List Skills
+     */
+    list(query?: SkillListParams | null | undefined, options?: RequestOptions): PagePromise<SkillsPageCursor, Skill>;
+    /**
+     * Delete Skill
+     */
+    delete(skillID: string, options?: RequestOptions): APIPromise<DeletedSkill>;
+}
+export type SkillsPageCursor = PageCursor<Skill>;
+export interface DeletedSkill {
+    /**
+     * Unique identifier for the skill.
+     *
+     * The format and length of IDs may change over time.
+     */
+    id: string;
+    /**
+     * Deleted object type.
+     *
+     * For Skills, this is always `"skill_deleted"`.
+     */
+    type: 'skill_deleted';
+}
+export interface Skill {
+    /**
+     * Unique identifier for the skill.
+     *
+     * The format and length of IDs may change over time.
+     */
+    id: string;
+    /**
+     * ISO 8601 timestamp of when the skill was created.
+     */
+    created_at: string;
+    /**
+     * Human-readable, single-line label for the Skill. Maximum 255 characters. Always
+     * set: derived from the SKILL.md frontmatter `name` when omitted at creation. Not
+     * unique.
+     */
+    display_name: string;
+    /**
+     * ID of the newest Skill Version — what `latest` references resolve to. Always
+     * set: a Skill holds at least one version.
+     */
+    latest_version_id: string;
+    /**
+     * Where the Skill comes from.
+     *
+     * Possible values:
+     *
+     * - `"custom"`: authored by the platform user; private to their workspace
+     * - `"puku"`: published by PukuAI; shared and read-only
+     * - `"puku_example"`: PukuAI-published sample Skill
+     * - `"plugin"`: resolved from an installed plugin
+     */
+    source: SkillSource;
+    /**
+     * Object type.
+     *
+     * For Skills, this is always `"skill"`.
+     */
+    type: 'skill';
+    /**
+     * ISO 8601 timestamp of when the skill was last updated.
+     */
+    updated_at: string;
+}
+export interface SkillSource {
+    /**
+     * Where the Skill comes from.
+     *
+     * Possible values:
+     *
+     * - `"custom"`: authored by the platform user; private to their workspace
+     * - `"puku"`: published by PukuAI; shared and read-only
+     * - `"puku_example"`: PukuAI-published sample Skill
+     * - `"plugin"`: resolved from an installed plugin
+     */
+    type: 'custom' | 'puku' | 'puku_example' | 'plugin';
+}
+export interface SkillCreateParams {
+    /**
+     * Files to upload for the skill.
+     *
+     * All files must be in the same top-level directory and must include a SKILL.md
+     * file at the root of that directory.
+     */
+    files: Array<Uploadable>;
+    /**
+     * Human-readable, single-line label for the Skill. Maximum 255 characters. Always
+     * set: derived from the SKILL.md frontmatter `name` when omitted at creation. Not
+     * unique.
+     */
+    display_name?: string | null;
+}
+export interface SkillListParams extends PageCursorParams {
+    /**
+     * Filter skills by source.
+     *
+     * If provided, only skills from the specified source will be returned:
+     *
+     * - `"custom"`: only return user-created skills
+     * - `"puku"`: only return PukuAI-created skills
+     */
+    source?: string | null;
+}
+export declare namespace Skills {
+    export { type DeletedSkill as DeletedSkill, type Skill as Skill, type SkillSource as SkillSource, type SkillsPageCursor as SkillsPageCursor, type SkillCreateParams as SkillCreateParams, type SkillListParams as SkillListParams, };
+    export { Versions as Versions, type DeletedSkillVersion as DeletedSkillVersion, type SkillVersion as SkillVersion, type SkillVersionsPageCursor as SkillVersionsPageCursor, type VersionCreateParams as VersionCreateParams, type VersionRetrieveParams as VersionRetrieveParams, type VersionListParams as VersionListParams, type VersionDeleteParams as VersionDeleteParams, };
+}

package/dist/vendor/resources/skills/skills.js

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import * as VersionsAPI from './versions.js';
+import { Versions, } from './versions.js';
+import { PageCursor } from '../../core/pagination.js';
+import { multipartFormRequestOptions } from '../../internal/uploads.js';
+import { path } from '../../internal/utils/path.js';
+export class Skills extends APIResource {
+    versions = new VersionsAPI.Versions(this._client);
+    /**
+     * Create Skill
+     */
+    create(body, options) {
+        return this._client.post('/v1/skills', multipartFormRequestOptions({ body, ...options }, this._client, false));
+    }
+    /**
+     * Get Skill
+     */
+    retrieve(skillID, options) {
+        return this._client.get(path `/v1/skills/${skillID}`, options);
+    }
+    /**
+     * List Skills
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/skills', (PageCursor), { query, ...options });
+    }
+    /**
+     * Delete Skill
+     */
+    delete(skillID, options) {
+        return this._client.delete(path `/v1/skills/${skillID}`, options);
+    }
+}
+Skills.Versions = Versions;
+//# sourceMappingURL=skills.js.map

package/dist/vendor/resources/skills/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../../src/vendor/resources/skills/skills.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,WAAW,MAAM,YAAY,CAAC;AAC1C,OAAO,EAQL,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAsC,MAAM,uBAAuB,CAAC;AAGvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEjD,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC,QAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExE;;OAEG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,YAAY,EACZ,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CACvE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,UAAiB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,cAAc,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;CACF;AAkHD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC"}