@tagma/sdk 0.7.1 → 0.7.4

package/dist/logger.js

@@ -1,154 +1,2 @@
-import { resolve, dirname } from 'node:path';
-import { mkdirSync, writeFileSync, openSync, writeSync, closeSync } from 'node:fs';
-const TASK_PREFIX_RE = /\[task:([^\]]+)\]/;
-function taskIdFromPrefix(prefix) {
-    const m = TASK_PREFIX_RE.exec(prefix);
-    return m ? m[1] : null;
-}
-/**
- * Dual-channel logger.
- *
- *   - `info/warn/error` → console AND file (brief, user-visible events)
- *   - `debug`           → file ONLY (verbose diagnostics)
- *   - `section`         → file ONLY (visual separators)
- *   - `quiet`           → file ONLY (bulk payload like full stdout dumps)
- *
- * Log file path: <workDir>/.tagma/logs/<runId>/pipeline.log (one file per pipeline run,
- * truncated on construction). Every line is also forwarded to the optional
- * `onLine` callback as a structured `LogRecord`, so callers that want to
- * stream the run process over IPC/SSE don't need to tail the file.
- */
-export class Logger {
-    filePath;
-    runDir;
-    onLine;
-    /** Persistent file descriptor for append writes (avoids open/close per line). */
-    fd;
-    constructor(workDir, runId, onLine) {
-        this.runDir = resolve(workDir, '.tagma', 'logs', runId);
-        this.filePath = resolve(this.runDir, 'pipeline.log');
-        this.onLine = onLine ?? null;
-        mkdirSync(dirname(this.filePath), { recursive: true });
-        const header = `# Pipeline run ${runId} @ ${new Date().toISOString()}\n` +
-            `# Host: ${process.platform} ${process.arch}  Bun: ${process.versions.bun ?? 'n/a'}\n` +
-            `# Work dir: ${workDir}\n\n`;
-        writeFileSync(this.filePath, header);
-        // Open once for all subsequent appends (O_APPEND is implied by 'a' flag)
-        this.fd = openSync(this.filePath, 'a');
-    }
-    info(prefix, message) {
-        const ts = timestamp();
-        const line = `${ts} ${prefix} ${message}`;
-        // eslint-disable-next-line no-console
-        console.log(line);
-        this.emit('info', ts, line, taskIdFromPrefix(prefix));
-        this.append(line);
-    }
-    warn(prefix, message) {
-        const ts = timestamp();
-        const line = `${ts} ${prefix} WARN: ${message}`;
-        console.warn(line);
-        this.emit('warn', ts, line, taskIdFromPrefix(prefix));
-        this.append(line);
-    }
-    error(prefix, message) {
-        const ts = timestamp();
-        const line = `${ts} ${prefix} ERROR: ${message}`;
-        console.error(line);
-        this.emit('error', ts, line, taskIdFromPrefix(prefix));
-        this.append(line);
-    }
-    /** File-only diagnostic log line. */
-    debug(prefix, message) {
-        const ts = timestamp();
-        const line = `${ts} ${prefix} DEBUG: ${message}`;
-        this.emit('debug', ts, line, taskIdFromPrefix(prefix));
-        this.append(line);
-    }
-    /** File-only visual separator with title. */
-    section(title, taskId) {
-        const ts = timestamp();
-        const text = `\n━━━ ${title} ━━━`;
-        this.emit('section', ts, text, taskId ?? null);
-        this.append(text);
-    }
-    /** File-only bulk payload (e.g. full stdout / stderr dumps). */
-    quiet(message, taskId) {
-        const ts = timestamp();
-        this.emit('quiet', ts, message, taskId ?? null);
-        this.append(message);
-    }
-    append(line) {
-        if (this.fd === null)
-            return;
-        try {
-            const data = line.endsWith('\n') ? line : line + '\n';
-            writeSync(this.fd, data);
-        }
-        catch {
-            // Swallow log write failures; engine correctness shouldn't depend on logging.
-        }
-    }
-    /** Close the persistent file handle. Called by the engine at run completion. */
-    close() {
-        if (this.fd !== null) {
-            try {
-                closeSync(this.fd);
-            }
-            catch {
-                /* already closed */
-            }
-            this.fd = null;
-        }
-    }
-    emit(level, ts, text, taskId) {
-        if (!this.onLine)
-            return;
-        try {
-            this.onLine({ level, taskId, timestamp: ts, text });
-        }
-        catch {
-            // Never let a listener error derail the pipeline.
-        }
-    }
-    get path() {
-        return this.filePath;
-    }
-    /** Directory that holds all artifacts for this run (pipeline.log, *.stderr, etc.). */
-    get dir() {
-        return this.runDir;
-    }
-}
-function timestamp() {
-    const d = new Date();
-    const hh = String(d.getHours()).padStart(2, '0');
-    const mm = String(d.getMinutes()).padStart(2, '0');
-    const ss = String(d.getSeconds()).padStart(2, '0');
-    const ms = String(d.getMilliseconds()).padStart(3, '0');
-    return `${hh}:${mm}:${ss}.${ms}`;
-}
-/** Return the last `n` non-empty lines of `text`, joined with newlines. */
-export function tailLines(text, n) {
-    if (!text)
-        return '';
-    const lines = text.split(/\r?\n/).filter((l) => l.length > 0);
-    return lines.slice(-n).join('\n');
-}
-/**
- * Truncate a blob to at most `maxBytes` UTF-8 bytes for log embedding,
- * appending a marker when truncation occurred.
- * Uses TextEncoder so CJK and emoji (multi-byte) characters are counted correctly.
- */
-export function clip(text, maxBytes = 16 * 1024) {
-    if (!text)
-        return '';
-    const encoder = new TextEncoder();
-    const bytes = encoder.encode(text);
-    if (bytes.length <= maxBytes)
-        return text;
-    const omittedBytes = bytes.length - maxBytes;
-    // TextDecoder handles partial code-point boundaries safely (replacement char insertion)
-    const truncated = new TextDecoder().decode(bytes.slice(0, maxBytes));
-    return truncated + `\n…[truncated ${omittedBytes} bytes]`;
-}
+export { clip, Logger, tailLines } from '@tagma/core';
 //# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAoBnF,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,MAAM;IACA,QAAQ,CAAS;IACjB,MAAM,CAAS;IACf,MAAM,CAAqB;IAC5C,iFAAiF;IACzE,EAAE,CAAgB;IAE1B,YAAY,OAAe,EAAE,KAAa,EAAE,MAAoB;QAC9D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;QAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,MAAM,GACV,kBAAkB,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI;YACzD,WAAW,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,IAAI;YACtF,eAAe,OAAO,MAAM,CAAC;QAC/B,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrC,yEAAyE;QACzE,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAe;QAClC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QAC1C,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAe;QAClC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,MAAM,UAAU,OAAO,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,OAAe;QACnC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,MAAM,WAAW,OAAO,EAAE,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,MAAc,EAAE,OAAe;QACnC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,MAAM,WAAW,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,6CAA6C;IAC7C,OAAO,CAAC,KAAa,EAAE,MAAsB;QAC3C,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,OAAe,EAAE,MAAsB;QAC3C,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;YACtD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;QAChF,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK;QACH,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,oBAAoB;YACtB,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAe,EAAE,EAAU,EAAE,IAAY,EAAE,MAAqB;QAC3E,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,sFAAsF;IACtF,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,SAAS,SAAS;IAChB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,CAAS;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,QAAQ,GAAG,EAAE,GAAG,IAAI;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC7C,wFAAwF;IACxF,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,OAAO,SAAS,GAAG,iBAAiB,YAAY,SAAS,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugins.d.ts

