@lssm/lib.contracts-integrations 9.0.1

package/dist/integrations/providers/web-access-shared.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as d}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as p}from"@lssm/lib.contracts-spec/registry";var g=(e)=>`${e.key}.v${e.version}`;class c extends p{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function m(e){return g(e)}var o=(e)=>e;function a({unsupportedModeReason:e,configFields:t,secretFields:n,rotationSupported:s=!1,setupSteps:i}){let r={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)r.configFields=t;if(n)r.secretFields=n;if(i)r.setupSteps=i;return{modes:{byok:r},exempt:!0,exemptionReason:e}}function b(e){return o({meta:{key:e.key,version:e.version??"1.0.0",category:"custom",title:e.title,description:e.description,domain:"knowledge",owners:["platform.ai"],tags:["web-access",...e.tags],stability:d.Experimental},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"Managed credentials are not shipped; tenants must supply provider-owned credentials through a SecretProvider.",secretFields:e.secretFields.map((t)=>({key:t})),rotationSupported:!1}),transports:e.transports,preferredTransport:e.preferredTransport,supportedAuthMethods:e.auth,capabilities:{provides:e.capabilities.map((t)=>({key:t,version:"1.0.0"}))},configSchema:{schema:{type:"object",properties:{baseUrl:{type:"string"},policyMode:{type:"string",enum:["governed","provider-pass-through","public-only"]},...e.configProperties}}},secretSchema:{schema:{type:"object",properties:Object.fromEntries(e.secretFields.map((t)=>[t,{type:"string"}]))},example:Object.fromEntries(e.secretFields.map((t)=>[t,"***"]))},healthCheck:{method:"custom",timeoutMs:5000},docsUrl:e.docsUrl,byokSetup:{setupInstructions:"Resolve provider credentials at execution time through SecretProvider; never persist credentials in integration config.",keyRotationSupported:!1,quotaTrackingSupported:!0}})}export{b as makeWebAccessIntegrationSpec};

package/dist/integrations/providers/whoop.d.ts

@@ -0,0 +1,3 @@
+import { type IntegrationSpecRegistry } from '../spec.js';
+export declare const whoopIntegrationSpec: import("..").IntegrationSpec;
+export declare function registerWhoopIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;

