veryfront 0.1.973 → 0.1.975

package/esm/src/trigger/discovery.d.ts

@@ -0,0 +1,31 @@
+import type { VeryfrontConfig } from "../config/index.js";
+import type { RuntimeAdapter } from "../platform/index.js";
+export type SourceTriggerKind = "schedule" | "webhook";
+export type SourceTriggerDiscoveryErrorCode = "parse_error" | "invalid_definition" | "dynamic_definition" | "duplicate_source_id" | "unsupported_target" | "manual_conflict";
+export interface SourceTriggerDiscoveryError {
+    kind: "source_trigger_discovery_error";
+    sourceKind: SourceTriggerKind;
+    sourcePath: string;
+    sourceId?: string;
+    code: SourceTriggerDiscoveryErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface SourceTriggerDiscoveryResult<T> {
+    items: T[];
+    errors: SourceTriggerDiscoveryError[];
+}
+export interface TriggerDiscoveryOptions {
+    projectDir: string;
+    adapter: RuntimeAdapter;
+    config?: VeryfrontConfig;
+    triggerDir: string;
+    sourceKind: SourceTriggerKind;
+}
+export interface TriggerDefinitionWithId {
+    id: string;
+}
+export declare function discoverSourceTriggers<T extends TriggerDefinitionWithId>(options: TriggerDiscoveryOptions & {
+    validate: (value: unknown) => value is T;
+}): Promise<SourceTriggerDiscoveryResult<T>>;
+//# sourceMappingURL=discovery.d.ts.map

package/esm/src/trigger/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/src/trigger/discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3D,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,gCAAgC,CAAC;IACvC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC7C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AA8DD,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,uBAAuB,EAC5E,OAAO,EAAE,uBAAuB,GAAG;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC1C,GACA,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAiE1C"}

package/esm/src/trigger/discovery.js

@@ -0,0 +1,115 @@
+import { join } from "../../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { importDiscoveryModule } from "../discovery/module-import.js";
+import { collectFiles } from "../utils/file-discovery.js";
+const TRIGGER_FILE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
+const TRIGGER_IGNORE_PATTERNS = [
+    "node_modules",
+    ".git",
+    "__tests__",
+    "*.test.*",
+    "*.spec.*",
+];
+function resolveTriggerBaseDir(projectDir, triggerDir, config) {
+    const fsType = config?.fs?.type ?? "local";
+    return fsType === "github" || fsType === "veryfront-api"
+        ? triggerDir
+        : join(projectDir, triggerDir);
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function createError(input) {
+    return {
+        kind: "source_trigger_discovery_error",
+        sourceKind: input.sourceKind,
+        sourcePath: input.sourcePath,
+        ...(input.sourceId === undefined ? {} : { sourceId: input.sourceId }),
+        code: input.code,
+        message: input.message,
+        ...(input.details === undefined ? {} : { details: input.details }),
+    };
+}
+async function collectTriggerFiles(baseDir, adapter) {
+    return await collectFiles({
+        baseDir,
+        extensions: [...TRIGGER_FILE_EXTENSIONS],
+        recursive: true,
+        ignorePatterns: [...TRIGGER_IGNORE_PATTERNS],
+        adapter,
+    });
+}
+function extractTriggerExport(module, validate) {
+    if (validate(module.default)) {
+        return { exportName: "default", definition: module.default };
+    }
+    for (const [exportName, value] of Object.entries(module)) {
+        if (exportName === "default")
+            continue;
+        if (validate(value))
+            return { exportName, definition: value };
+    }
+    return null;
+}
+export async function discoverSourceTriggers(options) {
+    const { projectDir, adapter, config, triggerDir, sourceKind, validate } = options;
+    const baseDir = resolveTriggerBaseDir(projectDir, triggerDir, config);
+    const items = [];
+    const errors = [];
+    const seenIds = new Map();
+    try {
+        const dirExists = await adapter.fs.exists(baseDir);
+        if (!dirExists)
+            return { items, errors };
+        const files = await collectTriggerFiles(baseDir, adapter);
+        for (const file of files) {
+            try {
+                const module = await importDiscoveryModule(file.path, {
+                    adapter,
+                    projectDir,
+                });
+                const triggerExport = extractTriggerExport(module, validate);
+                if (!triggerExport) {
+                    errors.push(createError({
+                        sourceKind,
+                        sourcePath: file.path,
+                        code: "invalid_definition",
+                        message: `File must export a valid ${sourceKind} definition.`,
+                    }));
+                    continue;
+                }
+                const existingPath = seenIds.get(triggerExport.definition.id);
+                if (existingPath) {
+                    errors.push(createError({
+                        sourceKind,
+                        sourcePath: file.path,
+                        sourceId: triggerExport.definition.id,
+                        code: "duplicate_source_id",
+                        message: `Duplicate ${sourceKind} id "${triggerExport.definition.id}".`,
+                        details: { firstSourcePath: existingPath },
+                    }));
+                    continue;
+                }
+                seenIds.set(triggerExport.definition.id, file.path);
+                items.push(triggerExport.definition);
+            }
+            catch (error) {
+                errors.push(createError({
+                    sourceKind,
+                    sourcePath: file.path,
+                    code: "parse_error",
+                    message: toErrorMessage(error),
+                }));
+            }
+        }
+        return { items, errors };
+    }
+    catch (error) {
+        errors.push(createError({
+            sourceKind,
+            sourcePath: baseDir,
+            code: "parse_error",
+            message: toErrorMessage(error),
+        }));
+        return { items, errors };
+    }
+}

package/esm/src/trigger/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared source-trigger discovery and local execution primitives.
+ *
+ * @module trigger
+ *
+ * @example Discover and run a source-defined trigger target
+ * ```ts
+ * import { discoverSchedules } from "veryfront/schedule";
+ * import { runTriggerTarget } from "veryfront/trigger";
+ *
+ * const { items } = await discoverSchedules({ projectDir, adapter });
+ * const dailyTriage = items.find((item) => item.id === "daily-support-triage");
+ *
+ * if (dailyTriage) {
+ *   await runTriggerTarget({
+ *     projectDir,
+ *     adapter,
+ *     target: dailyTriage.target,
+ *     input: dailyTriage.input,
+ *   });
+ * }
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { discoverSourceTriggers } from "./discovery.js";
+export { runTriggerTarget } from "./local-runner.js";
+export type { SourceTriggerDiscoveryError, SourceTriggerDiscoveryErrorCode, SourceTriggerDiscoveryResult, SourceTriggerKind, TriggerDefinitionWithId, TriggerDiscoveryOptions, } from "./discovery.js";
+export type { RunTriggerTargetOptions, TriggerTargetRunResult } from "./local-runner.js";
+export type { TriggerTarget } from "./target.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/trigger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/trigger/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EACV,2BAA2B,EAC3B,+BAA+B,EAC/B,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/esm/src/trigger/index.js

@@ -0,0 +1,26 @@
+/**
+ * Shared source-trigger discovery and local execution primitives.
+ *
+ * @module trigger
+ *
+ * @example Discover and run a source-defined trigger target
+ * ```ts
+ * import { discoverSchedules } from "veryfront/schedule";
+ * import { runTriggerTarget } from "veryfront/trigger";
+ *
+ * const { items } = await discoverSchedules({ projectDir, adapter });
+ * const dailyTriage = items.find((item) => item.id === "daily-support-triage");
+ *
+ * if (dailyTriage) {
+ *   await runTriggerTarget({
+ *     projectDir,
+ *     adapter,
+ *     target: dailyTriage.target,
+ *     input: dailyTriage.input,
+ *   });
+ * }
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { discoverSourceTriggers } from "./discovery.js";
+export { runTriggerTarget } from "./local-runner.js";

package/esm/src/trigger/local-runner.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimeAdapter } from "../platform/index.js";
+import type { VeryfrontConfig } from "../config/index.js";
+import type { TriggerTarget } from "./target.js";
+export interface RunTriggerTargetOptions {
+    projectDir: string;
+    adapter: RuntimeAdapter;
+    config?: VeryfrontConfig;
+    projectId?: string;
+    target: TriggerTarget;
+    input?: unknown;
+    debug?: boolean;
+}
+export interface TriggerTargetRunResult {
+    kind: TriggerTarget["kind"];
+    id: string;
+    output?: unknown;
+    durationMs: number;
+}
+export declare function runTriggerTarget(options: RunTriggerTargetOptions): Promise<TriggerTargetRunResult>;
+//# sourceMappingURL=local-runner.d.ts.map

package/esm/src/trigger/local-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-runner.d.ts","sourceRoot":"","sources":["../../../src/src/trigger/local-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyFD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAYjC"}

package/esm/src/trigger/local-runner.js

@@ -0,0 +1,92 @@
+import { agentRegistry } from "../agent/composition/index.js";
+import { discoverProjectAgentRuntime } from "../agent/project/agent-runtime.js";
+import { toolRegistry } from "../tool/registry.js";
+import { createWorkflowClient } from "../workflow/api/workflow-client.js";
+import { discoverTasks } from "../task/discovery.js";
+import { runTask } from "../task/runner.js";
+function toRecordInput(input) {
+    if (input === undefined)
+        return {};
+    if (input && typeof input === "object" && !Array.isArray(input)) {
+        return input;
+    }
+    return { payload: input };
+}
+async function runTaskTarget(options) {
+    const { tasks, errors } = await discoverTasks({
+        projectDir: options.projectDir,
+        adapter: options.adapter,
+        config: options.config,
+        debug: options.debug,
+    });
+    if (errors.length > 0) {
+        throw new Error(`Task discovery failed: ${errors[0]?.filePath}: ${errors[0]?.error}`);
+    }
+    const task = tasks.find((candidate) => candidate.id === options.target.id);
+    if (!task) {
+        throw new Error(`Task target "${options.target.id}" not found.`);
+    }
+    const result = await runTask({
+        task,
+        config: toRecordInput(options.input),
+        projectId: options.projectId,
+        debug: options.debug,
+    });
+    if (!result.success) {
+        throw new Error(result.error ?? `Task target "${options.target.id}" failed.`);
+    }
+    return {
+        kind: "task",
+        id: options.target.id,
+        output: result.result,
+        durationMs: result.durationMs,
+    };
+}
+async function runWorkflowTarget(options) {
+    const start = Date.now();
+    const discovery = await discoverProjectAgentRuntime({
+        projectDir: options.projectDir,
+        adapter: options.adapter,
+        verbose: options.debug,
+    });
+    if (discovery.errors.length > 0) {
+        const first = discovery.errors[0];
+        throw new Error(`Runtime discovery failed: ${first?.file}: ${first?.error.message}`);
+    }
+    const workflow = discovery.workflows.get(options.target.id);
+    if (!workflow) {
+        throw new Error(`Workflow target "${options.target.id}" not found.`);
+    }
+    const client = createWorkflowClient({
+        debug: options.debug,
+        executor: {
+            stepExecutor: {
+                agentRegistry,
+                toolRegistry,
+            },
+        },
+    });
+    try {
+        client.register(workflow.definition);
+        const handle = await client.start(options.target.id, options.input ?? {});
+        const output = await handle.result();
+        return {
+            kind: "workflow",
+            id: options.target.id,
+            output,
+            durationMs: Date.now() - start,
+        };
+    }
+    finally {
+        await client.destroy();
+    }
+}
+export async function runTriggerTarget(options) {
+    if (options.target.kind === "task") {
+        return await runTaskTarget(options);
+    }
+    if (options.target.kind === "workflow") {
+        return await runWorkflowTarget(options);
+    }
+    throw new Error("Agent trigger targets are Cloud-only for this milestone. Use a workflow or task for local trigger runs.");
+}

package/esm/src/trigger/target.d.ts

@@ -0,0 +1,7 @@
+export type TriggerTargetKind = "task" | "workflow" | "agent";
+export interface TriggerTarget {
+    kind: TriggerTargetKind;
+    id: string;
+}
+export declare function isTriggerTarget(value: unknown): value is TriggerTarget;
+//# sourceMappingURL=target.d.ts.map

package/esm/src/trigger/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../src/src/trigger/target.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE"}

package/esm/src/trigger/target.js

@@ -0,0 +1,8 @@
+export function isTriggerTarget(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const target = value;
+    return ((target.kind === "task" || target.kind === "workflow" || target.kind === "agent") &&
+        typeof target.id === "string" &&
+        target.id.trim().length > 0);
+}

package/esm/src/trigger/validation.d.ts

@@ -0,0 +1,3 @@
+export declare function validateTriggerId(id: string, label: string): void;
+export declare function assertSerializable(value: unknown, path?: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/esm/src/trigger/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/src/trigger/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAU,GAAG,IAAI,CAgCvE"}

package/esm/src/trigger/validation.js

@@ -0,0 +1,36 @@
+const ID_PATTERN = /^[a-z0-9][a-z0-9._/-]*$/;
+export function validateTriggerId(id, label) {
+    if (!ID_PATTERN.test(id)) {
+        throw new Error(`${label} id must start with a lowercase letter or number and use lowercase letters, numbers, dots, underscores, slashes, or hyphens.`);
+    }
+}
+export function assertSerializable(value, path = "value") {
+    if (value === undefined)
+        return;
+    if (value === null)
+        return;
+    const valueType = typeof value;
+    if (valueType === "string" || valueType === "number" || valueType === "boolean")
+        return;
+    if (valueType === "function" || valueType === "symbol" || valueType === "bigint") {
+        throw new Error(`${path} must be JSON-serializable.`);
+    }
+    if (value instanceof Date) {
+        throw new Error(`${path} must be JSON-serializable.`);
+    }
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index++) {
+            assertSerializable(value[index], `${path}[${index}]`);
+        }
+        return;
+    }
+    if (typeof value === "object") {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error(`${path} must be JSON-serializable.`);
+        }
+        for (const [key, child] of Object.entries(value)) {
+            assertSerializable(child, `${path}.${key}`);
+        }
+    }
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.973";
+export declare const VERSION = "0.1.975";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.973";
+export const VERSION = "0.1.975";

