@xemahq/biomes-platform-hubspot 0.1.0

package/LICENSE

@@ -0,0 +1,175 @@
+Xema Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:  Neuralchowder Inc.
+
+Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc.
+
+  The Licensed Work includes, without limitation, Xema Core, Xema Runtime,
+  Xema Kernel, Xema control plane, Xema application runtime, Xema biome
+  runtime, Xema biome registry, Xema store services, Xema orchestration
+  services, Xema agents, Xema skills, Xema memory services, Xema APIs, Xema
+  user interfaces, Xema command-line tools, Xema deployment artifacts, Xema
+  templates, Xema specifications, Xema schemas, Xema manifests, Xema
+  documentation, Xema examples, and all source code, object code, binaries,
+  packages, modules, configuration files, manifests, schemas, examples,
+  templates, documentation, and derivative works included in or distributed
+  as part of the Xema software project.
+
+  The Licensed Work does not include any third-party software, libraries,
+  dependencies, packages, assets, or components that are distributed with the
+  Licensed Work but are governed by their own separate license terms. Such
+  third-party materials remain subject to their respective licenses.
+
+  A specific file, package, component, or directory may state that it is
+  governed by a different license. In that case, that specific file, package,
+  component, or directory is governed by the license expressly stated therein.
+
+Additional Use Grant:
+
+  You may make production use of the Licensed Work, provided that your use
+  does not include offering, providing, making available, distributing,
+  hosting, managing, embedding, reselling, white-labeling, sublicensing,
+  commercializing, or otherwise making the Licensed Work, or any modified
+  version or derivative work of the Licensed Work, available to Third Parties
+  as part of a Competitive Offering.
+
+The following definitions and clarifications form part of, and govern
+the interpretation of, the Additional Use Grant set out above.
+
+  1. "Production Use" means any use of the Licensed Work other than for
+     development, testing, evaluation, demonstration, experimentation,
+     benchmarking, or other non-production purposes.
+
+  2. "Affiliate" means any entity that, directly or indirectly,
+     controls, is controlled by, or is under common control with you,
+     where "control" means ownership of more than fifty percent (50%) of
+     the voting interests of the entity, or the power to direct its
+     management.
+
+  3. "Third Party" means any natural person or legal entity other than
+     you and your Affiliates.
+
+  4. "Competitive Offering" means any product or service, made available
+     to one or more Third Parties for a fee or other consideration
+     (including without limitation on a paid, subscription,
+     advertising-supported, hosted, or managed-service basis), that is
+     offered or marketed as, or that competes with, a software platform,
+     runtime, orchestration system, agent or automation system,
+     extension or distribution marketplace, or other software system
+     that provides, in substantial part, the same or substantially
+     similar capabilities as those provided by the Licensed Work. A
+     product or service is a Competitive Offering whether the Licensed
+     Work is provided in whole or in part, alone or bundled with other
+     software, and whether modified or unmodified.
+
+  5. Providing, hosting, or managing the Licensed Work for a Third Party,
+     or otherwise making the Licensed Work available to a Third Party as
+     a hosted or managed service such that the Third Party obtains the
+     principal value or functionality of the Licensed Work, is a
+     Competitive Offering and is not permitted by the Additional Use
+     Grant.
+
+  6. Subject to the foregoing, the Additional Use Grant permits you to
+     make Production Use of the Licensed Work for your own internal
+     business purposes and to build, operate, and provide your own
+     products and services to Third Parties, provided that the Licensed
+     Work itself (whether modified or unmodified) is not the product or
+     service, and is not a Competitive Offering, made available to those
+     Third Parties.
+
+  7. You may modify the Licensed Work and create derivative works for
+     any purpose permitted by this License. Any Production Use of such
+     modified or derivative works remains subject to the same
+     restrictions as the Licensed Work, including the prohibition on
+     Competitive Offerings.
+
+  8. Use of the Licensed Work by your own employees, contractors, and
+     agents, acting on your behalf and for your benefit, is not by
+     itself making the Licensed Work available to a Third Party.
+
+  9. Embedding or distributing the Licensed Work as a component of your
+     own product or service is permitted only where the Licensed Work
+     does not constitute the principal value of that product or service
+     and the product or service is not a Competitive Offering.
+
+  10. Nothing in this Additional Use Grant grants any right to use any
+      name, trademark, service mark, or logo of the Licensor or its
+      Affiliates, except as reasonably required for customary
+      attribution.
+
+  11. The rights stated in this Additional Use Grant are the maximum
+      rights granted for Production Use prior to the Change Date. Any
+      Production Use not expressly permitted requires a separate
+      commercial license from the Licensor.
+
+  12. If any provision of this Additional Use Grant is held invalid or
+      unenforceable, that provision shall be limited or eliminated to
+      the minimum extent necessary so that the remainder of this
+      Additional Use Grant, and of this License, remains in full force
+      and effect. The Licensor reserves all rights not expressly granted
+      by this License.
+
+
+Change Date:  Four years from the date the specific version of the Licensed
+  Work is first publicly released by Licensor.
+
+Change License:  Mozilla Public License, Version 2.0
+
+For information about alternative licensing arrangements, commercial
+licensing, enterprise licensing, OEM licensing, appliance licensing, managed
+service licensing, cloud provider licensing, or other commercial use of the
+Licensed Work, please contact: licensing@neuralchowder.com
+
+-----------------------------------------------------------------------------
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates, provided that you may use a trademark or logo of Licensor
+as expressly required by this License.
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.

