@agentsean/actions 1.0.0

package/dist/persist.js

@@ -0,0 +1,362 @@
+import { randomUUID } from "node:crypto";
+import { and, eq, gte } from "drizzle-orm";
+import { actions, adapterConnections, changes, changeSnapshots, costLedger, entitySightings, pages, sites, twoKeyApprovals, urlAllowlist, } from "@agentsean/db";
+import { BLAST } from "./types.js";
+export function envelopeOf(action) {
+    return {
+        payload: action.payload,
+        rationale: action.rationale,
+        findingIds: action.findingIds,
+        estimatedImpact: action.estimatedImpact,
+        kind: action.kind,
+        target: action.target,
+    };
+}
+export function actionFromRow(row) {
+    if (!row.payload)
+        return null;
+    let env;
+    try {
+        env = JSON.parse(row.payload);
+    }
+    catch {
+        return null;
+    }
+    const tier = Number(row.tier.replace(/^T/, ""));
+    if (tier !== 0 && tier !== 1 && tier !== 2 && tier !== 3 && tier !== 4)
+        return null;
+    return {
+        id: row.id,
+        siteId: row.siteId,
+        kind: env.kind,
+        tier,
+        target: env.target,
+        payload: env.payload,
+        rationale: env.rationale,
+        findingIds: env.findingIds,
+        estimatedImpact: env.estimatedImpact,
+    };
+}
+export function saveAction(db, action, state, extra) {
+    const now = new Date().toISOString();
+    const existing = db.select().from(actions).where(eq(actions.id, action.id)).get();
+    const values = {
+        siteId: action.siteId,
+        pageId: action.target.pageId,
+        findingId: action.findingIds[0] ?? null,
+        actionType: action.kind,
+        targetRef: action.target.url,
+        payload: JSON.stringify(envelopeOf(action)),
+        risk: `T${action.tier}`,
+        tier: `T${action.tier}`,
+        state,
+        approvedBy: extra?.approvedBy ?? existing?.approvedBy ?? null,
+        approvedAt: extra?.approvedBy ? now : (existing?.approvedAt ?? null),
+        appliedAt: state === "applied" ? now : (existing?.appliedAt ?? null),
+        error: extra?.error ?? null,
+    };
+    if (existing) {
+        db.update(actions).set(values).where(eq(actions.id, action.id)).run();
+        return;
+    }
+    db.insert(actions)
+        .values({
+        id: action.id,
+        createdAt: now,
+        ...values,
+    })
+        .run();
+}
+export function recordChange(db, action, applied) {
+    const now = new Date().toISOString();
+    const changeId = applied.id || randomUUID();
+    db.insert(changes)
+        .values({
+        id: changeId,
+        actionId: action.id,
+        siteId: action.siteId,
+        appliedAt: now,
+        actor: "sean",
+        summary: applied.summary,
+        revertible: 1,
+        revertedAt: null,
+    })
+        .run();
+    db.insert(changeSnapshots)
+        .values({
+        id: randomUUID(),
+        changeId,
+        kind: "before",
+        targetRef: applied.targetRef,
+        body: applied.before,
+        contentType: "text/plain",
+        capturedAt: now,
+    })
+        .run();
+    db.insert(changeSnapshots)
+        .values({
+        id: randomUUID(),
+        changeId,
+        kind: "after",
+        targetRef: applied.targetRef,
+        body: applied.after,
+        contentType: "text/plain",
+        capturedAt: now,
+    })
+        .run();
+    const meta = {
+        branch: applied.branch ?? null,
+        commitSha: applied.commitSha ?? null,
+        prUrl: applied.prUrl ?? null,
+    };
+    db.insert(changeSnapshots)
+        .values({
+        id: randomUUID(),
+        changeId,
+        kind: "meta",
+        targetRef: applied.targetRef,
+        body: JSON.stringify(meta),
+        contentType: "application/json",
+        capturedAt: now,
+    })
+        .run();
+    return { changeId };
+}
+export function loadChange(db, changeId) {
+    const row = db.select().from(changes).where(eq(changes.id, changeId)).get();
+    if (!row)
+        return null;
+    const snaps = db
+        .select()
+        .from(changeSnapshots)
+        .where(eq(changeSnapshots.changeId, changeId))
+        .all();
+    const before = snaps.find((s) => s.kind === "before");
+    const after = snaps.find((s) => s.kind === "after");
+    const metaRow = snaps.find((s) => s.kind === "meta");
+    let meta = {};
+    if (metaRow) {
+        try {
+            meta = JSON.parse(metaRow.body);
+        }
+        catch {
+            meta = {};
+        }
+    }
+    const result = {
+        id: row.id,
+        actionId: row.actionId,
+        siteId: row.siteId,
+        targetRef: before?.targetRef ?? after?.targetRef ?? "",
+        before: before?.body ?? "",
+        after: after?.body ?? "",
+        summary: row.summary,
+    };
+    if (meta.branch)
+        result.branch = meta.branch;
+    if (meta.commitSha)
+        result.commitSha = meta.commitSha;
+    if (meta.prUrl)
+        result.prUrl = meta.prUrl;
+    return result;
+}
+export function markReverted(db, changeId) {
+    db.update(changes)
+        .set({ revertedAt: new Date().toISOString() })
+        .where(eq(changes.id, changeId))
+        .run();
+}
+export function loadSitePolicy(db, siteId) {
+    const row = db.select().from(sites).where(eq(sites.id, siteId)).get();
+    if (!row)
+        return null;
+    let globs = [];
+    try {
+        const parsed = JSON.parse(row.neverTouchGlobs);
+        if (Array.isArray(parsed) && parsed.every((g) => typeof g === "string"))
+            globs = parsed;
+    }
+    catch {
+        globs = [];
+    }
+    return {
+        id: row.id,
+        origin: row.origin,
+        autonomyMode: row.autonomyMode,
+        observeUntil: row.observeUntil,
+        ymylCategory: row.ymylCategory,
+        killswitch: row.killswitch,
+        neverTouchGlobs: globs,
+        createdAt: row.createdAt,
+    };
+}
+export function loadPages(db, siteId) {
+    return db
+        .select()
+        .from(pages)
+        .where(eq(pages.siteId, siteId))
+        .all()
+        .map((p) => ({
+        id: p.id,
+        url: p.url,
+        title: p.title,
+        metaDescription: p.metaDescription,
+        h1: p.h1,
+    }));
+}
+export function loadAllowlist(db, siteId) {
+    return db
+        .select()
+        .from(urlAllowlist)
+        .where(eq(urlAllowlist.siteId, siteId))
+        .all()
+        .map((r) => r.url);
+}
+export function loadEntities(db, siteId) {
+    return db
+        .select()
+        .from(entitySightings)
+        .where(eq(entitySightings.siteId, siteId))
+        .all()
+        .map((r) => ({
+        entity: r.entity,
+        source: r.source,
+    }));
+}
+export function loadTwoKey(db, actionId) {
+    return db
+        .select()
+        .from(twoKeyApprovals)
+        .where(eq(twoKeyApprovals.actionId, actionId))
+        .all()
+        .map((r) => ({ actor: r.actor, hmac: r.hmac }));
+}
+export function addTwoKey(db, actionId, actor, hmac) {
+    db.insert(twoKeyApprovals)
+        .values({
+        id: randomUUID(),
+        actionId,
+        actor,
+        hmac,
+        createdAt: new Date().toISOString(),
+    })
+        .run();
+}
+export function recordEntity(db, siteId, entity, entityKind, source) {
+    const existing = db
+        .select()
+        .from(entitySightings)
+        .where(eq(entitySightings.siteId, siteId))
+        .all()
+        .find((r) => r.entity === entity);
+    if (existing)
+        return;
+    db.insert(entitySightings)
+        .values({
+        id: randomUUID(),
+        siteId,
+        entity,
+        entityKind,
+        source,
+        firstSeenAt: new Date().toISOString(),
+    })
+        .run();
+}
+export function upsertAdapterConnection(db, siteId, kind, config) {
+    const now = new Date().toISOString();
+    const existing = db
+        .select()
+        .from(adapterConnections)
+        .where(and(eq(adapterConnections.siteId, siteId), eq(adapterConnections.kind, kind)))
+        .get();
+    if (existing) {
+        db.update(adapterConnections)
+            .set({ config: JSON.stringify(config), updatedAt: now })
+            .where(eq(adapterConnections.id, existing.id))
+            .run();
+        return;
+    }
+    db.insert(adapterConnections)
+        .values({
+        id: randomUUID(),
+        siteId,
+        kind,
+        config: JSON.stringify(config),
+        createdAt: now,
+        updatedAt: now,
+    })
+        .run();
+}
+export function loadAdapterConnection(db, siteId, kind) {
+    const row = db
+        .select()
+        .from(adapterConnections)
+        .where(and(eq(adapterConnections.siteId, siteId), eq(adapterConnections.kind, kind)))
+        .get();
+    if (!row)
+        return null;
+    try {
+        const parsed = JSON.parse(row.config);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function listAdapterConnections(db, siteId) {
+    return db
+        .select()
+        .from(adapterConnections)
+        .where(eq(adapterConnections.siteId, siteId))
+        .all()
+        .map((row) => {
+        let config = {};
+        try {
+            const parsed = JSON.parse(row.config);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                config = parsed;
+            }
+        }
+        catch {
+            config = {};
+        }
+        return { kind: row.kind, config };
+    });
+}
+export function upsertGitConnection(db, siteId, config) {
+    upsertAdapterConnection(db, siteId, "git", config);
+}
+export function loadGitConnection(db, siteId) {
+    return loadAdapterConnection(db, siteId, "git");
+}
+export function countsForLedger(db, siteId, now) {
+    const hour = new Date(now.getTime() - 60 * 60 * 1000).toISOString();
+    const day = now.toISOString().slice(0, 10) + "T00:00:00.000Z";
+    const applied = db
+        .select()
+        .from(actions)
+        .where(and(eq(actions.siteId, siteId), eq(actions.state, "applied")))
+        .all();
+    const appliedThisHour = applied.filter((a) => (a.appliedAt ?? "") >= hour).length;
+    const appliedThisDay = applied.filter((a) => (a.appliedAt ?? "") >= day).length;
+    const newPagesToday = applied.filter((a) => a.actionType === "create_page" && (a.appliedAt ?? "") >= day).length;
+    const contentRefreshToday = applied.filter((a) => a.actionType === "refresh_content" && (a.appliedAt ?? "") >= day).length;
+    const costs = db
+        .select()
+        .from(costLedger)
+        .where(and(eq(costLedger.siteId, siteId), gte(costLedger.ts, day)))
+        .all();
+    const spentUsdToday = costs.reduce((s, r) => s + (r.costUsd ?? 0), 0);
+    return {
+        appliedThisHour,
+        appliedThisDay,
+        newPagesToday,
+        contentRefreshToday,
+        spentUsdToday,
+    };
+}
+export { BLAST };
+//# sourceMappingURL=persist.js.map

package/dist/persist.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,20 @@
+import { type Action, type PageRow } from "./types.js";
+export type FindingRow = {
+    id: string;
+    siteId: string;
+    pageId: string | null;
+    ruleId: string;
+    status: string;
+};
+/**
+ * Deterministic title. Never reads JSON-LD headline or Readability metadata —
+ * those are attacker-controlled. Prefer a clean H1, else slug + site name.
+ */
+export declare function proposeTitle(page: PageRow, origin: string): string;
+export declare function planTitleActions(opts: {
+    siteId: string;
+    origin: string;
+    pages: PageRow[];
+    findings: FindingRow[];
+}): Action[];
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AASlE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAwCF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,GAAG,MAAM,EAAE,CA4BX"}

package/dist/planner.js

@@ -0,0 +1,115 @@
+import { randomUUID } from "node:crypto";
+import { KIND_TIER } from "./kinds.js";
+import { bannedHits, invisibleHits } from "./scan.js";
+import { TITLE_MAX } from "./types.js";
+const TITLE_RULES = new Set([
+    "ONP.TITLE_MISSING",
+    "ONP.TITLE_TOO_SHORT",
+    "ONP.TITLE_TOO_LONG",
+    "ONP.TITLE_PIXEL_OVER",
+]);
+function hostnameToName(origin) {
+    try {
+        const host = new URL(origin).hostname.replace(/^www\./, "");
+        const head = host.split(".")[0] ?? host;
+        return head.charAt(0).toUpperCase() + head.slice(1);
+    }
+    catch {
+        return "Site";
+    }
+}
+function slugTitle(url) {
+    try {
+        const u = new URL(url);
+        const parts = u.pathname.split("/").filter(Boolean);
+        const last = parts[parts.length - 1] ?? "";
+        const cleaned = last
+            .replace(/\.[a-z0-9]+$/i, "")
+            .replace(/[-_]+/g, " ")
+            .trim();
+        if (!cleaned)
+            return "";
+        return cleaned
+            .split(" ")
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(" ");
+    }
+    catch {
+        return "";
+    }
+}
+function usable(text) {
+    const t = text.replace(/\s+/g, " ").trim();
+    if (t.length < 8 || t.length > TITLE_MAX)
+        return false;
+    if (bannedHits(t).length)
+        return false;
+    if (invisibleHits(t).count)
+        return false;
+    if (/https?:\/\//i.test(t) || /</.test(t))
+        return false;
+    return true;
+}
+/**
+ * Deterministic title. Never reads JSON-LD headline or Readability metadata —
+ * those are attacker-controlled. Prefer a clean H1, else slug + site name.
+ */
+export function proposeTitle(page, origin) {
+    const site = hostnameToName(origin);
+    const h1 = page.h1?.replace(/\s+/g, " ").trim() ?? "";
+    if (usable(h1) && h1.length >= 20 && h1.length <= 60) {
+        return h1.length >= 30 ? h1 : `${h1} | ${site}`.slice(0, TITLE_MAX);
+    }
+    const slug = slugTitle(page.url);
+    let title = slug ? `${slug} | ${site}` : `${site} official site`;
+    if (h1 && usable(h1))
+        title = `${h1} | ${site}`;
+    if (title.length < 30)
+        title = `${title} — ${site} official site`;
+    if (title.length > 60) {
+        title = title
+            .slice(0, 57)
+            .replace(/\s+\S*$/, "")
+            .trimEnd();
+    }
+    if (title.length < 30)
+        title = `${site} official site home page`;
+    if (!usable(title))
+        title = `${site} official site home page`;
+    return title.slice(0, TITLE_MAX);
+}
+export function planTitleActions(opts) {
+    const byId = new Map(opts.pages.map((p) => [p.id, p]));
+    const out = [];
+    for (const f of opts.findings) {
+        if (f.status !== "open")
+            continue;
+        if (!TITLE_RULES.has(f.ruleId))
+            continue;
+        if (!f.pageId)
+            continue;
+        const page = byId.get(f.pageId);
+        if (!page)
+            continue;
+        const title = proposeTitle(page, opts.origin);
+        if (page.title && page.title === title)
+            continue;
+        out.push({
+            id: randomUUID(),
+            siteId: opts.siteId,
+            kind: "rewrite_title",
+            tier: KIND_TIER.rewrite_title,
+            target: { pageId: page.id, url: page.url },
+            payload: { title },
+            rationale: [
+                `Finding ${f.ruleId} on ${page.url}.`,
+                `Proposed title from the page H1 or URL slug, never from JSON-LD or og: tags.`,
+                `Default impact metric is clicks.`,
+            ],
+            findingIds: [f.id],
+            estimatedImpact: { metric: "clicks", estimate: 0, confidence: 0.2 },
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/scan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Output-side scanners. Applied to Action text, never to crawled input.
+ * Classifiers score ~60% on benign SEO trigger words — that is why we scan
+ * what we would write, not what we read.
+ */
+export declare const BANNED_PATTERNS: {
+    id: string;
+    re: RegExp;
+}[];
+export declare function foldHomoglyphs(text: string): string;
+export declare function invisibleHits(text: string): {
+    count: number;
+    kinds: string[];
+};
+export declare function stripInvisible(text: string): string;
+export declare function bannedHits(text: string): string[];
+export declare function encodedPayloadHits(text: string): string[];
+export declare function collectActionText(value: unknown): string;
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH,eAAO,MAAM,eAAe,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAyBvD,CAAC;AAeF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAW9E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjD;AAyCD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAwCzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUxD"}