aweshare 0.2.0

package/apps/agent/dist/config.js

@@ -0,0 +1,150 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { isValidAlias, PROTOCOLS } from 'aweshare-protocol';
+import { parse as parseToml } from 'smol-toml';
+export function agentDir(env = process.env) {
+    return env.AWESHARE_AGENT_DIR ?? join(homedir(), '.aweshare');
+}
+export class ConfigError extends Error {
+    problems;
+    constructor(message, problems) {
+        super(message);
+        this.problems = problems;
+    }
+}
+export function loadAgentConfig(dir) {
+    const configPath = join(dir, 'config.toml');
+    const secretsPath = join(dir, 'secrets.json');
+    if (!existsSync(configPath)) {
+        throw new ConfigError(`no config at ${configPath} — run 'aweshare agent init' first`, []);
+    }
+    let raw;
+    try {
+        raw = parseToml(readFileSync(configPath, 'utf8'));
+    }
+    catch (err) {
+        throw new ConfigError(`config.toml is not valid TOML: ${err instanceof Error ? err.message : err}`, []);
+    }
+    const secrets = existsSync(secretsPath)
+        ? JSON.parse(readFileSync(secretsPath, 'utf8'))
+        : {};
+    const problems = [];
+    const hubUrl = typeof raw.hubUrl === 'string' ? raw.hubUrl : '';
+    if (!/^https?:\/\//.test(hubUrl))
+        problems.push('hubUrl must be an http(s) URL');
+    const token = typeof raw.token === 'string' ? raw.token : '';
+    if (!token.startsWith('asp_'))
+        problems.push('token must be a producer token (asp_...)');
+    const backends = [];
+    const seenBackendIds = new Set();
+    if (raw.backends !== undefined && !Array.isArray(raw.backends)) {
+        problems.push('backends must be a [[backends]] list');
+    }
+    for (const b of Array.isArray(raw.backends) ? raw.backends : []) {
+        const id = typeof b.id === 'string' ? b.id : '';
+        const protocol = b.protocol;
+        const baseUrl = typeof b.baseUrl === 'string' ? b.baseUrl : '';
+        const keyRef = typeof b.keyRef === 'string' ? b.keyRef : undefined;
+        if (!id)
+            problems.push('backend: id is required');
+        else if (seenBackendIds.has(id))
+            problems.push(`backend: duplicate id '${id}'`);
+        else
+            seenBackendIds.add(id);
+        if (!PROTOCOLS.includes(protocol)) {
+            problems.push(`backend '${id || '?'}': protocol must be openai or anthropic`);
+            continue;
+        }
+        if (!/^https?:\/\//.test(baseUrl)) {
+            problems.push(`backend '${id}': baseUrl must be an http(s) URL`);
+            continue;
+        }
+        if (keyRef && !(keyRef in secrets)) {
+            problems.push(`backend '${id}': keyRef '${keyRef}' not found in secrets.json`);
+        }
+        backends.push({ id, protocol: protocol, baseUrl, keyRef });
+    }
+    const backendIds = new Set(backends.map((b) => b.id));
+    const offerings = [];
+    if (raw.offerings !== undefined && !Array.isArray(raw.offerings)) {
+        problems.push('offerings must be an [[offerings]] list');
+    }
+    for (const o of Array.isArray(raw.offerings)
+        ? raw.offerings
+        : []) {
+        const alias = typeof o.alias === 'string' ? o.alias : '';
+        const backend = typeof o.backend === 'string' ? o.backend : '';
+        const upstreamModel = typeof o.upstreamModel === 'string' ? o.upstreamModel : '';
+        const maxConcurrency = o.maxConcurrency === undefined ? 1 : Number(o.maxConcurrency);
+        if (!isValidAlias(alias)) {
+            problems.push(`offering: invalid alias '${alias}' (namespace/name, lowercase)`);
+            continue;
+        }
+        if (!backendIds.has(backend)) {
+            problems.push(`offering '${alias}': unknown backend '${backend}'`);
+            continue;
+        }
+        if (!upstreamModel) {
+            problems.push(`offering '${alias}': upstreamModel is required (the real backend model id)`);
+            continue;
+        }
+        if (!Number.isInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 64) {
+            problems.push(`offering '${alias}': maxConcurrency must be an integer 1..64`);
+            continue;
+        }
+        offerings.push({ alias, backend, upstreamModel, maxConcurrency });
+    }
+    if (problems.length > 0) {
+        throw new ConfigError(`config.toml has problems:\n  - ${problems.join('\n  - ')}`, problems);
+    }
+    return { config: { hubUrl: hubUrl.replace(/\/+$/, ''), token, backends, offerings }, secrets };
+}
+/** tmp+rename atomic write with owner-only permissions. */
+export function writeFileAtomic(path, content, mode = 0o600) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp-${process.pid}`;
+    writeFileSync(tmp, content, { mode });
+    renameSync(tmp, path);
+}
+export const CONFIG_TEMPLATE = `# aweshare agent configuration (~/.aweshare/config.toml)
+# Secrets live in ~/.aweshare/secrets.json and never leave this machine.
+
+hubUrl = "http://127.0.0.1:8787"
+token = "asp_PASTE_PRODUCER_TOKEN"
+
+# Backends hold the upstream API. baseUrl follows the SDK convention:
+#   openai-style (OpenAI/Ollama/vLLM/LM Studio) includes /v1, e.g. http://127.0.0.1:11434/v1
+#   anthropic-style excludes /v1, e.g. https://api.anthropic.com
+#   responses-style includes the version path, e.g. https://open.bigmodel.cn/api/v1
+[[backends]]
+id = "ollama"
+protocol = "openai"
+baseUrl = "http://127.0.0.1:11434/v1"
+# keyRef = "ollama-key"     # optional; keys live in secrets.json
+
+[[backends]]
+id = "openai"
+protocol = "openai"
+baseUrl = "https://api.openai.com/v1"
+keyRef = "openai-key"
+
+# Offerings map a public alias (namespace/name) to a backend model.
+# The namespace must match your producer name on the hub.
+[[offerings]]
+alias = "YOUR_NAME/qwen2.5.7b"
+backend = "ollama"
+upstreamModel = "qwen2.5:7b"   # must match 'ollama list' exactly, including the tag
+maxConcurrency = 1             # start at 1 for local models
+
+[[offerings]]
+alias = "YOUR_NAME/gpt-4o"
+backend = "openai"
+upstreamModel = "gpt-4o-2024-11-20"
+maxConcurrency = 4
+`;
+export const SECRETS_TEMPLATE = `{
+  "openai-key": "sk-PASTE_YOUR_KEY"
+}
+`;
+//# sourceMappingURL=config.js.map

package/apps/agent/dist/config.js.map

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

package/apps/agent/dist/connection.d.ts

@@ -0,0 +1,40 @@
+import { type RegisteredMessage } from 'aweshare-protocol';
+import { type Logger } from 'pino';
+import { type ResolvedBackend } from './adapters.js';
+import type { AgentConfig } from './config.js';
+export interface AgentConnectionOptions {
+    config: AgentConfig;
+    secrets: Record<string, string>;
+    log?: Logger;
+}
+/** Outbound-only tunnel client with reconnect, heartbeat and health reporting. */
+export declare class AgentConnection {
+    private readonly opts;
+    private ws;
+    private stopped;
+    private backoffMs;
+    private jobs;
+    private health;
+    private heartbeatTimer;
+    private probeTimer;
+    private backends;
+    private registeredWaiters;
+    private readonly log;
+    constructor(opts: AgentConnectionOptions);
+    /** In-flight jobs; completed or canceled jobs are removed. Exposed for tests. */
+    get activeJobCount(): number;
+    /** Resolves after the next successful register (used by tests and doctor). */
+    whenRegistered(): Promise<RegisteredMessage>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private runConnection;
+    private register;
+    private sendHeartbeat;
+    /** Minimal live probe for degraded backends; success clears the degraded state. */
+    private probeDegraded;
+}
+export declare function probeTarget(backend: ResolvedBackend): {
+    url: string;
+    headers: Record<string, string>;
+};
+export declare function probeBody(model: string, protocol?: 'openai' | 'anthropic' | 'responses'): Record<string, unknown>;

package/apps/agent/dist/connection.js

@@ -0,0 +1,359 @@
+import { BACKPRESSURE_LIMIT_BYTES, chunkBody, decodeChunkFrame, parseControlMessage, WIRE_VERSION, } from 'aweshare-protocol';
+import pino, {} from 'pino';
+import { WebSocket } from 'ws';
+import { buildUpstreamRequest } from './adapters.js';
+import { classifyStatus, HealthGate } from './health.js';
+const RECONNECT_BASE_MS = 1500;
+const RECONNECT_MAX_MS = 15_000;
+const HEARTBEAT_INTERVAL_MS = 15_000;
+const DEGRADED_PROBE_INTERVAL_MS = 30_000;
+const CONNECT_TIMEOUT_MS = 30_000;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** One tunneled request: collect body chunks, call upstream, stream back. */
+class Job {
+    ws;
+    backend;
+    health;
+    msg;
+    log;
+    onDone;
+    chunks = [];
+    controller = new AbortController();
+    aborted = false;
+    executed = false;
+    constructor(ws, backend, health, msg, log, 
+    /** Called exactly once when the job settles; the connection drops it from its map. */
+    onDone = () => { }) {
+        this.ws = ws;
+        this.backend = backend;
+        this.health = health;
+        this.msg = msg;
+        this.log = log;
+        this.onDone = onDone;
+    }
+    onChunk(payload) {
+        this.chunks.push(Buffer.from(payload));
+    }
+    abort() {
+        this.aborted = true;
+        this.controller.abort();
+    }
+    onEnd() {
+        if (this.executed)
+            return;
+        this.executed = true;
+        void this.execute().finally(() => this.onDone(this.msg.requestId));
+    }
+    async execute() {
+        const { requestId } = this.msg;
+        this.log.debug(`request ${requestId} executing against ${this.backend.baseUrl}`);
+        if (this.aborted || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        const { url, headers } = buildUpstreamRequest(this.backend, this.msg);
+        // head/connect phase timeout; streaming itself has no deadline (consumer cancel rules)
+        const connectTimer = setTimeout(() => this.controller.abort(new Error('upstream connect timeout')), CONNECT_TIMEOUT_MS);
+        try {
+            const resp = await fetch(url, {
+                method: this.msg.method,
+                headers,
+                // GET/HEAD must carry no body, even an empty one
+                body: this.chunks.length > 0 ? Buffer.concat(this.chunks) : undefined,
+                signal: this.controller.signal,
+                redirect: 'manual',
+            });
+            clearTimeout(connectTimer);
+            this.log.debug(`request ${requestId} upstream ${this.backend.id} -> ${resp.status}`);
+            const reason = classifyStatus(resp.status);
+            this.health.record(this.backend.id, reason === null, reason ?? undefined);
+            if (this.aborted || this.ws.readyState !== WebSocket.OPEN)
+                return;
+            this.send({
+                type: 'response.head',
+                requestId,
+                status: resp.status,
+                headers: pickHeaders(resp),
+            });
+            // upstream HTTP errors pass through transparently: status + body relayed as-is
+            if (resp.body) {
+                for await (const chunk of resp.body) {
+                    if (this.aborted || this.ws.readyState !== WebSocket.OPEN)
+                        return;
+                    for (const frame of chunkBody(requestId, chunk)) {
+                        await this.waitForDrain();
+                        if (this.aborted)
+                            return;
+                        this.ws.send(frame);
+                    }
+                }
+            }
+            this.send({ type: 'response.end', requestId });
+        }
+        catch (err) {
+            clearTimeout(connectTimer);
+            if (this.aborted)
+                return;
+            this.log.warn(`request ${requestId} upstream ${this.backend.id} failed: ${err instanceof Error ? err.message : err}`);
+            this.health.record(this.backend.id, false, 'NETWORK');
+            this.send({
+                type: 'response.error',
+                requestId,
+                code: 'BACKEND_UNREACHABLE',
+                message: `upstream ${this.backend.id} failed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    send(msg) {
+        if (this.ws.readyState === WebSocket.OPEN)
+            this.ws.send(JSON.stringify(msg));
+    }
+    async waitForDrain() {
+        while (this.ws.bufferedAmount > BACKPRESSURE_LIMIT_BYTES) {
+            await sleep(20);
+        }
+    }
+}
+/** undici decompresses gzip/br; relayed bytes are identity, so drop encoding markers. */
+function pickHeaders(resp) {
+    const out = {};
+    const skip = new Set([
+        'transfer-encoding',
+        'content-length',
+        'content-encoding',
+        'connection',
+        'keep-alive',
+        'set-cookie',
+    ]);
+    for (const [key, value] of resp.headers) {
+        const lower = key.toLowerCase();
+        if (skip.has(lower) || lower.startsWith('proxy-'))
+            continue;
+        out[lower] = value;
+    }
+    return out;
+}
+/** Outbound-only tunnel client with reconnect, heartbeat and health reporting. */
+export class AgentConnection {
+    opts;
+    ws = null;
+    stopped = true;
+    backoffMs = RECONNECT_BASE_MS;
+    jobs = new Map();
+    health = new HealthGate();
+    heartbeatTimer = null;
+    probeTimer = null;
+    backends;
+    registeredWaiters = [];
+    log;
+    constructor(opts) {
+        this.opts = opts;
+        this.log = opts.log ?? pino({ level: process.env.AWESHARE_LOG ?? 'info' });
+        this.backends = new Map(opts.config.backends.map((b) => [
+            b.id,
+            { ...b, apiKey: b.keyRef ? opts.secrets[b.keyRef] : undefined },
+        ]));
+    }
+    /** In-flight jobs; completed or canceled jobs are removed. Exposed for tests. */
+    get activeJobCount() {
+        return this.jobs.size;
+    }
+    /** Resolves after the next successful register (used by tests and doctor). */
+    whenRegistered() {
+        return new Promise((resolve) => this.registeredWaiters.push(resolve));
+    }
+    async start() {
+        this.stopped = false;
+        this.heartbeatTimer = setInterval(() => this.sendHeartbeat(), HEARTBEAT_INTERVAL_MS);
+        this.probeTimer = setInterval(() => void this.probeDegraded(), DEGRADED_PROBE_INTERVAL_MS);
+        while (!this.stopped) {
+            try {
+                await this.runConnection();
+            }
+            catch (err) {
+                this.log.debug(`connect failed: ${err instanceof Error ? err.message : err}`);
+            }
+            if (this.stopped)
+                break;
+            await sleep(this.backoffMs);
+            this.backoffMs = Math.min(this.backoffMs * 2, RECONNECT_MAX_MS);
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        if (this.probeTimer)
+            clearInterval(this.probeTimer);
+        for (const job of this.jobs.values())
+            job.abort();
+        this.jobs.clear();
+        await new Promise((resolve) => {
+            if (!this.ws || this.ws.readyState === WebSocket.CLOSED) {
+                resolve(undefined);
+                return;
+            }
+            this.ws.once('close', () => resolve(undefined));
+            this.ws.close();
+        });
+    }
+    runConnection() {
+        const { config } = this.opts;
+        const wsUrl = `${config.hubUrl.replace(/^http/, 'ws')}/ws/v1/producer`;
+        return new Promise((resolve) => {
+            const ws = new WebSocket(wsUrl, {
+                headers: { authorization: `Bearer ${config.token}` },
+                maxPayload: 256 * 1024,
+            });
+            this.ws = ws;
+            let wireOk = false;
+            ws.on('message', (data, isBinary) => {
+                try {
+                    if (isBinary) {
+                        const frame = decodeChunkFrame(data);
+                        this.jobs.get(frame.requestId)?.onChunk(frame.payload);
+                        return;
+                    }
+                    const msg = parseControlMessage(data.toString('utf8'));
+                    if (msg.type === 'hello') {
+                        if (msg.wireVersion !== WIRE_VERSION) {
+                            this.log.error(`wire version mismatch: hub=${msg.wireVersion} agent=${WIRE_VERSION}`);
+                            ws.close();
+                            return;
+                        }
+                        wireOk = true;
+                        this.register();
+                        return;
+                    }
+                    if (!wireOk)
+                        return;
+                    if (msg.type === 'registered') {
+                        this.backoffMs = RECONNECT_BASE_MS;
+                        for (const reject of msg.rejected) {
+                            this.log.warn(`offering rejected: ${reject.alias} (${reject.reason})`);
+                        }
+                        const waiterList = this.registeredWaiters;
+                        this.registeredWaiters = [];
+                        for (const waiter of waiterList)
+                            waiter(msg);
+                        return;
+                    }
+                    if (msg.type === 'request.start') {
+                        const backend = this.backends.get(msg.backendId);
+                        if (!backend) {
+                            ws.send(JSON.stringify({
+                                type: 'response.error',
+                                requestId: msg.requestId,
+                                code: 'BACKEND_NOT_FOUND',
+                                message: `backend '${msg.backendId}' is not configured on this agent`,
+                            }));
+                            return;
+                        }
+                        const job = new Job(ws, backend, this.health, msg, this.log, (id) => this.jobs.delete(id));
+                        this.jobs.set(msg.requestId, job);
+                        this.log.debug(`request ${msg.requestId} accepted on backend ${msg.backendId}`);
+                        return;
+                    }
+                    if (msg.type === 'request.end') {
+                        this.jobs.get(msg.requestId)?.onEnd();
+                        return;
+                    }
+                    if (msg.type === 'request.cancel') {
+                        this.jobs.get(msg.requestId)?.abort();
+                        this.jobs.delete(msg.requestId);
+                        return;
+                    }
+                }
+                catch (err) {
+                    this.log.warn(`bad frame from hub: ${err instanceof Error ? err.message : err}`);
+                    ws.close(1008);
+                }
+            });
+            ws.on('close', () => {
+                for (const job of this.jobs.values())
+                    job.abort();
+                this.jobs.clear();
+                this.ws = null;
+                resolve(undefined);
+            });
+            ws.on('error', (err) => {
+                this.log.debug(`tunnel error: ${err.message}`);
+            });
+        });
+    }
+    register() {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        ws.send(JSON.stringify({
+            type: 'register',
+            offerings: this.opts.config.offerings.map((o) => ({
+                alias: o.alias,
+                protocol: this.backends.get(o.backend)?.protocol,
+                upstreamModel: o.upstreamModel,
+                backendId: o.backend,
+                maxConcurrency: o.maxConcurrency,
+            })),
+        }));
+    }
+    sendHeartbeat() {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        ws.send(JSON.stringify({ type: 'heartbeat', backendStatus: this.health.statusMap() }));
+    }
+    /** Minimal live probe for degraded backends; success clears the degraded state. */
+    async probeDegraded() {
+        for (const backend of this.backends.values()) {
+            if (!this.health.isDegraded(backend.id))
+                continue;
+            const offering = this.opts.config.offerings.find((o) => o.backend === backend.id);
+            if (!offering)
+                continue;
+            try {
+                const { url, headers } = probeTarget(backend);
+                const resp = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(probeBody(offering.upstreamModel, backend.protocol)),
+                    signal: AbortSignal.timeout(10_000),
+                });
+                const reason = classifyStatus(resp.status);
+                this.health.record(backend.id, reason === null, reason ?? undefined);
+                // drain to free the socket
+                await resp.arrayBuffer().catch(() => undefined);
+            }
+            catch {
+                this.health.record(backend.id, false, 'NETWORK');
+            }
+        }
+    }
+}
+export function probeTarget(backend) {
+    const base = backend.baseUrl.replace(/\/+$/, '');
+    const path = backend.protocol === 'anthropic'
+        ? '/v1/messages'
+        : backend.protocol === 'responses'
+            ? '/responses'
+            : '/chat/completions';
+    const headers = { 'content-type': 'application/json' };
+    if (backend.protocol === 'anthropic') {
+        if (backend.apiKey)
+            headers['x-api-key'] = backend.apiKey;
+        headers['anthropic-version'] = '2023-06-01';
+    }
+    else if (backend.apiKey) {
+        headers.authorization = `Bearer ${backend.apiKey}`;
+    }
+    return { url: base + path, headers };
+}
+export function probeBody(model, protocol = 'openai') {
+    if (protocol === 'responses') {
+        return {
+            model,
+            input: [{ role: 'user', content: 'ping' }],
+            max_output_tokens: 1,
+            stream: false,
+        };
+    }
+    return { model, messages: [{ role: 'user', content: 'ping' }], max_tokens: 1, stream: false };
+}
+//# sourceMappingURL=connection.js.map

package/apps/agent/dist/connection.js.map

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

package/apps/agent/dist/doctor.d.ts

@@ -0,0 +1,14 @@
+export interface DoctorCheck {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    checks: DoctorCheck[];
+}
+/**
+ * Pre-flight diagnostics, in fasten's order of "find the first failing link":
+ * direct backend replay first, hub last. Never guess past a failure.
+ */
+export declare function runDoctor(dir: string): Promise<DoctorReport>;