@sanity/workbench 0.1.0-alpha.11 → 0.1.0-alpha.13

package/dist/system.js

@@ -0,0 +1,436 @@
+import { getAuthState, logout, AuthStateType, getClient, createSanityInstance } from "@sanity/sdk";
+import { fromObservable, fromPromise, setup, assign, sendTo, raise } from "xstate";
+import "./_chunks-es/studio.js";
+import { logger } from "./_chunks-es/index.js";
+import { createSessionId, createBatchedStore } from "@sanity/telemetry";
+const authStateLogic = fromObservable(
+  ({ input }) => getAuthState(input.instance).observable
+), logoutActorLogic = fromPromise(async ({ input }) => {
+  await logout(input.instance);
+}), authLogic = setup({
+  types: {
+    input: {},
+    context: {},
+    events: {},
+    tags: {}
+  },
+  actors: {
+    authState: authStateLogic,
+    logoutActor: logoutActorLogic
+  },
+  delays: {
+    authTimeout: 3e4
+  },
+  guards: {
+    isLoggedInComplete: (_, params) => params.state?.type === AuthStateType.LOGGED_IN && !!params.state.token && params.state.currentUser !== null,
+    isAuthState: (_, params) => params.state?.type === params.type
+  },
+  actions: {
+    setLoggedIn: assign({
+      token: (_, params) => params.token,
+      currentUser: (_, params) => params.currentUser,
+      error: () => null
+    }),
+    clearAuth: assign({
+      token: () => null,
+      currentUser: () => null,
+      error: () => null
+    }),
+    setError: assign({
+      token: () => null,
+      currentUser: () => null,
+      error: (_, params) => params.error
+    })
+  }
+}).createMachine({
+  id: "auth",
+  initial: "init",
+  context: ({ input }) => ({
+    instance: input.instance,
+    token: null,
+    currentUser: null,
+    error: null
+  }),
+  invoke: {
+    src: "authState",
+    input: ({ context }) => ({ instance: context.instance }),
+    onSnapshot: [
+      {
+        guard: {
+          type: "isLoggedInComplete",
+          params: ({ event }) => ({
+            state: event.snapshot.context
+          })
+        },
+        actions: [
+          {
+            type: "setLoggedIn",
+            params: ({ event }) => {
+              const state = event.snapshot.context;
+              return {
+                token: state.token,
+                currentUser: state.currentUser
+              };
+            }
+          }
+        ],
+        target: `.${AuthStateType.LOGGED_IN}`
+      },
+      {
+        guard: {
+          type: "isAuthState",
+          params: ({ event }) => ({
+            state: event.snapshot.context,
+            type: AuthStateType.LOGGING_IN
+          })
+        },
+        actions: [{ type: "clearAuth" }],
+        target: `.${AuthStateType.LOGGING_IN}`
+      },
+      {
+        guard: {
+          type: "isAuthState",
+          params: ({ event }) => ({
+            state: event.snapshot.context,
+            type: AuthStateType.ERROR
+          })
+        },
+        actions: [
+          {
+            type: "setError",
+            params: ({ event }) => ({
+              error: event.snapshot.context?.type === AuthStateType.ERROR ? event.snapshot.context.error : null
+            })
+          }
+        ],
+        target: `.${AuthStateType.ERROR}`
+      },
+      {
+        guard: {
+          type: "isAuthState",
+          params: ({ event }) => ({
+            state: event.snapshot.context,
+            type: AuthStateType.LOGGED_OUT
+          })
+        },
+        actions: [{ type: "clearAuth" }],
+        target: `.${AuthStateType.LOGGED_OUT}`
+      }
+    ]
+  },
+  states: {
+    init: {
+      tags: ["authenticating"],
+      after: {
+        authTimeout: {
+          actions: [
+            {
+              type: "setError",
+              params: () => ({
+                error: new Error("Authentication timed out")
+              })
+            }
+          ],
+          target: AuthStateType.ERROR
+        }
+      }
+    },
+    [AuthStateType.LOGGING_IN]: {
+      tags: ["authenticating"],
+      after: {
+        authTimeout: {
+          actions: [
+            {
+              type: "setError",
+              params: () => ({
+                error: new Error("Authentication timed out")
+              })
+            }
+          ],
+          target: AuthStateType.ERROR
+        }
+      }
+    },
+    [AuthStateType.LOGGED_IN]: {
+      tags: ["authenticated"],
+      on: {
+        "auth.logout": { target: "logging-out" }
+      }
+    },
+    "logging-out": {
+      invoke: {
+        src: "logoutActor",
+        input: ({ context }) => ({ instance: context.instance }),
+        onDone: {
+          target: AuthStateType.LOGGED_OUT
+        },
+        onError: {
+          actions: [
+            {
+              type: "setError",
+              params: ({ event }) => ({ error: event.error })
+            }
+          ],
+          target: AuthStateType.ERROR
+        }
+      }
+    },
+    [AuthStateType.LOGGED_OUT]: {},
+    [AuthStateType.ERROR]: { tags: ["error"] }
+  }
+}), actorPath = (ref) => {
+  const segments = [];
+  let current = ref;
+  for (; current; )
+    segments.unshift(current.id ?? current.sessionId), current = current._parent;
+  return segments.join(":");
+}, inspect = (event) => {
+  const ref = event.actorRef, log = logger.child(actorPath(ref));
+  switch (event.type) {
+    case "@xstate.snapshot": {
+      log.debug("snapshot", event.snapshot);
+      break;
+    }
+    case "@xstate.event":
+      log.debug("event", event.event);
+      break;
+    case "@xstate.action":
+      log.debug("action", event.action);
+      break;
+  }
+}, TELEMETRY_API_VERSION = "2024-11-12", FLUSH_INTERVAL_MS = 3e4, checkConsentLogic = fromPromise(async ({ input, signal }) => {
+  try {
+    return await getClient(input.instance, {
+      apiVersion: TELEMETRY_API_VERSION
+    }).request({
+      uri: "/intake/telemetry-status",
+      tag: "telemetry-consent",
+      signal
+    });
+  } catch {
+    return { status: "undetermined" };
+  }
+}), telemetryLogic = setup({
+  types: {
+    input: {},
+    context: {},
+    events: {}
+  },
+  actors: {
+    checkConsent: checkConsentLogic
+  },
+  guards: {
+    isConsentGranted: (_, params) => params.status === "granted"
+  },
+  actions: {
+    createStore: assign({
+      store: ({ context }) => {
+        const sessionId = createSessionId(), client = getClient(context.instance, {
+          apiVersion: TELEMETRY_API_VERSION
+        }), store = createBatchedStore(sessionId, {
+          flushInterval: FLUSH_INTERVAL_MS,
+          resolveConsent: () => client.request({
+            uri: "/intake/telemetry-status",
+            tag: "telemetry-consent"
+          }),
+          sendEvents: (batch) => client.request({
+            uri: "/intake/batch",
+            method: "POST",
+            body: { batch },
+            tag: "telemetry.batch"
+          }),
+          sendBeacon: (batch) => typeof navigator > "u" ? !1 : navigator.sendBeacon(
+            client.getUrl("/intake/batch"),
+            JSON.stringify({ batch })
+          )
+        });
+        return store.logger.updateUserProperties(context.userProperties), store;
+      }
+    }),
+    teardownStore: ({ context }) => {
+      context.store?.end();
+    }
+  }
+}).createMachine({
+  id: "telemetry",
+  initial: "idle",
+  context: ({ input }) => ({
+    instance: input.instance,
+    store: null,
+    userProperties: {
+      version: input.version,
+      organizationId: input.organizationId,
+      environment: input.environment,
+      userAgent: input.userAgent
+    }
+  }),
+  states: {
+    idle: {
+      on: {
+        "telemetry.start": {
+          target: "checkingConsent"
+        }
+      }
+    },
+    checkingConsent: {
+      invoke: {
+        src: "checkConsent",
+        input: ({ context }) => ({
+          instance: context.instance
+        }),
+        onDone: [
+          {
+            guard: {
+              type: "isConsentGranted",
+              params: ({ event }) => ({
+                status: event.output.status
+              })
+            },
+            actions: [{ type: "createStore" }],
+            target: "active"
+          },
+          {
+            target: "denied"
+          }
+        ]
+      }
+    },
+    active: {
+      tags: ["telemetry-resolved"],
+      exit: [{ type: "teardownStore" }],
+      on: {
+        "telemetry.stop": { target: "stopped" }
+      }
+    },
+    stopped: {
+      type: "final"
+    },
+    denied: {
+      tags: ["telemetry-resolved"]
+    }
+  }
+}), os = setup({
+  types: {
+    input: {},
+    context: {},
+    events: {},
+    // https://github.com/statelyai/xstate/issues/5515
+    children: {}
+  },
+  actors: {
+    auth: authLogic,
+    telemetry: telemetryLogic
+  },
+  guards: {
+    hasTag: (_, params) => params.hasTag
+  },
+  actions: {
+    raiseAuthReady: raise({ type: "boot.auth.ready" }),
+    raiseAuthFailed: raise({ type: "boot.auth.failed" }),
+    raiseTelemetryReady: raise({
+      type: "boot.telemetry.ready"
+    }),
+    startTelemetry: sendTo("telemetry", {
+      type: "telemetry.start"
+    })
+  }
+}).createMachine({
+  id: "os",
+  context: ({ input }) => ({
+    instance: createSanityInstance(),
+    userProperties: {
+      version: input.version,
+      organizationId: input.organizationId,
+      environment: input.environment,
+      userAgent: input.userAgent
+    }
+  }),
+  initial: "booting",
+  invoke: [
+    {
+      id: "auth",
+      systemId: "auth",
+      src: "auth",
+      input: ({ context }) => ({ instance: context.instance }),
+      onSnapshot: [
+        {
+          guard: {
+            type: "hasTag",
+            params: ({ event }) => ({
+              hasTag: event.snapshot.hasTag("authenticated")
+            })
+          },
+          actions: [{ type: "raiseAuthReady" }]
+        },
+        {
+          guard: {
+            type: "hasTag",
+            params: ({ event }) => ({
+              hasTag: event.snapshot.hasTag("error")
+            })
+          },
+          actions: [{ type: "raiseAuthFailed" }]
+        }
+      ]
+    },
+    {
+      id: "telemetry",
+      systemId: "telemetry",
+      src: "telemetry",
+      input: ({ context }) => ({
+        instance: context.instance,
+        ...context.userProperties
+      }),
+      onSnapshot: [
+        {
+          guard: {
+            type: "hasTag",
+            params: ({ event }) => ({
+              hasTag: event.snapshot.hasTag("telemetry-resolved")
+            })
+          },
+          actions: [{ type: "raiseTelemetryReady" }]
+        }
+      ]
+    }
+  ],
+  states: {
+    booting: {
+      initial: "auth",
+      states: {
+        auth: {
+          on: {
+            "boot.auth.ready": {
+              target: "telemetry",
+              actions: [{ type: "startTelemetry" }]
+            },
+            "boot.auth.failed": { target: "error" }
+          }
+        },
+        telemetry: {
+          on: {
+            "boot.telemetry.ready": { target: "done" }
+          }
+        },
+        error: {},
+        done: { type: "final" }
+      },
+      onDone: { target: "running" }
+    },
+    running: {
+      type: "parallel"
+    }
+  }
+});
+function createOSOptions(input) {
+  return {
+    id: "os",
+    input,
+    inspect
+  };
+}
+export {
+  createOSOptions,
+  os
+};
+//# sourceMappingURL=system.js.map

