@trigger.dev/sdk 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/esm/v3/prompt.js

@@ -0,0 +1,143 @@
+import { accessoryAttributes, apiClientManager, resourceCatalog, SemanticInternalAttributes, getSchemaParseFn, } from "@trigger.dev/core/v3";
+import { tracer } from "./tracer.js";
+/**
+ * Compile a Mustache-style template by substituting `{{variable}}` placeholders.
+ */
+function compileTemplate(template, variables) {
+    // Handle conditional sections: {{#key}}...{{/key}}
+    let result = template.replace(/\{\{#(\w+)\}\}([\s\S]*?)\{\{\/\1\}\}/g, (_match, key, content) => {
+        const value = variables[key];
+        return value
+            ? content.replace(/\{\{(\w+)\}\}/g, (_m, k) => {
+                return String(variables[k] ?? "");
+            })
+            : "";
+    });
+    // Handle simple substitutions: {{key}}
+    result = result.replace(/\{\{\s*(\w+)\s*\}\}/g, (_match, key) => {
+        const value = variables[key];
+        return value !== undefined && value !== null ? String(value) : "";
+    });
+    return result;
+}
+function makeToAISDKTelemetry(slug, promptId, version, labels, model, input) {
+    return function toAISDKTelemetry(additionalMetadata) {
+        return {
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    "prompt.slug": slug,
+                    "prompt.id": promptId,
+                    "prompt.version": String(version),
+                    "prompt.labels": labels.join(", "),
+                    ...(model ? { "prompt.model": model } : {}),
+                    ...(input ? { "prompt.input": input } : {}),
+                    ...additionalMetadata,
+                },
+            },
+        };
+    };
+}
+function resolveLocally(options, variables) {
+    const inputJson = Object.keys(variables).length > 0 ? JSON.stringify(variables) : undefined;
+    const telemetryFn = makeToAISDKTelemetry(options.id, options.id, 0, ["local"], options.model, inputJson);
+    return {
+        promptId: options.id,
+        version: 0,
+        labels: ["local"],
+        text: compileTemplate(options.content, variables),
+        model: options.model,
+        config: options.config,
+        toAISDKTelemetry: telemetryFn,
+    };
+}
+export function definePrompt(options) {
+    const parseVariables = options.variables ? getSchemaParseFn(options.variables) : undefined;
+    // Register with resource catalog
+    const metadata = {
+        id: options.id,
+        description: options.description,
+        content: options.content,
+        model: options.model,
+        config: options.config,
+        variableSchema: undefined, // Set by CLI via schemaToJsonSchema
+        schema: options.variables,
+        fns: {
+            resolve: async (variables) => {
+                const validated = parseVariables ? await parseVariables(variables) : variables;
+                return resolveLocally(options, validated);
+            },
+        },
+    };
+    resourceCatalog.registerPromptMetadata(metadata);
+    return {
+        id: options.id,
+        resolve: async (variables, resolveOptions) => {
+            // Validate variables if schema provided
+            const validated = parseVariables ? await parseVariables(variables) : variables;
+            const vars = validated;
+            const apiClient = apiClientManager.client;
+            // Resolve via the API when a client is configured (inside tasks or via configure())
+            if (apiClient) {
+                const response = await apiClient.resolvePrompt(options.id, {
+                    variables: vars,
+                    label: resolveOptions?.label,
+                    version: resolveOptions?.version,
+                }, {
+                    tracer,
+                    name: "prompt.resolve()",
+                    icon: "tabler-file-text-ai",
+                    attributes: {
+                        [SemanticInternalAttributes.STYLE_ICON]: "tabler-file-text-ai",
+                        [SemanticInternalAttributes.ENTITY_TYPE]: "prompt",
+                        [SemanticInternalAttributes.ENTITY_ID]: options.id,
+                        ...accessoryAttributes({
+                            items: [
+                                {
+                                    text: options.id,
+                                    variant: "normal",
+                                },
+                            ],
+                            style: "codepath",
+                        }),
+                    },
+                    onResponseBody: (body, span) => {
+                        span.setAttribute("prompt.version", body.data.version);
+                        span.setAttribute("prompt.slug", body.data.slug);
+                        span.setAttribute("prompt.labels", body.data.labels.join(", "));
+                        if (body.data.model) {
+                            span.setAttribute("prompt.model", body.data.model);
+                        }
+                        if (body.data.template) {
+                            span.setAttribute("prompt.template", body.data.template);
+                        }
+                        if (body.data.text) {
+                            span.setAttribute("prompt.text", body.data.text);
+                        }
+                        if (body.data.config) {
+                            span.setAttribute("prompt.config", JSON.stringify(body.data.config));
+                        }
+                        if (vars && Object.keys(vars).length > 0) {
+                            span.setAttribute("prompt.input", JSON.stringify(vars));
+                        }
+                    },
+                });
+                const data = response.data;
+                const inputJson = vars && Object.keys(vars).length > 0 ? JSON.stringify(vars) : undefined;
+                const telemetryFn = makeToAISDKTelemetry(data.slug, data.promptId, data.version, data.labels, data.model ?? undefined, inputJson);
+                return {
+                    promptId: data.promptId,
+                    version: data.version,
+                    labels: data.labels,
+                    text: data.text ?? "",
+                    model: data.model ?? undefined,
+                    config: data.config ?? undefined,
+                    toAISDKTelemetry: telemetryFn,
+                };
+            }
+            // Fallback: resolve locally (outside platform or during dev)
+            return resolveLocally(options, vars);
+        },
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/esm/v3/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/v3/prompt.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/promptManagement.d.ts

@@ -0,0 +1,26 @@
+import { type ApiRequestOptions, type CreatePromptOverrideRequestBody, type ListPromptsResponseBody, type ListPromptVersionsResponseBody, type PromptOkResponseBody, type PromptOverrideCreatedResponseBody, type UpdatePromptOverrideRequestBody } from "@trigger.dev/core/v3";
+import type { AnyPromptHandle, PromptIdentifier, PromptVariables, ResolvedPrompt } from "./prompt.js";
+/**
+ * Resolve a prompt by slug, calling the API to get the current version's
+ * compiled text. Works both inside and outside of a task context — requires
+ * an API client to be configured (via `configure()` or task runtime).
+ */
+export declare function resolvePrompt<TPromptHandle extends AnyPromptHandle = AnyPromptHandle>(slug: PromptIdentifier<TPromptHandle>, variables?: PromptVariables<TPromptHandle>, options?: {
+    label?: string;
+    version?: number;
+    requestOptions?: ApiRequestOptions;
+}): Promise<ResolvedPrompt>;
+/** List all prompts in the current environment. */
+export declare function listPrompts(requestOptions?: ApiRequestOptions): Promise<ListPromptsResponseBody>;
+/** List all versions for a prompt. */
+export declare function listPromptVersions(slug: string, requestOptions?: ApiRequestOptions): Promise<ListPromptVersionsResponseBody>;
+/** Promote a code-deployed version to be the current version. */
+export declare function promotePromptVersion(slug: string, version: number, requestOptions?: ApiRequestOptions): Promise<PromptOkResponseBody>;
+/** Create an override — a dashboard/API edit that takes priority over the deployed version. */
+export declare function createPromptOverride(slug: string, body: CreatePromptOverrideRequestBody, requestOptions?: ApiRequestOptions): Promise<PromptOverrideCreatedResponseBody>;
+/** Update the active override's content or model. */
+export declare function updatePromptOverride(slug: string, body: UpdatePromptOverrideRequestBody, requestOptions?: ApiRequestOptions): Promise<PromptOkResponseBody>;
+/** Remove the active override, reverting to the current deployed version. */
+export declare function removePromptOverride(slug: string, requestOptions?: ApiRequestOptions): Promise<PromptOkResponseBody>;
+/** Reactivate a previously removed override version. */
+export declare function reactivatePromptOverride(slug: string, version: number, requestOptions?: ApiRequestOptions): Promise<PromptOkResponseBody>;

package/dist/esm/v3/promptManagement.js

@@ -0,0 +1,170 @@
+import { accessoryAttributes, apiClientManager, SemanticInternalAttributes, } from "@trigger.dev/core/v3";
+import { tracer } from "./tracer.js";
+function promptSpanOptions(name, slug) {
+    return {
+        tracer,
+        name,
+        icon: "tabler-file-text-ai",
+        attributes: {
+            [SemanticInternalAttributes.STYLE_ICON]: "tabler-file-text-ai",
+            ...accessoryAttributes({
+                items: [{ text: slug, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    };
+}
+function makeToAISDKTelemetry(slug, promptId, version, labels, model, input) {
+    return function toAISDKTelemetry(additionalMetadata) {
+        return {
+            experimental_telemetry: {
+                isEnabled: true,
+                metadata: {
+                    "prompt.slug": slug,
+                    "prompt.id": promptId,
+                    "prompt.version": String(version),
+                    "prompt.labels": labels.join(", "),
+                    ...(model ? { "prompt.model": model } : {}),
+                    ...(input ? { "prompt.input": input } : {}),
+                    ...additionalMetadata,
+                },
+            },
+        };
+    };
+}
+/**
+ * Resolve a prompt by slug, calling the API to get the current version's
+ * compiled text. Works both inside and outside of a task context — requires
+ * an API client to be configured (via `configure()` or task runtime).
+ */
+export async function resolvePrompt(slug, variables, options) {
+    const apiClient = apiClientManager.clientOrThrow();
+    const vars = variables ?? {};
+    const response = await apiClient.resolvePrompt(slug, {
+        variables: vars,
+        label: options?.label,
+        version: options?.version,
+    }, {
+        ...promptSpanOptions("prompts.resolve()", slug),
+        attributes: {
+            [SemanticInternalAttributes.STYLE_ICON]: "tabler-file-text-ai",
+            [SemanticInternalAttributes.ENTITY_TYPE]: "prompt",
+            [SemanticInternalAttributes.ENTITY_ID]: slug,
+            ...accessoryAttributes({
+                items: [{ text: slug, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+        onResponseBody: (body, span) => {
+            span.setAttribute("prompt.version", body.data.version);
+            span.setAttribute("prompt.slug", body.data.slug);
+            span.setAttribute("prompt.labels", body.data.labels.join(", "));
+            if (body.data.model)
+                span.setAttribute("prompt.model", body.data.model);
+            if (body.data.text)
+                span.setAttribute("prompt.text", body.data.text);
+            if (vars && Object.keys(vars).length > 0) {
+                span.setAttribute("prompt.input", JSON.stringify(vars));
+            }
+        },
+    });
+    const data = response.data;
+    const inputJson = Object.keys(vars).length > 0 ? JSON.stringify(vars) : undefined;
+    return {
+        promptId: data.promptId,
+        version: data.version,
+        labels: data.labels,
+        text: data.text ?? "",
+        model: data.model ?? undefined,
+        config: data.config ?? undefined,
+        toAISDKTelemetry: makeToAISDKTelemetry(data.slug, data.promptId, data.version, data.labels, data.model ?? undefined, inputJson),
+    };
+}
+/** List all prompts in the current environment. */
+export function listPrompts(requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.listPrompts({
+        tracer,
+        name: "prompts.list()",
+        icon: "tabler-file-text-ai",
+        attributes: {
+            [SemanticInternalAttributes.STYLE_ICON]: "tabler-file-text-ai",
+        },
+        onResponseBody: (body, span) => {
+            span.setAttribute("prompt.count", body.data.length);
+        },
+    });
+}
+/** List all versions for a prompt. */
+export function listPromptVersions(slug, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.listPromptVersions(slug, {
+        ...promptSpanOptions("prompts.versions()", slug),
+        onResponseBody: (body, span) => {
+            span.setAttribute("prompt.slug", slug);
+            span.setAttribute("prompt.versions.count", body.data.length);
+        },
+    });
+}
+/** Promote a code-deployed version to be the current version. */
+export async function promotePromptVersion(slug, version, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.promotePromptVersion(slug, { version }, {
+        ...promptSpanOptions("prompts.promote()", slug),
+        attributes: {
+            ...promptSpanOptions("prompts.promote()", slug).attributes,
+            "prompt.slug": slug,
+            "prompt.version": version,
+        },
+    });
+}
+/** Create an override — a dashboard/API edit that takes priority over the deployed version. */
+export async function createPromptOverride(slug, body, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.createPromptOverride(slug, body, {
+        ...promptSpanOptions("prompts.createOverride()", slug),
+        attributes: {
+            ...promptSpanOptions("prompts.createOverride()", slug).attributes,
+            "prompt.slug": slug,
+            ...(body.model ? { "prompt.model": body.model } : {}),
+        },
+        onResponseBody: (body, span) => {
+            span.setAttribute("prompt.override.version", body.version);
+        },
+    });
+}
+/** Update the active override's content or model. */
+export async function updatePromptOverride(slug, body, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.updatePromptOverride(slug, body, {
+        ...promptSpanOptions("prompts.updateOverride()", slug),
+        attributes: {
+            ...promptSpanOptions("prompts.updateOverride()", slug).attributes,
+            "prompt.slug": slug,
+        },
+    });
+}
+/** Remove the active override, reverting to the current deployed version. */
+export async function removePromptOverride(slug, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.removePromptOverride(slug, {
+        ...promptSpanOptions("prompts.removeOverride()", slug),
+        attributes: {
+            ...promptSpanOptions("prompts.removeOverride()", slug).attributes,
+            "prompt.slug": slug,
+        },
+    });
+}
+/** Reactivate a previously removed override version. */
+export async function reactivatePromptOverride(slug, version, requestOptions) {
+    const apiClient = apiClientManager.clientOrThrow();
+    return apiClient.reactivatePromptOverride(slug, { version }, {
+        ...promptSpanOptions("prompts.reactivateOverride()", slug),
+        attributes: {
+            ...promptSpanOptions("prompts.reactivateOverride()", slug).attributes,
+            "prompt.slug": slug,
+            "prompt.version": version,
+        },
+    });
+}
+//# sourceMappingURL=promptManagement.js.map

package/dist/esm/v3/promptManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptManagement.js","sourceRoot":"","sources":["../../../src/v3/promptManagement.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/prompts.d.ts

@@ -0,0 +1,3 @@
+export { definePrompt as define } from "./prompt.js";
+export type { AnyPromptHandle, PromptHandle, PromptIdentifier, PromptOptions, PromptVariables, ResolvedPrompt, } from "./prompt.js";
+export { resolvePrompt as resolve, listPrompts as list, listPromptVersions as versions, promotePromptVersion as promote, createPromptOverride as createOverride, updatePromptOverride as updateOverride, removePromptOverride as removeOverride, reactivatePromptOverride as reactivateOverride, } from "./promptManagement.js";

package/dist/esm/v3/prompts.js

@@ -0,0 +1,3 @@
+export { definePrompt as define } from "./prompt.js";
+export { resolvePrompt as resolve, listPrompts as list, listPromptVersions as versions, promotePromptVersion as promote, createPromptOverride as createOverride, updatePromptOverride as updateOverride, removePromptOverride as removeOverride, reactivatePromptOverride as reactivateOverride, } from "./promptManagement.js";
+//# sourceMappingURL=prompts.js.map

package/dist/esm/v3/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/v3/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrD,OAAO,EACL,aAAa,IAAI,OAAO,EACxB,WAAW,IAAI,IAAI,EACnB,kBAAkB,IAAI,QAAQ,EAC9B,oBAAoB,IAAI,OAAO,EAC/B,oBAAoB,IAAI,cAAc,EACtC,oBAAoB,IAAI,cAAc,EACtC,oBAAoB,IAAI,cAAc,EACtC,wBAAwB,IAAI,kBAAkB,GAC/C,MAAM,uBAAuB,CAAC"}