@tangle-network/agent-integrations 0.6.0 → 0.7.1

package/docs/integration-coverage-checklist.md

@@ -15,7 +15,8 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [x] One normalized connector contract for apps, sandboxes, and agents.
 - [x] Central sandbox invocation envelope validation.
 - [x] Coverage catalog for 100+ high-value integrations.
-- [ ] Builder UI consumes the coverage catalog for app planning.
+- [x] Builder API consumes the coverage catalog for app planning.
+- [x] Declarative REST adapter factory for fast first-party promotion of REST-shaped APIs.
 - [ ] Generated sandbox apps can request missing connections from the catalog.
 - [ ] Live smoke credentials exist for Tier 0 connectors.
 - [ ] Tier 0 connector failures are classified by auth, scope, rate-limit, provider outage, validation, approval, and conflict.
@@ -39,11 +40,11 @@ Goal: cover the integrations that make agents useful for 99% of practical produc
 - [ ] Google Docs
 - [ ] Microsoft Teams
 - [ ] OneDrive
-- [ ] Airtable
-- [ ] Salesforce
+- [x] Airtable
+- [x] Salesforce
 - [ ] Linear
 - [ ] Jira
-- [ ] GitHub
+- [x] GitHub
 - [ ] Zendesk
 - [ ] Intercom
 - [ ] QuickBooks
@@ -80,7 +81,9 @@ The exhaustive checklist is generated from `integrationCoverageChecklistMarkdown
 
 - [ ] Wire Builder to show Tier 0 missing connections from the coverage catalog.
 - [ ] Add Gmail first-party adapter.
-- [ ] Add GitHub first-party adapter.
-- [ ] Add Salesforce or Zendesk first-party adapter.
+- [x] Add GitHub first-party adapter.
+- [x] Add Salesforce or Zendesk first-party adapter.
+- [x] Add reusable declarative REST adapter factory.
+- [x] Add Airtable, GitLab, and Asana via declarative REST.
 - [ ] Add live smoke-test harness that skips only when explicit credentials are absent.
 - [ ] Add gateway sync job for Nango/Pipedream/Activepieces metadata.

package/examples/basic-hub.ts

@@ -0,0 +1,47 @@
+import {
+  InMemoryConnectionStore,
+  IntegrationHub,
+  buildIntegrationToolCatalog,
+  createMockIntegrationProvider,
+  searchIntegrationTools,
+} from '@tangle-network/agent-integrations'
+
+const provider = createMockIntegrationProvider()
+const store = new InMemoryConnectionStore()
+const hub = new IntegrationHub({
+  providers: [provider],
+  store,
+  capabilitySecret: 'replace-with-secret-manager-value',
+})
+
+const tools = searchIntegrationTools(
+  buildIntegrationToolCatalog(await hub.listConnectors()),
+  'email search',
+  { maxRisk: 'read' },
+)
+
+const connection = await hub.upsertConnection({
+  id: 'conn_1',
+  owner: { type: 'user', id: 'user_1' },
+  providerId: 'mock',
+  connectorId: 'gmail',
+  status: 'active',
+  grantedScopes: ['email.read'],
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString(),
+})
+
+const capability = await hub.issueCapability({
+  subject: { type: 'sandbox', id: 'sandbox_1' },
+  connectionId: connection.id,
+  scopes: ['email.read'],
+  allowedActions: [tools[0]!.tool.action.id],
+  ttlMs: 60_000,
+})
+
+const result = await hub.invokeWithCapability(capability.token, {
+  action: tools[0]!.tool.action.id,
+  input: { q: 'is:unread' },
+})
+
+console.log(result)

package/examples/declarative-rest.ts

@@ -0,0 +1,27 @@
+import { declarativeRestConnector } from '@tangle-network/agent-integrations'
+
+export const statusApiConnector = declarativeRestConnector({
+  kind: 'status-api',
+  displayName: 'Status API',
+  description: 'Read service health from an internal status endpoint.',
+  auth: { kind: 'api-key', hint: 'Status API token.' },
+  category: 'other',
+  defaultConsistencyModel: 'authoritative',
+  baseUrl: 'https://status.example.com/api',
+  capabilities: [
+    {
+      name: 'services.get',
+      class: 'read',
+      description: 'Read one service status.',
+      parameters: {
+        type: 'object',
+        properties: { serviceId: { type: 'string' } },
+        required: ['serviceId'],
+      },
+      request: {
+        method: 'GET',
+        path: '/services/{serviceId}',
+      },
+    },
+  ],
+})

package/examples/first-party-adapter.ts

@@ -0,0 +1,32 @@
+import {
+  createConnectorAdapterProvider,
+  githubConnector,
+  type IntegrationConnection,
+  type ResolvedDataSource,
+} from '@tangle-network/agent-integrations'
+
+const provider = createConnectorAdapterProvider({
+  adapters: [githubConnector],
+  resolveDataSource,
+})
+
+const connectors = await provider.listConnectors()
+console.log(connectors.map((connector) => connector.id))
+
+async function resolveDataSource(connection: IntegrationConnection): Promise<ResolvedDataSource> {
+  return {
+    id: `source_${connection.id}`,
+    projectId: 'project_1',
+    publishedAgentId: null,
+    kind: connection.connectorId,
+    label: connection.connectorId,
+    consistencyModel: 'authoritative',
+    scopes: connection.grantedScopes,
+    metadata: {},
+    credentials: {
+      kind: 'api-key',
+      apiKey: process.env.GITHUB_TOKEN ?? '',
+    },
+    status: 'active',
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {
@@ -23,6 +23,7 @@
   "files": [
     "dist",
     "docs",
+    "examples",
     "README.md"
   ],
   "publishConfig": {