cognitive-core 0.1.0 → 0.2.0

package/dist/learning/trajectory-sources/entire.d.ts

@@ -0,0 +1,31 @@
+import type { SessionBank, SessionRecord } from '../../session-bank/index.js';
+import type { TrajectorySource, TrajectoryWithAnalysis, TrajectoryLoadOptions } from '../../types/trajectory-source.js';
+import type { Trajectory } from '../../types/trajectory.js';
+export interface SessionSynthesisOptions {
+    /** Domain to assign (default: inferred from files) */
+    domain?: string;
+    /** How to determine success/failure (default: 'summary') */
+    outcomeStrategy?: 'summary' | 'heuristic';
+    /** Source name for trajectory IDs and metadata (default: auto-detected from branch) */
+    sourceName?: string;
+}
+export declare class SessionTrajectorySource implements TrajectorySource {
+    private sessionBank;
+    private options?;
+    readonly name: string;
+    constructor(sessionBank: SessionBank, options?: SessionSynthesisOptions | undefined);
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+    /**
+     * Convert a SessionRecord into a cognitive-core Trajectory.
+     */
+    synthesize(session: SessionRecord): Trajectory;
+    private resolveSourceName;
+    private extractTask;
+    private extractSteps;
+    private inferOutcome;
+    private inferDomain;
+    private getFirstUserMessage;
+    private findToolResult;
+}
+//# sourceMappingURL=entire.d.ts.map

package/dist/learning/trajectory-sources/entire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entire.d.ts","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/entire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAiB5D,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAC1C,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,uBAAwB,YAAW,gBAAgB;IAI5D,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,OAAO,CAAC;IAJlB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGZ,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,uBAAuB,YAAA;IAKrC,IAAI,CACR,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAsB9B,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU;IA0B9C,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAwDpB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/learning/trajectory-sources/entire.js

