@prometheus-ai/agent 0.5.3 → 0.5.8

package/dist/types/extensibility/extensions/types.d.ts

@@ -7,25 +7,27 @@
  * - Register commands, keyboard shortcuts, and CLI flags
  * - Interact with the user via UI primitives
  */
-import type * as piCodingAgent from "@prometheus-ai/agent";
-import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel } from "@prometheus-ai/agent-core";
+import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolApproval } from "@prometheus-ai/agent-core";
 import type { CompactionResult } from "@prometheus-ai/agent-core/compaction";
-import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@prometheus-ai/ai";
-import type { OAuthCredentials, OAuthLoginCallbacks } from "@prometheus-ai/ai/utils/oauth/types";
+import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ModelSpec, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@prometheus-ai/ai";
+import type { OAuthCredentials, OAuthLoginCallbacks } from "@prometheus-ai/ai/oauth/types";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@prometheus-ai/tui";
 import type { logger as PiLogger } from "@prometheus-ai/utils";
-import type * as Zod from "zod/v4";
+import type { z } from "zod/v4";
 import type { KeybindingsManager } from "../../config/keybindings";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
 import type { PythonResult } from "../../eval/py/executor";
 import type { BashResult } from "../../exec/bash-executor";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
+import type * as PiCodingAgent from "../../index";
+import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { CustomEditor } from "../../modes/components/custom-editor";
 import type { Theme } from "../../modes/theme/theme";
 import type { CustomMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
 import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
+import type { ApprovalMode } from "../../tools/approval";
 import type { EventBus } from "../../utils/event-bus";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type { SlashCommandInfo } from "../slash-commands";
@@ -172,6 +174,31 @@ export interface CompactOptions {
 /**
  * Context passed to extension event handlers.
  */
+/**
+ * Read-only model query facade exposed at `ctx.models`. Lets an extension select a
+ * model the same way core does — list authenticated models, read the session model,
+ * resolve a model string or role alias, and compare model families — without reaching
+ * into the mutable registry or re-implementing matching/family heuristics.
+ */
+export interface ExtensionModelQuery {
+    /** Authenticated models available this session (the same set `--model` selection sees). */
+    list(): Model[];
+    /** The current session model, if one is set. */
+    current(): Model | undefined;
+    /**
+     * Resolve a model string (`provider/id`, bare id) or role alias (`pi/slow`, a
+     * configured role) to a Model, using the same settings-backed aliases and match
+     * preferences as core selection. Thinking/routing suffixes are accepted and resolved
+     * to the base model (pass effort separately). Returns undefined when nothing matches.
+     */
+    resolve(spec: string): Model | undefined;
+    /**
+     * Opaque lineage token for "are these the same family?" comparisons — every Claude
+     * point release shares a token, Claude and GPT differ. Backed by catalog canonical
+     * identity. Compare it; do not persist it (the vocabulary tracks new releases).
+     */
+    family(model: Model): string;
+}
 export interface ExtensionContext {
     /** UI methods for user interaction */
     ui: ExtensionUIContext;
@@ -189,6 +216,8 @@ export interface ExtensionContext {
     modelRegistry: ModelRegistry;
     /** Current model (may be undefined) */
     model: Model | undefined;
+    /** Read-only model query facade: list / current / resolve / family. */
+    models: ExtensionModelQuery;
     /** Whether the agent is idle (not streaming) */
     isIdle(): boolean;
     /** Abort the current agent operation */
@@ -199,6 +228,8 @@ export interface ExtensionContext {
     shutdown(): void;
     /** Get the current effective system prompt. */
     getSystemPrompt(): string[];
+    /** Structured memory runtime for status/search/save across the configured backend. */
+    memory?: MemoryRuntimeContext;
 }
 /**
  * Extended context for command handlers.
@@ -270,6 +301,9 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     defaultInactive?: boolean;
     /** If true, tool may stage deferred changes that require explicit resolve/discard. */
     deferrable?: boolean;
+    /** Tool approval tier. Defaults to `"exec"` when omitted.
+     *  `"read"`: read-only operations. `"write"`: mutations. `"exec"`: code execution. */
+    approval?: ToolApproval;
     /** MCP server name for discovery/search metadata when this tool fronts an MCP server. */
     mcpServerName?: string;
     /** Original MCP tool name for discovery/search metadata. */
@@ -390,6 +424,22 @@ export interface InputEvent {
     images?: ImageContent[];
     source: "interactive" | "rpc" | "extension";
 }
+export interface ToolApprovalRequestedEvent {
+    type: "tool_approval_requested";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    reason?: string;
+    approvalMode: ApprovalMode;
+}
+export interface ToolApprovalResolvedEvent {
+    type: "tool_approval_resolved";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    approved: boolean;
+    reason?: string;
+}
 interface ToolCallEventBase {
     type: "tool_call";
     toolCallId: string;
@@ -492,7 +542,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent;
+export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -552,9 +602,11 @@ export interface ExtensionAPI {
     /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
     typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored extension tools (canonical going forward). */
-    zod: typeof Zod;
-    /** Injected coding-agent exports for accessing SDK utilities */
-    pi: typeof piCodingAgent;
+    zod: typeof z;
+    /** Injected Prometheus coding agent exports for accessing SDK utilities */
+    prometheus: typeof PiCodingAgent;
+    /** Legacy alias for injected Prometheus coding agent exports */
+    pi: typeof PiCodingAgent;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
     on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
     on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
@@ -590,6 +642,8 @@ export interface ExtensionAPI {
     on(event: "goal_updated", handler: ExtensionHandler<GoalUpdatedEvent>): void;
     on(event: "credential_disabled", handler: ExtensionHandler<CredentialDisabledEvent>): void;
     on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): void;
+    on(event: "tool_approval_requested", handler: ExtensionHandler<ToolApprovalRequestedEvent>): void;
+    on(event: "tool_approval_resolved", handler: ExtensionHandler<ToolApprovalResolvedEvent>): void;
     on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
     on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
     on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
@@ -677,7 +731,7 @@ export interface ExtensionAPI {
      *       id: "claude-sonnet-4@20250514",
      *       name: "Claude Sonnet 4 (Vertex)",
      *       reasoning: true,
-     *       thinking: { mode: "anthropic-adaptive", minLevel: "minimal", maxLevel: "high" },
+     *       thinking: { mode: "anthropic-adaptive", efforts: ["minimal", "low", "medium", "high"] },
      *       input: ["text", "image"],
      *       cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
      *       contextWindow: 200000,
@@ -724,6 +778,13 @@ export interface ProviderConfig {
         /** Optional model rewrite hook for credential-aware routing (e.g., enterprise URLs). */
         modifyModels?(models: Model<Api>[], credentials: OAuthCredentials): Model<Api>[];
     };
+    /**
+     * Async factory that fetches the live model list from the provider endpoint.
+     * Runs through the same SQLite model-cache as built-in providers (keyed by
+     * provider name, default 24 h TTL). Receives the resolved API key (undefined
+     * when unauthenticated). Mutually exclusive with `models`.
+     */
+    fetchDynamicModels?: (apiKey: string | undefined) => Promise<readonly ProviderModelConfig[]>;
 }
 /** Configuration for a model within a provider. */
 export interface ProviderModelConfig {
@@ -755,7 +816,7 @@ export interface ProviderModelConfig {
     /** Custom headers for this model. */
     headers?: Record<string, string>;
     /** OpenAI compatibility settings. */
-    compat?: Model<Api>["compat"];
+    compat?: ModelSpec<Api>["compat"];
 }
 /** Extension factory function type. Supports both sync and async initialization. */
 export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;

package/dist/types/extensibility/hooks/index.d.ts

@@ -1,4 +1,5 @@
-export type { ReadonlySessionManager, UsageStatistics } from "../../session/session-manager";
+export type { UsageStatistics } from "../../session/session-entries";
+export type { ReadonlySessionManager } from "../../session/session-manager";
 export * from "./loader";
 export * from "./runner";
 export * from "./tool-wrapper";

package/dist/types/extensibility/hooks/loader.d.ts

@@ -79,7 +79,7 @@ export declare function loadHooks(paths: string[], cwd: string): Promise<LoadHoo
 /**
  * Discover and load hooks from all registered providers.
  * Uses the capability API to discover hook paths from:
- * 1. Prometheus native configs and compatibility hook roots
+ * 1. Prometheus native configs (.prometheus/.prometheus hooks/)
  * 2. Installed plugins
  * 3. Other editor/IDE configurations
  *

package/dist/types/extensibility/hooks/types.d.ts

@@ -1,13 +1,17 @@
 import type { ImageContent, Message, Model, TextContent } from "@prometheus-ai/ai";
 import type { Component, TUI } from "@prometheus-ai/tui";
+import type { logger as PiLogger } from "@prometheus-ai/utils";
+import type { z } from "zod/v4";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
+import type * as PiCodingAgent from "../../index";
 import type { Theme } from "../../modes/theme/theme";
 import type { HookMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
 import type { BashToolDetails, FindToolDetails, ReadToolDetails, SearchToolDetails } from "../../tools";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+import type * as TypeBox from "../typebox";
 export type { ExecOptions, ExecResult } from "../../exec/exec";
 /**
  * UI context for hooks to request interactive UI from the harness.
@@ -412,13 +416,15 @@ export interface HookAPI {
      */
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** File logger for error/warning/debug messages */
-    logger: typeof import("@prometheus-ai/utils").logger;
+    logger: typeof PiLogger;
     /** Injected zod-backed typebox shim (legacy/compat — prefer `zod`). */
-    typebox: typeof import("../typebox");
+    typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored hooks. */
-    zod: typeof import("zod/v4");
-    /** Injected coding-agent exports */
-    pi: typeof import("../..");
+    zod: typeof z;
+    /** Injected Prometheus coding agent exports */
+    prometheus: typeof PiCodingAgent;
+    /** Legacy alias for injected Prometheus coding agent exports */
+    pi: typeof PiCodingAgent;
 }
 /**
  * Hook factory function type.

package/dist/types/extensibility/{legacy-pi-ai-shim.d.ts → legacy-package-ai-shim.d.ts}

@@ -6,9 +6,9 @@
  * pi-ai 15.1.0 removed the historical TypeBox root exports (`Type`, plus the
  * runtime-relevant half of the `Static`/`TSchema` pair) from the package
  * entrypoint. Legacy extensions still author parameter schemas as
- * `Type.Object({ ... })`, so this file is served by `legacy-pi-compat.ts` in
+ * `Type.Object({ ... })`, so this file is served by `legacy-package-compat.ts` in
  * place of the real pi-ai entrypoint whenever a legacy extension imports the
- * bare package root. Subpath imports (`@prometheus-ai/ai/utils/oauth`, etc.)
+ * bare package root. Subpath imports (`@prometheus-ai/ai/oauth`, etc.)
  * continue to resolve directly against the bundled pi-ai package.
  *
  * The `Type` runtime is borrowed from the Zod-backed TypeBox shim that

package/dist/types/extensibility/plugins/{legacy-pi-compat.d.ts → legacy-package-compat.d.ts}

@@ -13,6 +13,23 @@ import * as path from "node:path";
  * Exported for tests; production callers use `BUNFS_PACKAGE_ROOT` below.
  */
 export declare function __computeBunfsPackageRoot(metaDir: string, pathImpl?: typeof path): string;
+/**
+ * Compute the package root for the npm prebuilt `dist/cli.js` bundle.
+ *
+ * `bundle-dist.ts` defines `process.env.PROMETHEUS_BUNDLED="true"`; after bundling,
+ * `import.meta.dir` points at `<package>/dist`. Do not resolve the package via
+ * bare `@prometheus-ai/agent` here: from a global install Bun can pick an
+ * older cache entry, recreating mixed-runtime plugin loading.
+ */
+export declare function __computeBundledSelfPackageRoot(metaDir: string, pathImpl?: typeof path): string;
+/**
+ * Drop overrides whose targets are missing on disk so they can fall through to
+ * the canonical-resolution path. Exported for the test seam in #2168.
+ *
+ * `pathExistsSync` defaults to `fs.existsSync`; the tests inject a stub to
+ * simulate the missing-entrypoint failure mode without touching the real FS.
+ */
+export declare function __validateLegacyPackagePackageRootOverrides(candidates: Record<string, string>, pathExistsSync?: (p: string) => boolean): Record<string, string>;
 /**
  * Load a legacy Pi extension module from its real on-disk location.
  *
@@ -23,7 +40,7 @@ export declare function __computeBunfsPackageRoot(metaDir: string, pathImpl?: ty
  * entry's source graph rewrites only host-resolved compatibility imports in the
  * extension's own source; everything else resolves natively.
  */
-export declare function loadLegacyPiModule(resolvedPath: string): Promise<unknown>;
-export declare function installLegacyPiSpecifierShim(): void;
+export declare function loadLegacyPackageModule(resolvedPath: string): Promise<unknown>;
+export declare function installLegacyPackageSpecifierShim(): void;
 /** Test seam: clears the memoized canonical specifier resolutions. */
-export declare function __resetLegacyPiResolutionCache(): void;
+export declare function __resetLegacyPackageResolutionCache(): void;

package/dist/types/extensibility/plugins/loader.d.ts

@@ -14,6 +14,17 @@ import type { InstalledPlugin } from "./types";
 export declare function getEnabledPlugins(cwd: string, opts?: {
     home?: string;
 }): Promise<InstalledPlugin[]>;
+/**
+ * Declared manifest entries paired with their resolved file path. Returns one
+ * record per declared entry — base entries first, then enabled-feature entries
+ * — so callers (e.g. install-time validation) can detect manifest entries that
+ * point at missing files instead of silently skipping them like
+ * {@link resolvePluginPaths} does.
+ */
+export declare function resolvePluginManifestEntries(plugin: InstalledPlugin, key: "tools" | "hooks" | "commands" | "extensions"): Array<{
+    entry: string;
+    resolvedPath: string | null;
+}>;
 export declare function resolvePluginToolPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginHookPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginCommandPaths(plugin: InstalledPlugin): string[];

package/dist/types/extensibility/plugins/marketplace-auto-update.d.ts

@@ -0,0 +1,8 @@
+type MarketplaceAutoUpdateMode = "off" | "notify" | "auto";
+interface MarketplaceAutoUpdateOptions {
+    autoUpdate: MarketplaceAutoUpdateMode;
+    resolveActiveProjectRegistryPath: (cwd: string) => Promise<string | null>;
+    clearPluginRootsCache: () => void;
+}
+export declare function scheduleMarketplaceAutoUpdate(options: MarketplaceAutoUpdateOptions): void;
+export {};

package/dist/types/extensibility/plugins/types.d.ts

@@ -17,7 +17,7 @@ export interface PluginFeature {
     commands?: string[];
 }
 /**
- * Plugin manifest from package.json prometheus field. The legacy pi field is still accepted by the loader.
+ * Plugin manifest from package.json prometheus or pi field.
  */
 export interface PluginManifest {
     /** Plugin display name (defaults to package name) */
@@ -82,7 +82,7 @@ export interface InstalledPlugin {
     version: string;
     /** Absolute path to package directory */
     path: string;
-    /** Parsed Prometheus plugin manifest */
+    /** Parsed prometheus/pi manifest */
     manifest: PluginManifest;
     /**
      * Enabled features:

package/dist/types/extensibility/shared-events.d.ts

@@ -17,7 +17,7 @@ import type { CompactionPreparation, CompactionResult } from "@prometheus-ai/age
 import type { ImageContent, TextContent, ToolResultMessage } from "@prometheus-ai/ai";
 import type { Rule } from "../capability/rule";
 import type { Goal, GoalModeState } from "../goals/state";
-import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-manager";
+import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-entries";
 import type { TodoItem } from "../tools/todo";
 /** Fired on initial session load */
 export interface SessionStartEvent {
@@ -160,12 +160,12 @@ export interface TurnEndEvent {
 export interface AutoCompactionStartEvent {
     type: "auto_compaction_start";
     reason: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
 }
 /** Fired when auto-compaction ends */
 export interface AutoCompactionEndEvent {
     type: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;

package/dist/types/extensibility/skills.d.ts

@@ -33,6 +33,16 @@ export declare function getActiveSkills(): readonly Skill[];
 export declare function setActiveSkills(value: readonly Skill[]): void;
 /** Reset the active skill snapshot. Test-only. */
 export declare function resetActiveSkillsForTests(): void;
+/**
+ * Whether `name` is already claimed by an active authored (non-managed) skill.
+ *
+ * Managed (auto-learn) skills resolve dead-last in discovery, so an authored
+ * skill of the same name always wins (see `loadSkills`) and a managed skill
+ * written under an authored name is silently dropped — it never surfaces.
+ * `manage_skill` create consults this to refuse the write up front instead of
+ * reporting a false "Created" for a skill that can never appear.
+ */
+export declare function isNameClaimedByAuthoredSkill(name: string): boolean;
 export interface LoadSkillsFromDirOptions {
     /** Directory to scan for skills */
     dir: string;

package/dist/types/extensibility/slash-commands.d.ts

@@ -1,5 +1,3 @@
-import type { AutocompleteItem } from "@prometheus-ai/tui";
-import { type BuiltinSlashCommand } from "../slash-commands/builtin-registry";
 export type SlashCommandSource = "extension" | "prompt" | "skill";
 export type SlashCommandLocation = "user" | "project" | "path";
 export interface SlashCommandInfo {
@@ -9,15 +7,7 @@ export interface SlashCommandInfo {
     location?: SlashCommandLocation;
     path?: string;
 }
-export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/builtin-registry";
-/**
- * Materialized builtin slash commands with completion functions derived from
- * declarative subcommand/hint definitions.
- */
-export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand & {
-    getArgumentCompletions?: (prefix: string) => AutocompleteItem[] | null;
-    getInlineHint?: (argumentText: string) => string | null;
-}>;
+export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/types";
 /**
  * Represents a custom slash command loaded from a file
  */

package/dist/types/gateway/adapters/telegram/access.d.ts

@@ -1,11 +1,14 @@
 import type { GatewayEvent } from "../../types";
 export interface TelegramGatewayAccessPolicy {
     allowedUserIds: string[];
+    allowedChatIds?: string[];
 }
 export type TelegramGatewayAuthorizer = (event: GatewayEvent) => boolean | Promise<boolean>;
-export declare function createTelegramUserAllowlistPolicy(userIds: Iterable<string>): TelegramGatewayAccessPolicy | undefined;
+export declare function createTelegramUserAllowlistPolicy(userIds: Iterable<string>, chatIds?: Iterable<string>): TelegramGatewayAccessPolicy | undefined;
 export declare function isTelegramGatewayAccessRestricted(policy: TelegramGatewayAccessPolicy | undefined): boolean;
 export declare function isTelegramGatewayEventAuthorized(event: GatewayEvent, policy: TelegramGatewayAccessPolicy | undefined): boolean;
 export declare function normalizeTelegramUserIds(userIds: Iterable<string>): string[];
+export declare function normalizeTelegramChatIds(chatIds: Iterable<string>): string[];
 export declare function normalizeTelegramPositiveIntegerId(value: string, label: string): string;
+export declare function normalizeTelegramSignedIntegerId(value: string, label: string): string;
 export declare function toTelegramPositiveIntegerId(value: string, label: string): number;

package/dist/types/gateway/adapters/telegram/setup-api.d.ts

@@ -1,6 +1,6 @@
 import { type TelegramFetch } from "./send-message";
 import type { TelegramUpdate, TelegramUser } from "./types";
-export declare const TELEGRAM_GATEWAY_ALLOWED_UPDATES: readonly ["message", "callback_query"];
+export declare const TELEGRAM_GATEWAY_ALLOWED_UPDATES: readonly ["message", "edited_message", "channel_post", "edited_channel_post", "callback_query"];
 export interface TelegramSetupApiOptions {
     apiBaseUrl?: string;
     fetch?: TelegramFetch;

package/dist/types/gateway/adapters/telegram/webhook.d.ts

@@ -4,7 +4,7 @@ import type { TelegramUpdate } from "./types";
 export declare const TELEGRAM_WEBHOOK_SECRET_HEADER = "X-Telegram-Bot-Api-Secret-Token";
 export declare const TELEGRAM_UPDATE_TYPES: readonly ["message", "edited_message", "channel_post", "edited_channel_post", "business_connection", "business_message", "edited_business_message", "deleted_business_messages", "message_reaction", "message_reaction_count", "inline_query", "chosen_inline_result", "callback_query", "shipping_query", "pre_checkout_query", "purchased_paid_media", "poll", "poll_answer", "my_chat_member", "chat_member", "chat_join_request", "chat_boost", "removed_chat_boost", "managed_bot", "guest_message"];
 export type TelegramUpdateType = (typeof TELEGRAM_UPDATE_TYPES)[number];
-export type TelegramRoutableUpdateType = "message" | "callback_query";
+export type TelegramRoutableUpdateType = "message" | "edited_message" | "channel_post" | "edited_channel_post" | "callback_query";
 export type TelegramWebhookIgnoreReason = "unsupported_update_type" | "unknown_update_type" | "unroutable_message" | "unroutable_callback_query" | "duplicate_update";
 type TelegramWebhookErrorStatus = 400 | 401 | 405 | 500;
 export interface TelegramWebhookOptions extends TelegramNormalizeOptions {

package/dist/types/gateway/types.d.ts

@@ -1,7 +1,7 @@
 export type GatewayPlatform = "telegram";
 export type GatewayChatType = "direct" | "group" | "supergroup" | "channel";
 export type GatewayParticipantScope = "shared" | "per-user";
-export type GatewayEventKind = "message" | "callback_query";
+export type GatewayEventKind = "message" | "edited_message" | "channel_post" | "edited_channel_post" | "callback_query";
 export interface GatewayCallbackInteraction {
     type: "callback_query";
     id: string;

package/dist/types/goals/guided-setup.d.ts

@@ -0,0 +1,18 @@
+import type { AgentSession } from "../session/agent-session";
+export interface GuidedGoalMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export type GuidedGoalTurnResult = {
+    kind: "question";
+    question: string;
+    objective?: string;
+} | {
+    kind: "ready";
+    objective: string;
+};
+export interface GuidedGoalTurnOptions {
+    messages: readonly GuidedGoalMessage[];
+    signal?: AbortSignal;
+}
+export declare function runGuidedGoalTurn(session: AgentSession, options: GuidedGoalTurnOptions): Promise<GuidedGoalTurnResult>;

package/dist/types/goals/state.d.ts

@@ -1,4 +1,4 @@
-import type { UsageStatistics } from "../session/session-manager";
+import type { UsageStatistics } from "../session/session-entries";
 export type GoalStatus = "active" | "paused" | "budget-limited" | "complete" | "dropped";
 export interface Goal {
     id: string;

package/dist/types/goals/tools/goal-tool.d.ts

@@ -1,6 +1,6 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@prometheus-ai/agent-core";
 import type { Component } from "@prometheus-ai/tui";
-import * as z from "zod/v4";
+import { z } from "zod/v4";
 import type { RenderResultOptions } from "../../extensibility/custom-tools/types";
 import type { Theme } from "../../modes/theme/theme";
 import type { ToolSession } from "../../tools";

package/dist/types/hindsight/mental-models.d.ts

@@ -26,8 +26,10 @@
  * retain side to emit them.
  *
  * Seed tags are baked from `seeds.json` plus, for `projectTagged: true`
- * entries, the active scope's `retainTags` (i.e. `project:<cwd>`). Untagged
- * seeds (e.g. `user-preferences`) read every memory in the bank — the
+ * entries, the active scope's `retainTags` (i.e. `project:<cwd>`). In
+ * `per-project-tagged`, those project seeds also get project-suffixed ids so
+ * each tag can own its conventions/decisions models in the shared bank.
+ * Untagged seeds (e.g. `user-preferences`) read every memory in the bank — the
  * reflect call applies no tag filter when `tags` is empty.
  *
  * Seed lifecycle is **create-only**: changes to `source_query`, `tags`,
@@ -58,12 +60,16 @@ export interface MentalModelSeed {
     sourceQuery: string;
     tags: string[];
     maxTokens?: number;
+    /** Legacy unqualified seed ids accepted as already-present when tags match. */
+    legacyIds?: string[];
     trigger?: MentalModelTrigger;
 }
 /**
  * Resolve the seed list that applies to the active bank scope. Per-project
  * seeds are skipped in `global` mode (where there is no project axis) and
- * `projectTagged` seeds inherit the scope's `retainTags`.
+ * `projectTagged` seeds inherit the scope's `retainTags`. In shared tagged
+ * banks, project seeds use project-suffixed ids and accept matching legacy
+ * bare ids as already present.
  */
 export declare function resolveSeedsForScope(scope: BankScope, scoping: HindsightScoping): MentalModelSeed[];
 /**
@@ -75,6 +81,8 @@ export declare function resolveSeedsForScope(scope: BankScope, scoping: Hindsigh
  * Existing models are NEVER modified. See module docstring.
  */
 export declare function ensureMentalModels(client: HindsightApi, bankId: string, seeds: MentalModelSeed[], debug: boolean): Promise<void>;
+/** Return whether a seed is already represented by current bank metadata. */
+export declare function seedAlreadyExists(seed: MentalModelSeed, models: readonly MentalModelSummary[]): boolean;
 /**
  * Default character budget for the rendered `<mental_models>` block. Mental
  * models are injected on every prompt rebuild; an unbounded block can crowd
@@ -93,12 +101,13 @@ export declare const MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT = 16000;
  * reflect for a freshly-seeded model hasn't completed yet).
  *
  * The rendered block is bounded by `budgetChars` (default
- * MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT). Per-model content is truncated
- * before assembly; if assembly still exceeds the budget, trailing models are
- * dropped. A budget overflow leaves a `…` marker so the LLM can tell the
- * snapshot is truncated.
+ * MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT). When `visibleTags` is supplied,
+ * tagged models must match at least one active tag; untagged models remain
+ * visible in every scope. Per-model content is truncated before assembly; if
+ * assembly still exceeds the budget, trailing models are dropped. A budget
+ * overflow leaves a `…` marker so the LLM can tell the snapshot is truncated.
  */
-export declare function loadMentalModelsBlock(client: HindsightApi, bankId: string, budgetChars?: number): Promise<string | undefined>;
+export declare function loadMentalModelsBlock(client: HindsightApi, bankId: string, budgetChars?: number, visibleTags?: readonly string[]): Promise<string | undefined>;
 export declare function renderMentalModelsBlock(models: MentalModelSummary[], budgetChars: number): string;
 /** Inventory line used by the `/memory mm list` command. */
 export declare function summarizeMentalModel(model: MentalModelSummary): string;

package/dist/types/hindsight/transcript.d.ts

@@ -6,7 +6,7 @@
  * messages, and anything else that isn't a primary conversation turn. Each
  * surviving message's `TextContent` parts are joined with newlines.
  */
-import type { SessionEntry } from "../session/session-manager";
+import type { SessionEntry } from "../session/session-entries";
 import type { HindsightMessage } from "./content";
 export interface ReadonlySessionManagerLike {
     getEntries(): SessionEntry[];

package/dist/types/index.d.ts

@@ -25,8 +25,13 @@ export * from "./session/auth-storage";
 export * from "./session/indexed-session-storage";
 export * from "./session/messages";
 export * from "./session/redis-session-storage";
+export * from "./session/session-context";
 export * from "./session/session-dump-format";
+export * from "./session/session-entries";
+export * from "./session/session-listing";
+export * from "./session/session-loader";
 export * from "./session/session-manager";
+export * from "./session/session-migrations";
 export * from "./session/session-storage";
 export * from "./session/sql-session-storage";
 export * from "./task/executor";

package/dist/types/internal-urls/artifact-protocol.d.ts

@@ -1,7 +1,7 @@
-import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion } from "./types";
 export declare class ArtifactProtocolHandler implements ProtocolHandler {
     readonly scheme = "artifact";
     readonly immutable = true;
-    resolve(url: InternalUrl): Promise<InternalResource>;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
     complete(): Promise<UrlCompletion[]>;
 }

package/dist/types/internal-urls/history-protocol.d.ts

@@ -0,0 +1,14 @@
+import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+/**
+ * Handler for history:// URLs.
+ *
+ * Resolves agent ids against the global AgentRegistry, serving transcripts
+ * for both live and parked agents.
+ */
+export declare class HistoryProtocolHandler implements ProtocolHandler {
+    #private;
+    readonly scheme = "history";
+    readonly immutable = false;
+    resolve(url: InternalUrl): Promise<InternalResource>;
+    complete(): Promise<UrlCompletion[]>;
+}

package/dist/types/internal-urls/index.d.ts

@@ -9,6 +9,7 @@
  */
 export * from "./agent-protocol";
 export * from "./artifact-protocol";
+export * from "./history-protocol";
 export * from "./issue-pr-protocol";
 export * from "./json-query";
 export * from "./local-protocol";

package/dist/types/internal-urls/local-protocol.d.ts

@@ -3,8 +3,20 @@ export interface LocalProtocolOptions {
     getArtifactsDir?: () => string | null;
     getSessionId?: () => string | null;
 }
-export declare function resolveLocalRoot(options: LocalProtocolOptions): string;
-export declare function resolveLocalUrlToPath(input: string | InternalUrl, options: LocalProtocolOptions): string;
+/** Resolve the session-scoped local:// root, shortening long Windows artifact paths before writes hit MAX_PATH. */
+export declare function resolveLocalRoot(options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
+/** Resolve a local:// URL to an on-disk path under the active session's local root. */
+export declare function resolveLocalUrlToPath(input: string | InternalUrl, options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
+/**
+ * On-disk roots the eval helpers (`read`/`write`/`append`) substitute for
+ * internal-URL schemes so e.g. `write("local://x.md")` lands where a later
+ * `read local://x.md` resolves — instead of a literal `local:/` directory under
+ * the cwd (a stdlib `pathlib.Path`/`path.resolve` collapses `local://` to
+ * `local:/`). Keyed by scheme without the `://`. Currently only `local`, but the
+ * shape is a map so additional file-backed schemes can be added without
+ * re-plumbing the worker boundary.
+ */
+export declare function buildEvalUrlRoots(options: LocalProtocolOptions): Record<string, string>;
 /**
  * Protocol handler for local:// URLs.
  *