@lucern/sdk 0.3.0-alpha.16 → 0.3.0-alpha.2

package/dist/authDeviceClient.js

@@ -1,121 +0,0 @@
-// src/authDeviceClient.ts
-var DeviceAuthorizationError = class extends Error {
-  error;
-  interval;
-  constructor(args) {
-    super(args.description ?? args.error);
-    this.name = "DeviceAuthorizationError";
-    this.error = args.error;
-    this.interval = args.interval;
-  }
-};
-function authBaseUrl(config) {
-  return config.baseUrl?.replace(/\/+$/, "") ?? "";
-}
-async function readJson(response) {
-  try {
-    const payload = await response.json();
-    return isRecord(payload) ? payload : {};
-  } catch (error) {
-    return unreadableJsonBodyFallback();
-  }
-}
-function unreadableJsonBodyFallback(_error) {
-  return {};
-}
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function readString(value) {
-  const normalized = typeof value === "string" ? value.trim() : "";
-  return normalized || void 0;
-}
-function assertDeviceCodeResponse(payload) {
-  const deviceCode = readString(payload.device_code);
-  const userCode = readString(payload.user_code);
-  const verificationUri = readString(payload.verification_uri);
-  const verificationUriComplete = readString(payload.verification_uri_complete);
-  const expiresIn = payload.expires_in;
-  const interval = payload.interval;
-  if (!deviceCode || !userCode || !verificationUri || !verificationUriComplete || typeof expiresIn !== "number" || typeof interval !== "number") {
-    throw new Error("Gateway returned an invalid device-code response.");
-  }
-  return {
-    device_code: deviceCode,
-    user_code: userCode,
-    verification_uri: verificationUri,
-    verification_uri_complete: verificationUriComplete,
-    expires_in: expiresIn,
-    interval
-  };
-}
-function assertDeviceTokenResponse(payload) {
-  const accessToken = readString(payload.access_token);
-  const tokenType = readString(payload.token_type);
-  const scope = readString(payload.scope);
-  const tenantId = readString(payload.tenant_id);
-  const principalId = readString(payload.principal_id);
-  if (!accessToken || tokenType !== "Bearer" || typeof payload.expires_in !== "number" || !scope || !tenantId || !principalId) {
-    throw new Error("Gateway returned an invalid device token response.");
-  }
-  return {
-    access_token: accessToken,
-    token_type: "Bearer",
-    expires_in: payload.expires_in,
-    scope,
-    tenant_id: tenantId,
-    workspace_id: readString(payload.workspace_id),
-    principal_id: principalId,
-    user: isRecord(payload.user) && typeof payload.user.id === "string" && typeof payload.user.principalId === "string" ? {
-      id: payload.user.id,
-      principalId: payload.user.principalId
-    } : void 0
-  };
-}
-function maybeThrowDeviceError(payload) {
-  const error = readString(payload.error);
-  throw new DeviceAuthorizationError({
-    error: error ?? "invalid_request",
-    description: readString(payload.error_description),
-    interval: typeof payload.interval === "number" ? payload.interval : void 0
-  });
-}
-function createAuthDeviceClient(config = {}) {
-  const fetchImpl = config.fetchImpl ?? fetch;
-  const baseUrl = authBaseUrl(config);
-  async function post(path, body) {
-    return fetchImpl(`${baseUrl}${path}`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify(body)
-    });
-  }
-  return {
-    async createDeviceCode(input = {}) {
-      const response = await post("/api/platform/v1/auth/device/code", {
-        client_id: input.clientId ?? "lucern-cli",
-        scope: input.scope ?? "graph.read graph.write"
-      });
-      const payload = await readJson(response);
-      if (!response.ok) {
-        maybeThrowDeviceError(payload);
-      }
-      return assertDeviceCodeResponse(payload);
-    },
-    async pollDeviceToken(deviceCode) {
-      const response = await post("/api/platform/v1/auth/device/token", {
-        grant_type: "urn:ietf:params:oauth:grant-type:device_code",
-        device_code: deviceCode
-      });
-      const payload = await readJson(response);
-      if (!response.ok) {
-        maybeThrowDeviceError(payload);
-      }
-      return assertDeviceTokenResponse(payload);
-    }
-  };
-}
-
-export { DeviceAuthorizationError, createAuthDeviceClient };
-//# sourceMappingURL=authDeviceClient.js.map
-//# sourceMappingURL=authDeviceClient.js.map

