@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/flows-actors/utils/cli-runtime-operation-support.backend.utils.d.ts

@@ -0,0 +1,15 @@
+import { CLIRuntime_ExecutionProfile, CLIRuntime_OperationBinding, CLIRuntime_OutputParserMode, CLIRuntime_Profile } from '@wildo-ai/external-connectors-models';
+export interface CLIRuntimeOperationSupportAssessment {
+    supported: boolean;
+    message?: string;
+}
+export declare function getCLIRuntimeOperationBinding(profile: CLIRuntime_Profile, operationKey: string): CLIRuntime_OperationBinding | undefined;
+export declare function getEffectiveCLIRuntimeOutputParserMode(profile: CLIRuntime_Profile, executionProfile: CLIRuntime_ExecutionProfile, operationKey: string): CLIRuntime_OutputParserMode;
+/**
+ * The CLI runtime profile declares provider-owned transport capabilities, but
+ * the backend still needs one shared truth source for which semantic
+ * operations the executor can honor without collapsing distinctions like text,
+ * structured output, chat, and streaming.
+ */
+export declare function assessCLIRuntimeOperationSupport(profile: CLIRuntime_Profile, executionProfile: CLIRuntime_ExecutionProfile, operationKey: string): CLIRuntimeOperationSupportAssessment;
+//# sourceMappingURL=cli-runtime-operation-support.backend.utils.d.ts.map

package/dist/esm/flows-actors/utils/cli-runtime-operation-support.backend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime-operation-support.backend.utils.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/utils/cli-runtime-operation-support.backend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,kBAAkB,EAEnB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,WAAW,oCAAoC;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,MAAM,GACnB,2BAA2B,GAAG,SAAS,CAEzC;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,2BAA2B,EAC7C,YAAY,EAAE,MAAM,GACnB,2BAA2B,CAG7B;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,2BAA2B,EAC7C,YAAY,EAAE,MAAM,GACnB,oCAAoC,CA+CtC"}

package/dist/esm/flows-actors/utils/cli-runtime-operation-support.backend.utils.js

@@ -0,0 +1,55 @@
+import { CLIRuntime_OutputParserMode, LLMProvider_OperationKey, } from '@wildo-ai/external-connectors-models';
+export function getCLIRuntimeOperationBinding(profile, operationKey) {
+    return profile.operationBindings?.[operationKey];
+}
+export function getEffectiveCLIRuntimeOutputParserMode(profile, executionProfile, operationKey) {
+    return getCLIRuntimeOperationBinding(profile, operationKey)?.outputParserMode
+        ?? executionProfile.outputParserMode;
+}
+/**
+ * The CLI runtime profile declares provider-owned transport capabilities, but
+ * the backend still needs one shared truth source for which semantic
+ * operations the executor can honor without collapsing distinctions like text,
+ * structured output, chat, and streaming.
+ */
+export function assessCLIRuntimeOperationSupport(profile, executionProfile, operationKey) {
+    if (!profile.supportedOperationKeys.includes(operationKey)) {
+        return {
+            supported: false,
+            message: 'CLI runtime profile does not declare support for the selected semantic LLM operation',
+        };
+    }
+    switch (operationKey) {
+        case LLMProvider_OperationKey.GENERATE_TEXT:
+            return { supported: true };
+        case LLMProvider_OperationKey.GENERATE_STRUCTURED: {
+            const binding = getCLIRuntimeOperationBinding(profile, operationKey);
+            if (!binding) {
+                return {
+                    supported: false,
+                    message: 'CLI runtime structured output requires an operation binding',
+                };
+            }
+            if (getEffectiveCLIRuntimeOutputParserMode(profile, executionProfile, operationKey)
+                !== CLIRuntime_OutputParserMode.JSON) {
+                return {
+                    supported: false,
+                    message: 'CLI runtime structured output requires JSON parsing',
+                };
+            }
+            if (!binding.jsonOutputPath?.length) {
+                return {
+                    supported: false,
+                    message: 'CLI runtime structured output requires a configured JSON output path',
+                };
+            }
+            return { supported: true };
+        }
+        default:
+            return {
+                supported: false,
+                message: 'CLI runtime does not implement truthful request/response semantics for this operation yet',
+            };
+    }
+}
+//# sourceMappingURL=cli-runtime-operation-support.backend.utils.js.map

