@skrr-ai/cli 0.1.131 → 0.1.133

package/dist/commands/agents/todos/list.js

@@ -21,14 +21,15 @@ class AgentsTodosList extends base_command_1.BaseCommand {
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
-        date: core_1.Flags.string({ description: 'Day to list (YYYY-MM-DD, UTC). Defaults to today.' }),
+        date: core_1.Flags.string({ description: 'Day to list (YYYY-MM-DD). Defaults to today in the selected timezone.' }),
+        timezone: core_1.Flags.string({ description: 'IANA timezone for the day (defaults to UTC)' }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(AgentsTodosList);
         let response;
         try {
-            response = await schedule_1.scheduleApi.listTodos(args.id, flags.date);
+            response = await schedule_1.scheduleApi.listTodos(args.id, flags.date, flags.timezone);
         }
         catch (err) {
             this.handleApiError(err);
@@ -37,6 +38,7 @@ class AgentsTodosList extends base_command_1.BaseCommand {
             this.printJsonResult((0, list_output_1.listResult)(response, 'todos'));
             return;
         }
+        this.log(`Day timezone: ${flags.timezone || 'UTC'}`);
         (0, schedule_1.renderTodoList)(response.todos ?? [], (line) => this.log(line));
     }
 }

package/dist/commands/agents/triggers/fire.d.ts

@@ -2,8 +2,7 @@ import { BaseCommand } from '../../../base-command';
 /**
  * `skrr agents triggers fire <agent-id> <trigger-id>` — fire a trigger now.
  * Mirrors the Schedule Board's "Run" button (`POST /api/triggers/:id/fire-now`).
- * The fire respects the same gates a scheduled fire would (quiet hours, caps,
- * concurrency) — the response `outcome` says whether it actually ran.
+ * The response distinguishes the manual fire from a scheduled-policy preview.
  */
 export default class AgentsTriggersFire extends BaseCommand {
     static description: string;
@@ -15,6 +14,7 @@ export default class AgentsTriggersFire extends BaseCommand {
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'from-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        strict: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/triggers/fire.js

@@ -7,8 +7,7 @@ const triggers_1 = require("../../../lib/triggers");
 /**
  * `skrr agents triggers fire <agent-id> <trigger-id>` — fire a trigger now.
  * Mirrors the Schedule Board's "Run" button (`POST /api/triggers/:id/fire-now`).
- * The fire respects the same gates a scheduled fire would (quiet hours, caps,
- * concurrency) — the response `outcome` says whether it actually ran.
+ * The response distinguishes the manual fire from a scheduled-policy preview.
  */
 class AgentsTriggersFire extends base_command_1.BaseCommand {
     static description = "Fire one of an agent's triggers immediately";
@@ -25,6 +24,11 @@ class AgentsTriggersFire extends base_command_1.BaseCommand {
         'from-json': core_1.Flags.string({
             description: 'Path to a JSON file (or "-" for stdin) to use as fire options',
         }),
+        strict: core_1.Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Exit nonzero if the fire was not accepted; use --no-strict for transport-only success',
+        }),
     };
     async run() {
         this.requireAuth();
@@ -46,13 +50,26 @@ class AgentsTriggersFire extends base_command_1.BaseCommand {
                 this.error(err.message, { exit: 4 });
             this.handleApiError(err);
         }
+        const refused = flags.strict && !(0, triggers_1.fireWasAccepted)(result);
+        const refusal = refused ? (0, triggers_1.describeStrictFireRefusal)(result) : null;
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.log(JSON.stringify(refused ? { ...result, ok: false, strictRefusal: refusal } : result, null, 2));
+            if (refusal) {
+                process.stderr.write(`${refusal}\n`);
+                this.exit(1);
+            }
             return;
         }
         this.log(`Fire requested: outcome=${String(result.outcome ?? '-')} reason=${String(result.reason ?? '-')}`);
         for (const line of (0, triggers_1.describeFireDetail)(result))
             this.log(line);
+        const note = (0, triggers_1.describeScheduledFire)(result);
+        if (note)
+            this.log(note);
+        if (refusal) {
+            process.stderr.write(`${refusal}\n`);
+            this.exit(1);
+        }
     }
 }
 exports.default = AgentsTriggersFire;

package/dist/commands/agents/triggers/policy.d.ts

@@ -1,4 +1,9 @@
 import { BaseCommand } from '../../../base-command';
+/**
+ * `3` → 3, `0` → 0 (new lookback plans blocked), `default` → null (clears it). The server validates
+ * the range again; refusing a bad value here names the flag instead of a schema issue list.
+ */
+export declare function parseLookbackPlansPerDay(raw: string | undefined): number | null | undefined;
 export default class AgentsTriggersPolicy extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -16,6 +21,7 @@ export default class AgentsTriggersPolicy extends BaseCommand {
         'working-hours': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'quiet-hours': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'followup-budget': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'lookback-plans-per-day': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/triggers/policy.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseLookbackPlansPerDay = parseLookbackPlansPerDay;
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const prompt_1 = require("../../../lib/prompt");
@@ -30,6 +31,21 @@ function parseFollowUpBudget(values) {
     }
     return budget;
 }
+/**
+ * `3` → 3, `0` → 0 (new lookback plans blocked), `default` → null (clears it). The server validates
+ * the range again; refusing a bad value here names the flag instead of a schema issue list.
+ */
+function parseLookbackPlansPerDay(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === 'default')
+        return null;
+    const count = Number(raw);
+    if (raw.trim() === '' || !Number.isInteger(count) || count < 0 || count > 1000) {
+        throw new Error('--lookback-plans-per-day must be an integer from 0 to 1000, or "default"');
+    }
+    return count;
+}
 class AgentsTriggersPolicy extends base_command_1.BaseCommand {
     static description = "Show or update an agent's initiative policy for agent-scoped triggers";
     static examples = [
@@ -66,6 +82,9 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
             description: 'Daily follow-up creation cap for this agent, as pool=count (pools: watch, checkin, act; count "default" clears it). Repeatable',
             multiple: true,
         }),
+        'lookback-plans-per-day': core_1.Flags.string({
+            description: 'Daily lookback plan allowance for this agent: an integer from 0 to 1000 (0 blocks new plans) or "default" to clear it. `followups plans capacity --agent <id>` reads what applies today',
+        }),
     };
     async run() {
         this.requireAuth();
@@ -81,6 +100,7 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
                 workingHours: (0, triggers_1.parseJsonObject)(flags['working-hours'], '--working-hours'),
                 quietHours: (0, triggers_1.parseJsonObject)(flags['quiet-hours'], '--quiet-hours'),
                 followUpBudget: parseFollowUpBudget(flags['followup-budget']),
+                lookbackPlansPerDay: parseLookbackPlansPerDay(flags['lookback-plans-per-day']),
             });
         }
         catch (err) {
@@ -111,6 +131,8 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
         this.log(`Follow-up caps:   ${budgetEntries.length > 0
             ? budgetEntries.map(([pool, cap]) => `${pool} ${String(cap)}/day`).join(', ')
             : 'defaults'}`);
+        const lookbackPlans = policy.lookbackPlansPerDay;
+        this.log(`Lookback plans:   ${typeof lookbackPlans === 'number' ? `${lookbackPlans}/day` : 'default'}`);
         if (Object.keys(counts).length > 0) {
             this.log(`Triggers:         ${String(counts.total ?? 0)} total, ${String(counts.enabled ?? 0)} enabled`);
         }

package/dist/commands/commitments/create.js

@@ -107,6 +107,19 @@ function assertEventDrivenWatchedSource(payload) {
         hasEventCapableWatchedSource(payload)) {
         return;
     }
+    const sources = Array.isArray(payload.watchedSources) ? payload.watchedSources : [];
+    const hasInvalidEvents = sources.some((value) => {
+        const source = record(value);
+        const config = record(source?.config);
+        return source?.enabled !== false && Array.isArray(config?.events) &&
+            !hasStructurallyValidExplicitEvent(config);
+    });
+    if (hasInvalidEvents) {
+        throw new Error('Event-driven cadence requires at least one event-capable watched source. ' +
+            'An explicit config.events list must contain event objects with non-empty entityType and eventType, ' +
+            'for example {"entityType":"github","eventType":"check_run_failed"}. ' +
+            'Supply valid bindings, or remove config.events to use the source defaults (which may include more events).');
+    }
     throw new Error('Event-driven cadence (--event-driven or --cadence-mode event_plus_interval) requires at least one event-capable watched source. ' +
         'Add --watch github (or another event-capable source), or choose an interval-only cadence.');
 }

