@proteos/sdk 0.54.1 → 0.56.0

package/dist/{types-6-ywikNl.d.ts → types-GIkv5spC.d.ts}

@@ -1456,12 +1456,15 @@ type LogicalOperator = 'and' | 'or';
  * Comparison operator for a single filter element. Mirrors
  * `ComparisonOperator` in `packages/go/model/comparison-operator.go`.
  */
-type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
+type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'contains_all' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
 /**
  * Single filter element (atomic predicate).
  *
- * `value` is a string at the wire level — pipe-joined for `in` / `not_in`,
- * ignored for `empty` / `not_empty`. This matches the data-service URL query
+ * `value` is a string at the wire level — pipe-joined for the list operators
+ * `in` / `not_in` / `contains_all`, ignored for `empty` / `not_empty`. On array
+ * attributes the membership operators are set tests: `contains` = has the
+ * value, `not_contains` = does not have it, `in` = has any of, `not_in` = has
+ * none of, `contains_all` = has all of. This matches the data-service URL query
  * convention so the same predicate flows through both the GET-with-filters
  * path and the layout `visible_when` JSONB path without a translation layer.
  */
@@ -1481,15 +1484,15 @@ interface FilterGroup {
 declare const FilterElementSchema: z.ZodObject<{
     field: z.ZodString;
     value: z.ZodString;
-    operator: z.ZodEnum<["eq", "gt", "lt", "gte", "lte", "ne", "in", "not_in", "contains", "starts_with", "ends_with", "empty", "not_empty"]>;
+    operator: z.ZodEnum<["eq", "gt", "lt", "gte", "lte", "ne", "in", "not_in", "contains", "not_contains", "contains_all", "starts_with", "ends_with", "empty", "not_empty"]>;
 }, "strip", z.ZodTypeAny, {
     value: string;
     field: string;
-    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | "empty" | "not_empty";
+    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "not_contains" | "contains_all" | "starts_with" | "ends_with" | "empty" | "not_empty";
 }, {
     value: string;
     field: string;
-    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | "empty" | "not_empty";
+    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "not_contains" | "contains_all" | "starts_with" | "ends_with" | "empty" | "not_empty";
 }>;
 declare const FilterGroupSchema: z.ZodType<FilterGroup>;
 
@@ -1997,6 +2000,28 @@ declare const PageLayoutSchema: z.ZodObject<{
     } | undefined;
 }>;
 