package/contributions/hubspot.connector-adapter.contribution.json

@@ -0,0 +1,112 @@
+{
+  "kind": "connector-adapter",
+  "manifest": {
+    "provider": {
+      "providerKey": "hubspot",
+      "displayName": "HubSpot",
+      "description": "HubSpot CRM — read access to contacts, companies and deals, authenticated per connection by a private-app access token.",
+      "iconName": "Contact",
+      "category": "CRM",
+      "apiBaseUrl": "https://api.hubapi.com",
+      "appAuthKind": "none",
+      "allowOrgOverride": false
+    },
+    "connectors": [
+      {
+        "connectorKey": "HUBSPOT_CRM",
+        "displayName": "HubSpot CRM (read-only)",
+        "description": "Search HubSpot CRM contacts, companies and deals, and read a contact in full. Read-only: connector writes cannot yet declare an approval requirement, so none are shipped.",
+        "iconName": "Contact",
+        "providerKey": "hubspot",
+        "scopes": [
+          "crm.objects.contacts.read",
+          "crm.objects.companies.read",
+          "crm.objects.deals.read"
+        ],
+        "connectionCredentialKind": "api_key",
+        "adapterKind": "crm",
+        "operations": [
+          {
+            "capabilityRef": "connector:hubspot.search-contacts@1",
+            "adapterKind": "declarative-http",
+            "scopes": [
+              "crm.objects.contacts.read"
+            ],
+            "requiresConnection": true,
+            "httpRequest": {
+              "method": "POST",
+              "pathTemplate": "/crm/v3/objects/contacts/search",
+              "bodyMode": "json_input",
+              "auth": {
+                "kind": "bearer_header"
+              }
+            }
+          },
+          {
+            "capabilityRef": "connector:hubspot.get-contact@1",
+            "adapterKind": "declarative-http",
+            "scopes": [
+              "crm.objects.contacts.read"
+            ],
+            "requiresConnection": true,
+            "httpRequest": {
+              "method": "GET",
+              "pathTemplate": "/crm/v3/objects/contacts/{contactId}",
+              "query": {
+                "properties": "{properties}"
+              },
+              "bodyMode": "none",
+              "auth": {
+                "kind": "bearer_header"
+              }
+            }
+          },
+          {
+            "capabilityRef": "connector:hubspot.search-companies@1",
+            "adapterKind": "declarative-http",
+            "scopes": [
+              "crm.objects.companies.read"
+            ],
+            "requiresConnection": true,
+            "httpRequest": {
+              "method": "POST",
+              "pathTemplate": "/crm/v3/objects/companies/search",
+              "bodyMode": "json_input",
+              "auth": {
+                "kind": "bearer_header"
+              }
+            }
+          },
+          {
+            "capabilityRef": "connector:hubspot.search-deals@1",
+            "adapterKind": "declarative-http",
+            "scopes": [
+              "crm.objects.deals.read"
+            ],
+            "requiresConnection": true,
+            "httpRequest": {
+              "method": "POST",
+              "pathTemplate": "/crm/v3/objects/deals/search",
+              "bodyMode": "json_input",
+              "auth": {
+                "kind": "bearer_header"
+              }
+            }
+          }
+        ]
+      }
+    ],
+    "credentialFields": [
+      {
+        "key": "accessToken",
+        "label": "Private app access token",
+        "type": "PASSWORD",
+        "required": true,
+        "isSecret": true,
+        "placeholder": "pat-na1-…",
+        "hint": "HubSpot → Settings → Integrations → Private Apps → your app → Auth. Grant only the scopes this connector declares — all three are READ scopes, so a token minted for it cannot modify your CRM even if it leaked. The token is held by the credential broker at org scope and is never shown to an agent.",
+        "transform": "TRIM"
+      }
+    ]
+  }
+}

