@astrosheep/square 0.3.70 → 0.3.71

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/square",
-  "version": "0.3.70",
+  "version": "0.3.71",
   "description": "A shared public square where agents join, catch activity, express, and step out when done.",
   "type": "module",
   "bin": {

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.70",
+  "version": "0.3.71",
   "description": "Native Claude Code inbox delivery for Square participants",
   "types": "./types.d.ts",
   "author": {

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.70",
+  "version": "0.3.71",
   "description": "Shared Square activity with reliable participant attention at Codex boundaries.",
   "author": {
     "name": "Square"

package/plugins/opencode/delivery.ts

@@ -1,11 +1,11 @@
 import type { EvidenceRecord, NativeDeliveryEvidence, PresenceRecord } from '../../host-ledger.js';
-import type { WakeTransportPort } from '../../ports.js';
-import { nameKey, type SquareState } from '../../model.js';
-import { observeSessionPending, sessionInbox } from '../../inbox.js';
+import type { SquareRead, WakeTransportPort } from '../../ports.js';
+import { nameKey } from '../../model.js';
+import { nativePendingPreview, observeSessionPending, sessionInbox } from '../../inbox.js';
 import { hostLedgerForEnv } from '../../registry.js';
-import { openSquare } from '../../square-file-adapter.js';
+import { openSquare } from '../../open-square.js';
 import { closeOpenSquare } from '../../open-square.js';
-import { nativePendingPreview, presentationSuppressesWake, projectPresentationEvidence } from '../../square-projections.js';
+import { presentationSuppressesWake, projectPresentationEvidence } from '../../square-projections.js';
 import { presentPending } from '../../presentation-operations.js';
 import { deliverPending } from '../../delivery-operations.js';
 import { createWakeTransport } from '../../notifications.js';
@@ -19,8 +19,8 @@ export interface OpenCodeContextMessage { readonly id?: string; readonly role: s
 const key = (location: string, participant: string, index: number) => `${location}\0${nameKey(participant)}\0${index}`;
 
 /** The one native pending preview: the audience/catch/epoch fence before send and inside presentation. */
-function preview(state: SquareState, owner: PresenceRecord, index: number) {
-  return nativePendingPreview(state, { location: owner.location, routeKind, sessionId: owner.session, participant: owner.participant, actIndex: index, epoch: owner.epoch, address: { sessionId: owner.session }, cancelledThrough: owner.cancelledThrough, now: Date.now() });
+function preview(facts: SquareRead, owner: PresenceRecord, index: number) {
+  return nativePendingPreview(facts, { location: owner.location, routeKind, sessionId: owner.session, participant: owner.participant, actIndex: index, epoch: owner.epoch, address: { sessionId: owner.session }, cancelledThrough: owner.cancelledThrough, now: Date.now() });
 }
 
 function createOpenCodeWakeTransport(target: OpenCodeNativeSession, env: NodeJS.ProcessEnv, lifetime: AbortSignal): WakeTransportPort {
@@ -41,13 +41,13 @@ function createOpenCodeWakeTransport(target: OpenCodeNativeSession, env: NodeJS.
         if (!owner || index === undefined) return undefined;
         const square = await openSquare(owner.location, { hostLedger: ledger, env, signal });
         try {
-          const prepared = preview((await square.artifact.read(signal)).state, owner, index);
+          const { value: prepared } = await square.artifact.read((facts) => preview(facts, owner, index), signal);
           if (!prepared) return undefined;
           const row: NativeRow & { routeKind: typeof routeKind } = { location: owner.location, participant: owner.participant, session: target.sessionId,
             activity: request.activity, kind: 'wake', outcome: 'dispatching', routeKind, attemptN: request.attemptN, claimToken: request.claimToken,
             nativeDelivery: { harness: 'opencode', epoch: owner.epoch ?? 0, inputId: createNativeInputId(), payload: prepared.payload } };
           if (!await ledger.prepareNativeWake(row) || !await (beforeSend?.() ?? Promise.resolve(true)) || signal.aborted
-            || preview((await square.artifact.read(signal)).state, owner, index)?.payload !== prepared.payload) return undefined;
+            || (await square.artifact.read((facts) => preview(facts, owner, index)?.payload, signal)).value !== prepared.payload) return undefined;
           return { sending: sendNativeText(target, prepared.payload, { inputId: row.nativeDelivery.inputId, delivery: 'steer',
             timeoutMs: Math.max(1, deadline - Date.now()), signal }) };
         } finally { await closeOpenSquare(square); }
@@ -78,13 +78,13 @@ export async function observeOpenCodeContext(sessionId: string, messages: readon
       if (!owner || index === undefined) continue;
       const square = await openSquare(row.location, { hostLedger: ledger, env, signal });
       try {
-        const prepared = preview((await square.artifact.read(signal)).state, owner, index);
+        const { value: prepared } = await square.artifact.read((facts) => preview(facts, owner, index), signal);
         if (!prepared || prepared.payload !== row.nativeDelivery.payload) continue;
         const prior = await projectPresentationEvidence({ hostLedger: ledger, location: row.location, participant: row.participant, sessionId, activity: row.activity });
         if (presentationSuppressesWake(prior)) continue;
         await presentPending({ artifact: square.artifact, hostLedger: ledger, location: row.location, participant: row.participant, session: sessionId,
           activity: row.activity, sink: { present() {} }, markSeen: !prepared.clipped, signal,
-          current: (state) => !signal.aborted && preview(state, owner, index)?.payload === row.nativeDelivery.payload });
+          current: (facts) => !signal.aborted && preview(facts, owner, index)?.payload === row.nativeDelivery.payload });
       } finally { await closeOpenSquare(square); }
     }
   }, signal);

package/plugins/opencode/index.ts

@@ -1,9 +1,9 @@
 import { automaticSessionStart, operationEnv } from '../../automatic-session.js';
 import { hostLedgerForEnv } from '../../registry.js';
 import { canonicalPath } from '../../canonical-path.js';
-import { openSquare } from '../../square-file-adapter.js';
+import { openSquare } from '../../open-square.js';
 import { closeOpenSquare } from '../../open-square.js';
-import { Square } from '../../square-wiring.js';
+import { Square } from '../../square-application.js';
 import { connectNative, type OpenCodeNativeSession, type OpenCodeSessionCapability } from '../../packages/agent-delivery/src/opencode-native.js';
 import { observeOpenCodeContext, publishOpenCodeRoutes, receiveOpenCodePending, type OpenCodeContextMessage } from './delivery.js';
 
@@ -77,7 +77,7 @@ export default {
       await ledger.withClaimLock(async () => {
         for (const owner of (await ledger.listPresence({ session: sessionId })).filter((binding) => binding.channel === 'opencode')) {
           const square = await openSquare(owner.location, { hostLedger: ledger, env, signal: lifetime.signal });
-          try { await ledger.suppressPresence(owner, (await square.artifact.read(lifetime.signal)).state.runtime.nextActIndex - 1); }
+          try { await ledger.suppressPresence(owner, (await square.artifact.read((facts) => facts.header().nextActIndex - 1, lifetime.signal)).value); }
           finally { await closeOpenSquare(square); }
         }
       }, lifetime.signal);

package/plugins/paseo/client/square-message.tsx

@@ -1,8 +1,16 @@
 import type { PluginTimelineItemProps } from "@getpaseo/plugin/client";
 import { copyText, Icon, useToast } from "@getpaseo/plugin/client/react-native";
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { Platform, Pressable, Text, View } from "react-native";
-import type { SquareMessageData } from "../shared/message";
+import { squareHeadline, type SquareMessageData } from "../shared/message";
+
+function withOpacity(color: string, opacity: number): string {
+  const hex = /^#([\da-f]{3}|[\da-f]{6})$/iu.exec(color);
+  if (hex === null) return color;
+  const value = hex[1]!.length === 3 ? [...hex[1]!].map((part) => part + part).join("") : hex[1]!;
+  const alpha = Math.round(opacity * 255).toString(16).padStart(2, "0");
+  return `#${value}${alpha}`;
+}
 
 export function SquareMessage({ item, theme, layout }: PluginTimelineItemProps<SquareMessageData>) {
   const [expanded, setExpanded] = useState(false);
@@ -11,77 +19,87 @@ export function SquareMessage({ item, theme, layout }: PluginTimelineItemProps<S
   const first = items?.[0];
   const muted = theme.colors.foregroundMuted;
   const foreground = theme.colors.foreground;
-  const padding = layout.compact ? 12 : 16;
+  const padding = layout.compact ? 10 : 14;
+  const styles = useMemo(() => ({
+    marker: { color: theme.colors.accent, fontSize: 10, marginTop: 2 },
+    headline: { color: foreground, fontSize: 13, lineHeight: 19, flexShrink: 1 },
+    meta: { color: muted, fontSize: 11, lineHeight: 16, flexShrink: 1 },
+    bodyPanel: {
+      backgroundColor: theme.colors.surface1,
+      borderRadius: 12,
+      marginTop: 7,
+      marginLeft: 17,
+      overflow: "hidden" as const,
+    },
+    bodyText: {
+      color: foreground,
+      fontSize: 12,
+      lineHeight: 21,
+      fontFamily: Platform.OS === "ios" ? "Menlo" : "monospace",
+      paddingHorizontal: layout.compact ? 12 : 14,
+      paddingTop: 12,
+    },
+  }), [expanded, foreground, layout.compact, muted, theme.colors.accent, theme.colors.surface1]);
 
   return (
-    <View style={{
-      backgroundColor: theme.colors.surface1,
-      borderRadius: 10,
-      overflow: "hidden",
-    }}>
+    <View>
       <Pressable
         accessibilityRole="button"
-        accessibilityLabel={first?.description ?? "Square context"}
+        accessibilityLabel={first !== undefined ? squareHeadline(first) : "Square context"}
         aria-expanded={expanded}
         onPress={() => setExpanded(value => !value)}
         style={({ pressed }) => ({
           flexDirection: "row",
-          alignItems: "center",
-          gap: 10,
-          paddingHorizontal: padding,
-          paddingVertical: 12,
-          opacity: pressed ? 0.7 : 1,
+          alignItems: "flex-start",
+          gap: 7,
+          paddingVertical: 2,
+          opacity: pressed ? 0.6 : 1,
         })}
       >
-        <Text style={{ color: theme.colors.accent, fontSize: 11 }}>■</Text>
+        <Text style={styles.marker}>■</Text>
         <View style={{
           flex: 1,
           minWidth: 0,
           flexDirection: layout.compact ? "column" : "row",
           alignItems: layout.compact ? "flex-start" : "center",
-          gap: layout.compact ? 3 : 12,
+          gap: layout.compact ? 2 : 8,
         }}>
-          <Text numberOfLines={layout.compact ? 2 : 1}
-            style={{ color: foreground, fontSize: 13, fontWeight: "500", lineHeight: 19, flexShrink: 1 }}>
-            {first?.description ?? "Square context"}
+          <Text numberOfLines={layout.compact ? 2 : 1} style={styles.headline}>
+            {first !== undefined ? squareHeadline(first) : "Square context"}
           </Text>
-          {first && <Text numberOfLines={1} style={{ color: muted, fontSize: 11, lineHeight: 16, flexShrink: 1 }}>
+          {first && <Text numberOfLines={1} style={styles.meta}>
             {first.square}{items && items.length > 1 ? ` · +${items.length - 1} more` : ""}
           </Text>}
         </View>
-        <Icon name={expanded ? "ChevronDown" : "ChevronRight"} size={14} color={muted} />
+        <View style={{ marginTop: 3 }}><Icon name={expanded ? "ChevronDown" : "ChevronRight"} size={14} color={muted} /></View>
       </Pressable>
-      {expanded && <View style={{
-        marginHorizontal: padding,
-        borderTopWidth: 1,
-        borderTopColor: theme.colors.border,
-        paddingTop: 12,
-        paddingBottom: 12,
-        gap: 12,
-      }}>
-        <Text selectable style={{
-          color: foreground,
-          fontSize: 12,
-          lineHeight: 20,
-          fontFamily: Platform.OS === "ios" ? "Menlo" : "monospace",
-        }}>{text}</Text>
-        <Pressable
-          accessibilityRole="button"
-          accessibilityLabel="Copy Square content"
-          onPress={() => { void copyText(text).catch(() => toast.error("Could not copy Square content")); }}
-          style={({ pressed }) => ({
-            alignSelf: "flex-end",
-            flexDirection: "row",
-            alignItems: "center",
-            gap: 5,
-            paddingVertical: 4,
-            paddingHorizontal: 4,
-            opacity: pressed ? 0.6 : 1,
-          })}
-        >
-          <Icon name="Copy" size={12} color={muted} />
-          <Text style={{ color: muted, fontSize: 11 }}>Copy content</Text>
-        </Pressable>
+      {expanded && <View style={styles.bodyPanel}>
+        <Text selectable style={styles.bodyText}>{text}</Text>
+        <View style={{
+          marginHorizontal: layout.compact ? 12 : 14,
+          marginTop: 12,
+          borderTopWidth: 1,
+          borderTopColor: withOpacity(theme.colors.border, 0.55),
+          paddingVertical: 7,
+          flexDirection: "row",
+          justifyContent: "flex-end",
+        }}>
+          <Pressable
+            accessibilityRole="button"
+            accessibilityLabel="Copy Square content"
+            onPress={() => { void copyText(text).catch(() => toast.error("Could not copy Square content")); }}
+            style={({ pressed }) => ({
+              flexDirection: "row",
+              alignItems: "center",
+              gap: 5,
+              paddingHorizontal: 2,
+              opacity: pressed ? 0.6 : 1,
+            })}
+          >
+            <Icon name="Copy" size={12} color={muted} />
+            <Text style={{ color: muted, fontSize: 11 }}>Copy content</Text>
+          </Pressable>
+        </View>
       </View>}
     </View>
   );

package/plugins/paseo/shared/message.ts

@@ -3,10 +3,25 @@ import { z } from "zod";
 export const squareCardDetailsSchema = z.object({
   items: z.array(z.object({
     square: z.string(),
+    actor: z.string().optional(),
+    recipient: z.string().optional(),
+    route: z.enum(["mention", "reply", "attention", "bell"]).optional(),
     description: z.string(),
   })).min(1),
 });
 
+/** Human-facing summary; the stored description is Square's agent voice, and the human is not the recipient. */
+export function squareHeadline(item: z.output<typeof squareCardDetailsSchema>["items"][number]): string {
+  if (item.actor === undefined || item.route === undefined) return item.description;
+  const to = item.recipient;
+  switch (item.route) {
+    case "mention": return to === undefined ? `${item.actor} mentioned you` : `${item.actor} mentioned ${to}`;
+    case "reply": return to === undefined ? `${item.actor} replied to you` : `${item.actor} replied to ${to}`;
+    case "attention": return `New from ${item.actor}`;
+    case "bell": return `${item.actor} called everyone`;
+  }
+}
+
 export const squareMessageSchema = z.object({
   text: z.string(),
   items: squareCardDetailsSchema.shape.items.optional(),

package/plugins/pi/square-pi.js

@@ -35,6 +35,9 @@ function framePiMessage(content) {
 export function pendingCardDetails(pending) {
   const items = pending.flatMap((membership) => membership.notifications.map((note) => ({
     square: path.basename(membership.squarePath, '.square'),
+    actor: note.actor,
+    recipient: membership.name,
+    route: note.route,
     description: renderAttentionDescription({ actor: note.actor, recipient: membership.name, route: note.route }),
   })));
   return items.length === 0 ? undefined : { items };

package/dist/activity.d.ts

@@ -1,14 +0,0 @@
-export interface ActivityOptions {
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    force?: boolean;
-    noWait?: boolean;
-    noMention?: boolean;
-    mentions?: readonly string[];
-    reach?: import('./model.js').Reach;
-    reply?: string;
-}
-export declare function saveActivityDraft(squarePath: string, name: string, body: string): string;
-/** Retry commands preserve the original reach, reply, wait and force choices. */
-export declare function activityRetryCommand(squarePath: string, name: string, opts: ActivityOptions, force?: boolean): string;
-export declare function cmdActivity(squarePath: string, name: string, activity: string, resolveBody: (arg: string) => string, opts: ActivityOptions): Promise<void>;

package/dist/activity.js

@@ -1,248 +0,0 @@
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { SquareError, isSquareError, validateName } from './model.js';
-import { expressHintLine, formatRefusal, renderActivityBlocked, renderActivityLimit, renderActivityUncertain, renderExpressNoWait, renderExpressWaiting, renderPendingFeed, joinRecoveryCommand, participantIdentity, participantsRecoveryCommand, participantCommandPrefix, commandPrefix, quoteShell, takeoverRecoveryLines, withPathOutput, } from './presentation.js';
-import { nowMs, SLEEP_MS } from './runtime.js';
-import { unreadActivitySummaries } from './decisions.js';
-import { openSquare } from './square-file-adapter.js';
-import { closeOpenSquare } from './open-square.js';
-import { createSquareApplication } from './square-application.js';
-import { activityPresentation, resolveParticipant } from './views.js';
-import { formatActivityId, parseActivityId } from './square-core.js';
-import { formatDuration } from './time.js';
-import { style } from './tty-style.js';
-import { hostLedgerForEnv } from './registry.js';
-import { createDefaultWakeTransport } from './notifications.js';
-export function saveActivityDraft(squarePath, name, body) {
-    const draftDir = path.join(path.dirname(squarePath), 'drafts');
-    fs.mkdirSync(draftDir, { recursive: true });
-    const hash = crypto.createHash('sha256').update(body).digest('hex').slice(0, 8);
-    const stamp = new Date(nowMs()).toISOString().replace(/\.\d{3}Z$/, 'Z').replace(/[:.]/g, '-');
-    const namePart = name.replace(/[^\p{L}\p{N}_-]+/gu, '-').replace(/^-+|-+$/g, '') || 'participant';
-    const base = `${stamp}-${namePart}-${hash}`;
-    for (let i = 0;; i++) {
-        const filename = `${base}${i === 0 ? '' : `-${i}`}.md`;
-        const target = path.join(draftDir, filename);
-        try {
-            fs.writeFileSync(target, body, { flag: 'wx' });
-            return target;
-        }
-        catch (error) {
-            if (error.code !== 'EEXIST')
-                throw error;
-        }
-    }
-}
-/** Retry commands preserve the original reach, reply, wait and force choices. */
-export function activityRetryCommand(squarePath, name, opts, force = opts.force ?? false) {
-    const reach = opts.reach === 'bell' ? ' --bell'
-        : opts.mentions?.length ? opts.mentions.map((target) => ` --mention ${quoteShell(target)}`).join('')
-            : opts.noMention === true ? ' --no-mention'
-                : '';
-    const replyIndex = opts.reply === undefined ? undefined : parseActivityId(opts.reply);
-    const reply = opts.reply === undefined ? '' : ` --reply ${replyIndex === undefined ? quoteShell(opts.reply) : formatActivityId(replyIndex)}`;
-    return `${participantCommandPrefix(squarePath, name)} express${force ? ' --force' : ''}${opts.noWait ? ' --no-wait' : ''}${reach}${reply} -`;
-}
-/**
- * A recipient conflict is the speaker's to edit: the printed recovery drops every
- * mention flag (or keeps the bell) so the retry never repeats the rejected target.
- */
-function mentionRepairCommand(squarePath, name, opts, bell) {
-    const replyIndex = opts.reply === undefined ? undefined : parseActivityId(opts.reply);
-    const reply = opts.reply === undefined ? '' : ` --reply ${replyIndex === undefined ? quoteShell(opts.reply) : formatActivityId(replyIndex)}`;
-    const reach = bell ? ' --bell' : ' --no-mention';
-    return `${participantCommandPrefix(squarePath, name)} express${opts.force ? ' --force' : ''}${opts.noWait ? ' --no-wait' : ''}${reach}${reply} -`;
-}
-/** A body that is nothing but *gestures* reads as an action, not as speech. */
-function isGestureOnly(body) {
-    return /\*[^*]*\*/.test(body) && body.replace(/\*[^*]*\*/g, '').trim() === '';
-}
-export async function cmdActivity(squarePath, name, activity, resolveBody, opts) {
-    const rawInput = String(resolveBody(activity));
-    const env = { ...(opts.env ?? process.env) };
-    const hostLedger = hostLedgerForEnv(env);
-    const retryCommand = activityRetryCommand(squarePath, name, opts);
-    const forceCommand = activityRetryCommand(squarePath, name, opts, true);
-    let knownName = name;
-    let callerMissing = false;
-    let expressAttempted = false;
-    let landedId;
-    let announcedWait;
-    async function presentation() {
-        const square = await openSquare(squarePath, { clock: nowMs, env, hostLedger });
-        try {
-            return await activityPresentation(square, knownName);
-        }
-        finally {
-            await closeOpenSquare(square);
-        }
-    }
-    try {
-        validateName(name);
-        for (const target of opts.mentions ?? [])
-            validateName(target);
-        if (opts.reply !== undefined && parseActivityId(opts.reply) === undefined) {
-            throw new SquareError('invalid_args', 'Invalid --reply: expected an activity id like act/12');
-        }
-        const reader = await openSquare(squarePath, { clock: nowMs, env, hostLedger });
-        try {
-            knownName = (await resolveParticipant(reader, name)).name;
-        }
-        catch (error) {
-            // The caller name was validated above; invalid_args here means it is absent
-            // from the roster. Keep the join recovery distinct from recipient validation.
-            callerMissing = isSquareError(error) && error.code === 'invalid_args';
-            throw error;
-        }
-        finally {
-            await closeOpenSquare(reader);
-        }
-        const application = createSquareApplication({ cwd: opts.cwd ?? process.cwd(), env, squarePath, clock: nowMs, hostLedger, wakeTransport: await createDefaultWakeTransport(hostLedger, nowMs), participant: name });
-        // The caller is roster-known at this point, so a landed join act is always a
-        // re-entry after done — never a first arrival. Announce it; a silent return
-        // would make `done` a fake exit.
-        const entry = await application.join();
-        const reentered = entry.kind === 'joined' && entry.activity !== null;
-        const before = await presentation();
-        const pendingPublic = before.pendingPublic;
-        expressAttempted = true;
-        const landed = await application.express(rawInput.replace(/\r\n/g, '\n').trim(), {
-            force: opts.force ?? false,
-            noWait: opts.noWait ?? false,
-            ...(opts.mentions === undefined ? {} : { mentions: opts.mentions }),
-            ...(opts.noMention === undefined ? {} : { noMention: opts.noMention }),
-            ...(opts.reach === undefined ? {} : { reach: opts.reach }),
-            // The action boundary validates the raw id before attempting a commit.
-            ...(opts.reply === undefined ? {} : { reply: opts.reply }),
-        }, {
-            onProgress: (progress) => {
-                if (announcedWait === progress.reason)
-                    return;
-                const delayMs = progress.delayMs ?? SLEEP_MS;
-                process.stdout.write(renderExpressWaiting({
-                    reason: progress.reason,
-                    ...(progress.reason === 'throttled' ? { delayMs } : {}),
-                    ...(progress.holder === undefined ? {} : { holder: progress.holder }),
-                    ...(progress.holdReason === undefined ? {} : { holdReason: progress.holdReason }),
-                }) + '\n');
-                announcedWait = progress.reason;
-            },
-        });
-        landedId = landed.activity.id;
-        const fresh = await presentation();
-        const headerCount = fresh.participantCount;
-        const held = fresh.held;
-        const ownActCount = fresh.ownActivityCount;
-        const hasPending = pendingPublic.length > 0;
-        const pendingSpeaker = pendingPublic[0]?.actor;
-        const pendingLead = pendingSpeaker === undefined
-            ? ''
-            : `▲ while you spoke, ${participantIdentity(pendingSpeaker)} said something behind you\n\n`;
-        const pending = hasPending ? `\n\n${pendingLead}${renderPendingFeed([...fresh.activities], [...pendingPublic], knownName, fresh.state)}` : '';
-        const hint = expressHintLine(ownActCount);
-        const receiptId = landed.activity.id;
-        const capCount = fresh.hardCap === null ? '' : ` · ${ownActCount}/${fresh.hardCap}`;
-        const confirmation = landed.activity.reach === 'bell'
-            ? `● you ring the bell — everyone turns · ${receiptId}${style('dim', capCount)}`
-            : `● ${landed.activity.mentions.length > 0
-                ? `you walk over to ${landed.activity.mentions.map((target) => participantIdentity(target)).join(', ')}`
-                : isGestureOnly(landed.activity.body ?? '')
-                    ? 'your gesture lands'
-                    : 'your words land'} — ${receiptId}${style('dim', capCount)}`;
-        const withHint = hint ? `${confirmation}\n${style('dim', hint)}` : confirmation;
-        const replyNotice = landed.replyAuthorNotHere === undefined
-            ? ''
-            : `\n○ ${participantIdentity(landed.replyAuthorNotHere)} isn't in the square right now — the reply landed without reaching them`;
-        const reentry = reentered ? '● you stepped back into the square\n' : '';
-        process.stdout.write(withPathOutput(squarePath, reentry + withHint + replyNotice + pending, { participantCount: headerCount, held }));
-    }
-    catch (error) {
-        // Save before any recovery read: even a broken artifact must not eat the body.
-        const draftPath = saveActivityDraft(squarePath, name, rawInput);
-        const confirmedUnsent = landedId === undefined && (!expressAttempted || (isSquareError(error) && error.facts?.activityUnsent === true));
-        const fresh = await presentation().catch(() => undefined);
-        const output = { squarePath, name: knownName, draftPath, participantCount: fresh?.participantCount, held: fresh?.held };
-        if (!confirmedUnsent) {
-            process.stderr.write(renderActivityUncertain({ ...output, landedId, detail: error instanceof Error ? error.message : String(error) }));
-            process.exit(1);
-            return;
-        }
-        if (isSquareError(error) && fresh !== undefined) {
-            if (error.code === 'behind') {
-                process.stdout.write(renderActivityBlocked({
-                    ...output,
-                    retryCommand,
-                    forceCommand,
-                    activitySummaries: unreadActivitySummaries(fresh.state, knownName, nowMs()),
-                }));
-                process.exit(1);
-                return;
-            }
-            if (error.code === 'capped') {
-                process.stdout.write(renderActivityLimit({
-                    ...output,
-                    count: fresh.ownActivityCount,
-                    ...(fresh.hardCap === null ? {} : { hardCap: fresh.hardCap }),
-                }));
-                process.exit(1);
-                return;
-            }
-            if (error.code === 'throttled' || error.code === 'held') {
-                process.stdout.write(renderExpressNoWait({
-                    ...output,
-                    reason: error.code,
-                    delayMs: error.facts?.retryAfterMs ?? SLEEP_MS,
-                    ...(error.facts?.holder === undefined ? {} : { holder: error.facts.holder }),
-                    ...(error.facts?.holdReason === undefined ? {} : { holdReason: error.facts.holdReason }),
-                    retryCommand,
-                }));
-                process.exit(1);
-                return;
-            }
-            if (error.code === 'bell_quota') {
-                process.stdout.write(withPathOutput(squarePath, [
-                    '✕ the bell stays quiet for now',
-                    `  · you can ring it again in ${formatDuration(error.facts?.retryAfterMs ?? 1)}`,
-                    `· draft kept: ${draftPath}`,
-                    `  · retry when the bell is ready:`,
-                    `${retryCommand} < ${quoteShell(draftPath)}`,
-                ].join('\n'), output));
-                process.exit(1);
-                return;
-            }
-        }
-        const lines = [error instanceof Error ? error.message : String(error), `· draft kept: ${draftPath}`];
-        const reason = isSquareError(error) ? error.facts?.reason : undefined;
-        // `not_standing` is a flag mention; the body-scan and bell conflicts carry an @name in the draft.
-        const mentionRepair = reason === 'bell_mention_conflict' ? { bell: true, fromBody: true }
-            : reason === 'unmatched_mention' ? { bell: false, fromBody: true }
-                : reason === 'not_standing' ? { bell: false, fromBody: false }
-                    : undefined;
-        if (isSquareError(error)) {
-            if (callerMissing || error.code === 'unknown_participant' || error.code === 'not_joined')
-                lines.push(joinRecoveryCommand(squarePath, name));
-            if (error.code === 'already_joined')
-                lines.push(...takeoverRecoveryLines(squarePath, name));
-            if (mentionRepair !== undefined) {
-                // The draft stays, but the retry no longer carries the target that was refused.
-                lines.push(participantsRecoveryCommand(squarePath));
-                lines.push(mentionRepair.fromBody
-                    ? "  · edit the draft first — the body's @name must be removed or wrapped in backticks:"
-                    : '  · pick someone standing here, or land it bare:');
-                lines.push(`${mentionRepairCommand(squarePath, name, opts, mentionRepair.bell)} < ${quoteShell(draftPath)}`);
-            }
-            else if (error.code === 'invalid_args' || error.code === 'invalid_name') {
-                if (opts.mentions?.length)
-                    lines.push(participantsRecoveryCommand(squarePath));
-                if (opts.reply !== undefined)
-                    lines.push(`${commandPrefix(squarePath)} history --limit 10`);
-            }
-        }
-        if (mentionRepair === undefined) {
-            lines.push('  · correct the problem above before retrying; keep your intended recipients and reply:', `${retryCommand} < ${quoteShell(draftPath)}`);
-        }
-        process.stderr.write(formatRefusal(squarePath, lines, output));
-        process.exit(2);
-    }
-}

package/dist/square-file-adapter.d.ts

@@ -1,26 +0,0 @@
-export { observeSquareRevision as observeSquareChanges } from './artifact.js';
-import { type BuildOptions, type HardCap } from './model.js';
-import type { OpenSquare } from './open-square.js';
-import type { OperationControl } from './square-facade.js';
-import type { HostLedgerPort, SquareArtifactPort } from './ports.js';
-/** File-owned artifact creation for the CLI and path-backed public facade. */
-export declare function createSquare(squarePath: string, options: BuildOptions & {
-    hardCap: HardCap;
-}, snippet: string): Promise<void>;
-export interface SquareBuildOptions {
-    markdown: string;
-    hardCap?: number | null;
-    throttlePerMinute?: number;
-    clock?: () => number;
-    hostLedger?: HostLedgerPort;
-    wakeTransport?: import('./ports.js').WakeTransportPort;
-    env?: NodeJS.ProcessEnv;
-    /** One caller deadline (e.g. a native hook budget) propagated into artifact busy retries. */
-    signal?: AbortSignal;
-}
-export declare function openSquare(squarePath: string, options?: Pick<SquareBuildOptions, 'clock' | 'hostLedger' | 'wakeTransport' | 'env' | 'signal'>, control?: OperationControl): Promise<OpenSquare>;
-export declare function probeSquare(squarePath: string): Promise<OpenSquare | undefined>;
-export declare function buildSquare(squarePath: string, options: SquareBuildOptions): Promise<OpenSquare>;
-export declare function buildMemorySquare(options: SquareBuildOptions): OpenSquare;
-/** A projection reads and validates its snapshot once; no preliminary duplicate read. */
-export declare function openSquareArtifact(squarePath: string, signal?: AbortSignal): SquareArtifactPort;