package/dist/authDeviceClient.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/authDeviceClient.ts"],"names":[],"mappings":"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","file":"authDeviceClient.js","sourcesContent":["import type { GatewayClientConfig } from \"./coreClient\";\n\nexport type DeviceCodeInput = {\n  clientId?: string;\n  scope?: string;\n};\n\nexport type DeviceCodeResponse = {\n  device_code: string;\n  user_code: string;\n  verification_uri: string;\n  verification_uri_complete: string;\n  expires_in: number;\n  interval: number;\n};\n\nexport type DeviceTokenResponse = {\n  access_token: string;\n  token_type: \"Bearer\";\n  expires_in: number;\n  scope: string;\n  tenant_id: string;\n  workspace_id?: string;\n  principal_id: string;\n  user?: {\n    id: string;\n    principalId: string;\n  };\n};\n\nexport type DeviceTokenErrorCode =\n  | \"authorization_pending\"\n  | \"slow_down\"\n  | \"access_denied\"\n  | \"expired_token\"\n  | \"invalid_grant\"\n  | \"invalid_request\";\n\nexport class DeviceAuthorizationError extends Error {\n  readonly error: DeviceTokenErrorCode;\n  readonly interval?: number;\n\n  constructor(args: {\n    error: DeviceTokenErrorCode;\n    description?: string;\n    interval?: number;\n  }) {\n    super(args.description ?? args.error);\n    this.name = \"DeviceAuthorizationError\";\n    this.error = args.error;\n    this.interval = args.interval;\n  }\n}\n\nfunction authBaseUrl(config: GatewayClientConfig): string {\n  return config.baseUrl?.replace(/\\/+$/, \"\") ?? \"\";\n}\n\nasync function readJson(response: Response): Promise<Record<string, unknown>> {\n  try {\n    const payload = (await response.json()) as unknown;\n    return isRecord(payload) ? payload : {};\n  } catch (error) {\n    return unreadableJsonBodyFallback(error);\n  }\n}\n\nfunction unreadableJsonBodyFallback(_error: unknown): Record<string, unknown> {\n  return {};\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction readString(value: unknown): string | undefined {\n  const normalized = typeof value === \"string\" ? value.trim() : \"\";\n  return normalized || undefined;\n}\n\nfunction assertDeviceCodeResponse(payload: Record<string, unknown>): DeviceCodeResponse {\n  const deviceCode = readString(payload.device_code);\n  const userCode = readString(payload.user_code);\n  const verificationUri = readString(payload.verification_uri);\n  const verificationUriComplete = readString(payload.verification_uri_complete);\n  const expiresIn = payload.expires_in;\n  const interval = payload.interval;\n  if (\n    !deviceCode ||\n    !userCode ||\n    !verificationUri ||\n    !verificationUriComplete ||\n    typeof expiresIn !== \"number\" ||\n    typeof interval !== \"number\"\n  ) {\n    throw new Error(\"Gateway returned an invalid device-code response.\");\n  }\n  return {\n    device_code: deviceCode,\n    user_code: userCode,\n    verification_uri: verificationUri,\n    verification_uri_complete: verificationUriComplete,\n    expires_in: expiresIn,\n    interval,\n  };\n}\n\nfunction assertDeviceTokenResponse(\n  payload: Record<string, unknown>\n): DeviceTokenResponse {\n  const accessToken = readString(payload.access_token);\n  const tokenType = readString(payload.token_type);\n  const scope = readString(payload.scope);\n  const tenantId = readString(payload.tenant_id);\n  const principalId = readString(payload.principal_id);\n  if (\n    !accessToken ||\n    tokenType !== \"Bearer\" ||\n    typeof payload.expires_in !== \"number\" ||\n    !scope ||\n    !tenantId ||\n    !principalId\n  ) {\n    throw new Error(\"Gateway returned an invalid device token response.\");\n  }\n  return {\n    access_token: accessToken,\n    token_type: \"Bearer\",\n    expires_in: payload.expires_in,\n    scope,\n    tenant_id: tenantId,\n    workspace_id: readString(payload.workspace_id),\n    principal_id: principalId,\n    user:\n      isRecord(payload.user) &&\n      typeof payload.user.id === \"string\" &&\n      typeof payload.user.principalId === \"string\"\n        ? {\n            id: payload.user.id,\n            principalId: payload.user.principalId,\n          }\n        : undefined,\n  };\n}\n\nfunction maybeThrowDeviceError(payload: Record<string, unknown>): never {\n  const error = readString(payload.error) as DeviceTokenErrorCode | undefined;\n  throw new DeviceAuthorizationError({\n    error: error ?? \"invalid_request\",\n    description: readString(payload.error_description),\n    interval:\n      typeof payload.interval === \"number\" ? payload.interval : undefined,\n  });\n}\n\nexport function createAuthDeviceClient(config: GatewayClientConfig = {}) {\n  const fetchImpl = config.fetchImpl ?? fetch;\n  const baseUrl = authBaseUrl(config);\n\n  async function post(path: string, body: Record<string, unknown>) {\n    return fetchImpl(`${baseUrl}${path}`, {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n  }\n\n  return {\n    async createDeviceCode(input: DeviceCodeInput = {}) {\n      const response = await post(\"/api/platform/v1/auth/device/code\", {\n        client_id: input.clientId ?? \"lucern-cli\",\n        scope: input.scope ?? \"graph.read graph.write\",\n      });\n      const payload = await readJson(response);\n      if (!response.ok) {\n        maybeThrowDeviceError(payload);\n      }\n      return assertDeviceCodeResponse(payload);\n    },\n    async pollDeviceToken(deviceCode: string) {\n      const response = await post(\"/api/platform/v1/auth/device/token\", {\n        grant_type: \"urn:ietf:params:oauth:grant-type:device_code\",\n        device_code: deviceCode,\n      });\n      const payload = await readJson(response);\n      if (!response.ok) {\n        maybeThrowDeviceError(payload);\n      }\n      return assertDeviceTokenResponse(payload);\n    },\n  };\n}\n"]}

package/dist/boundaryClientSurface.d.ts

@@ -1,20 +0,0 @@
-import { JsonObject, ListResult } from './types.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-
-type TopicProjectAliasInput = {
-    topicId?: string;
-    /** @deprecated Use topicId. */
-    projectId?: string;
-};
-declare function cleanOptionalString(value: string | undefined): string | undefined;
-declare function cleanRequiredString(value: string | undefined, label: string): string;
-declare function readTopicId(input: TopicProjectAliasInput): string | undefined;
-declare function requireTopicId(input: TopicProjectAliasInput): string;
-declare function assertKnownKeys<T extends string>(input: Record<string, unknown>, allowed: readonly T[], operation: string): void;
-declare function knownPayload<T extends string>(input: Record<string, unknown>, allowed: readonly T[], operation: string): JsonObject;
-declare function topicPayload<T extends string>(input: TopicProjectAliasInput & Record<string, unknown>, allowed: readonly T[], operation: string): JsonObject;
-declare function listResultFromEnvelope<T, LegacyKey extends string>(data: unknown, legacyKey: LegacyKey): ListResult<T, LegacyKey>;
-
-export { type TopicProjectAliasInput, assertKnownKeys, cleanOptionalString, cleanRequiredString, knownPayload, listResultFromEnvelope, readTopicId, requireTopicId, topicPayload };

package/dist/boundaryClientSurface.js

@@ -1,73 +0,0 @@
-// src/sdkSurface.ts
-function createListResult(items, legacyKey) {
-  const result = {
-    items,
-    total: items.length
-  };
-  if (legacyKey) {
-    return {
-      ...result,
-      [legacyKey]: items
-    };
-  }
-  return result;
-}
-
-// src/boundaryClientSurface.ts
-function cleanOptionalString(value) {
-  const normalized = value?.trim();
-  return normalized ? normalized : void 0;
-}
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function cleanRequiredString(value, label) {
-  const normalized = cleanOptionalString(value);
-  if (!normalized) {
-    throw new Error(`${label} is required`);
-  }
-  return normalized;
-}
-function readTopicId(input) {
-  return cleanOptionalString(input.topicId) ?? cleanOptionalString(input.projectId);
-}
-function requireTopicId(input) {
-  const topicId = readTopicId(input);
-  if (!topicId) {
-    throw new Error("topicId is required");
-  }
-  return topicId;
-}
-function assertKnownKeys(input, allowed, operation) {
-  const allowedSet = new Set(allowed);
-  const unknownKeys = Object.keys(input).filter((key) => !allowedSet.has(key));
-  if (unknownKeys.length > 0) {
-    throw new Error(
-      `${operation} received unsupported field(s): ${unknownKeys.join(", ")}`
-    );
-  }
-}
-function knownPayload(input, allowed, operation) {
-  assertKnownKeys(input, allowed, operation);
-  return { ...input };
-}
-function topicPayload(input, allowed, operation) {
-  assertKnownKeys(input, allowed, operation);
-  return {
-    ...input,
-    topicId: requireTopicId(input),
-    projectId: void 0
-  };
-}
-function listResultFromEnvelope(data, legacyKey) {
-  const record = isRecord(data) ? data : {};
-  const legacyItems = record[legacyKey];
-  return createListResult(
-    Array.isArray(legacyItems) ? legacyItems : Array.isArray(data) ? data : [],
-    legacyKey
-  );
-}
-
-export { assertKnownKeys, cleanOptionalString, cleanRequiredString, knownPayload, listResultFromEnvelope, readTopicId, requireTopicId, topicPayload };
-//# sourceMappingURL=boundaryClientSurface.js.map
-//# sourceMappingURL=boundaryClientSurface.js.map

