@nodaro/sdk 2.28.0 → 2.31.0

package/dist/entries/pipelines.js.map

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

package/dist/entries/projects.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-PZS2EXDR.cjs');
+var chunkLAWYFC4G_cjs = require('../chunk-LAWYFC4G.cjs');
+
+
+
+Object.defineProperty(exports, "ProjectsResource", {
+  enumerable: true,
+  get: function () { return chunkLAWYFC4G_cjs.ProjectsResource; }
+});
+//# sourceMappingURL=projects.cjs.map
+//# sourceMappingURL=projects.cjs.map

package/dist/entries/projects.cjs.map

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

package/dist/entries/projects.d.cts

@@ -0,0 +1,49 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface Project {
+    id: string;
+    userId: string;
+    name: string;
+    description?: string | null;
+    settings?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProjectInput {
+    name: string;
+    description?: string;
+    settings?: Record<string, unknown>;
+}
+interface UpdateProjectInput {
+    name?: string;
+    description?: string;
+    settings?: Record<string, unknown>;
+}
+declare class ProjectsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** List the authenticated user's projects. */
+    list(): Promise<{
+        data: Project[];
+    }>;
+    /** Get a project by ID. */
+    get(id: string): Promise<{
+        data: Project;
+    }>;
+    /** Create a new project. */
+    create(input: CreateProjectInput): Promise<{
+        data: Project;
+    }>;
+    /** Update a project. At least one field must be provided. */
+    update(id: string, input: UpdateProjectInput): Promise<{
+        data: Project;
+    }>;
+    /** Delete a project. Returns `{ success: true }`. */
+    delete(id: string): Promise<{
+        success: true;
+    }>;
+}
+
+export { type CreateProjectInput, type Project, ProjectsResource, type UpdateProjectInput };

package/dist/entries/projects.d.ts

@@ -0,0 +1,49 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface Project {
+    id: string;
+    userId: string;
+    name: string;
+    description?: string | null;
+    settings?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProjectInput {
+    name: string;
+    description?: string;
+    settings?: Record<string, unknown>;
+}
+interface UpdateProjectInput {
+    name?: string;
+    description?: string;
+    settings?: Record<string, unknown>;
+}
+declare class ProjectsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** List the authenticated user's projects. */
+    list(): Promise<{
+        data: Project[];
+    }>;
+    /** Get a project by ID. */
+    get(id: string): Promise<{
+        data: Project;
+    }>;
+    /** Create a new project. */
+    create(input: CreateProjectInput): Promise<{
+        data: Project;
+    }>;
+    /** Update a project. At least one field must be provided. */
+    update(id: string, input: UpdateProjectInput): Promise<{
+        data: Project;
+    }>;
+    /** Delete a project. Returns `{ success: true }`. */
+    delete(id: string): Promise<{
+        success: true;
+    }>;
+}
+
+export { type CreateProjectInput, type Project, ProjectsResource, type UpdateProjectInput };

package/dist/entries/projects.js

@@ -0,0 +1,4 @@
+import '../chunk-KZQKFBRN.js';
+export { ProjectsResource } from '../chunk-H7VQTG4M.js';
+//# sourceMappingURL=projects.js.map
+//# sourceMappingURL=projects.js.map

package/dist/entries/projects.js.map

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

package/dist/entries/prompt-helper.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-IGOPUMEX.cjs');
+var chunkKGKCAGRD_cjs = require('../chunk-KGKCAGRD.cjs');
+
+
+
+Object.defineProperty(exports, "PromptHelperResource", {
+  enumerable: true,
+  get: function () { return chunkKGKCAGRD_cjs.PromptHelperResource; }
+});
+//# sourceMappingURL=prompt-helper.cjs.map
+//# sourceMappingURL=prompt-helper.cjs.map

package/dist/entries/prompt-helper.cjs.map

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

package/dist/entries/prompt-helper.d.cts

@@ -0,0 +1,73 @@
+import { WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel } from '@nodaro/prompts/doctrine';
+export { RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection } from '@nodaro/prompts/doctrine';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface CommonInput {
+    nodeType: string;
+    provider?: string;
+    style?: string;
+    aspectRatio?: string;
+    duration?: number;
+    llmModel?: string;
+    /** Reasoning effort level (model-dependent). */
+    reasoningEffort?: string;
+    /**
+     * Gemini and Claude models. Runs the request on the provider's own API so
+     * `temperature`, `maxTokens` and the full reasoning range actually take
+     * effect — on the default lane those levers are not reliably honoured.
+     * Bills one credit rung up (a premium model moves to premium-direct). A model without a direct lane returns
+     * `400 advanced_mode_unsupported`.
+     */
+    advancedMode?: boolean;
+    /** Sampling temperature. Only honoured when `advancedMode` is true. */
+    temperature?: number;
+    /** Output token cap. Only honoured when `advancedMode` is true. */
+    maxTokens?: number;
+    nodeContext?: WizardNodeContext;
+    userPreference?: string;
+    /** Associates this call with a workflow execution. Read server-side before Zod. */
+    workflowId?: string;
+}
+interface AnalyzeInput extends CommonInput {
+    /** The user's rough idea. Omit to build questions from scratch. */
+    prompt?: string;
+}
+interface AnalyzeResult {
+    jobId: string;
+    questions: WizardQuestion[];
+}
+interface GenerateInput extends CommonInput {
+    /** The chosen answers from analyze. */
+    selections: WizardSelection[];
+    /** The user's original rough idea, woven into the generated prompt. */
+    originalPrompt?: string;
+}
+interface EnhanceInput extends CommonInput {
+    /** The rough idea to improve one-shot. Omit to build from scratch. */
+    prompt?: string;
+}
+interface PromptResult {
+    jobId: string;
+    prompt: string;
+    recommendedModel?: RecommendedModel;
+}
+/**
+ * AI Prompt Wizard — help write/improve prompts for generation nodes.
+ *
+ * - `analyze` -> guided questions, `generate` -> prompt from selections (the
+ *   2-step human flow), or `enhance` -> one-shot "improve this prompt".
+ *
+ * All three delegate to `POST /v1/prompt-helper/wizard`. Throws `NodaroError`
+ * on 4xx/5xx (e.g. `validation_error`, `malformed_response`).
+ */
+declare class PromptHelperResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    analyze(input: AnalyzeInput): Promise<AnalyzeResult>;
+    generate(input: GenerateInput): Promise<PromptResult>;
+    enhance(input: EnhanceInput): Promise<PromptResult>;
+}
+
+export { type AnalyzeInput, type AnalyzeResult, type EnhanceInput, type GenerateInput, PromptHelperResource, type PromptResult };

package/dist/entries/prompt-helper.d.ts

