@namzu/sdk 45.0.0 → 45.1.0

package/dist/schedules/tz.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Time-zone arithmetic over `Intl` alone.
+ *
+ * The SDK carries no time-zone database of its own: the runtime's ICU data is
+ * the source, read through `Intl.DateTimeFormat#formatToParts`. Everything in
+ * this file is expressed in "wall" milliseconds — a local date and time
+ * written as if it were UTC (`Date.UTC(y, m - 1, d, h, min)`) — so local
+ * arithmetic is plain integer arithmetic and only the conversions touch Intl.
+ */
+/**
+ * Throw unless `tz` is an IANA zone this runtime knows. Returns the zone as
+ * the runtime spells it (`europe/istanbul` → `Europe/Istanbul`).
+ */
+export declare function validateTimeZone(tz: string): string;
+/** The zone this host is in, as the runtime reports it. */
+export declare function hostTimeZone(): string;
+/** The wall clock of `instant` in `tz`, as wall milliseconds (seconds dropped). */
+export declare function wallOf(instant: number, tz: string): number;
+/** `tz`'s offset from UTC at `instant`, in milliseconds, minute precision. */
+export declare function offsetAt(instant: number, tz: string): number;
+/**
+ * Every instant whose wall clock in `tz` reads `wall`.
+ *
+ * One instant normally, two in the hour a fall-back repeats (earliest first),
+ * none in the hour a spring-forward skips.
+ */
+export declare function instantsForWall(wall: number, tz: string): number[];
+/**
+ * The first instant whose wall clock is later than `wall`, for a `wall` that
+ * falls inside a spring-forward gap: the moment the clocks jumped.
+ */
+export declare function firstInstantAfterGap(wall: number, tz: string): number;
+/** Civil date parts of a wall value. */
+export declare function civil(wall: number): {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    weekday: number;
+};
+/** `YYYY-MM-DD HH:MM` for an instant in `tz`. */
+export declare function formatWall(instant: number, tz: string): string;
+//# sourceMappingURL=tz.d.ts.map

package/dist/schedules/tz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tz.d.ts","sourceRoot":"","sources":["../../src/schedules/tz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAYrE;AAED,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf,CAUA;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/schedules/tz.js

