@frockbot/plugin-flock 0.3.10 → 0.3.12

package/src/client/state.ts

@@ -24,8 +24,10 @@ export interface FlockWebData {
    * Whether a directory read has ever completed.
    *
    * "No Bots yet." is a fact about the User's account, and it can only be
-   * stated once the account has been read. Before that — the first paint, and
-   * the reload after a Bot is created — the list is unknown, not empty.
+   * stated once the account has been read. Before that — the first paint, the
+   * reload after a Bot is created, and every read that failed — the list is
+   * unknown, not empty, and offering to create a first Bot to someone who
+   * already has several is the worst thing this column can say.
    */
   loaded: boolean;
   error?: string;

package/src/client/styles.css

@@ -16,6 +16,13 @@
   border-radius: 9px;
 }
 
+/* The pinned sidebar tile: round, so a pin reads as a destination not a row. */
+.flock-avatar--tile {
+  width: var(--frock-avatar-lg);
+  height: var(--frock-avatar-lg);
+  border-radius: 50%;
+}
+
 .flock-avatar--large {
   width: 188px;
   height: 188px;
@@ -63,6 +70,88 @@
   color: var(--frock-text);
 }
 
+/*
+ * Pinned Bots. A wrapping row of large round tiles above the labelled groups,
+ * each one a whole Bot rather than a line of text about it.
+ */
+.flock-pinned {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  padding: 4px 6px 10px;
+  border-bottom: 1px solid var(--frock-border);
+  margin-bottom: 8px;
+}
+
+.flock-pinned-tile {
+  display: flex;
+  width: 72px;
+  flex: 0 0 auto;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 2px;
+  border: 0;
+  border-radius: var(--frock-radius-card);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+  transition: background-color var(--frock-motion-fast);
+}
+
+.flock-pinned-tile:hover:not(:disabled) {
+  background: var(--frock-fill-hover);
+}
+
+.flock-pinned-tile.active {
+  background: var(--frock-fill-pressed);
+}
+
+.flock-pinned-tile.archived {
+  opacity: 0.72;
+  cursor: default;
+}
+
+.flock-pinned-tile:focus-visible {
+  outline: 2px solid var(--frock-focus-ring);
+  outline-offset: 2px;
+}
+
+.flock-pinned-art {
+  position: relative;
+  display: inline-flex;
+}
+
+/* The tile has no preview line, so unread is a dot rather than bold text. */
+.flock-pinned-dot {
+  position: absolute;
+  right: 0;
+  bottom: 2px;
+  width: 10px;
+  height: 10px;
+  border-radius: 999px;
+  background: var(--frock-action-primary);
+  box-shadow: 0 0 0 2px var(--frock-surface);
+}
+
+.flock-pinned-name {
+  max-width: 100%;
+  overflow: hidden;
+  color: var(--frock-text-muted);
+  font-size: var(--frock-text-xs);
+  line-height: var(--frock-leading-tight);
+  text-align: center;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.flock-pinned-tile.active .flock-pinned-name,
+.flock-pinned-tile.unread .flock-pinned-name {
+  color: var(--frock-text);
+  font-weight: 600;
+}
+
 .flock-groups,
 .flock-group,
 .flock-rows {
@@ -268,6 +357,24 @@
   color: var(--frock-danger-text);
 }
 
+/* The way to try the read again, beside the sentence that says it failed. */
+.flock-retry {
+  display: inline-block;
+  margin-top: 6px;
+  border: 1px solid var(--frock-border);
+  border-radius: var(--frock-radius-control);
+  background: transparent;
+  color: var(--frock-text);
+  padding: 2px 8px;
+  font: inherit;
+  font-size: var(--frock-text-xs);
+  cursor: pointer;
+}
+
+.flock-retry:hover {
+  background: var(--frock-fill-hover);
+}
+
 /* Header identity */
 
 .flock-identity-button {

package/src/shared.test.ts

@@ -184,6 +184,28 @@ describe("Flock v1 contracts", () => {
       }),
     ).toThrow("duplicate IDs");
   });
+
+  test("carries the pin instant, and refuses one that is not an instant", () => {
+    const identity = {
+      schemaVersion: 1 as const,
+      botId: "alpha",
+      name: "Atlas",
+      namedBy: "user" as const,
+      hiddenFromSidebar: false,
+      pinnedAt: "2026-09-03T10:15:00.000Z",
+    };
+    expect(decodeBotIdentityViewV1(structuredClone(identity))).toEqual(
+      identity,
+    );
+    // Absent stays absent: every identity written before pinning existed.
+    const { pinnedAt: _pinnedAt, ...unpinned } = identity;
+    expect(decodeBotIdentityViewV1(structuredClone(unpinned))).toEqual(
+      unpinned,
+    );
+    expect(() =>
+      decodeBotIdentityViewV1({ ...identity, pinnedAt: "someday" }),
+    ).toThrow("pinnedAt is invalid");
+  });
 });
 
 describe("stored Bot directory migration", () => {

package/src/shared.ts

@@ -137,6 +137,12 @@ export interface BotIdentityViewV1 {
   /** Purely organisational sidebar group; never part of Bot instructions. */
   label?: string;
   title?: string;
+  /**
+   * When the User pinned this Bot, as an ISO 8601 instant. A pinned Bot is
+   * shown as a tile above the list instead of a row inside it, earliest pin
+   * first. Absent means not pinned.
+   */
+  pinnedAt?: string;
 }
 
 export interface BotIdentityDirectoryViewV1 {
@@ -600,7 +606,7 @@ export function decodeBotIdentityViewV1(input: unknown): BotIdentityViewV1 {
   exact(
     value,
     ["schemaVersion", "botId", "name", "namedBy", "hiddenFromSidebar"],
-    ["label", "title"],
+    ["label", "title", "pinnedAt"],
   );
   if (value.schemaVersion !== 1 || typeof value.hiddenFromSidebar !== "boolean")
     throw new FlockDecodeError("Bot identity is invalid");
@@ -616,9 +622,20 @@ export function decodeBotIdentityViewV1(input: unknown): BotIdentityViewV1 {
     ...(value.title === undefined
       ? {}
       : { title: boundedText(value.title, "title", 120) }),
+    ...(value.pinnedAt === undefined
+      ? {}
+      : { pinnedAt: timestampText(value.pinnedAt, "pinnedAt") }),
   };
 }
 
+/** An ISO 8601 instant. The sidebar orders pinned Bots by it. */
+function timestampText(value: unknown, label: string): string {
+  const candidate = boundedText(value, label, 64);
+  if (!Number.isFinite(Date.parse(candidate)))
+    throw new FlockDecodeError(`${label} is invalid`);
+  return candidate;
+}
+
 export function decodeBotIdentityDirectoryViewV1(
   input: unknown,
 ): BotIdentityDirectoryViewV1 {