package/dist/boundaryClientSurface.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sdkSurface.ts","../src/boundaryClientSurface.ts"],"names":[],"mappings":";AAoJO,SAAS,gBAAA,CACd,OACA,SAAA,EAC0B;AAC1B,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,KAAA;AAAA,IACA,OAAO,KAAA,CAAM;AAAA,GACf;AAEA,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,OAAO;AAAA,MACL,GAAG,MAAA;AAAA,MACH,CAAC,SAAS,GAAG;AAAA,KACf;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;AC5JO,SAAS,oBAAoB,KAAA,EAA2B;AAC7D,EAAA,MAAM,UAAA,GAAa,OAAO,IAAA,EAAK;AAC/B,EAAA,OAAO,aAAa,UAAA,GAAa,MAAA;AACnC;AAEA,SAAS,SAAS,KAAA,EAAkD;AAClE,EAAA,OAAO,OAAA,CAAQ,KAAK,CAAA,IAAK,OAAO,UAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAC5E;AAEO,SAAS,mBAAA,CACd,OACA,KAAA,EACA;AACA,EAAA,MAAM,UAAA,GAAa,oBAAoB,KAAK,CAAA;AAC5C,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA,YAAA,CAAc,CAAA;AAAA,EACxC;AACA,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,YAAY,KAAA,EAA+B;AACzD,EAAA,OAAO,oBAAoB,KAAA,CAAM,OAAO,CAAA,IAAK,mBAAA,CAAoB,MAAM,SAAS,CAAA;AAClF;AAEO,SAAS,eAAe,KAAA,EAA+B;AAC5D,EAAA,MAAM,OAAA,GAAU,YAAY,KAAK,CAAA;AACjC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,OAAA;AACT;AAEO,SAAS,eAAA,CACd,KAAA,EACA,OAAA,EACA,SAAA,EACA;AACA,EAAA,MAAM,UAAA,GAAa,IAAI,GAAA,CAAY,OAAO,CAAA;AAC1C,EAAA,MAAM,WAAA,GAAc,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,MAAA,CAAO,CAAC,GAAA,KAAQ,CAAC,UAAA,CAAW,GAAA,CAAI,GAAG,CAAC,CAAA;AAC3E,EAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AAC1B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,GAAG,SAAS,CAAA,gCAAA,EAAmC,WAAA,CAAY,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACvE;AAAA,EACF;AACF;AAEO,SAAS,YAAA,CACd,KAAA,EACA,OAAA,EACA,SAAA,EACA;AACA,EAAA,eAAA,CAAgB,KAAA,EAAO,SAAS,SAAS,CAAA;AACzC,EAAA,OAAO,EAAE,GAAG,KAAA,EAAM;AACpB;AAEO,SAAS,YAAA,CACd,KAAA,EACA,OAAA,EACA,SAAA,EACA;AACA,EAAA,eAAA,CAAgB,KAAA,EAAO,SAAS,SAAS,CAAA;AACzC,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,OAAA,EAAS,eAAe,KAAK,CAAA;AAAA,IAC7B,SAAA,EAAW;AAAA,GACb;AACF;AAEO,SAAS,sBAAA,CACd,MACA,SAAA,EAC0B;AAC1B,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,IAAI,CAAA,GAAI,OAAO,EAAC;AACxC,EAAA,MAAM,WAAA,GAAc,OAAO,SAAS,CAAA;AACpC,EAAA,OAAO,gBAAA;AAAA,IACL,KAAA,CAAM,OAAA,CAAQ,WAAW,CAAA,GACrB,WAAA,GACA,MAAM,OAAA,CAAQ,IAAI,CAAA,GAChB,IAAA,GACA,EAAC;AAAA,IACP;AAAA,GACF;AACF","file":"boundaryClientSurface.js","sourcesContent":["import type { PlatformGatewaySuccess } from \"./coreClient\";\nimport type { JsonObject, ListResult } from \"./types\";\n\ntype TopicScopedValue = {\n  topicId?: string;\n};\n\ntype TextScopedValue = {\n  text?: string;\n  canonicalText?: string;\n};\n\ntype AnyRecord = Record<string, unknown>;\n\nexport function isRecord(value: unknown): value is AnyRecord {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function asRecord(value: unknown): AnyRecord {\n  return isRecord(value) ? value : {};\n}\n\nfunction cleanString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : undefined;\n}\n\nfunction normalizeVerificationStatus(value: unknown): string | undefined {\n  const status = cleanString(value);\n  if (!status) {\n    return undefined;\n  }\n  if (status === \"verified\") {\n    return \"human_verified\";\n  }\n  if (status === \"rejected\") {\n    return \"contradicted\";\n  }\n  return status;\n}\n\nfunction cloneWith<T extends AnyRecord>(value: T, patch: AnyRecord): T {\n  return { ...value, ...patch } as T;\n}\n\n/**\n * Resolve the canonical topic identifier.\n */\nexport function resolveTopicId(value: TopicScopedValue): string | undefined {\n  return cleanString(value.topicId);\n}\n\n/**\n * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.\n */\nexport function resolveText(value: TextScopedValue): string | undefined {\n  return cleanString(value.text) ?? cleanString(value.canonicalText);\n}\n\n/**\n * Attach the topicId to a record.\n */\nexport function withTopicAlias<T extends AnyRecord>(value: T): T {\n  const topicId = cleanString(value.topicId) ?? undefined;\n  if (!topicId) {\n    return value;\n  }\n  return cloneWith(value, { topicId });\n}\n\n/**\n * Attach the text/canonicalText alias pair to a record.\n */\nexport function withTextAlias<T extends AnyRecord>(value: T): T {\n  const text =\n    cleanString(value.text) ?? cleanString(value.canonicalText) ?? undefined;\n  if (!text) {\n    return value;\n  }\n  return cloneWith(value, { text, canonicalText: text });\n}\n\n/**\n * Attach topic and text aliases to SDK node-like records.\n */\nexport function withSdkAliases<T extends AnyRecord>(value: T): T {\n  return withTopicAlias(withTextAlias(value));\n}\n\n/**\n * Normalize a belief/question/evidence write payload to the canonical gateway shape.\n */\nexport function normalizeNodeWriteInput<T extends JsonObject>(value: T): T {\n  const topicId = resolveTopicId(value);\n  const text = resolveText(value);\n  const verificationStatus = normalizeVerificationStatus(value.verificationStatus);\n  const next = { ...value } as JsonObject;\n\n  if (topicId) {\n    next.topicId = topicId;\n  }\n  if (text) {\n    next.text = text;\n    next.canonicalText = text;\n  }\n  if (verificationStatus) {\n    next.verificationStatus = verificationStatus;\n  }\n\n  return next as T;\n}\n\nexport const normalizeNodeVerificationStatus = normalizeVerificationStatus;\n\n/**\n * Build a topic-aware query object.\n */\nexport function normalizeTopicQuery<T extends JsonObject>(value: T): T {\n  const topicId = cleanString(value.topicId);\n  if (!topicId) {\n    return value;\n  }\n  return { ...value, topicId } as T;\n}\n\n/**\n * Extract list items from array or list-envelope payloads.\n */\nexport function asListItems<T>(data: unknown, legacyKey?: string): T[] {\n  if (Array.isArray(data)) {\n    return data;\n  }\n\n  const record = asRecord(data);\n  if (Array.isArray(record.items)) {\n    return record.items;\n  }\n  if (legacyKey && Array.isArray(record[legacyKey])) {\n    return record[legacyKey];\n  }\n\n  return [];\n}\n\n/**\n * Standardize list data to { items, total } while retaining an optional legacy array key.\n */\nexport function createListResult<T, LegacyKey extends string>(\n  items: T[],\n  legacyKey?: LegacyKey\n): ListResult<T, LegacyKey> {\n  const result = {\n    items,\n    total: items.length,\n  } as ListResult<T, LegacyKey>;\n\n  if (legacyKey) {\n    return {\n      ...result,\n      [legacyKey]: items,\n    } as ListResult<T, LegacyKey>;\n  }\n\n  return result;\n}\n\n/**\n * Map a gateway success envelope's data while preserving the transport metadata.\n */\nexport function mapGatewayData<T, U>(\n  response: PlatformGatewaySuccess<T>,\n  mapper: (data: T) => U\n): PlatformGatewaySuccess<U> {\n  return {\n    ...response,\n    data: mapper(response.data),\n  };\n}\n\n/**\n * Apply SDK aliases across all items in a list-like payload.\n */\nexport function mapAliasedList<\n  TItem extends AnyRecord,\n  LegacyKey extends string,\n>(\n  data: unknown,\n  legacyKey?: LegacyKey\n): ListResult<TItem, LegacyKey> {\n  const items = asListItems<TItem>(data, legacyKey).map((item) =>\n    withSdkAliases(item)\n  );\n  return createListResult(items, legacyKey);\n}\n","import { createListResult } from \"./sdkSurface\";\nimport type { JsonObject, ListResult } from \"./types\";\n\nexport type TopicProjectAliasInput = {\n  topicId?: string;\n  /** @deprecated Use topicId. */\n  projectId?: string;\n};\n\nexport function cleanOptionalString(value: string | undefined) {\n  const normalized = value?.trim();\n  return normalized ? normalized : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function cleanRequiredString(\n  value: string | undefined,\n  label: string\n) {\n  const normalized = cleanOptionalString(value);\n  if (!normalized) {\n    throw new Error(`${label} is required`);\n  }\n  return normalized;\n}\n\nexport function readTopicId(input: TopicProjectAliasInput) {\n  return cleanOptionalString(input.topicId) ?? cleanOptionalString(input.projectId);\n}\n\nexport function requireTopicId(input: TopicProjectAliasInput) {\n  const topicId = readTopicId(input);\n  if (!topicId) {\n    throw new Error(\"topicId is required\");\n  }\n  return topicId;\n}\n\nexport function assertKnownKeys<T extends string>(\n  input: Record<string, unknown>,\n  allowed: readonly T[],\n  operation: string\n) {\n  const allowedSet = new Set<string>(allowed);\n  const unknownKeys = Object.keys(input).filter((key) => !allowedSet.has(key));\n  if (unknownKeys.length > 0) {\n    throw new Error(\n      `${operation} received unsupported field(s): ${unknownKeys.join(\", \")}`\n    );\n  }\n}\n\nexport function knownPayload<T extends string>(\n  input: Record<string, unknown>,\n  allowed: readonly T[],\n  operation: string\n) {\n  assertKnownKeys(input, allowed, operation);\n  return { ...input } as JsonObject;\n}\n\nexport function topicPayload<T extends string>(\n  input: TopicProjectAliasInput & Record<string, unknown>,\n  allowed: readonly T[],\n  operation: string\n) {\n  assertKnownKeys(input, allowed, operation);\n  return {\n    ...input,\n    topicId: requireTopicId(input),\n    projectId: undefined,\n  } as JsonObject;\n}\n\nexport function listResultFromEnvelope<T, LegacyKey extends string>(\n  data: unknown,\n  legacyKey: LegacyKey\n): ListResult<T, LegacyKey> {\n  const record = isRecord(data) ? data : {};\n  const legacyItems = record[legacyKey];\n  return createListResult(\n    Array.isArray(legacyItems)\n      ? legacyItems\n      : Array.isArray(data)\n        ? data\n        : [],\n    legacyKey\n  );\n}\n"]}

package/dist/clientHelpers.d.ts

@@ -1,48 +0,0 @@
-import { JsonObject, PlatformGraphEdge, PlatformGraphNode } from './types.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-
-type NodeLike = PlatformGraphNode;
-type EdgeLike = PlatformGraphEdge;
-type CustomToolInput = JsonObject;
-type BeliefsRefineInput = string | {
-    text: string;
-    rationale?: string;
-};
-type BeliefsArchiveInput = {
-    reason?: string;
-    rationale?: string;
-} | string;
-declare function normalizeCustomNamespace(namespace: string): string;
-declare function normalizeCustomToolPayload(input: unknown): CustomToolInput;
-declare function resolveCustomToolFullName(name: string): string;
-declare function buildBeliefsRefinePayload(textOrInput: BeliefsRefineInput, rationale?: string): {
-    text: string;
-    rationale?: string;
-};
-declare function buildBeliefsArchivePayload(input?: BeliefsArchiveInput): {
-    reason?: string;
-} | undefined;
-declare function asNodeArray(data: unknown): NodeLike[];
-declare function asEdgeArray(data: unknown): EdgeLike[];
-declare function requireTopicId(args: {
-    topicId?: string;
-}): string;
-declare function requireTopicOrProjectId(args: {
-    topicId?: string;
-    projectId?: string;
-}): string;
-declare function matchesAuditNodeReference(value: unknown, nodeId: string): boolean;
-declare function requireText(args: {
-    text?: string;
-    canonicalText?: string;
-    formulation?: string;
-    newFormulation?: string;
-}): string;
-declare function requireBaseRate(args: {
-    baseRate?: number;
-}): number;
-declare function sdkQueryString(input: Record<string, unknown>): string;
-
-export { type BeliefsArchiveInput, type BeliefsRefineInput, type CustomToolInput, type EdgeLike, type NodeLike, asEdgeArray, asNodeArray, buildBeliefsArchivePayload, buildBeliefsRefinePayload, matchesAuditNodeReference, normalizeCustomNamespace, normalizeCustomToolPayload, requireBaseRate, requireText, requireTopicId, requireTopicOrProjectId, resolveCustomToolFullName, sdkQueryString };

package/dist/clientHelpers.js

