@squidcloud/cli 1.0.435 → 1.0.437

package/dist/index.js

@@ -2156,6 +2156,7 @@ exports.KOTLIN_CONTROLLERS = [
     'integration',
     'internal-storage',
     'internalCodeExecutor',
+    'management-secret',
     'mutation',
     'native-query',
     'observability',
@@ -11632,7 +11633,7 @@ exports.CONNECTOR_IDS = [
     'linear',
     'mail',
     'salesforce',
-    'servicenow',
+    'servicenow_csm',
     'slack',
     'teams',
     'zendesk',
@@ -22085,12 +22086,8 @@ if (hasToStringTag && gOPD && getProto) {
 				// @ts-expect-error TS won't narrow inside a closure
 				descriptor = gOPD(superProto, Symbol.toStringTag);
 			}
-			if (descriptor && descriptor.get) {
-				var bound = callBind(descriptor.get);
-				cache[
-					/** @type {`$${import('.').TypedArrayName}`} */ ('$' + typedArray)
-				] = bound;
-			}
+			// @ts-expect-error TODO: fix
+			cache['$' + typedArray] = callBind(descriptor.get);
 		}
 	});
 } else {
@@ -22098,13 +22095,12 @@ if (hasToStringTag && gOPD && getProto) {
 		var arr = new g[typedArray]();
 		var fn = arr.slice || arr.set;
 		if (fn) {
-			var bound = /** @type {import('./types').BoundSlice | import('./types').BoundSet} */ (
+			cache[
+				/** @type {`$${import('.').TypedArrayName}`} */ ('$' + typedArray)
+			] = /** @type {import('./types').BoundSlice | import('./types').BoundSet} */ (
 				// @ts-expect-error TODO FIXME
 				callBind(fn)
 			);
-			cache[
-				/** @type {`$${import('.').TypedArrayName}`} */ ('$' + typedArray)
-			] = bound;
 		}
 	});
 }