@@ -0,0 +1,73 @@
+import { WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel } from '@nodaro/prompts/doctrine';
+export { RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection } from '@nodaro/prompts/doctrine';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+interface CommonInput {
+    nodeType: string;
+    provider?: string;
+    style?: string;
+    aspectRatio?: string;
+    duration?: number;
+    llmModel?: string;
+    /** Reasoning effort level (model-dependent). */
+    reasoningEffort?: string;
+    /**
+     * Gemini and Claude models. Runs the request on the provider's own API so
+     * `temperature`, `maxTokens` and the full reasoning range actually take
+     * effect — on the default lane those levers are not reliably honoured.
+     * Bills one credit rung up (a premium model moves to premium-direct). A model without a direct lane returns
+     * `400 advanced_mode_unsupported`.
+     */
+    advancedMode?: boolean;
+    /** Sampling temperature. Only honoured when `advancedMode` is true. */
+    temperature?: number;
+    /** Output token cap. Only honoured when `advancedMode` is true. */
+    maxTokens?: number;
+    nodeContext?: WizardNodeContext;
+    userPreference?: string;
+    /** Associates this call with a workflow execution. Read server-side before Zod. */
+    workflowId?: string;
+}
+interface AnalyzeInput extends CommonInput {
+    /** The user's rough idea. Omit to build questions from scratch. */
+    prompt?: string;
+}
+interface AnalyzeResult {
+    jobId: string;
+    questions: WizardQuestion[];
+}
+interface GenerateInput extends CommonInput {
+    /** The chosen answers from analyze. */
+    selections: WizardSelection[];
+    /** The user's original rough idea, woven into the generated prompt. */
+    originalPrompt?: string;
+}
+interface EnhanceInput extends CommonInput {
+    /** The rough idea to improve one-shot. Omit to build from scratch. */
+    prompt?: string;
+}
+interface PromptResult {
+    jobId: string;
+    prompt: string;
+    recommendedModel?: RecommendedModel;
+}
+/**
+ * AI Prompt Wizard — help write/improve prompts for generation nodes.
+ *
+ * - `analyze` -> guided questions, `generate` -> prompt from selections (the
+ *   2-step human flow), or `enhance` -> one-shot "improve this prompt".
+ *
+ * All three delegate to `POST /v1/prompt-helper/wizard`. Throws `NodaroError`
+ * on 4xx/5xx (e.g. `validation_error`, `malformed_response`).
+ */
+declare class PromptHelperResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    analyze(input: AnalyzeInput): Promise<AnalyzeResult>;
+    generate(input: GenerateInput): Promise<PromptResult>;
+    enhance(input: EnhanceInput): Promise<PromptResult>;
+}
+
+export { type AnalyzeInput, type AnalyzeResult, type EnhanceInput, type GenerateInput, PromptHelperResource, type PromptResult };

package/dist/entries/prompt-helper.js

@@ -0,0 +1,4 @@
+import '../chunk-7A7HYFGM.js';
+export { PromptHelperResource } from '../chunk-E2ZXHS6E.js';
+//# sourceMappingURL=prompt-helper.js.map
+//# sourceMappingURL=prompt-helper.js.map

package/dist/entries/prompt-helper.js.map

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

package/dist/entries/recast.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var chunkIMC2M5YM_cjs = require('../chunk-IMC2M5YM.cjs');
+var chunkKXEWTYS4_cjs = require('../chunk-KXEWTYS4.cjs');
+
+
+
+Object.defineProperty(exports, "RECAST_SEGMENT_PACKS", {
+  enumerable: true,
+  get: function () { return chunkIMC2M5YM_cjs.RECAST_SEGMENT_PACKS; }
+});
+Object.defineProperty(exports, "RecastResource", {
+  enumerable: true,
+  get: function () { return chunkKXEWTYS4_cjs.RecastResource; }
+});
+//# sourceMappingURL=recast.cjs.map
+//# sourceMappingURL=recast.cjs.map

package/dist/entries/recast.cjs.map

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

package/dist/entries/recast.d.cts