@@ -1,137 +0,0 @@
-// src/sdkSurface.ts
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function asRecord(value) {
-  return isRecord(value) ? value : {};
-}
-function cleanString(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function resolveTopicId(value) {
-  return cleanString(value.topicId);
-}
-function resolveText(value) {
-  return cleanString(value.text) ?? cleanString(value.canonicalText);
-}
-function asListItems(data, legacyKey) {
-  if (Array.isArray(data)) {
-    return data;
-  }
-  const record = asRecord(data);
-  if (Array.isArray(record.items)) {
-    return record.items;
-  }
-  if (legacyKey && Array.isArray(record[legacyKey])) {
-    return record[legacyKey];
-  }
-  return [];
-}
-
-// src/clientHelpers.ts
-function normalizeCustomNamespace(namespace) {
-  return namespace.trim() || "custom";
-}
-function normalizeCustomToolPayload(input) {
-  return input && typeof input === "object" && !Array.isArray(input) ? input : {};
-}
-function resolveCustomToolFullName(name) {
-  return name.includes(".") ? name : `custom.${name}`;
-}
-function buildBeliefsRefinePayload(textOrInput, rationale) {
-  return typeof textOrInput === "string" ? { text: textOrInput, rationale } : { text: textOrInput.text, rationale: textOrInput.rationale };
-}
-function buildBeliefsArchivePayload(input) {
-  return typeof input === "string" ? { reason: input } : input ? { reason: input.reason ?? input.rationale } : void 0;
-}
-function asNodeArray(data) {
-  const rows = asListItems(data, "nodes");
-  if (rows.length > 0) {
-    return rows.filter(
-      (value) => Boolean(value) && typeof value === "object"
-    );
-  }
-  if (data && typeof data === "object") {
-    return [data];
-  }
-  return [];
-}
-function asEdgeArray(data) {
-  const rows = asListItems(data, "edges");
-  if (rows.length > 0) {
-    return rows.filter(
-      (value) => Boolean(value) && typeof value === "object"
-    );
-  }
-  if (data && typeof data === "object") {
-    return [data];
-  }
-  return [];
-}
-function requireTopicId(args) {
-  const topicId = resolveTopicId(args);
-  if (!topicId) {
-    throw new Error("topicId is required");
-  }
-  return topicId;
-}
-function requireTopicOrProjectId(args) {
-  const topicId = args.topicId?.trim() || args.projectId?.trim() || void 0;
-  if (!topicId) {
-    throw new Error("topicId is required");
-  }
-  return topicId;
-}
-var AUDIT_NODE_REFERENCE_KEY_PATTERN = /(^|_)(id|nodeid|beliefid|resourceid|targetid|sourceid|subjectid|globalid|entityid|recordid|fromnodeid|tonodeid|linkednodeid|linkedbeliefid|nodeids|beliefids|resourceids)$/i;
-function matchesAuditNodeReference(value, nodeId) {
-  if (Array.isArray(value)) {
-    return value.some((entry) => matchesAuditNodeReference(entry, nodeId));
-  }
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  return Object.entries(value).some(([key, entry]) => {
-    if (typeof entry === "string" && entry === nodeId && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key)) {
-      return true;
-    }
-    if (Array.isArray(entry) && AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key) && entry.some((item) => item === nodeId)) {
-      return true;
-    }
-    return matchesAuditNodeReference(entry, nodeId);
-  });
-}
-function requireText(args) {
-  const text = resolveText(args);
-  if (!text) {
-    throw new Error("text is required");
-  }
-  return text;
-}
-function requireBaseRate(args) {
-  const baseRate = typeof args.baseRate === "number" && Number.isFinite(args.baseRate) ? args.baseRate : 0.5;
-  if (baseRate < 0 || baseRate > 1) {
-    throw new Error("baseRate must be within [0, 1].");
-  }
-  return baseRate;
-}
-function sdkQueryString(input) {
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(input)) {
-    if (value === void 0 || value === null) {
-      continue;
-    }
-    if (Array.isArray(value)) {
-      if (value.length > 0) {
-        params.set(key, value.join(","));
-      }
-      continue;
-    }
-    params.set(key, String(value));
-  }
-  const serialized = params.toString();
-  return serialized ? `?${serialized}` : "";
-}
-
-export { asEdgeArray, asNodeArray, buildBeliefsArchivePayload, buildBeliefsRefinePayload, matchesAuditNodeReference, normalizeCustomNamespace, normalizeCustomToolPayload, requireBaseRate, requireText, requireTopicId, requireTopicOrProjectId, resolveCustomToolFullName, sdkQueryString };
-//# sourceMappingURL=clientHelpers.js.map
-//# sourceMappingURL=clientHelpers.js.map