package/esm/src/webhook/discovery.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeAdapter } from "../platform/index.js";
+import type { VeryfrontConfig } from "../config/index.js";
+import { type SourceTriggerDiscoveryResult } from "../trigger/discovery.js";
+import { type WebhookDefinition } from "./types.js";
+export interface WebhookDiscoveryOptions {
+    projectDir: string;
+    adapter: RuntimeAdapter;
+    config?: VeryfrontConfig;
+    webhooksDir?: string;
+}
+export type WebhookDiscoveryResult = SourceTriggerDiscoveryResult<WebhookDefinition>;
+export declare function discoverWebhooks(options: WebhookDiscoveryOptions): Promise<WebhookDiscoveryResult>;
+//# sourceMappingURL=discovery.d.ts.map

package/esm/src/webhook/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/src/webhook/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;AAErF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CASjC"}

package/esm/src/webhook/discovery.js

@@ -0,0 +1,12 @@
+import { discoverSourceTriggers, } from "../trigger/discovery.js";
+import { isWebhookDefinition } from "./types.js";
+export async function discoverWebhooks(options) {
+    return await discoverSourceTriggers({
+        projectDir: options.projectDir,
+        adapter: options.adapter,
+        config: options.config,
+        triggerDir: options.webhooksDir ?? "webhooks",
+        sourceKind: "webhook",
+        validate: isWebhookDefinition,
+    });
+}