package/dist/integrations/providers/whoop.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as g}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as s}from"@lssm/lib.contracts-spec/registry";var p=(e)=>`${e.key}.v${e.version}`;class c extends s{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function u(e){return p(e)}var i=(e)=>e;var o=["official-api","official-mcp","aggregator-api","aggregator-mcp","unofficial"],l=[{key:"health.activities.read",version:"1.0.0"},{key:"health.workouts.read",version:"1.0.0"},{key:"health.sleep.read",version:"1.0.0"},{key:"health.biometrics.read",version:"1.0.0"}],d=[{type:"rest"},{type:"mcp",transport:"http"},{type:"webhook",inbound:{signatureHeader:"x-webhook-signature",signingAlgorithm:"hmac-sha256"}}],n=[{type:"oauth2",grantType:"authorization_code",tokenUrl:"",scopes:[]},{type:"api-key"},{type:"bearer"},{type:"basic"}];function a(e){let t=e.supportedAuthMethods??y(e);return i({meta:{key:e.key,version:"1.0.0",category:"health",title:e.title,description:e.description,domain:"health",owners:["platform.integrations"],tags:["health","wearables",...e.tags],stability:e.stability??g.Experimental},supportedModes:e.supportedModes??["managed","byok"],transports:e.transports??d,preferredTransport:"rest",supportedAuthMethods:t,capabilities:{provides:e.capabilities??[...l]},configSchema:{schema:{type:"object",properties:{apiBaseUrl:{type:"string",description:"Optional API base URL override for provider-specific regional or partner endpoints."},mcpUrl:{type:"string",description:"Optional MCP endpoint URL for provider tool transport."},oauthTokenUrl:{type:"string",description:"Optional OAuth token endpoint override used for access-token refresh flows."},defaultTransport:{type:"string",enum:[...o],description:"Preferred transport strategy used before fallbacks are attempted."},strategyOrder:{type:"array",items:{type:"string",enum:[...o]},description:"Ordered transport fallback strategy. Defaults to official API -> official MCP -> aggregator API -> aggregator MCP -> unofficial."},allowUnofficial:{type:"boolean",description:"Must be true to allow unofficial/automation connectors as fallback."},unofficialAllowList:{type:"array",items:{type:"string"},description:"Optional allowlist of provider keys allowed to use unofficial connectors."}}},example:{defaultTransport:e.defaultTransport??"official-api",strategyOrder:[...o],allowUnofficial:!1,unofficialAllowList:[]}},secretSchema:{schema:{type:"object",properties:{apiKey:{type:"string"},accessToken:{type:"string"},refreshToken:{type:"string"},tokenExpiresAt:{type:"string"},clientId:{type:"string"},clientSecret:{type:"string"},mcpAccessToken:{type:"string"},username:{type:"string"},password:{type:"string"}}},example:{apiKey:"provider-api-key",accessToken:"oauth-access-token",refreshToken:"oauth-refresh-token"}},healthCheck:{method:"list",timeoutMs:1e4},docsUrl:e.docsUrl,byokSetup:{setupInstructions:e.byokSetupInstructions??"Create provider credentials, set allowed scopes, and store credentials in secret provider.",requiredScopes:e.byokScopes,keyRotationSupported:!1,quotaTrackingSupported:!1}})}function y(e){if(e.oauthTokenUrl){let t=e.oauthTokenUrl;return n.map((r)=>{if(r.type==="oauth2")return{...r,tokenUrl:t,scopes:e.byokScopes??[]};return r})}return[...n]}var f=a({key:"health.whoop",title:"Whoop",description:"Whoop integration for sleep, recovery, workouts, and physiological metrics.",docsUrl:"https://developer.whoop.com/",tags:["whoop","official-api"],byokScopes:["read:recovery","read:workout","read:sleep","read:profile"]});function T(e){return e.register(f)}export{T as registerWhoopIntegration,f as whoopIntegrationSpec};

package/dist/integrations/runtime-transport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/integrations/runtime.d.ts

@@ -0,0 +1,140 @@
+import type { ResolvedAppConfig, ResolvedIntegration } from '@lssm/lib.contracts-spec/app-config/runtime';
+import type { ConnectionStatus, IntegrationConnection } from './connection.js';
+import type { SecretProvider } from './secrets/provider.js';
+import type { IntegrationSpec } from './spec.js';
+export interface IntegrationTraceMetadata {
+    blueprintName: string;
+    blueprintVersion: string;
+    configVersion: string;
+}
+export interface IntegrationTelemetryEvent {
+    tenantId: string;
+    appId: string;
+    environment?: string;
+    slotId?: string;
+    integrationKey: string;
+    integrationVersion: string;
+    connectionId: string;
+    status: 'success' | 'error';
+    durationMs?: number;
+    errorCode?: string;
+    errorMessage?: string;
+    occurredAt: Date;
+    metadata?: Record<string, string | number | boolean>;
+}
+export interface IntegrationTelemetryEmitter {
+    record(event: IntegrationTelemetryEvent): Promise<void> | void;
+}
+export type IntegrationInvocationStatus = 'success' | 'error';
+export interface IntegrationContext {
+    tenantId: string;
+    appId: string;
+    environment?: string;
+    slotId?: string;
+    spec: IntegrationSpec;
+    connection: IntegrationConnection;
+    secretProvider: SecretProvider;
+    secretReference: string;
+    trace: IntegrationTraceMetadata;
+    config?: Record<string, unknown>;
+}
+export interface IntegrationCallContext {
+    tenantId: string;
+    appId: string;
+    environment?: string;
+    blueprintName: string;
+    blueprintVersion: string;
+    configVersion: string;
+    slotId: string;
+    operation: string;
+}
+export interface IntegrationCallError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    cause?: unknown;
+}
+export interface IntegrationCallResult<T> {
+    success: boolean;
+    data?: T;
+    error?: IntegrationCallError;
+    metadata: {
+        latencyMs: number;
+        connectionId: string;
+        ownershipMode: IntegrationConnection['ownershipMode'];
+        attempts: number;
+    };
+}
+export interface IntegrationCallGuardOptions {
+    telemetry?: IntegrationTelemetryEmitter;
+    maxAttempts?: number;
+    backoffMs?: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => Date;
+}
+export declare class IntegrationCallGuard {
+    private readonly secretProvider;
+    private readonly telemetry?;
+    private readonly maxAttempts;
+    private readonly backoffMs;
+    private readonly shouldRetry;
+    private readonly sleep;
+    private readonly now;
+    constructor(secretProvider: SecretProvider, options?: IntegrationCallGuardOptions);
+    executeWithGuards<T>(slotId: string, operation: string, _input: unknown, resolvedConfig: ResolvedAppConfig, executor: (connection: IntegrationConnection, secrets: Record<string, string>) => Promise<T>): Promise<IntegrationCallResult<T>>;
+    private findIntegration;
+    private fetchSecrets;
+    private parseSecret;
+    private emitTelemetry;
+    private failure;
+    private makeContext;
+    private errorCodeFor;
+}
+import type { IntegrationAuthConfig, IntegrationAuthType } from './auth.js';
+import type { IntegrationTransportConfig, IntegrationTransportType } from './transport.js';
+import type { IntegrationVersionPolicy } from './versioning.js';
+/**
+ * Resolves the best transport to use for a given spec + connection.
+ */
+export interface TransportResolver {
+    resolve(specTransports: IntegrationTransportConfig[], preferredTransport: IntegrationTransportType | undefined, connectionTransport: IntegrationTransportType | undefined): IntegrationTransportType;
+}
+/**
+ * Default transport resolver: connection override > spec preferred > first available.
+ */
+export declare class DefaultTransportResolver implements TransportResolver {
+    resolve(specTransports: IntegrationTransportConfig[], preferredTransport: IntegrationTransportType | undefined, connectionTransport: IntegrationTransportType | undefined): IntegrationTransportType;
+}
+/**
+ * Resolves auth method: connection override > first supported method.
+ */
+export declare function resolveAuthMethod(specMethods: IntegrationAuthConfig[] | undefined, connectionMethod: IntegrationAuthType | undefined): IntegrationAuthType | undefined;
+/**
+ * Resolve full integration request context: transport, auth, and version.
+ */
+export declare function resolveIntegrationRequestContext(spec: {
+    transports?: IntegrationTransportConfig[];
+    preferredTransport?: IntegrationTransportType;
+    supportedAuthMethods?: IntegrationAuthConfig[];
+    versionPolicy?: IntegrationVersionPolicy;
+}, connection: {
+    activeTransport?: IntegrationTransportType;
+    authMethod?: IntegrationAuthType;
+    apiVersion?: string;
+}): {
+    transport: IntegrationTransportType;
+    authMethod: IntegrationAuthType | undefined;
+    apiVersion: string | undefined;
+};
+export type HealthTransportStrategy = 'official-api' | 'official-mcp' | 'aggregator-api' | 'aggregator-mcp' | 'unofficial';
+export interface HealthRuntimeStrategyOptions {
+    strategyOrder?: HealthTransportStrategy[];
+    allowUnofficial?: boolean;
+    unofficialAllowList?: string[];
+}
+export declare const DEFAULT_HEALTH_STRATEGY_ORDER: readonly HealthTransportStrategy[];
+export declare function resolveHealthStrategyOrder(options?: HealthRuntimeStrategyOptions): HealthTransportStrategy[];
+export declare function isUnofficialHealthProviderAllowed(providerKey: string, options?: HealthRuntimeStrategyOptions): boolean;
+export declare function ensureConnectionReady(integration: ResolvedIntegration): void;
+export declare function connectionStatusLabel(status: ConnectionStatus): string;