package/dist/clientHelpers.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sdkSurface.ts","../src/clientHelpers.ts"],"names":[],"mappings":"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","file":"clientHelpers.js","sourcesContent":["import type { PlatformGatewaySuccess } from \"./coreClient\";\nimport type { JsonObject, ListResult } from \"./types\";\n\ntype TopicScopedValue = {\n  topicId?: string;\n};\n\ntype TextScopedValue = {\n  text?: string;\n  canonicalText?: string;\n};\n\ntype AnyRecord = Record<string, unknown>;\n\nexport function isRecord(value: unknown): value is AnyRecord {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function asRecord(value: unknown): AnyRecord {\n  return isRecord(value) ? value : {};\n}\n\nfunction cleanString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : undefined;\n}\n\nfunction normalizeVerificationStatus(value: unknown): string | undefined {\n  const status = cleanString(value);\n  if (!status) {\n    return undefined;\n  }\n  if (status === \"verified\") {\n    return \"human_verified\";\n  }\n  if (status === \"rejected\") {\n    return \"contradicted\";\n  }\n  return status;\n}\n\nfunction cloneWith<T extends AnyRecord>(value: T, patch: AnyRecord): T {\n  return { ...value, ...patch } as T;\n}\n\n/**\n * Resolve the canonical topic identifier.\n */\nexport function resolveTopicId(value: TopicScopedValue): string | undefined {\n  return cleanString(value.topicId);\n}\n\n/**\n * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.\n */\nexport function resolveText(value: TextScopedValue): string | undefined {\n  return cleanString(value.text) ?? cleanString(value.canonicalText);\n}\n\n/**\n * Attach the topicId to a record.\n */\nexport function withTopicAlias<T extends AnyRecord>(value: T): T {\n  const topicId = cleanString(value.topicId) ?? undefined;\n  if (!topicId) {\n    return value;\n  }\n  return cloneWith(value, { topicId });\n}\n\n/**\n * Attach the text/canonicalText alias pair to a record.\n */\nexport function withTextAlias<T extends AnyRecord>(value: T): T {\n  const text =\n    cleanString(value.text) ?? cleanString(value.canonicalText) ?? undefined;\n  if (!text) {\n    return value;\n  }\n  return cloneWith(value, { text, canonicalText: text });\n}\n\n/**\n * Attach topic and text aliases to SDK node-like records.\n */\nexport function withSdkAliases<T extends AnyRecord>(value: T): T {\n  return withTopicAlias(withTextAlias(value));\n}\n\n/**\n * Normalize a belief/question/evidence write payload to the canonical gateway shape.\n */\nexport function normalizeNodeWriteInput<T extends JsonObject>(value: T): T {\n  const topicId = resolveTopicId(value);\n  const text = resolveText(value);\n  const verificationStatus = normalizeVerificationStatus(value.verificationStatus);\n  const next = { ...value } as JsonObject;\n\n  if (topicId) {\n    next.topicId = topicId;\n  }\n  if (text) {\n    next.text = text;\n    next.canonicalText = text;\n  }\n  if (verificationStatus) {\n    next.verificationStatus = verificationStatus;\n  }\n\n  return next as T;\n}\n\nexport const normalizeNodeVerificationStatus = normalizeVerificationStatus;\n\n/**\n * Build a topic-aware query object.\n */\nexport function normalizeTopicQuery<T extends JsonObject>(value: T): T {\n  const topicId = cleanString(value.topicId);\n  if (!topicId) {\n    return value;\n  }\n  return { ...value, topicId } as T;\n}\n\n/**\n * Extract list items from array or list-envelope payloads.\n */\nexport function asListItems<T>(data: unknown, legacyKey?: string): T[] {\n  if (Array.isArray(data)) {\n    return data;\n  }\n\n  const record = asRecord(data);\n  if (Array.isArray(record.items)) {\n    return record.items;\n  }\n  if (legacyKey && Array.isArray(record[legacyKey])) {\n    return record[legacyKey];\n  }\n\n  return [];\n}\n\n/**\n * Standardize list data to { items, total } while retaining an optional legacy array key.\n */\nexport function createListResult<T, LegacyKey extends string>(\n  items: T[],\n  legacyKey?: LegacyKey\n): ListResult<T, LegacyKey> {\n  const result = {\n    items,\n    total: items.length,\n  } as ListResult<T, LegacyKey>;\n\n  if (legacyKey) {\n    return {\n      ...result,\n      [legacyKey]: items,\n    } as ListResult<T, LegacyKey>;\n  }\n\n  return result;\n}\n\n/**\n * Map a gateway success envelope's data while preserving the transport metadata.\n */\nexport function mapGatewayData<T, U>(\n  response: PlatformGatewaySuccess<T>,\n  mapper: (data: T) => U\n): PlatformGatewaySuccess<U> {\n  return {\n    ...response,\n    data: mapper(response.data),\n  };\n}\n\n/**\n * Apply SDK aliases across all items in a list-like payload.\n */\nexport function mapAliasedList<\n  TItem extends AnyRecord,\n  LegacyKey extends string,\n>(\n  data: unknown,\n  legacyKey?: LegacyKey\n): ListResult<TItem, LegacyKey> {\n  const items = asListItems<TItem>(data, legacyKey).map((item) =>\n    withSdkAliases(item)\n  );\n  return createListResult(items, legacyKey);\n}\n","import { asListItems, resolveText, resolveTopicId } from \"./sdkSurface\";\nimport type { JsonObject, PlatformGraphEdge, PlatformGraphNode } from \"./types\";\n\nexport type NodeLike = PlatformGraphNode;\nexport type EdgeLike = PlatformGraphEdge;\nexport type CustomToolInput = JsonObject;\nexport type BeliefsRefineInput =\n  | string\n  | { text: string; rationale?: string };\nexport type BeliefsArchiveInput = { reason?: string; rationale?: string } | string;\n\nexport function normalizeCustomNamespace(namespace: string): string {\n  return namespace.trim() || \"custom\";\n}\n\nexport function normalizeCustomToolPayload(input: unknown): CustomToolInput {\n  return input && typeof input === \"object\" && !Array.isArray(input)\n    ? (input as CustomToolInput)\n    : {};\n}\n\nexport function resolveCustomToolFullName(name: string): string {\n  return name.includes(\".\") ? name : `custom.${name}`;\n}\n\nexport function buildBeliefsRefinePayload(\n  textOrInput: BeliefsRefineInput,\n  rationale?: string\n): { text: string; rationale?: string } {\n  return typeof textOrInput === \"string\"\n    ? { text: textOrInput, rationale }\n    : { text: textOrInput.text, rationale: textOrInput.rationale };\n}\n\nexport function buildBeliefsArchivePayload(\n  input?: BeliefsArchiveInput\n): { reason?: string } | undefined {\n  return typeof input === \"string\"\n    ? { reason: input }\n    : input\n      ? { reason: input.reason ?? input.rationale }\n      : undefined;\n}\n\nexport function asNodeArray(data: unknown): NodeLike[] {\n  const rows = asListItems<NodeLike>(data, \"nodes\");\n  if (rows.length > 0) {\n    return rows.filter(\n      (value): value is NodeLike => Boolean(value) && typeof value === \"object\"\n    );\n  }\n  if (data && typeof data === \"object\") {\n    return [data as NodeLike];\n  }\n  return [];\n}\n\nexport function asEdgeArray(data: unknown): EdgeLike[] {\n  const rows = asListItems<EdgeLike>(data, \"edges\");\n  if (rows.length > 0) {\n    return rows.filter(\n      (value): value is EdgeLike => Boolean(value) && typeof value === \"object\"\n    );\n  }\n  if (data && typeof data === \"object\") {\n    return [data as EdgeLike];\n  }\n  return [];\n}\n\nexport function requireTopicId(args: { topicId?: string }): string {\n  const topicId = resolveTopicId(args);\n  if (!topicId) {\n    throw new Error(\"topicId is required\");\n  }\n  return topicId;\n}\n\nexport function requireTopicOrProjectId(args: {\n  topicId?: string;\n  projectId?: string;\n}): string {\n  const topicId =\n    args.topicId?.trim() || args.projectId?.trim() || undefined;\n  if (!topicId) {\n    throw new Error(\"topicId is required\");\n  }\n  return topicId;\n}\n\nconst AUDIT_NODE_REFERENCE_KEY_PATTERN =\n  /(^|_)(id|nodeid|beliefid|resourceid|targetid|sourceid|subjectid|globalid|entityid|recordid|fromnodeid|tonodeid|linkednodeid|linkedbeliefid|nodeids|beliefids|resourceids)$/i;\n\nexport function matchesAuditNodeReference(\n  value: unknown,\n  nodeId: string\n): boolean {\n  if (Array.isArray(value)) {\n    return value.some((entry) => matchesAuditNodeReference(entry, nodeId));\n  }\n\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  return Object.entries(value as Record<string, unknown>).some(([key, entry]) => {\n    if (\n      typeof entry === \"string\" &&\n      entry === nodeId &&\n      AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key)\n    ) {\n      return true;\n    }\n\n    if (\n      Array.isArray(entry) &&\n      AUDIT_NODE_REFERENCE_KEY_PATTERN.test(key) &&\n      entry.some((item) => item === nodeId)\n    ) {\n      return true;\n    }\n\n    return matchesAuditNodeReference(entry, nodeId);\n  });\n}\n\nexport function requireText(args: {\n  text?: string;\n  canonicalText?: string;\n  formulation?: string;\n  newFormulation?: string;\n}): string {\n  const text = resolveText(args);\n  if (!text) {\n    throw new Error(\"text is required\");\n  }\n  return text;\n}\n\nexport function requireBaseRate(args: { baseRate?: number }): number {\n  const baseRate =\n    typeof args.baseRate === \"number\" && Number.isFinite(args.baseRate)\n      ? args.baseRate\n      : 0.5;\n  if (baseRate < 0 || baseRate > 1) {\n    throw new Error(\"baseRate must be within [0, 1].\");\n  }\n  return baseRate;\n}\n\nexport function sdkQueryString(input: Record<string, unknown>): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(input)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    if (Array.isArray(value)) {\n      if (value.length > 0) {\n        params.set(key, value.join(\",\"));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n  const serialized = params.toString();\n  return serialized ? `?${serialized}` : \"\";\n}\n"]}

