@crossworks/client-types 0.232.385 → 0.234.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.232.385",
+  "version": "0.234.5",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/dto/agent-graph.ts

@@ -81,16 +81,17 @@ export interface ToolDTO {
   handler: ToolHandler;
   requiresConfirm: boolean;
   enabled: boolean;
-  /** "Team apps may use" on an outside tool (mcp or http): team members'
-   *  runs of a team app may call it. Null when off. Absent from servers
-   *  before it shipped. Set it with `PUT /api/tools/:id/team-apps`. */
-  teamApps?: ToolTeamAppsDTO | null;
+  /** "External access" on an outside tool (mcp or http): everyone a shared
+   *  app that declares it reaches (members, clients, contacts on a contact
+   *  link) may call it. Null when off. Set it with
+   *  `PUT /api/tools/:id/external-access`. */
+  externalAccess?: ToolExternalAccessDTO | null;
   createdAt: string;
   updatedAt: string;
 }
 
-/** The "Team apps may use" switch of one tool, as the server reports it. */
-export interface ToolTeamAppsDTO {
+/** The "External access" switch of one tool, as the server reports it. */
+export interface ToolExternalAccessDTO {
   /** False when the handler changed after the admin confirmed it: the switch
    *  no longer counts and must be switched on again. */
   on: boolean;
@@ -100,9 +101,9 @@ export interface ToolTeamAppsDTO {
   by: { via: 'web' | 'mcp' | 'dev-tools'; actorId?: string; actorEmail?: string };
 }
 
-/** `PUT /api/tools/:id/team-apps` body. Switching on needs
+/** `PUT /api/tools/:id/external-access` body. Switching on needs
  *  `readOnlyConfirmed: true` (the admin confirms the tool only reads). */
-export interface ToolTeamAppsBody {
+export interface ToolExternalAccessBody {
   allow: boolean;
   readOnlyConfirmed?: boolean;
 }
@@ -194,8 +195,8 @@ export interface ToolGroupDTO {
   integration: ToolGroupIntegrationDTO | null;
   enabled: boolean;
   /** The group's level: an agent or a team app may hold it only at or above
-   *  it, and team apps call only tools in an enabled group at team level or
-   *  below. Absent from servers before it shipped. Set it with
+   *  it, and team apps call only built-in tools in an enabled group at team
+   *  level or below (outside tools follow External access instead). Absent from servers before it shipped. Set it with
    *  `PATCH /api/access/tool-groups/:slug { audience }`. */
   audience?: AccessLevel;
   createdAt: string;

package/src/dto/rows.ts

@@ -38,6 +38,11 @@ export type TaskRow = {
    *  it is what keeps a Done column from growing without bound. Orthogonal to
    *  `status`: an archived task keeps the status it had. */
   archivedAt: string | null;
+  /** On a done task: the status it had before it was marked done, which a
+   *  reopen (`PATCH {reopen: true}`) restores. Null when the brain does not
+   *  know it (the reopen then lands on 'open') and on every task that is not
+   *  done. Optional: brains before this field do not send it. */
+  statusBeforeDone?: TaskStatus | null;
   createdAt: string;
   updatedAt: string;
 };
@@ -196,6 +201,61 @@ export type AppDetail = AppRow & {
   manifest: AppManifest;
   draftBuild: BuildRef | null;
   publishedBuild: BuildRef | null;
+  /** When the draft last changed (ISO), null with no draft. The editor sends
+   *  it back as `baseDraftUpdatedAt` on save, and the save answers 409 when
+   *  the draft changed since (an agent or another window). Optional: absent
+   *  from an older brain. */
+  draftUpdatedAt?: string | null;
+};
+
+/**
+ * One entry on an app's History line (apps snapshots, Phase 2). A VERSION
+ * (`trigger` 'publish') is the code a publish made live; a SNAPSHOT (the
+ * owner's, or one taken automatically before a restore or a schema change)
+ * also holds a copy of the app's database. `seq` is the number the owner sees
+ * (v1, v2 …).
+ */
+export type AppSnapshot = {
+  id: string;
+  seq: number;
+  trigger:
+    'publish' | 'manual' | 'pre_restore' | 'pre_schema' | 'pre_delete' | 'pre_import' | 'nightly';
+  kind: 'version' | 'snapshot';
+  note: string | null;
+  actor: 'owner' | 'agent' | 'mcp' | 'system';
+  createdAt: string;
+  /** The seq this one's content was restored from, when it was. */
+  restoredFrom: number | null;
+  /** Whether it holds a copy of the database (a snapshot), and its size. */
+  hasData: boolean;
+  dbBytes: number | null;
+  /** The code it holds: files and their total size. */
+  fileCount: number;
+  sourceBytes: number;
+  /** Whether an unpublished draft was saved with it. */
+  hasDraft: boolean;
+};
+
+/** What a restore puts back: code into the draft, the data, or both live. */
+export type AppRestoreMode = 'code' | 'data' | 'full';
+
+/**
+ * One entry on a table's History line (apps first-class plan, Phase 4). A
+ * `commit` entry is the published table a commit replaced (kept by
+ * itself, the newest 20); a `manual` one the owner took. Each holds a copy
+ * of the whole workbook. `seq` is the number the owner sees (v1, v2 …).
+ */
+export type TableSnapshot = {
+  id: string;
+  seq: number;
+  trigger: 'commit' | 'manual';
+  note: string | null;
+  actor: 'owner' | 'agent' | 'mcp' | 'system';
+  createdAt: string;
+  /** The table's version the copy holds (it counts commits). */
+  tableVersion: number | null;
+  /** The copy's size in bytes. */
+  bytes: number | null;
 };
 
 export type ProfilePreferences = {

package/src/tree.ts

@@ -12,6 +12,7 @@
  * `@mantle/client-types/tree` subpath.
  */
 import type { AccessLevel } from './dto/access';
+import type { TaskStatus } from './dto/rows';
 import type { AppTint } from './app-nav';
 
 /** The kinds the tree serves, in navigation order. */
@@ -208,6 +209,9 @@ export type TreeItemState = 'private' | 'draft' | 'submitted' | 'returned' | 'wi
 export type TreeItemMeta = {
   /** A task marked done. */
   done?: boolean;
+  /** A done task: the status a reopen restores, when the brain knows it.
+   *  Absent otherwise (a reopen then lands on 'open'). */
+  reopensTo?: TaskStatus;
   /** A task's due instant (ISO), when it has one. */
   due?: string | null;
   /** An event's start (ISO). */