tools

type BucketResult struct {
	Name         string `json:"name"`
	CreationDate string `json:"creation_date,omitempty"`
}

type ConnectionInfo struct {
	Name     string `json:"name"`
	Region   string `json:"region,omitempty"`
	Endpoint string `json:"endpoint,omitempty"`
}

type CopyObjectInput struct {
	SourceBucket string            `json:"source_bucket" jsonschema_description:"Name of the source S3 bucket."`
	SourceKey    string            `json:"source_key" jsonschema_description:"Key (path) of the source object."`
	DestBucket   string            `json:"dest_bucket" jsonschema_description:"Name of the destination S3 bucket."`
	DestKey      string            `json:"dest_key" jsonschema_description:"Key (path) for the destination object."`
	Metadata     map[string]string `` /* 134-byte string literal not displayed */
	Connection   string            `` /* 133-byte string literal not displayed */
}

type CopyObjectResult struct {
	SourceBucket string `json:"source_bucket"`
	SourceKey    string `json:"source_key"`
	DestBucket   string `json:"dest_bucket"`
	DestKey      string `json:"dest_key"`
	ETag         string `json:"etag,omitempty"`
	LastModified string `json:"last_modified,omitempty"`
	VersionID    string `json:"version_id,omitempty"`
}

type DeleteObjectInput struct {
	Bucket     string `json:"bucket" jsonschema_description:"Name of the S3 bucket containing the object to delete."`
	Key        string `json:"key" jsonschema_description:"Key (path) of the object to delete."`
	Connection string `` /* 133-byte string literal not displayed */
}

type DeleteObjectResult struct {
	Bucket  string `json:"bucket"`
	Key     string `json:"key"`
	Deleted bool   `json:"deleted"`
}

type GetObjectInput struct {
	Bucket     string `json:"bucket" jsonschema_description:"Name of the S3 bucket containing the object."`
	Key        string `json:"key" jsonschema_description:"Key (path) of the object to retrieve."`
	Connection string `` /* 133-byte string literal not displayed */
}

type GetObjectMetadataInput struct {
	Bucket     string `json:"bucket" jsonschema_description:"Name of the S3 bucket containing the object."`
	Key        string `json:"key" jsonschema_description:"Key (path) of the object to get metadata for."`
	Connection string `` /* 133-byte string literal not displayed */
}

type GetObjectMetadataResult struct {
	Bucket        string            `json:"bucket"`
	Key           string            `json:"key"`
	Size          int64             `json:"size"`
	ContentType   string            `json:"content_type,omitempty"`
	ContentLength int64             `json:"content_length"`
	LastModified  string            `json:"last_modified,omitempty"`
	ETag          string            `json:"etag,omitempty"`
	Metadata      map[string]string `json:"metadata,omitempty"`
}

type GetObjectResult struct {
	Bucket       string            `json:"bucket"`
	Key          string            `json:"key"`
	Size         int64             `json:"size"`
	ContentType  string            `json:"content_type,omitempty"`
	LastModified string            `json:"last_modified,omitempty"`
	ETag         string            `json:"etag,omitempty"`
	Metadata     map[string]string `json:"metadata,omitempty"`
	Content      string            `json:"content"`
	IsBase64     bool              `json:"is_base64"`
	Truncated    bool              `json:"truncated"`
}

type InterceptResult struct {
	// Allow indicates whether the request should proceed.
	Allow bool

	// Reason provides an explanation if the request was blocked.
	Reason string

	// ModifiedRequest is an optional modified version of the request.
	// If nil, the original request is used.
	ModifiedRequest *mcp.CallToolRequest
}

type InterceptorChain struct {
	// contains filtered or unexported fields
}

type ListBucketsInput struct {
	Connection string `` /* 133-byte string literal not displayed */
}

type ListBucketsResult struct {
	Buckets []BucketResult `json:"buckets"`
	Count   int            `json:"count"`
}

type ListConnectionsInput struct {
}

type ListConnectionsResult struct {
	Connections       []ConnectionInfo `json:"connections"`
	DefaultConnection string           `json:"default_connection"`
	Count             int              `json:"count"`
}

type ListObjectsInput struct {
	Bucket            string `json:"bucket" jsonschema_description:"Name of the S3 bucket to list objects from."`
	Prefix            string `` /* 141-byte string literal not displayed */
	Delimiter         string `` /* 156-byte string literal not displayed */
	MaxKeys           int32  `json:"max_keys,omitempty" jsonschema_description:"Maximum number of objects to return (1-1000). Default: 1000."`
	ContinuationToken string `` /* 136-byte string literal not displayed */
	Connection        string `` /* 133-byte string literal not displayed */
}

type ListObjectsResult struct {
	Bucket            string         `json:"bucket"`
	Prefix            string         `json:"prefix,omitempty"`
	Delimiter         string         `json:"delimiter,omitempty"`
	Objects           []ObjectResult `json:"objects"`
	CommonPrefixes    []string       `json:"common_prefixes,omitempty"`
	Count             int            `json:"count"`
	IsTruncated       bool           `json:"is_truncated"`
	NextContinueToken string         `json:"next_continuation_token,omitempty"`
}

type MiddlewareChain struct {
	// contains filtered or unexported fields
}

type MiddlewareFunc struct {
	// contains filtered or unexported fields
}

