@betterlu/agentlu 1.10.0 → 1.11.0

package/README.md

@@ -359,3 +359,21 @@ const signal = await alu.household.signal({
 `deduped`). Facts are data, never instructions; urgency `now` requests a batched
 review, not guaranteed delivery. See [Household signals](../../docs/household-signals.md)
 for limits, expiry, dedupe and editorial semantics.
+
+## Publishing
+
+Every change to this package is published; consumer apps must only use
+published versions (never copy SDK code or hand-roll `/v1` fetch helpers for a
+feature the SDK lacks: add it here and publish).
+
+1. Make the change (after `/v1` contract edits, regenerate `src/generated.ts`
+   and confirm `npm run check:contract` from the repo root).
+2. Bump the version: `npm version <x.y.z> --no-git-tag-version` (minor for new
+   methods/fields, patch for fixes, major for breaking changes).
+3. Add a `CHANGELOG.md` entry for that version.
+4. Verify: `npm run build` here and `npx vitest run tests/sdk` from the repo root.
+5. Publish: `npm publish` (runs `prepublishOnly` → build; npm user `betterlu`).
+   Check with `npm view @betterlu/agentlu version`.
+6. Commit the bump with the change, then update consumers to the new range
+   (`npm install @betterlu/agentlu@^<x.y.z>`) and switch them to the new API.
+

package/dist/generated.d.ts

@@ -8,6 +8,77 @@
  * contract. They describe the bytes on the wire (snake_case); the SDK's own
  * types are the ergonomic view over them.
  */
+export interface WireBriefPublishInput {
+    "source": string;
+    "key": string;
+    "kind": "edition" | "report" | "note" | "story";
+    "audience": "larry" | "misa" | "both";
+    "title": string;
+    "dek"?: string;
+    "body"?: string;
+    "bodyFormat"?: "markdown" | "html";
+    "entries"?: Array<{
+        "title": string;
+        "url"?: string;
+        "image"?: string;
+        "chips"?: string[];
+        "body"?: string;
+    }>;
+    "images"?: string[];
+    "url"?: string;
+    "keep"?: boolean;
+    "ttlDays"?: number;
+    "collection"?: string;
+    "sourceLabel"?: string;
+    "sourceEmoji"?: string;
+    "coverArt"?: boolean;
+    "jobRunId"?: string;
+    "artifactId"?: string;
+    "publishedAt"?: string;
+}
+export interface WireBriefDetail {
+    "id": string;
+    "source": string;
+    "sourceLabel": string;
+    "sourceEmoji": string | null;
+    "kind": "edition" | "report" | "note" | "story";
+    "audience": "larry" | "misa" | "both";
+    "title": string;
+    "dek": string | null;
+    "coverUrl": string | null;
+    "coverArtStatus": "none" | "pending" | "ready" | "failed";
+    "edition": {
+        "hero": string;
+        "highlights": string[];
+    } | null;
+    "keep": boolean;
+    "collection": string | null;
+    "readingMinutes": number | null;
+    "publishedAt": string;
+    "bodyFormat": "markdown" | "html";
+    "bodyHtml": string | null;
+    "frameUrl": string | null;
+    "entries": Array<{
+        "title": string;
+        "url"?: string;
+        "image"?: string;
+        "chips"?: string[];
+        "body"?: string;
+        "bodyHtml"?: string;
+    }> | null;
+    "images": string[];
+    "url": string | null;
+    "jobRunId": string | null;
+    "artifactId": string | null;
+    "expiresAt": string | null;
+}
+export interface WireBriefPublishResult {
+    "id": string;
+    "url": string;
+    "coverUrl": string | null;
+    "coverArtStatus": "none" | "pending" | "ready" | "failed";
+    "updated": boolean;
+}
 export interface WireHouseholdSignalInput {
     "source": string;
     "kind": string;

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import type { WireBriefPublishInput, WireBriefPublishResult, WireBriefDetail } from "./generated.js";
+export type { WireBriefPublishInput, WireBriefPublishResult, WireBriefDetail } from "./generated.js";
+export type { WireBriefPublishInput as BriefPublishInput, WireBriefPublishResult as BriefPublishResult, WireBriefDetail as BriefDetail } from "./generated.js";
 /**
  * @betterlu/agentlu - client for the agentlu service API.
  *
@@ -668,6 +671,10 @@ export declare class AgentLu {
         delete: (id: string) => Promise<unknown>;
         messages: (id: string) => Promise<unknown>;
     };
+    readonly briefs: {
+        publish: (input: WireBriefPublishInput, opts?: RequestOptions) => Promise<WireBriefPublishResult>;
+        get: (id: string, opts?: RequestOptions) => Promise<WireBriefDetail>;
+    };
     readonly household: {
         signal: (input: WireHouseholdSignalInput, opts?: RequestOptions) => Promise<WireHouseholdSignalResult>;
     };

package/dist/index.js

@@ -728,6 +728,10 @@ export class AgentLu {
         delete: (id) => this.request("DELETE", `/threads/${encodeURIComponent(id)}`),
         messages: (id) => this.request("GET", `/threads/${encodeURIComponent(id)}/messages`),
     };
+    briefs = {
+        publish: (input, opts) => this.request("POST", "/briefs", input, opts),
+        get: (id, opts) => this.request("GET", `/briefs/${encodeURIComponent(id)}`, undefined, opts),
+    };
     household = {
         signal: (input, opts) => this.request("POST", "/household/signals", input, opts),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@betterlu/agentlu",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Client for the agentlu service API (/v1). Or just use the openai SDK pointed at http://localhost:8912/v1.",
   "type": "module",
   "main": "./dist/index.js",