@proteos/sdk 0.32.0 → 0.33.0

package/src/conversation/index.ts

@@ -106,10 +106,17 @@ export interface MeetingService {
   /** Make the bot leave the meeting and end the conversation (by conversation id). */
   remove(conversationId: string): Promise<Conversation>
   /**
-   * Regenerate this meeting conversation's markdown summary from its stored
-   * transcript, overwriting any existing one. Resolves with the updated
-   * conversation (its fresh `summary`). Rejects with `no_transcript` when the
-   * conversation has no completed transcript to summarize.
+   * START regenerating this meeting conversation's markdown summary from its
+   * stored transcript, overwriting any existing one when it lands. Generation
+   * runs server-side beyond this request, so the promise resolves as soon as the
+   * conversation is CLAIMED — with `summary_status: 'processing'` and the OLD
+   * `summary` still attached. Poll `conversations.get(id)` until
+   * `summary_status` is `completed` (or `failed`) to read the new one.
+   *
+   * Rejects with `no_transcript` when the conversation has no completed
+   * transcript to summarize, `summarization_unavailable` when the environment
+   * has no generator configured, and `summary_in_progress` when a generation is
+   * already running for this conversation.
    */
   summarize(conversationId: string): Promise<Conversation>
 }

package/src/conversation/types.ts

@@ -41,6 +41,7 @@ export type Channel =
 export type ConnectorKey =
   | 'slack'
   | 'gmail'
+  | 'outlook'
   | 'echo'
   | 'unipile-whatsapp'
   | 'unipile-linkedin'
@@ -73,6 +74,15 @@ export type ConnectionStatus = 'pending' | 'active' | 'error' | 'revoked'
  * drafting) — hidden from the default list until the first successful send.
  */
 export type ConversationStatus = 'active' | 'ended' | 'archived' | 'draft'
+/**
+ * Generation lifecycle of a conversation's `summary`. `none` is the resting
+ * default — no summary exists and none is being produced, the state of every
+ * conversation that is not a transcript-backed meeting. `processing` is claimed
+ * for the duration of one generation run (automatic at transcript attach, or a
+ * manual `meetings.summarize()`), so any client can render "Summarizing…"
+ * without having started the run itself.
+ */
+export type ConversationSummaryStatus = 'none' | 'processing' | 'completed' | 'failed'
 export type AgentListenerTriggerType = 'always' | 'mention' | 'channel' | 'keyword'
 
 export interface UserRef {
@@ -207,6 +217,16 @@ export interface Conversation {
    * conversations, editable via update(). Absent when no summary exists.
    */
   summary?: string
+  /**
+   * Generation lifecycle of `summary`. Poll `conversations.get(id)` while this
+   * reads `processing` to pick up the finished summary.
+   */
+  summary_status: ConversationSummaryStatus
+  /**
+   * When the current `processing` run was claimed; absent otherwise. Bounds the
+   * claim server-side and gives clients an elapsed time to show.
+   */
+  summary_started_at?: string
   status: ConversationStatus
   /**
    * Room directory row a room-borne thread (Slack channel conversation) lives

package/src/index.ts

@@ -52,6 +52,8 @@ export type {
   CreatePromptRequest,
   CreateSessionRequest,
   CreateToolRequest,
+  DependentAgent,
+  DependentSyncResult,
   EmptyPayload,
   ErrorPayload,
   EventType,
@@ -221,6 +223,7 @@ export type {
   ConversationParticipant,
   ConversationService,
   ConversationStatus,
+  ConversationSummaryStatus,
   CreateAgentListenerRequest,
   CreateConnectionRequest,
   CreateConversationFilterRequest,
@@ -587,7 +590,6 @@ export {
 } from './types/index.js'
 export type {
   AgentActionParams,
-  AgentKickoff,
   BinaryRef,
   ConnectionEndpoint,
   CreateWorkflowRequest,
@@ -611,7 +613,6 @@ export type {
   ListExecutionsOptions,
   ListWorkflowsOptions,
   ManualTriggerParams,
-  MessageKickoff,
   MessageTriggerParams,
   NodeDescriptor,
   NodeExecution,
@@ -625,8 +626,6 @@ export type {
   NodeTypeService,
   NodeTypeStatus,
   OnErrorPolicy,
-  OutcomeKickoff,
-  OutcomeRubric,
   PairedItem,
   PortSpec,
   PropertyOption,
@@ -641,7 +640,6 @@ export type {
   WebhookTriggerParams,
   Workflow,
   WorkflowConnection,
-  WorkflowContentBlock,
   WorkflowExecution,
   WorkflowGraph,
   WorkflowNode,

package/src/meta/layout/elements.ts

@@ -100,6 +100,12 @@ export type ComponentElement = CommonProps & {
   type: 'component'
   component_slug: string
   props?: Record<string, unknown>
+  /** Placeholder height (px) reserved while the component bundle loads, used
+   *  ONLY when `height` is unset/auto. Does not constrain the rendered
+   *  component — it auto-sizes to real content after load. Reserving roughly
+   *  the right space keeps the reveal from shoving content below it. Defaults
+   *  to the host's 80px fallback when unset. */
+  reserved_height?: number
 }
 
 export type DividerElement = CommonProps & {
@@ -195,6 +201,7 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       ...commonPropsShape,
       component_slug: z.string().min(1),
       props: z.record(z.unknown()).optional(),
+      reserved_height: z.number().positive().optional(),
     }),
     z.object({
       type: z.literal('divider'),

package/src/workflow/index.ts

@@ -42,7 +42,6 @@ export type { ExecutionService } from './executions.js'
 export type { NodeTypeService } from './node-types.js'
 export type {
   AgentActionParams,
-  AgentKickoff,
   BinaryRef,
   ConnectionEndpoint,
   CreateWorkflowRequest,
@@ -66,7 +65,6 @@ export type {
   ListExecutionsOptions,
   ListWorkflowsOptions,
   ManualTriggerParams,
-  MessageKickoff,
   MessageTriggerParams,
   NodeDescriptor,
   NodeExecution,
@@ -79,8 +77,6 @@ export type {
   NodeTypeKey,
   NodeTypeStatus,
   OnErrorPolicy,
-  OutcomeKickoff,
-  OutcomeRubric,
   PairedItem,
   PortSpec,
   PropertyOption,
@@ -95,7 +91,6 @@ export type {
   WebhookTriggerParams,
   Workflow,
   WorkflowConnection,
-  WorkflowContentBlock,
   WorkflowExecution,
   WorkflowGraph,
   WorkflowNode,

package/src/workflow/types.ts

@@ -13,6 +13,7 @@
  * workflow; per-node results live in append-only NodeExecution rows.
  */
 
+import type { Attribute } from '../meta/types.js'
 import type { AuditFields, ListOptions, UserRef } from '../types/common.js'
 
 // ---------------------------------------------------------------------------
@@ -163,6 +164,8 @@ export type PropertyType =
   | 'fixed_collection'
   | 'credentials_select'
   | 'button'
+  /** Edits a platform attribute list (`Attribute[]`) via the shared attribute schema builder. */
+  | 'attribute_schema'
   // Wave 2 (editor support lands with Phase 3):
   | 'resource_locator'
   | 'resource_mapper'
@@ -358,51 +361,36 @@ export interface MessageTriggerParams {
 export type KickoffType = 'message' | 'outcome'
 
 /**
- * Where a kickoff draws its instruction text from: typed inline (`manual`) or
- * resolved from a reusable agent-service Prompt by key (`prompt`) at run time.
+ * Where a kickoff slot draws its instruction text from: typed inline
+ * (`manual`) or resolved from a reusable agent-service Prompt by key
+ * (`prompt`) at run time.
  */
 export type KickoffSource = 'manual' | 'prompt'
 
-export interface WorkflowContentBlock {
-  type: 'text' | 'file'
-  text?: string
-  file_id?: string
-}
-
-export interface MessageKickoff {
-  source?: KickoffSource
-  /** Inline content blocks (manual source). */
-  content?: WorkflowContentBlock[]
-  /** Prompt key whose body becomes the message text (prompt source). */
-  prompt_key?: string
-}
-
-export interface OutcomeRubric {
-  type: 'text' | 'file'
-  content?: string
-  file_id?: string
-}
-
-export interface OutcomeKickoff {
-  /** Description and rubric are independently sourced (manual vs prompt). */
+/**
+ * Flat, descriptor-driven parameters of the `action.agent` node (gated by
+ * display_options on `kickoff_type` / `*_source`). `output_schema` declares
+ * the node's structured output as platform attributes — the agent records it
+ * via the session-scoped `set_output` tool; `is_output_required` fails the
+ * node when the agent finishes without setting it.
+ */
+export interface AgentActionParams {
+  agent_key: string
+  kickoff_type: KickoffType
+  message_source?: KickoffSource
+  message_text?: string
+  message_prompt_key?: string
   description_source?: KickoffSource
   description?: string
   description_prompt_key?: string
   rubric_source?: KickoffSource
-  rubric?: OutcomeRubric
+  rubric_type?: 'text' | 'file'
+  rubric_content?: string
+  rubric_file_id?: string
   rubric_prompt_key?: string
   max_iterations?: number
-}
-
-export interface AgentKickoff {
-  type: KickoffType
-  message?: MessageKickoff
-  outcome?: OutcomeKickoff
-}
-
-export interface AgentActionParams {
-  agent_key: string
-  kickoff: AgentKickoff
+  output_schema?: Attribute[]
+  is_output_required?: boolean
 }
 
 // ---------------------------------------------------------------------------