@runloop/reflex-client 0.12.0 → 0.13.0

package/src/react/agent-personas.ts

@@ -0,0 +1,260 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  MutationFunction,
+  QueryFunction,
+  QueryKey,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  Agent
+} from './model/agent.js';
+
+import type {
+  AgentPersona
+} from './model/agentPersona.js';
+
+import type {
+  LaunchAgentFromPersonaBody
+} from './model/launchAgentFromPersonaBody.js';
+
+import { apiFetch } from '../react-mutator.js';
+
+
+type AwaitedInput<T> = PromiseLike<T> | T;
+
+      type Awaited<O> = O extends AwaitedInput<infer T> ? T : never;
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+const withQueryKey = <T extends object, K>(query: T, queryKey: K): T & { queryKey: K } => {
+  const result = { queryKey } as T & { queryKey: K };
+  for (const key of Object.keys(query)) {
+    // The explicit queryKey always wins, matching the previous
+    // `{ ...query, queryKey }` spread where it was set last.
+    if (key === 'queryKey') continue;
+    Object.defineProperty(result, key, {
+      enumerable: true,
+      configurable: true,
+      get: () => (query as Record<string, unknown>)[key],
+    });
+  }
+  return result;
+};
+
+/**
+ * @summary List the agent personas visible in the active organization.
+ */
+export const listAgentPersonas = (
+
+ options?: SecondParameter<typeof apiFetch>,signal?: AbortSignal
+) => {
+
+
+      return apiFetch<AgentPersona[]>(
+      {url: `/agent-personas`, method: 'GET', signal
+    },
+      options);
+    }
+
+
+
+
+export const getListAgentPersonasQueryKey = () => {
+    return [
+    `/agent-personas`
+    ] as const;
+    }
+
+
+export const getListAgentPersonasQueryOptions = <TData = Awaited<ReturnType<typeof listAgentPersonas>>, TError = unknown>( options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof listAgentPersonas>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getListAgentPersonasQueryKey();
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof listAgentPersonas>>> = ({ signal }) => listAgentPersonas(requestOptions, signal);
+
+
+
+
+
+   return  { queryKey, queryFn, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listAgentPersonas>>, TError, TData> & { queryKey: QueryKey }
+}
+
+export type ListAgentPersonasQueryResult = NonNullable<Awaited<ReturnType<typeof listAgentPersonas>>>
+export type ListAgentPersonasQueryError = unknown
+
+
+/**
+ * @summary List the agent personas visible in the active organization.
+ */
+
+export function useListAgentPersonas<TData = Awaited<ReturnType<typeof listAgentPersonas>>, TError = unknown>(
+  options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof listAgentPersonas>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+
+ ):  UseQueryResult<TData, TError> & { queryKey: QueryKey } {
+
+  const queryOptions = getListAgentPersonasQueryOptions(options)
+
+  const query = useQuery(queryOptions) as  UseQueryResult<TData, TError> & { queryKey: QueryKey };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+
+
+
+
+
+/**
+ * @summary Get an agent persona by id.
+ */
+export const getAgentPersona = (
+    id: string,
+ options?: SecondParameter<typeof apiFetch>,signal?: AbortSignal
+) => {
+
+
+      return apiFetch<AgentPersona>(
+      {url: `/agent-personas/${encodeURIComponent(String(id))}`, method: 'GET', signal
+    },
+      options);
+    }
+
+
+
+
+export const getGetAgentPersonaQueryKey = (id: string,) => {
+    return [
+    `/agent-personas/${id}`
+    ] as const;
+    }
+
+
+export const getGetAgentPersonaQueryOptions = <TData = Awaited<ReturnType<typeof getAgentPersona>>, TError = unknown>(id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentPersona>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetAgentPersonaQueryKey(id);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getAgentPersona>>> = ({ signal }) => getAgentPersona(id, requestOptions, signal);
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: id !== null && id !== undefined, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getAgentPersona>>, TError, TData> & { queryKey: QueryKey }
+}
+
+export type GetAgentPersonaQueryResult = NonNullable<Awaited<ReturnType<typeof getAgentPersona>>>
+export type GetAgentPersonaQueryError = unknown
+
+
+/**
+ * @summary Get an agent persona by id.
+ */
+
+export function useGetAgentPersona<TData = Awaited<ReturnType<typeof getAgentPersona>>, TError = unknown>(
+ id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentPersona>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+
+ ):  UseQueryResult<TData, TError> & { queryKey: QueryKey } {
+
+  const queryOptions = getGetAgentPersonaQueryOptions(id,options)
+
+  const query = useQuery(queryOptions) as  UseQueryResult<TData, TError> & { queryKey: QueryKey };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+
+
+
+
+
+/**
+ * Starts an agent from the persona's saved configuration with per-launch overrides layered on top. `agentType` runs the persona as a different agent — the model, endpoint route, and the persona's pinned provider key are then re-resolved for that type rather than carried over.
+ * @summary Launch an agent from a persona.
+ */
+export const launchAgentFromPersona = (
+    id: string,
+    launchAgentFromPersonaBody: LaunchAgentFromPersonaBody,
+ options?: SecondParameter<typeof apiFetch>,signal?: AbortSignal
+) => {
+
+
+      return apiFetch<Agent>(
+      {url: `/agent-personas/${encodeURIComponent(String(id))}/launch`, method: 'POST',
+      headers: {'Content-Type': 'application/json', },
+      data: launchAgentFromPersonaBody, signal
+    },
+      options);
+    }
+
+
+
+export const getLaunchAgentFromPersonaMutationOptions = <TError = unknown,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof launchAgentFromPersona>>, TError,{id: string;data: LaunchAgentFromPersonaBody}, TContext>, request?: SecondParameter<typeof apiFetch>}
+): UseMutationOptions<Awaited<ReturnType<typeof launchAgentFromPersona>>, TError,{id: string;data: LaunchAgentFromPersonaBody}, TContext> => {
+
+const mutationKey = ['launchAgentFromPersona'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof launchAgentFromPersona>>, {id: string;data: LaunchAgentFromPersonaBody}> = (props) => {
+          const {id,data} = props ?? {};
+
+          return  launchAgentFromPersona(id,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type LaunchAgentFromPersonaMutationResult = NonNullable<Awaited<ReturnType<typeof launchAgentFromPersona>>>
+    export type LaunchAgentFromPersonaMutationBody = LaunchAgentFromPersonaBody
+    export type LaunchAgentFromPersonaMutationError = unknown
+
+    /**
+ * @summary Launch an agent from a persona.
+ */
+export const useLaunchAgentFromPersona = <TError = unknown,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof launchAgentFromPersona>>, TError,{id: string;data: LaunchAgentFromPersonaBody}, TContext>, request?: SecondParameter<typeof apiFetch>}
+ ): UseMutationResult<
+        Awaited<ReturnType<typeof launchAgentFromPersona>>,
+        TError,
+        {id: string;data: LaunchAgentFromPersonaBody},
+        TContext
+      > => {
+      return useMutation(getLaunchAgentFromPersonaMutationOptions(options));
+    }

package/src/react/model/agentPersona.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentPersonaAttachments } from './agentPersonaAttachments.js';
+import type { AgentPersonaEnvVars } from './agentPersonaEnvVars.js';
+import type { AgentPersonaPromptMode } from './agentPersonaPromptMode.js';
+import type { AgentPersonaSandboxOptions } from './agentPersonaSandboxOptions.js';
+
+export interface AgentPersona {
+  name: string;
+  agentType: string;
+  systemPrompt: string | null;
+  model: string | null;
+  modelEndpointId: string | null;
+  blueprintId?: string;
+  blueprintName: string | null;
+  sandboxOptions: AgentPersonaSandboxOptions;
+  attachments: AgentPersonaAttachments;
+  envVars: AgentPersonaEnvVars;
+  promptMode: AgentPersonaPromptMode;
+  labelIds: string[] | null;
+  groupId: string | null;
+  modelProviderSecretId: string | null;
+  id: string;
+  description: string | null;
+  icon: string | null;
+  defaultPrompt: string | null;
+  isBuiltIn: boolean;
+  organizationId: string | null;
+  ownerId: string | null;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/react/model/agentPersonaAttachments.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentPersonaAttachments = {
+  attachmentId: string;
+  pluginName: string;
+  config?: unknown;
+}[] | null;

package/src/react/model/agentPersonaEnvVars.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentPersonaEnvVars = {
+  /**
+     * @minLength 1
+     * @pattern ^[A-Za-z_][A-Za-z0-9_]*$
+     */
+  key: string;
+  value?: string;
+  secretRef?: string;
+  isSecret?: boolean;
+}[] | null;

package/src/react/model/agentPersonaPromptMode.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentPersonaPromptMode = typeof AgentPersonaPromptMode[keyof typeof AgentPersonaPromptMode] | null;
+
+
+export const AgentPersonaPromptMode = {
+  implement: 'implement',
+  plan: 'plan',
+  review: 'review',
+} as const;

package/src/react/model/agentPersonaSandboxOptions.ts

@@ -0,0 +1,21 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentPersonaSandboxOptionsCustomSize } from './agentPersonaSandboxOptionsCustomSize.js';
+import type { AgentPersonaSandboxOptionsResourceSize } from './agentPersonaSandboxOptionsResourceSize.js';
+
+export type AgentPersonaSandboxOptions = {
+  blueprintName?: string | null;
+  blueprintId?: string | null;
+  snapshotId?: string | null;
+  resourceSize?: AgentPersonaSandboxOptionsResourceSize;
+  customSize?: AgentPersonaSandboxOptionsCustomSize;
+  dockerd?: boolean | null;
+  computerUse?: boolean | null;
+  artifactMirrors?: boolean | null;
+  idleTimeMinutes?: number | null;
+  resumeOnHttp?: boolean | null;
+} | null;

package/src/react/model/agentPersonaSandboxOptionsCustomSize.ts

@@ -0,0 +1,22 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentPersonaSandboxOptionsCustomSize = {
+  /**
+     * @minLength 1
+     * @maxLength 50
+     */
+  name: string;
+  /** @minimum 0.5 */
+  cpuCores: number;
+  /**
+     * @minimum 1
+     * @maximum 9007199254740991
+     */
+  gbMemory: number;
+  diskSizeGb?: number | null;
+} | null;

package/src/react/model/agentPersonaSandboxOptionsResourceSize.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentPersonaSandboxOptionsResourceSize = typeof AgentPersonaSandboxOptionsResourceSize[keyof typeof AgentPersonaSandboxOptionsResourceSize] | null;
+
+
+export const AgentPersonaSandboxOptionsResourceSize = {
+  SMALL: 'SMALL',
+  MEDIUM: 'MEDIUM',
+  LARGE: 'LARGE',
+  X_LARGE: 'X_LARGE',
+  XX_LARGE: 'XX_LARGE',
+} as const;

package/src/react/model/launchAgentFromPersonaBody.ts

@@ -0,0 +1,39 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { LaunchAgentFromPersonaBodyAuthMethod } from './launchAgentFromPersonaBodyAuthMethod.js';
+import type { LaunchAgentFromPersonaBodyContentItem } from './launchAgentFromPersonaBodyContentItem.js';
+import type { LaunchAgentFromPersonaBodyExtraAttachmentsItem } from './launchAgentFromPersonaBodyExtraAttachmentsItem.js';
+import type { LaunchAgentFromPersonaBodyExtraEnvVarsItem } from './launchAgentFromPersonaBodyExtraEnvVarsItem.js';
+import type { LaunchAgentFromPersonaBodyPromptMode } from './launchAgentFromPersonaBodyPromptMode.js';
+import type { LaunchAgentFromPersonaBodyPromptStrategy } from './launchAgentFromPersonaBodyPromptStrategy.js';
+import type { LaunchAgentFromPersonaBodySandboxOptions } from './launchAgentFromPersonaBodySandboxOptions.js';
+
+export type LaunchAgentFromPersonaBody = {
+  /** @minLength 1 */
+  prompt: string;
+  promptStrategy?: LaunchAgentFromPersonaBodyPromptStrategy;
+  name?: string;
+  /** @minLength 1 */
+  agentType?: string;
+  model?: string;
+  /** @minLength 1 */
+  modelEndpointId?: string;
+  systemPrompt?: string;
+  promptMode?: LaunchAgentFromPersonaBodyPromptMode;
+  authMethod?: LaunchAgentFromPersonaBodyAuthMethod;
+  /** @pattern ^mps_[A-Za-z0-9]{22}$ */
+  providerSecretId?: string;
+  content?: LaunchAgentFromPersonaBodyContentItem[];
+  extraAttachments?: LaunchAgentFromPersonaBodyExtraAttachmentsItem[];
+  extraEnvVars?: LaunchAgentFromPersonaBodyExtraEnvVarsItem[];
+  repoSlug?: string;
+  repoBranch?: string;
+  extraLabelIds?: string[];
+  groupId?: string;
+  blueprintName?: string;
+  sandboxOptions?: LaunchAgentFromPersonaBodySandboxOptions;
+};

package/src/react/model/launchAgentFromPersonaBodyAuthMethod.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyAuthMethod = typeof LaunchAgentFromPersonaBodyAuthMethod[keyof typeof LaunchAgentFromPersonaBodyAuthMethod];
+
+
+export const LaunchAgentFromPersonaBodyAuthMethod = {
+  'org-key': 'org-key',
+  'claude-max': 'claude-max',
+  'codex-subscription': 'codex-subscription',
+} as const;

package/src/react/model/launchAgentFromPersonaBodyContentItem.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyContentItem = {
+  type: 'text';
+  text: string;
+} | {
+  type: 'image';
+  mimeType: string;
+  data: string;
+} | {
+  type: 'file';
+  name: string;
+  mimeType: string;
+  data: string;
+};

package/src/react/model/launchAgentFromPersonaBodyExtraAttachmentsItem.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyExtraAttachmentsItem = {
+  attachmentId: string;
+  pluginName: string;
+  config?: unknown;
+};

package/src/react/model/launchAgentFromPersonaBodyExtraEnvVarsItem.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyExtraEnvVarsItem = {
+  /**
+     * @minLength 1
+     * @pattern ^[A-Za-z_][A-Za-z0-9_]*$
+     */
+  key: string;
+  value?: string;
+  secretRef?: string;
+  isSecret?: boolean;
+};

package/src/react/model/launchAgentFromPersonaBodyPromptMode.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyPromptMode = typeof LaunchAgentFromPersonaBodyPromptMode[keyof typeof LaunchAgentFromPersonaBodyPromptMode];
+
+
+export const LaunchAgentFromPersonaBodyPromptMode = {
+  implement: 'implement',
+  plan: 'plan',
+  review: 'review',
+} as const;

package/src/react/model/launchAgentFromPersonaBodyPromptStrategy.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodyPromptStrategy = typeof LaunchAgentFromPersonaBodyPromptStrategy[keyof typeof LaunchAgentFromPersonaBodyPromptStrategy];
+
+
+export const LaunchAgentFromPersonaBodyPromptStrategy = {
+  'prepend-default': 'prepend-default',
+  replace: 'replace',
+} as const;

package/src/react/model/launchAgentFromPersonaBodySandboxOptions.ts

@@ -0,0 +1,21 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { LaunchAgentFromPersonaBodySandboxOptionsCustomSize } from './launchAgentFromPersonaBodySandboxOptionsCustomSize.js';
+import type { LaunchAgentFromPersonaBodySandboxOptionsResourceSize } from './launchAgentFromPersonaBodySandboxOptionsResourceSize.js';
+
+export type LaunchAgentFromPersonaBodySandboxOptions = {
+  blueprintName?: string | null;
+  blueprintId?: string | null;
+  snapshotId?: string | null;
+  resourceSize?: LaunchAgentFromPersonaBodySandboxOptionsResourceSize;
+  customSize?: LaunchAgentFromPersonaBodySandboxOptionsCustomSize;
+  dockerd?: boolean | null;
+  computerUse?: boolean | null;
+  artifactMirrors?: boolean | null;
+  idleTimeMinutes?: number | null;
+  resumeOnHttp?: boolean | null;
+};

package/src/react/model/launchAgentFromPersonaBodySandboxOptionsCustomSize.ts

@@ -0,0 +1,22 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodySandboxOptionsCustomSize = {
+  /**
+     * @minLength 1
+     * @maxLength 50
+     */
+  name: string;
+  /** @minimum 0.5 */
+  cpuCores: number;
+  /**
+     * @minimum 1
+     * @maximum 9007199254740991
+     */
+  gbMemory: number;
+  diskSizeGb?: number | null;
+} | null;

package/src/react/model/launchAgentFromPersonaBodySandboxOptionsResourceSize.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type LaunchAgentFromPersonaBodySandboxOptionsResourceSize = typeof LaunchAgentFromPersonaBodySandboxOptionsResourceSize[keyof typeof LaunchAgentFromPersonaBodySandboxOptionsResourceSize] | null;
+
+
+export const LaunchAgentFromPersonaBodySandboxOptionsResourceSize = {
+  SMALL: 'SMALL',
+  MEDIUM: 'MEDIUM',
+  LARGE: 'LARGE',
+  X_LARGE: 'X_LARGE',
+  XX_LARGE: 'XX_LARGE',
+} as const;