@takeshape/schema 11.91.0 → 11.92.0

package/dist/agents.d.ts

@@ -1,5 +1,12 @@
 import type { AgentAPI, AgentAPIArgument, AgentJSON, Args, ProjectSchemaJSON } from './project-schema/index.ts';
+/**
+ * Special transition destination ID for agent transitions that end the agent execution.
+ */
 export declare const END_AGENT_EXECUTION = "endAgentExecution";
+/**
+ * Special history strategy ID that indicates the history should be cleared.
+ */
+export declare const CLEAR_HISTORY_STRATEGY_ID = "clearHistory";
 export declare const BUILT_IN_CHAT_ARGS: AgentAPIArgument[];
 export declare const BUILT_IN_CHAT_ARG_NAMES: string[];
 export type AgentEndTransition = {

package/dist/agents.js

@@ -1,7 +1,14 @@
 import uniq from 'lodash/uniq.js';
 import uniqBy from 'lodash/uniqBy.js';
 import upperFirst from 'lodash/upperFirst.js';
+/**
+ * Special transition destination ID for agent transitions that end the agent execution.
+ */
 export const END_AGENT_EXECUTION = 'endAgentExecution';
+/**
+ * Special history strategy ID that indicates the history should be cleared.
+ */
+export const CLEAR_HISTORY_STRATEGY_ID = 'clearHistory';
 export const BUILT_IN_CHAT_ARGS = [
     {
         argName: 'input',

package/dist/builtin-schema.js

@@ -382,7 +382,9 @@ export const builtInShapes = {
                 chatSessionIds: { type: 'object' },
                 sessionMemory: { type: 'object' },
                 stateOutputs: { type: 'object' },
-                currentValue: { type: 'object' }
+                currentValue: { type: 'object' },
+                userHistory: { type: 'array', items: { type: 'object' } },
+                agentHistory: { type: 'array', items: { type: 'object' } }
             }
         }
     },

package/dist/project-schema/latest.d.ts

@@ -360,10 +360,11 @@ export type RemovePropertyKeyPatterns = MinimatchPattern[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdown = boolean;
-export type AgentChatHistoryConfig = AgentChatHistoryRetain | AgentChatHistorySummarize | AgentChatHistoryClear;
 export type AgentStateSessionMemoryLocation = AgentStateSessionMemoryLocationContent | AgentStateSessionMemoryLocationArtifact | AgentStateSessionMemoryLocationStaticValue;
 export type AgentStateSessionMemory = AgentStateSessionMemoryLocation[];
 export type GuardID = string;
+export type Variables1 = AgentVariable[];
+export type HistoryStrategyExecution = HistoryStrategyExecutionReplace | HistoryStrategyExecutionSummarize;
 /**
  * The human-readable name of the Guard.
  */
@@ -1763,6 +1764,7 @@ export interface AgentJSON {
     start: AgentStart;
     states: AgentStates;
     guards?: AgentGuard[];
+    historyStrategies?: HistoryStrategyMap;
 }
 export interface AgentAPIChat {
     type: 'chat';
@@ -1800,6 +1802,7 @@ export interface AgentTransitionStep {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1901,19 +1904,8 @@ export interface AgentExecutionChat {
     input: AgentAIStateInput;
     artifact?: string;
     tools?: AgentToolConfig[];
-    history?: AgentChatHistoryConfig;
     options?: AgentGenerateOptions;
 }
-export interface AgentChatHistoryRetain {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarize {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClear {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContent {
     type: 'content';
     memoryPath?: string;
@@ -1932,6 +1924,34 @@ export interface AgentStateSessionMemoryLocationStaticValue {
 export interface AgentGuard {
     guardId: GuardID;
 }
+export interface HistoryStrategyMap {
+    [k: string]: HistoryStrategy;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMap`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategy {
+    name: string;
+    variables?: Variables1;
+    filter?: HistoryStrategyFilter;
+    execution: HistoryStrategyExecution;
+}
+export interface HistoryStrategyFilter {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplace {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarize {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfig[];
+    options?: AgentGenerateOptions;
+}
 export interface GuardMap {
     [k: string]: GuardJSON;
 }

package/dist/project-schema/v3.48.0.d.ts

@@ -335,10 +335,11 @@ export type RemovePropertyKeyPatternsV3_48_0 = MinimatchPatternV3_48_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_48_0 = boolean;
-export type AgentChatHistoryConfigV3_48_0 = AgentChatHistoryRetainV3_48_0 | AgentChatHistorySummarizeV3_48_0 | AgentChatHistoryClearV3_48_0;
 export type AgentStateSessionMemoryLocationV3_48_0 = AgentStateSessionMemoryLocationContentV3_48_0 | AgentStateSessionMemoryLocationArtifactV3_48_0 | AgentStateSessionMemoryLocationStaticValueV3_48_0;
 export type AgentStateSessionMemoryV3_48_0 = AgentStateSessionMemoryLocationV3_48_0[];
 export type GuardIDV3_48_0 = string;
+export type VariablesV3_48_01 = AgentVariableV3_48_0[];
+export type HistoryStrategyExecutionV3_48_0 = HistoryStrategyExecutionReplaceV3_48_0 | HistoryStrategyExecutionSummarizeV3_48_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1611,6 +1612,7 @@ export interface AgentJSONV3_48_0 {
     start: AgentStartV3_48_0;
     states: AgentStatesV3_48_0;
     guards?: AgentGuardV3_48_0[];
+    historyStrategies?: HistoryStrategyMapV3_48_0;
 }
 export interface AgentAPIChatV3_48_0 {
     type: 'chat';
@@ -1648,6 +1650,7 @@ export interface AgentTransitionStepV3_48_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1749,19 +1752,8 @@ export interface AgentExecutionChatV3_48_0 {
     input: AgentAIStateInputV3_48_0;
     artifact?: string;
     tools?: AgentToolConfigV3_48_0[];
-    history?: AgentChatHistoryConfigV3_48_0;
     options?: AgentGenerateOptionsV3_48_0;
 }
-export interface AgentChatHistoryRetainV3_48_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_48_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_48_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_48_0 {
     type: 'content';
     memoryPath?: string;
@@ -1780,6 +1772,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_48_0 {
 export interface AgentGuardV3_48_0 {
     guardId: GuardIDV3_48_0;
 }
+export interface HistoryStrategyMapV3_48_0 {
+    [k: string]: HistoryStrategyV3_48_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_48_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_48_0 {
+    name: string;
+    variables?: VariablesV3_48_01;
+    filter?: HistoryStrategyFilterV3_48_0;
+    execution: HistoryStrategyExecutionV3_48_0;
+}
+export interface HistoryStrategyFilterV3_48_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_48_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_48_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_48_0[];
+    options?: AgentGenerateOptionsV3_48_0;
+}
 export interface GuardMapV3_48_0 {
     [k: string]: GuardJSONV3_48_0;
 }

package/dist/project-schema/v3.49.0.d.ts

@@ -335,10 +335,11 @@ export type RemovePropertyKeyPatternsV3_49_0 = MinimatchPatternV3_49_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_49_0 = boolean;
-export type AgentChatHistoryConfigV3_49_0 = AgentChatHistoryRetainV3_49_0 | AgentChatHistorySummarizeV3_49_0 | AgentChatHistoryClearV3_49_0;
 export type AgentStateSessionMemoryLocationV3_49_0 = AgentStateSessionMemoryLocationContentV3_49_0 | AgentStateSessionMemoryLocationArtifactV3_49_0 | AgentStateSessionMemoryLocationStaticValueV3_49_0;
 export type AgentStateSessionMemoryV3_49_0 = AgentStateSessionMemoryLocationV3_49_0[];
 export type GuardIDV3_49_0 = string;
+export type VariablesV3_49_01 = AgentVariableV3_49_0[];
+export type HistoryStrategyExecutionV3_49_0 = HistoryStrategyExecutionReplaceV3_49_0 | HistoryStrategyExecutionSummarizeV3_49_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1611,6 +1612,7 @@ export interface AgentJSONV3_49_0 {
     start: AgentStartV3_49_0;
     states: AgentStatesV3_49_0;
     guards?: AgentGuardV3_49_0[];
+    historyStrategies?: HistoryStrategyMapV3_49_0;
 }
 export interface AgentAPIChatV3_49_0 {
     type: 'chat';
@@ -1648,6 +1650,7 @@ export interface AgentTransitionStepV3_49_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1749,19 +1752,8 @@ export interface AgentExecutionChatV3_49_0 {
     input: AgentAIStateInputV3_49_0;
     artifact?: string;
     tools?: AgentToolConfigV3_49_0[];
-    history?: AgentChatHistoryConfigV3_49_0;
     options?: AgentGenerateOptionsV3_49_0;
 }
-export interface AgentChatHistoryRetainV3_49_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_49_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_49_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_49_0 {
     type: 'content';
     memoryPath?: string;
@@ -1780,6 +1772,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_49_0 {
 export interface AgentGuardV3_49_0 {
     guardId: GuardIDV3_49_0;
 }
+export interface HistoryStrategyMapV3_49_0 {
+    [k: string]: HistoryStrategyV3_49_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_49_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_49_0 {
+    name: string;
+    variables?: VariablesV3_49_01;
+    filter?: HistoryStrategyFilterV3_49_0;
+    execution: HistoryStrategyExecutionV3_49_0;
+}
+export interface HistoryStrategyFilterV3_49_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_49_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_49_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_49_0[];
+    options?: AgentGenerateOptionsV3_49_0;
+}
 export interface GuardMapV3_49_0 {
     [k: string]: GuardJSONV3_49_0;
 }

package/dist/project-schema/v3.50.0.d.ts

@@ -347,10 +347,11 @@ export type RemovePropertyKeyPatternsV3_50_0 = MinimatchPatternV3_50_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_50_0 = boolean;
-export type AgentChatHistoryConfigV3_50_0 = AgentChatHistoryRetainV3_50_0 | AgentChatHistorySummarizeV3_50_0 | AgentChatHistoryClearV3_50_0;
 export type AgentStateSessionMemoryLocationV3_50_0 = AgentStateSessionMemoryLocationContentV3_50_0 | AgentStateSessionMemoryLocationArtifactV3_50_0 | AgentStateSessionMemoryLocationStaticValueV3_50_0;
 export type AgentStateSessionMemoryV3_50_0 = AgentStateSessionMemoryLocationV3_50_0[];
 export type GuardIDV3_50_0 = string;
+export type VariablesV3_50_01 = AgentVariableV3_50_0[];
+export type HistoryStrategyExecutionV3_50_0 = HistoryStrategyExecutionReplaceV3_50_0 | HistoryStrategyExecutionSummarizeV3_50_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1663,6 +1664,7 @@ export interface AgentJSONV3_50_0 {
     start: AgentStartV3_50_0;
     states: AgentStatesV3_50_0;
     guards?: AgentGuardV3_50_0[];
+    historyStrategies?: HistoryStrategyMapV3_50_0;
 }
 export interface AgentAPIChatV3_50_0 {
     type: 'chat';
@@ -1700,6 +1702,7 @@ export interface AgentTransitionStepV3_50_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1801,19 +1804,8 @@ export interface AgentExecutionChatV3_50_0 {
     input: AgentAIStateInputV3_50_0;
     artifact?: string;
     tools?: AgentToolConfigV3_50_0[];
-    history?: AgentChatHistoryConfigV3_50_0;
     options?: AgentGenerateOptionsV3_50_0;
 }
-export interface AgentChatHistoryRetainV3_50_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_50_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_50_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_50_0 {
     type: 'content';
     memoryPath?: string;
@@ -1832,6 +1824,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_50_0 {
 export interface AgentGuardV3_50_0 {
     guardId: GuardIDV3_50_0;
 }
+export interface HistoryStrategyMapV3_50_0 {
+    [k: string]: HistoryStrategyV3_50_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_50_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_50_0 {
+    name: string;
+    variables?: VariablesV3_50_01;
+    filter?: HistoryStrategyFilterV3_50_0;
+    execution: HistoryStrategyExecutionV3_50_0;
+}
+export interface HistoryStrategyFilterV3_50_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_50_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_50_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_50_0[];
+    options?: AgentGenerateOptionsV3_50_0;
+}
 export interface GuardMapV3_50_0 {
     [k: string]: GuardJSONV3_50_0;
 }

package/dist/project-schema/v3.51.0.d.ts

@@ -347,10 +347,11 @@ export type RemovePropertyKeyPatternsV3_51_0 = MinimatchPatternV3_51_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_51_0 = boolean;
-export type AgentChatHistoryConfigV3_51_0 = AgentChatHistoryRetainV3_51_0 | AgentChatHistorySummarizeV3_51_0 | AgentChatHistoryClearV3_51_0;
 export type AgentStateSessionMemoryLocationV3_51_0 = AgentStateSessionMemoryLocationContentV3_51_0 | AgentStateSessionMemoryLocationArtifactV3_51_0 | AgentStateSessionMemoryLocationStaticValueV3_51_0;
 export type AgentStateSessionMemoryV3_51_0 = AgentStateSessionMemoryLocationV3_51_0[];
 export type GuardIDV3_51_0 = string;
+export type VariablesV3_51_01 = AgentVariableV3_51_0[];
+export type HistoryStrategyExecutionV3_51_0 = HistoryStrategyExecutionReplaceV3_51_0 | HistoryStrategyExecutionSummarizeV3_51_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1663,6 +1664,7 @@ export interface AgentJSONV3_51_0 {
     start: AgentStartV3_51_0;
     states: AgentStatesV3_51_0;
     guards?: AgentGuardV3_51_0[];
+    historyStrategies?: HistoryStrategyMapV3_51_0;
 }
 export interface AgentAPIChatV3_51_0 {
     type: 'chat';
@@ -1700,6 +1702,7 @@ export interface AgentTransitionStepV3_51_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1801,19 +1804,8 @@ export interface AgentExecutionChatV3_51_0 {
     input: AgentAIStateInputV3_51_0;
     artifact?: string;
     tools?: AgentToolConfigV3_51_0[];
-    history?: AgentChatHistoryConfigV3_51_0;
     options?: AgentGenerateOptionsV3_51_0;
 }
-export interface AgentChatHistoryRetainV3_51_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_51_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_51_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_51_0 {
     type: 'content';
     memoryPath?: string;
@@ -1832,6 +1824,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_51_0 {
 export interface AgentGuardV3_51_0 {
     guardId: GuardIDV3_51_0;
 }
+export interface HistoryStrategyMapV3_51_0 {
+    [k: string]: HistoryStrategyV3_51_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_51_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_51_0 {
+    name: string;
+    variables?: VariablesV3_51_01;
+    filter?: HistoryStrategyFilterV3_51_0;
+    execution: HistoryStrategyExecutionV3_51_0;
+}
+export interface HistoryStrategyFilterV3_51_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_51_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_51_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_51_0[];
+    options?: AgentGenerateOptionsV3_51_0;
+}
 export interface GuardMapV3_51_0 {
     [k: string]: GuardJSONV3_51_0;
 }

package/dist/project-schema/v3.52.0.d.ts

@@ -347,10 +347,11 @@ export type RemovePropertyKeyPatternsV3_52_0 = MinimatchPatternV3_52_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_52_0 = boolean;
-export type AgentChatHistoryConfigV3_52_0 = AgentChatHistoryRetainV3_52_0 | AgentChatHistorySummarizeV3_52_0 | AgentChatHistoryClearV3_52_0;
 export type AgentStateSessionMemoryLocationV3_52_0 = AgentStateSessionMemoryLocationContentV3_52_0 | AgentStateSessionMemoryLocationArtifactV3_52_0 | AgentStateSessionMemoryLocationStaticValueV3_52_0;
 export type AgentStateSessionMemoryV3_52_0 = AgentStateSessionMemoryLocationV3_52_0[];
 export type GuardIDV3_52_0 = string;
+export type VariablesV3_52_01 = AgentVariableV3_52_0[];
+export type HistoryStrategyExecutionV3_52_0 = HistoryStrategyExecutionReplaceV3_52_0 | HistoryStrategyExecutionSummarizeV3_52_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1663,6 +1664,7 @@ export interface AgentJSONV3_52_0 {
     start: AgentStartV3_52_0;
     states: AgentStatesV3_52_0;
     guards?: AgentGuardV3_52_0[];
+    historyStrategies?: HistoryStrategyMapV3_52_0;
 }
 export interface AgentAPIChatV3_52_0 {
     type: 'chat';
@@ -1700,6 +1702,7 @@ export interface AgentTransitionStepV3_52_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1801,19 +1804,8 @@ export interface AgentExecutionChatV3_52_0 {
     input: AgentAIStateInputV3_52_0;
     artifact?: string;
     tools?: AgentToolConfigV3_52_0[];
-    history?: AgentChatHistoryConfigV3_52_0;
     options?: AgentGenerateOptionsV3_52_0;
 }
-export interface AgentChatHistoryRetainV3_52_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_52_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_52_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_52_0 {
     type: 'content';
     memoryPath?: string;
@@ -1832,6 +1824,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_52_0 {
 export interface AgentGuardV3_52_0 {
     guardId: GuardIDV3_52_0;
 }
+export interface HistoryStrategyMapV3_52_0 {
+    [k: string]: HistoryStrategyV3_52_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_52_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_52_0 {
+    name: string;
+    variables?: VariablesV3_52_01;
+    filter?: HistoryStrategyFilterV3_52_0;
+    execution: HistoryStrategyExecutionV3_52_0;
+}
+export interface HistoryStrategyFilterV3_52_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_52_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_52_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_52_0[];
+    options?: AgentGenerateOptionsV3_52_0;
+}
 export interface GuardMapV3_52_0 {
     [k: string]: GuardJSONV3_52_0;
 }

package/dist/project-schema/v3.53.0.d.ts

@@ -356,10 +356,11 @@ export type RemovePropertyKeyPatternsV3_53_0 = MinimatchPatternV3_53_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_53_0 = boolean;
-export type AgentChatHistoryConfigV3_53_0 = AgentChatHistoryRetainV3_53_0 | AgentChatHistorySummarizeV3_53_0 | AgentChatHistoryClearV3_53_0;
 export type AgentStateSessionMemoryLocationV3_53_0 = AgentStateSessionMemoryLocationContentV3_53_0 | AgentStateSessionMemoryLocationArtifactV3_53_0 | AgentStateSessionMemoryLocationStaticValueV3_53_0;
 export type AgentStateSessionMemoryV3_53_0 = AgentStateSessionMemoryLocationV3_53_0[];
 export type GuardIDV3_53_0 = string;
+export type VariablesV3_53_01 = AgentVariableV3_53_0[];
+export type HistoryStrategyExecutionV3_53_0 = HistoryStrategyExecutionReplaceV3_53_0 | HistoryStrategyExecutionSummarizeV3_53_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1744,6 +1745,7 @@ export interface AgentJSONV3_53_0 {
     start: AgentStartV3_53_0;
     states: AgentStatesV3_53_0;
     guards?: AgentGuardV3_53_0[];
+    historyStrategies?: HistoryStrategyMapV3_53_0;
 }
 export interface AgentAPIChatV3_53_0 {
     type: 'chat';
@@ -1781,6 +1783,7 @@ export interface AgentTransitionStepV3_53_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1882,19 +1885,8 @@ export interface AgentExecutionChatV3_53_0 {
     input: AgentAIStateInputV3_53_0;
     artifact?: string;
     tools?: AgentToolConfigV3_53_0[];
-    history?: AgentChatHistoryConfigV3_53_0;
     options?: AgentGenerateOptionsV3_53_0;
 }
-export interface AgentChatHistoryRetainV3_53_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_53_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_53_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_53_0 {
     type: 'content';
     memoryPath?: string;
@@ -1913,6 +1905,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_53_0 {
 export interface AgentGuardV3_53_0 {
     guardId: GuardIDV3_53_0;
 }
+export interface HistoryStrategyMapV3_53_0 {
+    [k: string]: HistoryStrategyV3_53_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_53_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_53_0 {
+    name: string;
+    variables?: VariablesV3_53_01;
+    filter?: HistoryStrategyFilterV3_53_0;
+    execution: HistoryStrategyExecutionV3_53_0;
+}
+export interface HistoryStrategyFilterV3_53_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_53_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_53_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_53_0[];
+    options?: AgentGenerateOptionsV3_53_0;
+}
 export interface GuardMapV3_53_0 {
     [k: string]: GuardJSONV3_53_0;
 }

package/dist/project-schema/v3.54.0.d.ts

@@ -360,10 +360,11 @@ export type RemovePropertyKeyPatternsV3_54_0 = MinimatchPatternV3_54_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_54_0 = boolean;
-export type AgentChatHistoryConfigV3_54_0 = AgentChatHistoryRetainV3_54_0 | AgentChatHistorySummarizeV3_54_0 | AgentChatHistoryClearV3_54_0;
 export type AgentStateSessionMemoryLocationV3_54_0 = AgentStateSessionMemoryLocationContentV3_54_0 | AgentStateSessionMemoryLocationArtifactV3_54_0 | AgentStateSessionMemoryLocationStaticValueV3_54_0;
 export type AgentStateSessionMemoryV3_54_0 = AgentStateSessionMemoryLocationV3_54_0[];
 export type GuardIDV3_54_0 = string;
+export type VariablesV3_54_01 = AgentVariableV3_54_0[];
+export type HistoryStrategyExecutionV3_54_0 = HistoryStrategyExecutionReplaceV3_54_0 | HistoryStrategyExecutionSummarizeV3_54_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1763,6 +1764,7 @@ export interface AgentJSONV3_54_0 {
     start: AgentStartV3_54_0;
     states: AgentStatesV3_54_0;
     guards?: AgentGuardV3_54_0[];
+    historyStrategies?: HistoryStrategyMapV3_54_0;
 }
 export interface AgentAPIChatV3_54_0 {
     type: 'chat';
@@ -1800,6 +1802,7 @@ export interface AgentTransitionStepV3_54_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1901,19 +1904,8 @@ export interface AgentExecutionChatV3_54_0 {
     input: AgentAIStateInputV3_54_0;
     artifact?: string;
     tools?: AgentToolConfigV3_54_0[];
-    history?: AgentChatHistoryConfigV3_54_0;
     options?: AgentGenerateOptionsV3_54_0;
 }
-export interface AgentChatHistoryRetainV3_54_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_54_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_54_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_54_0 {
     type: 'content';
     memoryPath?: string;
@@ -1932,6 +1924,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_54_0 {
 export interface AgentGuardV3_54_0 {
     guardId: GuardIDV3_54_0;
 }
+export interface HistoryStrategyMapV3_54_0 {
+    [k: string]: HistoryStrategyV3_54_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_54_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_54_0 {
+    name: string;
+    variables?: VariablesV3_54_01;
+    filter?: HistoryStrategyFilterV3_54_0;
+    execution: HistoryStrategyExecutionV3_54_0;
+}
+export interface HistoryStrategyFilterV3_54_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_54_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_54_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_54_0[];
+    options?: AgentGenerateOptionsV3_54_0;
+}
 export interface GuardMapV3_54_0 {
     [k: string]: GuardJSONV3_54_0;
 }

package/dist/project-schema/v3.55.0.d.ts

@@ -360,10 +360,11 @@ export type RemovePropertyKeyPatternsV3_55_0 = MinimatchPatternV3_55_0[];
  * Remove Markdown formatting from the LLM response
  */
 export type StripMarkdownV3_55_0 = boolean;
-export type AgentChatHistoryConfigV3_55_0 = AgentChatHistoryRetainV3_55_0 | AgentChatHistorySummarizeV3_55_0 | AgentChatHistoryClearV3_55_0;
 export type AgentStateSessionMemoryLocationV3_55_0 = AgentStateSessionMemoryLocationContentV3_55_0 | AgentStateSessionMemoryLocationArtifactV3_55_0 | AgentStateSessionMemoryLocationStaticValueV3_55_0;
 export type AgentStateSessionMemoryV3_55_0 = AgentStateSessionMemoryLocationV3_55_0[];
 export type GuardIDV3_55_0 = string;
+export type VariablesV3_55_01 = AgentVariableV3_55_0[];
+export type HistoryStrategyExecutionV3_55_0 = HistoryStrategyExecutionReplaceV3_55_0 | HistoryStrategyExecutionSummarizeV3_55_0;
 /**
  * The human-readable name of the Guard.
  */
@@ -1763,6 +1764,7 @@ export interface AgentJSONV3_55_0 {
     start: AgentStartV3_55_0;
     states: AgentStatesV3_55_0;
     guards?: AgentGuardV3_55_0[];
+    historyStrategies?: HistoryStrategyMapV3_55_0;
 }
 export interface AgentAPIChatV3_55_0 {
     type: 'chat';
@@ -1800,6 +1802,7 @@ export interface AgentTransitionStepV3_55_0 {
     suspend?: boolean;
     condition?: string;
     limit?: number;
+    historyStrategy?: string;
 }
 /**
  * States that are traversed during the execution of an agent.
@@ -1901,19 +1904,8 @@ export interface AgentExecutionChatV3_55_0 {
     input: AgentAIStateInputV3_55_0;
     artifact?: string;
     tools?: AgentToolConfigV3_55_0[];
-    history?: AgentChatHistoryConfigV3_55_0;
     options?: AgentGenerateOptionsV3_55_0;
 }
-export interface AgentChatHistoryRetainV3_55_0 {
-    type: 'retain';
-}
-export interface AgentChatHistorySummarizeV3_55_0 {
-    type: 'summarize';
-    toolCalls: 'retain' | 'clear';
-}
-export interface AgentChatHistoryClearV3_55_0 {
-    type: 'clear';
-}
 export interface AgentStateSessionMemoryLocationContentV3_55_0 {
     type: 'content';
     memoryPath?: string;
@@ -1932,6 +1924,34 @@ export interface AgentStateSessionMemoryLocationStaticValueV3_55_0 {
 export interface AgentGuardV3_55_0 {
     guardId: GuardIDV3_55_0;
 }
+export interface HistoryStrategyMapV3_55_0 {
+    [k: string]: HistoryStrategyV3_55_0;
+}
+/**
+ * This interface was referenced by `HistoryStrategyMapV3_55_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface HistoryStrategyV3_55_0 {
+    name: string;
+    variables?: VariablesV3_55_01;
+    filter?: HistoryStrategyFilterV3_55_0;
+    execution: HistoryStrategyExecutionV3_55_0;
+}
+export interface HistoryStrategyFilterV3_55_0 {
+    toolCalls?: 'retain' | 'clear';
+}
+export interface HistoryStrategyExecutionReplaceV3_55_0 {
+    type: 'replace';
+    template: string;
+}
+export interface HistoryStrategyExecutionSummarizeV3_55_0 {
+    type: 'generate';
+    service: string;
+    model: string;
+    systemPrompt: string;
+    tools?: AgentToolConfigV3_55_0[];
+    options?: AgentGenerateOptionsV3_55_0;
+}
 export interface GuardMapV3_55_0 {
     [k: string]: GuardJSONV3_55_0;
 }

package/dist/schemas/project-schema/experimental.json

@@ -30,11 +30,115 @@
           "items": {
             "$ref": "#/definitions/agentGuard"
           }
+        },
+        "historyStrategies": {
+          "$ref": "#/definitions/historyStrategyMap"
         }
       },
       "required": ["start", "states", "api"],
       "additionalProperties": false
     },
+    "historyStrategyMap": {
+      "title": "History Strategy Map",
+      "type": "object",
+      "patternProperties": {
+        "^[0-9A-Za-z_]+$": {
+          "$ref": "#/definitions/historyStrategy"
+        }
+      },
+      "additionalProperties": false
+    },
+    "historyStrategy": {
+      "title": "History Strategy",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "variables": {
+          "title": "Variables",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentVariable"
+          }
+        },
+        "filter": {
+          "$ref": "#/definitions/historyStrategyFilter"
+        },
+        "execution": {
+          "$ref": "#/definitions/historyStrategyExecution"
+        }
+      },
+      "required": ["name", "execution"],
+      "additionalProperties": false
+    },
+    "historyStrategyFilter": {
+      "title": "History Strategy Filter",
+      "type": "object",
+      "properties": {
+        "toolCalls": {
+          "enum": ["retain", "clear"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "historyStrategyExecution": {
+      "title": "History Strategy Execution",
+      "discriminator": {
+        "propertyName": "type"
+      },
+      "oneOf": [
+        {
+          "$ref": "#/definitions/historyStrategyExecutionReplace"
+        },
+        {
+          "$ref": "#/definitions/historyStrategyExecutionSummarize"
+        }
+      ]
+    },
+    "historyStrategyExecutionReplace": {
+      "title": "History Strategy Execution Replace",
+      "type": "object",
+      "properties": {
+        "type": {
+          "enum": ["replace"]
+        },
+        "template": {
+          "type": "string"
+        }
+      },
+      "required": ["type", "template"],
+      "additionalProperties": false
+    },
+    "historyStrategyExecutionSummarize": {
+      "title": "History Strategy Execution Summarize",
+      "type": "object",
+      "properties": {
+        "type": {
+          "enum": ["generate"]
+        },
+        "service": {
+          "type": "string"
+        },
+        "model": {
+          "type": "string"
+        },
+        "systemPrompt": {
+          "type": "string"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentToolConfig"
+          }
+        },
+        "options": {
+          "$ref": "#/definitions/agentGenerateOptions"
+        }
+      },
+      "required": ["type", "service", "model", "systemPrompt"],
+      "additionalProperties": false
+    },
     "tool": {
       "title": "Tool JSON",
       "type": "object",
@@ -604,59 +708,6 @@
       "required": ["type", "argName", "variableName"],
       "additionalProperties": false
     },
-    "agentChatHistoryConfig": {
-      "title": "Agent Chat History Config",
-      "discriminator": {
-        "propertyName": "type"
-      },
-      "oneOf": [
-        {
-          "$ref": "#/definitions/agentChatHistoryRetain"
-        },
-        {
-          "$ref": "#/definitions/agentChatHistorySummarize"
-        },
-        {
-          "$ref": "#/definitions/agentChatHistoryClear"
-        }
-      ]
-    },
-    "agentChatHistoryRetain": {
-      "title": "Agent Chat History Retain",
-      "type": "object",
-      "properties": {
-        "type": {
-          "enum": ["retain"]
-        }
-      },
-      "required": ["type"],
-      "additionalProperties": false
-    },
-    "agentChatHistorySummarize": {
-      "title": "Agent Chat History Summarize",
-      "type": "object",
-      "properties": {
-        "type": {
-          "enum": ["summarize"]
-        },
-        "toolCalls": {
-          "enum": ["retain", "clear"]
-        }
-      },
-      "required": ["type", "toolCalls"],
-      "additionalProperties": false
-    },
-    "agentChatHistoryClear": {
-      "title": "Agent Chat History Clear",
-      "type": "object",
-      "properties": {
-        "type": {
-          "enum": ["clear"]
-        }
-      },
-      "required": ["type"],
-      "additionalProperties": false
-    },
     "agentExecutionGenerate": {
       "title": "Agent Execution Generate",
       "type": "object",
@@ -720,9 +771,6 @@
             "$ref": "#/definitions/agentToolConfig"
           }
         },
-        "history": {
-          "$ref": "#/definitions/agentChatHistoryConfig"
-        },
         "options": {
           "$ref": "#/definitions/agentGenerateOptions"
         }
@@ -747,6 +795,9 @@
         },
         "limit": {
           "type": "integer"
+        },
+        "historyStrategy": {
+          "type": "string"
         }
       },
       "additionalProperties": false,

package/dist/validate/validate.js

@@ -916,6 +916,21 @@ function validateAgents(projectSchema) {
                 })));
             }
         }