package/dist/esm/flows-actors/utils/cli-runtime-operation-support.backend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime-operation-support.backend.utils.js","sourceRoot":"","sources":["../../../../src/flows-actors/utils/cli-runtime-operation-support.backend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,2BAA2B,EAE3B,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAO9C,MAAM,UAAU,6BAA6B,CAC3C,OAA2B,EAC3B,YAAoB;IAEpB,OAAO,OAAO,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,OAA2B,EAC3B,gBAA6C,EAC7C,YAAoB;IAEpB,OAAO,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,gBAAgB;WACxE,gBAAgB,CAAC,gBAAgB,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAA2B,EAC3B,gBAA6C,EAC7C,YAAoB;IAEpB,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,sFAAsF;SAChG,CAAC;IACJ,CAAC;IAED,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,wBAAwB,CAAC,aAAa;YACzC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAE7B,KAAK,wBAAwB,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACrE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,6DAA6D;iBACvE,CAAC;YACJ,CAAC;YAED,IACE,sCAAsC,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,CAAC;oBAC3E,2BAA2B,CAAC,IAAI,EACpC,CAAC;gBACD,OAAO;oBACL,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,qDAAqD;iBAC/D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;gBACpC,OAAO;oBACL,SAAS,EAAE,KAAK;oBAChB,OAAO,EAAE,sEAAsE;iBAChF,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAED;YACE,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,2FAA2F;aACrG,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/esm/flows-actors/utils/cli-runtime-runner.backend.utils.d.ts

@@ -0,0 +1,22 @@
+import { CLIRuntime_ExecutionProfile } from '@wildo-ai/external-connectors-models';
+export interface CLIRuntimeCommandExecutionResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+}
+export declare class CLIRuntimeRunnerError extends Error {
+    readonly details: Record<string, unknown>;
+    constructor(message: string, details: Record<string, unknown>);
+}
+export declare function resolveCLIRuntimeWorkingDirectory(profile: Pick<CLIRuntime_ExecutionProfile, 'workspaceRootPath' | 'workingDirectoryPolicy' | 'workingDirectoryRelativePath'>): string;
+export declare function executeCLIRuntimeCommand(options: {
+    command: string;
+    args?: string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    stdinPayload?: string;
+    timeoutMs: number;
+    maxCapturedBytes?: number;
+}): Promise<CLIRuntimeCommandExecutionResult>;
+//# sourceMappingURL=cli-runtime-runner.backend.utils.d.ts.map

package/dist/esm/flows-actors/utils/cli-runtime-runner.backend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime-runner.backend.utils.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/utils/cli-runtime-runner.backend.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAE5B,MAAM,sCAAsC,CAAC;AAE9C,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADhD,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKnD;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,IAAI,CAAC,2BAA2B,EAAE,mBAAmB,GAAG,wBAAwB,GAAG,8BAA8B,CAAC,GAC1H,MAAM,CAyBR;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,gCAAgC,CAAC,CA6G5C"}

package/dist/esm/flows-actors/utils/cli-runtime-runner.backend.utils.js

