@wirecat/cli-core 0.559.0 → 0.561.0

package/dist/cli/messenger/message-writes.d.ts

@@ -232,6 +232,9 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
             bulk?: boolean | undefined;
             list_id?: string | null | undefined;
             rule_id?: number | null | undefined;
+            fingerprint?: string | undefined;
+            new_sender?: boolean | undefined;
+            sender_identities?: number | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;
@@ -454,6 +457,9 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
             bulk?: boolean | undefined;
             list_id?: string | null | undefined;
             rule_id?: number | null | undefined;
+            fingerprint?: string | undefined;
+            new_sender?: boolean | undefined;
+            sender_identities?: number | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;

package/dist/cli/schedule/schedule-command.d.ts

@@ -9,10 +9,15 @@ export interface ScheduleHost {
         env: NodeJS.ProcessEnv;
         profile: string;
     };
+    /**
+     * Whether mail is stored past the holder's mark (`holderHasMail`). Given, `schedule agent` takes `--on-new-mail`:
+     * the agent then runs only after a sync stored mail it has not processed.
+     */
+    newMail?: (command: Command, holder: string) => Promise<boolean>;
 }
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
  * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
  * the rest, so what runs and with which variables is the same on all three.
  */
-export declare const scheduleCommandFor: ({ app, context: contextOf }: ScheduleHost) => Command;
+export declare const scheduleCommandFor: ({ app, context: contextOf, newMail }: ScheduleHost) => Command;

package/dist/cli/schedule/schedule-command.js

