pi-roundtable 0.1.0 → 0.2.0

package/src/core/tool-set.snapshot.json

@@ -0,0 +1,288 @@
+{
+	"sessions": {
+		"owner": {
+			"tools": [
+				"delegate_task",
+				"discord_add_member_role",
+				"discord_ban_member",
+				"discord_create_channel",
+				"discord_create_role",
+				"discord_create_thread",
+				"discord_delete_channel",
+				"discord_delete_channel_permissions",
+				"discord_delete_message",
+				"discord_delete_role",
+				"discord_edit_channel",
+				"discord_edit_message",
+				"discord_edit_role",
+				"discord_edit_thread",
+				"discord_find_members",
+				"discord_get_channel_info",
+				"discord_get_messages",
+				"discord_get_pinned_messages",
+				"discord_kick_member",
+				"discord_list_channels",
+				"discord_list_roles",
+				"discord_list_servers",
+				"discord_list_threads",
+				"discord_pin_message",
+				"discord_remove_member_role",
+				"discord_search_messages",
+				"discord_send_message",
+				"discord_set_channel_permissions",
+				"discord_set_nickname",
+				"discord_timeout_member",
+				"discord_unban_member",
+				"discord_unpin_message",
+				"memory_add",
+				"memory_remove",
+				"memory_search",
+				"notify_owner",
+				"schedule_cancel",
+				"schedule_create",
+				"schedule_list",
+				"schedule_update"
+			]
+		},
+		"agent": {
+			"tools": [
+				"agent_create",
+				"agent_get",
+				"agent_list",
+				"agent_skills",
+				"agent_update",
+				"archive",
+				"channel_arrange",
+				"channel_read",
+				"delegate_task",
+				"discord_add_member_role",
+				"discord_ban_member",
+				"discord_create_channel",
+				"discord_create_role",
+				"discord_create_thread",
+				"discord_delete_channel",
+				"discord_delete_channel_permissions",
+				"discord_delete_message",
+				"discord_delete_role",
+				"discord_edit_channel",
+				"discord_edit_message",
+				"discord_edit_role",
+				"discord_edit_thread",
+				"discord_find_members",
+				"discord_get_channel_info",
+				"discord_get_messages",
+				"discord_get_pinned_messages",
+				"discord_kick_member",
+				"discord_list_channels",
+				"discord_list_roles",
+				"discord_list_servers",
+				"discord_list_threads",
+				"discord_pin_message",
+				"discord_remove_member_role",
+				"discord_search_messages",
+				"discord_send_message",
+				"discord_set_channel_permissions",
+				"discord_set_nickname",
+				"discord_timeout_member",
+				"discord_unban_member",
+				"discord_unpin_message",
+				"group_create",
+				"group_update",
+				"memory_add",
+				"memory_remove",
+				"memory_search",
+				"message_agent",
+				"notify_owner",
+				"schedule_cancel",
+				"schedule_create",
+				"schedule_list",
+				"schedule_update",
+				"skill_create",
+				"skill_delete",
+				"skill_group_delete",
+				"skill_group_set",
+				"skill_link",
+				"skill_unlink",
+				"skill_update"
+			],
+			"selection": [
+				"agent_create",
+				"agent_get",
+				"agent_list",
+				"agent_skills",
+				"agent_update",
+				"archive",
+				"bash",
+				"channel_arrange",
+				"channel_read",
+				"edit",
+				"group_create",
+				"group_update",
+				"message_agent",
+				"read",
+				"skill_create",
+				"skill_delete",
+				"skill_group_delete",
+				"skill_group_set",
+				"skill_link",
+				"skill_unlink",
+				"skill_update",
+				"write"
+			]
+		},
+		"group seat": {
+			"tools": [
+				"agent_create",
+				"agent_get",
+				"agent_list",
+				"agent_skills",
+				"agent_update",
+				"archive",
+				"channel_arrange",
+				"channel_read",
+				"delegate_task",
+				"discord_add_member_role",
+				"discord_ban_member",
+				"discord_create_channel",
+				"discord_create_role",
+				"discord_create_thread",
+				"discord_delete_channel",
+				"discord_delete_channel_permissions",
+				"discord_delete_message",
+				"discord_delete_role",
+				"discord_edit_channel",
+				"discord_edit_message",
+				"discord_edit_role",
+				"discord_edit_thread",
+				"discord_find_members",
+				"discord_get_channel_info",
+				"discord_get_messages",
+				"discord_get_pinned_messages",
+				"discord_kick_member",
+				"discord_list_channels",
+				"discord_list_roles",
+				"discord_list_servers",
+				"discord_list_threads",
+				"discord_pin_message",
+				"discord_remove_member_role",
+				"discord_search_messages",
+				"discord_send_message",
+				"discord_set_channel_permissions",
+				"discord_set_nickname",
+				"discord_timeout_member",
+				"discord_unban_member",
+				"discord_unpin_message",
+				"group_create",
+				"group_update",
+				"memory_add",
+				"memory_remove",
+				"memory_search",
+				"notify_owner",
+				"schedule_cancel",
+				"schedule_create",
+				"schedule_list",
+				"schedule_update",
+				"skill_create",
+				"skill_delete",
+				"skill_group_delete",
+				"skill_group_set",
+				"skill_link",
+				"skill_unlink",
+				"skill_update"
+			],
+			"selection": [
+				"agent_create",
+				"agent_get",
+				"agent_list",
+				"agent_skills",
+				"agent_update",
+				"archive",
+				"bash",
+				"channel_arrange",
+				"channel_read",
+				"edit",
+				"group_create",
+				"group_update",
+				"read",
+				"skill_create",
+				"skill_delete",
+				"skill_group_delete",
+				"skill_group_set",
+				"skill_link",
+				"skill_unlink",
+				"skill_update",
+				"write"
+			]
+		}
+	},
+	"tiers": {
+		"agent_create": "admin",
+		"agent_get": "member",
+		"agent_list": "member",
+		"agent_skills": "admin",
+		"agent_update": "admin",
+		"archive": "admin",
+		"ask_user": "member",
+		"bash": "owner",
+		"channel_arrange": "admin",
+		"channel_read": "member",
+		"compact_session": "member",
+		"delegate_task": "admin",
+		"discord_add_member_role": "owner",
+		"discord_ban_member": "owner",
+		"discord_create_channel": "owner",
+		"discord_create_role": "owner",
+		"discord_create_thread": "owner",
+		"discord_delete_channel": "owner",
+		"discord_delete_channel_permissions": "owner",
+		"discord_delete_message": "owner",
+		"discord_delete_role": "owner",
+		"discord_edit_channel": "owner",
+		"discord_edit_message": "owner",
+		"discord_edit_role": "owner",
+		"discord_edit_thread": "owner",
+		"discord_find_members": "owner",
+		"discord_get_channel_info": "owner",
+		"discord_get_messages": "owner",
+		"discord_get_pinned_messages": "owner",
+		"discord_kick_member": "owner",
+		"discord_list_channels": "owner",
+		"discord_list_roles": "owner",
+		"discord_list_servers": "owner",
+		"discord_list_threads": "owner",
+		"discord_pin_message": "owner",
+		"discord_remove_member_role": "owner",
+		"discord_search_messages": "owner",
+		"discord_send_message": "owner",
+		"discord_set_channel_permissions": "owner",
+		"discord_set_nickname": "owner",
+		"discord_timeout_member": "owner",
+		"discord_unban_member": "owner",
+		"discord_unpin_message": "owner",
+		"edit": "owner",
+		"fetch_content": "member",
+		"get_search_content": "member",
+		"group_create": "admin",
+		"group_update": "admin",
+		"memory_add": "member",
+		"memory_remove": "member",
+		"memory_search": "member",
+		"message_agent": "member",
+		"notify_owner": "owner",
+		"read": "owner",
+		"read_attachment": "member",
+		"schedule_cancel": "admin",
+		"schedule_create": "admin",
+		"schedule_list": "member",
+		"schedule_update": "admin",
+		"skill_create": "admin",
+		"skill_delete": "admin",
+		"skill_group_delete": "admin",
+		"skill_group_set": "admin",
+		"skill_link": "admin",
+		"skill_unlink": "admin",
+		"skill_update": "admin",
+		"web_search": "member",
+		"write": "owner"
+	}
+}

