@keystrokehq/keystroke 1.0.14 → 1.0.17

package/dist/trigger.d.mts

@@ -144,32 +144,71 @@ type AgentAttachOptions = {
   prompt: string | ((payload: unknown) => string);
 };
 type AttachOptions<TInput = unknown, TOutput = unknown> = WorkflowAttachOptions<TInput, TOutput> | AgentAttachOptions; //#endregion
+//#region src/trigger-slug.d.ts
+/** Optional human-facing metadata (same as agents/workflows). */
+type TriggerMetaInput = {
+  name?: string;
+  description?: string;
+};
+/** Authoring input: `slug` is canonical; `key` is legacy. */
+type TriggerAuthoringSlugInput = {
+  slug?: string; /** @deprecated Use `slug`. Accepted for backwards-compatible trigger definitions. */
+  key?: string;
+};
+/** Authoring options shared by all `define*Source` factories. */
+type TriggerSourceAuthoringInput = TriggerAuthoringSlugInput & TriggerMetaInput;
+/** Resolve slug from authoring options (`slug` preferred, `key` fallback). */
+declare function resolveAuthoringSlug(input: TriggerAuthoringSlugInput, label?: string): string;
+/** Composite attachment slug `{sourceSlug}:{targetSlug}`. */
+declare function attachmentSlugFrom(sourceSlug: string, targetSlug: string): string;
+/** Read slug from a trigger source (`slug` preferred, legacy `key` fallback). */
+declare function sourceSlugFrom(source: {
+  slug?: string;
+  key?: string;
+}): string;
+/** Read slug from a trigger attachment (`slug` preferred, legacy `key` fallback). */
+declare function attachmentSlugFromRecord(attachment: {
+  slug?: string;
+  key?: string;
+}): string;
+/** Source slug prefix from a composite attachment slug. */
+declare function triggerSourceSlugFromAttachmentSlug(attachmentSlug: string): string;
+/** Target slug suffix from a composite attachment slug. */
+declare function triggerTargetSlugFromAttachmentSlug(attachmentSlug: string): string; //#endregion
 //#region src/sources/cron-source.d.ts
