@takeshape/schema 11.104.4 → 11.105.0

package/dist/agents.d.ts

@@ -23,6 +23,7 @@ export declare const getSendAgentMessageShapeName: (agentName: string) => string
 export declare const getAgentMessageShapeName: (inputName: string) => string;
 export declare const getCreateAgentSessionMutationName: (agentName: string) => string;
 export declare const getInspectAgentQueryName: (agentName: string) => string;
+export declare const getSendAgentFeedbackMutationName: (agentName: string) => string;
 export declare const getSendAgentMessageMutationName: (inputName: string) => string;
 export declare const getGetAgentMessageQueryName: (inputName: string) => string;
 export declare const getAbortAgentMessageMutationName: (inputName: string) => string;

package/dist/agents.js

@@ -10,6 +10,7 @@ import * as getAgentMessageArgs from "./resolvers/ai/get-agent-message-args.js";
 import * as getAgentMessageResponse from "./resolvers/ai/get-agent-message-response.js";
 import * as inspectAgentArgs from "./resolvers/ai/inspect-agent-args.js";
 import * as inspectAgentResponse from "./resolvers/ai/inspect-agent-response.js";
+import * as sendAgentFeedbackArgs from "./resolvers/ai/send-agent-feedback-args.js";
 import * as sendAgentMessageArgs from "./resolvers/ai/send-agent-message-args.js";
 import * as sendAgentMessageResponse from "./resolvers/ai/send-agent-message-response.js";
 import { JSON_SHAPE_NAME } from "./resolvers/takeshape/builtins/constants.js";
@@ -71,6 +72,9 @@ export const getCreateAgentSessionMutationName = (agentName) => {
 export const getInspectAgentQueryName = (agentName) => {
     return `inspect${upperFirst(agentName)}`;
 };
+export const getSendAgentFeedbackMutationName = (agentName) => {
+    return `send${upperFirst(agentName)}Feedback`;
+};
 export const getSendAgentMessageMutationName = (inputName) => {
     return `send${upperFirst(inputName)}Message`;
 };
@@ -215,6 +219,15 @@ export function getAgentFeatures(agents) {
                 agentName
             }
         };
+        result.mutations[getSendAgentFeedbackMutationName(agentName)] ||= {
+            description: `Send feedback for the ${agentName} agent`,
+            args: sendAgentFeedbackArgs.shapeName,
+            shape: 'boolean',
+            resolver: {
+                name: 'ai:sendAgentFeedback',
+                agentName
+            }
+        };
     }
     return result;
 }

package/dist/builtin-schema.js

@@ -7,6 +7,7 @@ import * as agentRunMode from "./resolvers/ai/agent-run-mode.js";
 import * as createAgentSessionResponse from "./resolvers/ai/create-agent-session-response.js";
 import * as embeddingSearchArgs from "./resolvers/ai/embedding-search.js";
 import * as inspectAgentResponse from "./resolvers/ai/inspect-agent-response.js";
+import * as sendAgentFeedbackArgs from "./resolvers/ai/send-agent-feedback-args.js";
 import * as asset from "./resolvers/takeshape/assets/asset.js";
 import * as assetImage from "./resolvers/takeshape/assets/asset-image.js";
 import * as assetImageMeta from "./resolvers/takeshape/assets/asset-image-meta.js";
