@proteos/sdk 0.61.0 → 0.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.61.0",
+  "version": "0.75.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/session-types.ts

@@ -149,9 +149,16 @@ export interface ResultBlock {
 // Event payloads (discriminated by the sibling event `type`)
 // ---------------------------------------------------------------------------
 
-/** A user message body (text + file blocks). */
+/**
+ * A user message body (text + file blocks). `context` is what the launching
+ * surface hands the model alongside the message (a call's summary and linked
+ * records, say): stored with the event, sent to the model as an extra text
+ * block, never rendered as part of the person's message. Not for secrets —
+ * the session owner can read it back through the events API.
+ */
 export interface UserMessagePayload {
   content: ContentBlock[]
+  context?: string
 }
 
 /** An agent message body (text blocks only). */

package/src/agent/sessions.ts

@@ -61,11 +61,12 @@ export interface SessionService {
    * attachments. Each {@link FileBlock} carries the storage-service `file_id`; the
    * backend uploads it to the model provider and mounts it into the agent's sandbox
    * at send time. Pass `turnId` (a UUID) for optimistic rendering. At least one of
-   * `text` / `files` should be present.
+   * `text` / `files` should be present. `context` rides the payload for the model
+   * only (see {@link UserMessagePayload.context}).
    */
   sendUserMessage(
     id: string,
-    input: { text?: string; files?: FileBlock[]; turnId?: string },
+    input: { text?: string; files?: FileBlock[]; turnId?: string; context?: string },
   ): Promise<SessionEvent>
   /** Convenience: appends a `user.interrupt` to halt the running turn. */
   interrupt(id: string): Promise<SessionEvent>
@@ -149,7 +150,7 @@ export class SessionServiceImpl implements SessionService {
 
   async sendUserMessage(
     id: string,
-    input: { text?: string; files?: FileBlock[]; turnId?: string },
+    input: { text?: string; files?: FileBlock[]; turnId?: string; context?: string },
   ): Promise<SessionEvent> {
     const content: ContentBlock[] = []
     const text = input.text?.trim()
@@ -157,10 +158,11 @@ export class SessionServiceImpl implements SessionService {
     for (const file of input.files ?? []) {
       content.push({ type: 'file', ...file })
     }
+    const context = input.context?.trim()
     return this.appendEvent(id, {
       type: 'user.message',
       ...(input.turnId ? { turn_id: input.turnId } : {}),
-      payload: { content },
+      payload: { content, ...(context ? { context } : {}) },
     })
   }
 

package/src/agent/types.ts

@@ -68,6 +68,13 @@ export interface Agent extends AuditFields {
   toolsets: string[]
   /** Marks the single agent surfaced by default for the org (at most one). */
   is_org_default: boolean
+  /**
+   * Runs beside the tabbed workspace in the web app: the platform appends the
+   * workspace-mode instructions (open_tab / switch_tab / close_tab, app context) to
+   * the synced system prompt and the web client offers the tab tools instead of
+   * navigate / open_record.
+   */
+  has_workspace: boolean
   version: number
 }
 
@@ -84,6 +91,7 @@ export interface CreateAgentRequest {
   mcp_servers?: string[]
   toolsets?: string[]
   is_org_default?: boolean
+  has_workspace?: boolean
 }
 
 export interface UpdateAgentRequest {
@@ -98,6 +106,7 @@ export interface UpdateAgentRequest {
   mcp_servers?: string[]
   toolsets?: string[]
   is_org_default?: boolean
+  has_workspace?: boolean
 }
 
 export type ListAgentsOptions = AgentResourceListOptions

package/src/auth/platform-entities.ts

@@ -107,12 +107,18 @@ export const PLATFORM_ENTITIES: readonly PlatformEntity[] = [
   { slug: 'channel-events', name: 'Channel Events' },
   // Conversation briefs: guidance prepared ahead of a conversation (call, meeting) with a contact.
   { slug: 'conversation-briefs', name: 'Conversation Briefs' },
+  // Conversation notes: what a person recorded about a conversation (append log, author-stamped).
+  { slug: 'conversation-notes', name: 'Conversation Notes' },
   // Conversation intelligence: the typed questions asked of conversations
   // (definitions), where/when they are evaluated (sets), and the observations
   // they produce incl. their evaluation history (tags).
   { slug: 'conversation-tag-definitions', name: 'Conversation Tag Definitions' },
   { slug: 'conversation-tag-sets', name: 'Conversation Tag Sets' },
   { slug: 'conversation-tags', name: 'Conversation Tags' },
+  // Conversation objectives: what a conversation should achieve (definitions)
+  // and each definition's standing per conversation (objectives, read-only ledger).
+  { slug: 'conversation-objective-definitions', name: 'Conversation Objective Definitions' },
+  { slug: 'conversation-objectives', name: 'Conversation Objectives' },
   // Connectors (connector-service). `connections` above is shared; this is the
   // manifest catalog.
   { slug: 'connectors', name: 'Connectors' },

package/src/client.ts

@@ -1,5 +1,5 @@
 import { type EventSourceMessage, fetchEventSource } from '@microsoft/fetch-event-source'
-import { ProteosError, parseErrorResponse } from './errors.js'
+import { ErrorCode, ProteosError, parseErrorResponse } from './errors.js'
 import { toQueryParams } from './http/query-params.js'
 import {
   type ClientOptions,
@@ -132,6 +132,30 @@ export class ProteosClient {
     return AbortSignal.timeout(timeout)
   }
 
+  /**
+   * Runs fetch and turns a transport failure — DNS, connection refused, the
+   * network being down, the timeout signal firing — into a ProteosError with
+   * httpStatus 0, so callers can tell "the server said no" from "the server
+   * was never reached" (the latter is worth retrying). An abort the caller
+   * asked for is theirs and passes through untouched.
+   */
+  private async send(url: string, init: RequestInit): Promise<Response> {
+    try {
+      return await this.options.fetch(url, init)
+    } catch (error) {
+      if (error instanceof Error && error.name === 'AbortError') throw error
+      const message = error instanceof Error ? error.message : 'Network request failed'
+      const isTimeout =
+        error instanceof Error &&
+        (error.name === 'TimeoutError' || error.message.startsWith('Request timeout'))
+      throw new ProteosError(
+        message,
+        0,
+        isTimeout ? ErrorCode.REQUEST_TIMEOUT : ErrorCode.NETWORK_ERROR,
+      )
+    }
+  }
+
   /**
    * Performs an HTTP request and decodes the JSON response.
    *
@@ -182,7 +206,7 @@ export class ProteosClient {
     const headers = await this.buildHeaders(requestOptions)
     const signal = this.createTimeoutSignal(requestOptions)
 
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: body !== undefined ? JSON.stringify(body) : null,
@@ -247,7 +271,7 @@ export class ProteosClient {
 
     const signal = this.createTimeoutSignal(requestOptions)
 
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: formData,
@@ -287,7 +311,7 @@ export class ProteosClient {
     const headers = await this.buildHeaders(requestOptions)
     const signal = this.createTimeoutSignal(requestOptions)
 
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: body !== undefined ? JSON.stringify(body) : null,