operon-agents 0.1.0-alpha.28 → 0.1.0-alpha.29

package/dist/harness.d.ts

@@ -7,9 +7,9 @@
  * control plane (goals, plan mode, compaction, skills, plugins, …) delegated to
  * the core `Session`.
  *
- * It is a pure composition of core primitives — no new engine behavior. For the
- * low-level "assemble it yourself / stateless server" path, import from
- * `operon-agents/core` instead.
+ * It is a pure composition of core primitives — no new engine behavior. The low-level
+ * primitives for the "assemble it yourself / stateless server" path are exported from
+ * `operon-agents` too.
  */
 import { type EventPublicationMode, type TelemetryService, type AgentEventListener, type AgentInput, SessionProjection, type SessionSnapshot, type SnapshotOptions, type DirectoryEntry, type ProjectionObservation, type ProjectionListener, type ApprovalRequest, type ApprovalResponse, type Capability, type InterruptAnswer, type ChatModel, ListenerSink, type PermissionManagerOptions, type PermissionMode, type PendingRunInterrupt, type QuestionRequest, type QuestionResult, type Responder, type RunHandle, type RunResult, type SessionHandle, type SessionSummary, type ListSessionsFilter, type OpenSessionOptions, type DeleteSessionOptions, type ThinkingLevel, type Tool, type SteerMessage, type SteerOptions, type SteerOrigin, type SteerReceipt, Agent, Runner, Session, McpOAuthService, SkillRegistry, type HookDef, type McpServerConfig, type McpTransportKind, type McpCredentialProvider, type PluginManager, type ApprovalRequestOptions, type Environment, type EnvironmentFactory, type SessionRepository, type ResolvedAgentProfile, type SubagentProvider } from "operon-agents-core";
 import type { SkillsService, CompactionService, BackgroundManager, McpServersHandle, GoalStore, PlanMode, Logger, ModelRuntime, TracingProcessor } from "operon-agents-core";

package/dist/harness.js

@@ -7,9 +7,9 @@
  * control plane (goals, plan mode, compaction, skills, plugins, …) delegated to
  * the core `Session`.
  *
- * It is a pure composition of core primitives — no new engine behavior. For the
- * low-level "assemble it yourself / stateless server" path, import from
- * `operon-agents/core` instead.
+ * It is a pure composition of core primitives — no new engine behavior. The low-level
+ * primitives for the "assemble it yourself / stateless server" path are exported from
+ * `operon-agents` too.
  */
 import { readSessionTails, SessionProjection, ListenerSink, recoverOrphanedTurns, Agent, buildAgentFromProfile, INTERRUPTION_STATE_KEY, flattenPendingInterrupts, parseInterruptionState, Runner, Session, emptyUsage, isGuardrailTripwireError, askUserQuestionTool, backgroundCapability, compactionCapability, filesystemTools, goalCapability, LocalEnvironment, McpOAuthService, MemorySessionRepository, SessionRepositoryNotFoundError, planCapability, skillsCapability, SkillRegistry, mcpServersCapability, pluginsCapability, userHooksCapability, taskCapability, workflowCapability, DEFAULT_AGENT_PROFILES, DEFAULT_AGENT_PROFILE_NAME, DEFAULT_SUBAGENT_NAMES, profileSubagentProvider, DEFAULT_ADDRESS, envLogger, noopLogger, } from "operon-agents-core";
 import { mkdirSync } from "node:fs";

package/dist/index.d.ts

@@ -9,7 +9,8 @@
  * 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`.
+ * This is the only entry point for applications. `operon-agents-core` is for the framework's own
+ * packages, and everything its root exports is public here.
  */
 export * from "./harness.ts";
 export * from "./extensions/index.ts";

package/dist/index.js

@@ -9,7 +9,8 @@
  * 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`.
+ * This is the only entry point for applications. `operon-agents-core` is for the framework's own
+ * packages, and everything its root exports is public here.
  */
 export * from "./harness.js";
 // Extensions are a harness concept: they need the session/provider reach only this layer has.
@@ -22,8 +23,7 @@ export * from "./providers.js";
 export * from "./local.js";
 // Per-directory MCP sharing for hosts that open many sessions in one folder (a desktop app).
 export * from "./workspace-mcp.js";
-// The curated core engine, re-exported for convenience; `operon-agents/core` is the dedicated
-// primitives entrypoint.
+// The curated core engine, including the low-level primitives for assembling an agent by hand.
 export * from "operon-agents-core";
 export * as llm from "operon-agents-core/llm";
 export * as mcp from "operon-agents-core/mcp";

