@lucasreiners/lead 0.1.0

package/dist/infrastructure/fs/config-fs-loader.d.ts

@@ -0,0 +1,6 @@
+import type { LeadConfig } from "../../config/schema";
+export interface ConfigFsLoader {
+    loadUserConfig(homeDir?: string): LeadConfig;
+    loadProjectConfig(projectDir: string): LeadConfig;
+}
+export declare function createConfigFsLoader(): ConfigFsLoader;

package/dist/managers/background-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * BackgroundManager.
+ * Manages background task spawning with concurrency control.
+ * v0.1: In-memory tracking only — real session spawning is deferred.
+ */
+export type TaskStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
+export interface SpawnOptions {
+    agentName: string;
+    prompt: string;
+    category?: string;
+    skills?: string[];
+    concurrencyKey?: string;
+}
+export interface TaskRecord {
+    id: string;
+    status: TaskStatus;
+    options: SpawnOptions;
+    result?: unknown;
+    error?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+export declare class BackgroundManager {
+    private readonly tasks;
+    readonly maxConcurrent: number;
+    constructor(maxConcurrent?: number);
+    /**
+     * Spawn a new background task.
+     * Returns the task ID. v0.1: Creates record only, does not execute.
+     */
+    spawn(options: SpawnOptions): string;
+    /** Get a task record by ID */
+    getTask(taskId: string): TaskRecord | undefined;
+    /** Cancel a task */
+    cancel(taskId: string): boolean;
+    /** Cancel all pending/running tasks */
+    cancelAll(): void;
+    /** List tasks, optionally filtered by status */
+    list(filter?: {
+        status?: TaskStatus;
+    }): TaskRecord[];
+    /** Count currently running tasks */
+    getRunningCount(): number;
+    /** Mark a task as completed with a result */
+    complete(taskId: string, result?: unknown): boolean;
+    /** Mark a task as failed with an error */
+    fail(taskId: string, error: string): boolean;
+}

package/dist/managers/config-handler.d.ts

@@ -0,0 +1,31 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+/**
+ * ConfigHandler.
+ * Registers all L.E.A.D. agents into OpenCode's agent configuration.
+ * Called by the plugin's `config` hook.
+ */
+export interface ConfigHandlerOptions {
+    /** Built-in agent configurations (name → AgentConfig) */
+    builtinAgents: Record<string, AgentConfig>;
+    /** Custom agent configurations (name → AgentConfig) */
+    customAgents?: Record<string, AgentConfig>;
+}
+export declare class ConfigHandler {
+    private readonly builtinAgents;
+    private readonly customAgents;
+    constructor(options: ConfigHandlerOptions);
+    /**
+     * Apply all agent configurations to the OpenCode config object.
+     * This method mutates the passed config to register all agents.
+     */
+    handle(config: {
+        agent?: Record<string, AgentConfig | undefined>;
+        default_agent?: string;
+        permission?: Record<string, unknown> | string;
+        plugin?: Array<string | [string, {
+            [key: string]: unknown;
+        }]>;
+    }): void;
+    /** Get all registered agent names */
+    getAgentNames(): string[];
+}

package/dist/managers/index.d.ts

@@ -0,0 +1,6 @@
+export { ConfigHandler } from "./config-handler";
+export type { ConfigHandlerOptions } from "./config-handler";
+export { BackgroundManager } from "./background-manager";
+export type { SpawnOptions, TaskRecord, TaskStatus } from "./background-manager";
+export { SkillMcpManager } from "./skill-mcp-manager";
+export type { McpServerConfig, SkillMcpClientInfo } from "./skill-mcp-manager";

package/dist/managers/skill-mcp-manager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SkillMcpManager.
+ * Stub for MCP server declarations from skills.
+ * v0.1: No-op placeholder — full MCP integration deferred to future release.
+ */
+export interface McpServerConfig {
+    type?: "stdio" | "http";
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+}
+export interface SkillMcpClientInfo {
+    sessionId: string;
+    skillName: string;
+    serverName: string;
+}
+/**
+ * SkillMcpManager manages MCP server connections declared by skills.
+ * Currently a stub — only stdio support planned, HTTP deferred.
+ */
+export declare class SkillMcpManager {
+    /** v0.1: No active connections */
+    getOrCreateClient(_info: SkillMcpClientInfo, _config: McpServerConfig): Promise<void>;
+    /** v0.1: Stub — throws not implemented */
+    callTool(_info: SkillMcpClientInfo, _config: McpServerConfig, _name: string, _args: unknown): Promise<unknown>;
+    /** Disconnect all clients for a session */
+    disconnectSession(_sessionId: string): Promise<void>;
+    /** Disconnect all clients */
+    disconnectAll(): Promise<void>;
+}

package/dist/plugin/index.d.ts

@@ -0,0 +1,2 @@
+export { createPluginInterface } from "./plugin-interface";
+export type { LeadHooks, ToolsRecord } from "./types";

package/dist/plugin/plugin-interface.d.ts

@@ -0,0 +1,7 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import type { PluginAdapterArgs } from "../runtime/opencode/plugin-adapter";
+/**
+ * Create the final Hooks object satisfying the OpenCode Plugin contract.
+ * This is the return value of the main plugin entry point.
+ */
+export declare function createPluginInterface(args: PluginAdapterArgs): Hooks;

package/dist/plugin/types.d.ts

@@ -0,0 +1,18 @@
+import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+/**
+ * Plugin context passed through the initialization chain.
+ */
+export type PluginContext = PluginInput;
+/**
+ * The full Hooks type from @opencode-ai/plugin.
+ * Re-exported for convenience.
+ */
+export type { Hooks } from "@opencode-ai/plugin";
+/**
+ * The subset of Hooks that L.E.A.D. implements.
+ */
+export type LeadHooks = Required<Pick<Hooks, "tool" | "config" | "chat.message" | "chat.params" | "event" | "tool.execute.before" | "tool.execute.after" | "command.execute.before" | "tool.definition" | "experimental.session.compacting">>;
+/**
+ * Tools record (empty in v0.1 — OpenCode provides the tools).
+ */
+export type ToolsRecord = Record<string, never>;

package/dist/runtime/opencode/plugin-adapter.d.ts

@@ -0,0 +1,17 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import type { ConfigHandler } from "../../managers/config-handler";
+import type { CreatedHooks } from "../../hooks/create-hooks";
+import type { LeadConfig } from "../../config/schema";
+/**
+ * Plugin adapter arguments.
+ */
+export interface PluginAdapterArgs {
+    pluginConfig: LeadConfig;
+    directory: string;
+    configHandler: ConfigHandler;
+    hooks: CreatedHooks;
+}
+/**
+ * Create the plugin adapter that bridges L.E.A.D. internals to OpenCode hooks.
+ */
+export declare function createPluginAdapter(args: PluginAdapterArgs): Hooks;

package/dist/shared/agent-display-names.d.ts

@@ -0,0 +1,3 @@
+export declare function getAgentDisplayName(key: string): string;
+export declare function updateBuiltinDisplayName(key: string, name: string): void;
+export declare function getAllDisplayNames(): Record<string, string>;

package/dist/shared/index.d.ts

@@ -0,0 +1,6 @@
+export type { DeepPartial } from "./types";
+export { setClient, setLogLevel, debug, info, warn, error } from "./log";
+export type { LogLevel, SdkClient } from "./log";
+export { resolveSafePath } from "./resolve-safe-path";
+export { getVersion } from "./version";
+export { getAgentDisplayName, updateBuiltinDisplayName, getAllDisplayNames } from "./agent-display-names";

package/dist/shared/log.d.ts

@@ -0,0 +1,9 @@
+import type { createOpencodeClient } from "@opencode-ai/sdk";
+export type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
+export type SdkClient = ReturnType<typeof createOpencodeClient>;
+export declare function setClient(client: SdkClient): void;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function debug(message: string, ...args: unknown[]): void;
+export declare function info(message: string, ...args: unknown[]): void;
+export declare function warn(message: string, ...args: unknown[]): void;
+export declare function error(message: string, ...args: unknown[]): void;

package/dist/shared/resolve-safe-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves a relative path against a base directory, rejecting:
+ * - Absolute paths
+ * - Path traversal attempts (..)
+ * - Paths that would escape the base directory
+ */
+export declare function resolveSafePath(base: string, relativePath: string): string;

package/dist/shared/types.d.ts

@@ -0,0 +1,3 @@
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};

package/dist/shared/version.d.ts

@@ -0,0 +1 @@
+export declare function getVersion(): string;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lucasreiners/lead",
+  "version": "0.1.0",
+  "description": "L.E.A.D. (Lucas Engineering Automation & Delivery) — enterprise-grade OpenCode plugin with professional agent orchestration",
+  "author": "L.E.A.D.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lucasreiners/lead.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist/"],
+  "scripts": {
+    "build": "bun run script/build.ts && tsc --emitDeclarationOnly",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.4.3",
+    "@opencode-ai/sdk": "^1.4.3",
+    "jsonc-parser": "^3.3.1",
+    "picocolors": "^1.1.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "bun": "^1.3.11",
+    "bun-types": "^1.3.11",
+    "typescript": "^6.0.2"
+  }
+}