samsar-js 0.48.6 → 0.48.8

package/README.md

@@ -292,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',
@@ -301,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);
@@ -326,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

@@ -1062,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;
@@ -1231,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.6",
+  "version": "0.48.8",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",