@@ -0,0 +1,189 @@
+export class SessionTrajectorySource {
+    sessionBank;
+    options;
+    name;
+    constructor(sessionBank, options) {
+        this.sessionBank = sessionBank;
+        this.options = options;
+        this.name = options?.sourceName ?? 'session';
+    }
+    async load(options) {
+        const result = await this.sessionBank.query({
+            since: options?.since,
+            limit: options?.limit,
+        });
+        const items = [];
+        for (const session of result.sessions) {
+            try {
+                const trajectory = this.synthesize(session);
+                if (options?.domain && trajectory.task.domain !== options.domain)
+                    continue;
+                if (options?.successOnly && !trajectory.outcome.success)
+                    continue;
+                items.push({ trajectory, analysis: undefined });
+            }
+            catch {
+                // Skip sessions that fail to synthesize
+            }
+        }
+        return items;
+    }
+    async count(options) {
+        return this.sessionBank.count({
+            since: options?.since,
+        });
+    }
+    /**
+     * Convert a SessionRecord into a cognitive-core Trajectory.
+     */
+    synthesize(session) {
+        const sourceName = this.resolveSourceName(session);
+        return {
+            id: `${sourceName}-${session.checkpointId}-${session.sessionId}`,
+            task: this.extractTask(session),
+            steps: this.extractSteps(session),
+            outcome: this.inferOutcome(session),
+            agentId: session.metadata.agent,
+            timestamp: session.metadata.createdAt,
+            llmCalls: session.tokenUsage.apiCallCount,
+            totalTokens: session.tokenUsage.total,
+            wallTimeSeconds: 0,
+            metadata: {
+                source: sourceName,
+                checkpointId: session.checkpointId,
+                sessionId: session.sessionId,
+                branch: session.metadata.branch,
+                filesTouched: session.metadata.filesTouched,
+                strategy: session.metadata.strategy,
+                attribution: session.attribution,
+            },
+        };
+    }
+    // ── Private helpers ──────────────────────────────────────────
+    resolveSourceName(_session) {
+        if (this.options?.sourceName)
+            return this.options.sourceName;
+        return 'sessionlog';
+    }
+    extractTask(session) {
+        const description = session.summary?.intent ??
+            this.getFirstUserMessage(session) ??
+            'Unknown task';
+        return {
+            id: `task-${session.sessionId}`,
+            domain: this.options?.domain ?? this.inferDomain(session),
+            description,
+            context: {
+                filesTouched: session.metadata.filesTouched,
+                branch: session.metadata.branch,
+            },
+            metadata: {},
+            createdAt: session.metadata.createdAt,
+        };
+    }
+    extractSteps(session) {
+        const steps = [];
+        for (const msg of session.transcript) {
+            if (msg.role !== 'assistant')
+                continue;
+            const textBlocks = msg.content.filter((b) => b.type === 'text');
+            const thought = textBlocks
+                .map((b) => b.text)
+                .join('\n');
+            const toolBlocks = msg.content.filter((b) => b.type === 'tool_use');
+            if (toolBlocks.length === 0) {
+                // Pure reasoning step
+                if (thought) {
+                    steps.push({
+                        thought,
+                        action: '',
+                        observation: '',
+                        timestamp: session.metadata.createdAt,
+                        metadata: { messageUuid: msg.uuid },
+                    });
+                }
+            }
+            else {
+                for (const tool of toolBlocks) {
+                    const t = tool;
+                    const observation = this.findToolResult(session.transcript, t.id);
+                    steps.push({
+                        thought: steps.length === 0 || thought ? thought : undefined,
+                        action: `${t.name}(${JSON.stringify(t.input)})`,
+                        observation: observation ?? '',
+                        timestamp: session.metadata.createdAt,
+                        metadata: {
+                            messageUuid: msg.uuid,
+                            toolName: t.name,
+                            toolUseId: t.id,
+                        },
+                    });
+                }
+            }
+        }
+        return steps;
+    }
+    inferOutcome(session) {
+        const strategy = this.options?.outcomeStrategy ?? 'summary';
+        if (strategy === 'summary' && session.summary) {
+            const outcome = session.summary.outcome.toLowerCase();
+            const success = !outcome.includes('fail') &&
+                !outcome.includes('error') &&
+                !outcome.includes('unable') &&
+                !outcome.includes('could not');
+            return {
+                success,
+                partialScore: success ? 1.0 : 0.0,
+                verificationDetails: {
+                    sessionOutcome: session.summary.outcome,
+                    frictionPoints: session.summary.frictionPoints,
+                    openItems: session.summary.openItems,
+                },
+            };
+        }
+        // Heuristic fallback
+        const hasFiles = session.metadata.filesTouched.length > 0;
+        return {
+            success: hasFiles,
+            partialScore: hasFiles ? 0.7 : 0.3,
+            verificationDetails: { strategy: 'heuristic' },
+        };
+    }
+    inferDomain(session) {
+        const files = session.metadata.filesTouched;
+        if (files.some((f) => /\.(test|spec)\.(ts|js|tsx|jsx)$/.test(f)))
+            return 'testing';
+        if (files.some((f) => /\.(ts|tsx)$/.test(f)))
+            return 'typescript';
+        if (files.some((f) => /\.py$/.test(f)))
+            return 'python';
+        if (files.some((f) => /\.go$/.test(f)))
+            return 'go';
+        if (files.some((f) => /\.rs$/.test(f)))
+            return 'rust';
+        return 'code';
+    }
+    getFirstUserMessage(session) {
+        const firstUser = session.transcript.find((m) => m.role === 'user');
+        if (!firstUser)
+            return undefined;
+        const textBlock = firstUser.content.find((b) => b.type === 'text');
+        return textBlock
+            ? textBlock.text
+            : undefined;
+    }
+    findToolResult(messages, toolUseId) {
+        for (const msg of messages) {
+            if (msg.role !== 'user')
+                continue;
+            for (const block of msg.content) {
+                if (block.type === 'tool_result' &&
+                    block.toolUseId === toolUseId) {
+                    return block.content;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=entire.js.map

package/dist/learning/trajectory-sources/entire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entire.js","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/entire.ts"],"names":[],"mappings":"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"}

package/dist/learning/trajectory-sources/file.d.ts

@@ -0,0 +1,23 @@
+import type { TrajectorySource, TrajectoryWithAnalysis, TrajectoryLoadOptions } from '../../types/trajectory-source.js';
+/**
+ * FileTrajectorySource — loads trajectory JSON files from a directory.
+ *
+ * Expects files named `*.json` containing serialized Trajectory objects.
+ * Optionally reads companion `*-analysis.json` files for pre-computed analyses.
+ *
+ * @example
+ * ```typescript
+ * const source = new FileTrajectorySource('/path/to/trajectories');
+ * const items = await source.load({ domain: 'code' });
+ * ```
+ */
+export declare class FileTrajectorySource implements TrajectorySource {
+    readonly name = "file";
+    private dirPath;
+    constructor(dirPath: string);
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+    private readAll;
+    private filter;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/learning/trajectory-sources/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAG1C;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAIrB,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKxE,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;YAK/C,OAAO;IAgErB,OAAO,CAAC,MAAM;CA8Bf"}

package/dist/learning/trajectory-sources/file.js

@@ -0,0 +1,101 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { TrajectorySchema } from '../../types/trajectory.js';
+import { loadJson } from '../../utils/storage.js';
+/**
+ * FileTrajectorySource — loads trajectory JSON files from a directory.
+ *
+ * Expects files named `*.json` containing serialized Trajectory objects.
+ * Optionally reads companion `*-analysis.json` files for pre-computed analyses.
+ *
+ * @example
+ * ```typescript
+ * const source = new FileTrajectorySource('/path/to/trajectories');
+ * const items = await source.load({ domain: 'code' });
+ * ```
+ */
+export class FileTrajectorySource {
+    name = 'file';
+    dirPath;
+    constructor(dirPath) {
+        this.dirPath = dirPath;
+    }
+    async load(options) {
+        const items = await this.readAll();
+        return this.filter(items, options);
+    }
+    async count(options) {
+        const items = await this.readAll();
+        return this.filter(items, options).length;
+    }
+    async readAll() {
+        const items = [];
+        let files;
+        try {
+            files = await readdir(this.dirPath);
+        }
+        catch {
+            return [];
+        }
+        const trajectoryFiles = files.filter((f) => f.endsWith('.json') && !f.endsWith('-analysis.json'));
+        for (const file of trajectoryFiles) {
+            try {
+                const filePath = join(this.dirPath, file);
+                const raw = await loadJson(filePath);
+                if (!raw)
+                    continue;
+                // Parse dates from JSON (they come as strings)
+                if (typeof raw.timestamp === 'string') {
+                    raw.timestamp = new Date(raw.timestamp);
+                }
+                // Task.createdAt
+                const task = raw.task;
+                if (task && typeof task.createdAt === 'string') {
+                    task.createdAt = new Date(task.createdAt);
+                }
+                if (Array.isArray(raw.steps)) {
+                    for (const step of raw.steps) {
+                        if (typeof step === 'object' &&
+                            step !== null &&
+                            typeof step.timestamp === 'string') {
+                            step.timestamp = new Date(step.timestamp);
+                        }
+                    }
+                }
+                const parsed = TrajectorySchema.safeParse(raw);
+                if (!parsed.success)
+                    continue;
+                // Try loading companion analysis file
+                const analysisFile = file.replace('.json', '-analysis.json');
+                const analysis = await loadJson(join(this.dirPath, analysisFile));
+                items.push({
+                    trajectory: parsed.data,
+                    analysis: analysis ?? undefined,
+                });
+            }
+            catch {
+                // Skip invalid files
+            }
+        }
+        return items;
+    }
+    filter(items, options) {
+        let result = items;
+        if (options?.since) {
+            const since = options.since.getTime();
+            result = result.filter((item) => item.trajectory.timestamp.getTime() >= since);
+        }
+        if (options?.domain) {
+            const domain = options.domain;
+            result = result.filter((item) => item.trajectory.task.domain === domain);
+        }
+        if (options?.successOnly) {
+            result = result.filter((item) => item.trajectory.outcome.success);
+        }
+        if (options?.limit && options.limit > 0) {
+            result = result.slice(0, options.limit);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/learning/trajectory-sources/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/file.ts"],"names":[],"mappings":"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"}

package/dist/learning/trajectory-sources/huggingface.d.ts

@@ -0,0 +1,36 @@
+import { type DataclawSourceOptions } from './dataclaw.js';
+import type { TrajectorySource, TrajectoryWithAnalysis, TrajectoryLoadOptions } from '../../types/trajectory-source.js';
+export interface HuggingFaceSourceOptions extends DataclawSourceOptions {
+    /** HF API token for gated/private datasets */
+    token?: string;
+    /** Dataset config name (default: 'default') */
+    config?: string;
+    /** Dataset split (default: 'train') */
+    split?: string;
+    /** Max rows to fetch per API call (default: 100, max: 100) */
+    pageSize?: number;
+    /** Override the datasets-server base URL (useful for testing) */
+    baseUrl?: string;
+    /** Override fetch for testing / custom HTTP clients */
+    fetchFn?: typeof globalThis.fetch;
+}
+export declare class HuggingFaceTrajectorySource implements TrajectorySource {
+    readonly name = "huggingface";
+    private readonly datasetId;
+    private readonly config;
+    private readonly split;
+    private readonly pageSize;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    private readonly token;
+    private readonly synthesizer;
+    private readonly dataclawOptions;
+    constructor(datasetId: string, options?: HuggingFaceSourceOptions);
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+    private buildHeaders;
+    private fetchRowCount;
+    private fetchAllSessions;
+    private fetchPage;
+}
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/learning/trajectory-sources/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/huggingface.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAkB1C,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACnC;AAyBD,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;gBAGlE,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,wBAAwB;IAyB9B,IAAI,CACR,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IA8C9B,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB7D,OAAO,CAAC,YAAY;YAcN,aAAa;YAgBb,gBAAgB;YAyBhB,SAAS;CAoBxB"}

package/dist/learning/trajectory-sources/huggingface.js

@@ -0,0 +1,157 @@
+import { DataclawSessionSchema, } from '../../types/dataclaw.js';
+import { DataclawTrajectorySource, } from './dataclaw.js';
+// ─── HuggingFaceTrajectorySource ─────────────────────────────────────────
+// Loads dataclaw-format datasets directly from the Hugging Face Hub.
+//
+// Uses the HF datasets-server rows API to fetch sessions as JSON, then
+// delegates synthesis to DataclawTrajectorySource.synthesize().
+//
+// Usage:
+//   const source = new HuggingFaceTrajectorySource(
+//     'peteromallet/dataclaw-peteromallet',
+//   );
+//   const items = await source.load({ limit: 50 });
+// ─────────────────────────────────────────────────────────────────────────
+const DEFAULT_BASE_URL = 'https://datasets-server.huggingface.co';
+const DEFAULT_PAGE_SIZE = 100;
+export class HuggingFaceTrajectorySource {
+    name = 'huggingface';
+    datasetId;
+    config;
+    split;
+    pageSize;
+    baseUrl;
+    fetchFn;
+    token;
+    synthesizer;
+    dataclawOptions;
+    constructor(datasetId, options) {
+        this.datasetId = datasetId;
+        this.config = options?.config ?? 'default';
+        this.split = options?.split ?? 'train';
+        this.pageSize = Math.min(options?.pageSize ?? DEFAULT_PAGE_SIZE, 100);
+        this.baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
+        this.token = options?.token;
+        this.fetchFn = options?.fetchFn ?? globalThis.fetch;
+        // Build dataclaw options (source/model filtering, domain, outcome strategy)
+        this.dataclawOptions = {
+            domain: options?.domain,
+            outcomeStrategy: options?.outcomeStrategy,
+            sources: options?.sources,
+            models: options?.models,
+        };
+        // Use a dummy-path DataclawTrajectorySource solely for its synthesize() method
+        this.synthesizer = new DataclawTrajectorySource('/dev/null', this.dataclawOptions);
+    }
+    async load(options) {
+        const sessions = await this.fetchAllSessions();
+        const items = [];
+        for (const session of sessions) {
+            try {
+                // Pre-filter by dataclaw-specific options
+                if (this.dataclawOptions?.sources?.length &&
+                    !this.dataclawOptions.sources.includes(session.source)) {
+                    continue;
+                }
+                if (this.dataclawOptions?.models?.length &&
+                    !this.dataclawOptions.models.includes(session.model)) {
+                    continue;
+                }
+                const trajectory = this.synthesizer.synthesize(session);
+                // Apply standard TrajectoryLoadOptions filters
+                if (options?.since && trajectory.timestamp.getTime() < options.since.getTime()) {
+                    continue;
+                }
+                if (options?.domain && trajectory.task.domain !== options.domain) {
+                    continue;
+                }
+                if (options?.successOnly && !trajectory.outcome.success) {
+                    continue;
+                }
+                items.push({ trajectory, analysis: undefined });
+            }
+            catch {
+                // Skip sessions that fail to synthesize
+            }
+        }
+        if (options?.limit && options.limit > 0) {
+            return items.slice(0, options.limit);
+        }
+        return items;
+    }
+    async count(options) {
+        // If no filters, use the info endpoint for a fast count
+        if (!options && !this.dataclawOptions?.sources?.length && !this.dataclawOptions?.models?.length) {
+            try {
+                return await this.fetchRowCount();
+            }
+            catch {
+                // Fall back to loading everything
+            }
+        }
+        const items = await this.load(options);
+        return items.length;
+    }
+    // ── Private: HF API ────────────────────────────────────────────────
+    buildHeaders() {
+        const headers = {
+            'Accept': 'application/json',
+        };
+        const token = this.token ??
+            process.env.HF_TOKEN ??
+            process.env.HUGGING_FACE_HUB_TOKEN;
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        return headers;
+    }
+    async fetchRowCount() {
+        const url = `${this.baseUrl}/info?dataset=${encodeURIComponent(this.datasetId)}`;
+        const response = await this.fetchFn(url, { headers: this.buildHeaders() });
+        if (!response.ok) {
+            throw new Error(`HF info request failed: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const configInfo = data.dataset_info[this.config];
+        if (!configInfo) {
+            throw new Error(`Config "${this.config}" not found in dataset info`);
+        }
+        return configInfo.num_rows;
+    }
+    async fetchAllSessions() {
+        const sessions = [];
+        let offset = 0;
+        let total = Infinity;
+        while (offset < total) {
+            const page = await this.fetchPage(offset);
+            total = page.num_rows_total;
+            for (const { row } of page.rows) {
+                const parsed = DataclawSessionSchema.safeParse(row);
+                if (parsed.success) {
+                    sessions.push(parsed.data);
+                }
+            }
+            offset += page.rows.length;
+            // Safety: if the page returned 0 rows, stop to avoid infinite loop
+            if (page.rows.length === 0)
+                break;
+        }
+        return sessions;
+    }
+    async fetchPage(offset) {
+        const params = new URLSearchParams({
+            dataset: this.datasetId,
+            config: this.config,
+            split: this.split,
+            offset: String(offset),
+            length: String(this.pageSize),
+        });
+        const url = `${this.baseUrl}/rows?${params}`;
+        const response = await this.fetchFn(url, { headers: this.buildHeaders() });
+        if (!response.ok) {
+            throw new Error(`HF rows request failed: ${response.status} ${response.statusText} (offset=${offset})`);
+        }
+        return (await response.json());
+    }
+}
+//# sourceMappingURL=huggingface.js.map

package/dist/learning/trajectory-sources/huggingface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.js","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/huggingface.ts"],"names":[],"mappings":"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"}

package/dist/learning/trajectory-sources/in-memory.d.ts

@@ -0,0 +1,21 @@
+import type { TrajectorySource, TrajectoryWithAnalysis, TrajectoryLoadOptions } from '../../types/trajectory-source.js';
+/**
+ * InMemoryTrajectorySource — wraps a user-provided array of trajectories.
+ *
+ * Simplest source: pass in trajectories you already have in memory.
+ *
+ * @example
+ * ```typescript
+ * const source = new InMemoryTrajectorySource(myTrajectories);
+ * await knowledgeBank.extractFrom(source);
+ * ```
+ */
+export declare class InMemoryTrajectorySource implements TrajectorySource {
+    readonly name = "in-memory";
+    private items;
+    constructor(items: TrajectoryWithAnalysis[]);
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+    private filter;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/learning/trajectory-sources/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/learning/trajectory-sources/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,KAAK,CAA2B;gBAE5B,KAAK,EAAE,sBAAsB,EAAE;IAIrC,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAIxE,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D,OAAO,CAAC,MAAM;CA2Bf"}

package/dist/learning/trajectory-sources/in-memory.js

@@ -0,0 +1,43 @@
+/**
+ * InMemoryTrajectorySource — wraps a user-provided array of trajectories.
+ *
+ * Simplest source: pass in trajectories you already have in memory.
+ *
+ * @example
+ * ```typescript
+ * const source = new InMemoryTrajectorySource(myTrajectories);
+ * await knowledgeBank.extractFrom(source);
+ * ```
+ */
+export class InMemoryTrajectorySource {
+    name = 'in-memory';
+    items;
+    constructor(items) {
+        this.items = items;
+    }
+    async load(options) {
+        return this.filter(options);
+    }
+    async count(options) {
+        return this.filter(options).length;
+    }
+    filter(options) {
+        let result = this.items;
+        if (options?.since) {
+            const since = options.since.getTime();
+            result = result.filter((item) => item.trajectory.timestamp.getTime() >= since);
+        }
+        if (options?.domain) {
+            const domain = options.domain;
+            result = result.filter((item) => item.trajectory.task.domain === domain);
+        }
+        if (options?.successOnly) {
+            result = result.filter((item) => item.trajectory.outcome.success);
+        }
+        if (options?.limit && options.limit > 0) {
+            result = result.slice(0, options.limit);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=in-memory.js.map