@xemahq/kernel-contracts 0.36.0 → 0.37.0

package/dist/agent-composition/lib/agent-workspace-sharing.d.ts

@@ -1,6 +1,7 @@
 export declare enum WorkspaceSharingPolicy {
     Isolated = "isolated",
-    Shareable = "shareable"
+    Shareable = "shareable",
+    Shared = "shared"
 }
 export declare const WORKSPACE_SHARING_DEFAULT: WorkspaceSharingPolicy;
 //# sourceMappingURL=agent-workspace-sharing.d.ts.map

package/dist/agent-composition/lib/agent-workspace-sharing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-workspace-sharing.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-sharing.ts"],"names":[],"mappings":"AAoBA,oBAAY,sBAAsB;IAMhC,QAAQ,aAAa;IAOrB,SAAS,cAAc;CACxB;AAOD,eAAO,MAAM,yBAAyB,EAAE,sBACP,CAAC"}
+{"version":3,"file":"agent-workspace-sharing.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-sharing.ts"],"names":[],"mappings":"AAoBA,oBAAY,sBAAsB;IAMhC,QAAQ,aAAa;IAOrB,SAAS,cAAc;IAavB,MAAM,WAAW;CAClB;AAOD,eAAO,MAAM,yBAAyB,EAAE,sBACP,CAAC"}

package/dist/agent-composition/lib/agent-workspace-sharing.js

@@ -5,6 +5,7 @@ var WorkspaceSharingPolicy;
 (function (WorkspaceSharingPolicy) {
     WorkspaceSharingPolicy["Isolated"] = "isolated";
     WorkspaceSharingPolicy["Shareable"] = "shareable";
+    WorkspaceSharingPolicy["Shared"] = "shared";
 })(WorkspaceSharingPolicy || (exports.WorkspaceSharingPolicy = WorkspaceSharingPolicy = {}));
 exports.WORKSPACE_SHARING_DEFAULT = WorkspaceSharingPolicy.Isolated;
 //# sourceMappingURL=agent-workspace-sharing.js.map

package/dist/agent-composition/lib/agent-workspace-sharing.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-workspace-sharing.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-sharing.ts"],"names":[],"mappings":";;;AAoBA,IAAY,sBAcX;AAdD,WAAY,sBAAsB;IAMhC,+CAAqB,CAAA;IAOrB,iDAAuB,CAAA;AACzB,CAAC,EAdW,sBAAsB,sCAAtB,sBAAsB,QAcjC;AAOY,QAAA,yBAAyB,GACpC,sBAAsB,CAAC,QAAQ,CAAC"}
+{"version":3,"file":"agent-workspace-sharing.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-sharing.ts"],"names":[],"mappings":";;;AAoBA,IAAY,sBA2BX;AA3BD,WAAY,sBAAsB;IAMhC,+CAAqB,CAAA;IAOrB,iDAAuB,CAAA;IAavB,2CAAiB,CAAA;AACnB,CAAC,EA3BW,sBAAsB,sCAAtB,sBAAsB,QA2BjC;AAOY,QAAA,yBAAyB,GACpC,sBAAsB,CAAC,QAAQ,CAAC"}

package/dist/agent-composition/lib/agent.d.ts

@@ -39,6 +39,10 @@ export interface AgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped
 export interface StandingSessionRef {
     readonly pinKey: string;
 }
