@squidcloud/cli 1.0.460 → 1.0.461

package/dist/resources/claude/skills/squid-integrations/reference/integration-catalog.md

@@ -0,0 +1,154 @@
+# Integration Type Catalog
+
+Complete catalog of all Squid integration types. Source of truth: `INTEGRATION_TYPES` from `@squidcloud/client`.
+
+```typescript
+import { IntegrationType, INTEGRATION_TYPES } from '@squidcloud/client';
+```
+
+## Databases (14 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `postgres` | PostgreSQL | host, port, database, user, password |
+| `mysql` | MySQL / MariaDB | host, port, database, user, password |
+| `mongo` | MongoDB | connectionString, password |
+| `mssql` | Microsoft SQL Server | host, port, database, user, password |
+| `snowflake` | Snowflake | account, database, schema, warehouse, user, password or privateKey |
+| `bigquery` | Google BigQuery | GCP credentials, dataset |
+| `dynamodb` | Amazon DynamoDB | region, accessKeyId, secretAccessKey |
+| `elasticsearch` | Elasticsearch | host, port, user, password |
+| `clickhouse` | ClickHouse | host, port, database, user, password |
+| `oracledb` | Oracle Database | host, port, database, user, password |
+| `cockroach` | CockroachDB | host, port, database, user, password |
+| `sap_hana` | SAP HANA | host, port, user, password |
+| `databricks` | Databricks | host, catalog, schemas, warehousePath |
+| `legend` | Legend metadata | GitLab PAT |
+| `built_in_db` | Built-in database (included free) | None |
+
+Additional database types (available as integration, no dedicated connector):
+- `mariadb` - MariaDB (separate from MySQL)
+- `alloydb` - Google AlloyDB
+- `cloudsql` - Google Cloud SQL
+- `cassandra` - Apache Cassandra
+- `db2` - IBM DB2
+- `documentdb` - AWS DocumentDB
+- `firestore` - Google Firestore
+- `spanner` - Google Cloud Spanner
+- `xata` - Xata database
+- `azure_cosmosdb` - Azure Cosmos DB
+- `azure_postgresql` - Azure PostgreSQL
+- `azure_sql` - Azure SQL
+- `redis` - Redis
+
+## Authentication (8 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `auth0` | Auth0 | Auto-discovered via JWKS |
+| `cognito` | Amazon Cognito | region, userPoolId, appClientId |
+| `okta` | Okta | domain, clientId |
+| `keycloak` | Keycloak | realm, JWKS URL |
+| `firebase_auth` | Firebase Authentication | projectId |
+| `jwt_rsa` | Custom JWT (RSA) | JWKS URI, optional audience/issuer |
+| `jwt_hmac` | Custom JWT (HMAC) | Optional verification URI |
+| `descope` | Descope | projectId |
+
+## SaaS Connectors (18 types with AI functions)
+
+| Type | Description | Key AI Functions |
+|------|-------------|------------------|
+| `slack` | Slack messaging | searchInSlack |
+| `jira` | Atlassian Jira | search, create, update issues |
+| `jira_jsm` | Jira Service Management | search, create, transition requests |
+| `zendesk` | Zendesk support | search tickets, get details |
+| `freshdesk` | Freshdesk support | search, create, reply to tickets |
+| `salesforce` | Salesforce CRM | CRUD for opportunities, cases, accounts, incidents |
+| `hubspot` | HubSpot CRM | search/get contacts and companies |
+| `github` | GitHub repos | search PRs/code, create/merge PRs, reviews |
+| `confluence` | Atlassian Confluence | searchInConfluence |
+| `google_calendar` | Google Calendar | listCalendarEvents |
+| `google_drive` | Google Drive | search, list documents |
+| `google_docs` | Google Docs | Access via Google Drive connector |
+| `linear` | Linear issues | search, create, update issues |
+| `servicenow_csm` | ServiceNow CSM | search cases, create, reply |
+| `teams` | Microsoft Teams | searchInTeams |
+| `sharepoint` | Microsoft SharePoint | search, list documents |
+| `onedrive` | Microsoft OneDrive | Access via SharePoint connector |
+| `mail` | Email (SMTP) | sendMailWithAi |
+| `monday` | Monday.com | Board and item management |
+| `active_directory` | Active Directory | User/group management |
+
+## Storage (6 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `s3` | Amazon S3 | bucket, region, accessKeyId, secretKey |
+| `gcs` | Google Cloud Storage | bucket, GCP credentials |
+| `azure_blob` | Azure Blob Storage | container, connectionString |
+| `built_in_s3` | Built-in S3 (AWS deployments) | None |
+| `built_in_gcs` | Built-in GCS (GCP deployments) | None |
+| `built_in_azure_blob` | Built-in Azure Blob (Azure deployments) | None |
+
+## Message Queues (3 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `kafka` | Apache Kafka | bootstrapServers, SASL credentials |
+| `confluent` | Confluent Cloud | Kafka-compatible configuration |
+| `built_in_queue` | Built-in queue (included free) | None |
+
+## API Integrations (2 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `api` | REST API (OpenAPI) | OpenAPI spec URL |
+| `graphql` | GraphQL endpoint | Base URL |
+
+## AI Providers (3 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `openai_compatible` | OpenAI-compatible chat models | Base URL, API key, model list |
+| `openai_compatible_embedding` | OpenAI-compatible embeddings | Base URL, API key, model list |
+| `bedrock` | AWS Bedrock | Region, API key, model list |
+
+Note: Standard AI providers (OpenAI, Anthropic, Gemini, Grok) are configured in Console AI Settings, not as integration types.
+
+## Agent Protocols (2 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `mcp` | MCP Server connection | Server URL, optional auth header |
+| `a2a` | Agent-to-Agent protocol | Agent URL, optional auth header |
+
+## Observability (3 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `datadog` | Datadog monitoring | API key, app key, region |
+| `newrelic` | New Relic APM | API key, region |
+| `sentry` | Sentry error tracking | Configuration via Console |
+
+## Search & Vector (2 types)
+
+| Type | Description | Config Required |
+|------|-------------|-----------------|
+| `algolia` | Algolia search | API key, app ID |
+| `pinecone` | Pinecone vector DB | API key, environment |
+
+## Special Types
+
+| Type | Description |
+|------|-------------|
+| `ai_agents` | Internal - AI agent management |
+| `ai_chatbot` | Internal - AI chatbot configuration |
+| `connected_knowledgebases` | Internal - Knowledge base connections |
+
+## Built-in Integrations (Free, No Setup)
+
+Every Squid app automatically includes:
+- `built_in_db` - NoSQL database
+- `built_in_queue` - Message queue
+- `built_in_s3` / `built_in_gcs` / `built_in_azure_blob` - Cloud-specific storage
+- **Essentials Connector** - AI search, URL extraction, short URLs, PDF creation, data extraction, matchmaking