@@ -0,0 +1,229 @@
+import { RecastSegmentPack } from '@nodaro/shared/apps';
+export { RECAST_SEGMENT_PACKS, RecastSegmentPack } from '@nodaro/shared/apps';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/organizations';
+
+/**
+ * Recast — regenerate an analyzed source video with your own cast (the engine
+ * behind recast.nodaro.ai), plus the authored-script import lane ("movie as
+ * JSON", no source video).
+ *
+ * Cloud edition only: the `/v1/recast/*` and `/v1/video-analysis/import*`
+ * routes are served by the cloud plugin and 404 on self-hosted installs.
+ * Wire contract: docs/api-integration.md §13c/§13d and
+ * docs/mcp/recast-authoring.md. The interactive run is server-driven — poll
+ * `get()` and answer gates with `resolveGate()`; the platform advances every
+ * non-gate step itself.
+ */
+interface RecastScriptValidationError {
+    path: string;
+    message: string;
+    /** Written for an LLM repair loop — fix `path` using this and re-validate. */
+    hint?: string;
+}
+interface RecastScriptValidation {
+    valid: boolean;
+    errors: RecastScriptValidationError[];
+    warnings: string[];
+}
+interface RecastScriptImportResult {
+    /** A standard completed analysis job — feed it to `create()` as `analysisJobId`. */
+    jobId: string;
+    /** false when an identical script was already imported (idempotent re-import). */
+    created: boolean;
+    warnings: string[];
+    /** The document of record — WITH the server-derived fields; always prefer it
+     *  over your input. */
+    json: Record<string, unknown>;
+}
+interface CreateRecastInput {
+    /** Required: an existing workflow you own that the run attaches to. */
+    workflowId: string;
+    /** The source analysis job (from a video analysis or an authored-script import). */
+    analysisJobId: string;
+    /** Authored imports render `"faithful"` — exactly as written. */
+    fidelity?: string;
+    /** Required (`true`) for faithful renders of authored scripts. */
+    rightsAttested?: boolean;
+    resolution?: string;
+    /** How the render packs scenes into parts — a name, not seconds. */
+    segmentSec?: RecastSegmentPack;
+    renderMethod?: string;
+    /** Opt in to the interactive walk (pick-1-of-3 gates surfaced via `get()`). */
+    interactive?: boolean;
+    provider?: string;
+    /**
+     * Interactive gates the CLIENT can answer, e.g. `["sheet-gate"]`. The
+     * platform only opens a gate kind for runs whose create declared support
+     * for it — undeclared kinds are decided automatically.
+     */
+    clientCapabilities?: string[];
+}
+type EstimateRecastInput = Omit<CreateRecastInput, "workflowId" | "rightsAttested" | "clientCapabilities">;
+interface RecastEstimate {
+    totalCredits?: number;
+    breakdown?: Record<string, number>;
+    [key: string]: unknown;
+}
+type RecastAudioLayerName = "music" | "video";
+interface RecastAudioMixControl {
+    /** Linear gain percentage. The server rounds and clamps this to 0–200. */
+    gain: number;
+    /** A muted lane has an effective wire gain of zero. */
+    muted: boolean;
+}
+/** Complete desired controls for the logical lanes addressed by an operation. */
+interface RecastAudioMix {
+    music?: RecastAudioMixControl;
+    video?: RecastAudioMixControl;
+}
+interface RecastAudioManifestV1 {
+    version: 1;
+    /** Opaque server-minted identity of the currently published audio delivery. */
+    revision: string;
+    mode: "bed" | "replace";
+    /** Logical layers in the delivery, including layers whose preview derivative failed. */
+    present: {
+        music?: true;
+        video?: true;
+    };
+    /** Browser-ready, CORS-enabled audio-only derivatives. */
+    layers: {
+        music?: {
+            url: string;
+        };
+        video?: {
+            url: string;
+        };
+    };
+    /** Effective integer gain percentages baked into the current `resultUrl`. */
+    bakedEffectiveGain: {
+        music?: number;
+        video?: number;
+    };
+    /** Present only while a paid audio operation is genuinely live. */
+    pendingRescore?: {
+        jobId: string;
+        requestId: string;
+        state: "pending" | "running";
+        expectedAudioRevision: string;
+        requestedEffectiveGain: {
+            music?: number;
+            video?: number;
+        };
+    };
+}
+interface RecastAudioSectionReplacement {
+    index: number;
+    brief: string;
+}
+/** Exactly one replacement lane may be combined with a mix. */
+type RecastRescoreReplacement = {
+    audioUrl: string;
+    sections?: never;
+} | {
+    sections: RecastAudioSectionReplacement[];
+    audioUrl?: never;
+};
+type RecastNoReplacement = {
+    audioUrl?: never;
+    sections?: never;
+};
+/** A mix, one Music replacement, or a replacement and its complete desired mix. */
+type RecastRescoreOperation = ({
+    mix: RecastAudioMix;
+} & (RecastRescoreReplacement | RecastNoReplacement)) | (RecastRescoreReplacement & {
+    mix?: RecastAudioMix;
+});
+/** Free quote input. `requestId` is deliberately absent because quoting has no side effects. */
+type EstimateRecastRescoreInput = RecastRescoreOperation & {
+    expectedAudioRevision: string;
+};
+/** Revision-safe paid operation. Reuse `requestId` only for transport retries. */
+type RecastRescoreRequestV2 = EstimateRecastRescoreInput & {
+    requestId: string;
+};
+interface RecastRescoreQuote {
+    credits: number;
+    audioRevision: string;
+    noOp: boolean;
+}
+type RecastRescoreResponse = {
+    recastId: string;
+    jobId: string;
+    noOp?: false;
+} | {
+    recastId: string;
+    noOp: true;
+    audioRevision: string;
+};
+/** Run snapshot — `status` plus, on interactive runs, the pending step. */
+interface RecastRunSnapshot {
+    status: string;
+    interactive?: Record<string, unknown>;
+    /** Presence of `audioLayers: 1` opts a client into the revisioned audio contract. */
+    capabilities?: {
+        audioLayers?: 1;
+        [key: string]: unknown;
+    };
+    /** Server-authored manifest for the selected completed take. */
+    audio?: RecastAudioManifestV1;
+    [key: string]: unknown;
+}
+interface ResolveRecastGateInput {
+    /** Which gate the picks answer. Defaults server-side to `"cast"`. */
+    gate?: "cast" | "sheet" | "anchors" | "music";
+    /** cast / sheet gates: the pick payload as surfaced by the pending gate. */
+    picks?: unknown;
+    /** anchors gate: which segment the anchor picks apply to. */
+    segment?: number;
+    anchorPicks?: {
+        start?: number;
+        end?: number;
+    };
+    /** music gate: which section the pick applies to. */
+    section?: number;
+    musicPick?: number | string;
+    /** Let the critic decide this and every remaining gate automatically. */
+    finishAuto?: boolean;
+}
+declare class RecastResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /** The generated authoring guide (markdown): document contract, enum
+     *  vocabularies, bounds, audio rules, and a validated worked example. */
+    authoringSkill(): Promise<string>;
+    /** FREE validation of an authored script. Loop until `valid: true`. */
+    validateScript(script: Record<string, unknown>): Promise<RecastScriptValidation>;
+    /**
+     * Import a VALIDATED authored script as a completed analysis job.
+     * `rightsAttested: true` is required (403 otherwise) — authored recasts
+     * render Faithful, exactly as written, so only import work you own.
+     */
+    importScript(script: Record<string, unknown>, opts: {
+        rightsAttested: true;
+    }): Promise<RecastScriptImportResult>;
+    /** Quote a run (credits) before buying the plan. */
+    estimate(input: EstimateRecastInput): Promise<RecastEstimate>;
+    /** Create a run (buys the plan). Returns `{ recastId }`. */
+    create(input: CreateRecastInput): Promise<{
+        recastId: string;
+    }>;
+    /** Poll the run — status plus any pending interactive step. */
+    get(recastId: string): Promise<RecastRunSnapshot>;
+    /** Quote a revisioned Music replacement and/or complete desired mix. Free. */
+    estimateRescore(recastId: string, input: EstimateRecastRescoreInput): Promise<RecastRescoreQuote>;
+    /** Apply a quoted audio operation. Reuse its request id only for a transport retry. */
+    rescore(recastId: string, input: RecastRescoreRequestV2): Promise<RecastRescoreResponse>;
+    /** Start rendering a `planned` run. Idempotent server-side. */
+    start(recastId: string, opts?: {
+        segmentSec?: RecastSegmentPack;
+        provider?: string;
+    }): Promise<{
+        gvpJobId?: string;
+    }>;
+    /** Answer a pending interactive gate (the pick itself is free). */
+    resolveGate(recastId: string, input: ResolveRecastGateInput): Promise<Record<string, unknown>>;
+}
+
+export { type CreateRecastInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ResolveRecastGateInput };