Rename Dynamic Workflows to Agent Orchestrations

Renames the authoring surface from "workflow" to "orchestration" to match
the new product name "agent orchestrations":

- defineWorkflow -> defineOrchestration; WorkflowContext/Definition/Handle/
  Meta/Limits -> Orchestration*; SessionWorkflowApi -> SessionOrchestrationApi
  (session.orchestration); WorkflowRunError -> OrchestrationRunError.
- joinSession({ workflows }) -> joinSession({ orchestrations }).
- workflow.ts -> orchestration.ts (and its test); generated/rpc.ts regenerated
  from the renamed runtime contract (workflow.* -> orchestration.*).

The context primitives (step, agent, parallel, pipeline, phase, log, run) keep
their names. Companion runtime rename lands in github/copilot-agent-runtime#12953.

Author: MRayermannMSFT

nodejs/src/client.ts

@@ -85,7 +85,7 @@ import type {
     TypedSessionLifecycleHandler,
 } from "./types.js";
 import { defaultJoinSessionPermissionHandler } from "./types.js";
-import type { WorkflowHandle } from "./workflow.js";
+import type { OrchestrationHandle } from "./orchestration.js";
 
 /**
  * Minimum protocol version this SDK can communicate with.
@@ -1671,15 +1671,15 @@ export class CopilotClient {
     async resumeSessionForExtension(
         sessionId: string,
         config: ResumeSessionConfig,
-        workflows?: WorkflowHandle[]
+        orchestrations?: OrchestrationHandle[]
     ): Promise<CopilotSession> {
-        return this.resumeSessionInternal(sessionId, config, workflows);
+        return this.resumeSessionInternal(sessionId, config, orchestrations);
     }
 
     private async resumeSessionInternal(
         sessionId: string,
         config: ResumeSessionConfig,
-        workflows?: WorkflowHandle[]
+        orchestrations?: OrchestrationHandle[]
     ): Promise<CopilotSession> {
         if (!this.connection) {
             await this.start();
@@ -1697,7 +1697,7 @@ export class CopilotClient {
         session.registerTools(config.tools);
         session.registerCanvases(config.canvases);
         session.registerCommands(config.commands);
-        session.registerWorkflows(workflows);
+        session.registerOrchestrations(orchestrations);
         const {
             wireProvider: bearerWireProvider,
             wireProviders: bearerWireProviders,
@@ -1769,7 +1769,7 @@ export class CopilotClient {
                 })),
                 toolSearch: config.toolSearch,
                 canvases: config.canvases?.map((canvas) => canvas.declaration),
-                workflows: workflows?.map((workflow) => workflow.meta),
+                orchestrations: orchestrations?.map((orchestration) => orchestration.meta),
                 requestCanvasRenderer: config.requestCanvasRenderer,
                 requestExtensions: config.requestExtensions,
                 extensionSdkPath: config.extensionSdkPath,

nodejs/src/extension.ts

@@ -9,7 +9,7 @@ import {
     type PermissionHandler,
     type ResumeSessionConfig,
 } from "./types.js";
-import type { WorkflowHandle } from "./workflow.js";
+import type { OrchestrationHandle } from "./orchestration.js";
 
 export {
     Canvas,
@@ -28,28 +28,28 @@ export type JoinSessionConfig = Omit<
 > & {
     onPermissionRequest?: PermissionHandler;
     /**
-     * Workflow handles to register when the extension joins the session.
+     * Orchestration handles to register when the extension joins the session.
      *
-     * @experimental Part of the experimental Dynamic Workflows surface and may
+     * @experimental Part of the experimental Agent Orchestrations surface and may
      * change or be removed in future SDK or CLI releases.
      */
-    workflows?: WorkflowHandle[];
+    orchestrations?: OrchestrationHandle[];
 };
 
-export type { ExtensionInfo, WorkflowLimits, WorkflowMeta } from "./types.js";
+export type { ExtensionInfo, OrchestrationLimits, OrchestrationMeta } from "./types.js";
 export {
-    defineWorkflow,
-    WorkflowRunError,
+    defineOrchestration,
+    OrchestrationRunError,
     type RunOptions,
-    type SessionWorkflowApi,
-    type WorkflowAgentOptions,
-    type WorkflowContext,
-    type WorkflowDefinition,
-    type WorkflowHandle,
-    type WorkflowJsonSchema,
-    type WorkflowPipelineStage,
-    type WorkflowStepOptions,
-} from "./workflow.js";
+    type SessionOrchestrationApi,
+    type OrchestrationAgentOptions,
+    type OrchestrationContext,
+    type OrchestrationDefinition,
+    type OrchestrationHandle,
+    type OrchestrationJsonSchema,
+    type OrchestrationPipelineStage,
+    type OrchestrationStepOptions,
+} from "./orchestration.js";
 
 /**
  * Joins the current foreground session.
@@ -80,7 +80,7 @@ export async function joinSession(config: JoinSessionConfig = {}): Promise<Copil
     // already been forked by the host with the SDK the host chose.
     const {
         extensionSdkPath: _stripped,
-        workflows,
+        orchestrations,
         ...rest
     } = config as JoinSessionConfig & {
         extensionSdkPath?: string;
@@ -94,6 +94,6 @@ export async function joinSession(config: JoinSessionConfig = {}): Promise<Copil
             onPermissionRequest: config.onPermissionRequest ?? defaultJoinSessionPermissionHandler,
             suppressResumeEvent: config.suppressResumeEvent ?? true,
         },
-        workflows
+        orchestrations
     );
 }