@nodaro/sdk 2.28.0 → 2.31.0

package/dist/entries/organizations.d.cts

@@ -0,0 +1,164 @@
+import { OrgKind, OrgSettings, WorkspaceRole, InvitationState, OrganizationView, OrgPage, OrgMemberView, MemberStatus, InvitationDelivery, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry } from '@nodaro/shared/organizations';
+export { InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, MeOrganizations, MemberStatus, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, WORKSPACE_HEADER, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared/organizations';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+
+/**
+ * Organizations, their members, and the invitations that fill them.
+ *
+ * Every shape here comes from `@nodaro/shared` rather than being restated:
+ * the app, the CLI and this SDK all read the same wire, and a shape written
+ * out three times is one that drifts in two of them.
+ *
+ * Nothing in this file decides anything. Whether a caller may invite, remove
+ * or rename is the server's answer, delivered as a typed error code, and an
+ * SDK that guessed would be wrong the first time a setting changed.
+ */
+interface CreateOrgInput {
+    name: string;
+    kind: OrgKind;
+    /** Derived from the name when omitted; the server resolves collisions. */
+    slug?: string;
+    acceptTerms?: boolean;
+    settings?: OrgSettings;
+}
+interface InviteInput {
+    emails: string[];
+    orgRole?: "admin" | "member";
+    /** Also places the invitee in this workspace on accept. */
+    workspaceId?: string;
+    workspaceRole?: WorkspaceRole;
+}
+interface ListInvitationsOptions {
+    status?: InvitationState;
+    workspaceId?: string;
+    cursor?: string;
+    limit?: number;
+}
+declare class OrganizationsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** The organizations this account belongs to. */
+    list(): Promise<{
+        data: OrganizationView[];
+    }>;
+    get(id: string): Promise<{
+        data: OrganizationView;
+    }>;
+    /**
+     * Create an organization. On instances that require it, `acceptTerms` must
+     * be true or the server answers `terms_required` — the SDK does not decide
+     * whether terms apply, because only the instance knows.
+     *
+     * A new organization may come back `pending`: some instances hold new
+     * organizations for a platform admin to approve, and a pending one grants
+     * nothing until it is active.
+     */
+    create(input: CreateOrgInput): Promise<{
+        data: OrganizationView;
+    }>;
+    update(id: string, input: {
+        name?: string;
+        settings?: OrgSettings;
+    }): Promise<{
+        data: OrganizationView;
+    }>;
+    /** Soft-delete. The organization stops granting context; nothing is destroyed. */
+    delete(id: string): Promise<{
+        data: {
+            id: string;
+            status: string;
+        };
+    }>;
+    /** Hand the organization to another member. The caller becomes an admin. */
+    transferOwnership(id: string, userId: string): Promise<{
+        data: {
+            orgId: string;
+            ownerUserId: string;
+        };
+    }>;
+    /** Leave. An owner cannot — transfer ownership first (`owner_cannot_leave`). */
+    leave(id: string): Promise<{
+        data: {
+            orgId: string;
+            left: boolean;
+        };
+    }>;
+    listMembers(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgMemberView>>;
+    updateMember(orgId: string, userId: string, input: {
+        role?: "admin" | "member";
+        status?: MemberStatus;
+    }): Promise<{
+        data: OrgMemberView;
+    }>;
+    removeMember(orgId: string, userId: string): Promise<{
+        data: {
+            removed: boolean;
+        };
+    }>;
+    /**
+     * Invite by email. Returns ONE ROW PER ADDRESS, and a row whose `status` is
+     * not `sent` carries a `link` instead.
+     *
+     * Surface that link. An install with no mail provider — every fresh
+     * self-host — delivers nothing, and an integration that reports "invited"
+     * without showing the link creates invitations nobody can ever reach.
+     */
+    invite(orgId: string, input: InviteInput): Promise<{
+        data: InvitationDelivery[];
+    }>;
+    listInvitations(orgId: string, opts?: ListInvitationsOptions): Promise<OrgPage<InvitationView>>;
+    revokeInvitation(id: string): Promise<{
+        data: {
+            id: string;
+            revoked: boolean;
+        };
+    }>;
+    resendInvitation(id: string): Promise<{
+        data: InvitationDelivery & {
+            id: string;
+        };
+    }>;
+    /**
+     * What an invitee sees before signing in — the one organization read that
+     * needs no token, so it works while the recipient is still signed out.
+     */
+    previewInvitation(token: string): Promise<{
+        data: InvitationPreview;
+    }>;
+    /** Accept. Requires an authenticated caller whose email matches the invite. */
+    acceptInvitation(token: string): Promise<{
+        data: {
+            orgId: string;
+            workspaceId: string | null;
+        };
+    }>;
+    /**
+     * The organization's audit log, newest first. Owner and admins only, and
+     * readable while the organization is suspended — the record of what
+     * happened is exactly what someone needs when things have gone wrong.
+     */
+    audit(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgAuditEntry>>;
+    /**
+     * Credits by workspace, member, model or day. Owner and org admins only.
+     * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
+     * (default last 30).
+     */
+    usage(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit" | "groupBy"> & {
+        groupBy?: "workspace" | "member" | "model" | "day";
+    }): Promise<{
+        data: UsageReport;
+    }>;
+    /** The individual runs behind a report, newest first, cursor-paged. */
+    usageRows(orgId: string, opts?: Omit<UsageQuery, "groupBy">): Promise<OrgPage<UsageLogEntry>>;
+    /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+    usageCsv(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit">): Promise<string>;
+}
+
+export { type CreateOrgInput, type InviteInput, type ListInvitationsOptions, OrganizationsResource };

package/dist/entries/organizations.d.ts

@@ -0,0 +1,164 @@
+import { OrgKind, OrgSettings, WorkspaceRole, InvitationState, OrganizationView, OrgPage, OrgMemberView, MemberStatus, InvitationDelivery, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry } from '@nodaro/shared/organizations';
+export { InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, MeOrganizations, MemberStatus, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, WORKSPACE_HEADER, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared/organizations';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+
+/**
+ * Organizations, their members, and the invitations that fill them.
+ *
+ * Every shape here comes from `@nodaro/shared` rather than being restated:
+ * the app, the CLI and this SDK all read the same wire, and a shape written
+ * out three times is one that drifts in two of them.
+ *
+ * Nothing in this file decides anything. Whether a caller may invite, remove
+ * or rename is the server's answer, delivered as a typed error code, and an
+ * SDK that guessed would be wrong the first time a setting changed.
+ */
+interface CreateOrgInput {
+    name: string;
+    kind: OrgKind;
+    /** Derived from the name when omitted; the server resolves collisions. */
+    slug?: string;
+    acceptTerms?: boolean;
+    settings?: OrgSettings;
+}
+interface InviteInput {
+    emails: string[];
+    orgRole?: "admin" | "member";
+    /** Also places the invitee in this workspace on accept. */
+    workspaceId?: string;
+    workspaceRole?: WorkspaceRole;
+}
+interface ListInvitationsOptions {
+    status?: InvitationState;
+    workspaceId?: string;
+    cursor?: string;
+    limit?: number;
+}
+declare class OrganizationsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** The organizations this account belongs to. */
+    list(): Promise<{
+        data: OrganizationView[];
+    }>;
+    get(id: string): Promise<{
+        data: OrganizationView;
+    }>;
+    /**
+     * Create an organization. On instances that require it, `acceptTerms` must
+     * be true or the server answers `terms_required` — the SDK does not decide
+     * whether terms apply, because only the instance knows.
+     *
+     * A new organization may come back `pending`: some instances hold new
+     * organizations for a platform admin to approve, and a pending one grants
+     * nothing until it is active.
+     */
+    create(input: CreateOrgInput): Promise<{
+        data: OrganizationView;
+    }>;
+    update(id: string, input: {
+        name?: string;
+        settings?: OrgSettings;
+    }): Promise<{
+        data: OrganizationView;
+    }>;
+    /** Soft-delete. The organization stops granting context; nothing is destroyed. */
+    delete(id: string): Promise<{
+        data: {
+            id: string;
+            status: string;
+        };
+    }>;
+    /** Hand the organization to another member. The caller becomes an admin. */
+    transferOwnership(id: string, userId: string): Promise<{
+        data: {
+            orgId: string;
+            ownerUserId: string;
+        };
+    }>;
+    /** Leave. An owner cannot — transfer ownership first (`owner_cannot_leave`). */
+    leave(id: string): Promise<{
+        data: {
+            orgId: string;
+            left: boolean;
+        };
+    }>;
+    listMembers(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgMemberView>>;
+    updateMember(orgId: string, userId: string, input: {
+        role?: "admin" | "member";
+        status?: MemberStatus;
+    }): Promise<{
+        data: OrgMemberView;
+    }>;
+    removeMember(orgId: string, userId: string): Promise<{
+        data: {
+            removed: boolean;
+        };
+    }>;
+    /**
+     * Invite by email. Returns ONE ROW PER ADDRESS, and a row whose `status` is
+     * not `sent` carries a `link` instead.
+     *
+     * Surface that link. An install with no mail provider — every fresh
+     * self-host — delivers nothing, and an integration that reports "invited"
+     * without showing the link creates invitations nobody can ever reach.
+     */
+    invite(orgId: string, input: InviteInput): Promise<{
+        data: InvitationDelivery[];
+    }>;
+    listInvitations(orgId: string, opts?: ListInvitationsOptions): Promise<OrgPage<InvitationView>>;
+    revokeInvitation(id: string): Promise<{
+        data: {
+            id: string;
+            revoked: boolean;
+        };
+    }>;
+    resendInvitation(id: string): Promise<{
+        data: InvitationDelivery & {
+            id: string;
+        };
+    }>;
+    /**
+     * What an invitee sees before signing in — the one organization read that
+     * needs no token, so it works while the recipient is still signed out.
+     */
+    previewInvitation(token: string): Promise<{
+        data: InvitationPreview;
+    }>;
+    /** Accept. Requires an authenticated caller whose email matches the invite. */
+    acceptInvitation(token: string): Promise<{
+        data: {
+            orgId: string;
+            workspaceId: string | null;
+        };
+    }>;
+    /**
+     * The organization's audit log, newest first. Owner and admins only, and
+     * readable while the organization is suspended — the record of what
+     * happened is exactly what someone needs when things have gone wrong.
+     */
+    audit(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgAuditEntry>>;
+    /**
+     * Credits by workspace, member, model or day. Owner and org admins only.
+     * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
+     * (default last 30).
+     */
+    usage(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit" | "groupBy"> & {
+        groupBy?: "workspace" | "member" | "model" | "day";
+    }): Promise<{
+        data: UsageReport;
+    }>;
+    /** The individual runs behind a report, newest first, cursor-paged. */
+    usageRows(orgId: string, opts?: Omit<UsageQuery, "groupBy">): Promise<OrgPage<UsageLogEntry>>;
+    /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+    usageCsv(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit">): Promise<string>;
+}
+
+export { type CreateOrgInput, type InviteInput, type ListInvitationsOptions, OrganizationsResource };

package/dist/entries/organizations.js

@@ -0,0 +1,4 @@
+export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from '../chunk-RKVRCNMB.js';
+export { OrganizationsResource } from '../chunk-ALSLZG3U.js';
+//# sourceMappingURL=organizations.js.map
+//# sourceMappingURL=organizations.js.map

package/dist/entries/organizations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"organizations.js"}

package/dist/entries/palettes.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+require('../chunk-LLNNHLCE.cjs');
+var chunkNBVARNVA_cjs = require('../chunk-NBVARNVA.cjs');
+
+
+
+Object.defineProperty(exports, "PALETTE_DIRECTION_PREFIX", {
+  enumerable: true,
+  get: function () { return chunkNBVARNVA_cjs.PALETTE_DIRECTION_PREFIX; }
+});
+Object.defineProperty(exports, "PalettesResource", {
+  enumerable: true,
+  get: function () { return chunkNBVARNVA_cjs.PalettesResource; }
+});
+Object.defineProperty(exports, "paletteDirectionId", {
+  enumerable: true,
+  get: function () { return chunkNBVARNVA_cjs.paletteDirectionId; }
+});
+//# sourceMappingURL=palettes.cjs.map
+//# sourceMappingURL=palettes.cjs.map

package/dist/entries/palettes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"palettes.cjs"}

package/dist/entries/palettes.d.cts

@@ -0,0 +1,69 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/** One of your colour palettes. */
+interface ColorPalette {
+    id: string;
+    name: string;
+    /** 2–12 colours, `#RRGGBB`, upper case. */
+    colors: string[];
+    /** Your own note. It is not put into the prompt. */
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreatePaletteInput {
+    /** 1–80 characters. */
+    name: string;
+    /** 2–12 colours, `#RRGGBB` (any case; stored upper case). */
+    colors: string[];
+    /** Up to 500 characters. */
+    description?: string | null;
+}
+/** Only the fields you send are written; `description: null` clears it. */
+interface UpdatePaletteInput {
+    name?: string;
+    colors?: string[];
+    description?: string | null;
+}
+interface ListPalettesParams {
+    /** Page size, 1–100 (server default 50). */
+    limit?: number;
+    /** The previous page's `nextCursor`. */
+    cursor?: string;
+}
+interface PalettePage {
+    data: ColorPalette[];
+    /** Pass back as `cursor` for the next page; `null` on the last one. */
+    nextCursor: string | null;
+}
+/** The prefix of a palette's generate-image direction id (`direction.colorLook`). */
+declare const PALETTE_DIRECTION_PREFIX: "palette:";
+/**
+ * A palette as a generate-image direction value — put it on
+ * `direction.colorLook`. The run names each colour (an everyday name and its
+ * hex) in the prompt; the job keeps the id, so a re-run uses the palette as it
+ * is then.
+ */
+declare function paletteDirectionId(id: string): `palette:${string}`;
+/**
+ * Colour palettes — `GET/POST /v1/palettes`, `GET/PATCH/DELETE /v1/palettes/:id`.
+ *
+ * Yours only (another person's id answers 404). Use one on generate-image as
+ * `direction: { colorLook: paletteDirectionId(id) }`. OAuth app tokens need
+ * `assets:read` for reads and `assets:write` for writes.
+ */
+declare class PalettesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Your palettes, newest first. Page with `nextCursor`. */
+    list(params?: ListPalettesParams): Promise<PalettePage>;
+    get(id: string): Promise<ColorPalette>;
+    create(input: CreatePaletteInput): Promise<ColorPalette>;
+    update(id: string, input: UpdatePaletteInput): Promise<ColorPalette>;
+    /** A run that still names the palette answers 404 `direction_not_found`. */
+    delete(id: string): Promise<void>;
+}
+
+export { type ColorPalette, type CreatePaletteInput, type ListPalettesParams, PALETTE_DIRECTION_PREFIX, type PalettePage, PalettesResource, type UpdatePaletteInput, paletteDirectionId };

package/dist/entries/palettes.d.ts

@@ -0,0 +1,69 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/** One of your colour palettes. */
+interface ColorPalette {
+    id: string;
+    name: string;
+    /** 2–12 colours, `#RRGGBB`, upper case. */
+    colors: string[];
+    /** Your own note. It is not put into the prompt. */
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreatePaletteInput {
+    /** 1–80 characters. */
+    name: string;
+    /** 2–12 colours, `#RRGGBB` (any case; stored upper case). */
+    colors: string[];
+    /** Up to 500 characters. */
+    description?: string | null;
+}
+/** Only the fields you send are written; `description: null` clears it. */
+interface UpdatePaletteInput {
+    name?: string;
+    colors?: string[];
+    description?: string | null;
+}
+interface ListPalettesParams {
+    /** Page size, 1–100 (server default 50). */
+    limit?: number;
+    /** The previous page's `nextCursor`. */
+    cursor?: string;
+}
+interface PalettePage {
+    data: ColorPalette[];
+    /** Pass back as `cursor` for the next page; `null` on the last one. */
+    nextCursor: string | null;
+}
+/** The prefix of a palette's generate-image direction id (`direction.colorLook`). */
+declare const PALETTE_DIRECTION_PREFIX: "palette:";
+/**
+ * A palette as a generate-image direction value — put it on
+ * `direction.colorLook`. The run names each colour (an everyday name and its
+ * hex) in the prompt; the job keeps the id, so a re-run uses the palette as it
+ * is then.
+ */
+declare function paletteDirectionId(id: string): `palette:${string}`;
+/**
+ * Colour palettes — `GET/POST /v1/palettes`, `GET/PATCH/DELETE /v1/palettes/:id`.
+ *
+ * Yours only (another person's id answers 404). Use one on generate-image as
+ * `direction: { colorLook: paletteDirectionId(id) }`. OAuth app tokens need
+ * `assets:read` for reads and `assets:write` for writes.
+ */
+declare class PalettesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Your palettes, newest first. Page with `nextCursor`. */
+    list(params?: ListPalettesParams): Promise<PalettePage>;
+    get(id: string): Promise<ColorPalette>;
+    create(input: CreatePaletteInput): Promise<ColorPalette>;
+    update(id: string, input: UpdatePaletteInput): Promise<ColorPalette>;
+    /** A run that still names the palette answers 404 `direction_not_found`. */
+    delete(id: string): Promise<void>;
+}
+
+export { type ColorPalette, type CreatePaletteInput, type ListPalettesParams, PALETTE_DIRECTION_PREFIX, type PalettePage, PalettesResource, type UpdatePaletteInput, paletteDirectionId };

package/dist/entries/palettes.js

@@ -0,0 +1,4 @@
+import '../chunk-HLHR3R4P.js';
+export { PALETTE_DIRECTION_PREFIX, PalettesResource, paletteDirectionId } from '../chunk-WEQWU2IC.js';
+//# sourceMappingURL=palettes.js.map
+//# sourceMappingURL=palettes.js.map

package/dist/entries/palettes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"palettes.js"}

package/dist/entries/picker-catalogs.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-7MYKT2L4.cjs');
+var chunkOSX2GVZ2_cjs = require('../chunk-OSX2GVZ2.cjs');
+
+
+
+Object.defineProperty(exports, "PickerCatalogsResource", {
+  enumerable: true,
+  get: function () { return chunkOSX2GVZ2_cjs.PickerCatalogsResource; }
+});
+//# sourceMappingURL=picker-catalogs.cjs.map
+//# sourceMappingURL=picker-catalogs.cjs.map

package/dist/entries/picker-catalogs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"picker-catalogs.cjs"}