package/dist/connector-adapters/index.d.ts

@@ -0,0 +1,11 @@
+import { type ConnectorAdapterModule } from '@xemahq/biome-sdk/adapter';
+import { type ConnectorDescriptor, type ProviderDescriptor } from '@xemahq/kernel-contracts/connector';
+export declare const HUBSPOT_CONNECTOR_KEY = "HUBSPOT_CRM";
+export declare const providerDescriptor: ProviderDescriptor;
+export declare const connectorDescriptors: readonly ConnectorDescriptor[];
+export declare const hubspotProvider: ConnectorAdapterModule;
+declare const connectorAdapters: readonly ConnectorAdapterModule[];
+export default connectorAdapters;
+export { CRM_ADAPTER_KIND, HUBSPOT_API_BASE_URL, HUBSPOT_CAPABILITY_REFS, HUBSPOT_PROVIDER_KEY, HubSpotScope, HubSpotVerb, hubspotConnectorScopes, hubspotOperations, } from './operations.js';
+export { operationInputSchemas, operationInputSchemasByVerb, type OperationInputSchema, } from './operation-input-schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAExB,MAAM,oCAAoC,CAAC;AA8D5C,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAqDnD,eAAO,MAAM,kBAAkB,EAAE,kBAgBhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,mBAAmB,EAgB9D,CAAC;AASF,eAAO,MAAM,eAAe,EAAE,sBAQ5B,CAAC;AAEH,QAAA,MAAM,iBAAiB,EAAE,SAAS,sBAAsB,EAAsB,CAAC;AAC/E,eAAe,iBAAiB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC"}

package/dist/connector-adapters/index.js

