samva 0.25.0 → 0.27.0

package/README.md

@@ -188,6 +188,7 @@ match the template's input schema. `samva templates types` generates TypeScript
 
 The Promise client exposes:
 
+- `agents`
 - `analytics`
 - `apiKeys`
 - `attachments`
@@ -215,6 +216,7 @@ The Promise client exposes:
 
 The Effect SDK exposes Pascal-cased domain modules with lower-camel operations:
 
+- `Agents`
 - `Analytics`
 - `ApiKeys`
 - `Attachments`

package/dist/client/sdk.gen.js

@@ -4616,6 +4616,250 @@ var Journeys = class {
 		});
 	}
 };
+var Agents = class {
+	/**
+	* List agents
+	*
+	* Returns the agents the caller can reach, newest first, without their drafts. Pass nextCursor back as cursor for the next page.
+	*/
+	static list(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "query",
+			key: "limit"
+		}, {
+			in: "query",
+			key: "cursor"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Create an agent
+	*
+	* Creates an agent with a draft and returns it with status 201. The agent answers nothing until its draft is published. A new agent starts in supervised mode, so each reply waits for a person to approve it. The namespace is set at creation and cannot change.
+	*/
+	static create(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "name"
+			},
+			{
+				in: "body",
+				key: "namespaceId"
+			},
+			{
+				in: "body",
+				key: "definition"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Delete an agent
+	*
+	* Deletes an agent with its draft and published versions. The endpoints it answered on stop being answered by an agent. A reply already running finishes on the version it started on.
+	*/
+	static remove(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}] }]);
+		return (options?.client ?? client).delete({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Get an agent
+	*
+	* Returns an agent with its draft, its current revision, and its newest published version number.
+	*/
+	static get(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Rename an agent
+	*
+	* Renames an agent.
+	*/
+	static update(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "body",
+			key: "name"
+		}] }]);
+		return (options?.client ?? client).patch({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Replace an agent draft
+	*
+	* Replaces the whole draft and returns the agent with a new revision. The request names the revision it read; a stale revision returns 409. Published versions, and the conversations answered on them, do not change. An endpoint answers for one agent at a time: a draft that names an endpoint another agent answers on returns 409.
+	*/
+	static replaceDraft(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "revision"
+			},
+			{
+				in: "body",
+				key: "definition"
+			}
+		] }]);
+		return (options?.client ?? client).put({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}/draft",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Publish an agent
+	*
+	* Publishes the draft as the next immutable version. Each conversation moves to it from its next agent reply; a reply already running finishes on the version it started on. The request names the revision it read; a stale revision returns 409. Publishing a draft identical to the newest version changes nothing and answers published false. An endpoint answers for one agent at a time: publishing a draft whose endpoint another agent answers on returns 409. In supervised mode each reply waits for a person to approve it.
+	*/
+	static publish(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "body",
+			key: "revision"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}/publish",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* List published agent versions
+	*
+	* Returns an agent's published versions, newest first, without their definitions. Pass nextCursor back as cursor for the next page.
+	*/
+	static listVersions(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "query",
+				key: "limit"
+			},
+			{
+				in: "query",
+				key: "cursor"
+			}
+		] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}/versions",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Get a published agent version
+	*
+	* Returns the immutable definition of one published version.
+	*/
+	static getVersion(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "path",
+			key: "version"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/agents/{id}/versions/{version}",
+			...options,
+			...params
+		});
+	}
+};
 var Subscriptions = class {
 	/**
 	* Request subscription confirmation
@@ -10356,6 +10600,6 @@ var ExtensionInstallations = class {
 	}
 };
 //#endregion
-export { Analytics, ApiKeys, Attachments, Brands, Campaigns, ContactEvents, ContactGroups, Contacts, Conversations, CustomFields, Email, Events, ExtensionInstallations, Extensions, Feedback, Journeys, Mailboxes, Media, Messages, Namespaces, Operations, Organizations, ScheduledMessages, Subscriptions, Templates, Unsubscribe, Webhooks, Whoami };
+export { Agents, Analytics, ApiKeys, Attachments, Brands, Campaigns, ContactEvents, ContactGroups, Contacts, Conversations, CustomFields, Email, Events, ExtensionInstallations, Extensions, Feedback, Journeys, Mailboxes, Media, Messages, Namespaces, Operations, Organizations, ScheduledMessages, Subscriptions, Templates, Unsubscribe, Webhooks, Whoami };
 
 //# sourceMappingURL=sdk.gen.js.map

package/dist/client/types.gen.d.ts

@@ -3218,6 +3218,7 @@ export type EmailContent = {
     unsubscribeGroupId?: UnsubscribeId | null | null | undefined;
     tracking?: EmailTrackingOverrideV1 | undefined;
     footer?: EmailFooterOverride | undefined;
+    headers?: EmailCustomHeaders | null | undefined;
 };
 export type EmailContentWritable = {
     subject?: string | null | undefined;
@@ -3239,6 +3240,19 @@ export type EmailContentWritable = {
     unsubscribeGroupId?: UnsubscribeId | null | null | undefined;
     tracking?: EmailTrackingOverrideV1 | undefined;
     footer?: EmailFooterOverride | undefined;
+    headers?: EmailCustomHeadersWritable | null | undefined;
+};
+/**
+ * Custom headers copied onto the outgoing message. Each name is an RFC 5322 field name and each value is one non-empty line of printable ASCII. Names Samva or the transport own are rejected.
+ */
+export type EmailCustomHeaders = {
+    [key: string]: string;
+};
+/**
+ * Custom headers copied onto the outgoing message. Each name is an RFC 5322 field name and each value is one non-empty line of printable ASCII. Names Samva or the transport own are rejected.
+ */
+export type EmailCustomHeadersWritable = {
+    [key: string]: string | undefined;
 };
 export type EmailFooterOverride = {
     enabled?: boolean | null | undefined;
@@ -3321,6 +3335,7 @@ export type EmailDispatchContent = {
     unsubscribeGroupId?: UnsubscribeId | null | null | undefined;
     tracking?: EmailTrackingOverrideV1 | undefined;
     footer?: EmailFooterOverride | undefined;
+    headers?: EmailCustomHeadersWritable | null | undefined;
 };
 export type CampaignPage = {
     items: Array<CampaignListItem>;

package/dist/effect/agents.d.ts

@@ -0,0 +1,121 @@
+export declare const list: ((input?: {
+    readonly limit?: string | null | undefined;
+    readonly cursor?: string | null | undefined;
+} | undefined) => import("./internal/operation").OperationResult<"agentsList">) & {
+    readonly pages: (input?: {
+        readonly limit?: string | null | undefined;
+        readonly cursor?: string | null | undefined;
+    } | undefined) => import("effect/Stream").Stream<{
+        readonly items: readonly {
+            readonly id: string & import("effect/Brand").Brand<"AgentId">;
+            readonly name: string;
+            readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
+            readonly publishedVersion: number | null;
+            readonly publishedAt: string | null;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly nextCursor: string | null;
+    }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+    readonly items: (input?: {
+        readonly limit?: string | null | undefined;
+        readonly cursor?: string | null | undefined;
+    } | undefined) => import("effect/Stream").Stream<{
+        readonly id: string & import("effect/Brand").Brand<"AgentId">;
+        readonly name: string;
+        readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
+        readonly publishedVersion: number | null;
+        readonly publishedAt: string | null;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+};
+export declare const create: (input: {
+    readonly name: string;
+    readonly namespaceId?: string | null | undefined;
+    readonly definition?: {
+        readonly instructions: string;
+        readonly knowledge: string;
+        readonly endpointIds: readonly string[];
+        readonly integrationIds: readonly string[];
+        readonly mode: "live" | "supervised";
+        readonly model: "max" | "standard";
+        readonly approvalPolicy: "none" | "toolActions";
+        readonly workingHours: {
+            readonly timeZone: string;
+            readonly ranges: readonly {
+                readonly day: "friday" | "monday" | "saturday" | "sunday" | "thursday" | "tuesday" | "wednesday";
+                readonly opens: string;
+                readonly closes: string;
+            }[];
+        } | null;
+        readonly takeoverTimeoutMinutes: number;
+    } | null | undefined;
+}) => import("./internal/operation").OperationResult<"agentsCreate">;
+export declare const get: (input: {
+    readonly id: string;
+}) => import("./internal/operation").OperationResult<"agentsGet">;
+export declare const update: (input: {
+    readonly id: string;
+    readonly name: string;
+}) => import("./internal/operation").OperationResult<"agentsUpdate">;
+export declare const remove: (input: {
+    readonly id: string;
+}) => import("./internal/operation").OperationResult<"agentsRemove">;
+export declare const replaceDraft: (input: {
+    readonly id: string;
+    readonly revision: string;
+    readonly definition: {
+        readonly instructions: string;
+        readonly knowledge: string;
+        readonly endpointIds: readonly string[];
+        readonly integrationIds: readonly string[];
+        readonly mode: "live" | "supervised";
+        readonly model: "max" | "standard";
+        readonly approvalPolicy: "none" | "toolActions";
+        readonly workingHours: {
+            readonly timeZone: string;
+            readonly ranges: readonly {
+                readonly day: "friday" | "monday" | "saturday" | "sunday" | "thursday" | "tuesday" | "wednesday";
+                readonly opens: string;
+                readonly closes: string;
+            }[];
+        } | null;
+        readonly takeoverTimeoutMinutes: number;
+    };
+}) => import("./internal/operation").OperationResult<"agentsReplaceDraft">;
+export declare const publish: (input: {
+    readonly id: string;
+    readonly revision: string;
+}) => import("./internal/operation").OperationResult<"agentsPublish">;
+export declare const listVersions: ((input: {
+    readonly id: string;
+    readonly limit?: string | null | undefined;
+    readonly cursor?: string | null | undefined;
+}) => import("./internal/operation").OperationResult<"agentsListVersions">) & {
+    readonly pages: (input: {
+        readonly id: string;
+        readonly limit?: string | null | undefined;
+        readonly cursor?: string | null | undefined;
+    }) => import("effect/Stream").Stream<{
+        readonly items: readonly {
+            readonly agentId: string & import("effect/Brand").Brand<"AgentId">;
+            readonly version: number;
+            readonly publishedAt: string;
+        }[];
+        readonly nextCursor: string | null;
+    }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+    readonly items: (input: {
+        readonly id: string;
+        readonly limit?: string | null | undefined;
+        readonly cursor?: string | null | undefined;
+    }) => import("effect/Stream").Stream<{
+        readonly agentId: string & import("effect/Brand").Brand<"AgentId">;
+        readonly version: number;
+        readonly publishedAt: string;
+    }, import("./errors").ForbiddenError | import("./errors").GatewayTimeoutError | import("effect/http/HttpClientError").HttpClientError | import("./errors").InternalError | import("./errors").ResourceNotFoundError | import("effect/Schema").SchemaError | import("./errors").UnauthorizedError | import("./errors").ValidationError, import("./client").Service>;
+};
+export declare const getVersion: (input: {
+    readonly id: string;
+    readonly version: string;
+}) => import("./internal/operation").OperationResult<"agentsGetVersion">;

package/dist/effect/agents.js

@@ -0,0 +1,29 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { AgentsGroup } from "./generated/agents.js";
+import { forGroup } from "./internal/operation.js";
+//#region src/effect/agents.ts
+var agents_exports = /* @__PURE__ */ __exportAll({
+	create: () => create,
+	get: () => get,
+	getVersion: () => getVersion,
+	list: () => list,
+	listVersions: () => listVersions,
+	publish: () => publish,
+	remove: () => remove,
+	replaceDraft: () => replaceDraft,
+	update: () => update
+});
+const make = /* @__PURE__ */ forGroup(AgentsGroup);
+const list = /* @__PURE__ */ make("agentsList");
+const create = /* @__PURE__ */ make("agentsCreate");
+const get = /* @__PURE__ */ make("agentsGet");
+const update = /* @__PURE__ */ make("agentsUpdate");
+const remove = /* @__PURE__ */ make("agentsRemove");
+const replaceDraft = /* @__PURE__ */ make("agentsReplaceDraft");
+const publish = /* @__PURE__ */ make("agentsPublish");
+const listVersions = /* @__PURE__ */ make("agentsListVersions");
+const getVersion = /* @__PURE__ */ make("agentsGetVersion");
+//#endregion
+export { agents_exports, create, get, getVersion, list, listVersions, publish, remove, replaceDraft, update };
+
+//# sourceMappingURL=agents.js.map

package/dist/effect/analytics.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
-import { AnalyticsGroup } from "./generated/analytics.js";
 import { forGroup } from "./internal/operation.js";
+import { AnalyticsGroup } from "./generated/analytics.js";
 //#region src/effect/analytics.ts
 var analytics_exports = /* @__PURE__ */ __exportAll({
 	exportData: () => exportData,

package/dist/effect/campaigns.d.ts

@@ -44,6 +44,9 @@ export declare const list: ((input?: {
                     readonly footer?: {
                         readonly enabled?: boolean | null;
                     };
+                    readonly headers?: {
+                        readonly [x: string]: string;
+                    } | null;
                 };
                 readonly conversationId?: (string & import("effect/Brand").Brand<"ConversationId">) | null;
                 readonly metadata?: {
@@ -125,6 +128,9 @@ export declare const list: ((input?: {
                 readonly footer?: {
                     readonly enabled?: boolean | null;
                 };
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | null;
             };
             readonly conversationId?: (string & import("effect/Brand").Brand<"ConversationId">) | null;
             readonly metadata?: {
@@ -224,6 +230,9 @@ export declare const create: (input: {
             readonly footer?: {
                 readonly enabled?: boolean | null | undefined;
             } | undefined;
+            readonly headers?: {
+                readonly [x: string]: string | undefined;
+            } | null | undefined;
         };
         readonly conversationId?: string | null | undefined;
         readonly metadata?: {
@@ -330,6 +339,9 @@ export declare const update: (input: {
             readonly footer?: {
                 readonly enabled?: boolean | null | undefined;
             } | undefined;
+            readonly headers?: {
+                readonly [x: string]: string | undefined;
+            } | null | undefined;
         };
         readonly conversationId?: string | null | undefined;
         readonly metadata?: {
@@ -423,6 +435,9 @@ export declare const listRuns: ((input: {
                     readonly footer?: {
                         readonly enabled?: boolean | null;
                     };
+                    readonly headers?: {
+                        readonly [x: string]: string;
+                    } | null;
                 };
                 readonly conversationId?: (string & import("effect/Brand").Brand<"ConversationId">) | null;
                 readonly metadata?: {
@@ -508,6 +523,9 @@ export declare const listRuns: ((input: {
                 readonly footer?: {
                     readonly enabled?: boolean | null;
                 };
+                readonly headers?: {
+                    readonly [x: string]: string;
+                } | null;
             };
             readonly conversationId?: (string & import("effect/Brand").Brand<"ConversationId">) | null;
             readonly metadata?: {