package/dist/entries/picker-catalogs.d.cts

@@ -0,0 +1,148 @@
+import { CharacterMotionMetadata } from '@nodaro/shared/types';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Picker-catalog types. Mirrors `@nodaro/shared`'s `ProjectedPickerCatalog` /
+ * `PickerCatalogSummary` so the SDK stays dependency-free (same convention as
+ * `NodeDescriptor` mirroring node-registry).
+ */
+interface PickerOption {
+    id: string;
+    label: string;
+    description?: string;
+    category?: string;
+    /** The prompt fragment this id injects downstream. Present only when detail="full". */
+    promptHint?: string;
+    /**
+     * Short professional term injected by compact hint mode; `label` is for
+     * display. Present at BOTH detail levels — a thin client renders `label`
+     * and injects `term`. Empty for a no-op ("auto"/"none") entry that injects
+     * nothing.
+     */
+    term?: string;
+    icon?: string;
+    /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */
+    motion?: CharacterMotionMetadata;
+    /**
+     * Per-option parameters — node-data fields that apply only while THIS option
+     * is picked (the Transition catalog's `wipe` → `wipeDirection`). Same shape
+     * as a catalog's `dimensions`, at both detail levels; `auto` leads each list
+     * and means "send nothing". Absent on every other option.
+     */
+    params?: PickerDimension[];
+    /**
+     * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro
+     * Cloud only) rendered look preview — on the installation's own host, or the
+     * Nodaro CDN for look previews. Absent when the option has no picture. Use it
+     * as given: file names carry a content hash, so it can be cached for good.
+     */
+    imageUrl?: string;
+}
+interface PickerDimension {
+    field: string;
+    label: string;
+    options: PickerOption[];
+}
+/** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */
+interface PickerCatalogSection {
+    /** English topic name, e.g. "Identity", "Beauty & Hair". */
+    label: string;
+    /** Node-data fields of the settings in this topic, in display order. */
+    fields: string[];
+    /** Absolute URL of the topic's round picture. Absent when it has none. */
+    imageUrl?: string;
+}
+interface PickerCatalog {
+    nodeType: string;
+    label: string;
+    catalogId: string;
+    kind: "single" | "multi";
+    /** single only — the node-data field the chosen id writes to. */
+    valueField?: string;
+    defaultValue?: string;
+    categoryOrder?: string[];
+    categoryLabels?: Record<string, string>;
+    /** single-dim catalogs. */
+    options?: PickerOption[];
+    /** multi-dim catalogs. */
+    fields?: string[];
+    /** Per-field option lists. Multi-dim catalogs always carry these; a
+     *  single-dim catalog carries them when it has secondary parameter
+     *  fields beside its main picker (transition position/duration/intensity). */
+    dimensions?: PickerDimension[];
+    detail?: "compact" | "full";
+    /** person and styling: the topics their settings are grouped under, in order, each with its picture. */
+    sections?: PickerCatalogSection[];
+}
+interface PickerCatalogSummary {
+    nodeType: string;
+    label: string;
+    catalogId: string;
+    kind: "single" | "multi";
+    valueField?: string;
+    fields?: string[];
+    optionCount: number;
+    /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */
+    imageCount?: number;
+}
+interface GetPickerCatalogOptions {
+    /** "compact" (default) = id, label, category, term, icon, imageUrl; "full" additionally includes description + promptHint. */
+    detail?: "compact" | "full";
+    /** single-dim: filter to one category. */
+    category?: string;
+    /** multi-dim: only this dimension field. */
+    field?: string;
+}
+/** Input for `analyzeText` (POST /v1/text-to-picker). */
+interface TextToPickerParams {
+    /** Free-text scene/shot description to analyze. */
+    text: string;
+    /** Picker node types to fill. Omit for ALL analyzable pickers (the server
+     *  fans the analysis out per family and merges). */
+    targetPickers?: string[];
+    /** Extra guidance appended to the analyzer system prompt. */
+    instructions?: string;
+    /** Originating client app slug (e.g. "cine") — attribution only. */
+    origin?: string;
+    llmModel?: string;
+    reasoningEffort?: string;
+}
+interface TextToPickerResult {
+    jobId: string;
+    /** pickerType → dimension → chosen catalog id(s) — same shape as
+     *  describe-to-picker; hydrate pickers from it verbatim. */
+    pickerJson: Record<string, Record<string, string | string[]>>;
+    /** Catalog-coverage feedback (attributes the text described that no
+     *  catalog id represents well). Surface as "we couldn't infer X". */
+    gaps?: {
+        missingItems: Array<{
+            picker: string;
+            dimension: string;
+            observed: string;
+        }>;
+        missingCategories: Array<{
+            picker: string;
+            suggestedDimension: string;
+            observed: string;
+        }>;
+    };
+}
+declare class PickerCatalogsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** List every parameter-picker node type + its option count. Cached publicly 5 min. */
+    list(): Promise<{
+        data: PickerCatalogSummary[];
+    }>;
+    /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+     *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+    analyzeText(params: TextToPickerParams): Promise<TextToPickerResult>;
+    /** Get one picker's catalog of valid values. */
+    get(nodeType: string, opts?: GetPickerCatalogOptions): Promise<{
+        data: PickerCatalog;
+    }>;
+}
+
+export { type GetPickerCatalogOptions, type PickerCatalog, type PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, type TextToPickerParams, type TextToPickerResult };