pi-roundtable 0.34.0 → 0.35.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.35.0] - 2026-11-06
+
+### Added
+
+- Temp-knight presets: an agent saves the role prompt, skills, look, and model of a temp knight it makes often with `helper_preset_set`, reads them with `helper_preset_list`, removes one with `helper_preset_delete`, and makes it with `helper_create` and `preset`. Fields given in the call replace the preset's, and skills given are added to the preset's. A preset belongs to the agent that saved it, at most 20 each, and is checked at save and again when used, with the tier and skill rules `helper_create` applies. The tools are offered with `helper_create` at the member tier, never to a temp knight or with `helpers: false`. The presets live in a new `helper_presets` table, created by the agent server's migrations.
+- `AgentOps.helperPreset`; `AgentOps.helperCreate` takes `preset`, and its `displayName` and `prompt` are optional when a preset gives them.
+
 ## [0.34.0] - 2026-11-04
 
 This is a minor release with a breaking default: an agent's shell no longer gets `GH_TOKEN`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable",
-	"version": "0.34.0",
+	"version": "0.35.0",
 	"description": "A plugin-driven Pi agent server for one owner, reached through Discord or the web",
 	"type": "module",
 	"license": "MIT",
@@ -27,7 +27,6 @@
 	"files": [
 		"src",
 		"!src/**/*.test.ts",
-		"!src/core/testing/file-size.ts",
 		"!src/core/modules/host-shell/shell-fuzz-*.ts",
 		"!src/core/testing/discord-limits.ts",
 		"!src/core/testing/prompt-capture*.ts",

package/src/cli/checks/configuration.ts

@@ -1,5 +1,5 @@
-import { Roundtable } from "../../core/host.ts";
-import { silentLogger } from "../../core/log.ts";
+import { Roundtable } from "../../core/host/host.ts";
+import { silentLogger } from "../../core/kernel/log.ts";
 import { CONFIG_FILE, type Project } from "../project.ts";
 import { fail, ok, type Result } from "../report.ts";
 

package/src/cli/checks/database.ts

@@ -1,7 +1,7 @@
 import type { SQL } from "bun";
 import { nested, openPool, runMigrations } from "../../core/db/migrations.ts";
-import { MigrationError } from "../../core/errors.ts";
-import type { RoundtablePlugin } from "../../core/plugin.ts";
+import { MigrationError } from "../../core/kernel/errors.ts";
+import type { RoundtablePlugin } from "../../core/plugin-api/plugin.ts";
 import type { Project } from "../project.ts";
 import { fail, ok, type Result, skipped } from "../report.ts";
 

package/src/cli/checks/identity.ts

@@ -1,4 +1,5 @@
 import type { SQL } from "bun";
+import { backfillLine } from "../../core/builtin/identity.ts";
 import { LEGACY_ACCESS } from "../../core/config/access.ts";
 import type { ResolvedConfig } from "../../core/config/config.ts";
 import {
@@ -7,7 +8,6 @@ import {
 } from "../../core/identity/access-policy.ts";
 import { identityOf, parseIdentity } from "../../core/identity/actor-facts.ts";
 import { declaredConflict } from "../../core/identity/config-owner.ts";
-import { backfillLine } from "../../core/identity/identity-plugin.ts";
 import {
 	type BackfillSummary,
 	backfillPrincipals,

package/src/cli/checks/model.ts

@@ -1,4 +1,4 @@
-import { parseModelRef } from "../../core/models.ts";
+import { parseModelRef } from "../../core/domain/models.ts";
 import {
 	BRIDGE_MEMORY_FIX,
 	bridgeMemoryProblem,

package/src/cli/cli.ts

@@ -1,8 +1,8 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { resolveConfig } from "../core/config/config.ts";
-import type { DefinedRoundtable } from "../core/define-roundtable.ts";
-import { Roundtable } from "../core/host.ts";
+import type { DefinedRoundtable } from "../core/host/define-roundtable.ts";
+import { Roundtable } from "../core/host/host.ts";
 import { declaredIdentities } from "../core/identity/plugin-identities.ts";
 import { addPackage } from "./add-package.ts";
 import { addPlugin } from "./add-plugin.ts";

package/src/cli/principal.ts

@@ -12,7 +12,7 @@ import {
 	type RoleGrant,
 } from "../core/identity/principal-store.ts";
 import { chosenProfileSource } from "../core/identity/profile-choices.ts";
-import type { Tier } from "../core/speakers.ts";
+import type { Tier } from "../core/identity/speakers.ts";
 import { CONFIG_FILE } from "./project.ts";
 
 export const PRINCIPAL_USAGE = `  roundtable principal list    every principal, with its roles and its identities written as

package/src/cli/project.ts

@@ -7,8 +7,8 @@ import {
 	type RoundtableConfig,
 	resolveConfig,
 } from "../core/config/config.ts";
-import type { DefinedRoundtable } from "../core/define-roundtable.ts";
-import { type Logger, silentLogger } from "../core/log.ts";
+import type { DefinedRoundtable } from "../core/host/define-roundtable.ts";
+import { type Logger, silentLogger } from "../core/kernel/log.ts";
 import { fail, type Result } from "./report.ts";
 
 export const CONFIG_FILE = "roundtable.config.ts";

package/src/cli/runtime.ts

@@ -2,9 +2,9 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import type { Credential, CredentialStore } from "@earendil-works/pi-ai";
 import { ModelRuntime } from "@earendil-works/pi-coding-agent";
-import type { DefinedRoundtable } from "../core/define-roundtable.ts";
-import { defineRoundtable } from "../core/define-roundtable.ts";
-import type { Logger } from "../core/log.ts";
+import type { DefinedRoundtable } from "../core/host/define-roundtable.ts";
+import { defineRoundtable } from "../core/host/define-roundtable.ts";
+import type { Logger } from "../core/kernel/log.ts";
 
 /** A credential store that holds nothing and refuses writes, so looking never creates `auth.json`. */
 const emptyCredentials: CredentialStore = {

package/src/cli/start.ts

@@ -1,4 +1,4 @@
-import type { DefinedRoundtable } from "../core/define-roundtable.ts";
+import type { DefinedRoundtable } from "../core/host/define-roundtable.ts";
 import { buildChecks, type DoctorInputs } from "./doctor.ts";
 import { Project } from "./project.ts";
 import { failed, type Outcome, runChecks } from "./report.ts";

package/src/core/agents/agent-claim.ts

@@ -14,14 +14,14 @@ import type {
 import type { AgentRuntime } from "../contract/runtime.ts";
 import { parseChannelKey, type SurfacePort } from "../contract/surface.ts";
 import type { ChannelKey } from "../domain/conversation.ts";
-import type { OwnerIdentity } from "../identity.ts";
-import type { Logger } from "../log.ts";
-import { PERSONAL_TARGET } from "../modules/background/personal-target.ts";
+import type { OwnerIdentity } from "../identity/owner-identity.ts";
+import { addressee, attributed, type Speaker } from "../identity/speakers.ts";
+import type { Logger } from "../kernel/log.ts";
 import { withReference } from "../routing/message-text.ts";
 import { answersAuthor } from "../routing/peer-bots.ts";
 import { outcome } from "../routing/settle-turn.ts";
 import { systemTurn } from "../routing/system-turns.ts";
-import { addressee, attributed, type Speaker } from "../speakers.ts";
+import { PERSONAL_TARGET } from "../shared/personal-target.ts";
 import type { DiscordAgentTeam } from "./agent-team.ts";
 import { discordIdOf, roomOf } from "./team-keys.ts";
 

package/src/core/agents/agent-dashboard.ts

@@ -1,7 +1,7 @@
+import { thinkingLabel } from "../domain/models.ts";
 import { messages } from "../i18n/index.ts";
-import type { Logger } from "../log.ts";
-import { thinkingLabel } from "../models.ts";
-import { zonedDate, zonedStamp } from "../time.ts";
+import type { Logger } from "../kernel/log.ts";
+import { zonedDate, zonedStamp } from "../kernel/time.ts";
 import type { ContextUse, DashboardBoard } from "./agent-ports.ts";
 import type { AgentStatus, GroupStatus, TeamStatus } from "./agent-team.ts";
 

package/src/core/agents/agent-messages.ts

@@ -1,12 +1,12 @@
 import type { ChannelKey, IntercomCard } from "../domain/conversation.ts";
 import { AgentError, IdentityError } from "../domain/errors.ts";
 import type { AgentTurnScope } from "../domain/ports.ts";
-import { HostStoppingError } from "../errors.ts";
 import { SYSTEM_PRINCIPAL } from "../identity/principal-store.ts";
+import { addressee, type Speaker } from "../identity/speakers.ts";
+import { HostStoppingError } from "../kernel/errors.ts";
 import { intercomPlain } from "../presentation/intercom.ts";
 import { isQuiet } from "../presentation/reply-body.ts";
 import { splitReply } from "../presentation/reply-splitter.ts";
-import { addressee, type Speaker } from "../speakers.ts";
 import type { OutboxEntry, StoredOutboxEntry } from "./agent-outbox.ts";
 import {
 	agentFailureText,

package/src/core/agents/agent-outbox.ts

@@ -1,7 +1,7 @@
 import type { SQL } from "bun";
 import type { Migration } from "../db/migrations.ts";
 import type { ChannelKey } from "../domain/conversation.ts";
-import type { Speaker } from "../speakers.ts";
+import type { Speaker } from "../identity/speakers.ts";
 
 /**
  * An agent message the host stopped before it could deliver. `message` is the request to the

package/src/core/agents/agent-ports.ts

@@ -1,7 +1,7 @@
 import type { AgentRuntime, ContextUse } from "../contract/runtime.ts";
 import type { IntercomCard } from "../domain/conversation.ts";
 import type { InterimPosts } from "../domain/interim.ts";
-import type { ThinkingSetting } from "../models.ts";
+import type { ThinkingSetting } from "../domain/models.ts";
 
 export type { ContextUse };
 

package/src/core/agents/agent-prompt.ts

@@ -1,9 +1,9 @@
 import { parseChannelKey, type SurfacePort } from "../contract/surface.ts";
 import type { ChannelKey } from "../domain/conversation.ts";
 import { messages } from "../i18n/index.ts";
-import { type OwnerIdentity, ownerWords } from "../identity.ts";
-import type { AgentTools } from "../plugin.ts";
-import { addressee, type Speaker } from "../speakers.ts";
+import { type OwnerIdentity, ownerWords } from "../identity/owner-identity.ts";
+import { addressee, type Speaker } from "../identity/speakers.ts";
+import type { AgentTools } from "../plugin-api/plugin.ts";
 import type { Agent, AgentGroup, Backlog } from "./agent-store.ts";
 
 /**
@@ -58,7 +58,7 @@ export function agentSystemPrompt(input: {
 		);
 	else if (input.helpers)
 		parts.push(
-			"A task that stands on its own, such as one of several things to look up or compare, can go to a temp knight: helper_create makes one of yours that works in parallel, its answer comes back to you as a new turn, and helper_end clears the ones you are done with.",
+			"A task that stands on its own, such as one of several things to look up or compare, can go to a temp knight: helper_create makes one of yours that works in parallel, its answer comes back to you as a new turn, and helper_end clears the ones you are done with. A temp knight you make often can be saved as a preset (helper_preset_set), then made with helper_create and preset.",
 		);
 	if (group) {
 		const others = group.members

package/src/core/agents/agent-rules.ts

@@ -4,7 +4,7 @@ import {
 	suggestCharacter,
 } from "../../characters/index.ts";
 import { AgentError } from "../domain/errors.ts";
-import { THINKING_LEVELS, type ThinkingLevel } from "../models.ts";
+import { THINKING_LEVELS, type ThinkingLevel } from "../domain/models.ts";
 
 export const MAX_PROMPT_CHARS = 4_000;
 export const MAX_AVATAR_PROMPT_CHARS = 1_000;

package/src/core/agents/agent-schema.ts

@@ -1,11 +1,12 @@
 import { readCharacter } from "../../characters/index.ts";
 import { scopeToGuild } from "../db/guild-scope.ts";
 import type { Migration } from "../db/migrations.ts";
-import type { ThinkingLevel } from "../models.ts";
+import type { ThinkingLevel } from "../domain/models.ts";
 import { promptHistoryMigration } from "../modules/prompts/prompt-history.ts";
 import { AgentConversations } from "./agent-conversations.ts";
 import { outboxMigration } from "./agent-outbox.ts";
 import type { Agent, AgentGroup, AgentStatus } from "./agent-rules.ts";
+import { HelperPresets } from "./helper-presets.ts";
 
 export interface AgentRow {
 	name: string;
@@ -164,5 +165,7 @@ export function agentMigrations(guildId: string): Migration[] {
 		outboxMigration(),
 		// Where each agent last ran a turn, so a message to it finds that conversation after a restart.
 		AgentConversations.migration,
+		// The temp-knight presets each agent saved; kept when the agent is archived.
+		HelperPresets.migration,
 	];
 }

package/src/core/agents/agent-settings.ts

@@ -1,10 +1,10 @@
 import { AgentError } from "../domain/errors.ts";
-import { assistantName } from "../i18n/index.ts";
 import {
 	AUTO_THINKING,
 	type ThinkingLevel,
 	type ThinkingSetting,
-} from "../models.ts";
+} from "../domain/models.ts";
+import { assistantName } from "../i18n/index.ts";
 import { checkModelRef, checkThinking } from "./agent-store.ts";
 
 /** Resets a model or thinking setting to the assistant's. */

package/src/core/agents/agent-store.ts

@@ -2,12 +2,12 @@ import type { SQL } from "bun";
 import type { CharacterSpec } from "../../characters/index.ts";
 import type { Migration } from "../db/migrations.ts";
 import { AgentError } from "../domain/errors.ts";
-import type { ThinkingLevel } from "../models.ts";
+import type { ThinkingLevel } from "../domain/models.ts";
 import {
 	PromptHistory,
 	type PromptVersion,
 } from "../modules/prompts/prompt-history.ts";
-import type { AgentDirectory } from "../services.ts";
+import type { AgentDirectory } from "../plugin-api/services.ts";
 import { AgentBook } from "./agent-book.ts";
 import { AgentConversations } from "./agent-conversations.ts";
 import { AgentOutbox } from "./agent-outbox.ts";
@@ -15,7 +15,6 @@ import {
 	type Agent,
 	type AgentGroup,
 	type AgentSeed,
-	type AgentStatus,
 	type Backlog,
 	checkAgentName,
 	checkAvatarPrompt,
@@ -35,6 +34,7 @@ import {
 } from "./agent-schema.ts";
 import { AgentStatements } from "./agent-statements.ts";
 import { GroupMessages } from "./group-messages.ts";
+import { HelperPresets } from "./helper-presets.ts";
 
 export {
 	type Agent,
@@ -74,6 +74,8 @@ export class PgAgentStore extends AgentBook implements AgentDirectory {
 	readonly outbox: AgentOutbox;
 	/** The conversation each agent last ran a turn in. */
 	readonly conversations: AgentConversations;
+	/** The temp-knight presets each agent saved. */
+	readonly presets: HelperPresets;
 
 	private constructor(
 		sql: SQL,
@@ -88,6 +90,7 @@ export class PgAgentStore extends AgentBook implements AgentDirectory {
 		this.#messages = new GroupMessages(sql, guildId);
 		this.#prompts = new PromptHistory(sql, guildId);
 		this.outbox = new AgentOutbox(sql, guildId);
+		this.presets = new HelperPresets(sql, guildId);
 	}
 
 	/** The store's tables; the host runs this before any store attaches. */
@@ -454,12 +457,9 @@ export class PgAgentStore extends AgentBook implements AgentDirectory {
 
 	async #writeGroup(
 		name: string,
-		change: {
-			displayName?: string;
-			members?: string[];
-			host?: string;
-			status?: AgentStatus;
-		},
+		change: Partial<
+			Pick<AgentGroup, "displayName" | "members" | "host" | "status">
+		>,
 	): Promise<AgentGroup> {
 		const current = this.groupMap.get(name);
 		if (!current) throw new AgentError(`There is no group "${name}".`);

package/src/core/agents/agent-team-fixture.ts

@@ -12,11 +12,12 @@ import type {
 } from "../domain/conversation.ts";
 import type { RoundProgress } from "../domain/round.ts";
 import type { IdentityService } from "../identity/identity-port.ts";
-import { silentLogger } from "../log.ts";
+import { silentLogger } from "../kernel/log.ts";
 import { StoredSkillRegistry as SkillRegistry } from "../modules/skills/skill-registry.ts";
 import { SkillStore } from "../modules/skills/skill-store.ts";
-import type { PromptSection } from "../plugin.ts";
+import type { PromptSection } from "../plugin-api/plugin.ts";
 import { type ChannelQueue, channelQueue } from "../routing/channel-queue.ts";
+import { toolTiers } from "../runtime/tool-tiers.ts";
 import {
 	openTestStore,
 	TEST_GUILD,
@@ -25,7 +26,6 @@ import {
 } from "../testing/database.ts";
 import { useTestLocale } from "../testing/locale.ts";
 import { OWNER_SPEAKER, TEST_OWNER } from "../testing/owner.ts";
-import { toolTiers } from "../tool-tiers.ts";
 import type {
 	AgentCategory,
 	AgentChannels,
@@ -305,6 +305,7 @@ export function useTeamFixture(
 			"skill_versions",
 			"skill_groups",
 			"agent_skills",
+			"helper_presets",
 		])
 			await admin.unsafe(`DROP TABLE IF EXISTS ${table}`);
 		await admin.close();

package/src/core/agents/agent-team.ts

@@ -3,13 +3,13 @@ import type { CharacterInput } from "../../characters/index.ts";
 import type { TurnAttachments } from "../domain/attachment.ts";
 import type { ChannelKey, TurnResult } from "../domain/conversation.ts";
 import { AgentError, ScheduleError } from "../domain/errors.ts";
+import type { ThinkingSetting } from "../domain/models.ts";
 import type { AgentTurnScope } from "../domain/ports.ts";
-import type { ThinkingSetting } from "../models.ts";
+import type { TurnSelection } from "../domain/sessions.ts";
+import { type Speaker, THE_SPEAKER } from "../identity/speakers.ts";
 import type { PromptVersion } from "../modules/prompts/prompt-history.ts";
 import type { ResolvedSkill } from "../modules/skills/skill-rules.ts";
-import type { AgentChange, AgentTeam } from "../services.ts";
-import type { TurnSelection } from "../sessions.ts";
-import { type Speaker, THE_SPEAKER } from "../speakers.ts";
+import type { AgentChange, AgentTeam } from "../plugin-api/services.ts";
 import type { Agent } from "./agent-store.ts";
 import {
 	type AgentOps,
@@ -17,6 +17,7 @@ import {
 	agentToolsExtension,
 } from "./agent-tools.ts";
 import type { HelperTeam } from "./helper-ops.ts";
+import { type PresetAction, presetAction } from "./helper-preset-ops.ts";
 import { type Routes, routesOf } from "./routes.ts";
 import { TeamEditing } from "./team-editing.ts";
 import type { TeamHelpers } from "./team-helpers.ts";
@@ -257,19 +258,9 @@ export class DiscordAgentTeam implements AgentOps, AgentTeam {
 
 	/** The owner's message in an agent's channel; call inside its queue. `text` has the reference, `replyText` what they typed. */
 	answerOwner(
-		channel: ChannelKey,
-		speaker: Speaker,
-		text: string,
-		replyText: string,
-		attachments: TurnAttachments,
+		...args: Parameters<TeamTurns["answerOwner"]>
 	): Promise<TurnResult> {
-		return this.#turns.answerOwner(
-			channel,
-			speaker,
-			text,
-			replyText,
-			attachments,
-		);
+		return this.#turns.answerOwner(...args);
 	}
 
 	/**
@@ -422,6 +413,11 @@ export class DiscordAgentTeam implements AgentOps, AgentTeam {
 		return this.#editing.createHelper(caller, input);
 	}
 
+	/** A knight keeps its own temp-knight presets; see `AgentOps.helperPreset`. */
+	helperPreset(caller: AgentTurnScope, action: PresetAction): Promise<string> {
+		return presetAction(this.#context, caller, action);
+	}
+
 	/** A knight archives its own temp knights; the pages that show the parent are told. */
 	helperEnd(
 		caller: AgentTurnScope,

package/src/core/agents/agent-tools.ts

@@ -2,10 +2,11 @@ import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import type { CharacterInput } from "../../characters/index.ts";
 import { AgentError } from "../domain/errors.ts";
+import { THINKING_LEVELS } from "../domain/models.ts";
 import type { AgentTurnScope } from "../domain/ports.ts";
 import { assistantName, messages } from "../i18n/index.ts";
-import { type OwnerIdentity, ownerWords } from "../identity.ts";
-import { THINKING_LEVELS } from "../models.ts";
+import { type OwnerIdentity, ownerWords } from "../identity/owner-identity.ts";
+import { timeZone } from "../kernel/time.ts";
 import {
 	optionalString,
 	requiredString,
@@ -13,7 +14,6 @@ import {
 	type TextToolDef,
 	textToolsExtension,
 } from "../runtime/text-tools.ts";
-import { timeZone } from "../time.ts";
 import { MAX_GROUP_MEMBERS, MIN_GROUP_MEMBERS } from "./agent-store.ts";
 import {
 	CLASS,
@@ -24,6 +24,7 @@ import {
 	PARTS,
 	PROMPT,
 } from "./agent-tool-schema.ts";
+import type { HelperFields, PresetAction } from "./helper-preset-ops.ts";
 import { helperToolDefs } from "./helper-tools.ts";
 
 /** The tool that hands a request to another agent; a group seat has none. */
@@ -32,8 +33,14 @@ export const MESSAGE_AGENT_TOOL = "message_agent";
 /** The tool that changes an agent's look; every host offers it. */
 export const AVATAR_TOOL = "agent_avatar";
 
-/** The tools that make and end temp knights; `helpers: false` leaves them out. */
-export const HELPER_TOOLS = ["helper_create", "helper_end"] as const;
+/** The tools that make and end temp knights and keep their presets; `helpers: false` leaves them out. */
+export const HELPER_TOOLS = [
+	"helper_create",
+	"helper_end",
+	"helper_preset_set",
+	"helper_preset_list",
+	"helper_preset_delete",
+] as const;
 
 export const AGENT_TOOLS = [
 	"agent_list",
@@ -103,17 +110,10 @@ export interface AgentOps {
 	/** Makes a temp knight of the caller for one task; the answer returns to the caller's conversation. */
 	helperCreate(
 		caller: AgentTurnScope,
-		input: {
-			name?: string;
-			displayName: string;
-			prompt: string;
-			task: string;
-			character?: CharacterInput;
-			skills?: string[];
-			model?: string;
-			thinking?: string;
-		},
+		input: HelperFields & { name?: string; task: string },
 	): Promise<string>;
+	/** Saves, lists, or deletes the caller's own temp-knight presets. */
+	helperPreset(caller: AgentTurnScope, action: PresetAction): Promise<string>;
 	/** Archives the caller's own temp knights: the named ones, or every one that is finished. */
 	helperEnd(
 		caller: AgentTurnScope,

package/src/core/agents/avatar-refresh.ts

@@ -1,5 +1,5 @@
 import type { CharacterSpec } from "../../characters/index.ts";
-import type { Logger } from "../log.ts";
+import type { Logger } from "../kernel/log.ts";
 import type { Agent } from "./agent-store.ts";
 
 /** What the refresh needs of the team: the agents, a render, and a way to set the picture. */

package/src/core/agents/avatar-studio.ts

@@ -6,9 +6,9 @@ import { resolveCharacter } from "../../characters/index.ts";
 import { squarePng } from "../attachments/square-png.ts";
 import type { ImageDrawer } from "../contract/providers.ts";
 import { ConfigError } from "../domain/errors.ts";
-import { ProviderError } from "../errors.ts";
 import type { HttpRoute } from "../http/listeners.ts";
-import type { AvatarStudio } from "../services.ts";
+import { ProviderError } from "../kernel/errors.ts";
+import type { AvatarStudio } from "../plugin-api/services.ts";
 import { characterPng } from "./character-png.ts";
 import { fallbackAvatar } from "./fallback-avatar.ts";
 

package/src/core/agents/group-round.ts

@@ -1,6 +1,6 @@
 import type { Judge } from "../contract/providers.ts";
-import { type OwnerIdentity, ownerWords } from "../identity.ts";
-import type { Logger } from "../log.ts";
+import { type OwnerIdentity, ownerWords } from "../identity/owner-identity.ts";
+import type { Logger } from "../kernel/log.ts";
 import type { Agent, GroupMessage } from "./agent-store.ts";
 
 /** Members at or above this relevance answer an owner message nobody is named in; a message naming members is answered by them alone. */

package/src/core/agents/group-turns.ts

@@ -3,7 +3,7 @@ import type { ChannelKey, TurnResult } from "../domain/conversation.ts";
 import { AgentError } from "../domain/errors.ts";
 import type { RoundEnd, RoundProgress } from "../domain/round.ts";
 import { messages } from "../i18n/index.ts";
-import type { Speaker } from "../speakers.ts";
+import type { Speaker } from "../identity/speakers.ts";
 import { groupTurnText } from "./agent-prompt.ts";
 import type { Agent, AgentGroup } from "./agent-store.ts";
 import {

package/src/core/agents/helper-create.ts

@@ -1,12 +1,16 @@
 import type { CharacterInput } from "../../characters/index.ts";
-import { helpersOf } from "../config/helpers.ts";
 import { AgentError } from "../domain/errors.ts";
 import type { AgentTurnScope } from "../domain/ports.ts";
-import type { Speaker } from "../speakers.ts";
-import { toolTiers } from "../tool-tiers.ts";
+import type { Speaker } from "../identity/speakers.ts";
 import { isHelper } from "./agent-rules.ts";
 import type { Agent } from "./agent-store.ts";
 import { followOrigin } from "./helper-modes.ts";
+import {
+	checkHelperGrant,
+	type HelperFields,
+	helperMaker,
+	withPreset,
+} from "./helper-preset-ops.ts";
 import type { TeamContext } from "./team-options.ts";
 
 /** The team's way of making an agent, which `createHelper` uses to make a temp knight. */
@@ -40,46 +44,26 @@ export async function createHelper(
 	ctx: TeamContext,
 	make: MakeAgent,
 	caller: AgentTurnScope,
-	input: {
-		name?: string;
-		displayName: string;
-		prompt: string;
-		task: string;
-		character?: CharacterInput;
-		skills?: string[];
-		model?: string;
-		thinking?: string;
-	},
+	input: HelperFields & { name?: string; task: string },
 ): Promise<string> {
 	const { store, logger } = ctx.options;
-	const limits = helpersOf(ctx.options.helpers);
-	if (!limits)
-		throw new AgentError("Temp knights are switched off on this host.");
-	const speaker = ctx.turns.speakerOf(caller);
-	if (!speaker)
+	const { speaker, parent, limits } = helperMaker(ctx, caller, "helper_create");
+	// A preset saved earlier is checked again now, merged with the call.
+	const merged = await withPreset(ctx, parent, input);
+	const {
+		task,
+		name: given,
+		model,
+		thinking,
+		preset: _preset,
+		...rest
+	} = merged;
+	const { displayName, prompt } = rest;
+	if (!displayName || !prompt)
 		throw new AgentError(
-			"helper_create can only be used during an agent turn.",
+			"Give display_name and prompt, or a preset (from helper_preset_list) that has them.",
 		);
-	const parent = store.activeAgent(caller.name);
-	if (isHelper(parent))
-		throw new AgentError(
-			`You are a temp knight of "${parent.parent}" and cannot make temp knights; ask it to.`,
-		);
-	const { task, name: given, model, thinking, ...rest } = input;
-	// A temp knight never gets more than its parent unless the speaker could grant it by hand.
-	const tiers = ctx.options.toolTiers ?? toolTiers();
-	if (!tiers.allows(speaker.tier, "agent_update") && (model || thinking))
-		throw new AgentError(
-			"A temp knight runs your model and thinking level; choosing others needs a higher tier.",
-		);
-	if (rest.skills?.length && !tiers.allows(speaker.tier, "agent_skills")) {
-		const own = new Set(ctx.options.skills?.carriedNames(parent.name) ?? []);
-		const extra = rest.skills.filter((skill) => !own.has(skill));
-		if (extra.length > 0)
-			throw new AgentError(
-				`A temp knight can carry only skills you carry; not allowed: ${extra.join(", ")}.`,
-			);
-	}
+	checkHelperGrant(ctx, speaker, parent, merged);
 	const name = given ?? nextName(ctx, parent.name);
 	// Everything that can be refused is checked before anything is made or archived.
 	store.checkNewName(name);
@@ -92,7 +76,7 @@ export async function createHelper(
 			parent,
 			origin: ctx.turns.turnChannel(caller),
 		},
-		{ ...rest, name },
+		{ ...rest, displayName, prompt, name },
 		{ model, thinking },
 	);
 	const helper = made.agent;

package/src/core/agents/helper-modes.ts

@@ -1,8 +1,8 @@
 import type { AgentTurnScope } from "../domain/ports.ts";
 import { SYSTEM_PRINCIPAL } from "../identity/principal-store.ts";
+import type { Speaker } from "../identity/speakers.ts";
 import type { ModeOrigins } from "../modes/mode-inheritance.ts";
-import type { AgentDirectory } from "../services.ts";
-import type { Speaker } from "../speakers.ts";
+import type { AgentDirectory } from "../plugin-api/services.ts";
 import { isHelper } from "./agent-rules.ts";
 import type { Agent } from "./agent-store.ts";
 import { agentOfChannel, groupOfChannel, keysOf } from "./team-keys.ts";