package/dist/integrations/runtime.js

@@ -0,0 +1,2 @@
+// @bun
+import{performance as c}from"perf_hooks";function v(e,t){return e.find((n)=>n.type===t)}function f(e,t){return e.some((n)=>n.type===t)}function k(e,t){return e.find((n)=>n.type===t)}function d(e,t){return e.some((n)=>n.type===t)}function m(e,t){if(!e)return;return t??e.currentVersion}function I(e,t){return e.supportedVersions.find((n)=>n.version===t)}function S(e,t){let n=I(e,t);return n?.status==="deprecated"||n?.status==="sunset"}function V(e){return e.supportedVersions.filter((t)=>t.status==="stable"||t.status==="beta")}var T=3,b=250;class x{secretProvider;telemetry;maxAttempts;backoffMs;shouldRetry;sleep;now;constructor(e,t={}){this.secretProvider=e;this.telemetry=t.telemetry,this.maxAttempts=Math.max(1,t.maxAttempts??T),this.backoffMs=t.backoffMs??b,this.shouldRetry=t.shouldRetry??((n)=>typeof n==="object"&&n!==null&&("retryable"in n)&&Boolean(n.retryable)),this.sleep=t.sleep??((n)=>n<=0?Promise.resolve():new Promise((r)=>setTimeout(r,n))),this.now=t.now??(()=>new Date)}async executeWithGuards(e,t,n,r,s){let o=this.findIntegration(e,r);if(!o)return this.failure({tenantId:r.tenantId,appId:r.appId,environment:r.environment,blueprintName:r.blueprintName,blueprintVersion:r.blueprintVersion,configVersion:r.configVersion,slotId:e,operation:t},void 0,{code:"SLOT_NOT_BOUND",message:`Integration slot "${e}" is not bound for tenant "${r.tenantId}".`,retryable:!1},0);let g=o.connection.status;if(g==="disconnected"||g==="error")return this.failure(this.makeContext(e,t,r),o,{code:"CONNECTION_NOT_READY",message:`Integration connection "${o.connection.meta.label}" is in status "${g}".`,retryable:!1},0);let h=await this.fetchSecrets(o.connection),a=0,u=c.now();while(a<this.maxAttempts){a+=1;try{let i=await s(o.connection,h),p=c.now()-u;return this.emitTelemetry(this.makeContext(e,t,r),o,"success",p),{success:!0,data:i,metadata:{latencyMs:p,connectionId:o.connection.meta.id,ownershipMode:o.connection.ownershipMode,attempts:a}}}catch(i){let p=c.now()-u;this.emitTelemetry(this.makeContext(e,t,r),o,"error",p,this.errorCodeFor(i),i instanceof Error?i.message:String(i));let l=this.shouldRetry(i,a);if(!l||a>=this.maxAttempts)return{success:!1,error:{code:this.errorCodeFor(i),message:i instanceof Error?i.message:String(i),retryable:l,cause:i},metadata:{latencyMs:p,connectionId:o.connection.meta.id,ownershipMode:o.connection.ownershipMode,attempts:a}};await this.sleep(this.backoffMs)}}return{success:!1,error:{code:"UNKNOWN_ERROR",message:"Integration call failed after retries.",retryable:!1},metadata:{latencyMs:c.now()-u,connectionId:o.connection.meta.id,ownershipMode:o.connection.ownershipMode,attempts:this.maxAttempts}}}findIntegration(e,t){return t.integrations.find((n)=>n.slot.slotId===e)}async fetchSecrets(e){if(!this.secretProvider.canHandle(e.secretRef))throw Error(`Secret provider "${this.secretProvider.id}" cannot handle reference "${e.secretRef}".`);let t=await this.secretProvider.getSecret(e.secretRef);return this.parseSecret(t)}parseSecret(e){let t=new TextDecoder().decode(e.data);try{let n=JSON.parse(t);if(n&&typeof n==="object"&&!Array.isArray(n)){let r=Object.entries(n).filter(([,s])=>typeof s==="string"||typeof s==="number"||typeof s==="boolean");return Object.fromEntries(r.map(([s,o])=>[s,String(o)]))}}catch{}return{secret:t}}emitTelemetry(e,t,n,r,s,o){if(!this.telemetry||!t)return;this.telemetry.record({tenantId:e.tenantId,appId:e.appId,environment:e.environment,slotId:e.slotId,integrationKey:t.connection.meta.integrationKey,integrationVersion:t.connection.meta.integrationVersion,connectionId:t.connection.meta.id,status:n,durationMs:r,errorCode:s,errorMessage:o,occurredAt:this.now(),metadata:{blueprint:`${e.blueprintName}.v${e.blueprintVersion}`,configVersion:e.configVersion,operation:e.operation}})}failure(e,t,n,r){if(t)this.emitTelemetry(e,t,"error",0,n.code,n.message);return{success:!1,error:n,metadata:{latencyMs:0,connectionId:t?.connection.meta.id??"unknown",ownershipMode:t?.connection.ownershipMode??"managed",attempts:r}}}makeContext(e,t,n){return{tenantId:n.tenantId,appId:n.appId,environment:n.environment,blueprintName:n.blueprintName,blueprintVersion:n.blueprintVersion,configVersion:n.configVersion,slotId:e,operation:t}}errorCodeFor(e){if(typeof e==="object"&&e!==null&&"code"in e&&typeof e.code==="string")return e.code;return"PROVIDER_ERROR"}}class y{resolve(e,t,n){if(n&&d(e,n))return n;if(t&&d(e,t))return t;let r=e[0];if(r)return r.type;return"rest"}}function A(e,t){if(!e||e.length===0)return t;if(t&&f(e,t))return t;return e[0]?.type}function N(e,t){return{transport:new y().resolve(e.transports??[],e.preferredTransport,t.activeTransport),authMethod:A(e.supportedAuthMethods,t.authMethod),apiVersion:m(e.versionPolicy,t.apiVersion)}}var C=["official-api","official-mcp","aggregator-api","aggregator-mcp","unofficial"];function _(e){let t=e?.strategyOrder&&e.strategyOrder.length>0?e.strategyOrder:[...C];if(e?.allowUnofficial)return[...t];return t.filter((n)=>n!=="unofficial")}function D(e,t){if(!t?.allowUnofficial)return!1;if(!t.unofficialAllowList||t.unofficialAllowList.length===0)return!0;return t.unofficialAllowList.includes(e)}function U(e){let t=e.connection.status;if(t==="disconnected"||t==="error")throw Error(`Integration connection "${e.connection.meta.label}" is in status "${t}".`)}function F(e){switch(e){case"connected":return"connected";case"disconnected":return"disconnected";case"error":return"error";case"unknown":default:return"unknown"}}export{C as DEFAULT_HEALTH_STRATEGY_ORDER,y as DefaultTransportResolver,x as IntegrationCallGuard,F as connectionStatusLabel,U as ensureConnectionReady,D as isUnofficialHealthProviderAllowed,A as resolveAuthMethod,_ as resolveHealthStrategyOrder,N as resolveIntegrationRequestContext};