+export type WorkspaceRef = string;
+export interface DurableWorkspaceRef {
+    readonly workspaceRef: WorkspaceRef;
+}
 export interface Agent {
     readonly slug: string;
     readonly version: string;
@@ -52,6 +56,7 @@ export interface Agent {
     readonly workspace?: AgentWorkspaceConfig;
     readonly workspaceSharing?: WorkspaceSharingPolicy;
     readonly standingSession?: StandingSessionRef;
+    readonly durableWorkspace?: DurableWorkspaceRef;
 }
 export interface ResolvedAgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
     readonly kernel: Required<AgentKernelRef>;
@@ -71,5 +76,6 @@ export interface ResolvedAgent {
     readonly workspace?: AgentWorkspaceConfig;
     readonly workspaceSharing?: WorkspaceSharingPolicy;
     readonly standingSession?: StandingSessionRef;
+    readonly durableWorkspace?: DurableWorkspaceRef;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent-composition/lib/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAKxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD,oBAAY,UAAU;IACpB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAQD,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,QAAQ,aAAa;CACtB;AAwBD,MAAM,WAAW,WAAW;IAE1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAQ3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AASD,MAAM,WAAW,SACf,SAAQ,mBAAmB,EACzB,uBAAuB;IAEzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAM9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IAQxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAgBD,MAAM,WAAW,kBAAkB;IAMjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAcD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAclC,MAAM,WAAW,mBAAmB;IAOlC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AAKD,MAAM,WAAW,KAAK;IAEpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAUnC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAEpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IAStC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAS1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAQnD,QAAQ,CAAC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAQ9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACjD;AAWD,MAAM,WAAW,iBACf,SAAQ,mBAAmB,EACzB,uBAAuB;IAEzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAM9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAQhD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAOrC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAO1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAMnD,QAAQ,CAAC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IAO9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACjD"}

package/dist/connector/index.d.ts

@@ -6,6 +6,7 @@ export * from './lib/credential-kind';
 export * from './lib/credential-strategy-contribution';
 export * from './lib/onboarding-manifest';
 export * from './lib/provider-descriptor';
+export * from './lib/oauth-endpoints';
 export * from './lib/connector-descriptor';
 export * from './lib/envelope-schema';
 export * from './lib/filter-expr';

package/dist/connector/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC"}

package/dist/connector/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./lib/credential-kind"), exports);
 __exportStar(require("./lib/credential-strategy-contribution"), exports);
 __exportStar(require("./lib/onboarding-manifest"), exports);
 __exportStar(require("./lib/provider-descriptor"), exports);
+__exportStar(require("./lib/oauth-endpoints"), exports);
 __exportStar(require("./lib/connector-descriptor"), exports);
 __exportStar(require("./lib/envelope-schema"), exports);
 __exportStar(require("./lib/filter-expr"), exports);

package/dist/connector/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+DAA6C;AAC7C,+DAA6C;AAC7C,mDAAiC;AACjC,wDAAsC;AACtC,yEAAuD;AACvD,4DAA0C;AAC1C,4DAA0C;AAC1C,6DAA2C;AAC3C,wDAAsC;AACtC,oDAAkC;AAClC,2DAAyC;AACzC,6DAA2C;AAC3C,0EAAwD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+DAA6C;AAC7C,+DAA6C;AAC7C,mDAAiC;AACjC,wDAAsC;AACtC,yEAAuD;AACvD,4DAA0C;AAC1C,4DAA0C;AAC1C,wDAAsC;AACtC,6DAA2C;AAC3C,wDAAsC;AACtC,oDAAkC;AAClC,2DAAyC;AACzC,6DAA2C;AAC3C,0EAAwD"}

package/dist/connector/lib/oauth-endpoints.d.ts

@@ -0,0 +1,7 @@
+export interface OAuthAuthorityEndpoints {
+    readonly authorizationUrl: string;
+    readonly tokenUrl: string;
+}
+export declare const GOOGLE_OAUTH_ENDPOINTS: OAuthAuthorityEndpoints;
+export declare const MICROSOFT_OAUTH_ENDPOINTS: OAuthAuthorityEndpoints;
+//# sourceMappingURL=oauth-endpoints.d.ts.map

package/dist/connector/lib/oauth-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-endpoints.d.ts","sourceRoot":"","sources":["../../../src/connector/lib/oauth-endpoints.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,uBAAuB;IAEtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD,eAAO,MAAM,sBAAsB,EAAE,uBAG3B,CAAC;AAOX,eAAO,MAAM,yBAAyB,EAAE,uBAI9B,CAAC"}

package/dist/connector/lib/oauth-endpoints.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MICROSOFT_OAUTH_ENDPOINTS = exports.GOOGLE_OAUTH_ENDPOINTS = void 0;
+exports.GOOGLE_OAUTH_ENDPOINTS = {
+    authorizationUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
+    tokenUrl: 'https://oauth2.googleapis.com/token',
+};
+exports.MICROSOFT_OAUTH_ENDPOINTS = {
+    authorizationUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
+    tokenUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
+};
+//# sourceMappingURL=oauth-endpoints.js.map

package/dist/connector/lib/oauth-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-endpoints.js","sourceRoot":"","sources":["../../../src/connector/lib/oauth-endpoints.ts"],"names":[],"mappings":";;;AAmCa,QAAA,sBAAsB,GAA4B;IAC7D,gBAAgB,EAAE,8CAA8C;IAChE,QAAQ,EAAE,qCAAqC;CACvC,CAAC;AAOE,QAAA,yBAAyB,GAA4B;IAChE,gBAAgB,EACd,gEAAgE;IAClE,QAAQ,EAAE,4DAA4D;CAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",

package/src/agent-composition/lib/agent-workspace-sharing.ts

@@ -32,6 +32,19 @@ export enum WorkspaceSharingPolicy {
    * / chat-style agents.
    */
   Shareable = 'shareable',
+  /**
+   * N INDEPENDENT sessions/pods operate on ONE durable, named workspace whose
+   * files are the source of truth (a session is a disposable cache; a lost
+   * session re-reads the files). Unlike {@link Shareable} — which pools
+   * multiple threads onto ONE pod's `/workspace` — `shared` binds SEPARATE
+   * pods to the same durable storage identified by a
+   * {@link DurableWorkspaceRef}, coordinated by an advisory single-writer
+   * cross-session write-lease (readers free; one in-flight mutating turn at a
+   * time across the sharing sessions). This is the multi-pod tier; it engages
+   * only for an agent that also binds a `durableWorkspace`. OPTIONAL +
+   * additive: absent ⇒ today's behaviour.
+   */
+  Shared = 'shared',
 }
 
 /**

package/src/agent-composition/lib/agent.ts

@@ -153,6 +153,42 @@ export interface StandingSessionRef {
   readonly pinKey: string;
 }
 
+/**
+ * A stable, opaque identifier for a DURABLE, NAMED workspace whose files are
+ * the source of truth and which MANY independent sessions/pods may attach to
+ * (the multi-pod {@link WorkspaceSharingPolicy.Shared} tier). Unlike the
+ * default sessionId-derived, per-session workspace path, a durable workspace
+ * lives at a `workspaceRef`-keyed storage sub-path shared across every session
+ * that binds the same ref, and cross-session writes are serialized by an
+ * advisory single-writer write-lease keyed on the ref.
+ *
+ * OPTIONAL + additive: when an agent declares none, each session gets its own
+ * private, sessionId-derived workspace exactly as today.
+ */
+export type WorkspaceRef = string;
+
+/**
+ * Declares that an agent/composition binds to a DURABLE, NAMED workspace shared
+ * across N independent sessions (separate pods), instead of a private
+ * per-session workspace. When present, the session layer stores the
+ * {@link workspaceRef} on the session and the storage layer resolves a
+ * `workspaceRef`-keyed shared sub-path (not the sessionId-derived one); a
+ * cross-session write-lease keyed on the ref serializes mutating turns across
+ * the sharing sessions (readers free).
+ *
+ * OPTIONAL + additive: absent ⇒ today's private per-session workspace. Pairs
+ * with {@link WorkspaceSharingPolicy.Shared}.
+ */
+export interface DurableWorkspaceRef {
+  /**
+   * Stable, opaque durable-workspace identity. Two sessions that carry the same
+   * `workspaceRef` (within the same `(orgId, projectId)`) attach to the SAME
+   * durable storage sub-path and coordinate through ONE cross-session
+   * write-lease.
+   */
+  readonly workspaceRef: WorkspaceRef;
+}
+
 /**
  * A named, versioned, reusable Agent.
  */
@@ -204,6 +240,14 @@ export interface Agent {
    * {@link StandingSessionRef}.
    */
   readonly standingSession?: StandingSessionRef;
+  /**
+   * When set, sessions running this agent attach to a DURABLE, NAMED workspace
+   * shared across independent pods (the multi-pod
+   * {@link WorkspaceSharingPolicy.Shared} tier) instead of a private
+   * per-session workspace. OPTIONAL + additive: absent ⇒ today's private
+   * per-session workspace. See {@link DurableWorkspaceRef}.
+   */
+  readonly durableWorkspace?: DurableWorkspaceRef;
 }
 
 /**
@@ -274,4 +318,11 @@ export interface ResolvedAgent {
    * without re-fetching the definition. Absent ⇒ a fresh session per launch.
    */
   readonly standingSession?: StandingSessionRef;
+  /**
+   * Resolved durable-workspace binding — carried from the source `Agent` so the
+   * session layer can store the `workspaceRef` and the storage layer can
+   * resolve the shared, `workspaceRef`-keyed sub-path. Absent ⇒ today's private
+   * per-session workspace. See {@link DurableWorkspaceRef}.
+   */
+  readonly durableWorkspace?: DurableWorkspaceRef;
 }

package/src/connector/index.ts

@@ -6,6 +6,7 @@ export * from './lib/credential-kind';
 export * from './lib/credential-strategy-contribution';
 export * from './lib/onboarding-manifest';
 export * from './lib/provider-descriptor';
+export * from './lib/oauth-endpoints';
 export * from './lib/connector-descriptor';
 export * from './lib/envelope-schema';
 export * from './lib/filter-expr';

package/src/connector/lib/oauth-endpoints.ts

@@ -0,0 +1,50 @@
+/**
+ * ─────────────────────────────────────────────────────────────────────────
+ * Stable OAuth authority endpoints — single source of truth
+ *
+ * The authorization-code + token-exchange endpoints for the well-known OAuth
+ * authorities (Google, Microsoft Entra "common" tenant) are STABLE — they do
+ * not change per consumer and are not secrets. Before this module they were
+ * hardcoded independently in every OAuth consumer (gmail-connector,
+ * ms365-connector, mailops), inviting drift. They are now declared ONCE here.
+ *
+ * SCOPE — authority endpoints ONLY. `scopes`, `extraAuthorizeParams`
+ * (e.g. Google's `access_type=offline` / `prompt=consent`, Microsoft's
+ * `prompt`), redirect URIs, client credentials, and connector slugs
+ * legitimately DIFFER per consumer and MUST stay local to each consumer. Do
+ * NOT add any of those here — this file carries the two URLs and nothing else.
+ *
+ * The shape is value-compatible with the required fields of
+ * {@link ProviderOAuthEndpoints} (`authorizationUrl` + `tokenUrl`), so a
+ * consumer can spread these into a full `ProviderOAuthEndpoints` and add its
+ * own scopes/params.
+ * ─────────────────────────────────────────────────────────────────────────
+ */
+
+/** The stable authority endpoints of one OAuth provider — no scopes, no params. */
+export interface OAuthAuthorityEndpoints {
+  /** Authorization-code consent endpoint (where the user is redirected). */
+  readonly authorizationUrl: string;
+  /** Token-exchange endpoint (code→token, refresh-token rotation). */
+  readonly tokenUrl: string;
+}
+
+/**
+ * Google OAuth 2.0 authority endpoints (v2 auth + token). Stable across all
+ * Google APIs; consumers supply their own scopes and authorize params.
+ */
+export const GOOGLE_OAUTH_ENDPOINTS: OAuthAuthorityEndpoints = {
+  authorizationUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
+  tokenUrl: 'https://oauth2.googleapis.com/token',
+} as const;
+
+/**
+ * Microsoft Entra ID (Azure AD) OAuth 2.0 authority endpoints on the multi-
+ * tenant `common` authority. Consumers that must pin a single tenant build
+ * their own URLs; this constant is the shared multi-tenant default.
+ */
+export const MICROSOFT_OAUTH_ENDPOINTS: OAuthAuthorityEndpoints = {
+  authorizationUrl:
+    'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
+  tokenUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
+} as const;