hippocampus-mcp 1.0.0

package/README.md

@@ -0,0 +1,284 @@
+# Hippocampus MCP
+
+**Personal Knowledge MCP Server** - Provides AI assistants with access to personal knowledge, preferences, and contextual information stored in AWS DynamoDB.
+
+## Features
+
+- **Personal Knowledge Management**: Store and retrieve notes, preferences, and contextual information
+- **Semantic Search**: Find relevant information using natural language queries
+- **Category Organization**: Organize knowledge by categories (work, personal, technical, etc.)
+- **AWS Integration**: Leverages DynamoDB for scalable, serverless storage
+- **MCP Protocol**: Standard Model Context Protocol implementation for AI assistant integration
+
+## Prerequisites
+
+- Node.js 18.0.0 or higher
+- AWS Account with DynamoDB access
+- AWS CLI configured with credentials (or AWS SSO profile)
+
+## Installation
+
+### Quick Start (Recommended)
+
+Add to your MCP client configuration (e.g., `~/.kiro/settings/mcp.json` or `.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "hippocampus-mcp": {
+      "command": "npx",
+      "args": ["-y", "hippocampus-mcp@latest"],
+      "env": {
+        "AWS_PROFILE": "your-profile-name",
+        "AWS_REGION": "us-east-1",
+        "DYNAMODB_TABLE_NAME": "your-table-name"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+That's it! The MCP client will automatically download and run the server when needed.
+
+### Manual Installation
+
+```bash
+npm install -g hippocampus-mcp
+```
+
+## Configuration
+
+The server requires the following environment variables:
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `AWS_PROFILE` | AWS CLI profile name | - | No* |
+| `AWS_REGION` | AWS region for DynamoDB | `us-east-1` | No |
+| `DYNAMODB_TABLE_NAME` | DynamoDB table name | `personal-knowledge` | No |
+
+*Either `AWS_PROFILE` or standard AWS credentials (access key/secret) must be configured.
+
+## AWS Setup
+
+### 1. Create DynamoDB Table
+
+You can deploy the required infrastructure using AWS CDK (included in this package):
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/hippocampus-mcp.git
+cd hippocampus-mcp
+
+# Install dependencies
+npm install
+
+# Deploy infrastructure
+npm run cdk:deploy
+```
+
+Or create manually:
+- Table name: `personal-knowledge` (or your custom name)
+- Partition key: `PK` (String)
+- Sort key: `SK` (String)
+- GSI: `GSI1` with `GSI1PK` (String) and `GSI1SK` (String)
+
+### 2. Configure AWS Credentials
+
+```bash
+# Option 1: AWS SSO
+aws sso login --profile your-profile-name
+
+# Option 2: AWS CLI credentials
+aws configure
+```
+
+## Usage with MCP Clients
+
+### Kiro IDE
+
+Edit `~/.kiro/settings/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "hippocampus-mcp": {
+      "command": "npx",
+      "args": ["-y", "hippocampus-mcp@latest"],
+      "env": {
+        "AWS_PROFILE": "hc1",
+        "AWS_REGION": "us-east-1",
+        "DYNAMODB_TABLE_NAME": "hc1-model-knowledge-241763622848"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Edit `~/.cursor/mcp.json` or `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "hippocampus-mcp": {
+      "command": "npx",
+      "args": ["-y", "hippocampus-mcp@latest"],
+      "env": {
+        "AWS_PROFILE": "hc1",
+        "AWS_REGION": "us-east-1"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "hippocampus-mcp": {
+      "command": "npx",
+      "args": ["-y", "hippocampus-mcp@latest"],
+      "env": {
+        "AWS_PROFILE": "hc1",
+        "AWS_REGION": "us-east-1"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+The server provides the following MCP tools:
+
+### Knowledge Management
+- `create_note` - Create a new note with content and metadata
+- `get_note` - Retrieve a specific note by ID
+- `update_note` - Update an existing note
+- `delete_note` - Delete a note
+- `list_notes` - List all notes with optional filtering
+
+### Search
+- `search_notes` - Semantic search across all notes
+- `search_by_category` - Find notes by category
+
+### Preferences
+- `set_preference` - Store a user preference
+- `get_preference` - Retrieve a preference value
+- `list_preferences` - List all preferences
+
+## Available Resources
+
+The server exposes the following MCP resources:
+
+- `knowledge://notes` - Access to all notes
+- `knowledge://preferences` - Access to user preferences
+- `knowledge://categories` - List of available categories
+
+## Example Interactions
+
+```
+User: "Remember that I prefer dark mode for all applications"
+AI: [Uses set_preference tool]
+
+User: "What are my preferences for UI themes?"
+AI: [Uses get_preference tool]
+
+User: "Create a note about the AWS CDK deployment process"
+AI: [Uses create_note tool]
+
+User: "Find all my notes about AWS"
+AI: [Uses search_notes tool]
+```
+
+## Development
+
+### Local Development
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/hippocampus-mcp.git
+cd hippocampus-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start
+
+# Run tests
+npm test
+```
+
+### Testing with MCP Inspector
+
+```bash
+# Install MCP Inspector
+npm install -g @modelcontextprotocol/inspector
+
+# Run inspector
+mcp-inspector npx hippocampus-mcp
+```
+
+## Security Considerations
+
+- AWS credentials are never transmitted - they remain local to your machine
+- All data is stored in your own AWS account
+- The server runs locally and communicates via stdio (no network exposure)
+- Follow AWS IAM best practices for credential management
+
+## Cost Considerations
+
+- DynamoDB: Pay-per-request pricing (very low cost for personal use)
+- Typical usage: < $1/month for individual users
+- No additional AWS services required
+
+## Troubleshooting
+
+### Server won't start
+- Verify AWS credentials: `aws sts get-caller-identity --profile your-profile`
+- Check DynamoDB table exists: `aws dynamodb describe-table --table-name your-table --profile your-profile`
+- Review logs in MCP client (usually stderr output)
+
+### Permission errors
+- Ensure IAM user/role has DynamoDB permissions:
+  - `dynamodb:PutItem`
+  - `dynamodb:GetItem`
+  - `dynamodb:Query`
+  - `dynamodb:Scan`
+  - `dynamodb:UpdateItem`
+  - `dynamodb:DeleteItem`
+
+### Connection issues
+- Verify network connectivity to AWS
+- Check AWS region configuration
+- Ensure MCP client is properly configured
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+- Issues: https://github.com/yourusername/hippocampus-mcp/issues
+- Documentation: https://github.com/yourusername/hippocampus-mcp/wiki
+
+## Related Projects
+
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [AWS MCP Servers](https://github.com/awslabs/mcp)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

package/dist/aws/credentials-provider.d.ts

@@ -0,0 +1,20 @@
+import type { AwsCredentialIdentity, AwsCredentialIdentityProvider } from '@aws-sdk/types';
+export declare class CredentialsError extends Error {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+export interface CredentialsProviderConfig {
+    profile?: string;
+    region?: string;
+}
+export interface CredentialsResult {
+    credentials: AwsCredentialIdentity;
+    profile?: string;
+    source: string;
+}
+export declare function createCredentialsProvider(config?: CredentialsProviderConfig): AwsCredentialIdentityProvider;
+export declare function loadCredentials(config?: CredentialsProviderConfig): Promise<CredentialsResult>;
+export declare function validateCredentials(config?: CredentialsProviderConfig): Promise<boolean>;
+export declare function getProfileName(config?: CredentialsProviderConfig): string;
+export declare function getRegion(config?: CredentialsProviderConfig): string;
+//# sourceMappingURL=credentials-provider.d.ts.map

package/dist/aws/credentials-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-provider.d.ts","sourceRoot":"","sources":["../../src/aws/credentials-provider.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAK3F,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAKD,MAAM,WAAW,yBAAyB;IAIxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,iBAAiB;IAIhC,WAAW,EAAE,qBAAqB,CAAC;IAKnC,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,yBAA8B,GACrC,6BAA6B,CAU/B;AAYD,wBAAsB,eAAe,CACnC,MAAM,GAAE,yBAA8B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CA+C5B;AAiDD,wBAAsB,mBAAmB,CACvC,MAAM,GAAE,yBAA8B,GACrC,OAAO,CAAC,OAAO,CAAC,CAalB;AAQD,wBAAgB,cAAc,CAAC,MAAM,GAAE,yBAA8B,GAAG,MAAM,CAE7E;AAQD,wBAAgB,SAAS,CAAC,MAAM,GAAE,yBAA8B,GAAG,MAAM,CAExE"}

package/dist/aws/credentials-provider.js

@@ -0,0 +1,107 @@
+import { fromIni } from '@aws-sdk/credential-provider-ini';
+import { fromEnv } from '@aws-sdk/credential-provider-env';
+import { defaultProvider } from '@aws-sdk/credential-provider-node';
+export class CredentialsError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = 'CredentialsError';
+        this.cause = cause;
+    }
+}
+export function createCredentialsProvider(config = {}) {
+    const profile = config.profile || process.env['AWS_PROFILE'] || 'hc1';
+    const region = config.region || process.env['AWS_REGION'] || 'us-east-1';
+    return defaultProvider({
+        profile,
+        clientConfig: { region },
+    });
+}
+export async function loadCredentials(config = {}) {
+    const profile = config.profile || process.env['AWS_PROFILE'] || 'hc1';
+    const region = config.region || process.env['AWS_REGION'] || 'us-east-1';
+    try {
+        try {
+            const envProvider = fromEnv();
+            const credentials = await envProvider();
+            return {
+                credentials,
+                source: 'environment',
+            };
+        }
+        catch {
+        }
+        try {
+            const profileProvider = fromIni({ profile });
+            const credentials = await profileProvider();
+            return {
+                credentials,
+                profile,
+                source: 'profile',
+            };
+        }
+        catch {
+        }
+        const chainProvider = defaultProvider({
+            profile,
+            clientConfig: { region },
+        });
+        const credentials = await chainProvider();
+        return {
+            credentials,
+            profile,
+            source: 'credential-chain',
+        };
+    }
+    catch (error) {
+        const errorMessage = buildCredentialsErrorMessage(profile, error);
+        throw new CredentialsError(errorMessage, error);
+    }
+}
+function buildCredentialsErrorMessage(profile, error) {
+    const errorDetails = error instanceof Error ? error.message : String(error);
+    return `Failed to load AWS credentials for profile "${profile}".
+
+Possible causes:
+1. AWS credentials are not configured on this machine
+2. The profile "${profile}" does not exist in ~/.aws/credentials
+3. The credentials file is malformed or inaccessible
+4. Environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are not set
+
+To fix this issue:
+
+Option 1: Configure AWS credentials using the AWS CLI
+  $ aws configure --profile ${profile}
+
+Option 2: Set environment variables
+  $ export AWS_ACCESS_KEY_ID=your_access_key
+  $ export AWS_SECRET_ACCESS_KEY=your_secret_key
+  $ export AWS_REGION=us-east-1
+
+Option 3: Use a different profile
+  $ export AWS_PROFILE=your_profile_name
+
+For more information, see:
+https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html
+
+Original error: ${errorDetails}`;
+}
+export async function validateCredentials(config = {}) {
+    try {
+        await loadCredentials(config);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof CredentialsError) {
+            throw error;
+        }
+        throw new CredentialsError('Failed to validate AWS credentials', error);
+    }
+}
+export function getProfileName(config = {}) {
+    return config.profile || process.env['AWS_PROFILE'] || 'hc1';
+}
+export function getRegion(config = {}) {
+    return config.region || process.env['AWS_REGION'] || 'us-east-1';
+}
+//# sourceMappingURL=credentials-provider.js.map

package/dist/aws/credentials-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-provider.js","sourceRoot":"","sources":["../../src/aws/credentials-provider.ts"],"names":[],"mappings":"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"}

package/dist/config/environment.d.ts

@@ -0,0 +1,12 @@
+export interface Config {
+    awsRegion: string;
+    awsProfile: string;
+    tableName: string;
+}
+export declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare function loadConfig(): Config;
+export declare function getConfig(): Config;
+export declare function resetConfig(): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/config/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,MAAM;IAErB,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAQD,wBAAgB,UAAU,IAAI,MAAM,CAcnC;AAyCD,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAKD,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config/environment.js

@@ -0,0 +1,42 @@
+export class ConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+    }
+}
+export function loadConfig() {
+    const awsRegion = process.env['AWS_REGION']?.trim() || 'us-east-1';
+    const awsProfile = process.env['AWS_PROFILE']?.trim() || 'hc1';
+    const tableName = process.env['TABLE_NAME']?.trim() || 'hc1-model-knowledge-241763622848';
+    validateConfig({ awsRegion, awsProfile, tableName });
+    return {
+        awsRegion,
+        awsProfile,
+        tableName,
+    };
+}
+function validateConfig(config) {
+    if (!config.awsRegion) {
+        throw new ConfigurationError('AWS_REGION cannot be empty');
+    }
+    if (!config.awsProfile) {
+        throw new ConfigurationError('AWS_PROFILE cannot be empty');
+    }
+    if (!config.tableName) {
+        throw new ConfigurationError('TABLE_NAME cannot be empty');
+    }
+    if (!config.tableName.startsWith('hc1-')) {
+        console.warn(`Warning: TABLE_NAME "${config.tableName}" does not follow project naming convention (hc1-*)`);
+    }
+}
+let cachedConfig = null;
+export function getConfig() {
+    if (!cachedConfig) {
+        cachedConfig = loadConfig();
+    }
+    return cachedConfig;
+}
+export function resetConfig() {
+    cachedConfig = null;
+}
+//# sourceMappingURL=environment.js.map

package/dist/config/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAQD,MAAM,UAAU,UAAU;IAExB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,kCAAkC,CAAC;IAG1F,cAAc,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAErD,OAAO;QACL,SAAS;QACT,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAQD,SAAS,cAAc,CAAC,MAAc;IAGpC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IAGD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CACV,wBAAwB,MAAM,CAAC,SAAS,qDAAqD,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAKD,IAAI,YAAY,GAAkB,IAAI,CAAC;AAOvC,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAKD,MAAM,UAAU,WAAW;IACzB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { loadConfig, getConfig, resetConfig, ConfigurationError, type Config } from './environment';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { loadConfig, getConfig, resetConfig, ConfigurationError } from './environment';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAe,MAAM,eAAe,CAAC"}

package/dist/data/dynamodb-client.d.ts

@@ -0,0 +1,25 @@
+import { type PutCommandInput, type GetCommandInput, type QueryCommandInput, type ScanCommandInput, type PutCommandOutput, type GetCommandOutput, type QueryCommandOutput, type ScanCommandOutput } from '@aws-sdk/lib-dynamodb';
+export declare class DynamoDBError extends Error {
+    readonly cause?: Error;
+    readonly operation: string;
+    constructor(operation: string, message: string, cause?: Error);
+}
+export interface DynamoDBClientConfig {
+    region?: string;
+    profile?: string;
+    tableName?: string;
+}
+export declare class DynamoDBClientWrapper {
+    private readonly client;
+    private readonly tableName;
+    constructor(config?: DynamoDBClientConfig);
+    getTableName(): string;
+    putItem(item: Record<string, any>, options?: Omit<PutCommandInput, 'TableName' | 'Item'>): Promise<PutCommandOutput>;
+    getItem(key: Record<string, any>, options?: Omit<GetCommandInput, 'TableName' | 'Key'>): Promise<GetCommandOutput>;
+    query(options: Omit<QueryCommandInput, 'TableName'>): Promise<QueryCommandOutput>;
+    scan(options?: Omit<ScanCommandInput, 'TableName'>): Promise<ScanCommandOutput>;
+    private getErrorMessage;
+    close(): Promise<void>;
+}
+export declare function createDynamoDBClient(config?: DynamoDBClientConfig): DynamoDBClientWrapper;
+//# sourceMappingURL=dynamodb-client.d.ts.map

package/dist/data/dynamodb-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb-client.d.ts","sourceRoot":"","sources":["../../src/data/dynamodb-client.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAM/B,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;IACvC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM9D;AAKD,MAAM,WAAW,oBAAoB;IAInC,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAOvB,MAAM,GAAE,oBAAyB;IAwC7C,YAAY,IAAI,MAAM;IAYhB,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,MAAM,CAAC,GACpD,OAAO,CAAC,gBAAgB,CAAC;IA0BtB,OAAO,CACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,KAAK,CAAC,GACnD,OAAO,CAAC,gBAAgB,CAAC;IAyBtB,KAAK,CACT,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC5C,OAAO,CAAC,kBAAkB,CAAC;IAwBxB,IAAI,CACR,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC5C,OAAO,CAAC,iBAAiB,CAAC;IAuB7B,OAAO,CAAC,eAAe;IAUjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAQD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,qBAAqB,CAEzF"}

package/dist/data/dynamodb-client.js

@@ -0,0 +1,107 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, PutCommand, GetCommand, QueryCommand, ScanCommand, } from '@aws-sdk/lib-dynamodb';
+import { createCredentialsProvider, getRegion } from '../aws/credentials-provider.js';
+export class DynamoDBError extends Error {
+    cause;
+    operation;
+    constructor(operation, message, cause) {
+        super(message);
+        this.name = 'DynamoDBError';
+        this.operation = operation;
+        this.cause = cause;
+    }
+}
+export class DynamoDBClientWrapper {
+    client;
+    tableName;
+    constructor(config = {}) {
+        const region = config.region || getRegion({ region: config.region });
+        const credentialsProvider = createCredentialsProvider({
+            profile: config.profile,
+            region,
+        });
+        const baseClient = new DynamoDBClient({
+            region,
+            credentials: credentialsProvider,
+        });
+        this.client = DynamoDBDocumentClient.from(baseClient, {
+            marshallOptions: {
+                convertEmptyValues: false,
+                removeUndefinedValues: true,
+                convertClassInstanceToMap: true,
+            },
+            unmarshallOptions: {
+                wrapNumbers: false,
+            },
+        });
+        this.tableName = config.tableName ||
+            process.env['TABLE_NAME'] ||
+            'hc1-model-knowledge-241763622848';
+    }
+    getTableName() {
+        return this.tableName;
+    }
+    async putItem(item, options) {
+        try {
+            const command = new PutCommand({
+                TableName: this.tableName,
+                Item: item,
+                ...options,
+            });
+            return await this.client.send(command);
+        }
+        catch (error) {
+            throw new DynamoDBError('PutItem', `Failed to put item in table ${this.tableName}: ${this.getErrorMessage(error)}`, error);
+        }
+    }
+    async getItem(key, options) {
+        try {
+            const command = new GetCommand({
+                TableName: this.tableName,
+                Key: key,
+                ...options,
+            });
+            return await this.client.send(command);
+        }
+        catch (error) {
+            throw new DynamoDBError('GetItem', `Failed to get item from table ${this.tableName}: ${this.getErrorMessage(error)}`, error);
+        }
+    }
+    async query(options) {
+        try {
+            const command = new QueryCommand({
+                TableName: this.tableName,
+                ...options,
+            });
+            return await this.client.send(command);
+        }
+        catch (error) {
+            throw new DynamoDBError('Query', `Failed to query table ${this.tableName}: ${this.getErrorMessage(error)}`, error);
+        }
+    }
+    async scan(options) {
+        try {
+            const command = new ScanCommand({
+                TableName: this.tableName,
+                ...options,
+            });
+            return await this.client.send(command);
+        }
+        catch (error) {
+            throw new DynamoDBError('Scan', `Failed to scan table ${this.tableName}: ${this.getErrorMessage(error)}`, error);
+        }
+    }
+    getErrorMessage(error) {
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return String(error);
+    }
+    async close() {
+        this.client.destroy();
+    }
+}
+export function createDynamoDBClient(config) {
+    return new DynamoDBClientWrapper(config);
+}
+//# sourceMappingURL=dynamodb-client.js.map

package/dist/data/dynamodb-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb-client.js","sourceRoot":"","sources":["../../src/data/dynamodb-client.ts"],"names":[],"mappings":"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"}