package/dist/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sources":["../src/system/auth.machine.ts","../src/system/inspect.ts","../src/system/telemetry.machine.ts","../src/system/root.machine.ts"],"sourcesContent":["import {\n  type AuthState,\n  AuthStateType,\n  type CurrentUser,\n  getAuthState,\n  type LoggedInAuthState,\n  logout,\n  type SanityInstance,\n} from \"@sanity/sdk\";\nimport { assign, fromObservable, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @internal\n */\nexport interface AuthInput extends OSBaseInput {}\n\nconst authStateLogic = fromObservable<AuthState, AuthInput>(\n  ({ input }) => getAuthState(input.instance).observable,\n);\n\n/**\n * @internal\n */\nexport interface LogoutInput extends OSBaseInput {}\n\nconst logoutActorLogic = fromPromise<void, LogoutInput>(async ({ input }) => {\n  await logout(input.instance);\n});\n\ntype AuthContext = {\n  instance: SanityInstance;\n  token: string | null;\n  currentUser: CurrentUser | null;\n  error: unknown;\n};\n\ntype AuthEvent = { type: \"auth.logout\" };\n\nexport const authLogic = setup({\n  types: {\n    input: {} as AuthInput,\n    context: {} as AuthContext,\n    events: {} as AuthEvent,\n    tags: {} as \"authenticating\" | \"authenticated\" | \"error\",\n  },\n  actors: {\n    authState: authStateLogic,\n    logoutActor: logoutActorLogic,\n  },\n  delays: {\n    authTimeout: 30_000,\n  },\n  guards: {\n    isLoggedInComplete: (_, params: { state: AuthState | undefined }) =>\n      params.state?.type === AuthStateType.LOGGED_IN &&\n      Boolean((params.state as LoggedInAuthState).token) &&\n      (params.state as LoggedInAuthState).currentUser !== null,\n    isAuthState: (\n      _,\n      params: { state: AuthState | undefined; type: AuthStateType },\n    ) => params.state?.type === params.type,\n  },\n  actions: {\n    setLoggedIn: assign({\n      token: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.token,\n      currentUser: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.currentUser,\n      error: () => null,\n    }),\n    clearAuth: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: () => null,\n    }),\n    setError: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: (_, params: { error: unknown }) => params.error,\n    }),\n  },\n}).createMachine({\n  id: \"auth\",\n  initial: \"init\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    token: null,\n    currentUser: null,\n    error: null,\n  }),\n  invoke: {\n    src: \"authState\",\n    input: ({ context }) => ({ instance: context.instance }),\n    onSnapshot: [\n      {\n        guard: {\n          type: \"isLoggedInComplete\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n          }),\n        },\n        actions: [\n          {\n            type: \"setLoggedIn\",\n            params: ({ event }) => {\n              const state = event.snapshot.context as LoggedInAuthState;\n              return {\n                token: state.token,\n                currentUser: state.currentUser!,\n              };\n            },\n          },\n        ],\n        target: `.${AuthStateType.LOGGED_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGING_IN,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGING_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.ERROR,\n          }),\n        },\n        actions: [\n          {\n            type: \"setError\",\n            params: ({ event }) => ({\n              error:\n                event.snapshot.context?.type === AuthStateType.ERROR\n                  ? event.snapshot.context.error\n                  : null,\n            }),\n          },\n        ],\n        target: `.${AuthStateType.ERROR}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGED_OUT,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGED_OUT}`,\n      },\n    ],\n  },\n  states: {\n    init: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGING_IN]: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_IN]: {\n      tags: [\"authenticated\"],\n      on: {\n        \"auth.logout\": { target: \"logging-out\" },\n      },\n    },\n    [\"logging-out\"]: {\n      invoke: {\n        src: \"logoutActor\",\n        input: ({ context }) => ({ instance: context.instance }),\n        onDone: {\n          target: AuthStateType.LOGGED_OUT,\n        },\n        onError: {\n          actions: [\n            {\n              type: \"setError\",\n              params: ({ event }) => ({ error: event.error }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_OUT]: {},\n    [AuthStateType.ERROR]: { tags: [\"error\"] },\n  },\n});\n","import { type ActorRefLike, type InspectionEvent } from \"xstate\";\n\nimport { logger } from \"../core\";\n\n// Mirrors @statelyai/inspect's ActorRefLikeWithData — the inspect\n// callback receives full Actor instances at runtime, but the type is\n// narrowed for @xstate/store compat.\ntype ActorRefWithAncestry = ActorRefLike & {\n  id?: string;\n  _parent?: ActorRefWithAncestry;\n};\n\nconst actorPath = (ref: ActorRefWithAncestry): string => {\n  const segments: string[] = [];\n  let current: ActorRefWithAncestry | undefined = ref;\n  while (current) {\n    segments.unshift(current.id ?? current.sessionId);\n    current = current._parent;\n  }\n  return segments.join(\":\");\n};\n\n/** @internal exported for testing */\nexport const inspect = (event: InspectionEvent): void => {\n  const ref = event.actorRef as ActorRefWithAncestry;\n  const log = logger.child(actorPath(ref));\n\n  switch (event.type) {\n    case \"@xstate.snapshot\": {\n      log.debug(\"snapshot\", event.snapshot);\n      break;\n    }\n    case \"@xstate.event\":\n      log.debug(\"event\", event.event);\n      break;\n    case \"@xstate.action\":\n      log.debug(\"action\", event.action);\n      break;\n  }\n};\n","import { getClient, type SanityInstance } from \"@sanity/sdk\";\nimport {\n  type ConsentStatus,\n  createBatchedStore,\n  createSessionId,\n  type TelemetryEvent,\n  type TelemetryStore,\n} from \"@sanity/telemetry\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @public\n */\nexport type WorkbenchUserProperties = {\n  version: string;\n  organizationId: string;\n  environment: string;\n  userAgent: string;\n};\n\n/**\n * @internal\n */\nexport interface TelemetryInput extends OSBaseInput, WorkbenchUserProperties {}\n\n/**\n * TODO: this shouldn't be unique to the telemetry machine,\n * remove this and set it globally with a single client actor.\n */\nconst TELEMETRY_API_VERSION = \"2024-11-12\";\n/**\n * 30 seconds, in milliseconds, is the default flush interval\n * for the telemetry store.\n */\nconst FLUSH_INTERVAL_MS = 30_000;\n\ntype ConsentResult = { status: ConsentStatus };\n\nconst checkConsentLogic = fromPromise<\n  ConsentResult,\n  { instance: SanityInstance }\n>(async ({ input, signal }) => {\n  try {\n    const client = getClient(input.instance, {\n      apiVersion: TELEMETRY_API_VERSION,\n    });\n    return await client.request<ConsentResult>({\n      uri: \"/intake/telemetry-status\",\n      tag: \"telemetry-consent\",\n      signal,\n    });\n  } catch {\n    return { status: \"undetermined\" } satisfies ConsentResult;\n  }\n});\n\ntype TelemetryContext = {\n  instance: SanityInstance;\n  store: TelemetryStore<WorkbenchUserProperties> | null;\n  userProperties: WorkbenchUserProperties;\n};\n\ntype TelemetryMachineEvent =\n  | { type: \"telemetry.start\" }\n  | { type: \"telemetry.stop\" };\n\nexport const telemetryLogic = setup({\n  types: {\n    input: {} as TelemetryInput,\n    context: {} as TelemetryContext,\n    events: {} as TelemetryMachineEvent,\n  },\n  actors: {\n    checkConsent: checkConsentLogic,\n  },\n  guards: {\n    isConsentGranted: (_, params: { status: ConsentStatus }) =>\n      params.status === \"granted\",\n  },\n  actions: {\n    createStore: assign({\n      store: ({ context }) => {\n        const sessionId = createSessionId();\n        const client = getClient(context.instance, {\n          apiVersion: TELEMETRY_API_VERSION,\n        });\n        const store = createBatchedStore<WorkbenchUserProperties>(sessionId, {\n          flushInterval: FLUSH_INTERVAL_MS,\n          resolveConsent: () =>\n            client.request<{ status: ConsentStatus }>({\n              uri: \"/intake/telemetry-status\",\n              tag: \"telemetry-consent\",\n            }),\n          sendEvents: (batch: TelemetryEvent[]) =>\n            client.request({\n              uri: \"/intake/batch\",\n              method: \"POST\",\n              body: { batch },\n              tag: \"telemetry.batch\",\n            }),\n          sendBeacon: (batch: TelemetryEvent[]) => {\n            if (typeof navigator === \"undefined\") {\n              return false;\n            }\n            return navigator.sendBeacon(\n              client.getUrl(\"/intake/batch\"),\n              JSON.stringify({ batch }),\n            );\n          },\n        });\n        store.logger.updateUserProperties(context.userProperties);\n        return store;\n      },\n    }),\n    teardownStore: ({ context }) => {\n      context.store?.end();\n    },\n  },\n}).createMachine({\n  id: \"telemetry\",\n  initial: \"idle\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    store: null,\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n  }),\n  states: {\n    idle: {\n      on: {\n        \"telemetry.start\": {\n          target: \"checkingConsent\",\n        },\n      },\n    },\n    checkingConsent: {\n      invoke: {\n        src: \"checkConsent\",\n        input: ({ context }) => ({\n          instance: context.instance,\n        }),\n        onDone: [\n          {\n            guard: {\n              type: \"isConsentGranted\",\n              params: ({ event }) => ({\n                status: event.output.status,\n              }),\n            },\n            actions: [{ type: \"createStore\" }],\n            target: \"active\",\n          },\n          {\n            target: \"denied\",\n          },\n        ],\n      },\n    },\n    active: {\n      tags: [\"telemetry-resolved\"],\n      exit: [{ type: \"teardownStore\" }],\n      on: {\n        \"telemetry.stop\": { target: \"stopped\" },\n      },\n    },\n    stopped: {\n      type: \"final\",\n    },\n    denied: {\n      tags: [\"telemetry-resolved\"],\n    },\n  },\n});\n","import { createSanityInstance, type SanityInstance } from \"@sanity/sdk\";\nimport { raise, sendTo, setup, type ActorOptions } from \"xstate\";\n\nimport { authLogic } from \"./auth.machine\";\nimport { inspect } from \"./inspect\";\nimport {\n  telemetryLogic,\n  type WorkbenchUserProperties,\n} from \"./telemetry.machine\";\n\ntype OSInput = WorkbenchUserProperties;\ntype OSContext = {\n  instance: SanityInstance;\n  userProperties: WorkbenchUserProperties;\n};\n\n/**\n * The base inputs for the OS machine.\n * @internal\n */\nexport interface OSBaseInput extends Pick<OSContext, \"instance\"> {}\n\n/**\n * The sanity OS machine, responsible for managing the global state of the OS.\n * @public\n * @example\n * ```ts\n * import { os, createOSOptions } from \"@sanity/workbench/system\";\n * import { useActor } from \"@xstate/react\";\n *\n * const [state, send] = useActor(os, createOSOptions());\n * ```\n */\nexport const os = setup({\n  types: {\n    input: {} as OSInput,\n    context: {} as OSContext,\n    events: {} as\n      | { type: \"boot.auth.ready\" }\n      | { type: \"boot.auth.failed\" }\n      | { type: \"boot.telemetry.ready\" },\n    // https://github.com/statelyai/xstate/issues/5515\n    children: {} as {\n      auth: \"auth\";\n      telemetry: \"telemetry\";\n    },\n  },\n  actors: {\n    auth: authLogic,\n    telemetry: telemetryLogic,\n  },\n  guards: {\n    hasTag: (_, params: { hasTag: boolean }) => params.hasTag,\n  },\n  actions: {\n    raiseAuthReady: raise({ type: \"boot.auth.ready\" }),\n    raiseAuthFailed: raise({ type: \"boot.auth.failed\" }),\n    raiseTelemetryReady: raise({\n      type: \"boot.telemetry.ready\",\n    }),\n    startTelemetry: sendTo(\"telemetry\", {\n      type: \"telemetry.start\",\n    }),\n  },\n}).createMachine({\n  id: \"os\",\n  context: ({ input }) => ({\n    instance: createSanityInstance(),\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n  }),\n  initial: \"booting\",\n  invoke: [\n    {\n      id: \"auth\",\n      systemId: \"auth\",\n      src: \"auth\",\n      input: ({ context }) => ({ instance: context.instance }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"authenticated\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthReady\" }],\n        },\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"error\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthFailed\" }],\n        },\n      ],\n    },\n    {\n      id: \"telemetry\",\n      systemId: \"telemetry\",\n      src: \"telemetry\",\n      input: ({ context }) => ({\n        instance: context.instance,\n        ...context.userProperties,\n      }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"telemetry-resolved\"),\n            }),\n          },\n          actions: [{ type: \"raiseTelemetryReady\" }],\n        },\n      ],\n    },\n  ],\n  states: {\n    booting: {\n      initial: \"auth\",\n      states: {\n        auth: {\n          on: {\n            \"boot.auth.ready\": {\n              target: \"telemetry\",\n              actions: [{ type: \"startTelemetry\" }],\n            },\n            \"boot.auth.failed\": { target: \"error\" },\n          },\n        },\n        telemetry: {\n          on: {\n            \"boot.telemetry.ready\": { target: \"done\" },\n          },\n        },\n        error: {},\n        done: { type: \"final\" },\n      },\n      onDone: { target: \"running\" },\n    },\n    running: {\n      type: \"parallel\",\n    },\n  },\n});\n\n/**\n * Creates a set of default options for the OS machine, including passing\n * the sanity configuration for the internal instance.\n * @public\n */\nexport function createOSOptions(input: OSInput) {\n  return {\n    id: \"os\",\n    input,\n    inspect,\n  } satisfies ActorOptions<typeof os>;\n}\n"],"names":[],"mappings":";;;;;AAkBA,MAAM,iBAAiB;AAAA,EACrB,CAAC,EAAE,MAAA,MAAY,aAAa,MAAM,QAAQ,EAAE;AAC9C,GAOM,mBAAmB,YAA+B,OAAO,EAAE,YAAY;AAC3E,QAAM,OAAO,MAAM,QAAQ;AAC7B,CAAC,GAWY,YAAY,MAAM;AAAA,EAC7B,OAAO;AAAA,IACL,OAAO,CAAA;AAAA,IACP,SAAS,CAAA;AAAA,IACT,QAAQ,CAAA;AAAA,IACR,MAAM,CAAA;AAAA,EAAC;AAAA,EAET,QAAQ;AAAA,IACN,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA,EAEf,QAAQ;AAAA,IACN,aAAa;AAAA,EAAA;AAAA,EAEf,QAAQ;AAAA,IACN,oBAAoB,CAAC,GAAG,WACtB,OAAO,OAAO,SAAS,cAAc,aACrC,EAAS,OAAO,MAA4B,SAC3C,OAAO,MAA4B,gBAAgB;AAAA,IACtD,aAAa,CACX,GACA,WACG,OAAO,OAAO,SAAS,OAAO;AAAA,EAAA;AAAA,EAErC,SAAS;AAAA,IACP,aAAa,OAAO;AAAA,MAClB,OAAO,CAAC,GAAG,WACT,OAAO;AAAA,MACT,aAAa,CAAC,GAAG,WACf,OAAO;AAAA,MACT,OAAO,MAAM;AAAA,IAAA,CACd;AAAA,IACD,WAAW,OAAO;AAAA,MAChB,OAAO,MAAM;AAAA,MACb,aAAa,MAAM;AAAA,MACnB,OAAO,MAAM;AAAA,IAAA,CACd;AAAA,IACD,UAAU,OAAO;AAAA,MACf,OAAO,MAAM;AAAA,MACb,aAAa,MAAM;AAAA,MACnB,OAAO,CAAC,GAAG,WAA+B,OAAO;AAAA,IAAA,CAClD;AAAA,EAAA;AAEL,CAAC,EAAE,cAAc;AAAA,EACf,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,SAAS,CAAC,EAAE,aAAa;AAAA,IACvB,UAAU,MAAM;AAAA,IAChB,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,EAAA;AAAA,EAET,QAAQ;AAAA,IACN,KAAK;AAAA,IACL,OAAO,CAAC,EAAE,QAAA,OAAe,EAAE,UAAU,QAAQ;IAC7C,YAAY;AAAA,MACV;AAAA,QACE,OAAO;AAAA,UACL,MAAM;AAAA,UACN,QAAQ,CAAC,EAAE,aAAa;AAAA,YACtB,OAAO,MAAM,SAAS;AAAA,UAAA;AAAA,QACxB;AAAA,QAEF,SAAS;AAAA,UACP;AAAA,YACE,MAAM;AAAA,YACN,QAAQ,CAAC,EAAE,YAAY;AACrB,oBAAM,QAAQ,MAAM,SAAS;AAC7B,qBAAO;AAAA,gBACL,OAAO,MAAM;AAAA,gBACb,aAAa,MAAM;AAAA,cAAA;AAAA,YAEvB;AAAA,UAAA;AAAA,QACF;AAAA,QAEF,QAAQ,IAAI,cAAc,SAAS;AAAA,MAAA;AAAA,MAErC;AAAA,QACE,OAAO;AAAA,UACL,MAAM;AAAA,UACN,QAAQ,CAAC,EAAE,aAAa;AAAA,YACtB,OAAO,MAAM,SAAS;AAAA,YACtB,MAAM,cAAc;AAAA,UAAA;AAAA,QACtB;AAAA,QAEF,SAAS,CAAC,EAAE,MAAM,aAAa;AAAA,QAC/B,QAAQ,IAAI,cAAc,UAAU;AAAA,MAAA;AAAA,MAEtC;AAAA,QACE,OAAO;AAAA,UACL,MAAM;AAAA,UACN,QAAQ,CAAC,EAAE,aAAa;AAAA,YACtB,OAAO,MAAM,SAAS;AAAA,YACtB,MAAM,cAAc;AAAA,UAAA;AAAA,QACtB;AAAA,QAEF,SAAS;AAAA,UACP;AAAA,YACE,MAAM;AAAA,YACN,QAAQ,CAAC,EAAE,aAAa;AAAA,cACtB,OACE,MAAM,SAAS,SAAS,SAAS,cAAc,QAC3C,MAAM,SAAS,QAAQ,QACvB;AAAA,YAAA;AAAA,UACR;AAAA,QACF;AAAA,QAEF,QAAQ,IAAI,cAAc,KAAK;AAAA,MAAA;AAAA,MAEjC;AAAA,QACE,OAAO;AAAA,UACL,MAAM;AAAA,UACN,QAAQ,CAAC,EAAE,aAAa;AAAA,YACtB,OAAO,MAAM,SAAS;AAAA,YACtB,MAAM,cAAc;AAAA,UAAA;AAAA,QACtB;AAAA,QAEF,SAAS,CAAC,EAAE,MAAM,aAAa;AAAA,QAC/B,QAAQ,IAAI,cAAc,UAAU;AAAA,MAAA;AAAA,IACtC;AAAA,EACF;AAAA,EAEF,QAAQ;AAAA,IACN,MAAM;AAAA,MACJ,MAAM,CAAC,gBAAgB;AAAA,MACvB,OAAO;AAAA,QACL,aAAa;AAAA,UACX,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,QAAQ,OAAO;AAAA,gBACb,OAAO,IAAI,MAAM,0BAA0B;AAAA,cAAA;AAAA,YAC7C;AAAA,UACF;AAAA,UAEF,QAAQ,cAAc;AAAA,QAAA;AAAA,MACxB;AAAA,IACF;AAAA,IAEF,CAAC,cAAc,UAAU,GAAG;AAAA,MAC1B,MAAM,CAAC,gBAAgB;AAAA,MACvB,OAAO;AAAA,QACL,aAAa;AAAA,UACX,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,QAAQ,OAAO;AAAA,gBACb,OAAO,IAAI,MAAM,0BAA0B;AAAA,cAAA;AAAA,YAC7C;AAAA,UACF;AAAA,UAEF,QAAQ,cAAc;AAAA,QAAA;AAAA,MACxB;AAAA,IACF;AAAA,IAEF,CAAC,cAAc,SAAS,GAAG;AAAA,MACzB,MAAM,CAAC,eAAe;AAAA,MACtB,IAAI;AAAA,QACF,eAAe,EAAE,QAAQ,cAAA;AAAA,MAAc;AAAA,IACzC;AAAA,IAED,eAAgB;AAAA,MACf,QAAQ;AAAA,QACN,KAAK;AAAA,QACL,OAAO,CAAC,EAAE,QAAA,OAAe,EAAE,UAAU,QAAQ;QAC7C,QAAQ;AAAA,UACN,QAAQ,cAAc;AAAA,QAAA;AAAA,QAExB,SAAS;AAAA,UACP,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,QAAQ,CAAC,EAAE,MAAA,OAAa,EAAE,OAAO,MAAM,MAAA;AAAA,YAAM;AAAA,UAC/C;AAAA,UAEF,QAAQ,cAAc;AAAA,QAAA;AAAA,MACxB;AAAA,IACF;AAAA,IAEF,CAAC,cAAc,UAAU,GAAG,CAAA;AAAA,IAC5B,CAAC,cAAc,KAAK,GAAG,EAAE,MAAM,CAAC,OAAO,EAAA;AAAA,EAAE;AAE7C,CAAC,GClNK,YAAY,CAAC,QAAsC;AACvD,QAAM,WAAqB,CAAA;AAC3B,MAAI,UAA4C;AAChD,SAAO;AACL,aAAS,QAAQ,QAAQ,MAAM,QAAQ,SAAS,GAChD,UAAU,QAAQ;AAEpB,SAAO,SAAS,KAAK,GAAG;AAC1B,GAGa,UAAU,CAAC,UAAiC;AACvD,QAAM,MAAM,MAAM,UACZ,MAAM,OAAO,MAAM,UAAU,GAAG,CAAC;AAEvC,UAAQ,MAAM,MAAA;AAAA,IACZ,KAAK,oBAAoB;AACvB,UAAI,MAAM,YAAY,MAAM,QAAQ;AACpC;AAAA,IACF;AAAA,IACA,KAAK;AACH,UAAI,MAAM,SAAS,MAAM,KAAK;AAC9B;AAAA,IACF,KAAK;AACH,UAAI,MAAM,UAAU,MAAM,MAAM;AAChC;AAAA,EAAA;AAEN,GCRM,wBAAwB,cAKxB,oBAAoB,KAIpB,oBAAoB,YAGxB,OAAO,EAAE,OAAO,aAAa;AAC7B,MAAI;AAIF,WAAO,MAHQ,UAAU,MAAM,UAAU;AAAA,MACvC,YAAY;AAAA,IAAA,CACb,EACmB,QAAuB;AAAA,MACzC,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,IAAA,CACD;AAAA,EACH,QAAQ;AACN,WAAO,EAAE,QAAQ,eAAA;AAAA,EACnB;AACF,CAAC,GAYY,iBAAiB,MAAM;AAAA,EAClC,OAAO;AAAA,IACL,OAAO,CAAA;AAAA,IACP,SAAS,CAAA;AAAA,IACT,QAAQ,CAAA;AAAA,EAAC;AAAA,EAEX,QAAQ;AAAA,IACN,cAAc;AAAA,EAAA;AAAA,EAEhB,QAAQ;AAAA,IACN,kBAAkB,CAAC,GAAG,WACpB,OAAO,WAAW;AAAA,EAAA;AAAA,EAEtB,SAAS;AAAA,IACP,aAAa,OAAO;AAAA,MAClB,OAAO,CAAC,EAAE,cAAc;AACtB,cAAM,YAAY,gBAAA,GACZ,SAAS,UAAU,QAAQ,UAAU;AAAA,UACzC,YAAY;AAAA,QAAA,CACb,GACK,QAAQ,mBAA4C,WAAW;AAAA,UACnE,eAAe;AAAA,UACf,gBAAgB,MACd,OAAO,QAAmC;AAAA,YACxC,KAAK;AAAA,YACL,KAAK;AAAA,UAAA,CACN;AAAA,UACH,YAAY,CAAC,UACX,OAAO,QAAQ;AAAA,YACb,KAAK;AAAA,YACL,QAAQ;AAAA,YACR,MAAM,EAAE,MAAA;AAAA,YACR,KAAK;AAAA,UAAA,CACN;AAAA,UACH,YAAY,CAAC,UACP,OAAO,YAAc,MAChB,KAEF,UAAU;AAAA,YACf,OAAO,OAAO,eAAe;AAAA,YAC7B,KAAK,UAAU,EAAE,MAAA,CAAO;AAAA,UAAA;AAAA,QAC1B,CAEH;AACD,eAAA,MAAM,OAAO,qBAAqB,QAAQ,cAAc,GACjD;AAAA,MACT;AAAA,IAAA,CACD;AAAA,IACD,eAAe,CAAC,EAAE,cAAc;AAC9B,cAAQ,OAAO,IAAA;AAAA,IACjB;AAAA,EAAA;AAEJ,CAAC,EAAE,cAAc;AAAA,EACf,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,SAAS,CAAC,EAAE,aAAa;AAAA,IACvB,UAAU,MAAM;AAAA,IAChB,OAAO;AAAA,IACP,gBAAgB;AAAA,MACd,SAAS,MAAM;AAAA,MACf,gBAAgB,MAAM;AAAA,MACtB,aAAa,MAAM;AAAA,MACnB,WAAW,MAAM;AAAA,IAAA;AAAA,EACnB;AAAA,EAEF,QAAQ;AAAA,IACN,MAAM;AAAA,MACJ,IAAI;AAAA,QACF,mBAAmB;AAAA,UACjB,QAAQ;AAAA,QAAA;AAAA,MACV;AAAA,IACF;AAAA,IAEF,iBAAiB;AAAA,MACf,QAAQ;AAAA,QACN,KAAK;AAAA,QACL,OAAO,CAAC,EAAE,eAAe;AAAA,UACvB,UAAU,QAAQ;AAAA,QAAA;AAAA,QAEpB,QAAQ;AAAA,UACN;AAAA,YACE,OAAO;AAAA,cACL,MAAM;AAAA,cACN,QAAQ,CAAC,EAAE,aAAa;AAAA,gBACtB,QAAQ,MAAM,OAAO;AAAA,cAAA;AAAA,YACvB;AAAA,YAEF,SAAS,CAAC,EAAE,MAAM,eAAe;AAAA,YACjC,QAAQ;AAAA,UAAA;AAAA,UAEV;AAAA,YACE,QAAQ;AAAA,UAAA;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,IAEF,QAAQ;AAAA,MACN,MAAM,CAAC,oBAAoB;AAAA,MAC3B,MAAM,CAAC,EAAE,MAAM,iBAAiB;AAAA,MAChC,IAAI;AAAA,QACF,kBAAkB,EAAE,QAAQ,UAAA;AAAA,MAAU;AAAA,IACxC;AAAA,IAEF,SAAS;AAAA,MACP,MAAM;AAAA,IAAA;AAAA,IAER,QAAQ;AAAA,MACN,MAAM,CAAC,oBAAoB;AAAA,IAAA;AAAA,EAC7B;AAEJ,CAAC,GCjJY,KAAK,MAAM;AAAA,EACtB,OAAO;AAAA,IACL,OAAO,CAAA;AAAA,IACP,SAAS,CAAA;AAAA,IACT,QAAQ,CAAA;AAAA;AAAA,IAKR,UAAU,CAAA;AAAA,EAAC;AAAA,EAKb,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,WAAW;AAAA,EAAA;AAAA,EAEb,QAAQ;AAAA,IACN,QAAQ,CAAC,GAAG,WAAgC,OAAO;AAAA,EAAA;AAAA,EAErD,SAAS;AAAA,IACP,gBAAgB,MAAM,EAAE,MAAM,mBAAmB;AAAA,IACjD,iBAAiB,MAAM,EAAE,MAAM,oBAAoB;AAAA,IACnD,qBAAqB,MAAM;AAAA,MACzB,MAAM;AAAA,IAAA,CACP;AAAA,IACD,gBAAgB,OAAO,aAAa;AAAA,MAClC,MAAM;AAAA,IAAA,CACP;AAAA,EAAA;AAEL,CAAC,EAAE,cAAc;AAAA,EACf,IAAI;AAAA,EACJ,SAAS,CAAC,EAAE,aAAa;AAAA,IACvB,UAAU,qBAAA;AAAA,IACV,gBAAgB;AAAA,MACd,SAAS,MAAM;AAAA,MACf,gBAAgB,MAAM;AAAA,MACtB,aAAa,MAAM;AAAA,MACnB,WAAW,MAAM;AAAA,IAAA;AAAA,EACnB;AAAA,EAEF,SAAS;AAAA,EACT,QAAQ;AAAA,IACN;AAAA,MACE,IAAI;AAAA,MACJ,UAAU;AAAA,MACV,KAAK;AAAA,MACL,OAAO,CAAC,EAAE,QAAA,OAAe,EAAE,UAAU,QAAQ;MAC7C,YAAY;AAAA,QACV;AAAA,UACE,OAAO;AAAA,YACL,MAAM;AAAA,YACN,QAAQ,CAAC,EAAE,aAAa;AAAA,cACtB,QAAQ,MAAM,SAAS,OAAO,eAAe;AAAA,YAAA;AAAA,UAC/C;AAAA,UAEF,SAAS,CAAC,EAAE,MAAM,kBAAkB;AAAA,QAAA;AAAA,QAEtC;AAAA,UACE,OAAO;AAAA,YACL,MAAM;AAAA,YACN,QAAQ,CAAC,EAAE,aAAa;AAAA,cACtB,QAAQ,MAAM,SAAS,OAAO,OAAO;AAAA,YAAA;AAAA,UACvC;AAAA,UAEF,SAAS,CAAC,EAAE,MAAM,mBAAmB;AAAA,QAAA;AAAA,MACvC;AAAA,IACF;AAAA,IAEF;AAAA,MACE,IAAI;AAAA,MACJ,UAAU;AAAA,MACV,KAAK;AAAA,MACL,OAAO,CAAC,EAAE,eAAe;AAAA,QACvB,UAAU,QAAQ;AAAA,QAClB,GAAG,QAAQ;AAAA,MAAA;AAAA,MAEb,YAAY;AAAA,QACV;AAAA,UACE,OAAO;AAAA,YACL,MAAM;AAAA,YACN,QAAQ,CAAC,EAAE,aAAa;AAAA,cACtB,QAAQ,MAAM,SAAS,OAAO,oBAAoB;AAAA,YAAA;AAAA,UACpD;AAAA,UAEF,SAAS,CAAC,EAAE,MAAM,uBAAuB;AAAA,QAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAAA,EAEF,QAAQ;AAAA,IACN,SAAS;AAAA,MACP,SAAS;AAAA,MACT,QAAQ;AAAA,QACN,MAAM;AAAA,UACJ,IAAI;AAAA,YACF,mBAAmB;AAAA,cACjB,QAAQ;AAAA,cACR,SAAS,CAAC,EAAE,MAAM,kBAAkB;AAAA,YAAA;AAAA,YAEtC,oBAAoB,EAAE,QAAQ,QAAA;AAAA,UAAQ;AAAA,QACxC;AAAA,QAEF,WAAW;AAAA,UACT,IAAI;AAAA,YACF,wBAAwB,EAAE,QAAQ,OAAA;AAAA,UAAO;AAAA,QAC3C;AAAA,QAEF,OAAO,CAAA;AAAA,QACP,MAAM,EAAE,MAAM,QAAA;AAAA,MAAQ;AAAA,MAExB,QAAQ,EAAE,QAAQ,UAAA;AAAA,IAAU;AAAA,IAE9B,SAAS;AAAA,MACP,MAAM;AAAA,IAAA;AAAA,EACR;AAEJ,CAAC;AAOM,SAAS,gBAAgB,OAAgB;AAC9C,SAAO;AAAA,IACL,IAAI;AAAA,IACJ;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workbench",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "description": "Workbench component for the Sanity Content Operating System",
   "keywords": [],
   "homepage": "https://github.com/sanity-io/workbench/packages/@sanity/workbench#readme",
