@lssm/lib.contracts-integrations 9.0.1

package/dist/integrations/providers/fal.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as l}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as s}from"@lssm/lib.contracts-spec/registry";var c=(e)=>`${e.key}.v${e.version}`;class g extends s{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function u(e){return c(e)}var a=(e)=>e;function o({unsupportedModeReason:e,configFields:t,secretFields:r,rotationSupported:p=!1,setupSteps:n}){let i={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:p}};if(t)i.configFields=t;if(r)i.secretFields=r;if(n)i.setupSteps=n;return{modes:{byok:i},exempt:!0,exemptionReason:e}}var d=a({meta:{key:"ai-voice.fal",version:"1.0.0",category:"ai-voice-tts",title:"Fal Generative Media Platform",description:"Fal integration for generative media models including voice, image, video, realtime, queue, storage, SDK, and MCP surfaces.",domain:"ai",owners:["platform.ai"],tags:["media","voice","tts","image","video","realtime","mcp"],stability:l.Experimental},supportedModes:["byok"],credentialManifest:o({unsupportedModeReason:"Managed Fal credentials are not declared because public Fal access depends on tenant-owned FAL_KEY/API-key or MCP auth; ContractSpec does not provision a first-party Fal account for tenants.",secretFields:[{key:"apiKey",required:!0}],rotationSupported:!1}),transports:[{type:"sdk",packageName:"@fal-ai/client",runtime:"universal"},{type:"rest",baseUrl:"https://fal.run"},{type:"mcp",transport:"http",url:"https://mcp.fal.ai/mcp"}],preferredTransport:"sdk",supportedAuthMethods:[{type:"header",headerName:"Authorization",valuePrefix:"Key "},{type:"bearer",tokenField:"apiKey"}],capabilities:{provides:[{key:"ai.voice.tts",version:"1.0.0"},{key:"ai.image.generation",version:"1.0.0"},{key:"ai.video.generation",version:"1.0.0"},{key:"ai.media.realtime",version:"1.0.0"},{key:"provider.mcp.fal",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{modelId:{type:"string",description:"Fal model endpoint identifier (e.g. fal-ai/chatterbox/text-to-speech)."},defaultVoiceUrl:{type:"string",description:"Optional reference audio URL used as default voice conditioning input."},defaultExaggeration:{type:"number",minimum:0,maximum:1,description:"Optional default exaggeration value for speech output."},defaultTemperature:{type:"number",minimum:0.05,maximum:2,description:"Optional default temperature for synthesis requests."},defaultCfg:{type:"number",minimum:0.1,maximum:1,description:"Optional default cfg value for synthesis requests."},pollIntervalMs:{type:"number",description:"Optional queue polling interval in milliseconds."},mcpUrl:{type:"string",description:"Optional Fal hosted MCP server URL."}}},example:{modelId:"fal-ai/chatterbox/text-to-speech",mcpUrl:"https://mcp.fal.ai/mcp",defaultVoiceUrl:"https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3",defaultExaggeration:0.25,defaultTemperature:0.7,defaultCfg:0.5,pollIntervalMs:1000}},secretSchema:{schema:{type:"object",required:["apiKey"],properties:{apiKey:{type:"string",description:"Fal API key (FAL_KEY)."}}},example:{apiKey:"key-id:key-secret"}},healthCheck:{method:"custom",timeoutMs:7000},docsUrl:"https://fal.ai/models/fal-ai/chatterbox/text-to-speech/api",byokSetup:{setupInstructions:"Create a Fal API key, configure FAL_KEY for SDK/API calls, and use the hosted MCP URL with Bearer API-key auth. Fal account sign-in supports OAuth/SSO, but public MCP OAuth app auth is not documented as supported.",keyRotationSupported:!1,quotaTrackingSupported:!0}});function k(e){return e.register(d)}export{d as falIntegrationSpec,k as registerFalIntegration};

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

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

package/dist/integrations/providers/fathom.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 h(e){return g(e)}var i=(e)=>e;function a({unsupportedModeReason:e,configFields:t,secretFields:n,rotationSupported:s=!1,setupSteps:o}){let r={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)r.configFields=t;if(n)r.secretFields=n;if(o)r.setupSteps=o;return{modes:{byok:r},exempt:!0,exemptionReason:e}}var m=i({meta:{key:"meeting-recorder.fathom",version:"1.0.0",category:"meeting-recorder",title:"Fathom Meeting Recorder",description:"Fathom External API for meetings, transcripts, and webhook events.",domain:"productivity",owners:["platform.integrations"],tags:["meeting-recorder","fathom","transcripts"],stability:d.Experimental},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"Managed Fathom credentials are not declared because meeting API and webhook access require tenant-owned Fathom API keys and workspace configuration.",secretFields:[{key:"apiKey",required:!0},{key:"webhookSecret"}],rotationSupported:!1}),transports:[{type:"rest"},{type:"webhook",inbound:{signatureHeader:"x-fathom-signature",signingAlgorithm:"hmac-sha256"}}],preferredTransport:"rest",supportedAuthMethods:[{type:"api-key"},{type:"webhook-signing",algorithm:"hmac-sha256",signatureHeader:"x-fathom-signature"}],capabilities:{provides:[{key:"meeting-recorder.meetings.read",version:"1.0.0"},{key:"meeting-recorder.transcripts.read",version:"1.0.0"},{key:"meeting-recorder.webhooks",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{baseUrl:{type:"string",description:"Optional override for the Fathom API base URL. Defaults to https://api.fathom.ai/external/v1."},webhookUrl:{type:"string",description:"Webhook destination URL used when registering Fathom webhooks."},includeTranscript:{type:"boolean",description:"Include transcript data in Fathom webhook payloads."},includeSummary:{type:"boolean",description:"Include summary data in Fathom webhook payloads."},includeActionItems:{type:"boolean",description:"Include action items in Fathom webhook payloads."},includeCrmMatches:{type:"boolean",description:"Include CRM matches in Fathom webhook payloads."},triggeredFor:{type:"array",items:{type:"string"},description:"Recording scopes to trigger webhooks for (e.g., my_recordings)."}}},example:{baseUrl:"https://api.fathom.ai/external/v1",webhookUrl:"https://example.com/webhooks/fathom",includeTranscript:!0,includeSummary:!0,includeActionItems:!1,includeCrmMatches:!1,triggeredFor:["my_recordings"]}},secretSchema:{schema:{type:"object",required:["apiKey"],properties:{apiKey:{type:"string",description:"Fathom API key used in the X-Api-Key header."},webhookSecret:{type:"string",description:"Optional webhook secret used to verify Fathom webhook signatures."}}},example:{apiKey:"fathom-***",webhookSecret:"whsec_***"}},healthCheck:{method:"list",timeoutMs:8000},docsUrl:"https://developers.fathom.ai/",constraints:{rateLimit:{rpm:60}},byokSetup:{setupInstructions:"Generate an API key in Fathom settings and optionally configure webhooks for meeting content readiness.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function M(e){return e.register(m)}export{m as fathomIntegrationSpec,M as registerFathomIntegration};

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

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

package/dist/integrations/providers/firecrawl.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as l}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as c}from"@lssm/lib.contracts-spec/registry";var g=(e)=>`${e.key}.v${e.version}`;class d extends c{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function y(e){return g(e)}var o=(e)=>e;function a({unsupportedModeReason:e,configFields:t,secretFields:n,rotationSupported:p=!1,setupSteps:i}){let r={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:p}};if(t)r.configFields=t;if(n)r.secretFields=n;if(i)r.setupSteps=i;return{modes:{byok:r},exempt:!0,exemptionReason:e}}function s(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:l.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}})}var m=s({key:"web-access.firecrawl",title:"Firecrawl Web Access",description:"Firecrawl REST search, scrape, extract, map, and crawl operations.",tags:["search","scraping","extract","crawl"],transports:[{type:"rest",baseUrl:"https://api.firecrawl.dev/v2"}],preferredTransport:"rest",auth:[{type:"bearer",tokenField:"apiKey"}],secretFields:["apiKey"],capabilities:["web.search","web.fetch","web.extract","web.map","web.crawl"],docsUrl:"https://docs.firecrawl.dev/api-reference/v2-introduction"});function x(e){return e.register(m)}export{m as firecrawlIntegrationSpec,x as registerFirecrawlIntegration};

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

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

