@takeshape/schema 11.89.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/flatten-templates.js

@@ -11,7 +11,7 @@ export function flattenTemplates(projectSchema) {
     const newSchema = deepClone(projectSchema);
     for (const ref of templateRefs) {
         if (ref.template && isValidTemplate(ref.template)) {
-            const { shapeName, dependencies } = resolveTemplate(newSchema, ref.template, refItemToNamespacedShapeName(ref));
+            const { shapeName, dependencies } = resolveTemplate(newSchema, ref.template, refItemToNamespacedShapeName(newSchema, ref));
             set(newSchema, ref.path, ref.path[ref.path.length - 1] === '@ref' ? `local:${shapeName}` : shapeName);
             Object.assign(newSchema.shapes, dependencies);
         }

package/dist/index.d.ts

@@ -43,6 +43,7 @@ export * from './util/form-config.ts';
 export * from './util/get-conflicting-properties.ts';
 export * from './util/get-return-shape.ts';
 export * from './util/has-arg.ts';
+export * from './util/is-asset-property.ts';
 export * from './util/merge.ts';
 export * from './util/patch-schema.ts';
 export * from './util/shapes.ts';

package/dist/index.js

@@ -41,6 +41,7 @@ export * from "./util/form-config.js";
 export * from "./util/get-conflicting-properties.js";
 export * from "./util/get-return-shape.js";
 export * from "./util/has-arg.js";
+export * from "./util/is-asset-property.js";
 export * from "./util/merge.js";
 export * from "./util/patch-schema.js";
 export * from "./util/shapes.js";

package/dist/interfaces.d.ts

@@ -1,6 +1,8 @@
 import type { OneOfSchema, ProjectSchemaJSON, PropertySchema, ShapeJSON, ShapeMap } from './project-schema/index.ts';
-import type { RefItem, ServicesShapesContext } from './refs.ts';
-export declare function isInterfaceShape(shape?: ShapeJSON): boolean;
+import { type RefItem, type ServicesShapesContext } from './refs.ts';
+export declare function isInterfaceShape(shape?: ShapeJSON): shape is ShapeJSON & {
+    type: 'interface';
+};
 export type ImplementationShapeMap = Record<string, Set<ShapeJSON>>;
 export type ImplementationShapeNameMap = Record<string, Set<string>>;
 export declare function isInterfaceRef(context: ServicesShapesContext, propertySchema: PropertySchema): boolean;

package/dist/interfaces.js

@@ -1,6 +1,6 @@
 import { isDefined } from '@takeshape/util';
 import mapValues from 'lodash/mapValues.js';
-import { getRef, normalizeRefExpression, refExpressionToRefItem, refItemToNamespacedShapeName, refItemToShape, shapeToRefItem } from "./refs.js";
+import { getRef, getShapeByRef, normalizeRefExpression, parseRef, refItemToNamespacedShapeName, refItemToShape, shapeToRefItem } from "./refs.js";
 import { isUnionSchema } from "./unions.js";
 export function isInterfaceShape(shape) {
     return shape?.type === 'interface';
@@ -36,7 +36,8 @@ export function pruneUnusedInterfaces(projectSchema, shapeMap) {
     return mapValues(shapeMap, (shape) => {
         const { interfaces } = shape;
         if (interfaces?.length) {
-            const filteredInterfaces = interfaces.filter((refExpression) => shapeMap[refItemToNamespacedShapeName(refExpressionToRefItem(projectSchema, refExpression))]);
+            const context = { ...projectSchema, shapes: shapeMap };
+            const filteredInterfaces = interfaces.filter((refExpression) => getShapeByRef(context, refExpression));
             if (interfaces.length !== filteredInterfaces.length) {
                 return { ...shape, interfaces: filteredInterfaces };
             }
@@ -45,13 +46,13 @@ export function pruneUnusedInterfaces(projectSchema, shapeMap) {
     });
 }
 function compareRefItems(refItem1, refItem2) {
-    return refItem1.typeName === refItem2.typeName && refItem1.serviceKey === refItem2.serviceKey;
+    return refItem1.shapeName === refItem2.shapeName && refItem1.layerId === refItem2.layerId;
 }
 export function getImplementingShapes(context, interfaceRef) {
     const shapeMap = context.shapes;
     const implementingShapes = [];
     for (const shape of Object.values(shapeMap)) {
-        if (shape.interfaces?.find((interfaceRefExpression) => compareRefItems(refExpressionToRefItem(context, interfaceRefExpression), interfaceRef))) {
+        if (shape.interfaces?.find((interfaceRefExpression) => compareRefItems(parseRef(context, interfaceRefExpression), interfaceRef))) {
             implementingShapes.push(shape);
         }
     }
@@ -74,7 +75,7 @@ export function getPossibleShapeNames(projectSchema, shape) {
         names = shape.schema.oneOf
             .map((member) => {
             const ref = getRef(projectSchema, member);
-            return ref && refItemToNamespacedShapeName(ref);
+            return ref && refItemToNamespacedShapeName(projectSchema, ref);
         })
             .filter(isDefined);
     }

package/dist/migration/to/v3.34.0.js

@@ -3,15 +3,10 @@ import set from 'lodash/fp/set.js';
 import unset from 'lodash/fp/unset.js';
 import upperFirst from 'lodash/upperFirst.js';
 import { SERVICE_OBJECT_PATTERN_NAME } from "../../constants.js";
-import { getRefOrItemsRef } from "../../refs.js";
+import { getRefOrItemsRef, refItemToNamespacedShapeName } from "../../refs.js";
 import { createSchemaPropertyAccessor } from "../../schema-util.js";
 import { CURRENT_SCHEMA_VERSION } from "../../schemas/index.js";
 import { getServiceObjectFields } from "../../services/services.js";
-// Inline utilities for posterity
-function refItemToShapeName(refItem) {
-    const { serviceNamespace, typeName } = refItem;
-    return serviceNamespace ? `${serviceNamespace}_${typeName}` : typeName;
-}
 // Map of form studio widgets and their replacements in the shape editor
 const widgetMigrations = {
     object: 'shapeObject',
@@ -39,7 +34,7 @@ export function normalizeForms(projectSchema) {
             if (propSchema) {
                 const ref = getRefOrItemsRef(projectSchema, propSchema);
                 if (ref && propConfig.properties && propConfig.widget !== 'shopify') {
-                    const nestedShapeName = refItemToShapeName(ref);
+                    const nestedShapeName = refItemToNamespacedShapeName(projectSchema, ref);
                     normalizedForms[nestedShapeName] = { default: deepClone(propConfig) };
                     storeSourceForm(shapeName, formConfig, propName);
                     normalizeNested(nestedShapeName, propConfig);

package/dist/models/runtime-schema.js

@@ -1,4 +1,4 @@
-import { dereferenceSchema, getQuery, normalizePropertyRef, normalizeRefExpression, parsePropertyRef, refExpressionToRefItem, refItemToNamespacedShapeName } from "../refs.js";
+import { dereferenceSchema, getQuery, normalizePropertyRef, normalizeRefExpression, parsePropertyRef, parseRef, refItemToNamespacedShapeName } from "../refs.js";
 import { buildRuntimeSchema } from "../runtime-schema.js";
 import { getShape } from "../util/shapes.js";
 import { Query } from './query.js';
@@ -18,16 +18,16 @@ class ProjectSchemaRefResolver {
         const shapeRef = normalizeRefExpression(this.#runtimeSchemaJson, rawShapeRef);
         let shape = this.#shapeCache.get(shapeRef);
         if (!shape) {
-            const refItem = refExpressionToRefItem(this.#runtimeSchemaJson, rawShapeRef);
+            const refItem = parseRef(this.#runtimeSchemaJson, rawShapeRef);
             if (refItem) {
-                const namespacedName = refItemToNamespacedShapeName(refItem);
+                const namespacedName = refItemToNamespacedShapeName(this.#runtimeSchemaJson, refItem);
                 const shapeJson = getShape(this.#runtimeSchemaJson, namespacedName);
                 if (shapeJson) {
                     shape = new Shape(this, refItem, shapeJson);
                     this.#shapeCache.set(shapeRef, shape);
                 }
-                else if (refItem.serviceKey !== 'local') {
-                    const layerSchema = this.#layers[refItem.serviceKey]?.schema;
+                else if (refItem.layerId !== 'local') {
+                    const layerSchema = this.#layers[refItem.layerId]?.schema;
                     if (layerSchema) {
                         const shapeJson = getShape(layerSchema, namespacedName);
                         if (shapeJson) {
@@ -51,8 +51,8 @@ class ProjectSchemaRefResolver {
             }
             else {
                 const parsedRef = parsePropertyRef(queryRef);
-                if (parsedRef && parsedRef.serviceId !== 'local') {
-                    const layerSchema = this.#layers[parsedRef.serviceId]?.schema;
+                if (parsedRef && parsedRef.layerId !== 'local') {
+                    const layerSchema = this.#layers[parsedRef.layerId]?.schema;
                     if (layerSchema) {
                         const queryEntry = getQuery(layerSchema, parsedRef.propertyName);
                         if (queryEntry) {

package/dist/models/shape.d.ts

@@ -7,5 +7,6 @@ export declare class Shape {
     get name(): string;
     get ref(): string;
     get refItem(): RefItem;
+    get json(): ShapeJSON;
     getObjectSchema(): import("../project-schema/latest.ts").ObjectSchema | undefined;
 }

package/dist/models/shape.js

@@ -1,4 +1,4 @@
-import { refItemToAtRef } from "../refs.js";
+import { serializeRef } from "../refs.js";
 import { isObjectSchema } from "../types/utils.js";
 export class Shape {
     #refResolver;
@@ -14,11 +14,14 @@ export class Shape {
         return this.#shape.name;
     }
     get ref() {
-        return refItemToAtRef(this.#ref);
+        return serializeRef(this.#ref);
     }
     get refItem() {
         return this.#ref;
     }
+    get json() {
+        return this.#shape;
+    }
     getObjectSchema() {
         if (!this.#dereferencedSchema) {
             this.#dereferencedSchema = this.#refResolver.dereferenceSchema(this.#shape.schema);

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;
 }