@superglue/cli 1.1.10 → 1.1.12

package/dist/dist/skills/superglue/references/transforms-and-output.md

@@ -0,0 +1,92 @@
+# Transforms & Output Shaping
+
+Covers transform steps, output transforms, and response filters.
+
+## Three Transformation Points
+
+| Point                            | When it runs             | Purpose                              |
+| -------------------------------- | ------------------------ | ------------------------------------ |
+| `dataSelector`                   | Before step executes     | Controls input + single vs loop mode |
+| Transform step (`transformCode`) | As the step itself       | Reshape data between request steps   |
+| `outputTransform`                | After all steps complete | Shape final tool output              |
+
+## Transform Steps
+
+Use when you need intermediate data reshaping that can't wait until outputTransform (because a subsequent request step needs the data).
+
+```typescript
+{
+  id: "formatForInsert",
+  config: {
+    type: "transform",
+    transformCode: "(sourceData) => sourceData.getCustomers.data.map(c => ({ id: c.id, name: c.fullName }))"
+  }
+}
+```
+
+Transform steps do NOT have: systemId, url, method, headers, body, queryParams, or pagination.
+
+Results are wrapped in the **same envelope** as request steps:
+
+```javascript
+sourceData.formatForInsert = { currentItem: <dataSelector output>, data: <transformCode result>, success: true }
+```
+
+If the step has a dataSelector returning an array, the transform runs once per item.
+
+### When to Use
+
+- Data needed by a subsequent request step (can't defer to outputTransform)
+- Aggregating/combining results from multiple previous steps
+- Complex filtering or restructuring between API calls
+- Preparing data in a specific format for the next step
+
+### When NOT to Use
+
+- Simple input selection → use `dataSelector` instead
+- Final output shaping → use `outputTransform` instead
+- Simple filtering within a single step → use `dataSelector` returning a filtered array
+- As the final step before the outputTransform → merge into outputTransform code
+
+## Output Transform
+
+Final transformation shaping the tool's output. Runs after all steps complete.
+
+Access patterns depend on how the step was executed:
+
+- **Object-selector step**: `sourceData.stepId.data` — single envelope
+- **Array-selector (loop) step**: `sourceData.stepId.map(i => i.data)` — array of envelopes
+
+```javascript
+// Object-selector step — single result
+sourceData.getUsers.data; // the API response
+sourceData.getUsers.data.results; // nested field
+
+// Array-selector (loop) step — array of results
+sourceData.fetchDetails.map((i) => i.data); // all responses
+sourceData.fetchDetails.flatMap((i) => i.data.items); // nested arrays
+sourceData.fetchDetails.filter((i) => i.success).map((i) => i.data); // only successes
+```
+
+Payload fields are at root level — **NEVER** use `sourceData.payload.*`.
+
+### Requirements
+
+- Function signature: `(sourceData) => { ... }`
+- **Must have a return statement**
+- Pure synchronous — no async/await, no side effects
+- Handle missing data with `?.` and defaults
+- Validate arrays with `Array.isArray()` before array methods
+- Throw when expected required data is missing (enables self-healing)
+- NEVER include newlines or tabs in the code string
+
+## JS Code Constraints (all transform points)
+
+Runs in `isolated-vm` sandbox:
+
+- 4096 MB memory limit, 10s timeout (transforms/selectors), 3s timeout (pagination stops)
+- Synchronous only — no async/await, no Promises, no setTimeout
+- No side effects — no network, filesystem, or console access
+- No external dependencies — only standard JS built-ins (Array, Object, String, Math, Date, JSON, etc.)
+- JSON-serializable I/O only
+- Must return a value (undefined returns null)

package/dist/skills/superglue/SKILL.md

@@ -550,7 +550,7 @@ Templates auto-populate endpoints and OAuth config. Use `sg system find` to disc
 
 ### OAuth Flow
 
-**IMPORTANT:** For OAuth systems, always use `--template` when creating the system. Templates auto-configure OAuth URLs, token exchange settings, and scopes. Without a template, OAuth will likely fail or require manual credential setup.
+**IMPORTANT:** For OAuth systems, prefer `--template` when available because it auto-configures OAuth URLs and defaults. OAuth also works without a template if you provide required credentials (for example `client_id`, `auth_url`, and `token_url`) manually.
 
 If you don't know the template ID, the CLI auto-detects it from the URL — but using `--template` explicitly is more reliable.
 
@@ -574,7 +574,7 @@ sg system oauth --system-id gmail --scopes "https://www.googleapis.com/auth/gmai
 
 **Step 3:** User authenticates in browser → tokens saved automatically
 
-**Common OAuth templates:** gmail, google_drive, google_calendar, google_sheets, slack, salesforce, github, jira, confluence, notion, airtable, hubspot, shopify, dropbox, zoom, microsoft_365
+**Common OAuth templates:** gmail, googleDrive, googleCalendar, googleSheets, slack, salesforce, github, jira, confluence, notion, airtable, hubspot, shopify, dropbox, zoom, microsoft
 
 ### System IDs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superglue/cli",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "bin": {
     "sg": "./dist/cli.js"
   },
@@ -15,7 +15,6 @@
     "fast-json-patch": "^3.1.1"
   },
   "devDependencies": {
-    "@superglue/shared": "file:../shared",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"

package/skills/superglue/SKILL.md

@@ -550,7 +550,7 @@ Templates auto-populate endpoints and OAuth config. Use `sg system find` to disc
 
 ### OAuth Flow
 
-**IMPORTANT:** For OAuth systems, always use `--template` when creating the system. Templates auto-configure OAuth URLs, token exchange settings, and scopes. Without a template, OAuth will likely fail or require manual credential setup.
+**IMPORTANT:** For OAuth systems, prefer `--template` when available because it auto-configures OAuth URLs and defaults. OAuth also works without a template if you provide required credentials (for example `client_id`, `auth_url`, and `token_url`) manually.
 
 If you don't know the template ID, the CLI auto-detects it from the URL — but using `--template` explicitly is more reliable.
 
@@ -574,7 +574,7 @@ sg system oauth --system-id gmail --scopes "https://www.googleapis.com/auth/gmai
 
 **Step 3:** User authenticates in browser → tokens saved automatically
 
-**Common OAuth templates:** gmail, google_drive, google_calendar, google_sheets, slack, salesforce, github, jira, confluence, notion, airtable, hubspot, shopify, dropbox, zoom, microsoft_365
+**Common OAuth templates:** gmail, googleDrive, googleCalendar, googleSheets, slack, salesforce, github, jira, confluence, notion, airtable, hubspot, shopify, dropbox, zoom, microsoft
 
 ### System IDs