package/dist/providers.d.ts

@@ -35,7 +35,8 @@
  * ```
  */
 import { z } from "zod";
-import { type Api, type ModelRuntime } from "operon-agents-core";
+import { DecisionModel, type Api, type ChatModel, type Model, type ModelRuntime } from "operon-agents-core";
+import type { Provider } from "@earendil-works/pi-ai";
 /** The wire dialects a configured endpoint can speak. Almost everything speaks the first. */
 export declare const PROVIDER_APIS: readonly ["openai-completions", "openai-responses", "anthropic-messages"];
 export type ProviderApi = (typeof PROVIDER_APIS)[number];
@@ -119,7 +120,34 @@ export declare function parseModelsResponse(body: unknown): readonly string[];
  * Turn one config entry into a provider the engine can stream through. Its model list starts at
  * whatever the config declared and is replaced by the endpoint's on the first refresh.
  */
-export declare function providerFromConfig(providerId: string, entry: ProviderEntry): import("@earendil-works/pi-ai").Provider<Api>;
+export declare function providerFromConfig(providerId: string, entry: ProviderEntry): Provider<Api>;
+/**
+ * One model, named by a host that already knows which it wants.
+ *
+ * The picked fields are pi's own. `baseUrl` is used exactly as given; without it, pi's catalog says
+ * where each model lives. The others describe a model the catalog lacks: a catalogued one keeps its own.
+ */
+export interface ChatModelConfig extends Readonly<Partial<Pick<Model<Api>, "baseUrl" | "contextWindow" | "maxTokens" | "input" | "reasoning">>> {
+    /** pi's provider id to use its catalog; any other name needs `api` and `baseUrl`. */
+    readonly provider: string;
+    readonly model: string;
+    readonly apiKey?: string;
+    /** Marks a custom endpoint, built with `createProvider`. Only the dialects it can load. */
+    readonly api?: ProviderApi;
+}
+/** Build the `ChatModel` a host picked: from pi's catalog, or from `api` and `baseUrl` for a custom endpoint. */
+export declare function resolveChatModel(config: ChatModelConfig): ChatModel;
+export interface DecisionModelConfig {
+    /** pi's provider id: decision models only exist in its catalog. */
+    readonly provider: string;
+    readonly model: string;
+    readonly apiKey: string;
+}
+/**
+ * The decision model a config names, or undefined when it is an LLM. An id catalogued as both
+ * (OpenAI's `gpt-6-luna`) counts as an LLM, and an id the catalog doesn't know can only be one.
+ */
+export declare function resolveDecisionModel(config: DecisionModelConfig): Promise<DecisionModel | undefined>;
 export interface ModelRuntimeFromConfigOptions {
     readonly homeDir: string;
     /**

package/dist/providers.js

@@ -38,7 +38,7 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { parse as parseToml } from "smol-toml";
 import { z } from "zod";
-import { createModelRuntime, createProvider, lazyApi, } from "operon-agents-core";
+import { DecisionModel, createModelRuntime, createProvider, defineModel, lazyApi, } from "operon-agents-core";
 /** The wire dialects a configured endpoint can speak. Almost everything speaks the first. */
 export const PROVIDER_APIS = ["openai-completions", "openai-responses", "anthropic-messages"];
 const ModelOverrideSchema = z.object({
@@ -226,6 +226,74 @@ function dialectStreams(api) {
             return lazyApi(() => import("@earendil-works/pi-ai/api/openai-completions"));
     }
 }
+/** An id newer than a catalog provider's list runs on the API of that provider's default endpoint. */
+function modelNewerThanCatalog(provider, config) {
+    const models = provider.getModels();
+    const template = models.find((model) => model.baseUrl === provider.baseUrl) ?? models[0];
+    if (template === undefined)
+        throw new Error(`Provider "${provider.id}" lists no models to run "${config.model}" like.`);
+    return {
+        id: config.model,
+        name: config.model,
+        api: template.api,
+        provider: provider.id,
+        baseUrl: template.baseUrl,
+        reasoning: config.reasoning ?? false,
+        input: [...(config.input ?? ["text"])],
+        cost: NO_COST,
+        contextWindow: config.contextWindow ?? 128_000,
+        maxTokens: config.maxTokens ?? 8_192,
+    };
+}
+function catalogChatModel(config) {
+    const runtime = createModelRuntime();
+    const provider = runtime.models.getProvider(config.provider);
+    if (provider === undefined) {
+        throw new Error(`Provider "${config.provider}" is not in pi's catalog. Set \`api\` and \`baseUrl\` for a custom endpoint.`);
+    }
+    const descriptor = runtime.models.getModel(config.provider, config.model) ?? modelNewerThanCatalog(provider, config);
+    return defineModel({
+        runtime,
+        descriptor: config.baseUrl === undefined ? descriptor : { ...descriptor, baseUrl: config.baseUrl },
+        ...(config.apiKey !== undefined ? { apiKey: config.apiKey } : {}),
+    });
+}
+function customChatModel(config, api) {
+    if (config.baseUrl === undefined)
+        throw new Error(`Custom provider "${config.provider}" needs a \`baseUrl\`.`);
+    const entry = ProviderEntrySchema.parse({
+        base_url: config.baseUrl,
+        api,
+        api_key: config.apiKey,
+        fetch_models: false,
+        context_window: config.contextWindow,
+        max_output_tokens: config.maxTokens,
+        reasoning: config.reasoning,
+        vision: config.input?.includes("image"),
+        models: { [config.model]: {} },
+    });
+    const runtime = createModelRuntime({ builtins: false });
+    runtime.models.setProvider(providerFromConfig(config.provider, entry));
+    return defineModel({ runtime, descriptor: modelFrom(config.provider, entry, config.model) });
+}
+/** Build the `ChatModel` a host picked: from pi's catalog, or from `api` and `baseUrl` for a custom endpoint. */
+export function resolveChatModel(config) {
+    return config.api === undefined ? catalogChatModel(config) : customChatModel(config, config.api);
+}
+/**
+ * The decision model a config names, or undefined when it is an LLM. An id catalogued as both
+ * (OpenAI's `gpt-6-luna`) counts as an LLM, and an id the catalog doesn't know can only be one.
+ */
+export async function resolveDecisionModel(config) {
+    const runtime = createModelRuntime();
+    if (runtime.models.getModel(config.provider, config.model) !== undefined)
+        return undefined;
+    const descriptor = runtime.models.getModelOfType("classifier", config.provider, config.model);
+    if (descriptor === undefined)
+        return undefined;
+    await runtime.credentials.modify(config.provider, async () => ({ type: "api_key", key: config.apiKey }));
+    return new DecisionModel({ runtime, descriptor });
+}
 /**
  * One model runtime carrying the engine's built-in providers plus everything in
  * `<homeDir>/providers.toml`, with each configured endpoint asked what it serves.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "operon-agents",
-  "version": "0.1.0-alpha.28",
+  "version": "0.1.0-alpha.29",
   "description": "Public SDK entrypoint for building agents.",
   "type": "module",
   "engines": {
@@ -30,10 +30,6 @@
       "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"
@@ -74,7 +70,7 @@
     "zod": "^4.4.3",
     "smol-toml": "^1.6.1",
     "@earendil-works/pi-ai": "1.5.0",
-    "operon-agents-core": "0.1.0-alpha.28"
+    "operon-agents-core": "0.1.0-alpha.29"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": "1.5.0"

package/dist/core.d.ts

@@ -1,12 +0,0 @@
-/**
- * Mode 1 — low-level primitives (the engine, assemble-it-yourself).
- *
- * `import { Runner, defineAgent, defineModel } from 'operon-agents/core'`
- *
- * Everything the core engine exposes: Runner / Session / Agent / capabilities /
- * environments / tools. Pass no environment and omit file tools to run a stateless,
- * no-filesystem agent (a `NullEnvironment` refuses any stray I/O). For the
- * batteries-included facade, import from `operon-agents` instead.
- */
-export * from "operon-agents-core";
-//# sourceMappingURL=core.d.ts.map

package/dist/core.js

@@ -1,12 +0,0 @@
-/**
- * Mode 1 — low-level primitives (the engine, assemble-it-yourself).
- *
- * `import { Runner, defineAgent, defineModel } from 'operon-agents/core'`
- *
- * Everything the core engine exposes: Runner / Session / Agent / capabilities /
- * environments / tools. Pass no environment and omit file tools to run a stateless,
- * no-filesystem agent (a `NullEnvironment` refuses any stray I/O). For the
- * batteries-included facade, import from `operon-agents` instead.
- */
-export * from "operon-agents-core";
-//# sourceMappingURL=core.js.map