-type CronSource = {
+type CronSource = TriggerSourceBase & {
   kind: "cron";
-  key: string;
   schedule: CronSchedule;
   attach<TInput, TOutput>(options: AttachOptions<TInput, TOutput>): TriggerAttachment;
 };
+type TriggerSourceBase = {
+  slug: string;
+  name?: string;
+  description?: string;
+};
 /**
  * Defines a cron trigger source — fires its attached workflow on a schedule.
  *
- * @param options.key - Stable trigger key; the attachment id is `{key}:{workflowKey}`.
+ * @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+ * @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
+ * @param options.name - Optional human-readable name shown in the platform.
+ * @param options.description - Optional short description shown in the platform.
  * @param options.schedule - A cron expression. Pass a 5-field literal (e.g.
  *   `"0 9 * * *"`) for compile-time shape checking, or wrap with
  *   `parseCronSchedule(...)` for 6-field, named (`MON`), or `@daily`-style
  *   schedules. Validated at runtime; throws if the expression is invalid.
  * @example
- * defineCronSource({ key: "morning", schedule: "0 9 * * *" }).attach({ workflow });
+ * defineCronSource({ slug: "morning", schedule: "0 9 * * *" }).attach({ workflow });
  */
-declare function defineCronSource(options: {
-  key: string;
+declare function defineCronSource(options: TriggerSourceAuthoringInput & {
   schedule: CronScheduleInput;
 }): CronSource; //#endregion
 //#region src/sources/poll-source.d.ts
 type PollSource<TResult = unknown> = {
   kind: "poll";
-  key: string;
+  slug: string;
+  name?: string;
+  description?: string;
   id?: string;
   schedule: CronSchedule;
   run: () => TResult | Promise<TResult>;
@@ -184,18 +223,18 @@ type PollSourceChain<TResult> = PollSource<TResult> & {
  * Defines a poll trigger source — runs `run` on a schedule and, when the result
  * passes any `.filter(...)`, fires the attached workflow with it.
  *
- * @param options.key - Stable trigger key; the attachment id is `{key}:{workflowKey}`.
+ * @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+ * @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
  * @param options.id - Optional group id; poll sources sharing an id poll together.
  * @param options.schedule - Cron expression for the poll cadence (see `defineCronSource`).
  * @param options.run - Produces the payload checked by `filter` and passed to the workflow.
  * @param options.filter - Source-level predicate; the workflow only fires when it returns true.
  * @example
- * definePollSource({ key: "inbox", schedule: "0 * * * *", run: fetchInbox })
+ * definePollSource({ slug: "inbox", schedule: "0 * * * *", run: fetchInbox })
  *   .filter((r) => r.length > 0)
  *   .attach({ workflow });
  */
-declare function definePollSource<TResult>(options: {
-  key: string;
+declare function definePollSource<TResult>(options: TriggerSourceAuthoringInput & {
   id?: string;
   schedule: CronScheduleInput;
   run: () => TResult | Promise<TResult>;
@@ -206,7 +245,9 @@ declare const TRIGGER_ATTACHMENT: unique symbol;
 /** Trigger source as seen from outside the source factories. */
 type TriggerSource = WebhookSource | CronSource | PollSource;
 type WorkflowTriggerAttachment = {
-  key: string;
+  slug: string;
+  name?: string;
+  description?: string;
   source: TriggerSource;
   target: "workflow";
   workflow: WorkflowDefinition<any, any>;
@@ -214,7 +255,9 @@ type WorkflowTriggerAttachment = {
   readonly [TRIGGER_ATTACHMENT]: true;
 };
 type AgentTriggerAttachment = {
-  key: string;
+  slug: string;
+  name?: string;
+  description?: string;
   source: TriggerSource;
   target: "agent";
   agent: Agent;
@@ -237,7 +280,9 @@ declare function isAgentTriggerAttachment(attachment: TriggerAttachment): attach
 declare function normalizeWebhookEndpoint(endpoint: string): string;
 type WebhookSource = {
   kind: "webhook";
-  key: string;
+  slug: string;
+  name?: string;
+  description?: string;
   endpoint: string;
   request: z.ZodType;
   filter?: z.ZodType;
@@ -248,23 +293,23 @@ type WebhookSource = {
  * Defines a webhook trigger source — fires its attached workflow when a request
  * hits `/triggers/{endpoint}` and satisfies `request` plus any optional `filter`.
  *
- * @param options.key - Stable trigger key; attachment id is `{key}:{workflowKey}`.
+ * @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+ * @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
  * @param options.endpoint - Shared route suffix under `/triggers/` (e.g. `"stripe"`).
  */
-declare function defineWebhookSource<TRequestSchema extends z.ZodType, TFilterSchema extends z.ZodType | undefined = undefined>(options: {
-  key: string;
+declare function defineWebhookSource<TRequestSchema extends z.ZodType, TFilterSchema extends z.ZodType | undefined = undefined>(options: TriggerSourceAuthoringInput & {
   endpoint: string;
   request: TRequestSchema;
   filter?: TFilterSchema;
 }): WebhookSource; //#endregion
 //#region src/trigger-match-schema.d.ts
 type WebhookAttachmentSchema = {
-  attachmentKey: string;
+  attachmentSlug: string;
   requestSchema: Record<string, unknown>;
   filterSchema?: Record<string, unknown>;
 };
 type WebhookPayloadMatch = {
-  attachmentKey: string;
+  attachmentSlug: string;
   data: unknown;
 };
 declare function matchWebhookPayload(raw: unknown, schemas: WebhookAttachmentSchema[]): WebhookPayloadMatch[]; //#endregion
@@ -313,6 +358,28 @@ type PollSkipResponse = {
   ok: true;
   skipped: true;
 }; //#endregion
+//#region src/trigger-meta.d.ts
+declare function triggerMetaFromSource(source: TriggerSource): {
+  name?: string;
+  description?: string;
+};
+declare function triggerMetaFromAttachment(attachment: TriggerAttachment): {
+  name?: string;
+  description?: string;
+};
+declare function triggerMetaRecordFromAttachment(attachment: TriggerAttachment): {
+  name: string | null;
+  description: string | null;
+}; //#endregion
+//#region src/attachment-slug.d.ts
+declare function workflowSlugFromDefinition(workflow: WorkflowDefinition<unknown, unknown>): string;
+declare function agentSlugFromAgent(agent: Agent): string;
+/** @deprecated Use {@link attachmentSlugFrom}. */
+declare const attachmentKeyFrom: typeof attachmentSlugFrom;
+/** @deprecated Use {@link workflowSlugFromDefinition}. */
+declare const workflowKeyFromDefinition: typeof workflowSlugFromDefinition;
+/** @deprecated Use {@link agentSlugFromAgent}. */
+declare const agentKeyFromAgent: typeof agentSlugFromAgent; //#endregion
 //#endregion
-export { type AgentAttachOptions, type AgentTriggerAttachment, type AttachOptions, type CronExpression, type CronSchedule, type CronScheduleInput, type CronSource, type EphemeralWebhookMatch, type PollSkipResponse, type PollSource, type RunContext, TRIGGER_ATTACHMENT, type TriggerAttachment, type TriggerSource, type WebhookAttachmentSchema, type WebhookPayloadMatch, type WebhookSkipResponse, type WebhookSource, type WorkflowAttachOptions, type WorkflowTriggerAttachment, cronScheduleSchema, defineCronSource, definePollSource, defineWebhookSource, interpolatePrompt, isAgentTriggerAttachment, isTriggerAttachment, isWorkflowTriggerAttachment, matchToJsonSchema, matchWebhookPayload, nextTriggerRunAt, normalizeWebhookEndpoint, parseCronSchedule, parseTriggerSchedule, resolveAgentPrompt, resolveAttachmentInput, resolveAttachmentTransform, resolveCronSchedule };
+export { type AgentAttachOptions, type AgentTriggerAttachment, type AttachOptions, type CronExpression, type CronSchedule, type CronScheduleInput, type CronSource, type EphemeralWebhookMatch, type PollSkipResponse, type PollSource, type RunContext, TRIGGER_ATTACHMENT, type TriggerAttachment, type TriggerAuthoringSlugInput, type TriggerMetaInput, type TriggerSource, type TriggerSourceAuthoringInput, type WebhookAttachmentSchema, type WebhookPayloadMatch, type WebhookSkipResponse, type WebhookSource, type WorkflowAttachOptions, type WorkflowTriggerAttachment, agentKeyFromAgent, agentSlugFromAgent, attachmentKeyFrom, attachmentSlugFrom, attachmentSlugFromRecord, cronScheduleSchema, defineCronSource, definePollSource, defineWebhookSource, interpolatePrompt, isAgentTriggerAttachment, isTriggerAttachment, isWorkflowTriggerAttachment, matchToJsonSchema, matchWebhookPayload, nextTriggerRunAt, normalizeWebhookEndpoint, parseCronSchedule, parseTriggerSchedule, resolveAgentPrompt, resolveAttachmentInput, resolveAttachmentTransform, resolveAuthoringSlug, resolveCronSchedule, sourceSlugFrom, triggerMetaFromAttachment, triggerMetaFromSource, triggerMetaRecordFromAttachment, triggerSourceSlugFromAttachmentSlug, triggerTargetSlugFromAttachmentSlug, workflowKeyFromDefinition, workflowSlugFromDefinition };
 //# sourceMappingURL=trigger.d.mts.map

package/dist/trigger.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.mts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date","Cron","z","WorkflowDefinition","Agent","CredentialRunContext","CronField","CronExpression","cronScheduleSchema","ZodString","core","$ZodBranded","CronSchedule","infer","CronScheduleInput","parseCronSchedule","value","resolveCronSchedule","Record","attachmentId","schedule","cronScheduleOverride","attachmentScheduleOverrides","options","parseTriggerSchedule","nextTriggerRunAt","Date","from","WorkflowAttachOptions","TInput","TOutput","workflow","transform","payload","AgentAttachOptions","agent","prompt","AttachOptions","CronSource","TriggerAttachment","kind","key","attach","defineCronSource","PollSource","TResult","Promise","Array","id","run","filters","passes","PollSourceChain","filter","fn","definePollSource","TRIGGER_ATTACHMENT","TriggerSource","WebhookSource","WorkflowTriggerAttachment","source","target","AgentTriggerAttachment","isTriggerAttachment","isWorkflowTriggerAttachment","attachment","isAgentTriggerAttachment","normalizeWebhookEndpoint","endpoint","ZodType","request","defineWebhookSource","TRequestSchema","TFilterSchema","WebhookAttachmentSchema","attachmentKey","requestSchema","filterSchema","WebhookPayloadMatch","data","matchWebhookPayload","raw","schemas","EphemeralWebhookMatch","matchToJsonSchema","match","interpolatePrompt","template","resolveAgentPrompt","resolveAttachmentTransform","resolveAttachmentInput","RunContext","trigger","triggeredAt","credentials","WebhookSkipResponse","ok","skipped","PollSkipResponse"],"sources":["../../../node_modules/.pnpm/cron-schedule@6.0.0/node_modules/cron-schedule/dist/cron.d.ts","../../trigger/dist/index.d.mts"],"x_google_ignoreList":[0],"mappings":"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"}
+{"version":3,"file":"trigger.d.mts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date","Cron","z","WorkflowDefinition","Agent","CredentialRunContext","CronField","CronExpression","cronScheduleSchema","ZodString","core","$ZodBranded","CronSchedule","infer","CronScheduleInput","parseCronSchedule","value","resolveCronSchedule","Record","attachmentId","schedule","cronScheduleOverride","attachmentScheduleOverrides","options","parseTriggerSchedule","nextTriggerRunAt","Date","from","WorkflowAttachOptions","TInput","TOutput","workflow","transform","payload","AgentAttachOptions","agent","prompt","AttachOptions","TriggerMetaInput","name","description","TriggerAuthoringSlugInput","slug","key","TriggerSourceAuthoringInput","resolveAuthoringSlug","input","label","attachmentSlugFrom","sourceSlug","targetSlug","sourceSlugFrom","source","attachmentSlugFromRecord","attachment","triggerSourceSlugFromAttachmentSlug","attachmentSlug","triggerTargetSlugFromAttachmentSlug","CronSource","TriggerSourceBase","TriggerAttachment","kind","attach","defineCronSource","PollSource","TResult","Promise","Array","id","run","filters","passes","PollSourceChain","filter","fn","definePollSource","TRIGGER_ATTACHMENT","TriggerSource","WebhookSource","WorkflowTriggerAttachment","target","AgentTriggerAttachment","isTriggerAttachment","isWorkflowTriggerAttachment","isAgentTriggerAttachment","normalizeWebhookEndpoint","endpoint","ZodType","request","defineWebhookSource","TRequestSchema","TFilterSchema","WebhookAttachmentSchema","requestSchema","filterSchema","WebhookPayloadMatch","data","matchWebhookPayload","raw","schemas","EphemeralWebhookMatch","matchToJsonSchema","match","interpolatePrompt","template","resolveAgentPrompt","resolveAttachmentTransform","resolveAttachmentInput","RunContext","trigger","triggeredAt","credentials","WebhookSkipResponse","ok","skipped","PollSkipResponse","triggerMetaFromSource","triggerMetaFromAttachment","triggerMetaRecordFromAttachment","workflowSlugFromDefinition","agentSlugFromAgent","attachmentKeyFrom","workflowKeyFromDefinition","agentKeyFromAgent"],"sources":["../../../node_modules/.pnpm/cron-schedule@6.0.0/node_modules/cron-schedule/dist/cron.d.ts","../../trigger/dist/index.d.mts"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/trigger.mjs

@@ -1,4 +1,4 @@
-import { s as isWorkflow } from "./dist-DSbrc1sP.mjs";
+import { s as isWorkflow } from "./dist-DtLObwAS.mjs";
 import { z } from "zod";
 //#region ../../node_modules/.pnpm/cron-schedule@6.0.0/node_modules/cron-schedule/dist/utils.js
 function extractDateElements(date) {
@@ -438,8 +438,21 @@ const zodSchema = z.custom((v) => v instanceof z.ZodType, "must be a Zod schema"
 const workflowSchema = z.custom((v) => isWorkflow(v), "must be defineWorkflow(...)");
 const agentSchema = z.custom((v) => typeof v === "object" && v !== null && typeof v.slug === "string" && v.slug.trim().length > 0 && typeof v.prompt === "function", "must be defineAgent(...)");
 const promptSchema = z.union([z.string(), z.function()]);
+/** backwards-compat: normalize legacy `key` fields to canonical `slug` before validation. */
+function normalizeLegacySlugFields(value) {
+	if (typeof value !== "object" || value === null) return value;
+	const next = { ...value };
+	if (typeof next.slug !== "string" && typeof next.key === "string") next.slug = next.key;
+	delete next.key;
+	if (typeof next.source === "object" && next.source !== null) next.source = normalizeLegacySlugFields(next.source);
+	return next;
+}
+const slugField = z.string().trim().min(1);
+const optionalTextField = z.string().optional();
 const baseSourceShape = {
-	key: z.string().trim().min(1),
+	slug: slugField,
+	name: optionalTextField,
+	description: optionalTextField,
 	attach: z.function()
 };
 const webhookSourceSchema = z.object({
@@ -465,27 +478,32 @@ const pollSourceSchema = z.object({
 	passes: z.function()
 });
 /** Runtime validation for a trigger source (webhook | cron | poll). */
-const triggerSourceSchema = z.discriminatedUnion("kind", [
+const triggerSourceSchema = z.preprocess(normalizeLegacySlugFields, z.discriminatedUnion("kind", [
 	webhookSourceSchema,
 	cronSourceSchema,
 	pollSourceSchema
-]);
+]));
 const workflowAttachmentSchema = z.object({
-	key: z.string().trim().min(1),
+	slug: slugField,
+	name: optionalTextField,
+	description: optionalTextField,
 	source: triggerSourceSchema,
 	target: z.literal("workflow"),
 	workflow: workflowSchema,
 	transform: z.function().optional()
 });
 const agentAttachmentSchema = z.object({
-	key: z.string().trim().min(1),
+	slug: slugField,
+	name: optionalTextField,
+	description: optionalTextField,
 	source: triggerSourceSchema,
 	target: z.literal("agent"),
 	agent: agentSchema,
 	prompt: promptSchema
 });
+const triggerAttachmentCoreSchemaBase = z.discriminatedUnion("target", [workflowAttachmentSchema, agentAttachmentSchema]);
 /** Runtime validation for an unbranded trigger attachment. */
-const triggerAttachmentCoreSchema = z.discriminatedUnion("target", [workflowAttachmentSchema, agentAttachmentSchema]);
+const triggerAttachmentCoreSchema = z.preprocess(normalizeLegacySlugFields, triggerAttachmentCoreSchemaBase);
 const TRIGGER_ATTACHMENT = Symbol.for("keystroke.triggerAttachment");
 /**
 * Validates brand + shape via `triggerAttachmentCoreSchema` so server discovery
@@ -502,19 +520,54 @@ function isWorkflowTriggerAttachment(attachment) {
 function isAgentTriggerAttachment(attachment) {
 	return attachment.target === "agent";
 }
-function workflowKeyFromDefinition(workflow) {
+/** Resolve slug from authoring options (`slug` preferred, `key` fallback). */
+function resolveAuthoringSlug(input, label = "trigger") {
+	const slug = input.slug?.trim() || input.key?.trim();
+	if (!slug) throw new Error(`${label} requires a non-empty slug`);
+	return slug;
+}
+/** Composite attachment slug `{sourceSlug}:{targetSlug}`. */
+function attachmentSlugFrom(sourceSlug, targetSlug) {
+	return `${sourceSlug}:${targetSlug}`;
+}
+/** Read slug from a trigger source (`slug` preferred, legacy `key` fallback). */
+function sourceSlugFrom(source) {
+	const slug = source.slug?.trim() || source.key?.trim();
+	if (!slug) throw new Error("Trigger source requires slug or legacy key");
+	return slug;
+}
+/** Read slug from a trigger attachment (`slug` preferred, legacy `key` fallback). */
+function attachmentSlugFromRecord(attachment) {
+	const slug = attachment.slug?.trim() || attachment.key?.trim();
+	if (!slug) throw new Error("Trigger attachment requires slug or legacy key");
+	return slug;
+}
+/** Source slug prefix from a composite attachment slug. */
+function triggerSourceSlugFromAttachmentSlug(attachmentSlug) {
+	const separator = attachmentSlug.indexOf(":");
+	return separator === -1 ? attachmentSlug : attachmentSlug.slice(0, separator);
+}
+/** Target slug suffix from a composite attachment slug. */
+function triggerTargetSlugFromAttachmentSlug(attachmentSlug) {
+	const separator = attachmentSlug.indexOf(":");
+	return separator === -1 ? attachmentSlug : attachmentSlug.slice(separator + 1);
+}
+function workflowSlugFromDefinition(workflow) {
 	const slug = workflow.slug?.trim();
 	if (!slug) throw new Error("Workflow definition requires a non-empty slug");
 	return slug;
 }
-function agentKeyFromAgent(agent) {
+function agentSlugFromAgent(agent) {
 	const slug = agent.slug?.trim();
 	if (!slug) throw new Error("Agent definition requires a non-empty slug");
 	return slug;
 }
-function attachmentKeyFrom(triggerKey, targetKey) {
-	return `${triggerKey}:${targetKey}`;
-}
+/** @deprecated Use {@link attachmentSlugFrom}. */
+const attachmentKeyFrom = attachmentSlugFrom;
+/** @deprecated Use {@link workflowSlugFromDefinition}. */
+const workflowKeyFromDefinition = workflowSlugFromDefinition;
+/** @deprecated Use {@link agentSlugFromAgent}. */
+const agentKeyFromAgent = agentSlugFromAgent;
 function isAgentAttachOptions(options) {
 	return "agent" in options;
 }
@@ -527,7 +580,7 @@ function defineTriggerAttachment(input) {
 	const result = triggerAttachmentCoreSchema.safeParse(input);
 	if (!result.success) throw new Error(`Invalid trigger attachment: ${formatIssues(result.error.issues)}`);
 	return {
-		...input,
+		...result.data,
 		[TRIGGER_ATTACHMENT]: true
 	};
 }
@@ -536,16 +589,40 @@ function formatIssues(issues) {
 		return `${issue.path.length > 0 ? `${issue.path.join(".")}: ` : ""}${issue.message}`;
 	}).join("; ");
 }
-function attachFromSource(source, triggerKey, options) {
+function triggerMetaFromSource(source) {
+	return {
+		...source.name !== void 0 ? { name: source.name } : {},
+		...source.description !== void 0 ? { description: source.description } : {}
+	};
+}
+function triggerMetaFromAttachment(attachment) {
+	const name = attachment.name ?? attachment.source.name;
+	const description = attachment.description ?? attachment.source.description;
+	return {
+		...name !== void 0 ? { name } : {},
+		...description !== void 0 ? { description } : {}
+	};
+}
+function triggerMetaRecordFromAttachment(attachment) {
+	const meta = triggerMetaFromAttachment(attachment);
+	return {
+		name: meta.name ?? null,
+		description: meta.description ?? null
+	};
+}
+function attachFromSource(source, sourceSlug, options) {
+	const meta = triggerMetaFromSource(source);
 	if (isAgentAttachOptions(options)) return defineTriggerAttachment({
-		key: attachmentKeyFrom(triggerKey, agentKeyFromAgent(options.agent)),
+		slug: attachmentSlugFrom(sourceSlug, agentSlugFromAgent(options.agent)),
+		...meta,
 		source,
 		target: "agent",
 		agent: options.agent,
 		prompt: options.prompt
 	});
 	return defineTriggerAttachment({
-		key: attachmentKeyFrom(triggerKey, workflowKeyFromDefinition(options.workflow)),
+		slug: attachmentSlugFrom(sourceSlug, workflowSlugFromDefinition(options.workflow)),
+		...meta,
 		source,
 		target: "workflow",
 		workflow: options.workflow,
@@ -568,7 +645,7 @@ function matchWebhookPayload(raw, schemas) {
 		const data = matchShapeAndFilter(z.fromJSONSchema(schema.requestSchema), schema.filterSchema ? z.fromJSONSchema(schema.filterSchema) : void 0, raw);
 		if (data === void 0) continue;
 		matches.push({
-			attachmentKey: schema.attachmentKey,
+			attachmentSlug: schema.attachmentSlug,
 			data
 		});
 	}
@@ -589,19 +666,21 @@ function webhookObjectSchema(schema) {
 * Defines a webhook trigger source — fires its attached workflow when a request
 * hits `/triggers/{endpoint}` and satisfies `request` plus any optional `filter`.
 *
-* @param options.key - Stable trigger key; attachment id is `{key}:{workflowKey}`.
+* @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+* @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
 * @param options.endpoint - Shared route suffix under `/triggers/` (e.g. `"stripe"`).
 */
 function defineWebhookSource(options) {
-	const triggerKey = options.key.trim();
-	if (!triggerKey) throw new Error("defineWebhookSource requires a non-empty key");
+	const sourceSlug = resolveAuthoringSlug(options, "defineWebhookSource");
 	const endpoint = normalizeWebhookEndpoint(options.endpoint);
 	if (!endpoint) throw new Error("defineWebhookSource requires a non-empty endpoint");
 	const request = webhookObjectSchema(options.request);
 	const filter = options.filter ? webhookObjectSchema(options.filter) : void 0;
 	const source = {
 		kind: "webhook",
-		key: triggerKey,
+		slug: sourceSlug,
+		...options.name !== void 0 ? { name: options.name } : {},
+		...options.description !== void 0 ? { description: options.description } : {},
 		endpoint,
 		request,
 		filter,
@@ -609,7 +688,7 @@ function defineWebhookSource(options) {
 			return passesTriggerMatch(request, filter, payload);
 		},
 		attach(attachOptions) {
-			return attachFromSource(source, triggerKey, attachOptions);
+			return attachFromSource(source, sourceSlug, attachOptions);
 		}
 	};
 	return source;
@@ -617,23 +696,28 @@ function defineWebhookSource(options) {
 /**
 * Defines a cron trigger source — fires its attached workflow on a schedule.
 *
-* @param options.key - Stable trigger key; the attachment id is `{key}:{workflowKey}`.
+* @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+* @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
+* @param options.name - Optional human-readable name shown in the platform.
+* @param options.description - Optional short description shown in the platform.
 * @param options.schedule - A cron expression. Pass a 5-field literal (e.g.
 *   `"0 9 * * *"`) for compile-time shape checking, or wrap with
 *   `parseCronSchedule(...)` for 6-field, named (`MON`), or `@daily`-style
 *   schedules. Validated at runtime; throws if the expression is invalid.
 * @example
-* defineCronSource({ key: "morning", schedule: "0 9 * * *" }).attach({ workflow });
+* defineCronSource({ slug: "morning", schedule: "0 9 * * *" }).attach({ workflow });
 */
 function defineCronSource(options) {
-	const triggerKey = options.key.trim();
-	if (!triggerKey) throw new Error("defineCronSource requires a non-empty key");
+	const sourceSlug = resolveAuthoringSlug(options, "defineCronSource");
+	const schedule = parseCronSchedule(options.schedule);
 	const source = {
 		kind: "cron",
-		key: triggerKey,
-		schedule: parseCronSchedule(options.schedule),
+		slug: sourceSlug,
+		...options.name !== void 0 ? { name: options.name } : {},
+		...options.description !== void 0 ? { description: options.description } : {},
+		schedule,
 		attach(attachOptions) {
-			return attachFromSource(source, triggerKey, attachOptions);
+			return attachFromSource(source, sourceSlug, attachOptions);
 		}
 	};
 	return source;
@@ -642,25 +726,27 @@ function defineCronSource(options) {
 * Defines a poll trigger source — runs `run` on a schedule and, when the result
 * passes any `.filter(...)`, fires the attached workflow with it.
 *
-* @param options.key - Stable trigger key; the attachment id is `{key}:{workflowKey}`.
+* @param options.slug - Stable trigger source slug; attachment slug is `{slug}:{targetSlug}`.
+* @param options.key - **Deprecated.** Accepted for backwards-compatible definitions.
 * @param options.id - Optional group id; poll sources sharing an id poll together.
 * @param options.schedule - Cron expression for the poll cadence (see `defineCronSource`).
 * @param options.run - Produces the payload checked by `filter` and passed to the workflow.
 * @param options.filter - Source-level predicate; the workflow only fires when it returns true.
 * @example
-* definePollSource({ key: "inbox", schedule: "0 * * * *", run: fetchInbox })
+* definePollSource({ slug: "inbox", schedule: "0 * * * *", run: fetchInbox })
 *   .filter((r) => r.length > 0)
 *   .attach({ workflow });
 */
 function definePollSource(options) {
-	const triggerKey = options.key.trim();
-	if (!triggerKey) throw new Error("definePollSource requires a non-empty key");
+	const sourceSlug = resolveAuthoringSlug(options, "definePollSource");
 	const schedule = parseCronSchedule(options.schedule);
 	const filters = [];
 	if (options.filter) filters.push(options.filter);
 	const source = {
 		kind: "poll",
-		key: triggerKey,
+		slug: sourceSlug,
+		...options.name !== void 0 ? { name: options.name } : {},
+		...options.description !== void 0 ? { description: options.description } : {},
 		id: options.id,
 		schedule,
 		run: options.run,
@@ -669,7 +755,7 @@ function definePollSource(options) {
 			return source.filters.every((candidate) => candidate(payload));
 		},
 		attach(attachOptions) {
-			return attachFromSource(source, triggerKey, attachOptions);
+			return attachFromSource(source, sourceSlug, attachOptions);
 		}
 	};
 	const chain = source;
@@ -757,6 +843,6 @@ function resolveAttachmentInput(attachment, payload) {
 	return applyAttachmentTransform(attachment, payload);
 }
 //#endregion
-export { TRIGGER_ATTACHMENT, cronScheduleSchema, defineCronSource, definePollSource, defineWebhookSource, interpolatePrompt, isAgentTriggerAttachment, isTriggerAttachment, isWorkflowTriggerAttachment, matchToJsonSchema, matchWebhookPayload, nextTriggerRunAt, normalizeWebhookEndpoint, parseCronSchedule, parseTriggerSchedule, resolveAgentPrompt, resolveAttachmentInput, resolveAttachmentTransform, resolveCronSchedule };
+export { TRIGGER_ATTACHMENT, agentKeyFromAgent, agentSlugFromAgent, attachmentKeyFrom, attachmentSlugFrom, attachmentSlugFromRecord, cronScheduleSchema, defineCronSource, definePollSource, defineWebhookSource, interpolatePrompt, isAgentTriggerAttachment, isTriggerAttachment, isWorkflowTriggerAttachment, matchToJsonSchema, matchWebhookPayload, nextTriggerRunAt, normalizeWebhookEndpoint, parseCronSchedule, parseTriggerSchedule, resolveAgentPrompt, resolveAttachmentInput, resolveAttachmentTransform, resolveAuthoringSlug, resolveCronSchedule, sourceSlugFrom, triggerMetaFromAttachment, triggerMetaFromSource, triggerMetaRecordFromAttachment, triggerSourceSlugFromAttachmentSlug, triggerTargetSlugFromAttachmentSlug, workflowKeyFromDefinition, workflowSlugFromDefinition };
 
 //# sourceMappingURL=trigger.mjs.map