package/dist/commands/daemon/install.js

@@ -56,6 +56,15 @@ class DaemonInstall extends core_1.Command {
         // own comment records `skrr code run -m <model>` dying the same way. Same
         // mistake, one directory over.
         const argv = this.argv;
+        // A forwarded help request is read-only. Do not run installation preflight,
+        // bind a profile, or download software just to show the runtime's options.
+        if (argv.some((arg) => arg === '--help' || arg === '-h')) {
+            if (!(0, exec_runtime_binary_1.isCurrentRuntimeBinary)((0, exec_runtime_binary_1.findRuntimeBinary)())) {
+                this.log('The background service is not installed, so its detailed install options are unavailable. Run `skrr daemon install` to install it.');
+                return;
+            }
+            this.exit(await (0, exec_runtime_binary_1.execRuntimeBinary)(['install', '--help']));
+        }
         // Before fetching anything: a machine still carrying the previous product
         // identity's state is refused by the runtime's own install, so downloading a
         // release first only delays the same refusal (OSK-6895).

package/dist/commands/goals/briefing/enable.js

@@ -28,8 +28,7 @@ class GoalsBriefingEnable extends base_command_1.BaseCommand {
             this.log(JSON.stringify(result, null, 2));
             return;
         }
-        const cron = flags.cron ?? '0 8 * * *';
-        this.log(`Morning briefing enabled (cron: ${cron})`);
+        this.log(`Morning briefing enabled (cron: ${result.cron})`);
     }
 }
 exports.default = GoalsBriefingEnable;

package/dist/commands/goals/briefing/status.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from '../../../base-command';
+export default class GoalsBriefingStatus extends BaseCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/briefing/status.js

@@ -0,0 +1,35 @@
+"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");
+class GoalsBriefingStatus extends base_command_1.BaseCommand {
+    static description = 'Show the morning briefing schedule and delivery preference';
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(GoalsBriefingStatus);
+        let status;
+        try {
+            status = await data_provider_1.dataService.getGoalBriefingStatus();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(status, null, 2));
+            return;
+        }
+        this.log(`Morning briefing: ${status.enabled ? 'enabled' : 'disabled'}`);
+        if (status.cron)
+            this.log(`Schedule: ${status.cron} (${status.timezone || 'timezone unknown'})`);
+        if (status.nextRunAt)
+            this.log(`Next run: ${status.nextRunAt}`);
+        this.log(`Delivery preference: ${status.delivery.categoryLevel}`);
+        if (status.delivery.preferenceEligibleChannels.length) {
+            this.log(`Preference-eligible channels: ${status.delivery.preferenceEligibleChannels.join(', ')}`);
+            this.log('Actual delivery also depends on connected destinations and other notification settings.');
+        }
+    }
+}
+exports.default = GoalsBriefingStatus;

package/dist/commands/memory/list.js

@@ -7,7 +7,7 @@ const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const memory_scope_1 = require("../../lib/memory-scope");
 class MemoryList extends base_command_1.BaseCommand {
-    static description = 'List memories in a pool (owner, an agent, user, or workspace)';
+    static description = 'List compatibility-pool memories (canonical topics are listed separately)';
     static examples = [
         '<%= config.bin %> memory list',
         '<%= config.bin %> memory list --json',
@@ -30,15 +30,21 @@ class MemoryList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
+        const canonicalHint = flags.agent
+            ? 'Canonical Agent Memory topics are separate. Run skrr memory topics list with the same --agent and --scope agent:<agent-id>.'
+            : 'This is a compatibility pool. Canonical Memory topics are listed separately with skrr memory topics list.';
         if (flags.json) {
-            this.printJsonResult((0, list_output_1.listResult)(response, 'memories'));
+            this.printJsonResult((0, list_output_1.listResult)({ ...response, memorySource: 'compatibility_pool', canonicalTopicsHint: canonicalHint }, 'memories'));
             return;
         }
         const memories = response.memories ?? [];
         if (memories.length === 0) {
-            this.log('No memories.');
+            this.log('No compatibility-pool memories.');
+            this.log(canonicalHint);
             return;
         }
+        this.log('Compatibility-pool memories:');
+        this.log(canonicalHint);
         const rows = memories.map((m) => ({
             key: m.key,
             value: m.value,

package/dist/generated/agent-guides.json

@@ -454,7 +454,7 @@
                         "id": "speaking",
                         "title": "A Commitment finds; its Agent speaks",
                         "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                        "tokens": 263,
+                        "tokens": 301,
                         "aliases": [],
                         "explains": []
                     },
@@ -709,7 +709,7 @@
                 ]
             }
         ],
-        "hash": "6d23de37b320e5257e7e2400c36bfc79063c76c2e3984771b96a90727e95980d",
+        "hash": "74f6b87c1bd1f851fbfe0b1ee5da04425d1b6fdafbf55445a39e121af9c4e65b",
         "tokens": 545
     },
     "routedIndex": {
@@ -1167,7 +1167,7 @@
                         "id": "speaking",
                         "title": "A Commitment finds; its Agent speaks",
                         "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                        "tokens": 263,
+                        "tokens": 301,
                         "aliases": [],
                         "explains": []
                     },
