operon-agents 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `operon-agents` — the batteries-included public API (Mode 2).
+ *
+ *   import { createHarness } from "operon-agents"
+ *
+ * The headline is the Harness facade + deployment presets. The whole (curated) core engine
+ * is re-exported here for convenience — `operon-agents-core` defines its own public surface,
+ * so this dump is already clean: engine plumbing (the turn/step loop, store migration/blob
+ * machinery, capability assembly, …) is NOT here — it lives on `operon-agents/internal`
+ * (≡ `operon-agents-core/internal`) for advanced embedders.
+ *
+ * For the low-level "assemble it yourself" path, import from `operon-agents/core`.
+ */
+export * from "./harness.ts";
+export * from "./extensions/index.ts";
+export * from "./cron/index.ts";
+export * from "./local.ts";
+export * from "operon-agents-core";
+export * as llm from "operon-agents-core/llm";
+export * as mcp from "operon-agents-core/mcp";
+export * as protocol from "operon-agents-core/protocol";
+export * as tools from "operon-agents-core/tools";
+export * as tracing from "operon-agents-core/tracing";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * `operon-agents` — the batteries-included public API (Mode 2).
+ *
+ *   import { createHarness } from "operon-agents"
+ *
+ * The headline is the Harness facade + deployment presets. The whole (curated) core engine
+ * is re-exported here for convenience — `operon-agents-core` defines its own public surface,
+ * so this dump is already clean: engine plumbing (the turn/step loop, store migration/blob
+ * machinery, capability assembly, …) is NOT here — it lives on `operon-agents/internal`
+ * (≡ `operon-agents-core/internal`) for advanced embedders.
+ *
+ * For the low-level "assemble it yourself" path, import from `operon-agents/core`.
+ */
+export * from "./harness.js";
+// Extensions are a harness concept: they need the session/provider reach only this layer has.
+// Core supplies the primitives they are built on (Capability / LoopHooks / ToolFilter / Injector).
+export * from "./extensions/index.js";
+export * from "./cron/index.js";
+// Deployment composition roots: local vs server injection presets (Invariant 7 — no engine "mode").
+export * from "./local.js";
+// The curated core engine, re-exported for convenience; `operon-agents/core` is the dedicated
+// primitives entrypoint.
+export * from "operon-agents-core";
+export * as llm from "operon-agents-core/llm";
+export * as mcp from "operon-agents-core/mcp";
+export * as protocol from "operon-agents-core/protocol";
+export * as tools from "operon-agents-core/tools";
+export * as tracing from "operon-agents-core/tracing";
+//# sourceMappingURL=index.js.map

package/dist/internal.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `operon-agents/internal` — low-level engine plumbing (re-exports `operon-agents-core/internal`).
+ *
+ * NOT part of the stable public API. The turn/step loop, retry, tool scheduling,
+ * store blob/migration/index machinery, capability assembly, and file-op / shell-rule helpers.
+ * No stability guarantees — prefer the main `operon-agents` surface.
+ */
+export * from "operon-agents-core/internal";
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.js

@@ -0,0 +1,9 @@
+/**
+ * `operon-agents/internal` — low-level engine plumbing (re-exports `operon-agents-core/internal`).
+ *
+ * NOT part of the stable public API. The turn/step loop, retry, tool scheduling,
+ * store blob/migration/index machinery, capability assembly, and file-op / shell-rule helpers.
+ * No stability guarantees — prefer the main `operon-agents` surface.
+ */
+export * from "operon-agents-core/internal";
+//# sourceMappingURL=internal.js.map

package/dist/llm.d.ts

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/llm";
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.js

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/llm";
+//# sourceMappingURL=llm.js.map

package/dist/local.d.ts

@@ -0,0 +1,24 @@
+import { type HookDef, type McpServerConfig, type PluginManager } from "operon-agents-core";
+import { type CreateSessionOptions, type Harness, type HarnessOptions, type HarnessSession } from "./harness.ts";
+export interface LocalDeploymentOptions<TContext = unknown> extends HarnessOptions<TContext> {
+    /**
+     * App home root — sessions (`<homeDir>/sessions`), MCP creds, logs, and disk-discovered agent
+     * profiles all live under it. Defaults to `~/.agents`. (`homeDir` is a local-deployment concept;
+     * the harness itself only knows `repository`.)
+     */
+    readonly homeDir?: string;
+    /** Workspace MCP servers to expose. */
+    readonly mcpServers?: Record<string, McpServerConfig>;
+    /** Installed-plugin manager, if any. */
+    readonly pluginManager?: PluginManager;
+    /** Shell hooks from config (`config.hooks`), projected as HookDefs. */
+    readonly hooks?: readonly HookDef[];
+    /** Discover agent profiles from disk (`<homeDir>/agents` + `<cwd>/.agents/agents`). Default true. */
+    readonly loadDiskProfiles?: boolean;
+}
+/** Build `HarnessOptions` wired for a local, single-machine deployment. */
+export declare function localHarnessOptions<TContext>(options: LocalDeploymentOptions<TContext>): Promise<HarnessOptions<TContext>>;
+export declare function createLocalHarness<TContext = unknown>(options: LocalDeploymentOptions<TContext>): Promise<Harness<TContext>>;
+/** Convenience: a local harness with one session opened and ready to `prompt()`. */
+export declare function createLocalSession<TContext = unknown>(options: LocalDeploymentOptions<TContext>, session?: CreateSessionOptions<TContext>): Promise<HarnessSession<TContext>>;
+//# sourceMappingURL=local.d.ts.map

package/dist/local.js

@@ -0,0 +1,58 @@
+/**
+ * The local composition root — every convention a single-machine, single-operator app runs on,
+ * bundled in one place: disk sessions under `<homeDir>/sessions`, the local machine, a rotating
+ * file log, file-backed MCP credentials, disk-discovered agent profiles, and the cron extension.
+ *
+ * There is deliberately no server counterpart. A hosted deployment injects its own repository,
+ * machine, logger and credential store, and those choices belong to the host — a preset that
+ * bundled them saved three lines while forcing one `McpOAuthService` (and therefore one
+ * credential store, which has no tenant dimension) to be shared across every session in the
+ * process. Servers call `createHarness` directly; see `examples/managed-agents`.
+ *
+ * There is still no "mode" inside the engine (Architecture Invariant 7): this file only picks
+ * backends, and returns a plain `Harness` nothing downstream can distinguish.
+ */
+import { homedir } from "node:os";
+import { cronExtension } from "./cron/index.js";
+import { join } from "node:path";
+import { DiskSessionRepository, McpOAuthService, RotatingFileSink, loadAgentProfiles, resolveGlobalLogPath, sinkLogger, } from "operon-agents-core";
+import { createHarness, defaultCapabilities, } from "./harness.js";
+/** Build `HarnessOptions` wired for a local, single-machine deployment. */
+export async function localHarnessOptions(options) {
+    const homeDir = options.homeDir ?? join(homedir(), ".agents");
+    // MCP OAuth credentials on local disk (0600) — the local default backend (`<homeDir>/credentials/mcp`).
+    const oauthService = new McpOAuthService({ homeDir });
+    // Diagnostics roll on disk under <homeDir>/logs.
+    const logger = options.logger ?? sinkLogger(new RotatingFileSink({ path: resolveGlobalLogPath({ homeDir }) }));
+    // Agent profiles come from disk here; the server preset supplies them externally instead.
+    const extraSubagentProfiles = options.extraSubagentProfiles ??
+        ((options.loadDiskProfiles ?? true)
+            ? await loadAgentProfiles({ homeDir, cwd: options.workDir ?? process.cwd() })
+            : undefined);
+    return {
+        ...options,
+        // Disk sessions under <homeDir>/sessions; an injected repository still wins. The machine defaults to local.
+        repository: options.repository ?? new DiskSessionRepository(homeDir),
+        logger,
+        ...(extraSubagentProfiles !== undefined ? { extraSubagentProfiles } : {}),
+        capabilities: options.capabilities ??
+            (() => defaultCapabilities({
+                ...(options.maxContextTokens !== undefined ? { maxContextTokens: options.maxContextTokens } : {}),
+                ...(options.mcpServers !== undefined ? { mcpServers: options.mcpServers } : {}),
+                ...(options.pluginManager !== undefined ? { pluginManager: options.pluginManager } : {}),
+                ...(options.hooks !== undefined ? { hooks: options.hooks } : {}),
+                oauthService,
+            })),
+        // Cron rides the extension channel now: LOCAL deployments attach it, the server profile
+        // simply doesn't — Invariant 7 ("cron is local-only") is structural, not an option to pass.
+        extensions: [cronExtension(), ...(options.extensions ?? [])],
+    };
+}
+export async function createLocalHarness(options) {
+    return createHarness(await localHarnessOptions(options));
+}
+/** Convenience: a local harness with one session opened and ready to `prompt()`. */
+export async function createLocalSession(options, session = {}) {
+    return (await createLocalHarness(options)).createSession(session);
+}
+//# sourceMappingURL=local.js.map

package/dist/mcp.d.ts

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/mcp";
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.js

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/mcp";
+//# sourceMappingURL=mcp.js.map

package/dist/protocol.d.ts

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/protocol";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/protocol";
+//# sourceMappingURL=protocol.js.map

package/dist/tools.d.ts

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/tools";
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.js

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/tools";
+//# sourceMappingURL=tools.js.map

package/dist/tracing.d.ts

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/tracing";
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.js

@@ -0,0 +1,2 @@
+export * from "operon-agents-core/tracing";
+//# sourceMappingURL=tracing.js.map

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "operon-agents",
+  "version": "0.1.0-alpha.0",
+  "description": "Public SDK entrypoint for building agents.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nickqiaoo/operon-agents.git",
+    "directory": "packages/agents"
+  },
+  "homepage": "https://github.com/nickqiaoo/operon-agents/tree/main/packages/agents#readme",
+  "bugs": {
+    "url": "https://github.com/nickqiaoo/operon-agents/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "operon-app-server": "./dist/app-server/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./app-server": {
+      "types": "./dist/app-server/index.d.ts",
+      "import": "./dist/app-server/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
+    },
+    "./llm": {
+      "types": "./dist/llm.d.ts",
+      "import": "./dist/llm.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp.d.ts",
+      "import": "./dist/mcp.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js"
+    },
+    "./tracing": {
+      "types": "./dist/tracing.d.ts",
+      "import": "./dist/tracing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "operon-agents-core": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "0.84.1"
+  },
+  "scripts": {
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "build": "pnpm --filter operon-agents-core build && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "for f in test/e2e*.ts; do echo \"\\n▶ $f\"; node --experimental-strip-types --no-warnings \"$f\" || exit 1; done"
+  }
+}