@vibexp/api-client 0.89.0 → 0.90.0

package/dist/axios/sdk.gen.d.ts

@@ -455,7 +455,17 @@ export declare const getPromptDependencies: <ThrowOnError extends boolean = fals
 /**
  * Render a prompt
  *
- * Renders a prompt by resolving @references and substituting placeholders with provided values.
+ * Renders a prompt by resolving references and substituting placeholders with provided values.
+ *
+ * A reference is written `@prompt:<slug>` and resolves to a prompt in the
+ * prompt's own team; `@@` escapes a literal `@`. A bare `@slug` is the
+ * deprecated legacy form: it expands only when it resolves to a prompt and is
+ * otherwise left as plain text without a warning, so emails, handles and
+ * `git@host` remotes are safe. References are resolved on the authored body
+ * only; placeholder values are inserted verbatim.
+ *
+ * With `strict: true`, bare `@slug` is never resolved and an unresolved
+ * `@prompt:<slug>` fails the render with 422.
  *
  */
 export declare const renderPrompt: <ThrowOnError extends boolean = false>(options: Options<RenderPromptData, ThrowOnError>) => RequestResult<RenderPromptResponses, RenderPromptErrors, ThrowOnError>;

package/dist/axios/sdk.gen.js

@@ -1040,7 +1040,17 @@ export const getPromptDependencies = (options) => (options.client ?? client).get
 /**
  * Render a prompt
  *
- * Renders a prompt by resolving @references and substituting placeholders with provided values.
+ * Renders a prompt by resolving references and substituting placeholders with provided values.
+ *
+ * A reference is written `@prompt:<slug>` and resolves to a prompt in the
+ * prompt's own team; `@@` escapes a literal `@`. A bare `@slug` is the
+ * deprecated legacy form: it expands only when it resolves to a prompt and is
+ * otherwise left as plain text without a warning, so emails, handles and
+ * `git@host` remotes are safe. References are resolved on the authored body
+ * only; placeholder values are inserted verbatim.
+ *
+ * With `strict: true`, bare `@slug` is never resolved and an unresolved
+ * `@prompt:<slug>` fails the render with 422.
  *
  */
 export const renderPrompt = (options) => (options.client ?? client).post({

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

@@ -376,6 +376,10 @@ export type RenderPromptRequest = {
     placeholders: {
         [key: string]: string;
     };
+    /**
+     * When true, only explicit @prompt:slug references are resolved (a bare @word such as an email, handle or git@host remote stays literal text), and an unresolved @prompt:slug fails the render with 422 instead of a warning. Recommended for unattended agents.
+     */
+    strict?: boolean;
 };
 export type RenderPromptResponse = {
     rendered_body: string;
@@ -385,7 +389,7 @@ export type RenderPromptResponse = {
     placeholders_missing?: Array<string>;
     references_used?: Array<string>;
     /**
-     * Warnings about issues during rendering (e.g., missing references)
+     * Warnings about issues during rendering, such as an explicit @prompt:slug reference that does not resolve (kept as-is in rendered_body). A bare @word that does not resolve is plain text and never produces a warning.
      */
     warnings?: Array<string>;
 };
@@ -9127,6 +9131,10 @@ export type RenderPromptErrors = {
      * Prompt not found
      */
     404: ErrorResponse;
+    /**
+     * Strict render failed: one or more explicit @prompt:slug references do not resolve. The detail names the missing slugs.
+     */
+    422: ErrorResponse;
 };
 export type RenderPromptError = RenderPromptErrors[keyof RenderPromptErrors];
 export type RenderPromptResponses = {

package/dist/schema.d.ts

@@ -1037,7 +1037,17 @@ export interface paths {
         put?: never;
         /**
          * Render a prompt
-         * @description Renders a prompt by resolving @references and substituting placeholders with provided values.
+         * @description Renders a prompt by resolving references and substituting placeholders with provided values.
+         *
+         *     A reference is written `@prompt:<slug>` and resolves to a prompt in the
+         *     prompt's own team; `@@` escapes a literal `@`. A bare `@slug` is the
+         *     deprecated legacy form: it expands only when it resolves to a prompt and is
+         *     otherwise left as plain text without a warning, so emails, handles and
+         *     `git@host` remotes are safe. References are resolved on the authored body
+         *     only; placeholder values are inserted verbatim.
+         *
+         *     With `strict: true`, bare `@slug` is never resolved and an unresolved
+         *     `@prompt:<slug>` fails the render with 422.
          */
         post: operations["renderPrompt"];
         delete?: never;
@@ -5850,6 +5860,11 @@ export interface components {
             placeholders: {
                 [key: string]: string;
             };
+            /**
+             * @description When true, only explicit @prompt:slug references are resolved (a bare @word such as an email, handle or git@host remote stays literal text), and an unresolved @prompt:slug fails the render with 422 instead of a warning. Recommended for unattended agents.
+             * @default false
+             */
+            strict: boolean;
         };
         RenderPromptResponse: {
             /** @example Please review this code for: security vulnerabilities and code quality */
@@ -5863,9 +5878,9 @@ export interface components {
             placeholders_missing?: string[];
             references_used?: string[];
             /**
-             * @description Warnings about issues during rendering (e.g., missing references)
+             * @description Warnings about issues during rendering, such as an explicit @prompt:slug reference that does not resolve (kept as-is in rendered_body). A bare @word that does not resolve is plain text and never produces a warning.
              * @example [
-             *       "Reference not found: @nonexistent"
+             *       "Reference not found: @prompt:nonexistent"
              *     ]
              */
             warnings?: string[];
@@ -16700,6 +16715,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description Strict render failed: one or more explicit @prompt:slug references do not resolve. The detail names the missing slugs. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
     getPromptShare: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.89.0",
+  "version": "0.90.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {