address model gaps

packages/api/src/activities/activity.ts

@@ -69,6 +69,7 @@ export interface IActivity<T extends string = string> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 
@@ -172,6 +173,7 @@ export class Activity<T extends string = string> implements IActivity<T> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 
@@ -277,6 +279,9 @@ export class Activity<T extends string = string> implements IActivity<T> {
     return this;
   }
 
+  /**
+   * @deprecated This will be removed by end of summer 2026.
+   */
   withRelatesTo(value: ConversationReference) {
     this.relatesTo = value;
     return this;

packages/api/src/activities/conversation/end-of-conversation.ts

@@ -1,5 +1,8 @@
 import { IActivity } from '../activity';
 
+/**
+ * @deprecated This will be removed by end of summer 2026.
+ */
 export type EndOfConversationCode =
   | 'unknown'
   | 'completedSuccessfully'
@@ -8,6 +11,9 @@ export type EndOfConversationCode =
   | 'botIssuedInvalidMessage'
   | 'channelFailed';
 
+/**
+ * @deprecated This will be removed by end of summer 2026.
+ */
 export interface IEndOfConversationActivity extends IActivity<'endOfConversation'> {
   /**
    * The a code for endOfConversation activities that indicates why the conversation ended.

packages/api/src/activities/handoff.ts

@@ -1,3 +1,6 @@
 import { IActivity } from './activity';
 
+/**
+ * @deprecated This will be removed by end of summer 2026.
+ */
 export interface IHandoffActivity extends IActivity<'handoff'> {}

packages/api/src/activities/invoke/config/config-fetch.ts

@@ -14,6 +14,7 @@ export interface IConfigFetchInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/config/config-submit.ts

@@ -14,6 +14,7 @@ export interface IConfigSubmitInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/execute-action.ts

@@ -14,6 +14,7 @@ export interface IExecuteActionInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/file-consent.ts

@@ -14,6 +14,7 @@ export interface IFileConsentInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/handoff-action.ts

@@ -19,6 +19,7 @@ export interface IHandoffActionInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/anon-query-link.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionAnonQueryLinkInvokeActivity extends IActivity<
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/card-button-clicked.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionCardButtonClickedInvokeActivity extends IActiv
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/fetch-task.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionFetchTaskInvokeActivity extends IActivity<'inv
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/query-link.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionQueryLinkInvokeActivity extends IActivity<'inv
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/query-setting-url.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionQuerySettingUrlInvokeActivity extends IActivit
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/query.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionQueryInvokeActivity extends IActivity<'invoke'
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/select-item.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionSelectItemInvokeActivity extends IActivity<'in
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/setting.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionSettingInvokeActivity extends IActivity<'invok
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message-extension/submit-action.ts

@@ -14,6 +14,7 @@ export interface IMessageExtensionSubmitActionInvokeActivity extends IActivity<'
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/message/submit-action.ts

@@ -34,6 +34,7 @@ export interface IMessageSubmitActionInvokeActivity extends IActivity<'invoke'>
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/tab/tab-fetch.ts

@@ -14,6 +14,7 @@ export interface ITabFetchInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/tab/tab-submit.ts

@@ -14,6 +14,7 @@ export interface ITabSubmitInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/task/task-fetch.ts

@@ -14,6 +14,7 @@ export interface ITaskFetchInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/invoke/task/task-submit.ts

@@ -14,6 +14,7 @@ export interface ITaskSubmitInvokeActivity extends IActivity<'invoke'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }

packages/api/src/activities/message/message-update.ts

@@ -9,6 +9,7 @@ export interface IMessageUpdateActivity extends IActivity<'messageUpdate'> {
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   speak?: string;
 
@@ -20,6 +21,7 @@ export interface IMessageUpdateActivity extends IActivity<'messageUpdate'> {
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   expiration?: Date;
 
@@ -44,6 +46,7 @@ export class MessageUpdateActivity
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   speak?: string;
 
@@ -55,6 +58,7 @@ export class MessageUpdateActivity
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   expiration?: Date;
 
@@ -123,6 +127,7 @@ export class MessageUpdateActivity
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   withSpeak(value: string) {
     this.speak = value;
@@ -140,6 +145,7 @@ export class MessageUpdateActivity
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   withExpiration(value: Date) {
     this.expiration = value;

packages/api/src/activities/message/message.ts

@@ -23,13 +23,15 @@ export interface IMessageActivity extends IActivity<'message'> {
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   speak?: string;
 
   /**
    * Indicates whether your bot is accepting,
    * expecting, or ignoring user input after the message is delivered to the client. Possible
    * values include: 'acceptingInput', 'ignoringInput', 'expectingInput'
+   * @deprecated This will be removed by end of summer 2026.
    */
   inputHint?: InputHint;
 
@@ -61,6 +63,7 @@ export interface IMessageActivity extends IActivity<'message'> {
 
   /**
    * The importance of the activity. Possible values include: 'low', 'normal', 'high'
+   * @deprecated This will be removed by end of summer 2026.
    */
   importance?: Importance;
 
@@ -73,6 +76,7 @@ export interface IMessageActivity extends IActivity<'message'> {
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   expiration?: Date;
 
@@ -105,13 +109,15 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   speak?: string;
 
   /**
    * Indicates whether your bot is accepting,
    * expecting, or ignoring user input after the message is delivered to the client. Possible
    * values include: 'acceptingInput', 'ignoringInput', 'expectingInput'
+   * @deprecated This will be removed by end of summer 2026.
    */
   inputHint?: InputHint;
 
@@ -143,6 +149,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
 
   /**
    * The importance of the activity. Possible values include: 'low', 'normal', 'high'
+   * @deprecated This will be removed by end of summer 2026.
    */
   importance?: Importance;
 
@@ -155,6 +162,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   expiration?: Date;
 
@@ -213,6 +221,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
 
   /**
    * The text to speak.
+   * @deprecated This will be removed by end of summer 2026.
    */
   withSpeak(value: string) {
     this.speak = value;
@@ -223,6 +232,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
    * Indicates whether your bot is accepting,
    * expecting, or ignoring user input after the message is delivered to the client. Possible
    * values include: 'acceptingInput', 'ignoringInput', 'expectingInput'
+   * @deprecated This will be removed by end of summer 2026.
    */
   withInputHint(value: InputHint) {
     this.inputHint = value;
@@ -264,6 +274,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
 
   /**
    * The importance of the activity. Possible values include: 'low', 'normal', 'high'
+   * @deprecated This will be removed by end of summer 2026.
    */
   withImportance(value: Importance) {
     this.importance = value;
@@ -282,6 +293,7 @@ export class MessageActivity extends Activity<'message'> implements IMessageActi
   /**
    * The time at which the activity should be considered to be "expired" and should not be
    * presented to the recipient.
+   * @deprecated This will be removed by end of summer 2026.
    */
   withExpiration(value: Date) {
     this.expiration = value;

packages/api/src/activities/trace.ts

@@ -2,6 +2,9 @@ import { ConversationReference } from '../models';
 
 import { IActivity } from './activity';
 
+/**
+ * @deprecated This will be removed by end of summer 2026.
+ */
 export interface ITraceActivity extends IActivity<'trace'> {
   /**
    * The name of the operation associated with an invoke or event activity.
@@ -25,6 +28,7 @@ export interface ITraceActivity extends IActivity<'trace'> {
 
   /**
    * A reference to another conversation or activity.
+   * @deprecated This will be removed by end of summer 2026.
    */
   relatesTo?: ConversationReference;
 }