@lotics/cli 0.75.0 → 0.76.1

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+import type { KnowledgeUpgradeEntry, KnowledgeUpgradeResolutions, ContentUpgradeResolutions, ModifiedArtifact, PackageContentBinding } from "@lotics/shared/schemas/packages";
 /**
  * The error message for a non-ok response. A genuine JSON error (a 4xx carrying
  * a `message`) surfaces verbatim; a non-JSON body (a gateway HTML page), any
@@ -89,12 +90,33 @@ export interface PackageBinding {
     roles: Record<string, string>;
     workflows: Record<string, string>;
 }
-/** One finding from a bespoke→package extraction (`extractAppPackage`). */
+/** One finding from a bespoke→package extraction (`extractPackage`). */
 export interface ExtractFinding {
     severity: "error" | "warning" | "info";
     area: string;
     message: string;
 }
+/** A package's kind — a full app blueprint, or a standalone content package. */
+export type PackageKind = "app" | "content";
+/** One workspace's installation of a package's content (the standalone anchor). */
+export interface ContentInstallation {
+    id: string;
+    workspace_id: string;
+    package_id: string;
+    package_version: number;
+    /** Set when the content arrived bundled with an app install; null for a standalone content package. */
+    app_id: string | null;
+    /** The namespaced content binding: `knowledge` (alias → `kdc_` id) + `templates` (alias → `tmpl_` id). */
+    binding: PackageContentBinding;
+    installed_by: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Advisory knowledge warnings surfaced by install/upgrade (never block). */
+export interface KnowledgeWarnings {
+    /** `knowledge_expects` doc names with no matching workspace doc. */
+    missing_expected_docs: string[];
+}
 export declare const API_BASE_URL: string;
 export declare class LoticsClient {
     private apiKey;
@@ -200,6 +222,16 @@ export declare class LoticsClient {
          * through the `context` op for production parity.
          */
         config?: Record<string, string | number | boolean> | null;
+        /** Package registry id this app was installed from; null for a bespoke/ejected app. */
+        package_id?: string | null;
+        /** The installed package version (upgrade pin); null for a bespoke/ejected app. */
+        package_version?: number | null;
+        /**
+         * Package install join — per-namespace alias→id maps (entities/fields/
+         * options/templates/roles) plus the `workflows` artifact registry. Null for
+         * a bespoke app. Used to preview what `package uninstall` will archive.
+         */
+        binding?: Record<string, Record<string, string>> | null;
     }>;
     createApp(body: {
         name: string;
@@ -212,20 +244,128 @@ export declare class LoticsClient {
         current_version_id: string | null;
     }>;
     /**
-     * Install an app package version into the current workspace — scaffolds the
-     * data model, deploys the package bundle, materializes its
-     * queries/workflows/agents, and pins the installation. Returns the resulting
-     * installation app. `version` omitted installs the latest published version.
+     * Install a package version into the current workspace — ONE endpoint,
+     * kind-branched into a discriminated response (`kind`). An `app` package
+     * scaffolds the data model / deploys / materializes and returns the installation
+     * app (+ advisory knowledge warnings); a `content` package installs only its
+     * doc corpus and returns the installation row. `bind_to` (content only)
+     * resolves a name collision by adopting an existing same-named doc as
+     * package-managed. `version` omitted installs the latest published version.
      */
-    installAppPackage(package_id: string, body: {
+    installPackage(package_id: string, body: {
         version?: number;
+        /** Content-kind only: consent to adopt a same-named workspace doc on a knowledge collision. */
+        bind_to?: Record<string, string>;
+        /** App-kind only: per-knob config overrides applied over the contract defaults at install. */
+        config?: Record<string, string | number | boolean>;
+    }): Promise<{
+        kind: "app";
+        app: {
+            id: string;
+            name: string;
+            workspace_id: string;
+            package_id: string | null;
+            package_version: number | null;
+            current_version_id: string | null;
+        };
+        knowledge_warnings: KnowledgeWarnings;
+    } | {
+        kind: "content";
+        installation: ContentInstallation;
+        warnings: KnowledgeWarnings;
+    }>;
+    /**
+     * Uninstall a standalone content package — delete the installation row. By
+     * default the package-bound docs are ARCHIVED; `keep_content` retains them as
+     * ordinary workspace docs. Admin-only. Backs `lotics package uninstall`.
+     */
+    uninstallContentPackage(installation_id: string, opts?: {
+        keep_content?: boolean;
+    }): Promise<{
+        installation_id: string;
+        archived_doc_ids: string[];
+        archived_template_ids: string[];
+        deleted: true;
+    }>;
+    /**
+     * Preview upgrading a standalone content installation — the knowledge namespace's
+     * per-alias `entries` (added/changed/removed/drifted + a `modified` flag) plus the
+     * consent-requiring `templates` (a template the target changed whose live content
+     * was locally edited; a clean one auto-updates and is absent). No writes.
+     * Admin-only.
+     */
+    previewContentInstallationUpgrade(installation_id: string, opts?: {
+        version?: number;
+    }): Promise<{
+        installation_id: string;
+        package_id: string;
+        from_version: number;
+        to_version: number;
+        changelog: string | null;
+        update_available: boolean;
+        entries: KnowledgeUpgradeEntry[];
+        templates: ModifiedArtifact[];
+    }>;
+    /**
+     * Apply a standalone content upgrade — propagate the target version's content per
+     * the resolutions (`knowledge`: a modified change/removal or drift needs consent;
+     * `templates`: a locally-edited changed template takes revert|keep), then advance
+     * the pin + binding. Returns the updated installation row. Admin-only.
+     */
+    applyContentInstallationUpgrade(installation_id: string, body: {
+        version?: number;
+        resolutions?: ContentUpgradeResolutions;
+    }): Promise<ContentInstallation>;
+    /**
+     * List a workspace's package-managed knowledge installations, each folded with
+     * registry status (name, kind, official badge, latest version, update-available).
+     * Member-accessible (workspace-scoped); backs the settings "Managed by" badge.
+     */
+    listContentInstallations(workspace_id: string): Promise<Array<ContentInstallation & {
+        package_registry: {
+            name: string;
+            kind: PackageKind;
+            is_official: boolean;
+            latest_version: number;
+            update_available: boolean;
+        } | null;
+    }>>;
+    /**
+     * Uninstall a package installation (backs `lotics package uninstall`). Does
+     * everything DELETE does plus archives the installation's lifecycle
+     * artifacts; with `archive_tables` it also archives the scaffolded entity
+     * tables — refused server-side unless this installation created them
+     * (provenance) and nothing else references them. Admin-only.
+     */
+    uninstallAppPackage(app_id: string, body: {
+        archive_tables: boolean;
+    }): Promise<{
+        id: string;
+        uninstalled: boolean;
+        archived_table_ids: string[];
+    }>;
+    /**
+     * Partial-merge a package installation's config (backs `lotics package config
+     * --set`). Only the provided keys change; validated against the installed
+     * contract. Returns the full effective config. Admin-only.
+     */
+    updateAppPackageConfig(app_id: string, body: {
+        config: Record<string, string | number | boolean>;
+    }): Promise<{
+        config: Record<string, string | number | boolean>;
+    }>;
+    /**
+     * Retire (or `undo` un-retire) a registry package (backs `lotics package
+     * retire`). Retiring refuses NEW installs and hides the package from
+     * non-owning orgs; existing installations keep working and may still upgrade.
+     * Owner-org admin-only.
+     */
+    retirePackage(package_id: string, body: {
+        undo: boolean;
     }): Promise<{
         id: string;
         name: string;
-        workspace_id: string;
-        package_id: string | null;
-        package_version: number | null;
-        current_version_id: string | null;
+        retired_at: string | null;
     }>;
     /**
      * Eject an installation from its package — re-deploy the pinned version's
@@ -234,7 +374,7 @@ export declare class LoticsClient {
      * app becomes a normal bespoke app and can no longer be upgraded. Returns the
      * resulting app.
      */
-    ejectAppPackage(app_id: string): Promise<{
+    ejectPackage(app_id: string): Promise<{
         id: string;
         name: string;
         workspace_id: string;
@@ -242,7 +382,7 @@ export declare class LoticsClient {
     }>;
     /**
      * Extract a DRAFT app package from an existing bespoke app — the promotion
-     * read (docs/app_packages.md § Promotion). Pure: nothing is written. Returns
+     * read (docs/packages.md § Promotion). Pure: nothing is written. Returns
      * the alias-keyed draft `contract` (opaque to the CLI — the server is the
      * validating authority), the origin workspace's `binding` (which doubles as
      * the adopt binding), a findings `report` (any `error` ⇒ not publishable
@@ -250,7 +390,12 @@ export declare class LoticsClient {
      * project at their `bytes_ref` paths. Backs `lotics package extract`.
      * Admin-only.
      */
-    extractAppPackage(app_id: string): Promise<{
+    extractPackage(app_id: string, opts?: {
+        knowledge?: Array<{
+            alias: string;
+            doc_id: string;
+        }>;
+    }): Promise<{
         contract: unknown;
         binding: PackageBinding;
         report: ExtractFinding[];
@@ -259,6 +404,13 @@ export declare class LoticsClient {
             file_id: string;
             filename: string;
         }>;
+        /** Knowledge doc content to write to `knowledge/<alias>.md` in the draft project. */
+        knowledge_files: Array<{
+            content_ref: string;
+            content: string;
+        }>;
+        /** alias → the origin workspace's kdc_ id (the adopt knowledge binding). */
+        knowledge_binding: Record<string, string>;
     }>;
     /**
      * Adopt a published package onto an EXISTING (bespoke or ejected) app — the
@@ -269,10 +421,12 @@ export declare class LoticsClient {
      * ConflictError names the aliases that diverge. `version` omitted adopts the
      * latest. Backs `lotics package adopt`. Admin-only.
      */
-    adoptAppPackage(app_id: string, body: {
+    adoptPackage(app_id: string, body: {
         package_id: string;
         version?: number;
         binding: PackageBinding;
+        /** alias → this workspace's kdc_ id for the contract's knowledge docs (from extract). */
+        knowledge_binding?: Record<string, string>;
     }): Promise<{
         id: string;
         name: string;
@@ -292,13 +446,13 @@ export declare class LoticsClient {
      * adopts targeting it; pinned installations keep running. Owner-org
      * admin-only. Backs `lotics package yank`.
      */
-    yankAppPackageVersion(package_id: string, version: number, yanked: boolean): Promise<{
+    yankPackageVersion(package_id: string, version: number, yanked: boolean): Promise<{
         package_id: string;
         version: number;
         yanked_at: string | null;
         latest_version: number;
     }>;
-    fleetUpgradeAppPackage(package_id: string, body: {
+    fleetUpgradePackage(package_id: string, body: {
         version?: number;
     }): Promise<{
         package_id: string;
@@ -324,31 +478,48 @@ export declare class LoticsClient {
      * local manifest has no `package_id`), then publishes version 1 against the
      * returned id. Admin-only.
      */
-    createAppPackage(body: {
+    createPackage(body: {
         name: string;
         description?: string | null;
+        /** 'app' (default) | 'content'. Immutable after create. */
+        kind?: PackageKind;
     }): Promise<{
         id: string;
         name: string;
         description: string | null;
+        kind: PackageKind;
         latest_version: number;
         is_official: boolean;
         created_at: string;
         updated_at: string;
     }>;
     /**
-     * Fetch a registry app package's metadata (incl. `latest_version` and the
-     * Lotics-backed `is_official` trust badge). Admin-only; cross-tenant by id.
+     * Fetch a registry app package's metadata (incl. `kind`, `latest_version` and
+     * the Lotics-backed `is_official` trust badge). Admin-only; cross-tenant by id.
      */
-    getAppPackage(package_id: string): Promise<{
+    getPackage(package_id: string): Promise<{
         id: string;
         name: string;
         description: string | null;
+        kind: PackageKind;
         latest_version: number;
         is_official: boolean;
+        retired_at: string | null;
+        /** Absent from a pre-deploy server — treat undefined as not-owned (the badge under-claims, never over-claims). */
+        owned_by_caller?: boolean;
         created_at: string;
         updated_at: string;
     }>;
+    /** Version history newest-first (no contract payloads) — backs `lotics package show`. Admin-only. */
+    listPackageVersions(package_id: string): Promise<{
+        versions: Array<{
+            version: number;
+            changelog: string | null;
+            channel: "release" | "dev";
+            yanked_at: string | null;
+            created_at: string;
+        }>;
+    }>;
     /**
      * Publish a new immutable package version — multipart upload of the alias-keyed
      * contract (JSON) + the prebuilt code bundle (a gzipped tarball carrying
@@ -356,10 +527,12 @@ export declare class LoticsClient {
      * bundle, then allocates the next monotonic version. The `contract` is opaque
      * JSON to the transport (the server is the validating authority). Admin-only.
      */
-    publishAppPackageVersion(package_id: string, args: {
+    publishPackageVersion(package_id: string, args: {
         contract: unknown;
         bundle: Buffer;
         changelog?: string | null;
+        /** 'dev' = dev-loop publish: pinned by the dev installation, never the installable latest. */
+        channel?: "release" | "dev";
     }): Promise<{
         id: string;
         package_id: string;
@@ -375,7 +548,7 @@ export declare class LoticsClient {
      * package artifacts, and bumps the pin. `version` omitted upgrades to the
      * latest. Returns the resulting app. Admin-only.
      */
-    upgradeAppPackage(app_id: string, body: {
+    upgradePackage(app_id: string, body: {
         version?: number;
         /**
          * Per preview finding: drifted binding entries (`<namespace>.<alias>`)
@@ -386,6 +559,13 @@ export declare class LoticsClient {
         resolutions?: Record<string, "recreate" | "revert" | "keep" | {
             bind_to: string;
         }>;
+        /**
+         * Per bundled-knowledge finding: a consent resolution
+         * (`apply`/`keep`/`archive`/`recreate`/`unbind`) per alias + `bind_to`
+         * consents for added-doc name collisions. Consent-requiring docs left
+         * unresolved refuse the upgrade; unmodified changes apply automatically.
+         */
+        knowledge_resolutions?: KnowledgeUpgradeResolutions;
     }): Promise<{
         id: string;
         name: string;
@@ -399,7 +579,7 @@ export declare class LoticsClient {
      * breaking contract changes, the binding drift report, and the modified-core
      * report — with no writes. Admin-only.
      */
-    previewAppPackageUpgrade(app_id: string, opts?: {
+    previewPackageUpgrade(app_id: string, opts?: {
         version?: number;
     }): Promise<{
         app_id: string;
@@ -417,6 +597,9 @@ export declare class LoticsClient {
                 from: string;
                 to: string;
             }>;
+            changed: {
+                templates: string[];
+            };
         };
         drift: Array<{
             namespace: string;
@@ -426,14 +609,21 @@ export declare class LoticsClient {
         modified: Array<{
             kind: string;
             alias: string;
+            baseline_unknown?: boolean;
         }>;
+        /**
+         * Bundled package-managed knowledge docs the version bump adds/changes/
+         * removes/drifts — the app-install analogue of a standalone knowledge
+         * upgrade's `entries`. Consent-requiring docs resolve via `knowledge_resolutions`.
+         */
+        knowledge: KnowledgeUpgradeEntry[];
     }>;
     /**
      * Re-bind a package role to a different workspace group (the current group
      * still exists). Re-materializes at the pinned version; refuses over
      * modified-core findings. Admin-only.
      */
-    rebindAppPackageRole(app_id: string, body: {
+    rebindPackageRole(app_id: string, body: {
         role_alias: string;
         group_id: string;
     }): Promise<{
@@ -461,7 +651,7 @@ export declare class LoticsClient {
      * binding drift, and locally modified core artifacts. Read-only; backs
      * `lotics package doctor`. Admin-only.
      */
-    getAppPackageHealth(app_id: string): Promise<{
+    getPackageHealth(app_id: string): Promise<{
         app_id: string;
         package_id: string;
         package_name: string;
@@ -477,6 +667,20 @@ export declare class LoticsClient {
             kind: string;
             alias: string;
         }>;
+        /** Package-managed knowledge docs whose bound id no longer resolves (recreate/unbind at upgrade). */
+        knowledge_drift: Array<{
+            alias: string;
+            name: string;
+            doc_id: string | null;
+        }>;
+        /** Package-managed knowledge docs the workspace edited since install (apply/keep at upgrade). */
+        knowledge_modified: Array<{
+            alias: string;
+            name: string;
+            doc_id: string | null;
+        }>;
+        /** `knowledge_expects` names the package's agents route to but it does not own (advisory). */
+        missing_expected_docs: string[];
     }>;
     /**
      * Reset a package installation in a DEV workspace — drop the package-owned
@@ -484,7 +688,7 @@ export declare class LoticsClient {
      * workspaces (a non-dev workspace is refused). Returns the resulting app.
      * Admin-only.
      */
-    resetAppPackage(app_id: string): Promise<{
+    resetPackage(app_id: string): Promise<{
         id: string;
         name: string;
         workspace_id: string;

package/dist/client.js

@@ -204,13 +204,80 @@ export class LoticsClient {
         return this.request("POST", "/v1/apps", body);
     }
     /**
-     * Install an app package version into the current workspace — scaffolds the
-     * data model, deploys the package bundle, materializes its
-     * queries/workflows/agents, and pins the installation. Returns the resulting
-     * installation app. `version` omitted installs the latest published version.
+     * Install a package version into the current workspace — ONE endpoint,
+     * kind-branched into a discriminated response (`kind`). An `app` package
+     * scaffolds the data model / deploys / materializes and returns the installation
+     * app (+ advisory knowledge warnings); a `content` package installs only its
+     * doc corpus and returns the installation row. `bind_to` (content only)
+     * resolves a name collision by adopting an existing same-named doc as
+     * package-managed. `version` omitted installs the latest published version.
      */
-    async installAppPackage(package_id, body) {
-        return this.request("POST", `/v1/app-packages/${encodeURIComponent(package_id)}/installations`, body);
+    async installPackage(package_id, body) {
+        return this.request("POST", `/v1/packages/${encodeURIComponent(package_id)}/installations`, body);
+    }
+    /**
+     * Uninstall a standalone content package — delete the installation row. By
+     * default the package-bound docs are ARCHIVED; `keep_content` retains them as
+     * ordinary workspace docs. Admin-only. Backs `lotics package uninstall`.
+     */
+    async uninstallContentPackage(installation_id, opts = {}) {
+        const qs = opts.keep_content ? "?keep_content=true" : "";
+        return this.request("DELETE", `/v1/content-installations/${encodeURIComponent(installation_id)}${qs}`);
+    }
+    /**
+     * Preview upgrading a standalone content installation — the knowledge namespace's
+     * per-alias `entries` (added/changed/removed/drifted + a `modified` flag) plus the
+     * consent-requiring `templates` (a template the target changed whose live content
+     * was locally edited; a clean one auto-updates and is absent). No writes.
+     * Admin-only.
+     */
+    async previewContentInstallationUpgrade(installation_id, opts = {}) {
+        const qs = opts.version !== undefined ? `?version=${opts.version}` : "";
+        return this.request("GET", `/v1/content-installations/${encodeURIComponent(installation_id)}/upgrade${qs}`);
+    }
+    /**
+     * Apply a standalone content upgrade — propagate the target version's content per
+     * the resolutions (`knowledge`: a modified change/removal or drift needs consent;
+     * `templates`: a locally-edited changed template takes revert|keep), then advance
+     * the pin + binding. Returns the updated installation row. Admin-only.
+     */
+    async applyContentInstallationUpgrade(installation_id, body) {
+        return this.request("POST", `/v1/content-installations/${encodeURIComponent(installation_id)}/upgrade`, body);
+    }
+    /**
+     * List a workspace's package-managed knowledge installations, each folded with
+     * registry status (name, kind, official badge, latest version, update-available).
+     * Member-accessible (workspace-scoped); backs the settings "Managed by" badge.
+     */
+    async listContentInstallations(workspace_id) {
+        return this.request("GET", `/v1/workspaces/${encodeURIComponent(workspace_id)}/content-installations`);
+    }
+    /**
+     * Uninstall a package installation (backs `lotics package uninstall`). Does
+     * everything DELETE does plus archives the installation's lifecycle
+     * artifacts; with `archive_tables` it also archives the scaffolded entity
+     * tables — refused server-side unless this installation created them
+     * (provenance) and nothing else references them. Admin-only.
+     */
+    async uninstallAppPackage(app_id, body) {
+        return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/uninstall`, body);
+    }
+    /**
+     * Partial-merge a package installation's config (backs `lotics package config
+     * --set`). Only the provided keys change; validated against the installed
+     * contract. Returns the full effective config. Admin-only.
+     */
+    async updateAppPackageConfig(app_id, body) {
+        return this.request("PATCH", `/v1/apps/${encodeURIComponent(app_id)}/package-config`, body);
+    }
+    /**
+     * Retire (or `undo` un-retire) a registry package (backs `lotics package
+     * retire`). Retiring refuses NEW installs and hides the package from
+     * non-owning orgs; existing installations keep working and may still upgrade.
+     * Owner-org admin-only.
+     */
+    async retirePackage(package_id, body) {
+        return this.request("POST", `/v1/packages/${encodeURIComponent(package_id)}/retire`, body);
     }
     /**
      * Eject an installation from its package — re-deploy the pinned version's
@@ -219,12 +286,12 @@ export class LoticsClient {
      * app becomes a normal bespoke app and can no longer be upgraded. Returns the
      * resulting app.
      */
-    async ejectAppPackage(app_id) {
+    async ejectPackage(app_id) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/eject`);
     }
     /**
      * Extract a DRAFT app package from an existing bespoke app — the promotion
-     * read (docs/app_packages.md § Promotion). Pure: nothing is written. Returns
+     * read (docs/packages.md § Promotion). Pure: nothing is written. Returns
      * the alias-keyed draft `contract` (opaque to the CLI — the server is the
      * validating authority), the origin workspace's `binding` (which doubles as
      * the adopt binding), a findings `report` (any `error` ⇒ not publishable
@@ -232,8 +299,13 @@ export class LoticsClient {
      * project at their `bytes_ref` paths. Backs `lotics package extract`.
      * Admin-only.
      */
-    async extractAppPackage(app_id) {
-        return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/package-extract`);
+    async extractPackage(app_id, opts = {}) {
+        // The knowledge declaration ([{alias, doc_id}]) rides as a JSON-string query
+        // param — extract stays a GET (a pure read); the server validates it.
+        const qs = opts.knowledge && opts.knowledge.length > 0
+            ? `?knowledge=${encodeURIComponent(JSON.stringify(opts.knowledge))}`
+            : "";
+        return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/package-extract${qs}`);
     }
     /**
      * Adopt a published package onto an EXISTING (bespoke or ejected) app — the
@@ -244,7 +316,7 @@ export class LoticsClient {
      * ConflictError names the aliases that diverge. `version` omitted adopts the
      * latest. Backs `lotics package adopt`. Admin-only.
      */
-    async adoptAppPackage(app_id, body) {
+    async adoptPackage(app_id, body) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/package-adopt`, body);
     }
     /**
@@ -260,11 +332,11 @@ export class LoticsClient {
      * adopts targeting it; pinned installations keep running. Owner-org
      * admin-only. Backs `lotics package yank`.
      */
-    async yankAppPackageVersion(package_id, version, yanked) {
-        return this.request("POST", `/v1/app-packages/${encodeURIComponent(package_id)}/versions/${version}/yank`, { yanked });
+    async yankPackageVersion(package_id, version, yanked) {
+        return this.request("POST", `/v1/packages/${encodeURIComponent(package_id)}/versions/${version}/yank`, { yanked });
     }
-    async fleetUpgradeAppPackage(package_id, body) {
-        return this.request("POST", `/v1/app-packages/${encodeURIComponent(package_id)}/fleet-upgrade`, body);
+    async fleetUpgradePackage(package_id, body) {
+        return this.request("POST", `/v1/packages/${encodeURIComponent(package_id)}/fleet-upgrade`, body);
     }
     // --- App packages (registry authoring + dev harness) ---
     /**
@@ -273,15 +345,19 @@ export class LoticsClient {
      * local manifest has no `package_id`), then publishes version 1 against the
      * returned id. Admin-only.
      */
-    async createAppPackage(body) {
-        return this.request("POST", "/v1/app-packages", body);
+    async createPackage(body) {
+        return this.request("POST", "/v1/packages", body);
     }
     /**
-     * Fetch a registry app package's metadata (incl. `latest_version` and the
-     * Lotics-backed `is_official` trust badge). Admin-only; cross-tenant by id.
+     * Fetch a registry app package's metadata (incl. `kind`, `latest_version` and
+     * the Lotics-backed `is_official` trust badge). Admin-only; cross-tenant by id.
      */
-    async getAppPackage(package_id) {
-        return this.request("GET", `/v1/app-packages/${encodeURIComponent(package_id)}`);
+    async getPackage(package_id) {
+        return this.request("GET", `/v1/packages/${encodeURIComponent(package_id)}`);
+    }
+    /** Version history newest-first (no contract payloads) — backs `lotics package show`. Admin-only. */
+    async listPackageVersions(package_id) {
+        return this.request("GET", `/v1/packages/${encodeURIComponent(package_id)}/versions`);
     }
     /**
      * Publish a new immutable package version — multipart upload of the alias-keyed
@@ -290,13 +366,15 @@ export class LoticsClient {
      * bundle, then allocates the next monotonic version. The `contract` is opaque
      * JSON to the transport (the server is the validating authority). Admin-only.
      */
-    async publishAppPackageVersion(package_id, args) {
+    async publishPackageVersion(package_id, args) {
         const formData = new FormData();
         formData.append("contract", JSON.stringify(args.contract));
         formData.append("bundle", new Blob([new Uint8Array(args.bundle)], { type: "application/gzip" }), "bundle.tar.gz");
         if (args.changelog)
             formData.append("changelog", args.changelog);
-        const url = `${this.baseUrl}/v1/app-packages/${encodeURIComponent(package_id)}/versions`;
+        if (args.channel)
+            formData.append("channel", args.channel);
+        const url = `${this.baseUrl}/v1/packages/${encodeURIComponent(package_id)}/versions`;
         const response = await fetch(url, {
             method: "POST",
             headers: this.buildHeaders(), // no Content-Type — fetch sets the multipart boundary
@@ -313,7 +391,7 @@ export class LoticsClient {
      * package artifacts, and bumps the pin. `version` omitted upgrades to the
      * latest. Returns the resulting app. Admin-only.
      */
-    async upgradeAppPackage(app_id, body) {
+    async upgradePackage(app_id, body) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/package-upgrade`, body);
     }
     /**
@@ -321,7 +399,7 @@ export class LoticsClient {
      * breaking contract changes, the binding drift report, and the modified-core
      * report — with no writes. Admin-only.
      */
-    async previewAppPackageUpgrade(app_id, opts = {}) {
+    async previewPackageUpgrade(app_id, opts = {}) {
         const query = opts.version !== undefined ? `?version=${opts.version}` : "";
         return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/package-upgrade${query}`);
     }
@@ -330,7 +408,7 @@ export class LoticsClient {
      * still exists). Re-materializes at the pinned version; refuses over
      * modified-core findings. Admin-only.
      */
-    async rebindAppPackageRole(app_id, body) {
+    async rebindPackageRole(app_id, body) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/package-rebind-role`, body);
     }
     /**
@@ -346,7 +424,7 @@ export class LoticsClient {
      * binding drift, and locally modified core artifacts. Read-only; backs
      * `lotics package doctor`. Admin-only.
      */
-    async getAppPackageHealth(app_id) {
+    async getPackageHealth(app_id) {
         return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/package-health`);
     }
     /**
@@ -355,7 +433,7 @@ export class LoticsClient {
      * workspaces (a non-dev workspace is refused). Returns the resulting app.
      * Admin-only.
      */
-    async resetAppPackage(app_id) {
+    async resetPackage(app_id) {
         return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/package-reset`);
     }
     /**