type ObjectResult struct {
	Key          string `json:"key"`
	Size         int64  `json:"size"`
	LastModified string `json:"last_modified,omitempty"`
	ETag         string `json:"etag,omitempty"`
	StorageClass string `json:"storage_class,omitempty"`
}

type Option func(*Toolkit)

type PresignURLInput struct {
	Bucket     string `json:"bucket" jsonschema_description:"Name of the S3 bucket containing the object."`
	Key        string `json:"key" jsonschema_description:"Key (path) of the object to generate a URL for."`
	Method     string `` /* 139-byte string literal not displayed */
	ExpiresIn  int    `` /* 134-byte string literal not displayed */
	Connection string `` /* 133-byte string literal not displayed */
}

type PresignURLResult struct {
	Bucket    string `json:"bucket"`
	Key       string `json:"key"`
	URL       string `json:"url"`
	Method    string `json:"method"`
	ExpiresIn int    `json:"expires_in_seconds"`
	ExpiresAt string `json:"expires_at"`
}

type PutObjectInput struct {
	Bucket      string            `json:"bucket" jsonschema_description:"Name of the S3 bucket to upload to."`
	Key         string            `json:"key" jsonschema_description:"Key (path) for the object in the bucket."`
	Content     string            `` /* 130-byte string literal not displayed */
	ContentType string            `` /* 161-byte string literal not displayed */
	IsBase64    bool              `json:"is_base64,omitempty" jsonschema_description:"Set to true if the content is base64-encoded binary data."`
	Metadata    map[string]string `json:"metadata,omitempty" jsonschema_description:"Custom metadata key-value pairs to attach to the object."`
	Connection  string            `` /* 133-byte string literal not displayed */
}

type PutObjectResult struct {
	Bucket    string `json:"bucket"`
	Key       string `json:"key"`
	Size      int64  `json:"size"`
	ETag      string `json:"etag,omitempty"`
	VersionID string `json:"version_id,omitempty"`
}

type RequestInterceptor interface {
	// Name returns a unique identifier for this interceptor.
	Name() string

	// Intercept examines the request and returns an InterceptResult.
	// Called before the tool handler executes.
	Intercept(ctx context.Context, tc *ToolContext, request *mcp.CallToolRequest) InterceptResult
}

type RequestInterceptorFunc struct {
	// contains filtered or unexported fields
}

type ResultTransformer interface {
	// Name returns a unique identifier for this transformer.
	Name() string

	// Transform modifies the result and returns the transformed version.
	Transform(ctx context.Context, tc *ToolContext, result *mcp.CallToolResult) (*mcp.CallToolResult, error)
}

type ResultTransformerFunc struct {
	// contains filtered or unexported fields
}

type S3Client interface {
	// ConnectionName returns the configured connection name.
	ConnectionName() string

	// Config returns a copy of the client configuration.
	Config() *client.Config

	// ListBuckets returns a list of all buckets accessible to the client.
	ListBuckets(ctx context.Context) ([]client.BucketInfo, error)

	// ListObjects lists objects in a bucket with optional prefix, delimiter, and pagination.
	ListObjects(ctx context.Context, bucket, prefix, delimiter string, maxKeys int32, continueToken string) (*client.ListObjectsOutput, error)

	// GetObject retrieves an object's content from S3.
	GetObject(ctx context.Context, bucket, key string) (*client.ObjectContent, error)

	// GetObjectMetadata retrieves an object's metadata without downloading the content.
	GetObjectMetadata(ctx context.Context, bucket, key string) (*client.ObjectMetadata, error)

	// PutObject uploads an object to S3.
	PutObject(ctx context.Context, input *client.PutObjectInput) (*client.PutObjectOutput, error)

	// DeleteObject deletes an object from S3.
	DeleteObject(ctx context.Context, bucket, key string) error

	// CopyObject copies an object within or between buckets.
	CopyObject(ctx context.Context, input *client.CopyObjectInput) (*client.CopyObjectOutput, error)

	// PresignGetURL generates a presigned URL for downloading an object.
	PresignGetURL(ctx context.Context, bucket, key string, expires time.Duration) (*client.PresignedURL, error)

	// PresignPutURL generates a presigned URL for uploading an object.
	PresignPutURL(ctx context.Context, bucket, key string, expires time.Duration) (*client.PresignedURL, error)

	// Close closes the S3 client and releases resources.
	Close() error
}

type ToolContext struct {
	// ToolName is the name of the tool being executed.
	ToolName ToolName

	// ConnectionName is the name of the S3 connection being used.
	ConnectionName string

	// RequestID is a unique identifier for this request.
	RequestID string

	// StartTime is when the tool execution started.
	StartTime time.Time
	// contains filtered or unexported fields
}

type ToolMiddleware interface {
	// Name returns a unique identifier for this middleware.
	Name() string

	// Before is called before the tool handler executes.
	// It can modify the context or return an error to stop execution.
	Before(ctx context.Context, tc *ToolContext) (context.Context, error)

	// After is called after the tool handler executes (in reverse order).
	// It can modify the result or handle errors.
	After(ctx context.Context, tc *ToolContext, result *mcp.CallToolResult, handlerErr error) (*mcp.CallToolResult, error)
}

type ToolMiddlewareRegistry = MiddlewareChain

type ToolName string

type ToolOption func(*toolConfig)

type Toolkit struct {
	// contains filtered or unexported fields
}

type TransformerChain struct {
	// contains filtered or unexported fields
}