@animalabs/agent-framework 0.6.5 → 0.6.7

package/src/types/events.ts

@@ -226,6 +226,7 @@ export interface McplPushEvent {
   eventId: string;
   content: ContentBlock[];
   origin?: Record<string, unknown>;
+  tags?: string[];
   timestamp: string;
   inferenceId: string;
   triggerInference?: boolean;
@@ -249,4 +250,3 @@ export interface McplChannelIncomingEvent {
   triggerInference?: boolean;
   targetAgents?: string[];
 }
-

package/src/types/framework.ts

@@ -42,6 +42,23 @@ export interface FrameworkConfig {
   /** Path to Chronicle store */
   storePath?: string;
 
+  /**
+   * Branch-independent Discord awareness-marker outbox. Defaults to
+   * `<storePath>/recovery/discord-awareness-outbox.json`. Set explicitly when
+   * providing an app-owned `store` without `storePath`; omit to disable.
+   */
+  discordAwarenessOutboxPath?: string;
+
+  /** Emoji used for branch-awareness markers (default: 💤). */
+  discordAwarenessEmoji?: string;
+
+  /**
+   * Mandatory deadline for each Discord awareness marker tools/call. This is
+   * independent of MCPL requestTimeoutMs and cannot be disabled with 0.
+   * Values are clamped to 50..60000ms; 0 selects the 10000ms default.
+   */
+  discordAwarenessDeadlineMs?: number;
+
   /** Or existing store (app-owned) */
   store?: JsStore;
 

package/src/types/module.ts

@@ -96,6 +96,39 @@ export interface Module {
    * Adapted from Anarchid/agent-framework@mcpl-module-proto.
    */
   gatherContext?(agentName: string): Promise<ContextInjection[]>;
+
+  /**
+   * Declare extra settings for the synthesized `agent_settings` tool.
+   * Modules owning hot-tunable runtime state (e.g. a host settings module
+   * managing extended-thinking toggles) expose it here instead of registering
+   * their own tools — one settings surface for the agent instead of N.
+   * The framework merges the declared fields into agent_settings' schema and
+   * routes get/update/reset for the declared keys back to the extension.
+   */
+  getAgentSettingsExtension?(): AgentSettingsExtension;
+}
+
+/**
+ * A module-owned extension of the `agent_settings` tool: extra hot-tunable
+ * fields merged into the tool schema, with get/update/reset routed to the
+ * declaring module. Keys must not collide with the core settings
+ * (context_budget_tokens, tail_tokens, transition_pace_tokens) or with other
+ * extensions — colliding extensions are skipped loudly.
+ */
+export interface AgentSettingsExtension {
+  /** JSON-schema property definitions for the extension's fields, merged into
+   *  the agent_settings input schema (e.g. { reasoning_enabled: { type: 'boolean', … } }). */
+  properties: Record<string, unknown>;
+  /** The setting keys this extension owns (must match `properties` keys). */
+  keys: string[];
+  /** Current values for the extension's keys. */
+  get(agentName: string): Record<string, unknown>;
+  /** Apply a partial update (only this extension's keys present) and return
+   *  the new values. Throw to surface a validation error to the agent. */
+  update(agentName: string, patch: Record<string, unknown>): Record<string, unknown>;
+  /** Restore the listed keys (or all when omitted) to defaults and return the
+   *  new values. Optional — extensions without reset semantics are skipped. */
+  reset?(agentName: string, keys?: string[]): Record<string, unknown>;
 }
 
 /**

package/src/types/trace.ts

@@ -109,6 +109,8 @@ export type TraceEvent =
   | (TraceEventBase & {
       type: 'inference:stream_resumed';
       agentName: string;
+      /** Count of mid-turn messages injected into the resumed round (hear-while-acting). */
+      injectedMessages?: number;
     })
   | (TraceEventBase & {
       type: 'inference:stream_restarted';
@@ -317,6 +319,8 @@ export type TraceEvent =
       serverId: string;
       /** The JSON-RPC id of the late response whose pending request already timed out. */
       responseId: string | number;
+      /** Original request method when retained for mandatory-deadline visibility. */
+      method?: string;
       /** True when the dropped response carried host-managed `state`. */
       hadState: boolean;
       /** True when the dropped response carried a server-managed `checkpoint`. */