skein-cli 0.1.0-alpha.1

package/dist/conv/sources/opencode.js

@@ -0,0 +1,92 @@
+import { promises as fs } from 'node:fs';
+import { CursorStore } from '../cursor.js';
+import { opencodeConvReader, opencodeDbPath } from '../../adapters/opencode/conv-reader.js';
+/**
+ * Live tee source for OpenCode.
+ *
+ * OpenCode persists sessions in a SQLite database at
+ * `~/.local/share/opencode/opencode.db`. There's no rowid-style append
+ * marker we can rely on (sessions can be updated in place), so the
+ * source instead remembers which session ids have already been emitted
+ * to disk and re-emits only what's new on each tick.
+ */
+const POLL_INTERVAL_MS = 2_000;
+export function startOpencodeWatcher(sink, opts) {
+    const interval = opts.intervalMs ?? POLL_INTERVAL_MS;
+    const prefix = opts.cursorPrefix ?? 'opencode:';
+    const cursors = new CursorStore();
+    const dbPath = opencodeDbPath(opts.homeDir);
+    let timer;
+    let running = false;
+    let totalEvents = 0;
+    const emittedSessions = new Set();
+    return {
+        async start() {
+            if (running)
+                return;
+            running = true;
+            await cursors.load();
+            const tick = async () => {
+                if (!running)
+                    return;
+                try {
+                    totalEvents += await poll(opts.homeDir, dbPath, sink, cursors, prefix, emittedSessions);
+                }
+                catch (err) {
+                    process.emit('warning', err);
+                }
+                if (running)
+                    timer = setTimeout(tick, interval);
+            };
+            await tick();
+        },
+        async stop() {
+            running = false;
+            if (timer)
+                clearTimeout(timer);
+            timer = undefined;
+        },
+        tally() {
+            return totalEvents;
+        },
+    };
+}
+async function poll(homeDir, dbPath, sink, cursors, prefix, emittedSessions) {
+    try {
+        await fs.access(dbPath);
+    }
+    catch {
+        return 0;
+    }
+    let total = 0;
+    for await (const summary of opencodeConvReader.listSessions({ homeDir })) {
+        const key = `${prefix}${summary.id}`;
+        if (cursors.get(key) > 0 || emittedSessions.has(summary.id))
+            continue;
+        let seq = 0;
+        let opened = false;
+        for await (const event of opencodeConvReader.readSession(summary.id, { homeDir })) {
+            if (event.type === 'session.start') {
+                await sink.openSession(event.id, {
+                    tool: event.tool,
+                    ...(event.toolVersion ? { toolVersion: event.toolVersion } : {}),
+                    ...(event.model ? { model: event.model } : {}),
+                    ...(event.project ? { project: event.project } : {}),
+                    ...(event.title ? { title: event.title } : {}),
+                    startedAt: event.ts,
+                });
+                opened = true;
+                continue;
+            }
+            if (event.type === 'message' && opened) {
+                await sink.write(event.session, event);
+                seq += 1;
+                total += 1;
+            }
+        }
+        emittedSessions.add(summary.id);
+        await cursors.set(key, Math.max(seq, 1));
+    }
+    return total;
+}
+//# sourceMappingURL=opencode.js.map

package/dist/conv/sources/opencode.js.map

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

package/dist/conv/store.d.ts

@@ -0,0 +1,10 @@
+import type { ConvEvent, ConvSessionSummary } from '../schema/conv.js';
+export interface ConvStorePaths {
+    root: string;
+    sessions: string;
+    attachments: string;
+}
+export declare function storePaths(): ConvStorePaths;
+export declare function ensureStore(): Promise<ConvStorePaths>;
+export declare function writeSession(summary: ConvSessionSummary, events: AsyncIterable<ConvEvent>): Promise<string>;
+export declare function listStoredSessions(): Promise<string[]>;

package/dist/conv/store.js

