@lssm/lib.contracts-integrations 9.0.1

package/dist/integrations/operations.d.ts

@@ -0,0 +1,430 @@
+import { type AnyOperationSpec } from '@lssm/lib.contracts-spec/operations';
+import type { OperationSpecRegistry } from '@lssm/lib.contracts-spec/operations/registry';
+import { SchemaModel } from '@lssm/lib.schema';
+export declare const CreateIntegrationConnection: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationVersion: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    label: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    ownershipMode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalAccountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    secretProvider: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    secretRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    environment: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    config: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+}>, SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationVersion: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    label: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    ownershipMode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalAccountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    secretProvider: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    secretRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    environment: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthStatus: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthCheckedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    healthLatencyMs: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    healthErrorCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthErrorMessage: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    usageRequestCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageSuccessCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageErrorCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageLastUsedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    usageLastErrorAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    usageLastErrorCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const UpdateIntegrationConnection: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    label: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    ownershipMode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    externalAccountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    secretProvider: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    secretRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    config: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+}>, SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    integrationVersion: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    label: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    ownershipMode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalAccountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    secretProvider: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    secretRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    environment: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthStatus: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthCheckedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    healthLatencyMs: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    healthErrorCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    healthErrorMessage: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    usageRequestCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageSuccessCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageErrorCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    usageLastUsedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    usageLastErrorAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    usageLastErrorCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const DeleteIntegrationConnection: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, SchemaModel<{
+    success: {
+        type: import("@lssm/lib.schema").FieldType<boolean, boolean>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const ListIntegrationConnections: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    category: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, SchemaModel<{
+    connections: {
+        type: SchemaModel<{
+            id: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            tenantId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            integrationKey: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            integrationVersion: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: false;
+            };
+            label: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            ownershipMode: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            externalAccountId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            secretProvider: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            secretRef: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            status: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            environment: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            healthStatus: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            healthCheckedAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            healthLatencyMs: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: true;
+            };
+            healthErrorCode: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            healthErrorMessage: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            usageRequestCount: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: true;
+            };
+            usageSuccessCount: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: true;
+            };
+            usageErrorCount: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: true;
+            };
+            usageLastUsedAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            usageLastErrorAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            usageLastErrorCode: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            createdAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            updatedAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+        }>;
+        isOptional: false;
+        isArray: true;
+    };
+}>, undefined>;
+export declare const TestIntegrationConnection: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, SchemaModel<{
+    success: {
+        type: import("@lssm/lib.schema").FieldType<boolean, boolean>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    latencyMs: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    error: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    errorCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const integrationContracts: Record<string, AnyOperationSpec>;
+export declare function registerIntegrationContracts(registry: OperationSpecRegistry): OperationSpecRegistry;

package/dist/integrations/operations.js

@@ -0,0 +1,22 @@
+// @bun
+import{defineCommand as ne,defineQuery as vr}from"@lssm/lib.contracts-spec/operations";import{ScalarTypeEnum as r,SchemaModel as I}from"@lssm/lib.schema";import{defineQuery as Ie}from"@lssm/lib.contracts-spec/operations";import{ScalarTypeEnum as u,SchemaModel as U}from"@lssm/lib.schema";var Re=new U({name:"EmailProviderScopeInput",fields:{tenantId:{type:u.ID(),isOptional:!1},connectionId:{type:u.ID(),isOptional:!1}}}),Bt=new U({name:"EmailProviderHealthOutput",fields:{provider:{type:u.NonEmptyString(),isOptional:!1},status:{type:u.NonEmptyString(),isOptional:!1},checkedAt:{type:u.DateTime(),isOptional:!1},latencyMs:{type:u.Float_unsecure(),isOptional:!0},errorCode:{type:u.String_unsecure(),isOptional:!0}}}),_t=new U({name:"EmailInboundRouteRecord",fields:{id:{type:u.ID(),isOptional:!1},domainId:{type:u.ID(),isOptional:!1},name:{type:u.String_unsecure(),isOptional:!1},enabled:{type:u.Boolean(),isOptional:!1},createdAt:{type:u.DateTime(),isOptional:!0},updatedAt:{type:u.DateTime(),isOptional:!0}}}),Tt=new U({name:"EmailInboundRoutesOutput",fields:{provider:{type:u.NonEmptyString(),isOptional:!1},routes:{type:_t,isOptional:!1,isArray:!0}}}),Mt=Ie({meta:{key:"integrations.email.provider.health",title:"Inspect Email Provider Health",version:"1.0.0",description:"Inspect the redacted health state of a tenant-scoped email provider connection.",goal:"Give operators and governed agents safe provider diagnostics.",context:"Returns health metadata only; credentials and provider response bodies are never exposed.",owners:["@platform.integrations"],tags:["integration","email","health"],stability:"experimental"},io:{input:Re,output:Bt},policy:{auth:"admin",policies:[{key:"platform.integration.read",version:"1.0.0"}]}}),jt=Ie({meta:{key:"integrations.email.inbound-routes.list",title:"List Email Inbound Routes",version:"1.0.0",description:"List redacted inbound routing metadata for a tenant-scoped email provider connection.",goal:"Let operators verify inbound delivery configuration without revealing secrets.",context:"Exposes identifiers, labels, enabled state, and timestamps; filters and webhook secrets stay server-side.",owners:["@platform.integrations"],tags:["integration","email","inbound"],stability:"experimental"},io:{input:Re,output:Tt},policy:{auth:"admin",policies:[{key:"platform.integration.read",version:"1.0.0"}]}}),oe=[Mt,jt];import{defineEvent as De}from"@lssm/lib.contracts-spec/events";import{ScalarTypeEnum as se,SchemaModel as Ce}from"@lssm/lib.schema";var W=se.NonEmptyString(),We={connectionId:{type:W,isOptional:!1},deliveryId:{type:W,isOptional:!1},jobId:{type:W,isOptional:!1},correlationId:{type:W,isOptional:!0},receivedAt:{type:se.DateTime(),isOptional:!1},payload:{type:se.JSONObject(),isOptional:!1}},Nt=new Ce({name:"FullEnrichBatchCompletePayload",fields:{...We,batchId:{type:W,isOptional:!1}}}),Lt=new Ce({name:"FullEnrichContactFinishedPayload",fields:{...We,contactId:{type:W,isOptional:!1}}}),qt=De({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:Nt}),Gt=De({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:Lt}),Ut=[qt,Gt];function Mr(e){return Ut.reduce((t,n)=>t.register(n),e)}import{defineCommand as Jt}from"@lssm/lib.contracts-spec/operations";import{defaultRestPath as Vt}from"@lssm/lib.contracts-spec/jsonschema";var T="1.0.0";function V(e){return Vt(e,T)}function ke(e){return`${e.replace(/\./g,"_")}-v1_0_0`}function J(e){return`fullenrich_${e}-v1_0_0`}import{ScalarTypeEnum as z,SchemaModel as Q}from"@lssm/lib.schema";var K=z.JSONObject(),Pe=z.String_unsecure(),w=z.NonEmptyString(),M=new Q({name:"FullEnrichResultInput",fields:{connectionId:{type:w,isOptional:!1},jobId:{type:w,isOptional:!1},correlationId:{type:w,isOptional:!0}}}),Fe=new Q({name:"FullEnrichWebhookInput",fields:{connectionId:{type:w,isOptional:!1},headers:{type:K,isOptional:!0},payload:{type:K,isOptional:!1},receivedAt:{type:z.DateTime(),isOptional:!0}}}),k=new Q({name:"FullEnrichReceiptOutput",fields:{providerKey:{type:w,isOptional:!1},jobId:{type:w,isOptional:!0},correlationId:{type:w,isOptional:!0},status:{type:Pe,isOptional:!1},data:{type:K,isOptional:!0},rawRedacted:{type:K,isOptional:!0}}}),Be=new Q({name:"FullEnrichRemoteMcpOutput",fields:{providerKey:{type:w,isOptional:!1},url:{type:w,isOptional:!1},auth:{type:w,isOptional:!1},toolCategories:{type:Pe,isOptional:!1,isArray:!0}}});var _e="sales-intelligence.fullenrich.contact.enrichment.cancel",Te=Jt({meta:{key:_e,version:T,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:k},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:V(_e)},mcp:{toolName:J("contact_enrichment_cancel")}}});import{defineCommand as de,defineQuery as A}from"@lssm/lib.contracts-spec/operations";import{ScalarTypeEnum as H,SchemaModel as X}from"@lssm/lib.schema";var Me=H.JSONObject(),je=H.String_unsecure(),f=H.NonEmptyString(),Y=new X({name:"FullEnrichCorrelationInput",fields:{connectionId:{type:f,isOptional:!1},correlationId:{type:f,isOptional:!0},idempotencyKey:{type:f,isOptional:!0}}}),ae=new X({name:"FullEnrichSearchInput",fields:{connectionId:{type:f,isOptional:!1},query:{type:f,isOptional:!0},filters:{type:Me,isOptional:!0},limit:{type:H.Int_unsecure(),isOptional:!0},correlationId:{type:f,isOptional:!0}}}),ce=new X({name:"FullEnrichLookupInput",fields:{connectionId:{type:f,isOptional:!1},identifier:{type:f,isOptional:!1},identifierType:{type:je,isOptional:!1},correlationId:{type:f,isOptional:!0}}}),le=new X({name:"FullEnrichAsyncStartInput",fields:{connectionId:{type:f,isOptional:!1},request:{type:Me,isOptional:!1},correlationId:{type:f,isOptional:!0},webhookUrl:{type:je,isOptional:!0}}});import{ScalarTypeEnum as j,SchemaModel as Z}from"@lssm/lib.schema";var Ne=j.JSONObject(),pe=j.String_unsecure(),R=j.NonEmptyString(),Le=new Z({name:"FullEnrichCreditOutput",fields:{providerKey:{type:R,isOptional:!1},creditsRemaining:{type:j.Float_unsecure(),isOptional:!0},raw:{type:Ne,isOptional:!0},correlationId:{type:R,isOptional:!0}}}),qe=new Z({name:"FullEnrichValidationOutput",fields:{valid:{type:j.Boolean(),isOptional:!1},providerKey:{type:R,isOptional:!1},message:{type:pe,isOptional:!0}}}),N=new Z({name:"FullEnrichResultListOutput",fields:{providerKey:{type:R,isOptional:!1},items:{type:Ne,isOptional:!1},correlationId:{type:R,isOptional:!0}}}),ue=new Z({name:"FullEnrichAsyncStartOutput",fields:{providerKey:{type:R,isOptional:!1},jobId:{type:R,isOptional:!0},correlationId:{type:R,isOptional:!0},status:{type:pe,isOptional:!1},expectedWebhookPath:{type:pe,isOptional:!0}}});var $t=["@platform.integrations"],y={version:T,owners:$t,tags:["sales-intelligence","fullenrich","pii-safe"],stability:"experimental"},D={effects:["read"]},ee={effects:["write","cost-bearing","external-side-effect"],approval:{required:!0}};function h(e,t,n){return{rest:{method:t,path:V(e)},mcp:{toolName:n??ke(e)}}}var Kt=A({meta:{...y,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:Y,output:Le},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.credits.get","GET")}),zt=A({meta:{...y,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:Y,output:qe},policy:{auth:"admin",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.api-key.validate","GET")}),Qt=A({meta:{...y,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:ae,output:N},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.people.search","POST")}),Ht=A({meta:{...y,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:ae,output:N},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.companies.search","POST")}),Xt=A({meta:{...y,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:ce,output:N},policy:{auth:"user",policies:[]},execution:ee,transport:h("sales-intelligence.fullenrich.people.lookup","POST")}),Yt=A({meta:{...y,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:ce,output:N},policy:{auth:"user",policies:[]},execution:ee,transport:h("sales-intelligence.fullenrich.companies.lookup","POST")}),Zt=de({meta:{...y,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:le,output:ue},policy:{auth:"user",policies:[]},execution:ee,transport:h("sales-intelligence.fullenrich.contact.enrichment.start","POST")}),er=A({meta:{...y,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:k},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.contact.enrichment.result.get","GET",J("contact_result_get"))}),tr=de({meta:{...y,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:le,output:ue},policy:{auth:"user",policies:[]},execution:ee,transport:h("sales-intelligence.fullenrich.reverse-email.start","POST")}),rr=A({meta:{...y,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:k},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.reverse-email.result.get","GET")}),ir=de({meta:{...y,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:Fe,output:k},policy:{auth:"admin",policies:[]},execution:{effects:["external-side-effect"]}}),nr=A({meta:{...y,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:Y,output:Be},policy:{auth:"user",policies:[]},execution:D,transport:h("sales-intelligence.fullenrich.mcp.remote.describe","GET")}),te=[Kt,zt,Qt,Ht,Xt,Yt,Zt,er,Te,tr,rr,ir,nr],ii=Object.fromEntries(te.map((e)=>[e.meta.key,e]));function Ge(e){return te.reduce((t,n)=>t.register(n),e)}import{docRef as br}from"@lssm/lib.contracts-spec/docs";import{defineCommand as vt,defineQuery as At}from"@lssm/lib.contracts-spec/operations";var i=(e,t,n,g=!0)=>({provider:e,suffix:t,title:n,kind:"command",costBearing:g}),s=(e,t,n,g=!1)=>({provider:e,suffix:t,title:n,kind:"query",costBearing:g}),Ue=[i("bright-data","search.execute","Search with Bright Data"),i("bright-data","fetch.execute","Fetch with Bright Data"),i("bright-data","extract.execute","Extract with Bright Data"),i("bright-data","scraper.run","Run Bright Data scraper"),i("bright-data","scraper.trigger","Trigger Bright Data scraper"),s("bright-data","scraper.job.get","Get Bright Data scraper job"),s("bright-data","job.get","Get Bright Data job"),i("bright-data","job.cancel","Cancel Bright Data job",!1),s("bright-data","dataset.get","Get Bright Data dataset"),i("bright-data","crawl.start","Start Bright Data crawl"),s("bright-data","crawl.get","Get Bright Data crawl"),i("bright-data","crawl.cancel","Cancel Bright Data crawl",!1),i("bright-data","browser.session.create","Create Bright Data browser session"),s("bright-data","browser.session.get","Get Bright Data browser session"),i("bright-data","browser.session.close","Close Bright Data browser session",!1),s("bright-data","browser.connection.describe","Describe Bright Data CDP connection"),i("bright-data","proxy.request","Request through Bright Data proxy"),s("bright-data","proxy.describe","Describe Bright Data proxy"),s("bright-data","mcp.describe","Describe Bright Data native MCP"),i("massive","search.execute","Search with Massive"),i("massive","render.execute","Render with Massive"),s("massive","job.get","Get Massive render job"),i("massive","job.cancel","Cancel Massive render job",!1),i("massive","browser.session.create","Create Massive browser session"),s("massive","browser.session.get","Get Massive browser session"),i("massive","browser.session.close","Close Massive browser session",!1),s("massive","browser.connection.describe","Describe Massive CDP connection"),i("massive","proxy.request","Request through Massive proxy"),s("massive","proxy.describe","Describe Massive proxy"),s("massive","usage.get","Get Massive usage"),s("massive","mcp.describe","Describe Massive MCP projection"),i("browserbase","search.execute","Search with Browserbase"),i("browserbase","fetch.execute","Fetch with Browserbase"),i("browserbase","session.create","Create Browserbase session"),s("browserbase","session.get","Get Browserbase session"),i("browserbase","session.close","Close Browserbase session",!1),s("browserbase","connection.describe","Describe Browserbase CDP connection"),i("browserbase","context.create","Create Browserbase context"),s("browserbase","context.get","Get Browserbase context"),i("browserbase","context.delete","Delete Browserbase context",!1),s("browserbase","proxy.describe","Describe Browserbase session proxy"),s("browserbase","mcp.describe","Describe Browserbase native MCP"),...["search","images","news","maps","places","videos","shopping","scholar","patents","autocomplete"].map((e)=>i("serper",`${e}.execute`,`Run Serper ${e}`)),s("serper","mcp.describe","Describe Serper MCP projection"),i("linkup","search.execute","Search with Linkup"),i("linkup","fetch.execute","Fetch with Linkup"),i("linkup","research.start","Start Linkup research"),s("linkup","task.get","Get Linkup task"),i("linkup","task.cancel","Cancel Linkup task",!1),s("linkup","mcp.describe","Describe Linkup native MCP"),i("tavily","search.execute","Search with Tavily"),i("tavily","extract.execute","Extract with Tavily"),i("tavily","map.execute","Map with Tavily"),i("tavily","crawl.execute","Crawl with Tavily"),i("tavily","crawl.start","Start Tavily crawl"),s("tavily","crawl.get","Get Tavily crawl"),i("tavily","crawl.cancel","Cancel Tavily crawl",!1),i("tavily","research.start","Start Tavily research"),s("tavily","research.get","Get Tavily research"),s("tavily","research.stream","Stream Tavily research"),i("tavily","research.cancel","Cancel Tavily research",!1),s("tavily","mcp.describe","Describe Tavily native MCP")],or=[i("direct-fetch","fetch.execute","Fetch a public URL directly",!1),s("direct-fetch","mcp.describe","Describe direct-fetch MCP projection"),s("reworkd","dataset.get","Get Reworkd group outputs"),s("reworkd","mcp.describe","Describe Reworkd MCP projection"),i("firecrawl","search.execute","Search with Firecrawl"),i("firecrawl","fetch.execute","Scrape with Firecrawl"),i("firecrawl","extract.execute","Extract with Firecrawl"),i("firecrawl","map.execute","Map with Firecrawl"),i("firecrawl","crawl.start","Start Firecrawl crawl"),s("firecrawl","crawl.get","Get Firecrawl crawl"),i("firecrawl","crawl.cancel","Cancel Firecrawl crawl",!1),s("firecrawl","mcp.describe","Describe Firecrawl MCP projection"),i("apify","scraper.run","Run Apify Actor"),s("apify","job.get","Get Apify Actor run"),i("apify","job.cancel","Abort Apify Actor run",!1),s("apify","dataset.get","Get Apify dataset items"),s("apify","mcp.describe","Describe Apify MCP projection"),i("oxylabs","search.execute","Search with Oxylabs"),i("oxylabs","fetch.execute","Fetch with Oxylabs"),i("oxylabs","proxy.request","Request through Oxylabs proxy"),s("oxylabs","proxy.describe","Describe Oxylabs proxy"),s("oxylabs","mcp.describe","Describe Oxylabs MCP projection")],sr=[i("browserbase","browser.act","Act on a browser page"),s("browserbase","browser.observe","Observe actionable browser elements",!0),s("browserbase","browser.extract","Extract structured browser page data",!0)],ar=new Set(["bright-data:scraper.trigger","bright-data:scraper.job.get","bright-data:crawl.start","bright-data:crawl.get","bright-data:crawl.cancel","tavily:crawl.execute"]),ye=Ue.filter((e)=>!ar.has(`${e.provider}:${e.suffix}`)),yi=ye,me=Ue,fe=[...me,...or],Ve=[...fe,...sr];function Je(e){return`web-access.${e.provider}.${e.suffix}`}var he={policyDenied:{code:"WEB_ACCESS_POLICY_DENIED",http:403,description:"Authorization, evidence, or network policy denied execution."},authFailed:{code:"WEB_ACCESS_AUTH_FAILED",http:401,description:"The provider rejected the configured credential."},quotaExceeded:{code:"WEB_ACCESS_QUOTA_EXCEEDED",http:429,description:"The atomic request or monetary budget was exhausted."},rateLimited:{code:"WEB_ACCESS_RATE_LIMITED",http:429,retryable:!0,description:"Provider or local concurrency limits were reached."},timedOut:{code:"WEB_ACCESS_TIMEOUT",http:504,retryable:!0,description:"The bounded execution deadline elapsed."},unsupported:{code:"WEB_ACCESS_UNSUPPORTED",http:422,description:"The provider does not expose the requested native behavior."},cancelled:{code:"WEB_ACCESS_CANCELLED",http:499,description:"Execution was cancelled before provider completion."},notFound:{code:"WEB_ACCESS_NOT_FOUND",http:404,description:"The requested provider resource was not found."},providerUnavailable:{code:"WEB_ACCESS_PROVIDER_UNAVAILABLE",http:503,retryable:!0,description:"The provider is temporarily unavailable."},providerError:{code:"WEB_ACCESS_PROVIDER_ERROR",http:502,description:"The provider returned an unclassified failure."}},fi=Object.values(he).map((e)=>e.code);import{ScalarTypeEnum as m,SchemaModel as q}from"@lssm/lib.schema";import{ScalarTypeEnum as F,SchemaModel as C}from"@lssm/lib.schema";var bi=["browser.act","browser.observe","browser.extract"],Oe=F.String_unsecure(),P=F.NonEmptyString(),be={sessionId:{type:P,isOptional:!1},pageId:{type:Oe,isOptional:!0}},$e=new C({name:"WebAccessBrowserActPayload",fields:{...be,instruction:{type:P,isOptional:!1},elementRef:{type:Oe,isOptional:!0},variables:{type:F.JSONObject(),isOptional:!0}}}),Ke=new C({name:"WebAccessBrowserObservePayload",fields:{...be,instruction:{type:Oe,isOptional:!0}}}),ze=new C({name:"WebAccessBrowserExtractPayload",fields:{...be,instruction:{type:P,isOptional:!1},resultSchema:{type:F.JSONObject(),isOptional:!0}}}),Qe=new C({name:"WebAccessBrowserActDataRecord",fields:{action:{type:P,isOptional:!1},performed:{type:F.Boolean(),isOptional:!1}}}),cr=new C({name:"WebAccessBrowserActionCandidateRecord",fields:{description:{type:P,isOptional:!1},elementRef:{type:P,isOptional:!1}}}),He=new C({name:"WebAccessBrowserObserveDataRecord",fields:{candidates:{type:cr,isOptional:!1,isArray:!0}}}),Xe=new C({name:"WebAccessBrowserExtractDataRecord",fields:{value:{type:F.JSONObject(),isOptional:!1}}});import{ScalarTypeEnum as b,SchemaModel as _}from"@lssm/lib.schema";import{ScalarTypeEnum as p,SchemaModel as c}from"@lssm/lib.schema";var o=p.String_unsecure(),l=p.NonEmptyString(),O=p.Int_unsecure(),lr=p.Float_unsecure(),E=p.Boolean(),x=p.URL(),Ye=new c({name:"WebAccessAuthorizationRecord",fields:{decision:{type:l,isOptional:!1},evidenceRefs:{type:l,isOptional:!1,isArray:!0},expiresAt:{type:p.DateTime(),isOptional:!0}}}),Ze=new c({name:"WebAccessBudgetRecord",fields:{currency:{type:p.Currency(),isOptional:!0},maximumAmountMinor:{type:O,isOptional:!0},maximumRequests:{type:O,isOptional:!0},estimatedAmountMinor:{type:O,isOptional:!0}}}),et=new c({name:"WebAccessSearchPayload",fields:{query:{type:l,isOptional:!1},limit:{type:O,isOptional:!0},page:{type:O,isOptional:!0},language:{type:o,isOptional:!0},country:{type:o,isOptional:!0},category:{type:o,isOptional:!0},mode:{type:o,isOptional:!0},callback:{type:x,isOptional:!0},includeDomains:{type:l,isOptional:!0,isArray:!0},excludeDomains:{type:l,isOptional:!0,isArray:!0},transport:{type:o,isOptional:!0},useX402:{type:E,isOptional:!0}}}),tt=new c({name:"WebAccessFetchPayload",fields:{url:{type:x,isOptional:!1},format:{type:o,isOptional:!0},headers:{type:p.JSONObject(),isOptional:!0},renderJs:{type:E,isOptional:!0},includeRawContent:{type:E,isOptional:!0},extractImages:{type:E,isOptional:!0},country:{type:o,isOptional:!0},city:{type:o,isOptional:!0},mode:{type:o,isOptional:!0},callback:{type:x,isOptional:!0},transport:{type:o,isOptional:!0},useX402:{type:E,isOptional:!0}}}),rt=new c({name:"WebAccessExtractPayload",fields:{urls:{type:x,isOptional:!1,isArray:!0},query:{type:o,isOptional:!0},format:{type:o,isOptional:!0},includeImages:{type:E,isOptional:!0},transport:{type:o,isOptional:!0}}}),it=new c({name:"WebAccessCrawlPayload",fields:{url:{type:x,isOptional:!0},urls:{type:x,isOptional:!0,isArray:!0},instructions:{type:o,isOptional:!0},limit:{type:O,isOptional:!0},maxDepth:{type:O,isOptional:!0},allowExternal:{type:E,isOptional:!0},format:{type:o,isOptional:!0},transport:{type:o,isOptional:!0}}}),nt=new c({name:"WebAccessResearchPayload",fields:{query:{type:l,isOptional:!1},model:{type:o,isOptional:!0},mode:{type:o,isOptional:!0},reasoningDepth:{type:o,isOptional:!0},maxEvents:{type:O,isOptional:!0},includeDomains:{type:l,isOptional:!0,isArray:!0},excludeDomains:{type:l,isOptional:!0,isArray:!0},transport:{type:o,isOptional:!0},useX402:{type:E,isOptional:!0}}}),ot=new c({name:"WebAccessScraperPayload",fields:{collector:{type:l,isOptional:!1},input:{type:p.JSONObject(),isOptional:!0},transport:{type:o,isOptional:!0}}}),st=new c({name:"WebAccessDatasetPayload",fields:{datasetId:{type:l,isOptional:!1},limit:{type:O,isOptional:!0},cursor:{type:O,isOptional:!0},createdAfter:{type:p.DateTime(),isOptional:!0},jobId:{type:o,isOptional:!0},url:{type:x,isOptional:!0},transport:{type:o,isOptional:!0}}}),pr=new c({name:"WebAccessBrowserProxyPayload",fields:{mode:{type:l,isOptional:!1},country:{type:o,isOptional:!0},region:{type:o,isOptional:!0},city:{type:o,isOptional:!0},secretReference:{type:o,isOptional:!0}}}),at=new c({name:"WebAccessBrowserCreatePayload",fields:{projectId:{type:o,isOptional:!0},contextId:{type:o,isOptional:!0},timeoutSeconds:{type:O,isOptional:!0},keepAlive:{type:E,isOptional:!0},country:{type:o,isOptional:!0},proxy:{type:pr,isOptional:!0},transport:{type:o,isOptional:!0}}}),ct=new c({name:"WebAccessProxyPayload",fields:{url:{type:x,isOptional:!1},method:{type:o,isOptional:!0},headers:{type:p.JSONObject(),isOptional:!0},body:{type:o,isOptional:!0},protocol:{type:o,isOptional:!0},country:{type:o,isOptional:!0},region:{type:o,isOptional:!0},city:{type:o,isOptional:!0},stickySessionId:{type:o,isOptional:!0}}}),lt=new c({name:"WebAccessUsagePayload",fields:{start:{type:p.DateTime(),isOptional:!0},end:{type:p.DateTime(),isOptional:!0}}}),pt=new c({name:"WebAccessEmptyPayload",fields:{}}),L=new c({name:"WebAccessSourceRecord",fields:{url:{type:x,isOptional:!1},title:{type:o,isOptional:!0},snippet:{type:o,isOptional:!0},publishedAt:{type:p.DateTime(),isOptional:!0},score:{type:lr,isOptional:!0}}}),ut=new c({name:"NativeMcpDescriptorRecord",fields:{provider:{type:l,isOptional:!1},transport:{type:l,isOptional:!1},endpoint:{type:x,isOptional:!0},command:{type:o,isOptional:!0},args:{type:o,isOptional:!0,isArray:!0},auth:{type:l,isOptional:!1},toolPrefix:{type:l,isOptional:!1}}});var d=b.String_unsecure(),B=b.NonEmptyString(),dt=new _({name:"WebAccessSearchDataRecord",fields:{query:{type:d,isOptional:!0},answer:{type:d,isOptional:!0},results:{type:L,isOptional:!0,isArray:!0}}}),yt=new _({name:"WebAccessContentDataRecord",fields:{url:{type:b.URL(),isOptional:!0},title:{type:d,isOptional:!0},content:{type:d,isOptional:!0},answer:{type:d,isOptional:!0},results:{type:L,isOptional:!0,isArray:!0}}}),mt=new _({name:"WebAccessJobDataRecord",fields:{provider:{type:B,isOptional:!0},jobId:{type:B,isOptional:!0},kind:{type:d,isOptional:!0},status:{type:d,isOptional:!0}}}),ft=new _({name:"WebAccessBrowserDataRecord",fields:{provider:{type:B,isOptional:!0},sessionId:{type:B,isOptional:!0},contextId:{type:B,isOptional:!0},status:{type:d,isOptional:!0},protocol:{type:d,isOptional:!0},connectHandle:{type:B,isOptional:!0},expiresAt:{type:b.DateTime(),isOptional:!0}}}),ht=new _({name:"WebAccessProxyDataRecord",fields:{status:{type:b.Int_unsecure(),isOptional:!0},finalUrl:{type:b.URL(),isOptional:!0},host:{type:d,isOptional:!0},remoteDns:{type:b.Boolean(),isOptional:!0},geoTargeting:{type:b.Boolean(),isOptional:!0},stickySessions:{type:b.Boolean(),isOptional:!0}}}),Ot=new _({name:"WebAccessResourceDataRecord",fields:{id:{type:d,isOptional:!0},name:{type:d,isOptional:!0},status:{type:d,isOptional:!0},credits:{type:b.Float_unsecure(),isOptional:!0},requestCount:{type:b.Int_unsecure(),isOptional:!0}}});var S=m.NonEmptyString();function bt(e){let t=Or(e),n=mr(e,t),g=e.suffix==="mcp.describe",G=g?ut:yr(e);return{input:ur(`${t}Input`,n),output:dr(`${t}Output`,G,g)}}function ur(e,t){return new q({name:e,fields:{provider:{type:S,isOptional:!1},tenantId:{type:m.ID(),isOptional:!1},workspaceId:{type:m.ID(),isOptional:!0},connectionId:{type:m.ID(),isOptional:!1},correlationId:{type:S,isOptional:!1},policyMode:{type:S,isOptional:!1},authorization:{type:Ye,isOptional:!0},budget:{type:Ze,isOptional:!0},payload:{type:t,isOptional:!1}}})}function dr(e,t,n){return new q({name:e,fields:{status:{type:S,isOptional:!1},data:n?{type:t,isOptional:!0,isArray:!0}:{type:t,isOptional:!0},sources:{type:L,isOptional:!1,isArray:!0},usage:{type:fr(e),isOptional:!0},provenance:{type:hr(e),isOptional:!1}}})}function yr(e){let t=e.suffix;if(t==="browser.act")return Qe;if(t==="browser.observe")return He;if(t==="browser.extract")return Xe;if(t.startsWith("proxy."))return ht;if(t.includes("session.")||t.startsWith("context.")||t.includes("connection.describe"))return ft;if(t==="dataset.get"||t==="usage.get")return Ot;if(gt(t)||t.endsWith(".trigger"))return mt;if(t==="fetch.execute"||t==="extract.execute"||t==="render.execute"||t.startsWith("scraper.")||t.startsWith("crawl.")||t.startsWith("research.")||t==="map.execute")return yt;return dt}function mr(e,t){let n=e.suffix;if(n==="browser.act")return $e;if(n==="browser.observe")return Ke;if(n==="browser.extract")return ze;if(n==="mcp.describe"||n==="proxy.describe")return pt;if(n==="usage.get")return lt;if(n==="proxy.request")return ct;if(n.includes("session.create")||n==="context.create")return at;if(n.includes("session.")||n==="connection.describe")return ge(t,"sessionId");if(n.startsWith("context."))return ge(t,"contextId");if(n==="dataset.get")return st;if(n.startsWith("scraper.")&&!n.includes(".job."))return ot;if(gt(n))return ge(t,e.provider==="linkup"?"taskId":"jobId");if(n==="research.stream"||n==="research.start")return nt;if(n==="map.execute"||n.startsWith("crawl."))return it;if(n==="extract.execute")return rt;if(n==="fetch.execute"||n==="render.execute")return tt;return et}function ge(e,t){return new q({name:`${e}Payload`,fields:{[t]:{type:S,isOptional:!1},kind:{type:m.String_unsecure(),isOptional:!0},transport:{type:m.String_unsecure(),isOptional:!0}}})}function fr(e){return new q({name:`${e}Usage`,fields:{requestCount:{type:m.Int_unsecure(),isOptional:!0},credits:{type:m.Float_unsecure(),isOptional:!0},costAmountMinor:{type:m.Int_unsecure(),isOptional:!0},currency:{type:m.Currency(),isOptional:!0},providerReported:{type:m.Boolean(),isOptional:!1}}})}function hr(e){return new q({name:`${e}Provenance`,fields:{provider:{type:S,isOptional:!1},providerRequestId:{type:S,isOptional:!0},retrievedAt:{type:m.DateTime(),isOptional:!1},transport:{type:S,isOptional:!1},policyMode:{type:S,isOptional:!1}}})}function gt(e){return e.endsWith(".get")||e.endsWith(".cancel")||e==="scraper.job.get"}function Or(e){return`${e.provider}-${e.suffix}`.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((t)=>`${t[0]?.toUpperCase()}${t.slice(1)}`).join("")}import{ScalarTypeEnum as a,SchemaModel as re}from"@lssm/lib.schema";var v=a.NonEmptyString(),wt=new re({name:"WebAccessOperationInput",fields:{provider:{type:v,isOptional:!1},tenantId:{type:a.ID(),isOptional:!1},workspaceId:{type:a.ID(),isOptional:!0},connectionId:{type:a.ID(),isOptional:!1},correlationId:{type:v,isOptional:!1},policyMode:{type:v,isOptional:!1},authorization:{type:a.JSONObject(),isOptional:!0},budget:{type:a.JSONObject(),isOptional:!0},payload:{type:a.JSONObject(),isOptional:!1}}}),xt=new re({name:"WebAccessOperationOutput",fields:{status:{type:v,isOptional:!1},data:{type:a.JSONObject(),isOptional:!0},sources:{type:a.JSONObject(),isOptional:!1,isArray:!0},usage:{type:a.JSONObject(),isOptional:!0},provenance:{type:a.JSONObject(),isOptional:!1},rawRedacted:{type:a.JSONObject(),isOptional:!0}}}),ki=new re({name:"BrightDataDeliveryPayload",fields:{connectionId:{type:a.ID(),isOptional:!1},deliveryId:{type:v,isOptional:!1},jobId:{type:v,isOptional:!0},receivedAt:{type:a.DateTime(),isOptional:!1},contentEncoding:{type:v,isOptional:!0},payload:{type:a.JSONObject(),isOptional:!1}}}),Pi=new re({name:"MassiveDeliveryPayload",fields:{connectionId:{type:a.ID(),isOptional:!1},deliveryId:{type:v,isOptional:!1},jobId:{type:v,isOptional:!0},kind:{type:v,isOptional:!1},receivedAt:{type:a.DateTime(),isOptional:!1},payload:{type:a.JSONObject(),isOptional:!1}}});var gr={id:"docs.integrations.web-access-operations",title:"Governed web-access provider operations",summary:"Normalized scraping, research, browser automation, MCP, callback, streaming, and residential-proxy contracts for eleven providers.",kind:"reference",visibility:"public",route:"/docs/integrations/web-access",tags:["integrations","scraping","research","browser","proxy","mcp"],body:`# Governed web-access provider operations
+
+The web-access contract normalizes Bright Data, Massive, Browserbase, Serper,
+Linkup, Tavily, direct fetch, Reworkd, Firecrawl, Apify, and Oxylabs without
+inventing vendor-native transports. Provider-neutral browser act, observe, and
+structured extract contracts form the Stagehand v4 compatibility profile. The
+capability ledger reports that profile as supported by the separately owned
+Browserbase Stagehand adapter and executable adapter/tool tests. Every operation has a
+concrete payload family, normalized result/provenance, and typed failure catalog.
+The original generic 1.0 envelopes remain exported unchanged for pinned consumers.
+
+Governed execution fails closed unless an unexpired allow decision carries at
+least one evidence reference. Configured request or monetary budgets require an
+atomic budget port. Secrets remain behind SecretProvider references; MCP and CDP
+connectors accept only immutable provider manifests; proxy and fetch targets are
+subject to SSRF and redirect validation.
+
+Legacy operation keys remain callable for compatibility. Where a provider does
+not expose the formerly declared cancellation or polling behavior, execution
+returns WEB_ACCESS_UNSUPPORTED instead of emulating a native surface.
+`};function ie(e,t,n){let g=Je(e),G=bt(e),Pt=t.replaceAll(".","_"),Ft=e.kind==="query"?e.costBearing?["read","cost-bearing"]:["read"]:e.costBearing?["read","cost-bearing","external-side-effect"]:["write","external-side-effect"],Ae={meta:{key:g,version:t,title:e.title,description:`${e.title} through the governed web-access provider port.`,goal:e.title,context:"Network and secret safety are mandatory in every policy mode; provider availability remains connection and account dependent.",owners:["@platform.integrations"],tags:["integration","web-access",e.provider],stability:"experimental",docId:[br(gr.id)]},policy:{auth:"user",policies:[{key:"platform.web-access.execute",version:t}],idempotent:e.kind==="query",escalate:null},execution:{effects:Ft},economicEvidence:e.costBearing?{required:!0,modelVersion:"provider-reported-v1",refs:[{id:`usage:${e.provider}:${e.suffix}`,kind:"usage",source:"@lssm/integration.provider-web-access"}]}:void 0,transport:{rest:{method:e.kind==="query"?"GET":"POST",path:`/api/contracts/${g}/v${t}`},mcp:{toolName:`${g.replaceAll(".","_")}-v${Pt}`}}};if(n){let Se={...Ae,io:{input:G.input,output:G.output,errors:he}};return e.kind==="command"?vt(Se):At(Se)}let Ee={...Ae,io:{input:wt,output:xt}};return e.kind==="command"?vt(Ee):At(Ee)}var Et=ye.map((e)=>ie(e,"1.0.0",!1)),we=me.map((e)=>ie(e,"1.1.0",!0)),wr=fe.map((e)=>ie(e,"1.2.0",!0)),St=Ve.map((e)=>ie(e,"1.3.0",!0)),xe=Et,Li=St,xr=[...Et,...we,...wr,...St];function It(e){return xr.reduce((t,n)=>t.register(n),e)}var ve=new I({name:"IntegrationConnectionRecord",fields:{id:{type:r.ID(),isOptional:!1},tenantId:{type:r.ID(),isOptional:!1},integrationKey:{type:r.NonEmptyString(),isOptional:!1},integrationVersion:{type:r.Int_unsecure(),isOptional:!1},label:{type:r.String_unsecure(),isOptional:!1},ownershipMode:{type:r.String_unsecure(),isOptional:!1},externalAccountId:{type:r.String_unsecure(),isOptional:!0},secretProvider:{type:r.String_unsecure(),isOptional:!1},secretRef:{type:r.String_unsecure(),isOptional:!1},status:{type:r.String_unsecure(),isOptional:!1},environment:{type:r.String_unsecure(),isOptional:!0},healthStatus:{type:r.String_unsecure(),isOptional:!0},healthCheckedAt:{type:r.DateTime(),isOptional:!0},healthLatencyMs:{type:r.Float_unsecure(),isOptional:!0},healthErrorCode:{type:r.String_unsecure(),isOptional:!0},healthErrorMessage:{type:r.String_unsecure(),isOptional:!0},usageRequestCount:{type:r.Int_unsecure(),isOptional:!0},usageSuccessCount:{type:r.Int_unsecure(),isOptional:!0},usageErrorCount:{type:r.Int_unsecure(),isOptional:!0},usageLastUsedAt:{type:r.DateTime(),isOptional:!0},usageLastErrorAt:{type:r.DateTime(),isOptional:!0},usageLastErrorCode:{type:r.String_unsecure(),isOptional:!0},createdAt:{type:r.DateTime(),isOptional:!0},updatedAt:{type:r.DateTime(),isOptional:!0}}}),Ar=new I({name:"CreateIntegrationConnectionInput",fields:{tenantId:{type:r.ID(),isOptional:!1},integrationKey:{type:r.NonEmptyString(),isOptional:!1},integrationVersion:{type:r.Int_unsecure(),isOptional:!1},label:{type:r.String_unsecure(),isOptional:!1},ownershipMode:{type:r.String_unsecure(),isOptional:!1},externalAccountId:{type:r.String_unsecure(),isOptional:!0},secretProvider:{type:r.String_unsecure(),isOptional:!1},secretRef:{type:r.String_unsecure(),isOptional:!1},environment:{type:r.String_unsecure(),isOptional:!0},config:{type:r.JSONObject(),isOptional:!1}}}),Er=new I({name:"UpdateIntegrationConnectionInput",fields:{connectionId:{type:r.ID(),isOptional:!1},label:{type:r.String_unsecure(),isOptional:!0},status:{type:r.String_unsecure(),isOptional:!0},ownershipMode:{type:r.String_unsecure(),isOptional:!0},externalAccountId:{type:r.String_unsecure(),isOptional:!0},secretProvider:{type:r.String_unsecure(),isOptional:!0},secretRef:{type:r.String_unsecure(),isOptional:!0},config:{type:r.JSONObject(),isOptional:!0}}}),Sr=new I({name:"DeleteIntegrationConnectionInput",fields:{connectionId:{type:r.ID(),isOptional:!1}}}),Ir=new I({name:"ListIntegrationConnectionsInput",fields:{tenantId:{type:r.ID(),isOptional:!1},category:{type:r.String_unsecure(),isOptional:!0},status:{type:r.String_unsecure(),isOptional:!0}}}),Rr=new I({name:"ListIntegrationConnectionsOutput",fields:{connections:{type:ve,isOptional:!1,isArray:!0}}}),Dr=new I({name:"TestIntegrationConnectionInput",fields:{connectionId:{type:r.ID(),isOptional:!1}}}),Cr=new I({name:"TestIntegrationConnectionOutput",fields:{success:{type:r.Boolean(),isOptional:!1},status:{type:r.String_unsecure(),isOptional:!0},latencyMs:{type:r.Float_unsecure(),isOptional:!0},error:{type:r.String_unsecure(),isOptional:!0},errorCode:{type:r.String_unsecure(),isOptional:!0}}}),Wr=new I({name:"DeleteIntegrationConnectionOutput",fields:{success:{type:r.Boolean(),isOptional:!1}}}),Rt=ne({meta:{key:"integrations.connection.create",title:"Create Integration Connection",version:"1.0.0",description:"Create a new integration connection for a tenant.",goal:"Provision a tenant-scoped connection to an external provider.",context:"Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.",owners:["@platform.integrations"],tags:["integration","connections"],stability:"experimental"},io:{input:Ar,output:ve},policy:{auth:"admin",policies:[{key:"platform.integration.manage",version:"1.0.0"}]}}),Dt=ne({meta:{key:"integrations.connection.update",title:"Update Integration Connection",version:"1.0.0",description:"Update metadata or credentials for an integration connection.",goal:"Allow secure rotation of credentials and metadata adjustments.",context:"Supports rotating API keys, toggling status, or updating labels for tenant integrations.",owners:["@platform.integrations"],tags:["integration","connections"],stability:"experimental"},io:{input:Er,output:ve},policy:{auth:"admin",policies:[{key:"platform.integration.manage",version:"1.0.0"}]}}),Ct=ne({meta:{key:"integrations.connection.delete",title:"Delete Integration Connection",version:"1.0.0",description:"Delete an integration connection for a tenant.",goal:"Safely remove credentials and disable connector usage.",context:"Ensures connections are de-provisioned when no longer needed or breached.",owners:["@platform.integrations"],tags:["integration","connections"],stability:"experimental"},io:{input:Sr,output:Wr},policy:{auth:"admin",policies:[{key:"platform.integration.manage",version:"1.0.0"}]}}),Wt=vr({meta:{key:"integrations.connection.list",title:"List Integration Connections",version:"1.0.0",description:"List integration connections for a tenant.",goal:"Provide visibility into configured integrations and their status.",context:"Used by the App Studio and Ops flows to show bindings and health.",owners:["@platform.integrations"],tags:["integration","connections"],stability:"experimental"},io:{input:Ir,output:Rr},policy:{auth:"admin",policies:[{key:"platform.integration.read",version:"1.0.0"}]}}),kt=ne({meta:{key:"integrations.connection.test",title:"Test Integration Connection",version:"1.0.0",description:"Run a health check against a configured integration connection.",goal:"Validate credentials and connectivity for external providers.",context:"Triggered manually or by background monitors to confirm provider availability.",owners:["@platform.integrations"],tags:["integration","connections"],stability:"experimental"},io:{input:Dr,output:Cr},policy:{auth:"admin",policies:[{key:"platform.integration.manage",version:"1.0.0"}]}}),Ki={CreateIntegrationConnection:Rt,UpdateIntegrationConnection:Dt,DeleteIntegrationConnection:Ct,ListIntegrationConnections:Wt,TestIntegrationConnection:kt,...Object.fromEntries(oe.map((e)=>[e.meta.key,e])),...Object.fromEntries(te.map((e)=>[e.meta.key,e])),...Object.fromEntries(xe.map((e)=>[e.meta.key,e])),...Object.fromEntries(we.filter((e)=>!xe.some((t)=>t.meta.key===e.meta.key)).map((e)=>[e.meta.key,e]))};function zi(e){let t=e.register(Rt).register(Dt).register(Ct).register(Wt).register(kt);for(let n of oe)t.register(n);return Ge(It(t))}export{Rt as CreateIntegrationConnection,Ct as DeleteIntegrationConnection,Wt as ListIntegrationConnections,kt as TestIntegrationConnection,Dt as UpdateIntegrationConnection,Ki as integrationContracts,zi as registerIntegrationContracts};

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

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

