skein-cli 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 François Chastel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+<div align="center">
+
+# `skein`
+
+### Move your AI coding harness between tools — and capture, search, and protect every conversation along the way.
+
+<br />
+
+[![Tests](https://img.shields.io/badge/tests-135%20passing-brightgreen?style=flat-square)](https://github.com/FrancoisChastel/skein/actions)
+[![Node](https://img.shields.io/badge/node-%E2%89%A522-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](CONTRIBUTING.md)
+
+[**Quickstart**](#-quickstart) · [**Docs**](#-documentation) · [**Contributing**](CONTRIBUTING.md)
+
+<br />
+
+<a href="docs/media/skein-showcase.gif">
+  <img src="docs/media/skein-showcase.gif" alt="skein feature showcase: migrate harnesses, capture every conversation, search, redact secrets and PII, contribute redacted traces with real per-turn metrics, and unify memory" width="820" />
+</a>
+
+<sub>Every pillar, one take: migrate harnesses · capture every turn · search · redact · contribute <strong>redacted traces with real per-turn metrics</strong> · unify memory.</sub>
+
+</div>
+
+---
+
+## What is skein?
+
+You've spent months tuning your AI coding setup — subagents, slash commands, hooks, MCP servers, rules, memory. Switching harnesses or sharing that setup means copying files and losing nuance, while your conversations stay locked inside whichever tool created them.
+
+**Skein treats your harness as a portable artifact.** One canonical Intermediate Representation, adapters that speak every major coding tool, a universal proxy that captures every LLM turn, a unified memory store, and a four-tier redactor that strips secrets and PII before anything leaves your machine.
+
+```bash
+npx skein-cli migrate --from claude-code --to codex --dry-run
+```
+
+That one command rewrites your entire Claude Code setup into Codex-native format — subagents become skills, `.mcp.json` becomes TOML, hooks travel intact, `CLAUDE.md` becomes `AGENTS.md` — and your past conversations stream into a searchable, replayable archive.
+
+---
+
+## ✨ What skein does
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🔁 Migrate your harness
+One command moves skills, agents, commands, rules, MCP servers, hooks, permissions, and model config between **Claude Code · Codex CLI · OpenCode · Cursor · Aider · Claude Desktop**. Lossless where possible, honestly lossy where it isn't.
+
+</td>
+<td width="50%" valign="top">
+
+### 🎙 Capture any tool's conversations
+`skein wrap <tool>` puts an HTTP proxy in front of any harness that talks to an LLM API — Anthropic, OpenAI Chat, OpenAI Responses, streaming SSE included. Works for tools we've never tested too.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+### 🔎 Search across every session
+SQLite FTS5 over every captured conversation — title, content, full-text, incremental indexing, tool/model/cost breakdowns. The first cross-tool transcript archive.
+
+</td>
+<td width="50%" valign="top">
+
+### 🛡️ Defend privacy by default
+Four-tier redactor: 47 secret patterns + Shannon entropy + Luhn-validated PII regex + optional ML NER. Runs on every share. Never on by accident.
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+### 🤗 Share redacted traces
+Contribute per-turn traces — provider, model, effort, **real metrics (tokens, latency, cost)**, tool-call structure, **and redacted prompt / output / tool-I/O** — to one community dataset. Opt-in, scrubbed before it leaves your machine, export to jsonl / json / csv.
+
+</td>
+<td width="50%" valign="top">
+
+### 🧠 Unify your memory store
+Pull cross-session observations and saved facts from **claude-mem · Codex · ChatGPT exports** into one log, then migrate them into any other memory system. Native writers for claude-mem + Codex; cloud-only targets get a paste-ready brief.
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🚀 Quickstart
+
+```bash
+npm install -g skein-cli   # installs the `skein` command  (Node ≥ 22, no native build step)
+npx skein-cli doctor       # or run without installing
+```
+
+```bash
+skein doctor                                  # what's installed + what can move where
+skein migrate --from claude-code --to codex   # move your whole harness (add --dry-run to preview)
+skein wrap claude                             # capture every LLM turn behind a local proxy
+skein conv search "auth middleware"           # full-text search across every session
+skein redact ./session.jsonl --ml            # scrub secrets + PII from anything
+skein memory capture --tool claude-mem        # unify cross-tool memory, then import --to <tool>
+skein trace export --format csv --out t.csv   # export redacted traces (jsonl | json | csv)
+```
+
+### A concrete example, end-to-end
+
+<div align="center">
+
+<a href="docs/media/skein-live-migration.gif">
+  <img src="docs/media/skein-live-migration.gif" alt="skein migrating a Claude Code setup into Codex CLI, then unifying memory across both tools" width="760" />
+</a>
+
+<sub>On a real machine: profile snapshot → migrate into Codex → capture 4,737 claude-mem observations → replay into <code>~/.codex/memories_1.sqlite</code> → verify.</sub>
+
+</div>
+
+---
+
+## 🔌 Supported tools
+
+| | Migrate config | Capture conversations | Memory |
+|---|:---:|:---:|:---:|
+| **Claude Code** | ✅ | ✅ | ✅ |
+| **Codex CLI** | ✅ | ✅ | ✅ |
+| **OpenCode** | ✅ | ✅ | — |
+| **Cursor** | ✅ | ✅ (via proxy) | — |
+| **Aider** | ✅ | ✅ | — |
+| **Claude Desktop** | ✅ (MCP) | — | — |
+| **ChatGPT** | — | ✅ (export) | ✅ (export) |
+
+Adding a tool is **one adapter file** — see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## 📖 Documentation
+
+| Guide | What's inside |
+|---|---|
+| [**Command reference**](docs/COMMANDS.md) | Every command and flag, plus the Conversations & Memory deep-dives |
+| [**Architecture**](docs/ARCHITECTURE.md) | The hub-and-spoke IR, capture modes, conversation format |
+| [**Community traces dataset**](docs/traces-dataset/PLAN.md) | What's published, redaction, consent, and the privacy posture |
+| [**Cookbook**](docs/COOKBOOK.md) | Task-oriented recipes |
+| [**FAQ**](docs/FAQ.md) | Common questions, the IR shape, why hub-and-spoke |
+| [**Roadmap**](docs/ROADMAP.md) | Where skein is headed |
+
+---
+
+## 🛡️ Security & privacy
+
+Skein is **local-first** — nothing leaves your machine without an explicit, consented action. The four-tier redactor (secrets regex → entropy → PII regex → optional ML NER) runs before any share, and is also a standalone command:
+
+```bash
+echo 'sk-ant-… alice@example.com 4242 4242 4242 4242' | skein redact
+```
+
+Found a vulnerability? Please report it privately — see [SECURITY.md](SECURITY.md).
+
+---
+
+## 🤝 Contributing
+
+Issues and PRs welcome — adding a new tool is usually **one adapter file**. Start with [CONTRIBUTING.md](CONTRIBUTING.md), and be excellent to each other ([Code of Conduct](CODE_OF_CONDUCT.md)).
+
+## 📄 License
+
+[MIT](LICENSE) — © 2026 François Chastel and contributors.
+
+---
+
+<div align="center">
+
+**[Quickstart](#-quickstart)** · **[Docs](#-documentation)** · **[Contributing](CONTRIBUTING.md)**
+
+<sub>Made at the intersection of harness migration and conversation portability.</sub>
+
+</div>

package/bin/skein.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import('../dist/cli.js')
+  .then(m => m.run())
+  .catch(err => {
+    console.error(err)
+    process.exit(1)
+  })

package/dist/adapters/aider/conv-reader.d.ts

@@ -0,0 +1,7 @@
+import type { ConvReader, ReadContext } from '../base.js';
+export interface AiderReaderContext extends ReadContext {
+    /** When set, restrict the scan to this project root (default: ctx.projectPath ?? ctx.homeDir). */
+    projectPath?: string;
+}
+export declare const aiderConvReader: ConvReader;
+export declare function aiderHistoryPath(ctx: ReadContext): string | undefined;

package/dist/adapters/aider/conv-reader.js

@@ -0,0 +1,203 @@
+import { createReadStream, promises as fs } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { basename, join } from 'node:path';
+import { CONV_SCHEMA } from '../../version.js';
+/**
+ * Aider conv reader.
+ *
+ * Aider writes one markdown transcript per project at the repo root:
+ * `.aider.chat.history.md`. The file uses two reserved separators:
+ *
+ *   - `# aider chat started at <ts>` — opens a new chat session
+ *   - `####` heading — splits user prompts from assistant responses
+ *   - `> ` — quoted user prompt within an interleaved turn
+ *
+ * One markdown file = one or more Skein sessions (split on the
+ * `# aider chat started` headers). Each session id is derived from the
+ * project basename + the chat-start timestamp so it is stable across
+ * re-reads.
+ */
+const CHAT_START = /^#\s+aider chat started at (.+?)\s*$/i;
+const HEADING_4 = /^####\s+(.+?)\s*$/;
+const USER_LINE = /^>\s?(.*)$/;
+export const aiderConvReader = {
+    async *listSessions(ctx) {
+        const path = aiderHistoryPath(ctx);
+        if (!path)
+            return;
+        for await (const session of readSessions(path)) {
+            yield aiderSessionToSummary(path, session);
+        }
+    },
+    async *readSession(id, ctx) {
+        const path = aiderHistoryPath(ctx);
+        if (!path)
+            return;
+        for await (const session of readSessions(path)) {
+            if (session.id !== id)
+                continue;
+            yield {
+                type: 'session.start',
+                id: session.id,
+                tool: 'aider',
+                project: parentOf(path),
+                title: session.title,
+                schema: CONV_SCHEMA,
+                ts: session.startedAt,
+            };
+            let seq = 0;
+            for (const turn of session.turns) {
+                seq += 1;
+                const content = [{ type: 'text', text: turn.text }];
+                yield {
+                    type: 'message',
+                    session: session.id,
+                    seq,
+                    role: turn.role,
+                    content,
+                    ts: session.startedAt,
+                };
+            }
+            yield { type: 'session.end', session: session.id, ts: session.startedAt };
+            return;
+        }
+    },
+};
+export function aiderHistoryPath(ctx) {
+    const projectPath = ctx.projectPath ?? process.cwd();
+    if (!projectPath)
+        return undefined;
+    return join(projectPath, '.aider.chat.history.md');
+}
+async function* readSessions(path) {
+    if (!(await pathExists(path)))
+        return;
+    let current;
+    let buffer = [];
+    let pendingRole = 'user';
+    // Tracks whether the previous non-blank line was a `> …` quoted user prompt.
+    // When the user block ends (next non-blank line is unquoted), we flush the
+    // user turn and start collecting an assistant turn.
+    let lastNonBlankWasUserQuote = false;
+    const flushTurn = () => {
+        if (!current)
+            return;
+        const text = buffer.join('\n').trim();
+        if (text.length === 0) {
+            buffer = [];
+            return;
+        }
+        current.turns.push({ role: pendingRole, text });
+        buffer = [];
+    };
+    for await (const line of readLines(path)) {
+        const startMatch = CHAT_START.exec(line);
+        if (startMatch) {
+            flushTurn();
+            if (current)
+                yield current;
+            const startedAt = parseChatTimestamp(startMatch[1] ?? '');
+            const title = `Aider chat ${startMatch[1] ?? ''}`.trim();
+            current = {
+                id: makeSessionId(path, startedAt),
+                startedAt,
+                title,
+                turns: [],
+            };
+            pendingRole = 'user';
+            lastNonBlankWasUserQuote = false;
+            continue;
+        }
+        if (!current) {
+            current = {
+                id: makeSessionId(path, new Date(0).toISOString()),
+                startedAt: new Date(0).toISOString(),
+                title: 'Aider chat (no start header)',
+                turns: [],
+            };
+            pendingRole = 'user';
+            lastNonBlankWasUserQuote = false;
+        }
+        const headingMatch = HEADING_4.exec(line);
+        if (headingMatch) {
+            flushTurn();
+            const heading = (headingMatch[1] ?? '').toLowerCase();
+            pendingRole = heading.startsWith('>') ? 'user' : 'assistant';
+            const stripped = (headingMatch[1] ?? '').replace(/^>\s?/, '').trim();
+            if (stripped.length > 0)
+                buffer.push(stripped);
+            lastNonBlankWasUserQuote = pendingRole === 'user';
+            continue;
+        }
+        const userMatch = USER_LINE.exec(line);
+        if (userMatch) {
+            if (pendingRole !== 'user' && buffer.length > 0)
+                flushTurn();
+            pendingRole = 'user';
+            buffer.push(userMatch[1] ?? '');
+            lastNonBlankWasUserQuote = true;
+            continue;
+        }
+        if (line.trim().length === 0) {
+            // Blank line — preserve role state but emit a paragraph break in the
+            // accumulating buffer so multi-paragraph turns stay readable.
+            if (buffer.length > 0)
+                buffer.push('');
+            continue;
+        }
+        if (lastNonBlankWasUserQuote && pendingRole === 'user') {
+            // Transition from quoted user prompt to assistant prose.
+            flushTurn();
+            pendingRole = 'assistant';
+        }
+        buffer.push(line);
+        lastNonBlankWasUserQuote = false;
+    }
+    flushTurn();
+    if (current)
+        yield current;
+}
+function aiderSessionToSummary(path, session) {
+    return {
+        id: session.id,
+        tool: 'aider',
+        project: parentOf(path),
+        title: session.title,
+        startedAt: session.startedAt,
+        messageCount: session.turns.length,
+        path,
+    };
+}
+function makeSessionId(path, startedAt) {
+    const project = basename(parentOf(path));
+    return `aider-${project}-${startedAt.replace(/[^0-9]/g, '').slice(0, 14) || 'unknown'}`;
+}
+function parentOf(path) {
+    const idx = path.lastIndexOf('/');
+    return idx > 0 ? path.slice(0, idx) : path;
+}
+function parseChatTimestamp(raw) {
+    // Aider writes "2026-06-14 10:00:00"; normalize to ISO 8601.
+    const trimmed = raw.trim();
+    const iso = trimmed.replace(' ', 'T');
+    const parsed = new Date(iso);
+    if (Number.isNaN(parsed.getTime()))
+        return new Date().toISOString();
+    return parsed.toISOString();
+}
+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)
+        yield line;
+}
+async function pathExists(path) {
+    try {
+        await fs.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=conv-reader.js.map

package/dist/adapters/aider/conv-reader.js.map

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

package/dist/adapters/aider/index.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from '../base.js';
+export declare const aiderAdapter: Adapter;

package/dist/adapters/aider/index.js

@@ -0,0 +1,123 @@
+import { join } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { emptyReport } from '../base.js';
+import { exists, readTextOrUndefined, writeFileAtomic } from '../../util/fs.js';
+const CAPS = {
+    identity: 'unsupported',
+    rules: 'translatable',
+    agents: 'unsupported',
+    commands: 'unsupported',
+    skills: 'unsupported',
+    mcp: 'unsupported',
+    hooks: 'unsupported',
+    permissions: 'translatable',
+    models: 'native',
+    conversations: 'translatable',
+};
+const reader = {
+    async readRules(ctx) {
+        const conf = await readConf(ctx);
+        const rules = [];
+        for (const path of conf?.read ?? []) {
+            const body = await readTextOrUndefined(ctx.projectPath ? join(ctx.projectPath, path) : join(ctx.homeDir, path));
+            if (body) {
+                rules.push({
+                    id: `aider-read-${path}`,
+                    scope: ctx.projectPath ? 'project' : 'global',
+                    activation: 'always',
+                    body: body.trim(),
+                });
+            }
+        }
+        return rules;
+    },
+    async readModels(ctx) {
+        const conf = await readConf(ctx);
+        if (!conf)
+            return undefined;
+        return {
+            ...(conf.model ? { defaultModel: conf.model } : {}),
+            ...(conf['weak-model'] ? { smallModel: conf['weak-model'] } : {}),
+        };
+    },
+};
+async function readConf(ctx) {
+    for (const candidate of [
+        ctx.projectPath ? join(ctx.projectPath, '.aider.conf.yml') : undefined,
+        join(ctx.homeDir, '.aider.conf.yml'),
+    ]) {
+        if (!candidate)
+            continue;
+        const raw = await readTextOrUndefined(candidate);
+        if (raw) {
+            try {
+                return parseYaml(raw);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return undefined;
+}
+const writer = {
+    async writeRules(rules, ctx) {
+        const report = emptyReport();
+        if (rules.length === 0)
+            return report;
+        const path = ctx.projectPath
+            ? join(ctx.projectPath, 'CONVENTIONS.md')
+            : join(ctx.homeDir, 'CONVENTIONS.md');
+        const body = rules.map(r => r.body.trim()).join('\n\n---\n\n');
+        if (!ctx.dryRun)
+            await writeFileAtomic(path, body + '\n');
+        report.written.push(ctx.dryRun ? `(dry) ${path}` : path);
+        const confPath = ctx.projectPath
+            ? join(ctx.projectPath, '.aider.conf.yml')
+            : join(ctx.homeDir, '.aider.conf.yml');
+        const existing = await readTextOrUndefined(confPath);
+        const conf = (existing ? parseYamlOrUndefined(existing) : undefined) ?? {};
+        conf.read = [...new Set([...(conf.read ?? []), 'CONVENTIONS.md'])];
+        if (!ctx.dryRun)
+            await writeFileAtomic(confPath, stringifyYaml(conf));
+        report.written.push(ctx.dryRun ? `(dry) ${confPath}` : confPath);
+        return report;
+    },
+    async writeModels(models, ctx) {
+        const report = emptyReport();
+        const confPath = ctx.projectPath
+            ? join(ctx.projectPath, '.aider.conf.yml')
+            : join(ctx.homeDir, '.aider.conf.yml');
+        const existing = await readTextOrUndefined(confPath);
+        const conf = (existing ? parseYamlOrUndefined(existing) : undefined) ?? {};
+        if (models.defaultModel)
+            conf.model = models.defaultModel;
+        if (models.smallModel)
+            conf['weak-model'] = models.smallModel;
+        if (!ctx.dryRun)
+            await writeFileAtomic(confPath, stringifyYaml(conf));
+        report.written.push(ctx.dryRun ? `(dry) ${confPath}` : confPath);
+        return report;
+    },
+};
+function parseYamlOrUndefined(raw) {
+    try {
+        return parseYaml(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export const aiderAdapter = {
+    id: 'aider',
+    name: 'Aider',
+    homepage: 'https://aider.chat',
+    capabilities: CAPS,
+    async detect(ctx) {
+        return ((await exists(join(ctx.homeDir, '.aider.conf.yml'))) ||
+            (ctx.projectPath ? exists(join(ctx.projectPath, '.aider.conf.yml')) : Promise.resolve(false)));
+    },
+    reader,
+    writer,
+};
+//# sourceMappingURL=index.js.map

package/dist/adapters/aider/index.js.map

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

package/dist/adapters/base.d.ts

@@ -0,0 +1,71 @@
+import type { Agent, Command, Hook, Identity, McpServer, ModelConfig, Permission, ProfileManifest, Rule, Skill } from '../schema/manifest.js';
+import type { ConvEvent, ConvSessionSummary } from '../schema/conv.js';
+export type CapabilityLevel = 'native' | 'translatable' | 'lossy' | 'unsupported';
+export interface AdapterCapabilities {
+    identity: CapabilityLevel;
+    rules: CapabilityLevel;
+    agents: CapabilityLevel;
+    commands: CapabilityLevel;
+    skills: CapabilityLevel;
+    mcp: CapabilityLevel;
+    hooks: CapabilityLevel;
+    permissions: CapabilityLevel;
+    models: CapabilityLevel;
+    conversations: CapabilityLevel;
+}
+export interface ReadContext {
+    projectPath?: string;
+    homeDir: string;
+}
+export interface WriteContext {
+    projectPath?: string;
+    homeDir: string;
+    dryRun?: boolean;
+}
+export interface WriteReport {
+    written: string[];
+    skipped: {
+        item: string;
+        reason: string;
+    }[];
+    warnings: string[];
+}
+export declare function emptyReport(): WriteReport;
+export declare function mergeReports(a: WriteReport, b: WriteReport): WriteReport;
+export interface ProfileReader {
+    readIdentity?(ctx: ReadContext): Promise<Identity | undefined>;
+    readRules?(ctx: ReadContext): Promise<Rule[]>;
+    readAgents?(ctx: ReadContext): Promise<Agent[]>;
+    readCommands?(ctx: ReadContext): Promise<Command[]>;
+    readSkills?(ctx: ReadContext): Promise<Skill[]>;
+    readMcpServers?(ctx: ReadContext): Promise<McpServer[]>;
+    readHooks?(ctx: ReadContext): Promise<Hook[]>;
+    readPermissions?(ctx: ReadContext): Promise<Permission | undefined>;
+    readModels?(ctx: ReadContext): Promise<ModelConfig | undefined>;
+}
+export interface ProfileWriter {
+    writeIdentity?(identity: Identity, ctx: WriteContext): Promise<WriteReport>;
+    writeRules?(rules: Rule[], ctx: WriteContext): Promise<WriteReport>;
+    writeAgents?(agents: Agent[], ctx: WriteContext): Promise<WriteReport>;
+    writeCommands?(commands: Command[], ctx: WriteContext): Promise<WriteReport>;
+    writeSkills?(skills: Skill[], ctx: WriteContext): Promise<WriteReport>;
+    writeMcpServers?(servers: McpServer[], ctx: WriteContext): Promise<WriteReport>;
+    writeHooks?(hooks: Hook[], ctx: WriteContext): Promise<WriteReport>;
+    writePermissions?(perm: Permission, ctx: WriteContext): Promise<WriteReport>;
+    writeModels?(models: ModelConfig, ctx: WriteContext): Promise<WriteReport>;
+}
+export interface ConvReader {
+    listSessions(ctx: ReadContext): AsyncIterable<ConvSessionSummary>;
+    readSession(id: string, ctx: ReadContext): AsyncIterable<ConvEvent>;
+}
+export interface Adapter {
+    id: string;
+    name: string;
+    homepage?: string;
+    capabilities: AdapterCapabilities;
+    detect(ctx: ReadContext): Promise<boolean>;
+    reader?: ProfileReader;
+    writer?: ProfileWriter;
+    convReader?: ConvReader;
+}
+export declare function profileFromReader(reader: ProfileReader, sourceTool: string, ctx: ReadContext): Promise<ProfileManifest>;