Merge repos swift fm playground and swift bedrock library (#12)

Author: sebsto

.github/workflows/build_soundness.yml

@@ -1,15 +1,24 @@
-name: Build And Soundness checks
+name: Build, tests & soundness checks
 
-on: [push, pull_request]
+on: [pull_request]
 
 jobs:
-  build:
+  swift-bedrock-library:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
       - name: Run tests
-        working-directory: backend
+        working-directory: swift-bedrock-library
+        run: swift test
+
+  playground-backend:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Web playground backend tests
+        working-directory: web-playground/backend
         run: swift build
 
   soundness:

.gitignore

@@ -14,46 +14,40 @@ Package.resolved
 .env
 Makefile
 
-# backend
-backend/.DS_Store
-backend/.build
-backend/.swiftpm
-backend/.devContainer
-backend/Packages
-backend/*.xcodeproj
-backend/xcuserdata/
-backend/.vscode/*
-backend/!/.vscode/hummingbird.code-snippets
-backend/.env.*
-backend/.env
-backend/img/generated_images
-backend/.vscode
-backend/Makefile
-
-# frontend
-frontend/node_modules
-frontend/.pnp
-frontend/.pnp.js
-frontend/.yarn/install-state.gz
-
-frontend/coverage
-
-frontend/.next/
-frontend/out/
-
-frontend/build
-
-frontend/.DS_Store
-frontend/*.pem
-
-frontend/npm-debug.log*
-frontend/yarn-debug.log*
-frontend/yarn-error.log*
-
-frontend/.env*.local
-
-frontend/.vercel
-
-frontend/*.tsbuildinfo
-frontend/next-env.d.ts
-frontend/Makefile
+node_modules
+
+# **/backend
+**/backend/.DS_Store
+**/backend/.build
+**/backend/.swiftpm
+**/backend/.devContainer
+**/backend/Packages
+**/backend/*.xcodeproj
+**/backend/xcuserdata/
+**/backend/.vscode/*
+**/backend/!/.vscode/hummingbird.code-snippets
+**/backend/.env.*
+**/backend/.env
+**/backend/img/generated_images
+**/backend/.vscode
+**/backend/Makefile
+
+# **/frontend
+**/frontend/node_modules
+**/frontend/.pnp
+**/frontend/.pnp.js
+**/frontend/.yarn/install-state.gz
+**/frontend/coverage
+**/frontend/.next/
+**/frontend/out/
+**/frontend/build
+**/frontend/.DS_Store
+**/frontend/*.pem
+**/frontend/npm-debug.log*
+**/frontend/yarn-debug.log*
+**/frontend/yarn-error.log*
+**/frontend/.env*.local
+**/frontend/.vercel
+**/frontend/*.tsbuildinfo
+**/frontend/next-env.d.ts
+**/frontend/Makefile

.licenseignore

@@ -7,6 +7,7 @@
 **/*.md
 CONTRIBUTORS.txt
 LICENSE.txt
+LICENSE
 NOTICE.txt
 Package.swift
 Package@swift-*.swift
@@ -31,10 +32,9 @@ Package.resolved
 *.yaml
 *.yml
 *.json
-*.gif
-frontend/*
+**/*.gif
+**/*.png
+**/frontend/*
+**/*.code-snippets
 .DS_Store
-backend/.vscode/hummingbird.code-snippets
-backend/img/image.png
-LICENSE
-.licenseignore
+.licenseignore

backend/.swift-format renamed to .swift-format

@@ -0,0 +1,59 @@
+// swift-tools-version: 6.1
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "SwiftBedrockLibrary",
+    platforms: [.macOS(.v15), .iOS(.v18), .tvOS(.v18)],
+    products: [
+        .library(name: "BedrockService", targets: ["BedrockService"]),
+        .library(name: "BedrockTypes", targets: ["BedrockTypes"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/apple/swift-argument-parser.git", from: "1.3.0"),
+        .package(url: "https://github.com/awslabs/aws-sdk-swift", from: "1.3.3"),
+        .package(url: "https://github.com/smithy-lang/smithy-swift", from: "0.118.0"),
+        .package(url: "https://github.com/apple/swift-log.git", from: "1.5.0"),
+        .package(url: "https://github.com/awslabs/aws-crt-swift", from: "0.5.0"),
+    ],
+    targets: [
+        .target(
+            name: "BedrockService",
+            dependencies: [
+                .target(name: "BedrockTypes"),
+                .product(name: "AWSClientRuntime", package: "aws-sdk-swift"),
+                .product(name: "AWSBedrock", package: "aws-sdk-swift"),
+                .product(name: "AWSBedrockRuntime", package: "aws-sdk-swift"),
+                .product(name: "Smithy", package: "smithy-swift"),
+                .product(name: "Logging", package: "swift-log"),
+                .product(name: "AwsCommonRuntimeKit", package: "aws-crt-swift"),
+            ],
+            path: "swift-bedrock-library/Sources/BedrockService"
+        ),
+        .target(
+            name: "BedrockTypes",
+            dependencies: [
+                .product(name: "AWSBedrockRuntime", package: "aws-sdk-swift"),
+                .product(name: "AWSBedrock", package: "aws-sdk-swift"),
+                .product(name: "Smithy", package: "smithy-swift"),
+            ],
+            path: "swift-bedrock-library/Sources/BedrockTypes"
+        ),
+        .testTarget(
+            name: "BedrockServiceTests",
+            dependencies: [
+                .target(name: "BedrockService"),
+                .target(name: "BedrockTypes"),
+            ],
+            path: "swift-bedrock-library/Tests/BedrockServiceTests"
+        ),
+        .testTarget(
+            name: "BedrockTypesTests",
+            dependencies: [
+                .target(name: "BedrockTypes")
+            ],
+            path: "swift-bedrock-library/Tests/BedrockTypesTests"
+        ),
+    ]
+)

.vscode/launch.json

@@ -1,33 +1,46 @@
-# Swift FM Playground
+# Amazon Bedrock Swift Library and web playground
 
-Welcome to the Swift Foundation Model (FM) Playground, an example app to explore how to use **Amazon Bedrock** with the AWS SDK for Swift.
+This repository contains projects demonstrating how to use [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html) with Swift.
 
-> 🚨 **Important:** This application is for educational purposes and not intended for production use.
+## Projects
 
-## Overview
+### 1. Swift Bedrock Library
 
-> 🚧 Under construction 🚧
+A tiny layer on top of the [AWS SDK for Swift](https://github.com/awslabs/aws-sdk-swift) for interacting with Amazon Bedrock foundation models. This library provides a convenient way to access Amazon Bedrock's capabilities from Swift applications.
 
-## Prerequisites
+[Go to Swift Bedrock Library →](swift-bedrock-library/README.md)
+
+### 2. Swift FM Playground
+
+An interactive web application that demonstrates the capabilities of Amazon Bedrock foundation models using the Swift Bedrock Library. The playground includes:
+
+- A Swift "backend for frontend" that interfaces with Amazon Bedrock
+- A React frontend for interacting with the models through a user-friendly interface
 
-> 🚧 Under construction 🚧
+[Go to Swift FM Playground →](swift-fm-playground/web-playground/README.md)
 
-## Running the Application
+## Getting Started
 
-> 🚧 Under construction 🚧
+Each project has its own README with specific setup instructions:
+
+- For the Swift Bedrock Library, see the [library README](swift-bedrock-library/README.md)
+- For the Swift FM Playground, see the [playground README](swift-fm-playground/web-playground/README.md)
+
+## Prerequisites
 
-## Accessing the Application
+- Swift 6.0 or later
+- AWS account with access to Amazon Bedrock
+- [AWS credentials configured locally](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) or [SSO configured with AWS Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-accounts.html) configured
 
-To access the application, open `http://localhost:3000` in your web browser.
+## Acknowledgment 
 
-## Stopping the Application
+This library and playground have been written by [Mona Dierickx](https://www.linkedin.com/in/mona-dierickx/), during her last year of studies at [HoGent](https://www.hogent.be/), Belgium.
 
-To halt the application, you will need to stop both the backend and frontend processes.
+Thank you for your enthousiasm and positive attitude during the three months we worked together. (February 2025 - May 2025).
 
-### Stopping the Frontend
+Thank for Professor Steven Van Impe for allowing us to work with these young talents.
 
-In the terminal where the frontend is running, press `Ctrl + C` to terminate the process.
 
-### Stopping the Backend
+## License
 
-Similarly, in the backend terminal, use the `Ctrl + C` shortcut to stop the server.
+These projects are licensed under the Apache License 2.0. See the LICENSE files in each project for details.