fastapi-fullstack 0.1.7__py3-none-any.whl → 0.1.15__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/frontend/src/types/chat.ts

@@ -11,6 +11,8 @@ export interface ChatMessage {
   timestamp: Date;
   toolCalls?: ToolCall[];
   isStreaming?: boolean;
+  /** Group ID for related messages (e.g., CrewAI agent chain) */
+  groupId?: string;
 }
 
 export interface ToolCall {
@@ -23,6 +25,7 @@ export interface ToolCall {
 
 // WebSocket event types from backend
 export type WSEventType =
+  // PydanticAI / LangChain / LangGraph events
   | "user_prompt"
   | "user_prompt_processed"
   | "model_request_start"
@@ -37,7 +40,21 @@ export type WSEventType =
   | "complete"
   | "error"
   | "conversation_created"
-  | "message_saved";
+  | "message_saved"
+  // DeepAgents Human-in-the-Loop event
+  | "tool_approval_required"
+  // CrewAI-specific events
+  | "crew_start"
+  | "crew_started"
+  | "crew_complete"
+  | "agent_started"
+  | "agent_completed"
+  | "task_started"
+  | "task_completed"
+  | "tool_started"
+  | "tool_finished"
+  | "llm_started"
+  | "llm_completed";
 
 export interface WSEvent {
   type: WSEventType;
@@ -81,3 +98,42 @@ export interface ChatState {
   isConnected: boolean;
   isProcessing: boolean;
 }
+
+// Human-in-the-Loop (HITL) types for DeepAgents
+export interface ActionRequest {
+  id: string;
+  tool_name: string;
+  args: Record<string, unknown>;
+}
+
+export interface ReviewConfig {
+  tool_name: string;
+  /** Whether to allow editing the tool arguments */
+  allow_edit?: boolean;
+  /** Maximum time to wait for decision (seconds) */
+  timeout?: number;
+}
+
+export interface PendingApproval {
+  actionRequests: ActionRequest[];
+  reviewConfigs: ReviewConfig[];
+}
+
+export type DecisionType = "approve" | "edit" | "reject";
+
+export interface Decision {
+  type: DecisionType;
+  editedAction?: {
+    id: string;
+    tool_name: string;
+    args: Record<string, unknown>;
+  };
+}
+
+export interface ToolApprovalRequiredEvent {
+  type: "tool_approval_required";
+  data: {
+    action_requests: ActionRequest[];
+    review_configs: ReviewConfig[];
+  };
+}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/configmap.yaml

@@ -0,0 +1,63 @@
+{%- if cookiecutter.enable_kubernetes %}
+# ConfigMap for {{ cookiecutter.project_name }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ cookiecutter.project_slug }}-config
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: backend
+data:
+  # Application settings
+  ENVIRONMENT: "production"
+  DEBUG: "false"
+  PROJECT_NAME: "{{ cookiecutter.project_name }}"
+  API_V1_STR: "/api/v1"
+
+{%- if cookiecutter.use_postgresql %}
+  # PostgreSQL settings
+  POSTGRES_HOST: "postgres-service"
+  POSTGRES_PORT: "5432"
+  POSTGRES_DB: "{{ cookiecutter.project_slug }}"
+{%- endif %}
+
+{%- if cookiecutter.enable_redis %}
+  # Redis settings
+  REDIS_HOST: "redis-service"
+  REDIS_PORT: "6379"
+  REDIS_DB: "0"
+{%- endif %}
+
+{%- if cookiecutter.use_celery %}
+  # Celery settings
+  CELERY_BROKER_URL: "redis://redis-service:6379/0"
+  CELERY_RESULT_BACKEND: "redis://redis-service:6379/0"
+{%- endif %}
+
+{%- if cookiecutter.use_taskiq %}
+  # Taskiq settings
+  TASKIQ_BROKER_URL: "redis://redis-service:6379/1"
+  TASKIQ_RESULT_BACKEND: "redis://redis-service:6379/1"
+{%- endif %}
+
+{%- if cookiecutter.use_arq %}
+  # ARQ settings
+  ARQ_REDIS_HOST: "redis-service"
+  ARQ_REDIS_PORT: "6379"
+  ARQ_REDIS_DB: "2"
+{%- endif %}
+
+{%- if cookiecutter.enable_logfire %}
+  # Logfire settings
+  LOGFIRE_SERVICE_NAME: "{{ cookiecutter.project_slug }}"
+  LOGFIRE_ENVIRONMENT: "production"
+{%- endif %}
+
+{%- if cookiecutter.enable_cors %}
+  # CORS settings (adjust for your domain)
+  CORS_ORIGINS: '["https://{{ cookiecutter.project_slug }}.example.com"]'
+{%- endif %}
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/deployment.yaml

@@ -0,0 +1,242 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Deployment for {{ cookiecutter.project_name }} Backend
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ cookiecutter.project_slug }}-backend
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: backend
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+      app.kubernetes.io/component: backend
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+        app.kubernetes.io/component: backend
+{%- if cookiecutter.enable_prometheus %}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: "{{ cookiecutter.backend_port }}"
+        prometheus.io/path: "/metrics"
+{%- endif %}
+    spec:
+      containers:
+        - name: backend
+          image: {{ cookiecutter.project_slug }}:latest
+          imagePullPolicy: Always
+          ports:
+            - containerPort: {{ cookiecutter.backend_port }}
+              name: http
+          envFrom:
+            - configMapRef:
+                name: {{ cookiecutter.project_slug }}-config
+            - secretRef:
+                name: {{ cookiecutter.project_slug }}-secrets
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "100m"
+            limits:
+              memory: "512Mi"
+              cpu: "500m"
+          livenessProbe:
+            httpGet:
+              path: /api/v1/health
+              port: {{ cookiecutter.backend_port }}
+            initialDelaySeconds: 10
+            periodSeconds: 30
+            timeoutSeconds: 5
+            failureThreshold: 3
+          readinessProbe:
+            httpGet:
+              path: /api/v1/ready
+              port: {{ cookiecutter.backend_port }}
+            initialDelaySeconds: 5
+            periodSeconds: 10
+            timeoutSeconds: 5
+            failureThreshold: 3
+          securityContext:
+            runAsNonRoot: true
+            runAsUser: 1000
+            allowPrivilegeEscalation: false
+            readOnlyRootFilesystem: true
+      restartPolicy: Always
+
+---
+{%- if cookiecutter.use_celery %}
+# Celery Worker Deployment
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ cookiecutter.project_slug }}-celery-worker
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: celery-worker
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+      app.kubernetes.io/component: celery-worker
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+        app.kubernetes.io/component: celery-worker
+    spec:
+      containers:
+        - name: celery-worker
+          image: {{ cookiecutter.project_slug }}:latest
+          imagePullPolicy: Always
+          command: ["celery", "-A", "app.worker.celery_app", "worker", "--loglevel=info"]
+          envFrom:
+            - configMapRef:
+                name: {{ cookiecutter.project_slug }}-config
+            - secretRef:
+                name: {{ cookiecutter.project_slug }}-secrets
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "100m"
+            limits:
+              memory: "512Mi"
+              cpu: "500m"
+      restartPolicy: Always
+
+---
+# Celery Beat Deployment
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ cookiecutter.project_slug }}-celery-beat
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: celery-beat
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+      app.kubernetes.io/component: celery-beat
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+        app.kubernetes.io/component: celery-beat
+    spec:
+      containers:
+        - name: celery-beat
+          image: {{ cookiecutter.project_slug }}:latest
+          imagePullPolicy: Always
+          command: ["celery", "-A", "app.worker.celery_app", "beat", "--loglevel=info"]
+          envFrom:
+            - configMapRef:
+                name: {{ cookiecutter.project_slug }}-config
+            - secretRef:
+                name: {{ cookiecutter.project_slug }}-secrets
+          resources:
+            requests:
+              memory: "128Mi"
+              cpu: "50m"
+            limits:
+              memory: "256Mi"
+              cpu: "200m"
+      restartPolicy: Always
+{%- endif %}
+
+{%- if cookiecutter.use_taskiq %}
+---
+# Taskiq Worker Deployment
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ cookiecutter.project_slug }}-taskiq-worker
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: taskiq-worker
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+      app.kubernetes.io/component: taskiq-worker
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+        app.kubernetes.io/component: taskiq-worker
+    spec:
+      containers:
+        - name: taskiq-worker
+          image: {{ cookiecutter.project_slug }}:latest
+          imagePullPolicy: Always
+          command: ["taskiq", "worker", "app.worker.taskiq_app:broker", "--workers", "2"]
+          envFrom:
+            - configMapRef:
+                name: {{ cookiecutter.project_slug }}-config
+            - secretRef:
+                name: {{ cookiecutter.project_slug }}-secrets
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "100m"
+            limits:
+              memory: "512Mi"
+              cpu: "500m"
+      restartPolicy: Always
+{%- endif %}
+
+{%- if cookiecutter.use_arq %}
+---
+# ARQ Worker Deployment
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ cookiecutter.project_slug }}-arq-worker
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: arq-worker
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+      app.kubernetes.io/component: arq-worker
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+        app.kubernetes.io/component: arq-worker
+    spec:
+      containers:
+        - name: arq-worker
+          image: {{ cookiecutter.project_slug }}:latest
+          imagePullPolicy: Always
+          command: ["arq", "app.worker.arq_app.WorkerSettings"]
+          envFrom:
+            - configMapRef:
+                name: {{ cookiecutter.project_slug }}-config
+            - secretRef:
+                name: {{ cookiecutter.project_slug }}-secrets
+          resources:
+            requests:
+              memory: "256Mi"
+              cpu: "100m"
+            limits:
+              memory: "512Mi"
+              cpu: "500m"
+      restartPolicy: Always
+{%- endif %}
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/ingress.yaml