package/dist/integrations/providers/analytics-reader.d.ts

@@ -0,0 +1,103 @@
+import type { AnalyticsQueryInput, AnalyticsQueryResult } from './analytics.js';
+export type AnalyticsPropertyFilter = Record<string, string | number | boolean | null>;
+export interface DateRangeInput {
+    from?: string | Date;
+    to?: string | Date;
+    timezone?: string;
+}
+export interface PaginationInput {
+    limit?: number;
+    offset?: number;
+}
+export interface GetEventsInput extends PaginationInput {
+    projectId?: string | number;
+    event?: string;
+    events?: string[];
+    distinctId?: string;
+    properties?: AnalyticsPropertyFilter;
+    dateRange?: DateRangeInput;
+    orderBy?: 'timestamp' | '-timestamp';
+}
+export interface GetPersonsInput extends PaginationInput {
+    projectId?: string | number;
+    cohortId?: string | number;
+    properties?: AnalyticsPropertyFilter;
+    search?: string;
+}
+export type AnalyticsInsightType = 'TRENDS' | 'FUNNELS' | 'RETENTION' | 'PATHS' | 'STICKINESS' | 'LIFECYCLE' | 'SESSIONS' | 'CUSTOM';
+export interface GetInsightsInput extends PaginationInput {
+    projectId?: string | number;
+    insightType?: AnalyticsInsightType;
+}
+export interface GetInsightResultInput {
+    projectId?: string | number;
+    insightId: string | number;
+}
+export interface GetCohortsInput extends PaginationInput {
+    projectId?: string | number;
+}
+export interface GetFeatureFlagsInput extends PaginationInput {
+    projectId?: string | number;
+    active?: boolean;
+}
+export interface GetAnnotationsInput extends PaginationInput {
+    projectId?: string | number;
+    dateRange?: DateRangeInput;
+}
+export interface AnalyticsEvent {
+    id?: string | number;
+    event: string;
+    distinctId: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+export interface AnalyticsPerson {
+    id?: string | number;
+    distinctId?: string;
+    properties?: Record<string, unknown>;
+    createdAt?: string;
+}
+export interface AnalyticsInsight {
+    id?: string | number;
+    name?: string;
+    type?: AnalyticsInsightType | string;
+    filters?: Record<string, unknown>;
+    result?: unknown;
+}
+export interface AnalyticsCohort {
+    id?: string | number;
+    name?: string;
+    groups?: unknown;
+    count?: number;
+}
+export interface AnalyticsFeatureFlag {
+    id?: string | number;
+    key?: string;
+    name?: string;
+    active?: boolean;
+    filters?: Record<string, unknown>;
+    rolloutPercentage?: number;
+}
+export interface AnalyticsAnnotation {
+    id?: string | number;
+    content?: string;
+    dateMarker?: string;
+    scope?: string;
+    createdAt?: string;
+}
+export interface PaginatedResponse<T> {
+    count: number;
+    next?: string | null;
+    previous?: string | null;
+    results: T[];
+}
+export interface AnalyticsReader {
+    queryHogQL?(input: AnalyticsQueryInput): Promise<AnalyticsQueryResult>;
+    getEvents?(input: GetEventsInput): Promise<PaginatedResponse<AnalyticsEvent>>;
+    getPersons?(input: GetPersonsInput): Promise<PaginatedResponse<AnalyticsPerson>>;
+    getInsights?(input: GetInsightsInput): Promise<PaginatedResponse<AnalyticsInsight>>;
+    getInsightResult?(input: GetInsightResultInput): Promise<AnalyticsInsight>;
+    getCohorts?(input: GetCohortsInput): Promise<PaginatedResponse<AnalyticsCohort>>;
+    getFeatureFlags?(input: GetFeatureFlagsInput): Promise<PaginatedResponse<AnalyticsFeatureFlag>>;
+    getAnnotations?(input: GetAnnotationsInput): Promise<PaginatedResponse<AnalyticsAnnotation>>;
+}

package/dist/integrations/providers/analytics-reader.js

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

package/dist/integrations/providers/analytics-writer.d.ts

@@ -0,0 +1,6 @@
+import type { AnalyticsEventInput, AnalyticsIdentifyInput, AnalyticsMcpToolCall } from './analytics.js';
+export interface AnalyticsWriter {
+    capture(event: AnalyticsEventInput): Promise<void>;
+    identify?(input: AnalyticsIdentifyInput): Promise<void>;
+    callMcpTool?(call: AnalyticsMcpToolCall): Promise<unknown>;
+}