@@ -396,6 +397,12 @@ export const builtInShapes = {
         id: abortAgentMessageResponse.shapeName,
         name: abortAgentMessageResponse.shapeName,
         schema: abortAgentMessageResponse.schema
+    },
+    [sendAgentFeedbackArgs.shapeName]: {
+        title: 'Send Agent Feedback Args',
+        id: sendAgentFeedbackArgs.shapeName,
+        name: sendAgentFeedbackArgs.shapeName,
+        schema: sendAgentFeedbackArgs.schema
     }
 };
 export const builtInForms = {

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

@@ -74,7 +74,7 @@ export type Resolver = BasicResolver | ComposeResolver;
  * This interface was referenced by `ProjectSchemaJSON`'s JSON-Schema
  * via the `definition` "basicResolver".
  */
-export type BasicResolver = UtilResolver | DelegateResolver | TakeshapeResolver | ShapedbResolver | ShapedbResolverShapeNameNotRequired | GraphqlResolver | RestResolver | AwsLambdaResolver | SalsifyResolver | SyndigoResolver | FunctionResolver | AIGenerateTextResolver | AIGeneratePropertyResolver | AIEmbeddingResolver | AIEmbeddingSearchResolver | AIParseFileResolver | ChunkResolver | AISendAgentMessageResolver | AIInspectAgentResolver | AICreateAgentSessionResolver | AIGetAgentMessageResolver | AIAbortAgentMessageResolver;
+export type BasicResolver = UtilResolver | DelegateResolver | TakeshapeResolver | ShapedbResolver | ShapedbResolverShapeNameNotRequired | GraphqlResolver | RestResolver | AwsLambdaResolver | SalsifyResolver | SyndigoResolver | FunctionResolver | AIGenerateTextResolver | AIGeneratePropertyResolver | AIEmbeddingResolver | AIEmbeddingSearchResolver | AIParseFileResolver | ChunkResolver | AISendAgentMessageResolver | AIInspectAgentResolver | AICreateAgentSessionResolver | AIGetAgentMessageResolver | AIAbortAgentMessageResolver | AISendAgentFeedbackResolver;
 /**
  * Name of the resolver function.
  */
@@ -262,6 +262,10 @@ export type AIResolverName8 = 'ai:getAgentMessage';
  * Name of the resolver function.
  */
 export type AIResolverName9 = 'ai:abortAgentMessage';
+/**
+ * Name of the resolver function.
+ */
+export type AIResolverName10 = 'ai:sendAgentFeedback';
 /**
  * This interface was referenced by `ProjectSchemaJSON`'s JSON-Schema
  * via the `definition` "dependencies".
@@ -1545,6 +1549,11 @@ export interface AIAbortAgentMessageResolver {
     name: AIResolverName9;
     agentName: string;
 }
+export interface AISendAgentFeedbackResolver {
+    id?: string;
+    name: AIResolverName10;
+    agentName: string;
+}
 /**
  * This interface was referenced by `ProjectSchemaJSON`'s JSON-Schema
  * via the `definition` "composeResolver".

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

@@ -74,7 +74,7 @@ export type ResolverV3_56_0 = BasicResolverV3_56_0 | ComposeResolverV3_56_0;
  * This interface was referenced by `ProjectSchemaJSONV3_56_0`'s JSON-Schema
  * via the `definition` "basicResolver".
  */
-export type BasicResolverV3_56_0 = UtilResolverV3_56_0 | DelegateResolverV3_56_0 | TakeshapeResolverV3_56_0 | ShapedbResolverV3_56_0 | ShapedbResolverShapeNameNotRequiredV3_56_0 | GraphqlResolverV3_56_0 | RestResolverV3_56_0 | AwsLambdaResolverV3_56_0 | SalsifyResolverV3_56_0 | SyndigoResolverV3_56_0 | FunctionResolverV3_56_0 | AIGenerateTextResolverV3_56_0 | AIGeneratePropertyResolverV3_56_0 | AIEmbeddingResolverV3_56_0 | AIEmbeddingSearchResolverV3_56_0 | AIParseFileResolverV3_56_0 | ChunkResolverV3_56_0 | AISendAgentMessageResolverV3_56_0 | AIInspectAgentResolverV3_56_0 | AICreateAgentSessionResolverV3_56_0 | AIGetAgentMessageResolverV3_56_0 | AIAbortAgentMessageResolverV3_56_0;
+export type BasicResolverV3_56_0 = UtilResolverV3_56_0 | DelegateResolverV3_56_0 | TakeshapeResolverV3_56_0 | ShapedbResolverV3_56_0 | ShapedbResolverShapeNameNotRequiredV3_56_0 | GraphqlResolverV3_56_0 | RestResolverV3_56_0 | AwsLambdaResolverV3_56_0 | SalsifyResolverV3_56_0 | SyndigoResolverV3_56_0 | FunctionResolverV3_56_0 | AIGenerateTextResolverV3_56_0 | AIGeneratePropertyResolverV3_56_0 | AIEmbeddingResolverV3_56_0 | AIEmbeddingSearchResolverV3_56_0 | AIParseFileResolverV3_56_0 | ChunkResolverV3_56_0 | AISendAgentMessageResolverV3_56_0 | AIInspectAgentResolverV3_56_0 | AICreateAgentSessionResolverV3_56_0 | AIGetAgentMessageResolverV3_56_0 | AIAbortAgentMessageResolverV3_56_0 | AISendAgentFeedbackResolverV3_56_0;
 /**
  * Name of the resolver function.
  */
@@ -262,6 +262,10 @@ export type AIResolverNameV3_56_08 = 'ai:getAgentMessage';
  * Name of the resolver function.
  */
 export type AIResolverNameV3_56_09 = 'ai:abortAgentMessage';
+/**
+ * Name of the resolver function.
+ */
+export type AIResolverNameV3_56_010 = 'ai:sendAgentFeedback';
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_56_0`'s JSON-Schema
  * via the `definition` "dependencies".
@@ -383,7 +387,7 @@ export type StripMarkdownV3_56_0 = boolean;
  * These steps are evaluated in order until a destination is found.
  */
 export type AgentTransitionV3_56_0 = AgentTransitionImmediateV3_56_0 | AgentTransitionSuspendV3_56_0;
-export type AgentStateSessionMemoryV3_56_01 = AgentStateSessionMemoryAssignmentV3_56_01[];
+export type AgentStateSessionMemoryV3_56_01 = AgentStateSessionMemoryAssignmentV3_56_0[];
 export type GuardIDV3_56_0 = string;
 export type VariablesV3_56_01 = AgentVariableV3_56_0[];
 export type HistoryStrategyTransformV3_56_0 = HistoryStrategyTransformNoneV3_56_0 | HistoryStrategyTransformReplaceV3_56_0 | HistoryStrategyTransformSummarizeV3_56_0;
@@ -1545,6 +1549,11 @@ export interface AIAbortAgentMessageResolverV3_56_0 {
     name: AIResolverNameV3_56_09;
     agentName: string;
 }
+export interface AISendAgentFeedbackResolverV3_56_0 {
+    id?: string;
+    name: AIResolverNameV3_56_010;
+    agentName: string;
+}
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_56_0`'s JSON-Schema
  * via the `definition` "composeResolver".
@@ -1944,10 +1953,6 @@ export interface AgentTransitionImmediateV3_56_0 {
     sessionMemory?: AgentStateSessionMemoryV3_56_01;
     historyStrategy?: string;
 }
-export interface AgentStateSessionMemoryAssignmentV3_56_01 {
-    memoryPath?: string;
-    expression: string;
-}
 export interface AgentGuardV3_56_0 {
     guardId: GuardIDV3_56_0;
 }

package/dist/resolvers/ai/agent-message-payload.d.ts

@@ -56,6 +56,61 @@ export declare const schema: {
             readonly type: "number";
             readonly description: "Timestamp when the message finished processing";
         };
+        readonly span: {
+            readonly type: "object";
+            readonly description: "The span for the agent run associated with this message";
+            readonly properties: {
+                readonly traceId: {
+                    readonly type: "string";
+                };
+                readonly spanId: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly createdAt: {
+                    readonly type: "number";
+                };
+            };
+            readonly required: ["traceId", "spanId", "name", "createdAt"];
+            readonly additionalProperties: false;
+        };
+        readonly feedback: {
+            readonly type: "object";
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly description: "Name of the feedback, e.g., \"Quality\", \"Relevance\"";
+                };
+                readonly label: {
+                    readonly type: "string";
+                    readonly description: "String feedback for the agent message, e.g., \"helpful\", \"not helpful\". If a label is provided, a score must not be provided.";
+                };
+                readonly score: {
+                    readonly type: "number";
+                    readonly description: "Numeric feedback for the agent message, typically between 1 and 5. If a score is provided, a label must not be provided.";
+                };
+                readonly text: {
+                    readonly type: "string";
+                    readonly description: "Freeform text feedback for the agent message.";
+                };
+                readonly note: {
+                    readonly type: "string";
+                    readonly description: "Optional note for the feedback, e.g., \"This was helpful because...\"";
+                };
+                readonly updatedBy: {
+                    readonly type: "string";
+                    readonly description: "A string identifying the user who is adding the annotation, such as a name or email address.";
+                };
+                readonly createdAt: {
+                    readonly type: "number";
+                    readonly description: "Timestamp when the feedback was created";
+                };
+            };
+            readonly additionalProperties: false;
+            readonly required: ["name"];
+        };
     };
     readonly required: ["messageId", "sessionId", "projectId", "runMode"];
     readonly additionalProperties: false;
@@ -77,6 +132,21 @@ export declare const validate: import("ajv").ValidateFunction<{
     sentAt?: number | undefined;
     startedAt?: number | undefined;
     finishedAt?: number | undefined;
+    span?: {
+        name: string;
+        traceId: string;
+        spanId: string;
+        createdAt: number;
+    } | undefined;
+    feedback?: {
+        createdAt?: number | undefined;
+        label?: string | undefined;
+        score?: number | undefined;
+        text?: string | undefined;
+        note?: string | undefined;
+        updatedBy?: string | undefined;
+        name: string;
+    } | undefined;
     messageId: string;
     projectId: string;
     sessionId: string;

package/dist/resolvers/ai/agent-message-payload.js

@@ -49,6 +49,61 @@ export const schema = {
         finishedAt: {
             type: 'number',
             description: 'Timestamp when the message finished processing'
+        },
+        span: {
+            type: 'object',
+            description: 'The span for the agent run associated with this message',
+            properties: {
+                traceId: {
+                    type: 'string'
+                },
+                spanId: {
+                    type: 'string'
+                },
+                name: {
+                    type: 'string'
+                },
+                createdAt: {
+                    type: 'number'
+                }
+            },
+            required: ['traceId', 'spanId', 'name', 'createdAt'],
+            additionalProperties: false
+        },
+        feedback: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Name of the feedback, e.g., "Quality", "Relevance"'
+                },
+                label: {
+                    type: 'string',
+                    description: 'String feedback for the agent message, e.g., "helpful", "not helpful". If a label is provided, a score must not be provided.'
+                },
+                score: {
+                    type: 'number',
+                    description: 'Numeric feedback for the agent message, typically between 1 and 5. If a score is provided, a label must not be provided.'
+                },
+                text: {
+                    type: 'string',
+                    description: 'Freeform text feedback for the agent message.'
+                },
+                note: {
+                    type: 'string',
+                    description: 'Optional note for the feedback, e.g., "This was helpful because..."'
+                },
+                updatedBy: {
+                    type: 'string',
+                    description: 'A string identifying the user who is adding the annotation, such as a name or email address.'
+                },
+                createdAt: {
+                    type: 'number',
+                    description: 'Timestamp when the feedback was created'
+                }
+            },
+            additionalProperties: false,
+            required: ['name']
         }
     },
     required: ['messageId', 'sessionId', 'projectId', 'runMode'],

