Skip to main content

​
PromptVariable

Types for prompt variables with modality definitions.

​
Overview

Variable types define dynamic content that can be injected into prompts, with support for multiple modalities.

​
PromptVariable

Prompt variable with name and modality. 
interface PromptVariable {
  name: string;
  modality: VariableModality;
}
Properties:
  • name - Variable name (used as {{variable_name}} in prompts)
  • modality - Variable modality type (VariableModality)
Example: 
import type { PromptVariable } from '@adaline/api';

const variables: PromptVariable[] = [
  { name: 'user_name', modality: 'text' },
  { name: 'company_name', modality: 'text' },
  { name: 'company_logo', modality: 'image' },
  { name: 'report', modality: 'pdf' },
  { name: 'external_data', modality: 'api' },
  { name: 'nested_prompt', modality: 'prompt' }
];
JSON: 
[
  { "name": "user_name", "modality": "text" },
  { "name": "company_name", "modality": "text" },
  { "name": "company_logo", "modality": "image" },
  { "name": "report", "modality": "pdf" }
]

​
VariableModality

See the dedicated VariableModality page for full documentation. Variable modality type enumeration. 
type VariableModality = 'text' | 'image' | 'pdf' | 'api' | 'prompt';
Values:
  • 'text' - Plain text content
  • 'image' - Image content (URL or base64)
  • 'pdf' - PDF document content
  • 'api' - External API data source
  • 'prompt' - Nested prompt reference
Example: 
import type { VariableModality } from '@adaline/api';

const modality: VariableModality = 'text';

​
VariableValue

See the dedicated VariableValue page for full documentation. Variable value type, discriminated by modality. Used when providing values for prompt variables. 
type VariableValue =
  | TextContent
  | ImageContent
  | PdfContent
  | ApiContent
  | PromptContent;
Example: 
import type { VariableValue } from '@adaline/api';

// Text value
const textValue: VariableValue = {
  modality: 'text',
  value: 'John Doe'
};

// Image value
const imageValue: VariableValue = {
  modality: 'image',
  detail: 'auto',
  value: {
    type: 'url',
    url: 'https://example.com/logo.png'
  }
};

// PDF value
const pdfValue: VariableValue = {
  modality: 'pdf',
  value: {
    type: 'url',
    url: 'https://example.com/docs.pdf'
  },
  file: {
    name: 'user_guide.pdf',
    id: 'file_123'
  }
};

​
Using with Deployments

import { Adaline } from '@adaline/client';
import type { Deployment, PromptVariable } from '@adaline/api';

const adaline = new Adaline();

const deployment: Deployment = await adaline.getLatestDeployment({
  promptId: 'prompt_abc123',
  deploymentEnvironmentId: 'environment_abc123'
});

// Access variable definitions from the deployment
const variables: PromptVariable[] = deployment.prompt.variables;

variables.forEach(v => {
  console.log(`Variable: ${v.name}, Modality: ${v.modality}`);
});