@@ -0,0 +1,131 @@
+import { spawn } from 'node:child_process';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { CLIRuntime_WorkingDirectoryPolicy, } from '@wildo-ai/external-connectors-models';
+export class CLIRuntimeRunnerError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'CLIRuntimeRunnerError';
+    }
+}
+export function resolveCLIRuntimeWorkingDirectory(profile) {
+    if (!isAbsolute(profile.workspaceRootPath)) {
+        throw new CLIRuntimeRunnerError('CLI runtime workspaceRootPath must be an absolute path', {
+            workspaceRootPath: profile.workspaceRootPath,
+        });
+    }
+    const normalizedWorkspaceRoot = resolve(profile.workspaceRootPath);
+    const workingDirectory = profile.workingDirectoryPolicy === CLIRuntime_WorkingDirectoryPolicy.WORKSPACE_RELATIVE_PATH
+        ? resolve(normalizedWorkspaceRoot, profile.workingDirectoryRelativePath ?? '')
+        : normalizedWorkspaceRoot;
+    const relativePathFromRoot = relative(normalizedWorkspaceRoot, workingDirectory);
+    if (relativePathFromRoot.startsWith('..')
+        || relativePathFromRoot.includes('/../')
+        || relativePathFromRoot.includes('\\..\\')) {
+        throw new CLIRuntimeRunnerError('CLI runtime working directory escaped the trusted workspace root', {
+            workspaceRootPath: normalizedWorkspaceRoot,
+            workingDirectory,
+        });
+    }
+    return workingDirectory;
+}
+export async function executeCLIRuntimeCommand(options) {
+    const maxCapturedBytes = options.maxCapturedBytes ?? 1024 * 1024;
+    return new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(options.command, options.args ?? [], {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            detached: process.platform !== 'win32',
+        });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const settle = (error, result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timeoutHandle);
+            if (error) {
+                rejectPromise(error);
+                return;
+            }
+            resolvePromise(result ?? { stdout, stderr, exitCode: 0, signal: null });
+        };
+        const terminateProcessTree = (signal) => {
+            if (child.pid && process.platform !== 'win32') {
+                try {
+                    process.kill(-child.pid, signal);
+                    return;
+                }
+                catch {
+                    // Fall through to child.kill for platforms/processes that do not
+                    // support group signalling.
+                }
+            }
+            try {
+                child.kill(signal);
+            }
+            catch {
+                // Best effort termination only.
+            }
+        };
+        const failForCapturedOutputLimit = () => {
+            terminateProcessTree('SIGTERM');
+            settle(new CLIRuntimeRunnerError('CLI runtime output exceeded the allowed capture limit', {
+                maxCapturedBytes,
+            }));
+        };
+        const timeoutHandle = setTimeout(() => {
+            terminateProcessTree('SIGTERM');
+            setTimeout(() => terminateProcessTree('SIGKILL'), 2_000);
+            settle(new CLIRuntimeRunnerError('CLI runtime command timed out', {
+                timeoutMs: options.timeoutMs,
+            }));
+        }, options.timeoutMs);
+        child.on('error', (error) => {
+            settle(new CLIRuntimeRunnerError(`Failed to start CLI runtime command: ${error.message}`, {
+                originalError: error.message,
+            }));
+        });
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+            if ((Buffer.byteLength(stdout) + Buffer.byteLength(stderr)) > maxCapturedBytes) {
+                failForCapturedOutputLimit();
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+            if ((Buffer.byteLength(stdout) + Buffer.byteLength(stderr)) > maxCapturedBytes) {
+                failForCapturedOutputLimit();
+            }
+        });
+        child.on('close', (exitCode, signal) => {
+            if (settled) {
+                return;
+            }
+            if (exitCode !== 0) {
+                settle(new CLIRuntimeRunnerError('CLI runtime command failed', {
+                    exitCode,
+                    signal,
+                    stderr,
+                    stdout,
+                }));
+                return;
+            }
+            settle(undefined, {
+                stdout,
+                stderr,
+                exitCode,
+                signal,
+            });
+        });
+        if (options.stdinPayload !== undefined) {
+            child.stdin.write(options.stdinPayload);
+        }
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=cli-runtime-runner.backend.utils.js.map

package/dist/esm/flows-actors/utils/cli-runtime-runner.backend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime-runner.backend.utils.js","sourceRoot":"","sources":["../../../../src/flows-actors/utils/cli-runtime-runner.backend.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/flows-actors/utils/flows-actors-frontend-extractor.utils.d.ts

@@ -0,0 +1,15 @@
+import { FlowActorSystem, FlowActorSystem_FrontendInfo } from '@wildo-ai/saas-models';
+/**
+ * Extract frontend-relevant information from a FlowActorSystem.
+ * This filters the full system configuration to only what the frontend needs.
+ */
+export declare function extractFlowActorSystemFrontendInfo(system: FlowActorSystem): FlowActorSystem_FrontendInfo;
+/**
+ * Filter systems to only those with frontend visibility
+ */
+export declare function filterFrontendVisibleSystems(systems: FlowActorSystem[]): FlowActorSystem[];
+/**
+ * Extract frontend info for all frontend-visible systems
+ */
+export declare function extractAllFrontendVisibleSystemsInfo(systems: FlowActorSystem[]): FlowActorSystem_FrontendInfo[];
+//# sourceMappingURL=flows-actors-frontend-extractor.utils.d.ts.map

