@tinycloud/courier 0.6.0-beta.17 → 0.6.0-beta.19

package/dist/status.js

@@ -0,0 +1,86 @@
+import { requireFlag } from './args.js';
+import { CourierError } from './errors.js';
+import { getPeer, loadProfile } from './profile.js';
+import { cmd } from './program.js';
+import { oneLine } from './a2a.js';
+export const EXPIRY_WARNING_MS = 24 * 60 * 60 * 1000;
+/** Local expiry metadata only: this does not verify authority or remote access. */
+export function grantExpiry(expiresAt, now = Date.now()) {
+    if (expiresAt === undefined)
+        return { state: 'missing', expiresAt: null };
+    const end = Date.parse(expiresAt);
+    if (!Number.isFinite(end))
+        return { state: 'unknown', expiresAt: null };
+    return {
+        state: end <= now ? 'expired' : end - now <= EXPIRY_WARNING_MS ? 'expiring' : 'current',
+        expiresAt: new Date(end).toISOString(),
+    };
+}
+export function peerExpiryStatus(peer, now = Date.now()) {
+    const inbound = grantExpiry(peer.inbound?.expiresAt, now);
+    const outbound = grantExpiry(peer.outbound.at(-1)?.expiresAt, now);
+    const live = (g) => g.state === 'current' || g.state === 'expiring';
+    const renewalCommand = peer.status === 'paired' && live(inbound) && live(outbound)
+        ? cmd(`pair renew ${peer.handle}`) : null;
+    const warnings = [];
+    for (const [side, grant] of [['inbound', inbound], ['outbound', outbound]]) {
+        if (grant.state === 'expiring')
+            warnings.push(`The saved ${side} grant for ${oneLine(peer.handle)} expires within 24 hours (${grant.expiresAt}).`);
+        if (grant.state === 'expired')
+            warnings.push(side === 'inbound'
+                ? `Your saved access to ${oneLine(peer.handle)} has expired; the peer must approve a new grant.`
+                : `${oneLine(peer.handle)}'s saved access to you has expired; you must approve a new grant.`);
+        if (grant.state === 'missing')
+            warnings.push(`No saved ${side} grant for ${oneLine(peer.handle)}.`);
+        if (grant.state === 'unknown')
+            warnings.push(`The saved ${side} grant for ${oneLine(peer.handle)} has no expiry on record.`);
+    }
+    return {
+        peer: peer.handle, pairing: peer.status, inbound, outbound,
+        remoteReadability: 'not-checked',
+        renewal: { state: 'unknown', command: renewalCommand },
+        warnings,
+    };
+}
+const statusUsage = () => `Usage: ${cmd('status [--peer <peer>] [--json]')}`;
+/** Works even after grants lapse: never initializes a node, renews, or sends. */
+export function cmdStatus(args) {
+    if (args.positional.length || args.all('peer').length > 1)
+        throw new CourierError('usage', statusUsage());
+    const requested = args.has('peer') ? requireFlag(args, 'peer', statusUsage()) : undefined;
+    if (requested !== undefined && !requested.trim())
+        throw new CourierError('usage', statusUsage());
+    const profile = loadProfile();
+    const peers = requested === undefined ? Object.values(profile.peers) : [getPeer(profile, requested)];
+    const now = Date.now();
+    const output = { source: 'saved-profile', checkedAt: new Date(now).toISOString(), peers: peers.map(peer => peerExpiryStatus(peer, now)) };
+    if (args.has('json')) {
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    console.log("Showing saved expiry times.");
+    console.log("Inbound: your access to the peer. Outbound: the peer's access to you (latest saved grant).");
+    if (!output.peers.length)
+        console.log('No saved peers.');
+    for (const peer of output.peers) {
+        console.log(`${oneLine(peer.peer)} (${peer.pairing})`);
+        for (const side of ['inbound', 'outbound']) {
+            const grant = peer[side];
+            console.log(`  ${side}: ${grant.state}${grant.expiresAt ? ` — ${utcTime(grant.expiresAt)}` : ''}`);
+        }
+        for (const warning of peer.warnings) {
+            let text = warning;
+            for (const grant of [peer.inbound, peer.outbound]) {
+                if (grant.expiresAt)
+                    text = text.replaceAll(grant.expiresAt, utcTime(grant.expiresAt));
+            }
+            console.log(`  Warning: ${text}`);
+        }
+        if (peer.renewal.command)
+            console.log(`  To renew before it expires, run: ${peer.renewal.command}`);
+    }
+}
+function utcTime(iso) {
+    return `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinycloud/courier",
-  "version": "0.6.0-beta.17",
+  "version": "0.6.0-beta.19",
   "description": "Courier: agent-to-agent threads over TinyCloud (CLI, library and agent skill)",
   "author": "TinyCloud, Inc.",
   "type": "module",
@@ -30,10 +30,10 @@
     "test:live": "tsc -p tsconfig.json && node scripts/happy-path.mjs"
   },
   "dependencies": {
-    "@tinycloud/node-sdk": "3.12.0-beta.16",
-    "@tinycloud/sdk-core": "3.12.0-beta.16",
-    "@tinycloud/share-envelope": "1.5.0",
-    "@tinycloud/share-sdk": "1.5.0-beta.0",
+    "@tinycloud/node-sdk": "3.12.0-beta.17",
+    "@tinycloud/sdk-core": "3.12.0-beta.17",
+    "@tinycloud/share-envelope": "1.6.0-beta.0",
+    "@tinycloud/share-sdk": "1.5.0-beta.1",
     "ulid": "^3.0.2"
   },
   "devDependencies": {