@astrosheep/square 0.3.19 → 0.3.21

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

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Native Claude Code turn-boundary delivery for Square participants",
   "author": {
     "name": "Square"

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

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Square } from './square-wiring.js';
 export { SquareError } from './model.js';
-export { bindCurrentParticipant, currentParticipantName, unbindCurrentParticipant } from './registry.js';
+export { assignedSquareName, bindCurrentParticipant, unbindCurrentParticipant } from './registry.js';
 export type { ActivityId } from './square-core.js';
 export type { Activity, CatchOptions, CatchResult, ExpressOptions, ExpressResult, HistoryQuery, ListenerChangeResult, OpenOptions, Participant, ParticipantStatus, PerceivedActivity, SquareAtInput, SquareBuildInput, SquareSnapshot, SquareSource, WakeNotifier, } from './square-facade.js';

package/dist/index.js

@@ -1,3 +1,3 @@
 export { Square } from './square-wiring.js';
 export { SquareError } from './model.js';
-export { bindCurrentParticipant, currentParticipantName, unbindCurrentParticipant } from './registry.js';
+export { assignedSquareName, bindCurrentParticipant, unbindCurrentParticipant } from './registry.js';

package/dist/registry.d.ts

@@ -38,7 +38,7 @@ export declare function lookupParticipant(squarePath: string, name: string, now?
 export declare function localParticipantOwner(squarePath: string, name: string, env?: NodeJS.ProcessEnv, now?: number): string | undefined;
 export declare function localParticipantName(squarePath: string, env?: NodeJS.ProcessEnv): string | undefined;
 /** Resolve the one participant name owned by the current local session set, without a square path. */
-export declare function currentParticipantName(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function assignedSquareName(env?: NodeJS.ProcessEnv): string | undefined;
 export type CurrentParticipantBinding = Readonly<{
     created: boolean;
     ownerId: string;

package/dist/registry.js

@@ -237,13 +237,13 @@ export function localParticipantName(squarePath, env = process.env) {
     return names.size === 1 ? [...names][0] : undefined;
 }
 /** Resolve the one participant name owned by the current local session set, without a square path. */
-export function currentParticipantName(env = process.env) {
+export function assignedSquareName(env = process.env) {
     const names = new Set(localSessionIdentities(env).flatMap((identity) => lookupSession(identity.sessionId).map((item) => item.name)));
     return names.size === 1 ? [...names][0] : undefined;
 }
 /** Bind a current local session to one explicit square without taking an occupied registry name. */
 export function bindCurrentParticipant(squarePath, name, env = process.env) {
-    if (currentParticipantName(env) !== name) {
+    if (assignedSquareName(env) !== name) {
         throw new SquareError('invalid_args', `The current session is not uniquely bound to ${name}`);
     }
     const localOwner = localParticipantOwner(squarePath, name, env);

package/dist/square-wiring.d.ts

@@ -9,6 +9,10 @@ export declare class Square {
     static build(input: SquareBuildInput): Promise<Square>;
     static inMemory(input: Omit<SquareBuildInput, 'path'>): Square;
     join(name: string): Promise<Participant>;
+    joinWithActivity(name: string): Promise<{
+        readonly participant: Participant;
+        readonly activity: Activity | null;
+    }>;
     implicitJoin(name: string): Promise<{
         readonly state: 'joined' | 'active' | 'done';
         readonly participant?: Participant;

package/dist/square-wiring.js

@@ -59,6 +59,10 @@ export class Square {
         const joined = await join(this.square, name);
         return new ParticipantHandle(joined.name, this.square);
     }
+    async joinWithActivity(name) {
+        const joined = await join(this.square, name);
+        return { participant: new ParticipantHandle(joined.name, this.square), activity: joined.activity };
+    }
     async implicitJoin(name) {
         const joined = await implicitJoin(this.square, name);
         return joined.state === 'done'

package/package.json

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