@@ -0,0 +1,44 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Ingress for {{ cookiecutter.project_name }}
+# Configure your domain and TLS settings before deploying
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ cookiecutter.project_slug }}-ingress
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: ingress
+  annotations:
+    # Nginx Ingress Controller annotations
+    nginx.ingress.kubernetes.io/proxy-body-size: "10m"
+    nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
+    nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
+{%- if cookiecutter.enable_rate_limiting %}
+    # Rate limiting (adjust as needed)
+    nginx.ingress.kubernetes.io/limit-rps: "100"
+    nginx.ingress.kubernetes.io/limit-connections: "50"
+{%- endif %}
+    # Uncomment for Let's Encrypt with cert-manager
+    # cert-manager.io/cluster-issuer: "letsencrypt-prod"
+spec:
+  ingressClassName: nginx
+  # Uncomment for TLS
+  # tls:
+  #   - hosts:
+  #       - api.example.com
+  #     secretName: {{ cookiecutter.project_slug }}-tls
+  rules:
+    - host: api.example.com  # Replace with your domain
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: {{ cookiecutter.project_slug }}-backend
+                port:
+                  number: {{ cookiecutter.backend_port }}
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/kustomization.yaml

@@ -0,0 +1,28 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Kustomization for {{ cookiecutter.project_name }}
+# Deploy with: kubectl apply -k kubernetes/
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+namespace: {{ cookiecutter.project_slug }}
+
+resources:
+  - namespace.yaml
+  - configmap.yaml
+  - secret.yaml
+  - deployment.yaml
+  - service.yaml
+  - ingress.yaml
+
+commonLabels:
+  app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+  app.kubernetes.io/version: "0.1.0"
+  app.kubernetes.io/managed-by: kustomize
+
+# Image customization (override in overlays)
+images:
+  - name: {{ cookiecutter.project_slug }}
+    newTag: latest
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/namespace.yaml

@@ -0,0 +1,12 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Kubernetes Namespace for {{ cookiecutter.project_name }}
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/managed-by: kubectl
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/secret.yaml

@@ -0,0 +1,59 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Secret for {{ cookiecutter.project_name }}
+# WARNING: Replace placeholder values before deploying!
+# Consider using external secrets management (Vault, AWS Secrets Manager, etc.)
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ cookiecutter.project_slug }}-secrets
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: backend
+type: Opaque
+stringData:
+{%- if cookiecutter.use_jwt %}
+  # Generate with: openssl rand -hex 32
+  SECRET_KEY: "CHANGE_ME_IN_PRODUCTION"
+{%- endif %}
+
+{%- if cookiecutter.use_api_key %}
+  API_KEY: "CHANGE_ME_IN_PRODUCTION"
+{%- endif %}
+
+{%- if cookiecutter.use_postgresql %}
+  POSTGRES_USER: "postgres"
+  POSTGRES_PASSWORD: "CHANGE_ME_IN_PRODUCTION"
+{%- endif %}
+
+{%- if cookiecutter.enable_redis %}
+  REDIS_PASSWORD: ""
+{%- endif %}
+
+{%- if cookiecutter.enable_logfire %}
+  LOGFIRE_TOKEN: ""
+{%- endif %}
+
+{%- if cookiecutter.enable_sentry %}
+  SENTRY_DSN: ""
+{%- endif %}
+
+{%- if cookiecutter.enable_ai_agent %}
+{%- if cookiecutter.use_openai %}
+  OPENAI_API_KEY: ""
+{%- endif %}
+{%- if cookiecutter.use_anthropic %}
+  ANTHROPIC_API_KEY: ""
+{%- endif %}
+{%- if cookiecutter.use_openrouter %}
+  OPENROUTER_API_KEY: ""
+{%- endif %}
+{%- endif %}
+
+{%- if cookiecutter.enable_oauth_google %}
+  GOOGLE_CLIENT_ID: ""
+  GOOGLE_CLIENT_SECRET: ""
+{%- endif %}
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/kubernetes/service.yaml

@@ -0,0 +1,23 @@
+{%- if cookiecutter.enable_kubernetes %}
+# Service for {{ cookiecutter.project_name }} Backend
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ cookiecutter.project_slug }}-backend
+  namespace: {{ cookiecutter.project_slug }}
+  labels:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: backend
+spec:
+  type: ClusterIP
+  ports:
+    - port: {{ cookiecutter.backend_port }}
+      targetPort: {{ cookiecutter.backend_port }}
+      protocol: TCP
+      name: http
+  selector:
+    app.kubernetes.io/name: {{ cookiecutter.project_slug }}
+    app.kubernetes.io/component: backend
+{%- else %}
+# Kubernetes is disabled for this project
+{%- endif %}