@@ -0,0 +1,141 @@
+/**
+ * Time-zone arithmetic over `Intl` alone.
+ *
+ * The SDK carries no time-zone database of its own: the runtime's ICU data is
+ * the source, read through `Intl.DateTimeFormat#formatToParts`. Everything in
+ * this file is expressed in "wall" milliseconds — a local date and time
+ * written as if it were UTC (`Date.UTC(y, m - 1, d, h, min)`) — so local
+ * arithmetic is plain integer arithmetic and only the conversions touch Intl.
+ */
+import { ScheduleValidationError } from './errors.js';
+const MINUTE = 60_000;
+const HOUR = 60 * MINUTE;
+const formatters = new Map();
+function formatterFor(tz) {
+    let f = formatters.get(tz);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone: tz,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: 'numeric',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: 'numeric',
+            second: 'numeric',
+        });
+        formatters.set(tz, f);
+    }
+    return f;
+}
+/**
+ * Throw unless `tz` is an IANA zone this runtime knows. Returns the zone as
+ * the runtime spells it (`europe/istanbul` → `Europe/Istanbul`).
+ */
+export function validateTimeZone(tz) {
+    if (typeof tz !== 'string' || tz.trim() === '') {
+        throw new ScheduleValidationError('a time zone is required', String(tz));
+    }
+    try {
+        return new Intl.DateTimeFormat('en-US', { timeZone: tz.trim() }).resolvedOptions().timeZone;
+    }
+    catch {
+        throw new ScheduleValidationError(`unknown time zone "${tz}"`, tz);
+    }
+}
+/** The zone this host is in, as the runtime reports it. */
+export function hostTimeZone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+}
+/** The wall clock of `instant` in `tz`, as wall milliseconds (seconds dropped). */
+export function wallOf(instant, tz) {
+    const parts = formatterFor(tz).formatToParts(new Date(instant));
+    let year = 0;
+    let month = 1;
+    let day = 1;
+    let hour = 0;
+    let minute = 0;
+    for (const part of parts) {
+        switch (part.type) {
+            case 'year':
+                year = Number(part.value);
+                break;
+            case 'month':
+                month = Number(part.value);
+                break;
+            case 'day':
+                day = Number(part.value);
+                break;
+            case 'hour':
+                hour = Number(part.value) % 24;
+                break;
+            case 'minute':
+                minute = Number(part.value);
+                break;
+        }
+    }
+    return Date.UTC(year, month - 1, day, hour, minute);
+}
+/** `tz`'s offset from UTC at `instant`, in milliseconds, minute precision. */
+export function offsetAt(instant, tz) {
+    const floored = Math.floor(instant / MINUTE) * MINUTE;
+    return wallOf(floored, tz) - floored;
+}
+/**
+ * Every instant whose wall clock in `tz` reads `wall`.
+ *
+ * One instant normally, two in the hour a fall-back repeats (earliest first),
+ * none in the hour a spring-forward skips.
+ */
+export function instantsForWall(wall, tz) {
+    const offsets = new Set([
+        offsetAt(wall - 26 * HOUR, tz),
+        offsetAt(wall, tz),
+        offsetAt(wall + 26 * HOUR, tz),
+    ]);
+    const found = new Set();
+    for (const offset of offsets) {
+        const candidate = wall - offset;
+        if (wallOf(candidate, tz) === wall)
+            found.add(candidate);
+    }
+    return [...found].sort((a, b) => a - b);
+}
+/**
+ * The first instant whose wall clock is later than `wall`, for a `wall` that
+ * falls inside a spring-forward gap: the moment the clocks jumped.
+ */
+export function firstInstantAfterGap(wall, tz) {
+    const a = offsetAt(wall - 26 * HOUR, tz);
+    const b = offsetAt(wall + 26 * HOUR, tz);
+    let lo = Math.floor((wall - Math.max(a, b)) / MINUTE);
+    let hi = Math.ceil((wall - Math.min(a, b)) / MINUTE);
+    // Smallest minute m in [lo, hi] with wallOf(m) > wall.
+    while (lo < hi) {
+        const mid = Math.floor((lo + hi) / 2);
+        if (wallOf(mid * MINUTE, tz) > wall)
+            hi = mid;
+        else
+            lo = mid + 1;
+    }
+    return lo * MINUTE;
+}
+/** Civil date parts of a wall value. */
+export function civil(wall) {
+    const d = new Date(wall);
+    return {
+        year: d.getUTCFullYear(),
+        month: d.getUTCMonth() + 1,
+        day: d.getUTCDate(),
+        hour: d.getUTCHours(),
+        minute: d.getUTCMinutes(),
+        weekday: d.getUTCDay(),
+    };
+}
+/** `YYYY-MM-DD HH:MM` for an instant in `tz`. */
+export function formatWall(instant, tz) {
+    const c = civil(wallOf(instant, tz));
+    const p = (n) => String(n).padStart(2, '0');
+    return `${c.year}-${p(c.month)}-${p(c.day)} ${p(c.hour)}:${p(c.minute)}`;
+}
+//# sourceMappingURL=tz.js.map

package/dist/schedules/tz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tz.js","sourceRoot":"","sources":["../../src/schedules/tz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAA;AAExB,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAA;AAEzD,SAAS,YAAY,CAAC,EAAU;IAC/B,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACR,CAAC,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACpC,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;SACjB,CAAC,CAAA;QACF,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,CAAC,CAAA;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IAC1C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,uBAAuB,CAAC,yBAAyB,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IACzE,CAAC;IACD,IAAI,CAAC;QACJ,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAA;IAC5F,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,uBAAuB,CAAC,sBAAsB,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;AACF,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY;IAC3B,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAA;AACjE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,EAAU;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/D,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM;gBACV,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACzB,MAAK;YACN,KAAK,OAAO;gBACX,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC1B,MAAK;YACN,KAAK,KAAK;gBACT,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACxB,MAAK;YACN,KAAK,MAAM;gBACV,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;gBAC9B,MAAK;YACN,KAAK,QAAQ;gBACZ,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC3B,MAAK;QACP,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,EAAU;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;IACrD,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,EAAU;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS;QAC/B,QAAQ,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;KAC9B,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,CAAA;QAC/B,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,EAAU;IAC5D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAA;IACxC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAA;IACxC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IACrD,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IACpD,uDAAuD;IACvD,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,MAAM,CAAC,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI;YAAE,EAAE,GAAG,GAAG,CAAA;;YACxC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,CAAA;AACnB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,KAAK,CAAC,IAAY;IAQjC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;IACxB,OAAO;QACN,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC;QAC1B,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QACrB,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE;QACzB,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE;KACtB,CAAA;AACF,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,EAAU;IACrD,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IACpC,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnD,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAA;AACzE,CAAC"}

package/dist/skills/index.d.ts

@@ -1,3 +1,3 @@
-export { loadSkill, discoverSkills } from './loader.js';
+export { SKILL_FRONTMATTER_KEYS, loadSkill, discoverSkills } from './loader.js';
 export { SkillRegistry, resolveSkillChain } from './registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/index.js