+        if (agent.historyStrategies) {
+            const seenStrategyNames = new Set();
+            for (const [historyStrategyId, historyStrategy] of Object.entries(agent.historyStrategies)) {
+                if (seenStrategyNames.has(historyStrategy.name)) {
+                    errors.push({
+                        path: [...agentPath, 'historyStrategies', historyStrategyId, 'name'],
+                        type: 'conflict',
+                        message: `Duplicate history strategy name "${historyStrategy.name}"`
+                    });
+                }
+                else {
+                    seenStrategyNames.add(historyStrategy.name);
+                }
+            }
+        }
     }
     return errors;
 }

package/examples/latest/agent-schema.json

@@ -323,7 +323,8 @@
             },
             "transition": []
           }
-        }
+        },
+        "historyStrategies": {}
       },
       "chat": {
         "api": {
@@ -360,7 +361,8 @@
               }
             ]
           }
-        }
+        },
+        "historyStrategies": {}
       }
     }
   }

package/examples/source/agent-schema.json

@@ -305,7 +305,8 @@
             },
             "transition": []
           }
-        }
+        },
+        "historyStrategies": {}
       },
       "chat": {
         "api": {
@@ -342,7 +343,8 @@
               }
             ]
           }
-        }
+        },
+        "historyStrategies": {}
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "11.91.0",
+  "version": "11.92.0",
   "description": "TakeShape Schema",
   "homepage": "https://www.takeshape.io",
   "repository": {
@@ -58,9 +58,9 @@
     "p-reduce": "^2.1.0",
     "semver": "^7.3.2",
     "tiny-invariant": "^1.2.0",
-    "@takeshape/errors": "11.91.0",
-    "@takeshape/json-schema": "11.91.0",
-    "@takeshape/util": "11.91.0"
+    "@takeshape/errors": "11.92.0",
+    "@takeshape/util": "11.92.0",
+    "@takeshape/json-schema": "11.92.0"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "^11.0.0",
@@ -77,7 +77,7 @@
     "json-schema-to-ts": "^3.1.1",
     "meow": "^9.0.0",
     "shortid": "^2.2.15",
-    "@takeshape/infra": "11.91.0"
+    "@takeshape/infra": "11.92.0"
   },
   "engines": {
     "node": ">=20"