@nodaro/sdk 2.29.0 → 2.32.0

package/dist/entries/studio.d.cts

@@ -0,0 +1,281 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import { C as StudioProductionsResource } from '../studio-productions-DUHvdSvk.cjs';
+export { G as GetProductionOptions, L as ListStudioProductionsOptions, S as StudioClientRequestId, a as StudioCloneRequest, b as StudioCreateProductionRequest, c as StudioDescribeRequest, d as StudioExportPlanOptions, e as StudioExportPlanResponse, f as StudioExportStep, g as StudioFrameRequest, h as StudioGenerateEstimate, i as StudioGenerateOptions, j as StudioGenerateRequest, k as StudioGenerateResponse, l as StudioGenerateResult, m as StudioImportSummary, n as StudioJobStartedResponse, o as StudioListProductionsResponse, p as StudioMediaResponse, q as StudioMusicRequest, r as StudioOpClass, s as StudioOpsDryRunReceipt, t as StudioOpsDryRunResponse, u as StudioOpsImpact, v as StudioOpsReceipt, w as StudioOpsRequest, x as StudioOpsResponse, y as StudioPlanIssue, z as StudioProduction, A as StudioProductionDetail, B as StudioProductionResponse, D as StudioReconcileResponse, E as StudioRevoiceRequest, F as StudioSkillResponse, H as StudioValidatePlanResponse, I as StudioVideoLane, J as StudioVoiceRequest, K as isStudioGenerateEstimate } from '../studio-productions-DUHvdSvk.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/** Public response/transport contracts only; document validation and planning
+ * remain in the private Studio codec on the server. */
+type StudioDocumentJson = Record<string, unknown>;
+interface StudioProductionCapabilities {
+    planVersions: number[];
+    operations: {
+        readKeyframes: boolean;
+        saveEditorState?: boolean;
+        editableSharedCopies?: boolean;
+        revisionedSharing?: boolean;
+        cloneLinkedProductions?: boolean;
+        importPlannedBundles?: boolean;
+        importLinkedBundles?: boolean;
+        appendPlannedBundles?: boolean;
+        appendLinkedBundles?: boolean;
+        editKeyframes: boolean;
+        generateKeyframes: boolean;
+        acceptKeyframes: boolean;
+        rejectKeyframes?: boolean;
+        editSequencePlans?: boolean;
+        generateLinkedClips: boolean;
+        retakeLinkedClips?: boolean;
+        /** The host keeps a scene's empty media slots. */
+        mediaSlots?: boolean;
+        /** The host keeps a clip's inputs on its clip slot. */
+        clipSlotInputs?: boolean;
+    };
+    sourceFrameReferences: boolean;
+    automaticAcceptance: false;
+    unattendedGeneration: false;
+}
+interface StudioKeyframeRecord {
+    id: string;
+    label: string;
+    revision: number;
+    nodeId: string;
+    parentKeyframeId?: string;
+    previewResultKey: string | null;
+    previewUrl: string | null;
+    acceptedResultKey: string | null;
+    acceptedUrl: string | null;
+    count: number;
+    pending: Array<{
+        jobId: string;
+        startedAt: string;
+    }>;
+    /** Owner-only working state. Recorded acceptance is not an execution grant. */
+    plan?: StudioDocumentJson;
+    acceptance?: StudioDocumentJson;
+    results?: StudioDocumentJson[];
+}
+interface StudioProductionRecord {
+    id: string;
+    name: string;
+    version: number;
+    updatedAt: string;
+    thumbnailUrl: string | null;
+    shared: boolean;
+    archived: boolean;
+    requiredCapabilities?: string[];
+    keyframes?: StudioKeyframeRecord[];
+    sequences?: StudioDocumentJson[];
+    shots: StudioDocumentJson[];
+    pending: {
+        stills: number;
+        clips: number;
+        keyframes?: number;
+        music: boolean;
+        draft: StudioDocumentJson | null;
+    };
+    [field: string]: unknown;
+}
+interface StudioProductionReply {
+    production: StudioProductionRecord;
+    capabilities?: StudioProductionCapabilities;
+    warnings?: unknown[];
+    [field: string]: unknown;
+}
+interface StudioEditInput {
+    ops: ReadonlyArray<{
+        op: string;
+        [field: string]: unknown;
+    }>;
+    baseVersion?: number;
+    strict?: boolean;
+    clientRequestId?: string;
+}
+interface StudioKeyframeGenerationInput {
+    keyframeId: string;
+    expectedRevision: number;
+    clientRequestId?: string;
+    overrides?: StudioDocumentJson;
+}
+interface StudioKeyframeAcceptanceInput {
+    keyframeId: string;
+    expectedRevision: number;
+    resultKey: string;
+    expectedAcceptedResultKey: string | null;
+    requirementChecks: Array<{
+        requirementId: string;
+        outcome: "pass" | "waived";
+    }>;
+    waivedReason?: string;
+}
+interface StudioShotGenerationInput {
+    kind: "still" | "clip";
+    shotId: string;
+    clientRequestId?: string;
+    count?: number;
+    mode?: "start" | "start-end" | "references";
+    dryRun?: boolean;
+    /** Linked clips only: require the exact inputs returned by a reviewed quote. */
+    expectedInputHash?: string;
+    /** Retake a native linked take using its original request and retained endpoints. */
+    retakeResultKey?: string;
+    overrides?: StudioDocumentJson;
+}
+type StudioGenerationReply = {
+    jobIds: string[];
+    production?: StudioProductionRecord;
+    deduped?: true;
+    lane?: string;
+    [field: string]: unknown;
+} | {
+    dryRun: true;
+    provider: string;
+    count: number;
+    credits: number | null;
+    lane?: string;
+    /** Linked-clip quotes include normalized settings and accepted endpoint pins. */
+    inputHash?: string;
+    endpointPins?: StudioDocumentJson;
+    creditIdentifier?: string;
+    duration?: number;
+    resolution?: string;
+    aspectRatio?: string;
+    sound?: boolean;
+};
+/** Cloud plugin routes. Check capabilities before exposing dependency controls.
+ * Reads do not reconcile jobs, submit media or accept generated candidates. */
+declare class StudioResource {
+    private readonly client;
+    readonly productions: StudioProductionsResource;
+    constructor(client: NodaroClientCore);
+    capabilities(): Promise<{
+        data: StudioProductionCapabilities;
+    }>;
+    skill(): Promise<{
+        data: StudioDocumentJson;
+    }>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+        includeArchived?: boolean;
+    }): Promise<{
+        data: {
+            data: Array<{
+                id: string;
+                name: string;
+                version: number;
+                updatedAt: string;
+                thumbnailUrl: string | null;
+                shared: boolean;
+                archived: boolean;
+                shotCount: number;
+            }>;
+            nextCursor?: string;
+        };
+    }>;
+    get(id: string, options?: {
+        detail?: "summary" | "full";
+        shotId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    validatePlan(plan: StudioDocumentJson): Promise<{
+        data: {
+            valid: boolean;
+            errors: StudioDocumentJson[];
+            warnings: StudioDocumentJson[];
+            summary?: StudioDocumentJson;
+        };
+    }>;
+    create(input: {
+        name?: string;
+        plan?: StudioDocumentJson;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Import a portable document through the compatible server writer.
+     * Retained frame media requires an authorized source; acceptance never transfers. */
+    importBundle(input: {
+        bundle: StudioDocumentJson;
+        projectId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Append a bundle's scenes and frame closure under an exact destination revision. */
+    appendBundle(id: string, input: {
+        bundle: StudioDocumentJson;
+        expectedVersion: number;
+        afterShotId?: string;
+        applyFilm?: boolean;
+    }): Promise<{
+        data: {
+            production: StudioProductionRecord;
+            importedShotIds: string[];
+            importedKeyframeIds: string[];
+        };
+    }>;
+    /** Copy a saved production. Linked copies retain verified inputs, remap
+     * dependencies and require fresh frame acceptance; they start no media jobs. */
+    clone(id: string, input?: {
+        name?: string;
+        projectId?: string;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    edit(id: string, input: StudioEditInput): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    /** Audience-authorized sharing; an expected revision prevents publication
+     * of concurrent edits the caller has not reviewed. */
+    setShared(id: string, input: {
+        shared: boolean;
+        allowEditableCopy?: boolean;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Save ordinary editor fields against the loaded revision. Protected frame
+     * and job state can only change through their dedicated semantic actions. */
+    saveEditorState(id: string, input: {
+        expectedVersion: number;
+        graph: object;
+        clientRequestId?: string;
+    }): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    generateKeyframe(id: string, input: StudioKeyframeGenerationInput): Promise<{
+        data: Exclude<StudioGenerationReply, {
+            dryRun: true;
+        }>;
+    }>;
+    generateShot(id: string, input: StudioShotGenerationInput): Promise<{
+        data: StudioGenerationReply;
+    }>;
+    /** A separate explicit review action; generation never calls this method. */
+    acceptKeyframe(id: string, input: StudioKeyframeAcceptanceInput, concurrency?: Pick<StudioEditInput, "baseVersion" | "strict" | "clientRequestId">): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    reconcile(id: string): Promise<{
+        data: StudioProductionReply & {
+            landed: string[];
+            pending: string[];
+            failed: string[];
+            version: number;
+        };
+    }>;
+}
+
+export { type StudioDocumentJson, type StudioEditInput, type StudioGenerationReply, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioProductionCapabilities, type StudioProductionRecord, type StudioProductionReply, StudioProductionsResource, StudioResource, type StudioShotGenerationInput };

package/dist/entries/studio.d.ts

@@ -0,0 +1,281 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import { C as StudioProductionsResource } from '../studio-productions-vbCNSbtf.js';
+export { G as GetProductionOptions, L as ListStudioProductionsOptions, S as StudioClientRequestId, a as StudioCloneRequest, b as StudioCreateProductionRequest, c as StudioDescribeRequest, d as StudioExportPlanOptions, e as StudioExportPlanResponse, f as StudioExportStep, g as StudioFrameRequest, h as StudioGenerateEstimate, i as StudioGenerateOptions, j as StudioGenerateRequest, k as StudioGenerateResponse, l as StudioGenerateResult, m as StudioImportSummary, n as StudioJobStartedResponse, o as StudioListProductionsResponse, p as StudioMediaResponse, q as StudioMusicRequest, r as StudioOpClass, s as StudioOpsDryRunReceipt, t as StudioOpsDryRunResponse, u as StudioOpsImpact, v as StudioOpsReceipt, w as StudioOpsRequest, x as StudioOpsResponse, y as StudioPlanIssue, z as StudioProduction, A as StudioProductionDetail, B as StudioProductionResponse, D as StudioReconcileResponse, E as StudioRevoiceRequest, F as StudioSkillResponse, H as StudioValidatePlanResponse, I as StudioVideoLane, J as StudioVoiceRequest, K as isStudioGenerateEstimate } from '../studio-productions-vbCNSbtf.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/** Public response/transport contracts only; document validation and planning
+ * remain in the private Studio codec on the server. */
+type StudioDocumentJson = Record<string, unknown>;
+interface StudioProductionCapabilities {
+    planVersions: number[];
+    operations: {
+        readKeyframes: boolean;
+        saveEditorState?: boolean;
+        editableSharedCopies?: boolean;
+        revisionedSharing?: boolean;
+        cloneLinkedProductions?: boolean;
+        importPlannedBundles?: boolean;
+        importLinkedBundles?: boolean;
+        appendPlannedBundles?: boolean;
+        appendLinkedBundles?: boolean;
+        editKeyframes: boolean;
+        generateKeyframes: boolean;
+        acceptKeyframes: boolean;
+        rejectKeyframes?: boolean;
+        editSequencePlans?: boolean;
+        generateLinkedClips: boolean;
+        retakeLinkedClips?: boolean;
+        /** The host keeps a scene's empty media slots. */
+        mediaSlots?: boolean;
+        /** The host keeps a clip's inputs on its clip slot. */
+        clipSlotInputs?: boolean;
+    };
+    sourceFrameReferences: boolean;
+    automaticAcceptance: false;
+    unattendedGeneration: false;
+}
+interface StudioKeyframeRecord {
+    id: string;
+    label: string;
+    revision: number;
+    nodeId: string;
+    parentKeyframeId?: string;
+    previewResultKey: string | null;
+    previewUrl: string | null;
+    acceptedResultKey: string | null;
+    acceptedUrl: string | null;
+    count: number;
+    pending: Array<{
+        jobId: string;
+        startedAt: string;
+    }>;
+    /** Owner-only working state. Recorded acceptance is not an execution grant. */
+    plan?: StudioDocumentJson;
+    acceptance?: StudioDocumentJson;
+    results?: StudioDocumentJson[];
+}
+interface StudioProductionRecord {
+    id: string;
+    name: string;
+    version: number;
+    updatedAt: string;
+    thumbnailUrl: string | null;
+    shared: boolean;
+    archived: boolean;
+    requiredCapabilities?: string[];
+    keyframes?: StudioKeyframeRecord[];
+    sequences?: StudioDocumentJson[];
+    shots: StudioDocumentJson[];
+    pending: {
+        stills: number;
+        clips: number;
+        keyframes?: number;
+        music: boolean;
+        draft: StudioDocumentJson | null;
+    };
+    [field: string]: unknown;
+}
+interface StudioProductionReply {
+    production: StudioProductionRecord;
+    capabilities?: StudioProductionCapabilities;
+    warnings?: unknown[];
+    [field: string]: unknown;
+}
+interface StudioEditInput {
+    ops: ReadonlyArray<{
+        op: string;
+        [field: string]: unknown;
+    }>;
+    baseVersion?: number;
+    strict?: boolean;
+    clientRequestId?: string;
+}
+interface StudioKeyframeGenerationInput {
+    keyframeId: string;
+    expectedRevision: number;
+    clientRequestId?: string;
+    overrides?: StudioDocumentJson;
+}
+interface StudioKeyframeAcceptanceInput {
+    keyframeId: string;
+    expectedRevision: number;
+    resultKey: string;
+    expectedAcceptedResultKey: string | null;
+    requirementChecks: Array<{
+        requirementId: string;
+        outcome: "pass" | "waived";
+    }>;
+    waivedReason?: string;
+}
+interface StudioShotGenerationInput {
+    kind: "still" | "clip";
+    shotId: string;
+    clientRequestId?: string;
+    count?: number;
+    mode?: "start" | "start-end" | "references";
+    dryRun?: boolean;
+    /** Linked clips only: require the exact inputs returned by a reviewed quote. */
+    expectedInputHash?: string;
+    /** Retake a native linked take using its original request and retained endpoints. */
+    retakeResultKey?: string;
+    overrides?: StudioDocumentJson;
+}
+type StudioGenerationReply = {
+    jobIds: string[];
+    production?: StudioProductionRecord;
+    deduped?: true;
+    lane?: string;
+    [field: string]: unknown;
+} | {
+    dryRun: true;
+    provider: string;
+    count: number;
+    credits: number | null;
+    lane?: string;
+    /** Linked-clip quotes include normalized settings and accepted endpoint pins. */
+    inputHash?: string;
+    endpointPins?: StudioDocumentJson;
+    creditIdentifier?: string;
+    duration?: number;
+    resolution?: string;
+    aspectRatio?: string;
+    sound?: boolean;
+};
+/** Cloud plugin routes. Check capabilities before exposing dependency controls.
+ * Reads do not reconcile jobs, submit media or accept generated candidates. */
+declare class StudioResource {
+    private readonly client;
+    readonly productions: StudioProductionsResource;
+    constructor(client: NodaroClientCore);
+    capabilities(): Promise<{
+        data: StudioProductionCapabilities;
+    }>;
+    skill(): Promise<{
+        data: StudioDocumentJson;
+    }>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+        includeArchived?: boolean;
+    }): Promise<{
+        data: {
+            data: Array<{
+                id: string;
+                name: string;
+                version: number;
+                updatedAt: string;
+                thumbnailUrl: string | null;
+                shared: boolean;
+                archived: boolean;
+                shotCount: number;
+            }>;
+            nextCursor?: string;
+        };
+    }>;
+    get(id: string, options?: {
+        detail?: "summary" | "full";
+        shotId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    validatePlan(plan: StudioDocumentJson): Promise<{
+        data: {
+            valid: boolean;
+            errors: StudioDocumentJson[];
+            warnings: StudioDocumentJson[];
+            summary?: StudioDocumentJson;
+        };
+    }>;
+    create(input: {
+        name?: string;
+        plan?: StudioDocumentJson;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Import a portable document through the compatible server writer.
+     * Retained frame media requires an authorized source; acceptance never transfers. */
+    importBundle(input: {
+        bundle: StudioDocumentJson;
+        projectId?: string;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Append a bundle's scenes and frame closure under an exact destination revision. */
+    appendBundle(id: string, input: {
+        bundle: StudioDocumentJson;
+        expectedVersion: number;
+        afterShotId?: string;
+        applyFilm?: boolean;
+    }): Promise<{
+        data: {
+            production: StudioProductionRecord;
+            importedShotIds: string[];
+            importedKeyframeIds: string[];
+        };
+    }>;
+    /** Copy a saved production. Linked copies retain verified inputs, remap
+     * dependencies and require fresh frame acceptance; they start no media jobs. */
+    clone(id: string, input?: {
+        name?: string;
+        projectId?: string;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    edit(id: string, input: StudioEditInput): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    /** Audience-authorized sharing; an expected revision prevents publication
+     * of concurrent edits the caller has not reviewed. */
+    setShared(id: string, input: {
+        shared: boolean;
+        allowEditableCopy?: boolean;
+        expectedVersion?: number;
+    }): Promise<{
+        data: StudioProductionReply;
+    }>;
+    /** Save ordinary editor fields against the loaded revision. Protected frame
+     * and job state can only change through their dedicated semantic actions. */
+    saveEditorState(id: string, input: {
+        expectedVersion: number;
+        graph: object;
+        clientRequestId?: string;
+    }): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    generateKeyframe(id: string, input: StudioKeyframeGenerationInput): Promise<{
+        data: Exclude<StudioGenerationReply, {
+            dryRun: true;
+        }>;
+    }>;
+    generateShot(id: string, input: StudioShotGenerationInput): Promise<{
+        data: StudioGenerationReply;
+    }>;
+    /** A separate explicit review action; generation never calls this method. */
+    acceptKeyframe(id: string, input: StudioKeyframeAcceptanceInput, concurrency?: Pick<StudioEditInput, "baseVersion" | "strict" | "clientRequestId">): Promise<{
+        data: StudioProductionReply & {
+            version: number;
+            rebased: boolean;
+            receipts: StudioDocumentJson[];
+        };
+    }>;
+    reconcile(id: string): Promise<{
+        data: StudioProductionReply & {
+            landed: string[];
+            pending: string[];
+            failed: string[];
+            version: number;
+        };
+    }>;
+}
+
+export { type StudioDocumentJson, type StudioEditInput, type StudioGenerationReply, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioProductionCapabilities, type StudioProductionRecord, type StudioProductionReply, StudioProductionsResource, StudioResource, type StudioShotGenerationInput };

package/dist/entries/studio.js

@@ -0,0 +1,5 @@
+import '../chunk-PMTM26LL.js';
+export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from '../chunk-VV4TZG5S.js';
+import '../chunk-JGS6YBDW.js';
+//# sourceMappingURL=studio.js.map
+//# sourceMappingURL=studio.js.map

package/dist/entries/studio.js.map

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

package/dist/entries/templates.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-37YCKZX4.cjs');
+var chunk5ALNFATQ_cjs = require('../chunk-5ALNFATQ.cjs');
+
+
+
+Object.defineProperty(exports, "TemplatesResource", {
+  enumerable: true,
+  get: function () { return chunk5ALNFATQ_cjs.TemplatesResource; }
+});
+//# sourceMappingURL=templates.cjs.map
+//# sourceMappingURL=templates.cjs.map

package/dist/entries/templates.cjs.map

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

package/dist/entries/templates.d.cts

@@ -0,0 +1,110 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:
+ * browse cards, a single template with its full snapshot, and the free
+ * clone-into-my-project action. Creator/admin surfaces (publish, mine,
+ * favorites, metadata patch, tutorial flags) are deliberately NOT part of
+ * the public SDK contract; first-party apps reach them via
+ * `client.request()`.
+ */
+/** Card returned by the marketplace browse (no snapshot payload). */
+interface TemplateBrowseCard {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */
+    estimatedCredits: number;
+    /**
+     * Credits per minute of the recording the template is given, when its price
+     * follows that recording's length (an Apply EDL render of a whole episode,
+     * an Edit Plan pass): the price is `estimatedCredits` plus this per minute.
+     * 0 or absent when the price does not depend on a recording's length.
+     */
+    estimatedPerMinuteCredits?: number;
+    /**
+     * The listed price is a range: `estimatedCredits` / `estimatedPerMinuteCredits`
+     * are "from" (the saved settings), these "up to" — the most a run can cost over
+     * the template's exposed fields. Present only when they differ from "from".
+     */
+    maxEstimatedCredits?: number;
+    maxEstimatedPerMinuteCredits?: number;
+    category: string;
+    outputTypes: string[];
+    tags: string[];
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    complexity: string;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    creatorId: string;
+    creatorDisplayName: string | null;
+    cloneCount: number;
+    favoriteCount: number;
+    createdAt: string;
+}
+type TemplateSort = "newest" | "popular" | "most-favorited";
+interface BrowseTemplatesParams {
+    /** Opaque cursor from the previous page's `nextCursor`. */
+    cursor?: string;
+    limit?: number;
+    category?: string;
+    outputType?: string;
+    tag?: string;
+    /** Full-text search over name/description/tags. */
+    search?: string;
+    sort?: TemplateSort;
+    /** Only templates using this node type. */
+    nodeType?: string;
+    /** Only templates using this provider/model id. */
+    provider?: string;
+    complexity?: string;
+}
+interface BrowseTemplatesResult {
+    data: TemplateBrowseCard[];
+    /** Pass back as `cursor` to fetch the next page; `null` on the last page. */
+    nextCursor: string | null;
+}
+/**
+ * A single public template (`GET /v1/templates/:slug`) — the browse-card
+ * fields plus the full workflow snapshot the viewer/clone consume. The route
+ * returns the whole camelCased row, so additional columns may appear beyond
+ * the ones typed here; the index signature keeps them reachable without
+ * casting.
+ */
+interface Template extends TemplateBrowseCard {
+    markdownDescription: string | null;
+    /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */
+    snapshotNodes: unknown[];
+    snapshotEdges: unknown[];
+    snapshotSettings: Record<string, unknown>;
+    /** Channels the template is listed in (e.g. "marketplace", "tutorial"). */
+    listedIn: string[];
+    readonly [key: string]: unknown;
+}
+interface CloneTemplateParams {
+    /** Target project (must belong to the caller). */
+    projectId: string;
+    /** Optional name for the cloned workflow; defaults to the template's name. */
+    name?: string;
+}
+interface CloneTemplateResult {
+    workflowId: string;
+    projectId: string;
+}
+declare class TemplatesResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** Browse the public template marketplace (cursor-paginated, no auth required). */
+    browse(params?: BrowseTemplatesParams): Promise<BrowseTemplatesResult>;
+    /** Fetch one public template by slug, including its full workflow snapshot. */
+    get(slug: string): Promise<Template>;
+    /** Clone a template into one of the caller's projects. Free — no credits charged. */
+    clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult>;
+}
+
+export { type BrowseTemplatesParams, type BrowseTemplatesResult, type CloneTemplateParams, type CloneTemplateResult, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource };