phenoml 0.0.8 → 0.0.10

package/dist/esm/api/resources/fhir/client/requests/FhirSearchRequest.d.mts

@@ -1,12 +1,14 @@
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
  *     }
  *
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com"
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
  *     }
  */
 export interface FhirSearchRequest {
@@ -18,6 +20,14 @@ export interface FhirSearchRequest {
      * - Search prefixes for dates, numbers, quantities (eq, ne, gt, ge, lt, le, sa, eb, ap)
      */
     query_parameters?: Record<string, string | undefined>;
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
 }

package/dist/esm/api/resources/fhir/client/requests/FhirUpsertRequest.d.mts

@@ -2,7 +2,8 @@ import type * as phenoml from "../../../../index.mjs";
 /**
  * @example
  *     {
- *         "X-Phenoml-On-Behalf-Of": "user@example.com",
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         body: {
  *             resourceType: "Patient",
  *             id: "123",
@@ -21,7 +22,15 @@ import type * as phenoml from "../../../../index.mjs";
  *     }
  */
 export interface FhirUpsertRequest {
-    /** Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity. */
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
     "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     body: phenoml.fhir.FhirResource;
 }

package/dist/esm/api/resources/fhirProvider/client/Client.mjs

@@ -44,7 +44,7 @@ export class FhirProvider {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "fhir-provider/create"),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "fhir-provider"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -87,7 +87,7 @@ export class FhirProvider {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.phenomlTimeoutError("Timeout exceeded when calling POST /fhir-provider/create.");
+                    throw new errors.phenomlTimeoutError("Timeout exceeded when calling POST /fhir-provider.");
                 case "unknown":
                     throw new errors.phenomlError({
                         message: _response.error.errorMessage,

package/dist/esm/api/resources/fhirProvider/client/requests/FhirProviderAddAuthConfigRequest.d.mts

@@ -12,6 +12,7 @@ export interface FhirProviderAddAuthConfigRequest {
     service_account_key?: phenoml.fhirProvider.ServiceAccountKey;
     /** Expiry time for JWT credentials (only applicable for JWT auth method) */
     credential_expiry?: string;
-    /** OAuth scopes to request */
+    role?: phenoml.fhirProvider.Role;
+    /** OAuth scopes to request. Cannot be specified with role. If neither role nor scopes are specified, the provider-specific default role will be used. You are solely responsible for ensuring the scopes are valid options for the provider being created or updated. */
     scopes?: string;
 }

package/dist/esm/api/resources/fhirProvider/client/requests/FhirProviderCreateRequest.d.mts

@@ -22,6 +22,7 @@ export interface FhirProviderCreateRequest {
     /** OAuth client secret (required for client_secret and on_behalf_of auth methods) */
     client_secret?: string;
     service_account_key?: phenoml.fhirProvider.ServiceAccountKey;
-    /** OAuth scopes to request */
+    role?: phenoml.fhirProvider.Role;
+    /** OAuth scopes to request. Cannot be specified with role. If neither role nor scopes are specified, the provider-specific default role will be used. You are solely responsible for ensuring the scopes are valid options for the provider being created or updated. */
     scopes?: string;
 }

package/dist/esm/api/resources/fhirProvider/types/AuthMethod.d.mts

@@ -1,9 +1,10 @@
-/** Authentication method for the FHIR provider */
+/** Authentication method for the FHIR provider. Only one authentication method can be used at a time, but these can be rotated on the FHIR Provider as needed. For the 'token_passthrough' authentication method, you must provide the token in the X-Phenoml-Fhir-Provider  header in the format {fhir_provider_id}:{oauth2_token}. For the 'on_behalf_of' authentication method, you must provide the Patient or Practitioner reference in the  X-Phenoml-On-Behalf-Of header in the format Patient/{uuid} or Practitioner/{uuid}. This only works for the medplum provider currently. More on the authentication headers and how to structure them can be found in the FHIR Proxy, Tools and Agent documentation. */
 export declare const AuthMethod: {
     readonly ClientSecret: "client_secret";
     readonly GoogleHealthcare: "google_healthcare";
     readonly Jwt: "jwt";
     readonly OnBehalfOf: "on_behalf_of";
+    readonly TokenPassthrough: "token_passthrough";
     readonly None: "none";
 };
 export type AuthMethod = (typeof AuthMethod)[keyof typeof AuthMethod];

package/dist/esm/api/resources/fhirProvider/types/AuthMethod.mjs

@@ -1,9 +1,10 @@
 // This file was auto-generated by Fern from our API Definition.
-/** Authentication method for the FHIR provider */
+/** Authentication method for the FHIR provider. Only one authentication method can be used at a time, but these can be rotated on the FHIR Provider as needed. For the 'token_passthrough' authentication method, you must provide the token in the X-Phenoml-Fhir-Provider  header in the format {fhir_provider_id}:{oauth2_token}. For the 'on_behalf_of' authentication method, you must provide the Patient or Practitioner reference in the  X-Phenoml-On-Behalf-Of header in the format Patient/{uuid} or Practitioner/{uuid}. This only works for the medplum provider currently. More on the authentication headers and how to structure them can be found in the FHIR Proxy, Tools and Agent documentation. */
 export const AuthMethod = {
     ClientSecret: "client_secret",
     GoogleHealthcare: "google_healthcare",
     Jwt: "jwt",
     OnBehalfOf: "on_behalf_of",
+    TokenPassthrough: "token_passthrough",
     None: "none",
 };

package/dist/esm/api/resources/fhirProvider/types/Role.d.mts

@@ -0,0 +1,22 @@
+/** Predefined role that specifies OAuth scopes. Cannot be specified with scopes. Available roles depend on the provider being created or updated. */
+export declare const Role: {
+    readonly SmartV1Admin: "SmartV1Admin";
+    readonly SmartV1Read: "SmartV1Read";
+    readonly SmartV1Write: "SmartV1Write";
+    readonly SmartV2Admin: "SmartV2Admin";
+    readonly SmartV2Read: "SmartV2Read";
+    readonly SmartV2Write: "SmartV2Write";
+    readonly UscdiSmartV1Admin: "USCDISmartV1Admin";
+    readonly UscdiSmartV1Read: "USCDISmartV1Read";
+    readonly UscdiSmartV1Write: "USCDISmartV1Write";
+    readonly UscdiSmartV2Admin: "USCDISmartV2Admin";
+    readonly UscdiSmartV2Read: "USCDISmartV2Read";
+    readonly UscdiSmartV2Write: "USCDISmartV2Write";
+    readonly CernerSmartV1Admin: "CernerSmartV1Admin";
+    readonly CernerSmartV1Read: "CernerSmartV1Read";
+    readonly CernerSmartV1Write: "CernerSmartV1Write";
+    readonly CernerSmartV2Admin: "CernerSmartV2Admin";
+    readonly CernerSmartV2Read: "CernerSmartV2Read";
+    readonly CernerSmartV2Write: "CernerSmartV2Write";
+};
+export type Role = (typeof Role)[keyof typeof Role];

package/dist/esm/api/resources/fhirProvider/types/Role.mjs

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Predefined role that specifies OAuth scopes. Cannot be specified with scopes. Available roles depend on the provider being created or updated. */
+export const Role = {
+    SmartV1Admin: "SmartV1Admin",
+    SmartV1Read: "SmartV1Read",
+    SmartV1Write: "SmartV1Write",
+    SmartV2Admin: "SmartV2Admin",
+    SmartV2Read: "SmartV2Read",
+    SmartV2Write: "SmartV2Write",
+    UscdiSmartV1Admin: "USCDISmartV1Admin",
+    UscdiSmartV1Read: "USCDISmartV1Read",
+    UscdiSmartV1Write: "USCDISmartV1Write",
+    UscdiSmartV2Admin: "USCDISmartV2Admin",
+    UscdiSmartV2Read: "USCDISmartV2Read",
+    UscdiSmartV2Write: "USCDISmartV2Write",
+    CernerSmartV1Admin: "CernerSmartV1Admin",
+    CernerSmartV1Read: "CernerSmartV1Read",
+    CernerSmartV1Write: "CernerSmartV1Write",
+    CernerSmartV2Admin: "CernerSmartV2Admin",
+    CernerSmartV2Read: "CernerSmartV2Read",
+    CernerSmartV2Write: "CernerSmartV2Write",
+};

package/dist/esm/api/resources/fhirProvider/types/index.d.mts

@@ -9,5 +9,6 @@ export * from "./FhirProviderTemplate.mjs";
 export * from "./FhirQueryResponse.mjs";
 export * from "./JsonWebKey.mjs";
 export * from "./Provider.mjs";
+export * from "./Role.mjs";
 export * from "./ServiceAccountKey.mjs";
 export * from "./SmartConfiguration.mjs";

package/dist/esm/api/resources/fhirProvider/types/index.mjs

@@ -9,5 +9,6 @@ export * from "./FhirProviderTemplate.mjs";
 export * from "./FhirQueryResponse.mjs";
 export * from "./JsonWebKey.mjs";
 export * from "./Provider.mjs";
+export * from "./Role.mjs";
 export * from "./ServiceAccountKey.mjs";
 export * from "./SmartConfiguration.mjs";

package/dist/esm/api/resources/tools/client/Client.d.mts

@@ -27,6 +27,8 @@ export declare class Tools {
      *
      * @example
      *     await client.tools.createFhirResource({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         resource: "auto",
      *         text: "Patient John Doe has severe asthma with acute exacerbation"
      *     })
@@ -47,6 +49,8 @@ export declare class Tools {
      *
      * @example
      *     await client.tools.searchFhirResources({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         text: "Find all appointments for patient John Doe next week"
      *     })
      */
@@ -65,6 +69,8 @@ export declare class Tools {
      *
      * @example
      *     await client.tools.analyzeCohort({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         text: "female patients over 20 with diabetes but not hypertension",
      *         provider: "550e8400-e29b-41d4-a716-446655440000"
      *     })

package/dist/esm/api/resources/tools/client/Client.mjs

@@ -8,6 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as environments from "../../../../environments.mjs";
@@ -36,6 +47,8 @@ export class Tools {
      *
      * @example
      *     await client.tools.createFhirResource({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         resource: "auto",
      *         text: "Patient John Doe has severe asthma with acute exacerbation"
      *     })
@@ -46,7 +59,12 @@ export class Tools {
     __createFhirResource(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider } = request, _body = __rest(request, ["X-Phenoml-On-Behalf-Of", "X-Phenoml-Fhir-Provider"]);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "tools/lang2fhir-and-create"),
                 method: "POST",
@@ -54,7 +72,7 @@ export class Tools {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -116,6 +134,8 @@ export class Tools {
      *
      * @example
      *     await client.tools.searchFhirResources({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         text: "Find all appointments for patient John Doe next week"
      *     })
      */
@@ -125,7 +145,12 @@ export class Tools {
     __searchFhirResources(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider } = request, _body = __rest(request, ["X-Phenoml-On-Behalf-Of", "X-Phenoml-Fhir-Provider"]);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "tools/lang2fhir-and-search"),
                 method: "POST",
@@ -133,7 +158,7 @@ export class Tools {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -194,6 +219,8 @@ export class Tools {
      *
      * @example
      *     await client.tools.analyzeCohort({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         text: "female patients over 20 with diabetes but not hypertension",
      *         provider: "550e8400-e29b-41d4-a716-446655440000"
      *     })
@@ -204,7 +231,12 @@ export class Tools {
     __analyzeCohort(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const { "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf, "X-Phenoml-Fhir-Provider": phenomlFhirProvider } = request, _body = __rest(request, ["X-Phenoml-On-Behalf-Of", "X-Phenoml-Fhir-Provider"]);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Phenoml-On-Behalf-Of": phenomlOnBehalfOf != null ? phenomlOnBehalfOf : undefined,
+                "X-Phenoml-Fhir-Provider": phenomlFhirProvider != null ? phenomlFhirProvider : undefined,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "tools/cohort"),
                 method: "POST",
@@ -212,7 +244,7 @@ export class Tools {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

package/dist/esm/api/resources/tools/client/requests/CohortRequest.d.mts

@@ -1,11 +1,23 @@
 /**
  * @example
  *     {
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         text: "female patients over 20 with diabetes but not hypertension",
  *         provider: "550e8400-e29b-41d4-a716-446655440000"
  *     }
  */
 export interface CohortRequest {
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
+    "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     /** Natural language text describing the patient cohort criteria */
     text: string;
     /** FHIR provider ID - must be a valid UUID from existing FHIR providers. also supports provider by name (e.g. medplum) */

package/dist/esm/api/resources/tools/client/requests/Lang2FhirAndCreateRequest.d.mts

@@ -1,11 +1,23 @@
 /**
  * @example
  *     {
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         resource: "auto",
  *         text: "Patient John Doe has severe asthma with acute exacerbation"
  *     }
  */
 export interface Lang2FhirAndCreateRequest {
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
+    "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     /** Type of FHIR resource to create. Use 'auto' for automatic resource type detection, or specify a supported US Core profile. */
     resource: Lang2FhirAndCreateRequest.Resource;
     /** Natural language text to convert to FHIR resource */

package/dist/esm/api/resources/tools/client/requests/Lang2FhirAndSearchRequest.d.mts

@@ -1,10 +1,22 @@
 /**
  * @example
  *     {
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         text: "Find all appointments for patient John Doe next week"
  *     }
  */
 export interface Lang2FhirAndSearchRequest {
+    /**
+     * Optional header for on-behalf-of authentication. Used when making requests on behalf of another user or entity.
+     * Must be in the format: Patient/{uuid} or Practitioner/{uuid}
+     */
+    "X-Phenoml-On-Behalf-Of"?: string;
+    /**
+     * Optional header for FHIR provider authentication. Contains credentials in the format {fhir_provider_id}:{oauth2_token}.
+     * Multiple FHIR provider integrations can be provided as comma-separated values.
+     */
+    "X-Phenoml-Fhir-Provider"?: string;
     /** Natural language text to convert to FHIR search parameters */
     text: string;
     /** Patient ID to filter results */

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.0.8";
+export declare const SDK_VERSION = "0.0.10";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.0.8";
+export const SDK_VERSION = "0.0.10";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "phenoml",
-    "version": "0.0.8",
+    "version": "0.0.10",
     "private": false,
     "repository": "github:PhenoML/phenoml-ts-sdk",
     "type": "commonjs",

package/reference.md

@@ -444,6 +444,8 @@ Send a message to an agent and receive a response
 
 ```typescript
 await client.agent.chat({
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     message: "What is the patient's current condition?",
     agent_id: "agent-123"
 });
@@ -1272,72 +1274,6 @@ await client.construe.extractCodes({
 </dl>
 
 
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.construe.<a href="/src/api/resources/construe/client/Client.ts">cohort</a>({ ...params }) -> phenoml.ConstrueCohortResponse</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Creates a patient cohort based on a natural language description.
-Translates the description into FHIR search queries and optional SQL queries.
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.construe.cohort({
-    text: "Between 20 and 40 years old with hyperlipidemia"
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**request:** `phenoml.construe.ConstrueCohortRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `Construe.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
 </dd>
 </dl>
 </details>
@@ -1373,7 +1309,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.search("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com"
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
 });
 
 ```
@@ -1466,7 +1403,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.create("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com",
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     body: {
         resourceType: "Patient",
         name: [
@@ -1572,7 +1510,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.upsert("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com",
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     body: {
         resourceType: "Patient",
         id: "123",
@@ -1680,7 +1619,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.delete("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com"
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c..."
 });
 
 ```
@@ -1778,7 +1718,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.patch("550e8400-e29b-41d4-a716-446655440000", "Patient", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com",
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     body: [{
             op: "replace",
             path: "/name/0/family",
@@ -1878,7 +1819,8 @@ The request is proxied to the configured FHIR server with appropriate authentica
 
 ```typescript
 await client.fhir.executeBundle("550e8400-e29b-41d4-a716-446655440000", {
-    "X-Phenoml-On-Behalf-Of": "user@example.com",
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     body: {
         resourceType: "Bundle",
         entry: [{
@@ -3120,6 +3062,8 @@ Converts natural language to FHIR resource and optionally stores it in a FHIR se
 
 ```typescript
 await client.tools.createFhirResource({
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     resource: "auto",
     text: "Patient John Doe has severe asthma with acute exacerbation"
 });
@@ -3186,6 +3130,8 @@ Converts natural language to FHIR search parameters and executes search in FHIR
 
 ```typescript
 await client.tools.searchFhirResources({
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     text: "Find all appointments for patient John Doe next week"
 });
 
@@ -3251,6 +3197,8 @@ Uses LLM to extract search concepts from natural language and builds patient coh
 
 ```typescript
 await client.tools.analyzeCohort({
+    "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+    "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
     text: "female patients over 20 with diabetes but not hypertension",
     provider: "550e8400-e29b-41d4-a716-446655440000"
 });

package/dist/cjs/api/resources/construe/client/requests/ConstrueCohortRequest.d.ts

@@ -1,23 +0,0 @@
-/**
- * @example
- *     {
- *         text: "Between 20 and 40 years old with hyperlipidemia"
- *     }
- */
-export interface ConstrueCohortRequest {
-    config?: ConstrueCohortRequest.Config;
-    /** Natural language description of the desired patient cohort. */
-    text: string;
-}
-export declare namespace ConstrueCohortRequest {
-    interface Config {
-        /** When enabled, includes detailed information about medical codes extracted from the text. */
-        include_extract_results?: boolean;
-        /** When enabled, includes AI-generated explanations for each query component and code extraction. */
-        include_rationale?: boolean;
-        /** Controls whether deceased patients should be excluded from the cohort. */
-        exclude_deceased?: boolean;
-        /** Specifies the SQL dialect for query generation. Currently, only "bigquery" is supported. */
-        sql_syntax?: "bigquery";
-    }
-}

package/dist/cjs/api/resources/construe/client/requests/ConstrueCohortRequest.js

@@ -1,3 +0,0 @@
-"use strict";
-// This file was auto-generated by Fern from our API Definition.
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/BadRequestErrorBody.d.ts

@@ -1,6 +0,0 @@
-export interface BadRequestErrorBody {
-    /** HTTP status code. */
-    status?: number;
-    /** Error message. */
-    message?: string;
-}

package/dist/cjs/api/resources/construe/types/BadRequestErrorBody.js

@@ -1,3 +0,0 @@
-"use strict";
-// This file was auto-generated by Fern from our API Definition.
-Object.defineProperty(exports, "__esModule", { value: true });