@paneui/core 0.0.1 → 0.0.3

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactRecord, ArtifactSummary, ArtifactType, ArtifactVersion, CreateArtifactResponse, CreateSessionRequest, CreateSessionResponse, EventsPage, KeyInfo, PaneEvent, SessionState } from "./types.js";
+import type { ArtifactRecord, ArtifactSummary, ArtifactType, ArtifactVersion, CreateArtifactResponse, CreateSessionRequest, CreateSessionResponse, EventsPage, KeyInfo, PaneEvent, SessionState, TasteInfo } from "./types.js";
 export interface ClientOptions {
     /** Relay base URL, e.g. https://pane.example.com. Trailing slash is trimmed. */
     url: string;
@@ -153,6 +153,27 @@ export declare class PaneClient {
      * self-destruct. Returns 204 with no body on success.
      */
     revokeKey(id: string): Promise<void>;
+    /**
+     * GET /v1/taste — the calling agent's freeform "taste notes" markdown blob:
+     * presentation preferences the agent has picked up from human feedback over
+     * time. Returns `{ taste: null, updated_at: null, bytes: 0 }` when the
+     * agent has never written notes. Read this before generating an artifact so
+     * the agent applies prior feedback.
+     */
+    getTaste(): Promise<TasteInfo>;
+    /**
+     * PUT /v1/taste — whole-blob replace of the calling agent's taste notes.
+     * Empty/whitespace-only values are rejected by the relay; callers asking to
+     * clear must use {@link clearTaste}. The relay caps the payload at the
+     * server's `MAX_TASTE_BYTES` (utf8 bytes).
+     */
+    setTaste(taste: string): Promise<TasteInfo>;
+    /**
+     * DELETE /v1/taste — clear the calling agent's taste notes (idempotent on
+     * the relay; clearing already-empty notes still succeeds). Returns 204 with
+     * no body.
+     */
+    clearTaste(): Promise<void>;
     /**
      * DELETE /v1/sessions/:id — close/delete a session. Idempotent on the relay
      * side (an already-closed session still returns 204 with no body).

package/dist/client.js

@@ -269,6 +269,41 @@ export class PaneClient {
         if (!r.ok)
             this.fail(r);
     }
+    /**
+     * GET /v1/taste — the calling agent's freeform "taste notes" markdown blob:
+     * presentation preferences the agent has picked up from human feedback over
+     * time. Returns `{ taste: null, updated_at: null, bytes: 0 }` when the
+     * agent has never written notes. Read this before generating an artifact so
+     * the agent applies prior feedback.
+     */
+    async getTaste() {
+        const r = await this.call("GET", "/v1/taste");
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
+    /**
+     * PUT /v1/taste — whole-blob replace of the calling agent's taste notes.
+     * Empty/whitespace-only values are rejected by the relay; callers asking to
+     * clear must use {@link clearTaste}. The relay caps the payload at the
+     * server's `MAX_TASTE_BYTES` (utf8 bytes).
+     */
+    async setTaste(taste) {
+        const r = await this.call("PUT", "/v1/taste", { taste });
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
+    /**
+     * DELETE /v1/taste — clear the calling agent's taste notes (idempotent on
+     * the relay; clearing already-empty notes still succeeds). Returns 204 with
+     * no body.
+     */
+    async clearTaste() {
+        const r = await this.call("DELETE", "/v1/taste");
+        if (!r.ok)
+            this.fail(r);
+    }
     /**
      * DELETE /v1/sessions/:id — close/delete a session. Idempotent on the relay
      * side (an already-closed session still returns 204 with no body).

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export type { RegisterAgentOptions, RegisterAgentResult } from "./register.js";
 export { artifactSchema, callbackSchema, createSessionSchema, artifactTypeSchema, createArtifactSchema, createArtifactVersionSchema, patchArtifactMetadataSchema, } from "./schemas.js";
 export type { CreateSessionInput } from "./schemas.js";
 export { MAX_EVENT_TYPE_LENGTH, MAX_IDEMPOTENCY_KEY_LENGTH, MAX_RESPONSE_SNIPPET_LENGTH, MAX_FRAME_SNIPPET_LENGTH, } from "./limits.js";
-export type { AuthorKind, PaneEvent, Artifact, ArtifactType, ArtifactVersion, ArtifactRecord, ArtifactSummary, CreateArtifactResponse, KeyInfo, Callback, CreateSessionRequest, CreateSessionResponse, SessionState, EventsPage, RelayError, } from "./types.js";
+export type { AuthorKind, PaneEvent, Artifact, ArtifactType, ArtifactVersion, ArtifactRecord, ArtifactSummary, CreateArtifactResponse, KeyInfo, TasteInfo, Callback, CreateSessionRequest, CreateSessionResponse, SessionState, EventsPage, RelayError, } from "./types.js";

package/dist/types.d.ts

@@ -130,6 +130,18 @@ export interface KeyInfo {
     last_used_at: string | null;
     revoked_at: string | null;
 }
+/**
+ * Response from GET /v1/taste, PUT /v1/taste — the calling agent's freeform
+ * "taste notes" markdown blob (presentation preferences the agent has picked
+ * up from human feedback over time). `taste` and `updated_at` are null when
+ * the agent has never written notes; `bytes` is the utf8 byte length and 0
+ * when `taste` is null.
+ */
+export interface TasteInfo {
+    taste: string | null;
+    updated_at: string | null;
+    bytes: number;
+}
 /** A relay error envelope. */
 export interface RelayError {
     code: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paneui/core",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Pane relay client: typed HTTP + WebSocket operations against a Pane relay. Framework-free.",
   "license": "MIT",
   "type": "module",