feat(types): add tailor.context.getInvoker types

.changeset/add-context-get-invoker.md

@@ -0,0 +1,5 @@
+---
+"@tailor-platform/function-types": patch
+---
+
+Add `tailor.context` namespace with `getInvoker()` for retrieving information about the invoker of the current function execution

packages/types/tailor.d.ts

@@ -495,4 +495,28 @@ declare namespace tailor.workflow {
         key: string,
         callback: (waitPayload: any) => any
     ): Promise<void>;
-}
+}
+
+declare namespace tailor.context {
+    /**
+     * Information about the invoker of the current function execution.
+     */
+    interface Invoker {
+        /** The invoker's ID */
+        id: string;
+        /** The invoker's type */
+        type: "user" | "machine_user";
+        /** The workspace ID */
+        workspaceId: string;
+        /** The invoker's attribute IDs */
+        attributes: string[];
+        /** The invoker's attribute map */
+        attributeMap: Record<string, unknown>;
+    }
+
+    /**
+     * Returns information about the invoker of the current function execution,
+     * or `null` for anonymous invocations.
+     */
+    function getInvoker(): Invoker | null;
+}