samsar-js 0.48.4 → 0.48.5

package/README.md

@@ -1,6 +1,6 @@
 # samsar-js
 
-TypeScript/ESM client for the Samsar Processor public API (`https://api.samsar.one/v1`). It mirrors the OpenAI-style ergonomics for creating videos, enhancing chat messages, and managing image operations.
+TypeScript/ESM client for the Samsar Processor public API (`https://api.samsar.one/v1`). It mirrors OpenAI-style ergonomics for creating videos, enhancing copy, running assistant completions, and managing image operations.
 
 ## Installation
 
@@ -95,6 +95,26 @@ console.log(cancelled.data.status, cancelled.data.cancelled);
 // Enhance chat message
 const enhanced = await samsar.enhanceMessage({ message: 'Please improve this caption.' });
 
+// Set an account-level assistant system prompt
+await samsar.setAssistantSystemPrompt({
+  system_prompt: 'You are the brand assistant for Acme. Keep answers concise and commercially practical.',
+});
+
+// Create an assistant completion for an existing session
+const assistant = await samsar.createAssistantCompletion({
+  session_id: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+  input: [
+    {
+      role: 'user',
+      content: [
+        { type: 'input_text', text: 'Write a launch caption for this session.' },
+      ],
+    },
+  ],
+  max_output_tokens: 300,
+});
+console.log(assistant.data.output_text);
+
 // Create embeddings from a JSON array
 const embedding = await samsar.createEmbedding({
   name: 'listings',
@@ -304,9 +324,10 @@ Each method returns `{ data, status, headers, creditsCharged, creditsRemaining,
 
 ## Billing notes
 
+- Assistant completions are billed from actual request usage. Samsar measures the processed input and generated output, converts usage to credits using the standard `100 credits = $1` rule, and applies a `2.5x` assistant multiplier so text-only and multimodal sessions are priced consistently.
 - Embedding endpoints (`createEmbedding`, `updateEmbedding`, `searchAgainstEmbedding`, `similarToEmbedding`) are billed by input tokens at $1 per million tokens. `deleteEmbeddings` does not consume tokens.
 - URL-based embedding creation (`createEmbedding` with `urls`, or `createEmbeddingFromUrl`) adds Firecrawl crawl cost to the embedding token cost, then applies Samsar's 100 credits per USD mapping with a `2.5x` multiplier.
-- Token counts follow OpenAI tokenization for `text-embedding-3-large`. Credit deductions follow the existing 100 credits per USD rule.
+- Token-based routes scale with the amount of content processed. Larger prompts, longer responses, and richer inputs use more credits than short text-only requests.
 - Receipt template creation (`createReceiptTemplate`) and template JSON lookup (`getReceiptTemplateJson`) are free; receipt template query (`queryReceiptTemplate`) costs 50 credits per request.
 
 ## Configuration

package/dist/index.d.ts

@@ -297,6 +297,83 @@ export interface EnhanceMessageResponse {
     content: string;
     [key: string]: unknown;
 }
+export type AssistantInputContentItem = {
+    type: 'input_text' | 'text';
+    text: string;
+    [key: string]: unknown;
+} | {
+    type: 'input_image' | 'image_url' | 'image';
+    image_url?: string;
+    url?: string;
+    [key: string]: unknown;
+} | Record<string, unknown>;
+export interface AssistantInputMessage {
+    role: 'user' | 'assistant' | 'developer' | 'system';
+    content: string | AssistantInputContentItem[];
+    [key: string]: unknown;
+}
+export interface AssistantReasoningConfig {
+    effort?: 'low' | 'medium' | 'high' | string;
+    [key: string]: unknown;
+}
+export interface AssistantSetSystemPromptRequest {
+    system_prompt?: string | null;
+    systemPrompt?: string | null;
+    prompt?: string | null;
+    value?: string | null;
+}
+export interface AssistantSetSystemPromptResponse {
+    system_prompt: string | null;
+    model?: string;
+    selected_assistant_model?: string;
+    [key: string]: unknown;
+}
+export interface AssistantCompletionRequest {
+    session_id?: string;
+    sessionId?: string;
+    id?: string;
+    input?: string | AssistantInputMessage | AssistantInputMessage[] | AssistantInputContentItem[];
+    message?: string | AssistantInputMessage | AssistantInputMessage[] | AssistantInputContentItem[];
+    messages?: AssistantInputMessage[];
+    max_output_tokens?: number;
+    maxOutputTokens?: number;
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    metadata?: Record<string, unknown>;
+    user?: string;
+    text?: Record<string, unknown>;
+    tools?: unknown[];
+    tool_choice?: unknown;
+    parallel_tool_calls?: boolean;
+    reasoning?: AssistantReasoningConfig;
+    reasoning_effort?: 'low' | 'medium' | 'high' | string;
+    [key: string]: unknown;
+}
+export interface AssistantResponseContentItem {
+    type?: string;
+    text?: string;
+    annotations?: unknown[];
+    [key: string]: unknown;
+}
+export interface AssistantResponseOutputItem {
+    id?: string;
+    type?: string;
+    role?: string;
+    content?: AssistantResponseContentItem[];
+    [key: string]: unknown;
+}
+export interface AssistantCompletionResponse {
+    id?: string;
+    object?: string;
+    created_at?: number;
+    status?: string;
+    model?: string;
+    output_text?: string;
+    output?: AssistantResponseOutputItem[];
+    usage?: Record<string, unknown>;
+    [key: string]: unknown;
+}
 export interface EmbeddingStructuredField {
     key: string;
     type: string;
@@ -1194,6 +1271,16 @@ export declare class SamsarClient {
      * Optionally pass `language` (code or name) to enforce the output language.
      */
     enhanceMessage(payload: EnhanceMessageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnhanceMessageResponse>>;
+    /**
+     * Store or clear the account-level system prompt used by assistant completions.
+     * Pass `null` (for `system_prompt`) or an empty string to clear the custom prompt and revert to Samsar's default assistant prompt.
+     */
+    setAssistantSystemPrompt(payload: AssistantSetSystemPromptRequest, options?: SamsarRequestOptions): Promise<SamsarResult<AssistantSetSystemPromptResponse>>;
+    /**
+     * Create an assistant completion for an existing session.
+     * Returns an OpenAI Responses-style payload and includes credit headers when applicable.
+     */
+    createAssistantCompletion(payload: AssistantCompletionRequest, options?: SamsarRequestOptions): Promise<SamsarResult<AssistantCompletionResponse>>;
     /**
      * Create a new embedding template from either a JSON array (`records`) or a URL input (`urls`).
      */

package/dist/index.js

@@ -550,6 +550,20 @@ export class SamsarClient {
     async enhanceMessage(payload, options) {
         return this.post('chat/enhance', payload, options);
     }
+    /**
+     * Store or clear the account-level system prompt used by assistant completions.
+     * Pass `null` (for `system_prompt`) or an empty string to clear the custom prompt and revert to Samsar's default assistant prompt.
+     */
+    async setAssistantSystemPrompt(payload, options) {
+        return this.post('assistant/set_system_prompt', payload, options);
+    }
+    /**
+     * Create an assistant completion for an existing session.
+     * Returns an OpenAI Responses-style payload and includes credit headers when applicable.
+     */
+    async createAssistantCompletion(payload, options) {
+        return this.post('assistant/completion', payload, options);
+    }
     /**
      * Create a new embedding template from either a JSON array (`records`) or a URL input (`urls`).
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samsar-js",
-  "version": "0.48.4",
+  "version": "0.48.5",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",