@skrr-ai/cli 0.1.36 → 0.1.38

package/dist/commands/agents/unpin.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const agent_pin_mute_1 = require("../../lib/agent-pin-mute");
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+class AgentsUnpin extends base_command_1.BaseCommand {
+    static description = 'Remove an agent from your pinned list';
+    static examples = ['<%= config.bin %> agents unpin <agent-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Agent ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsUnpin);
+        let result;
+        try {
+            result = await (0, agent_pin_mute_1.setAgentFlag)(args.id, 'pin', false);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(this.agentJson(args.id, { pin: result.value, changed: result.changed }));
+            return;
+        }
+        this.log(result.changed
+            ? `Agent ${args.id}: pin is now ${result.value}`
+            : `Agent ${args.id}: pin was already ${result.value} — nothing to do`);
+    }
+}
+exports.default = AgentsUnpin;

package/dist/commands/agents/update.d.ts

@@ -40,6 +40,18 @@ export default class AgentsUpdate extends BaseCommand {
         'hide-sequential-outputs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'is-collaborative': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'recursion-limit': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        avatar: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'conversation-starter': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'todo-working-hours': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'reasoning-tool-escape': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'commitment-responsibility': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'commitment-responsibility-ceiling': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-turns': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'tool-resources': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'install-channel': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'auto-minor-updates': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'project-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'remove-project-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/update.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
+const agent_visual_refs_1 = require("../../lib/agent-visual-refs");
+const create_1 = require("./create");
 const base_command_1 = require("../../base-command");
 const execution_target_1 = require("../../lib/execution-target");
 const prompt_1 = require("../../lib/prompt");
@@ -32,7 +34,9 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         }),
         provider: core_1.Flags.string({ description: 'New provider' }),
         model: core_1.Flags.string({ description: 'New model' }),
-        category: core_1.Flags.string({ description: 'New category' }),
+        category: core_1.Flags.string({
+            description: 'New category. `skrr agents categories` lists what this account accepts.',
+        }),
         target: core_1.Flags.string({
             description: 'Execution target. Use a Harness id, Hosted Machine session, or Agent Worker. Use hosted-machine, sbs_..., agent-worker, or a connected Harness id.',
         }),
@@ -54,7 +58,7 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         'network-agent-ids': core_1.Flags.string({ description: 'Network agent IDs JSON array' }),
         'network-include-public': core_1.Flags.boolean({ description: 'Include public agents in network' }),
         'character-3d-id': core_1.Flags.string({ description: '3D character ID' }),
-        'scene-background': core_1.Flags.string({ description: 'Scene background' }),
+        'scene-background': core_1.Flags.string({ description: agent_visual_refs_1.SCENE_BACKGROUND_FLAG_HELP }),
         'tone-mode': core_1.Flags.string({ description: 'Tone mode' }),
         'tone-id': core_1.Flags.string({ description: 'Tone ID' }),
         'tone-notes': core_1.Flags.string({ description: 'Per-agent tone notes' }),
@@ -72,6 +76,55 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         'hide-sequential-outputs': core_1.Flags.boolean({ description: 'Hide sequential outputs' }),
         'is-collaborative': core_1.Flags.boolean({ description: 'Enable collaboration' }),
         'recursion-limit': core_1.Flags.integer({ description: 'Agent recursion limit' }),
