@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/apps/app-steward/src/types/steward.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Steward-specific wallet types.
+ *
+ * `StewardPolicyResult` and `StewardApprovalInfo` are still defined in
+ * `@elizaos/shared/contracts/wallet` because the BSC trade response types
+ * there reference them. Re-export them here so consumers only need a single
+ * import path for steward work.
+ */
+import type { StewardApprovalInfo, StewardBalanceResponse, StewardPolicyResult, StewardTokenBalancesResponse, StewardWalletAddressesResponse, StewardWebhookEvent, StewardWebhookEventsResponse, StewardWebhookEventType } from "@elizaos/shared/contracts";
+export type { StewardApprovalInfo, StewardBalanceResponse, StewardPolicyResult, StewardTokenBalancesResponse, StewardWalletAddressesResponse, StewardWebhookEvent, StewardWebhookEventsResponse, StewardWebhookEventType, };
+/** Response from GET /api/wallet/steward-status. */
+export interface StewardStatusResponse {
+    configured: boolean;
+    available: boolean;
+    connected: boolean;
+    baseUrl?: string;
+    agentId?: string;
+    evmAddress?: string;
+    error?: string | null;
+    walletAddresses?: {
+        evm: string | null;
+        solana: string | null;
+    };
+    agentName?: string;
+    vaultHealth?: "ok" | "degraded" | "error";
+}
+export type StewardTxStatus = "pending" | "approved" | "rejected" | "signed" | "broadcast" | "confirmed" | "failed";
+/** A transaction record from the Steward vault history. */
+export interface StewardTxRecord {
+    id: string;
+    agentId: string;
+    status: StewardTxStatus;
+    request: {
+        agentId: string;
+        tenantId: string;
+        to: string;
+        value: string;
+        data?: string;
+        chainId: number;
+    };
+    txHash?: string;
+    policyResults: StewardPolicyResult[];
+    createdAt: string;
+    signedAt?: string;
+    confirmedAt?: string;
+}
+/** A pending approval entry from the Steward approval queue. */
+export interface StewardPendingApproval {
+    queueId: string;
+    status: "pending" | "approved" | "rejected";
+    requestedAt: string;
+    transaction: StewardTxRecord;
+}
+/** Response shape for GET /api/wallet/steward-history */
+export type StewardHistoryResponse = StewardTxRecord[];
+/** Response shape for GET /api/wallet/steward-pending */
+export type StewardPendingResponse = StewardPendingApproval[];
+/** Response shape for POST /api/wallet/steward-approve and steward-reject */
+export interface StewardApprovalActionResponse {
+    ok: boolean;
+    txHash?: string;
+    error?: string;
+}
+/** Request body for signing a transaction through the Steward vault. */
+export interface StewardSignRequest {
+    to: string;
+    value: string;
+    chainId: number;
+    data?: string;
+    broadcast?: boolean;
+    description?: string;
+}
+/** Response from a Steward vault sign operation. */
+export interface StewardSignResponse {
+    approved: boolean;
+    txHash?: string;
+    txId?: string;
+    pending?: boolean;
+    denied?: boolean;
+    violations?: Array<{
+        policy: string;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=steward.d.ts.map

package/apps/app-steward/src/types/steward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-steward/src/types/steward.ts"],"names":[],"mappings":"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"}

package/apps/app-steward/src/types/steward.js

@@ -0,0 +1,9 @@
+/**
+ * Steward-specific wallet types.
+ *
+ * `StewardPolicyResult` and `StewardApprovalInfo` are still defined in
+ * `@elizaos/shared/contracts/wallet` because the BSC trade response types
+ * there reference them. Re-export them here so consumers only need a single
+ * import path for steward work.
+ */
+export {};

package/apps/app-training/src/backends/atropos.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Atropos training backend.
+ *
+ * Atropos is the open-source RL/SFT training stack used elsewhere in the
+ * elizaOS ecosystem. There is no in-repo TypeScript SDK, so this backend
+ * stages the dataset to the location atropos expects and prints next steps.
+ *
+ * Activation:
+ *   bun run train -- --backend atropos --dataset <path> [--task <task>]
+ *
+ * Environment:
+ *   ATROPOS_DATA_DIR  Where atropos picks up datasets. Defaults to
+ *                     `<repo>/.milady/training/atropos`.
+ *   ATROPOS_BIN       Optional path to a local atropos CLI binary.
+ */
+export interface AtroposBackendOptions {
+    datasetPath: string;
+    task?: string;
+    dataDir?: string;
+    bin?: string;
+}
+export interface AtroposBackendResult {
+    stagedPath: string;
+    bin: string | null;
+    invoked: boolean;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+}
+export declare function runAtroposBackend(options: AtroposBackendOptions): Promise<AtroposBackendResult>;
+//# sourceMappingURL=atropos.d.ts.map

package/apps/app-training/src/backends/atropos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atropos.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-training/src/backends/atropos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAaD,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAoC/B"}

package/apps/app-training/src/backends/atropos.js

@@ -0,0 +1,63 @@
+/**
+ * Atropos training backend.
+ *
+ * Atropos is the open-source RL/SFT training stack used elsewhere in the
+ * elizaOS ecosystem. There is no in-repo TypeScript SDK, so this backend
+ * stages the dataset to the location atropos expects and prints next steps.
+ *
+ * Activation:
+ *   bun run train -- --backend atropos --dataset <path> [--task <task>]
+ *
+ * Environment:
+ *   ATROPOS_DATA_DIR  Where atropos picks up datasets. Defaults to
+ *                     `<repo>/.milady/training/atropos`.
+ *   ATROPOS_BIN       Optional path to a local atropos CLI binary.
+ */
+import { mkdirSync, copyFileSync, existsSync } from "node:fs";
+import { join, basename, resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+function resolveDataDir(override) {
+    if (override)
+        return override;
+    const fromEnv = process.env.ATROPOS_DATA_DIR?.trim();
+    if (fromEnv)
+        return fromEnv;
+    const stateDir = process.env.MILADY_STATE_DIR?.trim() ||
+        process.env.ELIZA_STATE_DIR?.trim() ||
+        join(process.env.HOME ?? "", ".milady");
+    return join(stateDir, "training", "atropos");
+}
+export async function runAtroposBackend(options) {
+    if (!existsSync(options.datasetPath)) {
+        throw new Error(`Dataset not found at ${options.datasetPath}`);
+    }
+    const dataDir = resolveDataDir(options.dataDir);
+    const taskDir = options.task ? join(dataDir, options.task) : dataDir;
+    mkdirSync(taskDir, { recursive: true });
+    const stagedPath = join(taskDir, basename(options.datasetPath));
+    copyFileSync(resolve(options.datasetPath), stagedPath);
+    const bin = options.bin ?? process.env.ATROPOS_BIN ?? null;
+    if (!bin) {
+        console.log("[atropos] Dataset staged to:", stagedPath);
+        console.log("[atropos] Atropos CLI not configured. Set ATROPOS_BIN or pass --bin to invoke it directly.");
+        console.log("[atropos] Next steps:");
+        console.log(`  1. Install atropos and point ATROPOS_BIN at the binary.`);
+        console.log(`  2. Re-run with --backend atropos to launch training.`);
+        return { stagedPath, bin: null, invoked: false };
+    }
+    const spawnArgs = ["--dataset", stagedPath];
+    if (options.task)
+        spawnArgs.push("--task", options.task);
+    const result = spawnSync(bin, spawnArgs, {
+        stdio: "pipe",
+        encoding: "utf-8",
+    });
+    return {
+        stagedPath,
+        bin,
+        invoked: true,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        exitCode: result.status,
+    };
+}

package/apps/app-training/src/backends/native.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Native local-inference training backend.
+ *
+ * Dispatches a per-task JSONL dataset (produced by `dataset-generator.ts` /
+ * `trajectory-task-datasets.ts`) through one of the native optimizers
+ * (`instruction-search`, `prompt-evolution`, `bootstrap-fewshot`) and writes
+ * the resulting artifact into the `~/.milady/optimized-prompts/` store.
+ *
+ * Activation:
+ *   bun run train -- --backend native --optimizer instruction-search \
+ *     --dataset <path> --task <task>
+ *
+ * The backend is pure — it does not touch the network. It calls
+ * `runtime.useModel(ModelType.TEXT_LARGE, …)` for variant generation and the
+ * same model for scoring. Operators can swap the model via the optimizer
+ * options without changing this file.
+ */
+import { type LlmAdapter, type OptimizerName, type OptimizerResult, type UseModelHandler } from "../optimizers/index.js";
+import type { TrajectoryTrainingTask } from "../core/trajectory-task-datasets.js";
+export interface NativeBackendOptions {
+    /**
+     * JSONL dataset produced by exportTrajectoryTaskDatasets. Each line is a
+     * Gemini-style `{ messages: [{ role, content }, …] }` row.
+     */
+    datasetPath: string;
+    task: TrajectoryTrainingTask;
+    optimizer: OptimizerName;
+    /** Used for the artifact baseline + datasetId. */
+    baselinePrompt: string;
+    datasetId?: string;
+    /** Loose runtime shape — only useModel is required. */
+    runtime: {
+        useModel: UseModelHandler;
+    };
+    /** Override adapter (tests). */
+    adapter?: LlmAdapter;
+}
+export interface NativeBackendResult {
+    invoked: boolean;
+    optimizer: OptimizerName;
+    task: TrajectoryTrainingTask;
+    datasetSize: number;
+    score: number;
+    baselineScore: number;
+    result: OptimizerResult;
+    notes: string[];
+}
+export declare function runNativeBackend(options: NativeBackendOptions): Promise<NativeBackendResult>;
+export declare const NATIVE_OPTIMIZERS: readonly OptimizerName[];
+//# sourceMappingURL=native.d.ts.map

package/apps/app-training/src/backends/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-training/src/backends/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAGN,KAAK,UAAU,EAEf,KAAK,aAAa,EAClB,KAAK,eAAe,EAIpB,KAAK,eAAe,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE;QAAE,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC;IACvC,gCAAgC;IAChC,OAAO,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAsFD,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,aAAa,EAI5C,CAAC"}

package/apps/app-training/src/backends/native.js

@@ -0,0 +1,128 @@
+/**
+ * Native local-inference training backend.
+ *
+ * Dispatches a per-task JSONL dataset (produced by `dataset-generator.ts` /
+ * `trajectory-task-datasets.ts`) through one of the native optimizers
+ * (`instruction-search`, `prompt-evolution`, `bootstrap-fewshot`) and writes
+ * the resulting artifact into the `~/.milady/optimized-prompts/` store.
+ *
+ * Activation:
+ *   bun run train -- --backend native --optimizer instruction-search \
+ *     --dataset <path> --task <task>
+ *
+ * The backend is pure — it does not touch the network. It calls
+ * `runtime.useModel(ModelType.TEXT_LARGE, …)` for variant generation and the
+ * same model for scoring. Operators can swap the model via the optimizer
+ * options without changing this file.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { createPromptScorer, createRuntimeAdapter, runBootstrapFewshot, runInstructionSearch, runPromptEvolution, } from "../optimizers/index.js";
+function parseJsonlDataset(path) {
+    if (!existsSync(path)) {
+        throw new Error(`[native-backend] dataset not found at ${path}`);
+    }
+    const raw = readFileSync(path, "utf-8");
+    const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+    const examples = [];
+    let index = 0;
+    for (const line of lines) {
+        const parsedJson = JSON.parse(line);
+        if (!isJsonlRow(parsedJson)) {
+            throw new Error(`[native-backend] dataset line ${index + 1} is not a {messages: [...]} row`);
+        }
+        const example = rowToExample(parsedJson, index);
+        if (example)
+            examples.push(example);
+        index += 1;
+    }
+    return examples;
+}
+function isJsonlRow(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return Array.isArray(candidate.messages);
+}
+function rowToExample(row, index) {
+    let system;
+    let user;
+    let expected;
+    for (const msg of row.messages) {
+        if (msg.role === "system" && typeof msg.content === "string") {
+            system = msg.content;
+        }
+        if (msg.role === "user" && typeof msg.content === "string") {
+            // Concatenate when multiple user turns appear; the trajectory
+            // exporter already collapses these for single-turn tasks.
+            user = user ? `${user}\n${msg.content}` : msg.content;
+        }
+        if (msg.role === "model" && typeof msg.content === "string") {
+            expected = msg.content;
+        }
+    }
+    if (!user || !expected)
+        return null;
+    return {
+        id: `row-${index}`,
+        input: { system, user },
+        expectedOutput: expected,
+    };
+}
+function dispatchOptimizer(optimizer, input) {
+    switch (optimizer) {
+        case "instruction-search":
+            return runInstructionSearch(input);
+        case "prompt-evolution":
+            return runPromptEvolution(input);
+        case "bootstrap-fewshot":
+            return runBootstrapFewshot(input);
+    }
+}
+export async function runNativeBackend(options) {
+    const dataset = parseJsonlDataset(options.datasetPath);
+    if (dataset.length === 0) {
+        return {
+            invoked: false,
+            optimizer: options.optimizer,
+            task: options.task,
+            datasetSize: 0,
+            score: 0,
+            baselineScore: 0,
+            result: {
+                optimizedPrompt: options.baselinePrompt,
+                score: 0,
+                baseline: 0,
+                lineage: [],
+            },
+            notes: [
+                `dataset at ${options.datasetPath} parsed to 0 usable rows; nothing to optimize`,
+            ],
+        };
+    }
+    const adapter = options.adapter ?? createRuntimeAdapter(options.runtime.useModel);
+    const scorer = createPromptScorer(adapter);
+    const result = await dispatchOptimizer(options.optimizer, {
+        baselinePrompt: options.baselinePrompt,
+        dataset,
+        scorer,
+        llm: adapter,
+    });
+    return {
+        invoked: true,
+        optimizer: options.optimizer,
+        task: options.task,
+        datasetSize: dataset.length,
+        score: result.score,
+        baselineScore: result.baseline,
+        result,
+        notes: [
+            `optimizer=${options.optimizer} dataset=${basename(options.datasetPath)} size=${dataset.length} baseline=${result.baseline.toFixed(3)} optimized=${result.score.toFixed(3)}`,
+        ],
+    };
+}
+export const NATIVE_OPTIMIZERS = [
+    "instruction-search",
+    "prompt-evolution",
+    "bootstrap-fewshot",
+];

package/apps/app-training/src/backends/tinker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Thinking Machines Tinker training backend.
+ *
+ * Tinker is the SDK from Thinking Machines for hosted SFT/RLHF runs. The
+ * Node SDK package name (`@thinking-machines/tinker`) is loaded lazily so
+ * the rest of the training app does not require it to be installed.
+ *
+ * Activation:
+ *   bun run train -- --backend tinker --dataset <path> [--task <task>]
+ *
+ * Environment:
+ *   TINKER_API_KEY    Required when the SDK is installed.
+ *   TINKER_PROJECT    Tinker project ID.
+ */
+export interface TinkerBackendOptions {
+    datasetPath: string;
+    task?: string;
+    apiKey?: string;
+    project?: string;
+}
+export interface TinkerBackendResult {
+    invoked: boolean;
+    jobId?: string;
+    notes: string[];
+}
+export declare function runTinkerBackend(options: TinkerBackendOptions): Promise<TinkerBackendResult>;
+//# sourceMappingURL=tinker.d.ts.map

package/apps/app-training/src/backends/tinker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinker.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-training/src/backends/tinker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAuD9B"}

package/apps/app-training/src/backends/tinker.js

@@ -0,0 +1,56 @@
+/**
+ * Thinking Machines Tinker training backend.
+ *
+ * Tinker is the SDK from Thinking Machines for hosted SFT/RLHF runs. The
+ * Node SDK package name (`@thinking-machines/tinker`) is loaded lazily so
+ * the rest of the training app does not require it to be installed.
+ *
+ * Activation:
+ *   bun run train -- --backend tinker --dataset <path> [--task <task>]
+ *
+ * Environment:
+ *   TINKER_API_KEY    Required when the SDK is installed.
+ *   TINKER_PROJECT    Tinker project ID.
+ */
+import { existsSync } from "node:fs";
+const TINKER_PACKAGE_NAME = "@thinking-machines/tinker";
+export async function runTinkerBackend(options) {
+    if (!existsSync(options.datasetPath)) {
+        throw new Error(`Dataset not found at ${options.datasetPath}`);
+    }
+    const notes = [];
+    const apiKey = options.apiKey ?? process.env.TINKER_API_KEY;
+    const project = options.project ?? process.env.TINKER_PROJECT;
+    let sdk = null;
+    try {
+        // Optional dependency — load via runtime resolution. We deliberately
+        // avoid a static import so app-training builds without the SDK.
+        const dynamicImport = new Function("name", "return import(name);");
+        const mod = (await dynamicImport(TINKER_PACKAGE_NAME));
+        const candidate = mod && typeof mod === "object" && "default" in mod
+            ? mod.default
+            : mod;
+        if (candidate && typeof candidate === "object") {
+            sdk = candidate;
+        }
+    }
+    catch {
+        notes.push(`Tinker SDK not installed. Add it with \`bun add ${TINKER_PACKAGE_NAME}\` and set TINKER_API_KEY to enable hosted training.`);
+        return { invoked: false, notes };
+    }
+    if (!apiKey) {
+        notes.push("TINKER_API_KEY is not set; skipping job submission.");
+        return { invoked: false, notes };
+    }
+    if (!sdk?.createJob || typeof sdk.createJob !== "function") {
+        notes.push(`Tinker SDK was loaded but does not expose createJob(); update ${TINKER_PACKAGE_NAME}.`);
+        return { invoked: false, notes };
+    }
+    const job = await sdk.createJob({
+        datasetPath: options.datasetPath,
+        task: options.task,
+        project,
+    });
+    notes.push(`Tinker job submitted (id=${job?.id ?? "unknown"})`);
+    return { invoked: true, jobId: job?.id, notes };
+}

package/apps/app-training/src/core/privacy-filter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Privacy filter for trajectory exports.
+ *
+ * Three jobs:
+ *   1. Anonymize cross-platform handles by mapping them to opaque entity IDs
+ *      (the caller supplies a lookup callback so app-training does not have
+ *      to depend on the relationships service directly).
+ *   2. Honor `ContactPreferences.privacyLevel` — drop entire trajectories if
+ *      the participating entity is `private`.
+ *   3. Strip credential references — env-var name patterns from process.env,
+ *      plus the usual API key shapes (`sk-…`, `Bearer …`).
+ *
+ * Run automatically before any export to disk; required for any cloud upload.
+ */
+export type PrivacyLevel = "public" | "limited" | "private";
+export interface AnonymizerLookup {
+    /** Look up the opaque entity ID for a (platform, handle) pair. */
+    resolveEntityId(platform: string, handle: string): string | null;
+    /** Look up the privacy level for an entity. Defaults to "public". */
+    getPrivacyLevel?(entityId: string): PrivacyLevel | undefined;
+}
+export interface PrivacyFilterOptions {
+    /** Optional anonymizer lookup. If absent, handles pass through unchanged. */
+    anonymizer?: AnonymizerLookup;
+    /**
+     * Additional credential shapes to redact. Each entry is matched as a
+     * RegExp against any string field; matches are replaced with
+     * `<REDACTED:{label}>`.
+     */
+    extraCredentialPatterns?: Array<{
+        label: string;
+        pattern: RegExp;
+    }>;
+    /**
+     * Snapshot of `process.env` keys to treat as credential names.
+     * Defaults to capturing all env names matching the standard secret regex.
+     */
+    envKeySnapshot?: string[];
+    /**
+     * Hard list of platforms the anonymizer recognizes. Used to constrain
+     * cross-platform handle detection. Defaults to common platforms.
+     */
+    platforms?: string[];
+}
+export interface FilterableTrajectory {
+    trajectoryId?: string;
+    steps?: Array<{
+        llmCalls?: Array<{
+            systemPrompt?: string;
+            userPrompt?: string;
+            response?: string;
+        }>;
+    }>;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface FilterResult<T> {
+    trajectories: T[];
+    dropped: Array<{
+        trajectoryId?: string;
+        reason: string;
+    }>;
+    redactionCount: number;
+    anonymizationCount: number;
+}
+/**
+ * Apply the privacy filter to a list of trajectories. Returns the filtered
+ * list with credential references redacted and platform handles replaced by
+ * opaque entity IDs. Trajectories whose anonymized entities are marked as
+ * `private` are dropped wholesale.
+ */
+export declare function applyPrivacyFilter<T extends FilterableTrajectory>(trajectories: T[], options?: PrivacyFilterOptions): FilterResult<T>;
+//# sourceMappingURL=privacy-filter.d.ts.map

package/apps/app-training/src/core/privacy-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-filter.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-training/src/core/privacy-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAChC,kEAAkE;IAClE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,qEAAqE;IACrE,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,oBAAoB;IACpC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;QACb,QAAQ,CAAC,EAAE,KAAK,CAAC;YAChB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACH,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AA2HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,oBAAoB,EAChE,YAAY,EAAE,CAAC,EAAE,EACjB,OAAO,GAAE,oBAAyB,GAChC,YAAY,CAAC,CAAC,CAAC,CAkFjB"}