@@ -1353,7 +1353,7 @@
                 ]
             }
         ],
-        "hash": "c7cd104ee736aa524b486eb8858dce17a2de5f69036c7c61795ce5603ce1246e",
+        "hash": "6960740319e60127c5a1007fd32e77afada0b14442b5f6fb810a7fee1407cb63",
         "tokens": 494
     },
     "cards": {
@@ -1747,7 +1747,7 @@
             "routed": true,
             "aliases": [],
             "body": "## Concept model\n\n| Noun | Question it answers |\n| --- | --- |\n| **Compass** | What does good look like for this Agent, and what may it never trade away? |\n| **Northstar** | Which Commitments should exist, at what priority and on what budget? |\n| **Commitment** | Which outcome does this Agent keep true, and how does it keep checking? |\n| **Check** | What did one wake of a Commitment see, decide and do? |\n\nA Commitment is not a unit of work. A **Task** is one unit of work and a **Goal** is a dated\noutcome with key results; a Commitment watches both and may create Tasks, and is neither.\n\n## Decide\n\nFive mechanisms make something happen later, and the noun alone does not pick one:\n\n| Mechanism | What it is for | The signal that picks it |\n| --- | --- | --- |\n| **Follow-up** | Coming back to one thing, once or a bounded few times: a reminder, a watch, a check-in, an agreed action | The ask ends: \"look tomorrow\", \"tell me when CI is green\" |\n| **Trigger** | Running the Agent with a set prompt on a schedule, an event, once, or on demand | The person names when, and every run does the same work |\n| **Heartbeat** | Checking in on a conversation, group chat or Space at a frequency that backs off while unread | The person wants regular contact, not an outcome held |\n| **Commitment** | Keeping an outcome true: watched sources, a cadence and a loop that decides when to act | \"Keep X true\", \"watch this metric\": no end, and stale evidence matters |\n| **Workflow** | Running a durable graph of Tasks in order | Repeatable work whose steps depend on each other |\n\nA one-off \"look at it tomorrow\" is a follow-up, never a Commitment. Standing observation is a\nCommitment with a freshness contract, not a recurring trigger or a task board left running.\n\n## Workflow\n\n### Start a Commitment\n\n1. Read the Agent's Commitments first, and change one rather than add a near-duplicate.\n2. Create it and turn it on in one call: the outcome, what it watches, how often it checks, where\n   its work goes. Turning it on runs Preflight; a refusal keeps the draft and reports the code,\n   reason and fix.\n3. Leave it a draft only when the person asked to see it first.\n4. Read it back, and tell the person what it watches, how often, and whether it is on.\n\n## Authority\n\n| Actor | May do | Only a person may do |\n| --- | --- | --- |\n| Agent | Read the Commitments of an Agent it can view; create one, change it and turn it on; request a check; pause one; decide whether a finding is worth telling the owner | Lift a stop a person made; set or clear a concurrency limit; choose the Task review policy; approve an action proposal or a cadence change; configure a Northstar's governance or decide its intents |\n| Person | Everything in both columns | — |\n\nA Commitment grants no permission: its runs work under the Agent's own. A Check never writes an\nowner-facing message, and a Compass never creates, rewrites, pauses or archives a Commitment. The\nserver cannot always tell an Agent from the person whose login it holds, so an accepted call is\nnot permission: the right-hand column stays a person's.\n\n## Live state\n\n- `skrr commitments list --agent <agent-id>` — an Agent's Commitments, with status and assessment.\n- `skrr commitments show <commitment-id>` — the contract, its next check and the last one.\n- `skrr commitments roster --agent <agent-id>` — each loop: whether it is armed, its next wake, runs today.\n\n## Related guides\n\n- `tasks` — the Tasks a Commitment creates or watches.\n- `spaces` — Goals, and Workflows: durable graphs of Tasks.\n- `agents` — the Agent a Commitment belongs to, and where its runs execute.\n- `communication` — whether, what and how to tell the owner.",
-            "hash": "8a5ab2048ea5a6edacd881d4403a3481798876b4529f8a070d4953eebebd075f",
+            "hash": "197d9b84d1a4367ecf4b7a51687604d13814ec9e9265fe662883278a7738d2fa",
             "tokens": 1169,
             "sections": [
                 {
@@ -1824,7 +1824,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -5850,7 +5850,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -5966,7 +5966,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6084,7 +6084,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6206,7 +6206,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6322,7 +6322,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6438,7 +6438,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6560,7 +6560,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6598,9 +6598,9 @@
             "version": 4,
             "aliases": [],
             "explains": [],
-            "body": "Read this when a Commitment run found something and you must decide whether the owner hears of it.\n\nA Check never writes to the owner. When something it found may matter, the run is handed a brief\nunder \"Owner communication — your call.\": what was found, the evidence, why it may matter and a\nsuggested next step. Those are facts to judge, not a message to forward.\n\n- Decide with everything in view: what you already said, whether the owner replied, what another\n  surface already raised. One message, a different message or nothing are all valid outcomes, and\n  silence is often the right one.\n- To speak from the run, return a `message` or `status_update` action intent with its `text`, or a\n  `report` with its `text` for the Commitment's report destinations. Write the words yourself.\n- The owner's limits (mute, quiet hours, a daily nudge cap) decide whether a run is asked to speak\n  at all, and whatever you deliver counts against them, whichever way you send it.\n\n`skrr commitments reports <commitment-id>` lists where its reports go and on what condition; the\ndefault sends only on a material change.",
-            "hash": "f208f179f96c5f52058be9b4870b2591ef022e658745a7f3e44779bbde87ca10",
-            "tokens": 263,
+            "body": "Read this when a Commitment run found something and you must decide whether the owner hears of it.\n\nA Check never writes to the owner. When something it found may matter, the run is handed a brief\nunder \"Owner communication — your call.\": what was found, the evidence, why it may matter and a\nsuggested next step. Those are facts to judge, not a message to forward.\n\n- Decide with everything in view: what you already said, whether the owner replied, what another\n  surface already raised. One message, a different message or nothing are all valid outcomes, and\n  silence is often the right one.\n- To speak from the run, send it with `skrr agent message send` where the run allows it: it is\n  delivered under the owner's limits and counted for this Commitment. Otherwise return a\n  `status_update` or `report` action intent with its `text` for the Commitment's report\n  destinations. A `message` action intent is recorded but never delivered. Write the words yourself.\n- The owner's limits (mute, quiet hours, a daily nudge cap) decide whether a run is asked to speak\n  at all, and whatever you deliver counts against them, whichever way you send it.\n\n`skrr commitments reports <commitment-id>` lists where its reports go and on what condition; the\ndefault sends only on a material change.",
+            "hash": "45fa02a0344903cc355dff0b66eee45b14dab79a8f62fba8620106b29e11e8a9",
+            "tokens": 301,
             "sections": [
                 {
                     "id": "model",
@@ -6676,7 +6676,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6796,7 +6796,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },
@@ -6914,7 +6914,7 @@
                     "id": "speaking",
                     "title": "A Commitment finds; its Agent speaks",
                     "readWhen": "a Commitment run found something and you must decide whether the owner hears of it",
-                    "tokens": 263,
+                    "tokens": 301,
                     "aliases": [],
                     "explains": []
                 },

package/dist/lib/schedule.d.ts

@@ -19,6 +19,7 @@ export interface Todo {
     rationale?: string;
     confidence?: TodoConfidence;
     triggerId?: string;
+    updatedAt?: string;
     firedAt?: string;
     result?: {
         conversationId?: string;
@@ -68,6 +69,11 @@ export interface SmartScheduleProposal {
         truncated: boolean;
     };
     todos: ProposedTodo[];
+    nextRunSuggestion?: {
+        runAt: string;
+        reason?: string;
+        confidence?: number;
+    };
     /**
      * Agent-scope trigger budget at proposal time. Advisory — approval enforces
      * it for real — but it is the difference between a warning the user can act
@@ -105,6 +111,12 @@ export interface ApproveSmartScheduleResponse {
     }>;
     /** Post-write budget, so a caller approving several plans sees the wall coming. */
     capacity?: TriggerCapacity;
+    scheduledNextRun?: {
+        created?: boolean;
+        triggerId?: string;
+        skippedReason?: string;
+        message?: string;
+    } | null;
 }
 /**
  * The self-schedule TRACE — why the agent's day looks the way it does.
@@ -165,14 +177,20 @@ export declare const scheduleApi: {
         limit?: number;
         cursor?: string;
     }) => Promise<ScheduleTrace>;
-    listTodos: (agentId: string, date?: string) => Promise<ListTodosResponse>;
+    listTodos: (agentId: string, date?: string, timezone?: string) => Promise<ListTodosResponse>;
     getTodo: (todoId: string) => Promise<Todo>;
     createTodo: (input: CreateTodoInput) => Promise<Todo>;
+    updateTodo: (todoId: string, patch: {
+        name?: string;
+        runAt?: string;
+        expectedUpdatedAt?: string;
+    }) => Promise<Todo>;
     /** Cancel a To-Do (DELETE soft-cancels pending; see todos.js). */
     cancelTodo: (todoId: string) => Promise<Todo>;
     proposeSmartSchedule: (input: {
         agentId: string;
         workingHoursOverride?: WorkingHoursWindow;
+        timezone?: string;
         regenerateHint?: string;
     }) => Promise<SmartScheduleProposal>;
     pendingProposal: (agentId: string) => Promise<{
@@ -182,6 +200,7 @@ export declare const scheduleApi: {
         agentId: string;
         proposalId: string;
         todos: ApproveTodoInput[];
+        approveNextRunSuggestion?: boolean;
         saveHoursAsDefault?: boolean;
         workingHours?: WorkingHoursWindow;
     }) => Promise<ApproveSmartScheduleResponse>;

package/dist/lib/schedule.js

@@ -52,15 +52,16 @@ function scheduleTracePath(params) {
     });
 }
 /** Build the `/api/todos` list query — agentId is required, date optional. */
-function todoListPath(agentId, date) {
-    return (0, triggers_1.withQuery)('/api/todos', { agentId, date });
+function todoListPath(agentId, date, timezone) {
+    return (0, triggers_1.withQuery)('/api/todos', { agentId, date, timezone });
 }
 exports.scheduleApi = {
     /** The self-schedule trace for one agent-day. See `scheduleTracePath`. */
     scheduleTrace: (params) => data_provider_1.request.get(scheduleTracePath(params)),
-    listTodos: (agentId, date) => data_provider_1.request.get(todoListPath(agentId, date)),
+    listTodos: (agentId, date, timezone) => data_provider_1.request.get(todoListPath(agentId, date, timezone)),
     getTodo: (todoId) => data_provider_1.request.get(`/api/todos/${encodeURIComponent(todoId)}`),
     createTodo: (input) => data_provider_1.request.post('/api/todos', input),
+    updateTodo: (todoId, patch) => data_provider_1.request.patch(`/api/todos/${encodeURIComponent(todoId)}`, patch),
     /** Cancel a To-Do (DELETE soft-cancels pending; see todos.js). */
     cancelTodo: (todoId) => data_provider_1.request.delete(`/api/todos/${encodeURIComponent(todoId)}`),
     proposeSmartSchedule: (input) => data_provider_1.request.post('/api/todos/smart-schedule/propose', input),
@@ -162,6 +163,9 @@ function renderProposal(proposal, log) {
     if (proposal.expiresAt)
         log(`Expires:     ${formatStamp(proposal.expiresAt)}`);
     renderCapacityWarning(proposal.capacity, log);
+    if (proposal.nextRunSuggestion) {
+        log(`Next run:    ${formatStamp(proposal.nextRunSuggestion.runAt)}${proposal.nextRunSuggestion.reason ? ` · ${proposal.nextRunSuggestion.reason}` : ''}`);
+    }
     log('');
     const live = proposal.todos.filter((t) => !t.dropped);
     if (live.length === 0) {

package/dist/lib/scoped-memory-command.d.ts

@@ -82,6 +82,16 @@ export declare function parseMemoryApiError(error: ApiFetchError): {
     retryable: boolean;
     details?: Record<string, unknown>;
 };
+/** A gateway timeout can arrive after the canonical mutation committed. */
+export declare function uncertainMemoryMutationRecovery(path: string, options: ApiFetchOptions, status: number): {
+    message: string;
+    details: {
+        spaceId?: string | undefined;
+        outcome: string;
+        targetStoreId: string;
+        idempotencyKey: string;
+    };
+} | null;
 export declare abstract class ScopedMemoryCommand extends BaseCommand {
     protected endpoint(agentId: string, suffix?: string): string;
     protected memoryApi<T>(agentId: string, suffix: string, options?: ApiFetchOptions): Promise<T>;

package/dist/lib/scoped-memory-command.js

@@ -7,6 +7,7 @@ exports.memoryNotMountedDiagnostic = memoryNotMountedDiagnostic;
 exports.parseMemoryMount = parseMemoryMount;
 exports.parseMountedMemoryStore = parseMountedMemoryStore;
 exports.parseMemoryApiError = parseMemoryApiError;
+exports.uncertainMemoryMutationRecovery = uncertainMemoryMutationRecovery;
 const core_1 = require("@oclif/core");
 const node_crypto_1 = require("node:crypto");
 const base_command_1 = require("../base-command");
@@ -191,6 +192,23 @@ function parseMemoryApiError(error) {
         };
     }
 }
+/** A gateway timeout can arrive after the canonical mutation committed. */
+function uncertainMemoryMutationRecovery(path, options, status) {
+    if (status !== 504 || options.method !== 'POST' || !/\/mutations\/[^/?]+$/.test(path))
+        return null;
+    const body = options.body;
+    if (!body || body.dryRun === true || typeof body.idempotencyKey !== 'string' || typeof body.targetStoreId !== 'string')
+        return null;
+    return {
+        message: `The write may have been saved. Inspect the canonical Store with skrr memory topics list using the same --agent and --store ${body.targetStoreId}${body.spaceId ? ' and --space ' + body.spaceId : ''}. If retrying the identical operation, use --idempotency-key ${body.idempotencyKey}.`,
+        details: {
+            outcome: 'unknown',
+            targetStoreId: body.targetStoreId,
+            idempotencyKey: body.idempotencyKey,
+            ...(typeof body.spaceId === 'string' ? { spaceId: body.spaceId } : {}),
+        },
+    };
+}
 class ScopedMemoryCommand extends base_command_1.BaseCommand {
     endpoint(agentId, suffix = '') {
         return `/api/agents/${encodeURIComponent(agentId)}/memories/workspace${suffix}`;
@@ -229,13 +247,14 @@ class ScopedMemoryCommand extends base_command_1.BaseCommand {
         catch (error) {
             if (error instanceof api_fetch_1.ApiFetchError) {
                 const parsed = parseMemoryApiError(error);
+                const recovery = uncertainMemoryMutationRecovery(path, options, error.status);
                 this.failWithCliError({
-                    message: `${parsed.code}: ${parsed.message}`,
+                    message: `${parsed.code}: ${parsed.message}${recovery ? ` ${recovery.message}` : ''}`,
                     code: parsed.code,
                     status: error.status,
                     exit: ERROR_EXITS[parsed.code] || (error.status === 404 ? 4 : error.status === 403 ? 5 : 2),
                     retryable: parsed.retryable,
-                    details: parsed.details,
+                    details: recovery ? { ...parsed.details, ...recovery.details } : parsed.details,
                 });
             }
             this.handleApiError(error);