package/esm/src/webhook/factory.d.ts

@@ -0,0 +1,3 @@
+import type { WebhookConfig, WebhookDefinition } from "./types.js";
+export declare function webhook(config: WebhookConfig): WebhookDefinition;
+//# sourceMappingURL=factory.d.ts.map

package/esm/src/webhook/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/webhook/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAuCpB,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CA2BhE"}

package/esm/src/webhook/factory.js

@@ -0,0 +1,58 @@
+import { isTriggerTarget } from "../trigger/target.js";
+import { assertSerializable, validateTriggerId } from "../trigger/validation.js";
+const OPERATORS = new Set(["equals", "not_equals", "contains", "exists"]);
+function requireString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} is required.`);
+    }
+    return value;
+}
+function normalizeFilter(filter) {
+    if (filter === undefined)
+        return undefined;
+    if (filter.mode !== "all" && filter.mode !== "any") {
+        throw new Error("Webhook eventFilter mode must be all or any.");
+    }
+    if (!Array.isArray(filter.conditions)) {
+        throw new Error("Webhook eventFilter conditions must be an array.");
+    }
+    return {
+        mode: filter.mode,
+        conditions: filter.conditions.map((condition, index) => {
+            if (typeof condition.path !== "string" || condition.path.trim().length === 0) {
+                throw new Error(`Webhook eventFilter condition ${index} path is required.`);
+            }
+            if (!OPERATORS.has(condition.operator)) {
+                throw new Error(`Webhook eventFilter condition ${index} operator is not supported.`);
+            }
+            assertSerializable(condition.value, `Webhook eventFilter condition ${index} value`);
+            return {
+                path: condition.path,
+                operator: condition.operator,
+                ...(condition.value === undefined ? {} : { value: condition.value }),
+            };
+        }),
+    };
+}
+export function webhook(config) {
+    const id = requireString(config.id, "Webhook id");
+    validateTriggerId(id, "Webhook");
+    if (!isTriggerTarget(config.target)) {
+        throw new Error("Webhook target must specify a valid task, workflow, or agent id.");
+    }
+    if (config.target.kind === "agent" &&
+        (!config.agentMessage || config.agentMessage.promptTemplate.trim().length === 0)) {
+        throw new Error("Agent webhooks must define agentMessage.promptTemplate.");
+    }
+    const eventFilter = normalizeFilter(config.eventFilter);
+    return {
+        id,
+        ...(config.name === undefined ? {} : { name: config.name }),
+        ...(config.description === undefined ? {} : { description: config.description }),
+        target: { kind: config.target.kind, id: config.target.id },
+        ...(eventFilter === undefined ? {} : { eventFilter }),
+        ...(config.agentMessage === undefined
+            ? {}
+            : { agentMessage: { promptTemplate: config.agentMessage.promptTemplate } }),
+    };
+}

package/esm/src/webhook/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Source-defined webhooks for Veryfront projects.
+ *
+ * @module webhook
+ *
+ * @example Run a workflow for urgent customer events
+ * ```ts
+ * import { webhook } from "veryfront/webhook";
+ *
+ * export default webhook({
+ *   id: "customer-escalation",
+ *   target: { kind: "workflow", id: "escalate-ticket" },
+ *   eventFilter: {
+ *     mode: "any",
+ *     conditions: [
+ *       { path: "severity", operator: "equals", value: "high" },
+ *       { path: "priority", operator: "equals", value: "urgent" },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { webhook } from "./factory.js";
+export { discoverWebhooks } from "./discovery.js";
+export type { WebhookAgentMessageMapping, WebhookConfig, WebhookDefinition, WebhookEventFilter, WebhookEventFilterCondition, WebhookEventFilterMode, WebhookEventFilterOperator, } from "./types.js";
+export { isWebhookDefinition } from "./types.js";
+export type { WebhookDiscoveryOptions, WebhookDiscoveryResult } from "./discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/webhook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/webhook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/esm/src/webhook/index.js

@@ -0,0 +1,26 @@
+/**
+ * Source-defined webhooks for Veryfront projects.
+ *
+ * @module webhook
+ *
+ * @example Run a workflow for urgent customer events
+ * ```ts
+ * import { webhook } from "veryfront/webhook";
+ *
+ * export default webhook({
+ *   id: "customer-escalation",
+ *   target: { kind: "workflow", id: "escalate-ticket" },
+ *   eventFilter: {
+ *     mode: "any",
+ *     conditions: [
+ *       { path: "severity", operator: "equals", value: "high" },
+ *       { path: "priority", operator: "equals", value: "urgent" },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { webhook } from "./factory.js";
+export { discoverWebhooks } from "./discovery.js";
+export { isWebhookDefinition } from "./types.js";

package/esm/src/webhook/types.d.ts

@@ -0,0 +1,26 @@
+import type { TriggerTarget } from "../trigger/target.js";
+export type WebhookEventFilterMode = "all" | "any";
+export type WebhookEventFilterOperator = "equals" | "not_equals" | "contains" | "exists";
+export interface WebhookEventFilterCondition {
+    path: string;
+    operator: WebhookEventFilterOperator;
+    value?: unknown;
+}
+export interface WebhookEventFilter {
+    mode: WebhookEventFilterMode;
+    conditions: WebhookEventFilterCondition[];
+}
+export interface WebhookAgentMessageMapping {
+    promptTemplate: string;
+}
+export interface WebhookDefinition {
+    id: string;
+    name?: string;
+    description?: string;
+    target: TriggerTarget;
+    eventFilter?: WebhookEventFilter;
+    agentMessage?: WebhookAgentMessageMapping;
+}
+export type WebhookConfig = WebhookDefinition;
+export declare function isWebhookDefinition(value: unknown): value is WebhookDefinition;
+//# sourceMappingURL=types.d.ts.map

package/esm/src/webhook/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/webhook/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,0BAA0B,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,2BAA2B,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAQ9E"}

package/esm/src/webhook/types.js

@@ -0,0 +1,8 @@
+export function isWebhookDefinition(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const definition = value;
+    return (typeof definition.id === "string" &&
+        definition.target !== null &&
+        typeof definition.target === "object");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.973",
+  "version": "0.1.975",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -145,6 +145,18 @@
       "import": "./esm/src/skill/index.js",
       "types": "./esm/src/skill/index.d.ts"
     },
+    "./trigger": {
+      "import": "./esm/src/trigger/index.js",
+      "types": "./esm/src/trigger/index.d.ts"
+    },
+    "./schedule": {
+      "import": "./esm/src/schedule/index.js",
+      "types": "./esm/src/schedule/index.d.ts"
+    },
+    "./webhook": {
+      "import": "./esm/src/webhook/index.js",
+      "types": "./esm/src/webhook/index.d.ts"
+    },
     "./mcp": {
       "import": "./esm/src/mcp/index.js",
       "types": "./esm/src/mcp/index.d.ts"