tekimax-ts 0.1.2 → 0.1.4

package/dist/index.d.mts

@@ -31633,16 +31633,80 @@ declare const userMessageItemParamSchema: z.ZodObject<{
 
 declare const verbosityEnumSchema: z.ZodEnum<["low", "medium", "high"]>;
 
+/**
+ * A wrapper around the raw API response that provides helper methods
+ * for common tasks like extracting text content.
+ */
+declare class TekimaxResponse {
+    private readonly _raw;
+    constructor(_raw: ResponseResource);
+    /**
+     * Access the raw response object returned by the API.
+     */
+    get raw(): ResponseResource;
+    /**
+     * Automatically extracts the text content from the response.
+     * It looks for the first "output_text" item in the response content.
+     */
+    get text(): string | undefined;
+    /**
+     * The ID of the response.
+     */
+    get id(): string | undefined;
+    /**
+     * The model used to generate the response.
+     */
+    get model(): string | undefined;
+}
+/**
+ * Options for sending a message or creating a session.
+ */
+type MessageOptions = Omit<CreateResponseBody, "input" | "stream">;
+/**
+ * The main client for interacting with the Tekimax API.
+ */
 declare class TekimaxClient {
     private baseUrl;
     private headers;
+    /**
+     * Creates a new TekimaxClient.
+     *
+     * @param options - Configuration options for the client.
+     * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+     * @param options.apiKey - Your Tekimax API key.
+     *
+     * @example
+     * const client = new TekimaxClient({ apiKey: "tm_..." });
+     */
     constructor(options?: {
         baseUrl?: string;
         apiKey?: string;
     });
     private request;
-    createSession(body: CreateResponseBody): Promise<ResponseResource>;
-    sendMessage(body: CreateResponseBody): Promise<ResponseResource>;
+    /**
+     * Creates a new session and sends the initial message.
+     *
+     * @param message - The initial message text to start the session.
+     * @param options - Additional configuration options (model, temperature, etc.).
+     *
+     * @example
+     * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+     * console.log(response.text);
+     */
+    createSession(message: string, options?: MessageOptions): Promise<TekimaxResponse>;
+    /**
+     * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+     *
+     * @param message - The message text to send.
+     * @param options - Additional configuration options.
+     *
+     * @example
+     * const response = await client.sendMessage("What is the weather?", {
+     *   previous_response_id: "resp_123"
+     * });
+     * console.log(response.text);
+     */
+    sendMessage(message: string, options?: MessageOptions): Promise<TekimaxResponse>;
 }
 
-export { type AllowedToolChoice, type AllowedToolChoiceTypeEnumKey, type AllowedToolsParam, type AllowedToolsParamTypeEnumKey, type Annotation, type AssistantMessageItemParam, type AssistantMessageItemParamRoleEnumKey, type AssistantMessageItemParamTypeEnumKey, type CreateResponseBody, type Createresponse200, type CreateresponseMutation, type CreateresponseMutationRequest, type CreateresponseMutationResponse, type DetailEnum, type DetailEnumEnumKey, type DeveloperMessageItemParam, type DeveloperMessageItemParamRoleEnumKey, type DeveloperMessageItemParamTypeEnumKey, type EmptyModelParam, type Error, type ErrorPayload, type ErrorStreamingEvent, type ErrorStreamingEventTypeEnumKey, type FunctionCall, type FunctionCallItemParam, type FunctionCallItemParamTypeEnumKey, type FunctionCallItemStatus, type FunctionCallItemStatusEnumKey, type FunctionCallOutput, type FunctionCallOutputItemParam, type FunctionCallOutputItemParamTypeEnumKey, type FunctionCallOutputStatusEnum, type FunctionCallOutputStatusEnumEnumKey, type FunctionCallOutputTypeEnumKey, type FunctionCallStatus, type FunctionCallStatusEnumKey, type FunctionCallTypeEnumKey, type FunctionTool, type FunctionToolChoice, type FunctionToolChoiceTypeEnumKey, type FunctionToolParam, type FunctionToolParamTypeEnumKey, type FunctionToolTypeEnumKey, type ImageDetail, type ImageDetailEnumKey, type IncludeEnum, type IncludeEnumEnumKey, type IncompleteDetails, type InputFileContent, type InputFileContentParam, type InputFileContentParamTypeEnumKey, type InputFileContentTypeEnumKey, type InputImageContent, type InputImageContentParamAutoParam, type InputImageContentParamAutoParamTypeEnumKey, type InputImageContentTypeEnumKey, type InputTextContent, type InputTextContentParam, type InputTextContentParamTypeEnumKey, type InputTextContentTypeEnumKey, type InputTokensDetails, type InputVideoContent, type InputVideoContentTypeEnumKey, type ItemField, type ItemParam, type ItemReferenceParam, type ItemReferenceParamTypeEnumKey, type JsonObjectResponseFormat, type JsonObjectResponseFormatTypeEnumKey, type JsonSchemaResponseFormat, type JsonSchemaResponseFormatParam, type JsonSchemaResponseFormatParamTypeEnumKey, type JsonSchemaResponseFormatTypeEnumKey, type LogProb, type Message, type MessageRole, type MessageRoleEnumKey, type MessageStatus, type MessageStatusEnumKey, type MessageTypeEnumKey, type MetadataParam, type OutputTextContent, type OutputTextContentParam, type OutputTextContentParamTypeEnumKey, type OutputTextContentTypeEnumKey, type OutputTokensDetails, type Reasoning, type ReasoningBody, type ReasoningBodyTypeEnumKey, type ReasoningEffortEnum, type ReasoningEffortEnumEnumKey, type ReasoningItemParam, type ReasoningItemParamTypeEnumKey, type ReasoningParam, type ReasoningSummaryContentParam, type ReasoningSummaryContentParamTypeEnumKey, type ReasoningSummaryEnum, type ReasoningSummaryEnumEnumKey, type ReasoningTextContent, type ReasoningTextContentTypeEnumKey, type RefusalContent, type RefusalContentParam, type RefusalContentParamTypeEnumKey, type RefusalContentTypeEnumKey, type ResponseCompletedStreamingEvent, type ResponseCompletedStreamingEventTypeEnumKey, type ResponseContentPartAddedStreamingEvent, type ResponseContentPartAddedStreamingEventTypeEnumKey, type ResponseContentPartDoneStreamingEvent, type ResponseContentPartDoneStreamingEventTypeEnumKey, type ResponseCreatedStreamingEvent, type ResponseCreatedStreamingEventTypeEnumKey, type ResponseFailedStreamingEvent, type ResponseFailedStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDeltaStreamingEvent, type ResponseFunctionCallArgumentsDeltaStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDoneStreamingEvent, type ResponseFunctionCallArgumentsDoneStreamingEventTypeEnumKey, type ResponseInProgressStreamingEvent, type ResponseInProgressStreamingEventTypeEnumKey, type ResponseIncompleteStreamingEvent, type ResponseIncompleteStreamingEventTypeEnumKey, type ResponseOutputItemAddedStreamingEvent, type ResponseOutputItemAddedStreamingEventTypeEnumKey, type ResponseOutputItemDoneStreamingEvent, type ResponseOutputItemDoneStreamingEventTypeEnumKey, type ResponseOutputTextAnnotationAddedStreamingEvent, type ResponseOutputTextAnnotationAddedStreamingEventTypeEnumKey, type ResponseOutputTextDeltaStreamingEvent, type ResponseOutputTextDeltaStreamingEventTypeEnumKey, type ResponseOutputTextDoneStreamingEvent, type ResponseOutputTextDoneStreamingEventTypeEnumKey, type ResponseQueuedStreamingEvent, type ResponseQueuedStreamingEventTypeEnumKey, type ResponseReasoningDeltaStreamingEvent, type ResponseReasoningDeltaStreamingEventTypeEnumKey, type ResponseReasoningDoneStreamingEvent, type ResponseReasoningDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryDeltaStreamingEvent, type ResponseReasoningSummaryDeltaStreamingEventTypeEnumKey, type ResponseReasoningSummaryDoneStreamingEvent, type ResponseReasoningSummaryDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartAddedStreamingEvent, type ResponseReasoningSummaryPartAddedStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartDoneStreamingEvent, type ResponseReasoningSummaryPartDoneStreamingEventTypeEnumKey, type ResponseRefusalDeltaStreamingEvent, type ResponseRefusalDeltaStreamingEventTypeEnumKey, type ResponseRefusalDoneStreamingEvent, type ResponseRefusalDoneStreamingEventTypeEnumKey, type ResponseResource, type ResponseResourceObjectEnumKey, type ResponsesToolParam, type ServiceTierEnum, type ServiceTierEnumEnumKey, type SpecificFunctionParam, type SpecificFunctionParamTypeEnumKey, type SpecificToolChoiceParam, type StreamOptionsParam, type SummaryTextContent, type SummaryTextContentTypeEnumKey, type SystemMessageItemParam, type SystemMessageItemParamRoleEnumKey, type SystemMessageItemParamTypeEnumKey, TekimaxClient, type TextContent, type TextContentTypeEnumKey, type TextField, type TextFormatParam, type TextParam, type TextResponseFormat, type TextResponseFormatTypeEnumKey, type Tool, type ToolChoiceParam, type ToolChoiceValueEnum, type ToolChoiceValueEnumEnumKey, type TopLogProb, type TruncationEnum, type TruncationEnumEnumKey, type UrlCitationBody, type UrlCitationBodyTypeEnumKey, type UrlCitationParam, type UrlCitationParamTypeEnumKey, type Usage, type UserMessageItemParam, type UserMessageItemParamRoleEnumKey, type UserMessageItemParamTypeEnumKey, type VerbosityEnum, type VerbosityEnumEnumKey, allowedToolChoiceSchema, allowedToolChoiceTypeEnum, allowedToolsParamSchema, allowedToolsParamTypeEnum, annotationSchema, assistantMessageItemParamRoleEnum, assistantMessageItemParamSchema, assistantMessageItemParamTypeEnum, createResponseBodySchema, createresponse200Schema, createresponseMutationRequestSchema, createresponseMutationResponseSchema, detailEnumEnum, detailEnumSchema, developerMessageItemParamRoleEnum, developerMessageItemParamSchema, developerMessageItemParamTypeEnum, emptyModelParamSchema, errorPayloadSchema, errorSchema, errorStreamingEventSchema, errorStreamingEventTypeEnum, functionCallItemParamSchema, functionCallItemParamTypeEnum, functionCallItemStatusEnum, functionCallItemStatusSchema, functionCallOutputItemParamSchema, functionCallOutputItemParamTypeEnum, functionCallOutputSchema, functionCallOutputStatusEnumEnum, functionCallOutputStatusEnumSchema, functionCallOutputTypeEnum, functionCallSchema, functionCallStatusEnum, functionCallStatusSchema, functionCallTypeEnum, functionToolChoiceSchema, functionToolChoiceTypeEnum, functionToolParamSchema, functionToolParamTypeEnum, functionToolSchema, functionToolTypeEnum, imageDetailEnum, imageDetailSchema, includeEnumEnum, includeEnumSchema, incompleteDetailsSchema, inputFileContentParamSchema, inputFileContentParamTypeEnum, inputFileContentSchema, inputFileContentTypeEnum, inputImageContentParamAutoParamSchema, inputImageContentParamAutoParamTypeEnum, inputImageContentSchema, inputImageContentTypeEnum, inputTextContentParamSchema, inputTextContentParamTypeEnum, inputTextContentSchema, inputTextContentTypeEnum, inputTokensDetailsSchema, inputVideoContentSchema, inputVideoContentTypeEnum, itemFieldSchema, itemParamSchema, itemReferenceParamSchema, itemReferenceParamTypeEnum, jsonObjectResponseFormatSchema, jsonObjectResponseFormatTypeEnum, jsonSchemaResponseFormatParamSchema, jsonSchemaResponseFormatParamTypeEnum, jsonSchemaResponseFormatSchema, jsonSchemaResponseFormatTypeEnum, logProbSchema, messageRoleEnum, messageRoleSchema, messageSchema, messageStatusEnum, messageStatusSchema, messageTypeEnum, metadataParamSchema, outputTextContentParamSchema, outputTextContentParamTypeEnum, outputTextContentSchema, outputTextContentTypeEnum, outputTokensDetailsSchema, reasoningBodySchema, reasoningBodyTypeEnum, reasoningEffortEnumEnum, reasoningEffortEnumSchema, reasoningItemParamSchema, reasoningItemParamTypeEnum, reasoningParamSchema, reasoningSchema, reasoningSummaryContentParamSchema, reasoningSummaryContentParamTypeEnum, reasoningSummaryEnumEnum, reasoningSummaryEnumSchema, reasoningTextContentSchema, reasoningTextContentTypeEnum, refusalContentParamSchema, refusalContentParamTypeEnum, refusalContentSchema, refusalContentTypeEnum, responseCompletedStreamingEventSchema, responseCompletedStreamingEventTypeEnum, responseContentPartAddedStreamingEventSchema, responseContentPartAddedStreamingEventTypeEnum, responseContentPartDoneStreamingEventSchema, responseContentPartDoneStreamingEventTypeEnum, responseCreatedStreamingEventSchema, responseCreatedStreamingEventTypeEnum, responseFailedStreamingEventSchema, responseFailedStreamingEventTypeEnum, responseFunctionCallArgumentsDeltaStreamingEventSchema, responseFunctionCallArgumentsDeltaStreamingEventTypeEnum, responseFunctionCallArgumentsDoneStreamingEventSchema, responseFunctionCallArgumentsDoneStreamingEventTypeEnum, responseInProgressStreamingEventSchema, responseInProgressStreamingEventTypeEnum, responseIncompleteStreamingEventSchema, responseIncompleteStreamingEventTypeEnum, responseOutputItemAddedStreamingEventSchema, responseOutputItemAddedStreamingEventTypeEnum, responseOutputItemDoneStreamingEventSchema, responseOutputItemDoneStreamingEventTypeEnum, responseOutputTextAnnotationAddedStreamingEventSchema, responseOutputTextAnnotationAddedStreamingEventTypeEnum, responseOutputTextDeltaStreamingEventSchema, responseOutputTextDeltaStreamingEventTypeEnum, responseOutputTextDoneStreamingEventSchema, responseOutputTextDoneStreamingEventTypeEnum, responseQueuedStreamingEventSchema, responseQueuedStreamingEventTypeEnum, responseReasoningDeltaStreamingEventSchema, responseReasoningDeltaStreamingEventTypeEnum, responseReasoningDoneStreamingEventSchema, responseReasoningDoneStreamingEventTypeEnum, responseReasoningSummaryDeltaStreamingEventSchema, responseReasoningSummaryDeltaStreamingEventTypeEnum, responseReasoningSummaryDoneStreamingEventSchema, responseReasoningSummaryDoneStreamingEventTypeEnum, responseReasoningSummaryPartAddedStreamingEventSchema, responseReasoningSummaryPartAddedStreamingEventTypeEnum, responseReasoningSummaryPartDoneStreamingEventSchema, responseReasoningSummaryPartDoneStreamingEventTypeEnum, responseRefusalDeltaStreamingEventSchema, responseRefusalDeltaStreamingEventTypeEnum, responseRefusalDoneStreamingEventSchema, responseRefusalDoneStreamingEventTypeEnum, responseResourceObjectEnum, responseResourceSchema, responsesToolParamSchema, serviceTierEnumEnum, serviceTierEnumSchema, specificFunctionParamSchema, specificFunctionParamTypeEnum, specificToolChoiceParamSchema, streamOptionsParamSchema, summaryTextContentSchema, summaryTextContentTypeEnum, systemMessageItemParamRoleEnum, systemMessageItemParamSchema, systemMessageItemParamTypeEnum, textContentSchema, textContentTypeEnum, textFieldSchema, textFormatParamSchema, textParamSchema, textResponseFormatSchema, textResponseFormatTypeEnum, toolChoiceParamSchema, toolChoiceValueEnumEnum, toolChoiceValueEnumSchema, toolSchema, topLogProbSchema, truncationEnumEnum, truncationEnumSchema, urlCitationBodySchema, urlCitationBodyTypeEnum, urlCitationParamSchema, urlCitationParamTypeEnum, usageSchema, userMessageItemParamRoleEnum, userMessageItemParamSchema, userMessageItemParamTypeEnum, verbosityEnumEnum, verbosityEnumSchema };
+export { type AllowedToolChoice, type AllowedToolChoiceTypeEnumKey, type AllowedToolsParam, type AllowedToolsParamTypeEnumKey, type Annotation, type AssistantMessageItemParam, type AssistantMessageItemParamRoleEnumKey, type AssistantMessageItemParamTypeEnumKey, type CreateResponseBody, type Createresponse200, type CreateresponseMutation, type CreateresponseMutationRequest, type CreateresponseMutationResponse, type DetailEnum, type DetailEnumEnumKey, type DeveloperMessageItemParam, type DeveloperMessageItemParamRoleEnumKey, type DeveloperMessageItemParamTypeEnumKey, type EmptyModelParam, type Error, type ErrorPayload, type ErrorStreamingEvent, type ErrorStreamingEventTypeEnumKey, type FunctionCall, type FunctionCallItemParam, type FunctionCallItemParamTypeEnumKey, type FunctionCallItemStatus, type FunctionCallItemStatusEnumKey, type FunctionCallOutput, type FunctionCallOutputItemParam, type FunctionCallOutputItemParamTypeEnumKey, type FunctionCallOutputStatusEnum, type FunctionCallOutputStatusEnumEnumKey, type FunctionCallOutputTypeEnumKey, type FunctionCallStatus, type FunctionCallStatusEnumKey, type FunctionCallTypeEnumKey, type FunctionTool, type FunctionToolChoice, type FunctionToolChoiceTypeEnumKey, type FunctionToolParam, type FunctionToolParamTypeEnumKey, type FunctionToolTypeEnumKey, type ImageDetail, type ImageDetailEnumKey, type IncludeEnum, type IncludeEnumEnumKey, type IncompleteDetails, type InputFileContent, type InputFileContentParam, type InputFileContentParamTypeEnumKey, type InputFileContentTypeEnumKey, type InputImageContent, type InputImageContentParamAutoParam, type InputImageContentParamAutoParamTypeEnumKey, type InputImageContentTypeEnumKey, type InputTextContent, type InputTextContentParam, type InputTextContentParamTypeEnumKey, type InputTextContentTypeEnumKey, type InputTokensDetails, type InputVideoContent, type InputVideoContentTypeEnumKey, type ItemField, type ItemParam, type ItemReferenceParam, type ItemReferenceParamTypeEnumKey, type JsonObjectResponseFormat, type JsonObjectResponseFormatTypeEnumKey, type JsonSchemaResponseFormat, type JsonSchemaResponseFormatParam, type JsonSchemaResponseFormatParamTypeEnumKey, type JsonSchemaResponseFormatTypeEnumKey, type LogProb, type Message, type MessageRole, type MessageRoleEnumKey, type MessageStatus, type MessageStatusEnumKey, type MessageTypeEnumKey, type MetadataParam, type OutputTextContent, type OutputTextContentParam, type OutputTextContentParamTypeEnumKey, type OutputTextContentTypeEnumKey, type OutputTokensDetails, type Reasoning, type ReasoningBody, type ReasoningBodyTypeEnumKey, type ReasoningEffortEnum, type ReasoningEffortEnumEnumKey, type ReasoningItemParam, type ReasoningItemParamTypeEnumKey, type ReasoningParam, type ReasoningSummaryContentParam, type ReasoningSummaryContentParamTypeEnumKey, type ReasoningSummaryEnum, type ReasoningSummaryEnumEnumKey, type ReasoningTextContent, type ReasoningTextContentTypeEnumKey, type RefusalContent, type RefusalContentParam, type RefusalContentParamTypeEnumKey, type RefusalContentTypeEnumKey, type ResponseCompletedStreamingEvent, type ResponseCompletedStreamingEventTypeEnumKey, type ResponseContentPartAddedStreamingEvent, type ResponseContentPartAddedStreamingEventTypeEnumKey, type ResponseContentPartDoneStreamingEvent, type ResponseContentPartDoneStreamingEventTypeEnumKey, type ResponseCreatedStreamingEvent, type ResponseCreatedStreamingEventTypeEnumKey, type ResponseFailedStreamingEvent, type ResponseFailedStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDeltaStreamingEvent, type ResponseFunctionCallArgumentsDeltaStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDoneStreamingEvent, type ResponseFunctionCallArgumentsDoneStreamingEventTypeEnumKey, type ResponseInProgressStreamingEvent, type ResponseInProgressStreamingEventTypeEnumKey, type ResponseIncompleteStreamingEvent, type ResponseIncompleteStreamingEventTypeEnumKey, type ResponseOutputItemAddedStreamingEvent, type ResponseOutputItemAddedStreamingEventTypeEnumKey, type ResponseOutputItemDoneStreamingEvent, type ResponseOutputItemDoneStreamingEventTypeEnumKey, type ResponseOutputTextAnnotationAddedStreamingEvent, type ResponseOutputTextAnnotationAddedStreamingEventTypeEnumKey, type ResponseOutputTextDeltaStreamingEvent, type ResponseOutputTextDeltaStreamingEventTypeEnumKey, type ResponseOutputTextDoneStreamingEvent, type ResponseOutputTextDoneStreamingEventTypeEnumKey, type ResponseQueuedStreamingEvent, type ResponseQueuedStreamingEventTypeEnumKey, type ResponseReasoningDeltaStreamingEvent, type ResponseReasoningDeltaStreamingEventTypeEnumKey, type ResponseReasoningDoneStreamingEvent, type ResponseReasoningDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryDeltaStreamingEvent, type ResponseReasoningSummaryDeltaStreamingEventTypeEnumKey, type ResponseReasoningSummaryDoneStreamingEvent, type ResponseReasoningSummaryDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartAddedStreamingEvent, type ResponseReasoningSummaryPartAddedStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartDoneStreamingEvent, type ResponseReasoningSummaryPartDoneStreamingEventTypeEnumKey, type ResponseRefusalDeltaStreamingEvent, type ResponseRefusalDeltaStreamingEventTypeEnumKey, type ResponseRefusalDoneStreamingEvent, type ResponseRefusalDoneStreamingEventTypeEnumKey, type ResponseResource, type ResponseResourceObjectEnumKey, type ResponsesToolParam, type ServiceTierEnum, type ServiceTierEnumEnumKey, type SpecificFunctionParam, type SpecificFunctionParamTypeEnumKey, type SpecificToolChoiceParam, type StreamOptionsParam, type SummaryTextContent, type SummaryTextContentTypeEnumKey, type SystemMessageItemParam, type SystemMessageItemParamRoleEnumKey, type SystemMessageItemParamTypeEnumKey, TekimaxClient, TekimaxResponse, type TextContent, type TextContentTypeEnumKey, type TextField, type TextFormatParam, type TextParam, type TextResponseFormat, type TextResponseFormatTypeEnumKey, type Tool, type ToolChoiceParam, type ToolChoiceValueEnum, type ToolChoiceValueEnumEnumKey, type TopLogProb, type TruncationEnum, type TruncationEnumEnumKey, type UrlCitationBody, type UrlCitationBodyTypeEnumKey, type UrlCitationParam, type UrlCitationParamTypeEnumKey, type Usage, type UserMessageItemParam, type UserMessageItemParamRoleEnumKey, type UserMessageItemParamTypeEnumKey, type VerbosityEnum, type VerbosityEnumEnumKey, allowedToolChoiceSchema, allowedToolChoiceTypeEnum, allowedToolsParamSchema, allowedToolsParamTypeEnum, annotationSchema, assistantMessageItemParamRoleEnum, assistantMessageItemParamSchema, assistantMessageItemParamTypeEnum, createResponseBodySchema, createresponse200Schema, createresponseMutationRequestSchema, createresponseMutationResponseSchema, detailEnumEnum, detailEnumSchema, developerMessageItemParamRoleEnum, developerMessageItemParamSchema, developerMessageItemParamTypeEnum, emptyModelParamSchema, errorPayloadSchema, errorSchema, errorStreamingEventSchema, errorStreamingEventTypeEnum, functionCallItemParamSchema, functionCallItemParamTypeEnum, functionCallItemStatusEnum, functionCallItemStatusSchema, functionCallOutputItemParamSchema, functionCallOutputItemParamTypeEnum, functionCallOutputSchema, functionCallOutputStatusEnumEnum, functionCallOutputStatusEnumSchema, functionCallOutputTypeEnum, functionCallSchema, functionCallStatusEnum, functionCallStatusSchema, functionCallTypeEnum, functionToolChoiceSchema, functionToolChoiceTypeEnum, functionToolParamSchema, functionToolParamTypeEnum, functionToolSchema, functionToolTypeEnum, imageDetailEnum, imageDetailSchema, includeEnumEnum, includeEnumSchema, incompleteDetailsSchema, inputFileContentParamSchema, inputFileContentParamTypeEnum, inputFileContentSchema, inputFileContentTypeEnum, inputImageContentParamAutoParamSchema, inputImageContentParamAutoParamTypeEnum, inputImageContentSchema, inputImageContentTypeEnum, inputTextContentParamSchema, inputTextContentParamTypeEnum, inputTextContentSchema, inputTextContentTypeEnum, inputTokensDetailsSchema, inputVideoContentSchema, inputVideoContentTypeEnum, itemFieldSchema, itemParamSchema, itemReferenceParamSchema, itemReferenceParamTypeEnum, jsonObjectResponseFormatSchema, jsonObjectResponseFormatTypeEnum, jsonSchemaResponseFormatParamSchema, jsonSchemaResponseFormatParamTypeEnum, jsonSchemaResponseFormatSchema, jsonSchemaResponseFormatTypeEnum, logProbSchema, messageRoleEnum, messageRoleSchema, messageSchema, messageStatusEnum, messageStatusSchema, messageTypeEnum, metadataParamSchema, outputTextContentParamSchema, outputTextContentParamTypeEnum, outputTextContentSchema, outputTextContentTypeEnum, outputTokensDetailsSchema, reasoningBodySchema, reasoningBodyTypeEnum, reasoningEffortEnumEnum, reasoningEffortEnumSchema, reasoningItemParamSchema, reasoningItemParamTypeEnum, reasoningParamSchema, reasoningSchema, reasoningSummaryContentParamSchema, reasoningSummaryContentParamTypeEnum, reasoningSummaryEnumEnum, reasoningSummaryEnumSchema, reasoningTextContentSchema, reasoningTextContentTypeEnum, refusalContentParamSchema, refusalContentParamTypeEnum, refusalContentSchema, refusalContentTypeEnum, responseCompletedStreamingEventSchema, responseCompletedStreamingEventTypeEnum, responseContentPartAddedStreamingEventSchema, responseContentPartAddedStreamingEventTypeEnum, responseContentPartDoneStreamingEventSchema, responseContentPartDoneStreamingEventTypeEnum, responseCreatedStreamingEventSchema, responseCreatedStreamingEventTypeEnum, responseFailedStreamingEventSchema, responseFailedStreamingEventTypeEnum, responseFunctionCallArgumentsDeltaStreamingEventSchema, responseFunctionCallArgumentsDeltaStreamingEventTypeEnum, responseFunctionCallArgumentsDoneStreamingEventSchema, responseFunctionCallArgumentsDoneStreamingEventTypeEnum, responseInProgressStreamingEventSchema, responseInProgressStreamingEventTypeEnum, responseIncompleteStreamingEventSchema, responseIncompleteStreamingEventTypeEnum, responseOutputItemAddedStreamingEventSchema, responseOutputItemAddedStreamingEventTypeEnum, responseOutputItemDoneStreamingEventSchema, responseOutputItemDoneStreamingEventTypeEnum, responseOutputTextAnnotationAddedStreamingEventSchema, responseOutputTextAnnotationAddedStreamingEventTypeEnum, responseOutputTextDeltaStreamingEventSchema, responseOutputTextDeltaStreamingEventTypeEnum, responseOutputTextDoneStreamingEventSchema, responseOutputTextDoneStreamingEventTypeEnum, responseQueuedStreamingEventSchema, responseQueuedStreamingEventTypeEnum, responseReasoningDeltaStreamingEventSchema, responseReasoningDeltaStreamingEventTypeEnum, responseReasoningDoneStreamingEventSchema, responseReasoningDoneStreamingEventTypeEnum, responseReasoningSummaryDeltaStreamingEventSchema, responseReasoningSummaryDeltaStreamingEventTypeEnum, responseReasoningSummaryDoneStreamingEventSchema, responseReasoningSummaryDoneStreamingEventTypeEnum, responseReasoningSummaryPartAddedStreamingEventSchema, responseReasoningSummaryPartAddedStreamingEventTypeEnum, responseReasoningSummaryPartDoneStreamingEventSchema, responseReasoningSummaryPartDoneStreamingEventTypeEnum, responseRefusalDeltaStreamingEventSchema, responseRefusalDeltaStreamingEventTypeEnum, responseRefusalDoneStreamingEventSchema, responseRefusalDoneStreamingEventTypeEnum, responseResourceObjectEnum, responseResourceSchema, responsesToolParamSchema, serviceTierEnumEnum, serviceTierEnumSchema, specificFunctionParamSchema, specificFunctionParamTypeEnum, specificToolChoiceParamSchema, streamOptionsParamSchema, summaryTextContentSchema, summaryTextContentTypeEnum, systemMessageItemParamRoleEnum, systemMessageItemParamSchema, systemMessageItemParamTypeEnum, textContentSchema, textContentTypeEnum, textFieldSchema, textFormatParamSchema, textParamSchema, textResponseFormatSchema, textResponseFormatTypeEnum, toolChoiceParamSchema, toolChoiceValueEnumEnum, toolChoiceValueEnumSchema, toolSchema, topLogProbSchema, truncationEnumEnum, truncationEnumSchema, urlCitationBodySchema, urlCitationBodyTypeEnum, urlCitationParamSchema, urlCitationParamTypeEnum, usageSchema, userMessageItemParamRoleEnum, userMessageItemParamSchema, userMessageItemParamTypeEnum, verbosityEnumEnum, verbosityEnumSchema };

package/dist/index.d.ts

@@ -31633,16 +31633,80 @@ declare const userMessageItemParamSchema: z.ZodObject<{
 
 declare const verbosityEnumSchema: z.ZodEnum<["low", "medium", "high"]>;
 
+/**
+ * A wrapper around the raw API response that provides helper methods
+ * for common tasks like extracting text content.
+ */
+declare class TekimaxResponse {
+    private readonly _raw;
+    constructor(_raw: ResponseResource);
+    /**
+     * Access the raw response object returned by the API.
+     */
+    get raw(): ResponseResource;
+    /**
+     * Automatically extracts the text content from the response.
+     * It looks for the first "output_text" item in the response content.
+     */
+    get text(): string | undefined;
+    /**
+     * The ID of the response.
+     */
+    get id(): string | undefined;
+    /**
+     * The model used to generate the response.
+     */
+    get model(): string | undefined;
+}
+/**
+ * Options for sending a message or creating a session.
+ */
+type MessageOptions = Omit<CreateResponseBody, "input" | "stream">;
+/**
+ * The main client for interacting with the Tekimax API.
+ */
 declare class TekimaxClient {
     private baseUrl;
     private headers;
+    /**
+     * Creates a new TekimaxClient.
+     *
+     * @param options - Configuration options for the client.
+     * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+     * @param options.apiKey - Your Tekimax API key.
+     *
+     * @example
+     * const client = new TekimaxClient({ apiKey: "tm_..." });
+     */
     constructor(options?: {
         baseUrl?: string;
         apiKey?: string;
     });
     private request;
-    createSession(body: CreateResponseBody): Promise<ResponseResource>;
-    sendMessage(body: CreateResponseBody): Promise<ResponseResource>;
+    /**
+     * Creates a new session and sends the initial message.
+     *
+     * @param message - The initial message text to start the session.
+     * @param options - Additional configuration options (model, temperature, etc.).
+     *
+     * @example
+     * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+     * console.log(response.text);
+     */
+    createSession(message: string, options?: MessageOptions): Promise<TekimaxResponse>;
+    /**
+     * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+     *
+     * @param message - The message text to send.
+     * @param options - Additional configuration options.
+     *
+     * @example
+     * const response = await client.sendMessage("What is the weather?", {
+     *   previous_response_id: "resp_123"
+     * });
+     * console.log(response.text);
+     */
+    sendMessage(message: string, options?: MessageOptions): Promise<TekimaxResponse>;
 }
 
-export { type AllowedToolChoice, type AllowedToolChoiceTypeEnumKey, type AllowedToolsParam, type AllowedToolsParamTypeEnumKey, type Annotation, type AssistantMessageItemParam, type AssistantMessageItemParamRoleEnumKey, type AssistantMessageItemParamTypeEnumKey, type CreateResponseBody, type Createresponse200, type CreateresponseMutation, type CreateresponseMutationRequest, type CreateresponseMutationResponse, type DetailEnum, type DetailEnumEnumKey, type DeveloperMessageItemParam, type DeveloperMessageItemParamRoleEnumKey, type DeveloperMessageItemParamTypeEnumKey, type EmptyModelParam, type Error, type ErrorPayload, type ErrorStreamingEvent, type ErrorStreamingEventTypeEnumKey, type FunctionCall, type FunctionCallItemParam, type FunctionCallItemParamTypeEnumKey, type FunctionCallItemStatus, type FunctionCallItemStatusEnumKey, type FunctionCallOutput, type FunctionCallOutputItemParam, type FunctionCallOutputItemParamTypeEnumKey, type FunctionCallOutputStatusEnum, type FunctionCallOutputStatusEnumEnumKey, type FunctionCallOutputTypeEnumKey, type FunctionCallStatus, type FunctionCallStatusEnumKey, type FunctionCallTypeEnumKey, type FunctionTool, type FunctionToolChoice, type FunctionToolChoiceTypeEnumKey, type FunctionToolParam, type FunctionToolParamTypeEnumKey, type FunctionToolTypeEnumKey, type ImageDetail, type ImageDetailEnumKey, type IncludeEnum, type IncludeEnumEnumKey, type IncompleteDetails, type InputFileContent, type InputFileContentParam, type InputFileContentParamTypeEnumKey, type InputFileContentTypeEnumKey, type InputImageContent, type InputImageContentParamAutoParam, type InputImageContentParamAutoParamTypeEnumKey, type InputImageContentTypeEnumKey, type InputTextContent, type InputTextContentParam, type InputTextContentParamTypeEnumKey, type InputTextContentTypeEnumKey, type InputTokensDetails, type InputVideoContent, type InputVideoContentTypeEnumKey, type ItemField, type ItemParam, type ItemReferenceParam, type ItemReferenceParamTypeEnumKey, type JsonObjectResponseFormat, type JsonObjectResponseFormatTypeEnumKey, type JsonSchemaResponseFormat, type JsonSchemaResponseFormatParam, type JsonSchemaResponseFormatParamTypeEnumKey, type JsonSchemaResponseFormatTypeEnumKey, type LogProb, type Message, type MessageRole, type MessageRoleEnumKey, type MessageStatus, type MessageStatusEnumKey, type MessageTypeEnumKey, type MetadataParam, type OutputTextContent, type OutputTextContentParam, type OutputTextContentParamTypeEnumKey, type OutputTextContentTypeEnumKey, type OutputTokensDetails, type Reasoning, type ReasoningBody, type ReasoningBodyTypeEnumKey, type ReasoningEffortEnum, type ReasoningEffortEnumEnumKey, type ReasoningItemParam, type ReasoningItemParamTypeEnumKey, type ReasoningParam, type ReasoningSummaryContentParam, type ReasoningSummaryContentParamTypeEnumKey, type ReasoningSummaryEnum, type ReasoningSummaryEnumEnumKey, type ReasoningTextContent, type ReasoningTextContentTypeEnumKey, type RefusalContent, type RefusalContentParam, type RefusalContentParamTypeEnumKey, type RefusalContentTypeEnumKey, type ResponseCompletedStreamingEvent, type ResponseCompletedStreamingEventTypeEnumKey, type ResponseContentPartAddedStreamingEvent, type ResponseContentPartAddedStreamingEventTypeEnumKey, type ResponseContentPartDoneStreamingEvent, type ResponseContentPartDoneStreamingEventTypeEnumKey, type ResponseCreatedStreamingEvent, type ResponseCreatedStreamingEventTypeEnumKey, type ResponseFailedStreamingEvent, type ResponseFailedStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDeltaStreamingEvent, type ResponseFunctionCallArgumentsDeltaStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDoneStreamingEvent, type ResponseFunctionCallArgumentsDoneStreamingEventTypeEnumKey, type ResponseInProgressStreamingEvent, type ResponseInProgressStreamingEventTypeEnumKey, type ResponseIncompleteStreamingEvent, type ResponseIncompleteStreamingEventTypeEnumKey, type ResponseOutputItemAddedStreamingEvent, type ResponseOutputItemAddedStreamingEventTypeEnumKey, type ResponseOutputItemDoneStreamingEvent, type ResponseOutputItemDoneStreamingEventTypeEnumKey, type ResponseOutputTextAnnotationAddedStreamingEvent, type ResponseOutputTextAnnotationAddedStreamingEventTypeEnumKey, type ResponseOutputTextDeltaStreamingEvent, type ResponseOutputTextDeltaStreamingEventTypeEnumKey, type ResponseOutputTextDoneStreamingEvent, type ResponseOutputTextDoneStreamingEventTypeEnumKey, type ResponseQueuedStreamingEvent, type ResponseQueuedStreamingEventTypeEnumKey, type ResponseReasoningDeltaStreamingEvent, type ResponseReasoningDeltaStreamingEventTypeEnumKey, type ResponseReasoningDoneStreamingEvent, type ResponseReasoningDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryDeltaStreamingEvent, type ResponseReasoningSummaryDeltaStreamingEventTypeEnumKey, type ResponseReasoningSummaryDoneStreamingEvent, type ResponseReasoningSummaryDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartAddedStreamingEvent, type ResponseReasoningSummaryPartAddedStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartDoneStreamingEvent, type ResponseReasoningSummaryPartDoneStreamingEventTypeEnumKey, type ResponseRefusalDeltaStreamingEvent, type ResponseRefusalDeltaStreamingEventTypeEnumKey, type ResponseRefusalDoneStreamingEvent, type ResponseRefusalDoneStreamingEventTypeEnumKey, type ResponseResource, type ResponseResourceObjectEnumKey, type ResponsesToolParam, type ServiceTierEnum, type ServiceTierEnumEnumKey, type SpecificFunctionParam, type SpecificFunctionParamTypeEnumKey, type SpecificToolChoiceParam, type StreamOptionsParam, type SummaryTextContent, type SummaryTextContentTypeEnumKey, type SystemMessageItemParam, type SystemMessageItemParamRoleEnumKey, type SystemMessageItemParamTypeEnumKey, TekimaxClient, type TextContent, type TextContentTypeEnumKey, type TextField, type TextFormatParam, type TextParam, type TextResponseFormat, type TextResponseFormatTypeEnumKey, type Tool, type ToolChoiceParam, type ToolChoiceValueEnum, type ToolChoiceValueEnumEnumKey, type TopLogProb, type TruncationEnum, type TruncationEnumEnumKey, type UrlCitationBody, type UrlCitationBodyTypeEnumKey, type UrlCitationParam, type UrlCitationParamTypeEnumKey, type Usage, type UserMessageItemParam, type UserMessageItemParamRoleEnumKey, type UserMessageItemParamTypeEnumKey, type VerbosityEnum, type VerbosityEnumEnumKey, allowedToolChoiceSchema, allowedToolChoiceTypeEnum, allowedToolsParamSchema, allowedToolsParamTypeEnum, annotationSchema, assistantMessageItemParamRoleEnum, assistantMessageItemParamSchema, assistantMessageItemParamTypeEnum, createResponseBodySchema, createresponse200Schema, createresponseMutationRequestSchema, createresponseMutationResponseSchema, detailEnumEnum, detailEnumSchema, developerMessageItemParamRoleEnum, developerMessageItemParamSchema, developerMessageItemParamTypeEnum, emptyModelParamSchema, errorPayloadSchema, errorSchema, errorStreamingEventSchema, errorStreamingEventTypeEnum, functionCallItemParamSchema, functionCallItemParamTypeEnum, functionCallItemStatusEnum, functionCallItemStatusSchema, functionCallOutputItemParamSchema, functionCallOutputItemParamTypeEnum, functionCallOutputSchema, functionCallOutputStatusEnumEnum, functionCallOutputStatusEnumSchema, functionCallOutputTypeEnum, functionCallSchema, functionCallStatusEnum, functionCallStatusSchema, functionCallTypeEnum, functionToolChoiceSchema, functionToolChoiceTypeEnum, functionToolParamSchema, functionToolParamTypeEnum, functionToolSchema, functionToolTypeEnum, imageDetailEnum, imageDetailSchema, includeEnumEnum, includeEnumSchema, incompleteDetailsSchema, inputFileContentParamSchema, inputFileContentParamTypeEnum, inputFileContentSchema, inputFileContentTypeEnum, inputImageContentParamAutoParamSchema, inputImageContentParamAutoParamTypeEnum, inputImageContentSchema, inputImageContentTypeEnum, inputTextContentParamSchema, inputTextContentParamTypeEnum, inputTextContentSchema, inputTextContentTypeEnum, inputTokensDetailsSchema, inputVideoContentSchema, inputVideoContentTypeEnum, itemFieldSchema, itemParamSchema, itemReferenceParamSchema, itemReferenceParamTypeEnum, jsonObjectResponseFormatSchema, jsonObjectResponseFormatTypeEnum, jsonSchemaResponseFormatParamSchema, jsonSchemaResponseFormatParamTypeEnum, jsonSchemaResponseFormatSchema, jsonSchemaResponseFormatTypeEnum, logProbSchema, messageRoleEnum, messageRoleSchema, messageSchema, messageStatusEnum, messageStatusSchema, messageTypeEnum, metadataParamSchema, outputTextContentParamSchema, outputTextContentParamTypeEnum, outputTextContentSchema, outputTextContentTypeEnum, outputTokensDetailsSchema, reasoningBodySchema, reasoningBodyTypeEnum, reasoningEffortEnumEnum, reasoningEffortEnumSchema, reasoningItemParamSchema, reasoningItemParamTypeEnum, reasoningParamSchema, reasoningSchema, reasoningSummaryContentParamSchema, reasoningSummaryContentParamTypeEnum, reasoningSummaryEnumEnum, reasoningSummaryEnumSchema, reasoningTextContentSchema, reasoningTextContentTypeEnum, refusalContentParamSchema, refusalContentParamTypeEnum, refusalContentSchema, refusalContentTypeEnum, responseCompletedStreamingEventSchema, responseCompletedStreamingEventTypeEnum, responseContentPartAddedStreamingEventSchema, responseContentPartAddedStreamingEventTypeEnum, responseContentPartDoneStreamingEventSchema, responseContentPartDoneStreamingEventTypeEnum, responseCreatedStreamingEventSchema, responseCreatedStreamingEventTypeEnum, responseFailedStreamingEventSchema, responseFailedStreamingEventTypeEnum, responseFunctionCallArgumentsDeltaStreamingEventSchema, responseFunctionCallArgumentsDeltaStreamingEventTypeEnum, responseFunctionCallArgumentsDoneStreamingEventSchema, responseFunctionCallArgumentsDoneStreamingEventTypeEnum, responseInProgressStreamingEventSchema, responseInProgressStreamingEventTypeEnum, responseIncompleteStreamingEventSchema, responseIncompleteStreamingEventTypeEnum, responseOutputItemAddedStreamingEventSchema, responseOutputItemAddedStreamingEventTypeEnum, responseOutputItemDoneStreamingEventSchema, responseOutputItemDoneStreamingEventTypeEnum, responseOutputTextAnnotationAddedStreamingEventSchema, responseOutputTextAnnotationAddedStreamingEventTypeEnum, responseOutputTextDeltaStreamingEventSchema, responseOutputTextDeltaStreamingEventTypeEnum, responseOutputTextDoneStreamingEventSchema, responseOutputTextDoneStreamingEventTypeEnum, responseQueuedStreamingEventSchema, responseQueuedStreamingEventTypeEnum, responseReasoningDeltaStreamingEventSchema, responseReasoningDeltaStreamingEventTypeEnum, responseReasoningDoneStreamingEventSchema, responseReasoningDoneStreamingEventTypeEnum, responseReasoningSummaryDeltaStreamingEventSchema, responseReasoningSummaryDeltaStreamingEventTypeEnum, responseReasoningSummaryDoneStreamingEventSchema, responseReasoningSummaryDoneStreamingEventTypeEnum, responseReasoningSummaryPartAddedStreamingEventSchema, responseReasoningSummaryPartAddedStreamingEventTypeEnum, responseReasoningSummaryPartDoneStreamingEventSchema, responseReasoningSummaryPartDoneStreamingEventTypeEnum, responseRefusalDeltaStreamingEventSchema, responseRefusalDeltaStreamingEventTypeEnum, responseRefusalDoneStreamingEventSchema, responseRefusalDoneStreamingEventTypeEnum, responseResourceObjectEnum, responseResourceSchema, responsesToolParamSchema, serviceTierEnumEnum, serviceTierEnumSchema, specificFunctionParamSchema, specificFunctionParamTypeEnum, specificToolChoiceParamSchema, streamOptionsParamSchema, summaryTextContentSchema, summaryTextContentTypeEnum, systemMessageItemParamRoleEnum, systemMessageItemParamSchema, systemMessageItemParamTypeEnum, textContentSchema, textContentTypeEnum, textFieldSchema, textFormatParamSchema, textParamSchema, textResponseFormatSchema, textResponseFormatTypeEnum, toolChoiceParamSchema, toolChoiceValueEnumEnum, toolChoiceValueEnumSchema, toolSchema, topLogProbSchema, truncationEnumEnum, truncationEnumSchema, urlCitationBodySchema, urlCitationBodyTypeEnum, urlCitationParamSchema, urlCitationParamTypeEnum, usageSchema, userMessageItemParamRoleEnum, userMessageItemParamSchema, userMessageItemParamTypeEnum, verbosityEnumEnum, verbosityEnumSchema };
+export { type AllowedToolChoice, type AllowedToolChoiceTypeEnumKey, type AllowedToolsParam, type AllowedToolsParamTypeEnumKey, type Annotation, type AssistantMessageItemParam, type AssistantMessageItemParamRoleEnumKey, type AssistantMessageItemParamTypeEnumKey, type CreateResponseBody, type Createresponse200, type CreateresponseMutation, type CreateresponseMutationRequest, type CreateresponseMutationResponse, type DetailEnum, type DetailEnumEnumKey, type DeveloperMessageItemParam, type DeveloperMessageItemParamRoleEnumKey, type DeveloperMessageItemParamTypeEnumKey, type EmptyModelParam, type Error, type ErrorPayload, type ErrorStreamingEvent, type ErrorStreamingEventTypeEnumKey, type FunctionCall, type FunctionCallItemParam, type FunctionCallItemParamTypeEnumKey, type FunctionCallItemStatus, type FunctionCallItemStatusEnumKey, type FunctionCallOutput, type FunctionCallOutputItemParam, type FunctionCallOutputItemParamTypeEnumKey, type FunctionCallOutputStatusEnum, type FunctionCallOutputStatusEnumEnumKey, type FunctionCallOutputTypeEnumKey, type FunctionCallStatus, type FunctionCallStatusEnumKey, type FunctionCallTypeEnumKey, type FunctionTool, type FunctionToolChoice, type FunctionToolChoiceTypeEnumKey, type FunctionToolParam, type FunctionToolParamTypeEnumKey, type FunctionToolTypeEnumKey, type ImageDetail, type ImageDetailEnumKey, type IncludeEnum, type IncludeEnumEnumKey, type IncompleteDetails, type InputFileContent, type InputFileContentParam, type InputFileContentParamTypeEnumKey, type InputFileContentTypeEnumKey, type InputImageContent, type InputImageContentParamAutoParam, type InputImageContentParamAutoParamTypeEnumKey, type InputImageContentTypeEnumKey, type InputTextContent, type InputTextContentParam, type InputTextContentParamTypeEnumKey, type InputTextContentTypeEnumKey, type InputTokensDetails, type InputVideoContent, type InputVideoContentTypeEnumKey, type ItemField, type ItemParam, type ItemReferenceParam, type ItemReferenceParamTypeEnumKey, type JsonObjectResponseFormat, type JsonObjectResponseFormatTypeEnumKey, type JsonSchemaResponseFormat, type JsonSchemaResponseFormatParam, type JsonSchemaResponseFormatParamTypeEnumKey, type JsonSchemaResponseFormatTypeEnumKey, type LogProb, type Message, type MessageRole, type MessageRoleEnumKey, type MessageStatus, type MessageStatusEnumKey, type MessageTypeEnumKey, type MetadataParam, type OutputTextContent, type OutputTextContentParam, type OutputTextContentParamTypeEnumKey, type OutputTextContentTypeEnumKey, type OutputTokensDetails, type Reasoning, type ReasoningBody, type ReasoningBodyTypeEnumKey, type ReasoningEffortEnum, type ReasoningEffortEnumEnumKey, type ReasoningItemParam, type ReasoningItemParamTypeEnumKey, type ReasoningParam, type ReasoningSummaryContentParam, type ReasoningSummaryContentParamTypeEnumKey, type ReasoningSummaryEnum, type ReasoningSummaryEnumEnumKey, type ReasoningTextContent, type ReasoningTextContentTypeEnumKey, type RefusalContent, type RefusalContentParam, type RefusalContentParamTypeEnumKey, type RefusalContentTypeEnumKey, type ResponseCompletedStreamingEvent, type ResponseCompletedStreamingEventTypeEnumKey, type ResponseContentPartAddedStreamingEvent, type ResponseContentPartAddedStreamingEventTypeEnumKey, type ResponseContentPartDoneStreamingEvent, type ResponseContentPartDoneStreamingEventTypeEnumKey, type ResponseCreatedStreamingEvent, type ResponseCreatedStreamingEventTypeEnumKey, type ResponseFailedStreamingEvent, type ResponseFailedStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDeltaStreamingEvent, type ResponseFunctionCallArgumentsDeltaStreamingEventTypeEnumKey, type ResponseFunctionCallArgumentsDoneStreamingEvent, type ResponseFunctionCallArgumentsDoneStreamingEventTypeEnumKey, type ResponseInProgressStreamingEvent, type ResponseInProgressStreamingEventTypeEnumKey, type ResponseIncompleteStreamingEvent, type ResponseIncompleteStreamingEventTypeEnumKey, type ResponseOutputItemAddedStreamingEvent, type ResponseOutputItemAddedStreamingEventTypeEnumKey, type ResponseOutputItemDoneStreamingEvent, type ResponseOutputItemDoneStreamingEventTypeEnumKey, type ResponseOutputTextAnnotationAddedStreamingEvent, type ResponseOutputTextAnnotationAddedStreamingEventTypeEnumKey, type ResponseOutputTextDeltaStreamingEvent, type ResponseOutputTextDeltaStreamingEventTypeEnumKey, type ResponseOutputTextDoneStreamingEvent, type ResponseOutputTextDoneStreamingEventTypeEnumKey, type ResponseQueuedStreamingEvent, type ResponseQueuedStreamingEventTypeEnumKey, type ResponseReasoningDeltaStreamingEvent, type ResponseReasoningDeltaStreamingEventTypeEnumKey, type ResponseReasoningDoneStreamingEvent, type ResponseReasoningDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryDeltaStreamingEvent, type ResponseReasoningSummaryDeltaStreamingEventTypeEnumKey, type ResponseReasoningSummaryDoneStreamingEvent, type ResponseReasoningSummaryDoneStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartAddedStreamingEvent, type ResponseReasoningSummaryPartAddedStreamingEventTypeEnumKey, type ResponseReasoningSummaryPartDoneStreamingEvent, type ResponseReasoningSummaryPartDoneStreamingEventTypeEnumKey, type ResponseRefusalDeltaStreamingEvent, type ResponseRefusalDeltaStreamingEventTypeEnumKey, type ResponseRefusalDoneStreamingEvent, type ResponseRefusalDoneStreamingEventTypeEnumKey, type ResponseResource, type ResponseResourceObjectEnumKey, type ResponsesToolParam, type ServiceTierEnum, type ServiceTierEnumEnumKey, type SpecificFunctionParam, type SpecificFunctionParamTypeEnumKey, type SpecificToolChoiceParam, type StreamOptionsParam, type SummaryTextContent, type SummaryTextContentTypeEnumKey, type SystemMessageItemParam, type SystemMessageItemParamRoleEnumKey, type SystemMessageItemParamTypeEnumKey, TekimaxClient, TekimaxResponse, type TextContent, type TextContentTypeEnumKey, type TextField, type TextFormatParam, type TextParam, type TextResponseFormat, type TextResponseFormatTypeEnumKey, type Tool, type ToolChoiceParam, type ToolChoiceValueEnum, type ToolChoiceValueEnumEnumKey, type TopLogProb, type TruncationEnum, type TruncationEnumEnumKey, type UrlCitationBody, type UrlCitationBodyTypeEnumKey, type UrlCitationParam, type UrlCitationParamTypeEnumKey, type Usage, type UserMessageItemParam, type UserMessageItemParamRoleEnumKey, type UserMessageItemParamTypeEnumKey, type VerbosityEnum, type VerbosityEnumEnumKey, allowedToolChoiceSchema, allowedToolChoiceTypeEnum, allowedToolsParamSchema, allowedToolsParamTypeEnum, annotationSchema, assistantMessageItemParamRoleEnum, assistantMessageItemParamSchema, assistantMessageItemParamTypeEnum, createResponseBodySchema, createresponse200Schema, createresponseMutationRequestSchema, createresponseMutationResponseSchema, detailEnumEnum, detailEnumSchema, developerMessageItemParamRoleEnum, developerMessageItemParamSchema, developerMessageItemParamTypeEnum, emptyModelParamSchema, errorPayloadSchema, errorSchema, errorStreamingEventSchema, errorStreamingEventTypeEnum, functionCallItemParamSchema, functionCallItemParamTypeEnum, functionCallItemStatusEnum, functionCallItemStatusSchema, functionCallOutputItemParamSchema, functionCallOutputItemParamTypeEnum, functionCallOutputSchema, functionCallOutputStatusEnumEnum, functionCallOutputStatusEnumSchema, functionCallOutputTypeEnum, functionCallSchema, functionCallStatusEnum, functionCallStatusSchema, functionCallTypeEnum, functionToolChoiceSchema, functionToolChoiceTypeEnum, functionToolParamSchema, functionToolParamTypeEnum, functionToolSchema, functionToolTypeEnum, imageDetailEnum, imageDetailSchema, includeEnumEnum, includeEnumSchema, incompleteDetailsSchema, inputFileContentParamSchema, inputFileContentParamTypeEnum, inputFileContentSchema, inputFileContentTypeEnum, inputImageContentParamAutoParamSchema, inputImageContentParamAutoParamTypeEnum, inputImageContentSchema, inputImageContentTypeEnum, inputTextContentParamSchema, inputTextContentParamTypeEnum, inputTextContentSchema, inputTextContentTypeEnum, inputTokensDetailsSchema, inputVideoContentSchema, inputVideoContentTypeEnum, itemFieldSchema, itemParamSchema, itemReferenceParamSchema, itemReferenceParamTypeEnum, jsonObjectResponseFormatSchema, jsonObjectResponseFormatTypeEnum, jsonSchemaResponseFormatParamSchema, jsonSchemaResponseFormatParamTypeEnum, jsonSchemaResponseFormatSchema, jsonSchemaResponseFormatTypeEnum, logProbSchema, messageRoleEnum, messageRoleSchema, messageSchema, messageStatusEnum, messageStatusSchema, messageTypeEnum, metadataParamSchema, outputTextContentParamSchema, outputTextContentParamTypeEnum, outputTextContentSchema, outputTextContentTypeEnum, outputTokensDetailsSchema, reasoningBodySchema, reasoningBodyTypeEnum, reasoningEffortEnumEnum, reasoningEffortEnumSchema, reasoningItemParamSchema, reasoningItemParamTypeEnum, reasoningParamSchema, reasoningSchema, reasoningSummaryContentParamSchema, reasoningSummaryContentParamTypeEnum, reasoningSummaryEnumEnum, reasoningSummaryEnumSchema, reasoningTextContentSchema, reasoningTextContentTypeEnum, refusalContentParamSchema, refusalContentParamTypeEnum, refusalContentSchema, refusalContentTypeEnum, responseCompletedStreamingEventSchema, responseCompletedStreamingEventTypeEnum, responseContentPartAddedStreamingEventSchema, responseContentPartAddedStreamingEventTypeEnum, responseContentPartDoneStreamingEventSchema, responseContentPartDoneStreamingEventTypeEnum, responseCreatedStreamingEventSchema, responseCreatedStreamingEventTypeEnum, responseFailedStreamingEventSchema, responseFailedStreamingEventTypeEnum, responseFunctionCallArgumentsDeltaStreamingEventSchema, responseFunctionCallArgumentsDeltaStreamingEventTypeEnum, responseFunctionCallArgumentsDoneStreamingEventSchema, responseFunctionCallArgumentsDoneStreamingEventTypeEnum, responseInProgressStreamingEventSchema, responseInProgressStreamingEventTypeEnum, responseIncompleteStreamingEventSchema, responseIncompleteStreamingEventTypeEnum, responseOutputItemAddedStreamingEventSchema, responseOutputItemAddedStreamingEventTypeEnum, responseOutputItemDoneStreamingEventSchema, responseOutputItemDoneStreamingEventTypeEnum, responseOutputTextAnnotationAddedStreamingEventSchema, responseOutputTextAnnotationAddedStreamingEventTypeEnum, responseOutputTextDeltaStreamingEventSchema, responseOutputTextDeltaStreamingEventTypeEnum, responseOutputTextDoneStreamingEventSchema, responseOutputTextDoneStreamingEventTypeEnum, responseQueuedStreamingEventSchema, responseQueuedStreamingEventTypeEnum, responseReasoningDeltaStreamingEventSchema, responseReasoningDeltaStreamingEventTypeEnum, responseReasoningDoneStreamingEventSchema, responseReasoningDoneStreamingEventTypeEnum, responseReasoningSummaryDeltaStreamingEventSchema, responseReasoningSummaryDeltaStreamingEventTypeEnum, responseReasoningSummaryDoneStreamingEventSchema, responseReasoningSummaryDoneStreamingEventTypeEnum, responseReasoningSummaryPartAddedStreamingEventSchema, responseReasoningSummaryPartAddedStreamingEventTypeEnum, responseReasoningSummaryPartDoneStreamingEventSchema, responseReasoningSummaryPartDoneStreamingEventTypeEnum, responseRefusalDeltaStreamingEventSchema, responseRefusalDeltaStreamingEventTypeEnum, responseRefusalDoneStreamingEventSchema, responseRefusalDoneStreamingEventTypeEnum, responseResourceObjectEnum, responseResourceSchema, responsesToolParamSchema, serviceTierEnumEnum, serviceTierEnumSchema, specificFunctionParamSchema, specificFunctionParamTypeEnum, specificToolChoiceParamSchema, streamOptionsParamSchema, summaryTextContentSchema, summaryTextContentTypeEnum, systemMessageItemParamRoleEnum, systemMessageItemParamSchema, systemMessageItemParamTypeEnum, textContentSchema, textContentTypeEnum, textFieldSchema, textFormatParamSchema, textParamSchema, textResponseFormatSchema, textResponseFormatTypeEnum, toolChoiceParamSchema, toolChoiceValueEnumEnum, toolChoiceValueEnumSchema, toolSchema, topLogProbSchema, truncationEnumEnum, truncationEnumSchema, urlCitationBodySchema, urlCitationBodyTypeEnum, urlCitationParamSchema, urlCitationParamTypeEnum, usageSchema, userMessageItemParamRoleEnum, userMessageItemParamSchema, userMessageItemParamTypeEnum, verbosityEnumEnum, verbosityEnumSchema };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   TekimaxClient: () => TekimaxClient,
+  TekimaxResponse: () => TekimaxResponse,
   allowedToolChoiceSchema: () => allowedToolChoiceSchema,
   allowedToolChoiceTypeEnum: () => allowedToolChoiceTypeEnum,
   allowedToolsParamSchema: () => allowedToolsParamSchema,
@@ -1499,7 +1500,57 @@ var userMessageItemParamSchema = import_zod103.z.object({
 });
 
 // src/client.ts
+var TekimaxResponse = class {
+  constructor(_raw) {
+    this._raw = _raw;
+  }
+  /**
+   * Access the raw response object returned by the API.
+   */
+  get raw() {
+    return this._raw;
+  }
+  /**
+   * Automatically extracts the text content from the response.
+   * It looks for the first "output_text" item in the response content.
+   */
+  get text() {
+    if (!this._raw.output) return void 0;
+    for (const item of this._raw.output) {
+      if (item.type === "message") {
+        for (const contentPart of item.content) {
+          if (contentPart.type === "output_text" || contentPart.type === "text") {
+            return contentPart.text;
+          }
+        }
+      }
+    }
+    return void 0;
+  }
+  /**
+   * The ID of the response.
+   */
+  get id() {
+    return this._raw.id ?? void 0;
+  }
+  /**
+   * The model used to generate the response.
+   */
+  get model() {
+    return this._raw.model ?? void 0;
+  }
+};
 var TekimaxClient = class {
+  /**
+   * Creates a new TekimaxClient.
+   * 
+   * @param options - Configuration options for the client.
+   * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+   * @param options.apiKey - Your Tekimax API key.
+   * 
+   * @example
+   * const client = new TekimaxClient({ apiKey: "tm_..." });
+   */
   constructor(options = {}) {
     this.baseUrl = options.baseUrl || "https://api.tekimax.com";
     this.headers = {
@@ -1516,18 +1567,46 @@ var TekimaxClient = class {
     if (!response.ok) {
       throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
     }
-    return response.json();
+    const data = await response.json();
+    return new TekimaxResponse(data);
   }
-  async createSession(body) {
+  /**
+   * Creates a new session and sends the initial message.
+   * 
+   * @param message - The initial message text to start the session.
+   * @param options - Additional configuration options (model, temperature, etc.).
+   * 
+   * @example
+   * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+   * console.log(response.text);
+   */
+  async createSession(message, options) {
+    const body = {
+      ...options,
+      input: message
+    };
     return this.request("/responses", body);
   }
-  async sendMessage(body) {
-    return this.request("/responses", body);
+  /**
+   * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+   * 
+   * @param message - The message text to send.
+   * @param options - Additional configuration options.
+   * 
+   * @example
+   * const response = await client.sendMessage("What is the weather?", { 
+   *   previous_response_id: "resp_123" 
+   * });
+   * console.log(response.text);
+   */
+  async sendMessage(message, options) {
+    return this.createSession(message, options);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TekimaxClient,
+  TekimaxResponse,
   allowedToolChoiceSchema,
   allowedToolChoiceTypeEnum,
   allowedToolsParamSchema,

package/dist/index.mjs

@@ -1286,7 +1286,57 @@ var userMessageItemParamSchema = z103.object({
 });
 
 // src/client.ts
+var TekimaxResponse = class {
+  constructor(_raw) {
+    this._raw = _raw;
+  }
+  /**
+   * Access the raw response object returned by the API.
+   */
+  get raw() {
+    return this._raw;
+  }
+  /**
+   * Automatically extracts the text content from the response.
+   * It looks for the first "output_text" item in the response content.
+   */
+  get text() {
+    if (!this._raw.output) return void 0;
+    for (const item of this._raw.output) {
+      if (item.type === "message") {
+        for (const contentPart of item.content) {
+          if (contentPart.type === "output_text" || contentPart.type === "text") {
+            return contentPart.text;
+          }
+        }
+      }
+    }
+    return void 0;
+  }
+  /**
+   * The ID of the response.
+   */
+  get id() {
+    return this._raw.id ?? void 0;
+  }
+  /**
+   * The model used to generate the response.
+   */
+  get model() {
+    return this._raw.model ?? void 0;
+  }
+};
 var TekimaxClient = class {
+  /**
+   * Creates a new TekimaxClient.
+   * 
+   * @param options - Configuration options for the client.
+   * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+   * @param options.apiKey - Your Tekimax API key.
+   * 
+   * @example
+   * const client = new TekimaxClient({ apiKey: "tm_..." });
+   */
   constructor(options = {}) {
     this.baseUrl = options.baseUrl || "https://api.tekimax.com";
     this.headers = {
@@ -1303,17 +1353,45 @@ var TekimaxClient = class {
     if (!response.ok) {
       throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
     }
-    return response.json();
+    const data = await response.json();
+    return new TekimaxResponse(data);
   }
-  async createSession(body) {
+  /**
+   * Creates a new session and sends the initial message.
+   * 
+   * @param message - The initial message text to start the session.
+   * @param options - Additional configuration options (model, temperature, etc.).
+   * 
+   * @example
+   * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+   * console.log(response.text);
+   */
+  async createSession(message, options) {
+    const body = {
+      ...options,
+      input: message
+    };
     return this.request("/responses", body);
   }
-  async sendMessage(body) {
-    return this.request("/responses", body);
+  /**
+   * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+   * 
+   * @param message - The message text to send.
+   * @param options - Additional configuration options.
+   * 
+   * @example
+   * const response = await client.sendMessage("What is the weather?", { 
+   *   previous_response_id: "resp_123" 
+   * });
+   * console.log(response.text);
+   */
+  async sendMessage(message, options) {
+    return this.createSession(message, options);
   }
 };
 export {
   TekimaxClient,
+  TekimaxResponse,
   allowedToolChoiceSchema,
   allowedToolChoiceTypeEnum,
   allowedToolsParamSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tekimax-ts",
-    "version": "0.1.2",
+    "version": "0.1.4",
     "description": "Tekimax TypeScript SDK generated with Kubb",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/src/client.ts

@@ -1,9 +1,75 @@
-import { CreateResponseBody, ResponseResource } from "./gen/types";
+import { CreateResponseBody, ResponseResource, OutputTextContentParam } from "./gen/types";
 
+/**
+ * A wrapper around the raw API response that provides helper methods
+ * for common tasks like extracting text content.
+ */
+export class TekimaxResponse {
+    constructor(private readonly _raw: ResponseResource) { }
+
+    /**
+     * Access the raw response object returned by the API.
+     */
+    get raw(): ResponseResource {
+        return this._raw;
+    }
+
+    /**
+     * Automatically extracts the text content from the response.
+     * It looks for the first "output_text" item in the response content.
+     */
+    get text(): string | undefined {
+        if (!this._raw.output) return undefined;
+
+        for (const item of this._raw.output) {
+            if (item.type === "message") {
+                for (const contentPart of item.content) {
+                    if (contentPart.type === "output_text" || contentPart.type === "text") {
+                        return contentPart.text;
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+
+    /**
+     * The ID of the response.
+     */
+    get id(): string | undefined {
+        return this._raw.id ?? undefined;
+    }
+
+    /**
+     * The model used to generate the response.
+     */
+    get model(): string | undefined {
+        return this._raw.model ?? undefined;
+    }
+}
+
+/**
+ * Options for sending a message or creating a session.
+ */
+export type MessageOptions = Omit<CreateResponseBody, "input" | "stream">;
+
+/**
+ * The main client for interacting with the Tekimax API.
+ */
 export class TekimaxClient {
     private baseUrl: string;
     private headers: HeadersInit;
 
+    /**
+     * Creates a new TekimaxClient.
+     * 
+     * @param options - Configuration options for the client.
+     * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+     * @param options.apiKey - Your Tekimax API key.
+     * 
+     * @example
+     * const client = new TekimaxClient({ apiKey: "tm_..." });
+     */
     constructor(options: { baseUrl?: string; apiKey?: string } = {}) {
         this.baseUrl = options.baseUrl || "https://api.tekimax.com";
         this.headers = {
@@ -12,7 +78,7 @@ export class TekimaxClient {
         };
     }
 
-    private async request<T>(path: string, body: any): Promise<T> {
+    private async request(path: string, body: any): Promise<TekimaxResponse> {
         const response = await fetch(`${this.baseUrl}${path}`, {
             method: "POST",
             headers: this.headers,
@@ -23,14 +89,41 @@ export class TekimaxClient {
             throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
         }
 
-        return response.json() as Promise<T>;
+        const data = await response.json() as ResponseResource;
+        return new TekimaxResponse(data);
     }
 
-    async createSession(body: CreateResponseBody): Promise<ResponseResource> {
-        return this.request<ResponseResource>("/responses", body);
+    /**
+     * Creates a new session and sends the initial message.
+     * 
+     * @param message - The initial message text to start the session.
+     * @param options - Additional configuration options (model, temperature, etc.).
+     * 
+     * @example
+     * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+     * console.log(response.text);
+     */
+    async createSession(message: string, options?: MessageOptions): Promise<TekimaxResponse> {
+        const body: CreateResponseBody = {
+            ...options,
+            input: message,
+        };
+        return this.request("/responses", body);
     }
 
-    async sendMessage(body: CreateResponseBody): Promise<ResponseResource> {
-        return this.request<ResponseResource>("/responses", body);
+    /**
+     * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+     * 
+     * @param message - The message text to send.
+     * @param options - Additional configuration options.
+     * 
+     * @example
+     * const response = await client.sendMessage("What is the weather?", { 
+     *   previous_response_id: "resp_123" 
+     * });
+     * console.log(response.text);
+     */
+    async sendMessage(message: string, options?: MessageOptions): Promise<TekimaxResponse> {
+        return this.createSession(message, options);
     }
 }

package/src/index.ts

@@ -1,3 +1,3 @@
 export * from "./gen/types";
 export * from "./gen/zod";
-export { TekimaxClient } from "./client";
+export { TekimaxClient, TekimaxResponse } from "./client";