package/dist/integrations/providers/fireflies.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:i,rotationSupported:s=!1,setupSteps:n}){let r={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)r.configFields=t;if(i)r.secretFields=i;if(n)r.setupSteps=n;return{modes:{byok:r},exempt:!0,exemptionReason:e}}var l=o({meta:{key:"meeting-recorder.fireflies",version:"1.0.0",category:"meeting-recorder",title:"Fireflies.ai Meeting Recorder",description:"Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.",domain:"productivity",owners:["platform.integrations"],tags:["meeting-recorder","fireflies","transcripts"],stability:d.Experimental},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"Managed Fireflies credentials are not declared because GraphQL and webhook access depend on tenant-owned Fireflies API keys and developer settings.",secretFields:[{key:"apiKey",required:!0},{key:"webhookSecret"}],rotationSupported:!1}),transports:[{type:"rest",baseUrl:"https://api.fireflies.ai/graphql"},{type:"webhook",inbound:{signatureHeader:"x-fireflies-signature",signingAlgorithm:"hmac-sha256"}}],preferredTransport:"rest",supportedAuthMethods:[{type:"api-key"},{type:"webhook-signing",algorithm:"hmac-sha256",signatureHeader:"x-fireflies-signature"}],capabilities:{provides:[{key:"meeting-recorder.meetings.read",version:"1.0.0"},{key:"meeting-recorder.transcripts.read",version:"1.0.0"},{key:"meeting-recorder.webhooks",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{baseUrl:{type:"string",description:"Optional override for the Fireflies GraphQL endpoint. Defaults to https://api.fireflies.ai/graphql."},webhookUrl:{type:"string",description:"Webhook destination URL configured in Fireflies developer settings."},webhookEvents:{type:"array",items:{type:"string"},description:"Webhook events to subscribe to (e.g., Transcription completed)."},transcriptsPageSize:{type:"number",description:"Number of transcripts to request per GraphQL query."}}},example:{baseUrl:"https://api.fireflies.ai/graphql",webhookUrl:"https://example.com/webhooks/fireflies",webhookEvents:["Transcription completed"],transcriptsPageSize:25}},secretSchema:{schema:{type:"object",required:["apiKey"],properties:{apiKey:{type:"string",description:"Fireflies API key for GraphQL requests."},webhookSecret:{type:"string",description:"Optional webhook secret used to verify x-hub-signature HMAC payloads."}}},example:{apiKey:"fireflies-***",webhookSecret:"fireflies-webhook-secret"}},healthCheck:{method:"custom",timeoutMs:6000},docsUrl:"https://docs.fireflies.ai/getting-started/introduction",byokSetup:{setupInstructions:"Create a Fireflies API key and optionally configure webhook settings in Developer Settings.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function S(e){return e.register(l)}export{l as firefliesIntegrationSpec,S as registerFirefliesIntegration};

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

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

package/dist/integrations/providers/fitbit.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=(t)=>`${t.key}.v${t.version}`;class c extends s{constructor(t){super("integration",t)}getByCategory(t){return this.list().filter((e)=>e.meta.category===t)}}function u(t){return p(t)}var o=(t)=>t;var i=["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(t){let e=t.supportedAuthMethods??f(t);return o({meta:{key:t.key,version:"1.0.0",category:"health",title:t.title,description:t.description,domain:"health",owners:["platform.integrations"],tags:["health","wearables",...t.tags],stability:t.stability??g.Experimental},supportedModes:t.supportedModes??["managed","byok"],transports:t.transports??d,preferredTransport:"rest",supportedAuthMethods:e,capabilities:{provides:t.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:[...i],description:"Preferred transport strategy used before fallbacks are attempted."},strategyOrder:{type:"array",items:{type:"string",enum:[...i]},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:t.defaultTransport??"official-api",strategyOrder:[...i],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:t.docsUrl,byokSetup:{setupInstructions:t.byokSetupInstructions??"Create provider credentials, set allowed scopes, and store credentials in secret provider.",requiredScopes:t.byokScopes,keyRotationSupported:!1,quotaTrackingSupported:!1}})}function f(t){if(t.oauthTokenUrl){let e=t.oauthTokenUrl;return n.map((r)=>{if(r.type==="oauth2")return{...r,tokenUrl:e,scopes:t.byokScopes??[]};return r})}return[...n]}var y=a({key:"health.fitbit",title:"Fitbit",description:"Fitbit integration for activity, sleep, heart rate, and biometrics.",docsUrl:"https://dev.fitbit.com/build/reference/web-api/",tags:["fitbit","official-api"],byokScopes:["activity","heartrate","sleep","nutrition","weight","profile"]});function T(t){return t.register(y)}export{y as fitbitIntegrationSpec,T as registerFitbitIntegration};

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

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

package/dist/integrations/providers/fullenrich.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as g}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as p}from"@lssm/lib.contracts-spec/registry";var c=(e)=>`${e.key}.v${e.version}`;class l extends p{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function h(e){return c(e)}var o=(e)=>e;function a({unsupportedModeReason:e,configFields:t,secretFields:r,rotationSupported:s=!1,setupSteps:i}){let n={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)n.configFields=t;if(r)n.secretFields=r;if(i)n.setupSteps=i;return{modes:{byok:n},exempt:!0,exemptionReason:e}}var d=o({meta:{key:"crm.fullenrich",version:"1.0.0",category:"crm",title:"FullEnrich Sales Intelligence",description:"FullEnrich contact enrichment, reverse email lookup, search, credits, webhook, and remote MCP metadata integration.",domain:"sales-intelligence",owners:["platform.integrations"],tags:["sales-intelligence","contact-enrichment","fullenrich","mcp"],stability:g.Experimental},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"FullEnrich credentials are tenant-owned; ContractSpec does not provide a shared Managed FullEnrich tenant.",secretFields:[{key:"apiKey"}],rotationSupported:!1,setupSteps:["Create a FullEnrich API key in the vendor dashboard.","Store the key in an integration.runtime secret provider.","Use OAuth only for the remote FullEnrich MCP endpoint."]}),transports:[{type:"rest",baseUrl:"https://app.fullenrich.com/api/v2"},{type:"webhook"},{type:"mcp",transport:"http",url:"https://mcp.fullenrich.com/mcp"}],preferredTransport:"rest",supportedAuthMethods:[{type:"bearer",tokenField:"apiKey"},{type:"oauth2",grantType:"authorization_code",tokenUrl:"https://mcp.fullenrich.com/oauth/token",authorizationUrl:"https://mcp.fullenrich.com/oauth/authorize",scopes:["openid","offline_access"],pkce:!0}],capabilities:{provides:[{key:"sales-intelligence.contact-enrichment",version:"1.0.0"},{key:"sales-intelligence.reverse-email",version:"1.0.0"},{key:"sales-intelligence.people-search",version:"1.0.0"},{key:"sales-intelligence.company-search",version:"1.0.0"},{key:"provider.mcp.fullenrich",version:"1.0.0"},{key:"provider.webhook.fullenrich",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{baseUrl:{type:"string"},webhookPath:{type:"string"},pollingMinIntervalSeconds:{type:"number",minimum:60}}},example:{baseUrl:"https://app.fullenrich.com/api/v2",webhookPath:"/webhooks/fullenrich/enrichment",pollingMinIntervalSeconds:300}},secretSchema:{schema:{type:"object",required:["apiKey"],properties:{apiKey:{type:"string",description:"FullEnrich API key."}}},example:{apiKey:"fe_***"}},healthCheck:{method:"custom",timeoutMs:5000},docsUrl:"https://fullenrich.com/",byokSetup:{setupInstructions:"Use API keys for FullEnrich REST APIs. Prefer webhooks for async enrichment and reverse-email results; use slow polling only as fallback.",requiredScopes:["FullEnrich API key"],validationEndpoint:"https://app.fullenrich.com/api/v2",keyRotationSupported:!1,quotaTrackingSupported:!0}});function S(e){return e.register(d)}export{d as fullEnrichIntegrationSpec,S as registerFullEnrichIntegration};

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

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

package/dist/integrations/providers/garmin.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 n=(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"}}],i=[{type:"oauth2",grantType:"authorization_code",tokenUrl:"",scopes:[]},{type:"api-key"},{type:"bearer"},{type:"basic"}];function a(e){let t=e.supportedAuthMethods??f(e);return n({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 f(e){if(e.oauthTokenUrl){let t=e.oauthTokenUrl;return i.map((r)=>{if(r.type==="oauth2")return{...r,tokenUrl:t,scopes:e.byokScopes??[]};return r})}return[...i]}var y=a({key:"health.garmin",title:"Garmin",description:"Garmin integration for fitness activity, wellness, and sleep metrics.",docsUrl:"https://developer.garmin.com/gc-developer-program/overview/",tags:["garmin","official-api","partner"],byokSetupInstructions:"Use Garmin partner credentials or aggregator routes; enable unofficial connector only with explicit opt-in.",defaultTransport:"aggregator-api"});function T(e){return e.register(y)}export{y as garminIntegrationSpec,T as registerGarminIntegration};

package/dist/integrations/providers/gcs-storage.d.ts

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

package/dist/integrations/providers/gcs-storage.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as a}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as o}from"@lssm/lib.contracts-spec/registry";var i=(e)=>`${e.key}.v${e.version}`;class n extends o{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((r)=>r.meta.category===e)}}function c(e){return i(e)}var t=(e)=>e;var s=t({meta:{key:"storage.gcs",version:"1.0.0",category:"storage",title:"Google Cloud Storage Buckets",description:"Google Cloud Storage integration for object storage and retrieval.",domain:"infrastructure",owners:["platform.infrastructure"],tags:["storage","gcs","google-cloud"],stability:a.Beta},supportedModes:["managed","byok"],transports:[{type:"rest",baseUrl:"https://storage.googleapis.com"},{type:"sdk",packageName:"@google-cloud/storage",minVersion:"7.0.0"}],preferredTransport:"sdk",supportedAuthMethods:[{type:"service-account",credentialFormat:"json-key"},{type:"api-key"}],capabilities:{provides:[{key:"storage.objects",version:"1.0.0"}]},configSchema:{schema:{type:"object",required:["bucket"],properties:{bucket:{type:"string",description:"Primary bucket name used for storing objects."},prefix:{type:"string",description:"Optional prefix applied to object keys."}}},example:{bucket:"pfo-tenant-assets",prefix:"documents/"}},secretSchema:{schema:{type:"object",properties:{type:{type:"string",description:"Service account type field from Google credentials JSON (if provided)."},client_email:{type:"string"},private_key:{type:"string"},project_id:{type:"string"}}},example:{type:"service_account",client_email:"svc-account@example.iam.gserviceaccount.com",private_key:"-----BEGIN PRIVATE KEY-----...",project_id:"example-project"}},healthCheck:{method:"ping",timeoutMs:4000},docsUrl:"https://cloud.google.com/storage/docs/apis",constraints:{quotas:{storageGb:5120}},byokSetup:{setupInstructions:"Create a Google Cloud service account with Storage Object Admin role and upload the JSON credentials to the secret store.",keyRotationSupported:!1,quotaTrackingSupported:!0}});function u(e){return e.register(s)}export{s as gcsStorageIntegrationSpec,u as registerGcsStorageIntegration};

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

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

