@crossworks/client-types 0.239.45 → 0.239.47

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": "@crossworks/client-types",
3
- "version": "0.239.45",
3
+ "version": "0.239.47",
4
4
  "type": "module",
5
5
  "main": "./src/index.ts",
6
6
  "types": "./src/index.ts",
@@ -24,6 +24,8 @@ export const ACCESS_KEY_AREAS = [
24
24
  'contacts',
25
25
  'journal',
26
26
  'apps',
27
+ // The data of mini apps opened to MCP (team apps Phase 1, app_data_*).
28
+ 'app_data',
27
29
  ] as const;
28
30
  export type AccessKeyArea = (typeof ACCESS_KEY_AREAS)[number];
29
31
 
@@ -0,0 +1,30 @@
1
+ /**
2
+ * A member's own view of Settings > MCP (team apps Phase 1): GET
3
+ * /api/member/mcp. The member reads their access here; an admin sets it.
4
+ * The only thing a member changes is their own connected clients
5
+ * (DELETE /api/member/mcp/clients/:id).
6
+ */
7
+
8
+ /** One MCP client the member connected: their live OAuth grants on it. */
9
+ export type MemberMcpClient = {
10
+ id: string;
11
+ /** The name the client registered with (e.g. "Claude"); null if none. */
12
+ clientName: string | null;
13
+ /** ISO: the earliest of this member's live grants on it. */
14
+ connectedAt: string;
15
+ /** ISO: the last call, null when never used. */
16
+ lastUsedAt: string | null;
17
+ activeTokens: number;
18
+ };
19
+
20
+ export type MemberMcpView = {
21
+ /** The box-level remote MCP switch (an admin's). Off, no MCP works. */
22
+ remoteEnabled: boolean;
23
+ /** The URL to paste into an MCP client. */
24
+ connectorUrl: string;
25
+ /** The member's own switches, set by an admin: MCP at all, and Write
26
+ * (drafts in their own space, and rows of apps opened to MCP). */
27
+ access: { enabled: boolean; writeEnabled: boolean };
28
+ /** The clients this member connected, never another login's. */
29
+ clients: MemberMcpClient[];
30
+ };
package/src/dto/rows.ts CHANGED
@@ -191,6 +191,13 @@ export type AppRow = {
191
191
  * everyone who runs it writes. Set with PATCH /api/apps/:id
192
192
  * `{ dataReadOnly }`. Absent from an older brain: read as false. */
193
193
  dataReadOnly?: boolean;
194
+ /** MCP access (team apps Phase 1, migration 0234): a member's or client's
195
+ * MCP connection may reach this app's data (the app_data_* tools), at
196
+ * the app's level, read or write by the login's Write switch and
197
+ * `dataReadOnly`. Off by default. Set with PATCH /api/apps/:id
198
+ * `{ mcpAccess }`. Absent from an older brain: read as false (and the
199
+ * switch is not shown). */
200
+ mcpAccess?: boolean;
194
201
  createdAt: string;
195
202
  updatedAt: string;
196
203
  };
@@ -218,8 +225,17 @@ export type AppDetail = AppRow & {
218
225
  export type AppSnapshot = {
219
226
  id: string;
220
227
  seq: number;
228
+ /** `pre_mcp_write` (0234): taken before the first MCP write to the app
229
+ * in an hour. */
221
230
  trigger:
222
- 'publish' | 'manual' | 'pre_restore' | 'pre_schema' | 'pre_delete' | 'pre_import' | 'nightly';
231
+ | 'publish'
232
+ | 'manual'
233
+ | 'pre_restore'
234
+ | 'pre_schema'
235
+ | 'pre_delete'
236
+ | 'pre_import'
237
+ | 'nightly'
238
+ | 'pre_mcp_write';
223
239
  kind: 'version' | 'snapshot';
224
240
  note: string | null;
225
241
  actor: 'owner' | 'agent' | 'mcp' | 'system';
package/src/index.ts CHANGED
@@ -120,6 +120,7 @@ export type {
120
120
  MemberInviteRow,
121
121
  MemberInviteState,
122
122
  } from './dto/member-invites';
123
+ export type { MemberMcpClient, MemberMcpView } from './dto/member-mcp';
123
124
  export type { MemberItemKind, ClientItemKind, ClientItemFilter } from './member-kinds';
124
125
  export type {
125
126
  LoginKind,