package/dist/integrations/runtime.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/integrations/sales-intelligence/events.d.ts

@@ -0,0 +1,182 @@
+import { EventRegistry } from '@lssm/lib.contracts-spec/events';
+import { SchemaModel } from '@lssm/lib.schema';
+export declare const FullEnrichBatchCompletePayload: SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    batchId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const FullEnrichContactFinishedPayload: SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    contactId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const FullEnrichBatchCompleteEvent: import("@lssm/lib.contracts-spec").EventSpec<SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    batchId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const FullEnrichContactFinishedEvent: import("@lssm/lib.contracts-spec").EventSpec<SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    contactId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const fullEnrichWebhookEvents: readonly [import("@lssm/lib.contracts-spec").EventSpec<SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    batchId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>, import("@lssm/lib.contracts-spec").EventSpec<SchemaModel<{
+    connectionId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    deliveryId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    jobId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: false;
+    };
+    correlationId: {
+        readonly type: import("@lssm/lib.schema").FieldType<string, string>;
+        readonly isOptional: true;
+    };
+    receivedAt: {
+        readonly type: import("@lssm/lib.schema").FieldType<Date, string>;
+        readonly isOptional: false;
+    };
+    payload: {
+        readonly type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        readonly isOptional: false;
+    };
+    contactId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>];
+export declare function registerFullEnrichWebhookEvents(registry: EventRegistry): EventRegistry;

