@astrosheep/square 0.3.95 → 0.3.96

package/dist/sqlite-square.js

@@ -1,16 +1,17 @@
-import { formatActivityId } from './square-core.js';
+import { formatActivityId, MAX_IDENTITY_SET_SIZE } from './square-core.js';
 import { assertCurrentSeat } from './square-domain.js';
 import { canonicalPath } from './canonical-path.js';
 import { validateMetadataMatch, validateDeferralDuration, validateDeferralId } from './delivery-deferral.js';
 import { squareLocation } from './square-location.js';
 import crypto from 'node:crypto';
 import { setTimeout as sleep } from 'node:timers/promises';
-import { InternalSquareError, SquareError, isSquareError, nameKey, validateName } from './model.js';
+import { activityMetadataHasContent, InternalSquareError, SquareError, isSquareError, nameKey, sameName, validateActivityMetadata, validateName } from './model.js';
 import { coreDone, coreIgnore, coreListen, coreListening, coreUnlisten, decideAct, decideJoin, resolveKnownName, validateDoneBody } from './decisions.js';
 import { WATCH_HEARTBEAT_MS, inSquareCount, presenceAnchor } from './runtime.js';
 import { catchLimit, decideCatch, observeCatchSelection, selectCatchPage } from './catch-decisions.js';
 import { expressionContext } from './activity-feed.js';
 import { expressHint } from './hints.js';
+import { ATTENTION_BODY_MAX } from './attention-presentation.js';
 import { asSeatRef, participantAuthority, requireOwner, requireJoinName } from './seats.js';
 import { recoveryObservation, entryPresentation, snapshot, queryStatus, queryParticipants, catchPresence, parseRequiredActivityId, toPublicActivity, publicActivities, selectHistory, NON_READ, HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT } from './views.js';
 import { sessionInboxCounts } from './inbox.js';
@@ -133,6 +134,7 @@ export class SqliteSquare {
             this.owner = owner;
             this.seat = seat;
         }
+        get generation() { return this.seat.generation; }
         async express(bodyOrInput, optionsOrControl = {}, operationControl) {
             const square = this.owner;
             const input = typeof bodyOrInput === 'object' && bodyOrInput !== null ? bodyOrInput : undefined;
@@ -382,6 +384,56 @@ export class SqliteSquare {
             }, control?.signal)).value;
         }
     };