package/dist/resources/claude/skills/squid-integrations/reference/integration-setup.md

@@ -0,0 +1,529 @@
+# Integration Setup via IAC API
+
+Integrations can be managed programmatically using the IAC REST API or the ManagementClient SDK.
+
+## IAC REST API
+
+Base URL: `https://console.getsquid.ai/iac/applications/{appId}/integrations`
+
+All requests require the `x-app-api-key` header.
+
+### Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/` | List all integrations |
+| GET | `/{integrationId}` | Get integration config |
+| PUT | `/{integrationId}` | Create or update integration |
+| DELETE | `/{integrationId}` | Delete integration |
+| POST | `/{integrationId}/discover-schema` | Discover database schema |
+| POST | `/{integrationId}/discover-graphql-schema` | Discover GraphQL schema |
+| POST | `/{integrationId}/discover-openapi-schema` | Discover OpenAPI schema |
+| POST | `/test-connection` | Test database connection |
+| POST | `/{integrationId}/schema/generate-ai-descriptions` | Generate AI descriptions for schema |
+| GET | `/{integrationId}/schema` | Get integration schema |
+| PUT | `/{integrationId}/schema` | Set integration schema |
+
+### ManagementClient SDK
+
+```typescript
+import { ManagementClient } from '@squidcloud/client';
+
+const mgmt = new ManagementClient({
+  apiKey: 'management-api-key',
+  orgId: 'your-org-id'
+});
+
+// Upsert integration
+await mgmt.upsertIntegration(appId, 'my-postgres', {
+  id: 'my-postgres',
+  type: 'postgres',
+  configuration: {
+    connectionOptions: {
+      host: 'db.example.com',
+      port: 5432,
+      database: 'mydb',
+      user: 'admin',
+      secrets: { password: 'SECRET_NAME' },
+      ssl: true
+    }
+  }
+});
+
+// Discover schema after connecting
+await mgmt.discoverDataConnectionSchema(appId, 'my-postgres');
+
+// Test connection
+await mgmt.testDataConnection(appId, {
+  id: 'test-pg',
+  type: 'postgres',
+  configuration: { connectionOptions: { /* ... */ } }
+});
+```
+
+## Configuration Examples by Integration Type
+
+### Authentication
+
+#### Auth0
+```json
+{
+  "id": "my-auth0",
+  "type": "auth0"
+}
+```
+Auth0 configuration is auto-discovered via JWKS. Set the Auth0 domain in Console.
+
+#### Cognito
+```json
+{
+  "id": "my-cognito",
+  "type": "cognito",
+  "configuration": {
+    "region": "us-east-1",
+    "userPoolId": "us-east-1_xxxxxx",
+    "appClientId": "your-app-client-id"
+  }
+}
+```
+
+#### Okta
+```json
+{
+  "id": "my-okta",
+  "type": "okta",
+  "configuration": {
+    "domain": "your-domain.okta.com",
+    "clientId": "your-client-id"
+  }
+}
+```
+
+#### JWT RSA
+```json
+{
+  "id": "my-jwt",
+  "type": "jwt_rsa",
+  "configuration": {
+    "jwksUri": "https://your-auth-server/.well-known/jwks.json",
+    "audience": "your-api-audience",
+    "issuer": "https://your-auth-server/"
+  }
+}
+```
+
+#### Firebase Auth
+```json
+{
+  "id": "my-firebase",
+  "type": "firebase_auth",
+  "configuration": {
+    "projectId": "your-firebase-project-id"
+  }
+}
+```
+
+### Databases
+
+#### PostgreSQL
+```json
+{
+  "id": "my-postgres",
+  "type": "postgres",
+  "configuration": {
+    "connectionOptions": {
+      "host": "db.example.com",
+      "port": 5432,
+      "database": "mydb",
+      "user": "admin",
+      "secrets": { "password": "PG_PASSWORD_SECRET" },
+      "ssl": true
+    }
+  }
+}
+```
+
+#### MongoDB
+```json
+{
+  "id": "my-mongo",
+  "type": "mongo",
+  "configuration": {
+    "connectionOptions": {
+      "connectionString": "mongodb+srv://...",
+      "secrets": { "password": "MONGO_PASSWORD_SECRET" }
+    }
+  }
+}
+```
+
+#### MySQL
+```json
+{
+  "id": "my-mysql",
+  "type": "mysql",
+  "configuration": {
+    "connectionOptions": {
+      "host": "db.example.com",
+      "port": 3306,
+      "database": "mydb",
+      "user": "admin",
+      "secrets": { "password": "MYSQL_PASSWORD_SECRET" }
+    }
+  }
+}
+```
+
+#### Snowflake
+```json
+{
+  "id": "my-snowflake",
+  "type": "snowflake",
+  "configuration": {
+    "connectionOptions": {
+      "account": "your-account",
+      "database": "MY_DB",
+      "schema": "PUBLIC",
+      "warehouse": "COMPUTE_WH",
+      "user": "admin",
+      "secrets": { "password": "SNOWFLAKE_PASSWORD_SECRET" }
+    }
+  }
+}
+```
+
+#### DynamoDB
+```json
+{
+  "id": "my-dynamodb",
+  "type": "dynamodb",
+  "configuration": {
+    "connectionOptions": {
+      "region": "us-east-1",
+      "secrets": {
+        "accessKeyId": "AWS_ACCESS_KEY_SECRET",
+        "secretAccessKey": "AWS_SECRET_KEY_SECRET"
+      }
+    }
+  }
+}
+```
+
+### SaaS Connectors
+
+#### Slack
+```json
+{
+  "id": "my-slack",
+  "type": "slack",
+  "configuration": {
+    "appId": "A12345678",
+    "secrets": {
+      "botUserAuthToken": "SLACK_BOT_TOKEN_SECRET",
+      "signingSecret": "SLACK_SIGNING_SECRET",
+      "clientSecret": "SLACK_CLIENT_SECRET",
+      "verificationToken": "SLACK_VERIFICATION_TOKEN_SECRET"
+    }
+  }
+}
+```
+
+#### Jira
+```json
+{
+  "id": "my-jira",
+  "type": "jira",
+  "configuration": {
+    "domain": "your-company.atlassian.net",
+    "email": "admin@company.com",
+    "secrets": { "apiKey": "JIRA_API_KEY_SECRET" },
+    "indexIssues": true,
+    "selectedProjectKeys": ["PROJ1", "PROJ2"],
+    "issueHistoryDays": 90
+  }
+}
+```
+
+#### Zendesk
+```json
+{
+  "id": "my-zendesk",
+  "type": "zendesk",
+  "configuration": {
+    "subdomain": "your-company",
+    "email": "admin@company.com",
+    "secrets": { "apiToken": "ZENDESK_TOKEN_SECRET" }
+  }
+}
+```
+
+#### GitHub
+```json
+{
+  "id": "my-github",
+  "type": "github",
+  "configuration": {
+    "appId": "123456",
+    "installationId": "789012",
+    "secrets": {
+      "privateKey": "GITHUB_PRIVATE_KEY_SECRET",
+      "webhookSecret": "GITHUB_WEBHOOK_SECRET"
+    }
+  }
+}
+```
+
+#### Salesforce
+```json
+{
+  "id": "my-salesforce",
+  "type": "salesforce",
+  "configuration": {
+    "instanceDomain": "your-company.my.salesforce.com",
+    "secrets": {
+      "consumerKey": "SF_CONSUMER_KEY_SECRET",
+      "consumerSecret": "SF_CONSUMER_SECRET_SECRET"
+    }
+  }
+}
+```
+
+#### HubSpot
+```json
+{
+  "id": "my-hubspot",
+  "type": "hubspot",
+  "configuration": {
+    "secrets": { "accessToken": "HUBSPOT_TOKEN_SECRET" }
+  }
+}
+```
+
+#### Mail (SMTP)
+```json
+{
+  "id": "my-mail",
+  "type": "mail",
+  "configuration": {
+    "host": "smtp.gmail.com",
+    "port": 587,
+    "user": "noreply@company.com",
+    "encryption": "tls",
+    "secrets": { "password": "SMTP_PASSWORD_SECRET" }
+  }
+}
+```
+
+#### Linear
+```json
+{
+  "id": "my-linear",
+  "type": "linear",
+  "configuration": {
+    "secrets": { "apiKey": "LINEAR_API_KEY_SECRET" },
+    "indexIssues": true,
+    "selectedTeamIds": ["team-id-1"],
+    "issueHistoryDays": 90
+  }
+}
+```
+
+#### Freshdesk
+```json
+{
+  "id": "my-freshdesk",
+  "type": "freshdesk",
+  "configuration": {
+    "subdomain": "your-company",
+    "secrets": { "apiKey": "FRESHDESK_API_KEY_SECRET" },
+    "indexTickets": true,
+    "ticketHistoryDays": 90
+  }
+}
+```
+
+### Storage
+
+#### Amazon S3
+```json
+{
+  "id": "my-s3",
+  "type": "s3",
+  "configuration": {
+    "bucket": "my-bucket",
+    "region": "us-east-1",
+    "secrets": {
+      "accessKeyId": "S3_ACCESS_KEY_SECRET",
+      "secretKey": "S3_SECRET_KEY_SECRET"
+    }
+  }
+}
+```
+
+#### Google Cloud Storage
+```json
+{
+  "id": "my-gcs",
+  "type": "gcs",
+  "configuration": {
+    "bucket": "my-bucket",
+    "secrets": { "credentials": "GCS_CREDENTIALS_JSON_SECRET" }
+  }
+}
+```
+
+#### Azure Blob Storage
+```json
+{
+  "id": "my-azure-blob",
+  "type": "azure_blob",
+  "configuration": {
+    "container": "my-container",
+    "secrets": { "connectionString": "AZURE_BLOB_CONNECTION_STRING_SECRET" }
+  }
+}
+```
+
+### Message Queues
+
+#### Kafka
+```json
+{
+  "id": "my-kafka",
+  "type": "kafka",
+  "configuration": {
+    "connectionOptions": {
+      "bootstrapServers": "kafka1:9092,kafka2:9092",
+      "secrets": {
+        "saslUsername": "KAFKA_USER_SECRET",
+        "saslPassword": "KAFKA_PASSWORD_SECRET"
+      }
+    }
+  }
+}
+```
+
+### API Integrations
+
+#### REST API (OpenAPI)
+```json
+{
+  "id": "my-api",
+  "type": "api",
+  "configuration": {
+    "discoveryOptions": {
+      "openApiSpecUrl": "https://api.example.com/openapi.json"
+    },
+    "exposeAsMcpServer": false
+  }
+}
+```
+
+#### GraphQL
+```json
+{
+  "id": "my-graphql",
+  "type": "graphql",
+  "configuration": {
+    "connectionOptions": {
+      "baseUrl": "https://api.example.com/graphql"
+    }
+  }
+}
+```
+
+### AI Providers
+
+#### OpenAI-Compatible
+```json
+{
+  "id": "my-llm",
+  "type": "openai_compatible",
+  "configuration": {
+    "baseUrl": "https://api.your-llm.com/v1",
+    "secrets": { "apiKey": "LLM_API_KEY_SECRET" },
+    "models": ["model-name-1", "model-name-2"]
+  }
+}
+```
+
+#### AWS Bedrock
+```json
+{
+  "id": "my-bedrock",
+  "type": "bedrock",
+  "configuration": {
+    "region": "us-east-1",
+    "secrets": { "apiKey": "BEDROCK_API_KEY_SECRET" },
+    "models": ["anthropic.claude-3-sonnet"]
+  }
+}
+```
+
+### Agent Protocols
+
+#### MCP Server
+```json
+{
+  "id": "my-mcp",
+  "type": "mcp",
+  "configuration": {
+    "url": "https://mcp-server.example.com",
+    "authorizationHeader": "Bearer TOKEN"
+  }
+}
+```
+
+#### A2A (Agent-to-Agent)
+```json
+{
+  "id": "my-a2a",
+  "type": "a2a",
+  "configuration": {
+    "url": "https://a2a-agent.example.com",
+    "authorizationHeader": "Bearer TOKEN"
+  }
+}
+```
+
+### Observability
+
+#### Datadog
+```json
+{
+  "id": "my-datadog",
+  "type": "datadog",
+  "configuration": {
+    "region": "us1",
+    "secrets": {
+      "apiKey": "DD_API_KEY_SECRET",
+      "appKey": "DD_APP_KEY_SECRET"
+    }
+  }
+}
+```
+
+#### New Relic
+```json
+{
+  "id": "my-newrelic",
+  "type": "newrelic",
+  "configuration": {
+    "region": "worldwide",
+    "secrets": { "apiKey": "NR_API_KEY_SECRET" }
+  }
+}
+```
+
+## Secrets Management
+
+Integration secrets are stored securely in Squid. The values in the `secrets` fields are **secret names** (references), not the actual secret values. Set secret values in Squid Console > Your App > Secrets, or via the Secrets IAC API:
+
+```
+PUT /iac/applications/{appId}/secrets/{secretName}
+```
+
+```typescript
+// Via ManagementClient
+await mgmt.setSecret(appId, 'PG_PASSWORD_SECRET', 'actual-password-value');
+```

package/dist/resources/claude/skills/squid-react-development/SKILL.md

@@ -17,6 +17,8 @@ This skill provides comprehensive, code-verified knowledge about developing Reac
 
 **Key Point:** `@squidcloud/react` provides partial hooks for common operations. For any functionality not covered by a dedicated hook, use `useSquid()` to access the full Squid client SDK.
 
+**IMPORTANT:** Never invoke LLMs directly (e.g., importing `openai` or `@anthropic-ai/sdk`). Use Squid AI hooks (`useAiAgent`, `useAiChat`) or `squid.ai().agent()`. For external service integrations (email, Slack, Jira, etc.), use Squid's built-in integrations - see `squid-integrations` skill.
+
 ## Installation
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/cli",
-  "version": "1.0.460",
+  "version": "1.0.461",
   "description": "The Squid CLI",
   "main": "dist/index.js",
   "scripts": {
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@squidcloud/local-backend": "^1.0.460",
+    "@squidcloud/local-backend": "^1.0.461",
     "adm-zip": "^0.5.16",
     "copy-webpack-plugin": "^12.0.2",
     "decompress": "^4.2.1",