@astrosheep/square 0.3.63 → 0.3.65

package/dist/diagnostic-redaction.js

@@ -1,16 +1,14 @@
 const MAX_STRING_LENGTH = 1_000;
 const MAX_COLLECTION_ITEMS = 32;
 const MAX_NESTING = 8;
-function redactText(value, secret) {
-    const withoutSecret = secret?.trim() ? value.split(secret.trim()).join('[redacted]') : value;
-    const withoutUrlPassword = withoutSecret.replace(/([?&]password=)[^&\s]+/gi, '$1[redacted]');
-    return [...withoutUrlPassword].length <= MAX_STRING_LENGTH
-        ? withoutUrlPassword
-        : `${[...withoutUrlPassword].slice(0, MAX_STRING_LENGTH - 1).join('')}…`;
-}
 function redactValue(value, secret, seen, depth) {
-    if (typeof value === 'string')
-        return redactText(value, secret);
+    if (typeof value === 'string') {
+        const withoutSecret = secret?.trim() ? value.split(secret.trim()).join('[redacted]') : value;
+        const withoutUrlPassword = withoutSecret.replace(/([?&]password=)[^&\s]+/gi, '$1[redacted]');
+        return [...withoutUrlPassword].length <= MAX_STRING_LENGTH
+            ? withoutUrlPassword
+            : `${[...withoutUrlPassword].slice(0, MAX_STRING_LENGTH - 1).join('')}…`;
+    }
     if (depth >= MAX_NESTING)
         return '[truncated]';
     if (Array.isArray(value)) {

package/dist/file-changes.d.ts

@@ -1,4 +1,3 @@
-export declare function canonicalFilePath(value: string): Promise<string>;
 export interface VersionObserver<T> {
     readonly generation: number;
     hinted(since: number, timeoutMs: number, signal?: AbortSignal): Promise<boolean>;

package/dist/file-changes.js

@@ -1,25 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { canonicalPath } from './canonical-path.js';
 /** Filesystem notifications are hints, never proof of a committed change. */
 const RECONCILE_MS = 2_000;
-export async function canonicalFilePath(value) {
-    let current = path.resolve(value);
-    const suffix = [];
-    for (;;) {
-        try {
-            return path.join(await fs.promises.realpath(current), ...suffix.reverse());
-        }
-        catch (error) {
-            if (error.code !== 'ENOENT')
-                return path.resolve(value);
-            const parent = path.dirname(current);
-            if (parent === current)
-                return path.resolve(value);
-            suffix.push(path.basename(current));
-            current = parent;
-        }
-    }
-}
 /** A local edge counter: register first, inspect state, then wait from that counter. */
 class Edges {
     version = 0;
@@ -144,7 +127,7 @@ async function abortable(promise, signal) {
 const versions = new Map();
 /** Shared only within this process. Durable state is always read at the storage boundary. */
 export async function observeFileVersion(filePath, kind, read) {
-    const file = await canonicalFilePath(filePath);
+    const file = await canonicalPath(filePath);
     const key = kind + '\0' + file;
     let shared = versions.get(key);
     if (shared === undefined) {

package/dist/harness-claude.js

@@ -27,10 +27,6 @@ function requireSuccess(result, operation, allowMissing = false) {
         return;
     throw new Error(`Claude ${operation} failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.status}`}`);
 }
-function writeJson(file, value) {
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
-}
 export async function installClaudePlugin(homeDir, run = runClaude) {
     const marketplaceRoot = claudeMarketplaceRoot(homeDir);
     const staged = stageReplacement(marketplaceRoot, (stage) => {
@@ -39,11 +35,13 @@ export async function installClaudePlugin(homeDir, run = runClaude) {
         const skill = path.join(plugin, 'skills', 'square', 'SKILL.md');
         fs.mkdirSync(path.dirname(skill), { recursive: true });
         fs.copyFileSync(path.join(fileURLToPath(new URL('../skills/square/', import.meta.url)), 'SKILL.md'), skill);
-        writeJson(path.join(stage, '.claude-plugin', 'marketplace.json'), {
+        const manifestPath = path.join(stage, '.claude-plugin', 'marketplace.json');
+        fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+        fs.writeFileSync(manifestPath, `${JSON.stringify({
             name: CLAUDE_MARKETPLACE_NAME,
             owner: { name: 'Square' },
             plugins: [{ name: SQUARE_IDENTITY.pluginName, source: './plugins/square' }],
-        });
+        }, null, 2)}\n`, { mode: 0o600 });
     });
     try {
         const add = run(homeDir, ['plugin', 'marketplace', 'add', marketplaceRoot]);
@@ -73,5 +71,9 @@ export async function doctorClaudePlugin(homeDir, run = runClaude) {
     return [
         fs.existsSync(bundle) ? `✓ Square Claude plugin bundle ${root}` : `○ Square Claude plugin bundle missing ${root}`,
         installed ? `✓ ${CLAUDE_PLUGIN_ID} installed` : `○ ${CLAUDE_PLUGIN_ID} unavailable`,
+        `Claude native inbox: validated on macOS Claude Code 2.1.295 with a trusted, approved interactive mod.`,
+        `Installation or a socket alone does not prove receiver availability; absent/disabled mods, headless unapproved mods, other builds/platforms are unavailable.`,
+        `Queue admission is not model processing. Queued or held native messages cannot be retracted by Square cancellation.`,
+        `Live routes and admission/presentation evidence: square harness doctor delivery. No legacy fallback.`,
     ];
 }

package/dist/harness-codex.d.ts

@@ -1,5 +1,3 @@
-export declare const CODEX_HOOK_COMMAND: "square codex-hook";
-export declare const SQUARE_CODEX_MARKER: "square-codex-hook";
 export declare const CODEX_PLUGIN_ID: "square@astrosheep";
 export declare const CODEX_MARKETPLACE_NAME: "astrosheep";
 export interface CodexCommandResult {

package/dist/harness-codex.js

@@ -4,8 +4,6 @@ import { fileURLToPath } from 'node:url';
 import crossSpawn from 'cross-spawn';
 import { SQUARE_IDENTITY } from './identity.js';
 import { stageReplacement } from './harness-stage.js';
-export const CODEX_HOOK_COMMAND = SQUARE_IDENTITY.hookCommand;
-export const SQUARE_CODEX_MARKER = SQUARE_IDENTITY.hookMarker;
 export const CODEX_PLUGIN_ID = SQUARE_IDENTITY.pluginId;
 export const CODEX_MARKETPLACE_NAME = SQUARE_IDENTITY.marketplaceName;
 const LEGACY_MARKETPLACES = ['astrosheep-square'];

package/dist/harness-links.js

@@ -9,22 +9,21 @@ function packageRoot() {
     // Emitted modules live in dist; package assets are one level above them.
     return fileURLToPath(new URL('../', import.meta.url));
 }
-function lstatMaybe(target) {
-    try {
-        return fs.lstatSync(target);
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-}
 export function installHarnessLinks(links, force = false) {
     const prepared = links.map((link) => {
         if (!fs.existsSync(link.source)) {
             throw new Error(`Harness link source is missing: ${link.source}`);
         }
-        const existing = lstatMaybe(link.target);
+        const existing = (() => {
+            try {
+                return fs.lstatSync(link.target);
+            }
+            catch (error) {
+                if (error.code === 'ENOENT')
+                    return undefined;
+                throw error;
+            }
+        })();
         return {
             ...link,
             existing,
@@ -94,16 +93,13 @@ function runOpenCode(homeDir, args) {
         throw result.error;
     return { status: result.status ?? 1, stdout: result.stdout || '', stderr: result.stderr || '' };
 }
-function requireOpenCodeSuccess(result, action) {
-    if (result.status === 0)
-        return;
-    throw new Error(`OpenCode ${action} failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.status}`}`);
-}
 export function installOpenCodePlugin(homeDir, force = false, run = runOpenCode) {
     const args = ['plugin', SQUARE_IDENTITY.packageName, '--global'];
     if (force)
         args.push('--force');
-    requireOpenCodeSuccess(run(homeDir, args), 'plugin install');
+    const result = run(homeDir, args);
+    if (result.status !== 0)
+        throw new Error(`OpenCode plugin install failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.status}`}`);
     return [SQUARE_IDENTITY.packageName];
 }
 function configPath(homeDir) {

package/dist/harness.js

@@ -97,14 +97,10 @@ const TARGETS = [
 export function harnessTargets() {
     return TARGETS;
 }
-function requireHarnessCapability(target, action) {
-    const found = TARGETS.find((candidate) => candidate.name === target);
-    if (found === undefined || !found.capabilities.includes(action))
-        throw new Error(`Unsupported harness capability: ${action} ${target}`);
-    return found;
-}
 export async function executeHarnessTarget(targetName, action, context) {
-    const target = requireHarnessCapability(targetName, action);
+    const target = TARGETS.find((candidate) => candidate.name === targetName);
+    if (target === undefined || !target.capabilities.includes(action))
+        throw new Error(`Unsupported harness capability: ${action} ${targetName}`);
     const capability = target[action];
     if (capability === undefined)
         throw new Error(`Unsupported harness capability: ${action} ${targetName}`);

package/dist/help.js

@@ -17,9 +17,9 @@ const COMMANDS = [
         details: ['Options:', '  --last <N>  Show the last N public activities (default 10, maximum 100).', '  --kick      End the standing participant and reclaim the name for this session.'],
     },
     {
-        names: ['express'], usage: '--as <name> express [-f|--force] [--no-wait] (--mention <name>... | --no-mention | --bell) [--reply <activity-id>] <activity | ->', usesSquare: true, group: 'participant',
+        names: ['express'], usage: '--as <name> express [-f|--force] [--no-wait] (--mention <name>... | --no-mention | --bell | --reply <activity-id>) <activity | ->', usesSquare: true, group: 'participant',
         summary: 'Speak, gesture, or do both.',
-        details: ['Reach:', '  --mention <name>  Address one participant; repeat for multiple participants. The body stays unchanged.', '  --no-mention      Land a bare activity explicitly; @names stay plain text. listen opts someone into future bare delivery.', "  --bell            Call every participant's attention to this activity.", '  @name             An @name in the body also addresses that standing participant; `backticks` keep @text literal.', '', 'Options:', '  -f, --force       Express without first catching unread activity or attention etiquette.', '  --no-wait         If held or throttled, save a draft and return instead of waiting. A held wait gives up on its own after 10 minutes.', '  --reply <activity-id>   Mark this activity as a reply to an earlier activity (for example act/12).'],
+        details: ['Reach:', '  --mention <name>  Address one participant; repeat for multiple participants. The body stays unchanged.', '  --no-mention      Land a bare activity explicitly; @names stay plain text. listen opts someone into future bare delivery.', "  --bell            Call every participant's attention to this activity.", '  @name             An @name in the body also addresses that standing participant; `backticks` keep @text literal.', '', 'Options:', '  -f, --force       Express without first catching unread activity or attention etiquette.', '  --no-wait         If held or throttled, save a draft and return instead of waiting. A held wait gives up on its own after 10 minutes.', '  --reply <activity-id>   Mark this activity as a reply to an earlier activity (for example act/12); it reaches that activity\'s author.'],
     },
     { names: ['listen'], usage: '--as <name> listen <participant>', usesSquare: true, group: 'participant', summary: 'Turn an ear toward one participant\'s future bare says.' },
     { names: ['ignore'], usage: '--as <name> ignore <participant>', usesSquare: true, group: 'participant', summary: 'Ignore one participant\'s future mentions and bare says.' },
@@ -40,7 +40,8 @@ const COMMANDS = [
         summary: 'Inspect a bounded machine-local notification snapshot for a native session.',
         details: ['Options:', '  --for-session <id>  Required harness session id.', '  --limit <N>         Snapshot memberships (default 20, maximum 100).', '  --json              Emit the bounded snapshot as structured JSON.'],
     },
-    { names: ['claude-hook', 'codex-hook'], usage: '{command}', summary: 'Present pending attention at one native agent boundary.', hiddenFromIndex: true },
+    { names: ['codex-hook'], usage: '{command}', summary: 'Present pending attention at one native agent boundary.', hiddenFromIndex: true },
+    { names: ['claude-mod'], usage: '{command}', summary: 'Receive a structured operation from the loaded Claude mod.', hiddenFromIndex: true },
     {
         names: ['history'], usage: 'history [filters] [output]', usesSquare: true, group: 'participant',
         summary: 'Read or search the archive without changing what you have caught.',

package/dist/host-ledger-file-adapter.d.ts

@@ -1,13 +1,11 @@
 import { type VersionObserver } from './file-changes.js';
-import type { HostLedgerPort, PresenceRecord, PresenceKey, PresenceLookup, PresenceResult, PresenceClaimResult, EvidenceRecord, EvidenceClaim, EvidenceRelease, EvidenceLookup, EvidenceGc, ClaimResult, WakeDispatchClaim, WakeDispatchClaimInput, WakeDispatchReleaseInput, WakeDispatchTransitionInput, WakeAttemptLookup } from './host-ledger.js';
+import type { HostLedgerPort, PresenceRecord, PresenceKey, PresenceLookup, PresenceResult, PresenceClaimResult, EvidenceRecord, EvidenceClaim, EvidenceRelease, EvidenceLookup, EvidenceGc, ClaimResult, WakeAttemptClaim, WakeAttemptClaimInput, WakeAttemptLookup } from './host-ledger.js';
 export interface HostLedgerFileAdapterOptions {
     rootPath?: string;
-    claimsPath?: string;
     now?: () => number;
 }
 export declare class FileHostLedgerPort implements HostLedgerPort {
     private readonly root;
-    private readonly claims;
     private readonly clock;
     constructor(o?: HostLedgerFileAdapterOptions);
     private file;
@@ -18,20 +16,31 @@ export declare class FileHostLedgerPort implements HostLedgerPort {
     }>;
     /** Time can expire bindings/evidence even when their files do not change. */
     nextExpiry(session: string): Promise<number>;
+    /** The ownership claim critical section: the same lock as claimPresence and finalize. */
+    withClaimLock<T>(fn: () => Promise<T>, signal?: AbortSignal): Promise<T>;
     claimPresence(i: PresenceRecord, signal?: AbortSignal): Promise<PresenceClaimResult>;
     ensurePresence(i: PresenceRecord): Promise<PresenceResult>;
+    /** Local batch suppression is monotonic only for the captured host generation. */
+    suppressPresence(i: PresenceRecord, through: number): Promise<boolean>;
     removePresence(i: PresenceKey): Promise<void>;
     removePresenceIfUnchanged(i: PresenceRecord): Promise<boolean>;
     listPresence(i?: PresenceLookup): Promise<readonly PresenceRecord[]>;
-    claimWakeDispatch(i: WakeDispatchClaimInput): Promise<WakeDispatchClaim>;
-    transitionWakeDispatch(i: WakeDispatchTransitionInput): Promise<boolean>;
-    releaseWakeDispatch(i: WakeDispatchReleaseInput): Promise<void>;
+    /** One attempt row owns attention-wide exclusion and session-scoped history for a wake. */
+    claimWakeAttempt(i: WakeAttemptClaimInput): Promise<WakeAttemptClaim>;
+    /** One locked, token-fenced replacement; each operation owns its state condition. */
+    private updateWake;
     listWakeAttempts(i?: WakeAttemptLookup): Promise<readonly EvidenceRecord[]>;
-    appendWakeAttempt(i: EvidenceRecord & {
+    prepareNativeWake(i: EvidenceRecord & {
         readonly claimToken: string;
-    }): Promise<void>;
+        readonly routeKind: import('./model.js').WakeRouteKind;
+        readonly nativeDelivery: import('./host-ledger.js').NativeDeliveryEvidence;
+    }): Promise<boolean>;
+    confirmWakeAdmission(i: EvidenceRecord & {
+        readonly claimToken: string;
+    }): Promise<boolean>;
     claimEvidence(i: EvidenceClaim): Promise<ClaimResult>;
     releaseEvidence(i: EvidenceRelease): Promise<void>;
+    /** Token-fenced terminal write. A token may only finish the attempt it claimed. */
     appendEvidence(i: EvidenceRecord & {
         readonly claimToken: string;
     }): Promise<void>;