clawdi 0.14.59 → 0.14.61

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clawdi",
3
- "version": "0.14.59",
3
+ "version": "0.14.61",
4
4
  "description": "The best home for all your AI agents. Run them in the cloud or connect your own—with their context and tools in one place.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -138,12 +138,28 @@ to have changed:
138
138
  - Use the Clawdi connector when no direct option can perform the operation.
139
139
 
140
140
  Before a side effect, establish the exact service account and organization, Project, or tenant.
141
- Use `connector_account_list` when the connector is a candidate and its identity is not already clear.
141
+ Use connection details from Composio discovery, or explicitly list accounts with
142
+ `COMPOSIO_MANAGE_CONNECTIONS`, when the connector identity is not already clear.
142
143
  Fallback must not silently change that identity. Do not scan for credentials, start an interactive
143
144
  login, invent API details, or expose secrets. Choose the path before a side effect and advance
144
145
  only after a definite preflight failure. If a mutation's result is ambiguous, inspect it through
145
146
  the same path; never repeat it through another path.
146
147
 
148
+ ## Connector Account Management
149
+
150
+ Use `COMPOSIO_MANAGE_CONNECTIONS` for account management, following its live schema.
151
+ For the multi-account schema, each `toolkits` item has `name` and `action`:
152
+
153
+ - `list`: Read account IDs, aliases, and statuses. Always specify this action for a
154
+ lookup: omitting `action` defaults to `add` and creates an authorization link.
155
+ - `add`: Create a new authorization link when the user wants another connection.
156
+ - `rename`: Set `alias` on the exact `account_id` returned by discovery.
157
+ - `remove`: Delete the exact `account_id` selected by the user.
158
+
159
+ Reuse the returned `session_id` when available. Never guess account IDs, use a
160
+ mutation to discover accounts, or automatically retry an ambiguous mutation.
161
+ Do not assume an empty alias clears it unless the live contract confirms that behavior.
162
+
147
163
  ## Connector Workflow
148
164
 
149
165
  When the Clawdi connector path is selected, use the Composio Tool Router meta-tools returned
@@ -158,8 +174,9 @@ authoritative; never assume a fixed meta-tool set.
158
174
  Explicit intent authorizes the exact requested action and target, but never authorizes
159
175
  guessing a missing recipient, account, resource, or other target. Ask only for what is
160
176
  missing, and do not request redundant confirmation once the exact action is authorized.
161
- 3. When search reports no active connection, call `COMPOSIO_MANAGE_CONNECTIONS` with its
162
- exposed schema and interpret only the fields it returns. Continue on `active`. On
177
+ 3. When search reports no active connection and the user wants to connect, call
178
+ `COMPOSIO_MANAGE_CONNECTIONS` with explicit `action: "add"` in the multi-account schema.
179
+ Follow its exposed schema and interpret only the fields it returns. Continue on `active`. On
163
180
  `initiated`, present its non-empty `redirect_url` as a clickable authentication link with
164
181
  a concise explanation that authorization is pending; the link URL must be exactly that
165
182
  value. If `initiated` has no non-empty `redirect_url`, report that authorization cannot
@@ -108,12 +108,28 @@ to have changed:
108
108
  - Use the Clawdi connector when no direct option can perform the operation.
109
109
 
110
110
  Before a side effect, establish the exact service account and organization, Project, or tenant.
111
- Use `connector_account_list` when the connector is a candidate and its identity is not already clear.
111
+ Use connection details from Composio discovery, or explicitly list accounts with
112
+ `COMPOSIO_MANAGE_CONNECTIONS`, when the connector identity is not already clear.
112
113
  Fallback must not silently change that identity. Do not scan for credentials, start an interactive
113
114
  login, invent API details, or expose secrets. Choose the path before a side effect and advance
114
115
  only after a definite preflight failure. If a mutation's result is ambiguous, inspect it through
115
116
  the same path; never repeat it through another path.
116
117
 
118
+ ## Connector Account Management
119
+
120
+ Use `COMPOSIO_MANAGE_CONNECTIONS` for account management, following its live schema.
121
+ For the multi-account schema, each `toolkits` item has `name` and `action`:
122
+
123
+ - `list`: Read account IDs, aliases, and statuses. Always specify this action for a
124
+ lookup: omitting `action` defaults to `add` and creates an authorization link.
125
+ - `add`: Create a new authorization link when the user wants another connection.
126
+ - `rename`: Set `alias` on the exact `account_id` returned by discovery.
127
+ - `remove`: Delete the exact `account_id` selected by the user.
128
+
129
+ Reuse the returned `session_id` when available. Never guess account IDs, use a
130
+ mutation to discover accounts, or automatically retry an ambiguous mutation.
131
+ Do not assume an empty alias clears it unless the live contract confirms that behavior.
132
+
117
133
  ## Connector Workflow
118
134
 
119
135
  When the Clawdi connector path is selected, use the Composio Tool Router meta-tools returned
@@ -128,8 +144,9 @@ authoritative; never assume a fixed meta-tool set.
128
144
  Explicit intent authorizes the exact requested action and target, but never authorizes
129
145
  guessing a missing recipient, account, resource, or other target. Ask only for what is
130
146
  missing, and do not request redundant confirmation once the exact action is authorized.
131
- 3. When search reports no active connection, call `COMPOSIO_MANAGE_CONNECTIONS` with its
132
- exposed schema and interpret only the fields it returns. Continue on `active`. On
147
+ 3. When search reports no active connection and the user wants to connect, call
148
+ `COMPOSIO_MANAGE_CONNECTIONS` with explicit `action: "add"` in the multi-account schema.
149
+ Follow its exposed schema and interpret only the fields it returns. Continue on `active`. On
133
150
  `initiated`, present its non-empty `redirect_url` as a clickable authentication link with
134
151
  a concise explanation that authorization is pending; the link URL must be exactly that
135
152
  value. If `initiated` has no non-empty `redirect_url`, report that authorization cannot