package/dist/integrations/providers/gmail.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as a}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as i}from"@lssm/lib.contracts-spec/registry";var n=(e)=>`${e.key}.v${e.version}`;class o extends i{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((r)=>r.meta.category===e)}}function c(e){return n(e)}var t=(e)=>e;var s=t({meta:{key:"email.gmail",version:"1.0.0",category:"email",title:"Google Gmail API",description:"Gmail integration supporting inbound thread ingestion and outbound transactional email.",domain:"communications",owners:["platform.messaging"],tags:["email","gmail"],stability:a.Beta},supportedModes:["managed","byok"],transports:[{type:"rest",baseUrl:"https://gmail.googleapis.com"},{type:"sdk",packageName:"googleapis",minVersion:"130.0.0"}],preferredTransport:"rest",supportedAuthMethods:[{type:"oauth2",grantType:"authorization_code",authorizationUrl:"https://accounts.google.com/o/oauth2/v2/auth",tokenUrl:"https://oauth2.googleapis.com/token",scopes:["https://www.googleapis.com/auth/gmail.modify"],pkce:!0},{type:"service-account",credentialFormat:"json-key"}],capabilities:{provides:[{key:"email.inbound",version:"1.0.0"},{key:"email.outbound",version:"1.0.0"},{key:"provider.delta.watch",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{labelIds:{type:"array",items:{type:"string"},description:"Optional list of label IDs to scope inbound sync."},includeSpamTrash:{type:"boolean",description:"Whether to include spam or trash messages during sync."},webhookTopic:{type:"string",description:"Optional Pub/Sub topic used for Gmail watch notifications."},historyCursor:{type:"string",description:"Optional Gmail history cursor to resume incremental sync."}}},example:{labelIds:["INBOX"],includeSpamTrash:!1}},secretSchema:{schema:{type:"object",required:["clientId","clientSecret","refreshToken"],properties:{clientId:{type:"string",description:"OAuth client ID for the Google Cloud project."},clientSecret:{type:"string",description:"OAuth client secret for the Google Cloud project."},refreshToken:{type:"string",description:"OAuth refresh token for delegated Gmail access."},redirectUri:{type:"string",description:"Optional redirect URI used when issuing the refresh token."}}},example:{clientId:"xxx.apps.googleusercontent.com",clientSecret:"secret",refreshToken:"refresh-token"}},healthCheck:{method:"custom",timeoutMs:4000},docsUrl:"https://developers.google.com/gmail/api",constraints:{rateLimit:{rpm:600}},byokSetup:{setupInstructions:"Create an OAuth consent screen and credentials within Google Cloud Console, then authorize the Gmail scopes and store the resulting refresh token.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function u(e){return e.register(s)}export{s as gmailIntegrationSpec,u as registerGmailIntegration};

package/dist/integrations/providers/google-calendar.d.ts

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

package/dist/integrations/providers/google-calendar.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as i}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as n}from"@lssm/lib.contracts-spec/registry";var a=(e)=>`${e.key}.v${e.version}`;class o extends n{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((r)=>r.meta.category===e)}}function c(e){return a(e)}var t=(e)=>e;var p=t({meta:{key:"calendar.google",version:"1.0.0",category:"calendar",title:"Google Calendar API",description:"Google Calendar integration for event creation, updates, and scheduling automations.",domain:"productivity",owners:["platform.messaging"],tags:["calendar","google"],stability:i.Beta},supportedModes:["managed","byok"],transports:[{type:"rest",baseUrl:"https://www.googleapis.com/calendar"},{type:"sdk",packageName:"googleapis"}],preferredTransport:"rest",supportedAuthMethods:[{type:"oauth2",grantType:"authorization_code",authorizationUrl:"https://accounts.google.com/o/oauth2/v2/auth",tokenUrl:"https://oauth2.googleapis.com/token",scopes:["https://www.googleapis.com/auth/calendar"],pkce:!0},{type:"service-account",credentialFormat:"json-key"}],capabilities:{provides:[{key:"calendar.events",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{calendarId:{type:"string",description:"Default calendar identifier (defaults to primary)."}}},example:{calendarId:"primary"}},secretSchema:{schema:{type:"object",required:["clientEmail","privateKey"],properties:{clientEmail:{type:"string",description:"Service account client email."},privateKey:{type:"string",description:"Service account private key."},projectId:{type:"string",description:"Google Cloud project ID."}}},example:{clientEmail:"svc-calendar@example.iam.gserviceaccount.com",privateKey:"-----BEGIN PRIVATE KEY-----...",projectId:"calendar-project"}},healthCheck:{method:"custom",timeoutMs:4000},docsUrl:"https://developers.google.com/calendar/api",constraints:{},byokSetup:{setupInstructions:"Create a Google service account with Calendar access and share the target calendars with the service account email.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function u(e){return e.register(p)}export{p as googleCalendarIntegrationSpec,u as registerGoogleCalendarIntegration};

package/dist/integrations/providers/google-drive.d.ts

@@ -0,0 +1,54 @@
+import { IntegrationSpecRegistry } from '../spec.js';
+import type { ProviderDeltaSyncState } from './provider-delta.js';
+export interface GoogleDriveFileMetadata {
+    id: string;
+    name: string;
+    mimeType: string;
+    modifiedTime?: string | Date;
+    sizeBytes?: number;
+    md5Checksum?: string;
+    webViewLink?: string;
+    parents?: string[];
+    trashed?: boolean;
+    metadata?: Record<string, string>;
+    delta?: ProviderDeltaSyncState;
+}
+export type GoogleDriveFileBody = {
+    data: Uint8Array;
+    stream?: never;
+} | {
+    data?: never;
+    stream: AsyncIterable<Uint8Array>;
+};
+export type GoogleDriveFile = GoogleDriveFileMetadata & GoogleDriveFileBody;
+export interface GoogleDriveListFilesQuery {
+    query?: string;
+    pageSize?: number;
+    pageToken?: string;
+    driveId?: string;
+    spaces?: string[];
+    includeItemsFromAllDrives?: boolean;
+    delta?: ProviderDeltaSyncState;
+}
+export interface GoogleDriveListFilesResult {
+    files: GoogleDriveFileMetadata[];
+    nextPageToken?: string;
+    delta?: ProviderDeltaSyncState;
+}
+export interface GoogleDriveWatchInput {
+    channelId: string;
+    webhookUrl: string;
+    token?: string;
+    expiresAt?: string | Date;
+    delta?: ProviderDeltaSyncState;
+}
+export interface GoogleDriveWatchResult {
+    delta: ProviderDeltaSyncState;
+}
+export interface GoogleDriveProvider {
+    listFiles(query?: GoogleDriveListFilesQuery): Promise<GoogleDriveListFilesResult>;
+    getFile(fileId: string): Promise<GoogleDriveFile | null>;
+    watchChanges?(input: GoogleDriveWatchInput): Promise<GoogleDriveWatchResult>;
+}
+export declare const googleDriveIntegrationSpec: import("..").IntegrationSpec;
+export declare function registerGoogleDriveIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;

package/dist/integrations/providers/google-drive.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as a}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as i}from"@lssm/lib.contracts-spec/registry";var o=(e)=>`${e.key}.v${e.version}`;class n extends i{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((r)=>r.meta.category===e)}}function p(e){return o(e)}var t=(e)=>e;var s=t({meta:{key:"storage.google-drive",version:"1.0.0",category:"storage",title:"Google Drive API",description:"Google Drive integration for file search, file retrieval, change watches, and knowledge ingestion.",domain:"productivity",owners:["platform.integrations"],tags:["storage","google-drive","knowledge"],stability:a.Beta},supportedModes:["managed","byok"],transports:[{type:"rest",baseUrl:"https://www.googleapis.com/drive/v3"},{type:"sdk",packageName:"googleapis"}],preferredTransport:"rest",supportedAuthMethods:[{type:"oauth2",grantType:"authorization_code",authorizationUrl:"https://accounts.google.com/o/oauth2/v2/auth",tokenUrl:"https://oauth2.googleapis.com/token",scopes:["https://www.googleapis.com/auth/drive.readonly","https://www.googleapis.com/auth/drive.metadata.readonly"],pkce:!0},{type:"service-account",credentialFormat:"json-key"}],capabilities:{provides:[{key:"storage.objects",version:"1.0.0"},{key:"knowledge.ingestion.drive",version:"1.0.0"},{key:"provider.delta.watch",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{driveId:{type:"string",description:"Optional shared drive identifier."},query:{type:"string",description:"Optional Drive search query for scoped sync."},includeItemsFromAllDrives:{type:"boolean",description:"Whether shared-drive files are included."},webhookUrl:{type:"string",description:"Optional webhook endpoint for Drive change watches."}}},example:{query:"mimeType = 'text/plain' and trashed = false",includeItemsFromAllDrives:!0}},secretSchema:{schema:{type:"object",properties:{clientId:{type:"string"},clientSecret:{type:"string"},refreshToken:{type:"string"},clientEmail:{type:"string"},privateKey:{type:"string"},projectId:{type:"string"}}},example:{clientId:"xxx.apps.googleusercontent.com",refreshToken:"refresh-token"}},healthCheck:{method:"custom",timeoutMs:4000},docsUrl:"https://developers.google.com/drive/api",constraints:{rateLimit:{rpm:600}},byokSetup:{setupInstructions:"Authorize Google Drive readonly scopes or share the target Drive folders with a service account before enabling sync.",requiredScopes:["https://www.googleapis.com/auth/drive.readonly","https://www.googleapis.com/auth/drive.metadata.readonly"],keyRotationSupported:!1,quotaTrackingSupported:!1}});function y(e){return e.register(s)}export{s as googleDriveIntegrationSpec,y as registerGoogleDriveIntegration};

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

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

package/dist/integrations/providers/gradium.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 c=(e)=>`${e.key}.v${e.version}`;class g extends p{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function l(e){return c(e)}var o=(e)=>e;function a({unsupportedModeReason:e,configFields:t,secretFields:r,rotationSupported:s=!1,setupSteps:n}){let i={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)i.configFields=t;if(r)i.secretFields=r;if(n)i.setupSteps=n;return{modes:{byok:i},exempt:!0,exemptionReason:e}}var m=o({meta:{key:"ai-voice.gradium",version:"1.0.0",category:"ai-voice-conversational",title:"Gradium Realtime Voice AI",description:"Gradium integration for realtime TTS, STT, voice library, REST, and WebSocket protocol access.",domain:"ai",owners:["platform.ai"],tags:["voice","tts","stt","realtime","websocket"],stability:d.Experimental},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"Managed Gradium credentials are not declared because ContractSpec does not provide a first-party Gradium managed account or OAuth app surface; tenants must supply their own Gradium API key.",secretFields:[{key:"apiKey",required:!0}],rotationSupported:!1}),transports:[{type:"rest",baseUrl:"https://api.gradium.ai/api"},{type:"websocket",url:"wss://api.gradium.ai/api",protocol:"mixed"}],preferredTransport:"rest",supportedAuthMethods:[{type:"api-key",headerName:"x-api-key"}],capabilities:{provides:[{key:"ai.voice.tts",version:"1.0.0"},{key:"ai.voice.stt",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{defaultVoiceId:{type:"string",description:"Optional default voice identifier used for synthesis."},region:{type:"string",enum:["eu","us"],description:"Gradium region used by the SDK (eu or us)."},baseUrl:{type:"string",description:"Optional API base URL override for private routing or proxies."},websocketBaseUrl:{type:"string",description:"Optional WebSocket base URL for realtime TTS/STT."},timeoutMs:{type:"number",description:"Optional request timeout in milliseconds."},outputFormat:{type:"string",enum:["wav","pcm","opus","ulaw_8000","alaw_8000","pcm_16000","pcm_24000"],description:"Optional default output format used when no format is specified."}}},example:{defaultVoiceId:"YTpq7expH9539ERJ",region:"eu",baseUrl:"https://api.gradium.ai/api",websocketBaseUrl:"wss://api.gradium.ai/api",timeoutMs:15000,outputFormat:"wav"}},secretSchema:{schema:{type:"object",required:["apiKey"],properties:{apiKey:{type:"string",description:"Gradium API key with TTS/STT access."}}},example:{apiKey:"gd_***"}},healthCheck:{method:"custom",timeoutMs:5000},docsUrl:"https://docs.gradium.ai/api-reference/introduction",byokSetup:{setupInstructions:"Create a Gradium API key, select the target region, and store credentials in your tenant secret provider. Public docs expose REST/WebSocket API-key access and Python SDK; no official JS SDK, MCP, or OAuth app surface is documented.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function k(e){return e.register(m)}export{m as gradiumIntegrationSpec,k as registerGradiumIntegration};

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

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

package/dist/integrations/providers/granola.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as d}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as s}from"@lssm/lib.contracts-spec/registry";var c=(e)=>`${e.key}.v${e.version}`;class g extends s{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function y(e){return c(e)}var a=(e)=>e;function i({unsupportedModeReason:e,configFields:t,secretFields:n,rotationSupported:p=!1,setupSteps:o}){let r={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:p}};if(t)r.configFields=t;if(n)r.secretFields=n;if(o)r.setupSteps=o;return{modes:{byok:r},exempt:!0,exemptionReason:e}}var l=a({meta:{key:"meeting-recorder.granola",version:"1.0.0",category:"meeting-recorder",title:"Granola Meeting Notes",description:"Granola meeting notes and transcripts via Enterprise API or MCP transport.",domain:"productivity",owners:["platform.integrations"],tags:["meeting-recorder","granola","transcripts"],stability:d.Experimental},supportedModes:["byok"],credentialManifest:i({unsupportedModeReason:"Managed Granola credentials are not declared because Granola access is tied to tenant/user browser OAuth, MCP proxy auth, or tenant enterprise API keys rather than a ContractSpec-managed provider account.",secretFields:[{key:"apiKey"},{key:"mcpAccessToken"}],rotationSupported:!1}),transports:[{type:"rest"},{type:"mcp",transport:"http"}],preferredTransport:"mcp",supportedAuthMethods:[{type:"api-key"},{type:"bearer"}],capabilities:{provides:[{key:"meeting-recorder.meetings.read",version:"1.0.0"},{key:"meeting-recorder.transcripts.read",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{baseUrl:{type:"string",description:"Optional override for the Granola API base URL. Defaults to https://public-api.granola.ai for API transport."},transport:{type:"string",enum:["api","mcp"],description:"Transport mode for Granola integration. Use api for Enterprise API or mcp for broader MCP access."},mcpUrl:{type:"string",description:"Optional override for Granola MCP URL. Defaults to https://mcp.granola.ai/mcp."},mcpHeaders:{type:"object",additionalProperties:{type:"string"},description:"Optional static headers for MCP gateway/proxy setups."},pageSize:{type:"number",description:"Page size for listing notes (maximum 30 per Granola API)."}}},example:{transport:"mcp",mcpUrl:"https://mcp.granola.ai/mcp",pageSize:10}},secretSchema:{schema:{type:"object",properties:{apiKey:{type:"string",description:"Granola API key used as a Bearer token for Enterprise API requests (transport=api)."},mcpAccessToken:{type:"string",description:"Optional bearer token for MCP proxy/gateway auth (transport=mcp)."}}},example:{mcpAccessToken:"granola-mcp-***"}},healthCheck:{method:"list",timeoutMs:8000},docsUrl:"https://docs.granola.ai/help-center/sharing/integrations/mcp",byokSetup:{setupInstructions:"Use Granola MCP for browser OAuth access, or configure an Enterprise API key for REST transport.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function S(e){return e.register(l)}export{l as granolaIntegrationSpec,S as registerGranolaIntegration};

package/dist/integrations/providers/gtm-providers.test.d.ts

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

package/dist/integrations/providers/health-provider-shared.d.ts

@@ -0,0 +1,28 @@
+import type { IntegrationAuthConfig } from '../auth.js';
+import { type IntegrationSpec } from '../spec.js';
+import type { IntegrationTransportConfig } from '../transport.js';
+declare const STRATEGY_ENUM: readonly ['official-api', 'official-mcp', 'aggregator-api', 'aggregator-mcp', 'unofficial'];
+export interface HealthProviderSpecInput {
+    key: string;
+    title: string;
+    description: string;
+    docsUrl: string;
+    tags: string[];
+    supportedModes?: ('managed' | 'byok')[];
+    stability?: IntegrationSpec['meta']['stability'];
+    byokSetupInstructions?: string;
+    byokScopes?: string[];
+    capabilities?: {
+        key: string;
+        version: string;
+    }[];
+    defaultTransport?: (typeof STRATEGY_ENUM)[number];
+    /** Override default transports for this health provider. */
+    transports?: IntegrationTransportConfig[];
+    /** Override default auth methods for this health provider. */
+    supportedAuthMethods?: IntegrationAuthConfig[];
+    /** OAuth token endpoint URL (populates oauth2 auth config). */
+    oauthTokenUrl?: string;
+}
+export declare function defineHealthProviderSpec(input: HealthProviderSpecInput): IntegrationSpec;
+export {};

package/dist/integrations/providers/health-provider-shared.js

@@ -0,0 +1,2 @@
+// @bun
+import{StabilityEnum as c}from"@lssm/lib.contracts-spec/ownership";import{SpecContractRegistry as a}from"@lssm/lib.contracts-spec/registry";var s=(e)=>`${e.key}.v${e.version}`;class p extends a{constructor(e){super("integration",e)}getByCategory(e){return this.list().filter((t)=>t.meta.category===e)}}function f(e){return s(e)}var n=(e)=>e;var o=["official-api","official-mcp","aggregator-api","aggregator-mcp","unofficial"],g=[{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"}],l=[{type:"rest"},{type:"mcp",transport:"http"},{type:"webhook",inbound:{signatureHeader:"x-webhook-signature",signingAlgorithm:"hmac-sha256"}}],i=[{type:"oauth2",grantType:"authorization_code",tokenUrl:"",scopes:[]},{type:"api-key"},{type:"bearer"},{type:"basic"}];function I(e){let t=e.supportedAuthMethods??d(e);return n({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??c.Experimental},supportedModes:e.supportedModes??["managed","byok"],transports:e.transports??l,preferredTransport:"rest",supportedAuthMethods:t,capabilities:{provides:e.capabilities??[...g]},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 d(e){if(e.oauthTokenUrl){let t=e.oauthTokenUrl;return i.map((r)=>{if(r.type==="oauth2")return{...r,tokenUrl:t,scopes:e.byokScopes??[]};return r})}return[...i]}export{I as defineHealthProviderSpec};

package/dist/integrations/providers/health-providers.test.d.ts

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

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

@@ -0,0 +1,186 @@
+export type HealthDataTransport = 'official-api' | 'official-mcp' | 'aggregator-api' | 'aggregator-mcp' | 'unofficial';
+export type HealthConnectionStatusState = 'healthy' | 'degraded' | 'error' | 'disconnected';
+export interface HealthDataSource {
+    providerKey: string;
+    transport: HealthDataTransport;
+    aggregatorKey?: string;
+    route: 'primary' | 'fallback';
+}
+export interface HealthActivity {
+    id: string;
+    externalId: string;
+    tenantId: string;
+    connectionId: string;
+    userId?: string;
+    providerKey: string;
+    activityType: string;
+    startedAt?: string;
+    endedAt?: string;
+    durationSeconds?: number;
+    distanceMeters?: number;
+    caloriesKcal?: number;
+    steps?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthWorkout {
+    id: string;
+    externalId: string;
+    tenantId: string;
+    connectionId: string;
+    userId?: string;
+    providerKey: string;
+    workoutType: string;
+    startedAt?: string;
+    endedAt?: string;
+    durationSeconds?: number;
+    distanceMeters?: number;
+    caloriesKcal?: number;
+    averageHeartRateBpm?: number;
+    maxHeartRateBpm?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthSleep {
+    id: string;
+    externalId: string;
+    tenantId: string;
+    connectionId: string;
+    userId?: string;
+    providerKey: string;
+    startedAt: string;
+    endedAt: string;
+    durationSeconds?: number;
+    deepSleepSeconds?: number;
+    lightSleepSeconds?: number;
+    remSleepSeconds?: number;
+    awakeSeconds?: number;
+    sleepScore?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthBiometric {
+    id: string;
+    externalId: string;
+    tenantId: string;
+    connectionId: string;
+    userId?: string;
+    providerKey: string;
+    metricType: string;
+    value: number;
+    unit?: string;
+    measuredAt: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthNutrition {
+    id: string;
+    externalId: string;
+    tenantId: string;
+    connectionId: string;
+    userId?: string;
+    providerKey: string;
+    loggedAt: string;
+    caloriesKcal?: number;
+    proteinGrams?: number;
+    carbsGrams?: number;
+    fatGrams?: number;
+    fiberGrams?: number;
+    hydrationMl?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthPagination {
+    nextCursor?: string;
+    hasMore?: boolean;
+}
+export interface HealthListActivitiesParams {
+    tenantId: string;
+    connectionId?: string;
+    userId?: string;
+    from?: string;
+    to?: string;
+    cursor?: string;
+    pageSize?: number;
+}
+export interface HealthListActivitiesResult extends HealthPagination {
+    activities: HealthActivity[];
+    source?: HealthDataSource;
+}
+export type HealthListWorkoutsParams = HealthListActivitiesParams;
+export interface HealthListWorkoutsResult extends HealthPagination {
+    workouts: HealthWorkout[];
+    source?: HealthDataSource;
+}
+export type HealthListSleepParams = HealthListActivitiesParams;
+export interface HealthListSleepResult extends HealthPagination {
+    sleep: HealthSleep[];
+    source?: HealthDataSource;
+}
+export interface HealthListBiometricsParams extends HealthListActivitiesParams {
+    metricTypes?: string[];
+}
+export interface HealthListBiometricsResult extends HealthPagination {
+    biometrics: HealthBiometric[];
+    source?: HealthDataSource;
+}
+export type HealthListNutritionParams = HealthListActivitiesParams;
+export interface HealthListNutritionResult extends HealthPagination {
+    nutrition: HealthNutrition[];
+    source?: HealthDataSource;
+}
+export interface HealthSyncRequest {
+    tenantId: string;
+    connectionId?: string;
+    userId?: string;
+    from?: string;
+    to?: string;
+    cursor?: string;
+    forceFullRefresh?: boolean;
+}
+export interface HealthSyncResult {
+    synced: number;
+    failed: number;
+    nextCursor?: string;
+    errors?: string[];
+    source?: HealthDataSource;
+}
+export interface HealthGetConnectionStatusParams {
+    tenantId: string;
+    connectionId: string;
+}
+export interface HealthConnectionStatus {
+    connectionId: string;
+    tenantId: string;
+    status: HealthConnectionStatusState;
+    source?: HealthDataSource;
+    lastCheckedAt?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthWebhookRequest {
+    headers: Record<string, string | string[] | undefined>;
+    rawBody: string;
+    parsedBody?: unknown;
+}
+export interface HealthWebhookEvent {
+    providerKey: string;
+    eventType?: string;
+    externalEntityId?: string;
+    entityType?: 'activity' | 'workout' | 'sleep' | 'biometric' | 'nutrition';
+    receivedAt?: string;
+    verified?: boolean;
+    payload?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthProvider {
+    listActivities(params: HealthListActivitiesParams): Promise<HealthListActivitiesResult>;
+    listWorkouts(params: HealthListWorkoutsParams): Promise<HealthListWorkoutsResult>;
+    listSleep(params: HealthListSleepParams): Promise<HealthListSleepResult>;
+    listBiometrics(params: HealthListBiometricsParams): Promise<HealthListBiometricsResult>;
+    listNutrition(params: HealthListNutritionParams): Promise<HealthListNutritionResult>;
+    getConnectionStatus(params: HealthGetConnectionStatusParams): Promise<HealthConnectionStatus>;
+    syncActivities?(params: HealthSyncRequest): Promise<HealthSyncResult>;
+    syncWorkouts?(params: HealthSyncRequest): Promise<HealthSyncResult>;
+    syncSleep?(params: HealthSyncRequest): Promise<HealthSyncResult>;
+    syncBiometrics?(params: HealthSyncRequest): Promise<HealthSyncResult>;
+    syncNutrition?(params: HealthSyncRequest): Promise<HealthSyncResult>;
+    parseWebhook?(request: HealthWebhookRequest): Promise<HealthWebhookEvent>;
+    verifyWebhook?(request: HealthWebhookRequest): Promise<boolean>;
+}

package/dist/integrations/providers/health.js

@@ -0,0 +1 @@
+// @bun

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

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

package/dist/integrations/providers/higgsfield.js

@@ -0,0 +1,2 @@
+// @bun
+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:r,rotationSupported:s=!1,setupSteps:n}){let i={mode:"byok",validationStrategy:"byok-lifecycle",rotation:{supported:s}};if(t)i.configFields=t;if(r)i.secretFields=r;if(n)i.setupSteps=n;return{modes:{byok:i},exempt:!0,exemptionReason:e}}var d=o({meta:{key:"ai-media.higgsfield",version:"1.0.0",category:"ai-image",title:"Higgsfield Generative Media",description:"Asynchronous image, image-to-video and talking-presenter generation through a tenant-isolated HTTP adapter.",domain:"ai",owners:["platform.ai"],tags:["image","video","ugc","marketing"],stability:"experimental"},supportedModes:["byok"],credentialManifest:a({unsupportedModeReason:"Managed credential provisioning and billing have not been qualified. Each installation supplies its own scoped Higgsfield credentials.",secretFields:[{key:"apiKey",required:!0},{key:"apiSecret",required:!0}],rotationSupported:!1}),transports:[{type:"rest",baseUrl:"https://platform.higgsfield.ai"}],preferredTransport:"rest",supportedAuthMethods:[{type:"header",headerName:"Authorization",valuePrefix:"Key "}],capabilities:{provides:[{key:"ai.image.generation",version:"1.0.0"},{key:"ai.video.generation",version:"1.0.0"}]},configSchema:{schema:{type:"object",properties:{outputHosts:{type:"array",items:{type:"string"}}},required:["outputHosts"]},example:{outputHosts:["cdn.example.com"]}},secretSchema:{schema:{type:"object",properties:{apiKey:{type:"string"},apiSecret:{type:"string"}},required:["apiKey","apiSecret"]},example:{apiKey:"example-key-id",apiSecret:"example-key-secret"}},healthCheck:{method:"custom",timeoutMs:1e4},docsUrl:"https://github.com/higgsfield-ai/higgsfield-js",byokSetup:{setupInstructions:"Provide a Higgsfield key ID and secret through the host secret resolver. Qualify permitted input/output asset hosts and generation modes. Poll existing request IDs; do not retry uncertain submissions.",keyRotationSupported:!1,quotaTrackingSupported:!1}});function I(e){return e.register(d)}export{d as higgsfieldIntegrationSpec,I as registerHiggsfieldIntegration};

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

@@ -0,0 +1,85 @@
+export type ImageFormat = 'png' | 'jpg' | 'webp' | 'svg';
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export declare const IMAGE_PRESETS: {
+    readonly ogImage: {
+        readonly width: 1200;
+        readonly height: 630;
+    };
+    readonly twitterCard: {
+        readonly width: 1200;
+        readonly height: 675;
+    };
+    readonly instagramSquare: {
+        readonly width: 1080;
+        readonly height: 1080;
+    };
+    readonly instagramStory: {
+        readonly width: 1080;
+        readonly height: 1920;
+    };
+    readonly blogHero: {
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    readonly thumbnail: {
+        readonly width: 640;
+        readonly height: 360;
+    };
+    readonly favicon: {
+        readonly width: 512;
+        readonly height: 512;
+    };
+    readonly emailHeader: {
+        readonly width: 600;
+        readonly height: 200;
+    };
+    readonly illustration: {
+        readonly width: 1024;
+        readonly height: 1024;
+    };
+};
+export interface ImageGenerationInput {
+    prompt: string;
+    negativePrompt?: string;
+    dimensions: ImageDimensions;
+    format?: ImageFormat;
+    style?: 'photorealistic' | 'illustration' | '3d-render' | 'flat-design' | 'abstract';
+    numVariants?: number;
+    guidanceScale?: number;
+    seed?: number;
+    /** Reference image for img2img / style transfer */
+    referenceImage?: Uint8Array;
+    referenceStrength?: number;
+    metadata?: Record<string, string>;
+}
+export interface ImageGenerationResult {
+    images: GeneratedImageData[];
+    seed: number;
+    model: string;
+    generationTimeMs?: number;
+}
+export interface GeneratedImageData {
+    data: Uint8Array;
+    format: ImageFormat;
+    dimensions: ImageDimensions;
+    url?: string;
+    /** Provider may revise the prompt */
+    revisedPrompt?: string;
+}
+export interface ImageProvider {
+    generate(input: ImageGenerationInput): Promise<ImageGenerationResult>;
+    listModels?(): Promise<ImageModelInfo[]>;
+    upscale?(image: Uint8Array, scale: number): Promise<GeneratedImageData>;
+    edit?(image: Uint8Array, mask: Uint8Array, prompt: string): Promise<GeneratedImageData>;
+}
+export interface ImageModelInfo {
+    id: string;
+    name: string;
+    maxDimensions: ImageDimensions;
+    supportedFormats: ImageFormat[];
+    supportsNegativePrompt: boolean;
+    supportsImg2Img: boolean;
+}

package/dist/integrations/providers/image.js

@@ -0,0 +1,2 @@
+// @bun
+var e={ogImage:{width:1200,height:630},twitterCard:{width:1200,height:675},instagramSquare:{width:1080,height:1080},instagramStory:{width:1080,height:1920},blogHero:{width:1920,height:1080},thumbnail:{width:640,height:360},favicon:{width:512,height:512},emailHeader:{width:600,height:200},illustration:{width:1024,height:1024}};export{e as IMAGE_PRESETS};