@lssm/lib.contracts-integrations 9.0.1

package/dist/integrations/web-access/operations.js

@@ -0,0 +1,22 @@
+// @bun
+import{docRef as qe}from"@lssm/lib.contracts-spec/docs";import{defineCommand as Ae,defineQuery as he}from"@lssm/lib.contracts-spec/operations";var t=(e,r,o,b=!0)=>({provider:e,suffix:r,title:o,kind:"command",costBearing:b}),a=(e,r,o,b=!1)=>({provider:e,suffix:r,title:o,kind:"query",costBearing:b}),N=[t("bright-data","search.execute","Search with Bright Data"),t("bright-data","fetch.execute","Fetch with Bright Data"),t("bright-data","extract.execute","Extract with Bright Data"),t("bright-data","scraper.run","Run Bright Data scraper"),t("bright-data","scraper.trigger","Trigger Bright Data scraper"),a("bright-data","scraper.job.get","Get Bright Data scraper job"),a("bright-data","job.get","Get Bright Data job"),t("bright-data","job.cancel","Cancel Bright Data job",!1),a("bright-data","dataset.get","Get Bright Data dataset"),t("bright-data","crawl.start","Start Bright Data crawl"),a("bright-data","crawl.get","Get Bright Data crawl"),t("bright-data","crawl.cancel","Cancel Bright Data crawl",!1),t("bright-data","browser.session.create","Create Bright Data browser session"),a("bright-data","browser.session.get","Get Bright Data browser session"),t("bright-data","browser.session.close","Close Bright Data browser session",!1),a("bright-data","browser.connection.describe","Describe Bright Data CDP connection"),t("bright-data","proxy.request","Request through Bright Data proxy"),a("bright-data","proxy.describe","Describe Bright Data proxy"),a("bright-data","mcp.describe","Describe Bright Data native MCP"),t("massive","search.execute","Search with Massive"),t("massive","render.execute","Render with Massive"),a("massive","job.get","Get Massive render job"),t("massive","job.cancel","Cancel Massive render job",!1),t("massive","browser.session.create","Create Massive browser session"),a("massive","browser.session.get","Get Massive browser session"),t("massive","browser.session.close","Close Massive browser session",!1),a("massive","browser.connection.describe","Describe Massive CDP connection"),t("massive","proxy.request","Request through Massive proxy"),a("massive","proxy.describe","Describe Massive proxy"),a("massive","usage.get","Get Massive usage"),a("massive","mcp.describe","Describe Massive MCP projection"),t("browserbase","search.execute","Search with Browserbase"),t("browserbase","fetch.execute","Fetch with Browserbase"),t("browserbase","session.create","Create Browserbase session"),a("browserbase","session.get","Get Browserbase session"),t("browserbase","session.close","Close Browserbase session",!1),a("browserbase","connection.describe","Describe Browserbase CDP connection"),t("browserbase","context.create","Create Browserbase context"),a("browserbase","context.get","Get Browserbase context"),t("browserbase","context.delete","Delete Browserbase context",!1),a("browserbase","proxy.describe","Describe Browserbase session proxy"),a("browserbase","mcp.describe","Describe Browserbase native MCP"),...["search","images","news","maps","places","videos","shopping","scholar","patents","autocomplete"].map((e)=>t("serper",`${e}.execute`,`Run Serper ${e}`)),a("serper","mcp.describe","Describe Serper MCP projection"),t("linkup","search.execute","Search with Linkup"),t("linkup","fetch.execute","Fetch with Linkup"),t("linkup","research.start","Start Linkup research"),a("linkup","task.get","Get Linkup task"),t("linkup","task.cancel","Cancel Linkup task",!1),a("linkup","mcp.describe","Describe Linkup native MCP"),t("tavily","search.execute","Search with Tavily"),t("tavily","extract.execute","Extract with Tavily"),t("tavily","map.execute","Map with Tavily"),t("tavily","crawl.execute","Crawl with Tavily"),t("tavily","crawl.start","Start Tavily crawl"),a("tavily","crawl.get","Get Tavily crawl"),t("tavily","crawl.cancel","Cancel Tavily crawl",!1),t("tavily","research.start","Start Tavily research"),a("tavily","research.get","Get Tavily research"),a("tavily","research.stream","Stream Tavily research"),t("tavily","research.cancel","Cancel Tavily research",!1),a("tavily","mcp.describe","Describe Tavily native MCP")],We=[t("direct-fetch","fetch.execute","Fetch a public URL directly",!1),a("direct-fetch","mcp.describe","Describe direct-fetch MCP projection"),a("reworkd","dataset.get","Get Reworkd group outputs"),a("reworkd","mcp.describe","Describe Reworkd MCP projection"),t("firecrawl","search.execute","Search with Firecrawl"),t("firecrawl","fetch.execute","Scrape with Firecrawl"),t("firecrawl","extract.execute","Extract with Firecrawl"),t("firecrawl","map.execute","Map with Firecrawl"),t("firecrawl","crawl.start","Start Firecrawl crawl"),a("firecrawl","crawl.get","Get Firecrawl crawl"),t("firecrawl","crawl.cancel","Cancel Firecrawl crawl",!1),a("firecrawl","mcp.describe","Describe Firecrawl MCP projection"),t("apify","scraper.run","Run Apify Actor"),a("apify","job.get","Get Apify Actor run"),t("apify","job.cancel","Abort Apify Actor run",!1),a("apify","dataset.get","Get Apify dataset items"),a("apify","mcp.describe","Describe Apify MCP projection"),t("oxylabs","search.execute","Search with Oxylabs"),t("oxylabs","fetch.execute","Fetch with Oxylabs"),t("oxylabs","proxy.request","Request through Oxylabs proxy"),a("oxylabs","proxy.describe","Describe Oxylabs proxy"),a("oxylabs","mcp.describe","Describe Oxylabs MCP projection")],Se=[t("browserbase","browser.act","Act on a browser page"),a("browserbase","browser.observe","Observe actionable browser elements",!0),a("browserbase","browser.extract","Extract structured browser page data",!0)],Re=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"]),P=N.filter((e)=>!Re.has(`${e.provider}:${e.suffix}`)),Je=P,E=N,C=[...E,...We],F=[...C,...Se];function G(e){return`web-access.${e.provider}.${e.suffix}`}var I={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."}},Ue=Object.values(I).map((e)=>e.code);import{ScalarTypeEnum as u,SchemaModel as W}from"@lssm/lib.schema";import{ScalarTypeEnum as x,SchemaModel as A}from"@lssm/lib.schema";var Ke=["browser.act","browser.observe","browser.extract"],k=x.String_unsecure(),h=x.NonEmptyString(),_={sessionId:{type:h,isOptional:!1},pageId:{type:k,isOptional:!0}},J=new A({name:"WebAccessBrowserActPayload",fields:{..._,instruction:{type:h,isOptional:!1},elementRef:{type:k,isOptional:!0},variables:{type:x.JSONObject(),isOptional:!0}}}),L=new A({name:"WebAccessBrowserObservePayload",fields:{..._,instruction:{type:k,isOptional:!0}}}),U=new A({name:"WebAccessBrowserExtractPayload",fields:{..._,instruction:{type:h,isOptional:!1},resultSchema:{type:x.JSONObject(),isOptional:!0}}}),V=new A({name:"WebAccessBrowserActDataRecord",fields:{action:{type:h,isOptional:!1},performed:{type:x.Boolean(),isOptional:!1}}}),Be=new A({name:"WebAccessBrowserActionCandidateRecord",fields:{description:{type:h,isOptional:!1},elementRef:{type:h,isOptional:!1}}}),z=new A({name:"WebAccessBrowserObserveDataRecord",fields:{candidates:{type:Be,isOptional:!1,isArray:!0}}}),K=new A({name:"WebAccessBrowserExtractDataRecord",fields:{value:{type:x.JSONObject(),isOptional:!1}}});import{ScalarTypeEnum as y,SchemaModel as v}from"@lssm/lib.schema";import{ScalarTypeEnum as p,SchemaModel as n}from"@lssm/lib.schema";var s=p.String_unsecure(),c=p.NonEmptyString(),d=p.Int_unsecure(),Pe=p.Float_unsecure(),m=p.Boolean(),O=p.URL(),X=new n({name:"WebAccessAuthorizationRecord",fields:{decision:{type:c,isOptional:!1},evidenceRefs:{type:c,isOptional:!1,isArray:!0},expiresAt:{type:p.DateTime(),isOptional:!0}}}),H=new n({name:"WebAccessBudgetRecord",fields:{currency:{type:p.Currency(),isOptional:!0},maximumAmountMinor:{type:d,isOptional:!0},maximumRequests:{type:d,isOptional:!0},estimatedAmountMinor:{type:d,isOptional:!0}}}),Q=new n({name:"WebAccessSearchPayload",fields:{query:{type:c,isOptional:!1},limit:{type:d,isOptional:!0},page:{type:d,isOptional:!0},language:{type:s,isOptional:!0},country:{type:s,isOptional:!0},category:{type:s,isOptional:!0},mode:{type:s,isOptional:!0},callback:{type:O,isOptional:!0},includeDomains:{type:c,isOptional:!0,isArray:!0},excludeDomains:{type:c,isOptional:!0,isArray:!0},transport:{type:s,isOptional:!0},useX402:{type:m,isOptional:!0}}}),Y=new n({name:"WebAccessFetchPayload",fields:{url:{type:O,isOptional:!1},format:{type:s,isOptional:!0},headers:{type:p.JSONObject(),isOptional:!0},renderJs:{type:m,isOptional:!0},includeRawContent:{type:m,isOptional:!0},extractImages:{type:m,isOptional:!0},country:{type:s,isOptional:!0},city:{type:s,isOptional:!0},mode:{type:s,isOptional:!0},callback:{type:O,isOptional:!0},transport:{type:s,isOptional:!0},useX402:{type:m,isOptional:!0}}}),Z=new n({name:"WebAccessExtractPayload",fields:{urls:{type:O,isOptional:!1,isArray:!0},query:{type:s,isOptional:!0},format:{type:s,isOptional:!0},includeImages:{type:m,isOptional:!0},transport:{type:s,isOptional:!0}}}),ee=new n({name:"WebAccessCrawlPayload",fields:{url:{type:O,isOptional:!0},urls:{type:O,isOptional:!0,isArray:!0},instructions:{type:s,isOptional:!0},limit:{type:d,isOptional:!0},maxDepth:{type:d,isOptional:!0},allowExternal:{type:m,isOptional:!0},format:{type:s,isOptional:!0},transport:{type:s,isOptional:!0}}}),te=new n({name:"WebAccessResearchPayload",fields:{query:{type:c,isOptional:!1},model:{type:s,isOptional:!0},mode:{type:s,isOptional:!0},reasoningDepth:{type:s,isOptional:!0},maxEvents:{type:d,isOptional:!0},includeDomains:{type:c,isOptional:!0,isArray:!0},excludeDomains:{type:c,isOptional:!0,isArray:!0},transport:{type:s,isOptional:!0},useX402:{type:m,isOptional:!0}}}),re=new n({name:"WebAccessScraperPayload",fields:{collector:{type:c,isOptional:!1},input:{type:p.JSONObject(),isOptional:!0},transport:{type:s,isOptional:!0}}}),se=new n({name:"WebAccessDatasetPayload",fields:{datasetId:{type:c,isOptional:!1},limit:{type:d,isOptional:!0},cursor:{type:d,isOptional:!0},createdAfter:{type:p.DateTime(),isOptional:!0},jobId:{type:s,isOptional:!0},url:{type:O,isOptional:!0},transport:{type:s,isOptional:!0}}}),Ee=new n({name:"WebAccessBrowserProxyPayload",fields:{mode:{type:c,isOptional:!1},country:{type:s,isOptional:!0},region:{type:s,isOptional:!0},city:{type:s,isOptional:!0},secretReference:{type:s,isOptional:!0}}}),ae=new n({name:"WebAccessBrowserCreatePayload",fields:{projectId:{type:s,isOptional:!0},contextId:{type:s,isOptional:!0},timeoutSeconds:{type:d,isOptional:!0},keepAlive:{type:m,isOptional:!0},country:{type:s,isOptional:!0},proxy:{type:Ee,isOptional:!0},transport:{type:s,isOptional:!0}}}),oe=new n({name:"WebAccessProxyPayload",fields:{url:{type:O,isOptional:!1},method:{type:s,isOptional:!0},headers:{type:p.JSONObject(),isOptional:!0},body:{type:s,isOptional:!0},protocol:{type:s,isOptional:!0},country:{type:s,isOptional:!0},region:{type:s,isOptional:!0},city:{type:s,isOptional:!0},stickySessionId:{type:s,isOptional:!0}}}),ie=new n({name:"WebAccessUsagePayload",fields:{start:{type:p.DateTime(),isOptional:!0},end:{type:p.DateTime(),isOptional:!0}}}),ne=new n({name:"WebAccessEmptyPayload",fields:{}}),D=new n({name:"WebAccessSourceRecord",fields:{url:{type:O,isOptional:!1},title:{type:s,isOptional:!0},snippet:{type:s,isOptional:!0},publishedAt:{type:p.DateTime(),isOptional:!0},score:{type:Pe,isOptional:!0}}}),ce=new n({name:"NativeMcpDescriptorRecord",fields:{provider:{type:c,isOptional:!1},transport:{type:c,isOptional:!1},endpoint:{type:O,isOptional:!0},command:{type:s,isOptional:!0},args:{type:s,isOptional:!0,isArray:!0},auth:{type:c,isOptional:!1},toolPrefix:{type:c,isOptional:!1}}});var l=y.String_unsecure(),g=y.NonEmptyString(),pe=new v({name:"WebAccessSearchDataRecord",fields:{query:{type:l,isOptional:!0},answer:{type:l,isOptional:!0},results:{type:D,isOptional:!0,isArray:!0}}}),le=new v({name:"WebAccessContentDataRecord",fields:{url:{type:y.URL(),isOptional:!0},title:{type:l,isOptional:!0},content:{type:l,isOptional:!0},answer:{type:l,isOptional:!0},results:{type:D,isOptional:!0,isArray:!0}}}),ue=new v({name:"WebAccessJobDataRecord",fields:{provider:{type:g,isOptional:!0},jobId:{type:g,isOptional:!0},kind:{type:l,isOptional:!0},status:{type:l,isOptional:!0}}}),de=new v({name:"WebAccessBrowserDataRecord",fields:{provider:{type:g,isOptional:!0},sessionId:{type:g,isOptional:!0},contextId:{type:g,isOptional:!0},status:{type:l,isOptional:!0},protocol:{type:l,isOptional:!0},connectHandle:{type:g,isOptional:!0},expiresAt:{type:y.DateTime(),isOptional:!0}}}),ye=new v({name:"WebAccessProxyDataRecord",fields:{status:{type:y.Int_unsecure(),isOptional:!0},finalUrl:{type:y.URL(),isOptional:!0},host:{type:l,isOptional:!0},remoteDns:{type:y.Boolean(),isOptional:!0},geoTargeting:{type:y.Boolean(),isOptional:!0},stickySessions:{type:y.Boolean(),isOptional:!0}}}),be=new v({name:"WebAccessResourceDataRecord",fields:{id:{type:l,isOptional:!0},name:{type:l,isOptional:!0},status:{type:l,isOptional:!0},credits:{type:y.Float_unsecure(),isOptional:!0},requestCount:{type:y.Int_unsecure(),isOptional:!0}}});var w=u.NonEmptyString();function Oe(e){let r=je(e),o=_e(e,r),b=e.suffix==="mcp.describe",S=b?ce:ke(e);return{input:Ce(`${r}Input`,o),output:Ie(`${r}Output`,S,b)}}function Ce(e,r){return new W({name:e,fields:{provider:{type:w,isOptional:!1},tenantId:{type:u.ID(),isOptional:!1},workspaceId:{type:u.ID(),isOptional:!0},connectionId:{type:u.ID(),isOptional:!1},correlationId:{type:w,isOptional:!1},policyMode:{type:w,isOptional:!1},authorization:{type:X,isOptional:!0},budget:{type:H,isOptional:!0},payload:{type:r,isOptional:!1}}})}function Ie(e,r,o){return new W({name:e,fields:{status:{type:w,isOptional:!1},data:o?{type:r,isOptional:!0,isArray:!0}:{type:r,isOptional:!0},sources:{type:D,isOptional:!1,isArray:!0},usage:{type:Te(e),isOptional:!0},provenance:{type:Me(e),isOptional:!1}}})}function ke(e){let r=e.suffix;if(r==="browser.act")return V;if(r==="browser.observe")return z;if(r==="browser.extract")return K;if(r.startsWith("proxy."))return ye;if(r.includes("session.")||r.startsWith("context.")||r.includes("connection.describe"))return de;if(r==="dataset.get"||r==="usage.get")return be;if(fe(r)||r.endsWith(".trigger"))return ue;if(r==="fetch.execute"||r==="extract.execute"||r==="render.execute"||r.startsWith("scraper.")||r.startsWith("crawl.")||r.startsWith("research.")||r==="map.execute")return le;return pe}function _e(e,r){let o=e.suffix;if(o==="browser.act")return J;if(o==="browser.observe")return L;if(o==="browser.extract")return U;if(o==="mcp.describe"||o==="proxy.describe")return ne;if(o==="usage.get")return ie;if(o==="proxy.request")return oe;if(o.includes("session.create")||o==="context.create")return ae;if(o.includes("session.")||o==="connection.describe")return T(r,"sessionId");if(o.startsWith("context."))return T(r,"contextId");if(o==="dataset.get")return se;if(o.startsWith("scraper.")&&!o.includes(".job."))return re;if(fe(o))return T(r,e.provider==="linkup"?"taskId":"jobId");if(o==="research.stream"||o==="research.start")return te;if(o==="map.execute"||o.startsWith("crawl."))return ee;if(o==="extract.execute")return Z;if(o==="fetch.execute"||o==="render.execute")return Y;return Q}function T(e,r){return new W({name:`${e}Payload`,fields:{[r]:{type:w,isOptional:!1},kind:{type:u.String_unsecure(),isOptional:!0},transport:{type:u.String_unsecure(),isOptional:!0}}})}function Te(e){return new W({name:`${e}Usage`,fields:{requestCount:{type:u.Int_unsecure(),isOptional:!0},credits:{type:u.Float_unsecure(),isOptional:!0},costAmountMinor:{type:u.Int_unsecure(),isOptional:!0},currency:{type:u.Currency(),isOptional:!0},providerReported:{type:u.Boolean(),isOptional:!1}}})}function Me(e){return new W({name:`${e}Provenance`,fields:{provider:{type:w,isOptional:!1},providerRequestId:{type:w,isOptional:!0},retrievedAt:{type:u.DateTime(),isOptional:!1},transport:{type:w,isOptional:!1},policyMode:{type:w,isOptional:!1}}})}function fe(e){return e.endsWith(".get")||e.endsWith(".cancel")||e==="scraper.job.get"}function je(e){return`${e.provider}-${e.suffix}`.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((r)=>`${r[0]?.toUpperCase()}${r.slice(1)}`).join("")}import{ScalarTypeEnum as i,SchemaModel as R}from"@lssm/lib.schema";var f=i.NonEmptyString(),me=new R({name:"WebAccessOperationInput",fields:{provider:{type:f,isOptional:!1},tenantId:{type:i.ID(),isOptional:!1},workspaceId:{type:i.ID(),isOptional:!0},connectionId:{type:i.ID(),isOptional:!1},correlationId:{type:f,isOptional:!1},policyMode:{type:f,isOptional:!1},authorization:{type:i.JSONObject(),isOptional:!0},budget:{type:i.JSONObject(),isOptional:!0},payload:{type:i.JSONObject(),isOptional:!1}}}),we=new R({name:"WebAccessOperationOutput",fields:{status:{type:f,isOptional:!1},data:{type:i.JSONObject(),isOptional:!0},sources:{type:i.JSONObject(),isOptional:!1,isArray:!0},usage:{type:i.JSONObject(),isOptional:!0},provenance:{type:i.JSONObject(),isOptional:!1},rawRedacted:{type:i.JSONObject(),isOptional:!0}}}),nt=new R({name:"BrightDataDeliveryPayload",fields:{connectionId:{type:i.ID(),isOptional:!1},deliveryId:{type:f,isOptional:!1},jobId:{type:f,isOptional:!0},receivedAt:{type:i.DateTime(),isOptional:!1},contentEncoding:{type:f,isOptional:!0},payload:{type:i.JSONObject(),isOptional:!1}}}),ct=new R({name:"MassiveDeliveryPayload",fields:{connectionId:{type:i.ID(),isOptional:!1},deliveryId:{type:f,isOptional:!1},jobId:{type:f,isOptional:!0},kind:{type:f,isOptional:!1},receivedAt:{type:i.DateTime(),isOptional:!1},payload:{type:i.JSONObject(),isOptional:!1}}});var Ne={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 B(e,r,o){let b=G(e),S=Oe(e),ve=r.replaceAll(".","_"),De=e.kind==="query"?e.costBearing?["read","cost-bearing"]:["read"]:e.costBearing?["read","cost-bearing","external-side-effect"]:["write","external-side-effect"],M={meta:{key:b,version:r,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:[qe(Ne.id)]},policy:{auth:"user",policies:[{key:"platform.web-access.execute",version:r}],idempotent:e.kind==="query",escalate:null},execution:{effects:De},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/${b}/v${r}`},mcp:{toolName:`${b.replaceAll(".","_")}-v${ve}`}}};if(o){let q={...M,io:{input:S.input,output:S.output,errors:I}};return e.kind==="command"?Ae(q):he(q)}let j={...M,io:{input:me,output:we}};return e.kind==="command"?Ae(j):he(j)}var xe=P.map((e)=>B(e,"1.0.0",!1)),Fe=E.map((e)=>B(e,"1.1.0",!0)),$e=C.map((e)=>B(e,"1.2.0",!0)),ge=F.map((e)=>B(e,"1.3.0",!0)),ft=xe,mt=ge,Ge=[...xe,...Fe,...$e,...ge];function wt(e){return Ge.reduce((r,o)=>r.register(o),e)}export{Ne as WebAccessOperationsDocBlock,mt as currentWebAccessOperations,wt as registerWebAccessOperations,Ge as webAccessOperationVersions,ft as webAccessOperations,xe as webAccessOperationsV1,Fe as webAccessOperationsV1_1,$e as webAccessOperationsV1_2,ge as webAccessOperationsV1_3};

package/dist/integrations/web-access/operations.test.d.ts

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

package/dist/integrations/web-access/providers.d.ts

@@ -0,0 +1,56 @@
+import type { BrowserAutomationProvider } from './browser-automation.js';
+import type { BrowserConnectionDescriptor, BrowserSession, BrowserSessionRequest, NativeMcpDescriptor, ProxyRequest, ProxyResponse, WebAccessProviderKey, WebAccessRequestContext, WebAccessResult, WebCrawlRequest, WebExtractRequest, WebFetchRequest, WebJobReference, WebJobRequest, WebResearchRequest, WebSearchRequest } from './models.js';
+export interface WebSearchProvider {
+    search(input: WebSearchRequest): Promise<WebAccessResult>;
+}
+export interface WebFetchProvider {
+    fetch(input: WebFetchRequest): Promise<WebAccessResult>;
+}
+export interface WebExtractProvider {
+    extract(input: WebExtractRequest): Promise<WebAccessResult>;
+}
+export interface WebMapProvider {
+    map(input: WebCrawlRequest): Promise<WebAccessResult>;
+}
+export interface WebCrawlProvider {
+    startCrawl(input: WebCrawlRequest): Promise<WebAccessResult<WebJobReference>>;
+    getCrawl(input: WebJobRequest): Promise<WebAccessResult>;
+    cancelCrawl(input: WebJobRequest): Promise<WebAccessResult<WebJobReference>>;
+}
+export interface WebResearchProvider {
+    startResearch(input: WebResearchRequest): Promise<WebAccessResult<WebJobReference>>;
+    getResearch(input: WebJobRequest): Promise<WebAccessResult>;
+    streamResearch?(input: WebJobRequest): AsyncIterable<WebAccessResult>;
+    cancelResearch(input: WebJobRequest): Promise<WebAccessResult<WebJobReference>>;
+}
+export interface BrowserSessionProvider {
+    createSession(input: BrowserSessionRequest): Promise<WebAccessResult<BrowserSession>>;
+    getSession(input: WebAccessRequestContext & {
+        sessionId: string;
+    }): Promise<WebAccessResult<BrowserSession>>;
+    closeSession(input: WebAccessRequestContext & {
+        sessionId: string;
+    }): Promise<WebAccessResult<BrowserSession>>;
+    describeConnection(input: WebAccessRequestContext & {
+        sessionId: string;
+    }): Promise<WebAccessResult<BrowserConnectionDescriptor>>;
+}
+export interface ProxyAccessProvider {
+    request(input: ProxyRequest): Promise<WebAccessResult<ProxyResponse>>;
+}
+export interface NativeMcpProvider {
+    describeNativeMcp(input: WebAccessRequestContext): Promise<WebAccessResult<readonly NativeMcpDescriptor[]>>;
+}
+export interface WebAccessProvider {
+    readonly provider: WebAccessProviderKey;
+    readonly search?: WebSearchProvider;
+    readonly fetch?: WebFetchProvider;
+    readonly extract?: WebExtractProvider;
+    readonly map?: WebMapProvider;
+    readonly crawl?: WebCrawlProvider;
+    readonly research?: WebResearchProvider;
+    readonly browser?: BrowserSessionProvider;
+    readonly automation?: BrowserAutomationProvider;
+    readonly proxy?: ProxyAccessProvider;
+    readonly mcp?: NativeMcpProvider;
+}

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

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

package/dist/integrations/web-access/providers.test.d.ts

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

package/dist/integrations/web-access/schemas.d.ts

@@ -0,0 +1,118 @@
+import { SchemaModel } from '@lssm/lib.schema';
+export declare const WebAccessOperationInput: SchemaModel<{
+    provider: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    workspaceId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    correlationId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    policyMode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    authorization: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    budget: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    payload: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+}>;
+export declare const WebAccessOperationOutput: SchemaModel<{
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    data: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    sources: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+        isArray: true;
+    };
+    usage: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    provenance: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+    rawRedacted: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+}>;
+export declare const BrightDataDeliveryPayload: SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    deliveryId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    jobId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    receivedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    contentEncoding: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    payload: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+}>;
+export declare const MassiveDeliveryPayload: SchemaModel<{
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    deliveryId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    jobId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    kind: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    receivedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    payload: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+}>;

package/dist/integrations/web-access/schemas.js

@@ -0,0 +1,2 @@
+// @bun
+import{ScalarTypeEnum as e,SchemaModel as a}from"@lssm/lib.schema";var t=e.NonEmptyString(),p=new a({name:"WebAccessOperationInput",fields:{provider:{type:t,isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},workspaceId:{type:e.ID(),isOptional:!0},connectionId:{type:e.ID(),isOptional:!1},correlationId:{type:t,isOptional:!1},policyMode:{type:t,isOptional:!1},authorization:{type:e.JSONObject(),isOptional:!0},budget:{type:e.JSONObject(),isOptional:!0},payload:{type:e.JSONObject(),isOptional:!1}}}),s=new a({name:"WebAccessOperationOutput",fields:{status:{type:t,isOptional:!1},data:{type:e.JSONObject(),isOptional:!0},sources:{type:e.JSONObject(),isOptional:!1,isArray:!0},usage:{type:e.JSONObject(),isOptional:!0},provenance:{type:e.JSONObject(),isOptional:!1},rawRedacted:{type:e.JSONObject(),isOptional:!0}}}),o=new a({name:"BrightDataDeliveryPayload",fields:{connectionId:{type:e.ID(),isOptional:!1},deliveryId:{type:t,isOptional:!1},jobId:{type:t,isOptional:!0},receivedAt:{type:e.DateTime(),isOptional:!1},contentEncoding:{type:t,isOptional:!0},payload:{type:e.JSONObject(),isOptional:!1}}}),n=new a({name:"MassiveDeliveryPayload",fields:{connectionId:{type:e.ID(),isOptional:!1},deliveryId:{type:t,isOptional:!1},jobId:{type:t,isOptional:!0},kind:{type:t,isOptional:!1},receivedAt:{type:e.DateTime(),isOptional:!1},payload:{type:e.JSONObject(),isOptional:!1}}});export{o as BrightDataDeliveryPayload,n as MassiveDeliveryPayload,p as WebAccessOperationInput,s as WebAccessOperationOutput};

package/dist/node/contracts-integrations.feature.js

@@ -0,0 +1 @@
+import{defineFeature as e}from"@lssm/lib.contracts-spec/features";var t=e({meta:{key:"libs.contracts-integrations",version:"1.0.0",title:"Contracts Integrations",description:"Integration contract definitions for external services",domain:"contracts-integrations",owners:["@contractspec-core"],tags:["package","libs","contracts-integrations"],stability:"experimental"},operations:[{key:"health.activities.list",version:"1.0.0"},{key:"health.activities.sync",version:"1.0.0"},{key:"health.biometrics.list",version:"1.0.0"},{key:"health.biometrics.sync",version:"1.0.0"},{key:"health.nutrition.list",version:"1.0.0"},{key:"health.nutrition.sync",version:"1.0.0"},{key:"health.sleep.list",version:"1.0.0"},{key:"health.sleep.sync",version:"1.0.0"},{key:"health.webhooks.ingest",version:"1.0.0"},{key:"health.workouts.list",version:"1.0.0"},{key:"health.workouts.sync",version:"1.0.0"},{key:"meeting-recorder.meetings.list",version:"1.0.0"},{key:"meeting-recorder.meetings.get",version:"1.0.0"},{key:"meeting-recorder.transcripts.get",version:"1.0.0"},{key:"meeting-recorder.transcripts.sync",version:"1.0.0"},{key:"meeting-recorder.webhooks.ingest",version:"1.0.0"},{key:"openbanking.accounts.list",version:"1.0.0"},{key:"openbanking.accounts.get",version:"1.0.0"},{key:"openbanking.accounts.sync",version:"1.0.0"},{key:"openbanking.balances.get",version:"1.0.0"},{key:"openbanking.balances.refresh",version:"1.0.0"},{key:"openbanking.transactions.list",version:"1.0.0"},{key:"openbanking.transactions.sync",version:"1.0.0"},{key:"integrations.connection.create",version:"1.0.0"},{key:"integrations.connection.update",version:"1.0.0"},{key:"integrations.connection.delete",version:"1.0.0"},{key:"integrations.connection.list",version:"1.0.0"},{key:"integrations.connection.test",version:"1.0.0"}]});export{t as ContractsIntegrationsFeature};