@@ -1,3 +1,3 @@
-export { loadSkill, discoverSkills } from './loader.js';
+export { SKILL_FRONTMATTER_KEYS, loadSkill, discoverSkills } from './loader.js';
 export { SkillRegistry, resolveSkillChain } from './registry.js';
 //# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/loader.d.ts

@@ -2,12 +2,25 @@ import type { SkillDisclosureLevel, SkillLoadResult } from '../types/skills/inde
 import { type Logger } from '../utils/logger.js';
 export declare const SKILL_FILENAME = "SKILL.md";
 /**
- * `allowed-tools` may be a YAML list. The Agent Skills format writes it
- * space-separated, comma-separated or as a list, and all three must mean the
- * same grant; the reader joins a list into the comma form.
+ * The frontmatter keys this loader reads.
+ *
+ * Every other key is skipped whole, whatever YAML it is written in, so a
+ * skill written for another agent — `argument-hint: [file]`, a `hooks:`
+ * block, `user-invocable: false` — loads here with those fields ignored
+ * instead of being refused over syntax in a field nothing reads. The keys
+ * listed are still parsed strictly: a value this loader USES is never read
+ * wrongly.
+ */
+export declare const SKILL_FRONTMATTER_KEYS: readonly string[];
+/**
+ * How this loader reads frontmatter. `allowed-tools` may be a YAML list: the
+ * Agent Skills format writes it space-separated, comma-separated or as a
+ * list, and all three must mean the same grant; the reader joins a list into
+ * the comma form. Keys the loader does not read are skipped whole.
  */
 export declare const SKILL_FRONTMATTER_OPTIONS: {
     readonly lists: readonly ["allowed-tools"];
+    readonly readsKey: (key: string) => boolean;
 };
 export declare function loadSkill(dirPath: string, level?: SkillDisclosureLevel, log?: Logger): Promise<SkillLoadResult>;
 export declare function discoverSkills(parentDir: string, log?: Logger): Promise<string[]>;

package/dist/skills/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAE/D,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;CAAwC,CAAA;AAuI9E,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,EACxC,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBvF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAE/D,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EASlD,CAAA;AAIF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;6BARR,MAAM,KAAG,OAAO;CAWpC,CAAA;AA+JV,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,EACxC,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBvF"}

package/dist/skills/loader.js

@@ -5,11 +5,36 @@ import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
 import { resolveLogger } from '../utils/logger.js';
 export const SKILL_FILENAME = 'SKILL.md';
 /**
- * `allowed-tools` may be a YAML list. The Agent Skills format writes it
- * space-separated, comma-separated or as a list, and all three must mean the
- * same grant; the reader joins a list into the comma form.
+ * The frontmatter keys this loader reads.
+ *
+ * Every other key is skipped whole, whatever YAML it is written in, so a
+ * skill written for another agent — `argument-hint: [file]`, a `hooks:`
+ * block, `user-invocable: false` — loads here with those fields ignored
+ * instead of being refused over syntax in a field nothing reads. The keys
+ * listed are still parsed strictly: a value this loader USES is never read
+ * wrongly.
+ */
+export const SKILL_FRONTMATTER_KEYS = Object.freeze([
+    'name',
+    'description',
+    'license',
+    'compatibility',
+    'allowed-tools',
+    'invocation',
+    'disable-model-invocation',
+    'metadata',
+]);
+const READS_SKILL_KEY = (key) => SKILL_FRONTMATTER_KEYS.includes(key);
+/**
+ * How this loader reads frontmatter. `allowed-tools` may be a YAML list: the
+ * Agent Skills format writes it space-separated, comma-separated or as a
+ * list, and all three must mean the same grant; the reader joins a list into
+ * the comma form. Keys the loader does not read are skipped whole.
  */
