refactor(knowledge): compose copilot batch commands

Author: TheodoreSpeaks

apps/sim/lib/copilot/application/execute-knowledge-use-case.ts

@@ -21,10 +21,15 @@ const registeredKnowledgeOperationIds = new Set<string>(
   Object.values(knowledgeOperations).map((operation) => operation.id)
 )
 
-/** Normalizes immutable Copilot execution identity into a knowledge delegation. */
-export function resolveCopilotKnowledgePrincipal(
+type TrustedCopilotKnowledgeDelegationContext = CopilotKnowledgeDelegationContext & {
+  workspaceId: string
+  toolCallId: string
+  copilotToolExecution: true
+}
+
+function requireTrustedCopilotKnowledgeContext(
   context: CopilotKnowledgeDelegationContext | undefined
-): DelegatedPrincipal {
+): TrustedCopilotKnowledgeDelegationContext {
   if (!context) throw new Error('Knowledge delegation requires a Copilot execution context')
   if (!context.copilotToolExecution) {
     throw new Error('Knowledge delegation requires a trusted Copilot execution context')
@@ -33,7 +38,23 @@ export function resolveCopilotKnowledgePrincipal(
   if (!context.workspaceId) throw new Error('Knowledge delegation requires a workspace ID')
   if (!context.toolCallId) throw new Error('Knowledge delegation requires a tool call ID')
 
-  return createCopilotWorkspacePrincipal(context, {
+  return context as TrustedCopilotKnowledgeDelegationContext
+}
+
+/** Requires the immutable trusted workspace bound to a Copilot Knowledge execution. */
+export function requireCopilotKnowledgeWorkspaceId(
+  context: CopilotKnowledgeDelegationContext | undefined
+): string {
+  return requireTrustedCopilotKnowledgeContext(context).workspaceId
+}
+
+/** Normalizes immutable Copilot execution identity into a knowledge delegation. */
+export function resolveCopilotKnowledgePrincipal(
+  context: CopilotKnowledgeDelegationContext | undefined
+): DelegatedPrincipal {
+  const trustedContext = requireTrustedCopilotKnowledgeContext(context)
+
+  return createCopilotWorkspacePrincipal(trustedContext, {
     audience: KNOWLEDGE_DELEGATION_AUDIENCE,
   })
 }