@tessar/plugins 0.0.0-stage → 0.1.0-alpha.0

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @tessar/plugins
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional Node host utilities for loading plugins after an application is packaged,
+managing npm plugin packages, and structured logging. Requires Node 24.14 or newer.
+
+```sh
+npm install @tessar/core@next @tessar/plugins@next
+```
+
+```ts
+import { PluginManager } from "@tessar/plugins";
+import { LoggerPlugin } from "@tessar/plugins/logger";
+
+const manager = new PluginManager({
+  directory: ".my-cli",
+  hostUrl: import.meta.url,
+});
+const plugins = [new LoggerPlugin(), ...await manager.load()];
+// Pass plugins to new Controller({ id, agent, plugins }).
+// Dispose Controller first, then call manager.dispose() in finally.
+```
+
+Custom files under `plugins/`, or folders with an index entry, default-export a
+plugin instance. The manager supplies the host's public `@tessar/core` imports.
+Erasable TypeScript custom files are supported; npm packages publish JavaScript.
+
+`install(source)`, `update(name?)` and `remove(name)` use npm in the managed `npm/`
+subdirectory. Installed package names are recorded in `plugins.json` under
+`packages`; custom files are discovered automatically. `load()` never installs
+missing dependencies. A consuming CLI chooses its own command name and directory.
+
+Logger writes JSON lifecycle/error entries to stderr by default. Use
+`new LoggerPlugin({ write: entry => yourLogger.write(entry) })` for another sink.
+
+This is an alpha release. See the
+[repository](https://github.com/hphucdev-04/tessar) for usage and contracts.

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import type { Plugin } from "@tessar/core";
+export interface PluginManagerOptions {
+    directory: string;
+    /** A host module URL from which public SDK imports resolve. */
+    hostUrl?: string;
+}
+/** Opt-in Node host utilities; PluginHost still owns setup and resource cleanup. */
+export declare class PluginManager {
+    readonly directory: string;
+    private readonly npmDirectory;
+    private readonly hostUrl;
+    private readonly prefix;
+    private readonly graph;
+    private resolver?;
+    private disposed;
+    private mutation;
+    constructor(options: PluginManagerOptions);
+    private check;
+    private readJson;
+    private manifest;
+    private configuration;
+    discover(): Promise<string[]>;
+    private registerResolver;
+    load(sources?: readonly string[]): Promise<Plugin[]>;
+    private mutate;
+    private saveConfiguration;
+    private npm;
+    install(source: string, options?: {
+        name?: string;
+    }): Promise<string>;
+    update(name?: string): Promise<void>;
+    remove(name: string): Promise<void>;
+    dispose(): void;
+}

package/dist/index.js

@@ -0,0 +1,308 @@
+import { readFile, readdir, mkdir, writeFile, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { createRequire, registerHooks } from "node:module";
+import { isAbsolute, join, resolve, dirname, delimiter } from "node:path";
+import { pathToFileURL } from "node:url";
+import { randomUUID } from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const extensions = [".mjs", ".js", ".cjs", ".mts", ".ts", ".cts"];
+const isEntry = (name) => extensions.some((ext) => name.endsWith(ext)) &&
+    !/\.d\.(?:ts|mts|cts)$/.test(name);
+const missing = (error) => error.code === "ENOENT";
+const execute = promisify(execFile);
+const packageName = /^(@[a-z0-9._-]+\/[a-z0-9._-]+|[a-z0-9][a-z0-9._-]*)(?:@.+)?$/i;
+function validName(name) {
+    if (packageName.exec(name)?.[1] !== name)
+        throw Error("Invalid plugin package name: " + name);
+}
+/** Opt-in Node host utilities; PluginHost still owns setup and resource cleanup. */
+export class PluginManager {
+    directory;
+    npmDirectory;
+    hostUrl;
+    prefix = "tessar-plugin:" + randomUUID() + "/";
+    graph = new Set();
+    resolver;
+    disposed = false;
+    mutation = Promise.resolve();
+    constructor(options) {
+        if (!options.directory.trim())
+            throw Error("Plugin directory must be nonempty");
+        this.directory = resolve(options.directory);
+        this.npmDirectory = join(this.directory, "npm");
+        this.hostUrl = options.hostUrl ?? import.meta.url;
+    }
+    check() {
+        if (this.disposed)
+            throw Error("PluginManager is disposed");
+    }
+    async readJson(filename) {
+        let data;
+        try {
+            data = JSON.parse(await readFile(filename, "utf8"));
+        }
+        catch (error) {
+            if (missing(error))
+                return {};
+            throw new Error("Invalid JSON file " + filename, { cause: error });
+        }
+        if (!data || typeof data !== "object" || Array.isArray(data))
+            throw Error("Expected a JSON object in " + filename);
+        return data;
+    }
+    manifest() {
+        return this.readJson(join(this.npmDirectory, "package.json"));
+    }
+    async configuration() {
+        const filename = join(this.directory, "plugins.json");
+        const data = await this.readJson(filename);
+        if (data.packages !== undefined &&
+            (!Array.isArray(data.packages) ||
+                data.packages.some(value => typeof value !== "string" || !value.trim())))
+            throw Error("Invalid packages in " + filename);
+        return data;
+    }
+    async discover() {
+        this.check();
+        const directory = join(this.directory, "plugins");
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (!missing(error))
+                throw error;
+            entries = [];
+        }
+        const sources = [];
+        for (const entry of entries.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
+            if (entry.isFile() && isEntry(entry.name))
+                sources.push(join(directory, entry.name));
+            else if (entry.isDirectory()) {
+                const files = await readdir(join(directory, entry.name));
+                const indexes = extensions
+                    .map((ext) => "index" + ext)
+                    .filter((name) => files.includes(name));
+                if (indexes.length > 1)
+                    throw Error("Ambiguous plugin entry: " + join(directory, entry.name));
+                if (indexes[0])
+                    sources.push(join(directory, entry.name, indexes[0]));
+            }
+        }
+        const config = await this.configuration();
+        this.check();
+        return [...sources, ...(config.packages ?? [])];
+    }
+    registerResolver() {
+        if (this.resolver)
+            return;
+        this.resolver = registerHooks({
+            resolve: (specifier, context, nextResolve) => {
+                const sdkPrefix = this.prefix + "sdk/";
+                if (specifier.startsWith(sdkPrefix))
+                    return nextResolve(decodeURIComponent(specifier.slice(sdkPrefix.length)), { ...context, parentURL: this.hostUrl });
+                if (specifier.startsWith(this.prefix)) {
+                    const source = decodeURIComponent(specifier.slice(this.prefix.length));
+                    const result = nextResolve(source, {
+                        ...context,
+                        parentURL: pathToFileURL(join(this.npmDirectory, "package.json")).href,
+                    });
+                    this.graph.add(result.url);
+                    return result;
+                }
+                if (context.parentURL && this.graph.has(context.parentURL)) {
+                    if (specifier === "@tessar/core" ||
+                        specifier.startsWith("@tessar/core/"))
+                        // Resolve through ESM: require's default resolver retains caller search paths.
+                        return {
+                            url: import.meta.resolve(sdkPrefix + encodeURIComponent(specifier)),
+                            shortCircuit: true,
+                        };
+                    try {
+                        const result = nextResolve(specifier, context);
+                        this.graph.add(result.url);
+                        return result;
+                    }
+                    catch (error) {
+                        const code = error.code;
+                        if ((code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") ||
+                            specifier.startsWith(".") || isAbsolute(specifier) ||
+                            specifier.includes(":") || specifier.startsWith("#"))
+                            throw error;
+                        // Custom files can also use dependencies in the managed npm environment.
+                        const url = context.conditions.includes("require")
+                            ? pathToFileURL(createRequire(join(this.npmDirectory, "package.json")).resolve(specifier)).href
+                            : import.meta.resolve(this.prefix + encodeURIComponent(specifier));
+                        this.graph.add(url);
+                        return {
+                            url,
+                            shortCircuit: true,
+                        };
+                    }
+                }
+                return nextResolve(specifier, context);
+            },
+        });
+    }
+    async load(sources) {
+        this.check();
+        const entries = sources ?? (await this.discover());
+        this.check();
+        if (entries.length)
+            this.registerResolver();
+        const plugins = [], ids = new Set();
+        for (const source of entries) {
+            try {
+                const specifier = isAbsolute(source) || source.startsWith(".")
+                    ? pathToFileURL(resolve(this.directory, source)).href
+                    : source;
+                const module = await import(this.prefix + encodeURIComponent(specifier));
+                this.check();
+                const plugin = module.default;
+                if (!plugin ||
+                    typeof plugin !== "object" ||
+                    typeof plugin.id !== "string" ||
+                    !plugin.id.trim() ||
+                    typeof plugin.setup !== "function")
+                    throw Error("Expected a default Plugin export with id and setup(tessar)");
+                if (ids.has(plugin.id))
+                    throw Error("Duplicate plugin ID: " + plugin.id);
+                ids.add(plugin.id);
+                plugins.push(plugin);
+            }
+            catch (error) {
+                throw new Error("Cannot load plugin " +
+                    source +
+                    ": " +
+                    (error instanceof Error ? error.message : String(error)), { cause: error });
+            }
+        }
+        return plugins;
+    }
+    mutate(operation) {
+        const next = this.mutation.then(() => {
+            this.check();
+            return operation();
+        });
+        this.mutation = next.catch(() => { });
+        return next;
+    }
+    async saveConfiguration(config) {
+        await writeFile(join(this.directory, "plugins.json"), JSON.stringify(config, null, 2) + "\n");
+    }
+    async npm(args) {
+        const parameters = [
+            ...args,
+            "--prefix",
+            this.npmDirectory,
+            "--no-audit",
+            "--no-fund",
+        ];
+        // Windows .cmd launchers require a shell; invoke npm's JS entry with Node instead.
+        if (process.platform === "win32") {
+            const directories = [
+                dirname(process.execPath),
+                ...(process.env.PATH ?? "").split(delimiter),
+            ];
+            const cli = directories
+                .map((dir) => join(dir, "node_modules/npm/bin/npm-cli.js"))
+                .find(existsSync);
+            if (!cli)
+                throw Error("npm is not installed alongside Node or on PATH");
+            return (await execute(process.execPath, [cli, ...parameters], {
+                cwd: this.npmDirectory,
+                windowsHide: true,
+            })).stdout;
+        }
+        else
+            return (await execute("npm", parameters, {
+                cwd: this.npmDirectory,
+                windowsHide: true,
+            })).stdout;
+    }
+    install(source, options = {}) {
+        return this.mutate(async () => {
+            if (!source.trim() || source.startsWith("-"))
+                throw Error("Invalid plugin source");
+            const local = isAbsolute(source) ||
+                source.startsWith(".") ||
+                source.startsWith("file:");
+            const target = local
+                ? resolve(this.directory, source.replace(/^file:/, ""))
+                : source;
+            let sourceName = local
+                ? (await stat(target)).isDirectory()
+                    ? JSON.parse(await readFile(join(target, "package.json"), "utf8")).name
+                    : undefined
+                : packageName.exec(source)?.[1];
+            const name = options.name ?? sourceName;
+            if (typeof name !== "string")
+                throw Error("Provide a package name for Git, tarball or URL sources");
+            validName(name);
+            const config = await this.configuration();
+            await mkdir(this.npmDirectory, { recursive: true });
+            if (!existsSync(join(this.npmDirectory, "package.json")))
+                await writeFile(join(this.npmDirectory, "package.json"), JSON.stringify({ private: true, type: "module" }, null, 2) + "\n");
+            if (!sourceName) {
+                const packed = JSON.parse(await this.npm([
+                    "pack",
+                    "--dry-run",
+                    "--ignore-scripts",
+                    "--json",
+                    target,
+                ]));
+                sourceName = packed[0]?.name;
+            }
+            if (sourceName !== name)
+                throw Error("Requested name " +
+                    name +
+                    " differs from source package " +
+                    sourceName);
+            await this.npm(["install", "--save-exact", "--install-links", target]);
+            const manifest = await this.manifest();
+            if (!manifest.dependencies?.[name])
+                throw Error("Installed source did not provide requested package " + name);
+            config.packages = [...new Set([...(config.packages ?? []), name])];
+            await this.saveConfiguration(config);
+            return name;
+        });
+    }
+    update(name) {
+        return this.mutate(async () => {
+            const manifest = await this.manifest();
+            const config = await this.configuration();
+            const names = name
+                ? [name]
+                : (config.packages ?? []).filter((value) => manifest.dependencies?.[value]);
+            for (const value of names) {
+                validName(value);
+                if (!config.packages?.includes(value) ||
+                    !manifest.dependencies?.[value])
+                    throw Error("Not an installed plugin: " + value);
+            }
+            if (names.length)
+                await this.npm(["update", ...names]);
+        });
+    }
+    remove(name) {
+        return this.mutate(async () => {
+            validName(name);
+            const before = await this.manifest();
+            const config = await this.configuration();
+            if (!config.packages?.includes(name) ||
+                !before.dependencies?.[name])
+                throw Error("Not an installed plugin: " + name);
+            await this.npm(["uninstall", name]);
+            config.packages = (config.packages ?? []).filter(value => value !== name);
+            await this.saveConfiguration(config);
+        });
+    }
+    dispose() {
+        this.disposed = true;
+        this.resolver?.deregister();
+        this.resolver = undefined;
+        this.graph.clear();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,19 @@
+import { type EventContext, type Plugin, type PluginContext } from "@tessar/core";
+export interface LogEntry extends EventContext {
+    level: "info" | "warn" | "error";
+    type: string;
+    timestamp: string;
+    payload: unknown;
+}
+export interface LoggerOptions {
+    write?: (entry: LogEntry) => void | Promise<void>;
+}
+/** Structured lifecycle/error logs. Destinations and formatting belong to the host. */
+export declare class LoggerPlugin implements Plugin {
+    readonly id = "logger";
+    private readonly write;
+    constructor(options?: LoggerOptions);
+    setup(tessar: PluginContext): void;
+}
+declare const _default: LoggerPlugin;
+export default _default;

package/dist/logger.js

@@ -0,0 +1,55 @@
+import { AgentEvents, SessionEvents, } from "@tessar/core";
+const events = [
+    AgentEvents.Ready,
+    AgentEvents.ThreadStarted,
+    AgentEvents.ThreadShutdown,
+    AgentEvents.StreamStarted,
+    AgentEvents.StreamEnd,
+    AgentEvents.StreamError,
+    AgentEvents.StreamSuspended,
+    AgentEvents.StreamResumed,
+    AgentEvents.StreamCancel,
+    AgentEvents.TurnStart,
+    AgentEvents.TurnEnd,
+    AgentEvents.ModelStart,
+    AgentEvents.ModelEnd,
+    AgentEvents.ModelError,
+    AgentEvents.ToolStart,
+    AgentEvents.ToolEnd,
+    AgentEvents.ToolError,
+    AgentEvents.Diagnostic,
+    SessionEvents.Created,
+    SessionEvents.ModelChanged,
+    SessionEvents.ThreadCreated,
+    SessionEvents.ThreadSwitched,
+    SessionEvents.ThreadRenamed,
+    SessionEvents.ThreadForked,
+    SessionEvents.ThreadDeleted,
+    SessionEvents.InputQueued,
+    SessionEvents.InputDiscarded,
+    SessionEvents.Closed,
+];
+/** Structured lifecycle/error logs. Destinations and formatting belong to the host. */
+export class LoggerPlugin {
+    id = "logger";
+    write;
+    constructor(options = {}) {
+        this.write = options.write ?? ((entry) => {
+            console.error(JSON.stringify(entry));
+        });
+    }
+    setup(tessar) {
+        for (const name of events)
+            tessar.hook(name, (event) => this.write(Object.freeze({
+                ...event,
+                timestamp: event.timestamp ?? new Date().toISOString(),
+                level: "error" in event.payload && event.payload.error
+                    ? "error"
+                    : event.type === AgentEvents.StreamSuspended
+                        ? "warn"
+                        : "info",
+            })));
+    }
+}
+export default new LoggerPlugin();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,GAId,MAAM,cAAc,CAAC;AAUtB,MAAM,MAAM,GAAG;IACb,WAAW,CAAC,KAAK;IACjB,WAAW,CAAC,aAAa;IACzB,WAAW,CAAC,cAAc;IAC1B,WAAW,CAAC,aAAa;IACzB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,eAAe;IAC3B,WAAW,CAAC,aAAa;IACzB,WAAW,CAAC,YAAY;IACxB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,UAAU;IACtB,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,UAAU;IACtB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,UAAU;IACtB,aAAa,CAAC,OAAO;IACrB,aAAa,CAAC,YAAY;IAC1B,aAAa,CAAC,aAAa;IAC3B,aAAa,CAAC,cAAc;IAC5B,aAAa,CAAC,aAAa;IAC3B,aAAa,CAAC,YAAY;IAC1B,aAAa,CAAC,aAAa;IAC3B,aAAa,CAAC,WAAW;IACzB,aAAa,CAAC,cAAc;IAC5B,aAAa,CAAC,MAAM;CACZ,CAAC;AAEX,uFAAuF;AACvF,MAAM,OAAO,YAAY;IACd,EAAE,GAAG,QAAQ,CAAC;IACN,KAAK,CAAsC;IAE5D,YAAY,OAAO,GAAkB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAqB;QACzB,KAAK,MAAM,IAAI,IAAI,MAAM;YACvB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAC1B,IAAI,CAAC,KAAK,CACR,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,KAAK;gBACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtD,KAAK,EACH,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK;oBAC7C,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,eAAe;wBAC1C,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,MAAM;aACf,CAAC,CACH,CACF,CAAC;IACN,CAAC;CACF;AAED,eAAe,IAAI,YAAY,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@tessar/plugins",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "description": "Node plugin loading, npm package management and a built-in logger for Tessar.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hphucdev-04/tessar.git",
+    "directory": "packages/plugins"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "import": "./dist/logger.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.14.0"
+  },
+  "peerDependencies": {
+    "@tessar/core": "^0.1.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "@tessar/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tessar/core": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }