@project-ava-supernova/core 0.2.71

package/dist/social/index.d.ts

@@ -0,0 +1,290 @@
+export type { DayPlanItem as DayPlanRow, NewDayPlanItem, DayPlanStore } from './day-plan.js';
+/** A finished post the model emitted via write_post, normalised. */
+export interface SocialPostInput {
+    /** Target platform id — 'tweet', 'bluesky', 'linkedin', … (see write_post enum). */
+    platform: string;
+    /** Copy-paste-ready post body, hashtags + link inline. */
+    content: string;
+    /** Optional short library title. */
+    title?: string | null;
+    /** Optional variant label when writing several versions of one post. */
+    variant?: string | null;
+    /** Hashtags chosen for this post (no leading '#'), for the editable chip row. */
+    hashtags?: string[];
+    /** One line on the reach/niche tag split, shown under the chips. */
+    tagNote?: string | null;
+}
+/** What the store returns after a post is written. */
+export interface SocialPostWritten {
+    /** Stable id for this card this turn. */
+    id: string;
+    /** Library asset id when the surface auto-saved it as a draft; null otherwise. */
+    assetId?: string | null;
+}
+/**
+ * Surface-injected sink for finished posts. The web/hub implementation
+ * auto-saves to the Library (creative_assets) and collects the card for the
+ * post-run drain → canvas_update SSE. Core only calls write().
+ */
+export interface PostStore {
+    write(post: SocialPostInput): Promise<SocialPostWritten>;
+}
+/** A finished short-form video post: the clip, the voiceover, and the caption. */
+export interface VideoPostInput {
+    /** tiktok | instagram | youtube | facebook — all vertical short-form. */
+    platform: string;
+    /** What is ON SCREEN, as a generation prompt. */
+    visual: string;
+    /** What she SAYS over it. Empty for a silent clip carried by on-screen text. */
+    script?: string;
+    /** The caption — the post itself. */
+    caption: string;
+    /** Clip length in seconds. */
+    duration?: number;
+    title?: string;
+    hashtags?: string[];
+    tagNote?: string;
+    /**
+     * Fix the dice. Without a seed every regeneration lands in a different
+     * universe, so changing one word and comparing is impossible — you are not
+     * iterating, you are re-rolling. Pass the seed a previous clip reported to
+     * change ONE thing and see only that thing change.
+     */
+    seed?: number;
+    /**
+     * A dish we already have a photograph of. Naming one animates OUR hero image
+     * instead of generating a plausible stranger's version of the dish.
+     *
+     * Food is the right subject for this and a squat is not: there is no anatomy
+     * to get wrong, and the motion food wants — steam, a slow push, light moving
+     * across a surface — is exactly what these models do well. The picture is
+     * already the dish; animating it does not make it a different dish.
+     */
+    recipe?: string;
+}
+/** What the surface reports back once the job is accepted. */
+export interface VideoPostWritten {
+    /** Generation job id — the surface polls this; the clip is NOT ready yet. */
+    taskId: string;
+    /** The seed actually used. Reported so the next attempt can reuse it and
+     *  change one thing, rather than starting from scratch. */
+    seed: number;
+    /** The dish whose hero image became the first frame, when one was found.
+     *  Null when she named a recipe we have no photograph of — she is told, so
+     *  she does not claim the clip shows our dish when it was generated. */
+    recipeImageUsed?: string | null;
+    /** False when the voiceover failed, so the clip carries the model's own dub
+     *  rather than her voice. She must say so rather than let it pass as hers. */
+    voiced: boolean;
+    voiceError?: string | null;
+}
+/**
+ * Surface-injected sink for finished video posts.
+ *
+ * The split matters: core validates and enforces the caption cap (surface-free
+ * work it can do anywhere), while the IMPLEMENTATION renders the voiceover and
+ * submits the generation job — because those need provider keys and a wallet,
+ * which core has no business holding. Same shape as PostStore, one extra fact:
+ * write() returns a job, not a finished video, because generation outlives the
+ * turn and the caption is usable long before the picture is.
+ */
+export interface VideoPostStore {
+    write(post: VideoPostInput): Promise<VideoPostWritten>;
+}
+/**
+ * A voiceover asked for on its OWN — audio as the deliverable, with no clip
+ * around it.
+ *
+ * Separate from VideoPostInput on purpose. A video script is written to fit
+ * inside a picture and is capped hard because of it; a standalone read has no
+ * picture to stay inside, so the constraint would be arbitrary. The only reason
+ * these ever shared a path is that the voice happens to come from the same
+ * generator, which is not a reason.
+ */
+export interface VoiceoverInput {
+    /** The exact words to speak, verbatim — authored, never a summary. */
+    script: string;
+    /**
+     * Tone, pace and emotion, in her own words. The brand voice is the default
+     * and the store supplies it; this is the per-read direction on top.
+     */
+    direction?: string;
+    /** What it is for, so the card is identifiable later. */
+    title?: string;
+    /** BCP-47-ish language name the read is voiced in. Defaults to English. */
+    language?: string;
+}
+/** What the surface reports back once the audio exists. */
+export interface VoiceoverWritten {
+    /** Where the rendered audio lives. */
+    url: string;
+    /** Measured length, when the surface can determine it. */
+    seconds?: number | null;
+    /** Library id, when the surface saved it. */
+    assetId?: string | null;
+}
+/**
+ * Surface-injected sink for standalone voiceovers.
+ *
+ * Same split as VideoPostStore and PostStore: core validates the script, the
+ * implementation holds the provider key and the wallet. A room without this
+ * mounted simply has no voiceover tool, which is the honest failure — the
+ * alternative (a registered tool that answers "no canvas") is how the Design
+ * Studio's voice tool would have behaved if it had been allowlisted here.
+ */
+export interface VoiceoverStore {
+    write(voiceover: VoiceoverInput): Promise<VoiceoverWritten>;
+}
+/** Caption caps for the short-form platforms. Same deterministic enforcement as
+ *  POST_HARD_LIMITS — models cannot count characters, so we count for them. */
+export declare const VIDEO_CAPTION_LIMITS: Readonly<Record<string, number>>;
+/**
+ * Image size per platform, in the `width*height` form DashScope takes.
+ *
+ * DERIVED, never chosen. A model that can pick a resolution can pick the wrong
+ * one, and a 1:1 image on a Reel is a wasted generation — so the tool looks the
+ * size up from the platform and the model never sees a dimension at all.
+ *
+ * Facebook is the trap and the reason the key is platform + FORMAT rather than
+ * platform alone: its feed wants 1.91:1 and its Reels want 9:16, so "facebook"
+ * on its own cannot answer the question.
+ */
+export declare const PLATFORM_IMAGE_SPECS: Readonly<Record<string, string>>;
+/** Resolve a platform (optionally `platform:format`) to a DashScope size.
+ *  Falls back to square rather than guessing — a square crops to anything. */
+export declare function imageSizeFor(platform: string, format?: string): string;
+/** A picture for a post — generated, or REPAIRED from one that already exists. */
+export interface PostImageInput {
+    /** What the picture shows. */
+    prompt: string;
+    /** Target platform — decides the size. */
+    platform: string;
+    /** Optional format within a platform ('feed' | 'reel' | 'story'). Facebook
+     *  and Instagram both mean different shapes depending on this. */
+    format?: string;
+    /**
+     * An existing image to EDIT rather than replace. Its presence switches the
+     * model to the edit family, so "make the headline bigger" changes only the
+     * headline instead of rolling a new picture and losing what already worked.
+     */
+    referenceImage?: string;
+    /** What to keep out of the frame. */
+    negativePrompt?: string;
+    title?: string;
+}
+/** What the surface reports back once the picture exists. */
+export interface PostImageWritten {
+    url: string;
+    /** The size actually used, so she can state it without guessing. */
+    size: string;
+    /** True when this was an edit of a supplied image rather than a fresh one. */
+    edited: boolean;
+}
+/**
+ * Surface-injected sink for post images. Core validates and derives the size;
+ * the implementation holds the provider key and makes the call.
+ */
+export interface PostImageStore {
+    write(image: PostImageInput): Promise<PostImageWritten>;
+}
+/** A hook option the model proposed via propose_hooks. */
+export interface HookOption {
+    /** The opening line itself. */
+    hook: string;
+    /** One-line angle/rationale for this hook. */
+    angle?: string | null;
+}
+/** A set of candidate hooks for one subject, for the client to render as a picker. */
+export interface HookProposal {
+    /** The subject the hooks are for — echoed so the follow-up turn has context. */
+    subject: string;
+    /** Target platform for the eventual post. */
+    platform: string;
+    /** 1–3 candidate opening lines. */
+    hooks: HookOption[];
+}
+/**
+ * Surface-injected sink for proposed hooks. The web/hub implementation collects
+ * the proposal for the post-run drain → `hooks` SSE the client renders as a picker.
+ */
+export interface HookStore {
+    propose(proposal: HookProposal): Promise<void>;
+}
+/**
+ * Per-platform hard character caps (by code point — emoji count as 1). Single-
+ * post platforms with a real cap only; threads are per-tweet and long-form caps
+ * are rarely hit. The single source of truth shared by the core write_post tool
+ * and any surface that pre-validates. Kept here so both agree on one map.
+ */
+export declare const POST_HARD_LIMITS: Readonly<Record<string, number>>;
+/**
+ * Reddit is the one platform where the title is published content rather than a
+ * library label — it is what people vote on, and often all they read. So it has
+ * its own cap, enforced separately from the body.
+ */
+export declare const REDDIT_TITLE_LIMIT = 300;
+/** Per-platform hashtag/link policy — returned by research_post so Ava picks
+ *  tags within the platform's real conventions. Single source of truth. */
+export declare const PLATFORM_TAG_POLICY: Readonly<Record<string, string>>;
+/** A single web-search hit. */
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+/**
+ * Surface-injected web-search backend (the web supplies Brave, key server-side).
+ * research_post / suggest_beats call it to ground a post in the present.
+ * `freshness` biases toward recent results (pd/pw/pm/py = past day/week/month/year).
+ */
+export type WebSearchFn = (query: string, max?: number, freshness?: 'pd' | 'pw' | 'pm' | 'py') => Promise<WebSearchResult[]>;
+/** One tracked post's engagement (Bluesky — the platform we auto-track). */
+export interface PostMetric {
+    content: string;
+    likes: number | null;
+    reposts: number | null;
+    replies: number | null;
+    quotes: number | null;
+}
+/**
+ * Surface-injected reader for post performance. The web/hub implementation binds
+ * the user + queries `scheduled_posts` (Bluesky, posted, metrics synced); core
+ * does the sort/format. Returns up to ~50 recent tracked posts, newest first.
+ */
+export interface PostMetricsReader {
+    recent(): Promise<PostMetric[]>;
+}
+/**
+ * One STORY for the day's briefing.
+ *
+ * Not a post on a platform. A beat used to carry the single platform that
+ * "suited" it, which quietly decided the shape of the whole day: one angle per
+ * platform, platforms taking turns, a story's momentum split across three
+ * slots. What actually works is the opposite — one angle to every crowd in the
+ * same slot, adapted to each. Where it goes is a planning decision the operator
+ * makes; it is not a property of the idea.
+ */
+export interface Beat {
+    /** The angle/idea — the story itself. */
+    angle: string;
+    /** One line on why it fits the mission / the moment. */
+    why: string;
+    /**
+     * Does this story want SHOWING as well as saying?
+     *
+     * The one genuinely per-story judgement about medium: a demo, a before/after
+     * or anything visual earns a video for Reels and Shorts; an argument or a
+     * position usually does not. This decides whether the video platforms are on
+     * by default, so the operator is not making that call five times a morning.
+     */
+    needs_video?: boolean;
+}
+/**
+ * Surface-injected sink for the day's suggested beats. The web/hub
+ * implementation collects them for the post-run drain → `beats` SSE the client
+ * renders as the briefing (a menu the operator picks from).
+ */
+export interface BeatStore {
+    suggest(beats: Beat[]): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/social/index.ts"],"names":[],"mappings":"AAYA,YAAY,EAAE,WAAW,IAAI,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7F,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1D;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf;+DAC2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb;;4EAEwE;IACxE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;kFAC8E;IAC9E,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7D;AAED;+EAC+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBjE,CAAC;AAEF;8EAC8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB;sEACkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzD;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;2EAC2E;AAC3E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYhE,CAAC;AAEF,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,KAClC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEhC,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/social/index.js

@@ -0,0 +1,96 @@
+// ─── Social types — the Social Studio's shared contracts ────────────────────
+//
+// Ava's Social Media Manager persona (the Posts floor) runs on the core Agent.
+// Her write_post / propose_hooks tools produce cards + hook options that the
+// SURFACE renders — but core can't touch the surface (or the platform DB), so
+// they go through injected stores in sharedState, exactly like the health
+// tools' HealthPlanStore. The hub/web supplies the concrete stores (which
+// persist to the Library and emit the SSE the client draws), core just defines
+// the contract and does the surface-free logic (validation, char limits).
+/** Caption caps for the short-form platforms. Same deterministic enforcement as
+ *  POST_HARD_LIMITS — models cannot count characters, so we count for them. */
+export const VIDEO_CAPTION_LIMITS = {
+    tiktok: 4000,
+    instagram: 2200,
+    youtube: 5000,
+    facebook: 63206,
+};
+/**
+ * Image size per platform, in the `width*height` form DashScope takes.
+ *
+ * DERIVED, never chosen. A model that can pick a resolution can pick the wrong
+ * one, and a 1:1 image on a Reel is a wasted generation — so the tool looks the
+ * size up from the platform and the model never sees a dimension at all.
+ *
+ * Facebook is the trap and the reason the key is platform + FORMAT rather than
+ * platform alone: its feed wants 1.91:1 and its Reels want 9:16, so "facebook"
+ * on its own cannot answer the question.
+ */
+export const PLATFORM_IMAGE_SPECS = {
+    // Vertical short-form — the full screen.
+    'tiktok': '1080*1920',
+    'instagram:reel': '1080*1920',
+    'instagram:story': '1080*1920',
+    'youtube:short': '1080*1920',
+    'facebook:reel': '1080*1920',
+    // Instagram's feed: 4:5 over 1:1, because it takes more vertical screen and
+    // therefore more of the scroll.
+    'instagram': '1080*1350',
+    'instagram:feed': '1080*1350',
+    // Landscape / link-card shapes.
+    'tweet': '1600*900',
+    'x': '1600*900',
+    'youtube': '1600*900',
+    'linkedin': '1200*628',
+    'facebook': '1200*628',
+    'facebook:feed': '1200*628',
+    // Long-form headers and anything without a native shape.
+    'blog': '1600*900',
+    'post': '1280*1280',
+};
+/** Resolve a platform (optionally `platform:format`) to a DashScope size.
+ *  Falls back to square rather than guessing — a square crops to anything. */
+export function imageSizeFor(platform, format) {
+    const key = format ? `${platform}:${format}`.toLowerCase() : platform.toLowerCase();
+    return PLATFORM_IMAGE_SPECS[key]
+        ?? PLATFORM_IMAGE_SPECS[platform.toLowerCase()]
+        ?? '1280*1280';
+}
+/**
+ * Per-platform hard character caps (by code point — emoji count as 1). Single-
+ * post platforms with a real cap only; threads are per-tweet and long-form caps
+ * are rarely hit. The single source of truth shared by the core write_post tool
+ * and any surface that pre-validates. Kept here so both agree on one map.
+ */
+export const POST_HARD_LIMITS = {
+    tweet: 280,
+    bluesky: 300,
+    eurosky: 300,
+    instagram: 2200,
+    linkedin: 3000,
+    tiktok: 4000,
+    facebook: 63206,
+    reddit: 40000,
+};
+/**
+ * Reddit is the one platform where the title is published content rather than a
+ * library label — it is what people vote on, and often all they read. So it has
+ * its own cap, enforced separately from the body.
+ */
+export const REDDIT_TITLE_LIMIT = 300;
+/** Per-platform hashtag/link policy — returned by research_post so Ava picks
+ *  tags within the platform's real conventions. Single source of truth. */
+export const PLATFORM_TAG_POLICY = {
+    tweet: 'X: ~6 hashtags. Bimodal crowd — mix genre/theme tags with dev tags (#buildinpublic #IndieDev #aitools). URL allowed.',
+    thread: 'X thread: hashtags on the final tweet only, ~3-4. URL on the last tweet.',
+    tiktok: 'TikTok: 1-2 hashtags — one niche, one broad. Tags are heavily down-weighted now and a stack of five reads as low-effort to the classifier, so more tags is actively worse. Watch time in the opening seconds decides reach; caption KEYWORDS do more for discovery than tags, so write the caption to be searched. Genre/theme over dev tags. No URL. Avoid #fyp #foryou #foryoupage.',
+    youtube: 'YouTube Shorts: #Shorts always FIRST, top 3 show above the title. 15 max but >15 = ALL ignored. No URL surfaced in the Shorts feed.',
+    linkedin: 'LinkedIn: 3 hashtags max, professional. Link at the end is fine.',
+    bluesky: 'Bluesky: 1-2 hashtags max — technical / open-source / federated crowd, low tolerance for tag stacks. 300 char cap.',
+    facebook: 'Facebook Page: 0-2 hashtags max, tag stacks read as spam. Mixed crowd — some builders, but mostly people who just want the thing to work, so plain language over jargon and lead with what it does for them. Long-form is fine here; a story lands better than a headline. Link at the end is fine.',
+    instagram: 'Instagram: ~8-12 relevant tags, niche over generic; first few matter most.',
+    eurosky: 'Eurosky: 1-2 hashtags max — same AT-protocol crowd and conventions as Bluesky, European and privacy-minded. 300 char cap.',
+    reddit: 'Reddit: NO hashtags — they do nothing here and mark a post as imported from another platform. Discovery is the subreddit plus the title, not tags. Whether a link is allowed at all depends on the individual subreddit\'s self-promotion rules, which vary and are mod-enforced — check the sub rather than assuming. Title max 300 and it carries the post; plain and specific beats a hook, because this crowd reads clickbait as an insult.',
+    blog: 'Blog: no hashtags.',
+};
+//# sourceMappingURL=index.js.map

package/dist/social/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/social/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,0EAA0E;AAC1E,+EAA+E;AAC/E,0EAA0E;AAuJ1E;+EAC+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,yCAAyC;IACzC,QAAQ,EAAE,WAAW;IACrB,gBAAgB,EAAE,WAAW;IAC7B,iBAAiB,EAAE,WAAW;IAC9B,eAAe,EAAE,WAAW;IAC5B,eAAe,EAAE,WAAW;IAC5B,4EAA4E;IAC5E,gCAAgC;IAChC,WAAW,EAAE,WAAW;IACxB,gBAAgB,EAAE,WAAW;IAC7B,gCAAgC;IAChC,OAAO,EAAE,UAAU;IACnB,GAAG,EAAE,UAAU;IACf,SAAS,EAAE,UAAU;IACrB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,UAAU;IACtB,eAAe,EAAE,UAAU;IAC3B,yDAAyD;IACzD,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF;8EAC8E;AAC9E,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAe;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpF,OAAO,oBAAoB,CAAC,GAAG,CAAC;WAC3B,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;WAC5C,WAAW,CAAC;AACnB,CAAC;AAiED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC;2EAC2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,KAAK,EAAE,sHAAsH;IAC7H,MAAM,EAAE,0EAA0E;IAClF,MAAM,EAAE,uXAAuX;IAC/X,OAAO,EAAE,qIAAqI;IAC9I,QAAQ,EAAE,kEAAkE;IAC5E,OAAO,EAAE,oHAAoH;IAC7H,QAAQ,EAAE,qSAAqS;IAC/S,SAAS,EAAE,4EAA4E;IACvF,OAAO,EAAE,2HAA2H;IACpI,MAAM,EAAE,ibAAib;IACzb,IAAI,EAAE,oBAAoB;CAC3B,CAAC"}

package/dist/tasks/platform-sync.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Syncs local tasks to/from the Ava platform (Supabase).
+ * Follows the same pattern as PlatformMemorySync.
+ */
+import type { TaskEntry } from './types.js';
+import type { PlatformTaskSync } from './task-manager.js';
+export declare class PlatformTaskSyncImpl implements PlatformTaskSync {
+    private readonly apiBase;
+    private readonly platformKey;
+    constructor(apiBase: string, platformKey: string);
+    /** Push local tasks to the platform — upserts by matching title+project, deletes stale remotes. */
+    pushTasks(tasks: TaskEntry[]): Promise<void>;
+    /** Pull tasks from the platform. */
+    pullTasks(): Promise<TaskEntry[]>;
+    private pullRemote;
+    private create;
+    private update;
+    private delete;
+    private toLocal;
+    private headers;
+}
+//# sourceMappingURL=platform-sync.d.ts.map

package/dist/tasks/platform-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-sync.d.ts","sourceRoot":"","sources":["../../src/tasks/platform-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAmB1D,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKhD,mGAAmG;IAC7F,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BlD,oCAAoC;IAC9B,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAOzB,UAAU;YAaV,MAAM;YAqBN,MAAM;YAoBN,MAAM;IASpB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,OAAO;CAMhB"}

package/dist/tasks/platform-sync.js

@@ -0,0 +1,132 @@
+/**
+ * Syncs local tasks to/from the Ava platform (Supabase).
+ * Follows the same pattern as PlatformMemorySync.
+ */
+export class PlatformTaskSyncImpl {
+    apiBase;
+    platformKey;
+    constructor(apiBase, platformKey) {
+        this.apiBase = apiBase.replace(/\/+$/, '');
+        this.platformKey = platformKey;
+    }
+    /** Push local tasks to the platform — upserts by matching title+project, deletes stale remotes. */
+    async pushTasks(tasks) {
+        const remote = await this.pullRemote();
+        const remoteById = new Map(remote.map(t => [t.id, t]));
+        const localIds = new Set(tasks.map(t => t.id));
+        for (const task of tasks) {
+            const existing = remoteById.get(task.id);
+            if (existing) {
+                // Update if local is newer
+                if (new Date(task.updatedAt) > new Date(existing.updated_at)) {
+                    await this.update(existing.id, task);
+                }
+            }
+            else {
+                // Create new
+                await this.create(task);
+            }
+        }
+        // Delete remote tasks that no longer exist locally
+        for (const rt of remote) {
+            if (!localIds.has(rt.id)) {
+                await this.delete(rt.id);
+            }
+        }
+    }
+    /** Pull tasks from the platform. */
+    async pullTasks() {
+        const remote = await this.pullRemote();
+        return remote.map(this.toLocal);
+    }
+    // ── Private ─────────────────────────────────────────────────────────────────
+    async pullRemote() {
+        try {
+            const res = await fetch(`${this.apiBase}/tasks`, {
+                headers: this.headers(),
+            });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            return Array.isArray(data) ? data : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    async create(task) {
+        try {
+            await fetch(`${this.apiBase}/tasks`, {
+                method: 'POST',
+                headers: this.headers(),
+                body: JSON.stringify({
+                    title: task.title,
+                    description: task.description || null,
+                    priority: task.priority,
+                    status: task.status,
+                    due_date: task.dueDate || null,
+                    category: task.category,
+                    source: task.source,
+                    project: task.project,
+                    recurrence: task.recurrence,
+                    subtasks: task.subtasks,
+                }),
+            });
+        }
+        catch { /* fire-and-forget */ }
+    }
+    async update(id, task) {
+        try {
+            await fetch(`${this.apiBase}/tasks/${id}`, {
+                method: 'PATCH',
+                headers: this.headers(),
+                body: JSON.stringify({
+                    title: task.title,
+                    description: task.description || null,
+                    priority: task.priority,
+                    status: task.status,
+                    due_date: task.dueDate || null,
+                    category: task.category,
+                    recurrence: task.recurrence,
+                    subtasks: task.subtasks,
+                    completed_at: task.completedAt || null,
+                }),
+            });
+        }
+        catch { /* fire-and-forget */ }
+    }
+    async delete(id) {
+        try {
+            await fetch(`${this.apiBase}/tasks/${id}`, {
+                method: 'DELETE',
+                headers: this.headers(),
+            });
+        }
+        catch { /* fire-and-forget */ }
+    }
+    toLocal(remote) {
+        return {
+            id: remote.id,
+            title: remote.title,
+            description: remote.description ?? undefined,
+            priority: remote.priority,
+            status: remote.status,
+            dueDate: remote.due_date ?? undefined,
+            category: remote.category,
+            source: remote.source,
+            project: remote.project,
+            recurrence: remote.recurrence,
+            subtasks: remote.subtasks ?? [],
+            createdAt: remote.created_at,
+            updatedAt: remote.updated_at,
+            completedAt: remote.completed_at ?? undefined,
+        };
+    }
+    headers() {
+        return {
+            'Authorization': `Bearer ${this.platformKey}`,
+            'Content-Type': 'application/json',
+        };
+    }
+}
+//# sourceMappingURL=platform-sync.js.map

package/dist/tasks/platform-sync.js.map

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