package/dist/resolvers/ai/constants.d.ts

@@ -6,3 +6,4 @@ export declare const AI_AGENT_CHAT_RESPONSE_SHAPE_NAME = "TSChatResponse";
 export declare const AI_AGENT_CHAT_PAYLOAD_SHAPE_NAME = "TSChatPayload";
 export declare const AI_AGENT_ABORT_AGENT_MESSAGE_RESPONSE_SHAPE_NAME = "TSAbortAgentMessageResponse";
 export declare const AI_AGENT_RUN_MODE_SHAPE_NAME = "TSAgentRunMode";
+export declare const AI_AGENT_SEND_AGENT_FEEDBACK_SHAPE_NAME = "TSSendAgentFeedback";

package/dist/resolvers/ai/constants.js

@@ -6,3 +6,4 @@ export const AI_AGENT_CHAT_RESPONSE_SHAPE_NAME = 'TSChatResponse';
 export const AI_AGENT_CHAT_PAYLOAD_SHAPE_NAME = 'TSChatPayload';
 export const AI_AGENT_ABORT_AGENT_MESSAGE_RESPONSE_SHAPE_NAME = 'TSAbortAgentMessageResponse';
 export const AI_AGENT_RUN_MODE_SHAPE_NAME = 'TSAgentRunMode';
