samsar-js 0.48.5 → 0.48.7

package/README.md

@@ -115,6 +115,21 @@ const assistant = await samsar.createAssistantCompletion({
 });
 console.log(assistant.data.output_text);
 
+// Generate an image in the assistant response using the OpenAI-compatible image_generation tool
+const assistantImage = await samsar.createAssistantCompletion({
+  session_id: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+  input: 'Create a clean launch poster image for this session.',
+  tools: [{ type: 'image_generation', size: '1024x1024', quality: 'high' }],
+  tool_choice: { type: 'image_generation' },
+});
+const generatedImage = assistantImage.data.output?.find(
+  (item) => item.type === 'image_generation_call' && typeof item.result === 'string',
+);
+console.log(generatedImage?.result); // base64 image payload
+
+// Continue the same multimodal assistant thread by reusing the same session_id.
+// Samsar preserves the underlying OpenAI response chain for follow-up image edits.
+
 // Create embeddings from a JSON array
 const embedding = await samsar.createEmbedding({
   name: 'listings',
@@ -277,6 +292,14 @@ const externalUser = {
 const externalSession = await platform.createExternalUserSession(externalUser);
 console.log(externalSession.data.remainingCredits, externalSession.data.external_api_key);
 
+// Store an external-user-specific assistant prompt
+await platform.setExternalAssistantSystemPrompt(
+  {
+    system_prompt: 'You are the storefront assistant for this creator. Keep answers short, commercial, and visually aware.',
+  },
+  externalUser,
+);
+
 // Create a render attributed to that external user
 const externalRender = await platform.createExternalVideoFromText(externalUser, {
   prompt: 'A sleek teaser for a futuristic running shoe',
@@ -286,6 +309,18 @@ const externalRender = await platform.createExternalVideoFromText(externalUser,
   enable_subtitles: true,
 });
 
+// Run an assistant completion against one of that external user's sessions.
+// Credits are deducted from the external user, while the owning Samsar account model config is used internally.
+const externalAssistant = await platform.createExternalAssistantCompletion(
+  {
+    session_id: externalRender.data.request_id,
+    input: 'Write a product caption for this video and suggest a headline.',
+    max_output_tokens: 250,
+  },
+  externalUser,
+);
+console.log(externalAssistant.data.output_text);
+
 // Fetch their external library
 const library = await platform.listExternalUserRequests(externalUser, { limit: 12 });
 console.log(library.data.requests.length);
@@ -311,6 +346,9 @@ const verified = await platform.verifyClientSession({
 const externalClient = new SamsarClient({
   apiKey: verified.data.authToken!,
 });
+await externalClient.setExternalAssistantSystemPrompt({
+  system_prompt: 'You are my personal launch assistant. Stay concise and actionable.',
+});
 const externalLibrary = await externalClient.listExternalUserRequests();
 console.log(externalLibrary.data.requests.map((request) => request.request_id));
 ```

package/dist/index.d.ts

@@ -316,6 +316,22 @@ export interface AssistantReasoningConfig {
     effort?: 'low' | 'medium' | 'high' | string;
     [key: string]: unknown;
 }
+export interface AssistantImageGenerationTool {
+    type: 'image_generation';
+    size?: string;
+    quality?: 'auto' | 'low' | 'medium' | 'high' | string;
+    format?: 'png' | 'jpeg' | 'webp' | string;
+    background?: 'auto' | 'transparent' | 'opaque' | string;
+    compression?: number;
+    partial_images?: number;
+    action?: 'auto' | 'generate' | 'edit' | string;
+    [key: string]: unknown;
+}
+export type AssistantToolDefinition = AssistantImageGenerationTool | Record<string, unknown>;
+export type AssistantToolChoice = 'auto' | 'none' | 'required' | {
+    type?: string;
+    [key: string]: unknown;
+} | Record<string, unknown>;
 export interface AssistantSetSystemPromptRequest {
     system_prompt?: string | null;
     systemPrompt?: string | null;
@@ -332,6 +348,8 @@ export interface AssistantCompletionRequest {
     session_id?: string;
     sessionId?: string;
     id?: string;
+    previous_response_id?: string;
+    previousResponseId?: string;
     input?: string | AssistantInputMessage | AssistantInputMessage[] | AssistantInputContentItem[];
     message?: string | AssistantInputMessage | AssistantInputMessage[] | AssistantInputContentItem[];
     messages?: AssistantInputMessage[];
@@ -343,8 +361,8 @@ export interface AssistantCompletionRequest {
     metadata?: Record<string, unknown>;
     user?: string;
     text?: Record<string, unknown>;
-    tools?: unknown[];
-    tool_choice?: unknown;
+    tools?: AssistantToolDefinition[];
+    tool_choice?: AssistantToolChoice;
     parallel_tool_calls?: boolean;
     reasoning?: AssistantReasoningConfig;
     reasoning_effort?: 'low' | 'medium' | 'high' | string;
@@ -361,6 +379,9 @@ export interface AssistantResponseOutputItem {
     type?: string;
     role?: string;
     content?: AssistantResponseContentItem[];
+    status?: string;
+    revised_prompt?: string;
+    result?: string;
     [key: string]: unknown;
 }
 export interface AssistantCompletionResponse {
@@ -1041,6 +1062,10 @@ export interface ExternalCreateLoginTokenResponse extends CreateLoginTokenRespon
     external_user?: ExternalUserSummary | null;
     externalUser?: ExternalUserSummary | null;
 }
+export interface ExternalAssistantSetSystemPromptResponse extends AssistantSetSystemPromptResponse {
+    external_user?: ExternalUserSummary | null;
+    externalUser?: ExternalUserSummary | null;
+}
 export interface VerifyClientSessionInput {
     loginToken?: string;
     authToken?: string;
@@ -1210,6 +1235,16 @@ export declare class SamsarClient {
     createExternalUserLoginToken(externalUser?: ExternalUserIdentity | null, options?: ({
         redirect?: string;
     } & SamsarRequestOptions)): Promise<SamsarResult<ExternalCreateLoginTokenResponse>>;
+    /**
+     * Store or clear the external user’s assistant system prompt.
+     * When set, it overrides the owning account prompt for future assistant requests from that external user.
+     */
+    setExternalAssistantSystemPrompt(payload: AssistantSetSystemPromptRequest, externalUser?: ExternalUserIdentity | null, options?: SamsarRequestOptions): Promise<SamsarResult<ExternalAssistantSetSystemPromptResponse>>;
+    /**
+     * Create an assistant completion scoped to an external user while billing that external user's credit balance.
+     * The owning Samsar account's configured assistant model is used internally.
+     */
+    createExternalAssistantCompletion(payload: AssistantCompletionRequest, externalUser?: ExternalUserIdentity | null, options?: SamsarRequestOptions): Promise<SamsarResult<AssistantCompletionResponse>>;
     /**
      * Translate an existing video session into a new language.
      * Creates a new session_id and queues generation steps for lip sync + transcription + video render.

package/dist/index.js

@@ -128,6 +128,32 @@ export class SamsarClient {
         }
         return this.post('external_users/create_login_token', body, options);
     }
+    /**
+     * Store or clear the external user’s assistant system prompt.
+     * When set, it overrides the owning account prompt for future assistant requests from that external user.
+     */
+    async setExternalAssistantSystemPrompt(payload, externalUser, options) {
+        const body = {
+            ...payload,
+        };
+        if (externalUser) {
+            body.external_user = normalizeExternalUserIdentity(externalUser);
+        }
+        return this.post('external_users/assistant/set_system_prompt', body, options);
+    }
+    /**
+     * Create an assistant completion scoped to an external user while billing that external user's credit balance.
+     * The owning Samsar account's configured assistant model is used internally.
+     */
+    async createExternalAssistantCompletion(payload, externalUser, options) {
+        const body = {
+            ...payload,
+        };
+        if (externalUser) {
+            body.external_user = normalizeExternalUserIdentity(externalUser);
+        }
+        return this.post('external_users/assistant/completion', body, options);
+    }
     /**
      * Translate an existing video session into a new language.
      * Creates a new session_id and queues generation steps for lip sync + transcription + video render.

package/package.json

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