-export const SKILL_FRONTMATTER_OPTIONS = { lists: ['allowed-tools'] };
+export const SKILL_FRONTMATTER_OPTIONS = {
+    lists: ['allowed-tools'],
+    readsKey: READS_SKILL_KEY,
+};
 /**
  * How this file's errors name themselves. Passed to the shared reader so a
  * frontmatter failure still reads as a `SKILL.md` failure — the reader is
@@ -86,6 +111,25 @@ function toSkillMetadata(parsed, dirPath) {
         }
         skillMetadata.invocation = invocation;
     }
+    // The other common spelling of "the model may not pick this":
+    // `disable-model-invocation: true` is `invocation: operator`. Read here,
+    // at the one parser, so a registry that re-reads the file on every load
+    // cannot lose it — a host-side override would be dropped by the first
+    // freshness reload and the model could then load an operator-only skill.
+    const disableModel = scalarAt(values, 'disable-model-invocation');
+    if (disableModel !== undefined) {
+        if (disableModel !== 'true' && disableModel !== 'false') {
+            // Refused for the reason `invocation` is: `yes` quietly reading as
+            // "not disabled" would put the skill back in front of the model.
+            throw new Error(`${source}: disable-model-invocation must be true or false — got "${disableModel}"`);
+        }
+        if (disableModel === 'true') {
+            if (skillMetadata.invocation !== undefined && skillMetadata.invocation !== 'operator') {
+                throw new Error(`${source}: disable-model-invocation: true contradicts invocation: ${skillMetadata.invocation}`);
+            }
+            skillMetadata.invocation = 'operator';
+        }
+    }
     const extra = mappingAt(values, 'metadata');
     if (extra && Object.keys(extra).length > 0) {
         skillMetadata.metadata = { ...extra };

package/dist/skills/loader.js.map

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

package/dist/tools/builtins/browser-url.d.ts

@@ -0,0 +1,83 @@
+/**
+ * One spelling per address, decided before anyone judges the address.
+ *
+ * The browser tools' `url` and `origin` arguments are canonicalised by their
+ * input schema, and the registry hands the gate and the reviewer the schema's
+ * OUTPUT (`ToolRegistry.prepareExecution`). So a site rule written as
+ * `^https://github\.com(?:[/?#]|$)` is tested against the one spelling the
+ * browser will load, never against `HTTPS://GitHub.com:443/`,
+ * `https://github.com./` or `https://%67ithub.com/`, which name the same page
+ * and would each slip past a deny written for the plain form.
+ *
+ * The canonical form is the WHATWG URL serialisation (`new URL(x).href`),
+ * which already lowercases the scheme and host, converts an internationalised
+ * host to punycode, drops a default port, decodes percent-encoded host bytes
+ * and reads every IPv4 spelling (`2852039166`, `0xA9FEA9FE`,
+ * `0251.0376.0251.0376`, `169.254.43518`) as dotted-quad. On top of that:
+ *
+ * - trailing dots on the host are removed (`github.com.` is `github.com` to
+ *   DNS and to a person, and a different string to a pattern);
+ * - only `http:` and `https:` are accepted, plus the literal `about:blank`;
+ * - an address carrying a user name or password is refused — it is how
+ *   `https://github.com@evil.example/` reads as GitHub to a person;
+ * - cloud metadata endpoints are refused outright, in every spelling the
+ *   parser folds into them. This is a floor, not the site policy: a private
+ *   or loopback address is left to the operator's site rules, and a DNS name
+ *   that RESOLVES to a metadata address is the host's to catch after the
+ *   navigation lands.
+ */
+export type BrowserUrlVerdict = {
+    readonly ok: true;
+    readonly url: string;
+    readonly origin: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export type BrowserOriginVerdict = {
+    readonly ok: true;
+    readonly origin: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** Longest address the tools accept. Longer is not a page anyone meant to name. */
+export declare const BROWSER_URL_MAX_LENGTH = 8192;
+/**
+ * Is this host a cloud metadata endpoint, in any spelling the URL parser
+ * folds into one? `hostname` is a URL's `hostname` (IPv6 in brackets) or a
+ * bare name or address.
+ */
+export declare function isCloudMetadataHost(hostname: string): boolean;
+/**
+ * The one spelling of an address the browser may be sent to, or why not.
+ *
+ * Accepts absolute `http:` and `https:` URLs and `about:blank`. See the
+ * module comment for what is folded and what is refused.
+ */
+export declare function canonicalizeBrowserUrl(raw: string): BrowserUrlVerdict;
+/**
+ * The canonical origin (`scheme://host[:port]`) a `browser_act` call names,
+ * or why it is not one. A trailing `/` is accepted; a path, query or fragment
+ * is not — the argument is an origin, copied from the snapshot header.
+ */
+export declare function canonicalizeBrowserOrigin(raw: string): BrowserOriginVerdict;
+export type BrowserSitePatternVerdict = {
+    readonly ok: true;
+    readonly pattern: string;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * The canonical spelling of a site key an operator or a job grants —
+ * `https://github.com`, `https://*.example.com`, `http://localhost:*` — or
+ * why it is not one.
+ *
+ * The scheme is literal (`http` or `https`). The host may begin with `*.`,
+ * meaning one or more labels in front of the rest. The port may be `*`, any
+ * port; a default port is dropped. The host is lowercased and punycoded like
+ * a URL's. A bare `*`, a path, credentials and metadata hosts are refused.
+ */
+export declare function canonicalizeBrowserSitePattern(raw: string): BrowserSitePatternVerdict;
+//# sourceMappingURL=browser-url.d.ts.map

package/dist/tools/builtins/browser-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-url.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/browser-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,MAAM,iBAAiB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,MAAM,MAAM,oBAAoB,GAC7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,OAAO,CAAA;AA+D1C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiB7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CA+CrE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAa3E;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAoCrF"}