@lumifai/harness 0.2.0 → 0.3.0

package/README.md

@@ -12,6 +12,13 @@ durable lifecycle, reconnect, and transport behavior.
 4. **Server** — `@lumifai/harness-server`, `@lumifai/harness-server-fastify`, `@lumifai/harness-server-nest`
 5. **Client / React** — `@lumifai/harness-client`, `@lumifai/harness-react`, `@lumifai/harness-react-mantine`
 
+Mastra is a **peer dependency** (`@mastra/core` `^1.73`, plus `@mastra/memory` and `@mastra/libsql`
+for the server package). Install it in your app so there is one copy of Mastra. Publish and upgrade
+all `@lumifai/harness*` packages together.
+
+For local development against a checkout, use `pnpm link` (or a local `pnpm.overrides` entry that
+you do not commit); do not commit `link:` paths, they break Docker builds.
+
 ## Usage
 
 ```typescript
@@ -284,6 +291,7 @@ and `resumeToolSuspension(data, toolCallId)`.
 
 Import configurable presets from `@lumifai/harness-presets`:
 
+- `createPresetProfiles()` — the preset modes as profiles (the model stays selectable); `createPresetHostOptions()` — profiles plus baseline tools, subagents and displaced built-ins, ready for `createAgentHostConfig`
 - `createPresetModes()` — `plan` and `build` modes
 - `createPresetCustomModes()` — returns the built-in modes plus your custom list when you need the final array yourself
 - `createPresetSubagents()` — `explore` subagent; opt-in `websearch` subagent via `includeWebSearch: true`
@@ -292,6 +300,158 @@ Import configurable presets from `@lumifai/harness-presets`:
 - `createPresetHarnessConfig()` — combines the above and merges enabled pack skill paths
 - `createPresetPermissionConfig()` — default category resolver and merged `permissionRules` for harness init
 
+## Profiles (your own modes)
+
+Every Lumif app runs through one assembly, `createAgentHostConfig` in `@lumifai/harness`: a list
+of **profiles** in, controller config out. A profile is a Mastra controller mode (instructions,
+`availableTools`, `transitionsTo`, metadata) plus the agent-level settings that follow the mode:
+model, processors, scorers and run options. The presets are just a ready-made set of profiles
+(`createPresetProfiles()` in `@lumifai/harness-presets`); you can use them, extend them, or declare
+your own.
+
+On the server boot config, setting `profiles` replaces the presets (no plan/build modes, preset
+subagents, `ask_user`, `submit_plan` or `request_access`):
+
+```typescript
+createHarnessSessionManager({
+  bootConfig: {
+    systemContext: 'Shared context for every profile',
+    providerOptions: { openai: { reasoningEffort: 'high' } },
+    yolo: true, // tool calls run without approval; the default is to require it
+    profiles: [
+      {
+        id: 'concierge',
+        instructions: '...',
+        model: 'openai/gpt-6-luna',
+        availableTools: ['get_context', 'ask'], // final tool names, workspace tools included
+      },
+      {
+        id: 'matter',
+        instructions: '...',
+        model: 'openai/gpt-6-luna',
+        availableTools: ['get_context', 'propose_action'],
+        inputProcessors: [promptInjectionDetector],
+        outputProcessors: [],
+        scorers: {},
+        eagerToolExecution: false, // Mastra 1.71+ starts tools as soon as their call streams
+      },
+    ],
+    extraTools, // static tools, plus `toolPacks` as usual
+    // Per request: gate tools on the conversation or add per-user connectors.
+    toolsResolver: ({ requestContext }) => connectorsFor(requestContext.get('userId')),
+    hooks: { onRunStart, onToolCall, onApprovalRequired, onRunEnd }, // fired for every run
+  },
+});
+```
+
+All profiles run on one shared Mastra `Agent`. Its model, processors, scorers and options are
+resolved from the active mode on every request, so there is no per-mode agent (deprecated in
+Mastra).
+
+- **Model.** Pinned to the profile's `model` by default, so deploying a new model reaches existing
+  threads. Set `modelSelectable: true` to let the session's model (`switchModel`, and what a thread
+  last used) win; the presets do this. A profile with no `model` uses the host's `defaultModel`.
+- **Model fallback.** `model` and `defaultModel` take whatever a Mastra `Agent`'s `model` takes,
+  including an ordered `ModelWithRetries[]`: when an entry fails after its `maxRetries`, the next
+  one runs. The presets accept the same on `planModel` / `buildModel` (boot config and config
+  patches validate the JSON-serializable subset, at least one entry), e.g.
+  `[{ model: 'openai/gpt-6', maxRetries: 1 }, { model: 'anthropic/claude-sonnet-4-6' }]`. The list
+  reaches the Agent unchanged. An entry with `enabled: false` is skipped for display only: mode
+  summaries, the session model id, and the explore subagent use the first entry that is not
+  disabled. Explore gets that id and does not run the list. That mode's `modelSelectable` is
+  false (`listModeSummaries`, and `metadata.modelSelectable` on the controller mode) so a picker
+  can disable itself. `switchModel` rejects the mode with `HarnessClientError` (HTTP 400) and
+  leaves the list as configured. Session and request patches accept this same shape, including
+  `headers`, `providerOptions`, `modelSettings`, and `maxRetries`. Those values go out on
+  provider calls made with the server's credentials, and call headers override the provider's.
+  Authorize who can `updateConfig`; the harness does not narrow the patch.
+- **Approval.** Tool calls require approval unless `yolo: true`. Permission rules and the tool
+  category resolver apply to profiles exactly as they do to the presets.
+- **Built-in tools.** Mastra's built-ins (`ask_user`, `submit_plan`, `task_*`, `subagent`) are
+  removed unless you list others in `disableBuiltinTools`.
+- **Preset-only options** (`customModes`, `subagents`, `includeRequestAccess: true`, `planModel`,
+  `buildModel`, `planInstructions`, `buildInstructions`, `modeOverrides`) are rejected when
+  `profiles` is set, rather than silently ignored. The same goes for session and request config
+  patches that set `planModel`, `buildModel`, `planInstructions`, `buildInstructions` or
+  `modeOverrides`. `includeRequestAccess: false` is accepted, since that is what profiles do.
+  A session stored before the switch may still have those keys: restoring it drops them and
+  logs a warning, so the session can load and be destroyed. A new patch that sets them is
+  still rejected.
+
+Stored sessions keep their persisted mode id, so rename profiles with care.
+
+### Headless runs
+
+```typescript
+const outcome = await manager.run(
+  sessionId,
+  {
+    modeId: 'matter',
+    message,
+    requestContext: { matterId },
+    signal, // optional AbortSignal
+    timeoutMs: 120_000,
+  },
+  context,
+);
+// { mastraRunId, finishReason, usage, toolCalls, error, aborted, timedOut, pendingApprovals? }
+```
+
+`run` creates the session on first use and rejects with `HarnessRunBusyError` while a run is in
+progress. Aborting ends the run but does not stop a tool already executing unless that tool honours
+its abort signal, so do not treat run end as tool end.
+
+Unless the host sets `yolo`, a tool call that needs approval parks the run. `run` then resolves
+early with `finishReason: 'awaiting_approval'` and `pendingApprovals` (`toolCallId`, `toolName`,
+`args`) instead of hanging. The run is still open: answer each call with
+`manager.respondToToolApproval(sessionId, { toolCallId, approved }, context)` and the run continues
+on its own, or abort it. `timeoutMs` and `signal` stop applying once `run` has returned, and
+`run` rejects with `HarnessRunBusyError` until the approval is decided. A later approval in that
+same run fires `hooks.onApprovalRequired` again (`toolCallId`, `toolName`, `args`), including
+after `run` has returned. `onRunEnd` still reports how the run finished. Subscribing to session
+events or polling `getSnapshot()` shows the same pending call.
+
+### Mid-run input (experimental)
+
+```typescript
+await manager.signal(sessionId, { whenActive: 'deliver', content }, context);
+```
+
+- `deliver`: inject into the active run without aborting it; the next model step sees it and the
+  run id is unchanged. A running tool is not interrupted. Returns `{ delivered: false, action:
+'idle' }` when no run is active. Uses Mastra's `sendSignal`, which Mastra marks experimental; if
+  it is missing, it falls back to a steer.
+- `queue`: hold for the next run. On an idle session it starts a run immediately.
+- `abort`: abort the active run; with `content` it is also sent as the next input (a steer).
+  Without `content` on an idle session it returns `{ delivered: false, action: 'idle' }`.
+
+`signal` resolves once the input is accepted, not when the run it starts or steers finishes;
+failures of that run are logged.
+
+`agent-host.integration.test.ts` pins this behaviour against a real controller, so a Mastra upgrade
+that changes it fails there.
+
+### Thread lock
+
+```typescript
+import { Pool } from 'pg';
+import { createPostgresThreadLock } from '@lumifai/harness-server';
+
+// max must cover maxInMemorySessions (default 100) plus headroom for the app's own queries.
+const pool = new Pool({ max: 120, connectionTimeoutMillis: 5_000 });
+bootConfig.threadLock = createPostgresThreadLock({ pool });
+```
+
+One session in any process holds a thread at a time; `acquire` throws `ThreadLockedError` rather
+than waiting (set `waitTimeoutMs` to retry). Advisory locks belong to a connection, so each held
+thread occupies one pooled connection for the session's life; size the pool for it, and set
+`connectionTimeoutMillis`: `pg` otherwise waits on `pool.connect()` indefinitely once the pool is
+exhausted, which stalls session creation instead of failing it. Session-level advisory locks need a
+direct or session-mode connection; behind PgBouncer or Supabase transaction pooling they do not
+hold. A crashed process frees its locks, and so does a dropped connection, even though the session
+still believes it holds the thread. The harness holds a thread until the session is disposed, so a second
+device is refused until then.
+
 ## Tool packs
 
 Import opt-in capability bundles from `@lumifai/harness-tool-pack-*` packages. Shared types and merge helpers live in `@lumifai/harness-tool-packs`:

package/dist/agent-host.d.ts

@@ -0,0 +1,81 @@
+import { type AgentExecutionOptions, type ModelWithRetries, type ToolsInput } from '@mastra/core/agent';
+import type { AgentControllerConfig, AgentControllerMode, AgentControllerSubagent, BuiltinToolId, PermissionRules, ToolCategory } from '@mastra/core/agent-controller';
+import type { MastraScorers } from '@mastra/core/evals';
+import type { MastraModelConfig } from '@mastra/core/llm';
+import type { ErrorProcessorOrWorkflow, InputProcessorOrWorkflow, OutputProcessorOrWorkflow } from '@mastra/core/processors';
+import type { RequestContext } from '@mastra/core/request-context';
+/**
+ * One mode of an agent host. It is a Mastra controller mode (instructions, tool
+ * allow-list, `transitionsTo`, metadata...) plus the agent-level settings that follow the
+ * mode: model, processors, scorers and run options.
+ *
+ * All profiles run on one shared Mastra `Agent` whose model, processors, scorers and
+ * options are resolved from the active mode on every request, so a mode switch changes
+ * them without a second agent (`AgentControllerMode.agent` is deprecated in Mastra).
+ */
+export type AgentHostProfile = Omit<AgentControllerMode, 'agent' | 'default' | 'defaultModelId'> & {
+    /**
+     * Model for this profile. Falls back to the host's `defaultModel`. Pinned unless
+     * `modelSelectable` is set. Takes whatever a Mastra `Agent`'s `model` takes, including an
+     * ordered `ModelWithRetries[]` that falls back to the next entry when one fails its retries.
+     */
+    model?: MastraModelConfig | ModelWithRetries[];
+    /**
+     * Let the session's model (`switchModel`, and what a thread last used) win over `model`.
+     * Only applies to model ids (strings); a fallback list stays as configured. Off by default
+     * so deploying a new model reaches existing threads.
+     */
+    modelSelectable?: boolean;
+    /** Merged over the host-wide `providerOptions` for this profile's runs. */
+    providerOptions?: NonNullable<AgentExecutionOptions['providerOptions']>;
+    inputProcessors?: InputProcessorOrWorkflow[];
+    outputProcessors?: OutputProcessorOrWorkflow[];
+    errorProcessors?: ErrorProcessorOrWorkflow[];
+    scorers?: MastraScorers;
+    /**
+     * Start a tool as soon as its call has streamed. Left to Mastra's default (on since 1.71)
+     * unless set; turn it off if tool ordering or budget counting matters.
+     */
+    eagerToolExecution?: boolean;
+    /** The mode a session starts in. Defaults to the first profile flagged default, else the first. */
+    default?: boolean;
+};
+export type AgentHostToolsResolver = (input: {
+    requestContext: RequestContext;
+}) => ToolsInput | undefined | Promise<ToolsInput | undefined>;
+export type AgentHostOptions = {
+    profiles: AgentHostProfile[];
+    /** Model for profiles that declare none. */
+    defaultModel?: MastraModelConfig | ModelWithRetries[];
+    /** Host-wide context layered above every profile's instructions. */
+    systemContext?: string;
+    /** Tools registered once, before any request. */
+    tools?: ToolsInput;
+    /** Tools resolved per request (for example per-user connectors); merged over `tools`. */
+    toolsResolver?: AgentHostToolsResolver;
+    subagents?: AgentControllerSubagent[];
+    providerOptions?: AgentExecutionOptions['providerOptions'];
+    /** Mastra's built-in tools to remove. Defaults to all of them. */
+    disableBuiltinTools?: BuiltinToolId[];
+    permissionRules?: PermissionRules;
+    toolCategoryResolver?: (toolName: string) => ToolCategory | null;
+    /** Tool calls wait for approval unless this is false. Defaults to true. */
+    requireToolApproval?: boolean;
+};
+export type AgentHostConfig<TState = {}> = Pick<AgentControllerConfig<TState>, 'agent' | 'instructions' | 'defaultModeId' | 'modes' | 'tools' | 'subagents' | 'disableBuiltinTools' | 'initialState' | 'toolCategoryResolver'>;
+export declare const ALL_BUILTIN_TOOLS: BuiltinToolId[];
+export declare const AGENT_HOST_AGENT_ID = "lumif-harness-agent";
+/**
+ * Model id used for display, mode summaries, and the explore subagent.
+ * A fallback list contributes its first entry that is not `enabled: false`.
+ * The list passed to the agent is unchanged, and explore does not receive the list.
+ */
+export declare function firstModelId(model: string | ModelWithRetries[] | undefined): string | undefined;
+/** The controller modes for a set of profiles. */
+export declare function profilesToModes(profiles: AgentHostProfile[], defaultModel?: AgentHostProfile['model']): AgentControllerMode[];
+/**
+ * Assemble the controller config for a set of profiles: one shared agent, one mode per
+ * profile, tools, permissions and approval defaults. This is the only place a Lumif app's
+ * modes become controller config; presets and hand-written profiles both go through it.
+ */
+export declare function createAgentHostConfig<TState = {}>(options: AgentHostOptions): AgentHostConfig<TState>;

package/dist/agent-host.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_HOST_AGENT_ID = exports.ALL_BUILTIN_TOOLS = void 0;
+exports.firstModelId = firstModelId;
+exports.profilesToModes = profilesToModes;
+exports.createAgentHostConfig = createAgentHostConfig;
+const agent_1 = require("@mastra/core/agent");
+exports.ALL_BUILTIN_TOOLS = [
+    'ask_user',
+    'submit_plan',
+    'task_write',
+    'task_update',
+    'task_complete',
+    'task_check',
+    'subagent',
+];
+exports.AGENT_HOST_AGENT_ID = 'lumif-harness-agent';
+function isDefaultProfile(profile) {
+    return profile.default === true || profile.metadata?.default === true;
+}
+function pickDefaultProfile(profiles) {
+    return profiles.find(isDefaultProfile) ?? profiles[0];
+}
+/**
+ * Model id used for display, mode summaries, and the explore subagent.
+ * A fallback list contributes its first entry that is not `enabled: false`.
+ * The list passed to the agent is unchanged, and explore does not receive the list.
+ */
+function firstModelId(model) {
+    if (typeof model === 'string')
+        return model;
+    if (!Array.isArray(model))
+        return undefined;
+    for (const entry of model) {
+        if (!entry || entry.enabled === false)
+            continue;
+        if (typeof entry.model === 'string')
+            return entry.model;
+    }
+    return undefined;
+}
+function assertValidProfiles(profiles, defaultModel) {
+    if (profiles.length === 0) {
+        throw new Error('An agent host needs at least one profile.');
+    }
+    const seen = new Set();
+    for (const profile of profiles) {
+        if (!profile.id)
+            throw new Error('Agent host profile ids must be non-empty.');
+        if (seen.has(profile.id)) {
+            throw new Error(`Duplicate agent host profile id "${profile.id}". Profile ids must be unique.`);
+        }
+        seen.add(profile.id);
+        if (profile.model === undefined && defaultModel === undefined) {
+            throw new Error(`Agent host profile "${profile.id}" has no model and the host has no defaultModel.`);
+        }
+    }
+}
+/** The active mode, as the controller exposes it on every request context. */
+function controllerSession(requestContext) {
+    const controller = requestContext?.get('controller');
+    return controller?.session;
+}
+/** The controller modes for a set of profiles. */
+function profilesToModes(profiles, defaultModel) {
+    const fallback = pickDefaultProfile(profiles);
+    return profiles.map((profile) => {
+        const { model, modelSelectable: _modelSelectable, providerOptions: _providerOptions, inputProcessors: _inputProcessors, outputProcessors: _outputProcessors, errorProcessors: _errorProcessors, scorers: _scorers, eagerToolExecution: _eagerToolExecution, default: _default, ...mode } = profile;
+        // The controller reads `defaultModelId` synchronously as the session's model id.
+        // A fallback list contributes its first enabled entry and is not selectable.
+        const effective = model ?? defaultModel;
+        const modelId = firstModelId(Array.isArray(effective) || typeof effective === 'string' ? effective : undefined);
+        const listBacked = Array.isArray(effective);
+        const metadata = {
+            ...mode.metadata,
+            ...(profile === fallback ? { default: true } : {}),
+            ...(listBacked ? { modelSelectable: false } : {}),
+        };
+        return {
+            ...mode,
+            ...(typeof modelId === 'string' ? { defaultModelId: modelId } : {}),
+            ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
+        };
+    });
+}
+/**
+ * Assemble the controller config for a set of profiles: one shared agent, one mode per
+ * profile, tools, permissions and approval defaults. This is the only place a Lumif app's
+ * modes become controller config; presets and hand-written profiles both go through it.
+ */
+function createAgentHostConfig(options) {
+    const { profiles, defaultModel } = options;
+    assertValidProfiles(profiles, defaultModel);
+    const byId = new Map(profiles.map((profile) => [profile.id, profile]));
+    const fallback = pickDefaultProfile(profiles);
+    const profileOf = (requestContext) => byId.get(controllerSession(requestContext)?.modeId ?? '') ?? fallback;
+    const agent = new agent_1.Agent({
+        id: exports.AGENT_HOST_AGENT_ID,
+        name: 'Lumif Harness Agent',
+        // Each mode's instructions are layered on by the controller.
+        instructions: '',
+        model: ({ requestContext }) => {
+            const profile = profileOf(requestContext);
+            const selected = controllerSession(requestContext)?.modelId;
+            if (profile.modelSelectable &&
+                selected &&
+                typeof (profile.model ?? defaultModel) === 'string') {
+                return selected;
+            }
+            return (profile.model ?? defaultModel);
+        },
+        inputProcessors: ({ requestContext }) => profileOf(requestContext).inputProcessors ?? [],
+        outputProcessors: ({ requestContext }) => profileOf(requestContext).outputProcessors ?? [],
+        errorProcessors: ({ requestContext }) => profileOf(requestContext).errorProcessors ?? [],
+        scorers: ({ requestContext }) => profileOf(requestContext).scorers ?? {},
+        defaultOptions: ({ requestContext }) => {
+            const profile = profileOf(requestContext);
+            const providerOptions = { ...options.providerOptions, ...profile.providerOptions };
+            return {
+                // The host owns suspension resumes; Mastra's auto-resume rewrites tool-call args.
+                autoResumeSuspendedTools: false,
+                ...(profile.eagerToolExecution === undefined
+                    ? {}
+                    : { eagerToolExecution: profile.eagerToolExecution }),
+                ...(Object.keys(providerOptions).length > 0 ? { providerOptions } : {}),
+            };
+        },
+    });
+    const staticTools = options.tools ?? {};
+    const { toolsResolver } = options;
+    return {
+        agent,
+        instructions: options.systemContext,
+        defaultModeId: fallback.id,
+        modes: profilesToModes(profiles, defaultModel),
+        tools: toolsResolver
+            ? async ({ requestContext }) => ({
+                ...staticTools,
+                ...(await toolsResolver({ requestContext })),
+            })
+            : staticTools,
+        subagents: options.subagents,
+        disableBuiltinTools: options.disableBuiltinTools ?? exports.ALL_BUILTIN_TOOLS,
+        toolCategoryResolver: options.toolCategoryResolver,
+        initialState: {
+            ...(options.permissionRules ? { permissionRules: options.permissionRules } : {}),
+            // Approval is the safe default; an app that vets its own tools opts out.
+            ...(options.requireToolApproval === false ? { yolo: true } : {}),
+        },
+    };
+}
+//# sourceMappingURL=agent-host.js.map

package/dist/agent-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.js","sourceRoot":"","sources":["../src/agent-host.ts"],"names":[],"mappings":";;;AA0HA,oCAQC;AAgCD,0CAoCC;AAOD,sDAqEC;AAlRD,8CAK4B;AA4Ff,QAAA,iBAAiB,GAAoB;IAChD,UAAU;IACV,aAAa;IACb,YAAY;IACZ,aAAa;IACb,eAAe;IACf,YAAY;IACZ,UAAU;CACX,CAAC;AAEW,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,SAAS,gBAAgB,CAAC,OAAyB;IACjD,OAAO,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA4B;IACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAA8C;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;YAAE,SAAS;QAChD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,QAA4B,EAAE,YAAqB;IAC9E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,oCAAoC,OAAO,CAAC,EAAE,gCAAgC,CAC/E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CACb,uBAAuB,OAAO,CAAC,EAAE,kDAAkD,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,iBAAiB,CAAC,cAA0C;IACnE,MAAM,UAAU,GAAG,cAAc,EAAE,GAAG,CAAC,YAAY,CAEtC,CAAC;IACd,OAAO,UAAU,EAAE,OAAO,CAAC;AAC7B,CAAC;AAED,kDAAkD;AAClD,SAAgB,eAAe,CAC7B,QAA4B,EAC5B,YAAwC;IAExC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAuB,EAAE;QACnD,MAAM,EACJ,KAAK,EACL,eAAe,EAAE,gBAAgB,EACjC,eAAe,EAAE,gBAAgB,EACjC,eAAe,EAAE,gBAAgB,EACjC,gBAAgB,EAAE,iBAAiB,EACnC,eAAe,EAAE,gBAAgB,EACjC,OAAO,EAAE,QAAQ,EACjB,kBAAkB,EAAE,mBAAmB,EACvC,OAAO,EAAE,QAAQ,EACjB,GAAG,IAAI,EACR,GAAG,OAAO,CAAC;QACZ,iFAAiF;QACjF,6EAA6E;QAC7E,MAAM,SAAS,GAAG,KAAK,IAAI,YAAY,CAAC;QACxC,MAAM,OAAO,GAAG,YAAY,CAC1B,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAClF,CAAC;QACF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG;YACf,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QACF,OAAO;YACL,GAAG,IAAI;YACP,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,OAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAC3C,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,cAA0C,EAAE,EAAE,CAC/D,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC;IAExE,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC;QACtB,EAAE,EAAE,2BAAmB;QACvB,IAAI,EAAE,qBAAqB;QAC3B,6DAA6D;QAC7D,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE;YAC5B,MAAM,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;YAC5D,IACE,OAAO,CAAC,eAAe;gBACvB,QAAQ;gBACR,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,QAAQ,EACnD,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAE,CAAC;QAC1C,CAAC;QACD,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,eAAe,IAAI,EAAE;QACxF,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,gBAAgB,IAAI,EAAE;QAC1F,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,eAAe,IAAI,EAAE;QACxF,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,OAAO,IAAI,EAAE;QACxE,cAAc,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;YAC1C,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;YACnF,OAAO;gBACL,kFAAkF;gBAClF,wBAAwB,EAAE,KAAK;gBAC/B,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;oBAC1C,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBACvD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxE,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IACxC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAElC,OAAO;QACL,KAAK;QACL,YAAY,EAAE,OAAO,CAAC,aAAa;QACnC,aAAa,EAAE,QAAQ,CAAC,EAAE;QAC1B,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC;QAC9C,KAAK,EAAE,aAAa;YAClB,CAAC,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7B,GAAG,WAAW;gBACd,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;aAC7C,CAAC;YACJ,CAAC,CAAC,WAAW;QACf,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,yBAAiB;QACrE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,YAAY,EAAE;YACZ,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,yEAAyE;YACzE,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtB;KAC7C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,12 @@
+export { Agent } from '@mastra/core/agent';
+export type { ToolsInput } from '@mastra/core/agent';
 export { createLumifHarness } from './create-lumif-harness';
 export type { LumifHarnessOptions, LumifWorkspace, LumifWorkspaceFactory } from './types';
-export type { ToolsInput } from '@mastra/core/agent';
-export { Agent } from '@mastra/core/agent';
 export { createTool } from '@mastra/core/tools';
 export type { ToolExecutionContext } from '@mastra/core/tools';
 export { Session } from '@mastra/core/agent-controller';
 /** Lumif's stable Harness export, backed by Mastra's AgentController runtime. */
 export { AgentController as Harness } from '@mastra/core/agent-controller';
 export type { AgentControllerConfig, AgentControllerDisplayState, AgentControllerEvent, AgentControllerMode, AgentControllerSubagent, AgentControllerThread, AgentControllerConfig as HarnessConfig, AgentControllerDisplayState as HarnessDisplayState, AgentControllerEvent as HarnessEvent, AgentControllerMode as HarnessMode, AgentControllerSubagent as HarnessSubagent, AgentControllerThread as HarnessThread, } from '@mastra/core/agent-controller';
+export { AGENT_HOST_AGENT_ID, ALL_BUILTIN_TOOLS, createAgentHostConfig, firstModelId, profilesToModes, } from './agent-host';
+export type { AgentHostConfig, AgentHostOptions, AgentHostProfile, AgentHostToolsResolver, } from './agent-host';

package/dist/index.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Harness = exports.Session = exports.createTool = exports.Agent = exports.createLumifHarness = void 0;
-var create_lumif_harness_1 = require("./create-lumif-harness");
-Object.defineProperty(exports, "createLumifHarness", { enumerable: true, get: function () { return create_lumif_harness_1.createLumifHarness; } });
+exports.profilesToModes = exports.firstModelId = exports.createAgentHostConfig = exports.ALL_BUILTIN_TOOLS = exports.AGENT_HOST_AGENT_ID = exports.Harness = exports.Session = exports.createTool = exports.createLumifHarness = exports.Agent = void 0;
 var agent_1 = require("@mastra/core/agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
+var create_lumif_harness_1 = require("./create-lumif-harness");
+Object.defineProperty(exports, "createLumifHarness", { enumerable: true, get: function () { return create_lumif_harness_1.createLumifHarness; } });
 var tools_1 = require("@mastra/core/tools");
 Object.defineProperty(exports, "createTool", { enumerable: true, get: function () { return tools_1.createTool; } });
 var agent_controller_1 = require("@mastra/core/agent-controller");
@@ -12,4 +12,10 @@ Object.defineProperty(exports, "Session", { enumerable: true, get: function () {
 /** Lumif's stable Harness export, backed by Mastra's AgentController runtime. */
 var agent_controller_2 = require("@mastra/core/agent-controller");
 Object.defineProperty(exports, "Harness", { enumerable: true, get: function () { return agent_controller_2.AgentController; } });
+var agent_host_1 = require("./agent-host");
+Object.defineProperty(exports, "AGENT_HOST_AGENT_ID", { enumerable: true, get: function () { return agent_host_1.AGENT_HOST_AGENT_ID; } });
+Object.defineProperty(exports, "ALL_BUILTIN_TOOLS", { enumerable: true, get: function () { return agent_host_1.ALL_BUILTIN_TOOLS; } });
+Object.defineProperty(exports, "createAgentHostConfig", { enumerable: true, get: function () { return agent_host_1.createAgentHostConfig; } });
+Object.defineProperty(exports, "firstModelId", { enumerable: true, get: function () { return agent_host_1.firstModelId; } });
+Object.defineProperty(exports, "profilesToModes", { enumerable: true, get: function () { return agent_host_1.profilesToModes; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAG3B,4CAA2C;AAAlC,8FAAA,KAAK,OAAA;AAEd,4CAAgD;AAAvC,mGAAA,UAAU,OAAA;AAGnB,kEAAwD;AAA/C,2GAAA,OAAO,OAAA;AAChB,iFAAiF;AACjF,kEAA2E;AAAlE,2GAAA,eAAe,OAAW"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4CAA2C;AAAlC,8FAAA,KAAK,OAAA;AAEd,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAG3B,4CAAgD;AAAvC,mGAAA,UAAU,OAAA;AAGnB,kEAAwD;AAA/C,2GAAA,OAAO,OAAA;AAChB,iFAAiF;AACjF,kEAA2E;AAAlE,2GAAA,eAAe,OAAW;AAgBnC,2CAMsB;AALpB,iHAAA,mBAAmB,OAAA;AACnB,+GAAA,iBAAiB,OAAA;AACjB,mHAAA,qBAAqB,OAAA;AACrB,0GAAA,YAAY,OAAA;AACZ,6GAAA,eAAe,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumifai/harness",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -26,13 +26,17 @@
     "!dist/**/*.test.*",
     "README.md"
   ],
-  "dependencies": {
-    "@mastra/core": "1.57.0"
-  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "peerDependencies": {
+    "@mastra/core": "^1.73.0"
+  },
+  "devDependencies": {
+    "@mastra/core": "1.73.0",
+    "zod": "4.6.5"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json"
   }