# @fjell/lib-gcs - Agentic Guide

## Purpose

Google Cloud Storage-backed Fjell library implementation for object/file workflows.

This guide is optimized for AI-assisted code generation and integration workflows.

## Documentation

- **[Usage Guide](./usage.md)** - API-oriented usage patterns and model-safe examples
- **[Integration Guide](./integration.md)** - Architecture placement, composition rules, and implementation guidance

## Key Capabilities

- Provides GCS-backed primary and contained storage libraries
- Includes path/file processors for object key and metadata handling
- Supports file operations with Fjell type integration

## Installation

```bash
npm install @fjell/lib-gcs
```

## Public API Highlights

- `GCSLibrary`, `GCSLibraryFactory`, and options/operations exports
- `PathBuilder`, `FileProcessor`, and `FileOperations` helpers
- `Primary` and `Contained` namespaces plus file type exports