@superglue/cli 1.1.203 → 1.1.205
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +6 -7
- package/dist/cli.js +216 -215
- package/dist/skills/superglue/SKILL.md +73 -72
- package/dist/skills/superglue/references/access-rules.md +22 -27
- package/dist/skills/superglue/references/graphql.md +2 -6
- package/dist/skills/superglue/references/http.md +3 -3
- package/dist/skills/superglue/references/mongodb.md +1 -1
- package/dist/skills/superglue/references/mssql.md +4 -4
- package/dist/skills/superglue/references/odbc.md +1 -1
- package/dist/skills/superglue/references/postgres.md +1 -1
- package/dist/skills/superglue/references/redis.md +1 -1
- package/dist/skills/superglue/references/sftp-smb.md +5 -5
- package/dist/skills/superglue/references/suitecloud.md +1 -1
- package/dist/skills/superglue/references/superglue-info.md +4 -5
- package/package.json +1 -1
- package/skills/superglue/SKILL.md +73 -72
- package/skills/superglue/references/access-rules.md +22 -27
- package/skills/superglue/references/graphql.md +2 -6
- package/skills/superglue/references/http.md +3 -3
- package/skills/superglue/references/mongodb.md +1 -1
- package/skills/superglue/references/mssql.md +4 -4
- package/skills/superglue/references/odbc.md +1 -1
- package/skills/superglue/references/postgres.md +1 -1
- package/skills/superglue/references/redis.md +1 -1
- package/skills/superglue/references/sftp-smb.md +5 -5
- package/skills/superglue/references/suitecloud.md +1 -1
- package/skills/superglue/references/superglue-info.md +4 -5
|
@@ -13,9 +13,9 @@ FTP, SFTP, and SMB share an identical operation interface. Only the URL protocol
|
|
|
13
13
|
}
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
Configure the connection URL based on the selected
|
|
16
|
+
Configure the connection URL based on the selected connection's secrets — use `sg system find` to inspect the available secret names and reference them accordingly.
|
|
17
17
|
|
|
18
|
-
`<<systemId_url>>` resolves to the selected
|
|
18
|
+
`<<systemId_url>>` resolves to the selected connection's `url`. Use it as the full connection string when each tenant has its own host; set it with `sg system connection set --url`.
|
|
19
19
|
|
|
20
20
|
`method`, `headers`, `queryParams`, and `pagination` are HTTP-only fields — omit them for file server steps.
|
|
21
21
|
|
|
@@ -63,11 +63,11 @@ Credentials are embedded in the connection URL using `<<systemId_credentialKey>>
|
|
|
63
63
|
sftp://<<my_server_username>>:<<my_server_password>>@host/path
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
**SFTP private key auth:**
|
|
66
|
+
**SFTP private key auth:** store `privateKey` and `passphrase` as secrets on the connection instead of URL password placeholders.
|
|
67
67
|
|
|
68
68
|
**SMB domain auth:** use `domain\user` format in the URL, or store `domain` as a system credential.
|
|
69
69
|
|
|
70
|
-
|
|
70
|
+
Store these secrets on the connection: `host`, `port`, `username`, `password`, `privateKey`, `passphrase`, `domain` (SMB), `home_dir`. Paths and share names belong in the URL, not in credentials.
|
|
71
71
|
|
|
72
72
|
## File Server Runtime Details
|
|
73
73
|
|
|
@@ -158,6 +158,6 @@ When a file server step fails and the cause is not obvious:
|
|
|
158
158
|
3. **Check path resolution** — if you get "file not found", verify the path is relative to the URL base path, not an absolute filesystem path. Use `list` on the parent directory to see what files exist.
|
|
159
159
|
4. **Check permissions** — permission denied errors mean the user account lacks read/write access to the target path. Verify with the user that the account has the required grants.
|
|
160
160
|
5. **Check protocol-specific issues:**
|
|
161
|
-
- **SFTP**: if the error mentions authentication, verify whether the server expects password or private key auth. If using private key, ensure `privateKey` and `passphrase` are stored as secrets
|
|
161
|
+
- **SFTP**: if the error mentions authentication, verify whether the server expects password or private key auth. If using private key, ensure `privateKey` and `passphrase` are stored as secrets on the connection.
|
|
162
162
|
- **FTP/FTPS**: if the connection fails, try switching between `ftp://` and `ftps://` — some servers require TLS, others don't support it.
|
|
163
163
|
- **SMB**: verify the share name is correct (first path segment). If using domain auth, ensure the domain is included in the URL or stored as a secret. Check that the SMB port (445) is accessible.
|
|
@@ -36,7 +36,7 @@ sg system call --system-id netsuite \
|
|
|
36
36
|
|
|
37
37
|
### Login
|
|
38
38
|
|
|
39
|
-
The step logs in with the
|
|
39
|
+
The step logs in with the connection's NetSuite OAuth token, the same one the REST steps use. It runs as the user and role that connected NetSuite. The role needs the permissions **Log in using OAuth 2.0 Access Tokens**, **REST Web Services**, and **SuiteCloud Development Framework**; the standard Developer role has them. The integration record needs **REST Web Services** and **RESTlets** checked, and the sign-in needs the scopes `rest_webservices` and `restlets`. Nothing else is stored on the connection.
|
|
40
40
|
|
|
41
41
|
## Operations
|
|
42
42
|
|
|
@@ -44,11 +44,11 @@ Users can generate and manage API keys on the standalone **API Keys** page (`/ap
|
|
|
44
44
|
|
|
45
45
|
Each key carries an access scope, set at creation and editable later. A scope is a surface plus an action: the surfaces are **API & CLI** (everything except MCP, including the agent and the CLI) and **MCP** (assistants connected over MCP), and the actions are **read**, **write**, and **execute**. Writing covers creating, changing, and deleting. Executing covers running tools and talking to the agent, so a key with only read and write cannot run anything. MCP requests are always tool calls, so that surface only takes execute. Keys created before scoping keep full access. A scope only narrows a key; it never grants more than the owner's role permissions. A scoped key cannot reach the API keys endpoints at all, so it can neither widen itself nor read another key's value. Full access is therefore its own choice at creation, not the result of selecting every surface: a key that holds every scope is still a scoped key and still cannot manage API keys. A request outside the scope returns 403.
|
|
46
46
|
|
|
47
|
-
Two limits are worth stating plainly. Execute reaches the agent, and the agent's own tools create and edit
|
|
47
|
+
Two limits are worth stating plainly. Execute reaches the agent, and the agent's own tools create and edit connections, tools, and roles, so an execute scope is not a run-only scope — only the owner's role permissions bound it. And scopes apply to API keys alone: an MCP client that connects through OAuth instead of a key is unscoped and carries the user's full authority.
|
|
48
48
|
|
|
49
49
|
## Interfaces
|
|
50
50
|
|
|
51
|
-
- **Web app** — primary UI for building, testing, and managing tools and
|
|
51
|
+
- **Web app** — primary UI for building, testing, and managing tools and connections
|
|
52
52
|
- **TypeScript/Python SDK** — https://superglue.ai/docs/sdk/overview/
|
|
53
53
|
- **REST API** — https://superglue.ai/docs/api/
|
|
54
54
|
- **MCP Server** — https://superglue.ai/docs/mcp/using-the-mcp/
|
|
@@ -76,7 +76,7 @@ If a customer's system requires IP allowlisting for firewall rules, security gro
|
|
|
76
76
|
|
|
77
77
|
Use this section as the source of truth for high-level web app navigation. Do not invent UI locations that are not listed here.
|
|
78
78
|
|
|
79
|
-
Brain contains context-source setup, playbooks, artifacts, and files. Capabilities contains
|
|
79
|
+
Brain contains context-source setup, playbooks, artifacts, and files. Capabilities contains tools, connections, MCP servers, and schedules; tools are project-attachable, the others configure execution. A system is only the system ID that groups connections and tool steps. Projects are managed separately and group selected context and capabilities without changing RBAC.
|
|
80
80
|
|
|
81
81
|
The persistent left sidebar contains these top-level items:
|
|
82
82
|
|
|
@@ -88,8 +88,7 @@ The persistent left sidebar contains these top-level items:
|
|
|
88
88
|
- **Files** (`/files`) — uploaded source material.
|
|
89
89
|
- **Capabilities** — expandable group for connected and executable resources:
|
|
90
90
|
- **Tools** (`/tools`, detail at `/tools/{toolId}`) — saved tools; opens the tool playground for editing, testing, and running.
|
|
91
|
-
- **
|
|
92
|
-
- **Credentials** (`/credentials`) — manage the credentials you own for each system, and the credentials shared with you. Admins and members open it inside the normal app shell from the sidebar. API keys are not managed here.
|
|
91
|
+
- **Connections** (`/connections`, detail at `/connections/{connectionId}`) — connections to external services, grouped by system id, with secret status per connection; yours and the ones shared with you. A system ID is a namespace derived from existing connections; no system record is created. API keys are not managed here.
|
|
93
92
|
- **MCP Servers** (`/mcp-servers`) — manage and export named MCP server endpoints. Use the MCP documentation for behavior, permissions, and client setup.
|
|
94
93
|
- **Schedules** (`/schedules`) — scheduled and recurring tool runs.
|
|
95
94
|
- **Control Panel** (`/admin`) — expandable group for organization and account administration:
|