+/**
+ * The virtual column that stands for a record's rendered title — the entity's
+ * Liquid `title_template` evaluated against the row. Lists show it, and the
+ * records query sorts and filters on it when the template is "simple". No
+ * attribute backs it, so the name is reserved: the backend rejects an
+ * attribute called `record_title` (mirror of `metamodel.RecordTitleField`).
+ */
+declare const RECORD_TITLE_FIELD = "record_title";
+/** True when `name` is taken by a virtual column and unavailable to attributes. */
+declare function isReservedAttributeName(name: string): boolean;
+/**
+ * A simple template is literal text plus `{{ attribute }}` references and
+ * nothing else — no filters (`| upcase`), no tags (`{% if %}`), no dotted
+ * references. Only those compile to SQL, so only those make `record_title`
+ * sortable and filterable. Mirror of the Go `titletemplate.ParseSimple`
+ * grammar; the backend stays the authority and answers 400 when the two
+ * ever disagree.
+ */
+declare function isTitleQueryable(template: string | undefined): boolean;
+/** The attributes a simple template references, in order of first use; `[]` otherwise. */
+declare function titleTemplateVariables(template: string | undefined): string[];
+
 /**
  * Client for the Proteos Metadata Service API.
  * Provides access to all metadata management services.
@@ -5743,4 +5768,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { CurrencyAttributeMetaSchema as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type ResponseMeta as R, type CreateListRequest as S, type CreateListViewRequest as T, type UserRef as U, type CreateMenuConfigurationExtensionRequest as V, type CreateMenuConfigurationRequest as W, type CreatePageExtensionRequest as X, type CreatePageRequest as Y, type CreateVariableRequest as Z, type CurrencyAttributeMeta as _, type Attribute as a, type MenuConfigurationExtensionPlacement as a$, type CurrencySymbolSide as a0, type CurrencyValue as a1, type CurrentUserDefault as a2, DEFAULT_OPTIONS as a3, DEFAULT_PAGE_SIZE as a4, DONE as a5, type DeployModuleRequest as a6, type DesignReference as a7, type DesignReferenceContent as a8, DesignReferenceSchema as a9, type ListDesignReferencesOptions as aA, type ListEntitiesOptions as aB, type ListEntityExtensionsOptions as aC, type ListExtension as aD, type ListExtensionColumnPlacement as aE, ListExtensionColumnPlacementSchema as aF, ListExtensionSchema as aG, type ListExtensionService as aH, type ListFn as aI, type ListListExtensionsOptions as aJ, type ListListViewsOptions as aK, type ListListsOptions as aL, type ListMenuConfigurationExtensionsOptions as aM, type ListMenuConfigurationsOptions as aN, type ListModulesOptions as aO, type ListPageExtensionsOptions as aP, type ListPagesOptions as aQ, ListSchema as aR, type ListService as aS, type ListVariablesOptions as aT, type ListView as aU, ListViewSchema as aV, type ListViewService as aW, type LogicalOperator as aX, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aY, type MenuConfiguration as aZ, type MenuConfigurationExtension as a_, type DesignReferenceService as aa, type Done as ab, type Entity as ac, type EntityContactBinding as ad, EntityContactBindingSchema as ae, type EntityExtension as af, EntityExtensionSchema as ag, type EntityExtensionService as ah, EntitySchema as ai, type EntityService as aj, type EntityWithSchema as ak, EntityWithSchemaSchema as al, type EnumAttributeMeta as am, type EnumValue as an, type ExtensionPosition as ao, ExtensionPositionSchema as ap, type FileAttributeMeta as aq, FileRefSchema as ar, type FilterElement as as, FilterElementSchema as at, type FilterGroup as au, FilterGroupSchema as av, type List as aw, type ListAppConfigurationsOptions as ax, type ListAppsOptions as ay, type ListComponentsOptions as az, type ListResult as b, type UserType as b$, MenuConfigurationExtensionPlacementSchema as b0, type MenuConfigurationExtensionPosition as b1, MenuConfigurationExtensionPositionSchema as b2, MenuConfigurationExtensionSchema as b3, type MenuConfigurationExtensionService as b4, MenuConfigurationSchema as b5, type MenuConfigurationService as b6, type MenuItem as b7, MenuItemSchema as b8, MenuItemType as b9, type PublicPageComponent as bA, type PublicPageResponse as bB, type RelationAttributeMeta as bC, RelationAttributeMetaSchema as bD, type RequestOptions as bE, type ResolvedClientOptions as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, MetaClient as ba, type MetaListOptions as bb, type Module as bc, ModuleSchema as bd, type ModuleService as be, type ModuleStatus as bf, type OnDeleteAction as bg, OnDeleteActionSchema as bh, PAGE_EXTENSION_ANCHOR_MAIN as bi, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bj, PLATFORM_ATTRIBUTE_NAMES as bk, PLATFORM_USER_ID as bl, type Page as bm, type PageAction as bn, type PageActionKind as bo, PageActionSchema as bp, type PageExtension as bq, type PageExtensionPlacement as br, PageExtensionPlacementSchema as bs, PageExtensionSchema as bt, type PageExtensionService as bu, type PageLayout as bv, PageLayoutSchema as bw, PageSchema as bx, type PageService as by, type PageType as bz, ProteosClient as c, SizeValueSchema as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, type RecordFilterElement as cT, type RelatedListElement as cU, type RelatedRecordElement as cV, type ResponsiveSizing as cW, type RowElement as cX, type SchedulingPickerElement as cY, type SectionElement as cZ, type SizeValue as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, type SizingProps as d0, type StringAttributeMeta as d1, type StringFormat as d2, type TabsElement as d3, type TextElement as d4, type TextVariant as d5, type UserAttributeMeta as d6, UserAttributeMetaSchema as d7, type WorkflowTriggerElement as d8, isBuiltInControl as d9, lookupCompatibleControls as da, lookupControls as db, lookupPrimaryControl as dc, parsePrincipalMeta as dd, parseUserMeta as de, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };
+export { CurrencyAttributeMetaSchema as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type ResponseMeta as R, type CreateListRequest as S, type CreateListViewRequest as T, type UserRef as U, type CreateMenuConfigurationExtensionRequest as V, type CreateMenuConfigurationRequest as W, type CreatePageExtensionRequest as X, type CreatePageRequest as Y, type CreateVariableRequest as Z, type CurrencyAttributeMeta as _, type Attribute as a, type MenuConfigurationExtensionPlacement as a$, type CurrencySymbolSide as a0, type CurrencyValue as a1, type CurrentUserDefault as a2, DEFAULT_OPTIONS as a3, DEFAULT_PAGE_SIZE as a4, DONE as a5, type DeployModuleRequest as a6, type DesignReference as a7, type DesignReferenceContent as a8, DesignReferenceSchema as a9, type ListDesignReferencesOptions as aA, type ListEntitiesOptions as aB, type ListEntityExtensionsOptions as aC, type ListExtension as aD, type ListExtensionColumnPlacement as aE, ListExtensionColumnPlacementSchema as aF, ListExtensionSchema as aG, type ListExtensionService as aH, type ListFn as aI, type ListListExtensionsOptions as aJ, type ListListViewsOptions as aK, type ListListsOptions as aL, type ListMenuConfigurationExtensionsOptions as aM, type ListMenuConfigurationsOptions as aN, type ListModulesOptions as aO, type ListPageExtensionsOptions as aP, type ListPagesOptions as aQ, ListSchema as aR, type ListService as aS, type ListVariablesOptions as aT, type ListView as aU, ListViewSchema as aV, type ListViewService as aW, type LogicalOperator as aX, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aY, type MenuConfiguration as aZ, type MenuConfigurationExtension as a_, type DesignReferenceService as aa, type Done as ab, type Entity as ac, type EntityContactBinding as ad, EntityContactBindingSchema as ae, type EntityExtension as af, EntityExtensionSchema as ag, type EntityExtensionService as ah, EntitySchema as ai, type EntityService as aj, type EntityWithSchema as ak, EntityWithSchemaSchema as al, type EnumAttributeMeta as am, type EnumValue as an, type ExtensionPosition as ao, ExtensionPositionSchema as ap, type FileAttributeMeta as aq, FileRefSchema as ar, type FilterElement as as, FilterElementSchema as at, type FilterGroup as au, FilterGroupSchema as av, type List as aw, type ListAppConfigurationsOptions as ax, type ListAppsOptions as ay, type ListComponentsOptions as az, type ListResult as b, type UserType as b$, MenuConfigurationExtensionPlacementSchema as b0, type MenuConfigurationExtensionPosition as b1, MenuConfigurationExtensionPositionSchema as b2, MenuConfigurationExtensionSchema as b3, type MenuConfigurationExtensionService as b4, MenuConfigurationSchema as b5, type MenuConfigurationService as b6, type MenuItem as b7, MenuItemSchema as b8, MenuItemType as b9, type PublicPageComponent as bA, type PublicPageResponse as bB, type RelationAttributeMeta as bC, RelationAttributeMetaSchema as bD, type RequestOptions as bE, type ResolvedClientOptions as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, MetaClient as ba, type MetaListOptions as bb, type Module as bc, ModuleSchema as bd, type ModuleService as be, type ModuleStatus as bf, type OnDeleteAction as bg, OnDeleteActionSchema as bh, PAGE_EXTENSION_ANCHOR_MAIN as bi, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bj, PLATFORM_ATTRIBUTE_NAMES as bk, PLATFORM_USER_ID as bl, type Page as bm, type PageAction as bn, type PageActionKind as bo, PageActionSchema as bp, type PageExtension as bq, type PageExtensionPlacement as br, PageExtensionPlacementSchema as bs, PageExtensionSchema as bt, type PageExtensionService as bu, type PageLayout as bv, PageLayoutSchema as bw, PageSchema as bx, type PageService as by, type PageType as bz, ProteosClient as c, type SizeValue as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, RECORD_TITLE_FIELD as cT, type RecordFilterElement as cU, type RelatedListElement as cV, type RelatedRecordElement as cW, type ResponsiveSizing as cX, type RowElement as cY, type SchedulingPickerElement as cZ, type SectionElement as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, SizeValueSchema as d0, type SizingProps as d1, type StringAttributeMeta as d2, type StringFormat as d3, type TabsElement as d4, type TextElement as d5, type TextVariant as d6, type UserAttributeMeta as d7, UserAttributeMetaSchema as d8, type WorkflowTriggerElement as d9, isBuiltInControl as da, isReservedAttributeName as db, isTitleQueryable as dc, lookupCompatibleControls as dd, lookupControls as de, lookupPrimaryControl as df, parsePrincipalMeta as dg, parseUserMeta as dh, titleTemplateVariables as di, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.54.1",
+  "version": "0.56.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/biome-config": "0.0.0",
-    "@proteos/tsconfig": "0.0.0"
+    "@proteos/tsconfig": "0.0.0",
+    "@proteos/biome-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/agent/index.ts

@@ -1,6 +1,7 @@
 import type { ProteosClient } from '../client.js'
 import { type AgentService, AgentServiceImpl } from './agents.js'
 import { type McpServerService, McpServerServiceImpl } from './mcp-servers.js'
+import { type ModelService, ModelServiceImpl } from './models.js'
 import { type PromptService, PromptServiceImpl } from './prompts.js'
 import { type SessionService, SessionServiceImpl } from './sessions.js'
 import { type SkillService, SkillServiceImpl } from './skills.js'
@@ -12,7 +13,8 @@ import { type ToolsetService, ToolsetServiceImpl } from './toolsets.js'
  *
  * Manages the AI-agent configuration domain: Agents, Prompts (versioned),
  * Skills (versioned bundles), Tools, and MCP Servers — all org-scoped and keyed
- * by an immutable kebab-case `key`.
+ * by an immutable kebab-case `key` — plus the stateless model calls
+ * (`models.generate`, `models.decide`) and chat sessions.
  *
  * @example
  * ```ts
@@ -23,6 +25,15 @@ import { type ToolsetService, ToolsetServiceImpl } from './toolsets.js'
  *
  * const agents = await agent.agents.list().all();
  * const prompt = await agent.prompts.get('revenue-brief');
+ *
+ * const { answers } = await agent.models.decide({
+ *   state: { message: 'My card was charged twice!' },
+ *   questions: {
+ *     refund_requested: { type: 'boolean', instructions: 'Does the customer ask for money back?' },
+ *     topic: { type: 'choice', instructions: 'Topic?', criteria: { billing: 'charges', other: 'else' } },
+ *   },
+ * });
+ * if (answers.topic.confidence > 0.8) route(answers.topic.choice);
  * ```
  */
 export class AgentClient {
@@ -38,6 +49,8 @@ export class AgentClient {
   readonly toolsets: ToolsetService
   /** Service for managing MCP server registrations. */
   readonly mcpServers: McpServerService
+  /** Service for stateless model calls: `generate` (one message out) and `decide` (calibrated typed answers). */
+  readonly models: ModelService
   /** Service for managing chat sessions (conversations + event log + stream). */
   readonly sessions: SessionService
 
@@ -53,6 +66,7 @@ export class AgentClient {
     this.tools = new ToolServiceImpl(client)
     this.toolsets = new ToolsetServiceImpl(client)
     this.mcpServers = new McpServerServiceImpl(client)
+    this.models = new ModelServiceImpl(client)
     this.sessions = new SessionServiceImpl(client)
   }
 }
@@ -60,6 +74,28 @@ export class AgentClient {
 // Re-export service interfaces
 export type { AgentService } from './agents.js'
 export type { McpServerService } from './mcp-servers.js'
+// Re-export model-call types (generate + decide)
+export type {
+  BooleanAnswer,
+  BooleanCriteria,
+  BooleanQuestion,
+  ChoiceAnswer,
+  ChoiceQuestion,
+  DecideRequest,
+  DecisionAnswer,
+  DecisionAnswerFor,
+  DecisionQuestion,
+  DecisionQuestions,
+  DecisionQuestionType,
+  DecisionResult,
+  GenerateRequest,
+  GenerationResult,
+  ModelStopReason,
+  ScoreAnswer,
+  ScoreQuestion,
+  StructuredText,
+} from './model-types.js'
+export type { ModelService } from './models.js'
 export type { PromptService } from './prompts.js'
 // Re-export session types
 export type {
@@ -110,12 +146,14 @@ export type {
   CreateMcpServerRequest,
   CreatePromptRequest,
   CreateToolRequest,
+  CreateToolsetRequest,
   DependentAgent,
   DependentSyncResult,
   ListAgentsOptions,
   ListMcpServersOptions,
   ListPromptsOptions,
   ListSkillsOptions,
+  ListToolsetsOptions,
   ListToolsOptions,
   McpBinding,
   McpConnectionState,
@@ -125,25 +163,23 @@ export type {
   McpServerOAuth,
   McpToolSummary,
   ModelConfig,
+  PlatformBinding,
   Prompt,
   PromptVersion,
+  QueryBinding,
   Skill,
   SkillBundle,
   SkillVersion,
   StartMcpOAuthResponse,
-  PlatformBinding,
-  QueryBinding,
   Tool,
   ToolBinding,
   ToolKind,
   Toolset,
   ToolsetKind,
   ToolsetToolSummary,
-  CreateToolsetRequest,
-  UpdateToolsetRequest,
-  ListToolsetsOptions,
   UpdateAgentRequest,
   UpdateMcpServerRequest,
   UpdatePromptRequest,
   UpdateToolRequest,
+  UpdateToolsetRequest,
 } from './types.js'

package/src/agent/model-types.ts

@@ -0,0 +1,193 @@
+/**
+ * Types for the stateless model endpoints of the Proteos Agent Service API —
+ * `POST /agents/v1/models/generate` and `POST /agents/v1/models/decide`.
+ *
+ * Hand-written mirror of the Go models in `go.proteos.ai/model/agent`
+ * (`generation.go`, `decision.go` + `api/generation-requests.go`,
+ * `api/decision-requests.go`). Field names match the snake_case wire format
+ * exactly, including enum values.
+ */
+
+import type { ContentBlock, ModelUsage, TextBlock } from './session-types.js'
+import type { ModelConfig } from './types.js'
+
+// ---------------------------------------------------------------------------
+// Generation (one message out)
+// ---------------------------------------------------------------------------
+
+/**
+ * Why the model stopped generating. An open string so a new provider reason
+ * never breaks decoding; the key distinction is `end_turn` (complete) vs
+ * `max_tokens` (truncated).
+ */
+export type ModelStopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | (string & {})
+
+/**
+ * Body of `POST /agents/v1/models/generate` — a single, stateless model call:
+ * content blocks in, one assistant message out. No event log, no tools, no
+ * multi-turn state.
+ */
+export interface GenerateRequest {
+  /** Model id + sampling knobs. Omitted (or an empty `model_id`) resolves to the service default. */
+  model?: Partial<ModelConfig>
+  /** Optional system prompt steering the response. */
+  system?: string
+  /** The message body the model answers — text and file blocks (a file-only body is valid). */
+  content: ContentBlock[]
+  /**
+   * JSON Schema of the structured reply. When set, generation is forced through a
+   * schema-constrained tool and the structured value comes back as `output`.
+   */
+  output_schema?: Record<string, unknown>
+}
+
+/** The assistant's reply to a {@link GenerateRequest}. */
+export interface GenerationResult {
+  /** The returned text blocks (usually empty on a schema-constrained call). */
+  content: TextBlock[]
+  stop_reason?: ModelStopReason
+  /** The model that produced the reply (resolved id). */
+  model_id: string
+  usage: ModelUsage
+  /** The structured value of a schema-constrained generation; absent otherwise. */
+  output?: unknown
+}
+
+// ---------------------------------------------------------------------------
+// Decisions (typed, calibrated answers out — no prose)
+// ---------------------------------------------------------------------------
+
+/**
+ * The text shape a decision provider reads: a string, a JSON object, or an
+ * array — never `null`, a number, or a boolean. Carries the state under
+ * judgment, a question's instructions, every criteria description, and the
+ * legend echoed back on a score. Structure passes through verbatim, so
+ * instructions can be structured guidance (named fields such as `what` /
+ * `not_for` / `examples`, backtick paths into the state like
+ * `` `ticket.messages[0].text` ``).
+ */
+export type StructuredText = string | Record<string, unknown> | unknown[]
+
+/** Discriminates a {@link DecisionQuestion} and its {@link DecisionAnswer}. */
+export type DecisionQuestionType = 'boolean' | 'choice' | 'score'
+
+/** Describes the two outcomes of a {@link BooleanQuestion}. */
+export interface BooleanCriteria {
+  true: StructuredText
+  false: StructuredText
+}
+
+/**
+ * "Is this statement true?" — answered with the calibrated probability that it
+ * is. `criteria` optionally spells out what makes the statement hold (true) or
+ * not (false) when the boundary is subtle.
+ */
+export interface BooleanQuestion {
+  type: 'boolean'
+  instructions: StructuredText
+  criteria?: BooleanCriteria
+}
+
+/**
+ * "Which one of these?" — `criteria` maps each option name to its description;
+ * options are unordered. Option-count limits are the provider's.
+ */
+export interface ChoiceQuestion<Option extends string = string> {
+  type: 'choice'
+  instructions: StructuredText
+  criteria: Record<Option, StructuredText>
+}
+
+/**
+ * "Where on this scale?" — `criteria` is the ordered list of level
+ * descriptions; the level number is the position (0-based). Every level must
+ * be described. Level-count limits are the provider's.
+ */
+export interface ScoreQuestion {
+  type: 'score'
+  instructions: StructuredText
+  criteria: StructuredText[]
+}
+
+/** One atomic question over the shared state, discriminated by `type`. */
+export type DecisionQuestion = BooleanQuestion | ChoiceQuestion | ScoreQuestion
+
+/** Caller-keyed questions; answers come back under the same keys. */
+export type DecisionQuestions = Record<string, DecisionQuestion>
+
+/**
+ * Body of `POST /agents/v1/models/decide` — one text-only state and a map of
+ * atomic questions answered in parallel with calibrated probabilities.
+ *
+ * Only `model.model_id` is meaningful for a decision; the sampling knobs of
+ * {@link ModelConfig} are rejected with `invalid_decision_request`.
+ */
+export interface DecideRequest<Questions extends DecisionQuestions = DecisionQuestions> {
+  model?: Partial<Pick<ModelConfig, 'model_id'>>
+  state: StructuredText
+  questions: Questions
+}
+
+/**
+ * Answer to a {@link BooleanQuestion}: `probability` is P(true); `boolean` is
+ * the argmax (probability > 0.5); `confidence` is |2p − 1|.
+ */
+export interface BooleanAnswer {
+  type: 'boolean'
+  boolean: boolean
+  probability: number
+  confidence: number
+}
+
+/**
+ * Answer to a {@link ChoiceQuestion}: `choice` is the highest-probability
+ * option; `probabilities` is the full distribution keyed by option name.
+ */
+export interface ChoiceAnswer<Option extends string = string> {
+  type: 'choice'
+  choice: Option
+  probabilities: Record<Option, number>
+  confidence: number
+}
+
+/**
+ * Answer to a {@link ScoreQuestion}: `score` is the probability-weighted mean
+ * of the level numbers (so it can fall between levels); `legend` echoes the
+ * level descriptions and `probabilities` the distribution, both indexed by
+ * level.
+ */
+export interface ScoreAnswer {
+  type: 'score'
+  score: number
+  legend: StructuredText[]
+  probabilities: number[]
+  confidence: number
+}
+
+/**
+ * The calibrated answer to one question, discriminated by `type`. Every
+ * variant carries `confidence` = (n·peak − 1)/(n − 1) over its distribution,
+ * so gating code can threshold without switching on the type.
+ */
+export type DecisionAnswer = BooleanAnswer | ChoiceAnswer | ScoreAnswer
+
+/** The answer type a given question produces (drives typed `answers`). */
+export type DecisionAnswerFor<Question extends DecisionQuestion> = Question extends BooleanQuestion
+  ? BooleanAnswer
+  : Question extends ChoiceQuestion<infer Option>
+    ? ChoiceAnswer<Option>
+    : Question extends ScoreQuestion
+      ? ScoreAnswer
+      : never
+
+/**
+ * The provider's reply to a {@link DecideRequest}: one answer per question key
+ * (typed from the questions you sent), the model that produced them, and token
+ * usage.
+ */
+export interface DecisionResult<Questions extends DecisionQuestions = DecisionQuestions> {
+  /** The model that produced the answers (resolved id, e.g. `jev-1.13.0`). */
+  model_id: string
+  answers: { [Key in keyof Questions]: DecisionAnswerFor<Questions[Key]> }
+  usage: ModelUsage
+}

package/src/agent/models.ts

@@ -0,0 +1,67 @@
+import type { ProteosClient } from '../client.js'
+import type {
+  DecideRequest,
+  DecisionQuestions,
+  DecisionResult,
+  GenerateRequest,
+  GenerationResult,
+} from './model-types.js'
+
+const MODELS_BASE_PATH = '/agents/v1/models'
+
+/**
+ * Service for the stateless model calls — one request in, one reply out, no
+ * session, no event log:
+ *
+ * - `generate` — free text or schema-constrained structured output from an LLM.
+ * - `decide` — calibrated typed answers (boolean | choice | score) with
+ *   probabilities and confidence, for snap judgments inside code paths
+ *   (routing, triage, classification, gates). No prose comes back; compose the
+ *   answers in code and threshold on `confidence`.
+ *
+ * Both need the `agent-sessions:write` permission.
+ */
+export interface ModelService {
+  /**
+   * Runs a single model call and returns the assistant message.
+   * @throws {ProteosError} 400 `invalid_generation_request` / `unsupported_file_type` /
+   *   `model_provider_rejected_request`; 429 `model_provider_rate_limited`;
+   *   502 `model_provider_failed`.
+   */
+  generate(request: GenerateRequest): Promise<GenerationResult>
+  /**
+   * Answers typed questions about a text state with calibrated probabilities.
+   * `answers` is typed from the `questions` you pass, so
+   * `result.answers.topic.choice` narrows to the option names you declared.
+   *
+   * Semantic limits (option / level counts, empty questions, unknown model ids)
+   * are the provider's and surface as `decision_provider_rejected_request` with
+   * its message.
+   * @throws {ProteosError} 400 `invalid_decision_request` (shape) /
+   *   `decision_provider_rejected_request` (provider rule); 429
+   *   `decision_provider_rate_limited`; 502 `decision_provider_failed` /
+   *   `decision_provider_invalid_response`; 503 `decision_provider_unavailable`
+   *   when the provider key is not configured.
+   */
+  decide<Questions extends DecisionQuestions>(
+    request: DecideRequest<Questions>,
+  ): Promise<DecisionResult<Questions>>
+}
+
+export class ModelServiceImpl implements ModelService {
+  constructor(private readonly client: ProteosClient) {}
+
+  async generate(request: GenerateRequest): Promise<GenerationResult> {
+    return this.client.request<GenerationResult>('POST', `${MODELS_BASE_PATH}/generate`, request)
+  }
+
+  async decide<Questions extends DecisionQuestions>(
+    request: DecideRequest<Questions>,
+  ): Promise<DecisionResult<Questions>> {
+    return this.client.request<DecisionResult<Questions>>(
+      'POST',
+      `${MODELS_BASE_PATH}/decide`,
+      request,
+    )
+  }
+}

package/src/data/types.ts

@@ -16,14 +16,17 @@ export type RecordData = Record<string, any>
  *
  * Arbitrary filter keys pass through as query params. Supported operators
  * (via bracket syntax) include `[eq]`, `[ne]`, `[gt]`, `[gte]`, `[lt]`,
- * `[lte]`, `[in]` (pipe-separated), `[not_in]`, `[contains]`, `[starts_with]`,
- * `[ends_with]`, `[empty]`, `[not_empty]`. Missing operator defaults to `[eq]`.
+ * `[lte]`, `[in]` (pipe-separated), `[not_in]`, `[contains]`, `[not_contains]`,
+ * `[contains_all]` (pipe-separated, arrays only), `[starts_with]`, `[ends_with]`,
+ * `[empty]`, `[not_empty]`. Missing operator defaults to `[eq]`. On array
+ * attributes contains / not_contains / in / not_in / contains_all are
+ * set-membership tests (has / does not have / has any of / has none of / has all of).
  * A filter key may reach one hop through a relation attribute with a dotted
  * path (`"company_id.name[contains]": "acme"`).
  *
  * For nested AND/OR trees, pass a filter group (the same wire dialect as
  * `List.filters` / `visible_when`: `{logical_operator, elements: [{field,
- * operator, value}], groups}`, string values, pipe-joined for in/not_in)
+ * operator, value}], groups}`, string values, pipe-joined for in/not_in/contains_all)
  * JSON-encoded under the reserved `_filter` key:
  * `{ _filter: JSON.stringify(group) }`. The server ANDs it with any flat
  * filter params.

package/src/index.ts

@@ -34,7 +34,7 @@
  * @packageDocumentation
  */
 
-// Agent client (agent-service: agents, prompts, skills, tools, mcp-servers, sessions)
+// Agent client (agent-service: agents, prompts, skills, tools, mcp-servers, models, sessions)
 export type {
   ActionBinding,
   Agent,
@@ -43,6 +43,11 @@ export type {
   AgentResourceListOptions,
   AgentService,
   AppendEventRequest,
+  BooleanAnswer,
+  BooleanCriteria,
+  BooleanQuestion,
+  ChoiceAnswer,
+  ChoiceQuestion,
   ClientEventType,
   ClientToolSchema,
   ContentBlock,
@@ -53,12 +58,21 @@ export type {
   CreateSessionRequest,
   CreateToolRequest,
   CreateToolsetRequest,
+  DecideRequest,
+  DecisionAnswer,
+  DecisionAnswerFor,
+  DecisionQuestion,
+  DecisionQuestions,
+  DecisionQuestionType,
+  DecisionResult,
   DependentAgent,
   DependentSyncResult,
   EmptyPayload,
   ErrorPayload,
   EventType,
   FileBlock,
+  GenerateRequest,
+  GenerationResult,
   ListAgentsOptions,
   ListMcpServersOptions,
   ListPromptsOptions,
@@ -77,6 +91,8 @@ export type {
   ModelConfig,
   ModelRequestEndPayload,
   ModelRequestStartPayload,
+  ModelService,
+  ModelStopReason,
   ModelUsage,
   PlatformBinding,
   Prompt,
@@ -85,6 +101,8 @@ export type {
   QueryBinding,
   ReasoningPayload,
   ResultBlock,
+  ScoreAnswer,
+  ScoreQuestion,
   Session,
   SessionEvent,
   SessionEventEnvelope,
@@ -100,6 +118,7 @@ export type {
   SkillVersion,
   StartMcpOAuthResponse,
   StopReason,
+  StructuredText,
   TextBlock,
   Tool,
   ToolBinding,

package/src/meta/filters.ts

@@ -19,6 +19,8 @@ export type ComparisonOperator =
   | 'in'
   | 'not_in'
   | 'contains'
+  | 'not_contains'
+  | 'contains_all'
   | 'starts_with'
   | 'ends_with'
   | 'empty'
@@ -27,8 +29,11 @@ export type ComparisonOperator =
 /**
  * Single filter element (atomic predicate).
  *
- * `value` is a string at the wire level — pipe-joined for `in` / `not_in`,
- * ignored for `empty` / `not_empty`. This matches the data-service URL query
+ * `value` is a string at the wire level — pipe-joined for the list operators
+ * `in` / `not_in` / `contains_all`, ignored for `empty` / `not_empty`. On array
+ * attributes the membership operators are set tests: `contains` = has the
+ * value, `not_contains` = does not have it, `in` = has any of, `not_in` = has
+ * none of, `contains_all` = has all of. This matches the data-service URL query
  * convention so the same predicate flows through both the GET-with-filters
  * path and the layout `visible_when` JSONB path without a translation layer.
  */
@@ -60,6 +65,8 @@ export const FilterElementSchema = z.object({
     'in',
     'not_in',
     'contains',
+    'not_contains',
+    'contains_all',
     'starts_with',
     'ends_with',
     'empty',

package/src/meta/index.ts

@@ -164,6 +164,12 @@ export type { MenuConfigurationService } from './menu-configurations.js'
 export type { ModuleService } from './modules.js'
 export type { PageExtensionService } from './page-extensions.js'
 export type { PageService } from './pages.js'
+export {
+  isReservedAttributeName,
+  isTitleQueryable,
+  RECORD_TITLE_FIELD,
+  titleTemplateVariables,
+} from './record-title.js'
 // Re-export types
 export type {
   // App types