@lingjingai/scriptctl 0.30.2 → 0.32.0

package/dist/domain/direct-core.d.ts

@@ -58,6 +58,9 @@ export interface ProviderLike {
     extractEpisode?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
     extractBatch?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
     extractMetadata?(sourceText: string, script: Dict): Promise<Dict> | Dict;
+    groupAssets?(script: Dict, contextText: string): Promise<string> | string;
+    curateAssets?(script: Dict, contextText: string): Promise<string> | string;
+    bindStates?(script: Dict, context: Dict): Promise<Dict> | Dict;
     extractEpisodeTitles?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
     extractEpisodeSynopsis?(synopses: string[], ctx: Dict): Promise<Dict> | Dict;
     extractScriptSynopsis?(synopses: string[], ctx: Dict): Promise<Dict> | Dict;
@@ -188,11 +191,65 @@ interface AssetUsage {
     scenes: Set<string>;
 }
 export declare function sceneAssetUsage(script: Dict, refKey: string, idKey: string): Map<string, AssetUsage>;
+export type AssetCurationSelection = Partial<Record<AssetKind, readonly string[]>>;
+export declare const ASSET_GROUP_MAX_ITEMS = 8;
+export declare const ASSET_GROUP_MAX_CONTEXT_CHARS = 22000;
+export declare function buildAssetCurationContext(script: Dict, kinds?: readonly AssetKind[], selection?: AssetCurationSelection): Dict;
+export declare function formatAssetCurationContextText(context: Dict): string;
+export declare function buildAssetCurationContextText(script: Dict, kinds?: readonly AssetKind[], selection?: AssetCurationSelection): string;
+export declare function buildAssetGroupingContextText(script: Dict, kind: AssetKind): string;
+export interface AssetCurationChunkOptions {
+    maxItems: number;
+    maxContextChars: number;
+}
+export declare function buildPrimaryAssetCurationChunks(script: Dict, kind: AssetKind, options?: AssetCurationChunkOptions): string[][];
+export declare function extractAssetGroupingExpressions(rawText: string): string[];
+export declare function parseAssetGroupingExpressions(rawText: string): Dict;
+export declare function validateAssetGroupingPlan(script: Dict, kind: AssetKind, rawPlan: Dict): Dict;
+export declare function groupedAssetCurationChunks(script: Dict, kind: AssetKind, groups: readonly Dict[], options?: AssetCurationChunkOptions): string[][];
+export declare function buildAssetCurationRepairContextText(opts: {
+    baseContextText: string;
+    repairSourceKeys: readonly string[];
+    rejectedExpressions: readonly Dict[];
+    acceptedDecisions: readonly Dict[];
+}): string;
+export declare function missingAssetCurationRequiredSourceKeys(script: Dict, rawPlan: unknown): string[];
+export declare function assetCurationAuditCandidateSourceKeys(script: Dict, rawPlan: unknown): string[];
+export declare function assetCurationAuditSourceKeys(script: Dict, rawPlan: unknown): string[];
+export declare function buildAssetCurationAuditContextText(script: Dict, primaryPlan: unknown, selectedSourceKeys?: readonly string[]): string;
+export declare function locationCanonicalizationCandidateSourceKeys(script: Dict, rawPlan: unknown): string[];
+export declare function buildLocationCanonicalizationAuditContextText(script: Dict, rawPlan: unknown, selectedSourceKeys?: readonly string[]): string;
+export declare function assertLocationCanonicalizationPlan(rawPlan: unknown): void;
+export declare function combineLocationCanonicalizationPlan(script: Dict, basePlan: Dict, locationPlan: Dict, allowedNewLocationSources?: string[]): Dict;
 export declare function applyLocationMerges(script: Dict, replacements: Map<string, string>): void;
 export declare function actorCurationDecisions(script: Dict): Dict[];
 export declare function propCurationDecisions(script: Dict): Dict[];
+export declare function extractAssetCurationExpressions(rawText: string): string[];
+export interface RejectedAssetCurationExpression {
+    index: number;
+    raw: string;
+    error: string;
+    source_key: string | null;
+}
+export declare function guessAssetCurationExpressionSourceKey(rawExpression: string): string | null;
+export declare function parseAssetCurationExpressionsTolerant(rawText: string): Dict;
+export declare function parseAssetCurationExpressions(rawText: string): Dict;
+export declare function formatAssetCurationDecisionExpressions(plan: Dict): string;
+export declare function combineAssetCurationExpressionPlans(plans: readonly Dict[]): Dict;
+export declare function combinePrimaryAssetCurationPlans(plans: readonly Dict[]): Dict;
+export declare function combineAssetCurationPlans(primaryPlan: Dict, auditPlan: Dict, allowedNewAuditSources?: string[]): Dict;
+export declare function applyAssetCurationPlan(script: Dict, rawPlan: unknown): Dict;
+export declare function applyAssetGroupingDuplicateMerges(script: Dict, rawPlan: unknown): Dict;
 export declare function normalizeAssetCuration(script: Dict, rawCuration: unknown): Dict;
 export declare function curateScriptAssets(script: Dict, rawCuration?: unknown): Dict;
+export declare function normalizeStateBindingPlanShape(rawPlan: unknown): Dict | null;
+export declare function ensureDefaultStates(script: Dict): Dict;
+export declare function bindDefaultStateRefsInScript(script: Dict): Dict;
+export declare function buildStateBindingContexts(script: Dict, chunkSize?: number): Dict[];
+interface StateBindingApplyOptions {
+    invalidStateMode?: "reject" | "skip";
+}
+export declare function applyStateBindingPlan(script: Dict, rawPlan: unknown, options?: StateBindingApplyOptions): Dict;
 export type AssetKind = "actor" | "location" | "prop";
 export type CanonicalAssetKey = string;
 export type AssetNormalizationAction = "canonical_merge" | "location_state_from_name" | "location_state_from_time" | "review";