@applica-software-guru/persona-sdk 0.1.103 → 0.1.104

package/dist/index.d.ts

@@ -651,23 +651,6 @@ export declare interface KnowledgeConfiguration {
 
 export declare type KnowledgeType = 'multi_hop' | 'simple';
 
-export declare interface KnownModel {
-    id?: string;
-    provider?: string;
-    modelName?: string;
-    label?: string;
-    deprecated?: boolean;
-}
-
-export declare class KnownModelsApi extends HttpApi {
-    constructor(baseUrl: string, auth: string | AuthenticationProvider);
-    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnownModel>>;
-    get(id: string): Promise<KnownModel>;
-    create(knownModel: KnownModel): Promise<KnownModel>;
-    update(id: string, knownModel: KnownModel): Promise<KnownModel>;
-    remove(id: string): Promise<void>;
-}
-
 export declare type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt-BR';
 
 export declare interface LineItem {
@@ -679,6 +662,26 @@ export declare interface LineItem {
     periodEnd?: string;
 }
 
+export declare interface MarkupRule {
+    id?: string;
+    pattern?: string;
+    percentage?: number;
+}
+
+/**
+ * Global markup rules (super admin only). Markup no longer lives on the
+ * ServicePrice: there is a single platform-wide list of {pattern, percentage}
+ * rules matched against usage service codes (most-specific-wins, "*" fallback).
+ */
+export declare class MarkupRulesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number): Promise<Paginated<MarkupRule>>;
+    get(id: string): Promise<MarkupRule>;
+    create(markupRule: MarkupRule): Promise<MarkupRule>;
+    update(id: string, markupRule: MarkupRule): Promise<MarkupRule>;
+    remove(id: string): Promise<void>;
+}
+
 export declare interface McpServerConfiguration {
     type?: string;
     name?: string;
@@ -885,8 +888,10 @@ export declare class PersonaSdk {
     triggers(authProvider: AuthenticationProvider): TriggersApi;
     servicePrices(apiKey: string): ServicePricesApi;
     servicePrices(authProvider: AuthenticationProvider): ServicePricesApi;
-    knownModels(apiKey: string): KnownModelsApi;
-    knownModels(authProvider: AuthenticationProvider): KnownModelsApi;
+    markupRules(apiKey: string): MarkupRulesApi;
+    markupRules(authProvider: AuthenticationProvider): MarkupRulesApi;
+    providers(apiKey: string): ProvidersApi;
+    providers(authProvider: AuthenticationProvider): ProvidersApi;
     sessions(apiKey: string): SessionsApi;
     sessions(authProvider: AuthenticationProvider): SessionsApi;
     missions(apiKey: string): MissionsApi;
@@ -960,6 +965,51 @@ export declare interface ProjectUpdateRequest {
     tag?: string;
 }
 
+export declare interface Provider {
+    id?: string;
+    /** litellm provider name, e.g. "openai", "anthropic", "vertex_ai". */
+    name?: string;
+    /** null/undefined => global; set => per-project override. */
+    projectId?: string | null;
+    /** Write-only; returned masked ("********") on reads. */
+    apiKey?: string;
+    baseUrl?: string;
+    /** Provider-specific extras (e.g. vertexProject, vertexLocation, vertexCredentials). */
+    config?: Record<string, unknown>;
+}
+
+/** A model suggestion for a provider, with litellm capability flags. */
+export declare interface ProviderModel {
+    id: string;
+    contextWindow?: number;
+    supportsVision?: boolean;
+    supportsFunctionCalling?: boolean;
+    supportsAudioInput?: boolean;
+    supportsPdfInput?: boolean;
+    supportsReasoning?: boolean;
+}
+
+/**
+ * Managed LLM providers (super admin only). Providers bind a litellm provider
+ * name to its credentials; global or per-project (override). API keys are stored
+ * encrypted and returned masked.
+ */
+export declare class ProvidersApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(projectId?: string | null, keyword?: string | null, page?: number, size?: number): Promise<Paginated<Provider>>;
+    get(id: string): Promise<Provider>;
+    create(provider: Provider): Promise<Provider>;
+    update(id: string, provider: Provider): Promise<Provider>;
+    remove(id: string): Promise<void>;
+    /** Provider names litellm supports (for the "add provider" picker). Admin. */
+    available(): Promise<string[]>;
+    /** Names of providers configured for the caller (global + their project), no
+     * credentials. Authenticated (not admin) — for the model selector. */
+    names(): Promise<string[]>;
+    /** Model suggestions (chat, with capabilities) for a provider, from litellm. */
+    models(provider: string): Promise<ProviderModel[]>;
+}
+
 export declare type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
 
 export declare interface Ref {
@@ -1003,7 +1053,6 @@ export declare interface ServicePrice {
     service?: string;
     cost?: number;
     unit?: string;
-    markupPercentage?: number;
     fixedPrice?: number;
 }
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@applica-software-guru/persona-sdk",
   "description": "Official TypeScript SDK for the Persona API — manage agents, sessions, projects, knowledge bases, workflows, triggers and more.",
   "private": false,
-  "version": "0.1.103",
+  "version": "0.1.104",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/index.ts

@@ -152,8 +152,10 @@ export { MissionsApi } from './missions/missions-api';
 export type { Mission, MissionStatus } from './missions/types';
 export { ServicePricesApi } from './service-prices/service-prices-api';
 export type { ServicePrice } from './service-prices/types';
-export { KnownModelsApi } from './known-models/known-models-api';
-export type { KnownModel } from './known-models/types';
+export { MarkupRulesApi } from './markup-rules/markup-rules-api';
+export type { MarkupRule } from './markup-rules/types';
+export { ProvidersApi } from './providers/providers-api';
+export type { Provider, ProviderModel } from './providers/types';
 export type { Revision as RevisionType } from './revisions/types';
 export { BillingClient } from './billing/billing-client';
 export { ValuesApi } from './values/values-api';

package/src/markup-rules/markup-rules-api.ts

@@ -0,0 +1,38 @@
+import { HttpApi } from '../http-api';
+import { Paginated } from '../paginated';
+import { AuthenticationProvider } from '../auth/authentication-provider';
+import { MarkupRule } from './types';
+
+/**
+ * Global markup rules (super admin only). Markup no longer lives on the
+ * ServicePrice: there is a single platform-wide list of {pattern, percentage}
+ * rules matched against usage service codes (most-specific-wins, "*" fallback).
+ */
+export class MarkupRulesApi extends HttpApi {
+  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
+    super(baseUrl, auth);
+  }
+
+  async list(keyword?: string | null, page?: number, size?: number): Promise<Paginated<MarkupRule>> {
+    const { page: p, size: s } = this.normalizePageParams(page, size);
+    const params: Record<string, unknown> = { page: p, size: s };
+    if (keyword) params.keyword = keyword;
+    return this.httpGet<Paginated<MarkupRule>>('/markup-rules', params);
+  }
+
+  async get(id: string): Promise<MarkupRule> {
+    return this.httpGet<MarkupRule>('/markup-rules/' + id);
+  }
+
+  async create(markupRule: MarkupRule): Promise<MarkupRule> {
+    return this.httpPost<MarkupRule>('/markup-rules', markupRule);
+  }
+
+  async update(id: string, markupRule: MarkupRule): Promise<MarkupRule> {
+    return this.httpPut<MarkupRule>('/markup-rules/' + id, markupRule);
+  }
+
+  async remove(id: string): Promise<void> {
+    await this.httpDelete('/markup-rules/' + id);
+  }
+}

package/src/markup-rules/types.ts

@@ -0,0 +1,5 @@
+export interface MarkupRule {
+  id?: string;
+  pattern?: string;
+  percentage?: number;
+}

package/src/persona-sdk.ts

@@ -7,7 +7,8 @@ import { CredentialsApi } from './credentials/credentials-api';
 import { FeaturesApi } from './features/features-api';
 import { TriggersApi } from './triggers/triggers-api';
 import { ServicePricesApi } from './service-prices/service-prices-api';
-import { KnownModelsApi } from './known-models/known-models-api';
+import { MarkupRulesApi } from './markup-rules/markup-rules-api';
+import { ProvidersApi } from './providers/providers-api';
 import { SessionsApi } from './sessions/sessions-api';
 import { MissionsApi } from './missions/missions-api';
 import { BillingClient } from './billing/billing-client';
@@ -72,10 +73,16 @@ export class PersonaSdk {
     return new ServicePricesApi(this.baseUrl, auth);
   }
 
-  knownModels(apiKey: string): KnownModelsApi;
-  knownModels(authProvider: AuthenticationProvider): KnownModelsApi;
-  knownModels(auth: string | AuthenticationProvider): KnownModelsApi {
-    return new KnownModelsApi(this.baseUrl, auth);
+  markupRules(apiKey: string): MarkupRulesApi;
+  markupRules(authProvider: AuthenticationProvider): MarkupRulesApi;
+  markupRules(auth: string | AuthenticationProvider): MarkupRulesApi {
+    return new MarkupRulesApi(this.baseUrl, auth);
+  }
+
+  providers(apiKey: string): ProvidersApi;
+  providers(authProvider: AuthenticationProvider): ProvidersApi;
+  providers(auth: string | AuthenticationProvider): ProvidersApi {
+    return new ProvidersApi(this.baseUrl, auth);
   }
 
   sessions(apiKey: string): SessionsApi;

package/src/providers/providers-api.ts

@@ -0,0 +1,55 @@
+import { HttpApi } from '../http-api';
+import { Paginated } from '../paginated';
+import { AuthenticationProvider } from '../auth/authentication-provider';
+import { Provider, ProviderModel } from './types';
+
+/**
+ * Managed LLM providers (super admin only). Providers bind a litellm provider
+ * name to its credentials; global or per-project (override). API keys are stored
+ * encrypted and returned masked.
+ */
+export class ProvidersApi extends HttpApi {
+  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
+    super(baseUrl, auth);
+  }
+
+  async list(projectId?: string | null, keyword?: string | null, page?: number, size?: number): Promise<Paginated<Provider>> {
+    const { page: p, size: s } = this.normalizePageParams(page, size);
+    const params: Record<string, unknown> = { page: p, size: s };
+    if (projectId) params.projectId = projectId;
+    if (keyword) params.keyword = keyword;
+    return this.httpGet<Paginated<Provider>>('/providers', params);
+  }
+
+  async get(id: string): Promise<Provider> {
+    return this.httpGet<Provider>('/providers/' + id);
+  }
+
+  async create(provider: Provider): Promise<Provider> {
+    return this.httpPost<Provider>('/providers', provider);
+  }
+
+  async update(id: string, provider: Provider): Promise<Provider> {
+    return this.httpPut<Provider>('/providers/' + id, provider);
+  }
+
+  async remove(id: string): Promise<void> {
+    await this.httpDelete('/providers/' + id);
+  }
+
+  /** Provider names litellm supports (for the "add provider" picker). Admin. */
+  async available(): Promise<string[]> {
+    return this.httpGet<string[]>('/providers/available');
+  }
+
+  /** Names of providers configured for the caller (global + their project), no
+   * credentials. Authenticated (not admin) — for the model selector. */
+  async names(): Promise<string[]> {
+    return this.httpGet<string[]>('/provider-names');
+  }
+
+  /** Model suggestions (chat, with capabilities) for a provider, from litellm. */
+  async models(provider: string): Promise<ProviderModel[]> {
+    return this.httpGet<ProviderModel[]>('/provider-models', { provider });
+  }
+}

package/src/providers/types.ts

@@ -0,0 +1,23 @@
+export interface Provider {
+  id?: string;
+  /** litellm provider name, e.g. "openai", "anthropic", "vertex_ai". */
+  name?: string;
+  /** null/undefined => global; set => per-project override. */
+  projectId?: string | null;
+  /** Write-only; returned masked ("********") on reads. */
+  apiKey?: string;
+  baseUrl?: string;
+  /** Provider-specific extras (e.g. vertexProject, vertexLocation, vertexCredentials). */
+  config?: Record<string, unknown>;
+}
+
+/** A model suggestion for a provider, with litellm capability flags. */
+export interface ProviderModel {
+  id: string;
+  contextWindow?: number;
+  supportsVision?: boolean;
+  supportsFunctionCalling?: boolean;
+  supportsAudioInput?: boolean;
+  supportsPdfInput?: boolean;
+  supportsReasoning?: boolean;
+}

package/src/service-prices/types.ts

@@ -3,6 +3,5 @@ export interface ServicePrice {
   service?: string;
   cost?: number;
   unit?: string;
-  markupPercentage?: number;
   fixedPrice?: number;
 }

package/src/known-models/known-models-api.ts

@@ -1,33 +0,0 @@
-import { HttpApi } from '../http-api';
-import { Paginated } from '../paginated';
-import { AuthenticationProvider } from '../auth/authentication-provider';
-import { KnownModel } from './types';
-
-export class KnownModelsApi extends HttpApi {
-  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
-    super(baseUrl, auth);
-  }
-
-  async list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnownModel>> {
-    const { page: p, size: s } = this.normalizePageParams(page, size);
-    const params: Record<string, unknown> = { page: p, size: s, ...extraParams };
-    if (keyword) params.keyword = keyword;
-    return this.httpGet<Paginated<KnownModel>>('/known-models', params);
-  }
-
-  async get(id: string): Promise<KnownModel> {
-    return this.httpGet<KnownModel>('/known-models/' + id);
-  }
-
-  async create(knownModel: KnownModel): Promise<KnownModel> {
-    return this.httpPost<KnownModel>('/known-models', knownModel);
-  }
-
-  async update(id: string, knownModel: KnownModel): Promise<KnownModel> {
-    return this.httpPut<KnownModel>('/known-models/' + id, knownModel);
-  }
-
-  async remove(id: string): Promise<void> {
-    await this.httpDelete('/known-models/' + id);
-  }
-}

package/src/known-models/types.ts

@@ -1,7 +0,0 @@
-export interface KnownModel {
-  id?: string;
-  provider?: string;
-  modelName?: string;
-  label?: string;
-  deprecated?: boolean;
-}