package/dist/integrations/sales-intelligence/events.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineEvent as n}from"@lssm/lib.contracts-spec/events";import{ScalarTypeEnum as t,SchemaModel as i}from"@lssm/lib.schema";var e=t.NonEmptyString(),l={connectionId:{type:e,isOptional:!1},deliveryId:{type:e,isOptional:!1},jobId:{type:e,isOptional:!1},correlationId:{type:e,isOptional:!0},receivedAt:{type:t.DateTime(),isOptional:!1},payload:{type:t.JSONObject(),isOptional:!1}},c=new i({name:"FullEnrichBatchCompletePayload",fields:{...l,batchId:{type:e,isOptional:!1}}}),r=new i({name:"FullEnrichContactFinishedPayload",fields:{...l,contactId:{type:e,isOptional:!1}}}),p=n({meta:{key:"sales-intelligence.fullenrich.webhook.batch-complete",version:"1.0.0",description:"A FullEnrich enrichment batch reached a terminal result.",stability:"experimental",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","webhook"]},pii:["payload"],payload:c}),h=n({meta:{key:"sales-intelligence.fullenrich.webhook.contact-finished",version:"1.0.0",description:"A FullEnrich contact enrichment result became available.",stability:"experimental",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","webhook"]},pii:["payload"],payload:r}),d=[p,h];function u(o){return d.reduce((a,s)=>a.register(s),o)}export{p as FullEnrichBatchCompleteEvent,c as FullEnrichBatchCompletePayload,h as FullEnrichContactFinishedEvent,r as FullEnrichContactFinishedPayload,d as fullEnrichWebhookEvents,u as registerFullEnrichWebhookEvents};

package/dist/integrations/sales-intelligence/events.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/integrations/sales-intelligence/fullenrich-cancel-operation.d.ts

@@ -0,0 +1,39 @@
+export declare const FullEnrichContactEnrichmentCancel: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    jobId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    correlationId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    providerKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    jobId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    correlationId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    data: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    rawRedacted: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+}>, undefined>;