+export const AI_AGENT_SEND_AGENT_FEEDBACK_SHAPE_NAME = 'TSSendAgentFeedback';

package/dist/resolvers/ai/get-agent-message-response.d.ts

@@ -115,6 +115,61 @@ export declare const schema: {
             readonly type: "number";
             readonly description: "Timestamp when the message finished processing";
         };
+        readonly span: {
+            readonly type: "object";
+            readonly description: "The span for the agent run associated with this message";
+            readonly properties: {
+                readonly traceId: {
+                    readonly type: "string";
+                };
+                readonly spanId: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly createdAt: {
+                    readonly type: "number";
+                };
+            };
+            readonly required: ["traceId", "spanId", "name", "createdAt"];
+            readonly additionalProperties: false;
+        };
+        readonly feedback: {
+            readonly type: "object";
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly description: "Name of the feedback, e.g., \"Quality\", \"Relevance\"";
+                };
+                readonly label: {
+                    readonly type: "string";
+                    readonly description: "String feedback for the agent message, e.g., \"helpful\", \"not helpful\". If a label is provided, a score must not be provided.";
+                };
+                readonly score: {
+                    readonly type: "number";
+                    readonly description: "Numeric feedback for the agent message, typically between 1 and 5. If a score is provided, a label must not be provided.";
+                };
+                readonly text: {
+                    readonly type: "string";
+                    readonly description: "Freeform text feedback for the agent message.";
+                };
+                readonly note: {
+                    readonly type: "string";
+                    readonly description: "Optional note for the feedback, e.g., \"This was helpful because...\"";
+                };
+                readonly updatedBy: {
+                    readonly type: "string";
+                    readonly description: "A string identifying the user who is adding the annotation, such as a name or email address.";
+                };
+                readonly createdAt: {
+                    readonly type: "number";
+                    readonly description: "Timestamp when the feedback was created";
+                };
+            };
+            readonly additionalProperties: false;
+            readonly required: ["name"];
+        };
     };
     readonly required: ["messageId", "status"];
     readonly additionalProperties: true;

package/dist/resolvers/ai/send-agent-feedback-args.d.ts

@@ -0,0 +1,52 @@
+import type { FromSchema } from 'json-schema-to-ts';
+export declare const shapeName = "TSSendAgentFeedback";
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+            readonly description: "Name of the feedback, e.g., \"Quality\", \"Relevance\"";
+        };
+        readonly label: {
+            readonly type: "string";
+            readonly description: "String feedback for the agent message, e.g., \"helpful\", \"not helpful\". If a label is provided, a score must not be provided.";
+        };
+        readonly score: {
+            readonly type: "number";
+            readonly description: "Numeric feedback for the agent message, typically between 1 and 5. If a score is provided, a label must not be provided.";
+        };
+        readonly text: {
+            readonly type: "string";
+            readonly description: "Freeform text feedback for the agent message.";
+        };
+        readonly note: {
+            readonly type: "string";
+            readonly description: "Optional note for the feedback, e.g., \"This was helpful because...\"";
+        };
+        readonly updatedBy: {
+            readonly type: "string";
+            readonly description: "A string identifying the user who is adding the annotation, such as a name or email address.";
+        };
+        readonly createdAt: {
+            readonly type: "number";
+            readonly description: "Timestamp when the feedback was created";
+        };
+        readonly messageId: {
+            readonly type: "string";
+            readonly description: "Message ID for the message.";
+        };
+    };
+    readonly required: ["messageId", "name"];
+    readonly additionalProperties: false;
+};
+export type SendAgentFeedbackArgs = FromSchema<typeof schema>;
+export declare const validate: import("ajv").ValidateFunction<{
+    createdAt?: number | undefined;
+    label?: string | undefined;
+    score?: number | undefined;
+    text?: string | undefined;
+    note?: string | undefined;
+    updatedBy?: string | undefined;
+    messageId: string;
+    name: string;
+}>;