@@ -0,0 +1,71 @@
+import { defineConnectorAdapter, } from '@xemahq/biome-sdk/adapter';
+import { ConnectorOnboardingKind, CredentialFieldTransform, CredentialFieldType, CredentialKind, ProviderAppAuthKind, ProviderOrigin, } from '@xemahq/kernel-contracts/connector';
+import { CRM_ADAPTER_KIND, HUBSPOT_API_BASE_URL, HUBSPOT_PROVIDER_KEY, hubspotConnectorScopes, hubspotOperations, } from './operations.js';
+export const HUBSPOT_CONNECTOR_KEY = 'HUBSPOT_CRM';
+const ICON_NAME = 'Contact';
+const onboarding = {
+    provider: HUBSPOT_PROVIDER_KEY,
+    displayName: 'HubSpot',
+    description: 'Read HubSpot CRM contacts, companies and deals with a private-app access token.',
+    iconName: ICON_NAME,
+    kind: ConnectorOnboardingKind.CREDENTIALS,
+    supportedProjectBindingAdapterKinds: [],
+    fields: [
+        {
+            key: 'accessToken',
+            label: 'Private app access token',
+            type: CredentialFieldType.PASSWORD,
+            required: true,
+            isSecret: true,
+            placeholder: 'pat-na1-…',
+            hint: 'HubSpot → Settings → Integrations → Private Apps → your app → Auth. ' +
+                'Grant only the scopes this connector declares — all three are READ ' +
+                'scopes, so a token minted for it cannot modify your CRM even if it ' +
+                'leaked. The token is held by the credential broker at org scope and is ' +
+                'never shown to an agent.',
+            transform: CredentialFieldTransform.TRIM,
+        },
+    ],
+    hint: 'A private app authenticates one HubSpot account. For several accounts, ' +
+        'create one connection per account — each carries its own token.',
+};
+export const providerDescriptor = {
+    providerKey: HUBSPOT_PROVIDER_KEY,
+    displayName: 'HubSpot',
+    description: 'HubSpot CRM — read access to contacts, companies and deals, authenticated per connection by a private-app access token.',
+    iconName: ICON_NAME,
+    category: 'CRM',
+    apiBaseUrl: HUBSPOT_API_BASE_URL,
+    appAuthKind: ProviderAppAuthKind.None,
+    origin: ProviderOrigin.Biome,
+    allowOrgOverride: false,
+};
+export const connectorDescriptors = [
+    {
+        connectorKey: HUBSPOT_CONNECTOR_KEY,
+        displayName: 'HubSpot CRM (read-only)',
+        description: 'Search HubSpot CRM contacts, companies and deals, and read a contact in ' +
+            'full. Read-only: connector writes cannot yet declare an approval ' +
+            'requirement, so none are shipped.',
+        iconName: ICON_NAME,
+        providerKey: HUBSPOT_PROVIDER_KEY,
+        scopes: hubspotConnectorScopes,
+        connectionCredentialKind: CredentialKind.ApiKey,
+        adapterKind: CRM_ADAPTER_KIND,
+        operations: hubspotOperations,
+    },
+];
+export const hubspotProvider = defineConnectorAdapter({
+    adapterKind: CRM_ADAPTER_KIND,
+    provider: HUBSPOT_PROVIDER_KEY,
+    displayName: 'HubSpot',
+    credentialKind: CredentialKind.ApiKey,
+    resources: {},
+    actions: {},
+    onboarding,
+});
+const connectorAdapters = [hubspotProvider];
+export default connectorAdapters;
+export { CRM_ADAPTER_KIND, HUBSPOT_API_BASE_URL, HUBSPOT_CAPABILITY_REFS, HUBSPOT_PROVIDER_KEY, HubSpotScope, HubSpotVerb, hubspotConnectorScopes, hubspotOperations, } from './operations.js';
+export { operationInputSchemas, operationInputSchemasByVerb, } from './operation-input-schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/connector-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connector-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAEvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,cAAc,GAIf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAsDzB,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAGnD,MAAM,SAAS,GAAG,SAAS,CAAC;AAE5B,MAAM,UAAU,GAA+B;IAC7C,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,SAAS;IACtB,WAAW,EACT,iFAAiF;IACnF,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,uBAAuB,CAAC,WAAW;IAGzC,mCAAmC,EAAE,EAAE;IACvC,MAAM,EAAE;QACN;YAKE,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,0BAA0B;YACjC,IAAI,EAAE,mBAAmB,CAAC,QAAQ;YAClC,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,WAAW;YACxB,IAAI,EACF,sEAAsE;gBACtE,qEAAqE;gBACrE,qEAAqE;gBACrE,yEAAyE;gBACzE,0BAA0B;YAC5B,SAAS,EAAE,wBAAwB,CAAC,IAAI;SACzC;KACF;IACD,IAAI,EACF,yEAAyE;QACzE,iEAAiE;CACpE,CAAC;AAcF,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,SAAS;IACtB,WAAW,EACT,yHAAyH;IAC3H,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,mBAAmB,CAAC,IAAI;IACrC,MAAM,EAAE,cAAc,CAAC,KAAK;IAI5B,gBAAgB,EAAE,KAAK;CAGxB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAmC;IAClE;QACE,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE,yBAAyB;QACtC,WAAW,EACT,0EAA0E;YAC1E,mEAAmE;YACnE,mCAAmC;QACrC,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,oBAAoB;QAEjC,MAAM,EAAE,sBAAsB;QAC9B,wBAAwB,EAAE,cAAc,CAAC,MAAM;QAC/C,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE,iBAAiB;KAC9B;CACF,CAAC;AASF,MAAM,CAAC,MAAM,eAAe,GAA2B,sBAAsB,CAAC;IAC5E,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,cAAc,CAAC,MAAM;IACrC,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAsC,CAAC,eAAe,CAAC,CAAC;AAC/E,eAAe,iBAAiB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC"}

package/dist/connector-adapters/operation-input-schemas.d.ts

@@ -0,0 +1,19 @@
+import { HubSpotVerb } from './operations.js';
+import type { CapabilityRef } from '@xemahq/kernel-contracts/capability';
+type JsonSchemaNode = Readonly<Record<string, unknown>>;
+export interface OperationInputSchema {
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+    readonly type: 'object';
+    readonly title: string;
+    readonly description: string;
+    readonly properties: Readonly<Record<string, JsonSchemaNode>>;
+    readonly required: readonly string[];
+    readonly additionalProperties: false;
+    readonly anyOf?: readonly {
+        readonly required: readonly string[];
+    }[];
+}
+export declare const operationInputSchemasByVerb: Readonly<Record<HubSpotVerb, OperationInputSchema>>;
+export declare const operationInputSchemas: Readonly<Record<CapabilityRef, OperationInputSchema>>;
+export {};
+//# sourceMappingURL=operation-input-schemas.d.ts.map