@@ -0,0 +1,75 @@
+import { createWriteStream } from 'node:fs';
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { ensureDir } from '../util/fs.js';
+import { getToolPaths, SKEIN_SUBDIRS } from '../util/paths.js';
+export function storePaths() {
+    const paths = getToolPaths();
+    return {
+        root: join(paths.skeinDir, SKEIN_SUBDIRS.conv),
+        sessions: join(paths.skeinDir, SKEIN_SUBDIRS.convSessions),
+        attachments: join(paths.skeinDir, SKEIN_SUBDIRS.convAttachments),
+    };
+}
+export async function ensureStore() {
+    const paths = storePaths();
+    await ensureDir(paths.sessions);
+    await ensureDir(paths.attachments);
+    return paths;
+}
+export async function writeSession(summary, events) {
+    const paths = await ensureStore();
+    const yyyymm = monthSlug(summary.startedAt);
+    const dir = join(paths.sessions, yyyymm);
+    await ensureDir(dir);
+    const filePath = join(dir, `${sanitize(summary.id)}.jsonl`);
+    const stream = createWriteStream(filePath, { flags: 'w' });
+    try {
+        for await (const event of events) {
+            stream.write(`${JSON.stringify(event)}\n`);
+        }
+    }
+    finally {
+        await new Promise(resolve => stream.end(resolve));
+    }
+    return filePath;
+}
+function monthSlug(iso) {
+    if (!iso)
+        return 'unknown';
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return 'unknown';
+    return `${d.getUTCFullYear()}/${String(d.getUTCMonth() + 1).padStart(2, '0')}`;
+}
+function sanitize(id) {
+    return id.replace(/[^a-zA-Z0-9._-]/g, '_');
+}
+export async function listStoredSessions() {
+    const paths = storePaths();
+    if (!(await pathExists(paths.sessions)))
+        return [];
+    const out = [];
+    await walkSessions(paths.sessions, out);
+    return out;
+}
+async function walkSessions(dir, acc) {
+    const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory())
+            await walkSessions(path, acc);
+        else if (entry.name.endsWith('.jsonl'))
+            acc.push(path);
+    }
+}
+async function pathExists(path) {
+    try {
+        await fs.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/conv/store.js.map

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

package/dist/conv/title.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Read a session JSONL and return the best available title.
+ *
+ * Priority:
+ *  1. Explicit title on session.start
+ *  2. First user message text trimmed to MAX_LEN
+ *  3. Tool + model fallback
+ */
+export declare function deriveTitle(path: string): Promise<string | undefined>;

package/dist/conv/title.js

@@ -0,0 +1,74 @@
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+const MAX_LEN = 80;
+/**
+ * Read a session JSONL and return the best available title.
+ *
+ * Priority:
+ *  1. Explicit title on session.start
+ *  2. First user message text trimmed to MAX_LEN
+ *  3. Tool + model fallback
+ */
+export async function deriveTitle(path) {
+    let explicitTitle;
+    let firstUserText;
+    let tool;
+    let model;
+    for await (const line of readLines(path)) {
+        const event = safeJson(line);
+        if (!event)
+            continue;
+        if (event.type === 'session.start') {
+            if (event.title)
+                explicitTitle = event.title;
+            tool = event.tool;
+            if (event.model)
+                model = event.model;
+            if (explicitTitle)
+                return explicitTitle;
+        }
+        if (event.type === 'message' && event.role === 'user' && !firstUserText) {
+            for (const block of event.content) {
+                if (block.type === 'text' && block.text.trim().length > 0) {
+                    firstUserText = sanitize(block.text);
+                    break;
+                }
+            }
+            if (firstUserText)
+                break;
+        }
+    }
+    if (explicitTitle)
+        return explicitTitle;
+    if (firstUserText)
+        return firstUserText;
+    if (tool && model)
+        return `${tool} · ${model}`;
+    return tool;
+}
+function sanitize(raw) {
+    const collapsed = raw
+        .replace(/<[^>]+>/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (collapsed.length <= MAX_LEN)
+        return collapsed;
+    return `${collapsed.slice(0, MAX_LEN - 1)}…`;
+}
+async function* readLines(path) {
+    const stream = createReadStream(path, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Number.POSITIVE_INFINITY });
+    for await (const line of rl) {
+        if (line.trim())
+            yield line;
+    }
+}
+function safeJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=title.js.map

package/dist/conv/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/conv/title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,MAAM,OAAO,GAAG,EAAE,CAAA;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,aAAiC,CAAA;IACrC,IAAI,aAAiC,CAAA;IACrC,IAAI,IAAwB,CAAA;IAC5B,IAAI,KAAyB,CAAA;IAE7B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAY,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,KAAK;gBAAE,aAAa,GAAG,KAAK,CAAC,KAAK,CAAA;YAC5C,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;YACjB,IAAI,KAAK,CAAC,KAAK;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;YACpC,IAAI,aAAa;gBAAE,OAAO,aAAa,CAAA;QACzC,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACxE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1D,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;oBACpC,MAAK;gBACP,CAAC;YACH,CAAC;YACD,IAAI,aAAa;gBAAE,MAAK;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,IAAI,IAAI,IAAI,KAAK;QAAE,OAAO,GAAG,IAAI,MAAM,KAAK,EAAE,CAAA;IAC9C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,SAAS,GAAG,GAAG;SAClB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;IACT,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO;QAAE,OAAO,SAAS,CAAA;IACjD,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAA;AAC9C,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;IAC3D,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAClF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAI,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/conv/watcher.d.ts

@@ -0,0 +1,28 @@
+export type SourceName = 'claude-code' | 'codex' | 'opencode' | 'aider';
+export interface WatcherOptions {
+    homeDir: string;
+    sources?: SourceName[];
+    intervalMs?: number;
+    /** Project path for Aider (defaults to cwd). */
+    projectPath?: string;
+}
+export interface WatcherTally {
+    source: SourceName;
+    events: number;
+}
+/**
+ * Composite watcher that fans out to every requested source and aggregates
+ * the per-source event tallies. Each source writes to the shared sink so
+ * every captured event ends up in the same `~/.skein/conv/sessions/` layout.
+ */
+export declare class Watcher {
+    private readonly opts;
+    private readonly sink;
+    private readonly sources;
+    private started;
+    constructor(opts: WatcherOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    tallies(): WatcherTally[];
+    private buildSource;
+}

package/dist/conv/watcher.js

@@ -0,0 +1,75 @@
+import { JsonlSink } from './sink.js';
+import { startClaudeCodeWatcher } from './sources/claude-code.js';
+import { startCodexWatcher } from './sources/codex.js';
+import { startOpencodeWatcher } from './sources/opencode.js';
+import { startAiderWatcher } from './sources/aider.js';
+const ALL_SOURCES = ['claude-code', 'codex', 'opencode', 'aider'];
+/**
+ * Composite watcher that fans out to every requested source and aggregates
+ * the per-source event tallies. Each source writes to the shared sink so
+ * every captured event ends up in the same `~/.skein/conv/sessions/` layout.
+ */
+export class Watcher {
+    opts;
+    sink = new JsonlSink();
+    sources = new Map();
+    started = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        const requested = this.opts.sources ?? ALL_SOURCES;
+        for (const name of requested) {
+            const source = this.buildSource(name);
+            if (source)
+                this.sources.set(name, source);
+        }
+        await Promise.all([...this.sources.values()].map(s => s.start()));
+    }
+    async stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        await Promise.all([...this.sources.values()].map(s => s.stop()));
+        await this.sink.closeAll();
+    }
+    tallies() {
+        const out = [];
+        for (const [name, source] of this.sources) {
+            out.push({ source: name, events: source.tally() });
+        }
+        return out;
+    }
+    buildSource(name) {
+        if (name === 'claude-code') {
+            return startClaudeCodeWatcher(this.sink, {
+                homeDir: this.opts.homeDir,
+                ...(this.opts.intervalMs ? { intervalMs: this.opts.intervalMs } : {}),
+            });
+        }
+        if (name === 'codex') {
+            return startCodexWatcher(this.sink, {
+                homeDir: this.opts.homeDir,
+                ...(this.opts.intervalMs ? { intervalMs: this.opts.intervalMs } : {}),
+            });
+        }
+        if (name === 'opencode') {
+            return startOpencodeWatcher(this.sink, {
+                homeDir: this.opts.homeDir,
+                ...(this.opts.intervalMs ? { intervalMs: this.opts.intervalMs } : {}),
+            });
+        }
+        if (name === 'aider') {
+            return startAiderWatcher(this.sink, {
+                homeDir: this.opts.homeDir,
+                ...(this.opts.projectPath ? { projectPath: this.opts.projectPath } : {}),
+                ...(this.opts.intervalMs ? { intervalMs: this.opts.intervalMs } : {}),
+            });
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/conv/watcher.js.map

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

package/dist/conv/zip.d.ts

@@ -0,0 +1,11 @@
+export interface ZipEntry {
+    name: string;
+    method: number;
+    uncompressedSize: number;
+    compressedSize: number;
+    body: Buffer;
+}
+export declare function readZipFile(path: string): Promise<ZipEntry[]>;
+export declare function parseZip(buffer: Buffer): ZipEntry[];
+export declare function findEntry(entries: ZipEntry[], name: string): ZipEntry | undefined;
+export declare function findEntriesByExt(entries: ZipEntry[], ext: string): ZipEntry[];

package/dist/conv/zip.js

@@ -0,0 +1,82 @@
+import { promises as fs } from 'node:fs';
+import { inflateRawSync } from 'node:zlib';
+/**
+ * Minimal PKZIP central-directory reader.
+ *
+ * Supports STORED (method 0) and DEFLATE (method 8) — the two methods
+ * used by every real-world ZIP file. No streaming, no encryption, no
+ * ZIP64. The largest ChatGPT export the author has seen is ~50 MB; we
+ * read into memory, which is fine for the v0.4 acceptance target.
+ *
+ * Reference: PKWARE APPNOTE.TXT (Application Note) §4.3.
+ */
+const LFH_SIGNATURE = 0x04034b50; // 'PK\x03\x04'
+const CDH_SIGNATURE = 0x02014b50; // 'PK\x01\x02'
+const EOCD_SIGNATURE = 0x06054b50; // 'PK\x05\x06'
+export async function readZipFile(path) {
+    const buffer = await fs.readFile(path);
+    return parseZip(buffer);
+}
+export function parseZip(buffer) {
+    const eocdOffset = findEocd(buffer);
+    if (eocdOffset < 0)
+        throw new Error('zip: end-of-central-directory record not found');
+    const totalEntries = buffer.readUInt16LE(eocdOffset + 10);
+    const centralDirOffset = buffer.readUInt32LE(eocdOffset + 16);
+    if (centralDirOffset === 0xffffffff) {
+        throw new Error('zip: ZIP64 archive — not supported in skein v0.4');
+    }
+    const entries = [];
+    let cursor = centralDirOffset;
+    for (let i = 0; i < totalEntries; i++) {
+        if (buffer.readUInt32LE(cursor) !== CDH_SIGNATURE) {
+            throw new Error(`zip: bad central directory entry at offset ${cursor}`);
+        }
+        const method = buffer.readUInt16LE(cursor + 10);
+        const compressedSize = buffer.readUInt32LE(cursor + 20);
+        const uncompressedSize = buffer.readUInt32LE(cursor + 24);
+        const nameLen = buffer.readUInt16LE(cursor + 28);
+        const extraLen = buffer.readUInt16LE(cursor + 30);
+        const commentLen = buffer.readUInt16LE(cursor + 32);
+        const localHeaderOffset = buffer.readUInt32LE(cursor + 42);
+        const name = buffer.toString('utf8', cursor + 46, cursor + 46 + nameLen);
+        cursor += 46 + nameLen + extraLen + commentLen;
+        if (compressedSize === 0xffffffff || uncompressedSize === 0xffffffff) {
+            throw new Error(`zip: ZIP64-sized entry "${name}" — not supported in skein v0.4`);
+        }
+        if (buffer.readUInt32LE(localHeaderOffset) !== LFH_SIGNATURE) {
+            throw new Error(`zip: bad local file header for "${name}"`);
+        }
+        const lfhNameLen = buffer.readUInt16LE(localHeaderOffset + 26);
+        const lfhExtraLen = buffer.readUInt16LE(localHeaderOffset + 28);
+        const dataStart = localHeaderOffset + 30 + lfhNameLen + lfhExtraLen;
+        const dataEnd = dataStart + compressedSize;
+        const compressed = buffer.subarray(dataStart, dataEnd);
+        const body = method === 0 ? compressed : method === 8 ? inflateRawSync(compressed) : panic(method, name);
+        entries.push({ name, method, uncompressedSize, compressedSize, body: Buffer.from(body) });
+    }
+    return entries;
+}
+function findEocd(buffer) {
+    // EOCD has a 22-byte fixed prefix + a variable-length comment up to 65,535
+    // bytes. We scan backwards from the end of the buffer to find the
+    // signature, capping the search at 65,557 bytes.
+    const maxScan = Math.min(buffer.length, 65_557);
+    for (let i = buffer.length - 22; i >= buffer.length - maxScan; i--) {
+        if (i < 0)
+            break;
+        if (buffer.readUInt32LE(i) === EOCD_SIGNATURE)
+            return i;
+    }
+    return -1;
+}
+function panic(method, name) {
+    throw new Error(`zip: unsupported compression method ${method} for entry "${name}"`);
+}
+export function findEntry(entries, name) {
+    return entries.find(e => e.name === name || e.name.endsWith(`/${name}`));
+}
+export function findEntriesByExt(entries, ext) {
+    return entries.filter(e => e.name.endsWith(ext));
+}
+//# sourceMappingURL=zip.js.map

package/dist/conv/zip.js.map

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

package/dist/hf/client.d.ts

@@ -0,0 +1,41 @@
+import { Buffer } from 'node:buffer';
+export interface HfFileOp {
+    path: string;
+    content: Buffer;
+}
+export interface CommitRequest {
+    repoId: string;
+    branch?: string;
+    summary: string;
+    description?: string;
+    files: HfFileOp[];
+}
+export interface CreateRepoRequest {
+    name: string;
+    organization?: string;
+    private?: boolean;
+    type?: 'dataset' | 'model' | 'space';
+}
+export declare class HfClient {
+    private readonly endpoint;
+    private readonly token;
+    constructor(token: string, endpoint?: string);
+    /**
+     * Create a dataset repo. Returns true if newly created, false if it already
+     * exists (HTTP 409). Re-throws other errors.
+     */
+    ensureDataset(req: CreateRepoRequest): Promise<{
+        created: boolean;
+    }>;
+    /**
+     * Commit a batch of files to a dataset via the NDJSON commit API.
+     * Files <10MB are sent inline as base64; anything larger throws and asks
+     * the caller to chunk further or use LFS (not yet implemented in Skein v0.2).
+     */
+    commitFiles(req: CommitRequest): Promise<void>;
+    whoami(): Promise<{
+        name: string;
+        type: string;
+    } | undefined>;
+    private authHeaders;
+}

package/dist/hf/client.js

@@ -0,0 +1,87 @@
+export class HfClient {
+    endpoint;
+    token;
+    constructor(token, endpoint = 'https://huggingface.co') {
+        if (!token)
+            throw new Error('HfClient: token is required');
+        this.endpoint = endpoint.replace(/\/+$/, '');
+        this.token = token;
+    }
+    /**
+     * Create a dataset repo. Returns true if newly created, false if it already
+     * exists (HTTP 409). Re-throws other errors.
+     */
+    async ensureDataset(req) {
+        const res = await fetch(`${this.endpoint}/api/repos/create`, {
+            method: 'POST',
+            headers: this.authHeaders('application/json'),
+            body: JSON.stringify({
+                name: req.name,
+                ...(req.organization ? { organization: req.organization } : {}),
+                type: req.type ?? 'dataset',
+                private: req.private ?? false,
+            }),
+        });
+        if (res.ok)
+            return { created: true };
+        if (res.status === 409)
+            return { created: false };
+        throw new Error(await formatError('create repo', res));
+    }
+    /**
+     * Commit a batch of files to a dataset via the NDJSON commit API.
+     * Files <10MB are sent inline as base64; anything larger throws and asks
+     * the caller to chunk further or use LFS (not yet implemented in Skein v0.2).
+     */
+    async commitFiles(req) {
+        const branch = req.branch ?? 'main';
+        const url = `${this.endpoint}/api/datasets/${req.repoId}/commit/${encodeURIComponent(branch)}`;
+        const lines = [];
+        lines.push(JSON.stringify({
+            key: 'header',
+            value: {
+                summary: req.summary,
+                ...(req.description ? { description: req.description } : {}),
+            },
+        }));
+        for (const file of req.files) {
+            if (file.content.byteLength > 10 * 1024 * 1024) {
+                throw new Error(`HfClient: file ${file.path} is ${file.content.byteLength} bytes — LFS upload is not yet supported in Skein v0.2 (cap is 10 MB).`);
+            }
+            lines.push(JSON.stringify({
+                key: 'file',
+                value: {
+                    path: file.path,
+                    content: file.content.toString('base64'),
+                    encoding: 'base64',
+                },
+            }));
+        }
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: this.authHeaders('application/x-ndjson'),
+            body: `${lines.join('\n')}\n`,
+        });
+        if (!res.ok)
+            throw new Error(await formatError('commit files', res));
+    }
+    async whoami() {
+        const res = await fetch(`${this.endpoint}/api/whoami-v2`, {
+            headers: { Authorization: `Bearer ${this.token}` },
+        });
+        if (!res.ok)
+            return undefined;
+        return (await res.json());
+    }
+    authHeaders(contentType) {
+        return {
+            Authorization: `Bearer ${this.token}`,
+            'Content-Type': contentType,
+        };
+    }
+}
+async function formatError(label, res) {
+    const text = await res.text().catch(() => '<no body>');
+    return `HfClient ${label}: HTTP ${res.status} ${res.statusText} — ${text.slice(0, 500)}`;
+}
+//# sourceMappingURL=client.js.map

package/dist/hf/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ir/index.js';
+export * from './adapters/base.js';
+export { ADAPTERS, getAdapter, getAdapterOrThrow } from './adapters/registry.js';
+export { redactText, hasSecret } from './redactor/index.js';
+export { VERSION } from './version.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './ir/index.js';
+export * from './adapters/base.js';
+export { ADAPTERS, getAdapter, getAdapterOrThrow } from './adapters/registry.js';
+export { redactText, hasSecret } from './redactor/index.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}