+    /** Direct messages use explicit recipients, not participant expression admission or body attention. */
+    async send(input, control) {
+        checkControl(control);
+        const { from, to, body, truncate = ATTENTION_BODY_MAX } = input;
+        if (typeof from !== 'string')
+            throw new SquareError('invalid_args', 'Channel sender must be a name.');
+        validateName(from);
+        const targets = typeof to === 'string' ? [to] : to;
+        if (!Array.isArray(targets) || targets.length < 1 || targets.length > MAX_IDENTITY_SET_SIZE)
+            throw new SquareError('invalid_args', `Channel needs between 1 and ${MAX_IDENTITY_SET_SIZE} recipients.`);
+        const unique = [];
+        for (const target of targets) {
+            if (typeof target !== 'string')
+                throw new SquareError('invalid_args', 'Channel recipients must be names.');
+            validateName(target);
+            if (!unique.some(name => sameName(name, target)))
+                unique.push(target);
+        }
+        if (typeof body !== 'string' || body.trim() === '')
+            throw new SquareError('invalid_args', 'Channel body must be non-empty.');
+        if (truncate !== false && (!Number.isSafeInteger(truncate) || truncate < 1))
+            throw new SquareError('invalid_args', 'Channel truncate must be false or a positive integer.');
+        const fullBody = body.replace(/\r\n/g, '\n');
+        const preview = truncate !== false && fullBody.length > truncate
+            ? `${fullBody.slice(0, truncate).trimEnd()}… (truncated ${fullBody.length - truncate} chars)`
+            : undefined;
+        const delivery = preview === undefined ? { mode: 'direct' } : { mode: 'direct', preview };
+        const metadata = validateActivityMetadata(input.metadata);
+        const { stored, resolvedTo } = (await this.artifact.transactAs({ kind: 'send', actor: from }, facts => {
+            const standing = facts.roster().filter(p => p.joined), resolvedTo = [], missing = [];
+            for (const target of unique) {
+                const recipient = standing.find(p => sameName(p.name, target));
+                if (recipient === undefined || facts.seat(recipient.name)?.attachment !== 'attached')
+                    missing.push(target);
+                else
+                    resolvedTo.push(recipient.name);
+            }
+            if (missing.length > 0)
+                throw new SquareError('invalid_args', `Channel recipients are not standing: ${missing.join(', ')}`, {
+                    reason: 'not_standing', targets: missing, activityUnsent: true,
+                });
+            return { stored: facts.land({ kind: 'say', actor: from, at: this.clock(), body: fullBody,
+                    ...(activityMetadataHasContent(metadata) ? { metadata } : {}), delivery, mentions: resolvedTo }), resolvedTo };
+        }, control?.signal)).value;
+        if (this.wakeTransport !== undefined)
+            await deliverPending({ artifact: this.artifact, transport: this.wakeTransport, location: this.deliveryLocation,
+                activity: stored.index, now: stored.at }).catch(() => undefined);
+        return { id: formatActivityId(stored.index), at: stored.at, from: stored.actor, to: resolvedTo, body: preview ?? fullBody,
+            ...(stored.kind !== 'say' || stored.metadata === undefined ? {} : { metadata: stored.metadata }) };
+    }
     async participant(name, { owner }) {
         validateName(name);
         requireOwner(owner);

package/dist/square-core.d.ts

@@ -26,6 +26,7 @@ export type Act = {
     at?: number;
     body?: string;
     metadata?: import('./model.js').ActivityMetadata;
+    delivery?: import('./model.js').ActivityDelivery;
     mentions?: readonly Participant[];
     reach?: Reach;
     reply?: number;

package/dist/square-domain.js

@@ -1,7 +1,16 @@
-import { SquareError, formatActivityId, parseActivityId, sameName, validateOwner, validateName } from './model.js';
+import { SquareError, formatActivityId, parseActivityId, sameName, validateActivityDelivery, validateOwner, validateName } from './model.js';
 import { resolveAudience } from './attention.js';
 /** The single landing transition, shared by both adapters and explicit rebuild. */
 export function deriveLanding(activity, facts) {
+    if (activity.kind === 'say' && activity.delivery?.mode === 'direct') {
+        const audience = [];
+        for (const mention of activity.mentions ?? []) {
+            const recipient = facts.standing.find(item => sameName(item.name, mention))?.name;
+            if (recipient !== undefined && !audience.some(item => sameName(item.recipient, recipient)))
+                audience.push({ recipient, route: 'mention' });
+        }
+        return { activity, audience };
+    }
     const audience = activity.kind === 'say' ? resolveAudience({
         actor: activity.actor, recipients: facts.standing.map((item) => item.name),
         mentions: activity.mentions, replyAuthor: facts.replyAuthor, reach: activity.reach,
@@ -60,15 +69,15 @@ export function wrapSquareWrite(read, writes, authority) {
         throw new SquareError('invalid_args', 'Artifact writes require an explicit authority.');
     const { applyLanding, ...mutations } = writes;
     const seated = authority.kind === 'participant' || authority.kind === 'host-cleanup';
-    const expectedName = seated ? authority.seat?.participant : authority.participant;
-    if (!['participant', 'host-cleanup', 'join', 'takeover'].includes(authority.kind) || typeof expectedName !== 'string')
+    const expectedName = seated ? authority.seat?.participant : authority.kind === 'send' ? authority.actor : authority.participant;
+    if (!['participant', 'host-cleanup', 'join', 'takeover', 'send'].includes(authority.kind) || typeof expectedName !== 'string')
         throw new SquareError('invalid_args', 'Artifact write authority is malformed.');
     validateName(expectedName);
     if (seated) {
         validateOwner(authority.seat.owner);
         validateGeneration(authority.seat.generation);
     }
-    else {
+    else if (authority.kind !== 'send') {
         validateOwner(authority.owner);
         if (authority.kind === 'takeover')
             validateGeneration(authority.expectedGeneration);
@@ -100,7 +109,7 @@ export function wrapSquareWrite(read, writes, authority) {
             reconnectSeat = seat;
         }
     }
-    else {
+    else if (authority.kind === 'takeover') {
         const current = read.seat(expectedName);
         if (current === undefined || current.generation !== authority.expectedGeneration)
             throw new SquareError('already_joined', 'The participant seat changed before takeover.');
@@ -114,7 +123,13 @@ export function wrapSquareWrite(read, writes, authority) {
             validateName(actor);
             if (!sameName(actor, expectedName))
                 throw new SquareError('already_joined', 'Activity actor does not match the artifact authority.');
-            if (authority.kind === 'participant') {
+            if (activity.kind === 'say')
+                validateActivityDelivery(activity.delivery);
+            if (authority.kind === 'send') {
+                if (activity.kind !== 'say' || activity.delivery?.mode !== 'direct' || activity.reach !== undefined || activity.reply !== undefined)
+                    throw new SquareError('invalid_args', 'Send authority may only land direct messages without bell or reply.');
+            }
+            else if (authority.kind === 'participant') {
                 assertSeat(authority.seat);
                 if (activity.kind === 'join')
                     throw new SquareError('invalid_args', 'A participant seat can only be re-established by join.');
@@ -150,7 +165,7 @@ export function wrapSquareWrite(read, writes, authority) {
             const stored = { ...activity, index };
             applyLanding(deriveLanding(stored, landingFacts(read, stored)));
             if (stored.kind === 'join') {
-                if (seated)
+                if (authority.kind !== 'join' && authority.kind !== 'takeover')
                     throw new SquareError('invalid_args', 'Seat authority cannot establish another seat.');
                 const seat = {
                     participant: stored.actor,

package/dist/square-facade.d.ts

@@ -1,10 +1,10 @@
 import type { DeliveryDeferral, MetadataMatch } from './delivery-deferral.js';
 export type { DeliveryDeferral, MetadataMatch, MetadataScalar } from './delivery-deferral.js';
 import type { ActivityId, Perception, Reach } from './square-core.js';
-import type { Owner, StoredAct, WakeAddress, ActivityMetadata, DirectedNotificationRoute } from './model.js';
+import type { Owner, StoredAct, WakeAddress, ActivityMetadata, ActivityDelivery, DirectedNotificationRoute } from './model.js';
 import type { WakeTransportPort, SquareResourceOwner } from './ports.js';
 export type { ActivityId, Perception, Reach } from './square-core.js';
-export type { Owner, WakeAddress, ActivityMetadata, JsonValue, DirectedNotificationRoute } from './model.js';
+export type { Owner, WakeAddress, ActivityMetadata, ActivityDelivery, JsonValue, DirectedNotificationRoute } from './model.js';
 /** Indexed archive event, including read bookkeeping. */
 export type ArchiveRecord = Readonly<StoredAct>;
 export interface Activity {
@@ -14,6 +14,7 @@ export interface Activity {
     readonly actor: string;
     readonly body?: string;
     readonly metadata?: ActivityMetadata;
+    readonly delivery?: ActivityDelivery;
     readonly mentions: readonly string[];
     readonly reach?: Reach;
     readonly target?: string;
@@ -49,6 +50,22 @@ export interface ExpressResult {
     readonly hint?: string;
     readonly observation?: ExpressObservation;
 }
+export type ChannelTruncate = number | false;
+export interface ChannelSendInput {
+    readonly from: string;
+    readonly to: string | readonly string[];
+    readonly body: string;
+    readonly truncate?: ChannelTruncate;
+    readonly metadata?: ActivityMetadata;
+}
+export interface ChannelSendResult {
+    readonly id: ActivityId;
+    readonly at: number;
+    readonly from: string;
+    readonly to: readonly string[];
+    readonly body: string;
+    readonly metadata?: ActivityMetadata;
+}
 export interface ListenerChangeResult {
     readonly activity: Activity | null;
     readonly observation?: ListenerObservation;
@@ -170,6 +187,7 @@ export interface JoinResult {
 }
 export interface Participant {
     readonly name: string;
+    readonly generation: ActivityId;
     express(body: string | undefined, options?: ExpressOptions, control?: OperationControl): Promise<ExpressResult>;
     express(input: ExpressInput, control?: OperationControl): Promise<ExpressResult>;
     listen(target: string, options?: ObservationOptions, control?: OperationControl): Promise<ListenerChangeResult>;

package/dist/square-sqlite.js

@@ -1,5 +1,5 @@
 import { DatabaseSync as MemoryDatabase } from 'node:sqlite';
-import { SquareError, nameKey, isWakeRouteKind, validateOwner, validateActivityMetadata, activityMetadataHasContent } from './model.js';
+import { SquareError, nameKey, isWakeRouteKind, validateOwner, validateActivityMetadata, validateActivityDelivery, activityMetadataHasContent } from './model.js';
 import { validateMetadataMatch, matchingDeferrals, validateDeferralId } from './delivery-deferral.js';
 import { deriveLanding, landingFacts } from './square-domain.js';
 import { claimAttempt, prepareAttempt, settleAttempt } from './delivery-attempts.js';
@@ -269,7 +269,16 @@ export function validateStoredActivity(value) {
     string(a.actor, true);
     switch (a.kind) {
         case 'say':
-            shape(a, [...common], ['body', 'mentions', 'reach', 'reply', 'metadata']);
+            shape(a, [...common], ['body', 'mentions', 'reach', 'reply', 'metadata', 'delivery']);
+            if (Object.hasOwn(a, 'delivery')) {
+                requireFact(a.delivery !== undefined, 'say delivery is malformed.');
+                try {
+                    validateActivityDelivery(a.delivery);
+                }
+                catch {
+                    throw invalidArtifact('say delivery is malformed.');
+                }
+            }
             if (Object.hasOwn(a, 'body'))
                 string(a.body);
             if (Object.hasOwn(a, 'metadata')) {
@@ -311,7 +320,7 @@ export function validateStoredActivity(value) {
 function activity(row) {
     const h = head(row), payload = object(json(row.payload_json));
     // Payload cannot shadow indexed structural columns.
-    const allowed = h.kind === 'say' ? ['body', 'mentions', 'metadata'] : h.kind === 'done' ? ['body'] : h.kind === 'read' ? ['through'] : h.kind === 'listen' || h.kind === 'ignore' || h.kind === 'unlisten' ? ['target'] : [];
+    const allowed = h.kind === 'say' ? ['body', 'mentions', 'metadata', 'delivery'] : h.kind === 'done' ? ['body'] : h.kind === 'read' ? ['through'] : h.kind === 'listen' || h.kind === 'ignore' || h.kind === 'unlisten' ? ['target'] : [];
     requireFact(Object.keys(payload).every(k => allowed.includes(k)));
     return immutable(validateStoredActivity({ ...h, ...payload }));
 }

package/dist/square-tools.d.ts

@@ -13,6 +13,7 @@ interface ToolDefinition {
     /** Human text identical to what the CLI prints; domain receipts stay inside the adapter. */
     run(square: Square, args: JsonObject, control: OperationControl, identity: ToolIdentity): Promise<string>;
 }
+export declare function squareToolsEnabled(env?: NodeJS.ProcessEnv): boolean;
 export declare const SQUARE_TOOL_INSTRUCTIONS = "Join once. Then express to speak, and catch to take in what reached you. History looks back without taking anything in.";
 export declare const SQUARE_TOOLS: readonly ToolDefinition[];
 export declare function squareToolFailure(error: unknown, signal?: AbortSignal): JsonObject;

package/dist/square-tools.js

@@ -1,5 +1,5 @@
 import { z } from 'zod/v4';
-import { isSquareError } from './model.js';
+import { isSquareError, SquareError } from './model.js';
 import { requireOwner, requireJoinName, selectOwnSeat, CATCH_DEFAULT_LIMIT } from './square-api.js';
 import { renderCatchOutcome, renderExpression, renderFailureLines, renderHistoryResult, renderJoinResult, renderLifecycleResult, renderListenerChange, renderStatusResult, } from './operation-presentation.js';
 const location = z.string().optional().describe('Which square: a .square file path. Relative paths start from the working directory. Leave it out for the configured square.');
@@ -19,6 +19,14 @@ function tool(name, description, shape, run, render) {
             return render(receipt, operationArgs) ?? '';
         } };
 }
+export function squareToolsEnabled(env = process.env) {
+    const raw = env.SQUARE_TOOLS?.trim().toLowerCase();
+    if (raw === undefined || raw === '' || raw === '1' || raw === 'true')
+        return true;
+    if (raw === '0' || raw === 'false' || raw === 'none')
+        return false;
+    throw new SquareError('invalid_args', 'Invalid SQUARE_TOOLS: expected 0, 1, true, false, or none.');
+}
 export const SQUARE_TOOL_INSTRUCTIONS = 'Join once. Then express to speak, and catch to take in what reached you. History looks back without taking anything in.';
 const target = z.string().describe('The participant to turn toward or away from.');
 export const SQUARE_TOOLS = [

package/dist/views.js

@@ -19,6 +19,7 @@ export function toPublicActivity(stored) {
         ...(stored.kind === 'say' && stored.reach !== undefined ? { reach: stored.reach } : {}),
         ...('body' in stored && stored.body !== undefined ? { body: stored.body } : {}),
         ...(stored.kind === 'say' && stored.metadata !== undefined ? { metadata: stored.metadata } : {}),
+        ...(stored.kind === 'say' && stored.delivery !== undefined ? { delivery: stored.delivery } : {}),
         mentions: stored.kind === 'say' ? stored.mentions ?? [] : [], ...('target' in stored ? { target: stored.target } : {}),
         ...(stored.kind === 'say' && stored.reply !== undefined ? { reply: formatActivityId(stored.reply) } : {}) };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/square",
-  "version": "0.3.95",
+  "version": "0.3.96",
   "description": "A shared public square where agents join, catch activity, express, and step out when done.",
   "type": "module",
   "bin": {
@@ -51,6 +51,10 @@
     "ws": "^8.21.3"
   },
   "exports": {
+    "./channel": {
+      "types": "./dist/channel.d.ts",
+      "default": "./dist/channel.js"
+    },
     "./delivery": {
       "types": "./dist/delivery-primitives.d.ts",
       "default": "./dist/delivery-primitives.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.95",
+  "version": "0.3.96",
   "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.95",
+  "version": "0.3.96",
   "description": "Shared Square activity with reliable participant attention at Codex boundaries.",
   "author": {
     "name": "Square"

package/plugins/paseo/client/marble.ts

@@ -0,0 +1,7 @@
+/**
+ * Seamless 512px stone tiles, rendered once offline (float canvas noise, dithered, JPEG):
+ * veinless honed stone — only the milky drift, on muted grey-white (light) or charcoal (dark).
+ * Kept tiny so they inline as data URIs.
+ */
+export const MARBLE_LIGHT = "data:image/jpeg;base64,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";
+export const MARBLE_DARK = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZWiAH4AABAAEAAAAAAABhY3NwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAA9tYAAQAAAADTLQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlkZXNjAAAA8AAAACRyWFlaAAABFAAAABRnWFlaAAABKAAAABRiWFlaAAABPAAAABR3dHB0AAABUAAAABRyVFJDAAABZAAAAChnVFJDAAABZAAAAChiVFJDAAABZAAAAChjcHJ0AAABjAAAADxtbHVjAAAAAAAAAAEAAAAMZW5VUwAAAAgAAAAcAHMAUgBHAEJYWVogAAAAAAAAb6IAADj1AAADkFhZWiAAAAAAAABimQAAt4UAABjaWFlaIAAAAAAAACSgAAAPhAAAts9YWVogAAAAAAAA9tYAAQAAAADTLXBhcmEAAAAAAAQAAAACZmYAAPKnAAANWQAAE9AAAApbAAAAAAAAAABtbHVjAAAAAAAAAAEAAAAMZW5VUwAAACAAAAAcAEcAbwBvAGcAbABlACAASQBuAGMALgAgADIAMAAxADb/2wBDAAYEBAUEBAYFBQUGBgYHCQ4JCQgICRINDQoOFRIWFhUSFBQXGiEcFxgfGRQUHScdHyIjJSUlFhwpLCgkKyEkJST/2wBDAQYGBgkICREJCREkGBQYJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCQkJCT/wAARCAIAAgADASIAAhEBAxEB/8QAFwABAQEBAAAAAAAAAAAAAAAAAAECCP/EABYQAQEBAAAAAAAAAAAAAAAAAAABEf/EABUBAQEAAAAAAAAAAAAAAAAAAAAB/8QAFBEBAAAAAAAAAAAAAAAAAAAAAP/aAAwDAQACEQMRAD8A54AVFEAUQAAAAAAAAAAAAAAAABVRQWKkAURVBFARQQAAAAQAEABEUBAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFiLAVUigKCgAgAgKIKKCIAAJUVAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABUAVWV0GtNTTQaE00FEFFQEABQAQQABFARGkBMFKCAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAumoA1oigoigAgKIoAACKgAAAKCFioDNFqAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKigoCgaIgoigogAAAAAqAKgAgqUEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYJFBQAEVAAAU1AFQAAAFRQAUESqKMi1EAAAXDAQXAEFQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACKkagAoCCgIACAAgAKIoCooACgAgYYqKJgogAAAqiIogyKAguIAAAKgAAAAAAAAAAAAAAAAAAAAAAAAAAEaZUGgAAAEUBEVAQVAURQURQAAAAUAABRBRADAAVAQVAQVARQAQAAAAAAAAAAAAAAAAAAAAAAAAAAAUAFEFF0QQUEAABAAAAURQUAAAFEUAFUAEAAAAEFQERUAAARUAAAAAAAAAAAAAAAAAAAAAAAAAAAVAAAFEUAEAAAAAAAVFBQAAAAAVWVBTTUBRFAAARUBBUBBUBAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAVFBRFAABAAUAFAAABRAFQQFSiACAAAAAAAAAAAAAAAAEBQigIoCCmAiNICAAAAAAAAAAAAAAAAAAAAsEUAAAAFEUFEAVABRAAAEqKgAAAAAAAAAAAAAAAAAALFSAKAAqAKgAgqAgAAAAAAAAAAAAAAAAAAAAAAAKIoKIoCooCKAiKAiKAgAAAAAAAAAAAAAAAAACoAqoAogCgAAAlRagAAAAAAAAAAAAAAAAAAAAAAAAKqRQFAAEARUAQAAAAAAAAAAAAAAAAAAAAAAAXRAFNQBoQAqAAAAAAAAAAAAAAAAAAAAAAAAACxUgDQmgACglVEBAAAAAAAAAAAAAAAAAAAAAAAAAAABRFBAAAAAAAAAAAAAAAAAAAAAAAAAAAAU1DQXTUAXRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAVAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAUAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAVFBBQEFAQAAAAAAAAAAAAAAAFAAABBUAAABQRQAAAAAAARUAAAAAAAAAAAAAAAAAAAAABQAUEFAQVAQVAAAAAAAAAAAAAAAUAAAAAAxTATBQEFQAAAEBRAAAAAAAAAAAAAAAAAAAAAAABUUBUUAUBBQEwxQGcRpAQAAAAAAAAABUAURQBQAFAAABVGRUQRGqgIAAAAAAAAAAAAAAAAAAAAAAAAAChi4AKAAqiAIAAIACIoCCoAAAAAAACgAsAXBYCKKCC4AgoCIoCM1pFGaLYiAAAAAAAAAAAAAACooCCgIKmACgILhgNYYoACggACLUABAAAQAEAAAAAAFAAAFiKCxYiwFCAAAAoohioCJWkBmo0iCIoCCgIAAAAAAAACgAoIooJiY0YDKrgCLgqigoIKAiNIDIqICKAgUARQERQEAAUAFAAUBBQBQAVBRQAFQBUABFQBFQERRBEVAAAAAAAAAFiKCgoAKAAAACKALFZVRQAEBBEVKCAKACACAIqAAoAAKqAKAACgAoIKigoIAgoAIAAAIoJiiCVlpKCAAAAAAAAKigsVAFABRFABFFEEFisqCiCioCCBUAAAAAQKCAAKigAAKigoAKEVQBAURQEAAAAQQFQBUAAAERQERUAAAAAABRFBQAAAFQBRNUARQFRQAABACoACCAuiAKgAAAAAoACgAoAoigCCiiAKIIAAAgCgAAAJVQBABKAAAAAAAAqAKqQBQAAQFEAURQFZAaEAUQARagCAAAAAAAAAAqKAqAKqKACqIoAgCAigIAACAqoAoigIqAgIAAAAAAAAAAAACiAKgAaaALpqACoAqooAACCUAAAAAAAAAAAABUUFVFAUAEVAAFAUQRFAQVAAAAAEABFQAAAAAAAAAAAAAAAAAAAAAAFAAAARUAAAAAAAAAAAAAABqKysBoRQAFEAQAVRBQEMUQQAERUAQAAAAAAAAAAAAAAAAAAAAAAAf/9k=";

package/plugins/paseo/client/markdown.tsx

@@ -1,5 +1,5 @@
 import { useMemo, type ReactNode } from "react";
-import { Platform, Text, View, type TextStyle, type ViewStyle } from "react-native";
+import { Platform, StyleSheet, Text, View, type TextStyle } from "react-native";
 import type { PluginTheme } from "@getpaseo/plugin";
 import { Lexer, lexer, type Token, type Tokens } from "marked";
 
@@ -9,6 +9,7 @@ function makeStyles(colors: PluginTheme["colors"]) {
   return {
     block: { gap: 6 },
     text: { color: colors.foreground, fontSize: 13, lineHeight: 19 },
+    lead: { color: colors.accent, fontWeight: "600" as const },
     strong: { fontWeight: "500" as const, color: colors.foreground },
     em: { color: colors.foregroundMuted, fontStyle: "italic" as const },
     del: { color: colors.foregroundMuted, textDecorationLine: "line-through" as const },
@@ -117,7 +118,7 @@ function renderBlocks(tokens: Token[], styles: Styles, prefix: string, textStyle
       default: {
         const block = token as Tokens.Generic;
         return (
-          <Text key={key} style={[styles.text, textStyle]}>
+          <Text key={key} selectable={Platform.OS === "web"} style={[styles.text, textStyle]}>
             {renderInlines(block.tokens ?? Lexer.lexInline(block.text ?? block.raw), styles, key)}
           </Text>
         );
@@ -126,24 +127,79 @@ function renderBlocks(tokens: Token[], styles: Styles, prefix: string, textStyle
   });
 }
 
+/** The speaker run into the start of a line: the seal's blue, then the words. */
+function Lead({ name, styles }: { name: string; styles: Styles }) {
+  return <Text style={styles.lead}>{name}{"  "}</Text>;
+}
+
 /** One line (or a few) of Markdown, inline only: the collapsed preview on a notification card. */
-export function SquareInline({ text, theme, numberOfLines, style }: {
+export function SquareInline({ text, theme, numberOfLines, lead }: {
   text: string;
   theme: PluginTheme;
   numberOfLines?: number;
-  style?: TextStyle;
+  lead?: string;
 }) {
   const styles = useMemo(() => makeStyles(theme.colors), [theme.colors]);
   return (
-    <Text numberOfLines={numberOfLines} style={[styles.text, style]}>
+    <Text numberOfLines={numberOfLines} style={styles.text}>
+      {lead !== undefined && <Lead name={lead} styles={styles} />}
       {renderInlines(Lexer.lexInline(text), styles, "inline")}
     </Text>
   );
 }
 
-/** A body of Markdown: no envelope, no route line — the words only, indented by the card. */
-export function SquareMarkdownBody({ text, theme, style }: { text: string; theme: PluginTheme; style?: ViewStyle }) {
+/** A paragraph that is one *emphasis* and nothing else is an action, not a line. */
+const isAction = (token: Token): token is Tokens.Paragraph =>
+  token.type === "paragraph" && children(token).length === 1 && children(token)[0]!.type === "em";
+
+/** A bell or an action is stage direction: a caption on a hairline across the full width. */
+export function SquareCue({ label, theme }: { label: ReactNode; theme: PluginTheme }) {
+  const rule = { flex: 1, height: StyleSheet.hairlineWidth, backgroundColor: theme.colors.border };
+  return (
+    <View style={{ flexDirection: "row", alignItems: "center", gap: 8, marginVertical: 2 }}>
+      <View style={rule} />
+      <Text style={{ color: theme.colors.foregroundMuted, fontSize: 11.5, lineHeight: 16, letterSpacing: 0.4 }}>{label}</Text>
+      <View style={rule} />
+    </View>
+  );
+}
+
+/**
+ * A body of Markdown: no envelope, no route line — the words only, at full width.
+ * `lead` runs the speaker into the first line; `actor` names whoever performs an action.
+ */
+export function SquareMarkdownBody({ text, theme, lead, actor }: {
+  text: string;
+  theme: PluginTheme;
+  lead?: string;
+  actor?: string;
+}) {
   const styles = useMemo(() => makeStyles(theme.colors), [theme.colors]);
-  const tokens = useMemo(() => lexer(text), [text]);
-  return <View style={[styles.block, style]}>{renderBlocks(tokens, styles, "body")}</View>;
+  const tokens = useMemo(() => lexer(text).filter(token => token.type !== "space"), [text]);
+  let pending = lead;
+  const nodes = tokens.map((token, index) => {
+    const key = `body-${index}`;
+    if (isAction(token)) {
+      const words = renderInlines(children(children(token)[0]!), styles, key);
+      return <SquareCue key={key} theme={theme} label={actor === undefined ? words : <>{actor} {words}</>} />;
+    }
+    if (pending === undefined) return renderBlocks([token], styles, key);
+    const name = pending;
+    pending = undefined;
+    if (token.type === "paragraph") {
+      return (
+        <Text key={key} selectable={Platform.OS === "web"} style={styles.text}>
+          <Lead name={name} styles={styles} />
+          {renderInlines(children(token), styles, key)}
+        </Text>
+      );
+    }
+    return [<Text key={`${key}-lead`} style={styles.text}><Lead name={name} styles={styles} /></Text>, ...renderBlocks([token], styles, key)];
+  });
+  return (
+    <View style={styles.block}>
+      {nodes}
+      {pending !== undefined && <Text style={styles.text}><Lead name={pending} styles={styles} /></Text>}
+    </View>
+  );
 }

package/plugins/paseo/client/palette.ts

@@ -1,40 +1,50 @@
 import type { PluginTheme } from "@getpaseo/plugin";
+import { MARBLE_DARK, MARBLE_LIGHT } from "./marble";
 
 /**
- * Square's own courtyard palette: Carrara marble (grey-white stone with a
- * slate-blue vein), deliberately no relative of notesoup's warm parchment or
+ * Square's own courtyard palette: veinless honed stone (muted grey light, charcoal dark) and a
+ * slate seal ■ — everything half a step down, the quiet card on the timeline, deliberately no relative of notesoup's warm parchment or
  * pi-meantime's neutral carbon. Every token here is opaque and self-contained — the card and
  * Markdown never borrow the host's surface ramp or accent, only its appearance
  * (read from the host ink) and its accentForeground, which paints text on top
  * of an accent fill.
  */
 const DARK = {
-  surface0: "#14171b", // inset / code
-  surface1: "#1c2126", // card
-  surface2: "#14171b", // inset / code
-  border: "#2e353d",
-  foreground: "#e8edf3",
-  foregroundMuted: "#8b96a3",
-  accent: "#8ea8c3", // plaza ■ / links
+  surface0: "#15171a", // inset / code
+  surface1: "#1a1d20", // card (charcoal stone)
+  surface2: "#15171a", // inset / code
+  border: "#2b2f34",
+  foreground: "#dde1e6",
+  foregroundMuted: "#858b94",
+  accent: "#8298ad", // plaza ■ / links
 } as const;
 
 const LIGHT = {
-  surface0: "#e7ecf1",
-  surface1: "#f2f5f9", // cool marble white
-  surface2: "#e7ecf1",
-  border: "#d2dae3",
-  foreground: "#181d24",
-  foregroundMuted: "#67737f",
-  accent: "#4b6582",
+  surface0: "#e9ebee",
+  surface1: "#f4f5f6", // card (grey stone)
+  surface2: "#e9ebee",
+  border: "#e0e2e5",
+  foreground: "#2b2e33",
+  foregroundMuted: "#90959c",
+  accent: "#56687e",
 } as const;
 
-const VOICE = { dark: "#8b96a3", light: "#67737f" } as const; // grey: only the ■ carries colour
+const TILE = 512;
+
+/** Web-only surface: react-native-web passes these through as inline CSS. */
+const STONE = {
+  // A slab resting on the page: one darker cut along the bottom edge, a tight contact shadow, no sheen.
+  dark: { image: `url(${MARBLE_DARK})`, edge: "#34393f", boxShadow: "0 1px 0 rgba(0,0,0,0.3), 0 4px 10px -6px rgba(0,0,0,0.55)", inlay: "inset 0 0 0 0.5px rgba(0,0,0,0.4)" },
+  light: { image: `url(${MARBLE_LIGHT})`, edge: "#c9ccd1", boxShadow: "0 1px 0 rgba(24,26,30,0.04), 0 4px 10px -6px rgba(24,26,30,0.18)", inlay: "inset 0 0 0 0.5px rgba(0,0,0,0.26)" },
+} as const;
 
 export interface SquarePalette {
   /** Complete theme for the card and its Markdown surfaces. */
   theme: PluginTheme;
-  /** The filled ● speaker dot; the hollow ○ keeps the muted ink instead. */
-  voice: string;
+  /** Marble card surface for the web host, cut from the tile at `seed`; native keeps the flat surface1. */
+  stone(seed: string): { backgroundImage: string; backgroundSize: string; backgroundPosition: string; borderBottomColor: string; boxShadow: string };
+  /** Web-only: the ■ set into the stone. */
+  inlay: { boxShadow: string };
 }
 
 /** Paseo theme colors are hex (#RGB or #RRGGBB). */
@@ -57,6 +67,19 @@ export function squarePalette(theme: PluginTheme): SquarePalette {
       statusWarning: theme.colors.statusWarning,
       statusDanger: theme.colors.statusDanger,
     } },
-    voice: dark ? VOICE.dark : VOICE.light,
+    stone: seed => {
+      // Each card shows its own patch of the slab, so neighbours never repeat a vein.
+      let hash = 2166136261;
+      for (const char of seed) hash = Math.imul(hash ^ char.charCodeAt(0), 16777619);
+      const { image, edge, boxShadow } = dark ? STONE.dark : STONE.light;
+      return {
+        backgroundImage: image,
+        backgroundSize: `${TILE}px ${TILE}px`,
+        backgroundPosition: `${-((hash >>> 0) % TILE)}px ${-((hash >>> 9) % TILE)}px`,
+        borderBottomColor: edge,
+        boxShadow,
+      };
+    },
+    inlay: { boxShadow: (dark ? STONE.dark : STONE.light).inlay },
   };
 }