package/dist/esm/flows-actors/utils/flows-actors-frontend-extractor.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-actors-frontend-extractor.utils.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/utils/flows-actors-frontend-extractor.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,4BAA4B,EAK7B,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,eAAe,GACtB,4BAA4B,CA0B9B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EAAE,GACzB,eAAe,EAAE,CAInB;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,eAAe,EAAE,GACzB,4BAA4B,EAAE,CAGhC"}

package/dist/esm/flows-actors/utils/flows-actors-frontend-extractor.utils.js

@@ -0,0 +1,43 @@
+import { FlowActorSystem_Visibility, ResourcePrimaryScope, } from '@wildo-ai/saas-models';
+/**
+ * Extract frontend-relevant information from a FlowActorSystem.
+ * This filters the full system configuration to only what the frontend needs.
+ */
+export function extractFlowActorSystemFrontendInfo(system) {
+    const config = system.config;
+    // Extract relevant config from accessControl, executionRestrictions, etc.
+    // Note: accessControl is an array, we take the first entry for primary scope info
+    const primaryAccessControl = config.accessControl[0];
+    const frontendRelevantConfig = {
+        primaryScope: primaryAccessControl?.primaryScope ?? ResourcePrimaryScope.ORGANIZATIONS,
+        requiresApproval: primaryAccessControl?.requiresApproval ?? false,
+        approverRoles: primaryAccessControl?.approverRoles,
+        riskLevel: config.riskLevel, // riskLevel is directly on config, not under executionRestrictions
+        hasBudgetLimits: !!(config.executionRestrictions?.budgetLimits?.maxCost),
+    };
+    return {
+        ref: system.ref,
+        displayName: system.displayName,
+        description: system.description,
+        kind: system.kind,
+        status: system.status,
+        category: system.category,
+        tags: system.tags,
+        metadata: system.metadata,
+        frontendRelevantConfig,
+    };
+}
+/**
+ * Filter systems to only those with frontend visibility
+ */
+export function filterFrontendVisibleSystems(systems) {
+    return systems.filter(system => system.visibility === FlowActorSystem_Visibility.FRONTEND);
+}
+/**
+ * Extract frontend info for all frontend-visible systems
+ */
+export function extractAllFrontendVisibleSystemsInfo(systems) {
+    return filterFrontendVisibleSystems(systems)
+        .map(extractFlowActorSystemFrontendInfo);
+}
+//# sourceMappingURL=flows-actors-frontend-extractor.utils.js.map

package/dist/esm/flows-actors/utils/flows-actors-frontend-extractor.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-actors-frontend-extractor.utils.js","sourceRoot":"","sources":["../../../../src/flows-actors/utils/flows-actors-frontend-extractor.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,0BAA0B,EAE1B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,0EAA0E;IAC1E,kFAAkF;IAClF,MAAM,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAErD,MAAM,sBAAsB,GAA2C;QACrE,YAAY,EAAE,oBAAoB,EAAE,YAAY,IAAI,oBAAoB,CAAC,aAAa;QACtF,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,IAAI,KAAK;QACjE,aAAa,EAAE,oBAAoB,EAAE,aAAa;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,mEAAmE;QAChG,eAAe,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,EAAE,YAAY,EAAE,OAAO,CAAC;KACzE,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,sBAAsB;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAA0B;IAE1B,OAAO,OAAO,CAAC,MAAM,CACnB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,0BAA0B,CAAC,QAAQ,CACpE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAClD,OAA0B;IAE1B,OAAO,4BAA4B,CAAC,OAAO,CAAC;SACzC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/esm/flows-actors/utils/prompt-ir-adapters.backend.utils.d.ts

@@ -0,0 +1,66 @@
+import 'reflect-metadata';
+import { PromptIR_ContextItem, Actors_Memory_Context, ArtifactInstance, RAG_RetrievalResult } from '@wildo-ai/saas-models';
+/**
+ * Convert Actors_Memory_Context to PromptIR_ContextItem[]
+ *
+ * Flattens all memory scopes (short-term, long-term, working) into
+ * a single array of context items with appropriate trust levels.
+ *
+ * @param memory - The actor's memory context
+ * @param actorRef - Optional actor reference for ID prefixing
+ * @returns Array of context items
+ */
+export declare function memoryToContextItems(memory: Actors_Memory_Context, actorRef?: string): PromptIR_ContextItem[];
+/**
+ * Convert ArtifactInstance to PromptIR_ContextItem
+ *
+ * Artifacts from previous steps are considered MEDIUM trust
+ * (they were generated by agents, not verified by humans).
+ *
+ * Temporal awareness: Always populates timestamp for context ordering
+ * and recency-aware curation. Falls back to current time if not set.
+ *
+ * @param artifact - The artifact instance
+ * @returns Context item representation
+ */
+export declare function artifactToContextItem(artifact: ArtifactInstance): PromptIR_ContextItem;
+/**
+ * Convert multiple ArtifactInstance[] to PromptIR_ContextItem[]
+ *
+ * @param artifacts - Array of artifact instances
+ * @returns Array of context items
+ */
+export declare function artifactsToContextItems(artifacts: ArtifactInstance[]): PromptIR_ContextItem[];
+/**
+ * Convert RAG_RetrievalResult to PromptIR_ContextItem[]
+ *
+ * RAG results are considered MEDIUM trust (from owned docs but
+ * may be incomplete or outdated).
+ *
+ * Temporal awareness: Always populates timestamp for context ordering
+ * and recency-aware curation. Uses document indexedAt if available,
+ * falls back to retrieval timestamp, then current time.
+ *
+ * @param result - The RAG retrieval result
+ * @returns Array of context items
+ */
+export declare function ragToContextItems(result: RAG_RetrievalResult): PromptIR_ContextItem[];
+/**
+ * Convert user input to PromptIR_ContextItem
+ *
+ * User inputs are considered LOW trust (untrusted source).
+ *
+ * @param input - The user input (string or object)
+ * @param inputId - Unique identifier for this input
+ * @returns Context item representation
+ */
+export declare function userInputToContextItem(input: string | Record<string, unknown>, inputId: string): PromptIR_ContextItem;
+/**
+ * Merge multiple context item arrays
+ * Removes duplicates by id (first occurrence wins)
+ *
+ * @param arrays - Arrays of context items to merge
+ * @returns Merged array with duplicates removed
+ */
+export declare function mergeContextItems(...arrays: PromptIR_ContextItem[][]): PromptIR_ContextItem[];
+//# sourceMappingURL=prompt-ir-adapters.backend.utils.d.ts.map

package/dist/esm/flows-actors/utils/prompt-ir-adapters.backend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-ir-adapters.backend.utils.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/utils/prompt-ir-adapters.backend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EAGpB,qBAAqB,EAGrB,gBAAgB,EAChB,mBAAmB,EAEpB,MAAM,uBAAuB,CAAC;AAmE/B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB,EAAE,CAoBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,oBAAoB,CAiCtF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,oBAAoB,EAAE,CAE7F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,EAAE,CAqBrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,oBAAoB,CAetB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,oBAAoB,EAAE,CAc7F"}

package/dist/esm/flows-actors/utils/prompt-ir-adapters.backend.utils.js