package/dist/connector-adapters/operation-input-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-input-schemas.d.ts","sourceRoot":"","sources":["../../src/connector-adapters/operation-input-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAsCzE,KAAK,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AASxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,yCAAyC,CAAC;IAC5D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,KAAK,CAAC;IAErC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACtE;AA8FD,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,MAAM,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAiDzC,CAAC;AAQH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAQ5C,CAAC"}

package/dist/connector-adapters/operation-input-schemas.js

@@ -0,0 +1,118 @@
+import { HUBSPOT_CAPABILITY_REFS, HubSpotVerb } from './operations.js';
+const DRAFT_07 = 'http://json-schema.org/draft-07/schema#';
+function searchSchema(input) {
+    return {
+        $schema: DRAFT_07,
+        type: 'object',
+        title: input.title,
+        description: `Search HubSpot ${input.objectPlural}. Supply a free-text \`query\`, or ` +
+            '`filterGroups` for a structured search (groups are OR-ed, filters within ' +
+            'a group are AND-ed). The response carries `paging.next.after`; pass it ' +
+            'back as `after` to page.',
+        properties: {
+            query: {
+                type: 'string',
+                minLength: 1,
+                description: `Free-text search across the ${input.objectPlural}' searchable properties.`,
+            },
+            filterGroups: {
+                type: 'array',
+                maxItems: 5,
+                description: 'Structured search. Each group is `{ "filters": [{ "propertyName", ' +
+                    '"operator", "value" | "values" | "highValue" }] }`. At most 5 groups, ' +
+                    'each with at most 6 filters (HubSpot limit).',
+                items: {
+                    type: 'object',
+                    properties: {
+                        filters: { type: 'array', maxItems: 6, items: { type: 'object' } },
+                    },
+                    required: ['filters'],
+                },
+            },
+            sorts: {
+                type: 'array',
+                description: 'At most one sort, as `{ "propertyName", "direction": "ASCENDING" | ' +
+                    '"DESCENDING" }` (HubSpot accepts a single sort).',
+                maxItems: 1,
+                items: {
+                    type: 'object',
+                    properties: {
+                        propertyName: { type: 'string' },
+                        direction: { type: 'string', enum: ['ASCENDING', 'DESCENDING'] },
+                    },
+                    required: ['propertyName', 'direction'],
+                },
+            },
+            properties: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Property names to return on each result. Omit for HubSpot\'s default ' +
+                    `projection. Examples: ${input.examplePropertyNames.join(', ')}.`,
+            },
+            limit: {
+                type: 'integer',
+                minimum: 1,
+                maximum: 200,
+                default: 10,
+                description: 'Page size. HubSpot caps search at 200.',
+            },
+            after: {
+                type: 'string',
+                description: 'Paging cursor from a previous response (`paging.next.after`). Omit ' +
+                    'for the first page.',
+            },
+        },
+        required: [],
+        additionalProperties: false,
+        anyOf: [{ required: ['query'] }, { required: ['filterGroups'] }],
+    };
+}
+export const operationInputSchemasByVerb = Object.freeze({
+    [HubSpotVerb.SearchContacts]: searchSchema({
+        title: 'Search HubSpot contacts',
+        objectPlural: 'contacts',
+        examplePropertyNames: ['email', 'firstname', 'lastname', 'company', 'lifecyclestage'],
+    }),
+    [HubSpotVerb.GetContact]: {
+        $schema: DRAFT_07,
+        type: 'object',
+        title: 'Get one HubSpot contact',
+        description: 'Read a single contact by its HubSpot record id, returning the named ' +
+            'properties.',
+        properties: {
+            contactId: {
+                type: 'string',
+                minLength: 1,
+                pattern: '^[0-9]+$',
+                description: 'HubSpot contact record id (the numeric `id` on a search hit).',
+            },
+            properties: {
+                type: 'string',
+                minLength: 1,
+                pattern: '^[a-zA-Z0-9_]+(,[a-zA-Z0-9_]+)*$',
+                description: 'COMMA-SEPARATED property names, e.g. `email,firstname,lastname`. A ' +
+                    'string and not an array: this value fills a query-string placeholder, ' +
+                    'and the executor substitutes scalars only — it has no array-to-CSV ' +
+                    'serialisation. Required, because a declared placeholder with no input ' +
+                    'value is a fail-fast error, so there is no way to express "omit it".',
+            },
+        },
+        required: ['contactId', 'properties'],
+        additionalProperties: false,
+    },
+    [HubSpotVerb.SearchCompanies]: searchSchema({
+        title: 'Search HubSpot companies',
+        objectPlural: 'companies',
+        examplePropertyNames: ['name', 'domain', 'industry', 'country', 'numberofemployees'],
+    }),
+    [HubSpotVerb.SearchDeals]: searchSchema({
+        title: 'Search HubSpot deals',
+        objectPlural: 'deals',
+        examplePropertyNames: ['dealname', 'amount', 'dealstage', 'pipeline', 'closedate'],
+    }),
+});
+export const operationInputSchemas = Object.freeze(Object.fromEntries(Object.values(HubSpotVerb).map((verb) => [
+    HUBSPOT_CAPABILITY_REFS[verb],
+    operationInputSchemasByVerb[verb],
+])));
+//# sourceMappingURL=operation-input-schemas.js.map

package/dist/connector-adapters/operation-input-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-input-schemas.js","sourceRoot":"","sources":["../../src/connector-adapters/operation-input-schemas.ts"],"names":[],"mappings":"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"}

package/dist/connector-adapters/operations.d.ts

@@ -0,0 +1,24 @@
+import { type ConnectorOperationDescriptor } from '@xemahq/kernel-contracts/connector';
+export declare const HUBSPOT_PROVIDER_KEY = "hubspot";
+export declare const CRM_ADAPTER_KIND = "crm";
+export declare const HUBSPOT_API_BASE_URL = "https://api.hubapi.com";
+export declare enum HubSpotScope {
+    ContactsRead = "crm.objects.contacts.read",
+    CompaniesRead = "crm.objects.companies.read",
+    DealsRead = "crm.objects.deals.read"
+}
+export declare enum HubSpotVerb {
+    SearchContacts = "search-contacts",
+    GetContact = "get-contact",
+    SearchCompanies = "search-companies",
+    SearchDeals = "search-deals"
+}
+export declare const HUBSPOT_CAPABILITY_REFS: Readonly<{
+    "search-contacts": import("@xemahq/kernel-contracts/capability").CapabilityRef;
+    "get-contact": import("@xemahq/kernel-contracts/capability").CapabilityRef;
+    "search-companies": import("@xemahq/kernel-contracts/capability").CapabilityRef;
+    "search-deals": import("@xemahq/kernel-contracts/capability").CapabilityRef;
+}>;
+export declare const hubspotOperations: readonly ConnectorOperationDescriptor[];
+export declare const hubspotConnectorScopes: readonly string[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/connector-adapters/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/connector-adapters/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,4BAA4B,EAClC,MAAM,oCAAoC,CAAC;AA8E5C,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAQ9C,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAGtC,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAO7D,oBAAY,YAAY;IACtB,YAAY,8BAA8B;IAC1C,aAAa,+BAA+B;IAC5C,SAAS,2BAA2B;CACrC;AAOD,oBAAY,WAAW;IACrB,cAAc,oBAAoB;IAClC,UAAU,gBAAgB;IAC1B,eAAe,qBAAqB;IACpC,WAAW,iBAAiB;CAC7B;AAGD,eAAO,MAAM,uBAAuB;;;;;EAiBlC,CAAC;AAuDH,eAAO,MAAM,iBAAiB,EAAE,SAAS,4BAA4B,EAuCjE,CAAC;AAQL,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAElD,CAAC"}

package/dist/connector-adapters/operations.js

@@ -0,0 +1,77 @@
+import { ConnectorAdapterKind, ConnectorAuthInjectionKind, ConnectorHttpBodyMode, ConnectorHttpMethod, } from '@xemahq/kernel-contracts/connector';
+import { buildConnectorCapabilityRef } from '@xemahq/kernel-contracts/capability';
+export const HUBSPOT_PROVIDER_KEY = 'hubspot';
+export const CRM_ADAPTER_KIND = 'crm';
+export const HUBSPOT_API_BASE_URL = 'https://api.hubapi.com';
+export var HubSpotScope;
+(function (HubSpotScope) {
+    HubSpotScope["ContactsRead"] = "crm.objects.contacts.read";
+    HubSpotScope["CompaniesRead"] = "crm.objects.companies.read";
+    HubSpotScope["DealsRead"] = "crm.objects.deals.read";
+})(HubSpotScope || (HubSpotScope = {}));
+export var HubSpotVerb;
+(function (HubSpotVerb) {
+    HubSpotVerb["SearchContacts"] = "search-contacts";
+    HubSpotVerb["GetContact"] = "get-contact";
+    HubSpotVerb["SearchCompanies"] = "search-companies";
+    HubSpotVerb["SearchDeals"] = "search-deals";
+})(HubSpotVerb || (HubSpotVerb = {}));
+export const HUBSPOT_CAPABILITY_REFS = Object.freeze({
+    [HubSpotVerb.SearchContacts]: buildConnectorCapabilityRef(HUBSPOT_PROVIDER_KEY, HubSpotVerb.SearchContacts),
+    [HubSpotVerb.GetContact]: buildConnectorCapabilityRef(HUBSPOT_PROVIDER_KEY, HubSpotVerb.GetContact),
+    [HubSpotVerb.SearchCompanies]: buildConnectorCapabilityRef(HUBSPOT_PROVIDER_KEY, HubSpotVerb.SearchCompanies),
+    [HubSpotVerb.SearchDeals]: buildConnectorCapabilityRef(HUBSPOT_PROVIDER_KEY, HubSpotVerb.SearchDeals),
+});
+const BEARER_AUTH = Object.freeze({
+    kind: ConnectorAuthInjectionKind.BearerHeader,
+});
+function declarativeOperation(input) {
+    return {
+        capabilityRef: HUBSPOT_CAPABILITY_REFS[input.verb],
+        adapterKind: ConnectorAdapterKind.DeclarativeHttp,
+        scopes: input.scopes,
+        requiresConnection: true,
+        httpRequest: {
+            method: input.method,
+            pathTemplate: input.pathTemplate,
+            ...(input.query === undefined ? {} : { query: input.query }),
+            bodyMode: input.bodyMode,
+            auth: BEARER_AUTH,
+        },
+    };
+}
+export const hubspotOperations = Object.freeze([
+    declarativeOperation({
+        verb: HubSpotVerb.SearchContacts,
+        scopes: [HubSpotScope.ContactsRead],
+        method: ConnectorHttpMethod.Post,
+        pathTemplate: '/crm/v3/objects/contacts/search',
+        bodyMode: ConnectorHttpBodyMode.JsonInput,
+    }),
+    declarativeOperation({
+        verb: HubSpotVerb.GetContact,
+        scopes: [HubSpotScope.ContactsRead],
+        method: ConnectorHttpMethod.Get,
+        pathTemplate: '/crm/v3/objects/contacts/{contactId}',
+        query: { properties: '{properties}' },
+        bodyMode: ConnectorHttpBodyMode.None,
+    }),
+    declarativeOperation({
+        verb: HubSpotVerb.SearchCompanies,
+        scopes: [HubSpotScope.CompaniesRead],
+        method: ConnectorHttpMethod.Post,
+        pathTemplate: '/crm/v3/objects/companies/search',
+        bodyMode: ConnectorHttpBodyMode.JsonInput,
+    }),
+    declarativeOperation({
+        verb: HubSpotVerb.SearchDeals,
+        scopes: [HubSpotScope.DealsRead],
+        method: ConnectorHttpMethod.Post,
+        pathTemplate: '/crm/v3/objects/deals/search',
+        bodyMode: ConnectorHttpBodyMode.JsonInput,
+    }),
+]);
+export const hubspotConnectorScopes = Object.freeze([
+    ...new Set(hubspotOperations.flatMap((operation) => operation.scopes)),
+]);
+//# sourceMappingURL=operations.js.map

package/dist/connector-adapters/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/connector-adapters/operations.ts"],"names":[],"mappings":"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"}

package/install-schema/install.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "connector-hubspot-install",
+  "title": "HubSpot CRM Connector Settings",
+  "type": "object",
+  "required": ["integration"],
+  "properties": {
+    "integration": {
+      "type": "string",
+      "title": "HubSpot connection",
+      "description": "Which connected HubSpot account this installation uses. One connection per HubSpot account — each carries its own private-app access token, held at org scope by the credential broker."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@xemahq/biomes-platform-hubspot",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-community.git",
+    "directory": "biomes/connector-hubspot"
+  },
+  "license": "LicenseRef-Xema-BSL-1.1",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/connector-adapters/index.js",
+  "files": [
+    "dist",
+    "install-schema",
+    "xema-biome.json",
+    "contributions"
+  ],
+  "exports": {
+    "./connector-adapters": {
+      "types": "./dist/connector-adapters/index.d.ts",
+      "default": "./dist/connector-adapters/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@xemahq/biome-sdk": "^6.2.3",
+    "@xemahq/kernel-contracts": "^15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test ./tests/**/*.test.mjs"
+  }
+}

package/xema-biome.json

@@ -0,0 +1,124 @@
+{
+  "name": "@xemahq/biomes-platform-hubspot",
+  "version": "0.1.0",
+  "xema": {
+    "id": "connector-hubspot",
+    "displayName": "HubSpot CRM Connector (read-only)",
+    "display": {
+      "icon": "contact",
+      "category": "connect",
+      "summary": "HubSpot CRM connector \u2014 search contacts, companies and deals and read a contact in full, through four declarative-HTTP operations. Read-only by design."
+    },
+    "description": "First-party connector biome for HubSpot CRM, and the first whose every operation is `declarative-http`: four ConnectorHttpRequestTemplates executed by connector-gateway-api's generic DeclarativeHttpExecutorService with NO connector-specific code, no provider SDK and no adapter dispatch. Projects `connector:hubspot.search-contacts@1`, `.get-contact@1`, `.search-companies@1` and `.search-deals@1` against HubSpot's single global API host. Each connection authenticates with its own HubSpot private-app access token (curated `api_key` credential kind, injected as `Authorization: Bearer`), held by the credential broker at org scope \u2014 there is no shared platform app to provision, so the connector is connectable the moment it is installed. READ-ONLY BY DESIGN: `create-contact` and `update-contact` were written and removed before shipping, because `ConnectorOperationDescriptor` is a strictObject with no `requiresApproval`, `inputSchema`, `riskTier` or idempotency field \u2014 so a connector write can never reach the platform's durable approval gate, can never be validated at the capability boundary, and can never be safely retried against a provider that rate-limits. Adding those four optional fields to the kernel descriptor (and having the projector read them instead of UNDECLARED_OPERATION_METADATA) is the exact change that unblocks writes; the input schemas are already written and asserted in src/connector-adapters/operation-input-schemas.ts. Ships no webhook block (a private-app connection has no push channel) and no code actions.",
+    "scope": "platform",
+    "storeListed": true,
+    "target": "server",
+    "kind": "connector",
+    "bundleSource": {
+      "kind": "npm",
+      "name": "@xemahq/biomes-platform-hubspot",
+      "version": "0.1.0"
+    },
+    "trustTier": "first-party",
+    "connectorRequirements": [
+      {
+        "adapterKind": "crm",
+        "purpose": "Read an org's own HubSpot CRM records (contacts, companies, deals) from agents and workflows. Read-only \u2014 see the biome description for why no write operation is shipped.",
+        "capabilities": [
+          "crm.search-contacts",
+          "crm.get-contact",
+          "crm.search-companies",
+          "crm.search-deals"
+        ]
+      }
+    ],
+    "components": [
+      {
+        "key": "connector-adapter",
+        "kind": "adapter",
+        "artifact": {
+          "kind": "host-module",
+          "path": "dist/connector-adapters/index.js"
+        },
+        "entrypoint": {
+          "kind": "module-export",
+          "module": "dist/connector-adapters/index.js",
+          "exportName": "default"
+        },
+        "protocol": {
+          "kind": "adapter",
+          "revision": "v1"
+        },
+        "hostAbi": {
+          "name": "xema-adapter-host",
+          "versionRange": "^1"
+        },
+        "executionModes": [
+          "shared-host",
+          "isolated"
+        ],
+        "requirements": {
+          "tenancy": {
+            "allowed": [
+              "org",
+              "project"
+            ],
+            "tenantContext": "verified"
+          },
+          "isolation": {
+            "minimum": "none"
+          },
+          "trust": {
+            "minimum": "verified"
+          },
+          "locality": {
+            "allowed": [
+              "cloud",
+              "customer-private"
+            ]
+          },
+          "state": {
+            "kind": "stateless"
+          },
+          "resources": {
+            "minimum": {
+              "cpu": "100m",
+              "memory": "64Mi",
+              "ephemeralStorage": "64Mi"
+            }
+          },
+          "runtime": {
+            "kind": "node",
+            "versionRange": ">=22 <25"
+          },
+          "io": {
+            "ingress": "none",
+            "egress": "internet",
+            "rawBody": false,
+            "devices": []
+          },
+          "scaling": {
+            "mode": "horizontal",
+            "concurrency": {
+              "handling": "parallel",
+              "maximumPerInstance": 16
+            },
+            "readiness": {
+              "kind": "protocol",
+              "initialDelaySeconds": 0
+            },
+            "drain": {
+              "kind": "graceful",
+              "maximumSeconds": 30
+            },
+            "hints": {
+              "cpu": "latency",
+              "memory": "steady",
+              "startup": "fast"
+            }
+          }
+        }
+      }
+    ]
+  }
+}