@astrosheep/square 0.3.9 → 0.3.11

package/dist/file-lock.js

@@ -0,0 +1,112 @@
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+const lockWait = new Int32Array(new SharedArrayBuffer(4));
+const heldSyncLocks = new Set();
+function ownerState(lockPath) {
+    let pid;
+    try {
+        pid = Number.parseInt(fs.readFileSync(lockPath, 'utf8').split('\n')[0], 10);
+    }
+    catch {
+        return 'unknown';
+    }
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return 'unknown';
+    try {
+        process.kill(pid, 0);
+        return 'alive';
+    }
+    catch (error) {
+        return error.code === 'ESRCH' ? 'dead' : 'alive';
+    }
+}
+function createLock(lockPath) {
+    let fd;
+    try {
+        fd = fs.openSync(lockPath, 'wx', 0o600);
+    }
+    catch (error) {
+        if (error.code === 'EEXIST')
+            return undefined;
+        throw error;
+    }
+    const token = `${process.pid}\n${Date.now()}\n${randomUUID()}\n`;
+    try {
+        fs.writeFileSync(fd, token, 'utf8');
+        return token;
+    }
+    catch (error) {
+        try {
+            fs.unlinkSync(lockPath);
+        }
+        catch { }
+        throw error;
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+function reclaimLock(lockPath, staleMs) {
+    try {
+        const stale = Date.now() - fs.statSync(lockPath).mtimeMs > staleMs;
+        if (ownerState(lockPath) !== 'dead' && !stale)
+            return false;
+        fs.unlinkSync(lockPath);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'ENOENT';
+    }
+}
+function releaseLock(lockPath, token) {
+    try {
+        if (fs.readFileSync(lockPath, 'utf8') === token)
+            fs.unlinkSync(lockPath);
+    }
+    catch { }
+}
+function prepare(lockPath) {
+    fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+}
+export function withFileLockSync(lockPath, options, fn) {
+    if (heldSyncLocks.has(lockPath))
+        throw new Error(`Reentrant file lock: ${lockPath}`);
+    prepare(lockPath);
+    let token;
+    while (token === undefined) {
+        token = createLock(lockPath);
+        if (token !== undefined)
+            break;
+        if (reclaimLock(lockPath, options.staleMs))
+            continue;
+        Atomics.wait(lockWait, 0, 0, options.retryMs);
+    }
+    heldSyncLocks.add(lockPath);
+    try {
+        return fn();
+    }
+    finally {
+        heldSyncLocks.delete(lockPath);
+        releaseLock(lockPath, token);
+    }
+}
+export async function withFileLock(lockPath, options, fn) {
+    prepare(lockPath);
+    let token;
+    while (token === undefined) {
+        token = createLock(lockPath);
+        if (token !== undefined)
+            break;
+        if (reclaimLock(lockPath, options.staleMs))
+            continue;
+        await sleep(options.retryMs);
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        releaseLock(lockPath, token);
+    }
+}

package/dist/harness-codex.js

@@ -12,7 +12,7 @@ const LEGACY_MARKETPLACES = ['astrosheep-square'];
 export function codexMarketplaceRoot(homeDir) {
     return path.join(homeDir, '.square', 'codex', 'marketplaces', CODEX_MARKETPLACE_NAME);
 }
-function configuredMarketplaceRoot(homeDir, configText) {
+function configuredMarketplaceRoot(homeDir, configText, codexHomeDir) {
     const lines = configText.split('\n');
     const header = `[marketplaces.${CODEX_MARKETPLACE_NAME}]`;
     const start = lines.findIndex((line) => line.trim() === header);
@@ -28,10 +28,10 @@ function configuredMarketplaceRoot(homeDir, configText) {
     if (!match)
         return undefined;
     const value = match[1].startsWith('"') ? JSON.parse(match[1]) : match[1].slice(1, -1);
-    return path.isAbsolute(value) ? value : path.resolve(codexHome(homeDir), value);
+    return path.isAbsolute(value) ? value : path.resolve(codexHome(homeDir, codexHomeDir), value);
 }
-function activeMarketplaceRoot(homeDir, configText) {
-    return configuredMarketplaceRoot(homeDir, configText) ?? codexMarketplaceRoot(homeDir);
+function activeMarketplaceRoot(homeDir, configText, codexHomeDir) {
+    return configuredMarketplaceRoot(homeDir, configText, codexHomeDir) ?? codexMarketplaceRoot(homeDir);
 }
 export function codexPluginRoot(homeDir, marketplaceRoot = codexMarketplaceRoot(homeDir)) {
     return path.join(marketplaceRoot, 'plugins', SQUARE_IDENTITY.pluginName);
@@ -39,12 +39,15 @@ export function codexPluginRoot(homeDir, marketplaceRoot = codexMarketplaceRoot(
 export function codexPluginHooksPath(homeDir, marketplaceRoot = codexMarketplaceRoot(homeDir)) {
     return path.join(codexPluginRoot(homeDir, marketplaceRoot), 'hooks', 'hooks.json');
 }
-function codexHome(homeDir) { return path.join(homeDir, '.codex'); }
-export function codexHomeHooksPath(homeDir) { return path.join(codexHome(homeDir), 'hooks.json'); }
-export function codexConfigPath(homeDir) { return path.join(codexHome(homeDir), 'config.toml'); }
-function runCodex(homeDir, args) {
+function codexHome(homeDir, codexHomeDir) {
+    const explicit = codexHomeDir?.trim();
+    return explicit ? path.resolve(explicit) : path.join(homeDir, '.codex');
+}
+export function codexHomeHooksPath(homeDir, codexHomeDir) { return path.join(codexHome(homeDir, codexHomeDir), 'hooks.json'); }
+export function codexConfigPath(homeDir, codexHomeDir) { return path.join(codexHome(homeDir, codexHomeDir), 'config.toml'); }
+function runCodex(homeDir, args, codexHomeDir) {
     const result = spawnSync(process.env.SQUARE_CODEX_BIN || 'codex', args, {
-        encoding: 'utf8', env: { ...process.env, HOME: homeDir, CODEX_HOME: codexHome(homeDir) }, timeout: 30_000,
+        encoding: 'utf8', env: { ...process.env, HOME: homeDir, CODEX_HOME: codexHome(homeDir, codexHomeDir) }, timeout: 30_000,
     });
     if (result.error)
         throw result.error;
@@ -77,10 +80,11 @@ function writeAtomic(file, text) {
     fs.writeFileSync(temp, text, { mode: 0o600 });
     fs.renameSync(temp, file);
 }
-export async function installCodexPlugin(homeDir, run = runCodex) {
-    const config = codexConfigPath(homeDir);
+export async function installCodexPlugin(homeDir, run = runCodex, codexHomeDir) {
+    const resolvedCodexHome = codexHome(homeDir, codexHomeDir);
+    const config = codexConfigPath(homeDir, resolvedCodexHome);
     const current = fs.existsSync(config) ? fs.readFileSync(config, 'utf8') : '';
-    const root = activeMarketplaceRoot(homeDir, current);
+    const root = activeMarketplaceRoot(homeDir, current, resolvedCodexHome);
     const staged = stageReplacement(root, (stage) => {
         const plugin = path.join(stage, 'plugins', SQUARE_IDENTITY.pluginName);
         fs.cpSync(fileURLToPath(new URL('../codex-plugin/', import.meta.url)), plugin, { recursive: true });
@@ -92,8 +96,8 @@ export async function installCodexPlugin(homeDir, run = runCodex) {
     const notes = [];
     try {
         writeAtomic(config, upsertTomlSectionKey(current, 'features', 'hooks', 'true'));
-        requireSuccess(run(homeDir, ['plugin', 'marketplace', 'add', root, '--json']), 'marketplace install', true);
-        const installed = run(homeDir, ['plugin', 'add', CODEX_PLUGIN_ID, '--json']);
+        requireSuccess(run(homeDir, ['plugin', 'marketplace', 'add', root, '--json'], resolvedCodexHome), 'marketplace install', true);
+        const installed = run(homeDir, ['plugin', 'add', CODEX_PLUGIN_ID, '--json'], resolvedCodexHome);
         requireSuccess(installed, 'plugin install');
         let installedPath;
         try {
@@ -108,8 +112,8 @@ export async function installCodexPlugin(homeDir, run = runCodex) {
             const pluginId = `${SQUARE_IDENTITY.pluginName}@${marketplace}`;
             if (!current.includes(`[marketplaces.${marketplace}]`) && !current.includes(`[plugins."${pluginId}"]`))
                 continue;
-            requireSuccess(run(homeDir, ['plugin', 'remove', pluginId, '--json']), 'legacy plugin removal', true);
-            requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', marketplace, '--json']), 'legacy marketplace removal', true);
+            requireSuccess(run(homeDir, ['plugin', 'remove', pluginId, '--json'], resolvedCodexHome), 'legacy plugin removal', true);
+            requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', marketplace, '--json'], resolvedCodexHome), 'legacy marketplace removal', true);
             notes.push(`retired ${pluginId}`);
         }
         staged.finalize();
@@ -120,25 +124,27 @@ export async function installCodexPlugin(homeDir, run = runCodex) {
         throw error;
     }
 }
-export async function uninstallCodexPlugin(homeDir, run = runCodex) {
-    const config = codexConfigPath(homeDir);
+export async function uninstallCodexPlugin(homeDir, run = runCodex, codexHomeDir) {
+    const resolvedCodexHome = codexHome(homeDir, codexHomeDir);
+    const config = codexConfigPath(homeDir, resolvedCodexHome);
     const current = fs.existsSync(config) ? fs.readFileSync(config, 'utf8') : '';
-    const root = activeMarketplaceRoot(homeDir, current);
-    requireSuccess(run(homeDir, ['plugin', 'remove', CODEX_PLUGIN_ID, '--json']), 'plugin removal', true);
-    requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', CODEX_MARKETPLACE_NAME, '--json']), 'marketplace removal', true);
+    const root = activeMarketplaceRoot(homeDir, current, resolvedCodexHome);
+    requireSuccess(run(homeDir, ['plugin', 'remove', CODEX_PLUGIN_ID, '--json'], resolvedCodexHome), 'plugin removal', true);
+    requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', CODEX_MARKETPLACE_NAME, '--json'], resolvedCodexHome), 'marketplace removal', true);
     for (const marketplace of LEGACY_MARKETPLACES) {
-        requireSuccess(run(homeDir, ['plugin', 'remove', `${SQUARE_IDENTITY.pluginName}@${marketplace}`, '--json']), 'legacy plugin removal', true);
-        requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', marketplace, '--json']), 'legacy marketplace removal', true);
+        requireSuccess(run(homeDir, ['plugin', 'remove', `${SQUARE_IDENTITY.pluginName}@${marketplace}`, '--json'], resolvedCodexHome), 'legacy plugin removal', true);
+        requireSuccess(run(homeDir, ['plugin', 'marketplace', 'remove', marketplace, '--json'], resolvedCodexHome), 'legacy marketplace removal', true);
     }
     fs.rmSync(root, { recursive: true, force: true });
-    fs.rmSync(codexHomeHooksPath(homeDir), { force: true });
-    return { paths: [root, codexConfigPath(homeDir), codexHomeHooksPath(homeDir)], notes: [] };
+    fs.rmSync(codexHomeHooksPath(homeDir, resolvedCodexHome), { force: true });
+    return { paths: [root, config, codexHomeHooksPath(homeDir, resolvedCodexHome)], notes: [] };
 }
-export async function doctorCodexPlugin(homeDir, run = runCodex) {
-    const config = codexConfigPath(homeDir);
+export async function doctorCodexPlugin(homeDir, run = runCodex, codexHomeDir) {
+    const resolvedCodexHome = codexHome(homeDir, codexHomeDir);
+    const config = codexConfigPath(homeDir, resolvedCodexHome);
     const current = fs.existsSync(config) ? fs.readFileSync(config, 'utf8') : '';
-    const root = activeMarketplaceRoot(homeDir, current);
-    const listed = run(homeDir, ['plugin', 'list', '--json']);
+    const root = activeMarketplaceRoot(homeDir, current, resolvedCodexHome);
+    const listed = run(homeDir, ['plugin', 'list', '--json'], resolvedCodexHome);
     return [
         /^hooks\s*=\s*true$/m.test(current) ? `✓ features.hooks=true in ${config}` : `○ features.hooks missing in ${config}`,
         fs.existsSync(codexPluginHooksPath(homeDir, root)) ? `✓ Square plugin hooks ${codexPluginHooksPath(homeDir, root)}` : `○ Square plugin bundle missing ${root}`,

package/dist/harness-links.js

@@ -122,6 +122,3 @@ export function opencodeExtensionLink(homeDir = os.homedir()) {
         kind: 'extension',
     };
 }
-export function piExtensionLink(homeDir = os.homedir()) {
-    return { source: path.join(packageRoot(), 'extensions', 'square-pi.js'), target: path.join(homeDir, '.pi', 'agent', 'extensions', 'square.js'), kind: 'extension' };
-}

package/dist/harness-pi.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { SQUARE_IDENTITY } from './identity.js';
+export function piPackageSource() {
+    return `npm:${SQUARE_IDENTITY.packageName}@${SQUARE_IDENTITY.packageVersion}`;
+}
+export function piPackageRoot(homeDir) {
+    return path.join(homeDir, '.pi', 'agent', 'npm', 'node_modules', ...SQUARE_IDENTITY.packageName.split('/'));
+}
+function runPi(homeDir, args) {
+    const result = spawnSync(process.env.SQUARE_PI_BIN || 'pi', args, {
+        encoding: 'utf8',
+        env: { ...process.env, HOME: homeDir },
+        timeout: 30_000,
+    });
+    if (result.error)
+        throw result.error;
+    return { status: result.status ?? 1, stdout: result.stdout || '', stderr: result.stderr || '' };
+}
+function requireSuccess(result, action) {
+    if (result.status === 0)
+        return;
+    throw new Error(`Pi ${action} failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.status}`}`);
+}
+export function installPiPackage(homeDir, run = runPi) {
+    requireSuccess(run(homeDir, ['install', piPackageSource()]), 'package install');
+    return [piPackageRoot(homeDir)];
+}
+export function uninstallPiPackage(homeDir, run = runPi) {
+    requireSuccess(run(homeDir, ['remove', piPackageSource()]), 'package removal');
+    return [piPackageRoot(homeDir)];
+}
+export function doctorPiPackage(homeDir, run = runPi) {
+    const listed = run(homeDir, ['list']);
+    const root = piPackageRoot(homeDir);
+    const manifestPath = path.join(root, 'package.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        // The diagnostics below name the missing or invalid package state.
+    }
+    const extensions = manifest?.pi?.extensions;
+    return [
+        listed.status === 0 && listed.stdout.includes(SQUARE_IDENTITY.packageName)
+            ? `✓ Pi package ${SQUARE_IDENTITY.packageName} configured`
+            : `○ Pi package ${SQUARE_IDENTITY.packageName} not configured`,
+        manifest?.version === SQUARE_IDENTITY.packageVersion
+            ? `✓ Pi package ${SQUARE_IDENTITY.packageVersion} installed at ${root}`
+            : `○ Pi package ${SQUARE_IDENTITY.packageVersion} missing at ${root}`,
+        Array.isArray(extensions) && extensions.includes('./extensions/square-pi.js')
+            ? '✓ Pi Square extension declared'
+            : '○ Pi Square extension not declared',
+    ];
+}

package/dist/harness.js

@@ -1,8 +1,10 @@
 import fs from 'node:fs';
 import { doctorDeliveryHealth } from './delivery-health.js';
+import { wakeGraceMs } from './notifications.js';
 import { doctorClaudePlugin, installClaudePlugin, uninstallClaudePlugin, } from './harness-claude.js';
 import { doctorCodexPlugin, installCodexPlugin, uninstallCodexPlugin, } from './harness-codex.js';
-import { doctorHarnessLinks, installHarnessLinks, opencodeExtensionLink, piExtensionLink, skillLinks, uninstallHarnessLinks, verifyOpenCodeRuntime, } from './harness-links.js';
+import { doctorPiPackage, installPiPackage, uninstallPiPackage, } from './harness-pi.js';
+import { doctorHarnessLinks, installHarnessLinks, opencodeExtensionLink, skillLinks, uninstallHarnessLinks, verifyOpenCodeRuntime, } from './harness-links.js';
 function result(lines, notes = []) {
     return { lines, notes };
 }
@@ -28,13 +30,6 @@ function readableSquarePath(squarePath) {
     }
 }
 const TARGETS = [
-    {
-        name: 'skills',
-        capabilities: ['install', 'uninstall', 'doctor'],
-        install: ({ homeDir, force }) => result(installHarnessLinks(skillLinks(homeDir), force)),
-        uninstall: ({ homeDir }) => result(uninstallHarnessLinks(skillLinks(homeDir))),
-        doctor: ({ homeDir }) => result(doctorHarnessLinks(skillLinks(homeDir))),
-    },
     {
         name: 'claude',
         capabilities: ['install', 'uninstall', 'doctor'],
@@ -52,7 +47,7 @@ const TARGETS = [
         name: 'codex',
         capabilities: ['install', 'uninstall', 'doctor'],
         async install({ homeDir }) {
-            const installed = await installCodexPlugin(homeDir);
+            const installed = await installCodexPlugin(homeDir, undefined, process.env.CODEX_HOME);
             const lines = [
                 installed.configPath,
                 installed.marketplaceRoot,
@@ -62,10 +57,10 @@ const TARGETS = [
             return result(lines, installed.notes);
         },
         async uninstall({ homeDir }) {
-            const removed = await uninstallCodexPlugin(homeDir);
+            const removed = await uninstallCodexPlugin(homeDir, undefined, process.env.CODEX_HOME);
             return result(removed.paths, removed.notes);
         },
-        async doctor({ homeDir }) { return doctorHost('Codex', () => doctorCodexPlugin(homeDir)); },
+        async doctor({ homeDir }) { return doctorHost('Codex', () => doctorCodexPlugin(homeDir, undefined, process.env.CODEX_HOME)); },
     },
     {
         name: 'opencode',
@@ -77,15 +72,15 @@ const TARGETS = [
     {
         name: 'pi',
         capabilities: ['install', 'uninstall', 'doctor'],
-        install: ({ homeDir, force }) => result(installHarnessLinks([piExtensionLink(homeDir)], force)),
-        uninstall: ({ homeDir }) => result(uninstallHarnessLinks([piExtensionLink(homeDir)])),
-        doctor: ({ homeDir }) => result(doctorHarnessLinks([piExtensionLink(homeDir)])),
+        install: ({ homeDir }) => result(installPiPackage(homeDir)),
+        uninstall: ({ homeDir }) => result(uninstallPiPackage(homeDir)),
+        doctor: ({ homeDir }) => result(doctorPiPackage(homeDir)),
     },
     {
         name: 'delivery',
         capabilities: ['doctor'],
         doctor: ({ squarePath }) => result(readableSquarePath(squarePath)
-            ? doctorDeliveryHealth(squarePath)
+            ? doctorDeliveryHealth(squarePath, wakeGraceMs())
             : ['○ delivery health skipped (no readable square path)']),
     },
 ];

package/dist/help.js

@@ -11,7 +11,7 @@ const COMMANDS = [
         details: ['Options:', '  --depth <N>  Descend through at most N directory levels (default 4; 0 scans only the current directory).'],
     },
     {
-        names: ['join'], usage: '--as <name> join [--last N | --all]', usesSquare: true, group: 'participant',
+        names: ['join'], usage: '--as <name> join [--last N | --all] [--kick]', usesSquare: true, group: 'participant',
         summary: 'Step into the square and read its current context.',
         details: ['Options:', '  --last <N>  Show the last N public activities (default 10).', '  --all       Show the complete history.'],
     },
@@ -50,17 +50,17 @@ const COMMANDS = [
     {
         names: ['install'], usage: 'install (--all | <target>...) [-f]', group: 'maintenance',
         summary: 'Install Square support for one or more agent hosts.',
-        details: ['Targets:', '  skills, claude, codex, opencode, pi', '', 'Options:', '  --all       Install every supported target.', '  -f, --force Replace existing managed links.'],
+        details: ['Targets:', '  claude, codex, opencode, pi', '', 'Options:', '  --all       Install every supported target.', '  -f, --force Replace existing managed links.'],
     },
     {
         names: ['uninstall'], usage: 'uninstall (--all | <target>...)', group: 'maintenance',
         summary: 'Remove Square support from one or more agent hosts.',
-        details: ['Targets:', '  skills, claude, codex, opencode, pi', '', 'Options:', '  --all  Remove every supported target.'],
+        details: ['Targets:', '  claude, codex, opencode, pi', '', 'Options:', '  --all  Remove every supported target.'],
     },
     {
-        names: ['harness'], usage: 'harness doctor [skills|claude|codex|opencode|pi|delivery]', usesSquare: true, group: 'maintenance', hiddenFromIndex: true,
+        names: ['harness'], usage: 'harness doctor [claude|codex|opencode|pi|delivery]', usesSquare: true, group: 'maintenance', hiddenFromIndex: true,
         summary: 'Diagnose installed agent-host support.',
-        details: ['Targets:', '  skills, claude, codex, opencode, pi  Diagnose one installed adapter.', '  delivery                              Diagnose delivery for the selected square.'],
+        details: ['Targets:', '  claude, codex, opencode, pi  Diagnose one installed adapter.', '  delivery                      Diagnose delivery for the selected square.'],
     },
     { names: ['compact'], usage: 'compact [--keep N]', usesSquare: true, group: 'host', summary: 'Move older activity out of the working artifact while keeping the latest N.' },
     {
@@ -90,7 +90,7 @@ export function renderGlobalHelp() {
         '',
     ]);
     return [
-        'Usage: square [--square-path <path>] [--as <name>] <command> [args...]',
+        'Usage: square [--location <path>] [--as <name>] <command> [args...]',
         '',
         ...commandLines,
         "Run 'square <command> --help' for command options.",
@@ -104,7 +104,7 @@ export function renderSubcommandHelp(command) {
     const aliases = definition.names.filter((name) => name !== command);
     const usage = definition.usage.replace('{command}', command);
     return [
-        `Usage: square ${definition.usesSquare ? '[--square-path <path>] ' : ''}${usage}`,
+        `Usage: square ${definition.usesSquare ? '[--location <path>] ' : ''}${usage}`,
         ...(aliases.length > 0 ? [`Aliases: ${aliases.join(', ')}`] : []),
         '',
         definition.summary,
@@ -121,7 +121,7 @@ export function helpRequest(rawArgs) {
     const args = [];
     for (let index = 0; index < rawArgs.length; index++) {
         const arg = rawArgs[index];
-        if (arg === '--square-path' || arg === '--as') {
+        if (arg === '--location' || arg === '--as') {
             const value = rawArgs[index + 1];
             if (value === undefined || value.startsWith('--'))
                 return undefined;

package/dist/index.js

@@ -2,7 +2,7 @@ export { SquareError } from './model.js';
 export { loadSquare } from './artifact.js';
 export { extractMentions, countSays, joinedNames, doneNames, isCurrentlyJoined, publicActs, readCursor, } from './runtime.js';
 import { loadSquare } from './artifact.js';
-import { hasDeliveredNotification as hasDeliveredNotificationImpl, waitForDeliveredNotification as waitForDeliveredNotificationImpl, } from './notifications.js';
+import { dispatchActNotifications, hasDeliveredNotification as hasDeliveredNotificationImpl, sweepPendingNotifications, waitForDeliveredNotification as waitForDeliveredNotificationImpl, } from './notifications.js';
 import { WATCH_STALE_MS, freshWatchLease, getReadState as getDocReadState, } from './runtime.js';
 import { resolveKnownName } from './decisions.js';
 import { execute } from './square-application.js';
@@ -52,6 +52,7 @@ export async function resume(squarePath, actor) {
     await execute(squarePath, { type: 'resume', actor, now: Date.now() });
 }
 export async function express(squarePath, name, body, opts = {}) {
+    await sweepPendingNotifications(squarePath);
     const committed = await execute(squarePath, {
         type: 'say',
         name,
@@ -60,6 +61,9 @@ export async function express(squarePath, name, body, opts = {}) {
         now: Date.now(),
         ...(opts.reply === undefined ? {} : { reply: actRefIndex(opts.reply) }),
     });
+    const sayAct = committed.acts.find((act) => act.kind === 'say');
+    if (sayAct !== undefined)
+        await dispatchActNotifications(squarePath, sayAct);
     if (committed.result.type !== 'sent')
         throw new Error(`Activity rejected: ${committed.result.type}`);
 }

package/dist/model.js

@@ -1,4 +1,8 @@
 // Shared model and constants for Square.
+export const WAKE_ROUTE_KINDS = ['opencode-server', 'codex-app-server', 'claude-native', 'pi-extension', 'paseo'];
+export function isWakeRouteKind(value) {
+    return typeof value === 'string' && WAKE_ROUTE_KINDS.includes(value);
+}
 export class SquareError extends Error {
     code;
     constructor(code, message) {