@@ -7,6 +7,7 @@ import { describeWhen, findProgram, lastRun, listSchedules, readSchedule, runSch
 import { thisMachine } from "../../background/system.js";
 import { locationVariables } from "../../background/units.js";
 import { parseDuration } from "../../domain/duration.js";
+import { HOLDER } from "../../mail/marks.js";
 import { readOnlyLockOf } from "../../ports/app.js";
 import { aheadOf } from "../../services/moment.js";
 import { storePath } from "../../store/path.js";
@@ -18,6 +19,8 @@ import { SCHEDULES_QUERY, scheduleFilter } from "../messenger/list-result-querie
 import { lineOf } from "../steps.js";
 /** Each run of an agent is a paid model call that reads chats; keeping the store current is `serve`'s job. */
 const AGENT_MINIMUM_MINUTES = 60;
+/** A run gated on new mail costs a store read when nothing came, so it may check as often as mail syncs. */
+const GATED_AGENT_MINIMUM_MINUTES = 5;
 const COMMAND_MINIMUM_MINUTES = 1;
 const HARNESSES = ["claude", "codex"];
 const whenOf = ({ every, at, atTime }, minimum) => {
@@ -78,7 +81,7 @@ const promptExample = (app) => app.messenger === false
  * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
  * the rest, so what runs and with which variables is the same on all three.
  */
-export const scheduleCommandFor = ({ app, context: contextOf }) => {
+export const scheduleCommandFor = ({ app, context: contextOf, newMail }) => {
     const command = new Command("schedule").description(`run a ${app.command} command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send`);
     const prepare = (self, resolving = {}) => {
         const context = contextOf(self, resolving);
@@ -114,6 +117,13 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         };
         return { context, system, state, say, timer, environment, save };
     };
+    /** A schedule gated on new mail waits while nothing is stored past its holder's mark. */
+    const waits = async (self, file) => {
+        const holder = existsSync(file) ? readSchedule(file).onNewMail : undefined;
+        if (holder === undefined || !newMail || (await newMail(self, holder)))
+            return undefined;
+        return holder;
+    };
     withWhen(grantsAuthority(annotate(command.command("command"), {
         literal_after_dashes: true,
         effects: LOCAL_WRITE,
@@ -151,6 +161,8 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         .addOption(new Option("--max-cost <usd>", "claude only: stop a run that costs more than this, in US dollars").argParser(Number))).action(async function (name, harness, prompt) {
         const { context, system, environment, save } = prepare(this);
         const options = this.opts();
+        if (options.onNewMail !== undefined && !HOLDER.test(options.onNewMail))
+            throw new CliError("validation_error", `--on-new-mail takes a holder: lower-case letters, digits and dashes`);
         const program = findProgram(harness, context.env, system.platform);
         if (!program)
             throw new CliError("not_found", `${harness} is not on PATH`);
@@ -188,11 +200,16 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
             name: scheduleName(name),
             kind: "agent",
             argv,
-            when: whenOf(options, AGENT_MINIMUM_MINUTES),
+            when: whenOf(options, options.onNewMail ? GATED_AGENT_MINIMUM_MINUTES : AGENT_MINIMUM_MINUTES),
             environment: environment(),
             createdAt: new Date().toISOString(),
+            ...(options.onNewMail ? { onNewMail: options.onNewMail } : {}),
         });
     });
+    if (newMail)
+        command.commands
+            .find((one) => one.name() === "agent")
+            ?.option("--on-new-mail <holder>", `run only when mail is stored past this holder's mark — after a sync brought new mail; may check every ${GATED_AGENT_MINIMUM_MINUTES}m`);
     withQuery(annotate(command.command("list"), {
         effects: LOCAL_READ,
         examples: [`${app.command} personal schedule list`, `${app.command} personal schedule list kind:agent`],
@@ -241,6 +258,9 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         .argument("<name>", "the schedule's name, as `schedule list` shows it")
         .action(async function (name) {
         const { context, system, state, say, timer } = prepare(this);
+        const holder = await waits(this, scheduleFile(state, scheduleName(name)));
+        if (holder !== undefined)
+            return say({ name, skipped: true, holder }, [`${name}: skipped — no mail stored past ${holder}'s mark`]);
         const last = await untilChildEnds(this, (signal) => runSchedule(app, system, context.env, scheduleFile(state, scheduleName(name)), {
             timer: timer(),
             ...(signal ? { signal } : {}),
@@ -273,6 +293,8 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         .action(async function (file) {
         // A timer starts it with no profile named; the schedule's own environment carries the profile.
         const { context, system, timer } = prepare(this, { needsProfile: false });
+        if ((await waits(this, file)) !== undefined)
+            return;
         const last = await untilChildEnds(this, (signal) => runSchedule(app, system, context.env, file, {
             timer: timer(),
             untilUnlocked: true,

package/dist/entities/contact-context.d.ts

@@ -349,6 +349,9 @@ export declare const contactMessages: v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
                 readonly reply_to: v.ArraySchema<v.StrictObjectSchema<{
                     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly address: v.StringSchema<undefined>;
@@ -1124,6 +1127,9 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
                 readonly reply_to: v.ArraySchema<v.StrictObjectSchema<{
                     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly address: v.StringSchema<undefined>;

package/dist/entities/conversation-results.d.ts

@@ -227,6 +227,9 @@ export declare const conversationDetails: v.UnionSchema<[v.StrictObjectSchema<{
             readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, undefined>;
@@ -447,6 +450,9 @@ export declare const conversationDetails: v.UnionSchema<[v.StrictObjectSchema<{
         readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>, undefined>;
     readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
 }, undefined>], undefined>;

package/dist/entities/evidence.d.ts

@@ -218,6 +218,9 @@ export declare const contribution: v.StrictObjectSchema<{
             readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -438,6 +441,9 @@ export declare const contribution: v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -696,6 +702,9 @@ export declare const contribution: v.StrictObjectSchema<{
             readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -916,6 +925,9 @@ export declare const contribution: v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -1210,6 +1222,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -1430,6 +1445,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -1688,6 +1706,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+            readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -1908,6 +1929,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
                 readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+                readonly fingerprint: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+                readonly new_sender: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly sender_identities: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;