+        avatar: core_1.Flags.string({
+            description: "The agent's face, as a reference rather than a file: default, preset:<id> " +
+                '(`skrr agents avatar presets`), asset:<id> (`skrr agents avatar library`), or ' +
+                'image:<filepath>@<source>. To upload a new image use `skrr agents avatar upload`.',
+        }),
+        'conversation-starter': core_1.Flags.string({
+            description: 'Suggested opening prompt shown on the agent (repeatable; replaces the list)',
+            multiple: true,
+        }),
+        'todo-working-hours': core_1.Flags.string({
+            description: 'When this agent schedules its own work: HH:MM-HH:MM[@<IANA timezone>], e.g. ' +
+                '09:00-18:00@America/Los_Angeles',
+        }),
+        'reasoning-tool-escape': core_1.Flags.string({
+            description: 'Tool a reasoning-only turn may still use (repeatable; replaces the list). ' +
+                'These are ESCAPES, not a fenced tool surface.',
+            options: [...agent_config_1.REASONING_TOOL_ESCAPES],
+            multiple: true,
+        }),
+        'commitment-responsibility': core_1.Flags.string({
+            description: "Default work authority for this agent's commitments",
+            options: [...agent_config_1.COMMITMENT_RESPONSIBILITY_LEVELS],
+        }),
+        'commitment-responsibility-ceiling': core_1.Flags.string({
+            description: 'Ceiling a commitment may not exceed, whatever it asks for',
+            options: [...agent_config_1.COMMITMENT_RESPONSIBILITY_LEVELS],
+        }),
+        'max-turns': core_1.Flags.integer({ description: 'Maximum turns in one agent run (1-500)' }),
+        'tool-resources': core_1.Flags.string({
+            description: 'Tool resources JSON object (file_search / context / image_edit bindings)',
+        }),
+        'install-channel': core_1.Flags.string({
+            description: 'Release policy: which channel installs of this agent follow',
+            options: [...agent_config_1.RELEASE_INSTALL_CHANNELS],
+        }),
+        'auto-minor-updates': core_1.Flags.boolean({
+            description: 'Release policy: allow installs to take minor updates automatically',
+            allowNo: true,
+        }),
+        'project-id': core_1.Flags.string({
+            description: 'Prompt-store project to add this agent to (repeatable): a 24-character ObjectId — in ' +
+                'practice the instance-wide project that shares an agent with everyone, which needs the ' +
+                'SHARED_GLOBAL permission. Not a Space project id (`skrr projects`).',
+            multiple: true,
+        }),
+        'remove-project-id': core_1.Flags.string({
+            description: 'Prompt-store project to detach this agent from (repeatable)',
+            multiple: true,
+        }),
     };
     async run() {
         this.requireAuth();
@@ -107,7 +160,16 @@ class AgentsUpdate extends base_command_1.BaseCommand {
             workingDirectory: flags['working-directory'],
             defaultPermissionMode: flags['default-permission-mode'],
         });
