terse-types 0.0.52 → 0.0.54

package/dist/ApiRouteBuilder.d.ts

@@ -148,10 +148,21 @@ export declare const ApiRoutes: {
         TOOL_EXECUTE: string;
         TOOL_DEFINITIONS: string;
         RUN_TRIGGER_EVENT: string;
+        TEST_RUN: string;
+        TEST_RUN_FINALIZE: string;
         AGENT_RUN: string;
+        MEMORY_LIST: string;
+        MEMORY_GET: string;
+        MEMORY_PUT: string;
+        MEMORY_DELETE: string;
+        STATE_GET: string;
+        STATE_PUT: string;
         APPROVAL_DECISION: string;
         SESSION_EVENTS: string;
         LISTEN: string;
+        SUSPEND: string;
+        RESUME: string;
+        INPUT_REQUEST: string;
         CREATE_PROJECT: string;
         DEPLOY: string;
         IDENTIFY: string;

package/dist/ApiRoutes.json

@@ -148,10 +148,21 @@
         "TOOL_EXECUTE": "/sdk/tool-execute",
         "TOOL_DEFINITIONS": "/sdk/tool-definitions",
         "RUN_TRIGGER_EVENT": "/sdk/runs/:runId/trigger-event",
+        "TEST_RUN": "/sdk/test-run",
+        "TEST_RUN_FINALIZE": "/sdk/test-run/:runId/finalize",
         "AGENT_RUN": "/sdk/agent-run",
+        "MEMORY_LIST": "/sdk/memory/list",
+        "MEMORY_GET": "/sdk/memory/get",
+        "MEMORY_PUT": "/sdk/memory/put",
+        "MEMORY_DELETE": "/sdk/memory/delete",
+        "STATE_GET": "/sdk/state/get",
+        "STATE_PUT": "/sdk/state/put",
         "APPROVAL_DECISION": "/sdk/approval-decision",
         "SESSION_EVENTS": "/sdk/session-events",
         "LISTEN": "/sdk/listen",
+        "SUSPEND": "/sdk/suspend",
+        "RESUME": "/sdk/resume",
+        "INPUT_REQUEST": "/sdk/input-request",
         "CREATE_PROJECT": "/sdk/projects",
         "DEPLOY": "/sdk/deploy",
         "IDENTIFY": "/sdk/auth/identify",

package/dist/AttioRecordFlatten.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Collapses a single Attio value entry (or nested structure) toward primitives /
+ * simple objects, matching the shape produced for generated Attio tool outputs.
+ */
+export declare function flattenAttioLeafValue(value: unknown): unknown;
+/**
+ * Flattens one attribute’s raw value (often an array of interaction rows from the REST API).
+ * @param preferArray When true, keep all entries as an array; when false, use the first entry only.
+ */
+export declare function flattenAttioAttributeValue(rawValue: unknown, preferArray: boolean): unknown;
+/**
+ * Flattens `record.values` from Attio’s GET record / webhook enrichment payload.
+ */
+export declare function flattenAttioRecordValues(values: Record<string, unknown>, isMultiValueAttribute: (attributeSlug: string) => boolean): Record<string, unknown>;
+/**
+ * Slug-only heuristic when object attribute metadata is unavailable (e.g. Attio webhook triggers).
+ * Prefer {@link flattenAttioRecordValues} with object-aware multi-value info from codegen when possible.
+ */
+export declare function isProbablyAttioMultiValueAttributeSlug(attributeSlug: string): boolean;

package/dist/AttioRecordFlatten.js

@@ -0,0 +1,71 @@
+/** Keys Attio nests on attribute timeline entries (not the semantic payload). */
+const ATTIO_VALUE_METADATA_KEYS = new Set([
+    "active_from",
+    "active_until",
+    "attribute_type",
+    "created_by_actor"
+]);
+/**
+ * Collapses a single Attio value entry (or nested structure) toward primitives /
+ * simple objects, matching the shape produced for generated Attio tool outputs.
+ */
+export function flattenAttioLeafValue(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (Array.isArray(value))
+        return value.map(entry => flattenAttioLeafValue(entry));
+    if (typeof value !== "object")
+        return value;
+    const rawObject = value;
+    if (typeof rawObject.full_name === "string")
+        return rawObject.full_name;
+    if (typeof rawObject.email_address === "string")
+        return rawObject.email_address;
+    if (typeof rawObject.domain === "string")
+        return rawObject.domain;
+    if (typeof rawObject.phone_number === "string")
+        return rawObject.phone_number;
+    if ("value" in rawObject)
+        return flattenAttioLeafValue(rawObject.value);
+    const dataEntries = Object.entries(rawObject).filter(([key]) => !ATTIO_VALUE_METADATA_KEYS.has(key));
+    if (dataEntries.length === 0)
+        return rawObject;
+    if (dataEntries.length === 1)
+        return flattenAttioLeafValue(dataEntries[0][1]);
+    return Object.fromEntries(dataEntries.map(([key, entryValue]) => [key, flattenAttioLeafValue(entryValue)]));
+}
+/**
+ * Flattens one attribute’s raw value (often an array of interaction rows from the REST API).
+ * @param preferArray When true, keep all entries as an array; when false, use the first entry only.
+ */
+export function flattenAttioAttributeValue(rawValue, preferArray) {
+    if (!Array.isArray(rawValue))
+        return flattenAttioLeafValue(rawValue);
+    const flattened = rawValue.map(entry => flattenAttioLeafValue(entry)).filter(entry => entry !== undefined);
+    return preferArray ? flattened : flattened[0];
+}
+/**
+ * Flattens `record.values` from Attio’s GET record / webhook enrichment payload.
+ */
+export function flattenAttioRecordValues(values, isMultiValueAttribute) {
+    const flattenedValues = {};
+    for (const [attributeSlug, rawValue] of Object.entries(values)) {
+        flattenedValues[attributeSlug] = flattenAttioAttributeValue(rawValue, isMultiValueAttribute(attributeSlug));
+    }
+    return flattenedValues;
+}
+/**
+ * Slug-only heuristic when object attribute metadata is unavailable (e.g. Attio webhook triggers).
+ * Prefer {@link flattenAttioRecordValues} with object-aware multi-value info from codegen when possible.
+ */
+export function isProbablyAttioMultiValueAttributeSlug(attributeSlug) {
+    const slug = attributeSlug.toLowerCase();
+    return (slug === "email_addresses" ||
+        slug === "domains" ||
+        slug === "phone_numbers" ||
+        slug === "social_profiles" ||
+        slug === "links" ||
+        slug === "tags" ||
+        slug.endsWith("_addresses") ||
+        slug.endsWith("_ids"));
+}

package/dist/Configs.d.ts

@@ -16,6 +16,7 @@ export declare enum ConfigType {
     LAUNCHDARKLY = "launchdarkly",
     WEB = "web",
     IMAGE_EDIT = "image_edit",
+    MEMORY = "memory",
     WORKOS_INPUT = "workos_input",
     WORKOS_OUTPUT = "workos_output",
     ATTIO_INPUT = "attio_input",
@@ -160,6 +161,14 @@ export declare const ImageEditConfigMetadata: {
     readonly isInput: false;
     readonly isOutput: true;
 };
+export declare const MemoryConfigMetadata: {
+    readonly configType: ConfigType.MEMORY;
+    readonly name: "Memory";
+    readonly description: "Built-in persistent memory the agent can read and write across runs";
+    readonly integrationType: IntegrationType.TERSE;
+    readonly isInput: false;
+    readonly isOutput: true;
+};
 export declare const WorkOSInputConfigMetadata: {
     readonly configType: ConfigType.WORKOS_INPUT;
     readonly name: "WorkOS";
@@ -702,6 +711,18 @@ export declare class ImageEditConfig extends BaseConfigInstance<IntegrationType.
     isComplete(): boolean;
     formatForAgent(): string;
 }
+export declare const MemoryConfigSchema: z.ZodObject<{
+    integrationId: z.ZodLiteral<"system">;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    configType: z.ZodLiteral<ConfigType.MEMORY>;
+}, z.core.$strip>;
+export type MemoryConfigData = z.infer<typeof MemoryConfigSchema>;
+export type MemoryConfigInstance = MemoryConfigData & ConfigBehavior;
+export declare class MemoryConfig extends BaseConfigInstance<IntegrationType.TERSE, ConfigType.MEMORY, "system"> implements MemoryConfigInstance {
+    constructor();
+    isComplete(): boolean;
+    formatForAgent(): string;
+}
 export declare const WorkOSInputConfigSchema: z.ZodObject<{
     integrationId: z.ZodString;
     integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
@@ -1086,6 +1107,10 @@ export declare const configDataSchema: z.ZodUnion<readonly [z.ZodObject<{
     integrationId: z.ZodLiteral<"system">;
     integrationType: z.ZodLiteral<IntegrationType.TERSE>;
     configType: z.ZodLiteral<ConfigType.IMAGE_EDIT>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodLiteral<"system">;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    configType: z.ZodLiteral<ConfigType.MEMORY>;
 }, z.core.$strip>, z.ZodObject<{
     integrationId: z.ZodString;
     integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
@@ -1443,6 +1468,10 @@ export declare const skillConfigDataSchema: z.ZodUnion<readonly [z.ZodObject<{
     integrationId: z.ZodLiteral<"system">;
     integrationType: z.ZodLiteral<IntegrationType.TERSE>;
     configType: z.ZodLiteral<ConfigType.IMAGE_EDIT>;
+}, z.core.$strip>, z.ZodObject<{
+    integrationId: z.ZodLiteral<"system">;
+    integrationType: z.ZodLiteral<IntegrationType.TERSE>;
+    configType: z.ZodLiteral<ConfigType.MEMORY>;
 }, z.core.$strip>, z.ZodObject<{
     integrationId: z.ZodString;
     integrationType: z.ZodLiteral<IntegrationType.WORKOS>;
@@ -1477,6 +1506,7 @@ export type ConfigMetadataMap = EnsureExhaustiveMetadata<{
     [ConfigType.LAUNCHDARKLY]: typeof LaunchDarklyConfig;
     [ConfigType.WEB]: typeof WebConfig;
     [ConfigType.IMAGE_EDIT]: typeof ImageEditConfig;
+    [ConfigType.MEMORY]: typeof MemoryConfig;
     [ConfigType.WORKOS_INPUT]: typeof WorkOSInputConfig;
     [ConfigType.WORKOS_OUTPUT]: typeof WorkOSOutputConfig;
     [ConfigType.ATTIO_INPUT]: typeof AttioInputConfig;

package/dist/Configs.js

@@ -17,6 +17,7 @@ export var ConfigType;
     ConfigType["LAUNCHDARKLY"] = "launchdarkly";
     ConfigType["WEB"] = "web";
     ConfigType["IMAGE_EDIT"] = "image_edit";
+    ConfigType["MEMORY"] = "memory";
     ConfigType["WORKOS_INPUT"] = "workos_input";
     ConfigType["WORKOS_OUTPUT"] = "workos_output";
     ConfigType["ATTIO_INPUT"] = "attio_input";
@@ -149,6 +150,14 @@ export const ImageEditConfigMetadata = {
     isInput: false,
     isOutput: true
 };
+export const MemoryConfigMetadata = {
+    configType: ConfigType.MEMORY,
+    name: "Memory",
+    description: "Built-in persistent memory the agent can read and write across runs",
+    integrationType: IntegrationType.TERSE,
+    isInput: false,
+    isOutput: true
+};
 export const WorkOSInputConfigMetadata = {
     configType: ConfigType.WORKOS_INPUT,
     name: "WorkOS",
@@ -229,6 +238,7 @@ export const CONFIG_DETAILS = {
     [ConfigType.LAUNCHDARKLY]: LaunchDarklyConfigMetadata,
     [ConfigType.WEB]: WebConfigMetadata,
     [ConfigType.IMAGE_EDIT]: ImageEditConfigMetadata,
+    [ConfigType.MEMORY]: MemoryConfigMetadata,
     [ConfigType.WORKOS_INPUT]: WorkOSInputConfigMetadata,
     [ConfigType.WORKOS_OUTPUT]: WorkOSOutputConfigMetadata,
     [ConfigType.ATTIO_INPUT]: AttioInputConfigMetadata,
@@ -783,6 +793,22 @@ export class ImageEditConfig extends BaseConfigInstance {
         return "Type: Image Edit";
     }
 }
+export const MemoryConfigSchema = ConfigInstanceSchema.extend({
+    integrationId: z.literal("system"),
+    integrationType: z.literal(IntegrationType.TERSE),
+    configType: z.literal(ConfigType.MEMORY)
+});
+export class MemoryConfig extends BaseConfigInstance {
+    constructor() {
+        super("system", IntegrationType.TERSE, ConfigType.MEMORY);
+    }
+    isComplete() {
+        return true;
+    }
+    formatForAgent() {
+        return "Type: Memory (persistent across runs)";
+    }
+}
 export const WorkOSInputConfigSchema = ConfigInstanceSchema.extend({
     integrationType: z.literal(IntegrationType.WORKOS),
     configType: z.literal(ConfigType.WORKOS_INPUT),
@@ -998,6 +1024,7 @@ export const configDataSchema = z.union([
     LaunchDarklyConfigSchema,
     WebConfigSchema,
     ImageEditConfigSchema,
+    MemoryConfigSchema,
     WorkOSInputConfigSchema,
     WorkOSOutputConfigSchema,
     AttioInputConfigSchema,
@@ -1033,6 +1060,7 @@ export const skillConfigDataSchema = z.union([
     LaunchDarklyConfigSchema,
     WebConfigSchema,
     ImageEditConfigSchema,
+    MemoryConfigSchema,
     WorkOSOutputConfigSchema,
     AttioOutputConfigSchema,
     SnowflakeOutputConfigSchema
@@ -1049,6 +1077,7 @@ export function isConfigComplete(config) {
         case ConfigType.LINEAR_INPUT:
         case ConfigType.WEB:
         case ConfigType.IMAGE_EDIT:
+        case ConfigType.MEMORY:
         case ConfigType.WEBHOOK_INPUT:
             return true;
         case ConfigType.SLACK:
@@ -1198,6 +1227,8 @@ export function formatConfigForAgent(config) {
             return "Type: Web (search, extract, research)";
         case ConfigType.IMAGE_EDIT:
             return "Type: Image Edit";
+        case ConfigType.MEMORY:
+            return "Type: Memory (persistent across runs)";
         case ConfigType.WORKOS_INPUT:
             return `Type: WorkOS Events\nListening for: ${config.eventTypes.join(", ")}`;
         case ConfigType.HEY_REACH_INPUT: {
@@ -1254,6 +1285,7 @@ export const CONFIG_METADATA = {
     [ConfigType.LAUNCHDARKLY]: LaunchDarklyConfig,
     [ConfigType.WEB]: WebConfig,
     [ConfigType.IMAGE_EDIT]: ImageEditConfig,
+    [ConfigType.MEMORY]: MemoryConfig,
     [ConfigType.WORKOS_INPUT]: WorkOSInputConfig,
     [ConfigType.WORKOS_OUTPUT]: WorkOSOutputConfig,
     [ConfigType.ATTIO_INPUT]: AttioInputConfig,

package/dist/ModelEvents.d.ts

@@ -177,8 +177,8 @@ export declare const imageSchema: z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strip>;
 export declare const webhookFailureStageSchema: z.ZodEnum<{
-    handshake: "handshake";
     delivery: "delivery";
+    handshake: "handshake";
 }>;
 export type WebhookFailureStage = z.infer<typeof webhookFailureStageSchema>;
 /**
@@ -189,8 +189,8 @@ export type WebhookFailureStage = z.infer<typeof webhookFailureStageSchema>;
 export declare const webhookFailureSchema: z.ZodObject<{
     type: z.ZodLiteral<"webhook_failure">;
     stage: z.ZodEnum<{
-        handshake: "handshake";
         delivery: "delivery";
+        handshake: "handshake";
     }>;
     message: z.ZodString;
     triggerUrl: z.ZodString;
@@ -231,8 +231,8 @@ export declare const snippetVariantSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"webhook_failure">;
     stage: z.ZodEnum<{
-        handshake: "handshake";
         delivery: "delivery";
+        handshake: "handshake";
     }>;
     message: z.ZodString;
     triggerUrl: z.ZodString;
@@ -284,8 +284,8 @@ export declare const chatSnippetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"webhook_failure">;
     stage: z.ZodEnum<{
-        handshake: "handshake";
         delivery: "delivery";
+        handshake: "handshake";
     }>;
     message: z.ZodString;
     triggerUrl: z.ZodString;
@@ -344,8 +344,8 @@ export declare const modelEventChatSnippetSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"webhook_failure">;
         stage: z.ZodEnum<{
-            handshake: "handshake";
             delivery: "delivery";
+            handshake: "handshake";
         }>;
         message: z.ZodString;
         triggerUrl: z.ZodString;
@@ -480,8 +480,8 @@ export declare const modelEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"webhook_failure">;
         stage: z.ZodEnum<{
-            handshake: "handshake";
             delivery: "delivery";
+            handshake: "handshake";
         }>;
         message: z.ZodString;
         triggerUrl: z.ZodString;

package/dist/OrganizationMetadata.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const organizationMetadataSchema: z.ZodObject<{
+    stripeCustomerId: z.ZodString;
+    runExecutionBlocked: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>, z.ZodTransform<boolean, string | boolean | undefined>>;
+}, z.core.$strip>;
+export type OrganizationMetadata = z.infer<typeof organizationMetadataSchema>;

package/dist/OrganizationMetadata.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+// Can be serialized a string, supports deserialization
+const booleanMetadataSchema = z
+    .union([z.boolean(), z.string()])
+    .optional()
+    .transform(value => value === true || value === "true");
+export const organizationMetadataSchema = z.object({
+    stripeCustomerId: z.string(),
+    runExecutionBlocked: booleanMetadataSchema
+});

package/dist/RunHistoryTypes.d.ts

@@ -8,6 +8,7 @@ export declare const RunHistoryStatus: {
     readonly SKIPPED: "skipped";
     readonly IN_PROGRESS: "in_progress";
     readonly AWAITING_APPROVAL: "awaiting_approval";
+    readonly SUSPENDED: "suspended";
 };
 export declare const runHistoryStatusSchema: z.ZodEnum<{
     readonly SUCCESS: "success";
@@ -16,6 +17,7 @@ export declare const runHistoryStatusSchema: z.ZodEnum<{
     readonly SKIPPED: "skipped";
     readonly IN_PROGRESS: "in_progress";
     readonly AWAITING_APPROVAL: "awaiting_approval";
+    readonly SUSPENDED: "suspended";
 }>;
 export type RunHistoryStatus = z.infer<typeof runHistoryStatusSchema>;
 export declare const runHistoryDecisionActionSchema: z.ZodEnum<{
@@ -74,6 +76,7 @@ export type GetRunHistoryParams = {
     status?: RunHistoryStatus[];
     page?: number;
     pageSize?: number;
+    includeTest?: boolean;
 };
 export type GetRunHistoryResponse = {
     items: RunHistoryRecord[];

package/dist/RunHistoryTypes.js

@@ -7,7 +7,8 @@ export const RunHistoryStatus = {
     CANCELLED: "cancelled",
     SKIPPED: "skipped",
     IN_PROGRESS: "in_progress",
-    AWAITING_APPROVAL: "awaiting_approval"
+    AWAITING_APPROVAL: "awaiting_approval",
+    SUSPENDED: "suspended"
 };
 export const runHistoryStatusSchema = z.enum(RunHistoryStatus);
 export const runHistoryDecisionActionSchema = z.enum(["processed", "skipped"]);

package/dist/ToolDisplayUtils.js

@@ -14,6 +14,32 @@ function safeParseResult(result) {
         return undefined;
     }
 }
+function memoryCommand(params) {
+    const command = params?.command;
+    return command && typeof command === "object" && "op" in command ? command : undefined;
+}
+function memoryTarget(command) {
+    return command.op === "rename" ? command.old_path : (command.path ?? undefined);
+}
+function memoryLabel(command, done) {
+    if (!command)
+        return done ? "Updated memory" : "Accessing memory";
+    const target = memoryTarget(command);
+    const suffix = target ? ` ${truncate(target, 40)}` : "";
+    switch (command.op) {
+        case "view":
+            return (done ? "Read memory" : "Reading memory") + suffix;
+        case "create":
+            return (done ? "Saved memory" : "Saving memory") + suffix;
+        case "str_replace":
+        case "insert":
+            return (done ? "Updated memory" : "Updating memory") + suffix;
+        case "delete":
+            return (done ? "Deleted memory" : "Deleting memory") + suffix;
+        case "rename":
+            return done ? "Renamed memory file" : "Reorganizing memory";
+    }
+}
 /**
  * Display configurations for all tools.
  * Each tool defines how it should be displayed in preparing, executing, and complete phases.
@@ -780,6 +806,11 @@ const TOOL_DISPLAY_CONFIG = {
             return prompt ? `Image edited: "${truncate(prompt)}"` : "Image edited";
         }
     },
+    memory: {
+        preparing: "Checking memory",
+        executing: params => memoryLabel(memoryCommand(params), false),
+        complete: params => memoryLabel(memoryCommand(params), true)
+    },
     // ===================
     // Snowflake Tools
     // ===================