package/dist/control-plane.d.ts

@@ -1,69 +0,0 @@
-import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
-import { SdkPrincipalContext, JsonObject } from './types.js';
-import './authContext.js';
-import './contracts/auth-session.contract.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-
-type ControlPlanePrincipalType = "human" | "service" | "agent" | "group" | "external_viewer";
-type ControlPlanePrincipalStatus = "active" | "invited" | "suspended" | "disabled" | "revoked" | "missing";
-type ResolveInteractivePrincipalInput = {
-    clerkId: string;
-    tenantId?: string;
-    workspaceId?: string;
-    providerProjectId?: string;
-};
-type ControlPlanePermitSubject = {
-    subject: string;
-    tenant: string;
-    workspace?: string;
-};
-type ResolvedInteractivePrincipalContext = SdkPrincipalContext & {
-    principalType: ControlPlanePrincipalType;
-    authMode: "interactive_user";
-    clerkId: string;
-    tenantId: string;
-    workspaceId: string | null;
-    groupIds: string[];
-    permittedToolNames: string[];
-    permittedPackKeys: string[];
-    principalStatus: ControlPlanePrincipalStatus;
-    tenantStatus: string;
-    workspaceStatus: string;
-    permit: ControlPlanePermitSubject;
-};
-type ResolveInteractivePrincipalFailureReason = "principal_missing" | "tenant_missing" | "workspace_missing" | "membership_missing" | "ambiguous_principal" | "ambiguous_workspace" | "alias_invited" | "alias_suspended" | "alias_disabled" | "alias_revoked" | "principal_invited" | "principal_suspended" | "principal_disabled" | "principal_revoked" | "tenant_disabled" | "workspace_disabled" | "resolver_unavailable";
-type ResolveInteractivePrincipalFailure = {
-    ok: false;
-    reason: ResolveInteractivePrincipalFailureReason | (string & {});
-    message: string;
-    principalStatus?: ControlPlanePrincipalStatus | string;
-    tenantStatus?: string;
-    workspaceStatus?: string;
-    details?: JsonObject;
-};
-type ResolveInteractivePrincipalPayload = (ResolvedInteractivePrincipalContext & {
-    ok?: true;
-}) | ResolveInteractivePrincipalFailure;
-declare class LucernControlPlaneIdentityError extends Error {
-    readonly reason: ResolveInteractivePrincipalFailure["reason"];
-    readonly principalStatus?: string;
-    readonly tenantStatus?: string;
-    readonly workspaceStatus?: string;
-    readonly details?: JsonObject;
-    constructor(failure: ResolveInteractivePrincipalFailure);
-}
-declare function normalizeResolvedInteractivePrincipal(payload: ResolveInteractivePrincipalPayload): ResolvedInteractivePrincipalContext;
-type ResolveInteractivePrincipalResponse = PlatformGatewaySuccess<ResolvedInteractivePrincipalContext>;
-type ControlPlaneIdentityClientConfig = GatewayClientConfig;
-declare function createControlPlaneIdentityClient(config?: ControlPlaneIdentityClientConfig): {
-    resolveInteractivePrincipal(input: ResolveInteractivePrincipalInput): Promise<ResolveInteractivePrincipalResponse>;
-};
-declare function createControlPlaneClient(config?: ControlPlaneIdentityClientConfig): {
-    identity: {
-        resolveInteractivePrincipal(input: ResolveInteractivePrincipalInput): Promise<ResolveInteractivePrincipalResponse>;
-    };
-};
-
-export { type ControlPlaneIdentityClientConfig, type ControlPlanePermitSubject, type ControlPlanePrincipalStatus, type ControlPlanePrincipalType, LucernControlPlaneIdentityError, type ResolveInteractivePrincipalFailure, type ResolveInteractivePrincipalFailureReason, type ResolveInteractivePrincipalInput, type ResolveInteractivePrincipalResponse, type ResolvedInteractivePrincipalContext, createControlPlaneClient, createControlPlaneIdentityClient, normalizeResolvedInteractivePrincipal };