-        payload = (0, agent_config_1.mergeAgentConfigFlags)(payload, flags);
+        // `mergeAgentConfigFlags` parses the typed flags (avatar, scene background,
+        // working hours, every JSON flag). A parse failure is the caller's input, so
+        // it is reported as a CLI error with the accepted forms — not as an unhandled
+        // throw, and not as a 400 from the server naming a zod path.
+        try {
+            payload = (0, agent_config_1.mergeAgentConfigFlags)(payload, flags);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
         if (Object.keys(payload).length === 0) {
             this.error('Nothing to update. Pass at least one flag (e.g. --name) or --from-json.', {
                 exit: 1,
@@ -123,6 +185,15 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
+        // The same check `agents create` makes. Without it, a key the server does
+        // not model — or a typo of one that it does, `max_turns` for `maxTurns` —
+        // was discarded with the same "Updated agent" line as a real change.
+        // `removeProjectIds` is an instruction, not a stored field, so it never
+        // comes back and is not reported.
+        const unapplied = (0, create_1.unappliedPayloadKeys)(payload, updated, ['removeProjectIds']);
+        if (unapplied.length > 0) {
+            this.warn(`The server did not keep ${unapplied.join(', ')} — ${unapplied.length === 1 ? 'that field is' : 'those fields are'} not part of the agent. Check \`skrr agents show <id> --json\` for the field names it stores.`);
+        }
         if (flags.json) {
             this.log(JSON.stringify((0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, updated), null, 2));
             return;

package/dist/commands/code/{oversky-agent.d.ts → skrr-agent.d.ts}

@@ -2,7 +2,7 @@ import { Command } from '@oclif/core';
 /**
  * `skrr code skrr-agent` — read and write the agent a managed session runs as.
  *
- * ── Why the name carries the `oversky-` prefix ─────────────────────────────
+ * ── Why the name carries a product prefix ─────────────────────────────────
  *
  * The engine owns `agent`: the engine binary's `agent` is its own agent-management command.
  * `skrr code` forwards argv VERBATIM, and oclif's spaced-topic dispatch collates
@@ -28,8 +28,8 @@ import { Command } from '@oclif/core';
  * API through `apiFetch`, not the `dataService` adapter `BaseCommand.init`
  * installs.
  */
-export default class CodeOverskyAgent extends Command {
-    static aliases: string[];
+export default class CodeSkrrAgent extends Command {
+    static hiddenAliases: string[];
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/code/{oversky-agent.js → skrr-agent.js}

@@ -9,7 +9,7 @@ const first_party_harness_managed_1 = require("../../lib/first-party-harness-man
 /**
  * `skrr code skrr-agent` — read and write the agent a managed session runs as.
  *
- * ── Why the name carries the `oversky-` prefix ─────────────────────────────
+ * ── Why the name carries a product prefix ─────────────────────────────────
  *
  * The engine owns `agent`: the engine binary's `agent` is its own agent-management command.
  * `skrr code` forwards argv VERBATIM, and oclif's spaced-topic dispatch collates
@@ -35,11 +35,14 @@ const first_party_harness_managed_1 = require("../../lib/first-party-harness-man
  * API through `apiFetch`, not the `dataService` adapter `BaseCommand.init`
  * installs.
  */
-class CodeOverskyAgent extends core_1.Command {
-    // `skrr code skrr-agent` is the spelling to teach; the `oversky-` one is the
-    // path this file has and stays reachable, because it is in scripts and in
-    // muscle memory.
-    static aliases = ['code:skrr-agent'];
+class CodeSkrrAgent extends core_1.Command {
+    // `skrr code skrr-agent` is the name (docs/product/skrr-naming-map.md). The
+    // file used to be `oversky-agent.ts`, and oclif names a command after its
+    // file, so help, `skrr commands` and `skrr usage` taught the retired spelling
+    // while every remedy taught this one, and each help page showed the name you
+    // typed as its own alias (OSK-9396). The old spelling stays reachable for
+    // scripts and muscle memory, and hidden, as the naming map records.
+    static hiddenAliases = ['code:oversky-agent'];
     static description = `Show or set the skrr agent a managed ${auth_core_1.FIRST_PARTY_HARNESS.displayName} session is attributed to`;
     static examples = [
         '<%= config.bin %> code skrr-agent',
@@ -68,7 +71,7 @@ class CodeOverskyAgent extends core_1.Command {
         json: core_1.Flags.boolean({ description: 'Emit the result as JSON' }),
     };
     async run() {
-        const { flags } = await this.parse(CodeOverskyAgent);
+        const { flags } = await this.parse(CodeSkrrAgent);
         // Every branch except `--clear` reads `/api/agents`, and this command extends
         // `Command` rather than `BaseCommand` — so nothing has resolved the stored
         // credential for `apiFetch` yet. Without this a signed-in user gets a bare
@@ -184,7 +187,7 @@ class CodeOverskyAgent extends core_1.Command {
         throw err;
     }
 }
-exports.default = CodeOverskyAgent;
+exports.default = CodeSkrrAgent;
 function summarize(agent) {
     return { id: agent.id, name: agent.name ?? null, source: agent.source };
 }

package/dist/commands/convos/messages.d.ts

@@ -1,4 +1,17 @@
 import { BaseCommand } from '../../base-command';
+/**
+ * The lines `skrr convos messages` prints for one message row.
+ *
+ * A failed turn used to print as its text and nothing else — usually empty,
+ * which reads as an agent that replied with whitespace, while `error: true` and
+ * the reason sat on the row being printed. It is now marked, and its reason is
+ * printed where the answer would be (OSK-9468). The reason is read through
+ * `resolveMessageFailure`, the one reader every surface shares; a legacy error
+ * row's text IS that reason, so only the answer is printed as the body.
+ */
+export declare function formatMessageLines(m: Record<string, unknown>, options?: {
+    metadata?: boolean;
+}): string[];
 /**
  * `skrr convos messages` — read a conversation's transcript.
  *

package/dist/commands/convos/messages.js

@@ -1,9 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMessageLines = formatMessageLines;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const message_content_1 = require("../../lib/message-content");
+/**
+ * The lines `skrr convos messages` prints for one message row.
+ *
+ * A failed turn used to print as its text and nothing else — usually empty,
+ * which reads as an agent that replied with whitespace, while `error: true` and
+ * the reason sat on the row being printed. It is now marked, and its reason is
+ * printed where the answer would be (OSK-9468). The reason is read through
+ * `resolveMessageFailure`, the one reader every surface shares; a legacy error
+ * row's text IS that reason, so only the answer is printed as the body.
+ */
+function formatMessageLines(m, options = {}) {
+    const who = m.isCreatedByUser ? 'user' : String(m.sender ?? 'assistant');
+    const when = m.createdAt ? new Date(String(m.createdAt)).toISOString() : '';
+    const failure = (0, data_provider_1.resolveMessageFailure)(m);
+    // Render each assistant text part as its own block so a tool-paused turn
+    // reads as separate paragraphs instead of one glued run-on line
+    // (OSK-4911). Whitespace is collapsed WITHIN a block for compactness; the
+    // blank line BETWEEN blocks is what the flattened `text` field dropped.
+    const body = (0, message_content_1.messageTextBlocks)(failure ? { ...m, text: failure.answer } : m)
+        .map((block) => block.replace(/\s+/g, ' ').trim())
+        .join('\n\n');
+    const clipped = body.length > 300 ? `${body.slice(0, 300)}…` : body;
+    const lines = [`${when}  ${who}${failure ? '  [failed]' : ''}`];
+    if (clipped || !failure) {
+        for (const line of clipped.split('\n')) {
+            lines.push(`  ${line}`);
+        }
+    }
+    if (failure) {
+        const reason = failure.reason?.replace(/\s+/g, ' ').trim();
+        lines.push(`  failed: ${reason || 'no reason was recorded on the message'}`);
+    }
+    if (options.metadata && m.metadata && Object.keys(m.metadata).length > 0) {
+        lines.push(`  metadata: ${JSON.stringify(m.metadata)}`);
+    }
+    return lines;
+}
 /**
  * `skrr convos messages` — read a conversation's transcript.
  *
@@ -70,22 +108,8 @@ class ConvosMessages extends base_command_1.BaseCommand {
             return;
         }
         for (const m of messages) {
-            const who = m.isCreatedByUser ? 'user' : String(m.sender ?? 'assistant');
-            const when = m.createdAt ? new Date(String(m.createdAt)).toISOString() : '';
-            // Render each assistant text part as its own block so a tool-paused turn
-            // reads as separate paragraphs instead of one glued run-on line
-            // (OSK-4911). Whitespace is collapsed WITHIN a block for compactness; the
-            // blank line BETWEEN blocks is what the flattened `text` field dropped.
-            const body = (0, message_content_1.messageTextBlocks)(m)
-                .map((block) => block.replace(/\s+/g, ' ').trim())
-                .join('\n\n');
-            const clipped = body.length > 300 ? `${body.slice(0, 300)}…` : body;
-            this.log(`${when}  ${who}`);
-            for (const line of clipped.split('\n')) {
-                this.log(`  ${line}`);
-            }
-            if (flags.metadata && m.metadata && Object.keys(m.metadata).length > 0) {
-                this.log(`  metadata: ${JSON.stringify(m.metadata)}`);
+            for (const line of formatMessageLines(m, { metadata: flags.metadata })) {
+                this.log(line);
             }
         }
         this.log(`\n${messages.length} message(s)`);

package/dist/commands/daemon/index.js

@@ -13,7 +13,14 @@ class Daemon extends core_1.Command {
     // "Wraps the `skrrd` binary" read, cold, as though you must already HAVE one —
     // the opposite of what `skrr daemon install` does now that it fetches the
     // signed release. Dogfooding 0.1.12 hit exactly that reading.
-    static description = 'Manage the local skrr runtime — install it, sign it in, and check on it.';
+    // "runtime" names two unrelated things in this product: the background
+    // service on the computer you are typing on, and a rented Linux VM (every
+    // Dedicated Runtime's daemon id is `dedicated-runtime-rtl_…`). This topic is
+    // always the first. A dogfood note put the cost precisely: when `daemon
+    // status` warned about an update, the reader had to stop and work out whether
+    // it meant their laptop or one of their VMs. Naming the computer removes the
+    // hesitation without renaming a domain.
+    static description = 'Manage the skrr background service on THIS computer — install it, sign it in, and check on it. A rented Linux VM is a machine, not this: see `skrr machines`.';
     static examples = [
         '<%= config.bin %> daemon install',
         '<%= config.bin %> daemon status',

package/dist/commands/daemon/logs.d.ts

@@ -24,6 +24,32 @@ export interface DaemonLogsFlags {
  * constrained to the same profile grammar instead of trusting a lock file as
  * an arbitrary path component.
  */
+/**
+ * How old the log is, said out loud before any of it is printed.
+ *
+ * A log file is the one surface whose CONTENT looks equally plausible whether
+ * it is live or nine days dead — every line is well-formed and timestamped, and
+ * the timestamps are only wrong if you happen to read them. Observed on this
+ * machine: a daemon running since 06:20 today, launched with
+ * `--log-file ~/Library/Logs/OverSky/daemon.app.log` whose parent directory did
+ * not exist, so it wrote nothing; `skrr daemon logs` then served
+ * `~/.skrr/profiles/default/logs/daemon.log`, last written nine days earlier,
+ * with no marker. The top line read `[2026-09-08 02:55:24]` and nothing said
+ * that was not today.
+ *
+ * The daemon's own logger now creates its directory and reports a failed open
+ * (its comment cites OSK-7737/OSK-7699), and `daemon status` learned to say the
+ * file predates the running daemon. `daemon logs` — the command you actually
+ * reach for — never did.
+ *
+ * Stated as a FACT first and a warning second: the age is always printed, so a
+ * fresh log confirms itself, and no threshold has to be right for the reader to
+ * be correctly informed. The warning only adds a next step.
+ */
+export declare function describeLogAge(mtimeMs: number, now?: number): {
+    line: string;
+    stale: boolean;
+};
 export declare function resolveLegacyDaemonLogPath(flags: Pick<DaemonLogsFlags, 'stderr'>, options?: {
     home?: string;
     env?: NodeJS.ProcessEnv;

package/dist/commands/daemon/logs.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeLogAge = describeLogAge;
 exports.resolveLegacyDaemonLogPath = resolveLegacyDaemonLogPath;
 exports.readDaemonLogTail = readDaemonLogTail;
 exports.buildOverskyLogsArgs = buildOverskyLogsArgs;
@@ -19,6 +20,47 @@ const PROFILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
  * constrained to the same profile grammar instead of trusting a lock file as
  * an arbitrary path component.
  */
+/**
+ * How old the log is, said out loud before any of it is printed.
+ *
+ * A log file is the one surface whose CONTENT looks equally plausible whether
+ * it is live or nine days dead — every line is well-formed and timestamped, and
+ * the timestamps are only wrong if you happen to read them. Observed on this
+ * machine: a daemon running since 06:20 today, launched with
+ * `--log-file ~/Library/Logs/OverSky/daemon.app.log` whose parent directory did
+ * not exist, so it wrote nothing; `skrr daemon logs` then served
+ * `~/.skrr/profiles/default/logs/daemon.log`, last written nine days earlier,
+ * with no marker. The top line read `[2026-09-08 02:55:24]` and nothing said
+ * that was not today.
+ *
+ * The daemon's own logger now creates its directory and reports a failed open
+ * (its comment cites OSK-7737/OSK-7699), and `daemon status` learned to say the
+ * file predates the running daemon. `daemon logs` — the command you actually
+ * reach for — never did.
+ *
+ * Stated as a FACT first and a warning second: the age is always printed, so a
+ * fresh log confirms itself, and no threshold has to be right for the reader to
+ * be correctly informed. The warning only adds a next step.
+ */
+function describeLogAge(mtimeMs, now = Date.now()) {
+    const ageMs = Math.max(0, now - mtimeMs);
+    const minutes = Math.floor(ageMs / 60_000);
+    const human = minutes < 1
+        ? 'less than a minute ago'
+        : minutes < 60
+            ? `${minutes} minute${minutes === 1 ? '' : 's'} ago`
+            : minutes < 60 * 24
+                ? `${Math.floor(minutes / 60)} hour${Math.floor(minutes / 60) === 1 ? '' : 's'} ago`
+                : `${Math.floor(minutes / (60 * 24))} day${Math.floor(minutes / (60 * 24)) === 1 ? '' : 's'} ago`;
+    const stamp = new Date(mtimeMs).toISOString().slice(0, 19).replace('T', ' ');
+    const stale = ageMs > 60 * 60_000;
+    return {
+        line: stale
+            ? `Log last written ${stamp}Z — ${human}. If your daemon is running it is not writing here; check \`skrr daemon status\` for the path it was started with.`
+            : `Log last written ${stamp}Z — ${human}.`,
+        stale,
+    };
+}
 function resolveLegacyDaemonLogPath(flags, options = {}) {
     const home = options.home ?? (0, node_os_1.homedir)();
     const env = options.env ?? process.env;
@@ -118,6 +160,20 @@ class DaemonLogs extends core_1.Command {
     async run() {
         const { flags } = await this.parse(DaemonLogs);
         const args = buildOverskyLogsArgs(flags);
+        // Before ANY log content, on stderr so it never pollutes a pipe. `--path`
+        // is exempt: its whole contract is one path on stdout.
+        if (!flags.path) {
+            try {
+                const candidate = resolveLegacyDaemonLogPath(flags);
+                if ((0, node_fs_1.existsSync)(candidate)) {
+                    const { line } = describeLogAge((0, node_fs_1.statSync)(candidate).mtimeMs);
+                    this.logToStderr(line);
+                }
+            }
+            catch {
+                // Never let the banner stop the logs from being shown.
+            }
+        }
         try {
             // `oversky 0.2.x` has profiles and writes the same files, but has no
             // `logs` subcommand. Probe top-level help first so forwarding does not

package/dist/commands/daemon/uninstall.js

@@ -19,7 +19,7 @@ class DaemonUninstall extends core_1.Command {
     // whole topic, and without a per-command alias only the bare topic
     // resolved: every subcommand under it failed.
     static aliases = ['daemons:uninstall'];
-    static summary = "Remove the local skrr runtime's background service (local state is left alone)";
+    static summary = 'Remove the skrr background service from THIS computer (local state is left alone; a rented VM is a machine, see `skrr machines`)';
     static description = (0, exec_runtime_binary_1.forwardedFlagsNote)('uninstall');
     static strict = false; // forward all args verbatim — see run()
     async run() {

package/dist/commands/followups/act.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr followups act` — an `act` follow-up: a typed built-in action at a
+ * time, for an action already exactly known and already agreed to.
+ */
+export default class FollowupsAct extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        subject: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        why: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        action: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        at: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        in: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        endpoint: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'endpoint-target': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        pin: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/followups/act.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const followups_1 = require("../../lib/followups");
+const agent_resolver_1 = require("../../lib/agent-resolver");
+const triggers_1 = require("../../lib/triggers");
+/**
+ * `skrr followups act` — an `act` follow-up: a typed built-in action at a
+ * time, for an action already exactly known and already agreed to.
+ */
+class FollowupsAct extends base_command_1.BaseCommand {
+    static description = 'Run an agreed action at a time — the act follow-up';
+    static examples = [
+        '<%= config.bin %> followups act --subject task:OSK-42 --why "user approved the merge" --action \'{"builtinType":"task_mark_done","config":{"taskId":"OSK-42"}}\' --at 2026-09-20T09:00:00Z',
+    ];
+    static flags = {
+        subject: core_1.Flags.string({ description: 'Subject ref: type:externalKey', required: true }),
+        why: core_1.Flags.string({ description: 'Why this wake exists, in one line', required: true }),
+        action: core_1.Flags.string({
+            description: `Action payload JSON: {"builtinType": "...", "config": {...}, "refId?": "..."}. builtinType is one of: ${data_provider_1.BUILTIN_ACTION_TYPES.join(', ')}`,
+            required: true,
+        }),
+        at: core_1.Flags.string({ description: 'ISO-8601 instant to act at', exclusive: ['in'] }),
+        in: core_1.Flags.string({ description: 'Duration from now (2h, 3d)', exclusive: ['at'] }),
+        agent: core_1.Flags.string({ description: 'Agent ID (default: bound session agent)' }),
+        endpoint: core_1.Flags.string({ description: 'Delivery endpoint id (EndpointRegistry)' }),
+        'endpoint-target': core_1.Flags.string({ description: 'Channel target for channel endpoints' }),
+        pin: core_1.Flags.string({ description: 'Conversation id the act was authored in' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(FollowupsAct);
+        const at = flags.at ?? flags.in;
+        if (!at) {
+            this.failWithCliError({
+                message: 'Either --at <iso> or --in <duration> is required.',
+                code: 'FOLLOWUP_KIND_FIELD_MISSING',
+                exit: 2,
+                retryable: false,
+            });
+        }
+        const action = (0, triggers_1.parseJsonObject)(flags.action, '--action');
+        if (typeof action?.builtinType !== 'string' || !action.builtinType) {
+            this.failWithCliError({
+                message: '--action needs a builtinType: {"builtinType": "...", "config": {...}}.',
+                code: 'FOLLOWUP_KIND_FIELD_MISSING',
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let agent;
+        try {
+            agent = (0, followups_1.resolveFollowUpAgent)(flags.agent);
+        }
+        catch (err) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(err);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+                details: { suggestion: failure.suggestion, context: failure.details },
+            });
+        }
+        let response;
+        try {
+            response = await followups_1.followupsApi.create({
+                kind: 'act',
+                producer: agent.boundToSession ? 'agent_in_turn' : 'user_explicit',
+                agentId: agent.id,
+                subject: (0, followups_1.parseSubjectRef)(flags.subject),
+                why: flags.why,
+                action,
+                at,
+                ...(flags.endpoint ? { endpointId: flags.endpoint } : {}),
+                ...(flags['endpoint-target'] ? { endpointTarget: flags['endpoint-target'] } : {}),
+                ...(flags.pin ? { pinnedConversationId: flags.pin } : {}),
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+            return;
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        const row = response.followup;
+        if (response.reused) {
+            this.log(`Already armed: ${row?.id} — the same act exists and was not duplicated.`);
+            return;
+        }
+        if (response.dropped) {
+            this.log('Dropped by the daily act budget — no act was armed.');
+            return;
+        }
+        this.log(`Act armed: ${row?.id} at ${row?.nextRunAt ?? at}.`);
+    }
+}
+exports.default = FollowupsAct;

package/dist/commands/followups/cancel.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr followups cancel <id>` — "never mind". It records exactly what
+ * `resolve --outcome abandoned` records (terminal `abandoned`, the reason as
+ * the note); it exists so calling one off does not require knowing the
+ * terminal vocabulary. Neither help text used to say so, and a user had to
+ * read the service to choose between them (OSK-9679).
+ */
+export default class FollowupsCancel extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        reason: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}