@@ -1,5 +1,5 @@
 export { bootstrapBuiltins } from './bootstrap';
-export { PluginRegistry, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from './registry';
-export type { RegisterResult } from './registry';
-export type { PluginCategory, PluginModule, PluginManifest, DriverPlugin, TriggerPlugin, CompletionPlugin, MiddlewarePlugin, } from './types';
+export { PluginRegistry, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from '@tagma/core';
+export type { RegisteredCapability, RegisterResult } from '@tagma/core';
+export type { CapabilityHandler, PluginCategory, PluginCapabilities, PluginModule, PluginManifest, PluginSetupContext, TagmaPlugin, DriverPlugin, TriggerPlugin, CompletionPlugin, MiddlewarePlugin, } from './types';
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/plugins.js

@@ -1,3 +1,3 @@
 export { bootstrapBuiltins } from './bootstrap';
-export { PluginRegistry, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from './registry';
+export { PluginRegistry, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from '@tagma/core';
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/registry.d.ts

@@ -1,61 +1,3 @@
-import type { PluginCategory, DriverPlugin, TriggerPlugin, CompletionPlugin, MiddlewarePlugin, PluginManifest } from './types';
-type PluginType = DriverPlugin | TriggerPlugin | CompletionPlugin | MiddlewarePlugin;
-export type RegisterResult = 'registered' | 'replaced' | 'unchanged';
-export declare const PLUGIN_NAME_RE: RegExp;
-export declare function isValidPluginName(name: unknown): name is string;
-/**
- * Parse and validate the `tagmaPlugin` field of a `package.json` blob.
- *
- * Returns the strongly-typed manifest if the field is present and
- * well-formed (`category` is one of the four known categories and `type`
- * is a non-empty string). Returns `null` if the field is absent �?that
- * is the host's signal that the package is a library, not a plugin.
- *
- * Throws if the field is present but malformed: that's a packaging bug
- * the plugin author should hear about loudly, not a silent skip.
- *
- * Hosts use this during auto-discovery to decide whether to load a
- * package as a plugin without having to dynamically `import()` it.
- */
-export declare function readPluginManifest(pkgJson: unknown): PluginManifest | null;
-/**
- * Instance-scoped plugin registry. Each workspace in a multi-tenant sidecar
- * owns its own PluginRegistry, so installing/uninstalling a driver in one
- * workspace cannot clobber another.
- */
-export declare class PluginRegistry {
-    private readonly registries;
-    /**
-     * Register a plugin under (category, type). Returns:
-     *   - 'registered' on first registration
-     *   - 'replaced'   when an existing entry was overwritten with a different handler
-     *   - 'unchanged'  when the same handler instance was already present
-     *
-     * Throws if `category` is unknown, `type` is empty, or `handler` violates
-     * the minimum interface contract for the category.
-     */
-    registerPlugin<T extends PluginType>(category: PluginCategory, type: string, handler: T): RegisterResult;
-    /**
-     * Remove a plugin from the in-process registry. Returns true if a plugin
-     * was actually removed. Note: ESM module caching is not affected, so
-     * re-importing the same file after unregister will yield the cached module �?   * callers wanting a fresh load must restart the host process.
-     */
-    unregisterPlugin(category: PluginCategory, type: string): boolean;
-    getHandler<T extends PluginType>(category: PluginCategory, type: string): T;
-    hasHandler(category: PluginCategory, type: string): boolean;
-    listRegistered(category: PluginCategory): string[];
-    /**
-     * Load and register a list of plugin packages into this registry.
-     *
-     * @param pluginNames - Validated npm package names to load.
-     * @param resolveFrom - Optional absolute path to resolve plugins from (e.g.
-     *   the workspace's working directory). When omitted, the default ESM
-     *   resolution uses the SDK's own `node_modules`, which will fail for
-     *   plugins installed only in the user's workspace. CLI callers should
-     *   pass `process.cwd()` or the workspace root so that workspace-local
-     *   plugins resolve correctly.
-     */
-    loadPlugins(pluginNames: readonly string[], resolveFrom?: string): Promise<void>;
-}
-export {};
+export { isValidPluginName, PluginRegistry, PLUGIN_NAME_RE, readPluginManifest, } from '@tagma/core';
+export type { RegisteredCapability, RegisterResult } from '@tagma/core';
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,KAAK,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AA2GrF,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AAKrE,eAAO,MAAM,cAAc,QAA4D,CAAC;AAExF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAwB1E;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAKzB;IAEF;;;;;;;;OAQG;IACH,cAAc,CAAC,CAAC,SAAS,UAAU,EACjC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GACT,cAAc;IAiCjB;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjE,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAW3E,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3D,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE;IAIlD;;;;;;;;;;OAUG;IACG,WAAW,CACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CA0BjB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/registry.js

@@ -1,254 +1,2 @@
-import { createRequire } from 'node:module';
-import { pathToFileURL } from 'node:url';
-const VALID_CATEGORIES = new Set([
-    'drivers',
-    'triggers',
-    'completions',
-    'middlewares',
-]);
-const PLUGIN_TYPE_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
-function singularCategory(category) {
-    switch (category) {
-        case 'drivers':
-            return 'driver';
-        case 'triggers':
-            return 'trigger';
-        case 'completions':
-            return 'completion';
-        case 'middlewares':
-            return 'middleware';
-    }
-}
-/**
- * Minimal contract enforcement so a malformed plugin fails fast at
- * registration time rather than crashing the engine mid-run.
- *
- * For drivers we materialize `capabilities` and assert each field is a
- * boolean �?otherwise a plugin author can write
- *     get capabilities() { throw new Error('boom') }
- * and pass the basic typeof check, then crash preflight when the engine
- * touches `driver.capabilities.sessionResume`. (R8)
- */
-function validateContract(category, handler) {
-    if (!handler || typeof handler !== 'object') {
-        throw new Error(`Plugin handler for category "${category}" must be an object`);
-    }
-    const h = handler;
-    if (typeof h.name !== 'string' || h.name.length === 0) {
-        throw new Error(`Plugin handler for category "${category}" must declare a non-empty "name"`);
-    }
-    switch (category) {
-        case 'drivers': {
-            if (typeof h.buildCommand !== 'function') {
-                throw new Error(`drivers plugin "${h.name}" must export buildCommand()`);
-            }
-            // Materialize capabilities �?this triggers any throwing getter NOW
-            // instead of during preflight.
-            let caps;
-            try {
-                caps = h.capabilities;
-            }
-            catch (err) {
-                throw new Error(`drivers plugin "${h.name}" capabilities accessor threw: ` +
-                    (err instanceof Error ? err.message : String(err)));
-            }
-            if (!caps || typeof caps !== 'object') {
-                throw new Error(`drivers plugin "${h.name}" must declare capabilities object`);
-            }
-            const c = caps;
-            for (const field of ['sessionResume', 'systemPrompt', 'outputFormat']) {
-                if (typeof c[field] !== 'boolean') {
-                    throw new Error(`drivers plugin "${h.name}".capabilities.${field} must be a boolean (got ${typeof c[field]})`);
-                }
-            }
-            // Optional methods, but if present must be functions.
-            for (const opt of ['parseResult', 'resolveModel', 'resolveTools']) {
-                if (h[opt] !== undefined && typeof h[opt] !== 'function') {
-                    throw new Error(`drivers plugin "${h.name}".${opt} must be a function or undefined`);
-                }
-            }
-            break;
-        }
-        case 'triggers':
-            if (typeof h.watch !== 'function') {
-                throw new Error(`triggers plugin "${h.name}" must export watch()`);
-            }
-            break;
-        case 'completions':
-            if (typeof h.check !== 'function') {
-                throw new Error(`completions plugin "${h.name}" must export check()`);
-            }
-            break;
-        case 'middlewares':
-            // A middleware must provide at least one entry point. `enhanceDoc` is
-            // the structured PromptDocument API (preferred); `enhance` is the
-            // legacy string-in/string-out API the engine still supports for
-            // v0.x plugins. Requiring only `enhance` here rejects every built-in
-            // and every plugin written against the current types.
-            if (typeof h.enhanceDoc !== 'function' && typeof h.enhance !== 'function') {
-                throw new Error(`middlewares plugin "${h.name}" must export enhanceDoc() or enhance()`);
-            }
-            if (h.enhanceDoc !== undefined && typeof h.enhanceDoc !== 'function') {
-                throw new Error(`middlewares plugin "${h.name}".enhanceDoc must be a function or undefined`);
-            }
-            if (h.enhance !== undefined && typeof h.enhance !== 'function') {
-                throw new Error(`middlewares plugin "${h.name}".enhance must be a function or undefined`);
-            }
-            break;
-    }
-}
-// Plugin name must be a scoped npm package or a tagma-prefixed package.
-// Reject absolute/relative paths and suspicious patterns to prevent
-// arbitrary code execution via crafted YAML configs.
-export const PLUGIN_NAME_RE = /^(@[a-z0-9-]+\/[a-z0-9._-]+|tagma-plugin-[a-z0-9._-]+)$/;
-export function isValidPluginName(name) {
-    return typeof name === 'string' && PLUGIN_NAME_RE.test(name);
-}
-/**
- * Parse and validate the `tagmaPlugin` field of a `package.json` blob.
- *
- * Returns the strongly-typed manifest if the field is present and
- * well-formed (`category` is one of the four known categories and `type`
- * is a non-empty string). Returns `null` if the field is absent �?that
- * is the host's signal that the package is a library, not a plugin.
- *
- * Throws if the field is present but malformed: that's a packaging bug
- * the plugin author should hear about loudly, not a silent skip.
- *
- * Hosts use this during auto-discovery to decide whether to load a
- * package as a plugin without having to dynamically `import()` it.
- */
-export function readPluginManifest(pkgJson) {
-    if (!pkgJson || typeof pkgJson !== 'object')
-        return null;
-    const raw = pkgJson.tagmaPlugin;
-    if (raw === undefined)
-        return null;
-    if (!raw || typeof raw !== 'object') {
-        throw new Error('tagmaPlugin field must be an object with { category, type }');
-    }
-    const m = raw;
-    const category = m.category;
-    const type = m.type;
-    if (typeof category !== 'string' || !VALID_CATEGORIES.has(category)) {
-        throw new Error(`tagmaPlugin.category must be one of ${[...VALID_CATEGORIES].join(', ')}, got ${JSON.stringify(category)}`);
-    }
-    if (typeof type !== 'string' || type.length === 0) {
-        throw new Error(`tagmaPlugin.type must be a non-empty string, got ${JSON.stringify(type)}`);
-    }
-    if (!PLUGIN_TYPE_RE.test(type)) {
-        throw new Error(`tagmaPlugin.type must match ${PLUGIN_TYPE_RE} (letters, digits, underscores, hyphens; no paths or dots), got ${JSON.stringify(type)}`);
-    }
-    return { category: category, type };
-}
-/**
- * Instance-scoped plugin registry. Each workspace in a multi-tenant sidecar
- * owns its own PluginRegistry, so installing/uninstalling a driver in one
- * workspace cannot clobber another.
- */
-export class PluginRegistry {
-    registries = {
-        drivers: new Map(),
-        triggers: new Map(),
-        completions: new Map(),
-        middlewares: new Map(),
-    };
-    /**
-     * Register a plugin under (category, type). Returns:
-     *   - 'registered' on first registration
-     *   - 'replaced'   when an existing entry was overwritten with a different handler
-     *   - 'unchanged'  when the same handler instance was already present
-     *
-     * Throws if `category` is unknown, `type` is empty, or `handler` violates
-     * the minimum interface contract for the category.
-     */
-    registerPlugin(category, type, handler) {
-        if (!VALID_CATEGORIES.has(category)) {
-            throw new Error(`Unknown plugin category "${category}"`);
-        }
-        if (typeof type !== 'string' || type.length === 0) {
-            throw new Error(`Plugin type must be a non-empty string (category="${category}")`);
-        }
-        if (!PLUGIN_TYPE_RE.test(type)) {
-            throw new Error(`Plugin type "${type}" must match ${PLUGIN_TYPE_RE} (letters, digits, underscores, hyphens; no paths or dots)`);
-        }
-        validateContract(category, handler);
-        const registry = this.registries[category];
-        const existing = registry.get(type);
-        if (existing === handler)
-            return 'unchanged';
-        const wasReplaced = existing !== undefined;
-        registry.set(type, handler);
-        if (wasReplaced) {
-            // D18: surface silent shadowing. Hot-reload flows legitimately replace
-            // handlers; installing two different plugin packages that both claim
-            // the same (category, type) does not �?the second wins and breaks the
-            // first's consumers with no audit trail. A console.warn is cheap,
-            // respects existing callers that rely on 'replaced', and gives ops a
-            // grep-able signal when registrations collide unexpectedly.
-            console.warn(`[tagma-sdk] registerPlugin: replaced existing ${category}/${type} �?` +
-                `check for duplicate plugin packages claiming the same type.`);
-        }
-        return wasReplaced ? 'replaced' : 'registered';
-    }
-    /**
-     * Remove a plugin from the in-process registry. Returns true if a plugin
-     * was actually removed. Note: ESM module caching is not affected, so
-     * re-importing the same file after unregister will yield the cached module �?   * callers wanting a fresh load must restart the host process.
-     */
-    unregisterPlugin(category, type) {
-        if (!VALID_CATEGORIES.has(category))
-            return false;
-        return this.registries[category].delete(type);
-    }
-    getHandler(category, type) {
-        const handler = this.registries[category].get(type);
-        if (!handler) {
-            throw new Error(`${category} type "${type}" not registered.\n` +
-                `Install the plugin: bun add @tagma/${singularCategory(category)}-${type}`);
-        }
-        return handler;
-    }
-    hasHandler(category, type) {
-        return this.registries[category].has(type);
-    }
-    listRegistered(category) {
-        return [...this.registries[category].keys()];
-    }
-    /**
-     * Load and register a list of plugin packages into this registry.
-     *
-     * @param pluginNames - Validated npm package names to load.
-     * @param resolveFrom - Optional absolute path to resolve plugins from (e.g.
-     *   the workspace's working directory). When omitted, the default ESM
-     *   resolution uses the SDK's own `node_modules`, which will fail for
-     *   plugins installed only in the user's workspace. CLI callers should
-     *   pass `process.cwd()` or the workspace root so that workspace-local
-     *   plugins resolve correctly.
-     */
-    async loadPlugins(pluginNames, resolveFrom) {
-        for (const name of pluginNames) {
-            if (!isValidPluginName(name)) {
-                throw new Error(`Plugin "${name}" rejected: plugin names must be scoped npm packages ` +
-                    `(e.g. @tagma/trigger-xyz) or tagma-plugin-* packages. ` +
-                    `Relative/absolute paths are not allowed.`);
-            }
-            let moduleUrl = name;
-            if (resolveFrom) {
-                // Resolve the package entry point relative to the caller's directory
-                // so plugins installed in the workspace's node_modules are found
-                // even when the SDK itself lives elsewhere (e.g. a global install
-                // or a monorepo sibling package).
-                const req = createRequire(resolveFrom.endsWith('/') ? resolveFrom : resolveFrom + '/');
-                const resolved = req.resolve(name);
-                moduleUrl = pathToFileURL(resolved).href;
-            }
-            const mod = await import(moduleUrl);
-            if (!mod.pluginCategory || !mod.pluginType || !mod.default) {
-                throw new Error(`Plugin "${name}" must export pluginCategory, pluginType, and default`);
-            }
-            this.registerPlugin(mod.pluginCategory, mod.pluginType, mod.default);
-        }
-    }
-}
+export { isValidPluginName, PluginRegistry, PLUGIN_NAME_RE, readPluginManifest, } from '@tagma/core';
 //# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/runner.d.ts

@@ -1,36 +1,2 @@
-import type { SpawnSpec, DriverPlugin, TaskResult } from './types';
-export interface RunOptions {
-    readonly timeoutMs?: number;
-    readonly signal?: AbortSignal;
-    /**
-     * If set, stream the child's stdout to this file path as it arrives. The
-     * returned `TaskResult.stdout` is still a bounded in-memory tail
-     * (`maxStdoutTailBytes`) — callers that need the full output should read
-     * from the returned `stdoutPath`. Parent directories are created as needed.
-     */
-    readonly stdoutPath?: string;
-    /** Symmetric to `stdoutPath` for stderr. */
-    readonly stderrPath?: string;
-    /**
-     * Cap on bytes retained in memory for the returned `TaskResult.stdout`
-     * string. Defaults to `DEFAULT_STDOUT_TAIL_BYTES`. Bytes beyond this cap
-     * from the HEAD of the stream are dropped from the in-memory string; the
-     * on-disk file (if `stdoutPath` is set) is still the full output.
-     */
-    readonly maxStdoutTailBytes?: number;
-    readonly maxStderrTailBytes?: number;
-}
-/**
- * R2: Validate a SpawnSpec returned by a third-party driver. Returns null on
- * success or a human-readable error message describing the first violation.
- *
- * Catching this here is critical: an undetected bad spec ends up calling
- * Bun.spawn with garbage and the resulting TypeError leaks into engine
- * processTask's catch block as "Cannot read properties of undefined". By
- * validating here we surface a clear "Driver X returned invalid args" message
- * instead, and short-circuit before holding any process resources.
- */
-export declare function validateSpawnSpec(spec: unknown, driverName: string): string | null;
-export declare function runSpawn(spec: SpawnSpec, driver: DriverPlugin | null, opts?: RunOptions): Promise<TaskResult>;
-export declare function runCommand(command: string, cwd: string, opts?: RunOptions): Promise<TaskResult>;
+export { runCommand, runSpawn } from '@tagma/runtime-bun';
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA4CnE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AA4SD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoClF;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CA0OrB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CAMrB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}