@paneui/core 0.0.12 → 0.0.13

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { TemplateRecord, TemplateSummary, TemplateType, TemplateVersion, CreateArtifactResponse, CreatePaneRequest, CreatePaneResponse, EventsPage, FeedbackPage, FeedbackSubmission, FeedbackType, KeyInfo, MintParticipantResponse, PaneEvent, ParticipantsList, SerializedRecord, PaneState, PanesPage, TasteInfo, TrashListResponse } from "./types.js";
+import type { TemplateRecord, TemplateSummary, TemplateType, TemplateVersion, CreateArtifactResponse, CreatePaneRequest, CreatePaneResponse, EventsPage, FeedbackPage, FeedbackSubmission, FeedbackType, KeyInfo, MintParticipantResponse, PaneEvent, ParticipantsList, SerializedRecord, PaneState, PanesPage, TasteInfo, TrashListResponse, UpgradePaneResponse } from "./types.js";
 import type { ListPanesQuery } from "./schemas.js";
 export interface ClientOptions {
     /** Relay base URL, e.g. https://pane.example.com. Trailing slash is trimmed. */
@@ -413,6 +413,28 @@ export declare class PaneClient {
     mintParticipant(paneId: string, opts?: {
         kind?: "human";
     }): Promise<MintParticipantResponse>;
+    /**
+     * POST /v1/panes/:id/upgrade — re-pin a live pane to another version of the
+     * SAME template (#267), swapping its HTML and schemas in place without
+     * minting a new pane (the human keeps the same URL). Events already on disk
+     * are never rewritten — each carries the template version it was authored
+     * under (#268).
+     *
+     * `opts.template_version` defaults to the template head's latest version.
+     * `opts.compat` defaults to `"strict"`: the relay refuses with a 422
+     * `schema_incompatible_upgrade` (its `details.breaks` lists the offending
+     * paths) when the target schema narrows the current one — i.e. when events
+     * written under the old schema would no longer validate. Pass `"force"` to
+     * apply the upgrade anyway, accepting that old events may no longer match
+     * the new schema.
+     *
+     * Returns `{ upgraded: false }` (idempotent no-op) when the pane is already
+     * on the target version.
+     */
+    upgradePane(paneId: string, opts?: {
+        template_version?: number;
+        compat?: "strict" | "force";
+    }): Promise<UpgradePaneResponse>;
     /**
      * DELETE /v1/panes/:id/participants/:participant_id — revoke a single
      * participant URL. The pane's other participants (and the agent's own

package/dist/client.js

@@ -578,6 +578,35 @@ export class PaneClient {
             this.fail(r);
         return this.asObject(r);
     }
+    /**
+     * POST /v1/panes/:id/upgrade — re-pin a live pane to another version of the
+     * SAME template (#267), swapping its HTML and schemas in place without
+     * minting a new pane (the human keeps the same URL). Events already on disk
+     * are never rewritten — each carries the template version it was authored
+     * under (#268).
+     *
+     * `opts.template_version` defaults to the template head's latest version.
+     * `opts.compat` defaults to `"strict"`: the relay refuses with a 422
+     * `schema_incompatible_upgrade` (its `details.breaks` lists the offending
+     * paths) when the target schema narrows the current one — i.e. when events
+     * written under the old schema would no longer validate. Pass `"force"` to
+     * apply the upgrade anyway, accepting that old events may no longer match
+     * the new schema.
+     *
+     * Returns `{ upgraded: false }` (idempotent no-op) when the pane is already
+     * on the target version.
+     */
+    async upgradePane(paneId, opts = {}) {
+        const body = {};
+        if (opts.template_version !== undefined)
+            body["template_version"] = opts.template_version;
+        if (opts.compat !== undefined)
+            body["compat"] = opts.compat;
+        const r = await this.call("POST", `/v1/panes/${encodeURIComponent(paneId)}/upgrade`, body);
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
     /**
      * DELETE /v1/panes/:id/participants/:participant_id — revoke a single
      * participant URL. The pane's other participants (and the agent's own

package/dist/index.d.ts

@@ -9,4 +9,4 @@ export type { CreatePaneInput, ListPanesStatus, ListPanesQuery, MintParticipantI
 export { validateIconEmoji, isValidIconEmoji, isRasterImageMime, RASTER_ICON_MIME_ALLOWLIST, MAX_ICON_EMOJI_BYTES, } from "./icons.js";
 export type { RasterIconMime } from "./icons.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, SerializedRecord, DeletedRecordRef, RecordDeltaMessage, Template, TemplateType, TemplateVersion, TemplateRecord, TemplateSummary, CreateArtifactResponse, KeyInfo, TasteInfo, FeedbackType, FeedbackSubmission, FeedbackRecord, FeedbackPage, Callback, CreatePaneRequest, CreatePaneResponse, PaneState, EventsPage, ParticipantSummary, ParticipantsList, PaneSummary, PanesPage, MintParticipantResponse, TrashedPaneEntry, TrashedTemplateEntry, TrashListResponse, RelayError, } from "./types.js";
+export type { AuthorKind, PaneEvent, SerializedRecord, DeletedRecordRef, RecordDeltaMessage, Template, TemplateType, TemplateVersion, TemplateRecord, TemplateSummary, CreateArtifactResponse, KeyInfo, TasteInfo, FeedbackType, FeedbackSubmission, FeedbackRecord, FeedbackPage, Callback, CreatePaneRequest, CreatePaneResponse, PaneState, EventsPage, ParticipantSummary, ParticipantsList, PaneSummary, PanesPage, MintParticipantResponse, UpgradeBreak, UpgradePaneResponse, TrashedPaneEntry, TrashedTemplateEntry, TrashListResponse, RelayError, } from "./types.js";

package/dist/types.d.ts

@@ -209,6 +209,31 @@ export interface MintParticipantResponse {
     url: string;
     created_at: string;
 }
+/** One break flagged by the schema-compat gate when upgrading a pane to a
+ *  template version whose schema narrows the current one. */
+export interface UpgradeBreak {
+    /** JSON-pointer-ish path to the offending schema location. */
+    path: string;
+    /** Human-readable description of why the change is incompatible. */
+    message: string;
+}
+/** Response from POST /v1/panes/:id/upgrade — the result of re-pinning a live
+ *  pane to another version of the same template (#267). */
+export interface UpgradePaneResponse {
+    pane_id: string;
+    /** The version id the pane now points at. */
+    template_version_id: string;
+    /** Denormalised integer version number the pane now points at. */
+    template_version: number;
+    /** `false` when the pane was already on the target version (idempotent
+     *  no-op); `true` when the re-pin was applied. */
+    upgraded: boolean;
+    /** Schema-compat breaks detected against the target version. Empty on a
+     *  clean upgrade; populated (and applied anyway) on `compat: "force"`. */
+    breaks: UpgradeBreak[];
+    /** The compat mode the upgrade ran under. */
+    compat: "strict" | "force";
+}
 /** One immutable version of an template's content. */
 export interface TemplateVersion {
     id: string;

package/package.json

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