@@ -34,23 +34,34 @@
       "development": "./src/_exports/core.ts",
       "default": "./dist/core.js"
     },
+    "./system": {
+      "source": "./src/_exports/system.ts",
+      "development": "./src/_exports/system.ts",
+      "default": "./dist/system.js"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
     "@sanity/message-protocol": "^0.23.0",
+    "@sanity/telemetry": "^1.1.0",
     "rxjs": "^7.8.2",
     "semver": "^7.7.4",
+    "xstate": "^5.31.0",
     "zod": "^4.3.6",
     "@sanity/federation": "0.1.0-alpha.7"
   },
   "devDependencies": {
     "@sanity/pkg-utils": "^9.2.3",
+    "@sanity/sdk": "https://pkg.pr.new/sanity-io/sdk/@sanity/sdk@fbc9e08",
     "@types/semver": "^7.7.1",
     "typescript": "^6.0.2",
     "vite": "^7.3.1",
     "@repo/tsconfig": "0.0.1",
     "@repo/oxc-config": "0.0.0"
   },
+  "peerDependencies": {
+    "@sanity/sdk": "^2.9.0"
+  },
   "browserslist": "extends @sanity/browserslist-config",
   "engines": {
     "node": ">=20.19.1 <22 || >=22.12"

package/src/_exports/system.ts

@@ -0,0 +1 @@
+export * from "../system";

package/src/core/log/index.ts

@@ -26,6 +26,7 @@ export interface Logger {
   warn: (message: string, context?: LogContext) => void;
   info: (message: string, context?: LogContext) => void;
   debug: (message: string, context?: LogContext) => void;
+  child: (domain: string, context?: LogContext) => Logger;
 }
 
 const LEVELS: readonly LogLevel[] = ["none", "error", "warn", "info", "debug"];
@@ -37,6 +38,31 @@ interface LoggerOptions {
 }
 
 /**
+ * Creates a leveled logger with an optional namespace prefix and bound
+ * context. Calls below the configured `logLevel` are suppressed; `"none"`
+ * silences the logger entirely.
+ *
+ * Use {@link Logger.child} to derive a sub-logger with an extended namespace
+ * (e.g. `parent:domain`) that inherits the parent's level and merges its
+ * bound context.
+ *
+ * @param options - Logger configuration.
+ * @param options.namespace - Prepended to every message in `[brackets]`.
+ * @param options.context - Bound context merged with per-call context.
+ *   Per-call keys win on conflict.
+ * @param options.logLevel - Maximum verbosity to emit. Default `"info"`.
+ *
+ * @example
+ * ```ts
+ * const log = createLogger({ namespace: "checkout", logLevel: "debug" });
+ * log.info("placed", { orderId: "abc" });
+ * // → [checkout] placed { orderId: "abc" }
+ *
+ * const auth = log.child("auth", { tenant: "acme" });
+ * auth.warn("token expiring");
+ * // → [checkout:auth] token expiring { tenant: "acme" }
+ * ```
+ *
  * @public
  */
 export function createLogger({
@@ -76,6 +102,13 @@ export function createLogger({
     warn: (message, context) => logAtLevel("warn", message, context),
     info: (message, context) => logAtLevel("info", message, context),
     debug: (message, context) => logAtLevel("debug", message, context),
+    child: (domain, context) =>
+      createLogger({
+        logLevel,
+        namespace: namespace ? `${namespace}:${domain}` : domain,
+        context:
+          baseContext || context ? { ...baseContext, ...context } : undefined,
+      }),
   };
 }
 

package/src/core/projects.ts

@@ -57,7 +57,7 @@ export const Project = z.object({
     externalStudioHost: z.string().optional(),
     initialTemplate: z.string().optional(),
     cliInitializedAt: z.string().optional(),
-    integration: z.literal(["manage", "cli"]),
+    integration: z.string().optional(),
   }),
   isBlocked: z.boolean(),
   isDisabled: z.boolean(),

package/src/core/user-applications/core-app.ts

@@ -29,19 +29,22 @@ const CoreAppUserApplicationBase = UserApplicationBase.extend({
   title: z.string(),
   organizationId: OrganizationId,
   type: z.literal("coreApp"),
-  manifest: CoreAppUserApplicationManifest.nullable().optional(),
 });
 
+// Core apps surface their manifest exclusively via `activeDeployment.manifest`
+// — they have no top-level `manifest` field and no `manifestData`.
+const CoreAppActiveDeployment = ActiveDeployment.extend({
+  manifest: CoreAppUserApplicationManifest.nullable(),
+}).nullable();
+
 const InternalCoreAppUserApplication = CoreAppUserApplicationBase.extend({
   urlType: z.literal("internal"),
-  activeDeployment: ActiveDeployment.extend({
-    manifest: CoreAppUserApplicationManifest.nullable().optional(),
-  }).nullable(),
+  activeDeployment: CoreAppActiveDeployment,
 });
 
 const ExternalCoreAppUserApplication = CoreAppUserApplicationBase.extend({
   urlType: z.literal("external"),
-  activeDeployment: z.null(),
+  activeDeployment: CoreAppActiveDeployment,
 });
 
 /**
@@ -98,7 +101,17 @@ export class CoreAppApplication extends UserApplication<
   }
 
   get title() {
-    return this.activeDeployment?.manifest?.title ?? this.application.title;
+    return this.manifest?.title ?? this.application.title;
+  }
+
+  /**
+   * Resolves the core app's manifest from `activeDeployment.manifest`. This
+   * is the canonical (and only) slot for core app manifests — both for
+   * Sanity-deployed apps and for local CLI dev-server apps, which synthesise
+   * a deployment to surface the live manifest.
+   */
+  get manifest(): CoreAppUserApplicationManifest | null {
+    return this.activeDeployment?.manifest ?? null;
   }
 
   get subtitle() {

package/src/core/user-applications/studios/schemas.ts

@@ -18,7 +18,10 @@ const Workspace = z.object({
  */
 export type Workspace = z.output<typeof Workspace>;
 
-const ServerManifest = z.object({
+/**
+ * @public
+ */
+export const ServerManifest = z.object({
   buildId: z.string().optional(),
   bundleVersion: z.string().optional(),
   version: z.string().optional(),
@@ -32,6 +35,11 @@ const ServerManifest = z.object({
     .optional(),
 });
 
+/**
+ * @public
+ */
+export type ServerManifest = z.output<typeof ServerManifest>;
+
 /**
  * @public
  */
@@ -56,6 +64,9 @@ const StudioUserApplicationBase = UserApplicationBase.extend({
   title: z.string().nullable(),
   projectId: ProjectId,
   type: z.literal("studio"),
+  /**
+   * @deprecated Use `manifestData` instead.
+   */
   manifest: ClientManifest.nullable(),
   manifestData: z.object({ value: ClientManifest }).nullable(),
   autoUpdatingVersion: z.string().nullable(),