@@ -23700,11 +23696,11 @@ exports.INTEGRATION_TYPES = [
     'salesforce_crm',
     'sap_hana',
     'sentry',
-    'servicenow',
     'snowflake',
     'spanner',
     'xata',
     'zendesk',
+    'servicenow_csm',
     'freshdesk',
     'mail',
     'slack',
@@ -30670,7 +30666,7 @@ function exitWithError(...messages) {
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.435","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.435","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@squidcloud/cli","version":"1.0.437","description":"The Squid CLI","main":"dist/index.js","scripts":{"start":"node dist/index.js","start-ts":"ts-node -r tsconfig-paths/register src/index.ts","prebuild":"rimraf dist","build":"webpack --mode=production","build:dev":"webpack --mode=development","lint":"eslint","link":"npm run build && chmod 755 dist/index.js && npm link","watch":"webpack --watch","deploy":"npm run build && npm pack --silent | xargs -I {} mv {} package.tgz && npm install -g package.tgz && rm -rf package.tgz","publish:public":"npm run build && npm publish --access public"},"files":["dist/**/*"],"bin":{"squid":"dist/index.js"},"keywords":[],"author":"","license":"ISC","engines":{"node":">=18.0.0"},"dependencies":{"@squidcloud/local-backend":"^1.0.437","adm-zip":"^0.5.16","copy-webpack-plugin":"^12.0.2","decompress":"^4.2.1","nodemon":"^3.1.9","terser-webpack-plugin":"^5.3.10","ts-loader":"^9.5.1","ts-node":"^10.9.2","tsconfig-paths":"^4.2.0","tsconfig-paths-webpack-plugin":"^4.1.0","webpack":"^5.101.3","zip-webpack-plugin":"^4.0.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/decompress":"^4.2.7","@types/node":"^20.19.9","terminal-link":"^3.0.0"}}');
 
 /***/ },
 

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

@@ -195,54 +195,136 @@ await integrations.upsertIntegration({
 });
 ```
 
-**Key point:** The Console provides a visual interface for management, but everything (except org/app creation) can be automated through the SDK for more flexibility and control.
+**Key point:** The Console provides a visual interface for management, and everything can be automated through the SDK for more flexibility and control. For organization and application management, use the **ManagementClient** (see below).
+
+### 4. ManagementClient (Programmatic Org/App Management)
+
+**What it is:** A specialized client for programmatically managing Squid organizations and applications using management API keys.
+
+**How it works:**
+- Uses management API keys (created in Console Profile Settings)
+- Provides methods to create organizations and applications
+- Works independently of the main Squid client
+- Authenticated via management API key (starts with `squid_mgmt_`)
+
+**Creating Management API Keys:**
+1. Go to Squid Console → Profile Settings → API Keys
+2. Click "Create API Key"
+3. Copy the key value (shown only once)
+4. Key format: `squid_mgmt_<uuid>`
+
+**Usage:**
+
+```typescript
+import { ManagementClient } from '@squidcloud/client';
+
+// Initialize with management API key
+const client = new ManagementClient({
+  apiKey: 'squid_mgmt_xxx...',  // From Console Profile Settings
+  region: 'us-east-1.aws'       // Your Squid region
+});
+
+// Create an organization
+const { organizationId } = await client.createOrganization({
+  name: 'My Organization'  // 2-50 characters
+});
+console.log('Created org:', organizationId);
+
+// Create an application in the organization
+const { appId } = await client.createApplication({
+  organizationId,
+  name: 'My Application',
+  cloudId: 'aws',          // 'aws' | 'gcp' | 'azure'
+  region: 'us-east-1'      // Cloud region (e.g., 'us-east-1', 'us-central1')
+});
+console.log('Created app:', appId);
+
+// Delete an application
+await client.deleteApplication({ appId });
+```
+
+**Available Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `createOrganization({ name })` | Creates a new organization. User becomes admin. |
+| `createApplication({ organizationId, name, cloudId, region })` | Creates an application in an organization. |
+| `deleteApplication({ appId })` | Deletes an application. Requires admin role. |
+
+**TypeScript Types:**
+
+```typescript
+import {
+  ManagementClient,
+  ManagementClientOptions,
+  ManagementCloudId,              // 'aws' | 'gcp' | 'azure'
+  ManagementCreateOrganizationRequest,
+  ManagementCreateOrganizationResponse,
+  ManagementCreateApplicationRequest,
+  ManagementCreateApplicationResponse,
+  ManagementDeleteApplicationRequest
+} from '@squidcloud/client';
+```
+
+**Key Points:**
+- Management API keys are tied to a user account
+- The user associated with the key becomes the organization admin
+- Keys can be suspended/reactivated/deleted in Console Profile Settings
+- Different from app API keys (which bypass security rules)
+- Use for CI/CD pipelines, automation scripts, and programmatic management
+
+**Use Cases:**
+- Automated tenant provisioning (multi-tenant SaaS)
+- CI/CD pipeline integration
+- Infrastructure-as-code workflows
+- Programmatic organization management
+- Automated testing environments
 
 ### How They Work Together
 
 ```
-┌─────────────────────┐
-│   CLIENT (Web/     │
-│   Mobile/Server)    │
-│                     │
-│  - Squid SDK init   │
-│  - User auth        │
-│  - Limited access   │
-└──────────┬──────────┘
-           │
-           │ HTTP/WebSocket
-           │
-           ▼
-┌─────────────────────┐
-│  SQUID BACKEND      │
-│  (Your Code)        │
-│                     │
-│  - SquidService     │
-│  - Decorators       │
-│  - Full permissions │
-│  - Business logic   │
-│  - Security rules   │
-└──────────┬──────────┘
-           │
-           │ Deployed via CLI
-           │ or managed via
-           ▼
-┌─────────────────────┐
-│  SQUID CONSOLE      │
-│  (Web UI)           │
-│                     │
-│  - Manage apps      │
-│  - AI Studio        │
-│  - Integrations     │
-│  - Monitoring       │
-└─────────────────────┘
+┌─────────────────────┐     ┌─────────────────────┐
+│   CLIENT (Web/      │     │  MANAGEMENT CLIENT  │
+│   Mobile/Server)    │     │  (Automation)       │
+│                     │     │                     │
+│  - Squid SDK init   │     │  - ManagementClient │
+│  - User auth        │     │  - Management API   │
+│  - Limited access   │     │    key auth         │
+└──────────┬──────────┘     │  - Create orgs/apps │
+           │                └──────────┬──────────┘
+           │                           │
+           │ HTTP/WebSocket            │ HTTP
+           │                           │
+           ▼                           ▼
+┌─────────────────────────────────────────────────┐
+│                 SQUID BACKEND                    │
+│                 (Your Code)                      │
+│                                                  │
+│  - SquidService          - Decorators           │
+│  - Full permissions      - Business logic       │
+│  - Security rules        - Webhooks             │
+└──────────────────────────┬──────────────────────┘
+                           │
+                           │ Deployed via CLI
+                           │ or managed via
+                           ▼
+┌─────────────────────────────────────────────────┐
+│                  SQUID CONSOLE                   │
+│                  (Web UI)                        │
+│                                                  │
+│  - Manage apps           - AI Studio            │
+│  - Integrations          - Monitoring           │
+│  - Management API Keys   - Profile Settings     │
+└─────────────────────────────────────────────────┘
 ```
 
 **Development workflow:**
-1. Create application in **Squid Console**
+1. Create application in **Squid Console** (or programmatically via **ManagementClient**)
 2. Develop backend services in **Squid Backend** (local development with `squid start`)
 3. Deploy backend to Squid infrastructure (`squid deploy`)
 4. Build **Client** applications that use the Squid Client SDK
 5. Use **Console** for monitoring and management, or use **SDK** for programmatic control
+6. Use **ManagementClient** for automated org/app provisioning (CI/CD, multi-tenant SaaS)
 
 ## CLI Commands
 
@@ -1485,7 +1567,6 @@ const result = await squid.ai().executeAiQuery(
   'Show me all active users who registered last month',
   {
     instructions: 'Only query the users collection',
-    generateWalkthrough: true, // Get step-by-step explanation
     enableRawResults: true,     // Include raw query results
     selectCollectionsOptions: {
       collectionsToUse: ['users'] // Limit to specific collections

package/package.json

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