package/dist/resolvers/ai/send-agent-feedback-args.js

@@ -0,0 +1,17 @@
+import { createTypedValidator } from '@takeshape/json-schema';
+import * as agentMessagePayload from "./agent-message-payload.js";
+import { AI_AGENT_SEND_AGENT_FEEDBACK_SHAPE_NAME } from "./constants.js";
+export const shapeName = AI_AGENT_SEND_AGENT_FEEDBACK_SHAPE_NAME;
+export const schema = {
+    type: 'object',
+    properties: {
+        messageId: {
+            type: 'string',
+            description: 'Message ID for the message.'
+        },
+        ...agentMessagePayload.schema.properties.feedback.properties
+    },
+    required: ['messageId', ...agentMessagePayload.schema.properties.feedback.required],
+    additionalProperties: false
+};
+export const validate = createTypedValidator(schema);

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

@@ -897,6 +897,28 @@
       "required": ["name", "agentName"],
       "additionalProperties": false
     },
+    "aiSendAgentFeedbackResolver": {
+      "title": "AISendAgentFeedbackResolver",
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(?=[a-zA-Z])[-_a-zA-Z0-9]+$"
+        },
+        "name": {
+          "title": "AI Resolver Name",
+          "type": "string",
+          "description": "Name of the resolver function.",
+          "enum": ["ai:sendAgentFeedback"]
+        },
+        "agentName": {
+          "type": "string",
+          "pattern": "^[0-9A-Za-z_]+$"
+        }
+      },
+      "required": ["name", "agentName"],
+      "additionalProperties": false
+    },
     "guard": {
       "title": "GuardJSON",
       "description": "A Guard is a configuration for an AI guardrail that can check inputs and outputs and provide safety and compliance.",

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

@@ -952,6 +952,9 @@
         },
         {
           "$ref": "https://schema.takeshape.io/project-schema/experimental#/definitions/aiAbortAgentMessageResolver"
+        },
+        {
+          "$ref": "https://schema.takeshape.io/project-schema/experimental#/definitions/aiSendAgentFeedbackResolver"
         }
       ]
     },

package/dist/schemas/project-schema/v3.56.0.json

@@ -952,6 +952,9 @@
         },
         {
           "$ref": "https://schema.takeshape.io/project-schema/experimental#/definitions/aiAbortAgentMessageResolver"
+        },
+        {
+          "$ref": "https://schema.takeshape.io/project-schema/experimental#/definitions/aiSendAgentFeedbackResolver"
         }
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "11.104.4",
+  "version": "11.105.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.104.4",
-    "@takeshape/util": "11.104.4",
-    "@takeshape/json-schema": "11.104.4"
+    "@takeshape/errors": "11.105.0",
+    "@takeshape/json-schema": "11.105.0",
+    "@takeshape/util": "11.105.0"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "^11.0.0",
@@ -77,7 +77,7 @@
     "glob": "^7.1.6",
     "json-schema-to-ts": "^3.1.1",
     "shortid": "2.2.16",
-    "@takeshape/infra": "11.104.4"
+    "@takeshape/infra": "11.105.0"
   },
   "engines": {
     "node": ">=22"