package/dist/integrations/sales-intelligence/fullenrich-cancel-operation.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as h}from"@lssm/lib.contracts-spec/operations";import{defaultRestPath as f}from"@lssm/lib.contracts-spec/jsonschema";var o="1.0.0";function r(t){return f(t,o)}function d(t){return`${t.replace(/\./g,"_")}-v1_0_0`}function a(t){return`fullenrich_${t}-v1_0_0`}import{ScalarTypeEnum as i,SchemaModel as l}from"@lssm/lib.schema";var n=i.JSONObject(),p=i.String_unsecure(),e=i.NonEmptyString(),s=new l({name:"FullEnrichResultInput",fields:{connectionId:{type:e,isOptional:!1},jobId:{type:e,isOptional:!1},correlationId:{type:e,isOptional:!0}}}),g=new l({name:"FullEnrichWebhookInput",fields:{connectionId:{type:e,isOptional:!1},headers:{type:n,isOptional:!0},payload:{type:n,isOptional:!1},receivedAt:{type:i.DateTime(),isOptional:!0}}}),c=new l({name:"FullEnrichReceiptOutput",fields:{providerKey:{type:e,isOptional:!1},jobId:{type:e,isOptional:!0},correlationId:{type:e,isOptional:!0},status:{type:p,isOptional:!1},data:{type:n,isOptional:!0},rawRedacted:{type:n,isOptional:!0}}}),E=new l({name:"FullEnrichRemoteMcpOutput",fields:{providerKey:{type:e,isOptional:!1},url:{type:e,isOptional:!1},auth:{type:e,isOptional:!1},toolCategories:{type:p,isOptional:!1,isArray:!0}}});var u="sales-intelligence.fullenrich.contact.enrichment.cancel",w=h({meta:{key:u,version:o,title:"Cancel FullEnrich Contact Enrichment",description:"Cancel a pending FullEnrich contact enrichment job.",goal:"Stop pending credit-bearing work when the provider still permits it.",context:"Cancellation is terminal and requires scoped human approval.",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","pii-safe"],stability:"experimental"},io:{input:s,output:c},policy:{auth:"user",policies:[],escalate:"human_review"},execution:{effects:["write","external-side-effect"],approval:{required:!0,effects:["write","external-side-effect"]}},transport:{rest:{method:"POST",path:r(u)},mcp:{toolName:a("contact_enrichment_cancel")}}});export{w as FullEnrichContactEnrichmentCancel};

package/dist/integrations/sales-intelligence/index.d.ts

@@ -0,0 +1,7 @@
+export * from './events.js';
+export * from './fullenrich-cancel-operation.js';
+export * from './operation-helpers.js';
+export * from './operations.js';
+export * from './schemas.js';
+export * from './schemas-events.js';
+export * from './schemas-results.js';

package/dist/integrations/sales-intelligence/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineEvent as M}from"@lssm/lib.contracts-spec/events";import{ScalarTypeEnum as I,SchemaModel as _}from"@lssm/lib.schema";var a=I.NonEmptyString(),j={connectionId:{type:a,isOptional:!1},deliveryId:{type:a,isOptional:!1},jobId:{type:a,isOptional:!1},correlationId:{type:a,isOptional:!0},receivedAt:{type:I.DateTime(),isOptional:!1},payload:{type:I.JSONObject(),isOptional:!1}},Q=new _({name:"FullEnrichBatchCompletePayload",fields:{...j,batchId:{type:a,isOptional:!1}}}),Y=new _({name:"FullEnrichContactFinishedPayload",fields:{...j,contactId:{type:a,isOptional:!1}}}),H=M({meta:{key:"sales-intelligence.fullenrich.webhook.batch-complete",version:"1.0.0",description:"A FullEnrich enrichment batch reached a terminal result.",stability:"experimental",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","webhook"]},pii:["payload"],payload:Q}),X=M({meta:{key:"sales-intelligence.fullenrich.webhook.contact-finished",version:"1.0.0",description:"A FullEnrich contact enrichment result became available.",stability:"experimental",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","webhook"]},pii:["payload"],payload:Y}),Z=[H,X];function ge(e){return Z.reduce((p,u)=>p.register(u),e)}import{defineCommand as te}from"@lssm/lib.contracts-spec/operations";import{defaultRestPath as ee}from"@lssm/lib.contracts-spec/jsonschema";var h="1.0.0";function f(e){return ee(e,h)}function L(e){return`${e.replace(/\./g,"_")}-v1_0_0`}function E(e){return`fullenrich_${e}-v1_0_0`}import{ScalarTypeEnum as O,SchemaModel as F}from"@lssm/lib.schema";var g=O.JSONObject(),G=O.String_unsecure(),l=O.NonEmptyString(),m=new F({name:"FullEnrichResultInput",fields:{connectionId:{type:l,isOptional:!1},jobId:{type:l,isOptional:!1},correlationId:{type:l,isOptional:!0}}}),N=new F({name:"FullEnrichWebhookInput",fields:{connectionId:{type:l,isOptional:!1},headers:{type:g,isOptional:!0},payload:{type:g,isOptional:!1},receivedAt:{type:O.DateTime(),isOptional:!0}}}),s=new F({name:"FullEnrichReceiptOutput",fields:{providerKey:{type:l,isOptional:!1},jobId:{type:l,isOptional:!0},correlationId:{type:l,isOptional:!0},status:{type:G,isOptional:!1},data:{type:g,isOptional:!0},rawRedacted:{type:g,isOptional:!0}}}),K=new F({name:"FullEnrichRemoteMcpOutput",fields:{providerKey:{type:l,isOptional:!1},url:{type:l,isOptional:!1},auth:{type:l,isOptional:!1},toolCategories:{type:G,isOptional:!1,isArray:!0}}});var W="sales-intelligence.fullenrich.contact.enrichment.cancel",V=te({meta:{key:W,version:h,title:"Cancel FullEnrich Contact Enrichment",description:"Cancel a pending FullEnrich contact enrichment job.",goal:"Stop pending credit-bearing work when the provider still permits it.",context:"Cancellation is terminal and requires scoped human approval.",owners:["@platform.integrations"],tags:["sales-intelligence","fullenrich","pii-safe"],stability:"experimental"},io:{input:m,output:s},policy:{auth:"user",policies:[],escalate:"human_review"},execution:{effects:["write","external-side-effect"],approval:{required:!0,effects:["write","external-side-effect"]}},transport:{rest:{method:"POST",path:f(W)},mcp:{toolName:E("contact_enrichment_cancel")}}});import{defineCommand as A,defineQuery as o}from"@lssm/lib.contracts-spec/operations";import{ScalarTypeEnum as x,SchemaModel as v}from"@lssm/lib.schema";var q=x.JSONObject(),D=x.String_unsecure(),i=x.NonEmptyString(),k=new v({name:"FullEnrichCorrelationInput",fields:{connectionId:{type:i,isOptional:!1},correlationId:{type:i,isOptional:!0},idempotencyKey:{type:i,isOptional:!0}}}),w=new v({name:"FullEnrichSearchInput",fields:{connectionId:{type:i,isOptional:!1},query:{type:i,isOptional:!0},filters:{type:q,isOptional:!0},limit:{type:x.Int_unsecure(),isOptional:!0},correlationId:{type:i,isOptional:!0}}}),R=new v({name:"FullEnrichLookupInput",fields:{connectionId:{type:i,isOptional:!1},identifier:{type:i,isOptional:!1},identifierType:{type:D,isOptional:!1},correlationId:{type:i,isOptional:!0}}}),C=new v({name:"FullEnrichAsyncStartInput",fields:{connectionId:{type:i,isOptional:!1},request:{type:q,isOptional:!1},correlationId:{type:i,isOptional:!0},webhookUrl:{type:D,isOptional:!0}}});import{ScalarTypeEnum as d,SchemaModel as S}from"@lssm/lib.schema";var B=d.JSONObject(),P=d.String_unsecure(),r=d.NonEmptyString(),U=new S({name:"FullEnrichCreditOutput",fields:{providerKey:{type:r,isOptional:!1},creditsRemaining:{type:d.Float_unsecure(),isOptional:!0},raw:{type:B,isOptional:!0},correlationId:{type:r,isOptional:!0}}}),J=new S({name:"FullEnrichValidationOutput",fields:{valid:{type:d.Boolean(),isOptional:!1},providerKey:{type:r,isOptional:!1},message:{type:P,isOptional:!0}}}),y=new S({name:"FullEnrichResultListOutput",fields:{providerKey:{type:r,isOptional:!1},items:{type:B,isOptional:!1},correlationId:{type:r,isOptional:!0}}}),T=new S({name:"FullEnrichAsyncStartOutput",fields:{providerKey:{type:r,isOptional:!1},jobId:{type:r,isOptional:!0},correlationId:{type:r,isOptional:!0},status:{type:P,isOptional:!1},expectedWebhookPath:{type:P,isOptional:!0}}});var ie=["@platform.integrations"],t={version:h,owners:ie,tags:["sales-intelligence","fullenrich","pii-safe"],stability:"experimental"},c={effects:["read"]},b={effects:["write","cost-bearing","external-side-effect"],approval:{required:!0}};function n(e,p,u){return{rest:{method:p,path:f(e)},mcp:{toolName:u??L(e)}}}var ne=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.credits.get",title:"Get FullEnrich Credits",description:"Read FullEnrich credit balance without exposing API keys.",goal:"Preflight enrichment usage and quota availability.",context:"Uses the documented FullEnrich credits API via a secret-backed runtime adapter."},io:{input:k,output:U},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.credits.get","GET")}),le=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.api-key.validate",title:"Validate FullEnrich API Key",description:"Validate configured FullEnrich credentials with redacted output.",goal:"Fail fast on invalid BYOK setup without logging key material.",context:"Uses provider key-validation endpoint through runtime secrets only."},io:{input:k,output:J},policy:{auth:"admin",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.api-key.validate","GET")}),oe=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.people.search",title:"Search FullEnrich People",description:"Search people through FullEnrich Search API.",goal:"Find candidate contacts with synthetic-test-safe result handling.",context:"Synchronous FullEnrich people search; no live calls in tests."},io:{input:w,output:y},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.people.search","POST")}),re=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.companies.search",title:"Search FullEnrich Companies",description:"Search companies through FullEnrich Search API.",goal:"Find candidate company records.",context:"Synchronous FullEnrich company search; no live calls in tests."},io:{input:w,output:y},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.companies.search","POST")}),ce=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.people.lookup",title:"Lookup FullEnrich Person",description:"Lookup/enrich a known person record.",goal:"Resolve a known person identifier through FullEnrich.",context:"Uses lookup/search surface only when provider supports the identifier type."},io:{input:R,output:y},policy:{auth:"user",policies:[]},execution:b,transport:n("sales-intelligence.fullenrich.people.lookup","POST")}),ae=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.companies.lookup",title:"Lookup FullEnrich Company",description:"Lookup/enrich a known company record.",goal:"Resolve a known company identifier through FullEnrich.",context:"Uses lookup/search surface only when provider supports the identifier type."},io:{input:R,output:y},policy:{auth:"user",policies:[]},execution:b,transport:n("sales-intelligence.fullenrich.companies.lookup","POST")}),se=A({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.contact.enrichment.start",title:"Start FullEnrich Contact Enrichment",description:"Start async FullEnrich contact enrichment.",goal:"Start enrichment and return correlation/job metadata.",context:"Webhook-first async flow; polling is fallback only."},io:{input:C,output:T},policy:{auth:"user",policies:[]},execution:b,transport:n("sales-intelligence.fullenrich.contact.enrichment.start","POST")}),pe=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.contact.enrichment.result.get",title:"Get FullEnrich Contact Enrichment Result",description:"Slow polling fallback for async enrichment results.",goal:"Retrieve a result when webhook delivery is unavailable.",context:"Fallback-only because FullEnrich recommends webhooks for async results."},io:{input:m,output:s},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.contact.enrichment.result.get","GET",E("contact_result_get"))}),ue=A({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.reverse-email.start",title:"Start FullEnrich Reverse Email Lookup",description:"Start async reverse-email lookup.",goal:"Resolve a contact from an email address with correlation metadata.",context:"Webhook-first async reverse-email flow."},io:{input:C,output:T},policy:{auth:"user",policies:[]},execution:b,transport:n("sales-intelligence.fullenrich.reverse-email.start","POST")}),he=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.reverse-email.result.get",title:"Get FullEnrich Reverse Email Result",description:"Slow polling fallback for reverse-email results.",goal:"Retrieve a reverse-email result when webhook delivery is unavailable.",context:"Fallback-only; callers should prefer webhook receipt."},io:{input:m,output:s},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.reverse-email.result.get","GET")}),me=A({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.webhook.enrichment.received",title:"Receive FullEnrich Enrichment Webhook",description:"Normalize inbound enrichment webhook payloads.",goal:"Produce an idempotent receipt without leaking raw PII or secrets.",context:"Signature verification is only enabled when official signing docs exist."},io:{input:N,output:s},policy:{auth:"admin",policies:[]},execution:{effects:["external-side-effect"]}}),de=o({meta:{...t,version:"1.0.0",key:"sales-intelligence.fullenrich.mcp.remote.describe",title:"Describe FullEnrich Remote MCP",description:"Describe the official FullEnrich remote MCP endpoint and auth.",goal:"Let agents discover remote MCP metadata without proxying OAuth secrets.",context:"Declares https://mcp.fullenrich.com/mcp with OAuth metadata."},io:{input:k,output:K},policy:{auth:"user",policies:[]},execution:c,transport:n("sales-intelligence.fullenrich.mcp.remote.describe","GET")}),z=[ne,le,oe,re,ce,ae,se,pe,V,ue,he,me,de],Ne=Object.fromEntries(z.map((e)=>[e.meta.key,e]));function Ke(e){return z.reduce((p,u)=>p.register(u),e)}export{le as FullEnrichApiKeyValidate,C as FullEnrichAsyncStartInput,T as FullEnrichAsyncStartOutput,H as FullEnrichBatchCompleteEvent,Q as FullEnrichBatchCompletePayload,ae as FullEnrichCompaniesLookup,re as FullEnrichCompaniesSearch,V as FullEnrichContactEnrichmentCancel,pe as FullEnrichContactEnrichmentResultGet,se as FullEnrichContactEnrichmentStart,X as FullEnrichContactFinishedEvent,Y as FullEnrichContactFinishedPayload,k as FullEnrichCorrelationInput,U as FullEnrichCreditOutput,ne as FullEnrichCreditsGet,R as FullEnrichLookupInput,de as FullEnrichMcpRemoteDescribe,ce as FullEnrichPeopleLookup,oe as FullEnrichPeopleSearch,s as FullEnrichReceiptOutput,K as FullEnrichRemoteMcpOutput,m as FullEnrichResultInput,y as FullEnrichResultListOutput,he as FullEnrichReverseEmailResultGet,ue as FullEnrichReverseEmailStart,w as FullEnrichSearchInput,J as FullEnrichValidationOutput,me as FullEnrichWebhookEnrichmentReceived,N as FullEnrichWebhookInput,L as defaultSalesIntelligenceMcpTool,f as defaultSalesIntelligenceRestPath,z as fullEnrichSalesIntelligenceOperations,Z as fullEnrichWebhookEvents,ge as registerFullEnrichWebhookEvents,Ke as registerSalesIntelligenceContracts,h as salesIntelligenceOperationVersion,Ne as salesIntelligenceOperations,E as shortFullEnrichMcpTool};

package/dist/integrations/sales-intelligence/operation-helpers.d.ts

@@ -0,0 +1,4 @@
+export declare const salesIntelligenceOperationVersion = "1.0.0";
+export declare function defaultSalesIntelligenceRestPath(key: string): string;
+export declare function defaultSalesIntelligenceMcpTool(key: string): string;
+export declare function shortFullEnrichMcpTool(suffix: string): string;

package/dist/integrations/sales-intelligence/operation-helpers.js

@@ -0,0 +1,2 @@
+// @bun
+import{defaultRestPath as e}from"@lssm/lib.contracts-spec/jsonschema";var n="1.0.0";function l(t){return e(t,n)}function i(t){return`${t.replace(/\./g,"_")}-v1_0_0`}function o(t){return`fullenrich_${t}-v1_0_0`}export{i as defaultSalesIntelligenceMcpTool,l as defaultSalesIntelligenceRestPath,n as salesIntelligenceOperationVersion,o as shortFullEnrichMcpTool};