package/src/core/tool-tiers.ts

@@ -1,12 +1,7 @@
-import { AGENT_TOOLS } from "./agents/agent-tools.ts";
-import { ConfigError } from "./domain/errors.ts";
 import { PluginError } from "./errors.ts";
-import { SKILL_LIST_TOOL, SKILL_TOOLS } from "./modules/skills/skill-tools.ts";
 import { ASK_USER_TOOL } from "./runtime/extensions/ask-user.ts";
 import { COMPACT_TOOL } from "./runtime/extensions/self-compact-guard.ts";
-import { DELEGATE_TOOL } from "./shared/delegate-tool.ts";
-import { SCHEDULE_TOOLS } from "./shared/schedule-tools.ts";
-import { TIERS, type Tier, tierAtLeast } from "./speakers.ts";
+import { type Tier, tierAtLeast } from "./speakers.ts";
 
 /** The lowest tier that may use each tool; a tool that is not named needs the owner. */
 export interface ToolTiers {
@@ -19,37 +14,18 @@ const set = (tier: Tier, tools: readonly string[]) =>
 	Object.fromEntries(tools.map((tool) => [tool, tier]));
 
 /**
- * The core's default tiers. Members talk, read, look things up, and message agents; admins
- * also create and edit agents, groups, skills, schedules, and delegated work; everything else,
- * such as the shell, the owner's notes, Discord administration, and every plugin's tools,
- * stays with the owner until an operator lowers it.
+ * The core's own tools, which serve any turn that can ask, compact, or read an attachment.
+ * Every other feature declares the tiers of its tools with its plugin (`Contribution.toolTiers`):
+ * members talk, read, look things up, and message agents; admins also create and edit agents,
+ * groups, skills, schedules, and delegated work; everything else, such as the shell, the owner's
+ * notes, Discord administration, and any plugin's tools, stays with the owner until an operator
+ * lowers it.
  */
-export const CORE_TOOL_TIERS: Readonly<Record<string, Tier>> = {
-	...set("admin", [
-		...AGENT_TOOLS,
-		...SKILL_TOOLS,
-		...SCHEDULE_TOOLS,
-		DELEGATE_TOOL,
-	]),
-	...set("member", [
-		"agent_list",
-		"agent_get",
-		"message_agent",
-		"channel_read",
-		"schedule_list",
-		SKILL_LIST_TOOL,
-		"read_attachment",
-		// Each speaker keeps their own; the owner's reaches only the owner's turns.
-		"memory_add",
-		"memory_search",
-		"memory_remove",
-		"web_search",
-		"fetch_content",
-		"get_search_content",
-	]),
-	// The core's own tools serve any turn that can ask or compact.
-	...set("member", [ASK_USER_TOOL, COMPACT_TOOL]),
-};
+export const CORE_TOOL_TIERS: Readonly<Record<string, Tier>> = set("member", [
+	ASK_USER_TOOL,
+	COMPACT_TOOL,
+	"read_attachment",
+]);
 
 /**
  * What each tool needs: the operator's setting first, then the tier its plugin declared, then
@@ -65,11 +41,14 @@ export class ToolTierTable implements ToolTiers {
 		this.#operator = new Map(Object.entries(operator));
 	}
 
-	/** Records the tiers a plugin's tools need; a tool two plugins declare is a PluginError. */
+	/**
+	 * Records the tiers a plugin's tools need; a tool two plugins declare is a PluginError. A
+	 * plugin declaring its own tool again, as when the host retries its start, replaces it.
+	 */
 	declare(plugin: string, tiers: Readonly<Record<string, Tier>>): void {
 		for (const [tool, tier] of Object.entries(tiers)) {
 			const other = this.#declared.get(tool);
-			if (other)
+			if (other && other.plugin !== plugin)
 				throw new PluginError(
 					`plugin ${plugin}: tool ${tool} is already defined by plugin ${other.plugin}. Rename one of the two tools.`,
 				);
@@ -106,22 +85,3 @@ export function toolsForTier(
 ): string[] {
 	return tools.filter((tool) => tiers.allows(tier, tool));
 }
-
-/** Reads `tool=tier` pairs, comma-separated; unset means no changes. */
-export function parseToolTiers(
-	text: string | undefined,
-	name: string,
-): Record<string, Tier> {
-	const result: Record<string, Tier> = {};
-	for (const item of (text ?? "").split(",")) {
-		const pair = item.trim();
-		if (pair === "") continue;
-		const [tool, tier] = pair.split("=").map((part) => part.trim());
-		if (!tool || !tier || !(TIERS as readonly string[]).includes(tier))
-			throw new ConfigError(
-				`${name} must list tool=owner|admin|member pairs, got ${pair}`,
-			);
-		result[tool] = tier as Tier;
-	}
-	return result;
-}

package/src/discord/index.ts

@@ -0,0 +1,64 @@
+// The Discord entry: everything that names a discord.js type, apart from the main and kit entries.
+// Unstable before 1.0; not covered by semver.
+
+export type { DiscordServices } from "../core/builtin/discord.ts";
+export { DISCORD } from "../core/builtin/discord.ts";
+export type { AgentPanelMessage } from "../core/discord/agent-commands.ts";
+export type {
+	AgentPanel,
+	AgentPanelOptions,
+} from "../core/discord/agent-panel.ts";
+export { agentPanel } from "../core/discord/agent-panel.ts";
+export type { ManagedChannel } from "../core/discord/channel-executor.ts";
+export {
+	fetchManagedChannel,
+	OPERATION_PERMISSIONS,
+} from "../core/discord/channel-executor.ts";
+export type {
+	ChannelExecutor,
+	ChannelOperation,
+	ChannelTool,
+} from "../core/discord/channel-operations.ts";
+export {
+	CHANNEL_OPERATIONS,
+	CHANNEL_TOOLS,
+	ChannelToolError,
+	isChannelOperation,
+	operationLabel,
+	parseChannelTool,
+} from "../core/discord/channel-operations.ts";
+export type { ComposedCommands } from "../core/discord/compose-commands.ts";
+export { composeCommands } from "../core/discord/compose-commands.ts";
+export type {
+	ChannelInfo,
+	DiscordConnection,
+} from "../core/discord/connection.ts";
+export type {
+	CommandGuard,
+	CommandRegistrar,
+	CommandRoot,
+	InteractionContribution,
+	InteractionModule,
+	RootOption,
+} from "../core/discord/interaction-module.ts";
+export type {
+	CommandGuardOptions,
+	OwnerCommandHandlers,
+} from "../core/discord/owner-command.ts";
+export {
+	commandGuard,
+	groupOption,
+	ownerCommandModule,
+	ownerRootCommand,
+} from "../core/discord/owner-command.ts";
+export type { PanelContent } from "../core/discord/owner-panel.ts";
+export {
+	ephemeralPanel,
+	OwnerFacingError,
+	ownerPanel,
+	ownerPanels,
+	plain,
+	replyWithPanels,
+} from "../core/discord/owner-panel.ts";
+export type { OwnerOperations } from "../core/modules/discord-admin/discord-admin.ts";
+export { DISCORD_ADMIN_TOOLS } from "../core/modules/discord-admin/discord-admin.ts";

package/src/index.ts

@@ -1,28 +1,199 @@
 // The plugin author's stable entry; internals remain behind package exports.
 
-export type { AgentSeed } from "./core/agents/agent-store.ts";
-export type { RoundtableConfig } from "./core/config/config.ts";
-export type { ChannelClaim } from "./core/contract/channels.ts";
-export type { InteractionContribution } from "./core/contract/discord.ts";
-export type { Migration } from "./core/db/migrations.ts";
+export {
+	AGENT_SERVER_PRIORITY,
+	OWNER_TARGET,
+} from "./core/agents/agent-claim.ts";
+export type {
+	Agent,
+	AgentGroup,
+	AgentSeed,
+	AgentStatus,
+} from "./core/agents/agent-store.ts";
+export type { AvatarMode } from "./core/agents/agent-tools.ts";
+export type {
+	AgentStatus as TeamAgentStatus,
+	GroupStatus,
+	TeamStatus,
+} from "./core/agents/team-status.ts";
+export {
+	AGENT_SERVER_PLUGIN,
+	AGENT_TEAM_SERVICE,
+} from "./core/builtin/agent-server.ts";
+export type {
+	Pronouns,
+	RoundtableConfig,
+	TierConfig,
+} from "./core/config/config.ts";
+export type {
+	Admission,
+	AttachmentRef,
+	BackgroundTarget,
+	BackgroundTurn,
+	ChannelClaim,
+	ConversationKind,
+	ConversationPort,
+	InboundMessage,
+	QueuePort,
+	ScheduledOutcome,
+} from "./core/contract/channels.ts";
+export type {
+	ImageDrawer,
+	Judge,
+	Providers,
+	ReferenceImage,
+	ResolvedProviders,
+} from "./core/contract/providers.ts";
+export type {
+	AgentRuntime,
+	AgentSessions,
+	ContextUse,
+	HeldActionStore,
+	LoadedSkill,
+	RuntimeDeps,
+	RuntimeFactory,
+} from "./core/contract/runtime.ts";
+export type { ServiceKey, Services } from "./core/contract/services.ts";
+export { serviceKey } from "./core/contract/services.ts";
+export type { ChatSurface, SurfacePort } from "./core/contract/surface.ts";
+export { channelKey, parseChannelKey } from "./core/contract/surface.ts";
+export type { Migration, MigrationReport } from "./core/db/migrations.ts";
+export { migrateDatabase } from "./core/db/migrations.ts";
 export type { ToolContribution, ToolSpec, ToolTurn } from "./core/define.ts";
 export { definePlugin, defineTool, ToolRefusal } from "./core/define.ts";
-export type { DefinedRoundtable } from "./core/define-roundtable.ts";
+export type {
+	DefinedRoundtable,
+	DefineOverrides,
+} from "./core/define-roundtable.ts";
 export { defineRoundtable } from "./core/define-roundtable.ts";
-export { NotLinkedError, PluginError } from "./core/errors.ts";
-export type { HoldRule } from "./core/holds.ts";
-export type { RoundtableOptions } from "./core/host.ts";
+export type {
+	AttachmentFailure,
+	ModelImage,
+	StoredAttachment,
+	TurnAttachments,
+} from "./core/domain/attachment.ts";
+export { NO_ATTACHMENTS } from "./core/domain/attachment.ts";
+export type {
+	HeldCall,
+	OutboundReply,
+	PendingConfirmation,
+	TranscriptEntry,
+	TurnResult,
+} from "./core/domain/conversation.ts";
+export {
+	AgentRunError,
+	ConfigError,
+	DelegationError,
+	MemoryError,
+	ScheduleError,
+} from "./core/domain/errors.ts";
+export type {
+	Approval,
+	AskOption,
+	OwnerAnswer,
+	OwnerPrompts,
+	OwnerQuestion,
+} from "./core/domain/owner-prompts.ts";
+export type { TurnRequest } from "./core/domain/ports.ts";
+export type { DrainOptions } from "./core/drain.ts";
+export {
+	JudgeError,
+	MigrationError,
+	NotLinkedError,
+	PluginError,
+	ProviderError,
+} from "./core/errors.ts";
+export type { HoldCheck, HoldContext, HoldRule } from "./core/holds.ts";
+export type { HostEnvironment, RoundtableOptions } from "./core/host.ts";
 export { Roundtable } from "./core/host.ts";
+export type {
+	HttpRoute,
+	ListenerAddress,
+	ListenerConfig,
+} from "./core/http/listeners.ts";
+export type { Locale } from "./core/i18n/index.ts";
+export type { JudgeModel } from "./core/judging/model-judge.ts";
+export type { LogEntry, LogFn, Logger } from "./core/log.ts";
+export type { ThinkingLevel, ThinkingSetting } from "./core/models.ts";
+export type {
+	DelegationJob,
+	DelegationOutcome,
+} from "./core/modules/delegation/delegator.ts";
+export type {
+	Memory,
+	MemoryKind,
+	PromptMemory,
+} from "./core/modules/memory/owner-memory-store.ts";
+export { MEMORY_KINDS } from "./core/modules/memory/owner-memory-store.ts";
+export type {
+	Recurrence,
+	Weekday,
+} from "./core/modules/schedules/recurrence.ts";
+export type {
+	NewSchedule,
+	Schedule,
+	ScheduleChange,
+} from "./core/modules/schedules/schedule-store.ts";
+export type {
+	ResolvedSkill,
+	SkillCatalogEntry,
+	SkillSet,
+	SkillSource,
+} from "./core/modules/skills/skill-rules.ts";
 export type {
 	Contribution,
 	EventHandlers,
+	EventSink,
+	HostEnv,
+	LinkedSessions,
+	Persona,
 	PluginContext,
 	PromptSection,
 	PromptTurn,
 	RoundtablePlugin,
 	Service,
+	ServiceStartedEvent,
+	ServiceStartOutcome,
 	TurnEndEvent,
 	TurnEvent,
 } from "./core/plugin.ts";
-export type { SessionTool } from "./core/sessions.ts";
+export type {
+	ConversationTurnInput,
+	ConversationTurns,
+} from "./core/routing/conversation-turns.ts";
+export type {
+	AgentChange,
+	AgentDirectory,
+	AgentServer,
+	AgentTeam,
+	AvatarStudio,
+	BackgroundTurns,
+	DelegationRequest,
+	Delegator,
+	MemoryStore,
+	ScheduleStore,
+	SkillRegistry,
+	SpeakerMemory,
+} from "./core/services.ts";
+export {
+	AGENTS,
+	BACKGROUND_TURNS,
+	DELEGATION,
+	MEMORY,
+	SCHEDULES,
+	SKILLS,
+} from "./core/services.ts";
+export type {
+	AgentTurnScope,
+	ChannelKey,
+	SessionContext,
+	SessionPlan,
+	SessionTool,
+	SessionToolSnapshot,
+	ToolSelection,
+	TransientTask,
+	TurnSelection,
+} from "./core/sessions.ts";
 export type { Speaker, Tier } from "./core/speakers.ts";
+export { THE_SPEAKER, TIERS } from "./core/speakers.ts";
+export type { ToolTiers, ToolTierTable } from "./core/tool-tiers.ts";

package/src/kit/channels.ts

@@ -0,0 +1,14 @@
+// Unstable plugin helpers; see the plugin guide.
+
+export { discordKey } from "../core/agents/team-keys.ts";
+
+export {
+	channelSegment,
+	ownerAttachmentDir,
+} from "../core/attachments/attachment-dir.ts";
+export { withAttachmentsBlock } from "../core/attachments/prompt-block.ts";
+export { attachmentsOf } from "../core/attachments/turn-attachments.ts";
+export type { ChannelQueue } from "../core/routing/channel-queue.ts";
+export { channelQueue } from "../core/routing/channel-queue.ts";
+export { withReference } from "../core/routing/message-text.ts";
+export { outcome, settleTurn } from "../core/routing/settle-turn.ts";

package/src/kit/domain.ts

@@ -0,0 +1,18 @@
+// Unstable plugin helpers; see the plugin guide.
+
+export { AgentError } from "../core/domain/errors.ts";
+export type {
+	ChoiceAnswer,
+	ChoiceQuestion,
+	ScoreQuestion,
+	YesNoQuestion,
+} from "../core/domain/ports.ts";
+export type { OwnerIdentity } from "../core/identity.ts";
+export type { ModelRef } from "../core/models.ts";
+export {
+	AUTO_THINKING,
+	formatModelRef,
+	parseModelRef,
+	THINKING_LEVELS,
+	thinkingLabel,
+} from "../core/models.ts";