@@ -0,0 +1,219 @@
+import 'reflect-metadata';
+import { PromptIR_TrustLevel, PromptIR_ContextSourceKind, Actors_Memory_Scope, FlowsActors_IO_PartKind, } from '@wildo-ai/saas-models';
+//===============================================================
+// Prompt IR Adapters
+// --------
+// Utility functions to convert existing Wildo types into
+// PromptIR_ContextItem format for prompt compilation.
+// These adapters bridge the gap between domain types and
+// the unified context representation used by the compiler.
+//===============================================================
+/**
+ * Map memory scope to trust level
+ * - Long-term memory: HIGH (verified, persistent knowledge)
+ * - Short-term memory: MEDIUM (recent but unverified)
+ * - Working memory: MEDIUM (active processing state)
+ */
+function memoryTrustLevel(scope) {
+    switch (scope) {
+        case Actors_Memory_Scope.LONG_TERM:
+            return PromptIR_TrustLevel.HIGH;
+        case Actors_Memory_Scope.SHORT_TERM:
+        case Actors_Memory_Scope.WORKING:
+        default:
+            return PromptIR_TrustLevel.MEDIUM;
+    }
+}
+/**
+ * Convert a single memory entry to PromptIR_ContextItem
+ *
+ * Temporal awareness: Always populates timestamp for context ordering
+ * and recency-aware curation. Falls back to current time if not set.
+ */
+function memoryEntryToContextItem(entry, scope, prefix) {
+    // Serialize value based on type
+    let content;
+    if (entry.type === 'text') {
+        content = String(entry.value);
+    }
+    else if (entry.type === 'json') {
+        content = JSON.stringify(entry.value, null, 2);
+    }
+    else {
+        content = `[Binary data: ${entry.key}]`;
+    }
+    return {
+        id: `${prefix}_${entry.key}`,
+        content,
+        trust: memoryTrustLevel(scope),
+        sourceKind: PromptIR_ContextSourceKind.MEMORY,
+        // Temporal awareness: always populate timestamp
+        timestamp: entry.timestamp ?? new Date().toISOString(),
+        metadata: {
+            scope,
+            key: entry.key,
+            type: entry.type,
+            expiresAt: entry.expiresAt,
+            ...entry.metadata,
+        },
+    };
+}
+/**
+ * Convert Actors_Memory_Context to PromptIR_ContextItem[]
+ *
+ * Flattens all memory scopes (short-term, long-term, working) into
+ * a single array of context items with appropriate trust levels.
+ *
+ * @param memory - The actor's memory context
+ * @param actorRef - Optional actor reference for ID prefixing
+ * @returns Array of context items
+ */
+export function memoryToContextItems(memory, actorRef) {
+    const items = [];
+    const prefix = actorRef ? `mem_${actorRef}` : 'mem';
+    // Process short-term memory
+    for (const entry of memory.shortTerm.entries) {
+        items.push(memoryEntryToContextItem(entry, Actors_Memory_Scope.SHORT_TERM, `${prefix}_st`));
+    }
+    // Process long-term memory
+    for (const entry of memory.longTerm.entries) {
+        items.push(memoryEntryToContextItem(entry, Actors_Memory_Scope.LONG_TERM, `${prefix}_lt`));
+    }
+    // Process working memory
+    for (const entry of memory.working.entries) {
+        items.push(memoryEntryToContextItem(entry, Actors_Memory_Scope.WORKING, `${prefix}_wk`));
+    }
+    return items;
+}
+/**
+ * Convert ArtifactInstance to PromptIR_ContextItem
+ *
+ * Artifacts from previous steps are considered MEDIUM trust
+ * (they were generated by agents, not verified by humans).
+ *
+ * Temporal awareness: Always populates timestamp for context ordering
+ * and recency-aware curation. Falls back to current time if not set.
+ *
+ * @param artifact - The artifact instance
+ * @returns Context item representation
+ */
+export function artifactToContextItem(artifact) {
+    let content;
+    switch (artifact.type) {
+        case FlowsActors_IO_PartKind.TEXT:
+            content = artifact.content.text || '';
+            break;
+        case FlowsActors_IO_PartKind.STRUCTURED:
+        case FlowsActors_IO_PartKind.RAW_DATA:
+            content = JSON.stringify(artifact.content.data, null, 2);
+            break;
+        case FlowsActors_IO_PartKind.FILE:
+            // For files, include reference info but not binary data
+            const fileContent = artifact.content;
+            content = `[File: ${artifact.name}]\nPath: ${fileContent.storage?.path || fileContent.storage?.url || 'N/A'}`;
+            break;
+    }
+    return {
+        id: `artifact_${artifact.ref}`,
+        content,
+        trust: PromptIR_TrustLevel.MEDIUM,
+        sourceKind: PromptIR_ContextSourceKind.ARTIFACT,
+        // Temporal awareness: always populate timestamp
+        timestamp: artifact.createdAt ?? new Date().toISOString(),
+        metadata: {
+            name: artifact.name,
+            type: artifact.type,
+            definitionRef: artifact.definitionRef,
+            origin: artifact.origin,
+            ...artifact.metadata,
+        },
+    };
+}
+/**
+ * Convert multiple ArtifactInstance[] to PromptIR_ContextItem[]
+ *
+ * @param artifacts - Array of artifact instances
+ * @returns Array of context items
+ */
+export function artifactsToContextItems(artifacts) {
+    return artifacts.map(artifactToContextItem);
+}
+/**
+ * Convert RAG_RetrievalResult to PromptIR_ContextItem[]
+ *
+ * RAG results are considered MEDIUM trust (from owned docs but
+ * may be incomplete or outdated).
+ *
+ * Temporal awareness: Always populates timestamp for context ordering
+ * and recency-aware curation. Uses document indexedAt if available,
+ * falls back to retrieval timestamp, then current time.
+ *
+ * @param result - The RAG retrieval result
+ * @returns Array of context items
+ */
+export function ragToContextItems(result) {
+    const retrievalTimestamp = result.timestamp ?? new Date().toISOString();
+    return result.results.map((item, index) => ({
+        id: `rag_${item.documentId}_${item.chunkId || index}`,
+        content: item.content,
+        trust: PromptIR_TrustLevel.MEDIUM,
+        sourceKind: PromptIR_ContextSourceKind.RAG,
+        relevance: item.score,
+        // Temporal awareness: prefer document timestamp, fallback to retrieval time
+        timestamp: item.metadata?.indexedAt ?? item.metadata?.updatedAt ?? retrievalTimestamp,
+        metadata: {
+            query: result.query,
+            documentId: item.documentId,
+            chunkId: item.chunkId,
+            retrievalStrategy: result.retrievalStrategy,
+            duration: result.duration,
+            retrievedAt: retrievalTimestamp, // Track when retrieval happened
+            ...item.metadata,
+        },
+    }));
+}
+/**
+ * Convert user input to PromptIR_ContextItem
+ *
+ * User inputs are considered LOW trust (untrusted source).
+ *
+ * @param input - The user input (string or object)
+ * @param inputId - Unique identifier for this input
+ * @returns Context item representation
+ */
+export function userInputToContextItem(input, inputId) {
+    const content = typeof input === 'string'
+        ? input
+        : JSON.stringify(input, null, 2);
+    return {
+        id: `user_input_${inputId}`,
+        content,
+        trust: PromptIR_TrustLevel.LOW,
+        sourceKind: PromptIR_ContextSourceKind.USER_INPUT,
+        timestamp: new Date().toISOString(),
+        metadata: {
+            inputType: typeof input,
+        },
+    };
+}
+/**
+ * Merge multiple context item arrays
+ * Removes duplicates by id (first occurrence wins)
+ *
+ * @param arrays - Arrays of context items to merge
+ * @returns Merged array with duplicates removed
+ */
+export function mergeContextItems(...arrays) {
+    const seen = new Set();
+    const result = [];
+    for (const items of arrays) {
+        for (const item of items) {
+            if (!seen.has(item.id)) {
+                seen.add(item.id);
+                result.push(item);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=prompt-ir-adapters.backend.utils.js.map

package/dist/esm/flows-actors/utils/prompt-ir-adapters.backend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-ir-adapters.backend.utils.js","sourceRoot":"","sources":["../../../../src/flows-actors/utils/prompt-ir-adapters.backend.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/guidance/batches/dormancy-detection.batch.backend.service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Dormancy Detection Batch Job
+ *
+ * This batch job runs periodically (configurable via lifecycle config) and performs:
+ * 1. Query all lifecycle states where currentStage is in DORMANCY_SOURCE_STAGES
+ *    and lastActiveAt is older than the dormancy threshold
+ * 2. Transition each to DORMANT via LifecycleEvaluatorBackendService
+ * 3. WS events are pushed per transition (handled by the evaluator)
+ *
+ * Uses createCustomBatchExecutionService — same pattern as createFilesCleanupBatch().
+ * Evaluator accessed via late-binding getLifecycleEvaluator().
+ */
+import { createCustomBatchExecutionService } from '../../base-classes/services/batches/batches-cronjobs-custom-execution.service.js';
+/** @param cronSchedule — from LifecycleConfig.dormancyCronSchedule (flows from appConfig) */
+export declare function createDormancyDetectionBatch(cronSchedule?: string): ReturnType<typeof createCustomBatchExecutionService>;
+export declare const DORMANCY_DETECTION_BATCH_REF = "lifecycle:dormancy-detection";
+//# sourceMappingURL=dormancy-detection.batch.backend.service.d.ts.map

package/dist/esm/guidance/batches/dormancy-detection.batch.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dormancy-detection.batch.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/guidance/batches/dormancy-detection.batch.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iCAAiC,EAAE,MAAM,4FAA4F,CAAC;AAgC/I,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAC1C,YAAY,GAAE,MAAsB,GACnC,UAAU,CAAC,OAAO,iCAAiC,CAAC,CA2EtD;AAED,eAAO,MAAM,4BAA4B,iCAAiC,CAAC"}